@stackmemoryai/stackmemory 0.3.5 → 0.3.7

package/dist/cli/commands/clear.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/cli/commands/clear.ts"],
-  "sourcesContent": ["#!/usr/bin/env node\n/**\n * Clear command for StackMemory\n * Manages context clearing with ledger preservation\n */\n\nimport { Command } from 'commander';\nimport chalk from 'chalk';\nimport ora from 'ora';\nimport * as fs from 'fs/promises';\nimport * as path from 'path';\nimport Database from 'better-sqlite3';\nimport { existsSync } from 'fs';\nimport { ClearSurvival } from '../../core/session/clear-survival-stub.js';\nimport { FrameManager } from '../../core/context/frame-manager.js';\nimport { HandoffGenerator } from '../../core/session/handoff-generator.js';\nimport { sessionManager } from '../../core/session/session-manager.js';\n\nconst clearCommand = new Command('clear')\n  .description('Manage context clearing with ledger preservation')\n  .option('--save', 'Save continuity ledger before clearing')\n  .option('--restore', 'Restore from continuity ledger')\n  .option('--check', 'Check if clear is recommended')\n  .option('--auto', 'Automatically save if needed and clear')\n  .option('--status', 'Show current context usage')\n  .option('--show-ledger', 'Display current ledger')\n  .action(async (options) => {\n    const spinner = ora();\n\n    try {\n      // Initialize managers\n      const projectRoot = process.cwd();\n      const dbPath = path.join(projectRoot, '.stackmemory', 'context.db');\n\n      // Check if StackMemory is initialized\n      if (!existsSync(dbPath)) {\n        console.error(\n          chalk.red('\u2717 StackMemory not initialized in this directory')\n        );\n        console.log(chalk.yellow('Run: stackmemory init'));\n        process.exit(1);\n      }\n\n      const db = new Database(dbPath);\n      \n      // Initialize session manager\n      await sessionManager.initialize();\n      const session = await sessionManager.getOrCreateSession({\n        projectPath: projectRoot,\n      });\n\n      const frameManager = new FrameManager(db, session.projectId);\n      // For testing - use a mock handoff generator\n      const handoffGenerator = {\n        generateHandoff: () => Promise.resolve('Mock handoff'),\n        getHandoffPath: () => 'mock.md'\n      };\n      const clearSurvival = new ClearSurvival(\n        frameManager,\n        handoffGenerator,\n        projectRoot\n      );\n\n      // Handle different options\n      if (options.status) {\n        await showContextStatus(clearSurvival);\n      } else if (options.check) {\n        await checkIfClearRecommended(clearSurvival);\n      } else if (options.save) {\n        await saveLedger(clearSurvival, spinner);\n      } else if (options.restore) {\n        await restoreFromLedger(clearSurvival, spinner);\n      } else if (options.showLedger) {\n        await showLedger(projectRoot);\n      } else if (options.auto) {\n        await autoClear(clearSurvival, spinner);\n      } else {\n        // Default: Show status and options\n        await showContextStatus(clearSurvival);\n        console.log('\\nOptions:');\n        console.log('  --status     Show current context usage');\n        console.log('  --check      Check if clear is recommended');\n        console.log('  --save       Save continuity ledger');\n        console.log('  --restore    Restore from ledger');\n        console.log('  --auto       Auto-save if needed and clear');\n      }\n    } catch (error) {\n      // Don't exit in tests - just log the error\n      console.error(chalk.red('Error: ' + (error as Error).message));\n      if (process.env.NODE_ENV !== 'test') {\n        process.exit(1);\n      }\n    }\n  });\n\nasync function showContextStatus(clearSurvival: ClearSurvival): Promise<void> {\n  const usage = await clearSurvival.getContextUsage();\n  const status = clearSurvival.assessContextStatus(usage);\n\n  console.log(chalk.bold('\\n\uD83D\uDCCA Context Usage Status'));\n  console.log('\u2500'.repeat(40));\n  \n  const percentage = Math.round(usage.percentageUsed);\n  const statusColor = getStatusColor(status);\n  \n  console.log(`Usage: ${percentage}% ${getProgressBar(percentage)}`);\n  console.log(`Status: ${statusColor}`);\n  console.log(`Active Frames: ${usage.activeFrames}`);\n  console.log(`Total Frames: ${usage.totalFrames}`);\n  console.log(`Sessions: ${usage.sessionCount}`);\n  \n  if (status === 'critical' || status === 'saved') {\n    console.log(\n      chalk.yellow('\\n\u26A0\uFE0F  Consider clearing context to improve performance')\n    );\n    console.log(chalk.cyan('Run: stackmemory clear --save'));\n  }\n}\n\nasync function checkIfClearRecommended(clearSurvival: ClearSurvival): Promise<void> {\n  const usage = await clearSurvival.getContextUsage();\n  const status = clearSurvival.assessContextStatus(usage);\n  \n  if (status === 'critical' || status === 'saved') {\n    console.log(chalk.yellow('\u2713 Clear recommended'));\n    console.log(`Context usage: ${Math.round(usage.percentageUsed)}%`);\n    process.exit(0);\n  } else {\n    console.log(chalk.green('\u2717 Clear not needed'));\n    console.log(`Context usage: ${Math.round(usage.percentageUsed)}%`);\n    process.exit(1);\n  }\n}\n\nasync function saveLedger(clearSurvival: ClearSurvival, spinner: ora.Ora): Promise<void> {\n  spinner.start('Saving continuity ledger...');\n  \n  const ledgerPath = await clearSurvival.saveContinuityLedger();\n  \n  spinner.succeed(chalk.green('Continuity ledger saved'));\n  console.log(chalk.cyan(`Location: ${ledgerPath}`));\n  \n  // Show what was saved\n  const ledger = JSON.parse(await fs.readFile(ledgerPath, 'utf-8'));\n  console.log('\\nSaved:');\n  console.log(`  \u2022 ${ledger.activeFrames.length} active frames`);\n  console.log(`  \u2022 ${ledger.decisions.length} key decisions`);\n  console.log(`  \u2022 ${ledger.context.importantTasks?.length || 0} important tasks`);\n}\n\nasync function restoreFromLedger(clearSurvival: ClearSurvival, spinner: ora.Ora): Promise<void> {\n  spinner.start('Restoring from continuity ledger...');\n  \n  const result = await clearSurvival.restoreFromLedger();\n  \n  if (result.success) {\n    spinner.succeed(chalk.green('Context restored from ledger'));\n    console.log('\\nRestored:');\n    console.log(`  \u2022 ${result.restoredFrames} frames`);\n    console.log(`  \u2022 ${result.restoredDecisions} decisions`);\n  } else {\n    spinner.fail(chalk.red('Failed to restore from ledger'));\n    console.log(chalk.yellow(result.message));\n  }\n}\n\nasync function showLedger(projectRoot: string): Promise<void> {\n  const ledgerPath = path.join(projectRoot, '.stackmemory', 'continuity.json');\n  \n  if (!existsSync(ledgerPath)) {\n    console.log(chalk.yellow('No continuity ledger found'));\n    return;\n  }\n  \n  const ledger = JSON.parse(await fs.readFile(ledgerPath, 'utf-8'));\n  \n  console.log(chalk.bold('\\n\uD83D\uDCD6 Continuity Ledger'));\n  console.log('\u2500'.repeat(40));\n  console.log(`Created: ${new Date(ledger.timestamp).toLocaleString()}`);\n  console.log(`Active Frames: ${ledger.activeFrames.length}`);\n  console.log(`Key Decisions: ${ledger.decisions.length}`);\n  \n  if (ledger.activeFrames.length > 0) {\n    console.log('\\nActive Work:');\n    ledger.activeFrames.slice(0, 5).forEach((frame: any) => {\n      console.log(`  \u2022 ${frame.name} (${frame.type})`);\n    });\n  }\n  \n  if (ledger.decisions.length > 0) {\n    console.log('\\nKey Decisions:');\n    ledger.decisions.slice(0, 3).forEach((decision: any) => {\n      console.log(`  \u2022 ${decision.decision}`);\n    });\n  }\n}\n\nasync function autoClear(clearSurvival: ClearSurvival, spinner: ora.Ora): Promise<void> {\n  const usage = await clearSurvival.getContextUsage();\n  const status = clearSurvival.assessContextStatus(usage);\n  \n  if (status === 'critical' || status === 'saved') {\n    spinner.start('Auto-saving ledger before clear...');\n    await clearSurvival.saveContinuityLedger();\n    spinner.succeed('Ledger saved');\n    \n    spinner.start('Clearing context...');\n    // Note: Actual clear implementation would go here\n    // For now, just simulate\n    await new Promise(resolve => setTimeout(resolve, 1000));\n    spinner.succeed('Context cleared successfully');\n  } else {\n    console.log(chalk.green('Context usage is healthy, no clear needed'));\n  }\n}\n\nfunction getProgressBar(percentage: number): string {\n  const filled = Math.round(percentage / 5);\n  const empty = 20 - filled;\n  \n  let bar = '[';\n  bar += chalk.green('\u25A0').repeat(Math.min(filled, 10));\n  bar += chalk.yellow('\u25A0').repeat(Math.max(0, Math.min(filled - 10, 5)));\n  bar += chalk.red('\u25A0').repeat(Math.max(0, filled - 15));\n  bar += chalk.gray('\u25A1').repeat(empty);\n  bar += ']';\n  \n  return bar;\n}\n\nfunction getStatusColor(status: string): string {\n  switch (status) {\n    case 'healthy':\n      return chalk.green('\u2713 Healthy (<50%)');\n    case 'moderate':\n      return chalk.blue('\u26A1 Moderate (50-70%)');\n    case 'critical':\n      return chalk.yellow('\u26A0\uFE0F Critical (70-85%)');\n    case 'saved':\n      return chalk.red('\uD83D\uDCBE Auto-saved (>85%)');\n    default:\n      return status;\n  }\n}\n\n// Export for use in main CLI\nexport default clearCommand;"],
-  "mappings": "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",
+  "sourcesContent": ["#!/usr/bin/env node\n/**\n * Clear command for StackMemory\n * Manages context clearing with ledger preservation\n */\n\nimport { Command } from 'commander';\nimport chalk from 'chalk';\nimport ora from 'ora';\nimport * as fs from 'fs/promises';\nimport * as path from 'path';\nimport Database from 'better-sqlite3';\nimport { existsSync } from 'fs';\nimport { ClearSurvival } from '../../core/session/clear-survival-stub.js';\nimport { FrameManager } from '../../core/context/frame-manager.js';\nimport { HandoffGenerator } from '../../core/session/handoff-generator.js';\nimport { sessionManager } from '../../core/session/session-manager.js';\n// Type-safe environment variable access\nfunction getEnv(key: string, defaultValue?: string): string {\n  const value = process.env[key];\n  if (value === undefined) {\n    if (defaultValue !== undefined) return defaultValue;\n    throw new Error(`Environment variable ${key} is required`);\n  }\n  return value;\n}\n\nfunction getOptionalEnv(key: string): string | undefined {\n  return process.env[key];\n}\n\n\nconst clearCommand = new Command('clear')\n  .description('Manage context clearing with ledger preservation')\n  .option('--save', 'Save continuity ledger before clearing')\n  .option('--restore', 'Restore from continuity ledger')\n  .option('--check', 'Check if clear is recommended')\n  .option('--auto', 'Automatically save if needed and clear')\n  .option('--status', 'Show current context usage')\n  .option('--show-ledger', 'Display current ledger')\n  .action(async (options) => {\n    const spinner = ora();\n\n    try {\n      // Initialize managers\n      const projectRoot = process.cwd();\n      const dbPath = path.join(projectRoot, '.stackmemory', 'context.db');\n\n      // Check if StackMemory is initialized\n      if (!existsSync(dbPath)) {\n        console.error(\n          chalk.red('\u2717 StackMemory not initialized in this directory')\n        );\n        console.log(chalk.yellow('Run: stackmemory init'));\n        process.exit(1);\n      }\n\n      const db = new Database(dbPath);\n      \n      // Initialize session manager\n      await sessionManager.initialize();\n      const session = await sessionManager.getOrCreateSession({\n        projectPath: projectRoot,\n      });\n\n      const frameManager = new FrameManager(db, session.projectId);\n      // For testing - use a mock handoff generator\n      const handoffGenerator = {\n        generateHandoff: () => Promise.resolve('Mock handoff'),\n        getHandoffPath: () => 'mock.md'\n      };\n      const clearSurvival = new ClearSurvival(\n        frameManager,\n        handoffGenerator,\n        projectRoot\n      );\n\n      // Handle different options\n      if (options.status) {\n        await showContextStatus(clearSurvival);\n      } else if (options.check) {\n        await checkIfClearRecommended(clearSurvival);\n      } else if (options.save) {\n        await saveLedger(clearSurvival, spinner);\n      } else if (options.restore) {\n        await restoreFromLedger(clearSurvival, spinner);\n      } else if (options.showLedger) {\n        await showLedger(projectRoot);\n      } else if (options.auto) {\n        await autoClear(clearSurvival, spinner);\n      } else {\n        // Default: Show status and options\n        await showContextStatus(clearSurvival);\n        console.log('\\nOptions:');\n        console.log('  --status     Show current context usage');\n        console.log('  --check      Check if clear is recommended');\n        console.log('  --save       Save continuity ledger');\n        console.log('  --restore    Restore from ledger');\n        console.log('  --auto       Auto-save if needed and clear');\n      }\n    } catch (error: unknown) {\n      // Don't exit in tests - just log the error\n      console.error(chalk.red('Error: ' + (error as Error).message));\n      if (process.env['NODE_ENV'] !== 'test') {\n        process.exit(1);\n      }\n    }\n  });\n\nasync function showContextStatus(clearSurvival: ClearSurvival): Promise<void> {\n  const usage = await clearSurvival.getContextUsage();\n  const status = clearSurvival.assessContextStatus(usage);\n\n  console.log(chalk.bold('\\n\uD83D\uDCCA Context Usage Status'));\n  console.log('\u2500'.repeat(40));\n  \n  const percentage = Math.round(usage.percentageUsed);\n  const statusColor = getStatusColor(status);\n  \n  console.log(`Usage: ${percentage}% ${getProgressBar(percentage)}`);\n  console.log(`Status: ${statusColor}`);\n  console.log(`Active Frames: ${usage.activeFrames}`);\n  console.log(`Total Frames: ${usage.totalFrames}`);\n  console.log(`Sessions: ${usage.sessionCount}`);\n  \n  if (status === 'critical' || status === 'saved') {\n    console.log(\n      chalk.yellow('\\n\u26A0\uFE0F  Consider clearing context to improve performance')\n    );\n    console.log(chalk.cyan('Run: stackmemory clear --save'));\n  }\n}\n\nasync function checkIfClearRecommended(clearSurvival: ClearSurvival): Promise<void> {\n  const usage = await clearSurvival.getContextUsage();\n  const status = clearSurvival.assessContextStatus(usage);\n  \n  if (status === 'critical' || status === 'saved') {\n    console.log(chalk.yellow('\u2713 Clear recommended'));\n    console.log(`Context usage: ${Math.round(usage.percentageUsed)}%`);\n    process.exit(0);\n  } else {\n    console.log(chalk.green('\u2717 Clear not needed'));\n    console.log(`Context usage: ${Math.round(usage.percentageUsed)}%`);\n    process.exit(1);\n  }\n}\n\nasync function saveLedger(clearSurvival: ClearSurvival, spinner: ora.Ora): Promise<void> {\n  spinner.start('Saving continuity ledger...');\n  \n  const ledgerPath = await clearSurvival.saveContinuityLedger();\n  \n  spinner.succeed(chalk.green('Continuity ledger saved'));\n  console.log(chalk.cyan(`Location: ${ledgerPath}`));\n  \n  // Show what was saved\n  const ledger = JSON.parse(await fs.readFile(ledgerPath, 'utf-8'));\n  console.log('\\nSaved:');\n  console.log(`  \u2022 ${ledger.activeFrames.length} active frames`);\n  console.log(`  \u2022 ${ledger.decisions.length} key decisions`);\n  console.log(`  \u2022 ${ledger.context.importantTasks?.length || 0} important tasks`);\n}\n\nasync function restoreFromLedger(clearSurvival: ClearSurvival, spinner: ora.Ora): Promise<void> {\n  spinner.start('Restoring from continuity ledger...');\n  \n  const result = await clearSurvival.restoreFromLedger();\n  \n  if (result.success) {\n    spinner.succeed(chalk.green('Context restored from ledger'));\n    console.log('\\nRestored:');\n    console.log(`  \u2022 ${result.restoredFrames} frames`);\n    console.log(`  \u2022 ${result.restoredDecisions} decisions`);\n  } else {\n    spinner.fail(chalk.red('Failed to restore from ledger'));\n    console.log(chalk.yellow(result.message));\n  }\n}\n\nasync function showLedger(projectRoot: string): Promise<void> {\n  const ledgerPath = path.join(projectRoot, '.stackmemory', 'continuity.json');\n  \n  if (!existsSync(ledgerPath)) {\n    console.log(chalk.yellow('No continuity ledger found'));\n    return;\n  }\n  \n  const ledger = JSON.parse(await fs.readFile(ledgerPath, 'utf-8'));\n  \n  console.log(chalk.bold('\\n\uD83D\uDCD6 Continuity Ledger'));\n  console.log('\u2500'.repeat(40));\n  console.log(`Created: ${new Date(ledger.timestamp).toLocaleString()}`);\n  console.log(`Active Frames: ${ledger.activeFrames.length}`);\n  console.log(`Key Decisions: ${ledger.decisions.length}`);\n  \n  if (ledger.activeFrames.length > 0) {\n    console.log('\\nActive Work:');\n    ledger.activeFrames.slice(0, 5).forEach((frame: any) => {\n      console.log(`  \u2022 ${frame.name} (${frame.type})`);\n    });\n  }\n  \n  if (ledger.decisions.length > 0) {\n    console.log('\\nKey Decisions:');\n    ledger.decisions.slice(0, 3).forEach((decision: any) => {\n      console.log(`  \u2022 ${decision.decision}`);\n    });\n  }\n}\n\nasync function autoClear(clearSurvival: ClearSurvival, spinner: ora.Ora): Promise<void> {\n  const usage = await clearSurvival.getContextUsage();\n  const status = clearSurvival.assessContextStatus(usage);\n  \n  if (status === 'critical' || status === 'saved') {\n    spinner.start('Auto-saving ledger before clear...');\n    await clearSurvival.saveContinuityLedger();\n    spinner.succeed('Ledger saved');\n    \n    spinner.start('Clearing context...');\n    // Note: Actual clear implementation would go here\n    // For now, just simulate\n    await new Promise(resolve => setTimeout(resolve, 1000));\n    spinner.succeed('Context cleared successfully');\n  } else {\n    console.log(chalk.green('Context usage is healthy, no clear needed'));\n  }\n}\n\nfunction getProgressBar(percentage: number): string {\n  const filled = Math.round(percentage / 5);\n  const empty = 20 - filled;\n  \n  let bar = '[';\n  bar += chalk.green('\u25A0').repeat(Math.min(filled, 10));\n  bar += chalk.yellow('\u25A0').repeat(Math.max(0, Math.min(filled - 10, 5)));\n  bar += chalk.red('\u25A0').repeat(Math.max(0, filled - 15));\n  bar += chalk.gray('\u25A1').repeat(empty);\n  bar += ']';\n  \n  return bar;\n}\n\nfunction getStatusColor(status: string): string {\n  switch (status) {\n    case 'healthy':\n      return chalk.green('\u2713 Healthy (<50%)');\n    case 'moderate':\n      return chalk.blue('\u26A1 Moderate (50-70%)');\n    case 'critical':\n      return chalk.yellow('\u26A0\uFE0F Critical (70-85%)');\n    case 'saved':\n      return chalk.red('\uD83D\uDCBE Auto-saved (>85%)');\n    default:\n      return status;\n  }\n}\n\n// Export for use in main CLI\nexport default clearCommand;"],
+  "mappings": ";AAMA,SAAS,eAAe;AACxB,OAAO,WAAW;AAClB,OAAO,SAAS;AAChB,YAAY,QAAQ;AACpB,YAAY,UAAU;AACtB,OAAO,cAAc;AACrB,SAAS,kBAAkB;AAC3B,SAAS,qBAAqB;AAC9B,SAAS,oBAAoB;AAE7B,SAAS,sBAAsB;AAE/B,SAAS,OAAO,KAAa,cAA+B;AAC1D,QAAM,QAAQ,QAAQ,IAAI,GAAG;AAC7B,MAAI,UAAU,QAAW;AACvB,QAAI,iBAAiB,OAAW,QAAO;AACvC,UAAM,IAAI,MAAM,wBAAwB,GAAG,cAAc;AAAA,EAC3D;AACA,SAAO;AACT;AAEA,SAAS,eAAe,KAAiC;AACvD,SAAO,QAAQ,IAAI,GAAG;AACxB;AAGA,MAAM,eAAe,IAAI,QAAQ,OAAO,EACrC,YAAY,kDAAkD,EAC9D,OAAO,UAAU,wCAAwC,EACzD,OAAO,aAAa,gCAAgC,EACpD,OAAO,WAAW,+BAA+B,EACjD,OAAO,UAAU,wCAAwC,EACzD,OAAO,YAAY,4BAA4B,EAC/C,OAAO,iBAAiB,wBAAwB,EAChD,OAAO,OAAO,YAAY;AACzB,QAAM,UAAU,IAAI;AAEpB,MAAI;AAEF,UAAM,cAAc,QAAQ,IAAI;AAChC,UAAM,SAAS,KAAK,KAAK,aAAa,gBAAgB,YAAY;AAGlE,QAAI,CAAC,WAAW,MAAM,GAAG;AACvB,cAAQ;AAAA,QACN,MAAM,IAAI,sDAAiD;AAAA,MAC7D;AACA,cAAQ,IAAI,MAAM,OAAO,uBAAuB,CAAC;AACjD,cAAQ,KAAK,CAAC;AAAA,IAChB;AAEA,UAAM,KAAK,IAAI,SAAS,MAAM;AAG9B,UAAM,eAAe,WAAW;AAChC,UAAM,UAAU,MAAM,eAAe,mBAAmB;AAAA,MACtD,aAAa;AAAA,IACf,CAAC;AAED,UAAM,eAAe,IAAI,aAAa,IAAI,QAAQ,SAAS;AAE3D,UAAM,mBAAmB;AAAA,MACvB,iBAAiB,MAAM,QAAQ,QAAQ,cAAc;AAAA,MACrD,gBAAgB,MAAM;AAAA,IACxB;AACA,UAAM,gBAAgB,IAAI;AAAA,MACxB;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAGA,QAAI,QAAQ,QAAQ;AAClB,YAAM,kBAAkB,aAAa;AAAA,IACvC,WAAW,QAAQ,OAAO;AACxB,YAAM,wBAAwB,aAAa;AAAA,IAC7C,WAAW,QAAQ,MAAM;AACvB,YAAM,WAAW,eAAe,OAAO;AAAA,IACzC,WAAW,QAAQ,SAAS;AAC1B,YAAM,kBAAkB,eAAe,OAAO;AAAA,IAChD,WAAW,QAAQ,YAAY;AAC7B,YAAM,WAAW,WAAW;AAAA,IAC9B,WAAW,QAAQ,MAAM;AACvB,YAAM,UAAU,eAAe,OAAO;AAAA,IACxC,OAAO;AAEL,YAAM,kBAAkB,aAAa;AACrC,cAAQ,IAAI,YAAY;AACxB,cAAQ,IAAI,2CAA2C;AACvD,cAAQ,IAAI,8CAA8C;AAC1D,cAAQ,IAAI,uCAAuC;AACnD,cAAQ,IAAI,oCAAoC;AAChD,cAAQ,IAAI,8CAA8C;AAAA,IAC5D;AAAA,EACF,SAAS,OAAgB;AAEvB,YAAQ,MAAM,MAAM,IAAI,YAAa,MAAgB,OAAO,CAAC;AAC7D,QAAI,QAAQ,IAAI,UAAU,MAAM,QAAQ;AACtC,cAAQ,KAAK,CAAC;AAAA,IAChB;AAAA,EACF;AACF,CAAC;AAEH,eAAe,kBAAkB,eAA6C;AAC5E,QAAM,QAAQ,MAAM,cAAc,gBAAgB;AAClD,QAAM,SAAS,cAAc,oBAAoB,KAAK;AAEtD,UAAQ,IAAI,MAAM,KAAK,kCAA2B,CAAC;AACnD,UAAQ,IAAI,SAAI,OAAO,EAAE,CAAC;AAE1B,QAAM,aAAa,KAAK,MAAM,MAAM,cAAc;AAClD,QAAM,cAAc,eAAe,MAAM;AAEzC,UAAQ,IAAI,UAAU,UAAU,KAAK,eAAe,UAAU,CAAC,EAAE;AACjE,UAAQ,IAAI,WAAW,WAAW,EAAE;AACpC,UAAQ,IAAI,kBAAkB,MAAM,YAAY,EAAE;AAClD,UAAQ,IAAI,iBAAiB,MAAM,WAAW,EAAE;AAChD,UAAQ,IAAI,aAAa,MAAM,YAAY,EAAE;AAE7C,MAAI,WAAW,cAAc,WAAW,SAAS;AAC/C,YAAQ;AAAA,MACN,MAAM,OAAO,kEAAwD;AAAA,IACvE;AACA,YAAQ,IAAI,MAAM,KAAK,+BAA+B,CAAC;AAAA,EACzD;AACF;AAEA,eAAe,wBAAwB,eAA6C;AAClF,QAAM,QAAQ,MAAM,cAAc,gBAAgB;AAClD,QAAM,SAAS,cAAc,oBAAoB,KAAK;AAEtD,MAAI,WAAW,cAAc,WAAW,SAAS;AAC/C,YAAQ,IAAI,MAAM,OAAO,0BAAqB,CAAC;AAC/C,YAAQ,IAAI,kBAAkB,KAAK,MAAM,MAAM,cAAc,CAAC,GAAG;AACjE,YAAQ,KAAK,CAAC;AAAA,EAChB,OAAO;AACL,YAAQ,IAAI,MAAM,MAAM,yBAAoB,CAAC;AAC7C,YAAQ,IAAI,kBAAkB,KAAK,MAAM,MAAM,cAAc,CAAC,GAAG;AACjE,YAAQ,KAAK,CAAC;AAAA,EAChB;AACF;AAEA,eAAe,WAAW,eAA8B,SAAiC;AACvF,UAAQ,MAAM,6BAA6B;AAE3C,QAAM,aAAa,MAAM,cAAc,qBAAqB;AAE5D,UAAQ,QAAQ,MAAM,MAAM,yBAAyB,CAAC;AACtD,UAAQ,IAAI,MAAM,KAAK,aAAa,UAAU,EAAE,CAAC;AAGjD,QAAM,SAAS,KAAK,MAAM,MAAM,GAAG,SAAS,YAAY,OAAO,CAAC;AAChE,UAAQ,IAAI,UAAU;AACtB,UAAQ,IAAI,YAAO,OAAO,aAAa,MAAM,gBAAgB;AAC7D,UAAQ,IAAI,YAAO,OAAO,UAAU,MAAM,gBAAgB;AAC1D,UAAQ,IAAI,YAAO,OAAO,QAAQ,gBAAgB,UAAU,CAAC,kBAAkB;AACjF;AAEA,eAAe,kBAAkB,eAA8B,SAAiC;AAC9F,UAAQ,MAAM,qCAAqC;AAEnD,QAAM,SAAS,MAAM,cAAc,kBAAkB;AAErD,MAAI,OAAO,SAAS;AAClB,YAAQ,QAAQ,MAAM,MAAM,8BAA8B,CAAC;AAC3D,YAAQ,IAAI,aAAa;AACzB,YAAQ,IAAI,YAAO,OAAO,cAAc,SAAS;AACjD,YAAQ,IAAI,YAAO,OAAO,iBAAiB,YAAY;AAAA,EACzD,OAAO;AACL,YAAQ,KAAK,MAAM,IAAI,+BAA+B,CAAC;AACvD,YAAQ,IAAI,MAAM,OAAO,OAAO,OAAO,CAAC;AAAA,EAC1C;AACF;AAEA,eAAe,WAAW,aAAoC;AAC5D,QAAM,aAAa,KAAK,KAAK,aAAa,gBAAgB,iBAAiB;AAE3E,MAAI,CAAC,WAAW,UAAU,GAAG;AAC3B,YAAQ,IAAI,MAAM,OAAO,4BAA4B,CAAC;AACtD;AAAA,EACF;AAEA,QAAM,SAAS,KAAK,MAAM,MAAM,GAAG,SAAS,YAAY,OAAO,CAAC;AAEhE,UAAQ,IAAI,MAAM,KAAK,+BAAwB,CAAC;AAChD,UAAQ,IAAI,SAAI,OAAO,EAAE,CAAC;AAC1B,UAAQ,IAAI,YAAY,IAAI,KAAK,OAAO,SAAS,EAAE,eAAe,CAAC,EAAE;AACrE,UAAQ,IAAI,kBAAkB,OAAO,aAAa,MAAM,EAAE;AAC1D,UAAQ,IAAI,kBAAkB,OAAO,UAAU,MAAM,EAAE;AAEvD,MAAI,OAAO,aAAa,SAAS,GAAG;AAClC,YAAQ,IAAI,gBAAgB;AAC5B,WAAO,aAAa,MAAM,GAAG,CAAC,EAAE,QAAQ,CAAC,UAAe;AACtD,cAAQ,IAAI,YAAO,MAAM,IAAI,KAAK,MAAM,IAAI,GAAG;AAAA,IACjD,CAAC;AAAA,EACH;AAEA,MAAI,OAAO,UAAU,SAAS,GAAG;AAC/B,YAAQ,IAAI,kBAAkB;AAC9B,WAAO,UAAU,MAAM,GAAG,CAAC,EAAE,QAAQ,CAAC,aAAkB;AACtD,cAAQ,IAAI,YAAO,SAAS,QAAQ,EAAE;AAAA,IACxC,CAAC;AAAA,EACH;AACF;AAEA,eAAe,UAAU,eAA8B,SAAiC;AACtF,QAAM,QAAQ,MAAM,cAAc,gBAAgB;AAClD,QAAM,SAAS,cAAc,oBAAoB,KAAK;AAEtD,MAAI,WAAW,cAAc,WAAW,SAAS;AAC/C,YAAQ,MAAM,oCAAoC;AAClD,UAAM,cAAc,qBAAqB;AACzC,YAAQ,QAAQ,cAAc;AAE9B,YAAQ,MAAM,qBAAqB;AAGnC,UAAM,IAAI,QAAQ,aAAW,WAAW,SAAS,GAAI,CAAC;AACtD,YAAQ,QAAQ,8BAA8B;AAAA,EAChD,OAAO;AACL,YAAQ,IAAI,MAAM,MAAM,2CAA2C,CAAC;AAAA,EACtE;AACF;AAEA,SAAS,eAAe,YAA4B;AAClD,QAAM,SAAS,KAAK,MAAM,aAAa,CAAC;AACxC,QAAM,QAAQ,KAAK;AAEnB,MAAI,MAAM;AACV,SAAO,MAAM,MAAM,QAAG,EAAE,OAAO,KAAK,IAAI,QAAQ,EAAE,CAAC;AACnD,SAAO,MAAM,OAAO,QAAG,EAAE,OAAO,KAAK,IAAI,GAAG,KAAK,IAAI,SAAS,IAAI,CAAC,CAAC,CAAC;AACrE,SAAO,MAAM,IAAI,QAAG,EAAE,OAAO,KAAK,IAAI,GAAG,SAAS,EAAE,CAAC;AACrD,SAAO,MAAM,KAAK,QAAG,EAAE,OAAO,KAAK;AACnC,SAAO;AAEP,SAAO;AACT;AAEA,SAAS,eAAe,QAAwB;AAC9C,UAAQ,QAAQ;AAAA,IACd,KAAK;AACH,aAAO,MAAM,MAAM,uBAAkB;AAAA,IACvC,KAAK;AACH,aAAO,MAAM,KAAK,0BAAqB;AAAA,IACzC,KAAK;AACH,aAAO,MAAM,OAAO,gCAAsB;AAAA,IAC5C,KAAK;AACH,aAAO,MAAM,IAAI,6BAAsB;AAAA,IACzC;AACE,aAAO;AAAA,EACX;AACF;AAGA,IAAO,gBAAQ;",
   "names": []
 }

package/dist/cli/commands/context.js

@@ -3,6 +3,17 @@ import Database from "better-sqlite3";
 import { join } from "path";
 import { existsSync } from "fs";
 import { FrameManager } from "../../core/context/frame-manager.js";
+function getEnv(key, defaultValue) {
+  const value = process.env[key];
+  if (value === void 0) {
+    if (defaultValue !== void 0) return defaultValue;
+    throw new Error(`Environment variable ${key} is required`);
+  }
+  return value;
+}
+function getOptionalEnv(key) {
+  return process.env[key];
+}
 function createContextCommands() {
   const context = new Command("context").alias("ctx").description("Manage context stack");
   context.command("show").alias("status").description("Show current context stack").option("-v, --verbose", "Show detailed information").action(async (options) => {
@@ -273,7 +284,7 @@ function createContextCommands() {
           });
         }
       } else if (action === "save") {
-        const instanceId = options.instance || process.env.CLAUDE_INSTANCE_ID;
+        const instanceId = options.instance || process.env["CLAUDE_INSTANCE_ID"];
         const branch = options.branch || "unknown";
         if (!instanceId) {
           console.log("\u26A0\uFE0F No instance ID provided or detected.");
@@ -293,7 +304,7 @@ function createContextCommands() {
         console.log(`   Instance: ${instanceId}`);
         console.log(`   Frame ID: ${frameId.slice(0, 10)}`);
       } else if (action === "load") {
-        const instanceId = options.instance || process.env.CLAUDE_INSTANCE_ID;
+        const instanceId = options.instance || process.env["CLAUDE_INSTANCE_ID"];
         if (!instanceId) {
           console.log("\u26A0\uFE0F No instance ID provided.");
           return;

package/dist/cli/commands/context.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/cli/commands/context.ts"],
-  "sourcesContent": ["/**\n * Context Commands for StackMemory CLI\n * Manage context stack (show, push, pop)\n */\n\nimport { Command } from 'commander';\nimport Database from 'better-sqlite3';\nimport { join } from 'path';\nimport { existsSync } from 'fs';\nimport { FrameManager, FrameType } from '../../core/context/frame-manager.js';\n\nexport function createContextCommands(): Command {\n  const context = new Command('context')\n    .alias('ctx')\n    .description('Manage context stack');\n\n  // Show current context\n  context\n    .command('show')\n    .alias('status')\n    .description('Show current context stack')\n    .option('-v, --verbose', 'Show detailed information')\n    .action(async (options) => {\n      const projectRoot = process.cwd();\n      const dbPath = join(projectRoot, '.stackmemory', 'context.db');\n\n      if (!existsSync(dbPath)) {\n        console.log(\n          '\u274C StackMemory not initialized. Run \"stackmemory init\" first.'\n        );\n        return;\n      }\n\n      const db = new Database(dbPath);\n\n      try {\n        // Get project ID - try metadata table, fallback to default\n        let projectId = 'default';\n        try {\n          const projectRow = db\n            .prepare(\n              `\n            SELECT value FROM metadata WHERE key = 'project_id'\n          `\n            )\n            .get() as any;\n          if (projectRow?.value) projectId = projectRow.value;\n        } catch {\n          // metadata table doesn't exist, use default\n        }\n\n        const frameManager = new FrameManager(db, projectId, { \n          skipContextBridge: true \n        });\n\n        const depth = frameManager.getStackDepth();\n        const activePath = frameManager.getActiveFramePath();\n\n        console.log(`\\n\uD83D\uDCDA Context Stack\\n`);\n        console.log(`Project: ${projectId}`);\n        console.log(`Depth: ${depth}`);\n        console.log(`Active frames: ${activePath.length}\\n`);\n\n        if (activePath.length === 0) {\n          console.log('No active context frames.\\n');\n          console.log('Use \"stackmemory context push\" to create one.');\n        } else {\n          const typeIcon: Record<string, string> = {\n            session: '\uD83D\uDD37',\n            task: '\uD83D\uDCCB',\n            command: '\u26A1',\n            file: '\uD83D\uDCC4',\n            decision: '\uD83D\uDCA1',\n          };\n\n          console.log('Stack (bottom to top):');\n          activePath.forEach((frame, i) => {\n            const icon = typeIcon[frame.type] || '\uD83D\uDCE6';\n            const indent = '  '.repeat(i);\n            console.log(\n              `${indent}${i === activePath.length - 1 ? '\u2514\u2500' : '\u251C\u2500'} ${icon} ${frame.name || frame.frame_id.slice(0, 10)}`\n            );\n\n            if (options.verbose) {\n              console.log(`${indent}   ID: ${frame.frame_id}`);\n              console.log(`${indent}   Type: ${frame.type}`);\n              console.log(\n                `${indent}   Created: ${new Date(frame.created_at * 1000).toLocaleString()}`\n              );\n            }\n          });\n        }\n\n        console.log('');\n      } catch (error) {\n        console.error('\u274C Failed to show context:', (error as Error).message);\n      } finally {\n        db.close();\n      }\n    });\n\n  // Push new context frame\n  context\n    .command('push <name>')\n    .description('Push a new context frame onto the stack')\n    .option(\n      '-t, --type <type>',\n      'Frame type (session, task, command, file, decision)',\n      'task'\n    )\n    .option('-m, --metadata <json>', 'Additional metadata as JSON')\n    .action(async (name, options) => {\n      const projectRoot = process.cwd();\n      const dbPath = join(projectRoot, '.stackmemory', 'context.db');\n\n      if (!existsSync(dbPath)) {\n        console.log(\n          '\u274C StackMemory not initialized. Run \"stackmemory init\" first.'\n        );\n        return;\n      }\n\n      const db = new Database(dbPath);\n\n      try {\n        let projectId = 'default';\n        try {\n          const projectRow = db\n            .prepare(`SELECT value FROM metadata WHERE key = 'project_id'`)\n            .get() as any;\n          if (projectRow?.value) projectId = projectRow.value;\n        } catch {}\n\n        const frameManager = new FrameManager(db, projectId, { \n          skipContextBridge: true \n        });\n\n        // Get current top frame as parent\n        const activePath = frameManager.getActiveFramePath();\n        const parentId =\n          activePath.length > 0\n            ? activePath[activePath.length - 1].frame_id\n            : undefined;\n\n        // Parse metadata if provided\n        let inputs = {};\n        if (options.metadata) {\n          try {\n            inputs = JSON.parse(options.metadata);\n          } catch {\n            console.log('\u26A0\uFE0F Invalid metadata JSON, ignoring');\n          }\n        }\n\n        const frameId = frameManager.createFrame({\n          type: options.type as FrameType,\n          name,\n          inputs,\n          parentFrameId: parentId,\n        });\n\n        console.log(`\u2705 Pushed context frame: ${name}`);\n        console.log(`   ID: ${frameId.slice(0, 10)}`);\n        console.log(`   Type: ${options.type}`);\n        console.log(`   Depth: ${frameManager.getStackDepth()}`);\n      } catch (error) {\n        console.error('\u274C Failed to push context:', (error as Error).message);\n      } finally {\n        db.close();\n      }\n    });\n\n  // Pop context frame\n  context\n    .command('pop')\n    .description('Pop the top context frame from the stack')\n    .option('-a, --all', 'Pop all frames (clear stack)')\n    .action(async (options) => {\n      const projectRoot = process.cwd();\n      const dbPath = join(projectRoot, '.stackmemory', 'context.db');\n\n      if (!existsSync(dbPath)) {\n        console.log(\n          '\u274C StackMemory not initialized. Run \"stackmemory init\" first.'\n        );\n        return;\n      }\n\n      const db = new Database(dbPath);\n\n      try {\n        let projectId = 'default';\n        try {\n          const projectRow = db\n            .prepare(`SELECT value FROM metadata WHERE key = 'project_id'`)\n            .get() as any;\n          if (projectRow?.value) projectId = projectRow.value;\n        } catch {}\n\n        const frameManager = new FrameManager(db, projectId, { \n          skipContextBridge: true \n        });\n\n        const activePath = frameManager.getActiveFramePath();\n\n        if (activePath.length === 0) {\n          console.log('\uD83D\uDCDA Stack is already empty.');\n          return;\n        }\n\n        if (options.all) {\n          // Close all frames from top to bottom\n          for (let i = activePath.length - 1; i >= 0; i--) {\n            frameManager.closeFrame(activePath[i].frame_id);\n          }\n          console.log(`\u2705 Cleared all ${activePath.length} context frames.`);\n        } else {\n          // Close just the top frame\n          const topFrame = activePath[activePath.length - 1];\n          frameManager.closeFrame(topFrame.frame_id);\n          console.log(\n            `\u2705 Popped: ${topFrame.name || topFrame.frame_id.slice(0, 10)}`\n          );\n          console.log(`   Depth: ${frameManager.getStackDepth()}`);\n        }\n      } catch (error) {\n        console.error('\u274C Failed to pop context:', (error as Error).message);\n      } finally {\n        db.close();\n      }\n    });\n\n  // Add event to current context\n  context\n    .command('add <type> <message>')\n    .description(\n      'Add an event to current context (types: observation, decision, error)'\n    )\n    .action(async (type, message) => {\n      const projectRoot = process.cwd();\n      const dbPath = join(projectRoot, '.stackmemory', 'context.db');\n\n      if (!existsSync(dbPath)) {\n        console.log(\n          '\u274C StackMemory not initialized. Run \"stackmemory init\" first.'\n        );\n        return;\n      }\n\n      const db = new Database(dbPath);\n\n      try {\n        let projectId = 'default';\n        try {\n          const projectRow = db\n            .prepare(`SELECT value FROM metadata WHERE key = 'project_id'`)\n            .get() as any;\n          if (projectRow?.value) projectId = projectRow.value;\n        } catch {}\n\n        const frameManager = new FrameManager(db, projectId, { \n          skipContextBridge: true \n        });\n\n        const activePath = frameManager.getActiveFramePath();\n\n        if (activePath.length === 0) {\n          console.log('\u26A0\uFE0F No active context frame. Creating one...');\n          frameManager.createFrame({\n            type: 'task',\n            name: 'cli-session',\n            inputs: {},\n          });\n        }\n\n        const currentFrame = frameManager.getActiveFramePath().slice(-1)[0];\n\n        const validTypes = [\n          'observation',\n          'decision',\n          'error',\n          'action',\n          'result',\n        ];\n        if (!validTypes.includes(type)) {\n          console.log(`\u26A0\uFE0F Unknown event type \"${type}\". Using \"observation\".`);\n          type = 'observation';\n        }\n\n        frameManager.addEvent(\n          type,\n          { message, content: message },\n          currentFrame.frame_id\n        );\n\n        console.log(\n          `\u2705 Added ${type}: ${message.slice(0, 50)}${message.length > 50 ? '...' : ''}`\n        );\n      } catch (error) {\n        console.error('\u274C Failed to add event:', (error as Error).message);\n      } finally {\n        db.close();\n      }\n    });\n\n  // Worktree integration commands\n  context\n    .command('worktree [action]')\n    .description('Manage Claude worktree contexts')\n    .option('-i, --instance <id>', 'Instance ID')\n    .option('-b, --branch <name>', 'Branch name')\n    .option('-l, --list', 'List worktree contexts')\n    .action(async (action, options) => {\n      const projectRoot = process.cwd();\n      const dbPath = join(projectRoot, '.stackmemory', 'context.db');\n\n      if (!existsSync(dbPath)) {\n        console.log(\n          '\u274C StackMemory not initialized. Run \"stackmemory init\" first.'\n        );\n        return;\n      }\n\n      const db = new Database(dbPath);\n\n      try {\n        let projectId = 'default';\n        try {\n          const projectRow = db\n            .prepare(`SELECT value FROM metadata WHERE key = 'project_id'`)\n            .get() as any;\n          if (projectRow?.value) projectId = projectRow.value;\n        } catch {}\n\n        const frameManager = new FrameManager(db, projectId, { \n          skipContextBridge: true \n        });\n\n        if (options.list || action === 'list') {\n          // List all worktree contexts\n          const worktreeFrames = db\n            .prepare(\n              `\n              SELECT * FROM frames \n              WHERE project_id = ? \n              AND type = 'session' \n              AND inputs LIKE '%worktree%'\n              ORDER BY created_at DESC\n              LIMIT 10\n            `\n            )\n            .all(projectId) as any[];\n\n          console.log('\\n\uD83C\uDF33 Worktree Contexts\\n');\n          if (worktreeFrames.length === 0) {\n            console.log('No worktree contexts found.');\n          } else {\n            worktreeFrames.forEach((frame) => {\n              const inputs = JSON.parse(frame.inputs || '{}');\n              const instanceId = inputs.instanceId || 'unknown';\n              const branch = inputs.branch || 'unknown';\n              const created = new Date(\n                frame.created_at * 1000\n              ).toLocaleString();\n              console.log(`\uD83D\uDCCD ${frame.name || frame.frame_id.slice(0, 10)}`);\n              console.log(`   Instance: ${instanceId}`);\n              console.log(`   Branch: ${branch}`);\n              console.log(`   Created: ${created}`);\n              console.log('');\n            });\n          }\n        } else if (action === 'save') {\n          // Save current worktree context\n          const instanceId = options.instance || process.env.CLAUDE_INSTANCE_ID;\n          const branch = options.branch || 'unknown';\n\n          if (!instanceId) {\n            console.log('\u26A0\uFE0F No instance ID provided or detected.');\n            return;\n          }\n\n          const frameId = frameManager.createFrame({\n            type: 'task',\n            name: `worktree-${branch}`,\n            inputs: {\n              worktree: true,\n              instanceId,\n              branch,\n              path: process.cwd(),\n            },\n          });\n\n          console.log(`\u2705 Saved worktree context for ${branch}`);\n          console.log(`   Instance: ${instanceId}`);\n          console.log(`   Frame ID: ${frameId.slice(0, 10)}`);\n        } else if (action === 'load') {\n          // Load worktree context\n          const instanceId = options.instance || process.env.CLAUDE_INSTANCE_ID;\n\n          if (!instanceId) {\n            console.log('\u26A0\uFE0F No instance ID provided.');\n            return;\n          }\n\n          const worktreeFrame = db\n            .prepare(\n              `\n              SELECT * FROM frames \n              WHERE project_id = ? \n              AND type = 'session' \n              AND inputs LIKE ?\n              ORDER BY created_at DESC\n              LIMIT 1\n            `\n            )\n            .get(projectId, `%\"instanceId\":\"${instanceId}\"%`) as any;\n\n          if (worktreeFrame) {\n            const inputs = JSON.parse(worktreeFrame.inputs || '{}');\n            console.log(`\u2705 Loaded worktree context`);\n            console.log(`   Branch: ${inputs.branch}`);\n            console.log(`   Instance: ${inputs.instanceId}`);\n            console.log(`   Path: ${inputs.path}`);\n          } else {\n            console.log('\u26A0\uFE0F No worktree context found for this instance.');\n          }\n        } else {\n          console.log('Usage: stackmemory context worktree [save|load|list]');\n        }\n      } catch (error) {\n        console.error(\n          '\u274C Failed to manage worktree context:',\n          (error as Error).message\n        );\n      } finally {\n        db.close();\n      }\n    });\n\n  return context;\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * Context Commands for StackMemory CLI\n * Manage context stack (show, push, pop)\n */\n\nimport { Command } from 'commander';\nimport Database from 'better-sqlite3';\nimport { join } from 'path';\nimport { existsSync } from 'fs';\nimport { FrameManager, FrameType } from '../../core/context/frame-manager.js';\n// Type-safe environment variable access\nfunction getEnv(key: string, defaultValue?: string): string {\n  const value = process.env[key];\n  if (value === undefined) {\n    if (defaultValue !== undefined) return defaultValue;\n    throw new Error(`Environment variable ${key} is required`);\n  }\n  return value;\n}\n\nfunction getOptionalEnv(key: string): string | undefined {\n  return process.env[key];\n}\n\n\nexport function createContextCommands(): Command {\n  const context = new Command('context')\n    .alias('ctx')\n    .description('Manage context stack');\n\n  // Show current context\n  context\n    .command('show')\n    .alias('status')\n    .description('Show current context stack')\n    .option('-v, --verbose', 'Show detailed information')\n    .action(async (options) => {\n      const projectRoot = process.cwd();\n      const dbPath = join(projectRoot, '.stackmemory', 'context.db');\n\n      if (!existsSync(dbPath)) {\n        console.log(\n          '\u274C StackMemory not initialized. Run \"stackmemory init\" first.'\n        );\n        return;\n      }\n\n      const db = new Database(dbPath);\n\n      try {\n        // Get project ID - try metadata table, fallback to default\n        let projectId = 'default';\n        try {\n          const projectRow = db\n            .prepare(\n              `\n            SELECT value FROM metadata WHERE key = 'project_id'\n          `\n            )\n            .get() as any;\n          if (projectRow?.value) projectId = projectRow.value;\n        } catch {\n          // metadata table doesn't exist, use default\n        }\n\n        const frameManager = new FrameManager(db, projectId, { \n          skipContextBridge: true \n        });\n\n        const depth = frameManager.getStackDepth();\n        const activePath = frameManager.getActiveFramePath();\n\n        console.log(`\\n\uD83D\uDCDA Context Stack\\n`);\n        console.log(`Project: ${projectId}`);\n        console.log(`Depth: ${depth}`);\n        console.log(`Active frames: ${activePath.length}\\n`);\n\n        if (activePath.length === 0) {\n          console.log('No active context frames.\\n');\n          console.log('Use \"stackmemory context push\" to create one.');\n        } else {\n          const typeIcon: Record<string, string> = {\n            session: '\uD83D\uDD37',\n            task: '\uD83D\uDCCB',\n            command: '\u26A1',\n            file: '\uD83D\uDCC4',\n            decision: '\uD83D\uDCA1',\n          };\n\n          console.log('Stack (bottom to top):');\n          activePath.forEach((frame, i) => {\n            const icon = typeIcon[frame.type] || '\uD83D\uDCE6';\n            const indent = '  '.repeat(i);\n            console.log(\n              `${indent}${i === activePath.length - 1 ? '\u2514\u2500' : '\u251C\u2500'} ${icon} ${frame.name || frame.frame_id.slice(0, 10)}`\n            );\n\n            if (options.verbose) {\n              console.log(`${indent}   ID: ${frame.frame_id}`);\n              console.log(`${indent}   Type: ${frame.type}`);\n              console.log(\n                `${indent}   Created: ${new Date(frame.created_at * 1000).toLocaleString()}`\n              );\n            }\n          });\n        }\n\n        console.log('');\n      } catch (error: unknown) {\n        console.error('\u274C Failed to show context:', (error as Error).message);\n      } finally {\n        db.close();\n      }\n    });\n\n  // Push new context frame\n  context\n    .command('push <name>')\n    .description('Push a new context frame onto the stack')\n    .option(\n      '-t, --type <type>',\n      'Frame type (session, task, command, file, decision)',\n      'task'\n    )\n    .option('-m, --metadata <json>', 'Additional metadata as JSON')\n    .action(async (name, options) => {\n      const projectRoot = process.cwd();\n      const dbPath = join(projectRoot, '.stackmemory', 'context.db');\n\n      if (!existsSync(dbPath)) {\n        console.log(\n          '\u274C StackMemory not initialized. Run \"stackmemory init\" first.'\n        );\n        return;\n      }\n\n      const db = new Database(dbPath);\n\n      try {\n        let projectId = 'default';\n        try {\n          const projectRow = db\n            .prepare(`SELECT value FROM metadata WHERE key = 'project_id'`)\n            .get() as any;\n          if (projectRow?.value) projectId = projectRow.value;\n        } catch {}\n\n        const frameManager = new FrameManager(db, projectId, { \n          skipContextBridge: true \n        });\n\n        // Get current top frame as parent\n        const activePath = frameManager.getActiveFramePath();\n        const parentId =\n          activePath.length > 0\n            ? activePath[activePath.length - 1].frame_id\n            : undefined;\n\n        // Parse metadata if provided\n        let inputs = {};\n        if (options.metadata) {\n          try {\n            inputs = JSON.parse(options.metadata);\n          } catch {\n            console.log('\u26A0\uFE0F Invalid metadata JSON, ignoring');\n          }\n        }\n\n        const frameId = frameManager.createFrame({\n          type: options.type as FrameType,\n          name,\n          inputs,\n          parentFrameId: parentId,\n        });\n\n        console.log(`\u2705 Pushed context frame: ${name}`);\n        console.log(`   ID: ${frameId.slice(0, 10)}`);\n        console.log(`   Type: ${options.type}`);\n        console.log(`   Depth: ${frameManager.getStackDepth()}`);\n      } catch (error: unknown) {\n        console.error('\u274C Failed to push context:', (error as Error).message);\n      } finally {\n        db.close();\n      }\n    });\n\n  // Pop context frame\n  context\n    .command('pop')\n    .description('Pop the top context frame from the stack')\n    .option('-a, --all', 'Pop all frames (clear stack)')\n    .action(async (options) => {\n      const projectRoot = process.cwd();\n      const dbPath = join(projectRoot, '.stackmemory', 'context.db');\n\n      if (!existsSync(dbPath)) {\n        console.log(\n          '\u274C StackMemory not initialized. Run \"stackmemory init\" first.'\n        );\n        return;\n      }\n\n      const db = new Database(dbPath);\n\n      try {\n        let projectId = 'default';\n        try {\n          const projectRow = db\n            .prepare(`SELECT value FROM metadata WHERE key = 'project_id'`)\n            .get() as any;\n          if (projectRow?.value) projectId = projectRow.value;\n        } catch {}\n\n        const frameManager = new FrameManager(db, projectId, { \n          skipContextBridge: true \n        });\n\n        const activePath = frameManager.getActiveFramePath();\n\n        if (activePath.length === 0) {\n          console.log('\uD83D\uDCDA Stack is already empty.');\n          return;\n        }\n\n        if (options.all) {\n          // Close all frames from top to bottom\n          for (let i = activePath.length - 1; i >= 0; i--) {\n            frameManager.closeFrame(activePath[i].frame_id);\n          }\n          console.log(`\u2705 Cleared all ${activePath.length} context frames.`);\n        } else {\n          // Close just the top frame\n          const topFrame = activePath[activePath.length - 1];\n          frameManager.closeFrame(topFrame.frame_id);\n          console.log(\n            `\u2705 Popped: ${topFrame.name || topFrame.frame_id.slice(0, 10)}`\n          );\n          console.log(`   Depth: ${frameManager.getStackDepth()}`);\n        }\n      } catch (error: unknown) {\n        console.error('\u274C Failed to pop context:', (error as Error).message);\n      } finally {\n        db.close();\n      }\n    });\n\n  // Add event to current context\n  context\n    .command('add <type> <message>')\n    .description(\n      'Add an event to current context (types: observation, decision, error)'\n    )\n    .action(async (type, message) => {\n      const projectRoot = process.cwd();\n      const dbPath = join(projectRoot, '.stackmemory', 'context.db');\n\n      if (!existsSync(dbPath)) {\n        console.log(\n          '\u274C StackMemory not initialized. Run \"stackmemory init\" first.'\n        );\n        return;\n      }\n\n      const db = new Database(dbPath);\n\n      try {\n        let projectId = 'default';\n        try {\n          const projectRow = db\n            .prepare(`SELECT value FROM metadata WHERE key = 'project_id'`)\n            .get() as any;\n          if (projectRow?.value) projectId = projectRow.value;\n        } catch {}\n\n        const frameManager = new FrameManager(db, projectId, { \n          skipContextBridge: true \n        });\n\n        const activePath = frameManager.getActiveFramePath();\n\n        if (activePath.length === 0) {\n          console.log('\u26A0\uFE0F No active context frame. Creating one...');\n          frameManager.createFrame({\n            type: 'task',\n            name: 'cli-session',\n            inputs: {},\n          });\n        }\n\n        const currentFrame = frameManager.getActiveFramePath().slice(-1)[0];\n\n        const validTypes = [\n          'observation',\n          'decision',\n          'error',\n          'action',\n          'result',\n        ];\n        if (!validTypes.includes(type)) {\n          console.log(`\u26A0\uFE0F Unknown event type \"${type}\". Using \"observation\".`);\n          type = 'observation';\n        }\n\n        frameManager.addEvent(\n          type,\n          { message, content: message },\n          currentFrame.frame_id\n        );\n\n        console.log(\n          `\u2705 Added ${type}: ${message.slice(0, 50)}${message.length > 50 ? '...' : ''}`\n        );\n      } catch (error: unknown) {\n        console.error('\u274C Failed to add event:', (error as Error).message);\n      } finally {\n        db.close();\n      }\n    });\n\n  // Worktree integration commands\n  context\n    .command('worktree [action]')\n    .description('Manage Claude worktree contexts')\n    .option('-i, --instance <id>', 'Instance ID')\n    .option('-b, --branch <name>', 'Branch name')\n    .option('-l, --list', 'List worktree contexts')\n    .action(async (action, options) => {\n      const projectRoot = process.cwd();\n      const dbPath = join(projectRoot, '.stackmemory', 'context.db');\n\n      if (!existsSync(dbPath)) {\n        console.log(\n          '\u274C StackMemory not initialized. Run \"stackmemory init\" first.'\n        );\n        return;\n      }\n\n      const db = new Database(dbPath);\n\n      try {\n        let projectId = 'default';\n        try {\n          const projectRow = db\n            .prepare(`SELECT value FROM metadata WHERE key = 'project_id'`)\n            .get() as any;\n          if (projectRow?.value) projectId = projectRow.value;\n        } catch {}\n\n        const frameManager = new FrameManager(db, projectId, { \n          skipContextBridge: true \n        });\n\n        if (options.list || action === 'list') {\n          // List all worktree contexts\n          const worktreeFrames = db\n            .prepare(\n              `\n              SELECT * FROM frames \n              WHERE project_id = ? \n              AND type = 'session' \n              AND inputs LIKE '%worktree%'\n              ORDER BY created_at DESC\n              LIMIT 10\n            `\n            )\n            .all(projectId) as any[];\n\n          console.log('\\n\uD83C\uDF33 Worktree Contexts\\n');\n          if (worktreeFrames.length === 0) {\n            console.log('No worktree contexts found.');\n          } else {\n            worktreeFrames.forEach((frame) => {\n              const inputs = JSON.parse(frame.inputs || '{}');\n              const instanceId = inputs.instanceId || 'unknown';\n              const branch = inputs.branch || 'unknown';\n              const created = new Date(\n                frame.created_at * 1000\n              ).toLocaleString();\n              console.log(`\uD83D\uDCCD ${frame.name || frame.frame_id.slice(0, 10)}`);\n              console.log(`   Instance: ${instanceId}`);\n              console.log(`   Branch: ${branch}`);\n              console.log(`   Created: ${created}`);\n              console.log('');\n            });\n          }\n        } else if (action === 'save') {\n          // Save current worktree context\n          const instanceId = options.instance || process.env['CLAUDE_INSTANCE_ID'];\n          const branch = options.branch || 'unknown';\n\n          if (!instanceId) {\n            console.log('\u26A0\uFE0F No instance ID provided or detected.');\n            return;\n          }\n\n          const frameId = frameManager.createFrame({\n            type: 'task',\n            name: `worktree-${branch}`,\n            inputs: {\n              worktree: true,\n              instanceId,\n              branch,\n              path: process.cwd(),\n            },\n          });\n\n          console.log(`\u2705 Saved worktree context for ${branch}`);\n          console.log(`   Instance: ${instanceId}`);\n          console.log(`   Frame ID: ${frameId.slice(0, 10)}`);\n        } else if (action === 'load') {\n          // Load worktree context\n          const instanceId = options.instance || process.env['CLAUDE_INSTANCE_ID'];\n\n          if (!instanceId) {\n            console.log('\u26A0\uFE0F No instance ID provided.');\n            return;\n          }\n\n          const worktreeFrame = db\n            .prepare(\n              `\n              SELECT * FROM frames \n              WHERE project_id = ? \n              AND type = 'session' \n              AND inputs LIKE ?\n              ORDER BY created_at DESC\n              LIMIT 1\n            `\n            )\n            .get(projectId, `%\"instanceId\":\"${instanceId}\"%`) as any;\n\n          if (worktreeFrame) {\n            const inputs = JSON.parse(worktreeFrame.inputs || '{}');\n            console.log(`\u2705 Loaded worktree context`);\n            console.log(`   Branch: ${inputs.branch}`);\n            console.log(`   Instance: ${inputs.instanceId}`);\n            console.log(`   Path: ${inputs.path}`);\n          } else {\n            console.log('\u26A0\uFE0F No worktree context found for this instance.');\n          }\n        } else {\n          console.log('Usage: stackmemory context worktree [save|load|list]');\n        }\n      } catch (error: unknown) {\n        console.error(\n          '\u274C Failed to manage worktree context:',\n          (error as Error).message\n        );\n      } finally {\n        db.close();\n      }\n    });\n\n  return context;\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/cli/commands/dashboard.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/cli/commands/dashboard.ts"],
-  "sourcesContent": ["#!/usr/bin/env node\n/**\n * Dashboard Command - Display monitoring dashboard in terminal\n */\n\nimport chalk from 'chalk';\nimport Table from 'cli-table3';\nimport { SessionManager } from '../../core/session/session-manager.js';\nimport { FrameManager } from '../../core/context/frame-manager.js';\nimport Database from 'better-sqlite3';\nimport { join } from 'path';\nimport { existsSync } from 'fs';\n\nexport const dashboardCommand = {\n  command: 'dashboard',\n  describe: 'Display monitoring dashboard in terminal',\n  builder: (yargs: any) => {\n    return yargs\n      .option('watch', {\n        alias: 'w',\n        type: 'boolean',\n        description: 'Auto-refresh dashboard',\n        default: false\n      })\n      .option('interval', {\n        alias: 'i',\n        type: 'number',\n        description: 'Refresh interval in seconds',\n        default: 5\n      });\n  },\n  handler: async (argv: any) => {\n    const projectRoot = process.cwd();\n    const dbPath = join(projectRoot, '.stackmemory', 'context.db');\n\n    if (!existsSync(dbPath)) {\n      console.log('\u274C StackMemory not initialized. Run \"stackmemory init\" first.');\n      return;\n    }\n\n    const displayDashboard = async () => {\n      console.clear();\n      \n      // Header\n      console.log(chalk.cyan.bold('\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550'));\n      console.log(chalk.cyan.bold('         \uD83D\uDE80 StackMemory Monitoring Dashboard          '));\n      console.log(chalk.cyan.bold('\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550'));\n      console.log();\n\n      const sessionManager = new SessionManager({ enableMonitoring: false });\n      await sessionManager.initialize();\n      \n      const db = new Database(dbPath);\n\n      // Get sessions\n      const sessions = await sessionManager.listSessions({ \n        state: 'active',\n        limit: 5 \n      });\n      \n      // Sessions Table\n      const sessionsTable = new Table({\n        head: [\n          chalk.white('Session ID'),\n          chalk.white('Status'),\n          chalk.white('Branch'),\n          chalk.white('Duration'),\n          chalk.white('Last Active')\n        ],\n        style: { head: [], border: [] }\n      });\n\n      sessions.forEach(session => {\n        const duration = Math.round((Date.now() - session.startedAt) / 1000 / 60);\n        const lastActive = Math.round((Date.now() - session.lastActiveAt) / 1000 / 60);\n        const status = session.state === 'active' \n          ? chalk.green('\u25CF Active')\n          : session.state === 'completed'\n          ? chalk.gray('\u25CF Completed')\n          : chalk.yellow('\u25CF Idle');\n\n        sessionsTable.push([\n          session.sessionId.substring(0, 8),\n          status,\n          session.branch || 'main',\n          `${duration}m`,\n          `${lastActive}m ago`\n        ]);\n      });\n\n      console.log(chalk.yellow.bold('\uD83D\uDCCA Active Sessions'));\n      console.log(sessionsTable.toString());\n      console.log();\n\n      // Frame Statistics\n      const frameStats = db.prepare(`\n        SELECT \n          COUNT(*) as total,\n          SUM(CASE WHEN state = 'active' THEN 1 ELSE 0 END) as active,\n          COUNT(DISTINCT run_id) as sessions\n        FROM frames\n      `).get() as any;\n\n      const statsTable = new Table({\n        head: [chalk.white('Metric'), chalk.white('Value')],\n        style: { head: [], border: [] }\n      });\n\n      statsTable.push(\n        ['Total Frames', frameStats.total || 0],\n        ['Active Frames', chalk.green(frameStats.active || 0)],\n        ['Total Sessions', frameStats.sessions || 0]\n      );\n\n      console.log(chalk.yellow.bold('\uD83D\uDCC8 Frame Statistics'));\n      console.log(statsTable.toString());\n      console.log();\n\n      // Recent Activity\n      const recentActivity = db.prepare(`\n        SELECT \n          name,\n          type,\n          state,\n          datetime(created_at, 'unixepoch') as created\n        FROM frames\n        ORDER BY created_at DESC\n        LIMIT 5\n      `).all() as any[];\n\n      if (recentActivity.length > 0) {\n        const activityTable = new Table({\n          head: [\n            chalk.white('Frame'),\n            chalk.white('Type'),\n            chalk.white('Status'),\n            chalk.white('Created')\n          ],\n          style: { head: [], border: [] }\n        });\n\n        recentActivity.forEach(frame => {\n          const status = frame.state === 'active'\n            ? chalk.green('Active')\n            : chalk.gray('Closed');\n          \n          activityTable.push([\n            frame.name.substring(0, 30),\n            frame.type,\n            status,\n            frame.created\n          ]);\n        });\n\n        console.log(chalk.yellow.bold('\uD83D\uDD50 Recent Activity'));\n        console.log(activityTable.toString());\n        console.log();\n      }\n\n      // Memory Usage\n      const contextUsage = await estimateContextUsage(db);\n      const usageBar = createProgressBar(contextUsage, 100);\n      \n      console.log(chalk.yellow.bold('\uD83D\uDCBE Context Usage'));\n      console.log(`${usageBar} ${contextUsage}%`);\n      console.log();\n\n      db.close();\n\n      // Footer\n      if (argv.watch) {\n        console.log(chalk.gray(`Auto-refreshing every ${argv.interval} seconds. Press Ctrl+C to exit.`));\n      } else {\n        console.log(chalk.gray('Run with --watch to auto-refresh'));\n      }\n    };\n\n    try {\n      await displayDashboard();\n\n      if (argv.watch) {\n        const interval = setInterval(async () => {\n          await displayDashboard();\n        }, argv.interval * 1000);\n\n        process.on('SIGINT', () => {\n          clearInterval(interval);\n          console.clear();\n          console.log(chalk.green('\u2705 Dashboard closed'));\n          process.exit(0);\n        });\n      }\n    } catch (error) {\n      console.error(chalk.red('\u274C Dashboard error:'), (error as Error).message);\n      process.exit(1);\n    }\n  }\n};\n\nfunction createProgressBar(value: number, max: number): string {\n  const percentage = Math.min(100, Math.round((value / max) * 100));\n  const filled = Math.round(percentage / 5);\n  const empty = 20 - filled;\n  \n  let color = chalk.green;\n  if (percentage > 80) color = chalk.red;\n  else if (percentage > 60) color = chalk.yellow;\n  \n  return color('\u2588'.repeat(filled)) + chalk.gray('\u2591'.repeat(empty));\n}\n\nasync function estimateContextUsage(db: Database): Promise<number> {\n  const result = db.prepare(`\n    SELECT \n      COUNT(*) as frame_count,\n      SUM(LENGTH(inputs)) as input_size,\n      SUM(LENGTH(outputs)) as output_size\n    FROM frames\n    WHERE state = 'active'\n  `).get() as any;\n\n  // Rough estimate: assume average token is 4 bytes\n  const totalBytes = (result.input_size || 0) + (result.output_size || 0);\n  const estimatedTokens = totalBytes / 4;\n  const maxTokens = 128000; // Claude's context window\n  \n  return Math.round((estimatedTokens / maxTokens) * 100);\n}"],
-  "mappings": "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",
+  "sourcesContent": ["#!/usr/bin/env node\n/**\n * Dashboard Command - Display monitoring dashboard in terminal\n */\n\nimport chalk from 'chalk';\nimport Table from 'cli-table3';\nimport { SessionManager } from '../../core/session/session-manager.js';\nimport { FrameManager } from '../../core/context/frame-manager.js';\nimport Database from 'better-sqlite3';\nimport { join } from 'path';\nimport { existsSync } from 'fs';\n\nexport const dashboardCommand = {\n  command: 'dashboard',\n  describe: 'Display monitoring dashboard in terminal',\n  builder: (yargs: any) => {\n    return yargs\n      .option('watch', {\n        alias: 'w',\n        type: 'boolean',\n        description: 'Auto-refresh dashboard',\n        default: false\n      })\n      .option('interval', {\n        alias: 'i',\n        type: 'number',\n        description: 'Refresh interval in seconds',\n        default: 5\n      });\n  },\n  handler: async (argv: any) => {\n    const projectRoot = process.cwd();\n    const dbPath = join(projectRoot, '.stackmemory', 'context.db');\n\n    if (!existsSync(dbPath)) {\n      console.log('\u274C StackMemory not initialized. Run \"stackmemory init\" first.');\n      return;\n    }\n\n    const displayDashboard = async () => {\n      console.clear();\n      \n      // Header\n      console.log(chalk.cyan.bold('\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550'));\n      console.log(chalk.cyan.bold('         \uD83D\uDE80 StackMemory Monitoring Dashboard          '));\n      console.log(chalk.cyan.bold('\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550'));\n      console.log();\n\n      const sessionManager = new SessionManager({ enableMonitoring: false });\n      await sessionManager.initialize();\n      \n      const db = new Database(dbPath);\n\n      // Get sessions\n      const sessions = await sessionManager.listSessions({ \n        state: 'active',\n        limit: 5 \n      });\n      \n      // Sessions Table\n      const sessionsTable = new Table({\n        head: [\n          chalk.white('Session ID'),\n          chalk.white('Status'),\n          chalk.white('Branch'),\n          chalk.white('Duration'),\n          chalk.white('Last Active')\n        ],\n        style: { head: [], border: [] }\n      });\n\n      sessions.forEach(session => {\n        const duration = Math.round((Date.now() - session.startedAt) / 1000 / 60);\n        const lastActive = Math.round((Date.now() - session.lastActiveAt) / 1000 / 60);\n        const status = session.state === 'active' \n          ? chalk.green('\u25CF Active')\n          : session.state === 'completed'\n          ? chalk.gray('\u25CF Completed')\n          : chalk.yellow('\u25CF Idle');\n\n        sessionsTable.push([\n          session.sessionId.substring(0, 8),\n          status,\n          session.branch || 'main',\n          `${duration}m`,\n          `${lastActive}m ago`\n        ]);\n      });\n\n      console.log(chalk.yellow.bold('\uD83D\uDCCA Active Sessions'));\n      console.log(sessionsTable.toString());\n      console.log();\n\n      // Frame Statistics\n      const frameStats = db.prepare(`\n        SELECT \n          COUNT(*) as total,\n          SUM(CASE WHEN state = 'active' THEN 1 ELSE 0 END) as active,\n          COUNT(DISTINCT run_id) as sessions\n        FROM frames\n      `).get() as any;\n\n      const statsTable = new Table({\n        head: [chalk.white('Metric'), chalk.white('Value')],\n        style: { head: [], border: [] }\n      });\n\n      statsTable.push(\n        ['Total Frames', frameStats.total || 0],\n        ['Active Frames', chalk.green(frameStats.active || 0)],\n        ['Total Sessions', frameStats.sessions || 0]\n      );\n\n      console.log(chalk.yellow.bold('\uD83D\uDCC8 Frame Statistics'));\n      console.log(statsTable.toString());\n      console.log();\n\n      // Recent Activity\n      const recentActivity = db.prepare(`\n        SELECT \n          name,\n          type,\n          state,\n          datetime(created_at, 'unixepoch') as created\n        FROM frames\n        ORDER BY created_at DESC\n        LIMIT 5\n      `).all() as any[];\n\n      if (recentActivity.length > 0) {\n        const activityTable = new Table({\n          head: [\n            chalk.white('Frame'),\n            chalk.white('Type'),\n            chalk.white('Status'),\n            chalk.white('Created')\n          ],\n          style: { head: [], border: [] }\n        });\n\n        recentActivity.forEach(frame => {\n          const status = frame.state === 'active'\n            ? chalk.green('Active')\n            : chalk.gray('Closed');\n          \n          activityTable.push([\n            frame.name.substring(0, 30),\n            frame.type,\n            status,\n            frame.created\n          ]);\n        });\n\n        console.log(chalk.yellow.bold('\uD83D\uDD50 Recent Activity'));\n        console.log(activityTable.toString());\n        console.log();\n      }\n\n      // Memory Usage\n      const contextUsage = await estimateContextUsage(db);\n      const usageBar = createProgressBar(contextUsage, 100);\n      \n      console.log(chalk.yellow.bold('\uD83D\uDCBE Context Usage'));\n      console.log(`${usageBar} ${contextUsage}%`);\n      console.log();\n\n      db.close();\n\n      // Footer\n      if (argv.watch) {\n        console.log(chalk.gray(`Auto-refreshing every ${argv.interval} seconds. Press Ctrl+C to exit.`));\n      } else {\n        console.log(chalk.gray('Run with --watch to auto-refresh'));\n      }\n    };\n\n    try {\n      await displayDashboard();\n\n      if (argv.watch) {\n        const interval = setInterval(async () => {\n          await displayDashboard();\n        }, argv.interval * 1000);\n\n        process.on('SIGINT', () => {\n          clearInterval(interval);\n          console.clear();\n          console.log(chalk.green('\u2705 Dashboard closed'));\n          process.exit(0);\n        });\n      }\n    } catch (error: unknown) {\n      console.error(chalk.red('\u274C Dashboard error:'), (error as Error).message);\n      process.exit(1);\n    }\n  }\n};\n\nfunction createProgressBar(value: number, max: number): string {\n  const percentage = Math.min(100, Math.round((value / max) * 100));\n  const filled = Math.round(percentage / 5);\n  const empty = 20 - filled;\n  \n  let color = chalk.green;\n  if (percentage > 80) color = chalk.red;\n  else if (percentage > 60) color = chalk.yellow;\n  \n  return color('\u2588'.repeat(filled)) + chalk.gray('\u2591'.repeat(empty));\n}\n\nasync function estimateContextUsage(db: Database): Promise<number> {\n  const result = db.prepare(`\n    SELECT \n      COUNT(*) as frame_count,\n      SUM(LENGTH(inputs)) as input_size,\n      SUM(LENGTH(outputs)) as output_size\n    FROM frames\n    WHERE state = 'active'\n  `).get() as any;\n\n  // Rough estimate: assume average token is 4 bytes\n  const totalBytes = (result.input_size || 0) + (result.output_size || 0);\n  const estimatedTokens = totalBytes / 4;\n  const maxTokens = 128000; // Claude's context window\n  \n  return Math.round((estimatedTokens / maxTokens) * 100);\n}"],
+  "mappings": "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",
   "names": []
 }

package/dist/cli/commands/gc.js

@@ -0,0 +1,202 @@
+import { Command } from "commander";
+import chalk from "chalk";
+import ora from "ora";
+import Table from "cli-table3";
+import { IncrementalGarbageCollector } from "../../core/context/incremental-gc.js";
+import { FrameManager } from "../../core/context/frame-manager.js";
+import { Logger } from "../../core/monitoring/logger.js";
+const logger = new Logger("GC-CLI");
+function createGCCommand() {
+  const gc = new Command("gc").description("Manage incremental garbage collection system").alias("garbage-collect");
+  gc.command("status").description("Show garbage collection statistics").action(async () => {
+    const spinner = ora("Getting GC status...").start();
+    try {
+      const frameManager = new FrameManager();
+      const collector = new IncrementalGarbageCollector(frameManager);
+      const stats = collector.getStats();
+      spinner.stop();
+      console.log(chalk.cyan("\n\u{1F5D1}\uFE0F  Incremental Garbage Collection Status\n"));
+      const table = new Table({
+        head: ["Metric", "Value"],
+        colWidths: [25, 20]
+      });
+      table.push(
+        ["Total Frames", stats.totalFrames.toString()],
+        ["Collected Frames", stats.collectedFrames.toString()],
+        ["Collection Cycles", stats.cycleCount.toString()],
+        ["Avg Cycle Time", `${stats.avgCycleTime.toFixed(2)}ms`],
+        ["Protected Frames", stats.protectedFrames.toString()],
+        ["Last Run", stats.lastRunTime ? new Date(stats.lastRunTime).toLocaleString() : "Never"]
+      );
+      console.log(table.toString());
+      if (stats.totalFrames > 0) {
+        const collectionRate = (stats.collectedFrames / stats.totalFrames * 100).toFixed(1);
+        const protectionRate = (stats.protectedFrames / stats.totalFrames * 100).toFixed(1);
+        console.log("\n\u{1F4CA} Collection Efficiency:");
+        console.log(`  Collection Rate: ${collectionRate}%`);
+        console.log(`  Protection Rate: ${protectionRate}%`);
+      }
+    } catch (error) {
+      spinner.fail("Failed to get GC status");
+      logger.error("GC status error", error);
+      console.error(chalk.red(error instanceof Error ? error.message : "Unknown error"));
+    }
+  });
+  gc.command("collect").description("Run manual garbage collection cycle").option("--dry-run", "Show what would be collected without actually collecting").action(async (options) => {
+    const spinner = ora("Running garbage collection...").start();
+    try {
+      const frameManager = new FrameManager();
+      const collector = new IncrementalGarbageCollector(frameManager);
+      if (options.dryRun) {
+        spinner.text = "Analyzing collection candidates (dry run)...";
+        spinner.succeed("Dry run completed - check logs for details");
+      } else {
+        await collector.forceCollection();
+        const stats = collector.getStats();
+        spinner.succeed(`Collection completed - collected ${stats.collectedFrames} frames`);
+        console.log(chalk.green("\n\u2705 Manual collection completed"));
+        console.log(`   Processed: ${stats.totalFrames} frames`);
+        console.log(`   Collected: ${stats.collectedFrames} frames`);
+        console.log(`   Protected: ${stats.protectedFrames} frames`);
+      }
+    } catch (error) {
+      spinner.fail("Collection failed");
+      logger.error("GC collection error", error);
+      console.error(chalk.red(error instanceof Error ? error.message : "Unknown error"));
+    }
+  });
+  gc.command("start").description("Start incremental GC daemon").option("--interval <seconds>", "Collection interval in seconds", "60").option("--frames-per-cycle <number>", "Frames to process per cycle", "100").action(async (options) => {
+    const spinner = ora("Starting GC daemon...").start();
+    try {
+      const frameManager = new FrameManager();
+      const collector = new IncrementalGarbageCollector(frameManager, {
+        cycleInterval: parseInt(options.interval) * 1e3,
+        framesPerCycle: parseInt(options.framesPerCycle)
+      });
+      collector.start();
+      spinner.succeed("GC daemon started");
+      console.log(chalk.green("\n\u{1F680} Incremental GC daemon is running"));
+      console.log(`   Interval: ${options.interval}s`);
+      console.log(`   Frames per cycle: ${options.framesPerCycle}`);
+      console.log("\nPress Ctrl+C to stop");
+      process.on("SIGINT", () => {
+        console.log("\n\u23F9\uFE0F  Stopping GC daemon...");
+        collector.stop();
+        process.exit(0);
+      });
+      await new Promise(() => {
+      });
+    } catch (error) {
+      spinner.fail("Failed to start GC daemon");
+      logger.error("GC start error", error);
+      console.error(chalk.red(error instanceof Error ? error.message : "Unknown error"));
+    }
+  });
+  gc.command("config").description("View or update GC configuration").option("--set-interval <seconds>", "Set collection interval").option("--set-frames-per-cycle <number>", "Set frames per cycle").option("--set-max-age <days>", "Set max frame age before collection").action(async (options) => {
+    try {
+      const frameManager = new FrameManager();
+      const collector = new IncrementalGarbageCollector(frameManager);
+      if (options.setInterval || options.setFramesPerCycle || options.setMaxAge) {
+        const newConfig = {};
+        if (options.setInterval) newConfig.cycleInterval = parseInt(options.setInterval) * 1e3;
+        if (options.setFramesPerCycle) newConfig.framesPerCycle = parseInt(options.setFramesPerCycle);
+        if (options.setMaxAge) newConfig.maxAge = parseInt(options.setMaxAge) * 24 * 60 * 60 * 1e3;
+        collector.updateConfig(newConfig);
+        console.log(chalk.green("\u2705 Configuration updated"));
+      }
+      console.log(chalk.cyan("\n\u2699\uFE0F  Current GC Configuration\n"));
+      console.log("Cycle Interval: 60s");
+      console.log("Frames per Cycle: 100");
+      console.log("Max Age: 30 days");
+      console.log("\nGenerations:");
+      console.log("  Young: < 1 day");
+      console.log("  Mature: 1-7 days");
+      console.log("  Old: 7-30 days");
+    } catch (error) {
+      logger.error("GC config error", error);
+      console.error(chalk.red(error instanceof Error ? error.message : "Unknown error"));
+    }
+  });
+  gc.command("analyze").description("Analyze frame distribution and collection opportunities").action(async () => {
+    const spinner = ora("Analyzing frames...").start();
+    try {
+      const frameManager = new FrameManager();
+      const allFrames = await frameManager.getAllFrames();
+      if (allFrames.length === 0) {
+        spinner.succeed("No frames to analyze");
+        return;
+      }
+      const now = Date.now();
+      const analysis = {
+        total: allFrames.length,
+        active: 0,
+        closed: 0,
+        young: 0,
+        mature: 0,
+        old: 0,
+        withOutputs: 0,
+        withoutOutputs: 0,
+        rootFrames: 0,
+        leafFrames: 0
+      };
+      for (const frame of allFrames) {
+        const age = now - frame.created_at;
+        if (frame.state === "active") analysis.active++;
+        else analysis.closed++;
+        if (age < 24 * 60 * 60 * 1e3) analysis.young++;
+        else if (age < 7 * 24 * 60 * 60 * 1e3) analysis.mature++;
+        else analysis.old++;
+        if (frame.outputs && Object.keys(frame.outputs).length > 0) {
+          analysis.withOutputs++;
+        } else {
+          analysis.withoutOutputs++;
+        }
+        if (frame.depth === 0) analysis.rootFrames++;
+        if (!allFrames.some((f) => f.parent_frame_id === frame.frame_id)) {
+          analysis.leafFrames++;
+        }
+      }
+      spinner.stop();
+      console.log(chalk.cyan("\n\u{1F4CA} Frame Distribution Analysis\n"));
+      const stateTable = new Table({
+        head: ["Category", "Count", "Percentage"],
+        colWidths: [20, 10, 15]
+      });
+      const pct = (count) => `${(count / analysis.total * 100).toFixed(1)}%`;
+      stateTable.push(
+        ["Active Frames", analysis.active.toString(), pct(analysis.active)],
+        ["Closed Frames", analysis.closed.toString(), pct(analysis.closed)],
+        ["", "", ""],
+        ["Young (< 1 day)", analysis.young.toString(), pct(analysis.young)],
+        ["Mature (1-7 days)", analysis.mature.toString(), pct(analysis.mature)],
+        ["Old (> 7 days)", analysis.old.toString(), pct(analysis.old)],
+        ["", "", ""],
+        ["With Outputs", analysis.withOutputs.toString(), pct(analysis.withOutputs)],
+        ["Without Outputs", analysis.withoutOutputs.toString(), pct(analysis.withoutOutputs)],
+        ["", "", ""],
+        ["Root Frames", analysis.rootFrames.toString(), pct(analysis.rootFrames)],
+        ["Leaf Frames", analysis.leafFrames.toString(), pct(analysis.leafFrames)]
+      );
+      console.log(stateTable.toString());
+      console.log(chalk.yellow("\n\u{1F4A1} Collection Recommendations:\n"));
+      const candidatesForCollection = analysis.closed + analysis.withoutOutputs;
+      console.log(`\u2022 Potential collection candidates: ${candidatesForCollection} frames`);
+      console.log(`\u2022 Estimated space savings: ${(candidatesForCollection / analysis.total * 100).toFixed(1)}%`);
+      if (analysis.old > 0) {
+        console.log(`\u2022 ${analysis.old} old frames ready for collection`);
+      }
+      if (analysis.withoutOutputs > 0) {
+        console.log(`\u2022 ${analysis.withoutOutputs} frames without outputs can be collected`);
+      }
+    } catch (error) {
+      spinner.fail("Analysis failed");
+      logger.error("GC analysis error", error);
+      console.error(chalk.red(error instanceof Error ? error.message : "Unknown error"));
+    }
+  });
+  return gc;
+}
+export {
+  createGCCommand
+};
+//# sourceMappingURL=gc.js.map

package/dist/cli/commands/gc.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/cli/commands/gc.ts"],
+  "sourcesContent": ["/**\n * CLI commands for Incremental Garbage Collection management\n */\n\nimport { Command } from 'commander';\nimport chalk from 'chalk';\nimport ora from 'ora';\nimport Table from 'cli-table3';\nimport { IncrementalGarbageCollector } from '../../core/context/incremental-gc.js';\nimport { FrameManager } from '../../core/context/frame-manager.js';\nimport { Logger } from '../../core/monitoring/logger.js';\n\nconst logger = new Logger('GC-CLI');\n\nexport function createGCCommand(): Command {\n  const gc = new Command('gc')\n    .description('Manage incremental garbage collection system')\n    .alias('garbage-collect');\n\n  // Status command\n  gc.command('status')\n    .description('Show garbage collection statistics')\n    .action(async () => {\n      const spinner = ora('Getting GC status...').start();\n\n      try {\n        const frameManager = new FrameManager();\n        const collector = new IncrementalGarbageCollector(frameManager);\n        \n        const stats = collector.getStats();\n        spinner.stop();\n\n        console.log(chalk.cyan('\\n\uD83D\uDDD1\uFE0F  Incremental Garbage Collection Status\\n'));\n\n        const table = new Table({\n          head: ['Metric', 'Value'],\n          colWidths: [25, 20],\n        });\n\n        table.push(\n          ['Total Frames', stats.totalFrames.toString()],\n          ['Collected Frames', stats.collectedFrames.toString()],\n          ['Collection Cycles', stats.cycleCount.toString()],\n          ['Avg Cycle Time', `${stats.avgCycleTime.toFixed(2)}ms`],\n          ['Protected Frames', stats.protectedFrames.toString()],\n          ['Last Run', stats.lastRunTime ? new Date(stats.lastRunTime).toLocaleString() : 'Never']\n        );\n\n        console.log(table.toString());\n\n        // Show efficiency metrics\n        if (stats.totalFrames > 0) {\n          const collectionRate = ((stats.collectedFrames / stats.totalFrames) * 100).toFixed(1);\n          const protectionRate = ((stats.protectedFrames / stats.totalFrames) * 100).toFixed(1);\n          \n          console.log('\\n\uD83D\uDCCA Collection Efficiency:');\n          console.log(`  Collection Rate: ${collectionRate}%`);\n          console.log(`  Protection Rate: ${protectionRate}%`);\n        }\n\n      } catch (error: unknown) {\n        spinner.fail('Failed to get GC status');\n        logger.error('GC status error', error);\n        console.error(chalk.red(error instanceof Error ? error.message : 'Unknown error'));\n      }\n    });\n\n  // Manual collection command  \n  gc.command('collect')\n    .description('Run manual garbage collection cycle')\n    .option('--dry-run', 'Show what would be collected without actually collecting')\n    .action(async (options) => {\n      const spinner = ora('Running garbage collection...').start();\n\n      try {\n        const frameManager = new FrameManager();\n        const collector = new IncrementalGarbageCollector(frameManager);\n        \n        if (options.dryRun) {\n          spinner.text = 'Analyzing collection candidates (dry run)...';\n          // TODO: Implement dry run mode\n          spinner.succeed('Dry run completed - check logs for details');\n        } else {\n          await collector.forceCollection();\n          const stats = collector.getStats();\n          \n          spinner.succeed(`Collection completed - collected ${stats.collectedFrames} frames`);\n          \n          console.log(chalk.green('\\n\u2705 Manual collection completed'));\n          console.log(`   Processed: ${stats.totalFrames} frames`);\n          console.log(`   Collected: ${stats.collectedFrames} frames`);\n          console.log(`   Protected: ${stats.protectedFrames} frames`);\n        }\n\n      } catch (error: unknown) {\n        spinner.fail('Collection failed');\n        logger.error('GC collection error', error);\n        console.error(chalk.red(error instanceof Error ? error.message : 'Unknown error'));\n      }\n    });\n\n  // Start/stop daemon commands\n  gc.command('start')\n    .description('Start incremental GC daemon')\n    .option('--interval <seconds>', 'Collection interval in seconds', '60')\n    .option('--frames-per-cycle <number>', 'Frames to process per cycle', '100')\n    .action(async (options) => {\n      const spinner = ora('Starting GC daemon...').start();\n\n      try {\n        const frameManager = new FrameManager();\n        const collector = new IncrementalGarbageCollector(frameManager, {\n          cycleInterval: parseInt(options.interval) * 1000,\n          framesPerCycle: parseInt(options.framesPerCycle)\n        });\n        \n        collector.start();\n        \n        spinner.succeed('GC daemon started');\n        console.log(chalk.green('\\n\uD83D\uDE80 Incremental GC daemon is running'));\n        console.log(`   Interval: ${options.interval}s`);\n        console.log(`   Frames per cycle: ${options.framesPerCycle}`);\n        console.log('\\nPress Ctrl+C to stop');\n        \n        // Keep process alive\n        process.on('SIGINT', () => {\n          console.log('\\n\u23F9\uFE0F  Stopping GC daemon...');\n          collector.stop();\n          process.exit(0);\n        });\n        \n        // Keep the process running\n        await new Promise(() => {}); // Run forever\n\n      } catch (error: unknown) {\n        spinner.fail('Failed to start GC daemon');\n        logger.error('GC start error', error);\n        console.error(chalk.red(error instanceof Error ? error.message : 'Unknown error'));\n      }\n    });\n\n  // Configuration command\n  gc.command('config')\n    .description('View or update GC configuration')\n    .option('--set-interval <seconds>', 'Set collection interval')\n    .option('--set-frames-per-cycle <number>', 'Set frames per cycle')\n    .option('--set-max-age <days>', 'Set max frame age before collection')\n    .action(async (options) => {\n      try {\n        const frameManager = new FrameManager();\n        const collector = new IncrementalGarbageCollector(frameManager);\n        \n        if (options.setInterval || options.setFramesPerCycle || options.setMaxAge) {\n          // Update configuration\n          const newConfig: any = {};\n          if (options.setInterval) newConfig.cycleInterval = parseInt(options.setInterval) * 1000;\n          if (options.setFramesPerCycle) newConfig.framesPerCycle = parseInt(options.setFramesPerCycle);\n          if (options.setMaxAge) newConfig.maxAge = parseInt(options.setMaxAge) * 24 * 60 * 60 * 1000;\n          \n          collector.updateConfig(newConfig);\n          console.log(chalk.green('\u2705 Configuration updated'));\n        }\n\n        // Show current config\n        console.log(chalk.cyan('\\n\u2699\uFE0F  Current GC Configuration\\n'));\n        console.log('Cycle Interval: 60s');\n        console.log('Frames per Cycle: 100');\n        console.log('Max Age: 30 days');\n        console.log('\\nGenerations:');\n        console.log('  Young: < 1 day');\n        console.log('  Mature: 1-7 days');\n        console.log('  Old: 7-30 days');\n\n      } catch (error: unknown) {\n        logger.error('GC config error', error);\n        console.error(chalk.red(error instanceof Error ? error.message : 'Unknown error'));\n      }\n    });\n\n  // Analysis command\n  gc.command('analyze')\n    .description('Analyze frame distribution and collection opportunities')\n    .action(async () => {\n      const spinner = ora('Analyzing frames...').start();\n\n      try {\n        const frameManager = new FrameManager();\n        const allFrames = await frameManager.getAllFrames();\n        \n        if (allFrames.length === 0) {\n          spinner.succeed('No frames to analyze');\n          return;\n        }\n\n        // Analyze frame distribution\n        const now = Date.now();\n        const analysis = {\n          total: allFrames.length,\n          active: 0,\n          closed: 0,\n          young: 0,\n          mature: 0,\n          old: 0,\n          withOutputs: 0,\n          withoutOutputs: 0,\n          rootFrames: 0,\n          leafFrames: 0\n        };\n\n        for (const frame of allFrames) {\n          const age = now - frame.created_at;\n          \n          // State analysis\n          if (frame.state === 'active') analysis.active++;\n          else analysis.closed++;\n          \n          // Age analysis\n          if (age < 24 * 60 * 60 * 1000) analysis.young++;\n          else if (age < 7 * 24 * 60 * 60 * 1000) analysis.mature++;\n          else analysis.old++;\n          \n          // Output analysis\n          if (frame.outputs && Object.keys(frame.outputs).length > 0) {\n            analysis.withOutputs++;\n          } else {\n            analysis.withoutOutputs++;\n          }\n          \n          // Hierarchy analysis\n          if (frame.depth === 0) analysis.rootFrames++;\n          if (!allFrames.some(f => f.parent_frame_id === frame.frame_id)) {\n            analysis.leafFrames++;\n          }\n        }\n\n        spinner.stop();\n\n        console.log(chalk.cyan('\\n\uD83D\uDCCA Frame Distribution Analysis\\n'));\n\n        const stateTable = new Table({\n          head: ['Category', 'Count', 'Percentage'],\n          colWidths: [20, 10, 15],\n        });\n\n        const pct = (count: number) => `${((count / analysis.total) * 100).toFixed(1)}%`;\n\n        stateTable.push(\n          ['Active Frames', analysis.active.toString(), pct(analysis.active)],\n          ['Closed Frames', analysis.closed.toString(), pct(analysis.closed)],\n          ['', '', ''],\n          ['Young (< 1 day)', analysis.young.toString(), pct(analysis.young)],\n          ['Mature (1-7 days)', analysis.mature.toString(), pct(analysis.mature)],\n          ['Old (> 7 days)', analysis.old.toString(), pct(analysis.old)],\n          ['', '', ''],\n          ['With Outputs', analysis.withOutputs.toString(), pct(analysis.withOutputs)],\n          ['Without Outputs', analysis.withoutOutputs.toString(), pct(analysis.withoutOutputs)],\n          ['', '', ''],\n          ['Root Frames', analysis.rootFrames.toString(), pct(analysis.rootFrames)],\n          ['Leaf Frames', analysis.leafFrames.toString(), pct(analysis.leafFrames)]\n        );\n\n        console.log(stateTable.toString());\n\n        // Collection recommendations\n        console.log(chalk.yellow('\\n\uD83D\uDCA1 Collection Recommendations:\\n'));\n        const candidatesForCollection = analysis.closed + analysis.withoutOutputs;\n        console.log(`\u2022 Potential collection candidates: ${candidatesForCollection} frames`);\n        console.log(`\u2022 Estimated space savings: ${((candidatesForCollection / analysis.total) * 100).toFixed(1)}%`);\n        \n        if (analysis.old > 0) {\n          console.log(`\u2022 ${analysis.old} old frames ready for collection`);\n        }\n        if (analysis.withoutOutputs > 0) {\n          console.log(`\u2022 ${analysis.withoutOutputs} frames without outputs can be collected`);\n        }\n\n      } catch (error: unknown) {\n        spinner.fail('Analysis failed');\n        logger.error('GC analysis error', error);\n        console.error(chalk.red(error instanceof Error ? error.message : 'Unknown error'));\n      }\n    });\n\n  return gc;\n}"],
+  "mappings": "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",
+  "names": []
+}

package/dist/cli/commands/handoff.js

@@ -6,6 +6,17 @@ import Database from "better-sqlite3";
 import { FrameManager } from "../../core/context/frame-manager.js";
 import { PebblesTaskStore } from "../../features/tasks/pebbles-task-store.js";
 import { logger } from "../../core/monitoring/logger.js";
+function getEnv(key, defaultValue) {
+  const value = process.env[key];
+  if (value === void 0) {
+    if (defaultValue !== void 0) return defaultValue;
+    throw new Error(`Environment variable ${key} is required`);
+  }
+  return value;
+}
+function getOptionalEnv(key) {
+  return process.env[key];
+}
 function createHandoffCommand() {
   const cmd = new Command("handoff");
   cmd.description("Session handoff for continuity between Claude sessions");
@@ -209,7 +220,7 @@ Generated by stackmemory handoff at ${timestamp}
         "last-handoff.md"
       );
       const metaPath = join(
-        process.env.HOME || "~",
+        process.env["HOME"] || "~",
         ".stackmemory",
         "handoffs",
         "last-handoff-meta.json"