wip v28

Author: geraldarthurdavis

.ai/PRODUCT.md

@@ -7,9 +7,9 @@ This document is a current, non-canonical operator guide for the shipping V26 re
 Bitcode V26 is the first commercial promotion of the source-to-shares system:
 
 - `protocol-demonstration/` is the deterministic protocol witness and proof substrate.
-- `uapi/app/application/*` is the Bitcode Terminal route for give, need, review, fit, settlement, and reread.
+- `uapi/app/application/*` is the Bitcode Terminal route for deposit, read, review, fit, settlement, and reread.
 - `packages/api/*`, `uapi/app/api/*`, `packages/orm/*`, and Supabase schemas carry Bitcode Exchange state.
-- `packages/pipelines/asset-pack/*` carries Need-satisfaction AssetPack synthesis and Finish delivery.
+- `packages/pipelines/asset-pack/*` carries Read-satisfaction AssetPack synthesis and Finish delivery.
 - MCP, ChatGPT App, GitHub/VCS, webhooks, and other connections are admitted interfaces, not separate product owners.
 
 ## Terminal
@@ -25,7 +25,7 @@ Transactions write-space lives under `/application`.
 Auxillaries live under `/auxillaries/*`.
 Shared execution update carrier: `uapi/components/base/bitcode/execution/WorkUpdatePanel.tsx`.
 
-The main operator actions are `give` and `need`. Repository choice, Need review, fit review, transaction readiness, proof follow-through, and closure rereads must all resolve through Bitcode-owned state rather than shell-only side effects.
+The main operator actions are `give` and `read`. Repository choice, Read review, fit review, transaction readiness, proof follow-through, and closure rereads must all resolve through Bitcode-owned state rather than shell-only side effects.
 
 ## Exchange
 
@@ -34,7 +34,7 @@ The Exchange stores and rereads:
 - source/provider connections and repository scope,
 - conversations, attachments, and normalized rich input,
 - execution rows, events, phases, and activity history,
-- Need review and fit-quality receipts,
+- Read review and fit-quality receipts,
 - AssetPack synthesis artifacts, written assets, Shippables, and delivery-mechanism evidence,
 - settlement, proof, and operational telemetry.
 

.bitcode/conversations-continuity-proof.json

@@ -123,7 +123,7 @@
         {
           "file": "packages/api/src/routes/conversations.ts",
           "evidence": "need_measurement_intents",
-          "description": "Need-measurement intent is first-class conversation execution evidence"
+          "description": "Read-measurement intent is first-class conversation execution evidence"
         },
         {
           "file": "packages/api/src/conversations/messages.ts",
@@ -148,7 +148,7 @@
         {
           "file": "uapi/tests/api/chatStreamRoute.test.ts",
           "evidence": "rich_input: expect.objectContaining",
-          "description": "root conversation stream test asserts persisted Need-measurement rich input"
+          "description": "root conversation stream test asserts persisted Read-measurement rich input"
         },
         {
           "file": "uapi/tests/api/conversationThreadStreamRoute.test.ts",

.bitcode/fifth-gate-closure-deepening-proof.json

@@ -85,7 +85,7 @@
       "label": "Bitcode Terminal read/write loop",
       "baselineAdvanced": true,
       "closurePassed": true,
-      "currentDeepening": "Terminal-facing source-to-shares Need review, fit admission, settlement reading, TypeScript-only uapi/app ownership, product readiness audit, and environment posture are generated and app/API-backed.",
+      "currentDeepening": "Terminal-facing source-to-shares Read review, fit admission, settlement reading, TypeScript-only uapi/app ownership, product readiness audit, and environment posture are generated and app/API-backed.",
       "remainingClosure": "Closed by the fifth-gate closure proof as a minimum-functional read/write baseline; sixth-gate and later harden wider browser/authenticated production coverage.",
       "evidenceArtifactPaths": [
         ".bitcode/application-composition-proof.json",
@@ -112,7 +112,7 @@
       "label": "Transactional readiness and repository scope",
       "baselineAdvanced": true,
       "closurePassed": true,
-      "currentDeepening": "Repository-bound source-to-shares admission, stored-first/live-fallback connected-provider inventory validation, reconnect-required downgrade for invalid saved provider sessions, Terminal-side repository-supply reread that keeps stored inventory visible under reconnect-required provider drift, main-route readiness derivation that prefers route-local repository truth over auxillary reread or weak connection-presence fallback, Terminal pulse plus Give + Need flow-guide rendering of exact reconnect-required readiness, wallet-reconnect-required downgrade for saved verified signer posture without a live wallet-provider session, and Connects plus `$BTD` reread through `/api/auxillaries/data` are proof-backed as the current readiness baseline.",
+      "currentDeepening": "Repository-bound source-to-shares admission, stored-first/live-fallback connected-provider inventory validation, reconnect-required downgrade for invalid saved provider sessions, Terminal-side repository-supply reread that keeps stored inventory visible under reconnect-required provider drift, main-route readiness derivation that prefers route-local repository truth over auxillary reread or weak connection-presence fallback, Terminal pulse plus Deposit + Read flow-guide rendering of exact reconnect-required readiness, wallet-reconnect-required downgrade for saved verified signer posture without a live wallet-provider session, and Connects plus `$BTD` reread through `/api/auxillaries/data` are proof-backed as the current readiness baseline.",
       "remainingClosure": "Closed by the fifth-gate closure proof as an operative readiness baseline; live provider signing expansion remains later-gate hardening.",
       "evidenceArtifactPaths": [
         ".bitcode/application-composition-proof.json",

.bitcode/fifth-gate-closure-proof.json

@@ -107,18 +107,18 @@
       ],
       "sourceCheck": {
         "checkId": "terminal-read-write-loop-source-evidence",
-        "label": "Terminal give, need, deposit, branch, closure, selected-detail, and ledger reread are source-backed by route/API tests",
+        "label": "Terminal deposit, read, deposit, branch, closure, selected-detail, and ledger reread are source-backed by route/API tests",
         "passed": true,
         "detail": "4 source evidence requirements satisfied",
         "requiredEvidence": [
           {
             "file": "uapi/tests/api/executionsHistoryWriteReadParity.test.ts",
-            "evidence": "round-trips give, need, and closure writes through the same Bitcode activity ledger",
+            "evidence": "round-trips deposit, read, and closure writes through the same Bitcode activity ledger",
             "description": "execution-history parity proves write/reread continuity"
           },
           {
-            "file": "uapi/tests/api/needReviewProtocolParity.test.ts",
-            "evidence": "rereads accepted Need review and source-to-shares settlement artifacts through the commercial /api/state route",
+            "file": "uapi/tests/api/readReviewProtocolParity.test.ts",
+            "evidence": "rereads accepted Read review and source-to-shares settlement artifacts through the commercial /api/state route",
             "description": "state route rereads accepted source-to-shares branch materialization"
           },
           {

.bitcode/fourth-gate-reclosure-review-proof.json

@@ -157,7 +157,7 @@
       "label": "Retained tools and agents are Bitcode-purposed with prompt ownership and reader-first scope",
       "status": "closed",
       "passed": true,
-      "detail": "Prompt, inference, and retained-package proofs keep retained ports bounded to Bitcode roles such as need ingestion and source-attributed support.",
+      "detail": "Prompt, inference, and retained-package proofs keep retained ports bounded to Bitcode roles such as read ingestion and source-attributed support.",
       "evidenceArtifactPaths": [
         ".bitcode/prompt-system-totality-proof.json",
         ".bitcode/inference-implementation-records-proof.json",