Skip to content

V44 Gate 2: Economic Domain Model And Receipt Taxonomy #192

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
garrettmaring merged 1 commit into from
May 29, 2026
Merged

V44 Gate 2: Economic Domain Model And Receipt Taxonomy #192

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
906 changes: 906 additions & 0 deletions .bitcode/v44-economic-domain-model.json
View file
Open in desktop

Large diffs are not rendered by default.

3 changes: 3 additions & 0 deletions .github/workflows/bitcode-canon-quality.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -364,6 +364,9 @@ jobs:
if [ -f BITCODE_SPEC_V44.md ]; then
node scripts/check-bitcode-spec-family.mjs --version V44 --mode draft --current-target V43
node scripts/check-v44-gate1-scaled-economy-roadmap-opening.mjs --skip-branch-check
if [ -f scripts/check-v44-gate2-economic-domain-model.mjs ]; then
node scripts/check-v44-gate2-economic-domain-model.mjs --skip-branch-check --skip-package-tests
fi
fi
else
echo "Unexpected BITCODE_SPEC.txt pointer: $POINTER" >&2
Expand Down
6 changes: 6 additions & 0 deletions .github/workflows/bitcode-gate-quality.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -493,6 +493,9 @@ jobs:
if [ -f BITCODE_SPEC_V44.md ]; then
node scripts/check-bitcode-spec-family.mjs --version V44 --mode draft --current-target V43
node scripts/check-v44-gate1-scaled-economy-roadmap-opening.mjs --skip-branch-check
if [ -f scripts/check-v44-gate2-economic-domain-model.mjs ]; then
node scripts/check-v44-gate2-economic-domain-model.mjs --skip-branch-check --skip-package-tests
fi
fi
else
echo "Unexpected BITCODE_SPEC.txt pointer: $POINTER" >&2
Expand Down Expand Up @@ -528,6 +531,9 @@ jobs:
if [ "$POINTER" = "V43" ] && [ -f scripts/check-v44-gate1-scaled-economy-roadmap-opening.mjs ]; then
node scripts/check-v44-gate1-scaled-economy-roadmap-opening.mjs --skip-branch-check
fi
if [ "$POINTER" = "V43" ] && [ -f scripts/check-v44-gate2-economic-domain-model.mjs ]; then
node scripts/check-v44-gate2-economic-domain-model.mjs --skip-branch-check --skip-package-tests
fi
if [ "$POINTER" != "V43" ]; then
if [ -f scripts/check-v43-gate1-packs-read-deposit-roadmap.mjs ]; then
node scripts/check-v43-gate1-packs-read-deposit-roadmap.mjs --skip-branch-check
Expand Down
27 changes: 24 additions & 3 deletions BITCODE_SPEC_V44.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -184,6 +184,23 @@ compensation statements, governance decisions, and repair cases. It must label
estimate, quote, observed payment, final settlement, contributor allocation,
delivery, and repair states distinctly.

Gate 2 closes through `V44EconomicDomainModel` in
`packages/protocol/src/canonical/v44-economic-domain-model.js`, deterministic
`.bitcode/v44-economic-domain-model.json`, `generate:v44-economic-domain-model`,
`check:v44-economic-domain-model`, and `check:v44-gate2`. The artifact names
EnterprisePackPortfolio, PackPortfolioPosition, PackMarketSignal,
ReadDemandSignal, UnfitNeedSignal, DepositSupplyOpportunity,
ReadingBudgetPolicy, AssetPackQuotePolicy, ProcurementApprovalReceipt,
DepositorEarningStatement, ContributorCompensationStatement,
PackEconomicStatement, OrganizationPackPolicy, PackGovernanceDecision,
ScaledNetworkRehearsalReceipt, and PortfolioRepairCase as source-safe economic
objects. The receipt taxonomy names portfolio-position, market-signal,
quote-state, settlement-state, compensation-statement, governance-decision,
repair-case, budget-policy, supply-opportunity, and network-rehearsal. It does
not expose protected source, unpaid AssetPack source, raw prompts, provider
payloads, credentials, wallet private material, private settlement payloads, or
value-bearing mainnet operation.

## V44 Gate 3 Packs Portfolio Search And Market Intelligence

Gate 3 must evolve `/packs` from activity master-detail into portfolio and
Expand Down Expand Up @@ -561,7 +578,7 @@ quality, accessibility, visual inspectability, and generated quality evidence.
| `.bitcode/v44-spec-family-report.json` | aggregate proof verdict | draft-required |
| `.bitcode/v44-canonical-input-report.json` | generated artifact inventories | draft-required |
| `.bitcode/v44-canon-posture-drift-report.json` | active/draft posture | draft-required |
| `.bitcode/v44-economic-domain-model.json` | economic domain model | planned |
| `.bitcode/v44-economic-domain-model.json` | economic domain model | implemented-source-safe |
| `.bitcode/v44-packs-portfolio-market-intelligence.json` | Packs portfolio and market intelligence | planned |
| `.bitcode/v44-reading-budget-quote-policy.json` | Reading budget and quote policy | planned |
| `.bitcode/v44-depositor-earnings-supply-opportunities.json` | depositor earnings and supply opportunities | planned |
Expand Down Expand Up @@ -629,7 +646,10 @@ explicit later launch authority, or economic receipts cannot reconcile.

## V44 validation canon

Gate 1 validates with `pnpm run check:v44-gate1`,
Gate 1 validates with `pnpm run check:v44-gate1`. Gate 2 validates with
`pnpm run generate:v44-economic-domain-model`,
`pnpm run check:v44-economic-domain-model`, and `pnpm run check:v44-gate2`.
Shared draft posture validates with
`node scripts/check-bitcode-spec-family.mjs --version V44 --mode draft --current-target V43`,
`node scripts/check-bitcode-canon-posture-drift.mjs --active-canon V43 --draft-target V44`,
and `git diff --check`.
Expand Down Expand Up @@ -700,7 +720,7 @@ Inherited.
| `.bitcode/v44-spec-family-report.json` | aggregate proof verdict | draft-required |
| `.bitcode/v44-canonical-input-report.json` | exact generated-artifact inventory | draft-required |
| `.bitcode/v44-canon-posture-drift-report.json` | active/draft posture | draft-required |
| `.bitcode/v44-economic-domain-model.json` | economic domain model | planned |
| `.bitcode/v44-economic-domain-model.json` | economic domain model | implemented-source-safe |
| `.bitcode/v44-packs-portfolio-market-intelligence.json` | portfolio and market intelligence | planned |
| `.bitcode/v44-reading-budget-quote-policy.json` | budget and quote policy | planned |
| `.bitcode/v44-depositor-earnings-supply-opportunities.json` | depositor earning opportunity | planned |
Expand All @@ -715,6 +735,7 @@ Inherited.
`.bitcode/v44-spec-family-report.json`,
`.bitcode/v44-canonical-input-report.json`, and
`.bitcode/v44-canon-posture-drift-report.json` are the opening artifacts.
Gate 2 adds deterministic `.bitcode/v44-economic-domain-model.json`.

### Shared generated-artifact fields

Expand Down
19 changes: 15 additions & 4 deletions BITCODE_SPEC_V44_DELTA.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,12 +3,12 @@
## Status

- Version: `V44`
- V44 state: draft opened for scaled engineering economy and tokenized AssetPack network work over promoted V43
- V44 state: draft Gate 2 economic domain model work over promoted V43
- Current canonical/latest target: `V43`
- Prior canonical anchor: `BITCODE_SPEC_V43.md`
- Prior generated proof appendix: `BITCODE_SPEC_V43_PROVEN.md`
- Generated structured artifact inventory: no V44 generated artifacts are canonical at Gate 1; later gates must create source-safe `.bitcode/v44-*` artifacts
- Source parity state: Gate 1 aligns specification, roadmap, docs, workflow, package script, and checker posture only
- Generated structured artifact inventory: Gate 2 adds deterministic `.bitcode/v44-economic-domain-model.json`
- Source parity state: Gate 2 binds package-backed economic object contracts, receipt taxonomy, docs, workflow, package script, checker, and protocol tests
- Notes companion: `BITCODE_SPEC_V44_NOTES.md`
- Delta companion: `BITCODE_SPEC_V44_DELTA.md`
- Parity companion: `BITCODE_SPEC_V44_PARITY_MATRIX.md`
Expand All @@ -32,6 +32,9 @@ settlements, contributors, compensation statements, and repair states.
settlement, contributor allocation, delivery, or repair state.
- Keep source-safety stronger than UX convenience.
- Keep value-bearing mainnet blocked until a later explicit launch version.
- Bind Gate 2 economic contracts in package code before route/API/UI surfaces
consume portfolio, quote, settlement, compensation, governance, or repair
objects.

## V44 gate plan

Expand All @@ -53,6 +56,11 @@ APIs, budget policy engines, compensation statement materialization, governance
runtime enforcement, scaled rehearsal scripts, and V44 promotion workflow until
their owning gates.

V44 Gate 2 closes the source-safe economic domain model and receipt taxonomy
only. It does not implement route dashboards, quote engines, settlement
observation, compensation payout execution, organization wallet authority, or
scaled rehearsals.

## Pre-Implementation Sequence

1. Open V44 spec family, roadmap, checker, package script, workflow posture,
Expand All @@ -70,7 +78,10 @@ their owning gates.

## Validation direction

Gate 1 validates with `pnpm run check:v44-gate1`,
Gate 1 validates with `pnpm run check:v44-gate1`. Gate 2 validates with
`pnpm run generate:v44-economic-domain-model`,
`pnpm run check:v44-economic-domain-model`, and `pnpm run check:v44-gate2`.
Shared draft posture validates with
`node scripts/check-bitcode-spec-family.mjs --version V44 --mode draft --current-target V43`,
`node scripts/check-bitcode-canon-posture-drift.mjs --active-canon V43 --draft-target V44`,
and `git diff --check`.
Expand Down
18 changes: 15 additions & 3 deletions BITCODE_SPEC_V44_NOTES.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,12 +3,12 @@
## Status

- Version: `V44`
- V44 state: draft notes opened for scaled engineering economy work over promoted V43
- V44 state: draft notes include Gate 2 economic domain model work over promoted V43
- Current canonical/latest target: `V43`
- Prior canonical anchor: `BITCODE_SPEC_V43.md`
- Prior generated proof appendix: `BITCODE_SPEC_V43_PROVEN.md`
- Generated structured artifact inventory: V44 notes bind planning language only until later generated `.bitcode/v44-*` artifacts exist
- Source parity state: notes align roadmap, docs, and workflow posture for active V43 / draft V44
- Generated structured artifact inventory: Gate 2 adds deterministic `.bitcode/v44-economic-domain-model.json`
- Source parity state: notes align roadmap, docs, workflow posture, package source, generated artifact, and receipt taxonomy for active V43 / draft V44
- Scope: V44 notes for digitizing and tokenizing scaled engineering economies through enterprise AssetPack portfolio, market intelligence, BTD/BTC accounting, governance, and compensation operation
- Last fully realized canonical target preserved in source: `V43`

Expand Down Expand Up @@ -82,3 +82,15 @@ wallet private material, or private settlement payloads.
Gate 1 is intentionally a posture gate. It opens the V44 family and validates
that the repo now understands V43 active / V44 draft. It must not implement
later economic products under a loose roadmap commit.

## Gate 2 note

Gate 2 names the economic objects before later gates render or execute them.
The package-backed receipt taxonomy distinguishes portfolio-position,
market-signal, quote-state, settlement-state, compensation-statement,
governance-decision, repair-case, budget-policy, supply-opportunity, and
network-rehearsal receipts. Its value labels remain estimate, quote, observed
payment, final settlement, contributor allocation, delivery, and repair state.
This is intentionally source-safe: it carries identifiers, roots, states, and
contracts, not protected source, unpaid AssetPack source, raw prompts, provider
payloads, credentials, wallet private material, or private settlement payloads.
14 changes: 7 additions & 7 deletions BITCODE_SPEC_V44_PARITY_MATRIX.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,12 +3,12 @@
## Status

- Version: `V44`
- V44 state: draft parity opened for scaled engineering economy and tokenized AssetPack network work
- V44 state: draft parity includes Gate 2 economic domain model work
- Current canonical/latest target: `V43`
- Prior canonical anchor: `BITCODE_SPEC_V43.md`
- Prior generated proof appendix: `BITCODE_SPEC_V43_PROVEN.md`
- Generated structured artifact inventory: V44 parity begins as planning metadata; later gates must close generated `.bitcode/v44-*` artifacts
- Source parity state: Gate 1 requires spec/docs/workflow/checker parity only
- Generated structured artifact inventory: Gate 2 adds deterministic `.bitcode/v44-economic-domain-model.json`
- Source parity state: Gate 2 requires package/docs/workflow/checker/test parity for the economic receipt taxonomy
- Scope: parity for V44 enterprise economic operation over promoted V43 product routes
- Last fully realized canonical target preserved in source: `V43`

Expand All @@ -28,8 +28,8 @@ artifacts, workflow checks, and local/staging rehearsal receipts.

| Area | Required V44 result | Current judgment |
| --- | --- | --- |
| Gate 1 roadmap | V43 active / V44 draft posture, spec family, docs, workflow, package script, checker | drafted |
| Economic domain model | Portfolio positions, market signals, quote states, settlement states, statements, repair cases | drafted |
| Gate 1 roadmap | V43 active / V44 draft posture, spec family, docs, workflow, package script, checker | implemented |
| Economic domain model | Portfolio positions, market signals, quote states, settlement states, statements, repair cases | implemented |
| Packs portfolio | `/packs` portfolio search, market intelligence, saved filters, economic facets | drafted |
| Reading procurement | Budget, quote policy, approval thresholds, purchase governance | drafted |
| Depositor earnings | ROI, demand, compensation opportunity, supply recommendations | drafted |
Expand All @@ -43,8 +43,8 @@ artifacts, workflow checks, and local/staging rehearsal receipts.

| Area | Required V44 result | Current judgment |
| --- | --- | --- |
| Source safety | No protected source, unpaid source, raw prompts, provider payloads, credentials, wallet secrets | drafted |
| Economic labels | Estimate, quote, observed payment, settlement, allocation, delivery, repair are distinct | drafted |
| Source safety | No protected source, unpaid source, raw prompts, provider payloads, credentials, wallet secrets | implemented |
| Economic labels | Estimate, quote, observed payment, settlement, allocation, delivery, repair are distinct | implemented |
| Ledger reconciliation | Portfolio statements reconcile to receipts before finality | drafted |
| Route authority | `/packs`, `/read`, `/deposit` do not bypass protocol law | drafted |
| Tests and proofs | Each gate has generated artifacts, package tests, route tests, and workflow checks | drafted |
Expand Down
12 changes: 12 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -289,6 +289,18 @@ local/staging-testnet rehearsal, and polished economic operation through
`/packs`, `/read`, and `/deposit`. Gate 1 is specification, roadmap,
documentation, workflow, and checker posture only.

V44 Gate 2 adds `V44EconomicDomainModel`,
`.bitcode/v44-economic-domain-model.json`,
`generate:v44-economic-domain-model`, `check:v44-economic-domain-model`, and
`check:v44-gate2`. It defines source-safe contracts for portfolio positions,
market signals, quote states, settlement states, compensation statements,
governance decisions, and repair cases while keeping economic values labeled
as estimate, quote, observed payment, final settlement, contributor
allocation, delivery, or repair state. Gate 2 does not expose protected source,
unpaid AssetPack source, raw prompts, provider payloads, credentials, wallet
private material, private settlement payloads, or value-bearing mainnet
operation.

Exchange is inherited V36 canon: market-wide activity master-detail, buy/sell/
bid/ask/cancel/accept/settle/history flows, AssetPack range trading,
rights-transfer review, pricing/liquidity/wrapper analysis, settlement
Expand Down
5 changes: 3 additions & 2 deletions SPECIFICATIONS_ROADMAP.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,11 +5,12 @@
- Current active canonical pointer: `BITCODE_SPEC.txt` -> `V43`
- Current active canon: `BITCODE_SPEC_V43.md`
- Current draft target: `BITCODE_SPEC_V44.md`.
- Current working gate: V44 Gate 1 Scaled Engineering Economy Roadmap Opening.
- Next queued work after V44 Gate 1: V44 economic domain model and receipt taxonomy, `/packs` portfolio market intelligence, Reading budget/quote governance, Depositor earning intelligence, BTD/BTC compensation statements, organization policy, enterprise UX, scaled local/staging rehearsal, and V44 promotion readiness.
- Current working gate: V44 Gate 2 Economic Domain Model And Receipt Taxonomy.
- Next queued work after V44 Gate 2: `/packs` portfolio market intelligence, Reading budget/quote governance, Depositor earning intelligence, BTD/BTC compensation statements, organization policy, enterprise UX, scaled local/staging rehearsal, and V44 promotion readiness.
- Latest closed version: V43 Route Product Cleanup, which promoted `/packs`, `/read`, and `/deposit`; PackActivity master-detail; five-step Reading route UX; deposit AssetPack option synthesis; deposit criticality/ROI/compensation policy; option admission; product route UX; cross-route rehearsal; and V43 promotion readiness.
- Recent V43 canonical promotion anchor: V43 canonical promotion updated `BITCODE_SPEC.txt` to `V43`, generated `BITCODE_SPEC_V43_PROVEN.md`, preserved active V43 / draft V44 runtime posture, and closed route-product cleanup canon.
- V44 Gate 1 opening anchor: scaled engineering economy opens over promoted V43 with V44 SPEC, DELTA, NOTES, and PARITY files, `check:v44-gate1`, active V43 / draft V44 posture, and a ten-gate plan for economic domain models, Packs portfolio intelligence, Reading budget/quote governance, Depositor earnings/ROI intelligence, BTD/BTC compensation statements, organization policy/wallet authority, enterprise economic UX, scaled local/staging rehearsal, and promotion readiness.
- V44 Gate 2 closure anchor: scaled engineering economy now owns package-backed `V44EconomicDomainModel`, deterministic `.bitcode/v44-economic-domain-model.json`, source-safe object contracts for EnterprisePackPortfolio, PackPortfolioPosition, PackMarketSignal, ReadDemandSignal, UnfitNeedSignal, DepositSupplyOpportunity, ReadingBudgetPolicy, AssetPackQuotePolicy, ProcurementApprovalReceipt, DepositorEarningStatement, ContributorCompensationStatement, PackEconomicStatement, OrganizationPackPolicy, PackGovernanceDecision, ScaledNetworkRehearsalReceipt, and PortfolioRepairCase, receipt taxonomy coverage for portfolio positions, market signals, quote states, settlement states, compensation statements, governance decisions, repair cases, budget policies, supply opportunities, and network rehearsals, distinct estimate/quote/observed payment/final settlement/contributor allocation/delivery/repair labels, source-safe forbidden payload checks, package exports, protocol tests, workflow wiring, and `check:v44-gate2`.
- Latest prior closed version: V42 Reliable MVP Experience, which promoted shortest-path Depositing, five-step Reading, ReadNeed review/resynthesis, ReadFitsFinding source-safe preview and quote, settlement rights transfer, repository delivery, AI-reading demonstration, local/staging MVP rehearsal, and V42 promotion readiness.
- Recent V42 canonical promotion anchor: V42 canonical promotion updated `BITCODE_SPEC.txt` to `V42`, generated `BITCODE_SPEC_V42_PROVEN.md`, preserved active V42 / draft V43 runtime posture, and closed reliable MVP experience canon.
- Recent V42 opening anchor: reliable MVP experience opens over promoted V41 with V42 SPEC, DELTA, NOTES, and PARITY files, `check:v42-gate1`, active V41 / draft V42 posture, and a nine-gate plan for shortest-path Depositing, five-step Reading, ReadNeed product closure, ReadFitsFinding preview and quote closure, settlement and repository delivery, AI-reading demonstration, local/staging rehearsal, and promotion readiness.
Expand Down
3 changes: 3 additions & 0 deletions package.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -359,6 +359,9 @@
"check:v43-promotion-readiness": "node scripts/generate-v43-promotion-readiness-report.mjs --check",
"check:v43-gate10": "node scripts/check-v43-gate10-promotion-readiness.mjs",
"check:v44-gate1": "node scripts/check-v44-gate1-scaled-economy-roadmap-opening.mjs",
"generate:v44-economic-domain-model": "node scripts/generate-v44-economic-domain-model.mjs",
"check:v44-economic-domain-model": "node scripts/generate-v44-economic-domain-model.mjs --check",
"check:v44-gate2": "node scripts/check-v44-gate2-economic-domain-model.mjs",
"generate:v38-inference-surface-inventory": "node scripts/generate-v38-inference-surface-inventory.mjs",
"check:v38-inference-surface-inventory": "node scripts/generate-v38-inference-surface-inventory.mjs --check",
"check:v38-gate2": "node scripts/check-v38-gate2-inference-surface-inventory.mjs",
Expand Down
Loading
Loading