ctxr-cli 0.33.0 → 0.35.0

package/dist/core/second-opinion/judge.js

@@ -0,0 +1,55 @@
+const normalizeWs = (s) => s.replace(/\s+/g, ' ').trim().toLowerCase();
+/** Step ids a plan numbers as S1, S2, ... at the start of a line, list item, or heading. */
+export function planStepIds(plan) {
+    const ids = new Set();
+    for (const m of plan.matchAll(/^[ \t]*(?:[-*][ \t]+|#{1,6}[ \t]+)?\**S(\d+)\b/gm))
+        ids.add(`S${m[1]}`);
+    return ids;
+}
+export function parseCritique(text) {
+    const verdict = /^## Verdict:\s*(APPROVE_WITH_CHANGES|APPROVE|REJECT)\b/m.exec(text)?.[1] ?? null;
+    const findings = [];
+    const blocks = text.split(/^### F\d+\b/m).slice(1);
+    for (const block of blocks) {
+        // Brackets around the severity are what the contract asks for, and models drop them: accept both.
+        const head = /^\s*\[?(critical|major|minor)\]?\s*(?:confidence\s*[=:]\s*([01](?:\.\d+)?))?/i.exec(block);
+        const evidence = /^Evidence:\s*(.+)$/im.exec(block)?.[1] ?? '';
+        findings.push({
+            severity: head?.[1]?.toLowerCase() ?? null,
+            confidence: head?.[2] !== undefined ? Number(head[2]) : null,
+            evidence,
+        });
+    }
+    return { verdict, findings };
+}
+/** True if a finding's evidence points at something the plan actually contains. */
+export function evidenceResolves(evidence, plan, stepIds) {
+    for (const m of evidence.matchAll(/\bS(\d+)\b/g))
+        if (stepIds.has(`S${m[1]}`))
+            return true;
+    const haystack = normalizeWs(plan);
+    for (const m of evidence.matchAll(/["“`]([^"”`]{12,})["”`]/g))
+        if (haystack.includes(normalizeWs(m[1])))
+            return true;
+    for (const m of evidence.matchAll(/([\w./-]+\.[a-z]{1,6}):\d+/gi))
+        if (plan.includes(m[1]))
+            return true;
+    return false;
+}
+export function judgeCritique(text, plan) {
+    if (!text)
+        return { status: 'failed', cause: 'empty output', verdict: null, findings: [], veto: false };
+    const { verdict, findings } = parseCritique(text);
+    if (!verdict)
+        return { status: 'failed', cause: 'output has no "## Verdict:" line', verdict, findings, veto: false };
+    if (verdict !== 'APPROVE' && findings.length === 0)
+        return { status: 'failed', cause: `${verdict} with no parseable findings`, verdict, findings, veto: false };
+    const stepIds = planStepIds(plan);
+    const resolved = findings.filter((f) => evidenceResolves(f.evidence, plan, stepIds));
+    // An APPROVE with no findings has nothing to cite and is valid. Findings that exist but resolve to
+    // nothing in the plan mean the critic answered without reading it.
+    const blind = findings.length > 0 && resolved.length === 0;
+    const veto = verdict === 'REJECT' && findings.some((f) => f.severity === 'critical' && resolved.includes(f));
+    return { status: blind ? 'blind' : 'valid', cause: blind ? 'no finding cites anything in the plan' : null, verdict, findings, veto };
+}
+//# sourceMappingURL=judge.js.map

package/dist/core/second-opinion/judge.js.map

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

package/dist/core/second-opinion/launch.d.ts

@@ -0,0 +1,16 @@
+/**
+ * run-the-second-opinion-from-the-cli: the one place a model CLI is
+ * launched. No shell anywhere: an argument vector plus standard input, in a
+ * fresh empty scratch directory, with the allowlisted environment the caller
+ * built (D3). Ported from the skill's `run.mjs` unchanged in behaviour.
+ */
+export interface CliResult {
+    ok: boolean;
+    stdout: string;
+    stderr: string;
+    cause?: string;
+}
+export declare const firstLines: (text: string, n: number) => string;
+/** Runs one CLI. Resolves with what it printed and, on failure, why; never rejects. */
+export declare function runCli(cmd: string, args: readonly string[], stdin: string, timeoutSec: number, env: Record<string, string>): Promise<CliResult>;
+//# sourceMappingURL=launch.d.ts.map

package/dist/core/second-opinion/launch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch.d.ts","sourceRoot":"","sources":["../../../src/core/second-opinion/launch.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,UAAU,SAAU,MAAM,KAAK,MAAM,KAAG,MAAuE,CAAC;AAE7H,uFAAuF;AACvF,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,CA6D/I"}

package/dist/core/second-opinion/launch.js

@@ -0,0 +1,75 @@
+import { spawn } from 'node:child_process';
+import { mkdtempSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import path from 'node:path';
+export const firstLines = (text, n) => text.trim().split('\n').slice(0, n).join(' | ').slice(0, 400);
+/** Runs one CLI. Resolves with what it printed and, on failure, why; never rejects. */
+export function runCli(cmd, args, stdin, timeoutSec, env) {
+    return new Promise((resolve) => {
+        const scratch = mkdtempSync(path.join(tmpdir(), 'ctxr-second-opinion-'));
+        let settled = false;
+        let stdout = '';
+        let stderr = '';
+        let timedOut = false;
+        let timer;
+        const done = (result) => {
+            if (settled)
+                return;
+            settled = true;
+            if (timer)
+                clearTimeout(timer);
+            try {
+                rmSync(scratch, { recursive: true, force: true });
+            }
+            catch {
+                // best effort
+            }
+            resolve({ stdout, stderr, ...result });
+        };
+        let child;
+        try {
+            // detached: the CLI leads its own process group, so a timeout can stop everything it started.
+            child = spawn(cmd, [...args], { cwd: scratch, env, stdio: ['pipe', 'pipe', 'pipe'], detached: true });
+        }
+        catch (err) {
+            done({ ok: false, cause: `could not start ${cmd}: ${err instanceof Error ? err.message : String(err)}` });
+            return;
+        }
+        const killGroup = (signal) => {
+            try {
+                if (child.pid !== undefined)
+                    process.kill(-child.pid, signal);
+            }
+            catch {
+                // already gone
+            }
+        };
+        timer = setTimeout(() => {
+            timedOut = true;
+            killGroup('SIGTERM');
+            setTimeout(() => killGroup('SIGKILL'), 2000).unref();
+        }, timeoutSec * 1000);
+        // Decoded as a stream, so a multibyte character split across chunks survives.
+        child.stdout?.setEncoding('utf8');
+        child.stderr?.setEncoding('utf8');
+        child.stdout?.on('data', (d) => {
+            stdout += d;
+        });
+        child.stderr?.on('data', (d) => {
+            stderr += d;
+        });
+        child.on('error', (err) => done({ ok: false, cause: err.code === 'ENOENT' ? `'${cmd}' not found on PATH` : `could not start ${cmd}: ${err.message}` }));
+        child.on('close', (code) => {
+            if (timedOut)
+                return done({ ok: false, cause: `timed out after ${timeoutSec}s` });
+            if (code !== 0)
+                return done({ ok: false, cause: `exit ${code}: ${firstLines(stderr || stdout, 3)}` });
+            return done({ ok: true });
+        });
+        child.stdin?.on('error', () => {
+            // the CLI closed stdin early; its exit code says why
+        });
+        child.stdin?.end(stdin);
+    });
+}
+//# sourceMappingURL=launch.js.map

package/dist/core/second-opinion/launch.js.map

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

package/dist/core/second-opinion/lineup.d.ts

@@ -0,0 +1,82 @@
+import type { SourceEnv } from './environment.js';
+/**
+ * run-the-second-opinion-from-the-cli D1: the vendor CLI names and flags stay
+ * internal to this directory, behind contexture's own options (`--tier`,
+ * `--only`). The preflight still checks each CLI's help text for them, so a
+ * drifted flag fails loudly. Ported from the skill's `run.mjs`.
+ */
+export declare const ALL_CLIS: readonly ['claude', 'codex', 'agy'];
+export type Cli = (typeof ALL_CLIS)[number];
+export declare const TIERS: readonly ['strong', 'fast'];
+export type Tier = (typeof TIERS)[number];
+export declare const ROLE_CLI: {
+    readonly architect: 'claude';
+    readonly skeptic: 'codex';
+    readonly pragmatist: 'agy';
+};
+export type Role = keyof typeof ROLE_CLI;
+export declare const ROLES: Role[];
+/** A second opinion needs at least this many valid answers, and this many CLIs requested. */
+export declare const QUORUM = 2;
+/** Linux caps one argv element at 128 KiB; agy is the only CLI given its prompt as argv. */
+export declare const MAX_ARGV_BYTES = 120000;
+interface CliModel {
+    model: string;
+    effort?: string | null;
+}
+/**
+ * Model choice lives here, in one table. Override by environment, never by editing a store.
+ *
+ * The tiers name a class of model, not a price. `strong` is each family's frontier model and `fast` its
+ * workhorse: claude `fable` and `opus`; codex `gpt-6-astra` ("frontier intelligence") and `gpt-6.1-sol`
+ * ("latest workhorse"), as codex's model catalog described them on 2026-10-15; agy `Gemini 4 Argon` and
+ * `Gemini 3.8 Flash`, once agy offered Argon (2026-10-19). The tiers differ in model only: every model runs at
+ * its provider's default effort.
+ *
+ * Effort is each provider's own recommended default, not one this command picked:
+ *  - claude: no --effort at all, so Claude Code applies its own default for the model.
+ *  - codex: the default its model catalog declares (`default_reasoning_level`), which was `low` for both
+ *    gpt-6-astra and gpt-6.1-sol on 2026-10-15. It is passed explicitly because the flag cannot simply be
+ *    left off: with no pin in config.toml, codex resolves to `reasoning effort: none` on a ChatGPT login
+ *    (seen 2026-10-05), which is no review at all. Set CTXR_SECOND_OPINION_CODEX_EFFORT to use another.
+ *  - agy: the effort is part of the model name. The default thinking level is `(Medium)` for Gemini 4 Argon
+ *    and `(High)` for Gemini 3.8 Flash. agy rejects an unknown name, and preflight tests it.
+ */
+export declare function tiers(source: SourceEnv): Record<Tier, Record<Cli, CliModel>>;
+/**
+ * The flags this command passes, so preflight can confirm each CLI's --help still lists them. Only flags
+ * the help text documents belong here: `claude` still accepts a hidden --max-turns, but with `--tools ""`
+ * there is no tool turn to bound, so it is not passed at all. --effort is not listed because it is only
+ * passed when the environment asks for one.
+ */
+export declare const FLAGS_USED: Record<Cli, {
+    helpArgs: string[];
+    flags: string[];
+}>;
+export interface Invocation {
+    cmd: Cli;
+    args: string[];
+    stdin: string;
+}
+/**
+ * How each family is contained. Only claude and codex offer a mode that removes the ability to
+ * act; agy does not (its headless plan mode still wrote a file), so it is held to an empty working
+ * directory and an untrusted plan should run without it.
+ */
+export declare function buildInvocation(cli: Cli, prompt: string, tier: Tier, source: SourceEnv): Invocation;
+/** Normalizes a CLI's raw output to answer text plus the model it says it ran. */
+export declare function normalize(cli: Cli, raw: {
+    stdout: string;
+    stderr: string;
+}): {
+    text: string;
+    model: string | null;
+};
+/**
+ * Codex wraps its answer in a session banner and repeats it after a `tokens used` trailer.
+ * The answer starts at the first line of the required shape; failing that, the trailer is cut and
+ * everything else is kept, so real content is never eaten.
+ */
+export declare function stripCodexNoise(text: string): string;
+export {};
+//# sourceMappingURL=lineup.d.ts.map

package/dist/core/second-opinion/lineup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lineup.d.ts","sourceRoot":"","sources":["../../../src/core/second-opinion/lineup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,YAAI,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAU,CAAC;AAC5D,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5C,eAAO,MAAM,KAAK,YAAI,QAAQ,EAAE,MAAM,CAAU,CAAC;AACjD,MAAM,MAAM,IAAI,GAAG,CAAC,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1C,eAAO,MAAM,QAAQ;wBAAgB,QAAQ;sBAAW,OAAO;yBAAc,KAAK;CAAyC,CAAC;AAC5H,MAAM,MAAM,IAAI,GAAG,MAAM,OAAO,QAAQ,CAAC;AACzC,eAAO,MAAM,KAAK,EAA4B,IAAI,EAAE,CAAC;AAErD,6FAA6F;AAC7F,eAAO,MAAM,MAAM,IAAI,CAAC;AAExB,4FAA4F;AAC5F,eAAO,MAAM,cAAc,SAAU,CAAC;AAEtC,UAAU,QAAQ;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAc5E;AAED;;;;;GAKG;AACH,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,GAAG,EAAE;IAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAI3E,CAAC;AAEF,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,GAAG,CAAC;IACT,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,GAAG,UAAU,CAcnG;AAED,kFAAkF;AAClF,wBAAgB,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAenH;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOpD"}

package/dist/core/second-opinion/lineup.js

@@ -0,0 +1,113 @@
+/**
+ * run-the-second-opinion-from-the-cli D1: the vendor CLI names and flags stay
+ * internal to this directory, behind contexture's own options (`--tier`,
+ * `--only`). The preflight still checks each CLI's help text for them, so a
+ * drifted flag fails loudly. Ported from the skill's `run.mjs`.
+ */
+export const ALL_CLIS = ['claude', 'codex', 'agy'];
+export const TIERS = ['strong', 'fast'];
+export const ROLE_CLI = { architect: 'claude', skeptic: 'codex', pragmatist: 'agy' };
+export const ROLES = Object.keys(ROLE_CLI);
+/** A second opinion needs at least this many valid answers, and this many CLIs requested. */
+export const QUORUM = 2;
+/** Linux caps one argv element at 128 KiB; agy is the only CLI given its prompt as argv. */
+export const MAX_ARGV_BYTES = 120_000;
+/**
+ * Model choice lives here, in one table. Override by environment, never by editing a store.
+ *
+ * The tiers name a class of model, not a price. `strong` is each family's frontier model and `fast` its
+ * workhorse: claude `fable` and `opus`; codex `gpt-6-astra` ("frontier intelligence") and `gpt-6.1-sol`
+ * ("latest workhorse"), as codex's model catalog described them on 2026-10-15; agy `Gemini 4 Argon` and
+ * `Gemini 3.8 Flash`, once agy offered Argon (2026-10-19). The tiers differ in model only: every model runs at
+ * its provider's default effort.
+ *
+ * Effort is each provider's own recommended default, not one this command picked:
+ *  - claude: no --effort at all, so Claude Code applies its own default for the model.
+ *  - codex: the default its model catalog declares (`default_reasoning_level`), which was `low` for both
+ *    gpt-6-astra and gpt-6.1-sol on 2026-10-15. It is passed explicitly because the flag cannot simply be
+ *    left off: with no pin in config.toml, codex resolves to `reasoning effort: none` on a ChatGPT login
+ *    (seen 2026-10-05), which is no review at all. Set CTXR_SECOND_OPINION_CODEX_EFFORT to use another.
+ *  - agy: the effort is part of the model name. The default thinking level is `(Medium)` for Gemini 4 Argon
+ *    and `(High)` for Gemini 3.8 Flash. agy rejects an unknown name, and preflight tests it.
+ */
+export function tiers(source) {
+    const env = (name, fallback) => source[`CTXR_SECOND_OPINION_${name}`] || fallback;
+    return {
+        strong: {
+            claude: { model: env('CLAUDE_MODEL', 'fable'), effort: env('CLAUDE_EFFORT', null) },
+            codex: { model: env('CODEX_MODEL', 'gpt-6-astra'), effort: env('CODEX_EFFORT', 'low') },
+            agy: { model: env('AGY_MODEL', 'Gemini 4 Argon (Medium)') },
+        },
+        fast: {
+            claude: { model: env('CLAUDE_MODEL', 'opus'), effort: env('CLAUDE_EFFORT', null) },
+            codex: { model: env('CODEX_MODEL', 'gpt-6.1-sol'), effort: env('CODEX_EFFORT', 'low') },
+            agy: { model: env('AGY_MODEL', 'Gemini 3.8 Flash (High)') },
+        },
+    };
+}
+/**
+ * The flags this command passes, so preflight can confirm each CLI's --help still lists them. Only flags
+ * the help text documents belong here: `claude` still accepts a hidden --max-turns, but with `--tools ""`
+ * there is no tool turn to bound, so it is not passed at all. --effort is not listed because it is only
+ * passed when the environment asks for one.
+ */
+export const FLAGS_USED = {
+    claude: { helpArgs: ['--help'], flags: ['--tools', '--model', '--no-session-persistence', '--disable-slash-commands', '--output-format'] },
+    codex: { helpArgs: ['exec', '--help'], flags: ['--skip-git-repo-check', '--sandbox', '--ephemeral', '--color', '--config', '--model'] },
+    agy: { helpArgs: ['--help'], flags: ['--print', '--sandbox', '--disable-slash-commands', '--model'] },
+};
+/**
+ * How each family is contained. Only claude and codex offer a mode that removes the ability to
+ * act; agy does not (its headless plan mode still wrote a file), so it is held to an empty working
+ * directory and an untrusted plan should run without it.
+ */
+export function buildInvocation(cli, prompt, tier, source) {
+    const t = tiers(source)[tier][cli];
+    if (cli === 'claude') {
+        const args = ['-p', '--tools', '', '--model', t.model, '--no-session-persistence', '--disable-slash-commands', '--output-format', 'json'];
+        if (t.effort)
+            args.push('--effort', t.effort);
+        return { cmd: 'claude', args, stdin: prompt };
+    }
+    if (cli === 'codex') {
+        const args = ['exec', '--skip-git-repo-check', '--sandbox', 'read-only', '--ephemeral', '--color', 'never', '--model', t.model];
+        if (t.effort)
+            args.push('-c', `model_reasoning_effort=${t.effort}`);
+        args.push('-');
+        return { cmd: 'codex', args, stdin: prompt };
+    }
+    return { cmd: 'agy', args: ['-p', prompt, '--sandbox', '--disable-slash-commands', '--model', t.model], stdin: '' };
+}
+/** Normalizes a CLI's raw output to answer text plus the model it says it ran. */
+export function normalize(cli, raw) {
+    if (cli === 'claude') {
+        try {
+            const j = JSON.parse(raw.stdout);
+            const models = Object.keys(j.modelUsage ?? {});
+            return { text: String(j.result ?? '').trim(), model: models.length ? models.join(', ') : null };
+        }
+        catch {
+            return { text: raw.stdout.trim(), model: null };
+        }
+    }
+    if (cli === 'codex') {
+        const model = /^model:\s*(.+)$/m.exec(`${raw.stdout}\n${raw.stderr}`)?.[1]?.trim() ?? null;
+        return { text: stripCodexNoise(raw.stdout), model };
+    }
+    return { text: raw.stdout.trim(), model: null };
+}
+/**
+ * Codex wraps its answer in a session banner and repeats it after a `tokens used` trailer.
+ * The answer starts at the first line of the required shape; failing that, the trailer is cut and
+ * everything else is kept, so real content is never eaten.
+ */
+export function stripCodexNoise(text) {
+    const lines = text.split('\n');
+    const start = lines.findIndex((l) => /^## (Role|Verdict):/.test(l));
+    let body = start >= 0 ? lines.slice(start) : lines;
+    const trailer = body.findIndex((l) => /^tokens used\b/i.test(l.trim()));
+    if (trailer >= 0)
+        body = body.slice(0, trailer);
+    return body.join('\n').trim();
+}
+//# sourceMappingURL=lineup.js.map

package/dist/core/second-opinion/lineup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lineup.js","sourceRoot":"","sources":["../../../src/core/second-opinion/lineup.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAU,CAAC;AAG5D,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAU,CAAC;AAGjD,MAAM,CAAC,MAAM,QAAQ,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAyC,CAAC;AAE5H,MAAM,CAAC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAW,CAAC;AAErD,6FAA6F;AAC7F,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,CAAC;AAExB,4FAA4F;AAC5F,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AAOtC;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,KAAK,CAAC,MAAiB;IACrC,MAAM,GAAG,GAAG,CAAC,IAAY,EAAE,QAAuB,EAAiB,EAAE,CAAC,MAAM,CAAC,uBAAuB,IAAI,EAAE,CAAC,IAAI,QAAQ,CAAC;IACxH,OAAO;QACL,MAAM,EAAE;YACN,MAAM,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,cAAc,EAAE,OAAO,CAAE,EAAE,MAAM,EAAE,GAAG,CAAC,eAAe,EAAE,IAAI,CAAC,EAAE;YACpF,KAAK,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,aAAa,EAAE,aAAa,CAAE,EAAE,MAAM,EAAE,GAAG,CAAC,cAAc,EAAE,KAAK,CAAC,EAAE;YACxF,GAAG,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,WAAW,EAAE,yBAAyB,CAAE,EAAE;SAC7D;QACD,IAAI,EAAE;YACJ,MAAM,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,cAAc,EAAE,MAAM,CAAE,EAAE,MAAM,EAAE,GAAG,CAAC,eAAe,EAAE,IAAI,CAAC,EAAE;YACnF,KAAK,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,aAAa,EAAE,aAAa,CAAE,EAAE,MAAM,EAAE,GAAG,CAAC,cAAc,EAAE,KAAK,CAAC,EAAE;YACxF,GAAG,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,WAAW,EAAE,yBAAyB,CAAE,EAAE;SAC7D;KACF,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,UAAU,GAAyD;IAC9E,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,0BAA0B,EAAE,0BAA0B,EAAE,iBAAiB,CAAC,EAAE;IAC1I,KAAK,EAAE,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,KAAK,EAAE,CAAC,uBAAuB,EAAE,WAAW,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE;IACvI,GAAG,EAAE,EAAE,QAAQ,EAAE,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,CAAC,SAAS,EAAE,WAAW,EAAE,0BAA0B,EAAE,SAAS,CAAC,EAAE;CACtG,CAAC;AAQF;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,GAAQ,EAAE,MAAc,EAAE,IAAU,EAAE,MAAiB;IACrF,MAAM,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;QACrB,MAAM,IAAI,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,KAAK,EAAE,0BAA0B,EAAE,0BAA0B,EAAE,iBAAiB,EAAE,MAAM,CAAC,CAAC;QAC1I,IAAI,CAAC,CAAC,MAAM;YAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;QAC9C,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAChD,CAAC;IACD,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,uBAAuB,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;QAChI,IAAI,CAAC,CAAC,MAAM;YAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,0BAA0B,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QACpE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACf,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAC/C,CAAC;IACD,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,0BAA0B,EAAE,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;AACtH,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,SAAS,CAAC,GAAQ,EAAE,GAAuC;IACzE,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;QACrB,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAA+D,CAAC;YAC/F,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;YAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAClG,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QAClD,CAAC;IACH,CAAC;IACD,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;QACpB,MAAM,KAAK,GAAG,kBAAkB,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC;QAC3F,OAAO,EAAE,IAAI,EAAE,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;IACtD,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAClD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACpE,IAAI,IAAI,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACnD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACxE,IAAI,OAAO,IAAI,CAAC;QAAE,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAChD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;AAChC,CAAC"}

package/dist/core/second-opinion/modes.d.ts

@@ -0,0 +1,98 @@
+import { type SourceEnv } from './environment.js';
+import { type Cli, type Role, type Tier } from './lineup.js';
+/**
+ * run-the-second-opinion-from-the-cli: the three modes of `ctxr second-opinion`,
+ * ported from the skill's `run.mjs`. Behaviour is the script's; what changed is
+ * the exit-code mapping (D2, done by the command) and the child environment
+ * (D3, built here once per run). Each mode returns the lines the script
+ * printed to stdout, plus a structured result for `--json`.
+ */
+export interface SecondOpinionContext {
+    /** The command's own environment: the source the allowlist filters, and where the lineup overrides are read. */
+    source: SourceEnv;
+    cwd: string;
+    home: string;
+    /** Progress narration, for stderr. */
+    progress(line: string): void;
+    /** Piped standard input, or null when stdin is a terminal. */
+    readStdin(): Promise<string | null>;
+}
+export interface CommonOptions {
+    tier?: string;
+    timeout?: string;
+    only?: string;
+}
+export interface PreflightEntry {
+    cli: Cli;
+    ok: boolean;
+    detail: string;
+}
+export interface PreflightResult {
+    tier: Tier;
+    ok: boolean;
+    clis: PreflightEntry[];
+    /** On a failing preflight only: the variables withheld from the CLIs, by name. Never values. */
+    withheld?: string[];
+    lines: string[];
+}
+export declare function preflight(ctx: SecondOpinionContext, opts: CommonOptions): Promise<PreflightResult>;
+export interface CritiqueOptions extends CommonOptions {
+    planFile?: string;
+    out?: string;
+    seed?: string;
+}
+export interface CritiqueEntry {
+    letter: string | null;
+    role: Role;
+    cli: Cli;
+    model_reported: string | null;
+    status: 'valid' | 'blind' | 'failed';
+    cause: string | null;
+    verdict: string | null;
+    findings: number;
+    veto: boolean;
+    duration_ms: number;
+}
+export interface CritiqueManifest {
+    mode: 'critique';
+    tier: Tier;
+    quorum: number;
+    critiques: CritiqueEntry[];
+    valid: number;
+    partial: boolean;
+}
+export interface CritiqueResult {
+    out: string;
+    manifest: CritiqueManifest;
+    lines: string[];
+}
+export declare function critique(ctx: SecondOpinionContext, opts: CritiqueOptions): Promise<CritiqueResult>;
+export interface PollOptions extends CommonOptions {
+    promptFile?: string;
+    out?: string;
+    lens?: string;
+    /** False with `--no-wrap`: the question goes out without the answer scaffold. */
+    wrap?: boolean;
+}
+export interface PollAnswer {
+    cli: Cli;
+    status: 'valid' | 'failed';
+    cause: string | null;
+    model: string | null;
+}
+export interface PollManifest {
+    mode: 'poll';
+    tier: Tier;
+    lens: string | null;
+    quorum: number;
+    valid: number;
+    partial: boolean;
+    answers: PollAnswer[];
+}
+export interface PollResult {
+    out: string;
+    manifest: PollManifest;
+    lines: string[];
+}
+export declare function poll(ctx: SecondOpinionContext, opts: PollOptions): Promise<PollResult>;
+//# sourceMappingURL=modes.d.ts.map

package/dist/core/second-opinion/modes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modes.d.ts","sourceRoot":"","sources":["../../../src/core/second-opinion/modes.ts"],"names":[],"mappings":"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"}