@promptwheel/mcp 0.6.0

package/dist/spindle.js

@@ -0,0 +1,230 @@
+/**
+ * Spindle Loop Detection — MCP server adaptation.
+ *
+ * Monitors agent execution for unproductive patterns:
+ * - Oscillation: diffs flip-flopping (A→B→A)
+ * - Repetition: similar outputs repeated
+ * - Stalling: no file changes for N iterations
+ * - QA ping-pong: alternating test/lint failures
+ * - Command signature: same command fails repeatedly
+ *
+ * Ported from packages/cli/src/lib/spindle.ts, adapted for the
+ * event-driven MCP architecture.
+ */
+import { shortHash, detectQaPingPong, detectCommandFailure, extractFilesFromDiff, getFileEditWarnings as _getFileEditWarnings, } from '@promptwheel/core/spindle/shared';
+export const DEFAULT_SPINDLE_CONFIG = {
+    similarityThreshold: 0.8,
+    maxSimilarOutputs: 3,
+    maxStallIterations: 5,
+    maxCommandFailures: 3,
+    maxQaPingPong: 3,
+    maxFileEdits: 3,
+};
+const PASS = {
+    shouldAbort: false,
+    shouldBlock: false,
+    confidence: 0,
+    diagnostics: {},
+    risk: 'none',
+};
+// ---------------------------------------------------------------------------
+// Core check — runs on every advance()
+// ---------------------------------------------------------------------------
+export function checkSpindle(spindle, config = DEFAULT_SPINDLE_CONFIG) {
+    // 1. Stalling — no file changes
+    if (spindle.iterations_since_change >= config.maxStallIterations) {
+        return {
+            shouldAbort: true,
+            shouldBlock: false,
+            reason: 'stalling',
+            confidence: 0.9,
+            diagnostics: {
+                iterations_without_change: spindle.iterations_since_change,
+                threshold: config.maxStallIterations,
+            },
+            risk: 'high',
+        };
+    }
+    // 2. Oscillation — diff flip-flops
+    if (spindle.diff_hashes.length >= 3) {
+        const osc = detectOscillation(spindle.diff_hashes);
+        if (osc) {
+            return {
+                shouldAbort: true,
+                shouldBlock: false,
+                reason: 'oscillation',
+                confidence: 0.95,
+                diagnostics: { pattern: osc },
+                risk: 'high',
+            };
+        }
+    }
+    // 3. Repetition — similar output hashes
+    if (spindle.output_hashes.length >= config.maxSimilarOutputs) {
+        const rep = detectRepetition(spindle.output_hashes, config.maxSimilarOutputs);
+        if (rep) {
+            return {
+                shouldAbort: true,
+                shouldBlock: false,
+                reason: 'repetition',
+                confidence: 0.85,
+                diagnostics: { repeated_hash: rep, count: config.maxSimilarOutputs },
+                risk: 'high',
+            };
+        }
+    }
+    // 4. QA ping-pong — alternating failure types
+    if (spindle.failing_command_signatures.length >= config.maxQaPingPong * 2) {
+        const pp = detectQaPingPong(spindle.failing_command_signatures, config.maxQaPingPong);
+        if (pp) {
+            return {
+                shouldAbort: true,
+                shouldBlock: false,
+                reason: 'qa_ping_pong',
+                confidence: 0.9,
+                diagnostics: { pattern: pp },
+                risk: 'high',
+            };
+        }
+    }
+    // 5. Command signature — same command fails N times
+    const cmdFail = detectCommandFailure(spindle.failing_command_signatures, config.maxCommandFailures);
+    if (cmdFail) {
+        return {
+            shouldAbort: false,
+            shouldBlock: true, // → BLOCKED_NEEDS_HUMAN
+            reason: 'command_failure',
+            confidence: 0.8,
+            diagnostics: { command: cmdFail, threshold: config.maxCommandFailures },
+            risk: 'high',
+        };
+    }
+    // Compute risk level
+    const risk = computeRisk(spindle, config);
+    return { ...PASS, risk };
+}
+// ---------------------------------------------------------------------------
+// State update helpers — called from event processor
+// ---------------------------------------------------------------------------
+export function recordOutput(spindle, output) {
+    const hash = shortHash(output);
+    spindle.output_hashes.push(hash);
+    if (spindle.output_hashes.length > 10)
+        spindle.output_hashes.shift();
+    spindle.total_output_chars += output.length;
+}
+export function recordDiff(spindle, diff) {
+    if (!diff || diff.trim() === '') {
+        spindle.iterations_since_change++;
+        return;
+    }
+    spindle.iterations_since_change = 0;
+    const hash = shortHash(diff);
+    spindle.diff_hashes.push(hash);
+    if (spindle.diff_hashes.length > 10)
+        spindle.diff_hashes.shift();
+    spindle.total_change_chars += diff.length;
+    // Track per-file edit frequency
+    const files = extractFilesFromDiff(diff);
+    for (const f of files) {
+        const existing = spindle.file_edit_counts?.[f] ?? 0;
+        if (!spindle.file_edit_counts)
+            spindle.file_edit_counts = {};
+        spindle.file_edit_counts[f] = existing + 1;
+    }
+    // Cap file_edit_counts keys to prevent unbounded growth
+    const MAX_FILE_EDIT_KEYS = 50;
+    if (spindle.file_edit_counts && Object.keys(spindle.file_edit_counts).length > MAX_FILE_EDIT_KEYS) {
+        const sorted = Object.entries(spindle.file_edit_counts)
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, MAX_FILE_EDIT_KEYS);
+        spindle.file_edit_counts = Object.fromEntries(sorted);
+    }
+}
+export function recordCommandFailure(spindle, command, error) {
+    const sig = shortHash(`${command}::${error.slice(0, 200)}`);
+    spindle.failing_command_signatures.push(sig);
+    if (spindle.failing_command_signatures.length > 20)
+        spindle.failing_command_signatures.shift();
+}
+export function recordPlanHash(spindle, plan) {
+    const hash = shortHash(JSON.stringify(plan));
+    spindle.plan_hashes.push(hash);
+    if (spindle.plan_hashes.length > 10)
+        spindle.plan_hashes.shift();
+}
+export function recordTicketResult(spindle, changedFiles, diff) {
+    recordDiff(spindle, diff);
+}
+// ---------------------------------------------------------------------------
+// Detection functions
+// ---------------------------------------------------------------------------
+/** Detect A→B→A hash oscillation */
+function detectOscillation(hashes) {
+    // Check for A→B→A pattern in last 3
+    const recent = hashes.slice(-3);
+    if (recent.length === 3 && recent[0] === recent[2] && recent[0] !== recent[1]) {
+        return `Hash ${recent[0]} appeared at positions -3 and -1 (flip-flop)`;
+    }
+    // Check for any hash appearing in alternating positions
+    for (let i = hashes.length - 1; i >= 2; i--) {
+        if (hashes[i] === hashes[i - 2] && hashes[i] !== hashes[i - 1]) {
+            return `Hash ${hashes[i]} oscillating at positions ${i - 2}, ${i}`;
+        }
+    }
+    return null;
+}
+/** Detect N consecutive identical output hashes */
+function detectRepetition(hashes, threshold) {
+    if (hashes.length < threshold)
+        return null;
+    const recent = hashes.slice(-threshold);
+    const first = recent[0];
+    if (recent.every(h => h === first)) {
+        return first;
+    }
+    return null;
+}
+// ---------------------------------------------------------------------------
+// Risk computation
+// ---------------------------------------------------------------------------
+function computeRisk(spindle, config) {
+    let score = 0;
+    // Stall proximity
+    if (spindle.iterations_since_change >= config.maxStallIterations * 0.6)
+        score += 2;
+    else if (spindle.iterations_since_change >= 2)
+        score += 1;
+    // Repeated outputs
+    const recentOutputs = spindle.output_hashes.slice(-3);
+    if (recentOutputs.length >= 2 && recentOutputs[recentOutputs.length - 1] === recentOutputs[recentOutputs.length - 2]) {
+        score += 1;
+    }
+    // File edit frequency warnings
+    if (spindle.file_edit_counts) {
+        for (const count of Object.values(spindle.file_edit_counts)) {
+            if (count >= config.maxFileEdits)
+                score += 2;
+        }
+    }
+    // Command failures
+    if (spindle.failing_command_signatures.length >= 2)
+        score += 1;
+    if (score >= 4)
+        return 'high';
+    if (score >= 2)
+        return 'medium';
+    if (score >= 1)
+        return 'low';
+    return 'none';
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** Get file edit frequency warnings — wraps shared function, handles optional field */
+export function getFileEditWarnings(spindle, threshold = 3) {
+    if (!spindle.file_edit_counts)
+        return [];
+    return _getFileEditWarnings(spindle.file_edit_counts, threshold);
+}
+//# sourceMappingURL=spindle.js.map

package/dist/spindle.js.map

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

package/dist/state.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Session state manager (v2)
+ *
+ * Thin wrapper around RunManager + database.
+ * Each MCP server instance has at most one active run.
+ */
+import type { DatabaseAdapter } from '@promptwheel/core';
+import type { Project } from '@promptwheel/core';
+import { RunManager } from './run-manager.js';
+import type { RunState, SessionConfig } from './types.js';
+export declare class SessionManager {
+    readonly db: DatabaseAdapter;
+    readonly project: Project;
+    readonly projectPath: string;
+    readonly run: RunManager;
+    constructor(db: DatabaseAdapter, project: Project, projectPath: string);
+    /** Start a new session/run */
+    start(config: SessionConfig): RunState;
+    /** Get active run state or throw */
+    requireActive(): RunState;
+    /** End the session */
+    end(): RunState;
+    /** Get current status summary */
+    getStatus(): {
+        sessionId: string;
+        runId: string;
+        phase: string;
+        stepCount: number;
+        budgetRemaining: number;
+        ticketsCompleted: number;
+        ticketsFailed: number;
+        currentTicketId: string | null;
+        timeRemainingMs: number | null;
+    };
+}
+//# sourceMappingURL=state.d.ts.map

package/dist/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE1D,qBAAa,cAAc;IAIvB,QAAQ,CAAC,EAAE,EAAE,eAAe;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM;IAL9B,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;gBAGd,EAAE,EAAE,eAAe,EACnB,OAAO,EAAE,OAAO,EAChB,WAAW,EAAE,MAAM;IAK9B,8BAA8B;IAC9B,KAAK,CAAC,MAAM,EAAE,aAAa,GAAG,QAAQ;IAItC,oCAAoC;IACpC,aAAa,IAAI,QAAQ;IAIzB,sBAAsB;IACtB,GAAG,IAAI,QAAQ;IAIf,iCAAiC;IACjC,SAAS,IAAI;QACX,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,eAAe,EAAE,MAAM,CAAC;QACxB,gBAAgB,EAAE,MAAM,CAAC;QACzB,aAAa,EAAE,MAAM,CAAC;QACtB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;QAC/B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;KAChC;CAkBF"}

package/dist/state.js

@@ -0,0 +1,50 @@
+/**
+ * Session state manager (v2)
+ *
+ * Thin wrapper around RunManager + database.
+ * Each MCP server instance has at most one active run.
+ */
+import { RunManager } from './run-manager.js';
+export class SessionManager {
+    db;
+    project;
+    projectPath;
+    run;
+    constructor(db, project, projectPath) {
+        this.db = db;
+        this.project = project;
+        this.projectPath = projectPath;
+        this.run = new RunManager(projectPath);
+    }
+    /** Start a new session/run */
+    start(config) {
+        return this.run.create(this.project.id, config);
+    }
+    /** Get active run state or throw */
+    requireActive() {
+        return this.run.require();
+    }
+    /** End the session */
+    end() {
+        return this.run.end();
+    }
+    /** Get current status summary */
+    getStatus() {
+        const s = this.run.require();
+        const timeRemainingMs = s.expires_at
+            ? Math.max(0, new Date(s.expires_at).getTime() - Date.now())
+            : null;
+        return {
+            sessionId: s.session_id,
+            runId: s.run_id,
+            phase: s.phase,
+            stepCount: s.step_count,
+            budgetRemaining: s.step_budget - s.step_count,
+            ticketsCompleted: s.tickets_completed,
+            ticketsFailed: s.tickets_failed,
+            currentTicketId: s.current_ticket_id,
+            timeRemainingMs,
+        };
+    }
+}
+//# sourceMappingURL=state.js.map

package/dist/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,MAAM,OAAO,cAAc;IAId;IACA;IACA;IALF,GAAG,CAAa;IAEzB,YACW,EAAmB,EACnB,OAAgB,EAChB,WAAmB;QAFnB,OAAE,GAAF,EAAE,CAAiB;QACnB,YAAO,GAAP,OAAO,CAAS;QAChB,gBAAW,GAAX,WAAW,CAAQ;QAE5B,IAAI,CAAC,GAAG,GAAG,IAAI,UAAU,CAAC,WAAW,CAAC,CAAC;IACzC,CAAC;IAED,8BAA8B;IAC9B,KAAK,CAAC,MAAqB;QACzB,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IAClD,CAAC;IAED,oCAAoC;IACpC,aAAa;QACX,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IAC5B,CAAC;IAED,sBAAsB;IACtB,GAAG;QACD,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;IACxB,CAAC;IAED,iCAAiC;IACjC,SAAS;QAWP,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QAC7B,MAAM,eAAe,GAAG,CAAC,CAAC,UAAU;YAClC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC5D,CAAC,CAAC,IAAI,CAAC;QAET,OAAO;YACL,SAAS,EAAE,CAAC,CAAC,UAAU;YACvB,KAAK,EAAE,CAAC,CAAC,MAAM;YACf,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,SAAS,EAAE,CAAC,CAAC,UAAU;YACvB,eAAe,EAAE,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,UAAU;YAC7C,gBAAgB,EAAE,CAAC,CAAC,iBAAiB;YACrC,aAAa,EAAE,CAAC,CAAC,cAAc;YAC/B,eAAe,EAAE,CAAC,CAAC,iBAAiB;YACpC,eAAe;SAChB,CAAC;IACJ,CAAC;CACF"}

package/dist/ticket-worker.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Ticket Worker — self-contained mini state machine for one ticket in parallel mode.
+ *
+ * Each ticket worker follows: PLAN → EXECUTE → QA → PR → DONE
+ * State is stored in RunState.ticket_workers[ticketId].
+ */
+import type { DatabaseAdapter } from '@promptwheel/core';
+import type { Project } from '@promptwheel/core';
+import { RunManager } from './run-manager.js';
+import type { AdvanceConstraints } from './types.js';
+export interface TicketWorkerContext {
+    run: RunManager;
+    db: DatabaseAdapter;
+    project: Project;
+}
+export interface TicketWorkerResponse {
+    action: 'PROMPT' | 'DONE' | 'FAILED';
+    phase: string;
+    prompt: string | null;
+    constraints: AdvanceConstraints | null;
+    ticket_id: string;
+    reason: string;
+}
+/**
+ * Advance a single ticket worker through its lifecycle.
+ * Called by the promptwheel_advance_ticket MCP tool.
+ */
+export declare function advanceTicketWorker(ctx: TicketWorkerContext, ticketId: string): Promise<TicketWorkerResponse>;
+/**
+ * Ingest an event for a specific ticket worker.
+ * Mirrors event-processor.ts logic but scoped to one ticket.
+ */
+export declare function ingestTicketEvent(ctx: TicketWorkerContext, ticketId: string, type: string, payload: Record<string, unknown>): Promise<{
+    processed: boolean;
+    message: string;
+}>;
+//# sourceMappingURL=ticket-worker.d.ts.map

package/dist/ticket-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ticket-worker.d.ts","sourceRoot":"","sources":["../src/ticket-worker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EACV,kBAAkB,EAGnB,MAAM,YAAY,CAAC;AAiBpB,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,UAAU,CAAC;IAChB,EAAE,EAAE,eAAe,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,WAAW,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,mBAAmB,EACxB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,oBAAoB,CAAC,CAoP/B;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,mBAAmB,EACxB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAsKlD"}