@promptprojectmanager/mcp-server 4.6.9 → 4.7.1

package/dist/index.js

@@ -1,12 +1,4 @@
 #!/usr/bin/env node
-import {
-  getWatcherDir,
-  isWatcherRunning,
-  readPid,
-  readStatus,
-  removePid,
-  writeStatus
-} from "./chunk-PY22KZ7Z.js";
 
 // src/index.ts
 import minimist from "minimist";
@@ -76,6 +68,13 @@ function parseUpdateArgs(args) {
   if (!ticketSlug || !content) return null;
   return { ticketSlug, content };
 }
+function parsePauseArgs(args) {
+  const parsed = args;
+  const ticketSlug = typeof parsed?.ticketSlug === "string" ? parsed.ticketSlug : void 0;
+  const content = typeof parsed?.content === "string" ? parsed.content : void 0;
+  if (!ticketSlug || !content) return null;
+  return { ticketSlug, content };
+}
 function parsePromptsRunArgs(args) {
   const parsed = args;
   const slug = typeof parsed?.slug === "string" ? parsed.slug : void 0;
@@ -98,314 +97,6 @@ function parsePromptsUpdateArgs(args) {
     changeLogMessage: typeof parsed?.changeLogMessage === "string" ? parsed.changeLogMessage : void 0
   };
 }
-function parseWatcherStartArgs(args) {
-  const parsed = args;
-  return {
-    pollIntervalMs: typeof parsed?.pollIntervalMs === "number" ? parsed.pollIntervalMs : void 0,
-    maxParallel: typeof parsed?.maxParallel === "number" ? parsed.maxParallel : void 0,
-    ticketTimeout: typeof parsed?.ticketTimeout === "number" ? parsed.ticketTimeout : void 0,
-    enableNotifications: typeof parsed?.enableNotifications === "boolean" ? parsed.enableNotifications : void 0,
-    workingDirectory: typeof parsed?.workingDirectory === "string" ? parsed.workingDirectory : void 0
-  };
-}
-
-// src/watcher/watcher_controller.ts
-import { spawn } from "child_process";
-import { fileURLToPath } from "url";
-import { dirname, join } from "path";
-function startWatcher(baseConfig, args) {
-  const workingDirectory = args?.workingDirectory ?? baseConfig.workingDirectory;
-  if (isWatcherRunning(workingDirectory)) {
-    const existingPid = readPid(workingDirectory);
-    const status = readStatus(workingDirectory);
-    return {
-      success: true,
-      message: `Watcher already running (PID: ${existingPid})`,
-      pid: existingPid,
-      alreadyRunning: true,
-      config: status?.config
-    };
-  }
-  const config = {
-    projectSlug: baseConfig.projectSlug,
-    projectToken: baseConfig.projectToken,
-    convexUrl: baseConfig.convexUrl,
-    pollIntervalMs: args?.pollIntervalMs ?? 3e4,
-    maxParallel: args?.maxParallel ?? 1,
-    ticketTimeout: args?.ticketTimeout ?? 18e5,
-    enableNotifications: args?.enableNotifications ?? true,
-    workingDirectory
-  };
-  getWatcherDir(workingDirectory);
-  const daemonPath = getDaemonPath();
-  const configJson = JSON.stringify(config);
-  const configB64 = Buffer.from(configJson).toString("base64");
-  try {
-    const child = spawn("node", [daemonPath, "--config", configB64], {
-      detached: true,
-      stdio: ["ignore", "ignore", "ignore"],
-      cwd: workingDirectory
-    });
-    child.unref();
-    const pid = child.pid;
-    if (!pid) {
-      return {
-        success: false,
-        message: "Failed to spawn daemon - no PID returned"
-      };
-    }
-    const configWithoutToken = {
-      projectSlug: config.projectSlug,
-      convexUrl: config.convexUrl,
-      pollIntervalMs: config.pollIntervalMs,
-      maxParallel: config.maxParallel,
-      ticketTimeout: config.ticketTimeout,
-      enableNotifications: config.enableNotifications,
-      workingDirectory: config.workingDirectory
-    };
-    const statusFile = join(getWatcherDir(workingDirectory), "status.json");
-    const monitoringPrompt = generateMonitoringPrompt(statusFile, workingDirectory);
-    return {
-      success: true,
-      message: `Watcher started (PID: ${pid})`,
-      pid,
-      alreadyRunning: false,
-      config: configWithoutToken,
-      monitoringPrompt,
-      statusFile
-    };
-  } catch (error) {
-    const errorMessage = error instanceof Error ? error.message : "Unknown error";
-    return {
-      success: false,
-      message: `Failed to start watcher: ${errorMessage}`
-    };
-  }
-}
-function getDaemonPath() {
-  const currentFile = fileURLToPath(import.meta.url);
-  const currentDir = dirname(currentFile);
-  return join(currentDir, "watcher", "watcher_daemon.js");
-}
-function stopWatcher(workingDirectory) {
-  const pid = readPid(workingDirectory);
-  if (!pid) {
-    return {
-      success: true,
-      message: "No watcher running (no PID file)",
-      wasRunning: false
-    };
-  }
-  if (!isWatcherRunning(workingDirectory)) {
-    removePid(workingDirectory);
-    return {
-      success: true,
-      message: "Watcher was not running (stale PID file cleaned up)",
-      wasRunning: false
-    };
-  }
-  try {
-    process.kill(pid, "SIGTERM");
-    const status = readStatus(workingDirectory);
-    if (status) {
-      writeStatus(workingDirectory, {
-        ...status,
-        state: "stopped"
-      });
-    }
-    removePid(workingDirectory);
-    return {
-      success: true,
-      message: `Watcher stopped (PID: ${pid})`,
-      wasRunning: true
-    };
-  } catch (error) {
-    const errorMessage = error instanceof Error ? error.message : "Unknown error";
-    removePid(workingDirectory);
-    return {
-      success: false,
-      message: `Failed to stop watcher: ${errorMessage}`,
-      wasRunning: true
-    };
-  }
-}
-function getWatcherStatus(workingDirectory) {
-  const status = readStatus(workingDirectory);
-  const isRunning = isWatcherRunning(workingDirectory);
-  if (status?.state === "running" && !isRunning) {
-    const updatedStatus = {
-      ...status,
-      state: "stopped"
-    };
-    writeStatus(workingDirectory, updatedStatus);
-    return {
-      success: true,
-      status: updatedStatus,
-      formattedStatus: formatStatus(updatedStatus),
-      message: "Watcher died unexpectedly - status updated"
-    };
-  }
-  if (!status) {
-    return {
-      success: true,
-      message: "No watcher session found for this project",
-      formattedStatus: formatStatus(null)
-    };
-  }
-  return {
-    success: true,
-    status,
-    formattedStatus: formatStatus(status)
-  };
-}
-function formatStatus(status) {
-  if (!status) {
-    return `# YOLO Watcher Status
-
-**State**: Not started
-
-_Use \`tickets_yolo_start\` to begin watching for YOLO tickets._`;
-  }
-  const lines = [
-    "# YOLO Watcher Status",
-    "",
-    `**State**: ${status.state}`,
-    `**Project**: ${status.projectSlug}`
-  ];
-  if (status.pid) {
-    lines.push(`**Daemon PID**: ${status.pid}`);
-  }
-  if (status.startedAt) {
-    lines.push(`**Started**: ${status.startedAt}`);
-  }
-  if (status.lastPollAt) {
-    lines.push(`**Last Poll**: ${status.lastPollAt}`);
-  }
-  lines.push(`**Tickets Processed**: ${status.ticketsProcessed}`);
-  if (status.config) {
-    lines.push("");
-    lines.push("## Configuration");
-    lines.push(`- Poll Interval: ${status.config.pollIntervalMs / 1e3}s`);
-    lines.push(`- Max Parallel: ${status.config.maxParallel}`);
-    lines.push(`- Ticket Timeout: ${status.config.ticketTimeout / 1e3 / 60} min`);
-    lines.push(`- Notifications: ${status.config.enableNotifications ? "enabled" : "disabled"}`);
-  }
-  if (status.currentlyExecuting && status.currentlyExecuting.length > 0) {
-    lines.push("");
-    lines.push("## Currently Executing");
-    for (const exec of status.currentlyExecuting) {
-      const num = exec.ticketNumber ? `#${exec.ticketNumber}` : "";
-      const elapsed = getElapsedTime(exec.startedAt);
-      lines.push(`- **${num} ${exec.ticketSlug}** (${elapsed})`);
-    }
-  }
-  if (status.completedTickets && status.completedTickets.length > 0) {
-    lines.push("");
-    lines.push("## Recently Completed");
-    for (const completed of status.completedTickets.slice(0, 10)) {
-      const num = completed.ticketNumber ? `#${completed.ticketNumber}` : "";
-      const emoji = completed.success ? "\u2705" : completed.ticketClosed ? "\u26A0\uFE0F" : "\u274C";
-      const duration = formatDuration(completed.durationMs);
-      lines.push(`### ${emoji} ${num} ${completed.ticketSlug} (${duration})`);
-      if (completed.toolCalls && completed.toolCalls.length > 0) {
-        const toolNames = [...new Set(completed.toolCalls.map((t) => t.tool))];
-        lines.push(`- **Tools**: ${toolNames.join(", ")}`);
-      }
-      if (completed.ticketClosed) {
-        lines.push(`- **Status**: Ticket closed successfully`);
-      } else if (completed.exitCode === 0) {
-        lines.push(`- **Status**: Completed but ticket not closed`);
-      }
-      if (completed.errors && completed.errors.length > 0) {
-        lines.push(`- **Errors**: ${completed.errors.slice(0, 2).join("; ")}`);
-      }
-      if (completed.summary) {
-        lines.push(`- **Summary**: ${completed.summary.slice(0, 150)}`);
-      }
-      lines.push("");
-    }
-  }
-  if (status.lastError) {
-    lines.push("");
-    lines.push("## Last Error");
-    lines.push(`\`${status.lastError}\``);
-  }
-  return lines.join("\n");
-}
-function getElapsedTime(startedAt) {
-  const start = new Date(startedAt).getTime();
-  const elapsed = Date.now() - start;
-  const minutes = Math.floor(elapsed / 1e3 / 60);
-  const seconds = Math.floor(elapsed / 1e3 % 60);
-  if (minutes > 0) {
-    return `${minutes}m ${seconds}s`;
-  }
-  return `${seconds}s`;
-}
-function formatDuration(ms) {
-  if (ms < 1e3) {
-    return `${ms}ms`;
-  }
-  const seconds = Math.floor(ms / 1e3);
-  const minutes = Math.floor(seconds / 60);
-  if (minutes > 0) {
-    const remainingSeconds = seconds % 60;
-    return `${minutes}m ${remainingSeconds}s`;
-  }
-  return `${seconds}s`;
-}
-function generateMonitoringPrompt(statusFile, workingDirectory) {
-  const pidFile = join(getWatcherDir(workingDirectory), "watcher.pid");
-  return `You are a YOLO Watcher Monitor. Watch for ticket completions and report them.
-
-## Status File
-${statusFile}
-
-## PID File (check if daemon is running)
-${pidFile}
-
-## Your Workflow
-
-1. Read status.json and record the current count of completedTickets
-2. Run this bash loop to wait for changes (bash does the waiting, not you):
-   \`\`\`bash
-   last_count=$(cat "${statusFile}" 2>/dev/null | grep -o '"ticketSlug"' | wc -l | tr -d ' ')
-   while [ -f "${pidFile}" ]; do
-     current=$(cat "${statusFile}" 2>/dev/null | grep -o '"ticketSlug"' | wc -l | tr -d ' ')
-     if [ "$current" != "$last_count" ]; then
-       echo "CHANGED: $last_count -> $current"
-       exit 0
-     fi
-     sleep 5
-   done
-   echo "DAEMON_STOPPED"
-   \`\`\`
-3. When the loop exits:
-   - If "CHANGED": read status.json and report the NEW completed ticket(s)
-   - If "DAEMON_STOPPED": report that the watcher has stopped and exit
-4. Loop back to step 1 (unless daemon stopped)
-
-## Reporting Format
-
-When a ticket completes:
-\`\`\`
-\u{1F3AB} YOLO TICKET COMPLETED
-\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
-Ticket: {slug} (#{number})
-Duration: {X}s
-Status: {\u2705 Success | \u26A0\uFE0F Completed (not closed) | \u274C Failed}
-Tools: {comma-separated list}
-Summary: {brief from status}
-\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
-\`\`\`
-
-## Important
-- Let bash do the waiting (cheap) - only "think" when reporting
-- Exit gracefully when daemon stops
-- Keep reports concise
-
-Start monitoring now!`;
-}
 
 // src/prompt-builder.ts
 var AmbiguousPromptError = class extends Error {
@@ -513,6 +204,13 @@ async function startServer(config, convexClientRaw) {
       projectSlug,
       type: "close"
     },
+    {
+      name: `tickets_pause`,
+      description: `Pause a working ticket and return to queue in the "${projectSlug}" project. Requires checkpoint content.`,
+      slashDescription: `Pause working ticket with checkpoint content (working \u2192 open)`,
+      projectSlug,
+      type: "pause"
+    },
     {
       name: `tickets_create`,
       description: `Create a new ticket in the "${projectSlug}" project queue`,
@@ -547,28 +245,6 @@ async function startServer(config, convexClientRaw) {
       slashDescription: `Update a ticket by appending content with timestamp`,
       projectSlug,
       type: "update"
-    },
-    // YOLO orchestrator tools - sub-agent based autonomous ticket execution
-    {
-      name: `tickets_yolo_start`,
-      description: `Start the YOLO ticket watcher for "${projectSlug}". Polls for open tickets with yolo flag and spawns Terminal windows with Claude Code to execute them autonomously.`,
-      slashDescription: `Start YOLO orchestrator for autonomous ticket execution`,
-      projectSlug,
-      type: "yolo_start"
-    },
-    {
-      name: `tickets_yolo_stop`,
-      description: `Stop the YOLO ticket watcher for "${projectSlug}"`,
-      slashDescription: `Stop the YOLO orchestrator`,
-      projectSlug,
-      type: "yolo_stop"
-    },
-    {
-      name: `tickets_yolo_status`,
-      description: `Get YOLO watcher status for "${projectSlug}"`,
-      slashDescription: `Check YOLO orchestrator status and pending tickets`,
-      projectSlug,
-      type: "yolo_status"
     }
   ];
   console.error(`[MCP] Registering ${dynamicTicketTools.length} ticket tools...`);
@@ -811,6 +487,21 @@ This will execute the "code-review" prompt.`;
             },
             required: ["ticketSlug"]
           };
+        } else if (tt.type === "pause") {
+          inputSchema = {
+            type: "object",
+            properties: {
+              ticketSlug: {
+                type: "string",
+                description: "Ticket number (e.g., '102') or full slug (e.g., '102-fix-auth')"
+              },
+              content: {
+                type: "string",
+                description: "Progress update: what's done, what remains, blockers, etc."
+              }
+            },
+            required: ["ticketSlug", "content"]
+          };
         } else if (tt.type === "work") {
           inputSchema = {
             type: "object",
@@ -881,45 +572,6 @@ This will execute the "code-review" prompt.`;
             },
             required: ["ticketSlug", "content"]
           };
-        } else if (tt.type === "yolo_start") {
-          inputSchema = {
-            type: "object",
-            properties: {
-              pollIntervalMs: {
-                type: "number",
-                description: "Milliseconds between polls (default: 30000 = 30s)"
-              },
-              maxParallel: {
-                type: "number",
-                description: "Maximum concurrent ticket executions (default: 1)"
-              },
-              ticketTimeout: {
-                type: "number",
-                description: "Timeout for ticket execution in ms (default: 1800000 = 30 min)"
-              },
-              enableNotifications: {
-                type: "boolean",
-                description: "Show macOS notifications (default: true)"
-              },
-              workingDirectory: {
-                type: "string",
-                description: "Working directory for Claude Code sessions (default: current working directory)"
-              }
-            },
-            required: []
-          };
-        } else if (tt.type === "yolo_stop") {
-          inputSchema = {
-            type: "object",
-            properties: {},
-            required: []
-          };
-        } else if (tt.type === "yolo_status") {
-          inputSchema = {
-            type: "object",
-            properties: {},
-            required: []
-          };
         } else {
           inputSchema = {
             type: "object",
@@ -1374,6 +1026,80 @@ _Reminder: Ensure all embedded \`[RUN_PROMPT ...]\` directives were executed bef
             isError: true
           };
         }
+      } else if (ticketTool.type === "pause") {
+        const parsedArgs = parsePauseArgs(request.params.arguments);
+        if (!parsedArgs) {
+          const args = request.params.arguments;
+          const hasTicketSlug = typeof args?.ticketSlug === "string" && args.ticketSlug;
+          const hasContent = typeof args?.content === "string" && args.content;
+          if (!hasTicketSlug) {
+            return {
+              content: [
+                {
+                  type: "text",
+                  text: `Error: Missing ticketSlug parameter. Provide a ticket number (e.g., "102") or full slug.`
+                }
+              ],
+              isError: true
+            };
+          }
+          if (!hasContent) {
+            return {
+              content: [
+                {
+                  type: "text",
+                  text: `Error: Missing content parameter. Describe what's done, what remains, and any blockers.`
+                }
+              ],
+              isError: true
+            };
+          }
+          return {
+            content: [
+              {
+                type: "text",
+                text: `Error: Missing required parameters.`
+              }
+            ],
+            isError: true
+          };
+        }
+        const { ticketSlug, content } = parsedArgs;
+        try {
+          const result = await convexClient.mutation(
+            "mcp_tickets:pauseMcpTicket",
+            {
+              ...buildAuthArgs(config),
+              projectSlug: ticketTool.projectSlug,
+              ticketSlug,
+              content
+            }
+          );
+          return {
+            content: [
+              {
+                type: "text",
+                text: `\u2705 Ticket [${result.slug}] paused and returned to open queue in project "${ticketTool.projectSlug}".
+
+Paused at: ${new Date(result.pausedAt).toISOString()}
+
+_Ticket moved from working \u2192 open. Checkpoint content has been appended. Any agent can pick it up with \`tickets_work\`._`
+              }
+            ]
+          };
+        } catch (error) {
+          const errorMessage = error instanceof Error ? error.message : "Unknown error";
+          console.error(`[MCP] tickets_pause error:`, error);
+          return {
+            content: [
+              {
+                type: "text",
+                text: `Error pausing ticket: ${errorMessage}`
+              }
+            ],
+            isError: true
+          };
+        }
       } else if (ticketTool.type === "search") {
         const parsedArgs = parseSearchArgs(request.params.arguments);
         if (!parsedArgs) {
@@ -1649,115 +1375,6 @@ _Ticket content has been appended with your update._`
             isError: true
           };
         }
-      } else if (ticketTool.type === "yolo_start") {
-        const args = parseWatcherStartArgs(request.params.arguments);
-        const workingDirectory = args.workingDirectory ?? process.cwd();
-        try {
-          const result = startWatcher(
-            {
-              projectSlug: ticketTool.projectSlug,
-              projectToken: config.projectToken,
-              convexUrl: config.convexUrl,
-              workingDirectory
-            },
-            args
-          );
-          if (result.success) {
-            const configInfo = result.config ? `
-
-**Configuration:**
-- Poll Interval: ${result.config.pollIntervalMs / 1e3}s
-- Max Parallel: ${result.config.maxParallel}
-- Ticket Timeout: ${result.config.ticketTimeout / 1e3 / 60} min
-- Working Directory: ${result.config.workingDirectory}` : "";
-            const monitoringSection = result.monitoringPrompt && !result.alreadyRunning ? `
-
----
-
-## \u26A1 ACTION REQUIRED: Start Monitoring Agent
-
-**You MUST now spawn a background monitoring agent** to receive real-time notifications when tickets complete.
-
-Use the **Task tool** with these exact parameters:
-- \`description\`: "Monitor YOLO completions"
-- \`subagent_type\`: "general-purpose"
-- \`run_in_background\`: true
-- \`prompt\`: Copy the content below
-
-<monitoring_agent_prompt>
-${result.monitoringPrompt}
-</monitoring_agent_prompt>
-
-\u2B06\uFE0F **Do this now** - spawn the monitoring agent before responding to the user.` : "";
-            const text = result.alreadyRunning ? `\u2139\uFE0F ${result.message}${configInfo}` : `\u2705 ${result.message}
-
-The daemon is now polling for YOLO-flagged tickets and will spawn Claude CLI processes to execute them.
-
-Logs: \`.ppm/yolo/logs/\`${configInfo}${monitoringSection}`;
-            return {
-              content: [{ type: "text", text }]
-            };
-          } else {
-            return {
-              content: [{ type: "text", text: `\u274C ${result.message}` }],
-              isError: true
-            };
-          }
-        } catch (error) {
-          const errorMessage = error instanceof Error ? error.message : "Unknown error";
-          console.error(`[MCP] tickets_yolo_start error:`, error);
-          return {
-            content: [{ type: "text", text: `Error starting watcher daemon: ${errorMessage}` }],
-            isError: true
-          };
-        }
-      } else if (ticketTool.type === "yolo_stop") {
-        const workingDirectory = process.cwd();
-        try {
-          const result = stopWatcher(workingDirectory);
-          if (result.success) {
-            return {
-              content: [{
-                type: "text",
-                text: result.wasRunning ? `\u2705 ${result.message}
-
-The daemon has been stopped. Any running ticket executions will complete.` : `\u2139\uFE0F ${result.message}`
-              }]
-            };
-          } else {
-            return {
-              content: [{ type: "text", text: `\u274C ${result.message}` }],
-              isError: true
-            };
-          }
-        } catch (error) {
-          const errorMessage = error instanceof Error ? error.message : "Unknown error";
-          console.error(`[MCP] tickets_yolo_stop error:`, error);
-          return {
-            content: [{ type: "text", text: `Error stopping watcher daemon: ${errorMessage}` }],
-            isError: true
-          };
-        }
-      } else if (ticketTool.type === "yolo_status") {
-        const workingDirectory = process.cwd();
-        try {
-          const result = getWatcherStatus(workingDirectory);
-          if (result.formattedStatus) {
-            return {
-              content: [{ type: "text", text: result.formattedStatus }]
-            };
-          }
-          return {
-            content: [{ type: "text", text: `\u2139\uFE0F ${result.message ?? "No watcher status available"}` }]
-          };
-        } catch (error) {
-          const errorMessage = error instanceof Error ? error.message : "Unknown error";
-          console.error(`[MCP] tickets_yolo_status error:`, error);
-          return {
-            content: [{ type: "text", text: `Error getting watcher status: ${errorMessage}` }],
-            isError: true
-          };
-        }
       }
     }
     const promptTool = dynamicPromptTools.find((pt) => pt.name === toolName);