@stackmemoryai/stackmemory 0.8.0 → 1.0.0

package/templates/claude-hooks/notify-review-hook.js

@@ -1,360 +0,0 @@
-#!/usr/bin/env node
-/**
- * Claude Code hook for WhatsApp/SMS notifications
- *
- * Triggers notifications when:
- * - AskUserQuestion tool is used (allows remote response)
- * - PR is created
- * - Task is marked complete
- * - User explicitly requests notification
- *
- * Install: stackmemory notify install-hook
- */
-
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
-const https = require('https');
-
-// Load .env files (check multiple locations)
-const envPaths = [
-  path.join(process.cwd(), '.env'),
-  path.join(os.homedir(), 'Dev/stackmemory/.env'),
-  path.join(os.homedir(), '.stackmemory/.env'),
-  path.join(os.homedir(), '.env'),
-];
-for (const envPath of envPaths) {
-  if (fs.existsSync(envPath)) {
-    try {
-      const content = fs.readFileSync(envPath, 'utf8');
-      for (const line of content.split('\n')) {
-        const match = line.match(/^([^#=]+)=(.*)$/);
-        if (match && !process.env[match[1].trim()]) {
-          process.env[match[1].trim()] = match[2]
-            .trim()
-            .replace(/^["']|["']$/g, '');
-        }
-      }
-    } catch {}
-  }
-}
-
-const CONFIG_PATH = path.join(os.homedir(), '.stackmemory', 'sms-notify.json');
-const DEBUG_LOG = path.join(
-  os.homedir(),
-  '.stackmemory',
-  'claude-session-debug.log'
-);
-
-function loadConfig() {
-  try {
-    if (fs.existsSync(CONFIG_PATH)) {
-      return JSON.parse(fs.readFileSync(CONFIG_PATH, 'utf8'));
-    }
-  } catch {}
-  return { enabled: false, pendingPrompts: [] };
-}
-
-function saveConfig(config) {
-  try {
-    const dir = path.join(os.homedir(), '.stackmemory');
-    if (!fs.existsSync(dir)) {
-      fs.mkdirSync(dir, { recursive: true });
-    }
-    fs.writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2));
-  } catch (err) {
-    console.error('[notify-hook] Failed to save config:', err.message);
-  }
-}
-
-function logDebug(event, data) {
-  try {
-    const entry = `[${new Date().toISOString()}] ${event}: ${typeof data === 'string' ? data : JSON.stringify(data)}\n`;
-    fs.appendFileSync(DEBUG_LOG, entry);
-  } catch {}
-}
-
-function savePendingPrompt(prompt) {
-  try {
-    const config = loadConfig();
-    if (!config.pendingPrompts) {
-      config.pendingPrompts = [];
-    }
-    config.pendingPrompts.push(prompt);
-    // Keep only last 10 prompts
-    if (config.pendingPrompts.length > 10) {
-      config.pendingPrompts = config.pendingPrompts.slice(-10);
-    }
-    saveConfig(config);
-    logDebug('PENDING_PROMPT', {
-      id: prompt.id,
-      options: prompt.options.length,
-    });
-  } catch (err) {
-    console.error('[notify-hook] Failed to save pending prompt:', err.message);
-  }
-}
-
-function shouldNotify(toolName, toolInput, output) {
-  const config = loadConfig();
-  if (!config.enabled) return null;
-
-  // AskUserQuestion - send question via WhatsApp for remote response
-  if (toolName === 'AskUserQuestion') {
-    const questions = toolInput?.questions || [];
-    if (questions.length === 0) return null;
-
-    // Take first question (most common case)
-    const q = questions[0];
-    const promptId = Math.random().toString(36).substring(2, 10);
-
-    // Build message text
-    let messageText = q.question;
-    const options = [];
-
-    if (q.options && q.options.length > 0) {
-      messageText += '\n';
-      q.options.forEach((opt, i) => {
-        const key = String(i + 1);
-        messageText += `${key}. ${opt.label}`;
-        if (opt.description) {
-          messageText += ` - ${opt.description}`;
-        }
-        messageText += '\n';
-        options.push({ key, label: opt.label });
-      });
-      // Add "Other" option
-      const otherKey = String(q.options.length + 1);
-      messageText += `${otherKey}. Other (type your answer)`;
-      options.push({ key: otherKey, label: 'Other' });
-    }
-
-    // Store pending prompt in format webhook expects
-    const pendingPrompt = {
-      id: promptId,
-      timestamp: new Date().toISOString(),
-      message: q.question,
-      options: options,
-      type: options.length > 0 ? 'options' : 'freeform',
-      expiresAt: new Date(Date.now() + 60 * 60 * 1000).toISOString(), // 1 hour
-    };
-    savePendingPrompt(pendingPrompt);
-
-    return {
-      type: 'custom',
-      title: 'Claude needs your input',
-      message: messageText,
-      promptId: promptId,
-      isQuestion: true,
-    };
-  }
-
-  // Check for PR creation
-  if (toolName === 'Bash') {
-    const cmd = toolInput?.command || '';
-    const out = output || '';
-
-    // gh pr create
-    if (cmd.includes('gh pr create') && out.includes('github.com')) {
-      const prUrl = out.match(/https:\/\/github\.com\/[^\s]+\/pull\/\d+/)?.[0];
-      return {
-        type: 'review_ready',
-        title: 'PR Ready for Review',
-        message: prUrl || 'Pull request created successfully',
-        options: ['Approve', 'Review', 'Skip'],
-      };
-    }
-
-    // npm publish
-    if (cmd.includes('npm publish') && out.includes('+')) {
-      const pkg = out.match(/\+ ([^\s]+)/)?.[1];
-      return {
-        type: 'task_complete',
-        title: 'Package Published',
-        message: pkg ? `Published ${pkg}` : 'Package published successfully',
-      };
-    }
-
-    // Deployment
-    if (
-      (cmd.includes('deploy') || cmd.includes('railway up')) &&
-      (out.includes('deployed') || out.includes('success'))
-    ) {
-      return {
-        type: 'review_ready',
-        title: 'Deployment Complete',
-        message: 'Ready for verification',
-        options: ['Verify', 'Rollback', 'Skip'],
-      };
-    }
-  }
-
-  return null;
-}
-
-function getChannelNumbers(config) {
-  const channel = config.channel || 'whatsapp';
-
-  if (channel === 'whatsapp') {
-    const from = config.whatsappFromNumber || config.fromNumber;
-    const to = config.whatsappToNumber || config.toNumber;
-    if (from && to) {
-      return {
-        from: from.startsWith('whatsapp:') ? from : `whatsapp:${from}`,
-        to: to.startsWith('whatsapp:') ? to : `whatsapp:${to}`,
-        channel: 'whatsapp',
-      };
-    }
-  }
-
-  // Fallback to SMS
-  const from = config.smsFromNumber || config.fromNumber;
-  const to = config.smsToNumber || config.toNumber;
-  if (from && to) {
-    return { from, to, channel: 'sms' };
-  }
-
-  return null;
-}
-
-function sendNotification(notification) {
-  let config = loadConfig();
-
-  // Apply env vars
-  config.accountSid = config.accountSid || process.env.TWILIO_ACCOUNT_SID;
-  config.authToken = config.authToken || process.env.TWILIO_AUTH_TOKEN;
-  config.channel = config.channel || process.env.TWILIO_CHANNEL || 'whatsapp';
-
-  // WhatsApp numbers
-  config.whatsappFromNumber =
-    config.whatsappFromNumber || process.env.TWILIO_WHATSAPP_FROM;
-  config.whatsappToNumber =
-    config.whatsappToNumber || process.env.TWILIO_WHATSAPP_TO;
-
-  // SMS numbers (fallback)
-  config.smsFromNumber =
-    config.smsFromNumber ||
-    process.env.TWILIO_SMS_FROM ||
-    process.env.TWILIO_FROM_NUMBER;
-  config.smsToNumber =
-    config.smsToNumber ||
-    process.env.TWILIO_SMS_TO ||
-    process.env.TWILIO_TO_NUMBER;
-
-  // Legacy support
-  config.fromNumber = config.fromNumber || process.env.TWILIO_FROM_NUMBER;
-  config.toNumber = config.toNumber || process.env.TWILIO_TO_NUMBER;
-
-  if (!config.accountSid || !config.authToken) {
-    console.error('[notify-hook] Missing Twilio credentials');
-    return;
-  }
-
-  const numbers = getChannelNumbers(config);
-  if (!numbers) {
-    console.error(
-      '[notify-hook] Missing phone numbers for channel:',
-      config.channel
-    );
-    return;
-  }
-
-  let message = `${notification.title}\n\n${notification.message}`;
-
-  if (notification.options) {
-    message += '\n\n';
-    notification.options.forEach((opt, i) => {
-      message += `${i + 1}. ${opt}\n`;
-    });
-    message += '\nReply with number to select';
-  }
-
-  // For questions, add reply instruction
-  if (notification.isQuestion) {
-    message += '\n\nReply with your choice number or type your answer.';
-    if (notification.promptId) {
-      message += `\n[ID: ${notification.promptId}]`;
-    }
-  }
-
-  // Add session link if available
-  if (notification.sessionId) {
-    message += `\n\nSession: https://claude.ai/share/${notification.sessionId}`;
-  }
-
-  const postData = new URLSearchParams({
-    From: numbers.from,
-    To: numbers.to,
-    Body: message,
-  }).toString();
-
-  const options = {
-    hostname: 'api.twilio.com',
-    port: 443,
-    path: `/2010-04-01/Accounts/${config.accountSid}/Messages.json`,
-    method: 'POST',
-    headers: {
-      Authorization:
-        'Basic ' +
-        Buffer.from(`${config.accountSid}:${config.authToken}`).toString(
-          'base64'
-        ),
-      'Content-Type': 'application/x-www-form-urlencoded',
-      'Content-Length': Buffer.byteLength(postData),
-    },
-  };
-
-  const req = https.request(options, (res) => {
-    let body = '';
-    res.on('data', (chunk) => (body += chunk));
-    res.on('end', () => {
-      if (res.statusCode === 201) {
-        console.error(
-          `[notify-hook] Sent via ${numbers.channel}: ${notification.title}`
-        );
-        logDebug('MESSAGE_SENT', {
-          channel: numbers.channel,
-          title: notification.title,
-          promptId: notification.promptId,
-        });
-      } else {
-        console.error(`[notify-hook] Failed (${res.statusCode}): ${body}`);
-        logDebug('MESSAGE_FAILED', { status: res.statusCode, error: body });
-      }
-    });
-  });
-
-  req.on('error', (e) => {
-    console.error(`[notify-hook] Error: ${e.message}`);
-  });
-
-  req.write(postData);
-  req.end();
-}
-
-// Read hook input from stdin (post-tool-use hook)
-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, tool_output } = hookData;
-
-    logDebug('PostToolUse', { tool: tool_name, session: hookData.session_id });
-
-    const notification = shouldNotify(tool_name, tool_input, tool_output);
-
-    if (notification) {
-      notification.sessionId = hookData.session_id;
-      sendNotification(notification);
-    }
-
-    // Always allow (post-tool hooks don't block)
-    console.log(JSON.stringify({ status: 'ok' }));
-  } catch (err) {
-    logDebug('ERROR', err.message);
-    console.error('[notify-hook] Error:', err.message);
-    console.log(JSON.stringify({ status: 'ok' }));
-  }
-});

package/templates/claude-hooks/sms-response-handler.js

@@ -1,174 +0,0 @@
-#!/usr/bin/env node
-/**
- * Claude Code hook for processing SMS responses and triggering next actions
- *
- * This hook:
- * 1. Checks for pending SMS responses on startup
- * 2. Executes queued actions from SMS responses
- * 3. Injects response context into Claude session
- *
- * Install: stackmemory notify install-response-hook
- */
-
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
-const { execSync } = require('child_process');
-
-const QUEUE_PATH = path.join(
-  os.homedir(),
-  '.stackmemory',
-  'sms-action-queue.json'
-);
-const RESPONSE_PATH = path.join(
-  os.homedir(),
-  '.stackmemory',
-  'sms-latest-response.json'
-);
-
-function loadActionQueue() {
-  try {
-    if (fs.existsSync(QUEUE_PATH)) {
-      return JSON.parse(fs.readFileSync(QUEUE_PATH, 'utf8'));
-    }
-  } catch {}
-  return { actions: [] };
-}
-
-function saveActionQueue(queue) {
-  const dir = path.join(os.homedir(), '.stackmemory');
-  if (!fs.existsSync(dir)) {
-    fs.mkdirSync(dir, { recursive: true });
-  }
-  fs.writeFileSync(QUEUE_PATH, JSON.stringify(queue, null, 2));
-}
-
-function loadLatestResponse() {
-  try {
-    if (fs.existsSync(RESPONSE_PATH)) {
-      const data = JSON.parse(fs.readFileSync(RESPONSE_PATH, 'utf8'));
-      // Only return if less than 5 minutes old
-      const age = Date.now() - new Date(data.timestamp).getTime();
-      if (age < 5 * 60 * 1000) {
-        return data;
-      }
-    }
-  } catch {}
-  return null;
-}
-
-function clearLatestResponse() {
-  try {
-    if (fs.existsSync(RESPONSE_PATH)) {
-      fs.unlinkSync(RESPONSE_PATH);
-    }
-  } catch {}
-}
-
-function executeAction(action) {
-  try {
-    console.error(`[sms-hook] Executing: ${action.action}`);
-    const output = execSync(action.action, {
-      encoding: 'utf8',
-      timeout: 60000,
-      stdio: ['pipe', 'pipe', 'pipe'],
-    });
-    return { success: true, output };
-  } catch (err) {
-    return { success: false, error: err.message };
-  }
-}
-
-function processPendingActions() {
-  const queue = loadActionQueue();
-  const pending = queue.actions.filter((a) => a.status === 'pending');
-
-  if (pending.length === 0) return null;
-
-  const results = [];
-
-  for (const action of pending) {
-    action.status = 'running';
-    saveActionQueue(queue);
-
-    const result = executeAction(action);
-
-    action.status = result.success ? 'completed' : 'failed';
-    action.result = result.output;
-    action.error = result.error;
-    saveActionQueue(queue);
-
-    results.push({
-      action: action.action,
-      response: action.response,
-      success: result.success,
-      output: result.output?.substring(0, 500),
-      error: result.error,
-    });
-  }
-
-  return results;
-}
-
-// 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 { hook_type } = hookData;
-
-    // On session start, check for pending responses
-    if (hook_type === 'on_startup' || hook_type === 'pre_tool_use') {
-      // Check for SMS response waiting
-      const latestResponse = loadLatestResponse();
-      if (latestResponse) {
-        console.error(
-          `[sms-hook] SMS response received: "${latestResponse.response}"`
-        );
-
-        // Inject context for Claude
-        const context = {
-          type: 'sms_response',
-          response: latestResponse.response,
-          promptId: latestResponse.promptId,
-          timestamp: latestResponse.timestamp,
-          message: `User responded via SMS: "${latestResponse.response}"`,
-        };
-
-        clearLatestResponse();
-
-        // Log context to stderr for visibility, allow the tool
-        console.error(`[sms-hook] Context: ${JSON.stringify(context)}`);
-        console.log(JSON.stringify({ permissionDecision: 'allow' }));
-        return;
-      }
-
-      // Process any pending actions
-      const results = processPendingActions();
-      if (results && results.length > 0) {
-        console.error(`[sms-hook] Processed ${results.length} action(s)`);
-
-        const summary = results
-          .map((r) =>
-            r.success
-              ? `Executed: ${r.action.substring(0, 50)}...`
-              : `Failed: ${r.action.substring(0, 50)}... (${r.error})`
-          )
-          .join('\n');
-
-        // Log results to stderr for visibility, allow the tool
-        console.error(`[sms-hook] Actions summary:\n${summary}`);
-        console.log(JSON.stringify({ permissionDecision: 'allow' }));
-        return;
-      }
-    }
-
-    // Default: allow everything
-    console.log(JSON.stringify({ permissionDecision: 'allow' }));
-  } catch (err) {
-    console.error('[sms-hook] Error:', err.message);
-    console.log(JSON.stringify({ permissionDecision: 'allow' }));
-  }
-});