panopticon-cli 0.4.5 → 0.4.7

package/dist/specialist-context-SNCJ7O7G.js

@@ -0,0 +1,256 @@
+import {
+  getRecentRunLogs,
+  init_specialist_logs
+} from "./chunk-VTDDVLCK.js";
+import {
+  getModelId,
+  init_work_type_router
+} from "./chunk-PUR532O7.js";
+import {
+  getProject,
+  init_projects
+} from "./chunk-K45YD6A3.js";
+import {
+  PANOPTICON_HOME,
+  init_paths
+} from "./chunk-KGPRXDMX.js";
+import {
+  __esm,
+  __require,
+  init_esm_shims
+} from "./chunk-ZHC57RCV.js";
+
+// src/lib/cloister/specialist-context.ts
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { join } from "path";
+import { exec } from "child_process";
+import { promisify } from "util";
+function getContextDirectory(projectKey, specialistType) {
+  return join(SPECIALISTS_DIR, projectKey, specialistType, "context");
+}
+function getContextDigestPath(projectKey, specialistType) {
+  const contextDir = getContextDirectory(projectKey, specialistType);
+  return join(contextDir, "latest-digest.md");
+}
+function ensureContextDirectory(projectKey, specialistType) {
+  const contextDir = getContextDirectory(projectKey, specialistType);
+  if (!existsSync(contextDir)) {
+    mkdirSync(contextDir, { recursive: true });
+  }
+}
+function loadContextDigest(projectKey, specialistType) {
+  const digestPath = getContextDigestPath(projectKey, specialistType);
+  if (!existsSync(digestPath)) {
+    return null;
+  }
+  try {
+    return readFileSync(digestPath, "utf-8");
+  } catch (error) {
+    console.error(`[specialist-context] Failed to load digest for ${projectKey}/${specialistType}:`, error);
+    return null;
+  }
+}
+function getContextRunsCount(projectKey) {
+  const project = getProject(projectKey);
+  return project?.specialists?.context_runs ?? 5;
+}
+function getDigestModel(projectKey, specialistType) {
+  const project = getProject(projectKey);
+  if (project?.specialists?.digest_model) {
+    return project.specialists.digest_model;
+  }
+  try {
+    const workTypeId = `specialist-${specialistType}`;
+    return getModelId(workTypeId);
+  } catch (error) {
+    return "claude-sonnet-4-5";
+  }
+}
+async function generateContextDigest(projectKey, specialistType, options = {}) {
+  ensureContextDirectory(projectKey, specialistType);
+  const runCount = options.runCount ?? getContextRunsCount(projectKey);
+  const recentRuns = getRecentRunLogs(projectKey, specialistType, runCount);
+  if (recentRuns.length === 0 && !options.force) {
+    console.log(`[specialist-context] No recent runs for ${projectKey}/${specialistType}, skipping digest generation`);
+    return null;
+  }
+  const prompt = buildDigestPrompt(projectKey, specialistType, recentRuns);
+  const model = options.model ?? getDigestModel(projectKey, specialistType);
+  try {
+    console.log(`[specialist-context] Generating digest for ${projectKey}/${specialistType} using ${model}...`);
+    const tempDir = join(PANOPTICON_HOME, "tmp");
+    if (!existsSync(tempDir)) {
+      mkdirSync(tempDir, { recursive: true });
+    }
+    const promptFile = join(tempDir, `digest-prompt-${Date.now()}.md`);
+    writeFileSync(promptFile, prompt, "utf-8");
+    const { stdout, stderr } = await execAsync(
+      `claude --dangerously-skip-permissions --model ${model} "$(cat '${promptFile}')"`,
+      {
+        encoding: "utf-8",
+        maxBuffer: 10 * 1024 * 1024,
+        // 10MB buffer
+        timeout: 6e4
+        // 60 second timeout
+      }
+    );
+    try {
+      const { unlinkSync } = await import("fs");
+      unlinkSync(promptFile);
+    } catch {
+    }
+    if (stderr && !stderr.includes("warning")) {
+      console.error(`[specialist-context] Claude stderr:`, stderr);
+    }
+    const digest = stdout.trim();
+    if (!digest) {
+      console.error(`[specialist-context] Empty digest generated`);
+      return null;
+    }
+    const digestPath = getContextDigestPath(projectKey, specialistType);
+    writeFileSync(digestPath, digest, "utf-8");
+    console.log(`[specialist-context] Generated digest (${digest.length} chars)`);
+    return digest;
+  } catch (error) {
+    console.error(`[specialist-context] Failed to generate digest:`, error.message);
+    return null;
+  }
+}
+function buildDigestPrompt(projectKey, specialistType, recentRuns) {
+  const project = getProject(projectKey);
+  const projectName = project?.name || projectKey;
+  let prompt = `You are analyzing the recent history of a ${specialistType} specialist for the ${projectName} project.
+
+Your task is to generate a concise context digest that will be provided to the specialist at the start of their next run. This digest should help them understand:
+- Common patterns and practices observed in recent runs
+- Recurring issues or failure modes
+- Successful approaches and best practices
+- Any project-specific context that would be helpful
+
+Generate a digest in markdown format. Keep it focused and actionable - aim for 200-400 words total.
+
+## Recent Runs
+
+`;
+  if (recentRuns.length === 0) {
+    prompt += `No recent runs available yet. This is the specialist's first run.
+
+`;
+    prompt += `Generate a brief introduction for the specialist explaining their role and what to expect.
+`;
+  } else {
+    recentRuns.forEach((run, index) => {
+      prompt += `### Run ${index + 1}: ${run.metadata.issueId} (${run.metadata.status || "unknown"})
+`;
+      prompt += `Started: ${run.metadata.startedAt}
+`;
+      if (run.metadata.finishedAt) {
+        prompt += `Finished: ${run.metadata.finishedAt}
+`;
+      }
+      if (run.metadata.duration) {
+        const durationSec = Math.floor(run.metadata.duration / 1e3);
+        const minutes = Math.floor(durationSec / 60);
+        const seconds = durationSec % 60;
+        prompt += `Duration: ${minutes}m ${seconds}s
+`;
+      }
+      if (run.metadata.notes) {
+        prompt += `Notes: ${run.metadata.notes}
+`;
+      }
+      try {
+        const logContent = readFileSync(run.filePath, "utf-8");
+        const maxChars = 500;
+        const transcriptMatch = logContent.match(/## Session Transcript\n([\s\S]+?)(?=\n## |$)/);
+        if (transcriptMatch) {
+          let transcript = transcriptMatch[1].trim();
+          if (transcript.length > maxChars) {
+            transcript = transcript.substring(0, maxChars) + "... [truncated]";
+          }
+          prompt += `
+Transcript excerpt:
+${transcript}
+`;
+        }
+      } catch (error) {
+      }
+      prompt += `
+`;
+    });
+  }
+  prompt += `
+## Your Task
+
+Generate a context digest that summarizes the key insights from these runs. Format it as:
+
+# Recent ${specialistType} History for ${projectName}
+
+## Summary
+[2-3 sentence overview of patterns and trends]
+
+## Common Patterns
+[Bulleted list of observed patterns]
+
+## Recent Notable Runs
+[Brief highlights of 2-3 most interesting runs]
+
+## Recommendations
+[Specific guidance for the next run based on this history]
+
+Keep it concise, actionable, and focused on helping the specialist be more effective.`;
+  return prompt;
+}
+async function regenerateContextDigest(projectKey, specialistType) {
+  return generateContextDigest(projectKey, specialistType, { force: true });
+}
+function scheduleDigestGeneration(projectKey, specialistType) {
+  generateContextDigest(projectKey, specialistType).catch((error) => {
+    console.error(
+      `[specialist-context] Background digest generation failed for ${projectKey}/${specialistType}:`,
+      error
+    );
+  });
+}
+function hasContextDigest(projectKey, specialistType) {
+  const digestPath = getContextDigestPath(projectKey, specialistType);
+  return existsSync(digestPath);
+}
+function deleteContextDigest(projectKey, specialistType) {
+  const digestPath = getContextDigestPath(projectKey, specialistType);
+  if (!existsSync(digestPath)) {
+    return false;
+  }
+  try {
+    const { unlinkSync } = __require("fs");
+    unlinkSync(digestPath);
+    return true;
+  } catch (error) {
+    console.error(`[specialist-context] Failed to delete digest:`, error);
+    return false;
+  }
+}
+var execAsync, SPECIALISTS_DIR;
+var init_specialist_context = __esm({
+  "src/lib/cloister/specialist-context.ts"() {
+    init_esm_shims();
+    init_paths();
+    init_specialist_logs();
+    init_projects();
+    init_work_type_router();
+    execAsync = promisify(exec);
+    SPECIALISTS_DIR = join(PANOPTICON_HOME, "specialists");
+  }
+});
+init_specialist_context();
+export {
+  deleteContextDigest,
+  generateContextDigest,
+  getContextDigestPath,
+  getContextDirectory,
+  hasContextDigest,
+  loadContextDigest,
+  regenerateContextDigest,
+  scheduleDigestGeneration
+};
+//# sourceMappingURL=specialist-context-SNCJ7O7G.js.map

package/dist/specialist-context-SNCJ7O7G.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/cloister/specialist-context.ts"],"sourcesContent":["/**\n * Specialist Context Management\n *\n * Generates and manages AI-powered context digests from recent specialist runs.\n * These digests seed new specialist sessions with learned patterns and expertise.\n *\n * Directory structure:\n *   ~/.panopticon/specialists/{projectKey}/{specialistType}/context/latest-digest.md\n */\n\nimport { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';\nimport { join } from 'path';\nimport { exec } from 'child_process';\nimport { promisify } from 'util';\nimport { PANOPTICON_HOME } from '../paths.js';\nimport { getRecentRunLogs, type RunLogEntry } from './specialist-logs.js';\nimport { getProject } from '../projects.js';\nimport { getModelId } from '../work-type-router.js';\n\nconst execAsync = promisify(exec);\n\nconst SPECIALISTS_DIR = join(PANOPTICON_HOME, 'specialists');\n\n/**\n * Get the context directory for a project's specialist\n */\nexport function getContextDirectory(projectKey: string, specialistType: string): string {\n  return join(SPECIALISTS_DIR, projectKey, specialistType, 'context');\n}\n\n/**\n * Get the path to the latest context digest file\n */\nexport function getContextDigestPath(projectKey: string, specialistType: string): string {\n  const contextDir = getContextDirectory(projectKey, specialistType);\n  return join(contextDir, 'latest-digest.md');\n}\n\n/**\n * Ensure context directory exists for a project's specialist\n */\nfunction ensureContextDirectory(projectKey: string, specialistType: string): void {\n  const contextDir = getContextDirectory(projectKey, specialistType);\n  if (!existsSync(contextDir)) {\n    mkdirSync(contextDir, { recursive: true });\n  }\n}\n\n/**\n * Load the context digest for a specialist\n *\n * @param projectKey - Project identifier\n * @param specialistType - Specialist type\n * @returns Context digest content or null if not found\n */\nexport function loadContextDigest(projectKey: string, specialistType: string): string | null {\n  const digestPath = getContextDigestPath(projectKey, specialistType);\n\n  if (!existsSync(digestPath)) {\n    return null;\n  }\n\n  try {\n    return readFileSync(digestPath, 'utf-8');\n  } catch (error) {\n    console.error(`[specialist-context] Failed to load digest for ${projectKey}/${specialistType}:`, error);\n    return null;\n  }\n}\n\n/**\n * Get the number of recent runs to include in context\n *\n * Reads from project config or uses default.\n *\n * @param projectKey - Project identifier\n * @returns Number of runs to include (default: 5)\n */\nfunction getContextRunsCount(projectKey: string): number {\n  const project = getProject(projectKey);\n  return project?.specialists?.context_runs ?? 5;\n}\n\n/**\n * Get the model to use for digest generation\n *\n * Reads from project config or uses the same model as the specialist.\n *\n * @param projectKey - Project identifier\n * @param specialistType - Specialist type\n * @returns Model ID to use\n */\nfunction getDigestModel(projectKey: string, specialistType: string): string {\n  const project = getProject(projectKey);\n\n  // Check for explicit digest model in project config\n  if (project?.specialists?.digest_model) {\n    return project.specialists.digest_model;\n  }\n\n  // Fall back to specialist's model\n  try {\n    const workTypeId = `specialist-${specialistType}` as any;\n    return getModelId(workTypeId);\n  } catch (error) {\n    // Default to Sonnet if can't resolve\n    return 'claude-sonnet-4-5';\n  }\n}\n\n/**\n * Generate a context digest from recent runs using AI\n *\n * Creates an AI-generated summary of recent specialist runs to provide\n * context for the next run. This includes patterns, learnings, and common issues.\n *\n * @param projectKey - Project identifier\n * @param specialistType - Specialist type\n * @param options - Generation options\n * @returns Generated digest or null if generation failed\n */\nexport async function generateContextDigest(\n  projectKey: string,\n  specialistType: string,\n  options: {\n    runCount?: number;\n    model?: string;\n    force?: boolean; // Generate even if no recent runs\n  } = {}\n): Promise<string | null> {\n  ensureContextDirectory(projectKey, specialistType);\n\n  // Get recent runs\n  const runCount = options.runCount ?? getContextRunsCount(projectKey);\n  const recentRuns = getRecentRunLogs(projectKey, specialistType, runCount);\n\n  if (recentRuns.length === 0 && !options.force) {\n    console.log(`[specialist-context] No recent runs for ${projectKey}/${specialistType}, skipping digest generation`);\n    return null;\n  }\n\n  // Build prompt for digest generation\n  const prompt = buildDigestPrompt(projectKey, specialistType, recentRuns);\n  const model = options.model ?? getDigestModel(projectKey, specialistType);\n\n  try {\n    console.log(`[specialist-context] Generating digest for ${projectKey}/${specialistType} using ${model}...`);\n\n    // Use Claude Code CLI to generate digest\n    // Write prompt to temp file to avoid shell escaping issues\n    const tempDir = join(PANOPTICON_HOME, 'tmp');\n    if (!existsSync(tempDir)) {\n      mkdirSync(tempDir, { recursive: true });\n    }\n\n    const promptFile = join(tempDir, `digest-prompt-${Date.now()}.md`);\n    writeFileSync(promptFile, prompt, 'utf-8');\n\n    // Run Claude Code with the prompt\n    const { stdout, stderr } = await execAsync(\n      `claude --dangerously-skip-permissions --model ${model} \"$(cat '${promptFile}')\"`,\n      {\n        encoding: 'utf-8',\n        maxBuffer: 10 * 1024 * 1024, // 10MB buffer\n        timeout: 60000, // 60 second timeout\n      }\n    );\n\n    // Clean up temp file\n    try {\n      const { unlinkSync } = await import('fs');\n      unlinkSync(promptFile);\n    } catch {\n      // Ignore cleanup errors\n    }\n\n    if (stderr && !stderr.includes('warning')) {\n      console.error(`[specialist-context] Claude stderr:`, stderr);\n    }\n\n    const digest = stdout.trim();\n\n    if (!digest) {\n      console.error(`[specialist-context] Empty digest generated`);\n      return null;\n    }\n\n    // Save digest\n    const digestPath = getContextDigestPath(projectKey, specialistType);\n    writeFileSync(digestPath, digest, 'utf-8');\n\n    console.log(`[specialist-context] Generated digest (${digest.length} chars)`);\n    return digest;\n  } catch (error: any) {\n    console.error(`[specialist-context] Failed to generate digest:`, error.message);\n    // Degrade gracefully - return null so specialist can continue without context\n    return null;\n  }\n}\n\n/**\n * Build the prompt for digest generation\n *\n * @param projectKey - Project identifier\n * @param specialistType - Specialist type\n * @param recentRuns - Recent run logs\n * @returns Prompt for Claude\n */\nfunction buildDigestPrompt(\n  projectKey: string,\n  specialistType: string,\n  recentRuns: RunLogEntry[]\n): string {\n  const project = getProject(projectKey);\n  const projectName = project?.name || projectKey;\n\n  let prompt = `You are analyzing the recent history of a ${specialistType} specialist for the ${projectName} project.\n\nYour task is to generate a concise context digest that will be provided to the specialist at the start of their next run. This digest should help them understand:\n- Common patterns and practices observed in recent runs\n- Recurring issues or failure modes\n- Successful approaches and best practices\n- Any project-specific context that would be helpful\n\nGenerate a digest in markdown format. Keep it focused and actionable - aim for 200-400 words total.\n\n## Recent Runs\n\n`;\n\n  if (recentRuns.length === 0) {\n    prompt += `No recent runs available yet. This is the specialist's first run.\\n\\n`;\n    prompt += `Generate a brief introduction for the specialist explaining their role and what to expect.\\n`;\n  } else {\n    recentRuns.forEach((run, index) => {\n      prompt += `### Run ${index + 1}: ${run.metadata.issueId} (${run.metadata.status || 'unknown'})\\n`;\n      prompt += `Started: ${run.metadata.startedAt}\\n`;\n      if (run.metadata.finishedAt) {\n        prompt += `Finished: ${run.metadata.finishedAt}\\n`;\n      }\n      if (run.metadata.duration) {\n        const durationSec = Math.floor(run.metadata.duration / 1000);\n        const minutes = Math.floor(durationSec / 60);\n        const seconds = durationSec % 60;\n        prompt += `Duration: ${minutes}m ${seconds}s\\n`;\n      }\n      if (run.metadata.notes) {\n        prompt += `Notes: ${run.metadata.notes}\\n`;\n      }\n\n      // Include snippets from the log if available\n      try {\n        const logContent = readFileSync(run.filePath, 'utf-8');\n        // Extract key sections (limit to avoid overwhelming the prompt)\n        const maxChars = 500;\n        const transcriptMatch = logContent.match(/## Session Transcript\\n([\\s\\S]+?)(?=\\n## |$)/);\n        if (transcriptMatch) {\n          let transcript = transcriptMatch[1].trim();\n          if (transcript.length > maxChars) {\n            transcript = transcript.substring(0, maxChars) + '... [truncated]';\n          }\n          prompt += `\\nTranscript excerpt:\\n${transcript}\\n`;\n        }\n      } catch (error) {\n        // If we can't read the log, skip the excerpt\n      }\n\n      prompt += `\\n`;\n    });\n  }\n\n  prompt += `\\n## Your Task\n\nGenerate a context digest that summarizes the key insights from these runs. Format it as:\n\n# Recent ${specialistType} History for ${projectName}\n\n## Summary\n[2-3 sentence overview of patterns and trends]\n\n## Common Patterns\n[Bulleted list of observed patterns]\n\n## Recent Notable Runs\n[Brief highlights of 2-3 most interesting runs]\n\n## Recommendations\n[Specific guidance for the next run based on this history]\n\nKeep it concise, actionable, and focused on helping the specialist be more effective.`;\n\n  return prompt;\n}\n\n/**\n * Regenerate the context digest\n *\n * Forces regeneration even if a digest already exists.\n *\n * @param projectKey - Project identifier\n * @param specialistType - Specialist type\n * @returns Generated digest or null if generation failed\n */\nexport async function regenerateContextDigest(\n  projectKey: string,\n  specialistType: string\n): Promise<string | null> {\n  return generateContextDigest(projectKey, specialistType, { force: true });\n}\n\n/**\n * Generate digest after a run completes (async, fire-and-forget)\n *\n * This is called after a specialist finishes a run to update the context\n * for the next run. It runs asynchronously and failures are logged but not thrown.\n *\n * @param projectKey - Project identifier\n * @param specialistType - Specialist type\n */\nexport function scheduleDigestGeneration(projectKey: string, specialistType: string): void {\n  // Run async without awaiting\n  generateContextDigest(projectKey, specialistType).catch((error) => {\n    console.error(\n      `[specialist-context] Background digest generation failed for ${projectKey}/${specialistType}:`,\n      error\n    );\n  });\n}\n\n/**\n * Check if a context digest exists\n *\n * @param projectKey - Project identifier\n * @param specialistType - Specialist type\n * @returns True if digest file exists\n */\nexport function hasContextDigest(projectKey: string, specialistType: string): boolean {\n  const digestPath = getContextDigestPath(projectKey, specialistType);\n  return existsSync(digestPath);\n}\n\n/**\n * Delete the context digest\n *\n * Useful for forcing a fresh start or clearing stale context.\n *\n * @param projectKey - Project identifier\n * @param specialistType - Specialist type\n * @returns True if digest was deleted, false if it didn't exist\n */\nexport function deleteContextDigest(projectKey: string, specialistType: string): boolean {\n  const digestPath = getContextDigestPath(projectKey, specialistType);\n\n  if (!existsSync(digestPath)) {\n    return false;\n  }\n\n  try {\n    const { unlinkSync } = require('fs');\n    unlinkSync(digestPath);\n    return true;\n  } catch (error) {\n    console.error(`[specialist-context] Failed to delete digest:`, error);\n    return false;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/specialist-logs-A7ODEK2T.js

@@ -0,0 +1,43 @@
+import {
+  MAX_LOG_SIZE,
+  appendToRunLog,
+  checkLogSizeLimit,
+  cleanupAllLogs,
+  cleanupOldLogs,
+  createRunLog,
+  finalizeRunLog,
+  generateRunId,
+  getRecentRunLogs,
+  getRunLog,
+  getRunLogPath,
+  getRunLogSize,
+  getRunsDirectory,
+  init_specialist_logs,
+  isRunLogActive,
+  listRunLogs,
+  parseLogMetadata
+} from "./chunk-VTDDVLCK.js";
+import "./chunk-PUR532O7.js";
+import "./chunk-K45YD6A3.js";
+import "./chunk-KGPRXDMX.js";
+import "./chunk-ZHC57RCV.js";
+init_specialist_logs();
+export {
+  MAX_LOG_SIZE,
+  appendToRunLog,
+  checkLogSizeLimit,
+  cleanupAllLogs,
+  cleanupOldLogs,
+  createRunLog,
+  finalizeRunLog,
+  generateRunId,
+  getRecentRunLogs,
+  getRunLog,
+  getRunLogPath,
+  getRunLogSize,
+  getRunsDirectory,
+  isRunLogActive,
+  listRunLogs,
+  parseLogMetadata
+};
+//# sourceMappingURL=specialist-logs-A7ODEK2T.js.map

package/dist/specialist-logs-A7ODEK2T.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/specialists-C7XLNSXQ.js

@@ -0,0 +1,121 @@
+import {
+  checkSpecialistQueue,
+  clearSessionId,
+  completeSpecialistTask,
+  countContextTokens,
+  disableSpecialist,
+  enableSpecialist,
+  ensureProjectSpecialistDir,
+  exitGracePeriod,
+  findSessionFile,
+  getAllProjectSpecialistStatuses,
+  getAllSpecialistStatus,
+  getAllSpecialists,
+  getEnabledSpecialists,
+  getFeedbackStats,
+  getGracePeriodState,
+  getNextSpecialistTask,
+  getPendingFeedback,
+  getProjectSpecialistDir,
+  getProjectSpecialistMetadata,
+  getSessionFilePath,
+  getSessionId,
+  getSpecialistMetadata,
+  getSpecialistState,
+  getSpecialistStatus,
+  getTmuxSessionName,
+  incrementProjectRunCount,
+  initSpecialistsDirectory,
+  init_specialists,
+  initializeEnabledSpecialists,
+  initializeSpecialist,
+  isEnabled,
+  isInitialized,
+  isRunning,
+  listProjectsWithSpecialists,
+  listSessionFiles,
+  listSpecialistsForProject,
+  loadRegistry,
+  pauseGracePeriod,
+  recordWake,
+  resumeGracePeriod,
+  saveRegistry,
+  sendFeedbackToAgent,
+  setCurrentRun,
+  setSessionId,
+  signalSpecialistCompletion,
+  spawnEphemeralSpecialist,
+  startGracePeriod,
+  submitToSpecialistQueue,
+  terminateSpecialist,
+  updateContextTokens,
+  updateProjectSpecialistMetadata,
+  updateRunStatus,
+  updateSpecialistMetadata,
+  wakeSpecialist,
+  wakeSpecialistOrQueue,
+  wakeSpecialistWithTask
+} from "./chunk-VTDDVLCK.js";
+import "./chunk-PUR532O7.js";
+import "./chunk-K45YD6A3.js";
+import "./chunk-KGPRXDMX.js";
+import "./chunk-ZHC57RCV.js";
+init_specialists();
+export {
+  checkSpecialistQueue,
+  clearSessionId,
+  completeSpecialistTask,
+  countContextTokens,
+  disableSpecialist,
+  enableSpecialist,
+  ensureProjectSpecialistDir,
+  exitGracePeriod,
+  findSessionFile,
+  getAllProjectSpecialistStatuses,
+  getAllSpecialistStatus,
+  getAllSpecialists,
+  getEnabledSpecialists,
+  getFeedbackStats,
+  getGracePeriodState,
+  getNextSpecialistTask,
+  getPendingFeedback,
+  getProjectSpecialistDir,
+  getProjectSpecialistMetadata,
+  getSessionFilePath,
+  getSessionId,
+  getSpecialistMetadata,
+  getSpecialistState,
+  getSpecialistStatus,
+  getTmuxSessionName,
+  incrementProjectRunCount,
+  initSpecialistsDirectory,
+  initializeEnabledSpecialists,
+  initializeSpecialist,
+  isEnabled,
+  isInitialized,
+  isRunning,
+  listProjectsWithSpecialists,
+  listSessionFiles,
+  listSpecialistsForProject,
+  loadRegistry,
+  pauseGracePeriod,
+  recordWake,
+  resumeGracePeriod,
+  saveRegistry,
+  sendFeedbackToAgent,
+  setCurrentRun,
+  setSessionId,
+  signalSpecialistCompletion,
+  spawnEphemeralSpecialist,
+  startGracePeriod,
+  submitToSpecialistQueue,
+  terminateSpecialist,
+  updateContextTokens,
+  updateProjectSpecialistMetadata,
+  updateRunStatus,
+  updateSpecialistMetadata,
+  wakeSpecialist,
+  wakeSpecialistOrQueue,
+  wakeSpecialistWithTask
+};
+//# sourceMappingURL=specialists-C7XLNSXQ.js.map

package/dist/specialists-C7XLNSXQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/traefik-WI3KSRGG.js

@@ -0,0 +1,12 @@
+import {
+  cleanupTemplateFiles,
+  generatePanopticonTraefikConfig
+} from "./chunk-F7NQZD6H.js";
+import "./chunk-NYVQC3D7.js";
+import "./chunk-KGPRXDMX.js";
+import "./chunk-ZHC57RCV.js";
+export {
+  cleanupTemplateFiles,
+  generatePanopticonTraefikConfig
+};
+//# sourceMappingURL=traefik-WI3KSRGG.js.map

package/dist/traefik-WI3KSRGG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "panopticon-cli",
-  "version": "0.4.5",
+  "version": "0.4.7",
   "description": "Multi-agent orchestration for AI coding assistants (Claude Code, Codex, Cursor, Gemini CLI)",
   "keywords": [
     "ai-agents",
@@ -38,6 +38,7 @@
   "files": [
     "dist",
     "templates",
+    "skills",
     "scripts/git-hooks",
     "README.md",
     "LICENSE"

package/skills/beads/README.md

@@ -0,0 +1,120 @@
+# Beads Skill for Claude Code
+
+A comprehensive skill for using [beads](https://github.com/steveyegge/beads) (bd) issue tracking with Claude Code.
+
+## What This Skill Does
+
+This skill teaches Claude Code how to use bd effectively for:
+- **Multi-session work tracking** - Persistent memory across conversation compactions
+- **Dependency management** - Graph-based issue relationships
+- **Session handoff** - Writing notes that survive context resets
+- **Molecules and wisps** (v0.34.0+) - Reusable work templates and ephemeral workflows
+
+## Installation
+
+Copy the `beads/` directory to your Claude Code skills location:
+
+```bash
+# Global installation
+cp -r beads ~/.claude/skills/
+
+# Or project-local
+cp -r beads .claude/skills/
+```
+
+## When Claude Uses This Skill
+
+The skill activates when conversations involve:
+- "multi-session", "complex dependencies", "resume after weeks"
+- "project memory", "persistent context", "side quest tracking"
+- Work that spans multiple days or compaction cycles
+- Tasks too complex for simple TodoWrite lists
+
+## File Structure
+
+```
+beads/
+├── SKILL.md                 # Main skill file (Claude reads this first)
+├── CLAUDE.md                # Maintenance guide for updating the skill
+├── README.md                # This file (for humans)
+├── adr/                     # Architectural Decision Records
+│   └── 0001-bd-prime-as-source-of-truth.md
+└── resources/               # Detailed documentation (loaded on demand)
+    ├── BOUNDARIES.md        # When to use bd vs TodoWrite
+    ├── CLI_REFERENCE.md     # CLI command reference
+    ├── DEPENDENCIES.md      # Dependency semantics (A blocks B vs B blocks A)
+    ├── INTEGRATION_PATTERNS.md # TodoWrite and other tool integration
+    ├── ISSUE_CREATION.md    # When and how to create issues
+    ├── MOLECULES.md         # Protos, mols, wisps (v0.34.0+)
+    ├── PATTERNS.md          # Common usage patterns
+    ├── RESUMABILITY.md      # Writing notes for post-compaction recovery
+    ├── STATIC_DATA.md       # Using bd for reference databases
+    ├── TROUBLESHOOTING.md   # Common issues and fixes
+    ├── WORKFLOWS.md         # Step-by-step workflow guides
+    ├── AGENTS.md            # Agent bead tracking (v0.40+)
+    ├── ASYNC_GATES.md       # Human-in-the-loop gates
+    ├── CHEMISTRY_PATTERNS.md # Mol vs Wisp decision tree
+    └── WORKTREES.md         # Parallel development patterns
+```
+
+## Key Concepts
+
+### bd vs TodoWrite
+
+| Use bd when... | Use TodoWrite when... |
+|----------------|----------------------|
+| Work spans multiple sessions | Single-session tasks |
+| Complex dependencies exist | Linear step-by-step work |
+| Need to resume after weeks | Just need a quick checklist |
+| Knowledge work with fuzzy boundaries | Clear, immediate tasks |
+
+### The Dependency Direction Trap
+
+`bd dep add A B` means **"A depends on B"** (B must complete before A can start).
+
+```bash
+# Want: "Setup must complete before Implementation"
+bd dep add implementation setup  # ✓ CORRECT
+# NOT: bd dep add setup implementation  # ✗ WRONG
+```
+
+### Surviving Compaction
+
+When Claude's context gets compacted, conversation history is lost but bd state survives. Write notes as if explaining to a future Claude with zero context:
+
+```bash
+bd update issue-123 --notes "COMPLETED: JWT auth with RS256
+KEY DECISION: RS256 over HS256 for key rotation
+IN PROGRESS: Password reset flow
+NEXT: Implement rate limiting"
+```
+
+## Requirements
+
+- [bd CLI](https://github.com/steveyegge/beads) installed (`brew install steveyegge/beads/bd`)
+- A git repository (bd requires git for sync)
+- Initialized database (`bd init` in project root)
+
+## Version Compatibility
+
+| Version | Features |
+|---------|----------|
+| v0.43.0+ | Full support: agents, gates, worktrees, chemistry patterns |
+| v0.40.0+ | Agent beads, async gates, worktree management |
+| v0.34.0+ | Molecules, wisps, cross-project dependencies |
+| v0.15.0+ | Core: dependencies, notes, status tracking |
+| Earlier | Basic functionality, some features missing |
+
+## Contributing
+
+This skill is maintained at [github.com/steveyegge/beads](https://github.com/steveyegge/beads) in the `skills/beads/` directory.
+
+Issues and PRs welcome for:
+- Documentation improvements
+- New workflow patterns
+- Bug fixes in examples
+- Additional troubleshooting scenarios
+
+## License
+
+MIT (same as beads)