Merge pull request #144 from engineeredsoftware/v39/gate-9-interface-conversation-product-parity

V39 Gate 9: Interface And Conversation Product Parity

Author: geraldarthurdavis

.bitcode/v39-interface-conversation-product-parity.json

@@ -205,6 +205,9 @@ jobs:
               if [ -f scripts/check-v39-gate8-operational-telemetry-repair-readback.mjs ]; then
                 node scripts/check-v39-gate8-operational-telemetry-repair-readback.mjs --skip-branch-check --skip-package-tests --skip-uapi-tests
               fi
+              if [ -f scripts/check-v39-gate9-interface-conversation-product-parity.mjs ]; then
+                node scripts/check-v39-gate9-interface-conversation-product-parity.mjs --skip-branch-check --skip-package-tests --skip-interface-tests
+              fi
             fi
           else
             echo "Unexpected BITCODE_SPEC.txt pointer: $POINTER" >&2

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

@@ -334,6 +334,9 @@ jobs:
               if [ -f scripts/check-v39-gate8-operational-telemetry-repair-readback.mjs ]; then
                 node scripts/check-v39-gate8-operational-telemetry-repair-readback.mjs --skip-branch-check --skip-package-tests --skip-uapi-tests
               fi
+              if [ -f scripts/check-v39-gate9-interface-conversation-product-parity.mjs ]; then
+                node scripts/check-v39-gate9-interface-conversation-product-parity.mjs --skip-branch-check --skip-package-tests --skip-interface-tests
+              fi
             fi
           else
             echo "Unexpected BITCODE_SPEC.txt pointer: $POINTER" >&2
@@ -413,6 +416,7 @@ jobs:
           pnpm --filter @bitcode/pipeline-asset-pack exec jest --config jest.config.cjs --runTestsByPath src/__tests__/asset-pack-preview-boundary.test.ts --runInBand --forceExit
           pnpm --filter @bitcode/pipeline-asset-pack exec jest --config jest.config.cjs --runTestsByPath src/__tests__/asset-pack-settlement-rights-delivery.test.ts --runInBand --forceExit
           pnpm --filter @bitcode/pipeline-asset-pack exec jest --config jest.config.cjs --runTestsByPath src/__tests__/reading-operational-telemetry-repair-readback.test.ts --runInBand --forceExit
+          pnpm --filter @bitcode/pipeline-asset-pack exec jest --config jest.config.cjs --runTestsByPath src/__tests__/reading-interface-product-parity.test.ts --runInBand --forceExit
           pnpm --filter @bitcode/api exec jest --config jest.config.cjs --runTestsByPath src/conversations/__tests__/stream-events.test.ts src/conversations/__tests__/privacy.test.ts src/conversations/__tests__/telemetry.test.ts --runInBand --forceExit
           pnpm --dir packages/protocol exec node --test --test-force-exit test/conversation-telemetry-proof-hooks.test.js
           pnpm --dir packages/protocol exec node --test --test-force-exit test/conversation-rehearsal.test.js
@@ -447,6 +451,9 @@ jobs:
           if [ -f packages/protocol/test/v38-promotion-readiness.test.js ]; then
             pnpm --dir packages/protocol exec node --test --test-force-exit test/v38-promotion-readiness.test.js
           fi
+          if [ -f packages/protocol/test/v39-interface-conversation-product-parity.test.js ]; then
+            pnpm --dir packages/protocol exec node --test --test-force-exit test/v39-interface-conversation-product-parity.test.js
+          fi
           pnpm --filter @bitcode/protocol test
 
       - name: Test staged Reading route and Terminal harness contracts
@@ -469,6 +476,7 @@ jobs:
             tests/api/conversationTelemetryProofHooks.test.ts \
             tests/conversationTelemetryProofPanel.test.tsx \
             tests/api/conversationRehearsal.test.ts \
+            tests/api/conversationReadingInterfaceParity.test.ts \
             tests/conversationRehearsalPanel.test.tsx \
             tests/conversationSourceSelector.test.tsx \
             tests/conversationWritingWorkspace.test.tsx \

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

@@ -218,6 +218,20 @@ checked by `pnpm run check:v39-gate8`.
 Gate 9 brings Conversation, MCP/API, ChatGPT App, and package-facing interfaces into the same Reading contract without creating parallel authority.
 Every interface must respect accepted-Need gating, source-safe preview, settlement unlock, BTD rights, and delivery boundaries.
 
+The package-owned closure type is `ReadingInterfaceProductParity` in
+`packages/pipelines/asset-pack/src/reading-interface-product-parity.ts`.
+It projects Terminal, Conversation, public API, MCP API, ChatGPT App, and
+package-consumer surfaces into one source-safe contract. Conversation is a
+Terminal-delegated handoff, package consumers receive contract readback only,
+and API/MCP/ChatGPT actions compose the existing BTD interface contract,
+read-license, AssetPack-rights, telemetry hook, and consumer UX primitives.
+Every `ReadingInterfaceProductParityRow` proves accepted-Need gating,
+Finding Fits admission, source-safe preview, settlement unlock, BTD rights,
+authorized delivery, no parallel authority, and locked source-bearing delivery
+before settlement and rights transfer. The deterministic source-safe proof
+artifact is `.bitcode/v39-interface-conversation-product-parity.json`,
+checked by `pnpm run check:v39-gate9`.
+
 ### Gate 10: Local And Staging Commercial Reading Rehearsal
 
 Gate 10 proves V39 locally and in staging-testnet.

BITCODE_SPEC_V39.md

@@ -216,7 +216,11 @@ Closure acceptance:
 
 Closure implementation:
 
-- Pending Gate 9 work must define interface parity artifacts and consumer contract tests.
+- `ReadingInterfaceProductParity` is implemented in `packages/pipelines/asset-pack/src/reading-interface-product-parity.ts` and persisted under `reading/interfaces`.
+- Terminal, Conversation, public API, MCP API, ChatGPT App, and package consumers have parity rows with `sameAuthorityAsTerminal: true`, `parallelAuthorityCreated: false`, accepted-Need gating, source-safe preview, settlement unlock, BTD rights, and delivery-boundary checks.
+- The parity primitive composes BTD interface catalog, read-license/AssetPack-rights contracts, telemetry proof hooks, and interface consumer UX proof roots.
+- Focused package, Conversation, MCP, ChatGPT App, protocol, and checker tests cover no-bypass posture.
+- The generated proof artifact is `.bitcode/v39-interface-conversation-product-parity.json`; `pnpm run check:v39-gate9` validates artifact freshness, protocol tests, package tests, interface tests, docs, source safety, and workflow wiring.
 
 ### Gate 10: Local And Staging Commercial Reading Rehearsal
 

BITCODE_SPEC_V39_DELTA.md

@@ -277,6 +277,16 @@ compact row-by-row stream while preserving expandable source-safe metadata.
 ## Gate 9 implementation notes
 
 Gate 9 closes interface and Conversation product parity. Conversation, MCP/API, ChatGPT App, and package consumers may assist the flow but cannot bypass accepted-Need gating, preview disclosure, settlement, rights, or delivery law.
+`ReadingInterfaceProductParity` is the package-owned readback for that law. It
+binds Terminal, Conversation, public API, MCP API, ChatGPT App, and package
+consumer rows to the same Terminal Reading authority. Conversation remains a
+source-safe Terminal handoff rather than a second Reading authority. Package
+consumers can read contract roots and no-bypass posture but cannot authorize
+delivery. API/MCP/ChatGPT rows reuse BTD interface catalog,
+read-license/AssetPack-rights, telemetry-hook, and consumer-UX roots. The
+runtime and generated artifact both forbid protected source, raw protected
+prompts, raw interpolated prompts, raw provider responses, unpaid AssetPack
+source, wallet private material, private settlement payloads, and credentials.
 
 ## Gate 10 implementation notes
 

BITCODE_SPEC_V39_NOTES.md

@@ -77,7 +77,7 @@ No `_legacy/` source is active source truth.
 | AssetPack preview and quote boundary | Gate 6 | `packages/pipelines/asset-pack/src/asset-pack-preview-boundary.ts`, `.bitcode/v39-assetpack-preview-quote-boundary.json`, package tests, protocol tests | implemented | Preview exposes source-safe measurements, deterministic quote, settlement instructions, and withheld delivery posture without source-bearing AssetPack content. |
 | Settlement, BTD rights, and delivery | Gate 7 | `packages/pipelines/asset-pack/src/asset-pack-settlement-rights-delivery.ts`, `.bitcode/v39-settlement-rights-delivery.json`, BTD receipt/source-to-shares/reconciliation primitives, package tests, protocol tests | implemented | Payment unlocks rights and delivery only when finality, source-to-shares, BTD rights, reconciliation, and pull-request delivery agree; repair paths are auditable. |
 | Operational telemetry and repair | Gate 8 | `ReadingOperationalTelemetryRepairReadback`, `.bitcode/v39-operational-telemetry-repair-readback.json`, package tests, UI tests, protocol tests | implemented | Reading is observable and repairable end to end through source-safe stream events, operator readback, runbook hooks, proof roots, and repair commands. |
-| Interface and Conversation parity | Gate 9 | Conversation, MCP/API, ChatGPT App, package contract tests | pending | Interfaces follow Terminal authority and cannot bypass gating, preview, settlement, rights, or delivery boundaries. |
+| Interface and Conversation parity | Gate 9 | `ReadingInterfaceProductParity`, `.bitcode/v39-interface-conversation-product-parity.json`, package/Conversation/MCP/ChatGPT/protocol tests | implemented | Terminal, Conversation, public API, MCP API, ChatGPT App, and package consumers share Terminal Reading authority; accepted Need, source-safe preview, settlement, BTD rights, and delivery boundaries cannot be bypassed. |
 | Local and staging rehearsal | Gate 10 | local/staging lanes, real-inference gates, depository search, preview, settlement/delivery posture | pending | The full Reading flow rehearses in local and staging-testnet with production-mainnet value-bearing admission blocked. |
 | Promotion readiness | Gate 11 | V39 promotion report, generated proof appendix, promotion workflow, command dry-run | pending | V39 promotes only after all commercial Reading gates and source-safety evidence close. |
 
@@ -236,6 +236,23 @@ source leakage. The generated proof artifact is
 `.bitcode/v39-operational-telemetry-repair-readback.json` and the gate check
 is `pnpm run check:v39-gate8`.
 
+## Gate 9 Parity
+
+V39 Gate 9 is implemented when `ReadingInterfaceProductParity` binds Terminal,
+Conversation, public API, MCP API, ChatGPT App, and package-consumer surfaces
+to the same Reading authority. Conversation is a Terminal-delegated handoff,
+package consumers receive source-safe contract readback only, and API/MCP/
+ChatGPT rows reuse BTD interface catalog, read-license/AssetPack-rights,
+telemetry hook, and consumer UX proof roots. Each row proves accepted-Need
+gating, Finding Fits admission, source-safe preview, settlement unlock, BTD
+rights, delivery authorization, no parallel authority, and source-bearing
+delivery locked before settlement and rights transfer. The parity source is
+`packages/pipelines/asset-pack/src/reading-interface-product-parity.ts`; it
+persists `reading/interfaces` productParity, parityRows, noBypassReadback,
+interfaceRoots, sourceSafety, and parityRoot. The generated proof artifact is
+`.bitcode/v39-interface-conversation-product-parity.json` and the gate check
+is `pnpm run check:v39-gate9`.
+
 ## completion condition
 
-V39 Gate 8 is complete when `check:v39-gate8`, focused AssetPack operational telemetry package tests, focused rich execution log UI tests, V39 draft spec-family validation, V38/V39 canon-posture drift validation, promoted V38 spec-family validation, and Gate Quality pass on a `v39/gate-8-*` branch.
+V39 Gate 9 is complete when `check:v39-gate9`, focused AssetPack interface parity package tests, Conversation handoff parity tests, MCP ingress parity tests, ChatGPT source-safe delivery parity tests, V39 draft spec-family validation, V38/V39 canon-posture drift validation, promoted V38 spec-family validation, and Gate Quality pass on a `v39/gate-9-*` branch.

BITCODE_SPEC_V39_PARITY_MATRIX.md

@@ -310,6 +310,15 @@ operator readback with proof roots, runbook hooks, prompt/result disclosure
 posture, and rich execution-log rendering. Use
 `pnpm run generate:v39-operational-telemetry-repair-readback` and
 `pnpm run check:v39-gate8` before closing the gate.
+V39 Gate 9 adds the package-owned `ReadingInterfaceProductParity` and
+source-safe generated artifact
+`.bitcode/v39-interface-conversation-product-parity.json`. Terminal,
+Conversation, public API, MCP API, ChatGPT App, and package consumers now share
+the same Reading authority: accepted Need, Finding Fits, source-safe preview,
+settlement unlock, BTD rights, and delivery boundaries cannot be bypassed, and
+source-bearing delivery remains locked until settlement and rights transfer.
+Use `pnpm run generate:v39-interface-conversation-product-parity` and
+`pnpm run check:v39-gate9` before closing the gate.
 V36 Gate 2 anchors market-wide activity through the package-owned
 `ExchangeActivityBook` and the source-safe generated artifact
 `.bitcode/v36-exchange-activity-book.json`, including listing, bid, ask,
@@ -481,7 +490,9 @@ through `pnpm run check:v39-gate6` and its generated
 wired through `pnpm run check:v39-gate7` and its generated
 `.bitcode/v39-settlement-rights-delivery.json` artifact. V39 Gate 8 is wired
 through `pnpm run check:v39-gate8` and its generated
-`.bitcode/v39-operational-telemetry-repair-readback.json` artifact.
+`.bitcode/v39-operational-telemetry-repair-readback.json` artifact. V39 Gate 9
+is wired through `pnpm run check:v39-gate9` and its generated
+`.bitcode/v39-interface-conversation-product-parity.json` artifact.
 V38 Gates 1 through 11 are wired through `pnpm run check:v38-gate1`,
 `pnpm run check:v38-gate2`, `pnpm run check:v38-gate3`,
 `pnpm run check:v38-gate4`, `pnpm run check:v38-gate5`,

README.md

@@ -5,10 +5,11 @@
 - Current active canonical pointer: `BITCODE_SPEC.txt` -> `V38`
 - Current active canon: `BITCODE_SPEC_V38.md`
 - Current draft target: `BITCODE_SPEC_V39.md`.
-- Current working gate: V39 Gate 8 Operational Telemetry, Repair, And Operator Readback.
-- Next queued gate after V39 Gate 8 closure: V39 Gate 9 Interface And Conversation Product Parity.
+- Current working gate: V39 Gate 9 Interface And Conversation Product Parity.
+- Next queued gate after V39 Gate 9 closure: V39 Gate 10 Local And Staging Commercial Reading Rehearsal.
 - Latest closed version: V38 Inference Correctness, which promoted pipeline execution call-stack law, PTRR/Failsafe/Thricified parity, prompt and PromptPart benchmarking, source-safe inference telemetry, ReadNeedComprehensionSynthesis hardening, ReadFitsFindingSynthesis search and embeddings, AssetPack economic traceability, local/staging inference rehearsal, and V38 promotion readiness.
 - Recent V38 closure anchor: V38 Gate 11 Promotion Readiness generated V38 proof support, promoted `BITCODE_SPEC.txt` to `V38`, prepared V38 active / V39 draft runtime posture, and closed inference correctness canon.
+- V39 Gate 9 closure anchor: commercial Reading readiness now owns package-backed `ReadingInterfaceProductParity`, deterministic `.bitcode/v39-interface-conversation-product-parity.json`, Terminal/Conversation/API/MCP/ChatGPT/package-consumer no-bypass rows, source-safe contract readback, BTD interface root composition, focused package/interface tests, and workflow wiring through `check:v39-gate9`.
 - V34 Gate 2 closure anchor: deployment-depth now owns package-backed `DeploymentHostCapabilityCatalog` and `EnvironmentLaneContract` source, deterministic `.bitcode/v34-deployment-host-capability-catalog.json` and `.bitcode/v34-environment-lane-contracts.json`, and visible `value-bearing-mainnet` blocking through `blocked_future_canon_required`.
 - V34 Gate 3 closure anchor: deployment-depth now owns package-backed `DistributedExecutionRuntimeReceipt` source, deterministic `.bitcode/v34-distributed-execution-runtime-receipts.json`, `request_response_not_required` long-running work posture, and source-safe roots for pipeline, PTRR agent, ThricifiedGeneration, tool, ledger, wallet, proof, object-storage, and repair work.
 - V34 Gate 4 closure anchor: deployment-depth now owns package-backed `DeploymentStoragePosture` source, deterministic `.bitcode/v34-deployment-storage-posture.json`, ledger/database/object-storage drift repair fixtures, retention/encryption/backup/rollback/audit posture, and source-bearing AssetPack storage remains locked before settlement.

SPECIFICATIONS_ROADMAP.md

@@ -236,6 +236,9 @@
     "generate:v39-operational-telemetry-repair-readback": "node scripts/generate-v39-operational-telemetry-repair-readback.mjs",
     "check:v39-operational-telemetry-repair-readback": "node scripts/generate-v39-operational-telemetry-repair-readback.mjs --check",
     "check:v39-gate8": "node scripts/check-v39-gate8-operational-telemetry-repair-readback.mjs",
+    "generate:v39-interface-conversation-product-parity": "node scripts/generate-v39-interface-conversation-product-parity.mjs",
+    "check:v39-interface-conversation-product-parity": "node scripts/generate-v39-interface-conversation-product-parity.mjs --check",
+    "check:v39-gate9": "node scripts/check-v39-gate9-interface-conversation-product-parity.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",