scai 0.1.178 → 1.0.0

package/dist/agents/analysisPlanGenStep.js

@@ -1,12 +1,92 @@
-// src/agents/analysisPlanGenStep.ts
+/**
+ * Generates one analysis step from the current focus without re-explaining the whole task.
+ *
+ * Why this file exists:
+ * - planner retries should change only when evidence changes
+ * - generic assumptions and stale resume text make repeated planner prompts look identical
+ * - the chosen target file should stay aligned with the focus rationale and downstream answer grounding
+ */
 import { generate } from "../lib/generate.js";
 import { PLAN_ACTIONS } from "../utils/planActions.js";
 import { logInputOutput } from "../utils/promptLogHelper.js";
 import { cleanupModule } from "../pipeline/modules/cleanupModule.js";
+import { buildResumePacket, renderResumePacket } from "../utils/resumeState.js";
 /**
- * ANALYSIS PLAN GENERATOR (single-step)
- * Generates exactly one analysis reasoning step per iteration.
+ * Builds one safe semantic fallback when the planner returns no usable step.
+ *
+ * Why this exists:
+ * - empty planner output leaves the current task step pending
+ * - repeated empty retries burn the give-up budget without new evidence
+ * - semanticAnalysis is a stable read-only fallback for the current file
  */
+function buildFallbackAnalysisStep(targetFile, currentQuestionId) {
+    return {
+        id: `analysis:fallback:${targetFile}`,
+        action: "semanticAnalysis",
+        actionId: "semanticAnalysis",
+        actionArgs: {},
+        targetFile,
+        questionId: currentQuestionId,
+        description: "Run one deterministic semantic pass on the current target file.",
+        metadata: {
+            fallbackAnalysisPlan: true,
+        },
+        groups: ["analysis"],
+    };
+}
+function reduceUnderstanding(value) {
+    if (!value)
+        return "";
+    const compact = {};
+    const genericLine = /(repository|codebase|module|system|task|current selected files|partial and based)/i;
+    for (const [key, rawItems] of Object.entries(value)) {
+        if (!Array.isArray(rawItems))
+            continue;
+        const filtered = rawItems
+            .map(item => String(item).trim())
+            .filter(Boolean)
+            .filter(item => !genericLine.test(item))
+            .slice(0, 2);
+        if (filtered.length > 0) {
+            compact[key] = filtered;
+        }
+    }
+    return Object.keys(compact).length > 0 ? JSON.stringify(compact, null, 2) : "";
+}
+function buildPlannerFrontierSignature(context) {
+    const trail = context.analysis?.trail;
+    if (!trail)
+        return undefined;
+    const frontier = (trail.frontier ?? [])
+        .map(candidate => `${candidate.filePath}:${candidate.confidence.toFixed(2)}`)
+        .sort();
+    const pendingQueries = [...(trail.pendingQueries ?? [])].sort();
+    if (frontier.length === 0 && pendingQueries.length === 0)
+        return undefined;
+    return JSON.stringify({ frontier, pendingQueries });
+}
+function buildPlannerPromptSignature(args) {
+    return JSON.stringify(args);
+}
+function buildPlannerPromptState(args) {
+    const signature = buildPlannerPromptSignature({
+        targetFile: args.targetFile,
+        rationaleText: args.rationaleText,
+        currentQuestionId: args.currentQuestionId,
+        promptMode: args.promptMode,
+    });
+    const repeated = args.prior?.signature === signature &&
+        args.prior?.frontierSignature === args.frontierSignature;
+    return {
+        targetFile: args.targetFile,
+        rationaleText: args.rationaleText,
+        currentQuestionId: args.currentQuestionId,
+        promptMode: args.promptMode,
+        signature,
+        frontierSignature: args.frontierSignature,
+        repeatCount: repeated ? (args.prior?.repeatCount ?? 1) + 1 : 1,
+    };
+}
 export const analysisPlanGenStep = {
     name: "analysisPlanGen",
     description: "Generates a single analysis reasoning step.",
@@ -15,6 +95,7 @@ export const analysisPlanGenStep = {
     async run(context) {
         context.analysis || (context.analysis = {});
         context.execution || (context.execution = {});
+        const priorPlannerState = context.analysis.plannerPromptState;
         // Ensure task exists (required for currentStep)
         if (!context.task) {
             throw new Error("analysisPlanGenStep: context.task must exist — ensure runBoot has been called");
@@ -41,9 +122,40 @@ export const analysisPlanGenStep = {
         const intentCategory = context.analysis.intent?.intentCategory ?? "";
         const relevantFiles = JSON.stringify([targetFile], null, 2);
         const rationaleText = context.analysis.focus?.rationale ?? "";
-        const understandingText = context.analysis.understanding
-            ? JSON.stringify(context.analysis.understanding, null, 2)
-            : "";
+        const understandingText = reduceUnderstanding(context.analysis.understanding);
+        const orderedQuestions = context.analysis.intent?.questions ?? [];
+        const currentQuestionId = currentStep.questionId ?? (orderedQuestions.length === 1 ? orderedQuestions[0].id : undefined);
+        const resumedContextCapsule = renderResumePacket(buildResumePacket(context.analysis?.resumeState)) ||
+            context.initContext?.resumedContextCapsule ||
+            "";
+        const compactRetry = shouldUseCompactRetryPrompt({
+            prior: priorPlannerState,
+            targetFile,
+            rationaleText,
+            currentQuestionId,
+        });
+        const promptMode = compactRetry ? "delta" : "full";
+        const frontierSignature = buildPlannerFrontierSignature(context);
+        const nextPlannerState = buildPlannerPromptState({
+            prior: priorPlannerState,
+            targetFile,
+            rationaleText,
+            currentQuestionId,
+            promptMode,
+            frontierSignature,
+        });
+        const promptRationaleText = compactRetry
+            ? buildCompactRetryRationale(targetFile, rationaleText)
+            : rationaleText;
+        const promptAllowedActions = compactRetry
+            ? renderCompactActionIds(effectiveActions)
+            : JSON.stringify(effectiveActions, null, 2);
+        const promptOrderedQuestions = compactRetry
+            ? renderCompactQuestionState(orderedQuestions, currentQuestionId)
+            : orderedQuestions.length > 0
+                ? JSON.stringify(orderedQuestions, null, 2)
+                : "";
+        const promptResumedContext = compactRetry ? "" : resumedContextCapsule;
         const prompt = `
 You are an autonomous coding agent.
 Produce **exactly one structured analysis step** that will advance understanding
@@ -55,17 +167,23 @@ ${intentText}
 Task category:
 ${intentCategory}
 
-Allowed actions (analysis only):
-${actionsJson}
+${compactRetry ? "Allowed action ids (analysis only, unchanged from prior planner step):" : "Allowed actions (analysis only):"}
+${promptAllowedActions}
 
 Relevant files:
 ${relevantFiles}
 
-Rationale / notes from pre-file check:
-${rationaleText}
+Primary target file:
+${targetFile}
+
+Focus rationale:
+${promptRationaleText}
+
+${understandingText ? `Grounded understanding:\n${understandingText}\n` : ""}
 
-Existing understanding of the codebase:
-${understandingText}
+${promptOrderedQuestions ? `Ordered question parts:\n${promptOrderedQuestions}\n` : ""}
+
+${promptResumedContext ? `Resumed context capsule:\n${promptResumedContext}\n` : ""}
 
 If this is NOT a coding, refactoring, or inline commenting task,
 return: { "step": null }
@@ -75,6 +193,8 @@ Return a valid JSON object in this format:
 {
   "step": {
     "action": "analysisAction",
+    "actionId": "analysisAction",
+    "actionArgs": {},
     "targetFile": "optional/path.ts",
     "description": "what this analysis step achieves",
     "metadata": {}
@@ -83,7 +203,23 @@ Return a valid JSON object in this format:
         `.trim();
         try {
             const genInput = { query: intentText, content: prompt };
-            const genOutput = await generate(genInput);
+            const genOutput = await generate(genInput, {
+                caller: "analysisPlanGenStep",
+                inputContext: {
+                    intentText,
+                    intentCategory,
+                    targetFile,
+                    rationaleText: promptRationaleText,
+                    understandingText,
+                    orderedQuestions,
+                    currentQuestionId,
+                    resumedContextCapsule: promptResumedContext,
+                    plannerRetryMode: promptMode,
+                    ...(compactRetry
+                        ? { allowedActionIds: effectiveActions.map(action => action.actionId ?? action.action) }
+                        : { allowedActions: effectiveActions }),
+                },
+            });
             const raw = typeof genOutput.data === "string"
                 ? genOutput.data
                 : JSON.stringify(genOutput.data ?? "{}");
@@ -97,12 +233,23 @@ Return a valid JSON object in this format:
                 const actionDef = PLAN_ACTIONS.find(a => a.action === step.action);
                 return {
                     ...step,
+                    // Example: planner returns action="semanticAnalysis".
+                    actionId: step.actionId ?? step.action,
+                    actionArgs: step.actionArgs ?? {},
+                    questionId: step.questionId ?? currentQuestionId,
                     groups: actionDef?.groups ?? ["analysis"],
                     metadata: step.metadata ?? {},
                 };
             });
-            context.analysis.planSuggestion = { plan: { steps: finalSteps } };
-            logInputOutput("analysisPlanGen", "output", finalSteps);
+            const normalizedSteps = finalSteps.length > 0
+                ? finalSteps
+                : [buildFallbackAnalysisStep(targetFile, currentQuestionId)];
+            context.analysis.planSuggestion = { plan: { steps: normalizedSteps } };
+            context.analysis.plannerPromptState = nextPlannerState;
+            logInputOutput("analysisPlanGen", "output", {
+                callId: genOutput.trace?.callId,
+                steps: normalizedSteps,
+            });
             if (process.env.SCAI_VERBOSE_AGENT_LOGS === "1") {
                 console.log("🧠 [analysisPlanGenStep] EXIT (success)");
             }
@@ -111,8 +258,38 @@ Return a valid JSON object in this format:
             if (process.env.SCAI_VERBOSE_AGENT_LOGS === "1") {
                 console.warn("⚠️ [analysisPlanGenStep] FAILED to generate analysis plan:", err);
             }
-            context.analysis.planSuggestion = { plan: { steps: [] } };
-            logInputOutput("analysisPlanGen", "output", { steps: [] });
+            const fallbackSteps = [buildFallbackAnalysisStep(targetFile, currentQuestionId)];
+            context.analysis.planSuggestion = { plan: { steps: fallbackSteps } };
+            context.analysis.plannerPromptState = nextPlannerState;
+            logInputOutput("analysisPlanGen", "output", { steps: fallbackSteps });
         }
     }
 };
+function shouldUseCompactRetryPrompt(args) {
+    return Boolean(args.prior &&
+        args.prior.targetFile === args.targetFile &&
+        args.prior.rationaleText === args.rationaleText &&
+        args.prior.currentQuestionId === args.currentQuestionId);
+}
+function buildCompactRetryRationale(targetFile, rationaleText) {
+    const lines = rationaleText
+        .split("\n")
+        .map(line => line.trim())
+        .filter(Boolean)
+        .filter(line => /^Pre-check:/i.test(line) || /^\[Post-check\]/i.test(line));
+    const summary = lines.slice(0, 2).join("\n").trim();
+    return summary || `Focus unchanged for ${targetFile}; reuse the same target and only add materially new analysis evidence.`;
+}
+function renderCompactActionIds(actions) {
+    return actions.map(action => action.actionId ?? action.action).join(", ");
+}
+function renderCompactQuestionState(orderedQuestions, currentQuestionId) {
+    if (orderedQuestions.length === 0)
+        return "";
+    const current = orderedQuestions.find(question => question.id === currentQuestionId);
+    if (current?.text) {
+        return `Current question: ${current.text}`;
+    }
+    return `Question count unchanged: ${orderedQuestions.length}`;
+}
+//# sourceMappingURL=analysisPlanGenStep.js.map

package/dist/agents/analysisPlanGenStep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysisPlanGenStep.js","sourceRoot":"","sources":["../../src/agents/analysisPlanGenStep.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Generates one analysis step from the current focus without re-explaining the whole task.\n *\n * Why this file exists:\n * - planner retries should change only when evidence changes\n * - generic assumptions and stale resume text make repeated planner prompts look identical\n * - the chosen target file should stay aligned with the focus rationale and downstream answer grounding\n */\nimport { generate } from \"../lib/generate.js\";\nimport { PLAN_ACTIONS } from \"../utils/planActions.js\";\nimport { logInputOutput } from \"../utils/promptLogHelper.js\";\nimport { cleanupModule } from \"../pipeline/modules/cleanupModule.js\";\nimport type { ModuleIO, StructuredContext, AgentPlanStep, PlannerPromptState } from \"../types.js\";\nimport { buildResumePacket, renderResumePacket } from \"../utils/resumeState.js\";\n\n/**\n * Builds one safe semantic fallback when the planner returns no usable step.\n *\n * Why this exists:\n * - empty planner output leaves the current task step pending\n * - repeated empty retries burn the give-up budget without new evidence\n * - semanticAnalysis is a stable read-only fallback for the current file\n */\nfunction buildFallbackAnalysisStep(targetFile: string, currentQuestionId?: string): AgentPlanStep {\n    return {\n        id: `analysis:fallback:${targetFile}`,\n        action: \"semanticAnalysis\",\n        actionId: \"semanticAnalysis\",\n        actionArgs: {},\n        targetFile,\n        questionId: currentQuestionId,\n        description: \"Run one deterministic semantic pass on the current target file.\",\n        metadata: {\n            fallbackAnalysisPlan: true,\n        },\n        groups: [\"analysis\"],\n    };\n}\n\nfunction reduceUnderstanding(value: {\n    problemStatement?: string;\n    constraints?: string[];\n    assumptions?: string[];\n    risks?: string[];\n    sharedPatterns?: string[];\n    hotspots?: string[];\n    couplingPoints?: string[];\n} | undefined): string {\n    if (!value) return \"\";\n    const compact: Record<string, unknown> = {};\n    const genericLine = /(repository|codebase|module|system|task|current selected files|partial and based)/i;\n\n    for (const [key, rawItems] of Object.entries(value)) {\n        if (!Array.isArray(rawItems)) continue;\n        const filtered = rawItems\n            .map(item => String(item).trim())\n            .filter(Boolean)\n            .filter(item => !genericLine.test(item))\n            .slice(0, 2);\n        if (filtered.length > 0) {\n            compact[key] = filtered;\n        }\n    }\n\n    return Object.keys(compact).length > 0 ? JSON.stringify(compact, null, 2) : \"\";\n}\n\nfunction buildPlannerFrontierSignature(context: StructuredContext): string | undefined {\n    const trail = context.analysis?.trail;\n    if (!trail) return undefined;\n\n    const frontier = (trail.frontier ?? [])\n        .map(candidate => `${candidate.filePath}:${candidate.confidence.toFixed(2)}`)\n        .sort();\n    const pendingQueries = [...(trail.pendingQueries ?? [])].sort();\n    if (frontier.length === 0 && pendingQueries.length === 0) return undefined;\n\n    return JSON.stringify({ frontier, pendingQueries });\n}\n\nfunction buildPlannerPromptSignature(args: {\n    targetFile: string;\n    rationaleText: string;\n    currentQuestionId?: string;\n    promptMode: \"full\" | \"delta\";\n}): string {\n    return JSON.stringify(args);\n}\n\nfunction buildPlannerPromptState(args: {\n    prior: PlannerPromptState | undefined;\n    targetFile: string;\n    rationaleText: string;\n    currentQuestionId?: string;\n    promptMode: \"full\" | \"delta\";\n    frontierSignature?: string;\n}): PlannerPromptState {\n    const signature = buildPlannerPromptSignature({\n        targetFile: args.targetFile,\n        rationaleText: args.rationaleText,\n        currentQuestionId: args.currentQuestionId,\n        promptMode: args.promptMode,\n    });\n    const repeated =\n        args.prior?.signature === signature &&\n        args.prior?.frontierSignature === args.frontierSignature;\n\n    return {\n        targetFile: args.targetFile,\n        rationaleText: args.rationaleText,\n        currentQuestionId: args.currentQuestionId,\n        promptMode: args.promptMode,\n        signature,\n        frontierSignature: args.frontierSignature,\n        repeatCount: repeated ? (args.prior?.repeatCount ?? 1) + 1 : 1,\n    };\n}\n\nexport const analysisPlanGenStep = {\n    name: \"analysisPlanGen\",\n    description: \"Generates a single analysis reasoning step.\",\n\n    requires: [\"analysis.intent\", \"analysis.focus\", \"analysis.routingDecision\"],\n    produces: [\"analysis.planSuggestion\"],\n\n    async run(context: StructuredContext): Promise<void> {\n        context.analysis ||= {};\n        context.execution ||= {};\n        const priorPlannerState = context.analysis.plannerPromptState;\n\n        // Ensure task exists (required for currentStep)\n        if (!context.task) {\n            throw new Error(\n                \"analysisPlanGenStep: context.task must exist — ensure runBoot has been called\"\n            );\n        }\n\n        // 🔁 Always overwrite previous planSuggestion\n        delete context.analysis.planSuggestion;\n\n        // Use the DB-backed currentStep\n        const currentStep = context.task.currentStep;\n        if (!currentStep?.filePath) {\n            context.analysis.planSuggestion = { plan: { steps: [] } };\n            logInputOutput(\"analysisPlanGen\", \"output\", { steps: [] });\n            return;\n        }\n        const targetFile = currentStep.filePath;\n\n        // Restrict actions to ANALYSIS only\n        const effectiveActions = PLAN_ACTIONS.filter(a => a.groups?.includes(\"analysis\"));\n        if (!effectiveActions.length) {\n            context.analysis.planSuggestion = { plan: { steps: [] } };\n            logInputOutput(\"analysisPlanGen\", \"output\", { steps: [] });\n            return;\n        }\n\n        const actionsJson = JSON.stringify(effectiveActions, null, 2);\n        const intentText = context.analysis.intent?.normalizedQuery ?? context.initContext?.userQuery ?? \"\";\n        const intentCategory = context.analysis.intent?.intentCategory ?? \"\";\n        const relevantFiles = JSON.stringify([targetFile], null, 2);\n        const rationaleText = context.analysis.focus?.rationale ?? \"\";\n        const understandingText = reduceUnderstanding(context.analysis.understanding);\n        const orderedQuestions = context.analysis.intent?.questions ?? [];\n        const currentQuestionId = currentStep.questionId ?? (orderedQuestions.length === 1 ? orderedQuestions[0].id : undefined);\n        const resumedContextCapsule =\n            renderResumePacket(buildResumePacket(context.analysis?.resumeState)) ||\n            context.initContext?.resumedContextCapsule ||\n            \"\";\n        const compactRetry = shouldUseCompactRetryPrompt({\n            prior: priorPlannerState,\n            targetFile,\n            rationaleText,\n            currentQuestionId,\n        });\n        const promptMode = compactRetry ? \"delta\" : \"full\";\n        const frontierSignature = buildPlannerFrontierSignature(context);\n        const nextPlannerState = buildPlannerPromptState({\n            prior: priorPlannerState,\n            targetFile,\n            rationaleText,\n            currentQuestionId,\n            promptMode,\n            frontierSignature,\n        });\n        const promptRationaleText = compactRetry\n            ? buildCompactRetryRationale(targetFile, rationaleText)\n            : rationaleText;\n        const promptAllowedActions = compactRetry\n            ? renderCompactActionIds(effectiveActions)\n            : JSON.stringify(effectiveActions, null, 2);\n        const promptOrderedQuestions = compactRetry\n            ? renderCompactQuestionState(orderedQuestions, currentQuestionId)\n            : orderedQuestions.length > 0\n                ? JSON.stringify(orderedQuestions, null, 2)\n                : \"\";\n        const promptResumedContext = compactRetry ? \"\" : resumedContextCapsule;\n\n        const prompt = `\nYou are an autonomous coding agent.\nProduce **exactly one structured analysis step** that will advance understanding\nof the codebase, suitable for safe planning of transformations.\n\nIntent / task description:\n${intentText}\n\nTask category:\n${intentCategory}\n\n${compactRetry ? \"Allowed action ids (analysis only, unchanged from prior planner step):\" : \"Allowed actions (analysis only):\"}\n${promptAllowedActions}\n\nRelevant files:\n${relevantFiles}\n\nPrimary target file:\n${targetFile}\n\nFocus rationale:\n${promptRationaleText}\n\n${understandingText ? `Grounded understanding:\\n${understandingText}\\n` : \"\"}\n\n${promptOrderedQuestions ? `Ordered question parts:\\n${promptOrderedQuestions}\\n` : \"\"}\n\n${promptResumedContext ? `Resumed context capsule:\\n${promptResumedContext}\\n` : \"\"}\n\nIf this is NOT a coding, refactoring, or inline commenting task,\nreturn: { \"step\": null }\n\nReturn a valid JSON object in this format:\n\n{\n  \"step\": {\n    \"action\": \"analysisAction\",\n    \"actionId\": \"analysisAction\",\n    \"actionArgs\": {},\n    \"targetFile\": \"optional/path.ts\",\n    \"description\": \"what this analysis step achieves\",\n    \"metadata\": {}\n  }\n}\n        `.trim();\n\n        try {\n            const genInput: ModuleIO = { query: intentText, content: prompt };\n            const genOutput = await generate(genInput, {\n                caller: \"analysisPlanGenStep\",\n                inputContext: {\n                    intentText,\n                    intentCategory,\n                    targetFile,\n                    rationaleText: promptRationaleText,\n                    understandingText,\n                    orderedQuestions,\n                    currentQuestionId,\n                    resumedContextCapsule: promptResumedContext,\n                    plannerRetryMode: promptMode,\n                    ...(compactRetry\n                        ? { allowedActionIds: effectiveActions.map(action => action.actionId ?? action.action) }\n                        : { allowedActions: effectiveActions }),\n                },\n            });\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: intentText, content: raw });\n            const jsonString =\n                typeof cleaned.content === \"string\"\n                    ? cleaned.content\n                    : JSON.stringify(cleaned.content ?? \"{}\");\n\n            const planObj: { step?: AgentPlanStep | null } = JSON.parse(jsonString);\n            const steps: AgentPlanStep[] = planObj.step ? [planObj.step] : [];\n\n            const finalSteps = steps.map((step: AgentPlanStep) => {\n                const actionDef = PLAN_ACTIONS.find(a => a.action === step.action);\n                return {\n                    ...step,\n                    // Example: planner returns action=\"semanticAnalysis\".\n                    actionId: step.actionId ?? step.action,\n                    actionArgs: step.actionArgs ?? {},\n                    questionId: step.questionId ?? currentQuestionId,\n                    groups: actionDef?.groups ?? [\"analysis\"],\n                    metadata: step.metadata ?? {},\n                };\n            });\n\n            const normalizedSteps = finalSteps.length > 0\n                ? finalSteps\n                : [buildFallbackAnalysisStep(targetFile, currentQuestionId)];\n\n            context.analysis.planSuggestion = { plan: { steps: normalizedSteps } };\n            context.analysis.plannerPromptState = nextPlannerState;\n            logInputOutput(\"analysisPlanGen\", \"output\", {\n                callId: genOutput.trace?.callId,\n                steps: normalizedSteps,\n            });\n            if (process.env.SCAI_VERBOSE_AGENT_LOGS === \"1\") {\n                console.log(\"🧠 [analysisPlanGenStep] EXIT (success)\");\n            }\n\n        } catch (err) {\n            if (process.env.SCAI_VERBOSE_AGENT_LOGS === \"1\") {\n                console.warn(\"⚠️ [analysisPlanGenStep] FAILED to generate analysis plan:\", err);\n            }\n            const fallbackSteps = [buildFallbackAnalysisStep(targetFile, currentQuestionId)];\n            context.analysis.planSuggestion = { plan: { steps: fallbackSteps } };\n            context.analysis.plannerPromptState = nextPlannerState;\n            logInputOutput(\"analysisPlanGen\", \"output\", { steps: fallbackSteps });\n        }\n    }\n};\n\nfunction shouldUseCompactRetryPrompt(args: {\n    prior: PlannerPromptState | undefined;\n    targetFile: string;\n    rationaleText: string;\n    currentQuestionId?: string;\n}): boolean {\n    return Boolean(\n        args.prior &&\n        args.prior.targetFile === args.targetFile &&\n        args.prior.rationaleText === args.rationaleText &&\n        args.prior.currentQuestionId === args.currentQuestionId\n    );\n}\n\nfunction buildCompactRetryRationale(targetFile: string, rationaleText: string): string {\n    const lines = rationaleText\n        .split(\"\\n\")\n        .map(line => line.trim())\n        .filter(Boolean)\n        .filter(line => /^Pre-check:/i.test(line) || /^\\[Post-check\\]/i.test(line));\n    const summary = lines.slice(0, 2).join(\"\\n\").trim();\n    return summary || `Focus unchanged for ${targetFile}; reuse the same target and only add materially new analysis evidence.`;\n}\n\nfunction renderCompactActionIds(actions: Array<{ actionId?: string; action: string }>): string {\n    return actions.map(action => action.actionId ?? action.action).join(\", \");\n}\n\nfunction renderCompactQuestionState(\n    orderedQuestions: Array<{ id?: string; text?: string; order?: number }> ,\n    currentQuestionId?: string\n): string {\n    if (orderedQuestions.length === 0) return \"\";\n    const current = orderedQuestions.find(question => question.id === currentQuestionId);\n    if (current?.text) {\n        return `Current question: ${current.text}`;\n    }\n    return `Question count unchanged: ${orderedQuestions.length}`;\n}\n"]}

package/dist/agents/answerOnlyCompletion.js

@@ -0,0 +1,32 @@
+function keepStartedOrCompletedSteps(steps) {
+    return (steps ?? []).filter((step) => {
+        return step.status === "completed" || step.startTime != null || step.endTime != null;
+    });
+}
+/**
+ * Converts direct-answer and analysis-only answer paths into completed tasks.
+ * Example: finalAnswer exists, transform route disabled, and only pending seeded steps exist.
+ */
+export function normalizeAnswerOnlyCompletion(context, answerPath) {
+    const finalAnswer = context.analysis?.finalAnswer?.trim();
+    if (!finalAnswer)
+        return false;
+    const startedOrCompletedSteps = keepStartedOrCompletedSteps(context.task.steps);
+    const hasStartedOrCompletedSteps = startedOrCompletedSteps.length > 0;
+    const allowTransform = Boolean(context.analysis?.routingDecision?.allowTransform ??
+        context.analysis?.executionPolicy?.routeAllowed?.transform);
+    const isDirectContinuityAnswer = answerPath === "continuity";
+    const isAnalysisOnlyFinalAnswer = answerPath === "final" &&
+        !allowTransform &&
+        !hasStartedOrCompletedSteps;
+    if (!isDirectContinuityAnswer && !isAnalysisOnlyFinalAnswer) {
+        return false;
+    }
+    context.task.status = "completed";
+    delete context.task.reason;
+    context.task.currentStep = undefined;
+    context.task.steps = startedOrCompletedSteps;
+    context.currentStep = undefined;
+    return true;
+}
+//# sourceMappingURL=answerOnlyCompletion.js.map

package/dist/agents/answerOnlyCompletion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"answerOnlyCompletion.js","sourceRoot":"","sources":["../../src/agents/answerOnlyCompletion.ts"],"names":[],"mappings":"AAiBA,SAAS,2BAA2B,CAAC,KAAyB;IAC5D,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QACnC,OAAO,IAAI,CAAC,MAAM,KAAK,WAAW,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC;IACvF,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,6BAA6B,CAC3C,OAA0B,EAC1B,UAA0B;IAE1B,MAAM,WAAW,GAAG,OAAO,CAAC,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAC1D,IAAI,CAAC,WAAW;QAAE,OAAO,KAAK,CAAC;IAE/B,MAAM,uBAAuB,GAAG,2BAA2B,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChF,MAAM,0BAA0B,GAAG,uBAAuB,CAAC,MAAM,GAAG,CAAC,CAAC;IACtE,MAAM,cAAc,GAAG,OAAO,CAC5B,OAAO,CAAC,QAAQ,EAAE,eAAe,EAAE,cAAc;QACjD,OAAO,CAAC,QAAQ,EAAE,eAAe,EAAE,YAAY,EAAE,SAAS,CAC3D,CAAC;IACF,MAAM,wBAAwB,GAAG,UAAU,KAAK,YAAY,CAAC;IAC7D,MAAM,yBAAyB,GAC7B,UAAU,KAAK,OAAO;QACtB,CAAC,cAAc;QACf,CAAC,0BAA0B,CAAC;IAE9B,IAAI,CAAC,wBAAwB,IAAI,CAAC,yBAAyB,EAAE,CAAC;QAC5D,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,WAAW,CAAC;IAClC,OAAO,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;IAC3B,OAAO,CAAC,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,KAAK,GAAG,uBAAuB,CAAC;IAC7C,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IAChC,OAAO,IAAI,CAAC;AACd,CAAC","sourcesContent":["/**\n * Normalizes answer-only runs into a clean completed terminal state.\n *\n * Why this exists:\n * - some runs can produce a valid final answer without entering real execution work\n * - those runs should not stay `deferred` or carry stale pending plan seeds\n * - the rule must live in one place before the future Session/Task/Step rebuild\n *\n * Examples:\n * - continuity direct answer -> completed with zero steps\n * - explicit-target explanation with no execution work -> completed with zero steps\n * - transform route with real execution expectation -> do not normalize here\n */\nimport type { StructuredContext, Step } from \"../types.js\";\n\ntype AnswerPathKind = \"continuity\" | \"final\";\n\nfunction keepStartedOrCompletedSteps(steps: Step[] | undefined): Step[] {\n  return (steps ?? []).filter((step) => {\n    return step.status === \"completed\" || step.startTime != null || step.endTime != null;\n  });\n}\n\n/**\n * Converts direct-answer and analysis-only answer paths into completed tasks.\n * Example: finalAnswer exists, transform route disabled, and only pending seeded steps exist.\n */\nexport function normalizeAnswerOnlyCompletion(\n  context: StructuredContext,\n  answerPath: AnswerPathKind\n): boolean {\n  const finalAnswer = context.analysis?.finalAnswer?.trim();\n  if (!finalAnswer) return false;\n\n  const startedOrCompletedSteps = keepStartedOrCompletedSteps(context.task.steps);\n  const hasStartedOrCompletedSteps = startedOrCompletedSteps.length > 0;\n  const allowTransform = Boolean(\n    context.analysis?.routingDecision?.allowTransform ??\n    context.analysis?.executionPolicy?.routeAllowed?.transform\n  );\n  const isDirectContinuityAnswer = answerPath === \"continuity\";\n  const isAnalysisOnlyFinalAnswer =\n    answerPath === \"final\" &&\n    !allowTransform &&\n    !hasStartedOrCompletedSteps;\n\n  if (!isDirectContinuityAnswer && !isAnalysisOnlyFinalAnswer) {\n    return false;\n  }\n\n  context.task.status = \"completed\";\n  delete context.task.reason;\n  context.task.currentStep = undefined;\n  context.task.steps = startedOrCompletedSteps;\n  context.currentStep = undefined;\n  return true;\n}\n"]}

package/dist/agents/collaboratorStep.js

@@ -43,3 +43,4 @@ export const collaboratorStep = {
         });
     }
 };
+//# sourceMappingURL=collaboratorStep.js.map

package/dist/agents/collaboratorStep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collaboratorStep.js","sourceRoot":"","sources":["../../src/agents/collaboratorStep.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC5B,IAAI,EAAE,kBAAkB;IACxB,WAAW,EAAE,2DAA2D;IAExE,QAAQ,EAAE,CAAC,6BAA6B,CAAC;IACzC,QAAQ,EAAE,CAAC,+BAA+B,EAAE,6BAA6B,CAAC;IAE1E,KAAK,CAAC,GAAG,CAAC,OAA0B;QAChC,OAAO,CAAC,QAAQ,KAAhB,OAAO,CAAC,QAAQ,GAAK,EAAE,EAAC;QAExB,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC;QACtD,IAAI,CAAC,SAAS;YAAE,OAAO;QAEvB,wDAAwD;QACxD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC;QACvD,IAAI,QAAQ,EAAE,MAAM,KAAK,SAAS;YAAE,OAAO;QAE3C,qDAAqD;QACrD,IAAI,SAAS,CAAC,UAAU,KAAK,kBAAkB;YAAE,OAAO;QAExD,sDAAsD;QACtD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACZ,MAAM,QAAQ,GAAyB;gBACnC,cAAc,EACV,iGAAiG;gBACrG,MAAM,EAAE,SAAS;gBACjB,cAAc,EAAE,IAAI;aACvB,CAAC;YAEF,OAAO,CAAC,QAAQ,CAAC,oBAAoB,GAAG,QAAQ,CAAC;QACrD,CAAC;QAED,mEAAmE;QACnE,OAAO,CAAC,QAAQ,CAAC,kBAAkB,GAAG;YAClC,GAAG,SAAS;YACZ,OAAO,EAAE,gCAAgC;YACzC,SAAS,EACL,wEAAwE;YAC5E,UAAU,EAAE,GAAG;SAClB,CAAC;QAEF,cAAc,CACV,kBAAkB,EAClB,QAAQ,EACR;YACI,oBAAoB,EAAE,OAAO,CAAC,QAAQ,EAAE,oBAAoB;YAC5D,kBAAkB,EAAE,OAAO,CAAC,QAAQ,EAAE,kBAAkB;SAC3D,CACJ,CAAC;IAEN,CAAC;CACJ,CAAC","sourcesContent":["// File: src/agents/collaboratorStep.ts\nimport type {\n    StructuredContext,\n    CollaboratorFeedback,\n    IterationReasoning\n} from '../types.js';\nimport { logInputOutput } from '../utils/promptLogHelper.js';\n\n/**\n * COLLABORATOR STEP\n * Prepares or collects collaborator / human feedback when required.\n * Does NOT advance execution unless feedback is resolved.\n */\nexport const collaboratorStep = {\n    name: 'collaboratorStep',\n    description: 'Requests or integrates collaborator feedback when needed.',\n\n    requires: ['analysis.iterationReasoning'],\n    produces: ['analysis.collaboratorFeedback', 'analysis.iterationReasoning'],\n\n    async run(context: StructuredContext): Promise<void> {\n        context.analysis ||= {};\n\n        const reasoning = context.analysis.iterationReasoning;\n        if (!reasoning) return;\n\n        // If feedback already exists and is applied, do nothing\n        const existing = context.analysis.collaboratorFeedback;\n        if (existing?.status === 'applied') return;\n\n        // Only act if iteration explicitly requests feedback\n        if (reasoning.nextAction !== 'request-feedback') return;\n\n        // Initialize collaborator feedback request if missing\n        if (!existing) {\n            const feedback: CollaboratorFeedback = {\n                summaryForUser:\n                    'Additional review is requested before continuing. Please confirm or correct the recent changes.',\n                status: 'pending',\n                requiresAction: true\n            };\n\n            context.analysis.collaboratorFeedback = feedback;\n        }\n\n        // Update iteration reasoning to reflect wait state (no new fields)\n        context.analysis.iterationReasoning = {\n            ...reasoning,\n            summary: 'Awaiting collaborator feedback',\n            rationale:\n                'Iteration paused until external confirmation or correction is received',\n            confidence: 0.5\n        };\n\n        logInputOutput(\n            \"collaboratorStep\",\n            \"output\",\n            {\n                collaboratorFeedback: context.analysis?.collaboratorFeedback,\n                iterationReasoning: context.analysis?.iterationReasoning\n            }\n        );\n\n    }\n};\n"]}