@blockspool/mcp 0.3.0

package/dist/formulas.js

@@ -0,0 +1,245 @@
+/**
+ * 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 * as fs from 'node:fs';
+import * as path from 'node:path';
+// ---------------------------------------------------------------------------
+// Built-in Formulas
+// ---------------------------------------------------------------------------
+export const BUILTIN_FORMULAS = [
+    {
+        name: 'security-audit',
+        version: 1,
+        description: 'Find and fix security vulnerabilities',
+        categories: ['security'],
+        min_confidence: 80,
+        risk_tolerance: 'low',
+        prompt: [
+            'Look for OWASP Top 10 vulnerabilities, insecure defaults,',
+            'missing input validation, credential exposure, and injection risks.',
+            'Focus on real vulnerabilities, not style issues.',
+        ].join(' '),
+        max_prs: 10,
+        tags: ['security'],
+    },
+    {
+        name: 'test-coverage',
+        version: 1,
+        description: 'Add missing unit tests for untested code',
+        categories: ['test'],
+        min_confidence: 70,
+        risk_tolerance: 'medium',
+        prompt: [
+            'Find functions and modules with no test coverage.',
+            'Write focused unit tests with edge cases.',
+            'Prioritize business logic over utility functions.',
+        ].join(' '),
+        max_prs: 15,
+        tags: ['quality'],
+    },
+    {
+        name: 'type-safety',
+        version: 1,
+        description: 'Strengthen TypeScript types and remove any/unknown',
+        categories: ['types'],
+        min_confidence: 75,
+        risk_tolerance: 'medium',
+        prompt: [
+            'Find uses of any, unknown, or weak typing.',
+            'Add proper type annotations, interfaces, and type guards.',
+            'Do not change runtime behavior.',
+        ].join(' '),
+        max_prs: 10,
+        tags: ['quality'],
+    },
+    {
+        name: 'cleanup',
+        version: 1,
+        description: 'Remove dead code, unused imports, and stale comments',
+        categories: ['refactor'],
+        min_confidence: 85,
+        risk_tolerance: 'low',
+        prompt: [
+            'Find dead code, unused imports, unreachable branches,',
+            'commented-out code, and stale TODO comments.',
+            'Only remove things that are clearly unused.',
+        ].join(' '),
+        max_prs: 10,
+        tags: ['cleanup'],
+    },
+    {
+        name: 'deep',
+        version: 1,
+        description: 'Find high-impact structural and architectural improvements',
+        categories: ['refactor', 'perf', 'security'],
+        min_confidence: 60,
+        risk_tolerance: 'high',
+        model: 'opus',
+        max_prs: 5,
+        prompt: [
+            'Principal engineer architecture review. Ignore trivial issues.',
+            'Focus on: leaky abstractions, silent error swallowing, coupling/circular deps,',
+            'mixed concerns (business logic + I/O), algorithmic perf issues,',
+            'missing security boundaries, brittle integration points.',
+            'Prefer moderate/complex complexity. Set impact_score 1-10.',
+        ].join(' '),
+        tags: ['architecture', 'deep'],
+    },
+    {
+        name: 'docs',
+        version: 1,
+        description: 'Add or improve documentation for public APIs',
+        categories: ['docs'],
+        min_confidence: 70,
+        risk_tolerance: 'medium',
+        prompt: [
+            'Find exported functions, classes, and types missing JSDoc.',
+            'Add clear, concise documentation that explains the purpose,',
+            'parameters, and return values. Do not over-document obvious code.',
+        ].join(' '),
+        max_prs: 10,
+        tags: ['docs'],
+    },
+];
+// ---------------------------------------------------------------------------
+// Loader
+// ---------------------------------------------------------------------------
+/**
+ * Load a formula by name.
+ * Search order: user formulas in `.blockspool/formulas/`, then built-ins.
+ */
+export function loadFormula(name, projectPath) {
+    const userFormula = loadUserFormula(name, projectPath);
+    if (userFormula)
+        return userFormula;
+    return BUILTIN_FORMULAS.find(f => f.name === name) ?? null;
+}
+/**
+ * List all available formulas (user + built-in, user overrides built-in).
+ */
+export function listFormulas(projectPath) {
+    const userFormulas = loadAllUserFormulas(projectPath);
+    const userNames = new Set(userFormulas.map(f => f.name));
+    const builtins = BUILTIN_FORMULAS.filter(f => !userNames.has(f.name));
+    return [...userFormulas, ...builtins];
+}
+/**
+ * Apply a formula's settings to a SessionConfig.
+ * Formula values are defaults — explicit config values take precedence.
+ */
+export function applyFormula(formula, config) {
+    return {
+        ...config,
+        scope: config.scope ?? formula.scope,
+        categories: config.categories ?? formula.categories,
+        min_confidence: config.min_confidence ?? formula.min_confidence,
+        max_prs: config.max_prs ?? formula.max_prs,
+        // formula name stays as-is for prompt injection
+        formula: config.formula,
+    };
+}
+// ---------------------------------------------------------------------------
+// User formulas (YAML)
+// ---------------------------------------------------------------------------
+function getFormulasDir(projectPath) {
+    const base = projectPath ?? process.cwd();
+    return path.join(base, '.blockspool', 'formulas');
+}
+function loadUserFormula(name, projectPath) {
+    const dir = getFormulasDir(projectPath);
+    for (const ext of ['.yaml', '.yml']) {
+        const filePath = path.join(dir, `${name}${ext}`);
+        if (fs.existsSync(filePath)) {
+            return parseFormulaFile(filePath, name);
+        }
+    }
+    return null;
+}
+function loadAllUserFormulas(projectPath) {
+    const dir = getFormulasDir(projectPath);
+    if (!fs.existsSync(dir))
+        return [];
+    const files = fs.readdirSync(dir).filter(f => f.endsWith('.yaml') || f.endsWith('.yml'));
+    const formulas = [];
+    for (const file of files) {
+        const name = path.basename(file, path.extname(file));
+        const formula = parseFormulaFile(path.join(dir, file), name);
+        if (formula)
+            formulas.push(formula);
+    }
+    return formulas;
+}
+function parseFormulaFile(filePath, name) {
+    try {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        const parsed = parseSimpleYaml(content);
+        return {
+            name,
+            version: parsed.version ? parseInt(parsed.version, 10) : 1,
+            description: parsed.description || `Formula: ${name}`,
+            scope: parsed.scope,
+            categories: parsed.categories ? parseStringList(parsed.categories) : undefined,
+            min_confidence: parsed.min_confidence ? parseInt(parsed.min_confidence, 10) : undefined,
+            prompt: parsed.prompt,
+            max_prs: parsed.max_prs ? parseInt(parsed.max_prs, 10) : undefined,
+            model: parsed.model,
+            risk_tolerance: parsed.risk_tolerance,
+            tags: parsed.tags ? parseStringList(parsed.tags) : undefined,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+// ---------------------------------------------------------------------------
+// Simple YAML parser (avoids external dependency)
+// ---------------------------------------------------------------------------
+function parseSimpleYaml(content) {
+    const result = {};
+    const lines = content.split('\n');
+    let currentKey = null;
+    let multilineValue = [];
+    let multilineIndent = 0;
+    for (const line of lines) {
+        if (!currentKey && (line.trim().startsWith('#') || line.trim() === ''))
+            continue;
+        if (currentKey) {
+            const indent = line.length - line.trimStart().length;
+            if (indent > multilineIndent && line.trim() !== '') {
+                multilineValue.push(line.trim());
+                continue;
+            }
+            else {
+                result[currentKey] = multilineValue.join(' ');
+                currentKey = null;
+                multilineValue = [];
+            }
+        }
+        const match = line.match(/^(\w[\w_-]*)\s*:\s*(.*)/);
+        if (match) {
+            const [, key, value] = match;
+            const trimmedValue = value.trim();
+            if (trimmedValue === '|' || trimmedValue === '>') {
+                currentKey = key;
+                multilineIndent = line.length - line.trimStart().length;
+                multilineValue = [];
+            }
+            else {
+                result[key] = trimmedValue;
+            }
+        }
+    }
+    if (currentKey) {
+        result[currentKey] = multilineValue.join(' ');
+    }
+    return result;
+}
+function parseStringList(value) {
+    const stripped = value.replace(/^\[/, '').replace(/\]$/, '');
+    return stripped.split(',').map(s => s.trim()).filter(s => s.length > 0);
+}
+//# sourceMappingURL=formulas.js.map

package/dist/formulas.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * @blockspool/mcp — MCP server entry point
+ *
+ * Runs as a stdio MCP server for Claude Code.
+ * Usage: npx @blockspool/mcp
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;GAKG"}

package/dist/index.js

@@ -0,0 +1,42 @@
+#!/usr/bin/env node
+/**
+ * @blockspool/mcp — MCP server entry point
+ *
+ * Runs as a stdio MCP server for Claude Code.
+ * Usage: npx @blockspool/mcp
+ */
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createSQLiteAdapter } from '@blockspool/sqlite';
+import { createServer } from './server.js';
+import * as path from 'node:path';
+import * as fs from 'node:fs';
+async function main() {
+    const projectPath = process.env.BLOCKSPOOL_PROJECT_PATH ?? process.cwd();
+    // Determine DB path
+    const bsDir = path.join(projectPath, '.blockspool');
+    if (!fs.existsSync(bsDir)) {
+        fs.mkdirSync(bsDir, { recursive: true });
+    }
+    const dbPath = path.join(bsDir, 'state.sqlite');
+    const db = await createSQLiteAdapter({ url: dbPath });
+    const { server } = await createServer({
+        db,
+        projectPath,
+    });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Graceful shutdown
+    process.on('SIGINT', async () => {
+        await db.close();
+        process.exit(0);
+    });
+    process.on('SIGTERM', async () => {
+        await db.close();
+        process.exit(0);
+    });
+}
+main().catch((err) => {
+    console.error('BlockSpool MCP server failed to start:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;GAKG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAE9B,KAAK,UAAU,IAAI;IACjB,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAEzE,oBAAoB;IACpB,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IACpD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,EAAE,CAAC,SAAS,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;IAEhD,MAAM,EAAE,GAAG,MAAM,mBAAmB,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;IAEtD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,YAAY,CAAC;QACpC,EAAE;QACF,WAAW;KACZ,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,oBAAoB;IACpB,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;QAC9B,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC;QACjB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE;QAC/B,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC;QACjB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,wCAAwC,EAAE,GAAG,CAAC,CAAC;IAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/proposals.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Proposal filtering, dedup, scoring, and ticket creation.
+ *
+ * Used by the event processor when SCOUT_OUTPUT is ingested,
+ * and by the blockspool_submit_proposals tool.
+ */
+import type { DatabaseAdapter } from '@blockspool/core';
+import { RunManager } from './run-manager.js';
+export interface RawProposal {
+    category?: string;
+    title?: string;
+    description?: string;
+    acceptance_criteria?: string[];
+    verification_commands?: string[];
+    allowed_paths?: string[];
+    files?: string[];
+    confidence?: number;
+    impact_score?: number;
+    rationale?: string;
+    estimated_complexity?: string;
+    risk?: string;
+    touched_files_estimate?: number;
+    rollback_note?: string;
+}
+export interface ValidatedProposal {
+    category: string;
+    title: string;
+    description: string;
+    acceptance_criteria: string[];
+    verification_commands: string[];
+    allowed_paths: string[];
+    files: string[];
+    confidence: number;
+    impact_score: number;
+    rationale: string;
+    estimated_complexity: string;
+    risk: string;
+    touched_files_estimate: number;
+    rollback_note: string;
+}
+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>;
+export declare function titleSimilarity(a: string, b: string): number;
+//# 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;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAkB,MAAM,kBAAkB,CAAC;AAExE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAM9C,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB,EAAE,MAAM,CAAC;IAC/B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,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;AAYD,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,UAAU,EACf,EAAE,EAAE,eAAe,EACnB,YAAY,EAAE,WAAW,EAAE,GAC1B,OAAO,CAAC,YAAY,CAAC,CAuGvB;AA8CD,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAc5D"}

package/dist/proposals.js

@@ -0,0 +1,207 @@
+/**
+ * Proposal filtering, dedup, scoring, and ticket creation.
+ *
+ * Used by the event processor when SCOUT_OUTPUT is ingested,
+ * and by the blockspool_submit_proposals tool.
+ */
+import { repos } from '@blockspool/core';
+const REQUIRED_FIELDS = [
+    'category', 'title', 'description', 'allowed_paths',
+    'files', 'confidence', 'verification_commands',
+    'risk', 'touched_files_estimate', 'rollback_note',
+];
+// ---------------------------------------------------------------------------
+// Main entry: filter + create tickets
+// ---------------------------------------------------------------------------
+export async function filterAndCreateTickets(run, db, rawProposals) {
+    const s = run.require();
+    const rejected = [];
+    // Step 1: Schema validation
+    const valid = [];
+    for (const raw of rawProposals) {
+        const missing = validateSchema(raw);
+        if (missing) {
+            rejected.push({ proposal: raw, reason: `Missing fields: ${missing}` });
+            continue;
+        }
+        valid.push(normalizeProposal(raw));
+    }
+    // Step 2: Confidence filter
+    const afterConfidence = valid.filter(p => {
+        if (p.confidence < s.min_confidence) {
+            rejected.push({ proposal: p, reason: `Confidence ${p.confidence} below min ${s.min_confidence}` });
+            return false;
+        }
+        return true;
+    });
+    // Step 3: Category trust ladder
+    const allowedCategories = new Set(s.categories);
+    const afterCategory = afterConfidence.filter(p => {
+        if (!allowedCategories.has(p.category)) {
+            rejected.push({ proposal: p, reason: `Category '${p.category}' not in trust ladder` });
+            return false;
+        }
+        return true;
+    });
+    // Step 4: Dedup against existing tickets (title similarity)
+    const existingTickets = await repos.tickets.listByProject(db, s.project_id);
+    const existingTitles = existingTickets.map(t => t.title);
+    const afterDedup = afterCategory.filter(p => {
+        const isDupe = existingTitles.some(t => titleSimilarity(t, p.title) >= 0.6);
+        if (isDupe) {
+            rejected.push({ proposal: p, reason: 'Duplicate of existing ticket (title similarity >= 0.6)' });
+            return false;
+        }
+        return true;
+    });
+    // Also dedup within the batch
+    const uniqueByTitle = [];
+    for (const p of afterDedup) {
+        const isDupeInBatch = uniqueByTitle.some(q => titleSimilarity(q.title, p.title) >= 0.6);
+        if (isDupeInBatch) {
+            rejected.push({ proposal: p, reason: 'Duplicate within batch (title similarity >= 0.6)' });
+            continue;
+        }
+        uniqueByTitle.push(p);
+    }
+    // Step 5: Score and cap
+    const scored = uniqueByTitle
+        .map(p => ({
+        proposal: p,
+        score: (p.impact_score ?? 5) * p.confidence,
+    }))
+        .sort((a, b) => b.score - a.score)
+        .slice(0, s.max_proposals_per_scout);
+    const accepted = scored.map(s => s.proposal);
+    // Step 6: Create tickets
+    const ticketInputs = accepted.map(p => ({
+        projectId: s.project_id,
+        title: p.title,
+        description: formatDescription(p),
+        status: 'ready',
+        priority: Math.round((p.impact_score ?? 5) * p.confidence / 10),
+        category: p.category,
+        allowedPaths: p.allowed_paths,
+        verificationCommands: p.verification_commands,
+    }));
+    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_category: afterCategory.length,
+        after_dedup: uniqueByTitle.length,
+        accepted: accepted.length,
+        rejected_count: rejected.length,
+    });
+    return { accepted, rejected, created_ticket_ids: createdIds };
+}
+// ---------------------------------------------------------------------------
+// Schema validation
+// ---------------------------------------------------------------------------
+function validateSchema(raw) {
+    const missing = [];
+    if (!raw.category || typeof raw.category !== 'string')
+        missing.push('category');
+    if (!raw.title || typeof raw.title !== 'string')
+        missing.push('title');
+    if (!raw.description || typeof raw.description !== 'string')
+        missing.push('description');
+    if (!Array.isArray(raw.allowed_paths))
+        missing.push('allowed_paths');
+    if (!Array.isArray(raw.files))
+        missing.push('files');
+    if (typeof raw.confidence !== 'number')
+        missing.push('confidence');
+    if (!Array.isArray(raw.verification_commands))
+        missing.push('verification_commands');
+    if (!raw.risk || typeof raw.risk !== 'string')
+        missing.push('risk');
+    if (typeof raw.touched_files_estimate !== 'number')
+        missing.push('touched_files_estimate');
+    if (!raw.rollback_note || typeof raw.rollback_note !== 'string')
+        missing.push('rollback_note');
+    return missing.length > 0 ? missing.join(', ') : null;
+}
+function normalizeProposal(raw) {
+    return {
+        category: raw.category,
+        title: raw.title,
+        description: raw.description,
+        acceptance_criteria: raw.acceptance_criteria ?? [],
+        verification_commands: raw.verification_commands ?? [],
+        allowed_paths: raw.allowed_paths ?? [],
+        files: raw.files ?? [],
+        confidence: raw.confidence,
+        impact_score: raw.impact_score ?? 5,
+        rationale: raw.rationale ?? '',
+        estimated_complexity: raw.estimated_complexity ?? 'moderate',
+        risk: raw.risk,
+        touched_files_estimate: raw.touched_files_estimate,
+        rollback_note: raw.rollback_note,
+    };
+}
+// ---------------------------------------------------------------------------
+// Title similarity (Jaccard on bigrams, case-insensitive)
+// ---------------------------------------------------------------------------
+export function titleSimilarity(a, b) {
+    const bigramsA = bigrams(a.toLowerCase());
+    const bigramsB = bigrams(b.toLowerCase());
+    if (bigramsA.size === 0 && bigramsB.size === 0)
+        return 1;
+    if (bigramsA.size === 0 || bigramsB.size === 0)
+        return 0;
+    let intersection = 0;
+    for (const bg of bigramsA) {
+        if (bigramsB.has(bg))
+            intersection++;
+    }
+    const union = bigramsA.size + bigramsB.size - intersection;
+    return union === 0 ? 0 : intersection / union;
+}
+function bigrams(s) {
+    const result = new Set();
+    const cleaned = s.replace(/[^a-z0-9 ]/g, '').trim();
+    for (let i = 0; i < cleaned.length - 1; i++) {
+        result.add(cleaned.slice(i, i + 2));
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// Description formatter
+// ---------------------------------------------------------------------------
+function formatDescription(p) {
+    const parts = [
+        p.description,
+        '',
+        '## Acceptance Criteria',
+        ...p.acceptance_criteria.map(c => `- ${c}`),
+        '',
+        '## Details',
+        `**Risk:** ${p.risk}`,
+        `**Complexity:** ${p.estimated_complexity}`,
+        `**Confidence:** ${p.confidence}%`,
+        `**Impact:** ${p.impact_score}/10`,
+        `**Estimated files:** ${p.touched_files_estimate}`,
+        '',
+        '## Rollback',
+        p.rollback_note,
+    ];
+    if (p.rationale) {
+        parts.push('', '## Rationale', p.rationale);
+    }
+    if (p.files.length > 0) {
+        parts.push('', '## Files', ...p.files.map(f => `- \`${f}\``));
+    }
+    return parts.join('\n');
+}
+//# 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/run-manager.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Run Manager — creates and manages run folders on disk.
+ *
+ * Each run lives at `.blockspool/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 } from './types.js';
+export declare class RunManager {
+    private readonly projectPath;
+    private state;
+    private runDir;
+    private eventsPath;
+    constructor(projectPath: string);
+    /** The base .blockspool 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;
+    /** Add a hint */
+    addHint(hint: string): void;
+    /** Consume and return all pending hints */
+    consumeHints(): string[];
+    /** End the run */
+    end(): RunState;
+    /** 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;
+    };
+    private persistState;
+}
+//# sourceMappingURL=run-manager.d.ts.map