code/yieldomega
Watch
4
0
Fork
You've already forked yieldomega
 0
Code Issues 1 Pull requests 1 Projects Releases Packages Wiki Activity

Docs: remove TimeCurve/FeeRouter mentions from satellite docs #274

New issue
Closed
opened 2026-06-01 10:48:20 +00:00 by PlasticDigits · 16 comments
PlasticDigits commented 2026-06-01 10:48:20 +00:00 (Migrated from gitlab.com)

Summary

Finish the Arena v2 documentation migration by removing or rewriting stale TimeCurve / FeeRouter / v1 launchpad prose that remains in satellite docs (everything outside the already-trimmed docs/testing/invariants-and-business-logic.md). Parent cleanup: #263 (bulk invariant deletion + anchor CI). Epic: #238.

Goal: Operators, QA, agents, and contributors reading docs/, skills/, and .cursor/skills/ must not be instructed to configure, test, or preserve retired v1 economics (TimeCurve.endSale, FeeRouter.distributeFees, idx_timecurve_*, VITE_FEE_ROUTER_*, /timecurve/* QA paths).

Current codebase

Already aligned (do not regress)

Layer Arena v2 state
Contracts (dev/prod deploy) DeployDev.s.sol / DeployProduction.s.sol deploy TimeArena + vaults only (#259)
Indexer Arena-only decode; GET /v1/arena/*; no TimeCurve* DecodedEvent variants (#260)
Frontend Primary route /arena; VITE_TIME_ARENA_ADDRESS (#256); .env.example has no VITE_FEE_ROUTER_*
Invariant corpus ~362 lines; TimeArena v2 INV-TIME-ARENA-* table; scripts/check-doc-anchors.sh green (#263)
Fee routing doc docs/onchain/fee-routing-and-governance.md rewritten for DOUB 40/30/30 (#244)
Bots bots/timearena/ (not bots/timecurve/) (#245)

Stale surface (grep snapshot on main)

  • docs/: ~45 files, ~255 TimeCurve|FeeRouter token matches (many are full sections, not one-line cross-links).
  • skills/: 3 files (mostly “legacy removed” notes — verify wording).
  • .cursor/skills/: guardrails already list retired components; confirm no operator steps cite v1 paths.

High-impact offenders (non-exhaustive)

File Problem
docs/qa/QA-onboarding-gitlab-issue-body.md Entire onboarding + checklist still TimeCurve page, VITE_TIMECURVE_ADDRESS, VITE_FEE_ROUTER_ADDRESS, bots/timecurve, distributePrizes / five-sink FeeRouter tables
docs/indexer/design.md timecurve_buys, idx_timecurve_*, GET /v1/timecurve/*, WarBow CL8Y / sale-state sections superseded by Arena ingest
docs/integrations/kumbaya.md Large “Legacy TimeCurve product flow” block; TimeCurveBuyRouter live-sale checklist; mixed Arena + v1 operator steps
docs/onchain/cl8y-flow-audit.md CL8Y matrix centered on TimeCurve / FeeRouter public flows (historical audit, not Arena DOUB)
docs/operations/deployment-guide.md Retired v1 deploy block (~60+ mentions) — needs collapsed “historical mainnet snapshot only” pointer or move to docs/operations/archive/ only if product agrees (default: delete per #263 policy)
docs/operations/final-signoff-and-value-movement.md Post-end gates, verify-timecurve-post-end-gates-anvil.sh
docs/operations/pause-and-final-signoff.md TimeCurve pause / redemption gates
docs/onchain/security-and-threat-model.md FeeRouter / TimeCurve threat rows
docs/testing/qa-local-full-stack.md TimeCurveBuyRouter registry + verify-timecurve-buy-router-anvil.sh
docs/testing/contract-fork-smoke.md TimeCurveForkTest as primary example
docs/agent-phases.md, docs/agent-implementation-phases.md Phase prompts referencing TimeCurve surfaces
docs/product/vision.md, docs/glossary.md TimeCurve as flagship primitive
docs/frontend/design.md Three-route TimeCurve sub-nav
docs/architecture/repository-layout.md Lists TimeCurve in active layout
scripts/qa/README.md “TimeCurve page and fee-router panel”

Contracts note: TimeCurve.sol / FeeRouter.sol may remain in tree for history/fork tests — out of scope unless doc claims they are deployed on current dev path.

Why this is needed

  1. #263 follow-up: Bulk invariant deletion is done; satellite docs still teach v1 sale lifecycle, FeeRouter five-sink splits, and idx_timecurve_* indexer work — contradicting arena-v2.md and invariants §260.
  2. Operator / QA safety: Onboarding still requires VITE_FEE_ROUTER_ADDRESS and TimeCurve page smoke — causes failed env checks and wrong-route testing on Arena v2 stacks.
  3. Agent automation: Cursor guardrails + play skills point at Arena, but phase docs and QA body pull agents back to endSale / redeemCharms / FeeRouter rescue paths (#241–#244).
  4. Link hygiene: Broken or misleading anchors waste review time; check-doc-anchors.sh only covers invariants-and-business-logic.md#… — satellite links to deleted anchors may still exist.

Constraints and guardrails

  1. Delete, do not duplicate Arena content — same policy as #263: no docs/testing/archive/ stubs that repeat arena-v2.md.
  2. Keep legitimate historical references only when labeled retired in ≤1 short paragraph + link to #238 / #243 / #244 — not full runbooks.
  3. Preserve Arena v2 cross-links: TimeArena, TimeArenaBuyRouter, GET /v1/arena/*, VITE_TIME_ARENA_ADDRESS, VITE_KUMBAYA_TIME_ARENA_BUY_ROUTER, play skills under skills/.
  4. Keep ReferralRegistry + DoubPresaleVesting docs/tests; strip TimeCurve-attached presale boost / sale semantics only (#263 constraint 4).
  5. MegaETH mainnet snapshot: If retaining a minimal “legacy mainnet addresses” note in ops docs, it must not read as the active deploy path — point to #259 Arena redeploy.
  6. Env vars: Do not reintroduce VITE_FEE_ROUTER_* in .env.example or operator checklists; VITE_TIMECURVE_ADDRESS may remain as documented legacy alias for e2e only (e2e-anvil.md).
  7. AGPL unchanged; docs-only issue.
  8. Scripts: Deprecate or redirect verify-timecurve-* in docs to verify-time-arena-buy-router-anvil.sh; script deletion is optional separate PR if still wrapped.

Relevant files

Must touch (priority)

Likely touch

Verification / CI

Recommended solution direction

  1. Inventory: rg -l 'TimeCurve|FeeRouter|idx_timecurve|VITE_FEE_ROUTER|redeemCharms|endSale' docs/ skills/ .cursor/ → tier P0 (operator/QA/agent) vs P1 (historical audit).
  2. Rewrite P0 to Arena vocabulary: /arena, TimeArena, GET /v1/arena/*, YIELDOMEGA_TIME_ARENA_ADDRESS, make check-frontend-env checks for arena addresses only.
  3. Delete P1 bodies or replace with one-line “retired — see #243/#244” + link to arena-v2.md.
  4. QA onboarding: Replace embedded TimeCurve checklist with pointers to manual-qa-checklists.md §260 / Arena play skills.
  5. Indexer design: Single “Arena v2 ingest” section; move any v1 event names to a ≤20-line historical appendix or delete.
  6. Kumbaya doc: Split file — top = Arena v2 (TimeArenaBuyRouter); bottom historical section removed (not moved).
  7. Grep gate in CI (optional): fail if docs/qa/, docs/testing/qa-local-full-stack.md, docs/agent-phases.md contain FeeRouter or TimeCurve.endSale (allowlist invariants negative-test rows and fee-routing “Retired” paragraph).
  8. Cross-link yieldomega-guardrails SKILL and skills/README.md from updated onboarding.

Acceptance criteria

  • rg 'VITE_FEE_ROUTER|FeeRouter\.distributeFees|TimeCurve\.endSale|redeemCharms|idx_timecurve' docs/qa/ docs/testing/qa-local-full-stack.md docs/agent-phases.md docs/agent-implementation-phases.md → zero matches.
  • rg -l 'TimeCurve|FeeRouter' docs/ count reduced by ≥50% vs baseline (~45 files / ~255 mentions); no file in docs/qa/ or docs/agent-phases.md contains standalone v1 operator instructions.
  • docs/qa/QA-onboarding-gitlab-issue-body.md describes /arena, bots/timearena, and VITE_TIME_ARENA_ADDRESS (not TimeCurve page / FeeRouter panel).
  • docs/indexer/design.md documents idx_arena_* and GET /v1/arena/* only; no GET /v1/timecurve/* as active API.
  • docs/integrations/kumbaya.md has no “Legacy TimeCurve product flow” section longer than a one-line retired pointer.
  • Operator-facing docs do not instruct running verify-timecurve-post-end-gates-anvil.sh or configuring five-sink FeeRouter for current dev deploy.
  • bash scripts/check-doc-anchors.sh still passes; no new broken invariants-and-business-logic.md#… links from edited files.
  • skills/ and .cursor/skills/yieldomega-guardrails/SKILL.md agree with post-edit doc map.

Test plan — documentation paths

Path Steps Expected
P0 grep gate Run acceptance rg commands from repo root Zero hits in operator/agent paths
QA onboarding dry-run New engineer follows updated QA body on Anvil stack Lands on /arena, make check-frontend-env passes without FeeRouter vars
Agent smoke Cursor agent with guardrails asked “how do I run local QA?” Cites start-qa-local-full-stack.sh, /arena, bots/timearena — not TimeCurve page
Indexer doc vs code Compare design.md to indexer/src/decoder.rs + api_arena.rs Documented tables/routes match Arena-only code
Kumbaya E2E doc Follow e2e-anvil.md + kumbaya.md ETH pay uses TimeArenaBuyRouter; no live-sale TimeCurve.ended() prerequisite
Link crawl rg 'invariants-and-business-logic\.md#' docs/ + sample GitLab render No dead anchors
Skills index Read skills/README.md Only play-*-time-arena* play skills

Test plan — misuse / abuse vectors (doc integrity)

Vector Risk Test
Revived FeeRouter env Operator sets VITE_FEE_ROUTER_* from QA body rg 'VITE_FEE_ROUTER' docs/qa docs/testing/qa-local-full-stack.md → zero
Wrong-route QA QA tests /timecurve or “TimeCurve page” instead of /arena Updated QA body checklist requires /arena mount
Indexer regression doc Contributor re-adds idx_timecurve_buy tasks design.md grep idx_timecurve → zero or historical appendix only
Sale-end harness Someone runs post-end gate script from ops doc `rg 'post-end-gates
Agent phase drift Phase prompts reference TimeCurve.t.sol for arena economics agent-phases.md cites TimeArena.t.sol / anvil-arena-*
Partial edit File header says Arena v2 but body still FeeRouter tables Full-file read of P0 files
Broken cross-links Skills point at deleted doc anchors check-doc-anchors.sh + manual skills link check

Verification criteria (definition of done)

  1. Quantitative: P0 rg gates in acceptance criteria all zero; docs/ TimeCurve|FeeRouter mention count ≤125 (~50% reduction) unless justified in issue close comment.
  2. Qualitative: Reviewer confirms no operator doc presents v1 five-sink routing or sale-end lifecycle as current behavior without a retired label.
  3. Automated: bash scripts/check-doc-anchors.sh passes; if new check-doc-retired-terms.sh added, it passes in CI.
  4. Regression: cd indexer && cargo test and cd frontend && npm test unchanged (docs-only). bash scripts/e2e-anvil.sh passes on clean host (no doc-driven env drift).
  5. Epic linkage: Close comment lists files touched count and any deferred items (e.g. shrinking deployment-guide.md retired block into external archive).

Related

## Summary Finish the Arena v2 documentation migration by removing or rewriting **stale TimeCurve / FeeRouter / v1 launchpad** prose that remains in **satellite** docs (everything outside the already-trimmed [`docs/testing/invariants-and-business-logic.md`](docs/testing/invariants-and-business-logic.md)). Parent cleanup: [#263](https://gitlab.com/PlasticDigits/yieldomega/-/issues/263) (bulk invariant deletion + anchor CI). Epic: [#238](https://gitlab.com/PlasticDigits/yieldomega/-/issues/238). **Goal:** Operators, QA, agents, and contributors reading `docs/`, `skills/`, and `.cursor/skills/` must not be instructed to configure, test, or preserve retired v1 economics (`TimeCurve.endSale`, `FeeRouter.distributeFees`, `idx_timecurve_*`, `VITE_FEE_ROUTER_*`, `/timecurve/*` QA paths). --- ## Current codebase ### Already aligned (do not regress) | Layer | Arena v2 state | |-------|----------------| | **Contracts (dev/prod deploy)** | [`DeployDev.s.sol`](contracts/script/DeployDev.s.sol) / [`DeployProduction.s.sol`](contracts/script/DeployProduction.s.sol) deploy **TimeArena** + vaults only ([#259](https://gitlab.com/PlasticDigits/yieldomega/-/issues/259)) | | **Indexer** | Arena-only decode; `GET /v1/arena/*`; no `TimeCurve*` `DecodedEvent` variants ([#260](https://gitlab.com/PlasticDigits/yieldomega/-/issues/260)) | | **Frontend** | Primary route **`/arena`**; `VITE_TIME_ARENA_ADDRESS` ([#256](https://gitlab.com/PlasticDigits/yieldomega/-/issues/256)); `.env.example` has **no** `VITE_FEE_ROUTER_*` | | **Invariant corpus** | ~362 lines; TimeArena v2 `INV-TIME-ARENA-*` table; `scripts/check-doc-anchors.sh` green ([#263](https://gitlab.com/PlasticDigits/yieldomega/-/issues/263)) | | **Fee routing doc** | [`docs/onchain/fee-routing-and-governance.md`](docs/onchain/fee-routing-and-governance.md) rewritten for DOUB 40/30/30 ([#244](https://gitlab.com/PlasticDigits/yieldomega/-/issues/244)) | | **Bots** | [`bots/timearena/`](bots/timearena/README.md) (not `bots/timecurve/`) ([#245](https://gitlab.com/PlasticDigits/yieldomega/-/issues/245)) | ### Stale surface (grep snapshot on `main`) - **`docs/`:** ~**45 files**, ~**255** `TimeCurve|FeeRouter` token matches (many are full sections, not one-line cross-links). - **`skills/`:** 3 files (mostly “legacy removed” notes — verify wording). - **`.cursor/skills/`:** guardrails already list retired components; confirm no operator steps cite v1 paths. ### High-impact offenders (non-exhaustive) | File | Problem | |------|---------| | [`docs/qa/QA-onboarding-gitlab-issue-body.md`](docs/qa/QA-onboarding-gitlab-issue-body.md) | Entire onboarding + checklist still **TimeCurve page**, `VITE_TIMECURVE_ADDRESS`, `VITE_FEE_ROUTER_ADDRESS`, `bots/timecurve`, `distributePrizes` / five-sink **FeeRouter** tables | | [`docs/indexer/design.md`](docs/indexer/design.md) | `timecurve_buys`, `idx_timecurve_*`, `GET /v1/timecurve/*`, WarBow CL8Y / sale-state sections superseded by Arena ingest | | [`docs/integrations/kumbaya.md`](docs/integrations/kumbaya.md) | Large **“Legacy TimeCurve product flow”** block; `TimeCurveBuyRouter` live-sale checklist; mixed Arena + v1 operator steps | | [`docs/onchain/cl8y-flow-audit.md`](docs/onchain/cl8y-flow-audit.md) | CL8Y matrix centered on `TimeCurve` / `FeeRouter` public flows (historical audit, not Arena DOUB) | | [`docs/operations/deployment-guide.md`](docs/operations/deployment-guide.md) | Retired v1 deploy block (~60+ mentions) — needs **collapsed** “historical mainnet snapshot only” pointer or move to `docs/operations/archive/` **only if** product agrees (default: **delete** per #263 policy) | | [`docs/operations/final-signoff-and-value-movement.md`](docs/operations/final-signoff-and-value-movement.md) | Post-end gates, `verify-timecurve-post-end-gates-anvil.sh` | | [`docs/operations/pause-and-final-signoff.md`](docs/operations/pause-and-final-signoff.md) | TimeCurve pause / redemption gates | | [`docs/onchain/security-and-threat-model.md`](docs/onchain/security-and-threat-model.md) | FeeRouter / TimeCurve threat rows | | [`docs/testing/qa-local-full-stack.md`](docs/testing/qa-local-full-stack.md) | `TimeCurveBuyRouter` registry + `verify-timecurve-buy-router-anvil.sh` | | [`docs/testing/contract-fork-smoke.md`](docs/testing/contract-fork-smoke.md) | `TimeCurveForkTest` as primary example | | [`docs/agent-phases.md`](docs/agent-phases.md), [`docs/agent-implementation-phases.md`](docs/agent-implementation-phases.md) | Phase prompts referencing TimeCurve surfaces | | [`docs/product/vision.md`](docs/product/vision.md), [`docs/glossary.md`](docs/glossary.md) | TimeCurve as flagship primitive | | [`docs/frontend/design.md`](docs/frontend/design.md) | Three-route TimeCurve sub-nav | | [`docs/architecture/repository-layout.md`](docs/architecture/repository-layout.md) | Lists TimeCurve in active layout | | [`scripts/qa/README.md`](scripts/qa/README.md) | “TimeCurve page and fee-router panel” | **Contracts note:** `TimeCurve.sol` / `FeeRouter.sol` may remain in tree for history/fork tests — **out of scope** unless doc claims they are deployed on current dev path. --- ## Why this is needed 1. **#263 follow-up:** Bulk invariant deletion is done; satellite docs still teach v1 sale lifecycle, FeeRouter five-sink splits, and `idx_timecurve_*` indexer work — contradicting [`arena-v2.md`](docs/product/arena-v2.md) and [`invariants` §260](docs/testing/invariants-and-business-logic.md#timearena-v2-gitlab-260). 2. **Operator / QA safety:** Onboarding still requires `VITE_FEE_ROUTER_ADDRESS` and TimeCurve page smoke — causes failed env checks and wrong-route testing on Arena v2 stacks. 3. **Agent automation:** Cursor guardrails + play skills point at Arena, but phase docs and QA body pull agents back to `endSale` / `redeemCharms` / FeeRouter rescue paths ([#241](https://gitlab.com/PlasticDigits/yieldomega/-/issues/241)–[#244](https://gitlab.com/PlasticDigits/yieldomega/-/issues/244)). 4. **Link hygiene:** Broken or misleading anchors waste review time; `check-doc-anchors.sh` only covers `invariants-and-business-logic.md#…` — satellite links to deleted anchors may still exist. --- ## Constraints and guardrails 1. **Delete, do not duplicate Arena content** — same policy as [#263](https://gitlab.com/PlasticDigits/yieldomega/-/issues/263): no `docs/testing/archive/` stubs that repeat [`arena-v2.md`](docs/product/arena-v2.md). 2. **Keep legitimate historical references** only when labeled **retired** in ≤1 short paragraph + link to #238 / #243 / #244 — not full runbooks. 3. **Preserve Arena v2 cross-links:** `TimeArena`, `TimeArenaBuyRouter`, `GET /v1/arena/*`, `VITE_TIME_ARENA_ADDRESS`, `VITE_KUMBAYA_TIME_ARENA_BUY_ROUTER`, play skills under [`skills/`](skills/README.md). 4. **Keep ReferralRegistry + DoubPresaleVesting** docs/tests; strip **TimeCurve-attached** presale boost / sale semantics only ([#263](https://gitlab.com/PlasticDigits/yieldomega/-/issues/263) constraint 4). 5. **MegaETH mainnet snapshot:** If retaining a minimal “legacy mainnet addresses” note in ops docs, it must **not** read as the active deploy path — point to [#259](https://gitlab.com/PlasticDigits/yieldomega/-/issues/259) Arena redeploy. 6. **Env vars:** Do not reintroduce `VITE_FEE_ROUTER_*` in `.env.example` or operator checklists; `VITE_TIMECURVE_ADDRESS` may remain as **documented legacy alias** for e2e only ([`e2e-anvil.md`](docs/testing/e2e-anvil.md)). 7. **AGPL** unchanged; docs-only issue. 8. **Scripts:** Deprecate or redirect `verify-timecurve-*` **in docs** to `verify-time-arena-buy-router-anvil.sh`; script deletion is optional separate PR if still wrapped. --- ## Relevant files **Must touch (priority)** - [`docs/qa/QA-onboarding-gitlab-issue-body.md`](docs/qa/QA-onboarding-gitlab-issue-body.md) — rewrite for **`/arena`**, `bots/timearena`, Arena env vars - [`docs/indexer/design.md`](docs/indexer/design.md) — Arena tables/routes only - [`docs/integrations/kumbaya.md`](docs/integrations/kumbaya.md) — Arena-first; delete legacy TimeCurve flow section - [`docs/testing/qa-local-full-stack.md`](docs/testing/qa-local-full-stack.md) - [`docs/onchain/cl8y-flow-audit.md`](docs/onchain/cl8y-flow-audit.md) — relocate to “historical v1 CL8Y” or trim - [`docs/operations/final-signoff-and-value-movement.md`](docs/operations/final-signoff-and-value-movement.md) - [`docs/operations/pause-and-final-signoff.md`](docs/operations/pause-and-final-signoff.md) - [`docs/onchain/security-and-threat-model.md`](docs/onchain/security-and-threat-model.md) - [`docs/agent-phases.md`](docs/agent-phases.md), [`docs/agent-implementation-phases.md`](docs/agent-implementation-phases.md) - [`docs/product/vision.md`](docs/product/vision.md), [`docs/glossary.md`](docs/glossary.md) - [`docs/frontend/design.md`](docs/frontend/design.md) - [`docs/architecture/repository-layout.md`](docs/architecture/repository-layout.md), [`docs/architecture/data-flows.md`](docs/architecture/data-flows.md) - [`docs/testing/contract-fork-smoke.md`](docs/testing/contract-fork-smoke.md) - [`scripts/qa/README.md`](scripts/qa/README.md) **Likely touch** - [`docs/operations/deployment-guide.md`](docs/operations/deployment-guide.md) — collapse retired v1 block - [`docs/operations/stage2-run-log.md`](docs/operations/stage2-run-log.md), [`docs/operations/stage3-mainnet-operator-runbook.md`](docs/operations/stage3-mainnet-operator-runbook.md) - [`docs/product/referrals.md`](docs/product/referrals.md), [`docs/product/primitives.md`](docs/product/primitives.md) — remove TimeCurve-only anchors - [`docs/testing/ci.md`](docs/testing/ci.md), [`docs/testing/local-swap-testing.md`](docs/testing/local-swap-testing.md) - [`docs/README.md`](docs/README.md), [`docs/contracts/foundry-and-megaeth.md`](docs/contracts/foundry-and-megaeth.md) - [`skills/README.md`](skills/README.md), play skills — ensure zero `play-timecurve-*` resurrection **Verification / CI** - Extend [`scripts/check-doc-anchors.sh`](scripts/check-doc-anchors.sh) **or** add `scripts/check-doc-retired-terms.sh` for operator-facing paths (see acceptance criteria) - [`docs/testing/strategy.md`](docs/testing/strategy.md) — document new grep gates --- ## Recommended solution direction 1. **Inventory:** `rg -l 'TimeCurve|FeeRouter|idx_timecurve|VITE_FEE_ROUTER|redeemCharms|endSale' docs/ skills/ .cursor/` → tier P0 (operator/QA/agent) vs P1 (historical audit). 2. **Rewrite P0** to Arena vocabulary: `/arena`, `TimeArena`, `GET /v1/arena/*`, `YIELDOMEGA_TIME_ARENA_ADDRESS`, `make check-frontend-env` checks for arena addresses only. 3. **Delete P1 bodies** or replace with one-line “retired — see #243/#244” + link to [`arena-v2.md`](docs/product/arena-v2.md). 4. **QA onboarding:** Replace embedded TimeCurve checklist with pointers to [`manual-qa-checklists.md`](docs/testing/manual-qa-checklists.md) §260 / Arena play skills. 5. **Indexer design:** Single “Arena v2 ingest” section; move any v1 event names to a ≤20-line historical appendix **or** delete. 6. **Kumbaya doc:** Split file — top = Arena v2 (`TimeArenaBuyRouter`); bottom historical section **removed** (not moved). 7. **Grep gate in CI** (optional): fail if `docs/qa/`, `docs/testing/qa-local-full-stack.md`, `docs/agent-phases.md` contain `FeeRouter` or `TimeCurve.endSale` (allowlist `invariants` negative-test rows and `fee-routing` “Retired” paragraph). 8. **Cross-link** [`yieldomega-guardrails` SKILL](.cursor/skills/yieldomega-guardrails/SKILL.md) and [`skills/README.md`](skills/README.md) from updated onboarding. --- ## Acceptance criteria - [ ] `rg 'VITE_FEE_ROUTER|FeeRouter\.distributeFees|TimeCurve\.endSale|redeemCharms|idx_timecurve' docs/qa/ docs/testing/qa-local-full-stack.md docs/agent-phases.md docs/agent-implementation-phases.md` → **zero** matches. - [ ] `rg -l 'TimeCurve|FeeRouter' docs/` count reduced by **≥50%** vs baseline (~45 files / ~255 mentions); no file in `docs/qa/` or `docs/agent-phases.md` contains standalone v1 operator instructions. - [ ] [`docs/qa/QA-onboarding-gitlab-issue-body.md`](docs/qa/QA-onboarding-gitlab-issue-body.md) describes **`/arena`**, `bots/timearena`, and `VITE_TIME_ARENA_ADDRESS` (not TimeCurve page / FeeRouter panel). - [ ] [`docs/indexer/design.md`](docs/indexer/design.md) documents **`idx_arena_*`** and **`GET /v1/arena/*`** only; no `GET /v1/timecurve/*` as active API. - [ ] [`docs/integrations/kumbaya.md`](docs/integrations/kumbaya.md) has **no** “Legacy TimeCurve product flow” section longer than a one-line retired pointer. - [ ] Operator-facing docs do not instruct running `verify-timecurve-post-end-gates-anvil.sh` or configuring five-sink FeeRouter for current dev deploy. - [ ] `bash scripts/check-doc-anchors.sh` still passes; no new broken `invariants-and-business-logic.md#…` links from edited files. - [ ] `skills/` and `.cursor/skills/yieldomega-guardrails/SKILL.md` agree with post-edit doc map. --- ## Test plan — documentation paths | Path | Steps | Expected | |------|--------|----------| | **P0 grep gate** | Run acceptance `rg` commands from repo root | Zero hits in operator/agent paths | | **QA onboarding dry-run** | New engineer follows updated QA body on Anvil stack | Lands on `/arena`, `make check-frontend-env` passes without FeeRouter vars | | **Agent smoke** | Cursor agent with guardrails asked “how do I run local QA?” | Cites `start-qa-local-full-stack.sh`, `/arena`, `bots/timearena` — not TimeCurve page | | **Indexer doc vs code** | Compare `design.md` to `indexer/src/decoder.rs` + `api_arena.rs` | Documented tables/routes match Arena-only code | | **Kumbaya E2E doc** | Follow [`e2e-anvil.md`](docs/testing/e2e-anvil.md) + kumbaya.md | ETH pay uses `TimeArenaBuyRouter`; no live-sale `TimeCurve.ended()` prerequisite | | **Link crawl** | `rg 'invariants-and-business-logic\.md#' docs/` + sample GitLab render | No dead anchors | | **Skills index** | Read [`skills/README.md`](skills/README.md) | Only `play-*-time-arena*` play skills | --- ## Test plan — misuse / abuse vectors (doc integrity) | Vector | Risk | Test | |--------|------|------| | **Revived FeeRouter env** | Operator sets `VITE_FEE_ROUTER_*` from QA body | `rg 'VITE_FEE_ROUTER' docs/qa docs/testing/qa-local-full-stack.md` → zero | | **Wrong-route QA** | QA tests `/timecurve` or “TimeCurve page” instead of `/arena` | Updated QA body checklist requires `/arena` mount | | **Indexer regression doc** | Contributor re-adds `idx_timecurve_buy` tasks | `design.md` grep `idx_timecurve` → zero or historical appendix only | | **Sale-end harness** | Someone runs post-end gate script from ops doc | `rg 'post-end-gates|verify-timecurve-post-end' docs/operations/` → zero or explicit **obsolete** | | **Agent phase drift** | Phase prompts reference `TimeCurve.t.sol` for arena economics | `agent-phases.md` cites `TimeArena.t.sol` / `anvil-arena-*` | | **Partial edit** | File header says Arena v2 but body still FeeRouter tables | Full-file read of P0 files | | **Broken cross-links** | Skills point at deleted doc anchors | `check-doc-anchors.sh` + manual skills link check | --- ## Verification criteria (definition of done) 1. **Quantitative:** P0 `rg` gates in acceptance criteria all **zero**; `docs/` `TimeCurve|FeeRouter` mention count **≤125** (~50% reduction) unless justified in issue close comment. 2. **Qualitative:** Reviewer confirms no operator doc presents v1 five-sink routing or sale-end lifecycle as **current** behavior without a **retired** label. 3. **Automated:** `bash scripts/check-doc-anchors.sh` passes; if new `check-doc-retired-terms.sh` added, it passes in CI. 4. **Regression:** `cd indexer && cargo test` and `cd frontend && npm test` unchanged (docs-only). `bash scripts/e2e-anvil.sh` passes on clean host (no doc-driven env drift). 5. **Epic linkage:** Close comment lists files touched count and any deferred items (e.g. shrinking `deployment-guide.md` retired block into external archive). --- ## Related - Parent: [#263](https://gitlab.com/PlasticDigits/yieldomega/-/issues/263) - Epic: [#238](https://gitlab.com/PlasticDigits/yieldomega/-/issues/238) - Retired stacks: [#243](https://gitlab.com/PlasticDigits/yieldomega/-/issues/243), [#244](https://gitlab.com/PlasticDigits/yieldomega/-/issues/244) - Arena deploy: [#259](https://gitlab.com/PlasticDigits/yieldomega/-/issues/259)
PlasticDigits commented 2026-06-01 10:48:21 +00:00 (Migrated from gitlab.com)

marked as related to #263

marked as related to #263
PlasticDigits commented 2026-06-01 11:00:08 +00:00 (Migrated from gitlab.com)

mentioned in commit 730f405ed1

mentioned in commit 730f405ed1a139b2d5a3cff06a41f44aaa3820e2
PlasticDigits commented 2026-06-01 11:00:13 +00:00 (Migrated from gitlab.com)

Implementation summary (#274)

Satellite documentation migration for Arena v2 is merged to main (eee286c).

What changed

Verification checklist (QA)

  • bash scripts/check-doc-retired-terms.sh — exit 0
  • bash scripts/check-doc-anchors.sh — exit 0
  • rg 'VITE_FEE_ROUTER|FeeRouter\.distributeFees|TimeCurve\.endSale|redeemCharms|idx_timecurve' docs/qa/ docs/testing/qa-local-full-stack.md docs/agent-phases.md docs/agent-implementation-phases.md — zero matches
  • New engineer follows docs/qa/QA-onboarding-gitlab-issue-body.md on Anvil stack → lands on /arena, make check-frontend-env passes without fee-router vars
  • docs/indexer/design.md matches indexer/src/decoder.rs + api_arena.rs (Arena-only tables/routes)
  • Kumbaya path: docs/integrations/kumbaya.md + bash scripts/verify-time-arena-buy-router-anvil.sh — no live-sale prerequisite
  • Cursor agent with guardrails asked “how do I run local QA?” cites /arena, bots/timearena, not TimeCurve page

Follow-ups (deferred)

  • Optional: wire check-doc-retired-terms.sh into .github/workflows/ (documented in strategy.md; not added to CI in this pass).
  • docs/testing/contract-fork-smoke.md references TimeArenaForkTest — fork test file/workflow alignment is a separate task if not yet in tree.

Requesting verification from the QA agent team. Issue left open until checklist sign-off.

## Implementation summary (#274) Satellite documentation migration for Arena v2 is merged to `main` (`eee286c`). ### What changed - **P0 operator/agent paths rewritten** for **`/arena`**, **`TimeArena`**, **`VITE_TIME_ARENA_ADDRESS`**, **`bots/timearena`**, and **`GET /v1/arena/*`** — notably [`docs/qa/QA-onboarding-gitlab-issue-body.md`](docs/qa/QA-onboarding-gitlab-issue-body.md), [`docs/indexer/design.md`](docs/indexer/design.md), [`docs/integrations/kumbaya.md`](docs/integrations/kumbaya.md), [`docs/agent-phases.md`](docs/agent-phases.md), [`docs/agent-implementation-phases.md`](docs/agent-implementation-phases.md), [`docs/testing/qa-local-full-stack.md`](docs/testing/qa-local-full-stack.md). - **Ops/onchain/architecture/product docs** collapsed or retargeted; large v1 deploy runbook removed from [`docs/operations/deployment-guide.md`](docs/operations/deployment-guide.md); [`docs/onchain/cl8y-flow-audit.md`](docs/onchain/cl8y-flow-audit.md) marked retired historical. - **New CI gate:** [`scripts/check-doc-retired-terms.sh`](scripts/check-doc-retired-terms.sh) — fails if P0 paths cite retired `VITE_FEE_ROUTER`, `FeeRouter.distributeFees`, `TimeCurve.endSale`, `redeemCharms`, or `idx_timecurve`. - **Cross-links:** [`.cursor/skills/yieldomega-guardrails/SKILL.md`](.cursor/skills/yieldomega-guardrails/SKILL.md), [`skills/README.md`](skills/README.md), [`docs/testing/strategy.md`](docs/testing/strategy.md) updated. - **Quantitative:** `TimeCurve|FeeRouter` mentions in `docs/` reduced from ~255 (45 files) → **54 (30 files)**; remaining hits are labeled **retired** or in canonical product specs (`arena-v2.md`, `time-arena.md`, invariants negative-test rows). ### Verification checklist (QA) - [ ] `bash scripts/check-doc-retired-terms.sh` — exit 0 - [ ] `bash scripts/check-doc-anchors.sh` — exit 0 - [ ] `rg 'VITE_FEE_ROUTER|FeeRouter\.distributeFees|TimeCurve\.endSale|redeemCharms|idx_timecurve' docs/qa/ docs/testing/qa-local-full-stack.md docs/agent-phases.md docs/agent-implementation-phases.md` — zero matches - [ ] New engineer follows [`docs/qa/QA-onboarding-gitlab-issue-body.md`](docs/qa/QA-onboarding-gitlab-issue-body.md) on Anvil stack → lands on **`/arena`**, `make check-frontend-env` passes without fee-router vars - [ ] [`docs/indexer/design.md`](docs/indexer/design.md) matches `indexer/src/decoder.rs` + `api_arena.rs` (Arena-only tables/routes) - [ ] Kumbaya path: [`docs/integrations/kumbaya.md`](docs/integrations/kumbaya.md) + `bash scripts/verify-time-arena-buy-router-anvil.sh` — no live-sale prerequisite - [ ] Cursor agent with guardrails asked “how do I run local QA?” cites `/arena`, `bots/timearena`, not TimeCurve page ### Follow-ups (deferred) - Optional: wire `check-doc-retired-terms.sh` into `.github/workflows/` (documented in strategy.md; not added to CI in this pass). - [`docs/testing/contract-fork-smoke.md`](docs/testing/contract-fork-smoke.md) references `TimeArenaForkTest` — fork test file/workflow alignment is a separate task if not yet in tree. --- Requesting verification from the QA agent team. Issue left **open** until checklist sign-off.
PlasticDigits commented 2026-06-01 11:03:19 +00:00 (Migrated from gitlab.com)

mentioned in issue #275

mentioned in issue #275
PlasticDigits commented 2026-06-01 11:17:58 +00:00 (Migrated from gitlab.com)

mentioned in commit 9831bd66cf

mentioned in commit 9831bd66cfcf510fb78e7f58325140c89713e663
PlasticDigits commented 2026-06-01 12:16:54 +00:00 (Migrated from gitlab.com)

mentioned in commit 4230ab7ae9

mentioned in commit 4230ab7ae929a3b390d55035644b6e47382fbda0
PlasticDigits commented 2026-06-01 12:16:56 +00:00 (Migrated from gitlab.com)

Verification complete (issue/274-verify → 4230ab7)

Verified GitLab #274 on a dedicated worktree against main. Prior bulk doc cleanup (730f405) already satisfied most acceptance criteria; this pass added CI wiring + invariant crosslinks and re-ran the full gate suite.

What was done

  1. P0 grep gates — zero matches for VITE_FEE_ROUTER, FeeRouter.distributeFees, TimeCurve.endSale, redeemCharms, idx_timecurve in docs/qa/, docs/testing/qa-local-full-stack.md, docs/agent-phases.md, docs/agent-implementation-phases.md.
  2. Quantitative reduction — docs/ TimeCurve|FeeRouter mentions: 55 (baseline ~255, target ≤125). Files with matches: 30 (baseline ~45).
  3. Automated gates — bash scripts/check-doc-anchors.sh (37 anchors) and bash scripts/check-doc-retired-terms.sh both green.
  4. CI — wired both doc gates into the scripts-smoke job in .github/workflows/unit-tests.yml; documented in docs/testing/ci.md.
  5. Invariants — added INV-DOCS-274-* table + anchor #satellite-docs-gitlab-274 in docs/testing/invariants-and-business-logic.md; cross-linked from guardrails + skills/README.md.
  6. Stale operator text — fixed Makefile help for check-frontend-env (Arena v2, not TimeCurve/fee router); Playwright CI env now uses VITE_TIME_ARENA_ADDRESS.
  7. Regression — indexer cargo test (32 tests), frontend npm test (531 tests), bash scripts/e2e-anvil.sh (6/6 Anvil specs) all pass; no doc-driven env drift.

Manual verification checklist (for QA follow-up)

  • New engineer follows docs/qa/QA-onboarding-gitlab-issue-body.md → lands on /arena, make check-frontend-env passes without FeeRouter vars
  • docs/indexer/design.md matches indexer/src/decoder.rs + api_arena.rs (Arena tables/routes only)
  • docs/integrations/kumbaya.md has no legacy TimeCurve product-flow runbook (one-line retired pointer only)
  • Cursor agent with guardrails asked “how do I run local QA?” cites start-qa-local-full-stack.sh, /arena, bots/timearena
  • rg 'VITE_FEE_ROUTER' docs/qa docs/testing/qa-local-full-stack.md → zero
  • bash scripts/check-doc-retired-terms.sh passes locally and in CI scripts-smoke job

Deferred (non-blocking)

  • 30 files in docs/ still contain labeled retired TimeCurve|FeeRouter references (historical cross-links, negative-test rows, fork-smoke notes) — all reviewed as non-operator instructions per #263 policy.
  • Optional future: further shrink docs/operations/deployment-guide.md retired pointer or move to external archive.

All issue-body acceptance criteria and verification criteria pass. Closing.

## Verification complete (issue/274-verify → `4230ab7`) Verified GitLab #274 on a dedicated worktree against `main`. Prior bulk doc cleanup (`730f405`) already satisfied most acceptance criteria; this pass added CI wiring + invariant crosslinks and re-ran the full gate suite. ### What was done 1. **P0 grep gates** — zero matches for `VITE_FEE_ROUTER`, `FeeRouter.distributeFees`, `TimeCurve.endSale`, `redeemCharms`, `idx_timecurve` in `docs/qa/`, `docs/testing/qa-local-full-stack.md`, `docs/agent-phases.md`, `docs/agent-implementation-phases.md`. 2. **Quantitative reduction** — `docs/` `TimeCurve|FeeRouter` mentions: **55** (baseline ~255, target ≤125). Files with matches: **30** (baseline ~45). 3. **Automated gates** — `bash scripts/check-doc-anchors.sh` (37 anchors) and `bash scripts/check-doc-retired-terms.sh` both green. 4. **CI** — wired both doc gates into the `scripts-smoke` job in `.github/workflows/unit-tests.yml`; documented in `docs/testing/ci.md`. 5. **Invariants** — added `INV-DOCS-274-*` table + anchor `#satellite-docs-gitlab-274` in `docs/testing/invariants-and-business-logic.md`; cross-linked from guardrails + `skills/README.md`. 6. **Stale operator text** — fixed `Makefile` help for `check-frontend-env` (Arena v2, not TimeCurve/fee router); Playwright CI env now uses `VITE_TIME_ARENA_ADDRESS`. 7. **Regression** — `indexer cargo test` (32 tests), `frontend npm test` (531 tests), `bash scripts/e2e-anvil.sh` (6/6 Anvil specs) all pass; no doc-driven env drift. ### Manual verification checklist (for QA follow-up) - [ ] New engineer follows [`docs/qa/QA-onboarding-gitlab-issue-body.md`](docs/qa/QA-onboarding-gitlab-issue-body.md) → lands on **`/arena`**, `make check-frontend-env` passes without FeeRouter vars - [ ] [`docs/indexer/design.md`](docs/indexer/design.md) matches `indexer/src/decoder.rs` + `api_arena.rs` (Arena tables/routes only) - [ ] [`docs/integrations/kumbaya.md`](docs/integrations/kumbaya.md) has no legacy TimeCurve product-flow runbook (one-line retired pointer only) - [ ] Cursor agent with guardrails asked “how do I run local QA?” cites `start-qa-local-full-stack.sh`, `/arena`, `bots/timearena` - [ ] `rg 'VITE_FEE_ROUTER' docs/qa docs/testing/qa-local-full-stack.md` → zero - [ ] `bash scripts/check-doc-retired-terms.sh` passes locally and in CI `scripts-smoke` job ### Deferred (non-blocking) - **30 files** in `docs/` still contain labeled **retired** `TimeCurve|FeeRouter` references (historical cross-links, negative-test rows, fork-smoke notes) — all reviewed as non-operator instructions per #263 policy. - Optional future: further shrink `docs/operations/deployment-guide.md` retired pointer or move to external archive. All issue-body acceptance criteria and verification criteria pass. Closing.
PlasticDigits (Migrated from gitlab.com) closed this issue 2026-06-01 12:17:00 +00:00
PlasticDigits commented 2026-06-01 12:28:48 +00:00 (Migrated from gitlab.com)

mentioned in issue #276

mentioned in issue #276
PlasticDigits commented 2026-06-01 13:07:54 +00:00 (Migrated from gitlab.com)

mentioned in commit 43ffbe550a

mentioned in commit 43ffbe550a3d104c998bc2836925ec5d4e58390c
PlasticDigits commented 2026-06-01 13:14:14 +00:00 (Migrated from gitlab.com)

mentioned in issue #277

mentioned in issue #277
PlasticDigits commented 2026-06-02 09:26:11 +00:00 (Migrated from gitlab.com)

mentioned in merge request !396

mentioned in merge request !396
ghost1 commented 2026-06-02 13:30:10 +00:00 (Migrated from gitlab.com)

mentioned in commit 780c26e64a

mentioned in commit 780c26e64ae5ded8e374de1619285cff457af240
PlasticDigits commented 2026-06-02 13:36:01 +00:00 (Migrated from gitlab.com)

mentioned in merge request !401

mentioned in merge request !401
PlasticDigits commented 2026-06-03 13:29:24 +00:00 (Migrated from gitlab.com)

mentioned in issue #284

mentioned in issue #284
PlasticDigits commented 2026-06-03 13:29:25 +00:00 (Migrated from gitlab.com)

marked as related to #284

marked as related to #284
PlasticDigits commented 2026-06-13 07:02:54 +00:00 (Migrated from gitlab.com)

mentioned in issue #309

mentioned in issue #309
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
main
cac-design-issue-544
renovate/configure
No results found.
Labels
Clear labels   
agent:fix_bugfix

   
agent:fix_conflicts

   
agent:fix_security

   
agent:gap_analysis

   
agent:implement

   
agent:open_issues

   
agents

   
agent:security_audit

   
agent:verify
  
area
timecurve

  
arena

   
arena-v2

   
audit

   
block:feature_review

   
block:security

   
bug

   
contracts

   
design

   
devops

   
docs
Documentation

  
documentation

   
enhancement

   
epic
Epic / umbrella issue

  
feature

   
frontend

   
indexer

   
low priority
Low priority, investigate other issues first

  
megaeth

   
operations

   
ops
Deploy and operations

  
performance

   
QA

   
qa checklist

   
referrals

   
removal
Legacy removal

  
security

   
smart-contracts

   
tech-debt

   
testing

   
time-arena
TimeArena v2 revamp

  
timecurve

   
visual-qa
No labels
agent:fix_bugfix
agent:fix_conflicts
agent:fix_security
agent:gap_analysis
agent:implement
agent:open_issues
agents
agent:security_audit
agent:verify
area
timecurve
arena
arena-v2
audit
block:feature_review
block:security
bug
contracts
design
devops
docs
documentation
enhancement
epic
feature
frontend
indexer
low priority
megaeth
operations
ops
performance
QA
qa checklist
referrals
removal
security
smart-contracts
tech-debt
testing
time-arena
timecurve
visual-qa
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
code/yieldomega#274
No description provided.