@jamesaphoenix/tx-cli 0.5.2 → 0.5.9

package/dist/commands/scaffold.js

@@ -1,11 +1,11 @@
 /**
  * Scaffold Claude Code or Codex integration files into the current project.
  *
- * Copies template files (CLAUDE.md / AGENTS.md, skills, scripts) into the
+ * Copies template files (CLAUDE.md / AGENTS.md, skills, scripts, codex rules) into the
  * user's project, skipping any files that already exist.
  */
-import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync, statSync, chmodSync } from "node:fs";
-import { resolve, join, dirname, relative } from "node:path";
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync, statSync, chmodSync, accessSync, constants as fsConstants } from "node:fs";
+import { resolve, join, dirname, relative, delimiter } from "node:path";
 import { fileURLToPath } from "node:url";
 import * as p from "@clack/prompts";
 const __dirname = dirname(fileURLToPath(import.meta.url));
@@ -66,6 +66,110 @@ function copyTree(src, dest, baseDir) {
     }
     return { copied, skipped };
 }
+const WATCHDOG_RUNTIME_MODES = ["auto", "codex", "claude", "both"];
+export function parseWatchdogRuntimeMode(value) {
+    if (value === undefined) {
+        return "auto";
+    }
+    if (value === true) {
+        throw new Error("Flag --watchdog-runtime requires a value: auto|codex|claude|both.");
+    }
+    if (typeof value !== "string") {
+        throw new Error("Flag --watchdog-runtime must be one of: auto|codex|claude|both.");
+    }
+    if (WATCHDOG_RUNTIME_MODES.includes(value)) {
+        return value;
+    }
+    throw new Error(`Invalid --watchdog-runtime value: ${value} (expected: auto|codex|claude|both)`);
+}
+function commandAvailable(commandName, pathEnv) {
+    if (!pathEnv) {
+        return false;
+    }
+    const pathEntries = pathEnv.split(delimiter).filter(Boolean);
+    const isWindows = process.platform === "win32";
+    const extensions = isWindows
+        ? (process.env.PATHEXT ?? ".EXE;.CMD;.BAT;.COM").split(";")
+        : [""];
+    for (const entry of pathEntries) {
+        for (const ext of extensions) {
+            const candidate = join(entry, isWindows ? `${commandName}${ext}` : commandName);
+            try {
+                accessSync(candidate, fsConstants.X_OK);
+                if (statSync(candidate).isFile()) {
+                    return true;
+                }
+            }
+            catch {
+                continue;
+            }
+        }
+    }
+    return false;
+}
+function resolveWatchdogRuntime(mode, pathEnv) {
+    const codexAvailable = commandAvailable("codex", pathEnv);
+    const claudeAvailable = commandAvailable("claude", pathEnv);
+    if (mode === "codex") {
+        if (!codexAvailable) {
+            throw new Error("Watchdog runtime 'codex' unavailable: codex CLI not found in PATH. Install codex or use --watchdog-runtime auto|claude.");
+        }
+        return { warnings: [], watchdogEnabled: true, codexEnabled: true, claudeEnabled: false };
+    }
+    if (mode === "claude") {
+        if (!claudeAvailable) {
+            throw new Error("Watchdog runtime 'claude' unavailable: claude CLI not found in PATH. Install claude or use --watchdog-runtime auto|codex.");
+        }
+        return { warnings: [], watchdogEnabled: true, codexEnabled: false, claudeEnabled: true };
+    }
+    if (mode === "both") {
+        const missing = [];
+        if (!codexAvailable)
+            missing.push("codex");
+        if (!claudeAvailable)
+            missing.push("claude");
+        if (missing.length > 0) {
+            throw new Error(`Watchdog runtime 'both' requires codex and claude; missing: ${missing.join(", ")}.`);
+        }
+        return { warnings: [], watchdogEnabled: true, codexEnabled: true, claudeEnabled: true };
+    }
+    const codexEnabled = codexAvailable;
+    const claudeEnabled = claudeAvailable;
+    const watchdogEnabled = codexEnabled || claudeEnabled;
+    const warnings = watchdogEnabled
+        ? []
+        : [
+            "Watchdog runtime auto-detect found no codex/claude CLI in PATH. Assets were scaffolded with WATCHDOG_ENABLED=0.",
+            "Install a runtime and update .tx/watchdog.env to enable watchdog supervision.",
+        ];
+    return {
+        warnings,
+        watchdogEnabled,
+        codexEnabled,
+        claudeEnabled,
+    };
+}
+function renderWatchdogEnv(mode, runtime, detached) {
+    const as01 = (value) => (value ? "1" : "0");
+    const lines = [
+        `WATCHDOG_ENABLED=${as01(runtime.watchdogEnabled)}`,
+        `WATCHDOG_RUNTIME_MODE=${mode}`,
+        `WATCHDOG_CODEX_ENABLED=${as01(runtime.codexEnabled)}`,
+        `WATCHDOG_CLAUDE_ENABLED=${as01(runtime.claudeEnabled)}`,
+        "WATCHDOG_POLL_SECONDS=300",
+        "WATCHDOG_TRANSCRIPT_IDLE_SECONDS=600",
+        "WATCHDOG_CLAUDE_STALL_GRACE_SECONDS=900",
+        "WATCHDOG_HEARTBEAT_LAG_SECONDS=180",
+        "WATCHDOG_RUN_STALE_SECONDS=5400",
+        "WATCHDOG_IDLE_ROUNDS=300",
+        "WATCHDOG_ERROR_BURST_WINDOW_MINUTES=20",
+        "WATCHDOG_ERROR_BURST_THRESHOLD=4",
+        "WATCHDOG_ERROR_BURST_GRACE_SECONDS=600",
+        "WATCHDOG_RESTART_COOLDOWN_SECONDS=900",
+        `WATCHDOG_DETACHED=${detached ? "1" : "0"}`,
+    ];
+    return `${lines.join("\n")}\n`;
+}
 /**
  * Scaffold Claude Code integration into the current project.
  */
@@ -131,6 +235,12 @@ export function scaffoldCodex(projectDir) {
     const agentsResult = copyTree(codexAgentsSrc, codexAgentsDest);
     allCopied.push(...agentsResult.copied.map(p => `.codex/agents/${p}`));
     allSkipped.push(...agentsResult.skipped.map(p => `.codex/agents/${p}`));
+    // Copy codex command policy rules
+    const codexRulesSrc = join(templates, "codex", "rules");
+    const codexRulesDest = join(projectDir, ".codex", "rules");
+    const rulesResult = copyTree(codexRulesSrc, codexRulesDest);
+    allCopied.push(...rulesResult.copied.map(p => `.codex/rules/${p}`));
+    allSkipped.push(...rulesResult.skipped.map(p => `.codex/rules/${p}`));
     const agentsMdSrc = join(templates, "codex", "AGENTS.md");
     const agentsMdDest = join(projectDir, "AGENTS.md");
     if (existsSync(agentsMdDest)) {
@@ -150,6 +260,46 @@ export function scaffoldCodex(projectDir) {
     }
     return { copied: allCopied, skipped: allSkipped };
 }
+/**
+ * Scaffold watchdog supervision scripts/config into the current project.
+ * Runtime-specific toggles are persisted in .tx/watchdog.env.
+ */
+export function scaffoldWatchdog(projectDir, options) {
+    const allCopied = [];
+    const allSkipped = [];
+    const mode = options?.runtimeMode ?? "auto";
+    const runtime = resolveWatchdogRuntime(mode, options?.pathEnv ?? (process.env.PATH ?? ""));
+    const detached = options?.detached !== false;
+    const templates = templatesDir();
+    const scriptsSrc = join(templates, "watchdog", "scripts");
+    const scriptsDest = join(projectDir, "scripts");
+    const scriptsResult = copyTree(scriptsSrc, scriptsDest);
+    allCopied.push(...scriptsResult.copied.map(p => `scripts/${p}`));
+    allSkipped.push(...scriptsResult.skipped.map(p => `scripts/${p}`));
+    const opsSrc = join(templates, "watchdog", "ops");
+    const opsDest = join(projectDir, "ops");
+    const opsResult = copyTree(opsSrc, opsDest);
+    allCopied.push(...opsResult.copied.map(p => `ops/${p}`));
+    allSkipped.push(...opsResult.skipped.map(p => `ops/${p}`));
+    const envPath = join(projectDir, ".tx", "watchdog.env");
+    if (existsSync(envPath)) {
+        allSkipped.push(".tx/watchdog.env");
+    }
+    else {
+        mkdirSync(dirname(envPath), { recursive: true });
+        writeFileSync(envPath, renderWatchdogEnv(mode, runtime, detached));
+        allCopied.push(".tx/watchdog.env");
+    }
+    return {
+        copied: allCopied,
+        skipped: allSkipped,
+        warnings: runtime.warnings,
+        runtimeMode: mode,
+        watchdogEnabled: runtime.watchdogEnabled,
+        codexEnabled: runtime.codexEnabled,
+        claudeEnabled: runtime.claudeEnabled,
+    };
+}
 /** Format scaffold results for clack note */
 function formatResults(results) {
     const lines = [];
@@ -165,7 +315,8 @@ function formatResults(results) {
  * Interactive scaffold using @clack/prompts.
  * Asks the user what they want step by step.
  */
-export async function interactiveScaffold(projectDir) {
+export async function interactiveScaffold(projectDir, options) {
+    const watchdogRuntimeMode = options?.watchdogRuntimeMode ?? "auto";
     const wantsClaude = await p.confirm({
         message: "Add Claude Code integration? (CLAUDE.md + skills)",
         initialValue: true,
@@ -201,7 +352,7 @@ export async function interactiveScaffold(projectDir) {
         results.push(result);
     }
     const wantsCodex = await p.confirm({
-        message: "Add Codex integration? (AGENTS.md + .codex/agents)",
+        message: "Add Codex integration? (AGENTS.md + .codex/agents + .codex/rules)",
         initialValue: true,
     });
     if (p.isCancel(wantsCodex)) {
@@ -211,12 +362,27 @@ export async function interactiveScaffold(projectDir) {
     if (wantsCodex) {
         results.push(scaffoldCodex(projectDir));
     }
+    const wantsWatchdog = await p.confirm({
+        message: "Enable watchdog supervision for detached RALPH loops? (default: No)",
+        initialValue: false,
+    });
+    if (p.isCancel(wantsWatchdog)) {
+        p.cancel("Setup cancelled.");
+        return;
+    }
+    if (wantsWatchdog) {
+        const watchdogResult = scaffoldWatchdog(projectDir, { runtimeMode: watchdogRuntimeMode });
+        for (const warning of watchdogResult.warnings) {
+            p.log.warn(warning);
+        }
+        results.push(watchdogResult);
+    }
     const output = formatResults(results);
     if (output) {
         p.note(output, "Files");
     }
-    if (!wantsClaude && !wantsCodex) {
-        p.log.info("Skipped agent integration. Run tx init --claude or tx init --codex later.");
+    if (!wantsClaude && !wantsCodex && !wantsWatchdog) {
+        p.log.info("Skipped integrations. Run tx init --claude, --codex, or --watchdog later.");
     }
 }
 //# sourceMappingURL=scaffold.js.map

package/dist/commands/scaffold.js.map

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

package/dist/commands/trace.d.ts

@@ -4,7 +4,7 @@
  * CLI commands for execution tracing (PRD-019).
  */
 import { Effect } from "effect";
-import { RunRepository, SqliteClient, type DatabaseError } from "@jamesaphoenix/tx-core";
+import { RunRepository, RunHeartbeatService, SqliteClient, type DatabaseError } from "@jamesaphoenix/tx-core";
 import { type Flags } from "../utils/parse.js";
 /**
  * tx trace list - Show recent runs with event counts.
@@ -28,6 +28,19 @@ export declare const traceStderr: (pos: string[], _flags: Flags) => Effect.Effec
  * tx trace show <run-id> - Show metrics events for a run.
  */
 export declare const traceShow: (pos: string[], flags: Flags) => Effect.Effect<void, DatabaseError, RunRepository | SqliteClient>;
+/**
+ * tx trace heartbeat <run-id> - Update run heartbeat state.
+ *
+ * Primitive used by orchestration loops to record transcript/log progress.
+ */
+export declare const traceHeartbeat: (pos: string[], flags: Flags) => Effect.Effect<void, DatabaseError, RunHeartbeatService>;
+/**
+ * tx trace stalled - Find or reap stalled running runs.
+ *
+ * A run is considered stalled when transcript activity has not moved
+ * for longer than --transcript-idle-seconds.
+ */
+export declare const traceStalled: (pos: string[], flags: Flags) => Effect.Effect<void, DatabaseError, RunHeartbeatService>;
 /**
  * tx trace errors - Show recent errors across all runs.
  */
@@ -35,5 +48,5 @@ export declare const traceErrors: (_pos: string[], flags: Flags) => Effect.Effec
 /**
  * Main trace command dispatcher.
  */
-export declare const trace: (pos: string[], flags: Flags) => Effect.Effect<void, DatabaseError, RunRepository | SqliteClient>;
+export declare const trace: (pos: string[], flags: Flags) => Effect.Effect<void, DatabaseError, RunRepository | RunHeartbeatService | SqliteClient>;
 //# sourceMappingURL=trace.d.ts.map

package/dist/commands/trace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../src/commands/trace.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAG/B,OAAO,EACL,aAAa,EACb,YAAY,EACZ,KAAK,aAAa,EAGnB,MAAM,wBAAwB,CAAA;AAI/B,OAAO,EAAE,KAAK,KAAK,EAAqB,MAAM,mBAAmB,CAAA;AAmDjE;;GAEG;AACH,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,EAAE,EAAE,OAAO,KAAK,KAmE9C,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,EAAE,aAAa,GAAG,YAAY,CAAC,CAAA;AAiIxE;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAAI,KAAK,MAAM,EAAE,EAAE,QAAQ,KAAK,KA4CpD,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,EAAE,aAAa,CAAC,CAAA;AAEzD;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,KAAK,MAAM,EAAE,EAAE,QAAQ,KAAK,KA4ChD,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,EAAE,aAAa,CAAC,CAAA;AAEzD;;GAEG;AACH,eAAO,MAAM,SAAS,GAAI,KAAK,MAAM,EAAE,EAAE,OAAO,KAAK,KA0L7C,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,EAAE,aAAa,GAAG,YAAY,CAAC,CAAA;AAwCxE;;GAEG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,EAAE,EAAE,OAAO,KAAK,KAuIhD,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,EAAE,YAAY,CAAC,CAAA;AAExD;;GAEG;AACH,eAAO,MAAM,KAAK,GAAI,KAAK,MAAM,EAAE,EAAE,OAAO,KAAK,KAgDzC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,EAAE,aAAa,GAAG,YAAY,CAAC,CAAA"}
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../src/commands/trace.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAG/B,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,YAAY,EACZ,KAAK,aAAa,EAGnB,MAAM,wBAAwB,CAAA;AAI/B,OAAO,EAAE,KAAK,KAAK,EAA0B,MAAM,mBAAmB,CAAA;AAmDtE;;GAEG;AACH,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,EAAE,EAAE,OAAO,KAAK,KA6D9C,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,EAAE,aAAa,GAAG,YAAY,CAAC,CAAA;AAiIxE;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAAI,KAAK,MAAM,EAAE,EAAE,QAAQ,KAAK,KA4CpD,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,EAAE,aAAa,CAAC,CAAA;AAEzD;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,KAAK,MAAM,EAAE,EAAE,QAAQ,KAAK,KA4ChD,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,EAAE,aAAa,CAAC,CAAA;AAEzD;;GAEG;AACH,eAAO,MAAM,SAAS,GAAI,KAAK,MAAM,EAAE,EAAE,OAAO,KAAK,KA0L7C,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,EAAE,aAAa,GAAG,YAAY,CAAC,CAAA;AAgDxE;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAI,KAAK,MAAM,EAAE,EAAE,OAAO,KAAK,KAsDlD,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,EAAE,mBAAmB,CAAC,CAAA;AAE/D;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,KAAK,MAAM,EAAE,EAAE,OAAO,KAAK,KA0DhD,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,EAAE,mBAAmB,CAAC,CAAA;AAE/D;;GAEG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,EAAE,EAAE,OAAO,KAAK,KAuIhD,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,EAAE,YAAY,CAAC,CAAA;AAExD;;GAEG;AACH,eAAO,MAAM,KAAK,GAAI,KAAK,MAAM,EAAE,EAAE,OAAO,KAAK,KAsDzC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,EAAE,aAAa,GAAG,mBAAmB,GAAG,YAAY,CAAC,CAAA"}

package/dist/commands/trace.js

@@ -6,10 +6,10 @@
 import { Effect } from "effect";
 import { existsSync, readFileSync } from "node:fs";
 import { join, resolve } from "node:path";
-import { RunRepository, SqliteClient, getAdapter } from "@jamesaphoenix/tx-core";
+import { RunRepository, RunHeartbeatService, SqliteClient, getAdapter } from "@jamesaphoenix/tx-core";
 import { toJson, truncate } from "../output.js";
 import { commandHelp } from "../help.js";
-import { flag, parseIntOpt } from "../utils/parse.js";
+import { flag, opt, parseIntOpt } from "../utils/parse.js";
 /**
  * Calculate relative time string (e.g., "2h ago", "3d ago").
  */
@@ -38,7 +38,7 @@ const getSpanCountsForRuns = (db, runIds) => {
     const rows = db.prepare(`
     SELECT run_id, COUNT(*) as count
     FROM events
-    WHERE run_id IN (${placeholders}) AND event_type = 'span'
+    WHERE event_type = 'span' AND run_id IN (${placeholders})
     GROUP BY run_id
   `).all(...runIds);
     const counts = new Map();
@@ -56,14 +56,9 @@ export const traceList = (_pos, flags) => Effect.gen(function* () {
     // Parse options
     const limit = parseIntOpt(flags, "limit", "limit", "n") ?? 20;
     const hours = parseIntOpt(flags, "hours", "hours") ?? 24;
-    // Get recent runs - for now we'll get more than needed and filter by time
-    // A more efficient approach would be to add a time-filtered query to RunRepository
-    const allRuns = yield* runRepo.findRecent(limit * 2); // Get extra to account for time filtering
-    // Filter to runs within the specified hours
-    const cutoff = Date.now() - hours * 60 * 60 * 1000;
-    const recentRuns = allRuns
-        .filter(r => r.startedAt.getTime() >= cutoff)
-        .slice(0, limit);
+    // Push time-window filtering into SQL to avoid overfetching runs in memory.
+    const cutoff = new Date(Date.now() - hours * 60 * 60 * 1000);
+    const recentRuns = yield* runRepo.findRecentSince(cutoff, limit);
     // Get span counts for all runs
     const runIds = recentRuns.map(r => r.id);
     const spanCounts = getSpanCountsForRuns(db, runIds);
@@ -440,6 +435,123 @@ export const traceShow = (pos, flags) => Effect.gen(function* () {
     console.log("");
     console.log(`${metricsEvents.length} event(s)`);
 });
+const parseRunId = (raw) => {
+    if (!/^run-.+$/.test(raw)) {
+        console.error(`Invalid run ID: "${raw}". Expected format: run-<id>`);
+        process.exit(1);
+    }
+    return raw;
+};
+/**
+ * tx trace heartbeat <run-id> - Update run heartbeat state.
+ *
+ * Primitive used by orchestration loops to record transcript/log progress.
+ */
+export const traceHeartbeat = (pos, flags) => Effect.gen(function* () {
+    const raw = pos[0];
+    if (!raw) {
+        console.error("Error: run-id is required");
+        console.error("Usage: tx trace heartbeat <run-id> [--stdout-bytes <n>] [--stderr-bytes <n>] [--transcript-bytes <n>] [--delta-bytes <n>] [--check-at <iso>] [--activity-at <iso>]");
+        process.exit(1);
+    }
+    const runId = parseRunId(raw);
+    const svc = yield* RunHeartbeatService;
+    const stdoutBytes = parseIntOpt(flags, "stdout-bytes", "stdout-bytes") ?? 0;
+    const stderrBytes = parseIntOpt(flags, "stderr-bytes", "stderr-bytes") ?? 0;
+    const transcriptBytes = parseIntOpt(flags, "transcript-bytes", "transcript-bytes") ?? 0;
+    const deltaBytes = parseIntOpt(flags, "delta-bytes", "delta-bytes") ?? 0;
+    const parseDateFlag = (name) => {
+        const rawValue = opt(flags, name);
+        if (!rawValue)
+            return undefined;
+        const parsed = new Date(rawValue);
+        if (Number.isNaN(parsed.getTime())) {
+            console.error(`Invalid value for --${name}: "${rawValue}" is not a valid ISO timestamp`);
+            process.exit(1);
+        }
+        return parsed;
+    };
+    const checkAt = parseDateFlag("check-at");
+    const activityAt = parseDateFlag("activity-at");
+    yield* svc.heartbeat({
+        runId,
+        checkAt,
+        activityAt,
+        stdoutBytes,
+        stderrBytes,
+        transcriptBytes,
+        deltaBytes,
+    });
+    if (flag(flags, "json")) {
+        console.log(toJson({
+            runId,
+            checkAt: (checkAt ?? new Date()).toISOString(),
+            activityAt: activityAt?.toISOString() ?? null,
+            stdoutBytes,
+            stderrBytes,
+            transcriptBytes,
+            deltaBytes,
+        }));
+    }
+    else {
+        console.log(`Heartbeat updated: ${runId}`);
+    }
+});
+/**
+ * tx trace stalled - Find or reap stalled running runs.
+ *
+ * A run is considered stalled when transcript activity has not moved
+ * for longer than --transcript-idle-seconds.
+ */
+export const traceStalled = (pos, flags) => Effect.gen(function* () {
+    const _ = pos; // reserved for future positional args
+    void _;
+    const svc = yield* RunHeartbeatService;
+    const transcriptIdleSeconds = parseIntOpt(flags, "transcript-idle-seconds", "transcript-idle-seconds") ?? 300;
+    const heartbeatLagSeconds = parseIntOpt(flags, "heartbeat-lag-seconds", "heartbeat-lag-seconds");
+    const reap = flag(flags, "reap", "kill");
+    const dryRun = flag(flags, "dry-run");
+    const noResetTask = flag(flags, "no-reset-task");
+    if (reap) {
+        const results = yield* svc.reapStalled({
+            transcriptIdleSeconds,
+            heartbeatLagSeconds,
+            dryRun,
+            resetTask: !noResetTask,
+        });
+        if (flag(flags, "json")) {
+            console.log(toJson(results));
+            return;
+        }
+        if (results.length === 0) {
+            console.log("No stalled running runs found.");
+            return;
+        }
+        console.log(`Reaped stalled runs (${results.length}):`);
+        for (const row of results) {
+            console.log(`  ${row.id} [${row.reason}] pid=${row.pid ?? "-"} task=${row.taskId ?? "-"}`);
+            console.log(`    processTerminated=${row.processTerminated} taskReset=${row.taskReset}`);
+        }
+        return;
+    }
+    const results = yield* svc.listStalled({
+        transcriptIdleSeconds,
+        heartbeatLagSeconds,
+    });
+    if (flag(flags, "json")) {
+        console.log(toJson(results));
+        return;
+    }
+    if (results.length === 0) {
+        console.log("No stalled running runs found.");
+        return;
+    }
+    console.log(`Stalled running runs (${results.length}):`);
+    for (const row of results) {
+        console.log(`  ${row.run.id} [${row.reason}] pid=${row.run.pid ?? "-"} task=${row.run.taskId ?? "-"}`);
+        console.log(`    transcriptIdleSeconds=${row.transcriptIdleSeconds ?? "-"} heartbeatLagSeconds=${row.heartbeatLagSeconds ?? "-"}`);
+    }
+});
 /**
  * tx trace errors - Show recent errors across all runs.
  */
@@ -454,10 +566,10 @@ export const traceErrors = (_pos, flags) => Effect.gen(function* () {
     const failedRuns = db.prepare(`
       SELECT id, task_id, agent, ended_at, error_message
       FROM runs
-      WHERE status = 'failed' AND ended_at >= ?
+      WHERE status = ? AND ended_at >= ?
       ORDER BY ended_at DESC
       LIMIT ?
-    `).all(cutoff, limit);
+    `).all("failed", cutoff, limit);
     for (const run of failedRuns) {
         errors.push({
             timestamp: run.ended_at ? new Date(run.ended_at) : new Date(),
@@ -474,12 +586,12 @@ export const traceErrors = (_pos, flags) => Effect.gen(function* () {
     const errorSpans = db.prepare(`
       SELECT timestamp, run_id, task_id, agent, content, metadata, duration_ms
       FROM events
-      WHERE event_type = 'span'
+      WHERE event_type = ?
+        AND json_extract(metadata, '$.status') = ?
         AND timestamp >= ?
-        AND json_extract(metadata, '$.status') = 'error'
       ORDER BY timestamp DESC
       LIMIT ?
-    `).all(cutoff, limit);
+    `).all("span", "error", cutoff, limit);
     for (const span of errorSpans) {
         let errorMessage = "Unknown error";
         try {
@@ -506,10 +618,10 @@ export const traceErrors = (_pos, flags) => Effect.gen(function* () {
     const errorEvents = db.prepare(`
       SELECT timestamp, run_id, task_id, agent, content, metadata, duration_ms
       FROM events
-      WHERE event_type = 'error' AND timestamp >= ?
+      WHERE event_type = ? AND timestamp >= ?
       ORDER BY timestamp DESC
       LIMIT ?
-    `).all(cutoff, limit);
+    `).all("error", cutoff, limit);
     for (const event of errorEvents) {
         errors.push({
             timestamp: new Date(event.timestamp),
@@ -578,6 +690,8 @@ Subcommands:
   show <run-id>               Show metrics events for a run
   transcript <run-id>         Display raw transcript content
   stderr <run-id>             Display stderr content
+  heartbeat <run-id>          Update heartbeat state for a run
+  stalled                     List or reap stalled running runs
   errors                      Show recent errors across all runs
 
 Options:
@@ -608,6 +722,12 @@ Options:
     else if (subcommand === "stderr") {
         yield* traceStderr(pos.slice(1), flags);
     }
+    else if (subcommand === "heartbeat") {
+        yield* traceHeartbeat(pos.slice(1), flags);
+    }
+    else if (subcommand === "stalled") {
+        yield* traceStalled(pos.slice(1), flags);
+    }
     else if (subcommand === "errors") {
         yield* traceErrors(pos.slice(1), flags);
     }