@stackmemoryai/stackmemory 0.5.20 → 0.5.22

package/dist/hooks/linear-task-picker.js

@@ -0,0 +1,180 @@
+import { fileURLToPath as __fileURLToPath } from 'url';
+import { dirname as __pathDirname } from 'path';
+const __filename = __fileURLToPath(import.meta.url);
+const __dirname = __pathDirname(__filename);
+import { LinearClient } from "../integrations/linear/client.js";
+import { LinearAuthManager } from "../integrations/linear/auth.js";
+const TEST_KEYWORDS = [
+  "test",
+  "spec",
+  "unit test",
+  "integration test",
+  "e2e",
+  "end-to-end",
+  "jest",
+  "vitest",
+  "mocha"
+];
+const VALIDATION_KEYWORDS = [
+  "validate",
+  "verify",
+  "verification",
+  "acceptance criteria",
+  "ac:",
+  "acceptance:",
+  "given when then",
+  "criteria:"
+];
+const QA_KEYWORDS = ["qa", "quality", "regression", "coverage", "assertion"];
+const TEST_LABELS = [
+  "needs-tests",
+  "test-required",
+  "qa-review",
+  "has-ac",
+  "acceptance-criteria",
+  "tdd",
+  "testing"
+];
+function containsKeywords(text, keywords) {
+  const lowerText = text.toLowerCase();
+  return keywords.some((kw) => lowerText.includes(kw.toLowerCase()));
+}
+function scoreTask(issue, preferTestTasks) {
+  let score = 0;
+  const description = issue.description || "";
+  const title = issue.title || "";
+  const fullText = `${title} ${description}`;
+  if (containsKeywords(fullText, TEST_KEYWORDS)) {
+    score += preferTestTasks ? 10 : 5;
+  }
+  if (containsKeywords(fullText, VALIDATION_KEYWORDS)) {
+    score += preferTestTasks ? 8 : 4;
+  }
+  if (containsKeywords(fullText, QA_KEYWORDS)) {
+    score += preferTestTasks ? 5 : 2;
+  }
+  const labelNames = issue.labels?.nodes?.map((l) => l.name.toLowerCase()) || [];
+  const hasTestLabel = TEST_LABELS.some(
+    (tl) => labelNames.some((ln) => ln.includes(tl))
+  );
+  if (hasTestLabel) {
+    score += preferTestTasks ? 5 : 3;
+  }
+  if (issue.priority === 1) {
+    score += 5;
+  } else if (issue.priority === 2) {
+    score += 3;
+  } else if (issue.priority === 3) {
+    score += 1;
+  }
+  if (description.includes("## Acceptance") || description.includes("### AC") || description.includes("- [ ]")) {
+    score += 2;
+  }
+  if (issue.estimate) {
+    score += 1;
+  }
+  return score;
+}
+function getLinearClient() {
+  const apiKey = process.env["LINEAR_API_KEY"];
+  if (apiKey) {
+    return new LinearClient({ apiKey });
+  }
+  try {
+    const authManager = new LinearAuthManager();
+    const tokens = authManager.loadTokens();
+    if (tokens?.accessToken) {
+      return new LinearClient({ accessToken: tokens.accessToken });
+    }
+  } catch {
+  }
+  return null;
+}
+async function pickNextLinearTask(options = {}) {
+  const client = getLinearClient();
+  if (!client) {
+    return null;
+  }
+  const { teamId, preferTestTasks = true, limit = 20 } = options;
+  try {
+    const [backlogIssues, unstartedIssues] = await Promise.all([
+      client.getIssues({ teamId, stateType: "backlog", limit }),
+      client.getIssues({ teamId, stateType: "unstarted", limit })
+    ]);
+    const allIssues = [...backlogIssues, ...unstartedIssues];
+    const unassignedIssues = allIssues.filter((issue) => !issue.assignee);
+    if (unassignedIssues.length === 0) {
+      if (allIssues.length === 0) {
+        return null;
+      }
+    }
+    const issuesToScore = unassignedIssues.length > 0 ? unassignedIssues : allIssues;
+    const scoredIssues = issuesToScore.map((issue) => ({
+      issue,
+      score: scoreTask(issue, preferTestTasks)
+    }));
+    scoredIssues.sort((a, b) => b.score - a.score);
+    const best = scoredIssues[0];
+    if (!best) {
+      return null;
+    }
+    const description = best.issue.description || "";
+    const hasTestRequirements = containsKeywords(description, TEST_KEYWORDS) || containsKeywords(description, VALIDATION_KEYWORDS);
+    return {
+      id: best.issue.id,
+      identifier: best.issue.identifier,
+      title: best.issue.title,
+      priority: best.issue.priority,
+      hasTestRequirements,
+      estimatedPoints: best.issue.estimate,
+      url: best.issue.url,
+      score: best.score
+    };
+  } catch (error) {
+    console.error("[linear-task-picker] Error fetching tasks:", error);
+    return null;
+  }
+}
+async function getTopTaskSuggestions(options = {}, count = 3) {
+  const client = getLinearClient();
+  if (!client) {
+    return [];
+  }
+  const { teamId, preferTestTasks = true, limit = 30 } = options;
+  try {
+    const [backlogIssues, unstartedIssues] = await Promise.all([
+      client.getIssues({ teamId, stateType: "backlog", limit }),
+      client.getIssues({ teamId, stateType: "unstarted", limit })
+    ]);
+    const allIssues = [...backlogIssues, ...unstartedIssues];
+    const unassignedIssues = allIssues.filter((issue) => !issue.assignee);
+    const issuesToScore = unassignedIssues.length > 0 ? unassignedIssues : allIssues;
+    const scoredIssues = issuesToScore.map((issue) => ({
+      issue,
+      score: scoreTask(issue, preferTestTasks)
+    }));
+    scoredIssues.sort((a, b) => b.score - a.score);
+    return scoredIssues.slice(0, count).map(({ issue, score }) => {
+      const description = issue.description || "";
+      const hasTestRequirements = containsKeywords(description, TEST_KEYWORDS) || containsKeywords(description, VALIDATION_KEYWORDS);
+      return {
+        id: issue.id,
+        identifier: issue.identifier,
+        title: issue.title,
+        priority: issue.priority,
+        hasTestRequirements,
+        estimatedPoints: issue.estimate,
+        url: issue.url,
+        score
+      };
+    });
+  } catch (error) {
+    console.error("[linear-task-picker] Error fetching tasks:", error);
+    return [];
+  }
+}
+export {
+  getTopTaskSuggestions,
+  pickNextLinearTask
+};
+//# sourceMappingURL=linear-task-picker.js.map

package/dist/hooks/linear-task-picker.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/hooks/linear-task-picker.ts"],
+  "sourcesContent": ["/**\n * Linear Task Picker\n * Picks the next best task from Linear queue, prioritizing tasks with test/validation requirements\n */\n\nimport { LinearClient, LinearIssue } from '../integrations/linear/client.js';\nimport { LinearAuthManager } from '../integrations/linear/auth.js';\n\nexport interface TaskSuggestion {\n  id: string;\n  identifier: string; // e.g., \"STA-123\"\n  title: string;\n  priority: number;\n  hasTestRequirements: boolean;\n  estimatedPoints?: number;\n  url: string;\n  score: number;\n}\n\nexport interface PickerOptions {\n  teamId?: string;\n  preferTestTasks?: boolean;\n  limit?: number;\n}\n\n// Keywords indicating test/validation requirements\nconst TEST_KEYWORDS = [\n  'test',\n  'spec',\n  'unit test',\n  'integration test',\n  'e2e',\n  'end-to-end',\n  'jest',\n  'vitest',\n  'mocha',\n];\n\nconst VALIDATION_KEYWORDS = [\n  'validate',\n  'verify',\n  'verification',\n  'acceptance criteria',\n  'ac:',\n  'acceptance:',\n  'given when then',\n  'criteria:',\n];\n\nconst QA_KEYWORDS = ['qa', 'quality', 'regression', 'coverage', 'assertion'];\n\n// Labels that indicate test requirements\nconst TEST_LABELS = [\n  'needs-tests',\n  'test-required',\n  'qa-review',\n  'has-ac',\n  'acceptance-criteria',\n  'tdd',\n  'testing',\n];\n\n/**\n * Check if text contains any of the keywords (case-insensitive)\n */\nfunction containsKeywords(text: string, keywords: string[]): boolean {\n  const lowerText = text.toLowerCase();\n  return keywords.some((kw) => lowerText.includes(kw.toLowerCase()));\n}\n\n/**\n * Score a task based on test/validation requirements\n */\nfunction scoreTask(issue: LinearIssue, preferTestTasks: boolean): number {\n  let score = 0;\n  const description = issue.description || '';\n  const title = issue.title || '';\n  const fullText = `${title} ${description}`;\n\n  // +10 if has test/validation keywords in description\n  if (containsKeywords(fullText, TEST_KEYWORDS)) {\n    score += preferTestTasks ? 10 : 5;\n  }\n\n  if (containsKeywords(fullText, VALIDATION_KEYWORDS)) {\n    score += preferTestTasks ? 8 : 4;\n  }\n\n  if (containsKeywords(fullText, QA_KEYWORDS)) {\n    score += preferTestTasks ? 5 : 2;\n  }\n\n  // +5 if has test-related labels\n  const labelNames =\n    issue.labels?.nodes?.map((l: { name: string }) => l.name.toLowerCase()) ||\n    [];\n  const hasTestLabel = TEST_LABELS.some((tl) =>\n    labelNames.some((ln: string) => ln.includes(tl))\n  );\n  if (hasTestLabel) {\n    score += preferTestTasks ? 5 : 3;\n  }\n\n  // +3 for higher priority (urgent=1, high=2)\n  if (issue.priority === 1) {\n    score += 5; // Urgent\n  } else if (issue.priority === 2) {\n    score += 3; // High\n  } else if (issue.priority === 3) {\n    score += 1; // Medium\n  }\n\n  // +2 if has acceptance criteria pattern\n  if (\n    description.includes('## Acceptance') ||\n    description.includes('### AC') ||\n    description.includes('- [ ]')\n  ) {\n    score += 2;\n  }\n\n  // +1 if has estimate (indicates well-scoped)\n  if (issue.estimate) {\n    score += 1;\n  }\n\n  return score;\n}\n\n/**\n * Get Linear client instance\n */\nfunction getLinearClient(): LinearClient | null {\n  // Try API key first\n  const apiKey = process.env['LINEAR_API_KEY'];\n  if (apiKey) {\n    return new LinearClient({ apiKey });\n  }\n\n  // Fall back to OAuth\n  try {\n    const authManager = new LinearAuthManager();\n    const tokens = authManager.loadTokens();\n    if (tokens?.accessToken) {\n      return new LinearClient({ accessToken: tokens.accessToken });\n    }\n  } catch {\n    // Auth not available\n  }\n\n  return null;\n}\n\n/**\n * Pick the next best task from Linear\n */\nexport async function pickNextLinearTask(\n  options: PickerOptions = {}\n): Promise<TaskSuggestion | null> {\n  const client = getLinearClient();\n  if (!client) {\n    return null;\n  }\n\n  const { teamId, preferTestTasks = true, limit = 20 } = options;\n\n  try {\n    // Fetch backlog and unstarted issues\n    const [backlogIssues, unstartedIssues] = await Promise.all([\n      client.getIssues({ teamId, stateType: 'backlog', limit }),\n      client.getIssues({ teamId, stateType: 'unstarted', limit }),\n    ]);\n\n    const allIssues = [...backlogIssues, ...unstartedIssues];\n\n    // Filter out assigned issues (we want unassigned ones)\n    const unassignedIssues = allIssues.filter((issue) => !issue.assignee);\n\n    if (unassignedIssues.length === 0) {\n      // If no unassigned, consider all\n      if (allIssues.length === 0) {\n        return null;\n      }\n    }\n\n    const issuesToScore =\n      unassignedIssues.length > 0 ? unassignedIssues : allIssues;\n\n    // Score and sort\n    const scoredIssues = issuesToScore.map((issue) => ({\n      issue,\n      score: scoreTask(issue, preferTestTasks),\n    }));\n\n    scoredIssues.sort((a, b) => b.score - a.score);\n\n    const best = scoredIssues[0];\n    if (!best) {\n      return null;\n    }\n\n    const description = best.issue.description || '';\n    const hasTestRequirements =\n      containsKeywords(description, TEST_KEYWORDS) ||\n      containsKeywords(description, VALIDATION_KEYWORDS);\n\n    return {\n      id: best.issue.id,\n      identifier: best.issue.identifier,\n      title: best.issue.title,\n      priority: best.issue.priority,\n      hasTestRequirements,\n      estimatedPoints: best.issue.estimate,\n      url: best.issue.url,\n      score: best.score,\n    };\n  } catch (error) {\n    console.error('[linear-task-picker] Error fetching tasks:', error);\n    return null;\n  }\n}\n\n/**\n * Get multiple task suggestions (for showing options)\n */\nexport async function getTopTaskSuggestions(\n  options: PickerOptions = {},\n  count: number = 3\n): Promise<TaskSuggestion[]> {\n  const client = getLinearClient();\n  if (!client) {\n    return [];\n  }\n\n  const { teamId, preferTestTasks = true, limit = 30 } = options;\n\n  try {\n    const [backlogIssues, unstartedIssues] = await Promise.all([\n      client.getIssues({ teamId, stateType: 'backlog', limit }),\n      client.getIssues({ teamId, stateType: 'unstarted', limit }),\n    ]);\n\n    const allIssues = [...backlogIssues, ...unstartedIssues];\n    const unassignedIssues = allIssues.filter((issue) => !issue.assignee);\n    const issuesToScore =\n      unassignedIssues.length > 0 ? unassignedIssues : allIssues;\n\n    const scoredIssues = issuesToScore.map((issue) => ({\n      issue,\n      score: scoreTask(issue, preferTestTasks),\n    }));\n\n    scoredIssues.sort((a, b) => b.score - a.score);\n\n    return scoredIssues.slice(0, count).map(({ issue, score }) => {\n      const description = issue.description || '';\n      const hasTestRequirements =\n        containsKeywords(description, TEST_KEYWORDS) ||\n        containsKeywords(description, VALIDATION_KEYWORDS);\n\n      return {\n        id: issue.id,\n        identifier: issue.identifier,\n        title: issue.title,\n        priority: issue.priority,\n        hasTestRequirements,\n        estimatedPoints: issue.estimate,\n        url: issue.url,\n        score,\n      };\n    });\n  } catch (error) {\n    console.error('[linear-task-picker] Error fetching tasks:', error);\n    return [];\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/hooks/session-summary.js

@@ -0,0 +1,197 @@
+import { fileURLToPath as __fileURLToPath } from 'url';
+import { dirname as __pathDirname } from 'path';
+const __filename = __fileURLToPath(import.meta.url);
+const __dirname = __pathDirname(__filename);
+import { execSync } from "child_process";
+import { pickNextLinearTask } from "./linear-task-picker.js";
+function formatDuration(ms) {
+  const seconds = Math.floor(ms / 1e3);
+  const minutes = Math.floor(seconds / 60);
+  const hours = Math.floor(minutes / 60);
+  if (hours > 0) {
+    return `${hours}h ${minutes % 60}min`;
+  }
+  if (minutes > 0) {
+    return `${minutes}min`;
+  }
+  return `${seconds}s`;
+}
+function getCurrentBranch() {
+  try {
+    return execSync("git rev-parse --abbrev-ref HEAD", {
+      encoding: "utf8",
+      stdio: ["pipe", "pipe", "pipe"]
+    }).trim();
+  } catch {
+    return "unknown";
+  }
+}
+function hasUncommittedChanges() {
+  try {
+    const status = execSync("git status --porcelain", {
+      encoding: "utf8",
+      stdio: ["pipe", "pipe", "pipe"]
+    });
+    const lines = status.trim().split("\n").filter(Boolean);
+    return { changed: lines.length > 0, count: lines.length };
+  } catch {
+    return { changed: false, count: 0 };
+  }
+}
+function isInWorktree() {
+  try {
+    execSync("git rev-parse --is-inside-work-tree", {
+      encoding: "utf8",
+      stdio: ["pipe", "pipe", "pipe"]
+    });
+    const gitDir = execSync("git rev-parse --git-dir", {
+      encoding: "utf8",
+      stdio: ["pipe", "pipe", "pipe"]
+    }).trim();
+    return gitDir.includes(".git/worktrees/");
+  } catch {
+    return false;
+  }
+}
+function hasTestScript() {
+  try {
+    const packageJson = execSync("cat package.json", {
+      encoding: "utf8",
+      stdio: ["pipe", "pipe", "pipe"]
+    });
+    const pkg = JSON.parse(packageJson);
+    return !!(pkg.scripts?.test || pkg.scripts?.["test:run"]);
+  } catch {
+    return false;
+  }
+}
+async function generateSuggestions(context) {
+  const suggestions = [];
+  let keyIndex = 1;
+  const changes = hasUncommittedChanges();
+  const inWorktree = isInWorktree();
+  const hasTests = hasTestScript();
+  if (context.exitCode !== 0 && context.exitCode !== null) {
+    suggestions.push({
+      key: String(keyIndex++),
+      label: "Review error logs",
+      action: "cat ~/.claude/logs/claude-*.log | tail -50",
+      priority: 100
+    });
+  }
+  if (changes.changed) {
+    suggestions.push({
+      key: String(keyIndex++),
+      label: `Commit changes (${changes.count} files)`,
+      action: "git add -A && git commit",
+      priority: 90
+    });
+    const branch = getCurrentBranch();
+    if (branch !== "main" && branch !== "master" && branch !== "unknown") {
+      suggestions.push({
+        key: String(keyIndex++),
+        label: "Create PR",
+        action: "gh pr create --fill",
+        priority: 80
+      });
+    }
+  }
+  if (hasTests && changes.changed) {
+    suggestions.push({
+      key: String(keyIndex++),
+      label: "Run tests",
+      action: "npm run test:run",
+      priority: 85
+    });
+  }
+  if (inWorktree) {
+    suggestions.push({
+      key: String(keyIndex++),
+      label: "Merge to main",
+      action: "cwm",
+      // custom alias
+      priority: 70
+    });
+  }
+  try {
+    const linearTask = await pickNextLinearTask({ preferTestTasks: true });
+    if (linearTask) {
+      suggestions.push({
+        key: String(keyIndex++),
+        label: `Start: ${linearTask.identifier} - ${linearTask.title.substring(0, 40)}${linearTask.title.length > 40 ? "..." : ""}${linearTask.hasTestRequirements ? " (has tests)" : ""}`,
+        action: `stackmemory task start ${linearTask.id} --assign-me`,
+        priority: 60
+      });
+    }
+  } catch {
+  }
+  const durationMs = Date.now() - context.sessionStartTime;
+  if (durationMs > 30 * 60 * 1e3) {
+    suggestions.push({
+      key: String(keyIndex++),
+      label: "Take a break",
+      action: 'echo "Great work! Time for a coffee break."',
+      priority: 10
+    });
+  }
+  suggestions.sort((a, b) => b.priority - a.priority);
+  suggestions.forEach((s, i) => {
+    s.key = String(i + 1);
+  });
+  return suggestions;
+}
+async function generateSessionSummary(context) {
+  const durationMs = Date.now() - context.sessionStartTime;
+  const duration = formatDuration(durationMs);
+  const branch = context.branch || getCurrentBranch();
+  let status = "success";
+  if (context.exitCode !== 0 && context.exitCode !== null) {
+    status = "error";
+  }
+  const suggestions = await generateSuggestions(context);
+  let linearTask;
+  try {
+    linearTask = await pickNextLinearTask({ preferTestTasks: true });
+  } catch {
+  }
+  return {
+    duration,
+    exitCode: context.exitCode,
+    branch,
+    status,
+    suggestions,
+    linearTask
+  };
+}
+function formatSummaryMessage(summary) {
+  const statusEmoji = summary.status === "success" ? "" : "";
+  const exitInfo = summary.exitCode !== null ? ` | Exit: ${summary.exitCode}` : "";
+  let message = `Claude session complete ${statusEmoji}
+`;
+  message += `Duration: ${summary.duration}${exitInfo} | Branch: ${summary.branch}
+
+`;
+  if (summary.suggestions.length > 0) {
+    message += `What to do next:
+`;
+    for (const s of summary.suggestions.slice(0, 4)) {
+      message += `${s.key}. ${s.label}
+`;
+    }
+    message += `
+Reply with number or custom action`;
+  } else {
+    message += `No pending actions. Nice work!`;
+  }
+  return message;
+}
+function getActionForKey(suggestions, key) {
+  const suggestion = suggestions.find((s) => s.key === key);
+  return suggestion?.action || null;
+}
+export {
+  formatSummaryMessage,
+  generateSessionSummary,
+  getActionForKey
+};
+//# sourceMappingURL=session-summary.js.map

package/dist/hooks/session-summary.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/hooks/session-summary.ts"],
+  "sourcesContent": ["/**\n * Session Summary Generator\n * Generates intelligent suggestions for what to do next after a Claude session\n */\n\nimport { execSync } from 'child_process';\nimport { pickNextLinearTask, TaskSuggestion } from './linear-task-picker.js';\n\nexport interface SessionContext {\n  instanceId: string;\n  exitCode: number | null;\n  sessionStartTime: number;\n  worktreePath?: string;\n  branch?: string;\n  task?: string;\n}\n\nexport interface Suggestion {\n  key: string;\n  label: string;\n  action: string;\n  priority: number;\n}\n\nexport interface SessionSummary {\n  duration: string;\n  exitCode: number | null;\n  branch: string;\n  status: 'success' | 'error' | 'interrupted';\n  suggestions: Suggestion[];\n  linearTask?: TaskSuggestion;\n}\n\n/**\n * Format duration in human-readable form\n */\nfunction formatDuration(ms: number): string {\n  const seconds = Math.floor(ms / 1000);\n  const minutes = Math.floor(seconds / 60);\n  const hours = Math.floor(minutes / 60);\n\n  if (hours > 0) {\n    return `${hours}h ${minutes % 60}min`;\n  }\n  if (minutes > 0) {\n    return `${minutes}min`;\n  }\n  return `${seconds}s`;\n}\n\n/**\n * Get current git branch\n */\nfunction getCurrentBranch(): string {\n  try {\n    return execSync('git rev-parse --abbrev-ref HEAD', {\n      encoding: 'utf8',\n      stdio: ['pipe', 'pipe', 'pipe'],\n    }).trim();\n  } catch {\n    return 'unknown';\n  }\n}\n\n/**\n * Check for uncommitted changes\n */\nfunction hasUncommittedChanges(): { changed: boolean; count: number } {\n  try {\n    const status = execSync('git status --porcelain', {\n      encoding: 'utf8',\n      stdio: ['pipe', 'pipe', 'pipe'],\n    });\n    const lines = status.trim().split('\\n').filter(Boolean);\n    return { changed: lines.length > 0, count: lines.length };\n  } catch {\n    return { changed: false, count: 0 };\n  }\n}\n\n/**\n * Check if we're in a worktree\n */\nfunction isInWorktree(): boolean {\n  try {\n    execSync('git rev-parse --is-inside-work-tree', {\n      encoding: 'utf8',\n      stdio: ['pipe', 'pipe', 'pipe'],\n    });\n    // Check if it's a worktree (not the main repo)\n    const gitDir = execSync('git rev-parse --git-dir', {\n      encoding: 'utf8',\n      stdio: ['pipe', 'pipe', 'pipe'],\n    }).trim();\n    return gitDir.includes('.git/worktrees/');\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Check if tests exist and might need running\n */\nfunction hasTestScript(): boolean {\n  try {\n    const packageJson = execSync('cat package.json', {\n      encoding: 'utf8',\n      stdio: ['pipe', 'pipe', 'pipe'],\n    });\n    const pkg = JSON.parse(packageJson);\n    return !!(pkg.scripts?.test || pkg.scripts?.['test:run']);\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Generate suggestions based on session context\n */\nasync function generateSuggestions(\n  context: SessionContext\n): Promise<Suggestion[]> {\n  const suggestions: Suggestion[] = [];\n  let keyIndex = 1;\n\n  const changes = hasUncommittedChanges();\n  const inWorktree = isInWorktree();\n  const hasTests = hasTestScript();\n\n  // Error case - suggest reviewing logs\n  if (context.exitCode !== 0 && context.exitCode !== null) {\n    suggestions.push({\n      key: String(keyIndex++),\n      label: 'Review error logs',\n      action: 'cat ~/.claude/logs/claude-*.log | tail -50',\n      priority: 100,\n    });\n  }\n\n  // Uncommitted changes - suggest commit or PR\n  if (changes.changed) {\n    suggestions.push({\n      key: String(keyIndex++),\n      label: `Commit changes (${changes.count} files)`,\n      action: 'git add -A && git commit',\n      priority: 90,\n    });\n\n    // If on feature branch, suggest PR\n    const branch = getCurrentBranch();\n    if (branch !== 'main' && branch !== 'master' && branch !== 'unknown') {\n      suggestions.push({\n        key: String(keyIndex++),\n        label: 'Create PR',\n        action: 'gh pr create --fill',\n        priority: 80,\n      });\n    }\n  }\n\n  // If tests exist and changes were made, suggest running tests\n  if (hasTests && changes.changed) {\n    suggestions.push({\n      key: String(keyIndex++),\n      label: 'Run tests',\n      action: 'npm run test:run',\n      priority: 85,\n    });\n  }\n\n  // Worktree-specific suggestions\n  if (inWorktree) {\n    suggestions.push({\n      key: String(keyIndex++),\n      label: 'Merge to main',\n      action: 'cwm', // custom alias\n      priority: 70,\n    });\n  }\n\n  // Try to get next Linear task\n  try {\n    const linearTask = await pickNextLinearTask({ preferTestTasks: true });\n    if (linearTask) {\n      suggestions.push({\n        key: String(keyIndex++),\n        label: `Start: ${linearTask.identifier} - ${linearTask.title.substring(0, 40)}${linearTask.title.length > 40 ? '...' : ''}${linearTask.hasTestRequirements ? ' (has tests)' : ''}`,\n        action: `stackmemory task start ${linearTask.id} --assign-me`,\n        priority: 60,\n      });\n    }\n  } catch {\n    // Linear not available, skip\n  }\n\n  // Long session suggestion\n  const durationMs = Date.now() - context.sessionStartTime;\n  if (durationMs > 30 * 60 * 1000) {\n    // > 30 minutes\n    suggestions.push({\n      key: String(keyIndex++),\n      label: 'Take a break',\n      action: 'echo \"Great work! Time for a coffee break.\"',\n      priority: 10,\n    });\n  }\n\n  // Sort by priority (highest first) and re-key\n  suggestions.sort((a, b) => b.priority - a.priority);\n  suggestions.forEach((s, i) => {\n    s.key = String(i + 1);\n  });\n\n  return suggestions;\n}\n\n/**\n * Generate full session summary\n */\nexport async function generateSessionSummary(\n  context: SessionContext\n): Promise<SessionSummary> {\n  const durationMs = Date.now() - context.sessionStartTime;\n  const duration = formatDuration(durationMs);\n  const branch = context.branch || getCurrentBranch();\n\n  let status: 'success' | 'error' | 'interrupted' = 'success';\n  if (context.exitCode !== 0 && context.exitCode !== null) {\n    status = 'error';\n  }\n\n  const suggestions = await generateSuggestions(context);\n\n  // Extract linear task if present\n  let linearTask: TaskSuggestion | undefined;\n  try {\n    linearTask = await pickNextLinearTask({ preferTestTasks: true });\n  } catch {\n    // Linear not available\n  }\n\n  return {\n    duration,\n    exitCode: context.exitCode,\n    branch,\n    status,\n    suggestions,\n    linearTask,\n  };\n}\n\n/**\n * Format session summary as WhatsApp message\n */\nexport function formatSummaryMessage(summary: SessionSummary): string {\n  const statusEmoji = summary.status === 'success' ? '' : '';\n  const exitInfo =\n    summary.exitCode !== null ? ` | Exit: ${summary.exitCode}` : '';\n\n  let message = `Claude session complete ${statusEmoji}\\n`;\n  message += `Duration: ${summary.duration}${exitInfo} | Branch: ${summary.branch}\\n\\n`;\n\n  if (summary.suggestions.length > 0) {\n    message += `What to do next:\\n`;\n    for (const s of summary.suggestions.slice(0, 4)) {\n      message += `${s.key}. ${s.label}\\n`;\n    }\n    message += `\\nReply with number or custom action`;\n  } else {\n    message += `No pending actions. Nice work!`;\n  }\n\n  return message;\n}\n\n/**\n * Get action for a suggestion key\n */\nexport function getActionForKey(\n  suggestions: Suggestion[],\n  key: string\n): string | null {\n  const suggestion = suggestions.find((s) => s.key === key);\n  return suggestion?.action || null;\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/hooks/sms-action-runner.js

@@ -5,10 +5,12 @@ const __dirname = __pathDirname(__filename);
 import { existsSync, readFileSync } from "fs";
 import { join } from "path";
 import { homedir } from "os";
-import { execSync, execFileSync } from "child_process";
+import { execFileSync } from "child_process";
 import { randomBytes } from "crypto";
 import { writeFileSecure, ensureSecureDir } from "./secure-fs.js";
 import { ActionQueueSchema, parseConfigSafe } from "./schemas.js";
+import { LinearClient } from "../integrations/linear/client.js";
+import { LinearAuthManager } from "../integrations/linear/auth.js";
 const SAFE_ACTION_PATTERNS = [
   // Git/GitHub CLI commands (limited to safe operations)
   { pattern: /^gh pr (view|list|status|checks) (\d+)$/ },
@@ -20,8 +22,20 @@ const SAFE_ACTION_PATTERNS = [
   { pattern: /^npm (test|run build)$/ },
   // StackMemory commands
   { pattern: /^stackmemory (status|notify check|context list)$/ },
+  // Task start with optional --assign-me flag (Linear task ID is UUID format)
+  {
+    pattern: /^stackmemory task start ([a-f0-9-]{36})( --assign-me)?$/
+  },
+  // Git commands
+  { pattern: /^git (status|diff|log|branch)( --[a-z-]+)*$/ },
+  { pattern: /^git add -A && git commit$/ },
+  { pattern: /^gh pr create --fill$/ },
+  // Custom aliases (cwm = claude worktree merge)
+  { pattern: /^cwm$/ },
   // Simple echo/confirmation (no variables)
-  { pattern: /^echo "?(Done|OK|Confirmed|Acknowledged)"?$/ }
+  {
+    pattern: /^echo "?(Done|OK|Confirmed|Acknowledged|Great work! Time for a coffee break\.)"?$/
+  }
 ];
 function isActionAllowed(action) {
   const trimmed = action.trim();
@@ -73,7 +87,60 @@ function queueAction(promptId, response, action) {
   saveActionQueue(queue);
   return id;
 }
-function executeActionSafe(action, _response) {
+function getLinearClient() {
+  const apiKey = process.env["LINEAR_API_KEY"];
+  if (apiKey) {
+    return new LinearClient({ apiKey });
+  }
+  try {
+    const authManager = new LinearAuthManager();
+    const tokens = authManager.loadTokens();
+    if (tokens?.accessToken) {
+      return new LinearClient({ accessToken: tokens.accessToken });
+    }
+  } catch {
+  }
+  return null;
+}
+async function handleSpecialAction(action) {
+  const taskStartMatch = action.match(
+    /^stackmemory task start ([a-f0-9-]{36})( --assign-me)?$/
+  );
+  if (taskStartMatch) {
+    const issueId = taskStartMatch[1];
+    const client = getLinearClient();
+    if (!client) {
+      return {
+        handled: true,
+        success: false,
+        error: "Linear not configured. Set LINEAR_API_KEY or run stackmemory linear setup."
+      };
+    }
+    try {
+      const result = await client.startIssue(issueId);
+      if (result.success && result.issue) {
+        return {
+          handled: true,
+          success: true,
+          output: `Started: ${result.issue.identifier} - ${result.issue.title}`
+        };
+      }
+      return {
+        handled: true,
+        success: false,
+        error: result.error || "Failed to start issue"
+      };
+    } catch (err) {
+      return {
+        handled: true,
+        success: false,
+        error: err instanceof Error ? err.message : "Unknown error"
+      };
+    }
+  }
+  return { handled: false };
+}
+async function executeActionSafe(action, _response) {
   if (!isActionAllowed(action)) {
     console.error(`[sms-action] Action not in allowlist: ${action}`);
     return {
@@ -81,6 +148,14 @@ function executeActionSafe(action, _response) {
       error: `Action not allowed. Only pre-approved commands can be executed via SMS.`
     };
   }
+  const specialResult = await handleSpecialAction(action);
+  if (specialResult.handled) {
+    return {
+      success: specialResult.success || false,
+      output: specialResult.output,
+      error: specialResult.error
+    };
+  }
   try {
     console.log(`[sms-action] Executing safe action: ${action}`);
     const parts = action.split(" ");
@@ -121,30 +196,22 @@ function markActionCompleted(id, result, error) {
     saveActionQueue(queue);
   }
 }
-function executeAction(action) {
+async function executeAction(action) {
   markActionRunning(action.id);
-  try {
-    console.log(`[sms-action] Executing: ${action.action}`);
-    const output = execSync(action.action, {
-      encoding: "utf8",
-      timeout: 6e4,
-      // 1 minute timeout
-      stdio: ["pipe", "pipe", "pipe"]
-    });
-    markActionCompleted(action.id, output);
-    return { success: true, output };
-  } catch (err) {
-    const error = err instanceof Error ? err.message : String(err);
-    markActionCompleted(action.id, void 0, error);
-    return { success: false, error };
+  const result = await executeActionSafe(action.action, action.response);
+  if (result.success) {
+    markActionCompleted(action.id, result.output);
+  } else {
+    markActionCompleted(action.id, void 0, result.error);
   }
+  return result;
 }
-function processAllPendingActions() {
+async function processAllPendingActions() {
   const pending = getPendingActions();
   let succeeded = 0;
   let failed = 0;
   for (const action of pending) {
-    const result = executeAction(action);
+    const result = await executeAction(action);
     if (result.success) {
       succeeded++;
     } else {