V44 Gate 1: Open scaled economy roadmap

Open the V44 draft specification family for scaled engineering economy work over promoted V43 routes. Update roadmap, README, protocol docs, PR template, workflow posture, and package script wiring for active V43 / draft V44 validation. Add the V44 Gate 1 checker and validate source-safe roadmap posture without implementing later economic product surfaces.

Author: geraldarthurdavis

.github/pull_request_template.md

@@ -1,7 +1,7 @@
 ## Title
 
-Use the version and gate prefix for gate PRs: `V43 Gate N: Concise Topical Title`.
-Use the version and promotion prefix for version promotion PRs: `V43 Canonical Promotion: Concise Topical Title`.
+Use the version and gate prefix for gate PRs: `V44 Gate N: Concise Topical Title`.
+Use the version and promotion prefix for version promotion PRs: `V44 Canonical Promotion: Concise Topical Title`.
 
 ## Closure
 

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

@@ -363,6 +363,7 @@ jobs:
             node scripts/check-v43-gate10-promotion-readiness.mjs --promotion-mode --skip-branch-check --skip-package-tests
             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
             fi
           else
             echo "Unexpected BITCODE_SPEC.txt pointer: $POINTER" >&2
@@ -519,7 +520,10 @@ jobs:
                 node scripts/check-bitcode-spec-family.mjs --version V43 --mode draft --current-target V42
               fi
               ;;
+            spec:\ V44*|spec:\ v44*)
+              node scripts/check-bitcode-spec-family.mjs --version V44 --mode draft --current-target V43
+              ;;
             *)
-              echo "Skipping strict spec-title conformance; title is not a V29/V30/V31/V32/V33/V34/V35/V36/V37/V38/V39/V40/V41/V42/V43 spec change."
+              echo "Skipping strict spec-title conformance; title is not a V29/V30/V31/V32/V33/V34/V35/V36/V37/V38/V39/V40/V41/V42/V43/V44 spec change."
               ;;
           esac

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

@@ -492,6 +492,7 @@ jobs:
             node scripts/check-v43-gate10-promotion-readiness.mjs --promotion-mode --skip-branch-check --skip-package-tests
             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
             fi
           else
             echo "Unexpected BITCODE_SPEC.txt pointer: $POINTER" >&2
@@ -524,6 +525,9 @@ jobs:
             else
               node scripts/check-v43-gate10-promotion-readiness.mjs --promotion-mode --skip-branch-check
             fi
+            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" ]; 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

BITCODE_SPEC_V44.md

@@ -0,0 +1,83 @@
+# Bitcode Spec V44 Delta
+
+## Status
+
+- Version: `V44`
+- V44 state: draft opened for scaled engineering economy and tokenized AssetPack network 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
+- Notes companion: `BITCODE_SPEC_V44_NOTES.md`
+- Delta companion: `BITCODE_SPEC_V44_DELTA.md`
+- Parity companion: `BITCODE_SPEC_V44_PARITY_MATRIX.md`
+- Scope: delta from V43 product-route/agentic-depositing canon to V44 scaled engineering economy operation
+- Last fully realized canonical target preserved in source: `V43`
+
+## Why V44 exists
+
+V43 made the product routes intelligible: AssetPacks in through `/deposit`,
+AssetPacks out through `/read`, and PackActivity inspection through `/packs`.
+V44 exists because an enterprise-grade Bitcode network must operate at scale:
+many departments, budgets, repositories, deposit options, Reads, Fits, quotes,
+settlements, contributors, compensation statements, and repair states.
+
+## Accepted V44 decisions
+
+- Treat scaled economic operation as the next draft target over V43.
+- Keep V43 route law: `/packs`, `/read`, and `/deposit` remain the default
+  product surfaces.
+- Name every economic field as estimate, quote, observed payment, final
+  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.
+
+## V44 gate plan
+
+1. Gate 1 Scaled Engineering Economy Roadmap Opening.
+2. Gate 2 Economic Domain Model And Receipt Taxonomy.
+3. Gate 3 Packs Portfolio Search And Market Intelligence.
+4. Gate 4 Reading Budget, Quote Policy, And Procurement Governance.
+5. Gate 5 Depositor Earnings, ROI, And Supply Opportunity Intelligence.
+6. Gate 6 BTD/BTC Accounting And Contributor Compensation Statements.
+7. Gate 7 Organization Policy, Approval, And Wallet Authority.
+8. Gate 8 Enterprise Product UX For Economic Operation.
+9. Gate 9 Scaled Local/Staging Network Rehearsal.
+10. Gate 10 Promotion Readiness.
+
+## Explicitly deferred
+
+V44 Gate 1 defers implementation of portfolio dashboards, economic statement
+APIs, budget policy engines, compensation statement materialization, governance
+runtime enforcement, scaled rehearsal scripts, and V44 promotion workflow until
+their owning gates.
+
+## Pre-Implementation Sequence
+
+1. Open V44 spec family, roadmap, checker, package script, workflow posture,
+   and documentation.
+2. Implement economic domain model and receipt taxonomy for source-safe
+   portfolio, quote, statement, governance, and repair objects.
+3. Extend `/packs` into portfolio analytics, search, and market intelligence.
+4. Add Reading budget policy, quote policy, and procurement governance.
+5. Add deposit revenue, demand, ROI, and supply opportunity readback.
+6. Add BTD/BTC/source-to-shares compensation statements and reconciliation.
+7. Add organization policy, approval, spend authority, and wallet authority.
+8. Rehearse scaled many-pack local/staging-testnet economic operation.
+9. Polish enterprise economy UX and operator dashboards.
+10. Close V44 promotion readiness and prepare active V44 / draft V45 posture.
+
+## Validation direction
+
+Gate 1 validates with `pnpm run check:v44-gate1`,
+`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`.
+
+## Commit-Body Direction
+
+V44 commit bodies should name the closed gate, generated artifacts or proof
+surfaces touched, source-safety posture, validation commands, accepted
+boundaries, and any deferred economic implementation work. They should not use
+temporary `wip` wording for closed gate work.

BITCODE_SPEC_V44_DELTA.md

@@ -0,0 +1,84 @@
+# Bitcode Spec V44 Notes
+
+## Status
+
+- Version: `V44`
+- V44 state: draft notes opened for scaled engineering economy 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
+- 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`
+
+## Notes companion rule
+
+These notes clarify V44 only. The active canon remains V43 until V44 promotion.
+
+## Concise current-system reading
+
+V43 made the commercial product paths legible:
+
+- `/deposit` creates reviewed, source-safe AssetPack supply options.
+- `/read` buys synthesized Need-Fit AssetPacks after review, settlement, and
+  rights transfer.
+- `/packs` inspects pack activity, proof roots, settlement, delivery,
+  compensation, and repair state.
+
+V44 should now make those paths operable for scaled engineering economies:
+portfolio positions, demand signals, supply opportunities, budgets, quotes,
+approvals, BTC settlement, BTD rights, source-to-shares allocation,
+compensation statements, and repair cases must be visible as source-safe
+economic truth.
+
+## Simplified-spec reading rule
+
+When V44 work becomes broad, reduce it to the economic law:
+
+1. Packs is portfolio, market intelligence, proof, and repair inspection.
+2. Read is budgeted procurement of source-bearing technical knowledge after
+   Need review, Finding Fits, quote approval, BTC settlement, BTD rights
+   transfer, and delivery.
+3. Deposit is supply creation and earning visibility over source-safe
+   AssetPack options and admitted Depository supply.
+4. Statements must distinguish estimate, quote, observed payment, final
+   settlement, contributor allocation, delivery, and repair state.
+5. Source is never disclosed before paid settlement and rights transfer.
+
+## V44 scaled economy note
+
+The product now has the right route shape. V44 should make that route shape
+economically operable at enterprise scale. `/packs` should become the
+portfolio and market-intelligence surface; `/read` should support budgeted
+procurement and quote approval; `/deposit` should support earning visibility,
+supply opportunity intelligence, and contributor compensation readback.
+
+## Economic label precision
+
+Every economic projection must say exactly what kind of value it is:
+estimate, quote, observed payment, final settlement, contributor allocation,
+delivery state, repair state, or statement. If the value has not settled on
+ledger, it is not ledger truth.
+
+## Governance note
+
+Scaled Reading and Depositing require organization policy. V44 should bind
+roles, budgets, approval thresholds, wallet authority, source criticality,
+deposit limits, and spend limits without allowing any policy surface to bypass
+Need review, Finding Fits, settlement, rights transfer, delivery, or
+source-to-shares law.
+
+## Source-safety note
+
+Market intelligence is useful only if it is safe. Unfit Need signals, demand
+signals, supply opportunities, portfolio positions, and compensation statements
+must remain metadata and proof roots. They must not serialize protected source,
+unpaid AssetPack source, raw prompts, raw provider responses, credentials,
+wallet private material, or private settlement payloads.
+
+## Gate 1 note
+
+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.

BITCODE_SPEC_V44_NOTES.md

@@ -0,0 +1,61 @@
+# Bitcode Spec V44 Parity Matrix
+
+## Status
+
+- Version: `V44`
+- V44 state: draft parity opened for scaled engineering economy and tokenized AssetPack network 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
+- Scope: parity for V44 enterprise economic operation over promoted V43 product routes
+- Last fully realized canonical target preserved in source: `V43`
+
+## Purpose
+
+This matrix tracks the gap between promoted V43 product routes and the V44
+scaled engineering economy target.
+
+## Audit basis
+
+Audit V44 against `BITCODE_SPEC_V44.md`, promoted V43 canon, `/packs`, `/read`,
+`/deposit`, PackActivity, Reading, deposit AssetPack options, BTD/BTC
+settlement, source-to-shares accounting, organization policy, generated
+artifacts, workflow checks, and local/staging rehearsal receipts.
+
+## V44 implementation matrix
+
+| 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 |
+| 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 |
+| Accounting statements | BTD/BTC/source-to-shares statements and reconciliation | drafted |
+| Organization governance | Roles, budgets, wallet authority, source criticality, approvals | drafted |
+| Enterprise UX | Dense economic surfaces, proof expansion, responsive/accessibility proof | drafted |
+| Scaled rehearsal | Many-pack, many-org local/staging-testnet economic rehearsal | drafted |
+| Promotion readiness | Generated PROVEN, workflow, all V44 artifacts bound | drafted |
+
+## V44 implementation checklist
+
+| 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 |
+| 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 |
+
+## Accepted boundaries
+
+V44 must not weaken V43 source-safety, V42 settlement/delivery, V30 Protocol/BTD
+rails, V27 BTD law, V36 economic exchange truth, V38 inference boundaries, or
+V41 prompt-program discipline.
+
+## Completion condition
+
+V44 is complete when every matrix row is closed, source-safe, generated,
+tested, rehearsed, documented, and promotion-ready.

BITCODE_SPEC_V44_PARITY_MATRIX.md

@@ -1,24 +1,23 @@
 # Bitcode Repository
 
 `BITCODE_SPEC.txt` is the canonical pointer for active-system work. It currently
-resolves to `V42`; V43 is the active draft target for the Packs, Read, Deposit
-route model, agentic deposit AssetPack options, and product UX cleanup after the
-promoted reliable MVP experience canon.
+resolves to `V43`; V44 is the active draft target for scaled engineering economy
+operation over the Packs, Read, and Deposit route model promoted in V43.
 
 ## Current Product Posture
 
 Bitcode is the protocol and the commercial source tree implements it in-place.
-The promoted V42 operator route is still:
-
-- `/terminal` for depositing, reading, transaction work, and protocol follow-through.
-- `/auxillaries` for Wallet, Externals, Profile, and Interfaces support surfaces.
-
-The active V43 draft target moves the primary enterprise routes to:
+The promoted V43 enterprise routes are:
 
 - `/packs` for searchable master-detail pack activity.
 - `/read` for the five-step Reading path from Read Request to settlement-gated delivery.
 - `/deposit` for connected-source deposit AssetPack option synthesis, review, and admission.
 
+The active V44 draft target makes those routes economically operable at
+enterprise scale: `/packs` becomes the portfolio and market-intelligence
+surface, `/read` gains budgeted procurement and quote governance, and
+`/deposit` gains earning, demand, ROI, and compensation-statement visibility.
+
 V41 Gate 1 opens the prompts-as-programs specification family over active V40
 with `check:v41-gate1`. V41 will catalogue every raw PromptPart and composed
 Prompt, map registry composition and interpolation contracts, benchmark Reading
@@ -280,6 +279,16 @@ artifact, promotion script, generated PROVEN hook, workflow, source-safety
 boundary, documentation update, and post-promotion V43 active / draft V44
 runtime posture before the version branch can promote canon.
 
+V44 Gate 1 opens scaled engineering economy work over active V43 with
+`check:v44-gate1`. V44 is scoped to digitizing and tokenizing scaled
+engineering economies: enterprise AssetPack portfolios, Pack market signals,
+Reading demand signals, deposit supply opportunities, Reading budgets,
+AssetPack quote policy, BTD/BTC/source-to-shares accounting, contributor
+compensation statements, organization policy, wallet/spend authority, scaled
+local/staging-testnet rehearsal, and polished economic operation through
+`/packs`, `/read`, and `/deposit`. Gate 1 is specification, roadmap,
+documentation, workflow, and checker posture only.
+
 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
@@ -897,12 +906,13 @@ or promotion validation.
 ## Key Surfaces
 
 - [BITCODE_SPEC.txt](BITCODE_SPEC.txt) is the canonical version pointer.
-- [BITCODE_SPEC_V41.md](BITCODE_SPEC_V41.md) is the active promoted spec family.
-- [BITCODE_SPEC_V42.md](BITCODE_SPEC_V42.md) is the active draft target.
-- [BITCODE_SPEC_V42_PARITY_MATRIX.md](BITCODE_SPEC_V42_PARITY_MATRIX.md) tracks V42 gate parity.
+- [BITCODE_SPEC_V43.md](BITCODE_SPEC_V43.md) is the active promoted spec family.
+- [BITCODE_SPEC_V44.md](BITCODE_SPEC_V44.md) is the active draft target.
+- [BITCODE_SPEC_V44_PARITY_MATRIX.md](BITCODE_SPEC_V44_PARITY_MATRIX.md) tracks V44 gate parity.
 - [uapi/README.md](uapi/README.md) documents the commercial website/API surface.
-- [uapi/app/terminal/README.md](uapi/app/terminal/README.md) documents Terminal.
-- [uapi/app/exchange/README.md](uapi/app/exchange/README.md) documents Exchange.
+- [uapi/app/packs](uapi/app/packs) is the PackActivity and portfolio inspection route.
+- [uapi/app/read](uapi/app/read) is the Reading route.
+- [uapi/app/deposit](uapi/app/deposit) is the Depositing route.
 - [uapi/app/auxillaries/README.md](uapi/app/auxillaries/README.md) documents Auxillaries.
 - [protocol-demonstration/README.md](protocol-demonstration/README.md) documents
   the deterministic demonstration.