@blockspool/mcp 0.3.0

package/dist/types.d.ts

@@ -0,0 +1,116 @@
+/**
+ * BlockSpool v2 types — Run state, events, phases, and response contracts.
+ *
+ * These match the schemas defined in docs/PLUGIN_ROADMAP.md.
+ */
+export type Phase = 'SCOUT' | 'PLAN' | 'EXECUTE' | 'QA' | 'PR' | 'NEXT_TICKET' | 'DONE' | 'BLOCKED_NEEDS_HUMAN' | 'FAILED_BUDGET' | 'FAILED_VALIDATION' | 'FAILED_SPINDLE';
+export declare const TERMINAL_PHASES: ReadonlySet<Phase>;
+export interface CommitPlan {
+    ticket_id: string;
+    files_to_touch: Array<{
+        path: string;
+        reason: string;
+        action: 'create' | 'modify' | 'delete';
+    }>;
+    expected_tests: string[];
+    risk_level: 'low' | 'medium' | 'high';
+    estimated_lines: number;
+}
+export interface SpindleState {
+    output_hashes: string[];
+    diff_hashes: string[];
+    iterations_since_change: number;
+    total_output_chars: number;
+    total_change_chars: number;
+    failing_command_signatures: string[];
+    plan_hashes: string[];
+    file_edit_counts?: Record<string, number>;
+}
+export interface RunState {
+    run_id: string;
+    session_id: string;
+    project_id: string;
+    phase: Phase;
+    phase_entry_step: number;
+    step_count: number;
+    step_budget: number;
+    ticket_step_count: number;
+    ticket_step_budget: number;
+    total_lines_changed: number;
+    max_lines_per_ticket: number;
+    total_tool_calls: number;
+    max_tool_calls_per_ticket: number;
+    tickets_completed: number;
+    tickets_failed: number;
+    tickets_blocked: number;
+    prs_created: number;
+    scout_cycles: number;
+    max_cycles: number;
+    max_prs: number;
+    current_ticket_id: string | null;
+    current_ticket_plan: CommitPlan | null;
+    plan_approved: boolean;
+    plan_rejections: number;
+    qa_retries: number;
+    started_at: string;
+    expires_at: string | null;
+    scope: string;
+    formula: string | null;
+    categories: string[];
+    min_confidence: number;
+    max_proposals_per_scout: number;
+    draft_prs: boolean;
+    hints: string[];
+    spindle: SpindleState;
+    recent_intent_hashes: string[];
+}
+export type EventType = 'SESSION_START' | 'ADVANCE_CALLED' | 'ADVANCE_RETURNED' | 'SCOUT_OUTPUT' | 'PROPOSALS_FILTERED' | 'TICKETS_CREATED' | 'TICKET_ASSIGNED' | 'PLAN_SUBMITTED' | 'PLAN_APPROVED' | 'PLAN_REJECTED' | 'TOOL_CALL_ATTEMPTED' | 'SCOPE_ALLOWED' | 'SCOPE_BLOCKED' | 'TICKET_RESULT' | 'QA_STARTED' | 'QA_COMMAND_RESULT' | 'QA_PASSED' | 'QA_FAILED' | 'PR_CREATED' | 'TICKET_COMPLETED' | 'TICKET_FAILED' | 'BUDGET_WARNING' | 'BUDGET_EXHAUSTED' | 'SPINDLE_WARNING' | 'SPINDLE_ABORT' | 'HINT_CONSUMED' | 'USER_OVERRIDE' | 'SESSION_END';
+export interface RunEvent {
+    ts: string;
+    step: number;
+    type: EventType;
+    payload: Record<string, unknown>;
+}
+export interface AdvanceConstraints {
+    allowed_paths: string[];
+    denied_paths: string[];
+    denied_patterns: string[];
+    max_files: number;
+    max_lines: number;
+    required_commands: string[];
+    plan_required: boolean;
+}
+export interface AdvanceDigest {
+    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;
+}
+export interface AdvanceResponse {
+    next_action: 'PROMPT' | 'STOP';
+    phase: Phase;
+    prompt: string | null;
+    reason: string;
+    constraints: AdvanceConstraints;
+    digest: AdvanceDigest;
+}
+export interface SessionConfig {
+    hours?: number;
+    formula?: string;
+    deep?: boolean;
+    continuous?: boolean;
+    scope?: string;
+    categories?: string[];
+    min_confidence?: number;
+    max_proposals?: number;
+    step_budget?: number;
+    ticket_step_budget?: number;
+    max_prs?: number;
+    max_cycles?: number;
+    draft_prs?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,13 @@
+/**
+ * BlockSpool v2 types — Run state, events, phases, and response contracts.
+ *
+ * These match the schemas defined in docs/PLUGIN_ROADMAP.md.
+ */
+export const TERMINAL_PHASES = new Set([
+    'DONE',
+    'BLOCKED_NEEDS_HUMAN',
+    'FAILED_BUDGET',
+    'FAILED_VALIDATION',
+    'FAILED_SPINDLE',
+]);
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAoBH,MAAM,CAAC,MAAM,eAAe,GAAuB,IAAI,GAAG,CAAC;IACzD,MAAM;IACN,qBAAqB;IACrB,eAAe;IACf,mBAAmB;IACnB,gBAAgB;CACjB,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@blockspool/mcp",
+  "version": "0.3.0",
+  "description": "BlockSpool MCP server - stateful tool provider for Claude Code",
+  "author": "BlockSpool",
+  "homepage": "https://blockspool.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/blockspool/blockspool.git",
+    "directory": "packages/mcp"
+  },
+  "bugs": {
+    "url": "https://github.com/blockspool/blockspool/issues"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "blockspool-mcp": "./dist/index.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./direct-client": {
+      "types": "./dist/direct-client.d.ts",
+      "import": "./dist/direct-client.js"
+    },
+    "./formulas": {
+      "types": "./dist/formulas.d.ts",
+      "import": "./dist/formulas.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "tsc"
+  },
+  "keywords": [
+    "blockspool",
+    "mcp",
+    "model-context-protocol",
+    "claude-code",
+    "tools"
+  ],
+  "license": "Apache-2.0",
+  "dependencies": {
+    "@blockspool/core": "^0.3.0",
+    "@blockspool/sqlite": "^0.3.0",
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "@types/minimatch": "^5.1.2",
+    "minimatch": "^10.1.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.9.3"
+  }
+}