@stackmemoryai/stackmemory 0.5.58 → 0.5.61

package/README.md

@@ -1,6 +1,6 @@
 # StackMemory
 
-**Lossless, project-scoped memory for AI tools** • v0.5.51
+**Lossless, project-scoped memory for AI tools** • v0.5.59
 
 StackMemory is a **production-ready memory runtime** for AI coding tools that preserves full project context across sessions:
 
@@ -36,6 +36,110 @@ StackMemory solves this by:
 
 ---
 
+## Features
+
+StackMemory includes powerful features to enhance your AI coding workflow. Enable/disable with `claude-sm config setup`.
+
+### Predictive Edit
+
+Anticipates your next edit and displays suggestions as a status bar overlay. Powered by llama-server and Claude Code's PostToolUse hooks.
+
+```bash
+claude-sm --sweep          # Enable (default: on)
+claude-sm --no-sweep       # Disable
+```
+
+- **How it works**: Analyzes tool outputs and predicts likely follow-up edits
+- **Interface**: Tab to accept, Esc to dismiss
+- **Requirement**: Installs `node-pty` on first use
+
+### Code Review
+
+AI-powered code review using Greptile's codebase-aware analysis. Automatically registers the Greptile MCP server for deep repository understanding.
+
+```bash
+claude-sm --greptile       # Enable (default: on)
+claude-sm --no-greptile    # Disable
+```
+
+- **Tools provided**: `index_repository`, `query_repository`, `get_repository_info`
+- **Requirement**: `GREPTILE_API_KEY` in `.env`
+
+### Prompt Forge
+
+Genetic Eval-driven Prompt Algorithm (GEPA) for automatic system prompt optimization. Evolves your `CLAUDE.md` through mutation, evaluation, and selection.
+
+```bash
+claude-sm --gepa           # Enable
+claude-sm --no-gepa        # Disable (default)
+```
+
+- **Auto-optimize**: Watches `CLAUDE.md` and runs optimization on changes
+- **Strategies**: rephrase, add_examples, remove_redundancy, restructure, add_constraints, simplify
+- **Output**: Before/after comparison with metrics (lines, tokens, rules)
+
+### Model Switcher
+
+Dynamic model routing based on task complexity. Automatically selects the optimal model (Haiku/Sonnet/Opus) for each request.
+
+```bash
+claude-sm --model-routing  # Enable
+claude-sm --no-model-routing  # Disable (default)
+```
+
+- **Cost optimization**: Uses cheaper models for simple tasks
+- **Quality preservation**: Routes complex tasks to more capable models
+
+### Safe Branch
+
+Git worktree isolation for experimental changes. Each session operates in an isolated branch, preventing accidental commits to main.
+
+```bash
+claude-sm --worktree       # Enable
+claude-sm --no-worktree    # Disable (default)
+```
+
+- **Isolation**: Changes happen in a separate worktree
+- **Safety**: Main branch remains untouched until explicit merge
+
+### Mobile Sync
+
+WhatsApp notifications for session updates and task completion. Stay informed even when away from your terminal.
+
+```bash
+claude-sm --whatsapp       # Enable
+claude-sm --no-whatsapp    # Disable (default)
+```
+
+- **Notifications**: Session start, task completion, errors
+- **Interactive**: Reply to trigger actions remotely
+
+### Session Insights
+
+Detailed tracing of session activity for debugging and optimization. Tracks tool calls, timing, and decision paths.
+
+```bash
+claude-sm --tracing        # Enable
+claude-sm --no-tracing     # Disable (default)
+```
+
+- **Visibility**: Full execution trace
+- **Analytics**: Performance metrics and patterns
+
+### Task Alert
+
+Desktop/terminal notifications when long-running tasks complete. Never miss a completed build or test run.
+
+```bash
+claude-sm --notify-on-done # Enable (default: on)
+claude-sm --no-notify-on-done  # Disable
+```
+
+- **Platforms**: macOS notifications, terminal bell
+- **Smart**: Only notifies for tasks taking >10 seconds
+
+---
+
 ## Core concepts (quick mental model)
 
 | Concept        | Meaning                                           |

package/dist/scripts/benchmark-performance.js

@@ -0,0 +1,48 @@
+#!/usr/bin/env node
+import { fileURLToPath as __fileURLToPath } from 'url';
+import { dirname as __pathDirname } from 'path';
+const __filename = __fileURLToPath(import.meta.url);
+const __dirname = __pathDirname(__filename);
+import Database from "better-sqlite3";
+import { join } from "path";
+import { existsSync } from "fs";
+import { PerformanceBenchmark } from "../src/core/performance/performance-benchmark.js";
+import { logger } from "../src/core/monitoring/logger.js";
+async function runBenchmarks() {
+  const projectRoot = process.cwd();
+  const dbPath = join(projectRoot, ".stackmemory", "context.db");
+  if (!existsSync(dbPath)) {
+    console.error(
+      '\u274C StackMemory not initialized. Run "stackmemory init" first.'
+    );
+    process.exit(1);
+  }
+  const db = new Database(dbPath, { readonly: false });
+  const projectId = "benchmark-test";
+  console.log("\u{1F680} Starting Performance Benchmarks...\n");
+  const benchmark = new PerformanceBenchmark();
+  try {
+    const suite = await benchmark.runFullSuite(projectRoot, db, projectId);
+    console.log("\n\u2705 Benchmarks completed successfully!");
+    if (suite.averageImprovement > 0) {
+      console.log(
+        `
+\u{1F389} Overall performance improved by ${suite.averageImprovement.toFixed(1)}%`
+      );
+    }
+    process.exit(0);
+  } catch (error) {
+    console.error("\n\u274C Benchmark failed:", error);
+    logger.error("Benchmark error", error);
+    process.exit(1);
+  } finally {
+    db.close();
+  }
+}
+if (import.meta.url === `file://${process.argv[1]}`) {
+  runBenchmarks().catch(console.error);
+}
+export {
+  runBenchmarks
+};
+//# sourceMappingURL=benchmark-performance.js.map

package/dist/scripts/benchmark-performance.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../scripts/benchmark-performance.ts"],
+  "sourcesContent": ["#!/usr/bin/env node\n/**\n * Run performance benchmarks\n */\n\nimport Database from 'better-sqlite3';\nimport { join } from 'path';\nimport { existsSync } from 'fs';\nimport { PerformanceBenchmark } from '../src/core/performance/performance-benchmark.js';\nimport { logger } from '../src/core/monitoring/logger.js';\n\nasync function runBenchmarks() {\n  const projectRoot = process.cwd();\n  const dbPath = join(projectRoot, '.stackmemory', 'context.db');\n\n  if (!existsSync(dbPath)) {\n    console.error(\n      '\u274C StackMemory not initialized. Run \"stackmemory init\" first.'\n    );\n    process.exit(1);\n  }\n\n  const db = new Database(dbPath, { readonly: false });\n  const projectId = 'benchmark-test';\n\n  console.log('\uD83D\uDE80 Starting Performance Benchmarks...\\n');\n\n  const benchmark = new PerformanceBenchmark();\n\n  try {\n    const suite = await benchmark.runFullSuite(projectRoot, db, projectId);\n\n    console.log('\\n\u2705 Benchmarks completed successfully!');\n\n    // Summary\n    if (suite.averageImprovement > 0) {\n      console.log(\n        `\\n\uD83C\uDF89 Overall performance improved by ${suite.averageImprovement.toFixed(1)}%`\n      );\n    }\n\n    process.exit(0);\n  } catch (error: unknown) {\n    console.error('\\n\u274C Benchmark failed:', error);\n    logger.error('Benchmark error', error as Error);\n    process.exit(1);\n  } finally {\n    db.close();\n  }\n}\n\n// Run if called directly\nif (import.meta.url === `file://${process.argv[1]}`) {\n  runBenchmarks().catch(console.error);\n}\n\nexport { runBenchmarks };\n"],
+  "mappings": ";;;;;AAKA,OAAO,cAAc;AACrB,SAAS,YAAY;AACrB,SAAS,kBAAkB;AAC3B,SAAS,4BAA4B;AACrC,SAAS,cAAc;AAEvB,eAAe,gBAAgB;AAC7B,QAAM,cAAc,QAAQ,IAAI;AAChC,QAAM,SAAS,KAAK,aAAa,gBAAgB,YAAY;AAE7D,MAAI,CAAC,WAAW,MAAM,GAAG;AACvB,YAAQ;AAAA,MACN;AAAA,IACF;AACA,YAAQ,KAAK,CAAC;AAAA,EAChB;AAEA,QAAM,KAAK,IAAI,SAAS,QAAQ,EAAE,UAAU,MAAM,CAAC;AACnD,QAAM,YAAY;AAElB,UAAQ,IAAI,gDAAyC;AAErD,QAAM,YAAY,IAAI,qBAAqB;AAE3C,MAAI;AACF,UAAM,QAAQ,MAAM,UAAU,aAAa,aAAa,IAAI,SAAS;AAErE,YAAQ,IAAI,6CAAwC;AAGpD,QAAI,MAAM,qBAAqB,GAAG;AAChC,cAAQ;AAAA,QACN;AAAA,4CAAwC,MAAM,mBAAmB,QAAQ,CAAC,CAAC;AAAA,MAC7E;AAAA,IACF;AAEA,YAAQ,KAAK,CAAC;AAAA,EAChB,SAAS,OAAgB;AACvB,YAAQ,MAAM,8BAAyB,KAAK;AAC5C,WAAO,MAAM,mBAAmB,KAAc;AAC9C,YAAQ,KAAK,CAAC;AAAA,EAChB,UAAE;AACA,OAAG,MAAM;AAAA,EACX;AACF;AAGA,IAAI,YAAY,QAAQ,UAAU,QAAQ,KAAK,CAAC,CAAC,IAAI;AACnD,gBAAc,EAAE,MAAM,QAAQ,KAAK;AACrC;",
+  "names": []
+}

package/dist/scripts/check-redis.js

@@ -0,0 +1,42 @@
+#!/usr/bin/env tsx
+import { fileURLToPath as __fileURLToPath } from 'url';
+import { dirname as __pathDirname } from 'path';
+const __filename = __fileURLToPath(import.meta.url);
+const __dirname = __pathDirname(__filename);
+import { createClient } from "redis";
+import dotenv from "dotenv";
+function getEnv(key, defaultValue) {
+  const value = process.env[key];
+  if (value === void 0) {
+    if (defaultValue !== void 0) return defaultValue;
+    throw new Error(`Environment variable ${key} is required`);
+  }
+  return value;
+}
+function getOptionalEnv(key) {
+  return process.env[key];
+}
+dotenv.config();
+async function checkRedis() {
+  const client = createClient({ url: process.env["REDIS_URL"] });
+  await client.connect();
+  const keys = await client.keys("trace:*");
+  console.log("Redis trace keys:", keys.length);
+  if (keys.length > 0) {
+    console.log("Sample keys:", keys.slice(0, 3));
+    const sample = await client.hGetAll(keys[0]);
+    console.log("Sample trace fields:", Object.keys(sample));
+    console.log("Sample trace data size:", sample.data?.length || 0, "bytes");
+    console.log(
+      "Sample trace compressed:",
+      sample.compressed === "true" ? "yes" : "no"
+    );
+  }
+  const scoreIndex = await client.zCard("traces:by_score");
+  const timeIndex = await client.zCard("traces:by_time");
+  console.log("Score index entries:", scoreIndex);
+  console.log("Time index entries:", timeIndex);
+  await client.quit();
+}
+checkRedis().catch(console.error);
+//# sourceMappingURL=check-redis.js.map

package/dist/scripts/check-redis.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../scripts/check-redis.ts"],
+  "sourcesContent": ["#!/usr/bin/env tsx\n\nimport { createClient } from 'redis';\nimport dotenv from 'dotenv';\n// Type-safe environment variable access\nfunction getEnv(key: string, defaultValue?: string): string {\n  const value = process.env[key];\n  if (value === undefined) {\n    if (defaultValue !== undefined) return defaultValue;\n    throw new Error(`Environment variable ${key} is required`);\n  }\n  return value;\n}\n\nfunction getOptionalEnv(key: string): string | undefined {\n  return process.env[key];\n}\n\ndotenv.config();\n\nasync function checkRedis() {\n  const client = createClient({ url: process.env['REDIS_URL'] });\n  await client.connect();\n\n  const keys = await client.keys('trace:*');\n  console.log('Redis trace keys:', keys.length);\n\n  if (keys.length > 0) {\n    console.log('Sample keys:', keys.slice(0, 3));\n    // Using hGetAll since we store as hash\n    const sample = await client.hGetAll(keys[0]);\n    console.log('Sample trace fields:', Object.keys(sample));\n    console.log('Sample trace data size:', sample.data?.length || 0, 'bytes');\n    console.log(\n      'Sample trace compressed:',\n      sample.compressed === 'true' ? 'yes' : 'no'\n    );\n  }\n\n  const scoreIndex = await client.zCard('traces:by_score');\n  const timeIndex = await client.zCard('traces:by_time');\n  console.log('Score index entries:', scoreIndex);\n  console.log('Time index entries:', timeIndex);\n\n  await client.quit();\n}\n\ncheckRedis().catch(console.error);\n"],
+  "mappings": ";;;;;AAEA,SAAS,oBAAoB;AAC7B,OAAO,YAAY;AAEnB,SAAS,OAAO,KAAa,cAA+B;AAC1D,QAAM,QAAQ,QAAQ,IAAI,GAAG;AAC7B,MAAI,UAAU,QAAW;AACvB,QAAI,iBAAiB,OAAW,QAAO;AACvC,UAAM,IAAI,MAAM,wBAAwB,GAAG,cAAc;AAAA,EAC3D;AACA,SAAO;AACT;AAEA,SAAS,eAAe,KAAiC;AACvD,SAAO,QAAQ,IAAI,GAAG;AACxB;AAEA,OAAO,OAAO;AAEd,eAAe,aAAa;AAC1B,QAAM,SAAS,aAAa,EAAE,KAAK,QAAQ,IAAI,WAAW,EAAE,CAAC;AAC7D,QAAM,OAAO,QAAQ;AAErB,QAAM,OAAO,MAAM,OAAO,KAAK,SAAS;AACxC,UAAQ,IAAI,qBAAqB,KAAK,MAAM;AAE5C,MAAI,KAAK,SAAS,GAAG;AACnB,YAAQ,IAAI,gBAAgB,KAAK,MAAM,GAAG,CAAC,CAAC;AAE5C,UAAM,SAAS,MAAM,OAAO,QAAQ,KAAK,CAAC,CAAC;AAC3C,YAAQ,IAAI,wBAAwB,OAAO,KAAK,MAAM,CAAC;AACvD,YAAQ,IAAI,2BAA2B,OAAO,MAAM,UAAU,GAAG,OAAO;AACxE,YAAQ;AAAA,MACN;AAAA,MACA,OAAO,eAAe,SAAS,QAAQ;AAAA,IACzC;AAAA,EACF;AAEA,QAAM,aAAa,MAAM,OAAO,MAAM,iBAAiB;AACvD,QAAM,YAAY,MAAM,OAAO,MAAM,gBAAgB;AACrD,UAAQ,IAAI,wBAAwB,UAAU;AAC9C,UAAQ,IAAI,uBAAuB,SAAS;AAE5C,QAAM,OAAO,KAAK;AACpB;AAEA,WAAW,EAAE,MAAM,QAAQ,KAAK;",
+  "names": []
+}

package/dist/scripts/initialize.js

@@ -0,0 +1,116 @@
+#!/usr/bin/env tsx
+import { fileURLToPath as __fileURLToPath } from 'url';
+import { dirname as __pathDirname } from 'path';
+const __filename = __fileURLToPath(import.meta.url);
+const __dirname = __pathDirname(__filename);
+import {
+  existsSync,
+  mkdirSync,
+  writeFileSync,
+  readFileSync,
+  appendFileSync
+} from "fs";
+import { join } from "path";
+import { execSync } from "child_process";
+import chalk from "chalk";
+function getEnv(key, defaultValue) {
+  const value = process.env[key];
+  if (value === void 0) {
+    if (defaultValue !== void 0) return defaultValue;
+    throw new Error(`Environment variable ${key} is required`);
+  }
+  return value;
+}
+function getOptionalEnv(key) {
+  return process.env[key];
+}
+const projectRoot = process.cwd();
+console.log(chalk.blue.bold("\n\u{1F680} Initializing StackMemory...\n"));
+const stackDir = join(projectRoot, ".stackmemory");
+if (!existsSync(stackDir)) {
+  mkdirSync(stackDir, { recursive: true });
+  console.log(chalk.green("\u2713") + " Created .stackmemory directory");
+} else {
+  console.log(chalk.yellow("\u26A0") + " .stackmemory directory already exists");
+}
+const gitignorePath = join(projectRoot, ".gitignore");
+const gitignoreEntry = "\n# StackMemory\n.stackmemory/*.db\n.stackmemory/*.db-*\n";
+if (existsSync(gitignorePath)) {
+  const gitignore = readFileSync(gitignorePath, "utf-8");
+  if (!gitignore.includes(".stackmemory")) {
+    appendFileSync(gitignorePath, gitignoreEntry);
+    console.log(chalk.green("\u2713") + " Added .stackmemory to .gitignore");
+  }
+} else {
+  writeFileSync(gitignorePath, gitignoreEntry);
+  console.log(chalk.green("\u2713") + " Created .gitignore with .stackmemory");
+}
+const configPath = join(stackDir, "config.json");
+if (!existsSync(configPath)) {
+  const config = {
+    projectId: projectRoot.split("/").pop(),
+    userId: process.env["USER"] || "default",
+    teamId: "local",
+    initialized: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  writeFileSync(configPath, JSON.stringify(config, null, 2));
+  console.log(chalk.green("\u2713") + " Created config file");
+}
+const jsonlPath = join(stackDir, "frames.jsonl");
+if (!existsSync(jsonlPath)) {
+  const initialFrame = {
+    id: "init_" + Date.now(),
+    type: "system",
+    content: "StackMemory initialized",
+    timestamp: Date.now()
+  };
+  writeFileSync(jsonlPath, JSON.stringify(initialFrame) + "\n");
+  console.log(chalk.green("\u2713") + " Created frames.jsonl");
+}
+const isMacOS = process.platform === "darwin";
+const mcpConfigPath = isMacOS ? join(
+  process.env["HOME"] || "~",
+  "Library",
+  "Application Support",
+  "Claude",
+  "claude_desktop_config.json"
+) : join(
+  process.env["HOME"] || "~",
+  ".config",
+  "claude",
+  "claude_desktop_config.json"
+);
+console.log(chalk.blue("\n\u{1F4DD} MCP Configuration for Claude Code:\n"));
+const mcpConfig = {
+  mcpServers: {
+    stackmemory: {
+      command: "node",
+      args: [join(projectRoot, "dist", "integrations", "mcp", "server.js")],
+      env: {
+        PROJECT_ROOT: projectRoot
+      }
+    }
+  }
+};
+console.log(chalk.gray("Add this to your Claude Code MCP configuration:"));
+console.log(chalk.gray("(" + mcpConfigPath + ")\n"));
+console.log(chalk.cyan(JSON.stringify(mcpConfig, null, 2)));
+console.log(chalk.blue("\n\u{1F4E6} Building TypeScript files...\n"));
+try {
+  execSync("npm run build", { stdio: "inherit", cwd: projectRoot });
+  console.log(chalk.green("\u2713") + " Build completed");
+} catch {
+  console.log(chalk.yellow("\u26A0") + " Build failed - run npm run build manually");
+}
+console.log(chalk.green.bold("\n\u2705 StackMemory initialized successfully!\n"));
+console.log(chalk.gray("Next steps:"));
+console.log(chalk.gray("1. Add the MCP configuration above to Claude Code"));
+console.log(chalk.gray("2. Restart Claude Code"));
+console.log(chalk.gray("3. Start using context tracking!"));
+console.log(chalk.gray("\nUseful commands:"));
+console.log(
+  chalk.cyan("  npm run mcp:dev") + " - Start MCP server in dev mode"
+);
+console.log(chalk.cyan("  npm run status") + " - Check StackMemory status");
+console.log(chalk.cyan("  npm run analyze") + " - Analyze context usage\n");
+//# sourceMappingURL=initialize.js.map

package/dist/scripts/initialize.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../scripts/initialize.ts"],
+  "sourcesContent": ["#!/usr/bin/env tsx\n/**\n * Initialize StackMemory in the current project\n */\n\nimport {\n  existsSync,\n  mkdirSync,\n  writeFileSync,\n  readFileSync,\n  appendFileSync,\n} from 'fs';\nimport { join } from 'path';\nimport { execSync } from 'child_process';\nimport chalk from 'chalk';\n// Type-safe environment variable access\nfunction getEnv(key: string, defaultValue?: string): string {\n  const value = process.env[key];\n  if (value === undefined) {\n    if (defaultValue !== undefined) return defaultValue;\n    throw new Error(`Environment variable ${key} is required`);\n  }\n  return value;\n}\n\nfunction getOptionalEnv(key: string): string | undefined {\n  return process.env[key];\n}\n\nconst projectRoot = process.cwd();\n\nconsole.log(chalk.blue.bold('\\n\uD83D\uDE80 Initializing StackMemory...\\n'));\n\n// 1. Create .stackmemory directory\nconst stackDir = join(projectRoot, '.stackmemory');\nif (!existsSync(stackDir)) {\n  mkdirSync(stackDir, { recursive: true });\n  console.log(chalk.green('\u2713') + ' Created .stackmemory directory');\n} else {\n  console.log(chalk.yellow('\u26A0') + ' .stackmemory directory already exists');\n}\n\n// 2. Add to .gitignore\nconst gitignorePath = join(projectRoot, '.gitignore');\nconst gitignoreEntry =\n  '\\n# StackMemory\\n.stackmemory/*.db\\n.stackmemory/*.db-*\\n';\n\nif (existsSync(gitignorePath)) {\n  const gitignore = readFileSync(gitignorePath, 'utf-8');\n  if (!gitignore.includes('.stackmemory')) {\n    appendFileSync(gitignorePath, gitignoreEntry);\n    console.log(chalk.green('\u2713') + ' Added .stackmemory to .gitignore');\n  }\n} else {\n  writeFileSync(gitignorePath, gitignoreEntry);\n  console.log(chalk.green('\u2713') + ' Created .gitignore with .stackmemory');\n}\n\n// 3. Create config file\nconst configPath = join(stackDir, 'config.json');\nif (!existsSync(configPath)) {\n  const config = {\n    projectId: projectRoot.split('/').pop(),\n    userId: process.env['USER'] || 'default',\n    teamId: 'local',\n    initialized: new Date().toISOString(),\n  };\n  writeFileSync(configPath, JSON.stringify(config, null, 2));\n  console.log(chalk.green('\u2713') + ' Created config file');\n}\n\n// 4. Create initial JSONL file\nconst jsonlPath = join(stackDir, 'frames.jsonl');\nif (!existsSync(jsonlPath)) {\n  const initialFrame = {\n    id: 'init_' + Date.now(),\n    type: 'system',\n    content: 'StackMemory initialized',\n    timestamp: Date.now(),\n  };\n  writeFileSync(jsonlPath, JSON.stringify(initialFrame) + '\\n');\n  console.log(chalk.green('\u2713') + ' Created frames.jsonl');\n}\n\n// 5. Create MCP config for Claude Code\nconst isMacOS = process.platform === 'darwin';\nconst mcpConfigPath = isMacOS\n  ? join(\n      process.env['HOME'] || '~',\n      'Library',\n      'Application Support',\n      'Claude',\n      'claude_desktop_config.json'\n    )\n  : join(\n      process.env['HOME'] || '~',\n      '.config',\n      'claude',\n      'claude_desktop_config.json'\n    );\nconsole.log(chalk.blue('\\n\uD83D\uDCDD MCP Configuration for Claude Code:\\n'));\n\nconst mcpConfig = {\n  mcpServers: {\n    stackmemory: {\n      command: 'node',\n      args: [join(projectRoot, 'dist', 'integrations', 'mcp', 'server.js')],\n      env: {\n        PROJECT_ROOT: projectRoot,\n      },\n    },\n  },\n};\n\nconsole.log(chalk.gray('Add this to your Claude Code MCP configuration:'));\nconsole.log(chalk.gray('(' + mcpConfigPath + ')\\n'));\nconsole.log(chalk.cyan(JSON.stringify(mcpConfig, null, 2)));\n\n// 6. Build the project\nconsole.log(chalk.blue('\\n\uD83D\uDCE6 Building TypeScript files...\\n'));\ntry {\n  execSync('npm run build', { stdio: 'inherit', cwd: projectRoot });\n  console.log(chalk.green('\u2713') + ' Build completed');\n} catch {\n  console.log(chalk.yellow('\u26A0') + ' Build failed - run npm run build manually');\n}\n\nconsole.log(chalk.green.bold('\\n\u2705 StackMemory initialized successfully!\\n'));\nconsole.log(chalk.gray('Next steps:'));\nconsole.log(chalk.gray('1. Add the MCP configuration above to Claude Code'));\nconsole.log(chalk.gray('2. Restart Claude Code'));\nconsole.log(chalk.gray('3. Start using context tracking!'));\nconsole.log(chalk.gray('\\nUseful commands:'));\nconsole.log(\n  chalk.cyan('  npm run mcp:dev') + ' - Start MCP server in dev mode'\n);\nconsole.log(chalk.cyan('  npm run status') + ' - Check StackMemory status');\nconsole.log(chalk.cyan('  npm run analyze') + ' - Analyze context usage\\n');\n"],
+  "mappings": ";;;;;AAKA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,YAAY;AACrB,SAAS,gBAAgB;AACzB,OAAO,WAAW;AAElB,SAAS,OAAO,KAAa,cAA+B;AAC1D,QAAM,QAAQ,QAAQ,IAAI,GAAG;AAC7B,MAAI,UAAU,QAAW;AACvB,QAAI,iBAAiB,OAAW,QAAO;AACvC,UAAM,IAAI,MAAM,wBAAwB,GAAG,cAAc;AAAA,EAC3D;AACA,SAAO;AACT;AAEA,SAAS,eAAe,KAAiC;AACvD,SAAO,QAAQ,IAAI,GAAG;AACxB;AAEA,MAAM,cAAc,QAAQ,IAAI;AAEhC,QAAQ,IAAI,MAAM,KAAK,KAAK,2CAAoC,CAAC;AAGjE,MAAM,WAAW,KAAK,aAAa,cAAc;AACjD,IAAI,CAAC,WAAW,QAAQ,GAAG;AACzB,YAAU,UAAU,EAAE,WAAW,KAAK,CAAC;AACvC,UAAQ,IAAI,MAAM,MAAM,QAAG,IAAI,iCAAiC;AAClE,OAAO;AACL,UAAQ,IAAI,MAAM,OAAO,QAAG,IAAI,wCAAwC;AAC1E;AAGA,MAAM,gBAAgB,KAAK,aAAa,YAAY;AACpD,MAAM,iBACJ;AAEF,IAAI,WAAW,aAAa,GAAG;AAC7B,QAAM,YAAY,aAAa,eAAe,OAAO;AACrD,MAAI,CAAC,UAAU,SAAS,cAAc,GAAG;AACvC,mBAAe,eAAe,cAAc;AAC5C,YAAQ,IAAI,MAAM,MAAM,QAAG,IAAI,mCAAmC;AAAA,EACpE;AACF,OAAO;AACL,gBAAc,eAAe,cAAc;AAC3C,UAAQ,IAAI,MAAM,MAAM,QAAG,IAAI,uCAAuC;AACxE;AAGA,MAAM,aAAa,KAAK,UAAU,aAAa;AAC/C,IAAI,CAAC,WAAW,UAAU,GAAG;AAC3B,QAAM,SAAS;AAAA,IACb,WAAW,YAAY,MAAM,GAAG,EAAE,IAAI;AAAA,IACtC,QAAQ,QAAQ,IAAI,MAAM,KAAK;AAAA,IAC/B,QAAQ;AAAA,IACR,cAAa,oBAAI,KAAK,GAAE,YAAY;AAAA,EACtC;AACA,gBAAc,YAAY,KAAK,UAAU,QAAQ,MAAM,CAAC,CAAC;AACzD,UAAQ,IAAI,MAAM,MAAM,QAAG,IAAI,sBAAsB;AACvD;AAGA,MAAM,YAAY,KAAK,UAAU,cAAc;AAC/C,IAAI,CAAC,WAAW,SAAS,GAAG;AAC1B,QAAM,eAAe;AAAA,IACnB,IAAI,UAAU,KAAK,IAAI;AAAA,IACvB,MAAM;AAAA,IACN,SAAS;AAAA,IACT,WAAW,KAAK,IAAI;AAAA,EACtB;AACA,gBAAc,WAAW,KAAK,UAAU,YAAY,IAAI,IAAI;AAC5D,UAAQ,IAAI,MAAM,MAAM,QAAG,IAAI,uBAAuB;AACxD;AAGA,MAAM,UAAU,QAAQ,aAAa;AACrC,MAAM,gBAAgB,UAClB;AAAA,EACE,QAAQ,IAAI,MAAM,KAAK;AAAA,EACvB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,IACA;AAAA,EACE,QAAQ,IAAI,MAAM,KAAK;AAAA,EACvB;AAAA,EACA;AAAA,EACA;AACF;AACJ,QAAQ,IAAI,MAAM,KAAK,kDAA2C,CAAC;AAEnE,MAAM,YAAY;AAAA,EAChB,YAAY;AAAA,IACV,aAAa;AAAA,MACX,SAAS;AAAA,MACT,MAAM,CAAC,KAAK,aAAa,QAAQ,gBAAgB,OAAO,WAAW,CAAC;AAAA,MACpE,KAAK;AAAA,QACH,cAAc;AAAA,MAChB;AAAA,IACF;AAAA,EACF;AACF;AAEA,QAAQ,IAAI,MAAM,KAAK,iDAAiD,CAAC;AACzE,QAAQ,IAAI,MAAM,KAAK,MAAM,gBAAgB,KAAK,CAAC;AACnD,QAAQ,IAAI,MAAM,KAAK,KAAK,UAAU,WAAW,MAAM,CAAC,CAAC,CAAC;AAG1D,QAAQ,IAAI,MAAM,KAAK,4CAAqC,CAAC;AAC7D,IAAI;AACF,WAAS,iBAAiB,EAAE,OAAO,WAAW,KAAK,YAAY,CAAC;AAChE,UAAQ,IAAI,MAAM,MAAM,QAAG,IAAI,kBAAkB;AACnD,QAAQ;AACN,UAAQ,IAAI,MAAM,OAAO,QAAG,IAAI,4CAA4C;AAC9E;AAEA,QAAQ,IAAI,MAAM,MAAM,KAAK,kDAA6C,CAAC;AAC3E,QAAQ,IAAI,MAAM,KAAK,aAAa,CAAC;AACrC,QAAQ,IAAI,MAAM,KAAK,mDAAmD,CAAC;AAC3E,QAAQ,IAAI,MAAM,KAAK,wBAAwB,CAAC;AAChD,QAAQ,IAAI,MAAM,KAAK,kCAAkC,CAAC;AAC1D,QAAQ,IAAI,MAAM,KAAK,oBAAoB,CAAC;AAC5C,QAAQ;AAAA,EACN,MAAM,KAAK,mBAAmB,IAAI;AACpC;AACA,QAAQ,IAAI,MAAM,KAAK,kBAAkB,IAAI,6BAA6B;AAC1E,QAAQ,IAAI,MAAM,KAAK,mBAAmB,IAAI,4BAA4B;",
+  "names": []
+}

package/dist/scripts/list-linear-tasks.js

@@ -0,0 +1,124 @@
+#!/usr/bin/env ts-node
+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 "../src/integrations/linear/client.js";
+import { LinearAuthManager } from "../src/integrations/linear/auth.js";
+import chalk from "chalk";
+function getEnv(key, defaultValue) {
+  const value = process.env[key];
+  if (value === void 0) {
+    if (defaultValue !== void 0) return defaultValue;
+    throw new Error(`Environment variable ${key} is required`);
+  }
+  return value;
+}
+function getOptionalEnv(key) {
+  return process.env[key];
+}
+async function main() {
+  try {
+    console.log(chalk.cyan("\u{1F50D} Fetching Linear tasks...\n"));
+    const authManager = new LinearAuthManager(process.cwd());
+    const tokens = authManager.loadTokens();
+    const apiKey = process.env["LINEAR_API_KEY"];
+    if (!tokens && !apiKey) {
+      console.log(chalk.red("\u274C Not authenticated with Linear"));
+      console.log("Run: node dist/src/cli/index.js linear setup");
+      process.exit(1);
+    }
+    const client = apiKey ? new LinearClient({ apiKey }) : new LinearClient({
+      apiKey: tokens?.accessToken ?? "",
+      useBearer: true
+    });
+    console.log(chalk.gray("Fetching issues..."));
+    const issues = await client.getIssues({ limit: 200 });
+    if (!issues || issues.length === 0) {
+      console.log(chalk.gray("No issues found"));
+      return;
+    }
+    console.log(chalk.green(`\u2713 Found ${issues.length} tasks`));
+    const tasksByStatus = {};
+    issues.forEach((issue) => {
+      const statusType = issue.state.type;
+      const statusName = issue.state.name;
+      const key = `${statusType} (${statusName})`;
+      if (!tasksByStatus[key]) {
+        tasksByStatus[key] = [];
+      }
+      tasksByStatus[key].push({
+        identifier: issue.identifier,
+        title: issue.title,
+        priority: issue.priority,
+        assignee: issue.assignee?.name,
+        url: issue.url
+      });
+    });
+    const statusOrder = [
+      "backlog",
+      "unstarted",
+      "started",
+      "completed",
+      "cancelled"
+    ];
+    console.log(chalk.cyan("\n\u{1F4CB} Linear Tasks by Status:\n"));
+    statusOrder.forEach((statusType) => {
+      const matchingKeys = Object.keys(tasksByStatus).filter(
+        (key) => key.startsWith(statusType)
+      );
+      matchingKeys.forEach((statusKey) => {
+        const tasks = tasksByStatus[statusKey];
+        if (tasks.length === 0) return;
+        console.log(
+          chalk.bold.white(
+            `
+${getStatusEmoji(statusType)} ${statusKey} (${tasks.length} tasks)`
+          )
+        );
+        console.log(chalk.gray("".padEnd(60, "\u2500")));
+        tasks.forEach((task) => {
+          const priorityStr = task.priority > 0 ? chalk.yellow(`P${task.priority}`) : chalk.gray("--");
+          const assigneeStr = task.assignee ? chalk.blue(task.assignee) : chalk.gray("Unassigned");
+          const titleStr = task.title.length > 50 ? task.title.substring(0, 47) + "..." : task.title;
+          console.log(
+            `  ${chalk.cyan(task.identifier.padEnd(8))} ${titleStr.padEnd(50)} ${priorityStr.padEnd(8)} ${assigneeStr}`
+          );
+        });
+      });
+    });
+    const totalTasks = issues.length;
+    const statusCounts = Object.entries(tasksByStatus).map(
+      ([status, tasks]) => ({
+        status,
+        count: tasks.length
+      })
+    );
+    console.log(chalk.cyan("\n\u{1F4CA} Summary:"));
+    statusCounts.forEach(({ status, count }) => {
+      console.log(chalk.gray(`  ${status}: ${count} tasks`));
+    });
+    console.log(chalk.bold(`  Total: ${totalTasks} tasks`));
+  } catch (error) {
+    console.error(chalk.red("\u274C Error:"), error.message);
+    process.exit(1);
+  }
+}
+function getStatusEmoji(statusType) {
+  switch (statusType) {
+    case "backlog":
+      return "\u{1F4CB}";
+    case "unstarted":
+      return "\u{1F4DD}";
+    case "started":
+      return "\u23F3";
+    case "completed":
+      return "\u2705";
+    case "cancelled":
+      return "\u274C";
+    default:
+      return "\u{1F4C4}";
+  }
+}
+main();
+//# sourceMappingURL=list-linear-tasks.js.map

package/dist/scripts/list-linear-tasks.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../scripts/list-linear-tasks.ts"],
+  "sourcesContent": ["#!/usr/bin/env ts-node\n\n/**\n * Standalone script to list all Linear tasks grouped by status\n */\n\nimport { LinearClient } from '../src/integrations/linear/client.js';\nimport { LinearAuthManager } from '../src/integrations/linear/auth.js';\nimport chalk from 'chalk';\n// Type-safe environment variable access\nfunction getEnv(key: string, defaultValue?: string): string {\n  const value = process.env[key];\n  if (value === undefined) {\n    if (defaultValue !== undefined) return defaultValue;\n    throw new Error(`Environment variable ${key} is required`);\n  }\n  return value;\n}\n\nfunction getOptionalEnv(key: string): string | undefined {\n  return process.env[key];\n}\n\ninterface TasksByStatus {\n  [status: string]: Array<{\n    identifier: string;\n    title: string;\n    priority: number;\n    assignee?: string;\n    url: string;\n  }>;\n}\n\nasync function main() {\n  try {\n    console.log(chalk.cyan('\uD83D\uDD0D Fetching Linear tasks...\\n'));\n\n    // Try to get authentication\n    const authManager = new LinearAuthManager(process.cwd());\n    const tokens = authManager.loadTokens();\n    const apiKey = process.env['LINEAR_API_KEY'];\n\n    if (!tokens && !apiKey) {\n      console.log(chalk.red('\u274C Not authenticated with Linear'));\n      console.log('Run: node dist/src/cli/index.js linear setup');\n      process.exit(1);\n    }\n\n    // Create client\n    const client = apiKey\n      ? new LinearClient({ apiKey })\n      : new LinearClient({\n          apiKey: tokens?.accessToken ?? '',\n          useBearer: true,\n        });\n\n    // Get all issues (increase limit to get more tasks)\n    console.log(chalk.gray('Fetching issues...'));\n    const issues = await client.getIssues({ limit: 200 });\n\n    if (!issues || issues.length === 0) {\n      console.log(chalk.gray('No issues found'));\n      return;\n    }\n\n    console.log(chalk.green(`\u2713 Found ${issues.length} tasks`));\n\n    // Group tasks by status\n    const tasksByStatus: TasksByStatus = {};\n\n    issues.forEach((issue) => {\n      const statusType = issue.state.type;\n      const statusName = issue.state.name;\n      const key = `${statusType} (${statusName})`;\n\n      if (!tasksByStatus[key]) {\n        tasksByStatus[key] = [];\n      }\n\n      tasksByStatus[key].push({\n        identifier: issue.identifier,\n        title: issue.title,\n        priority: issue.priority,\n        assignee: issue.assignee?.name,\n        url: issue.url,\n      });\n    });\n\n    // Define status order for display\n    const statusOrder = [\n      'backlog',\n      'unstarted',\n      'started',\n      'completed',\n      'cancelled',\n    ];\n\n    // Display results grouped by status\n    console.log(chalk.cyan('\\n\uD83D\uDCCB Linear Tasks by Status:\\n'));\n\n    statusOrder.forEach((statusType) => {\n      // Find all status keys that match this type\n      const matchingKeys = Object.keys(tasksByStatus).filter((key) =>\n        key.startsWith(statusType)\n      );\n\n      matchingKeys.forEach((statusKey) => {\n        const tasks = tasksByStatus[statusKey];\n        if (tasks.length === 0) return;\n\n        // Status header with count\n        console.log(\n          chalk.bold.white(\n            `\\n${getStatusEmoji(statusType)} ${statusKey} (${tasks.length} tasks)`\n          )\n        );\n        console.log(chalk.gray(''.padEnd(60, '\u2500')));\n\n        // List tasks\n        tasks.forEach((task) => {\n          const priorityStr =\n            task.priority > 0\n              ? chalk.yellow(`P${task.priority}`)\n              : chalk.gray('--');\n          const assigneeStr = task.assignee\n            ? chalk.blue(task.assignee)\n            : chalk.gray('Unassigned');\n          const titleStr =\n            task.title.length > 50\n              ? task.title.substring(0, 47) + '...'\n              : task.title;\n\n          console.log(\n            `  ${chalk.cyan(task.identifier.padEnd(8))} ${titleStr.padEnd(50)} ${priorityStr.padEnd(8)} ${assigneeStr}`\n          );\n        });\n      });\n    });\n\n    // Summary\n    const totalTasks = issues.length;\n    const statusCounts = Object.entries(tasksByStatus).map(\n      ([status, tasks]) => ({\n        status,\n        count: tasks.length,\n      })\n    );\n\n    console.log(chalk.cyan('\\n\uD83D\uDCCA Summary:'));\n    statusCounts.forEach(({ status, count }) => {\n      console.log(chalk.gray(`  ${status}: ${count} tasks`));\n    });\n    console.log(chalk.bold(`  Total: ${totalTasks} tasks`));\n  } catch (error: unknown) {\n    console.error(chalk.red('\u274C Error:'), (error as Error).message);\n    process.exit(1);\n  }\n}\n\nfunction getStatusEmoji(statusType: string): string {\n  switch (statusType) {\n    case 'backlog':\n      return '\uD83D\uDCCB';\n    case 'unstarted':\n      return '\uD83D\uDCDD';\n    case 'started':\n      return '\u23F3';\n    case 'completed':\n      return '\u2705';\n    case 'cancelled':\n      return '\u274C';\n    default:\n      return '\uD83D\uDCC4';\n  }\n}\n\n// Direct execution\nmain();\n"],
+  "mappings": "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",
+  "names": []
+}