scai 0.1.178 → 1.0.0

package/dist/pipeline/modules/readFileModule.js

@@ -0,0 +1,300 @@
+/**
+ * Runs one cheap structured read over an already-loaded file.
+ *
+ * Why this file exists:
+ * - keep quick file inspection separate from raw file loading
+ * - let the inner loop gather compact facts without doing full semantic analysis
+ * - give the outer loop a small evidence packet it can evaluate against the objective
+ */
+import path from "path";
+import { logInputOutput } from "../../utils/promptLogHelper.js";
+import { computeContentFingerprint, computeQueryFingerprint, hasFreshReadResult, } from "../../utils/fileEvidenceCache.js";
+const MAX_SNIPPETS = 3;
+const MAX_SNIPPET_CHARS = 120;
+export const readFileModule = {
+    name: "read-file",
+    description: "Inspects one already-loaded file and returns compact findings only.",
+    groups: ["analysis"],
+    async run(input) {
+        var _a;
+        const context = input.context;
+        if (!context) {
+            throw new Error("[read-file] Missing context.");
+        }
+        const step = context.currentStep;
+        const actionArgs = (input.data ?? {});
+        const targetFile = typeof actionArgs.target === "string" && actionArgs.target.trim().length > 0
+            ? actionArgs.target.trim()
+            : step?.targetFile;
+        const expectedFacts = normalizeExpectedFacts(actionArgs.expectedFacts);
+        const mode = typeof actionArgs.mode === "string" && actionArgs.mode.trim().length > 0
+            ? actionArgs.mode.trim()
+            : "quick-read";
+        const workingFile = targetFile
+            ? (context.workingFiles ?? []).find((file) => file.path === targetFile)
+            : undefined;
+        context.analysis || (context.analysis = {});
+        (_a = context.analysis).readResults || (_a.readResults = { byFile: {} });
+        const cachedResult = targetFile ? context.analysis.readResults.byFile[targetFile] : undefined;
+        if (hasFreshReadResult({
+            result: cachedResult,
+            file: workingFile,
+            query: input.query,
+            expectedFacts,
+            mode,
+        })) {
+            logInputOutput("read-file", "output", {
+                targetFile: targetFile ?? null,
+                mode,
+                status: cachedResult?.status,
+                fileKind: cachedResult?.fileKind,
+                facts: cachedResult?.facts,
+                missingFacts: cachedResult?.missingFacts,
+                snippets: cachedResult?.snippets,
+                queryFit: cachedResult?.queryFit,
+                confidence: cachedResult?.confidence,
+                readAt: cachedResult?.readAt,
+                callId: cachedResult?.callId,
+                reusedFromCache: true,
+            });
+            return {
+                query: input.query,
+                data: {
+                    readResult: cachedResult,
+                    notes: "Quick read reused cached result",
+                },
+                context,
+            };
+        }
+        const result = buildReadResult({
+            context,
+            targetFile,
+            query: input.query,
+            expectedFacts,
+            mode,
+            callId: input.trace?.callId,
+        });
+        if (targetFile) {
+            context.analysis.readResults.byFile[targetFile] = result;
+        }
+        logInputOutput("read-file", "output", {
+            targetFile: targetFile ?? null,
+            mode,
+            status: result.status,
+            fileKind: result.fileKind,
+            facts: result.facts,
+            missingFacts: result.missingFacts,
+            snippets: result.snippets,
+            queryFit: result.queryFit,
+            confidence: result.confidence,
+            readAt: result.readAt,
+            callId: result.callId,
+        });
+        return {
+            query: input.query,
+            data: {
+                readResult: result,
+            },
+        };
+    },
+};
+function buildReadResult(args) {
+    const readAt = new Date().toISOString();
+    const queryFingerprint = computeQueryFingerprint(args.query);
+    if (!args.targetFile) {
+        return {
+            status: "error",
+            fileKind: "unknown",
+            facts: [],
+            missingFacts: ["target"],
+            snippets: [],
+            queryFit: {
+                judgment: "unknown",
+                rationale: "No target file was provided to read-file.",
+            },
+            confidence: 0.05,
+            readAt,
+            mode: args.mode,
+            requestedFacts: args.expectedFacts,
+            queryFingerprint,
+            callId: args.callId,
+        };
+    }
+    const workingFile = (args.context.workingFiles ?? []).find((file) => file.path === args.targetFile);
+    if (!workingFile || typeof workingFile.code !== "string") {
+        return {
+            status: "missing-working-file",
+            fileKind: detectFileKind(args.targetFile),
+            facts: [],
+            missingFacts: args.expectedFacts,
+            snippets: [],
+            queryFit: {
+                judgment: "unknown",
+                rationale: "The target file is not loaded in workingFiles yet.",
+            },
+            confidence: 0.15,
+            readAt,
+            mode: args.mode,
+            requestedFacts: args.expectedFacts,
+            queryFingerprint,
+            callId: args.callId,
+        };
+    }
+    const fileKind = detectFileKind(workingFile.path);
+    const facts = collectFacts(workingFile, fileKind, args.expectedFacts);
+    const missingFacts = facts.filter((fact) => !fact.found).map((fact) => fact.key);
+    const snippets = Array.from(new Set(facts
+        .map((fact) => fact.snippet)
+        .filter((snippet) => typeof snippet === "string" && snippet.length > 0))).slice(0, MAX_SNIPPETS);
+    const queryFit = judgeQueryFit(args.query, workingFile.path, fileKind, facts);
+    const contentFingerprint = computeContentFingerprint(workingFile.code);
+    return {
+        status: "ok",
+        fileKind,
+        facts,
+        missingFacts,
+        snippets,
+        queryFit,
+        confidence: deriveConfidence(facts, queryFit),
+        readAt,
+        mode: args.mode,
+        requestedFacts: args.expectedFacts,
+        contentFingerprint,
+        queryFingerprint,
+        callId: args.callId,
+    };
+}
+function normalizeExpectedFacts(input) {
+    if (!Array.isArray(input))
+        return [];
+    return input
+        .map((value) => String(value ?? "").trim())
+        .filter((value) => value.length > 0);
+}
+function detectFileKind(filePath) {
+    const lower = filePath.toLowerCase();
+    if (lower.endsWith("/package.json") || path.basename(lower) === "package.json")
+        return "package-json";
+    if (lower.endsWith(".json"))
+        return "json";
+    if (lower.endsWith(".md"))
+        return "markdown";
+    if (/\.(ts|tsx|js|jsx|java|rs|py|go|rb|c|cc|cpp|h)$/i.test(lower))
+        return "source";
+    if (/\.(txt|ya?ml|toml|lock)$/i.test(lower))
+        return "text";
+    return "unknown";
+}
+function collectFacts(file, fileKind, expectedFacts) {
+    if (fileKind === "package-json" || fileKind === "json") {
+        return collectJsonFacts(file.code ?? "", expectedFacts);
+    }
+    if (fileKind === "markdown" || fileKind === "source" || fileKind === "text" || fileKind === "unknown") {
+        return collectTextFacts(file.code ?? "", expectedFacts);
+    }
+    return [];
+}
+function collectJsonFacts(code, expectedFacts) {
+    let parsed;
+    try {
+        parsed = JSON.parse(code);
+    }
+    catch {
+        return expectedFacts.map((fact) => ({
+            key: fact,
+            found: false,
+        }));
+    }
+    return expectedFacts.map((fact) => {
+        const value = readNestedJsonValue(parsed, fact);
+        const found = value !== undefined;
+        return {
+            key: fact,
+            value: found ? formatFactValue(value) : undefined,
+            found,
+            snippet: found ? `"${fact}": ${formatFactValue(value)}`.slice(0, MAX_SNIPPET_CHARS) : undefined,
+        };
+    });
+}
+function readNestedJsonValue(input, factPath) {
+    const keys = factPath.split(".").filter(Boolean);
+    let current = input;
+    for (const key of keys) {
+        if (!current || typeof current !== "object" || !(key in current)) {
+            return undefined;
+        }
+        current = current[key];
+    }
+    return current;
+}
+function formatFactValue(value) {
+    if (typeof value === "string")
+        return value;
+    return JSON.stringify(value);
+}
+function collectTextFacts(code, expectedFacts) {
+    return expectedFacts.map((fact) => {
+        const index = code.indexOf(fact);
+        const found = index >= 0;
+        return {
+            key: fact,
+            value: found ? "present" : undefined,
+            found,
+            snippet: found ? buildSnippet(code, index, fact.length) : undefined,
+        };
+    });
+}
+function buildSnippet(code, start, length) {
+    const prefix = Math.max(0, start - 30);
+    const suffix = Math.min(code.length, start + length + 40);
+    return code
+        .slice(prefix, suffix)
+        .replace(/\s+/g, " ")
+        .trim()
+        .slice(0, MAX_SNIPPET_CHARS);
+}
+function judgeQueryFit(query, filePath, fileKind, facts) {
+    const lowerQuery = query.toLowerCase();
+    const base = path.basename(filePath).toLowerCase();
+    const foundCount = facts.filter((fact) => fact.found).length;
+    const missingCount = facts.filter((fact) => !fact.found).length;
+    if (/\b(refactor|edit|rename|change|fix|transform|symbol|function|class)\b/i.test(query) && fileKind === "markdown") {
+        return {
+            judgment: "wrong-shape",
+            rationale: "The query looks code-focused, but this file is markdown-shaped.",
+        };
+    }
+    if (base.length > 0 && lowerQuery.includes(base)) {
+        return {
+            judgment: missingCount === 0 ? "strong" : "partial",
+            rationale: "The query names this file directly.",
+        };
+    }
+    if ((fileKind === "package-json" && lowerQuery.includes("package")) || (fileKind === "markdown" && lowerQuery.includes("readme"))) {
+        return {
+            judgment: missingCount === 0 ? "strong" : "partial",
+            rationale: "The query points at this file shape directly.",
+        };
+    }
+    if (foundCount > 0) {
+        return {
+            judgment: missingCount === 0 ? "partial" : "weak",
+            rationale: "The file contains some expected facts, but it is not a clean direct match.",
+        };
+    }
+    return {
+        judgment: "weak",
+        rationale: "The quick read did not find a strong direct fit signal.",
+    };
+}
+function deriveConfidence(facts, queryFit) {
+    const total = facts.length;
+    const found = facts.filter((fact) => fact.found).length;
+    const factScore = total === 0 ? 0.45 : found / total;
+    const fitBoost = queryFit.judgment === "strong" ? 0.25 :
+        queryFit.judgment === "partial" ? 0.15 :
+            queryFit.judgment === "wrong-shape" ? -0.2 :
+                queryFit.judgment === "weak" ? -0.05 : 0;
+    return Math.max(0.05, Math.min(0.98, Number((0.5 + (factScore - 0.5) * 0.5 + fitBoost).toFixed(2))));
+}
+//# sourceMappingURL=readFileModule.js.map

package/dist/pipeline/modules/readFileModule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readFileModule.js","sourceRoot":"","sources":["../../../src/pipeline/modules/readFileModule.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Runs one cheap structured read over an already-loaded file.\n *\n * Why this file exists:\n * - keep quick file inspection separate from raw file loading\n * - let the inner loop gather compact facts without doing full semantic analysis\n * - give the outer loop a small evidence packet it can evaluate against the objective\n */\nimport path from \"path\";\nimport type {\n    Module,\n    ModuleIO,\n    ReadFileFact,\n    ReadFileResult,\n    ReadQueryFit,\n    StructuredContext,\n    StructuredFileCapsule,\n} from \"../../types.js\";\nimport { logInputOutput } from \"../../utils/promptLogHelper.js\";\nimport {\n    computeContentFingerprint,\n    computeQueryFingerprint,\n    hasFreshReadResult,\n} from \"../../utils/fileEvidenceCache.js\";\n\nconst MAX_SNIPPETS = 3;\nconst MAX_SNIPPET_CHARS = 120;\n\nexport const readFileModule: Module = {\n    name: \"read-file\",\n    description: \"Inspects one already-loaded file and returns compact findings only.\",\n    groups: [\"analysis\"],\n\n    async run(input: ModuleIO): Promise<ModuleIO> {\n        const context = input.context as StructuredContext;\n        if (!context) {\n            throw new Error(\"[read-file] Missing context.\");\n        }\n\n        const step = context.currentStep;\n        const actionArgs = (input.data ?? {}) as Record<string, unknown>;\n        const targetFile =\n            typeof actionArgs.target === \"string\" && actionArgs.target.trim().length > 0\n                ? actionArgs.target.trim()\n                : step?.targetFile;\n        const expectedFacts = normalizeExpectedFacts(actionArgs.expectedFacts);\n        const mode = typeof actionArgs.mode === \"string\" && actionArgs.mode.trim().length > 0\n            ? actionArgs.mode.trim()\n            : \"quick-read\";\n        const workingFile = targetFile\n            ? (context.workingFiles ?? []).find((file) => file.path === targetFile)\n            : undefined;\n\n        context.analysis ||= {};\n        context.analysis.readResults ||= { byFile: {} };\n\n        const cachedResult = targetFile ? context.analysis.readResults.byFile[targetFile] : undefined;\n        if (hasFreshReadResult({\n            result: cachedResult,\n            file: workingFile,\n            query: input.query,\n            expectedFacts,\n            mode,\n        })) {\n            logInputOutput(\"read-file\", \"output\", {\n                targetFile: targetFile ?? null,\n                mode,\n                status: cachedResult?.status,\n                fileKind: cachedResult?.fileKind,\n                facts: cachedResult?.facts,\n                missingFacts: cachedResult?.missingFacts,\n                snippets: cachedResult?.snippets,\n                queryFit: cachedResult?.queryFit,\n                confidence: cachedResult?.confidence,\n                readAt: cachedResult?.readAt,\n                callId: cachedResult?.callId,\n                reusedFromCache: true,\n            });\n\n            return {\n                query: input.query,\n                data: {\n                    readResult: cachedResult,\n                    notes: \"Quick read reused cached result\",\n                },\n                context,\n            };\n        }\n\n        const result = buildReadResult({\n            context,\n            targetFile,\n            query: input.query,\n            expectedFacts,\n            mode,\n            callId: input.trace?.callId,\n        });\n\n        if (targetFile) {\n            context.analysis.readResults.byFile[targetFile] = result;\n        }\n\n        logInputOutput(\"read-file\", \"output\", {\n            targetFile: targetFile ?? null,\n            mode,\n            status: result.status,\n            fileKind: result.fileKind,\n            facts: result.facts,\n            missingFacts: result.missingFacts,\n            snippets: result.snippets,\n            queryFit: result.queryFit,\n            confidence: result.confidence,\n            readAt: result.readAt,\n            callId: result.callId,\n        });\n\n        return {\n            query: input.query,\n            data: {\n                readResult: result,\n            },\n        };\n    },\n};\n\ntype BuildReadResultArgs = {\n    context: StructuredContext;\n    targetFile?: string;\n    query: string;\n    expectedFacts: string[];\n    mode: string;\n    callId?: string;\n};\n\nfunction buildReadResult(args: BuildReadResultArgs): ReadFileResult {\n    const readAt = new Date().toISOString();\n    const queryFingerprint = computeQueryFingerprint(args.query);\n    if (!args.targetFile) {\n        return {\n            status: \"error\",\n            fileKind: \"unknown\",\n            facts: [],\n            missingFacts: [\"target\"],\n            snippets: [],\n            queryFit: {\n                judgment: \"unknown\",\n                rationale: \"No target file was provided to read-file.\",\n            },\n            confidence: 0.05,\n            readAt,\n            mode: args.mode,\n            requestedFacts: args.expectedFacts,\n            queryFingerprint,\n            callId: args.callId,\n        };\n    }\n\n    const workingFile = (args.context.workingFiles ?? []).find((file) => file.path === args.targetFile);\n    if (!workingFile || typeof workingFile.code !== \"string\") {\n        return {\n            status: \"missing-working-file\",\n            fileKind: detectFileKind(args.targetFile),\n            facts: [],\n            missingFacts: args.expectedFacts,\n            snippets: [],\n            queryFit: {\n                judgment: \"unknown\",\n                rationale: \"The target file is not loaded in workingFiles yet.\",\n            },\n            confidence: 0.15,\n            readAt,\n            mode: args.mode,\n            requestedFacts: args.expectedFacts,\n            queryFingerprint,\n            callId: args.callId,\n        };\n    }\n\n    const fileKind = detectFileKind(workingFile.path);\n    const facts = collectFacts(workingFile, fileKind, args.expectedFacts);\n    const missingFacts = facts.filter((fact) => !fact.found).map((fact) => fact.key);\n    const snippets = Array.from(\n        new Set(\n            facts\n                .map((fact) => fact.snippet)\n                .filter((snippet): snippet is string => typeof snippet === \"string\" && snippet.length > 0)\n        )\n    ).slice(0, MAX_SNIPPETS);\n    const queryFit = judgeQueryFit(args.query, workingFile.path, fileKind, facts);\n    const contentFingerprint = computeContentFingerprint(workingFile.code);\n\n    return {\n        status: \"ok\",\n        fileKind,\n        facts,\n        missingFacts,\n        snippets,\n        queryFit,\n        confidence: deriveConfidence(facts, queryFit),\n        readAt,\n        mode: args.mode,\n        requestedFacts: args.expectedFacts,\n        contentFingerprint,\n        queryFingerprint,\n        callId: args.callId,\n    };\n}\n\nfunction normalizeExpectedFacts(input: unknown): string[] {\n    if (!Array.isArray(input)) return [];\n    return input\n        .map((value) => String(value ?? \"\").trim())\n        .filter((value) => value.length > 0);\n}\n\nfunction detectFileKind(filePath: string): ReadFileResult[\"fileKind\"] {\n    const lower = filePath.toLowerCase();\n    if (lower.endsWith(\"/package.json\") || path.basename(lower) === \"package.json\") return \"package-json\";\n    if (lower.endsWith(\".json\")) return \"json\";\n    if (lower.endsWith(\".md\")) return \"markdown\";\n    if (/\\.(ts|tsx|js|jsx|java|rs|py|go|rb|c|cc|cpp|h)$/i.test(lower)) return \"source\";\n    if (/\\.(txt|ya?ml|toml|lock)$/i.test(lower)) return \"text\";\n    return \"unknown\";\n}\n\nfunction collectFacts(\n    file: StructuredFileCapsule,\n    fileKind: ReadFileResult[\"fileKind\"],\n    expectedFacts: string[]\n): ReadFileFact[] {\n    if (fileKind === \"package-json\" || fileKind === \"json\") {\n        return collectJsonFacts(file.code ?? \"\", expectedFacts);\n    }\n\n    if (fileKind === \"markdown\" || fileKind === \"source\" || fileKind === \"text\" || fileKind === \"unknown\") {\n        return collectTextFacts(file.code ?? \"\", expectedFacts);\n    }\n\n    return [];\n}\n\nfunction collectJsonFacts(code: string, expectedFacts: string[]): ReadFileFact[] {\n    let parsed: Record<string, unknown> | undefined;\n    try {\n        parsed = JSON.parse(code);\n    } catch {\n        return expectedFacts.map((fact) => ({\n            key: fact,\n            found: false,\n        }));\n    }\n\n    return expectedFacts.map((fact) => {\n        const value = readNestedJsonValue(parsed, fact);\n        const found = value !== undefined;\n        return {\n            key: fact,\n            value: found ? formatFactValue(value) : undefined,\n            found,\n            snippet: found ? `\"${fact}\": ${formatFactValue(value)}`.slice(0, MAX_SNIPPET_CHARS) : undefined,\n        };\n    });\n}\n\nfunction readNestedJsonValue(input: unknown, factPath: string): unknown {\n    const keys = factPath.split(\".\").filter(Boolean);\n    let current = input;\n    for (const key of keys) {\n        if (!current || typeof current !== \"object\" || !(key in current)) {\n            return undefined;\n        }\n        current = (current as Record<string, unknown>)[key];\n    }\n    return current;\n}\n\nfunction formatFactValue(value: unknown): string {\n    if (typeof value === \"string\") return value;\n    return JSON.stringify(value);\n}\n\nfunction collectTextFacts(code: string, expectedFacts: string[]): ReadFileFact[] {\n    return expectedFacts.map((fact) => {\n        const index = code.indexOf(fact);\n        const found = index >= 0;\n        return {\n            key: fact,\n            value: found ? \"present\" : undefined,\n            found,\n            snippet: found ? buildSnippet(code, index, fact.length) : undefined,\n        };\n    });\n}\n\nfunction buildSnippet(code: string, start: number, length: number): string {\n    const prefix = Math.max(0, start - 30);\n    const suffix = Math.min(code.length, start + length + 40);\n    return code\n        .slice(prefix, suffix)\n        .replace(/\\s+/g, \" \")\n        .trim()\n        .slice(0, MAX_SNIPPET_CHARS);\n}\n\nfunction judgeQueryFit(\n    query: string,\n    filePath: string,\n    fileKind: ReadFileResult[\"fileKind\"],\n    facts: ReadFileFact[]\n): ReadQueryFit {\n    const lowerQuery = query.toLowerCase();\n    const base = path.basename(filePath).toLowerCase();\n    const foundCount = facts.filter((fact) => fact.found).length;\n    const missingCount = facts.filter((fact) => !fact.found).length;\n\n    if (/\\b(refactor|edit|rename|change|fix|transform|symbol|function|class)\\b/i.test(query) && fileKind === \"markdown\") {\n        return {\n            judgment: \"wrong-shape\",\n            rationale: \"The query looks code-focused, but this file is markdown-shaped.\",\n        };\n    }\n\n    if (base.length > 0 && lowerQuery.includes(base)) {\n        return {\n            judgment: missingCount === 0 ? \"strong\" : \"partial\",\n            rationale: \"The query names this file directly.\",\n        };\n    }\n\n    if ((fileKind === \"package-json\" && lowerQuery.includes(\"package\")) || (fileKind === \"markdown\" && lowerQuery.includes(\"readme\"))) {\n        return {\n            judgment: missingCount === 0 ? \"strong\" : \"partial\",\n            rationale: \"The query points at this file shape directly.\",\n        };\n    }\n\n    if (foundCount > 0) {\n        return {\n            judgment: missingCount === 0 ? \"partial\" : \"weak\",\n            rationale: \"The file contains some expected facts, but it is not a clean direct match.\",\n        };\n    }\n\n    return {\n        judgment: \"weak\",\n        rationale: \"The quick read did not find a strong direct fit signal.\",\n    };\n}\n\nfunction deriveConfidence(facts: ReadFileFact[], queryFit: ReadQueryFit): number {\n    const total = facts.length;\n    const found = facts.filter((fact) => fact.found).length;\n    const factScore = total === 0 ? 0.45 : found / total;\n    const fitBoost =\n        queryFit.judgment === \"strong\" ? 0.25 :\n            queryFit.judgment === \"partial\" ? 0.15 :\n                queryFit.judgment === \"wrong-shape\" ? -0.2 :\n                    queryFit.judgment === \"weak\" ? -0.05 : 0;\n\n    return Math.max(0.05, Math.min(0.98, Number((0.5 + (factScore - 0.5) * 0.5 + fitBoost).toFixed(2))));\n}\n"]}

package/dist/pipeline/modules/reviewModule.js

@@ -1,4 +1,6 @@
-// File: src/pipeline/modules/reviewModule.ts
+/**
+ * Reviews a diff-like text input and asks the model for short actionable suggestions.
+ */
 import { generate } from '../../lib/generate.js';
 export const reviewModule = {
     name: 'review',
@@ -27,6 +29,12 @@ ${codeDiff}
         const response = await generate({
             query,
             content: prompt,
+        }, {
+            caller: "reviewModule",
+            inputContext: {
+                query,
+                codeDiff,
+            },
         });
         // Ensure content is string
         const responseText = typeof response.content === 'string' ? response.content : JSON.stringify(response.content ?? '', null, 2);
@@ -45,3 +53,4 @@ ${codeDiff}
         return output;
     },
 };
+//# sourceMappingURL=reviewModule.js.map

package/dist/pipeline/modules/reviewModule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reviewModule.js","sourceRoot":"","sources":["../../../src/pipeline/modules/reviewModule.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAIjD,MAAM,CAAC,MAAM,YAAY,GAAW;IAClC,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,qEAAqE;IAElF,GAAG,EAAE,KAAK,EAAE,KAAe,EAAqB,EAAE;QAChD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;QAChC,MAAM,QAAQ,GAAG,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QAExE,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QAED,MAAM,MAAM,GAAG;;;;;;;;;;;;;EAajB,QAAQ;KACL,CAAC,IAAI,EAAE,CAAC;QAET,MAAM,QAAQ,GAAa,MAAM,QAAQ,CAAC;YACxC,KAAK;YACL,OAAO,EAAE,MAAM;SAChB,EAAE;YACD,MAAM,EAAE,cAAc;YACtB,YAAY,EAAE;gBACZ,KAAK;gBACL,QAAQ;aACT;SACF,CAAC,CAAC;QAEH,2BAA2B;QAC3B,MAAM,YAAY,GAAG,OAAO,QAAQ,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,OAAO,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAE/H,2CAA2C;QAC3C,MAAM,KAAK,GAAG,YAAY;aACvB,KAAK,CAAC,IAAI,CAAC;aACX,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;aACxB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAE1C,8CAA8C;QAC9C,MAAM,WAAW,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CACnC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE,CAC/D,CAAC;QAEF,MAAM,MAAM,GAAa;YACvB,KAAK;YACL,OAAO,EAAE,YAAY,EAAQ,mBAAmB;YAChD,IAAI,EAAE,EAAE,WAAW,EAAE,EAAQ,yBAAyB;SACvD,CAAC;QAEF,OAAO,MAAM,CAAC;IAChB,CAAC;CACF,CAAC","sourcesContent":["/**\n * Reviews a diff-like text input and asks the model for short actionable suggestions.\n */\nimport { generate } from '../../lib/generate.js';\nimport { Config } from '../../config.js';\nimport { Module, ModuleIO } from '../../types.js';\n\r\nexport const reviewModule: Module = {\r\n  name: 'review',\r\n  description: 'Reviews code diff or PR content and provides actionable suggestions',\r\n\r\n  run: async (input: ModuleIO): Promise<ModuleIO> => {\r\n    const query = input.query ?? '';\r\n    const codeDiff = typeof input.content === 'string' ? input.content : '';\r\n\r\n    if (!codeDiff) {\r\n      throw new Error('⚠️ No code diff provided for review.');\r\n    }\r\n\r\n    const prompt = `\r\nSuggest ALWAYS 3 concise suggestions for improvements based on the input code diff.\r\n\r\n- Use one of these types for each suggestion: style, refactor, bug, docs, test\r\n- Keep each message short, clear, and actionable\r\n\r\nFormat your response exactly as:\r\n\r\n1. <type>: <message>\r\n2. <type>: <message>\r\n3. <type>: <message>\r\n\r\nChanges:\r\n${codeDiff}\r\n    `.trim();\r\n\r\n    const response: ModuleIO = await generate({\n      query,\n      content: prompt,\n    }, {\n      caller: \"reviewModule\",\n      inputContext: {\n        query,\n        codeDiff,\n      },\n    });\n\r\n    // Ensure content is string\r\n    const responseText = typeof response.content === 'string' ? response.content : JSON.stringify(response.content ?? '', null, 2);\r\n\r\n    // Parse response: only keep numbered lines\r\n    const lines = responseText\r\n      .split('\\n')\r\n      .map(line => line.trim())\r\n      .filter(line => /^\\d+\\.\\s+/.test(line));\r\n\r\n    // Remove numbering and any surrounding quotes\r\n    const suggestions = lines.map(line =>\r\n      line.replace(/^\\d+\\.\\s+/, '').replace(/^\"(.*)\"$/, '$1').trim()\r\n    );\r\n\r\n    const output: ModuleIO = {\r\n      query,\r\n      content: responseText,       // raw model output\r\n      data: { suggestions },       // structured suggestions\r\n    };\r\n\r\n    return output;\r\n  },\r\n};\r\n"]}

package/dist/pipeline/modules/searchDbModule.js

@@ -0,0 +1,159 @@
+/**
+ * Runs deterministic DB-backed search as a first-class loop action.
+ *
+ * Why this file exists:
+ * - the planner should ask for `search-db` explicitly
+ * - this keeps search execution in `SearchOrchestrator`
+ * - this module only handles loop-facing state like focus, history, and related files
+ */
+import fs from "fs";
+import path from "path";
+import { Config } from "../../config.js";
+import { logInputOutput } from "../../utils/promptLogHelper.js";
+import { getContextExecutionPath, mapCanonicalPathToExecutionPath } from "../../utils/repoIdentity.js";
+import { getVerifyFocusFilePreference, isVerifyFocusQueryText, } from "../../utils/verifyFocusPreference.js";
+import { SearchOrchestrator } from "../../search/SearchOrchestrator.js";
+import { deriveFocusFromSearchResult } from "../../agents/deriveFocusFromSearchStep.js";
+import { enrichMissingSummaries, persistDiscoveredFiles, recordSearchAttempt, } from "./searchModuleShared.js";
+export const searchDbModule = {
+    name: "search-db",
+    description: "Runs deterministic indexed search and exact target lookup.",
+    groups: ["analysis"],
+    run: async (input) => {
+        const ctx = input.context;
+        if (!ctx) {
+            throw new Error("[search-db] StructuredContext is required.");
+        }
+        const subQuery = resolveSubQuery(ctx, input.query);
+        if (!subQuery) {
+            return { query: input.query, data: { files: [] } };
+        }
+        let repoRoot = getContextExecutionPath(ctx) || Config.getIndexDir() || process.cwd();
+        repoRoot = path.resolve(repoRoot);
+        if (!fs.existsSync(repoRoot)) {
+            return { query: input.query, data: { files: [] } };
+        }
+        const orchestrator = new SearchOrchestrator();
+        const search = await orchestrator.runDbSearch({
+            context: ctx,
+            query: subQuery,
+            plannerQuery: subQuery,
+            limit: 5,
+        });
+        deriveFocusFromSearchResult(ctx, search, {
+            appendCandidates: true,
+            promoteOperatorMatchesToCandidates: true,
+        });
+        let results = applyResolvedFolderScope(ctx, search.fileCandidates.map(file => ({ ...file })));
+        if (results.length > 0) {
+            results = supplementVerifyFocusResults({
+                repoRoot,
+                queryText: input.query,
+                results,
+                context: ctx,
+            });
+        }
+        results = await enrichMissingSummaries(results, ctx);
+        results = results.map(result => ({
+            ...result,
+            path: mapCanonicalPathToExecutionPath(result.path, ctx),
+        }));
+        persistDiscoveredFiles(ctx, results);
+        recordSearchAttempt({
+            context: ctx,
+            actionId: "search-db",
+            query: subQuery,
+            search,
+        });
+        const output = { query: input.query, data: { files: results } };
+        logInputOutput("search-db", "output", output);
+        return output;
+    },
+};
+function resolveSubQuery(context, fallbackQuery) {
+    const planStep = context.currentStep;
+    const subQueryTerms = planStep?.subQuery ?? [];
+    const subQuery = subQueryTerms.join(" ").trim();
+    return subQuery || String(fallbackQuery ?? "").trim();
+}
+function applyResolvedFolderScope(ctx, results) {
+    const folders = (ctx.analysis?.focus?.resolvedTargetFolders ?? [])
+        .map(folder => path.normalize(String(folder ?? "")))
+        .filter(Boolean);
+    if (folders.length === 0)
+        return results;
+    const inScope = (filePath) => {
+        const normalized = path.normalize(String(filePath ?? ""));
+        return folders.some(folder => normalized === folder || normalized.startsWith(`${folder}${path.sep}`));
+    };
+    const scopedResults = results.filter(result => inScope(result.path));
+    if (scopedResults.length > 0) {
+        return scopedResults;
+    }
+    const candidateFiles = (ctx.analysis?.focus?.candidateFiles ?? [])
+        .filter(filePath => path.isAbsolute(filePath) && inScope(filePath))
+        .map(filePath => ({
+        path: filePath,
+        id: -1,
+        filename: path.basename(filePath),
+        summary: null,
+        type: path.extname(filePath).replace(/^\./, "") || "unknown",
+        lastModified: new Date(0).toISOString(),
+    }));
+    return candidateFiles.length > 0 ? candidateFiles : results;
+}
+function supplementVerifyFocusResults(args) {
+    if (!isVerifyFocusQueryText(args.queryText)) {
+        return args.results;
+    }
+    const existingPaths = new Set(args.results.map(result => path.resolve(mapCanonicalPathToExecutionPath(result.path, args.context))));
+    const supplemental = collectSearchableFiles(args.repoRoot)
+        .filter(filePath => !existingPaths.has(path.resolve(filePath)))
+        .filter(filePath => {
+        const preference = getVerifyFocusFilePreference({ filePath, query: args.queryText });
+        return preference.score > 0;
+    })
+        .sort((left, right) => {
+        const leftPreference = getVerifyFocusFilePreference({ filePath: left, query: args.queryText }).score;
+        const rightPreference = getVerifyFocusFilePreference({ filePath: right, query: args.queryText }).score;
+        return rightPreference - leftPreference;
+    })
+        .slice(0, 3)
+        .map(filePath => ({
+        path: filePath,
+        id: -1,
+        filename: path.basename(filePath),
+        summary: null,
+        type: path.extname(filePath).replace(/^\./, "") || "unknown",
+        lastModified: new Date(0).toISOString(),
+    }));
+    return [...supplemental, ...args.results].filter((result, index, list) => list.findIndex(candidate => candidate.path === result.path) === index);
+}
+function collectSearchableFiles(rootDir) {
+    const files = [];
+    const stack = [rootDir];
+    while (stack.length > 0) {
+        const currentDir = stack.pop();
+        if (!currentDir)
+            continue;
+        let entries = [];
+        try {
+            entries = fs.readdirSync(currentDir, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            if (entry.name.startsWith("."))
+                continue;
+            const fullPath = path.join(currentDir, entry.name);
+            if (entry.isDirectory()) {
+                stack.push(fullPath);
+                continue;
+            }
+            files.push(fullPath);
+        }
+    }
+    return files;
+}
+//# sourceMappingURL=searchDbModule.js.map

package/dist/pipeline/modules/searchDbModule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"searchDbModule.js","sourceRoot":"","sources":["../../../src/pipeline/modules/searchDbModule.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Runs deterministic DB-backed search as a first-class loop action.\n *\n * Why this file exists:\n * - the planner should ask for `search-db` explicitly\n * - this keeps search execution in `SearchOrchestrator`\n * - this module only handles loop-facing state like focus, history, and related files\n */\nimport fs from \"fs\";\nimport path from \"path\";\nimport type { Module, ModuleIO, SearchResult, StructuredContext } from \"../../types.js\";\nimport { Config } from \"../../config.js\";\nimport { logInputOutput } from \"../../utils/promptLogHelper.js\";\nimport { getContextExecutionPath, mapCanonicalPathToExecutionPath } from \"../../utils/repoIdentity.js\";\nimport {\n  getVerifyFocusFilePreference,\n  isVerifyFocusQueryText,\n} from \"../../utils/verifyFocusPreference.js\";\nimport { SearchOrchestrator } from \"../../search/SearchOrchestrator.js\";\nimport { deriveFocusFromSearchResult } from \"../../agents/deriveFocusFromSearchStep.js\";\nimport {\n  enrichMissingSummaries,\n  persistDiscoveredFiles,\n  recordSearchAttempt,\n} from \"./searchModuleShared.js\";\n\ntype FileRecord = SearchResult;\n\nexport const searchDbModule: Module = {\n  name: \"search-db\",\n  description: \"Runs deterministic indexed search and exact target lookup.\",\n  groups: [\"analysis\"],\n\n  run: async (input: ModuleIO): Promise<ModuleIO> => {\n    const ctx = input.context;\n    if (!ctx) {\n      throw new Error(\"[search-db] StructuredContext is required.\");\n    }\n\n    const subQuery = resolveSubQuery(ctx, input.query);\n    if (!subQuery) {\n      return { query: input.query, data: { files: [] } };\n    }\n\n    let repoRoot = getContextExecutionPath(ctx) || Config.getIndexDir() || process.cwd();\n    repoRoot = path.resolve(repoRoot);\n    if (!fs.existsSync(repoRoot)) {\n      return { query: input.query, data: { files: [] } };\n    }\n\n    const orchestrator = new SearchOrchestrator();\n    const search = await orchestrator.runDbSearch({\n      context: ctx,\n      query: subQuery,\n      plannerQuery: subQuery,\n      limit: 5,\n    });\n\n    deriveFocusFromSearchResult(ctx, search, {\n      appendCandidates: true,\n      promoteOperatorMatchesToCandidates: true,\n    });\n\n    let results = applyResolvedFolderScope(\n      ctx,\n      search.fileCandidates.map(file => ({ ...file }))\n    );\n    if (results.length > 0) {\n      results = supplementVerifyFocusResults({\n        repoRoot,\n        queryText: input.query,\n        results,\n        context: ctx,\n      });\n    }\n    results = await enrichMissingSummaries(results, ctx);\n    results = results.map(result => ({\n      ...result,\n      path: mapCanonicalPathToExecutionPath(result.path, ctx),\n    }));\n\n    persistDiscoveredFiles(ctx, results);\n    recordSearchAttempt({\n      context: ctx,\n      actionId: \"search-db\",\n      query: subQuery,\n      search,\n    });\n\n    const output: ModuleIO = { query: input.query, data: { files: results } };\n    logInputOutput(\"search-db\", \"output\", output);\n    return output;\n  },\n};\n\nfunction resolveSubQuery(context: StructuredContext, fallbackQuery: string): string {\n  const planStep = context.currentStep;\n  const subQueryTerms = planStep?.subQuery ?? [];\n  const subQuery = subQueryTerms.join(\" \").trim();\n  return subQuery || String(fallbackQuery ?? \"\").trim();\n}\n\nfunction applyResolvedFolderScope(\n  ctx: StructuredContext,\n  results: FileRecord[]\n): FileRecord[] {\n  const folders = (ctx.analysis?.focus?.resolvedTargetFolders ?? [])\n    .map(folder => path.normalize(String(folder ?? \"\")))\n    .filter(Boolean);\n  if (folders.length === 0) return results;\n\n  const inScope = (filePath: string): boolean => {\n    const normalized = path.normalize(String(filePath ?? \"\"));\n    return folders.some(folder => normalized === folder || normalized.startsWith(`${folder}${path.sep}`));\n  };\n\n  const scopedResults = results.filter(result => inScope(result.path));\n  if (scopedResults.length > 0) {\n    return scopedResults;\n  }\n\n  const candidateFiles = (ctx.analysis?.focus?.candidateFiles ?? [])\n    .filter(filePath => path.isAbsolute(filePath) && inScope(filePath))\n    .map(filePath => ({\n      path: filePath,\n      id: -1,\n      filename: path.basename(filePath),\n      summary: null,\n      type: path.extname(filePath).replace(/^\\./, \"\") || \"unknown\",\n      lastModified: new Date(0).toISOString(),\n    }));\n  return candidateFiles.length > 0 ? candidateFiles : results;\n}\n\nfunction supplementVerifyFocusResults(args: {\n  repoRoot: string;\n  queryText: string;\n  results: FileRecord[];\n  context: StructuredContext | undefined;\n}): FileRecord[] {\n  if (!isVerifyFocusQueryText(args.queryText)) {\n    return args.results;\n  }\n\n  const existingPaths = new Set(args.results.map(result => path.resolve(mapCanonicalPathToExecutionPath(result.path, args.context))));\n  const supplemental = collectSearchableFiles(args.repoRoot)\n    .filter(filePath => !existingPaths.has(path.resolve(filePath)))\n    .filter(filePath => {\n      const preference = getVerifyFocusFilePreference({ filePath, query: args.queryText });\n      return preference.score > 0;\n    })\n    .sort((left, right) => {\n      const leftPreference = getVerifyFocusFilePreference({ filePath: left, query: args.queryText }).score;\n      const rightPreference = getVerifyFocusFilePreference({ filePath: right, query: args.queryText }).score;\n      return rightPreference - leftPreference;\n    })\n    .slice(0, 3)\n    .map(filePath => ({\n      path: filePath,\n      id: -1,\n      filename: path.basename(filePath),\n      summary: null,\n      type: path.extname(filePath).replace(/^\\./, \"\") || \"unknown\",\n      lastModified: new Date(0).toISOString(),\n    }));\n\n  return [...supplemental, ...args.results].filter((result, index, list) =>\n    list.findIndex(candidate => candidate.path === result.path) === index\n  );\n}\n\nfunction collectSearchableFiles(rootDir: string): string[] {\n  const files: string[] = [];\n  const stack = [rootDir];\n  while (stack.length > 0) {\n    const currentDir = stack.pop();\n    if (!currentDir) continue;\n    let entries: fs.Dirent[] = [];\n    try {\n      entries = fs.readdirSync(currentDir, { withFileTypes: true });\n    } catch {\n      continue;\n    }\n\n    for (const entry of entries) {\n      if (entry.name.startsWith(\".\")) continue;\n      const fullPath = path.join(currentDir, entry.name);\n      if (entry.isDirectory()) {\n        stack.push(fullPath);\n        continue;\n      }\n      files.push(fullPath);\n    }\n  }\n  return files;\n}\n"]}

package/dist/pipeline/modules/searchListDirectoryModule.js

@@ -0,0 +1,62 @@
+/**
+ * Lists direct folder children as a lightweight answer path.
+ *
+ * Why this file exists:
+ * - folder listing is not semantic file analysis
+ * - it must not populate broad file candidates or trigger deep evidence work
+ * - it gives the loop one structured answer packet it can finalize directly
+ */
+import { logInputOutput } from "../../utils/promptLogHelper.js";
+import { SearchOrchestrator } from "../../search/SearchOrchestrator.js";
+import { recordSearchAttempt } from "./searchModuleShared.js";
+export const searchListDirectoryModule = {
+    name: "search-list-directory",
+    description: "Lists direct child files and folders for a resolved directory.",
+    groups: ["analysis"],
+    run: async (input) => {
+        const ctx = input.context;
+        if (!ctx) {
+            throw new Error("[search-list-directory] StructuredContext is required.");
+        }
+        const orchestrator = new SearchOrchestrator();
+        const search = orchestrator.runDirectoryListing({
+            context: ctx,
+            query: input.query,
+        });
+        ctx.analysis || (ctx.analysis = {});
+        ctx.analysis.search = search;
+        ctx.analysis.directoryListingAnswer = {
+            query: input.query,
+            folderPath: search.resolvedFolders[0],
+            entries: search.directoryEntries,
+            summary: renderDirectoryListingSummary(search.resolvedFolders[0], search.directoryEntries),
+        };
+        recordSearchAttempt({
+            context: ctx,
+            actionId: "search-list-directory",
+            query: input.query,
+            search,
+        });
+        const output = {
+            query: input.query,
+            data: {
+                entries: search.directoryEntries,
+                folderPath: search.resolvedFolders[0],
+                failure: search.failure,
+            },
+        };
+        logInputOutput("search-list-directory", "output", output);
+        return output;
+    },
+};
+function renderDirectoryListingSummary(folderPath, entries) {
+    const header = folderPath ? `Contents of ${folderPath}:` : "Directory contents:";
+    if (entries.length === 0) {
+        return `${header}\n[empty]`;
+    }
+    return [
+        header,
+        ...entries.map(entry => `${entry.kind === "folder" ? "[dir]" : "[file]"} ${entry.name}`),
+    ].join("\n");
+}
+//# sourceMappingURL=searchListDirectoryModule.js.map

package/dist/pipeline/modules/searchListDirectoryModule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"searchListDirectoryModule.js","sourceRoot":"","sources":["../../../src/pipeline/modules/searchListDirectoryModule.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAExE,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAE9D,MAAM,CAAC,MAAM,yBAAyB,GAAW;IAC/C,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EAAE,gEAAgE;IAC7E,MAAM,EAAE,CAAC,UAAU,CAAC;IAEpB,GAAG,EAAE,KAAK,EAAE,KAAe,EAAqB,EAAE;QAChD,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC;QAC1B,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;QAC5E,CAAC;QAED,MAAM,YAAY,GAAG,IAAI,kBAAkB,EAAE,CAAC;QAC9C,MAAM,MAAM,GAAG,YAAY,CAAC,mBAAmB,CAAC;YAC9C,OAAO,EAAE,GAAG;YACZ,KAAK,EAAE,KAAK,CAAC,KAAK;SACnB,CAAC,CAAC;QACH,GAAG,CAAC,QAAQ,KAAZ,GAAG,CAAC,QAAQ,GAAK,EAAE,EAAC;QACpB,GAAG,CAAC,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAC;QAC7B,GAAG,CAAC,QAAQ,CAAC,sBAAsB,GAAG;YACpC,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,UAAU,EAAE,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC;YACrC,OAAO,EAAE,MAAM,CAAC,gBAAgB;YAChC,OAAO,EAAE,6BAA6B,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,gBAAgB,CAAC;SAC3F,CAAC;QAEF,mBAAmB,CAAC;YAClB,OAAO,EAAE,GAAG;YACZ,QAAQ,EAAE,uBAAuB;YACjC,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,MAAM;SACP,CAAC,CAAC;QAEH,MAAM,MAAM,GAAa;YACvB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,IAAI,EAAE;gBACJ,OAAO,EAAE,MAAM,CAAC,gBAAgB;gBAChC,UAAU,EAAE,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC;gBACrC,OAAO,EAAE,MAAM,CAAC,OAAO;aACxB;SACF,CAAC;QACF,cAAc,CAAC,uBAAuB,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC1D,OAAO,MAAM,CAAC;IAChB,CAAC;CACF,CAAC;AAEF,SAAS,6BAA6B,CACpC,UAA8B,EAC9B,OAAyD;IAEzD,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,eAAe,UAAU,GAAG,CAAC,CAAC,CAAC,qBAAqB,CAAC;IACjF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,GAAG,MAAM,WAAW,CAAC;IAC9B,CAAC;IACD,OAAO;QACL,MAAM;QACN,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;KACzF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC","sourcesContent":["/**\n * Lists direct folder children as a lightweight answer path.\n *\n * Why this file exists:\n * - folder listing is not semantic file analysis\n * - it must not populate broad file candidates or trigger deep evidence work\n * - it gives the loop one structured answer packet it can finalize directly\n */\nimport { logInputOutput } from \"../../utils/promptLogHelper.js\";\nimport { SearchOrchestrator } from \"../../search/SearchOrchestrator.js\";\nimport type { Module, ModuleIO } from \"../../types.js\";\nimport { recordSearchAttempt } from \"./searchModuleShared.js\";\n\nexport const searchListDirectoryModule: Module = {\n  name: \"search-list-directory\",\n  description: \"Lists direct child files and folders for a resolved directory.\",\n  groups: [\"analysis\"],\n\n  run: async (input: ModuleIO): Promise<ModuleIO> => {\n    const ctx = input.context;\n    if (!ctx) {\n      throw new Error(\"[search-list-directory] StructuredContext is required.\");\n    }\n\n    const orchestrator = new SearchOrchestrator();\n    const search = orchestrator.runDirectoryListing({\n      context: ctx,\n      query: input.query,\n    });\n    ctx.analysis ||= {};\n    ctx.analysis.search = search;\n    ctx.analysis.directoryListingAnswer = {\n      query: input.query,\n      folderPath: search.resolvedFolders[0],\n      entries: search.directoryEntries,\n      summary: renderDirectoryListingSummary(search.resolvedFolders[0], search.directoryEntries),\n    };\n\n    recordSearchAttempt({\n      context: ctx,\n      actionId: \"search-list-directory\",\n      query: input.query,\n      search,\n    });\n\n    const output: ModuleIO = {\n      query: input.query,\n      data: {\n        entries: search.directoryEntries,\n        folderPath: search.resolvedFolders[0],\n        failure: search.failure,\n      },\n    };\n    logInputOutput(\"search-list-directory\", \"output\", output);\n    return output;\n  },\n};\n\nfunction renderDirectoryListingSummary(\n  folderPath: string | undefined,\n  entries: Array<{ name: string; kind: \"file\" | \"folder\" }>\n): string {\n  const header = folderPath ? `Contents of ${folderPath}:` : \"Directory contents:\";\n  if (entries.length === 0) {\n    return `${header}\\n[empty]`;\n  }\n  return [\n    header,\n    ...entries.map(entry => `${entry.kind === \"folder\" ? \"[dir]\" : \"[file]\"} ${entry.name}`),\n  ].join(\"\\n\");\n}\n"]}