@mindrian_os/install 1.13.0-beta.11

package/lib/hmi/shape-f2-renderer.cjs

@@ -0,0 +1,132 @@
+/*
+ * Copyright (c) 2026 Mindrian. BSL 1.1.
+ *
+ * Phase 88.2-01 -- Shape F.2 Path Control renderer (UISEL-88.2-02).
+ *
+ * Implements the open-vocabulary Shape F.2 (Path Control) selector per
+ * skills/ui-system/SKILL.md Section 2 Shape F.2. F.2 is the structural
+ * companion to F.1: where F.1 chooses the next move (tactical), F.2
+ * chooses the path (strategic). Verb vocabulary is a constrained subset
+ * of the canonical 10 verbs per SKILL.md §2 F.2 verb constraints:
+ * Run Methodology / Reformulate / Scenario Plan / Defer / Free-Text.
+ *
+ * Mirrors the structure of lib/hmi/shape-f1-renderer.cjs. Differences:
+ *   - PATH_CONTROL_VERBS is a 5-verb constrained subset (NOT the 10).
+ *   - Default verbs == PATH_CONTROL_VERBS.
+ *   - contract.shape === 'F.2'.
+ *   - Default header refers to "path control".
+ *
+ * Free-Text-always-last invariant: hardcoded; deduped; appended outside
+ * the user-supplied 5-verb cap.
+ *
+ * Mode A (tier >= 2): Brain reachable, RECOMMENDED marker (▶) rendered on
+ * matching `recommendedVerb` row when it appears in the verb list.
+ * Mode B (tier < 2):  no RECOMMENDED marker; every row prefixed with ▷.
+ *
+ * Allowed glyphs in body (Canon Part 3 + skills/ui-system/SKILL.md
+ * 12-glyph vocabulary): ▶ ▷ ■ • →. No box characters.
+ *
+ * Pure CJS, node built-ins only, zero runtime deps (Phase 87 invariant).
+ *
+ * API:
+ *   renderShapeF2({ tier, recommendedVerb?, verbs?, header?, personaContext? })
+ *     -> { zones, contract }
+ *
+ * personaContext (optional, Phase 88.2-03): when a non-empty string is
+ * supplied, the header is suffixed with ' ({personaContext} lens)' and
+ * contract.personaContext surfaces the value back to the dispatcher for
+ * telemetry. Cold-start (omitted/null/empty) preserves the prior
+ * behavior byte-for-byte (no suffix; contract.personaContext === null).
+ */
+
+'use strict';
+
+const PATH_CONTROL_VERBS = [
+  'Run Methodology',
+  'Reformulate',
+  'Scenario Plan',
+  'Defer',
+  'Free-Text',
+];
+
+const FREE_TEXT = 'Free-Text';
+const USER_VERB_CAP = 5; // Phase 88.2 invariant: 3-5 options + Free-Text appended.
+const MARKER_RECOMMENDED = '▶';
+const MARKER_ROW = '▷';
+const DEFAULT_HEADER = '-- mindrianOS -- path control -- choose path --';
+
+/**
+ * Normalize the verb list:
+ *   - if user-supplied: cap at USER_VERB_CAP, drop all Free-Text instances,
+ *     then append exactly one trailing Free-Text.
+ *   - if not: return the PATH_CONTROL_VERBS subset as-is (already ends
+ *     with Free-Text).
+ *
+ * Free-Text-always-last is hardcoded; callers cannot omit it.
+ */
+function normalizeVerbs(rawVerbs) {
+  if (!Array.isArray(rawVerbs)) {
+    return PATH_CONTROL_VERBS.slice();
+  }
+  const userOnly = rawVerbs
+    .filter(v => typeof v === 'string' && v.length > 0 && v !== FREE_TEXT)
+    .slice(0, USER_VERB_CAP);
+  userOnly.push(FREE_TEXT);
+  return userOnly;
+}
+
+function renderShapeF2(input) {
+  const opts = (input && typeof input === 'object') ? input : {};
+  const tier = typeof opts.tier === 'number' ? opts.tier : 0;
+  const recommendedVerb = typeof opts.recommendedVerb === 'string' && opts.recommendedVerb.length > 0
+    ? opts.recommendedVerb : null;
+  const header = typeof opts.header === 'string' && opts.header.length > 0
+    ? opts.header : null;
+  // Phase 88.2-03 D-AMEND-04 / DISCRETION-AMEND-01 option (a): optional
+  // personaContext suffix; cold-start (omitted/null/empty) renders without
+  // suffix. Renderer stays PURE; caller (dispatcher) supplies the string.
+  const personaContext = (typeof opts.personaContext === 'string' && opts.personaContext.length > 0)
+    ? opts.personaContext
+    : null;
+
+  const verbs = normalizeVerbs(opts.verbs);
+
+  const mode = tier >= 2 ? 'A' : 'B';
+  // RECOMMENDED only when Mode A AND verb is in list AND not Free-Text.
+  const recInList = (mode === 'A' && recommendedVerb
+      && verbs.indexOf(recommendedVerb) !== -1
+      && recommendedVerb !== FREE_TEXT)
+    ? recommendedVerb : null;
+
+  const lines = verbs.map((verb, i) => {
+    const prefix = (verb === recInList) ? MARKER_RECOMMENDED : MARKER_ROW;
+    return prefix + ' ' + String(i + 1) + '. ' + verb;
+  });
+
+  let composedHeader = header || DEFAULT_HEADER;
+  if (personaContext) {
+    composedHeader = composedHeader + ' (' + personaContext + ' lens)';
+  }
+
+  return {
+    zones: {
+      header: composedHeader,
+      body: lines.join('\n'),
+      signals: '',
+      footer: null,
+    },
+    contract: {
+      shape: 'F.2',
+      keyboard: 'askuserquestion',
+      verbs: verbs.slice(),
+      mode: mode,
+      recommended: recInList,
+      personaContext: personaContext,
+    },
+  };
+}
+
+module.exports = {
+  renderShapeF2: renderShapeF2,
+  PATH_CONTROL_VERBS: PATH_CONTROL_VERBS.slice(),
+};

package/lib/hmi/shape-f3-renderer.cjs

@@ -0,0 +1,66 @@
+/*
+ * Copyright (c) 2026 Mindrian. BSL 1.1.
+ *
+ * Phase 88.2-02 -- Shape F.3 (Rabbit-Hole Depth) renderer.
+ *
+ * Closed-vocabulary depth selector. Five fixed options:
+ *   Shallow / Medium / Deep / Extreme / Back
+ *
+ * Per docs/MINDRIAN-CANON.md Part 3 + skills/ui-system/SKILL.md Section 2
+ * Shape F.3, this is the one Shape F sub-shape whose option set is NOT the
+ * canonical 10-verb vocabulary. It is a depth scalar.
+ *
+ * Closed-vocab discipline:
+ *   - Free-Text is NOT offered (depth is a closed axis).
+ *   - RECOMMENDED marker (▶) is NEVER rendered. F.3 is not Brain-routed; the
+ *     option set is identical in Mode A, Mode B, and Tier 0.
+ *   - The dispatcher applies any Mode B Zone-1 prefix; the renderer itself
+ *     does not branch on tier.
+ *
+ * Allowed glyphs (skills/ui-system/SKILL.md 12-glyph vocabulary):
+ *   ▷ (row marker). No box characters. No ▶.
+ *
+ * Pure CJS, node built-ins only, zero deps (Phase 87 invariant).
+ *
+ * API:
+ *   renderShapeF3({ header? }) -> { zones, contract }
+ */
+
+'use strict';
+
+const F3_OPTIONS = ['Shallow', 'Medium', 'Deep', 'Extreme', 'Back'];
+const MARKER_ROW = '▷'; // ▷
+const DEFAULT_HEADER = '-- mindrianOS -- depth -- pick depth --';
+
+function renderShapeF3(input) {
+  const opts = (input && typeof input === 'object') ? input : {};
+  const header = (typeof opts.header === 'string' && opts.header.length > 0)
+    ? opts.header
+    : DEFAULT_HEADER;
+
+  const lines = F3_OPTIONS.map((label, i) => {
+    return MARKER_ROW + ' ' + String(i + 1) + '. ' + label;
+  });
+
+  return {
+    zones: {
+      header: header,
+      body: lines.join('\n'),
+      signals: '',
+      footer: null,
+    },
+    contract: {
+      shape: 'F.3',
+      keyboard: 'f3-fixed',
+      verbs: F3_OPTIONS.slice(),
+      mode: 'closed',
+      recommended: null,
+      freeTextOffered: false,
+    },
+  };
+}
+
+module.exports = {
+  renderShapeF3: renderShapeF3,
+  F3_OPTIONS: F3_OPTIONS.slice(),
+};

package/lib/hmi/shape-f4-renderer.cjs

@@ -0,0 +1,72 @@
+/*
+ * Copyright (c) 2026 Mindrian. BSL 1.1.
+ *
+ * Phase 88.2-02 -- Shape F.4 (Insight Extraction) renderer.
+ *
+ * Closed-vocabulary insight-extraction selector. Five fixed options:
+ *   Key insights / +contradictions / +actions / Create artifact draft / Back
+ *
+ * Per docs/MINDRIAN-CANON.md Part 3 + skills/ui-system/SKILL.md Section 2
+ * Shape F.4, F.4 wraps the canonical verb Synthesize. The five options form
+ * a progressive scope ladder for what the synthesis produces.
+ *
+ * Closed-vocab discipline:
+ *   - Free-Text is NOT offered (extraction scope is a closed ladder).
+ *   - RECOMMENDED marker (▶) is NEVER rendered. F.4 is not Brain-routed; the
+ *     option set is identical in Mode A, Mode B, and Tier 0.
+ *   - The dispatcher applies any Mode B Zone-1 prefix; the renderer itself
+ *     does not branch on tier.
+ *
+ * Allowed glyphs (skills/ui-system/SKILL.md 12-glyph vocabulary):
+ *   ▷ (row marker). No box characters. No ▶.
+ *
+ * Pure CJS, node built-ins only, zero deps (Phase 87 invariant).
+ *
+ * API:
+ *   renderShapeF4({ header? }) -> { zones, contract }
+ */
+
+'use strict';
+
+const F4_OPTIONS = [
+  'Key insights',
+  '+contradictions',
+  '+actions',
+  'Create artifact draft',
+  'Back',
+];
+const MARKER_ROW = '▷';
+const DEFAULT_HEADER = '-- mindrianOS -- insights -- pick scope --';
+
+function renderShapeF4(input) {
+  const opts = (input && typeof input === 'object') ? input : {};
+  const header = (typeof opts.header === 'string' && opts.header.length > 0)
+    ? opts.header
+    : DEFAULT_HEADER;
+
+  const lines = F4_OPTIONS.map((label, i) => {
+    return MARKER_ROW + ' ' + String(i + 1) + '. ' + label;
+  });
+
+  return {
+    zones: {
+      header: header,
+      body: lines.join('\n'),
+      signals: '',
+      footer: null,
+    },
+    contract: {
+      shape: 'F.4',
+      keyboard: 'f4-fixed',
+      verbs: F4_OPTIONS.slice(),
+      mode: 'closed',
+      recommended: null,
+      freeTextOffered: false,
+    },
+  };
+}
+
+module.exports = {
+  renderShapeF4: renderShapeF4,
+  F4_OPTIONS: F4_OPTIONS.slice(),
+};

package/lib/hmi/shape-f5-renderer.cjs

@@ -0,0 +1,155 @@
+/*
+ * Copyright (c) 2026 Mindrian. BSL 1.1.
+ *
+ * Phase 88.2-03 -- Shape F.5 Branch Resolution renderer (UISEL-88.2-05).
+ *
+ * F.5 is the branch-resolution sub-shape of the AskUserQuestion-backed
+ * Shape F selector family. It is invoked when the navigator returns from
+ * parallel exploration (Scenario Plan, Compare Ventures, manual fork) and
+ * must decide how branches converge.
+ *
+ * Vocabulary (per skills/ui-system/SKILL.md Section 2 Shape F.5):
+ *   ALLOWED_BRANCH_VERBS    : Continue / Merge / Compare / Park / Drop / Free-Text
+ *   BRANCH_RESOLUTION_VERBS : default 5-slate (Continue / Merge / Compare / Park / Free-Text)
+ *
+ * Drop is the terminal Reject-with-reason path -- power-user verb, not in
+ * the default slate but admissible when explicitly injected.
+ *
+ * Open-vocabulary like F.1/F.2, but caller-supplied verbs are validated
+ * against ALLOWED_BRANCH_VERBS. Unknown verbs are silently dropped --
+ * F.5 is specialized to branch-resolution semantics; navigators cannot
+ * invent new branch labels.
+ *
+ * Mode A (tier >= 2) renders RECOMMENDED `▶` marker on the matching verb.
+ * Mode B (tier < 2) suppresses the marker (every row prefixed with `▷`).
+ * Free-Text is hardcoded as the last verb (Canon Part 3 + Phase 88.2 invariant).
+ *
+ * Allowed glyphs (Canon Part 3 + skills/ui-system/SKILL.md 12-glyph
+ * vocabulary): ▶ ▷. No box characters.
+ *
+ * Pure CJS, node built-ins only, zero deps.
+ *
+ * API:
+ *   renderShapeF5({ tier, recommendedVerb?, verbs?, header?, personaContext? })
+ *     -> { zones, contract }
+ *
+ * personaContext (optional, Phase 88.2-03): when a non-empty string is
+ * supplied, the header is suffixed with ' ({personaContext} lens)' and
+ * contract.personaContext surfaces the value back to the dispatcher for
+ * telemetry. Cold-start (omitted/null/empty) preserves the prior
+ * behavior byte-for-byte (no suffix; contract.personaContext === null).
+ */
+
+'use strict';
+
+const ALLOWED_BRANCH_VERBS = [
+  'Continue',
+  'Merge',
+  'Compare',
+  'Park',
+  'Drop',
+  'Free-Text',
+];
+
+const BRANCH_RESOLUTION_VERBS = [
+  'Continue',
+  'Merge',
+  'Compare',
+  'Park',
+  'Free-Text',
+];
+
+const FREE_TEXT = 'Free-Text';
+const MAX_USER_VERBS = 5;
+const MARKER_RECOMMENDED = '▶'; // ▶
+const MARKER_ROW = '▷';         // ▷
+
+const ALLOWED_SET = new Set(ALLOWED_BRANCH_VERBS);
+
+function defaultHeader() {
+  return '-- mindrianOS -- branch -- resolve --';
+}
+
+function buildVerbList(callerVerbs) {
+  // If caller did not supply verbs, use the default 5-slate (already
+  // contains Free-Text last).
+  if (!Array.isArray(callerVerbs)) {
+    return BRANCH_RESOLUTION_VERBS.slice();
+  }
+
+  // Filter to ALLOWED_BRANCH_VERBS membership (silent drop of unknowns).
+  // Strip Free-Text -- we re-append it at the end unconditionally.
+  const cleaned = [];
+  for (const v of callerVerbs) {
+    if (typeof v !== 'string') continue;
+    if (!ALLOWED_SET.has(v)) continue;
+    if (v === FREE_TEXT) continue;
+    if (cleaned.indexOf(v) !== -1) continue; // de-dup
+    cleaned.push(v);
+  }
+
+  // Cap user-supplied verbs at MAX_USER_VERBS (5) before Free-Text is
+  // appended, so total length never exceeds 6.
+  const capped = cleaned.slice(0, MAX_USER_VERBS);
+  capped.push(FREE_TEXT);
+  return capped;
+}
+
+function renderShapeF5(input) {
+  const opts = (input && typeof input === 'object') ? input : {};
+  const tier = typeof opts.tier === 'number' ? opts.tier : 0;
+  const recommendedVerb = typeof opts.recommendedVerb === 'string' && opts.recommendedVerb.length > 0
+    ? opts.recommendedVerb : null;
+  const header = typeof opts.header === 'string' && opts.header.length > 0
+    ? opts.header : null;
+  // Phase 88.2-03 D-AMEND-04 / DISCRETION-AMEND-01 option (a): optional
+  // personaContext suffix; cold-start (omitted/null/empty) renders without
+  // suffix. Renderer stays PURE; caller (dispatcher) supplies the string.
+  const personaContext = (typeof opts.personaContext === 'string' && opts.personaContext.length > 0)
+    ? opts.personaContext
+    : null;
+
+  const verbs = buildVerbList(opts.verbs);
+
+  const mode = tier >= 2 ? 'A' : 'B';
+  // Recommendation only renders if (a) Mode A, (b) the verb survived the
+  // pipeline (is in the final verbs[]), and (c) it is not Free-Text.
+  const recInList = (mode === 'A'
+    && recommendedVerb
+    && recommendedVerb !== FREE_TEXT
+    && verbs.indexOf(recommendedVerb) !== -1)
+    ? recommendedVerb : null;
+
+  const lines = verbs.map((verb, i) => {
+    const prefix = (verb === recInList) ? MARKER_RECOMMENDED : MARKER_ROW;
+    return prefix + ' ' + String(i + 1) + '. ' + verb;
+  });
+
+  let composedHeader = header || defaultHeader();
+  if (personaContext) {
+    composedHeader = composedHeader + ' (' + personaContext + ' lens)';
+  }
+
+  return {
+    zones: {
+      header: composedHeader,
+      body: lines.join('\n'),
+      signals: '',
+      footer: null,
+    },
+    contract: {
+      shape: 'F.5',
+      keyboard: 'askuserquestion',
+      verbs: verbs.slice(),
+      mode: mode,
+      recommended: recInList,
+      personaContext: personaContext,
+    },
+  };
+}
+
+module.exports = {
+  renderShapeF5: renderShapeF5,
+  BRANCH_RESOLUTION_VERBS: BRANCH_RESOLUTION_VERBS.slice(),
+  ALLOWED_BRANCH_VERBS: ALLOWED_BRANCH_VERBS.slice(),
+};