scai 0.1.178 → 1.0.0

package/dist/__tests__/agents/agentReadPersistence.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentReadPersistence.test.js","sourceRoot":"","sources":["../../../src/__tests__/agents/agentReadPersistence.test.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Covers DB-backed full-read reuse for the modular agent.\n *\n * Why this file exists:\n * - Phase 1 persistence should stay limited to full reads only\n * - full reads should be reusable across later queries when file bytes do not change\n * - changed files should invalidate cached reads by content hash and force a new full read\n */\nimport fs from \"fs\";\nimport os from \"os\";\nimport path from \"path\";\nimport { afterEach, beforeEach, describe, expect, it, vi } from \"vitest\";\n\nconst ORIGINAL_ENV = { ...process.env };\nconst generateMock = vi.fn();\n\nvi.mock(\"../../lib/generate.js\", () => ({\n  generate: generateMock,\n}));\n\nfunction createTempHome(): string {\n  const homeDir = fs.mkdtempSync(path.join(os.tmpdir(), \"scai-agent-read-persist-home-\"));\n  process.env.HOME = homeDir;\n  process.env.USERPROFILE = homeDir;\n  return homeDir;\n}\n\nasync function bootstrapRepo(repoRoot: string) {\n  const { writeConfig } = await import(\"../../config.js\");\n  const { initSchema } = await import(\"../../db/schema.js\");\n  writeConfig({\n    activeRepo: \"repo-a\",\n    repos: {\n      \"repo-a\": {\n        indexDir: repoRoot,\n      },\n    },\n  });\n  initSchema();\n}\n\ndescribe(\"read-file persistence\", () => {\n  beforeEach(() => {\n    generateMock.mockReset();\n  });\n\n  afterEach(() => {\n    vi.resetModules();\n    process.env = { ...ORIGINAL_ENV };\n  });\n\n  it(\"persists the first full read and reuses it on later unchanged reads\", async () => {\n    createTempHome();\n    const repoRoot = fs.mkdtempSync(path.join(os.tmpdir(), \"scai-agent-read-persist-repo-\"));\n    const filePath = path.join(repoRoot, \"src\", \"thing.ts\");\n    fs.mkdirSync(path.dirname(filePath), { recursive: true });\n    fs.writeFileSync(filePath, \"export function runThing() { return 'ok'; }\\n\", \"utf8\");\n\n    await bootstrapRepo(repoRoot);\n    const { createAgentMemory } = await import(\"../../agents/agentMemory.js\");\n    const { getDbForRepo } = await import(\"../../db/client.js\");\n    const { readAgentFile } = await import(\"../../agent/read/index.js\");\n\n    generateMock.mockResolvedValueOnce({\n      data: JSON.stringify({\n        summary: \"Runs the thing.\",\n        relevanceExplanation: \"This file implements runThing.\",\n        role: \"primary\",\n        excerpts: [{ description: \"Implementation block\", code: \"export function runThing() { return 'ok'; }\", symbols: [\"runThing\"] }],\n        keySymbols: [\"runThing\"],\n      }),\n    });\n\n    const firstMemory = createAgentMemory(\"Explain runThing\", repoRoot, repoRoot);\n    firstMemory.task.normalizedQuery = \"Explain runThing\";\n    const first = await readAgentFile(firstMemory, filePath);\n\n    expect(generateMock).toHaveBeenCalledTimes(1);\n    expect(firstMemory.evidence.fileReads[filePath].summary).toBe(first.summary);\n\n    const row = getDbForRepo()\n      .prepare(\"SELECT file_path, read_mode, payload_json FROM agent_file_reads WHERE file_path = ?\")\n      .get(filePath) as { file_path: string; read_mode: string; payload_json: string } | undefined;\n    expect(row?.file_path).toBe(filePath);\n    expect(row?.read_mode).toBe(\"full\");\n    expect(JSON.parse(String(row?.payload_json)).summary).toBe(first.summary);\n\n    const secondMemory = createAgentMemory(\"Where is the implementation?\", repoRoot, repoRoot);\n    secondMemory.task.normalizedQuery = \"Where is the implementation\";\n    const second = await readAgentFile(secondMemory, filePath);\n\n    expect(generateMock).toHaveBeenCalledTimes(1);\n    expect(second.summary).toBe(first.summary);\n    expect(secondMemory.evidence.fileReads[filePath].summary).toBe(first.summary);\n  });\n\n  it(\"invalidates persisted full reads when file content changes\", async () => {\n    createTempHome();\n    const repoRoot = fs.mkdtempSync(path.join(os.tmpdir(), \"scai-agent-read-persist-repo-\"));\n    const filePath = path.join(repoRoot, \"src\", \"thing.ts\");\n    fs.mkdirSync(path.dirname(filePath), { recursive: true });\n    fs.writeFileSync(filePath, \"export function runThing() { return 'ok'; }\\n\", \"utf8\");\n\n    await bootstrapRepo(repoRoot);\n    const { createAgentMemory } = await import(\"../../agents/agentMemory.js\");\n    const { getDbForRepo } = await import(\"../../db/client.js\");\n    const { readAgentFile } = await import(\"../../agent/read/index.js\");\n\n    generateMock\n      .mockResolvedValueOnce({ data: JSON.stringify({ summary: \"Runs the first version.\" }) })\n      .mockResolvedValueOnce({ data: JSON.stringify({ summary: \"Runs the updated version.\" }) });\n\n    const firstMemory = createAgentMemory(\"Explain runThing\", repoRoot, repoRoot);\n    firstMemory.task.normalizedQuery = \"Explain runThing\";\n    await readAgentFile(firstMemory, filePath);\n\n    fs.writeFileSync(filePath, \"export function runThing() { return 'new'; }\\n\", \"utf8\");\n\n    const secondMemory = createAgentMemory(\"Explain runThing again\", repoRoot, repoRoot);\n    secondMemory.task.normalizedQuery = \"Explain runThing again\";\n    const second = await readAgentFile(secondMemory, filePath);\n\n    expect(generateMock).toHaveBeenCalledTimes(2);\n    expect(second.summary).toBe(\"Runs the updated version.\");\n\n    const row = getDbForRepo()\n      .prepare(\"SELECT payload_json FROM agent_file_reads WHERE file_path = ?\")\n      .get(filePath) as { payload_json: string } | undefined;\n    expect(JSON.parse(String(row?.payload_json)).summary).toBe(\"Runs the updated version.\");\n  });\n\n  it(\"does not persist triage reads\", async () => {\n    createTempHome();\n    const repoRoot = fs.mkdtempSync(path.join(os.tmpdir(), \"scai-agent-read-persist-repo-\"));\n    const filePath = path.join(repoRoot, \"src\", \"thing.ts\");\n    fs.mkdirSync(path.dirname(filePath), { recursive: true });\n    fs.writeFileSync(filePath, \"export function runThing() { return 'ok'; }\\n\", \"utf8\");\n\n    await bootstrapRepo(repoRoot);\n    const { createAgentMemory } = await import(\"../../agents/agentMemory.js\");\n    const { getDbForRepo } = await import(\"../../db/client.js\");\n    const { triageAgentFile } = await import(\"../../agent/read/index.js\");\n\n    const memory = createAgentMemory(\"Explain runThing\", repoRoot, repoRoot);\n    memory.task.normalizedQuery = \"Explain runThing\";\n    await triageAgentFile(memory, filePath);\n\n    const row = getDbForRepo()\n      .prepare(\"SELECT file_path FROM agent_file_reads WHERE file_path = ?\")\n      .get(filePath);\n    expect(row).toBeUndefined();\n    expect(generateMock).not.toHaveBeenCalled();\n  });\n});\n"]}

package/dist/__tests__/agents/agentResumeCheckpoint.test.js

@@ -0,0 +1,90 @@
+/**
+ * Verifies the new agent keeps one latest grounded checkpoint across resumed turns.
+ *
+ * Why this file exists:
+ * - continuation prep now needs to preserve one old grounded answer without leaking it into current-turn artifacts
+ * - blocked follow-up turns should still keep the previous grounded checkpoint alive
+ * - this test exercises the real `Agent` entrypoint with a mocked loop boundary
+ */
+import fs from "fs";
+import os from "os";
+import path from "path";
+import { afterEach, describe, expect, it, vi } from "vitest";
+const ORIGINAL_ENV = { ...process.env };
+function createTempHome() {
+    const homeDir = fs.mkdtempSync(path.join(os.tmpdir(), "scai-agent-resume-checkpoint-home-"));
+    process.env.HOME = homeDir;
+    process.env.USERPROFILE = homeDir;
+    return homeDir;
+}
+async function bootstrapRepo(repoRoot) {
+    const { writeConfig } = await import("../../config.js");
+    const { initSchema } = await import("../../db/schema.js");
+    writeConfig({
+        activeRepo: "repo-a",
+        repos: {
+            "repo-a": {
+                indexDir: repoRoot,
+            },
+        },
+    });
+    initSchema();
+}
+afterEach(() => {
+    process.env = { ...ORIGINAL_ENV };
+    vi.resetModules();
+    vi.restoreAllMocks();
+});
+describe("agent resume checkpoint", () => {
+    it("copies the latest grounded result into resumeCheckpoint before a resumed turn starts", async () => {
+        createTempHome();
+        const repoRoot = fs.mkdtempSync(path.join(os.tmpdir(), "scai-agent-resume-checkpoint-repo-"));
+        await bootstrapRepo(repoRoot);
+        const { bootAgentTask, beginAgentTurn, finishAgentTurn, persistAgentTask } = await import("../../agent/persistence/index.js");
+        const first = bootAgentTask("Explain the retry policy", { bindAsCurrentTask: true });
+        beginAgentTurn(first, "Explain the retry policy", "fresh-ask");
+        first.task.status = "done";
+        first.task.primaryIntent = "Explain the retry policy.";
+        first.task.normalizedQuery = "Explain the retry policy";
+        first.artifacts.latestFinalAnswerPacket = {
+            normalizedQuery: "Explain the retry policy",
+            primaryIntent: "Explain the retry policy.",
+            queryScope: "broad-repo",
+            explicitTargets: ["retry policy"],
+            groundedPrimaryFiles: [],
+            groundedSupportingFiles: [],
+            mustMentionFiles: ["/repo/cli/src/agent/policy/index.ts"],
+            mustMentionSymbols: ["resolvePolicyState"],
+            mustMentionFacts: ["Exact target phrase: retry policy"],
+        };
+        first.artifacts.finalAnswer = "The retry policy is owned by resolvePolicyState.";
+        persistAgentTask(first);
+        finishAgentTurn(first);
+        vi.mock("../../agent/runtime/runAgentLoop.js", () => ({
+            runAgentLoop: vi.fn(async (memory) => {
+                expect(memory.resumeCheckpoint).toEqual(expect.objectContaining({
+                    finalAnswer: "The retry policy is owned by resolvePolicyState.",
+                    finalAnswerPacket: expect.objectContaining({
+                        mustMentionSymbols: ["resolvePolicyState"],
+                    }),
+                    sourceTurnIndex: 1,
+                    sourceUserQuery: "Explain the retry policy",
+                }));
+                expect(memory.artifacts.finalAnswer).toBeUndefined();
+                expect(memory.artifacts.latestFinalAnswerPacket).toBeUndefined();
+                memory.task.status = "waiting";
+                memory.artifacts.stopMessage = "Need one more file.";
+            }),
+        }));
+        const { Agent } = await import("../../agent/index.js");
+        const resumed = await import("../../agent/persistence/index.js").then((mod) => mod.loadAgentTask(first.task.id, "What should I inspect next?", { bindAsCurrentTask: true }));
+        const ui = {
+            start() { },
+            update() { },
+            message() { },
+            stop() { },
+        };
+        await new Agent("What should I inspect next?", ui, resumed).run();
+    });
+});
+//# sourceMappingURL=agentResumeCheckpoint.test.js.map

package/dist/__tests__/agents/agentResumeCheckpoint.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentResumeCheckpoint.test.js","sourceRoot":"","sources":["../../../src/__tests__/agents/agentResumeCheckpoint.test.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Verifies the new agent keeps one latest grounded checkpoint across resumed turns.\n *\n * Why this file exists:\n * - continuation prep now needs to preserve one old grounded answer without leaking it into current-turn artifacts\n * - blocked follow-up turns should still keep the previous grounded checkpoint alive\n * - this test exercises the real `Agent` entrypoint with a mocked loop boundary\n */\nimport fs from \"fs\";\nimport os from \"os\";\nimport path from \"path\";\nimport { afterEach, describe, expect, it, vi } from \"vitest\";\n\nconst ORIGINAL_ENV = { ...process.env };\n\nfunction createTempHome(): string {\n  const homeDir = fs.mkdtempSync(path.join(os.tmpdir(), \"scai-agent-resume-checkpoint-home-\"));\n  process.env.HOME = homeDir;\n  process.env.USERPROFILE = homeDir;\n  return homeDir;\n}\n\nasync function bootstrapRepo(repoRoot: string) {\n  const { writeConfig } = await import(\"../../config.js\");\n  const { initSchema } = await import(\"../../db/schema.js\");\n  writeConfig({\n    activeRepo: \"repo-a\",\n    repos: {\n      \"repo-a\": {\n        indexDir: repoRoot,\n      },\n    },\n  });\n  initSchema();\n}\n\nafterEach(() => {\n  process.env = { ...ORIGINAL_ENV };\n  vi.resetModules();\n  vi.restoreAllMocks();\n});\n\ndescribe(\"agent resume checkpoint\", () => {\n  it(\"copies the latest grounded result into resumeCheckpoint before a resumed turn starts\", async () => {\n    createTempHome();\n    const repoRoot = fs.mkdtempSync(path.join(os.tmpdir(), \"scai-agent-resume-checkpoint-repo-\"));\n    await bootstrapRepo(repoRoot);\n\n    const { bootAgentTask, beginAgentTurn, finishAgentTurn, persistAgentTask } = await import(\"../../agent/persistence/index.js\");\n    const first = bootAgentTask(\"Explain the retry policy\", { bindAsCurrentTask: true });\n    beginAgentTurn(first, \"Explain the retry policy\", \"fresh-ask\");\n    first.task.status = \"done\";\n    first.task.primaryIntent = \"Explain the retry policy.\";\n    first.task.normalizedQuery = \"Explain the retry policy\";\n    first.artifacts.latestFinalAnswerPacket = {\n      normalizedQuery: \"Explain the retry policy\",\n      primaryIntent: \"Explain the retry policy.\",\n      queryScope: \"broad-repo\",\n      explicitTargets: [\"retry policy\"],\n      groundedPrimaryFiles: [],\n      groundedSupportingFiles: [],\n      mustMentionFiles: [\"/repo/cli/src/agent/policy/index.ts\"],\n      mustMentionSymbols: [\"resolvePolicyState\"],\n      mustMentionFacts: [\"Exact target phrase: retry policy\"],\n    };\n    first.artifacts.finalAnswer = \"The retry policy is owned by resolvePolicyState.\";\n    persistAgentTask(first);\n    finishAgentTurn(first);\n\n    vi.mock(\"../../agent/runtime/runAgentLoop.js\", () => ({\n      runAgentLoop: vi.fn(async (memory) => {\n        expect(memory.resumeCheckpoint).toEqual(expect.objectContaining({\n          finalAnswer: \"The retry policy is owned by resolvePolicyState.\",\n          finalAnswerPacket: expect.objectContaining({\n            mustMentionSymbols: [\"resolvePolicyState\"],\n          }),\n          sourceTurnIndex: 1,\n          sourceUserQuery: \"Explain the retry policy\",\n        }));\n        expect(memory.artifacts.finalAnswer).toBeUndefined();\n        expect(memory.artifacts.latestFinalAnswerPacket).toBeUndefined();\n        memory.task.status = \"waiting\";\n        memory.artifacts.stopMessage = \"Need one more file.\";\n      }),\n    }));\n\n    const { Agent } = await import(\"../../agent/index.js\");\n    const resumed = await import(\"../../agent/persistence/index.js\").then((mod) =>\n      mod.loadAgentTask(first.task.id, \"What should I inspect next?\", { bindAsCurrentTask: true })\n    );\n    const ui = {\n      start() {},\n      update() {},\n      message() {},\n      stop() {},\n    };\n\n    await new Agent(\"What should I inspect next?\", ui as never, resumed).run();\n  });\n});\n"]}

package/dist/__tests__/agents/agentSearchBatchPlanner.test.js

@@ -0,0 +1,289 @@
+/**
+ * Covers grouped semantic search batching without running the full agent loop.
+ *
+ * Why this file exists:
+ * - search term group planning should stay owned by the new search area
+ * - batch continuation and snippet merge rules are easier to prove with direct tests
+ */
+import { describe, expect, it } from "vitest";
+import { createAgentMemory } from "../../agents/agentMemory.js";
+import { runSemanticSearchBatches, buildSemanticSearchBatchPlan } from "../../agent/search/batchPlanner.js";
+import { buildSearchContext } from "../../agent/search/searchContext.js";
+describe("buildSemanticSearchBatchPlan", () => {
+    it("keeps the base query first and dedupes repeated group queries", () => {
+        const memory = createAgentMemory("Explain how test execution is wired", "/repo", "/repo");
+        memory.task.normalizedQuery = "Explain how test execution is wired";
+        memory.task.searchTermGroups = [
+            { kind: "generic", terms: ["cli", "wiring", "commands"] },
+            { kind: "repo-anchor", terms: ["registerDevCliCommands", "testCommands"] },
+            { kind: "repo-anchor", terms: ["registerDevCliCommands", "testCommands"] },
+        ];
+        const context = buildSearchContext(memory, memory.task.normalizedQuery);
+        const batches = buildSemanticSearchBatchPlan(context);
+        expect(batches).toEqual([
+            { query: "Explain how test execution is wired", source: "base-query" },
+            {
+                query: "registerDevCliCommands testCommands",
+                source: "search-term-group",
+                termGroupIndex: 1,
+                kind: "repo-anchor",
+                terms: ["registerDevCliCommands", "testCommands"],
+            },
+            {
+                query: "cli wiring commands",
+                source: "search-term-group",
+                termGroupIndex: 0,
+                kind: "generic",
+                terms: ["cli", "wiring", "commands"],
+            },
+        ]);
+    });
+});
+describe("runSemanticSearchBatches", () => {
+    it("stops after the first strong batch", async () => {
+        const memory = createAgentMemory("Explain how ranking works", "/repo", "/repo");
+        memory.task.searchTermGroups = [{ kind: "repo-anchor", terms: ["scoreSearchCandidates", "sharedRankingPolicy"] }];
+        const context = buildSearchContext(memory, memory.task.initialQuery);
+        const packet = await runSemanticSearchBatches(memory, context, 5, async (query) => ({
+            lane: "semantic",
+            query,
+            filePaths: ["/repo/cli/src/agent/search/ranking.ts"],
+            matches: [
+                {
+                    filePath: "/repo/cli/src/agent/search/ranking.ts",
+                    line: 1,
+                    snippet: "export function scoreSearchCandidates() {}",
+                    matchKind: "semantic-content",
+                    reasons: ["term:scoreSearchCandidates", "term:sharedRankingPolicy"],
+                },
+            ],
+        }));
+        expect(packet.debug?.batchDebug).toEqual([
+            expect.objectContaining({
+                query: "Explain how ranking works",
+                source: "base-query",
+                continued: false,
+                strongEnough: true,
+            }),
+        ]);
+    });
+    it("continues to later groups when the first batch is weak", async () => {
+        const memory = createAgentMemory("Explain how test execution is wired", "/repo", "/repo");
+        memory.task.searchTermGroups = [
+            { kind: "generic", terms: ["repo", "test"] },
+            { kind: "repo-anchor", terms: ["registerDevCliCommands", "testCommands", "register"] },
+        ];
+        const context = buildSearchContext(memory, memory.task.initialQuery);
+        const packet = await runSemanticSearchBatches(memory, context, 5, async (query) => {
+            if (query === "Explain how test execution is wired" || query === "repo test") {
+                return {
+                    lane: "semantic",
+                    query,
+                    filePaths: ["/repo/cli/src/agent/actions/index.ts"],
+                    matches: [
+                        {
+                            filePath: "/repo/cli/src/agent/actions/index.ts",
+                            line: 1,
+                            snippet: "export const repoTest = true;",
+                            matchKind: "semantic-content",
+                            reasons: ["term:repo", "term:test"],
+                        },
+                    ],
+                };
+            }
+            return {
+                lane: "semantic",
+                query,
+                filePaths: ["/repo/cli/src/testing/registerDevCliCommands.ts"],
+                matches: [
+                    {
+                        filePath: "/repo/cli/src/testing/registerDevCliCommands.ts",
+                        line: 4,
+                        snippet: "export function registerDevCliCommands() {}",
+                        matchKind: "semantic-content",
+                        reasons: ["term:registerDevCliCommands", "term:testCommands", "term:register"],
+                    },
+                ],
+            };
+        });
+        expect(packet.filePaths).toEqual(expect.arrayContaining([
+            "/repo/cli/src/agent/actions/index.ts",
+            "/repo/cli/src/testing/registerDevCliCommands.ts",
+        ]));
+        expect(packet.debug?.batchDebug).toEqual([
+            expect.objectContaining({
+                query: "Explain how test execution is wired",
+                continued: true,
+                strongEnough: false,
+                strongReason: "evidence is still driven by weak semantic terms",
+            }),
+            expect.objectContaining({
+                query: "registerDevCliCommands testCommands register",
+                kind: "repo-anchor",
+                continued: false,
+                strongEnough: true,
+            }),
+        ]);
+    });
+    it("preserves snippet evidence from multiple batches", async () => {
+        const memory = createAgentMemory("Explain loop limit ownership", "/repo", "/repo");
+        memory.task.searchTermGroups = [{ kind: "repo-anchor", terms: ["maxTurns", "turnCount"] }];
+        const context = buildSearchContext(memory, memory.task.initialQuery);
+        const packet = await runSemanticSearchBatches(memory, context, 5, async (query) => {
+            if (query === "Explain loop limit ownership") {
+                return {
+                    lane: "semantic",
+                    query,
+                    filePaths: ["/repo/cli/src/agent/state/memory.ts"],
+                    matches: [
+                        {
+                            filePath: "/repo/cli/src/agent/state/memory.ts",
+                            line: 10,
+                            snippet: "export const owner = 'agent';",
+                            matchKind: "semantic-content",
+                            reasons: ["term:agent"],
+                        },
+                    ],
+                };
+            }
+            return {
+                lane: "semantic",
+                query,
+                filePaths: ["/repo/cli/src/agent/state/memory.ts"],
+                matches: [
+                    {
+                        filePath: "/repo/cli/src/agent/state/memory.ts",
+                        line: 42,
+                        snippet: "maxTurns: 12, turnCount: 0,",
+                        matchKind: "semantic-content",
+                        reasons: ["term:maxTurns", "term:turnCount"],
+                    },
+                ],
+            };
+        });
+        expect(packet.matches).toEqual(expect.arrayContaining([
+            expect.objectContaining({
+                filePath: "/repo/cli/src/agent/state/memory.ts",
+                snippet: "export const owner = 'agent';",
+            }),
+            expect.objectContaining({
+                filePath: "/repo/cli/src/agent/state/memory.ts",
+                snippet: "maxTurns: 12, turnCount: 0,",
+            }),
+        ]));
+    });
+    it("continues config-style search when base matches are only weak semantic terms", async () => {
+        const memory = createAgentMemory("Where are test entry points configured?", "/repo", "/repo");
+        memory.task.searchTermGroups = [{ kind: "repo-anchor", terms: ["registerDevCliCommands", "testCommands", "entrypoint"] }];
+        const context = buildSearchContext(memory, memory.task.initialQuery);
+        const packet = await runSemanticSearchBatches(memory, context, 5, async (query) => {
+            if (query === "Where are test entry points configured?") {
+                return {
+                    lane: "semantic",
+                    query,
+                    filePaths: ["/repo/cli/src/testing/testCommands.ts"],
+                    matches: [
+                        {
+                            filePath: "/repo/cli/src/testing/testCommands.ts",
+                            line: 2,
+                            snippet: "Registers shell test helpers.",
+                            matchKind: "semantic-content",
+                            reasons: ["term:test", "term:configured"],
+                        },
+                    ],
+                };
+            }
+            return {
+                lane: "semantic",
+                query,
+                filePaths: ["/repo/cli/src/testing/registerDevCliCommands.ts"],
+                matches: [
+                    {
+                        filePath: "/repo/cli/src/testing/registerDevCliCommands.ts",
+                        line: 4,
+                        snippet: "export function registerDevCliCommands() {}",
+                        matchKind: "semantic-content",
+                        reasons: ["term:registerDevCliCommands", "term:testCommands", "term:entrypoint"],
+                    },
+                ],
+            };
+        });
+        expect(packet.filePaths).toEqual(expect.arrayContaining([
+            "/repo/cli/src/testing/testCommands.ts",
+            "/repo/cli/src/testing/registerDevCliCommands.ts",
+        ]));
+        expect(packet.debug?.batchDebug).toEqual([
+            expect.objectContaining({
+                query: "Where are test entry points configured?",
+                continued: true,
+                strongEnough: false,
+            }),
+            expect.objectContaining({
+                query: "registerDevCliCommands testCommands entrypoint",
+                continued: false,
+                strongEnough: true,
+            }),
+        ]);
+    });
+    it("does not stop on one anchored config hit without concrete confirmation", async () => {
+        const memory = createAgentMemory("Where are command entry points configured?", "/repo", "/repo");
+        memory.task.searchTermGroups = [
+            { kind: "repo-anchor", terms: ["registerDevCliCommands", "entrypoint"] },
+            { kind: "command-path", terms: ["package.json", "/test-run"] },
+        ];
+        const context = buildSearchContext(memory, memory.task.initialQuery);
+        const packet = await runSemanticSearchBatches(memory, context, 5, async (query) => {
+            if (query === "Where are command entry points configured?") {
+                return {
+                    lane: "semantic",
+                    query,
+                    filePaths: ["/repo/package.json"],
+                    topHits: [
+                        {
+                            filePath: "/repo/package.json",
+                            score: 20,
+                            reasons: ["path-anchor"],
+                        },
+                    ],
+                    matches: [
+                        {
+                            filePath: "/repo/package.json",
+                            line: 2,
+                            snippet: "\"test\": \"vitest\"",
+                            matchKind: "semantic-content",
+                            reasons: ["term:test"],
+                        },
+                    ],
+                };
+            }
+            return {
+                lane: "semantic",
+                query,
+                filePaths: ["/repo/cli/src/testing/registerDevCliCommands.ts"],
+                matches: [
+                    {
+                        filePath: "/repo/cli/src/testing/registerDevCliCommands.ts",
+                        line: 4,
+                        snippet: "export function registerDevCliCommands() {}",
+                        matchKind: "semantic-content",
+                        reasons: ["term:registerDevCliCommands", "term:entrypoint"],
+                    },
+                ],
+            };
+        });
+        expect(packet.debug?.batchDebug).toEqual([
+            expect.objectContaining({
+                query: "Where are command entry points configured?",
+                continued: true,
+                strongEnough: false,
+                strongReason: "evidence is still driven by weak semantic terms",
+            }),
+            expect.objectContaining({
+                query: "registerDevCliCommands entrypoint",
+                continued: false,
+                strongEnough: true,
+            }),
+        ]);
+    });
+});
+//# sourceMappingURL=agentSearchBatchPlanner.test.js.map

package/dist/__tests__/agents/agentSearchBatchPlanner.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentSearchBatchPlanner.test.js","sourceRoot":"","sources":["../../../src/__tests__/agents/agentSearchBatchPlanner.test.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Covers grouped semantic search batching without running the full agent loop.\n *\n * Why this file exists:\n * - search term group planning should stay owned by the new search area\n * - batch continuation and snippet merge rules are easier to prove with direct tests\n */\nimport { describe, expect, it } from \"vitest\";\nimport { createAgentMemory } from \"../../agents/agentMemory.js\";\nimport { runSemanticSearchBatches, buildSemanticSearchBatchPlan } from \"../../agent/search/batchPlanner.js\";\nimport { buildSearchContext } from \"../../agent/search/searchContext.js\";\nimport type { AgentSearchPacket } from \"../../agent/search/types.js\";\n\ndescribe(\"buildSemanticSearchBatchPlan\", () => {\n  it(\"keeps the base query first and dedupes repeated group queries\", () => {\n    const memory = createAgentMemory(\"Explain how test execution is wired\", \"/repo\", \"/repo\");\n    memory.task.normalizedQuery = \"Explain how test execution is wired\";\n    memory.task.searchTermGroups = [\n      { kind: \"generic\", terms: [\"cli\", \"wiring\", \"commands\"] },\n      { kind: \"repo-anchor\", terms: [\"registerDevCliCommands\", \"testCommands\"] },\n      { kind: \"repo-anchor\", terms: [\"registerDevCliCommands\", \"testCommands\"] },\n    ];\n    const context = buildSearchContext(memory, memory.task.normalizedQuery);\n\n    const batches = buildSemanticSearchBatchPlan(context);\n\n    expect(batches).toEqual([\n      { query: \"Explain how test execution is wired\", source: \"base-query\" },\n      {\n        query: \"registerDevCliCommands testCommands\",\n        source: \"search-term-group\",\n        termGroupIndex: 1,\n        kind: \"repo-anchor\",\n        terms: [\"registerDevCliCommands\", \"testCommands\"],\n      },\n      {\n        query: \"cli wiring commands\",\n        source: \"search-term-group\",\n        termGroupIndex: 0,\n        kind: \"generic\",\n        terms: [\"cli\", \"wiring\", \"commands\"],\n      },\n    ]);\n  });\n});\n\ndescribe(\"runSemanticSearchBatches\", () => {\n  it(\"stops after the first strong batch\", async () => {\n    const memory = createAgentMemory(\"Explain how ranking works\", \"/repo\", \"/repo\");\n    memory.task.searchTermGroups = [{ kind: \"repo-anchor\", terms: [\"scoreSearchCandidates\", \"sharedRankingPolicy\"] }];\n    const context = buildSearchContext(memory, memory.task.initialQuery);\n\n    const packet = await runSemanticSearchBatches(\n      memory,\n      context,\n      5,\n      async (query): Promise<AgentSearchPacket> => ({\n        lane: \"semantic\",\n        query,\n        filePaths: [\"/repo/cli/src/agent/search/ranking.ts\"],\n        matches: [\n          {\n            filePath: \"/repo/cli/src/agent/search/ranking.ts\",\n            line: 1,\n            snippet: \"export function scoreSearchCandidates() {}\",\n            matchKind: \"semantic-content\",\n            reasons: [\"term:scoreSearchCandidates\", \"term:sharedRankingPolicy\"],\n          },\n        ],\n      })\n    );\n\n    expect(packet.debug?.batchDebug).toEqual([\n      expect.objectContaining({\n        query: \"Explain how ranking works\",\n        source: \"base-query\",\n        continued: false,\n        strongEnough: true,\n      }),\n    ]);\n  });\n\n  it(\"continues to later groups when the first batch is weak\", async () => {\n    const memory = createAgentMemory(\"Explain how test execution is wired\", \"/repo\", \"/repo\");\n    memory.task.searchTermGroups = [\n      { kind: \"generic\", terms: [\"repo\", \"test\"] },\n      { kind: \"repo-anchor\", terms: [\"registerDevCliCommands\", \"testCommands\", \"register\"] },\n    ];\n    const context = buildSearchContext(memory, memory.task.initialQuery);\n\n    const packet = await runSemanticSearchBatches(\n      memory,\n      context,\n      5,\n      async (query): Promise<AgentSearchPacket> => {\n        if (query === \"Explain how test execution is wired\" || query === \"repo test\") {\n          return {\n            lane: \"semantic\",\n            query,\n            filePaths: [\"/repo/cli/src/agent/actions/index.ts\"],\n            matches: [\n              {\n                filePath: \"/repo/cli/src/agent/actions/index.ts\",\n                line: 1,\n                snippet: \"export const repoTest = true;\",\n                matchKind: \"semantic-content\",\n                reasons: [\"term:repo\", \"term:test\"],\n              },\n            ],\n          };\n        }\n        return {\n          lane: \"semantic\",\n          query,\n          filePaths: [\"/repo/cli/src/testing/registerDevCliCommands.ts\"],\n          matches: [\n            {\n              filePath: \"/repo/cli/src/testing/registerDevCliCommands.ts\",\n              line: 4,\n              snippet: \"export function registerDevCliCommands() {}\",\n              matchKind: \"semantic-content\",\n              reasons: [\"term:registerDevCliCommands\", \"term:testCommands\", \"term:register\"],\n            },\n          ],\n        };\n      }\n    );\n\n    expect(packet.filePaths).toEqual(expect.arrayContaining([\n      \"/repo/cli/src/agent/actions/index.ts\",\n      \"/repo/cli/src/testing/registerDevCliCommands.ts\",\n    ]));\n    expect(packet.debug?.batchDebug).toEqual([\n      expect.objectContaining({\n        query: \"Explain how test execution is wired\",\n        continued: true,\n        strongEnough: false,\n        strongReason: \"evidence is still driven by weak semantic terms\",\n      }),\n      expect.objectContaining({\n        query: \"registerDevCliCommands testCommands register\",\n        kind: \"repo-anchor\",\n        continued: false,\n        strongEnough: true,\n      }),\n    ]);\n  });\n\n  it(\"preserves snippet evidence from multiple batches\", async () => {\n    const memory = createAgentMemory(\"Explain loop limit ownership\", \"/repo\", \"/repo\");\n    memory.task.searchTermGroups = [{ kind: \"repo-anchor\", terms: [\"maxTurns\", \"turnCount\"] }];\n    const context = buildSearchContext(memory, memory.task.initialQuery);\n\n    const packet = await runSemanticSearchBatches(\n      memory,\n      context,\n      5,\n      async (query): Promise<AgentSearchPacket> => {\n        if (query === \"Explain loop limit ownership\") {\n          return {\n            lane: \"semantic\",\n            query,\n            filePaths: [\"/repo/cli/src/agent/state/memory.ts\"],\n            matches: [\n              {\n                filePath: \"/repo/cli/src/agent/state/memory.ts\",\n                line: 10,\n                snippet: \"export const owner = 'agent';\",\n                matchKind: \"semantic-content\",\n                reasons: [\"term:agent\"],\n              },\n            ],\n          };\n        }\n        return {\n          lane: \"semantic\",\n          query,\n          filePaths: [\"/repo/cli/src/agent/state/memory.ts\"],\n          matches: [\n            {\n              filePath: \"/repo/cli/src/agent/state/memory.ts\",\n              line: 42,\n              snippet: \"maxTurns: 12, turnCount: 0,\",\n              matchKind: \"semantic-content\",\n              reasons: [\"term:maxTurns\", \"term:turnCount\"],\n            },\n          ],\n        };\n      }\n    );\n\n    expect(packet.matches).toEqual(expect.arrayContaining([\n      expect.objectContaining({\n        filePath: \"/repo/cli/src/agent/state/memory.ts\",\n        snippet: \"export const owner = 'agent';\",\n      }),\n      expect.objectContaining({\n        filePath: \"/repo/cli/src/agent/state/memory.ts\",\n        snippet: \"maxTurns: 12, turnCount: 0,\",\n      }),\n    ]));\n  });\n\n  it(\"continues config-style search when base matches are only weak semantic terms\", async () => {\n    const memory = createAgentMemory(\"Where are test entry points configured?\", \"/repo\", \"/repo\");\n    memory.task.searchTermGroups = [{ kind: \"repo-anchor\", terms: [\"registerDevCliCommands\", \"testCommands\", \"entrypoint\"] }];\n    const context = buildSearchContext(memory, memory.task.initialQuery);\n\n    const packet = await runSemanticSearchBatches(\n      memory,\n      context,\n      5,\n      async (query): Promise<AgentSearchPacket> => {\n        if (query === \"Where are test entry points configured?\") {\n          return {\n            lane: \"semantic\",\n            query,\n            filePaths: [\"/repo/cli/src/testing/testCommands.ts\"],\n            matches: [\n              {\n                filePath: \"/repo/cli/src/testing/testCommands.ts\",\n                line: 2,\n                snippet: \"Registers shell test helpers.\",\n                matchKind: \"semantic-content\",\n                reasons: [\"term:test\", \"term:configured\"],\n              },\n            ],\n          };\n        }\n        return {\n          lane: \"semantic\",\n          query,\n          filePaths: [\"/repo/cli/src/testing/registerDevCliCommands.ts\"],\n          matches: [\n            {\n              filePath: \"/repo/cli/src/testing/registerDevCliCommands.ts\",\n              line: 4,\n              snippet: \"export function registerDevCliCommands() {}\",\n              matchKind: \"semantic-content\",\n              reasons: [\"term:registerDevCliCommands\", \"term:testCommands\", \"term:entrypoint\"],\n            },\n          ],\n        };\n      }\n    );\n\n    expect(packet.filePaths).toEqual(expect.arrayContaining([\n      \"/repo/cli/src/testing/testCommands.ts\",\n      \"/repo/cli/src/testing/registerDevCliCommands.ts\",\n    ]));\n    expect(packet.debug?.batchDebug).toEqual([\n      expect.objectContaining({\n        query: \"Where are test entry points configured?\",\n        continued: true,\n        strongEnough: false,\n      }),\n      expect.objectContaining({\n        query: \"registerDevCliCommands testCommands entrypoint\",\n        continued: false,\n        strongEnough: true,\n      }),\n    ]);\n  });\n\n  it(\"does not stop on one anchored config hit without concrete confirmation\", async () => {\n    const memory = createAgentMemory(\"Where are command entry points configured?\", \"/repo\", \"/repo\");\n    memory.task.searchTermGroups = [\n      { kind: \"repo-anchor\", terms: [\"registerDevCliCommands\", \"entrypoint\"] },\n      { kind: \"command-path\", terms: [\"package.json\", \"/test-run\"] },\n    ];\n    const context = buildSearchContext(memory, memory.task.initialQuery);\n\n    const packet = await runSemanticSearchBatches(\n      memory,\n      context,\n      5,\n      async (query): Promise<AgentSearchPacket> => {\n        if (query === \"Where are command entry points configured?\") {\n          return {\n            lane: \"semantic\",\n            query,\n            filePaths: [\"/repo/package.json\"],\n            topHits: [\n              {\n                filePath: \"/repo/package.json\",\n                score: 20,\n                reasons: [\"path-anchor\"],\n              },\n            ],\n            matches: [\n              {\n                filePath: \"/repo/package.json\",\n                line: 2,\n                snippet: \"\\\"test\\\": \\\"vitest\\\"\",\n                matchKind: \"semantic-content\",\n                reasons: [\"term:test\"],\n              },\n            ],\n          };\n        }\n        return {\n          lane: \"semantic\",\n          query,\n          filePaths: [\"/repo/cli/src/testing/registerDevCliCommands.ts\"],\n          matches: [\n            {\n              filePath: \"/repo/cli/src/testing/registerDevCliCommands.ts\",\n              line: 4,\n              snippet: \"export function registerDevCliCommands() {}\",\n              matchKind: \"semantic-content\",\n              reasons: [\"term:registerDevCliCommands\", \"term:entrypoint\"],\n            },\n          ],\n        };\n      }\n    );\n\n    expect(packet.debug?.batchDebug).toEqual([\n      expect.objectContaining({\n        query: \"Where are command entry points configured?\",\n        continued: true,\n        strongEnough: false,\n        strongReason: \"evidence is still driven by weak semantic terms\",\n      }),\n      expect.objectContaining({\n        query: \"registerDevCliCommands entrypoint\",\n        continued: false,\n        strongEnough: true,\n      }),\n    ]);\n  });\n});\n"]}

package/dist/__tests__/agents/agentSearchOwnership.test.js

@@ -0,0 +1,166 @@
+/**
+ * Guards the new-agent search area against old-flow reuse and legacy search logging.
+ *
+ * Why this file exists:
+ * - the new agent should own its search flow outright
+ * - search-heavy runs should expose one clean search boundary instead of legacy helper noise
+ * - static checks make accidental imports from old flow fail fast in review and CI
+ */
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+import fg from "fast-glob";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { createAgentMemory } from "../../agents/agentMemory.js";
+const semanticRows = vi.hoisted(() => ({
+    default: [
+        {
+            id: 1,
+            path: "/repo/cli/src/commands/TasksCmd.ts",
+            filename: "TasksCmd.ts",
+            summary: null,
+            type: "ts",
+            bm25Score: -6.6,
+        },
+        {
+            id: 2,
+            path: "/repo/cli/src/agents/guards/executionPolicyResolver.ts",
+            filename: "executionPolicyResolver.ts",
+            summary: null,
+            type: "ts",
+            bm25Score: -6.4,
+        },
+    ],
+    recovery: [
+        {
+            id: 10,
+            path: "/repo/cli/src/agent/state/memory.ts",
+            filename: "memory.ts",
+            summary: null,
+            type: "ts",
+            bm25Score: -7.1,
+        },
+    ],
+    forcePrimaryEmpty: false,
+    primaryReturnedEmptyOnce: false,
+}));
+const runtimeRecords = vi.hoisted(() => []);
+vi.mock("../../db/client.js", () => ({
+    getDbForRepo: () => ({
+        prepare: () => ({
+            all: (query) => {
+                if (query.includes("runtime*"))
+                    return semanticRows.default;
+                if (semanticRows.forcePrimaryEmpty) {
+                    if (!semanticRows.primaryReturnedEmptyOnce) {
+                        semanticRows.primaryReturnedEmptyOnce = true;
+                        return [];
+                    }
+                    return semanticRows.recovery;
+                }
+                if (query.includes("loop*") || query.includes("turn*") || query.includes("count*") || query.includes("max*")) {
+                    return semanticRows.recovery;
+                }
+                return [];
+            },
+        }),
+    }),
+}));
+vi.mock("../../utils/runtimeLogger.js", async () => {
+    const actual = await vi.importActual("../../utils/runtimeLogger.js");
+    return {
+        ...actual,
+        clearRuntimeLogs: vi.fn(() => {
+            runtimeRecords.length = 0;
+        }),
+        logRuntimeRecord: vi.fn((record) => {
+            runtimeRecords.push(record);
+        }),
+    };
+});
+function stripComments(source) {
+    return source
+        .replace(/\/\*[\s\S]*?\*\//g, "")
+        .replace(/^\s*\/\/.*$/gm, "");
+}
+describe("new-agent search ownership", () => {
+    beforeEach(() => {
+        runtimeRecords.length = 0;
+        semanticRows.forcePrimaryEmpty = false;
+        semanticRows.primaryReturnedEmptyOnce = false;
+    });
+    afterEach(() => {
+        runtimeRecords.length = 0;
+        semanticRows.forcePrimaryEmpty = false;
+        semanticRows.primaryReturnedEmptyOnce = false;
+    });
+    it("keeps cli/src/agent free of old-flow imports and legacy module names", async () => {
+        const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../../../..");
+        const agentFiles = await fg("src/agent/**/*.ts", { cwd: path.join(repoRoot, "cli"), absolute: true });
+        const forbiddenTokens = [
+            "promptLogHelper",
+            "MainAgent",
+            "transformPlanGen",
+            "validateChangesStep",
+            "reasonNextStep",
+            "continuityAnswerModule",
+        ];
+        for (const filePath of agentFiles) {
+            const source = stripComments(fs.readFileSync(filePath, "utf8"));
+            expect(source).not.toMatch(/from\s+["'][^"']*\/agents\//);
+            for (const token of forbiddenTokens) {
+                expect(source, `${path.relative(repoRoot, filePath)} should not reference ${token}`).not.toContain(token);
+            }
+        }
+    });
+    it("writes one clean search-module boundary without legacy shared search records", async () => {
+        const { runSearchDb } = await import("../../agent/search/index.js");
+        const memory = createAgentMemory("console presentation centralization runtime messages", "/repo", "/repo");
+        memory.task.currentStepId = "step-001";
+        const packet = await runSearchDb(memory, "console presentation centralization runtime messages", 5);
+        const summaries = runtimeRecords.map((record) => String(record.summary ?? ""));
+        const outputRecord = runtimeRecords.find((record) => record.summary === "search-module output");
+        expect(packet.lane).toBe("semantic");
+        expect(summaries).toContain("search-module input");
+        expect(summaries).toContain("search-module output");
+        expect(outputRecord?.payload).toMatchObject({
+            lane: "semantic",
+            candidateCount: 2,
+            semanticDebug: {
+                queriesRun: expect.any(Array),
+                recoveryUsed: false,
+                matchTerms: expect.any(Array),
+            },
+            route: {
+                chosenLane: "semantic",
+                fallbackUsed: false,
+            },
+        });
+        expect(JSON.stringify(runtimeRecords)).not.toContain("[shared] [legacy:output]");
+        expect(JSON.stringify(runtimeRecords)).not.toContain("semanticSearchFiles initial results");
+        expect(JSON.stringify(runtimeRecords)).not.toContain("fileIndex.generatePrimaryFtsQuery");
+        expect(JSON.stringify(runtimeRecords)).not.toContain("fileIndex.generateFallbackFtsQueries");
+    });
+    it("logs deterministic semantic recovery when the primary query is empty", async () => {
+        const { runSearchDb } = await import("../../agent/search/index.js");
+        semanticRows.forcePrimaryEmpty = true;
+        semanticRows.primaryReturnedEmptyOnce = false;
+        const memory = createAgentMemory("where do I set the max count for how many loops the agent can run?", "/repo", "/repo");
+        memory.task.currentStepId = "step-002";
+        const packet = await runSearchDb(memory, "where do I set the max count for how many loops the agent can run?", 5);
+        const outputRecord = runtimeRecords.find((record) => record.summary === "search-module output");
+        expect(packet.filePaths).toContain("/repo/cli/src/agent/state/memory.ts");
+        expect(outputRecord?.payload).toMatchObject({
+            semanticDebug: {
+                queriesRun: expect.any(Array),
+                recoveryUsed: true,
+                recoveryReason: "primary-empty",
+            },
+            route: {
+                chosenLane: "semantic",
+                fallbackUsed: true,
+            },
+        });
+    });
+});
+//# sourceMappingURL=agentSearchOwnership.test.js.map