purple-ai 0.0.13 → 0.0.14

package/mcp-server/dist/bundle.js

@@ -20646,173 +20646,139 @@ var StdioServerTransport = class {
 
 // dist/index.js
 var PURPLE_STATUS_URL = "http://127.0.0.1:7685/status";
-var PURPLE_STANDARDS_COMPLETE_URL = "http://127.0.0.1:7685/standards-complete";
-var PURPLE_SET_FEATURE_FOLDER_URL = "http://127.0.0.1:7685/set-feature-folder";
 var TOOLS = [
   {
-    name: "purple_update_status",
-    description: "Update the Purple CLI status bar with current progress. Use this to keep users informed of agent activity without requiring them to read your output.",
+    name: "purple_status",
+    description: "Update Purple CLI status bar and ticket tree. Use this unified tool for all progress reporting: setting phases, tracking tickets, updating agent status, and managing feature folders.",
     inputSchema: {
       type: "object",
       properties: {
+        // Feature folder (sets progress.json location - typically sent once at start)
+        featureFolder: {
+          type: "string",
+          description: 'Path to feature folder containing progress.json (e.g., "purple/documentation/260113-my-feature")'
+        },
+        // Status bar fields
         phase: {
           type: "string",
-          description: 'Current phase (e.g., "0 - Validation", "1 - Product Spec", "2 - Engineering", "3 - Implementation", "4 - Review")'
+          description: 'Current phase (e.g., "1 - Product Spec", "2 - Engineering", "3 - Implementation")'
         },
         agent: {
           type: "string",
           description: 'Active agent name (e.g., "orchestrator", "senior-engineer", "spec-writer")'
         },
-        currentTicket: {
-          type: "number",
-          description: "Current ticket number being worked on (1-indexed)"
-        },
-        totalTickets: {
-          type: "number",
-          description: "Total number of tickets in the implementation"
-        },
         mode: {
           type: "string",
           enum: ["plan", "execute", "review"],
-          description: 'Current working mode: "plan" (analyzing/planning), "execute" (writing code), "review" (verifying work)'
-        },
-        tool: {
-          type: "string",
-          description: 'Currently active tool being used (e.g., "Edit", "Grep", "Read", "Bash")'
+          description: 'Current working mode: "plan" (analyzing), "execute" (writing code), "review" (verifying)'
         },
         activeFile: {
           type: "string",
           description: "File currently being worked on (e.g., src/components/Button.tsx)"
-        }
-      },
-      additionalProperties: false
-    }
-  },
-  {
-    name: "purple_set_phase",
-    description: "Quick helper to set just the current phase. Use this when transitioning between major workflow phases.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        phase: {
-          type: "string",
-          description: 'Phase name (e.g., "0 - Validation", "1 - Product Spec", "2 - Engineering", "3 - Implementation", "4 - Review")'
-        }
-      },
-      required: ["phase"],
-      additionalProperties: false
-    }
-  },
-  {
-    name: "purple_report_progress",
-    description: "Report ticket progress during implementation. Call this at the start of each ticket to update the progress indicator.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        current: {
-          type: "number",
-          description: "Current ticket number (1-indexed)"
         },
-        total: {
+        // Overall progress
+        completedTickets: {
           type: "number",
-          description: "Total number of tickets"
-        }
-      },
-      required: ["current", "total"],
-      additionalProperties: false
-    }
-  },
-  {
-    name: "purple_ticket_status",
-    description: "Update ticket progress with phase information. Use this to show progress like '5/12 tickets done' in the status bar. Call this whenever starting a new ticket or completing one.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        phase: {
-          type: "string",
-          description: 'Current phase name (e.g., "Phase 3: Implementation", "Phase 4: Review")'
+          description: "Total tickets completed so far"
         },
-        completed: {
+        totalTickets: {
           type: "number",
-          description: "Number of tickets completed so far"
+          description: "Total number of tickets in the feature"
         },
-        total: {
-          type: "number",
-          description: "Total number of tickets"
+        // QA section fields
+        qaActive: {
+          type: "boolean",
+          description: "Set true when starting QA, false when QA completes. When false, shows checkmark in panel."
         },
-        currentTicketName: {
-          type: "string",
-          description: 'Name or description of the current ticket being worked on (e.g., "AUTH-001: User Login")'
-        }
-      },
-      required: ["completed", "total"],
-      additionalProperties: false
-    }
-  },
-  {
-    name: "purple_standards_complete",
-    description: "Signal that standards creation/update is complete. Call this when the create-standards agent has finished writing all standards files. This triggers automatic upload of standards to the Purple database.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        message: {
-          type: "string",
-          description: 'Optional completion message (e.g., "Created 12 standards files")'
-        }
-      },
-      additionalProperties: false
-    }
-  },
-  {
-    name: "purple_set_feature_folder",
-    description: "Set the active feature folder for progress tracking. Call this when starting work on a feature to enable real-time progress.json monitoring. The folder should be the feature documentation folder (e.g., 'purple/documentation/260113-my-feature').",
-    inputSchema: {
-      type: "object",
-      properties: {
-        folder: {
-          type: "string",
-          description: 'Absolute or relative path to the feature folder containing progress.json (e.g., "purple/documentation/260113-my-feature")'
-        }
-      },
-      required: ["folder"],
-      additionalProperties: false
-    }
-  },
-  {
-    name: "purple_progress_start_ticket",
-    description: "Mark a ticket as in_progress and show it in the Purple progress panel. Call this when starting work on a ticket.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        ticketId: {
-          type: "string",
-          description: 'The ticket ID (e.g., "FCB-003")'
+        qaRunNumber: {
+          type: "number",
+          description: "Current QA run number (1, 2, 3...)"
         },
-        ticketName: {
+        qaCurrentTest: {
           type: "string",
-          description: 'The ticket name/description (e.g., "Firebase authentication service")'
+          description: 'Status text (e.g., "Running unit tests" when active, "Passed" or "Failed" when complete)'
         },
-        agent: {
-          type: "string",
-          description: 'The agent name (e.g., "senior-engineer"). Defaults to "senior-engineer".'
-        }
-      },
-      required: ["ticketId"],
-      additionalProperties: false
-    }
-  },
-  {
-    name: "purple_progress_complete_ticket",
-    description: "Mark a ticket as completed and remove it from the active list. Call this when a ticket is done.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        ticketId: {
-          type: "string",
-          description: 'The ticket ID (e.g., "FCB-003")'
+        // Ticket data (announce/update a specific ticket)
+        ticket: {
+          type: "object",
+          description: "Full ticket data for announcing or updating a ticket",
+          properties: {
+            id: {
+              type: "string",
+              description: 'Ticket ID (e.g., "FCB-003")'
+            },
+            name: {
+              type: "string",
+              description: 'Ticket name (e.g., "Firebase authentication")'
+            },
+            description: {
+              type: "string",
+              description: "Detailed description of the ticket"
+            },
+            phase: {
+              type: "string",
+              description: 'Phase this ticket belongs to (e.g., "Phase 1: Setup")'
+            },
+            acceptance: {
+              type: "array",
+              items: { type: "string" },
+              description: "List of acceptance criteria for the ticket"
+            },
+            status: {
+              type: "object",
+              description: "Ticket status and timing information",
+              properties: {
+                status: {
+                  type: "string",
+                  enum: ["todo", "in_progress", "completed", "failed"],
+                  description: "Current ticket status"
+                },
+                startedAt: {
+                  type: "string",
+                  description: "ISO timestamp when work started"
+                },
+                updatedAt: {
+                  type: "string",
+                  description: "ISO timestamp of last update"
+                },
+                exceptionDescription: {
+                  type: "string",
+                  description: "Description of any blocker or exception encountered"
+                },
+                completionSummary: {
+                  type: "string",
+                  description: "Summary of what was accomplished"
+                }
+              }
+            },
+            dependencies: {
+              type: "array",
+              description: "List of ticket dependencies",
+              items: {
+                type: "object",
+                properties: {
+                  id: { type: "string", description: "Dependent ticket ID" },
+                  phase: { type: "string", description: "Phase of dependent ticket" }
+                }
+              }
+            },
+            estimatedEffort: {
+              type: "object",
+              description: "Effort estimates for the ticket",
+              properties: {
+                humanEffort: {
+                  type: "string",
+                  description: 'Estimated human effort (e.g., "30 minutes")'
+                },
+                purpleEffort: {
+                  type: "string",
+                  description: 'Estimated Purple/AI effort (e.g., "5 minutes")'
+                }
+              }
+            }
+          }
         }
       },
-      required: ["ticketId"],
       additionalProperties: false
     }
   }
@@ -20833,42 +20799,10 @@ async function sendStatusUpdate(payload) {
     console.error("Failed to send status update (Purple may not be active):", error2);
   }
 }
-async function sendStandardsComplete(payload) {
-  try {
-    const response = await fetch(PURPLE_STANDARDS_COMPLETE_URL, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json"
-      },
-      body: JSON.stringify(payload)
-    });
-    if (!response.ok) {
-      console.error(`Standards complete signal failed with HTTP ${response.status}: ${response.statusText}`);
-    }
-  } catch (error2) {
-    console.error("Failed to send standards complete signal (Purple may not be active):", error2);
-  }
-}
-async function sendSetFeatureFolder(payload) {
-  try {
-    const response = await fetch(PURPLE_SET_FEATURE_FOLDER_URL, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json"
-      },
-      body: JSON.stringify(payload)
-    });
-    if (!response.ok) {
-      console.error(`Set feature folder failed with HTTP ${response.status}: ${response.statusText}`);
-    }
-  } catch (error2) {
-    console.error("Failed to set feature folder (Purple may not be active):", error2);
-  }
-}
 async function main() {
   const server = new Server({
     name: "purple-status",
-    version: "1.0.0"
+    version: "2.0.0"
   }, {
     capabilities: {
       tools: {}
@@ -20881,120 +20815,75 @@ async function main() {
   });
   server.setRequestHandler(CallToolRequestSchema, async (request) => {
     const { name, arguments: args } = request.params;
-    let payload;
-    switch (name) {
-      case "purple_update_status": {
-        const typedArgs = args;
-        payload = {
-          tool: name,
-          phase: typedArgs.phase,
-          agent: typedArgs.agent,
-          currentTicket: typedArgs.currentTicket,
-          totalTickets: typedArgs.totalTickets,
-          mode: typedArgs.mode,
-          activeTool: typedArgs.tool,
-          activeFile: typedArgs.activeFile
-        };
-        break;
-      }
-      case "purple_set_phase": {
-        const typedArgs = args;
-        payload = {
-          tool: name,
-          phase: typedArgs.phase
-        };
-        break;
-      }
-      case "purple_report_progress": {
-        const typedArgs = args;
-        payload = {
-          tool: name,
-          currentTicket: typedArgs.current,
-          totalTickets: typedArgs.total
-        };
-        break;
-      }
-      case "purple_ticket_status": {
-        const typedArgs = args;
-        payload = {
-          tool: name,
-          phase: typedArgs.phase,
-          // completed means how many are done, so current ticket is completed + 1
-          currentTicket: typedArgs.completed + 1,
-          totalTickets: typedArgs.total,
-          activeFile: typedArgs.currentTicketName
-          // Use activeFile to show ticket name
-        };
-        break;
-      }
-      case "purple_standards_complete": {
-        const typedArgs = args;
-        await sendStandardsComplete({ message: typedArgs.message });
-        return {
-          content: [
-            {
-              type: "text",
-              text: "Standards upload triggered"
-            }
-          ]
-        };
-      }
-      case "purple_set_feature_folder": {
-        const typedArgs = args;
-        await sendSetFeatureFolder({ folder: typedArgs.folder });
-        return {
-          content: [
-            {
-              type: "text",
-              text: `Feature folder set to: ${typedArgs.folder}`
-            }
-          ]
-        };
-      }
-      case "purple_progress_start_ticket": {
-        const typedArgs = args;
-        payload = {
-          tool: name,
-          ticketId: typedArgs.ticketId,
-          ticketName: typedArgs.ticketName || "",
-          agent: typedArgs.agent || "senior-engineer",
-          ticketAction: "start"
-        };
-        break;
-      }
-      case "purple_progress_complete_ticket": {
-        const typedArgs = args;
-        payload = {
-          tool: name,
-          ticketId: typedArgs.ticketId,
-          ticketAction: "complete"
-        };
-        break;
-      }
-      default:
-        return {
-          content: [
-            {
-              type: "text",
-              text: `Unknown tool: ${name}`
-            }
-          ],
-          isError: true
-        };
+    if (name !== "purple_status") {
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Unknown tool: ${name}. Use 'purple_status' for all status updates.`
+          }
+        ],
+        isError: true
+      };
+    }
+    const typedArgs = args;
+    const payload = {};
+    if (typedArgs.featureFolder) {
+      payload.featureFolder = typedArgs.featureFolder;
+    }
+    if (typedArgs.phase) {
+      payload.phase = typedArgs.phase;
+    }
+    if (typedArgs.agent) {
+      payload.agent = typedArgs.agent;
+    }
+    if (typedArgs.mode) {
+      payload.mode = typedArgs.mode;
+    }
+    if (typedArgs.activeFile) {
+      payload.activeFile = typedArgs.activeFile;
+    }
+    if (typedArgs.completedTickets !== void 0) {
+      payload.completedTickets = typedArgs.completedTickets;
+    }
+    if (typedArgs.totalTickets !== void 0) {
+      payload.totalTickets = typedArgs.totalTickets;
+    }
+    if (typedArgs.qaActive !== void 0) {
+      payload.qaActive = typedArgs.qaActive;
+    }
+    if (typedArgs.qaRunNumber !== void 0) {
+      payload.qaRunNumber = typedArgs.qaRunNumber;
+    }
+    if (typedArgs.qaCurrentTest) {
+      payload.qaCurrentTest = typedArgs.qaCurrentTest;
+    }
+    if (typedArgs.ticket) {
+      payload.ticket = typedArgs.ticket;
     }
     await sendStatusUpdate(payload);
+    let responseText = "Status updated";
+    if (typedArgs.ticket?.id && typedArgs.ticket?.status?.status) {
+      responseText = `Ticket ${typedArgs.ticket.id}: ${typedArgs.ticket.status.status}`;
+    } else if (typedArgs.ticket?.id) {
+      responseText = `Ticket ${typedArgs.ticket.id} updated`;
+    } else if (typedArgs.featureFolder) {
+      responseText = `Feature folder set to: ${typedArgs.featureFolder}`;
+    } else if (typedArgs.phase) {
+      responseText = `Phase: ${typedArgs.phase}`;
+    }
     return {
       content: [
         {
           type: "text",
-          text: "Status updated"
+          text: responseText
         }
       ]
     };
   });
   const transport = new StdioServerTransport();
   await server.connect(transport);
-  console.error("Purple MCP server started");
+  console.error("Purple MCP server started (v2.0.0 - unified purple_status)");
 }
 main().catch((error2) => {
   console.error("Fatal error in MCP server:", error2);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "purple-ai",
-  "version": "0.0.13",
+  "version": "0.0.14",
   "description": "Purple - AI-powered workspace management CLI that wraps Claude Code",
   "main": "bin/purple.js",
   "bin": {