attocode 0.2.3 → 0.2.5

package/dist/src/core/agent-state-machine.js

@@ -0,0 +1,302 @@
+/**
+ * Phase 2.2: Agent State Machine
+ *
+ * Formalizes the phase tracking that previously lived in economics.ts into a
+ * proper state machine with typed transitions, event emission, and per-phase
+ * metrics. Testable independently of the economics system.
+ *
+ * Phases:
+ * - exploring: Reading files, searching code, understanding the problem
+ * - planning: Creating or editing a plan
+ * - acting: Writing/editing files, running commands
+ * - verifying: Running tests, checking results
+ *
+ * Valid transitions:
+ *   exploring → planning | acting
+ *   planning  → acting | exploring
+ *   acting    → verifying | exploring
+ *   verifying → acting | exploring
+ */
+// =============================================================================
+// VALID TRANSITIONS
+// =============================================================================
+/**
+ * Allowed phase transitions. Each phase lists the phases it can transition to.
+ * Invalid transitions are rejected with a warning.
+ */
+const VALID_TRANSITIONS = {
+    exploring: new Set(['planning', 'acting']),
+    planning: new Set(['acting', 'exploring']),
+    acting: new Set(['verifying', 'exploring']),
+    verifying: new Set(['acting', 'exploring']),
+};
+// =============================================================================
+// AGENT STATE MACHINE
+// =============================================================================
+export class AgentStateMachine {
+    currentPhase;
+    phaseEnteredAt;
+    phaseIterations = 0;
+    phaseToolCalls = 0;
+    listeners = [];
+    transitions = [];
+    // Per-phase tracking (mirrors economics PhaseState for backward compat)
+    uniqueFilesRead = new Set();
+    uniqueSearches = new Set();
+    filesModified = new Set();
+    testsRun = 0;
+    shouldTransition = false;
+    recentNewFiles = 0;
+    lastTestPassed = null;
+    consecutiveTestFailures = 0;
+    inTestFixCycle = false;
+    consecutiveBashFailures = 0;
+    // Accumulated metrics per phase (for history)
+    phaseHistory = [];
+    // Tuning thresholds
+    explorationFileThreshold;
+    explorationIterThreshold;
+    constructor(options) {
+        this.currentPhase = options?.initialPhase ?? 'exploring';
+        this.phaseEnteredAt = Date.now();
+        this.explorationFileThreshold = options?.explorationFileThreshold ?? 10;
+        this.explorationIterThreshold = options?.explorationIterThreshold ?? 5;
+    }
+    // ---------------------------------------------------------------------------
+    // PUBLIC API
+    // ---------------------------------------------------------------------------
+    /** Get the current phase */
+    getPhase() {
+        return this.currentPhase;
+    }
+    /** Get a snapshot of the current phase state (backward-compatible with economics) */
+    getPhaseSnapshot() {
+        return {
+            phase: this.currentPhase,
+            iterationsInPhase: this.phaseIterations,
+            uniqueFilesRead: new Set(this.uniqueFilesRead),
+            uniqueSearches: new Set(this.uniqueSearches),
+            filesModified: new Set(this.filesModified),
+            testsRun: this.testsRun,
+            shouldTransition: this.shouldTransition,
+            recentNewFiles: this.recentNewFiles,
+            lastTestPassed: this.lastTestPassed,
+            consecutiveTestFailures: this.consecutiveTestFailures,
+            inTestFixCycle: this.inTestFixCycle,
+            consecutiveBashFailures: this.consecutiveBashFailures,
+        };
+    }
+    /** Get metrics for the current phase */
+    getCurrentPhaseMetrics() {
+        return {
+            phase: this.currentPhase,
+            iterations: this.phaseIterations,
+            enteredAt: this.phaseEnteredAt,
+            duration: Date.now() - this.phaseEnteredAt,
+            filesRead: this.uniqueFilesRead.size,
+            filesModified: this.filesModified.size,
+            toolCalls: this.phaseToolCalls,
+        };
+    }
+    /** Get all phase transition history */
+    getTransitions() {
+        return this.transitions;
+    }
+    /** Get accumulated phase history */
+    getPhaseHistory() {
+        return this.phaseHistory;
+    }
+    /**
+     * Attempt a phase transition.
+     * Returns true if transition was valid and executed, false if rejected.
+     */
+    transition(to, reason) {
+        if (to === this.currentPhase)
+            return false;
+        const validTargets = VALID_TRANSITIONS[this.currentPhase];
+        if (!validTargets.has(to)) {
+            return false;
+        }
+        const fromMetrics = this.getCurrentPhaseMetrics();
+        fromMetrics.duration = Date.now() - this.phaseEnteredAt;
+        const transition = {
+            from: this.currentPhase,
+            to,
+            reason,
+            timestamp: Date.now(),
+            fromMetrics,
+        };
+        // Record history
+        this.phaseHistory.push({ ...fromMetrics });
+        this.transitions.push(transition);
+        // Reset phase-local counters
+        this.currentPhase = to;
+        this.phaseEnteredAt = Date.now();
+        this.phaseIterations = 0;
+        this.phaseToolCalls = 0;
+        this.recentNewFiles = 0;
+        this.shouldTransition = false;
+        // Emit event
+        this.emit({ type: 'phase.changed', transition });
+        return true;
+    }
+    /**
+     * Record a tool call and update phase state.
+     * This is the primary input signal for the state machine.
+     */
+    recordToolCall(toolName, args, result) {
+        this.phaseIterations++;
+        this.phaseToolCalls++;
+        // Reset recentNewFiles counter every 3 iterations
+        if (this.phaseIterations % 3 === 0) {
+            this.recentNewFiles = 0;
+        }
+        // Track file reads
+        if (toolName === 'read_file' && args.path) {
+            const path = String(args.path);
+            const isNew = !this.uniqueFilesRead.has(path);
+            this.uniqueFilesRead.add(path);
+            if (isNew)
+                this.recentNewFiles++;
+        }
+        // Track searches
+        if (['grep', 'search', 'glob', 'find_files', 'search_files'].includes(toolName)) {
+            const query = String(args.pattern || args.query || args.path || '');
+            this.uniqueSearches.add(query);
+        }
+        // Track file modifications → auto-transition to acting
+        if (['write_file', 'edit_file'].includes(toolName) && args.path) {
+            this.filesModified.add(String(args.path));
+            if (this.currentPhase === 'exploring' || this.currentPhase === 'planning') {
+                this.transition('acting', 'First file edit made');
+            }
+        }
+        // Track bash commands
+        if (toolName === 'bash' && args.command) {
+            const command = String(args.command);
+            const bashResult = extractBashSuccess(result);
+            // Track consecutive bash failures
+            if (result !== undefined) {
+                if (!bashResult) {
+                    this.consecutiveBashFailures++;
+                }
+                else {
+                    this.consecutiveBashFailures = 0;
+                }
+            }
+            // Detect test runs
+            if (isTestCommand(command)) {
+                this.testsRun++;
+                // Auto-transition to verifying when tests run after edits
+                if (this.currentPhase === 'acting' && this.filesModified.size > 0) {
+                    this.transition('verifying', 'Tests run after edits');
+                }
+                // Track test outcomes
+                if (result !== undefined) {
+                    if (bashResult) {
+                        this.lastTestPassed = true;
+                        this.consecutiveTestFailures = 0;
+                        this.inTestFixCycle = false;
+                    }
+                    else {
+                        this.lastTestPassed = false;
+                        this.consecutiveTestFailures++;
+                        // Enter test-fix cycle after 2+ failures
+                        if (this.consecutiveTestFailures >= 2) {
+                            this.inTestFixCycle = true;
+                            // Go back to acting to fix
+                            if (this.currentPhase === 'verifying') {
+                                this.transition('acting', `Test failed ${this.consecutiveTestFailures} times, fixing`);
+                            }
+                        }
+                    }
+                }
+            }
+        }
+        // Check exploration saturation
+        this.checkExplorationSaturation();
+    }
+    /** Subscribe to state machine events */
+    subscribe(listener) {
+        this.listeners.push(listener);
+        return () => {
+            const idx = this.listeners.indexOf(listener);
+            if (idx >= 0)
+                this.listeners.splice(idx, 1);
+        };
+    }
+    /** Reset state machine to initial state */
+    reset(phase) {
+        this.currentPhase = phase ?? 'exploring';
+        this.phaseEnteredAt = Date.now();
+        this.phaseIterations = 0;
+        this.phaseToolCalls = 0;
+        this.uniqueFilesRead.clear();
+        this.uniqueSearches.clear();
+        this.filesModified.clear();
+        this.testsRun = 0;
+        this.shouldTransition = false;
+        this.recentNewFiles = 0;
+        this.lastTestPassed = null;
+        this.consecutiveTestFailures = 0;
+        this.inTestFixCycle = false;
+        this.consecutiveBashFailures = 0;
+        this.transitions = [];
+        this.phaseHistory = [];
+    }
+    // ---------------------------------------------------------------------------
+    // PRIVATE
+    // ---------------------------------------------------------------------------
+    /** Check for exploration saturation (too many reads without action) */
+    checkExplorationSaturation() {
+        if (this.currentPhase !== 'exploring') {
+            this.shouldTransition = false;
+            return;
+        }
+        // After N+ unique files without edits
+        if (this.uniqueFilesRead.size >= this.explorationFileThreshold && this.filesModified.size === 0) {
+            this.shouldTransition = true;
+            return;
+        }
+        // After N+ iterations with diminishing returns
+        if (this.phaseIterations >= this.explorationIterThreshold && this.recentNewFiles < 2 && this.filesModified.size === 0) {
+            this.shouldTransition = true;
+            return;
+        }
+        this.shouldTransition = false;
+    }
+    emit(event) {
+        for (const listener of this.listeners) {
+            try {
+                listener(event);
+            }
+            catch {
+                // Don't let listener errors break the state machine
+            }
+        }
+    }
+}
+// =============================================================================
+// HELPERS
+// =============================================================================
+/** Check if a bash command is a test command */
+function isTestCommand(command) {
+    return (command.includes('test') ||
+        command.includes('pytest') ||
+        command.includes('npm test') ||
+        command.includes('jest'));
+}
+/** Extract success from a bash result (object or string) */
+function extractBashSuccess(result) {
+    if (result && typeof result === 'object') {
+        return result.success !== false;
+    }
+    return true; // strings and undefined are treated as success
+}
+// =============================================================================
+// FACTORY
+// =============================================================================
+export function createAgentStateMachine(options) {
+    return new AgentStateMachine(options);
+}
+//# sourceMappingURL=agent-state-machine.js.map

package/dist/src/core/agent-state-machine.js.map

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

package/dist/src/core/base-manager.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Phase 2.3: Base Manager Pattern
+ *
+ * Provides a common base class for managers with consistent lifecycle
+ * (init/cleanup/reset), event emission, and subscription management.
+ *
+ * Usage:
+ * ```ts
+ * interface MyEvent { type: 'my.event'; data: string }
+ *
+ * class MyManager extends BaseManager<MyEvent> {
+ *   protected managerName = 'MyManager';
+ *
+ *   async onInit(): Promise<void> { ... }
+ *   async onCleanup(): Promise<void> { ... }
+ *   onReset(): void { ... }
+ * }
+ * ```
+ */
+/** Standard lifecycle states for managers */
+export type ManagerState = 'created' | 'initializing' | 'ready' | 'cleaning_up' | 'disposed';
+/** Base event type — all manager events must have a `type` field */
+export interface BaseEvent {
+    type: string;
+}
+/** Lifecycle events emitted by all managers */
+export interface ManagerLifecycleEvent extends BaseEvent {
+    type: 'manager.initialized' | 'manager.cleanup' | 'manager.reset' | 'manager.error';
+    manager: string;
+    error?: string;
+}
+export declare abstract class BaseManager<TEvent extends BaseEvent = BaseEvent> {
+    /** Name for logging and events */
+    protected abstract readonly managerName: string;
+    private _state;
+    private _listeners;
+    private _unsubscribers;
+    private _initPromise;
+    /** Current lifecycle state */
+    get state(): ManagerState;
+    /** Whether the manager is ready to use */
+    get isReady(): boolean;
+    /**
+     * Initialize the manager. Idempotent — calling multiple times returns the
+     * same promise. Override `onInit()` for custom initialization.
+     */
+    init(): Promise<void>;
+    /**
+     * Clean up resources. Override `onCleanup()` for custom cleanup.
+     * Automatically unsubscribes all tracked subscriptions.
+     */
+    cleanup(): Promise<void>;
+    /**
+     * Reset manager to initial state without disposing.
+     * Override `onReset()` for custom reset logic.
+     */
+    reset(): void;
+    /**
+     * Subscribe to manager events.
+     * Returns an unsubscribe function.
+     */
+    subscribe(listener: (event: TEvent | ManagerLifecycleEvent) => void): () => void;
+    /**
+     * Track an external unsubscription function.
+     * All tracked subscriptions are cleaned up on `cleanup()`.
+     */
+    protected trackSubscription(unsub: () => void): void;
+    /** Emit a typed event to all listeners */
+    protected emit(event: TEvent): void;
+    /** Called during init(). Override for custom initialization. */
+    protected onInit(): Promise<void>;
+    /** Called during cleanup(). Override for custom resource release. */
+    protected onCleanup(): Promise<void>;
+    /** Called during reset(). Override to clear state without disposing. */
+    protected onReset(): void;
+    private _doInit;
+    private emitLifecycle;
+}
+//# sourceMappingURL=base-manager.d.ts.map

package/dist/src/core/base-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-manager.d.ts","sourceRoot":"","sources":["../../../src/core/base-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAMH,6CAA6C;AAC7C,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,cAAc,GAAG,OAAO,GAAG,aAAa,GAAG,UAAU,CAAC;AAE7F,oEAAoE;AACpE,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,+CAA+C;AAC/C,MAAM,WAAW,qBAAsB,SAAQ,SAAS;IACtD,IAAI,EAAE,qBAAqB,GAAG,iBAAiB,GAAG,eAAe,GAAG,eAAe,CAAC;IACpF,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAMD,8BAAsB,WAAW,CAAC,MAAM,SAAS,SAAS,GAAG,SAAS;IACpE,kCAAkC;IAClC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAEhD,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,UAAU,CAA8D;IAChF,OAAO,CAAC,cAAc,CAAyB;IAC/C,OAAO,CAAC,YAAY,CAA8B;IAMlD,8BAA8B;IAC9B,IAAI,KAAK,IAAI,YAAY,CAExB;IAED,0CAA0C;IAC1C,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAS3B;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA2B9B;;;OAGG;IACH,KAAK,IAAI,IAAI;IAWb;;;OAGG;IACH,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,qBAAqB,KAAK,IAAI,GAAG,MAAM,IAAI;IAShF;;;OAGG;IACH,SAAS,CAAC,iBAAiB,CAAC,KAAK,EAAE,MAAM,IAAI,GAAG,IAAI;IAIpD,0CAA0C;IAC1C,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAcnC,gEAAgE;cAChD,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAIvC,qEAAqE;cACrD,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAI1C,wEAAwE;IACxE,SAAS,CAAC,OAAO,IAAI,IAAI;YAQX,OAAO;IAarB,OAAO,CAAC,aAAa;CAWtB"}

package/dist/src/core/base-manager.js

@@ -0,0 +1,170 @@
+/**
+ * Phase 2.3: Base Manager Pattern
+ *
+ * Provides a common base class for managers with consistent lifecycle
+ * (init/cleanup/reset), event emission, and subscription management.
+ *
+ * Usage:
+ * ```ts
+ * interface MyEvent { type: 'my.event'; data: string }
+ *
+ * class MyManager extends BaseManager<MyEvent> {
+ *   protected managerName = 'MyManager';
+ *
+ *   async onInit(): Promise<void> { ... }
+ *   async onCleanup(): Promise<void> { ... }
+ *   onReset(): void { ... }
+ * }
+ * ```
+ */
+// =============================================================================
+// BASE MANAGER
+// =============================================================================
+export class BaseManager {
+    _state = 'created';
+    _listeners = [];
+    _unsubscribers = [];
+    _initPromise = null;
+    // ---------------------------------------------------------------------------
+    // LIFECYCLE
+    // ---------------------------------------------------------------------------
+    /** Current lifecycle state */
+    get state() {
+        return this._state;
+    }
+    /** Whether the manager is ready to use */
+    get isReady() {
+        return this._state === 'ready';
+    }
+    /**
+     * Initialize the manager. Idempotent — calling multiple times returns the
+     * same promise. Override `onInit()` for custom initialization.
+     */
+    async init() {
+        if (this._state === 'ready')
+            return;
+        if (this._initPromise)
+            return this._initPromise;
+        this._state = 'initializing';
+        this._initPromise = this._doInit();
+        return this._initPromise;
+    }
+    /**
+     * Clean up resources. Override `onCleanup()` for custom cleanup.
+     * Automatically unsubscribes all tracked subscriptions.
+     */
+    async cleanup() {
+        if (this._state === 'disposed')
+            return;
+        this._state = 'cleaning_up';
+        // Unsubscribe all tracked subscriptions
+        for (const unsub of this._unsubscribers) {
+            try {
+                unsub();
+            }
+            catch {
+                // Ignore errors during cleanup
+            }
+        }
+        this._unsubscribers = [];
+        try {
+            await this.onCleanup();
+        }
+        catch (err) {
+            this.emitLifecycle('manager.error', String(err));
+        }
+        this._state = 'disposed';
+        this._initPromise = null;
+        this.emitLifecycle('manager.cleanup');
+        this._listeners = [];
+    }
+    /**
+     * Reset manager to initial state without disposing.
+     * Override `onReset()` for custom reset logic.
+     */
+    reset() {
+        this.onReset();
+        this._state = 'ready';
+        this._initPromise = null;
+        this.emitLifecycle('manager.reset');
+    }
+    // ---------------------------------------------------------------------------
+    // EVENT SYSTEM
+    // ---------------------------------------------------------------------------
+    /**
+     * Subscribe to manager events.
+     * Returns an unsubscribe function.
+     */
+    subscribe(listener) {
+        this._listeners.push(listener);
+        const unsub = () => {
+            const idx = this._listeners.indexOf(listener);
+            if (idx >= 0)
+                this._listeners.splice(idx, 1);
+        };
+        return unsub;
+    }
+    /**
+     * Track an external unsubscription function.
+     * All tracked subscriptions are cleaned up on `cleanup()`.
+     */
+    trackSubscription(unsub) {
+        this._unsubscribers.push(unsub);
+    }
+    /** Emit a typed event to all listeners */
+    emit(event) {
+        for (const listener of this._listeners) {
+            try {
+                listener(event);
+            }
+            catch {
+                // Don't let listener errors break the manager
+            }
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // HOOKS (override in subclasses)
+    // ---------------------------------------------------------------------------
+    /** Called during init(). Override for custom initialization. */
+    async onInit() {
+        // Default: no-op
+    }
+    /** Called during cleanup(). Override for custom resource release. */
+    async onCleanup() {
+        // Default: no-op
+    }
+    /** Called during reset(). Override to clear state without disposing. */
+    onReset() {
+        // Default: no-op
+    }
+    // ---------------------------------------------------------------------------
+    // PRIVATE
+    // ---------------------------------------------------------------------------
+    async _doInit() {
+        try {
+            await this.onInit();
+            this._state = 'ready';
+            this.emitLifecycle('manager.initialized');
+        }
+        catch (err) {
+            this._state = 'created';
+            this._initPromise = null;
+            this.emitLifecycle('manager.error', String(err));
+            throw err;
+        }
+    }
+    emitLifecycle(type, error) {
+        const event = { type, manager: this.managerName };
+        if (error)
+            event.error = error;
+        for (const listener of this._listeners) {
+            try {
+                listener(event);
+            }
+            catch {
+                // Ignore
+            }
+        }
+    }
+}
+//# sourceMappingURL=base-manager.js.map

package/dist/src/core/base-manager.js.map

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

package/dist/src/core/completion-analyzer.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Completion Analyzer
+ *
+ * Shared logic for identifying responses that describe future intent
+ * ("I'll do X") instead of completed work. This must stay centralized so
+ * execution-loop and final run guardrails classify consistently.
+ */
+export interface CompletionIntentAnalysis {
+    isIncompleteAction: boolean;
+    reason: 'none' | 'future_intent' | 'failure_admission' | 'narrative_action';
+    confidence: number;
+}
+export declare function analyzeCompletionIntent(content: string): CompletionIntentAnalysis;
+export declare function detectIncompleteActionResponse(content: string): boolean;
+//# sourceMappingURL=completion-analyzer.d.ts.map

package/dist/src/core/completion-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion-analyzer.d.ts","sourceRoot":"","sources":["../../../src/core/completion-analyzer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,wBAAwB;IACvC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,MAAM,EAAE,MAAM,GAAG,eAAe,GAAG,mBAAmB,GAAG,kBAAkB,CAAC;IAC5E,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,wBAAwB,CA+CjF;AAED,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEvE"}

package/dist/src/core/completion-analyzer.js

@@ -0,0 +1,53 @@
+/**
+ * Completion Analyzer
+ *
+ * Shared logic for identifying responses that describe future intent
+ * ("I'll do X") instead of completed work. This must stay centralized so
+ * execution-loop and final run guardrails classify consistently.
+ */
+export function analyzeCompletionIntent(content) {
+    const trimmed = content.trim();
+    if (!trimmed) {
+        return { isIncompleteAction: false, reason: 'none', confidence: 0 };
+    }
+    const lower = trimmed.toLowerCase();
+    // Positive completion signals should override weaker future-intent cues.
+    const completionSignals = /\b(done|completed|finished|here is the (final|complete)|created successfully|saved|wrote|all (changes|tasks) (are )?complete)\b/;
+    if (completionSignals.test(lower)) {
+        return { isIncompleteAction: false, reason: 'none', confidence: 0.9 };
+    }
+    const futureIntentPatterns = [
+        /\b(i\s+will|i'll|let me)\s+(create|write|save|update|modify|fix|add|edit|implement|change|run|execute|build|set up|start)\b/,
+        /\b(i\s+need to|i\s+should|i\s+can)\s+(create|write|update|modify|fix|add|edit|implement)\b/,
+        /\b(the next step|first[, ]+i|now i)\b/,
+        /\b(i am going to|i'm going to)\b/,
+    ];
+    if (futureIntentPatterns.some(pattern => pattern.test(lower))) {
+        return { isIncompleteAction: true, reason: 'future_intent', confidence: 0.95 };
+    }
+    const failureAdmissionPatterns = [
+        /\bran out of budget\b/,
+        /\bbudget exhausted\b/,
+        /\bunable to complete\b/,
+        /\bcould not complete\b/,
+        /\bno changes were made\b/,
+        /\bno files were modified\b/,
+    ];
+    if (failureAdmissionPatterns.some(pattern => pattern.test(lower))) {
+        return { isIncompleteAction: true, reason: 'failure_admission', confidence: 0.9 };
+    }
+    // Heuristic: short narrative about "changing code" with no artifact.
+    const hasCodeBlock = /```/.test(trimmed);
+    const mentionsCodeConcepts = /\b(file|function|class|module|component|import|export|variable|method)\b/i.test(trimmed);
+    if (!hasCodeBlock && mentionsCodeConcepts && trimmed.length < 600) {
+        const actionWords = /\b(update|modify|create|add|change|fix|implement|refactor|write|edit)\b/i;
+        if (actionWords.test(lower)) {
+            return { isIncompleteAction: true, reason: 'narrative_action', confidence: 0.65 };
+        }
+    }
+    return { isIncompleteAction: false, reason: 'none', confidence: 0.3 };
+}
+export function detectIncompleteActionResponse(content) {
+    return analyzeCompletionIntent(content).isIncompleteAction;
+}
+//# sourceMappingURL=completion-analyzer.js.map

package/dist/src/core/completion-analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion-analyzer.js","sourceRoot":"","sources":["../../../src/core/completion-analyzer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,MAAM,UAAU,uBAAuB,CAAC,OAAe;IACrD,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAC/B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,kBAAkB,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;IACtE,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAEpC,yEAAyE;IACzE,MAAM,iBAAiB,GAAG,iIAAiI,CAAC;IAC5J,IAAI,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAClC,OAAO,EAAE,kBAAkB,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC;IACxE,CAAC;IAED,MAAM,oBAAoB,GAAa;QACrC,6HAA6H;QAC7H,4FAA4F;QAC5F,uCAAuC;QACvC,kCAAkC;KACnC,CAAC;IACF,IAAI,oBAAoB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QAC9D,OAAO,EAAE,kBAAkB,EAAE,IAAI,EAAE,MAAM,EAAE,eAAe,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;IACjF,CAAC;IAED,MAAM,wBAAwB,GAAa;QACzC,uBAAuB;QACvB,sBAAsB;QACtB,wBAAwB;QACxB,wBAAwB;QACxB,0BAA0B;QAC1B,4BAA4B;KAC7B,CAAC;IACF,IAAI,wBAAwB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QAClE,OAAO,EAAE,kBAAkB,EAAE,IAAI,EAAE,MAAM,EAAE,mBAAmB,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC;IACpF,CAAC;IAED,qEAAqE;IACrE,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzC,MAAM,oBAAoB,GAAG,2EAA2E,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACvH,IAAI,CAAC,YAAY,IAAI,oBAAoB,IAAI,OAAO,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;QAClE,MAAM,WAAW,GAAG,0EAA0E,CAAC;QAC/F,IAAI,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5B,OAAO,EAAE,kBAAkB,EAAE,IAAI,EAAE,MAAM,EAAE,kBAAkB,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;QACpF,CAAC;IACH,CAAC;IAED,OAAO,EAAE,kBAAkB,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,OAAe;IAC5D,OAAO,uBAAuB,CAAC,OAAO,CAAC,CAAC,kBAAkB,CAAC;AAC7D,CAAC"}