scai 0.1.178 → 1.0.1

package/dist/agents/understandIntentStep.js

@@ -1,7 +1,17 @@
-// File: src/agents/steps/understandIntentStep.ts
+/**
+ * Understands the raw user query and extracts early intent hints.
+ *
+ * Why this exists:
+ * - explicit repo refs should be captured before search and routing
+ * - this step stays cheap and permissive, then search decides what truly resolves
+ * - `targetFiles` is a compatibility field, but it now carries file or folder refs
+ */
 import { generate } from "../lib/generate.js";
 import { logInputOutput } from "../utils/promptLogHelper.js";
 import { extractFileReferences } from "../utils/extractFileReferences.js";
+import { SENTENCE_STARTER_WORDS, STOP_WORDS } from "../fileRules/stopWords.js";
+import { buildResumePacket, renderResumePacket } from "../utils/resumeState.js";
+import { buildFallbackQuestions, buildRollingPlanState, resolvePlanModeState, } from "../utils/rollingPlan.js";
 export const understandIntentStep = {
     name: "understandIntent",
     description: "Analyze the user query and determine its intent, type, and the appropriate task category.",
@@ -11,24 +21,49 @@ export const understandIntentStep = {
     run: async (input) => {
         const { context } = input;
         const rawQuery = (context.initContext?.userQuery ?? "").trim();
-        // Fast-path for command-like probes (e.g. "/test") to avoid unnecessary model calls.
-        if (rawQuery.startsWith("/")) {
+        const commandName = rawQuery.startsWith("/")
+            ? rawQuery.slice(1).trim().split(/\s+/, 1)[0]?.toLowerCase()
+            : undefined;
+        const commandArgs = rawQuery.startsWith("/")
+            ? rawQuery.replace(/^\/\S+\s*/, "").trim()
+            : "";
+        const intentQuery = commandName === "plan" ? (commandArgs || rawQuery) : rawQuery;
+        const resumedContextCapsule = renderResumePacket(buildResumePacket(context.analysis?.resumeState)) ||
+            context.initContext?.resumedContextCapsule?.trim();
+        // Fast-path for command-like probes (e.g. "/tests") to avoid unnecessary model calls.
+        if (rawQuery.startsWith("/") && commandName !== "plan") {
+            const questions = buildFallbackQuestions({
+                rawQuery: commandArgs || rawQuery,
+                intentCategory: "request",
+                targetFiles: extractFileReferences(commandArgs),
+                targetSymbols: extractLikelySymbols(commandArgs),
+            });
             context.analysis ?? (context.analysis = {});
             context.analysis.intent = {
                 intent: "Handle command-like query input",
                 intentCategory: "request",
-                normalizedQuery: rawQuery,
+                normalizedQuery: commandArgs || rawQuery,
                 confidence: 0.9,
-                targetFiles: extractFileReferences(rawQuery),
-                targetSymbols: extractLikelySymbols(rawQuery),
+                targetFiles: extractFileReferences(commandArgs),
+                targetSymbols: extractLikelySymbols(commandArgs),
+                questions,
             };
+            context.analysis.planMode = resolvePlanModeState({
+                rawQuery,
+                normalizedQuery: commandArgs || rawQuery,
+                intentCategory: "request",
+                questions,
+            });
+            context.analysis.rollingPlan = buildRollingPlanState(context, "initial");
             return;
         }
         const prompt = `
 You are an AI assistant whose job is to determine the user's intent.
 
 User Query:
-${context.initContext?.userQuery}
+${intentQuery}
+
+${resumedContextCapsule ? `Resumed Context:\n${resumedContextCapsule}\n` : ""}
 
 Return a STRICT JSON object with the following fields:
 {
@@ -36,10 +71,23 @@ Return a STRICT JSON object with the following fields:
   "intentCategory": "one of: question, request, codingTask, refactorTask, explanation, debugging, planning, writing, docsAndComments",
   "normalizedQuery": "a cleaned and direct restatement of the user query",
   "confidence": 0-1,  // float
-  "targetFiles": ["optional explicit filenames/paths from user query"],
+  "questions": [
+    {
+      "id": "q1",
+      "order": 0,
+      "text": "optional ordered user-facing question",
+      "normalizedQuery": "optional cleaned question",
+      "intentCategory": "question",
+      "targetFiles": ["optional explicit file or folder refs for this question"],
+      "targetSymbols": ["optional symbol refs for this question"]
+    }
+  ],
+  "targetFiles": ["optional explicit file or folder refs from user query"],
   "targetSymbols": ["optional function/class/identifier targets from user query"]
 }
 
+Only include "questions" when the user clearly asked more than one direct question or distinct ask.
+Preserve user order.
 Do not include commentary. Emit ONLY valid JSON.
         `.trim();
         try {
@@ -47,11 +95,16 @@ Do not include commentary. Emit ONLY valid JSON.
                 query: rawQuery,
                 content: prompt
             };
-            const genOutput = await generate(genInput);
+            const genOutput = await generate(genInput, {
+                caller: "understandIntentStep",
+                inputContext: {
+                    userQuery: rawQuery,
+                    resumedContextCapsule,
+                },
+            });
             let raw = genOutput.data;
             if (typeof raw !== "string")
                 raw = JSON.stringify(raw ?? "{}");
-            logInputOutput("understandIntent", "output", raw);
             let parsed;
             try {
                 parsed = JSON.parse(raw);
@@ -99,14 +152,51 @@ Do not include commentary. Emit ONLY valid JSON.
             // Ensure the analysis object exists
             context.analysis ?? (context.analysis = {});
             // Store intent inside a dedicated object
+            const parsedQuestions = normalizeQuestions({
+                rawQuery,
+                parsedQuestions: Array.isArray(parsed.questions) ? parsed.questions : [],
+                defaultIntentCategory: category,
+                fallbackTargetFiles: targetFiles,
+                fallbackTargetSymbols: targetSymbols,
+            });
+            const questions = preferDeterministicQuestionSplit({
+                rawQuery,
+                parsedQuestions,
+                defaultIntentCategory: category,
+                fallbackTargetFiles: targetFiles,
+                fallbackTargetSymbols: targetSymbols,
+            });
             context.analysis.intent = {
                 intent: parsed.intent,
                 intentCategory: category,
-                normalizedQuery: parsed.normalizedQuery ?? rawQuery,
+                normalizedQuery: parsed.normalizedQuery ?? intentQuery,
                 confidence: intentConfidence,
+                questions,
                 targetFiles,
                 targetSymbols,
             };
+            if (context.task) {
+                context.task.taskQuestions = questions.map((question) => question.text);
+                context.task.taskQuestionDetails = questions;
+            }
+            context.analysis.planMode = resolvePlanModeState({
+                rawQuery,
+                normalizedQuery: context.analysis.intent.normalizedQuery,
+                intentCategory: category,
+                questions,
+            });
+            context.analysis.rollingPlan = buildRollingPlanState(context, context.analysis.planMode.enabled ? "initial" : "rolling");
+            logInputOutput("understandIntent", "output", {
+                callId: genOutput.trace?.callId,
+                intent: context.analysis.intent.intent,
+                intentCategory: context.analysis.intent.intentCategory,
+                normalizedQuery: context.analysis.intent.normalizedQuery,
+                confidence: context.analysis.intent.confidence,
+                questions: context.analysis.intent.questions,
+                targetFiles: context.analysis.intent.targetFiles,
+                targetSymbols: context.analysis.intent.targetSymbols,
+                planMode: context.analysis.planMode,
+            });
         }
         catch (err) {
             console.error("understandIntent error:", err);
@@ -117,12 +207,132 @@ Do not include commentary. Emit ONLY valid JSON.
                 intentCategory: "request",
                 normalizedQuery: rawQuery,
                 confidence: 0.0,
-                targetFiles: extractFileReferences(rawQuery),
-                targetSymbols: extractLikelySymbols(rawQuery),
+                questions: buildFallbackQuestions({
+                    rawQuery,
+                    intentCategory: "request",
+                    targetFiles: extractFileReferences(intentQuery),
+                    targetSymbols: extractLikelySymbols(intentQuery),
+                }),
+                targetFiles: extractFileReferences(intentQuery),
+                targetSymbols: extractLikelySymbols(intentQuery),
             };
+            if (context.task) {
+                context.task.taskQuestions = context.analysis.intent.questions?.map((question) => question.text) ?? [];
+                context.task.taskQuestionDetails = context.analysis.intent.questions;
+            }
+            context.analysis.planMode = resolvePlanModeState({
+                rawQuery,
+                normalizedQuery: intentQuery,
+                intentCategory: "request",
+                questions: context.analysis.intent.questions ?? [],
+            });
+            context.analysis.rollingPlan = buildRollingPlanState(context, "initial");
         }
     }
 };
+function normalizeQuestions(args) {
+    const normalized = args.parsedQuestions
+        .map((question, index) => {
+        const text = typeof question.text === "string" ? question.text.trim() : "";
+        const normalizedQuery = typeof question.normalizedQuery === "string" && question.normalizedQuery.trim().length > 0
+            ? question.normalizedQuery.trim()
+            : text;
+        if (!text && !normalizedQuery)
+            return undefined;
+        return {
+            id: typeof question.id === "string" && question.id.trim().length > 0 ? question.id.trim() : `q${index + 1}`,
+            order: typeof question.order === "number" ? question.order : index,
+            text: text || normalizedQuery,
+            normalizedQuery: normalizedQuery || text,
+            intentCategory: normalizeIntentCategory(question.intentCategory ?? args.defaultIntentCategory),
+            targetFiles: mergeUniqueCaseInsensitive(Array.isArray(question.targetFiles) ? question.targetFiles : [], []),
+            targetSymbols: mergeUniqueCaseInsensitive(Array.isArray(question.targetSymbols) ? question.targetSymbols : [], []),
+        };
+    })
+        .filter((question) => Boolean(question))
+        .sort((left, right) => left.order - right.order);
+    if (normalized.length > 0) {
+        return normalized;
+    }
+    return buildFallbackQuestions({
+        rawQuery: args.rawQuery,
+        intentCategory: args.defaultIntentCategory,
+        targetFiles: args.fallbackTargetFiles,
+        targetSymbols: args.fallbackTargetSymbols,
+    });
+}
+function preferDeterministicQuestionSplit(args) {
+    const deterministic = buildDeterministicQuestions({
+        rawQuery: args.rawQuery,
+        intentCategory: args.defaultIntentCategory,
+        fallbackTargetFiles: args.fallbackTargetFiles,
+        fallbackTargetSymbols: args.fallbackTargetSymbols,
+    });
+    if (deterministic.length > 1 && args.parsedQuestions.length <= 1) {
+        return deterministic;
+    }
+    return args.parsedQuestions;
+}
+function buildDeterministicQuestions(args) {
+    const parts = splitDirectQuestions(args.rawQuery);
+    if (parts.length <= 1) {
+        return buildFallbackQuestions({
+            rawQuery: args.rawQuery,
+            intentCategory: args.intentCategory,
+            targetFiles: args.fallbackTargetFiles,
+            targetSymbols: args.fallbackTargetSymbols,
+        });
+    }
+    return parts.map((text, index) => ({
+        id: `q${index + 1}`,
+        order: index,
+        text,
+        normalizedQuery: text,
+        intentCategory: args.intentCategory || "question",
+        targetFiles: mergeUniqueCaseInsensitive(extractFileReferences(text), args.fallbackTargetFiles),
+        targetSymbols: mergeUniqueCaseInsensitive(extractLikelySymbols(text), args.fallbackTargetSymbols),
+    }));
+}
+function splitDirectQuestions(rawQuery) {
+    const trimmed = rawQuery.trim();
+    if (!trimmed)
+        return [];
+    const questionMarkParts = trimmed
+        .split(/\?+/)
+        .map(part => part.trim())
+        .filter(Boolean);
+    if ((trimmed.match(/\?/g) ?? []).length >= 2 && questionMarkParts.length >= 2) {
+        return questionMarkParts.map(part => ensureQuestionMark(part));
+    }
+    const directQuestionParts = splitOnQuestionJoiners(trimmed);
+    return directQuestionParts.length >= 2 ? directQuestionParts : [ensureQuestionMark(trimmed)];
+}
+function splitOnQuestionJoiners(query) {
+    const matches = Array.from(query.matchAll(/\s+(?:and|also)\s+(?=(how|what|where|why|which|who|is|are|do|does|can|should|could|would)\b)/gi));
+    if (matches.length === 0) {
+        return [];
+    }
+    const parts = [];
+    let start = 0;
+    for (const match of matches) {
+        const index = match.index ?? -1;
+        if (index <= start)
+            continue;
+        parts.push(query.slice(start, index).trim());
+        const fullMatch = String(match[0] ?? "");
+        const nextQuestionLead = String(match[1] ?? "");
+        const leadOffset = fullMatch.toLowerCase().lastIndexOf(nextQuestionLead.toLowerCase());
+        start = index + (leadOffset >= 0 ? leadOffset : fullMatch.length);
+    }
+    parts.push(query.slice(start).trim());
+    return parts.map(part => ensureQuestionMark(part)).filter(Boolean);
+}
+function ensureQuestionMark(value) {
+    const trimmed = value.trim();
+    if (!trimmed)
+        return "";
+    return /[?.!]$/.test(trimmed) ? trimmed : `${trimmed}?`;
+}
 function mergeUniqueCaseInsensitive(primary, secondary) {
     const out = [];
     const seen = new Set();
@@ -141,16 +351,25 @@ function mergeUniqueCaseInsensitive(primary, secondary) {
     return out;
 }
 function extractLikelySymbols(query) {
+    // Heuristic symbol detector used to enrich intent targets.
+    // Example: "Refactor ChangeLogModule and runQueryWithDaemonControl" -> keeps both.
+    // Example: "Can you help..." -> drops "Can" as a sentence starter.
     const matches = query.match(/[A-Za-z_][A-Za-z0-9_]{2,}/g) ?? [];
     const out = new Set();
+    const symbolSuffixes = ["Step", "Module", "Cmd", "Service", "Controller", "Handler", "Manager"];
     for (const token of matches) {
-        const looksLikeSymbol = /[A-Z]/.test(token) ||
+        const lowered = token.toLowerCase();
+        if (STOP_WORDS.has(lowered) || SENTENCE_STARTER_WORDS.has(lowered))
+            continue;
+        const looksLikeSymbol = /[a-z][A-Z]/.test(token) ||
+            /[A-Z]{2,}[a-z]/.test(token) ||
             token.includes("_") ||
-            token.endsWith("Step") ||
-            token.endsWith("Module") ||
-            token.endsWith("Cmd");
+            /[0-9]/.test(token) ||
+            symbolSuffixes.some((suffix) => token.endsWith(suffix));
         if (!looksLikeSymbol)
             continue;
+        if (token.length < 4 && !symbolSuffixes.some((suffix) => token.endsWith(suffix)))
+            continue;
         out.add(token);
     }
     return Array.from(out);
@@ -185,3 +404,4 @@ function normalizeIntentCategory(raw) {
     };
     return directMap[value] ?? "request";
 }
+//# sourceMappingURL=understandIntentStep.js.map

package/dist/agents/understandIntentStep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"understandIntentStep.js","sourceRoot":"","sources":["../../src/agents/understandIntentStep.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Understands the raw user query and extracts early intent hints.\n *\n * Why this exists:\n * - explicit repo refs should be captured before search and routing\n * - this step stays cheap and permissive, then search decides what truly resolves\n * - `targetFiles` is a compatibility field, but it now carries file or folder refs\n */\n\nimport { generate } from \"../lib/generate.js\";\nimport { StructuredContext, ModuleIO } from \"../types\";\nimport { logInputOutput } from \"../utils/promptLogHelper.js\";\nimport { extractFileReferences } from \"../utils/extractFileReferences.js\";\nimport { SENTENCE_STARTER_WORDS, STOP_WORDS } from \"../fileRules/stopWords.js\";\nimport { buildResumePacket, renderResumePacket } from \"../utils/resumeState.js\";\nimport {\n    buildFallbackQuestions,\n    buildRollingPlanState,\n    resolvePlanModeState,\n} from \"../utils/rollingPlan.js\";\n\nexport interface UnderstandIntentInput {\n    context: StructuredContext;\n}\n\nexport interface UnderstandIntentOutput {\n    intent: string;\n    intentCategory: string;\n    normalizedQuery: string;\n    confidence: number;\n    questions?: Array<{\n        id?: string;\n        order?: number;\n        text?: string;\n        normalizedQuery?: string;\n        intentCategory?: string;\n        targetFiles?: string[];\n        targetSymbols?: string[];\n    }>;\n    targetFiles?: string[];\n    targetSymbols?: string[];\n}\n\nexport const understandIntentStep = {\n    name: \"understandIntent\",\n\n    description: \"Analyze the user query and determine its intent, type, and the appropriate task category.\",\n\n    /**\n     * Run the step\n     */\n    run: async (input: UnderstandIntentInput): Promise<void> => {\n        const { context } = input;\n        const rawQuery = (context.initContext?.userQuery ?? \"\").trim();\n        const commandName = rawQuery.startsWith(\"/\")\n            ? rawQuery.slice(1).trim().split(/\\s+/, 1)[0]?.toLowerCase()\n            : undefined;\n        const commandArgs = rawQuery.startsWith(\"/\")\n            ? rawQuery.replace(/^\\/\\S+\\s*/, \"\").trim()\n            : \"\";\n        const intentQuery = commandName === \"plan\" ? (commandArgs || rawQuery) : rawQuery;\n        const resumedContextCapsule =\n            renderResumePacket(buildResumePacket(context.analysis?.resumeState)) ||\n            context.initContext?.resumedContextCapsule?.trim();\n\n        // Fast-path for command-like probes (e.g. \"/tests\") to avoid unnecessary model calls.\n        if (rawQuery.startsWith(\"/\") && commandName !== \"plan\") {\n            const questions = buildFallbackQuestions({\n                rawQuery: commandArgs || rawQuery,\n                intentCategory: \"request\",\n                targetFiles: extractFileReferences(commandArgs),\n                targetSymbols: extractLikelySymbols(commandArgs),\n            });\n            context.analysis ??= {};\n            context.analysis.intent = {\n                intent: \"Handle command-like query input\",\n                intentCategory: \"request\",\n                normalizedQuery: commandArgs || rawQuery,\n                confidence: 0.9,\n                targetFiles: extractFileReferences(commandArgs),\n                targetSymbols: extractLikelySymbols(commandArgs),\n                questions,\n            };\n            context.analysis.planMode = resolvePlanModeState({\n                rawQuery,\n                normalizedQuery: commandArgs || rawQuery,\n                intentCategory: \"request\",\n                questions,\n            });\n            context.analysis.rollingPlan = buildRollingPlanState(context, \"initial\");\n            return;\n        }\n\n        const prompt = `\nYou are an AI assistant whose job is to determine the user's intent.\n\nUser Query:\n${intentQuery}\n\n${resumedContextCapsule ? `Resumed Context:\\n${resumedContextCapsule}\\n` : \"\"}\n\nReturn a STRICT JSON object with the following fields:\n{\n  \"intent\": \"short sentence summarizing the user's intent\",\n  \"intentCategory\": \"one of: question, request, codingTask, refactorTask, explanation, debugging, planning, writing, docsAndComments\",\n  \"normalizedQuery\": \"a cleaned and direct restatement of the user query\",\n  \"confidence\": 0-1,  // float\n  \"questions\": [\n    {\n      \"id\": \"q1\",\n      \"order\": 0,\n      \"text\": \"optional ordered user-facing question\",\n      \"normalizedQuery\": \"optional cleaned question\",\n      \"intentCategory\": \"question\",\n      \"targetFiles\": [\"optional explicit file or folder refs for this question\"],\n      \"targetSymbols\": [\"optional symbol refs for this question\"]\n    }\n  ],\n  \"targetFiles\": [\"optional explicit file or folder refs from user query\"],\n  \"targetSymbols\": [\"optional function/class/identifier targets from user query\"]\n}\n\nOnly include \"questions\" when the user clearly asked more than one direct question or distinct ask.\nPreserve user order.\nDo not include commentary. Emit ONLY valid JSON.\n        `.trim();\n\n        try {\n            const genInput: ModuleIO = {\n                query: rawQuery,\n                content: prompt\n            };\n\n            const genOutput: ModuleIO = await generate(genInput, {\n                caller: \"understandIntentStep\",\n                inputContext: {\n                    userQuery: rawQuery,\n                    resumedContextCapsule,\n                },\n            });\n            let raw = genOutput.data;\n\n            if (typeof raw !== \"string\") raw = JSON.stringify(raw ?? \"{}\");\n\n            let parsed;\n            try {\n                parsed = JSON.parse(raw);\n            } catch {\n                parsed = {\n                    intent: \"unknown\",\n                    intentCategory: \"\",\n                    normalizedQuery: context.initContext?.userQuery,\n                    confidence: 0.3\n                };\n            }\n\n            // ---------------------\n            // Fallback for invalid / \"other\" categories\n            // ---------------------\n            let category = parsed.intentCategory?.trim();\n            if (!category || category.toLowerCase() === \"other\") {\n                const q = parsed.normalizedQuery?.toLowerCase() ?? \"\";\n\n                if (q.includes(\"move\") || q.includes(\"append\") || q.includes(\"remove\") || q.includes(\"insert\")) {\n                    category = \"refactorTask\";\n                } else if (q.includes(\"comment\") || q.includes(\"documentation\") || q.includes(\"jsdoc\") || q.includes(\"docstring\")) {\n                    category = \"docsAndComments\";\n                } else if (q.includes(\"sentence\") || q.includes(\"file\")) {\n                    category = \"explanation\";\n                } else {\n                    category = \"request\"; // safe default\n                }\n            }\n\n            category = normalizeIntentCategory(category);\n\n            const intentConfidence = normalizeConfidence(parsed.confidence, 0.5);\n            const llmTargetFiles = Array.isArray(parsed.targetFiles) ? parsed.targetFiles : [];\n            const llmTargetSymbols = Array.isArray(parsed.targetSymbols) ? parsed.targetSymbols : [];\n\n            // If model confidence is high and it already provided explicit targets,\n            // avoid merging raw-query regex matches (pasted logs can add heavy noise).\n            // Example:\n            // - high confidence + targetFiles=[\"fileIndex.ts\"] => keep only that target\n            // - low confidence or no targets => merge heuristic extraction from raw query\n            const shouldMergeHeuristics =\n                intentConfidence < 0.6 ||\n                (llmTargetFiles.length === 0 && llmTargetSymbols.length === 0);\n\n            const targetFiles = mergeUniqueCaseInsensitive(\n                llmTargetFiles,\n                shouldMergeHeuristics ? extractFileReferences(rawQuery) : []\n            );\n            const targetSymbols = mergeUniqueCaseInsensitive(\n                llmTargetSymbols,\n                shouldMergeHeuristics ? extractLikelySymbols(rawQuery) : []\n            );\n\n            // Ensure the analysis object exists\n            context.analysis ??= {};\n            // Store intent inside a dedicated object\n            const parsedQuestions = normalizeQuestions({\n                rawQuery,\n                parsedQuestions: Array.isArray(parsed.questions) ? parsed.questions : [],\n                defaultIntentCategory: category,\n                fallbackTargetFiles: targetFiles,\n                fallbackTargetSymbols: targetSymbols,\n            });\n            const questions = preferDeterministicQuestionSplit({\n                rawQuery,\n                parsedQuestions,\n                defaultIntentCategory: category,\n                fallbackTargetFiles: targetFiles,\n                fallbackTargetSymbols: targetSymbols,\n            });\n            context.analysis.intent = {\n                intent: parsed.intent,\n                intentCategory: category,\n                normalizedQuery: parsed.normalizedQuery ?? intentQuery,\n                confidence: intentConfidence,\n                questions,\n                targetFiles,\n                targetSymbols,\n            };\n            if (context.task) {\n                context.task.taskQuestions = questions.map((question) => question.text);\n                context.task.taskQuestionDetails = questions;\n            }\n            context.analysis.planMode = resolvePlanModeState({\n                rawQuery,\n                normalizedQuery: context.analysis.intent.normalizedQuery,\n                intentCategory: category,\n                questions,\n            });\n            context.analysis.rollingPlan = buildRollingPlanState(\n                context,\n                context.analysis.planMode.enabled ? \"initial\" : \"rolling\"\n            );\n\n            logInputOutput(\"understandIntent\", \"output\", {\n                callId: genOutput.trace?.callId,\n                intent: context.analysis.intent.intent,\n                intentCategory: context.analysis.intent.intentCategory,\n                normalizedQuery: context.analysis.intent.normalizedQuery,\n                confidence: context.analysis.intent.confidence,\n                questions: context.analysis.intent.questions,\n                targetFiles: context.analysis.intent.targetFiles,\n                targetSymbols: context.analysis.intent.targetSymbols,\n                planMode: context.analysis.planMode,\n            });\n\n        } catch (err) {\n            console.error(\"understandIntent error:\", err);\n\n            // Ensure the analysis object exists\n            context.analysis ??= {};\n            context.analysis.intent = {\n                intent: \"unknown\",\n                intentCategory: \"request\",\n                normalizedQuery: rawQuery,\n                confidence: 0.0,\n                questions: buildFallbackQuestions({\n                    rawQuery,\n                    intentCategory: \"request\",\n                    targetFiles: extractFileReferences(intentQuery),\n                    targetSymbols: extractLikelySymbols(intentQuery),\n                }),\n                targetFiles: extractFileReferences(intentQuery),\n                targetSymbols: extractLikelySymbols(intentQuery),\n            };\n            if (context.task) {\n                context.task.taskQuestions = context.analysis.intent.questions?.map((question) => question.text) ?? [];\n                context.task.taskQuestionDetails = context.analysis.intent.questions;\n            }\n            context.analysis.planMode = resolvePlanModeState({\n                rawQuery,\n                normalizedQuery: intentQuery,\n                intentCategory: \"request\",\n                questions: context.analysis.intent.questions ?? [],\n            });\n            context.analysis.rollingPlan = buildRollingPlanState(context, \"initial\");\n        }\n    }\n};\n\nfunction normalizeQuestions(args: {\n    rawQuery: string;\n    parsedQuestions: Array<Record<string, unknown>>;\n    defaultIntentCategory: string;\n    fallbackTargetFiles: string[];\n    fallbackTargetSymbols: string[];\n}) {\n    const normalized = args.parsedQuestions\n        .map((question, index) => {\n            const text = typeof question.text === \"string\" ? question.text.trim() : \"\";\n            const normalizedQuery =\n                typeof question.normalizedQuery === \"string\" && question.normalizedQuery.trim().length > 0\n                    ? question.normalizedQuery.trim()\n                    : text;\n            if (!text && !normalizedQuery) return undefined;\n            return {\n                id: typeof question.id === \"string\" && question.id.trim().length > 0 ? question.id.trim() : `q${index + 1}`,\n                order: typeof question.order === \"number\" ? question.order : index,\n                text: text || normalizedQuery,\n                normalizedQuery: normalizedQuery || text,\n                intentCategory: normalizeIntentCategory(question.intentCategory ?? args.defaultIntentCategory),\n                targetFiles: mergeUniqueCaseInsensitive(\n                    Array.isArray(question.targetFiles) ? question.targetFiles as string[] : [],\n                    []\n                ),\n                targetSymbols: mergeUniqueCaseInsensitive(\n                    Array.isArray(question.targetSymbols) ? question.targetSymbols as string[] : [],\n                    []\n                ),\n            };\n        })\n        .filter((question): question is NonNullable<typeof question> => Boolean(question))\n        .sort((left, right) => left.order - right.order);\n\n    if (normalized.length > 0) {\n        return normalized;\n    }\n\n    return buildFallbackQuestions({\n        rawQuery: args.rawQuery,\n        intentCategory: args.defaultIntentCategory,\n        targetFiles: args.fallbackTargetFiles,\n        targetSymbols: args.fallbackTargetSymbols,\n    });\n}\n\nfunction preferDeterministicQuestionSplit(args: {\n    rawQuery: string;\n    parsedQuestions: ReturnType<typeof normalizeQuestions>;\n    defaultIntentCategory: string;\n    fallbackTargetFiles: string[];\n    fallbackTargetSymbols: string[];\n}) {\n    const deterministic = buildDeterministicQuestions({\n        rawQuery: args.rawQuery,\n        intentCategory: args.defaultIntentCategory,\n        fallbackTargetFiles: args.fallbackTargetFiles,\n        fallbackTargetSymbols: args.fallbackTargetSymbols,\n    });\n    if (deterministic.length > 1 && args.parsedQuestions.length <= 1) {\n        return deterministic;\n    }\n    return args.parsedQuestions;\n}\n\nfunction buildDeterministicQuestions(args: {\n    rawQuery: string;\n    intentCategory: string;\n    fallbackTargetFiles: string[];\n    fallbackTargetSymbols: string[];\n}) {\n    const parts = splitDirectQuestions(args.rawQuery);\n    if (parts.length <= 1) {\n        return buildFallbackQuestions({\n            rawQuery: args.rawQuery,\n            intentCategory: args.intentCategory,\n            targetFiles: args.fallbackTargetFiles,\n            targetSymbols: args.fallbackTargetSymbols,\n        });\n    }\n\n    return parts.map((text, index) => ({\n        id: `q${index + 1}`,\n        order: index,\n        text,\n        normalizedQuery: text,\n        intentCategory: args.intentCategory || \"question\",\n        targetFiles: mergeUniqueCaseInsensitive(extractFileReferences(text), args.fallbackTargetFiles),\n        targetSymbols: mergeUniqueCaseInsensitive(extractLikelySymbols(text), args.fallbackTargetSymbols),\n    }));\n}\n\nfunction splitDirectQuestions(rawQuery: string): string[] {\n    const trimmed = rawQuery.trim();\n    if (!trimmed) return [];\n\n    const questionMarkParts = trimmed\n        .split(/\\?+/)\n        .map(part => part.trim())\n        .filter(Boolean);\n    if ((trimmed.match(/\\?/g) ?? []).length >= 2 && questionMarkParts.length >= 2) {\n        return questionMarkParts.map(part => ensureQuestionMark(part));\n    }\n\n    const directQuestionParts = splitOnQuestionJoiners(trimmed);\n    return directQuestionParts.length >= 2 ? directQuestionParts : [ensureQuestionMark(trimmed)];\n}\n\nfunction splitOnQuestionJoiners(query: string): string[] {\n    const matches = Array.from(\n        query.matchAll(/\\s+(?:and|also)\\s+(?=(how|what|where|why|which|who|is|are|do|does|can|should|could|would)\\b)/gi)\n    );\n    if (matches.length === 0) {\n        return [];\n    }\n\n    const parts: string[] = [];\n    let start = 0;\n    for (const match of matches) {\n        const index = match.index ?? -1;\n        if (index <= start) continue;\n        parts.push(query.slice(start, index).trim());\n        const fullMatch = String(match[0] ?? \"\");\n        const nextQuestionLead = String(match[1] ?? \"\");\n        const leadOffset = fullMatch.toLowerCase().lastIndexOf(nextQuestionLead.toLowerCase());\n        start = index + (leadOffset >= 0 ? leadOffset : fullMatch.length);\n    }\n    parts.push(query.slice(start).trim());\n\n    return parts.map(part => ensureQuestionMark(part)).filter(Boolean);\n}\n\nfunction ensureQuestionMark(value: string): string {\n    const trimmed = value.trim();\n    if (!trimmed) return \"\";\n    return /[?.!]$/.test(trimmed) ? trimmed : `${trimmed}?`;\n}\n\nfunction mergeUniqueCaseInsensitive(primary: string[], secondary: string[]): string[] {\n    const out: string[] = [];\n    const seen = new Set<string>();\n    for (const token of [...primary, ...secondary]) {\n        if (typeof token !== \"string\") continue;\n        const trimmed = token.trim();\n        if (!trimmed) continue;\n        const key = trimmed.toLowerCase();\n        if (seen.has(key)) continue;\n        seen.add(key);\n        out.push(trimmed);\n    }\n    return out;\n}\n\nfunction extractLikelySymbols(query: string): string[] {\n    // Heuristic symbol detector used to enrich intent targets.\n    // Example: \"Refactor ChangeLogModule and runQueryWithDaemonControl\" -> keeps both.\n    // Example: \"Can you help...\" -> drops \"Can\" as a sentence starter.\n    const matches = query.match(/[A-Za-z_][A-Za-z0-9_]{2,}/g) ?? [];\n    const out = new Set<string>();\n    const symbolSuffixes = [\"Step\", \"Module\", \"Cmd\", \"Service\", \"Controller\", \"Handler\", \"Manager\"];\n\n    for (const token of matches) {\n        const lowered = token.toLowerCase();\n        if (STOP_WORDS.has(lowered) || SENTENCE_STARTER_WORDS.has(lowered)) continue;\n\n        const looksLikeSymbol =\n            /[a-z][A-Z]/.test(token) ||\n            /[A-Z]{2,}[a-z]/.test(token) ||\n            token.includes(\"_\") ||\n            /[0-9]/.test(token) ||\n            symbolSuffixes.some((suffix) => token.endsWith(suffix));\n        if (!looksLikeSymbol) continue;\n        if (token.length < 4 && !symbolSuffixes.some((suffix) => token.endsWith(suffix))) continue;\n        out.add(token);\n    }\n\n    return Array.from(out);\n}\n\nfunction normalizeConfidence(value: unknown, fallback = 0.5): number {\n    if (typeof value !== \"number\" || !Number.isFinite(value)) {\n        return fallback;\n    }\n    return Math.max(0, Math.min(1, value));\n}\n\nfunction normalizeIntentCategory(raw: unknown): string {\n    const value = typeof raw === \"string\" ? raw.trim().toLowerCase() : \"\";\n    if (!value) return \"request\";\n\n    const directMap: Record<string, string> = {\n        question: \"question\",\n        request: \"request\",\n        codingtask: \"codingTask\",\n        refactortask: \"refactorTask\",\n        explanation: \"explanation\",\n        debugging: \"debugging\",\n        planning: \"planning\",\n        writing: \"writing\",\n        docsandcomments: \"docsAndComments\",\n        docsandcomment: \"docsAndComments\",\n        docs: \"docsAndComments\",\n        comments: \"docsAndComments\",\n        comment: \"docsAndComments\",\n        analysis: \"question\",\n        analyze: \"question\",\n        architecture: \"explanation\",\n    };\n\n    return directMap[value] ?? \"request\";\n}\n"]}

package/dist/agents/validateChangesStep.js

@@ -32,6 +32,7 @@ export const validateChangesStep = {
         let status = 'invalid';
         let rationale = '';
         let actualChange = '';
+        let callId;
         if (artifact) {
             actualChange = artifact.notes ?? artifact.content ?? 'No changes detected';
             status = 'valid';
@@ -67,7 +68,16 @@ Task:
                 const ai = await generate({
                     query: context.initContext?.userQuery ?? `validate ${targetFile}`,
                     content: prompt,
+                }, {
+                    caller: "validateChangesStep",
+                    inputContext: {
+                        userQuery: context.initContext?.userQuery ?? `validate ${targetFile}`,
+                        targetFile,
+                        proposedChanges: fileAnalysis.proposedChanges,
+                        transformedContent: artifact.content ?? "[no content]",
+                    },
                 });
+                callId = ai.trace?.callId;
                 let cleaned;
                 try {
                     cleaned = await cleanupModule.run({
@@ -102,15 +112,19 @@ Task:
         }
         const validation = {
             filePath: targetFile,
-            expectedChange: fileAnalysis.proposedChanges?.summary ?? 'No expected change defined',
+            expectedChange: fileAnalysis.proposedChanges?.summary ??
+                'Insufficient expected change from semantic analysis',
             actualChange,
             status,
             rationale,
             requiresRedo: status !== 'valid',
         };
-        exec.validations = [validation];
+        const priorValidations = (exec.validations ?? []).filter(v => v.filePath !== targetFile);
+        exec.validations = [...priorValidations, validation];
         logInputOutput('validateChangesStep', 'output', {
+            callId,
             executionOutcome: exec,
         });
     },
 };
+//# sourceMappingURL=validateChangesStep.js.map

package/dist/agents/validateChangesStep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateChangesStep.js","sourceRoot":"","sources":["../../src/agents/validateChangesStep.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAErE;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IAC/B,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EACP,uFAAuF;IAE3F,QAAQ,EAAE,CAAC,2BAA2B,EAAE,uBAAuB,CAAC;IAChE,QAAQ,EAAE,CAAC,2BAA2B,EAAE,6BAA6B,CAAC;IAEtE,KAAK,CAAC,GAAG,CAAC,OAA0B;QAChC,OAAO,CAAC,QAAQ,KAAhB,OAAO,CAAC,QAAQ,GAAK,EAAE,EAAC;QACxB,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,gBAAgB,IAAI;YAC9C,eAAe,EAAE,EAAE;YACnB,WAAW,EAAE,EAAE;SAClB,CAAC;QACF,OAAO,CAAC,QAAQ,CAAC,gBAAgB,GAAG,IAAI,CAAC;QAEzC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC;YACvC,OAAO,CAAC,IAAI,CACR,uEAAuE,CAC1E,CAAC;YACF,OAAO;QACX,CAAC;QAED,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC;QAErD,MAAM,YAAY,GACd,OAAO,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC,UAAU,CAAC,CAAC;QAEhD,IAAI,CAAC,YAAY;YAAE,OAAO;QAE1B,yBAAyB;QACzB,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,EAAE,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC;QACzE,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,UAAU,CAAC,CAAC;QAEhE,6BAA6B;QAC7B,IAAI,MAAM,GAAoC,SAAS,CAAC;QACxD,IAAI,SAAS,GAAG,EAAE,CAAC;QACnB,IAAI,YAAY,GAAG,EAAE,CAAC;QACtB,IAAI,MAA0B,CAAC;QAE/B,IAAI,QAAQ,EAAE,CAAC;YACX,YAAY,GAAG,QAAQ,CAAC,KAAK,IAAI,QAAQ,CAAC,OAAO,IAAI,qBAAqB,CAAC;YAC3E,MAAM,GAAG,OAAO,CAAC;YACjB,SAAS,GAAG,iDAAiD,CAAC;QAClE,CAAC;aAAM,CAAC;YACJ,YAAY,GAAG,qCAAqC,CAAC;YACrD,MAAM,GAAG,SAAS,CAAC;YACnB,SAAS,GAAG,yDAAyD,CAAC;QAC1E,CAAC;QAED,IAAI,QAAQ,IAAI,YAAY,CAAC,eAAe,EAAE,CAAC;YAC3C,IAAI,CAAC;gBACD,MAAM,MAAM,GAAG;;;aAGlB,UAAU;;;EAGrB,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC;;;EAGrD,QAAQ,CAAC,OAAO,IAAI,cAAc;;;;;;;;;;CAUnC,CAAC,IAAI,EAAE,CAAC;gBAEO,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAC;oBACtB,KAAK,EAAE,OAAO,CAAC,WAAW,EAAE,SAAS,IAAI,YAAY,UAAU,EAAE;oBACjE,OAAO,EAAE,MAAM;iBAClB,EAAE;oBACC,MAAM,EAAE,qBAAqB;oBAC7B,YAAY,EAAE;wBACV,SAAS,EAAE,OAAO,CAAC,WAAW,EAAE,SAAS,IAAI,YAAY,UAAU,EAAE;wBACrE,UAAU;wBACV,eAAe,EAAE,YAAY,CAAC,eAAe;wBAC7C,kBAAkB,EAAE,QAAQ,CAAC,OAAO,IAAI,cAAc;qBACzD;iBACJ,CAAC,CAAC;gBACH,MAAM,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC;gBAE1B,IAAI,OAAY,CAAC;gBACjB,IAAI,CAAC;oBACD,OAAO,GAAG,MAAM,aAAa,CAAC,GAAG,CAAC;wBAC9B,KAAK,EAAE,OAAO,CAAC,WAAW,EAAE,SAAS,IAAI,YAAY,UAAU,EAAE;wBACjE,OAAO,EAAE,EAAE,CAAC,IAAI;qBACnB,CAAC,CAAC;gBACP,CAAC;gBAAC,OAAO,UAAU,EAAE,CAAC;oBAClB,OAAO,CAAC,IAAI,CACR,kDAAkD,UAAU,EAAE,EAC9D,UAAU,CACb,CAAC;oBACF,OAAO,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC;gBAClD,CAAC;gBAED,IAAI,YAAY,GAAQ,SAAS,CAAC;gBAClC,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;oBAC5D,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;gBAChC,CAAC;qBAAM,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;oBAC7C,IAAI,CAAC;wBACD,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;oBAC/C,CAAC;oBAAC,MAAM,CAAC;wBACL,YAAY,GAAG,SAAS,CAAC;oBAC7B,CAAC;gBACL,CAAC;gBAED,IAAI,YAAY,EAAE,MAAM;oBAAE,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC;gBACvD,IAAI,YAAY,EAAE,SAAS;oBAAE,SAAS,GAAG,YAAY,CAAC,SAAS,CAAC;YACpE,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACX,OAAO,CAAC,IAAI,CAAC,mDAAmD,UAAU,GAAG,EAAE,GAAG,CAAC,CAAC;YACxF,CAAC;QACL,CAAC;QAED,MAAM,UAAU,GAAqB;YACjC,QAAQ,EAAE,UAAU;YACpB,cAAc,EACV,YAAY,CAAC,eAAe,EAAE,OAAO;gBACrC,qDAAqD;YACzD,YAAY;YACZ,MAAM;YACN,SAAS;YACT,YAAY,EAAE,MAAM,KAAK,OAAO;SACnC,CAAC;QAEF,MAAM,gBAAgB,GAAG,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,UAAU,CAAC,CAAC;QACzF,IAAI,CAAC,WAAW,GAAG,CAAC,GAAG,gBAAgB,EAAE,UAAU,CAAC,CAAC;QAErD,cAAc,CAAC,qBAAqB,EAAE,QAAQ,EAAE;YAC5C,MAAM;YACN,gBAAgB,EAAE,IAAI;SACzB,CAAC,CAAC;IACP,CAAC;CACJ,CAAC","sourcesContent":["// File: src/agents/validateChangesStep.ts\nimport type {\n    StructuredContext,\n    ChangeValidation,\n    FileAnalysis,\n} from '../types.js';\nimport { logInputOutput } from '../utils/promptLogHelper.js';\nimport { generate } from '../lib/generate.js';\nimport { cleanupModule } from '../pipeline/modules/cleanupModule.js';\n\n/**\n * VALIDATE CHANGES STEP\n * Validates executed changes against expectations and emits iteration reasoning.\n */\nexport const validateChangesStep = {\n    name: 'validateChangesStep',\n    description:\n        'Validates executed changes against expected changes and produces iteration reasoning.',\n\n    requires: ['analysis.executionOutcome', 'analysis.fileAnalysis'],\n    produces: ['analysis.executionOutcome', 'analysis.iterationReasoning'],\n\n    async run(context: StructuredContext): Promise<void> {\n        context.analysis ||= {};\n        const exec = context.analysis.executionOutcome ?? {\n            executedStepIds: [],\n            validations: [],\n        };\n        context.analysis.executionOutcome = exec;\n\n        if (!context.task?.currentStep?.filePath) {\n            console.warn(\n                'validateChangesStep: no currentStep or filePath — skipping validation'\n            );\n            return;\n        }\n\n        const targetFile = context.task.currentStep.filePath;\n\n        const fileAnalysis: FileAnalysis | undefined =\n            context.analysis.fileAnalysis?.[targetFile];\n\n        if (!fileAnalysis) return;\n\n        // 🔹 Normalize artifacts\n        const artifacts = context.execution?.codeTransformArtifacts?.files ?? [];\n        const artifact = artifacts.find(f => f.filePath === targetFile);\n\n        // 🔹 Reason about validation\n        let status: 'valid' | 'partial' | 'invalid' = 'invalid';\n        let rationale = '';\n        let actualChange = '';\n        let callId: string | undefined;\n\n        if (artifact) {\n            actualChange = artifact.notes ?? artifact.content ?? 'No changes detected';\n            status = 'valid';\n            rationale = 'Transformation artifact exists for target file.';\n        } else {\n            actualChange = 'No transformation artifact produced';\n            status = 'invalid';\n            rationale = 'Expected changes were not executed or artifact missing.';\n        }\n\n        if (artifact && fileAnalysis.proposedChanges) {\n            try {\n                const prompt = `\nYou are validating a code transformation for a single file.\n\nFile path: ${targetFile}\n\nProposed changes:\n${JSON.stringify(fileAnalysis.proposedChanges, null, 2)}\n\nActual transformed content:\n${artifact.content ?? \"[no content]\"}\n\nTask:\n- Determine whether the proposed changes have been properly applied.\n- Consider the proposed targets and rationale.\n- Return STRICT JSON:\n{\n  \"status\": \"valid\" | \"partial\" | \"invalid\",\n  \"rationale\": \"Explain why the changes are valid/partial/invalid\"\n}\n`.trim();\n\n                const ai = await generate({\n                    query: context.initContext?.userQuery ?? `validate ${targetFile}`,\n                    content: prompt,\n                }, {\n                    caller: \"validateChangesStep\",\n                    inputContext: {\n                        userQuery: context.initContext?.userQuery ?? `validate ${targetFile}`,\n                        targetFile,\n                        proposedChanges: fileAnalysis.proposedChanges,\n                        transformedContent: artifact.content ?? \"[no content]\",\n                    },\n                });\n                callId = ai.trace?.callId;\n\n                let cleaned: any;\n                try {\n                    cleaned = await cleanupModule.run({\n                        query: context.initContext?.userQuery ?? `validate ${targetFile}`,\n                        content: ai.data,\n                    });\n                } catch (cleanupErr) {\n                    console.warn(\n                        `[validateChangesStep] cleanupModule failed for ${targetFile}`,\n                        cleanupErr\n                    );\n                    cleaned = { data: ai.data, content: ai.data };\n                }\n\n                let responseData: any = undefined;\n                if (typeof cleaned.data === 'object' && cleaned.data !== null) {\n                    responseData = cleaned.data;\n                } else if (typeof cleaned.content === 'string') {\n                    try {\n                        responseData = JSON.parse(cleaned.content);\n                    } catch {\n                        responseData = undefined;\n                    }\n                }\n\n                if (responseData?.status) status = responseData.status;\n                if (responseData?.rationale) rationale = responseData.rationale;\n            } catch (err) {\n                console.warn(`[validateChangesStep] LLM validation failed for ${targetFile}:`, err);\n            }\n        }\n\n        const validation: ChangeValidation = {\n            filePath: targetFile,\n            expectedChange:\n                fileAnalysis.proposedChanges?.summary ??\n                'Insufficient expected change from semantic analysis',\n            actualChange,\n            status,\n            rationale,\n            requiresRedo: status !== 'valid',\n        };\n\n        const priorValidations = (exec.validations ?? []).filter(v => v.filePath !== targetFile);\n        exec.validations = [...priorValidations, validation];\n\n        logInputOutput('validateChangesStep', 'output', {\n            callId,\n            executionOutcome: exec,\n        });\n    },\n};\n"]}

package/dist/agents/writeFileStep.js

@@ -111,3 +111,4 @@ export const writeFileStep = {
         return output;
     }
 };
+//# sourceMappingURL=writeFileStep.js.map

package/dist/agents/writeFileStep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writeFileStep.js","sourceRoot":"","sources":["../../src/agents/writeFileStep.ts"],"names":[],"mappings":"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","sourcesContent":["// File: src/modules/writeFileModule.ts\nimport fs from \"fs/promises\";\nimport path from \"path\";\nimport chalk from \"chalk\";\nimport { normalizePath } from \"../utils/contentUtils.js\";\nimport { Module, ModuleIO, StructuredContext } from \"../types.js\";\nimport { logInputOutput } from \"../utils/promptLogHelper.js\";\nimport { MODULE_STEP_INDENTATION } from \"../constants.js\";\n\nexport interface WriteFileData {\n    writeMode: string;\n    writtenFiles: string[];\n    errors: string[];\n}\n\nexport const writeFileStep: Module = {\n    name: \"writeFile\",\n    description:\n        \"Writes materialized file outputs from codeTransformModule to disk. \" +\n        \"Each artifact is written exactly once.\",\n    groups: [\"finalize\"],\n\n    run: async (input: ModuleIO): Promise<ModuleIO> => {\n        const context = input.context as StructuredContext | undefined;\n        const mode = (input.data as any)?.mode ?? \"overwrite\";\n\n        const writtenFiles: string[] = [];\n        const errors: string[] = [];\n\n        if (!context) {\n            console.error(`${MODULE_STEP_INDENTATION} writeFileStep: Missing execution context`);\n            return {\n                query: input.query,\n                data: { writeMode: mode, writtenFiles, errors: [\"Missing execution context\"] }\n            };\n        }\n\n        const artifacts = context.execution?.codeTransformArtifacts?.files ?? [];\n\n        // 🔹 Use DB-backed currentStep as authoritative target\n        const currentStepFile = context.task?.currentStep?.filePath\n            ? normalizePath(context.task.currentStep.filePath)\n            : undefined;\n\n        // 🔎 Debug visibility (pre-write)\n        logInputOutput(\"writeFile\", \"input\", {\n            artifactCount: artifacts.length,\n            currentStepFile,\n            artifacts: artifacts.map(a => ({\n                filePath: normalizePath(a.filePath),\n                written: (a as any).written === true\n            }))\n        });\n\n        for (const artifact of artifacts) {\n            const filePath = normalizePath(artifact.filePath);\n\n            // Skip already-written artifacts\n            if ((artifact as any).written === true) {\n                continue;\n            }\n\n            // Optional: scope writes to currentStep file\n            if (currentStepFile && filePath !== currentStepFile) {\n                continue;\n            }\n\n            if (!filePath) {\n                const msg = `Invalid filePath: ${artifact.filePath}`;\n                console.error(msg);\n                errors.push(msg);\n                continue;\n            }\n\n            if (typeof artifact.content !== \"string\" || !artifact.content.trim()) {\n                const msg = `Write expected but content is empty for ${filePath}`;\n                console.error(msg);\n                errors.push(msg);\n                continue;\n            }\n\n            try {\n                // 🔍 Detect no-op writes (content identical)\n                let existingContent: string | null = null;\n                try {\n                    existingContent = await fs.readFile(filePath, \"utf-8\");\n                } catch {\n                    // File may not exist yet — that's fine\n                }\n\n                if (existingContent !== null && existingContent === artifact.content) {\n                    console.log(\n                        chalk.yellow(\n                            `${MODULE_STEP_INDENTATION} SKIP write (content identical): ${filePath}`\n                        )\n                    );\n                    (artifact as any).written = true;\n                    continue;\n                }\n\n                await fs.mkdir(path.dirname(filePath), { recursive: true });\n                await fs.writeFile(filePath, artifact.content, \"utf-8\");\n\n                console.log(\n                    chalk.blue(`${MODULE_STEP_INDENTATION} Wrote file: ${filePath}`)\n                );\n\n                writtenFiles.push(filePath);\n                (artifact as any).written = true;\n\n            } catch (err: any) {\n                const msg = err?.message ?? String(err);\n                console.error(\n                    chalk.red(`${MODULE_STEP_INDENTATION} Failed writing ${filePath}: ${msg}`)\n                );\n                errors.push(`${filePath}: ${msg}`);\n            }\n        }\n\n        // Mark files as touched (append-only)\n        context.plan ??= {};\n        context.plan.touchedFiles ??= [];\n        for (const file of writtenFiles) {\n            if (!context.plan.touchedFiles.includes(file)) {\n                context.plan.touchedFiles.push(file);\n            }\n        }\n\n        const output: ModuleIO = {\n            query: input.query,\n            data: { writeMode: mode, writtenFiles, errors }\n        };\n\n        // 🔎 Debug visibility (post-write)\n        logInputOutput(\"writeFile\", \"output\", {\n            artifactCount: artifacts.length,\n            currentStepFile,\n            artifacts: artifacts.map(a => ({\n                filePath: normalizePath(a.filePath),\n                contentPreview: (a.content ?? \"\").slice(0, 100),\n                written: (a as any).written === true\n            }))\n        });\n\n        console.log(`${MODULE_STEP_INDENTATION} writeFileStep complete`);\n        return output;\n    }\n};\n"]}