hicommonwealth / commonwealth / 21838592412

37%

push

github

docs: Prediction Markets (Futarchy) integration spec (#13358)

* docs: add Prediction Markets (Futarchy) integration spec

Full engineering spec for integrating Futarchy Protocol prediction markets
into the Commonwealth platform. Includes architecture diagrams, data model
ERD, 10 pre-cut tickets (PM-1 through PM-10) with acceptance criteria,
dependency graph, test plan, and implementation phases.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs: add event storming model, consolidate schemas/models per review

Addresses PR review comments from @Rotorsoft:
- Consolidate entity schemas into single file (like quests pattern)
- Consolidate Sequelize models into single file (like quests pattern)
- Add full event storming model with 8 vertical slices
- Restructure tickets to derive from model slices
- Reduce from 10 to 9 tickets with clearer boundaries

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs: add FigJam diagram links to prediction markets spec

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs: add design decisions section with quests pattern references

Inlines the two key review decisions from @Rotorsoft:
1. Single schema file per domain (like quest.schemas.ts)
2. Single model file + aggregate directory (like quest.ts)

Includes side-by-side comparison tables mapping quests source
files to their prediction market equivalents and a status
checklist.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* Update common_knowledge/Prediction-Markets.md

Depending how many markets we are tracking, and how frequently we check to see if they have ended, we should have an index on like:
PredictionMarket (status, end_time)

judging from PredictionMarketDeployed.end_time we will probably be looping over this checking for ended markets in order to resolve them.

Co-authored-by: kurtassad <kurtisassad@gmail.com>

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
Co-authored-by: Roger Torr... (continued)

2017 of 5892 branches covered (34.23%)

Branch coverage included in aggregate %.

3569 of 9164 relevant lines covered (38.95%)

45.46 hits per line