@arimakouyou/spec-workflow-mcp 2.2.7

package/dist/prompts/refresh-tasks.js

@@ -0,0 +1,237 @@
+import { PathUtils } from '../core/path-utils.js';
+import { readFile } from 'fs/promises';
+import { join } from 'path';
+const prompt = {
+    name: 'refresh-tasks',
+    title: 'Refresh Tasks After Spec Changes',
+    description: 'Comprehensive guide for updating tasks.md when requirements or design change during implementation. Preserves completed work while aligning pending tasks with current spec.',
+    arguments: [
+        {
+            name: 'specName',
+            description: 'Name of the specification to refresh tasks for',
+            required: true
+        },
+        {
+            name: 'changes',
+            description: 'Description of what changed in requirements or design',
+            required: false
+        }
+    ]
+};
+async function handler(args, context) {
+    const { specName, changes = 'Requirements or design have been updated' } = args;
+    const projectPath = context.projectPath;
+    // Try to load existing documents for context
+    let contextInfo = '';
+    try {
+        const specDir = PathUtils.getSpecPath(projectPath, specName);
+        // Check what documents exist
+        let hasRequirements = false;
+        let hasDesign = false;
+        let hasTasks = false;
+        try {
+            await readFile(join(specDir, 'requirements.md'), 'utf-8');
+            hasRequirements = true;
+        }
+        catch (error) {
+            // File doesn't exist
+        }
+        try {
+            await readFile(join(specDir, 'design.md'), 'utf-8');
+            hasDesign = true;
+        }
+        catch (error) {
+            // File doesn't exist
+        }
+        try {
+            await readFile(join(specDir, 'tasks.md'), 'utf-8');
+            hasTasks = true;
+        }
+        catch (error) {
+            // File doesn't exist
+        }
+        contextInfo = `
+## Current Spec Status for "${specName}"
+- Requirements.md exists: ${hasRequirements ? 'Yes' : 'No'}
+- Design.md exists: ${hasDesign ? 'Yes' : 'No'}
+- Tasks.md exists: ${hasTasks ? 'Yes' : 'No'}
+
+## Reported Changes
+${changes}
+`;
+    }
+    catch (error) {
+        contextInfo = `
+## Spec: "${specName}"
+Unable to check existing documents. Ensure the spec exists at the correct path.
+
+## Reported Changes
+${changes}
+`;
+    }
+    const content = `# Task Refresh Instructions
+
+${contextInfo}
+
+## Context
+You are refreshing the task list for specification "${specName}" because requirements or design have changed during implementation. Your goal is to ensure the task list accurately reflects what needs to be done to bridge the gap between current implementation and the updated requirements/design.
+
+## CRITICAL: Source of Truth
+- Requirements come ONLY from requirements.md - not from existing tasks
+- Design decisions come ONLY from design.md - not from existing tasks
+- Tasks are implementation steps - they implement requirements, they don't define them
+- If a feature exists in tasks but NOT in requirements.md/design.md, it has been REMOVED from the spec
+
+## Three-Pass Validation Process
+
+### PASS 1: Validate Existing Tasks Against Current Spec
+For each existing task, verify if the feature it implements still exists in requirements.md or design.md.
+
+Actions for PENDING tasks:
+- KEEP if the feature is still in requirements/design
+- REMOVE if the feature is NOT in requirements/design (feature was cut from spec)
+
+Actions for COMPLETED/IN-PROGRESS tasks:
+- ALWAYS PRESERVE completed [x] and in-progress [-] tasks exactly as written
+- If the feature was removed, add a note: "_Note: Feature removed from spec but task preserved_"
+- If architecture changed, add migration tasks immediately after the completed work
+
+### PASS 2: Gap Analysis
+For each requirement in requirements.md, verify corresponding task coverage exists.
+For each design decision in design.md, verify tasks align with the architecture.
+
+Actions:
+- ADD new tasks for requirements/design elements without task coverage
+- ADD migration tasks when architecture changes affect completed work
+- UPDATE pending tasks that need alignment with updated requirements
+
+### PASS 3: Create Updated Task List
+After Pass 1 and Pass 2, determine if changes are needed:
+- Are there pending tasks to remove?
+- Are there new tasks to add?
+- Are there migration tasks needed?
+- Are there existing tasks to modify?
+
+If NO changes needed: Report "Task list is already aligned with current requirements - no refresh needed" and STOP.
+
+If changes ARE needed, build the new tasks.md with:
+1. All completed [x] tasks preserved exactly as written
+2. All in-progress [-] tasks preserved exactly as written
+3. Migration tasks added where architecture changes affect completed work
+4. Only pending [ ] tasks that have backing in current requirements/design
+5. New tasks for any missing requirements/design elements
+6. Proper sequencing and requirement references
+
+## Handling Architecture Changes
+
+When architecture changes affect already-implemented code, add migration tasks:
+
+Example: MongoDB to PostgreSQL switch with completed MongoDB work:
+- [x] 2.1 Create MongoDB connection logic
+- [x] 2.2 Define MongoDB schemas
+- [x] 2.3 Implement MongoDB queries
+- [ ] 2.4 Migrate MongoDB schemas to PostgreSQL tables (NEW)
+- [ ] 2.5 Replace MongoDB connection with PostgreSQL client (NEW)
+- [ ] 2.6 Convert MongoDB queries to PostgreSQL syntax (NEW)
+- [ ] 2.7 Migrate existing data from MongoDB to PostgreSQL (NEW)
+- [ ] 2.8 Verify data integrity after migration (NEW)
+- [ ] 2.9 Remove MongoDB dependencies after verification (NEW)
+- [ ] 2.10 Implement remaining PostgreSQL features
+
+Example: REST to GraphQL migration with completed REST endpoints:
+- [x] 3.1 Implement user REST endpoints
+- [x] 3.2 Implement product REST endpoints
+- [ ] 3.3 Define GraphQL schema for users and products (NEW)
+- [ ] 3.4 Create GraphQL resolvers wrapping REST logic (NEW)
+- [ ] 3.5 Update client to use GraphQL queries (NEW)
+- [ ] 3.6 Test GraphQL implementation thoroughly (NEW)
+- [ ] 3.7 Remove REST endpoints after GraphQL verified (NEW)
+
+## Task Format Requirements
+Each task must follow this format (with phase headings and _TestFocus):
+
+## Phase 1: Core Domain Layer
+
+- [ ] 1.1 Create user authentication interface
+  - File: src/auth/UserAuth.ts
+  - Implement login and registration forms
+  - Add form validation and error handling
+  - Purpose: Enable user account management
+  - _Leverage: src/components/BaseForm.tsx, src/utils/validation.ts_
+  - _Requirements: 1.1, 1.2_
+  - _TestFocus: Form validation, auth flow, error handling_
+
+- [ ] 1.2 Review and commit Phase 1
+  - _PhaseReview: true_
+  - _Prompt: Role: Code reviewer | Task: Review Phase 1 changes, run tests, commit | Success: All tests pass, committed_
+
+Migration tasks should follow this format:
+- [ ] 2.4 Migrate MongoDB schemas to PostgreSQL tables
+  - File: src/database/migrations/mongo-to-postgres.ts
+  - Convert document schemas to relational tables
+  - Map embedded documents to foreign key relationships
+  - Preserve all existing data relationships
+  - Purpose: Transition database layer to new architecture
+  - _Leverage: Completed MongoDB schemas in tasks 2.1-2.3_
+  - _Requirements: Design section 3.2_
+  - _TestFocus: Schema mapping correctness, data integrity, relationship preservation_
+
+## Critical Rules
+- ALWAYS preserve completed [x] tasks exactly as written
+- ALWAYS preserve in-progress [-] tasks exactly as written
+- ALWAYS add migration tasks when architecture changes affect completed work
+- ALWAYS reference specific requirements (e.g., _Requirements: 1.1, 2.3_)
+- ENSURE tasks build incrementally with proper dependencies
+- MAKE tasks atomic, specific, and actionable
+- PRESERVE the original tasks.md structure and format
+- KEEP tasks.md clean - only include the task list itself
+- DO NOT create standalone test tasks — TDD handles testing automatically in each task
+- PRESERVE phase structure (## Phase headings). Add new tasks to the appropriate phase, or create a new phase
+- PRESERVE _TestFocus fields on existing tasks and add them to new tasks
+- PRESERVE _PhaseReview tasks at the end of each phase
+
+## Progressive Migration Strategy
+
+For major architecture changes, create tasks that support progressive migration:
+1. Implement new architecture alongside existing
+2. Add compatibility layer tasks
+3. Migrate functionality incrementally
+4. Verify each migration step
+5. Remove old implementation only after full verification
+
+This ensures the application remains functional throughout the transition.
+
+## Implementation Steps
+1. Read requirements.md and design.md carefully - these define what should exist
+2. Read current tasks.md and identify completed, in-progress, and pending tasks
+3. Perform Pass 1: Validate existing tasks against current spec
+4. Perform Pass 2: Identify gaps in task coverage
+5. Determine if changes are needed
+6. If changes needed, build updated task list with proper validation
+7. Use create-spec-doc tool to save the updated tasks.md
+8. Report what changes were made and why
+
+## Example Analysis Output
+
+When refreshing tasks, provide clear feedback:
+
+"Task Refresh Analysis:
+- Preserved: 5 completed tasks, 2 in-progress tasks
+- Removed: 3 pending tasks for deleted reporting feature
+- Added: 4 migration tasks for MongoDB to PostgreSQL transition
+- Added: 6 new tasks for social login feature
+- Updated: 2 pending tasks to align with new API design
+
+The tasks.md has been updated to reflect current requirements while preserving all completed work."`;
+    return [
+        {
+            role: 'user',
+            content: { type: 'text', text: content }
+        }
+    ];
+}
+export const refreshTasksPrompt = {
+    prompt,
+    handler
+};
+//# sourceMappingURL=refresh-tasks.js.map

package/dist/prompts/refresh-tasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refresh-tasks.js","sourceRoot":"","sources":["../../src/prompts/refresh-tasks.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,MAAM,MAAM,GAAW;IACrB,IAAI,EAAE,eAAe;IACrB,KAAK,EAAE,kCAAkC;IACzC,WAAW,EAAE,8KAA8K;IAC3L,SAAS,EAAE;QACT;YACE,IAAI,EAAE,UAAU;YAChB,WAAW,EAAE,gDAAgD;YAC7D,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,uDAAuD;YACpE,QAAQ,EAAE,KAAK;SAChB;KACF;CACF,CAAC;AAEF,KAAK,UAAU,OAAO,CAAC,IAAyB,EAAE,OAAoB;IACpE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,0CAA0C,EAAE,GAAG,IAAI,CAAC;IAChF,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IAExC,6CAA6C;IAC7C,IAAI,WAAW,GAAG,EAAE,CAAC;IACrB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,SAAS,CAAC,WAAW,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QAE7D,6BAA6B;QAC7B,IAAI,eAAe,GAAG,KAAK,CAAC;QAC5B,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,IAAI,QAAQ,GAAG,KAAK,CAAC;QAErB,IAAI,CAAC;YACH,MAAM,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,iBAAiB,CAAC,EAAE,OAAO,CAAC,CAAC;YAC1D,eAAe,GAAG,IAAI,CAAC;QACzB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,qBAAqB;QACvB,CAAC;QAED,IAAI,CAAC;YACH,MAAM,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE,OAAO,CAAC,CAAC;YACpD,SAAS,GAAG,IAAI,CAAC;QACnB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,qBAAqB;QACvB,CAAC;QAED,IAAI,CAAC;YACH,MAAM,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,OAAO,CAAC,CAAC;YACnD,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,qBAAqB;QACvB,CAAC;QAED,WAAW,GAAG;8BACY,QAAQ;4BACV,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;sBACpC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;qBACzB,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;;;EAG1C,OAAO;CACR,CAAC;IACA,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,WAAW,GAAG;YACN,QAAQ;;;;EAIlB,OAAO;CACR,CAAC;IACA,CAAC;IAED,MAAM,OAAO,GAAG;;EAEhB,WAAW;;;sDAGyC,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oGAoJsC,CAAC;IAEnG,OAAO;QACL;YACE,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE;SACzC;KACF,CAAC;AAAA,CAAC;AAEL,MAAM,CAAC,MAAM,kBAAkB,GAAqB;IAClD,MAAM;IACN,OAAO;CACR,CAAC"}

package/dist/prompts/spec-status.d.ts

@@ -0,0 +1,3 @@
+import { PromptDefinition } from './types.js';
+export declare const specStatusPrompt: PromptDefinition;
+//# sourceMappingURL=spec-status.d.ts.map

package/dist/prompts/spec-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-status.d.ts","sourceRoot":"","sources":["../../src/prompts/spec-status.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAgF9C,eAAO,MAAM,gBAAgB,EAAE,gBAG9B,CAAC"}

package/dist/prompts/spec-status.js

@@ -0,0 +1,77 @@
+const prompt = {
+    name: 'spec-status',
+    title: 'Specification Status Overview',
+    description: 'Get comprehensive status overview of specification documents, tasks, and approval workflows. Useful for project tracking and progress reporting.',
+    arguments: [
+        {
+            name: 'specName',
+            description: 'Feature name in kebab-case to get status for (optional - if not provided, shows all specs)',
+            required: false
+        },
+        {
+            name: 'detailed',
+            description: 'Show detailed status including task breakdown and approval history',
+            required: false
+        }
+    ]
+};
+async function handler(args, context) {
+    const { specName, detailed } = args;
+    const scope = specName ? `the "${specName}" feature` : 'all specifications in the project';
+    const detailLevel = detailed ? 'detailed' : 'summary';
+    const messages = [
+        {
+            role: 'user',
+            content: {
+                type: 'text',
+                text: `Get ${detailLevel} status overview for ${scope}.
+
+**Context:**
+- Project: ${context.projectPath}
+${specName ? `- Feature: ${specName}` : '- Scope: All specifications'}
+- Detail level: ${detailLevel}
+${context.dashboardUrl ? `- Dashboard: ${context.dashboardUrl}` : ''}
+
+**Instructions:**
+${specName ?
+                    `1. Use the spec-status tool with specName "${specName}" to get status information
+2. If you need detailed task information, read the tasks.md file directly at .spec-workflow/specs/${specName}/tasks.md
+3. Check for any pending approvals using approvals tool with action:'status'` :
+                    `1. List directory .spec-workflow/specs/ to see all specifications
+2. Use the spec-status tool to get status for each specification
+3. Provide a consolidated overview of project progress`}
+
+**Status Information Includes:**
+- **Document Status**: Which documents exist (requirements, design, tasks)
+- **Task Progress**: Completion status and remaining work
+- **Approval Status**: Pending, approved, or rejected approvals
+- **File Information**: Last modified dates and file sizes
+- **Workflow Stage**: Current phase in the spec-driven development process
+
+**Workflow Stages:**
+1. **Planning**: Requirements document created and approved
+2. **Design**: Design document created and approved
+3. **Test Design**: Test design document (UT/IT/E2E specifications) created and approved
+4. **Task Breakdown**: Tasks defined based on design and test design
+5. **Implementation**: Tasks implementation in progress
+6. **Review**: Implementation complete, awaiting final approval
+7. **Complete**: All tasks complete and approved
+
+${detailed ? `**Detailed Information Includes:**
+- Individual task breakdown with completion status
+- Approval request history and reviewer comments
+- File modification timestamps
+- Steering document references
+- Dependency tracking between specs` : ''}
+
+Please provide a comprehensive status report that helps understand the current state and next steps.`
+            }
+        }
+    ];
+    return messages;
+}
+export const specStatusPrompt = {
+    prompt,
+    handler
+};
+//# sourceMappingURL=spec-status.js.map

package/dist/prompts/spec-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-status.js","sourceRoot":"","sources":["../../src/prompts/spec-status.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,GAAW;IACrB,IAAI,EAAE,aAAa;IACnB,KAAK,EAAE,+BAA+B;IACtC,WAAW,EAAE,kJAAkJ;IAC/J,SAAS,EAAE;QACT;YACE,IAAI,EAAE,UAAU;YAChB,WAAW,EAAE,4FAA4F;YACzG,QAAQ,EAAE,KAAK;SAChB;QACD;YACE,IAAI,EAAE,UAAU;YAChB,WAAW,EAAE,oEAAoE;YACjF,QAAQ,EAAE,KAAK;SAChB;KACF;CACF,CAAC;AAEF,KAAK,UAAU,OAAO,CAAC,IAAyB,EAAE,OAAoB;IACpE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;IAEpC,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,QAAQ,QAAQ,WAAW,CAAC,CAAC,CAAC,mCAAmC,CAAC;IAC3F,MAAM,WAAW,GAAG,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;IAEtD,MAAM,QAAQ,GAAoB;QAChC;YACE,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE;gBACP,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,OAAO,WAAW,wBAAwB,KAAK;;;aAGhD,OAAO,CAAC,WAAW;EAC9B,QAAQ,CAAC,CAAC,CAAC,cAAc,QAAQ,EAAE,CAAC,CAAC,CAAC,6BAA6B;kBACnD,WAAW;EAC3B,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,gBAAgB,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE;;;EAGlE,QAAQ,CAAC,CAAC;oBACV,8CAA8C,QAAQ;oGAC4C,QAAQ;6EAC/B,CAAC,CAAC;oBAC7E;;uDAEqD;;;;;;;;;;;;;;;;;;EAkBrD,QAAQ,CAAC,CAAC,CAAC;;;;;oCAKuB,CAAC,CAAC,CAAC,EAAE;;qGAE4D;aAC9F;SACF;KACF,CAAC;IAEF,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAqB;IAChD,MAAM;IACN,OAAO;CACR,CAAC"}

package/dist/prompts/types.d.ts

@@ -0,0 +1,13 @@
+import { Prompt, PromptMessage } from '@modelcontextprotocol/sdk/types.js';
+import { ToolContext } from '../types.js';
+export interface PromptHandler {
+    (args: Record<string, any>, context: ToolContext): Promise<PromptMessage[]>;
+}
+export interface PromptDefinition {
+    prompt: Prompt;
+    handler: PromptHandler;
+}
+export interface PromptResponse {
+    messages: PromptMessage[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/prompts/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/prompts/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,aAAa,EAAkB,MAAM,oCAAoC,CAAC;AAC3F,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,WAAW,aAAa;IAC5B,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;CAC7E;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,aAAa,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B"}

package/dist/prompts/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/prompts/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/prompts/types.ts"],"names":[],"mappings":""}

package/dist/server.d.ts

@@ -0,0 +1,17 @@
+export declare class SpecWorkflowMCPServer {
+    private server;
+    private projectPath;
+    private workspacePath;
+    private projectRegistry;
+    private lang?;
+    constructor();
+    initialize(projectPath: string, workspacePath: string, lang?: string): Promise<void>;
+    private setupHandlers;
+    /**
+     * Check if running in Docker mode (path translation enabled)
+     * When in Docker, we can't verify host PIDs and want projects to persist
+     */
+    private isDockerMode;
+    stop(): Promise<void>;
+}
+//# 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":"AAoBA,qBAAa,qBAAqB;IAChC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAU;IAC7B,OAAO,CAAC,aAAa,CAAU;IAC/B,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,IAAI,CAAC,CAAS;;IAiChB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;IA4E1E,OAAO,CAAC,aAAa;IAoCrB;;;OAGG;IACH,OAAO,CAAC,YAAY;IAMd,IAAI;CAuBX"}

package/dist/server.js

@@ -0,0 +1,175 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema, McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
+import { registerTools, handleToolCall } from './tools/index.js';
+import { registerPrompts, handlePromptList, handlePromptGet } from './prompts/index.js';
+import { validateProjectPath } from './core/path-utils.js';
+import { WorkspaceInitializer } from './core/workspace-initializer.js';
+import { ProjectRegistry } from './core/project-registry.js';
+import { DashboardSessionManager } from './core/dashboard-session.js';
+import { readFileSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+export class SpecWorkflowMCPServer {
+    server;
+    projectPath; // workflowRootPath for .spec-workflow operations
+    workspacePath; // workspace/worktree path for identity in registry
+    projectRegistry;
+    lang;
+    constructor() {
+        // Get version from package.json
+        const __dirname = dirname(fileURLToPath(import.meta.url));
+        const packageJsonPath = join(__dirname, '..', 'package.json');
+        const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+        // Get all registered tools and prompts
+        const tools = registerTools();
+        const prompts = registerPrompts();
+        // Create tools capability object with each tool name
+        const toolsCapability = tools.reduce((acc, tool) => {
+            acc[tool.name] = {};
+            return acc;
+        }, {});
+        this.server = new Server({
+            name: 'spec-workflow-mcp',
+            version: packageJson.version
+        }, {
+            capabilities: {
+                tools: toolsCapability,
+                prompts: {
+                    listChanged: true
+                }
+            }
+        });
+        this.projectRegistry = new ProjectRegistry();
+    }
+    async initialize(projectPath, workspacePath, lang) {
+        this.projectPath = projectPath;
+        this.workspacePath = workspacePath;
+        this.lang = lang;
+        try {
+            // Validate project path
+            await validateProjectPath(this.projectPath);
+            await validateProjectPath(this.workspacePath);
+            // Initialize workspace
+            const __dirname = dirname(fileURLToPath(import.meta.url));
+            const packageJsonPath = join(__dirname, '..', 'package.json');
+            const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+            const workspaceInitializer = new WorkspaceInitializer(this.projectPath, packageJson.version);
+            await workspaceInitializer.initializeWorkspace();
+            // Register this project in the global registry
+            const projectId = await this.projectRegistry.registerProject(this.workspacePath, process.pid, {
+                workflowRootPath: this.projectPath
+            });
+            console.error(`Project registered: ${projectId}`);
+            // Try to get the dashboard URL from session manager
+            let dashboardUrl = undefined;
+            try {
+                const sessionManager = new DashboardSessionManager();
+                const dashboardSession = await sessionManager.getDashboardSession();
+                if (dashboardSession) {
+                    dashboardUrl = dashboardSession.url;
+                }
+            }
+            catch (error) {
+                // Dashboard not running, continue without it
+            }
+            // Create context for tools
+            const context = {
+                projectPath: this.projectPath,
+                dashboardUrl: dashboardUrl,
+                lang: this.lang
+            };
+            // Register handlers
+            this.setupHandlers(context);
+            // Connect to stdio transport
+            const transport = new StdioServerTransport();
+            // Handle client disconnection - exit gracefully when transport closes
+            transport.onclose = async () => {
+                await this.stop();
+                process.exit(0);
+            };
+            await this.server.connect(transport);
+            // Monitor stdin for client disconnection (additional safety net)
+            process.stdin.on('end', async () => {
+                await this.stop();
+                process.exit(0);
+            });
+            // Handle stdin errors
+            process.stdin.on('error', async (error) => {
+                console.error('stdin error:', error);
+                await this.stop();
+                process.exit(1);
+            });
+            // MCP server initialized successfully
+        }
+        catch (error) {
+            throw error;
+        }
+    }
+    setupHandlers(context) {
+        // Tool handlers
+        this.server.setRequestHandler(ListToolsRequestSchema, async () => ({
+            tools: registerTools()
+        }));
+        this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            try {
+                return await handleToolCall(request.params.name, request.params.arguments || {}, context);
+            }
+            catch (error) {
+                throw new McpError(ErrorCode.InternalError, error.message);
+            }
+        });
+        // Prompt handlers
+        this.server.setRequestHandler(ListPromptsRequestSchema, async () => {
+            try {
+                return await handlePromptList();
+            }
+            catch (error) {
+                throw new McpError(ErrorCode.InternalError, error.message);
+            }
+        });
+        this.server.setRequestHandler(GetPromptRequestSchema, async (request) => {
+            try {
+                return await handlePromptGet(request.params.name, request.params.arguments || {}, context);
+            }
+            catch (error) {
+                throw new McpError(ErrorCode.InternalError, error.message);
+            }
+        });
+    }
+    /**
+     * Check if running in Docker mode (path translation enabled)
+     * When in Docker, we can't verify host PIDs and want projects to persist
+     */
+    isDockerMode() {
+        const hostPrefix = process.env.SPEC_WORKFLOW_HOST_PATH_PREFIX;
+        const containerPrefix = process.env.SPEC_WORKFLOW_CONTAINER_PATH_PREFIX;
+        return !!(hostPrefix && containerPrefix);
+    }
+    async stop() {
+        try {
+            // Only unregister when NOT in Docker mode
+            // In Docker, projects should persist across sessions since we can't verify host PIDs
+            if (!this.isDockerMode()) {
+                try {
+                    // Pass current PID to only remove this specific instance
+                    await this.projectRegistry.unregisterProject(this.workspacePath, process.pid);
+                    console.error('Project instance unregistered from global registry');
+                }
+                catch (error) {
+                    // Ignore errors during cleanup
+                }
+            }
+            else {
+                console.error('Docker mode: skipping project unregistration (projects persist across sessions)');
+            }
+            // Stop MCP server
+            await this.server.close();
+        }
+        catch (error) {
+            console.error('Error during shutdown:', error);
+            // Continue with shutdown even if there are errors
+        }
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/tools/__tests__/log-implementation-review-process.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=log-implementation-review-process.test.d.ts.map

package/dist/tools/__tests__/log-implementation-review-process.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-implementation-review-process.test.d.ts","sourceRoot":"","sources":["../../../src/tools/__tests__/log-implementation-review-process.test.ts"],"names":[],"mappings":""}