@agentmeshhq/agent 0.2.0 → 0.2.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 therajushahi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -115,6 +115,45 @@ The AI assistant sees the injected message as if you typed it, maintaining full
 - Node.js 18+
 - An AgentMesh HQ account with API key
 
+## Versioning
+
+This package uses [Semantic Versioning](https://semver.org). Releases are fully automated — **do not publish manually**.
+
+### How to release
+
+1. Update `version` in `packages/agent/package.json` on the `dev` branch (via PR).
+2. Push a tag matching `agent-v<version>` from the commit where the version was bumped:
+
+   ```bash
+   # After your version-bump PR is merged to dev and pulled locally:
+   git tag agent-v0.2.1 <merge-commit-sha>
+   git push origin agent-v0.2.1
+   ```
+
+3. The `publish-agent.yml` GitHub Actions workflow triggers automatically and:
+   - Builds and tests the package
+   - Verifies `package.json` version matches the tag
+   - Publishes to npm as `@agentmeshhq/agent`
+   - Creates a GitHub Release
+   - Updates the Homebrew formula in `therajushahi/homebrew-agentmesh`
+
+### Rules
+
+- **Never run `npm publish` manually.** It bypasses the version check and can publish a mismatched version (e.g. a `package.json` that says `0.1.2` getting published as `0.2.0`).
+- **Never skip a version number.** The Homebrew formula uses the version string; if the npm registry already has a higher version, `brew upgrade` will not install the new formula.
+- **The tag drives everything.** The tag name (`agent-v0.2.1`) is the source of truth — the workflow validates that `package.json` matches before publishing.
+- **All work targets `dev`.** `main` is for releases only, managed by the Product Owner. PRs must target `dev`.
+
+### Version history incident
+
+In Feb 2026, `0.2.0` was published manually with `npm publish` from a commit whose `package.json` said `0.1.2`. This caused:
+- npm registry to have `0.2.0` as the latest version
+- The Homebrew formula to point at `0.2.0`
+- All subsequent CI-published versions (`0.1.3`, `0.1.4`) to be *lower* than `0.2.0`, so `brew upgrade` ignored them
+- Workers already on `0.2.0` unable to receive fixes
+
+The fix was to bump past `0.2.0` → `0.2.1` using the correct automated pipeline.
+
 ## License
 
 MIT

package/dist/__tests__/orphan-process.test.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Tests for orphaned process prevention (P0 fix for the daemon process leak).
+ *
+ * Covers:
+ * - killProcessTree: SIGTERM → SIGKILL escalation
+ * - getTmuxPanePid: reads PID from tmux pane
+ * - getProcessTree: recursive child enumeration
+ * - captureAgentChildPids: captures all PIDs for a given agent
+ * - destroySession: kills child PIDs before killing tmux session
+ */
+export {};

package/dist/__tests__/orphan-process.test.js

@@ -0,0 +1,286 @@
+/**
+ * Tests for orphaned process prevention (P0 fix for the daemon process leak).
+ *
+ * Covers:
+ * - killProcessTree: SIGTERM → SIGKILL escalation
+ * - getTmuxPanePid: reads PID from tmux pane
+ * - getProcessTree: recursive child enumeration
+ * - captureAgentChildPids: captures all PIDs for a given agent
+ * - destroySession: kills child PIDs before killing tmux session
+ */
+import { execSync } from "node:child_process";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { captureAgentChildPids, getProcessTree, getTmuxPanePid } from "../core/daemon/state.js";
+import { destroySession, killProcessTree } from "../core/tmux.js";
+// ─── Mocks ────────────────────────────────────────────────────────────────────
+vi.mock("node:child_process", () => ({
+    execSync: vi.fn(),
+    execFileSync: vi.fn(),
+    spawnSync: vi.fn(),
+}));
+vi.mock("../core/tmux-runtime.js", () => ({
+    buildInteractiveCommand: vi.fn().mockReturnValue("opencode"),
+    detectRunnerCommandKind: vi.fn().mockReturnValue("opencode"),
+    prepareOpenCodeRuntime: vi.fn().mockReturnValue("/tmp/test-runtime"),
+}));
+// Helper to mock process.kill without type gymnastics
+function mockProcessKill(impl) {
+    return vi.spyOn(process, "kill").mockImplementation(impl);
+}
+const mockExecSync = vi.mocked(execSync);
+// ─── killProcessTree ──────────────────────────────────────────────────────────
+describe("killProcessTree", () => {
+    let killSpy;
+    beforeEach(() => {
+        killSpy = mockProcessKill(() => true);
+        vi.useFakeTimers();
+    });
+    afterEach(() => {
+        killSpy.mockRestore();
+        vi.useRealTimers();
+    });
+    it("returns true immediately if pids list is empty", () => {
+        const result = killProcessTree([]);
+        expect(result).toBe(true);
+        expect(killSpy).not.toHaveBeenCalled();
+    });
+    it("sends SIGTERM to all provided PIDs", () => {
+        // Track whether SIGTERM has been sent to each PID
+        const terminatedPids = new Set();
+        killSpy.mockImplementation((_pid, sig) => {
+            if (sig === "SIGTERM") {
+                terminatedPids.add(_pid);
+                return true;
+            }
+            if (sig === 0) {
+                // Alive until SIGTERM has been sent
+                if (terminatedPids.has(_pid))
+                    throw new Error("no such process");
+                return true;
+            }
+            return true;
+        });
+        mockExecSync.mockReturnValue("");
+        killProcessTree([1234, 5678]);
+        expect(killSpy).toHaveBeenCalledWith(1234, "SIGTERM");
+        expect(killSpy).toHaveBeenCalledWith(5678, "SIGTERM");
+    });
+    it("escalates to SIGKILL after timeout when processes remain alive", () => {
+        // Process stays alive through SIGTERM, only dies after SIGKILL check
+        let killedWithSigkill = false;
+        killSpy.mockImplementation((_pid, sig) => {
+            if (sig === "SIGKILL") {
+                killedWithSigkill = true;
+                return true;
+            }
+            if (sig === 0) {
+                // Stay alive until SIGKILL has been sent
+                if (killedWithSigkill)
+                    throw new Error("no such process");
+                return true;
+            }
+            return true;
+        });
+        mockExecSync.mockImplementation((cmd) => {
+            if (cmd === "sleep 0.1")
+                vi.advanceTimersByTime(100);
+            return "";
+        });
+        killProcessTree([1234], 200);
+        expect(killSpy).toHaveBeenCalledWith(1234, "SIGTERM");
+        expect(killSpy).toHaveBeenCalledWith(1234, "SIGKILL");
+    });
+    it("does not SIGKILL when processes exit gracefully before timeout", () => {
+        let sigkillCalled = false;
+        let terminatedPid = null;
+        killSpy.mockImplementation((_pid, sig) => {
+            if (sig === "SIGKILL") {
+                sigkillCalled = true;
+                return true;
+            }
+            if (sig === "SIGTERM") {
+                terminatedPid = _pid;
+                return true;
+            }
+            if (sig === 0) {
+                // Dead after SIGTERM
+                if (terminatedPid === _pid)
+                    throw new Error("no such process");
+                return true;
+            }
+            return true;
+        });
+        mockExecSync.mockReturnValue("");
+        killProcessTree([1234]);
+        expect(sigkillCalled).toBe(false);
+    });
+});
+// ─── getTmuxPanePid ────────────────────────────────────────────────────────────
+describe("getTmuxPanePid", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    it("returns parsed PID from tmux list-panes output", () => {
+        mockExecSync.mockReturnValue("42000\n");
+        const pid = getTmuxPanePid("agentmesh-test-agent");
+        expect(pid).toBe(42000);
+    });
+    it("returns null when tmux command fails", () => {
+        mockExecSync.mockImplementation(() => {
+            throw new Error("no server running");
+        });
+        const pid = getTmuxPanePid("agentmesh-nonexistent");
+        expect(pid).toBeNull();
+    });
+    it("returns null when output is not a valid number", () => {
+        mockExecSync.mockReturnValue("not-a-pid\n");
+        const pid = getTmuxPanePid("agentmesh-test-agent");
+        expect(pid).toBeNull();
+    });
+});
+// ─── getProcessTree ────────────────────────────────────────────────────────────
+describe("getProcessTree", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    it("returns direct children of a process", () => {
+        mockExecSync.mockImplementation((cmd) => {
+            const c = cmd;
+            if (c.includes("pgrep -P 1000"))
+                return "1001\n1002\n";
+            return "";
+        });
+        const tree = getProcessTree(1000);
+        expect(tree).toContain(1001);
+        expect(tree).toContain(1002);
+    });
+    it("recursively includes grandchildren", () => {
+        mockExecSync.mockImplementation((cmd) => {
+            const c = cmd;
+            if (c.includes("pgrep -P 1000"))
+                return "1001\n";
+            if (c.includes("pgrep -P 1001"))
+                return "1002\n";
+            return "";
+        });
+        const tree = getProcessTree(1000);
+        expect(tree).toContain(1001);
+        expect(tree).toContain(1002);
+    });
+    it("returns empty array when process has no children", () => {
+        mockExecSync.mockReturnValue("");
+        const tree = getProcessTree(9999);
+        expect(tree).toEqual([]);
+    });
+    it("returns empty array when pgrep fails", () => {
+        mockExecSync.mockImplementation(() => {
+            throw new Error("pgrep: no matching processes");
+        });
+        const tree = getProcessTree(9999);
+        expect(tree).toEqual([]);
+    });
+});
+// ─── captureAgentChildPids ─────────────────────────────────────────────────────
+describe("captureAgentChildPids", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    it("returns empty array when tmux session has no pane PID", () => {
+        mockExecSync.mockImplementation(() => {
+            throw new Error("no server");
+        });
+        const pids = captureAgentChildPids("test-agent");
+        expect(pids).toEqual([]);
+    });
+    it("returns pane PID and all descendants", () => {
+        mockExecSync.mockImplementation((cmd) => {
+            const c = cmd;
+            if (c.includes("list-panes"))
+                return "5000\n";
+            if (c.includes("pgrep -P 5000"))
+                return "5001\n5002\n";
+            return "";
+        });
+        const pids = captureAgentChildPids("test-agent");
+        expect(pids).toContain(5000);
+        expect(pids).toContain(5001);
+        expect(pids).toContain(5002);
+    });
+    it("deduplicates PIDs", () => {
+        mockExecSync.mockImplementation((cmd) => {
+            const c = cmd;
+            if (c.includes("list-panes"))
+                return "5000\n";
+            if (c.includes("pgrep -P 5000"))
+                return "5001\n5001\n"; // duplicate
+            return "";
+        });
+        const pids = captureAgentChildPids("test-agent");
+        const uniquePids = [...new Set(pids)];
+        expect(pids.length).toBe(uniquePids.length);
+    });
+});
+// ─── destroySession with childPids ────────────────────────────────────────────
+describe("destroySession with childPids", () => {
+    let killSpy;
+    beforeEach(() => {
+        killSpy = mockProcessKill(() => true);
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        killSpy.mockRestore();
+    });
+    it("kills child PIDs before killing the tmux session", () => {
+        const callOrder = [];
+        const terminatedPids = new Set();
+        killSpy.mockImplementation((_pid, sig) => {
+            if (sig === "SIGTERM") {
+                callOrder.push(`kill-${_pid}`);
+                terminatedPids.add(_pid);
+                return true;
+            }
+            if (sig === 0) {
+                if (terminatedPids.has(_pid))
+                    throw new Error("dead");
+                return true;
+            }
+            return true;
+        });
+        mockExecSync.mockImplementation((cmd) => {
+            const c = cmd;
+            if (c.includes("has-session"))
+                return "";
+            if (c.includes("kill-session"))
+                callOrder.push("tmux-kill");
+            return "";
+        });
+        destroySession("test-agent", [1234, 5678]);
+        const childKillIndex = callOrder.findIndex((c) => c.startsWith("kill-"));
+        const tmuxKillIndex = callOrder.indexOf("tmux-kill");
+        expect(childKillIndex).toBeGreaterThanOrEqual(0);
+        expect(tmuxKillIndex).toBeGreaterThan(childKillIndex);
+    });
+    it("still destroys tmux session when no childPids provided", () => {
+        mockExecSync.mockImplementation((cmd) => {
+            const c = cmd;
+            if (c.includes("has-session"))
+                return "";
+            return "";
+        });
+        destroySession("test-agent");
+        expect(mockExecSync).toHaveBeenCalledWith(expect.stringContaining("kill-session"));
+        expect(killSpy).not.toHaveBeenCalled();
+    });
+    it("still destroys tmux session when childPids is empty array", () => {
+        mockExecSync.mockImplementation((cmd) => {
+            const c = cmd;
+            if (c.includes("has-session"))
+                return "";
+            return "";
+        });
+        destroySession("test-agent", []);
+        expect(mockExecSync).toHaveBeenCalledWith(expect.stringContaining("kill-session"));
+        expect(killSpy).not.toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=orphan-process.test.js.map

package/dist/__tests__/orphan-process.test.js.map

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

package/dist/__tests__/runner.test.js

@@ -12,6 +12,11 @@ describe("Runner Module", () => {
             expect(detectRunner("claude --some-flag")).toBe("claude");
             expect(detectRunner("CLAUDE")).toBe("claude");
         });
+        it("should detect codex runner", () => {
+            expect(detectRunner("codex")).toBe("codex");
+            expect(detectRunner("codex --some-flag")).toBe("codex");
+            expect(detectRunner("CODEX")).toBe("codex");
+        });
         it("should detect custom runner for unknown commands", () => {
             expect(detectRunner("aider")).toBe("custom");
             expect(detectRunner("cursor")).toBe("custom");
@@ -75,11 +80,22 @@ describe("Runner Module", () => {
             expect(config.model).toBe("gpt-4");
             expect(Object.keys(config.env)).toHaveLength(0);
         });
+        it("should build config for codex with CODEX_MODEL env", () => {
+            const config = buildRunnerConfig({
+                cliModel: "openai/gpt-5-codex",
+                defaultModel: "anthropic/claude-sonnet-4-5",
+                command: "codex",
+            });
+            expect(config.type).toBe("codex");
+            expect(config.model).toBe("openai/gpt-5-codex");
+            expect(config.env.CODEX_MODEL).toBe("openai/gpt-5-codex");
+        });
     });
     describe("getRunnerDisplayName", () => {
         it("should return correct display names", () => {
             expect(getRunnerDisplayName("opencode")).toBe("OpenCode");
             expect(getRunnerDisplayName("claude")).toBe("Claude CLI");
+            expect(getRunnerDisplayName("codex")).toBe("Codex CLI");
             expect(getRunnerDisplayName("custom")).toBe("Custom");
         });
     });

package/dist/__tests__/runner.test.js.map

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

package/dist/__tests__/watchdog.test.js

@@ -1,7 +1,10 @@
 import { execSync, spawnSync } from "node:child_process";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import * as tmux from "../core/tmux.js";
-import { checkAgentProgress, cleanupOrphanContainers, detectPermissionPrompt, findOrphanContainers, getLastActivityTime, isProcessRunning, sendNudge, } from "../core/watchdog.js";
+import { checkAgentProgress, cleanupOrphanContainers, clearWaitingForHuman, detectPermissionPrompt, findOrphanContainers, getLastActivityTime, isProcessRunning, isWaitingForHuman, sendNudge, setWaitingForHuman, } from "../core/watchdog.js";
 // Mock child_process
 vi.mock("node:child_process", () => ({
     execSync: vi.fn(),
@@ -11,6 +14,19 @@ vi.mock("node:child_process", () => ({
 vi.mock("../core/tmux.js", () => ({
     captureSessionOutput: vi.fn(),
 }));
+// Mock node:fs for waiting signal file tests
+vi.mock("node:fs", () => ({
+    default: {
+        mkdirSync: vi.fn(),
+        writeFileSync: vi.fn(),
+        unlinkSync: vi.fn(),
+        readFileSync: vi.fn(),
+    },
+    mkdirSync: vi.fn(),
+    writeFileSync: vi.fn(),
+    unlinkSync: vi.fn(),
+    readFileSync: vi.fn(),
+}));
 describe("Watchdog Module", () => {
     beforeEach(() => {
         vi.resetAllMocks();
@@ -48,20 +64,36 @@ describe("Watchdog Module", () => {
             const result = detectPermissionPrompt("test-agent");
             expect(result).toBeNull();
         });
+        it("should not treat standalone 'Reject' text as a permission prompt", () => {
+            vi.mocked(tmux.captureSessionOutput).mockReturnValue("Unit test failed\nReject this PR until CI is green");
+            const result = detectPermissionPrompt("test-agent");
+            expect(result).toBeNull();
+        });
     });
     describe("getLastActivityTime", () => {
         it("should parse timestamp from local log file", () => {
-            vi.mocked(spawnSync).mockReturnValue({
-                status: 0,
-                stdout: "INFO  2026-02-26T00:14:42 +0ms service=opencode message=test",
-                stderr: "",
-                pid: 123,
-                signal: null,
-                output: [],
-            });
-            const result = getLastActivityTime("test-agent");
-            expect(result).toBeInstanceOf(Date);
-            expect(result?.toISOString()).toContain("2026-02-26");
+            const originalHome = process.env.HOME;
+            try {
+                process.env.HOME = "/tmp/agent-home";
+                vi.mocked(spawnSync).mockReturnValue({
+                    status: 0,
+                    stdout: "INFO  2026-02-26T00:14:42 +0ms service=opencode message=test",
+                    stderr: "",
+                    pid: 123,
+                    signal: null,
+                    output: [],
+                });
+                const result = getLastActivityTime("test-agent");
+                expect(result).toBeInstanceOf(Date);
+                expect(result?.toISOString()).toContain("2026-02-26");
+                expect(spawnSync).toHaveBeenCalledWith("sh", [
+                    "-c",
+                    "ls -t /tmp/agent-home/.agentmesh/opencode-data/test-agent/opencode/log/*.log 2>/dev/null | head -1 | xargs tail -1 2>/dev/null",
+                ], { encoding: "utf-8", timeout: 5000 });
+            }
+            finally {
+                process.env.HOME = originalHome;
+            }
         });
         it("should parse timestamp from container log file", () => {
             vi.mocked(spawnSync).mockReturnValue({
@@ -286,5 +318,99 @@ describe("Watchdog Module", () => {
             expect(execSync).toHaveBeenCalledWith(expect.stringContaining('\\"quotes\\"'), expect.any(Object));
         });
     });
+    describe("waiting-for-human signal", () => {
+        const agentName = "test-agent";
+        const waitingFilePath = path.join(os.homedir(), ".agentmesh", "agents", `${agentName}.waiting`);
+        beforeEach(() => {
+            vi.resetAllMocks();
+        });
+        describe("setWaitingForHuman", () => {
+            it("should create the agents directory and write the signal file", () => {
+                setWaitingForHuman(agentName, "Waiting for approval");
+                expect(fs.mkdirSync).toHaveBeenCalledWith(path.join(os.homedir(), ".agentmesh", "agents"), {
+                    recursive: true,
+                });
+                expect(fs.writeFileSync).toHaveBeenCalledWith(waitingFilePath, expect.stringContaining("Waiting for approval"), { mode: 0o600 });
+            });
+            it("should use default reason when none provided", () => {
+                setWaitingForHuman(agentName);
+                expect(fs.writeFileSync).toHaveBeenCalledWith(waitingFilePath, expect.stringContaining("Waiting for human input"), { mode: 0o600 });
+            });
+            it("should write valid JSON with reason and since fields", () => {
+                setWaitingForHuman(agentName, "Test reason");
+                const writeCall = vi.mocked(fs.writeFileSync).mock.calls[0];
+                const written = JSON.parse(writeCall[1]);
+                expect(written).toHaveProperty("reason", "Test reason");
+                expect(written).toHaveProperty("since");
+                expect(() => new Date(written.since)).not.toThrow();
+            });
+        });
+        describe("clearWaitingForHuman", () => {
+            it("should delete the signal file", () => {
+                clearWaitingForHuman(agentName);
+                expect(fs.unlinkSync).toHaveBeenCalledWith(waitingFilePath);
+            });
+            it("should not throw when the signal file does not exist", () => {
+                vi.mocked(fs.unlinkSync).mockImplementation(() => {
+                    throw new Error("ENOENT: no such file");
+                });
+                expect(() => clearWaitingForHuman(agentName)).not.toThrow();
+            });
+        });
+        describe("isWaitingForHuman", () => {
+            it("should return waiting=true with reason and since when signal file exists", () => {
+                const payload = { reason: "Awaiting handoff reply", since: "2026-02-28T10:00:00.000Z" };
+                vi.mocked(fs.readFileSync).mockReturnValue(JSON.stringify(payload));
+                const result = isWaitingForHuman(agentName);
+                expect(result.waiting).toBe(true);
+                expect(result.reason).toBe("Awaiting handoff reply");
+                expect(result.since).toBe("2026-02-28T10:00:00.000Z");
+            });
+            it("should return waiting=false when signal file does not exist", () => {
+                vi.mocked(fs.readFileSync).mockImplementation(() => {
+                    throw new Error("ENOENT: no such file");
+                });
+                const result = isWaitingForHuman(agentName);
+                expect(result.waiting).toBe(false);
+            });
+            it("should return waiting=false on malformed JSON", () => {
+                vi.mocked(fs.readFileSync).mockReturnValue("not-json");
+                const result = isWaitingForHuman(agentName);
+                expect(result.waiting).toBe(false);
+            });
+        });
+        describe("checkAgentProgress with waiting_for_human", () => {
+            it("should return waiting_for_human when signal file exists, before any other check", () => {
+                const payload = {
+                    reason: "Waiting for Terraform decision",
+                    since: "2026-02-28T10:00:00.000Z",
+                };
+                vi.mocked(fs.readFileSync).mockReturnValue(JSON.stringify(payload));
+                // Even with a permission prompt visible in tmux, waiting_for_human takes priority
+                vi.mocked(tmux.captureSessionOutput).mockReturnValue("Permission required\nAllow once");
+                const result = checkAgentProgress(agentName);
+                expect(result.status).toBe("waiting_for_human");
+                expect(result.details).toBe("Waiting for Terraform decision");
+            });
+            it("should fall through to normal checks when no signal file", () => {
+                vi.mocked(fs.readFileSync).mockImplementation(() => {
+                    throw new Error("ENOENT");
+                });
+                vi.mocked(tmux.captureSessionOutput).mockReturnValue("Normal output");
+                // Mock recent activity so it returns active
+                const recentTime = new Date(Date.now() - 30 * 1000);
+                vi.mocked(spawnSync).mockReturnValue({
+                    status: 0,
+                    stdout: `INFO  ${recentTime.toISOString().slice(0, 19)} +0ms service=opencode`,
+                    stderr: "",
+                    pid: 123,
+                    signal: null,
+                    output: [],
+                });
+                const result = checkAgentProgress(agentName);
+                expect(result.status).toBe("active");
+            });
+        });
+    });
 });
 //# sourceMappingURL=watchdog.test.js.map