ctxr-cli 0.33.0 → 0.35.0

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

@@ -0,0 +1,224 @@
+import { mkdirSync, mkdtempSync, readFileSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import path from 'node:path';
+import { SecondOpinionUsageError } from '../errors.js';
+import { childEnvironment, PASS_ENV_VARIABLE, protectedPassThroughNames } from './environment.js';
+import { judgeCritique } from './judge.js';
+import { firstLines, runCli } from './launch.js';
+import { ALL_CLIS, buildInvocation, FLAGS_USED, MAX_ARGV_BYTES, normalize, QUORUM, ROLE_CLI, ROLES, TIERS, tiers } from './lineup.js';
+import { critiquePrompt, pollPrompt } from './prompts.js';
+/** Every refusal happens here, before any CLI launches. */
+function resolve(ctx, opts, needQuorum) {
+    const tier = (opts.tier ?? 'strong');
+    if (!TIERS.includes(tier))
+        throw new SecondOpinionUsageError('--tier is strong or fast');
+    const timeout = opts.timeout === undefined ? 600 : Number(opts.timeout);
+    if (!Number.isFinite(timeout) || timeout <= 0)
+        throw new SecondOpinionUsageError('--timeout must be a positive number of seconds');
+    let clis = [...ALL_CLIS];
+    if (opts.only !== undefined) {
+        const named = opts.only.split(',').map((c) => c.trim()).filter(Boolean);
+        const bad = named.filter((c) => !ALL_CLIS.includes(c));
+        if (bad.length)
+            throw new SecondOpinionUsageError(`unknown CLI in --only: ${bad.join(', ')} (valid: ${ALL_CLIS.join(', ')})`);
+        clis = [...new Set(named)];
+    }
+    if (needQuorum && clis.length < QUORUM) {
+        throw new SecondOpinionUsageError(`--only names ${clis.length} CLI; a second opinion needs at least ${QUORUM}`);
+    }
+    // D3 and Revisions after critique 1: the protected prefixes win over the pass-through, and naming one stops the run.
+    const refused = protectedPassThroughNames(ctx.source);
+    if (refused.length) {
+        throw new SecondOpinionUsageError(`${PASS_ENV_VARIABLE} names ${refused.join(', ')}; forge and contexture variables are never passed to a model CLI`, { variables: refused });
+    }
+    const { env, withheld } = childEnvironment(ctx.source, ctx.home);
+    return { tier, timeout, clis, env, withheld };
+}
+export async function preflight(ctx, opts) {
+    const r = resolve(ctx, opts, false);
+    const results = await Promise.all(r.clis.map(async (cli) => {
+        const spec = FLAGS_USED[cli];
+        const help = await runCli(cli, spec.helpArgs, '', 30, r.env);
+        if (!help.ok)
+            return { cli, ok: false, detail: help.cause ?? 'failed' };
+        const helpText = help.stdout + help.stderr;
+        const missing = spec.flags.filter((f) => !helpText.includes(f));
+        // The ping runs at the tier the run will use. A fixed tier left the other tier's model untested, so a
+        // model name agy no longer accepted passed preflight and failed the critique (2026-10-13).
+        const inv = buildInvocation(cli, 'say PONG only', r.tier, ctx.source);
+        const ping = await runCli(inv.cmd, inv.args, inv.stdin, Math.min(r.timeout, 60), r.env);
+        if (!ping.ok)
+            return { cli, ok: false, detail: ping.cause ?? 'failed' };
+        const { text } = normalize(cli, ping);
+        if (!/pong/i.test(text))
+            return { cli, ok: false, detail: `unexpected reply: ${firstLines(text, 2)}` };
+        if (missing.length)
+            return { cli, ok: false, detail: `answers, but its --help no longer lists: ${missing.join(' ')}` };
+        const model = tiers(ctx.source)[r.tier][cli].model;
+        return { cli, ok: true, detail: model ? `PONG (${model})` : 'PONG' };
+    }));
+    const ok = results.every((x) => x.ok);
+    const lines = results.map((x) => `[${x.ok ? 'OK  ' : 'DOWN'}] ${x.cli.padEnd(7)} ${x.detail}`);
+    if (!ok) {
+        lines.push('', 'At least one CLI is down. Re-authenticate it, or run with --only on the ones that are up.');
+        // D3: a variable the allowlist dropped may be what a CLI needed. Names only, never values.
+        if (r.withheld.length) {
+            lines.push(`Withheld from the CLIs: ${r.withheld.join(', ')}. To pass one through, name it in ${PASS_ENV_VARIABLE}.`);
+        }
+    }
+    return { tier: r.tier, ok, clis: results, ...(ok ? {} : { withheld: r.withheld }), lines };
+}
+// ---------------------------------------------------------------------------
+// Input and output.
+// ---------------------------------------------------------------------------
+async function readInput(ctx, file, flag) {
+    if (file !== undefined) {
+        const absolute = path.resolve(ctx.cwd, file);
+        try {
+            return readFileSync(absolute, 'utf8');
+        }
+        catch (err) {
+            throw new SecondOpinionUsageError(`cannot read ${file}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    const piped = await ctx.readStdin();
+    if (piped !== null && piped.trim())
+        return piped;
+    throw new SecondOpinionUsageError(`no input: pass ${flag} PATH or pipe it on stdin`);
+}
+function outDir(ctx, out) {
+    const dir = out !== undefined ? path.resolve(ctx.cwd, out) : mkdtempSync(path.join(tmpdir(), 'ctxr-second-opinion-out-'));
+    mkdirSync(path.join(dir, 'raw'), { recursive: true });
+    return dir;
+}
+function rng(seed) {
+    if (seed === null || Number.isNaN(seed))
+        return Math.random;
+    let a = seed >>> 0; // mulberry32: deterministic, for tests
+    return () => {
+        a = (a + 0x6d2b79f5) >>> 0;
+        let t = a;
+        t = Math.imul(t ^ (t >>> 15), t | 1);
+        t ^= t + Math.imul(t ^ (t >>> 7), t | 61);
+        return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+    };
+}
+function shuffled(items, random) {
+    const a = [...items];
+    for (let i = a.length - 1; i > 0; i--) {
+        const j = Math.floor(random() * (i + 1));
+        [a[i], a[j]] = [a[j], a[i]];
+    }
+    return a;
+}
+const tooLong = (prompt, cause) => Buffer.byteLength(prompt) > MAX_ARGV_BYTES ? { ok: false, stdout: '', stderr: '', cause } : null;
+export async function critique(ctx, opts) {
+    const r = resolve(ctx, opts, true);
+    const seed = opts.seed === undefined ? null : Number(opts.seed);
+    const plan = await readInput(ctx, opts.planFile, '--plan-file');
+    const roles = ROLES.filter((role) => r.clis.includes(ROLE_CLI[role]));
+    const dir = outDir(ctx, opts.out);
+    ctx.progress(`plan: ${plan.length} characters (about ${Math.ceil(plan.length / 4)} tokens) · tier: ${r.tier} · critics: ${roles.length} · each may take 1-3 minutes`);
+    const runs = await Promise.all(roles.map(async (role) => {
+        const cli = ROLE_CLI[role];
+        const prompt = critiquePrompt(role, plan);
+        const started = Date.now();
+        let raw;
+        const refused = cli === 'agy' ? tooLong(prompt, `prompt is ${Buffer.byteLength(prompt)} bytes; agy takes it as one argument and the limit is ${MAX_ARGV_BYTES}`) : null;
+        if (refused)
+            raw = refused;
+        else {
+            const inv = buildInvocation(cli, prompt, r.tier, ctx.source);
+            raw = await runCli(inv.cmd, inv.args, inv.stdin, r.timeout, r.env);
+        }
+        writeFileSync(path.join(dir, 'raw', `${role}-${cli}.txt`), `${raw.stdout}\n--- stderr ---\n${raw.stderr}\n`);
+        const base = { role, cli, duration_ms: Date.now() - started };
+        if (!raw.ok)
+            return { ...base, status: 'failed', cause: raw.cause ?? null, model: null, text: '', verdict: null, findings: 0, veto: false };
+        const { text, model } = normalize(cli, raw);
+        const judged = judgeCritique(text, plan);
+        return { ...base, status: judged.status, cause: judged.cause, model, text, verdict: judged.verdict, findings: judged.findings.length, veto: judged.veto };
+    }));
+    // Letters go to every critique that produced text (valid or blind), in an order that does not follow the roster.
+    const answered = runs.filter((x) => x.status !== 'failed');
+    const letters = shuffled(answered, rng(seed)).map((x, i) => ({ ...x, letter: String.fromCharCode(65 + i) }));
+    for (const x of letters)
+        writeFileSync(path.join(dir, `critique-${x.letter}.md`), `${x.text}\n`);
+    const valid = runs.filter((x) => x.status === 'valid').length;
+    const manifest = {
+        mode: 'critique',
+        tier: r.tier,
+        quorum: QUORUM,
+        critiques: runs.map((x) => ({
+            letter: letters.find((l) => l.role === x.role)?.letter ?? null,
+            role: x.role,
+            cli: x.cli,
+            model_reported: x.model,
+            status: x.status,
+            cause: x.cause,
+            verdict: x.verdict,
+            findings: x.findings,
+            veto: x.veto,
+            duration_ms: x.duration_ms,
+        })),
+        valid,
+        partial: valid < QUORUM,
+    };
+    writeFileSync(path.join(dir, 'manifest.json'), `${JSON.stringify(manifest, null, 2)}\n`);
+    // stdout names letters, never roles or models; a failed critic has no letter and is named by CLI, since that is what to fix.
+    const lines = [`out: ${dir}`, `valid: ${valid}  blind: ${runs.filter((x) => x.status === 'blind').length}  failed: ${runs.filter((x) => x.status === 'failed').length}`];
+    for (const x of [...letters].sort((a, b) => a.letter.localeCompare(b.letter))) {
+        lines.push(`  ${x.letter}  ${x.status}  ${x.verdict ?? '-'}  findings=${x.findings}${x.veto ? '  veto' : ''}`);
+    }
+    for (const x of runs.filter((y) => y.status === 'failed'))
+        lines.push(`  failed  ${x.cli}  ${x.cause}`);
+    if (manifest.partial)
+        lines.push(`PARTIAL: fewer than ${QUORUM} valid critiques. Report this as a partial result, not a consensus.`);
+    lines.push(`Read the critique files first; open ${path.join(dir, 'manifest.json')} last.`);
+    return { out: dir, manifest, lines };
+}
+export async function poll(ctx, opts) {
+    const r = resolve(ctx, opts, true);
+    const question = await readInput(ctx, opts.promptFile, '--prompt-file');
+    const prompt = pollPrompt(question, { lens: opts.lens, wrap: opts.wrap !== false });
+    const dir = outDir(ctx, opts.out);
+    ctx.progress(`question: ${question.length} characters · tier: ${r.tier} · models: ${r.clis.length}${opts.lens ? ` · lenses: ${opts.lens}` : ''}`);
+    const runs = await Promise.all(r.clis.map(async (cli) => {
+        let raw;
+        const refused = cli === 'agy' ? tooLong(prompt, `prompt exceeds the ${MAX_ARGV_BYTES}-byte argument limit`) : null;
+        if (refused)
+            raw = refused;
+        else {
+            const inv = buildInvocation(cli, prompt, r.tier, ctx.source);
+            raw = await runCli(inv.cmd, inv.args, inv.stdin, r.timeout, r.env);
+        }
+        writeFileSync(path.join(dir, 'raw', `poll-${cli}.txt`), `${raw.stdout}\n--- stderr ---\n${raw.stderr}\n`);
+        if (!raw.ok)
+            return { cli, status: 'failed', cause: raw.cause ?? null, model: null, text: '' };
+        const { text, model } = normalize(cli, raw);
+        if (!text)
+            return { cli, status: 'failed', cause: 'empty output', model, text };
+        return { cli, status: 'valid', cause: null, model, text };
+    }));
+    // A poll is read model against model (the lens grid's columns are models), so files are named by model here.
+    for (const x of runs.filter((y) => y.status === 'valid'))
+        writeFileSync(path.join(dir, `poll-${x.cli}.md`), `${x.text}\n`);
+    const valid = runs.filter((x) => x.status === 'valid').length;
+    const manifest = {
+        mode: 'poll',
+        tier: r.tier,
+        lens: opts.lens ?? null,
+        quorum: QUORUM,
+        valid,
+        partial: valid < QUORUM,
+        answers: runs.map(({ text: _text, ...rest }) => rest),
+    };
+    writeFileSync(path.join(dir, 'manifest.json'), `${JSON.stringify(manifest, null, 2)}\n`);
+    const lines = [`out: ${dir}`, `valid: ${valid}  failed: ${runs.length - valid}`];
+    for (const x of runs)
+        lines.push(`  ${x.cli}  ${x.status}${x.cause ? `  ${x.cause}` : ''}${x.model ? `  model=${x.model}` : ''}`);
+    if (manifest.partial)
+        lines.push(`PARTIAL: fewer than ${QUORUM} answers. Report it as a partial result.`);
+    return { out: dir, manifest, lines };
+}
+//# sourceMappingURL=modes.js.map

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

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

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

@@ -0,0 +1,18 @@
+import type { Role } from './lineup.js';
+export declare function critiquePrompt(role: Role, plan: string): string;
+/** The built-in lenses, by name, from the roster's `- **name** — description` lines. */
+export declare function lensRoster(): Map<string, string>;
+/**
+ * Splits `--lens` into one string per lens. Lenses are comma-separated, but an inline description may itself
+ * contain commas: a fragment starts a NEW lens only when it is exactly a roster name or begins `Name:`;
+ * any other fragment continues the lens before it. So `minimalist,House taste:blunt, anti-slogan` is two
+ * lenses, and a description must not contain a colon (that would read as the start of another lens).
+ */
+export declare function splitLenses(spec: string, roster: ReadonlyMap<string, string>): string[];
+/** One `- name — description` line per lens; refuses an unknown lens and a count outside two to three. */
+export declare function lensLines(spec: string): string[];
+export declare function pollPrompt(question: string, opts: {
+    lens?: string;
+    wrap: boolean;
+}): string;
+//# sourceMappingURL=prompts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../src/core/second-opinion/prompts.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAUxC,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,wFAAwF;AACxF,wBAAgB,UAAU,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAIhD;AAID;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,EAAE,CAQvF;AAED,0GAA0G;AAC1G,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAehD;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAM3F"}

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

@@ -0,0 +1,65 @@
+import { SecondOpinionUsageError } from '../errors.js';
+import { packagedTemplate, substituteBlock } from '../templates.js';
+/**
+ * run-the-second-opinion-from-the-cli D4: the critic contract, the persona
+ * mandates, the lens roster and the poll scaffolds are package templates
+ * under `templates/second-opinion/`, reviewable as markdown. This module only
+ * assembles them; it carries no prompt prose of its own.
+ */
+const template = (name) => packagedTemplate('second-opinion', name);
+export function critiquePrompt(role, plan) {
+    return `${template('critic-contract').trimEnd()}\n\n---\n${template(`personas/${role}`).trimEnd()}\n\nPLAN:\n${plan}\n`;
+}
+/** The built-in lenses, by name, from the roster's `- **name** — description` lines. */
+export function lensRoster() {
+    const roster = new Map();
+    for (const m of template('lenses').matchAll(/^- \*\*([a-z-]+)\*\* — (.+)$/gm))
+        roster.set(m[1], m[2].trim());
+    return roster;
+}
+const INLINE_LENS = /^[^:,]{1,40}:/;
+/**
+ * Splits `--lens` into one string per lens. Lenses are comma-separated, but an inline description may itself
+ * contain commas: a fragment starts a NEW lens only when it is exactly a roster name or begins `Name:`;
+ * any other fragment continues the lens before it. So `minimalist,House taste:blunt, anti-slogan` is two
+ * lenses, and a description must not contain a colon (that would read as the start of another lens).
+ */
+export function splitLenses(spec, roster) {
+    const lenses = [];
+    for (const fragment of spec.split(',').map((f) => f.trim()).filter(Boolean)) {
+        const startsLens = roster.has(fragment.toLowerCase()) || INLINE_LENS.test(fragment);
+        if (startsLens || lenses.length === 0)
+            lenses.push(fragment);
+        else
+            lenses[lenses.length - 1] += `, ${fragment}`;
+    }
+    return lenses;
+}
+/** One `- name — description` line per lens; refuses an unknown lens and a count outside two to three. */
+export function lensLines(spec) {
+    const roster = lensRoster();
+    const described = [];
+    for (const s of splitLenses(spec, roster)) {
+        const known = roster.get(s.toLowerCase());
+        if (known !== undefined)
+            described.push(`- ${s.toLowerCase()} — ${known}`);
+        else if (INLINE_LENS.test(s)) {
+            const [name, ...rest] = s.split(':');
+            described.push(`- ${name.trim()} — ${rest.join(':').trim()}`);
+        }
+        else {
+            throw new SecondOpinionUsageError(`unknown lens "${s}" (known: ${[...roster.keys()].join(', ')}; or pass "Name:description")`);
+        }
+    }
+    if (described.length < 2 || described.length > 3)
+        throw new SecondOpinionUsageError('--lens takes two or three lenses; keep them orthogonal');
+    return described;
+}
+export function pollPrompt(question, opts) {
+    if (opts.lens) {
+        const withLenses = substituteBlock(template('taste-panel'), '__LENSES__', lensLines(opts.lens));
+        return `${substituteBlock(withLenses, '__QUESTION__', question.split('\n'))}\n`;
+    }
+    return opts.wrap ? `${question}\n\n${template('poll-answer')}` : question;
+}
+//# sourceMappingURL=prompts.js.map

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

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

package/dist/core/session/commit.d.ts

@@ -0,0 +1,29 @@
+import type { GitResult, GitRunner } from '../git/exec.js';
+/**
+ * bring-the-session-lifecycle-into-the-cli D4: one commit call for both
+ * surfaces. Locally it commits as the clone's own git identity, exactly as a
+ * hand-run `git commit` does. The MCP surface passes an author override (the
+ * member's verified email) with a trailer naming them, and the recording
+ * login as committer when the host has no identity of its own — the same
+ * fallback `ctxr land` uses. The store's hooks run either way.
+ */
+export interface CommitOptions {
+    message: string;
+    /** The commit's author, in place of the clone's identity. */
+    author?: {
+        name: string;
+        email: string;
+    };
+    /** A trailer paragraph, e.g. `Edited-by: <email>`. */
+    trailer?: {
+        key: string;
+        value: string;
+    };
+    /** The committer when neither git config nor the environment names one; omitted, git decides. */
+    fallbackCommitter?: string;
+}
+/** The committer: the host's git identity when it has one, else the given login's noreply address. */
+export declare function committerEnv(git: GitRunner, cwd: string, env: Readonly<Record<string, string | undefined>>, login: string): Promise<Record<string, string>>;
+/** Commits what is staged in `cwd`. Resolves with git's result; the caller decides what a refusal means on its surface. */
+export declare function commitStaged(git: GitRunner, cwd: string, env: Readonly<Record<string, string | undefined>>, opts: CommitOptions): Promise<GitResult>;
+//# sourceMappingURL=commit.d.ts.map

package/dist/core/session/commit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit.d.ts","sourceRoot":"","sources":["../../../src/core/session/commit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3D;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,sDAAsD;IACtD,OAAO,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,iGAAiG;IACjG,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,sGAAsG;AACtG,wBAAsB,YAAY,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAKjK;AAED,2HAA2H;AAC3H,wBAAsB,YAAY,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,SAAS,CAAC,CAQ1J"}

package/dist/core/session/commit.js

@@ -0,0 +1,22 @@
+/** The committer: the host's git identity when it has one, else the given login's noreply address. */
+export async function committerEnv(git, cwd, env, login) {
+    const email = (await git.run(['config', '--get', 'user.email'], { cwd, allowFailure: true })).stdout.trim();
+    if (email !== '' || env.GIT_COMMITTER_EMAIL || env.EMAIL)
+        return {};
+    const address = `${login.replace(/\[bot\]$/, '')}@users.noreply.github.com`;
+    return { GIT_COMMITTER_NAME: login, GIT_COMMITTER_EMAIL: address };
+}
+/** Commits what is staged in `cwd`. Resolves with git's result; the caller decides what a refusal means on its surface. */
+export async function commitStaged(git, cwd, env, opts) {
+    const identity = {};
+    if (opts.fallbackCommitter !== undefined)
+        Object.assign(identity, await committerEnv(git, cwd, env, opts.fallbackCommitter));
+    if (opts.author !== undefined)
+        Object.assign(identity, { GIT_AUTHOR_NAME: opts.author.name, GIT_AUTHOR_EMAIL: opts.author.email });
+    const args = ['commit', '--quiet', '-m', opts.message];
+    if (opts.trailer !== undefined)
+        args.push('-m', `${opts.trailer.key}: ${opts.trailer.value}`);
+    const overridden = Object.keys(identity).length > 0;
+    return git.run(args, { cwd, allowFailure: true, ...(overridden ? { env: { ...env, ...identity } } : {}) });
+}
+//# sourceMappingURL=commit.js.map

package/dist/core/session/commit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit.js","sourceRoot":"","sources":["../../../src/core/session/commit.ts"],"names":[],"mappings":"AAoBA,sGAAsG;AACtG,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAc,EAAE,GAAW,EAAE,GAAiD,EAAE,KAAa;IAC9H,MAAM,KAAK,GAAG,CAAC,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE,EAAE,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAC5G,IAAI,KAAK,KAAK,EAAE,IAAI,GAAG,CAAC,mBAAmB,IAAI,GAAG,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACpE,MAAM,OAAO,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,2BAA2B,CAAC;IAC5E,OAAO,EAAE,kBAAkB,EAAE,KAAK,EAAE,mBAAmB,EAAE,OAAO,EAAE,CAAC;AACrE,CAAC;AAED,2HAA2H;AAC3H,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAc,EAAE,GAAW,EAAE,GAAiD,EAAE,IAAmB;IACpI,MAAM,QAAQ,GAA2B,EAAE,CAAC;IAC5C,IAAI,IAAI,CAAC,iBAAiB,KAAK,SAAS;QAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAC7H,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;QAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,eAAe,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,gBAAgB,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IACnI,MAAM,IAAI,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACvD,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS;QAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,KAAK,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IAC9F,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IACpD,OAAO,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,GAAG,GAAG,EAAE,GAAG,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;AAC7G,CAAC"}

package/dist/core/session/discard.d.ts

@@ -0,0 +1,24 @@
+import { type RemoteDeps } from './remote.js';
+import { type SessionRef } from './resolve.js';
+/**
+ * write-lifecycle spec (*`ctxr session discard` removes only a session, and
+ * only clean unless forced*): #31's `abandon` could force-remove any worktree
+ * (bring-the-session-lifecycle-into-the-cli D1, point 4). `resolveSession`
+ * has already refused anything that is not a session; this refuses, without
+ * `--force`, a session whose removal would lose work — uncommitted changes, or
+ * commits its remote branch lacks — and closes a pull request only when asked.
+ */
+export interface DiscardResult {
+    session: string;
+    worktree: string;
+    branch: string;
+    removed: boolean;
+    forced: boolean;
+    /** The pull request `--close-pull-request` closed; null when none was asked for or none was open. */
+    closed_pull_request: number | null;
+}
+export declare function discardSession(deps: RemoteDeps, session: SessionRef, opts?: {
+    force?: boolean;
+    closePullRequest?: boolean;
+}): Promise<DiscardResult>;
+//# sourceMappingURL=discard.d.ts.map

package/dist/core/session/discard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discard.d.ts","sourceRoot":"","sources":["../../../src/core/session/discard.ts"],"names":[],"mappings":"AAIA,OAAO,EAAgD,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAC5F,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/D;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,qGAAqG;IACrG,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAiCD,wBAAsB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAAC,aAAa,CAAC,CAqC9J"}

package/dist/core/session/discard.js

@@ -0,0 +1,68 @@
+import { baseRef, forgeRead } from '../approval/sessions.js';
+import { SessionRefusedError } from '../errors.js';
+import { ExitCode } from '../exit-codes.js';
+import { ForgeRequestError } from '../forge/github.js';
+import { removeSession, remoteTip, SessionRemoteError } from './remote.js';
+import { workingChanges } from './resolve.js';
+/**
+ * The session's commits that are on no remote ref: not on its remote branch,
+ * nor any other this clone has fetched. A session whose pull request was
+ * squash-merged and whose branch was then deleted carries commits on no
+ * remote ref, so a merged pull request at exactly this head counts as published.
+ */
+async function unpublishedCommits(deps, session) {
+    const run = (args) => deps.git.run(args, { cwd: session.path, allowFailure: true });
+    const tip = (await run(['rev-parse', 'HEAD'])).stdout.trim();
+    let remote = null;
+    try {
+        remote = await remoteTip(deps, session.path, session.branch);
+    }
+    catch (err) {
+        if (!(err instanceof SessionRemoteError))
+            throw err;
+    }
+    if (remote === tip)
+        return 0;
+    const exclude = remote !== null && (await run(['cat-file', '-e', `${remote}^{commit}`])).exitCode === 0 ? [`^${remote}`] : [];
+    // The default branch itself never counts: a session's base is already on it.
+    const base = await baseRef(deps.git, session.path, deps.config.git.default_branch);
+    const counted = await run(['rev-list', '--count', 'HEAD', ...exclude, `^${base}`, '--not', '--remotes=origin']);
+    const count = counted.exitCode === 0 ? Number.parseInt(counted.stdout.trim(), 10) || 0 : 0;
+    if (count === 0)
+        return 0;
+    try {
+        const pulls = await deps.forge.pullsForHead(session.branch);
+        if (pulls.some((p) => p.merged && p.headSha === tip))
+            return 0;
+    }
+    catch (err) {
+        if (!(err instanceof ForgeRequestError))
+            throw err;
+    }
+    return count;
+}
+export async function discardSession(deps, session, opts = {}) {
+    const force = opts.force === true;
+    if (!force) {
+        const dirty = await workingChanges(deps.git, session.path);
+        if (dirty.length > 0) {
+            throw new SessionRefusedError(ExitCode.CheckFailed, 'discard_uncommitted', `"${session.name}" has uncommitted changes (${dirty.map((c) => c.path).join(', ')}); discarding it would destroy them. Pass --force to discard them anyway.`, { session: session.name, paths: dirty.map((c) => c.path) }, session.name);
+        }
+        const unpublished = await unpublishedCommits(deps, session);
+        if (unpublished > 0) {
+            throw new SessionRefusedError(ExitCode.CheckFailed, 'discard_unpushed', `"${session.name}" carries ${unpublished} commit(s) its remote branch lacks; discarding it would destroy them. Pass --force to discard them anyway.`, { session: session.name, commits: unpublished }, session.name);
+        }
+    }
+    let closed = null;
+    if (opts.closePullRequest === true) {
+        // Before anything is removed, so a forge that cannot be reached leaves the session as it was.
+        const open = (await forgeRead(() => deps.forge.pullsForHead(session.branch))).find((p) => p.state === 'open');
+        if (open !== undefined) {
+            await forgeRead(() => deps.forge.updatePull(open.number, { state: 'closed' }));
+            closed = open.number;
+        }
+    }
+    await removeSession(deps.git, session.canonical, session);
+    return { session: session.name, worktree: session.path, branch: session.branch, removed: true, forced: force, closed_pull_request: closed };
+}
+//# sourceMappingURL=discard.js.map

package/dist/core/session/discard.js.map

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

package/dist/core/session/list.d.ts

@@ -0,0 +1,48 @@
+import type { StoreConfig } from '../../config/schema.js';
+import type { ReviewStateName } from '../approval/decision.js';
+import { type ForgeClient } from '../forge/github.js';
+import type { GitRunner } from '../git/exec.js';
+/**
+ * write-lifecycle spec (*`ctxr session list` reports each session's state*):
+ * each session's branch, worktree, head, uncommitted state and commits ahead,
+ * all read locally. With `review`, each one's open pull request and, when the
+ * store declares change approval, the decision `ctxr review list` reports for
+ * it. The forge stays behind the option so a plain list never waits on the
+ * network; an unreachable forge reads `unknown`, because the list is an
+ * inventory, not a check (bring-the-session-lifecycle-into-the-cli D3,
+ * revision 1).
+ */
+export interface SessionListEntry {
+    /** The worktree's directory name: what the other session commands take. */
+    name: string;
+    branch: string;
+    worktree: string;
+    head: string;
+    uncommitted: boolean;
+    ahead: number;
+    /** `review` only: the open pull request, null when none is open. */
+    pull_request?: {
+        number: number | null;
+        state: 'open' | 'unknown';
+        url: string | null;
+    } | null;
+    /** `review` with change approval declared: the decision on the open pull request. */
+    review?: {
+        state: ReviewStateName | 'unknown';
+        comment: string | null;
+    } | null;
+}
+export interface ListReview {
+    forge: ForgeClient;
+    /** `change_approval.recording_login`; null when the store declares no change approval. */
+    recordingLogin: string | null;
+}
+export interface SessionList {
+    sessions: SessionListEntry[];
+    /** `review` only: whether the forge answered. */
+    forge_reachable?: boolean;
+}
+export declare function listSessions(git: GitRunner, storeRoot: string, config: StoreConfig, opts?: {
+    review?: ListReview;
+}): Promise<SessionList>;
+//# sourceMappingURL=list.d.ts.map

package/dist/core/session/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/core/session/list.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D,OAAO,EAAqB,KAAK,WAAW,EAAoB,MAAM,oBAAoB,CAAC;AAC3F,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGhD;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,OAAO,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,YAAY,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IAC/F,qFAAqF;IACrF,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,eAAe,GAAG,SAAS,CAAC;QAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;CAChF;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,WAAW,CAAC;IACnB,0FAA0F;IAC1F,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,iDAAiD;IACjD,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAWD,wBAAsB,YAAY,CAAC,GAAG,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,UAAU,CAAA;CAAO,GAAG,OAAO,CAAC,WAAW,CAAC,CA0CnJ"}

package/dist/core/session/list.js

@@ -0,0 +1,55 @@
+import { baseRef, reviewStateOf, sessionWorktrees } from '../approval/sessions.js';
+import { ForgeRequestError } from '../forge/github.js';
+import { commitsAhead, workingChanges } from './resolve.js';
+async function forgeOr(call) {
+    try {
+        return await call();
+    }
+    catch (err) {
+        if (err instanceof ForgeRequestError)
+            return 'unknown';
+        throw err;
+    }
+}
+export async function listSessions(git, storeRoot, config, opts = {}) {
+    const worktrees = await sessionWorktrees(git, storeRoot, config);
+    const base = await baseRef(git, storeRoot, config.git.default_branch);
+    const sessions = await Promise.all(worktrees.map(async (w) => ({
+        name: w.name,
+        branch: w.branch,
+        worktree: w.path,
+        head: (await git.run(['rev-parse', 'HEAD'], { cwd: w.path, allowFailure: true })).stdout.trim(),
+        uncommitted: (await workingChanges(git, w.path)).length > 0,
+        ahead: await commitsAhead(git, w.path, base),
+    })));
+    if (opts.review === undefined)
+        return { sessions };
+    const { forge, recordingLogin } = opts.review;
+    const open = await forgeOr(() => forge.openPulls());
+    let reachable = open !== 'unknown';
+    await Promise.all(sessions.map(async (entry) => {
+        if (open === 'unknown') {
+            entry.pull_request = { number: null, state: 'unknown', url: null };
+            if (recordingLogin !== null)
+                entry.review = { state: 'unknown', comment: null };
+            return;
+        }
+        const pull = open.find((p) => p.headRef === entry.branch);
+        entry.pull_request = pull === undefined ? null : { number: pull.number, state: 'open', url: pull.url };
+        if (recordingLogin === null)
+            return;
+        if (pull === undefined) {
+            entry.review = null;
+            return;
+        }
+        const review = await forgeOr(() => reviewStateOf(git, entry.worktree, base, forge, recordingLogin, pull));
+        if (review === 'unknown') {
+            reachable = false;
+            entry.review = { state: 'unknown', comment: null };
+            return;
+        }
+        entry.review = { state: review.state, comment: review.state === 'changes-requested' ? (review.decision?.comment ?? null) : null };
+    }));
+    return { sessions, forge_reachable: reachable };
+}
+//# sourceMappingURL=list.js.map