@promptwheel/mcp 0.6.0

package/dist/proposals.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Proposal filtering, dedup, scoring, and ticket creation.
+ *
+ * Pure algorithms (schema validation, normalization, scoring, balancing,
+ * review prompt, description formatting) live in @promptwheel/core/proposals/shared.
+ * This file wraps them with database I/O, event logging, and MCP-specific
+ * dedup and deferred-proposal management.
+ */
+import type { DatabaseAdapter } from '@promptwheel/core';
+import { type RawProposal, type ValidatedProposal } from '@promptwheel/core/proposals/shared';
+import { RunManager } from './run-manager.js';
+export type { RawProposal, ValidatedProposal, ReviewedProposal } from '@promptwheel/core/proposals/shared';
+export { validateProposalSchema, normalizeProposal, buildProposalReviewPrompt, parseReviewedProposals, applyReviewToProposals, scoreAndRank, balanceProposals, formatProposalDescription, computePriority, PROPOSALS_DEFAULTS, } from '@promptwheel/core/proposals/shared';
+export interface FilterResult {
+    accepted: ValidatedProposal[];
+    rejected: Array<{
+        proposal: RawProposal;
+        reason: string;
+    }>;
+    created_ticket_ids: string[];
+}
+export declare function filterAndCreateTickets(run: RunManager, db: DatabaseAdapter, rawProposals: RawProposal[]): Promise<FilterResult>;
+//# sourceMappingURL=proposals.d.ts.map

package/dist/proposals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proposals.d.ts","sourceRoot":"","sources":["../src/proposals.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAkB,MAAM,mBAAmB,CAAC;AAGzE,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,iBAAiB,EAQvB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAI9C,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAC3G,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,yBAAyB,EACzB,sBAAsB,EACtB,sBAAsB,EACtB,YAAY,EACZ,gBAAgB,EAChB,yBAAyB,EACzB,eAAe,EACf,kBAAkB,GACnB,MAAM,oCAAoC,CAAC;AAM5C,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,QAAQ,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,WAAW,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3D,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC9B;AAMD,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,UAAU,EACf,EAAE,EAAE,eAAe,EACnB,YAAY,EAAE,WAAW,EAAE,GAC1B,OAAO,CAAC,YAAY,CAAC,CA0MvB"}

package/dist/proposals.js

@@ -0,0 +1,201 @@
+/**
+ * Proposal filtering, dedup, scoring, and ticket creation.
+ *
+ * Pure algorithms (schema validation, normalization, scoring, balancing,
+ * review prompt, description formatting) live in @promptwheel/core/proposals/shared.
+ * This file wraps them with database I/O, event logging, and MCP-specific
+ * dedup and deferred-proposal management.
+ */
+import { repos } from '@promptwheel/core';
+import { bigramSimilarity } from '@promptwheel/core/dedup/shared';
+import { validateProposalSchema, normalizeProposal, scoreAndRank, balanceProposals, formatProposalDescription, computePriority, PROPOSALS_DEFAULTS, } from '@promptwheel/core/proposals/shared';
+import { minimatch } from 'minimatch';
+import { recordDedupEntries } from './dedup-memory.js';
+export { validateProposalSchema, normalizeProposal, buildProposalReviewPrompt, parseReviewedProposals, applyReviewToProposals, scoreAndRank, balanceProposals, formatProposalDescription, computePriority, PROPOSALS_DEFAULTS, } from '@promptwheel/core/proposals/shared';
+// ---------------------------------------------------------------------------
+// Main entry: filter + create tickets
+// ---------------------------------------------------------------------------
+export async function filterAndCreateTickets(run, db, rawProposals) {
+    const s = run.require();
+    const rejected = [];
+    // Step 0: Re-promote deferred proposals that now match the current scope
+    const currentScope = s.scope || '';
+    const currentIsCatchAll = !currentScope || currentScope === '**' || currentScope === '*';
+    const stillDeferred = [];
+    for (const dp of s.deferred_proposals) {
+        const files = dp.files.length > 0 ? dp.files : dp.allowed_paths;
+        const nowInScope = currentIsCatchAll || files.length === 0 || files.every(f => minimatch(f, currentScope, { dot: true }));
+        if (nowInScope) {
+            rawProposals.push({
+                category: dp.category,
+                title: dp.title,
+                description: dp.description,
+                files: dp.files,
+                allowed_paths: dp.allowed_paths,
+                confidence: dp.confidence,
+                impact_score: dp.impact_score,
+                verification_commands: dp.verification_commands,
+                acceptance_criteria: dp.acceptance_criteria,
+                risk: dp.risk,
+                touched_files_estimate: dp.touched_files_estimate,
+                rollback_note: dp.rollback_note,
+                rationale: dp.rationale,
+                estimated_complexity: dp.estimated_complexity,
+            });
+        }
+        else {
+            stillDeferred.push(dp);
+        }
+    }
+    s.deferred_proposals = stillDeferred;
+    // Step 1: Schema validation
+    const valid = [];
+    for (const raw of rawProposals) {
+        const missing = validateProposalSchema(raw);
+        if (missing) {
+            rejected.push({ proposal: raw, reason: `Missing fields: ${missing}` });
+            continue;
+        }
+        valid.push(normalizeProposal(raw));
+    }
+    // Step 2a: Reject fundamentally flawed proposals (confidence=0 from adversarial review)
+    const afterConfidence = valid.filter(p => {
+        if (p.confidence <= 0) {
+            rejected.push({ proposal: p, reason: 'Rejected by adversarial review (confidence=0)' });
+            return false;
+        }
+        return true;
+    });
+    // Step 2b: Impact score filter
+    const minImpact = s.min_impact_score ?? PROPOSALS_DEFAULTS.DEFAULT_MIN_IMPACT;
+    const afterImpact = afterConfidence.filter(p => {
+        const impact = p.impact_score ?? PROPOSALS_DEFAULTS.DEFAULT_IMPACT;
+        if (impact < minImpact) {
+            rejected.push({ proposal: p, reason: `Impact score ${impact} below min ${minImpact}` });
+            return false;
+        }
+        return true;
+    });
+    // Step 3: Category trust ladder
+    const allowedCategories = new Set(s.categories);
+    const afterCategory = afterImpact.filter(p => {
+        if (!allowedCategories.has(p.category)) {
+            rejected.push({ proposal: p, reason: `Category '${p.category}' not in trust ladder` });
+            return false;
+        }
+        return true;
+    });
+    // Step 3b: Scope filter — defer proposals whose files fall outside session scope
+    const sessionScope = s.scope || '';
+    const isCatchAll = !sessionScope || sessionScope === '**' || sessionScope === '*';
+    const afterScope = isCatchAll
+        ? afterCategory
+        : afterCategory.filter(p => {
+            const files = p.files.length > 0 ? p.files : p.allowed_paths;
+            const allInScope = files.length === 0 || files.every(f => minimatch(f, sessionScope, { dot: true }));
+            if (!allInScope) {
+                s.deferred_proposals.push({
+                    category: p.category,
+                    title: p.title,
+                    description: p.description,
+                    files: p.files,
+                    allowed_paths: p.allowed_paths,
+                    confidence: p.confidence,
+                    impact_score: p.impact_score,
+                    original_scope: s.scope,
+                    verification_commands: p.verification_commands,
+                    acceptance_criteria: p.acceptance_criteria,
+                    risk: p.risk,
+                    touched_files_estimate: p.touched_files_estimate,
+                    rollback_note: p.rollback_note,
+                    rationale: p.rationale,
+                    estimated_complexity: p.estimated_complexity,
+                });
+                rejected.push({ proposal: p, reason: `Deferred (files outside scope '${s.scope}'): ${files.filter(f => !minimatch(f, sessionScope, { dot: true })).join(', ')}` });
+                return false;
+            }
+            return true;
+        });
+    // Cap deferred proposals to prevent unbounded growth
+    if (s.deferred_proposals.length > PROPOSALS_DEFAULTS.MAX_DEFERRED) {
+        s.deferred_proposals.sort((a, b) => b.confidence - a.confidence);
+        s.deferred_proposals = s.deferred_proposals.slice(0, PROPOSALS_DEFAULTS.MAX_DEFERRED);
+    }
+    // Step 4: Dedup against existing tickets (title similarity via bigrams)
+    const existingTickets = await repos.tickets.listByProject(db, s.project_id, {
+        status: ['ready', 'in_progress'],
+    });
+    const existingTitles = existingTickets.map(t => t.title);
+    const afterDedup = afterScope.filter(p => {
+        const isDupe = existingTitles.some(t => bigramSimilarity(t, p.title) >= PROPOSALS_DEFAULTS.DEDUP_THRESHOLD);
+        if (isDupe) {
+            rejected.push({ proposal: p, reason: `Duplicate of existing ticket (title similarity >= ${PROPOSALS_DEFAULTS.DEDUP_THRESHOLD})` });
+            return false;
+        }
+        return true;
+    });
+    // Also dedup within the batch
+    const uniqueByTitle = [];
+    for (const p of afterDedup) {
+        const isDupeInBatch = uniqueByTitle.some(q => bigramSimilarity(q.title, p.title) >= PROPOSALS_DEFAULTS.DEDUP_THRESHOLD);
+        if (isDupeInBatch) {
+            rejected.push({ proposal: p, reason: `Duplicate within batch (title similarity >= ${PROPOSALS_DEFAULTS.DEDUP_THRESHOLD})` });
+            continue;
+        }
+        uniqueByTitle.push(p);
+    }
+    // Step 5: Score, rank, and cap
+    const ranked = scoreAndRank(uniqueByTitle, s.max_proposals_per_scout);
+    // Step 5b: Balance test vs non-test proposals
+    const accepted = balanceProposals(ranked, PROPOSALS_DEFAULTS.MAX_TEST_RATIO);
+    // Step 6: Create tickets
+    const ticketInputs = accepted.map(p => ({
+        projectId: s.project_id,
+        title: p.title,
+        description: formatProposalDescription(p),
+        status: 'ready',
+        priority: computePriority(p.impact_score ?? PROPOSALS_DEFAULTS.DEFAULT_IMPACT, p.confidence),
+        category: p.category,
+        allowedPaths: p.allowed_paths,
+        verificationCommands: p.verification_commands,
+        metadata: {
+            scoutConfidence: p.confidence,
+            estimatedComplexity: p.estimated_complexity,
+        },
+    }));
+    let createdIds = [];
+    if (ticketInputs.length > 0) {
+        const created = await repos.tickets.createMany(db, ticketInputs);
+        createdIds = created.map(t => t.id);
+        run.appendEvent('TICKETS_CREATED', {
+            count: created.length,
+            ids: createdIds,
+            titles: accepted.map(p => p.title),
+        });
+    }
+    run.appendEvent('PROPOSALS_FILTERED', {
+        submitted: rawProposals.length,
+        valid: valid.length,
+        after_confidence: afterConfidence.length,
+        after_impact: afterImpact.length,
+        after_category: afterCategory.length,
+        after_dedup: uniqueByTitle.length,
+        accepted: accepted.length,
+        rejected_count: rejected.length,
+    });
+    // Record dedup memory — accepted titles as completed, duplicate rejections as attempted
+    const dedupEntries = [];
+    for (const p of accepted) {
+        dedupEntries.push({ title: p.title, completed: true });
+    }
+    for (const r of rejected) {
+        if (r.reason.includes('Duplicate') && r.proposal.title) {
+            dedupEntries.push({ title: r.proposal.title, completed: false });
+        }
+    }
+    if (dedupEntries.length > 0) {
+        recordDedupEntries(run.rootPath, dedupEntries);
+    }
+    return { accepted, rejected, created_ticket_ids: createdIds };
+}
+//# sourceMappingURL=proposals.js.map

package/dist/proposals.js.map

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

package/dist/qa-stats.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Per-command QA statistics tracking for the MCP package.
+ *
+ * Minimal subset copied from CLI's `packages/cli/src/lib/qa-stats.ts`.
+ * Provides persistence to `.promptwheel/qa-stats.json` for QA command
+ * result tracking when running through the plugin/MCP path.
+ */
+export interface QaCommandStats {
+    name: string;
+    totalRuns: number;
+    successes: number;
+    failures: number;
+    timeouts: number;
+    preExistingSkips: number;
+    totalDurationMs: number;
+    avgDurationMs: number;
+    lastRunAt: number;
+    consecutiveFailures: number;
+    consecutiveTimeouts: number;
+    /** Ring buffer of recent baseline results (max 10) */
+    recentBaselineResults: boolean[];
+}
+export interface DisabledCommand {
+    name: string;
+    reason: string;
+    disabledAt: number;
+}
+export interface QaStatsStore {
+    commands: Record<string, QaCommandStats>;
+    lastUpdated: number;
+    /** Commands disabled by auto-tune, persisted across restarts */
+    disabledCommands: DisabledCommand[];
+    /** Quality rate when calibrateConfidence last adjusted (hysteresis) */
+    lastCalibratedQualityRate: number | null;
+}
+export declare function loadQaStats(projectRoot: string): QaStatsStore;
+export declare function saveQaStats(projectRoot: string, store: QaStatsStore): void;
+/**
+ * Record the result of a QA command execution.
+ */
+export declare function recordQaCommandResult(projectRoot: string, name: string, result: {
+    passed: boolean;
+    durationMs: number;
+    timedOut: boolean;
+    skippedPreExisting: boolean;
+}): void;
+/**
+ * Record a baseline check result (push to ring buffer).
+ */
+export declare function recordBaselineResult(projectRoot: string, name: string, passed: boolean): void;
+//# sourceMappingURL=qa-stats.d.ts.map

package/dist/qa-stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qa-stats.d.ts","sourceRoot":"","sources":["../src/qa-stats.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,sDAAsD;IACtD,qBAAqB,EAAE,OAAO,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,gBAAgB,EAAE,eAAe,EAAE,CAAC;IACpC,uEAAuE;IACvE,yBAAyB,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1C;AAiBD,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,CAkB7D;AAED,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI,CAU1E;AA8BD;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE;IACN,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,kBAAkB,EAAE,OAAO,CAAC;CAC7B,GACA,IAAI,CA6BN;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,OAAO,GACd,IAAI,CAQN"}

package/dist/qa-stats.js

@@ -0,0 +1,121 @@
+/**
+ * Per-command QA statistics tracking for the MCP package.
+ *
+ * Minimal subset copied from CLI's `packages/cli/src/lib/qa-stats.ts`.
+ * Provides persistence to `.promptwheel/qa-stats.json` for QA command
+ * result tracking when running through the plugin/MCP path.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const QA_STATS_FILE = 'qa-stats.json';
+const MAX_BASELINE_RING = 10;
+// ---------------------------------------------------------------------------
+// File I/O
+// ---------------------------------------------------------------------------
+function statsPath(projectRoot) {
+    return path.join(projectRoot, '.promptwheel', QA_STATS_FILE);
+}
+export function loadQaStats(projectRoot) {
+    const fp = statsPath(projectRoot);
+    if (!fs.existsSync(fp)) {
+        return { commands: {}, lastUpdated: 0, disabledCommands: [], lastCalibratedQualityRate: null };
+    }
+    try {
+        const raw = fs.readFileSync(fp, 'utf8');
+        const parsed = JSON.parse(raw);
+        return {
+            commands: parsed.commands ?? {},
+            lastUpdated: parsed.lastUpdated ?? 0,
+            disabledCommands: Array.isArray(parsed.disabledCommands) ? parsed.disabledCommands : [],
+            lastCalibratedQualityRate: parsed.lastCalibratedQualityRate ?? null,
+        };
+    }
+    catch (err) {
+        console.warn(`[promptwheel] failed to parse qa-stats.json: ${err instanceof Error ? err.message : String(err)}`);
+        return { commands: {}, lastUpdated: 0, disabledCommands: [], lastCalibratedQualityRate: null };
+    }
+}
+export function saveQaStats(projectRoot, store) {
+    const fp = statsPath(projectRoot);
+    const dir = path.dirname(fp);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    store.lastUpdated = Date.now();
+    const tmp = fp + '.tmp';
+    fs.writeFileSync(tmp, JSON.stringify(store, null, 2) + '\n', 'utf8');
+    fs.renameSync(tmp, fp);
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function ensureCommand(store, name) {
+    if (!store.commands[name]) {
+        store.commands[name] = {
+            name,
+            totalRuns: 0,
+            successes: 0,
+            failures: 0,
+            timeouts: 0,
+            preExistingSkips: 0,
+            totalDurationMs: 0,
+            avgDurationMs: 0,
+            lastRunAt: 0,
+            consecutiveFailures: 0,
+            consecutiveTimeouts: 0,
+            recentBaselineResults: [],
+        };
+    }
+    return store.commands[name];
+}
+// ---------------------------------------------------------------------------
+// Core API
+// ---------------------------------------------------------------------------
+/**
+ * Record the result of a QA command execution.
+ */
+export function recordQaCommandResult(projectRoot, name, result) {
+    const store = loadQaStats(projectRoot);
+    const stats = ensureCommand(store, name);
+    stats.totalRuns++;
+    stats.lastRunAt = Date.now();
+    if (result.skippedPreExisting) {
+        stats.preExistingSkips++;
+    }
+    else if (result.timedOut) {
+        stats.timeouts++;
+        stats.consecutiveTimeouts++;
+        stats.consecutiveFailures++;
+    }
+    else if (result.passed) {
+        stats.successes++;
+        stats.consecutiveFailures = 0;
+        stats.consecutiveTimeouts = 0;
+    }
+    else {
+        stats.failures++;
+        stats.consecutiveFailures++;
+        stats.consecutiveTimeouts = 0;
+    }
+    stats.totalDurationMs += result.durationMs;
+    stats.avgDurationMs = stats.totalRuns > 0
+        ? Math.round(stats.totalDurationMs / stats.totalRuns)
+        : 0;
+    saveQaStats(projectRoot, store);
+}
+/**
+ * Record a baseline check result (push to ring buffer).
+ */
+export function recordBaselineResult(projectRoot, name, passed) {
+    const store = loadQaStats(projectRoot);
+    const stats = ensureCommand(store, name);
+    stats.recentBaselineResults.push(passed);
+    if (stats.recentBaselineResults.length > MAX_BASELINE_RING) {
+        stats.recentBaselineResults.shift();
+    }
+    saveQaStats(projectRoot, store);
+}
+//# sourceMappingURL=qa-stats.js.map

package/dist/qa-stats.js.map

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

package/dist/run-manager.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Run Manager — creates and manages run folders on disk.
+ *
+ * Each run lives at `.promptwheel/runs/<run_id>/` and contains:
+ *   - state.json   — current RunState (overwritten on every change)
+ *   - events.ndjson — append-only event log
+ *   - diffs/        — patch files per step
+ *   - artifacts/    — QA logs, scout proposals, etc.
+ */
+import type { RunState, EventType, Phase, SessionConfig, TicketWorkerState } from './types.js';
+export declare class RunManager {
+    private readonly projectPath;
+    private state;
+    private runDir;
+    private eventsPath;
+    private learningsDecayRate?;
+    constructor(projectPath: string);
+    /** The project root path */
+    get rootPath(): string;
+    /** The base .promptwheel directory */
+    private get bsDir();
+    /** Create a new run, write initial state.json and SESSION_START event */
+    create(projectId: string, config: SessionConfig): RunState;
+    /** Get current state or throw */
+    require(): RunState;
+    /** Get current state (may be null) */
+    get current(): RunState | null;
+    /** Get run directory path */
+    get dir(): string | null;
+    /** Transition to a new phase */
+    setPhase(phase: Phase): void;
+    /** Increment step counter (called on each advance) */
+    incrementStep(): void;
+    /** Assign a ticket as current work */
+    assignTicket(ticketId: string): void;
+    /** Mark current ticket completed */
+    completeTicket(): void;
+    /** Mark current ticket failed */
+    failTicket(reason: string): void;
+    /** Reset spindle and ticket state for recovery after a spindle abort */
+    resetForSpindleRecovery(): void;
+    /** Add a hint */
+    addHint(hint: string): void;
+    /** Consume and return all pending hints */
+    consumeHints(): string[];
+    /** End the run */
+    end(): RunState;
+    /** Initialize a ticket worker entry */
+    initTicketWorker(ticketId: string, _ticket: {
+        title: string;
+    }): void;
+    /** Get a ticket worker state */
+    getTicketWorker(ticketId: string): TicketWorkerState | null;
+    /** Update a ticket worker state */
+    updateTicketWorker(ticketId: string, updates: Partial<TicketWorkerState>): void;
+    /** Complete a ticket worker — increment counters and remove from workers */
+    completeTicketWorker(ticketId: string): void;
+    /** Fail a ticket worker — increment counters and remove from workers */
+    failTicketWorker(ticketId: string, reason: string): void;
+    /** Check if all ticket workers are done */
+    allWorkersComplete(): boolean;
+    /** Append an event to events.ndjson */
+    appendEvent(type: EventType, payload: Record<string, unknown>): void;
+    /** Save an artifact file */
+    saveArtifact(filename: string, content: string): void;
+    /** Save a diff/patch file */
+    saveDiff(step: number, ticketId: string, patch: string): void;
+    /** Check if any budget is exhausted */
+    isBudgetExhausted(): {
+        exhausted: boolean;
+        which?: string;
+    };
+    /** Check if approaching budget limits (80%) */
+    getBudgetWarnings(): string[];
+    /** Build the digest for advance responses */
+    buildDigest(): {
+        step: number;
+        phase: string;
+        tickets_completed: number;
+        tickets_failed: number;
+        budget_remaining: number;
+        ticket_budget_remaining: number;
+        spindle_risk: 'none' | 'low' | 'medium' | 'high';
+        time_remaining_ms: number | null;
+        coverage: {
+            sectors_scanned: number;
+            sectors_total: number;
+            files_scanned: number;
+            files_total: number;
+            percent: number;
+        };
+    };
+    /** Lazy-load learnings from disk on first access. No-op if already loaded or disabled. */
+    ensureLearningsLoaded(): void;
+    private persistState;
+}
+//# sourceMappingURL=run-manager.d.ts.map

package/dist/run-manager.d.ts.map

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