@ai-dossier/cli 0.14.0 → 0.19.0

package/dist/commands/sched.js

@@ -0,0 +1,432 @@
+"use strict";
+/**
+ * `ai-dossier sched` — the deterministic scheduler core (RFC-0001 §C.1, issue #460).
+ *
+ * enqueue / status / pause / resume / abandon manage the queue and state
+ * (#460); `sched start` runs the dispatch engine (#464: spawning agent
+ * processes, verifying their completion against ground truth, mechanizing
+ * the stall/escalation ladder) and since #468 also the detached-ship tail:
+ * watching parked PRs, script-based teardown of merged worktrees, and the
+ * cheap-tier report dispatch.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerSchedCommand = registerSchedCommand;
+const node_fs_1 = __importDefault(require("node:fs"));
+const sched_1 = require("@ai-dossier/sched");
+const duration_1 = require("../duration");
+const helpers_1 = require("../helpers");
+const issue_selection_1 = require("../issue-selection");
+const table_1 = require("../table");
+function parseMode(raw) {
+    if (raw === undefined || raw === 'full')
+        return 'full';
+    if (raw === 'slot')
+        return 'slot';
+    (0, helpers_1.fail)([`--mode must be 'full' or 'slot', got '${raw}'`]);
+}
+function parseTier(raw) {
+    if (raw === undefined || raw === 'mid')
+        return 'mid';
+    if (raw === 'mechanical' || raw === 'strong')
+        return raw;
+    (0, helpers_1.fail)([`--tier must be mechanical | mid | strong, got '${raw}'`]);
+}
+/** Parse an issue selection (`4,5` or `4..9`), failing through the CLI's exit path. */
+function issueList(raw, flag) {
+    try {
+        return (0, issue_selection_1.parseIssueSelection)(raw);
+    }
+    catch (err) {
+        (0, helpers_1.fail)([`--${flag}: ${err.message}`]);
+    }
+}
+/**
+ * Resolve the state store: explicit `--project`, else the repo's slug
+ * (gh owner-repo, git toplevel basename fallback — fleet-cycle's convention).
+ */
+function resolveStore(opts) {
+    const project = opts.project ?? (0, sched_1.resolveProjectSlug)(sched_1.defaultExec);
+    if (!opts.project && project === 'default') {
+        console.error('⚠ Could not resolve a repo from the current directory — operating on the "default" state bucket. Run sched from the repo, or pass --project.');
+    }
+    return { store: new sched_1.SchedStore((0, sched_1.schedStateDir)(project)), project };
+}
+/** Route package errors through the CLI's exit path instead of a stack trace. */
+function handleKnownError(err) {
+    if (err instanceof sched_1.CorruptStateError ||
+        err instanceof sched_1.LockTimeoutError ||
+        err instanceof sched_1.EnqueueError ||
+        err instanceof sched_1.IllegalTransitionError ||
+        err instanceof sched_1.SchedNotFoundError) {
+        (0, helpers_1.fail)([err.message]);
+    }
+    throw err;
+}
+// --- status rendering (the CLI's shared table renderer, like every other
+// table-printing command; the package deliberately has no CLI dependencies) ---
+function renderReport(report) {
+    const lines = [];
+    const state = report.paused ? 'PAUSED' : 'running';
+    const runnable = report.runnable_units.length > 0 ? report.runnable_units.join(', ') : 'none';
+    lines.push(`Scheduler [${report.project}]: ${state} · slots ${report.live_slots}/${report.max_slots} live`);
+    lines.push(`Runnable units: ${runnable}`);
+    lines.push('');
+    lines.push('== Queue ==');
+    lines.push((0, table_1.renderTable)(['issue', 'mode', 'batch', 'tier', 'deps', 'status', 'pr', 'cleanup'], report.queue.map((e) => [
+        `#${e.issue}`,
+        e.mode,
+        e.batch ?? '-',
+        e.tier,
+        e.deps.length > 0 ? e.deps.map((d) => `#${d}`).join(',') : '-',
+        e.status,
+        e.pr !== null && e.pr !== undefined ? String(e.pr) : '-',
+        e.cleanup ?? '-',
+    ])));
+    lines.push('');
+    if (report.parked.length > 0) {
+        const lastPoll = report.last_pr_poll_at
+            ? `; last poll ${relativeTime(report.last_pr_poll_at)}`
+            : '; never polled';
+        lines.push(`== Parked PRs (watched, zero slots${lastPoll}) ==`);
+        lines.push(report.parked
+            .map((p) => `#${p.issue} — PR #${p.pr} (parked ${relativeTime(p.since)})`)
+            .join('\n'));
+        lines.push('');
+    }
+    lines.push('== Slots ==');
+    lines.push(report.slots.length === 0
+        ? '(no slots materialized yet)'
+        : (0, table_1.renderTable)(['slot', 'status', 'unit', 'pid', 'phase', 'last-progress', 'recoveries'], report.slots.map((s) => [
+            String(s.id),
+            s.status,
+            s.unit ?? '-',
+            s.pid !== null ? String(s.pid) : '-',
+            s.phase ?? '-',
+            s.last_progress_at !== null ? relativeTime(s.last_progress_at) : '-',
+            String(s.recoveries),
+        ])));
+    lines.push('');
+    lines.push('== Batches ==');
+    lines.push(report.batches.length === 0
+        ? '(no batches)'
+        : (0, table_1.renderTable)(['batch', 'status', 'members', 'member-in-work'], report.batches.map((b) => [
+            b.id,
+            b.status,
+            b.members.length > 0 ? b.members.map((m) => `#${m}`).join(',') : '-',
+            b.executing_member > 0 ? `${b.executing_member}/${b.members.length}` : '-',
+        ])));
+    lines.push('');
+    lines.push('== Blocked ==');
+    lines.push(report.blocked.length > 0
+        ? report.blocked.map((b) => `#${b.issue} [${b.status}] — ${b.reason}`).join('\n')
+        : '(none)');
+    lines.push('');
+    lines.push('== Failed ==');
+    lines.push(report.failed.length > 0
+        ? report.failed.map((f) => `#${f.issue} — ${f.reason ?? f.status}`).join('\n')
+        : '(none)');
+    return lines.join('\n');
+}
+/** `5m ago` / `2h ago` — compact last-progress rendering for the slot table. */
+function relativeTime(iso, now = Date.now()) {
+    const then = Date.parse(iso);
+    if (Number.isNaN(then))
+        return '-';
+    return (0, duration_1.formatAge)(Math.max(0, now - then), ' ago');
+}
+// --- subcommands ---
+function registerEnqueueSubcommand(cmd) {
+    cmd
+        .command('enqueue')
+        .description('Add issues to the scheduler queue (flags, a --from-manifest JSON file, or both)')
+        .option('--issues <numbers>', 'Comma-separated issue numbers or ranges, e.g. 101,105..109')
+        .option('--mode <mode>', "Execution mode: 'full' (default) or 'slot'", 'full')
+        .option('--batch <id>', 'Batch id (required for slot mode)')
+        .option('--deps <numbers>', 'Comma-separated dependency issue numbers (applied to all)')
+        .option('--tier <tier>', 'Model tier: mechanical | mid (default) | strong', 'mid')
+        .option('--from-manifest <path>', 'JSON file of entries (batch-prep output)')
+        .option('--project <slug>', 'Project slug (default: owner-repo of the current directory)')
+        .option('--json', 'Output the result as JSON')
+        .action((opts) => {
+        const { store, project } = resolveStore(opts);
+        const inputs = [];
+        let manifestProject = null;
+        if (opts.fromManifest) {
+            let raw;
+            try {
+                raw = node_fs_1.default.readFileSync(opts.fromManifest, 'utf-8');
+            }
+            catch (err) {
+                (0, helpers_1.fail)([`Cannot read manifest ${opts.fromManifest}: ${err.message}`]);
+            }
+            let parsed;
+            try {
+                parsed = JSON.parse(raw);
+            }
+            catch (err) {
+                (0, helpers_1.fail)([`Manifest is not valid JSON: ${err.message}`]);
+            }
+            if (parsed &&
+                typeof parsed === 'object' &&
+                typeof parsed.project === 'string') {
+                manifestProject = parsed.project;
+            }
+            try {
+                inputs.push(...(0, sched_1.parseManifest)(parsed));
+            }
+            catch (err) {
+                (0, helpers_1.fail)([err.message]);
+            }
+        }
+        if (manifestProject !== null && manifestProject !== project) {
+            console.error(`⚠ Manifest was prepared for project '${manifestProject}' but enqueueing into '${project}'`);
+        }
+        if (opts.issues) {
+            const mode = parseMode(opts.mode);
+            const tier = parseTier(opts.tier);
+            const deps = opts.deps ? issueList(opts.deps, 'deps') : [];
+            for (const issue of issueList(opts.issues, 'issues')) {
+                inputs.push({ issue, mode, batch: opts.batch ?? null, deps, tier });
+            }
+        }
+        if (inputs.length === 0) {
+            (0, helpers_1.fail)(['Nothing to enqueue — pass --issues or --from-manifest']);
+        }
+        let enqueued;
+        try {
+            enqueued = store.withLock((state) => {
+                const next = (0, sched_1.enqueueEntries)(state, inputs);
+                return { state: next, result: next.entries.length };
+            });
+        }
+        catch (err) {
+            handleKnownError(err);
+        }
+        if (opts.json) {
+            console.log(JSON.stringify({ project, enqueued: inputs.length, queue_depth: enqueued }));
+        }
+        else {
+            console.log(`✓ Enqueued ${inputs.length} issue(s) for ${project} (queue depth: ${enqueued})`);
+        }
+    });
+}
+function registerStatusSubcommand(cmd) {
+    cmd
+        .command('status')
+        .description('Render the queue, slots, batches, and blocked/failed sets')
+        .option('--project <slug>', 'Project slug (default: owner-repo of the current directory)')
+        .option('--json', 'Output the report as JSON')
+        .action((opts) => {
+        const { store, project } = resolveStore(opts);
+        try {
+            const report = (0, sched_1.buildStatusReport)(store.load(), store.loadConfig(), project);
+            if (opts.json) {
+                console.log(JSON.stringify(report, null, 2));
+            }
+            else {
+                console.log(renderReport(report));
+            }
+        }
+        catch (err) {
+            handleKnownError(err);
+        }
+    });
+}
+function registerPauseResumeSubcommand(cmd, pause) {
+    cmd
+        .command(pause ? 'pause' : 'resume')
+        .description(pause
+        ? 'Stop making new slot assignments (live units keep running)'
+        : 'Resume making new slot assignments')
+        .option('--project <slug>', 'Project slug (default: owner-repo of the current directory)')
+        .option('--json', 'Output the result as JSON')
+        .action((opts) => {
+        const { store, project } = resolveStore(opts);
+        try {
+            const paused = store.withLock((state) => ({
+                state: (0, sched_1.setPaused)(state, pause),
+                result: pause,
+            }));
+            if (opts.json) {
+                console.log(JSON.stringify({ project, paused }));
+            }
+            else {
+                console.log(paused ? '⏸ Scheduler paused' : '▶ Scheduler resumed');
+            }
+        }
+        catch (err) {
+            handleKnownError(err);
+        }
+    });
+}
+function registerAbandonSubcommand(cmd) {
+    cmd
+        .command('abandon')
+        .description('Fail an issue entry (or dissolve a batch and requeue its members as full-cycle)')
+        .option('--issue <number>', 'Issue number to abandon')
+        .option('--batch <id>', 'Batch id to dissolve')
+        .option('--reason <text>', 'Reason recorded on the entry')
+        .option('--project <slug>', 'Project slug (default: owner-repo of the current directory)')
+        .option('--json', 'Output the result as JSON')
+        .action((opts) => {
+        if ((opts.issue ? 1 : 0) + (opts.batch ? 1 : 0) !== 1) {
+            (0, helpers_1.fail)(['Pass exactly one of --issue <number> or --batch <id>']);
+        }
+        const { store } = resolveStore(opts);
+        const reason = opts.reason ?? 'abandoned';
+        try {
+            if (opts.issue) {
+                const issue = issueList(opts.issue, 'issue')[0];
+                const result = store.withLock((state) => {
+                    const r = (0, sched_1.abandonIssue)(state, issue, reason);
+                    return { state: r.state, result: r.releasedSlots };
+                });
+                if (opts.json) {
+                    console.log(JSON.stringify({ abandoned: `issue:${issue}`, released_slots: result }));
+                }
+                else {
+                    console.log(`✓ Abandoned issue #${issue} (released ${result.length} slot(s))`);
+                }
+            }
+            else if (opts.batch) {
+                const requeued = store.withLock((state) => {
+                    const r = (0, sched_1.abandonBatch)(state, opts.batch, reason);
+                    return { state: r.state, result: r.requeued };
+                });
+                if (opts.json) {
+                    console.log(JSON.stringify({ abandoned: `batch:${opts.batch}`, requeued }));
+                }
+                else {
+                    console.log(`✓ Dissolved batch ${opts.batch}; requeued ${requeued.length} member(s) as full-cycle`);
+                }
+            }
+        }
+        catch (err) {
+            handleKnownError(err);
+        }
+    });
+}
+function registerStartSubcommand(cmd) {
+    cmd
+        .command('start')
+        .description('Run the dispatch engine: spawn agents, verify completion, escalate stalls, watch parked PRs, tear down merged worktrees, dispatch report agents (Ctrl-C stops the engine; agents keep running)')
+        .option('--interval <seconds>', 'Reconcile tick interval in seconds (default 60)', Number.parseInt)
+        .option('--once', 'Run a single reconcile+refill tick and exit (cron-style)')
+        .option('--project <slug>', 'Project slug (default: owner-repo of the current directory)')
+        .option('--json', 'Output tick results as JSON')
+        .action(async (opts) => {
+        const { store, project } = resolveStore(opts);
+        let config;
+        try {
+            config = store.loadConfig();
+        }
+        catch (err) {
+            handleKnownError(err);
+        }
+        // CLI flag beats config.json beats the engine default (60s).
+        if (opts.interval !== undefined) {
+            if (!Number.isInteger(opts.interval) || opts.interval <= 0) {
+                (0, helpers_1.fail)(['--interval must be a positive number of seconds']);
+            }
+            config = { ...config, reconcile_interval_ms: opts.interval * 1000 };
+        }
+        // Resolve the agent command: config dispatch.command wins; otherwise
+        // auto-detect (claude first, opencode fallback — the run machinery's
+        // order, #459) and use the matching headless template.
+        const dispatchCommand = config.dispatch?.command ??
+            ((0, helpers_1.detectLlm)('auto', true) === 'opencode' ? [...sched_1.OPENCODE_DISPATCH_COMMAND] : undefined);
+        const engineConfig = dispatchCommand
+            ? { ...config, dispatch: { ...config.dispatch, command: dispatchCommand } }
+            : config;
+        const deps = {
+            store,
+            journal: new sched_1.Journal(store.dir),
+            groundTruth: (0, sched_1.createExecGroundTruth)(undefined, { repoDir: process.cwd() }),
+            spawnDeps: (0, sched_1.createSpawnDeps)(process.cwd()),
+            now: () => new Date(),
+            repoDir: process.cwd(),
+            teardownExec: (0, sched_1.createExecFn)(sched_1.TEARDOWN_TIMEOUT_MS, {
+                onError: (file, args, err) => process.stderr.write(`⚠ sched teardown: '${file} ${args.join(' ')}' failed: ${err.message}\n`),
+            }),
+        };
+        const describe = (result) => {
+            const parts = [];
+            if (result.spawned.length > 0)
+                parts.push(`spawned ${result.spawned.join(', ')}`);
+            if (result.parked.length > 0)
+                parts.push(`parked ${result.parked.join(', ')}`);
+            if (result.mergeAccepted.length > 0)
+                parts.push(`merge accepted ${result.mergeAccepted.join(', ')}`);
+            if (result.teardownDone.length > 0)
+                parts.push(`teardown done ${result.teardownDone.join(', ')}`);
+            if (result.teardownFailed.length > 0)
+                parts.push(`teardown failed ${result.teardownFailed.join(', ')}`);
+            if (result.reportDispatched.length > 0)
+                parts.push(`report dispatched ${result.reportDispatched.join(', ')}`);
+            if (result.reportWaiting > 0)
+                parts.push(`${result.reportWaiting} report(s) waiting for a free slot`);
+            if (result.externalAdvances.length > 0)
+                parts.push(`externally completed ${result.externalAdvances.join(', ')}`);
+            if (result.completed.length > 0)
+                parts.push(`completed ${result.completed.join(', ')}`);
+            if (result.redispatched.length > 0)
+                parts.push(`redispatched ${result.redispatched.join(', ')}`);
+            if (result.failed.length > 0)
+                parts.push(`failed ${result.failed.join(', ')}`);
+            if (result.blocked.length > 0)
+                parts.push(`blocked ${result.blocked.map((i) => `#${i}`).join(', ')}`);
+            return parts.length > 0 ? parts.join(' · ') : 'nothing to do';
+        };
+        if (opts.once) {
+            let result;
+            try {
+                result = (0, sched_1.tick)(deps, engineConfig);
+            }
+            catch (err) {
+                // Route known package errors through the CLI exit path; any other
+                // failure must not surface as an unhandled async rejection (this is
+                // the cron path).
+                handleKnownError(err);
+                (0, helpers_1.fail)([`sched tick failed: ${err.name}: ${err.message}`]);
+            }
+            if (opts.json) {
+                console.log(JSON.stringify(result, null, 2));
+            }
+            else {
+                console.log(`✓ [${project}] tick: ${describe(result)}`);
+            }
+            return;
+        }
+        const interval = (engineConfig.reconcile_interval_ms ?? sched_1.DEFAULT_RECONCILE_INTERVAL_MS) / 1000;
+        console.log(`▶ Scheduler engine running for ${project} (tick every ${interval}s, Ctrl-C to stop)`);
+        let stopping = false;
+        process.on('SIGINT', () => {
+            if (stopping)
+                process.exit(130);
+            stopping = true;
+            console.log('\n⏹ Stopping engine (spawned agents keep running)…');
+        });
+        await (0, sched_1.runLoop)(deps, engineConfig, () => stopping, (result) => {
+            if (!opts.json)
+                console.log(`✓ [${new Date().toISOString()}] ${describe(result)}`);
+            else
+                console.log(JSON.stringify({ ts: new Date().toISOString(), ...result }));
+        });
+        console.log('⏹ Engine stopped');
+    });
+}
+function registerSchedCommand(program) {
+    const schedCmd = program
+        .command('sched')
+        .description('Deterministic scheduler core — queue, slots, dispatch, verification, stall ladder (RFC-0001)');
+    registerEnqueueSubcommand(schedCmd);
+    registerStatusSubcommand(schedCmd);
+    registerPauseResumeSubcommand(schedCmd, true);
+    registerPauseResumeSubcommand(schedCmd, false);
+    registerAbandonSubcommand(schedCmd);
+    registerStartSubcommand(schedCmd);
+}
+//# sourceMappingURL=sched.js.map

package/dist/commands/sched.js.map

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

package/dist/gh.d.ts

@@ -0,0 +1,155 @@
+/**
+ * Shared subprocess plumbing for issue-comment-backed protocols (runstate:v1,
+ * plan:v1).
+ *
+ * Every command that reads or writes GitHub issue comments through `gh` needs the
+ * same things: run a subprocess and keep WHY it failed, turn `gh`'s stderr into a
+ * named cause with a fix, parse `--json` output without a throw, and reject
+ * values that cannot be safely passed on a command line. These lived privately in
+ * `commands/runstate.ts` until the second consumer (`commands/plan.ts`) arrived;
+ * they are extracted verbatim rather than reimplemented per command — and anything
+ * BOTH command suites do (fetch comments, post a comment, print a dry-run) lives
+ * here once, not twice.
+ */
+/**
+ * Fail on stderr and exit 1, so a calling dossier can detect it.
+ *
+ * Each entry is one problem. An entry may span lines: the first gets the ❌, the rest are
+ * indented under it, which is how a cause line and its "Fix:" line stay visibly one item.
+ */
+export declare function fail(lines: string[]): never;
+/** Why a subprocess did not produce output — enough to name the actual cause. */
+export interface ExecFailure {
+    /** The binary itself is missing from PATH (ENOENT), rather than having exited non-zero. */
+    notFound: boolean;
+    /** The process was killed after {@link EXEC_TIMEOUT_MS} instead of answering. */
+    timedOut: boolean;
+    /** Exit status, or null when the process never ran or was killed by a signal. */
+    status: number | null;
+    /** Whatever the command wrote to stderr, falling back to the thrown message. */
+    stderr: string;
+}
+export type ExecResult = {
+    ok: true;
+    stdout: string;
+} | {
+    ok: false;
+    error: ExecFailure;
+};
+/**
+ * Run a command, keeping WHY it failed.
+ *
+ * The whole point of the comment-protocol subcommands is that agents were silently
+ * getting things wrong, so a discarded stderr is the one thing we cannot afford:
+ * "gh is not installed", "gh is not logged in", and "issue 440 does not exist" need
+ * three different fixes and are indistinguishable without it. A hard timeout keeps a
+ * network-stalled gh from hanging an agent-driven run with nothing to debug.
+ */
+export declare function exec(file: string, args: string[]): ExecResult;
+/**
+ * Collapse output to one bounded line so a huge or binary payload stays readable.
+ * Control characters (ANSI/OSC escapes included) are stripped — snippets come from
+ * network-reachable comment bodies, and a terminal escape re-emitted raw can
+ * rewrite the operator's screen or clipboard.
+ */
+export declare function snippet(text: string, max?: number): string;
+/**
+ * `JSON.parse` for a `gh --json` payload: `null` instead of a throw, and the caller's
+ * declared shape instead of `any`. Every gh call here reads a `--json` payload, so all
+ * call sites need the same "gh exited 0 but printed something that is not JSON" branch —
+ * they differ only in what they say about it. Fields stay `unknown` because gh's output is
+ * remote data — {@link asString} narrows each one at the point of use.
+ */
+export declare function parseGhJson<T>(raw: string): T | null;
+/** A JSON field as a string, or `fallback` when gh omitted it or sent another type. */
+export declare function asString(value: unknown, fallback?: string): string;
+/**
+ * Turn a failed `gh` invocation into a message that names the cause and the fix.
+ *
+ * `action` is what we were trying to do, e.g. "Could not read issue #440".
+ */
+export declare function ghFailure(action: string, err: ExecFailure, repo?: string): string;
+/** GitHub issue numbers are positive integers; anything else is a caller mistake. */
+export declare function isIssueNumber(value: string): boolean;
+/** Reject a non-numeric `--issue` here rather than letting gh (or `mint`) fail obscurely. */
+export declare function requireIssueNumber(issue: string): void;
+/** `--repo owner/name` appended to a gh invocation when the caller supplied one. */
+export declare function repoArgs(repo?: string): string[];
+/** Reject a `--repo` that is not a repository slug before handing it to gh. */
+export declare function requireRepoSlug(repo?: string): void;
+/**
+ * The `--issue`/`--repo` checks every issue-targeting subcommand runs before it starts.
+ * Kept together so a new subcommand cannot pick up one guard and miss the other.
+ */
+export declare function requireIssueTarget(options: {
+    issue: string;
+    repo?: string;
+}): void;
+/**
+ * Whether a value read back OUT of a comment may be passed to `git`/`gh`.
+ *
+ * These values are attacker-reachable: anyone who can comment on the issue can post a
+ * protocol comment, so values like `branch=`, `head=` and `pr=` arrive from the network
+ * rather than from the caller. Every invocation here is `execFileSync` with an argument
+ * array and no shell, so there is no command injection — but a value that begins with `-`
+ * is still read as a FLAG rather than as data. `gh` (cobra) parses flags interspersed with
+ * positionals, so `pr=--repo=someone/else` or `pr=--web` would silently retarget, or add a
+ * side effect to, a subcommand documented as strictly read-only.
+ */
+export declare function isSafeArg(value: string): boolean;
+/**
+ * Paths are only ever passed in value position (`git -C <path>`) or to `fs.statSync`, so
+ * they cannot be mistaken for a flag — but the protocol requires them absolute, and a
+ * relative path from a forged comment would resolve against whatever directory the agent
+ * happens to be in.
+ */
+export declare function isSafePath(value: string): boolean;
+/** Formats why a local `git` probe could not answer — shared by every git-reading command. */
+export declare function gitFailure(err: ExecFailure): string;
+/** A comment as gh reports it; every field but `body` may be absent. */
+export interface GhComment {
+    body?: unknown;
+    url?: unknown;
+    createdAt?: unknown;
+    author?: {
+        login?: unknown;
+    } | null;
+    authorAssociation?: unknown;
+}
+/** A comment-read, or the one reason it could not be read. */
+export type CommentsResult = {
+    ok: true;
+    comments: GhComment[];
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * Read an issue's comments through gh, reporting WHY rather than exiting.
+ *
+ * The single-issue subcommands turn a failure here into an immediate exit; `stats
+ * --issues` cannot, because one unreadable issue in a set must not discard the rest. So
+ * the decision of what a failure means belongs to the caller, and this function only
+ * reports it.
+ */
+export declare function tryFetchComments(issue: string, repo?: string): CommentsResult;
+/** `--dry-run` support for comment-posting subcommands: show the body, post nothing. */
+export declare function printDryRun(body: string, json?: boolean, extra?: Record<string, unknown>): void;
+/**
+ * Comment `body` onto an issue, with the shared failure taxonomy, the paste-safe retry
+ * hint, and the success output both protocols use.
+ *
+ * `jsonExtras` merge into the `--json` result (e.g. `head` for plans); `successLine`
+ * renders the human-mode success line for the caller's protocol.
+ */
+export declare function postIssueComment(options: {
+    issue: string;
+    repo?: string;
+    body: string;
+    noun: string;
+    action: string;
+    json?: boolean;
+    jsonExtras?: Record<string, unknown>;
+    successLine: (url: string) => string;
+}): void;
+//# sourceMappingURL=gh.d.ts.map

package/dist/gh.d.ts.map

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