Merge pull request #114 from engineeredsoftware/v37/gate-4-fullscreen-writing-workspace

V37 Gate 4: Conversation Writing Workspace

Author: geraldarthurdavis

.bitcode/v37-conversation-writing-workspace.json

@@ -115,6 +115,9 @@ jobs:
               if [ -f scripts/check-v37-gate3-conversation-stream-event-contracts.mjs ]; then
                 node scripts/check-v37-gate3-conversation-stream-event-contracts.mjs --skip-branch-check
               fi
+              if [ -f scripts/check-v37-gate4-conversation-writing-workspace.mjs ]; then
+                node scripts/check-v37-gate4-conversation-writing-workspace.mjs --skip-branch-check
+              fi
             fi
           else
             echo "Unexpected BITCODE_SPEC.txt pointer: $POINTER" >&2

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

@@ -244,6 +244,9 @@ jobs:
               if [ -f scripts/check-v37-gate3-conversation-stream-event-contracts.mjs ]; then
                 node scripts/check-v37-gate3-conversation-stream-event-contracts.mjs --skip-branch-check
               fi
+              if [ -f scripts/check-v37-gate4-conversation-writing-workspace.mjs ]; then
+                node scripts/check-v37-gate4-conversation-writing-workspace.mjs --skip-branch-check
+              fi
             fi
           else
             echo "Unexpected BITCODE_SPEC.txt pointer: $POINTER" >&2
@@ -333,6 +336,7 @@ jobs:
             tests/api/conversationSessionRouteHistoryContract.test.ts \
             tests/api/conversationStreamEventContract.test.ts \
             tests/conversationStreamPipelineLog.test.tsx \
+            tests/conversationWritingWorkspace.test.tsx \
             tests/auxillariesExternalsPane.test.tsx \
             tests/profileStep.test.tsx \
             tests/api/readReviewRoute.test.ts \

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

@@ -3,12 +3,12 @@
 ## Status
 
 - Version: `V37`
-- V37 state: draft implementation; Gate 3 closes ConversationStreamEvent stream UI and event contracts over active V36 Exchange canon
+- V37 state: draft implementation; Gate 4 closes ConversationWritingWorkspace fullscreen writing mode and composer workspace over active V36 Exchange canon
 - Current canonical/latest target: `V36`
 - Prior canonical anchor: `BITCODE_SPEC_V36.md`
 - Prior generated proof appendix: `BITCODE_SPEC_V36_PROVEN.md`
-- 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`, and `.bitcode/v37-conversation-stream-event-contract.json`
-- 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, and Gate 3 package-owned ConversationStreamEvent stream UI/event contracts
+- 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`, and `.bitcode/v37-conversation-writing-workspace.json`
+- 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, and Gate 4 package-owned ConversationWritingWorkspace fullscreen writing contracts
 - Active canonical pointer during draft opening: `BITCODE_SPEC.txt` -> `V36`
 - Notes companion: `BITCODE_SPEC_V37_NOTES.md`
 - Delta companion: `BITCODE_SPEC_V37_DELTA.md`
@@ -107,6 +107,31 @@ package tests, route/UI tests, telemetry binding, docs, workflow wiring,
 source safety, event kind coverage, proof roots, disclosure posture, and
 fail-closed states.
 
+## V37 Gate 4 ConversationWritingWorkspace writing canon
+
+Gate 4 implements `ConversationWritingWorkspace` as the package-owned
+fullscreen writing contract for Website Conversations. It owns Read Request,
+Need feedback, AssetPack review note, and Terminal handoff summary drafting
+modes. It emits `.bitcode/v37-conversation-writing-workspace.json` with
+`source-safe-conversation-writing-workspace-metadata`, deterministic row roots,
+deterministic detail roots, mode ids, action ids, required field ids, proof
+roots, event ids, route-local draft keys, source evidence roots, and
+source-safe disclosure limits.
+
+Conversation writing state is route-local workspace state. It can be saved,
+restored, summarized, and handed off from the fullscreen composer workspace.
+Saved drafts may remain in route-local browser storage for recovery, but
+summaries and handoff messages crossing the stream boundary are redacted
+source-safe metadata. Protected source, raw protected prompts, provider
+tokens, wallet private material, settlement private payloads, unpaid AssetPack
+source, and global ledger authority claims are never valid emitted workspace
+payloads. Terminal remains authoritative for transaction execution.
+
+`check:v37-gate4` validates package source, generated artifact freshness,
+package tests, UI tests, docs, workflow wiring, source safety, mode/action
+coverage, route-local draft keys, keyboard behavior, responsive fullscreen
+layout, recovery states, proof roots, and source-safe handoff summaries.
+
 ## Inherited V36 Exchange canon
 
 The promoted V36 sections below remain inherited canonical law for Exchange.
@@ -782,11 +807,15 @@ V36 inherits operator quality, visual/accessibility/performance posture, project
 | `.bitcode/v37-canonical-input-report.json` | Gate 1 | source-safe | V37 canonical-input checker |
 | `.bitcode/v37-canon-posture-drift-report.json` | Gate 1 | source-safe | V36 active / V37 draft posture checker |
 | `.bitcode/v37-conversation-session-route-history.json` | Gate 2 | source-safe | ConversationSession route-local history contracts |
+| `.bitcode/v37-conversation-stream-event-contract.json` | Gate 3 | source-safe | ConversationStreamEvent stream UI/event contracts |
+| `.bitcode/v37-conversation-writing-workspace.json` | Gate 4 | source-safe | ConversationWritingWorkspace fullscreen composer contracts |
 
 ### V37 specifying generated artifacts
 
 Gate 1 requires `.bitcode/v37-spec-family-report.json`, `.bitcode/v37-canonical-input-report.json`, and `.bitcode/v37-canon-posture-drift-report.json` readiness.
 Gate 2 adds `.bitcode/v37-conversation-session-route-history.json` from the package-owned ConversationSession route-history builder with package tests, route tests, workflow checks, and source-safety checks.
+Gate 3 adds `.bitcode/v37-conversation-stream-event-contract.json` from the package-owned ConversationStreamEvent builder with package tests, route/UI tests, workflow checks, and source-safety checks.
+Gate 4 adds `.bitcode/v37-conversation-writing-workspace.json` from the package-owned ConversationWritingWorkspace builder with package tests, fullscreen workspace UI tests, workflow checks, and source-safety checks.
 Later V37 gates add Conversations generated artifacts only when their package-owned builders, route checks, stream tests, telemetry checks, and source-safety tests exist.
 
 ### Shared generated-artifact fields

BITCODE_SPEC_V37.md

@@ -3,12 +3,12 @@
 ## Status
 
 - Version: `V37`
-- V37 state: draft implementation; this delta records the V36-to-V37 Website Conversations opening through Gate 3 ConversationStreamEvent stream UI/event contracts
+- V37 state: draft implementation; this delta records the V36-to-V37 Website Conversations opening through Gate 4 ConversationWritingWorkspace fullscreen writing contracts
 - Current canonical/latest target: `V36`
 - Prior canonical anchor: `BITCODE_SPEC_V36.md`
 - Prior generated proof appendix: `BITCODE_SPEC_V36_PROVEN.md`
-- 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`, and `.bitcode/v37-conversation-stream-event-contract.json`
-- 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
+- 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`, and `.bitcode/v37-conversation-writing-workspace.json`
+- 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
 - Spec companion: `BITCODE_SPEC_V37.md`
 - Notes companion: `BITCODE_SPEC_V37_NOTES.md`
 - Parity companion: `BITCODE_SPEC_V37_PARITY_MATRIX.md`
@@ -109,6 +109,14 @@ Closure acceptance:
 - accessibility, keyboard behavior, responsive layout, and recovery states are tested;
 - `pnpm run check:v37-gate4` validates workspace contracts, UI tests, docs, telemetry, source-safety, and workflow wiring.
 
+Gate 4 closure adds package-backed `ConversationWritingWorkspace` source,
+`.bitcode/v37-conversation-writing-workspace.json`,
+`source-safe-conversation-writing-workspace-metadata`, fullscreen workspace UI
+binding, Read Request, Need feedback, AssetPack review note, and Terminal
+handoff summary modes, save/restore/summarize/handoff actions, route-local
+draft keys, source-safe handoff summaries, package tests, UI tests, workflow
+wiring, and `check:v37-gate4`.
+
 ### Gate 5: Source Selectors And Context Policy
 
 Gate 5 defines source selection inside Conversations.

BITCODE_SPEC_V37_DELTA.md

@@ -3,13 +3,13 @@
 ## Status
 
 - Version: `V37`
-- V37 state: draft implementation; Gate 2 closes ConversationSession route-local history contracts over active V36 Exchange canon
+- V37 state: draft implementation; Gate 4 closes ConversationWritingWorkspace fullscreen writing mode and composer workspace over active V36 Exchange canon
 - Current canonical/latest target: `V36`
 - Current active draft target: `V37`
 - Prior canonical anchor: `BITCODE_SPEC_V36.md`
 - Prior generated proof appendix: `BITCODE_SPEC_V36_PROVEN.md`
-- Generated structured artifact inventory: draft `.bitcode/v37-spec-family-report.json`, `.bitcode/v37-canonical-input-report.json`, `.bitcode/v37-canon-posture-drift-report.json`, and `.bitcode/v37-conversation-session-route-history.json`
-- 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
+- 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`, and `.bitcode/v37-conversation-writing-workspace.json`
+- 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
 - Scope: draft notes for website Conversations work after V36 Exchange depth and after the V28 ChatGPT App MVP proved the interface path.
 
 This NOTES file does not promote V37. It is binding draft guidance while V37 gates are in flight.
@@ -71,6 +71,21 @@ posture, and fail-closed state.
 Gate 3 keeps gate-quality CI greenable by bounding the workflow runtime and
 running maintained targeted package tests inside the gate job.
 
+## Gate 4 implementation notes
+
+ConversationWritingWorkspace contracts are source-safe fullscreen composer
+contracts, not protected source storage or Terminal authority. Gate 4 adds
+`.bitcode/v37-conversation-writing-workspace.json`,
+`buildConversationWritingWorkspace`, the route-facing writing workspace helper,
+the fullscreen workspace component, package tests, UI tests, and
+`check:v37-gate4`.
+The required modes are Read Request, Need feedback, AssetPack review note, and
+Terminal handoff summary. The required actions are save, restore, summarize,
+and handoff. Draft recovery stays route-local; emitted summaries and handoff
+messages are redacted source-safe metadata only and must not expose protected
+source, provider tokens, private wallet material, unpaid AssetPack source,
+settlement private payloads, or global ledger authority claims.
+
 ## V37 gate plan
 
 - Gate 1: V37 Conversations Roadmap And Spec Opening