@ai-dossier/cli 0.9.1 → 0.11.0

package/dist/runstate.d.ts

@@ -0,0 +1,177 @@
+/**
+ * Runstate protocol (`runstate:v1`) — the milestone comments issue-workflow dossiers
+ * append to a GitHub issue after every phase.
+ *
+ * This module is the executable copy of the "Runstate Milestones" table in
+ * `imboard-ai/git/full-cycle-issue@3.8.0`. Dossiers used to ask agents to reproduce a
+ * markdown heredoc by hand; smaller models skipped it or pasted `$(date …)` literally.
+ * Everything here is pure and dependency-free so it can be unit tested without touching
+ * `gh`, the network, or the filesystem.
+ */
+/** Marker that opens every runstate comment. Readers filter on this exact prefix. */
+export declare const RUNSTATE_MARKER = "<!-- runstate:v1 -->";
+/** Workflow phases, in execution order. */
+export declare const PHASES: readonly ["gate", "setup", "plan", "implement", "review", "ship", "report"];
+export type Phase = (typeof PHASES)[number];
+/** Milestone statuses. */
+export declare const STATUSES: readonly ["done", "partial", "blocked", "awaiting-merge"];
+export type Status = (typeof STATUSES)[number];
+/**
+ * Keys whose values are paths and must therefore be absolute — the dossier rule is
+ * "paths are absolute", and a relative worktree path makes a resume unresolvable from
+ * a different working directory.
+ */
+export declare const PATH_KEYS: readonly ["worktree", "planning"];
+/**
+ * Per-phase specification, transcribed from full-cycle-issue@3.8.0.
+ *
+ * `statuses` is the closed set a phase may report. `required` maps each status to the
+ * keys that must accompany it. `status=blocked` additionally requires `reason` for every
+ * phase (see {@link BLOCKED_REQUIRED}) — the dossier rule is "If a phase aborts, post
+ * `status=blocked` with `reason=<short-slug>` before stopping".
+ */
+export interface PhaseSpec {
+    statuses: readonly Status[];
+    required: Partial<Record<Status, readonly string[]>>;
+}
+/** Keys required whenever a phase reports `status=blocked`. */
+export declare const BLOCKED_REQUIRED: readonly ["reason"];
+/**
+ * Caps that keep a milestone postable. GitHub rejects an issue comment over 65536
+ * characters with an opaque 422, and `execFileSync` hits E2BIG well before that on some
+ * platforms — both surface as "gh failed" with no hint that size was the cause. Checking
+ * here turns those into a named key and a number.
+ */
+export declare const MAX_VALUE_LENGTH = 4000;
+export declare const MAX_BODY_LENGTH = 60000;
+export declare const PHASE_SPECS: Record<Phase, PhaseSpec>;
+/** Consecutive `blocked` milestones on one phase that mean the run is looping. */
+export declare const RESUME_LOOP_CAP = 3;
+/** Every value `next=` may legally carry: a phase to re-enter, or `done`. */
+export declare const NEXT_VALUES: readonly string[];
+/** GitHub issue numbers are positive integers; anything else is a caller mistake. */
+export declare function isIssueNumber(value: string): boolean;
+/** True when `key` may carry spaces in its value. */
+export declare function isAcKey(key: string): boolean;
+export declare function isPhase(value: string): value is Phase;
+export declare function isStatus(value: string): value is Status;
+/**
+ * The phase that follows `phase`, for the milestone's `next=` line.
+ *
+ * - `blocked` ends the run, so `next=done`.
+ * - the two non-terminal statuses keep the run inside the same phase: ship's
+ *   `awaiting-merge` is the FIRST of ship's two milestones (CI wait, then teardown),
+ *   and a `partial` review still has agents left to run — which is exactly how
+ *   gate-issue's resume table reads them back.
+ * - otherwise the linear order gate → setup → plan → implement → review → ship →
+ *   report → done.
+ */
+export declare function defaultNext(phase: Phase, status: Status): Phase | 'done';
+/** The keys `phase` must carry when reporting `status`. */
+export declare function requiredKeys(phase: Phase, status: Status): readonly string[];
+export interface MilestoneInput {
+    phase: string;
+    status: string;
+    run: string;
+    /** Phase-specific `key=value` pairs, in the order they should be emitted. */
+    keys?: Array<[string, string]>;
+    /** Override the computed `next=` value. */
+    next?: string;
+    /** Override the timestamp (tests); defaults to now. */
+    at?: string;
+}
+/**
+ * Validate a milestone against the protocol.
+ *
+ * @returns one actionable line per problem; an empty array means valid.
+ */
+export declare function validateMilestone(input: MilestoneInput): string[];
+/** Current time as `YYYY-MM-DDTHH:MM:SSZ` (the dossier template's `date -u` format). */
+export declare function nowStamp(date?: Date): string;
+/**
+ * Build the milestone comment body. Does not validate — call
+ * {@link validateMilestone} first.
+ */
+export declare function buildMilestone(input: MilestoneInput): string;
+/**
+ * Split one `key=value` token at its FIRST `=`, so a value may itself contain `=`.
+ * Returns null when nothing precedes the separator.
+ *
+ * The single definition of the pair grammar: {@link parseMilestone} reads it back off an
+ * issue comment and the `--kv` flag parser reads it off argv, and the two must agree.
+ */
+export declare function splitPair(token: string): [string, string] | null;
+export interface ParsedMilestone {
+    phase: string;
+    status: string;
+    run: string;
+    at: string;
+    next: string;
+    /** Every `key=value` line, including the ones from the header line. */
+    keys: Record<string, string>;
+}
+/**
+ * Parse a runstate comment body. Returns `null` when `body` is not a runstate comment.
+ *
+ * Tolerant by design: a milestone posted by an older dossier (or a hand-written one)
+ * should still be readable by `runstate last` even if it would not pass validation.
+ */
+export declare function parseMilestone(body: string): ParsedMilestone | null;
+/** Extract every runstate milestone from a list of comment bodies, oldest first. */
+export declare function parseMilestones(bodies: string[]): ParsedMilestone[];
+/** Mint a fresh run id: `r-<issue>-<4 hex>`. */
+export declare function mintRunId(issue: number | string): string;
+/**
+ * The world-facing checks the resume table needs. Injected so {@link computeResume}
+ * stays pure and testable — the command layer supplies the `git`/`gh`/`fs` versions.
+ */
+export interface ResumeProbe {
+    /** `git ls-remote --exit-code origin <branch>` succeeds. */
+    branchOnRemote(branch: string): boolean;
+    /** The worktree directory exists. */
+    dirExists(path: string): boolean;
+    /** The planning file exists. */
+    fileExists(path: string): boolean;
+    /** `git -C <worktree> rev-parse --short HEAD`, or null if it fails. */
+    headOf(worktree: string): string | null;
+    /** `gh pr view <pr> --json state,mergedAt,mergeable`, or null if it fails. */
+    prState(pr: string): {
+        state: string;
+        mergedAt: string | null;
+        mergeable: string;
+    } | null;
+    /** The issue's state is CLOSED. */
+    issueClosed(): boolean;
+}
+export interface ResumeResult {
+    /** Phase to resume from: a phase name, `ship-wait`, `ship-teardown`, `done`, or `none`. */
+    resume_from: string;
+    /** The run id to reuse, or null on a fresh run. */
+    run_id: string | null;
+    /** Checks that passed, for the gate milestone's `verified=` key. */
+    verified: string[];
+    /**
+     * Merged `key=value` state for the run: every milestone's keys, later milestones
+     * winning. Merged rather than last-only because a resume at `plan` still needs
+     * `branch`/`worktree` from the `setup` milestone.
+     */
+    resume_context: Record<string, string>;
+    /** The last milestone, or null on a fresh run. */
+    last: ParsedMilestone | null;
+    /** Set when the run must hard-block instead of resuming (currently `resume-loop`). */
+    hard_block?: string;
+    /** Human-readable note, e.g. "already complete". */
+    note?: string;
+}
+/**
+ * True when the last {@link RESUME_LOOP_CAP} milestones are all `blocked` on the same
+ * phase — the run is retrying the same wall and needs a human, not another resume.
+ */
+export declare function hitLoopCap(milestones: ParsedMilestone[]): boolean;
+/**
+ * Resolve where a run should resume from, implementing the resume verification table in
+ * `imboard-ai/git/gate-issue`. Never trusts the milestone alone — every claim is checked
+ * against reality through `probe`, and {@link PHASE_RESUMERS} holds the per-phase rules.
+ */
+export declare function computeResume(milestones: ParsedMilestone[], probe: ResumeProbe): ResumeResult;
+//# sourceMappingURL=runstate.d.ts.map

package/dist/runstate.d.ts.map

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

package/dist/runstate.js

@@ -0,0 +1,438 @@
+"use strict";
+/**
+ * Runstate protocol (`runstate:v1`) — the milestone comments issue-workflow dossiers
+ * append to a GitHub issue after every phase.
+ *
+ * This module is the executable copy of the "Runstate Milestones" table in
+ * `imboard-ai/git/full-cycle-issue@3.8.0`. Dossiers used to ask agents to reproduce a
+ * markdown heredoc by hand; smaller models skipped it or pasted `$(date …)` literally.
+ * Everything here is pure and dependency-free so it can be unit tested without touching
+ * `gh`, the network, or the filesystem.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NEXT_VALUES = exports.RESUME_LOOP_CAP = exports.PHASE_SPECS = exports.MAX_BODY_LENGTH = exports.MAX_VALUE_LENGTH = exports.BLOCKED_REQUIRED = exports.PATH_KEYS = exports.STATUSES = exports.PHASES = exports.RUNSTATE_MARKER = void 0;
+exports.isIssueNumber = isIssueNumber;
+exports.isAcKey = isAcKey;
+exports.isPhase = isPhase;
+exports.isStatus = isStatus;
+exports.defaultNext = defaultNext;
+exports.requiredKeys = requiredKeys;
+exports.validateMilestone = validateMilestone;
+exports.nowStamp = nowStamp;
+exports.buildMilestone = buildMilestone;
+exports.splitPair = splitPair;
+exports.parseMilestone = parseMilestone;
+exports.parseMilestones = parseMilestones;
+exports.mintRunId = mintRunId;
+exports.hitLoopCap = hitLoopCap;
+exports.computeResume = computeResume;
+const node_crypto_1 = require("node:crypto");
+/** Marker that opens every runstate comment. Readers filter on this exact prefix. */
+exports.RUNSTATE_MARKER = '<!-- runstate:v1 -->';
+/** Workflow phases, in execution order. */
+exports.PHASES = ['gate', 'setup', 'plan', 'implement', 'review', 'ship', 'report'];
+/** Milestone statuses. */
+exports.STATUSES = ['done', 'partial', 'blocked', 'awaiting-merge'];
+/**
+ * Keys whose values are paths and must therefore be absolute — the dossier rule is
+ * "paths are absolute", and a relative worktree path makes a resume unresolvable from
+ * a different working directory.
+ */
+exports.PATH_KEYS = ['worktree', 'planning'];
+/** Keys required whenever a phase reports `status=blocked`. */
+exports.BLOCKED_REQUIRED = ['reason'];
+/**
+ * Caps that keep a milestone postable. GitHub rejects an issue comment over 65536
+ * characters with an opaque 422, and `execFileSync` hits E2BIG well before that on some
+ * platforms — both surface as "gh failed" with no hint that size was the cause. Checking
+ * here turns those into a named key and a number.
+ */
+exports.MAX_VALUE_LENGTH = 4000;
+exports.MAX_BODY_LENGTH = 60000;
+/**
+ * `review` reports the same keys whether it finished or still has agents pending, so the
+ * list lives once — a key added to one status must never drift from the other.
+ */
+const REVIEW_KEYS = ['head', 'fixed', 'escalated', 'agents_done', 'agents_pending'];
+exports.PHASE_SPECS = {
+    gate: {
+        statuses: ['done', 'blocked'],
+        required: { done: ['base_branch', 'warnings'] },
+    },
+    setup: {
+        statuses: ['done', 'blocked'],
+        required: { done: ['branch', 'worktree', 'pool_claimed', 'base_branch'] },
+    },
+    plan: {
+        statuses: ['done', 'blocked'],
+        required: { done: ['planning', 'head', 'open_questions', 'visual_review'] },
+    },
+    implement: {
+        statuses: ['done', 'blocked'],
+        required: { done: ['head', 'files', 'tests_added', 'tests_run', 'ci_parity'] },
+    },
+    review: {
+        statuses: ['done', 'partial', 'blocked'],
+        required: { done: REVIEW_KEYS, partial: REVIEW_KEYS },
+    },
+    ship: {
+        statuses: ['awaiting-merge', 'done', 'blocked'],
+        required: {
+            'awaiting-merge': ['pr', 'head', 'ci_fix_attempts'],
+            done: ['pr', 'merge_commit', 'ci_fix_attempts', 'cleanup'],
+        },
+    },
+    report: {
+        statuses: ['done'],
+        required: { done: ['pr', 'traps_added'] },
+    },
+};
+/**
+ * `r-<issue>-<hex>`, minted once per run by the gate phase. Accepts four or more hex
+ * chars so a longer id from another minter still reads back as valid.
+ */
+const RUN_ID_RE = /^r-\d+-[0-9a-f]{4,}$/;
+/** Random bytes in a minted run id; 2 bytes renders as the 4 hex chars in `r-440-ab56`. */
+const RUN_ID_RANDOM_BYTES = 2;
+/** Characters in the abbreviated SHA `git rev-parse --short HEAD` prints. */
+const SHORT_SHA_LENGTH = 7;
+/** Consecutive `blocked` milestones on one phase that mean the run is looping. */
+exports.RESUME_LOOP_CAP = 3;
+/** Suffix `implement` milestones add to `head=` when the worktree had uncommitted changes. */
+const DIRTY_HEAD_SUFFIX_RE = /-dirty$/;
+/** Every value `next=` may legally carry: a phase to re-enter, or `done`. */
+exports.NEXT_VALUES = [...exports.PHASES, 'done'];
+/** GitHub issue numbers are positive integers; anything else is a caller mistake. */
+function isIssueNumber(value) {
+    return /^[1-9]\d*$/.test(value);
+}
+/**
+ * Keys exempt from the no-spaces rule: acceptance-criterion lines are prose by nature.
+ * Matches `ac`, `ac1`, `ac_results`, `ac2_note`, …
+ */
+const AC_KEY_RE = /^ac(\d+)?(_[a-z0-9_]+)?$/;
+/** True when `key` may carry spaces in its value. */
+function isAcKey(key) {
+    return AC_KEY_RE.test(key);
+}
+function isPhase(value) {
+    return exports.PHASES.includes(value);
+}
+function isStatus(value) {
+    return exports.STATUSES.includes(value);
+}
+/**
+ * The phase that follows `phase`, for the milestone's `next=` line.
+ *
+ * - `blocked` ends the run, so `next=done`.
+ * - the two non-terminal statuses keep the run inside the same phase: ship's
+ *   `awaiting-merge` is the FIRST of ship's two milestones (CI wait, then teardown),
+ *   and a `partial` review still has agents left to run — which is exactly how
+ *   gate-issue's resume table reads them back.
+ * - otherwise the linear order gate → setup → plan → implement → review → ship →
+ *   report → done.
+ */
+function defaultNext(phase, status) {
+    if (status === 'blocked')
+        return 'done';
+    if (status === 'awaiting-merge' || status === 'partial')
+        return phase;
+    const idx = exports.PHASES.indexOf(phase);
+    return idx === exports.PHASES.length - 1 ? 'done' : exports.PHASES[idx + 1];
+}
+/** The keys `phase` must carry when reporting `status`. */
+function requiredKeys(phase, status) {
+    const spec = exports.PHASE_SPECS[phase];
+    const base = spec.required[status] ?? [];
+    return status === 'blocked' ? [...base, ...exports.BLOCKED_REQUIRED] : base;
+}
+/**
+ * The single most important thing wrong with one `key=value` pair, or null when it is
+ * well-formed. Checked in the order an author would want to hear about them.
+ */
+function firstKeyProblem(key, value) {
+    if (!/^[a-z][a-z0-9_]*$/.test(key)) {
+        return `Invalid key '${key}' — use lower_snake_case, e.g. base_branch`;
+    }
+    if (value === '') {
+        return `Key '${key}' has an empty value — omit the key or give it a value`;
+    }
+    if (value.includes('$')) {
+        return `Key '${key}' contains '$' — values must be literal; shell expansions like $(date …) end up pasted verbatim`;
+    }
+    // Checked before the ac* whitespace exemption: one milestone line is one key, so a
+    // newline in ANY value silently splits into extra `key=` lines that readers would
+    // parse as real state. Not exempt for ac* keys.
+    if (/[\r\n]/.test(value)) {
+        return `Key '${key}' contains a newline — every value must be a single line, or it splits into extra key= lines in the posted comment; collapse it (use ' / ' or ',') and retry`;
+    }
+    if (value.length > exports.MAX_VALUE_LENGTH) {
+        return `Key '${key}' is ${value.length} characters — the maximum is ${exports.MAX_VALUE_LENGTH}; summarise it (e.g. a count, or a path to the full text) instead of inlining it`;
+    }
+    if (/\s/.test(value) && !isAcKey(key)) {
+        return `Key '${key}' contains whitespace — values must not contain spaces (use '-' or ','); only ac* keys are exempt`;
+    }
+    if (exports.PATH_KEYS.includes(key) && !value.startsWith('/')) {
+        return `Key '${key}' must be an absolute path, got '${value}'`;
+    }
+    return null;
+}
+/**
+ * Validate a milestone against the protocol.
+ *
+ * @returns one actionable line per problem; an empty array means valid.
+ */
+function validateMilestone(input) {
+    const errors = [];
+    const { phase, status, run } = input;
+    const keys = input.keys ?? [];
+    if (!isPhase(phase)) {
+        errors.push(`Unknown phase '${phase}' — expected one of: ${exports.PHASES.join(', ')}`);
+    }
+    if (!isStatus(status)) {
+        errors.push(`Unknown status '${status}' — expected one of: ${exports.STATUSES.join(', ')}`);
+    }
+    else if (isPhase(phase)) {
+        const allowed = exports.PHASE_SPECS[phase].statuses;
+        if (!allowed.includes(status)) {
+            errors.push(`Status '${status}' is not valid for phase '${phase}' — expected one of: ${allowed.join(', ')}`);
+        }
+    }
+    if (!RUN_ID_RE.test(run)) {
+        errors.push(`Invalid run id '${run}' — expected r-<issue>-<hex>, e.g. r-440-ab56 (mint one with: ai-dossier runstate mint --issue <n>)`);
+    }
+    // An unchecked --next lands verbatim in the comment: a typo sends the next resume to a
+    // phase that does not exist, and whitespace/newlines corrupt the line outright.
+    if (input.next !== undefined && !exports.NEXT_VALUES.includes(input.next)) {
+        errors.push(`Invalid --next '${input.next}' — expected one of: ${exports.NEXT_VALUES.join(', ')} (omit --next to use the default for this phase and status)`);
+    }
+    // One line per offending key — an agent fixes the first problem with a value and
+    // re-runs, so listing every way the same value is wrong is noise, not help.
+    const seen = new Map();
+    for (const [key, value] of keys) {
+        if (seen.has(key)) {
+            errors.push(`Duplicate key '${key}' — each key may appear at most once`);
+            continue;
+        }
+        seen.set(key, value);
+        const problem = firstKeyProblem(key, value);
+        if (problem)
+            errors.push(problem);
+    }
+    if (isPhase(phase) && isStatus(status) && exports.PHASE_SPECS[phase].statuses.includes(status)) {
+        const missing = requiredKeys(phase, status).filter((k) => !seen.has(k));
+        if (missing.length > 0) {
+            errors.push(`Phase '${phase}' with status '${status}' requires ${missing.map((k) => `${k}=`).join(' ')} — add with --kv ${missing.map((k) => `${k}=<value>`).join(' --kv ')}`);
+        }
+    }
+    return errors;
+}
+/** Current time as `YYYY-MM-DDTHH:MM:SSZ` (the dossier template's `date -u` format). */
+function nowStamp(date = new Date()) {
+    return `${date.toISOString().slice(0, 19)}Z`;
+}
+/**
+ * Build the milestone comment body. Does not validate — call
+ * {@link validateMilestone} first.
+ */
+function buildMilestone(input) {
+    const at = input.at ?? nowStamp();
+    const next = input.next ??
+        (isPhase(input.phase) && isStatus(input.status)
+            ? defaultNext(input.phase, input.status)
+            : 'done');
+    const lines = [
+        exports.RUNSTATE_MARKER,
+        `phase=${input.phase} status=${input.status} run=${input.run} at=${at}`,
+        ...(input.keys ?? []).map(([k, v]) => `${k}=${v}`),
+        `next=${next}`,
+    ];
+    return `${lines.join('\n')}\n`;
+}
+/**
+ * Split one `key=value` token at its FIRST `=`, so a value may itself contain `=`.
+ * Returns null when nothing precedes the separator.
+ *
+ * The single definition of the pair grammar: {@link parseMilestone} reads it back off an
+ * issue comment and the `--kv` flag parser reads it off argv, and the two must agree.
+ */
+function splitPair(token) {
+    const eq = token.indexOf('=');
+    if (eq <= 0)
+        return null;
+    return [token.slice(0, eq), token.slice(eq + 1)];
+}
+/**
+ * Parse a runstate comment body. Returns `null` when `body` is not a runstate comment.
+ *
+ * Tolerant by design: a milestone posted by an older dossier (or a hand-written one)
+ * should still be readable by `runstate last` even if it would not pass validation.
+ */
+function parseMilestone(body) {
+    if (!body.startsWith(exports.RUNSTATE_MARKER))
+        return null;
+    const keys = {};
+    const lines = body.split('\n').slice(1);
+    for (const raw of lines) {
+        const line = raw.trim();
+        if (line === '' || line.startsWith('<!--'))
+            continue;
+        // The header line packs several pairs; later lines carry exactly one each, and
+        // their values may contain spaces (ac* keys), so only the header is split on space.
+        const isHeader = line.startsWith('phase=');
+        const pairs = isHeader ? line.split(/\s+/) : [line];
+        for (const pair of pairs) {
+            const kv = splitPair(pair);
+            if (!kv)
+                continue;
+            const [key, value] = kv;
+            if (!(key in keys))
+                keys[key] = value;
+        }
+    }
+    return {
+        phase: keys.phase ?? '',
+        status: keys.status ?? '',
+        run: keys.run ?? '',
+        at: keys.at ?? '',
+        next: keys.next ?? '',
+        keys,
+    };
+}
+/** Extract every runstate milestone from a list of comment bodies, oldest first. */
+function parseMilestones(bodies) {
+    const out = [];
+    for (const body of bodies) {
+        const parsed = parseMilestone(body);
+        if (parsed)
+            out.push(parsed);
+    }
+    return out;
+}
+/** Mint a fresh run id: `r-<issue>-<4 hex>`. */
+function mintRunId(issue) {
+    return `r-${issue}-${(0, node_crypto_1.randomBytes)(RUN_ID_RANDOM_BYTES).toString('hex')}`;
+}
+/**
+ * True when the last {@link RESUME_LOOP_CAP} milestones are all `blocked` on the same
+ * phase — the run is retrying the same wall and needs a human, not another resume.
+ */
+function hitLoopCap(milestones) {
+    if (milestones.length < exports.RESUME_LOOP_CAP)
+        return false;
+    const streak = milestones.slice(-exports.RESUME_LOOP_CAP);
+    return (streak.every((m) => m.status === 'blocked') &&
+        streak.every((m) => m.phase === streak[0].phase) &&
+        streak[0].phase !== '');
+}
+/**
+ * Where each phase's run re-enters, given that its own milestone is the latest one.
+ *
+ * Every phase downstream of `setup` re-checks the setup claims first: a branch deleted on
+ * the remote or a reaped worktree invalidates everything recorded after it, so the run
+ * has to rebuild the workspace before it can trust its own later milestones.
+ */
+const PHASE_RESUMERS = {
+    gate: () => ({ resume_from: 'setup' }),
+    setup: (scan) => ({ resume_from: scan.setupOk() ? 'plan' : 'setup' }),
+    plan: (scan) => {
+        if (!scan.setupOk())
+            return { resume_from: 'setup' };
+        const planning = scan.context.planning;
+        if (!planning || !scan.probe.fileExists(planning))
+            return { resume_from: 'plan' };
+        scan.pass('planning');
+        return { resume_from: 'implement' };
+    },
+    implement: (scan) => {
+        if (!scan.setupOk())
+            return { resume_from: 'setup' };
+        const head = scan.probe.headOf(scan.context.worktree);
+        const claimed = (scan.last.keys.head ?? '').replace(DIRTY_HEAD_SUFFIX_RE, '');
+        // The milestone may record a longer or shorter abbreviation than `--short` prints,
+        // so compare on the short-SHA prefix rather than for equality.
+        if (!head || !claimed || !head.startsWith(claimed.slice(0, SHORT_SHA_LENGTH))) {
+            return { resume_from: 'implement' };
+        }
+        scan.pass('head');
+        return { resume_from: 'review' };
+    },
+    review: (scan) => {
+        if (!scan.setupOk())
+            return { resume_from: 'setup' };
+        // A `partial` review still has agents left to run.
+        return { resume_from: scan.last.status === 'partial' ? 'review' : 'ship' };
+    },
+    ship: (scan) => {
+        if (scan.last.status === 'done')
+            return { resume_from: 'report' };
+        // awaiting-merge: the PR itself decides where to re-enter ship.
+        const pr = scan.last.keys.pr;
+        const state = pr ? scan.probe.prState(pr) : null;
+        if (!state)
+            return { resume_from: 'ship' };
+        scan.pass('pr');
+        if (state.mergedAt)
+            return { resume_from: 'ship-teardown' };
+        if (state.state === 'OPEN' && state.mergeable === 'MERGEABLE') {
+            return { resume_from: 'ship-wait' };
+        }
+        return { resume_from: 'ship' };
+    },
+    report: (scan) => {
+        if (!scan.probe.issueClosed())
+            return { resume_from: 'report' };
+        scan.pass('issue-closed');
+        return { resume_from: 'done', note: 'already complete' };
+    },
+};
+/**
+ * Resolve where a run should resume from, implementing the resume verification table in
+ * `imboard-ai/git/gate-issue`. Never trusts the milestone alone — every claim is checked
+ * against reality through `probe`, and {@link PHASE_RESUMERS} holds the per-phase rules.
+ */
+function computeResume(milestones, probe) {
+    if (milestones.length === 0) {
+        return { resume_from: 'none', run_id: null, verified: [], resume_context: {}, last: null };
+    }
+    const context = {};
+    for (const m of milestones)
+        Object.assign(context, m.keys);
+    const last = milestones[milestones.length - 1];
+    const verified = [];
+    const base = { run_id: last.run || null, verified, resume_context: context, last };
+    if (hitLoopCap(milestones)) {
+        return { ...base, resume_from: last.phase, hard_block: 'resume-loop' };
+    }
+    // Any blocked milestone resumes at that same phase.
+    if (last.status === 'blocked') {
+        return { ...base, resume_from: last.phase || 'none' };
+    }
+    // A phase this version does not know — a hand-written comment, or one written by a
+    // newer dossier — is not resumable, so the caller starts over.
+    if (!isPhase(last.phase)) {
+        return { ...base, resume_from: 'none' };
+    }
+    const pass = (check) => {
+        if (!verified.includes(check))
+            verified.push(check);
+    };
+    const setupOk = () => {
+        const { branch, worktree } = context;
+        if (!branch || !worktree)
+            return false;
+        let ok = true;
+        if (probe.branchOnRemote(branch))
+            pass('branch');
+        else
+            ok = false;
+        if (probe.dirExists(worktree))
+            pass('worktree');
+        else
+            ok = false;
+        return ok;
+    };
+    const { resume_from, note } = PHASE_RESUMERS[last.phase]({ last, context, probe, pass, setupOk });
+    return { ...base, resume_from, ...(note ? { note } : {}) };
+}
+//# sourceMappingURL=runstate.js.map

package/dist/runstate.js.map

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