@stackmemoryai/stackmemory 0.8.0 → 1.0.0

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

@@ -1,46 +0,0 @@
-#!/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

@@ -1,113 +0,0 @@
-#!/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

@@ -1,81 +0,0 @@
-#!/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

@@ -1,262 +0,0 @@
-#!/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 'stackmemory 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