@stackmemoryai/stackmemory 0.3.17 → 0.3.19

package/scripts/archive/setup-linear-oauth.sh

@@ -0,0 +1,46 @@
+#!/bin/bash
+
+# Linear OAuth Setup Script
+# Sets up environment variables for Linear OAuth integration
+
+echo "🔧 Setting up Linear OAuth environment..."
+
+# Load from .env.linear if it exists
+if [ -f ".env.linear" ]; then
+    echo "📄 Loading configuration from .env.linear"
+    export $(cat .env.linear | grep -v '^#' | xargs)
+else
+    echo "❌ .env.linear file not found!"
+    echo "Creating template .env.linear file..."
+    cat > .env.linear << 'EOF'
+# Linear OAuth Configuration
+# LINEAR_CLIENT_ID=your_client_id_here
+# LINEAR_CLIENT_SECRET=your_client_secret_here
+# LINEAR_OAUTH_TOKEN=your_oauth_token_here
+LINEAR_REDIRECT_URI=http://localhost:3456/auth/linear/callback
+EOF
+    echo "⚠️  Please edit .env.linear and add your Linear OAuth credentials"
+    exit 1
+fi
+
+# Verify environment variables are set
+if [ -z "$LINEAR_CLIENT_ID" ] || [ -z "$LINEAR_CLIENT_SECRET" ]; then
+    echo "❌ Error: LINEAR_CLIENT_ID or LINEAR_CLIENT_SECRET not set"
+    echo "Please check your .env.linear file"
+    exit 1
+fi
+
+echo "✅ Linear OAuth environment configured:"
+echo "   CLIENT_ID: ${LINEAR_CLIENT_ID:0:8}..."
+echo "   CLIENT_SECRET: ${LINEAR_CLIENT_SECRET:0:20}..."
+echo "   REDIRECT_URI: $LINEAR_REDIRECT_URI"
+echo ""
+echo "📝 Next steps:"
+echo "1. Ensure your Linear OAuth app redirect URI is set to:"
+echo "   $LINEAR_REDIRECT_URI"
+echo ""
+echo "2. Run authentication:"
+echo "   npx stackmemory linear auth"
+echo ""
+echo "3. Or use this script to set environment in current shell:"
+echo "   source scripts/setup-linear-oauth.sh"

package/scripts/archive/setup-mcp.sh

@@ -0,0 +1,113 @@
+#!/bin/bash
+
+# StackMemory MCP Setup Script
+# This script configures StackMemory as an MCP server for Claude Desktop
+
+set -e
+
+echo "🔧 StackMemory MCP Setup for Claude Desktop"
+echo "============================================"
+
+# Check if npm is installed
+if ! command -v npm &> /dev/null; then
+    echo "❌ npm is not installed. Please install Node.js first."
+    exit 1
+fi
+
+# Install or update StackMemory globally
+echo "📦 Installing/updating StackMemory..."
+npm install -g @stackmemoryai/stackmemory@latest
+
+# Get the global npm bin directory
+NPM_BIN=$(npm bin -g)
+STACKMEMORY_CMD="$NPM_BIN/stackmemory"
+
+# Check if stackmemory was installed
+if [ ! -f "$STACKMEMORY_CMD" ]; then
+    echo "❌ StackMemory installation failed"
+    exit 1
+fi
+
+echo "✅ StackMemory installed at: $STACKMEMORY_CMD"
+
+# Create Claude Desktop config directory if it doesn't exist
+CLAUDE_CONFIG_DIR="$HOME/Library/Application Support/Claude"
+mkdir -p "$CLAUDE_CONFIG_DIR"
+
+# Backup existing config if it exists
+CONFIG_FILE="$CLAUDE_CONFIG_DIR/claude_desktop_config.json"
+if [ -f "$CONFIG_FILE" ]; then
+    echo "📋 Backing up existing Claude config..."
+    cp "$CONFIG_FILE" "$CONFIG_FILE.backup.$(date +%Y%m%d_%H%M%S)"
+fi
+
+# Get current project directory
+DEFAULT_PROJECT="$PWD"
+read -p "Enter project directory for StackMemory [$DEFAULT_PROJECT]: " PROJECT_DIR
+PROJECT_DIR="${PROJECT_DIR:-$DEFAULT_PROJECT}"
+
+# Check for Linear API key
+read -p "Enter your Linear API key (optional, press Enter to skip): " LINEAR_KEY
+
+# Create the Claude Desktop configuration
+echo "📝 Creating Claude Desktop configuration..."
+
+# Build the config JSON
+CONFIG_JSON=$(cat <<EOF
+{
+  "mcpServers": {
+    "stackmemory": {
+      "command": "$STACKMEMORY_CMD",
+      "args": ["mcp-server", "--project", "$PROJECT_DIR"],
+      "env": {
+        "PROJECT_ROOT": "$PROJECT_DIR"
+EOF
+)
+
+# Add Linear API key if provided
+if [ -n "$LINEAR_KEY" ]; then
+    CONFIG_JSON+=",
+        \"LINEAR_API_KEY\": \"$LINEAR_KEY\""
+fi
+
+CONFIG_JSON+="
+      }
+    }
+  }
+}"
+
+# Write the configuration
+echo "$CONFIG_JSON" > "$CONFIG_FILE"
+
+echo "✅ Claude Desktop configuration created!"
+
+# Initialize StackMemory in the project if needed
+if [ ! -d "$PROJECT_DIR/.stackmemory" ]; then
+    echo "📂 Initializing StackMemory in project..."
+    cd "$PROJECT_DIR"
+    stackmemory init
+fi
+
+echo ""
+echo "🎉 Setup complete!"
+echo ""
+echo "📍 Configuration details:"
+echo "   - StackMemory: $STACKMEMORY_CMD"
+echo "   - Project: $PROJECT_DIR"
+echo "   - Config: $CONFIG_FILE"
+if [ -n "$LINEAR_KEY" ]; then
+    echo "   - Linear: Configured ✅"
+fi
+echo ""
+echo "🚀 Next steps:"
+echo "   1. Restart Claude Desktop"
+echo "   2. StackMemory will be available as an MCP server"
+echo "   3. Use 'stackmemory status' to verify setup"
+echo ""
+echo "📚 Available commands in Claude:"
+echo "   - save_context: Save important context"
+echo "   - load_context: Retrieve previous context"
+echo "   - review_recent: Review recent messages"
+echo "   - monitor_check: Manual checkpoint"
+echo ""
+echo "For more info: https://github.com/stackmemoryai/stackmemory"

package/scripts/archive/setup-railway-deployment.sh

@@ -0,0 +1,81 @@
+#!/bin/bash
+
+echo "🚂 Railway Deployment Setup Script"
+echo "=================================="
+echo ""
+echo "This script will guide you through setting up automatic Railway deployments"
+echo ""
+
+# Check if Railway CLI is installed
+if ! command -v railway &> /dev/null; then
+    echo "📦 Installing Railway CLI..."
+    npm install -g @railway/cli
+fi
+
+# Check if logged in to Railway
+echo "🔐 Checking Railway authentication..."
+if ! railway whoami &> /dev/null; then
+    echo "Please log in to Railway:"
+    railway login
+fi
+
+# Get project ID
+echo ""
+echo "🔍 Getting Railway project information..."
+RAILWAY_PROJECT_ID=$(railway status --json 2>/dev/null | jq -r '.projectId' 2>/dev/null)
+
+if [ -z "$RAILWAY_PROJECT_ID" ]; then
+    echo "No Railway project linked. Would you like to:"
+    echo "1) Link an existing project"
+    echo "2) Create a new project"
+    read -p "Choose option (1 or 2): " option
+    
+    if [ "$option" = "1" ]; then
+        railway link
+    else
+        railway init
+    fi
+    
+    RAILWAY_PROJECT_ID=$(railway status --json | jq -r '.projectId')
+fi
+
+# Get Railway token
+echo ""
+echo "🔑 To enable GitHub Actions deployment, you need a Railway API token."
+echo "   Visit: https://railway.app/account/tokens"
+echo "   Create a new token and copy it."
+echo ""
+read -p "Enter your Railway API token (it will be hidden): " -s RAILWAY_TOKEN
+echo ""
+
+# Display GitHub secrets to add
+echo ""
+echo "✅ Setup complete! Now add these secrets to your GitHub repository:"
+echo ""
+echo "1. Go to: https://github.com/$(git remote get-url origin | sed 's/.*github.com[:/]\(.*\)\.git/\1/')/settings/secrets/actions"
+echo ""
+echo "2. Add these repository secrets:"
+echo "   • RAILWAY_TOKEN = (your token - hidden for security)"
+echo "   • RAILWAY_PROJECT_ID = $RAILWAY_PROJECT_ID"
+echo ""
+echo "3. Railway deployments will trigger automatically on:"
+echo "   • Push to main/master branch → Production deployment"
+echo "   • Pull requests → Preview deployments"
+echo ""
+
+# Optional: Test deployment
+read -p "Would you like to test the deployment now? (y/n): " test_deploy
+if [ "$test_deploy" = "y" ]; then
+    echo ""
+    echo "🚀 Testing deployment..."
+    railway up --detach
+    echo "✅ Deployment initiated! Check your Railway dashboard for status."
+fi
+
+echo ""
+echo "📝 Additional configuration:"
+echo "   • Edit railway.json to customize build/deploy settings"
+echo "   • Edit .github/workflows/railway-deploy.yml to customize CI/CD"
+echo "   • Visit Railway dashboard to configure environment variables"
+echo ""
+echo "🎉 Railway deployment setup complete!"

package/scripts/auto-handoff.sh

@@ -0,0 +1,262 @@
+#!/bin/bash
+# Auto-handoff script for Claude session termination
+# Captures context and creates handoff file when Claude is killed
+
+set -e
+
+# Configuration
+STACKMEMORY_DIR="${HOME}/.stackmemory"
+HANDOFF_DIR="${STACKMEMORY_DIR}/handoffs"
+CURRENT_HANDOFF="${HANDOFF_DIR}/current.json"
+HANDOFF_ARCHIVE="${HANDOFF_DIR}/archive"
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Ensure directories exist
+mkdir -p "$HANDOFF_DIR" "$HANDOFF_ARCHIVE"
+
+# Function to capture current context
+capture_context() {
+    local timestamp=$(date +%Y%m%d_%H%M%S)
+    local handoff_file="${HANDOFF_DIR}/handoff_${timestamp}.json"
+    
+    echo -e "${BLUE}📸 Capturing session context...${NC}"
+    
+    # Capture git status
+    local git_status=""
+    local git_branch=""
+    local uncommitted_files=""
+    
+    if git rev-parse --git-dir > /dev/null 2>&1; then
+        git_branch=$(git branch --show-current)
+        git_status=$(git status --short)
+        uncommitted_files=$(git diff --name-only)
+    fi
+    
+    # Capture StackMemory context if available
+    local sm_context=""
+    local recent_traces=""
+    local active_tasks=""
+    
+    if command -v stackmemory &> /dev/null; then
+        sm_context=$(stackmemory context show --json 2>/dev/null || echo "{}")
+        recent_traces=$(stackmemory trace list --limit 5 --json 2>/dev/null || echo "[]")
+        active_tasks=$(stackmemory tasks list --status in_progress --json 2>/dev/null || echo "[]")
+    fi
+    
+    # Get current working directory and recent commands
+    local cwd=$(pwd)
+    local recent_commands=$(history | tail -20 | awk '{$1=""; print $0}' | sed 's/^ //')
+    
+    # Get modified files in last hour
+    local recent_files=$(find . -type f -mmin -60 2>/dev/null | head -20 || echo "")
+    
+    # Create handoff JSON
+    cat > "$handoff_file" << EOF
+{
+    "timestamp": "$timestamp",
+    "session": {
+        "cwd": "$cwd",
+        "user": "$USER",
+        "hostname": "$(hostname)",
+        "pid": "$$"
+    },
+    "git": {
+        "branch": "$git_branch",
+        "status": $(echo "$git_status" | jq -R -s -c 'split("\n") | map(select(length > 0))'),
+        "uncommitted": $(echo "$uncommitted_files" | jq -R -s -c 'split("\n") | map(select(length > 0))')
+    },
+    "stackmemory": {
+        "context": $sm_context,
+        "recent_traces": $recent_traces,
+        "active_tasks": $active_tasks
+    },
+    "files": {
+        "recently_modified": $(echo "$recent_files" | jq -R -s -c 'split("\n") | map(select(length > 0))'),
+        "open_in_editor": $(lsof -c vim -c nvim -c code 2>/dev/null | grep REG | awk '{print $NF}' | jq -R -s -c 'split("\n") | map(select(length > 0))' || echo "[]")
+    },
+    "commands": {
+        "recent": $(echo "$recent_commands" | jq -R -s -c 'split("\n") | map(select(length > 0))')
+    }
+}
+EOF
+    
+    # Create symlink to current handoff
+    ln -sf "$handoff_file" "$CURRENT_HANDOFF"
+    
+    echo -e "${GREEN}✅ Context captured: ${handoff_file}${NC}"
+    
+    # Generate handoff prompt
+    generate_handoff_prompt "$handoff_file"
+}
+
+# Function to generate handoff prompt from captured context
+generate_handoff_prompt() {
+    local handoff_file=$1
+    local prompt_file="${HANDOFF_DIR}/handoff_prompt.md"
+    
+    echo -e "${BLUE}📝 Generating handoff prompt...${NC}"
+    
+    # Parse JSON data
+    local timestamp=$(jq -r '.timestamp' "$handoff_file")
+    local cwd=$(jq -r '.session.cwd' "$handoff_file")
+    local git_branch=$(jq -r '.git.branch' "$handoff_file")
+    local uncommitted=$(jq -r '.git.uncommitted[]' "$handoff_file" 2>/dev/null | head -10)
+    local active_tasks=$(jq -r '.stackmemory.active_tasks[].content' "$handoff_file" 2>/dev/null)
+    local recent_files=$(jq -r '.files.recently_modified[]' "$handoff_file" 2>/dev/null | head -10)
+    
+    # Create handoff prompt
+    cat > "$prompt_file" << EOF
+# Session Handoff - $timestamp
+
+## Context
+Continuing work from previous session in \`$cwd\` on branch \`$git_branch\`.
+
+## Uncommitted Changes
+$(if [ -n "$uncommitted" ]; then
+    echo "The following files have uncommitted changes:"
+    echo "$uncommitted" | while read -r file; do
+        echo "- $file"
+    done
+else
+    echo "No uncommitted changes."
+fi)
+
+## Active Tasks
+$(if [ -n "$active_tasks" ]; then
+    echo "Tasks in progress:"
+    echo "$active_tasks" | while read -r task; do
+        echo "- $task"
+    done
+else
+    echo "No active tasks recorded."
+fi)
+
+## Recently Modified Files
+$(if [ -n "$recent_files" ]; then
+    echo "Files modified in the last hour:"
+    echo "$recent_files" | while read -r file; do
+        echo "- $file"
+    done | head -10
+else
+    echo "No recently modified files."
+fi)
+
+## Instructions
+Please continue the work from where we left off. Check the uncommitted changes and active tasks to understand what needs to be completed.
+
+---
+*Generated by auto-handoff on $(date)*
+EOF
+    
+    echo -e "${GREEN}✅ Handoff prompt saved: ${prompt_file}${NC}"
+}
+
+# Function to restore from handoff
+restore_handoff() {
+    if [ ! -f "$CURRENT_HANDOFF" ]; then
+        echo -e "${YELLOW}⚠️  No handoff file found${NC}"
+        return 1
+    fi
+    
+    echo -e "${BLUE}🔄 Restoring from handoff...${NC}"
+    
+    # Display handoff prompt if it exists
+    local prompt_file="${HANDOFF_DIR}/handoff_prompt.md"
+    if [ -f "$prompt_file" ]; then
+        echo -e "${GREEN}📋 Handoff Prompt:${NC}"
+        echo "----------------------------------------"
+        cat "$prompt_file"
+        echo "----------------------------------------"
+        
+        # Copy to clipboard if possible
+        if command -v pbcopy &> /dev/null; then
+            cat "$prompt_file" | pbcopy
+            echo -e "${GREEN}✅ Handoff prompt copied to clipboard${NC}"
+        elif command -v xclip &> /dev/null; then
+            cat "$prompt_file" | xclip -selection clipboard
+            echo -e "${GREEN}✅ Handoff prompt copied to clipboard${NC}"
+        fi
+    fi
+    
+    # Show git status
+    local git_branch=$(jq -r '.git.branch' "$CURRENT_HANDOFF")
+    if [ -n "$git_branch" ]; then
+        echo -e "${BLUE}Git branch: ${git_branch}${NC}"
+        git status --short
+    fi
+    
+    # Show active tasks
+    local active_tasks=$(jq -r '.stackmemory.active_tasks[].content' "$CURRENT_HANDOFF" 2>/dev/null)
+    if [ -n "$active_tasks" ]; then
+        echo -e "${BLUE}Active tasks:${NC}"
+        echo "$active_tasks" | while read -r task; do
+            echo "  • $task"
+        done
+    fi
+}
+
+# Function to clean old handoffs
+cleanup_handoffs() {
+    echo -e "${BLUE}🧹 Cleaning old handoffs...${NC}"
+    
+    # Archive handoffs older than 7 days
+    find "$HANDOFF_DIR" -name "handoff_*.json" -mtime +7 -exec mv {} "$HANDOFF_ARCHIVE" \; 2>/dev/null
+    
+    # Delete archives older than 30 days
+    find "$HANDOFF_ARCHIVE" -name "handoff_*.json" -mtime +30 -delete 2>/dev/null
+    
+    echo -e "${GREEN}✅ Cleanup complete${NC}"
+}
+
+# Signal handler for graceful shutdown
+handle_termination() {
+    echo -e "\n${YELLOW}⚠️  Session terminating...${NC}"
+    capture_context
+    echo -e "${GREEN}✨ Handoff complete! Run 'auto-handoff restore' to continue${NC}"
+    exit 0
+}
+
+# Main script logic
+case "${1:-}" in
+    capture)
+        capture_context
+        ;;
+    restore)
+        restore_handoff
+        ;;
+    cleanup)
+        cleanup_handoffs
+        ;;
+    watch)
+        # Set up signal handlers
+        trap handle_termination SIGINT SIGTERM SIGHUP
+        
+        echo -e "${BLUE}👀 Watching session... Press Ctrl+C to capture handoff${NC}"
+        echo -e "${YELLOW}Run this in your Claude session to enable auto-handoff${NC}"
+        
+        # Keep script running
+        while true; do
+            sleep 1
+        done
+        ;;
+    *)
+        echo "Usage: $0 {capture|restore|cleanup|watch}"
+        echo ""
+        echo "Commands:"
+        echo "  capture  - Manually capture current context"
+        echo "  restore  - Restore from last handoff"
+        echo "  cleanup  - Clean old handoff files"
+        echo "  watch    - Watch session and capture on termination"
+        echo ""
+        echo "Example:"
+        echo "  $0 watch    # Run in Claude session for auto-capture"
+        echo "  $0 restore  # Run in new session to get context"
+        exit 1
+        ;;
+esac