V41 Gate 2: Catalog prompt programs

Add source-safe PromptPart and Prompt inventory generation for V41 Gate 2, including package exports, protocol tests, artifact freshness checks, and gate/canon workflow wiring.

Record V42 as the planned MVP experience version for shortest-path Depositing, shortest-path Reading, and the AI-reading dominant demonstration while preserving V41's prompt-program scope.

Author: geraldarthurdavis

.bitcode/v41-promptpart-prompt-inventory.json

@@ -262,6 +262,9 @@ jobs:
             if [ -f BITCODE_SPEC_V41.md ]; then
               node scripts/check-bitcode-spec-family.mjs --version V41 --mode draft --current-target V40
               node scripts/check-v41-gate1-prompt-program-roadmap-opening.mjs --skip-branch-check
+              if [ -f scripts/check-v41-gate2-promptpart-prompt-inventory.mjs ]; then
+                node scripts/check-v41-gate2-promptpart-prompt-inventory.mjs --skip-branch-check --skip-package-tests
+              fi
             fi
           else
             echo "Unexpected BITCODE_SPEC.txt pointer: $POINTER" >&2

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

@@ -391,6 +391,9 @@ jobs:
             if [ -f BITCODE_SPEC_V41.md ]; then
               node scripts/check-bitcode-spec-family.mjs --version V41 --mode draft --current-target V40
               node scripts/check-v41-gate1-prompt-program-roadmap-opening.mjs --skip-branch-check
+              if [ -f scripts/check-v41-gate2-promptpart-prompt-inventory.mjs ]; then
+                node scripts/check-v41-gate2-promptpart-prompt-inventory.mjs --skip-branch-check --skip-package-tests
+              fi
             fi
           else
             echo "Unexpected BITCODE_SPEC.txt pointer: $POINTER" >&2

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

@@ -108,6 +108,9 @@ It closes when active V40 / draft V41 truth is visible in the root docs, protoco
 Gate 2 must emit a source-safe inventory of every raw PromptPart and every composed Prompt.
 Rows must include prompt id, part id, source root, registry owner, semantic purpose, prompt family, composed prompt membership, current title, template variable names, benchmark fixture ids, disclosure tier, and validation command.
 The artifact may include ids, hashes, counts, and source-safe previews, but no raw protected prompt text.
+Gate 2 is closed by the package-backed `buildV41PromptPartPromptInventory` source, deterministic `.bitcode/v41-promptpart-prompt-inventory.json` artifact, `generate:v41-prompt-inventory`, `check:v41-prompt-inventory`, `check:v41-gate2`, protocol tests, and gate/canon workflow wiring.
+The current inventory source-safe count contract is 1,459 raw PromptPart rows, 105 composed Prompt rows, 59 generic PromptPart rows, 1,400 specific PromptPart rows, 49 Reading prompt rows, 2 Conversation prompt rows, 74 tool prompt rows, 10 interface prompt rows, 87 prompt rows with registry paths, 1,135 registry paths, 8 benchmark fixture families, V38 benchmark report binding, and V40 prompt benchmark smoke binding.
+Gate 2 also preserves V41 scope and prepares draft V42 only as forward roadmap truth: V42 will focus on shortest-path Depositing, shortest-path Reading, and an AI-reading dominant demonstration MVP.
 
 ## V41 Gate 3 Registry Composition And Interpolation Contracts
 
@@ -445,6 +448,7 @@ Generation must fail closed when artifact freshness, source-safety, benchmark co
 ### Appendix D. Validation and checking gate catalog
 
 V41 Gate 1 validates with `pnpm run check:v41-gate1`, `node scripts/check-bitcode-spec-family.mjs --version V41 --mode draft --current-target V40`, `node scripts/check-bitcode-canon-posture-drift.mjs --active-canon V40 --draft-target V41`, and `node scripts/check-bitcode-canonical-inputs.mjs --current-target V40`.
+V41 Gate 2 validates with `pnpm run generate:v41-prompt-inventory`, `pnpm run check:v41-prompt-inventory`, `pnpm run check:v41-gate2`, and `node --test --test-force-exit packages/protocol/test/v41-promptpart-prompt-inventory.test.js`.
 Later gates add focused generator, checker, package, benchmark, and workflow commands.
 
 ## V41 promotion canon

BITCODE_SPEC_V41.md

@@ -33,6 +33,8 @@ Open the V41 full specification family, roadmap, package script, workflow postur
 ### Gate 2: PromptPart And Prompt Inventory Catalog
 
 Inventory every raw PromptPart and composed Prompt across Reading, Conversation, tool-definition, and interface inference surfaces.
+Gate 2 is package-backed by `buildV41PromptPartPromptInventory`, emits `.bitcode/v41-promptpart-prompt-inventory.json`, covers 1,459 raw PromptPart rows and 105 composed Prompt rows, binds V38/V40 benchmark handoff artifacts, and records only source-safe metadata.
+It also records V42 as the subsequent MVP experience version for shortest-path Depositing, shortest-path Reading, and an AI-reading dominant demonstration without expanding V41 beyond prompt-program work.
 
 ### Gate 3: Registry Composition And Interpolation Contracts
 

BITCODE_SPEC_V41_DELTA.md

@@ -8,7 +8,7 @@
 - Canonical pointer: `BITCODE_SPEC.txt` -> `V40`
 - Prior canonical anchor: `BITCODE_SPEC_V40.md`
 - Prior generated proof appendix: `BITCODE_SPEC_V40_PROVEN.md`
-- Generated structured artifact inventory: draft `.bitcode/v41-spec-family-report.json`, draft `.bitcode/v41-canonical-input-report.json`, planned prompt-program catalogue artifacts, planned benchmark artifacts, planned promotion-readiness artifact, and eventual `BITCODE_SPEC_V41_PROVEN.md` after V41 promotion
+- Generated structured artifact inventory: draft `.bitcode/v41-spec-family-report.json`, draft `.bitcode/v41-canonical-input-report.json`, Gate 2 `.bitcode/v41-promptpart-prompt-inventory.json`, planned benchmark artifacts, planned promotion-readiness artifact, and eventual `BITCODE_SPEC_V41_PROVEN.md` after V41 promotion
 - Source parity state: V41 notes track prompt-program planning, catalogue, benchmark, rewrite, telemetry, and promotion parity over active V40
 - Draft target posture: V41 Gate 1 creates the full SPEC, DELTA, NOTES, and PARITY family.
 - Scope: Prompt and PromptPart excellence over the promoted V40 exhaustive testing base.
@@ -19,6 +19,18 @@ This notes companion records the working prompt-program plan and simplified read
 It does not override `BITCODE_SPEC_V41.md`.
 Prompt content changes remain blocked until the relevant catalogue and benchmark gates admit them.
 
+## Gate 2 prompt inventory note
+
+Gate 2 makes the first prompt-program catalogue concrete.
+The package-backed inventory currently emits 1,459 raw PromptPart rows and 105 composed Prompt rows with source path, source hash, registry owner, semantic purpose id, prompt family ids, composed prompt memberships, template variable names, benchmark fixture ids, disclosure tier, validation command, and source-safe raw-payload exclusions.
+This is an inventory and admission artifact, not a rewrite artifact.
+
+## V42 forward roadmap note
+
+V42 is re-roadmapped as the MVP experience version after V41.
+Its focus is shortest-path Depositing, shortest-path Reading, and a strong AI-reading dominant demonstration where any deposit source can contribute proprietary or otherwise non-public training, prompt, context, or evaluation material to an AssetPack that measurably improves an AI system beyond public-data-only performance.
+V42 must keep depositor compensation, reader purchase, BTD/AssetPack rights, and repository delivery visible in the shortest path without widening V41 beyond Prompt and PromptPart excellence.
+
 ## Concise current-system reading
 
 Bitcode is active at V40.

BITCODE_SPEC_V41_NOTES.md

@@ -7,8 +7,8 @@
 - Current canonical/latest target: `V40`
 - Prior canonical anchor: `BITCODE_SPEC_V40.md`
 - Prior generated proof appendix: `BITCODE_SPEC_V40_PROVEN.md`
-- Generated structured artifact inventory: draft `.bitcode/v41-spec-family-report.json`, draft `.bitcode/v41-canonical-input-report.json`, planned prompt-program catalogue artifacts, planned benchmark artifacts, planned promotion-readiness artifact, and eventual `BITCODE_SPEC_V41_PROVEN.md` after V41 promotion
-- Source parity state: Gate 1 closes spec, roadmap, docs, package script, workflow posture, and checker parity; later gates own source prompt inventory, rewrite, benchmark, telemetry, and promotion parity
+- Generated structured artifact inventory: draft `.bitcode/v41-spec-family-report.json`, draft `.bitcode/v41-canonical-input-report.json`, Gate 2 `.bitcode/v41-promptpart-prompt-inventory.json`, planned benchmark artifacts, planned promotion-readiness artifact, and eventual `BITCODE_SPEC_V41_PROVEN.md` after V41 promotion
+- Source parity state: Gate 1 closes spec, roadmap, docs, package script, workflow posture, and checker parity; Gate 2 closes source-safe prompt inventory parity; later gates own registry contracts, rewrite, benchmark, telemetry, and promotion parity
 - Scope: V41 draft parity ledger for Prompt and PromptPart excellence
 - Last fully realized canonical target preserved in source: `V40`
 
@@ -34,7 +34,7 @@ This matrix records the prompt-program surfaces that must become promotion-grade
 | Roadmap truth | Roadmap states V40 active, V41 draft, prompt-program Gate 1 active | `SPECIFICATIONS_ROADMAP.md` | drafted |
 | Gate workflow | Gate quality knows active V40 and draft V41 Gate 1 | `.github/workflows/bitcode-gate-quality.yml` | drafted |
 | Canon workflow | Canon quality knows active V40 and draft V41 Gate 1 | `.github/workflows/bitcode-canon-quality.yml` | drafted |
-| Prompt inventory | Every raw PromptPart and composed Prompt catalogued | planned V41 Gate 2 artifact | pending |
+| Prompt inventory | Every raw PromptPart and composed Prompt catalogued | `.bitcode/v41-promptpart-prompt-inventory.json` | implemented |
 | Registry/interpolation | Registry composition and interpolation contracts proven | planned V41 Gate 3 artifact | pending |
 | Reading baselines | Reading prompt benchmarks captured before rewrites | planned V41 Gate 4 artifact | pending |
 | ReadNeed rewrite | ReadNeedComprehensionSynthesis prompts rewritten and type-hardened | planned V41 Gate 5 artifact | pending |
@@ -47,8 +47,8 @@ This matrix records the prompt-program surfaces that must become promotion-grade
 
 | Area | Closure requirement | Judgment |
 | --- | --- | --- |
-| Gate 1 | Open V41 family, roadmap, docs, workflow posture, package script, and checker | drafted |
-| Gate 2 | PromptPart and Prompt inventory artifact | pending |
+| Gate 1 | Open V41 family, roadmap, docs, workflow posture, package script, and checker | closed |
+| Gate 2 | PromptPart and Prompt inventory artifact | implemented |
 | Gate 3 | Registry composition and interpolation artifact | pending |
 | Gate 4 | Reading prompt benchmark baseline artifact | pending |
 | Gate 5 | ReadNeedComprehensionSynthesis rewrite artifact | pending |
@@ -63,6 +63,10 @@ V41 Gate 1 may open specification, workflow, docs, and validation posture.
 It may not rewrite prompt content.
 Later gates may rewrite prompts only after catalogue, registry, interpolation, benchmark, parser, and disclosure checks exist.
 
+V41 Gate 2 may catalogue PromptPart and Prompt metadata, hashes, registry owners, family ids, template variables, benchmark fixture ids, and validation commands.
+It may not serialize raw prompt text, raw provider responses, protected source, secrets, or unpaid AssetPack source.
+It also may record the V42 MVP roadmap posture as forward planning while preserving V41 as the active prompt-program draft target.
+
 ## V41 completion condition
 
 V41 closes when prompt-program quality is fully specified, implemented, benchmarked, source-safe, tested, documented, generated, workflow-checked, and promotion-ready across Reading, Conversation, tool-definition, and interface inference surfaces.

BITCODE_SPEC_V41_PARITY_MATRIX.md

@@ -19,6 +19,15 @@ prompt baselines, then harden `ReadNeedComprehensionSynthesis`,
 `ReadFitsFindingSynthesis`, Conversation, tool-definition, and interface prompts
 without exposing protected prompt payloads, raw provider responses, secrets,
 protected source, or unpaid AssetPack source.
+V41 Gate 2 adds the package-backed `buildV41PromptPartPromptInventory` and
+generated source-safe artifact `.bitcode/v41-promptpart-prompt-inventory.json`.
+The inventory currently covers 1,459 raw PromptPart rows and 105 composed Prompt
+rows across Reading, Conversation, tool-definition, interface, and benchmark
+surfaces, with `generate:v41-prompt-inventory`, `check:v41-prompt-inventory`,
+and `check:v41-gate2`. V42 is now roadmapped as the next MVP experience version:
+shortest-path Depositing, shortest-path Reading, and an AI-reading dominant
+demonstration whose AssetPack measurably improves an AI system beyond
+public-data-only performance.
 
 Exchange is inherited V36 canon: market-wide activity master-detail, buy/sell/
 bid/ask/cancel/accept/settle/history flows, AssetPack range trading,