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

package/lib/core/mva-deck-builder.cjs

@@ -0,0 +1,452 @@
+/*
+ * Copyright (c) 2026 Mindrian. BSL 1.1.
+ *
+ * Phase 118-04 Plan 04 Task 2 -- mva-deck-builder.
+ *
+ * Pure function: buildDeck(orchestratorOutcome) -> string (full HTML document).
+ *
+ * De Stijl theme, INLINE styles ONLY (no <style> blocks anywhere). Mondrian
+ * palette mirrored from the shipped De Stijl source-of-truth (lib/wiki/
+ * wiki-layout.cjs CSS vars + lib/core/visual-ops.cjs DS_HEX). System fonts
+ * (Impact, Helvetica, Courier). 5-7 slides depending on agent return count.
+ *
+ * Canon Part 8 invariants:
+ *   - Deck contains the rendered summary_lines + structured deck_data
+ *     (already sanitized by Plan 118-02 agents).
+ *   - Raw sentence is NEVER serialized; only the sha8 marker appears.
+ *   - No raw error strings (Plan 118-02 agents already redact).
+ *
+ * Em-dash discipline (per feedback_no_emdashes.md): all emitted text uses
+ * `--` and `-`. The 3-option footer uses `--` not `—`. Verified by Test 2.
+ *
+ * No real-names discipline (per feedback_no_real_names_in_repo.md): the
+ * template + builder never spell tester/advisor/partner names. Verified by
+ * Test 13.
+ *
+ * Per OQ13 lean: footer attributes "Generated by MindrianOS" with link to
+ * the install minisite.
+ *
+ * Per OQ15 lean: footer shows the 3-option static text + a copy hint for
+ * /mos:new-project --from-brief <sha8>. Real routing happens in the terminal
+ * (Plan 118-05), not in the deployed HTML.
+ *
+ * NIT-3 palette parity: DECK_PALETTE matches wiki-layout.cjs CSS variables
+ * and visual-ops.cjs DS_HEX values to maintain product coherence between the
+ * MVA deck and the existing De Stijl wiki surface.
+ *
+ * Pure CJS. fs.readFileSync at module load only (for the template). No I/O
+ * elsewhere.
+ */
+'use strict';
+
+const fs = require('node:fs');
+const path = require('node:path');
+
+// ---------- Module-level constants ----------
+
+/**
+ * DECK_PALETTE -- frozen De Stijl Mondrian colors.
+ *
+ * Mirrors the shipped source-of-truth:
+ *   - lib/core/visual-ops.cjs::DS_HEX (used by Mermaid diagrams)
+ *   - lib/wiki/wiki-layout.cjs CSS variables (--ds-red, --ds-blue, etc.)
+ *
+ * NOTE on palette divergence: the plan's <interfaces> section documented an
+ * aspirational classic-Mondrian palette (#E0162B/#F8D43E/#0F52BA/#7A4FA0).
+ * Canon Part 7 (Reuse Before Build) + the NIT-3 palette-parity test override:
+ * the DECK_PALETTE here uses the EXISTING De Stijl values so the wiki surface
+ * and the MVA deck feel like one coherent product. This divergence is
+ * documented in 118-04-feynman-deck-vercel-SUMMARY.md.
+ */
+const DECK_PALETTE = Object.freeze({
+  red:      '#A63D2F',  // ds-red
+  blue:     '#1E3A6E',  // ds-blue
+  yellow:   '#C8A43C',  // ds-yellow
+  green:    '#2D6B4A',  // ds-green
+  amethyst: '#6B4E8B',  // ds-amethyst
+  sienna:   '#B5602A',  // ds-sienna (for accent rails)
+  cream:    '#F5F0E8',  // ds-cream (canvas)
+  black:    '#0D0D0D',  // ds-bg (text)
+  muted:    '#A09A90',  // ds-muted
+});
+
+// Load the template at module-load time (cached). Throws on missing file --
+// that's a build-time failure, not a runtime one.
+const TEMPLATE_PATH = path.join(__dirname, '..', '..', 'data', 'mva-deck-template.html');
+const TEMPLATE = fs.readFileSync(TEMPLATE_PATH, 'utf8');
+
+// Per-agent slide accent color (deterministic rotation through palette)
+const AGENT_ACCENT = Object.freeze({
+  brain_similar:       DECK_PALETTE.red,
+  brain_cross_domain:  DECK_PALETTE.yellow,
+  brain_classic_traps: DECK_PALETTE.blue,
+  tavily_funding:      DECK_PALETTE.green,
+  six_hats_red_black:  DECK_PALETTE.amethyst,
+  dashboard_graph:     DECK_PALETTE.sienna,
+});
+
+const AGENT_LABEL = Object.freeze({
+  brain_similar:       'Similar Ventures',
+  brain_cross_domain:  'Cross-Domain Analogy',
+  brain_classic_traps: 'Classic Traps',
+  tavily_funding:      'Live Funding Scan',
+  six_hats_red_black:  'Worth Chewing On',
+  dashboard_graph:     'Your Room',
+});
+
+const INSTALL_SITE_URL = 'https://mindrianos-install-site.vercel.app';
+
+// Sharp-question fallback (verbatim from Plan 118-03 renderer; em-dash-free)
+const SHARP_QUESTION_LINES = [
+  "I didn't find precedents for this in 30 seconds.",
+  "That's either a gap in my data or a signal that you're in a genuinely unexplored space.",
+  "Which do you think it is?",
+];
+
+// Hebrew refusal (defensive -- per LD1 the orchestrator short-circuits before
+// invoking the deck builder on locale=he, but we mirror the safety here too)
+const HEBREW_REFUSAL_LINES = [
+  'MindrianOS does not yet support Hebrew in v1.13.0. Please try in English.',
+  'MindrianOS לא תומך בעברית ב-v1.13.0; אנא נסה באנגלית.',
+];
+
+// ---------- Helpers ----------
+
+/**
+ * Escape HTML in untrusted text. Used for every dynamic insertion so that
+ * agent summary lines (or any future user-derived content -- there is none
+ * today per Canon Part 8) cannot inject markup.
+ */
+function _esc(s) {
+  if (s === null || s === undefined) return '';
+  return String(s)
+    .replace(/&/g, '&amp;')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+    .replace(/"/g, '&quot;')
+    .replace(/'/g, '&#39;');
+}
+
+function _summaryLine(payload) {
+  if (!payload || typeof payload !== 'object') return '';
+  if (typeof payload.summary_line === 'string') return payload.summary_line;
+  return '';
+}
+
+function _agentLabelFor(agent_id) {
+  return AGENT_LABEL[agent_id] || agent_id;
+}
+
+function _accentFor(agent_id) {
+  return AGENT_ACCENT[agent_id] || DECK_PALETTE.muted;
+}
+
+/**
+ * Render the agent-specific deck_data payload as a small structured block.
+ * The deck_data shapes vary per agent (Plan 118-02 contract). We render
+ * defensively: any unknown / missing shape falls back to a single line.
+ */
+function _renderDeckData(agent_id, payload) {
+  if (!payload || typeof payload !== 'object' || !payload.deck_data) return '';
+  const d = payload.deck_data;
+  const items = [];
+
+  // brain_similar: ventures list
+  if (Array.isArray(d.ventures)) {
+    for (const v of d.ventures) {
+      items.push(_esc(v.name) + (v.stage ? ' (' + _esc(v.stage) + ')' : ''));
+    }
+  }
+  // brain_cross_domain / brain_classic_traps: framework/trap + signature
+  if (d.framework || d.trap) {
+    items.push(_esc(d.framework || d.trap) +
+      (d.signature ? ': ' + _esc(d.signature) : ''));
+  }
+  // tavily_funding: title + deadline
+  if (d.title) {
+    items.push(_esc(d.title) + (d.deadline ? ' (deadline ' + _esc(d.deadline) + ')' : ''));
+  }
+  // six_hats_red_black: question
+  if (d.question) {
+    items.push(_esc(d.question));
+  }
+  // dashboard_graph: node list
+  if (Array.isArray(d.nodes)) {
+    for (const n of d.nodes) {
+      items.push(_esc(n));
+    }
+  }
+
+  if (items.length === 0) return '';
+  const liStyle = 'padding:4px 0;border-bottom:1px solid ' + DECK_PALETTE.muted + ';font-family:Courier,"Courier New",monospace;font-size:13px;color:' + DECK_PALETTE.black + ';';
+  return '<ul style="list-style:none;margin:12px 0 0 0;padding:0;">' +
+    items.map(function (it) {
+      return '<li style="' + liStyle + '">' + it + '</li>';
+    }).join('') +
+    '</ul>';
+}
+
+// ---------- Slide rendering ----------
+
+/**
+ * buildSlide(result) -> string. Render one <article> per agent result.
+ *
+ * Status-aware:
+ *   ok      -> label + summary_line + deck_data list
+ *   empty   -> placeholder (tavily_unavailable has special config-hint text)
+ *   timeout -> "(still in progress at 45s)"
+ *   error   -> "(skipped)"
+ *
+ * Each article has a 4px top accent rail in the agent's palette color.
+ */
+function buildSlide(result) {
+  if (!result || typeof result !== 'object') return '';
+  const agent_id = result.agent_id || 'agent';
+  const label = _agentLabelFor(agent_id);
+  const accent = _accentFor(agent_id);
+  const status = result.status;
+
+  let body;
+  if (status === 'ok') {
+    const summary = _summaryLine(result.payload);
+    const deckBlock = _renderDeckData(agent_id, result.payload);
+    body =
+      '<p style="margin:0;font-size:16px;color:' + DECK_PALETTE.black + ';line-height:1.55;">' +
+      _esc(summary || '(no summary returned)') +
+      '</p>' +
+      deckBlock;
+  } else if (status === 'empty') {
+    const reason = result.payload && typeof result.payload === 'object' ? result.payload.reason : null;
+    if (agent_id === 'tavily_funding' && reason === 'tavily_unavailable') {
+      body = '<p style="margin:0;font-style:italic;color:' + DECK_PALETTE.muted + ';font-size:15px;">' +
+        'Live funding scan: not configured (add TAVILY_API_KEY to ~/.mindrian.env)' +
+        '</p>';
+    } else {
+      body = '<p style="margin:0;font-style:italic;color:' + DECK_PALETTE.muted + ';font-size:15px;">' +
+        '(no findings this pass)' +
+        '</p>';
+    }
+  } else if (status === 'timeout') {
+    body = '<p style="margin:0;font-style:italic;color:' + DECK_PALETTE.muted + ';font-size:15px;">' +
+      '(still in progress at 45s)' +
+      '</p>';
+  } else {
+    // error / unknown
+    body = '<p style="margin:0;font-style:italic;color:' + DECK_PALETTE.muted + ';font-size:15px;">' +
+      '(skipped)' +
+      '</p>';
+  }
+
+  const articleStyle = [
+    'margin:0 0 24px 0',
+    'padding:20px 24px',
+    'background:#FFFFFF',
+    'border-top:4px solid ' + accent,
+    'border-left:1px solid ' + DECK_PALETTE.muted,
+    'border-right:1px solid ' + DECK_PALETTE.muted,
+    'border-bottom:1px solid ' + DECK_PALETTE.muted,
+  ].join(';');
+
+  const labelStyle = [
+    'margin:0 0 12px 0',
+    'font-family:Impact,"Arial Black",sans-serif',
+    'font-size:18px',
+    'letter-spacing:1px',
+    'text-transform:uppercase',
+    'color:' + accent,
+  ].join(';');
+
+  return '<article style="' + articleStyle + '">' +
+    '<h2 style="' + labelStyle + '">' + _esc(label) + '</h2>' +
+    body +
+    '</article>';
+}
+
+// ---------- Header / footer ----------
+
+function _buildHeader(sha8) {
+  // 5-rectangle Mondrian color bar across the top
+  const barStyle = 'display:flex;height:8px;width:100%;';
+  const cells = [
+    DECK_PALETTE.red, DECK_PALETTE.yellow, DECK_PALETTE.blue,
+    DECK_PALETTE.green, DECK_PALETTE.amethyst,
+  ].map(function (c) {
+    return '<div style="flex:1;background:' + c + ';"></div>';
+  }).join('');
+
+  const headerStyle = [
+    'padding:24px 32px 16px 32px',
+    'background:' + DECK_PALETTE.black,
+    'color:' + DECK_PALETTE.cream,
+    'border-bottom:2px solid ' + DECK_PALETTE.cream,
+  ].join(';');
+
+  const wordmarkStyle = [
+    'margin:0',
+    'font-family:Impact,"Arial Black",sans-serif',
+    'font-size:32px',
+    'letter-spacing:3px',
+  ].join(';');
+
+  const taglineStyle = [
+    'margin:8px 0 0 0',
+    'font-size:13px',
+    'color:' + DECK_PALETTE.muted,
+    'font-family:Courier,"Courier New",monospace',
+  ].join(';');
+
+  return '<div style="' + barStyle + '">' + cells + '</div>' +
+    '<header style="' + headerStyle + '">' +
+    '<h1 style="' + wordmarkStyle + '">MINDRIAN</h1>' +
+    '<p style="' + taglineStyle + '">30-Second Brief // sentence ' + _esc(sha8) + '</p>' +
+    '</header>';
+}
+
+function _buildFooter(sha8) {
+  // 3-option static text per OQ15 lean (no clickable router; the deck is
+  // public HTML and can't invoke a local CLI; the user pastes the copy hint
+  // into their terminal).
+  const footerStyle = [
+    'margin-top:32px',
+    'padding:24px 32px',
+    'background:' + DECK_PALETTE.black,
+    'color:' + DECK_PALETTE.cream,
+    'border-top:2px solid ' + DECK_PALETTE.cream,
+  ].join(';');
+
+  const promptStyle = 'margin:0 0 16px 0;font-family:Impact,"Arial Black",sans-serif;font-size:20px;color:' + DECK_PALETTE.yellow + ';';
+  const optionStyle = 'margin:6px 0;font-family:Courier,"Courier New",monospace;font-size:14px;color:' + DECK_PALETTE.cream + ';';
+  const copyStyle = [
+    'margin-top:20px',
+    'padding:12px 16px',
+    'background:' + DECK_PALETTE.cream,
+    'color:' + DECK_PALETTE.black,
+    'border:1px solid ' + DECK_PALETTE.yellow,
+    'font-family:Courier,"Courier New",monospace',
+    'font-size:13px',
+  ].join(';');
+
+  const attribStyle = [
+    'margin:24px 0 0 0',
+    'padding-top:16px',
+    'border-top:1px solid ' + DECK_PALETTE.muted,
+    'font-size:11px',
+    'color:' + DECK_PALETTE.muted,
+    'font-family:Courier,"Courier New",monospace',
+  ].join(';');
+
+  // Bottom Mondrian bar
+  const bottomBarStyle = 'display:flex;height:8px;width:100%;';
+  const bottomCells = [
+    DECK_PALETTE.amethyst, DECK_PALETTE.green, DECK_PALETTE.blue,
+    DECK_PALETTE.yellow, DECK_PALETTE.red,
+  ].map(function (c) {
+    return '<div style="flex:1;background:' + c + ';"></div>';
+  }).join('');
+
+  return '<footer style="' + footerStyle + '">' +
+    '<p style="' + promptStyle + '">What now?</p>' +
+    '<p style="' + optionStyle + '">[1] Just tell me what&#39;s new         (stay in &quot;tell me&quot; mode)</p>' +
+    '<p style="' + optionStyle + '">[2] Build a room around this        (invest)</p>' +
+    '<p style="' + optionStyle + '">[3] Challenge me -- Devil&#39;s Advocate (go deeper cognitively)</p>' +
+    '<div style="' + copyStyle + '">' +
+    'Paste in your terminal: <strong>/mos:new-project --from-brief ' + _esc(sha8) + '</strong>' +
+    '</div>' +
+    '<p style="' + attribStyle + '">' +
+    'Generated by MindrianOS -- ' +
+    '<a href="' + INSTALL_SITE_URL + '" style="color:' + DECK_PALETTE.yellow + ';text-decoration:none;">' +
+    INSTALL_SITE_URL +
+    '</a>' +
+    ' // brief ' + _esc(sha8) +
+    '</p>' +
+    '</footer>' +
+    '<div style="' + bottomBarStyle + '">' + bottomCells + '</div>';
+}
+
+// ---------- Special-case decks ----------
+
+function _buildHebrewRefusalDeck(sha8) {
+  const articleStyle = 'margin:0;padding:32px;background:#FFFFFF;border-top:4px solid ' + DECK_PALETTE.red + ';border:1px solid ' + DECK_PALETTE.muted + ';';
+  const body = HEBREW_REFUSAL_LINES.map(function (line) {
+    return '<p style="margin:8px 0;font-size:16px;color:' + DECK_PALETTE.black + ';">' + _esc(line) + '</p>';
+  }).join('');
+  const slides = '<article style="' + articleStyle + '">' + body + '</article>';
+  return TEMPLATE
+    .replace('{{HEADER}}', _buildHeader(sha8))
+    .replace('{{SLIDES}}', slides)
+    .replace('{{FOOTER}}', _buildFooter(sha8));
+}
+
+function _buildSharpQuestionDeck(sha8) {
+  const articleStyle = [
+    'margin:0',
+    'padding:40px 32px',
+    'background:#FFFFFF',
+    'border-top:4px solid ' + DECK_PALETTE.amethyst,
+    'border:1px solid ' + DECK_PALETTE.muted,
+  ].join(';');
+  const labelStyle = 'margin:0 0 16px 0;font-family:Impact,"Arial Black",sans-serif;font-size:20px;letter-spacing:1px;text-transform:uppercase;color:' + DECK_PALETTE.amethyst + ';';
+  // SHARP_QUESTION_LINES are module-level constants (verbatim from source
+  // spec; no user content). We render them WITHOUT escape so the apostrophes
+  // stay as readable ASCII characters in the HTML, not as &#39; entities.
+  // This is safe-by-construction: no user data flows through this branch.
+  const body = SHARP_QUESTION_LINES.map(function (line) {
+    return '<p style="margin:12px 0;font-size:17px;color:' + DECK_PALETTE.black + ';line-height:1.55;">' + line + '</p>';
+  }).join('');
+  const slides = '<article style="' + articleStyle + '">' +
+    '<h2 style="' + labelStyle + '">A Sharper Question</h2>' +
+    body +
+    '</article>';
+  return TEMPLATE
+    .replace('{{HEADER}}', _buildHeader(sha8))
+    .replace('{{SLIDES}}', slides)
+    .replace('{{FOOTER}}', _buildFooter(sha8));
+}
+
+// ---------- Public buildDeck ----------
+
+/**
+ * buildDeck(outcome) -> full HTML document string.
+ *
+ * @param {{
+ *   results: Array<{agent_id: string, status: string, payload?: object, error?: string}>,
+ *   rendered?: string,
+ *   footer_data: { ok: number, failed: number, sha256: string, hebrew_refusal?: boolean } | null
+ * }} outcome
+ * @returns {string}
+ */
+function buildDeck(outcome) {
+  if (!outcome || typeof outcome !== 'object') {
+    return '';
+  }
+  const fd = outcome.footer_data || {};
+  const sha256 = typeof fd.sha256 === 'string' ? fd.sha256 : '';
+  const sha8 = sha256.slice(0, 8) || 'unknown';
+
+  // Hebrew refusal short-circuit (defensive -- Plan 118-03 should not call us here)
+  if (fd.hebrew_refusal) {
+    return _buildHebrewRefusalDeck(sha8);
+  }
+
+  const results = Array.isArray(outcome.results) ? outcome.results : [];
+  const okCount = results.filter(function (r) { return r && r.status === 'ok'; }).length;
+
+  // All-fail -> sharp-question single slide
+  if (okCount === 0 && results.length > 0) {
+    return _buildSharpQuestionDeck(sha8);
+  }
+
+  // Normal path: one slide per result (placeholder slides for empty/error)
+  const slides = results.map(buildSlide).join('\n');
+
+  return TEMPLATE
+    .replace('{{HEADER}}', _buildHeader(sha8))
+    .replace('{{SLIDES}}', slides)
+    .replace('{{FOOTER}}', _buildFooter(sha8));
+}
+
+module.exports = {
+  buildDeck,
+  buildSlide,
+  DECK_PALETTE,
+};