@yuaone/core 0.6.1 → 0.7.1

package/dist/planner/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/planner/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/planner/milestone-checker.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @module planner/milestone-checker
+ * @description Tracks milestone progress within a HierarchicalPlan execution.
+ * Milestones are checkpoints derived from tactical tasks that indicate overall
+ * plan health and schedule adherence.
+ */
+import type { HierarchicalPlan } from "../hierarchical-planner.js";
+export interface Milestone {
+    id: string;
+    description: string;
+    targetTaskIds: string[];
+    expectedByIteration: number;
+    priority: "must" | "should" | "could";
+}
+export interface MilestoneStatus {
+    achieved: Milestone[];
+    missed: Milestone[];
+    pending: Milestone[];
+    behindSchedule: boolean;
+    consecutiveMisses: number;
+    overallProgress: number;
+}
+export declare class MilestoneChecker {
+    private milestones;
+    private consecutiveMisses;
+    private lastStatus;
+    /**
+     * Extract milestones from a HierarchicalPlan.
+     * Groups tactical tasks into milestones:
+     * - Independent tasks (no dependsOn) → first "should" milestone
+     * - Every 3 tasks → one "should" milestone
+     * - Last task → one "must" milestone (completion)
+     */
+    extractMilestones(plan: HierarchicalPlan): Milestone[];
+    /**
+     * Evaluate current milestone status given completed tasks and current iteration.
+     */
+    check(milestones: Milestone[], completedTaskIds: string[], currentIteration: number): MilestoneStatus;
+    /**
+     * Register externally defined milestones.
+     */
+    setMilestones(milestones: Milestone[]): void;
+    /**
+     * Get milestones at risk: pending milestones past their expectedByIteration.
+     */
+    getAtRisk(currentIteration: number): Milestone[];
+}
+//# sourceMappingURL=milestone-checker.d.ts.map

package/dist/planner/milestone-checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"milestone-checker.d.ts","sourceRoot":"","sources":["../../src/planner/milestone-checker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAInE,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;CACvC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;CACzB;AAID,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,UAAU,CAAgC;IAElD;;;;;;OAMG;IACH,iBAAiB,CAAC,IAAI,EAAE,gBAAgB,GAAG,SAAS,EAAE;IA8CtD;;OAEG;IACH,KAAK,CACH,UAAU,EAAE,SAAS,EAAE,EACvB,gBAAgB,EAAE,MAAM,EAAE,EAC1B,gBAAgB,EAAE,MAAM,GACvB,eAAe;IAsClB;;OAEG;IACH,aAAa,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,IAAI;IAI5C;;OAEG;IACH,SAAS,CAAC,gBAAgB,EAAE,MAAM,GAAG,SAAS,EAAE;CAOjD"}

package/dist/planner/milestone-checker.js

@@ -0,0 +1,113 @@
+/**
+ * @module planner/milestone-checker
+ * @description Tracks milestone progress within a HierarchicalPlan execution.
+ * Milestones are checkpoints derived from tactical tasks that indicate overall
+ * plan health and schedule adherence.
+ */
+// ─── MilestoneChecker ───
+export class MilestoneChecker {
+    milestones = [];
+    consecutiveMisses = 0;
+    lastStatus = null;
+    /**
+     * Extract milestones from a HierarchicalPlan.
+     * Groups tactical tasks into milestones:
+     * - Independent tasks (no dependsOn) → first "should" milestone
+     * - Every 3 tasks → one "should" milestone
+     * - Last task → one "must" milestone (completion)
+     */
+    extractMilestones(plan) {
+        const tasks = plan.tactical;
+        if (tasks.length === 0)
+            return [];
+        const milestones = [];
+        const totalIterations = plan.totalEstimatedIterations;
+        // Milestone 1: Initial exploration (first batch of independent tasks)
+        const independentFirst = tasks
+            .filter((t) => t.dependsOn.length === 0)
+            .map((t) => t.id);
+        if (independentFirst.length > 0) {
+            milestones.push({
+                id: "milestone:initial",
+                description: "Initial exploration and file reading complete",
+                targetTaskIds: independentFirst.slice(0, Math.min(3, independentFirst.length)),
+                expectedByIteration: Math.floor(totalIterations * 0.2),
+                priority: "should",
+            });
+        }
+        // Middle milestones: every 3 tasks
+        for (let i = 0; i < tasks.length - 1; i += 3) {
+            const batch = tasks.slice(i, i + 3).map((t) => t.id);
+            milestones.push({
+                id: `milestone:batch-${Math.floor(i / 3)}`,
+                description: `Tasks ${i + 1}–${Math.min(i + 3, tasks.length)} complete`,
+                targetTaskIds: batch,
+                expectedByIteration: Math.floor(totalIterations * ((i + 3) / tasks.length)),
+                priority: "should",
+            });
+        }
+        // Final milestone: all tasks done
+        milestones.push({
+            id: "milestone:complete",
+            description: "All planned tasks completed",
+            targetTaskIds: tasks.map((t) => t.id),
+            expectedByIteration: totalIterations,
+            priority: "must",
+        });
+        this.milestones = milestones;
+        return milestones;
+    }
+    /**
+     * Evaluate current milestone status given completed tasks and current iteration.
+     */
+    check(milestones, completedTaskIds, currentIteration) {
+        const completedSet = new Set(completedTaskIds);
+        const achieved = [];
+        const missed = [];
+        const pending = [];
+        for (const m of milestones) {
+            const allDone = m.targetTaskIds.every((id) => completedSet.has(id));
+            if (allDone) {
+                achieved.push(m);
+            }
+            else if (currentIteration > m.expectedByIteration) {
+                missed.push(m);
+            }
+            else {
+                pending.push(m);
+            }
+        }
+        // Track consecutive misses for "must" milestones
+        const mustMissed = missed.filter((m) => m.priority === "must").length;
+        if (mustMissed > 0) {
+            this.consecutiveMisses++;
+        }
+        else if (achieved.length > 0) {
+            this.consecutiveMisses = 0;
+        }
+        const status = {
+            achieved,
+            missed,
+            pending,
+            behindSchedule: missed.some((m) => m.priority === "must"),
+            consecutiveMisses: this.consecutiveMisses,
+            overallProgress: milestones.length > 0 ? achieved.length / milestones.length : 1,
+        };
+        this.lastStatus = status;
+        return status;
+    }
+    /**
+     * Register externally defined milestones.
+     */
+    setMilestones(milestones) {
+        this.milestones = milestones;
+    }
+    /**
+     * Get milestones at risk: pending milestones past their expectedByIteration.
+     */
+    getAtRisk(currentIteration) {
+        return this.milestones.filter((m) => currentIteration > m.expectedByIteration &&
+            !this.lastStatus?.achieved.some((a) => a.id === m.id));
+    }
+}
+//# sourceMappingURL=milestone-checker.js.map

package/dist/planner/milestone-checker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"milestone-checker.js","sourceRoot":"","sources":["../../src/planner/milestone-checker.ts"],"names":[],"mappings":"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"}

package/dist/planner/plan-evaluator.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @module planner/plan-evaluator
+ * @description Evaluates the health of a running HierarchicalPlan.
+ * Detects deviations, predicts token overruns, and recommends corrective actions.
+ */
+import type { HierarchicalPlan } from "../hierarchical-planner.js";
+import type { StateStore } from "../world-model/state-store.js";
+import type { SimulationEngine } from "../world-model/simulation-engine.js";
+import type { ToolResult } from "../types.js";
+export type DeviantType = "unexpected_file" | "scope_creep" | "blocked_dependency" | "token_overrun" | "quality_regression";
+export interface PlanDeviation {
+    type: DeviantType;
+    description: string;
+    severity: "low" | "medium" | "high";
+    affectedTaskIds: string[];
+}
+export interface PlanHealth {
+    score: number;
+    completedTasks: number;
+    totalTasks: number;
+    progressRatio: number;
+    tokensUsed: number;
+    tokensRemaining: number;
+    deviations: PlanDeviation[];
+    recommendation: "continue" | "replan_minor" | "replan_major" | "abort";
+}
+export declare class PlanEvaluator {
+    private stateStore;
+    private simulationEngine;
+    constructor(stateStore: StateStore, simulationEngine: SimulationEngine);
+    evaluate(plan: HierarchicalPlan, completedTaskIds: string[], toolResults: ToolResult[], tokensUsed: number, tokenBudget: number): PlanHealth;
+    detectUnexpectedChanges(plan: HierarchicalPlan, actualChangedFiles: string[]): PlanDeviation[];
+    predictTokenOverrun(plan: HierarchicalPlan, tokensUsed: number, completedRatio: number): boolean;
+}
+//# sourceMappingURL=plan-evaluator.d.ts.map

package/dist/planner/plan-evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-evaluator.d.ts","sourceRoot":"","sources":["../../src/planner/plan-evaluator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAI9C,MAAM,MAAM,WAAW,GACnB,iBAAiB,GACjB,aAAa,GACb,oBAAoB,GACpB,eAAe,GACf,oBAAoB,CAAC;AAEzB,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACpC,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,cAAc,EAAE,UAAU,GAAG,cAAc,GAAG,cAAc,GAAG,OAAO,CAAC;CACxE;AAID,qBAAa,aAAa;IAEtB,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,gBAAgB;gBADhB,UAAU,EAAE,UAAU,EACtB,gBAAgB,EAAE,gBAAgB;IAG5C,QAAQ,CACN,IAAI,EAAE,gBAAgB,EACtB,gBAAgB,EAAE,MAAM,EAAE,EAC1B,WAAW,EAAE,UAAU,EAAE,EACzB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,UAAU;IAoEb,uBAAuB,CACrB,IAAI,EAAE,gBAAgB,EACtB,kBAAkB,EAAE,MAAM,EAAE,GAC3B,aAAa,EAAE;IAelB,mBAAmB,CACjB,IAAI,EAAE,gBAAgB,EACtB,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,GACrB,OAAO;CAKX"}

package/dist/planner/plan-evaluator.js

@@ -0,0 +1,92 @@
+/**
+ * @module planner/plan-evaluator
+ * @description Evaluates the health of a running HierarchicalPlan.
+ * Detects deviations, predicts token overruns, and recommends corrective actions.
+ */
+// ─── PlanEvaluator ───
+export class PlanEvaluator {
+    stateStore;
+    simulationEngine;
+    constructor(stateStore, simulationEngine) {
+        this.stateStore = stateStore;
+        this.simulationEngine = simulationEngine;
+    }
+    evaluate(plan, completedTaskIds, toolResults, tokensUsed, tokenBudget) {
+        const completedSet = new Set(completedTaskIds);
+        const totalTasks = plan.tactical.length;
+        const completedTasks = completedTaskIds.length;
+        const progressRatio = totalTasks > 0 ? completedTasks / totalTasks : 0;
+        const tokensRemaining = tokenBudget - tokensUsed;
+        const deviations = [];
+        // 1. Detect unexpected file changes
+        // ToolResult has no args field — callers should pass changedFiles separately.
+        // We collect tool names that indicate file writes for quality assessment only.
+        const writeToolCount = toolResults
+            .filter(r => r.success && (r.name === "file_write" || r.name === "file_edit"))
+            .length;
+        void writeToolCount; // available for future heuristics
+        deviations.push(...this.detectUnexpectedChanges(plan, []));
+        // 2. Detect token overrun risk
+        if (this.predictTokenOverrun(plan, tokensUsed, progressRatio)) {
+            deviations.push({
+                type: "token_overrun",
+                description: `Token usage on pace to exceed budget (used ${Math.round(tokensUsed / 1000)}K / ${Math.round(tokenBudget / 1000)}K at ${Math.round(progressRatio * 100)}% completion)`,
+                severity: tokensUsed / tokenBudget > 0.9 ? "high" : "medium",
+                affectedTaskIds: plan.tactical.slice(completedTasks).map(t => t.id),
+            });
+        }
+        // 3. Check for failed tool results
+        const failedCount = toolResults.filter(r => !r.success).length;
+        if (failedCount > 2) {
+            deviations.push({
+                type: "quality_regression",
+                description: `${failedCount} tool executions failed`,
+                severity: failedCount > 5 ? "high" : "medium",
+                affectedTaskIds: [],
+            });
+        }
+        // 4. Compute health score (100 = perfect)
+        let score = 100;
+        for (const d of deviations) {
+            score -= d.severity === "high" ? 25 : d.severity === "medium" ? 10 : 5;
+        }
+        // Penalize low progress ratio relative to tokens used
+        const efficiency = progressRatio / Math.max(tokensUsed / tokenBudget, 0.01);
+        if (efficiency < 0.5)
+            score -= 15;
+        score = Math.max(0, Math.min(100, score));
+        const recommendation = score < 20 ? "abort" :
+            score < 45 ? "replan_major" :
+                score < 65 ? "replan_minor" :
+                    "continue";
+        return {
+            score,
+            completedTasks,
+            totalTasks,
+            progressRatio,
+            tokensUsed,
+            tokensRemaining,
+            deviations,
+            recommendation,
+        };
+    }
+    detectUnexpectedChanges(plan, actualChangedFiles) {
+        const plannedFiles = new Set(plan.tactical.flatMap(t => [...t.targetFiles, ...t.readFiles]));
+        const unexpected = actualChangedFiles.filter(f => !plannedFiles.has(f));
+        if (unexpected.length === 0)
+            return [];
+        return [{
+                type: "unexpected_file",
+                description: `${unexpected.length} files modified outside plan: ${unexpected.slice(0, 3).join(", ")}${unexpected.length > 3 ? " ..." : ""}`,
+                severity: unexpected.length > 5 ? "high" : unexpected.length > 2 ? "medium" : "low",
+                affectedTaskIds: [],
+            }];
+    }
+    predictTokenOverrun(plan, tokensUsed, completedRatio) {
+        if (completedRatio < 0.1)
+            return false; // too early to predict
+        const projectedTotal = tokensUsed / completedRatio;
+        return projectedTotal > plan.estimatedTokenBudget * 1.3; // 30% over budget
+    }
+}
+//# sourceMappingURL=plan-evaluator.js.map

package/dist/planner/plan-evaluator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-evaluator.js","sourceRoot":"","sources":["../../src/planner/plan-evaluator.ts"],"names":[],"mappings":"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"}

package/dist/planner/replanning-engine.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @module planner/replanning-engine
+ * @description Proactive replanning engine — evaluates plan health mid-execution
+ * and triggers partial or full replanning when deviations are detected.
+ */
+import type { HierarchicalPlan, HierarchicalPlanner, TacticalTask } from "../hierarchical-planner.js";
+import type { BYOKClient } from "../llm-client.js";
+import type { WorldState } from "../world-model/state-store.js";
+import type { ToolResult } from "../types.js";
+import type { PlanEvaluator } from "./plan-evaluator.js";
+import type { RiskEstimator } from "./risk-estimator.js";
+import type { MilestoneChecker, Milestone } from "./milestone-checker.js";
+export interface ReplanDecision {
+    shouldReplan: boolean;
+    scope: "none" | "operational" | "tactical" | "strategic";
+    trigger: string;
+    urgency: "low" | "medium" | "high" | "critical";
+    reasoning: string;
+}
+export interface ProactiveReplanResult {
+    triggered: boolean;
+    decision: ReplanDecision;
+    newPlan?: HierarchicalPlan;
+    modifiedTasks?: TacticalTask[];
+    message: string;
+}
+export declare class ReplanningEngine {
+    private planner;
+    private planEvaluator;
+    private riskEstimator;
+    private milestoneChecker;
+    constructor(planner: HierarchicalPlanner, planEvaluator: PlanEvaluator, riskEstimator: RiskEstimator, milestoneChecker: MilestoneChecker);
+    evaluate(plan: HierarchicalPlan, currentState: WorldState, completedTaskIds: string[], toolResults: ToolResult[], tokensUsed: number, tokenBudget: number, changedFiles: string[], currentIteration: number, activeMilestones: Milestone[], llmClient: BYOKClient): Promise<ProactiveReplanResult>;
+    private shouldTrigger;
+    private executeReplan;
+}
+//# sourceMappingURL=replanning-engine.d.ts.map

package/dist/planner/replanning-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replanning-engine.d.ts","sourceRoot":"","sources":["../../src/planner/replanning-engine.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,mBAAmB,EACnB,YAAY,EAEb,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAc,MAAM,qBAAqB,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAa,MAAM,qBAAqB,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAmB,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAI3F,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,MAAM,GAAG,aAAa,GAAG,UAAU,GAAG,WAAW,CAAC;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IAChD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,cAAc,CAAC;IACzB,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,aAAa,CAAC,EAAE,YAAY,EAAE,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;CACjB;AAID,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,aAAa;IACrB,OAAO,CAAC,aAAa;IACrB,OAAO,CAAC,gBAAgB;gBAHhB,OAAO,EAAE,mBAAmB,EAC5B,aAAa,EAAE,aAAa,EAC5B,aAAa,EAAE,aAAa,EAC5B,gBAAgB,EAAE,gBAAgB;IAGtC,QAAQ,CACZ,IAAI,EAAE,gBAAgB,EACtB,YAAY,EAAE,UAAU,EACxB,gBAAgB,EAAE,MAAM,EAAE,EAC1B,WAAW,EAAE,UAAU,EAAE,EACzB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EAAE,EACtB,gBAAgB,EAAE,MAAM,EACxB,gBAAgB,EAAE,SAAS,EAAE,EAC7B,SAAS,EAAE,UAAU,GACpB,OAAO,CAAC,qBAAqB,CAAC;IAmDjC,OAAO,CAAC,aAAa;YAgFP,aAAa;CAwB5B"}

package/dist/planner/replanning-engine.js

@@ -0,0 +1,130 @@
+/**
+ * @module planner/replanning-engine
+ * @description Proactive replanning engine — evaluates plan health mid-execution
+ * and triggers partial or full replanning when deviations are detected.
+ */
+// ─── ReplanningEngine ───
+export class ReplanningEngine {
+    planner;
+    planEvaluator;
+    riskEstimator;
+    milestoneChecker;
+    constructor(planner, planEvaluator, riskEstimator, milestoneChecker) {
+        this.planner = planner;
+        this.planEvaluator = planEvaluator;
+        this.riskEstimator = riskEstimator;
+        this.milestoneChecker = milestoneChecker;
+    }
+    async evaluate(plan, currentState, completedTaskIds, toolResults, tokensUsed, tokenBudget, changedFiles, currentIteration, activeMilestones, llmClient) {
+        const remainingTasks = plan.tactical.filter(t => !completedTaskIds.includes(t.id));
+        const completedTasks = plan.tactical.filter(t => completedTaskIds.includes(t.id));
+        // 1. Evaluate plan health
+        const health = this.planEvaluator.evaluate(plan, completedTaskIds, toolResults, tokensUsed, tokenBudget);
+        // 2. Estimate risk
+        const risk = await this.riskEstimator.estimate(currentState, remainingTasks, completedTasks, changedFiles, tokensUsed, tokenBudget);
+        // 3. Check milestones
+        const milestoneStatus = this.milestoneChecker.check(activeMilestones, completedTaskIds, currentIteration);
+        // 4. Decide whether to replan
+        const decision = this.shouldTrigger(health, risk, milestoneStatus);
+        if (!decision.shouldReplan) {
+            return { triggered: false, decision, message: "Plan on track" };
+        }
+        // 5. Execute replan
+        try {
+            const result = await this.executeReplan(plan, decision, currentState, llmClient);
+            const message = `Proactive replan triggered (${decision.scope}): ${decision.trigger}`;
+            return { triggered: true, decision, modifiedTasks: result, message };
+        }
+        catch (err) {
+            return {
+                triggered: false,
+                decision,
+                message: `Replan attempted but failed: ${String(err)}`,
+            };
+        }
+    }
+    shouldTrigger(health, risk, milestoneStatus) {
+        // Critical: abort conditions
+        if (health.recommendation === "abort") {
+            return {
+                shouldReplan: true,
+                scope: "strategic",
+                trigger: "Plan health critical",
+                urgency: "critical",
+                reasoning: `Health score ${health.score}/100, recommendation: abort`,
+            };
+        }
+        // High risk → strategic replan
+        if (risk.overall >= 85) {
+            return {
+                shouldReplan: true,
+                scope: "strategic",
+                trigger: `Risk score ${risk.overall}/100`,
+                urgency: "critical",
+                reasoning: risk.factors.join("; "),
+            };
+        }
+        // Medium-high risk → tactical replan
+        if (risk.overall >= 70) {
+            return {
+                shouldReplan: true,
+                scope: "tactical",
+                trigger: `Elevated risk: ${risk.overall}/100`,
+                urgency: "high",
+                reasoning: risk.factors.join("; "),
+            };
+        }
+        // Major health issues → major replan
+        if (health.recommendation === "replan_major") {
+            return {
+                shouldReplan: true,
+                scope: "tactical",
+                trigger: "Plan health deteriorated",
+                urgency: "high",
+                reasoning: health.deviations.map(d => d.description).join("; "),
+            };
+        }
+        // Milestone misses
+        if (milestoneStatus.consecutiveMisses >= 2) {
+            return {
+                shouldReplan: true,
+                scope: "tactical",
+                trigger: `${milestoneStatus.consecutiveMisses} consecutive milestone misses`,
+                urgency: "high",
+                reasoning: "Falling behind schedule",
+            };
+        }
+        // Minor issues → minor replan
+        if (health.recommendation === "replan_minor") {
+            return {
+                shouldReplan: true,
+                scope: "operational",
+                trigger: "Minor plan deviations",
+                urgency: "medium",
+                reasoning: health.deviations.map(d => d.description).join("; "),
+            };
+        }
+        return {
+            shouldReplan: false,
+            scope: "none",
+            trigger: "",
+            urgency: "low",
+            reasoning: "Plan healthy",
+        };
+    }
+    async executeReplan(plan, decision, _currentState, llmClient) {
+        const triggerType = decision.scope === "strategic" ? "strategic" : "error";
+        const severity = decision.urgency === "critical" ? "critical" :
+            decision.urgency === "high" ? "major" :
+                "minor";
+        const trigger = {
+            type: triggerType,
+            description: `[Proactive] ${decision.trigger}: ${decision.reasoning}`,
+            affectedTaskIds: [],
+            severity,
+        };
+        const result = await this.planner.replan(plan, trigger, llmClient);
+        return result.modifiedTasks;
+    }
+}
+//# sourceMappingURL=replanning-engine.js.map

package/dist/planner/replanning-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replanning-engine.js","sourceRoot":"","sources":["../../src/planner/replanning-engine.ts"],"names":[],"mappings":"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"}

package/dist/planner/risk-estimator.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @module planner/risk-estimator
+ * @description Estimates execution risk across multiple dimensions:
+ * build, test, scope, dependency, and token budget.
+ * Used by the autonomous planner to decide when to pause, re-plan, or alert.
+ */
+import type { ImpactAnalyzer } from "../impact-analyzer.js";
+import type { TransitionModel } from "../world-model/transition-model.js";
+import type { WorldState } from "../world-model/state-store.js";
+import type { TacticalTask } from "../hierarchical-planner.js";
+export interface RiskComponents {
+    buildRisk: number;
+    testRisk: number;
+    scopeRisk: number;
+    dependencyRisk: number;
+    tokenRisk: number;
+}
+export interface RiskScore {
+    overall: number;
+    components: RiskComponents;
+    factors: string[];
+    mitigations: string[];
+    level: "low" | "medium" | "high" | "critical";
+}
+export declare class RiskEstimator {
+    private transitionModel;
+    private impactAnalyzer;
+    constructor(transitionModel: TransitionModel, impactAnalyzer: ImpactAnalyzer);
+    /**
+     * Estimate overall risk given current world state, remaining tasks, and resource usage.
+     */
+    estimate(currentState: WorldState, remainingTasks: TacticalTask[], completedTasks: TacticalTask[], changedFiles: string[], tokensUsed: number, tokenBudget: number): Promise<RiskScore>;
+    /**
+     * Estimate risk for a single task given the current world state.
+     * Returns a 0-100 score.
+     */
+    estimateTaskRisk(task: TacticalTask, state: WorldState): Promise<number>;
+    /**
+     * Returns true if the risk score's overall value meets or exceeds the threshold.
+     * Default threshold is 70 ("high").
+     */
+    isHighRisk(score: RiskScore, threshold?: number): boolean;
+}
+//# sourceMappingURL=risk-estimator.d.ts.map

package/dist/planner/risk-estimator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"risk-estimator.d.ts","sourceRoot":"","sources":["../../src/planner/risk-estimator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAI/D,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,cAAc,CAAC;IAC3B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;CAC/C;AAID,qBAAa,aAAa;IAEtB,OAAO,CAAC,eAAe;IACvB,OAAO,CAAC,cAAc;gBADd,eAAe,EAAE,eAAe,EAChC,cAAc,EAAE,cAAc;IAGxC;;OAEG;IACG,QAAQ,CACZ,YAAY,EAAE,UAAU,EACxB,cAAc,EAAE,YAAY,EAAE,EAC9B,cAAc,EAAE,YAAY,EAAE,EAC9B,YAAY,EAAE,MAAM,EAAE,EACtB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,SAAS,CAAC;IA6ErB;;;OAGG;IACG,gBAAgB,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAmB9E;;;OAGG;IACH,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,SAAK,GAAG,OAAO;CAGtD"}