scai 0.1.178 → 1.0.0

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

@@ -0,0 +1,207 @@
+/**
+ * Verifies the shared outer-loop evaluator chooses retarget, expansion, and redo deterministically.
+ */
+import { describe, expect, it } from "vitest";
+import { evaluateOuterLoopRecovery } from "../../agents/outerLoopRecoveryEvaluator.js";
+describe("outerLoopRecoveryEvaluator", () => {
+    it("returns rework-scope when a quick read shows the target is the wrong shape", () => {
+        const targetFile = "/repo/README.md";
+        const context = {
+            task: {
+                status: "active",
+                steps: [],
+                currentStep: {
+                    taskId: 1,
+                    filePath: targetFile,
+                    status: "pending",
+                },
+            },
+            initContext: {
+                userQuery: "Refactor MainAgent.ts to reduce nesting",
+            },
+            analysis: {
+                intent: {
+                    normalizedQuery: "Refactor MainAgent.ts to reduce nesting",
+                    resolvedTargetFiles: [targetFile],
+                },
+                focus: {
+                    executionLock: {
+                        enabled: true,
+                        files: [targetFile],
+                    },
+                },
+                progressState: {
+                    optionalTargets: [],
+                    completion: {
+                        eligible: false,
+                    },
+                },
+                readResults: {
+                    byFile: {
+                        [targetFile]: {
+                            status: "ok",
+                            fileKind: "markdown",
+                            facts: [],
+                            missingFacts: ["MainAgent"],
+                            snippets: [],
+                            queryFit: {
+                                judgment: "wrong-shape",
+                                rationale: "The query is code-focused, but this file is markdown-shaped.",
+                            },
+                            confidence: 0.2,
+                            readAt: "now",
+                        },
+                    },
+                },
+            },
+        };
+        const evaluation = evaluateOuterLoopRecovery({
+            context,
+            sourceAction: "read-file",
+            targetFile,
+        });
+        expect(evaluation.decision).toBe("rework-scope");
+        expect(evaluation.reason).toContain("wrong file shape");
+    });
+    it("returns expand-scope when the current target fits but nearby evidence is still needed", () => {
+        const targetFile = "/repo/cli/package.json";
+        const context = {
+            task: {
+                status: "active",
+                steps: [],
+                currentStep: {
+                    taskId: 1,
+                    filePath: targetFile,
+                    status: "pending",
+                },
+            },
+            initContext: {
+                userQuery: "Bump the package version",
+            },
+            analysis: {
+                intent: {
+                    normalizedQuery: "Bump the package version",
+                    resolvedTargetFiles: [targetFile],
+                },
+                focus: {
+                    executionLock: {
+                        enabled: true,
+                        files: [targetFile],
+                    },
+                },
+                progressState: {
+                    optionalTargets: ["/repo/cli/package-lock.json"],
+                    completion: {
+                        eligible: false,
+                    },
+                },
+                readResults: {
+                    byFile: {
+                        [targetFile]: {
+                            status: "ok",
+                            fileKind: "package-json",
+                            facts: [
+                                { key: "name", found: true, value: "scai" },
+                            ],
+                            missingFacts: ["version"],
+                            snippets: ["\"name\": scai"],
+                            queryFit: {
+                                judgment: "partial",
+                                rationale: "The query points at package-shaped files directly.",
+                            },
+                            confidence: 0.72,
+                            readAt: "now",
+                        },
+                    },
+                },
+            },
+        };
+        const evaluation = evaluateOuterLoopRecovery({
+            context,
+            sourceAction: "read-file",
+            targetFile,
+        });
+        expect(evaluation.decision).toBe("expand-scope");
+    });
+    it("returns redo-step when validation says the current target needs another pass", () => {
+        const targetFile = "/repo/cli/package.json";
+        const context = {
+            task: {
+                status: "active",
+                steps: [],
+                currentStep: {
+                    taskId: 1,
+                    filePath: targetFile,
+                    status: "pending",
+                },
+            },
+            initContext: {
+                userQuery: "Bump the package version",
+            },
+            analysis: {
+                executionOutcome: {
+                    validations: [
+                        {
+                            filePath: targetFile,
+                            actualChange: "wrong version string",
+                            status: "invalid",
+                            requiresRedo: true,
+                        },
+                    ],
+                },
+                progressState: {
+                    optionalTargets: [],
+                    completion: {
+                        eligible: false,
+                    },
+                },
+            },
+        };
+        const evaluation = evaluateOuterLoopRecovery({
+            context,
+            sourceAction: "codeTransform",
+            targetFile,
+        });
+        expect(evaluation.decision).toBe("redo-step");
+    });
+    it("ignores research pseudo-paths when evaluating recovery", () => {
+        const context = {
+            task: {
+                status: "active",
+                steps: [],
+                currentStep: {
+                    taskId: 1,
+                    filePath: "__research__/impact-map-0",
+                    status: "pending",
+                    action: "research-impact-map",
+                },
+            },
+            analysis: {
+                intent: {
+                    normalizedQuery: "Trace routing decisions.",
+                    resolvedTargetFiles: ["/repo/cli/src/agents/MainAgent.ts"],
+                },
+                focus: {
+                    executionLock: {
+                        enabled: true,
+                        files: ["/repo/cli/src/agents/MainAgent.ts"],
+                    },
+                },
+                progressState: {
+                    optionalTargets: [],
+                    completion: {
+                        eligible: false,
+                    },
+                },
+            },
+        };
+        const evaluation = evaluateOuterLoopRecovery({
+            context,
+            sourceAction: "research-impact-map",
+            targetFile: "__research__/impact-map-0",
+        });
+        expect(evaluation.decision).toBe("continue");
+        expect(evaluation.targetFile).toBeUndefined();
+    });
+});
+//# sourceMappingURL=outerLoopRecoveryEvaluator.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"outerLoopRecoveryEvaluator.test.js","sourceRoot":"","sources":["../../../src/__tests__/agents/outerLoopRecoveryEvaluator.test.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Verifies the shared outer-loop evaluator chooses retarget, expansion, and redo deterministically.\n */\nimport { describe, expect, it } from \"vitest\";\nimport { evaluateOuterLoopRecovery } from \"../../agents/outerLoopRecoveryEvaluator.js\";\n\ndescribe(\"outerLoopRecoveryEvaluator\", () => {\n    it(\"returns rework-scope when a quick read shows the target is the wrong shape\", () => {\n        const targetFile = \"/repo/README.md\";\n        const context = {\n            task: {\n                status: \"active\",\n                steps: [],\n                currentStep: {\n                    taskId: 1,\n                    filePath: targetFile,\n                    status: \"pending\",\n                },\n            },\n            initContext: {\n                userQuery: \"Refactor MainAgent.ts to reduce nesting\",\n            },\n            analysis: {\n                intent: {\n                    normalizedQuery: \"Refactor MainAgent.ts to reduce nesting\",\n                    resolvedTargetFiles: [targetFile],\n                },\n                focus: {\n                    executionLock: {\n                        enabled: true,\n                        files: [targetFile],\n                    },\n                },\n                progressState: {\n                    optionalTargets: [],\n                    completion: {\n                        eligible: false,\n                    },\n                },\n                readResults: {\n                    byFile: {\n                        [targetFile]: {\n                            status: \"ok\",\n                            fileKind: \"markdown\",\n                            facts: [],\n                            missingFacts: [\"MainAgent\"],\n                            snippets: [],\n                            queryFit: {\n                                judgment: \"wrong-shape\",\n                                rationale: \"The query is code-focused, but this file is markdown-shaped.\",\n                            },\n                            confidence: 0.2,\n                            readAt: \"now\",\n                        },\n                    },\n                },\n            },\n        } as any;\n\n        const evaluation = evaluateOuterLoopRecovery({\n            context,\n            sourceAction: \"read-file\",\n            targetFile,\n        });\n\n        expect(evaluation.decision).toBe(\"rework-scope\");\n        expect(evaluation.reason).toContain(\"wrong file shape\");\n    });\n\n    it(\"returns expand-scope when the current target fits but nearby evidence is still needed\", () => {\n        const targetFile = \"/repo/cli/package.json\";\n        const context = {\n            task: {\n                status: \"active\",\n                steps: [],\n                currentStep: {\n                    taskId: 1,\n                    filePath: targetFile,\n                    status: \"pending\",\n                },\n            },\n            initContext: {\n                userQuery: \"Bump the package version\",\n            },\n            analysis: {\n                intent: {\n                    normalizedQuery: \"Bump the package version\",\n                    resolvedTargetFiles: [targetFile],\n                },\n                focus: {\n                    executionLock: {\n                        enabled: true,\n                        files: [targetFile],\n                    },\n                },\n                progressState: {\n                    optionalTargets: [\"/repo/cli/package-lock.json\"],\n                    completion: {\n                        eligible: false,\n                    },\n                },\n                readResults: {\n                    byFile: {\n                        [targetFile]: {\n                            status: \"ok\",\n                            fileKind: \"package-json\",\n                            facts: [\n                                { key: \"name\", found: true, value: \"scai\" },\n                            ],\n                            missingFacts: [\"version\"],\n                            snippets: [\"\\\"name\\\": scai\"],\n                            queryFit: {\n                                judgment: \"partial\",\n                                rationale: \"The query points at package-shaped files directly.\",\n                            },\n                            confidence: 0.72,\n                            readAt: \"now\",\n                        },\n                    },\n                },\n            },\n        } as any;\n\n        const evaluation = evaluateOuterLoopRecovery({\n            context,\n            sourceAction: \"read-file\",\n            targetFile,\n        });\n\n        expect(evaluation.decision).toBe(\"expand-scope\");\n    });\n\n    it(\"returns redo-step when validation says the current target needs another pass\", () => {\n        const targetFile = \"/repo/cli/package.json\";\n        const context = {\n            task: {\n                status: \"active\",\n                steps: [],\n                currentStep: {\n                    taskId: 1,\n                    filePath: targetFile,\n                    status: \"pending\",\n                },\n            },\n            initContext: {\n                userQuery: \"Bump the package version\",\n            },\n            analysis: {\n                executionOutcome: {\n                    validations: [\n                        {\n                            filePath: targetFile,\n                            actualChange: \"wrong version string\",\n                            status: \"invalid\",\n                            requiresRedo: true,\n                        },\n                    ],\n                },\n                progressState: {\n                    optionalTargets: [],\n                    completion: {\n                        eligible: false,\n                    },\n                },\n            },\n        } as any;\n\n        const evaluation = evaluateOuterLoopRecovery({\n            context,\n            sourceAction: \"codeTransform\",\n            targetFile,\n        });\n\n        expect(evaluation.decision).toBe(\"redo-step\");\n    });\n\n    it(\"ignores research pseudo-paths when evaluating recovery\", () => {\n        const context = {\n            task: {\n                status: \"active\",\n                steps: [],\n                currentStep: {\n                    taskId: 1,\n                    filePath: \"__research__/impact-map-0\",\n                    status: \"pending\",\n                    action: \"research-impact-map\",\n                },\n            },\n            analysis: {\n                intent: {\n                    normalizedQuery: \"Trace routing decisions.\",\n                    resolvedTargetFiles: [\"/repo/cli/src/agents/MainAgent.ts\"],\n                },\n                focus: {\n                    executionLock: {\n                        enabled: true,\n                        files: [\"/repo/cli/src/agents/MainAgent.ts\"],\n                    },\n                },\n                progressState: {\n                    optionalTargets: [],\n                    completion: {\n                        eligible: false,\n                    },\n                },\n            },\n        } as any;\n\n        const evaluation = evaluateOuterLoopRecovery({\n            context,\n            sourceAction: \"research-impact-map\",\n            targetFile: \"__research__/impact-map-0\",\n        });\n\n        expect(evaluation.decision).toBe(\"continue\");\n        expect(evaluation.targetFile).toBeUndefined();\n    });\n});\n"]}

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

@@ -0,0 +1,363 @@
+/**
+ * Covers prompt ownership under `cli/src/agent/prompting/**`.
+ *
+ * Why this file exists:
+ * - stage 1 moves prompt code to one direct owner path
+ * - packet shaping and prompt rendering should stay stable through that move
+ * - direct tests make it safe to delete the old prompt entrypoints
+ */
+import { describe, expect, it } from "vitest";
+import { createAgentMemory } from "../../agent/state/memory.js";
+import { buildActionChoicePacket, buildFinalAnswerPacket, buildPlanPacket, buildTransformPlanPrompt, buildTransformValidationPrompt, renderActionChoicePrompt, renderFinalAnswerPrompt, renderPlanPrompt, renderUnderstandPrompt, } from "../../agent/prompting/index.js";
+describe("new-agent prompt owners", () => {
+    it("builds a compact action-choice packet", () => {
+        const memory = createAgentMemory("Explain sample.ts", "/repo", "/repo");
+        memory.task.normalizedQuery = "Explain sample.ts";
+        memory.task.primaryIntent = "Explain the sample file.";
+        memory.resumeCheckpoint = {
+            finalAnswer: "sample.ts owns the answer path.",
+            finalAnswerPacket: {
+                normalizedQuery: "Explain sample.ts",
+                primaryIntent: "Explain the sample file.",
+                queryScope: "targeted",
+                explicitTargets: ["/repo/sample.ts"],
+                groundedPrimaryFiles: [],
+                groundedSupportingFiles: [],
+                mustMentionFiles: ["/repo/sample.ts"],
+                mustMentionSymbols: ["sampleAnswer"],
+                mustMentionFacts: ["Exact target phrase: Sample Answer Module"],
+            },
+            sourceTurnIndex: 1,
+            sourceUserQuery: "Explain sample.ts",
+        };
+        memory.evidence.candidateFiles = ["/repo/sample.ts"];
+        memory.evidence.fileReads["/repo/sample.ts"] = {
+            filePath: "/repo/sample.ts",
+            readMode: "full",
+            summary: "Summary",
+            snippets: ["snippet"],
+            matchedTerms: ["sample"],
+            relevantContext: [{ kind: "purpose", text: "context" }],
+            recordedAt: new Date(0).toISOString(),
+        };
+        const packet = buildActionChoicePacket(memory, {
+            allowedActions: ["read-file", "final-answer"],
+            hasUsefulEvidence: true,
+            loopReview: {
+                groundingStatus: "partial",
+                queryShape: "targeted",
+                requiredGroundedCoverage: 1,
+                groundedCoverageCount: 1,
+                targetCoverage: {
+                    explicitTargetCount: 1,
+                    groundedExplicitTargetCount: 1,
+                    groundedExplicitTargets: ["/repo/sample.ts"],
+                    missingExplicitTargets: [],
+                    allExplicitTargetsGrounded: true,
+                },
+                groundedFiles: [],
+                discoveredSoFar: {
+                    targetFacts: ["sample.ts: Summary"],
+                    supportingFacts: [],
+                    missingGaps: [],
+                },
+                topUnreadCandidates: [],
+                followupSignals: [],
+                recentProgress: {
+                    recentReadCount: 1,
+                    targetLinkedReadCount: 1,
+                    newTargetLinkedFactCount: 1,
+                    stalled: false,
+                    reason: "Recent reads still add grounded facts.",
+                },
+                expansionAssessment: {
+                    shouldExpand: false,
+                    reason: "No unread follow-up candidate is strong enough to justify another read.",
+                },
+                driftAssessment: {
+                    status: "on-track",
+                    blocksExpansion: false,
+                    reason: "No unread follow-up remains.",
+                },
+                multiFileStatus: {
+                    required: false,
+                    groundedOwnerCount: 0,
+                    hasUnreadDistinctOwner: false,
+                },
+                stopAssessment: {
+                    canStop: false,
+                    stopRisk: "medium",
+                    reason: "Need one more grounded read.",
+                },
+                referenceFollowupNeeded: false,
+            },
+            shouldReplan: false,
+            reason: "Ready to answer.",
+            primaryAmbiguousTarget: undefined,
+            shouldAskUser: false,
+            decision: { reason: "Ready to answer.", nextAction: "final-answer" },
+        });
+        expect(packet).toEqual(expect.objectContaining({
+            normalizedQuery: "Explain sample.ts",
+            legalActions: ["read-file", "final-answer"],
+            loopReview: expect.objectContaining({
+                groundingStatus: "partial",
+            }),
+            policy: expect.objectContaining({
+                hasUsefulEvidence: true,
+            }),
+            latestGroundedResult: expect.objectContaining({
+                sourceTurnIndex: 1,
+                mustMentionFiles: ["/repo/sample.ts"],
+            }),
+        }));
+    });
+    it("renders action-choice prompt from the owned packet", () => {
+        expect(renderActionChoicePrompt({
+            legalActions: ["search-db", "final-answer"],
+            normalizedQuery: "Explain sample.ts",
+            loopReview: {
+                groundingStatus: "partial",
+            },
+        })).toContain("Review the loopReview packet");
+        expect(renderActionChoicePrompt({
+            legalActions: ["search-db", "final-answer"],
+            normalizedQuery: "Explain sample.ts",
+            loopReview: {
+                groundingStatus: "partial",
+            },
+        })).toContain("Use discoveredSoFar to decide whether the requested files already support the answer.");
+    });
+    it("renders general-scope understand guidance and final-answer fallback", () => {
+        const understandPrompt = renderUnderstandPrompt("how do I use git bash to save a diff?");
+        expect(understandPrompt).toContain('how do I use git bash to save a diff?');
+        expect(understandPrompt).toContain("git diff, bash, npm test, and docker build are not repo anchors by themselves");
+        const finalAnswerPrompt = renderFinalAnswerPrompt({
+            normalizedQuery: "how do I use git bash to save a diff?",
+            primaryIntent: "Answer a general Git usage question.",
+            queryScope: "general",
+            explicitTargets: [],
+            groundedPrimaryFiles: [],
+            groundedSupportingFiles: [],
+            fileReads: [],
+            mustMentionFiles: [],
+            mustMentionSymbols: [],
+            mustMentionFacts: [],
+        });
+        expect(finalAnswerPrompt).toContain("Answer the user from general knowledge.");
+        expect(finalAnswerPrompt).toContain("Do not mention missing grounded files or missing repo evidence.");
+        expect(finalAnswerPrompt).not.toContain("Answer the user using only the grounded evidence in the packet.");
+    });
+    it("renders planner action enums from the current legal menu", () => {
+        const memory = createAgentMemory("Clarify sample.ts", "/repo", "/repo");
+        memory.task.normalizedQuery = "Clarify sample.ts";
+        memory.task.primaryIntent = "Ask the user to clarify the target.";
+        const prompt = renderPlanPrompt(buildPlanPacket(memory, ["request-user-input", "plan"]));
+        expect(prompt).toContain('"action": "plan | search-db | search-regex | search-list-directory | triage-file | read-file | codeTransform | final-answer"');
+        expect(prompt).toContain("Create a small ordered plan");
+    });
+    it("builds a strict grounded final-answer packet", () => {
+        const memory = createAgentMemory("Explain sample.ts", "/repo", "/repo");
+        memory.task.normalizedQuery = "Explain sample.ts";
+        memory.task.primaryIntent = "Explain the sample file.";
+        memory.task.explicitTargets = ["/repo/sample.ts"];
+        memory.task.hardFileTargets = ["/repo/sample.ts"];
+        memory.evidence.candidateMetadata = {
+            "/repo/sample.ts": {
+                searchScore: 12,
+                searchReasons: ["path-anchor", "match-confirmation:sampleAnswer"],
+                readPriority: 14,
+            },
+            "/repo/unread.ts": {
+                searchScore: 99,
+                searchReasons: ["path-anchor", "symbol:UnreadThing:filename"],
+                readPriority: 99,
+            },
+        };
+        memory.evidence.fileReads["/repo/sample.ts"] = {
+            filePath: "/repo/sample.ts",
+            readMode: "full",
+            summary: "Summary",
+            snippets: ["snippet"],
+            keySymbols: ["sampleAnswer"],
+            excerpts: [
+                {
+                    description: "Sample answer symbol.",
+                    startLine: 10,
+                    endLine: 12,
+                    symbols: ["sampleAnswer", "sampleHelper"],
+                    code: "export const sampleAnswer = sampleHelper();",
+                },
+            ],
+            matchedTerms: ["sample"],
+            relevanceExplanation: "This file defines the grounded answer path.",
+            relevantContext: [{ kind: "purpose", text: "context" }],
+            strengthSignals: {
+                exactTargetPhrases: ["Sample Answer Module"],
+                implementationSymbols: ["buildSampleAnswer"],
+                directAnswerFacts: [],
+                strongestConceptExcerpt: {
+                    description: "Sample answer symbol.",
+                    startLine: 10,
+                    endLine: 12,
+                    symbols: ["sampleAnswer", "sampleHelper"],
+                },
+                strongestImplementationExcerpt: {
+                    description: "Sample answer symbol.",
+                    startLine: 10,
+                    endLine: 12,
+                    symbols: ["sampleAnswer", "sampleHelper"],
+                },
+            },
+            recordedAt: new Date(0).toISOString(),
+        };
+        memory.evidence.fileReads["/repo/support.ts"] = {
+            filePath: "/repo/support.ts",
+            readMode: "full",
+            summary: "Support summary",
+            snippets: ["support snippet"],
+            keySymbols: ["supportHelper"],
+            excerpts: [
+                {
+                    description: "Support block.",
+                    startLine: 20,
+                    endLine: 26,
+                    symbols: ["supportHelper"],
+                    code: "cmd.command(\"tests\").description(\"Run the full Vitest suite\");\nexport function supportHelper() {}",
+                },
+            ],
+            matchedTerms: ["support"],
+            relevanceExplanation: "Adds one secondary supporting fact.",
+            relevantContext: [{ kind: "dependency", text: "Depends on supportHelper." }],
+            strengthSignals: {
+                exactTargetPhrases: [],
+                implementationSymbols: ["supportHelper"],
+                directAnswerFacts: ["CLI command: tests"],
+            },
+            recordedAt: new Date(0).toISOString(),
+            role: "supporting",
+        };
+        memory.evidence.fileReads["/repo/cli/package.json"] = {
+            filePath: "/repo/cli/package.json",
+            readMode: "full",
+            summary: "CLI package metadata",
+            snippets: ['4: "scai": "./dist/index.js"'],
+            excerpts: [
+                {
+                    description: "CLI package bin mapping.",
+                    startLine: 3,
+                    endLine: 5,
+                    code: '"bin": {\n  "scai": "./dist/index.js"\n}',
+                },
+            ],
+            matchedTerms: ["cli"],
+            relevantContext: [{ kind: "purpose", text: "Defines the CLI binary name." }],
+            strengthSignals: {
+                exactTargetPhrases: [],
+                implementationSymbols: [],
+                directAnswerFacts: [],
+            },
+            recordedAt: new Date(0).toISOString(),
+            role: "supporting",
+        };
+        const packet = buildFinalAnswerPacket(memory);
+        expect(packet).toEqual(expect.objectContaining({
+            explicitTargets: ["/repo/sample.ts"],
+            groundedPrimaryFiles: expect.arrayContaining([
+                expect.objectContaining({
+                    filePath: "/repo/sample.ts",
+                    keySymbols: ["buildSampleAnswer", "sampleAnswer", "sampleHelper"],
+                    answerFacts: expect.arrayContaining(["Exact target phrase: Sample Answer Module", "context", "Sample answer symbol."]),
+                }),
+                expect.objectContaining({
+                    filePath: "/repo/support.ts",
+                    answerFacts: expect.arrayContaining(["CLI command: tests", "Depends on supportHelper."]),
+                }),
+                expect.objectContaining({
+                    filePath: "/repo/cli/package.json",
+                }),
+            ]),
+            groundedSupportingFiles: [],
+            mustMentionFiles: ["/repo/sample.ts", "/repo/support.ts", "/repo/cli/package.json"],
+            mustMentionSymbols: expect.arrayContaining(["buildSampleAnswer", "sampleAnswer", "sampleHelper", "supportHelper"]),
+            mustMentionFacts: expect.arrayContaining([
+                "Exact target phrase: Sample Answer Module",
+                "CLI command: tests",
+                "CLI command: scai tests",
+                "context",
+            ]),
+        }));
+        expect(JSON.stringify(packet)).not.toContain("/repo/unread.ts");
+        expect(packet.mustMentionSymbols).not.toContain("repo:path");
+        expect(packet.mustMentionFacts).not.toContain("Relevant block near the strongest query match.");
+        const prompt = renderFinalAnswerPrompt(packet);
+        expect(prompt).toContain("Answer the user using only the grounded evidence");
+        expect(prompt).toContain("Use only groundedPrimaryFiles and groundedSupportingFiles as factual support.");
+        expect(prompt).toContain("Name mustMentionFiles when they directly answer the query.");
+        expect(prompt).toContain("Name mustMentionSymbols when they directly answer the query.");
+    });
+    it("renders final-answer prompt with compact latest grounded resume context", () => {
+        const packet = {
+            normalizedQuery: "Explain sample.ts",
+            primaryIntent: "Explain the sample file.",
+            queryScope: "targeted",
+            explicitTargets: ["/repo/sample.ts"],
+            groundedPrimaryFiles: [],
+            groundedSupportingFiles: [],
+            mustMentionFiles: ["/repo/sample.ts"],
+            mustMentionSymbols: ["sampleAnswer"],
+            mustMentionFacts: ["Exact target phrase: Sample Answer Module"],
+        };
+        const prompt = renderFinalAnswerPrompt(packet, {
+            sourceTurnIndex: 2,
+            sourceUserQuery: "Did you check sample.ts?",
+            finalAnswer: "Yes, sample.ts owns the answer path.",
+            mustMentionFiles: ["/repo/sample.ts"],
+            mustMentionSymbols: ["sampleAnswer"],
+            mustMentionFacts: ["Exact target phrase: Sample Answer Module"],
+        });
+        expect(prompt).toContain("latestGroundedResult");
+        expect(prompt).toContain("Do not copy files, symbols, or facts from latestGroundedResult");
+        expect(prompt).toContain("Did you check sample.ts?");
+    });
+    it("keeps understand prompt under the new owner path", () => {
+        const prompt = renderUnderstandPrompt('Find "currentQuestionId = task.currentQuestionId"', {
+            sourceTurnIndex: 2,
+            sourceUserQuery: "Did you check memory.ts?",
+            finalAnswer: "Yes, memory.ts was checked.",
+            mustMentionFiles: ["/repo/cli/src/agent/state/memory.ts"],
+            mustMentionSymbols: ["createAgentMemory"],
+            mustMentionFacts: ["Creates the in-memory runtime state."],
+        });
+        expect(prompt).toContain("Normalize the user request.");
+        expect(prompt).toContain('"queryScope": "targeted | multi-file | broad-repo | general"');
+        expect(prompt).toContain('"ambiguityFlags": ["string"]');
+        expect(prompt).toContain("Each search term group must have a kind: repo-anchor, command-path, or generic.");
+        expect(prompt).toContain("For code-location, config, owner, or entrypoint questions, include at least one repo-anchor group.");
+        expect(prompt).toContain("Resumed context:");
+        expect(prompt).toContain("Do not treat resumed context as fresh grounding for the current turn.");
+        expect(prompt).toContain("Good example for a test-entry query:");
+        expect(prompt).toContain("registerDevCliCommands");
+        expect(prompt).toContain("Bad example for the same query:");
+    });
+    it("keeps transform planning and validation prompt builders under one owner", () => {
+        const planPrompt = buildTransformPlanPrompt("Refactor sample.ts", "/repo/sample.ts", "const value = 1;\n", '{"index":0,"description":"excerpt"}');
+        expect(planPrompt).toContain("Create one full-file transform plan");
+        const validationPrompt = buildTransformValidationPrompt("Refactor sample.ts", {
+            filePath: "/repo/sample.ts",
+            originalContent: "const value = 1;\n",
+            latestContent: "const value = 1;\n",
+            plan: {
+                filePath: "/repo/sample.ts",
+                excerpts: [{ description: "excerpt", code: "const value = 1;\n" }],
+                edits: [{ id: "edit-1", order: 1, action: "rename", summary: "Rename value.", status: "pending" }],
+            },
+            completedEditIds: [],
+            failedEditIds: [],
+            retryCounts: {},
+            validationResults: [],
+        }, { editIds: ["edit-1"], retryCount: 0 }, "const renamed = 1;\n");
+        expect(validationPrompt).toContain("Validate one transform batch against the plan memory.");
+    });
+});
+//# sourceMappingURL=prompting.test.js.map