purple-ai 0.0.8 → 0.0.9

package/mcp-server/dist/index.d.ts

@@ -8,11 +8,15 @@
  * - purple_update_status: Full status update with all fields
  * - purple_set_phase: Quick helper to set just the phase
  * - purple_report_progress: Report ticket progress during implementation
+ * - purple_set_feature_folder: Set feature folder for progress.json monitoring
+ * - purple_progress_start_ticket: Mark a ticket as in_progress
+ * - purple_progress_complete_ticket: Mark a ticket as completed
  *
  * Communication flow:
  * Claude Agent -> MCP Server (stdio) -> HTTP POST localhost:7685 -> Purple CLI
  *
  * Changelog:
+ * - 2026-01-13: Added feature folder and progress tracking tools
  * - 2026-01-12: Initial implementation
  */
 export {};

package/mcp-server/dist/index.js

@@ -8,11 +8,15 @@
  * - purple_update_status: Full status update with all fields
  * - purple_set_phase: Quick helper to set just the phase
  * - purple_report_progress: Report ticket progress during implementation
+ * - purple_set_feature_folder: Set feature folder for progress.json monitoring
+ * - purple_progress_start_ticket: Mark a ticket as in_progress
+ * - purple_progress_complete_ticket: Mark a ticket as completed
  *
  * Communication flow:
  * Claude Agent -> MCP Server (stdio) -> HTTP POST localhost:7685 -> Purple CLI
  *
  * Changelog:
+ * - 2026-01-13: Added feature folder and progress tracking tools
  * - 2026-01-12: Initial implementation
  */
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
@@ -21,6 +25,7 @@ import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextpro
 // Purple CLI status server endpoints
 const PURPLE_STATUS_URL = "http://127.0.0.1:7685/status";
 const PURPLE_STANDARDS_COMPLETE_URL = "http://127.0.0.1:7685/standards-complete";
+const PURPLE_SET_FEATURE_FOLDER_URL = "http://127.0.0.1:7685/set-feature-folder";
 // Tool definitions
 const TOOLS = [
     {
@@ -137,6 +142,59 @@ const TOOLS = [
             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., 'workbench/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., "workbench/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")',
+                },
+                ticketName: {
+                    type: "string",
+                    description: 'The ticket name/description (e.g., "Firebase authentication service")',
+                },
+                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")',
+                },
+            },
+            required: ["ticketId"],
+            additionalProperties: false,
+        },
+    },
 ];
 /**
  * Sends a status update to the Purple CLI via HTTP POST.
@@ -183,6 +241,26 @@ async function sendStandardsComplete(payload) {
         console.error("Failed to send standards complete signal (Purple may not be active):", error);
     }
 }
+/**
+ * Sets the active feature folder for progress.json monitoring.
+ */
+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 (error) {
+        console.error("Failed to set feature folder (Purple may not be active):", error);
+    }
+}
 /**
  * Main function to initialize and run the MCP server
  */
@@ -264,6 +342,39 @@ async function main() {
                     ],
                 };
             }
+            case "purple_set_feature_folder": {
+                const typedArgs = args;
+                // Send feature folder to Purple for progress.json monitoring
+                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: [

package/package.json

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