@stackmemoryai/stackmemory 0.8.0 → 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

@@ -16,7 +16,8 @@ StackMemory is a **production-ready memory runtime** for AI coding tools that pr
 - **Hierarchical frame organization** (nested call stack model)
 - **Skills system** with `/spec` and `/linear-run` for Claude Code
 - **Automatic hooks** for task tracking, Linear sync, and spec progress
-- **498 tests passing** with comprehensive coverage
+- **Memory monitor daemon** with automatic capture/clear on RAM pressure
+- **650+ tests passing** with comprehensive coverage
 
 Instead of a linear chat log, StackMemory organizes memory as a **call stack** of scoped work (frames), with intelligent LLM-driven retrieval and team collaboration features.
 
@@ -24,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.
@@ -42,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
 
 ---
 
@@ -241,6 +255,43 @@ When a task completes (via hook or `/linear-run`), StackMemory fuzzy-matches the
 
 ---
 
+## Memory Monitor Daemon (v0.8.0)
+
+Automatically monitors system RAM and Node.js heap usage, triggering capture/clear cycles when memory pressure exceeds thresholds. Prevents long-running sessions from degrading performance.
+
+### How it works
+
+1. Daemon checks RAM and heap usage every 30 seconds
+2. If either exceeds 90%, it captures context (`stackmemory capture --no-commit --basic`)
+3. Clears context (`stackmemory clear --save`)
+4. Writes a signal file (`.stackmemory/.memory-clear-signal`)
+5. On next prompt, a Claude Code hook reads the signal and alerts you to run `/clear`
+
+### Configuration
+
+Configured via `stackmemory daemon` with these defaults:
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `ramThreshold` | 0.9 (90%) | System RAM usage trigger |
+| `heapThreshold` | 0.9 (90%) | Node.js heap usage trigger |
+| `cooldownMinutes` | 10 | Minimum time between triggers |
+| `interval` | 0.5 (30s) | Check frequency in minutes |
+
+### CLI
+
+```bash
+stackmemory daemon start      # Start daemon (includes memory monitor)
+stackmemory daemon status      # Show memory stats, trigger count, thresholds
+stackmemory daemon stop        # Stop daemon
+```
+
+### Hook
+
+The memory guard hook (`.claude/hooks/memory-guard.sh`) is registered as a `user-prompt-submit` hook. When the daemon writes a signal file, the hook alerts you on the next prompt to run `/clear` and restore.
+
+---
+
 ## Prompt Forge (GEPA)
 
 When launching via `claude-sm`, StackMemory watches `CLAUDE.md`, `AGENT.md`, and `AGENTS.md` for changes. On file modification, the GEPA optimizer analyzes content and suggests improvements for prompt clarity and structure. Runs as a detached background process.
@@ -495,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