scai 0.1.178 → 1.0.0

package/dist/__tests__/utils/runtimeLogger.test.js

@@ -0,0 +1,200 @@
+/**
+ * Covers the shared Stage 1 runtime log writer and legacy log shim.
+ *
+ * Why this file exists:
+ * - `runtime.log` and `runtime.ndjson` should be written together
+ * - old `logInputOutput(...)` callers should still append useful records during migration
+ * - the log file rename should stay stable for eval and integration flows
+ */
+import fs from "fs";
+import os from "os";
+import path from "path";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+function stripAnsi(text) {
+    return text.replace(/\x1B\[[0-9;]*m/g, "");
+}
+describe("runtimeLogger", () => {
+    let tempDir;
+    let originalTz;
+    beforeEach(() => {
+        tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "scai-runtime-log-"));
+        originalTz = process.env.TZ;
+        vi.resetModules();
+    });
+    afterEach(() => {
+        process.env.TZ = originalTz;
+        fs.rmSync(tempDir, { recursive: true, force: true });
+    });
+    it("writes both runtime.log and runtime.ndjson", async () => {
+        vi.doMock("../../constants.js", async (importOriginal) => {
+            const actual = await importOriginal();
+            return {
+                ...actual,
+                SCAI_HOME: tempDir,
+                RUNTIME_LOG_PATH: path.join(tempDir, "runtime.log"),
+                RUNTIME_NDJSON_PATH: path.join(tempDir, "runtime.ndjson"),
+                RUN_LOG_PATH: path.join(tempDir, "runtime.log"),
+            };
+        });
+        vi.doMock("../../utils/log.js", () => ({
+            log: vi.fn(),
+        }));
+        const { clearRuntimeLogs, logRunStart, logRuntimeRecord } = await import("../../utils/runtimeLogger.js");
+        clearRuntimeLogs();
+        logRunStart("agent", "Explain the runtime logger.");
+        logRuntimeRecord({
+            runtime: "agent",
+            kind: "step",
+            phase: "started",
+            summary: "search-db",
+            taskId: "task-1",
+            stepId: "step-1",
+            payload: { query: "tests" },
+        });
+        const humanLog = fs.readFileSync(path.join(tempDir, "runtime.log"), "utf-8");
+        const ndjsonLog = fs.readFileSync(path.join(tempDir, "runtime.ndjson"), "utf-8");
+        expect(stripAnsi(humanLog)).toContain("== Simple Agent Run ==");
+        expect(stripAnsi(humanLog)).toContain("Query: Explain the runtime logger.");
+        expect(ndjsonLog).toContain("\"summary\":\"run started\"");
+        expect(ndjsonLog).toContain("\"boundary\":\"start\"");
+        expect(ndjsonLog).toContain("\"title\":\"Simple Agent Run\"");
+        expect(ndjsonLog).toContain("\"query\":\"Explain the runtime logger.\"");
+        expect(stripAnsi(humanLog)).toContain("[agent] [step:started step=step-1]");
+        expect(humanLog).toMatch(/\x1B\[[0-9;]*mstep:started step=step-1\x1B\[[0-9;]*m/);
+        expect(ndjsonLog).toContain("\"kind\":\"step\"");
+        expect(ndjsonLog).toContain("\"phase\":\"started\"");
+    });
+    it("groups step llm tool and user-message scan keys into colored runtime header tokens", async () => {
+        vi.doMock("../../constants.js", async (importOriginal) => {
+            const actual = await importOriginal();
+            return {
+                ...actual,
+                SCAI_HOME: tempDir,
+                RUNTIME_LOG_PATH: path.join(tempDir, "runtime.log"),
+                RUNTIME_NDJSON_PATH: path.join(tempDir, "runtime.ndjson"),
+                RUN_LOG_PATH: path.join(tempDir, "runtime.log"),
+            };
+        });
+        vi.doMock("../../utils/log.js", () => ({
+            log: vi.fn(),
+        }));
+        const { clearRuntimeLogs, logRuntimeRecord } = await import("../../utils/runtimeLogger.js");
+        clearRuntimeLogs();
+        logRuntimeRecord({
+            runtime: "agent",
+            kind: "llm",
+            phase: "output",
+            status: "ok",
+            sessionId: "session-001",
+            taskId: "task-001",
+            stepId: "step-003",
+            summary: "agent.action-choice",
+            payload: { label: "agent.action-choice" },
+        });
+        logRuntimeRecord({
+            runtime: "agent",
+            kind: "step",
+            phase: "created",
+            sessionId: "session-001",
+            taskId: "task-001",
+            stepId: "step-003",
+            summary: "step-created",
+            payload: {
+                payload: {
+                    action: "read-file",
+                },
+            },
+        });
+        logRuntimeRecord({
+            runtime: "agent",
+            kind: "tool",
+            phase: "started",
+            status: "active",
+            sessionId: "session-001",
+            taskId: "task-001",
+            stepId: "step-003",
+            summary: "tool-started",
+            payload: {
+                payload: {
+                    action: "read-file",
+                },
+            },
+        });
+        logRuntimeRecord({
+            runtime: "agent",
+            kind: "user-message",
+            phase: "shown",
+            status: "active",
+            summary: "[STATE] step step-003 pending -> running | action=read-file | 38ms",
+        });
+        const humanLog = fs.readFileSync(path.join(tempDir, "runtime.log"), "utf-8");
+        const ndjsonLog = fs.readFileSync(path.join(tempDir, "runtime.ndjson"), "utf-8");
+        expect(stripAnsi(humanLog)).toContain("[agent] [llm:output step=step-003 label=action-choice] status=ok session=session-001 task=task-001");
+        expect(stripAnsi(humanLog)).toContain("[agent] [step:created step=step-003 action=read-file] session=session-001 task=task-001");
+        expect(stripAnsi(humanLog)).toContain("[agent] [tool:started step=step-003 action=read-file] status=active session=session-001 task=task-001");
+        expect(stripAnsi(humanLog)).toContain("[agent] [user-message:shown step-003 pending -> running | action=read-file] status=active [STATE] 38ms");
+        expect(humanLog).toMatch(/\[\x1B\[[0-9;]*mllm:output step=step-003 label=action-choice\x1B\[[0-9;]*m\]/);
+        expect(humanLog).toMatch(/\[\x1B\[[0-9;]*mstep:created step=step-003 action=read-file\x1B\[[0-9;]*m\]/);
+        expect(humanLog).toMatch(/\[\x1B\[[0-9;]*mtool:started step=step-003 action=read-file\x1B\[[0-9;]*m\]/);
+        expect(humanLog).toMatch(/\[\x1B\[[0-9;]*muser-message:shown step-003 pending -> running \| action=read-file\x1B\[[0-9;]*m\]/);
+        expect(ndjsonLog).toContain("\"kind\":\"tool\"");
+        expect(ndjsonLog).toContain("\"summary\":\"tool-started\"");
+        expect(ndjsonLog).toContain("\"stepId\":\"step-003\"");
+    });
+    it("renders runtime.log and runtime.ndjson timestamps in local machine time", async () => {
+        process.env.TZ = "Europe/Copenhagen";
+        vi.doMock("../../constants.js", async (importOriginal) => {
+            const actual = await importOriginal();
+            return {
+                ...actual,
+                SCAI_HOME: tempDir,
+                RUNTIME_LOG_PATH: path.join(tempDir, "runtime.log"),
+                RUNTIME_NDJSON_PATH: path.join(tempDir, "runtime.ndjson"),
+                RUN_LOG_PATH: path.join(tempDir, "runtime.log"),
+            };
+        });
+        vi.doMock("../../utils/log.js", () => ({
+            log: vi.fn(),
+        }));
+        const { clearRuntimeLogs, logRuntimeRecord } = await import("../../utils/runtimeLogger.js");
+        clearRuntimeLogs();
+        logRuntimeRecord({
+            at: "2026-05-01T10:15:00.000Z",
+            runtime: "agent",
+            kind: "step",
+            phase: "started",
+            summary: "search-db",
+        });
+        const humanLog = fs.readFileSync(path.join(tempDir, "runtime.log"), "utf-8");
+        const ndjsonLog = fs.readFileSync(path.join(tempDir, "runtime.ndjson"), "utf-8");
+        expect(stripAnsi(humanLog)).toContain("[2026-05-01 12:15:00 +02:00]");
+        expect(ndjsonLog).toContain("\"at\":\"2026-05-01T12:15:00.000+02:00\"");
+    });
+    it("keeps the legacy input/output shim writing to the new runtime logs", async () => {
+        vi.doMock("../../constants.js", async (importOriginal) => {
+            const actual = await importOriginal();
+            return {
+                ...actual,
+                SCAI_HOME: tempDir,
+                PROMPT_LOG_PATH: path.join(tempDir, "prompt.log"),
+                RUNTIME_LOG_PATH: path.join(tempDir, "runtime.log"),
+                RUNTIME_NDJSON_PATH: path.join(tempDir, "runtime.ndjson"),
+                RUN_LOG_PATH: path.join(tempDir, "runtime.log"),
+            };
+        });
+        vi.doMock("../../utils/log.js", () => ({
+            log: vi.fn(),
+        }));
+        const { clearRunLog, logInputOutput } = await import("../../utils/promptLogHelper.js");
+        clearRunLog();
+        logInputOutput("agentEvent", "output", { ok: true });
+        const humanLog = fs.readFileSync(path.join(tempDir, "runtime.log"), "utf-8");
+        const ndjsonLog = fs.readFileSync(path.join(tempDir, "runtime.ndjson"), "utf-8");
+        expect(stripAnsi(humanLog)).toContain("[shared] [legacy:output]");
+        expect(stripAnsi(humanLog)).toContain("agentEvent output");
+        expect(humanLog).not.toContain("OUTPUT | agentEvent");
+        expect(ndjsonLog).toContain("\"kind\":\"legacy\"");
+        expect(ndjsonLog).toContain("\"stepName\":\"agentEvent\"");
+    });
+});
+//# sourceMappingURL=runtimeLogger.test.js.map

package/dist/__tests__/utils/runtimeLogger.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeLogger.test.js","sourceRoot":"","sources":["../../../src/__tests__/utils/runtimeLogger.test.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Covers the shared Stage 1 runtime log writer and legacy log shim.\n *\n * Why this file exists:\n * - `runtime.log` and `runtime.ndjson` should be written together\n * - old `logInputOutput(...)` callers should still append useful records during migration\n * - the log file rename should stay stable for eval and integration flows\n */\nimport fs from \"fs\";\nimport os from \"os\";\nimport path from \"path\";\nimport { afterEach, beforeEach, describe, expect, it, vi } from \"vitest\";\n\nfunction stripAnsi(text: string): string {\n  return text.replace(/\\x1B\\[[0-9;]*m/g, \"\");\n}\n\ndescribe(\"runtimeLogger\", () => {\n  let tempDir: string;\n  let originalTz: string | undefined;\n\n  beforeEach(() => {\n    tempDir = fs.mkdtempSync(path.join(os.tmpdir(), \"scai-runtime-log-\"));\n    originalTz = process.env.TZ;\n    vi.resetModules();\n  });\n\n  afterEach(() => {\n    process.env.TZ = originalTz;\n    fs.rmSync(tempDir, { recursive: true, force: true });\n  });\n\n  it(\"writes both runtime.log and runtime.ndjson\", async () => {\n    vi.doMock(\"../../constants.js\", async (importOriginal) => {\n      const actual = await importOriginal<typeof import(\"../../constants.js\")>();\n      return {\n        ...actual,\n        SCAI_HOME: tempDir,\n        RUNTIME_LOG_PATH: path.join(tempDir, \"runtime.log\"),\n        RUNTIME_NDJSON_PATH: path.join(tempDir, \"runtime.ndjson\"),\n        RUN_LOG_PATH: path.join(tempDir, \"runtime.log\"),\n      };\n    });\n    vi.doMock(\"../../utils/log.js\", () => ({\n      log: vi.fn(),\n    }));\n\n    const { clearRuntimeLogs, logRunStart, logRuntimeRecord } = await import(\"../../utils/runtimeLogger.js\");\n    clearRuntimeLogs();\n    logRunStart(\"agent\", \"Explain the runtime logger.\");\n    logRuntimeRecord({\n      runtime: \"agent\",\n      kind: \"step\",\n      phase: \"started\",\n      summary: \"search-db\",\n      taskId: \"task-1\",\n      stepId: \"step-1\",\n      payload: { query: \"tests\" },\n    });\n\n    const humanLog = fs.readFileSync(path.join(tempDir, \"runtime.log\"), \"utf-8\");\n    const ndjsonLog = fs.readFileSync(path.join(tempDir, \"runtime.ndjson\"), \"utf-8\");\n\n    expect(stripAnsi(humanLog)).toContain(\"== Simple Agent Run ==\");\n    expect(stripAnsi(humanLog)).toContain(\"Query: Explain the runtime logger.\");\n    expect(ndjsonLog).toContain(\"\\\"summary\\\":\\\"run started\\\"\");\n    expect(ndjsonLog).toContain(\"\\\"boundary\\\":\\\"start\\\"\");\n    expect(ndjsonLog).toContain(\"\\\"title\\\":\\\"Simple Agent Run\\\"\");\n    expect(ndjsonLog).toContain(\"\\\"query\\\":\\\"Explain the runtime logger.\\\"\");\n    expect(stripAnsi(humanLog)).toContain(\"[agent] [step:started step=step-1]\");\n    expect(humanLog).toMatch(/\\x1B\\[[0-9;]*mstep:started step=step-1\\x1B\\[[0-9;]*m/);\n    expect(ndjsonLog).toContain(\"\\\"kind\\\":\\\"step\\\"\");\n    expect(ndjsonLog).toContain(\"\\\"phase\\\":\\\"started\\\"\");\n  });\n\n  it(\"groups step llm tool and user-message scan keys into colored runtime header tokens\", async () => {\n    vi.doMock(\"../../constants.js\", async (importOriginal) => {\n      const actual = await importOriginal<typeof import(\"../../constants.js\")>();\n      return {\n        ...actual,\n        SCAI_HOME: tempDir,\n        RUNTIME_LOG_PATH: path.join(tempDir, \"runtime.log\"),\n        RUNTIME_NDJSON_PATH: path.join(tempDir, \"runtime.ndjson\"),\n        RUN_LOG_PATH: path.join(tempDir, \"runtime.log\"),\n      };\n    });\n    vi.doMock(\"../../utils/log.js\", () => ({\n      log: vi.fn(),\n    }));\n\n    const { clearRuntimeLogs, logRuntimeRecord } = await import(\"../../utils/runtimeLogger.js\");\n    clearRuntimeLogs();\n    logRuntimeRecord({\n      runtime: \"agent\",\n      kind: \"llm\",\n      phase: \"output\",\n      status: \"ok\",\n      sessionId: \"session-001\",\n      taskId: \"task-001\",\n      stepId: \"step-003\",\n      summary: \"agent.action-choice\",\n      payload: { label: \"agent.action-choice\" },\n    });\n    logRuntimeRecord({\n      runtime: \"agent\",\n      kind: \"step\",\n      phase: \"created\",\n      sessionId: \"session-001\",\n      taskId: \"task-001\",\n      stepId: \"step-003\",\n      summary: \"step-created\",\n      payload: {\n        payload: {\n          action: \"read-file\",\n        },\n      },\n    });\n    logRuntimeRecord({\n      runtime: \"agent\",\n      kind: \"tool\",\n      phase: \"started\",\n      status: \"active\",\n      sessionId: \"session-001\",\n      taskId: \"task-001\",\n      stepId: \"step-003\",\n      summary: \"tool-started\",\n      payload: {\n        payload: {\n          action: \"read-file\",\n        },\n      },\n    });\n    logRuntimeRecord({\n      runtime: \"agent\",\n      kind: \"user-message\",\n      phase: \"shown\",\n      status: \"active\",\n      summary: \"[STATE] step step-003 pending -> running | action=read-file | 38ms\",\n    });\n\n    const humanLog = fs.readFileSync(path.join(tempDir, \"runtime.log\"), \"utf-8\");\n    const ndjsonLog = fs.readFileSync(path.join(tempDir, \"runtime.ndjson\"), \"utf-8\");\n\n    expect(stripAnsi(humanLog)).toContain(\n      \"[agent] [llm:output step=step-003 label=action-choice] status=ok session=session-001 task=task-001\"\n    );\n    expect(stripAnsi(humanLog)).toContain(\n      \"[agent] [step:created step=step-003 action=read-file] session=session-001 task=task-001\"\n    );\n    expect(stripAnsi(humanLog)).toContain(\n      \"[agent] [tool:started step=step-003 action=read-file] status=active session=session-001 task=task-001\"\n    );\n    expect(stripAnsi(humanLog)).toContain(\n      \"[agent] [user-message:shown step-003 pending -> running | action=read-file] status=active [STATE] 38ms\"\n    );\n    expect(humanLog).toMatch(\n      /\\[\\x1B\\[[0-9;]*mllm:output step=step-003 label=action-choice\\x1B\\[[0-9;]*m\\]/\n    );\n    expect(humanLog).toMatch(\n      /\\[\\x1B\\[[0-9;]*mstep:created step=step-003 action=read-file\\x1B\\[[0-9;]*m\\]/\n    );\n    expect(humanLog).toMatch(\n      /\\[\\x1B\\[[0-9;]*mtool:started step=step-003 action=read-file\\x1B\\[[0-9;]*m\\]/\n    );\n    expect(humanLog).toMatch(\n      /\\[\\x1B\\[[0-9;]*muser-message:shown step-003 pending -> running \\| action=read-file\\x1B\\[[0-9;]*m\\]/\n    );\n    expect(ndjsonLog).toContain(\"\\\"kind\\\":\\\"tool\\\"\");\n    expect(ndjsonLog).toContain(\"\\\"summary\\\":\\\"tool-started\\\"\");\n    expect(ndjsonLog).toContain(\"\\\"stepId\\\":\\\"step-003\\\"\");\n  });\n\n  it(\"renders runtime.log and runtime.ndjson timestamps in local machine time\", async () => {\n    process.env.TZ = \"Europe/Copenhagen\";\n    vi.doMock(\"../../constants.js\", async (importOriginal) => {\n      const actual = await importOriginal<typeof import(\"../../constants.js\")>();\n      return {\n        ...actual,\n        SCAI_HOME: tempDir,\n        RUNTIME_LOG_PATH: path.join(tempDir, \"runtime.log\"),\n        RUNTIME_NDJSON_PATH: path.join(tempDir, \"runtime.ndjson\"),\n        RUN_LOG_PATH: path.join(tempDir, \"runtime.log\"),\n      };\n    });\n    vi.doMock(\"../../utils/log.js\", () => ({\n      log: vi.fn(),\n    }));\n\n    const { clearRuntimeLogs, logRuntimeRecord } = await import(\"../../utils/runtimeLogger.js\");\n    clearRuntimeLogs();\n    logRuntimeRecord({\n      at: \"2026-05-01T10:15:00.000Z\",\n      runtime: \"agent\",\n      kind: \"step\",\n      phase: \"started\",\n      summary: \"search-db\",\n    });\n\n    const humanLog = fs.readFileSync(path.join(tempDir, \"runtime.log\"), \"utf-8\");\n    const ndjsonLog = fs.readFileSync(path.join(tempDir, \"runtime.ndjson\"), \"utf-8\");\n\n    expect(stripAnsi(humanLog)).toContain(\"[2026-05-01 12:15:00 +02:00]\");\n    expect(ndjsonLog).toContain(\"\\\"at\\\":\\\"2026-05-01T12:15:00.000+02:00\\\"\");\n  });\n\n  it(\"keeps the legacy input/output shim writing to the new runtime logs\", async () => {\n    vi.doMock(\"../../constants.js\", async (importOriginal) => {\n      const actual = await importOriginal<typeof import(\"../../constants.js\")>();\n      return {\n        ...actual,\n        SCAI_HOME: tempDir,\n        PROMPT_LOG_PATH: path.join(tempDir, \"prompt.log\"),\n        RUNTIME_LOG_PATH: path.join(tempDir, \"runtime.log\"),\n        RUNTIME_NDJSON_PATH: path.join(tempDir, \"runtime.ndjson\"),\n        RUN_LOG_PATH: path.join(tempDir, \"runtime.log\"),\n      };\n    });\n    vi.doMock(\"../../utils/log.js\", () => ({\n      log: vi.fn(),\n    }));\n\n    const { clearRunLog, logInputOutput } = await import(\"../../utils/promptLogHelper.js\");\n    clearRunLog();\n    logInputOutput(\"agentEvent\", \"output\", { ok: true });\n\n    const humanLog = fs.readFileSync(path.join(tempDir, \"runtime.log\"), \"utf-8\");\n    const ndjsonLog = fs.readFileSync(path.join(tempDir, \"runtime.ndjson\"), \"utf-8\");\n\n    expect(stripAnsi(humanLog)).toContain(\"[shared] [legacy:output]\");\n    expect(stripAnsi(humanLog)).toContain(\"agentEvent output\");\n    expect(humanLog).not.toContain(\"OUTPUT | agentEvent\");\n    expect(ndjsonLog).toContain(\"\\\"kind\\\":\\\"legacy\\\"\");\n    expect(ndjsonLog).toContain(\"\\\"stepName\\\":\\\"agentEvent\\\"\");\n  });\n});\n"]}

package/dist/__tests__/utils/spinner.test.js

@@ -0,0 +1,31 @@
+// Verifies spinner redraws clear the terminal row before writing new status text.
+// This keeps shorter updates from leaving stale tails behind in user-facing progress output.
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { Spinner } from "../../lib/spinner.js";
+describe("Spinner", () => {
+    const writes = [];
+    beforeEach(() => {
+        writes.length = 0;
+        vi.useFakeTimers();
+        vi.spyOn(process.stdout, "write").mockImplementation(((chunk) => {
+            writes.push(typeof chunk === "string" ? chunk : chunk.toString());
+            return true;
+        }));
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+        vi.useRealTimers();
+    });
+    it("clears the line before each redraw so shorter updates do not leak stale text", () => {
+        const spinner = new Spinner("Running long-module-name.ts");
+        spinner.start();
+        spinner.update("Running a.ts");
+        vi.advanceTimersByTime(80);
+        spinner.stop();
+        expect(writes).toContain("\r\x1b[K");
+        expect(writes).toContain("⠙ Running a.ts");
+        const clearCount = writes.filter(entry => entry === "\r\x1b[K").length;
+        expect(clearCount).toBeGreaterThanOrEqual(3);
+    });
+});
+//# sourceMappingURL=spinner.test.js.map

package/dist/__tests__/utils/spinner.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.test.js","sourceRoot":"","sources":["../../../src/__tests__/utils/spinner.test.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,6FAA6F;AAC7F,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACzE,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAE/C,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE;IACrB,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,UAAU,CAAC,GAAG,EAAE;QACZ,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;QAClB,EAAE,CAAC,aAAa,EAAE,CAAC;QACnB,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,KAA0B,EAAE,EAAE;YAC7E,MAAM,CAAC,IAAI,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;YAClE,OAAO,IAAI,CAAC;QAChB,CAAC,CAAgC,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACX,EAAE,CAAC,eAAe,EAAE,CAAC;QACrB,EAAE,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8EAA8E,EAAE,GAAG,EAAE;QACpF,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,6BAA6B,CAAC,CAAC;QAE3D,OAAO,CAAC,KAAK,EAAE,CAAC;QAChB,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;QAC/B,EAAE,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC;QAC3B,OAAO,CAAC,IAAI,EAAE,CAAC;QAEf,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QACrC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;QAE3C,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC,MAAM,CAAC;QACvE,MAAM,CAAC,UAAU,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC","sourcesContent":["// Verifies spinner redraws clear the terminal row before writing new status text.\n// This keeps shorter updates from leaving stale tails behind in user-facing progress output.\nimport { afterEach, beforeEach, describe, expect, it, vi } from \"vitest\";\nimport { Spinner } from \"../../lib/spinner.js\";\n\ndescribe(\"Spinner\", () => {\n    const writes: string[] = [];\n\n    beforeEach(() => {\n        writes.length = 0;\n        vi.useFakeTimers();\n        vi.spyOn(process.stdout, \"write\").mockImplementation(((chunk: string | Uint8Array) => {\n                writes.push(typeof chunk === \"string\" ? chunk : chunk.toString());\n                return true;\n            }) as typeof process.stdout.write);\n    });\n\n    afterEach(() => {\n        vi.restoreAllMocks();\n        vi.useRealTimers();\n    });\n\n    it(\"clears the line before each redraw so shorter updates do not leak stale text\", () => {\n        const spinner = new Spinner(\"Running long-module-name.ts\");\n\n        spinner.start();\n        spinner.update(\"Running a.ts\");\n        vi.advanceTimersByTime(80);\n        spinner.stop();\n\n        expect(writes).toContain(\"\\r\\x1b[K\");\n        expect(writes).toContain(\"⠙ Running a.ts\");\n\n        const clearCount = writes.filter(entry => entry === \"\\r\\x1b[K\").length;\n        expect(clearCount).toBeGreaterThanOrEqual(3);\n    });\n});\n"]}

package/dist/__tests__/utils/verifyFocusPreference.test.js

@@ -0,0 +1,41 @@
+// Verifies the shared verify-focus preference stays consistent across retrieval, verify focus, and final grounding.
+// It locks the intended preference policy so later loop tuning does not drift across call sites.
+import { describe, expect, it } from "vitest";
+import { getVerifyFocusFilePreference, isVerifyFocusQueryText } from "../../utils/verifyFocusPreference.js";
+describe("verifyFocusPreference", () => {
+    it("detects real verify-flow queries but ignores generic trace queries", () => {
+        expect(isVerifyFocusQueryText("Trace how selectedFiles and candidateFiles evolve across verify waves.")).toBe(true);
+        expect(isVerifyFocusQueryText("Trace how SQLite queries flow through db/client.ts.")).toBe(false);
+    });
+    it("prefers verify pipeline files over broad docs", () => {
+        const query = "Trace how selectedFiles and candidateFiles evolve across verify waves for this query.";
+        const verifyFile = getVerifyFocusFilePreference({
+            query,
+            filePath: "/repo/cli/src/agents/mainAgentVerify.ts",
+            evidenceText: "selectedFiles and candidateFiles evolve during verify waves",
+        });
+        const readmeFile = getVerifyFocusFilePreference({
+            query,
+            filePath: "/repo/README.md",
+            contentText: "verify selectedFiles candidateFiles",
+        });
+        expect(verifyFile.applies).toBe(true);
+        expect(verifyFile.score).toBeGreaterThan(readmeFile.score);
+    });
+    it("prefers mainAgentVerify and grounding-budget signals over generic analysis planning files", () => {
+        const query = "For repo-wide analysis questions, which method decides verify wave budget and why?";
+        const verifyFile = getVerifyFocusFilePreference({
+            query,
+            filePath: "/repo/cli/src/agents/mainAgentVerify.ts",
+            contentText: "function getGroundingWaveBudget() { const maxWaves = 4; }",
+        });
+        const analysisPlanFile = getVerifyFocusFilePreference({
+            query,
+            filePath: "/repo/cli/src/agents/analysisPlanGenStep.ts",
+            contentText: "analysis planning and action normalization",
+        });
+        expect(verifyFile.applies).toBe(true);
+        expect(verifyFile.score).toBeGreaterThan(analysisPlanFile.score);
+    });
+});
+//# sourceMappingURL=verifyFocusPreference.test.js.map

package/dist/__tests__/utils/verifyFocusPreference.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verifyFocusPreference.test.js","sourceRoot":"","sources":["../../../src/__tests__/utils/verifyFocusPreference.test.ts"],"names":[],"mappings":"AAAA,oHAAoH;AACpH,iGAAiG;AACjG,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,4BAA4B,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAE5G,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,oEAAoE,EAAE,GAAG,EAAE;QAC1E,MAAM,CAAC,sBAAsB,CAAC,wEAAwE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpH,MAAM,CAAC,sBAAsB,CAAC,qDAAqD,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACrD,MAAM,KAAK,GAAG,uFAAuF,CAAC;QAEtG,MAAM,UAAU,GAAG,4BAA4B,CAAC;YAC5C,KAAK;YACL,QAAQ,EAAE,yCAAyC;YACnD,YAAY,EAAE,6DAA6D;SAC9E,CAAC,CAAC;QACH,MAAM,UAAU,GAAG,4BAA4B,CAAC;YAC5C,KAAK;YACL,QAAQ,EAAE,iBAAiB;YAC3B,WAAW,EAAE,qCAAqC;SACrD,CAAC,CAAC;QAEH,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,eAAe,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2FAA2F,EAAE,GAAG,EAAE;QACjG,MAAM,KAAK,GAAG,oFAAoF,CAAC;QAEnG,MAAM,UAAU,GAAG,4BAA4B,CAAC;YAC5C,KAAK;YACL,QAAQ,EAAE,yCAAyC;YACnD,WAAW,EAAE,2DAA2D;SAC3E,CAAC,CAAC;QACH,MAAM,gBAAgB,GAAG,4BAA4B,CAAC;YAClD,KAAK;YACL,QAAQ,EAAE,6CAA6C;YACvD,WAAW,EAAE,4CAA4C;SAC5D,CAAC,CAAC;QAEH,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,eAAe,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC","sourcesContent":["// Verifies the shared verify-focus preference stays consistent across retrieval, verify focus, and final grounding.\n// It locks the intended preference policy so later loop tuning does not drift across call sites.\nimport { describe, expect, it } from \"vitest\";\nimport { getVerifyFocusFilePreference, isVerifyFocusQueryText } from \"../../utils/verifyFocusPreference.js\";\n\ndescribe(\"verifyFocusPreference\", () => {\n    it(\"detects real verify-flow queries but ignores generic trace queries\", () => {\n        expect(isVerifyFocusQueryText(\"Trace how selectedFiles and candidateFiles evolve across verify waves.\")).toBe(true);\n        expect(isVerifyFocusQueryText(\"Trace how SQLite queries flow through db/client.ts.\")).toBe(false);\n    });\n\n    it(\"prefers verify pipeline files over broad docs\", () => {\n        const query = \"Trace how selectedFiles and candidateFiles evolve across verify waves for this query.\";\n\n        const verifyFile = getVerifyFocusFilePreference({\n            query,\n            filePath: \"/repo/cli/src/agents/mainAgentVerify.ts\",\n            evidenceText: \"selectedFiles and candidateFiles evolve during verify waves\",\n        });\n        const readmeFile = getVerifyFocusFilePreference({\n            query,\n            filePath: \"/repo/README.md\",\n            contentText: \"verify selectedFiles candidateFiles\",\n        });\n\n        expect(verifyFile.applies).toBe(true);\n        expect(verifyFile.score).toBeGreaterThan(readmeFile.score);\n    });\n\n    it(\"prefers mainAgentVerify and grounding-budget signals over generic analysis planning files\", () => {\n        const query = \"For repo-wide analysis questions, which method decides verify wave budget and why?\";\n\n        const verifyFile = getVerifyFocusFilePreference({\n            query,\n            filePath: \"/repo/cli/src/agents/mainAgentVerify.ts\",\n            contentText: \"function getGroundingWaveBudget() { const maxWaves = 4; }\",\n        });\n        const analysisPlanFile = getVerifyFocusFilePreference({\n            query,\n            filePath: \"/repo/cli/src/agents/analysisPlanGenStep.ts\",\n            contentText: \"analysis planning and action normalization\",\n        });\n\n        expect(verifyFile.applies).toBe(true);\n        expect(verifyFile.score).toBeGreaterThan(analysisPlanFile.score);\n    });\n});\n"]}

package/dist/agent/actions/index.js

@@ -0,0 +1,301 @@
+import { generate } from "../../lib/generate.js";
+import { emitAgentLlmTimingMessage } from "../../utils/consolePresentation.js";
+import { nowLocalIso } from "../../utils/time.js";
+import { getErrorMessage, getErrorTrace, logAgentLlmFailure, logAgentLlmInput, logAgentLlmOutput, logAgentToolFailure, logAgentToolInput, logAgentToolOutput, recordAgentArtifact, } from "../logging/index.js";
+import { buildFinalAnswerPacket, buildPlanPacket, renderFinalAnswerPrompt, renderPlanPrompt } from "../prompting/index.js";
+import { createDurableCheckpointFromArtifacts, renderResumeCheckpointForPrompt } from "../resume/checkpoint.js";
+import { buildRequestUserInputMessage, prepareAgentWaitingState } from "../feedback/index.js";
+import { resolvePolicyState } from "../policy/index.js";
+import { formatTransformCompletionMilestone, formatTransformFailureMilestone, formatTransformLoopProgress, formatTransformRetryMilestone, formatTransformStartMilestone, formatTransformWarningMilestone, } from "../runtime/progress.js";
+import { sanitizePlan } from "./normalize.js";
+export { buildActionMenu, sanitizeDecision, sanitizePlan } from "./normalize.js";
+import { CODE_TRANSFORM_SCHEMA, EMPTY_OBJECT_SCHEMA, LIST_DIRECTORY_SCHEMA, READ_FILE_SCHEMA, SEARCH_DB_SCHEMA, SEARCH_REGEX_SCHEMA, TRIAGE_FILE_SCHEMA, } from "./schemas.js";
+import { createRuntimeStep } from "../state/index.js";
+import { runCodeTransform } from "../transform/index.js";
+import { parseStructuredJson } from "../structuredOutput/index.js";
+import { AgentRuntimeError } from "../types.js";
+function pluralize(count, noun) {
+    return `${count} ${noun}${count === 1 ? "" : "s"}`;
+}
+function buildAttemptLines(memory) {
+    const completedSteps = memory.steps.filter((step) => step.status === "done" || step.status === "failed" || step.status === "blocked");
+    const actionCounts = new Map();
+    for (const step of completedSteps) {
+        if (step.action === "final-answer" || step.action === "cannot-answer" || step.action === "request-user-input") {
+            continue;
+        }
+        actionCounts.set(step.action, (actionCounts.get(step.action) ?? 0) + 1);
+    }
+    const actionLines = Array.from(actionCounts.entries()).map(([action, count]) => {
+        switch (action) {
+            case "plan":
+                return `- replanned ${pluralize(count, "time")}`;
+            case "search-db":
+                return `- searched indexed files ${pluralize(count, "time")}`;
+            case "search-regex":
+                return `- ran regex search ${pluralize(count, "time")}`;
+            case "search-list-directory":
+                return `- listed directories ${pluralize(count, "time")}`;
+            case "triage-file":
+                return `- triaged files ${pluralize(count, "time")}`;
+            case "read-file":
+                return `- read files ${pluralize(count, "time")}`;
+            case "codeTransform":
+                return `- transformed files ${pluralize(count, "time")}`;
+            default:
+                return null;
+        }
+    }).filter((line) => !!line);
+    return [
+        ...actionLines,
+        `- searched ${pluralize(memory.evidence.searches.length, "time")}`,
+        `- read ${pluralize(Object.keys(memory.evidence.fileReads).length, "file")}`,
+    ];
+}
+function buildCannotAnswerMessage(memory) {
+    const reason = memory.task.stopReason === "max-turns"
+        ? "no grounded answer before the turn budget ended"
+        : "the gathered evidence was still too weak to answer reliably";
+    return [
+        "I could not answer from grounded repo evidence.",
+        "I tried:",
+        ...buildAttemptLines(memory),
+        "",
+        "Why I stopped:",
+        `- ${reason}`,
+    ].join("\n");
+}
+function toolBackedAction(name, tool, schema) {
+    return {
+        name,
+        kind: "tool",
+        description: tool.description ?? name,
+        inputSchema: schema,
+        outputSchema: tool.outputSchema,
+        async run(memory, args) {
+            const stepId = memory.task.currentStepId ?? "unknown-step";
+            logAgentToolInput(memory, stepId, name, args);
+            try {
+                const output = await tool.invoke(args, memory);
+                logAgentToolOutput(memory, stepId, name, output);
+                return {
+                    ok: true,
+                    summary: `Ran ${name}.`,
+                    output,
+                };
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                logAgentToolFailure(memory, {
+                    stage: "tool",
+                    message,
+                    action: name,
+                    stepId,
+                }, {
+                    args,
+                });
+                return {
+                    ok: false,
+                    summary: message,
+                };
+            }
+        },
+    };
+}
+export function buildActions(tools, ui) {
+    return {
+        plan: {
+            name: "plan",
+            kind: "control",
+            description: "Create or revise a small ordered step list.",
+            inputSchema: EMPTY_OBJECT_SCHEMA,
+            async run(memory) {
+                const packet = buildPlanPacket(memory, resolvePolicyState(memory).allowedActions);
+                const prompt = renderPlanPrompt(packet);
+                const stepId = memory.task.currentStepId;
+                logAgentLlmInput(memory, "agent.plan", packet, stepId, nowLocalIso());
+                try {
+                    const response = await generate({ query: memory.task.initialQuery, content: prompt }, {
+                        caller: "agent.plan",
+                        inputContext: packet,
+                    });
+                    const parsed = parseStructuredJson(String(response?.data ?? ""), { fallback: {
+                            goal: memory.task.primaryIntent,
+                            why: "Gather the smallest grounded evidence needed to answer.",
+                            steps: [],
+                        } });
+                    const plan = sanitizePlan(memory, parsed);
+                    logAgentLlmOutput(memory, "agent.plan", {
+                        parsed: plan,
+                    }, stepId, response?.trace);
+                    emitAgentLlmTimingMessage(ui, "agent.plan", response?.trace);
+                    memory.artifacts.plans.push(plan);
+                    recordAgentArtifact(memory.artifacts, "plan", plan);
+                    for (const plannedStep of plan.steps) {
+                        createRuntimeStep(memory, plannedStep.action, plannedStep.purpose, plannedStep.args, plannedStep.expectedEvidence);
+                    }
+                    memory.task.replanCount += 1;
+                    return {
+                        ok: true,
+                        summary: `Planned ${plan.steps.length} step(s).`,
+                        output: plan,
+                    };
+                }
+                catch (error) {
+                    const details = {
+                        stage: "plan",
+                        message: getErrorMessage(error),
+                        action: "plan",
+                        stepId,
+                    };
+                    logAgentLlmFailure(memory, "agent.plan", details, getErrorTrace(error));
+                    throw new AgentRuntimeError(details, error);
+                }
+            },
+        },
+        "search-db": toolBackedAction("search-db", tools["search-db"], SEARCH_DB_SCHEMA),
+        "search-regex": toolBackedAction("search-regex", tools["search-regex"], SEARCH_REGEX_SCHEMA),
+        "search-list-directory": toolBackedAction("search-list-directory", tools["search-list-directory"], LIST_DIRECTORY_SCHEMA),
+        "triage-file": toolBackedAction("triage-file", tools["triage-file"], TRIAGE_FILE_SCHEMA),
+        "read-file": toolBackedAction("read-file", tools["read-file"], READ_FILE_SCHEMA),
+        codeTransform: {
+            name: "codeTransform",
+            kind: "control",
+            description: "Plan, apply, validate, and retry one file transform inside the new transform owner.",
+            inputSchema: CODE_TRANSFORM_SCHEMA,
+            async run(memory, args) {
+                const target = typeof args.target === "string" ? args.target.trim() : "";
+                if (!target) {
+                    return {
+                        ok: false,
+                        summary: "codeTransform requires one target file.",
+                    };
+                }
+                try {
+                    const result = await runCodeTransform(memory, target, {
+                        onProgress(progress) {
+                            switch (progress.stage) {
+                                case "started":
+                                    ui.message(formatTransformStartMilestone(progress.filePath));
+                                    if (progress.warning) {
+                                        ui.message(formatTransformWarningMilestone(progress.warning));
+                                    }
+                                    break;
+                                case "retrying":
+                                    ui.message(formatTransformRetryMilestone(progress));
+                                    ui.update(formatTransformLoopProgress(progress));
+                                    break;
+                                case "failed":
+                                    ui.message(formatTransformFailureMilestone(progress));
+                                    break;
+                                case "completed":
+                                    ui.message(formatTransformCompletionMilestone(progress));
+                                    break;
+                                default:
+                                    ui.update(formatTransformLoopProgress(progress));
+                                    break;
+                            }
+                        },
+                    });
+                    const editCount = result.plan.edits.length;
+                    const finalMessage = `Updated ${result.filePath} with ${editCount} planned edit${editCount === 1 ? "" : "s"}.`;
+                    memory.artifacts.finalAnswer = finalMessage;
+                    recordAgentArtifact(memory.artifacts, "final-answer", finalMessage);
+                    return {
+                        ok: true,
+                        summary: finalMessage,
+                        output: result,
+                    };
+                }
+                catch (error) {
+                    return {
+                        ok: false,
+                        summary: error instanceof Error ? error.message : String(error),
+                    };
+                }
+            },
+        },
+        "cannot-answer": {
+            name: "cannot-answer",
+            kind: "control",
+            description: "Report that the agent could not answer from grounded evidence.",
+            inputSchema: EMPTY_OBJECT_SCHEMA,
+            async run(memory) {
+                const message = buildCannotAnswerMessage(memory);
+                memory.artifacts.stopMessage = message;
+                recordAgentArtifact(memory.artifacts, "cannot-answer", message);
+                return {
+                    ok: true,
+                    summary: "Reported that the agent could not answer.",
+                    output: message,
+                };
+            },
+        },
+        "request-user-input": {
+            name: "request-user-input",
+            kind: "control",
+            description: "Ask the user for one missing concrete input before continuing.",
+            inputSchema: EMPTY_OBJECT_SCHEMA,
+            async run(memory) {
+                const dialog = prepareAgentWaitingState(memory);
+                const message = buildRequestUserInputMessage(memory, dialog);
+                memory.artifacts.stopMessage = message;
+                recordAgentArtifact(memory.artifacts, "request-user-input", message);
+                return {
+                    ok: true,
+                    summary: "Requested one focused user input.",
+                    output: message,
+                };
+            },
+        },
+        "final-answer": {
+            name: "final-answer",
+            kind: "control",
+            description: "Produce the final grounded answer from collected evidence.",
+            inputSchema: EMPTY_OBJECT_SCHEMA,
+            async run(memory) {
+                const packet = buildFinalAnswerPacket(memory);
+                const latestGroundedResult = renderResumeCheckpointForPrompt(memory.resumeCheckpoint);
+                memory.artifacts.latestFinalAnswerPacket = packet;
+                const stepId = memory.task.currentStepId;
+                logAgentLlmInput(memory, "agent.final-answer", {
+                    ...packet,
+                    latestGroundedResult,
+                }, stepId, nowLocalIso());
+                try {
+                    const response = await generate({ query: memory.task.initialQuery, content: renderFinalAnswerPrompt(packet, latestGroundedResult) }, {
+                        caller: "agent.final-answer",
+                        inputContext: {
+                            ...packet,
+                            latestGroundedResult,
+                        },
+                    });
+                    const answer = String(response?.data ?? "").trim();
+                    logAgentLlmOutput(memory, "agent.final-answer", {
+                        answer,
+                    }, stepId, response?.trace);
+                    emitAgentLlmTimingMessage(ui, "agent.final-answer", response?.trace);
+                    memory.artifacts.finalAnswer = answer;
+                    memory.durableCheckpoint = createDurableCheckpointFromArtifacts(memory);
+                    recordAgentArtifact(memory.artifacts, "final-answer", answer);
+                    return {
+                        ok: answer.length > 0,
+                        summary: "Produced the final answer.",
+                        output: answer,
+                    };
+                }
+                catch (error) {
+                    const details = {
+                        stage: "final-answer",
+                        message: getErrorMessage(error),
+                        action: "final-answer",
+                        stepId,
+                    };
+                    logAgentLlmFailure(memory, "agent.final-answer", details, getErrorTrace(error));
+                    throw new AgentRuntimeError(details, error);
+                }
+            },
+        },
+    };
+}
+//# sourceMappingURL=index.js.map