From c238bd1f57ca29fb83fc19a35a04c30867404ceb Mon Sep 17 00:00:00 2001
From: johba <johba@noreply.codeberg.org>
Date: Sun, 22 Mar 2026 08:05:43 +0000
Subject: [PATCH] chore: seed prerequisite tree + RESOURCES.md

Prerequisite tree seeded from VISION.md milestones with current issue state.
Top 3 constraints: contract safety (#1031/#997/#1067), OptimizerV3 tests (#1054),
evolution commits via PR (#1047).

RESOURCES.md lists evolution box, Codeberg accounts, CI, and RPC access.

Part of disinto #502 (planner v2).
---
 RESOURCES.md                 | 31 ++++++++++++++
 planner/prerequisite-tree.md | 80 ++++++++++++++++++++++++++++++++++++
 2 files changed, 111 insertions(+)
 create mode 100644 RESOURCES.md
 create mode 100644 planner/prerequisite-tree.md

diff --git a/RESOURCES.md b/RESOURCES.md
new file mode 100644
index 0000000..384848f
--- /dev/null
+++ b/RESOURCES.md
@@ -0,0 +1,31 @@
+# RESOURCES.md — Project Capability Inventory
+
+## evolution
+- type: compute
+- capability: run harb agents (dev, review, action, gardener, planner, predictor, supervisor), run formulas (red-team, evolution, holdout, user-test)
+- agents: dev, review, action, gardener, supervisor, planner, predictor
+- ram: 8GB
+- note: dedicated to harb — all agent and formula workloads run here
+
+## codeberg-johba
+- type: source-control
+- capability: host repo, issue tracker, PR workflow, API access
+- repo: johba/harb
+- note: owner account
+
+## codeberg-disinto-bot
+- type: source-control
+- capability: review PRs, merge PRs, push branches
+- repo: johba/harb
+- note: bot account, push+pull permissions, no admin
+
+## woodpecker-ci
+- type: ci
+- capability: run pipelines on PR and push events, docker backend
+- note: hosted on harb-staging, triggers via Codeberg webhook
+
+## base-mainnet-rpc
+- type: infrastructure
+- capability: Base L2 mainnet access for on-chain queries, event logs, pool data
+- env: INFURA_API_KEY
+- note: used by evidence formulas (red-team, evolution)
diff --git a/planner/prerequisite-tree.md b/planner/prerequisite-tree.md
new file mode 100644
index 0000000..8f25b65
--- /dev/null
+++ b/planner/prerequisite-tree.md
@@ -0,0 +1,80 @@
+# Prerequisite Tree
+<!-- Last updated: 2026-03-22 -->
+
+## Phase 1 — Quality gate & release pipeline
+
+### Objective: E2E quality gate (#1099)
+- [x] Core E2E test suite exists (tests/e2e/, 6 files)
+- [ ] Mobile viewport coverage (#1099)
+- [ ] Cross-browser matrix (#1099)
+- [ ] OptimizerV3 test coverage (#1054)
+- [ ] Floor ratchet attack defeated (#1067, #1082)
+- [ ] int256 overflow patched (#1031)
+- [ ] Overflow guard for slots 1-7 (#997)
+Status: BLOCKED — 6 prerequisites unresolved
+
+### Objective: Conversion funnel verification (#1100)
+- [x] Landing page exists
+- [x] Staking app exists
+- [ ] E2E quality gate passing (#1099)
+- [ ] Funnel test: landing → swap → stake (#1100)
+Status: BLOCKED — depends on #1099
+
+### Objective: Release pipeline
+- [x] CI pipeline (Woodpecker)
+- [x] Docker images (registry.niovi.voyage)
+- [ ] E2E quality gate integrated into release (#1099)
+Status: BLOCKED — depends on #1099
+
+## Phase 2 — Coordinated launch
+
+### Objective: Pitch deck
+- [ ] E2E quality gate passing (Phase 1 complete)
+- [ ] Analytics in place (#1101)
+Status: BLOCKED — Phase 1 incomplete
+
+### Objective: Influencer outreach
+- [ ] Pitch deck exists
+- [ ] At least 3 influencers committed
+Status: BLOCKED — prerequisite chain
+
+### Objective: Launch day deployment
+- [x] LiquidityManager contract
+- [x] UUPS upgradeable optimizer
+- [ ] Conversion funnel verified (#1100)
+- [ ] Pitch deck reviewed
+- [ ] Influencers committed
+Status: BLOCKED — prerequisite chain
+
+## Phase 3 — Operations
+
+### Objective: Analytics (#1101)
+- [ ] Funnel tracking infrastructure (#1101)
+- [ ] E2E quality gate passing (#1099)
+Status: BLOCKED — depends on #1099
+
+### Objective: Community channel
+- [ ] Launch day scheduled
+Status: BLOCKED — prerequisite chain
+
+### Objective: Optimizer governance
+- [ ] Protocol live with real users
+- [ ] Evolution pipeline producing candidates
+Status: BLOCKED — prerequisite chain
+
+## Foundation (cross-cutting)
+
+### Objective: Contract safety
+- [ ] Floor ratchet attack defeated (#1067, #1082)
+- [ ] int256 overflow patched (#1031)
+- [ ] Overflow guard for slots 1-7 (#997)
+- [ ] Catch block clamping fix (#1019)
+- [ ] OptimizerV3 tested (#1054)
+Status: BLOCKED — 5 prerequisites unresolved. **CONSTRAINT** — blocks Phase 1.
+
+### Objective: Evidence pipeline
+- [x] Red-team formula exists
+- [x] Evolution formula exists
+- [ ] Red-team produces persistent evidence
+- [ ] Evolution commits via PR (#1047)
+Status: BLOCKED — 2 prerequisites unresolved