scai 0.1.178 → 1.0.0

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

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

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

@@ -0,0 +1,139 @@
+/**
+ * Covers search-owned ranking behavior for the modular agent runtime.
+ *
+ * Why this file exists:
+ * - the agent adapter should stay aligned with the shared scorer
+ * - ranking changes should be proven without depending on read or runtime policy
+ * - score reasons should stay explicit when candidate ordering changes
+ */
+import { describe, expect, it } from "vitest";
+import { rankAgentSearchHits } from "../../agent/search/ranking.js";
+import { scoreCandidateFiles } from "../../search/sharedRankingPolicy.js";
+describe("rankAgentSearchHits", () => {
+    it("prefers exact filename anchors over generic workflow files", () => {
+        const ranked = rankAgentSearchHits([
+            "/repo/cli/src/commands/EvalReportCmd.ts",
+            "/repo/cli/src/agents/MainAgent.ts",
+        ], {}, "Explain EvalReportCmd");
+        expect(ranked[0].filePath).toContain("EvalReportCmd.ts");
+        expect(ranked[0].reasons).toEqual(expect.arrayContaining(["exact-basename:evalreportcmd"]));
+    });
+    it("boosts likely owner files for method-selection questions", () => {
+        const ranked = rankAgentSearchHits([
+            "/repo/cli/src/agent/policy/readinessPolicy.ts",
+            "/repo/cli/src/agent/runtime/runAgentLoop.ts",
+        ], {}, "Which file decides whether the runtime should read or triage next?");
+        expect(ranked[0].filePath).toContain("readinessPolicy.ts");
+        expect(ranked[0].reasons.some((reason) => reason.startsWith("method-owner:"))).toBe(true);
+    });
+    it("prefers specific loop-limit evidence over generic agent matches", () => {
+        const ranked = rankAgentSearchHits([
+            "/repo/cli/src/agent/state/memory.ts",
+            "/repo/cli/src/agents/MainAgent.ts",
+        ], {}, "where do I set the max count for how many loops the agent can run?", [
+            {
+                filePath: "/repo/cli/src/agent/state/memory.ts",
+                line: 40,
+                snippet: "  maxTurns: 12,",
+                matchKind: "semantic-content",
+                reasons: ["term:maxTurns", "term:turnCount"],
+            },
+            {
+                filePath: "/repo/cli/src/agents/MainAgent.ts",
+                line: 1,
+                snippet: "export class MainAgent {}",
+                matchKind: "semantic-content",
+                reasons: ["term:agent"],
+            },
+        ]);
+        expect(ranked[0].filePath).toContain("memory.ts");
+        expect(ranked[0].reasons.some((reason) => reason.startsWith("match-confirmation:"))).toBe(true);
+    });
+    it("does not let repeated weak max matches outrank the stronger owner file", () => {
+        const ranked = rankAgentSearchHits([
+            "/repo/cli/src/config.ts",
+            "/repo/cli/src/agent/state/memory.ts",
+        ], {}, "where do I set the max count for how many loops the agent can run?", [
+            {
+                filePath: "/repo/cli/src/config.ts",
+                line: 12,
+                snippet: "export const maxOutputTokens = 2000;",
+                matchKind: "semantic-content",
+                reasons: ["term:max"],
+            },
+            {
+                filePath: "/repo/cli/src/config.ts",
+                line: 18,
+                snippet: "export const transformMaxFileLines = 120;",
+                matchKind: "semantic-content",
+                reasons: ["term:max"],
+            },
+            {
+                filePath: "/repo/cli/src/agent/state/memory.ts",
+                line: 40,
+                snippet: "  maxTurns: 12,",
+                matchKind: "semantic-content",
+                reasons: ["term:maxTurns", "term:turnCount"],
+            },
+        ]);
+        expect(ranked[0].filePath).toContain("memory.ts");
+        expect(ranked[0].reasons.some((reason) => reason.startsWith("match-confirmation:"))).toBe(true);
+    });
+    it("prefers test entrypoint files over generic agent files for shell-content matches", () => {
+        const ranked = rankAgentSearchHits([
+            "/repo/cli/src/testing/registerDevCliCommands.ts",
+            "/repo/cli/src/testing/testCommands.ts",
+            "/repo/cli/src/agent/feedback/index.ts",
+        ], {}, "How does this repo run tests and where are the test entry points configured?", [
+            {
+                filePath: "/repo/cli/src/testing/registerDevCliCommands.ts",
+                line: 26,
+                snippet: " *   scai tests",
+                matchKind: "shell-content",
+                reasons: ["term:test", "term:tests"],
+            },
+            {
+                filePath: "/repo/cli/src/testing/registerDevCliCommands.ts",
+                line: 42,
+                snippet: "export function registerDevCliCommands(",
+                matchKind: "shell-content",
+                reasons: ["term:register"],
+            },
+            {
+                filePath: "/repo/cli/src/testing/testCommands.ts",
+                line: 20,
+                snippet: " * Registers test and integration shell commands.",
+                matchKind: "shell-content",
+                reasons: ["term:test", "term:entry"],
+            },
+            {
+                filePath: "/repo/cli/src/agent/feedback/index.ts",
+                line: 4,
+                snippet: " * Why this file exists:",
+                matchKind: "shell-content",
+                reasons: ["term:test"],
+            },
+        ], ["test", "tests", "entry", "register", "command"]);
+        expect(ranked[0].filePath).toContain("registerDevCliCommands.ts");
+        expect(ranked[1].filePath).toContain("testCommands.ts");
+        expect(ranked[2].filePath).toContain("agent/feedback/index.ts");
+    });
+    it("keeps the agent adapter in lockstep with the shared scorer", () => {
+        const filePaths = [
+            "/repo/cli/src/agent/policy/readinessPolicy.ts",
+            "/repo/cli/src/agent/runtime/runAgentLoop.ts",
+            "/repo/cli/src/commands/EvalReportCmd.ts",
+        ];
+        const relatedFileScores = {
+            "/repo/cli/src/agent/policy/readinessPolicy.ts": -4,
+            "/repo/cli/src/agent/runtime/runAgentLoop.ts": -2,
+        };
+        const query = "Which file decides whether EvalReportCmd should read or triage next?";
+        const shared = scoreCandidateFiles(filePaths, relatedFileScores, query, {
+            hintTerms: [],
+        });
+        const agent = rankAgentSearchHits(filePaths, relatedFileScores, query, [], []);
+        expect(agent).toEqual(shared);
+    });
+});
+//# sourceMappingURL=agentSearchRanking.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agentSearchRanking.test.js","sourceRoot":"","sources":["../../../src/__tests__/agents/agentSearchRanking.test.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Covers search-owned ranking behavior for the modular agent runtime.\n *\n * Why this file exists:\n * - the agent adapter should stay aligned with the shared scorer\n * - ranking changes should be proven without depending on read or runtime policy\n * - score reasons should stay explicit when candidate ordering changes\n */\nimport { describe, expect, it } from \"vitest\";\nimport { rankAgentSearchHits } from \"../../agent/search/ranking.js\";\nimport { scoreCandidateFiles } from \"../../search/sharedRankingPolicy.js\";\n\ndescribe(\"rankAgentSearchHits\", () => {\n  it(\"prefers exact filename anchors over generic workflow files\", () => {\n    const ranked = rankAgentSearchHits(\n      [\n        \"/repo/cli/src/commands/EvalReportCmd.ts\",\n        \"/repo/cli/src/agents/MainAgent.ts\",\n      ],\n      {},\n      \"Explain EvalReportCmd\"\n    );\n\n    expect(ranked[0].filePath).toContain(\"EvalReportCmd.ts\");\n    expect(ranked[0].reasons).toEqual(expect.arrayContaining([\"exact-basename:evalreportcmd\"]));\n  });\n\n  it(\"boosts likely owner files for method-selection questions\", () => {\n    const ranked = rankAgentSearchHits(\n      [\n        \"/repo/cli/src/agent/policy/readinessPolicy.ts\",\n        \"/repo/cli/src/agent/runtime/runAgentLoop.ts\",\n      ],\n      {},\n      \"Which file decides whether the runtime should read or triage next?\"\n    );\n\n    expect(ranked[0].filePath).toContain(\"readinessPolicy.ts\");\n    expect(ranked[0].reasons.some((reason) => reason.startsWith(\"method-owner:\"))).toBe(true);\n  });\n\n  it(\"prefers specific loop-limit evidence over generic agent matches\", () => {\n    const ranked = rankAgentSearchHits(\n      [\n        \"/repo/cli/src/agent/state/memory.ts\",\n        \"/repo/cli/src/agents/MainAgent.ts\",\n      ],\n      {},\n      \"where do I set the max count for how many loops the agent can run?\",\n      [\n        {\n          filePath: \"/repo/cli/src/agent/state/memory.ts\",\n          line: 40,\n          snippet: \"  maxTurns: 12,\",\n          matchKind: \"semantic-content\",\n          reasons: [\"term:maxTurns\", \"term:turnCount\"],\n        },\n        {\n          filePath: \"/repo/cli/src/agents/MainAgent.ts\",\n          line: 1,\n          snippet: \"export class MainAgent {}\",\n          matchKind: \"semantic-content\",\n          reasons: [\"term:agent\"],\n        },\n      ]\n    );\n\n    expect(ranked[0].filePath).toContain(\"memory.ts\");\n    expect(ranked[0].reasons.some((reason) => reason.startsWith(\"match-confirmation:\"))).toBe(true);\n  });\n\n  it(\"does not let repeated weak max matches outrank the stronger owner file\", () => {\n    const ranked = rankAgentSearchHits(\n      [\n        \"/repo/cli/src/config.ts\",\n        \"/repo/cli/src/agent/state/memory.ts\",\n      ],\n      {},\n      \"where do I set the max count for how many loops the agent can run?\",\n      [\n        {\n          filePath: \"/repo/cli/src/config.ts\",\n          line: 12,\n          snippet: \"export const maxOutputTokens = 2000;\",\n          matchKind: \"semantic-content\",\n          reasons: [\"term:max\"],\n        },\n        {\n          filePath: \"/repo/cli/src/config.ts\",\n          line: 18,\n          snippet: \"export const transformMaxFileLines = 120;\",\n          matchKind: \"semantic-content\",\n          reasons: [\"term:max\"],\n        },\n        {\n          filePath: \"/repo/cli/src/agent/state/memory.ts\",\n          line: 40,\n          snippet: \"  maxTurns: 12,\",\n          matchKind: \"semantic-content\",\n          reasons: [\"term:maxTurns\", \"term:turnCount\"],\n        },\n      ]\n    );\n\n    expect(ranked[0].filePath).toContain(\"memory.ts\");\n    expect(ranked[0].reasons.some((reason) => reason.startsWith(\"match-confirmation:\"))).toBe(true);\n  });\n\n  it(\"prefers test entrypoint files over generic agent files for shell-content matches\", () => {\n    const ranked = rankAgentSearchHits(\n      [\n        \"/repo/cli/src/testing/registerDevCliCommands.ts\",\n        \"/repo/cli/src/testing/testCommands.ts\",\n        \"/repo/cli/src/agent/feedback/index.ts\",\n      ],\n      {},\n      \"How does this repo run tests and where are the test entry points configured?\",\n      [\n        {\n          filePath: \"/repo/cli/src/testing/registerDevCliCommands.ts\",\n          line: 26,\n          snippet: \" *   scai tests\",\n          matchKind: \"shell-content\",\n          reasons: [\"term:test\", \"term:tests\"],\n        },\n        {\n          filePath: \"/repo/cli/src/testing/registerDevCliCommands.ts\",\n          line: 42,\n          snippet: \"export function registerDevCliCommands(\",\n          matchKind: \"shell-content\",\n          reasons: [\"term:register\"],\n        },\n        {\n          filePath: \"/repo/cli/src/testing/testCommands.ts\",\n          line: 20,\n          snippet: \" * Registers test and integration shell commands.\",\n          matchKind: \"shell-content\",\n          reasons: [\"term:test\", \"term:entry\"],\n        },\n        {\n          filePath: \"/repo/cli/src/agent/feedback/index.ts\",\n          line: 4,\n          snippet: \" * Why this file exists:\",\n          matchKind: \"shell-content\",\n          reasons: [\"term:test\"],\n        },\n      ],\n      [\"test\", \"tests\", \"entry\", \"register\", \"command\"]\n    );\n\n    expect(ranked[0].filePath).toContain(\"registerDevCliCommands.ts\");\n    expect(ranked[1].filePath).toContain(\"testCommands.ts\");\n    expect(ranked[2].filePath).toContain(\"agent/feedback/index.ts\");\n  });\n\n  it(\"keeps the agent adapter in lockstep with the shared scorer\", () => {\n    const filePaths = [\n      \"/repo/cli/src/agent/policy/readinessPolicy.ts\",\n      \"/repo/cli/src/agent/runtime/runAgentLoop.ts\",\n      \"/repo/cli/src/commands/EvalReportCmd.ts\",\n    ];\n    const relatedFileScores = {\n      \"/repo/cli/src/agent/policy/readinessPolicy.ts\": -4,\n      \"/repo/cli/src/agent/runtime/runAgentLoop.ts\": -2,\n    };\n    const query = \"Which file decides whether EvalReportCmd should read or triage next?\";\n\n    const shared = scoreCandidateFiles(filePaths, relatedFileScores, query, {\n      hintTerms: [],\n    });\n    const agent = rankAgentSearchHits(filePaths, relatedFileScores, query, [], []);\n\n    expect(agent).toEqual(shared);\n  });\n});\n"]}