@damian87/omp 0.2.0 → 0.4.0

package/dist/src/council/config.d.ts

@@ -0,0 +1,32 @@
+import type { CouncilMemberSpec, CouncilTaskSpec, ResolvedCouncilConfig } from "./types.js";
+export declare const DEFAULT_MIN_SURVIVORS = 2;
+export declare const DEFAULT_PER_MEMBER_TIMEOUT_MS = 120000;
+export declare const DEFAULT_MAX_CONCURRENCY = 4;
+/**
+ * Built-in default roster. Uses the free/included lightweight models verified
+ * available via the Task 0 spike (gpt-5-mini, gpt-4.1) so the council runs
+ * without consuming premium model quota. Users override these in
+ * .omp/config.json `council` or inline via --models (e.g. add a Claude member
+ * for cross-provider diversity if their plan includes it).
+ */
+export declare const DEFAULT_MEMBERS: CouncilMemberSpec[];
+export declare const DEFAULT_SYNTHESIZER = "gpt-4.1";
+interface PartialCouncilFileConfig {
+    members?: unknown;
+    synthesizer?: unknown;
+    minSurvivors?: unknown;
+    perMemberTimeoutMs?: unknown;
+    maxConcurrency?: unknown;
+    probe?: unknown;
+}
+export interface LoadCouncilConfigOptions {
+    cwd?: string;
+}
+/** Read the `council` block from .omp/config.json; tolerate missing/malformed. */
+export declare function readCouncilFileConfig(options?: LoadCouncilConfigOptions): PartialCouncilFileConfig;
+/**
+ * Resolve the effective council configuration.
+ * Precedence: spec override > .omp/config.json council block > built-in default.
+ */
+export declare function loadCouncilConfig(spec?: CouncilTaskSpec, options?: LoadCouncilConfigOptions): ResolvedCouncilConfig;
+export {};

package/dist/src/council/config.js

@@ -0,0 +1,84 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+export const DEFAULT_MIN_SURVIVORS = 2;
+export const DEFAULT_PER_MEMBER_TIMEOUT_MS = 120000;
+export const DEFAULT_MAX_CONCURRENCY = 4;
+/**
+ * Built-in default roster. Uses the free/included lightweight models verified
+ * available via the Task 0 spike (gpt-5-mini, gpt-4.1) so the council runs
+ * without consuming premium model quota. Users override these in
+ * .omp/config.json `council` or inline via --models (e.g. add a Claude member
+ * for cross-provider diversity if their plan includes it).
+ */
+export const DEFAULT_MEMBERS = [
+    { model: "gpt-5-mini", role: "critic", weight: 0.4 },
+    { model: "gpt-4.1", role: "architect", weight: 0.35 },
+    { model: "gpt-5-mini", role: "pragmatist", weight: 0.25 },
+];
+export const DEFAULT_SYNTHESIZER = "gpt-4.1";
+function isValidMember(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const m = value;
+    return (typeof m.model === "string" &&
+        m.model.length > 0 &&
+        typeof m.role === "string" &&
+        m.role.length > 0 &&
+        typeof m.weight === "number" &&
+        Number.isFinite(m.weight) &&
+        m.weight > 0);
+}
+/** Read the `council` block from .omp/config.json; tolerate missing/malformed. */
+export function readCouncilFileConfig(options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    const configFile = join(cwd, ".omp", "config.json");
+    if (!existsSync(configFile))
+        return {};
+    try {
+        const parsed = JSON.parse(readFileSync(configFile, "utf8"));
+        return parsed.council ?? {};
+    }
+    catch {
+        return {}; // unreadable/invalid config -> treat as absent
+    }
+}
+/**
+ * Resolve the effective council configuration.
+ * Precedence: spec override > .omp/config.json council block > built-in default.
+ */
+export function loadCouncilConfig(spec = { question: "" }, options = {}) {
+    const file = readCouncilFileConfig(options);
+    const fileMembers = Array.isArray(file.members)
+        ? file.members.filter(isValidMember)
+        : [];
+    const members = spec.members && spec.members.length > 0
+        ? spec.members
+        : fileMembers.length > 0
+            ? fileMembers
+            : DEFAULT_MEMBERS;
+    const synthesizerModel = spec.synthesizerModel ??
+        (typeof file.synthesizer === "string" && file.synthesizer.length > 0
+            ? file.synthesizer
+            : DEFAULT_SYNTHESIZER);
+    const minSurvivors = spec.minSurvivors ??
+        (typeof file.minSurvivors === "number" ? file.minSurvivors : DEFAULT_MIN_SURVIVORS);
+    const perMemberTimeoutMs = spec.perMemberTimeoutMs ??
+        (typeof file.perMemberTimeoutMs === "number"
+            ? file.perMemberTimeoutMs
+            : DEFAULT_PER_MEMBER_TIMEOUT_MS);
+    const maxConcurrency = spec.maxConcurrency ??
+        (typeof file.maxConcurrency === "number"
+            ? file.maxConcurrency
+            : DEFAULT_MAX_CONCURRENCY);
+    // probe precedence: spec.probe ?? config.probe ?? false
+    const probe = spec.probe ?? (typeof file.probe === "boolean" ? file.probe : false);
+    return {
+        members,
+        synthesizerModel,
+        minSurvivors,
+        perMemberTimeoutMs,
+        maxConcurrency: maxConcurrency > 0 ? maxConcurrency : DEFAULT_MAX_CONCURRENCY,
+        probe,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/src/council/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/council/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAOjC,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC;AACvC,MAAM,CAAC,MAAM,6BAA6B,GAAG,MAAM,CAAC;AACpD,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC;AAEzC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,eAAe,GAAwB;IAClD,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE;IACpD,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE;IACrD,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE;CAC1D,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG,SAAS,CAAC;AAe7C,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,OAAO,CACL,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ;QAC3B,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;QAClB,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ;QAC1B,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;QACjB,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ;QAC5B,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;QACzB,CAAC,CAAC,MAAM,GAAG,CAAC,CACb,CAAC;AACJ,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,qBAAqB,CACnC,UAAoC,EAAE;IAEtC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACzC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC;IACpD,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,EAAE,CAAC;IACvC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAEzD,CAAC;QACF,OAAO,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC,CAAC,+CAA+C;IAC5D,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAwB,EAAE,QAAQ,EAAE,EAAE,EAAE,EACxC,UAAoC,EAAE;IAEtC,MAAM,IAAI,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAE5C,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;QAC7C,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC;QACpC,CAAC,CAAC,EAAE,CAAC;IAEP,MAAM,OAAO,GACX,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;QACrC,CAAC,CAAC,IAAI,CAAC,OAAO;QACd,CAAC,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC;YACtB,CAAC,CAAC,WAAW;YACb,CAAC,CAAC,eAAe,CAAC;IAExB,MAAM,gBAAgB,GACpB,IAAI,CAAC,gBAAgB;QACrB,CAAC,OAAO,IAAI,CAAC,WAAW,KAAK,QAAQ,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC;YAClE,CAAC,CAAC,IAAI,CAAC,WAAW;YAClB,CAAC,CAAC,mBAAmB,CAAC,CAAC;IAE3B,MAAM,YAAY,GAChB,IAAI,CAAC,YAAY;QACjB,CAAC,OAAO,IAAI,CAAC,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC;IAEtF,MAAM,kBAAkB,GACtB,IAAI,CAAC,kBAAkB;QACvB,CAAC,OAAO,IAAI,CAAC,kBAAkB,KAAK,QAAQ;YAC1C,CAAC,CAAC,IAAI,CAAC,kBAAkB;YACzB,CAAC,CAAC,6BAA6B,CAAC,CAAC;IAErC,MAAM,cAAc,GAClB,IAAI,CAAC,cAAc;QACnB,CAAC,OAAO,IAAI,CAAC,cAAc,KAAK,QAAQ;YACtC,CAAC,CAAC,IAAI,CAAC,cAAc;YACrB,CAAC,CAAC,uBAAuB,CAAC,CAAC;IAE/B,wDAAwD;IACxD,MAAM,KAAK,GACT,IAAI,CAAC,KAAK,IAAI,CAAC,OAAO,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAEvE,OAAO;QACL,OAAO;QACP,gBAAgB;QAChB,YAAY;QACZ,kBAAkB;QAClB,cAAc,EAAE,cAAc,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,uBAAuB;QAC7E,KAAK;KACN,CAAC;AACJ,CAAC"}

package/dist/src/council/engine.d.ts

@@ -0,0 +1,19 @@
+import { type LoadCouncilConfigOptions } from "./config.js";
+import type { CouncilDeps, CouncilRunResult, CouncilTaskSpec } from "./types.js";
+/**
+ * Run `worker` over `items` with at most `limit` in flight. The slot is released
+ * in a finally block so a rejected/errored worker frees its slot too (otherwise
+ * a rejection would deadlock the queue for subsequent items). Results preserve
+ * input order. Worker rejections are reflected as rejected result promises, so
+ * callers should make `worker` non-throwing (we do).
+ */
+export declare function runWithConcurrency<T, R>(items: T[], limit: number, worker: (item: T, index: number) => Promise<R>): Promise<R[]>;
+export interface RunCouncilOptions extends LoadCouncilConfigOptions {
+}
+/**
+ * Fan a question out to the council, parse + classify each member, then
+ * synthesize from survivors. Degrades gracefully: drops timed-out / unavailable /
+ * errored / unparseable members and synthesizes from the rest; fails only if
+ * fewer than `minSurvivors` survive.
+ */
+export declare function runCouncil(spec: CouncilTaskSpec, deps: CouncilDeps, options?: RunCouncilOptions): Promise<CouncilRunResult>;

package/dist/src/council/engine.js

@@ -0,0 +1,193 @@
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { loadCouncilConfig } from "./config.js";
+import { buildMemberPrompt, parseMemberOutput } from "./prompts.js";
+import { synthesize } from "./synth.js";
+/** stderr signature emitted by copilot when a --model slug is not entitled. */
+const UNAVAILABLE_SIGNATURE = /is not available/i;
+function isUnavailable(res) {
+    return res.exitCode !== 0 && !res.timedOut && UNAVAILABLE_SIGNATURE.test(res.stderr);
+}
+/**
+ * Run `worker` over `items` with at most `limit` in flight. The slot is released
+ * in a finally block so a rejected/errored worker frees its slot too (otherwise
+ * a rejection would deadlock the queue for subsequent items). Results preserve
+ * input order. Worker rejections are reflected as rejected result promises, so
+ * callers should make `worker` non-throwing (we do).
+ */
+export async function runWithConcurrency(items, limit, worker) {
+    const results = new Array(items.length);
+    let next = 0;
+    const effectiveLimit = Math.max(1, Math.min(limit, items.length || 1));
+    async function runner() {
+        while (true) {
+            const current = next++;
+            if (current >= items.length)
+                return;
+            try {
+                results[current] = await worker(items[current], current);
+            }
+            finally {
+                // slot is freed simply by looping to the next item
+            }
+        }
+    }
+    const runners = [];
+    for (let i = 0; i < effectiveLimit; i++)
+        runners.push(runner());
+    await Promise.all(runners);
+    return results;
+}
+function classify(res) {
+    if (res.timedOut)
+        return { status: "timeout", dropReason: "member timed out" };
+    if (isUnavailable(res)) {
+        return { status: "unavailable", dropReason: "model not available to this Copilot plan" };
+    }
+    if (res.exitCode !== 0) {
+        return { status: "error", dropReason: `member exited ${res.exitCode}` };
+    }
+    return { status: "ok" };
+}
+async function runMember(spec, index, taskSpec, config, deps, tmpDir) {
+    const prompt = buildMemberPrompt(taskSpec, spec);
+    const started = (deps.now ?? Date.now)();
+    let res;
+    try {
+        res = await deps.spawn({ model: spec.model, prompt, timeoutMs: config.perMemberTimeoutMs });
+    }
+    catch (err) {
+        return {
+            spec,
+            status: "error",
+            durationMs: 0,
+            dropReason: `spawn failed: ${String(err)}`,
+        };
+    }
+    const durationMs = (deps.now ?? Date.now)() - started;
+    let { status, dropReason } = classify(res);
+    let output;
+    if (status === "ok") {
+        const parsed = parseMemberOutput(res.stdout);
+        if (parsed) {
+            output = parsed;
+        }
+        else {
+            status = "unparseable";
+            dropReason = "no schema-valid JSON in output";
+        }
+    }
+    const jsonPath = join(tmpDir, `m${index}.json`);
+    const artifact = output ?? { rawStdout: res.stdout, rawStderr: res.stderr, status };
+    if (deps.writeArtifact) {
+        try {
+            deps.writeArtifact(jsonPath, JSON.stringify(artifact, null, 2));
+        }
+        catch {
+            // artifact write is best-effort; ignore failures
+        }
+    }
+    return {
+        spec,
+        status,
+        output,
+        rawStdout: res.stdout,
+        rawStderr: res.stderr,
+        exitCode: res.exitCode,
+        durationMs,
+        dropReason,
+        jsonPath,
+    };
+}
+/**
+ * Opt-in preflight probe: cheaply ping each DISTINCT model and prune only those
+ * that report "unavailable" (exit + stderr signature). A slow/timed-out probe is
+ * NOT treated as unavailable, so reachable-but-slow models are kept.
+ */
+async function probeRoster(members, config, deps) {
+    const distinct = Array.from(new Set(members.map((m) => m.model)));
+    const probeTimeout = Math.min(15000, config.perMemberTimeoutMs);
+    const verdicts = await runWithConcurrency(distinct, config.maxConcurrency, async (model) => {
+        try {
+            const res = await deps.spawn({ model, prompt: "Reply with: ok", timeoutMs: probeTimeout });
+            return { model, unavailable: isUnavailable(res) };
+        }
+        catch {
+            return { model, unavailable: false }; // spawn error != entitlement problem
+        }
+    });
+    const unavailable = new Set(verdicts.filter((v) => v.unavailable).map((v) => v.model));
+    const kept = members.filter((m) => !unavailable.has(m.model));
+    const pruned = members
+        .filter((m) => unavailable.has(m.model))
+        .map((m) => ({ model: m.model, reason: "model not available to this Copilot plan" }));
+    return { kept, pruned };
+}
+/**
+ * Fan a question out to the council, parse + classify each member, then
+ * synthesize from survivors. Degrades gracefully: drops timed-out / unavailable /
+ * errored / unparseable members and synthesizes from the rest; fails only if
+ * fewer than `minSurvivors` survive.
+ */
+export async function runCouncil(spec, deps, options = {}) {
+    const config = loadCouncilConfig(spec, options);
+    const now = deps.now ?? Date.now;
+    const tmpDir = spec.tmpDir ?? join(tmpdir(), `council-${now()}`);
+    let roster = config.members;
+    const prunedResults = [];
+    if (config.probe) {
+        const { kept, pruned } = await probeRoster(roster, config, deps);
+        roster = kept;
+        for (const p of pruned) {
+            const spc = config.members.find((m) => m.model === p.model);
+            if (spc) {
+                prunedResults.push({
+                    spec: spc,
+                    status: "unavailable",
+                    durationMs: 0,
+                    dropReason: p.reason,
+                });
+            }
+        }
+    }
+    const ran = await runWithConcurrency(roster, config.maxConcurrency, (member, i) => runMember(member, i, spec, config, deps, tmpDir));
+    const members = [...ran, ...prunedResults];
+    const survivors = members.filter((m) => m.status === "ok");
+    const dropped = members.length - survivors.length;
+    if (survivors.length < config.minSurvivors) {
+        const unavailableModels = members
+            .filter((m) => m.status === "unavailable")
+            .map((m) => m.spec.model);
+        const detail = unavailableModels.length > 0
+            ? ` Unavailable models: ${unavailableModels.join(", ")}.`
+            : "";
+        return {
+            ok: false,
+            members,
+            survivors: survivors.length,
+            dropped,
+            tmpDir,
+            error: `too few surviving members (${survivors.length}/${config.minSurvivors}).${detail}`,
+        };
+    }
+    const synthResult = await synthesize(config, spec, members, deps);
+    if (!synthResult.ok || !synthResult.synth) {
+        return {
+            ok: false,
+            members,
+            survivors: survivors.length,
+            dropped,
+            tmpDir,
+            error: synthResult.error ?? "synthesis failed",
+        };
+    }
+    return {
+        ok: true,
+        synth: synthResult.synth,
+        members,
+        survivors: survivors.length,
+        dropped,
+        tmpDir,
+    };
+}
+//# sourceMappingURL=engine.js.map

package/dist/src/council/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../../src/council/engine.ts"],"names":[],"mappings":"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"}

package/dist/src/council/index.d.ts

@@ -0,0 +1,20 @@
+import { type RunCouncilOptions } from "./engine.js";
+import type { CouncilDeps, CouncilRunResult, CouncilSpawn, CouncilTaskSpec } from "./types.js";
+export * from "./types.js";
+export { loadCouncilConfig, readCouncilFileConfig, DEFAULT_MEMBERS, DEFAULT_SYNTHESIZER, DEFAULT_MIN_SURVIVORS, DEFAULT_PER_MEMBER_TIMEOUT_MS, DEFAULT_MAX_CONCURRENCY, } from "./config.js";
+export { buildMemberPrompt, buildSynthPrompt, parseMemberOutput, parseSynthOutput, extractJsonCandidates, balancedBlocks, isValidMemberOutput, isValidSynthOutput, } from "./prompts.js";
+export { runCouncil, runWithConcurrency } from "./engine.js";
+export { synthesize } from "./synth.js";
+/**
+ * Default member invoker: spawn `copilot --model <model> -p <prompt> --allow-all-tools`
+ * with PIPED stdio so we can capture stdout. Uses resolveCopilotBin() so the
+ * OMP_COPILOT_BIN stub-bin test seam works. Does NOT route through launchCopilot
+ * (that tmux-wraps and inherits stdio, which would discard the model's output).
+ */
+export declare function createDefaultSpawn(bin?: string): CouncilSpawn;
+/** Default deps: real spawn + fs artifact writer (mkdir -p on demand). */
+export declare function createDefaultDeps(bin?: string): CouncilDeps;
+/** Convenience entry for the CLI: run the council with the real default deps. */
+export declare function runCouncilWithDefaults(spec: CouncilTaskSpec, options?: RunCouncilOptions & {
+    bin?: string;
+}): Promise<CouncilRunResult>;

package/dist/src/council/index.js

@@ -0,0 +1,72 @@
+import { spawn } from "node:child_process";
+import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+import { resolveCopilotBin } from "../copilot/launch.js";
+import { runCouncil } from "./engine.js";
+export * from "./types.js";
+export { loadCouncilConfig, readCouncilFileConfig, DEFAULT_MEMBERS, DEFAULT_SYNTHESIZER, DEFAULT_MIN_SURVIVORS, DEFAULT_PER_MEMBER_TIMEOUT_MS, DEFAULT_MAX_CONCURRENCY, } from "./config.js";
+export { buildMemberPrompt, buildSynthPrompt, parseMemberOutput, parseSynthOutput, extractJsonCandidates, balancedBlocks, isValidMemberOutput, isValidSynthOutput, } from "./prompts.js";
+export { runCouncil, runWithConcurrency } from "./engine.js";
+export { synthesize } from "./synth.js";
+/**
+ * Default member invoker: spawn `copilot --model <model> -p <prompt> --allow-all-tools`
+ * with PIPED stdio so we can capture stdout. Uses resolveCopilotBin() so the
+ * OMP_COPILOT_BIN stub-bin test seam works. Does NOT route through launchCopilot
+ * (that tmux-wraps and inherits stdio, which would discard the model's output).
+ */
+export function createDefaultSpawn(bin) {
+    const copilotBin = resolveCopilotBin(bin);
+    return (req) => new Promise((resolveFn) => {
+        const child = spawn(copilotBin, ["--model", req.model, "-p", req.prompt, "--allow-all-tools"], { stdio: ["ignore", "pipe", "pipe"] });
+        let stdout = "";
+        let stderr = "";
+        let timedOut = false;
+        let settled = false;
+        const timer = setTimeout(() => {
+            timedOut = true;
+            child.kill("SIGTERM");
+        }, req.timeoutMs);
+        child.stdout?.on("data", (d) => {
+            stdout += d.toString();
+        });
+        child.stderr?.on("data", (d) => {
+            stderr += d.toString();
+        });
+        child.on("error", () => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            resolveFn({ stdout, stderr, exitCode: 127, timedOut });
+        });
+        child.on("close", (code) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            resolveFn({
+                stdout,
+                stderr,
+                exitCode: typeof code === "number" ? code : timedOut ? 124 : 1,
+                timedOut,
+            });
+        });
+    });
+}
+/** Default deps: real spawn + fs artifact writer (mkdir -p on demand). */
+export function createDefaultDeps(bin) {
+    return {
+        spawn: createDefaultSpawn(bin),
+        now: () => Date.now(),
+        writeArtifact: (path, data) => {
+            mkdirSync(dirname(path), { recursive: true });
+            writeFileSync(path, data, "utf8");
+        },
+    };
+}
+/** Convenience entry for the CLI: run the council with the real default deps. */
+export async function runCouncilWithDefaults(spec, options = {}) {
+    const { bin, ...rest } = options;
+    return runCouncil(spec, createDefaultDeps(bin), rest);
+}
+//# sourceMappingURL=index.js.map

package/dist/src/council/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/council/index.ts"],"names":[],"mappings":"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"}

package/dist/src/council/prompts.d.ts

@@ -0,0 +1,32 @@
+import type { CouncilMemberOutput, CouncilMemberResult, CouncilMemberSpec, CouncilSynthOutput, CouncilTaskSpec, ResolvedCouncilConfig } from "./types.js";
+/**
+ * Build a concise member prompt. Role is injected via {{COUNCIL_ROLE}}.
+ * Members are told to wrap their JSON in sentinels so the engine can extract it
+ * reliably from fence/banner noise (verified necessary in the Task 0 spike).
+ * NOTE: sentinels are NOT a security boundary — a hostile --context could embed
+ * the markers; the engine schema-validates extracted blocks to mitigate.
+ */
+export declare function buildMemberPrompt(spec: CouncilTaskSpec, member: CouncilMemberSpec): string;
+/** Build the low-context synthesizer prompt from surviving members. */
+export declare function buildSynthPrompt(config: ResolvedCouncilConfig, spec: CouncilTaskSpec, survivors: CouncilMemberResult[]): string;
+/**
+ * Enumerate top-level balanced {...} blocks in text (brace-depth scan).
+ * Returns the raw substrings in order of appearance.
+ */
+export declare function balancedBlocks(text: string): string[];
+/**
+ * Extract candidate JSON strings from raw stdout. Sentinel-wrapped content is
+ * preferred (primary contract); otherwise fall back to all balanced {...} blocks.
+ */
+export declare function extractJsonCandidates(stdout: string): string[];
+export declare function isValidMemberOutput(value: unknown): value is CouncilMemberOutput;
+export declare function isValidSynthOutput(value: unknown): value is CouncilSynthOutput;
+/**
+ * Parse a member's stdout into a validated CouncilMemberOutput.
+ * Strategy: enumerate candidate blocks, JSON.parse each, return the FIRST that
+ * passes schema validation. Tie-break = schema validity, not size/position.
+ * Returns null when no candidate validates (caller marks "unparseable").
+ */
+export declare function parseMemberOutput(stdout: string): CouncilMemberOutput | null;
+/** Parse the synthesizer's stdout into a validated CouncilSynthOutput. */
+export declare function parseSynthOutput(stdout: string): CouncilSynthOutput | null;

package/dist/src/council/prompts.js

@@ -0,0 +1,173 @@
+const SENTINEL_START = "<<<JSON>>>";
+const SENTINEL_END = "<<<END>>>";
+/**
+ * Build a concise member prompt. Role is injected via {{COUNCIL_ROLE}}.
+ * Members are told to wrap their JSON in sentinels so the engine can extract it
+ * reliably from fence/banner noise (verified necessary in the Task 0 spike).
+ * NOTE: sentinels are NOT a security boundary — a hostile --context could embed
+ * the markers; the engine schema-validates extracted blocks to mitigate.
+ */
+export function buildMemberPrompt(spec, member) {
+    const role = member.role;
+    const parts = [];
+    parts.push(`You are acting as the ${role} on an independent review council. ` +
+        `Bring YOUR OWN angle as the ${role}; you cannot see other members' answers.`);
+    parts.push(`Question: ${spec.question}`);
+    if (spec.context && spec.context.trim().length > 0) {
+        parts.push(`Context:\n${spec.context}`);
+    }
+    if (spec.rubric && spec.rubric.trim().length > 0) {
+        parts.push(`Evaluation rubric:\n${spec.rubric}`);
+    }
+    parts.push(`Respond with ONLY a JSON object wrapped EXACTLY in ${SENTINEL_START} and ${SENTINEL_END} markers, ` +
+        `no prose outside them. Shape: ` +
+        `${SENTINEL_START}{"verdict":"<short answer>","confidence":<0..1>,"rationale":"<concise, evidence-first>","risks":["..."],"dissent":"<where you expect to disagree>"}${SENTINEL_END}`);
+    return parts.join("\n\n");
+}
+/** Build the low-context synthesizer prompt from surviving members. */
+export function buildSynthPrompt(config, spec, survivors) {
+    const memberBlocks = survivors
+        .map((r, i) => {
+        const o = r.output;
+        return (`Member ${i + 1} [role=${r.spec.role}, model=${r.spec.model}, weight=${r.spec.weight}]:\n` +
+            `  verdict: ${o.verdict}\n` +
+            `  confidence: ${o.confidence}\n` +
+            `  rationale: ${o.rationale}` +
+            (o.risks && o.risks.length ? `\n  risks: ${o.risks.join("; ")}` : "") +
+            (o.dissent ? `\n  dissent: ${o.dissent}` : ""));
+    })
+        .join("\n\n");
+    return [
+        `You are the synthesizer for a model council. Original question: ${spec.question}`,
+        spec.context ? `Shared context:\n${spec.context}` : "",
+        `Council members (independent, did not see each other):\n\n${memberBlocks}`,
+        `Treat each member's weight as a PRIOR/hint (e.g. trust the higher-weight member more), ` +
+            `but let EVIDENCE QUALITY override weight — do NOT do a simple majority vote or average. ` +
+            `Surface any well-reasoned dissent as a minority report so dangerous edge cases are not voted away.`,
+        `Respond with ONLY a JSON object wrapped EXACTLY in ${SENTINEL_START} and ${SENTINEL_END}. Shape: ` +
+            `${SENTINEL_START}{"verdict":"<final>","confidence":<0..1>,"rationale":"<your reasoning>","minority_report":"<notable dissent or empty string>",` +
+            `"per_member_summary":[{"model":"...","role":"...","weight":<n>,"verdict":"...","confidence":<0..1>,"dropped":false}]}${SENTINEL_END}`,
+    ]
+        .filter((s) => s.length > 0)
+        .join("\n\n");
+}
+/**
+ * Enumerate top-level balanced {...} blocks in text (brace-depth scan).
+ * Returns the raw substrings in order of appearance.
+ */
+export function balancedBlocks(text) {
+    const blocks = [];
+    let depth = 0;
+    let start = -1;
+    let inString = false;
+    let escaped = false;
+    for (let i = 0; i < text.length; i++) {
+        const ch = text[i];
+        if (inString) {
+            if (escaped) {
+                escaped = false;
+            }
+            else if (ch === "\\") {
+                escaped = true;
+            }
+            else if (ch === '"') {
+                inString = false;
+            }
+            continue;
+        }
+        if (ch === '"') {
+            inString = true;
+        }
+        else if (ch === "{") {
+            if (depth === 0)
+                start = i;
+            depth++;
+        }
+        else if (ch === "}") {
+            if (depth > 0) {
+                depth--;
+                if (depth === 0 && start >= 0) {
+                    blocks.push(text.slice(start, i + 1));
+                    start = -1;
+                }
+            }
+        }
+    }
+    return blocks;
+}
+/**
+ * Extract candidate JSON strings from raw stdout. Sentinel-wrapped content is
+ * preferred (primary contract); otherwise fall back to all balanced {...} blocks.
+ */
+export function extractJsonCandidates(stdout) {
+    const candidates = [];
+    const sentinelRe = new RegExp(`${SENTINEL_START}([\\s\\S]*?)${SENTINEL_END}`, "g");
+    let match;
+    while ((match = sentinelRe.exec(stdout)) !== null) {
+        candidates.push(match[1].trim());
+    }
+    // Fallback: balanced blocks (may include the inner object of a sentinel match,
+    // which is harmless — schema validation decides the winner).
+    for (const block of balancedBlocks(stdout)) {
+        candidates.push(block);
+    }
+    return candidates;
+}
+export function isValidMemberOutput(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const o = value;
+    return (typeof o.verdict === "string" &&
+        typeof o.confidence === "number" &&
+        Number.isFinite(o.confidence) &&
+        typeof o.rationale === "string");
+}
+export function isValidSynthOutput(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const o = value;
+    return (typeof o.verdict === "string" &&
+        typeof o.confidence === "number" &&
+        Number.isFinite(o.confidence) &&
+        typeof o.rationale === "string");
+}
+/**
+ * Parse a member's stdout into a validated CouncilMemberOutput.
+ * Strategy: enumerate candidate blocks, JSON.parse each, return the FIRST that
+ * passes schema validation. Tie-break = schema validity, not size/position.
+ * Returns null when no candidate validates (caller marks "unparseable").
+ */
+export function parseMemberOutput(stdout) {
+    for (const candidate of extractJsonCandidates(stdout)) {
+        try {
+            const parsed = JSON.parse(candidate);
+            if (isValidMemberOutput(parsed))
+                return parsed;
+        }
+        catch {
+            // try next candidate
+        }
+    }
+    return null;
+}
+/** Parse the synthesizer's stdout into a validated CouncilSynthOutput. */
+export function parseSynthOutput(stdout) {
+    for (const candidate of extractJsonCandidates(stdout)) {
+        try {
+            const parsed = JSON.parse(candidate);
+            if (isValidSynthOutput(parsed)) {
+                const o = parsed;
+                if (typeof o.minority_report !== "string")
+                    o.minority_report = "";
+                if (!Array.isArray(o.per_member_summary))
+                    o.per_member_summary = [];
+                return o;
+            }
+        }
+        catch {
+            // try next candidate
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=prompts.js.map