@madmatt112org/spec-workflow-mcp 3.0.0

package/dist/tools/index.js.map

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

package/dist/tools/log-implementation.d.ts

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

package/dist/tools/log-implementation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-implementation.d.ts","sourceRoot":"","sources":["../../src/tools/log-implementation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,YAAY,EAA0B,MAAM,aAAa,CAAC;AAKhF,eAAO,MAAM,qBAAqB,EAAE,IA4RnC,CAAC;AAEF,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,GAAG,EACT,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,YAAY,CAAC,CA6HvB"}

package/dist/tools/log-implementation.js

@@ -0,0 +1,398 @@
+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: [
+                'Ask the user to trigger a code review from the dashboard Tasks page (Review button) — do NOT self-review',
+                'Once review completes, call get-task-review to retrieve findings and discuss with user',
+                'After review passes, mark task as completed in tasks.md by changing [-] to [x]',
+                '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/review-task.d.ts

@@ -0,0 +1,58 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import { ToolContext, ToolResponse } from '../types.js';
+import { HygieneSignal } from '../core/hygiene-signals.js';
+import { TypecheckResult } from '../core/typecheck.js';
+import { TaskDiffResult } from '../core/task-diff.js';
+export declare function _resetValidateWarnings(): void;
+export declare function safeRealpath(p: string): string | undefined;
+export declare function validateAllFiles(input: unknown, projectPath: string): string[];
+type HygieneResult = {
+    signals: HygieneSignal[];
+    rejection?: {
+        message: string;
+    };
+};
+export type DiffMethodologyState = {
+    kind: 'present';
+} | {
+    kind: 'present-truncated';
+} | {
+    kind: 'empty';
+} | {
+    kind: 'rejected';
+    message: string;
+};
+export declare function computeDiffMethodologyState(result: TaskDiffResult): DiffMethodologyState;
+export type TypecheckMethodologyState = {
+    kind: 'success-clean-full';
+} | {
+    kind: 'success-with-diagnostics';
+    truncated: boolean;
+} | {
+    kind: 'success-partial-coverage';
+} | {
+    kind: 'success-with-diagnostics-and-partial-coverage';
+    truncated: boolean;
+} | {
+    kind: 'unavailable-feature-disabled';
+} | {
+    kind: 'unavailable-other';
+    reason: string;
+} | {
+    kind: 'timeout';
+};
+export declare function computeTypecheckMethodologyState(result: TypecheckResult): TypecheckMethodologyState;
+export declare function unwrapTypecheck(settled: PromiseSettledResult<TypecheckResult[]>, projectPath: string): TypecheckResult[];
+export declare function unwrapHygiene(settled: PromiseSettledResult<HygieneSignal[]>): HygieneResult;
+export declare function unwrapDiff(settled: PromiseSettledResult<TaskDiffResult>): TaskDiffResult;
+export declare const reviewTaskTool: Tool;
+export declare function reviewTaskHandler(args: any, context: ToolContext): Promise<ToolResponse>;
+export declare function buildReviewMethodology(taskContext: {
+    description: string;
+    requirements: string[];
+    leverage: string | null;
+    prompt: string | null;
+    promptStructured: any[] | null;
+}, hasTechSteering: boolean, hasPriorReviews: boolean, hasHygieneSignals: boolean, diffState: DiffMethodologyState, typecheckState: TypecheckMethodologyState): string;
+export {};
+//# sourceMappingURL=review-task.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"review-task.d.ts","sourceRoot":"","sources":["../../src/tools/review-task.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,YAAY,EAAiB,MAAM,aAAa,CAAC;AAKvE,OAAO,EAAyB,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAClF,OAAO,EAAuB,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5E,OAAO,EAAmB,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAIvE,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C;AAQD,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAa1D;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAiD9E;AAED,KAAK,aAAa,GAAG;IAAE,OAAO,EAAE,aAAa,EAAE,CAAC;IAAC,SAAS,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AAEnF,MAAM,MAAM,oBAAoB,GAC5B;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,mBAAmB,CAAA;CAAE,GAC7B;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1C,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,cAAc,GAAG,oBAAoB,CAOxF;AAED,MAAM,MAAM,yBAAyB,GACjC;IAAE,IAAI,EAAE,oBAAoB,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,0BAA0B,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,GACxD;IAAE,IAAI,EAAE,0BAA0B,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,+CAA+C,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,GAC7E;IAAE,IAAI,EAAE,8BAA8B,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC;AAExB,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,eAAe,GACtB,yBAAyB,CAiB3B;AAMD,wBAAgB,eAAe,CAC7B,OAAO,EAAE,oBAAoB,CAAC,eAAe,EAAE,CAAC,EAChD,WAAW,EAAE,MAAM,GAClB,eAAe,EAAE,CAanB;AAED,wBAAgB,aAAa,CAC3B,OAAO,EAAE,oBAAoB,CAAC,aAAa,EAAE,CAAC,GAC7C,aAAa,CAQf;AAED,wBAAgB,UAAU,CACxB,OAAO,EAAE,oBAAoB,CAAC,cAAc,CAAC,GAC5C,cAAc,CAchB;AAED,eAAO,MAAM,cAAc,EAAE,IA8E5B,CAAC;AAEF,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,GAAG,EACT,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,YAAY,CAAC,CAuBvB;AAiRD,wBAAgB,sBAAsB,CACpC,WAAW,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,gBAAgB,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;CAAE,EAC5I,eAAe,EAAE,OAAO,EACxB,eAAe,EAAE,OAAO,EACxB,iBAAiB,EAAE,OAAO,EAC1B,SAAS,EAAE,oBAAoB,EAC/B,cAAc,EAAE,yBAAyB,GACxC,MAAM,CAkGR"}