@stackmemoryai/stackmemory 0.8.1 → 1.0.0

package/LICENSE

@@ -0,0 +1,64 @@
+Business Source License 1.1
+
+Parameters
+
+Licensor:             StackMemory AI
+Licensed Work:        StackMemory v1.0.0
+                      The Licensed Work is (c) 2026 StackMemory AI
+Additional Use Grant: You may make production use of the Licensed Work,
+                      provided such use does not include offering the
+                      Licensed Work to third parties on a hosted or
+                      embedded basis which is competitive with StackMemory
+                      AI's products.
+Change Date:          2030-02-10
+Change License:       MIT
+
+For information about alternative licensing arrangements for the Licensed
+Work, please contact: hello@stackmemory.ai
+
+Notice
+
+Business Source License 1.1
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create
+derivative works, redistribute, and make non-production use of the
+Licensed Work. The Licensor may make an Additional Use Grant, above,
+permitting limited production use.
+
+Effective on the Change Date, or the fourth anniversary of the first
+publicly available distribution of a specific version of the Licensed
+Work under this License, whichever comes first, the Licensor hereby
+grants you rights under the terms of the Change License, and the rights
+granted in the paragraph above terminate.
+
+If your use of the Licensed Work does not comply with the requirements
+currently in effect as described in this License, you must purchase a
+commercial license from the Licensor, its affiliated entities, or
+authorized resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative
+works of the Licensed Work, are subject to this License. This License
+applies separately for each version of the Licensed Work and the Change
+Date may vary for each version of the Licensed Work released by
+Licensor.
+
+You must conspicuously display this License on each original or modified
+copy of the Licensed Work. If you receive the Licensed Work in original
+or modified form from a third party, the terms and conditions set forth
+in this License apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will
+automatically terminate your rights under this License for the current
+and all other versions of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of
+Licensor or its affiliates (provided that you may use a trademark or
+logo of Licensor as expressly required by this License).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS
+PROVIDED ON AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES
+AND CONDITIONS, EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION)
+WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE,
+NON-INFRINGEMENT, AND TITLE.

package/README.md

@@ -25,6 +25,19 @@ Instead of a linear chat log, StackMemory organizes memory as a **call stack** o
 
 ---
 
+## Who is this for?
+
+| You are... | StackMemory helps you... |
+|------------|--------------------------|
+| **Solo dev using Claude Code** | Keep decisions, constraints, and progress across sessions — no more re-explaining context after `/clear` |
+| **Team using AI coding tools** | Share project context across agents and teammates with a single source of truth |
+| **AI-first startup** | Ship faster with persistent memory, automatic Linear sync, and recursive task orchestration |
+| **Open-source maintainer** | Onboard contributors and AI agents with durable project knowledge |
+
+If you use an LLM coding assistant and lose context between sessions, StackMemory fixes that.
+
+---
+
 ## Why StackMemory exists
 
 Tools forget decisions and constraints between sessions. StackMemory makes context durable and actionable.
@@ -43,7 +56,7 @@ Tools forget decisions and constraints between sessions. StackMemory makes conte
 - **Prompt Forge**: watches AGENTS.md and CLAUDE.md for prompt optimization (GEPA)
 - **Safe branches**: worktree isolation with `--worktree` or `-w`
 - **Persistent context**: frames, anchors, decisions, retrieval
-- **Integrations**: Linear, Greptile, DiffMem, Browser MCP
+- **Integrations**: Linear, DiffMem, Browser MCP
 
 ---
 
@@ -533,8 +546,7 @@ See https://github.com/stackmemoryai/stackmemory/blob/main/docs/roadmap.md for o
 
 ## License
 
-- Hosted service: Proprietary
-- Open-source mirror: Apache 2.0 / MIT (TBD)
+Licensed under the [Business Source License 1.1](./LICENSE). You can use, modify, and self-host StackMemory freely. The one restriction: you may not offer it as a competing hosted service. The license converts to MIT after 4 years per release.
 
 ---
 

package/dist/src/agents/core/agent-task-manager.js

@@ -524,4 +524,3 @@ export {
   AgentTaskManager,
   AgentType
 };
-//# sourceMappingURL=agent-task-manager.js.map

package/dist/src/agents/verifiers/base-verifier.js

@@ -130,4 +130,3 @@ ${errorList}`;
 export {
   BaseVerifier
 };
-//# sourceMappingURL=base-verifier.js.map

package/dist/src/agents/verifiers/formatter-verifier.js

@@ -127,4 +127,3 @@ class FormatterVerifier extends BaseVerifier {
 export {
   FormatterVerifier
 };
-//# sourceMappingURL=formatter-verifier.js.map

package/dist/src/agents/verifiers/llm-judge.js

@@ -249,4 +249,3 @@ class LLMJudge extends BaseVerifier {
 export {
   LLMJudge
 };
-//# sourceMappingURL=llm-judge.js.map

package/dist/src/cli/auto-detect.js

@@ -318,4 +318,3 @@ class ClaudeAutoDetect {
 export {
   ClaudeAutoDetect
 };
-//# sourceMappingURL=auto-detect.js.map

package/dist/src/cli/claude-sm-danger.js

@@ -18,4 +18,3 @@ child.on("error", (err) => {
   console.error("Failed to launch claude-sm:", err.message);
   process.exit(1);
 });
-//# sourceMappingURL=claude-sm-danger.js.map

package/dist/src/cli/claude-sm.js

@@ -1067,4 +1067,3 @@ program.option("-w, --worktree", "Create isolated worktree for this instance").o
   await claudeSM.run(args);
 });
 program.parse(process.argv);
-//# sourceMappingURL=claude-sm.js.map

package/dist/src/cli/codex-sm-danger.js

@@ -18,4 +18,3 @@ child.on("error", (err) => {
   console.error("Failed to launch codex-sm:", err.message);
   process.exit(1);
 });
-//# sourceMappingURL=codex-sm-danger.js.map

package/dist/src/cli/codex-sm.js

@@ -374,4 +374,3 @@ program.name("codex-sm").description("Codex with StackMemory context and optiona
   await codexSM.run(args);
 });
 program.parse(process.argv);
-//# sourceMappingURL=codex-sm.js.map

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

@@ -229,4 +229,3 @@ Registered ${registered}/${discovered.length} APIs`);
 export {
   createAPICommand
 };
-//# sourceMappingURL=api.js.map

package/dist/src/cli/commands/auto-background.js

@@ -177,4 +177,3 @@ Examples:
 export {
   createAutoBackgroundCommand
 };
-//# sourceMappingURL=auto-background.js.map

package/dist/src/cli/commands/cleanup-processes.js

@@ -65,4 +65,3 @@ Killed: ${result.killed.length}`);
 export {
   createCleanupProcessesCommand
 };
-//# sourceMappingURL=cleanup-processes.js.map

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

@@ -194,4 +194,3 @@ var clear_default = clearCommand;
 export {
   clear_default as default
 };
-//# sourceMappingURL=clear.js.map

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

@@ -442,4 +442,3 @@ Storage Modes:
 export {
   createConfigCommand
 };
-//# sourceMappingURL=config.js.map

package/dist/src/cli/commands/context-rehydrate.js

@@ -748,4 +748,3 @@ async function calculateCheckpointHash(checkpoint) {
 export {
   createContextRehydrateCommand
 };
-//# sourceMappingURL=context-rehydrate.js.map

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

@@ -340,4 +340,3 @@ function createContextCommands() {
 export {
   createContextCommands
 };
-//# sourceMappingURL=context.js.map

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

@@ -447,4 +447,3 @@ export {
   createDaemonCommand,
   daemon_default as default
 };
-//# sourceMappingURL=daemon.js.map

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

@@ -102,9 +102,9 @@ const dashboardCommand = {
         style: { head: [], border: [] }
       });
       statsTable.push(
-        ["Total Frames", frameStats.total || 0],
-        ["Active Frames", chalk.green(frameStats.active || 0)],
-        ["Total Sessions", frameStats.sessions || 0]
+        ["Total Frames", frameStats?.total || 0],
+        ["Active Frames", chalk.green(frameStats?.active || 0)],
+        ["Total Sessions", frameStats?.sessions || 0]
       );
       console.log(chalk.yellow.bold("\u{1F4C8} Frame Statistics"));
       console.log(statsTable.toString());
@@ -199,7 +199,7 @@ async function estimateContextUsage(db) {
     WHERE state = 'active'
   `
   ).get();
-  const totalBytes = (result.input_size || 0) + (result.output_size || 0);
+  const totalBytes = (result?.input_size || 0) + (result?.output_size || 0);
   const estimatedTokens = totalBytes / 4;
   const maxTokens = 128e3;
   return Math.round(estimatedTokens / maxTokens * 100);
@@ -207,4 +207,3 @@ async function estimateContextUsage(db) {
 export {
   dashboardCommand
 };
-//# sourceMappingURL=dashboard.js.map

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

@@ -144,4 +144,3 @@ export {
   registerDbCommands,
   registerLogoutCommand
 };
-//# sourceMappingURL=db.js.map

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

@@ -263,4 +263,3 @@ export {
   createMemoryCommand,
   getSessionDecisions
 };
-//# sourceMappingURL=decision.js.map

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

@@ -276,4 +276,3 @@ Finding files related to: ${target}
 export {
   createDiscoveryCommands
 };
-//# sourceMappingURL=discovery.js.map

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

@@ -621,4 +621,3 @@ export {
   createHandoffCommand,
   createRestoreCommand
 };
-//# sourceMappingURL=handoff.js.map

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

@@ -295,4 +295,3 @@ export {
   createHooksCommand,
   hooks_default as default
 };
-//# sourceMappingURL=hooks.js.map

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

@@ -526,4 +526,3 @@ Showing ${displayTasks.length} of ${tasks.length} total tasks`
 export {
   registerLinearCommands
 };
-//# sourceMappingURL=linear.js.map

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

@@ -166,4 +166,3 @@ function createLogCommand() {
 export {
   createLogCommand
 };
-//# sourceMappingURL=log.js.map

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

@@ -169,4 +169,3 @@ ${data.databaseUrl ? `DATABASE_URL=${data.databaseUrl}` : ""}
 export {
   registerLoginCommand
 };
-//# sourceMappingURL=login.js.map

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

@@ -237,4 +237,3 @@ main().catch((e) => {
   console.error(e);
   process.exit(1);
 });
-//# sourceMappingURL=migrate.js.map

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

@@ -530,4 +530,3 @@ function getDefaultKeyEnv(provider) {
 export {
   createModelCommand
 };
-//# sourceMappingURL=model.js.map

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

@@ -549,4 +549,3 @@ function showNextSteps(config) {
 export {
   registerOnboardingCommand
 };
-//# sourceMappingURL=onboard.js.map

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

@@ -11,4 +11,3 @@ function createPingCommand() {
 export {
   createPingCommand
 };
-//# sourceMappingURL=ping.js.map

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

@@ -196,4 +196,3 @@ function registerProjectCommands(program) {
 export {
   registerProjectCommands
 };
-//# sourceMappingURL=projects.js.map

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

@@ -1008,4 +1008,3 @@ export {
   createRalphCommand,
   ralph_default as default
 };
-//# sourceMappingURL=ralph.js.map

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

@@ -245,4 +245,3 @@ function formatConfidence(score) {
 export {
   createRetrievalCommands
 };
-//# sourceMappingURL=retrieval.js.map

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

@@ -170,4 +170,3 @@ function createSearchCommand() {
 export {
   createSearchCommand
 };
-//# sourceMappingURL=search.js.map

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

@@ -746,4 +746,3 @@ export {
   service_default as default,
   installServiceSilent
 };
-//# sourceMappingURL=service.js.map

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

@@ -197,4 +197,3 @@ function formatDuration(ms) {
 export {
   createSessionCommands
 };
-//# sourceMappingURL=session.js.map

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

@@ -678,9 +678,6 @@ WantedBy=default.target`;
     console.log(chalk.gray(`
 Logs: ${logDir}/remote-mcp.log`));
     console.log(chalk.gray(`Service: ${serviceFile}`));
-    console.log(chalk.cyan("\nFor external access (ngrok):"));
-    console.log(chalk.white(`  ngrok http ${port}`));
-    console.log(chalk.gray("  Then use the ngrok URL + /sse in Claude.ai"));
   });
   return cmd;
 }
@@ -697,4 +694,3 @@ export {
   createSetupRemoteCommand,
   registerSetupCommands
 };
-//# sourceMappingURL=setup.js.map

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

@@ -246,4 +246,3 @@ export {
   createShellCommand,
   shell_default as default
 };
-//# sourceMappingURL=shell.js.map

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

@@ -47,4 +47,3 @@ function registerSignupCommand(program) {
 export {
   registerSignupCommand
 };
-//# sourceMappingURL=signup.js.map

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

@@ -75,6 +75,7 @@ async function initializeSkillContext() {
   const embeddingProvider = await createTransformersProvider() ?? void 0;
   const database = new SQLiteAdapter(projectId, { dbPath, embeddingProvider });
   await database.connect();
+  await database.initializeSchema();
   const rawDatabase = database.getRawDatabase();
   if (!rawDatabase) {
     throw new DatabaseError(
@@ -380,14 +381,15 @@ function createSkillsCommand() {
         { plannerModel: options.plannerModel }
       );
       spinner.stop();
+      const planRecord = plan;
       const compacted = options.compact ? {
         summary: plan?.summary,
-        steps: Array.isArray(plan?.steps) ? plan.steps.map((s) => ({
+        steps: Array.isArray(planRecord?.steps) ? planRecord.steps.map((s) => ({
           id: s.id,
           title: s.title,
           acceptanceCriteria: s.acceptanceCriteria
         })) : [],
-        risks: plan?.risks
+        risks: planRecord?.risks
       } : plan;
       const payload = JSON.stringify(compacted, null, options.pretty ? 2 : 0);
       console.log(payload);
@@ -768,4 +770,3 @@ Options:
 export {
   createSkillsCommand
 };
-//# sourceMappingURL=skills.js.map

package/dist/src/cli/commands/storage-tier.js

@@ -180,4 +180,3 @@ function getStorageConfig() {
 export {
   createStorageTierCommand
 };
-//# sourceMappingURL=storage-tier.js.map

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

@@ -246,4 +246,3 @@ function formatUptime(seconds) {
 export {
   createSweepCommand
 };
-//# sourceMappingURL=sweep.js.map

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

@@ -210,4 +210,3 @@ function findTaskByPartialId(projectRoot, partialId) {
 export {
   createTaskCommands
 };
-//# sourceMappingURL=tasks.js.map

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

@@ -140,9 +140,9 @@ Detected ${worktrees.length} worktree(s):`));
             `
           ).get();
           console.log(chalk.cyan("\nContext Statistics:"));
-          console.log(chalk.gray("  Frames:"), stats.frames);
-          console.log(chalk.gray("  Events:"), stats.events);
-          console.log(chalk.gray("  Contexts:"), stats.contexts);
+          console.log(chalk.gray("  Frames:"), stats?.frames ?? 0);
+          console.log(chalk.gray("  Events:"), stats?.events ?? 0);
+          console.log(chalk.gray("  Contexts:"), stats?.contexts ?? 0);
           db.close();
         } else {
           console.log(chalk.yellow("\nContext not initialized"));
@@ -171,7 +171,13 @@ Detected ${worktrees.length} worktree(s):`));
       if (options.from) {
         CommitSchema.parse(options.from);
       }
-      const gitArgs = ["worktree", "add", "-b", validatedBranch, worktreePath];
+      const gitArgs = [
+        "worktree",
+        "add",
+        "-b",
+        validatedBranch,
+        worktreePath
+      ];
       if (options.from) {
         gitArgs.push(options.from);
       }
@@ -316,4 +322,3 @@ Detected ${worktrees.length} worktree(s):`));
 export {
   registerWorktreeCommands
 };
-//# sourceMappingURL=worktree.js.map

package/dist/src/cli/index.js

@@ -79,6 +79,14 @@ function findPackageJson() {
   return { version: "0.0.0" };
 }
 const VERSION = findPackageJson().version;
+const nodeMajor = parseInt(process.version.slice(1), 10);
+if (nodeMajor < 20) {
+  console.error(
+    `[ERROR] Node.js 20+ required. Current: ${process.version}
+  Upgrade: https://nodejs.org/`
+  );
+  process.exit(1);
+}
 async function openDatabase(dbPath) {
   const { default: Database } = await import("better-sqlite3");
   return new Database(dbPath);
@@ -428,10 +436,6 @@ program.command("mcp-remote").description(
     console.log("");
     console.log("For Claude.ai web connector:");
     console.log(`  URL: http://localhost:${port}/sse`);
-    console.log("");
-    console.log("For external access (ngrok):");
-    console.log(`  ngrok http ${port}`);
-    console.log("  Then use the ngrok URL + /sse in Claude.ai");
   } catch (error) {
     logger.error("Failed to start remote MCP server", error);
     console.error("Remote MCP server failed:", error.message);
@@ -878,4 +882,3 @@ if (isMainModule) {
 export {
   program
 };
-//# sourceMappingURL=index.js.map

package/dist/src/cli/opencode-sm.js

@@ -473,4 +473,3 @@ program.option("-w, --worktree", "Create isolated worktree for this instance").o
   await opencodeSM.run(args);
 });
 program.parse(process.argv);
-//# sourceMappingURL=opencode-sm.js.map

package/dist/src/cli/utils/viewer.js

@@ -93,4 +93,3 @@ if (import.meta.url === `file://${process.argv[1]}`) {
 export {
   displayAnalyticsDashboard
 };
-//# sourceMappingURL=viewer.js.map

package/dist/src/core/config/config-manager.js

@@ -395,4 +395,3 @@ class ConfigManager {
 export {
   ConfigManager
 };
-//# sourceMappingURL=config-manager.js.map

package/dist/src/core/config/feature-flags.js

@@ -61,4 +61,3 @@ export {
   isLocalOnly,
   logFeatureStatus
 };
-//# sourceMappingURL=feature-flags.js.map

package/dist/src/core/config/storage-config.js

@@ -112,4 +112,3 @@ export {
   loadStorageConfig,
   saveStorageConfig
 };
-//# sourceMappingURL=storage-config.js.map

package/dist/src/core/config/types.js

@@ -141,4 +141,3 @@ export {
   DEFAULT_WEIGHTS,
   PRESET_PROFILES
 };
-//# sourceMappingURL=types.js.map

package/dist/src/core/context/auto-context.js

@@ -77,4 +77,3 @@ class AutoContext {
 export {
   AutoContext
 };
-//# sourceMappingURL=auto-context.js.map

package/dist/src/core/context/dual-stack-manager.js

@@ -867,4 +867,3 @@ class DualStackManager {
 export {
   DualStackManager
 };
-//# sourceMappingURL=dual-stack-manager.js.map

package/dist/src/core/context/enhanced-rehydration.js

@@ -91,7 +91,6 @@ class CompactionHandler {
       };
       this.frameManager.addAnchor(
         "CONSTRAINT",
-        // Using CONSTRAINT type for now
         JSON.stringify(anchor),
         10,
         {
@@ -991,4 +990,3 @@ export {
   CompactionHandler,
   EnhancedRehydrationManager
 };
-//# sourceMappingURL=enhanced-rehydration.js.map