scai 0.1.178 → 1.0.1

package/dist/agents/researchPlanGenStep.js

@@ -1,25 +1,22 @@
-// File: src/agents/researchPlanGenStep.ts
+/**
+ * Generates ordered research steps for repo-wide or multi-question work.
+ *
+ * Why this file exists:
+ * - research planning should stay small and typed even when the task is broad
+ * - ordered question parts now give the planner one stable view of user-facing sub-questions
+ * - runtime execution still owns when those research steps actually run
+ */
 import { generate } from "../lib/generate.js";
 import { cleanupModule } from "../pipeline/modules/cleanupModule.js";
 import { logInputOutput } from "../utils/promptLogHelper.js";
-const RESEARCH_ACTIONS = [
-    {
-        action: "research-impact-map",
-        description: "Map expected cross-file impact and affected areas before edits.",
-    },
-    {
-        action: "research-symbol-trace",
-        description: "Trace key symbols and call paths across candidate files.",
-    },
-    {
-        action: "research-risk-check",
-        description: "Identify risks, assumptions, and safety constraints.",
-    },
-    {
-        action: "research-architecture-synthesis",
-        description: "Synthesize architecture, hotspots, and coupling points from findings.",
-    },
-];
+import { getActionsByPhase } from "./actionRegistry.js";
+import { buildResumePacket, renderResumePacket } from "../utils/resumeState.js";
+// Runtime registry is now authoritative for allowed research actions.
+const RESEARCH_ACTIONS = getActionsByPhase("research")
+    .map(spec => ({
+    action: spec.id,
+    description: `${spec.id} (${spec.executorKind}, ${spec.safety})`,
+}));
 /**
  * RESEARCH PLAN GENERATOR
  * Produces ordered research steps tailored to the current query and scope.
@@ -37,9 +34,19 @@ export const researchPlanGenStep = {
             context.initContext?.userQuery ??
             "";
         const intentCategory = context.analysis.intent?.intentCategory ?? "request";
+        const orderedQuestions = context.analysis.intent?.questions ?? [];
         const scopeType = context.analysis.scopeType ?? "repo-wide";
-        const selectedFiles = context.analysis.focus?.selectedFiles ?? [];
-        const candidateFiles = context.analysis.focus?.candidateFiles ?? [];
+        const selectedFiles = context.analysis.executionPolicy?.executionRequired ??
+            context.analysis.focus?.executionRequired ??
+            context.analysis.focus?.selectedFiles ??
+            [];
+        const candidateFiles = context.analysis.executionPolicy?.explorationCandidates ??
+            context.analysis.focus?.explorationCandidates ??
+            context.analysis.focus?.candidateFiles ??
+            [];
+        const resumedContextCapsule = renderResumePacket(buildResumePacket(context.analysis?.resumeState)) ||
+            context.initContext?.resumedContextCapsule ||
+            "";
         const prompt = `
 You are generating a research-only execution plan for a coding agent.
 
@@ -58,28 +65,47 @@ ${JSON.stringify(selectedFiles.slice(0, 20), null, 2)}
 Candidate files (current):
 ${JSON.stringify(candidateFiles.slice(0, 30), null, 2)}
 
+${resumedContextCapsule ? `Resumed context capsule:\n${resumedContextCapsule}\n` : ""}
+
+Ordered question parts:
+${JSON.stringify(orderedQuestions, null, 2)}
+
 Allowed research actions (use only these):
 ${JSON.stringify(RESEARCH_ACTIONS, null, 2)}
 
 Rules:
 - Return 2-4 ordered steps.
 - Every step action must be one of the allowed research actions.
+- Include "questionId" when one question clearly owns the step.
 - Include architecture synthesis as final step when scope is multi-file or repo-wide.
 - Prefer deterministic filePath values:
   - research-impact-map => "__research__/impact-map"
   - research-symbol-trace => "__research__/symbol-trace"
   - research-risk-check => "__research__/risk-check"
   - research-architecture-synthesis => "__research__/architecture-synthesis"
+  - research-trail-expand => "__research__/trail-expand"
 - Return strict JSON only:
 {
   "steps": [
-    { "id": "research:1", "action": "research-impact-map", "targetFile": "__research__/impact-map", "description": "..." }
+    { "id": "research:1", "action": "research-impact-map", "actionId": "research-impact-map", "actionArgs": {}, "targetFile": "__research__/impact-map", "description": "..." }
   ]
 }
         `.trim();
         try {
             const input = { query: intentText, content: prompt };
-            const generated = await generate(input);
+            const generated = await generate(input, {
+                caller: "researchPlanGenStep",
+                inputContext: {
+                    intentText,
+                    intentCategory,
+                    orderedQuestions,
+                    scopeType,
+                    selectedFiles,
+                    candidateFiles,
+                    resumedContextCapsule,
+                    allowedActions: RESEARCH_ACTIONS,
+                },
+            });
             const raw = typeof generated.data === "string"
                 ? generated.data
                 : JSON.stringify(generated.data ?? "{}");
@@ -100,10 +126,16 @@ Rules:
                         ? "__research__/symbol-trace"
                         : action === "research-risk-check"
                             ? "__research__/risk-check"
-                            : "__research__/architecture-synthesis";
+                            : action === "research-trail-expand"
+                                ? "__research__/trail-expand"
+                                : "__research__/architecture-synthesis";
                 return {
                     id: step.id ?? `research:${index + 1}`,
                     action,
+                    // Example: action="research-risk-check" stays identical actionId.
+                    actionId: step.actionId ?? action,
+                    actionArgs: step.actionArgs ?? {},
+                    questionId: typeof step.questionId === "string" ? step.questionId : undefined,
                     targetFile: step.targetFile ?? defaultFile,
                     description: step.description ?? `Run ${action}`,
                     metadata: step.metadata ?? {},
@@ -112,7 +144,10 @@ Rules:
             })
                 .slice(0, 4);
             context.analysis.planSuggestion = { plan: { steps: normalized } };
-            logInputOutput("researchPlanGen", "output", { steps: normalized });
+            logInputOutput("researchPlanGen", "output", {
+                callId: generated.trace?.callId,
+                steps: normalized,
+            });
         }
         catch (err) {
             console.warn("[researchPlanGenStep] Failed to generate research plan:", err);
@@ -121,3 +156,4 @@ Rules:
         }
     },
 };
+//# sourceMappingURL=researchPlanGenStep.js.map

package/dist/agents/researchPlanGenStep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"researchPlanGenStep.js","sourceRoot":"","sources":["../../src/agents/researchPlanGenStep.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAchF,sEAAsE;AACtE,MAAM,gBAAgB,GAA2D,iBAAiB,CAAC,UAAU,CAAC;KACzG,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACV,MAAM,EAAE,IAAI,CAAC,EAAoB;IACjC,WAAW,EAAE,GAAG,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,YAAY,KAAK,IAAI,CAAC,MAAM,GAAG;CACnE,CAAC,CAAC,CAAC;AAER;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IAC/B,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE,+DAA+D;IAC5E,QAAQ,EAAE,CAAC,iBAAiB,EAAE,oBAAoB,EAAE,0BAA0B,CAAC;IAC/E,QAAQ,EAAE,CAAC,yBAAyB,CAAC;IAErC,KAAK,CAAC,GAAG,CAAC,OAA0B;QAChC,OAAO,CAAC,QAAQ,KAAhB,OAAO,CAAC,QAAQ,GAAK,EAAE,EAAC;QACxB,OAAO,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;QAEvC,MAAM,UAAU,GACZ,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,eAAe;YACxC,OAAO,CAAC,WAAW,EAAE,SAAS;YAC9B,EAAE,CAAC;QACP,MAAM,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,cAAc,IAAI,SAAS,CAAC;QAC5E,MAAM,gBAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,IAAI,EAAE,CAAC;QAClE,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,SAAS,IAAI,WAAW,CAAC;QAC5D,MAAM,aAAa,GACf,OAAO,CAAC,QAAQ,CAAC,eAAe,EAAE,iBAAiB;YACnD,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,iBAAiB;YACzC,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,aAAa;YACrC,EAAE,CAAC;QACP,MAAM,cAAc,GAChB,OAAO,CAAC,QAAQ,CAAC,eAAe,EAAE,qBAAqB;YACvD,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,qBAAqB;YAC7C,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,cAAc;YACtC,EAAE,CAAC;QACP,MAAM,qBAAqB,GACvB,kBAAkB,CAAC,iBAAiB,CAAC,OAAO,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;YACpE,OAAO,CAAC,WAAW,EAAE,qBAAqB;YAC1C,EAAE,CAAC;QAEP,MAAM,MAAM,GAAG;;;;EAIrB,UAAU;;;EAGV,cAAc;;;EAGd,SAAS;;;EAGT,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;;;EAGnD,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;;EAEpD,qBAAqB,CAAC,CAAC,CAAC,6BAA6B,qBAAqB,IAAI,CAAC,CAAC,CAAC,EAAE;;;EAGnF,IAAI,CAAC,SAAS,CAAC,gBAAgB,EAAE,IAAI,EAAE,CAAC,CAAC;;;EAGzC,IAAI,CAAC,SAAS,CAAC,gBAAgB,EAAE,IAAI,EAAE,CAAC,CAAC;;;;;;;;;;;;;;;;;;;SAmBlC,CAAC,IAAI,EAAE,CAAC;QAET,IAAI,CAAC;YACD,MAAM,KAAK,GAAa,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;YAC/D,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,KAAK,EAAE;gBACpC,MAAM,EAAE,qBAAqB;gBAC7B,YAAY,EAAE;oBACV,UAAU;oBACV,cAAc;oBACd,gBAAgB;oBAChB,SAAS;oBACT,aAAa;oBACb,cAAc;oBACd,qBAAqB;oBACrB,cAAc,EAAE,gBAAgB;iBACnC;aACJ,CAAC,CAAC;YACH,MAAM,GAAG,GACL,OAAO,SAAS,CAAC,IAAI,KAAK,QAAQ;gBAC9B,CAAC,CAAC,SAAS,CAAC,IAAI;gBAChB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC;YACjD,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;YAC7E,MAAM,UAAU,GACZ,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ;gBAC/B,CAAC,CAAC,OAAO,CAAC,OAAO;gBACjB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC;YAElD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAgC,CAAC;YACrE,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YACvE,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;YAEhE,MAAM,UAAU,GAAoB,cAAc;iBAC7C,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,IAAI,EAAE,MAAM,KAAK,QAAQ,IAAI,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,MAAwB,CAAC,CAAC;iBACjG,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;gBACjB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAwB,CAAC;gBAC7C,MAAM,WAAW,GACb,MAAM,KAAK,qBAAqB;oBAC5B,CAAC,CAAC,yBAAyB;oBAC3B,CAAC,CAAC,MAAM,KAAK,uBAAuB;wBAChC,CAAC,CAAC,2BAA2B;wBAC7B,CAAC,CAAC,MAAM,KAAK,qBAAqB;4BAC9B,CAAC,CAAC,yBAAyB;4BAC3B,CAAC,CAAC,MAAM,KAAK,uBAAuB;gCAChC,CAAC,CAAC,2BAA2B;gCAC7B,CAAC,CAAC,qCAAqC,CAAC;gBAE5D,OAAO;oBACH,EAAE,EAAE,IAAI,CAAC,EAAE,IAAI,YAAY,KAAK,GAAG,CAAC,EAAE;oBACtC,MAAM;oBACN,kEAAkE;oBAClE,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,MAAM;oBACjC,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,EAAE;oBACjC,UAAU,EAAE,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;oBAC7E,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,WAAW;oBAC1C,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,OAAO,MAAM,EAAE;oBAChD,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,EAAE;oBAC7B,MAAM,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC;iBACnC,CAAC;YACN,CAAC,CAAC;iBACD,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAEjB,OAAO,CAAC,QAAQ,CAAC,cAAc,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,CAAC;YAClE,cAAc,CAAC,iBAAiB,EAAE,QAAQ,EAAE;gBACxC,MAAM,EAAE,SAAS,CAAC,KAAK,EAAE,MAAM;gBAC/B,KAAK,EAAE,UAAU;aACpB,CAAC,CAAC;QACP,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,OAAO,CAAC,IAAI,CAAC,yDAAyD,EAAE,GAAG,CAAC,CAAC;YAC7E,OAAO,CAAC,QAAQ,CAAC,cAAc,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC;YAC1D,cAAc,CAAC,iBAAiB,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;QAC/D,CAAC;IACL,CAAC;CACJ,CAAC","sourcesContent":["/**\n * Generates ordered research steps for repo-wide or multi-question work.\n *\n * Why this file exists:\n * - research planning should stay small and typed even when the task is broad\n * - ordered question parts now give the planner one stable view of user-facing sub-questions\n * - runtime execution still owns when those research steps actually run\n */\nimport { generate } from \"../lib/generate.js\";\nimport { cleanupModule } from \"../pipeline/modules/cleanupModule.js\";\nimport { logInputOutput } from \"../utils/promptLogHelper.js\";\nimport type { StructuredContext, ModuleIO, AgentPlanStep } from \"../types.js\";\nimport { getActionsByPhase } from \"./actionRegistry.js\";\nimport { buildResumePacket, renderResumePacket } from \"../utils/resumeState.js\";\n\n/**\n * Refactor note:\n * - Research allowlist now comes from runtime ActionRegistry.\n * - Why it exists: planners and runtime must share one action contract.\n */\ntype ResearchAction =\n    | \"research-impact-map\"\n    | \"research-symbol-trace\"\n    | \"research-risk-check\"\n    | \"research-architecture-synthesis\"\n    | \"research-trail-expand\";\n\n// Runtime registry is now authoritative for allowed research actions.\nconst RESEARCH_ACTIONS: Array<{ action: ResearchAction; description: string }> = getActionsByPhase(\"research\")\n    .map(spec => ({\n        action: spec.id as ResearchAction,\n        description: `${spec.id} (${spec.executorKind}, ${spec.safety})`,\n    }));\n\n/**\n * RESEARCH PLAN GENERATOR\n * Produces ordered research steps tailored to the current query and scope.\n * Example: for repo-wide architecture questions, prioritize symbol-trace + synthesis.\n */\nexport const researchPlanGenStep = {\n    name: \"researchPlanGen\",\n    description: \"Generates ordered research steps for repo-wide complex lanes.\",\n    requires: [\"analysis.intent\", \"analysis.scopeType\", \"analysis.routingDecision\"],\n    produces: [\"analysis.planSuggestion\"],\n\n    async run(context: StructuredContext): Promise<void> {\n        context.analysis ||= {};\n        delete context.analysis.planSuggestion;\n\n        const intentText =\n            context.analysis.intent?.normalizedQuery ??\n            context.initContext?.userQuery ??\n            \"\";\n        const intentCategory = context.analysis.intent?.intentCategory ?? \"request\";\n        const orderedQuestions = context.analysis.intent?.questions ?? [];\n        const scopeType = context.analysis.scopeType ?? \"repo-wide\";\n        const selectedFiles =\n            context.analysis.executionPolicy?.executionRequired ??\n            context.analysis.focus?.executionRequired ??\n            context.analysis.focus?.selectedFiles ??\n            [];\n        const candidateFiles =\n            context.analysis.executionPolicy?.explorationCandidates ??\n            context.analysis.focus?.explorationCandidates ??\n            context.analysis.focus?.candidateFiles ??\n            [];\n        const resumedContextCapsule =\n            renderResumePacket(buildResumePacket(context.analysis?.resumeState)) ||\n            context.initContext?.resumedContextCapsule ||\n            \"\";\n\n        const prompt = `\nYou are generating a research-only execution plan for a coding agent.\n\nUser intent:\n${intentText}\n\nIntent category:\n${intentCategory}\n\nScope:\n${scopeType}\n\nSelected files (current):\n${JSON.stringify(selectedFiles.slice(0, 20), null, 2)}\n\nCandidate files (current):\n${JSON.stringify(candidateFiles.slice(0, 30), null, 2)}\n\n${resumedContextCapsule ? `Resumed context capsule:\\n${resumedContextCapsule}\\n` : \"\"}\n\nOrdered question parts:\n${JSON.stringify(orderedQuestions, null, 2)}\n\nAllowed research actions (use only these):\n${JSON.stringify(RESEARCH_ACTIONS, null, 2)}\n\nRules:\n- Return 2-4 ordered steps.\n- Every step action must be one of the allowed research actions.\n- Include \"questionId\" when one question clearly owns the step.\n- Include architecture synthesis as final step when scope is multi-file or repo-wide.\n- Prefer deterministic filePath values:\n  - research-impact-map => \"__research__/impact-map\"\n  - research-symbol-trace => \"__research__/symbol-trace\"\n  - research-risk-check => \"__research__/risk-check\"\n  - research-architecture-synthesis => \"__research__/architecture-synthesis\"\n  - research-trail-expand => \"__research__/trail-expand\"\n- Return strict JSON only:\n{\n  \"steps\": [\n    { \"id\": \"research:1\", \"action\": \"research-impact-map\", \"actionId\": \"research-impact-map\", \"actionArgs\": {}, \"targetFile\": \"__research__/impact-map\", \"description\": \"...\" }\n  ]\n}\n        `.trim();\n\n        try {\n            const input: ModuleIO = { query: intentText, content: prompt };\n            const generated = await generate(input, {\n                caller: \"researchPlanGenStep\",\n                inputContext: {\n                    intentText,\n                    intentCategory,\n                    orderedQuestions,\n                    scopeType,\n                    selectedFiles,\n                    candidateFiles,\n                    resumedContextCapsule,\n                    allowedActions: RESEARCH_ACTIONS,\n                },\n            });\n            const raw =\n                typeof generated.data === \"string\"\n                    ? generated.data\n                    : JSON.stringify(generated.data ?? \"{}\");\n            const cleaned = await cleanupModule.run({ query: intentText, content: raw });\n            const jsonString =\n                typeof cleaned.content === \"string\"\n                    ? cleaned.content\n                    : JSON.stringify(cleaned.content ?? \"{}\");\n\n            const parsed = JSON.parse(jsonString) as { steps?: AgentPlanStep[] };\n            const candidateSteps = Array.isArray(parsed.steps) ? parsed.steps : [];\n            const allowedSet = new Set(RESEARCH_ACTIONS.map(a => a.action));\n\n            const normalized: AgentPlanStep[] = candidateSteps\n                .filter(step => typeof step?.action === \"string\" && allowedSet.has(step.action as ResearchAction))\n                .map((step, index) => {\n                    const action = step.action as ResearchAction;\n                    const defaultFile =\n                        action === \"research-impact-map\"\n                            ? \"__research__/impact-map\"\n                            : action === \"research-symbol-trace\"\n                                ? \"__research__/symbol-trace\"\n                                : action === \"research-risk-check\"\n                                    ? \"__research__/risk-check\"\n                                    : action === \"research-trail-expand\"\n                                        ? \"__research__/trail-expand\"\n                                        : \"__research__/architecture-synthesis\";\n\n                    return {\n                        id: step.id ?? `research:${index + 1}`,\n                        action,\n                        // Example: action=\"research-risk-check\" stays identical actionId.\n                        actionId: step.actionId ?? action,\n                        actionArgs: step.actionArgs ?? {},\n                        questionId: typeof step.questionId === \"string\" ? step.questionId : undefined,\n                        targetFile: step.targetFile ?? defaultFile,\n                        description: step.description ?? `Run ${action}`,\n                        metadata: step.metadata ?? {},\n                        groups: [\"analysis\", \"planning\"],\n                    };\n                })\n                .slice(0, 4);\n\n            context.analysis.planSuggestion = { plan: { steps: normalized } };\n            logInputOutput(\"researchPlanGen\", \"output\", {\n                callId: generated.trace?.callId,\n                steps: normalized,\n            });\n        } catch (err) {\n            console.warn(\"[researchPlanGenStep] Failed to generate research plan:\", err);\n            context.analysis.planSuggestion = { plan: { steps: [] } };\n            logInputOutput(\"researchPlanGen\", \"output\", { steps: [] });\n        }\n    },\n};\n"]}

package/dist/agents/resolveAgentTargetClassification.js

@@ -0,0 +1,5 @@
+/**
+ * Re-exports modular target classification helpers from the legacy simple-agent path.
+ */
+export * from "../agent/policy/targetClassification.js";
+//# sourceMappingURL=resolveAgentTargetClassification.js.map

package/dist/agents/resolveAgentTargetClassification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveAgentTargetClassification.js","sourceRoot":"","sources":["../../src/agents/resolveAgentTargetClassification.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,yCAAyC,CAAC","sourcesContent":["/**\n * Re-exports modular target classification helpers from the legacy simple-agent path.\n */\nexport * from \"../agent/policy/targetClassification.js\";\n"]}

package/dist/agents/resolveExecutionModeStep.js

@@ -103,3 +103,4 @@ function hasExplicitWriteIntent(query) {
     const q = query.toLowerCase();
     return /\b(add|update|edit|modify|refactor|rewrite|implement|fix|create|remove|delete|replace|rename|write|patch|change|increment|bump|set)\b/.test(q);
 }
+//# sourceMappingURL=resolveExecutionModeStep.js.map

package/dist/agents/resolveExecutionModeStep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveExecutionModeStep.js","sourceRoot":"","sources":["../../src/agents/resolveExecutionModeStep.ts"],"names":[],"mappings":"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","sourcesContent":["import { StructuredContext } from \"../types\";\n\nexport const resolveExecutionModeStep = {\n    name: \"resolveExecutionMode\",\n\n    description:\n        \"Derive a hard execution mode from the interpreted user intent. \" +\n        \"This decision is authoritative and must not be changed later.\",\n\n    run: async (context: StructuredContext): Promise<void> => {\n        const intent = context.analysis?.intent;\n        if (!intent) {\n            throw new Error(\"resolveExecutionMode: missing analysis.intent\");\n        }\n        const normalizedQuery =\n            intent.normalizedQuery?.trim() ??\n            context.initContext?.userQuery?.trim() ??\n            \"\";\n\n        // ───── Defaults: safe, read-only ─────\n        let mode: \"analyze\" | \"transform\" = \"analyze\";\n        let rationale = \"Defaulted to analysis mode.\";\n        let constraints = {\n            allowAnalysis: true,\n            allowPlanning: true,\n            allowFileWrites: false,\n            docsOnly: false\n        };\n\n        switch (intent.intentCategory) {\n            // ───── Code-changing intents ─────\n            case \"codingTask\":\n            case \"refactorTask\":\n                mode = \"transform\";\n                rationale = \"User intent implies code modification.\";\n                constraints = {\n                    allowAnalysis: true,\n                    allowPlanning: true,\n                    allowFileWrites: true,\n                    docsOnly: false\n                };\n                break;\n\n            // ───── Docs / comments only ─────\n            case \"docsAndComments\":\n            case \"docsandcomments\":\n            case \"docsAndComment\":\n            case \"docs\":\n            case \"comments\":\n            case \"comment\":\n                mode = \"transform\";\n                rationale = \"User intent requests documentation/comments only.\";\n                constraints = {\n                    allowAnalysis: false,\n                    allowPlanning: false,\n                    allowFileWrites: true,\n                    docsOnly: true\n                };\n                break;\n\n            // ───── Generic requests: promote to transform when edit intent is explicit ─────\n            case \"request\":\n                if (hasExplicitWriteIntent(normalizedQuery)) {\n                    mode = \"transform\";\n                    rationale = \"Request contains explicit edit intent.\";\n                    constraints = {\n                        allowAnalysis: true,\n                        allowPlanning: true,\n                        allowFileWrites: true,\n                        docsOnly: false\n                    };\n                }\n                break;\n\n            // ───── Everything else is analysis ─────\n            case \"debugging\":\n            case \"planning\":\n            case \"question\":\n            case \"explanation\":\n            case \"writing\":\n                // keep defaults\n                rationale = \"User intent implies investigation or explanation.\";\n                break;\n        }\n\n        // Safety override: question-form prompts should remain read-only unless\n        // they explicitly ask for edits (e.g. \"How do I update README?\").\n        if (isQuestionLikeQuery(normalizedQuery) && !hasExplicitWriteIntent(normalizedQuery)) {\n            mode = \"analyze\";\n            rationale = \"Question-form intent without explicit edit verb — forced analysis mode.\";\n            constraints = {\n                allowAnalysis: true,\n                allowPlanning: true,\n                allowFileWrites: false,\n                docsOnly: false\n            };\n        }\n\n        context.executionControl = {\n            mode,\n            rationale,\n            confidence: intent.confidence,\n            constraints\n        };\n    }\n};\n\nfunction isQuestionLikeQuery(query: string): boolean {\n    const q = query.trim().toLowerCase();\n    if (!q) return false;\n    if (q.endsWith(\"?\")) return true;\n    return /^(what|why|how|which|where|when|who)\\b/.test(q);\n}\n\nfunction hasExplicitWriteIntent(query: string): boolean {\n    const q = query.toLowerCase();\n    return /\\b(add|update|edit|modify|refactor|rewrite|implement|fix|create|remove|delete|replace|rename|write|patch|change|increment|bump|set)\\b/.test(q);\n}\n"]}

package/dist/agents/resolveExplicitTargetsStep.js

@@ -0,0 +1,74 @@
+import { logInputOutput } from "../utils/promptLogHelper.js";
+import { SearchOrchestrator } from "../search/SearchOrchestrator.js";
+import { deriveFocusFromSearchStep } from "./deriveFocusFromSearchStep.js";
+import path from "path";
+export const resolveExplicitTargetsStep = {
+    name: "resolveExplicitTargets",
+    async run(context) {
+        context.analysis ?? (context.analysis = {});
+        const query = context.initContext?.userQuery ?? "";
+        const orchestrator = new SearchOrchestrator();
+        const search = await orchestrator.run({
+            context,
+            query,
+            mode: "exact-target",
+        });
+        resetStaleFocusForNewExplicitTargets(context, search);
+        deriveFocusFromSearchStep.run(context, search);
+        logInputOutput("resolveExplicitTargetsStep", "output", {
+            mode: search.mode,
+            resolvedTargetFiles: search.resolvedFiles.map(item => item.path),
+            resolvedTargetFolders: search.resolvedFolders,
+            resolvedTargetSymbols: search.resolvedSymbols,
+            unresolvedTargetRefs: search.unresolvedRefs,
+            ambiguousTargetRefs: search.ambiguousRefs,
+            enteredBroadFallback: search.unresolvedRefs.length > 0 && search.resolvedFiles.length === 0,
+        });
+    },
+};
+/**
+ * Clears stale per-turn focus when a new explicit target is stronger than resumed task context.
+ *
+ * Examples:
+ * - previous wrong answer left `guardPolicy.ts` selected, new query says `check guards`
+ * - resumed currentStep points at one old file, new exact-target resolves a different folder
+ */
+function resetStaleFocusForNewExplicitTargets(context, search) {
+    var _a;
+    const hasExplicitResolution = search.resolvedFiles.length > 0 ||
+        search.resolvedFolders.length > 0 ||
+        search.resolvedSymbols.length > 0;
+    if (!hasExplicitResolution)
+        return;
+    context.analysis ?? (context.analysis = {});
+    (_a = context.analysis).focus || (_a.focus = { selectedFiles: [], candidateFiles: [] });
+    const nextScopeFiles = new Set(search.resolvedFiles.map(item => item.path));
+    const nextScopeCandidates = new Set(search.fileCandidates.map(item => item.path));
+    const nextScopeFolders = search.resolvedFolders.map(folder => path.normalize(folder));
+    const existingSelected = context.analysis.focus.selectedFiles ?? [];
+    const existingCandidates = context.analysis.focus.candidateFiles ?? [];
+    const currentStepPath = context.task?.currentStep?.filePath;
+    const fitsNextScope = (filePath) => {
+        const normalized = path.normalize(String(filePath ?? ""));
+        if (!normalized)
+            return false;
+        if (nextScopeFiles.has(normalized) || nextScopeCandidates.has(normalized))
+            return true;
+        return nextScopeFolders.some(folder => normalized === folder || normalized.startsWith(`${folder}${path.sep}`));
+    };
+    const staleSelected = existingSelected.some(filePath => !fitsNextScope(filePath));
+    const staleCandidates = existingCandidates.some(filePath => !fitsNextScope(filePath));
+    const staleCurrentStep = currentStepPath ? !fitsNextScope(currentStepPath) : false;
+    if (!staleSelected && !staleCandidates && !staleCurrentStep) {
+        return;
+    }
+    context.analysis.focus.selectedFiles = [];
+    context.analysis.focus.candidateFiles = [];
+    context.analysis.focus.executionRequired = [];
+    context.analysis.focus.explorationCandidates = [];
+    context.analysis.focus.executionLock = { enabled: false, files: [], reason: "reset-for-new-explicit-target" };
+    if (context.task) {
+        context.task.currentStep = undefined;
+    }
+}
+//# sourceMappingURL=resolveExplicitTargetsStep.js.map

package/dist/agents/resolveExplicitTargetsStep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveExplicitTargetsStep.js","sourceRoot":"","sources":["../../src/agents/resolveExplicitTargetsStep.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Resolves explicit file, folder, and symbol references through the shared search orchestrator.\n *\n * Why this exists:\n * - intent extraction only collects possible refs from the query text\n * - search should own discovery before routing decides how narrow to stay\n * - this step keeps the old compatibility fields, but the source of truth is the search packet\n */\nimport type { StructuredContext } from \"../types.js\";\nimport { logInputOutput } from \"../utils/promptLogHelper.js\";\nimport { SearchOrchestrator } from \"../search/SearchOrchestrator.js\";\nimport { deriveFocusFromSearchStep } from \"./deriveFocusFromSearchStep.js\";\nimport path from \"path\";\n\nexport const resolveExplicitTargetsStep = {\n  name: \"resolveExplicitTargets\",\n\n  async run(context: StructuredContext): Promise<void> {\n    context.analysis ??= {};\n    const query = context.initContext?.userQuery ?? \"\";\n    const orchestrator = new SearchOrchestrator();\n    const search = await orchestrator.run({\n      context,\n      query,\n      mode: \"exact-target\",\n    });\n    resetStaleFocusForNewExplicitTargets(context, search);\n    deriveFocusFromSearchStep.run(context, search);\n\n    logInputOutput(\"resolveExplicitTargetsStep\", \"output\", {\n      mode: search.mode,\n      resolvedTargetFiles: search.resolvedFiles.map(item => item.path),\n      resolvedTargetFolders: search.resolvedFolders,\n      resolvedTargetSymbols: search.resolvedSymbols,\n      unresolvedTargetRefs: search.unresolvedRefs,\n      ambiguousTargetRefs: search.ambiguousRefs,\n      enteredBroadFallback: search.unresolvedRefs.length > 0 && search.resolvedFiles.length === 0,\n    });\n  },\n};\n\n/**\n * Clears stale per-turn focus when a new explicit target is stronger than resumed task context.\n *\n * Examples:\n * - previous wrong answer left `guardPolicy.ts` selected, new query says `check guards`\n * - resumed currentStep points at one old file, new exact-target resolves a different folder\n */\nfunction resetStaleFocusForNewExplicitTargets(context: StructuredContext, search: Awaited<ReturnType<SearchOrchestrator[\"run\"]>>): void {\n  const hasExplicitResolution =\n    search.resolvedFiles.length > 0 ||\n    search.resolvedFolders.length > 0 ||\n    search.resolvedSymbols.length > 0;\n  if (!hasExplicitResolution) return;\n\n  context.analysis ??= {};\n  context.analysis.focus ||= { selectedFiles: [], candidateFiles: [] };\n\n  const nextScopeFiles = new Set(search.resolvedFiles.map(item => item.path));\n  const nextScopeCandidates = new Set(search.fileCandidates.map(item => item.path));\n  const nextScopeFolders = search.resolvedFolders.map(folder => path.normalize(folder));\n\n  const existingSelected = context.analysis.focus.selectedFiles ?? [];\n  const existingCandidates = context.analysis.focus.candidateFiles ?? [];\n  const currentStepPath = context.task?.currentStep?.filePath;\n\n  const fitsNextScope = (filePath: string | undefined): boolean => {\n    const normalized = path.normalize(String(filePath ?? \"\"));\n    if (!normalized) return false;\n    if (nextScopeFiles.has(normalized) || nextScopeCandidates.has(normalized)) return true;\n    return nextScopeFolders.some(folder => normalized === folder || normalized.startsWith(`${folder}${path.sep}`));\n  };\n\n  const staleSelected = existingSelected.some(filePath => !fitsNextScope(filePath));\n  const staleCandidates = existingCandidates.some(filePath => !fitsNextScope(filePath));\n  const staleCurrentStep = currentStepPath ? !fitsNextScope(currentStepPath) : false;\n\n  if (!staleSelected && !staleCandidates && !staleCurrentStep) {\n    return;\n  }\n\n  context.analysis.focus.selectedFiles = [];\n  context.analysis.focus.candidateFiles = [];\n  context.analysis.focus.executionRequired = [];\n  context.analysis.focus.explorationCandidates = [];\n  context.analysis.focus.executionLock = { enabled: false, files: [], reason: \"reset-for-new-explicit-target\" };\n  if (context.task) {\n    context.task.currentStep = undefined;\n  }\n}\n"]}

package/dist/agents/routingDecisionStep.js

@@ -12,6 +12,14 @@ export const routingDecisionStep = {
         const scope = (context.analysis.scopeType ?? "repo-wide");
         const intentCategory = context.analysis.intent?.intentCategory ?? "request";
         const intentConfidence = context.analysis.intent?.confidence ?? 0.5;
+        const resolvedExplicitTargets = context.analysis.focus?.resolvedTargetFiles ??
+            context.analysis.intent?.resolvedTargetFiles ??
+            [];
+        const resolvedExplicitFolders = context.analysis.focus?.resolvedTargetFolders ?? [];
+        const unresolvedExplicitRefs = context.analysis.search?.unresolvedRefs ?? [];
+        const ambiguousExplicitRefs = context.analysis.search?.ambiguousRefs ?? [];
+        const resumeIntent = context.analysis.resumeIntent;
+        const continuityDecision = context.analysis.continuityDecision;
         const query = context.initContext?.userQuery?.trim() ?? "";
         const canWrite = context.executionControl?.constraints?.allowFileWrites ?? false;
         const complexitySignals = [
@@ -29,7 +37,29 @@ export const routingDecisionStep = {
         let decision = "has-info";
         let allowSearch = true;
         let scopeLocked = false;
-        if (scope === "none") {
+        if (resolvedExplicitTargets.length > 0) {
+            allowSearch = false;
+            scopeLocked = true;
+            decision = "has-info";
+        }
+        else if (resolvedExplicitFolders.length > 0) {
+            // Folder targets are explicit scope, but they still need search to expand into concrete files.
+            allowSearch = true;
+            scopeLocked = true;
+            decision = "needs-info";
+        }
+        else if (continuityDecision?.answerNow) {
+            allowSearch = false;
+            scopeLocked = true;
+            decision = "has-info";
+        }
+        else if (resumeIntent?.kind === "continuity-next-step" && !continuityDecision?.answerNow) {
+            const hasResumeFiles = resumeIntent.relevantResumeFiles.length > 0;
+            allowSearch = !hasResumeFiles;
+            scopeLocked = hasResumeFiles;
+            decision = hasResumeFiles ? "has-info" : "needs-info";
+        }
+        else if (scope === "none") {
             allowSearch = false;
             scopeLocked = true;
         }
@@ -45,22 +75,32 @@ export const routingDecisionStep = {
         if (!allowSearch) {
             decision = "has-info";
         }
-        const routeLabel = !allowSearch
-            ? "direct-answer"
-            : isResearchScope
-                ? "repo-research"
-                : scope === "single-file"
-                    ? "single-file-focused"
-                    : "bounded-analysis";
-        const allowResearch = scope !== "none" &&
+        const routeLabel = resolvedExplicitTargets.length > 0 || resolvedExplicitFolders.length > 0
+            ? "explicit-target"
+            : continuityDecision?.answerNow
+                ? "resume-continuity"
+                : !allowSearch
+                    ? "direct-answer"
+                    : isResearchScope
+                        ? "repo-research"
+                        : scope === "single-file"
+                            ? "single-file-focused"
+                            : "bounded-analysis";
+        const allowResearch = resolvedExplicitTargets.length === 0 &&
+            resolvedExplicitFolders.length === 0 &&
+            !continuityDecision?.answerNow &&
+            scope !== "none" &&
             ((isAnalysisLike && isResearchScope && (decision === "needs-info" || complexitySignals >= 2)) ||
                 (isRefactorLike && complexitySignals >= 1));
         const confidence = Math.max(0, Math.min(1, 0.55 + intentConfidence * 0.35 - (ambiguousIntent ? 0.2 : 0)));
+        const allowTransform = continuityDecision?.answerNow || resumeIntent?.fastTrackEligible
+            ? false
+            : canWrite && scope !== "none";
         const routingDecision = {
             decision,
             allowSearch,
             allowResearch,
-            allowTransform: canWrite && scope !== "none",
+            allowTransform,
             scopeLocked,
             confidence: Number(confidence.toFixed(2)),
             rationale: [
@@ -69,10 +109,17 @@ export const routingDecisionStep = {
                 `intent=${intentCategory}`,
                 `complexitySignals=${complexitySignals}`,
                 `hasTargets=${hasExplicitTargets}`,
-            ].join("; "),
+                `resolvedTargets=${resolvedExplicitTargets.length}`,
+                `resolvedFolders=${resolvedExplicitFolders.length}`,
+                `unresolvedTargets=${unresolvedExplicitRefs.length}`,
+                `ambiguousTargets=${ambiguousExplicitRefs.length}`,
+                resumeIntent ? `resumeIntent=${resumeIntent.kind}` : "",
+                continuityDecision ? `continuityDecision=${continuityDecision.kind}` : "",
+            ].filter(Boolean).join("; "),
         };
         context.analysis.routingDecision = routingDecision;
         logInputOutput("routingDecisionStep", "output", routingDecision);
         return routingDecision;
     },
 };
+//# sourceMappingURL=routingDecisionStep.js.map

package/dist/agents/routingDecisionStep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routingDecisionStep.js","sourceRoot":"","sources":["../../src/agents/routingDecisionStep.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Shapes the initial route from already-known analysis signals.\n *\n * Priority order:\n * 1. resolved explicit targets\n * 2. continuity decisions for resumed tasks\n * 3. generic scope/intent heuristics\n *\n * Example:\n * - resolved `index.ts` target -> stay narrow, no broad search\n * - resolved folder `cli/src/agents` -> keep the explicit-target lane, but still allow search to expand inside that folder\n * - continuity summary with enough resumed state -> direct-answer lane\n * - repo-wide explanation -> needs-info, allow evidence and research\n */\nimport type { StructuredContext, RoutingDecision, ScopeType } from \"../types.js\";\nimport { logInputOutput } from \"../utils/promptLogHelper.js\";\n\n/**\n * Computes an initial routing decision from existing analysis signals.\n * This step is intentionally deterministic and non-invasive:\n * it only writes analysis.routingDecision for observability.\n */\nexport const routingDecisionStep = {\n    name: \"routingDecision\",\n    description: \"Derive a lightweight routing decision for logging and downstream planning context.\",\n\n    run: async (context: StructuredContext): Promise<RoutingDecision> => {\n        context.analysis ||= {};\n\n        const scope = (context.analysis.scopeType ?? \"repo-wide\") as ScopeType;\n        const intentCategory = context.analysis.intent?.intentCategory ?? \"request\";\n        const intentConfidence = context.analysis.intent?.confidence ?? 0.5;\n        const resolvedExplicitTargets =\n            context.analysis.focus?.resolvedTargetFiles ??\n            context.analysis.intent?.resolvedTargetFiles ??\n            [];\n        const resolvedExplicitFolders = context.analysis.focus?.resolvedTargetFolders ?? [];\n        const unresolvedExplicitRefs = context.analysis.search?.unresolvedRefs ?? [];\n        const ambiguousExplicitRefs = context.analysis.search?.ambiguousRefs ?? [];\n        const resumeIntent = context.analysis.resumeIntent;\n        const continuityDecision = context.analysis.continuityDecision;\n        const query = context.initContext?.userQuery?.trim() ?? \"\";\n        const canWrite = context.executionControl?.constraints?.allowFileWrites ?? false;\n\n        const complexitySignals = [\n            /\\b(and|also|plus|as well as|in addition)\\b/gi,\n            /\\b(compare|trade[\\s-]?off|pros and cons|strategy|architecture)\\b/gi,\n            /\\?/g,\n        ].reduce((sum, rx) => sum + ((query.match(rx) ?? []).length > 0 ? 1 : 0), 0);\n\n        const isResearchScope = scope === \"repo-wide\";\n        const hasExplicitTargets = (context.analysis.intent?.targetFiles?.length ?? 0) > 0;\n        const ambiguousIntent = intentConfidence < 0.45;\n        const isRefactorLike = intentCategory === \"refactorTask\" || intentCategory === \"codingTask\";\n        const isAnalysisLike =\n            intentCategory === \"question\" ||\n            intentCategory === \"analysis\" ||\n            intentCategory === \"explanation\";\n\n        let decision: RoutingDecision[\"decision\"] = \"has-info\";\n        let allowSearch = true;\n        let scopeLocked = false;\n\n        if (resolvedExplicitTargets.length > 0) {\n            allowSearch = false;\n            scopeLocked = true;\n            decision = \"has-info\";\n        } else if (resolvedExplicitFolders.length > 0) {\n            // Folder targets are explicit scope, but they still need search to expand into concrete files.\n            allowSearch = true;\n            scopeLocked = true;\n            decision = \"needs-info\";\n        } else if (continuityDecision?.answerNow) {\n            allowSearch = false;\n            scopeLocked = true;\n            decision = \"has-info\";\n        } else if (resumeIntent?.kind === \"continuity-next-step\" && !continuityDecision?.answerNow) {\n            const hasResumeFiles = resumeIntent.relevantResumeFiles.length > 0;\n            allowSearch = !hasResumeFiles;\n            scopeLocked = hasResumeFiles;\n            decision = hasResumeFiles ? \"has-info\" : \"needs-info\";\n        } else if (scope === \"none\") {\n            allowSearch = false;\n            scopeLocked = true;\n        } else if (scope === \"single-file\" && hasExplicitTargets) {\n            scopeLocked = true;\n        } else if (scope === \"repo-wide\") {\n            scopeLocked = false;\n        }\n\n        if (isResearchScope || ambiguousIntent || complexitySignals >= 2) {\n            decision = \"needs-info\";\n        }\n\n        if (!allowSearch) {\n            decision = \"has-info\";\n        }\n\n        const routeLabel = resolvedExplicitTargets.length > 0 || resolvedExplicitFolders.length > 0\n            ? \"explicit-target\"\n            : continuityDecision?.answerNow\n                ? \"resume-continuity\"\n                : !allowSearch\n            ? \"direct-answer\"\n            : isResearchScope\n                ? \"repo-research\"\n                : scope === \"single-file\"\n                    ? \"single-file-focused\"\n                    : \"bounded-analysis\";\n\n        const allowResearch =\n            resolvedExplicitTargets.length === 0 &&\n            resolvedExplicitFolders.length === 0 &&\n            !continuityDecision?.answerNow &&\n            scope !== \"none\" &&\n            (\n                (isAnalysisLike && isResearchScope && (decision === \"needs-info\" || complexitySignals >= 2)) ||\n                (isRefactorLike && complexitySignals >= 1)\n            );\n\n        const confidence = Math.max(0, Math.min(1, 0.55 + intentConfidence * 0.35 - (ambiguousIntent ? 0.2 : 0)));\n\n        const allowTransform =\n            continuityDecision?.answerNow || resumeIntent?.fastTrackEligible\n                ? false\n                : canWrite && scope !== \"none\";\n\n        const routingDecision: RoutingDecision = {\n            decision,\n            allowSearch,\n            allowResearch,\n            allowTransform,\n            scopeLocked,\n            confidence: Number(confidence.toFixed(2)),\n            rationale: [\n                `route=${routeLabel}`,\n                `scope=${scope}`,\n                `intent=${intentCategory}`,\n                `complexitySignals=${complexitySignals}`,\n                `hasTargets=${hasExplicitTargets}`,\n                `resolvedTargets=${resolvedExplicitTargets.length}`,\n                `resolvedFolders=${resolvedExplicitFolders.length}`,\n                `unresolvedTargets=${unresolvedExplicitRefs.length}`,\n                `ambiguousTargets=${ambiguousExplicitRefs.length}`,\n                resumeIntent ? `resumeIntent=${resumeIntent.kind}` : \"\",\n                continuityDecision ? `continuityDecision=${continuityDecision.kind}` : \"\",\n            ].filter(Boolean).join(\"; \"),\n        };\n\n        context.analysis.routingDecision = routingDecision;\n\n        logInputOutput(\"routingDecisionStep\", \"output\", routingDecision);\n        return routingDecision;\n    },\n};\n"]}

package/dist/agents/scopeClassificationStep.js

@@ -1,9 +1,32 @@
 import { generate } from "../lib/generate.js";
 import { cleanupModule } from "../pipeline/modules/cleanupModule.js";
 import { logInputOutput } from "../utils/promptLogHelper.js";
+import { buildResumePacket, renderResumePacket } from "../utils/resumeState.js";
+function reduceScopeClassificationCapsule(value) {
+    if (!value.trim())
+        return "";
+    const lines = value
+        .split("\n")
+        .map(line => line.trim())
+        .filter(Boolean);
+    const keepPrefixes = [
+        "Original task:",
+        "Current task status:",
+        "- Normalized intent:",
+        "- Selected files:",
+        "New user query:",
+    ];
+    const reduced = lines.filter(line => keepPrefixes.some(prefix => line.startsWith(prefix)));
+    return (reduced.length > 0 ? reduced : lines.slice(0, 5)).join("\n");
+}
 export const scopeClassificationStep = {
     run: async (context) => {
         const query = context.initContext?.userQuery?.trim() ?? "";
+        const resumedContextCapsule = reduceScopeClassificationCapsule((renderResumePacket(buildResumePacket(context.analysis?.resumeState)) ||
+            context.initContext?.resumedContextCapsule?.trim() ||
+            ""));
+        const explicitTargetFiles = context.analysis?.intent?.targetFiles ?? [];
+        const orderedQuestions = context.analysis?.intent?.questions ?? [];
         context.analysis ?? (context.analysis = {});
         // ------------------------------------------------------------
         // 1️⃣ Prepare deterministic hints for the LLM
@@ -23,9 +46,15 @@ export const scopeClassificationStep = {
             /\b(class|function|method|module)\s+\w+/i.test(lower)) {
             hints.push("The query references a specific file, class, function, or module; possibly single-file scope.");
         }
+        if (orderedQuestions.length > 1) {
+            hints.push(`The query contains ${orderedQuestions.length} ordered question parts; do not collapse it to a narrow single-file scope unless all parts point to one file.`);
+        }
         // ------------------------------------------------------------
         // 2️⃣ LLM classification
         // ------------------------------------------------------------
+        const explicitTargetHints = explicitTargetFiles.length > 0
+            ? `Explicit targets:\n- ${explicitTargetFiles.join("\n- ")}\n`
+            : "";
         const prompt = `
 You classify the scope of a user's request in a software repository.
 
@@ -39,18 +68,35 @@ Definitions:
 - "multi-file": involves several related files/modules.
 - "repo-wide": broad/systemic across the repository.
 
-User query:
-"${query}"
+Current query:
+${query}
+
+${explicitTargetHints}
+
+${orderedQuestions.length > 1 ? `Ordered question parts:\n${orderedQuestions.map((question, index) => `${index + 1}. ${question.text}`).join("\n")}\n` : ""}
+
+${resumedContextCapsule ? `Resumed context capsule:\n${resumedContextCapsule}\n` : ""}
 
 Hints for classification:
 ${hints.length ? "- " + hints.join("\n- ") : "None"}
         `.trim();
         let llmScope = null;
+        let callId;
         let fallbackApplied = false;
         let normalizationApplied = false;
         try {
             const genInput = { query, content: prompt };
-            const genOutput = await generate(genInput);
+            const genOutput = await generate(genInput, {
+                caller: "scopeClassificationStep",
+                inputContext: {
+                    query,
+                    resumedContextCapsule,
+                    explicitTargetFiles,
+                    orderedQuestions,
+                    hints,
+                },
+            });
+            callId = genOutput.trace?.callId;
             const raw = typeof genOutput.data === "string"
                 ? genOutput.data
                 : JSON.stringify(genOutput.data ?? "{}");
@@ -74,8 +120,24 @@ ${hints.length ? "- " + hints.join("\n- ") : "None"}
             llmScope = "repo-wide";
             fallbackApplied = true;
         }
+        const explicitFilenameMatches = query.match(/\b[\w-]+\.(ts|js|tsx|jsx|py|java|go|rs|cpp|c|cs)\b/gi) ?? [];
+        const explicitFileCount = new Set([
+            ...explicitTargetFiles.map(file => file.toLowerCase()),
+            ...explicitFilenameMatches.map(file => file.toLowerCase()),
+        ]).size;
+        if (explicitFileCount >= 2 && llmScope === "single-file") {
+            llmScope = "multi-file";
+            normalizationApplied = true;
+        }
+        if (orderedQuestions.length > 1 && llmScope === "single-file") {
+            llmScope = orderedQuestions.some((question) => /\b(codebase|repo|repository|whole repo|entire repo|system)\b/i.test(question.text))
+                ? "repo-wide"
+                : "multi-file";
+            normalizationApplied = true;
+        }
         context.analysis.scopeType = llmScope;
         logInputOutput("scopeClassificationStep", "output", {
+            callId,
             llmScope,
             fallbackScope: "repo-wide",
             finalScope: llmScope,
@@ -90,3 +152,4 @@ ${hints.length ? "- " + hints.join("\n- ") : "None"}
         return { scopeType: llmScope };
     },
 };
+//# sourceMappingURL=scopeClassificationStep.js.map

package/dist/agents/scopeClassificationStep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scopeClassificationStep.js","sourceRoot":"","sources":["../../src/agents/scopeClassificationStep.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Classifies query scope with a small prompt so early routing is cheap and stable.\n *\n * Why this file exists:\n * - scope is one of the first routing signals, so noise here spreads through the run\n * - continuity follow-ups need only a tiny reminder, not the whole resumed state\n * - explicit target hints should help classification without repeating the user query\n */\nimport type { StructuredContext, ScopeType } from \"../types.js\";\nimport { generate } from \"../lib/generate.js\";\nimport { cleanupModule } from \"../pipeline/modules/cleanupModule.js\";\nimport { logInputOutput } from \"../utils/promptLogHelper.js\";\nimport { buildResumePacket, renderResumePacket } from \"../utils/resumeState.js\";\n\nfunction reduceScopeClassificationCapsule(value: string): string {\n    if (!value.trim()) return \"\";\n    const lines = value\n        .split(\"\\n\")\n        .map(line => line.trim())\n        .filter(Boolean);\n    const keepPrefixes = [\n        \"Original task:\",\n        \"Current task status:\",\n        \"- Normalized intent:\",\n        \"- Selected files:\",\n        \"New user query:\",\n    ];\n    const reduced = lines.filter(line => keepPrefixes.some(prefix => line.startsWith(prefix)));\n    return (reduced.length > 0 ? reduced : lines.slice(0, 5)).join(\"\\n\");\n}\n\nexport const scopeClassificationStep = {\n    run: async (context: StructuredContext) => {\n        const query = context.initContext?.userQuery?.trim() ?? \"\";\n        const resumedContextCapsule = reduceScopeClassificationCapsule(\n            (renderResumePacket(buildResumePacket(context.analysis?.resumeState)) ||\n            context.initContext?.resumedContextCapsule?.trim() ||\n            \"\")\n        );\n        const explicitTargetFiles = context.analysis?.intent?.targetFiles ?? [];\n        const orderedQuestions = context.analysis?.intent?.questions ?? [];\n\n        context.analysis ??= {};\n\n        // ------------------------------------------------------------\n        // 1️⃣ Prepare deterministic hints for the LLM\n        // ------------------------------------------------------------\n        const lower = query.toLowerCase();\n\n        const hints: string[] = [];\n\n        // Systemic/repo-wide hints\n        if (/\\b(codebase|entire repo|whole repo|entire project|whole project|application|system)\\b/i.test(lower)) {\n            hints.push(\"The query mentions the entire codebase or system; likely repo-wide scope.\");\n        }\n\n        // Debugging or error hints\n        if (/\\b(debug|issue|bug|memory leak|performance|error|crash|failure)\\b/i.test(lower)) {\n            hints.push(\"The query mentions debugging, errors, or memory/performance issues; consider broad impact.\");\n        }\n\n        // Explicit artifact references\n        if (/\\b[\\w-]+\\.(ts|js|tsx|jsx|py|java|go|rs|cpp|c|cs)\\b/i.test(lower) ||\n            /\\b(class|function|method|module)\\s+\\w+/i.test(lower)) {\n            hints.push(\"The query references a specific file, class, function, or module; possibly single-file scope.\");\n        }\n\n        if (orderedQuestions.length > 1) {\n            hints.push(`The query contains ${orderedQuestions.length} ordered question parts; do not collapse it to a narrow single-file scope unless all parts point to one file.`);\n        }\n\n        // ------------------------------------------------------------\n        // 2️⃣ LLM classification\n        // ------------------------------------------------------------\n        const explicitTargetHints = explicitTargetFiles.length > 0\n            ? `Explicit targets:\\n- ${explicitTargetFiles.join(\"\\n- \")}\\n`\n            : \"\";\n        const prompt = `\nYou classify the scope of a user's request in a software repository.\n\nReturn STRICT JSON:\n{\n  \"scopeType\": \"single-file\" | \"multi-file\" | \"repo-wide\"\n}\n\nDefinitions:\n- \"single-file\": clearly limited to one specific file or artifact.\n- \"multi-file\": involves several related files/modules.\n- \"repo-wide\": broad/systemic across the repository.\n\nCurrent query:\n${query}\n\n${explicitTargetHints}\n\n${orderedQuestions.length > 1 ? `Ordered question parts:\\n${orderedQuestions.map((question, index) => `${index + 1}. ${question.text}`).join(\"\\n\")}\\n` : \"\"}\n\n${resumedContextCapsule ? `Resumed context capsule:\\n${resumedContextCapsule}\\n` : \"\"}\n\nHints for classification:\n${hints.length ? \"- \" + hints.join(\"\\n- \") : \"None\"}\n        `.trim();\n\n        let llmScope: ScopeType | null = null;\n        let callId: string | undefined;\n        let fallbackApplied = false;\n        let normalizationApplied = false;\n\n        try {\n            const genInput = { query, content: prompt };\n            const genOutput = await generate(genInput, {\n                caller: \"scopeClassificationStep\",\n                inputContext: {\n                    query,\n                    resumedContextCapsule,\n                    explicitTargetFiles,\n                    orderedQuestions,\n                    hints,\n                },\n            });\n            callId = genOutput.trace?.callId;\n\n            const raw =\n                typeof genOutput.data === \"string\"\n                    ? genOutput.data\n                    : JSON.stringify(genOutput.data ?? \"{}\");\n\n            const cleaned = await cleanupModule.run({ query, content: raw });\n\n            const jsonString =\n                typeof cleaned.content === \"string\"\n                    ? cleaned.content\n                    : JSON.stringify(cleaned.content ?? \"{}\");\n\n            const parsed = JSON.parse(jsonString);\n\n            if (\n                parsed &&\n                [\"none\", \"single-file\", \"multi-file\", \"repo-wide\"].includes(parsed.scopeType)\n            ) {\n                llmScope = parsed.scopeType as ScopeType;\n            }\n        } catch (err) {\n            console.warn(\"⚠️ LLM scope classification failed, falling back:\", err);\n        }\n\n        // ------------------------------------------------------------\n        // 3️⃣ Safe fallback if LLM fails\n        // ------------------------------------------------------------\n        if (!llmScope) {\n            llmScope = \"repo-wide\";\n            fallbackApplied = true;\n        }\n\n        const explicitFilenameMatches = query.match(/\\b[\\w-]+\\.(ts|js|tsx|jsx|py|java|go|rs|cpp|c|cs)\\b/gi) ?? [];\n        const explicitFileCount = new Set([\n            ...explicitTargetFiles.map(file => file.toLowerCase()),\n            ...explicitFilenameMatches.map(file => file.toLowerCase()),\n        ]).size;\n\n        if (explicitFileCount >= 2 && llmScope === \"single-file\") {\n            llmScope = \"multi-file\";\n            normalizationApplied = true;\n        }\n\n        if (orderedQuestions.length > 1 && llmScope === \"single-file\") {\n            llmScope = orderedQuestions.some((question) => /\\b(codebase|repo|repository|whole repo|entire repo|system)\\b/i.test(question.text))\n                ? \"repo-wide\"\n                : \"multi-file\";\n            normalizationApplied = true;\n        }\n\n        context.analysis.scopeType = llmScope;\n\n        logInputOutput(\"scopeClassificationStep\", \"output\", {\n            callId,\n            llmScope,\n            fallbackScope: \"repo-wide\",\n            finalScope: llmScope,\n            fallbackApplied,\n            normalizationApplied,\n            reasoning: fallbackApplied\n                ? \"fallback-default\"\n                : normalizationApplied\n                    ? \"normalized-none-to-repo-wide\"\n                    : \"llm\",\n        });\n\n        return { scopeType: llmScope };\n    },\n};\n"]}