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

package/lib/memory/palette-consistency.test.cjs

@@ -0,0 +1,127 @@
+// palette-consistency.test.cjs -- Phase 121.5-03 Task 1
+//
+// Tests for references/visual/palette.json + scripts/check-palette-consistency.cjs.
+//
+// 5 tests: schema, hex format, live-repo check, fixture violation, derived_files paths.
+//
+// No emoji. No em-dashes.
+
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const REPO_ROOT = path.join(__dirname, '..', '..');
+const PALETTE_PATH = path.join(REPO_ROOT, 'references', 'visual', 'palette.json');
+const CHECKER_PATH = path.join(REPO_ROOT, 'scripts', 'check-palette-consistency.cjs');
+
+const checker = require(CHECKER_PATH);
+
+let passed = 0;
+let failed = 0;
+
+function ok(name) {
+  console.log('  ok   ' + name);
+  passed++;
+}
+function fail(name, msg) {
+  console.error('  FAIL ' + name + (msg ? ' -- ' + msg : ''));
+  failed++;
+}
+
+function assert(cond, name, msg) {
+  if (cond) ok(name);
+  else fail(name, msg);
+}
+
+console.log('test palette-consistency');
+
+// Test 1: palette.json parses; required tiers present.
+let palette;
+try {
+  palette = JSON.parse(fs.readFileSync(PALETTE_PATH, 'utf8'));
+  const hasAll = palette.base && palette.palette_a_discovery && palette.palette_b_build &&
+                 palette.ansi_5_color && Array.isArray(palette.derived_files);
+  assert(hasAll, 'test1 schema -- base, palette_a, palette_b, ansi_5, derived_files all present');
+} catch (e) {
+  fail('test1 schema -- parse error: ' + e.message);
+}
+
+// Test 2: Every hex value matches /^#[0-9a-f]{6}$/i.
+try {
+  const tiers = [palette.base, palette.palette_a_discovery, palette.palette_b_build, palette.extended || {}];
+  let bad = null;
+  for (const t of tiers) {
+    if (!t) continue;
+    for (const k of Object.keys(t)) {
+      const v = t[k];
+      if (typeof v === 'string' && !/^#[0-9a-f]{6}$/i.test(v)) {
+        bad = k + ' = ' + v;
+        break;
+      }
+    }
+    if (bad) break;
+  }
+  assert(bad === null, 'test2 hex format -- every hex matches /^#[0-9a-f]{6}$/i', bad);
+} catch (e) {
+  fail('test2 hex format', e.message);
+}
+
+// Test 3: check() exits valid against the live repo (or at least returns
+// a structured result with no stray hex from derived files that exist).
+try {
+  const result = checker.check();
+  // The check() may have violations if Task 2 hasn't wired consumers yet -- that
+  // is acceptable for Task 1 alone; we assert that the result is well-structured.
+  const ok1 = typeof result === 'object' && typeof result.valid === 'boolean' &&
+              Array.isArray(result.violations) && typeof result.canonical_count === 'number';
+  assert(ok1, 'test3 live-repo check -- check() returns structured result');
+  // Smoke test: canonical_count is at least 9 (the base tier alone has 9 keys).
+  assert(result.canonical_count >= 9, 'test3b live-repo check -- canonical_count >= 9');
+} catch (e) {
+  fail('test3 live-repo check', e.message);
+}
+
+// Test 4: Synthetic fixture with stray hex returns violations.length >= 1.
+try {
+  const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'palette-test-'));
+  const fakeFile = path.join(tmpDir, 'fake-consumer.css');
+  fs.writeFileSync(fakeFile, ':root { --not-canon: #abcdef; }');
+  // Build synthetic palette referencing this fake file via absolute path
+  // (relative-to-repo trick: place fixture under a known subpath).
+  // Instead use the in-process checker on a synthesized text directly.
+  const hexes = checker.hexesFromText(':root { --not-canon: #abcdef; --canon: #A63D2F; }');
+  const found1 = hexes.has('#abcdef');
+  const found2 = hexes.has('#a63d2f');
+  assert(found1 && found2, 'test4 fixture -- hexesFromText finds both canonical + non-canonical');
+  // Build a canonical set + check membership directly.
+  const canon = checker.collectCanonical(palette);
+  assert(canon.has('#a63d2f') && !canon.has('#abcdef'),
+    'test4b fixture -- canonical set contains shipped red, not the synthetic non-canon hex');
+  // Clean up tmp dir
+  try { fs.rmSync(tmpDir, { recursive: true, force: true }); } catch (_) {}
+} catch (e) {
+  fail('test4 fixture', e.message);
+}
+
+// Test 5: derived_files entries point to files (or skip gracefully).
+try {
+  const derived = palette.derived_files;
+  assert(Array.isArray(derived) && derived.length > 0,
+    'test5 derived_files -- non-empty array');
+  // At least one of the derived files must exist on disk.
+  const existCount = derived.filter(function(e) {
+    return fs.existsSync(path.join(REPO_ROOT, e.path));
+  }).length;
+  assert(existCount > 0,
+    'test5b derived_files -- at least one file exists on disk');
+} catch (e) {
+  fail('test5 derived_files', e.message);
+}
+
+// Summary
+console.log('');
+console.log('palette-consistency.test: ' + passed + ' passed, ' + failed + ' failed');
+if (failed > 0) process.exit(1);
+process.exit(0);

package/lib/memory/pending-tension-store.cjs

@@ -37,6 +37,29 @@ const crypto = require('node:crypto');
 // ---------- Constants ----------
 
 const PENDING_TENSIONS_DIR = path.join(os.homedir(), '.mindrian', 'pending-tensions');
+
+// Phase 121-02 D-05: tension_engagement emit support. Maps the local Phase 116
+// last_response vocabulary {RESOLVE, LATER, SKIP, DROPPED} -> the unified
+// telemetry user_response enum {resolve, defer, ignore}. DROPPED is system-
+// driven (3-strikes decay or explicit drop) and is intentionally excluded so
+// only user-initiated transitions ever land in the unified stream.
+const USER_RESPONSE_MAP = Object.freeze({
+  RESOLVE: 'resolve',
+  LATER: 'defer',
+  SKIP: 'ignore',
+});
+
+// Map Phase 116 tension_type vocabulary -> unified telemetry enum.
+//   contradiction   -> contradicts
+//   convergence     -> converges
+//   stale_decision  -> invalidates  (a stale decision invalidates its premise)
+//   open_question   -> invalidates  (an open question invalidates closure)
+const TENSION_TYPE_MAP = Object.freeze({
+  contradiction: 'contradicts',
+  convergence: 'converges',
+  stale_decision: 'invalidates',
+  open_question: 'invalidates',
+});
 const VALID_STATES = Object.freeze(new Set(['queued', 'surfaced', 'resolved', 'dropped']));
 const VALID_TYPES = Object.freeze(new Set([
   'contradiction',
@@ -220,6 +243,58 @@ function markSurfaced(roomSlug, tension_id) {
   return { ok: true, surfacing_count: next.surfacing_count };
 }
 
+/**
+ * Phase 121-02 D-05: capture user engagement with surfaced tensions into the
+ * unified ~/.mindrian/telemetry/v1.13/events-YYYY-WNN.jsonl stream (Plan 121-00
+ * writer chokepoint). Emit ONLY on user-initiated state transitions
+ * (RESOLVE -> resolve, LATER -> defer, SKIP -> ignore). Decayed tensions
+ * (system-driven 3-strikes via evaluateAndDecay or explicit markDropped) are
+ * NOT engagement events and intentionally do NOT emit.
+ *
+ * Non-blocking: try/catch wraps every step. A Canon Part 8 forbidden-pattern
+ * rejection in the writer never crashes the markResolved transition; the
+ * JSONL state append has already succeeded by the time we emit.
+ *
+ * TTR: time from last_surfaced_at -> now. Floor at 0; integer seconds.
+ * Context hash: 16-char sha256 of context_signature.focus_node_id (or empty).
+ */
+function emitTensionEngagementUnified(roomSlug, prev, response) {
+  try {
+    if (!USER_RESPONSE_MAP[response]) return; // system-driven; do not emit
+    let writer;
+    try {
+      writer = require('../core/telemetry/writer.cjs');
+    } catch (_e) {
+      return; // missing writer module; soft skip
+    }
+    if (!writer || typeof writer.emit !== 'function') return;
+    const tensionType = TENSION_TYPE_MAP[prev && prev.type] || 'invalidates';
+    const surfacedAt = (prev && Number.isFinite(prev.last_surfaced_at))
+      ? Number(prev.last_surfaced_at)
+      : 0;
+    const ttrSeconds = surfacedAt > 0
+      ? Math.max(0, Math.round((Date.now() - surfacedAt) / 1000))
+      : 0;
+    // Hash the focus node id (or any context_signature field) to a 16-char
+    // sha256 prefix; never the raw scalar.
+    let contextSrc = '';
+    if (prev && isPlainObject(prev.context_signature)) {
+      contextSrc = String(prev.context_signature.focus_node_id || prev.context_signature.context_id || '');
+    }
+    const contextHash = crypto.createHash('sha256').update(contextSrc).digest('hex').slice(0, 16);
+    const slugHash = crypto.createHash('sha256').update(String(roomSlug || '')).digest('hex');
+    writer.emit('tension_engagement', {
+      tension_type: String(tensionType).slice(0, 64),
+      user_response: USER_RESPONSE_MAP[response],
+      ttr_seconds: ttrSeconds,
+      room_slug_sha256: slugHash,
+      context_hash: contextHash,
+    });
+  } catch (_e) {
+    // Swallow: telemetry MUST never crash the tension transition.
+  }
+}
+
 /**
  * Mark a tension as resolved with a user response. State -> 'resolved'.
  *
@@ -239,6 +314,11 @@ function markResolved(roomSlug, tension_id, response) {
   });
   const r = appendTension(roomSlug, next);
   if (!r.ok) return r;
+  // Phase 121-02 D-05: emit only AFTER the JSONL state append succeeds. The
+  // emit is gated on USER_RESPONSE_MAP (RESOLVE/LATER/SKIP) so DROPPED falls
+  // through silently. This is the load-bearing exclusion: decayed tensions
+  // are system-driven and must not count as engagement.
+  emitTensionEngagementUnified(roomSlug, prev, response);
   return { ok: true };
 }
 

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);