@lbruton/spec-workflow-mcp 2.2.4

package/dist/tools/log-implementation.js

@@ -0,0 +1,397 @@
+import { PathUtils } from '../core/path-utils.js';
+import { ImplementationLogManager } from '../dashboard/implementation-log-manager.js';
+import { parseTasksFromMarkdown } from '../core/task-parser.js';
+export const logImplementationTool = {
+    name: 'log-implementation',
+    description: `Record comprehensive implementation details for a completed task.
+
+⚠️ CRITICAL: Artifacts are REQUIRED. This creates a searchable knowledge base that future AI agents use to discover existing code and avoid duplication.
+
+# WHY DETAILED LOGGING MATTERS
+
+Future AI agents (and future you) will use grep/ripgrep to search implementation logs before implementing new tasks. Complete logs prevent:
+- ❌ Creating duplicate API endpoints
+- ❌ Reimplementing existing components
+- ❌ Duplicating utility functions and business logic
+- ❌ Breaking established integration patterns
+
+Incomplete logs = Duplicated code = Technical debt
+
+# REQUIRED FIELDS
+
+## artifacts (REQUIRED - Object)
+
+Contains structured data about what was implemented. Must include relevant artifact types:
+
+### apiEndpoints (array of API endpoint objects)
+When new API endpoints are created/modified, document:
+- method: HTTP method (GET, POST, PUT, DELETE, PATCH)
+- path: Route path (e.g., "/api/specs/:name/logs")
+- purpose: What this endpoint does
+- requestFormat: Request body/query params format (JSON schema or example)
+- responseFormat: Response structure (JSON schema or example)
+- location: File path and line number (e.g., "src/server.ts:245")
+
+Example:
+\`\`\`
+{
+  "method": "GET",
+  "path": "/api/specs/:name/implementation-log",
+  "purpose": "Retrieve implementation logs with optional filtering",
+  "requestFormat": "Query params: taskId (string, optional), search (string, optional)",
+  "responseFormat": "{ entries: ImplementationLogEntry[] }",
+  "location": "src/dashboard/server.ts:245"
+}
+\`\`\`
+
+### components (array of component objects)
+When reusable UI components are created, document:
+- name: Component name
+- type: Framework type (React, Vue, Svelte, etc.)
+- purpose: What the component does
+- location: File path
+- props: Props interface or type signature
+- exports: What it exports (array of export names)
+
+Example:
+\`\`\`
+{
+  "name": "LogsPage",
+  "type": "React",
+  "purpose": "Main dashboard page for viewing implementation logs with search and filtering",
+  "location": "src/modules/pages/LogsPage.tsx",
+  "props": "{ specs: any[], selectedSpec: string, onSelect: (value: string) => void }",
+  "exports": ["LogsPage (default)"]
+}
+\`\`\`
+
+### functions (array of function objects)
+When utility functions are created, document:
+- name: Function name
+- purpose: What it does
+- location: File path and line
+- signature: Function signature (params and return type)
+- isExported: Whether it can be imported
+
+Example:
+\`\`\`
+{
+  "name": "searchLogs",
+  "purpose": "Search implementation logs by keyword",
+  "location": "src/dashboard/implementation-log-manager.ts:156",
+  "signature": "(searchTerm: string) => Promise<ImplementationLogEntry[]>",
+  "isExported": true
+}
+\`\`\`
+
+### classes (array of class objects)
+When classes are created, document:
+- name: Class name
+- purpose: What the class does
+- location: File path
+- methods: List of public methods
+- isExported: Whether it can be imported
+
+Example:
+\`\`\`
+{
+  "name": "ImplementationLogManager",
+  "purpose": "Manages CRUD operations for implementation logs",
+  "location": "src/dashboard/implementation-log-manager.ts",
+  "methods": ["loadLog", "addLogEntry", "getAllLogs", "searchLogs", "getTaskStats"],
+  "isExported": true
+}
+\`\`\`
+
+### integrations (array of integration objects)
+Document how frontend connects to backend:
+- description: How components connect to APIs
+- frontendComponent: Which component initiates the connection
+- backendEndpoint: Which API endpoint is called
+- dataFlow: Describe the data flow (e.g., "User clicks → API call → State update → Re-render")
+
+Example:
+\`\`\`
+{
+  "description": "LogsPage fetches logs via REST API and subscribes to WebSocket for real-time updates",
+  "frontendComponent": "LogsPage",
+  "backendEndpoint": "GET /api/specs/:name/implementation-log",
+  "dataFlow": "Component mount → API fetch → Display logs → WebSocket subscription → Real-time updates on new entries"
+}
+\`\`\`
+
+# GOOD EXAMPLE (Include ALL relevant artifacts)
+
+Task: "Implemented logs dashboard with real-time updates"
+
+\`\`\`json
+{
+  "taskId": "2.3",
+  "summary": "Implemented real-time implementation logs dashboard with filtering, search, and WebSocket updates",
+  "artifacts": {
+    "apiEndpoints": [
+      {
+        "method": "GET",
+        "path": "/api/specs/:name/implementation-log",
+        "purpose": "Retrieve implementation logs with optional filtering",
+        "requestFormat": "Query params: taskId (string, optional), search (string, optional)",
+        "responseFormat": "{ entries: ImplementationLogEntry[] }",
+        "location": "src/dashboard/server.ts:245"
+      }
+    ],
+    "components": [
+      {
+        "name": "LogsPage",
+        "type": "React",
+        "purpose": "Main dashboard page for viewing implementation logs with search and filtering",
+        "location": "src/modules/pages/LogsPage.tsx",
+        "props": "None (uses React Router params)",
+        "exports": ["LogsPage (default)"]
+      }
+    ],
+    "classes": [
+      {
+        "name": "ImplementationLogManager",
+        "purpose": "Manages CRUD operations for implementation logs",
+        "location": "src/dashboard/implementation-log-manager.ts",
+        "methods": ["loadLog", "addLogEntry", "getAllLogs", "searchLogs", "getTaskStats"],
+        "isExported": true
+      }
+    ],
+    "integrations": [
+      {
+        "description": "LogsPage fetches logs via REST API and subscribes to WebSocket for real-time updates",
+        "frontendComponent": "LogsPage",
+        "backendEndpoint": "GET /api/specs/:name/implementation-log",
+        "dataFlow": "Component mount → API fetch → Display logs → WebSocket subscription → Real-time updates on new entries"
+      }
+    ]
+  },
+  "filesModified": ["src/dashboard/server.ts"],
+  "filesCreated": ["src/modules/pages/LogsPage.tsx"],
+  "statistics": { "linesAdded": 650, "linesRemoved": 15, "filesChanged": 2 }
+}
+\`\`\`
+
+# BAD EXAMPLE (Don't do this)
+
+❌ Empty artifacts - Future agents learn nothing:
+\`\`\`json
+{
+  "taskId": "2.3",
+  "summary": "Added endpoint and page",
+  "artifacts": {},
+  "filesModified": ["server.ts"],
+  "filesCreated": ["LogsPage.tsx"]
+}
+\`\`\`
+
+❌ Vague summary with no structured data:
+\`\`\`json
+{
+  "taskId": "2.3",
+  "summary": "Implemented features",
+  "artifacts": {},
+  "filesModified": ["server.ts", "app.tsx"]
+}
+\`\`\`
+
+# Instructions
+
+1. After completing a task, review what you implemented
+2. Identify all artifacts (APIs, components, functions, classes, integrations)
+3. Document each with full details and locations
+4. Include ALL the information - be thorough!
+5. Future agents depend on this data quality`,
+    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'
+            },
+            taskId: {
+                type: 'string',
+                description: 'Task ID (e.g., "1", "1.2", "3.1.4")'
+            },
+            summary: {
+                type: 'string',
+                description: 'Brief summary of what was implemented'
+            },
+            filesModified: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'List of files that were modified'
+            },
+            filesCreated: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'List of files that were created'
+            },
+            statistics: {
+                type: 'object',
+                properties: {
+                    linesAdded: {
+                        type: 'number',
+                        description: 'Number of lines added'
+                    },
+                    linesRemoved: {
+                        type: 'number',
+                        description: 'Number of lines removed'
+                    }
+                },
+                required: ['linesAdded', 'linesRemoved'],
+                description: 'Code statistics for the implementation'
+            },
+            artifacts: {
+                type: 'object',
+                description: 'REQUIRED: Structured data about implemented artifacts (APIs, components, functions, classes, integrations). See tool description for detailed format.',
+                properties: {
+                    apiEndpoints: {
+                        type: 'array',
+                        description: 'API endpoints created or modified',
+                        items: { type: 'object' }
+                    },
+                    components: {
+                        type: 'array',
+                        description: 'Reusable UI components created',
+                        items: { type: 'object' }
+                    },
+                    functions: {
+                        type: 'array',
+                        description: 'Utility functions or methods created',
+                        items: { type: 'object' }
+                    },
+                    classes: {
+                        type: 'array',
+                        description: 'Classes created',
+                        items: { type: 'object' }
+                    },
+                    integrations: {
+                        type: 'array',
+                        description: 'Frontend-backend integration patterns',
+                        items: { type: 'object' }
+                    }
+                }
+            }
+        },
+        required: ['specName', 'taskId', 'summary', 'filesModified', 'filesCreated', 'statistics', 'artifacts']
+    },
+    annotations: {
+        title: 'Log Implementation',
+        destructiveHint: true,
+    }
+};
+export async function logImplementationHandler(args, context) {
+    const { specName, taskId, summary, filesModified = [], filesCreated = [], statistics, artifacts } = args;
+    // Use context projectPath as default, allow override via args
+    const projectPath = args.projectPath || context.projectPath;
+    if (!projectPath) {
+        return {
+            success: false,
+            message: 'Project path is required but not provided in context or arguments'
+        };
+    }
+    try {
+        // Validate artifacts is provided
+        if (!artifacts) {
+            return {
+                success: false,
+                message: 'Artifacts field is REQUIRED. See tool description for detailed artifact format and examples.',
+                nextSteps: [
+                    'Review the log-implementation tool description for artifact structure',
+                    'Document all API endpoints, components, functions, classes, and integrations',
+                    'Provide structured artifact data before calling this tool',
+                    'Ensure artifacts contains at least one of: apiEndpoints, components, functions, classes, or integrations'
+                ]
+            };
+        }
+        // Validate task exists
+        const specTasksPath = PathUtils.getSpecPath(projectPath, specName);
+        const tasksFile = `${specTasksPath}/tasks.md`;
+        try {
+            const { promises: fs } = await import('fs');
+            const tasksContent = await fs.readFile(tasksFile, 'utf-8');
+            const parseResult = parseTasksFromMarkdown(tasksContent);
+            const taskExists = parseResult.tasks.some(t => t.id === taskId);
+            if (!taskExists) {
+                return {
+                    success: false,
+                    message: `Task '${taskId}' not found in specification '${specName}'`,
+                    nextSteps: [
+                        `Check the task ID in .spec-workflow/specs/${specName}/tasks.md`,
+                        'Verify the spec name is correct',
+                        'Use spec-status to see available tasks'
+                    ]
+                };
+            }
+        }
+        catch (parseError) {
+            return {
+                success: false,
+                message: `Failed to validate task: ${parseError instanceof Error ? parseError.message : String(parseError)}`,
+                nextSteps: [
+                    `Check that .spec-workflow/specs/${specName}/tasks.md exists`,
+                    'Verify the tasks file is valid markdown',
+                    'Use spec-status to diagnose issues'
+                ]
+            };
+        }
+        // Create log entry
+        const logManager = new ImplementationLogManager(specTasksPath);
+        const logEntry = {
+            taskId,
+            timestamp: new Date().toISOString(),
+            summary,
+            filesModified: filesModified || [],
+            filesCreated: filesCreated || [],
+            statistics: {
+                linesAdded: statistics.linesAdded || 0,
+                linesRemoved: statistics.linesRemoved || 0,
+                filesChanged: (filesModified?.length || 0) + (filesCreated?.length || 0)
+            },
+            artifacts
+        };
+        const createdEntry = await logManager.addLogEntry(logEntry);
+        // Get task stats
+        const taskStats = await logManager.getTaskStats(taskId);
+        return {
+            success: true,
+            message: `Implementation logged for task '${taskId}'`,
+            data: {
+                entryId: createdEntry.id,
+                entry: createdEntry,
+                taskStats,
+                dashboardUrl: `${context.dashboardUrl}/logs?spec=${encodeURIComponent(specName)}&task=${taskId}`
+            },
+            nextSteps: [
+                'Mark task as completed in tasks.md by changing [-] to [x]',
+                'View implementation log in dashboard under Logs tab',
+                'Continue with next pending task'
+            ],
+            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 log implementation: ${errorMessage}`,
+            nextSteps: [
+                'Verify all required parameters are provided',
+                'Check that the spec and task exist',
+                'View dashboard logs to see previous entries'
+            ]
+        };
+    }
+}
+//# sourceMappingURL=log-implementation.js.map

package/dist/tools/log-implementation.js.map

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"spec-status.d.ts","sourceRoot":"","sources":["../../src/tools/spec-status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIxD,eAAO,MAAM,cAAc,EAAE,IAwB5B,CAAC;AAEF,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAwJ9F"}

package/dist/tools/spec-status.js

@@ -0,0 +1,178 @@
+import { PathUtils } from '../core/path-utils.js';
+import { SpecParser } from '../core/parser.js';
+export const specStatusTool = {
+    name: 'spec-status',
+    description: `Display comprehensive specification progress overview.
+
+# Instructions
+Call when resuming work on a spec or checking overall completion status. Shows which phases are complete and task implementation progress. After viewing status, read tasks.md directly to see all tasks and their status markers ([ ] pending, [-] in-progress, [x] completed).`,
+    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'
+            }
+        },
+        required: ['specName']
+    },
+    annotations: {
+        title: 'Spec Status',
+        readOnlyHint: true,
+    }
+};
+export async function specStatusHandler(args, context) {
+    const { specName } = args;
+    // Use context projectPath as default, allow override via args
+    const projectPath = args.projectPath || context.projectPath;
+    if (!projectPath) {
+        return {
+            success: false,
+            message: 'Project path is required but not provided in context or arguments'
+        };
+    }
+    try {
+        // Translate path at tool entry point (components expect pre-translated paths)
+        const translatedPath = PathUtils.translatePath(projectPath);
+        const parser = new SpecParser(translatedPath);
+        const spec = await parser.getSpec(specName);
+        if (!spec) {
+            return {
+                success: false,
+                message: `Specification '${specName}' not found`,
+                nextSteps: [
+                    'Check spec name',
+                    'Use spec-list for available specs',
+                    'Create spec with create-spec-doc'
+                ]
+            };
+        }
+        // Determine current phase and overall status
+        let currentPhase = 'not-started';
+        let overallStatus = 'not-started';
+        if (!spec.phases.requirements.exists) {
+            currentPhase = 'requirements';
+            overallStatus = 'requirements-needed';
+        }
+        else if (!spec.phases.design.exists) {
+            currentPhase = 'design';
+            overallStatus = 'design-needed';
+        }
+        else if (!spec.phases.tasks.exists) {
+            currentPhase = 'tasks';
+            overallStatus = 'tasks-needed';
+        }
+        else if (spec.taskProgress && spec.taskProgress.pending > 0) {
+            currentPhase = 'implementation';
+            overallStatus = 'implementing';
+        }
+        else if (spec.taskProgress && spec.taskProgress.total > 0 && spec.taskProgress.completed === spec.taskProgress.total) {
+            currentPhase = 'completed';
+            overallStatus = 'completed';
+        }
+        else {
+            currentPhase = 'implementation';
+            overallStatus = 'ready-for-implementation';
+        }
+        // Phase details
+        const phaseDetails = [
+            {
+                name: 'Requirements',
+                status: spec.phases.requirements.exists ? (spec.phases.requirements.approved ? 'approved' : 'created') : 'missing',
+                lastModified: spec.phases.requirements.lastModified
+            },
+            {
+                name: 'Design',
+                status: spec.phases.design.exists ? (spec.phases.design.approved ? 'approved' : 'created') : 'missing',
+                lastModified: spec.phases.design.lastModified
+            },
+            {
+                name: 'Tasks',
+                status: spec.phases.tasks.exists ? (spec.phases.tasks.approved ? 'approved' : 'created') : 'missing',
+                lastModified: spec.phases.tasks.lastModified
+            },
+            {
+                name: 'Implementation',
+                status: spec.phases.implementation.exists ? 'in-progress' : 'not-started',
+                progress: spec.taskProgress
+            }
+        ];
+        // Next steps based on current phase
+        const nextSteps = [];
+        switch (currentPhase) {
+            case 'requirements':
+                nextSteps.push('Read template: .spec-workflow/templates/requirements-template-v*.md');
+                nextSteps.push('Create: .spec-workflow/specs/{name}/requirements.md');
+                nextSteps.push('Request approval');
+                break;
+            case 'design':
+                nextSteps.push('Read template: .spec-workflow/templates/design-template-v*.md');
+                nextSteps.push('Create: .spec-workflow/specs/{name}/design.md');
+                nextSteps.push('Request approval');
+                break;
+            case 'tasks':
+                nextSteps.push('Read template: .spec-workflow/templates/tasks-template-v*.md');
+                nextSteps.push('Create: .spec-workflow/specs/{name}/tasks.md');
+                nextSteps.push('Request approval');
+                break;
+            case 'implementation':
+                if (spec.taskProgress && spec.taskProgress.pending > 0) {
+                    nextSteps.push(`Read tasks: .spec-workflow/specs/${specName}/tasks.md`);
+                    nextSteps.push('Edit tasks.md: Change [ ] to [-] for task you start');
+                    nextSteps.push('Implement the task code');
+                    nextSteps.push('Edit tasks.md: Change [-] to [x] when completed');
+                }
+                else {
+                    nextSteps.push(`Read tasks: .spec-workflow/specs/${specName}/tasks.md`);
+                    nextSteps.push('Begin implementation by marking first task [-]');
+                }
+                break;
+            case 'completed':
+                nextSteps.push('All tasks completed (marked [x])');
+                nextSteps.push('Run tests');
+                break;
+        }
+        return {
+            success: true,
+            message: `Specification '${specName}' status: ${overallStatus}`,
+            data: {
+                name: specName,
+                description: spec.description,
+                currentPhase,
+                overallStatus,
+                createdAt: spec.createdAt,
+                lastModified: spec.lastModified,
+                phases: phaseDetails,
+                taskProgress: spec.taskProgress || {
+                    total: 0,
+                    completed: 0,
+                    pending: 0
+                }
+            },
+            nextSteps,
+            projectContext: {
+                projectPath,
+                workflowRoot: PathUtils.getWorkflowRoot(projectPath),
+                currentPhase,
+                dashboardUrl: context.dashboardUrl
+            }
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            success: false,
+            message: `Failed to get specification status: ${errorMessage}`,
+            nextSteps: [
+                'Check if the specification exists',
+                'Verify the project path',
+                'List directory .spec-workflow/specs/ to see available specifications'
+            ]
+        };
+    }
+}
+//# sourceMappingURL=spec-status.js.map

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

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

package/dist/tools/spec-workflow-guide.d.ts

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

package/dist/tools/spec-workflow-guide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-workflow-guide.d.ts","sourceRoot":"","sources":["../../src/tools/spec-workflow-guide.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAExD,eAAO,MAAM,qBAAqB,EAAE,IAenC,CAAC;AAEF,wBAAsB,wBAAwB,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAsBrG"}