@stackmemoryai/stackmemory 1.2.6 → 1.2.8

package/README.md

@@ -5,12 +5,16 @@
 [![Coverage](https://codecov.io/gh/stackmemoryai/stackmemory/branch/main/graph/badge.svg)](https://codecov.io/gh/stackmemoryai/stackmemory)
 [![npm version](https://img.shields.io/npm/v/@stackmemoryai/stackmemory)](https://www.npmjs.com/package/@stackmemoryai/stackmemory)
 
-Lossless, project-scoped memory for AI coding tools.
+Lossless, project-scoped memory for AI coding tools. **[Website](https://stackmemoryai.github.io/stackmemory/)** | **[MCP Tools](https://stackmemoryai.github.io/stackmemory/tools.html)** | **[Getting Started](./docs/GETTING_STARTED.md)**
+
+<p align="center">
+  <img src="site/demo.svg" alt="StackMemory setup demo" width="560">
+</p>
 
 StackMemory is a **production-ready memory runtime** for AI coding tools that preserves full project context across sessions:
 
 - **Zero-config setup** — `stackmemory init` just works
-- **32 MCP tools** for Claude Code integration (context, tasks, Linear, traces, discovery, cord, team)
+- **55 MCP tools** for Claude Code integration (context, tasks, Linear, traces, discovery, cord, team)
 - **FTS5 full-text search** with BM25 scoring and hybrid retrieval
 - **Full Linear integration** with bidirectional sync and OAuth/API key support
 - **Context persistence** that survives `/clear` operations
@@ -53,7 +57,7 @@ Tools forget decisions and constraints between sessions. StackMemory makes conte
 
 ## Features
 
-- **MCP tools** for Claude Code: 36 tools across context, tasks, Linear, traces, discovery, cord, and team
+- **MCP tools** for Claude Code: 56 tools across context, tasks, Linear, traces, planning, discovery, cord, team, and more
 - **FTS5 search**: full-text search with BM25 scoring, hybrid retrieval, and smart thresholds
 - **Skills**: `/spec` (iterative spec generation), `/linear-run` (task execution via RLM)
 - **Hooks**: automatic context save, task tracking, Linear sync, PROMPT_PLAN updates, cord tracing
@@ -351,6 +355,8 @@ See [docs/cli.md](https://github.com/stackmemoryai/stackmemory/blob/main/docs/cl
 
 ## Documentation
 
+- [Getting Started](./docs/GETTING_STARTED.md) — Quick start guide (5 minutes)
+- [MCP Tools Reference](https://stackmemoryai.github.io/stackmemory/tools.html) — All 55 MCP tools
 - [CLI Reference](./docs/cli.md) — Full command reference
 - [Setup Guide](./docs/SETUP.md) — Advanced setup options
 - [Development Guide](./docs/DEVELOPMENT.md) — Contributing and development

package/dist/src/cli/commands/digest.js

@@ -0,0 +1,73 @@
+import { fileURLToPath as __fileURLToPath } from 'url';
+import { dirname as __pathDirname } from 'path';
+const __filename = __fileURLToPath(import.meta.url);
+const __dirname = __pathDirname(__filename);
+import { Command } from "commander";
+import Database from "better-sqlite3";
+import { join } from "path";
+import { existsSync, writeFileSync, mkdirSync } from "fs";
+import { execSync } from "child_process";
+import {
+  generateChronologicalDigest
+} from "../../core/digest/chronological-digest.js";
+function findProjectRoot() {
+  let dir = process.cwd();
+  while (dir !== "/") {
+    if (existsSync(join(dir, ".git"))) return dir;
+    dir = join(dir, "..");
+  }
+  return process.cwd();
+}
+function getProjectId(projectRoot) {
+  let identifier;
+  try {
+    identifier = execSync("git config --get remote.origin.url", {
+      cwd: projectRoot,
+      stdio: "pipe",
+      timeout: 5e3
+    }).toString().trim();
+  } catch {
+    identifier = projectRoot;
+  }
+  const cleaned = identifier.replace(/\.git$/, "").replace(/[^a-zA-Z0-9-]/g, "-").toLowerCase();
+  return cleaned.substring(cleaned.length - 50) || "unknown";
+}
+function createDigestCommands() {
+  const digest = new Command("digest").description("Generate chronological activity digest").argument("<period>", "Time period: today, yesterday, or week").option("-o, --output <path>", "Custom output path").action((period, options) => {
+    const validPeriods = ["today", "yesterday", "week"];
+    if (!validPeriods.includes(period)) {
+      console.error(
+        `Invalid period "${period}". Use: ${validPeriods.join(", ")}`
+      );
+      process.exit(1);
+    }
+    const projectRoot = findProjectRoot();
+    const dbPath = join(projectRoot, ".stackmemory", "context.db");
+    if (!existsSync(dbPath)) {
+      console.error(
+        "No StackMemory database found. Run stackmemory in a project first."
+      );
+      process.exit(1);
+    }
+    const db = new Database(dbPath, { readonly: true });
+    const projectId = getProjectId(projectRoot);
+    try {
+      const markdown = generateChronologicalDigest(
+        db,
+        period,
+        projectId
+      );
+      const smDir = join(projectRoot, ".stackmemory");
+      if (!existsSync(smDir)) mkdirSync(smDir, { recursive: true });
+      const outputPath = options.output || join(smDir, `${period}.md`);
+      writeFileSync(outputPath, markdown);
+      console.log(`Digest written to ${outputPath}`);
+    } finally {
+      db.close();
+    }
+  });
+  return digest;
+}
+export {
+  createDigestCommands
+};

package/dist/src/cli/commands/ralph.js

@@ -317,12 +317,12 @@ ${contextResponse.context}`;
     "Launch Oracle/Worker pattern swarm for cost-effective execution"
   ).argument("<project>", "Project description for Oracle planning").option(
     "--oracle <model>",
-    "Oracle model (default: claude-3-opus)",
-    "claude-3-opus-20240229"
+    "Oracle model (default: claude-sonnet-4-5)",
+    "claude-sonnet-4-5-20250929"
   ).option(
     "--workers <models>",
     "Comma-separated worker models",
-    "claude-3-5-haiku-20241022"
+    "claude-haiku-4-5-20251001"
   ).option("--budget <amount>", "Cost budget in USD", "10.0").option("--max-workers <count>", "Maximum worker agents", "5").option("--hints <hints>", "Comma-separated planning hints").action(async (project, options) => {
     return trace.command(
       "ralph-oracle-worker",

package/dist/src/cli/index.js

@@ -54,6 +54,7 @@ import { createPingCommand } from "./commands/ping.js";
 import { createAuditCommand } from "./commands/audit.js";
 import { createStatsCommand } from "./commands/stats.js";
 import { createBenchCommand } from "./commands/bench.js";
+import { createDigestCommands } from "./commands/digest.js";
 import chalk from "chalk";
 import * as fs from "fs";
 import * as path from "path";
@@ -501,6 +502,7 @@ program.addCommand(createModelCommand());
 program.addCommand(createAuditCommand());
 program.addCommand(createStatsCommand());
 program.addCommand(createBenchCommand());
+program.addCommand(createDigestCommands());
 registerSetupCommands(program);
 program.command("mm-spike").description(
   "Run multi-agent planning/implementation spike (planner/implementer/critic)"

package/dist/src/core/digest/chronological-digest.js

@@ -0,0 +1,143 @@
+import { fileURLToPath as __fileURLToPath } from 'url';
+import { dirname as __pathDirname } from 'path';
+const __filename = __fileURLToPath(import.meta.url);
+const __dirname = __pathDirname(__filename);
+function getTimeRange(period) {
+  const now = /* @__PURE__ */ new Date();
+  const todayStart = new Date(now.getFullYear(), now.getMonth(), now.getDate());
+  switch (period) {
+    case "today": {
+      return {
+        start: Math.floor(todayStart.getTime() / 1e3),
+        end: Math.floor(now.getTime() / 1e3),
+        label: `Today \u2014 ${todayStart.toISOString().slice(0, 10)}`
+      };
+    }
+    case "yesterday": {
+      const yesterdayStart = new Date(todayStart);
+      yesterdayStart.setDate(yesterdayStart.getDate() - 1);
+      return {
+        start: Math.floor(yesterdayStart.getTime() / 1e3),
+        end: Math.floor(todayStart.getTime() / 1e3),
+        label: `Yesterday \u2014 ${yesterdayStart.toISOString().slice(0, 10)}`
+      };
+    }
+    case "week": {
+      const weekStart = new Date(todayStart);
+      weekStart.setDate(weekStart.getDate() - 7);
+      return {
+        start: Math.floor(weekStart.getTime() / 1e3),
+        end: Math.floor(now.getTime() / 1e3),
+        label: `Week \u2014 ${weekStart.toISOString().slice(0, 10)} to ${todayStart.toISOString().slice(0, 10)}`
+      };
+    }
+  }
+}
+function formatDate(epoch) {
+  return new Date(epoch * 1e3).toISOString().slice(0, 10);
+}
+function generateChronologicalDigest(db, period, projectId) {
+  const { start, end, label } = getTimeRange(period);
+  let frames = db.prepare(
+    `SELECT frame_id, name, type, state, created_at, closed_at, inputs, outputs
+       FROM frames
+       WHERE project_id = ? AND created_at >= ? AND created_at < ?
+       ORDER BY created_at ASC`
+  ).all(projectId, start, end);
+  if (frames.length === 0 && projectId !== "default") {
+    frames = db.prepare(
+      `SELECT frame_id, name, type, state, created_at, closed_at, inputs, outputs
+         FROM frames
+         WHERE project_id = 'default' AND created_at >= ? AND created_at < ?
+         ORDER BY created_at ASC`
+    ).all(start, end);
+  }
+  if (frames.length === 0) {
+    return `# ${label}
+
+No activity recorded.
+`;
+  }
+  const frameIds = frames.map((f) => f.frame_id);
+  const placeholders = frameIds.map(() => "?").join(",");
+  const anchors = db.prepare(
+    `SELECT anchor_id, frame_id, type, text, priority, created_at
+       FROM anchors
+       WHERE frame_id IN (${placeholders})
+       ORDER BY priority DESC, created_at ASC`
+  ).all(...frameIds);
+  const events = db.prepare(
+    `SELECT event_id, frame_id, event_type, payload, ts
+       FROM events
+       WHERE frame_id IN (${placeholders}) AND event_type IN ('tool_call', 'decision')
+       ORDER BY ts ASC`
+  ).all(...frameIds);
+  const anchorsByFrame = /* @__PURE__ */ new Map();
+  for (const a of anchors) {
+    const list = anchorsByFrame.get(a.frame_id) || [];
+    list.push(a);
+    anchorsByFrame.set(a.frame_id, list);
+  }
+  const eventsByFrame = /* @__PURE__ */ new Map();
+  for (const e of events) {
+    const list = eventsByFrame.get(e.frame_id) || [];
+    list.push(e);
+    eventsByFrame.set(e.frame_id, list);
+  }
+  const framesByDate = /* @__PURE__ */ new Map();
+  for (const f of frames) {
+    const date = formatDate(f.created_at);
+    const list = framesByDate.get(date) || [];
+    list.push(f);
+    framesByDate.set(date, list);
+  }
+  const lines = [`# ${label}
+`];
+  const renderFrame = (f) => {
+    lines.push(`## ${f.name} (${f.type}, ${f.state})`);
+    const frameAnchors = anchorsByFrame.get(f.frame_id) || [];
+    const frameEvents = eventsByFrame.get(f.frame_id) || [];
+    for (const a of frameAnchors.slice(0, 8)) {
+      lines.push(`- ${a.type}: ${a.text}`);
+    }
+    const files = /* @__PURE__ */ new Set();
+    for (const e of frameEvents) {
+      try {
+        const payload = JSON.parse(e.payload);
+        if (payload.arguments?.file_path)
+          files.add(payload.arguments.file_path);
+        if (payload.arguments?.path) files.add(payload.arguments.path);
+      } catch {
+      }
+    }
+    if (files.size > 0) {
+      lines.push(`- ${files.size} files touched`);
+    }
+    lines.push("");
+  };
+  if (period === "week") {
+    for (const [date, dateFrames] of framesByDate) {
+      lines.push(`### ${date}
+`);
+      for (const f of dateFrames) {
+        renderFrame(f);
+      }
+    }
+  } else {
+    for (const f of frames) {
+      renderFrame(f);
+    }
+  }
+  const completed = frames.filter((f) => f.state === "completed").length;
+  const active = frames.filter((f) => f.state === "active").length;
+  lines.push("---");
+  lines.push(
+    `*${frames.length} frames total: ${completed} completed, ${active} active*`
+  );
+  lines.push(`*Generated: ${(/* @__PURE__ */ new Date()).toISOString()}*
+`);
+  return lines.join("\n");
+}
+export {
+  generateChronologicalDigest
+};

package/dist/src/core/digest/index.js

@@ -6,3 +6,4 @@ export * from "./types.js";
 export * from "./hybrid-digest-generator.js";
 export * from "./hybrid-digest.js";
 export * from "./frame-digest-integration.js";
+export * from "./chronological-digest.js";

package/dist/src/core/extensions/provider-adapter.js

@@ -113,10 +113,11 @@ class ClaudeAdapter {
   }
   async listModels() {
     return [
-      "claude-opus-4-20250514",
+      "claude-opus-4-6",
+      "claude-sonnet-4-5-20250929",
+      "claude-haiku-4-5-20251001",
       "claude-sonnet-4-20250514",
-      "claude-3-5-haiku-20241022",
-      "claude-3-opus-20240229"
+      "claude-3-5-haiku-20241022"
     ];
   }
   buildRequestBody(messages, options) {
@@ -360,16 +361,7 @@ class GPTAdapter {
     }
   }
   async listModels() {
-    return [
-      "gpt-4o",
-      "gpt-4o-mini",
-      "gpt-4-turbo",
-      "gpt-4",
-      "gpt-3.5-turbo",
-      "o1",
-      "o1-mini",
-      "o1-preview"
-    ];
+    return ["gpt-4o", "gpt-4o-mini", "o3-mini", "o4-mini"];
   }
 }
 function createProvider(id, config) {

package/dist/src/core/models/model-router.js

@@ -22,16 +22,14 @@ const MODEL_TOKEN_LIMITS = {
   "claude-sonnet-4-5-20250929": 2e5,
   "claude-haiku-4-5-20251001": 2e5,
   "claude-sonnet-4-20250514": 2e5,
-  // Claude 3.x
+  // Claude 3.x (legacy, still functional)
   "claude-3-5-sonnet-20241022": 2e5,
   "claude-3-5-haiku-20241022": 2e5,
-  "claude-3-opus-20240229": 2e5,
   // OpenAI
   "gpt-4o": 128e3,
-  "gpt-4-turbo": 128e3,
-  "gpt-4": 8192,
-  o1: 2e5,
+  "gpt-4o-mini": 128e3,
   "o3-mini": 2e5,
+  "o4-mini": 2e5,
   // Qwen
   "qwen3-max-2025-01-23": 128e3,
   // Cerebras