@stackmemoryai/stackmemory 0.8.1 → 1.0.0

package/scripts/detect-and-rehydrate.js

@@ -1,162 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Smart Compaction Detection and Auto-Rehydration
- * Monitors Claude Code context and triggers rehydration when needed
- */
-
-const fs = require('fs');
-const path = require('path');
-const { exec } = require('child_process');
-const { promisify } = require('util');
-
-const execAsync = promisify(exec);
-
-// Compaction detection patterns
-const COMPACTION_INDICATORS = [
-  'earlier in this conversation',
-  'previously discussed',
-  'as mentioned before', 
-  'summarized for brevity',
-  '[conversation compressed]',
-  '[context truncated]',
-  '⏺ Compact summary',
-  'Previous Conversation Compacted',
-  'Referenced file',
-  /⎿.*Referenced file/,
-  /⎿.*Read.*\(\d+ lines\)/
-];
-
-class CompactionDetector {
-  constructor() {
-    this.logFile = path.join(process.cwd(), '.stackmemory', 'compaction.log');
-    this.lastCheck = 0;
-    this.ensureLogDirectory();
-  }
-
-  ensureLogDirectory() {
-    const dir = path.dirname(this.logFile);
-    if (!fs.existsSync(dir)) {
-      fs.mkdirSync(dir, { recursive: true });
-    }
-  }
-
-  log(message) {
-    const timestamp = new Date().toISOString();
-    const logEntry = `${timestamp}: ${message}\n`;
-    
-    console.log(`🔍 ${message}`);
-    
-    try {
-      fs.appendFileSync(this.logFile, logEntry);
-    } catch (error) {
-      console.error('Failed to write to log:', error.message);
-    }
-  }
-
-  async detectCompaction(inputText) {
-    if (!inputText) return false;
-
-    const lowerText = inputText.toLowerCase();
-    
-    // Check for exact string matches
-    const hasStringIndicator = COMPACTION_INDICATORS.some(indicator => {
-      if (typeof indicator === 'string') {
-        return lowerText.includes(indicator.toLowerCase());
-      } else if (indicator instanceof RegExp) {
-        return indicator.test(inputText);
-      }
-      return false;
-    });
-
-    // Check for compact summary patterns
-    const hasCompactPattern = /⏺.*compact summary|compact.*summary/i.test(inputText);
-    
-    // Check for conversation compression indicators  
-    const hasCompressionPattern = /previous conversation.*compacted|context.*truncated/i.test(inputText);
-
-    // Check for file reference patterns (common after compaction)
-    const hasFileReferencePattern = /⎿.*referenced file|⎿.*read.*\(\d+ lines\)/i.test(inputText);
-
-    return hasStringIndicator || hasCompactPattern || hasCompressionPattern || hasFileReferencePattern;
-  }
-
-  async triggerRehydration() {
-    this.log('Compaction detected, triggering context rehydration...');
-
-    try {
-      // Check if StackMemory is available
-      await execAsync('stackmemory status');
-      
-      // Check for existing checkpoints
-      const { stdout: listOutput } = await execAsync('stackmemory context rehydrate --list');
-      
-      if (listOutput.includes('No rehydration checkpoints')) {
-        this.log('No checkpoints found, creating initial checkpoint...');
-        await execAsync('stackmemory context rehydrate --create');
-        this.log('Initial checkpoint created');
-      }
-
-      // Perform rehydration
-      this.log('Performing context rehydration...');
-      const { stdout: rehydrateOutput } = await execAsync('stackmemory context rehydrate --verbose');
-      
-      this.log('Context rehydration completed successfully');
-      console.log('\n✅ Rich context restored! Your session now includes:');
-      console.log('   📁 File snapshots with content previews');
-      console.log('   🗺️  Project structure and relationships');
-      console.log('   🧠 Previous decisions and reasoning');
-      console.log('   🎯 Active workflows and focus areas\n');
-
-      return true;
-
-    } catch (error) {
-      this.log(`Context rehydration failed: ${error.message}`);
-      console.error('❌ Failed to rehydrate context:', error.message);
-      return false;
-    }
-  }
-
-  async checkInput(text) {
-    if (await this.detectCompaction(text)) {
-      // Debounce multiple detections
-      const now = Date.now();
-      if (now - this.lastCheck < 30000) { // 30 second cooldown
-        this.log('Compaction detected but within cooldown period, skipping...');
-        return;
-      }
-      
-      this.lastCheck = now;
-      await this.triggerRehydration();
-    }
-  }
-}
-
-// CLI usage
-async function main() {
-  const detector = new CompactionDetector();
-
-  if (process.argv.length > 2) {
-    // Check specific text
-    const text = process.argv.slice(2).join(' ');
-    const detected = await detector.detectCompaction(text);
-    console.log(`Compaction detected: ${detected}`);
-    
-    if (detected) {
-      await detector.triggerRehydration();
-    }
-  } else {
-    // Monitor mode (could be enhanced to monitor clipboard, files, etc.)
-    console.log('📡 StackMemory Compaction Detector Ready');
-    console.log('💡 Usage: node detect-and-rehydrate.js "text to check"');
-    console.log('🔧 Integrate with Claude Code hooks for automatic detection');
-  }
-}
-
-// Export for use as module
-module.exports = { CompactionDetector };
-
-// Run if called directly
-if (require.main === module) {
-  main().catch(console.error);
-}

package/scripts/detect-and-rehydrate.mjs

@@ -1,165 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Smart Compaction Detection and Auto-Rehydration
- * Monitors Claude Code context and triggers rehydration when needed
- */
-
-import fs from 'fs';
-import path from 'path';
-import { exec } from 'child_process';
-import { promisify } from 'util';
-import { fileURLToPath } from 'url';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-const execAsync = promisify(exec);
-
-// Compaction detection patterns
-const COMPACTION_INDICATORS = [
-  'earlier in this conversation',
-  'previously discussed',
-  'as mentioned before', 
-  'summarized for brevity',
-  '[conversation compressed]',
-  '[context truncated]',
-  '⏺ Compact summary',
-  'Previous Conversation Compacted',
-  'Referenced file',
-  /⎿.*Referenced file/,
-  /⎿.*Read.*\(\d+ lines\)/
-];
-
-class CompactionDetector {
-  constructor() {
-    this.logFile = path.join(process.cwd(), '.stackmemory', 'compaction.log');
-    this.lastCheck = 0;
-    this.ensureLogDirectory();
-  }
-
-  ensureLogDirectory() {
-    const dir = path.dirname(this.logFile);
-    if (!fs.existsSync(dir)) {
-      fs.mkdirSync(dir, { recursive: true });
-    }
-  }
-
-  log(message) {
-    const timestamp = new Date().toISOString();
-    const logEntry = `${timestamp}: ${message}\n`;
-    
-    console.log(`🔍 ${message}`);
-    
-    try {
-      fs.appendFileSync(this.logFile, logEntry);
-    } catch (error) {
-      console.error('Failed to write to log:', error.message);
-    }
-  }
-
-  async detectCompaction(inputText) {
-    if (!inputText) return false;
-
-    const lowerText = inputText.toLowerCase();
-    
-    // Check for exact string matches
-    const hasStringIndicator = COMPACTION_INDICATORS.some(indicator => {
-      if (typeof indicator === 'string') {
-        return lowerText.includes(indicator.toLowerCase());
-      } else if (indicator instanceof RegExp) {
-        return indicator.test(inputText);
-      }
-      return false;
-    });
-
-    // Check for compact summary patterns
-    const hasCompactPattern = /⏺.*compact summary|compact.*summary/i.test(inputText);
-    
-    // Check for conversation compression indicators  
-    const hasCompressionPattern = /previous conversation.*compacted|context.*truncated/i.test(inputText);
-
-    // Check for file reference patterns (common after compaction)
-    const hasFileReferencePattern = /⎿.*referenced file|⎿.*read.*\(\d+ lines\)/i.test(inputText);
-
-    return hasStringIndicator || hasCompactPattern || hasCompressionPattern || hasFileReferencePattern;
-  }
-
-  async triggerRehydration() {
-    this.log('Compaction detected, triggering context rehydration...');
-
-    try {
-      // Check if StackMemory is available
-      await execAsync('~/.stackmemory/bin/stackmemory status');
-      
-      // Check for existing checkpoints
-      const { stdout: listOutput } = await execAsync('~/.stackmemory/bin/stackmemory context rehydrate --list');
-      
-      if (listOutput.includes('No rehydration checkpoints')) {
-        this.log('No checkpoints found, creating initial checkpoint...');
-        await execAsync('~/.stackmemory/bin/stackmemory context rehydrate --create');
-        this.log('Initial checkpoint created');
-      }
-
-      // Perform rehydration
-      this.log('Performing context rehydration...');
-      const { stdout: rehydrateOutput } = await execAsync('~/.stackmemory/bin/stackmemory context rehydrate --verbose');
-      
-      this.log('Context rehydration completed successfully');
-      console.log('\n✅ Rich context restored! Your session now includes:');
-      console.log('   📁 File snapshots with content previews');
-      console.log('   🗺️  Project structure and relationships');
-      console.log('   🧠 Previous decisions and reasoning');
-      console.log('   🎯 Active workflows and focus areas\n');
-
-      return true;
-
-    } catch (error) {
-      this.log(`Context rehydration failed: ${error.message}`);
-      console.error('❌ Failed to rehydrate context:', error.message);
-      return false;
-    }
-  }
-
-  async checkInput(text) {
-    if (await this.detectCompaction(text)) {
-      // Debounce multiple detections
-      const now = Date.now();
-      if (now - this.lastCheck < 30000) { // 30 second cooldown
-        this.log('Compaction detected but within cooldown period, skipping...');
-        return;
-      }
-      
-      this.lastCheck = now;
-      await this.triggerRehydration();
-    }
-  }
-}
-
-// CLI usage
-async function main() {
-  const detector = new CompactionDetector();
-
-  if (process.argv.length > 2) {
-    // Check specific text
-    const text = process.argv.slice(2).join(' ');
-    const detected = await detector.detectCompaction(text);
-    console.log(`Compaction detected: ${detected}`);
-    
-    if (detected) {
-      await detector.triggerRehydration();
-    }
-  } else {
-    // Monitor mode
-    console.log('📡 StackMemory Compaction Detector Ready');
-    console.log('💡 Usage: node detect-and-rehydrate.mjs "text to check"');
-    console.log('🔧 Integrate with Claude Code hooks for automatic detection');
-  }
-}
-
-// Run if called directly
-if (import.meta.url === `file://${process.argv[1]}`) {
-  main().catch(console.error);
-}
-
-export { CompactionDetector };

package/scripts/development/create-demo-tasks.js

@@ -1,143 +0,0 @@
-#!/usr/bin/env node
-/**
- * Create demo tasks to review current system and plan Linear integration
- */
-
-import Database from 'better-sqlite3';
-import { join } from 'path';
-import { PebblesTaskStore } from './dist/src/pebbles/pebbles-task-store.js';
-import { FrameManager } from './dist/src/core/frame-manager.js';
-
-const projectRoot = process.cwd();
-const dbPath = join(projectRoot, '.stackmemory', 'context.db');
-const db = new Database(dbPath);
-
-// Initialize managers
-const frameManager = new FrameManager(db, 'stackmemory-demo');
-const taskStore = new PebblesTaskStore(projectRoot, db);
-
-console.log('🚀 Creating demo development tasks...\n');
-
-// Create a main development frame
-const mainFrameId = frameManager.createFrame({
-  type: 'task',
-  name: 'StackMemory v0.3.0 Development',
-  inputs: {
-    constraints: [
-      'Must maintain git-native architecture',
-      'Zero infrastructure requirements',
-    ],
-    goals: [
-      'Linear integration',
-      'Enhanced task management',
-      'Team collaboration',
-    ],
-  },
-});
-
-console.log(`📋 Created main frame: ${mainFrameId}\n`);
-
-// Create development tasks
-const tasks = [
-  {
-    title: 'Linear API Integration',
-    description:
-      'Implement bi-directional sync with Linear for team collaboration. Include webhook handlers, status mapping, and conflict resolution.',
-    priority: 'high',
-    estimatedEffort: 240, // 4 hours
-    tags: ['integration', 'linear', 'api', 'team'],
-    dependsOn: [],
-  },
-  {
-    title: 'Enhanced CLI Commands',
-    description:
-      'Add comprehensive task management commands to StackMemory CLI. Include list, update, create, and dependency management.',
-    priority: 'medium',
-    estimatedEffort: 120, // 2 hours
-    tags: ['cli', 'ux', 'commands'],
-    dependsOn: [],
-  },
-  {
-    title: 'Git Hooks Integration',
-    description:
-      'Automate task state sync with git workflow. Pre-commit validation, post-commit updates, and branch-based task isolation.',
-    priority: 'medium',
-    estimatedEffort: 90, // 1.5 hours
-    tags: ['git', 'automation', 'hooks'],
-    dependsOn: [],
-  },
-  {
-    title: 'Task Analytics Dashboard',
-    description:
-      'Web UI for task metrics and project insights. Show completion rates, effort accuracy, blocking issues, and team performance.',
-    priority: 'low',
-    estimatedEffort: 480, // 8 hours
-    tags: ['ui', 'analytics', 'web', 'dashboard'],
-    dependsOn: [],
-  },
-  {
-    title: 'Performance Optimization',
-    description:
-      'Optimize context assembly and JSONL parsing performance. Implement lazy loading, caching, and parallel processing.',
-    priority: 'high',
-    estimatedEffort: 180, // 3 hours
-    tags: ['performance', 'optimization', 'caching'],
-    dependsOn: [],
-  },
-];
-
-const createdTasks = [];
-
-for (const task of tasks) {
-  const taskId = taskStore.createTask({
-    title: task.title,
-    description: task.description,
-    priority: task.priority,
-    frameId: mainFrameId,
-    tags: task.tags,
-    estimatedEffort: task.estimatedEffort,
-  });
-
-  createdTasks.push({ id: taskId, ...task });
-  console.log(`✅ Created: ${task.title} (${taskId})`);
-}
-
-console.log(`\n📊 Created ${createdTasks.length} development tasks`);
-
-// Set up some task dependencies
-console.log('\n🔗 Setting up task dependencies...');
-
-// Find Linear integration task
-const linearTask = createdTasks.find((t) => t.title.includes('Linear'));
-const cliTask = createdTasks.find((t) => t.title.includes('CLI'));
-
-if (linearTask && cliTask) {
-  // CLI commands should depend on Linear integration being available
-  taskStore.addDependency(cliTask.id, linearTask.id);
-  console.log(`🔗 ${cliTask.title} depends on ${linearTask.title}`);
-}
-
-// Start the Linear integration task as in_progress
-if (linearTask) {
-  taskStore.updateTaskStatus(linearTask.id, 'in_progress');
-  console.log(`🚀 Started: ${linearTask.title}`);
-}
-
-console.log('\n📈 Current metrics:');
-const metrics = taskStore.getMetrics();
-console.log(`- Total tasks: ${metrics.total_tasks}`);
-console.log(`- In progress: ${metrics.by_status.in_progress || 0}`);
-console.log(`- Pending: ${metrics.by_status.pending || 0}`);
-console.log(`- High priority: ${metrics.by_priority.high || 0}`);
-
-console.log('\n🎯 Active tasks:');
-const activeTasks = taskStore.getActiveTasks();
-activeTasks.forEach((task) => {
-  const status = task.status.replace('_', ' ').toUpperCase();
-  const effort = task.estimated_effort ? ` (${task.estimated_effort}m)` : '';
-  console.log(`- [${status}] ${task.title}${effort}`);
-});
-
-console.log('\n✅ Demo tasks created! Use MCP tools to interact with them.');
-
-db.close();

package/scripts/development/debug-frame-test.js

@@ -1,16 +0,0 @@
-// Test the actual issue with a simpler approach
-import { v4 as uuidv4 } from 'uuid';
-
-console.log('Testing simple UUID generation...');
-const testId = uuidv4();
-console.log('UUID result:', testId);
-console.log('Type:', typeof testId);
-
-// Let me check if this is a vitest issue
-const simpleFunction = function () {
-  return 'string-result';
-};
-
-const result = simpleFunction();
-console.log('Simple function result:', result);
-console.log('Simple function type:', typeof result);

package/scripts/development/demo-auto-sync.js

@@ -1,128 +0,0 @@
-#!/usr/bin/env node
-/**
- * Demo: Linear Auto-Sync Functionality
- * Demonstrates how the auto-sync works locally
- */
-
-import {
-  initializeAutoSync,
-  getAutoSyncService,
-} from './dist/src/integrations/linear-auto-sync.js';
-
-console.log('🚀 Linear Auto-Sync Demo\n');
-
-// Simulate a project directory
-const projectRoot = process.cwd();
-
-console.log('📋 Demo Scenario:');
-console.log('- Configure auto-sync with 30-second intervals');
-console.log('- Show service status and configuration');
-console.log(
-  '- Simulate what happens during sync (without actual Linear connection)'
-);
-console.log('- Demonstrate configuration management\n');
-
-// Step 1: Initialize auto-sync service
-console.log('1️⃣ Initializing auto-sync service...');
-const autoSyncService = initializeAutoSync(projectRoot, {
-  interval: 0.5, // 30 seconds for demo
-  direction: 'bidirectional',
-  conflictResolution: 'newest_wins',
-  enabled: true,
-  retryAttempts: 2,
-  retryDelay: 5000, // 5 seconds
-});
-
-console.log('✅ Auto-sync service initialized\n');
-
-// Step 2: Show service status
-console.log('2️⃣ Current service status:');
-const status = autoSyncService.getStatus();
-console.log(`   Running: ${status.running ? '✅' : '❌'}`);
-console.log(`   Interval: ${status.config.interval} minutes`);
-console.log(`   Direction: ${status.config.direction}`);
-console.log(`   Conflict Resolution: ${status.config.conflictResolution}`);
-console.log(`   Retry Attempts: ${status.config.retryAttempts}`);
-
-if (status.config.quietHours) {
-  console.log(
-    `   Quiet Hours: ${status.config.quietHours.start}:00 - ${status.config.quietHours.end}:00`
-  );
-}
-
-console.log('\n');
-
-// Step 3: Simulate configuration updates
-console.log('3️⃣ Demonstrating configuration updates...');
-autoSyncService.updateConfig({
-  interval: 1, // Change to 1 minute
-  conflictResolution: 'linear_wins',
-});
-console.log('✅ Updated: interval=1min, conflict_resolution=linear_wins\n');
-
-// Step 4: Show updated status
-console.log('4️⃣ Updated service status:');
-const updatedStatus = autoSyncService.getStatus();
-console.log(`   Interval: ${updatedStatus.config.interval} minutes`);
-console.log(
-  `   Conflict Resolution: ${updatedStatus.config.conflictResolution}\n`
-);
-
-// Step 5: Demonstrate the auto-sync would work with Linear
-console.log('5️⃣ How auto-sync works with Linear:');
-console.log('');
-console.log('🔄 **Automatic Synchronization Process:**');
-console.log('   1. Every N minutes (configurable), check for changes');
-console.log('   2. Sync StackMemory tasks → Linear issues');
-console.log('   3. Sync Linear issues → StackMemory task updates');
-console.log(
-  '   4. Handle conflicts based on strategy (newest_wins, linear_wins, etc.)'
-);
-console.log('   5. Log results and schedule next sync');
-console.log('');
-console.log('📊 **Status Mapping:**');
-console.log('   StackMemory pending     → Linear Backlog');
-console.log('   StackMemory in_progress → Linear In Progress');
-console.log('   StackMemory completed   → Linear Done');
-console.log('   StackMemory blocked     → Linear Blocked');
-console.log('');
-console.log('⚡ **Smart Features:**');
-console.log('   • Quiet hours (no sync 10pm-7am by default)');
-console.log('   • Automatic retry with exponential backoff');
-console.log('   • Conflict detection and resolution');
-console.log('   • Persistent configuration');
-console.log('   • Background service support');
-console.log('');
-
-// Step 6: Show NPM integration
-console.log('6️⃣ NPM Package Integration:');
-console.log('');
-console.log('📦 **Available Commands:**');
-console.log('   npm run linear:setup     # Setup Linear OAuth');
-console.log('   npm run linear:status    # Check integration status');
-console.log('   npm run linear:config    # View/edit configuration');
-console.log('   npm run linear:auto-sync # Start auto-sync service');
-console.log('');
-console.log('🔧 **Manual Commands:**');
-console.log('   stackmemory linear config --set-interval 10');
-console.log('   stackmemory linear auto-sync --start');
-console.log('   stackmemory linear force-sync');
-console.log('');
-
-// Step 7: Cleanup
-console.log('7️⃣ Stopping demo service...');
-autoSyncService.stop();
-console.log('✅ Demo completed!\n');
-
-console.log('🎯 **To Use in Production:**');
-console.log('1. Set up Linear OAuth: stackmemory linear setup');
-console.log('2. Authorize integration: stackmemory linear authorize <code>');
-console.log(
-  '3. Configure auto-sync: stackmemory linear config --set-interval 5'
-);
-console.log('4. Start auto-sync: stackmemory linear auto-sync --start');
-console.log('');
-console.log('📖 **Documentation:**');
-console.log('   All settings persist in .stackmemory/linear-auto-sync.json');
-console.log('   Auto-sync runs as a background process within the npm package');
-console.log('   No external services required - everything runs locally');