@stackmemoryai/stackmemory 0.3.17 → 0.3.19

package/scripts/setup/configure-alias.js

@@ -0,0 +1,125 @@
+#!/usr/bin/env node
+
+import fs from 'fs';
+import os from 'os';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+const ALIAS_NAME = 'claude-sm';
+const WRAPPER_SCRIPT = 'claude-code-wrapper.sh';
+
+function getShellConfigFiles() {
+  const shell = process.env.SHELL || '';
+  const home = os.homedir();
+  const files = [];
+
+  if (shell.includes('zsh')) {
+    files.push(path.join(home, '.zshrc'));
+    // Also check .zprofile for some systems
+    const zprofile = path.join(home, '.zprofile');
+    if (fs.existsSync(zprofile)) {
+      files.push(zprofile);
+    }
+  }
+
+  if (shell.includes('bash') || !shell.includes('zsh')) {
+    const profilePath = path.join(home, '.bash_profile');
+    const rcPath = path.join(home, '.bashrc');
+    if (fs.existsSync(profilePath)) files.push(profilePath);
+    if (fs.existsSync(rcPath)) files.push(rcPath);
+  }
+
+  if (shell.includes('fish')) {
+    files.push(path.join(home, '.config', 'fish', 'config.fish'));
+  }
+
+  return files.length > 0 ? files : [path.join(home, '.bashrc')];
+}
+
+function setupAlias() {
+  try {
+    const wrapperPath = join(dirname(__dirname), 'scripts', WRAPPER_SCRIPT);
+
+    if (!fs.existsSync(wrapperPath)) {
+      console.log(`⚠️  Wrapper script not found at ${wrapperPath}`);
+      console.log(
+        '   Please ensure claude-code-wrapper.sh exists in the scripts directory'
+      );
+      return;
+    }
+
+    const configFiles = getShellConfigFiles();
+    const aliasLine = `alias ${ALIAS_NAME}="${wrapperPath}"`;
+    const marker = '# StackMemory Claude alias';
+    let alreadyConfigured = false;
+    let configuredIn = [];
+
+    for (const configFile of configFiles) {
+      let config = '';
+      if (fs.existsSync(configFile)) {
+        config = fs.readFileSync(configFile, 'utf8');
+      }
+
+      // Check if already has the alias (with marker or just the alias itself)
+      if (config.includes(marker) || config.includes(`alias ${ALIAS_NAME}=`)) {
+        configuredIn.push(configFile);
+        alreadyConfigured = true;
+        continue;
+      }
+
+      // Only add to primary shell config (first in the list)
+      if (configuredIn.length === 0 && configFiles.indexOf(configFile) === 0) {
+        const aliasBlock = `\n${marker}\n${aliasLine}\n`;
+        fs.appendFileSync(configFile, aliasBlock);
+        configuredIn.push(configFile);
+        console.log(`✅ Added ${ALIAS_NAME} alias to ${configFile}`);
+      }
+    }
+
+    if (alreadyConfigured && configuredIn.length > 0) {
+      console.log(
+        `✓ ${ALIAS_NAME} alias already configured in: ${configuredIn.join(', ')}`
+      );
+    } else if (configuredIn.length > 0) {
+      console.log(
+        `   Run 'source ${configuredIn[0]}' or restart your terminal to use it`
+      );
+      console.log(`   You can then use: ${ALIAS_NAME} [your message]`);
+    }
+  } catch (error) {
+    console.error('Error setting up alias:', error.message);
+    console.log('\nManual setup:');
+    console.log(`Add this line to your shell config file:`);
+    console.log(
+      `alias ${ALIAS_NAME}="${join(dirname(__dirname), 'scripts', WRAPPER_SCRIPT)}"`
+    );
+  }
+}
+
+if (process.argv.includes('--check')) {
+  const configFiles = getShellConfigFiles();
+  let found = false;
+
+  for (const configFile of configFiles) {
+    if (fs.existsSync(configFile)) {
+      const config = fs.readFileSync(configFile, 'utf8');
+      if (config.includes(`alias ${ALIAS_NAME}=`)) {
+        console.log(`✓ ${ALIAS_NAME} alias is configured in ${configFile}`);
+        found = true;
+        break;
+      }
+    }
+  }
+
+  if (!found) {
+    console.log(`✗ ${ALIAS_NAME} alias not found`);
+    process.exit(1);
+  }
+  process.exit(0);
+}
+
+setupAlias();

package/scripts/setup/configure-codex-alias.js

@@ -0,0 +1,161 @@
+#!/usr/bin/env node
+
+import fs from 'fs';
+import os from 'os';
+import path, { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+const ALIAS_NAME = 'codex-sm';
+const WRAPPER_SCRIPT = 'codex-wrapper.sh';
+
+function getShellConfigFiles() {
+  const shell = process.env.SHELL || '';
+  const home = os.homedir();
+  const files = [];
+
+  if (shell.includes('zsh')) {
+    files.push(path.join(home, '.zshrc'));
+    const zprofile = path.join(home, '.zprofile');
+    if (fs.existsSync(zprofile)) files.push(zprofile);
+  }
+
+  if (shell.includes('bash') || !shell.includes('zsh')) {
+    const profilePath = path.join(home, '.bash_profile');
+    const rcPath = path.join(home, '.bashrc');
+    if (fs.existsSync(profilePath)) files.push(profilePath);
+    if (fs.existsSync(rcPath)) files.push(rcPath);
+  }
+
+  if (shell.includes('fish')) {
+    files.push(path.join(home, '.config', 'fish', 'config.fish'));
+  }
+
+  return files.length > 0 ? files : [path.join(home, '.bashrc')];
+}
+
+function setupAlias() {
+  try {
+    const scriptsDir = dirname(__dirname);
+    const repoRoot = dirname(scriptsDir);
+    const distBin = join(repoRoot, 'dist', 'src', 'cli', 'codex-sm.js');
+    const wrapperPath = join(scriptsDir, WRAPPER_SCRIPT);
+
+    // Prefer TypeScript bin (built file); fallback to shell wrapper
+    const targetCmd = fs.existsSync(distBin)
+      ? `node ${distBin}`
+      : (fs.existsSync(wrapperPath)
+          ? `${wrapperPath}`
+          : null);
+
+    if (!targetCmd) {
+      console.log('⚠️  Neither built TS bin nor wrapper script found.');
+      console.log('   Build first: npm run build');
+      console.log(`   Or ensure ${WRAPPER_SCRIPT} exists in scripts/`);
+      return;
+    }
+
+    const configFiles = getShellConfigFiles();
+    const aliasLine = `alias ${ALIAS_NAME}="${targetCmd}"`;
+    const marker = '# StackMemory Codex alias';
+    let updatedOrConfigured = false;
+    const touched = [];
+
+    for (const configFile of configFiles) {
+      let config = '';
+      if (fs.existsSync(configFile)) config = fs.readFileSync(configFile, 'utf8');
+
+      // If already present, replace existing alias line in-place
+      if (config.includes(`alias ${ALIAS_NAME}=`)) {
+        const newConfig = config.replace(
+          new RegExp(`^.*alias\\s+${ALIAS_NAME}=.*$`, 'm'),
+          aliasLine
+        );
+        if (newConfig !== config) {
+          fs.writeFileSync(configFile, newConfig, 'utf8');
+          console.log(`✅ Updated ${ALIAS_NAME} alias in ${configFile}`);
+          updatedOrConfigured = true;
+          touched.push(configFile);
+          continue;
+        }
+      }
+
+      // Otherwise, add once to the first config file available
+      if (!updatedOrConfigured && configFiles.indexOf(configFile) === 0) {
+        const aliasBlock = `\n${marker}\n${aliasLine}\n`;
+        fs.appendFileSync(configFile, aliasBlock);
+        console.log(`✅ Added ${ALIAS_NAME} alias to ${configFile}`);
+        updatedOrConfigured = true;
+        touched.push(configFile);
+      }
+    }
+
+    if (touched.length > 0) {
+      console.log(`   Run 'source ${touched[0]}' or restart your terminal to use it`);
+      console.log(`   You can then use: ${ALIAS_NAME} [your message]`);
+    } else {
+      console.log(`ℹ️  No suitable shell config found to modify.`);
+    }
+
+    console.log(`\n📖 Usage:`);
+    console.log(`   ${ALIAS_NAME}                    # Start Codex with StackMemory`);
+    console.log(`   ${ALIAS_NAME} --auto-sync        # With Linear auto-sync`);
+    console.log(`   ${ALIAS_NAME} --sync-interval=10 # Custom sync interval (minutes)`);
+  } catch (error) {
+    console.error('Error setting up alias:', error.message);
+    console.log('\nManual setup:');
+    console.log(`Add this line to your shell config file:`);
+    console.log(`alias ${ALIAS_NAME}="${join(dirname(__dirname), WRAPPER_SCRIPT)}"`);
+  }
+}
+
+if (process.argv.includes('--check')) {
+  const configFiles = getShellConfigFiles();
+  let found = false;
+  for (const configFile of configFiles) {
+    if (fs.existsSync(configFile)) {
+      const config = fs.readFileSync(configFile, 'utf8');
+      if (config.includes(`alias ${ALIAS_NAME}=`)) {
+        console.log(`✓ ${ALIAS_NAME} alias is configured in ${configFile}`);
+        found = true;
+        break;
+      }
+    }
+  }
+  if (!found) {
+    console.log(`✗ ${ALIAS_NAME} alias not found`);
+    process.exit(1);
+  }
+  process.exit(0);
+}
+
+if (process.argv.includes('--remove')) {
+  const configFiles = getShellConfigFiles();
+  let removed = false;
+  for (const configFile of configFiles) {
+    if (fs.existsSync(configFile)) {
+      let config = fs.readFileSync(configFile, 'utf8');
+      const marker = '# StackMemory Codex alias';
+      if (config.includes(marker) || config.includes(`alias ${ALIAS_NAME}=`)) {
+        const lines = config.split('\n');
+        const newLines = [];
+        let skipNext = false;
+        for (const line of lines) {
+          if (line.includes(marker)) { skipNext = true; continue; }
+          if (skipNext && line.includes(`alias ${ALIAS_NAME}=`)) { skipNext = false; continue; }
+          skipNext = false;
+          newLines.push(line);
+        }
+        fs.writeFileSync(configFile, newLines.join('\n'));
+        console.log(`✅ Removed ${ALIAS_NAME} alias from ${configFile}`);
+        removed = true;
+      }
+    }
+  }
+  if (!removed) console.log(`✗ ${ALIAS_NAME} alias not found in any config file`);
+  process.exit(0);
+}
+
+setupAlias();

package/scripts/setup/configure-opencode-alias.js

@@ -0,0 +1,175 @@
+#!/usr/bin/env node
+
+import fs from 'fs';
+import os from 'os';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+const ALIAS_NAME = 'opencode-sm';
+const WRAPPER_SCRIPT = 'opencode-wrapper.sh';
+
+function getShellConfigFiles() {
+  const shell = process.env.SHELL || '';
+  const home = os.homedir();
+  const files = [];
+
+  if (shell.includes('zsh')) {
+    files.push(path.join(home, '.zshrc'));
+    // Also check .zprofile for some systems
+    const zprofile = path.join(home, '.zprofile');
+    if (fs.existsSync(zprofile)) {
+      files.push(zprofile);
+    }
+  }
+
+  if (shell.includes('bash') || !shell.includes('zsh')) {
+    const profilePath = path.join(home, '.bash_profile');
+    const rcPath = path.join(home, '.bashrc');
+    if (fs.existsSync(profilePath)) files.push(profilePath);
+    if (fs.existsSync(rcPath)) files.push(rcPath);
+  }
+
+  if (shell.includes('fish')) {
+    files.push(path.join(home, '.config', 'fish', 'config.fish'));
+  }
+
+  return files.length > 0 ? files : [path.join(home, '.bashrc')];
+}
+
+function setupAlias() {
+  try {
+    const wrapperPath = join(dirname(__dirname), WRAPPER_SCRIPT);
+
+    if (!fs.existsSync(wrapperPath)) {
+      console.log(`⚠️  Wrapper script not found at ${wrapperPath}`);
+      console.log(
+        '   Please ensure opencode-wrapper.sh exists in the scripts directory'
+      );
+      return;
+    }
+
+    const configFiles = getShellConfigFiles();
+    const aliasLine = `alias ${ALIAS_NAME}="${wrapperPath}"`;
+    const marker = '# StackMemory OpenCode alias';
+    let alreadyConfigured = false;
+    let configuredIn = [];
+
+    for (const configFile of configFiles) {
+      let config = '';
+      if (fs.existsSync(configFile)) {
+        config = fs.readFileSync(configFile, 'utf8');
+      }
+
+      // Check if already has the alias (with marker or just the alias itself)
+      if (config.includes(marker) || config.includes(`alias ${ALIAS_NAME}=`)) {
+        configuredIn.push(configFile);
+        alreadyConfigured = true;
+        continue;
+      }
+
+      // Only add to primary shell config (first in the list)
+      if (configuredIn.length === 0 && configFiles.indexOf(configFile) === 0) {
+        const aliasBlock = `\n${marker}\n${aliasLine}\n`;
+        fs.appendFileSync(configFile, aliasBlock);
+        configuredIn.push(configFile);
+        console.log(`✅ Added ${ALIAS_NAME} alias to ${configFile}`);
+      }
+    }
+
+    if (alreadyConfigured && configuredIn.length > 0) {
+      console.log(
+        `✓ ${ALIAS_NAME} alias already configured in: ${configuredIn.join(', ')}`
+      );
+    } else if (configuredIn.length > 0) {
+      console.log(
+        `   Run 'source ${configuredIn[0]}' or restart your terminal to use it`
+      );
+      console.log(`   You can then use: ${ALIAS_NAME} [your message]`);
+    }
+
+    console.log(`\n📖 Usage:`);
+    console.log(
+      `   ${ALIAS_NAME}                    # Start OpenCode with StackMemory`
+    );
+    console.log(`   ${ALIAS_NAME} --auto-sync        # With Linear auto-sync`);
+    console.log(
+      `   ${ALIAS_NAME} --sync-interval=10 # Custom sync interval (minutes)`
+    );
+  } catch (error) {
+    console.error('Error setting up alias:', error.message);
+    console.log('\nManual setup:');
+    console.log(`Add this line to your shell config file:`);
+    console.log(
+      `alias ${ALIAS_NAME}="${join(dirname(__dirname), WRAPPER_SCRIPT)}"`
+    );
+  }
+}
+
+if (process.argv.includes('--check')) {
+  const configFiles = getShellConfigFiles();
+  let found = false;
+
+  for (const configFile of configFiles) {
+    if (fs.existsSync(configFile)) {
+      const config = fs.readFileSync(configFile, 'utf8');
+      if (config.includes(`alias ${ALIAS_NAME}=`)) {
+        console.log(`✓ ${ALIAS_NAME} alias is configured in ${configFile}`);
+        found = true;
+        break;
+      }
+    }
+  }
+
+  if (!found) {
+    console.log(`✗ ${ALIAS_NAME} alias not found`);
+    process.exit(1);
+  }
+  process.exit(0);
+}
+
+if (process.argv.includes('--remove')) {
+  const configFiles = getShellConfigFiles();
+  let removed = false;
+
+  for (const configFile of configFiles) {
+    if (fs.existsSync(configFile)) {
+      let config = fs.readFileSync(configFile, 'utf8');
+      const marker = '# StackMemory OpenCode alias';
+
+      if (config.includes(marker)) {
+        // Remove the alias block
+        const lines = config.split('\n');
+        const newLines = [];
+        let skipNext = false;
+
+        for (const line of lines) {
+          if (line.includes(marker)) {
+            skipNext = true;
+            continue;
+          }
+          if (skipNext && line.includes(`alias ${ALIAS_NAME}=`)) {
+            skipNext = false;
+            continue;
+          }
+          skipNext = false;
+          newLines.push(line);
+        }
+
+        fs.writeFileSync(configFile, newLines.join('\n'));
+        console.log(`✅ Removed ${ALIAS_NAME} alias from ${configFile}`);
+        removed = true;
+      }
+    }
+  }
+
+  if (!removed) {
+    console.log(`✗ ${ALIAS_NAME} alias not found in any config file`);
+  }
+  process.exit(0);
+}
+
+setupAlias();

package/scripts/setup-claude-integration.js

@@ -0,0 +1,204 @@
+#!/usr/bin/env node
+/**
+ * StackMemory Claude Code Integration Setup
+ * Automatically configures Claude Code to use StackMemory MCP server
+ */
+
+import { execSync } from 'child_process';
+import { existsSync, mkdirSync, writeFileSync, readFileSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+
+const CLAUDE_CONFIG_DIR = join(homedir(), '.claude');
+const CLAUDE_CONFIG_FILE = join(CLAUDE_CONFIG_DIR, 'config.json');
+const STACKMEMORY_MCP_CONFIG = join(CLAUDE_CONFIG_DIR, 'stackmemory-mcp.json');
+const HOOKS_DIR = join(CLAUDE_CONFIG_DIR, 'hooks');
+const STACKMEMORY_HOOK = join(HOOKS_DIR, 'stackmemory_init.sh');
+
+console.log('🚀 Setting up StackMemory + Claude Code integration...\n');
+
+// 1. Create Claude config directory
+if (!existsSync(CLAUDE_CONFIG_DIR)) {
+  console.log('📁 Creating ~/.claude directory...');
+  mkdirSync(CLAUDE_CONFIG_DIR, { recursive: true });
+}
+
+// 2. Create hooks directory
+if (!existsSync(HOOKS_DIR)) {
+  console.log('📁 Creating ~/.claude/hooks directory...');
+  mkdirSync(HOOKS_DIR, { recursive: true });
+}
+
+// 3. Create StackMemory MCP configuration
+console.log('⚙️  Creating StackMemory MCP configuration...');
+const mcpConfig = {
+  mcpServers: {
+    stackmemory: {
+      command: "stackmemory",
+      args: ["mcp-server"],
+      env: {
+        NODE_ENV: "production"
+      }
+    }
+  }
+};
+
+writeFileSync(STACKMEMORY_MCP_CONFIG, JSON.stringify(mcpConfig, null, 2));
+console.log(`✅ Created: ${STACKMEMORY_MCP_CONFIG}`);
+
+// 4. Create session initialization hook
+console.log('🪝 Creating StackMemory session hook...');
+const hookScript = `#!/bin/bash
+# StackMemory Session Initialization Hook
+# Automatically loads context and starts frame tracking
+
+if [ -d "./.stackmemory" ]; then
+    echo "🧠 StackMemory context tracking active"
+    
+    # Show current stack status
+    STACK_STATUS=$(stackmemory status --project 2>/dev/null)
+    if echo "$STACK_STATUS" | grep -q "Stack depth: 0"; then
+        echo "📝 Starting fresh work session"
+    else
+        echo "📚 Resuming context stack:"
+        echo "$STACK_STATUS" | grep -E "(Stack depth|Active frames|└─)" | head -5
+    fi
+    
+    # Quick context summary
+    ACTIVE_TASKS=$(stackmemory status --project 2>/dev/null | grep -c "└─" || echo "0")
+    if [ "$ACTIVE_TASKS" -gt 0 ]; then
+        echo "📋 $ACTIVE_TASKS active frames loaded"
+    fi
+fi
+`;
+
+writeFileSync(STACKMEMORY_HOOK, hookScript);
+execSync(`chmod +x "${STACKMEMORY_HOOK}"`);
+console.log(`✅ Created: ${STACKMEMORY_HOOK}`);
+
+// 4b. Create startup hook with Linear sync
+const STARTUP_HOOK = join(HOOKS_DIR, 'on-startup');
+console.log('🪝 Creating StackMemory startup hook with Linear sync...');
+const startupHookScript = `#!/bin/bash
+# Auto-start StackMemory monitor on Claude Code startup
+
+# Start monitor if project has StackMemory
+if [ -d ".stackmemory" ]; then
+    stackmemory monitor --start 2>/dev/null || true
+    echo "🔍 StackMemory monitor started"
+fi
+
+# Load previous handoff if exists
+if [ -d ".stackmemory/handoffs" ]; then
+    stackmemory handoff --load 2>/dev/null || true
+fi
+
+# Check and restore from ledger if needed
+stackmemory clear --restore 2>/dev/null || true
+
+# Trigger Linear sync on StackMemory instance loading
+if [ -d ".stackmemory" ] && [ -f "scripts/sync-linear-graphql.js" ]; then
+    echo "🔄 Triggering Linear sync..."
+    npm run linear:sync >/dev/null 2>&1 || node scripts/sync-linear-graphql.js >/dev/null 2>&1 || true
+    echo "✅ Linear sync triggered"
+fi
+`;
+
+writeFileSync(STARTUP_HOOK, startupHookScript);
+execSync(`chmod +x "${STARTUP_HOOK}"`);
+console.log(`✅ Created: ${STARTUP_HOOK}`);
+
+// 5. Update or create Claude config.json
+console.log('📝 Updating Claude Code configuration...');
+
+let claudeConfig = {};
+if (existsSync(CLAUDE_CONFIG_FILE)) {
+  try {
+    const existing = readFileSync(CLAUDE_CONFIG_FILE, 'utf-8');
+    claudeConfig = JSON.parse(existing);
+    console.log('   Found existing config, merging...');
+  } catch (error) {
+    console.log('   Existing config invalid, creating new...');
+  }
+}
+
+// Merge configuration
+if (!claudeConfig.mcp) {
+  claudeConfig.mcp = {};
+}
+
+if (!claudeConfig.mcp.configFiles) {
+  claudeConfig.mcp.configFiles = [];
+}
+
+// Add StackMemory MCP config if not already present
+if (!claudeConfig.mcp.configFiles.includes(STACKMEMORY_MCP_CONFIG)) {
+  claudeConfig.mcp.configFiles.push(STACKMEMORY_MCP_CONFIG);
+}
+
+// Update session start hook
+if (!claudeConfig.hooks) {
+  claudeConfig.hooks = {};
+}
+
+if (!claudeConfig.hooks.session_start) {
+  claudeConfig.hooks.session_start = [];
+} else if (typeof claudeConfig.hooks.session_start === 'string') {
+  claudeConfig.hooks.session_start = [claudeConfig.hooks.session_start];
+}
+
+// Add StackMemory hook if not already present
+if (!claudeConfig.hooks.session_start.includes(STACKMEMORY_HOOK)) {
+  claudeConfig.hooks.session_start.unshift(STACKMEMORY_HOOK);
+}
+
+writeFileSync(CLAUDE_CONFIG_FILE, JSON.stringify(claudeConfig, null, 2));
+console.log(`✅ Updated: ${CLAUDE_CONFIG_FILE}`);
+
+// 6. Verify setup
+console.log('\n🔍 Verifying setup...');
+
+try {
+  // Check if stackmemory command is available
+  execSync('stackmemory --version', { stdio: 'ignore' });
+  console.log('✅ StackMemory CLI available');
+} catch {
+  console.log('⚠️  StackMemory CLI not in PATH - you may need to restart your terminal');
+}
+
+try {
+  // Check if Claude Code is available
+  execSync('claude --help', { stdio: 'ignore' });
+  console.log('✅ Claude Code available');
+} catch {
+  console.log('⚠️  Claude Code not found - install from https://claude.ai/code');
+}
+
+// 7. Usage instructions
+console.log(`
+🎉 Setup complete! 
+
+📋 To use StackMemory with Claude Code:
+
+1. Initialize StackMemory in your project:
+   cd your-project
+   stackmemory init
+
+2. Start Claude Code (will auto-load StackMemory):
+   claude
+
+3. Or explicitly load StackMemory MCP:
+   claude --mcp-config ~/.claude/stackmemory-mcp.json
+
+📚 Available MCP tools in Claude Code:
+   • start_frame, close_frame - Frame lifecycle
+   • create_task, get_active_tasks - Task management  
+   • linear_sync, linear_status - Linear integration
+   • get_context, add_decision - Context management
+
+📖 Full documentation: docs/claude-code-integration.md
+
+🔧 To reconfigure: npm run claude:setup
+`);
+
+console.log('✨ Integration setup successful!');