@stackmemoryai/stackmemory 0.5.6 → 0.5.8

package/dist/hooks/sms-notify.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/hooks/sms-notify.ts"],
+  "sourcesContent": ["/**\n * SMS Notification Hook for StackMemory\n * Sends text messages when tasks are ready for review\n * Supports interactive prompts with numbered options or yes/no\n *\n * Optional feature - requires Twilio setup\n */\n\nimport { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';\nimport { join } from 'path';\nimport { homedir } from 'os';\n\nexport interface SMSConfig {\n  enabled: boolean;\n  // Twilio credentials (from env or config)\n  accountSid?: string;\n  authToken?: string;\n  fromNumber?: string;\n  toNumber?: string;\n  // Webhook URL for receiving responses\n  webhookUrl?: string;\n  // Notification preferences\n  notifyOn: {\n    taskComplete: boolean;\n    reviewReady: boolean;\n    error: boolean;\n    custom: boolean;\n  };\n  // Quiet hours (don't send during these times)\n  quietHours?: {\n    enabled: boolean;\n    start: string; // \"22:00\"\n    end: string; // \"08:00\"\n  };\n  // Response timeout (seconds)\n  responseTimeout: number;\n  // Pending prompts awaiting response\n  pendingPrompts: PendingPrompt[];\n}\n\nexport interface PendingPrompt {\n  id: string;\n  timestamp: string;\n  message: string;\n  options: PromptOption[];\n  type: 'options' | 'yesno' | 'freeform';\n  callback?: string; // Command to run with response\n  expiresAt: string;\n}\n\nexport interface PromptOption {\n  key: string; // \"1\", \"2\", \"y\", \"n\", etc.\n  label: string;\n  action?: string; // Command to execute\n}\n\nexport interface NotificationPayload {\n  type: 'task_complete' | 'review_ready' | 'error' | 'custom';\n  title: string;\n  message: string;\n  prompt?: {\n    type: 'options' | 'yesno' | 'freeform';\n    options?: PromptOption[];\n    question?: string;\n  };\n  metadata?: Record<string, unknown>;\n}\n\nconst CONFIG_PATH = join(homedir(), '.stackmemory', 'sms-notify.json');\n\nconst DEFAULT_CONFIG: SMSConfig = {\n  enabled: false,\n  notifyOn: {\n    taskComplete: true,\n    reviewReady: true,\n    error: true,\n    custom: true,\n  },\n  quietHours: {\n    enabled: false,\n    start: '22:00',\n    end: '08:00',\n  },\n  responseTimeout: 300, // 5 minutes\n  pendingPrompts: [],\n};\n\nexport function loadSMSConfig(): SMSConfig {\n  try {\n    if (existsSync(CONFIG_PATH)) {\n      const data = readFileSync(CONFIG_PATH, 'utf8');\n      return { ...DEFAULT_CONFIG, ...JSON.parse(data) };\n    }\n  } catch {\n    // Use defaults\n  }\n\n  // Check environment variables\n  const config = { ...DEFAULT_CONFIG };\n  if (process.env['TWILIO_ACCOUNT_SID']) {\n    config.accountSid = process.env['TWILIO_ACCOUNT_SID'];\n  }\n  if (process.env['TWILIO_AUTH_TOKEN']) {\n    config.authToken = process.env['TWILIO_AUTH_TOKEN'];\n  }\n  if (process.env['TWILIO_FROM_NUMBER']) {\n    config.fromNumber = process.env['TWILIO_FROM_NUMBER'];\n  }\n  if (process.env['TWILIO_TO_NUMBER']) {\n    config.toNumber = process.env['TWILIO_TO_NUMBER'];\n  }\n\n  return config;\n}\n\nexport function saveSMSConfig(config: SMSConfig): void {\n  try {\n    const dir = join(homedir(), '.stackmemory');\n    if (!existsSync(dir)) {\n      mkdirSync(dir, { recursive: true });\n    }\n    // Don't save sensitive credentials to file\n    const safeConfig = { ...config };\n    delete safeConfig.accountSid;\n    delete safeConfig.authToken;\n    writeFileSync(CONFIG_PATH, JSON.stringify(safeConfig, null, 2));\n  } catch {\n    // Silently fail\n  }\n}\n\nfunction isQuietHours(config: SMSConfig): boolean {\n  if (!config.quietHours?.enabled) return false;\n\n  const now = new Date();\n  const currentTime = now.getHours() * 60 + now.getMinutes();\n\n  const [startH, startM] = config.quietHours.start.split(':').map(Number);\n  const [endH, endM] = config.quietHours.end.split(':').map(Number);\n\n  const startTime = startH * 60 + startM;\n  const endTime = endH * 60 + endM;\n\n  // Handle overnight quiet hours (e.g., 22:00 - 08:00)\n  if (startTime > endTime) {\n    return currentTime >= startTime || currentTime < endTime;\n  }\n\n  return currentTime >= startTime && currentTime < endTime;\n}\n\nfunction generatePromptId(): string {\n  return Math.random().toString(36).substring(2, 10);\n}\n\nfunction formatPromptMessage(payload: NotificationPayload): string {\n  let message = `${payload.title}\\n\\n${payload.message}`;\n\n  if (payload.prompt) {\n    message += '\\n\\n';\n\n    if (payload.prompt.question) {\n      message += `${payload.prompt.question}\\n`;\n    }\n\n    if (payload.prompt.type === 'yesno') {\n      message += 'Reply Y for Yes, N for No';\n    } else if (payload.prompt.type === 'options' && payload.prompt.options) {\n      payload.prompt.options.forEach((opt) => {\n        message += `${opt.key}. ${opt.label}\\n`;\n      });\n      message += '\\nReply with number to select';\n    } else if (payload.prompt.type === 'freeform') {\n      message += 'Reply with your response';\n    }\n  }\n\n  return message;\n}\n\nexport async function sendSMSNotification(\n  payload: NotificationPayload\n): Promise<{ success: boolean; promptId?: string; error?: string }> {\n  const config = loadSMSConfig();\n\n  if (!config.enabled) {\n    return { success: false, error: 'SMS notifications disabled' };\n  }\n\n  // Check notification type is enabled\n  const typeMap: Record<string, keyof typeof config.notifyOn> = {\n    task_complete: 'taskComplete',\n    review_ready: 'reviewReady',\n    error: 'error',\n    custom: 'custom',\n  };\n\n  if (!config.notifyOn[typeMap[payload.type]]) {\n    return {\n      success: false,\n      error: `Notifications for ${payload.type} disabled`,\n    };\n  }\n\n  // Check quiet hours\n  if (isQuietHours(config)) {\n    return { success: false, error: 'Quiet hours active' };\n  }\n\n  // Validate credentials\n  if (\n    !config.accountSid ||\n    !config.authToken ||\n    !config.fromNumber ||\n    !config.toNumber\n  ) {\n    return {\n      success: false,\n      error:\n        'Missing Twilio credentials. Set TWILIO_ACCOUNT_SID, TWILIO_AUTH_TOKEN, TWILIO_FROM_NUMBER, TWILIO_TO_NUMBER',\n    };\n  }\n\n  const message = formatPromptMessage(payload);\n  let promptId: string | undefined;\n\n  // Store pending prompt if interactive\n  if (payload.prompt) {\n    promptId = generatePromptId();\n    const expiresAt = new Date(\n      Date.now() + config.responseTimeout * 1000\n    ).toISOString();\n\n    const pendingPrompt: PendingPrompt = {\n      id: promptId,\n      timestamp: new Date().toISOString(),\n      message: payload.message,\n      options: payload.prompt.options || [],\n      type: payload.prompt.type,\n      expiresAt,\n    };\n\n    config.pendingPrompts.push(pendingPrompt);\n    saveSMSConfig(config);\n  }\n\n  try {\n    // Use Twilio API\n    const twilioUrl = `https://api.twilio.com/2010-04-01/Accounts/${config.accountSid}/Messages.json`;\n\n    const response = await fetch(twilioUrl, {\n      method: 'POST',\n      headers: {\n        Authorization:\n          'Basic ' +\n          Buffer.from(`${config.accountSid}:${config.authToken}`).toString(\n            'base64'\n          ),\n        'Content-Type': 'application/x-www-form-urlencoded',\n      },\n      body: new URLSearchParams({\n        From: config.fromNumber,\n        To: config.toNumber,\n        Body: message,\n      }),\n    });\n\n    if (!response.ok) {\n      const errorData = await response.text();\n      return { success: false, error: `Twilio error: ${errorData}` };\n    }\n\n    return { success: true, promptId };\n  } catch (err) {\n    return {\n      success: false,\n      error: `Failed to send SMS: ${err instanceof Error ? err.message : String(err)}`,\n    };\n  }\n}\n\nexport function processIncomingResponse(\n  from: string,\n  body: string\n): {\n  matched: boolean;\n  prompt?: PendingPrompt;\n  response?: string;\n  action?: string;\n} {\n  const config = loadSMSConfig();\n\n  // Normalize response\n  const response = body.trim().toLowerCase();\n\n  // Find matching pending prompt (most recent first)\n  const now = new Date();\n  const validPrompts = config.pendingPrompts.filter(\n    (p) => new Date(p.expiresAt) > now\n  );\n\n  if (validPrompts.length === 0) {\n    return { matched: false };\n  }\n\n  // Get most recent prompt\n  const prompt = validPrompts[validPrompts.length - 1];\n\n  let matchedOption: PromptOption | undefined;\n\n  if (prompt.type === 'yesno') {\n    if (response === 'y' || response === 'yes') {\n      matchedOption = { key: 'y', label: 'Yes' };\n    } else if (response === 'n' || response === 'no') {\n      matchedOption = { key: 'n', label: 'No' };\n    }\n  } else if (prompt.type === 'options') {\n    matchedOption = prompt.options.find(\n      (opt) => opt.key.toLowerCase() === response\n    );\n  } else if (prompt.type === 'freeform') {\n    matchedOption = { key: response, label: response };\n  }\n\n  // Remove processed prompt\n  config.pendingPrompts = config.pendingPrompts.filter(\n    (p) => p.id !== prompt.id\n  );\n  saveSMSConfig(config);\n\n  if (matchedOption) {\n    return {\n      matched: true,\n      prompt,\n      response: matchedOption.key,\n      action: matchedOption.action,\n    };\n  }\n\n  return { matched: false, prompt };\n}\n\n// Convenience functions for common notifications\n\nexport async function notifyReviewReady(\n  title: string,\n  description: string,\n  options?: { label: string; action?: string }[]\n): Promise<{ success: boolean; promptId?: string; error?: string }> {\n  const payload: NotificationPayload = {\n    type: 'review_ready',\n    title: `Review Ready: ${title}`,\n    message: description,\n  };\n\n  if (options && options.length > 0) {\n    payload.prompt = {\n      type: 'options',\n      options: options.map((opt, i) => ({\n        key: String(i + 1),\n        label: opt.label,\n        action: opt.action,\n      })),\n      question: 'What would you like to do?',\n    };\n  }\n\n  return sendSMSNotification(payload);\n}\n\nexport async function notifyWithYesNo(\n  title: string,\n  question: string,\n  yesAction?: string,\n  noAction?: string\n): Promise<{ success: boolean; promptId?: string; error?: string }> {\n  return sendSMSNotification({\n    type: 'custom',\n    title,\n    message: question,\n    prompt: {\n      type: 'yesno',\n      options: [\n        { key: 'y', label: 'Yes', action: yesAction },\n        { key: 'n', label: 'No', action: noAction },\n      ],\n    },\n  });\n}\n\nexport async function notifyTaskComplete(\n  taskName: string,\n  summary: string\n): Promise<{ success: boolean; error?: string }> {\n  return sendSMSNotification({\n    type: 'task_complete',\n    title: `Task Complete: ${taskName}`,\n    message: summary,\n  });\n}\n\nexport async function notifyError(\n  error: string,\n  context?: string\n): Promise<{ success: boolean; error?: string }> {\n  return sendSMSNotification({\n    type: 'error',\n    title: 'Error Alert',\n    message: context ? `${error}\\n\\nContext: ${context}` : error,\n  });\n}\n\n// Clean up expired prompts\nexport function cleanupExpiredPrompts(): number {\n  const config = loadSMSConfig();\n  const now = new Date();\n  const before = config.pendingPrompts.length;\n\n  config.pendingPrompts = config.pendingPrompts.filter(\n    (p) => new Date(p.expiresAt) > now\n  );\n\n  const removed = before - config.pendingPrompts.length;\n  if (removed > 0) {\n    saveSMSConfig(config);\n  }\n\n  return removed;\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/hooks/sms-webhook.js

@@ -0,0 +1,122 @@
+import { fileURLToPath as __fileURLToPath } from 'url';
+import { dirname as __pathDirname } from 'path';
+const __filename = __fileURLToPath(import.meta.url);
+const __dirname = __pathDirname(__filename);
+import { createServer } from "http";
+import { parse as parseUrl } from "url";
+import { processIncomingResponse, loadSMSConfig } from "./sms-notify.js";
+import { execSync } from "child_process";
+function parseFormData(body) {
+  const params = new URLSearchParams(body);
+  const result = {};
+  params.forEach((value, key) => {
+    result[key] = value;
+  });
+  return result;
+}
+function handleSMSWebhook(payload) {
+  const { From, Body } = payload;
+  console.log(`[sms-webhook] Received from ${From}: ${Body}`);
+  const result = processIncomingResponse(From, Body);
+  if (!result.matched) {
+    if (result.prompt) {
+      return {
+        response: `Invalid response. Expected: ${result.prompt.options.map((o) => o.key).join(", ")}`
+      };
+    }
+    return { response: "No pending prompt found." };
+  }
+  if (result.action) {
+    try {
+      console.log(`[sms-webhook] Executing action: ${result.action}`);
+      execSync(result.action, { stdio: "inherit" });
+      return {
+        response: `Got it! Executing: ${result.action}`,
+        action: result.action
+      };
+    } catch {
+      return {
+        response: `Received "${result.response}" but action failed.`,
+        action: result.action
+      };
+    }
+  }
+  return {
+    response: `Received: ${result.response}`
+  };
+}
+function twimlResponse(message) {
+  return `<?xml version="1.0" encoding="UTF-8"?>
+<Response>
+  <Message>${escapeXml(message)}</Message>
+</Response>`;
+}
+function escapeXml(str) {
+  return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
+}
+function startWebhookServer(port = 3456) {
+  const server = createServer(
+    async (req, res) => {
+      const url = parseUrl(req.url || "/", true);
+      if (url.pathname === "/health") {
+        res.writeHead(200, { "Content-Type": "application/json" });
+        res.end(JSON.stringify({ status: "ok" }));
+        return;
+      }
+      if (url.pathname === "/sms" && req.method === "POST") {
+        let body = "";
+        req.on("data", (chunk) => {
+          body += chunk;
+        });
+        req.on("end", () => {
+          try {
+            const payload = parseFormData(
+              body
+            );
+            const result = handleSMSWebhook(payload);
+            res.writeHead(200, { "Content-Type": "text/xml" });
+            res.end(twimlResponse(result.response));
+          } catch (err) {
+            console.error("[sms-webhook] Error:", err);
+            res.writeHead(500, { "Content-Type": "text/xml" });
+            res.end(twimlResponse("Error processing message"));
+          }
+        });
+        return;
+      }
+      if (url.pathname === "/status") {
+        const config = loadSMSConfig();
+        res.writeHead(200, { "Content-Type": "application/json" });
+        res.end(
+          JSON.stringify({
+            enabled: config.enabled,
+            pendingPrompts: config.pendingPrompts.length
+          })
+        );
+        return;
+      }
+      res.writeHead(404);
+      res.end("Not found");
+    }
+  );
+  server.listen(port, () => {
+    console.log(`[sms-webhook] Server listening on port ${port}`);
+    console.log(`[sms-webhook] Webhook URL: http://localhost:${port}/sms`);
+    console.log(`[sms-webhook] Configure this URL in Twilio console`);
+  });
+}
+function smsWebhookMiddleware(req, res) {
+  const result = handleSMSWebhook(req.body);
+  res.type("text/xml");
+  res.send(twimlResponse(result.response));
+}
+if (process.argv[1]?.endsWith("sms-webhook.js")) {
+  const port = parseInt(process.env["SMS_WEBHOOK_PORT"] || "3456", 10);
+  startWebhookServer(port);
+}
+export {
+  handleSMSWebhook,
+  smsWebhookMiddleware,
+  startWebhookServer
+};
+//# sourceMappingURL=sms-webhook.js.map

package/dist/hooks/sms-webhook.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/hooks/sms-webhook.ts"],
+  "sourcesContent": ["/**\n * SMS Webhook Handler for receiving Twilio responses\n * Can run as standalone server or integrate with existing Express app\n */\n\nimport { createServer, IncomingMessage, ServerResponse } from 'http';\nimport { parse as parseUrl } from 'url';\nimport { processIncomingResponse, loadSMSConfig } from './sms-notify.js';\nimport { execSync } from 'child_process';\n\ninterface TwilioWebhookPayload {\n  From: string;\n  To: string;\n  Body: string;\n  MessageSid: string;\n}\n\nfunction parseFormData(body: string): Record<string, string> {\n  const params = new URLSearchParams(body);\n  const result: Record<string, string> = {};\n  params.forEach((value, key) => {\n    result[key] = value;\n  });\n  return result;\n}\n\nexport function handleSMSWebhook(payload: TwilioWebhookPayload): {\n  response: string;\n  action?: string;\n} {\n  const { From, Body } = payload;\n\n  console.log(`[sms-webhook] Received from ${From}: ${Body}`);\n\n  const result = processIncomingResponse(From, Body);\n\n  if (!result.matched) {\n    if (result.prompt) {\n      return {\n        response: `Invalid response. Expected: ${result.prompt.options.map((o) => o.key).join(', ')}`,\n      };\n    }\n    return { response: 'No pending prompt found.' };\n  }\n\n  // Execute action if specified\n  if (result.action) {\n    try {\n      console.log(`[sms-webhook] Executing action: ${result.action}`);\n      execSync(result.action, { stdio: 'inherit' });\n      return {\n        response: `Got it! Executing: ${result.action}`,\n        action: result.action,\n      };\n    } catch {\n      return {\n        response: `Received \"${result.response}\" but action failed.`,\n        action: result.action,\n      };\n    }\n  }\n\n  return {\n    response: `Received: ${result.response}`,\n  };\n}\n\n// TwiML response helper\nfunction twimlResponse(message: string): string {\n  return `<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<Response>\n  <Message>${escapeXml(message)}</Message>\n</Response>`;\n}\n\nfunction escapeXml(str: string): string {\n  return str\n    .replace(/&/g, '&amp;')\n    .replace(/</g, '&lt;')\n    .replace(/>/g, '&gt;')\n    .replace(/\"/g, '&quot;')\n    .replace(/'/g, '&apos;');\n}\n\n// Standalone webhook server\nexport function startWebhookServer(port: number = 3456): void {\n  const server = createServer(\n    async (req: IncomingMessage, res: ServerResponse) => {\n      const url = parseUrl(req.url || '/', true);\n\n      // Health check\n      if (url.pathname === '/health') {\n        res.writeHead(200, { 'Content-Type': 'application/json' });\n        res.end(JSON.stringify({ status: 'ok' }));\n        return;\n      }\n\n      // SMS webhook endpoint\n      if (url.pathname === '/sms' && req.method === 'POST') {\n        let body = '';\n        req.on('data', (chunk) => {\n          body += chunk;\n        });\n\n        req.on('end', () => {\n          try {\n            const payload = parseFormData(\n              body\n            ) as unknown as TwilioWebhookPayload;\n            const result = handleSMSWebhook(payload);\n\n            res.writeHead(200, { 'Content-Type': 'text/xml' });\n            res.end(twimlResponse(result.response));\n          } catch (err) {\n            console.error('[sms-webhook] Error:', err);\n            res.writeHead(500, { 'Content-Type': 'text/xml' });\n            res.end(twimlResponse('Error processing message'));\n          }\n        });\n        return;\n      }\n\n      // Status endpoint\n      if (url.pathname === '/status') {\n        const config = loadSMSConfig();\n        res.writeHead(200, { 'Content-Type': 'application/json' });\n        res.end(\n          JSON.stringify({\n            enabled: config.enabled,\n            pendingPrompts: config.pendingPrompts.length,\n          })\n        );\n        return;\n      }\n\n      res.writeHead(404);\n      res.end('Not found');\n    }\n  );\n\n  server.listen(port, () => {\n    console.log(`[sms-webhook] Server listening on port ${port}`);\n    console.log(`[sms-webhook] Webhook URL: http://localhost:${port}/sms`);\n    console.log(`[sms-webhook] Configure this URL in Twilio console`);\n  });\n}\n\n// Express middleware for integration\nexport function smsWebhookMiddleware(\n  req: { body: TwilioWebhookPayload },\n  res: { type: (t: string) => void; send: (s: string) => void }\n): void {\n  const result = handleSMSWebhook(req.body);\n  res.type('text/xml');\n  res.send(twimlResponse(result.response));\n}\n\n// CLI entry\nif (process.argv[1]?.endsWith('sms-webhook.js')) {\n  const port = parseInt(process.env['SMS_WEBHOOK_PORT'] || '3456', 10);\n  startWebhookServer(port);\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stackmemoryai/stackmemory",
-  "version": "0.5.6",
+  "version": "0.5.8",
   "description": "Lossless memory runtime for AI coding tools - organizes context as a call stack instead of linear chat logs, with team collaboration and infinite retention",
   "engines": {
     "node": ">=20.0.0",

package/scripts/install-auto-background-hook.sh

@@ -0,0 +1,144 @@
+#!/bin/bash
+# Install auto-background hook for Claude Code
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+HOOK_SOURCE="$SCRIPT_DIR/../templates/claude-hooks/auto-background-hook.js"
+CLAUDE_DIR="$HOME/.claude"
+HOOKS_DIR="$CLAUDE_DIR/hooks"
+SETTINGS_FILE="$CLAUDE_DIR/settings.json"
+CONFIG_DIR="$HOME/.stackmemory"
+
+echo "Installing auto-background hook for Claude Code..."
+
+# Create directories
+mkdir -p "$HOOKS_DIR"
+mkdir -p "$CONFIG_DIR"
+
+# Copy hook script
+HOOK_DEST="$HOOKS_DIR/auto-background-hook.js"
+cp "$HOOK_SOURCE" "$HOOK_DEST"
+chmod +x "$HOOK_DEST"
+echo "Installed hook to $HOOK_DEST"
+
+# Create default config if not exists
+CONFIG_FILE="$CONFIG_DIR/auto-background.json"
+if [ ! -f "$CONFIG_FILE" ]; then
+  cat > "$CONFIG_FILE" << 'EOF'
+{
+  "enabled": true,
+  "timeoutMs": 5000,
+  "alwaysBackground": [
+    "npm install",
+    "npm ci",
+    "yarn install",
+    "pnpm install",
+    "bun install",
+    "npm run build",
+    "yarn build",
+    "pnpm build",
+    "cargo build",
+    "go build",
+    "make",
+    "npm test",
+    "npm run test",
+    "yarn test",
+    "pytest",
+    "jest",
+    "vitest",
+    "cargo test",
+    "docker build",
+    "docker-compose up",
+    "docker compose up",
+    "git clone",
+    "git fetch --all",
+    "npx tsc",
+    "tsc --noEmit",
+    "eslint .",
+    "npm run lint"
+  ],
+  "neverBackground": [
+    "vim",
+    "nvim",
+    "nano",
+    "less",
+    "more",
+    "top",
+    "htop",
+    "echo",
+    "cat",
+    "ls",
+    "pwd",
+    "cd",
+    "which",
+    "git status",
+    "git diff",
+    "git log"
+  ],
+  "verbose": false
+}
+EOF
+  echo "Created config at $CONFIG_FILE"
+fi
+
+# Update Claude Code settings
+if [ -f "$SETTINGS_FILE" ]; then
+  # Check if jq is available
+  if command -v jq &> /dev/null; then
+    # Backup existing settings
+    cp "$SETTINGS_FILE" "$SETTINGS_FILE.bak"
+
+    # Add hook to settings
+    HOOK_CMD="node $HOOK_DEST"
+
+    # Check if hooks.pre_tool_use exists
+    if jq -e '.hooks.pre_tool_use' "$SETTINGS_FILE" > /dev/null 2>&1; then
+      # Check if hook already added
+      if ! jq -e ".hooks.pre_tool_use | index(\"$HOOK_CMD\")" "$SETTINGS_FILE" > /dev/null 2>&1; then
+        jq ".hooks.pre_tool_use += [\"$HOOK_CMD\"]" "$SETTINGS_FILE" > "$SETTINGS_FILE.tmp"
+        mv "$SETTINGS_FILE.tmp" "$SETTINGS_FILE"
+        echo "Added hook to existing pre_tool_use array"
+      else
+        echo "Hook already configured"
+      fi
+    else
+      # Create hooks.pre_tool_use array
+      jq ".hooks = (.hooks // {}) | .hooks.pre_tool_use = [\"$HOOK_CMD\"]" "$SETTINGS_FILE" > "$SETTINGS_FILE.tmp"
+      mv "$SETTINGS_FILE.tmp" "$SETTINGS_FILE"
+      echo "Created hooks.pre_tool_use with auto-background hook"
+    fi
+  else
+    echo ""
+    echo "jq not found. Please manually add to $SETTINGS_FILE:"
+    echo ""
+    echo '  "hooks": {'
+    echo '    "pre_tool_use": ["node '$HOOK_DEST'"]'
+    echo '  }'
+  fi
+else
+  # Create new settings file
+  cat > "$SETTINGS_FILE" << EOF
+{
+  "hooks": {
+    "pre_tool_use": ["node $HOOK_DEST"]
+  }
+}
+EOF
+  echo "Created settings file with hook"
+fi
+
+echo ""
+echo "Auto-background hook installed!"
+echo ""
+echo "Configuration: $CONFIG_FILE"
+echo "  - Edit to customize which commands auto-background"
+echo "  - Set 'enabled': false to disable"
+echo "  - Set 'verbose': true for debug logging"
+echo ""
+echo "Commands that will auto-background:"
+echo "  - npm install/build/test"
+echo "  - yarn/pnpm/bun install"
+echo "  - docker build"
+echo "  - cargo/go build/test"
+echo "  - And more (see config)"

package/scripts/install-notify-hook.sh

@@ -0,0 +1,84 @@
+#!/bin/bash
+# Install SMS notification hook for Claude Code (optional)
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+HOOK_SOURCE="$SCRIPT_DIR/../templates/claude-hooks/notify-review-hook.js"
+CLAUDE_DIR="$HOME/.claude"
+HOOKS_DIR="$CLAUDE_DIR/hooks"
+SETTINGS_FILE="$CLAUDE_DIR/settings.json"
+
+echo "Installing SMS notification hook for Claude Code..."
+echo "(Optional feature - requires Twilio setup)"
+echo ""
+
+# Create directories
+mkdir -p "$HOOKS_DIR"
+
+# Copy hook script
+HOOK_DEST="$HOOKS_DIR/notify-review-hook.js"
+cp "$HOOK_SOURCE" "$HOOK_DEST"
+chmod +x "$HOOK_DEST"
+echo "Installed hook to $HOOK_DEST"
+
+# Update Claude Code settings
+if [ -f "$SETTINGS_FILE" ]; then
+  if command -v jq &> /dev/null; then
+    cp "$SETTINGS_FILE" "$SETTINGS_FILE.bak"
+
+    HOOK_CMD="node $HOOK_DEST"
+
+    # Add to post_tool_use hooks
+    if jq -e '.hooks.post_tool_use' "$SETTINGS_FILE" > /dev/null 2>&1; then
+      if ! jq -e ".hooks.post_tool_use | index(\"$HOOK_CMD\")" "$SETTINGS_FILE" > /dev/null 2>&1; then
+        jq ".hooks.post_tool_use += [\"$HOOK_CMD\"]" "$SETTINGS_FILE" > "$SETTINGS_FILE.tmp"
+        mv "$SETTINGS_FILE.tmp" "$SETTINGS_FILE"
+        echo "Added hook to post_tool_use array"
+      else
+        echo "Hook already configured"
+      fi
+    else
+      jq ".hooks = (.hooks // {}) | .hooks.post_tool_use = [\"$HOOK_CMD\"]" "$SETTINGS_FILE" > "$SETTINGS_FILE.tmp"
+      mv "$SETTINGS_FILE.tmp" "$SETTINGS_FILE"
+      echo "Created hooks.post_tool_use with notify hook"
+    fi
+  else
+    echo ""
+    echo "jq not found. Please manually add to $SETTINGS_FILE:"
+    echo ""
+    echo '  "hooks": {'
+    echo '    "post_tool_use": ["node '$HOOK_DEST'"]'
+    echo '  }'
+  fi
+else
+  cat > "$SETTINGS_FILE" << EOF
+{
+  "hooks": {
+    "post_tool_use": ["node $HOOK_DEST"]
+  }
+}
+EOF
+  echo "Created settings file with hook"
+fi
+
+echo ""
+echo "Notification hook installed!"
+echo ""
+echo "To enable SMS notifications:"
+echo "  1. Set Twilio environment variables:"
+echo "     export TWILIO_ACCOUNT_SID=your_sid"
+echo "     export TWILIO_AUTH_TOKEN=your_token"
+echo "     export TWILIO_FROM_NUMBER=+1234567890"
+echo "     export TWILIO_TO_NUMBER=+1234567890"
+echo ""
+echo "  2. Enable notifications:"
+echo "     stackmemory notify enable"
+echo ""
+echo "  3. Test:"
+echo "     stackmemory notify test"
+echo ""
+echo "Notifications will be sent when:"
+echo "  - PR is created (gh pr create)"
+echo "  - Package is published (npm publish)"
+echo "  - Deployment completes"

package/templates/claude-hooks/auto-background-hook.js

@@ -0,0 +1,156 @@
+#!/usr/bin/env node
+/**
+ * Claude Code pre-tool-use hook for auto-backgrounding commands
+ *
+ * Install: Add to ~/.claude/settings.json hooks.pre_tool_use
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const CONFIG_PATH = path.join(
+  os.homedir(),
+  '.stackmemory',
+  'auto-background.json'
+);
+
+const DEFAULT_CONFIG = {
+  enabled: true,
+  timeoutMs: 5000,
+  alwaysBackground: [
+    'npm install',
+    'npm ci',
+    'yarn install',
+    'pnpm install',
+    'bun install',
+    'npm run build',
+    'yarn build',
+    'pnpm build',
+    'cargo build',
+    'go build',
+    'make',
+    'npm test',
+    'npm run test',
+    'yarn test',
+    'pytest',
+    'jest',
+    'vitest',
+    'cargo test',
+    'docker build',
+    'docker-compose up',
+    'docker compose up',
+    'git clone',
+    'git fetch --all',
+    'npx tsc',
+    'tsc --noEmit',
+    'eslint .',
+    'npm run lint',
+  ],
+  neverBackground: [
+    'vim',
+    'nvim',
+    'nano',
+    'less',
+    'more',
+    'top',
+    'htop',
+    'echo',
+    'cat',
+    'ls',
+    'pwd',
+    'cd',
+    'which',
+    'git status',
+    'git diff',
+    'git log',
+  ],
+  verbose: false,
+};
+
+function loadConfig() {
+  try {
+    if (fs.existsSync(CONFIG_PATH)) {
+      return {
+        ...DEFAULT_CONFIG,
+        ...JSON.parse(fs.readFileSync(CONFIG_PATH, 'utf8')),
+      };
+    }
+  } catch {}
+  return DEFAULT_CONFIG;
+}
+
+function shouldAutoBackground(command, config) {
+  if (!config.enabled) return false;
+
+  const cmd = command.trim().toLowerCase();
+
+  // Never background these
+  for (const pattern of config.neverBackground) {
+    if (cmd.startsWith(pattern.toLowerCase())) return false;
+  }
+
+  // Always background these
+  for (const pattern of config.alwaysBackground) {
+    if (cmd.startsWith(pattern.toLowerCase())) return true;
+  }
+
+  return false;
+}
+
+// Read hook input from stdin
+let input = '';
+process.stdin.setEncoding('utf8');
+process.stdin.on('data', (chunk) => (input += chunk));
+process.stdin.on('end', () => {
+  try {
+    const hookData = JSON.parse(input);
+    const { tool_name, tool_input } = hookData;
+
+    // Only process Bash tool
+    if (tool_name !== 'Bash') {
+      // Allow other tools through unchanged
+      console.log(JSON.stringify({ decision: 'allow' }));
+      return;
+    }
+
+    const command = tool_input?.command;
+    if (!command) {
+      console.log(JSON.stringify({ decision: 'allow' }));
+      return;
+    }
+
+    // Already backgrounded
+    if (tool_input.run_in_background === true) {
+      console.log(JSON.stringify({ decision: 'allow' }));
+      return;
+    }
+
+    const config = loadConfig();
+
+    if (shouldAutoBackground(command, config)) {
+      if (config.verbose) {
+        console.error(
+          `[auto-bg] Backgrounding: ${command.substring(0, 60)}...`
+        );
+      }
+
+      // Modify the tool input to add run_in_background
+      console.log(
+        JSON.stringify({
+          decision: 'modify',
+          tool_input: {
+            ...tool_input,
+            run_in_background: true,
+          },
+        })
+      );
+    } else {
+      console.log(JSON.stringify({ decision: 'allow' }));
+    }
+  } catch (err) {
+    // On error, allow the command through unchanged
+    console.error('[auto-bg] Error:', err.message);
+    console.log(JSON.stringify({ decision: 'allow' }));
+  }
+});