panopticon-cli 0.4.7 → 0.4.9

package/dist/index.d.ts

@@ -295,6 +295,11 @@ interface PanopticonConfig {
 declare function loadConfig(): PanopticonConfig;
 declare function saveConfig(config: PanopticonConfig): void;
 declare function getDefaultConfig(): PanopticonConfig;
+/**
+ * Get the dashboard API base URL from config.
+ * Reads from DASHBOARD_URL env var first, then config file, then defaults.
+ */
+declare function getDashboardApiUrl(): string;
 
 type Shell = 'bash' | 'zsh' | 'fish' | 'unknown';
 declare function detectShell(): Shell;
@@ -702,4 +707,4 @@ declare function needsRouter(apiKeys: {
  */
 declare function getProviderEnv(provider: ProviderConfig, apiKey: string): Record<string, string>;
 
-export { AGENTS_DIR, type AnthropicModel, type ApiKeysConfig, BACKUPS_DIR, BIN_DIR, type BackupInfo, CERTS_DIR, CLAUDE_DIR, CLAUDE_MD_TEMPLATES, CODEX_DIR, COMMANDS_DIR, CONFIG_DIR, CONFIG_FILE, COSTS_DIR, CURSOR_DIR, type Comment, type ComplexityLevel, type ComplexityModels, GEMINI_DIR, type GitHubConfig, GitHubTracker, type GitLabConfig, GitLabTracker, type GoogleModel, HEARTBEATS_DIR, type HookItem, INIT_DIRS, type Issue, type IssueFilters, IssueNotFoundError, type IssueState, type IssueTracker, type IssueUpdate, type KimiModel, type LinearConfig, LinearTracker, type LinkDirection, LinkManager, type ModelId, type ModelsConfig, type NewIssue, NotImplementedError, OPENCODE_DIR, type OpenAIModel, PANOPTICON_HOME, PROVIDERS, type PanopticonConfig, type ProviderCompatibility, type ProviderConfig, type ProviderName, type RallyConfig, type RemoteConfig, type RemoteExeConfig, type Runtime, SETTINGS_FILE, SKILLS_DIR, SOURCE_DEV_SKILLS_DIR, SOURCE_SCRIPTS_DIR, SOURCE_SKILLS_DIR, SOURCE_TEMPLATES_DIR, SOURCE_TRAEFIK_TEMPLATES, SYNC_TARGETS, type SettingsConfig, type ShadowConfig, type Shell, type SpecialistModels, type SyncItem, type SyncOptions, type SyncPlan, type SyncResult, TEMPLATES_DIR, TRAEFIK_CERTS_DIR, TRAEFIK_DIR, TRAEFIK_DYNAMIC_DIR, TrackerAuthError, type TrackerConfig, type TrackerConfigItem, type TrackerLink, type TrackerType, type TrackersConfig, type ZAIModel, addAlias, cleanOldBackups, createBackup, createBackupTimestamp, createTracker, createTrackerFromConfig, detectShell, executeSync, formatIssueRef, getAgentCommand, getAliasInstructions, getAllTrackers, getAvailableModels, getClaudeModelFlag, getDefaultConfig, getDefaultSettings, getDirectProviders, getLinkManager, getPrimaryTracker, getProviderEnv, getProviderForModel, getRouterProviders, getSecondaryTracker, getShellRcFile, hasAlias, isAnthropicModel, isDevMode, isPanopticonSymlink, listBackups, loadConfig, loadSettings, needsRouter, parseIssueRef, planHooksSync, planSync, requiresRouter, restoreBackup, saveConfig, saveSettings, syncHooks, validateSettings };
+export { AGENTS_DIR, type AnthropicModel, type ApiKeysConfig, BACKUPS_DIR, BIN_DIR, type BackupInfo, CERTS_DIR, CLAUDE_DIR, CLAUDE_MD_TEMPLATES, CODEX_DIR, COMMANDS_DIR, CONFIG_DIR, CONFIG_FILE, COSTS_DIR, CURSOR_DIR, type Comment, type ComplexityLevel, type ComplexityModels, GEMINI_DIR, type GitHubConfig, GitHubTracker, type GitLabConfig, GitLabTracker, type GoogleModel, HEARTBEATS_DIR, type HookItem, INIT_DIRS, type Issue, type IssueFilters, IssueNotFoundError, type IssueState, type IssueTracker, type IssueUpdate, type KimiModel, type LinearConfig, LinearTracker, type LinkDirection, LinkManager, type ModelId, type ModelsConfig, type NewIssue, NotImplementedError, OPENCODE_DIR, type OpenAIModel, PANOPTICON_HOME, PROVIDERS, type PanopticonConfig, type ProviderCompatibility, type ProviderConfig, type ProviderName, type RallyConfig, type RemoteConfig, type RemoteExeConfig, type Runtime, SETTINGS_FILE, SKILLS_DIR, SOURCE_DEV_SKILLS_DIR, SOURCE_SCRIPTS_DIR, SOURCE_SKILLS_DIR, SOURCE_TEMPLATES_DIR, SOURCE_TRAEFIK_TEMPLATES, SYNC_TARGETS, type SettingsConfig, type ShadowConfig, type Shell, type SpecialistModels, type SyncItem, type SyncOptions, type SyncPlan, type SyncResult, TEMPLATES_DIR, TRAEFIK_CERTS_DIR, TRAEFIK_DIR, TRAEFIK_DYNAMIC_DIR, TrackerAuthError, type TrackerConfig, type TrackerConfigItem, type TrackerLink, type TrackerType, type TrackersConfig, type ZAIModel, addAlias, cleanOldBackups, createBackup, createBackupTimestamp, createTracker, createTrackerFromConfig, detectShell, executeSync, formatIssueRef, getAgentCommand, getAliasInstructions, getAllTrackers, getAvailableModels, getClaudeModelFlag, getDashboardApiUrl, getDefaultConfig, getDefaultSettings, getDirectProviders, getLinkManager, getPrimaryTracker, getProviderEnv, getProviderForModel, getRouterProviders, getSecondaryTracker, getShellRcFile, hasAlias, isAnthropicModel, isDevMode, isPanopticonSymlink, listBackups, loadConfig, loadSettings, needsRouter, parseIssueRef, planHooksSync, planSync, requiresRouter, restoreBackup, saveConfig, saveSettings, syncHooks, validateSettings };

package/dist/index.js

@@ -29,7 +29,7 @@ import {
   planSync,
   restoreBackup,
   syncHooks
-} from "./chunk-ZZ3477GY.js";
+} from "./chunk-NRPHRN6M.js";
 import {
   PROVIDERS,
   getAgentCommand,
@@ -49,11 +49,13 @@ import {
   saveSettings,
   validateSettings
 } from "./chunk-KQAEUOML.js";
+import "./chunk-BBCUK6N2.js";
 import {
+  getDashboardApiUrl,
   getDefaultConfig,
   loadConfig,
   saveConfig
-} from "./chunk-NYVQC3D7.js";
+} from "./chunk-ZAM2Q52Q.js";
 import {
   AGENTS_DIR,
   BACKUPS_DIR,
@@ -148,6 +150,7 @@ export {
   getAllTrackers,
   getAvailableModels,
   getClaudeModelFlag,
+  getDashboardApiUrl,
   getDefaultConfig,
   getDefaultSettings,
   getDirectProviders,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// Panopticon CLI - Main exports for library usage\nexport * from './lib/paths.js';\nexport * from './lib/config.js';\nexport * from './lib/shell.js';\nexport * from './lib/backup.js';\nexport * from './lib/sync.js';\nexport * from './lib/tracker/index.js';\nexport * from './lib/providers.js';\nexport * from './lib/settings.js';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AACA;AAMA;AACA;","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// Panopticon CLI - Main exports for library usage\nexport * from './lib/paths.js';\nexport * from './lib/config.js';\nexport * from './lib/shell.js';\nexport * from './lib/backup.js';\nexport * from './lib/sync.js';\nexport * from './lib/tracker/index.js';\nexport * from './lib/providers.js';\nexport * from './lib/settings.js';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AACA;AAMA;AACA;","names":[]}

package/dist/{remote-workspace-HI4VML6H.js → remote-workspace-WZVEDYQA.js}

@@ -1,6 +1,9 @@
 import {
   saveWorkspaceMetadata
 } from "./chunk-44EOY2ZL.js";
+import {
+  loadConfig
+} from "./chunk-ZAM2Q52Q.js";
 import {
   extractTeamPrefix,
   findProjectByTeam,
@@ -10,9 +13,6 @@ import {
   createExeProvider,
   init_exe_provider
 } from "./chunk-JM6V62LT.js";
-import {
-  loadConfig
-} from "./chunk-NYVQC3D7.js";
 import "./chunk-KGPRXDMX.js";
 import {
   init_esm_shims
@@ -176,4 +176,4 @@ EOF`);
 export {
   createRemoteWorkspace
 };
-//# sourceMappingURL=remote-workspace-HI4VML6H.js.map
+//# sourceMappingURL=remote-workspace-WZVEDYQA.js.map

package/dist/{specialist-context-SNCJ7O7G.js → specialist-context-JO4RB7UC.js}

@@ -1,11 +1,12 @@
 import {
   getRecentRunLogs,
   init_specialist_logs
-} from "./chunk-VTDDVLCK.js";
+} from "./chunk-45PZFXJM.js";
 import {
   getModelId,
   init_work_type_router
-} from "./chunk-PUR532O7.js";
+} from "./chunk-65DGYSS4.js";
+import "./chunk-BBCUK6N2.js";
 import {
   getProject,
   init_projects
@@ -253,4 +254,4 @@ export {
   regenerateContextDigest,
   scheduleDigestGeneration
 };
-//# sourceMappingURL=specialist-context-SNCJ7O7G.js.map
+//# sourceMappingURL=specialist-context-JO4RB7UC.js.map

package/dist/{specialist-context-SNCJ7O7G.js.map → specialist-context-JO4RB7UC.js.map}

@@ -1 +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":[]}
+{"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":";;;;;;;;;;;;;;;;;;;;;;;;AAUA,SAAS,YAAY,WAAW,cAAc,qBAAqB;AACnE,SAAS,YAAY;AACrB,SAAS,YAAY;AACrB,SAAS,iBAAiB;AAanB,SAAS,oBAAoB,YAAoB,gBAAgC;AACtF,SAAO,KAAK,iBAAiB,YAAY,gBAAgB,SAAS;AACpE;AAKO,SAAS,qBAAqB,YAAoB,gBAAgC;AACvF,QAAM,aAAa,oBAAoB,YAAY,cAAc;AACjE,SAAO,KAAK,YAAY,kBAAkB;AAC5C;AAKA,SAAS,uBAAuB,YAAoB,gBAA8B;AAChF,QAAM,aAAa,oBAAoB,YAAY,cAAc;AACjE,MAAI,CAAC,WAAW,UAAU,GAAG;AAC3B,cAAU,YAAY,EAAE,WAAW,KAAK,CAAC;AAAA,EAC3C;AACF;AASO,SAAS,kBAAkB,YAAoB,gBAAuC;AAC3F,QAAM,aAAa,qBAAqB,YAAY,cAAc;AAElE,MAAI,CAAC,WAAW,UAAU,GAAG;AAC3B,WAAO;AAAA,EACT;AAEA,MAAI;AACF,WAAO,aAAa,YAAY,OAAO;AAAA,EACzC,SAAS,OAAO;AACd,YAAQ,MAAM,kDAAkD,UAAU,IAAI,cAAc,KAAK,KAAK;AACtG,WAAO;AAAA,EACT;AACF;AAUA,SAAS,oBAAoB,YAA4B;AACvD,QAAM,UAAU,WAAW,UAAU;AACrC,SAAO,SAAS,aAAa,gBAAgB;AAC/C;AAWA,SAAS,eAAe,YAAoB,gBAAgC;AAC1E,QAAM,UAAU,WAAW,UAAU;AAGrC,MAAI,SAAS,aAAa,cAAc;AACtC,WAAO,QAAQ,YAAY;AAAA,EAC7B;AAGA,MAAI;AACF,UAAM,aAAa,cAAc,cAAc;AAC/C,WAAO,WAAW,UAAU;AAAA,EAC9B,SAAS,OAAO;AAEd,WAAO;AAAA,EACT;AACF;AAaA,eAAsB,sBACpB,YACA,gBACA,UAII,CAAC,GACmB;AACxB,yBAAuB,YAAY,cAAc;AAGjD,QAAM,WAAW,QAAQ,YAAY,oBAAoB,UAAU;AACnE,QAAM,aAAa,iBAAiB,YAAY,gBAAgB,QAAQ;AAExE,MAAI,WAAW,WAAW,KAAK,CAAC,QAAQ,OAAO;AAC7C,YAAQ,IAAI,2CAA2C,UAAU,IAAI,cAAc,8BAA8B;AACjH,WAAO;AAAA,EACT;AAGA,QAAM,SAAS,kBAAkB,YAAY,gBAAgB,UAAU;AACvE,QAAM,QAAQ,QAAQ,SAAS,eAAe,YAAY,cAAc;AAExE,MAAI;AACF,YAAQ,IAAI,8CAA8C,UAAU,IAAI,cAAc,UAAU,KAAK,KAAK;AAI1G,UAAM,UAAU,KAAK,iBAAiB,KAAK;AAC3C,QAAI,CAAC,WAAW,OAAO,GAAG;AACxB,gBAAU,SAAS,EAAE,WAAW,KAAK,CAAC;AAAA,IACxC;AAEA,UAAM,aAAa,KAAK,SAAS,iBAAiB,KAAK,IAAI,CAAC,KAAK;AACjE,kBAAc,YAAY,QAAQ,OAAO;AAGzC,UAAM,EAAE,QAAQ,OAAO,IAAI,MAAM;AAAA,MAC/B,iDAAiD,KAAK,YAAY,UAAU;AAAA,MAC5E;AAAA,QACE,UAAU;AAAA,QACV,WAAW,KAAK,OAAO;AAAA;AAAA,QACvB,SAAS;AAAA;AAAA,MACX;AAAA,IACF;AAGA,QAAI;AACF,YAAM,EAAE,WAAW,IAAI,MAAM,OAAO,IAAI;AACxC,iBAAW,UAAU;AAAA,IACvB,QAAQ;AAAA,IAER;AAEA,QAAI,UAAU,CAAC,OAAO,SAAS,SAAS,GAAG;AACzC,cAAQ,MAAM,uCAAuC,MAAM;AAAA,IAC7D;AAEA,UAAM,SAAS,OAAO,KAAK;AAE3B,QAAI,CAAC,QAAQ;AACX,cAAQ,MAAM,6CAA6C;AAC3D,aAAO;AAAA,IACT;AAGA,UAAM,aAAa,qBAAqB,YAAY,cAAc;AAClE,kBAAc,YAAY,QAAQ,OAAO;AAEzC,YAAQ,IAAI,0CAA0C,OAAO,MAAM,SAAS;AAC5E,WAAO;AAAA,EACT,SAAS,OAAY;AACnB,YAAQ,MAAM,mDAAmD,MAAM,OAAO;AAE9E,WAAO;AAAA,EACT;AACF;AAUA,SAAS,kBACP,YACA,gBACA,YACQ;AACR,QAAM,UAAU,WAAW,UAAU;AACrC,QAAM,cAAc,SAAS,QAAQ;AAErC,MAAI,SAAS,6CAA6C,cAAc,uBAAuB,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAc1G,MAAI,WAAW,WAAW,GAAG;AAC3B,cAAU;AAAA;AAAA;AACV,cAAU;AAAA;AAAA,EACZ,OAAO;AACL,eAAW,QAAQ,CAAC,KAAK,UAAU;AACjC,gBAAU,WAAW,QAAQ,CAAC,KAAK,IAAI,SAAS,OAAO,KAAK,IAAI,SAAS,UAAU,SAAS;AAAA;AAC5F,gBAAU,YAAY,IAAI,SAAS,SAAS;AAAA;AAC5C,UAAI,IAAI,SAAS,YAAY;AAC3B,kBAAU,aAAa,IAAI,SAAS,UAAU;AAAA;AAAA,MAChD;AACA,UAAI,IAAI,SAAS,UAAU;AACzB,cAAM,cAAc,KAAK,MAAM,IAAI,SAAS,WAAW,GAAI;AAC3D,cAAM,UAAU,KAAK,MAAM,cAAc,EAAE;AAC3C,cAAM,UAAU,cAAc;AAC9B,kBAAU,aAAa,OAAO,KAAK,OAAO;AAAA;AAAA,MAC5C;AACA,UAAI,IAAI,SAAS,OAAO;AACtB,kBAAU,UAAU,IAAI,SAAS,KAAK;AAAA;AAAA,MACxC;AAGA,UAAI;AACF,cAAM,aAAa,aAAa,IAAI,UAAU,OAAO;AAErD,cAAM,WAAW;AACjB,cAAM,kBAAkB,WAAW,MAAM,8CAA8C;AACvF,YAAI,iBAAiB;AACnB,cAAI,aAAa,gBAAgB,CAAC,EAAE,KAAK;AACzC,cAAI,WAAW,SAAS,UAAU;AAChC,yBAAa,WAAW,UAAU,GAAG,QAAQ,IAAI;AAAA,UACnD;AACA,oBAAU;AAAA;AAAA,EAA0B,UAAU;AAAA;AAAA,QAChD;AAAA,MACF,SAAS,OAAO;AAAA,MAEhB;AAEA,gBAAU;AAAA;AAAA,IACZ,CAAC;AAAA,EACH;AAEA,YAAU;AAAA;AAAA;AAAA;AAAA;AAAA,WAID,cAAc,gBAAgB,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAgBlD,SAAO;AACT;AAWA,eAAsB,wBACpB,YACA,gBACwB;AACxB,SAAO,sBAAsB,YAAY,gBAAgB,EAAE,OAAO,KAAK,CAAC;AAC1E;AAWO,SAAS,yBAAyB,YAAoB,gBAA8B;AAEzF,wBAAsB,YAAY,cAAc,EAAE,MAAM,CAAC,UAAU;AACjE,YAAQ;AAAA,MACN,gEAAgE,UAAU,IAAI,cAAc;AAAA,MAC5F;AAAA,IACF;AAAA,EACF,CAAC;AACH;AASO,SAAS,iBAAiB,YAAoB,gBAAiC;AACpF,QAAM,aAAa,qBAAqB,YAAY,cAAc;AAClE,SAAO,WAAW,UAAU;AAC9B;AAWO,SAAS,oBAAoB,YAAoB,gBAAiC;AACvF,QAAM,aAAa,qBAAqB,YAAY,cAAc;AAElE,MAAI,CAAC,WAAW,UAAU,GAAG;AAC3B,WAAO;AAAA,EACT;AAEA,MAAI;AACF,UAAM,EAAE,WAAW,IAAI,UAAQ,IAAI;AACnC,eAAW,UAAU;AACrB,WAAO;AAAA,EACT,SAAS,OAAO;AACd,YAAQ,MAAM,iDAAiD,KAAK;AACpE,WAAO;AAAA,EACT;AACF;AA7WA,IAmBM,WAEA;AArBN;AAAA;AAAA;AAcA;AACA;AACA;AACA;AAEA,IAAM,YAAY,UAAU,IAAI;AAEhC,IAAM,kBAAkB,KAAK,iBAAiB,aAAa;AAAA;AAAA;","names":[]}

package/dist/{specialist-logs-A7ODEK2T.js → specialist-logs-7P5EUIUT.js}

@@ -16,8 +16,9 @@ import {
   isRunLogActive,
   listRunLogs,
   parseLogMetadata
-} from "./chunk-VTDDVLCK.js";
-import "./chunk-PUR532O7.js";
+} from "./chunk-45PZFXJM.js";
+import "./chunk-65DGYSS4.js";
+import "./chunk-BBCUK6N2.js";
 import "./chunk-K45YD6A3.js";
 import "./chunk-KGPRXDMX.js";
 import "./chunk-ZHC57RCV.js";
@@ -40,4 +41,4 @@ export {
   listRunLogs,
   parseLogMetadata
 };
-//# sourceMappingURL=specialist-logs-A7ODEK2T.js.map
+//# sourceMappingURL=specialist-logs-7P5EUIUT.js.map

package/dist/{specialists-C7XLNSXQ.js → specialists-B4QAT244.js}

@@ -55,8 +55,9 @@ import {
   wakeSpecialist,
   wakeSpecialistOrQueue,
   wakeSpecialistWithTask
-} from "./chunk-VTDDVLCK.js";
-import "./chunk-PUR532O7.js";
+} from "./chunk-45PZFXJM.js";
+import "./chunk-65DGYSS4.js";
+import "./chunk-BBCUK6N2.js";
 import "./chunk-K45YD6A3.js";
 import "./chunk-KGPRXDMX.js";
 import "./chunk-ZHC57RCV.js";
@@ -118,4 +119,4 @@ export {
   wakeSpecialistOrQueue,
   wakeSpecialistWithTask
 };
-//# sourceMappingURL=specialists-C7XLNSXQ.js.map
+//# sourceMappingURL=specialists-B4QAT244.js.map

package/dist/{traefik-WI3KSRGG.js → traefik-DRNZMPGZ.js}

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

package/dist/traefik-DRNZMPGZ.js.map

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

package/package.json

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

package/scripts/heartbeat-hook

@@ -0,0 +1,149 @@
+#!/bin/bash
+# ~/.panopticon/bin/heartbeat-hook
+# Called by Claude Code after every tool use with JSON on stdin
+#
+# This hook receives PostToolUse event data from Claude Code and writes
+# rich heartbeat information to enable real-time agent monitoring.
+
+# Don't use set -e - we want the hook to be resilient to failures
+# and never break Claude Code execution
+
+# Parse tool info from stdin
+TOOL_INFO=$(cat 2>/dev/null || echo '{}')
+
+# Check if jq is available
+if ! command -v jq &> /dev/null; then
+  echo "Warning: jq not found. Heartbeat hook requires jq to parse tool data." >&2
+  exit 0  # Silent failure - don't break Claude Code execution
+fi
+
+# Extract tool name and input (truncate input to 100 chars to avoid huge files)
+TOOL_NAME=$(echo "$TOOL_INFO" | jq -r '.tool_name // "unknown"' 2>/dev/null || echo "unknown")
+TOOL_INPUT=$(echo "$TOOL_INFO" | jq -r '.tool_input | tostring | .[0:100] // ""' 2>/dev/null || echo "")
+
+# Get agent ID from env (set by pan work issue) or tmux session name
+# Only use tmux session name if we're actually INSIDE a tmux session ($TMUX is set)
+if [ -n "$PANOPTICON_AGENT_ID" ]; then
+  AGENT_ID="$PANOPTICON_AGENT_ID"
+elif [ -n "$TMUX" ]; then
+  AGENT_ID=$(tmux display-message -p '#S' 2>/dev/null)
+else
+  AGENT_ID="main-cli"
+fi
+AGENT_ID="${AGENT_ID:-unknown}"
+
+# Get current beads task from cache (if exists)
+TASK_CACHE="$HOME/.panopticon/agents/$AGENT_ID/current-task.json"
+CURRENT_TASK=""
+if [ -f "$TASK_CACHE" ]; then
+  CURRENT_TASK=$(jq -r '.title // ""' "$TASK_CACHE" 2>/dev/null || echo "")
+fi
+
+# Get git branch (fast, single command) - suppress all errors
+GIT_BRANCH=$(git branch --show-current 2>/dev/null || true)
+GIT_BRANCH="${GIT_BRANCH:-unknown}"
+
+# Get workspace from pwd
+WORKSPACE=$(pwd)
+
+# Ensure heartbeat directory exists
+HEARTBEAT_DIR="$HOME/.panopticon/heartbeats"
+mkdir -p "$HEARTBEAT_DIR"
+
+# Ensure agent state directory exists for activity log
+AGENT_DIR="$HOME/.panopticon/agents/$AGENT_ID"
+mkdir -p "$AGENT_DIR"
+
+# Write heartbeat atomically (write to temp file, then move)
+# Use jq to properly escape all strings in the JSON output
+TEMP_FILE="$HEARTBEAT_DIR/$AGENT_ID.json.tmp"
+jq -n \
+  --arg timestamp "$(date -Iseconds)" \
+  --arg agent_id "$AGENT_ID" \
+  --arg tool_name "$TOOL_NAME" \
+  --arg last_action "$TOOL_INPUT" \
+  --arg current_task "$CURRENT_TASK" \
+  --arg git_branch "$GIT_BRANCH" \
+  --arg workspace "$WORKSPACE" \
+  --argjson pid $$ \
+  '{
+    timestamp: $timestamp,
+    agent_id: $agent_id,
+    tool_name: $tool_name,
+    last_action: $last_action,
+    current_task: $current_task,
+    git_branch: $git_branch,
+    workspace: $workspace,
+    pid: $pid
+  }' > "$TEMP_FILE" 2>/dev/null || true
+
+# Atomic move to avoid race conditions
+mv "$TEMP_FILE" "$HEARTBEAT_DIR/$AGENT_ID.json" 2>/dev/null || true
+
+# Append to activity log (JSONL format)
+ACTIVITY_FILE="$AGENT_DIR/activity.jsonl"
+
+# Create activity entry
+ACTIVITY_ENTRY=$(jq -n \
+  --arg ts "$(date -Iseconds)" \
+  --arg tool "$TOOL_NAME" \
+  --arg action "$TOOL_INPUT" \
+  '{
+    ts: $ts,
+    tool: $tool,
+    action: $action
+  }' 2>/dev/null || echo "")
+
+# Append to activity log if we successfully created the entry
+if [ -n "$ACTIVITY_ENTRY" ]; then
+  echo "$ACTIVITY_ENTRY" >> "$ACTIVITY_FILE" 2>/dev/null || true
+
+  # Prune to last 100 entries (use tail for atomic operation)
+  if [ -f "$ACTIVITY_FILE" ]; then
+    TEMP_ACTIVITY="$ACTIVITY_FILE.tmp"
+    tail -n 100 "$ACTIVITY_FILE" > "$TEMP_ACTIVITY" 2>/dev/null && mv "$TEMP_ACTIVITY" "$ACTIVITY_FILE" 2>/dev/null || true
+  fi
+fi
+
+# Update agent runtime state with latest activity timestamp (PAN-119)
+STATE_FILE="$AGENT_DIR/state.json"
+TIMESTAMP="$(date -Iseconds)"
+
+if [ -f "$STATE_FILE" ]; then
+  # Update existing state file's lastActivity field
+  TEMP_STATE="$STATE_FILE.tmp"
+  jq --arg ts "$TIMESTAMP" --arg tool "$TOOL_NAME" \
+    '.lastActivity = $ts | .currentTool = $tool | .state = "active"' \
+    "$STATE_FILE" > "$TEMP_STATE" 2>/dev/null && mv "$TEMP_STATE" "$STATE_FILE" 2>/dev/null || true
+else
+  # Create initial state file
+  jq -n \
+    --arg ts "$TIMESTAMP" \
+    --arg tool "$TOOL_NAME" \
+    '{
+      state: "active",
+      lastActivity: $ts,
+      currentTool: $tool
+    }' > "$STATE_FILE" 2>/dev/null || true
+fi
+
+# Record cost event from tool usage (PAN-81)
+# Find the record-cost-event.js script - check multiple locations
+COST_SCRIPT=""
+if [ -f "$HOME/.panopticon/bin/record-cost-event.js" ]; then
+  COST_SCRIPT="$HOME/.panopticon/bin/record-cost-event.js"
+elif [ -f "$(dirname "$0")/record-cost-event.js" ]; then
+  COST_SCRIPT="$(dirname "$0")/record-cost-event.js"
+fi
+
+if [ -n "$COST_SCRIPT" ] && [ -f "$COST_SCRIPT" ]; then
+  # Export issue context for the cost recording script
+  export PANOPTICON_ISSUE_ID="${PANOPTICON_ISSUE_ID:-UNKNOWN}"
+  export PANOPTICON_SESSION_TYPE="${PANOPTICON_SESSION_TYPE:-implementation}"
+
+  # Call cost recording script with tool info on stdin
+  echo "$TOOL_INFO" | node "$COST_SCRIPT" 2>/dev/null || true
+fi
+
+# Always exit successfully - never break Claude Code execution
+exit 0

package/scripts/install-git-hooks.sh

@@ -0,0 +1,66 @@
+#!/bin/bash
+#
+# Install Panopticon git hooks in a project's repos
+# Usage: ./install-git-hooks.sh /path/to/project
+#
+# For poly-repos, this will find all .git directories and install hooks in each.
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+HOOKS_DIR="$SCRIPT_DIR/git-hooks"
+TARGET_DIR="${1:-.}"
+
+if [ ! -d "$TARGET_DIR" ]; then
+    echo "Error: Directory does not exist: $TARGET_DIR"
+    exit 1
+fi
+
+echo "Installing Panopticon git hooks in: $TARGET_DIR"
+echo ""
+
+# Find all .git directories (not files - those are worktrees)
+# Also exclude node_modules, target, etc.
+find "$TARGET_DIR" -maxdepth 4 -type d -name ".git" \
+    -not -path "*/node_modules/*" \
+    -not -path "*/target/*" \
+    -not -path "*/.git/*" \
+    -not -path "*/workspaces/*" \
+    2>/dev/null | while read git_dir; do
+
+    hooks_target="$git_dir/hooks"
+    repo_dir="$(dirname "$git_dir")"
+
+    echo "Installing hooks in: $repo_dir"
+
+    # Create hooks directory if it doesn't exist
+    mkdir -p "$hooks_target"
+
+    # Install each hook
+    for hook in "$HOOKS_DIR"/*; do
+        if [ -f "$hook" ]; then
+            hook_name=$(basename "$hook")
+            target_hook="$hooks_target/$hook_name"
+
+            # Check if hook already exists
+            if [ -f "$target_hook" ] && [ ! -L "$target_hook" ]; then
+                echo "  ⚠️  $hook_name: existing hook found, creating backup"
+                mv "$target_hook" "$target_hook.backup"
+            fi
+
+            # Create symlink to our hook
+            ln -sf "$hook" "$target_hook"
+            echo "  ✓ $hook_name installed"
+        fi
+    done
+
+    echo ""
+done
+
+echo "Done! Git hooks installed."
+echo ""
+echo "The post-checkout hook will warn if the main project directory"
+echo "is checked out to a branch other than 'main'."
+echo ""
+echo "To enable auto-revert (automatically switch back to main):"
+echo "  export PANOPTICON_AUTO_REVERT_CHECKOUT=1"

package/scripts/notify-complete

@@ -0,0 +1,79 @@
+#!/bin/bash
+# notify-complete: Send desktop notification when agent completes work
+# Part of Panopticon - works on WSL2/Windows, Linux, and macOS
+#
+# Usage: notify-complete <issue-id> <title> [mr-url]
+#
+# Examples:
+#   notify-complete MIN-665 "Fixed login button"
+#   notify-complete PAN-96 "Implemented templates" "https://gitlab.com/mr/123"
+
+ISSUE_ID="${1:-UNKNOWN}"
+TITLE="${2:-Agent completed work}"
+MR_URL="${3:-}"
+
+# Log to completion file
+COMPLETION_LOG="$HOME/.panopticon/agent-completed.log"
+mkdir -p "$(dirname "$COMPLETION_LOG")"
+echo "$(date '+%Y-%m-%d %H:%M:%S') | ${ISSUE_ID} | ${TITLE} | ${MR_URL}" >> "$COMPLETION_LOG"
+
+# Detect platform and send notification
+send_notification() {
+  local title="$1"
+  local message="$2"
+
+  # WSL2/Windows - use PowerShell toast notifications
+  if command -v powershell.exe &>/dev/null; then
+    powershell.exe -Command "
+\$xml = @\"
+<toast>
+  <visual>
+    <binding template=\"ToastText02\">
+      <text id=\"1\">${title}</text>
+      <text id=\"2\">${message}</text>
+    </binding>
+  </visual>
+  <audio src=\"ms-winsoundevent:Notification.Default\"/>
+</toast>
+\"@
+
+[Windows.UI.Notifications.ToastNotificationManager, Windows.UI.Notifications, ContentType = WindowsRuntime] | Out-Null
+[Windows.Data.Xml.Dom.XmlDocument, Windows.Data.Xml.Dom.XmlDocument, ContentType = WindowsRuntime] | Out-Null
+
+\$template = New-Object Windows.Data.Xml.Dom.XmlDocument
+\$template.LoadXml(\$xml)
+\$toast = New-Object Windows.UI.Notifications.ToastNotification \$template
+[Windows.UI.Notifications.ToastNotificationManager]::CreateToastNotifier('Panopticon').Show(\$toast)
+" 2>/dev/null && return 0
+
+    # Fallback: MessageBox
+    powershell.exe -Command "[System.Reflection.Assembly]::LoadWithPartialName('System.Windows.Forms'); [System.Windows.Forms.MessageBox]::Show('${message}', '${title}', 'OK', 'Information')" 2>/dev/null &
+    return 0
+  fi
+
+  # macOS - use osascript
+  if command -v osascript &>/dev/null; then
+    osascript -e "display notification \"${message}\" with title \"${title}\"" 2>/dev/null
+    return 0
+  fi
+
+  # Linux - use notify-send
+  if command -v notify-send &>/dev/null; then
+    notify-send "${title}" "${message}" 2>/dev/null
+    return 0
+  fi
+
+  # Fallback - just print to console
+  echo "[NOTIFICATION] ${title}: ${message}"
+}
+
+# Build notification message
+if [ -n "$MR_URL" ]; then
+  MESSAGE="${TITLE} - Ready for review"
+else
+  MESSAGE="${TITLE} - Work complete"
+fi
+
+send_notification "Panopticon: ${ISSUE_ID}" "$MESSAGE"
+
+echo "Notification sent for ${ISSUE_ID}"

package/scripts/postinstall.mjs

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+/**
+ * Postinstall script for Panopticon
+ *
+ * Automatically syncs hooks after npm install/upgrade if Panopticon
+ * has been initialized (bin dir exists).
+ */
+
+import { existsSync, readdirSync, copyFileSync, chmodSync, mkdirSync } from 'fs';
+import { join, dirname } from 'path';
+import { homedir } from 'os';
+import { fileURLToPath } from 'url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const BIN_DIR = join(homedir(), '.panopticon', 'bin');
+const SCRIPTS_DIR = __dirname;
+
+// Only run if Panopticon has been initialized
+if (!existsSync(join(homedir(), '.panopticon'))) {
+  console.log('Panopticon not initialized yet. Run `pan init` to set up.');
+  process.exit(0);
+}
+
+// Ensure bin directory exists
+mkdirSync(BIN_DIR, { recursive: true });
+
+// Copy all scripts from scripts/ to ~/.panopticon/bin/
+const scripts = readdirSync(SCRIPTS_DIR)
+  .filter(f => !f.startsWith('.') && !f.endsWith('.mjs') && !f.endsWith('.js'));
+
+let synced = 0;
+for (const script of scripts) {
+  try {
+    const source = join(SCRIPTS_DIR, script);
+    const target = join(BIN_DIR, script);
+    copyFileSync(source, target);
+    chmodSync(target, 0o755);
+    synced++;
+  } catch (e) {
+    // Ignore errors, hooks are non-critical
+  }
+}
+
+if (synced > 0) {
+  console.log(`✓ Synced ${synced} hooks to ~/.panopticon/bin/`);
+}
+
+// Suggest running full sync
+console.log('Run `pan sync` to sync skills and commands to AI tools.');