@mindrian_os/install 1.13.0-beta.17 → 1.13.0-beta.21

package/lib/memory/render-v2-disposition.test.cjs

@@ -0,0 +1,199 @@
+#!/usr/bin/env node
+'use strict';
+
+/*
+ * Copyright (c) 2026 Mindrian. BSL 1.1.
+ *
+ * Phase 121.5-04 (Sub-plan E) -- render-v2 disposition CI gate.
+ *
+ * Pairs with scripts/disposition-render-v2.cjs. The script is the
+ * operator-facing audit surface; this test is the CI wall that fails
+ * the build when a prose-path module silently starts importing
+ * lib/render/render-v2.cjs.
+ *
+ * What this test asserts (the disposition contract):
+ *
+ *   1. The audit script's verdict is HOLDS -- no prose-path module
+ *      currently imports render-v2.
+ *   2. The allowlist matches the canonical set documented in
+ *      lib/render/ROOM.md: { lib/render/render.cjs (v1 shim),
+ *      lib/hmi/selector-dispatcher.cjs (agent-surface dispatcher) }.
+ *      Any addition to the allowlist requires updating ROOM.md in
+ *      the same commit -- this test catches drift between the two.
+ *   3. lib/render/ROOM.md exists and documents the disposition with
+ *      the "current" linguistic discipline (NEVER "final", "complete",
+ *      or "closed set" framing on rankable input signal types --
+ *      verdict locked 2026-05-16 per the dual-graph review).
+ *   4. The Phase 102 VALIDATION.md is no longer status: draft (the
+ *      Sub-plan E precondition for v1.13.0 final release gate).
+ *
+ * Registered in lib/memory/run-feynman-tests.cjs alongside the existing
+ * Phase 102 fences (test-render-v2-signature.cjs etc.).
+ *
+ * Constraints (Phase 87 invariant):
+ *   - Node built-ins only (node:assert/strict, node:fs, node:path).
+ *   - CJS only.
+ *   - Zero new runtime dependencies.
+ *
+ * Canon parts: 3 (the v2 entry is reserved for Shape F.x decision-gate
+ *   output surfaces), 6 (Product-as-Venture: the plugin honors its own
+ *   disposition decisions via a CI gate, not a promise), 7 (Reuse Before
+ *   Build: the v1 shim wraps v2 so we ship one renderer, two entry
+ *   points -- not two parallel implementations).
+ */
+
+const assert = require('node:assert/strict');
+const fs = require('node:fs');
+const path = require('node:path');
+
+const REPO_ROOT = path.resolve(__dirname, '..', '..');
+
+let passed = 0;
+let failed = 0;
+
+function ok(name) {
+  passed += 1;
+  process.stdout.write('  ok ' + name + '\n');
+}
+
+function fail(name, err) {
+  failed += 1;
+  process.stdout.write('  FAIL ' + name + '\n');
+  if (err) process.stdout.write('    ' + (err.message || String(err)) + '\n');
+}
+
+// ---------------------------------------------------------------------------
+// Scenario 1: the audit script's verdict is HOLDS.
+// ---------------------------------------------------------------------------
+(function test1_auditVerdictHolds() {
+  const label = 'audit script verdict HOLDS (no prose-path consumer)';
+  try {
+    const audit = require(path.join(REPO_ROOT, 'scripts', 'disposition-render-v2.cjs'));
+    const report = audit.audit();
+    assert.equal(report.verdict, 'HOLDS',
+      'verdict must be HOLDS; got ' + report.verdict
+      + ' with violations: ' + JSON.stringify(report.violations));
+    assert.equal(report.disposition, 'agent-surface-only',
+      'disposition must be agent-surface-only');
+    assert.equal(report.summary.violation_count, 0,
+      'violation_count must be 0');
+    ok(label);
+  } catch (e) { fail(label, e); }
+})();
+
+// ---------------------------------------------------------------------------
+// Scenario 2: allowlist matches canonical set.
+// ---------------------------------------------------------------------------
+(function test2_allowlistMatches() {
+  const label = 'allowlist matches canonical agent-surface set';
+  try {
+    const audit = require(path.join(REPO_ROOT, 'scripts', 'disposition-render-v2.cjs'));
+    const expected = [
+      path.join('lib', 'render', 'render.cjs'),
+      path.join('lib', 'hmi', 'selector-dispatcher.cjs'),
+    ];
+    assert.deepEqual(
+      audit.ALLOWED_CONSUMERS.slice().sort(),
+      expected.slice().sort(),
+      'allowlist must equal canonical set; changes require ROOM.md update in same commit'
+    );
+    ok(label);
+  } catch (e) { fail(label, e); }
+})();
+
+// ---------------------------------------------------------------------------
+// Scenario 3: ROOM.md documents the disposition with "current" language.
+//
+// Per the 2026-05-16 dual-graph review (logged in 121.5-CONTEXT.md):
+//   render-v2's rankable input signal types is one of FOUR
+//   ultrareview-adjacent surfaces. The dual-graph proposal (future
+//   ASSOCIATION_LENS + TRANSITION_LENS lens classes) may add lens-derived
+//   signals. The disposition is "current," NOT "final/complete/closed."
+// ---------------------------------------------------------------------------
+(function test3_roomMdLinguisticDiscipline() {
+  const label = 'ROOM.md uses "current" linguistic discipline (no final/closed/complete framing)';
+  try {
+    const roomMdPath = path.join(REPO_ROOT, 'lib', 'render', 'ROOM.md');
+    assert.ok(fs.existsSync(roomMdPath), 'lib/render/ROOM.md must exist');
+    const body = fs.readFileSync(roomMdPath, 'utf8');
+
+    // Disposition must be present + carry the agent-surface-only marker.
+    assert.ok(/121\.5-04/.test(body) || /Sub-plan E/.test(body) || /Disposition/i.test(body),
+      'ROOM.md must reference the Sub-plan E disposition');
+    assert.ok(/agent-surface-only/i.test(body),
+      'ROOM.md must use the phrase "agent-surface-only"');
+
+    // Forbidden framing on rankable input signal types. The check is
+    // scoped to specific phrases that imply closure -- we do NOT forbid
+    // the words "final" or "complete" in unrelated context (e.g. "final
+    // release gate", "compose 4 zones" -- both legitimate). The patterns
+    // below are the closure-implying phrases we explicitly disallow on
+    // the signal-types section.
+    const forbidden = [
+      { pattern: /\bcomplete set of rankable\b/i, label: '"complete set of rankable"' },
+      { pattern: /\bclosed signal vocabulary\b/i, label: '"closed signal vocabulary"' },
+      { pattern: /\ball input signal types\b/i, label: '"all input signal types"' },
+      { pattern: /\bfinal set of rankable\b/i, label: '"final set of rankable"' },
+    ];
+    for (const f of forbidden) {
+      assert.ok(!f.pattern.test(body),
+        'ROOM.md must NOT contain ' + f.label + ' (use "current"/"today"/"as of" framing)');
+    }
+    ok(label);
+  } catch (e) { fail(label, e); }
+})();
+
+// ---------------------------------------------------------------------------
+// Scenario 4: Phase 102 VALIDATION.md is no longer status: draft.
+// ---------------------------------------------------------------------------
+(function test4_validation102OutOfDraft() {
+  const label = 'Phase 102 VALIDATION.md is out of status: draft';
+  try {
+    const valPath = path.join(REPO_ROOT,
+      '.planning', 'phases', '102-context-aware-rendering', '102-VALIDATION.md');
+    if (!fs.existsSync(valPath)) {
+      // The worktree may not carry the .planning tree; treat absence as
+      // a soft-pass at unit-test time. The Phase 102 VERIFICATION.md
+      // existence check (scenario 5) is the harder gate.
+      ok(label + ' (skipped: 102-VALIDATION.md absent in this worktree)');
+      return;
+    }
+    const body = fs.readFileSync(valPath, 'utf8');
+    // The frontmatter `status:` field MUST NOT read "draft".
+    const m = body.match(/^status:\s*(\S+)\s*$/m);
+    if (m) {
+      assert.notEqual(m[1].toLowerCase(), 'draft',
+        '102-VALIDATION.md status field must not be "draft"; got "' + m[1] + '"');
+    }
+    ok(label);
+  } catch (e) { fail(label, e); }
+})();
+
+// ---------------------------------------------------------------------------
+// Scenario 5: Phase 102 VERIFICATION.md exists.
+// ---------------------------------------------------------------------------
+(function test5_verification102Exists() {
+  const label = 'Phase 102 VERIFICATION.md exists (Sub-plan E closure)';
+  try {
+    const verPath = path.join(REPO_ROOT,
+      '.planning', 'phases', '102-context-aware-rendering', '102-VERIFICATION.md');
+    if (!fs.existsSync(path.dirname(verPath))) {
+      // Worktree may not carry the phase tree; soft-pass.
+      ok(label + ' (skipped: phase 102 dir absent in this worktree)');
+      return;
+    }
+    assert.ok(fs.existsSync(verPath),
+      '102-VERIFICATION.md must exist at ' + path.relative(REPO_ROOT, verPath));
+    const body = fs.readFileSync(verPath, 'utf8');
+    assert.ok(body.length > 200,
+      '102-VERIFICATION.md must be substantive (>200 bytes)');
+    ok(label);
+  } catch (e) { fail(label, e); }
+})();
+
+process.stdout.write('\n');
+process.stdout.write(
+  'Phase 121.5-04 render-v2 disposition gate: ' +
+    passed + ' passed, ' + failed + ' failed\n'
+);
+process.exit(failed === 0 ? 0 : 1);

package/lib/memory/run-feynman-tests.cjs

@@ -1119,6 +1119,12 @@ const TEST_FILES = [
   path.join(REPO_ROOT, 'tests', 'test-render-v2-jtbd-zone4.cjs'),
   path.join(REPO_ROOT, 'tests', 'test-render-v2-provenance.cjs'),
   path.join(REPO_ROOT, 'tests', 'test-render-v2-color-overlay.cjs'),
+  // Phase 121.5-04 Sub-plan E: render-v2 disposition CI gate. Asserts the
+  // audit verdict HOLDS, the allowlist matches the canonical agent-surface
+  // set, ROOM.md uses "current" linguistic discipline, and the Phase 102
+  // VALIDATION/VERIFICATION pair has closed (out of draft + record exists).
+  // Pairs with the operator-facing audit at scripts/disposition-render-v2.cjs.
+  path.join(REPO_ROOT, 'lib', 'memory', 'render-v2-disposition.test.cjs'),
   // Phase 103 — Memory Continuity Layer (within-session + across-session + cross-room)
   path.join(REPO_ROOT, 'tests', 'test-across-session-memory.cjs'),
   path.join(REPO_ROOT, 'tests', 'test-cross-room-memory.cjs'),
@@ -1319,6 +1325,13 @@ const TEST_FILES = [
   path.join(REPO_ROOT, 'tests', 'test-feynman-timeline-empty-state.cjs'),
   path.join(REPO_ROOT, 'tests', 'test-feynman-timeline-runner.cjs'),
   path.join(REPO_ROOT, 'tests', 'test-feynman-timeline-canon-part-9-invariant.cjs'),
+  // Phase 121.5 terminal-coherence-capstone (multi-plan; SessionStart Coordinator is Plan 00).
+  //   sessionstart-coordinator.test.cjs        -> Plan 121.5-00 (D-13..D-16 coordinator + 9 injector refactor)
+  // Aggregator: tests/run-all-121.5.sh. Additional 121.5-* test suites are
+  // already registered above this block (palette-consistency / statusline-two-row /
+  // terminal-capability / help-renderer / help-coverage); the SessionStart
+  // Coordinator suite lands here per the Plan 121.5-00 Task 3 contract.
+  path.join(REPO_ROOT, 'lib', 'memory', 'sessionstart-coordinator.test.cjs'),
   // Phase 125 F-Selector Ranker (8 plans: Plan 00 writeEdge through Plan 07 miss).
   //   navigation-write-edge.test.cjs          -> Plan 125-00 (writeEdge primitive)
   //   navigation-projections.test.cjs         -> Plan 125-01 (projection helpers)
@@ -1373,6 +1386,216 @@ const TEST_FILES = [
   //   Plan 118-06 (rule-linter + Dror 2.0 acceptance harness):
   path.join(REPO_ROOT, 'lib', 'core', 'mva-rule-linter.test.cjs'),
   path.join(REPO_ROOT, 'tests', 'test-mva-dror-harness.cjs'),
+  // Phase 119-00 Wave 1 (Room-as-Receipt Invariant; D-01 + D-04 + D-06 telemetry mirror).
+  //   test-room-auto-create-event-types.cjs -> 119-00 Task 1 (EVENT_TYPES floor + 3 new strings)
+  //   venture-shape-nudge.test.cjs          -> 119-00 Task 1 (D-02 nudge detector + D-01 invariant)
+  //   room-auto-create.test.cjs             -> 119-00 Task 2 (slug + scaffold + registry + memory_event)
+  //   test-room-auto-create-fingerprint-integration.cjs -> 119-00 Task 3 (sibling hook + nudge shim)
+  // Mirrors the Phase 117-00 + Phase 124-02 additive-tail-append registration precedent.
+  path.join(REPO_ROOT, 'tests', 'test-room-auto-create-event-types.cjs'),
+  path.join(REPO_ROOT, 'lib', 'core', 'venture-shape-nudge.test.cjs'),
+  path.join(REPO_ROOT, 'lib', 'core', 'room-auto-create.test.cjs'),
+  path.join(REPO_ROOT, 'tests', 'test-room-auto-create-fingerprint-integration.cjs'),
+  // Phase 119-02 Wave 1 extension (Room-as-Receipt Invariant; D-05 skeleton scaffold +
+  //   Larry thinness-acknowledgment voice line + Canon decision 15 ICM Layer 0 everywhere).
+  //   larry-thinness-acknowledgment.test.cjs        -> 119-02 Task 1 (THINNESS_VOICE_LINE verbatim + detector)
+  //   room-skeleton-scaffold.test.cjs               -> 119-02 Task 2 (scaffold unit tests; reentrancy + Part 8/9 invariants)
+  //   test-room-skeleton-scaffold-integration.cjs   -> 119-02 Task 2 (end-to-end placeholder-room scaffold scenarios)
+  //   test-119-02-auto-explore-fire-wiring.cjs      -> 119-02 Task 3 (REVISION 2026-05-16: scaffoldRoomSkeleton call
+  //                                                                   site wired into scripts/auto-explore-fire.cjs;
+  //                                                                   closes Blocker 1+4 phantom wiring)
+  // Aggregator: tests/test-119-02-scaffold.sh (the 6-gate shell harness).
+  path.join(REPO_ROOT, 'lib', 'core', 'larry-thinness-acknowledgment.test.cjs'),
+  path.join(REPO_ROOT, 'lib', 'core', 'room-skeleton-scaffold.test.cjs'),
+  path.join(REPO_ROOT, 'tests', 'test-room-skeleton-scaffold-integration.cjs'),
+  path.join(REPO_ROOT, 'tests', 'test-119-02-auto-explore-fire-wiring.cjs'),
+  // Phase 119-01 Wave 2 extension (Room-as-Receipt Invariant; D-03 + D-06 retroactive-naming
+  //   F.1 selector + discard cascade + LLM-name-suggester + tri-surface adaptation):
+  //   llm-name-suggester.test.cjs                -> 119-01 Task 1 (HAIKU_MODEL_ID + FALLBACK +
+  //                                                  suggest happy/sad + Canon Part 8 grep tripwire +
+  //                                                  EVENT_TYPES floor with +1 room_discard_partial_failure)
+  //   room-name-validator.test.cjs               -> 119-01 Task 2 (four rejection classes +
+  //                                                  Windows-reserved defense-in-depth)
+  //   room-discard-cascade.test.cjs              -> 119-01 Task 2 (transactional discard +
+  //                                                  partial-failure recovery via rooms-meta.db)
+  //   room-naming-selector.test.cjs              -> 119-01 Task 3 (orchestrator + F1_OPTION_LABELS
+  //                                                  + DECISION_PATHS + tri-surface envelope)
+  //   test-room-naming-selector-integration.cjs  -> 119-01 Task 4 (mva-orchestrator hook + e2e shim spawn)
+  // Aggregator: tests/test-119-01-scaffold.sh (the 7-gate shell harness).
+  path.join(REPO_ROOT, 'lib', 'core', 'llm-name-suggester.test.cjs'),
+  path.join(REPO_ROOT, 'lib', 'core', 'room-name-validator.test.cjs'),
+  path.join(REPO_ROOT, 'lib', 'core', 'room-discard-cascade.test.cjs'),
+  path.join(REPO_ROOT, 'lib', 'core', 'room-naming-selector.test.cjs'),
+  path.join(REPO_ROOT, 'tests', 'test-room-naming-selector-integration.cjs'),
+  // Phase 120-00 Wave 1: 4 breakthrough pattern detectors + Breakthrough graph schema.
+  //   test-breakthrough-event-types.cjs   -> 120-00 Task 1 (EVENT_TYPES floor + 6 new strings;
+  //                                          round-trip via navigation.logMemoryEvent)
+  //   test-breakthrough-edge-types.cjs    -> 120-00 Task 1 (ALLOWED_EDGE_TYPES floor + DERIVED_FROM;
+  //                                          round-trip via navigation.writeEdge)
+  //   lib/core/breakthrough/detectors.test.cjs -> 120-00 Task 2 (DETECTOR_THRESHOLDS verbatim + 4
+  //                                          detectors + classifyFireTier + Canon Part 8 invariant)
+  //   lib/core/breakthrough/schema.test.cjs    -> 120-00 Task 3 (writeBreakthrough + validateProvenance;
+  //                                          D-20 HARD FLOOR atomic-transaction invariant)
+  // Aggregator: tests/test-120-00-scaffold.sh (the 9-gate shell harness).
+  path.join(REPO_ROOT, 'tests', 'test-breakthrough-event-types.cjs'),
+  path.join(REPO_ROOT, 'tests', 'test-breakthrough-edge-types.cjs'),
+  path.join(REPO_ROOT, 'lib', 'core', 'breakthrough', 'detectors.test.cjs'),
+  path.join(REPO_ROOT, 'lib', 'core', 'breakthrough', 'schema.test.cjs'),
+  // Phase 120-01 Wave 2: F.7 Breakthrough Surface selector + 5-component scoring formula.
+  //   shape-f7-breakthrough-renderer.test.cjs -> 120-01 Task 1 (closed-vocab 5 verbs verbatim
+  //                                              + D-10 mandatory-dismiss invariant +
+  //                                              D-20 HARD FLOOR provenance refusal)
+  //   scoring.test.cjs                        -> 120-01 Task 3 (SCORING_WEIGHTS verbatim
+  //                                              + RECENCY_HALF_LIFE_DAYS verbatim + the
+  //                                              5-component formula + Laplace prior +
+  //                                              D-19 dismissal-rate canary + Canon Part 8
+  //                                              source-grep + em-dash HARD RULE)
+  //   selector-dispatcher additive F.7 branch is verified by tests/test-120-01-scaffold.sh
+  //                                              Gates 1 + 2 (already on disk; no separate
+  //                                              dispatcher unit-test file landed in Plan 120-01).
+  // Aggregator: tests/test-120-01-scaffold.sh (the 8-gate shell harness).
+  path.join(REPO_ROOT, 'lib', 'hmi', 'shape-f7-breakthrough-renderer.test.cjs'),
+  path.join(REPO_ROOT, 'lib', 'core', 'breakthrough', 'scoring.test.cjs'),
+  // Phase 120-02 Wave 2: session-start scanner + resurfacing + canary +
+  //   verb-dispatch consumer. Wires Plan 120-00 detectors + Plan 120-01 F.7 +
+  //   D-13..D-15 resurfacing rules + D-19 canary + 5-verb dispatch.
+  //   resurfacing.test.cjs     -> 120-02 Task 1 (D-13..D-15 predicates;
+  //                                SEVEN_DAY_COOLDOWN_MS verbatim; D-13 BOTH-
+  //                                condition lock; Canon Part 8 source-grep)
+  //   canary.test.cjs          -> 120-02 Task 1 (D-19 constants verbatim;
+  //                                computeDismissalRate + isThrottled +
+  //                                emitThrottleEvent; D19_MIN_SAMPLE floor;
+  //                                per-kind isolation)
+  //   verb-dispatch.test.cjs   -> 120-02 Task 2 (5-verb to 3-event lock;
+  //                                Confirm/Dismiss/File-as-decision emitters;
+  //                                D-09 FILED_AS_DECISION edge bridge;
+  //                                D-13 artifact_ids_at_dismiss baseline)
+  //   scanner.test.cjs         -> 120-02 Task 3 (scanForBreakthroughs +
+  //                                surfaceBreakthrough; D-16 silence; D-13..
+  //                                D-15 resurfacing filter; D-19 throttle
+  //                                filter; D-20 writeBreakthrough contract;
+  //                                D-20 third structural enforcement point)
+  //   check-pending-breakthrough.test.cjs -> 120-02 Task 3 session-start hook
+  //                                (no-active-room / D-16 silence / happy-path
+  //                                F.7 surfaced / corrupt-room degrade / hooks
+  //                                .json wiring)
+  //   tests/test-breakthrough-d20-end-to-end.cjs -> 120-02 Task 3 LOAD-BEARING
+  //                                D-20 invariant: every breakthrough_surfaced
+  //                                pairs with >= 1 DERIVED_FROM edge; batch
+  //                                invariant returns zero orphan-provenance
+  //                                Breakthroughs; surface refusal emits
+  //                                breakthrough_surface_blocked telemetry.
+  // Aggregator: tests/test-120-02-scaffold.sh (the 8-gate shell harness).
+  path.join(REPO_ROOT, 'lib', 'core', 'breakthrough', 'resurfacing.test.cjs'),
+  path.join(REPO_ROOT, 'lib', 'core', 'breakthrough', 'canary.test.cjs'),
+  path.join(REPO_ROOT, 'lib', 'core', 'breakthrough', 'verb-dispatch.test.cjs'),
+  path.join(REPO_ROOT, 'lib', 'core', 'breakthrough', 'scanner.test.cjs'),
+  path.join(REPO_ROOT, 'scripts', 'check-pending-breakthrough.test.cjs'),
+  path.join(REPO_ROOT, 'tests', 'test-breakthrough-d20-end-to-end.cjs'),
+  // Phase 120-03 Wave 2: D-17 voice scaffold + D-18 4-tier ethics fence + SOFT_BAND
+  //   review queue + Larry skill update. The conversational + ethical-enforcement
+  //   layer that converts the math-detected breakthrough into honest, evidence-backed
+  //   Larry voice. Aggregator: tests/test-120-03-scaffold.sh (the 9-gate harness).
+  //   voice-scaffold.test.cjs                       -> 120-03 Task 1 (composeBreakthrough
+  //                                                    VoiceLine + auditVoiceLine + the
+  //                                                    4 D-17 rule predicates + frozen
+  //                                                    constants verbatim)
+  //   ethics-fence.test.cjs                         -> 120-03 Task 2 (classifyEthicsBand
+  //                                                    + 4 frozen threshold constants +
+  //                                                    queueForReview happy path +
+  //                                                    memory_event mirror)
+  //   review-queue.test.cjs                         -> 120-03 Task 2 (openReviewQueue +
+  //                                                    .rooms/breakthrough-review-queue.db
+  //                                                    schema + insertReviewCandidate +
+  //                                                    listPendingReviews + graceful EACCES
+  //                                                    fallback)
+  //   scanner-d17-d18.test.cjs                      -> 120-03 Task 3 (scanner integration
+  //                                                    of voice-scaffold + ethics-fence;
+  //                                                    F.7 renderer voice_line slot; D-17
+  //                                                    violator -> structural default)
+  //   tests/test-breakthrough-d17-voice-audit.cjs   -> 120-03 Task 1 (D-17 audit catalog
+  //                                                    end-to-end: 8-candidate matrix +
+  //                                                    per-rule violator/valid pairs)
+  //   tests/test-breakthrough-d18-ethics-fence.cjs  -> 120-03 Task 2 (D-18 4-band end-to-end:
+  //                                                    SOFT_BAND queue + memory_event; no
+  //                                                    breakthrough_surfaced from SOFT_BAND)
+  path.join(REPO_ROOT, 'lib', 'core', 'breakthrough', 'voice-scaffold.test.cjs'),
+  path.join(REPO_ROOT, 'lib', 'core', 'breakthrough', 'ethics-fence.test.cjs'),
+  path.join(REPO_ROOT, 'lib', 'core', 'breakthrough', 'review-queue.test.cjs'),
+  path.join(REPO_ROOT, 'lib', 'core', 'breakthrough', 'scanner-d17-d18.test.cjs'),
+  path.join(REPO_ROOT, 'tests', 'test-breakthrough-d17-voice-audit.cjs'),
+  path.join(REPO_ROOT, 'tests', 'test-breakthrough-d18-ethics-fence.cjs'),
+  // Phase 121-00 (Wave 1, Foundation): unified trajectory-telemetry writer
+  // chokepoint + frozen v1 schema + Canon Part 8 emit-time validator. The
+  // architectural ancestor is lib/core/mva-telemetry.cjs (Phase 118); this
+  // module consolidates the 4 piecemeal writers (mva, query-efficiency,
+  // selector, navigation-bypass) into ONE emit() entry point with
+  // ISO-week rotation (events-YYYY-WNN.jsonl) and a per-row schema_version
+  // (Number 1). schema.test.cjs (2 cases) asserts EVENT_TYPES frozen at 15
+  // + ALLOWED_FIELDS shape. validator.test.cjs (7 cases) asserts the
+  // Canon Part 8 constitutional gate: unknown_event + unknown_field + 7
+  // adversarial forbidden-pattern rejections (Cypher / email / phone /
+  // brain host URL / absolute path / raw hex / free-text prose). The
+  // sha256-in-dedicated-field sanity case confirms hash-class fields are
+  // NOT false-flagged. writer.test.cjs (10 cases) asserts the chokepoint
+  // contract end-to-end: export surface, telemetryDir under HOME,
+  // isoWeekFilename zero-padding, telemetryFile composition, emit() JSONL
+  // shape (schema_version=1 Number + ISO-8601 timestamp + session_id +
+  // payload), throws on unknown event, throws on Part 8 forbidden pattern,
+  // recursive mkdir + silent fs-error swallow, two emits 5ms apart in
+  // same ISO-week file, all lines JSON.parseable with no BOM.
+  path.join(REPO_ROOT, 'lib', 'core', 'telemetry', 'schema.test.cjs'),
+  path.join(REPO_ROOT, 'lib', 'core', 'telemetry', 'validator.test.cjs'),
+  path.join(REPO_ROOT, 'lib', 'core', 'telemetry', 'writer.test.cjs'),
+  // Phase 121-01 Task 1 (Wave 1, atomic cutover): the one-time idempotent
+  // migration script that merges the 4 piecemeal telemetry sources
+  // (mva.jsonl, selector.jsonl, navigation-bypass.jsonl,
+  // query-efficiency.jsonl) into the unified events-YYYY-WNN.jsonl stream
+  // produced by writer.cjs. 8 fixture tests cover: empty source dir
+  // no-op, legacy-shape normalization to command_invocation, mva
+  // timestamp-order + schema_version=1 (Number), source rename to
+  // *.pre-v121.bak, sha256-fingerprint idempotence on re-run, mixed-week
+  // ISO split (W19/W20), Canon Part 8 forbidden-pattern quarantine
+  // without abort, stdout summary JSON shape. Hermetic per-test
+  // tmpdir + HOME swap; mirrors writer.test.cjs scaffolding.
+  path.join(REPO_ROOT, 'scripts', 'migrate-telemetry-v1.test.cjs'),
+  // Phase 121-02 Task 1..4 (Wave 2, capture-point wire-ins): 4 integration
+  // test files each verify that a high-signal capture point routes its
+  // emit through lib/core/telemetry/writer.cjs into the unified
+  // events-YYYY-WNN.jsonl stream. D-04 selector_pick (88.2/125 ranker) +
+  // D-05 tension_engagement (Phase 116) + D-06 auto_explore_decision
+  // (Phase 117) + D-07 breakthrough_dismissed (Phase 120 + ethics_tier +
+  // voice_audit_pass). 4 tests per file (16 total); each asserts the
+  // event lands with correct ALLOWED_FIELDS shape, non-blocking semantics
+  // (telemetry validation failure does NOT crash the shipping behavior),
+  // and that user-initiated state transitions are captured while
+  // system-driven transitions (decay, throttle, skip) are excluded.
+  path.join(REPO_ROOT, 'tests', 'test-121-02-selector-pick-capture.cjs'),
+  path.join(REPO_ROOT, 'tests', 'test-121-02-tension-engagement-capture.cjs'),
+  path.join(REPO_ROOT, 'tests', 'test-121-02-auto-explore-capture.cjs'),
+  path.join(REPO_ROOT, 'tests', 'test-121-02-breakthrough-dismissed-capture.cjs'),
+  // Phase 121-03 Task 1..4 (Wave 2, secondary D-09 capture points): 3 integration
+  // tests + 1 drowning-protection fixture. D-09 ships three lower-signal but
+  // broader-sweep emit surfaces: empathy audit observation CLI harness +
+  // Phase 119 room-as-receipt helper module + PostToolUse /mos:* broad sweep
+  // (100% sampling, type-discriminator-isolated bucket). The drowning-protection
+  // fixture proves the type discriminator works: 100 command_invocation events
+  // + 10 selector_pick events to a tmpdir, type-filter isolates them so SEED-002
+  // consumers can drop the bucket without losing the high-signal stream.
+  path.join(REPO_ROOT, 'tests', 'test-121-03-empathy-observation.cjs'),
+  path.join(REPO_ROOT, 'tests', 'test-121-03-room-receipt-emit.cjs'),
+  path.join(REPO_ROOT, 'tests', 'test-121-03-command-invocation-hook.cjs'),
+  path.join(REPO_ROOT, 'tests', 'test-121-03-drowning-protection.cjs'),
+  // Phase 127.1 brain-graphrag-collapse-pinecone-neo4j-hnsw (Wave 0 harness scaffold + Wave 1/2/3 outputs)
+  //   Surface 1 -> Plan 127.1-01 produces embedding-manifest.fixture.json (12,401 byte-identical SHA256 pairs).
+  //   Surface 2 -> Plan 127.1-02 produces index-config.fixture.json (SHOW INDEXES dim=1024 cosine ONLINE).
+  //   query-embedder -> Plan 127.1-03 produces mcp-server-brain/lib/query-embedder.cjs (server-side e5-large query embedding; hermetic, mocked transport).
+  //   Surface 3 -> Plan 127.1-04 produces overlap-baseline + overlap-neo4j fixtures (BLOCKING gate >= 0.80).
+  // Aggregator: tests/run-all-127.sh. RED-by-design until consumer plans land the fixtures.
+  path.join(REPO_ROOT, 'tests', '127.1-embedding-integrity.test.cjs'),
+  path.join(REPO_ROOT, 'tests', '127.1-index-config.test.cjs'),
+  path.join(REPO_ROOT, 'tests', '127.1-query-embedder.test.cjs'),
+  path.join(REPO_ROOT, 'tests', '127.1-graphrag-overlap.test.cjs'),
 ];
 
 // Exit code convention for child tests: