@sureshdsk/devflow-mcp 3.0.0 → 3.0.2

package/.next/standalone/src/mcp/websocket.ts

@@ -1,4 +1,4 @@
-import WebSocket from "ws";
+import WebSocket from 'ws';
 
 let client: WebSocket | null = null;
 let reconnectAttempts = 0;
@@ -6,11 +6,11 @@ let reconnectTimeout: ReturnType<typeof setTimeout> | null = null;
 let isConnecting = false;
 
 function detectAgentName(): string {
-  if (process.env.CLAUDECODE || process.env.CLAUDE_CODE_ENTRYPOINT) return "Claude Code";
-  if (process.env.CODEX) return "Codex";
-  if (process.env.CURSOR_TRACE_ID || process.env.CURSOR_CHANNEL) return "Cursor";
-  if (process.env.WINDSURF_PLUGIN_VERSION) return "Windsurf";
-  return ""; // empty = unknown, server.ts will re-identify after MCP initialize
+  if (process.env.CLAUDECODE || process.env.CLAUDE_CODE_ENTRYPOINT) return 'Claude Code';
+  if (process.env.CODEX) return 'Codex';
+  if (process.env.CURSOR_TRACE_ID || process.env.CURSOR_CHANNEL) return 'Cursor';
+  if (process.env.WINDSURF_PLUGIN_VERSION) return 'Windsurf';
+  return ''; // empty = unknown, server.ts will re-identify after MCP initialize
 }
 
 const MAX_RECONNECT_DELAY = 30000; // 30 seconds
@@ -32,7 +32,7 @@ function getReconnectDelay(): number {
   // Exponential backoff: 1s, 2s, 4s, 8s, 16s, 30s (max)
   const delay = Math.min(
     INITIAL_RECONNECT_DELAY * Math.pow(2, reconnectAttempts),
-    MAX_RECONNECT_DELAY
+    MAX_RECONNECT_DELAY,
   );
   return delay;
 }
@@ -62,42 +62,40 @@ function connectToServer() {
   try {
     client = new WebSocket(url);
 
-    client.on("open", () => {
+    client.on('open', () => {
       isConnecting = false;
       reconnectAttempts = 0;
       console.error(`[MCP WebSocket] Connected to server at ${url}`);
       // Announce this connection as an MCP agent with detected name
-      client!.send(JSON.stringify({ type: "identify", role: "mcp", agent: detectAgentName() }));
+      client!.send(JSON.stringify({ type: 'identify', role: 'mcp', agent: detectAgentName() }));
     });
 
-    client.on("close", () => {
+    client.on('close', () => {
       isConnecting = false;
       client = null;
       // Only log and reconnect if we had been connected (reconnectAttempts > 0 means we're already trying)
       if (reconnectAttempts === 0) {
-        console.error("[MCP WebSocket] Disconnected from server, will reconnect");
+        console.error('[MCP WebSocket] Disconnected from server, will reconnect');
       }
       scheduleReconnect();
     });
 
-    client.on("error", (error: Error & { code?: string }) => {
+    client.on('error', (error: Error & { code?: string }) => {
       isConnecting = false;
       // Only log connection refused once, not on every retry
-      if (error.code === "ECONNREFUSED") {
+      if (error.code === 'ECONNREFUSED') {
         if (reconnectAttempts === 0) {
-          console.error(
-            `[MCP WebSocket] Server not available at ${url}, will retry in background`
-          );
+          console.error(`[MCP WebSocket] Server not available at ${url}, will retry in background`);
         }
       } else {
-        console.error("[MCP WebSocket] Error:", error.message);
+        console.error('[MCP WebSocket] Error:', error.message);
       }
       client = null;
       scheduleReconnect();
     });
   } catch (error) {
     isConnecting = false;
-    console.error("[MCP WebSocket] Failed to create connection:", error);
+    console.error('[MCP WebSocket] Failed to create connection:', error);
     scheduleReconnect();
   }
 }
@@ -105,16 +103,19 @@ function connectToServer() {
 export function broadcastUpdate(data: unknown) {
   if (!client || client.readyState !== WebSocket.OPEN) {
     // Server not available, silently fail - UI has polling fallback
-    console.error("[MCP WebSocket] Not connected, skipping broadcast:", JSON.stringify(data).substring(0, 100));
+    console.error(
+      '[MCP WebSocket] Not connected, skipping broadcast:',
+      JSON.stringify(data).substring(0, 100),
+    );
     return;
   }
 
   try {
     const message = JSON.stringify(data);
-    console.error("[MCP WebSocket] Broadcasting:", message.substring(0, 100));
+    console.error('[MCP WebSocket] Broadcasting:', message.substring(0, 100));
     client.send(message);
   } catch (error) {
-    console.error("[MCP WebSocket] Failed to send message:", error);
+    console.error('[MCP WebSocket] Failed to send message:', error);
   }
 }
 
@@ -133,5 +134,7 @@ export function disconnect() {
   }
 }
 
-// Attempt initial connection when module is imported
-connectToServer();
+// Connect lazily — skip during build
+if (process.env.NEXT_PHASE !== 'phase-production-build') {
+  connectToServer();
+}

package/.next/standalone/src/schemas/backend-api/templates/proposal.md

@@ -11,15 +11,17 @@
 ## Scope
 
 ### In Scope
-- 
+
+-
 
 ### Out of Scope
-- 
+
+-
 
 ## Success Criteria
 
-- 
+-
 
 ## Risks & Assumptions
 
-- 
+-

package/.next/standalone/src/schemas/backend-api/templates/tasks.md

@@ -3,15 +3,18 @@
 ## 1. Delivery Overview
 
 ### 1.1 Objective
+
 <Deliver backend/API changes with contract safety and operational confidence.>
 
 ### 1.2 In-Scope Outcomes
+
 - <Service/API behavior outcome>
 - <Data or migration outcome>
 
 ## 2. Task Cards
 
 ### 2.1 Task: <short-task-title>
+
 - [ ] **Status**
 - **Task ID:** `<T1>`
 - **Owner Type:** `agent`
@@ -22,14 +25,17 @@
 <Concrete backend/API goal>
 
 **Implementation Targets**
+
 - Files to create/update:
   - `<path>`
 
 **Validation**
+
 - Automated tests to add/update:
   - `<test file>`
 
 **Task Summary**
+
 - Completed: <!-- yes/no -->
 - What was done: <!-- brief description -->
 - Files changed: <!-- list key files -->

package/.next/standalone/src/schemas/data-engineering/templates/proposal.md

@@ -11,15 +11,17 @@
 ## Scope
 
 ### In Scope
-- 
+
+-
 
 ### Out of Scope
-- 
+
+-
 
 ## Success Criteria
 
-- 
+-
 
 ## Risks & Assumptions
 
-- 
+-

package/.next/standalone/src/schemas/data-engineering/templates/tasks.md

@@ -3,15 +3,18 @@
 ## 1. Delivery Overview
 
 ### 1.1 Objective
+
 <Deliver trustworthy data pipeline/model changes with lineage and quality controls.>
 
 ### 1.2 In-Scope Outcomes
+
 - <Pipeline/model outcome>
 - <Data quality/SLA outcome>
 
 ## 2. Task Cards
 
 ### 2.1 Task: <short-task-title>
+
 - [ ] **Status**
 - **Task ID:** `<T1>`
 - **Owner Type:** `agent`
@@ -22,14 +25,17 @@
 <Concrete data engineering goal>
 
 **Implementation Targets**
+
 - Files to create/update:
   - `<path>`
 
 **Validation**
+
 - Automated tests to add/update:
   - `<test file>`
 
 **Task Summary**
+
 - Completed: <!-- yes/no -->
 - What was done: <!-- brief description -->
 - Files changed: <!-- list key files -->

package/.next/standalone/src/schemas/devops-platform/templates/proposal.md

@@ -11,15 +11,17 @@
 ## Scope
 
 ### In Scope
-- 
+
+-
 
 ### Out of Scope
-- 
+
+-
 
 ## Success Criteria
 
-- 
+-
 
 ## Risks & Assumptions
 
-- 
+-

package/.next/standalone/src/schemas/devops-platform/templates/tasks.md

@@ -3,15 +3,18 @@
 ## 1. Delivery Overview
 
 ### 1.1 Objective
+
 <Deliver safe platform/devops changes with clear deployment and rollback confidence.>
 
 ### 1.2 In-Scope Outcomes
+
 - <Infrastructure/deployment outcome>
 - <Reliability/security outcome>
 
 ## 2. Task Cards
 
 ### 2.1 Task: <short-task-title>
+
 - [ ] **Status**
 - **Task ID:** `<T1>`
 - **Owner Type:** `agent`
@@ -22,14 +25,17 @@
 <Concrete devops/platform goal>
 
 **Implementation Targets**
+
 - Files to create/update:
   - `<path>`
 
 **Validation**
+
 - Automated tests to add/update:
   - `<test file>`
 
 **Task Summary**
+
 - Completed: <!-- yes/no -->
 - What was done: <!-- brief description -->
 - Files changed: <!-- list key files -->

package/.next/standalone/src/schemas/frontend-product/templates/proposal.md

@@ -11,15 +11,17 @@
 ## Scope
 
 ### In Scope
-- 
+
+-
 
 ### Out of Scope
-- 
+
+-
 
 ## Success Criteria
 
-- 
+-
 
 ## Risks & Assumptions
 
-- 
+-

package/.next/standalone/src/schemas/frontend-product/templates/tasks.md

@@ -3,15 +3,18 @@
 ## 1. Delivery Overview
 
 ### 1.1 Objective
+
 <Deliver the frontend/product experience safely with measurable UX outcomes.>
 
 ### 1.2 In-Scope Outcomes
+
 - <UI/UX outcome>
 - <Behavior/API consumption outcome>
 
 ## 2. Task Cards
 
 ### 2.1 Task: <short-task-title>
+
 - [ ] **Status**
 - **Task ID:** `<T1>`
 - **Owner Type:** `agent`
@@ -22,14 +25,17 @@
 <Concrete frontend/product goal>
 
 **Implementation Targets**
+
 - Files to create/update:
   - `<path>`
 
 **Validation**
+
 - Automated tests to add/update:
   - `<test file>`
 
 **Task Summary**
+
 - Completed: <!-- yes/no -->
 - What was done: <!-- brief description -->
 - Files changed: <!-- list key files -->

package/.next/standalone/src/schemas/spec-driven/templates/proposal.md

@@ -11,15 +11,17 @@
 ## Scope
 
 ### In Scope
-- 
+
+-
 
 ### Out of Scope
-- 
+
+-
 
 ## Success Criteria
 
-- 
+-
 
 ## Risks & Assumptions
 
-- 
+-

package/.next/standalone/src/schemas/spec-driven/templates/tasks.md

@@ -4,6 +4,7 @@
 <!-- Tasks will be parsed and promoted to the Kanban board -->
 
 ## How To Use This File
+
 - Create one task card per meaningful unit of delivery.
 - Keep tasks dependency-ordered and independently executable where possible.
 - Every task card must include enough context that a new agent can execute it without re-discovery work.
@@ -12,21 +13,26 @@
 ## 1. Delivery Overview
 
 ### 1.1 Objective
+
 <One-paragraph summary of what this change delivers and why it matters.>
 
 ### 1.2 In-Scope Outcomes
+
 - <Outcome 1>
 - <Outcome 2>
 
 ### 1.3 Non-Goals
+
 - <Non-goal 1>
 - <Non-goal 2>
 
 ### 1.4 Global Constraints
+
 - <Technical or product constraints that apply to all tasks>
 - <Compatibility/performance/security constraints>
 
 ### 1.5 Shared References
+
 - Proposal: `specflow/changes/<change-name>/proposal.md`
 - Design: `specflow/changes/<change-name>/design.md`
 - Specs: `specflow/changes/<change-name>/specs/spec.md`
@@ -37,6 +43,7 @@
 ## 2. Task Cards
 
 ### 2.1 Task: <short-task-title>
+
 - [ ] **Status**
 - **Task ID:** `<T1>`
 - **Owner Type:** `<agent|human|either>`
@@ -50,6 +57,7 @@
 <Domain and technical context required before editing. Include key assumptions.>
 
 **Scope**
+
 - In scope:
   - <item>
   - <item>
@@ -57,6 +65,7 @@
   - <item>
 
 **Implementation Targets**
+
 - Files to create/update:
   - `<path>`
   - `<path>`
@@ -64,11 +73,13 @@
   - `<API/type/command>`
 
 **Execution Steps**
+
 1. <Step 1 with expected output>
 2. <Step 2 with expected output>
 3. <Step 3 with expected output>
 
 **Validation**
+
 - Automated tests to add/update:
   - `<test file>`
 - Commands to run:
@@ -78,10 +89,12 @@
   - <check>
 
 **Acceptance Criteria**
+
 - <Measurable criterion 1>
 - <Measurable criterion 2>
 
 **Risks and Mitigations**
+
 - Risk: <risk>
   - Mitigation: <mitigation>
 
@@ -89,7 +102,9 @@
 <What the next task/agent should know, including outputs and unresolved items.>
 
 **Task Summary**
+
 <!-- To be filled by the agent after completing this task -->
+
 - Completed: <!-- yes/no -->
 - What was done: <!-- brief description -->
 - Files changed: <!-- list key files -->
@@ -97,6 +112,7 @@
 - Follow-ups: <!-- items deferred or discovered during implementation -->
 
 ### 2.2 Task: <short-task-title>
+
 - [ ] **Status**
 - **Task ID:** `<T2>`
 - **Owner Type:** `<agent|human|either>`
@@ -110,6 +126,7 @@
 <Domain and technical context required before editing. Include key assumptions.>
 
 **Scope**
+
 - In scope:
   - <item>
   - <item>
@@ -117,6 +134,7 @@
   - <item>
 
 **Implementation Targets**
+
 - Files to create/update:
   - `<path>`
   - `<path>`
@@ -124,11 +142,13 @@
   - `<API/type/command>`
 
 **Execution Steps**
+
 1. <Step 1 with expected output>
 2. <Step 2 with expected output>
 3. <Step 3 with expected output>
 
 **Validation**
+
 - Automated tests to add/update:
   - `<test file>`
 - Commands to run:
@@ -138,10 +158,12 @@
   - <check>
 
 **Acceptance Criteria**
+
 - <Measurable criterion 1>
 - <Measurable criterion 2>
 
 **Risks and Mitigations**
+
 - Risk: <risk>
   - Mitigation: <mitigation>
 
@@ -149,7 +171,9 @@
 <What the next task/agent should know, including outputs and unresolved items.>
 
 **Task Summary**
+
 <!-- To be filled by the agent after completing this task -->
+
 - Completed: <!-- yes/no -->
 - What was done: <!-- brief description -->
 - Files changed: <!-- list key files -->
@@ -157,12 +181,14 @@
 - Follow-ups: <!-- items deferred or discovered during implementation -->
 
 ## 3. Cross-Task Verification
+
 - [ ] End-to-end behavior matches `specs/spec.md` requirements and scenarios.
 - [ ] All affected tests are updated and passing.
 - [ ] User-facing docs and command help are updated where behavior changed.
 - [ ] Rollback path is documented for risky changes.
 
 ## 4. Completion Gate
+
 - [ ] All task cards are checked complete.
 - [ ] `node bin/specflow.js validate --change <change-name>` passes.
 - [ ] Implementation summary and follow-up items are recorded in handoff notes.

package/.next/standalone/src/websocket/server.ts

@@ -1,5 +1,5 @@
-import { WebSocketServer, WebSocket } from "ws";
-import { createConnection } from "net";
+import { WebSocketServer, WebSocket } from 'ws';
+import { createConnection } from 'net';
 
 let wss: WebSocketServer | null = null;
 const clients = new Set<WebSocket>();
@@ -25,7 +25,7 @@ function isPortInUse(port: number): Promise<boolean> {
       client.end();
       resolve(true);
     });
-    client.on("error", () => {
+    client.on('error', () => {
       resolve(false);
     });
   });
@@ -46,28 +46,30 @@ export async function startWebSocketServer(port?: number): Promise<WebSocketServ
   try {
     wss = new WebSocketServer({ port: wsPort });
 
-    wss.on("connection", (ws) => {
+    wss.on('connection', (ws) => {
       clients.add(ws);
       console.log(`[WebSocket] Client connected (total: ${clients.size})`);
 
-      ws.on("message", (data) => {
+      ws.on('message', (data) => {
         try {
           const message = data.toString();
           const parsed = JSON.parse(message);
 
           // Identity handshake: MCP clients announce themselves
-          if (parsed.type === "identify" && parsed.role === "mcp") {
-            const agentName = parsed.agent || "Unknown Agent";
+          if (parsed.type === 'identify' && parsed.role === 'mcp') {
+            const agentName = parsed.agent || 'Unknown Agent';
             const prev = agentClients.get(ws);
             agentClients.set(ws, agentName);
             if (prev !== agentName) {
-              console.log(`[WebSocket] MCP agent identified: ${agentName} (agents: ${agentClients.size})`);
+              console.log(
+                `[WebSocket] MCP agent identified: ${agentName} (agents: ${agentClients.size})`,
+              );
               broadcastAgentList();
             }
             return;
           }
 
-          console.log("[WebSocket] Relaying message:", message.substring(0, 100));
+          console.log('[WebSocket] Relaying message:', message.substring(0, 100));
           // Relay to all non-sender clients (browser UIs)
           clients.forEach((client) => {
             if (client !== ws && client.readyState === WebSocket.OPEN) {
@@ -75,11 +77,11 @@ export async function startWebSocketServer(port?: number): Promise<WebSocketServ
             }
           });
         } catch (error) {
-          console.error("[WebSocket] Error relaying message:", error);
+          console.error('[WebSocket] Error relaying message:', error);
         }
       });
 
-      ws.on("close", () => {
+      ws.on('close', () => {
         const wasAgent = agentClients.has(ws);
         agentClients.delete(ws);
         clients.delete(ws);
@@ -90,18 +92,18 @@ export async function startWebSocketServer(port?: number): Promise<WebSocketServ
         }
       });
 
-      ws.on("error", (error) => {
-        console.error("[WebSocket] Client error:", error);
+      ws.on('error', (error) => {
+        console.error('[WebSocket] Client error:', error);
         agentClients.delete(ws);
         clients.delete(ws);
       });
     });
 
-    wss.on("error", (error: NodeJS.ErrnoException) => {
-      if (error.code === "EADDRINUSE") {
+    wss.on('error', (error: NodeJS.ErrnoException) => {
+      if (error.code === 'EADDRINUSE') {
         console.log(`[WebSocket] Port ${wsPort} already in use, skipping`);
       } else {
-        console.error("[WebSocket] Server error:", error);
+        console.error('[WebSocket] Server error:', error);
       }
       wss = null;
     });
@@ -124,7 +126,7 @@ export async function startWebSocketServer(port?: number): Promise<WebSocketServ
 
     console.log(`[WebSocket] Server started on port ${wsPort}`);
   } catch (error) {
-    console.error("[WebSocket] Failed to start server:", error);
+    console.error('[WebSocket] Failed to start server:', error);
     return null;
   }
 
@@ -149,7 +151,7 @@ export function getAgentList(): string[] {
 
 function broadcastAgentList() {
   const agents = getAgentList();
-  const msg = JSON.stringify({ type: "agent_count", count: agents.length, agents });
+  const msg = JSON.stringify({ type: 'agent_count', count: agents.length, agents });
   clients.forEach((client) => {
     if (!agentClients.has(client) && client.readyState === WebSocket.OPEN) {
       client.send(msg);

package/.next/standalone/tsconfig.json

@@ -1,11 +1,7 @@
 {
   "compilerOptions": {
     "target": "ES2017",
-    "lib": [
-      "dom",
-      "dom.iterable",
-      "esnext"
-    ],
+    "lib": ["dom", "dom.iterable", "esnext"],
     "allowJs": true,
     "skipLibCheck": true,
     "strict": true,
@@ -23,9 +19,7 @@
       }
     ],
     "paths": {
-      "@/*": [
-        "./src/*"
-      ]
+      "@/*": ["./src/*"]
     }
   },
   "include": [
@@ -35,8 +29,5 @@
     ".next/types/**/*.ts",
     ".next/dev/types/**/*.ts"
   ],
-  "exclude": [
-    "node_modules",
-    "**/*.test.ts"
-  ]
+  "exclude": ["node_modules", "**/*.test.ts"]
 }