npm - @mindrian_os/install - Versions diffs - 1.13.0-beta.16 → 1.13.0-beta.19 - Mend

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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (219) hide show

package/.claude-plugin/plugin.json +1 -1
package/CHANGELOG.md +36 -0
package/commands/act.md +1 -0
package/commands/admin.md +1 -0
package/commands/analyze-needs.md +2 -0
package/commands/analyze-systems.md +2 -0
package/commands/analyze-timing.md +2 -0
package/commands/auto-explore.md +2 -0
package/commands/beautiful-question.md +2 -0
package/commands/brain-derive.md +2 -0
package/commands/build-knowledge.md +2 -0
package/commands/build-thesis.md +2 -0
package/commands/causal.md +2 -0
package/commands/challenge-assumptions.md +2 -0
package/commands/compare-ventures.md +2 -0
package/commands/dashboard.md +2 -1
package/commands/deep-grade.md +2 -0
package/commands/diagnose.md +21 -1
package/commands/diagnostics.md +14 -3
package/commands/doctor.md +4 -1
package/commands/dogfood-flush.md +92 -0
package/commands/dominant-designs.md +2 -0
package/commands/explain-decision.md +2 -0
package/commands/explore-domains.md +2 -0
package/commands/explore-futures.md +2 -0
package/commands/explore-trends.md +2 -0
package/commands/export.md +1 -0
package/commands/feynman-timeline-refresh.md +2 -0
package/commands/file-meeting.md +4 -0
package/commands/find-analogies.md +1 -0
package/commands/find-bottlenecks.md +2 -0
package/commands/find-connections.md +2 -0
package/commands/funding.md +1 -0
package/commands/grade.md +4 -0
package/commands/graph.md +1 -0
package/commands/hat-briefing.md +1 -0
package/commands/heal.md +22 -170
package/commands/help.md +54 -334
package/commands/hmi-status.md +23 -144
package/commands/jtbd.md +1 -0
package/commands/leadership.md +2 -0
package/commands/lean-canvas.md +2 -0
package/commands/macro-trends.md +2 -0
package/commands/map-unknowns.md +2 -0
package/commands/memory.md +1 -0
package/commands/models.md +1 -0
package/commands/mos-reason.md +2 -0
package/commands/mos.md +139 -0
package/commands/mullins.md +2 -0
package/commands/mva-brief.md +58 -0
package/commands/mva-option.md +91 -0
package/commands/new-project.md +4 -0
package/commands/onboard.md +22 -7
package/commands/operator.md +1 -0
package/commands/opportunities.md +1 -0
package/commands/organize.md +22 -469
package/commands/persona.md +1 -0
package/commands/pipeline.md +2 -0
package/commands/present.md +1 -0
package/commands/publish.md +2 -0
package/commands/query.md +24 -102
package/commands/radar.md +2 -0
package/commands/reanalyze.md +1 -0
package/commands/research.md +2 -0
package/commands/room.md +2 -0
package/commands/rooms.md +1 -0
package/commands/root-cause.md +2 -0
package/commands/rs-experts.md +1 -0
package/commands/rs-explain.md +1 -0
package/commands/rs-fetch.md +1 -0
package/commands/rs-thesis.md +1 -0
package/commands/scenario-plan.md +2 -0
package/commands/scheduled-tasks.md +1 -0
package/commands/score-innovation.md +2 -0
package/commands/scout.md +1 -0
package/commands/setup.md +2 -0
package/commands/snapshot.md +2 -0
package/commands/speakers.md +1 -0
package/commands/splash.md +5 -2
package/commands/status.md +1 -0
package/commands/structure-argument.md +2 -0
package/commands/suggest-next.md +2 -0
package/commands/systems-thinking.md +2 -0
package/commands/think-hats.md +2 -0
package/commands/update.md +2 -0
package/commands/user-needs.md +2 -0
package/commands/validate.md +2 -0
package/commands/value-proposition.md +2 -0
package/commands/vault.md +2 -0
package/commands/visualize.md +24 -29
package/commands/whitespace.md +2 -1
package/commands/wiki.md +1 -0
package/hooks/hooks.json +31 -88
package/lib/agents/auto-explore-agent.cjs +82 -0
package/lib/agents/mva/brain-classic-traps.cjs +77 -0
package/lib/agents/mva/brain-cross-domain.cjs +79 -0
package/lib/agents/mva/brain-similar-ventures.cjs +93 -0
package/lib/agents/mva/dashboard-graph-neighborhood.cjs +72 -0
package/lib/agents/mva/index.cjs +42 -0
package/lib/agents/mva/six-hats-red-black.cjs +137 -0
package/lib/agents/mva/tavily-funding-scan.cjs +147 -0
package/lib/agents/mva/test-all-six-agents.cjs +467 -0
package/lib/conversation/operator.cjs +64 -0
package/lib/conversation/operator.test.cjs +160 -0
package/lib/core/breakthrough/canary.cjs +134 -0
package/lib/core/breakthrough/canary.test.cjs +136 -0
package/lib/core/breakthrough/detectors.cjs +359 -0
package/lib/core/breakthrough/detectors.test.cjs +333 -0
package/lib/core/breakthrough/ethics-fence.cjs +127 -0
package/lib/core/breakthrough/ethics-fence.test.cjs +178 -0
package/lib/core/breakthrough/resurfacing.cjs +150 -0
package/lib/core/breakthrough/resurfacing.test.cjs +233 -0
package/lib/core/breakthrough/review-queue.cjs +154 -0
package/lib/core/breakthrough/review-queue.test.cjs +160 -0
package/lib/core/breakthrough/scanner-d17-d18.test.cjs +229 -0
package/lib/core/breakthrough/scanner.cjs +426 -0
package/lib/core/breakthrough/scanner.test.cjs +267 -0
package/lib/core/breakthrough/schema.cjs +164 -0
package/lib/core/breakthrough/schema.test.cjs +256 -0
package/lib/core/breakthrough/scoring.cjs +293 -0
package/lib/core/breakthrough/scoring.test.cjs +423 -0
package/lib/core/breakthrough/verb-dispatch.cjs +221 -0
package/lib/core/breakthrough/verb-dispatch.test.cjs +185 -0
package/lib/core/breakthrough/voice-scaffold.cjs +247 -0
package/lib/core/breakthrough/voice-scaffold.test.cjs +251 -0
package/lib/core/first-touch-version-stamper.cjs +113 -0
package/lib/core/larry-thinness-acknowledgment.cjs +64 -0
package/lib/core/larry-thinness-acknowledgment.test.cjs +97 -0
package/lib/core/llm-name-suggester.cjs +194 -0
package/lib/core/llm-name-suggester.test.cjs +132 -0
package/lib/core/mva-agent-contract.cjs +170 -0
package/lib/core/mva-agent-contract.test.cjs +169 -0
package/lib/core/mva-budget.cjs +75 -0
package/lib/core/mva-budget.test.cjs +68 -0
package/lib/core/mva-classifier.cjs +370 -0
package/lib/core/mva-classifier.test.cjs +248 -0
package/lib/core/mva-deck-builder.cjs +452 -0
package/lib/core/mva-deck-builder.test.cjs +287 -0
package/lib/core/mva-detect.smoke.test.cjs +197 -0
package/lib/core/mva-dispatcher.cjs +110 -0
package/lib/core/mva-dispatcher.test.cjs +216 -0
package/lib/core/mva-option-router.cjs +292 -0
package/lib/core/mva-option-router.test.cjs +483 -0
package/lib/core/mva-orchestrator.cjs +365 -0
package/lib/core/mva-orchestrator.test.cjs +908 -0
package/lib/core/mva-progressive-renderer.cjs +194 -0
package/lib/core/mva-progressive-renderer.test.cjs +157 -0
package/lib/core/mva-rule-linter.cjs +213 -0
package/lib/core/mva-rule-linter.test.cjs +336 -0
package/lib/core/mva-state.cjs +159 -0
package/lib/core/mva-telemetry.cjs +58 -0
package/lib/core/mva-telemetry.test.cjs +196 -0
package/lib/core/mva-vercel-deploy.cjs +168 -0
package/lib/core/mva-vercel-deploy.test.cjs +239 -0
package/lib/core/navigation/dashboard-helpers.cjs +145 -0
package/lib/core/navigation/edges.cjs +35 -0
package/lib/core/navigation/memory-events.cjs +126 -0
package/lib/core/navigation.cjs +11 -0
package/lib/core/resolve-vercel-key.cjs +107 -0
package/lib/core/resolve-vercel-key.test.cjs +137 -0
package/lib/core/room-auto-create.cjs +318 -0
package/lib/core/room-auto-create.test.cjs +198 -0
package/lib/core/room-discard-cascade.cjs +225 -0
package/lib/core/room-discard-cascade.test.cjs +135 -0
package/lib/core/room-name-validator.cjs +132 -0
package/lib/core/room-name-validator.test.cjs +156 -0
package/lib/core/room-naming-selector.cjs +357 -0
package/lib/core/room-naming-selector.test.cjs +277 -0
package/lib/core/room-receipt-emit.cjs +63 -0
package/lib/core/room-skeleton-scaffold.cjs +315 -0
package/lib/core/room-skeleton-scaffold.test.cjs +291 -0
package/lib/core/stale-copy-scanner.cjs +190 -0
package/lib/core/state-aware-router.cjs +78 -0
package/lib/core/telemetry/schema.cjs +168 -0
package/lib/core/telemetry/schema.test.cjs +124 -0
package/lib/core/telemetry/validator.cjs +197 -0
package/lib/core/telemetry/validator.test.cjs +188 -0
package/lib/core/telemetry/writer.cjs +141 -0
package/lib/core/telemetry/writer.test.cjs +331 -0
package/lib/core/terminal-capability.cjs +88 -0
package/lib/core/venture-shape-nudge.cjs +163 -0
package/lib/core/venture-shape-nudge.test.cjs +161 -0
package/lib/core/visual-ops.cjs +70 -2
package/lib/hmi/selector-dispatcher.cjs +90 -1
package/lib/hmi/shape-f7-breakthrough-renderer.cjs +222 -0
package/lib/hmi/shape-f7-breakthrough-renderer.test.cjs +233 -0
package/lib/memory/body-shape-coverage.test.cjs +268 -0
package/lib/memory/doctor-deprecation-surface.test.cjs +185 -0
package/lib/memory/first-touch-version.test.cjs +198 -0
package/lib/memory/help-coverage.test.cjs +108 -0
package/lib/memory/help-renderer.test.cjs +145 -0
package/lib/memory/palette-consistency.test.cjs +127 -0
package/lib/memory/pending-tension-store.cjs +80 -0
package/lib/memory/render-v2-disposition.test.cjs +199 -0
package/lib/memory/run-feynman-tests.cjs +240 -0
package/lib/memory/sessionstart-coordinator.test.cjs +446 -0
package/lib/memory/skill-vs-code-drift.test.cjs +257 -0
package/lib/memory/soft-alias.test.cjs +144 -0
package/lib/memory/stale-copy-scanner.test.cjs +291 -0
package/lib/memory/state-aware-router.test.cjs +90 -0
package/lib/memory/statusline-two-row.test.cjs +338 -0
package/lib/memory/terminal-capability.test.cjs +155 -0
package/lib/render/ROOM.md +74 -22
package/lib/sessionstart/budget-compressor.cjs +130 -0
package/lib/sessionstart/contributor-interface.cjs +134 -0
package/lib/sessionstart/contributor-isolator.cjs +128 -0
package/lib/sessionstart/precedence-ladder.cjs +47 -0
package/lib/statusline/governing-thought-truncator.cjs +45 -0
package/lib/statusline/two-row-renderer.cjs +186 -0
package/lib/statusline/version-resolver.cjs +81 -0
package/package.json +1 -1
package/references/visual/ROOM.md +55 -0
package/references/visual/palette.json +54 -0
package/skills/larry-personality/SKILL.md +34 -0
package/skills/mva-pipeline/SKILL.md +129 -0
package/skills/ui-system/SKILL.md +109 -1
package/skills/ui-system/rules/dual-palette.md +156 -0
package/skills/ui-system/rules/glyph-disambiguation.md +171 -0
package/skills/ui-system/rules/shape-f-zero-and-six.md +169 -0

package/lib/core/mva-deck-builder.test.cjs ADDED Viewed

@@ -0,0 +1,287 @@
+/*
+ * Copyright (c) 2026 Mindrian. BSL 1.1.
+ *
+ * Phase 118-04 Plan 04 Task 2 -- mva-deck-builder tests.
+ *
+ * The deck builder is a pure function that takes an OrchestratorOutcome
+ * (from Plan 118-03) and returns a full HTML document. De Stijl theme,
+ * INLINE styles only (no <style> blocks), Mondrian palette, em-dash-free.
+ *
+ * Canon Part 8 invariants:
+ *   - The deck contains the RENDERED summary_lines + structured deck_data
+ *     (already sanitized by Plan 118-02 agents).
+ *   - The raw sentence is NEVER serialized into the HTML.
+ *   - The sentence sha256 hash IS rendered (as a hash marker, not a leak).
+ *
+ * Em-dash discipline (per feedback_no_emdashes.md): every emitted string
+ * uses `--` and `-` ONLY. The 3-option footer uses `--` not `—`.
+ *
+ * No real-name discipline (per feedback_no_real_names_in_repo.md): the
+ * template MUST NOT mention testers/advisors/partners.
+ *
+ * Per OQ13 lean: deck includes "Generated by MindrianOS" footer with link to
+ * the install minisite.
+ *
+ * Per OQ15 lean: deck shows static 3-option text + copy-to-clipboard button
+ * for the brief sha8.
+ *
+ * NIT-3 palette parity: DECK_PALETTE must match the De Stijl source-of-truth
+ * (lib/wiki/wiki-layout.cjs CSS variables; lib/core/visual-ops.cjs DS_HEX).
+ */
+'use strict';
+const test = require('node:test');
+const assert = require('node:assert/strict');
+const fs = require('node:fs');
+const path = require('node:path');
+const { buildDeck, buildSlide, DECK_PALETTE } = require('./mva-deck-builder.cjs');
+// ---------- Synthetic OrchestratorOutcome factories ----------
+function _agentOk(agent_id, summary_line, extra) {
+  return {
+    agent_id,
+    status: 'ok',
+    duration_ms: 100,
+    payload: Object.assign({ summary_line }, extra || {}),
+  };
+}
+function _agentEmpty(agent_id, reason) {
+  return {
+    agent_id,
+    status: 'empty',
+    duration_ms: 10,
+    payload: { reason: reason || 'no_findings' },
+  };
+}
+function _agentError(agent_id) {
+  return {
+    agent_id,
+    status: 'error',
+    duration_ms: 10,
+    error: 'mock_error',
+    payload: null,
+  };
+}
+function _sixOkOutcome() {
+  const sha = '0'.repeat(64);
+  return {
+    results: [
+      _agentOk('brain_similar',       'Found 3 ventures in this space: A, B, C',
+               { deck_data: { ventures: [{ name: 'A', stage: 'seed' }, { name: 'B', stage: 'pre-seed' }] } }),
+      _agentOk('brain_cross_domain',  'Cross-domain analogy: ConstraintTheory -- bottleneck pattern',
+               { deck_data: { framework: 'ConstraintTheory', signature: 'bottleneck pattern' } }),
+      _agentOk('brain_classic_traps', 'Classic trap: PrematureScale -- raised before PMF',
+               { deck_data: { trap: 'PrematureScale', signature: 'raised before PMF' } }),
+      _agentOk('tavily_funding',      'Live funding match: NSF SBIR Phase I -- deadline 2026-06-15',
+               { deck_data: { title: 'NSF SBIR Phase I', deadline: '2026-06-15' } }),
+      _agentOk('six_hats_red_black',  "One question you haven't asked yourself: What if no one cares?",
+               { deck_data: { question: 'What if no one cares?' } }),
+      _agentOk('dashboard_graph',     'Your room already has 5 related decision nodes. Quick preview:',
+               { deck_data: { node_count: 5, nodes: ['Idea-2026-03', 'Pivot-2026-04'] } }),
+    ],
+    rendered: '(stub terminal output)',
+    footer_data: { ok: 6, failed: 0, sha256: sha },
+  };
+}
+// ---------- Tests ----------
+test('Test 1: 6 agents ok -> 6 slides + header + footer; valid HTML', () => {
+  const outcome = _sixOkOutcome();
+  const html = buildDeck(outcome);
+  assert.ok(html.startsWith('<!DOCTYPE html>'), 'must start with DOCTYPE');
+  assert.ok(html.endsWith('</html>\n') || html.endsWith('</html>'),
+    'must end with </html>');
+  // 6 slide articles
+  const slideCount = (html.match(/<article\b/g) || []).length;
+  assert.equal(slideCount, 6, 'expected 6 slides, got ' + slideCount);
+  assert.ok(html.length > 2000, 'deck should be substantive (>2000 chars), got ' + html.length);
+});
+test('Test 2: em-dash sweep -- zero — characters in output', () => {
+  const outcome = _sixOkOutcome();
+  const html = buildDeck(outcome);
+  const matches = html.match(/—/g);
+  assert.equal(matches, null, 'no em-dashes (—) allowed; found ' + (matches && matches.length));
+  // Verify `--` IS present in 3-option footer
+  assert.ok(html.includes("Challenge me -- Devil"), 'footer must contain "Challenge me -- Devil"');
+});
+test('Test 3: no <style> blocks anywhere in output', () => {
+  const outcome = _sixOkOutcome();
+  const html = buildDeck(outcome);
+  assert.equal(/<style[^>]*>/.test(html), false,
+    'no <style> blocks allowed; inline styles only');
+});
+test('Test 4: inline styles present (>= 10 style="" attributes)', () => {
+  const outcome = _sixOkOutcome();
+  const html = buildDeck(outcome);
+  const inlineMatches = html.match(/style="[^"]+"/g) || [];
+  assert.ok(inlineMatches.length >= 10,
+    'expected >= 10 inline style attributes, got ' + inlineMatches.length);
+});
+test('Test 5: Mondrian/De Stijl palette present (>= 3 of canonical hexes)', () => {
+  const outcome = _sixOkOutcome();
+  const html = buildDeck(outcome);
+  const palette = Object.values(DECK_PALETTE);
+  let hits = 0;
+  for (const hex of palette) {
+    if (html.toUpperCase().includes(hex.toUpperCase())) hits += 1;
+  }
+  assert.ok(hits >= 3, 'expected >= 3 palette hexes in HTML, got ' + hits);
+});
+test('Test 6: 3 empty agents render placeholder slides', () => {
+  const sha = 'a'.repeat(64);
+  const outcome = {
+    results: [
+      _agentOk('brain_similar', 'A B C'),
+      _agentEmpty('brain_cross_domain'),
+      _agentEmpty('brain_classic_traps'),
+      _agentEmpty('tavily_funding', 'tavily_unavailable'),
+      _agentOk('six_hats_red_black', "What if no one cares?"),
+      _agentOk('dashboard_graph', 'Your room has 2 nodes.'),
+    ],
+    rendered: '',
+    footer_data: { ok: 3, failed: 3, sha256: sha },
+  };
+  const html = buildDeck(outcome);
+  const slideCount = (html.match(/<article\b/g) || []).length;
+  assert.equal(slideCount, 6, '6 slides total (3 ok + 3 empty placeholders)');
+  // Placeholder phrase appears (matches renderer empty-state strings)
+  assert.ok(html.includes('no findings this pass') || html.includes('Live funding scan'),
+    'empty agents should render placeholder text');
+});
+test('Test 7: all-fail -> single sharp-question slide', () => {
+  const sha = 'b'.repeat(64);
+  const outcome = {
+    results: [
+      _agentError('brain_similar'),
+      _agentError('brain_cross_domain'),
+      _agentError('brain_classic_traps'),
+      _agentError('tavily_funding'),
+      _agentError('six_hats_red_black'),
+      _agentError('dashboard_graph'),
+    ],
+    rendered: '',
+    footer_data: { ok: 0, failed: 6, sha256: sha },
+  };
+  const html = buildDeck(outcome);
+  // Exactly one slide article on all-fail
+  const slideCount = (html.match(/<article\b/g) || []).length;
+  assert.equal(slideCount, 1, 'all-fail should render exactly 1 slide');
+  // Verbatim sharp-question source-spec text (em-dash-free)
+  assert.ok(html.includes("didn't find precedents for this in 30 seconds"),
+    'sharp-question text must appear');
+  assert.ok(html.includes('genuinely unexplored space'),
+    'sharp-question second line must appear');
+});
+test('Test 8: raw-sentence absent -- only sha8 marker appears, no "sentence"/"prompt"/"user_input" fields', () => {
+  const outcome = _sixOkOutcome();
+  const html = buildDeck(outcome);
+  // sha8 (first 8 chars of sha256) IS rendered as identifier
+  assert.ok(html.includes(outcome.footer_data.sha256.slice(0, 8)),
+    'sha8 should appear as the brief identifier');
+  // But raw "sentence" / "prompt" / "user_input" field labels do NOT appear
+  // (We check for the field-label patterns, not arbitrary occurrences of "sentence")
+  assert.equal(/raw_sentence|MVA_SENTENCE|user_input|user_prompt/i.test(html), false,
+    'no raw sentence field labels should appear in HTML');
+});
+test('Test 9: footer includes "Generated by MindrianOS" attribution + install-site link', () => {
+  const outcome = _sixOkOutcome();
+  const html = buildDeck(outcome);
+  assert.ok(html.includes('Generated by MindrianOS'),
+    'footer must include "Generated by MindrianOS" attribution');
+  assert.ok(html.includes('mindrianos-install-site.vercel.app'),
+    'footer must link to install minisite');
+  assert.ok(html.includes(outcome.footer_data.sha256.slice(0, 8)),
+    'footer must include sha8 marker');
+});
+test('Test 10: 3-option footer text + copy-to-clipboard button for /mos:new-project --from-brief <sha8>', () => {
+  const outcome = _sixOkOutcome();
+  const html = buildDeck(outcome);
+  // 3-option verbatim text (em-dash-free)
+  assert.ok(html.includes('What now?'), 'must include "What now?" prompt');
+  assert.ok(html.includes("Just tell me what's new") || html.includes('Just tell me what&#39;s new'),
+    'option 1 text');
+  assert.ok(html.includes('Build a room around this'), 'option 2 text');
+  assert.ok(html.includes("Devil's Advocate") || html.includes('Devil&#39;s Advocate'),
+    "option 3 text contains Devil's Advocate");
+  // Copy-to-clipboard hint
+  const sha8 = outcome.footer_data.sha256.slice(0, 8);
+  assert.ok(html.includes('/mos:new-project --from-brief ' + sha8),
+    'copy hint must include /mos:new-project --from-brief <sha8>');
+});
+test('Test 11: data/mva-deck-template.html exists + has placeholder tokens', () => {
+  const tmplPath = path.join(__dirname, '..', '..', 'data', 'mva-deck-template.html');
+  assert.ok(fs.existsSync(tmplPath), 'template must exist at ' + tmplPath);
+  const tmpl = fs.readFileSync(tmplPath, 'utf8');
+  assert.ok(tmpl.includes('{{HEADER}}'), 'template must have {{HEADER}}');
+  assert.ok(tmpl.includes('{{SLIDES}}'), 'template must have {{SLIDES}}');
+  assert.ok(tmpl.includes('{{FOOTER}}'), 'template must have {{FOOTER}}');
+});
+test('Test 12: NIT-3 palette parity with lib/wiki/wiki-layout.cjs', () => {
+  const wikiPath = path.join(__dirname, '..', '..', 'lib', 'wiki', 'wiki-layout.cjs');
+  if (!fs.existsSync(wikiPath)) {
+    // Documented skip per plan-checker iter 2 NIT-3
+    console.log('  (skipped: lib/wiki/wiki-layout.cjs absent; palette is freshly defined for the MVA deck)');
+    return;
+  }
+  const wikiSource = fs.readFileSync(wikiPath, 'utf8');
+  const divergent = [];
+  for (const [name, hex] of Object.entries(DECK_PALETTE)) {
+    const hexUpper = hex.toUpperCase();
+    const wikiHasSameHex = wikiSource.toUpperCase().includes(hexUpper);
+    if (!wikiHasSameHex) {
+      const wikiMentionsColor = new RegExp('\\b' + name + '\\b', 'i').test(wikiSource);
+      if (wikiMentionsColor) {
+        const otherHexes = (wikiSource.match(/#[0-9A-Fa-f]{6}/g) || []).map(h => h.toUpperCase());
+        // Only flag if wiki has hex literals AND wiki names this color
+        if (otherHexes.length > 0) {
+          divergent.push(
+            name + ': deck=' + hex + ', wiki references "' + name + '" but uses different hex(es): ' +
+            otherHexes.slice(0, 3).join(', ')
+          );
+        }
+      }
+    }
+  }
+  assert.equal(divergent.length, 0,
+    'Palette divergence detected vs lib/wiki/wiki-layout.cjs:\n  ' + divergent.join('\n  ') +
+    '\nReconcile DECK_PALETTE with wiki-layout.cjs or document the divergence in the SUMMARY.');
+});
+test('Test 13: Canon Part 8 source grep -- builder source has no raw-sentence references', () => {
+  const code = fs.readFileSync(path.join(__dirname, 'mva-deck-builder.cjs'), 'utf8');
+  // Strip comments
+  const stripped = code.replace(/\/\*[\s\S]*?\*\//g, '').replace(/\/\/.*$/gm, '');
+  assert.equal(stripped.match(/MVA_SENTENCE/), null, 'no MVA_SENTENCE in builder source');
+  assert.equal(stripped.match(/process\.env\.CLAUDE_USER_PROMPT/), null,
+    'no process.env.CLAUDE_USER_PROMPT in builder source');
+  // Template-level forbidden tokens + real-name discipline
+  const tmplPath = path.join(__dirname, '..', '..', 'data', 'mva-deck-template.html');
+  const template = fs.readFileSync(tmplPath, 'utf8');
+  assert.equal(template.match(/MVA_SENTENCE/), null, 'no MVA_SENTENCE in template');
+  // feedback_no_real_names_in_repo.md: no biographical tester/advisor names in deck template
+  assert.equal(template.match(/Lawrence|Gary|Natan|Aronhime|Reuven|Schler/), null,
+    'no real names in template (per feedback_no_real_names_in_repo.md)');
+});
+test('Test 14: buildSlide is exported and produces an <article>', () => {
+  const slideHtml = buildSlide(_agentOk('brain_similar', 'Found 3 ventures: A, B, C'));
+  assert.ok(slideHtml.includes('<article'), 'slide must be wrapped in <article>');
+  assert.ok(slideHtml.includes('A, B, C'), 'slide must contain the summary line');
+});

package/lib/core/mva-detect.smoke.test.cjs ADDED Viewed

@@ -0,0 +1,197 @@
+'use strict';
+/*
+ * Phase 118-00 Plan 00 -- mva-detect.cjs smoke test (Task 2 verification).
+ *
+ * Spawns `node scripts/mva-detect.cjs` as a child with stdin JSON payload
+ * and asserts:
+ *   - exit code 0
+ *   - completes in < 1500ms (the hook budget)
+ *   - state file ~/.mindrian/mva/<session-id>.json written for venture prompt
+ *   - state file contains hebrew_refusal:true for Hebrew prompt
+ *   - state file UNWRITTEN for non-venture prompt
+ *   - telemetry jsonl gains one event per run
+ *
+ * Tests use a tmpdir HOME so the real ~/.mindrian is never touched.
+ *
+ * Pure CJS, node built-ins only.
+ */
+const assert = require('node:assert/strict');
+const fs = require('node:fs');
+const os = require('node:os');
+const path = require('node:path');
+const { spawnSync } = require('node:child_process');
+const HOOK = path.resolve(__dirname, '..', '..', 'scripts', 'mva-detect.cjs');
+let passed = 0;
+let failed = 0;
+function run(name, fn) {
+  try {
+    fn();
+    process.stdout.write('ok  ' + name + '\n');
+    passed += 1;
+  } catch (err) {
+    process.stderr.write('FAIL ' + name + '\n' + (err && err.stack ? err.stack : String(err)) + '\n');
+    failed += 1;
+  }
+}
+function withTmpHome(fn) {
+  const tmpHome = fs.mkdtempSync(path.join(os.tmpdir(), 'mva-smoke-'));
+  const prevHome = process.env.HOME;
+  process.env.HOME = tmpHome;
+  try {
+    return fn(tmpHome);
+  } finally {
+    process.env.HOME = prevHome;
+    try { fs.rmSync(tmpHome, { recursive: true, force: true }); } catch (_e) {}
+  }
+}
+function spawnHook(stdinStr, env) {
+  const t0 = Date.now();
+  const res = spawnSync(process.execPath, [HOOK], {
+    input: stdinStr,
+    encoding: 'utf8',
+    env: Object.assign({}, process.env, env || {}),
+    timeout: 3000,
+  });
+  return { res, elapsed: Date.now() - t0 };
+}
+// ---------- S1 venture sentence -> state file written; exit 0; under budget ----------
+run('S1 venture sentence -> state file written + telemetry + sub-1500ms', () => {
+  withTmpHome((tmpHome) => {
+    const sessionId = 'smoke-session-S1';
+    const { res, elapsed } = spawnHook(
+      JSON.stringify({ prompt: 'I have an idea for a couples finance app' }),
+      { HOME: tmpHome, CLAUDE_SESSION_ID: sessionId, ANTHROPIC_API_KEY: '' }
+    );
+    assert.equal(res.status, 0, 'hook must exit 0; stderr=' + (res.stderr || ''));
+    assert.ok(elapsed < 1500, 'hook must complete under 1500ms; got ' + elapsed + 'ms');
+    const stateFile = path.join(tmpHome, '.mindrian', 'mva', sessionId + '.json');
+    assert.ok(fs.existsSync(stateFile), 'state file must exist at ' + stateFile);
+    const body = JSON.parse(fs.readFileSync(stateFile, 'utf8'));
+    assert.ok(body.sentence_sha256 && body.sentence_sha256.length === 64,
+      'state must carry sentence_sha256 (64 hex chars); got ' + body.sentence_sha256);
+    assert.equal(body.locale, 'en');
+    assert.equal(body.pipeline_status, 'pending');
+    assert.ok(body.classifier_source === 'heuristic' || body.classifier_source === 'heuristic_fallback',
+      'classifier_source must be heuristic/heuristic_fallback; got ' + body.classifier_source);
+    // Raw sentence must NOT appear in state file
+    const rawState = fs.readFileSync(stateFile, 'utf8');
+    assert.equal(rawState.indexOf('couples finance app'), -1,
+      'state file must NEVER contain raw prompt text');
+    // Telemetry
+    const tFile = path.join(tmpHome, '.mindrian', 'telemetry', 'v1.13', 'mva.jsonl');
+    assert.ok(fs.existsSync(tFile), 'telemetry file must exist at ' + tFile);
+    const lines = fs.readFileSync(tFile, 'utf8').trim().split('\n').filter(Boolean);
+    assert.equal(lines.length, 1, 'expected exactly 1 telemetry line; got ' + lines.length);
+    const ev = JSON.parse(lines[0]);
+    assert.equal(ev.event, 'mva_classified');
+    assert.equal(ev.venture, true);
+    assert.equal(ev.sha256_of_sentence, body.sentence_sha256);
+    assert.equal(typeof ev.classified_in_ms, 'number');
+    // Telemetry must NOT contain raw prompt
+    assert.equal(lines[0].indexOf('couples finance app'), -1,
+      'telemetry must NEVER contain raw prompt text');
+  });
+});
+// ---------- S2 non-venture sentence -> NO state file; exit 0 ----------
+run('S2 non-venture sentence -> no state file; exit 0', () => {
+  withTmpHome((tmpHome) => {
+    const sessionId = 'smoke-session-S2';
+    const { res } = spawnHook(
+      JSON.stringify({ prompt: 'fix the failing test in foo.test.js' }),
+      { HOME: tmpHome, CLAUDE_SESSION_ID: sessionId, ANTHROPIC_API_KEY: '' }
+    );
+    assert.equal(res.status, 0);
+    const stateFile = path.join(tmpHome, '.mindrian', 'mva', sessionId + '.json');
+    assert.equal(fs.existsSync(stateFile), false,
+      'state file must NOT exist for non-venture prompt; found ' + stateFile);
+    // Telemetry MUST still be appended (we record classification outcomes for analysis)
+    const tFile = path.join(tmpHome, '.mindrian', 'telemetry', 'v1.13', 'mva.jsonl');
+    assert.ok(fs.existsSync(tFile));
+    const ev = JSON.parse(fs.readFileSync(tFile, 'utf8').trim().split('\n')[0]);
+    assert.equal(ev.venture, false);
+  });
+});
+// ---------- S3 Hebrew sentence -> hebrew_refusal state; exit 0 ----------
+run('S3 Hebrew sentence -> hebrew_refusal:true in state; exit 0 (LD1)', () => {
+  withTmpHome((tmpHome) => {
+    const sessionId = 'smoke-session-S3';
+    const { res } = spawnHook(
+      JSON.stringify({ prompt: 'יש לי רעיון לאפליקציה לזוגות מתחתנים' }),
+      { HOME: tmpHome, CLAUDE_SESSION_ID: sessionId, ANTHROPIC_API_KEY: '' }
+    );
+    assert.equal(res.status, 0);
+    const stateFile = path.join(tmpHome, '.mindrian', 'mva', sessionId + '.json');
+    assert.ok(fs.existsSync(stateFile), 'Hebrew refusal must still write a state file');
+    const body = JSON.parse(fs.readFileSync(stateFile, 'utf8'));
+    assert.equal(body.hebrew_refusal, true);
+    assert.equal(body.locale, 'he');
+    assert.equal(body.classifier_source, 'language_detect');
+    // Raw Hebrew sentence must NOT appear in state file
+    const rawState = fs.readFileSync(stateFile, 'utf8');
+    assert.equal(rawState.indexOf('יש לי רעיון'), -1,
+      'state file must NEVER contain raw Hebrew prompt text');
+  });
+});
+// ---------- S4 no stdin payload -> exit 0 silently ----------
+run('S4 empty stdin -> exit 0 silently', () => {
+  withTmpHome((tmpHome) => {
+    const sessionId = 'smoke-session-S4';
+    const { res } = spawnHook('', { HOME: tmpHome, CLAUDE_SESSION_ID: sessionId });
+    assert.equal(res.status, 0);
+    const stateFile = path.join(tmpHome, '.mindrian', 'mva', sessionId + '.json');
+    assert.equal(fs.existsSync(stateFile), false);
+  });
+});
+// ---------- S5 malformed JSON -> exit 0 silently ----------
+run('S5 malformed stdin JSON -> exit 0 silently; no state mutation', () => {
+  withTmpHome((tmpHome) => {
+    const sessionId = 'smoke-session-S5';
+    const { res } = spawnHook('not-json-at-all', { HOME: tmpHome, CLAUDE_SESSION_ID: sessionId });
+    assert.equal(res.status, 0);
+    const stateFile = path.join(tmpHome, '.mindrian', 'mva', sessionId + '.json');
+    assert.equal(fs.existsSync(stateFile), false);
+  });
+});
+// ---------- S6 Canon Part 8 source-grep sweep ----------
+run('S6 Canon Part 8 sweep: no Brain MCP / brain-client refs in hook + classifier + state', () => {
+  const files = [
+    path.resolve(__dirname, '..', '..', 'scripts', 'mva-detect.cjs'),
+    path.resolve(__dirname, 'mva-classifier.cjs'),
+    path.resolve(__dirname, 'mva-state.cjs'),
+  ];
+  const forbidden = [
+    /require\(['"][^'"]*brain-client['"]\)/,
+    /mcp__brain_/,
+    /brain_query/,
+    /brain_search/,
+  ];
+  for (const f of files) {
+    const src = fs.readFileSync(f, 'utf8');
+    for (const re of forbidden) {
+      assert.ok(!re.test(src),
+        'Canon Part 8 forbidden token ' + re + ' found in ' + path.basename(f));
+    }
+  }
+});
+// ---------- Summary ----------
+process.stderr.write('\n' + passed + ' passed, ' + failed + ' failed\n');
+process.exit(failed === 0 ? 0 : 1);

package/lib/core/mva-dispatcher.cjs ADDED Viewed

@@ -0,0 +1,110 @@
+/*
+ * Copyright (c) 2026 Mindrian. BSL 1.1.
+ *
+ * Phase 118-01 Plan 01 Task 3 -- mva-dispatcher.
+ *
+ * The parallel fan-out primitive used by Plan 118-03 (progressive streaming)
+ * and Plan 118-04 (deck generation). Plan 118-02 supplies the 6 specific
+ * agents (brain_similar, brain_cross_domain, brain_classic_traps,
+ * tavily_funding, six_hats_red_black, dashboard_graph); this module knows
+ * NOTHING about which agents are which -- it accepts any { id, fn } tuple
+ * conforming to the Agent contract in lib/core/mva-agent-contract.cjs.
+ *
+ * Per binding decision B2 (HARD):
+ *   - 45-second global wall-clock budget
+ *   - 35-second per-agent budget
+ *   - Per-agent abort signal feeds from global deadline:
+ *       perAgentTimeout = min(35000, remainingGlobalMs)
+ *
+ * Per binding decision B7:
+ *   - Per-agent failure (throw, timeout, empty) does NOT abort sibling agents
+ *   - All-fail does NOT throw; it returns N error/timeout results so the
+ *     caller (Plan 118-03) can render the sharp-question fallback
+ *
+ * Streaming-as-settled pattern: results yield in arrival order. Fast agents
+ * yield before slow agents finish. Implemented via a settlement queue with
+ * a deferred-resolve "ready" promise.
+ *
+ * Canon Part 8 hard invariants (zero user-content egress):
+ *   - The dispatcher passes ONLY sentence_sha256 to agents (NOT the raw sentence)
+ *   - process.env.MVA_SENTENCE is NEVER read or written by this module
+ *   - No stdout / stderr writes (telemetry side-channel rule)
+ *   - No Brain MCP client require (agents own their own I/O)
+ *
+ * Pure CJS, node built-ins only, zero new runtime dependencies.
+ */
+'use strict';
+const { runAgent } = require('./mva-agent-contract.cjs');
+const { createBudget } = require('./mva-budget.cjs');
+/**
+ * dispatch -- parallel fan-out over agents, yielding each AgentResult as it
+ * settles (streaming-as-settled). Compatible with `for await (...)` consumers.
+ *
+ * @param {Array<{ id: string, fn: Function }>} agents - 6 agents from Plan 118-02
+ * @param {string} sentence_sha256 - the ONLY sentence-derived identifier
+ * @param {{ globalBudgetMs?: number, perAgentCapMs?: number }} [opts]
+ * @returns {AsyncGenerator<{ agent_id: string, status: string, duration_ms: number, payload?: any, error?: string }>}
+ */
+async function* dispatch(agents, sentence_sha256, opts) {
+  const options = opts || {};
+  const budget = createBudget(options.globalBudgetMs);
+  const perAgentCap = (typeof options.perAgentCapMs === 'number') ? options.perAgentCapMs : undefined;
+  // Settlement queue. Each entry is a promise that resolves with an AgentResult.
+  // We use a deferred "ready" notification so the async generator can yield
+  // results in arrival order without busy-waiting.
+  const queue = [];
+  let pendingCount = agents.length;
+  let notify;
+  let ready = new Promise((r) => { notify = r; });
+  // Kick off every agent in parallel. Each agent runs under its own per-agent
+  // budget = min(perAgentCap, budget.remainingMs()) computed at start.
+  for (const agent of agents) {
+    const timeoutMs = budget.perAgentMs(perAgentCap);
+    const context = { sentence_sha256: sentence_sha256 };
+    // Fire-and-forget; result lands in the queue. runAgent never throws.
+    runAgent(agent, context, { timeoutMs }).then((result) => {
+      queue.push(result);
+      const fire = notify;
+      ready = new Promise((r) => { notify = r; });
+      fire();
+    });
+  }
+  while (pendingCount > 0) {
+    if (queue.length === 0) {
+      await ready;
+    }
+    while (queue.length > 0) {
+      pendingCount -= 1;
+      yield queue.shift();
+    }
+  }
+}
+/**
+ * dispatchToArray -- convenience wrapper that collects the AsyncIterable into
+ * a Promise<Array>. Plan 118-04 (deck generator) uses this; Plan 118-03
+ * (progressive streaming) uses the streaming dispatch directly.
+ *
+ * @param {Array<{ id: string, fn: Function }>} agents
+ * @param {string} sentence_sha256
+ * @param {{ globalBudgetMs?: number, perAgentCapMs?: number }} [opts]
+ * @returns {Promise<Array<{ agent_id: string, status: string, duration_ms: number, payload?: any, error?: string }>>}
+ */
+async function dispatchToArray(agents, sentence_sha256, opts) {
+  const results = [];
+  for await (const r of dispatch(agents, sentence_sha256, opts)) {
+    results.push(r);
+  }
+  return results;
+}
+module.exports = {
+  dispatch,
+  dispatchToArray
+};