Session Summary: Congress Redesign + Academy + Governance Engine (2026-03-27)

Development Session Summary — March 27, 2026

Session participants: Lennart Lopin (founder), Claude (AI development partner) Duration: Full day session Commits: 12 commits pushed to main

Major Changes

1. Congress Redesign (5 pages) All Congress pages transformed from old Bootstrap to the Martian Republic dark theme:

• Voting Hub — filter tabs, proposal cards with color-coded status borders, vote bars
• Proposal Detail — breadcrumb nav, content tabs, vote breakdown sidebar, diff viewer
• New Proposal — dark SimpleMDE, 4-tier preset selector, styled sliders
• Ballot — terminal-style console, ceremonial YES/NO/ABSTAIN buttons
• Not Eligible Yet — updated styling

2. The Academy (new section) Launched /academy with 4 deep articles:

• "How Mars Governs Itself" — complete guide to the 4-tier governance system (25 min)
• "The History of Blockchain Governance" — DAO failures and successes (20 min)
• "CoinShuffle: Secret Ballots on a Public Blockchain" — protocol deep dive (15 min)
• "Dynamic Quorum: Why Fixed Thresholds Kill DAOs" — the math (12 min)

Plus 11 upcoming article stubs across 4 learning paths.

3. New 4-Tier Governance System Replaced the old Poll/Regulation/Statute/Law/Amendment presets with a research-backed system:

• Signal (10% quorum, 7 sols) — temperature checks
• Operational (25% quorum, 14 sols + 3-sol timelock) — day-to-day decisions
• Legislative (40% quorum, 30 sols + 7-sol timelock, quiet ending) — significant policy
• Constitutional (50% quorum, 60 sols + 30-sol timelock, quiet ending) — code changes

Based on analysis of 15+ DAO governance systems and 636 research sources.

4. LegislationRepo (git-based proposal versioning) Every proposal now gets a git branch. Amendments are commits. Diffs are rendered with diff2html. The git history IS the legislative record.

5. Database Migrations

• Added tier, screening/voting/timelock timestamps to proposals table
• Created proposal_challenges + challenge_votes tables for tier reclassification
• Created governance_config table for dynamic quorum (EMA formula)
• Migrated existing proposals to Signal tier

6. Governance Lifecycle Engine

• GovernanceTiers.php — single source of truth for all tier parameters
• Automatic phase transitions: screening → voting → timelock → active → sunset
• Screening period with challenge, amend (1x), and withdraw capabilities

7. Landing Page

• "Docs" renamed to "Academy" in nav, footer, and hero CTA

What's Next

• Full smoke test of the ballot server and CoinShuffle protocol
• Register third AI citizen for 3-voter testing
• Phase 3: cron jobs for dynamic quorum, quiet ending, sunset expiration
• Integration of git diffs into Constitutional proposals

All code is open source at github.com/marscoin/martianrepublic

Session update (end of day): 30+ commits pushed. All Congress pages redesigned. Academy launched with 4 articles. Governance engine built (4-tier system + lifecycle + LegislationRepo). Logbook redesigned as The Chronicle. 3 AI test citizens configured for smoke test. Endorsement transactions in mempool awaiting confirmation. Next session: full 4-voter smoke test of the ballot server and CoinShuffle protocol.

Session update (2026-03-28): First successful 3-voter CoinShuffle ballot completed! Ballot tx 205f61ec5c7064382bd3af3ffcd03149c2062cc165bea392bf464db9f480f6fe broadcast to Marscoin blockchain. 7 bugs found and fixed during smoke test: websockets v14 API change, Cloudflare port blocking (Apache WebSocket proxy), proxy peer matching (all clients = 127.0.0.1), broadcastTxHash temporal dead zone, stale shuffle state, pebas broadcast hanging (no error response), Electrum maxfeerate rejection (CLI fallback). Also fixed: endorsement UX, logbook FilePond replacement, DataTables CDN, modal stacking, notarize pending state.