@promptwheel/cli 0.6.0

package/dist/lib/spindle/failure-patterns.js

@@ -0,0 +1,22 @@
+/**
+ * Spindle — Failure pattern detectors (command failures, QA ping-pong, file edits)
+ *
+ * Merged from command-failure.ts, qa-ping-pong.ts, and file-edits.ts.
+ * Core detection algorithms live in @promptwheel/core; this module
+ * re-exports them and adds CLI-specific state helpers.
+ */
+import { shortHash, detectQaPingPong, detectCommandFailure, extractFilesFromDiff, getFileEditWarnings as _getFileEditWarnings, } from '@promptwheel/core/spindle/shared';
+// Re-export shared detectors for consumers
+export { shortHash, detectQaPingPong, detectCommandFailure, extractFilesFromDiff };
+/** Get file edit frequency warnings from CLI SpindleState */
+export function getFileEditWarnings(state, threshold = 3) {
+    return _getFileEditWarnings(state.fileEditCounts, threshold);
+}
+/** Record a failing command for spindle tracking */
+export function recordCommandFailure(state, command, error) {
+    const sig = shortHash(`${command}::${error.slice(0, 200)}`);
+    state.failingCommandSignatures.push(sig);
+    if (state.failingCommandSignatures.length > 20)
+        state.failingCommandSignatures.shift();
+}
+//# sourceMappingURL=failure-patterns.js.map

package/dist/lib/spindle/failure-patterns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-patterns.js","sourceRoot":"","sources":["../../../src/lib/spindle/failure-patterns.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,IAAI,oBAAoB,GAC5C,MAAM,kCAAkC,CAAC;AAE1C,2CAA2C;AAC3C,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,CAAC;AAEnF,6DAA6D;AAC7D,MAAM,UAAU,mBAAmB,CAAC,KAAmB,EAAE,YAAoB,CAAC;IAC5E,OAAO,oBAAoB,CAAC,KAAK,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;AAC/D,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,oBAAoB,CAAC,KAAmB,EAAE,OAAe,EAAE,KAAa;IACtF,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,OAAO,KAAK,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IAC5D,KAAK,CAAC,wBAAwB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzC,IAAI,KAAK,CAAC,wBAAwB,CAAC,MAAM,GAAG,EAAE;QAAE,KAAK,CAAC,wBAAwB,CAAC,KAAK,EAAE,CAAC;AACzF,CAAC"}

package/dist/lib/spindle/format.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Spindle — Result formatting
+ */
+import type { SpindleResult } from './types.js';
+/**
+ * Format Spindle result for display
+ */
+export declare function formatSpindleResult(result: SpindleResult): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/lib/spindle/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../src/lib/spindle/format.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAgCjE"}

package/dist/lib/spindle/format.js

@@ -0,0 +1,37 @@
+/**
+ * Spindle — Result formatting
+ */
+/**
+ * Format Spindle result for display
+ */
+export function formatSpindleResult(result) {
+    if (!result.shouldAbort && !result.shouldBlock) {
+        return 'No spindle loop detected';
+    }
+    const label = result.shouldBlock ? 'Spindle blocked (needs human)' : 'Spindle loop detected';
+    const parts = [`${label}: ${result.reason}`];
+    parts.push(`Confidence: ${(result.confidence * 100).toFixed(0)}%`);
+    if (result.diagnostics.estimatedTokens) {
+        parts.push(`Tokens: ~${result.diagnostics.estimatedTokens}`);
+    }
+    if (result.diagnostics.iterationsWithoutChange) {
+        parts.push(`Iterations without change: ${result.diagnostics.iterationsWithoutChange}`);
+    }
+    if (result.diagnostics.oscillationPattern) {
+        parts.push(`Pattern: ${result.diagnostics.oscillationPattern}`);
+    }
+    if (result.diagnostics.repeatedPatterns?.length) {
+        parts.push(`Repeated: ${result.diagnostics.repeatedPatterns.join(', ')}`);
+    }
+    if (result.diagnostics.pingPongPattern) {
+        parts.push(`Pattern: ${result.diagnostics.pingPongPattern}`);
+    }
+    if (result.diagnostics.commandSignature) {
+        parts.push(`Command signature: ${result.diagnostics.commandSignature}`);
+    }
+    if (result.diagnostics.fileEditWarnings?.length) {
+        parts.push(`File churn: ${result.diagnostics.fileEditWarnings.join(', ')}`);
+    }
+    return parts.join('\n');
+}
+//# sourceMappingURL=format.js.map

package/dist/lib/spindle/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../../src/lib/spindle/format.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAqB;IACvD,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;QAC/C,OAAO,0BAA0B,CAAC;IACpC,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,+BAA+B,CAAC,CAAC,CAAC,uBAAuB,CAAC;IAC7F,MAAM,KAAK,GAAG,CAAC,GAAG,KAAK,KAAK,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7C,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAEnE,IAAI,MAAM,CAAC,WAAW,CAAC,eAAe,EAAE,CAAC;QACvC,KAAK,CAAC,IAAI,CAAC,YAAY,MAAM,CAAC,WAAW,CAAC,eAAe,EAAE,CAAC,CAAC;IAC/D,CAAC;IACD,IAAI,MAAM,CAAC,WAAW,CAAC,uBAAuB,EAAE,CAAC;QAC/C,KAAK,CAAC,IAAI,CAAC,8BAA8B,MAAM,CAAC,WAAW,CAAC,uBAAuB,EAAE,CAAC,CAAC;IACzF,CAAC;IACD,IAAI,MAAM,CAAC,WAAW,CAAC,kBAAkB,EAAE,CAAC;QAC1C,KAAK,CAAC,IAAI,CAAC,YAAY,MAAM,CAAC,WAAW,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAClE,CAAC;IACD,IAAI,MAAM,CAAC,WAAW,CAAC,gBAAgB,EAAE,MAAM,EAAE,CAAC;QAChD,KAAK,CAAC,IAAI,CAAC,aAAa,MAAM,CAAC,WAAW,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5E,CAAC;IACD,IAAI,MAAM,CAAC,WAAW,CAAC,eAAe,EAAE,CAAC;QACvC,KAAK,CAAC,IAAI,CAAC,YAAY,MAAM,CAAC,WAAW,CAAC,eAAe,EAAE,CAAC,CAAC;IAC/D,CAAC;IACD,IAAI,MAAM,CAAC,WAAW,CAAC,gBAAgB,EAAE,CAAC;QACxC,KAAK,CAAC,IAAI,CAAC,sBAAsB,MAAM,CAAC,WAAW,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAC1E,CAAC;IACD,IAAI,MAAM,CAAC,WAAW,CAAC,gBAAgB,EAAE,MAAM,EAAE,CAAC;QAChD,KAAK,CAAC,IAAI,CAAC,eAAe,MAAM,CAAC,WAAW,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC9E,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/lib/spindle/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Spindle Loop Detection
+ *
+ * Monitors agent execution for unproductive patterns:
+ * - Oscillation: Similar diffs being applied and reverted
+ * - Spinning: High tool call rate without progress
+ * - Stalling: Verbose output without meaningful changes
+ * - Repetition: Same errors or phrases repeated
+ *
+ * Named "Spindle" after the spinning wheel component — when the spindle
+ * jams, it spins without producing thread.
+ */
+export type { SpindleConfig, SpindleState, SpindleResult } from './types.js';
+export { DEFAULT_SPINDLE_CONFIG, createSpindleState, estimateTokens } from './types.js';
+export { computeSimilarity } from './similarity.js';
+export { detectOscillation } from './oscillation.js';
+export { detectRepetition } from './repetition.js';
+export { detectQaPingPong, detectCommandFailure, recordCommandFailure, shortHash, extractFilesFromDiff, getFileEditWarnings } from './failure-patterns.js';
+export { formatSpindleResult } from './format.js';
+import type { SpindleConfig, SpindleState, SpindleResult } from './types.js';
+/**
+ * Check if agent is in a Spindle loop
+ *
+ * Updates state in-place and returns detection result.
+ *
+ * @param state - Current Spindle state (will be mutated)
+ * @param latestOutput - Agent's latest output text
+ * @param latestDiff - Latest git diff (null if no changes)
+ * @param config - Spindle configuration
+ * @returns Detection result
+ */
+export declare function checkSpindleLoop(state: SpindleState, latestOutput: string, latestDiff: string | null, config: SpindleConfig): SpindleResult;
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/spindle/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/spindle/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACxF,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,SAAS,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC3J,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAO7E;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,YAAY,EACnB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,MAAM,EAAE,aAAa,GACpB,aAAa,CAwMf"}

package/dist/lib/spindle/index.js

@@ -0,0 +1,231 @@
+/**
+ * Spindle Loop Detection
+ *
+ * Monitors agent execution for unproductive patterns:
+ * - Oscillation: Similar diffs being applied and reverted
+ * - Spinning: High tool call rate without progress
+ * - Stalling: Verbose output without meaningful changes
+ * - Repetition: Same errors or phrases repeated
+ *
+ * Named "Spindle" after the spinning wheel component — when the spindle
+ * jams, it spins without producing thread.
+ */
+export { DEFAULT_SPINDLE_CONFIG, createSpindleState, estimateTokens } from './types.js';
+export { computeSimilarity } from './similarity.js';
+export { detectOscillation } from './oscillation.js';
+export { detectRepetition } from './repetition.js';
+export { detectQaPingPong, detectCommandFailure, recordCommandFailure, shortHash, extractFilesFromDiff, getFileEditWarnings } from './failure-patterns.js';
+export { formatSpindleResult } from './format.js';
+import { estimateTokens } from './types.js';
+import { detectOscillation } from './oscillation.js';
+import { detectRepetition } from './repetition.js';
+import { detectQaPingPong, detectCommandFailure, extractFilesFromDiff, getFileEditWarnings } from './failure-patterns.js';
+import { metric } from '../metrics.js';
+/**
+ * Check if agent is in a Spindle loop
+ *
+ * Updates state in-place and returns detection result.
+ *
+ * @param state - Current Spindle state (will be mutated)
+ * @param latestOutput - Agent's latest output text
+ * @param latestDiff - Latest git diff (null if no changes)
+ * @param config - Spindle configuration
+ * @returns Detection result
+ */
+export function checkSpindleLoop(state, latestOutput, latestDiff, config) {
+    // If disabled, always pass
+    if (!config.enabled) {
+        return { shouldAbort: false, shouldBlock: false, confidence: 0, diagnostics: {} };
+    }
+    // Update state with latest data
+    const outputTokens = estimateTokens(latestOutput);
+    const diffTokens = estimateTokens(latestDiff ?? '');
+    state.estimatedTokens += outputTokens + diffTokens;
+    state.totalOutputChars += latestOutput.length;
+    state.totalChangeChars += (latestDiff ?? '').length;
+    // Store for pattern detection (keep last N)
+    state.outputs.push(latestOutput);
+    if (state.outputs.length > config.maxSimilarOutputs + 1) {
+        state.outputs.shift();
+    }
+    if (latestDiff) {
+        state.diffs.push(latestDiff);
+        if (state.diffs.length > 5) {
+            state.diffs.shift();
+        }
+        // Track per-file edit frequency
+        const editedFiles = extractFilesFromDiff(latestDiff);
+        for (const f of editedFiles) {
+            state.fileEditCounts[f] = (state.fileEditCounts[f] ?? 0) + 1;
+        }
+        // Cap file_edit_counts keys to prevent unbounded growth
+        const MAX_FILE_EDIT_KEYS = 200;
+        const editKeys = Object.keys(state.fileEditCounts);
+        if (editKeys.length > MAX_FILE_EDIT_KEYS) {
+            const sorted = Object.entries(state.fileEditCounts)
+                .sort((a, b) => b[1] - a[1])
+                .slice(0, MAX_FILE_EDIT_KEYS);
+            state.fileEditCounts = Object.fromEntries(sorted);
+        }
+    }
+    // Track iterations without changes
+    if (!latestDiff || latestDiff.trim() === '') {
+        state.iterationsSinceChange++;
+    }
+    else {
+        state.iterationsSinceChange = 0;
+        state.lastProgressAt = Date.now();
+    }
+    // Check 1: Token budget
+    if (state.estimatedTokens >= config.tokenBudgetAbort) {
+        return triggerSpindle({
+            shouldAbort: true,
+            shouldBlock: false,
+            reason: 'token_budget',
+            confidence: 1.0,
+            diagnostics: {
+                estimatedTokens: state.estimatedTokens,
+            },
+        });
+    }
+    // Token budget warning (don't abort, just warn)
+    if (state.estimatedTokens >= config.tokenBudgetWarning) {
+        const warning = `Approaching token budget: ~${state.estimatedTokens} tokens`;
+        if (!state.warnings.includes(warning)) {
+            state.warnings.push(warning);
+        }
+    }
+    // Check 2: Stalling (no changes for too many iterations)
+    if (state.iterationsSinceChange >= config.maxStallIterations) {
+        return triggerSpindle({
+            shouldAbort: true,
+            shouldBlock: false,
+            reason: 'stalling',
+            confidence: 0.9,
+            diagnostics: {
+                iterationsWithoutChange: state.iterationsSinceChange,
+            },
+        });
+    }
+    // Check 2b: Time-based stall (wall-clock)
+    if (config.maxStallMinutes > 0) {
+        const minutesSinceProgress = (Date.now() - state.lastProgressAt) / 60_000;
+        if (minutesSinceProgress >= config.maxStallMinutes) {
+            return triggerSpindle({
+                shouldAbort: true,
+                shouldBlock: false,
+                reason: 'time_stall',
+                confidence: 0.95,
+                diagnostics: {
+                    minutesSinceProgress: Math.round(minutesSinceProgress),
+                    maxStallMinutes: config.maxStallMinutes,
+                },
+            });
+        }
+    }
+    // Check 3: Oscillation in diffs
+    if (state.diffs.length >= 2) {
+        const oscillation = detectOscillation(state.diffs, config.similarityThreshold);
+        if (oscillation.detected) {
+            return triggerSpindle({
+                shouldAbort: true,
+                shouldBlock: false,
+                reason: 'oscillation',
+                confidence: oscillation.confidence,
+                diagnostics: {
+                    oscillationPattern: oscillation.pattern,
+                },
+            });
+        }
+    }
+    // Check 4: Repetition in outputs
+    if (state.outputs.length >= 2) {
+        const repetition = detectRepetition(state.outputs.slice(0, -1), latestOutput, config);
+        if (repetition.detected) {
+            return triggerSpindle({
+                shouldAbort: true,
+                shouldBlock: false,
+                reason: 'repetition',
+                confidence: repetition.confidence,
+                diagnostics: {
+                    repeatedPatterns: repetition.patterns,
+                    similarityScore: repetition.confidence,
+                },
+            });
+        }
+    }
+    // Check 5: Verbosity ratio (lots of output, few changes)
+    if (state.totalOutputChars > 5000 && state.totalChangeChars > 0) {
+        const verbosityRatio = state.totalOutputChars / state.totalChangeChars;
+        if (verbosityRatio >= config.verbosityThreshold) {
+            // Only warn, don't abort on verbosity alone
+            const warning = `High verbosity ratio: ${verbosityRatio.toFixed(1)}x output vs changes`;
+            if (!state.warnings.includes(warning)) {
+                state.warnings.push(warning);
+            }
+        }
+    }
+    // Check 6: QA ping-pong — alternating failure signatures
+    if (state.failingCommandSignatures.length >= config.maxQaPingPong * 2) {
+        const pp = detectQaPingPong(state.failingCommandSignatures, config.maxQaPingPong);
+        if (pp) {
+            return triggerSpindle({
+                shouldAbort: true,
+                shouldBlock: false,
+                reason: 'qa_ping_pong',
+                confidence: 0.9,
+                diagnostics: { pingPongPattern: pp },
+            });
+        }
+    }
+    // Check 7: Command signature — same command fails N times → block (needs human)
+    const cmdFail = detectCommandFailure(state.failingCommandSignatures, config.maxCommandFailures);
+    if (cmdFail) {
+        return triggerSpindle({
+            shouldAbort: false,
+            shouldBlock: true,
+            reason: 'command_failure',
+            confidence: 0.8,
+            diagnostics: { commandSignature: cmdFail, commandFailureThreshold: config.maxCommandFailures },
+        });
+    }
+    // Check 8: File edit frequency warnings
+    const fileWarnings = getFileEditWarnings(state, config.maxFileEdits);
+    if (fileWarnings.length > 0) {
+        for (const w of fileWarnings) {
+            const warning = `File churn: ${w}`;
+            if (!state.warnings.includes(warning)) {
+                state.warnings.push(warning);
+            }
+        }
+    }
+    // No issues detected
+    // Instrument: track spindle check (no trigger)
+    metric('spindle', 'check_passed', {
+        tokens: state.estimatedTokens,
+        iterations: state.iterationsSinceChange,
+    });
+    return {
+        shouldAbort: false,
+        shouldBlock: false,
+        confidence: 0,
+        diagnostics: {
+            estimatedTokens: state.estimatedTokens,
+            iterationsWithoutChange: state.iterationsSinceChange,
+            ...(fileWarnings.length > 0 ? { fileEditWarnings: fileWarnings } : {}),
+        },
+    };
+}
+/**
+ * Helper to record spindle trigger and return result
+ */
+function triggerSpindle(result) {
+    metric('spindle', 'triggered', {
+        reason: result.reason,
+        shouldAbort: result.shouldAbort,
+        shouldBlock: result.shouldBlock,
+        confidence: result.confidence,
+    });
+    return result;
+}
+//# sourceMappingURL=index.js.map

package/dist/lib/spindle/index.js.map

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

package/dist/lib/spindle/oscillation.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Spindle — Oscillation detection
+ */
+/**
+ * Detect oscillation pattern in diffs
+ *
+ * Looks for add→remove→add or remove→add→remove patterns where similar
+ * content is being repeatedly changed back and forth.
+ *
+ * @returns Object with detected flag and pattern description
+ */
+export declare function detectOscillation(diffs: string[], similarityThreshold?: number): {
+    detected: boolean;
+    pattern?: string;
+    confidence: number;
+};
+//# sourceMappingURL=oscillation.d.ts.map

package/dist/lib/spindle/oscillation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oscillation.d.ts","sourceRoot":"","sources":["../../../src/lib/spindle/oscillation.ts"],"names":[],"mappings":"AAAA;;GAEG;AA2BH;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EAAE,EACf,mBAAmB,GAAE,MAAY,GAChC;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAiE7D"}

package/dist/lib/spindle/oscillation.js

@@ -0,0 +1,96 @@
+/**
+ * Spindle — Oscillation detection
+ */
+import { computeSimilarity } from './similarity.js';
+/**
+ * Extract added and removed lines from a unified diff
+ */
+function extractDiffLines(diff) {
+    const lines = diff.split('\n');
+    const added = [];
+    const removed = [];
+    for (const line of lines) {
+        // Skip diff headers
+        if (line.startsWith('+++') || line.startsWith('---') || line.startsWith('@@')) {
+            continue;
+        }
+        if (line.startsWith('+')) {
+            added.push(line.slice(1).trim());
+        }
+        else if (line.startsWith('-')) {
+            removed.push(line.slice(1).trim());
+        }
+    }
+    return { added, removed };
+}
+/**
+ * Detect oscillation pattern in diffs
+ *
+ * Looks for add→remove→add or remove→add→remove patterns where similar
+ * content is being repeatedly changed back and forth.
+ *
+ * @returns Object with detected flag and pattern description
+ */
+export function detectOscillation(diffs, similarityThreshold = 0.8) {
+    if (diffs.length < 2) {
+        return { detected: false, confidence: 0 };
+    }
+    // Analyze last 3 diffs (or 2 if only 2 available)
+    const recentDiffs = diffs.slice(-3);
+    const patterns = recentDiffs.map(d => extractDiffLines(d));
+    // With 2 diffs: check if what was added is now removed (or vice versa)
+    if (patterns.length >= 2) {
+        const [prev, curr] = patterns.slice(-2);
+        // Check: lines added in prev are now removed in curr
+        for (const addedLine of prev.added) {
+            if (addedLine.length < 3)
+                continue; // Skip trivial lines
+            for (const removedLine of curr.removed) {
+                const sim = computeSimilarity(addedLine, removedLine);
+                if (sim >= similarityThreshold) {
+                    return {
+                        detected: true,
+                        pattern: `Added then removed: "${addedLine.slice(0, 50)}..."`,
+                        confidence: sim,
+                    };
+                }
+            }
+        }
+        // Check: lines removed in prev are now added in curr
+        for (const removedLine of prev.removed) {
+            if (removedLine.length < 3)
+                continue;
+            for (const addedLine of curr.added) {
+                const sim = computeSimilarity(removedLine, addedLine);
+                if (sim >= similarityThreshold) {
+                    return {
+                        detected: true,
+                        pattern: `Removed then re-added: "${removedLine.slice(0, 50)}..."`,
+                        confidence: sim,
+                    };
+                }
+            }
+        }
+    }
+    // With 3 diffs: check for A→B→A pattern
+    if (patterns.length === 3) {
+        const [first, , third] = patterns;
+        // Check if first additions match third additions (came back to same state)
+        for (const line1 of first.added) {
+            if (line1.length < 3)
+                continue;
+            for (const line3 of third.added) {
+                const sim = computeSimilarity(line1, line3);
+                if (sim >= similarityThreshold) {
+                    return {
+                        detected: true,
+                        pattern: `Oscillating: same content added in iterations 1 and 3`,
+                        confidence: sim,
+                    };
+                }
+            }
+        }
+    }
+    return { detected: false, confidence: 0 };
+}
+//# sourceMappingURL=oscillation.js.map

package/dist/lib/spindle/oscillation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oscillation.js","sourceRoot":"","sources":["../../../src/lib/spindle/oscillation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD;;GAEG;AACH,SAAS,gBAAgB,CAAC,IAAY;IACpC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,oBAAoB;QACpB,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9E,SAAS;QACX,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACnC,CAAC;aAAM,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAChC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC5B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAe,EACf,sBAA8B,GAAG;IAEjC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;IAC5C,CAAC;IAED,kDAAkD;IAClD,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC;IAE3D,uEAAuE;IACvE,IAAI,QAAQ,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACzB,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAExC,qDAAqD;QACrD,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACnC,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC;gBAAE,SAAS,CAAC,qBAAqB;YACzD,KAAK,MAAM,WAAW,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACvC,MAAM,GAAG,GAAG,iBAAiB,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;gBACtD,IAAI,GAAG,IAAI,mBAAmB,EAAE,CAAC;oBAC/B,OAAO;wBACL,QAAQ,EAAE,IAAI;wBACd,OAAO,EAAE,wBAAwB,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM;wBAC7D,UAAU,EAAE,GAAG;qBAChB,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;QAED,qDAAqD;QACrD,KAAK,MAAM,WAAW,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACvC,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC;gBAAE,SAAS;YACrC,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBACnC,MAAM,GAAG,GAAG,iBAAiB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;gBACtD,IAAI,GAAG,IAAI,mBAAmB,EAAE,CAAC;oBAC/B,OAAO;wBACL,QAAQ,EAAE,IAAI;wBACd,OAAO,EAAE,2BAA2B,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM;wBAClE,UAAU,EAAE,GAAG;qBAChB,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,wCAAwC;IACxC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,CAAC,KAAK,EAAE,AAAD,EAAG,KAAK,CAAC,GAAG,QAAQ,CAAC;QAElC,2EAA2E;QAC3E,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAChC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;gBAAE,SAAS;YAC/B,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBAChC,MAAM,GAAG,GAAG,iBAAiB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;gBAC5C,IAAI,GAAG,IAAI,mBAAmB,EAAE,CAAC;oBAC/B,OAAO;wBACL,QAAQ,EAAE,IAAI;wBACd,OAAO,EAAE,uDAAuD;wBAChE,UAAU,EAAE,GAAG;qBAChB,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;AAC5C,CAAC"}

package/dist/lib/spindle/repetition.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Spindle — Repetition detection
+ */
+import type { SpindleConfig } from './types.js';
+/**
+ * Detect repetition in agent outputs
+ *
+ * Looks for consecutive similar outputs that indicate the agent is stuck
+ * in a loop saying the same things.
+ */
+export declare function detectRepetition(outputs: string[], latestOutput: string, config: SpindleConfig): {
+    detected: boolean;
+    patterns: string[];
+    confidence: number;
+};
+//# sourceMappingURL=repetition.d.ts.map

package/dist/lib/spindle/repetition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repetition.d.ts","sourceRoot":"","sources":["../../../src/lib/spindle/repetition.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EAAE,EACjB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,aAAa,GACpB;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CA+C/D"}

package/dist/lib/spindle/repetition.js

@@ -0,0 +1,52 @@
+/**
+ * Spindle — Repetition detection
+ */
+import { computeSimilarity, findRepeatedPhrases } from './similarity.js';
+/**
+ * Detect repetition in agent outputs
+ *
+ * Looks for consecutive similar outputs that indicate the agent is stuck
+ * in a loop saying the same things.
+ */
+export function detectRepetition(outputs, latestOutput, config) {
+    const patterns = [];
+    let maxSimilarity = 0;
+    // Compare latest output with recent outputs
+    for (const prevOutput of outputs.slice(-config.maxSimilarOutputs)) {
+        const sim = computeSimilarity(latestOutput, prevOutput);
+        if (sim >= config.similarityThreshold) {
+            maxSimilarity = Math.max(maxSimilarity, sim);
+            // Extract repeated phrases
+            const phrases = findRepeatedPhrases(latestOutput, prevOutput);
+            patterns.push(...phrases);
+        }
+    }
+    // Check for common "stuck" phrases
+    const stuckPhrases = [
+        'let me try',
+        'i apologize',
+        "i'll try again",
+        'let me attempt',
+        'trying again',
+        'one more time',
+        'another approach',
+    ];
+    const lowerOutput = latestOutput.toLowerCase();
+    for (const phrase of stuckPhrases) {
+        if (lowerOutput.includes(phrase)) {
+            const occurrences = outputs.filter(o => o.toLowerCase().includes(phrase)).length;
+            if (occurrences >= 2) {
+                patterns.push(`Repeated phrase: "${phrase}" (${occurrences + 1} times)`);
+                // Set high similarity since stuck phrases are a strong signal
+                maxSimilarity = Math.max(maxSimilarity, 0.85);
+            }
+        }
+    }
+    const detected = patterns.length > 0 && maxSimilarity >= config.similarityThreshold;
+    return {
+        detected,
+        patterns: [...new Set(patterns)].slice(0, 5), // Dedupe and limit
+        confidence: maxSimilarity,
+    };
+}
+//# sourceMappingURL=repetition.js.map

package/dist/lib/spindle/repetition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repetition.js","sourceRoot":"","sources":["../../../src/lib/spindle/repetition.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAGzE;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAiB,EACjB,YAAoB,EACpB,MAAqB;IAErB,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,aAAa,GAAG,CAAC,CAAC;IAEtB,4CAA4C;IAC5C,KAAK,MAAM,UAAU,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC,EAAE,CAAC;QAClE,MAAM,GAAG,GAAG,iBAAiB,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;QACxD,IAAI,GAAG,IAAI,MAAM,CAAC,mBAAmB,EAAE,CAAC;YACtC,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;YAE7C,2BAA2B;YAC3B,MAAM,OAAO,GAAG,mBAAmB,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;YAC9D,QAAQ,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,mCAAmC;IACnC,MAAM,YAAY,GAAG;QACnB,YAAY;QACZ,aAAa;QACb,gBAAgB;QAChB,gBAAgB;QAChB,cAAc;QACd,eAAe;QACf,kBAAkB;KACnB,CAAC;IAEF,MAAM,WAAW,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC;IAC/C,KAAK,MAAM,MAAM,IAAI,YAAY,EAAE,CAAC;QAClC,IAAI,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACjC,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CACrC,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CACjC,CAAC,MAAM,CAAC;YACT,IAAI,WAAW,IAAI,CAAC,EAAE,CAAC;gBACrB,QAAQ,CAAC,IAAI,CAAC,qBAAqB,MAAM,MAAM,WAAW,GAAG,CAAC,SAAS,CAAC,CAAC;gBACzE,8DAA8D;gBAC9D,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;YAChD,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,aAAa,IAAI,MAAM,CAAC,mBAAmB,CAAC;IACpF,OAAO;QACL,QAAQ;QACR,QAAQ,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,mBAAmB;QACjE,UAAU,EAAE,aAAa;KAC1B,CAAC;AACJ,CAAC"}

package/dist/lib/spindle/similarity.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Spindle — Similarity computation
+ */
+/**
+ * Compute similarity between two strings using Jaccard index on word tokens
+ *
+ * @returns Similarity score from 0 (completely different) to 1 (identical)
+ */
+export declare function computeSimilarity(a: string, b: string): number;
+/**
+ * Find repeated phrases between two texts
+ */
+export declare function findRepeatedPhrases(a: string, b: string, maxResults?: number): string[];
+//# sourceMappingURL=similarity.d.ts.map

package/dist/lib/spindle/similarity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"similarity.d.ts","sourceRoot":"","sources":["../../../src/lib/spindle/similarity.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CA6B9D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,UAAU,GAAE,MAAU,GAAG,MAAM,EAAE,CAkB1F"}

package/dist/lib/spindle/similarity.js

@@ -0,0 +1,58 @@
+/**
+ * Spindle — Similarity computation
+ */
+/**
+ * Compute similarity between two strings using Jaccard index on word tokens
+ *
+ * @returns Similarity score from 0 (completely different) to 1 (identical)
+ */
+export function computeSimilarity(a, b) {
+    if (!a && !b)
+        return 1;
+    if (!a || !b)
+        return 0;
+    // Tokenize on whitespace and punctuation, lowercase
+    const tokenize = (s) => {
+        const tokens = s
+            .toLowerCase()
+            .split(/[\s.,;:!?\-()[\]{}"']+/)
+            .filter(t => t.length > 0);
+        return new Set(tokens);
+    };
+    const tokensA = tokenize(a);
+    const tokensB = tokenize(b);
+    if (tokensA.size === 0 && tokensB.size === 0)
+        return 1;
+    if (tokensA.size === 0 || tokensB.size === 0)
+        return 0;
+    // Jaccard index: |intersection| / |union|
+    let intersectionSize = 0;
+    for (const token of tokensA) {
+        if (tokensB.has(token)) {
+            intersectionSize++;
+        }
+    }
+    const unionSize = tokensA.size + tokensB.size - intersectionSize;
+    return intersectionSize / unionSize;
+}
+/**
+ * Find repeated phrases between two texts
+ */
+export function findRepeatedPhrases(a, b, maxResults = 5) {
+    const phrases = [];
+    // Split into sentences/fragments
+    const fragmentsA = a.split(/[.!?\n]+/).filter(f => f.trim().length > 20);
+    const fragmentsB = b.split(/[.!?\n]+/).filter(f => f.trim().length > 20);
+    for (const fragA of fragmentsA) {
+        for (const fragB of fragmentsB) {
+            const sim = computeSimilarity(fragA, fragB);
+            if (sim >= 0.9) {
+                phrases.push(fragA.trim().slice(0, 60) + '...');
+                if (phrases.length >= maxResults)
+                    return phrases;
+            }
+        }
+    }
+    return phrases;
+}
+//# sourceMappingURL=similarity.js.map