ship(P00): merge phase 0 into milestone v0.1

---ci--- project: oy phase: 0 milestone: v0.1 status: complete ship: v0.0.0 ---/ci--- Phase 0 shipped. All pre-execution stages complete. SPECIFY -> CLARIFY -> RESEARCH -> PLAN -> GRILL -> SHIP 9 commits, 21 REQ-IDs, 14 components indexed, personas assigned.
2026-08-17 19:51:09 +00:00
parent 711fca3d27 88ed67e527
commit 7a5dcb7b81
2 changed files with 196 additions and 74 deletions
@@ -1,96 +1,213 @@
-# Phase Plans: OpenYield (oy)
+# Phase Plans: OpenYield (oy) — Milestone v0.1 (Pre-MVP)

-## Phase 1 — Foundation (8 components)
+## Milestone Versioning

-### Wave 1: Core Spine (must ship first)
- **Plan 1.1**: OY Chain & Mirror (Component 1)
-  - REQs: REQ-004 (9 Watchers, 6-of-9 quorum), REQ-008 (OY Chain)
-  - Deliverable: Cosmos app-chain launched, 9 Watchers bonded, Mirror live
-  - Owner: backend-engineer
+- **Milestone**: v0.1 (development; stays v0.1 until MVP ships as v0.1.0)
+- **Patch line**: v0.0.x (previous minor)
+- **Phase 0 tag**: v0.0.0
+- **P1-P8 tags**: v0.0.1 - v0.0.8
+- **P9 (final review)**: v0.0.9 — milestone complete, no MVP release yet
+- **MVP release** (future milestone): v0.1.0

- **Plan 1.2**: Bread Unit & Root Basket (Component 3)
-  - REQs: REQ-003 (Bloom from real yield), REQ-013 (Bread unit), REQ-009 (Satellites)
-  - Deliverable: Forge/Fold on Ethereum + Polygon/Base/Arbitrum; initial Root Basket
-  - Owner: backend-engineer
+## Phase Breakdown — Task-Level Slices

- **Plan 1.3**: Storage Substrate (Component 5)
-  - REQs: REQ-014 (3 pools), REQ-015 (Window data source)
-  - Deliverable: Stash, Vault, Root-Pool contracts
-  - Owner: data-engineer
+### Phase 0 — Pre-Execution (COMPLETE)
+- SPECIFY → CLARIFY → RESEARCH → PLAN → GRILL
+- Tag: v0.0.0
+- Ships: .ciagent/ reference files, 21 REQ-IDs, persona assessment

-### Wave 2: Foundation Layer (depends on Wave 1)
- **Plan 1.4**: Bloom Engine (Component 4)
-  - REQs: REQ-003 (Bloom from real yield)
-  - Deliverable: Bloom accrual loop tied to Mirror attestations
-  - Owner: backend-engineer
+### Phase 1 — OY Chain & Mirror (Component 1)
+- **Wave**: Core Spine
+- **REQs**: REQ-004 (9 Watchers, 6-of-9 quorum), REQ-008 (OY Chain)
+- **Deliverables**:
+  - Cosmos SDK app-chain skeleton (CometBFT consensus)
+  - Watcher bond module (min 100,000 Bread bond)
+  - Attestation quorum module (6-of-9, daily epoch, geographic diversity rule)
+  - Mirror: reserve ratio publication, NAV computation
+  - Still/Stir (pause/resume) module
+- **Blocked by**: Phase 0 ship
+- **Owner**: backend-engineer
+- **Tag**: v0.0.1
+- **Demo**: Chain launches, 9 Watchers bond, daily attestation quorum reached, reserve ratio published

- **Plan 1.5**: Fee Covenant (Component 13)
-  - REQs: REQ-002 (fee ceiling/floor)
-  - Deliverable: 0.1% ceiling live, processor share 50%, 1-Grain internal minimum
-  - Owner: backend-engineer
+### Phase 2 — Bread Unit & Root Basket (Component 3)
+- **Wave**: Core Spine
+- **REQs**: REQ-003 (Bloom from real yield), REQ-013 (Bread unit), REQ-009 (Satellites)
+- **Deliverables**:
+  - Forge/Fold CosmWasm contracts (mint against deposited Root Basket assets only)
+  - Bread unit scale (Grain → Crumb → Bread → Loaf → Batch → Cake → Bakery → Granary → Mill → Harvest → Earth)
+  - Root Basket config (Treasuries ~35%, IG corporate ~25%, gold ~20%, Bitcoin ~10%, other RWA ~10%)
+  - Ethereum bridge stub (wrapped Bread on Ethereum)
+  - Satellite chain stubs (Polygon, Base, Arbitrum)
+- **Blocked by**: Phase 1
+- **Owner**: backend-engineer
+- **Tag**: v0.0.2
+- **Demo**: Deposit RWA asset → Forge mints Bread → Fold burns Bread → returns asset. NAV per Bread published.

- **Plan 1.6**: Identity, Standing & Citizenship (Component 6)
-  - REQs: REQ-005 (Four Freeholder signals), REQ-006 (Standing formula)
-  - Deliverable: Reach v1, Standing v1, Nomad/Freeholder system
-  - Owner: backend-engineer + data-engineer
+### Phase 3 — Storage Substrate (Component 5)
+- **Wave**: Core Spine
+- **REQs**: REQ-014 (3 pools), REQ-015 (Window data source)
+- **Deliverables**:
+  - Stash contract (per Holder, sovereign)
+  - Vault contract (per Stand, governed)
+  - Root-Pool contract (treasury, attested by Watchers)
+  - Storage indexer (Subsquid + GraphQL)
+  - Audit log primitive (for Window)
+- **Blocked by**: Phase 1, Phase 2
+- **Owner**: data-engineer
+- **Tag**: v0.0.3
+- **Demo**: Holder creates Stash, receives Bread, balance queryable. Root-Pool visible to all Holders.

-### Wave 3: User-Facing (depends on Wave 2)
- **Plan 1.7**: Bearers & Processing Mesh (Component 12)
-  - REQs: REQ-007 (FCFS), REQ-019 (6 bearers)
-  - Deliverable: Processing v1, OY-BLE, OY-WiFi-Direct
-  - Owner: backend-engineer + frontend-engineer
+### Phase 4 — Bloom Engine (Component 4)
+- **Wave**: Foundation Layer
+- **REQs**: REQ-003 (Bloom from real yield)
+- **Deliverables**:
+  - Bloom accrual loop (tied to Mirror attestations)
+  - Pro-rata distribution to every Grain in every Stash
+  - Target ~4-5%/year (honest expectation, not promise)
+  - Bloom Booster Bucket (higher-yield strategy)
+- **Blocked by**: Phase 2, Phase 3
+- **Owner**: backend-engineer
+- **Tag**: v0.0.4
+- **Demo**: Bread in Stash accrues Bloom automatically. Holder sees Bloom balance grow.

- **Plan 1.8**: Mesh Experience (Component 9)
-  - REQs: REQ-010 (Exit layer), Maya's Day integration spec
-  - Deliverable: Maps, Pay v1
-  - Owner: frontend-engineer
+### Phase 5 — Fee Covenant (Component 13)
+- **Wave**: Foundation Layer
+- **REQs**: REQ-002 (fee ceiling/floor)
+- **Deliverables**:
+  - Fee Covenant smart contract (0.1% ceiling, 0.01% floor, 1-Grain internal minimum)
+  - Auto-decline schedule (Genesis 0.1% → $10B 0.07% → $50B 0.05% → $200B 0.03% → $500B 0.02% → $1T 0.01%)
+  - Processor share (50% → 30% → 20% → 10%)
+  - Waiver logic (Hand-Passes, Crew-internal, Household-internal, Cover Calls, Trust, Foundation, Circle)
+  - clamp() function (never > ceiling, never < floor)
+- **Blocked by**: Phase 3
+- **Owner**: backend-engineer
+- **Tag**: v0.0.5
+- **Demo**: Pass-Act executes, fee computed correctly, waived passes cost only 1 Grain, auto-decline verified.

-## Phase 2 — The Mesh (5 components + bond primitive)
+### Phase 6 — Identity, Standing & Citizenship (Component 6)
+- **Wave**: Foundation Layer
+- **REQs**: REQ-005 (Four Freeholder signals), REQ-006 (Standing formula), REQ-012 (Lexicon)
+- **Deliverables**:
+  - Reach v1 (mesh-native identity, cryptographic)
+  - Standing v1 (Bayesian + time-decay + diversity + voucher-weighted − slashes)
+  - Freeholder transition (4 signals: 90d Stash, 4.5★+ in 3 cats, Capital, Vouch)
+  - Vouching with skin-in-the-game
+  - Slashing (Crack, FraudulentCoverCall, InactivityTimeout)
+  - Wayfarer's Record attestation
+  - Two-Layer Passport routing stub
+- **Blocked by**: Phase 1, Phase 3
+- **Owner**: backend-engineer + data-engineer
+- **Tag**: v0.0.6
+- **Demo**: Holder accumulates Standing, meets 4 signals, becomes Freeholder automatically. Vouching + slashing verified.

-### Wave 1
- **Plan 2.1**: Organizational Primitives (Component 10) — 9 Stand types, Guilds
-  - REQs: REQ-016, REQ-017
-  - Owner: backend-engineer
+### Phase 7 — Bearers & Processing Mesh (Component 12)
+- **Wave**: User-Facing
+- **REQs**: REQ-007 (FCFS), REQ-019 (6 bearers)
+- **Deliverables**:
+  - FCFS processing mesh (not fee-auctioned)
+  - Geographic proximity wins (closest processor to recipient)
+  - Light client (~30 MB app, ~1-3% battery/day)
+  - OY-BLE bearer (10-100m)
+  - OY-WiFi-Direct bearer (50-200m)
+  - Unified Bearer Layer (parallel尝试, first-to-deliver wins, RFC 5050 DTN principles)
+  - Internet bearer (fallback)
+- **Blocked by**: Phase 1, Phase 2, Phase 3, Phase 5
+- **Owner**: backend-engineer + frontend-engineer
+- **Tag**: v0.0.7
+- **Demo**: Two phones transfer Bread via BLE. Processing mesh routes via FCFS. Light client runs.

- **Plan 2.2**: Partner Spectrum & Forex (Component 11) — First Piers, Forex Engine v1
-  - REQs: REQ-018
-  - Owner: backend-engineer
+### Phase 8 — Mesh Experience (Component 9)
+- **Wave**: User-Facing
+- **REQs**: REQ-010 (Exit layer), Maya's Day placeholder
+- **Deliverables**:
+  - Maps v1 (discovery — where you are, what's around)
+  - Pay v1 (settlement — how value flows)
+  - React Native app (Expo, offline-first)
+  - Exit layer stub (DEX swaps, bridges)
+  - Maya's Day placeholder UI (full narrative deferred to component doc)
+- **Blocked by**: Phase 6, Phase 7, Phase 5
+- **Owner**: frontend-engineer
+- **Tag**: v0.0.8
+- **Demo**: Holder opens app, sees Maps, sends Bread via Pay, views Standing, sees Mirror ratio.

-### Wave 2
- **Plan 2.3**: Window Primitive (Component 7)
-  - REQs: REQ-015
-  - Owner: backend-engineer + data-engineer
+### Phase 9 — Final Review + Audit + Milestone Ship
+- **Deliverables**:
+  - Multi-persona code review (all phases P1-P8)
+  - P0 fixes auto-applied, P1+ flagged for post-hoc
+  - Project health audit (reconstruction test, .ciagent discipline, branch hygiene)
+  - Milestone ship: merge phase/09 → milestone/v0.1-oy → main
+  - Tag v0.0.9 (final patch in v0.1 development line)
+  - Update REQUIREMENTS.md (mark milestone requirements complete)
+  - Update ROADMAP.md (mark milestone complete)
+  - Delete all milestone branches (tags preserve history)
+- **Blocked by**: Phase 1-8 all shipped
+- **Owner**: lead-developer
+- **Tag**: v0.0.9
+- **Note**: v0.1 milestone complete. MVP NOT released. Next milestone (v0.2) builds toward MVP at v0.1.0.

- **Plan 2.4**: Pacts Suite (Component 8) — Pause, Ground, Stance, Cover, Stand Registry
-  - REQs: REQ-020
-  - Owner: backend-engineer
+## Dependency Graph

- **Plan 2.5**: Governance (Component 14) — Mesh Council activated
-  - REQs: REQ-011
-  - Owner: backend-engineer
+```
+P0 (done) ──► P1 (Chain & Mirror)
+                 │
+                 ▼
+              P2 (Bread & Root Basket)
+                 │
+                 ▼
+              P3 (Storage)
+                 │
+        ┌────────┼────────┐
+        ▼        ▼        ▼
+     P4 (Bloom) P5 (Fee) P6 (Identity)
+                 │        │
+                 └────┬───┘
+                      ▼
+                   P7 (Bearers)
+                      │
+                      ▼
+                   P8 (Mesh UI)
+                      │
+                      ▼
+                   P9 (Final)
+```

-### Wave 3
- **Plan 2.6**: Bearers expansion — OY-LR + Beacon v1
- **Plan 2.7**: First Mesh Bonds — OY Bond primitive on-chain
-  - REQs: REQ-021
+## Parallelization Opportunities

-## Phase 3 — The Bearers (4 components)
+After P3 ships:
+- P4 (Bloom), P5 (Fee), P6 (Identity) can run in parallel (all depend only on P1-P3)
+- P5 depends only on P3; P6 depends on P1+P3; P4 depends on P2+P3

- **Plan 3.1**: Cross-Chain & Exit (Component 2)
- **Plan 3.2**: Bearers expansion — OY-SAT, OY-QR
- **Plan 3.3**: Hub API
- **Plan 3.4**: Full bond market + Growth Bonds
-
-## Phase 4 — Maturity
-
- Cross-chain expansion, Confederation support
- Yield Token, Travel + 11 service categories
+After P5+P6 ship:
+- P7 (Bearers) depends on P1+P2+P3+P5
+- P8 (Mesh UI) depends on P5+P6+P7

 ## Vertical Slice Integrity

-Each Wave is a vertical slice:
- Wave 1: chain + token + storage (can hold Bread)
- Wave 2: identity + fees + Bloom (Bread earns yield, fees enforced)
- Wave 3: bearers + UI (Holders can transact)
+| After Phase | Demoable End State |
+|---|---|
+| P1 | Chain runs, Watchers attest, Mirror live |
+| P2 | Bread minted against RWA, NAV published |
+| P3 | Holder has Stash, Root-Pool visible |
+| P4 | Bloom accrues to Stash automatically |
+| P5 | Fees enforced, waivers work, auto-decline |
+| P6 | Freeholder transition computed, vouching works |
+| P7 | Transact via BLE/WiFi-Direct, FCFS processing |
+| P8 | Full app: Maps, Pay, Standing, Mirror ratio |
+| P9 | Milestone v0.1 complete, ready for v0.2 |

-A demo after Phase 1: Holder can create Stash, receive Bread, watch Bloom accrue, see Mirror ratio.
+## Phase 2+ (Future Milestones)
+
+### Milestone v0.2 — The Mesh
+- Window, Pacts, Orgs, Partners, Governance, OY-LR, Bonds
+- Target: $1B annual volume (simulation)
+
+### Milestone v0.3 — The Bearers
+- Cross-Chain, OY-SAT, OY-QR, Hub API, Anchors, full bond market
+
+### Milestone v0.4 — Maturity
+- Cross-chain expansion, Confederation, Yield Token
+
+### MVP Release — v0.1.0
+- After v0.4 milestone completes and system is validated as production-ready
+- First public release to real Holders
@@ -55,5 +55,10 @@ OpenYield (OY) is a durable, anti-greed, jurisdiction-light financial layer —
 - Persona assessment
 - Phase plans

+## Key Decisions
+- D-002: OY Chain = Cosmos SDK + CosmWasm (confidence: 1.0, confirmed)
+- D-008: Milestone stays v0.1 until MVP; MVP ships as v0.1.0
+- D-009: Rebased history to fix v1.0 → v0.1 in ---ci--- blocks
+
 ## Milestone
 v0.1 — OpenYield Foundation Init (pre-MVP development milestone; remains v0.1 until MVP ships as v0.1.0)