@madmatt112org/spec-workflow-mcp 3.0.0

package/dist/tools/decomposition-guide.js

@@ -0,0 +1,163 @@
+export const decompositionGuideTool = {
+    name: 'decomposition-guide',
+    description: `Load guide for decomposing steering documents into a complete set of specs.
+
+# Instructions
+Called as part of the spec workflow when steering docs exist. This is a required step before
+starting the first spec. Returns the spec decomposition methodology — principles for identifying
+spec boundaries, ordering dependencies, and producing a decomposition document.`,
+    inputSchema: {
+        type: 'object',
+        properties: {},
+        additionalProperties: false
+    },
+    annotations: {
+        title: 'Decomposition Guide',
+        readOnlyHint: true,
+    }
+};
+export async function decompositionGuideHandler(args, context) {
+    return {
+        success: true,
+        message: 'Spec decomposition guide loaded — use this methodology to break the project into specs',
+        data: {
+            guide: getDecompositionGuide(),
+            dashboardUrl: context.dashboardUrl
+        },
+        nextSteps: [
+            'Read all steering docs from .spec-workflow/steering/',
+            'Ask user if there is existing code to account for',
+            'Apply the decomposition methodology to produce a spec breakdown',
+            'Surface open questions to the user before finalizing',
+            'Save decomposition to .spec-workflow/spec-decomposition/decomposition.md'
+        ]
+    };
+}
+export function getDecompositionGuide() {
+    return `# Spec Decomposition Methodology
+
+## Purpose
+
+This guide provides principles for decomposing a project — described by its steering documents
+(product.md, tech.md, structure.md) — into a complete, ordered set of specs. Each spec will
+later go through the standard spec workflow (Requirements → Design → Tasks → Implementation).
+
+## Core Principle
+
+**Each spec should produce a system state where you can do something you couldn't do before,
+and verify it end-to-end.**
+
+Not a technical layer. Not a product feature bullet point. A demonstrable capability.
+
+## Decomposition Principles
+
+### 1. The Reviewability Test
+
+If the spec is too big for a human to meaningfully review the requirements, design, and task
+breakdown in a single sitting, it is too big. This is the most practical heuristic for sizing.
+
+### 2. INVEST Criteria at the Spec Level
+
+- **Independent**: Each spec should be buildable and verifiable without waiting for unfinished
+  specs (dependencies on *completed* specs are fine).
+- **Negotiable**: Scope details are refined during the spec's own requirements and design phases.
+- **Valuable**: Each spec delivers user-visible or system-verifiable value on its own.
+- **Estimable**: The scope is clear enough to reason about effort.
+- **Small**: Small enough to hold in your head; large enough to be meaningful.
+- **Testable**: There is a concrete end-to-end verification for the spec's deliverable.
+
+### 3. Vertical Slicing
+
+Each spec must cut through the full stack needed to deliver its capability. Never split by
+technical layer:
+
+**Wrong**: "database schema spec" + "API layer spec" + "UI spec" for the same feature.
+**Right**: One spec that delivers the feature end-to-end, touching database, API, and UI.
+
+The exception is foundational infrastructure that genuinely has no user-facing value on its own
+(e.g., project scaffolding, CI pipeline). These should be absorbed into the first spec that
+needs them, not separated into their own spec.
+
+### 4. Dependency Ordering
+
+Specs should form a directed acyclic graph (DAG). For each spec, identify:
+- What it depends on (which earlier specs must be complete)
+- What depends on it (which later specs it unblocks)
+
+Prefer orderings that deliver user-visible value early. Front-load specs that unblock the most
+downstream work.
+
+### 5. Cross-Spec Conventions
+
+Identify patterns that apply across multiple specs and document them once:
+- Schema evolution strategy (e.g., migration numbering)
+- API versioning or OpenAPI conventions
+- Shared type definitions or interfaces
+- Error handling patterns
+- Naming conventions
+
+These are not specs themselves — they are conventions that specs follow.
+
+### 6. What Is NOT a Spec
+
+Some items from steering docs lack independent deliverable value:
+- **Pure infrastructure**: CI/CD setup, Docker configuration, linting — absorb into the first
+  spec that needs the infrastructure.
+- **Technical layers**: "Set up the database" or "Configure the SSE broker" — these are
+  components within a spec, not standalone deliverables.
+- **Trivial features**: If the implementation is a few lines of code with no design decisions,
+  it belongs inside a related spec, not as its own.
+
+Call these out explicitly so they don't get lost — document where each non-spec item lands.
+
+### 7. Existing Code Awareness
+
+If the project has existing code:
+- Scan the codebase to understand what is already built.
+- Identify specs that are partially or fully implemented.
+- Note which specs require refactoring existing code vs. building new.
+- Account for existing patterns and conventions that new specs should follow.
+
+### 8. Open Questions Protocol
+
+During decomposition, ambiguities and design decisions will surface. For each:
+- Document the question clearly.
+- Explain why it matters for spec boundaries or ordering.
+- Suggest options if possible.
+- **Present all open questions to the user before finalizing the decomposition.**
+  The user may provide answers, directives to leave questions unresolved, or indicate
+  that a question should be resolved during a specific spec's design phase.
+
+## Decomposition Process
+
+1. **Read all steering docs** to understand the full scope.
+2. **Identify capabilities** — what distinct things should the system do?
+3. **Group into specs** — each spec delivers one or more related capabilities end-to-end.
+4. **Check sizing** — apply the reviewability test. Split specs that are too large; merge
+   specs that are too small to be independently valuable.
+5. **Order by dependencies** — build the DAG. Identify the critical path.
+6. **Identify cross-spec conventions** — extract shared patterns.
+7. **Flag what is NOT a spec** — assign non-spec items to their parent specs.
+8. **Surface open questions** — present to the user for guidance.
+9. **Write the decomposition document** with all findings.
+
+## Output Structure
+
+The decomposition document should include (adapt to fit the project):
+
+- **Per-spec entries**: Name, scope description, what it delivers, end-to-end verification,
+  dependencies on other specs, and any design considerations for this spec specifically.
+- **Dependency graph**: Visual representation (mermaid DAG recommended) of spec ordering.
+- **Cross-spec conventions**: Shared patterns and rules.
+- **What is NOT a spec**: Items absorbed into other specs, with rationale.
+- **Open questions**: Unresolved decisions with context and options.
+
+## Sources
+
+These principles are drawn from:
+- INVEST criteria (originally for user stories, applied here at spec granularity)
+- The reviewability test (intent-driven.dev)
+- Vertical slicing (ThoughtWorks spec-driven development analysis)
+- Practical examples from spec-driven development tooling (Kiro, spec-kit, Zencoder)`;
+}
+//# sourceMappingURL=decomposition-guide.js.map

package/dist/tools/decomposition-guide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decomposition-guide.js","sourceRoot":"","sources":["../../src/tools/decomposition-guide.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,sBAAsB,GAAS;IAC1C,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EAAE;;;;;gFAKiE;IAC9E,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;QACd,oBAAoB,EAAE,KAAK;KAC5B;IACD,WAAW,EAAE;QACX,KAAK,EAAE,qBAAqB;QAC5B,YAAY,EAAE,IAAI;KACnB;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,IAAS,EAAE,OAAoB;IAC7E,OAAO;QACL,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,wFAAwF;QACjG,IAAI,EAAE;YACJ,KAAK,EAAE,qBAAqB,EAAE;YAC9B,YAAY,EAAE,OAAO,CAAC,YAAY;SACnC;QACD,SAAS,EAAE;YACT,sDAAsD;YACtD,mDAAmD;YACnD,iEAAiE;YACjE,sDAAsD;YACtD,0EAA0E;SAC3E;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qFA4H4E,CAAC;AACtF,CAAC"}

package/dist/tools/deferrals.d.ts

@@ -0,0 +1,5 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import { ToolContext, ToolResponse } from '../types.js';
+export declare const deferralsTool: Tool;
+export declare function deferralsHandler(args: Record<string, any>, context: ToolContext): Promise<ToolResponse>;
+//# sourceMappingURL=deferrals.d.ts.map

package/dist/tools/deferrals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deferrals.d.ts","sourceRoot":"","sources":["../../src/tools/deferrals.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIxD,eAAO,MAAM,aAAa,EAAE,IAgG3B,CAAC;AAEF,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,YAAY,CAAC,CA8BvB"}

package/dist/tools/deferrals.js

@@ -0,0 +1,229 @@
+import { DeferralStorage } from '../core/deferral-storage.js';
+import { validateProjectPath } from '../core/path-utils.js';
+export const deferralsTool = {
+    name: 'deferrals',
+    description: `Track decisions that are explicitly deferred during spec work.
+
+# Instructions
+Use this tool to record, query, and resolve deferred decisions. Deferrals are project-level artifacts that persist across specs.
+
+Actions:
+- 'add': Record a new deferred decision (optionally superseding an existing one)
+- 'list': List deferrals with optional filters (status, originSpec, tag)
+- 'get': Get full details of a specific deferral
+- 'resolve': Mark a deferral as resolved
+- 'update': Update mutable fields (title, revisitTrigger, tags, context, decision, revisitCriteria)
+- 'delete': Remove a deferral (fails if referenced by another deferral)`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            action: {
+                type: 'string',
+                enum: ['add', 'list', 'get', 'resolve', 'update', 'delete'],
+                description: 'The action to perform'
+            },
+            projectPath: {
+                type: 'string',
+                description: 'Absolute path to the project root (optional - uses server context path if not provided)'
+            },
+            // add params
+            title: {
+                type: 'string',
+                description: 'Title of the deferred decision (required for add)'
+            },
+            context: {
+                type: 'string',
+                description: 'Why this decision was deferred and what alternatives were considered (required for add)'
+            },
+            decision: {
+                type: 'string',
+                description: 'What specifically was not decided or not implemented (required for add)'
+            },
+            revisitTrigger: {
+                type: 'string',
+                description: 'Freeform description of when to revisit this decision (required for add)'
+            },
+            revisitCriteria: {
+                type: 'string',
+                description: 'What conditions should trigger revisiting this (optional for add, defaults to revisitTrigger)'
+            },
+            originSpec: {
+                type: 'string',
+                description: 'Spec that created this deferral (optional for add)'
+            },
+            originPhase: {
+                type: 'string',
+                enum: ['requirements', 'design', 'tasks', 'implementation'],
+                description: 'Phase where decision was deferred (optional for add)'
+            },
+            tags: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Freeform tags for filtering (optional for add/update)'
+            },
+            supersedes: {
+                type: 'string',
+                description: 'ID of deferral this one replaces — automatically marks old one as superseded (optional for add)'
+            },
+            // get/resolve/update/delete params
+            id: {
+                type: 'string',
+                description: 'Deferral ID (required for get, resolve, update, delete)'
+            },
+            // resolve params
+            resolution: {
+                type: 'string',
+                description: 'Brief note on how it was resolved (required for resolve)'
+            },
+            resolvedInSpec: {
+                type: 'string',
+                description: 'Spec that resolved this deferral (optional for resolve)'
+            },
+            // list params
+            status: {
+                type: 'string',
+                enum: ['deferred', 'resolved', 'superseded'],
+                description: 'Filter by status (optional for list, default: all statuses)'
+            },
+            tag: {
+                type: 'string',
+                description: 'Filter by tag — matches if deferral tags include this value (optional for list)'
+            }
+        },
+        required: ['action']
+    },
+    annotations: {
+        title: 'Deferrals',
+        destructiveHint: true,
+    }
+};
+export async function deferralsHandler(args, context) {
+    const projectPath = args.projectPath || context.projectPath;
+    if (!projectPath) {
+        return { success: false, message: 'Project path is required but not provided in context or arguments' };
+    }
+    try {
+        const validatedPath = await validateProjectPath(projectPath);
+        const storage = new DeferralStorage(validatedPath);
+        switch (args.action) {
+            case 'add':
+                return await handleAdd(args, storage);
+            case 'list':
+                return await handleList(args, storage);
+            case 'get':
+                return await handleGet(args, storage);
+            case 'resolve':
+                return await handleResolve(args, storage);
+            case 'update':
+                return await handleUpdate(args, storage);
+            case 'delete':
+                return await handleDelete(args, storage);
+            default:
+                return { success: false, message: `Unknown action: ${args.action}. Use 'add', 'list', 'get', 'resolve', 'update', or 'delete'.` };
+        }
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        return { success: false, message: `Deferrals operation failed: ${msg}` };
+    }
+}
+async function handleAdd(args, storage) {
+    if (!args.title || !args.context || !args.decision || !args.revisitTrigger) {
+        return { success: false, message: 'Missing required fields for add. Required: title, context, decision, revisitTrigger' };
+    }
+    const id = await storage.create({
+        title: args.title,
+        originSpec: args.originSpec || null,
+        originPhase: args.originPhase || null,
+        revisitTrigger: args.revisitTrigger,
+        tags: args.tags || [],
+        supersedes: args.supersedes || null,
+        body: {
+            context: args.context,
+            decision: args.decision,
+            revisitCriteria: args.revisitCriteria || args.revisitTrigger,
+        },
+    }, args.supersedes);
+    return {
+        success: true,
+        message: `Deferred decision recorded: ${id}`,
+        data: { id, title: args.title },
+    };
+}
+async function handleList(args, storage) {
+    const deferrals = await storage.list({
+        status: args.status,
+        originSpec: args.originSpec,
+        tag: args.tag,
+    });
+    const summary = deferrals.map(d => ({
+        id: d.id,
+        status: d.status,
+        title: d.title,
+        originSpec: d.originSpec,
+        tags: d.tags,
+        revisitTrigger: d.revisitTrigger,
+        createdAt: d.createdAt,
+    }));
+    return {
+        success: true,
+        message: `Found ${deferrals.length} deferral(s)`,
+        data: { deferrals: summary, total: deferrals.length },
+    };
+}
+async function handleGet(args, storage) {
+    if (!args.id) {
+        return { success: false, message: 'Missing required field: id' };
+    }
+    const deferral = await storage.get(args.id);
+    if (!deferral) {
+        return { success: false, message: `Deferral ${args.id} not found` };
+    }
+    return {
+        success: true,
+        message: `Deferral ${args.id}: ${deferral.title}`,
+        data: deferral,
+    };
+}
+async function handleResolve(args, storage) {
+    if (!args.id || !args.resolution) {
+        return { success: false, message: 'Missing required fields for resolve. Required: id, resolution' };
+    }
+    await storage.resolve(args.id, args.resolution, args.resolvedInSpec);
+    return {
+        success: true,
+        message: `Deferral ${args.id} resolved`,
+        data: { id: args.id, resolution: args.resolution },
+    };
+}
+async function handleUpdate(args, storage) {
+    if (!args.id) {
+        return { success: false, message: 'Missing required field: id' };
+    }
+    const updates = {};
+    for (const key of ['title', 'revisitTrigger', 'tags', 'context', 'decision', 'revisitCriteria']) {
+        if (args[key] !== undefined)
+            updates[key] = args[key];
+    }
+    if (Object.keys(updates).length === 0) {
+        return { success: false, message: 'No fields to update. Updatable: title, revisitTrigger, tags, context, decision, revisitCriteria' };
+    }
+    await storage.update(args.id, updates);
+    return {
+        success: true,
+        message: `Deferral ${args.id} updated`,
+        data: { id: args.id, updatedFields: Object.keys(updates) },
+    };
+}
+async function handleDelete(args, storage) {
+    if (!args.id) {
+        return { success: false, message: 'Missing required field: id' };
+    }
+    await storage.delete(args.id);
+    return {
+        success: true,
+        message: `Deferral ${args.id} deleted`,
+        data: { id: args.id },
+    };
+}
+//# sourceMappingURL=deferrals.js.map

package/dist/tools/deferrals.js.map

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

package/dist/tools/get-task-review.d.ts

@@ -0,0 +1,5 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import { ToolContext, ToolResponse } from '../types.js';
+export declare const getTaskReviewTool: Tool;
+export declare function getTaskReviewHandler(args: any, context: ToolContext): Promise<ToolResponse>;
+//# sourceMappingURL=get-task-review.d.ts.map

package/dist/tools/get-task-review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-task-review.d.ts","sourceRoot":"","sources":["../../src/tools/get-task-review.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIxD,eAAO,MAAM,iBAAiB,EAAE,IAoC/B,CAAC;AAEF,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,GAAG,EACT,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,YAAY,CAAC,CAsGvB"}

package/dist/tools/get-task-review.js

@@ -0,0 +1,136 @@
+import { PathUtils } from '../core/path-utils.js';
+import { TaskReviewManager } from '../core/task-review-manager.js';
+export const getTaskReviewTool = {
+    name: 'get-task-review',
+    description: `Retrieve the findings from a completed task review.
+
+# Instructions
+
+Call this to read review findings after a dashboard-triggered or CLI-triggered review has completed for a task. Returns the full review including verdict, summary, and structured findings with severity, file locations, and categories.
+
+By default returns the latest review version. Pass a specific version number to retrieve an older review.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            projectPath: {
+                type: 'string',
+                description: 'Absolute path to the project root (optional - uses server context path if not provided)'
+            },
+            specName: {
+                type: 'string',
+                description: 'Name of the specification (kebab-case)'
+            },
+            taskId: {
+                type: 'string',
+                description: 'Task ID (e.g., "1", "1.2", "3.1.4")'
+            },
+            version: {
+                type: 'integer',
+                minimum: 1,
+                description: 'Specific review version to retrieve (optional - defaults to latest)'
+            }
+        },
+        required: ['specName', 'taskId']
+    },
+    annotations: {
+        title: 'Get Task Review',
+        readOnlyHint: true,
+    }
+};
+export async function getTaskReviewHandler(args, context) {
+    const { specName, taskId, version } = args;
+    const projectPath = args.projectPath || context.projectPath;
+    if (!projectPath) {
+        return {
+            success: false,
+            message: 'Project path is required but not provided in context or arguments'
+        };
+    }
+    const specPath = PathUtils.getSpecPath(projectPath, specName);
+    // Validate spec exists before touching TaskReviewManager (avoids phantom directory creation)
+    const { promises: fs } = await import('fs');
+    try {
+        await fs.stat(specPath);
+    }
+    catch {
+        return {
+            success: false,
+            message: `Spec '${specName}' not found at ${specPath}`,
+            nextSteps: ['Check the spec name and try again']
+        };
+    }
+    try {
+        const reviewManager = new TaskReviewManager(specPath);
+        if (version !== undefined) {
+            // Validate version is a positive integer
+            const v = parseInt(version);
+            if (!Number.isInteger(v) || v < 1) {
+                return {
+                    success: false,
+                    message: 'Version must be a positive integer (1 or greater)'
+                };
+            }
+            const reviews = await reviewManager.getReviewsForTask(taskId);
+            const review = reviews.find(r => r.version === v);
+            if (!review) {
+                if (reviews.length === 0) {
+                    return {
+                        success: false,
+                        message: `No reviews found for task '${taskId}' in spec '${specName}'`,
+                        nextSteps: ['Run a review first using review-task or the dashboard Review button']
+                    };
+                }
+                const available = reviews.map(r => r.version).join(', ');
+                return {
+                    success: false,
+                    message: `Review version ${v} not found for task '${taskId}'. Available versions: ${available}`,
+                    nextSteps: [`Use one of the available versions: ${available}`]
+                };
+            }
+            return {
+                success: true,
+                message: `Review v${review.version} for task '${taskId}': ${review.verdict}`,
+                data: { review },
+                projectContext: {
+                    projectPath,
+                    workflowRoot: PathUtils.getWorkflowRoot(projectPath),
+                    specName,
+                    dashboardUrl: context.dashboardUrl
+                }
+            };
+        }
+        // Default: get latest review
+        const review = await reviewManager.getLatestReview(taskId);
+        if (!review) {
+            return {
+                success: false,
+                message: `No reviews found for task '${taskId}' in spec '${specName}'`,
+                nextSteps: ['Run a review first using review-task or the dashboard Review button']
+            };
+        }
+        return {
+            success: true,
+            message: `Latest review (v${review.version}) for task '${taskId}': ${review.verdict}`,
+            data: { review },
+            nextSteps: review.verdict === 'fail'
+                ? ['Address the critical findings', 'Re-review after fixes using the dashboard Review button']
+                : review.verdict === 'findings'
+                    ? ['Consider addressing the warnings', 'Mark task [x] complete when satisfied']
+                    : ['Task review passed — mark task [x] complete'],
+            projectContext: {
+                projectPath,
+                workflowRoot: PathUtils.getWorkflowRoot(projectPath),
+                specName,
+                dashboardUrl: context.dashboardUrl
+            }
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            success: false,
+            message: `Failed to retrieve review: ${errorMessage}`
+        };
+    }
+}
+//# sourceMappingURL=get-task-review.js.map

package/dist/tools/get-task-review.js.map

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

package/dist/tools/index.d.ts

@@ -0,0 +1,5 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import { ToolContext, MCPToolResponse } from '../types.js';
+export declare function registerTools(): Tool[];
+export declare function handleToolCall(name: string, args: any, context: ToolContext): Promise<MCPToolResponse>;
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAY1D,OAAO,EAAE,WAAW,EAAgB,eAAe,EAAiB,MAAM,aAAa,CAAC;AAExF,wBAAgB,aAAa,IAAI,IAAI,EAAE,CActC;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC,CAwD5G"}

package/dist/tools/index.js

@@ -0,0 +1,82 @@
+import { specWorkflowGuideTool, specWorkflowGuideHandler } from './spec-workflow-guide.js';
+import { specStatusTool, specStatusHandler } from './spec-status.js';
+import { steeringGuideTool, steeringGuideHandler } from './steering-guide.js';
+import { approvalsTool, approvalsHandler } from './approvals.js';
+import { logImplementationTool, logImplementationHandler } from './log-implementation.js';
+import { deferralsTool, deferralsHandler } from './deferrals.js';
+import { adversarialReviewTool, adversarialReviewHandler } from './adversarial-review.js';
+import { adversarialResponseTool, adversarialResponseHandler } from './adversarial-response.js';
+import { decompositionGuideTool, decompositionGuideHandler } from './decomposition-guide.js';
+import { reviewTaskTool, reviewTaskHandler } from './review-task.js';
+import { getTaskReviewTool, getTaskReviewHandler } from './get-task-review.js';
+import { toMCPResponse } from '../types.js';
+export function registerTools() {
+    return [
+        specWorkflowGuideTool,
+        steeringGuideTool,
+        specStatusTool,
+        approvalsTool,
+        logImplementationTool,
+        deferralsTool,
+        adversarialReviewTool,
+        adversarialResponseTool,
+        decompositionGuideTool,
+        reviewTaskTool,
+        getTaskReviewTool
+    ];
+}
+export async function handleToolCall(name, args, context) {
+    let response;
+    let isError = false;
+    try {
+        switch (name) {
+            case 'spec-workflow-guide':
+                response = await specWorkflowGuideHandler(args, context);
+                break;
+            case 'steering-guide':
+                response = await steeringGuideHandler(args, context);
+                break;
+            case 'spec-status':
+                response = await specStatusHandler(args, context);
+                break;
+            case 'approvals':
+                response = await approvalsHandler(args, context);
+                break;
+            case 'log-implementation':
+                response = await logImplementationHandler(args, context);
+                break;
+            case 'deferrals':
+                response = await deferralsHandler(args, context);
+                break;
+            case 'adversarial-review':
+                response = await adversarialReviewHandler(args, context);
+                break;
+            case 'adversarial-response':
+                response = await adversarialResponseHandler(args, context);
+                break;
+            case 'decomposition-guide':
+                response = await decompositionGuideHandler(args, context);
+                break;
+            case 'review-task':
+                response = await reviewTaskHandler(args, context);
+                break;
+            case 'get-task-review':
+                response = await getTaskReviewHandler(args, context);
+                break;
+            default:
+                throw new Error(`Unknown tool: ${name}`);
+        }
+        // Check if the response indicates an error
+        isError = !response.success;
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        response = {
+            success: false,
+            message: `Tool execution failed: ${errorMessage}`
+        };
+        isError = true;
+    }
+    return toMCPResponse(response, isError);
+}
+//# sourceMappingURL=index.js.map