purple-ai 0.0.8 → 0.0.10

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., '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")',
+                },
+                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.10",
   "description": "Purple - AI-powered workspace management CLI that wraps Claude Code",
   "main": "bin/purple.js",
   "bin": {

package/mcp-server/node_modules/@hono/node-server/README.md

@@ -1,357 +0,0 @@
-# Node.js Adapter for Hono
-
-This adapter `@hono/node-server` allows you to run your Hono application on Node.js.
-Initially, Hono wasn't designed for Node.js, but with this adapter, you can now use Hono on Node.js.
-It utilizes web standard APIs implemented in Node.js version 18 or higher.
-
-## Benchmarks
-
-Hono is 3.5 times faster than Express.
-
-Express:
-
-```txt
-$ bombardier -d 10s --fasthttp http://localhost:3000/
-
-Statistics        Avg      Stdev        Max
-  Reqs/sec     16438.94    1603.39   19155.47
-  Latency        7.60ms     7.51ms   559.89ms
-  HTTP codes:
-    1xx - 0, 2xx - 164494, 3xx - 0, 4xx - 0, 5xx - 0
-    others - 0
-  Throughput:     4.55MB/s
-```
-
-Hono + `@hono/node-server`:
-
-```txt
-$ bombardier -d 10s --fasthttp http://localhost:3000/
-
-Statistics        Avg      Stdev        Max
-  Reqs/sec     58296.56    5512.74   74403.56
-  Latency        2.14ms     1.46ms   190.92ms
-  HTTP codes:
-    1xx - 0, 2xx - 583059, 3xx - 0, 4xx - 0, 5xx - 0
-    others - 0
-  Throughput:    12.56MB/s
-```
-
-## Requirements
-
-It works on Node.js versions greater than 18.x. The specific required Node.js versions are as follows:
-
-- 18.x => 18.14.1+
-- 19.x => 19.7.0+
-- 20.x => 20.0.0+
-
-Essentially, you can simply use the latest version of each major release.
-
-## Installation
-
-You can install it from the npm registry with `npm` command:
-
-```sh
-npm install @hono/node-server
-```
-
-Or use `yarn`:
-
-```sh
-yarn add @hono/node-server
-```
-
-## Usage
-
-Just import `@hono/node-server` at the top and write the code as usual.
-The same code that runs on Cloudflare Workers, Deno, and Bun will work.
-
-```ts
-import { serve } from '@hono/node-server'
-import { Hono } from 'hono'
-
-const app = new Hono()
-app.get('/', (c) => c.text('Hono meets Node.js'))
-
-serve(app, (info) => {
-  console.log(`Listening on http://localhost:${info.port}`) // Listening on http://localhost:3000
-})
-```
-
-For example, run it using `ts-node`. Then an HTTP server will be launched. The default port is `3000`.
-
-```sh
-ts-node ./index.ts
-```
-
-Open `http://localhost:3000` with your browser.
-
-## Options
-
-### `port`
-
-```ts
-serve({
-  fetch: app.fetch,
-  port: 8787, // Port number, default is 3000
-})
-```
-
-### `createServer`
-
-```ts
-import { createServer } from 'node:https'
-import fs from 'node:fs'
-
-//...
-
-serve({
-  fetch: app.fetch,
-  createServer: createServer,
-  serverOptions: {
-    key: fs.readFileSync('test/fixtures/keys/agent1-key.pem'),
-    cert: fs.readFileSync('test/fixtures/keys/agent1-cert.pem'),
-  },
-})
-```
-
-### `overrideGlobalObjects`
-
-The default value is `true`. The Node.js Adapter rewrites the global Request/Response and uses a lightweight Request/Response to improve performance. If you don't want to do that, set `false`.
-
-```ts
-serve({
-  fetch: app.fetch,
-  overrideGlobalObjects: false,
-})
-```
-
-### `autoCleanupIncoming`
-
-The default value is `true`. The Node.js Adapter automatically cleans up (explicitly call `destroy()` method) if application is not finished to consume the incoming request. If you don't want to do that, set `false`.
-
-If the application accepts connections from arbitrary clients, this cleanup must be done otherwise incomplete requests from clients may cause the application to stop responding. If your application only accepts connections from trusted clients, such as in a reverse proxy environment and there is no process that returns a response without reading the body of the POST request all the way through, you can improve performance by setting it to `false`.
-
-```ts
-serve({
-  fetch: app.fetch,
-  autoCleanupIncoming: false,
-})
-```
-
-## Middleware
-
-Most built-in middleware also works with Node.js.
-Read [the documentation](https://hono.dev/middleware/builtin/basic-auth) and use the Middleware of your liking.
-
-```ts
-import { serve } from '@hono/node-server'
-import { Hono } from 'hono'
-import { prettyJSON } from 'hono/pretty-json'
-
-const app = new Hono()
-
-app.get('*', prettyJSON())
-app.get('/', (c) => c.json({ 'Hono meets': 'Node.js' }))
-
-serve(app)
-```
-
-## Serve Static Middleware
-
-Use Serve Static Middleware that has been created for Node.js.
-
-```ts
-import { serveStatic } from '@hono/node-server/serve-static'
-
-//...
-
-app.use('/static/*', serveStatic({ root: './' }))
-```
-
-If using a relative path, `root` will be relative to the current working directory from which the app was started.
-
-This can cause confusion when running your application locally.
-
-Imagine your project structure is:
-
-```
-my-hono-project/
-  src/
-    index.ts
-  static/
-    index.html
-```
-
-Typically, you would run your app from the project's root directory (`my-hono-project`),
-so you would need the following code to serve the `static` folder:
-
-```ts
-app.use('/static/*', serveStatic({ root: './static' }))
-```
-
-Notice that `root` here is not relative to `src/index.ts`, rather to `my-hono-project`.
-
-### Options
-
-#### `rewriteRequestPath`
-
-If you want to serve files in `./.foojs` with the request path `/__foo/*`, you can write like the following.
-
-```ts
-app.use(
-  '/__foo/*',
-  serveStatic({
-    root: './.foojs/',
-    rewriteRequestPath: (path: string) => path.replace(/^\/__foo/, ''),
-  })
-)
-```
-
-#### `onFound`
-
-You can specify handling when the requested file is found with `onFound`.
-
-```ts
-app.use(
-  '/static/*',
-  serveStatic({
-    // ...
-    onFound: (_path, c) => {
-      c.header('Cache-Control', `public, immutable, max-age=31536000`)
-    },
-  })
-)
-```
-
-#### `onNotFound`
-
-The `onNotFound` is useful for debugging. You can write a handle for when a file is not found.
-
-```ts
-app.use(
-  '/static/*',
-  serveStatic({
-    root: './non-existent-dir',
-    onNotFound: (path, c) => {
-      console.log(`${path} is not found, request to ${c.req.path}`)
-    },
-  })
-)
-```
-
-#### `precompressed`
-
-The `precompressed` option checks if files with extensions like `.br` or `.gz` are available and serves them based on the `Accept-Encoding` header. It prioritizes Brotli, then Zstd, and Gzip. If none are available, it serves the original file.
-
-```ts
-app.use(
-  '/static/*',
-  serveStatic({
-    precompressed: true,
-  })
-)
-```
-
-## ConnInfo Helper
-
-You can use the [ConnInfo Helper](https://hono.dev/docs/helpers/conninfo) by importing `getConnInfo` from `@hono/node-server/conninfo`.
-
-```ts
-import { getConnInfo } from '@hono/node-server/conninfo'
-
-app.get('/', (c) => {
-  const info = getConnInfo(c) // info is `ConnInfo`
-  return c.text(`Your remote address is ${info.remote.address}`)
-})
-```
-
-## Accessing Node.js API
-
-You can access the Node.js API from `c.env` in Node.js. For example, if you want to specify a type, you can write the following.
-
-```ts
-import { serve } from '@hono/node-server'
-import type { HttpBindings } from '@hono/node-server'
-import { Hono } from 'hono'
-
-const app = new Hono<{ Bindings: HttpBindings }>()
-
-app.get('/', (c) => {
-  return c.json({
-    remoteAddress: c.env.incoming.socket.remoteAddress,
-  })
-})
-
-serve(app)
-```
-
-The APIs that you can get from `c.env` are as follows.
-
-```ts
-type HttpBindings = {
-  incoming: IncomingMessage
-  outgoing: ServerResponse
-}
-
-type Http2Bindings = {
-  incoming: Http2ServerRequest
-  outgoing: Http2ServerResponse
-}
-```
-
-## Direct response from Node.js API
-
-You can directly respond to the client from the Node.js API.
-In that case, the response from Hono should be ignored, so return `RESPONSE_ALREADY_SENT`.
-
-> [!NOTE]
-> This feature can be used when migrating existing Node.js applications to Hono, but we recommend using Hono's API for new applications.
-
-```ts
-import { serve } from '@hono/node-server'
-import type { HttpBindings } from '@hono/node-server'
-import { RESPONSE_ALREADY_SENT } from '@hono/node-server/utils/response'
-import { Hono } from 'hono'
-
-const app = new Hono<{ Bindings: HttpBindings }>()
-
-app.get('/', (c) => {
-  const { outgoing } = c.env
-  outgoing.writeHead(200, { 'Content-Type': 'text/plain' })
-  outgoing.end('Hello World\n')
-
-  return RESPONSE_ALREADY_SENT
-})
-
-serve(app)
-```
-
-## Listen to a UNIX domain socket
-
-You can configure the HTTP server to listen to a UNIX domain socket instead of a TCP port.
-
-```ts
-import { createAdaptorServer } from '@hono/node-server'
-
-// ...
-
-const socketPath ='/tmp/example.sock'
-
-const server = createAdaptorServer(app)
-server.listen(socketPath, () => {
-  console.log(`Listening on ${socketPath}`)
-})
-```
-
-## Related projects
-
-- Hono - <https://hono.dev>
-- Hono GitHub repository - <https://github.com/honojs/hono>
-
-## Author
-
-Yusuke Wada <https://github.com/yusukebe>
-
-## License
-
-MIT

package/mcp-server/node_modules/@hono/node-server/dist/conninfo.d.mts

@@ -1,10 +0,0 @@
-import { GetConnInfo } from 'hono/conninfo';
-
-/**
- * ConnInfo Helper for Node.js
- * @param c Context
- * @returns ConnInfo
- */
-declare const getConnInfo: GetConnInfo;
-
-export { getConnInfo };

package/mcp-server/node_modules/@hono/node-server/dist/conninfo.d.ts

@@ -1,10 +0,0 @@
-import { GetConnInfo } from 'hono/conninfo';
-
-/**
- * ConnInfo Helper for Node.js
- * @param c Context
- * @returns ConnInfo
- */
-declare const getConnInfo: GetConnInfo;
-
-export { getConnInfo };

package/mcp-server/node_modules/@hono/node-server/dist/conninfo.js

@@ -1,42 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/conninfo.ts
-var conninfo_exports = {};
-__export(conninfo_exports, {
-  getConnInfo: () => getConnInfo
-});
-module.exports = __toCommonJS(conninfo_exports);
-var getConnInfo = (c) => {
-  const bindings = c.env.server ? c.env.server : c.env;
-  const address = bindings.incoming.socket.remoteAddress;
-  const port = bindings.incoming.socket.remotePort;
-  const family = bindings.incoming.socket.remoteFamily;
-  return {
-    remote: {
-      address,
-      port,
-      addressType: family === "IPv4" ? "IPv4" : family === "IPv6" ? "IPv6" : void 0
-    }
-  };
-};
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  getConnInfo
-});

package/mcp-server/node_modules/@hono/node-server/dist/conninfo.mjs

@@ -1,17 +0,0 @@
-// src/conninfo.ts
-var getConnInfo = (c) => {
-  const bindings = c.env.server ? c.env.server : c.env;
-  const address = bindings.incoming.socket.remoteAddress;
-  const port = bindings.incoming.socket.remotePort;
-  const family = bindings.incoming.socket.remoteFamily;
-  return {
-    remote: {
-      address,
-      port,
-      addressType: family === "IPv4" ? "IPv4" : family === "IPv6" ? "IPv6" : void 0
-    }
-  };
-};
-export {
-  getConnInfo
-};

package/mcp-server/node_modules/@hono/node-server/dist/globals.d.mts

@@ -1,2 +0,0 @@
-
-export {  }

package/mcp-server/node_modules/@hono/node-server/dist/globals.d.ts

@@ -1,2 +0,0 @@
-
-export {  }

package/mcp-server/node_modules/@hono/node-server/dist/globals.js

@@ -1,39 +0,0 @@
-"use strict";
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-
-// src/globals.ts
-var import_node_crypto = __toESM(require("crypto"));
-var webFetch = global.fetch;
-if (typeof global.crypto === "undefined") {
-  global.crypto = import_node_crypto.default;
-}
-global.fetch = (info, init) => {
-  init = {
-    // Disable compression handling so people can return the result of a fetch
-    // directly in the loader without messing with the Content-Encoding header.
-    compress: false,
-    ...init
-  };
-  return webFetch(info, init);
-};

package/mcp-server/node_modules/@hono/node-server/dist/globals.mjs

@@ -1,15 +0,0 @@
-// src/globals.ts
-import crypto from "crypto";
-var webFetch = global.fetch;
-if (typeof global.crypto === "undefined") {
-  global.crypto = crypto;
-}
-global.fetch = (info, init) => {
-  init = {
-    // Disable compression handling so people can return the result of a fetch
-    // directly in the loader without messing with the Content-Encoding header.
-    compress: false,
-    ...init
-  };
-  return webFetch(info, init);
-};

package/mcp-server/node_modules/@hono/node-server/dist/index.d.mts

@@ -1,8 +0,0 @@
-export { createAdaptorServer, serve } from './server.mjs';
-export { getRequestListener } from './listener.mjs';
-export { RequestError } from './request.mjs';
-export { Http2Bindings, HttpBindings, ServerType } from './types.mjs';
-import 'node:net';
-import 'node:http';
-import 'node:http2';
-import 'node:https';