@blockspool/mcp 0.3.0

package/dist/direct-client.js

@@ -0,0 +1,92 @@
+/**
+ * Direct Client — programmatic adapter for the BlockSpool canonical loop.
+ *
+ * Proves the MCP tools work without Claude Code or stdio transport.
+ * Any LLM (or test harness) can drive the loop:
+ *
+ *   const client = await DirectClient.create({ projectPath });
+ *   const session = client.startSession({ scope: 'src/**' });
+ *   while (true) {
+ *     const resp = await client.advance();
+ *     if (resp.next_action === 'STOP') break;
+ *     // ... call LLM with resp.prompt ...
+ *     await client.ingestEvent(type, payload);
+ *   }
+ *   client.endSession();
+ *   await client.close();
+ */
+import * as path from 'node:path';
+import * as fs from 'node:fs';
+import { createSQLiteAdapter } from '@blockspool/sqlite';
+import { repos } from '@blockspool/core';
+import { RunManager } from './run-manager.js';
+import { advance } from './advance.js';
+import { processEvent } from './event-processor.js';
+export class DirectClient {
+    run;
+    db;
+    project;
+    ownsDb;
+    constructor(run, db, project, ownsDb) {
+        this.run = run;
+        this.db = db;
+        this.project = project;
+        this.ownsDb = ownsDb;
+    }
+    /**
+     * Create a DirectClient. Initializes SQLite and ensures the project exists.
+     */
+    static async create(options) {
+        const { projectPath, projectName } = options;
+        let db = options.db;
+        let ownsDb = false;
+        if (!db) {
+            const bsDir = path.join(projectPath, '.blockspool');
+            if (!fs.existsSync(bsDir)) {
+                fs.mkdirSync(bsDir, { recursive: true });
+            }
+            db = await createSQLiteAdapter({ url: path.join(bsDir, 'state.sqlite') });
+            ownsDb = true;
+        }
+        const project = await repos.projects.ensureForRepo(db, {
+            name: projectName ?? path.basename(projectPath),
+            rootPath: projectPath,
+        });
+        const run = new RunManager(projectPath);
+        return new DirectClient(run, db, project, ownsDb);
+    }
+    /** Start a new session. Returns the initial RunState. */
+    startSession(config = {}) {
+        return this.run.create(this.project.id, config);
+    }
+    /** Get the next action. This is the core loop driver. */
+    async advance() {
+        return advance({ run: this.run, db: this.db, project: this.project });
+    }
+    /** Report an event back. Triggers state transitions. */
+    async ingestEvent(type, payload) {
+        // Log the raw event (matches what blockspool_ingest_event tool does)
+        this.run.appendEvent(type, payload);
+        const result = await processEvent(this.run, this.db, type, payload);
+        return { processed: result.processed, message: result.message };
+    }
+    /** Get current run state. */
+    getState() {
+        return this.run.require();
+    }
+    /** End the session. */
+    endSession() {
+        return this.run.end();
+    }
+    /** Clean up resources. */
+    async close() {
+        if (this.ownsDb) {
+            await this.db.close();
+        }
+    }
+    /** Expose internals for testing */
+    get _run() { return this.run; }
+    get _db() { return this.db; }
+    get _project() { return this.project; }
+}
+//# sourceMappingURL=direct-client.js.map

package/dist/direct-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"direct-client.js","sourceRoot":"","sources":["../src/direct-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEzC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAepD,MAAM,OAAO,YAAY;IACf,GAAG,CAAa;IAChB,EAAE,CAAkB;IACpB,OAAO,CAAU;IACjB,MAAM,CAAU;IAExB,YACE,GAAe,EACf,EAAmB,EACnB,OAAgB,EAChB,MAAe;QAEf,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAA4B;QAC9C,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;QAC7C,IAAI,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC;QACpB,IAAI,MAAM,GAAG,KAAK,CAAC;QAEnB,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;YACpD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1B,EAAE,CAAC,SAAS,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC3C,CAAC;YACD,EAAE,GAAG,MAAM,mBAAmB,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,cAAc,CAAC,EAAE,CAAC,CAAC;YAC1E,MAAM,GAAG,IAAI,CAAC;QAChB,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,EAAE;YACrD,IAAI,EAAE,WAAW,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;YAC/C,QAAQ,EAAE,WAAW;SACtB,CAAC,CAAC;QAEH,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,WAAW,CAAC,CAAC;QACxC,OAAO,IAAI,YAAY,CAAC,GAAG,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IACpD,CAAC;IAED,yDAAyD;IACzD,YAAY,CAAC,SAAwB,EAAE;QACrC,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IAClD,CAAC;IAED,yDAAyD;IACzD,KAAK,CAAC,OAAO;QACX,OAAO,OAAO,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IACxE,CAAC;IAED,wDAAwD;IACxD,KAAK,CAAC,WAAW,CACf,IAAe,EACf,OAAgC;QAEhC,qEAAqE;QACrE,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACpC,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QACpE,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;IAClE,CAAC;IAED,6BAA6B;IAC7B,QAAQ;QACN,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IAC5B,CAAC;IAED,uBAAuB;IACvB,UAAU;QACR,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;IACxB,CAAC;IAED,0BAA0B;IAC1B,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;QACxB,CAAC;IACH,CAAC;IAED,mCAAmC;IACnC,IAAI,IAAI,KAAiB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3C,IAAI,GAAG,KAAsB,OAAO,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9C,IAAI,QAAQ,KAAc,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;CACjD"}

package/dist/event-processor.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Event Processor — handles ingested events and triggers state transitions.
+ *
+ * When the client calls `blockspool_ingest_event`, this module processes
+ * the event and updates RunState accordingly (phase transitions, counters, etc).
+ */
+import type { DatabaseAdapter } from '@blockspool/core';
+import { RunManager } from './run-manager.js';
+import type { EventType } from './types.js';
+export interface ProcessResult {
+    processed: boolean;
+    phase_changed: boolean;
+    new_phase?: string;
+    message: string;
+}
+export declare function processEvent(run: RunManager, db: DatabaseAdapter, type: EventType, payload: Record<string, unknown>): Promise<ProcessResult>;
+//# sourceMappingURL=event-processor.d.ts.map

package/dist/event-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-processor.d.ts","sourceRoot":"","sources":["../src/event-processor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAExD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,YAAY,CAAC;AAMxD,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,YAAY,CAChC,GAAG,EAAE,UAAU,EACf,EAAE,EAAE,eAAe,EACnB,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,aAAa,CAAC,CAiaxB"}

package/dist/event-processor.js

@@ -0,0 +1,360 @@
+/**
+ * Event Processor — handles ingested events and triggers state transitions.
+ *
+ * When the client calls `blockspool_ingest_event`, this module processes
+ * the event and updates RunState accordingly (phase transitions, counters, etc).
+ */
+import { repos } from '@blockspool/core';
+import { filterAndCreateTickets } from './proposals.js';
+import { deriveScopePolicy, validatePlanScope } from './scope-policy.js';
+import { recordDiff, recordCommandFailure, recordPlanHash } from './spindle.js';
+export async function processEvent(run, db, type, payload) {
+    const s = run.require();
+    switch (type) {
+        // -----------------------------------------------------------------
+        // Scout events
+        // -----------------------------------------------------------------
+        case 'SCOUT_OUTPUT': {
+            if (s.phase !== 'SCOUT') {
+                return { processed: true, phase_changed: false, message: 'Scout output outside SCOUT phase, ignored' };
+            }
+            // Extract proposals from payload
+            const rawProposals = (payload['proposals'] ?? []);
+            if (rawProposals.length === 0) {
+                // No proposals found — done
+                run.setPhase('DONE');
+                return {
+                    processed: true,
+                    phase_changed: true,
+                    new_phase: 'DONE',
+                    message: 'No proposals in scout output, transitioning to DONE',
+                };
+            }
+            // Filter, dedup, score, create tickets
+            const result = await filterAndCreateTickets(run, db, rawProposals);
+            // Save proposals artifact
+            run.saveArtifact(`${s.step_count}-scout-proposals.json`, JSON.stringify({ raw: rawProposals, result }, null, 2));
+            if (result.created_ticket_ids.length > 0) {
+                run.setPhase('NEXT_TICKET');
+                return {
+                    processed: true,
+                    phase_changed: true,
+                    new_phase: 'NEXT_TICKET',
+                    message: `Created ${result.created_ticket_ids.length} tickets from ${rawProposals.length} proposals (${result.rejected.length} rejected)`,
+                };
+            }
+            // All proposals rejected — done
+            run.setPhase('DONE');
+            return {
+                processed: true,
+                phase_changed: true,
+                new_phase: 'DONE',
+                message: `All ${rawProposals.length} proposals rejected: ${result.rejected.map(r => r.reason).join('; ')}`,
+            };
+        }
+        case 'PROPOSALS_FILTERED': {
+            // Legacy event from blockspool_submit_proposals tool.
+            // Check if we have ready tickets now.
+            const readyCount = await repos.tickets.countByStatus(db, s.project_id);
+            const ready = readyCount['ready'] ?? 0;
+            if (ready > 0 && s.phase === 'SCOUT') {
+                run.setPhase('NEXT_TICKET');
+                return {
+                    processed: true,
+                    phase_changed: true,
+                    new_phase: 'NEXT_TICKET',
+                    message: `${ready} tickets ready, transitioning to NEXT_TICKET`,
+                };
+            }
+            if (ready === 0 && s.phase === 'SCOUT') {
+                run.setPhase('DONE');
+                return {
+                    processed: true,
+                    phase_changed: true,
+                    new_phase: 'DONE',
+                    message: 'No proposals accepted, transitioning to DONE',
+                };
+            }
+            return { processed: true, phase_changed: false, message: 'Proposals filtered' };
+        }
+        // -----------------------------------------------------------------
+        // Plan events
+        // -----------------------------------------------------------------
+        case 'PLAN_SUBMITTED': {
+            if (s.phase !== 'PLAN') {
+                return { processed: true, phase_changed: false, message: 'Plan submitted outside PLAN phase, ignored' };
+            }
+            const raw = payload;
+            // Coerce files_to_touch if Claude sends plain strings instead of objects
+            const rawFiles = Array.isArray(raw.files_to_touch) ? raw.files_to_touch : [];
+            const files_to_touch = rawFiles.map((f) => {
+                if (typeof f === 'string')
+                    return { path: f, action: 'modify', reason: '' };
+                if (f && typeof f === 'object' && 'path' in f)
+                    return f;
+                return { path: String(f), action: 'modify', reason: '' };
+            });
+            const plan = {
+                ticket_id: String(raw.ticket_id ?? s.current_ticket_id ?? ''),
+                files_to_touch,
+                expected_tests: Array.isArray(raw.expected_tests) ? raw.expected_tests.map(String) : [],
+                risk_level: (raw.risk_level === 'low' || raw.risk_level === 'medium' || raw.risk_level === 'high')
+                    ? raw.risk_level : 'low',
+                estimated_lines: typeof raw.estimated_lines === 'number' ? raw.estimated_lines : 50,
+            };
+            // Derive scope policy for the current ticket
+            const ticket = s.current_ticket_id
+                ? await repos.tickets.getById(db, s.current_ticket_id)
+                : null;
+            const policy = deriveScopePolicy({
+                allowedPaths: ticket?.allowedPaths ?? [],
+                category: ticket?.category ?? 'refactor',
+                maxLinesPerTicket: s.max_lines_per_ticket,
+            });
+            // Validate plan against scope policy
+            const scopeResult = validatePlanScope(plan.files_to_touch, plan.estimated_lines, plan.risk_level, policy);
+            if (!scopeResult.valid) {
+                s.plan_rejections++;
+                run.appendEvent('PLAN_REJECTED', { reason: scopeResult.reason, attempt: s.plan_rejections });
+                return {
+                    processed: true,
+                    phase_changed: false,
+                    message: `Plan rejected: ${scopeResult.reason} (attempt ${s.plan_rejections}/${3})`,
+                };
+            }
+            // Plan passed validation
+            s.current_ticket_plan = plan;
+            recordPlanHash(s.spindle, plan);
+            // High-risk plans → BLOCKED_NEEDS_HUMAN
+            if (plan.risk_level === 'high') {
+                run.appendEvent('PLAN_REJECTED', { reason: 'High-risk plan requires human approval', risk_level: 'high' });
+                run.setPhase('BLOCKED_NEEDS_HUMAN');
+                return {
+                    processed: true,
+                    phase_changed: true,
+                    new_phase: 'BLOCKED_NEEDS_HUMAN',
+                    message: 'High-risk plan requires human approval',
+                };
+            }
+            // Low/medium risk — auto-approve
+            s.plan_approved = true;
+            run.appendEvent('PLAN_APPROVED', { risk_level: plan.risk_level, auto: true });
+            run.setPhase('EXECUTE');
+            return {
+                processed: true,
+                phase_changed: true,
+                new_phase: 'EXECUTE',
+                message: `${plan.risk_level}-risk plan auto-approved, moving to EXECUTE`,
+            };
+        }
+        // -----------------------------------------------------------------
+        // Execution events
+        // -----------------------------------------------------------------
+        case 'TICKET_RESULT': {
+            if (s.phase !== 'EXECUTE') {
+                return { processed: true, phase_changed: false, message: 'Ticket result outside EXECUTE phase' };
+            }
+            const status = payload['status'];
+            if (status === 'done') {
+                // Validate changed_files against plan (if plan exists)
+                const changedFiles = (payload['changed_files'] ?? []);
+                const linesAdded = (payload['lines_added'] ?? 0);
+                const linesRemoved = (payload['lines_removed'] ?? 0);
+                const totalLines = linesAdded + linesRemoved;
+                // Save ticket result artifact
+                run.saveArtifact(`${s.step_count}-ticket-result.json`, JSON.stringify({
+                    status,
+                    changed_files: changedFiles,
+                    lines_added: linesAdded,
+                    lines_removed: linesRemoved,
+                    summary: payload['summary'],
+                }, null, 2));
+                // Validate changed files against approved plan
+                if (s.current_ticket_plan) {
+                    const plannedPaths = new Set(s.current_ticket_plan.files_to_touch.map(f => f.path));
+                    const surpriseFiles = changedFiles.filter(f => !plannedPaths.has(f));
+                    if (surpriseFiles.length > 0) {
+                        run.appendEvent('SCOPE_BLOCKED', {
+                            ticket_id: s.current_ticket_id,
+                            surprise_files: surpriseFiles,
+                            planned_files: [...plannedPaths],
+                        });
+                        return {
+                            processed: true,
+                            phase_changed: false,
+                            message: `Changed files not in plan: ${surpriseFiles.join(', ')}. Revert those changes and re-submit.`,
+                        };
+                    }
+                    // Validate lines against budget
+                    if (totalLines > s.max_lines_per_ticket) {
+                        return {
+                            processed: true,
+                            phase_changed: false,
+                            message: `Lines changed (${totalLines}) exceeds budget (${s.max_lines_per_ticket}). Reduce changes.`,
+                        };
+                    }
+                }
+                // Track lines
+                s.total_lines_changed += totalLines;
+                // Update spindle state with diff info
+                const diff = (payload['diff'] ?? null);
+                recordDiff(s.spindle, diff ?? (changedFiles.length > 0 ? changedFiles.join('\n') : null));
+                // Move to QA
+                run.setPhase('QA');
+                return {
+                    processed: true,
+                    phase_changed: true,
+                    new_phase: 'QA',
+                    message: `Ticket result accepted (${changedFiles.length} files, ${totalLines} lines), moving to QA`,
+                };
+            }
+            if (status === 'failed') {
+                // Fail the ticket, move to next
+                if (s.current_ticket_id) {
+                    await repos.tickets.updateStatus(db, s.current_ticket_id, 'blocked');
+                    run.failTicket(payload['reason'] ?? 'Execution failed');
+                }
+                run.setPhase('NEXT_TICKET');
+                return {
+                    processed: true,
+                    phase_changed: true,
+                    new_phase: 'NEXT_TICKET',
+                    message: 'Ticket failed, moving to NEXT_TICKET',
+                };
+            }
+            return { processed: true, phase_changed: false, message: `Ticket result: ${status}` };
+        }
+        // -----------------------------------------------------------------
+        // QA events
+        // -----------------------------------------------------------------
+        case 'QA_COMMAND_RESULT': {
+            if (s.phase !== 'QA') {
+                return { processed: true, phase_changed: false, message: 'QA command result outside QA phase' };
+            }
+            const command = payload['command'];
+            const success = payload['success'];
+            const output = (payload['output'] ?? '');
+            // Record command failure in spindle state
+            if (!success) {
+                recordCommandFailure(s.spindle, command, output);
+            }
+            // Save command output as artifact
+            const cmdSlug = command.replace(/[^a-z0-9]/gi, '-').slice(0, 30);
+            run.saveArtifact(`${s.step_count}-qa-${cmdSlug}-${success ? 'pass' : 'fail'}.log`, `$ ${command}\n\n${output}`);
+            return {
+                processed: true,
+                phase_changed: false,
+                message: `QA command ${success ? 'passed' : 'failed'}: ${command}`,
+            };
+        }
+        case 'QA_PASSED': {
+            if (s.phase !== 'QA') {
+                return { processed: true, phase_changed: false, message: 'QA passed outside QA phase' };
+            }
+            // Mark ticket done in DB
+            if (s.current_ticket_id) {
+                await repos.tickets.updateStatus(db, s.current_ticket_id, 'done');
+            }
+            // Save QA summary artifact
+            run.saveArtifact(`${s.step_count}-qa-summary.json`, JSON.stringify({
+                ticket_id: s.current_ticket_id,
+                status: 'passed',
+                attempt: s.qa_retries + 1,
+                ...payload,
+            }, null, 2));
+            // Move to PR
+            run.setPhase('PR');
+            return {
+                processed: true,
+                phase_changed: true,
+                new_phase: 'PR',
+                message: 'QA passed, moving to PR',
+            };
+        }
+        case 'QA_FAILED': {
+            if (s.phase !== 'QA') {
+                return { processed: true, phase_changed: false, message: 'QA failed outside QA phase' };
+            }
+            // Record QA failure in spindle (for stall detection — no progress)
+            recordDiff(s.spindle, null);
+            // Save failure artifact
+            run.saveArtifact(`${s.step_count}-qa-failed-attempt-${s.qa_retries + 1}.json`, JSON.stringify({
+                ticket_id: s.current_ticket_id,
+                attempt: s.qa_retries + 1,
+                ...payload,
+            }, null, 2));
+            s.qa_retries++;
+            if (s.qa_retries >= 3) {
+                // Give up on this ticket
+                if (s.current_ticket_id) {
+                    await repos.tickets.updateStatus(db, s.current_ticket_id, 'blocked');
+                    run.failTicket(`QA failed ${s.qa_retries} times`);
+                }
+                run.setPhase('NEXT_TICKET');
+                return {
+                    processed: true,
+                    phase_changed: true,
+                    new_phase: 'NEXT_TICKET',
+                    message: `QA failed ${s.qa_retries} times, giving up on ticket`,
+                };
+            }
+            // Retry: go back to EXECUTE to fix
+            run.setPhase('EXECUTE');
+            return {
+                processed: true,
+                phase_changed: true,
+                new_phase: 'EXECUTE',
+                message: `QA failed (attempt ${s.qa_retries}/3), retrying execution`,
+            };
+        }
+        // -----------------------------------------------------------------
+        // PR events
+        // -----------------------------------------------------------------
+        case 'PR_CREATED': {
+            if (s.phase !== 'PR') {
+                return { processed: true, phase_changed: false, message: 'PR created outside PR phase' };
+            }
+            // Save PR artifact
+            run.saveArtifact(`${s.step_count}-pr-created.json`, JSON.stringify({
+                ticket_id: s.current_ticket_id,
+                pr_number: s.prs_created + 1,
+                ...payload,
+            }, null, 2));
+            s.prs_created++;
+            run.completeTicket();
+            run.appendEvent('PR_CREATED', payload);
+            run.setPhase('NEXT_TICKET');
+            return {
+                processed: true,
+                phase_changed: true,
+                new_phase: 'NEXT_TICKET',
+                message: `PR created (${s.prs_created}/${s.max_prs}), moving to NEXT_TICKET`,
+            };
+        }
+        // -----------------------------------------------------------------
+        // User overrides
+        // -----------------------------------------------------------------
+        case 'USER_OVERRIDE': {
+            if (typeof payload['hint'] === 'string') {
+                run.addHint(payload['hint']);
+                return { processed: true, phase_changed: false, message: 'Hint added' };
+            }
+            if (payload['cancel'] === true) {
+                run.setPhase('DONE');
+                return {
+                    processed: true,
+                    phase_changed: true,
+                    new_phase: 'DONE',
+                    message: 'Session cancelled by user',
+                };
+            }
+            return { processed: true, phase_changed: false, message: 'User override recorded' };
+        }
+        // -----------------------------------------------------------------
+        // Default: just record
+        // -----------------------------------------------------------------
+        default:
+            return { processed: true, phase_changed: false, message: `Event ${type} recorded` };
+    }
+}
+//# sourceMappingURL=event-processor.js.map

package/dist/event-processor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-processor.js","sourceRoot":"","sources":["../src/event-processor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAGzC,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAExD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAgB,UAAU,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAS9F,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,GAAe,EACf,EAAmB,EACnB,IAAe,EACf,OAAgC;IAEhC,MAAM,CAAC,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC;IAExB,QAAQ,IAAI,EAAE,CAAC;QACb,oEAAoE;QACpE,eAAe;QACf,oEAAoE;QACpE,KAAK,cAAc,CAAC,CAAC,CAAC;YACpB,IAAI,CAAC,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC;gBACxB,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,EAAE,2CAA2C,EAAE,CAAC;YACzG,CAAC;YAED,iCAAiC;YACjC,MAAM,YAAY,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,EAAE,CAAkB,CAAC;YACnE,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC9B,4BAA4B;gBAC5B,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;gBACrB,OAAO;oBACL,SAAS,EAAE,IAAI;oBACf,aAAa,EAAE,IAAI;oBACnB,SAAS,EAAE,MAAM;oBACjB,OAAO,EAAE,qDAAqD;iBAC/D,CAAC;YACJ,CAAC;YAED,uCAAuC;YACvC,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC,GAAG,EAAE,EAAE,EAAE,YAAY,CAAC,CAAC;YAEnE,0BAA0B;YAC1B,GAAG,CAAC,YAAY,CACd,GAAG,CAAC,CAAC,UAAU,uBAAuB,EACtC,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CACvD,CAAC;YAEF,IAAI,MAAM,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzC,GAAG,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;gBAC5B,OAAO;oBACL,SAAS,EAAE,IAAI;oBACf,aAAa,EAAE,IAAI;oBACnB,SAAS,EAAE,aAAa;oBACxB,OAAO,EAAE,WAAW,MAAM,CAAC,kBAAkB,CAAC,MAAM,iBAAiB,YAAY,CAAC,MAAM,eAAe,MAAM,CAAC,QAAQ,CAAC,MAAM,YAAY;iBAC1I,CAAC;YACJ,CAAC;YAED,gCAAgC;YAChC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YACrB,OAAO;gBACL,SAAS,EAAE,IAAI;gBACf,aAAa,EAAE,IAAI;gBACnB,SAAS,EAAE,MAAM;gBACjB,OAAO,EAAE,OAAO,YAAY,CAAC,MAAM,wBAAwB,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;aAC3G,CAAC;QACJ,CAAC;QAED,KAAK,oBAAoB,CAAC,CAAC,CAAC;YAC1B,sDAAsD;YACtD,sCAAsC;YACtC,MAAM,UAAU,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC;YACvE,MAAM,KAAK,GAAI,UAAqC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACnE,IAAI,KAAK,GAAG,CAAC,IAAI,CAAC,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC;gBACrC,GAAG,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;gBAC5B,OAAO;oBACL,SAAS,EAAE,IAAI;oBACf,aAAa,EAAE,IAAI;oBACnB,SAAS,EAAE,aAAa;oBACxB,OAAO,EAAE,GAAG,KAAK,8CAA8C;iBAChE,CAAC;YACJ,CAAC;YACD,IAAI,KAAK,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC;gBACvC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;gBACrB,OAAO;oBACL,SAAS,EAAE,IAAI;oBACf,aAAa,EAAE,IAAI;oBACnB,SAAS,EAAE,MAAM;oBACjB,OAAO,EAAE,8CAA8C;iBACxD,CAAC;YACJ,CAAC;YACD,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,EAAE,oBAAoB,EAAE,CAAC;QAClF,CAAC;QAED,oEAAoE;QACpE,cAAc;QACd,oEAAoE;QACpE,KAAK,gBAAgB,CAAC,CAAC,CAAC;YACtB,IAAI,CAAC,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;gBACvB,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,EAAE,4CAA4C,EAAE,CAAC;YAC1G,CAAC;YAED,MAAM,GAAG,GAAG,OAAkC,CAAC;YAC/C,yEAAyE;YACzE,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7E,MAAM,cAAc,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAU,EAAE,EAAE;gBACjD,IAAI,OAAO,CAAC,KAAK,QAAQ;oBAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,QAAiB,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;gBACrF,IAAI,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,IAAI,CAAC;oBAAE,OAAO,CAA6E,CAAC;gBACpI,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,QAAiB,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;YACpE,CAAC,CAAC,CAAC;YACH,MAAM,IAAI,GAAe;gBACvB,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,SAAS,IAAI,CAAC,CAAC,iBAAiB,IAAI,EAAE,CAAC;gBAC7D,cAAc;gBACd,cAAc,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE;gBACvF,UAAU,EAAE,CAAC,GAAG,CAAC,UAAU,KAAK,KAAK,IAAI,GAAG,CAAC,UAAU,KAAK,QAAQ,IAAI,GAAG,CAAC,UAAU,KAAK,MAAM,CAAC;oBAChG,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK;gBAC1B,eAAe,EAAE,OAAO,GAAG,CAAC,eAAe,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE;aACpF,CAAC;YAEF,6CAA6C;YAC7C,MAAM,MAAM,GAAG,CAAC,CAAC,iBAAiB;gBAChC,CAAC,CAAC,MAAM,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,iBAAiB,CAAC;gBACtD,CAAC,CAAC,IAAI,CAAC;YAET,MAAM,MAAM,GAAG,iBAAiB,CAAC;gBAC/B,YAAY,EAAE,MAAM,EAAE,YAAY,IAAI,EAAE;gBACxC,QAAQ,EAAE,MAAM,EAAE,QAAQ,IAAI,UAAU;gBACxC,iBAAiB,EAAE,CAAC,CAAC,oBAAoB;aAC1C,CAAC,CAAC;YAEH,qCAAqC;YACrC,MAAM,WAAW,GAAG,iBAAiB,CACnC,IAAI,CAAC,cAAc,EACnB,IAAI,CAAC,eAAe,EACpB,IAAI,CAAC,UAAU,EACf,MAAM,CACP,CAAC;YAEF,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;gBACvB,CAAC,CAAC,eAAe,EAAE,CAAC;gBACpB,GAAG,CAAC,WAAW,CAAC,eAAe,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC;gBAC7F,OAAO;oBACL,SAAS,EAAE,IAAI;oBACf,aAAa,EAAE,KAAK;oBACpB,OAAO,EAAE,kBAAkB,WAAW,CAAC,MAAM,aAAa,CAAC,CAAC,eAAe,IAAI,CAAC,GAAG;iBACpF,CAAC;YACJ,CAAC;YAED,yBAAyB;YACzB,CAAC,CAAC,mBAAmB,GAAG,IAAI,CAAC;YAC7B,cAAc,CAAC,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YAEhC,wCAAwC;YACxC,IAAI,IAAI,CAAC,UAAU,KAAK,MAAM,EAAE,CAAC;gBAC/B,GAAG,CAAC,WAAW,CAAC,eAAe,EAAE,EAAE,MAAM,EAAE,wCAAwC,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;gBAC3G,GAAG,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAC;gBACpC,OAAO;oBACL,SAAS,EAAE,IAAI;oBACf,aAAa,EAAE,IAAI;oBACnB,SAAS,EAAE,qBAAqB;oBAChC,OAAO,EAAE,wCAAwC;iBAClD,CAAC;YACJ,CAAC;YAED,iCAAiC;YACjC,CAAC,CAAC,aAAa,GAAG,IAAI,CAAC;YACvB,GAAG,CAAC,WAAW,CAAC,eAAe,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAC9E,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;YACxB,OAAO;gBACL,SAAS,EAAE,IAAI;gBACf,aAAa,EAAE,IAAI;gBACnB,SAAS,EAAE,SAAS;gBACpB,OAAO,EAAE,GAAG,IAAI,CAAC,UAAU,6CAA6C;aACzE,CAAC;QACJ,CAAC;QAED,oEAAoE;QACpE,mBAAmB;QACnB,oEAAoE;QACpE,KAAK,eAAe,CAAC,CAAC,CAAC;YACrB,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBAC1B,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,EAAE,qCAAqC,EAAE,CAAC;YACnG,CAAC;YAED,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAW,CAAC;YAE3C,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;gBACtB,uDAAuD;gBACvD,MAAM,YAAY,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC,IAAI,EAAE,CAAa,CAAC;gBAClE,MAAM,UAAU,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,CAAW,CAAC;gBAC3D,MAAM,YAAY,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,CAAW,CAAC;gBAC/D,MAAM,UAAU,GAAG,UAAU,GAAG,YAAY,CAAC;gBAE7C,8BAA8B;gBAC9B,GAAG,CAAC,YAAY,CACd,GAAG,CAAC,CAAC,UAAU,qBAAqB,EACpC,IAAI,CAAC,SAAS,CAAC;oBACb,MAAM;oBACN,aAAa,EAAE,YAAY;oBAC3B,WAAW,EAAE,UAAU;oBACvB,aAAa,EAAE,YAAY;oBAC3B,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC;iBAC5B,EAAE,IAAI,EAAE,CAAC,CAAC,CACZ,CAAC;gBAEF,+CAA+C;gBAC/C,IAAI,CAAC,CAAC,mBAAmB,EAAE,CAAC;oBAC1B,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,mBAAmB,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;oBACpF,MAAM,aAAa,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;oBAErE,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBAC7B,GAAG,CAAC,WAAW,CAAC,eAAe,EAAE;4BAC/B,SAAS,EAAE,CAAC,CAAC,iBAAiB;4BAC9B,cAAc,EAAE,aAAa;4BAC7B,aAAa,EAAE,CAAC,GAAG,YAAY,CAAC;yBACjC,CAAC,CAAC;wBACH,OAAO;4BACL,SAAS,EAAE,IAAI;4BACf,aAAa,EAAE,KAAK;4BACpB,OAAO,EAAE,8BAA8B,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,uCAAuC;yBACvG,CAAC;oBACJ,CAAC;oBAED,gCAAgC;oBAChC,IAAI,UAAU,GAAG,CAAC,CAAC,oBAAoB,EAAE,CAAC;wBACxC,OAAO;4BACL,SAAS,EAAE,IAAI;4BACf,aAAa,EAAE,KAAK;4BACpB,OAAO,EAAE,kBAAkB,UAAU,qBAAqB,CAAC,CAAC,oBAAoB,oBAAoB;yBACrG,CAAC;oBACJ,CAAC;gBACH,CAAC;gBAED,cAAc;gBACd,CAAC,CAAC,mBAAmB,IAAI,UAAU,CAAC;gBAEpC,sCAAsC;gBACtC,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,IAAI,CAAkB,CAAC;gBACxD,UAAU,CAAC,CAAC,CAAC,OAAO,EAAE,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;gBAE1F,aAAa;gBACb,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;gBACnB,OAAO;oBACL,SAAS,EAAE,IAAI;oBACf,aAAa,EAAE,IAAI;oBACnB,SAAS,EAAE,IAAI;oBACf,OAAO,EAAE,2BAA2B,YAAY,CAAC,MAAM,WAAW,UAAU,uBAAuB;iBACpG,CAAC;YACJ,CAAC;YAED,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;gBACxB,gCAAgC;gBAChC,IAAI,CAAC,CAAC,iBAAiB,EAAE,CAAC;oBACxB,MAAM,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,EAAE,CAAC,CAAC,iBAAiB,EAAE,SAAS,CAAC,CAAC;oBACrE,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAW,IAAI,kBAAkB,CAAC,CAAC;gBACpE,CAAC;gBACD,GAAG,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;gBAC5B,OAAO;oBACL,SAAS,EAAE,IAAI;oBACf,aAAa,EAAE,IAAI;oBACnB,SAAS,EAAE,aAAa;oBACxB,OAAO,EAAE,sCAAsC;iBAChD,CAAC;YACJ,CAAC;YAED,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,EAAE,kBAAkB,MAAM,EAAE,EAAE,CAAC;QACxF,CAAC;QAED,oEAAoE;QACpE,YAAY;QACZ,oEAAoE;QACpE,KAAK,mBAAmB,CAAC,CAAC,CAAC;YACzB,IAAI,CAAC,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;gBACrB,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,EAAE,oCAAoC,EAAE,CAAC;YAClG,CAAC;YAED,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,CAAW,CAAC;YAC7C,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,CAAY,CAAC;YAC9C,MAAM,MAAM,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAW,CAAC;YAEnD,0CAA0C;YAC1C,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,oBAAoB,CAAC,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;YACnD,CAAC;YAED,kCAAkC;YAClC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACjE,GAAG,CAAC,YAAY,CACd,GAAG,CAAC,CAAC,UAAU,OAAO,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,MAAM,EAChE,KAAK,OAAO,OAAO,MAAM,EAAE,CAC5B,CAAC;YAEF,OAAO;gBACL,SAAS,EAAE,IAAI;gBACf,aAAa,EAAE,KAAK;gBACpB,OAAO,EAAE,cAAc,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,EAAE;aACnE,CAAC;QACJ,CAAC;QAED,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,IAAI,CAAC,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;gBACrB,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,EAAE,4BAA4B,EAAE,CAAC;YAC1F,CAAC;YAED,yBAAyB;YACzB,IAAI,CAAC,CAAC,iBAAiB,EAAE,CAAC;gBACxB,MAAM,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,EAAE,CAAC,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC;YACpE,CAAC;YAED,2BAA2B;YAC3B,GAAG,CAAC,YAAY,CACd,GAAG,CAAC,CAAC,UAAU,kBAAkB,EACjC,IAAI,CAAC,SAAS,CAAC;gBACb,SAAS,EAAE,CAAC,CAAC,iBAAiB;gBAC9B,MAAM,EAAE,QAAQ;gBAChB,OAAO,EAAE,CAAC,CAAC,UAAU,GAAG,CAAC;gBACzB,GAAG,OAAO;aACX,EAAE,IAAI,EAAE,CAAC,CAAC,CACZ,CAAC;YAEF,aAAa;YACb,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YACnB,OAAO;gBACL,SAAS,EAAE,IAAI;gBACf,aAAa,EAAE,IAAI;gBACnB,SAAS,EAAE,IAAI;gBACf,OAAO,EAAE,yBAAyB;aACnC,CAAC;QACJ,CAAC;QAED,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,IAAI,CAAC,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;gBACrB,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,EAAE,4BAA4B,EAAE,CAAC;YAC1F,CAAC;YAED,mEAAmE;YACnE,UAAU,CAAC,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YAE5B,wBAAwB;YACxB,GAAG,CAAC,YAAY,CACd,GAAG,CAAC,CAAC,UAAU,sBAAsB,CAAC,CAAC,UAAU,GAAG,CAAC,OAAO,EAC5D,IAAI,CAAC,SAAS,CAAC;gBACb,SAAS,EAAE,CAAC,CAAC,iBAAiB;gBAC9B,OAAO,EAAE,CAAC,CAAC,UAAU,GAAG,CAAC;gBACzB,GAAG,OAAO;aACX,EAAE,IAAI,EAAE,CAAC,CAAC,CACZ,CAAC;YAEF,CAAC,CAAC,UAAU,EAAE,CAAC;YAEf,IAAI,CAAC,CAAC,UAAU,IAAI,CAAC,EAAE,CAAC;gBACtB,yBAAyB;gBACzB,IAAI,CAAC,CAAC,iBAAiB,EAAE,CAAC;oBACxB,MAAM,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,EAAE,CAAC,CAAC,iBAAiB,EAAE,SAAS,CAAC,CAAC;oBACrE,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,UAAU,QAAQ,CAAC,CAAC;gBACpD,CAAC;gBACD,GAAG,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;gBAC5B,OAAO;oBACL,SAAS,EAAE,IAAI;oBACf,aAAa,EAAE,IAAI;oBACnB,SAAS,EAAE,aAAa;oBACxB,OAAO,EAAE,aAAa,CAAC,CAAC,UAAU,6BAA6B;iBAChE,CAAC;YACJ,CAAC;YAED,mCAAmC;YACnC,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;YACxB,OAAO;gBACL,SAAS,EAAE,IAAI;gBACf,aAAa,EAAE,IAAI;gBACnB,SAAS,EAAE,SAAS;gBACpB,OAAO,EAAE,sBAAsB,CAAC,CAAC,UAAU,yBAAyB;aACrE,CAAC;QACJ,CAAC;QAED,oEAAoE;QACpE,YAAY;QACZ,oEAAoE;QACpE,KAAK,YAAY,CAAC,CAAC,CAAC;YAClB,IAAI,CAAC,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;gBACrB,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,EAAE,6BAA6B,EAAE,CAAC;YAC3F,CAAC;YAED,mBAAmB;YACnB,GAAG,CAAC,YAAY,CACd,GAAG,CAAC,CAAC,UAAU,kBAAkB,EACjC,IAAI,CAAC,SAAS,CAAC;gBACb,SAAS,EAAE,CAAC,CAAC,iBAAiB;gBAC9B,SAAS,EAAE,CAAC,CAAC,WAAW,GAAG,CAAC;gBAC5B,GAAG,OAAO;aACX,EAAE,IAAI,EAAE,CAAC,CAAC,CACZ,CAAC;YAEF,CAAC,CAAC,WAAW,EAAE,CAAC;YAChB,GAAG,CAAC,cAAc,EAAE,CAAC;YACrB,GAAG,CAAC,WAAW,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YACvC,GAAG,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;YAC5B,OAAO;gBACL,SAAS,EAAE,IAAI;gBACf,aAAa,EAAE,IAAI;gBACnB,SAAS,EAAE,aAAa;gBACxB,OAAO,EAAE,eAAe,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,OAAO,0BAA0B;aAC7E,CAAC;QACJ,CAAC;QAED,oEAAoE;QACpE,iBAAiB;QACjB,oEAAoE;QACpE,KAAK,eAAe,CAAC,CAAC,CAAC;YACrB,IAAI,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,QAAQ,EAAE,CAAC;gBACxC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAW,CAAC,CAAC;gBACvC,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC;YAC1E,CAAC;YACD,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC;gBAC/B,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;gBACrB,OAAO;oBACL,SAAS,EAAE,IAAI;oBACf,aAAa,EAAE,IAAI;oBACnB,SAAS,EAAE,MAAM;oBACjB,OAAO,EAAE,2BAA2B;iBACrC,CAAC;YACJ,CAAC;YACD,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,EAAE,wBAAwB,EAAE,CAAC;QACtF,CAAC;QAED,oEAAoE;QACpE,uBAAuB;QACvB,oEAAoE;QACpE;YACE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,IAAI,WAAW,EAAE,CAAC;IACxF,CAAC;AACH,CAAC"}

package/dist/formulas.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Formulas — typed, versioned, testable sweep recipes.
+ *
+ * A formula configures what a scout session looks for and how strictly
+ * it gates execution. Built-in formulas mirror the CLI's set; users can
+ * add custom formulas in `.blockspool/formulas/` as simple YAML files.
+ */
+import type { SessionConfig } from './types.js';
+export interface Formula {
+    name: string;
+    version: number;
+    description: string;
+    scope?: string;
+    categories?: string[];
+    min_confidence?: number;
+    prompt?: string;
+    max_prs?: number;
+    model?: string;
+    risk_tolerance?: 'low' | 'medium' | 'high';
+    tags?: string[];
+}
+export declare const BUILTIN_FORMULAS: Formula[];
+/**
+ * Load a formula by name.
+ * Search order: user formulas in `.blockspool/formulas/`, then built-ins.
+ */
+export declare function loadFormula(name: string, projectPath?: string): Formula | null;
+/**
+ * List all available formulas (user + built-in, user overrides built-in).
+ */
+export declare function listFormulas(projectPath?: string): Formula[];
+/**
+ * Apply a formula's settings to a SessionConfig.
+ * Formula values are defaults — explicit config values take precedence.
+ */
+export declare function applyFormula(formula: Formula, config: SessionConfig): SessionConfig;
+//# sourceMappingURL=formulas.d.ts.map

package/dist/formulas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formulas.d.ts","sourceRoot":"","sources":["../src/formulas.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAMhD,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC3C,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAMD,eAAO,MAAM,gBAAgB,EAAE,OAAO,EA8FrC,CAAC;AAMF;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAI9E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,EAAE,CAK5D;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,GAAG,aAAa,CAUnF"}