V48 Gate 3 (specification-implementation): eradicate legacy terminal browser proofs; repoint browser-proof coverage to /deposits and /reads

The /terminal cockpit browser proofs are removed and the active browser-proof
coverage now proves the current product surfaces.

- Contracts: uapi/app/bitcode-browser-proof.ts and
  bitcode-browser-accessibility-responsive-proof.ts drop the `terminal` surface
  and add `deposits` (/deposits) + `reads` (/reads) surfaces with real testids
  (route-shell-deposit/deposits-pipelines-table/deposit-synthesis-telemetry,
  route-shell-read/reads-pipelines-table/reads-synthesized-packs); Auxillaries
  routes move /terminal?auxillary-open-to= -> /packs?auxillary-open-to=. The jest
  contract tests and the opt-in Playwright specs are repointed to match.
- Deleted the V29-era terminal-ux browser proof: terminal-ux-browser-proof.ts,
  terminalUxBrowserProof.test.tsx, commercial-mvp.terminal-ux.spec.ts. Removed
  from the Gate Quality jest step + jest.config allowlist + the test:e2e:terminal-ux
  script; renamed test:e2e:v32-browser-proof -> test:e2e:accessibility-responsive-proof;
  CI step names drop "Terminal".
- Frozen V39/V40 proofs that read the deleted files as evidence
  (v39-enterprise-reading-ux-state, v40-browser-e2e-visual-proof,
  v40-test-inventory-coverage-matrix) are era-pinned via a new
  packages/protocol/test/era-pinned-superseded-browser-proofs.js shim (skips WITH
  A REASON once the terminal-ux proof is absent; runs unchanged on V39/V40 canon).
  Era-pinned V29/V32 .mjs checkers + historical canon-promotion workflows keep
  their references (inert at the current pointer; deep removal is F8 scope).

Verified: uapi tsc 0; uapi jest 156 suites / 619 pass; protocol 237 tests,
193 pass, 0 fail, 44 skipped; no live/dangling refs to the deleted files.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: geraldarthurdavis

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

@@ -926,24 +926,19 @@ jobs:
             tests/protocolCommercialBoundary.test.ts \
             tests/terminalTransactionDetailCards.test.tsx \
             tests/terminalTransactionDetailSnapshot.test.ts \
-            tests/terminalUxBrowserProof.test.tsx \
             tests/bitcodeBrowserProof.test.ts \
             tests/bitcodeBrowserAccessibilityResponsiveProof.test.ts \
             tests/readingOperationalTelemetryPipelineLog.test.tsx \
             tests/pipelineExecutionLogHeader.test.tsx \
             --runInBand
 
-      - name: Install Terminal browser proof browser
+      - name: Install browser-proof browser
         if: vars.BITCODE_ENABLE_GATE_BROWSER_PROOF == '1'
         run: pnpm --dir uapi exec playwright install chromium --with-deps
 
-      - name: Browser proof Terminal cockpit
+      - name: Browser proof Deposits, Reads, and Auxillaries responsive accessibility
         if: vars.BITCODE_ENABLE_GATE_BROWSER_PROOF == '1'
-        run: pnpm --dir uapi run test:e2e:terminal-ux
-
-      - name: Browser proof Terminal and Auxillaries responsive accessibility
-        if: vars.BITCODE_ENABLE_GATE_BROWSER_PROOF == '1'
-        run: pnpm --dir uapi run test:e2e:v32-browser-proof
+        run: pnpm --dir uapi run test:e2e:accessibility-responsive-proof
 
       - name: Browser proof product surfaces
         if: vars.BITCODE_ENABLE_GATE_BROWSER_PROOF == '1'

BITCODE_SPEC_V48_NOTES.md

@@ -578,6 +578,37 @@ realization still stands. The proofs are NOT re-pointed at the plural routes —
 Gate 3 rewrote those files, so their historical content predicates would not
 match, and the frozen proofs attest their own era.
 
+### Legacy terminal browser-proof eradication (Garrett, 2026-07-05)
+
+The legacy `/terminal` cockpit **browser proofs** are eradicated and the active
+browser-proof coverage is repointed at the current product surfaces:
+
+- The two ACTIVE browser-proof contracts (`uapi/app/bitcode-browser-proof.ts`,
+  `uapi/app/bitcode-browser-accessibility-responsive-proof.ts`) drop the
+  `terminal` surface (routes `/terminal…`) and instead prove `deposits`
+  (`/deposits`) and `reads` (`/reads`) — real routes, real testids
+  (`route-shell-deposit`/`deposits-pipelines-table`/`deposit-synthesis-telemetry`,
+  `route-shell-read`/`reads-pipelines-table`/`reads-synthesized-packs`) — with the
+  Auxillaries routes moved from `/terminal?auxillary-open-to=` to
+  `/packs?auxillary-open-to=`. Their jest contract tests and the (opt-in,
+  gate-var-guarded) Playwright specs are repointed to match.
+- The V29-era terminal-ux browser proof is DELETED:
+  `uapi/app/terminal/terminal-ux-browser-proof.ts`,
+  `uapi/tests/terminalUxBrowserProof.test.tsx`, and
+  `uapi/tests/e2e/commercial-mvp.terminal-ux.spec.ts` — removed from the Gate
+  Quality jest step, the `jest.config.cjs` allowlist, and the `test:e2e:terminal-ux`
+  package script; the accessibility script is renamed
+  `test:e2e:v32-browser-proof` → `test:e2e:accessibility-responsive-proof`, and the
+  CI step names drop "Terminal".
+- Frozen V39/V40 canonical proofs that read those deleted files as evidence
+  (`v39-enterprise-reading-ux-state`, `v40-browser-e2e-visual-proof`,
+  `v40-test-inventory-coverage-matrix`) are era-pinned via a second shim,
+  `packages/protocol/test/era-pinned-superseded-browser-proofs.js`, which skips
+  WITH A REASON once the terminal-ux proof is absent (and runs unchanged on the
+  promoted V39/V40 canon). The era-pinned V29/V32 `.mjs` checker scripts and the
+  historical canon-promotion workflows keep their references (inert at the current
+  pointer) — their deep removal belongs to the broader F8 `/terminal` eradication.
+
 ### Deposit/Read product-surface presentation laws (Garrett, 2026-07-04)
 
 The 2026-07-04 UI wave on the product surfaces (/deposits, /reads, and the

packages/protocol/test/era-pinned-superseded-browser-proofs.js

@@ -0,0 +1,44 @@
+/**
+ * Era-pin for proofs superseded by the V48 legacy terminal browser-proof eradication.
+ *
+ * V48 Gate 3 eradicated the legacy `/terminal` cockpit browser proof — the
+ * `terminal-ux-browser-proof.ts` contract, its jest test, and the
+ * `commercial-mvp.terminal-ux.spec.ts` Playwright spec — and repointed the
+ * active browser-proof contracts at the current product surfaces (`/deposits`,
+ * `/reads`). The V39/V40 canonical proofs that read those terminal-ux files as
+ * evidence therefore attest a superseded era.
+ *
+ * As with `era-pinned-superseded-routes.js`, the frozen historical proofs are
+ * NOT re-pointed (they attest their own era); they are era-pinned: a superseded
+ * proof file imports `test` from here instead of `node:test`, and every test it
+ * registers is skipped WITH A REASON once the terminal-ux browser proof is
+ * gone. On the promoted V39/V40 canon — where the terminal-ux files still
+ * exist — `SUPERSEDED` is false and the proofs run unchanged.
+ */
+
+import nodeTest from 'node:test';
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const REPO_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../../..');
+
+/** True once the legacy terminal-ux browser proof has been eradicated. */
+export const SUPERSEDED = !existsSync(
+  path.join(REPO_ROOT, 'uapi/app/terminal/terminal-ux-browser-proof.ts'),
+);
+
+const SKIP_REASON =
+  'era-pinned: superseded by V48 Gate 3 legacy terminal browser-proof eradication (repointed to /deposits, /reads)';
+
+function eraPinnedTest(name, options, fn) {
+  if (!SUPERSEDED) return nodeTest(name, options, fn);
+  if (typeof options === 'function') {
+    fn = options;
+    options = {};
+  }
+  return nodeTest(name, { ...(options || {}), skip: SKIP_REASON }, fn || (() => {}));
+}
+
+export default eraPinnedTest;
+export { eraPinnedTest as test };

packages/protocol/test/v39-enterprise-reading-ux-state.test.js

@@ -1,5 +1,5 @@
 import assert from 'node:assert/strict';
-import test from 'node:test';
+import test from './era-pinned-superseded-browser-proofs.js';
 
 import {
   V39_ENTERPRISE_READING_STEP_IDS,

packages/protocol/test/v40-browser-e2e-visual-proof.test.js

@@ -1,5 +1,5 @@
 import assert from 'node:assert/strict';
-import test from 'node:test';
+import test from './era-pinned-superseded-browser-proofs.js';
 
 import {
   V40_BROWSER_E2E_VISUAL_EXPECTED_TOTALS,

packages/protocol/test/v40-test-inventory-coverage-matrix.test.js

@@ -1,5 +1,5 @@
 import assert from 'node:assert/strict';
-import test from 'node:test';
+import test from './era-pinned-superseded-browser-proofs.js';
 
 import {
   V40_TEST_INVENTORY_COVERAGE_MATRIX_ARTIFACT_PATH,

uapi/app/bitcode-browser-accessibility-responsive-proof.ts

@@ -18,44 +18,69 @@ export const BITCODE_BROWSER_ACCESSIBILITY_RESPONSIVE_PROOF_ASSERTIONS = [
 
 export const BITCODE_BROWSER_ACCESSIBILITY_RESPONSIVE_PROOF_SURFACES = [
   {
-    id: 'terminal',
-    label: 'Bitcode Terminal',
+    id: 'deposits',
+    label: 'Bitcode Deposits',
     routes: [
-      { id: 'default', path: '/terminal', state: 'default' },
+      { id: 'default', path: '/deposits', state: 'default' },
       {
         id: 'guided',
-        path: '/terminal',
+        path: '/deposits',
         state: 'guided',
-        selector: '[data-testid="terminal-transaction-workspace"]',
+        selector: '[data-testid="deposits-pipelines-table"]',
       },
       {
         id: 'detail',
-        path: '/terminal?transactionId=mock-run-branch-remediation&transactionDetail=activity',
+        path: '/deposits?transactionId=mock-run-branch-remediation',
         state: 'detail',
-        selector: '[data-testid="terminal-selected-activity-detail"]',
+        selector: '[data-testid="deposit-synthesis-telemetry"]',
       },
     ],
     landmarks: ['main', 'region', 'group'],
     evidenceFiles: [
-      'uapi/tests/terminalUxBrowserProof.test.tsx',
-      'uapi/tests/e2e/commercial-mvp.terminal-ux.spec.ts',
+      'uapi/tests/depositPageClient.test.tsx',
+      'uapi/tests/e2e/commercial-mvp.ip-exchange.spec.ts',
+      'uapi/tests/e2e/bitcode-browser-accessibility-responsive-proof.spec.ts',
+    ],
+  },
+  {
+    id: 'reads',
+    label: 'Bitcode Reads',
+    routes: [
+      { id: 'default', path: '/reads', state: 'default' },
+      {
+        id: 'guided',
+        path: '/reads',
+        state: 'guided',
+        selector: '[data-testid="reads-pipelines-table"]',
+      },
+      {
+        id: 'detail',
+        path: '/reads?transactionId=mock-run-branch-remediation',
+        state: 'detail',
+        selector: '[data-testid="reads-synthesized-packs"]',
+      },
+    ],
+    landmarks: ['main', 'region', 'group'],
+    evidenceFiles: [
+      'uapi/tests/readPageClient.test.tsx',
+      'uapi/tests/e2e/commercial-mvp.ip-exchange.spec.ts',
       'uapi/tests/e2e/bitcode-browser-accessibility-responsive-proof.spec.ts',
     ],
   },
   {
     id: 'auxillaries',
     label: 'Bitcode Auxillaries',
     routes: [
-      { id: 'default', path: '/terminal?auxillary-open-to=wallet', state: 'default' },
+      { id: 'default', path: '/packs?auxillary-open-to=wallet', state: 'default' },
       {
         id: 'guided',
-        path: '/terminal?auxillary-open-to=profile',
+        path: '/packs?auxillary-open-to=profile',
         state: 'guided',
         selector: '[data-testid="auxillaries-pane-navigation"]',
       },
       {
         id: 'detail',
-        path: '/terminal?auxillary-open-to=interfaces',
+        path: '/packs?auxillary-open-to=interfaces',
         state: 'detail',
         selector: '[data-testid="auxillaries-active-pane-region"]',
       },

uapi/app/bitcode-browser-proof.ts

@@ -26,20 +26,50 @@ export const BITCODE_BROWSER_PROOF_VISUAL_STRATEGY = [
 
 export const BITCODE_BROWSER_PROOF_SURFACES = [
   {
-    id: 'terminal',
-    label: 'Bitcode Terminal',
+    id: 'deposits',
+    label: 'Bitcode Deposits',
     routes: [
-      { id: 'request-read', path: '/terminal', state: 'five-stage Reading request' },
       {
-        id: 'selected-activity',
-        path: '/terminal?transactionId=mock-run-branch-remediation&transactionDetail=activity',
-        state: 'transaction activity detail',
-        selector: '[data-testid="terminal-activity-stream-surface"]',
+        id: 'pipelines',
+        path: '/deposits',
+        state: 'deposit pipelines and option synthesis',
+        selector: '[data-testid="deposits-pipelines-table"]',
       },
       {
-        id: 'blocked-console',
-        path: '/terminal?transactionId=mock-run-branch-remediation&transactionDetail=console',
-        state: 'blocked source-safe console detail',
+        id: 'selected-telemetry',
+        path: '/deposits?transactionId=mock-run-branch-remediation',
+        state: 'selected synthesis telemetry detail',
+        selector: '[data-testid="deposit-synthesis-telemetry"]',
+      },
+    ],
+    landmarks: ['main', 'region', 'group', 'status'],
+    interactionStates: [
+      'connect-source',
+      'synthesize-options',
+      'review-measurements',
+      'admit-to-depository',
+    ],
+    evidenceFiles: [
+      'uapi/tests/e2e/commercial-mvp.ip-exchange.spec.ts',
+      'uapi/tests/e2e/bitcode-browser-proof.spec.ts',
+      'uapi/tests/depositPageClient.test.tsx',
+    ],
+  },
+  {
+    id: 'reads',
+    label: 'Bitcode Reads',
+    routes: [
+      {
+        id: 'pipelines',
+        path: '/reads',
+        state: 'five-stage Reading request and pipelines',
+        selector: '[data-testid="reads-pipelines-table"]',
+      },
+      {
+        id: 'selected-telemetry',
+        path: '/reads?transactionId=mock-run-branch-remediation',
+        state: 'selected read telemetry detail',
+        selector: '[data-testid="reads-synthesized-packs"]',
       },
     ],
     landmarks: ['main', 'region', 'group', 'status'],
@@ -51,10 +81,9 @@ export const BITCODE_BROWSER_PROOF_SURFACES = [
       'buy-asset-pack-settle',
     ],
     evidenceFiles: [
-      'uapi/tests/e2e/commercial-mvp.terminal.spec.ts',
-      'uapi/tests/e2e/commercial-mvp.terminal-ux.spec.ts',
+      'uapi/tests/e2e/commercial-mvp.ip-exchange.spec.ts',
       'uapi/tests/e2e/bitcode-browser-proof.spec.ts',
-      'uapi/tests/terminalUxBrowserProof.test.tsx',
+      'uapi/tests/readPageClient.test.tsx',
     ],
   },
   {
@@ -77,9 +106,9 @@ export const BITCODE_BROWSER_PROOF_SURFACES = [
     id: 'auxillaries',
     label: 'Bitcode Auxillaries',
     routes: [
-      { id: 'wallet', path: '/terminal?auxillary-open-to=wallet', state: 'wallet support pane' },
-      { id: 'profile', path: '/terminal?auxillary-open-to=profile', state: 'profile support pane' },
-      { id: 'interfaces', path: '/terminal?auxillary-open-to=interfaces', state: 'interfaces support pane' },
+      { id: 'wallet', path: '/packs?auxillary-open-to=wallet', state: 'wallet support pane' },
+      { id: 'profile', path: '/packs?auxillary-open-to=profile', state: 'profile support pane' },
+      { id: 'interfaces', path: '/packs?auxillary-open-to=interfaces', state: 'interfaces support pane' },
     ],
     landmarks: ['main', 'navigation', 'region', 'status'],
     interactionStates: ['skip-to-active-pane', 'pane-tabs', 'expandable-audit-detail'],