@quickchatai/pi-quickreview 0.0.0-stage → 1.2.0

package/dist/src/reviewstate.js

@@ -0,0 +1,167 @@
+// What `qcr review` remembers about a target between runs (repo plus branch
+// today; a PR keys the same way), so a second review covers only what changed
+// and never repeats a finding that is still open.
+//
+// The state is the production reasoning record in miniature: one row per
+// finding a round recorded (`RoundFindingRow`) and one per status a later
+// round reported for a prior finding. The open list handed to the next round
+// is production's `computePriorFindings` over them, so the chain, supersede
+// and resolution rules are the daemon's, not a copy.
+//
+// Kept in the install's state home (packages/pi-plugin/src/reviewstore.ts), never tracked, never
+// shared. Unreadable state is no state: the next review is a full one.
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+import { normalizeDisposition, recordString } from "./findingkey.js";
+import { parseFindingsRecord } from "./findingsrecord.js";
+import { computePriorFindings } from "./priorfindings.js";
+export const STATE_VERSION = 1;
+/** The target a review is of: the key its state is kept under. */
+export function branchTargetKey(repo, branch) {
+    return `branch:${repo}@${branch}`;
+}
+/** A PR's key: the repo and the PR number, apart from any branch of the repo. */
+export function prTargetKey(repo, number) {
+    return `pr:${repo}#${number}`;
+}
+export function emptyState(target) {
+    return { version: STATE_VERSION, target, rounds: [], rows: [], checks: [] };
+}
+/** The target's state; null when there is none or it cannot be trusted. */
+export function loadState(path, target) {
+    if (path === null || !existsSync(path))
+        return null;
+    try {
+        const s = JSON.parse(readFileSync(path, "utf8"));
+        if (s.version !== STATE_VERSION ||
+            s.target !== target ||
+            !Array.isArray(s.rounds) ||
+            !Array.isArray(s.rows) ||
+            !Array.isArray(s.checks) ||
+            s.rounds.length === 0)
+            return null;
+        const last = s.rounds[s.rounds.length - 1];
+        if (typeof last?.head_sha !== "string" || typeof last.round_no !== "number")
+            return null;
+        return s;
+    }
+    catch {
+        return null;
+    }
+}
+/** Atomic: a crash never leaves half a state. Best-effort by contract — a
+ * state that could not be written only costs the next review its delta. */
+export function saveState(path, s) {
+    if (path === null)
+        return false;
+    try {
+        mkdirSync(dirname(path), { recursive: true });
+        const tmp = `${path}.${process.pid}.tmp`;
+        writeFileSync(tmp, JSON.stringify(s, null, 2) + "\n");
+        renameSync(tmp, path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export const lastRound = (s) => s.rounds[s.rounds.length - 1];
+/** The findings still open for the round after the last one: production's
+ * prior-findings list over the state. */
+export function openFindings(s, nextRound) {
+    const roundNo = nextRound ?? (s ? lastRound(s).round_no + 1 : 1);
+    if (s === null)
+        return { pr: 0, round_no: roundNo, findings: [], dropped: [], incomplete: [] };
+    return computePriorFindings({
+        pr: 0,
+        roundNo,
+        rows: s.rows,
+        checks: s.checks.map((c) => ({ ...c })),
+    });
+}
+// ---- recording a round -----------------------------------------------------------
+/** The dispositions a reader sees as findings (the terminal hides the
+ * review's own kills): carried as open findings, whatever the record called
+ * them. */
+const SHOWN_AS_POSTED = new Set(["posted", "downgraded", "doubted", "unknown"]);
+const norm = (s) => (s ?? "")
+    .toLowerCase()
+    .replace(/[^a-z0-9 ]+/g, " ")
+    .replace(/\s+/g, " ")
+    .trim();
+/**
+ * Fold a finished round's findings record into the state. A finding that
+ * re-raises one already open (the same key on the same file, a named older round, the same
+ * title on the same file, or the same lens on the same line) is a repeat: it
+ * is kept in the state as `merged` (auditable) and never reaches the reader as
+ * new, whatever the session did. The statuses the round reported for the prior
+ * findings are recorded, so the next list shrinks.
+ */
+export function recordRound(prev, target, round, rawRecord) {
+    const base = prev === null || round.scope === "full" ? emptyState(target) : structuredClone(prev);
+    const open = round.scope === "delta" && prev ? openFindings(prev, round.round_no) : null;
+    const raw = rawRecord !== null && typeof rawRecord === "object" && !Array.isArray(rawRecord)
+        ? { ...rawRecord, pr: undefined, round_no: undefined }
+        : rawRecord;
+    const parsed = parseFindingsRecord(raw, 0, round.round_no);
+    const entries = parsed.record?.findings ?? [];
+    const fresh = [];
+    const repeats = [];
+    let id = base.rows.reduce((m, r) => Math.max(m, r.id), 0);
+    for (const e of entries) {
+        const disposition = normalizeDisposition(e.disposition);
+        const shown = SHOWN_AS_POSTED.has(disposition);
+        const isRepeat = shown &&
+            open !== null &&
+            open.findings.some((p) => 
+            // A key is a round-local handle: it names the same finding only on
+            // the same file.
+            (p.finding_key === e.key && p.path === e.path) ||
+                (e.raised_in_round !== null && e.raised_in_round < round.round_no) ||
+                (p.path !== null &&
+                    p.path === e.path &&
+                    ((norm(p.title) !== "" && norm(p.title) === norm(e.title)) ||
+                        (p.line !== null && p.line === e.line && p.lens === e.lens))));
+        if (shown)
+            (isRepeat ? repeats : fresh).push(e);
+        base.rows.push({
+            id: ++id,
+            pr: 0,
+            round_id: null,
+            round_no: round.round_no,
+            head_sha: round.head_sha,
+            finding_key: e.key,
+            path: e.path,
+            line: e.line,
+            lens: e.lens,
+            tier: e.tier,
+            unplanned: 0,
+            severity: e.severity,
+            confidence: e.confidence,
+            reachability: e.reachability,
+            kind: e.kind,
+            disposition: isRepeat ? "merged" : shown ? "posted" : disposition,
+            axis: e.axis,
+            word: isRepeat ? "repeat-of-open" : e.word,
+            reason: e.reason,
+            evidence: e.evidence,
+            posted_as: shown ? (e.posted_as ?? recordString(e.severity) ?? "finding") : e.posted_as,
+            raised_in_round: e.raised_in_round,
+            thread_id: e.thread_id,
+            recorded_at: round.reviewed_at,
+            title: e.title,
+            lens_ids: null,
+        });
+    }
+    for (const p of parsed.record?.prior ?? [])
+        base.checks.push({
+            checked_round: round.round_no,
+            round_no: p.round_no,
+            finding_key: p.finding_key,
+            status: p.status,
+            evidence: p.evidence,
+        });
+    base.rounds.push(round);
+    return { state: base, fresh, repeats };
+}
+//# sourceMappingURL=reviewstate.js.map

package/dist/src/reviewstate.js.map

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

package/dist/src/reviewstore.d.ts

@@ -0,0 +1,17 @@
+export interface ReviewStore {
+    /** `<state home>/review/<key>`. */
+    readonly dir: string;
+    /** The state file for a target (`branchTargetKey` / `prTargetKey`). */
+    statePath(targetKey: string): string;
+    /** The repo's saved destinations. */
+    destinationPath(): string;
+}
+/** The repo's directory-safe key; null outside a git repo, or in one with no
+ * commit yet (nothing to key it by, and nothing to remember). Several root
+ * commits (merged histories): the smallest hash, so the key is stable. */
+export declare function repoKey(cwd: string): string | null;
+/** The repo's store under the review home `home`; null outside a git repo.
+ * Opening is cheap and creates nothing but, on the first open, the imported
+ * copies. */
+export declare function openReviewStoreIn(home: string, cwd: string): ReviewStore | null;
+//# sourceMappingURL=reviewstore.d.ts.map

package/dist/src/reviewstore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reviewstore.d.ts","sourceRoot":"","sources":["../../src/reviewstore.ts"],"names":[],"mappings":"AAsBA,MAAM,WAAW,WAAW;IAC1B,mCAAmC;IACnC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,uEAAuE;IACvE,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IACrC,qCAAqC;IACrC,eAAe,IAAI,MAAM,CAAC;CAC3B;AAoBD;;0EAE0E;AAC1E,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAelD;AA8BD;;aAEa;AACb,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAgB/E"}

package/dist/src/reviewstore.js

@@ -0,0 +1,105 @@
+// Where a local review keeps what it remembers about a repo: the delta history
+// per target (packages/pi-plugin/src/reviewstate.ts) and the saved destination (packages/pi-plugin/src/reviewdest.ts).
+//
+// One directory per repo under the review home the host names (the CLI's is
+// `<state home>/review`, src/reviewhome.ts):
+//   <home>/<key>/state/<hash>.json   one file per target
+//   <home>/<key>/destination.json    the saved destinations
+// The key is the origin's owner/name plus the repo's root commit, so every
+// clone and worktree of a repo shares one history and a fork keeps its own.
+// A repo with no origin is keyed by its directory name instead of an owner.
+// The state home is the place a container volume mounts, which is why this is
+// not the git dir any more. The git dir's old files are copied in once.
+import { createHash } from "node:crypto";
+import { execFileSync } from "node:child_process";
+import { copyFileSync, existsSync, mkdirSync, readdirSync, writeFileSync } from "node:fs";
+import { basename, dirname, join, resolve } from "node:path";
+import { originRepo } from "./localreview.js";
+const LEGACY_STATE_DIR = "qcr-review-state";
+const LEGACY_DEST_FILE = "qcr-review-destination.json";
+const IMPORTED_MARKER = ".legacy-imported";
+function git(cwd, args) {
+    try {
+        return execFileSync("git", args, {
+            cwd,
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "ignore"],
+        }).trim();
+    }
+    catch {
+        return null;
+    }
+}
+const slug = (s) => s
+    .toLowerCase()
+    .replace(/[^a-z0-9._-]+/g, "_")
+    .replace(/^\.+/, "_");
+/** The repo's directory-safe key; null outside a git repo, or in one with no
+ * commit yet (nothing to key it by, and nothing to remember). Several root
+ * commits (merged histories): the smallest hash, so the key is stable. */
+export function repoKey(cwd) {
+    const roots = git(cwd, ["rev-list", "--max-parents=0", "HEAD"]);
+    const root = roots?.split("\n").filter(Boolean).sort()[0];
+    if (!root)
+        return null;
+    const origin = originRepo(cwd);
+    let name = origin;
+    if (name === null) {
+        const common = git(cwd, ["rev-parse", "--path-format=absolute", "--git-common-dir"]);
+        if (common === null)
+            return null;
+        // A normal repo's common dir is `<repo>/.git`; a bare one is the repo.
+        const dir = basename(common) === ".git" ? dirname(common) : common;
+        name = `local/${basename(dir)}`;
+    }
+    const [owner = "local", repo = ""] = name.split("/");
+    return `${slug(owner)}--${slug(repo)}--${root.slice(0, 12)}`;
+}
+/** Copy what the repo's git dir held before the state moved here. Once per
+ * store (a marker says so), and never over a file the store already has. The
+ * originals are left where they are. Best-effort: a copy that fails costs the
+ * repo its old history, not the review. */
+function importLegacy(cwd, store) {
+    const marker = join(store.dir, IMPORTED_MARKER);
+    if (existsSync(marker))
+        return;
+    try {
+        const common = git(cwd, ["rev-parse", "--path-format=absolute", "--git-common-dir"]);
+        if (common !== null) {
+            const stateDir = join(common, LEGACY_STATE_DIR);
+            const copy = (from, to) => {
+                if (!existsSync(from) || existsSync(to))
+                    return;
+                mkdirSync(dirname(to), { recursive: true });
+                copyFileSync(from, to);
+            };
+            if (existsSync(stateDir))
+                for (const f of readdirSync(stateDir))
+                    if (f.endsWith(".json"))
+                        copy(join(stateDir, f), join(store.dir, "state", f));
+            copy(join(common, LEGACY_DEST_FILE), store.destinationPath());
+        }
+        mkdirSync(store.dir, { recursive: true });
+        writeFileSync(marker, "");
+    }
+    catch {
+        // Unwritable store: the callers' own saves fail the same way, quietly.
+    }
+}
+/** The repo's store under the review home `home`; null outside a git repo.
+ * Opening is cheap and creates nothing but, on the first open, the imported
+ * copies. */
+export function openReviewStoreIn(home, cwd) {
+    const key = repoKey(cwd);
+    if (key === null)
+        return null;
+    const dir = resolve(home, key);
+    const store = {
+        dir,
+        statePath: (targetKey) => join(dir, "state", `${createHash("sha256").update(targetKey).digest("hex").slice(0, 20)}.json`),
+        destinationPath: () => join(dir, "destination.json"),
+    };
+    importLegacy(cwd, store);
+    return store;
+}
+//# sourceMappingURL=reviewstore.js.map

package/dist/src/reviewstore.js.map

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

package/dist/src/round-progress.d.ts

@@ -0,0 +1,120 @@
+export declare const LIVE_AGENT_STATUSES: readonly ["running", "completed", "failed"];
+export type LiveAgentStatus = (typeof LIVE_AGENT_STATUSES)[number];
+export declare function isLiveAgentStatus(value: unknown): value is LiveAgentStatus;
+export type PassExecutionPhase = "plan" | "sweep" | "optional";
+export interface LiveAgentProgress {
+    /** One subagent tool invocation, not merely an agent name. Repeated lenses
+     * remain distinct so an older completion cannot satisfy a newer run. */
+    execution_id?: string;
+    agent: string;
+    /** Task-directory phase. Absent on legacy/free-form calls, which retain
+     * their original plan interpretation. Sweep completions never repair a
+     * different phase's required failure. */
+    phase?: PassExecutionPhase;
+    status: LiveAgentStatus;
+    duration_ms: number;
+    tool_count: number;
+    /** Immutable execution milestones. Absent on version-1/display-only
+     * snapshots; supervisors must never infer their absence as a failure. */
+    started_at?: string;
+    finished_at?: string;
+    current_tool?: string;
+    last_message?: string;
+    error?: string;
+}
+export type RoundExecutionStage = "unknown" | "accepted" | "preparing" | "fanout-started" | "passes-complete" | "finalized";
+export interface RoundProgressSnapshot {
+    /** v2 adds immutable execution milestones. v1 remains readable for the TUI
+     * and for settlement evidence, but cannot drive early pass-stage recovery. */
+    version: 1 | 2;
+    pr: number;
+    session: string;
+    run_started_at: string;
+    updated_at: string;
+    parent_status: "active" | "settled";
+    /** Exact durable command identity, learned from its correlated user
+     * message. Absent on interactive/legacy runs; absent means telemetry cannot
+     * prove settlement for command recovery. */
+    command_id?: string;
+    command_sha256?: string;
+    command_accepted_at?: string;
+    /** Prompt-derived immutable review identity. Together with command id/hash,
+     * this prevents a neighboring accepted run from impersonating this round. */
+    round_no?: number;
+    head_sha?: string;
+    /** Named parent milestones. `preparing_at` is stamped with exact
+     * command acceptance; `fanout_started_at` is the first subagent execution.
+     * `first_lens_started_at` remains the backwards-compatible spelling. */
+    preparing_at?: string;
+    first_lens_started_at?: string;
+    fanout_started_at?: string;
+    last_activity_at: string;
+    last_activity: string;
+    active_tool?: string;
+    agents: LiveAgentProgress[];
+}
+/** Built pass agents append their model tier to the lens identity. SQLite's
+ * authoritative plan stores the lens, while Pi progress reports the invoked
+ * agent, so every comparison crosses this one normalization seam. */
+export declare function lensForAgent(agent: string): string;
+/** A pass execution that has ended, either way. */
+export declare function isTerminalAgentStatus(status: LiveAgentStatus): boolean;
+/** A required lens is complete only when it ran and all its executions ended. */
+export declare function executionsComplete(executions: readonly LiveAgentProgress[]): boolean;
+/** The executions that open a round's fanout: a started run of one of the
+ * plan's DISCOVERY lenses. Validator-first, an added lens or a foreign
+ * subagent never counts. */
+export declare function plannedFanoutAgents(progress: RoundProgressSnapshot, planned: readonly string[]): LiveAgentProgress[];
+/** Classify the current parent stage from immutable milestones plus the
+ * authoritative round plan. Activity text and heartbeat age are deliberately
+ * absent: they can describe a stage but can never renew it. */
+export declare function roundExecutionStage(progress: RoundProgressSnapshot, planned: readonly string[]): RoundExecutionStage;
+/** Parse an untrusted remote sidecar. A malformed file is simply unavailable. */
+export declare function parseRoundProgress(raw: string): RoundProgressSnapshot | undefined;
+/**
+ * The APPEND-ONLY transition log beside the snapshot:
+ * `state/round-progress/pr-<n>.jsonl`. The snapshot is rewritten on every
+ * event, so it can only say what is true NOW; the log keeps the order in
+ * which a run got there — parent start/settle, command acceptance, every
+ * pass's start and end with its status — so a round the supervisor ended can
+ * be reconstructed afterwards. Diagnostic only: nothing in the daemon reads
+ * it for a decision.
+ */
+export type ProgressTransition = {
+    event: "parent_start";
+} | {
+    event: "command_accepted";
+    round_no?: number;
+    head_sha?: string;
+} | {
+    event: "pass_start";
+    execution_id: string;
+    agent: string;
+} | {
+    event: "pass_end";
+    execution_id: string;
+    agent: string;
+    status: LiveAgentStatus;
+} | {
+    event: "parent_settle";
+};
+export type ProgressLogLine = ProgressTransition & {
+    at: string;
+    pr: number;
+    session: string;
+    run_started_at: string;
+    command_id?: string;
+};
+/** Size cap of the live log. A transition line is ~200–300 bytes and a round
+ * writes a few dozen (sweeps a little over a hundred), so 256 KiB holds many
+ * rounds of one PR. Past it the file rotates ONCE to `.jsonl.1` (the previous
+ * `.1` dropped), so a PR never holds more than ~512 KiB of log. Rotation is
+ * per line, not per round: a round may straddle the two files, so a
+ * reconstruction reads `.jsonl.1` then `.jsonl`. */
+export declare const PROGRESS_LOG_MAX_BYTES: number;
+/** `pr-<n>.json` → `pr-<n>.jsonl`. */
+export declare function progressLogPath(snapshotPath: string): string;
+/** Append one line, rotating first when it would cross the cap. Throws on an
+ * I/O failure — the caller (the extension) logs and carries on. */
+export declare function appendProgressLog(path: string, line: ProgressLogLine, maxBytes?: number): void;
+//# sourceMappingURL=round-progress.d.ts.map

package/dist/src/round-progress.d.ts.map

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

package/dist/src/round-progress.js

@@ -0,0 +1,172 @@
+/**
+ * Live, ephemeral progress from one PR's sticky pi session.
+ *
+ * SQLite remains authoritative for the round plan, timing and verdict. This
+ * sidecar answers only the question SQLite cannot: what the parent and its
+ * lens subagents are doing right now. Missing/stale data is UNKNOWN, never
+ * inferred as pending or done.
+ */
+import { appendFileSync, renameSync, statSync } from "node:fs";
+import { PASS_TIER_ORDER } from "./types.js";
+export const LIVE_AGENT_STATUSES = ["running", "completed", "failed"];
+export function isLiveAgentStatus(value) {
+    return typeof value === "string" && LIVE_AGENT_STATUSES.some((status) => status === value);
+}
+/** Built pass agents append their model tier to the lens identity. SQLite's
+ * authoritative plan stores the lens, while Pi progress reports the invoked
+ * agent, so every comparison crosses this one normalization seam. */
+export function lensForAgent(agent) {
+    return agent.replace(TIER_SUFFIX, "");
+}
+/** `--<tier>` for every tier on the ladder (`PASS_TIER_ORDER`). */
+const TIER_SUFFIX = new RegExp(`--(?:${PASS_TIER_ORDER.join("|")})$`);
+/** A pass execution that has ended, either way. */
+export function isTerminalAgentStatus(status) {
+    return status === "completed" || status === "failed";
+}
+/** A required lens is complete only when it ran and all its executions ended. */
+export function executionsComplete(executions) {
+    return executions.length > 0 && executions.every((agent) => isTerminalAgentStatus(agent.status));
+}
+/** The executions that open a round's fanout: a started run of one of the
+ * plan's DISCOVERY lenses. Validator-first, an added lens or a foreign
+ * subagent never counts. */
+export function plannedFanoutAgents(progress, planned) {
+    const discovery = planned.filter((name) => name !== "pass-validate");
+    return progress.agents.filter((agent) => discovery.includes(lensForAgent(agent.agent)) && agent.started_at !== undefined);
+}
+/** Classify the current parent stage from immutable milestones plus the
+ * authoritative round plan. Activity text and heartbeat age are deliberately
+ * absent: they can describe a stage but can never renew it. */
+export function roundExecutionStage(progress, planned) {
+    if (progress.version !== 2 || !progress.command_id || !progress.command_sha256)
+        return "unknown";
+    if (progress.parent_status === "settled")
+        return "finalized";
+    if (plannedFanoutAgents(progress, planned).length === 0)
+        return progress.preparing_at ? "preparing" : "accepted";
+    const terminal = isTerminalAgentStatus;
+    const plannedComplete = planned.every((name) => {
+        const executions = progress.agents.filter((agent) => lensForAgent(agent.agent) === name);
+        return executionsComplete(executions);
+    });
+    const addedComplete = progress.agents
+        .filter((agent) => !planned.includes(lensForAgent(agent.agent)))
+        .every((agent) => terminal(agent.status));
+    return plannedComplete && addedComplete ? "passes-complete" : "fanout-started";
+}
+function instant(value) {
+    if (typeof value !== "string")
+        return undefined;
+    const parsed = Date.parse(value);
+    return Number.isFinite(parsed) ? parsed : undefined;
+}
+/** Parse an untrusted remote sidecar. A malformed file is simply unavailable. */
+export function parseRoundProgress(raw) {
+    try {
+        const value = JSON.parse(raw);
+        if ((value.version !== 1 && value.version !== 2) ||
+            !Number.isInteger(value.pr) ||
+            typeof value.session !== "string" ||
+            instant(value.run_started_at) === undefined ||
+            instant(value.updated_at) === undefined ||
+            (value.parent_status !== "active" && value.parent_status !== "settled") ||
+            (value.command_id === undefined) !== (value.command_sha256 === undefined) ||
+            (value.command_id !== undefined && typeof value.command_id !== "string") ||
+            (value.command_sha256 !== undefined &&
+                (typeof value.command_sha256 !== "string" ||
+                    !/^[a-f0-9]{64}$/.test(value.command_sha256))) ||
+            (value.round_no !== undefined && (!Number.isInteger(value.round_no) || value.round_no < 1)) ||
+            (value.head_sha !== undefined &&
+                (typeof value.head_sha !== "string" || value.head_sha.length === 0)) ||
+            instant(value.last_activity_at) === undefined ||
+            typeof value.last_activity !== "string" ||
+            !Array.isArray(value.agents))
+            return undefined;
+        const runStarted = instant(value.run_started_at);
+        const accepted = value.command_accepted_at === undefined ? undefined : instant(value.command_accepted_at);
+        const preparing = value.preparing_at === undefined ? undefined : instant(value.preparing_at);
+        const firstLens = value.first_lens_started_at === undefined ? undefined : instant(value.first_lens_started_at);
+        const fanout = value.fanout_started_at === undefined ? undefined : instant(value.fanout_started_at);
+        if ((value.command_accepted_at !== undefined && accepted === undefined) ||
+            (value.preparing_at !== undefined && preparing === undefined) ||
+            (value.first_lens_started_at !== undefined && firstLens === undefined) ||
+            (value.fanout_started_at !== undefined && fanout === undefined) ||
+            (accepted !== undefined && accepted < runStarted) ||
+            (accepted !== undefined && preparing !== undefined && preparing < accepted) ||
+            (accepted !== undefined && firstLens !== undefined && firstLens < accepted) ||
+            (preparing !== undefined && fanout !== undefined && fanout < preparing) ||
+            (firstLens !== undefined && fanout !== undefined && firstLens !== fanout))
+            return undefined;
+        if (value.version === 2 && value.command_id !== undefined && accepted === undefined)
+            return undefined;
+        if (value.version === 2 &&
+            value.agents.length > 0 &&
+            firstLens === undefined &&
+            fanout === undefined)
+            return undefined;
+        for (const rawAgent of value.agents) {
+            if (rawAgent === null || typeof rawAgent !== "object" || Array.isArray(rawAgent))
+                return undefined;
+            const agent = rawAgent;
+            if ((value.version === 2 && typeof agent.execution_id !== "string") ||
+                typeof agent.agent !== "string" ||
+                (agent.phase !== undefined && !["plan", "sweep", "optional"].includes(agent.phase)) ||
+                !isLiveAgentStatus(agent.status) ||
+                typeof agent.duration_ms !== "number" ||
+                !Number.isFinite(agent.duration_ms) ||
+                typeof agent.tool_count !== "number" ||
+                !Number.isFinite(agent.tool_count))
+                return undefined;
+            const started = agent.started_at === undefined ? undefined : instant(agent.started_at);
+            const finished = agent.finished_at === undefined ? undefined : instant(agent.finished_at);
+            if ((agent.started_at !== undefined && started === undefined) ||
+                (agent.finished_at !== undefined && finished === undefined) ||
+                (started !== undefined && started < runStarted) ||
+                (accepted !== undefined && started !== undefined && started < accepted) ||
+                (started !== undefined && finished !== undefined && finished < started) ||
+                (finished !== undefined && finished > instant(value.updated_at)) ||
+                (value.version === 2 && started === undefined) ||
+                (value.version === 2 && agent.status === "running" && finished !== undefined) ||
+                (value.version === 2 && agent.status !== "running" && finished === undefined))
+                return undefined;
+        }
+        if (value.version === 2) {
+            const ids = value.agents.map((agent) => agent.execution_id);
+            if (new Set(ids).size !== ids.length)
+                return undefined;
+        }
+        return value;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Size cap of the live log. A transition line is ~200–300 bytes and a round
+ * writes a few dozen (sweeps a little over a hundred), so 256 KiB holds many
+ * rounds of one PR. Past it the file rotates ONCE to `.jsonl.1` (the previous
+ * `.1` dropped), so a PR never holds more than ~512 KiB of log. Rotation is
+ * per line, not per round: a round may straddle the two files, so a
+ * reconstruction reads `.jsonl.1` then `.jsonl`. */
+export const PROGRESS_LOG_MAX_BYTES = 256 * 1024;
+/** `pr-<n>.json` → `pr-<n>.jsonl`. */
+export function progressLogPath(snapshotPath) {
+    return snapshotPath.replace(/\.json$/, ".jsonl");
+}
+/** Append one line, rotating first when it would cross the cap. Throws on an
+ * I/O failure — the caller (the extension) logs and carries on. */
+export function appendProgressLog(path, line, maxBytes = PROGRESS_LOG_MAX_BYTES) {
+    const bytes = `${JSON.stringify(line)}\n`;
+    let size = 0;
+    try {
+        size = statSync(path).size;
+    }
+    catch (err) {
+        if (err.code !== "ENOENT")
+            throw err;
+    }
+    if (size > 0 && size + Buffer.byteLength(bytes) > maxBytes)
+        renameSync(path, `${path}.1`);
+    appendFileSync(path, bytes);
+}
+//# sourceMappingURL=round-progress.js.map

package/dist/src/round-progress.js.map

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

package/dist/src/round-stage-deadlines.d.ts

@@ -0,0 +1,12 @@
+/** Start-derived round deadlines, shared by enforcement and status publication. */
+export declare function roundStageDeadlines(started: number, bounds: {
+    first_pass_max_min: number;
+    passes_max_min: number;
+    running_max_min: number;
+    follow_up_sweep_extra_min?: number;
+}, sweepOwed: boolean): {
+    first_pass_start: number;
+    passes_complete: number;
+    running_hard_bound: number;
+};
+//# sourceMappingURL=round-stage-deadlines.d.ts.map