@lanjak/council 0.0.0-stage → 0.6.0

package/dist/commands/debate.d.ts

@@ -0,0 +1,15 @@
+import { type RunControlFlags } from '../config.js';
+import { type ArtifactOptions } from './review.js';
+export interface DebateCommandOptions extends ArtifactOptions, RunControlFlags {
+    models?: string;
+    maxRounds?: string;
+    full?: boolean;
+    participate?: boolean;
+}
+export declare function debateCommand(prompt: string, options: DebateCommandOptions): Promise<void>;
+export declare function debateTurnCommand(sessionId: string, response: string | undefined, options: {
+    stdin?: boolean;
+    full?: boolean;
+}): Promise<void>;
+export declare function debateAbortCommand(sessionId: string): Promise<void>;
+export declare function parseMaxRounds(raw: string | undefined): number;

package/dist/commands/debate.js

@@ -0,0 +1,172 @@
+import { loadConfig, resolveModels, parseRunControls } from '../config.js';
+import { runDebate, activeParticipants, CALLER } from '../debate/loop.js';
+import { buildDebateOutput, renderDebateTOON, renderDebatePaused } from '../debate/render.js';
+import { cleanupExpired, newSessionId, saveSession, loadSession, deleteSession } from '../debate/session.js';
+import { formatTranscript } from '../debate/prompts.js';
+import { parseVerdict } from '../verdict.js';
+import { readStdinPayload } from '../stdin.js';
+import { CouncilError } from '../errors.js';
+import { buildPrompt, parseModelList } from '../input.js';
+import { readArtifactInput } from './review.js';
+// 'caller' is a reserved participant name, never a provider key. Filter it
+// AFTER resolution so an explicit --models list and a COUNCIL_PROVIDERS
+// fallback are both covered - the earlier pre-filter only guarded the
+// explicit path.
+function parseModels(raw, providers) {
+    return resolveModels(parseModelList(raw), providers).filter((m) => m !== CALLER);
+}
+export async function debateCommand(prompt, options) {
+    const controls = parseRunControls(options);
+    cleanupExpired();
+    const config = loadConfig();
+    const models = parseModels(options.models, config.providers);
+    if (models.length < 2) {
+        throw new CouncilError('A debate needs at least 2 judges; configure more providers or widen --models', 'NO_QUORUM');
+    }
+    const maxRounds = parseMaxRounds(options.maxRounds);
+    const fullPrompt = buildPrompt(prompt, await readArtifactInput(options));
+    // The caller participates by default: it authored the prompt, so it sits
+    // in the rotation and its verdict gates consensus. --no-participate drops
+    // it, which is what makes an unattended run possible.
+    const participate = options.participate !== false;
+    const progress = await runDebate(config, {
+        prompt: fullPrompt.text,
+        models,
+        participate,
+        maxRounds,
+        ...controls,
+    });
+    if (progress.status === 'awaiting-caller') {
+        const session = {
+            id: newSessionId(),
+            createdAt: new Date().toISOString(),
+            prompt: fullPrompt.text,
+            models: [...models, CALLER],
+            maxRounds,
+            ...controls,
+            turns: progress.turns,
+            nextTurn: progress.nextTurn,
+            warnings: fullPrompt.warnings,
+        };
+        saveSession(session);
+        console.log(renderPause(session));
+        return;
+    }
+    const output = buildDebateOutput({
+        prompt: fullPrompt.text,
+        turns: progress.turns,
+        consensus: progress.status === 'consensus',
+        maxRounds,
+        totalCount: models.length + (participate ? 1 : 0),
+        warnings: fullPrompt.warnings,
+    });
+    console.log(renderDebateTOON(output, { full: options.full === true }));
+}
+function renderPause(session) {
+    const callerTurnIndexes = session.turns
+        .map((t, i) => (t.provider === CALLER ? i : -1))
+        .filter((i) => i >= 0);
+    const lastCallerIdx = callerTurnIndexes.length > 0 ? callerTurnIndexes[callerTurnIndexes.length - 1] : -1;
+    const seenTurns = session.turns.slice(0, lastCallerIdx + 1);
+    const unseenTurns = session.turns.slice(lastCallerIdx + 1);
+    const order = session.nextTurn.order;
+    return renderDebatePaused({
+        sessionId: session.id,
+        round: session.nextTurn.round,
+        maxRounds: session.maxRounds,
+        turnIndex: order.indexOf(CALLER) + 1,
+        turnCount: order.length,
+        unseenTurns,
+        seenRounds: seenTurns.length > 0 ? new Set(seenTurns.map((t) => t.round)).size : 0,
+        seenBytes: Buffer.byteLength(formatTranscript(seenTurns), 'utf8'),
+    });
+}
+export async function debateTurnCommand(sessionId, response, options) {
+    const text = await readTurnText(response, options.stdin === true);
+    const session = loadSession(sessionId);
+    if (session.nextTurn.participant !== CALLER) {
+        throw new CouncilError(`It is not the caller's turn in session ${sessionId}; the state file may be damaged. Run: council debate abort ${sessionId}`, 'NOT_YOUR_TURN');
+    }
+    const callerTurn = {
+        round: session.nextTurn.round,
+        provider: CALLER,
+        model: CALLER,
+        status: 'success',
+        response: text,
+        verdict: parseVerdict(text),
+    };
+    const turns = [...session.turns, callerTurn];
+    const config = loadConfig();
+    const judges = session.models.filter((m) => m !== CALLER);
+    const next = participantAfterCaller(session, turns);
+    const progress = await runDebate(config, { prompt: session.prompt, models: judges, participate: true, maxRounds: session.maxRounds, maxTokens: session.maxTokens, effort: session.effort }, next ? { turns, nextTurn: next } : { turns, nextTurn: { round: session.maxRounds + 1, participant: CALLER, order: [] } });
+    if (progress.status === 'awaiting-caller') {
+        const updated = { ...session, turns: progress.turns, nextTurn: progress.nextTurn };
+        saveSession(updated);
+        console.log(renderPause(updated));
+        return;
+    }
+    deleteSession(sessionId);
+    const output = buildDebateOutput({
+        prompt: session.prompt,
+        turns: progress.turns,
+        consensus: progress.status === 'consensus',
+        maxRounds: session.maxRounds,
+        totalCount: session.models.length,
+        warnings: session.warnings,
+    });
+    console.log(renderDebateTOON(output, { full: options.full === true }));
+}
+// The next speaker after the caller's turn: the next still-active,
+// not-yet-spoken participant after CALLER in the round's FROZEN order (never
+// recomputed - a judge that errored earlier this round must not shift who
+// speaks after the caller), or the opener of the next round when the caller
+// closed this one (the engine computes that round's order fresh on resume,
+// since no turns are recorded for it yet). Returns undefined past maxRounds
+// (engine will cap).
+function participantAfterCaller(session, turns) {
+    const order = session.nextTurn.order;
+    const round = session.nextTurn.round;
+    const active = activeParticipants(session.models, turns);
+    const idx = order.indexOf(CALLER);
+    for (let i = idx + 1; i < order.length; i++) {
+        const candidate = order[i];
+        if (turns.some((t) => t.round === round && t.provider === candidate))
+            continue;
+        if (!active.includes(candidate))
+            continue;
+        return { round, participant: candidate, order };
+    }
+    if (round + 1 > session.maxRounds)
+        return undefined;
+    return { round: round + 1, participant: CALLER, order: [] };
+}
+async function readTurnText(response, stdin) {
+    if (stdin === (response !== undefined)) {
+        throw new CouncilError('Provide the turn as an argument or via --stdin, not both/neither', 'BAD_ARG');
+    }
+    if (!stdin)
+        return response;
+    if (process.stdin.isTTY) {
+        throw new CouncilError('--stdin given but stdin is a terminal; pipe content or omit the flag', 'STDIN_TTY');
+    }
+    return readStdinPayload();
+}
+export async function debateAbortCommand(sessionId) {
+    deleteSession(sessionId);
+    console.log(`session ${sessionId}: aborted (no-op if it did not exist)`);
+}
+export function parseMaxRounds(raw) {
+    if (raw === undefined)
+        return 5;
+    const trimmed = raw.trim();
+    if (!/^\d+$/.test(trimmed)) {
+        throw new CouncilError(`--max-rounds must be a positive integer, got "${raw}"`, 'BAD_ARG');
+    }
+    const n = Number.parseInt(trimmed, 10);
+    if (!Number.isInteger(n) || n < 1) {
+        throw new CouncilError(`--max-rounds must be a positive integer, got "${raw}"`, 'BAD_ARG');
+    }
+    return n;
+}
+//# sourceMappingURL=debate.js.map

package/dist/commands/debate.js.map

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

package/dist/commands/home.d.ts

@@ -0,0 +1 @@
+export declare function homeCommand(): Promise<void>;

package/dist/commands/home.js

@@ -0,0 +1,27 @@
+import { loadConfig, listProviders } from '../config.js';
+import { loadProvider } from '../providers/index.js';
+export async function homeCommand() {
+    const config = loadConfig();
+    const providers = listProviders(config);
+    const lines = [];
+    lines.push('council: multi-LLM adversarial review council');
+    lines.push(`providers[${providers.length}]{name,authenticated}:`);
+    for (const name of providers) {
+        const providerConfig = config.providers[name];
+        const provider = loadProvider(name, providerConfig);
+        const auth = await provider.checkAuth();
+        lines.push(`  ${name},${auth.authenticated}`);
+    }
+    if (providers.length === 0) {
+        lines.push('  (none configured)');
+    }
+    lines.push('commands[3]{name,purpose}:');
+    lines.push('  setup,check provider authentication');
+    lines.push('  review,adversarial review of an artifact or question');
+    lines.push('  plan,pressure-test a plan or decision');
+    lines.push('help[2]:');
+    lines.push('  Set COUNCIL_PROVIDERS and per-provider env vars');
+    lines.push('  Run `council review "<prompt>" --models <provider1>,<provider2>`');
+    console.log(lines.join('\n'));
+}
+//# sourceMappingURL=home.js.map

package/dist/commands/home.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"home.js","sourceRoot":"","sources":["../../src/commands/home.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,SAAS,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;IAC5D,KAAK,CAAC,IAAI,CAAC,aAAa,SAAS,CAAC,MAAM,wBAAwB,CAAC,CAAC;IAClE,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,MAAM,cAAc,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC9C,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;QACpD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,SAAS,EAAE,CAAC;QACxC,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;IAChD,CAAC;IAED,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;IACzC,KAAK,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;IACpD,KAAK,CAAC,IAAI,CAAC,wDAAwD,CAAC,CAAC;IACrE,KAAK,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;IAEtD,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvB,KAAK,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAC;IAChE,KAAK,CAAC,IAAI,CAAC,oEAAoE,CAAC,CAAC;IAEjF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAChC,CAAC"}

package/dist/commands/hook.d.ts

@@ -0,0 +1,3 @@
+export declare function hookCommand(event: string | undefined, options: {
+    payload?: string;
+}): Promise<void>;

package/dist/commands/hook.js

@@ -0,0 +1,138 @@
+import { loadConfig, listProviders } from '../config.js';
+import { readStdinPayload } from '../stdin.js';
+import { parseHookPayload } from '../hooks/payload.js';
+import { resolveSessionKey, recordEdit, pendingEdits, clearSession } from '../hooks/state.js';
+import { synthesize } from '../chairman.js';
+import { runCouncil } from '../council.js';
+import { assembleArtifacts, formatArtifactPreamble } from '../artifacts.js';
+import { decideGate } from '../hooks/gate.js';
+import { parseCapBytesOverride } from '../input.js';
+const GATE_SYSTEM_PROMPT = `You are one judge on a review council gating completion of a coding task. Review the diff of uncommitted changes. Be adversarial: look for bugs, security issues, broken contracts, missing tests. End your response with a final line of exactly one of:
+VERDICT: pass
+VERDICT: concerns
+VERDICT: fail
+Use fail only for issues that must be fixed before this work is acceptable.`;
+const EVENTS = ['session-start', 'post-edit', 'stop'];
+export async function hookCommand(event, options) {
+    if (!event || !EVENTS.includes(event)) {
+        console.error(`council hook: unknown event "${event ?? '(none)'}"\navailable events: ${EVENTS.join(', ')}`);
+        process.exitCode = 1;
+        return;
+    }
+    const rawPayload = options.payload ?? (await readStdinPayload());
+    switch (event) {
+        case 'session-start':
+            return sessionStart(rawPayload);
+        case 'post-edit':
+            return postEdit(rawPayload);
+        case 'stop':
+            return stop(rawPayload);
+    }
+}
+async function sessionStart(_rawPayload) {
+    try {
+        const config = loadConfig();
+        const providers = listProviders(config);
+        if (providers.length === 0) {
+            return; // nothing configured: stay silent, exit 0
+        }
+        console.log(`council[available]: providers ${providers.join(',')} | review gate active`);
+        console.log('help: run `council review "<question>" --diff` for a council review');
+    }
+    catch {
+        // A context hook must never break session startup.
+    }
+}
+async function postEdit(rawPayload) {
+    try {
+        const payload = parseHookPayload(rawPayload);
+        const cwd = payload.cwd ?? process.cwd();
+        const key = resolveSessionKey(payload);
+        for (const file of payload.files ?? []) {
+            recordEdit(key, file, cwd);
+        }
+    }
+    catch (err) {
+        console.error(`council hook post-edit: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+function safelyClearSession(key) {
+    try {
+        clearSession(key);
+    }
+    catch {
+        // Best-effort cleanup only. The block/pass decision (exit code, stdout
+        // synthesis, stderr summary) is already final at this point - a failed
+        // cleanup must never reclassify it as fail-open.
+    }
+}
+async function stop(rawPayload) {
+    const payload = parseHookPayload(rawPayload);
+    const key = resolveSessionKey(payload, () => { }); // stop stays quiet; post-edit already warned
+    let edits;
+    try {
+        edits = pendingEdits(key);
+    }
+    catch {
+        process.exitCode = 0;
+        return;
+    }
+    if (edits.length === 0) {
+        process.exitCode = 0;
+        return; // zero-cost pass-through
+    }
+    try {
+        const config = loadConfig();
+        const models = listProviders(config);
+        if (models.length === 0) {
+            console.log('council[gate_error]: no providers configured - gate inert');
+            process.exitCode = 0;
+            return;
+        }
+        const bundle = assembleArtifacts({
+            diff: { paths: edits },
+            cwd: payload.cwd ?? process.cwd(),
+            capBytes: parseCapBytesOverride(),
+        });
+        if (bundle.blocks.length === 0) {
+            // Edits were pending but produced no diff content (e.g. already
+            // committed) - there is nothing to review, so treat this the same as
+            // the no-pending-edits case, but the pending edits WERE reviewed (as
+            // "nothing to flag"), so clear the state instead of leaving it stale.
+            process.exitCode = 0;
+            safelyClearSession(key);
+            return;
+        }
+        const warningsSuffix = bundle.warnings.length > 0 ? ` (warnings: ${bundle.warnings.length})` : '';
+        const prompt = formatArtifactPreamble(bundle) +
+            `Review the above uncommitted changes to these files: ${edits.join(', ')}`;
+        const judges = await runCouncil(config, {
+            prompt,
+            mode: 'review',
+            models,
+            systemPrompt: GATE_SYSTEM_PROMPT,
+        });
+        const decision = decideGate(judges);
+        if (decision.outcome === 'fail-open') {
+            console.log(`council[gate_error]: ${decision.reason} - gate failed open, edits kept for re-review${warningsSuffix}`);
+            process.exitCode = 0;
+            return; // state NOT cleared
+        }
+        const synthesis = synthesize({ prompt, mode: 'review', models, systemPrompt: GATE_SYSTEM_PROMPT }, judges);
+        if (decision.outcome === 'block') {
+            console.log(synthesis);
+            console.error(`council gate: blocked - ${decision.reason}${warningsSuffix}`);
+            process.exitCode = 2;
+            safelyClearSession(key);
+            return;
+        }
+        console.log(`council[gate]: pass - ${decision.reason}${warningsSuffix}`);
+        process.exitCode = 0;
+        safelyClearSession(key);
+    }
+    catch (err) {
+        console.log(`council[gate_error]: ${err instanceof Error ? err.message : String(err)} - gate failed open, edits kept for re-review`);
+        process.exitCode = 0; // fail open, state kept
+    }
+}
+//# sourceMappingURL=hook.js.map

package/dist/commands/hook.js.map

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

package/dist/commands/plan.d.ts

@@ -0,0 +1,6 @@
+import { type RunControlFlags } from '../config.js';
+import { type ArtifactOptions } from './review.js';
+import { type ExitPolicyOptions } from '../exit.js';
+export declare function planCommand(prompt: string, options: {
+    models?: string;
+} & RunControlFlags & ArtifactOptions & ExitPolicyOptions): Promise<void>;

package/dist/commands/plan.js

@@ -0,0 +1,23 @@
+import { renderTOON } from '../output.js';
+import { loadConfig, resolveModels, parseRunControls } from '../config.js';
+import { parseModelList } from '../input.js';
+import { readArtifactInput } from './review.js';
+import { runPlan } from '../runners/plan.js';
+import { exitCodeFor } from '../exit.js';
+export async function planCommand(prompt, options) {
+    // Resolve and validate the model list BEFORE reading stdin. A bad --models
+    // must fail immediately rather than after a blocking stdin read drains.
+    const controls = parseRunControls(options);
+    const config = loadConfig();
+    const models = resolveModels(parseModelList(options.models), config.providers);
+    const output = await runPlan({
+        prompt,
+        models,
+        config,
+        ...controls,
+        ...(await readArtifactInput(options)),
+    });
+    console.log(renderTOON(output));
+    process.exitCode = exitCodeFor(output, options);
+}
+//# sourceMappingURL=plan.js.map

package/dist/commands/plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../src/commands/plan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,gBAAgB,EAAwB,MAAM,cAAc,CAAC;AACjG,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAwB,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAA0B,MAAM,YAAY,CAAC;AAEjE,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,MAAc,EACd,OAAoF;IAEpF,2EAA2E;IAC3E,wEAAwE;IACxE,MAAM,QAAQ,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,MAAM,GAAG,aAAa,CAAC,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IAE/E,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC;QAC3B,MAAM;QACN,MAAM;QACN,MAAM;QACN,GAAG,QAAQ;QACX,GAAG,CAAC,MAAM,iBAAiB,CAAC,OAAO,CAAC,CAAC;KACtC,CAAC,CAAC;IACH,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IAChC,OAAO,CAAC,QAAQ,GAAG,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAClD,CAAC"}

package/dist/commands/review.d.ts

@@ -0,0 +1,18 @@
+import { type RunControlFlags } from '../config.js';
+import { type ExitPolicyOptions } from '../exit.js';
+export interface ArtifactOptions {
+    file?: string[];
+    diff?: string | boolean;
+    stdin?: boolean;
+}
+export declare function readArtifactInput(options: ArtifactOptions): Promise<{
+    files: string[] | undefined;
+    diff: {
+        range: string | undefined;
+    } | undefined;
+    stdinContent: string | undefined;
+    capBytes: number | undefined;
+}>;
+export declare function reviewCommand(prompt: string, options: {
+    models?: string;
+} & RunControlFlags & ArtifactOptions & ExitPolicyOptions): Promise<void>;

package/dist/commands/review.js

@@ -0,0 +1,37 @@
+import { renderTOON } from '../output.js';
+import { CouncilError } from '../errors.js';
+import { loadConfig, resolveModels, parseRunControls } from '../config.js';
+import { parseCapBytesOverride, parseModelList } from '../input.js';
+import { readStdinPayload } from '../stdin.js';
+import { runReview } from '../runners/review.js';
+import { exitCodeFor } from '../exit.js';
+export async function readArtifactInput(options) {
+    if (options.stdin && process.stdin.isTTY) {
+        throw new CouncilError('--stdin given but stdin is a terminal; pipe content or omit the flag', 'STDIN_TTY');
+    }
+    return {
+        files: options.file,
+        diff: options.diff === undefined
+            ? undefined
+            : { range: typeof options.diff === 'string' ? options.diff : undefined },
+        stdinContent: options.stdin ? await readStdinPayload() : undefined,
+        capBytes: parseCapBytesOverride(),
+    };
+}
+export async function reviewCommand(prompt, options) {
+    // Resolve and validate the model list BEFORE reading stdin. A bad --models
+    // must fail immediately rather than after a blocking stdin read drains.
+    const controls = parseRunControls(options);
+    const config = loadConfig();
+    const models = resolveModels(parseModelList(options.models), config.providers);
+    const output = await runReview({
+        prompt,
+        models,
+        config,
+        ...controls,
+        ...(await readArtifactInput(options)),
+    });
+    console.log(renderTOON(output));
+    process.exitCode = exitCodeFor(output, options);
+}
+//# sourceMappingURL=review.js.map

package/dist/commands/review.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review.js","sourceRoot":"","sources":["../../src/commands/review.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,gBAAgB,EAAwB,MAAM,cAAc,CAAC;AACjG,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,WAAW,EAA0B,MAAM,YAAY,CAAC;AAQjE,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAAwB;IAC9D,IAAI,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACzC,MAAM,IAAI,YAAY,CACpB,sEAAsE,EACtE,WAAW,CACZ,CAAC;IACJ,CAAC;IACD,OAAO;QACL,KAAK,EAAE,OAAO,CAAC,IAAI;QACnB,IAAI,EACF,OAAO,CAAC,IAAI,KAAK,SAAS;YACxB,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,EAAE;QAC5E,YAAY,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,gBAAgB,EAAE,CAAC,CAAC,CAAC,SAAS;QAClE,QAAQ,EAAE,qBAAqB,EAAE;KAClC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAc,EACd,OAAoF;IAEpF,2EAA2E;IAC3E,wEAAwE;IACxE,MAAM,QAAQ,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,MAAM,GAAG,aAAa,CAAC,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IAE/E,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC;QAC7B,MAAM;QACN,MAAM;QACN,MAAM;QACN,GAAG,QAAQ;QACX,GAAG,CAAC,MAAM,iBAAiB,CAAC,OAAO,CAAC,CAAC;KACtC,CAAC,CAAC;IACH,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IAChC,OAAO,CAAC,QAAQ,GAAG,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAClD,CAAC"}

package/dist/commands/setup.d.ts

@@ -0,0 +1 @@
+export declare function setupCommand(): Promise<void>;

package/dist/commands/setup.js

@@ -0,0 +1,23 @@
+import { loadConfig, listProviders } from '../config.js';
+import { loadProvider } from '../providers/index.js';
+export async function setupCommand() {
+    const config = loadConfig();
+    const providers = listProviders(config);
+    const lines = [];
+    lines.push(`providers[${providers.length}]{name,authenticated,detail}:`);
+    for (const name of providers) {
+        const providerConfig = config.providers[name];
+        const provider = loadProvider(name, providerConfig);
+        const auth = await provider.checkAuth();
+        lines.push(`  ${name},${auth.authenticated},${auth.detail}`);
+    }
+    if (providers.length === 0) {
+        lines.push('  (none configured)');
+    }
+    lines.push('help[3]:');
+    lines.push('  Set COUNCIL_PROVIDERS and per-provider env vars to add judges');
+    lines.push('  Example: COUNCIL_PROVIDERS=openai OPENAI_API_KEY=sk-... OPENAI_BASE_URL=https://api.openai.com/v1 OPENAI_MODEL=gpt-4o');
+    lines.push('  Anthropic example: COUNCIL_PROVIDERS=claude CLAUDE_KIND=anthropic CLAUDE_API_KEY=sk-ant-... CLAUDE_MODEL=claude-opus-5');
+    console.log(lines.join('\n'));
+}
+//# sourceMappingURL=setup.js.map

package/dist/commands/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/commands/setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,SAAS,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,aAAa,SAAS,CAAC,MAAM,+BAA+B,CAAC,CAAC;IACzE,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,MAAM,cAAc,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC9C,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;QACpD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,SAAS,EAAE,CAAC;QACxC,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvB,KAAK,CAAC,IAAI,CAAC,iEAAiE,CAAC,CAAC;IAC9E,KAAK,CAAC,IAAI,CAAC,yHAAyH,CAAC,CAAC;IACtI,KAAK,CAAC,IAAI,CAAC,0HAA0H,CAAC,CAAC;IAEvI,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAChC,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,17 @@
+import type { ProviderConfig, Effort } from './types.js';
+export interface CouncilConfig {
+    providers: Record<string, ProviderConfig>;
+}
+export declare function loadConfig(env?: Record<string, string | undefined>): CouncilConfig;
+export declare function parseEffort(value: string, source?: string): Effort;
+export interface RunControlFlags {
+    maxTokens?: string;
+    effort?: string;
+}
+export declare function parseRunControls(options: RunControlFlags): {
+    maxTokens: number | undefined;
+    effort: Effort | undefined;
+};
+export declare function listProviders(config: CouncilConfig): string[];
+export declare function resolveModel(providerConfig: ProviderConfig): string | undefined;
+export declare function resolveModels(models: string[] | undefined, providers: Record<string, ProviderConfig>): string[];

package/dist/config.js

@@ -0,0 +1,101 @@
+import { CouncilError } from './errors.js';
+export function loadConfig(env = process.env) {
+    const providers = {};
+    const defaultEffort = env.COUNCIL_EFFORT === undefined
+        ? undefined
+        : parseEffort(env.COUNCIL_EFFORT, 'COUNCIL_EFFORT');
+    const configured = env.COUNCIL_PROVIDERS?.split(',').map((p) => p.trim()).filter(Boolean) ?? [];
+    for (const provider of configured) {
+        const prefix = provider.toUpperCase();
+        const apiKey = env[`${prefix}_API_KEY`] ?? '';
+        const baseURL = env[`${prefix}_BASE_URL`] ?? '';
+        const model = env[`${prefix}_MODEL`];
+        const displayName = env[`${prefix}_DISPLAY_NAME`] ?? capitalize(provider);
+        const maxTokens = parsePositiveInt(env[`${prefix}_MAX_TOKENS`]);
+        const temperature = parseTemperature(env[`${prefix}_TEMPERATURE`]);
+        const kind = parseKind(env[`${prefix}_KIND`], prefix);
+        providers[provider] = {
+            name: provider,
+            apiKey,
+            baseURL,
+            model,
+            displayName,
+            maxTokens,
+            effort: env[`${prefix}_EFFORT`] === undefined
+                ? defaultEffort
+                : parseEffort(env[`${prefix}_EFFORT`], `${prefix}_EFFORT`),
+            temperature,
+            kind,
+        };
+    }
+    return { providers };
+}
+export function parseEffort(value, source = '--effort') {
+    if (value === 'low' || value === 'medium' || value === 'high' || value === 'xhigh')
+        return value;
+    throw new CouncilError(`${source} must be low|medium|high|xhigh, got "${value}"`, 'BAD_EFFORT');
+}
+export function parseRunControls(options) {
+    let maxTokens;
+    if (options.maxTokens !== undefined) {
+        const raw = options.maxTokens.trim();
+        maxTokens = Number(raw);
+        if (!/^\d+$/.test(raw) || !Number.isSafeInteger(maxTokens) || maxTokens < 1) {
+            throw new CouncilError(`--max-tokens must be a positive integer, got "${options.maxTokens}"`, 'BAD_ARG');
+        }
+    }
+    return { maxTokens, effort: options.effort === undefined ? undefined : parseEffort(options.effort) };
+}
+function capitalize(text) {
+    return text.replace(/\b\w/g, (c) => c.toUpperCase());
+}
+function parsePositiveInt(value) {
+    if (!value)
+        return undefined;
+    const n = Number.parseInt(value, 10);
+    return Number.isInteger(n) && n > 0 ? n : undefined;
+}
+function parseTemperature(value) {
+    if (!value)
+        return undefined;
+    const n = Number.parseFloat(value);
+    return Number.isFinite(n) && n >= 0 ? n : undefined;
+}
+function parseKind(value, prefix) {
+    // Trim BEFORE the emptiness check: a whitespace-only value (e.g. a stray
+    // space from a sloppy .env edit) must default to 'openai' like an unset
+    // or empty value, not throw - trimming after the check would only catch
+    // the empty-string case and treat whitespace as an unrecognized value.
+    const normalized = (value ?? '').trim().toLowerCase();
+    if (normalized === '')
+        return 'openai';
+    if (normalized === 'openai')
+        return 'openai';
+    if (normalized === 'anthropic')
+        return 'anthropic';
+    throw new CouncilError(`Unrecognized ${prefix}_KIND "${value}" (expected "openai" or "anthropic")`, 'BAD_KIND');
+}
+export function listProviders(config) {
+    return Object.keys(config.providers);
+}
+export function resolveModel(providerConfig) {
+    return providerConfig.model;
+}
+// One resolver for every command. Previously duplicated three times, and the
+// copies had drifted: only debate filtered empty entries, so `--models a,,b`
+// asked review and plan for a provider named "".
+export function resolveModels(models, providers) {
+    const explicit = (models ?? []).map((m) => m.trim()).filter((m) => m.length > 0);
+    if (explicit.length > 0)
+        return explicit;
+    // A supplied-but-empty list is a typo, not a request for every provider.
+    if (models !== undefined && models.length > 0) {
+        throw new CouncilError('--models was given but listed no providers', 'BAD_ARG');
+    }
+    const configured = Object.keys(providers);
+    if (configured.length === 0) {
+        throw new CouncilError('No providers configured. Set COUNCIL_PROVIDERS or pass --models.', 'NO_PROVIDERS');
+    }
+    return configured;
+}
+//# sourceMappingURL=config.js.map