scai 0.1.158 → 0.1.160

package/dist/agents/MainAgent.js

@@ -1,12 +1,9 @@
 import { builtInModules } from "../pipeline/registry/moduleRegistry.js";
 import { logInputOutput } from "../utils/promptLogHelper.js";
-import { infoPlanGen } from "./infoPlanGenStep.js";
+import { infoPlanGenStep } from "./infoPlanGenStep.js";
 import { understandIntentStep } from "./understandIntentStep.js";
 import { contextReviewStep } from "./contextReviewStep.js";
-import { planTargetFilesStep } from "./planTargetFilesStep.js";
-import { selectRelevantSourcesStep } from "./selectRelevantSourcesStep.js";
 import { transformPlanGenStep } from "./transformPlanGenStep.js";
-import { finalPlanGenStep } from "./finalPlanGenStep.js";
 import { getDbForRepo } from "../db/client.js";
 import { writeFileStep } from "./writeFileStep.js";
 import { resolveExecutionModeStep } from "./resolveExecutionModeStep.js";
@@ -14,8 +11,14 @@ import { fileCheckStep } from "./fileCheckStep.js";
 import { analysisPlanGenStep } from "./analysisPlanGenStep.js";
 import { readinessGateStep } from "./readinessGateStep.js";
 import { scopeClassificationStep } from "./scopeClassificationStep.js";
-import { routingDecisionStep } from "./routingDecisionStep.js";
 import { evidenceVerifierStep } from "./evidenceVerifierStep.js";
+import { validateChangesStep } from './validateChangesStep.js';
+import { reasonNextIterationStep } from './reasonNextIterationStep.js';
+import { collaboratorStep } from './collaboratorStep.js';
+import { integrateFeedbackStep } from './integrateFeedbackStep.js';
+import { selectRelevantSourcesStep } from "./selectRelevantSourcesStep.js";
+import { iterationFileSelector } from "./iterationFileSelector.js";
+import { finalAnswerModule } from "../pipeline/modules/finalAnswerModule.js";
 /* ───────────────────────── registry ───────────────────────── */
 /**
  * Registry mapping action names to their corresponding Module implementations.
@@ -39,7 +42,7 @@ function resolveModuleForAction(action) {
  * The agent follows a multi-phase execution model:
  * 1. Boot: Determine intent and execution mode
  * 2. Precheck: File existence validation
- * 3. Scope & Routing: Determine where to act and what actions are allowed
+ * 3. Scope: Determine where to act and what actions are allowed
  * 4. Grounding & Readiness Loop: Acquire evidence and verify readiness
  * 5. Analysis: Perform in-depth analysis
  * 6. Transform: Generate and execute transformations
@@ -59,53 +62,175 @@ export class MainAgent {
         this.query = context.initContext?.userQuery ?? "";
         this.ui = ui;
     }
-    /* ───────────── timers ───────────── */
-    /**
-     * Creates a timer function that measures execution time.
-     *
-     * @returns A function that returns the elapsed time in milliseconds.
-     */
-    startTimer() {
-        const start = Date.now();
-        return () => Date.now() - start;
-    }
-    /* ───────────── spinner helpers ───────────── */
-    /**
-     * Executes a function while pausing the UI spinner.
-     *
-     * @param fn - The function to execute while spinner is paused.
-     */
-    withSpinnerPaused(fn) {
-        this.ui.pause(() => {
-            // Ensure spinner line is fully gone
-            process.stdout.write('\r\x1b[K');
-            fn();
-        });
+    /* ───────────── main run ───────────── */
+    async run() {
+        this.runCount = 0;
+        /* ===== BOOT ===== */
+        await understandIntentStep.run({ context: this.context });
+        await resolveExecutionModeStep.run(this.context);
+        this.taskId = bootTaskForRepo(this.context, getDbForRepo(), this.logLine.bind(this));
+        /* ===== PRECHECK ===== */
+        await fileCheckStep(this.context);
+        /* ===== SCOPE ===== */
+        await scopeClassificationStep.run(this.context);
+        /* ===== GROUNDING / INFO ACQUISITION ===== */
+        await this.runGrounding();
+        /* ===== WORK LOOP ===== */
+        const MAX_ITERATIONS = 5;
+        let loopCount = 0;
+        // Helper: determine next iteration action
+        const getNextIterationAction = () => {
+            const nextAction = this.context.analysis?.iterationReasoning?.nextAction;
+            if (!nextAction)
+                return "complete"; // default safe exit
+            return nextAction;
+        };
+        while (loopCount < MAX_ITERATIONS) {
+            this.runCount++;
+            loopCount++;
+            await this.runWorkIteration();
+            const nextAction = getNextIterationAction();
+            this.logLine("LOOP", "nextAction", undefined, nextAction);
+            if (nextAction === "complete")
+                break;
+            if (nextAction === "request-feedback")
+                return;
+        }
+        /* ===== FINALIZE ===== */
+        // Directly generate the final answer for the user
+        await finalAnswerModule.run({ query: this.query, context: this.context });
+        // Persist task as usual
+        persistTaskData(this.context, this.taskId, getDbForRepo(), this.logLine.bind(this));
     }
-    /**
-     * Logs a line with timing information.
-     *
-     * @param phase - The phase of execution.
-     * @param step - The step being executed.
-     * @param ms - The execution time in milliseconds.
-     * @param desc - Optional description of the step.
-     */
-    logLine(phase, step, ms, desc) {
-        this.withSpinnerPaused(() => {
-            const suffix = desc ? ` — ${desc}` : "";
-            const timing = typeof ms === "number" ? ` (${ms}ms)` : "";
-            console.log(`[AGENT] ${phase} :: ${step}${suffix}${timing}`);
-        });
+    /* ───────────── grounding / info acquisition loop ───────────── */
+    async runGrounding() {
+        let ready = false;
+        while (!ready && this.runCount < this.maxRuns) {
+            // ---------------- INFORMATION ACQUISITION ----------------
+            if (this.canExecutePhase("planning") &&
+                this.canExecuteScope("planning")) {
+                const t = this.startTimer();
+                // Generate info plan step(s) in context
+                await infoPlanGenStep.run(this.context);
+                const infoPlan = this.context.analysis?.planSuggestion?.plan ?? { steps: [] };
+                for (const step of infoPlan.steps) {
+                    const stepIO = { query: this.query };
+                    await this.executeStep(step, stepIO);
+                    // Re-check any new files discovered
+                    const t2 = this.startTimer();
+                    await fileCheckStep(this.context);
+                    this.logLine("PRECHECK", "postFileSearch", t2());
+                }
+                this.logLine("PLAN", "infoPlanGen", t());
+            }
+            // ---------------- DETERMINISTIC EVIDENCE VERIFICATION ----------------
+            const t1 = this.startTimer();
+            await evidenceVerifierStep.run({ query: this.query, context: this.context });
+            this.logLine("ANALYSIS", "collectAnalysisEvidence", t1(), undefined);
+            // Select grounded candidate files
+            const t2 = this.startTimer();
+            await selectRelevantSourcesStep.run({ query: this.query, context: this.context });
+            this.logLine("ANALYSIS", "selectRelevantSources", t2(), undefined);
+            // ---------------- READINESS GATE ----------------
+            const t3 = this.startTimer();
+            await readinessGateStep.run(this.context);
+            this.logLine("HASINFO", "readinessGate", t3(), undefined);
+            ready = this.context.analysis?.readiness?.decision === "ready";
+            if (!ready) {
+                this.runCount++;
+                // Previously resetInitContextForLoop removed; optionally clear temporary data
+                if (this.context.analysis) {
+                    this.context.analysis.planSuggestion = undefined;
+                }
+                this.logLine("HASINFO", "readinessGate", undefined, "Not ready, looping back to information acquisition");
+            }
+        }
     }
-    /**
-     * Logs a message to the user output.
-     *
-     * @param message - The message to log.
-     */
-    userOutput(message) {
-        this.withSpinnerPaused(() => {
-            console.log(`[USER OUTPUT] ${message}`);
-        });
+    /* ───────────── work iteration ───────────── */
+    async runWorkIteration() {
+        // ---------------- FILE SELECTION ----------------
+        const tSelect = this.startTimer();
+        await iterationFileSelector.run(this.context); // <-- sets context.analysis.currentTargetFile
+        this.logLine("LOOP", "iterationFileSelector", tSelect());
+        // ---------------- ANALYSIS ----------------
+        if (this.canExecutePhase("analysis") && this.canExecuteScope("analysis")) {
+            const tAnalysis = this.startTimer();
+            await analysisPlanGenStep.run(this.context);
+            this.logLine("PLAN", "analysisPlanGen", tAnalysis());
+            /* // 🔎 DEBUG BREAKPOINT — inspect context BEFORE analysis planning
+            debugContext(this.context, {
+                step: "pre-analysisPlanGen",
+                note: "After iterationFileSelector, before analysisPlanGen",
+                exit: true,      // set to false if you want execution to continue
+                depth: 6
+            });
+ */
+            const analysisPlan = this.context.analysis?.planSuggestion?.plan ?? { steps: [] };
+            for (const step of analysisPlan.steps) {
+                const tStep = this.startTimer();
+                await this.executeStep(step, { query: this.query });
+                this.logLine("STEP", step.action || "unnamedStep", tStep());
+            }
+            if (this.context.analysis) {
+                this.context.analysis.planSuggestion = undefined;
+            }
+        }
+        // ---------------- TRANSFORM ----------------
+        if (this.canExecutePhase("transform") && this.canExecuteScope("transform")) {
+            const tTransform = this.startTimer();
+            await transformPlanGenStep.run(this.context);
+            this.logLine("PLAN", "transformPlanGen", tTransform());
+            const transformPlan = this.context.analysis?.planSuggestion?.plan ?? { steps: [] };
+            let stepCounter = 1; // 🔹 initialize step counter
+            for (const step of transformPlan.steps) {
+                const tStep = this.startTimer();
+                await this.executeStep(step, { query: this.query });
+                // 🔹 include step number in log
+                this.logLine("STEP", `#${stepCounter} - ${step.action || "unnamedStep"}`, tStep());
+                stepCounter++; // 🔹 increment counter
+            }
+            if (this.context.analysis) {
+                this.context.analysis.planSuggestion = undefined;
+            }
+            // ---------------- WRITE ----------------
+            if (this.canExecutePhase("write") && this.canExecuteScope("write")) {
+                const tWrite = this.startTimer();
+                await writeFileStep.run({ query: this.query, context: this.context });
+                this.logLine("WRITE", "writeFileStep", tWrite());
+            }
+            // ---------------- VALIDATION ----------------
+            const tValidate = this.startTimer();
+            await validateChangesStep.run(this.context);
+            this.logLine("VALIDATION", "validateChangesStep", tValidate());
+        }
+        // ---------------- REASONING ----------------
+        const tReason = this.startTimer();
+        await reasonNextIterationStep.run(this.context);
+        this.logLine("REASONING", "reasonNextIterationStep", tReason());
+        // ---------------- COLLABORATOR FEEDBACK ----------------
+        const tCollab = this.startTimer();
+        await collaboratorStep.run(this.context);
+        this.logLine("FEEDBACK", "collaboratorStep", tCollab());
+        // ---------------- INTEGRATE FEEDBACK ----------------
+        const tIntegrate = this.startTimer();
+        await integrateFeedbackStep.run(this.context);
+        this.logLine("FEEDBACK", "integrateFeedbackStep", tIntegrate());
+        // ---------------- REVIEW / RECOVERY ----------------
+        const tReview = this.startTimer();
+        const review = await contextReviewStep(this.context);
+        this.logLine("REVIEW", "contextReviewStep", tReview());
+        if (review.decision === "gatherData" && this.runCount < this.maxRuns) {
+            this.runCount++;
+            if (this.context.analysis) {
+                this.context.analysis.readiness = {
+                    decision: 'not-ready',
+                    confidence: 0,
+                    rationale: 'Additional data gathering required.'
+                };
+                this.context.analysis.planSuggestion = undefined;
+            }
+            this.logLine("REVIEW", "contextReviewStep", undefined, "Not ready, looping back for additional data gathering");
+        }
     }
     /* ───────────── step executor ───────────── */
     /**
@@ -118,7 +243,9 @@ export class MainAgent {
      */
     async executeStep(step, input) {
         const stop = this.startTimer();
+        // Set current step in context
         this.context.currentStep = step;
+        // Resolve module for this action
         const mod = resolveModuleForAction(step.action);
         if (!mod) {
             this.logLine("EXECUTE", step.action, stop(), "skipped (missing module)");
@@ -126,15 +253,15 @@ export class MainAgent {
         }
         try {
             this.ui.update(`Running step: ${step.action}`);
-            const output = await mod.run({
+            // Execute the module
+            await mod.run({
                 query: step.description ?? input.query,
                 content: input.data ?? input.content,
                 context: this.context
             });
-            if (!output)
-                throw new Error(`Module "${mod.name}" returned empty output`);
             this.logLine("EXECUTE", step.action, stop());
-            return { query: step.description ?? input.query, data: output.data };
+            // Return ModuleIO (can remain minimal since output is untyped)
+            return { query: step.description ?? input.query, data: {} };
         }
         catch (err) {
             this.logLine("EXECUTE", step.action, stop(), "failed");
@@ -205,211 +332,56 @@ export class MainAgent {
         this.logLine("EXEC", "canExecuteScope", undefined, `phase=${phase}, scope=${scope}, allowed=${allowed}`);
         return allowed;
     }
-    /* ───────────── main run ───────────── */
+    /* ----------------------------------- */
+    /* ------------- helpers ------------- */
+    /* ----------------------------------- */
+    /* ───────────── timers ───────────── */
     /**
-     * Executes the main agent run sequence.
+     * Creates a timer function that measures execution time.
      *
-     * @returns A promise resolving to the final ModuleIO output or void.
+     * @returns A function that returns the elapsed time in milliseconds.
      */
-    async run() {
-        this.runCount++;
-        const stopRun = this.startTimer();
-        this.logLine("RUN", `start #${this.runCount}`);
-        logInputOutput("GlobalContext (structured)", "input", this.context);
-        /* ================= BOOT ================= */
-        // AXIS 1: Capability — determine WHAT actions are allowed
-        // executionMode: "explain" | "analyze" | "transform"
-        // Controls: files may be written, code analyzed, or run text-only
-        // This step does NOT determine WHERE to act or whether enough evidence exists
-        {
-            const t1 = this.startTimer();
-            await understandIntentStep.run({ context: this.context }); // Classify user intent
-            this.logLine("BOOT", "understandIntent", t1());
-            const t2 = this.startTimer();
-            await resolveExecutionModeStep.run(this.context); // Set executionMode
-            this.logLine("BOOT", "resolveExecutionMode", t2(), `mode = ${this.context.executionControl?.mode}`);
-            const db = getDbForRepo();
-            this.taskId = bootTaskForRepo(this.context, db, this.logLine.bind(this)); // Persist task
-        }
-        /* ================= PRECHECK (INITIAL) ================= */
-        // Quick file existence check (pre-grounding)
-        // Does NOT infer relevance or scope beyond directly referenced files
-        {
-            const t = this.startTimer();
-            await fileCheckStep(this.context);
-            this.logLine("PRECHECK", "preFileSearch", t());
-        }
-        /* ───────────────────────── SCOPE & ROUTING GATE ───────────────────────── */
-        // AXIS 2: Scope — determine WHERE the agent may act
-        // scopeType: "none" | "single-file" | "multi-file" | "repo-wide"
-        // Responsible for deciding which files, repos, or modules the agent should consider
-        // Does NOT validate anchors (Axis 3) or decide allowed actions (Axis 1)
-        // ----------------- SCOPE CLASSIFICATION -----------------
-        // Responsibility:
-        //  - Determine problem coverage: none / single-file / multi-file / repo-wide
-        //  - Purely repo/file coverage decision
-        //  - Output: context.analysis.scopeType
-        // Does NOT decide allowed actions, validate evidence, or affect executionMode
-        {
-            const t1 = this.startTimer();
-            await scopeClassificationStep.run(this.context);
-            this.logLine("SCOPE", "scopeClassification", t1());
-        }
-        // ----------------- ROUTING DECISION -----------------
-        // Responsibility:
-        //  - Determine allowed actions within scope
-        //    * Can search be performed?
-        //    * Are early exits (explain) allowed?
-        //  - Output: context.analysis.routingDecision
-        // Does NOT check anchors, determine readiness, or modify scope
-        {
-            const t2 = this.startTimer();
-            await routingDecisionStep.run(this.context);
-            this.logLine("SCOPE", "routingDecision", t2());
-        }
-        /* ================= GROUNDING & READINESS LOOP ================= */
-        // AXIS 3: Certainty — do we have enough evidence to safely proceed?
-        // confidence: "high" | "medium" | "low"
-        // Controls whether we loop back to acquire more info
-        // Does NOT change executionMode (Axis 1) or scopeType (Axis 2)
-        let ready = false;
-        while (!ready && this.runCount < this.maxRuns) {
-            const routing = this.context.analysis?.routingDecision;
-            // ---------------- INFORMATION ACQUISITION ----------------
-            // Plan & execute info steps; may discover new files
-            // Does NOT guarantee readiness — anchors still need verification
-            if (this.canExecutePhase("planning") &&
-                this.canExecuteScope("planning") &&
-                routing?.allowInfoSteps !== false) {
-                const t = this.startTimer();
-                await infoPlanGen.run(this.context); // Generate info-gathering plan
-                this.logLine("PLAN", "infoPlanGen", t());
-                let stepIO = { query: this.query };
-                const infoPlan = this.context.analysis?.planSuggestion?.plan ?? { steps: [] };
-                for (const step of infoPlan.steps.filter(s => s.groups?.includes("info"))) {
-                    // Guard: skip fileSearch if routingDecision forbids repo search
-                    if (step.action === "fileSearch" && !routing?.allowSearch) {
-                        this.logLine("PLAN", "infoStepSkipped", undefined, `Step "${step.description}" skipped: file search not allowed by routingDecision`);
-                        continue;
-                    }
-                    stepIO = await this.executeStep(step, stepIO);
-                }
-                // Re-run precheck for newly discovered files
-                if (infoPlan.steps.length > 0) {
-                    const t2 = this.startTimer();
-                    await fileCheckStep(this.context);
-                    this.logLine("PRECHECK", "postFileSearch", t2());
-                }
-            }
-            // ---------------- DETERMINISTIC EVIDENCE VERIFICATION ----------------
-            // Verify anchors exist (filenames, paths, literals)
-            // Does NOT execute full analysis or transformations
-            const t1 = this.startTimer();
-            await evidenceVerifierStep.run({ query: this.query, context: this.context });
-            this.logLine("ANALYSIS", "collectAnalysisEvidence", t1(), undefined);
-            // Select grounded candidate files
-            // Does NOT update executionMode or scope classification
-            const t2 = this.startTimer();
-            await selectRelevantSourcesStep.run({ query: this.query, context: this.context });
-            this.logLine("ANALYSIS", "selectRelevantSources", t2(), undefined);
-            // ---------------- READINESS GATE ----------------
-            // Decide if we have enough info to proceed
-            // Does NOT modify info plan or transform steps
-            const t3 = this.startTimer();
-            await readinessGateStep.run(this.context);
-            this.logLine("HASINFO", "readinessGate", t3(), undefined);
-            ready = this.context.analysis?.readiness?.decision === "ready";
-            if (!ready) {
-                this.runCount++;
-                this.resetInitContextForLoop();
-                this.logLine("HASINFO", "readinessGate", undefined, "Not ready, looping back to information acquisition");
-            }
-        }
-        /* ================= ANALYSIS (DEEP) ================= */
-        if (this.canExecutePhase("analysis") &&
-            this.canExecuteScope("analysis")) {
-            {
-                const t = this.startTimer();
-                await analysisPlanGenStep.run(this.context);
-                this.logLine("PLAN", "analysisPlanGen", t());
-            }
-            let stepIO = { query: this.query };
-            const analysisPlan = this.context.analysis?.planSuggestion?.plan?.steps ?? [];
-            for (const step of analysisPlan.filter(s => s.groups?.includes("analysis"))) {
-                stepIO = await this.executeStep(step, stepIO);
-            }
-            {
-                const t = this.startTimer();
-                await planTargetFilesStep.run({ query: this.query, context: this.context });
-                this.logLine("ANALYSIS", "planTargetFiles", t());
-            }
-            const review = await contextReviewStep(this.context);
-            if (review.decision === "has" && this.runCount < this.maxRuns) {
-                this.runCount++;
-                this.resetInitContextForLoop();
-                return this.run();
-            }
-        }
-        /* ================= EXPLAIN (EVIDENCE EXIT) ================= */
-        // Early exit if mode=explain and routing allows it
-        // Does NOT perform analysis, transform, or write steps
-        if (this.canExecutePhase("explain") &&
-            this.canExecuteScope("explain") &&
-            this.context.analysis?.routingDecision?.decision === "has-info") {
-            const explainMod = resolveModuleForAction("explain");
-            if (!explainMod)
-                throw new Error("Explain module not found");
-            return await explainMod.run({
-                query: this.query,
-                context: this.context
-            });
-        }
-        // Remaining phases (ANALYSIS, TRANSFORM, FINALIZE, PERSIST) execute after loop exits
-        /* ================= TRANSFORM ================= */
-        if (this.canExecutePhase("transform") &&
-            this.canExecuteScope("transform")) {
-            {
-                const t = this.startTimer();
-                await transformPlanGenStep.run(this.context);
-                this.logLine("PLAN", "transformPlanGen", t());
-            }
-            let stepIO = { query: this.query };
-            const transformSteps = this.context.analysis?.planSuggestion?.plan?.steps
-                ?.filter(s => s.groups?.includes("transform")) ?? [];
-            for (const step of transformSteps) {
-                stepIO = await this.executeStep(step, stepIO);
-            }
-            if (this.canExecutePhase("write") &&
-                this.canExecuteScope("write")) {
-                const t = this.startTimer();
-                await writeFileStep.run({ query: this.query, context: this.context });
-                this.logLine("EXECUTE", "writeFile", t());
-            }
-        }
-        /* ================= FINALIZE ================= */
-        {
-            const t = this.startTimer();
-            await finalPlanGenStep.run(this.context);
-            this.logLine("PLAN", "finalPlanGen", t());
-            let stepIO = { query: this.query };
-            const finalPlan = this.context.analysis?.planSuggestion?.plan ?? { steps: [] };
-            for (const step of finalPlan.steps.filter(s => s.groups?.includes("finalize"))) {
-                stepIO = await this.executeStep(step, stepIO);
-            }
-        }
-        const db = getDbForRepo();
-        persistTaskData(this.context, this.taskId, db, this.logLine.bind(this));
-        this.logLine("RUN", "complete", stopRun());
-        return { query: this.query, data: {} };
+    startTimer() {
+        const start = Date.now();
+        return () => Date.now() - start;
     }
+    /* ───────────── spinner helpers ───────────── */
     /**
-     * Resets the initial context for the next loop iteration.
+     * Executes a function while pausing the UI spinner.
      *
-     * This is used to clear related files from the context before looping back.
+     * @param fn - The function to execute while spinner is paused.
      */
-    resetInitContextForLoop() {
-        if (this.context.initContext)
-            this.context.initContext.relatedFiles = [];
+    withSpinnerPaused(fn) {
+        this.ui.pause(() => {
+            // Ensure spinner line is fully gone
+            process.stdout.write('\r\x1b[K');
+            fn();
+        });
+    }
+    /**
+     * Logs a line with timing information.
+     *
+     * @param phase - The phase of execution.
+     * @param step - The step being executed.
+     * @param ms - The execution time in milliseconds.
+     * @param desc - Optional description of the step.
+     */
+    logLine(phase, step, ms, desc) {
+        this.withSpinnerPaused(() => {
+            const suffix = desc ? ` — ${desc}` : "";
+            const timing = typeof ms === "number" ? ` (${ms}ms)` : "";
+            console.log(`[AGENT] ${phase} :: ${step}${suffix}${timing}`);
+        });
+    }
+    /**
+     * Logs a message to the user output.
+     *
+     * @param message - The message to log.
+     */
+    userOutput(message) {
+        this.withSpinnerPaused(() => {
+            console.log(`[USER OUTPUT] ${message}`);
+        });
     }
 }
 /* ───────────── FOLDER CAPSULES SUMMARY HELPER ───────────── */
@@ -440,7 +412,7 @@ export function logFolderCapsulesSummary(context) {
                 body += summaryText;
             if (key) {
                 const keyHint = `Key: ${key.path.split("/").pop()} — ${truncate(key.reason)}`;
-                body += summaryText ? ` [${keyHint}]` : keyHint;
+                body += summaryText ? `[${keyHint}]` : keyHint;
             }
         }
         return body ? `${header}\n${body}` : header;
@@ -480,11 +452,6 @@ export function persistTaskData(context, taskId, db, logLine) {
     if (context.analysis?.focus?.candidateFiles?.length) {
         fieldsToUpdate.missing_files_json = JSON.stringify(context.analysis.focus.candidateFiles);
     }
-    // ❌ focus_rationale intentionally removed
-    // Persist routing decision (meta / audit)
-    if (context.analysis?.routingDecision) {
-        fieldsToUpdate.routing_decision_json = JSON.stringify(context.analysis.routingDecision);
-    }
     // ✅ Persist final answer → tasks.summary
     if (context.analysis?.finalAnswer) {
         fieldsToUpdate.summary = context.analysis.finalAnswer;