@stackmemoryai/stackmemory 0.5.1 → 0.5.2

package/dist/core/session/enhanced-handoff.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/core/session/enhanced-handoff.ts"],
+  "sourcesContent": ["/**\n * Enhanced Handoff Generator\n * Produces high-efficacy handoffs (70-85% context preservation)\n * Target: 2,000-3,000 tokens for rich context\n */\n\nimport { execSync } from 'child_process';\nimport {\n  existsSync,\n  readFileSync,\n  readdirSync,\n  statSync,\n  writeFileSync,\n  mkdirSync,\n} from 'fs';\nimport { join, basename } from 'path';\nimport { homedir, tmpdir } from 'os';\nimport { globSync } from 'glob';\n\n// Token counting - use Anthropic's tokenizer for accurate counts\nlet countTokens: (text: string) => number;\ntry {\n  // Dynamic import for CommonJS compatibility\n  const tokenizer = await import('@anthropic-ai/tokenizer');\n  countTokens = tokenizer.countTokens;\n} catch {\n  // Fallback to estimation if tokenizer not available\n  countTokens = (text: string) => Math.ceil(text.length / 3.5);\n}\n\n// Load session decisions if available\ninterface SessionDecision {\n  id: string;\n  what: string;\n  why: string;\n  alternatives?: string[];\n  timestamp: string;\n  category?: string;\n}\n\n// Review feedback persistence\ninterface StoredReviewFeedback {\n  timestamp: string;\n  source: string;\n  keyPoints: string[];\n  actionItems: string[];\n  sourceFile?: string;\n}\n\ninterface ReviewFeedbackStore {\n  feedbacks: StoredReviewFeedback[];\n  lastUpdated: string;\n}\n\nfunction loadSessionDecisions(projectRoot: string): SessionDecision[] {\n  const storePath = join(projectRoot, '.stackmemory', 'session-decisions.json');\n  if (existsSync(storePath)) {\n    try {\n      const store = JSON.parse(readFileSync(storePath, 'utf-8'));\n      return store.decisions || [];\n    } catch {\n      return [];\n    }\n  }\n  return [];\n}\n\nfunction loadReviewFeedback(projectRoot: string): StoredReviewFeedback[] {\n  const storePath = join(projectRoot, '.stackmemory', 'review-feedback.json');\n  if (existsSync(storePath)) {\n    try {\n      const store: ReviewFeedbackStore = JSON.parse(\n        readFileSync(storePath, 'utf-8')\n      );\n      // Return feedbacks from last 24 hours\n      const cutoff = Date.now() - 24 * 60 * 60 * 1000;\n      return store.feedbacks.filter(\n        (f) => new Date(f.timestamp).getTime() > cutoff\n      );\n    } catch {\n      return [];\n    }\n  }\n  return [];\n}\n\nfunction saveReviewFeedback(\n  projectRoot: string,\n  feedbacks: StoredReviewFeedback[]\n): void {\n  const dir = join(projectRoot, '.stackmemory');\n  if (!existsSync(dir)) {\n    mkdirSync(dir, { recursive: true });\n  }\n\n  const storePath = join(dir, 'review-feedback.json');\n\n  // Load existing and merge\n  let existing: StoredReviewFeedback[] = [];\n  if (existsSync(storePath)) {\n    try {\n      const store: ReviewFeedbackStore = JSON.parse(\n        readFileSync(storePath, 'utf-8')\n      );\n      existing = store.feedbacks || [];\n    } catch {\n      // Ignore parse errors\n    }\n  }\n\n  // Deduplicate by source + first key point\n  const seen = new Set<string>();\n  const merged: StoredReviewFeedback[] = [];\n\n  for (const f of [...feedbacks, ...existing]) {\n    const key = `${f.source}:${f.keyPoints[0] || ''}`;\n    if (!seen.has(key)) {\n      seen.add(key);\n      merged.push(f);\n    }\n  }\n\n  // Keep only last 20 feedbacks\n  const store: ReviewFeedbackStore = {\n    feedbacks: merged.slice(0, 20),\n    lastUpdated: new Date().toISOString(),\n  };\n\n  writeFileSync(storePath, JSON.stringify(store, null, 2));\n}\n\n/**\n * Find Claude agent output directories dynamically\n */\nfunction findAgentOutputDirs(projectRoot: string): string[] {\n  const dirs: string[] = [];\n\n  // Try multiple locations where agent outputs might be stored\n  const tmpBase = process.env['TMPDIR'] || tmpdir() || '/tmp';\n\n  // Pattern 1: /tmp/claude/-path-to-project/tasks\n  const projectPathEncoded = projectRoot.replace(/\\//g, '-').replace(/^-/, '');\n  const pattern1 = join(tmpBase, 'claude', `*${projectPathEncoded}*`, 'tasks');\n  try {\n    const matches = globSync(pattern1);\n    dirs.push(...matches);\n  } catch {\n    // Glob failed\n  }\n\n  // Pattern 2: /private/tmp/claude/... (macOS specific)\n  if (tmpBase !== '/private/tmp') {\n    const pattern2 = join(\n      '/private/tmp',\n      'claude',\n      `*${projectPathEncoded}*`,\n      'tasks'\n    );\n    try {\n      const matches = globSync(pattern2);\n      dirs.push(...matches);\n    } catch {\n      // Glob failed\n    }\n  }\n\n  // Pattern 3: ~/.claude/projects/*/tasks (if exists)\n  const homeClaudeDir = join(homedir(), '.claude', 'projects');\n  if (existsSync(homeClaudeDir)) {\n    try {\n      const projectDirs = readdirSync(homeClaudeDir);\n      for (const d of projectDirs) {\n        const tasksDir = join(homeClaudeDir, d, 'tasks');\n        if (existsSync(tasksDir)) {\n          dirs.push(tasksDir);\n        }\n      }\n    } catch {\n      // Failed to read\n    }\n  }\n\n  return [...new Set(dirs)]; // Deduplicate\n}\n\nexport interface EnhancedHandoff {\n  // Metadata\n  timestamp: string;\n  project: string;\n  branch: string;\n  sessionDuration?: string;\n\n  // What we're building (HIGH VALUE)\n  activeWork: {\n    description: string;\n    status: 'in_progress' | 'blocked' | 'review' | 'done';\n    keyFiles: string[];\n    progress?: string;\n  };\n\n  // Decisions made (HIGH VALUE)\n  decisions: Array<{\n    what: string;\n    why: string;\n    alternatives?: string[];\n  }>;\n\n  // Architecture context (MEDIUM VALUE)\n  architecture: {\n    keyComponents: Array<{\n      file: string;\n      purpose: string;\n    }>;\n    patterns: string[];\n  };\n\n  // Blockers and issues (HIGH VALUE)\n  blockers: Array<{\n    issue: string;\n    attempted: string[];\n    status: 'resolved' | 'open';\n  }>;\n\n  // Review feedback (HIGH VALUE if present)\n  reviewFeedback?: {\n    source: string;\n    keyPoints: string[];\n    actionItems: string[];\n  }[];\n\n  // Next actions (MEDIUM VALUE)\n  nextActions: string[];\n\n  // Patterns established (LOW-MEDIUM VALUE)\n  codePatterns?: string[];\n\n  // Token metrics\n  estimatedTokens: number;\n}\n\nexport class EnhancedHandoffGenerator {\n  private projectRoot: string;\n  private claudeProjectsDir: string;\n\n  constructor(projectRoot: string) {\n    this.projectRoot = projectRoot;\n    this.claudeProjectsDir = join(homedir(), '.claude', 'projects');\n  }\n\n  /**\n   * Generate a high-efficacy handoff\n   */\n  async generate(): Promise<EnhancedHandoff> {\n    const handoff: EnhancedHandoff = {\n      timestamp: new Date().toISOString(),\n      project: basename(this.projectRoot),\n      branch: this.getCurrentBranch(),\n      activeWork: await this.extractActiveWork(),\n      decisions: await this.extractDecisions(),\n      architecture: await this.extractArchitecture(),\n      blockers: await this.extractBlockers(),\n      reviewFeedback: await this.extractReviewFeedback(),\n      nextActions: await this.extractNextActions(),\n      codePatterns: await this.extractCodePatterns(),\n      estimatedTokens: 0,\n    };\n\n    // Calculate estimated tokens\n    const markdown = this.toMarkdown(handoff);\n    handoff.estimatedTokens = countTokens(markdown);\n\n    return handoff;\n  }\n\n  /**\n   * Extract what we're currently building from git and recent files\n   */\n  private async extractActiveWork(): Promise<EnhancedHandoff['activeWork']> {\n    // Get recent commits to understand current work\n    const recentCommits = this.getRecentCommits(5);\n    const recentFiles = this.getRecentlyModifiedFiles(10);\n\n    // Try to infer the active work from commit messages\n    let description = 'Unknown - check git log for context';\n    let status: EnhancedHandoff['activeWork']['status'] = 'in_progress';\n\n    if (recentCommits.length > 0) {\n      // Use most recent commit as indicator\n      const lastCommit = recentCommits[0];\n      if (lastCommit.includes('feat:') || lastCommit.includes('implement')) {\n        description = lastCommit.replace(/^[a-f0-9]+\\s+/, '');\n      } else if (lastCommit.includes('fix:')) {\n        description = 'Bug fix: ' + lastCommit.replace(/^[a-f0-9]+\\s+/, '');\n      } else if (\n        lastCommit.includes('chore:') ||\n        lastCommit.includes('refactor:')\n      ) {\n        description = lastCommit.replace(/^[a-f0-9]+\\s+/, '');\n      } else {\n        description = lastCommit.replace(/^[a-f0-9]+\\s+/, '');\n      }\n    }\n\n    // Check for blocking indicators\n    const gitStatus = this.getGitStatus();\n    if (gitStatus.includes('conflict')) {\n      status = 'blocked';\n    }\n\n    return {\n      description,\n      status,\n      keyFiles: recentFiles.slice(0, 5),\n      progress:\n        recentCommits.length > 0\n          ? `${recentCommits.length} commits in current session`\n          : undefined,\n    };\n  }\n\n  /**\n   * Extract decisions from session store, git commits, and decision logs\n   */\n  private async extractDecisions(): Promise<EnhancedHandoff['decisions']> {\n    const decisions: EnhancedHandoff['decisions'] = [];\n\n    // First, load session decisions (highest priority - explicitly recorded)\n    const sessionDecisions = loadSessionDecisions(this.projectRoot);\n    for (const d of sessionDecisions) {\n      decisions.push({\n        what: d.what,\n        why: d.why,\n        alternatives: d.alternatives,\n      });\n    }\n\n    // Then look for decision markers in recent commits\n    const commits = this.getRecentCommits(20);\n    for (const commit of commits) {\n      // Look for decision-like patterns\n      if (\n        commit.toLowerCase().includes('use ') ||\n        commit.toLowerCase().includes('switch to ') ||\n        commit.toLowerCase().includes('default to ') ||\n        (commit.toLowerCase().includes('make ') &&\n          commit.toLowerCase().includes('optional'))\n      ) {\n        // Avoid duplicates\n        const commitText = commit.replace(/^[a-f0-9]+\\s+/, '');\n        if (!decisions.some((d) => d.what.includes(commitText.slice(0, 30)))) {\n          decisions.push({\n            what: commitText,\n            why: 'See commit for details',\n          });\n        }\n      }\n    }\n\n    // Check for a decisions file\n    const decisionsFile = join(\n      this.projectRoot,\n      '.stackmemory',\n      'decisions.md'\n    );\n    if (existsSync(decisionsFile)) {\n      const content = readFileSync(decisionsFile, 'utf-8');\n      const parsed = this.parseDecisionsFile(content);\n      decisions.push(...parsed);\n    }\n\n    return decisions.slice(0, 10); // Limit to prevent bloat\n  }\n\n  /**\n   * Parse a decisions.md file\n   */\n  private parseDecisionsFile(content: string): EnhancedHandoff['decisions'] {\n    const decisions: EnhancedHandoff['decisions'] = [];\n    const lines = content.split('\\n');\n\n    let currentDecision: {\n      what: string;\n      why: string;\n      alternatives?: string[];\n    } | null = null;\n\n    for (const line of lines) {\n      if (line.startsWith('## ') || line.startsWith('### ')) {\n        if (currentDecision) {\n          decisions.push(currentDecision);\n        }\n        currentDecision = { what: line.replace(/^#+\\s+/, ''), why: '' };\n      } else if (currentDecision && line.toLowerCase().includes('rationale:')) {\n        currentDecision.why = line.replace(/rationale:\\s*/i, '').trim();\n      } else if (currentDecision && line.toLowerCase().includes('why:')) {\n        currentDecision.why = line.replace(/why:\\s*/i, '').trim();\n      } else if (\n        currentDecision &&\n        line.toLowerCase().includes('alternatives:')\n      ) {\n        currentDecision.alternatives = [];\n      } else if (currentDecision?.alternatives && line.trim().startsWith('-')) {\n        currentDecision.alternatives.push(line.replace(/^\\s*-\\s*/, '').trim());\n      }\n    }\n\n    if (currentDecision) {\n      decisions.push(currentDecision);\n    }\n\n    return decisions;\n  }\n\n  /**\n   * Extract architecture context from key files\n   */\n  private async extractArchitecture(): Promise<\n    EnhancedHandoff['architecture']\n  > {\n    const keyComponents: EnhancedHandoff['architecture']['keyComponents'] = [];\n    const patterns: string[] = [];\n\n    // Find recently modified TypeScript/JavaScript files\n    const recentFiles = this.getRecentlyModifiedFiles(20);\n    const codeFiles = recentFiles.filter(\n      (f) => f.endsWith('.ts') || f.endsWith('.js') || f.endsWith('.tsx')\n    );\n\n    for (const file of codeFiles.slice(0, 8)) {\n      const purpose = this.inferFilePurpose(file);\n      if (purpose) {\n        keyComponents.push({ file, purpose });\n      }\n    }\n\n    // Detect patterns from file structure\n    if (codeFiles.some((f) => f.includes('/daemon/'))) {\n      patterns.push('Daemon/background process pattern');\n    }\n    if (codeFiles.some((f) => f.includes('/cli/'))) {\n      patterns.push('CLI command pattern');\n    }\n    if (\n      codeFiles.some((f) => f.includes('.test.') || f.includes('__tests__'))\n    ) {\n      patterns.push('Test files present');\n    }\n    if (codeFiles.some((f) => f.includes('/core/'))) {\n      patterns.push('Core/domain separation');\n    }\n\n    return { keyComponents, patterns };\n  }\n\n  /**\n   * Infer purpose from file name and path\n   */\n  private inferFilePurpose(filePath: string): string | null {\n    const name = basename(filePath).replace(/\\.(ts|js|tsx)$/, '');\n    const path = filePath.toLowerCase();\n\n    if (path.includes('daemon')) return 'Background daemon/service';\n    if (path.includes('cli/command')) return 'CLI command handler';\n    if (path.includes('config')) return 'Configuration management';\n    if (path.includes('storage')) return 'Data storage layer';\n    if (path.includes('handoff')) return 'Session handoff logic';\n    if (path.includes('service')) return 'Service orchestration';\n    if (path.includes('manager')) return 'Resource/state management';\n    if (path.includes('handler')) return 'Event/request handler';\n    if (path.includes('util') || path.includes('helper'))\n      return 'Utility functions';\n    if (path.includes('types') || path.includes('interface'))\n      return 'Type definitions';\n    if (path.includes('test')) return null; // Skip test files\n    if (name.includes('-')) {\n      return name\n        .split('-')\n        .map((w) => w.charAt(0).toUpperCase() + w.slice(1))\n        .join(' ');\n    }\n    return null;\n  }\n\n  /**\n   * Extract blockers from git status and recent errors\n   */\n  private async extractBlockers(): Promise<EnhancedHandoff['blockers']> {\n    const blockers: EnhancedHandoff['blockers'] = [];\n\n    // Check for merge conflicts\n    const gitStatus = this.getGitStatus();\n    if (gitStatus.includes('UU ') || gitStatus.includes('both modified')) {\n      blockers.push({\n        issue: 'Merge conflict detected',\n        attempted: ['Check git status for affected files'],\n        status: 'open',\n      });\n    }\n\n    // Check for failing tests\n    try {\n      const testResult = execSync('npm test 2>&1 || true', {\n        encoding: 'utf-8',\n        cwd: this.projectRoot,\n        timeout: 30000,\n      });\n      if (testResult.includes('FAIL') || testResult.includes('failed')) {\n        const failCount = (testResult.match(/(\\d+) failed/i) || ['', '?'])[1];\n        blockers.push({\n          issue: `Test failures: ${failCount} tests failing`,\n          attempted: ['Run npm test for details'],\n          status: 'open',\n        });\n      }\n    } catch {\n      // Test command failed - might indicate issues\n    }\n\n    // Check for lint errors\n    try {\n      const lintResult = execSync('npm run lint 2>&1 || true', {\n        encoding: 'utf-8',\n        cwd: this.projectRoot,\n        timeout: 30000,\n      });\n      if (lintResult.includes('error') && !lintResult.includes('0 errors')) {\n        blockers.push({\n          issue: 'Lint errors present',\n          attempted: ['Run npm run lint for details'],\n          status: 'open',\n        });\n      }\n    } catch {\n      // Lint command failed\n    }\n\n    return blockers;\n  }\n\n  /**\n   * Extract review feedback from agent output files and persisted storage\n   */\n  private async extractReviewFeedback(): Promise<\n    EnhancedHandoff['reviewFeedback']\n  > {\n    const feedback: EnhancedHandoff['reviewFeedback'] = [];\n    const newFeedbacks: StoredReviewFeedback[] = [];\n\n    // Find agent output directories dynamically\n    const outputDirs = findAgentOutputDirs(this.projectRoot);\n\n    for (const tmpDir of outputDirs) {\n      if (!existsSync(tmpDir)) continue;\n\n      try {\n        const files = readdirSync(tmpDir).filter((f) => f.endsWith('.output'));\n        const recentFiles = files\n          .map((f) => ({\n            name: f,\n            path: join(tmpDir, f),\n            stat: statSync(join(tmpDir, f)),\n          }))\n          .filter((f) => Date.now() - f.stat.mtimeMs < 3600000) // Last hour\n          .sort((a, b) => b.stat.mtimeMs - a.stat.mtimeMs)\n          .slice(0, 3);\n\n        for (const file of recentFiles) {\n          const content = readFileSync(file.path, 'utf-8');\n          const extracted = this.extractKeyPointsFromReview(content);\n          if (extracted.keyPoints.length > 0) {\n            feedback.push(extracted);\n\n            // Also store for persistence\n            newFeedbacks.push({\n              timestamp: new Date().toISOString(),\n              source: extracted.source,\n              keyPoints: extracted.keyPoints,\n              actionItems: extracted.actionItems,\n              sourceFile: file.name,\n            });\n          }\n        }\n      } catch {\n        // Failed to read agent outputs from this directory\n      }\n    }\n\n    // Save new feedback to persistent storage\n    if (newFeedbacks.length > 0) {\n      saveReviewFeedback(this.projectRoot, newFeedbacks);\n    }\n\n    // Load persisted feedback if no new feedback found\n    if (feedback.length === 0) {\n      const stored = loadReviewFeedback(this.projectRoot);\n      for (const s of stored.slice(0, 3)) {\n        feedback.push({\n          source: s.source,\n          keyPoints: s.keyPoints,\n          actionItems: s.actionItems,\n        });\n      }\n    }\n\n    return feedback.length > 0 ? feedback : undefined;\n  }\n\n  /**\n   * Extract key points from a review output\n   */\n  private extractKeyPointsFromReview(content: string): {\n    source: string;\n    keyPoints: string[];\n    actionItems: string[];\n  } {\n    const keyPoints: string[] = [];\n    const actionItems: string[] = [];\n    let source = 'Agent Review';\n\n    // Detect review type\n    if (\n      content.includes('Product Manager') ||\n      content.includes('product-manager')\n    ) {\n      source = 'Product Manager';\n    } else if (\n      content.includes('Staff Architect') ||\n      content.includes('staff-architect')\n    ) {\n      source = 'Staff Architect';\n    }\n\n    // Extract key recommendations (look for common patterns)\n    const lines = content.split('\\n');\n    let inRecommendations = false;\n    let inActionItems = false;\n\n    for (const line of lines) {\n      const trimmed = line.trim();\n\n      // Detect section headers\n      if (\n        trimmed.toLowerCase().includes('recommendation') ||\n        trimmed.toLowerCase().includes('key finding')\n      ) {\n        inRecommendations = true;\n        inActionItems = false;\n        continue;\n      }\n      if (\n        trimmed.toLowerCase().includes('action') ||\n        trimmed.toLowerCase().includes('next step') ||\n        trimmed.toLowerCase().includes('priority')\n      ) {\n        inActionItems = true;\n        inRecommendations = false;\n        continue;\n      }\n\n      // Extract bullet points\n      if (\n        trimmed.startsWith('- ') ||\n        trimmed.startsWith('* ') ||\n        /^\\d+\\.\\s/.test(trimmed)\n      ) {\n        const point = trimmed.replace(/^[-*]\\s+/, '').replace(/^\\d+\\.\\s+/, '');\n        if (point.length > 10 && point.length < 200) {\n          if (inActionItems) {\n            actionItems.push(point);\n          } else if (inRecommendations) {\n            keyPoints.push(point);\n          }\n        }\n      }\n    }\n\n    // Limit to prevent bloat\n    return {\n      source,\n      keyPoints: keyPoints.slice(0, 5),\n      actionItems: actionItems.slice(0, 5),\n    };\n  }\n\n  /**\n   * Extract next actions from todo state and git\n   */\n  private async extractNextActions(): Promise<string[]> {\n    const actions: string[] = [];\n\n    // Check for uncommitted changes\n    const gitStatus = this.getGitStatus();\n    if (gitStatus.trim()) {\n      actions.push('Commit pending changes');\n    }\n\n    // Look for TODO comments in recent files\n    const recentFiles = this.getRecentlyModifiedFiles(5);\n    for (const file of recentFiles) {\n      try {\n        const fullPath = join(this.projectRoot, file);\n        if (existsSync(fullPath)) {\n          const content = readFileSync(fullPath, 'utf-8');\n          const todos = content.match(/\\/\\/\\s*TODO:?\\s*.+/gi) || [];\n          for (const todo of todos.slice(0, 2)) {\n            actions.push(todo.replace(/\\/\\/\\s*TODO:?\\s*/i, 'TODO: '));\n          }\n        }\n      } catch {\n        // Skip unreadable files\n      }\n    }\n\n    // Check for pending tasks in .stackmemory\n    const tasksFile = join(this.projectRoot, '.stackmemory', 'tasks.json');\n    if (existsSync(tasksFile)) {\n      try {\n        const tasks = JSON.parse(readFileSync(tasksFile, 'utf-8'));\n        const pending = tasks.filter(\n          (t: any) => t.status === 'pending' || t.status === 'in_progress'\n        );\n        for (const task of pending.slice(0, 3)) {\n          actions.push(task.title || task.description);\n        }\n      } catch {\n        // Invalid tasks file\n      }\n    }\n\n    return actions.slice(0, 8);\n  }\n\n  /**\n   * Extract established code patterns\n   */\n  private async extractCodePatterns(): Promise<string[]> {\n    const patterns: string[] = [];\n\n    // Check ESLint config for patterns\n    const eslintConfig = join(this.projectRoot, 'eslint.config.js');\n    if (existsSync(eslintConfig)) {\n      const content = readFileSync(eslintConfig, 'utf-8');\n      if (content.includes('argsIgnorePattern')) {\n        patterns.push('Underscore prefix for unused vars (_var)');\n      }\n      if (content.includes('ignores') && content.includes('test')) {\n        patterns.push('Test files excluded from lint');\n      }\n    }\n\n    // Check tsconfig for patterns\n    const tsconfig = join(this.projectRoot, 'tsconfig.json');\n    if (existsSync(tsconfig)) {\n      const content = readFileSync(tsconfig, 'utf-8');\n      if (content.includes('\"strict\": true')) {\n        patterns.push('TypeScript strict mode enabled');\n      }\n      if (content.includes('ES2022') || content.includes('ESNext')) {\n        patterns.push('ESM module system');\n      }\n    }\n\n    return patterns;\n  }\n\n  /**\n   * Get recent git commits\n   */\n  private getRecentCommits(count: number): string[] {\n    try {\n      const result = execSync(`git log --oneline -${count}`, {\n        encoding: 'utf-8',\n        cwd: this.projectRoot,\n      });\n      return result.trim().split('\\n').filter(Boolean);\n    } catch {\n      return [];\n    }\n  }\n\n  /**\n   * Get current git branch\n   */\n  private getCurrentBranch(): string {\n    try {\n      return execSync('git rev-parse --abbrev-ref HEAD', {\n        encoding: 'utf-8',\n        cwd: this.projectRoot,\n      }).trim();\n    } catch {\n      return 'unknown';\n    }\n  }\n\n  /**\n   * Get git status\n   */\n  private getGitStatus(): string {\n    try {\n      return execSync('git status --short', {\n        encoding: 'utf-8',\n        cwd: this.projectRoot,\n      });\n    } catch {\n      return '';\n    }\n  }\n\n  /**\n   * Get recently modified files\n   */\n  private getRecentlyModifiedFiles(count: number): string[] {\n    try {\n      const result = execSync(\n        `git diff --name-only HEAD~10 HEAD 2>/dev/null || git diff --name-only`,\n        {\n          encoding: 'utf-8',\n          cwd: this.projectRoot,\n        }\n      );\n      return result.trim().split('\\n').filter(Boolean).slice(0, count);\n    } catch {\n      return [];\n    }\n  }\n\n  /**\n   * Convert handoff to markdown\n   */\n  toMarkdown(handoff: EnhancedHandoff): string {\n    const lines: string[] = [];\n\n    lines.push(`# Session Handoff - ${handoff.timestamp.split('T')[0]}`);\n    lines.push('');\n    lines.push(`**Project**: ${handoff.project}`);\n    lines.push(`**Branch**: ${handoff.branch}`);\n    lines.push('');\n\n    // Active Work (HIGH VALUE)\n    lines.push('## Active Work');\n    lines.push(`- **Building**: ${handoff.activeWork.description}`);\n    lines.push(`- **Status**: ${handoff.activeWork.status}`);\n    if (handoff.activeWork.keyFiles.length > 0) {\n      lines.push(`- **Key files**: ${handoff.activeWork.keyFiles.join(', ')}`);\n    }\n    if (handoff.activeWork.progress) {\n      lines.push(`- **Progress**: ${handoff.activeWork.progress}`);\n    }\n    lines.push('');\n\n    // Decisions (HIGH VALUE)\n    if (handoff.decisions.length > 0) {\n      lines.push('## Key Decisions');\n      for (const d of handoff.decisions) {\n        lines.push(`1. **${d.what}**`);\n        if (d.why) {\n          lines.push(`   - Rationale: ${d.why}`);\n        }\n        if (d.alternatives && d.alternatives.length > 0) {\n          lines.push(\n            `   - Alternatives considered: ${d.alternatives.join(', ')}`\n          );\n        }\n      }\n      lines.push('');\n    }\n\n    // Architecture (MEDIUM VALUE)\n    if (handoff.architecture.keyComponents.length > 0) {\n      lines.push('## Architecture Context');\n      for (const c of handoff.architecture.keyComponents) {\n        lines.push(`- \\`${c.file}\\`: ${c.purpose}`);\n      }\n      if (handoff.architecture.patterns.length > 0) {\n        lines.push('');\n        lines.push('**Patterns**: ' + handoff.architecture.patterns.join(', '));\n      }\n      lines.push('');\n    }\n\n    // Blockers (HIGH VALUE)\n    if (handoff.blockers.length > 0) {\n      lines.push('## Blockers');\n      for (const b of handoff.blockers) {\n        lines.push(`- **${b.issue}** [${b.status}]`);\n        if (b.attempted.length > 0) {\n          lines.push(`  - Tried: ${b.attempted.join(', ')}`);\n        }\n      }\n      lines.push('');\n    }\n\n    // Review Feedback (HIGH VALUE)\n    if (handoff.reviewFeedback && handoff.reviewFeedback.length > 0) {\n      lines.push('## Review Feedback');\n      for (const r of handoff.reviewFeedback) {\n        lines.push(`### ${r.source}`);\n        if (r.keyPoints.length > 0) {\n          lines.push('**Key Points**:');\n          for (const p of r.keyPoints) {\n            lines.push(`- ${p}`);\n          }\n        }\n        if (r.actionItems.length > 0) {\n          lines.push('**Action Items**:');\n          for (const a of r.actionItems) {\n            lines.push(`- ${a}`);\n          }\n        }\n        lines.push('');\n      }\n    }\n\n    // Next Actions (MEDIUM VALUE)\n    if (handoff.nextActions.length > 0) {\n      lines.push('## Next Actions');\n      for (const a of handoff.nextActions) {\n        lines.push(`1. ${a}`);\n      }\n      lines.push('');\n    }\n\n    // Code Patterns (LOW VALUE)\n    if (handoff.codePatterns && handoff.codePatterns.length > 0) {\n      lines.push('## Established Patterns');\n      for (const p of handoff.codePatterns) {\n        lines.push(`- ${p}`);\n      }\n      lines.push('');\n    }\n\n    lines.push('---');\n    lines.push(`*Estimated tokens: ~${handoff.estimatedTokens}*`);\n    lines.push(`*Generated at ${handoff.timestamp}*`);\n\n    return lines.join('\\n');\n  }\n}\n"],
+  "mappings": "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",
+  "names": ["store"]
+}

package/dist/daemon/session-daemon.js

@@ -0,0 +1,308 @@
+#!/usr/bin/env node
+import * as fs from "fs";
+import * as path from "path";
+import { execSync } from "child_process";
+class SessionDaemon {
+  config;
+  state;
+  stackmemoryDir;
+  sessionsDir;
+  logsDir;
+  pidFile;
+  heartbeatFile;
+  logFile;
+  saveInterval = null;
+  heartbeatInterval = null;
+  activityCheckInterval = null;
+  isShuttingDown = false;
+  constructor(sessionId2, options2) {
+    const homeDir = process.env["HOME"] || process.env["USERPROFILE"] || "";
+    this.stackmemoryDir = path.join(homeDir, ".stackmemory");
+    this.sessionsDir = path.join(this.stackmemoryDir, "sessions");
+    this.logsDir = path.join(this.stackmemoryDir, "logs");
+    this.config = {
+      sessionId: sessionId2,
+      saveIntervalMs: options2?.saveIntervalMs ?? 15 * 60 * 1e3,
+      inactivityTimeoutMs: options2?.inactivityTimeoutMs ?? 30 * 60 * 1e3,
+      heartbeatIntervalMs: options2?.heartbeatIntervalMs ?? 60 * 1e3
+    };
+    this.pidFile = path.join(this.sessionsDir, `${sessionId2}.pid`);
+    this.heartbeatFile = path.join(this.sessionsDir, `${sessionId2}.heartbeat`);
+    this.logFile = path.join(this.logsDir, "daemon.log");
+    this.state = {
+      startTime: Date.now(),
+      lastSaveTime: Date.now(),
+      lastActivityTime: Date.now(),
+      saveCount: 0,
+      errors: []
+    };
+    this.ensureDirectories();
+  }
+  ensureDirectories() {
+    [this.sessionsDir, this.logsDir].forEach((dir) => {
+      if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+      }
+    });
+  }
+  log(level, message, data) {
+    const entry = {
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      level,
+      sessionId: this.config.sessionId,
+      message,
+      data
+    };
+    const logLine = JSON.stringify(entry) + "\n";
+    try {
+      fs.appendFileSync(this.logFile, logLine);
+    } catch {
+      console.error(`[${entry.timestamp}] ${level}: ${message}`, data);
+    }
+  }
+  checkIdempotency() {
+    if (fs.existsSync(this.pidFile)) {
+      try {
+        const existingPid = fs.readFileSync(this.pidFile, "utf8").trim();
+        const pid = parseInt(existingPid, 10);
+        try {
+          process.kill(pid, 0);
+          this.log("WARN", "Daemon already running for this session", {
+            existingPid: pid
+          });
+          return false;
+        } catch {
+          this.log("INFO", "Cleaning up stale PID file", { stalePid: pid });
+          fs.unlinkSync(this.pidFile);
+        }
+      } catch {
+        try {
+          fs.unlinkSync(this.pidFile);
+        } catch {
+        }
+      }
+    }
+    return true;
+  }
+  writePidFile() {
+    fs.writeFileSync(this.pidFile, process.pid.toString());
+    this.log("INFO", "PID file created", {
+      pid: process.pid,
+      file: this.pidFile
+    });
+  }
+  updateHeartbeat() {
+    const heartbeatData = {
+      pid: process.pid,
+      sessionId: this.config.sessionId,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      uptime: Date.now() - this.state.startTime,
+      saveCount: this.state.saveCount,
+      lastSaveTime: new Date(this.state.lastSaveTime).toISOString()
+    };
+    try {
+      fs.writeFileSync(
+        this.heartbeatFile,
+        JSON.stringify(heartbeatData, null, 2)
+      );
+    } catch (err) {
+      this.log("ERROR", "Failed to update heartbeat file", {
+        error: String(err)
+      });
+    }
+  }
+  saveContext() {
+    if (this.isShuttingDown) return;
+    try {
+      const stackmemoryBin = path.join(
+        this.stackmemoryDir,
+        "bin",
+        "stackmemory"
+      );
+      if (!fs.existsSync(stackmemoryBin)) {
+        this.log("WARN", "StackMemory binary not found", {
+          path: stackmemoryBin
+        });
+        return;
+      }
+      const message = `Auto-checkpoint #${this.state.saveCount + 1} at ${(/* @__PURE__ */ new Date()).toISOString()}`;
+      execSync(`"${stackmemoryBin}" context add observation "${message}"`, {
+        timeout: 3e4,
+        encoding: "utf8",
+        stdio: "pipe"
+      });
+      this.state.saveCount++;
+      this.state.lastSaveTime = Date.now();
+      this.log("INFO", "Context saved successfully", {
+        saveCount: this.state.saveCount,
+        intervalMs: this.config.saveIntervalMs
+      });
+    } catch (err) {
+      const errorMsg = err instanceof Error ? err.message : String(err);
+      if (!errorMsg.includes("EBUSY") && !errorMsg.includes("EAGAIN")) {
+        this.state.errors.push(errorMsg);
+        this.log("WARN", "Failed to save context", { error: errorMsg });
+      }
+      if (this.state.errors.length > 50) {
+        this.log("ERROR", "Too many errors, initiating shutdown");
+        this.shutdown("too_many_errors");
+      }
+    }
+  }
+  checkActivity() {
+    if (this.isShuttingDown) return;
+    const sessionFile = path.join(
+      this.stackmemoryDir,
+      "traces",
+      "current-session.json"
+    );
+    try {
+      if (fs.existsSync(sessionFile)) {
+        const stats = fs.statSync(sessionFile);
+        const lastModified = stats.mtimeMs;
+        if (lastModified > this.state.lastActivityTime) {
+          this.state.lastActivityTime = lastModified;
+          this.log("DEBUG", "Activity detected", {
+            lastModified: new Date(lastModified).toISOString()
+          });
+        }
+      }
+    } catch {
+    }
+    const inactiveTime = Date.now() - this.state.lastActivityTime;
+    if (inactiveTime > this.config.inactivityTimeoutMs) {
+      this.log("INFO", "Inactivity timeout reached", {
+        inactiveTimeMs: inactiveTime,
+        timeoutMs: this.config.inactivityTimeoutMs
+      });
+      this.shutdown("inactivity_timeout");
+    }
+  }
+  setupSignalHandlers() {
+    const handleSignal = (signal) => {
+      this.log("INFO", `Received ${signal}, shutting down gracefully`);
+      this.shutdown(signal.toLowerCase());
+    };
+    process.on("SIGTERM", () => handleSignal("SIGTERM"));
+    process.on("SIGINT", () => handleSignal("SIGINT"));
+    process.on("SIGHUP", () => handleSignal("SIGHUP"));
+    process.on("uncaughtException", (err) => {
+      this.log("ERROR", "Uncaught exception", {
+        error: err.message,
+        stack: err.stack
+      });
+      this.shutdown("uncaught_exception");
+    });
+    process.on("unhandledRejection", (reason) => {
+      this.log("ERROR", "Unhandled rejection", { reason: String(reason) });
+    });
+  }
+  cleanup() {
+    try {
+      if (fs.existsSync(this.pidFile)) {
+        fs.unlinkSync(this.pidFile);
+        this.log("INFO", "PID file removed");
+      }
+    } catch (e) {
+      this.log("WARN", "Failed to remove PID file", { error: String(e) });
+    }
+    try {
+      const finalHeartbeat = {
+        pid: process.pid,
+        sessionId: this.config.sessionId,
+        timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+        status: "shutdown",
+        uptime: Date.now() - this.state.startTime,
+        totalSaves: this.state.saveCount
+      };
+      fs.writeFileSync(
+        this.heartbeatFile,
+        JSON.stringify(finalHeartbeat, null, 2)
+      );
+    } catch {
+    }
+  }
+  shutdown(reason) {
+    if (this.isShuttingDown) return;
+    this.isShuttingDown = true;
+    this.log("INFO", "Daemon shutting down", {
+      reason,
+      uptime: Date.now() - this.state.startTime,
+      totalSaves: this.state.saveCount,
+      errors: this.state.errors.length
+    });
+    if (this.saveInterval) {
+      clearInterval(this.saveInterval);
+      this.saveInterval = null;
+    }
+    if (this.heartbeatInterval) {
+      clearInterval(this.heartbeatInterval);
+      this.heartbeatInterval = null;
+    }
+    if (this.activityCheckInterval) {
+      clearInterval(this.activityCheckInterval);
+      this.activityCheckInterval = null;
+    }
+    try {
+      this.saveContext();
+    } catch {
+    }
+    this.cleanup();
+    process.exit(
+      reason === "inactivity_timeout" || reason === "sigterm" ? 0 : 1
+    );
+  }
+  start() {
+    if (!this.checkIdempotency()) {
+      this.log("INFO", "Exiting - daemon already running");
+      process.exit(0);
+    }
+    this.writePidFile();
+    this.setupSignalHandlers();
+    this.log("INFO", "Session daemon started", {
+      sessionId: this.config.sessionId,
+      pid: process.pid,
+      saveIntervalMs: this.config.saveIntervalMs,
+      inactivityTimeoutMs: this.config.inactivityTimeoutMs
+    });
+    this.updateHeartbeat();
+    this.heartbeatInterval = setInterval(() => {
+      this.updateHeartbeat();
+    }, this.config.heartbeatIntervalMs);
+    this.saveInterval = setInterval(() => {
+      this.saveContext();
+    }, this.config.saveIntervalMs);
+    this.activityCheckInterval = setInterval(() => {
+      this.checkActivity();
+    }, 60 * 1e3);
+    this.saveContext();
+  }
+}
+function parseArgs() {
+  const args = process.argv.slice(2);
+  let sessionId2 = `session-${Date.now()}`;
+  const options2 = {};
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg === "--session-id" && args[i + 1]) {
+      sessionId2 = args[i + 1];
+      i++;
+    } else if (arg === "--save-interval" && args[i + 1]) {
+      options2.saveIntervalMs = parseInt(args[i + 1], 10) * 1e3;
+      i++;
+    } else if (arg === "--inactivity-timeout" && args[i + 1]) {
+      options2.inactivityTimeoutMs = parseInt(args[i + 1], 10) * 1e3;
+      i++;
+    } else if (arg === "--heartbeat-interval" && args[i + 1]) {
+      options2.heartbeatIntervalMs = parseInt(args[i + 1], 10) * 1e3;
+      i++;
+    } else if (!arg.startsWith("--")) {
+      sessionId2 = arg;
+    }
+  }
+  return { sessionId: sessionId2, options: options2 };
+}
+const { sessionId, options } = parseArgs();
+const daemon = new SessionDaemon(sessionId, options);
+daemon.start();
+//# sourceMappingURL=session-daemon.js.map

package/dist/daemon/session-daemon.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/daemon/session-daemon.ts"],
+  "sourcesContent": ["#!/usr/bin/env node\n\n/**\n * Session Daemon for StackMemory\n *\n * Lightweight background daemon that:\n * - Saves context periodically (default: every 15 minutes)\n * - Auto-exits after 30 minutes of no Claude Code activity\n * - Updates heartbeat file to indicate liveness\n * - Logs to JSON structured log file\n */\n\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport { execSync } from 'child_process';\n\ninterface DaemonConfig {\n  sessionId: string;\n  saveIntervalMs: number;\n  inactivityTimeoutMs: number;\n  heartbeatIntervalMs: number;\n}\n\ninterface DaemonState {\n  startTime: number;\n  lastSaveTime: number;\n  lastActivityTime: number;\n  saveCount: number;\n  errors: string[];\n}\n\ninterface LogEntry {\n  timestamp: string;\n  level: 'INFO' | 'WARN' | 'ERROR' | 'DEBUG';\n  sessionId: string;\n  message: string;\n  data?: Record<string, unknown>;\n}\n\nclass SessionDaemon {\n  private config: DaemonConfig;\n  private state: DaemonState;\n  private stackmemoryDir: string;\n  private sessionsDir: string;\n  private logsDir: string;\n  private pidFile: string;\n  private heartbeatFile: string;\n  private logFile: string;\n\n  private saveInterval: NodeJS.Timeout | null = null;\n  private heartbeatInterval: NodeJS.Timeout | null = null;\n  private activityCheckInterval: NodeJS.Timeout | null = null;\n  private isShuttingDown = false;\n\n  constructor(sessionId: string, options?: Partial<DaemonConfig>) {\n    const homeDir = process.env['HOME'] || process.env['USERPROFILE'] || '';\n    this.stackmemoryDir = path.join(homeDir, '.stackmemory');\n    this.sessionsDir = path.join(this.stackmemoryDir, 'sessions');\n    this.logsDir = path.join(this.stackmemoryDir, 'logs');\n\n    this.config = {\n      sessionId,\n      saveIntervalMs: options?.saveIntervalMs ?? 15 * 60 * 1000,\n      inactivityTimeoutMs: options?.inactivityTimeoutMs ?? 30 * 60 * 1000,\n      heartbeatIntervalMs: options?.heartbeatIntervalMs ?? 60 * 1000,\n    };\n\n    this.pidFile = path.join(this.sessionsDir, `${sessionId}.pid`);\n    this.heartbeatFile = path.join(this.sessionsDir, `${sessionId}.heartbeat`);\n    this.logFile = path.join(this.logsDir, 'daemon.log');\n\n    this.state = {\n      startTime: Date.now(),\n      lastSaveTime: Date.now(),\n      lastActivityTime: Date.now(),\n      saveCount: 0,\n      errors: [],\n    };\n\n    this.ensureDirectories();\n  }\n\n  private ensureDirectories(): void {\n    [this.sessionsDir, this.logsDir].forEach((dir) => {\n      if (!fs.existsSync(dir)) {\n        fs.mkdirSync(dir, { recursive: true });\n      }\n    });\n  }\n\n  private log(\n    level: LogEntry['level'],\n    message: string,\n    data?: Record<string, unknown>\n  ): void {\n    const entry: LogEntry = {\n      timestamp: new Date().toISOString(),\n      level,\n      sessionId: this.config.sessionId,\n      message,\n      data,\n    };\n\n    const logLine = JSON.stringify(entry) + '\\n';\n\n    try {\n      fs.appendFileSync(this.logFile, logLine);\n    } catch {\n      console.error(`[${entry.timestamp}] ${level}: ${message}`, data);\n    }\n  }\n\n  private checkIdempotency(): boolean {\n    if (fs.existsSync(this.pidFile)) {\n      try {\n        const existingPid = fs.readFileSync(this.pidFile, 'utf8').trim();\n        const pid = parseInt(existingPid, 10);\n\n        // Check if process is still running\n        try {\n          process.kill(pid, 0);\n          // Process exists, daemon already running\n          this.log('WARN', 'Daemon already running for this session', {\n            existingPid: pid,\n          });\n          return false;\n        } catch {\n          // Process not running, stale PID file\n          this.log('INFO', 'Cleaning up stale PID file', { stalePid: pid });\n          fs.unlinkSync(this.pidFile);\n        }\n      } catch {\n        try {\n          fs.unlinkSync(this.pidFile);\n        } catch {\n          // Ignore cleanup errors\n        }\n      }\n    }\n    return true;\n  }\n\n  private writePidFile(): void {\n    fs.writeFileSync(this.pidFile, process.pid.toString());\n    this.log('INFO', 'PID file created', {\n      pid: process.pid,\n      file: this.pidFile,\n    });\n  }\n\n  private updateHeartbeat(): void {\n    const heartbeatData = {\n      pid: process.pid,\n      sessionId: this.config.sessionId,\n      timestamp: new Date().toISOString(),\n      uptime: Date.now() - this.state.startTime,\n      saveCount: this.state.saveCount,\n      lastSaveTime: new Date(this.state.lastSaveTime).toISOString(),\n    };\n\n    try {\n      fs.writeFileSync(\n        this.heartbeatFile,\n        JSON.stringify(heartbeatData, null, 2)\n      );\n    } catch (err) {\n      this.log('ERROR', 'Failed to update heartbeat file', {\n        error: String(err),\n      });\n    }\n  }\n\n  private saveContext(): void {\n    if (this.isShuttingDown) return;\n\n    try {\n      const stackmemoryBin = path.join(\n        this.stackmemoryDir,\n        'bin',\n        'stackmemory'\n      );\n\n      if (!fs.existsSync(stackmemoryBin)) {\n        this.log('WARN', 'StackMemory binary not found', {\n          path: stackmemoryBin,\n        });\n        return;\n      }\n\n      // Save context checkpoint using the context add command\n      const message = `Auto-checkpoint #${this.state.saveCount + 1} at ${new Date().toISOString()}`;\n\n      execSync(`\"${stackmemoryBin}\" context add observation \"${message}\"`, {\n        timeout: 30000,\n        encoding: 'utf8',\n        stdio: 'pipe',\n      });\n\n      this.state.saveCount++;\n      this.state.lastSaveTime = Date.now();\n\n      this.log('INFO', 'Context saved successfully', {\n        saveCount: this.state.saveCount,\n        intervalMs: this.config.saveIntervalMs,\n      });\n    } catch (err) {\n      const errorMsg = err instanceof Error ? err.message : String(err);\n\n      // Only log if not a transient error - many save errors are expected when CLI is busy\n      if (!errorMsg.includes('EBUSY') && !errorMsg.includes('EAGAIN')) {\n        this.state.errors.push(errorMsg);\n        this.log('WARN', 'Failed to save context', { error: errorMsg });\n      }\n\n      // If we have too many consecutive errors, consider shutting down\n      if (this.state.errors.length > 50) {\n        this.log('ERROR', 'Too many errors, initiating shutdown');\n        this.shutdown('too_many_errors');\n      }\n    }\n  }\n\n  private checkActivity(): void {\n    if (this.isShuttingDown) return;\n\n    // Check for Claude Code activity by looking at the session file or heartbeat\n    const sessionFile = path.join(\n      this.stackmemoryDir,\n      'traces',\n      'current-session.json'\n    );\n\n    try {\n      if (fs.existsSync(sessionFile)) {\n        const stats = fs.statSync(sessionFile);\n        const lastModified = stats.mtimeMs;\n\n        // If session file was modified recently, update activity time\n        if (lastModified > this.state.lastActivityTime) {\n          this.state.lastActivityTime = lastModified;\n          this.log('DEBUG', 'Activity detected', {\n            lastModified: new Date(lastModified).toISOString(),\n          });\n        }\n      }\n    } catch {\n      // Ignore errors checking activity\n    }\n\n    // Check if we've exceeded the inactivity timeout\n    const inactiveTime = Date.now() - this.state.lastActivityTime;\n    if (inactiveTime > this.config.inactivityTimeoutMs) {\n      this.log('INFO', 'Inactivity timeout reached', {\n        inactiveTimeMs: inactiveTime,\n        timeoutMs: this.config.inactivityTimeoutMs,\n      });\n      this.shutdown('inactivity_timeout');\n    }\n  }\n\n  private setupSignalHandlers(): void {\n    const handleSignal = (signal: string) => {\n      this.log('INFO', `Received ${signal}, shutting down gracefully`);\n      this.shutdown(signal.toLowerCase());\n    };\n\n    process.on('SIGTERM', () => handleSignal('SIGTERM'));\n    process.on('SIGINT', () => handleSignal('SIGINT'));\n    process.on('SIGHUP', () => handleSignal('SIGHUP'));\n\n    // Handle uncaught exceptions\n    process.on('uncaughtException', (err) => {\n      this.log('ERROR', 'Uncaught exception', {\n        error: err.message,\n        stack: err.stack,\n      });\n      this.shutdown('uncaught_exception');\n    });\n\n    process.on('unhandledRejection', (reason) => {\n      this.log('ERROR', 'Unhandled rejection', { reason: String(reason) });\n    });\n  }\n\n  private cleanup(): void {\n    // Remove PID file\n    try {\n      if (fs.existsSync(this.pidFile)) {\n        fs.unlinkSync(this.pidFile);\n        this.log('INFO', 'PID file removed');\n      }\n    } catch (e) {\n      this.log('WARN', 'Failed to remove PID file', { error: String(e) });\n    }\n\n    // Update heartbeat with shutdown status\n    try {\n      const finalHeartbeat = {\n        pid: process.pid,\n        sessionId: this.config.sessionId,\n        timestamp: new Date().toISOString(),\n        status: 'shutdown',\n        uptime: Date.now() - this.state.startTime,\n        totalSaves: this.state.saveCount,\n      };\n      fs.writeFileSync(\n        this.heartbeatFile,\n        JSON.stringify(finalHeartbeat, null, 2)\n      );\n    } catch {\n      // Ignore errors updating final heartbeat\n    }\n  }\n\n  private shutdown(reason: string): void {\n    if (this.isShuttingDown) return;\n    this.isShuttingDown = true;\n\n    this.log('INFO', 'Daemon shutting down', {\n      reason,\n      uptime: Date.now() - this.state.startTime,\n      totalSaves: this.state.saveCount,\n      errors: this.state.errors.length,\n    });\n\n    // Clear all intervals\n    if (this.saveInterval) {\n      clearInterval(this.saveInterval);\n      this.saveInterval = null;\n    }\n    if (this.heartbeatInterval) {\n      clearInterval(this.heartbeatInterval);\n      this.heartbeatInterval = null;\n    }\n    if (this.activityCheckInterval) {\n      clearInterval(this.activityCheckInterval);\n      this.activityCheckInterval = null;\n    }\n\n    // Final context save before shutdown\n    try {\n      this.saveContext();\n    } catch {\n      // Ignore errors during final save\n    }\n\n    this.cleanup();\n\n    // Exit with appropriate code\n    process.exit(\n      reason === 'inactivity_timeout' || reason === 'sigterm' ? 0 : 1\n    );\n  }\n\n  public start(): void {\n    // Check idempotency first\n    if (!this.checkIdempotency()) {\n      this.log('INFO', 'Exiting - daemon already running');\n      process.exit(0);\n    }\n\n    // Write PID file\n    this.writePidFile();\n\n    // Setup signal handlers\n    this.setupSignalHandlers();\n\n    // Log startup\n    this.log('INFO', 'Session daemon started', {\n      sessionId: this.config.sessionId,\n      pid: process.pid,\n      saveIntervalMs: this.config.saveIntervalMs,\n      inactivityTimeoutMs: this.config.inactivityTimeoutMs,\n    });\n\n    // Initial heartbeat\n    this.updateHeartbeat();\n\n    // Setup periodic tasks\n    this.heartbeatInterval = setInterval(() => {\n      this.updateHeartbeat();\n    }, this.config.heartbeatIntervalMs);\n\n    this.saveInterval = setInterval(() => {\n      this.saveContext();\n    }, this.config.saveIntervalMs);\n\n    // Check activity every minute\n    this.activityCheckInterval = setInterval(() => {\n      this.checkActivity();\n    }, 60 * 1000);\n\n    // Initial context save\n    this.saveContext();\n  }\n}\n\n// Parse command line arguments\nfunction parseArgs(): { sessionId: string; options: Partial<DaemonConfig> } {\n  const args = process.argv.slice(2);\n  let sessionId = `session-${Date.now()}`;\n  const options: Partial<DaemonConfig> = {};\n\n  for (let i = 0; i < args.length; i++) {\n    const arg = args[i];\n    if (arg === '--session-id' && args[i + 1]) {\n      sessionId = args[i + 1];\n      i++;\n    } else if (arg === '--save-interval' && args[i + 1]) {\n      options.saveIntervalMs = parseInt(args[i + 1], 10) * 1000;\n      i++;\n    } else if (arg === '--inactivity-timeout' && args[i + 1]) {\n      options.inactivityTimeoutMs = parseInt(args[i + 1], 10) * 1000;\n      i++;\n    } else if (arg === '--heartbeat-interval' && args[i + 1]) {\n      options.heartbeatIntervalMs = parseInt(args[i + 1], 10) * 1000;\n      i++;\n    } else if (!arg.startsWith('--')) {\n      sessionId = arg;\n    }\n  }\n\n  return { sessionId, options };\n}\n\n// Main entry point\nconst { sessionId, options } = parseArgs();\nconst daemon = new SessionDaemon(sessionId, options);\ndaemon.start();\n"],
+  "mappings": "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",
+  "names": ["sessionId", "options"]
+}

package/dist/skills/repo-ingestion-skill.js

@@ -1,5 +1,9 @@
 import { ChromaDBAdapter } from "../core/storage/chromadb-adapter.js";
 import { Logger } from "../core/monitoring/logger.js";
+import {
+  isChromaDBEnabled,
+  getChromaDBConfig
+} from "../core/config/storage-config.js";
 import * as fs from "fs";
 import * as path from "path";
 import * as crypto from "crypto";
@@ -11,27 +15,57 @@ class RepoIngestionSkill {
     this.userId = userId;
     this.teamId = teamId;
     this.logger = new Logger("RepoIngestionSkill");
-    this.adapter = new ChromaDBAdapter(
-      {
-        ...config,
-        collectionName: config.collectionName || "stackmemory_repos"
-      },
-      userId,
-      teamId
-    );
+    this.chromaEnabled = isChromaDBEnabled();
+    if (this.chromaEnabled) {
+      const chromaConfig = getChromaDBConfig();
+      if (chromaConfig && chromaConfig.apiKey) {
+        this.adapter = new ChromaDBAdapter(
+          {
+            apiKey: config?.apiKey || chromaConfig.apiKey,
+            tenant: config?.tenant || chromaConfig.tenant || "default_tenant",
+            database: config?.database || chromaConfig.database || "default_database",
+            collectionName: config?.collectionName || "stackmemory_repos"
+          },
+          userId,
+          teamId
+        );
+      }
+    }
   }
   logger;
-  adapter;
+  adapter = null;
   metadataCache = /* @__PURE__ */ new Map();
   fileHashCache = /* @__PURE__ */ new Map();
+  chromaEnabled = false;
+  /**
+   * Check if ChromaDB is available for use
+   */
+  isAvailable() {
+    return this.chromaEnabled && this.adapter !== null;
+  }
   async initialize() {
-    await this.adapter.initialize();
+    if (!this.isAvailable()) {
+      this.logger.warn(
+        "ChromaDB not enabled. Repository ingestion features are unavailable."
+      );
+      this.logger.warn('Run "stackmemory init --chromadb" to enable ChromaDB.');
+      return;
+    }
+    if (this.adapter) {
+      await this.adapter.initialize();
+    }
     await this.loadMetadataCache();
   }
   /**
    * Ingest a repository into ChromaDB
    */
   async ingestRepository(repoPath, repoName, options = {}) {
+    if (!this.isAvailable()) {
+      return {
+        success: false,
+        message: 'ChromaDB not enabled. Run "stackmemory init --chromadb" to enable semantic search features.'
+      };
+    }
     const startTime = Date.now();
     try {
       this.logger.info(`Starting repository ingestion for ${repoName}`);
@@ -199,6 +233,10 @@ class RepoIngestionSkill {
    * Search code in ingested repositories
    */
   async searchCode(query, options) {
+    if (!this.isAvailable() || !this.adapter) {
+      this.logger.warn("ChromaDB not enabled. Code search unavailable.");
+      return [];
+    }
     try {
       const filters = {
         type: ["code_chunk"]
@@ -418,11 +456,17 @@ class RepoIngestionSkill {
    * Store a chunk in ChromaDB
    */
   async storeChunk(chunk, metadata) {
+    if (!this.adapter) {
+      throw new Error("ChromaDB adapter not available");
+    }
     const documentContent = `File: ${chunk.filePath} (Lines ${chunk.startLine}-${chunk.endLine})
 Language: ${chunk.language}
 Repository: ${metadata.repoName}/${metadata.branch}
 
 ${chunk.content}`;
+    if (!this.adapter) {
+      throw new Error("ChromaDB adapter not initialized");
+    }
     await this.adapter.storeContext("observation", documentContent, {
       type: "code_chunk",
       repo_id: metadata.repoId,