@songsid/agend 2.1.3 → 2.1.4-beta.10

package/dist/transcript-sources.js

@@ -0,0 +1,428 @@
+/**
+ * Per-backend tool-event sources for the transcript monitor.
+ *
+ * claude-code keeps its transcript path in statusline.json and is handled
+ * inside TranscriptMonitor itself (it predates this file). The sources here
+ * cover backends whose CLIs persist their conversation elsewhere:
+ *
+ *   codex     — rollout JSONL under <codex home>/sessions/YYYY/MM/DD/,
+ *               matched to this instance by session_meta.cwd (sessions are a
+ *               shared symlinked dir across instances, #507)
+ *   kiro-cli  — ~/.kiro/sessions/cli/<uuid>.jsonl with a sibling <uuid>.json
+ *               carrying { cwd, updated_at }
+ *   opencode  — $XDG_DATA_HOME/opencode/opencode.db `part` table rows of
+ *               data JSON { type: "tool", tool, state.input }, matched by the
+ *               `session` table's directory column
+ *
+ * Common rules, learned the hard way (#528 traps):
+ *   - No persisted byte offsets. Codex writes a fresh rollout per process and
+ *     kiro/opencode keep full history — a stale offset is meaningless at best
+ *     and replays history at worst.
+ *   - First attach to a PRE-EXISTING transcript baselines to its end: only
+ *     new work emits. A transcript that APPEARS after the source was created
+ *     is this instance's own new session and is read from the start.
+ *   - Every poll re-resolves which transcript is active. Pinning to the first
+ *     one found silently goes blind when the CLI starts a new session.
+ */
+import { closeSync, existsSync, openSync, readdirSync, readFileSync, readSync, statSync } from "node:fs";
+import { open, stat } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join } from "node:path";
+const EMPTY = { toolUses: [], toolResults: [], assistantTexts: [] };
+function emptyEvents() {
+    return { toolUses: [], toolResults: [], assistantTexts: [] };
+}
+/** Shared JSONL tailer: byte-offset incremental reads of a single file. */
+async function readNewLines(path, fromOffset) {
+    const stats = await stat(path);
+    if (stats.size <= fromOffset)
+        return { lines: [], newOffset: fromOffset };
+    const fh = await open(path, "r");
+    try {
+        const length = stats.size - fromOffset;
+        const buffer = Buffer.alloc(length);
+        await fh.read(buffer, 0, length, fromOffset);
+        return { lines: buffer.toString("utf-8").split("\n").filter(l => l.trim()), newOffset: stats.size };
+    }
+    finally {
+        await fh.close();
+    }
+}
+/* ------------------------------------------------------------------ codex */
+/**
+ * Follows the newest rollout JSONL whose session_meta.cwd matches this
+ * instance's working directory. Rollouts are date-sharded and shared across
+ * instances, so cwd is the only reliable ownership signal.
+ */
+export class CodexRolloutSource {
+    workingDirectory;
+    sessionsDir;
+    currentFile = null;
+    byteOffset = 0;
+    createdAt;
+    /** Files whose session_meta was read and did NOT match our cwd. */
+    rejected = new Set();
+    constructor(workingDirectory, sessionsDir = join(process.env.CODEX_HOME?.trim() || join(homedir(), ".codex"), "sessions"), now = Date.now()) {
+        this.workingDirectory = workingDirectory;
+        this.sessionsDir = sessionsDir;
+        this.createdAt = now;
+    }
+    reset() {
+        this.currentFile = null;
+        this.byteOffset = 0;
+    }
+    /** Newest rollout files first, bounded to the last two date shards. */
+    candidateFiles() {
+        const out = [];
+        const walk = (dir, depth) => {
+            let entries;
+            try {
+                entries = readdirSync(dir);
+            }
+            catch {
+                return;
+            }
+            // Date-sharded YYYY/MM/DD tree: at each level only the two newest
+            // subdirs can contain today's/yesterday's rollouts.
+            const dirs = [];
+            for (const e of entries) {
+                const p = join(dir, e);
+                try {
+                    const st = statSync(p);
+                    if (st.isDirectory())
+                        dirs.push(e);
+                    else if (depth >= 3 && e.startsWith("rollout-") && e.endsWith(".jsonl")) {
+                        out.push({ path: p, mtimeMs: st.mtimeMs });
+                    }
+                }
+                catch { /* raced with deletion */ }
+            }
+            if (depth < 3) {
+                for (const d of dirs.sort().reverse().slice(0, 2))
+                    walk(join(dir, d), depth + 1);
+            }
+        };
+        walk(this.sessionsDir, 0);
+        return out.sort((a, b) => b.mtimeMs - a.mtimeMs);
+    }
+    fileBelongsToUs(path) {
+        if (this.rejected.has(path))
+            return false;
+        try {
+            // session_meta is the first line. It can carry long instructions, so
+            // give it headroom — but never read the whole rollout.
+            const fd = openSync(path, "r");
+            let head;
+            try {
+                const buf = Buffer.alloc(65536);
+                const bytes = readSync(fd, buf, 0, buf.length, 0);
+                head = buf.toString("utf-8", 0, bytes);
+            }
+            finally {
+                closeSync(fd);
+            }
+            const firstLine = head.split("\n")[0];
+            const meta = JSON.parse(firstLine);
+            const cwd = meta?.payload?.cwd;
+            if (meta?.type === "session_meta" && cwd === this.workingDirectory)
+                return true;
+            this.rejected.add(path);
+            return false;
+        }
+        catch {
+            // First line unreadable/partial — retry next poll, do not cache the verdict.
+            return false;
+        }
+    }
+    async poll() {
+        // Re-resolve every poll: a restarted codex writes a NEW rollout, and
+        // staying pinned to the old one goes silently blind (#528 trap 1).
+        const candidates = this.candidateFiles();
+        const active = candidates.find(c => this.fileBelongsToUs(c.path));
+        if (!active)
+            return EMPTY;
+        if (active.path !== this.currentFile) {
+            this.currentFile = active.path;
+            // A rollout born after this source existed is our own fresh session —
+            // read it from the start. A pre-existing one is history — baseline EOF.
+            if (active.mtimeMs >= this.createdAt) {
+                this.byteOffset = 0;
+            }
+            else {
+                try {
+                    this.byteOffset = (await stat(active.path)).size;
+                }
+                catch {
+                    this.byteOffset = 0;
+                }
+                return EMPTY;
+            }
+        }
+        const { lines, newOffset } = await readNewLines(this.currentFile, this.byteOffset);
+        this.byteOffset = newOffset;
+        const events = emptyEvents();
+        for (const line of lines) {
+            let entry;
+            try {
+                entry = JSON.parse(line);
+            }
+            catch {
+                continue;
+            }
+            if (entry.type !== "response_item")
+                continue;
+            const p = entry.payload;
+            if (!p)
+                continue;
+            if (p.type === "function_call") {
+                let input = p.arguments;
+                if (typeof input === "string") {
+                    try {
+                        input = JSON.parse(input);
+                    }
+                    catch { /* keep raw */ }
+                }
+                events.toolUses.push({ name: String(p.name ?? "unknown"), input });
+            }
+            else if (p.type === "custom_tool_call") {
+                events.toolUses.push({ name: String(p.name ?? "unknown"), input: p.input });
+            }
+            else if (p.type === "local_shell_call") {
+                const action = p.action;
+                events.toolUses.push({ name: "shell", input: { command: action?.command } });
+            }
+            else if (p.type === "function_call_output" || p.type === "custom_tool_call_output") {
+                events.toolResults.push({ name: String(p.name ?? "unknown") });
+            }
+            else if (p.type === "message" && p.role === "assistant") {
+                const content = p.content;
+                for (const block of content ?? []) {
+                    const text = block.text;
+                    if (typeof text === "string" && text.trim())
+                        events.assistantTexts.push(text);
+                }
+            }
+        }
+        return events;
+    }
+}
+/* -------------------------------------------------------------------- kiro */
+/**
+ * Follows the newest kiro session whose metadata cwd matches this instance's
+ * working directory. Session transcript is <uuid>.jsonl; ownership and
+ * recency come from the sibling <uuid>.json ({ cwd, updated_at,
+ * session_created_reason }).
+ */
+export class KiroSessionSource {
+    workingDirectory;
+    sessionsDir;
+    currentFile = null;
+    byteOffset = 0;
+    createdAt;
+    constructor(workingDirectory, sessionsDir = join(homedir(), ".kiro", "sessions", "cli"), now = Date.now()) {
+        this.workingDirectory = workingDirectory;
+        this.sessionsDir = sessionsDir;
+        this.createdAt = now;
+    }
+    reset() {
+        this.currentFile = null;
+        this.byteOffset = 0;
+    }
+    resolveActiveSession() {
+        let entries;
+        try {
+            entries = readdirSync(this.sessionsDir);
+        }
+        catch {
+            return null;
+        }
+        let best = null;
+        for (const e of entries) {
+            if (!e.endsWith(".json") || e.endsWith(".jsonl"))
+                continue;
+            const metaPath = join(this.sessionsDir, e);
+            try {
+                const meta = JSON.parse(readFileSync(metaPath, "utf-8"));
+                if (meta.cwd !== this.workingDirectory)
+                    continue;
+                // Subagent sessions are children of a turn already being reported.
+                if (meta.session_created_reason === "subagent")
+                    continue;
+                const updated = Date.parse(meta.updated_at ?? "") || 0;
+                const created = Date.parse(meta.created_at ?? "") || 0;
+                if (!best || updated > best.updated) {
+                    const jsonlPath = join(this.sessionsDir, e.replace(/\.json$/, ".jsonl"));
+                    best = { jsonlPath, updated, createdAtMs: created };
+                }
+            }
+            catch { /* partially written metadata — next poll */ }
+        }
+        return best && existsSync(best.jsonlPath)
+            ? { jsonlPath: best.jsonlPath, createdAtMs: best.createdAtMs }
+            : null;
+    }
+    async poll() {
+        const active = this.resolveActiveSession();
+        if (!active)
+            return EMPTY;
+        if (active.jsonlPath !== this.currentFile) {
+            this.currentFile = active.jsonlPath;
+            if (active.createdAtMs >= this.createdAt) {
+                this.byteOffset = 0; // our own fresh session — observable from the start
+            }
+            else {
+                try {
+                    this.byteOffset = (await stat(active.jsonlPath)).size;
+                }
+                catch {
+                    this.byteOffset = 0;
+                }
+                return EMPTY;
+            }
+        }
+        const { lines, newOffset } = await readNewLines(this.currentFile, this.byteOffset);
+        this.byteOffset = newOffset;
+        const events = emptyEvents();
+        for (const line of lines) {
+            let entry;
+            try {
+                entry = JSON.parse(line);
+            }
+            catch {
+                continue;
+            }
+            collectKiroEvents(entry, events);
+        }
+        return events;
+    }
+}
+/**
+ * Kiro nests { kind: "toolUse", data: { name, input } } blocks inside
+ * AssistantMessage content; exact nesting has shifted across kiro versions,
+ * so walk the tree for the kind markers instead of hardcoding a path.
+ */
+function collectKiroEvents(node, out, depth = 0) {
+    if (depth > 8 || node === null || typeof node !== "object")
+        return;
+    if (Array.isArray(node)) {
+        for (const item of node)
+            collectKiroEvents(item, out, depth + 1);
+        return;
+    }
+    const obj = node;
+    if (obj.kind === "toolUse" && obj.data && typeof obj.data === "object") {
+        const d = obj.data;
+        out.toolUses.push({ name: String(d.name ?? "unknown"), input: d.input });
+        return;
+    }
+    if (obj.kind === "toolResult" && obj.data && typeof obj.data === "object") {
+        out.toolResults.push({ name: "toolResult" });
+        return;
+    }
+    for (const value of Object.values(obj))
+        collectKiroEvents(value, out, depth + 1);
+}
+function loadSqlite() {
+    try {
+        return process
+            .getBuiltinModule?.("node:sqlite");
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Reads tool parts from opencode's sqlite DB for the newest top-level
+ * session in this instance's working directory. Rows are cursored by
+ * time_created, which is immutable — a part that later flips from `running`
+ * to `completed` only changes time_updated, so each tool use emits once.
+ *
+ * Requires node:sqlite (Node ≥22.13); silently inert otherwise, matching the
+ * session-resume feature's degradation.
+ */
+export class OpenCodeDbSource {
+    workingDirectory;
+    dbPath;
+    sessionId = null;
+    partCursor = 0;
+    createdAt;
+    constructor(workingDirectory, dbPath = join(process.env.XDG_DATA_HOME || join(homedir(), ".local", "share"), "opencode", "opencode.db"), now = Date.now()) {
+        this.workingDirectory = workingDirectory;
+        this.dbPath = dbPath;
+        this.createdAt = now;
+    }
+    reset() {
+        this.sessionId = null;
+        this.partCursor = 0;
+    }
+    async poll() {
+        const sqlite = loadSqlite();
+        if (!sqlite || !existsSync(this.dbPath))
+            return EMPTY;
+        let db;
+        try {
+            db = new sqlite.DatabaseSync(this.dbPath, { readOnly: true });
+        }
+        catch {
+            return EMPTY;
+        }
+        try {
+            const session = db.prepare("SELECT id, time_created FROM session WHERE directory = ? AND parent_id IS NULL ORDER BY time_updated DESC LIMIT 1").get(this.workingDirectory);
+            if (!session)
+                return EMPTY;
+            if (session.id !== this.sessionId) {
+                this.sessionId = session.id;
+                // Fresh session started under us → report from its beginning;
+                // pre-existing session → only new parts.
+                this.partCursor = session.time_created >= this.createdAt ? 0 : Date.now();
+            }
+            const rows = db.prepare("SELECT data, time_created FROM part WHERE session_id = ? AND time_created > ? ORDER BY time_created ASC LIMIT 100").all(this.sessionId, this.partCursor);
+            const events = emptyEvents();
+            for (const row of rows) {
+                this.partCursor = Math.max(this.partCursor, row.time_created);
+                let data;
+                try {
+                    data = JSON.parse(row.data);
+                }
+                catch {
+                    continue;
+                }
+                if (data.type === "tool") {
+                    const state = data.state;
+                    events.toolUses.push({ name: String(data.tool ?? "unknown"), input: state?.input });
+                }
+                else if (data.type === "text") {
+                    const text = data.text;
+                    if (typeof text === "string" && text.trim())
+                        events.assistantTexts.push(text);
+                }
+            }
+            return events;
+        }
+        catch {
+            return EMPTY;
+        }
+        finally {
+            try {
+                db.close();
+            }
+            catch { /* already closed */ }
+        }
+    }
+}
+/* ----------------------------------------------------------------- factory */
+/**
+ * Source for a backend, or null for backends handled elsewhere (claude-code
+ * lives inside TranscriptMonitor) and backends with no known source
+ * (antigravity, gemini-cli — nothing usable found on disk; grok has
+ * events.jsonl with tool names only and can be added later).
+ */
+export function createTranscriptSource(backend, workingDirectory) {
+    switch (backend) {
+        case "codex": return new CodexRolloutSource(workingDirectory);
+        case "kiro-cli": return new KiroSessionSource(workingDirectory);
+        case "opencode": return new OpenCodeDbSource(workingDirectory);
+        default: return null;
+    }
+}
+//# sourceMappingURL=transcript-sources.js.map

package/dist/transcript-sources.js.map

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

package/dist/types.d.ts

@@ -119,6 +119,12 @@ export interface InstanceConfig {
     kiro_ui?: "legacy" | "tui" | "v3";
     /** MCP tool profile: "full" (20 tools), "standard" (8), "minimal" (3). Default: "full" */
     tool_set?: string;
+    /**
+     * Tool-progress detail shown in the channel processing bubble.
+     * "standard" (default) shows semantic labels with no shell arguments;
+     * "verbose" adds truncated command previews; "off" disables the list.
+     */
+    tool_progress?: "off" | "standard" | "verbose";
     /** Skip non-essential subsystems (transcript monitor, context guardian, approval server, prompt detector) */
     lightweight?: boolean;
     /** System prompt — supports comma-separated file: paths for modularization */
@@ -166,6 +172,8 @@ export interface InstanceConfig {
     terminal?: TerminalConfig;
     /** Command to paste raw before each user message (e.g. "/chat load base.json") */
     pre_task_command?: string;
+    /** Per-backend options keyed by backend name (e.g. { codex: { provider: "glm" } }) */
+    backend_options?: Record<string, Record<string, unknown>>;
 }
 export interface WebhookConfig {
     url: string;

package/dist/ui/dashboard.html

@@ -463,12 +463,13 @@ async function showCreateInstance() {
   let backendOpts = '<option value="">Use fleet default</option>';
   try {
     const bd = await api("GET", "/ui/backends");
-    const first = (bd.backends || []).find(b => b.installed);
+    const first = (bd.backends || []).find(b => b.installed && !b.deprecated) || (bd.backends || []).find(b => b.installed);
     backendOpts += (bd.backends || []).map(b => {
-      const label = b.installed ? b.name : `${b.name} (not installed)`;
+      let label = b.deprecated ? `${b.name} (deprecated)` : b.name;
+      if (!b.installed) label += " (not installed)";
       return `<option value="${b.name}" ${b.installed ? "" : "disabled"} ${b.name === first?.name ? "selected" : ""}>${label}</option>`;
     }).join("");
-  } catch { backendOpts += ["claude-code","codex","gemini-cli","opencode","kiro-cli","antigravity","grok"].map(b => `<option value="${b}">${b}</option>`).join(""); }
+  } catch { backendOpts += ["claude-code","codex","opencode","kiro-cli","antigravity","grok","gemini-cli"].map(b => `<option value="${b}">${b === "gemini-cli" ? "gemini-cli (deprecated)" : b}</option>`).join(""); }
   ov.innerHTML = `<div class="form-card"><h2>Create Instance</h2>
     <div class="form-field"><label>Directory</label><input id="ci-dir" placeholder="Optional — auto-creates workspace if empty"></div>
     <div class="form-field"><label id="ci-topic-label">Topic Name</label><input id="ci-topic" placeholder="Auto from directory name"></div>
@@ -689,7 +690,7 @@ async function loadConfig() {
       <div class="card"><h3>Defaults</h3>
         <div class="form-field"><label>Backend</label>
           <select id="cfg-backend">
-            ${["claude-code","codex","gemini-cli","opencode","kiro-cli","antigravity","grok"].map(b => `<option value="${b}" ${defs.backend===b?"selected":""}>${b}</option>`).join("")}
+            ${["claude-code","codex","opencode","kiro-cli","antigravity","grok","gemini-cli"].map(b => `<option value="${b}" ${defs.backend===b?"selected":""}>${b === "gemini-cli" ? "gemini-cli (deprecated)" : b}</option>`).join("")}
           </select></div>
       </div>
       <div class="card"><h3>Project Roots</h3>

package/dist/update-marker.d.ts

@@ -4,6 +4,36 @@
  * one quiet window, not silence until someone notices.
  */
 export declare const UPDATE_MARKER_MAX_AGE_MS: number;
+export type UpdateProgressStage = "preparing" | "downloading" | "installed" | "stopping" | "starting" | "complete" | "failed";
+export interface UpdateProgressTarget {
+    adapterId: string;
+    chatId: string;
+    threadId?: string;
+    messageId: string;
+}
+export interface UpdateProgressState {
+    stage: UpdateProgressStage;
+    target: UpdateProgressTarget;
+    version?: string;
+    error?: string;
+    failedStage?: UpdateProgressStage;
+}
+export interface UpdateMarker {
+    startedAt: number;
+    pid: number;
+    progress?: UpdateProgressState;
+}
+/** Persist the channel message that `/update` will edit across process restart. */
+export declare function beginUpdateProgress(dataDir: string, target: UpdateProgressTarget, now?: number): void;
+/** Read the live progress contract shared by the old CLI and the new fleet. */
+export declare function readUpdateProgress(dataDir: string): (UpdateMarker & {
+    progress: UpdateProgressState;
+}) | null;
+/** Advance the cross-process progress state without losing its message target. */
+export declare function setUpdateProgressStage(dataDir: string, stage: UpdateProgressStage, details?: {
+    version?: string;
+    error?: string;
+}): boolean;
 /** Called by `agend update` before it touches anything. */
 export declare function markUpdateInProgress(dataDir: string, now?: number): void;
 /** Called when the update finishes or gives up, and by the new fleet on startup. */

package/dist/update-marker.js

@@ -13,7 +13,7 @@
  * machine reboots) must not leave the fleet permanently unable to report a real
  * crash — a stale marker is ignored, and the next fleet startup deletes it.
  */
-import { existsSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
+import { existsSync, readFileSync, renameSync, unlinkSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 /**
  * How long a marker is believed. Long enough for a slow npm install plus a
@@ -25,16 +25,75 @@ const FILE = "update-in-progress.json";
 function markerPath(dataDir) {
     return join(dataDir, FILE);
 }
-/** Called by `agend update` before it touches anything. */
-export function markUpdateInProgress(dataDir, now = Date.now()) {
+function readMarker(dataDir) {
+    try {
+        const parsed = JSON.parse(readFileSync(markerPath(dataDir), "utf-8"));
+        if (typeof parsed.startedAt !== "number" || !Number.isFinite(parsed.startedAt))
+            return null;
+        if (typeof parsed.pid !== "number" || !Number.isFinite(parsed.pid))
+            return null;
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+function writeMarker(dataDir, marker) {
+    const path = markerPath(dataDir);
+    const temp = `${path}.${process.pid}.${Date.now()}.tmp`;
     try {
-        writeFileSync(markerPath(dataDir), JSON.stringify({ startedAt: now, pid: process.pid }));
+        writeFileSync(temp, JSON.stringify(marker), { mode: 0o600 });
+        renameSync(temp, path);
+        return true;
     }
     catch {
-        // Best effort: failing to write the marker costs a few spurious alerts,
-        // which is not a reason to abort someone's upgrade.
+        try {
+            unlinkSync(temp);
+        }
+        catch { /* best effort */ }
+        return false;
     }
 }
+/** Persist the channel message that `/update` will edit across process restart. */
+export function beginUpdateProgress(dataDir, target, now = Date.now()) {
+    writeMarker(dataDir, {
+        startedAt: now,
+        pid: process.pid,
+        progress: { stage: "preparing", target },
+    });
+}
+/** Read the live progress contract shared by the old CLI and the new fleet. */
+export function readUpdateProgress(dataDir) {
+    const marker = readMarker(dataDir);
+    if (!marker?.progress?.target?.messageId || !marker.progress.target.adapterId)
+        return null;
+    return marker;
+}
+/** Advance the cross-process progress state without losing its message target. */
+export function setUpdateProgressStage(dataDir, stage, details = {}) {
+    const marker = readMarker(dataDir);
+    if (!marker?.progress)
+        return false;
+    const previousStage = marker.progress.stage;
+    marker.pid = process.pid;
+    marker.progress = {
+        ...marker.progress,
+        stage,
+        ...(details.version !== undefined ? { version: details.version } : {}),
+        ...(details.error !== undefined ? { error: details.error.replace(/\s+/g, " ").trim().slice(0, 300) } : {}),
+        ...(stage === "failed" ? { failedStage: previousStage } : {}),
+    };
+    return writeMarker(dataDir, marker);
+}
+/** Called by `agend update` before it touches anything. */
+export function markUpdateInProgress(dataDir, now = Date.now()) {
+    const existing = readMarker(dataDir);
+    writeMarker(dataDir, {
+        startedAt: existing?.startedAt ?? now,
+        pid: process.pid,
+        ...(existing?.progress ? { progress: existing.progress } : {}),
+    });
+}
 /** Called when the update finishes or gives up, and by the new fleet on startup. */
 export function clearUpdateMarker(dataDir) {
     try {
@@ -47,23 +106,15 @@ export function clearUpdateMarker(dataDir) {
  * abandoned marker must not silence real incidents forever.
  */
 export function isUpdateInProgress(dataDir, now = Date.now()) {
-    const path = markerPath(dataDir);
-    if (!existsSync(path))
+    if (!existsSync(markerPath(dataDir)))
         return false;
-    let startedAt = null;
-    try {
-        const parsed = JSON.parse(readFileSync(path, "utf-8"));
-        if (typeof parsed.startedAt === "number" && Number.isFinite(parsed.startedAt)) {
-            startedAt = parsed.startedAt;
-        }
-    }
-    catch {
-        // Truncated or hand-edited: treat as unknown age rather than as fresh.
-    }
-    if (startedAt === null)
+    const marker = readMarker(dataDir);
+    if (!marker)
+        return false;
+    if (marker.progress?.stage === "failed" || marker.progress?.stage === "complete")
         return false;
     // A clock jump backwards would otherwise make a marker look infinitely fresh.
-    const age = now - startedAt;
+    const age = now - marker.startedAt;
     return age >= 0 && age < UPDATE_MARKER_MAX_AGE_MS;
 }
 //# sourceMappingURL=update-marker.js.map