@maestrofrontier/frontier 1.4.4 → 1.5.0

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,
+};

package/frontier/semaphore.cjs

@@ -1,49 +1,49 @@
-#!/usr/bin/env node
-// Maestro Frontier — bounded-concurrency map utility.
-// mapLimit(items, limit, asyncFn) -> Promise<settled[]>
-// Each settled item is {ok:true,value} or {ok:false,error}.
-// A rejected task releases its permit and does NOT starve the pool.
-
-'use strict';
-
-/**
- * @template T, R
- * @param {T[]} items
- * @param {number} limit
- * @param {(item: T, index: number) => Promise<R>} asyncFn
- * @returns {Promise<({ok:true,value:R}|{ok:false,error:unknown})[]}
- */
-function mapLimit(items, limit, asyncFn) {
-  return new Promise((resolve) => {
-    const n = items.length;
-    if (n === 0) { resolve([]); return; }
-
-    const results = new Array(n);
-    let nextIdx = 0;   // index of next item to start
-    let inFlight = 0;  // currently running tasks
-    let done = 0;      // settled tasks
-
-    function run() {
-      while (inFlight < limit && nextIdx < n) {
-        const idx = nextIdx++;
-        inFlight++;
-        Promise.resolve()
-          .then(() => asyncFn(items[idx], idx))
-          .then(
-            (value) => { results[idx] = { ok: true, value }; },
-            (error) => { results[idx] = { ok: false, error }; }
-          )
-          .finally(() => {
-            inFlight--;
-            done++;
-            if (done === n) { resolve(results); return; }
-            run();
-          });
-      }
-    }
-
-    run();
-  });
-}
-
-module.exports = { mapLimit };
+#!/usr/bin/env node
+// Maestro Frontier — bounded-concurrency map utility.
+// mapLimit(items, limit, asyncFn) -> Promise<settled[]>
+// Each settled item is {ok:true,value} or {ok:false,error}.
+// A rejected task releases its permit and does NOT starve the pool.
+
+'use strict';
+
+/**
+ * @template T, R
+ * @param {T[]} items
+ * @param {number} limit
+ * @param {(item: T, index: number) => Promise<R>} asyncFn
+ * @returns {Promise<({ok:true,value:R}|{ok:false,error:unknown})[]}
+ */
+function mapLimit(items, limit, asyncFn) {
+  return new Promise((resolve) => {
+    const n = items.length;
+    if (n === 0) { resolve([]); return; }
+
+    const results = new Array(n);
+    let nextIdx = 0;   // index of next item to start
+    let inFlight = 0;  // currently running tasks
+    let done = 0;      // settled tasks
+
+    function run() {
+      while (inFlight < limit && nextIdx < n) {
+        const idx = nextIdx++;
+        inFlight++;
+        Promise.resolve()
+          .then(() => asyncFn(items[idx], idx))
+          .then(
+            (value) => { results[idx] = { ok: true, value }; },
+            (error) => { results[idx] = { ok: false, error }; }
+          )
+          .finally(() => {
+            inFlight--;
+            done++;
+            if (done === n) { resolve(results); return; }
+            run();
+          });
+      }
+    }
+
+    run();
+  });
+}
+
+module.exports = { mapLimit };

package/frontier/synthesize.cjs

@@ -1,79 +1,79 @@
-#!/usr/bin/env node
-// Maestro Frontier — synthesis stage: build prompt + invoke Opus for final answer.
-
-'use strict';
-
-const dispatch = require('./dispatch.cjs');
-
-/**
- * Build the synthesis prompt for Opus.
- * @param {string} userPrompt
- * @param {{ analysis?: import('./schema.cjs').Analysis, responses: import('./schema.cjs').PanelResponse[] }} bundle
- * @param {object} cfg
- * @returns {string}
- */
-function buildSynthPrompt(userPrompt, bundle, cfg) {
-  const antiMajority =
-    'Do NOT majority-vote or pick the most common answer; weigh correctness and evidence — ' +
-    'a single correct minority response outweighs a popular wrong one.';
-
-  let groundingSection;
-  if (bundle.analysis) {
-    groundingSection =
-      `PANEL ANALYSIS (structured):
-${JSON.stringify(bundle.analysis, null, 2)}
-
-Ground your final answer in this analysis:
-- Adopt the consensus points as established facts.
-- RESOLVE contradictions by reasoning about which stance is most correct; do not dodge them.
-- Preserve unique insights that add value.
-- Address any blind spots the analysis identified.`;
-  } else {
-    const raw = bundle.responses.map(
-      r => `### Response from ${r.model}\n${r.content}`
-    ).join('\n\n');
-    groundingSection =
-      `RAW PANEL RESPONSES:
-${raw}
-
-Ground your final answer in these responses.`;
-  }
-
-  return `You are a SYNTHESIZER producing the definitive final answer to a user question.
-
-USER QUESTION:
-${userPrompt}
-
-${groundingSection}
-
-IMPORTANT: ${antiMajority}
-
-Write the final answer as clear, direct prose. No JSON, no meta-commentary, no preamble about your process. Output the answer only.`;
-}
-
-/**
- * Run the synthesis stage. Returns the final answer string or '' on failure (degrades gracefully).
- * @param {string} userPrompt
- * @param {{ analysis?: import('./schema.cjs').Analysis, responses: import('./schema.cjs').PanelResponse[] }} bundle
- * @param {object} cfg
- * @param {{ spawn?: Function }} [deps]
- * @returns {Promise<string>}
- */
-async function runSynth(userPrompt, bundle, cfg, deps) {
-  const spawn = (deps && deps.spawn) || dispatch.spawnOne;
-  let r;
-  try {
-    r = await spawn(
-      buildSynthPrompt(userPrompt, bundle, cfg),
-      cfg.adapters[cfg.synthModel],
-      { timeoutMs: cfg.timeoutMs, fusionDepth: 1 }
-    );
-  } catch {
-    return '';
-  }
-
-  if (r && r.ok && r.content) return r.content;
-  return '';
-}
-
-module.exports = { buildSynthPrompt, runSynth };
+#!/usr/bin/env node
+// Maestro Frontier — synthesis stage: build prompt + invoke Opus for final answer.
+
+'use strict';
+
+const dispatch = require('./dispatch.cjs');
+
+/**
+ * Build the synthesis prompt for Opus.
+ * @param {string} userPrompt
+ * @param {{ analysis?: import('./schema.cjs').Analysis, responses: import('./schema.cjs').PanelResponse[] }} bundle
+ * @param {object} cfg
+ * @returns {string}
+ */
+function buildSynthPrompt(userPrompt, bundle, cfg) {
+  const antiMajority =
+    'Do NOT majority-vote or pick the most common answer; weigh correctness and evidence — ' +
+    'a single correct minority response outweighs a popular wrong one.';
+
+  let groundingSection;
+  if (bundle.analysis) {
+    groundingSection =
+      `PANEL ANALYSIS (structured):
+${JSON.stringify(bundle.analysis, null, 2)}
+
+Ground your final answer in this analysis:
+- Adopt the consensus points as established facts.
+- RESOLVE contradictions by reasoning about which stance is most correct; do not dodge them.
+- Preserve unique insights that add value.
+- Address any blind spots the analysis identified.`;
+  } else {
+    const raw = bundle.responses.map(
+      r => `### Response from ${r.model}\n${r.content}`
+    ).join('\n\n');
+    groundingSection =
+      `RAW PANEL RESPONSES:
+${raw}
+
+Ground your final answer in these responses.`;
+  }
+
+  return `You are a SYNTHESIZER producing the definitive final answer to a user question.
+
+USER QUESTION:
+${userPrompt}
+
+${groundingSection}
+
+IMPORTANT: ${antiMajority}
+
+Write the final answer as clear, direct prose. No JSON, no meta-commentary, no preamble about your process. Output the answer only.`;
+}
+
+/**
+ * Run the synthesis stage. Returns the final answer string or '' on failure (degrades gracefully).
+ * @param {string} userPrompt
+ * @param {{ analysis?: import('./schema.cjs').Analysis, responses: import('./schema.cjs').PanelResponse[] }} bundle
+ * @param {object} cfg
+ * @param {{ spawn?: Function }} [deps]
+ * @returns {Promise<string>}
+ */
+async function runSynth(userPrompt, bundle, cfg, deps) {
+  const spawn = (deps && deps.spawn) || dispatch.spawnOne;
+  let r;
+  try {
+    r = await spawn(
+      buildSynthPrompt(userPrompt, bundle, cfg),
+      cfg.adapters[cfg.synthModel],
+      { timeoutMs: cfg.timeoutMs, fusionDepth: 1 }
+    );
+  } catch {
+    return '';
+  }
+
+  if (r && r.ok && r.content) return r.content;
+  return '';
+}
+
+module.exports = { buildSynthPrompt, runSynth };