cloudinit-bot
7d1468b442
Add ARCHITECTURE.md §"Council Voice/Council Interface — Lifecycle Type Divergence Decisions (v0.4)": documents P1-1 (Proposal/VoteOption absent, deferred to v0.5+ governance runtime — feat: rejected by D-001), P1-2 (SignalKind 4-vs-5: the 4-source shape is intentional per AUDIT rationale; Freeholder is eligibility, Guild is council tier, Capital is committed- capital per vision §9.1), P2 (bearers ValidateGenesis no-op correct per spec). test(council): TestSignalKindShapeIntentional regression guard (REQ-031) Add intent-assertion test locking the 4-source SignalKind shape with the AUDIT §193 P1-2 rationale in the doc comment. A future agent changing SignalKindCount 4→5 must update this test, surfacing the rationale. No locked-const change, no production .go files modified (D-050). Verification: go test ./... green; only types_test.go modified in x/**. ---ci--- project: oy phase: 2 milestone: v0.4 status: execute tag_base: v0.3.x milestone_type: nfr reqs: [REQ-031] ---/ci---
Component 1: OY Chain & Mirror — Phase 1 Skeleton
Status
v0.0.1 — skeleton with type definitions and locked-constant tests
Vision References
- §7: Architecture — Three Layers and the Mirror
- §3: Still/Stir (pause/resume)
Modules
x/watcher — Watcher Bond & Attestation Quorum
types.Watcher— bonded Watcher (§7: 100,000 Bread minimum bond)types.Attestation— daily reserve snapshot signed by a Watchertypes.ReserveSnapshot— off-chain reserve state (off-chain total, on-chain Bread, basket breakdown)types.QuorumStatus— QuorumMet / QuorumLost / StaleEpochtypes.SlashReason— InsufficientBond / StaleAttestation / GeographicCollusion / Forgery
Locked constants (§7):
MinBond = 100000(100,000 Bread)Quorum = 6(6-of-9)MaxWatchers = 9AttestationEpochHours = 24(daily)
x/mirror — Reserve Ratio Publication
types.NavPerBread— Net Asset Value per Bread (§4.2)types.ReserveRatio— real-time published ratio with quorum flag
x/still — Pause/Resume (Still/Stir)
types.StillState— StirActive / StillPaused (§3)types.StillReason— CouncilVote / QuorumLost / SecurityAlerttypes.StillRecord— tracks pause events- Auto-still on quorum lost (§4.2: Forge/Fold blocked until quorum restored)
Tests
12 tests, all passing:
- Watcher: MinBond, Quorum, MaxWatchers, AttestationEpoch, DefaultParams (5)
- Still: DefaultStillState, AutoStillOnQuorumLost, StillStates (3)
- Mirror: DefaultPublishInterval, ModuleName, NavPerBreadStruct, ReserveRatioQuorum (4)
What's NOT in this skeleton (deferred to P1 completion)
- Cosmos SDK app.go full integration (requires SDK v0.50+ dependency resolution)
- Keeper implementations (BondWatcher, SubmitAttestation, VerifyQuorum, SlashWatcher)
- CLI commands (oyd tx watcher bond, oyd query watcher quorum)
- Proto definitions (Buf-generated types)
- CometBFT consensus setup
- Genesis import/export
Next Steps (P1 continuation)
- Resolve Cosmos SDK v0.50 dependency tree
- Implement keeper logic with store operations
- Add proto definitions and code generation
- Wire modules into app.go
- Build oyd daemon
- Integration test: 9 Watchers bond, submit attestations, verify quorum