panopticon-cli 0.3.3 → 0.3.4

package/dist/cli/index.js

@@ -16,7 +16,7 @@ import {
   restoreBackup,
   saveConfig,
   syncHooks
-} from "../chunk-ZT55DPAC.js";
+} from "../chunk-C6A7S65K.js";
 import {
   PROJECTS_CONFIG_FILE,
   getProject,
@@ -26,7 +26,7 @@ import {
   registerProject,
   resolveProjectFromIssue,
   unregisterProject
-} from "../chunk-IVAFJ6DS.js";
+} from "../chunk-BH6BR26M.js";
 import {
   AGENTS_DIR,
   CERTS_DIR,
@@ -42,11 +42,11 @@ import {
   SYNC_TARGETS,
   TRAEFIK_CERTS_DIR,
   TRAEFIK_DIR
-} from "../chunk-3SI436SZ.js";
+} from "../chunk-P5TQ5C3J.js";
 
 // src/cli/index.ts
 import { Command } from "commander";
-import chalk29 from "chalk";
+import chalk33 from "chalk";
 
 // src/cli/commands/init.ts
 import { existsSync, mkdirSync, readdirSync, cpSync } from "fs";
@@ -294,7 +294,7 @@ async function restoreCommand(timestamp) {
     ]);
     timestamp = selected;
   }
-  const { confirm } = await inquirer.prompt([
+  const { confirm: confirm2 } = await inquirer.prompt([
     {
       type: "confirm",
       name: "confirm",
@@ -302,7 +302,7 @@ async function restoreCommand(timestamp) {
       default: false
     }
   ]);
-  if (!confirm) {
+  if (!confirm2) {
     console.log(chalk3.dim("Restore cancelled."));
     return;
   }
@@ -3759,7 +3759,7 @@ async function createCommand(issueId, options) {
   }
 }
 async function listCommand2(options) {
-  const { listProjects: listProjects3 } = await import("../projects-EHEXMVSP.js");
+  const { listProjects: listProjects3 } = await import("../projects-54CV437J.js");
   const projects = listProjects3();
   if (projects.length > 0 && options.all) {
     const allWorkspaces = [];
@@ -4530,6 +4530,19 @@ function getSessionFiles(projectDir) {
     }
   });
 }
+function getAllSessionFiles() {
+  const files = [];
+  for (const projectDir of getProjectDirs()) {
+    files.push(...getSessionFiles(projectDir));
+  }
+  return files.sort((a, b) => {
+    try {
+      return statSync2(b).mtime.getTime() - statSync2(a).mtime.getTime();
+    } catch {
+      return 0;
+    }
+  });
+}
 function normalizeModelName(model) {
   if (model.includes("claude")) {
     let normalizedModel = model;
@@ -4703,6 +4716,23 @@ function getSessionId(name) {
     return null;
   }
 }
+function clearSessionId(name) {
+  const sessionFile = getSessionFilePath(name);
+  if (!existsSync21(sessionFile)) {
+    return false;
+  }
+  try {
+    unlinkSync2(sessionFile);
+    return true;
+  } catch (error) {
+    console.error(`Failed to delete session file for ${name}:`, error);
+    throw error;
+  }
+}
+function getSpecialistMetadata(name) {
+  const registry = loadRegistry();
+  return registry.specialists.find((s) => s.name === name) || null;
+}
 function updateSpecialistMetadata(name, updates) {
   const registry = loadRegistry();
   const index = registry.specialists.findIndex((s) => s.name === name);
@@ -4736,6 +4766,34 @@ function recordWake(name, sessionId) {
 function getEnabledSpecialists() {
   return getAllSpecialists().filter((s) => s.enabled);
 }
+function findSessionFile(sessionId) {
+  try {
+    const allFiles = getAllSessionFiles();
+    for (const file of allFiles) {
+      const fileSessionId = basename4(file, ".jsonl");
+      if (fileSessionId === sessionId) {
+        return file;
+      }
+    }
+  } catch {
+  }
+  return null;
+}
+function countContextTokens(name) {
+  const sessionId = getSessionId(name);
+  if (!sessionId) {
+    return null;
+  }
+  const sessionFile = findSessionFile(sessionId);
+  if (!sessionFile) {
+    return null;
+  }
+  const sessionUsage = parseClaudeSession(sessionFile);
+  if (!sessionUsage) {
+    return null;
+  }
+  return sessionUsage.usage.inputTokens + sessionUsage.usage.outputTokens + (sessionUsage.usage.cacheReadTokens || 0) + (sessionUsage.usage.cacheWriteTokens || 0);
+}
 function isRunning(name) {
   const tmuxSession = getTmuxSessionName(name);
   try {
@@ -4745,6 +4803,37 @@ function isRunning(name) {
     return false;
   }
 }
+function getSpecialistStatus(name) {
+  const metadata = getSpecialistMetadata(name) || {
+    name,
+    displayName: name,
+    description: "",
+    enabled: false,
+    autoWake: false
+  };
+  const sessionId = getSessionId(name);
+  const running = isRunning(name);
+  const contextTokens = countContextTokens(name);
+  let state;
+  if (running) {
+    state = "active";
+  } else if (sessionId) {
+    state = "sleeping";
+  } else {
+    state = "uninitialized";
+  }
+  return {
+    ...metadata,
+    sessionId: sessionId || void 0,
+    contextTokens: contextTokens || void 0,
+    state,
+    isRunning: running,
+    tmuxSession: getTmuxSessionName(name)
+  };
+}
+function getAllSpecialistStatus() {
+  return getAllSpecialists().map((metadata) => getSpecialistStatus(metadata.name));
+}
 async function initializeSpecialist(name) {
   if (isRunning(name)) {
     return {
@@ -4817,6 +4906,9 @@ async function initializeEnabledSpecialists() {
   }
   return results;
 }
+function checkSpecialistQueue(specialistName) {
+  return checkHook(specialistName);
+}
 
 // src/lib/runtimes/claude-code.ts
 import { existsSync as existsSync22, readFileSync as readFileSync18, statSync as statSync3, mkdirSync as mkdirSync16, writeFileSync as writeFileSync14 } from "fs";
@@ -5918,7 +6010,7 @@ var CloisterService = class {
           }
         }
       }
-      await this.checkHandoffTriggers(agentHealths);
+      void this.checkHandoffTriggers(agentHealths);
     } catch (error) {
       console.error("Cloister health check failed:", error);
       this.emit({ type: "error", error });
@@ -6411,23 +6503,341 @@ function registerSetupCommands(program2) {
   setup.command("hooks").description("Configure Claude Code hooks for heartbeat tracking").action(setupHooksCommand);
 }
 
-// src/cli/commands/project.ts
+// src/cli/commands/specialists/list.ts
 import chalk26 from "chalk";
+function listCommand3(options) {
+  const specialists = getAllSpecialistStatus();
+  if (options.json) {
+    console.log(JSON.stringify(specialists, null, 2));
+    return;
+  }
+  console.log(chalk26.bold("\nSpecialist Agents:\n"));
+  if (specialists.length === 0) {
+    console.log(chalk26.dim("No specialists configured."));
+    console.log("");
+    return;
+  }
+  for (const specialist of specialists) {
+    displaySpecialist(specialist);
+  }
+  console.log("");
+}
+function displaySpecialist(specialist) {
+  const statusIcon = getStatusIcon(specialist);
+  const statusColor = getStatusColor(specialist);
+  const enabledBadge = specialist.enabled ? chalk26.green("enabled") : chalk26.dim("disabled");
+  console.log(`${statusIcon} ${chalk26.bold(specialist.displayName)} (${enabledBadge})`);
+  console.log(`  ${chalk26.dim(specialist.description)}`);
+  console.log(`  Status: ${statusColor(specialist.state)}`);
+  if (specialist.isRunning) {
+    console.log(`  Running: ${chalk26.cyan(specialist.tmuxSession)}`);
+  }
+  if (specialist.sessionId) {
+    const shortId = specialist.sessionId.substring(0, 8);
+    console.log(`  Session: ${chalk26.dim(shortId + "...")}`);
+  }
+  if (specialist.contextTokens) {
+    const tokensFormatted = specialist.contextTokens.toLocaleString();
+    console.log(`  Context: ${chalk26.dim(tokensFormatted + " tokens")}`);
+  }
+  if (specialist.lastWake) {
+    const lastWake = new Date(specialist.lastWake);
+    const relative = getRelativeTime(lastWake);
+    console.log(`  Last wake: ${chalk26.dim(relative)}`);
+  }
+  console.log("");
+}
+function getStatusIcon(specialist) {
+  if (!specialist.enabled) return chalk26.dim("\u25CB");
+  if (specialist.isRunning) return chalk26.green("\u25CF");
+  if (specialist.state === "sleeping") return chalk26.yellow("\u25CF");
+  return chalk26.dim("\u25CB");
+}
+function getStatusColor(specialist) {
+  if (specialist.isRunning) return chalk26.green;
+  if (specialist.state === "sleeping") return chalk26.yellow;
+  return chalk26.dim;
+}
+function getRelativeTime(date) {
+  const now = /* @__PURE__ */ new Date();
+  const diff = now.getTime() - date.getTime();
+  const seconds = Math.floor(diff / 1e3);
+  const minutes = Math.floor(seconds / 60);
+  const hours = Math.floor(minutes / 60);
+  const days = Math.floor(hours / 24);
+  if (days > 0) return `${days}d ago`;
+  if (hours > 0) return `${hours}h ago`;
+  if (minutes > 0) return `${minutes}m ago`;
+  return "just now";
+}
+
+// src/cli/commands/specialists/wake.ts
+import chalk27 from "chalk";
+import { execSync as execSync13 } from "child_process";
+function wakeCommand(name, options) {
+  const validNames = ["merge-agent", "review-agent", "test-agent"];
+  if (!validNames.includes(name)) {
+    console.log(chalk27.red(`
+Error: Unknown specialist '${name}'`));
+    console.log(`Valid specialists: ${validNames.join(", ")}
+`);
+    process.exit(1);
+  }
+  const specialistName = name;
+  const status = getSpecialistStatus(specialistName);
+  console.log(chalk27.bold(`
+Waking ${status.displayName}...
+`));
+  if (status.isRunning) {
+    console.log(chalk27.yellow(`Specialist is already running in tmux session: ${status.tmuxSession}`));
+    if (options.task) {
+      console.log(chalk27.dim("\nSending task message..."));
+      try {
+        const escapedTask = options.task.replace(/'/g, "'\\''");
+        execSync13(`tmux send-keys -t "${status.tmuxSession}" '${escapedTask}' C-m`, { encoding: "utf-8" });
+        console.log(chalk27.green("\u2713 Task message sent"));
+      } catch (error) {
+        console.log(chalk27.red(`Failed to send message: ${error.message}`));
+      }
+    } else {
+      console.log(chalk27.dim("Use --task to send a message to the running specialist"));
+    }
+    console.log("");
+    return;
+  }
+  if (!status.enabled) {
+    console.log(chalk27.yellow(`Warning: Specialist '${specialistName}' is disabled in registry`));
+    console.log(chalk27.dim("You can still wake it manually, but it won't auto-wake\n"));
+  }
+  const sessionId = getSessionId(specialistName);
+  const tmuxSession = getTmuxSessionName(specialistName);
+  const cwd = process.env.HOME || "/home/eltmon";
+  try {
+    let claudeCmd = "claude --dangerously-skip-permissions";
+    if (sessionId) {
+      claudeCmd += ` --resume ${sessionId}`;
+      console.log(chalk27.dim(`Resuming session: ${sessionId.substring(0, 8)}...`));
+    } else {
+      console.log(chalk27.dim("Starting fresh session (no previous session found)"));
+    }
+    console.log(chalk27.dim(`Creating tmux session: ${tmuxSession}`));
+    execSync13(
+      `tmux new-session -d -s "${tmuxSession}" -c "${cwd}" "${claudeCmd}"`,
+      { encoding: "utf-8" }
+    );
+    execSync13("sleep 2", { encoding: "utf-8" });
+    if (options.task) {
+      console.log(chalk27.dim("Sending task message..."));
+      const escapedTask = options.task.replace(/'/g, "'\\''");
+      execSync13(`tmux send-keys -t "${tmuxSession}" '${escapedTask}' C-m`, { encoding: "utf-8" });
+    }
+    recordWake(specialistName);
+    console.log(chalk27.green(`\u2713 Specialist ${specialistName} woken up successfully`));
+    console.log(chalk27.dim(`  Tmux session: ${tmuxSession}`));
+    console.log(chalk27.dim(`  Attach with: tmux attach -t ${tmuxSession}`));
+    console.log("");
+  } catch (error) {
+    console.log(chalk27.red(`
+Failed to wake specialist: ${error.message}
+`));
+    process.exit(1);
+  }
+}
+
+// src/cli/commands/specialists/queue.ts
+import chalk28 from "chalk";
+function queueCommand(name, options) {
+  const validNames = ["merge-agent", "review-agent", "test-agent"];
+  if (!validNames.includes(name)) {
+    console.log(chalk28.red(`
+Error: Unknown specialist '${name}'`));
+    console.log(`Valid specialists: ${validNames.join(", ")}
+`);
+    process.exit(1);
+  }
+  const specialistName = name;
+  const metadata = getSpecialistMetadata(specialistName);
+  if (!metadata) {
+    console.log(chalk28.red(`
+Error: Specialist '${specialistName}' not found in registry
+`));
+    process.exit(1);
+  }
+  const queueStatus = checkSpecialistQueue(specialistName);
+  if (options.json) {
+    console.log(JSON.stringify(queueStatus, null, 2));
+    return;
+  }
+  console.log(chalk28.bold(`
+${metadata.displayName} Queue:
+`));
+  if (!queueStatus.hasWork) {
+    console.log(chalk28.dim("Queue is empty - no pending work"));
+    console.log("");
+    return;
+  }
+  console.log(`Total items: ${chalk28.bold(queueStatus.items.length.toString())}`);
+  if (queueStatus.urgentCount > 0) {
+    console.log(`Urgent items: ${chalk28.red.bold(queueStatus.urgentCount.toString())}`);
+  }
+  console.log("");
+  for (let i = 0; i < queueStatus.items.length; i++) {
+    const item = queueStatus.items[i];
+    const position = i + 1;
+    const priorityColor = getPriorityColor(item.priority);
+    console.log(`${position}. ${priorityColor(item.priority.toUpperCase())}`);
+    console.log(`   ID: ${chalk28.dim(item.id)}`);
+    console.log(`   Source: ${chalk28.dim(item.source)}`);
+    if (item.payload) {
+      const payload = item.payload;
+      if (payload.issueId) {
+        console.log(`   Issue: ${chalk28.cyan(payload.issueId)}`);
+      }
+      if (payload.prUrl) {
+        console.log(`   PR: ${chalk28.dim(payload.prUrl)}`);
+      }
+      if (payload.workspace) {
+        console.log(`   Workspace: ${chalk28.dim(payload.workspace)}`);
+      }
+      if (payload.branch) {
+        console.log(`   Branch: ${chalk28.dim(payload.branch)}`);
+      }
+      if (payload.filesChanged && Array.isArray(payload.filesChanged)) {
+        const fileCount = payload.filesChanged.length;
+        console.log(`   Files: ${chalk28.dim(fileCount + " changed")}`);
+      }
+    }
+    const createdAt = new Date(item.createdAt);
+    const age = getAge(createdAt);
+    console.log(`   Age: ${chalk28.dim(age)}`);
+    console.log("");
+  }
+}
+function getPriorityColor(priority) {
+  switch (priority.toLowerCase()) {
+    case "urgent":
+      return chalk28.red.bold;
+    case "high":
+      return chalk28.yellow;
+    case "normal":
+      return chalk28.white;
+    case "low":
+      return chalk28.dim;
+    default:
+      return chalk28.white;
+  }
+}
+function getAge(date) {
+  const now = /* @__PURE__ */ new Date();
+  const diff = now.getTime() - date.getTime();
+  const seconds = Math.floor(diff / 1e3);
+  const minutes = Math.floor(seconds / 60);
+  const hours = Math.floor(minutes / 60);
+  const days = Math.floor(hours / 24);
+  if (days > 0) return `${days}d ago`;
+  if (hours > 0) return `${hours}h ago`;
+  if (minutes > 0) return `${minutes}m ago`;
+  return "just now";
+}
+
+// src/cli/commands/specialists/reset.ts
+import chalk29 from "chalk";
+import { execSync as execSync14 } from "child_process";
+import * as readline from "readline";
+async function resetCommand(name, options) {
+  const validNames = ["merge-agent", "review-agent", "test-agent"];
+  if (!validNames.includes(name)) {
+    console.log(chalk29.red(`
+Error: Unknown specialist '${name}'`));
+    console.log(`Valid specialists: ${validNames.join(", ")}
+`);
+    process.exit(1);
+  }
+  const specialistName = name;
+  const status = getSpecialistStatus(specialistName);
+  console.log(chalk29.bold(`
+Resetting ${status.displayName}...
+`));
+  console.log(chalk29.dim("Current state:"));
+  console.log(`  Status: ${status.state}`);
+  if (status.isRunning) {
+    console.log(`  Running: ${chalk29.yellow("yes")} (tmux: ${status.tmuxSession})`);
+  }
+  if (status.sessionId) {
+    console.log(`  Session: ${status.sessionId.substring(0, 8)}...`);
+  }
+  if (status.contextTokens) {
+    console.log(`  Context: ${status.contextTokens.toLocaleString()} tokens`);
+  }
+  console.log("");
+  if (!options.force) {
+    const confirmed = await confirm(
+      "This will clear the session and all context. Continue?"
+    );
+    if (!confirmed) {
+      console.log(chalk29.dim("Reset cancelled\n"));
+      return;
+    }
+  }
+  if (status.isRunning) {
+    console.log(chalk29.dim("Stopping tmux session..."));
+    try {
+      execSync14(`tmux kill-session -t "${status.tmuxSession}"`, { encoding: "utf-8", stdio: "ignore" });
+      console.log(chalk29.green("\u2713 Tmux session stopped"));
+    } catch (error) {
+      console.log(chalk29.yellow("\u26A0 Failed to stop tmux session (may not be running)"));
+    }
+  }
+  console.log(chalk29.dim("Clearing session file..."));
+  const cleared = clearSessionId(specialistName);
+  if (cleared) {
+    console.log(chalk29.green("\u2713 Session file cleared"));
+  } else {
+    console.log(chalk29.dim("No session file to clear"));
+  }
+  console.log(chalk29.green(`
+\u2713 Specialist ${specialistName} has been reset`));
+  console.log(chalk29.dim("Next wake will start a fresh session\n"));
+}
+function confirm(question) {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  return new Promise((resolve2) => {
+    rl.question(chalk29.yellow(`${question} [y/N] `), (answer) => {
+      rl.close();
+      resolve2(answer.toLowerCase() === "y" || answer.toLowerCase() === "yes");
+    });
+  });
+}
+
+// src/cli/commands/specialists/index.ts
+function registerSpecialistsCommands(program2) {
+  const specialists = program2.command("specialists").description("Manage specialist agents (review-agent, test-agent, merge-agent)");
+  specialists.command("list").description("Show all specialists with their status").option("--json", "Output in JSON format").action(listCommand3);
+  specialists.command("wake <name>").description("Wake up a specialist agent (for testing/debugging)").option("--task <description>", "Optional task description to wake with").action(wakeCommand);
+  specialists.command("queue <name>").description("Show pending work in a specialist's queue").option("--json", "Output in JSON format").action(queueCommand);
+  specialists.command("reset <name>").description("Reset a specialist (clear session, start fresh)").option("--force", "Skip confirmation prompt").action(resetCommand);
+}
+
+// src/cli/commands/project.ts
+import chalk30 from "chalk";
 import { existsSync as existsSync28, readFileSync as readFileSync22 } from "fs";
 import { join as join28, resolve } from "path";
 async function projectAddCommand(projectPath, options = {}) {
   const fullPath = resolve(projectPath);
   if (!existsSync28(fullPath)) {
-    console.log(chalk26.red(`Path does not exist: ${fullPath}`));
+    console.log(chalk30.red(`Path does not exist: ${fullPath}`));
     return;
   }
   const name = options.name || fullPath.split("/").pop() || "unknown";
   const key = name.toLowerCase().replace(/[^a-z0-9-]/g, "-");
   const existing = getProject(key);
   if (existing) {
-    console.log(chalk26.yellow(`Project already registered with key: ${key}`));
-    console.log(chalk26.dim(`Existing path: ${existing.path}`));
-    console.log(chalk26.dim(`To update, first run: pan project remove ${key}`));
+    console.log(chalk30.yellow(`Project already registered with key: ${key}`));
+    console.log(chalk30.dim(`Existing path: ${existing.path}`));
+    console.log(chalk30.dim(`To update, first run: pan project remove ${key}`));
     return;
   }
   let linearTeam = options.linearTeam;
@@ -6447,21 +6857,21 @@ async function projectAddCommand(projectPath, options = {}) {
     projectConfig.linear_team = linearTeam.toUpperCase();
   }
   registerProject(key, projectConfig);
-  console.log(chalk26.green(`\u2713 Added project: ${name}`));
-  console.log(chalk26.dim(`  Key: ${key}`));
-  console.log(chalk26.dim(`  Path: ${fullPath}`));
+  console.log(chalk30.green(`\u2713 Added project: ${name}`));
+  console.log(chalk30.dim(`  Key: ${key}`));
+  console.log(chalk30.dim(`  Path: ${fullPath}`));
   if (linearTeam) {
-    console.log(chalk26.dim(`  Linear team: ${linearTeam}`));
+    console.log(chalk30.dim(`  Linear team: ${linearTeam}`));
   }
   console.log("");
-  console.log(chalk26.dim(`Edit ${PROJECTS_CONFIG_FILE} to add issue routing rules.`));
+  console.log(chalk30.dim(`Edit ${PROJECTS_CONFIG_FILE} to add issue routing rules.`));
 }
 async function projectListCommand(options = {}) {
   const projects = listProjects();
   if (projects.length === 0) {
-    console.log(chalk26.dim("No projects registered."));
-    console.log(chalk26.dim("Add one with: pan project add <path> --linear-team <TEAM>"));
-    console.log(chalk26.dim(`Or edit: ${PROJECTS_CONFIG_FILE}`));
+    console.log(chalk30.dim("No projects registered."));
+    console.log(chalk30.dim("Add one with: pan project add <path> --linear-team <TEAM>"));
+    console.log(chalk30.dim(`Or edit: ${PROJECTS_CONFIG_FILE}`));
     return;
   }
   if (options.json) {
@@ -6472,51 +6882,51 @@ async function projectListCommand(options = {}) {
     console.log(JSON.stringify(output, null, 2));
     return;
   }
-  console.log(chalk26.bold("\nRegistered Projects:\n"));
+  console.log(chalk30.bold("\nRegistered Projects:\n"));
   for (const { key, config } of projects) {
     const exists = existsSync28(config.path);
-    const statusIcon = exists ? chalk26.green("\u2713") : chalk26.red("\u2717");
-    console.log(`${statusIcon} ${chalk26.bold(config.name)} ${chalk26.dim(`(${key})`)}`);
-    console.log(`  ${chalk26.dim(config.path)}`);
+    const statusIcon = exists ? chalk30.green("\u2713") : chalk30.red("\u2717");
+    console.log(`${statusIcon} ${chalk30.bold(config.name)} ${chalk30.dim(`(${key})`)}`);
+    console.log(`  ${chalk30.dim(config.path)}`);
     if (config.linear_team) {
-      console.log(`  ${chalk26.cyan(`Linear: ${config.linear_team}`)}`);
+      console.log(`  ${chalk30.cyan(`Linear: ${config.linear_team}`)}`);
     }
     if (config.issue_routing && config.issue_routing.length > 0) {
-      console.log(`  ${chalk26.dim(`Routes: ${config.issue_routing.length} rules`)}`);
+      console.log(`  ${chalk30.dim(`Routes: ${config.issue_routing.length} rules`)}`);
     }
     console.log("");
   }
-  console.log(chalk26.dim(`Config: ${PROJECTS_CONFIG_FILE}`));
+  console.log(chalk30.dim(`Config: ${PROJECTS_CONFIG_FILE}`));
 }
 async function projectRemoveCommand(nameOrPath) {
   const projects = listProjects();
   if (unregisterProject(nameOrPath)) {
-    console.log(chalk26.green(`\u2713 Removed project: ${nameOrPath}`));
+    console.log(chalk30.green(`\u2713 Removed project: ${nameOrPath}`));
     return;
   }
   for (const { key, config } of projects) {
     if (config.name === nameOrPath || config.path === resolve(nameOrPath)) {
       unregisterProject(key);
-      console.log(chalk26.green(`\u2713 Removed project: ${config.name}`));
+      console.log(chalk30.green(`\u2713 Removed project: ${config.name}`));
       return;
     }
   }
-  console.log(chalk26.red(`Project not found: ${nameOrPath}`));
-  console.log(chalk26.dim(`Use 'pan project list' to see registered projects.`));
+  console.log(chalk30.red(`Project not found: ${nameOrPath}`));
+  console.log(chalk30.dim(`Use 'pan project list' to see registered projects.`));
 }
 async function projectInitCommand() {
   if (existsSync28(PROJECTS_CONFIG_FILE)) {
-    console.log(chalk26.yellow(`Config already exists: ${PROJECTS_CONFIG_FILE}`));
+    console.log(chalk30.yellow(`Config already exists: ${PROJECTS_CONFIG_FILE}`));
     return;
   }
   initializeProjectsConfig();
-  console.log(chalk26.green("\u2713 Projects config initialized"));
+  console.log(chalk30.green("\u2713 Projects config initialized"));
   console.log("");
-  console.log(chalk26.dim(`Edit ${PROJECTS_CONFIG_FILE} to add your projects.`));
+  console.log(chalk30.dim(`Edit ${PROJECTS_CONFIG_FILE} to add your projects.`));
   console.log("");
-  console.log(chalk26.bold("Quick start:"));
+  console.log(chalk30.bold("Quick start:"));
   console.log(
-    chalk26.dim(
+    chalk30.dim(
       '  pan project add /path/to/project --name "My Project" --linear-team MIN'
     )
   );
@@ -6535,13 +6945,13 @@ async function projectShowCommand(keyOrName) {
     }
   }
   if (!found) {
-    console.error(chalk26.red(`Project not found: ${keyOrName}`));
-    console.log(chalk26.dim(`Use 'pan project list' to see registered projects.`));
+    console.error(chalk30.red(`Project not found: ${keyOrName}`));
+    console.log(chalk30.dim(`Use 'pan project list' to see registered projects.`));
     process.exit(1);
   }
   const pathExists = existsSync28(found.path);
-  const pathStatus = pathExists ? chalk26.green("\u2713") : chalk26.red("\u2717");
-  console.log(chalk26.bold(`
+  const pathStatus = pathExists ? chalk30.green("\u2713") : chalk30.red("\u2717");
+  console.log(chalk30.bold(`
 Project: ${foundKey}
 `));
   console.log(`  Name:   ${found.name}`);
@@ -6550,7 +6960,7 @@ Project: ${foundKey}
     console.log(`  Team:   ${found.linear_team}`);
   }
   if (found.issue_routing && found.issue_routing.length > 0) {
-    console.log("\n  " + chalk26.bold("Routing Rules:"));
+    console.log("\n  " + chalk30.bold("Routing Rules:"));
     for (const rule of found.issue_routing) {
       if (rule.labels) {
         console.log(`    Labels: ${rule.labels.join(", ")}`);
@@ -6565,14 +6975,14 @@ Project: ${foundKey}
 }
 
 // src/cli/commands/doctor.ts
-import chalk27 from "chalk";
+import chalk31 from "chalk";
 import { existsSync as existsSync29, readdirSync as readdirSync15, readFileSync as readFileSync23 } from "fs";
-import { execSync as execSync13 } from "child_process";
+import { execSync as execSync15 } from "child_process";
 import { homedir as homedir9 } from "os";
 import { join as join29 } from "path";
 function checkCommand2(cmd) {
   try {
-    execSync13(`which ${cmd}`, { encoding: "utf-8", stdio: "pipe" });
+    execSync15(`which ${cmd}`, { encoding: "utf-8", stdio: "pipe" });
     return true;
   } catch {
     return false;
@@ -6590,8 +7000,8 @@ function countItems(path) {
   }
 }
 async function doctorCommand() {
-  console.log(chalk27.bold("\nPanopticon Doctor\n"));
-  console.log(chalk27.dim("Checking system health...\n"));
+  console.log(chalk31.bold("\nPanopticon Doctor\n"));
+  console.log(chalk31.dim("Checking system health...\n"));
   const checks = [];
   const requiredCommands = [
     { cmd: "git", name: "Git", fix: "Install git" },
@@ -6689,7 +7099,7 @@ async function doctorCommand() {
     });
   }
   try {
-    const sessions = execSync13("tmux list-sessions 2>/dev/null || true", { encoding: "utf-8" });
+    const sessions = execSync15("tmux list-sessions 2>/dev/null || true", { encoding: "utf-8" });
     const agentSessions = sessions.split("\n").filter((s) => s.includes("agent-")).length;
     checks.push({
       name: "Running Agents",
@@ -6704,37 +7114,37 @@ async function doctorCommand() {
     });
   }
   const icons = {
-    ok: chalk27.green("\u2713"),
-    warn: chalk27.yellow("\u26A0"),
-    error: chalk27.red("\u2717")
+    ok: chalk31.green("\u2713"),
+    warn: chalk31.yellow("\u26A0"),
+    error: chalk31.red("\u2717")
   };
   let hasErrors = false;
   let hasWarnings = false;
   for (const check of checks) {
     const icon = icons[check.status];
-    const message = check.status === "error" ? chalk27.red(check.message) : check.status === "warn" ? chalk27.yellow(check.message) : chalk27.dim(check.message);
+    const message = check.status === "error" ? chalk31.red(check.message) : check.status === "warn" ? chalk31.yellow(check.message) : chalk31.dim(check.message);
     console.log(`${icon} ${check.name}: ${message}`);
     if (check.fix && check.status !== "ok") {
-      console.log(chalk27.dim(`  Fix: ${check.fix}`));
+      console.log(chalk31.dim(`  Fix: ${check.fix}`));
     }
     if (check.status === "error") hasErrors = true;
     if (check.status === "warn") hasWarnings = true;
   }
   console.log("");
   if (hasErrors) {
-    console.log(chalk27.red("Some required components are missing."));
-    console.log(chalk27.dim("Fix the errors above before using Panopticon."));
+    console.log(chalk31.red("Some required components are missing."));
+    console.log(chalk31.dim("Fix the errors above before using Panopticon."));
   } else if (hasWarnings) {
-    console.log(chalk27.yellow("System is functional with some optional features missing."));
+    console.log(chalk31.yellow("System is functional with some optional features missing."));
   } else {
-    console.log(chalk27.green("All systems operational!"));
+    console.log(chalk31.green("All systems operational!"));
   }
   console.log("");
 }
 
 // src/cli/commands/update.ts
-import { execSync as execSync14 } from "child_process";
-import chalk28 from "chalk";
+import { execSync as execSync16 } from "child_process";
+import chalk32 from "chalk";
 import { readFileSync as readFileSync24 } from "fs";
 import { fileURLToPath as fileURLToPath2 } from "url";
 import { dirname as dirname5, join as join30 } from "path";
@@ -6751,7 +7161,7 @@ function getCurrentVersion() {
 }
 async function getLatestVersion() {
   try {
-    const result = execSync14("npm view panopticon-cli version", {
+    const result = execSync16("npm view panopticon-cli version", {
       encoding: "utf8",
       stdio: ["pipe", "pipe", "pipe"]
     });
@@ -6776,49 +7186,49 @@ function isNewer(latest, current) {
   return l.patch > c.patch;
 }
 async function updateCommand(options) {
-  console.log(chalk28.bold("Panopticon Update\n"));
+  console.log(chalk32.bold("Panopticon Update\n"));
   const currentVersion = getCurrentVersion();
-  console.log(`Current version: ${chalk28.cyan(currentVersion)}`);
+  console.log(`Current version: ${chalk32.cyan(currentVersion)}`);
   let latestVersion;
   try {
-    console.log(chalk28.dim("Checking npm for latest version..."));
+    console.log(chalk32.dim("Checking npm for latest version..."));
     latestVersion = await getLatestVersion();
-    console.log(`Latest version:  ${chalk28.cyan(latestVersion)}`);
+    console.log(`Latest version:  ${chalk32.cyan(latestVersion)}`);
   } catch (error) {
-    console.error(chalk28.red("Failed to check for updates"));
-    console.error(chalk28.dim("Make sure you have internet connectivity"));
+    console.error(chalk32.red("Failed to check for updates"));
+    console.error(chalk32.dim("Make sure you have internet connectivity"));
     process.exit(1);
   }
   const needsUpdate = isNewer(latestVersion, currentVersion);
   if (!needsUpdate) {
-    console.log(chalk28.green("\n\u2713 You are on the latest version"));
+    console.log(chalk32.green("\n\u2713 You are on the latest version"));
     return;
   }
   console.log(
-    chalk28.yellow(`
+    chalk32.yellow(`
 \u2191 Update available: ${currentVersion} \u2192 ${latestVersion}`)
   );
   if (options.check) {
-    console.log(chalk28.dim("\nRun `pan update` to install"));
+    console.log(chalk32.dim("\nRun `pan update` to install"));
     return;
   }
-  console.log(chalk28.dim("\nUpdating Panopticon..."));
+  console.log(chalk32.dim("\nUpdating Panopticon..."));
   try {
-    execSync14("npm install -g panopticon-cli@latest", {
+    execSync16("npm install -g panopticon-cli@latest", {
       stdio: "inherit"
     });
-    console.log(chalk28.green(`
+    console.log(chalk32.green(`
 \u2713 Updated to ${latestVersion}`));
     const config = loadConfig();
     if (config.sync.auto_sync) {
-      console.log(chalk28.dim("\nRunning auto-sync..."));
+      console.log(chalk32.dim("\nRunning auto-sync..."));
       await syncCommand({});
     }
-    console.log(chalk28.dim("\nRestart any running agents to use the new version."));
+    console.log(chalk32.dim("\nRestart any running agents to use the new version."));
   } catch (error) {
-    console.error(chalk28.red("\nUpdate failed"));
+    console.error(chalk32.red("\nUpdate failed"));
     console.error(
-      chalk28.dim("Try running with sudo: sudo npm install -g panopticon-cli@latest")
+      chalk32.dim("Try running with sudo: sudo npm install -g panopticon-cli@latest")
     );
     process.exit(1);
   }
@@ -6837,11 +7247,12 @@ program.command("skills").description("List and manage skills").option("--json",
 registerWorkCommands(program);
 registerWorkspaceCommands(program);
 registerCloisterCommands(program);
+registerSpecialistsCommands(program);
 registerSetupCommands(program);
 registerInstallCommand(program);
 program.command("status").description("Show running agents (shorthand for work status)").option("--json", "Output as JSON").action(statusCommand);
 program.command("up").description("Start dashboard (and Traefik if enabled)").option("--detach", "Run in background").option("--skip-traefik", "Skip Traefik startup").action(async (options) => {
-  const { spawn, execSync: execSync15 } = await import("child_process");
+  const { spawn, execSync: execSync17 } = await import("child_process");
   const { join: join31, dirname: dirname6 } = await import("path");
   const { fileURLToPath: fileURLToPath3 } = await import("url");
   const { readFileSync: readFileSync25, existsSync: existsSync30 } = await import("fs");
@@ -6858,76 +7269,95 @@ program.command("up").description("Start dashboard (and Traefik if enabled)").op
       traefikEnabled = config.traefik?.enabled === true;
       traefikDomain = config.traefik?.domain || "pan.localhost";
     } catch (error) {
-      console.log(chalk29.yellow("Warning: Could not read config.toml"));
+      console.log(chalk33.yellow("Warning: Could not read config.toml"));
     }
   }
-  console.log(chalk29.bold("Starting Panopticon...\n"));
+  console.log(chalk33.bold("Starting Panopticon...\n"));
   if (traefikEnabled && !options.skipTraefik) {
     const traefikDir = join31(process.env.HOME || "", ".panopticon", "traefik");
     if (existsSync30(traefikDir)) {
       try {
-        console.log(chalk29.dim("Starting Traefik..."));
-        execSync15("docker-compose up -d", {
+        console.log(chalk33.dim("Starting Traefik..."));
+        execSync17("docker-compose up -d", {
           cwd: traefikDir,
           stdio: "pipe"
         });
-        console.log(chalk29.green("\u2713 Traefik started"));
-        console.log(chalk29.dim(`  Dashboard: https://traefik.${traefikDomain}:8080
+        console.log(chalk33.green("\u2713 Traefik started"));
+        console.log(chalk33.dim(`  Dashboard: https://traefik.${traefikDomain}:8080
 `));
       } catch (error) {
-        console.log(chalk29.yellow("\u26A0 Failed to start Traefik (continuing anyway)"));
-        console.log(chalk29.dim("  Run with --skip-traefik to suppress this message\n"));
+        console.log(chalk33.yellow("\u26A0 Failed to start Traefik (continuing anyway)"));
+        console.log(chalk33.dim("  Run with --skip-traefik to suppress this message\n"));
       }
     }
   }
-  console.log(chalk29.dim("Starting dashboard..."));
+  try {
+    execSync17("npm --version", { stdio: "pipe" });
+  } catch {
+    console.error(chalk33.red("Error: npm not found in PATH"));
+    console.error(chalk33.dim("Make sure Node.js and npm are installed and in your PATH"));
+    process.exit(1);
+  }
+  console.log(chalk33.dim("Starting dashboard..."));
   if (options.detach) {
     const child = spawn("npm", ["run", "dev"], {
       cwd: dashboardDir,
       detached: true,
-      stdio: "ignore"
+      stdio: "ignore",
+      shell: true
     });
-    child.unref();
-    console.log(chalk29.green("\u2713 Dashboard started in background"));
+    let hasError = false;
+    child.on("error", (err) => {
+      hasError = true;
+      console.error(chalk33.red("Failed to start dashboard in background:"), err.message);
+      process.exit(1);
+    });
+    setTimeout(() => {
+      if (!hasError) {
+        child.unref();
+      }
+    }, 100);
+    console.log(chalk33.green("\u2713 Dashboard started in background"));
     if (traefikEnabled) {
-      console.log(`  Frontend: ${chalk29.cyan(`https://${traefikDomain}`)}`);
-      console.log(`  API:      ${chalk29.cyan(`https://${traefikDomain}/api`)}`);
+      console.log(`  Frontend: ${chalk33.cyan(`https://${traefikDomain}`)}`);
+      console.log(`  API:      ${chalk33.cyan(`https://${traefikDomain}/api`)}`);
     } else {
-      console.log(`  Frontend: ${chalk29.cyan("http://localhost:3001")}`);
-      console.log(`  API:      ${chalk29.cyan("http://localhost:3002")}`);
+      console.log(`  Frontend: ${chalk33.cyan("http://localhost:3001")}`);
+      console.log(`  API:      ${chalk33.cyan("http://localhost:3002")}`);
     }
   } else {
     if (traefikEnabled) {
-      console.log(`  Frontend: ${chalk29.cyan(`https://${traefikDomain}`)}`);
-      console.log(`  API:      ${chalk29.cyan(`https://${traefikDomain}/api`)}`);
+      console.log(`  Frontend: ${chalk33.cyan(`https://${traefikDomain}`)}`);
+      console.log(`  API:      ${chalk33.cyan(`https://${traefikDomain}/api`)}`);
     } else {
-      console.log(`  Frontend: ${chalk29.cyan("http://localhost:3001")}`);
-      console.log(`  API:      ${chalk29.cyan("http://localhost:3002")}`);
+      console.log(`  Frontend: ${chalk33.cyan("http://localhost:3001")}`);
+      console.log(`  API:      ${chalk33.cyan("http://localhost:3002")}`);
     }
-    console.log(chalk29.dim("\nPress Ctrl+C to stop\n"));
+    console.log(chalk33.dim("\nPress Ctrl+C to stop\n"));
     const child = spawn("npm", ["run", "dev"], {
       cwd: dashboardDir,
-      stdio: "inherit"
+      stdio: "inherit",
+      shell: true
     });
     child.on("error", (err) => {
-      console.error(chalk29.red("Failed to start dashboard:"), err.message);
+      console.error(chalk33.red("Failed to start dashboard:"), err.message);
       process.exit(1);
     });
   }
 });
 program.command("down").description("Stop dashboard (and Traefik if enabled)").option("--skip-traefik", "Skip Traefik shutdown").action(async (options) => {
-  const { execSync: execSync15 } = await import("child_process");
+  const { execSync: execSync17 } = await import("child_process");
   const { join: join31 } = await import("path");
   const { readFileSync: readFileSync25, existsSync: existsSync30 } = await import("fs");
   const { parse: parse2 } = await import("@iarna/toml");
-  console.log(chalk29.bold("Stopping Panopticon...\n"));
-  console.log(chalk29.dim("Stopping dashboard..."));
+  console.log(chalk33.bold("Stopping Panopticon...\n"));
+  console.log(chalk33.dim("Stopping dashboard..."));
   try {
-    execSync15("lsof -ti:3001 | xargs kill -9 2>/dev/null || true", { stdio: "pipe" });
-    execSync15("lsof -ti:3002 | xargs kill -9 2>/dev/null || true", { stdio: "pipe" });
-    console.log(chalk29.green("\u2713 Dashboard stopped"));
+    execSync17("lsof -ti:3001 | xargs kill -9 2>/dev/null || true", { stdio: "pipe" });
+    execSync17("lsof -ti:3002 | xargs kill -9 2>/dev/null || true", { stdio: "pipe" });
+    console.log(chalk33.green("\u2713 Dashboard stopped"));
   } catch {
-    console.log(chalk29.dim("  No dashboard processes found"));
+    console.log(chalk33.dim("  No dashboard processes found"));
   }
   const configFile = join31(process.env.HOME || "", ".panopticon", "config.toml");
   let traefikEnabled = false;
@@ -6942,15 +7372,15 @@ program.command("down").description("Stop dashboard (and Traefik if enabled)").o
   if (traefikEnabled && !options.skipTraefik) {
     const traefikDir = join31(process.env.HOME || "", ".panopticon", "traefik");
     if (existsSync30(traefikDir)) {
-      console.log(chalk29.dim("Stopping Traefik..."));
+      console.log(chalk33.dim("Stopping Traefik..."));
       try {
-        execSync15("docker-compose down", {
+        execSync17("docker-compose down", {
           cwd: traefikDir,
           stdio: "pipe"
         });
-        console.log(chalk29.green("\u2713 Traefik stopped"));
+        console.log(chalk33.green("\u2713 Traefik stopped"));
       } catch (error) {
-        console.log(chalk29.yellow("\u26A0 Failed to stop Traefik"));
+        console.log(chalk33.yellow("\u26A0 Failed to stop Traefik"));
       }
     }
   }