@madmatt112org/spec-workflow-mcp 3.0.0

package/dist/types.d.ts

@@ -0,0 +1,213 @@
+export interface AutomationJob {
+    id: string;
+    name: string;
+    type: 'cleanup-approvals' | 'cleanup-specs' | 'cleanup-archived-specs';
+    enabled: boolean;
+    config: {
+        daysOld: number;
+    };
+    schedule: string;
+    lastRun?: string;
+    nextRun?: string;
+    createdAt: string;
+}
+export interface SecurityConfig {
+    rateLimitEnabled: boolean;
+    rateLimitPerMinute: number;
+    auditLogEnabled: boolean;
+    auditLogPath?: string;
+    auditLogRetentionDays: number;
+    corsEnabled: boolean;
+    allowedOrigins: string[];
+}
+export interface GlobalSettings {
+    automationJobs: AutomationJob[];
+    security?: SecurityConfig;
+    createdAt?: string;
+    lastModified?: string;
+}
+export interface JobExecutionHistory {
+    jobId: string;
+    jobName: string;
+    jobType: string;
+    executedAt: string;
+    success: boolean;
+    duration: number;
+    itemsProcessed: number;
+    itemsDeleted: number;
+    error?: string;
+}
+export interface JobExecutionLog {
+    executions: JobExecutionHistory[];
+    lastUpdated?: string;
+}
+export interface ToolContext {
+    projectPath: string;
+    dashboardUrl?: string;
+    lang?: string;
+}
+export interface SpecData {
+    name: string;
+    description?: string;
+    createdAt: string;
+    lastModified: string;
+    phases: {
+        requirements: PhaseStatus;
+        design: PhaseStatus;
+        tasks: PhaseStatus;
+        implementation: PhaseStatus;
+    };
+    taskProgress?: {
+        total: number;
+        completed: number;
+        pending: number;
+    };
+}
+export interface PhaseStatus {
+    exists: boolean;
+    approved?: boolean;
+    lastModified?: string;
+    content?: string;
+}
+export interface SteeringStatus {
+    exists: boolean;
+    documents: {
+        product: boolean;
+        tech: boolean;
+        structure: boolean;
+    };
+    lastModified?: string;
+}
+export interface PromptSection {
+    key: string;
+    value: string;
+}
+export interface TaskInfo {
+    id: string;
+    description: string;
+    leverage?: string;
+    requirements?: string;
+    completed: boolean;
+    details?: string[];
+    prompt?: string;
+    promptStructured?: PromptSection[];
+}
+export interface ImplementationLogEntry {
+    id: string;
+    taskId: string;
+    timestamp: string;
+    summary: string;
+    filesModified: string[];
+    filesCreated: string[];
+    statistics: {
+        linesAdded: number;
+        linesRemoved: number;
+        filesChanged: number;
+    };
+    artifacts: {
+        apiEndpoints?: Array<{
+            method: string;
+            path: string;
+            purpose: string;
+            requestFormat?: string;
+            responseFormat?: string;
+            location: string;
+        }>;
+        components?: Array<{
+            name: string;
+            type: string;
+            purpose: string;
+            location: string;
+            props?: string;
+            exports?: string[];
+        }>;
+        functions?: Array<{
+            name: string;
+            purpose: string;
+            location: string;
+            signature?: string;
+            isExported: boolean;
+        }>;
+        classes?: Array<{
+            name: string;
+            purpose: string;
+            location: string;
+            methods?: string[];
+            isExported: boolean;
+        }>;
+        integrations?: Array<{
+            description: string;
+            frontendComponent: string;
+            backendEndpoint: string;
+            dataFlow: string;
+        }>;
+    };
+}
+export interface ImplementationLog {
+    entries: ImplementationLogEntry[];
+    lastUpdated?: string;
+}
+export interface ToolResponse {
+    success: boolean;
+    message: string;
+    data?: any;
+    nextSteps?: string[];
+    projectContext?: {
+        projectPath: string;
+        workflowRoot: string;
+        specName?: string;
+        currentPhase?: string;
+        dashboardUrl?: string;
+    };
+}
+export interface MCPToolResponse {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+    _meta?: Record<string, any>;
+}
+export interface ReviewFinding {
+    severity: 'critical' | 'warning' | 'info';
+    title: string;
+    file?: string;
+    line?: number;
+    description: string;
+    taskRequirement?: string;
+    category?: 'spec-compliance' | 'hygiene';
+    classification?: 'novel' | 'compounding' | 'recurring';
+}
+export interface TaskReview {
+    id: string;
+    taskId: string;
+    specName: string;
+    version: number;
+    timestamp: string;
+    verdict: 'pass' | 'fail' | 'findings';
+    summary: string;
+    findings: ReviewFinding[];
+}
+export interface Deferral {
+    id: string;
+    status: 'deferred' | 'resolved' | 'superseded';
+    title: string;
+    createdAt: string;
+    updatedAt: string;
+    resolvedAt: string | null;
+    originSpec: string | null;
+    originPhase: 'requirements' | 'design' | 'tasks' | 'implementation' | null;
+    revisitTrigger: string;
+    tags: string[];
+    resolution: string | null;
+    resolvedInSpec: string | null;
+    supersededBy: string | null;
+    supersedes: string | null;
+    body: {
+        context: string;
+        decision: string;
+        revisitCriteria: string;
+    };
+}
+export declare function toMCPResponse(response: ToolResponse, isError?: boolean): MCPToolResponse;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,13 @@
+// Common types for the spec workflow MCP server
+import { encode } from '@toon-format/toon';
+// Helper function to convert ToolResponse to MCP format
+export function toMCPResponse(response, isError = false) {
+    return {
+        content: [{
+                type: "text",
+                text: encode(response)
+            }],
+        isError
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AA8O3C,wDAAwD;AACxD,MAAM,UAAU,aAAa,CAAC,QAAsB,EAAE,UAAmB,KAAK;IAC5E,OAAO;QACL,OAAO,EAAE,CAAC;gBACR,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC;aACvB,CAAC;QACF,OAAO;KACR,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,113 @@
+{
+  "name": "@madmatt112org/spec-workflow-mcp",
+  "version": "3.0.0",
+  "description": "MCP server for spec-driven development workflow with real-time web dashboard (madmatt112 fork of Pimzino/spec-workflow-mcp)",
+  "author": "Matthew Field <fieldm58@gmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/madmatt112/spec-workflow-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/madmatt112/spec-workflow-mcp/issues"
+  },
+  "homepage": "https://github.com/madmatt112/spec-workflow-mcp#readme",
+  "main": "dist/index.js",
+  "type": "module",
+  "bin": {
+    "spec-workflow-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist/**/*",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "npm run validate:i18n && npm run clean && tsc && npm run build:dashboard",
+    "copy-static": "node scripts/copy-static.cjs",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js",
+    "dev:dashboard": "vite --config src/dashboard_frontend/vite.config.ts",
+    "build:dashboard": "vite build --config src/dashboard_frontend/vite.config.ts && npm run copy-static",
+    "clean": "rimraf dist",
+    "validate:i18n": "node scripts/validate-i18n.js",
+    "sync:plugin-version": "node scripts/sync-plugin-version.js",
+    "check:plugin-version": "node scripts/sync-plugin-version.js --check",
+    "test": "vitest",
+    "test:watch": "vitest --watch",
+    "test:coverage": "vitest --coverage",
+    "test:e2e": "playwright test",
+    "test:e2e:worktree": "playwright test -c playwright.worktree.config.ts",
+    "test:e2e:ui": "playwright test --ui",
+    "test:generate-approvals": "node scripts/generate-test-approvals.cjs",
+    "prepublishOnly": "npm run build",
+    "validate:mdx": "tsx scripts/validate-mdx.ts"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "spec-workflow",
+    "ai-development",
+    "claude",
+    "cursor",
+    "development-workflow",
+    "project-management"
+  ],
+  "license": "GPL-3.0",
+  "dependencies": {
+    "@dnd-kit/core": "^6.1.0",
+    "@dnd-kit/sortable": "^8.0.0",
+    "@dnd-kit/utilities": "^3.2.2",
+    "@fastify/cors": "^11.2.0",
+    "@fastify/static": "^9.0.0",
+    "@fastify/websocket": "^11.2.0",
+    "@heroicons/react": "^2.2.0",
+    "@mdx-js/mdx": "^3.1.1",
+    "@mdxeditor/editor": "^3.50.0",
+    "@modelcontextprotocol/sdk": "^1.24.3",
+    "@tailwindcss/vite": "^4.1.13",
+    "@toon-format/toon": "^0.8.0",
+    "ajv": "^8.17.1",
+    "ajv-formats": "^3.0.1",
+    "chokidar": "^3.5.3",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "diff": "^5.2.0",
+    "fastify": "^5.7.4",
+    "highlight.js": "^11.9.0",
+    "howler": "^2.2.4",
+    "i18next": "^25.5.2",
+    "i18next-browser-languagedetector": "^8.2.0",
+    "markdown-it": "^14.1.0",
+    "mermaid": "^10.9.1",
+    "node-cron": "^4.2.1",
+    "open": "^8.4.2",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "react-i18next": "^15.7.3",
+    "react-router-dom": "^6.26.2",
+    "react-text-annotate-blend": "^1.2.0",
+    "simple-git": "^3.28.0",
+    "tailwind-merge": "^3.3.1",
+    "toml": "^3.0.0",
+    "ws": "^8.18.0",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.58.0",
+    "@tailwindcss/typography": "^0.5.16",
+    "@types/diff": "^5.2.3",
+    "@types/node": "^22.18.1",
+    "@types/react": "^18.3.5",
+    "@types/react-dom": "^18.3.0",
+    "@types/ws": "^8.5.13",
+    "@vitejs/plugin-react": "^4.3.3",
+    "@vitest/coverage-v8": "^4.0.15",
+    "rimraf": "^6.0.1",
+    "tailwindcss": "^4.1.13",
+    "tsx": "^4.7.0",
+    "typescript": "^5.7.2",
+    "vite": "^7.2.7",
+    "vitest": "^4.0.15"
+  }
+}