Skip to content

Commit 68d69ed

Browse files
geraldarthurdavisgeraldarthurdavis
committed
Promote Bitcode canon to V37
1 parent 3df6b2c commit 68d69ed

15 files changed

Lines changed: 2851 additions & 63 deletions

‎.bitcode/v37-canon-posture-drift-report.json‎

Lines changed: 77 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,77 @@
1+
{
2+
"reportId": "v37-canon-posture-drift-report",
3+
"version": "V37",
4+
"checkedActiveCanonVersion": "V37",
5+
"checkedDraftTargetVersion": "V38",
6+
"pointerVersion": "V37",
7+
"proofSourceCommit": "3df6b2cae755336067da920abbe8142df487a221",
8+
"generatedAt": "2026-05-24T16:30:41-03:00",
9+
"generatorId": "bitcode.proven-generator.v1",
10+
"worktreeState": "clean",
11+
"passed": true,
12+
"checkCount": 10,
13+
"blockingFailureCount": 0,
14+
"blockingFailures": [],
15+
"runtimeSpecVersion": "Bitcode Spec V37 active canon / V38 system draft",
16+
"publicSpecVersion": "Bitcode Spec V37 active canon / V38 system draft",
17+
"activeProvenAppendixPath": "BITCODE_SPEC_V37_PROVEN.md",
18+
"policyRef": "policy://bitcode/spec-v37-active-v38-system-draft/current",
19+
"checkedFiles": [
20+
"protocol-demonstration/README.md",
21+
"protocol-demonstration/public/index.html",
22+
"protocol-demonstration/public/app.js",
23+
"protocol-demonstration/server.js"
24+
],
25+
"checks": [
26+
{
27+
"checkId": "pointer-active-canon-alignment",
28+
"passed": true,
29+
"detail": "BITCODE_SPEC.txt points to V37 while runtime expects V37."
30+
},
31+
{
32+
"checkId": "canon-posture-constant-alignment",
33+
"passed": true,
34+
"detail": "canon-posture constants resolve V37/V38 with operator label V37 active canon / V38 system draft."
35+
},
36+
{
37+
"checkId": "proven-appendix-alignment",
38+
"passed": true,
39+
"detail": "active generated appendix path is BITCODE_SPEC_V37_PROVEN.md."
40+
},
41+
{
42+
"checkId": "policy-ref-alignment",
43+
"passed": true,
44+
"detail": "policy reference is policy://bitcode/spec-v37-active-v38-system-draft/current."
45+
},
46+
{
47+
"checkId": "runtime-state-alignment",
48+
"passed": true,
49+
"detail": "buildInitialState() reports Bitcode Spec V37 active canon / V38 system draft with canon posture V37/V38."
50+
},
51+
{
52+
"checkId": "public-state-alignment",
53+
"passed": true,
54+
"detail": "publicState() reports Bitcode Spec V37 active canon / V38 system draft with canon posture V37/V38."
55+
},
56+
{
57+
"checkId": "server-api-alignment",
58+
"passed": true,
59+
"detail": "server.js keeps API posture sourced from SPEC_VERSION and buildPublicState(...)."
60+
},
61+
{
62+
"checkId": "browser-shell-placeholder-alignment",
63+
"passed": true,
64+
"detail": "public/index.html exposes canon-posture placeholders and no stale hardcoded hero posture."
65+
},
66+
{
67+
"checkId": "browser-shell-render-alignment",
68+
"passed": true,
69+
"detail": "public/app.js renders canon posture from runtime state and omits stale V15 explainer keys."
70+
},
71+
{
72+
"checkId": "readme-alignment",
73+
"passed": true,
74+
"detail": "README states V37 active canon and BITCODE_SPEC_V37_PROVEN.md as the current generated appendix."
75+
}
76+
]
77+
}

‎.bitcode/v37-canonical-input-report.json‎

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
{
2+
"reportId": "v37-canonical-input-report",
3+
"version": "V37",
4+
"proofSourceCommit": "3df6b2cae755336067da920abbe8142df487a221",
5+
"generatedAt": "2026-05-24T16:30:41-03:00",
6+
"generatorId": "bitcode.proven-generator.v1",
7+
"worktreeState": "clean",
8+
"checkedTargetVersion": "V37",
9+
"pointerVersion": "V37",
10+
"passed": true,
11+
"failureCount": 0,
12+
"failures": [],
13+
"specPath": "BITCODE_SPEC_V37.md",
14+
"notesPath": "BITCODE_SPEC_V37_NOTES.md",
15+
"provenPath": "BITCODE_SPEC_V37_PROVEN.md",
16+
"parityPath": "BITCODE_SPEC_V37_PARITY_MATRIX.md",
17+
"requiredGeneratedArtifactPaths": [],
18+
"requiredGeneratedArtifactCount": 0
19+
}

‎.bitcode/v37-promotion-readiness-report.json‎

Lines changed: 12 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,10 @@
11
{
2+
"reportId": "v37-promotion-readiness-report",
23
"artifactId": "v37-promotion-readiness-report",
34
"schemaId": "bitcode.v37.conversationPromotionReadinessReport.v1",
45
"version": "V37",
56
"currentTarget": "V36",
6-
"generatedAt": "2026-05-24T00:00:00.000Z",
7+
"generatedAt": "2026-05-24T16:30:41-03:00",
78
"sourceSafetyVerdict": "source-safe-conversation-promotion-readiness-metadata",
89
"prePromotionPosture": "V36 active / V37 draft",
910
"postPromotionPosture": "V37 active / V38 draft",
@@ -346,7 +347,7 @@
346347
{
347348
"relativePath": "BITCODE_SPEC_V37.md",
348349
"present": true,
349-
"digest": "sha256:43a927465914e8f435d65e195d53ef63a7f9e8ba11ee1733400d0a3c6b7bf3f3",
350+
"digest": "sha256:2455eb991591f316946b0081cd41ad360c4cf0c9727d96b773707899bd1faada",
350351
"requiredTokens": [
351352
{
352353
"token": "V37 promotion readiness canon",
@@ -365,7 +366,7 @@
365366
{
366367
"relativePath": "BITCODE_SPEC_V37_DELTA.md",
367368
"present": true,
368-
"digest": "sha256:5474db49b715401c294cf044d513e7d8e62763834289265e841c17d341a61873",
369+
"digest": "sha256:bc0fd7e112036cec170a84be09812add589d1635860ddacefc1640347665ddd6",
369370
"requiredTokens": [
370371
{
371372
"token": "Gate 10: V37 Promotion Readiness",
@@ -384,7 +385,7 @@
384385
{
385386
"relativePath": "BITCODE_SPEC_V37_NOTES.md",
386387
"present": true,
387-
"digest": "sha256:42bbb9d3e77377dd2ddda7935a29d0fa4f175942c2fcc790b3b607da295e0933",
388+
"digest": "sha256:eb50e5cfc05d4c6e76fec8651f11de6987bf5a0b6ae95a9f050dc7dac1ab4e26",
388389
"requiredTokens": [
389390
{
390391
"token": "Gate 10: V37 Promotion Readiness",
@@ -403,7 +404,7 @@
403404
{
404405
"relativePath": "BITCODE_SPEC_V37_PARITY_MATRIX.md",
405406
"present": true,
406-
"digest": "sha256:07f237b864378366485334fadd62a21f227299e0baaa90dc74e39709a08f0a24",
407+
"digest": "sha256:86866f5ffb578312e387e0193deab7f0fce8722af81c99eb3fb0af6af39c1dba",
407408
"requiredTokens": [
408409
{
409410
"token": "## Gate 10 Parity",
@@ -452,7 +453,7 @@
452453
{
453454
"relativePath": "packages/protocol/README.md",
454455
"present": true,
455-
"digest": "sha256:5487e6720c0e292494812c2da2be79301311149367562fa8c5bc876452066ad9",
456+
"digest": "sha256:a352709ad557da38c250a6bbc6b5e76c4b02f7e85b73f43b247226c7a47277f0",
456457
"requiredTokens": [
457458
{
458459
"token": "V37 Gate 10",
@@ -513,5 +514,9 @@
513514
"artifactRoot": "conversation-promotion-readiness-report:34bf35d1911c3fa9b1991f54",
514515
"passed": true,
515516
"failures": [],
516-
"validationCommand": "pnpm run check:v37-gate10"
517+
"validationCommand": "pnpm run check:v37-gate10",
518+
"proofSourceCommit": "3df6b2cae755336067da920abbe8142df487a221",
519+
"generatorId": "bitcode.proven-generator.v1",
520+
"worktreeState": "clean",
521+
"sourceSafe": true
517522
}

‎.bitcode/v37-spec-family-report.json‎

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
{
2+
"reportId": "v37-spec-family-report",
3+
"version": "V37",
4+
"proofSourceCommit": "3df6b2cae755336067da920abbe8142df487a221",
5+
"generatedAt": "2026-05-24T16:30:41-03:00",
6+
"generatorId": "bitcode.proven-generator.v1",
7+
"worktreeState": "clean",
8+
"checkedVersion": "V37",
9+
"mode": "promoted",
10+
"currentTarget": "V37",
11+
"pointerVersion": "V37",
12+
"passed": true,
13+
"failureCount": 0,
14+
"failures": [],
15+
"requiredFiles": [
16+
"BITCODE_SPEC_V37.md",
17+
"BITCODE_SPEC_V37_DELTA.md",
18+
"BITCODE_SPEC_V37_NOTES.md",
19+
"BITCODE_SPEC_V37_PARITY_MATRIX.md"
20+
],
21+
"supportFiles": [
22+
"BITCODE_SPECIFYING.md",
23+
"BITCODE_SPEC_TEMPLATEGUIDE.md"
24+
],
25+
"requiredStatusLabelCount": 4,
26+
"requiredPromotedStatusLabelCount": 1,
27+
"requiredSpecSectionCount": 18,
28+
"requiredAppendixSectionCount": 14,
29+
"requiredProofFamilyCount": 9,
30+
"requiredGeneratedArtifactCatalogSectionCount": 9,
31+
"requiredGeneratedArtifactPathCount": 11,
32+
"requiredNotesSectionCount": 4,
33+
"requiredSubsystemCoverageCount": 18
34+
}

‎BITCODE_SPEC.txt‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
V36
1+
V37

‎BITCODE_SPEC_V37.md‎

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -3,19 +3,20 @@
33
## Status
44

55
- Version: `V37`
6-
- V37 state: draft implementation; Gate 10 closes ConversationPromotionReadinessReport over active V36 Exchange canon
7-
- Current canonical/latest target: `V36`
6+
- V37 state: canonical promotion complete; V37 is the active Website Conversations canon and the V37 hand-authored plus generated canon are aligned
7+
- Current canonical/latest target: `V37`
8+
- Canonical proof-source commit: `3df6b2cae755336067da920abbe8142df487a221`
89
- Prior canonical anchor: `BITCODE_SPEC_V36.md`
910
- Prior generated proof appendix: `BITCODE_SPEC_V36_PROVEN.md`
10-
- Generated structured artifact inventory: draft `.bitcode/v37-spec-family-report.json`, `.bitcode/v37-canonical-input-report.json`, `.bitcode/v37-canon-posture-drift-report.json`, `.bitcode/v37-conversation-session-route-history.json`, `.bitcode/v37-conversation-stream-event-contract.json`, `.bitcode/v37-conversation-writing-workspace.json`, `.bitcode/v37-conversation-source-selector.json`, `.bitcode/v37-conversation-terminal-handoff.json`, `.bitcode/v37-conversation-persistence-privacy-redaction.json`, `.bitcode/v37-conversation-telemetry-proof-hooks.json`, `.bitcode/v37-conversation-rehearsal.json`, and `.bitcode/v37-promotion-readiness-report.json`
11-
- Source parity state: V37 source parity includes Gate 1 spec family, roadmap, docs, workflow, and checker posture, Gate 2 package-owned ConversationSession route-history contracts, Gate 3 package-owned ConversationStreamEvent stream UI/event contracts, Gate 4 package-owned ConversationWritingWorkspace fullscreen writing contracts, Gate 5 package-owned ConversationSourceSelector source/context policy contracts, Gate 6 package-owned ConversationTerminalHandoff transaction handoff contracts, Gate 7 package-owned ConversationPersistencePrivacyRedaction durable storage privacy contracts, Gate 8 package-owned ConversationTelemetryProofHooks telemetry, dashboard, runbook, and docs contracts, Gate 9 package-owned ConversationRehearsal local/staging proof contracts, and Gate 10 package-owned ConversationPromotionReadinessReport promotion closure contracts
11+
- Generated structured artifact inventory: active canonical `.bitcode/v37-spec-family-report.json`, `.bitcode/v37-canonical-input-report.json`, `.bitcode/v37-canon-posture-drift-report.json`, `.bitcode/v37-conversation-session-route-history.json`, `.bitcode/v37-conversation-stream-event-contract.json`, `.bitcode/v37-conversation-writing-workspace.json`, `.bitcode/v37-conversation-source-selector.json`, `.bitcode/v37-conversation-terminal-handoff.json`, `.bitcode/v37-conversation-persistence-privacy-redaction.json`, `.bitcode/v37-conversation-telemetry-proof-hooks.json`, `.bitcode/v37-conversation-rehearsal.json`, `.bitcode/v37-promotion-readiness-report.json`, V37 gate-quality and promotion workflow evidence, and `BITCODE_SPEC_V37_PROVEN.md` as the generated proof appendix for V37 promotion
12+
- Source parity state: V37 source-side ConversationSession route history, ConversationStreamEvent contracts, ConversationWritingWorkspace contracts, ConversationSourceSelector contracts, ConversationTerminalHandoff contracts, ConversationPersistencePrivacyRedaction contracts, ConversationTelemetryProofHooks contracts, ConversationRehearsal evidence, workflow, and promotion surfaces are canonicalized in the promoted V37 file family
1213
- Active canonical pointer during draft opening: `BITCODE_SPEC.txt` -> `V36`
1314
- Notes companion: `BITCODE_SPEC_V37_NOTES.md`
1415
- Delta companion: `BITCODE_SPEC_V37_DELTA.md`
1516
- Parity companion: `BITCODE_SPEC_V37_PARITY_MATRIX.md`
1617
- Generated proof appendix: `BITCODE_SPEC_V37_PROVEN.md` only after V37 promotion
17-
- Scope: V37 draft system specification for Website Conversations, route-local conversational state, stream UI, fullscreen writing mode, source selectors, Terminal handoff, persistence/privacy, telemetry/proof hooks, local/staging rehearsal, and promotion readiness over promoted V36 Exchange canon
18-
- Last fully realized canonical target preserved in source: `V36`
18+
- Scope: V37 canonical system specification for Website Conversations over promoted sessions, route-local history, stream UI/event contracts, fullscreen writing mode, source selectors, Terminal handoff, persistence/privacy/redaction, telemetry/proof hooks, local/staging rehearsal, and promotion readiness surfaces
19+
- Last fully realized canonical target preserved in source: `V37`
1920

2021
## Version executive summary
2122

‎BITCODE_SPEC_V37_DELTA.md‎

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -3,17 +3,18 @@
33
## Status
44

55
- Version: `V37`
6-
- V37 state: draft implementation; this delta records the V36-to-V37 Website Conversations opening through Gate 10 ConversationPromotionReadinessReport contracts
7-
- Current canonical/latest target: `V36`
6+
- V37 state: canonical promotion complete; this delta records the promoted V36-to-V37 Website Conversations closure set
7+
- Current canonical/latest target: `V37`
8+
- Canonical proof-source commit: `3df6b2cae755336067da920abbe8142df487a221`
89
- Prior canonical anchor: `BITCODE_SPEC_V36.md`
910
- Prior generated proof appendix: `BITCODE_SPEC_V36_PROVEN.md`
10-
- Generated structured artifact inventory: draft `.bitcode/v37-spec-family-report.json`, `.bitcode/v37-canonical-input-report.json`, `.bitcode/v37-canon-posture-drift-report.json`, `.bitcode/v37-conversation-session-route-history.json`, `.bitcode/v37-conversation-stream-event-contract.json`, `.bitcode/v37-conversation-writing-workspace.json`, `.bitcode/v37-conversation-source-selector.json`, `.bitcode/v37-conversation-terminal-handoff.json`, `.bitcode/v37-conversation-persistence-privacy-redaction.json`, `.bitcode/v37-conversation-telemetry-proof-hooks.json`, `.bitcode/v37-conversation-rehearsal.json`, and `.bitcode/v37-promotion-readiness-report.json`
11-
- Source parity state: V37 source parity begins at Gate 1 with spec family, roadmap, docs, workflow, and checker posture; Gate 2 adds package-owned ConversationSession route-history contracts; Gate 3 adds package-owned ConversationStreamEvent contracts and stream UI binding; Gate 4 adds package-owned ConversationWritingWorkspace fullscreen composer contracts; Gate 5 adds package-owned ConversationSourceSelector context policy; Gate 6 adds package-owned ConversationTerminalHandoff transaction handoff contracts; Gate 7 adds package-owned ConversationPersistencePrivacyRedaction durable storage privacy contracts; Gate 8 adds package-owned ConversationTelemetryProofHooks telemetry, dashboard, runbook, and docs contracts; Gate 9 adds package-owned ConversationRehearsal local/staging proof contracts; Gate 10 adds package-owned ConversationPromotionReadinessReport promotion readiness contracts
11+
- Generated structured artifact inventory: active canonical `.bitcode/v37-spec-family-report.json`, `.bitcode/v37-canonical-input-report.json`, `.bitcode/v37-canon-posture-drift-report.json`, `.bitcode/v37-conversation-session-route-history.json`, `.bitcode/v37-conversation-stream-event-contract.json`, `.bitcode/v37-conversation-writing-workspace.json`, `.bitcode/v37-conversation-source-selector.json`, `.bitcode/v37-conversation-terminal-handoff.json`, `.bitcode/v37-conversation-persistence-privacy-redaction.json`, `.bitcode/v37-conversation-telemetry-proof-hooks.json`, `.bitcode/v37-conversation-rehearsal.json`, `.bitcode/v37-promotion-readiness-report.json`, V37 gate-quality and promotion workflow evidence, and `BITCODE_SPEC_V37_PROVEN.md` as the generated proof appendix for V37 promotion
12+
- Source parity state: V37 source-side ConversationSession route history, ConversationStreamEvent contracts, ConversationWritingWorkspace contracts, ConversationSourceSelector contracts, ConversationTerminalHandoff contracts, ConversationPersistencePrivacyRedaction contracts, ConversationTelemetryProofHooks contracts, ConversationRehearsal evidence, workflow, and promotion surfaces are canonicalized in the promoted V37 file family
1213
- Spec companion: `BITCODE_SPEC_V37.md`
1314
- Notes companion: `BITCODE_SPEC_V37_NOTES.md`
1415
- Parity companion: `BITCODE_SPEC_V37_PARITY_MATRIX.md`
1516
- Generated proof appendix: `BITCODE_SPEC_V37_PROVEN.md` only after V37 promotion
16-
- Scope: V37 draft delta for Website Conversations over promoted V36 Exchange canon
17+
- Scope: V37 canonical delta for Website Conversations over promoted V36 Exchange canon
1718

1819
## Why V37 exists
1920

‎BITCODE_SPEC_V37_NOTES.md‎

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -3,14 +3,16 @@
33
## Status
44

55
- Version: `V37`
6-
- V37 state: draft implementation; Gate 10 closes ConversationPromotionReadinessReport promotion posture over active V36 Exchange canon
7-
- Current canonical/latest target: `V36`
6+
- V37 state: canonical promotion complete; V37 notes record the accepted Conversations session, stream, writing, source selector, Terminal handoff, persistence privacy, telemetry proof, rehearsal, and promotion-readiness evidence
7+
- Current canonical/latest target: `V37`
8+
- Canonical proof-source commit: `3df6b2cae755336067da920abbe8142df487a221`
89
- Current active draft target: `V37`
910
- Prior canonical anchor: `BITCODE_SPEC_V36.md`
1011
- Prior generated proof appendix: `BITCODE_SPEC_V36_PROVEN.md`
11-
- Generated structured artifact inventory: draft `.bitcode/v37-spec-family-report.json`, `.bitcode/v37-canonical-input-report.json`, `.bitcode/v37-canon-posture-drift-report.json`, `.bitcode/v37-conversation-session-route-history.json`, `.bitcode/v37-conversation-stream-event-contract.json`, `.bitcode/v37-conversation-writing-workspace.json`, `.bitcode/v37-conversation-source-selector.json`, `.bitcode/v37-conversation-terminal-handoff.json`, `.bitcode/v37-conversation-persistence-privacy-redaction.json`, `.bitcode/v37-conversation-telemetry-proof-hooks.json`, `.bitcode/v37-conversation-rehearsal.json`, and `.bitcode/v37-promotion-readiness-report.json`
12-
- Source parity state: V37 source parity begins at Gate 1 with spec family, roadmap, docs, workflow, and checker posture; Gate 2 adds package-owned ConversationSession route-history contracts; Gate 3 adds package-owned ConversationStreamEvent stream contracts; Gate 4 adds package-owned ConversationWritingWorkspace fullscreen composer contracts; Gate 5 adds package-owned ConversationSourceSelector context policy; Gate 6 adds package-owned ConversationTerminalHandoff transaction handoff contracts; Gate 7 adds package-owned ConversationPersistencePrivacyRedaction durable storage privacy contracts; Gate 8 adds package-owned ConversationTelemetryProofHooks telemetry, dashboard, runbook, and docs contracts; Gate 9 adds package-owned ConversationRehearsal local/staging proof contracts; Gate 10 adds package-owned ConversationPromotionReadinessReport promotion readiness contracts
13-
- Scope: draft notes for website Conversations work after V36 Exchange depth and after the V28 ChatGPT App MVP proved the interface path.
12+
- Generated structured artifact inventory: active canonical `.bitcode/v37-spec-family-report.json`, `.bitcode/v37-canonical-input-report.json`, `.bitcode/v37-canon-posture-drift-report.json`, `.bitcode/v37-conversation-session-route-history.json`, `.bitcode/v37-conversation-stream-event-contract.json`, `.bitcode/v37-conversation-writing-workspace.json`, `.bitcode/v37-conversation-source-selector.json`, `.bitcode/v37-conversation-terminal-handoff.json`, `.bitcode/v37-conversation-persistence-privacy-redaction.json`, `.bitcode/v37-conversation-telemetry-proof-hooks.json`, `.bitcode/v37-conversation-rehearsal.json`, `.bitcode/v37-promotion-readiness-report.json`, V37 gate-quality and promotion workflow evidence, and `BITCODE_SPEC_V37_PROVEN.md` as the generated proof appendix for V37 promotion
13+
- Source parity state: V37 source-side ConversationSession route history, ConversationStreamEvent contracts, ConversationWritingWorkspace contracts, ConversationSourceSelector contracts, ConversationTerminalHandoff contracts, ConversationPersistencePrivacyRedaction contracts, ConversationTelemetryProofHooks contracts, ConversationRehearsal evidence, workflow, and promotion surfaces are canonicalized in the promoted V37 file family
14+
- Scope: V37 canonical notes for Website Conversations over promoted V36 Exchange canon
15+
- Last fully realized canonical target preserved in source: `V37`
1416

1517
This NOTES file does not promote V37. It is binding draft guidance while V37 gates are in flight.
1618

0 commit comments

Comments
 (0)