@maestrofrontier/frontier 1.4.5 → 1.6.0

package/frontier/run.cjs

@@ -1,180 +1,201 @@
-#!/usr/bin/env node
-// Maestro Frontier — mode router (off / single / fusion).
-// runFrontier({prompt, state, cfg, deps}) -> Promise<FusionResult>.
-//
-// Re-grounding note (Fable T2): the engine fans a prompt to model CLIs
-// that do NOT share this session's file/context. A member or synthesis
-// output asserting "I can't see X" / "no such file" reflects that
-// subprocess's blank context, not ground truth — re-ground such claims
-// against live context before relaying them to the user (AGENTS.md S7.7).
-
-'use strict';
-
-const { DEFAULTS } = require('./config.cjs');
-const { resolvePanel, resolveJudgeModel, resolveSynthModel } = require('./config.cjs');
-const { classify, toFailedModel } = require('./schema.cjs');
-const dispatch = require('./dispatch.cjs');
-const judge = require('./judge.cjs');
-const synthesize = require('./synthesize.cjs');
-
-const MODEL_ALIASES = {
-  chatgpt: 'gpt-5.5',
-};
-
-const PRESET_ALIASES = {
-  'chatgpt-duo': 'gpt-duo',
-};
-
-/** @param {string} model @returns {string} */
-function canonicalModelId(model) {
-  return MODEL_ALIASES[model] || model;
-}
-
-/** @param {string} preset @returns {string} */
-function canonicalPresetId(preset) {
-  return PRESET_ALIASES[preset] || preset;
-}
-
-/** @param {object} state @returns {object} */
-function normalizeStateAliases(state) {
-  const normalized = { ...state };
-  if (normalized.model) normalized.model = canonicalModelId(normalized.model);
-  if (normalized.preset) normalized.preset = canonicalPresetId(normalized.preset);
-  if (Array.isArray(normalized.models)) {
-    normalized.models = normalized.models.map(canonicalModelId);
-  }
-  if (normalized.judgeModel) normalized.judgeModel = canonicalModelId(normalized.judgeModel);
-  if (normalized.synthModel) normalized.synthModel = canonicalModelId(normalized.synthModel);
-  return normalized;
-}
-
-/**
- * @param {{ prompt:string, state:object, cfg?:object, deps?:object }} opts
- * @returns {Promise<object>}
- */
-async function runFrontier({ prompt, state, cfg, deps }) {
-  cfg = cfg || DEFAULTS;
-  deps = deps || {};
-  state = normalizeStateAliases(state || {});
-
-  const spawnOne  = deps.spawnOne  || dispatch.spawnOne;
-  const fanOut    = deps.fanOut    || dispatch.fanOut;
-  const runJudge  = deps.runJudge  || judge.runJudge;
-  const runSynth  = deps.runSynth  || synthesize.runSynth;
-
-  const rawDepth = parseInt(process.env.FUSION_DEPTH || '0', 10);
-  const depth    = isNaN(rawDepth) ? 0 : rawDepth;
-
-  // ---- OFF ----
-  if (state.mode === 'off') {
-    return { status: 'off', mode: 'off', final: null };
-  }
-
-  // ---- RECURSION GUARD (single + fusion) ----
-  if (depth >= 1) {
-    const base = {
-      status: 'error',
-      mode: state.mode,
-      error: 'fusion depth exceeded (one-level cap)',
-      failure_reason: 'fusion_invocation_capped',
-    };
-    if (state.mode === 'fusion') return { ...base, preset: state.preset };
-    if (state.mode === 'single') return { ...base, model: state.model };
-    return base;
-  }
-
-  // ---- SINGLE ----
-  if (state.mode === 'single') {
-    const adapter = cfg.adapters && cfg.adapters[state.model];
-    if (!adapter) {
-      return {
-        status: 'error',
-        mode: 'single',
-        model: state.model,
-        error: 'unknown model: ' + state.model,
-        failure_reason: 'unexpected_error',
-      };
-    }
-    const resp = await spawnOne(prompt, adapter, { timeoutMs: cfg.timeoutMs, fusionDepth: depth + 1 });
-    if (!resp.ok) {
-      return {
-        status: 'error',
-        mode: 'single',
-        model: state.model,
-        error: resp.error,
-        failure_reason: classify([toFailedModel(resp)]),
-      };
-    }
-    return { status: 'ok', mode: 'single', model: state.model, final: resp.content, response: resp };
-  }
-
-  // ---- FUSION ----
-  if (state.mode === 'fusion') {
-    // resolve panel
-    let panelIds;
-    try {
-      panelIds = resolvePanel(state, cfg);
-    } catch (e) {
-      return {
-        status: 'error',
-        mode: 'fusion',
-        preset: state.preset,
-        error: e.message,
-        failure_reason: 'unexpected_error',
-      };
-    }
-
-    // BUDGET (opt-in)
-    if (cfg.tokenBudget && cfg.tokenBudget > 0) {
-      const projected = Math.ceil(prompt.length / 4) * panelIds.length;
-      if (projected > cfg.tokenBudget) {
-        return {
-          status: 'error',
-          mode: 'fusion',
-          preset: state.preset,
-          error: 'projected token budget exceeded (' + projected + '>' + cfg.tokenBudget + ')',
-          failure_reason: 'unexpected_error',
-        };
-      }
-    }
-
-    const panel  = await fanOut(prompt, panelIds, cfg, { fusionDepth: depth + 1 });
-    const ok     = panel.filter(p => p.ok);
-    const failed = panel.filter(p => !p.ok);
-
-    if (ok.length === 0) {
-      return {
-        status: 'error',
-        mode: 'fusion',
-        preset: state.preset,
-        error: 'all panels failed',
-        failure_reason: classify(failed.map(toFailedModel)),
-      };
-    }
-
-    // Resolve judge/synth model (explicit flag -> preset override -> default)
-    // and hand the judge/synth stages a cfg pinned to those models, so a
-    // preset like gpt-duo runs entirely on its own provider.
-    const stageCfg = {
-      ...cfg,
-      judgeModel: resolveJudgeModel(state, cfg),
-      synthModel: resolveSynthModel(state, cfg),
-    };
-    const analysis = await runJudge(prompt, ok, stageCfg);
-    let final = await runSynth(prompt, { analysis, responses: ok }, stageCfg);
-    if (!final) {
-      // synth-fail fallback: longest ok response
-      final = ok.reduce((a, b) => b.content.length > a.content.length ? b : a).content;
-    }
-
-    const result = { status: 'ok', mode: 'fusion', preset: state.preset, final, responses: ok };
-    if (analysis !== undefined) result.analysis = analysis;
-    if (failed.length) result.failed_models = failed.map(toFailedModel);
-    return result;
-  }
-
-  // ---- UNKNOWN MODE ----
-  return { status: 'error', mode: state.mode, error: 'unknown mode', failure_reason: 'unexpected_error' };
-}
-
-module.exports = { runFrontier, canonicalModelId, canonicalPresetId, normalizeStateAliases };
+#!/usr/bin/env node
+// Maestro Frontier — mode router (off / single / fusion).
+// runFrontier({prompt, state, cfg, deps}) -> Promise<FusionResult>.
+//
+// Re-grounding note (Fable T2): the engine fans a prompt to model CLIs
+// that do NOT share this session's file/context. A member or synthesis
+// output asserting "I can't see X" / "no such file" reflects that
+// subprocess's blank context, not ground truth — re-ground such claims
+// against live context before relaying them to the user (AGENTS.md S7.7).
+
+'use strict';
+
+const { DEFAULTS } = require('./config.cjs');
+const { resolvePanel, resolveJudgeModel, resolveSynthModel } = require('./config.cjs');
+const { classify, toFailedModel } = require('./schema.cjs');
+const dispatch = require('./dispatch.cjs');
+const judge = require('./judge.cjs');
+const synthesize = require('./synthesize.cjs');
+
+const MODEL_ALIASES = {
+  chatgpt: 'gpt-5.5',
+};
+
+const PRESET_ALIASES = {
+  'chatgpt-duo': 'gpt-duo',
+};
+
+/** @param {string} model @returns {string} */
+function canonicalModelId(model) {
+  return MODEL_ALIASES[model] || model;
+}
+
+/** @param {string} preset @returns {string} */
+function canonicalPresetId(preset) {
+  return PRESET_ALIASES[preset] || preset;
+}
+
+/** @param {object} state @returns {object} */
+function normalizeStateAliases(state) {
+  const normalized = { ...state };
+  if (normalized.model) normalized.model = canonicalModelId(normalized.model);
+  if (normalized.preset) normalized.preset = canonicalPresetId(normalized.preset);
+  if (Array.isArray(normalized.models)) {
+    normalized.models = normalized.models.map(canonicalModelId);
+  }
+  if (normalized.judgeModel) normalized.judgeModel = canonicalModelId(normalized.judgeModel);
+  if (normalized.synthModel) normalized.synthModel = canonicalModelId(normalized.synthModel);
+  return normalized;
+}
+
+/**
+ * @param {{ prompt:string, state:object, cfg?:object, deps?:object }} opts
+ * @returns {Promise<object>}
+ */
+async function runFrontier({ prompt, state, cfg, deps }) {
+  cfg = cfg || DEFAULTS;
+  deps = deps || {};
+  state = normalizeStateAliases(state || {});
+
+  const spawnOne   = deps.spawnOne   || dispatch.spawnOne;
+  const fanOut     = deps.fanOut     || dispatch.fanOut;
+  const runJudge   = deps.runJudge   || judge.runJudge;
+  const runSynth   = deps.runSynth   || synthesize.runSynth;
+  const onProgress = (deps && typeof deps.onProgress === 'function') ? deps.onProgress : null;
+
+  const startMs = Date.now();
+
+  /** Emit a progress event; swallows any error thrown by the callback. */
+  function emit(eventObj) {
+    if (!onProgress) return;
+    try { onProgress(eventObj); } catch (_) {}
+  }
+
+  const rawDepth = parseInt(process.env.FUSION_DEPTH || '0', 10);
+  const depth    = isNaN(rawDepth) ? 0 : rawDepth;
+
+  // ---- OFF ----
+  if (state.mode === 'off') {
+    return { status: 'off', mode: 'off', final: null };
+  }
+
+  // ---- RECURSION GUARD (single + fusion) ----
+  if (depth >= 1) {
+    const base = {
+      status: 'error',
+      mode: state.mode,
+      error: 'fusion depth exceeded (one-level cap)',
+      failure_reason: 'fusion_invocation_capped',
+    };
+    if (state.mode === 'fusion') return { ...base, preset: state.preset };
+    if (state.mode === 'single') return { ...base, model: state.model };
+    return base;
+  }
+
+  // ---- SINGLE ----
+  if (state.mode === 'single') {
+    const adapter = cfg.adapters && cfg.adapters[state.model];
+    if (!adapter) {
+      return {
+        status: 'error',
+        mode: 'single',
+        model: state.model,
+        error: 'unknown model: ' + state.model,
+        failure_reason: 'unexpected_error',
+      };
+    }
+    emit({ phase: 'single-start', model: state.model });
+    const resp = await spawnOne(prompt, adapter, { timeoutMs: cfg.timeoutMs, fusionDepth: depth + 1 });
+    if (!resp.ok) {
+      return {
+        status: 'error',
+        mode: 'single',
+        model: state.model,
+        error: resp.error,
+        failure_reason: classify([toFailedModel(resp)]),
+      };
+    }
+    emit({ phase: 'done', models: 1, ms: Date.now() - startMs });
+    return { status: 'ok', mode: 'single', model: state.model, final: resp.content, response: resp };
+  }
+
+  // ---- FUSION ----
+  if (state.mode === 'fusion') {
+    // resolve panel
+    let panelIds;
+    try {
+      panelIds = resolvePanel(state, cfg);
+    } catch (e) {
+      return {
+        status: 'error',
+        mode: 'fusion',
+        preset: state.preset,
+        error: e.message,
+        failure_reason: 'unexpected_error',
+      };
+    }
+
+    // BUDGET (opt-in)
+    if (cfg.tokenBudget && cfg.tokenBudget > 0) {
+      const projected = Math.ceil(prompt.length / 4) * panelIds.length;
+      if (projected > cfg.tokenBudget) {
+        return {
+          status: 'error',
+          mode: 'fusion',
+          preset: state.preset,
+          error: 'projected token budget exceeded (' + projected + '>' + cfg.tokenBudget + ')',
+          failure_reason: 'unexpected_error',
+        };
+      }
+    }
+
+    emit({ phase: 'panel-start', models: panelIds });
+    const panel  = await fanOut(prompt, panelIds, cfg, { fusionDepth: depth + 1, onProgress });
+    const ok     = panel.filter(p => p.ok);
+    const failed = panel.filter(p => !p.ok);
+
+    emit({ phase: 'panel-done', ok: ok.length, failed: failed.length });
+
+    if (ok.length === 0) {
+      return {
+        status: 'error',
+        mode: 'fusion',
+        preset: state.preset,
+        error: 'all panels failed',
+        failure_reason: classify(failed.map(toFailedModel)),
+      };
+    }
+
+    // Resolve judge/synth model (explicit flag -> preset override -> default)
+    // and hand the judge/synth stages a cfg pinned to those models, so a
+    // preset like gpt-duo runs entirely on its own provider.
+    const stageCfg = {
+      ...cfg,
+      judgeModel: resolveJudgeModel(state, cfg),
+      synthModel: resolveSynthModel(state, cfg),
+    };
+    emit({ phase: 'judge-start', model: stageCfg.judgeModel });
+    const analysis = await runJudge(prompt, ok, stageCfg);
+    emit({ phase: 'synth-start', model: stageCfg.synthModel });
+    let final = await runSynth(prompt, { analysis, responses: ok }, stageCfg);
+    if (!final) {
+      // synth-fail fallback: longest ok response
+      final = ok.reduce((a, b) => b.content.length > a.content.length ? b : a).content;
+    }
+
+    if (failed.length > 0 && ok.length > 0) {
+      emit({ phase: 'degraded', failed: failed.length });
+    }
+    emit({ phase: 'done', models: ok.length, ms: Date.now() - startMs });
+
+    const result = { status: 'ok', mode: 'fusion', preset: state.preset, final, responses: ok };
+    if (analysis !== undefined) result.analysis = analysis;
+    if (failed.length) result.failed_models = failed.map(toFailedModel);
+    return result;
+  }
+
+  // ---- UNKNOWN MODE ----
+  return { status: 'error', mode: state.mode, error: 'unknown mode', failure_reason: 'unexpected_error' };
+}
+
+module.exports = { runFrontier, canonicalModelId, canonicalPresetId, normalizeStateAliases };

package/frontier/schema.cjs

@@ -1,112 +1,112 @@
-#!/usr/bin/env node
-// Maestro Frontier — shared types-as-validators + helpers.
-// Zero deps, CJS. Ported stripLlmWrapper from scripts/compress.cjs.
-
-'use strict';
-
-/**
- * @typedef {{ model:string, content:string, ok:boolean, durationMs:number, tokensEst:number, toolCalls?:unknown[], error?:string }} PanelResponse
- * @typedef {{ model:string, reason:string }} FailedModel
- * @typedef {{ consensus:string[], contradictions:{topic:string,stances:{model:string,stance:string}[]}[], partial_coverage:{models:string[],point:string}[], unique_insights:{model:string,insight:string}[], blind_spots:string[] }} Analysis
- */
-
-/** @type {string[]} */
-const FAILURE_REASONS = [
-  'all_panels_failed',
-  'insufficient_credits',
-  'rate_limited',
-  'fusion_invocation_capped',
-  'unexpected_error',
-];
-
-/**
- * @param {unknown} x
- * @returns {x is PanelResponse}
- */
-function isPanelResponse(x) {
-  if (x === null || typeof x !== 'object') return false;
-  const o = /** @type {Record<string,unknown>} */ (x);
-  return (
-    typeof o.model === 'string' &&
-    typeof o.content === 'string' &&
-    typeof o.ok === 'boolean' &&
-    typeof o.durationMs === 'number' &&
-    typeof o.tokensEst === 'number'
-  );
-}
-
-/**
- * @param {unknown} x
- * @returns {x is Analysis}
- */
-function isAnalysis(x) {
-  if (x === null || typeof x !== 'object') return false;
-  const o = /** @type {Record<string,unknown>} */ (x);
-  if (!Array.isArray(o.consensus)) return false;
-  if (!o.consensus.every(s => typeof s === 'string')) return false;
-  if (!Array.isArray(o.blind_spots)) return false;
-  if (!o.blind_spots.every(s => typeof s === 'string')) return false;
-  if (!Array.isArray(o.contradictions)) return false;
-  if (!o.contradictions.every(e => e !== null && typeof e === 'object')) return false;
-  if (!Array.isArray(o.partial_coverage)) return false;
-  if (!o.partial_coverage.every(e => e !== null && typeof e === 'object')) return false;
-  if (!Array.isArray(o.unique_insights)) return false;
-  if (!o.unique_insights.every(e => e !== null && typeof e === 'object')) return false;
-  return true;
-}
-
-/**
- * @param {string} str
- * @returns {Analysis}
- * @throws {Error}
- */
-function parseAnalysis(str) {
-  let parsed;
-  try {
-    parsed = JSON.parse(str);
-  } catch (e) {
-    throw new Error('parseAnalysis: invalid JSON — ' + e.message);
-  }
-  if (!isAnalysis(parsed)) {
-    throw new Error('parseAnalysis: object does not satisfy Analysis shape');
-  }
-  return /** @type {Analysis} */ (parsed);
-}
-
-/**
- * @param {PanelResponse} panelResponse
- * @returns {FailedModel}
- */
-function toFailedModel(panelResponse) {
-  return { model: panelResponse.model, reason: panelResponse.error || 'unknown' };
-}
-
-/**
- * @param {FailedModel[]} failedModels
- * @returns {string}
- */
-function classify(failedModels) {
-  if (!failedModels || failedModels.length === 0) return 'all_panels_failed';
-  const combined = failedModels.map(f => f.reason || '').join(' ').toLowerCase();
-  if (/rate.?limit|429|too many request/.test(combined)) return 'rate_limited';
-  if (/insufficient|credit|quota|billing|payment|exceed.*(usage|plan)/.test(combined)) return 'insufficient_credits';
-  if (/enoent|spawn|signal|crash|killed/.test(combined)) return 'unexpected_error';
-  return 'all_panels_failed';
-}
-
-// Port VERBATIM from scripts/compress.cjs — strips an outer ```fence
-// wrapping the ENTIRE output.
-function stripLlmWrapper(text) {
-  const m = text.match(/^\s*(`{3,}|~{3,})[^\n]*\n([\s\S]*)\n\1\s*$/);
-  return m ? m[2] : text;
-}
-
-module.exports = {
-  FAILURE_REASONS,
-  isPanelResponse,
-  isAnalysis,
-  parseAnalysis,
-  toFailedModel,
-  classify,
-  stripLlmWrapper,
-};
+#!/usr/bin/env node
+// Maestro Frontier — shared types-as-validators + helpers.
+// Zero deps, CJS. Ported stripLlmWrapper from scripts/compress.cjs.
+
+'use strict';
+
+/**
+ * @typedef {{ model:string, content:string, ok:boolean, durationMs:number, tokensEst:number, toolCalls?:unknown[], error?:string }} PanelResponse
+ * @typedef {{ model:string, reason:string }} FailedModel
+ * @typedef {{ consensus:string[], contradictions:{topic:string,stances:{model:string,stance:string}[]}[], partial_coverage:{models:string[],point:string}[], unique_insights:{model:string,insight:string}[], blind_spots:string[] }} Analysis
+ */
+
+/** @type {string[]} */
+const FAILURE_REASONS = [
+  'all_panels_failed',
+  'insufficient_credits',
+  'rate_limited',
+  'fusion_invocation_capped',
+  'unexpected_error',
+];
+
+/**
+ * @param {unknown} x
+ * @returns {x is PanelResponse}
+ */
+function isPanelResponse(x) {
+  if (x === null || typeof x !== 'object') return false;
+  const o = /** @type {Record<string,unknown>} */ (x);
+  return (
+    typeof o.model === 'string' &&
+    typeof o.content === 'string' &&
+    typeof o.ok === 'boolean' &&
+    typeof o.durationMs === 'number' &&
+    typeof o.tokensEst === 'number'
+  );
+}
+
+/**
+ * @param {unknown} x
+ * @returns {x is Analysis}
+ */
+function isAnalysis(x) {
+  if (x === null || typeof x !== 'object') return false;
+  const o = /** @type {Record<string,unknown>} */ (x);
+  if (!Array.isArray(o.consensus)) return false;
+  if (!o.consensus.every(s => typeof s === 'string')) return false;
+  if (!Array.isArray(o.blind_spots)) return false;
+  if (!o.blind_spots.every(s => typeof s === 'string')) return false;
+  if (!Array.isArray(o.contradictions)) return false;
+  if (!o.contradictions.every(e => e !== null && typeof e === 'object')) return false;
+  if (!Array.isArray(o.partial_coverage)) return false;
+  if (!o.partial_coverage.every(e => e !== null && typeof e === 'object')) return false;
+  if (!Array.isArray(o.unique_insights)) return false;
+  if (!o.unique_insights.every(e => e !== null && typeof e === 'object')) return false;
+  return true;
+}
+
+/**
+ * @param {string} str
+ * @returns {Analysis}
+ * @throws {Error}
+ */
+function parseAnalysis(str) {
+  let parsed;
+  try {
+    parsed = JSON.parse(str);
+  } catch (e) {
+    throw new Error('parseAnalysis: invalid JSON — ' + e.message);
+  }
+  if (!isAnalysis(parsed)) {
+    throw new Error('parseAnalysis: object does not satisfy Analysis shape');
+  }
+  return /** @type {Analysis} */ (parsed);
+}
+
+/**
+ * @param {PanelResponse} panelResponse
+ * @returns {FailedModel}
+ */
+function toFailedModel(panelResponse) {
+  return { model: panelResponse.model, reason: panelResponse.error || 'unknown' };
+}
+
+/**
+ * @param {FailedModel[]} failedModels
+ * @returns {string}
+ */
+function classify(failedModels) {
+  if (!failedModels || failedModels.length === 0) return 'all_panels_failed';
+  const combined = failedModels.map(f => f.reason || '').join(' ').toLowerCase();
+  if (/rate.?limit|429|too many request/.test(combined)) return 'rate_limited';
+  if (/insufficient|credit|quota|billing|payment|exceed.*(usage|plan)/.test(combined)) return 'insufficient_credits';
+  if (/enoent|spawn|signal|crash|killed/.test(combined)) return 'unexpected_error';
+  return 'all_panels_failed';
+}
+
+// Port VERBATIM from scripts/compress.cjs — strips an outer ```fence
+// wrapping the ENTIRE output.
+function stripLlmWrapper(text) {
+  const m = text.match(/^\s*(`{3,}|~{3,})[^\n]*\n([\s\S]*)\n\1\s*$/);
+  return m ? m[2] : text;
+}
+
+module.exports = {
+  FAILURE_REASONS,
+  isPanelResponse,
+  isAnalysis,
+  parseAnalysis,
+  toFailedModel,
+  classify,
+  stripLlmWrapper,
+};