V48 Gate 3 (specification-implementation): era-pin superseded V43–V47 route-realization proofs so Gate Quality is green

Gate Quality failed at `pnpm --filter @bitcode/protocol test` (the sole failing
step in both CI runs): 16 V43–V47 canonical proof suites asserted `false !== true`.
Cause: those proofs read the historical singular-route source in place
(`uapi/app/deposit/*`, `uapi/app/read/*`) and assert on its literal content, but
V48 Gate 3 (f51a7b2) pluralized the routes and MOVED those files to
`uapi/app/deposits/` and `uapi/app/reads/` (old paths are redirect-only shims),
so every `readSource` came back empty. The standalone `.mjs` gate checkers are
already pointer-gated (era-pinned) in the workflow, but the protocol test suite
runs `node --test test/*.test.js` unconditionally, so this class was never pinned.

The proofs are NOT re-pointed at the plural routes: Gate 3 also rewrote those
files, so their historical content predicates would not match, and the frozen
proofs exist to attest their own era (the `.bitcode/` artifacts + promoted spec
families keep the historical route names). Instead they are era-pinned:

- New `packages/protocol/test/era-pinned-superseded-routes.js` — a `node:test`
  `test` shim that skips every registered test WITH A REASON when the current
  plural realization is present (`uapi/app/deposits/DepositPageClient.tsx`
  exists), and is `node:test` unchanged otherwise (so the proofs still run on the
  promoted V47 canon, where the singular realization stands).
- The 16 superseded proof files import `test` from that shim instead of
  `node:test` (one import-line change each; no body changes).
- V48 notes checker-posture paragraph updated to record the protocol-suite pin.

Verified: `pnpm --filter @bitcode/protocol test` → 237 tests, 199 pass, 0 fail,
38 skipped (exit 0); protocol typecheck 0. Skips render with the era-pin reason.

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

Author: geraldarthurdavis

BITCODE_SPEC_V48_NOTES.md

@@ -563,7 +563,20 @@ become MASTER-DETAIL:
 
 Checker posture: all gate checkers literal-matching the old routes are
 era-pinned (V43–V47) and do not run at the current pointer; frozen `.bitcode/`
-era artifacts and promoted spec families keep the historical route names.
+era artifacts and promoted spec families keep the historical route names. The
+standalone `.mjs` gate checkers are pointer-gated in the workflow; the
+`@bitcode/protocol` **test suite** (`node --test test/*.test.js`, run
+unconditionally by Gate Quality) was NOT — its V43–V47 route-realization proofs
+read the historical singular-route source in place and moved to `false !== true`
+once the pluralization moved the files to `uapi/app/deposits|reads`. Those 16
+superseded proof files import `test` from
+`packages/protocol/test/era-pinned-superseded-routes.js` (a `node:test` shim)
+instead of `node:test`: it skips every test WITH A REASON when the current
+plural realization is present (`uapi/app/deposits/DepositPageClient.tsx` exists)
+and runs them unchanged on the promoted V47 canon where the singular
+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.
 
 ### Deposit/Read product-surface presentation laws (Garrett, 2026-07-04)
 

packages/protocol/test/era-pinned-superseded-routes.js

@@ -0,0 +1,56 @@
+/**
+ * Era-pin for superseded product-route realization proofs.
+ *
+ * V48 Gate 3 pluralized the product routes (`/deposit` -> `/deposits`,
+ * `/read` -> `/reads`) and MOVED the client + route-model files into
+ * `uapi/app/deposits/` and `uapi/app/reads/` (the old paths are redirect-only
+ * shims). The V43-V47 canonical proofs read the historical singular-route
+ * source in place and assert on its literal content, so once the pluralized
+ * realization lands they are validating a superseded era against source that
+ * has legitimately moved forward.
+ *
+ * Rather than mutate the frozen historical proofs to chase the current routes
+ * (they exist to attest their own era, and the `.bitcode/` artifacts + promoted
+ * spec families keep the historical route names), these proofs 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 current (plural)
+ * realization is present. On the promoted V47 canon — where the singular
+ * realization still exists — `SUPERSEDED` is false and the proofs run normally.
+ *
+ * This mirrors the `.mjs` gate checkers' era-pinning (pointer-gated in the
+ * workflow); the difference is that the protocol test suite runs
+ * `node --test test/*.test.js` unconditionally, so the pin lives at the import.
+ */
+
+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 V48 plural-route realization is present in the working tree. */
+export const SUPERSEDED = existsSync(
+  path.join(REPO_ROOT, 'uapi/app/deposits/DepositPageClient.tsx'),
+);
+
+const SKIP_REASON =
+  'era-pinned: superseded by V48 Gate 3 route pluralization (/deposit->/deposits, /read->/reads)';
+
+/**
+ * A `node:test` `test` shim. When the realization is superseded it registers
+ * every test as skipped (carrying the reason); otherwise it is `node:test`'s
+ * `test` unchanged. Handles the `(name)`, `(name, fn)`, and
+ * `(name, options, fn)` call signatures.
+ */
+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/v43-cross-route-rehearsal-telemetry-repair.test.js

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

packages/protocol/test/v44-depositor-earnings-supply-opportunities.test.js

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

packages/protocol/test/v44-organization-policy-wallet-authority.test.js

@@ -1,5 +1,5 @@
 import assert from 'node:assert/strict';
-import { test } from 'node:test';
+import { test } from './era-pinned-superseded-routes.js';
 import {
   V44_ORGANIZATION_POLICY_ACTION_IDS,
   V44_ORGANIZATION_POLICY_OBJECT_IDS,

packages/protocol/test/v44-reading-budget-quote-policy.test.js

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

packages/protocol/test/v45-proof-family-artifacts.test.js

@@ -1,7 +1,7 @@
 import assert from 'node:assert/strict';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { test } from 'node:test';
+import { test } from './era-pinned-superseded-routes.js';
 
 import {
   V45_PROOF_FAMILY_ARTIFACT_PATHS,

packages/protocol/test/v45-source-safe-e2e-rehearsal.test.js

@@ -1,5 +1,5 @@
 import assert from 'node:assert/strict';
-import { test } from 'node:test';
+import { test } from './era-pinned-superseded-routes.js';
 
 import {
   V45_SOURCE_SAFE_E2E_REHEARSAL_ARTIFACT_PATH,

packages/protocol/test/v46-local-interface-comprehension-rehearsal.test.js

@@ -1,5 +1,5 @@
 import assert from 'node:assert/strict';
-import { test } from 'node:test';
+import { test } from './era-pinned-superseded-routes.js';
 import {
   V46_LOCAL_INTERFACE_COMPREHENSION_REHEARSAL_ARTIFACT_PATH,
   V46_LOCAL_INTERFACE_COMPREHENSION_REHEARSAL_ROWS,

packages/protocol/test/v46-product-route-comprehension-readback.test.js

@@ -1,5 +1,5 @@
 import assert from 'node:assert/strict';
-import { test } from 'node:test';
+import { test } from './era-pinned-superseded-routes.js';
 import {
   V46_PRODUCT_ROUTE_CAPABILITY_IDS,
   V46_PRODUCT_ROUTE_COMPREHENSION_READBACK_ARTIFACT_PATH,