@stackmemoryai/stackmemory 0.3.16 → 0.3.18

package/scripts/start-linear-sync-daemon.sh

@@ -0,0 +1,141 @@
+#!/bin/bash
+
+# Linear Sync Daemon Launcher
+# Starts the Linear sync daemon in the background
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_DIR="$(dirname "$SCRIPT_DIR")"
+PID_FILE="$PROJECT_DIR/.stackmemory/linear-sync.pid"
+LOG_FILE="$PROJECT_DIR/.stackmemory/linear-sync.log"
+
+# Function to check if daemon is running
+is_running() {
+    if [ -f "$PID_FILE" ]; then
+        PID=$(cat "$PID_FILE")
+        if ps -p $PID > /dev/null 2>&1; then
+            return 0
+        fi
+    fi
+    return 1
+}
+
+# Function to start the daemon
+start_daemon() {
+    if is_running; then
+        echo "⚠️  Linear sync daemon is already running (PID: $(cat "$PID_FILE"))"
+        return 1
+    fi
+    
+    echo "🚀 Starting Linear sync daemon..."
+    
+    # Start the Node.js daemon in background
+    cd "$PROJECT_DIR"
+    nohup node scripts/linear-sync-daemon.js >> "$LOG_FILE" 2>&1 &
+    PID=$!
+    
+    # Save PID
+    echo $PID > "$PID_FILE"
+    
+    # Wait a moment and check if it started successfully
+    sleep 2
+    if is_running; then
+        echo "✅ Linear sync daemon started successfully (PID: $PID)"
+        echo "📄 Log file: $LOG_FILE"
+        echo "⏰ Syncing every hour in the background"
+        return 0
+    else
+        echo "❌ Failed to start Linear sync daemon"
+        rm -f "$PID_FILE"
+        return 1
+    fi
+}
+
+# Function to stop the daemon
+stop_daemon() {
+    if ! is_running; then
+        echo "⚠️  Linear sync daemon is not running"
+        return 1
+    fi
+    
+    PID=$(cat "$PID_FILE")
+    echo "🛑 Stopping Linear sync daemon (PID: $PID)..."
+    
+    kill $PID 2>/dev/null
+    
+    # Wait for process to stop
+    for i in {1..10}; do
+        if ! ps -p $PID > /dev/null 2>&1; then
+            break
+        fi
+        sleep 1
+    done
+    
+    # Force kill if still running
+    if ps -p $PID > /dev/null 2>&1; then
+        echo "⚠️  Process didn't stop gracefully, forcing..."
+        kill -9 $PID 2>/dev/null
+    fi
+    
+    rm -f "$PID_FILE"
+    echo "✅ Linear sync daemon stopped"
+}
+
+# Function to check daemon status
+status_daemon() {
+    if is_running; then
+        PID=$(cat "$PID_FILE")
+        echo "✅ Linear sync daemon is running (PID: $PID)"
+        
+        # Show last few log lines
+        if [ -f "$LOG_FILE" ]; then
+            echo ""
+            echo "📄 Recent activity:"
+            tail -n 5 "$LOG_FILE"
+        fi
+    else
+        echo "❌ Linear sync daemon is not running"
+    fi
+}
+
+# Function to show logs
+show_logs() {
+    if [ -f "$LOG_FILE" ]; then
+        tail -f "$LOG_FILE"
+    else
+        echo "❌ Log file not found: $LOG_FILE"
+    fi
+}
+
+# Parse command
+case "$1" in
+    start)
+        start_daemon
+        ;;
+    stop)
+        stop_daemon
+        ;;
+    restart)
+        stop_daemon
+        sleep 2
+        start_daemon
+        ;;
+    status)
+        status_daemon
+        ;;
+    logs)
+        show_logs
+        ;;
+    *)
+        echo "Linear Sync Daemon Manager"
+        echo ""
+        echo "Usage: $0 {start|stop|restart|status|logs}"
+        echo ""
+        echo "Commands:"
+        echo "  start    - Start the sync daemon"
+        echo "  stop     - Stop the sync daemon"
+        echo "  restart  - Restart the sync daemon"
+        echo "  status   - Check daemon status"
+        echo "  logs     - Show and follow logs"
+        exit 1
+        ;;
+esac

package/scripts/start-temporal-paradox.sh

@@ -0,0 +1,214 @@
+#!/bin/bash
+
+# 🌌 Temporal Paradox Chamber - Mission Launcher
+# STA-101: Stack Merge Conflict Resolution
+
+set -e
+
+# Colors for dramatic effect
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+BLUE='\033[0;34m'
+PURPLE='\033[0;35m'
+CYAN='\033[0;36m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+BOLD='\033[1m'
+
+# ASCII Art Welcome
+clear
+echo -e "${PURPLE}"
+cat << "EOF"
+╔═══════════════════════════════════════════════════════════════╗
+║                                                               ║
+║   ████████╗███████╗███╗   ███╗██████╗  ██████╗ ██████╗      ║
+║   ╚══██╔══╝██╔════╝████╗ ████║██╔══██╗██╔═══██╗██╔══██╗     ║
+║      ██║   █████╗  ██╔████╔██║██████╔╝██║   ██║██████╔╝     ║
+║      ██║   ██╔══╝  ██║╚██╔╝██║██╔═══╝ ██║   ██║██╔══██╗     ║
+║      ██║   ███████╗██║ ╚═╝ ██║██║     ╚██████╔╝██║  ██║     ║
+║      ╚═╝   ╚══════╝╚═╝     ╚═╝╚═╝      ╚═════╝ ╚═╝  ╚═╝     ║
+║                                                               ║
+║            P A R A D O X   C H A M B E R                      ║
+║                                                               ║
+╚═══════════════════════════════════════════════════════════════╝
+EOF
+echo -e "${NC}"
+
+# Mission briefing
+echo -e "${CYAN}${BOLD}MISSION BRIEFING:${NC}"
+echo -e "${YELLOW}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+echo -e "📋 ${BOLD}Task:${NC} STA-101 - Stack Merge Conflict Resolution"
+echo -e "⚡ ${BOLD}Difficulty:${NC} ████░ (4/5)"
+echo -e "⏱️  ${BOLD}Est. Time:${NC} 8 hours"
+echo -e "🎯 ${BOLD}Objective:${NC} Build the Temporal Reconciliation Engine"
+echo -e "${YELLOW}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+echo
+
+# Check prerequisites
+echo -e "${BLUE}${BOLD}Checking temporal stability...${NC}"
+sleep 1
+
+# Check if on correct branch
+CURRENT_BRANCH=$(git branch --show-current)
+if [ "$CURRENT_BRANCH" != "feature/STA-101-merge-conflicts" ]; then
+    echo -e "${YELLOW}⚠️  Not on mission branch. Creating temporal branch...${NC}"
+    git checkout -b feature/STA-101-merge-conflicts 2>/dev/null || git checkout feature/STA-101-merge-conflicts
+    echo -e "${GREEN}✓ Temporal branch established${NC}"
+else
+    echo -e "${GREEN}✓ Already in temporal branch${NC}"
+fi
+
+# Initialize mission structure
+echo -e "${BLUE}${BOLD}Initializing Temporal Reconciliation System...${NC}"
+sleep 1
+
+# Create directory structure
+mkdir -p src/core/merge
+mkdir -p src/core/merge/__tests__
+mkdir -p src/core/merge/strategies
+mkdir -p src/core/merge/visualizers
+
+# Create initial files if they don't exist
+if [ ! -f "src/core/merge/types.ts" ]; then
+    cat > src/core/merge/types.ts << 'TYPESCRIPT'
+/**
+ * Temporal Paradox Resolution Types
+ * STA-101: Stack Merge Conflict Resolution
+ */
+
+export interface MergeConflict {
+  id: string;
+  type: 'parallel_solution' | 'conflicting_decision' | 'structural_divergence';
+  frameId1: string;
+  frameId2: string;
+  severity: 'low' | 'medium' | 'high' | 'critical';
+  description: string;
+  detectedAt: number;
+}
+
+export interface ResolutionStrategy {
+  type: 'keep_both' | 'team_vote' | 'senior_override' | 'ai_suggest' | 'hybrid';
+  confidence: number;
+  reasoning?: string;
+}
+
+export interface StackDiff {
+  baseFrame: string;
+  branch1: string;
+  branch2: string;
+  divergencePoint: number;
+  conflicts: MergeConflict[];
+  commonAncestor?: string;
+}
+
+// TODO: Implement the rest of the type system
+TYPESCRIPT
+    echo -e "${GREEN}✓ Created types.ts${NC}"
+fi
+
+if [ ! -f "src/core/merge/conflict-detector.ts" ]; then
+    cat > src/core/merge/conflict-detector.ts << 'TYPESCRIPT'
+/**
+ * Conflict Detection Engine
+ * Detects paradoxes in parallel frame timelines
+ */
+
+import { MergeConflict, StackDiff } from './types.js';
+
+export class ConflictDetector {
+  /**
+   * Detect conflicts between two frame stacks
+   * TODO: Implement detection algorithm
+   */
+  detectConflicts(stack1: any, stack2: any): MergeConflict[] {
+    // Your implementation here
+    throw new Error('Temporal paradox detected! Implement detection algorithm.');
+  }
+}
+TYPESCRIPT
+    echo -e "${GREEN}✓ Created conflict-detector.ts${NC}"
+fi
+
+# Create test file
+if [ ! -f "src/core/merge/__tests__/conflict-scenarios.test.ts" ]; then
+    cat > src/core/merge/__tests__/conflict-scenarios.test.ts << 'TYPESCRIPT'
+/**
+ * Temporal Paradox Test Scenarios
+ */
+
+import { describe, it, expect } from 'vitest';
+import { ConflictDetector } from '../conflict-detector.js';
+
+describe('Temporal Paradox Resolution', () => {
+  describe('Level 1: Conflict Detection', () => {
+    it('should detect parallel solution conflicts', () => {
+      // TODO: Implement test
+      expect(true).toBe(false); // This will fail until you implement it!
+    });
+
+    it('should detect conflicting decisions', () => {
+      // TODO: Implement test
+      expect(true).toBe(false);
+    });
+
+    it('should detect structural divergence', () => {
+      // TODO: Implement test
+      expect(true).toBe(false);
+    });
+  });
+
+  // More test levels to be implemented...
+});
+TYPESCRIPT
+    echo -e "${GREEN}✓ Created test scenarios${NC}"
+fi
+
+# Status display
+echo
+echo -e "${PURPLE}${BOLD}╔═══════════════════════════════════════════════════════╗${NC}"
+echo -e "${PURPLE}${BOLD}║         TEMPORAL CHAMBER STATUS: INITIALIZED          ║${NC}"
+echo -e "${PURPLE}${BOLD}╚═══════════════════════════════════════════════════════╝${NC}"
+echo
+
+# Progress tracker
+echo -e "${CYAN}${BOLD}Progress Tracker:${NC}"
+echo -e "Level 1: Conflict Detector      [${RED}░░░░░░░░░░${NC}] 0%"
+echo -e "Level 2: Stack Diff Visualizer  [${RED}░░░░░░░░░░${NC}] 0%"
+echo -e "Level 3: Resolution Strategist  [${RED}░░░░░░░░░░${NC}] 0%"
+echo -e "Level 4: Merge Orchestrator     [${RED}░░░░░░░░░░${NC}] 0%"
+echo -e "Level 5: Paradox Prevention     [${RED}░░░░░░░░░░${NC}] 0%"
+echo
+
+# Available commands
+echo -e "${YELLOW}${BOLD}Available Commands:${NC}"
+echo -e "  ${GREEN}npm test -- src/core/merge${NC} - Run temporal tests"
+echo -e "  ${GREEN}npm run build${NC} - Compile the timeline"
+echo -e "  ${GREEN}npm run lint${NC} - Check temporal stability"
+echo -e "  ${GREEN}cat ESCAPE_ROOM_TEMPORAL_PARADOX.md${NC} - Review mission details"
+echo
+
+# Start timer
+echo -e "${RED}${BOLD}⏱️  Mission Timer Started!${NC}"
+echo -e "${CYAN}Time: $(date '+%H:%M:%S')${NC}"
+echo
+
+# Final message
+echo -e "${PURPLE}${BOLD}The timelines are diverging... ${NC}"
+echo -e "${PURPLE}${BOLD}Two realities cannot coexist... ${NC}"
+echo -e "${PURPLE}${BOLD}Only you can restore temporal harmony!${NC}"
+echo
+echo -e "${GREEN}${BOLD}>>> BEGIN MISSION <<<${NC}"
+echo
+echo -e "${YELLOW}Hint: Start by implementing the ConflictDetector class${NC}"
+echo -e "${YELLOW}Next step: ${CYAN}code src/core/merge/conflict-detector.ts${NC}"
+echo
+
+# Store mission start time
+echo "$(date +%s)" > .temporal-mission-start
+
+# Optional: Open VS Code
+read -p "Open VS Code in the merge directory? (y/n) " -n 1 -r
+echo
+if [[ $REPLY =~ ^[Yy]$ ]]; then
+    code src/core/merge/
+fi

package/scripts/status.ts

@@ -0,0 +1,159 @@
+#!/usr/bin/env tsx
+/**
+ * Check StackMemory status and statistics
+ */
+
+import Database from 'better-sqlite3';
+import { existsSync } from 'fs';
+import { join } from 'path';
+import chalk from 'chalk';
+
+interface CountResult {
+  count: number;
+}
+
+interface ContextRow {
+  type: string;
+  preview: string;
+  importance: number;
+  access_count: number;
+}
+
+interface FrameRow {
+  task: string;
+  started: string;
+}
+
+interface AttentionRow {
+  query_preview: string;
+  count: number;
+}
+
+const projectRoot = process.cwd();
+const dbPath = join(projectRoot, '.stackmemory', 'context.db');
+
+if (!existsSync(dbPath)) {
+  console.log(chalk.red('❌ StackMemory not initialized in this project'));
+  console.log(chalk.gray('Run: npm run init'));
+  process.exit(1);
+}
+
+const db = new Database(dbPath, { readonly: true });
+
+console.log(chalk.blue.bold('\n📊 StackMemory Status\n'));
+
+// Get statistics
+const stats = {
+  contexts: db
+    .prepare('SELECT COUNT(*) as count FROM contexts')
+    .get() as CountResult,
+  frames: db
+    .prepare('SELECT COUNT(*) as count FROM frames')
+    .get() as CountResult,
+  attention: db
+    .prepare('SELECT COUNT(*) as count FROM attention_log')
+    .get() as CountResult,
+};
+
+console.log(chalk.green('Database:') + ` ${dbPath}`);
+console.log(chalk.green('Contexts:') + ` ${stats.contexts.count}`);
+console.log(chalk.green('Frames:') + ` ${stats.frames.count}`);
+console.log(chalk.green('Attention logs:') + ` ${stats.attention.count}`);
+
+// Get top contexts by importance
+console.log(chalk.blue('\n🎯 Top Contexts by Importance:\n'));
+
+const topContexts = db
+  .prepare(
+    `
+  SELECT type, substr(content, 1, 60) as preview, importance, access_count
+  FROM contexts
+  ORDER BY importance DESC, access_count DESC
+  LIMIT 5
+`
+  )
+  .all() as ContextRow[];
+
+topContexts.forEach((ctx, i) => {
+  const importance = '●'.repeat(Math.round(ctx.importance * 5));
+  console.log(
+    chalk.cyan(`${i + 1}.`) +
+      ` [${ctx.type}] ` +
+      chalk.gray(`(${ctx.access_count} uses)`) +
+      ` ${importance}`
+  );
+  console.log(chalk.gray(`   ${ctx.preview}...`));
+});
+
+// Get active frames
+const activeFrames = db
+  .prepare(
+    `
+  SELECT task, datetime(created_at, 'unixepoch') as started
+  FROM frames
+  WHERE status = 'active'
+  ORDER BY created_at DESC
+  LIMIT 3
+`
+  )
+  .all() as FrameRow[];
+
+if (activeFrames.length > 0) {
+  console.log(chalk.blue('\n🔄 Active Tasks:\n'));
+  activeFrames.forEach((frame) => {
+    console.log(chalk.green('•') + ` ${frame.task}`);
+    console.log(chalk.gray(`  Started: ${frame.started}`));
+  });
+}
+
+// Get recent attention patterns
+const recentAttention = db
+  .prepare(
+    `
+  SELECT 
+    substr(query, 1, 50) as query_preview,
+    COUNT(*) as count
+  FROM attention_log
+  WHERE timestamp > unixepoch() - 86400
+  GROUP BY query_preview
+  ORDER BY count DESC
+  LIMIT 3
+`
+  )
+  .all() as AttentionRow[];
+
+if (recentAttention.length > 0) {
+  console.log(chalk.blue('\n👁️ Recent Query Patterns:\n'));
+  recentAttention.forEach((pattern) => {
+    console.log(
+      chalk.yellow('?') + ` "${pattern.query_preview}..." (${pattern.count}x)`
+    );
+  });
+}
+
+// Show context decay
+const oldContexts = db
+  .prepare(
+    `
+  SELECT COUNT(*) as count
+  FROM contexts
+  WHERE last_accessed < unixepoch() - 86400 * 7
+`
+  )
+  .get() as CountResult;
+
+if (oldContexts.count > 0) {
+  console.log(
+    chalk.yellow(
+      `\n⚠️  ${oldContexts.count} contexts haven't been accessed in 7+ days`
+    )
+  );
+}
+
+console.log(
+  chalk.gray(
+    '\n💡 Tip: Run "npm run analyze" for detailed attention analysis\n'
+  )
+);
+
+db.close();