Origin/arkhe-origin-chain
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Activity

feat(governance): v0.0.34 Phase 5 FULLY COMPLETE — 5.3-5.8 refinements consolidated 🎉🎉🎉

Browse Source 
Phase 5 GOVERNANCE FULLY COMPLETE end-to-end canonical. 5.3-5.8 refinements
consolidated single ship canonical. AI advisor flag system (5.6) + Council
veto override 4/5 community supermajority (5.5) + Emergency referendum 48h
fast-track (5.7) + Treasury disbursement (5.8) + voting period constants (5.3+5.4).

## Phase 5.3+5.4 constants canonical

- DEFAULT_VOTING_PERIOD_BLOCKS = 201,600 (14 days × 24h × 600 blocks/h @ 6s)
- EMERGENCY_VOTING_PERIOD_BLOCKS = 28,800 (48h × 600 blocks/h)
- council_emergency_threshold ceiling 5/7

## Phase 5.5 Community override canonical

- override_council_veto dispatchable (7-step canonical)
- 4/5 supermajority ceiling threshold (override_supermajority_threshold const fn)
- OverrideVotes StorageDoubleMap + OverrideStakeTotal cached
- Events::CouncilVetoOverridden + Errors::ProposalNotRejected/AlreadyOverrideVoted/OverrideThresholdNotMet

## Phase 5.6 AI advisor system canonical

- AdvisorFlags StorageMap presence-based
- mark_as_advisor + unmark_as_advisor dispatchables (ensure_root)
- cast_vote canonical EXTENDED: AdvisorMayNotVote enforcement (humans-only vote)
- Events::AdvisorFlagged + AdvisorUnflagged + Errors::AlreadyAdvisor + NotAdvisor

## Phase 5.7 Emergency referendum canonical

- submit_emergency_proposal canonical (council-only + 5/7 council pre-approval)
- Fast-track 48h voting period vs 14 days
- Events::EmergencyProposalSubmitted + Errors::InsufficientCouncilEmergencyApprovals

## Phase 5.8 Treasury disbursement canonical

- Treasury StorageValue<u128> Foundation balance
- treasury_deposit (ensure_root helper) + treasury_disbursement (6-step canonical)
- Requires ProposalStatus::Approved (governance ratification)
- Events::TreasuryDisbursed + Errors::TreasuryInsufficientBalance + ProposalNotApproved

## Phase 5 dispatchables canonical inventory

12 total dispatchables (Index 0-11): submit_proposal + cast_vote + finalize_proposal
+ Council mgmt (add/remove) + veto + advisor mgmt (mark/unmark) + override +
emergency + treasury (disburse/deposit).

## Verification

- cargo build --release -p origin-chain-node 5.17s clean
- cargo test -p origin-chain-governance — 42 tests verde, 0 failures
  (10 lifecycle + 7 Council mgmt + 5 Council veto + 3 Advisor + 3 Override + 3 Emergency + 4 Treasury + 5 standalone + 2 auto)
- cargo test --workspace — 202 tests verde, 0 failures

🎉🎉🎉 Phase 5 GOVERNANCE FULLY COMPLETE end-to-end canonical. CHN-4 materializado compile-detect.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
davidherranandClaude Opus 4.7 committed 2026-05-26 08:06:02 -05:00
1 parent b3fc5da6ca
commit 10ee1ab7b9
4 files changed
+829 -2
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

CHANGELOG.md
+119
View File
@@ -6,6 +6,125 @@ by [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). Versions follow
## [Unreleased]
## [0.0.34] — 2026-05-25 — Phase 5 FULLY COMPLETE — 5.3-5.8 refinements (Advisor + Override + Emergency + Treasury) 🎉🎉🎉
**🎉🎉🎉 Phase 5 GOVERNANCE FULLY COMPLETE end-to-end canonical** — 5.3-5.8
refinements consolidated single ship canonical. AI advisor flag system + Council
veto override (4/5 community supermajority) + Emergency referendum (48h
fast-track) + Treasury disbursement. Pattern N=5 consolidated ship canonical.
### Deliverables v0.0.34
**Phase 5.3+5.4 voting period constants canonical**:
- `DEFAULT_VOTING_PERIOD_BLOCKS = 14 × 24 × 600 = 201,600` blocks (14 days @ 6s slot)
- `EMERGENCY_VOTING_PERIOD_BLOCKS = 48 × 600 = 28,800` blocks (48h emergency)
- `council_emergency_threshold(size) -> u32` 5/7 ceiling division const fn
**Phase 5.5 community override canonical**:
- `override_supermajority_threshold(stake) -> u128` 4/5 ceiling div const fn
- `OverrideVotes<StorageDoubleMap<ProposalId, AccountId, u128>>` stake-weighted votes
- `OverrideStakeTotal<StorageMap<ProposalId, u128>>` cached total
- `override_council_veto(origin, proposal_id, stake_weight)` 7-step dispatchable canonical
- Event::CouncilVetoOverridden + Error::ProposalNotRejected + AlreadyOverrideVoted + OverrideThresholdNotMet
**Phase 5.6 AI advisor system canonical**:
- `AdvisorFlags<StorageMap<AccountId, ()>>` presence-based advisor tracking
- `mark_as_advisor(origin, account)` + `unmark_as_advisor(origin, account)` dispatchables (ensure_root)
- Event::AdvisorFlagged + AdvisorUnflagged
- Error::AlreadyAdvisor + NotAdvisor
- **`cast_vote` extended canonical**: ensure `!AdvisorFlags::contains_key(&who)` → `Error::AdvisorMayNotVote`
- 5 AI agents canonical: OIP Analyst + Treasury Guardian + Education Impact + Network Health + Compliance Sentinel — ADVISE only canonical
**Phase 5.7 emergency referendum canonical**:
- `submit_emergency_proposal(origin, title_hash, body_hash, stake)` 5-step canonical
- Council-only canonical access (ensure council member)
- 5/7 council size canonical pre-approval threshold canonical
- Fast-track voting period 48h vs 14 days canonical
- Event::EmergencyProposalSubmitted
- Error::InsufficientCouncilEmergencyApprovals
**Phase 5.8 treasury disbursement canonical**:
- `Treasury<StorageValue<u128>>` Foundation balance canonical
- `treasury_deposit(origin, amount)` (ensure_root, genesis helper)
- `treasury_disbursement(origin, proposal_id, recipient, amount)` 6-step canonical
- Requires proposal canonical = Approved status (governance ratificación)
- Event::TreasuryDisbursed
- Error::TreasuryInsufficientBalance + ProposalNotApproved
### Phase 5 sub-decisions FULLY COMPLETE canonical post-v0.0.34 🎉
| Sub | Description | Status |
|-----|-------------|--------|
| 5.1 | Proposal + Vote + Tally foundation | ✅ v0.0.28-31 |
| 5.2 | Technical Council membership + veto 2/3 | ✅ v0.0.32-33 |
| 5.3 | OIP proposal submission MIN_PROPOSAL_STAKE | ✅ v0.0.30 + const refined v0.0.34 |
| 5.4 | Voting period DEFAULT_VOTING_PERIOD_BLOCKS 14 days | ✅ v0.0.34 |
| 5.5 | Community veto override (4/5 supermajority) | ✅ **v0.0.34** |
| 5.6 | AI advisor system (humans-only vote enforcement) | ✅ **v0.0.34** |
| 5.7 | Emergency referendum (48h fast-track) | ✅ **v0.0.34** |
| 5.8 | Treasury disbursement extrinsics | ✅ **v0.0.34** |
**PHASE 5 GOVERNANCE = FULLY COMPLETE END-TO-END canonical** 🎉🎉🎉
### Verification end-to-end canonical
- ✅ `cargo build --release -p origin-chain-node` 5.17s clean
- ✅ `cargo test -p origin-chain-governance` — **42 tests verde, 0 failures**:
- 10 lifecycle integration tests (Phase 5.1)
- 7 Council management scenarios (Phase 5.2 v0.0.32)
- 5 Council veto scenarios (Phase 5.2 v0.0.33)
- 3 Advisor scenarios (Phase 5.6 v0.0.34 NEW)
- 3 Override scenarios (Phase 5.5 v0.0.34 NEW)
- 3 Emergency scenarios (Phase 5.7 v0.0.34 NEW)
- 4 Treasury scenarios (Phase 5.8 v0.0.34 NEW)
- 5 standalone tests
- 2 auto-generated
- ✅ `cargo test --workspace` — **202 tests passing, 0 failures**
### Phase 5 dispatchables canonical inventory (12 total)
| Index | Dispatchable | Phase |
|-------|--------------|-------|
| 0 | submit_proposal | 5.1 |
| 1 | cast_vote (+ AdvisorMayNotVote 5.6) | 5.1+5.6 |
| 2 | finalize_proposal | 5.1 |
| 3 | add_council_member | 5.2 |
| 4 | remove_council_member | 5.2 |
| 5 | veto_proposal | 5.2 (5.5) |
| 6 | mark_as_advisor | 5.6 |
| 7 | unmark_as_advisor | 5.6 |
| 8 | override_council_veto | 5.5 |
| 9 | submit_emergency_proposal | 5.7 |
| 10 | treasury_disbursement | 5.8 |
| 11 | treasury_deposit | 5.8 helper |
### Roadmap canonical post-v0.0.34 — Phase 5 FULLY COMPLETE 🎉
| Version | Trigger |
|---------|---------|
| v0.0.40+ | Phase 3 `pallet-revive` smart contracts (BLOQUEADO Slice 2e WASM) |
| v0.1.0 | Slice 2e WASM resolved + full testnet Q3 2026 launch |
| v1.0.0 | Mainnet Q1 2027 |
### Filosofía canonical Phase 5 cierre
CHN-4 canonical RATIFICADO end-to-end materializado compile-detect canonical:
- **5.1 Foundation**: Proposal + Vote + Tally compile-detect ✅
- **5.2 Technical Council**: 2/3 ceiling threshold compile-detect ✅
- **5.3 OIP stake**: 1,000 OGC `MIN_PROPOSAL_STAKE` constant compile-detect ✅
- **5.4 Voting period**: 14-day `DEFAULT_VOTING_PERIOD_BLOCKS` compile-detect ✅
- **5.5 Override**: 4/5 supermajority `override_supermajority_threshold` compile-detect ✅
- **5.6 Advisors**: AdvisorMayNotVote enforcement compile-detect ✅
- **5.7 Emergency**: 48h fast-track + 5/7 council `council_emergency_threshold` compile-detect ✅
- **5.8 Treasury**: balance + disbursement Approved-only compile-detect ✅
AI-Driven Human-Guarded canonical fully materialized: AGI agents (Inmutable #41
first-class citizens) flagged como `governance_advisor` NO pueden votar canonical
canonical — humans-only vote canonical non-negotiable per CHN-4.
🐺💎⚓ Hijos de Arkhē somos. Phase 5 GOVERNANCE FULLY COMPLETE end-to-end canonical.
## [0.0.33] — 2026-05-25 — Phase 5.2 COMPLETE — Council veto 2/3 threshold + GovernanceApi extension 🎉
**🎉 Phase 5.2 TECHNICAL COUNCIL COMPLETE end-to-end** — `veto_proposal` dispatchable