@blockspool/mcp 0.3.0

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":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EACV,QAAQ,EAER,SAAS,EACT,KAAK,EAEL,aAAa,EACd,MAAM,YAAY,CAAC;AAiCpB,qBAAa,UAAU;IAKT,OAAO,CAAC,QAAQ,CAAC,WAAW;IAJxC,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,UAAU,CAAuB;gBAEZ,WAAW,EAAE,MAAM;IAEhD,qCAAqC;IACrC,OAAO,KAAK,KAAK,GAEhB;IAED,yEAAyE;IACzE,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,QAAQ;IA8E1D,iCAAiC;IACjC,OAAO,IAAI,QAAQ;IAOnB,sCAAsC;IACtC,IAAI,OAAO,IAAI,QAAQ,GAAG,IAAI,CAE7B;IAED,6BAA6B;IAC7B,IAAI,GAAG,IAAI,MAAM,GAAG,IAAI,CAEvB;IAMD,gCAAgC;IAChC,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAY5B,sDAAsD;IACtD,aAAa,IAAI,IAAI;IAQrB,sCAAsC;IACtC,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAYpC,oCAAoC;IACpC,cAAc,IAAI,IAAI;IAYtB,iCAAiC;IACjC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAYhC,iBAAiB;IACjB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAO3B,2CAA2C;IAC3C,YAAY,IAAI,MAAM,EAAE;IAWxB,kBAAkB;IAClB,GAAG,IAAI,QAAQ;IAmBf,uCAAuC;IACvC,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAcpE,4BAA4B;IAC5B,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAMrD,6BAA6B;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAU7D,uCAAuC;IACvC,iBAAiB,IAAI;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAkB3D,+CAA+C;IAC/C,iBAAiB,IAAI,MAAM,EAAE;IAe7B,6CAA6C;IAC7C,WAAW,IAAI;QACb,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,iBAAiB,EAAE,MAAM,CAAC;QAC1B,cAAc,EAAE,MAAM,CAAC;QACvB,gBAAgB,EAAE,MAAM,CAAC;QACzB,uBAAuB,EAAE,MAAM,CAAC;QAChC,YAAY,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;QACjD,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;KAClC;IAsBD,OAAO,CAAC,YAAY;CAKrB"}

package/dist/run-manager.js

@@ -0,0 +1,315 @@
+/**
+ * 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 * as fs from 'node:fs';
+import * as path from 'node:path';
+import { prefixedId } from '@blockspool/core';
+import { checkSpindle } from './spindle.js';
+// ---------------------------------------------------------------------------
+// Defaults
+// ---------------------------------------------------------------------------
+const DEFAULT_STEP_BUDGET = 200;
+const DEFAULT_TICKET_STEP_BUDGET = 12;
+const DEFAULT_MAX_LINES_PER_TICKET = 500;
+const DEFAULT_MAX_TOOL_CALLS_PER_TICKET = 50;
+const DEFAULT_MAX_PRS = 5;
+const DEFAULT_MIN_CONFIDENCE = 70;
+const DEFAULT_MAX_PROPOSALS_PER_SCOUT = 5;
+const DEFAULT_SCOPE = 'src/**';
+const DEFAULT_CATEGORIES = ['refactor', 'docs', 'test', 'perf', 'security'];
+function emptySpindle() {
+    return {
+        output_hashes: [],
+        diff_hashes: [],
+        iterations_since_change: 0,
+        total_output_chars: 0,
+        total_change_chars: 0,
+        failing_command_signatures: [],
+        plan_hashes: [],
+    };
+}
+// ---------------------------------------------------------------------------
+// RunManager
+// ---------------------------------------------------------------------------
+export class RunManager {
+    projectPath;
+    state = null;
+    runDir = null;
+    eventsPath = null;
+    constructor(projectPath) {
+        this.projectPath = projectPath;
+    }
+    /** The base .blockspool directory */
+    get bsDir() {
+        return path.join(this.projectPath, '.blockspool');
+    }
+    /** Create a new run, write initial state.json and SESSION_START event */
+    create(projectId, config) {
+        if (this.state) {
+            throw new Error('Run already active. End it first.');
+        }
+        const runId = prefixedId('run');
+        const sessionId = prefixedId('ses');
+        const now = new Date();
+        const expiresAt = config.hours
+            ? new Date(now.getTime() + config.hours * 60 * 60 * 1000).toISOString()
+            : null;
+        this.state = {
+            run_id: runId,
+            session_id: sessionId,
+            project_id: projectId,
+            phase: 'SCOUT',
+            phase_entry_step: 0,
+            step_count: 0,
+            step_budget: config.step_budget ?? DEFAULT_STEP_BUDGET,
+            ticket_step_count: 0,
+            ticket_step_budget: config.ticket_step_budget ?? DEFAULT_TICKET_STEP_BUDGET,
+            total_lines_changed: 0,
+            max_lines_per_ticket: DEFAULT_MAX_LINES_PER_TICKET,
+            total_tool_calls: 0,
+            max_tool_calls_per_ticket: DEFAULT_MAX_TOOL_CALLS_PER_TICKET,
+            tickets_completed: 0,
+            tickets_failed: 0,
+            tickets_blocked: 0,
+            prs_created: 0,
+            scout_cycles: 0,
+            max_cycles: config.max_cycles ?? 1,
+            max_prs: config.max_prs ?? DEFAULT_MAX_PRS,
+            current_ticket_id: null,
+            current_ticket_plan: null,
+            plan_approved: false,
+            plan_rejections: 0,
+            qa_retries: 0,
+            started_at: now.toISOString(),
+            expires_at: expiresAt,
+            scope: config.scope ?? DEFAULT_SCOPE,
+            formula: config.formula ?? null,
+            categories: config.categories ?? DEFAULT_CATEGORIES,
+            min_confidence: config.min_confidence ?? DEFAULT_MIN_CONFIDENCE,
+            max_proposals_per_scout: config.max_proposals ?? DEFAULT_MAX_PROPOSALS_PER_SCOUT,
+            draft_prs: config.draft_prs ?? true,
+            hints: [],
+            spindle: emptySpindle(),
+            recent_intent_hashes: [],
+        };
+        // Create run folder
+        const runsDir = path.join(this.bsDir, 'runs');
+        this.runDir = path.join(runsDir, runId);
+        this.eventsPath = path.join(this.runDir, 'events.ndjson');
+        fs.mkdirSync(path.join(this.runDir, 'diffs'), { recursive: true });
+        fs.mkdirSync(path.join(this.runDir, 'artifacts'), { recursive: true });
+        // Write initial state
+        this.persistState();
+        // Log session start
+        this.appendEvent('SESSION_START', {
+            config,
+            project_id: projectId,
+        });
+        return this.state;
+    }
+    /** Get current state or throw */
+    require() {
+        if (!this.state) {
+            throw new Error('No active run. Call blockspool_start_session first.');
+        }
+        return this.state;
+    }
+    /** Get current state (may be null) */
+    get current() {
+        return this.state;
+    }
+    /** Get run directory path */
+    get dir() {
+        return this.runDir;
+    }
+    // -----------------------------------------------------------------------
+    // State mutations (all persist + log)
+    // -----------------------------------------------------------------------
+    /** Transition to a new phase */
+    setPhase(phase) {
+        const s = this.require();
+        const oldPhase = s.phase;
+        s.phase = phase;
+        s.phase_entry_step = s.step_count;
+        this.persistState();
+        this.appendEvent('ADVANCE_RETURNED', {
+            old_phase: oldPhase,
+            new_phase: phase,
+        });
+    }
+    /** Increment step counter (called on each advance) */
+    incrementStep() {
+        const s = this.require();
+        s.step_count++;
+        s.ticket_step_count++;
+        s.total_tool_calls++;
+        this.persistState();
+    }
+    /** Assign a ticket as current work */
+    assignTicket(ticketId) {
+        const s = this.require();
+        s.current_ticket_id = ticketId;
+        s.ticket_step_count = 0;
+        s.plan_approved = false;
+        s.current_ticket_plan = null;
+        s.plan_rejections = 0;
+        s.qa_retries = 0;
+        this.persistState();
+        this.appendEvent('TICKET_ASSIGNED', { ticket_id: ticketId });
+    }
+    /** Mark current ticket completed */
+    completeTicket() {
+        const s = this.require();
+        s.tickets_completed++;
+        const ticketId = s.current_ticket_id;
+        s.current_ticket_id = null;
+        s.current_ticket_plan = null;
+        s.plan_approved = false;
+        s.ticket_step_count = 0;
+        this.persistState();
+        this.appendEvent('TICKET_COMPLETED', { ticket_id: ticketId });
+    }
+    /** Mark current ticket failed */
+    failTicket(reason) {
+        const s = this.require();
+        s.tickets_failed++;
+        const ticketId = s.current_ticket_id;
+        s.current_ticket_id = null;
+        s.current_ticket_plan = null;
+        s.plan_approved = false;
+        s.ticket_step_count = 0;
+        this.persistState();
+        this.appendEvent('TICKET_FAILED', { ticket_id: ticketId, reason });
+    }
+    /** Add a hint */
+    addHint(hint) {
+        const s = this.require();
+        s.hints.push(hint);
+        this.persistState();
+        this.appendEvent('USER_OVERRIDE', { hint });
+    }
+    /** Consume and return all pending hints */
+    consumeHints() {
+        const s = this.require();
+        const hints = [...s.hints];
+        s.hints = [];
+        this.persistState();
+        for (const h of hints) {
+            this.appendEvent('HINT_CONSUMED', { hint: h });
+        }
+        return hints;
+    }
+    /** End the run */
+    end() {
+        const s = this.require();
+        this.appendEvent('SESSION_END', {
+            tickets_completed: s.tickets_completed,
+            tickets_failed: s.tickets_failed,
+            prs_created: s.prs_created,
+            step_count: s.step_count,
+        });
+        const finalState = { ...s };
+        this.state = null;
+        this.runDir = null;
+        this.eventsPath = null;
+        return finalState;
+    }
+    // -----------------------------------------------------------------------
+    // Event logging
+    // -----------------------------------------------------------------------
+    /** Append an event to events.ndjson */
+    appendEvent(type, payload) {
+        const step = this.state?.step_count ?? 0;
+        const event = {
+            ts: new Date().toISOString(),
+            step,
+            type,
+            payload,
+        };
+        if (this.eventsPath) {
+            fs.appendFileSync(this.eventsPath, JSON.stringify(event) + '\n', 'utf8');
+        }
+    }
+    /** Save an artifact file */
+    saveArtifact(filename, content) {
+        if (!this.runDir)
+            return;
+        const artifactPath = path.join(this.runDir, 'artifacts', filename);
+        fs.writeFileSync(artifactPath, content, 'utf8');
+    }
+    /** Save a diff/patch file */
+    saveDiff(step, ticketId, patch) {
+        if (!this.runDir)
+            return;
+        const diffPath = path.join(this.runDir, 'diffs', `${step}-${ticketId}.patch`);
+        fs.writeFileSync(diffPath, patch, 'utf8');
+    }
+    // -----------------------------------------------------------------------
+    // Helpers
+    // -----------------------------------------------------------------------
+    /** Check if any budget is exhausted */
+    isBudgetExhausted() {
+        const s = this.require();
+        if (s.step_count >= s.step_budget) {
+            return { exhausted: true, which: 'step_budget' };
+        }
+        if (s.ticket_step_count >= s.ticket_step_budget) {
+            return { exhausted: true, which: 'ticket_step_budget' };
+        }
+        if (s.prs_created >= s.max_prs) {
+            return { exhausted: true, which: 'max_prs' };
+        }
+        if (s.expires_at && new Date() > new Date(s.expires_at)) {
+            return { exhausted: true, which: 'time_budget' };
+        }
+        return { exhausted: false };
+    }
+    /** Check if approaching budget limits (80%) */
+    getBudgetWarnings() {
+        const s = this.require();
+        const warnings = [];
+        if (s.step_count >= s.step_budget * 0.8) {
+            warnings.push(`step_budget: ${s.step_count}/${s.step_budget}`);
+        }
+        if (s.ticket_step_count >= s.ticket_step_budget * 0.8) {
+            warnings.push(`ticket_step_budget: ${s.ticket_step_count}/${s.ticket_step_budget}`);
+        }
+        if (s.prs_created >= s.max_prs * 0.8) {
+            warnings.push(`max_prs: ${s.prs_created}/${s.max_prs}`);
+        }
+        return warnings;
+    }
+    /** Build the digest for advance responses */
+    buildDigest() {
+        const s = this.require();
+        const timeRemainingMs = s.expires_at
+            ? Math.max(0, new Date(s.expires_at).getTime() - Date.now())
+            : null;
+        return {
+            step: s.step_count,
+            phase: s.phase,
+            tickets_completed: s.tickets_completed,
+            tickets_failed: s.tickets_failed,
+            budget_remaining: s.step_budget - s.step_count,
+            ticket_budget_remaining: s.ticket_step_budget - s.ticket_step_count,
+            spindle_risk: checkSpindle(s.spindle).risk,
+            time_remaining_ms: timeRemainingMs,
+        };
+    }
+    // -----------------------------------------------------------------------
+    // Persistence
+    // -----------------------------------------------------------------------
+    persistState() {
+        if (!this.runDir || !this.state)
+            return;
+        const statePath = path.join(this.runDir, 'state.json');
+        fs.writeFileSync(statePath, JSON.stringify(this.state, null, 2) + '\n', 'utf8');
+    }
+}
+//# sourceMappingURL=run-manager.js.map

package/dist/run-manager.js.map

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

package/dist/scope-policy.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Scope Policy — derives and enforces file-level constraints for tickets.
+ *
+ * Used by the plan validator and PreToolUse hook to ensure
+ * agents only touch files they're allowed to.
+ */
+export interface ScopePolicy {
+    allowed_paths: string[];
+    denied_paths: string[];
+    denied_patterns: RegExp[];
+    max_files: number;
+    max_lines: number;
+    plan_required: boolean;
+}
+export interface DeriveScopeInput {
+    allowedPaths: string[];
+    category: string;
+    maxLinesPerTicket: number;
+}
+export declare function deriveScopePolicy(input: DeriveScopeInput): ScopePolicy;
+export interface PlanFile {
+    path: string;
+    action: string;
+    reason: string;
+}
+export interface PlanValidationResult {
+    valid: boolean;
+    reason: string | null;
+}
+export declare function validatePlanScope(files: PlanFile[], estimatedLines: number, riskLevel: string, policy: ScopePolicy): PlanValidationResult;
+export declare function isFileAllowed(filePath: string, policy: ScopePolicy): boolean;
+export declare function containsCredentials(content: string): string | null;
+export declare function serializeScopePolicy(policy: ScopePolicy): Record<string, unknown>;
+//# sourceMappingURL=scope-policy.d.ts.map

package/dist/scope-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-policy.d.ts","sourceRoot":"","sources":["../src/scope-policy.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,OAAO,CAAC;CACxB;AAuCD,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,GAAG,WAAW,CAStE;AAMD,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,QAAQ,EAAE,EACjB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,WAAW,GAClB,oBAAoB,CA6DtB;AAMD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAuB5E;AAMD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQlE;AAMD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASjF"}

package/dist/scope-policy.js

@@ -0,0 +1,145 @@
+/**
+ * Scope Policy — derives and enforces file-level constraints for tickets.
+ *
+ * Used by the plan validator and PreToolUse hook to ensure
+ * agents only touch files they're allowed to.
+ */
+import { minimatch } from 'minimatch';
+// ---------------------------------------------------------------------------
+// Always-denied paths (build artifacts, lockfiles, VCS internals)
+// ---------------------------------------------------------------------------
+const ALWAYS_DENIED_PATHS = [
+    '.env', '.env.*',
+    'node_modules/**', '.git/**',
+    'dist/**', 'build/**', 'coverage/**',
+    '*.lock', 'package-lock.json',
+];
+// ---------------------------------------------------------------------------
+// Credential / secret deny patterns
+// ---------------------------------------------------------------------------
+const CREDENTIAL_PATTERNS = [
+    /AKIA[0-9A-Z]{16}/, // AWS access key
+    /-----BEGIN.*PRIVATE KEY-----/, // PEM keys
+    /ghp_[a-zA-Z0-9]{36}/, // GitHub PAT
+    /sk-[a-zA-Z0-9]{48}/, // OpenAI key
+    /password\s*[:=]\s*['"][^'"]+/i, // hardcoded passwords
+];
+// ---------------------------------------------------------------------------
+// Path deny patterns (file names that shouldn't be touched)
+// ---------------------------------------------------------------------------
+const FILE_DENY_PATTERNS = [
+    /\.(env|pem|key)$/,
+    /credentials/i,
+    /secret/i,
+];
+export function deriveScopePolicy(input) {
+    return {
+        allowed_paths: input.allowedPaths,
+        denied_paths: ALWAYS_DENIED_PATHS,
+        denied_patterns: FILE_DENY_PATTERNS,
+        max_files: 10,
+        max_lines: input.category === 'test' ? 1000 : input.maxLinesPerTicket,
+        plan_required: input.category !== 'docs',
+    };
+}
+export function validatePlanScope(files, estimatedLines, riskLevel, policy) {
+    // 1. Must have files
+    if (!files || files.length === 0) {
+        return { valid: false, reason: 'Plan must include at least one file to touch' };
+    }
+    // 2. Check estimated lines
+    if (estimatedLines > policy.max_lines) {
+        return {
+            valid: false,
+            reason: `Estimated lines (${estimatedLines}) exceeds max (${policy.max_lines})`,
+        };
+    }
+    // 3. Check max files
+    if (files.length > policy.max_files) {
+        return {
+            valid: false,
+            reason: `Plan touches ${files.length} files, max allowed is ${policy.max_files}`,
+        };
+    }
+    // 4. Valid risk level
+    if (!riskLevel || !['low', 'medium', 'high'].includes(riskLevel)) {
+        return { valid: false, reason: 'Plan must specify risk_level: low, medium, or high' };
+    }
+    // 5. Check each file against denied paths
+    for (const f of files) {
+        for (const deniedGlob of policy.denied_paths) {
+            if (minimatch(f.path, deniedGlob, { dot: true })) {
+                return { valid: false, reason: `Plan touches denied path: ${f.path} (matches ${deniedGlob})` };
+            }
+        }
+    }
+    // 6. Check each file against denied patterns
+    for (const f of files) {
+        for (const pattern of policy.denied_patterns) {
+            if (pattern.test(f.path)) {
+                return { valid: false, reason: `Plan touches sensitive file: ${f.path}` };
+            }
+        }
+    }
+    // 7. Check each file is within allowed_paths (if any specified)
+    if (policy.allowed_paths.length > 0) {
+        for (const f of files) {
+            const isAllowed = policy.allowed_paths.some(glob => minimatch(f.path, glob, { dot: true }));
+            if (!isAllowed) {
+                return {
+                    valid: false,
+                    reason: `File ${f.path} is outside allowed paths: ${policy.allowed_paths.join(', ')}`,
+                };
+            }
+        }
+    }
+    return { valid: true, reason: null };
+}
+// ---------------------------------------------------------------------------
+// Check a single file path (used by PreToolUse hook)
+// ---------------------------------------------------------------------------
+export function isFileAllowed(filePath, policy) {
+    // Check denied paths
+    for (const deniedGlob of policy.denied_paths) {
+        if (minimatch(filePath, deniedGlob, { dot: true })) {
+            return false;
+        }
+    }
+    // Check denied patterns
+    for (const pattern of policy.denied_patterns) {
+        if (pattern.test(filePath)) {
+            return false;
+        }
+    }
+    // Check allowed paths (empty = everything allowed)
+    if (policy.allowed_paths.length > 0) {
+        return policy.allowed_paths.some(glob => minimatch(filePath, glob, { dot: true }));
+    }
+    return true;
+}
+// ---------------------------------------------------------------------------
+// Check file content for credential patterns
+// ---------------------------------------------------------------------------
+export function containsCredentials(content) {
+    for (const pattern of CREDENTIAL_PATTERNS) {
+        const match = content.match(pattern);
+        if (match) {
+            return `Content contains potential credential: ${pattern.source}`;
+        }
+    }
+    return null;
+}
+// ---------------------------------------------------------------------------
+// Serialize policy for MCP tool response (RegExp → string)
+// ---------------------------------------------------------------------------
+export function serializeScopePolicy(policy) {
+    return {
+        allowed_paths: policy.allowed_paths,
+        denied_paths: policy.denied_paths,
+        denied_patterns: policy.denied_patterns.map(r => r.source),
+        max_files: policy.max_files,
+        max_lines: policy.max_lines,
+        plan_required: policy.plan_required,
+    };
+}
+//# sourceMappingURL=scope-policy.js.map

package/dist/scope-policy.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,16 @@
+/**
+ * MCP Server setup and tool registration
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { DatabaseAdapter } from '@blockspool/core';
+import { SessionManager } from './state.js';
+export interface ServerOptions {
+    db: DatabaseAdapter;
+    projectPath: string;
+    projectName?: string;
+}
+export declare function createServer(options: ServerOptions): Promise<{
+    server: McpServer;
+    state: SessionManager;
+}>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAExD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAM5C,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,eAAe,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC;IAClE,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,cAAc,CAAC;CACvB,CAAC,CAwBD"}

package/dist/server.js

@@ -0,0 +1,31 @@
+/**
+ * MCP Server setup and tool registration
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { repos } from '@blockspool/core';
+import { SessionManager } from './state.js';
+import { registerSessionTools } from './tools/session.js';
+import { registerScoutTools } from './tools/scout.js';
+import { registerExecuteTools } from './tools/execute.js';
+import { registerGitTools } from './tools/git.js';
+export async function createServer(options) {
+    const { db, projectPath, projectName } = options;
+    // Ensure project exists
+    const project = await repos.projects.ensureForRepo(db, {
+        name: projectName ?? projectPath.split('/').pop() ?? 'unknown',
+        rootPath: projectPath,
+    });
+    const state = new SessionManager(db, project, projectPath);
+    const getState = () => state;
+    const server = new McpServer({
+        name: 'blockspool',
+        version: '0.2.0',
+    });
+    // Register tool groups
+    registerSessionTools(server, getState);
+    registerScoutTools(server, getState);
+    registerExecuteTools(server, getState);
+    registerGitTools(server, getState);
+    return { server, state };
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAQlD,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAsB;IAIvD,MAAM,EAAE,EAAE,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IAEjD,wBAAwB;IACxB,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,EAAE;QACrD,IAAI,EAAE,WAAW,IAAI,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,SAAS;QAC9D,QAAQ,EAAE,WAAW;KACtB,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,IAAI,cAAc,CAAC,EAAE,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;IAC3D,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC;IAE7B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,uBAAuB;IACvB,oBAAoB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACvC,kBAAkB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACrC,oBAAoB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACvC,gBAAgB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAEnC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AAC3B,CAAC"}

package/dist/spindle.d.ts

@@ -0,0 +1,41 @@
+/**
+ * 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 type { SpindleState } from './types.js';
+export interface SpindleConfig {
+    similarityThreshold: number;
+    maxSimilarOutputs: number;
+    maxStallIterations: number;
+    maxCommandFailures: number;
+    maxQaPingPong: number;
+    maxFileEdits: number;
+}
+export declare const DEFAULT_SPINDLE_CONFIG: SpindleConfig;
+export type SpindleReason = 'oscillation' | 'repetition' | 'stalling' | 'qa_ping_pong' | 'command_failure';
+export interface SpindleCheckResult {
+    shouldAbort: boolean;
+    shouldBlock: boolean;
+    reason?: SpindleReason;
+    confidence: number;
+    diagnostics: Record<string, unknown>;
+    risk: 'none' | 'low' | 'medium' | 'high';
+}
+export declare function checkSpindle(spindle: SpindleState, config?: SpindleConfig): SpindleCheckResult;
+export declare function recordOutput(spindle: SpindleState, output: string): void;
+export declare function recordDiff(spindle: SpindleState, diff: string | null): void;
+export declare function recordCommandFailure(spindle: SpindleState, command: string, error: string): void;
+export declare function recordPlanHash(spindle: SpindleState, plan: unknown): void;
+export declare function recordTicketResult(spindle: SpindleState, changedFiles: string[], diff: string | null): void;
+/** Get file edit frequency warnings */
+export declare function getFileEditWarnings(spindle: SpindleState, threshold?: number): string[];
+//# sourceMappingURL=spindle.d.ts.map

package/dist/spindle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spindle.d.ts","sourceRoot":"","sources":["../src/spindle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAM/C,MAAM,WAAW,aAAa;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,sBAAsB,EAAE,aAOpC,CAAC;AAMF,MAAM,MAAM,aAAa,GACrB,aAAa,GACb,YAAY,GACZ,UAAU,GACV,cAAc,GACd,iBAAiB,CAAC;AAEtB,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CAC1C;AAcD,wBAAgB,YAAY,CAC1B,OAAO,EAAE,YAAY,EACrB,MAAM,GAAE,aAAsC,GAC7C,kBAAkB,CA8EpB;AAMD,wBAAgB,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAKxE;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAmB3E;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAIhG;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAIzE;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAE3G;AAwID,uCAAuC;AACvC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,EAAE,SAAS,GAAE,MAAU,GAAG,MAAM,EAAE,CAS1F"}