@stackmemoryai/stackmemory 0.8.0 → 1.0.0

package/scripts/clean-linear-backlog.js

@@ -1,273 +0,0 @@
-#!/usr/bin/env node
-
-import fs from 'fs';
-import path from 'path';
-import { fileURLToPath } from 'url';
-import dotenv from 'dotenv';
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-
-// Load environment variables from .env file first
-dotenv.config({ 
-  path: path.join(__dirname, '..', '.env'),
-  override: true // Override to ensure we use the latest key
-});
-
-async function queryLinear(query, variables = {}) {
-  const response = await fetch('https://api.linear.app/graphql', {
-    method: 'POST',
-    headers: {
-      'Content-Type': 'application/json',
-      'Authorization': process.env.STACKMEMORY_LINEAR_API_KEY || process.env.LINEAR_API_KEY
-    },
-    body: JSON.stringify({ query, variables })
-  });
-
-  const data = await response.json();
-  if (data.errors) {
-    throw new Error(data.errors[0].message);
-  }
-  return data.data;
-}
-
-async function cleanLinearBacklog() {
-  const apiKey = process.env.STACKMEMORY_LINEAR_API_KEY || process.env.LINEAR_API_KEY;
-  
-  if (!apiKey) {
-    console.error('❌ LINEAR_API_KEY not found in environment');
-    process.exit(1);
-  }
-  
-  console.log('🔍 Analyzing Linear backlog...\n');
-  
-  try {
-    // Fetch ALL issues (including completed/cancelled)
-    const issuesData = await queryLinear(`
-      query {
-        issues(first: 250, orderBy: updatedAt) {
-          nodes {
-            id
-            identifier
-            title
-            description
-            state {
-              name
-              type
-            }
-            priority
-            priorityLabel
-            team {
-              key
-              name
-            }
-            assignee {
-              name
-              email
-            }
-            createdAt
-            updatedAt
-            completedAt
-            canceledAt
-            url
-          }
-        }
-      }
-    `);
-    
-    const allIssues = issuesData.issues.nodes;
-    console.log(`📊 Total issues found: ${allIssues.length}`);
-    
-    // Categorize issues
-    const byStatus = {
-      completed: [],
-      cancelled: [],
-      backlog: [],
-      unstarted: [],
-      started: [],
-      inProgress: []
-    };
-    
-    const duplicates = new Map(); // Track potential duplicates
-    const engineeringMeetings = [];
-    const testTasks = [];
-    
-    for (const issue of allIssues) {
-      // Categorize by status
-      if (issue.state.type === 'completed') {
-        byStatus.completed.push(issue);
-      } else if (issue.state.type === 'canceled' || issue.state.type === 'cancelled') {
-        byStatus.cancelled.push(issue);
-      } else if (issue.state.type === 'backlog') {
-        byStatus.backlog.push(issue);
-      } else if (issue.state.type === 'unstarted') {
-        byStatus.unstarted.push(issue);
-      } else if (issue.state.type === 'started') {
-        byStatus.started.push(issue);
-      }
-      
-      // Check for duplicates (normalize title for comparison)
-      const normalizedTitle = issue.title
-        .replace(/^\[[^\]]+\]\s*/, '') // Remove [ENG-XXX] prefix
-        .replace(/^\[.*?\]\s*/, '') // Remove priority markers
-        .trim()
-        .toLowerCase();
-      
-      if (!duplicates.has(normalizedTitle)) {
-        duplicates.set(normalizedTitle, []);
-      }
-      duplicates.get(normalizedTitle).push(issue);
-      
-      // Identify meeting tasks
-      if (issue.title.includes('Engineering x') || issue.title.includes('Meeting')) {
-        engineeringMeetings.push(issue);
-      }
-      
-      // Identify test tasks
-      if (issue.title.toLowerCase().includes('test') && 
-          (issue.title.includes('test-') || issue.title.includes('TEST]'))) {
-        testTasks.push(issue);
-      }
-    }
-    
-    // Find actual duplicates (same title appearing multiple times)
-    const actualDuplicates = [];
-    for (const [title, issues] of duplicates.entries()) {
-      if (issues.length > 1) {
-        actualDuplicates.push({ title, issues });
-      }
-    }
-    
-    // Report findings
-    console.log('\n📈 Status Breakdown:');
-    console.log(`  ✅ Completed: ${byStatus.completed.length}`);
-    console.log(`  ❌ Cancelled: ${byStatus.cancelled.length}`);
-    console.log(`  📋 Backlog: ${byStatus.backlog.length}`);
-    console.log(`  ⏳ Unstarted: ${byStatus.unstarted.length}`);
-    console.log(`  🔄 Started: ${byStatus.started.length}`);
-    
-    console.log('\n🔍 Issues to Clean:');
-    console.log(`  🗓️ Engineering Meetings: ${engineeringMeetings.length}`);
-    console.log(`  🧪 Test Tasks: ${testTasks.length}`);
-    console.log(`  🔄 Duplicate Titles: ${actualDuplicates.length}`);
-    
-    // Show duplicates
-    if (actualDuplicates.length > 0) {
-      console.log('\n📑 Duplicate Issues:');
-      for (const dup of actualDuplicates.slice(0, 10)) {
-        console.log(`\n  "${dup.title}":`);
-        for (const issue of dup.issues) {
-          const status = issue.state.type === 'completed' ? '✅' : 
-                        issue.state.type === 'cancelled' ? '❌' : '⏳';
-          console.log(`    ${status} ${issue.identifier}: ${issue.state.name}`);
-        }
-      }
-      if (actualDuplicates.length > 10) {
-        console.log(`  ... and ${actualDuplicates.length - 10} more duplicate groups`);
-      }
-    }
-    
-    // Recommend deletions
-    const toDelete = [];
-    const toArchive = [];
-    
-    // Add completed issues older than 30 days
-    const thirtyDaysAgo = new Date(Date.now() - 30 * 24 * 60 * 60 * 1000);
-    for (const issue of byStatus.completed) {
-      if (new Date(issue.completedAt) < thirtyDaysAgo) {
-        toArchive.push(issue);
-      }
-    }
-    
-    // Add all cancelled issues
-    toDelete.push(...byStatus.cancelled);
-    
-    // Add test tasks
-    toDelete.push(...testTasks.filter(t => t.state.type !== 'started'));
-    
-    // For duplicates, keep the most recent one
-    for (const dup of actualDuplicates) {
-      const sorted = dup.issues.sort((a, b) => 
-        new Date(b.updatedAt).getTime() - new Date(a.updatedAt).getTime()
-      );
-      // Mark all but the first (most recent) for deletion
-      for (let i = 1; i < sorted.length; i++) {
-        if (sorted[i].state.type !== 'completed' && sorted[i].state.type !== 'started') {
-          toDelete.push(sorted[i]);
-        }
-      }
-    }
-    
-    // Remove duplicates from delete list
-    const uniqueToDelete = Array.from(new Set(toDelete.map(i => i.id)))
-      .map(id => toDelete.find(i => i.id === id));
-    
-    console.log('\n🗑️ Recommended Actions:');
-    console.log(`  📁 Archive (completed >30 days): ${toArchive.length}`);
-    console.log(`  🗑️ Delete (cancelled/test/duplicates): ${uniqueToDelete.length}`);
-    
-    if (toArchive.length > 0) {
-      console.log('\n📁 Issues to Archive:');
-      for (const issue of toArchive.slice(0, 5)) {
-        console.log(`  - ${issue.identifier}: ${issue.title}`);
-      }
-      if (toArchive.length > 5) {
-        console.log(`  ... and ${toArchive.length - 5} more`);
-      }
-    }
-    
-    if (uniqueToDelete.length > 0) {
-      console.log('\n🗑️ Issues to Delete:');
-      const deleteByReason = {
-        cancelled: uniqueToDelete.filter(i => i.state.type === 'canceled' || i.state.type === 'cancelled'),
-        test: uniqueToDelete.filter(i => i.title.toLowerCase().includes('test')),
-        duplicate: uniqueToDelete.filter(i => 
-          !i.title.toLowerCase().includes('test') && 
-          i.state.type !== 'canceled' && 
-          i.state.type !== 'cancelled'
-        )
-      };
-      
-      console.log(`  Cancelled: ${deleteByReason.cancelled.length}`);
-      console.log(`  Test: ${deleteByReason.test.length}`);
-      console.log(`  Duplicate: ${deleteByReason.duplicate.length}`);
-      
-      // Save deletion list
-      const deletionList = uniqueToDelete.map(i => ({
-        id: i.id,
-        identifier: i.identifier,
-        title: i.title,
-        state: i.state.type,
-        reason: i.state.type === 'canceled' || i.state.type === 'cancelled' ? 'cancelled' :
-                i.title.toLowerCase().includes('test') ? 'test' : 'duplicate'
-      }));
-      
-      const filename = `linear-cleanup-${new Date().toISOString().split('T')[0]}.json`;
-      fs.writeFileSync(
-        path.join(__dirname, '..', filename),
-        JSON.stringify(deletionList, null, 2)
-      );
-      console.log(`\n💾 Deletion list saved to: ${filename}`);
-    }
-    
-    // Summary
-    console.log('\n📊 Final Summary:');
-    const activeIssues = allIssues.filter(i => 
-      i.state.type !== 'completed' && 
-      i.state.type !== 'canceled' && 
-      i.state.type !== 'cancelled'
-    );
-    console.log(`  Current backlog size: ${activeIssues.length}`);
-    console.log(`  After cleanup: ${activeIssues.length - uniqueToDelete.length}`);
-    console.log(`  Reduction: ${Math.round((uniqueToDelete.length / activeIssues.length) * 100)}%`);
-    
-    console.log('\n💡 Next Steps:');
-    console.log('  1. Review the deletion list in the JSON file');
-    console.log('  2. Use Linear\'s bulk operations to archive/delete');
-    console.log('  3. Run the hourly sync daemon: ./scripts/start-linear-sync-daemon.sh start');
-    
-  } catch (error) {
-    console.error('❌ Error analyzing Linear backlog:', error.message);
-  }
-}
-
-cleanLinearBacklog();

package/scripts/cleanup-old-sessions.sh

@@ -1,57 +0,0 @@
-#!/bin/bash
-
-# StackMemory Session Cleanup Script
-
-echo "🧹 StackMemory Session Cleanup"
-echo "=============================="
-
-SESSIONS_DIR="$HOME/.stackmemory/sessions"
-DAYS_TO_KEEP=7
-
-# Count current sessions
-TOTAL_SESSIONS=$(find "$SESSIONS_DIR" -type f -name "*.json" | wc -l | tr -d ' ')
-echo "📊 Total sessions: $TOTAL_SESSIONS"
-
-# Count old sessions
-OLD_SESSIONS=$(find "$SESSIONS_DIR" -type f -name "*.json" -mtime +$DAYS_TO_KEEP | wc -l | tr -d ' ')
-echo "🗓️  Sessions older than $DAYS_TO_KEEP days: $OLD_SESSIONS"
-
-if [ "$OLD_SESSIONS" -eq 0 ]; then
-    echo "✨ No old sessions to clean up!"
-    exit 0
-fi
-
-# Calculate space used
-SPACE_BEFORE=$(du -sh "$SESSIONS_DIR" | cut -f1)
-echo "💾 Current space used: $SPACE_BEFORE"
-
-# Ask for confirmation
-read -p "⚠️  Remove $OLD_SESSIONS sessions older than $DAYS_TO_KEEP days? (y/n) " -n 1 -r
-echo
-if [[ $REPLY =~ ^[Yy]$ ]]; then
-    # Create backup directory
-    BACKUP_DIR="$HOME/.stackmemory/session-backups/$(date +%Y%m%d_%H%M%S)"
-    mkdir -p "$BACKUP_DIR"
-    
-    echo "📦 Creating backup in $BACKUP_DIR..."
-    
-    # Move old sessions to backup (sample a few for backup)
-    find "$SESSIONS_DIR" -type f -name "*.json" -mtime +$DAYS_TO_KEEP -print0 | \
-        head -z -n 100 | \
-        xargs -0 -I {} cp {} "$BACKUP_DIR/" 2>/dev/null
-    
-    # Remove old sessions
-    find "$SESSIONS_DIR" -type f -name "*.json" -mtime +$DAYS_TO_KEEP -delete
-    
-    # Count remaining sessions
-    REMAINING=$(find "$SESSIONS_DIR" -type f -name "*.json" | wc -l | tr -d ' ')
-    SPACE_AFTER=$(du -sh "$SESSIONS_DIR" | cut -f1)
-    
-    echo "✅ Cleanup complete!"
-    echo "📊 Sessions removed: $((TOTAL_SESSIONS - REMAINING))"
-    echo "📊 Sessions remaining: $REMAINING"
-    echo "💾 Space after cleanup: $SPACE_AFTER"
-    echo "📦 Sample backup saved to: $BACKUP_DIR"
-else
-    echo "❌ Cleanup cancelled"
-fi

package/scripts/create-cleanup-issues.js

@@ -1,302 +0,0 @@
-#!/usr/bin/env node
-/**
- * Create cleanup issues in Linear
- */
-
-import dotenv from 'dotenv';
-import path from 'path';
-import { fileURLToPath } from 'url';
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-dotenv.config({ path: path.join(__dirname, '..', '.env') });
-
-const TEAM_ID = 'STA'; // Stackmemoryai team
-
-const cleanupTasks = [
-  {
-    title: 'Add tests for monitoring module (0% coverage)',
-    description: `## Problem
-The \`/src/core/monitoring/\` module has 0% test coverage.
-
-## Files affected
-- src/core/monitoring/logger.ts
-- src/core/monitoring/health-check.ts
-- src/core/monitoring/metrics-collector.ts
-- src/core/monitoring/performance-tracker.ts
-- src/core/monitoring/index.ts
-
-## Acceptance criteria
-- [ ] Add unit tests for all public functions
-- [ ] Test error handling paths
-- [ ] Achieve >80% coverage`,
-    priority: 2, // High
-    labels: ['tech-debt', 'testing'],
-  },
-  {
-    title: 'Add tests for performance module (0% coverage)',
-    description: `## Problem
-The \`/src/core/performance/\` module has 0% test coverage.
-
-## Files affected
-- src/core/performance/profiler.ts
-- src/core/performance/metrics.ts
-- src/core/performance/index.ts
-
-## Acceptance criteria
-- [ ] Add unit tests for profiler
-- [ ] Add unit tests for metrics collection
-- [ ] Achieve >80% coverage`,
-    priority: 2, // High
-    labels: ['tech-debt', 'testing'],
-  },
-  {
-    title: 'Add tests for session module (0% coverage)',
-    description: `## Problem
-The \`/src/core/session/\` module has 0% test coverage.
-
-## Files affected
-- src/core/session/session-manager.ts
-- src/core/session/enhanced-handoff.ts
-- src/core/session/index.ts
-
-## Acceptance criteria
-- [ ] Add unit tests for session lifecycle
-- [ ] Add unit tests for handoff
-- [ ] Achieve >80% coverage`,
-    priority: 2, // High
-    labels: ['tech-debt', 'testing'],
-  },
-  {
-    title: 'Add tests for claude-code integration (7 files, 0% coverage)',
-    description: `## Problem
-The \`/src/integrations/claude-code/\` module has no tests.
-
-## Files affected
-- src/integrations/claude-code/agent-bridge.ts
-- src/integrations/claude-code/context-injector.ts
-- src/integrations/claude-code/hook-manager.ts
-- src/integrations/claude-code/index.ts
-- src/integrations/claude-code/mcp-client.ts
-- src/integrations/claude-code/session-detector.ts
-- src/integrations/claude-code/types.ts
-
-## Acceptance criteria
-- [ ] Add unit tests for all modules
-- [ ] Mock external dependencies
-- [ ] Achieve >80% coverage`,
-    priority: 2, // High
-    labels: ['tech-debt', 'testing'],
-  },
-  {
-    title: 'Improve trace module test coverage (9%)',
-    description: `## Problem
-The \`/src/core/trace/\` module has only ~9% test coverage.
-
-## Files affected (11 files)
-- src/core/trace/trace-detector.ts
-- src/core/trace/trace-bundler.ts
-- src/core/trace/pattern-matcher.ts
-- And 8 more...
-
-## Acceptance criteria
-- [ ] Add tests for trace detection
-- [ ] Add tests for pattern matching
-- [ ] Add tests for trace bundling
-- [ ] Achieve >80% coverage`,
-    priority: 3, // Medium
-    labels: ['tech-debt', 'testing'],
-  },
-  {
-    title: 'Reorganize scripts directory (112 files)',
-    description: `## Problem
-The \`/scripts/\` directory has 112 files with no clear organization.
-
-## Proposed structure
-\`\`\`
-scripts/
-  setup/        # Installation & configuration
-  test/         # Test runners
-  cli/          # CLI wrappers
-  maintenance/  # Cleanup & sync tasks
-  demos/        # Demo & example scripts (DONE)
-  archive/      # Archived scripts
-\`\`\`
-
-## Acceptance criteria
-- [ ] Create subdirectories
-- [ ] Move scripts to appropriate directories
-- [ ] Update any references in package.json
-- [ ] Update documentation`,
-    priority: 4, // Low
-    labels: ['tech-debt', 'organization'],
-  },
-  {
-    title: 'Remove ESLint blanket exclusion of /src/integrations/',
-    description: `## Problem
-ESLint config (line 55) excludes entire \`/src/integrations/\` directory from linting.
-
-## Impact
-- Potential code quality issues not caught
-- Inconsistent code style
-- 33 warnings not shown
-
-## Acceptance criteria
-- [ ] Remove blanket exclusion from eslint.config.js
-- [ ] Fix any lint errors that appear
-- [ ] Keep specific exclusions only if truly needed`,
-    priority: 3, // Medium
-    labels: ['tech-debt', 'code-quality'],
-  },
-  {
-    title: 'Resolve service duplication (context-service.ts)',
-    description: `## Problem
-\`context-service.ts\` exists in two locations with different implementations:
-- /src/services/context-service.ts
-- /src/daemon/services/context-service.ts
-
-## Acceptance criteria
-- [ ] Analyze both implementations
-- [ ] Rename daemon version to DaemonContextService or consolidate
-- [ ] Update all imports
-- [ ] Document the difference if both needed`,
-    priority: 3, // Medium
-    labels: ['tech-debt', 'organization'],
-  },
-  {
-    title: 'Rename temporary-named files (refactored-*, enhanced-*)',
-    description: `## Problem
-Several files have temporary-sounding names:
-- refactored-frame-manager.ts
-- enhanced-hybrid-digest.ts
-- enhanced-rehydration.ts
-- enhanced-handoff.ts
-
-## Acceptance criteria
-- [ ] Rename to final names (remove prefix)
-- [ ] Update all imports
-- [ ] Verify tests pass`,
-    priority: 4, // Low
-    labels: ['tech-debt', 'naming'],
-  },
-  {
-    title: 'Add documentation for monitoring, trace, and performance modules',
-    description: `## Problem
-Critical modules lack documentation:
-- /src/core/monitoring/ - no docs
-- /src/core/trace/ - demos but no guide
-- /src/core/performance/ - no docs
-
-## Acceptance criteria
-- [ ] Add README.md or docs for each module
-- [ ] Document public APIs
-- [ ] Add usage examples`,
-    priority: 4, // Low
-    labels: ['documentation'],
-  },
-];
-
-async function queryLinear(query, variables = {}) {
-  const apiKey =
-    process.env.STACKMEMORY_LINEAR_API_KEY || process.env.LINEAR_API_KEY;
-  const response = await fetch('https://api.linear.app/graphql', {
-    method: 'POST',
-    headers: {
-      'Content-Type': 'application/json',
-      Authorization: apiKey,
-    },
-    body: JSON.stringify({ query, variables }),
-  });
-
-  const data = await response.json();
-  if (data.errors) {
-    throw new Error(data.errors[0].message);
-  }
-  return data.data;
-}
-
-async function getTeamId() {
-  const teams = await queryLinear(`
-    query {
-      teams {
-        nodes {
-          id
-          key
-          name
-        }
-      }
-    }
-  `);
-
-  const team = teams.teams.nodes.find((t) => t.key === TEAM_ID);
-  if (!team) {
-    throw new Error(`Team ${TEAM_ID} not found`);
-  }
-  return team.id;
-}
-
-async function createIssue(teamId, task) {
-  const mutation = `
-    mutation CreateIssue($input: IssueCreateInput!) {
-      issueCreate(input: $input) {
-        success
-        issue {
-          id
-          identifier
-          title
-          url
-        }
-      }
-    }
-  `;
-
-  const result = await queryLinear(mutation, {
-    input: {
-      teamId,
-      title: task.title,
-      description: task.description,
-      priority: task.priority,
-    },
-  });
-
-  return result.issueCreate;
-}
-
-async function main() {
-  const apiKey =
-    process.env.STACKMEMORY_LINEAR_API_KEY || process.env.LINEAR_API_KEY;
-  if (!apiKey) {
-    console.error('❌ LINEAR_API_KEY not set');
-    process.exit(1);
-  }
-
-  console.log('🔄 Connecting to Linear...');
-
-  // Verify connection
-  const viewer = await queryLinear('{ viewer { name email } }');
-  console.log(`✅ Connected as: ${viewer.viewer.name}`);
-
-  // Get team ID
-  const teamId = await getTeamId();
-  console.log(`📋 Team: ${TEAM_ID} (${teamId})\n`);
-
-  // Create issues
-  console.log(`Creating ${cleanupTasks.length} cleanup issues...\n`);
-
-  for (const task of cleanupTasks) {
-    try {
-      const result = await createIssue(teamId, task);
-      if (result.success) {
-        console.log(`✅ ${result.issue.identifier}: ${task.title}`);
-        console.log(`   ${result.issue.url}\n`);
-      } else {
-        console.log(`❌ Failed: ${task.title}`);
-      }
-    } catch (error) {
-      console.log(`❌ Error creating "${task.title}": ${error.message}`);
-    }
-  }
-
-  console.log('✅ Done!');
-}
-
-main().catch(console.error);