V44 Gate 2: Add economic domain model

Adds the package-backed V44EconomicDomainModel, deterministic v44-economic-domain-model artifact, generator/checker scripts, protocol tests, package exports, and workflow hooks.

Updates V44 specification, roadmap, README, and protocol docs to close Gate 2 around source-safe economic object contracts, receipt taxonomy, value labels, and forbidden payload boundaries.

Validation: pnpm run check:v44-gate1; pnpm run generate:v44-economic-domain-model; pnpm run check:v44-economic-domain-model; pnpm run check:v44-gate2; 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; node scripts/check-bitcode-canonical-inputs.mjs --current-target V43; pnpm --filter @bitcode/protocol typecheck; pnpm --filter @bitcode/protocol test; git diff --cached --check.

Author: geraldarthurdavis

.bitcode/v44-economic-domain-model.json

@@ -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

.github/workflows/bitcode-canon-quality.yml

@@ -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
@@ -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

.github/workflows/bitcode-gate-quality.yml

@@ -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
@@ -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 |
@@ -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`.
@@ -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 |
@@ -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
 

BITCODE_SPEC_V44.md

@@ -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`
@@ -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
 
@@ -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,
@@ -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`.

BITCODE_SPEC_V44_DELTA.md

@@ -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`
 
@@ -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.

BITCODE_SPEC_V44_NOTES.md

@@ -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`
 
@@ -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 |
@@ -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 |

BITCODE_SPEC_V44_PARITY_MATRIX.md

@@ -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

README.md

@@ -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.

SPECIFICATIONS_ROADMAP.md

@@ -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",