@stackmemoryai/stackmemory 1.10.5 → 1.14.0

package/LICENSE

@@ -1,64 +1,131 @@
-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.
+PolyForm Noncommercial License 1.0.0
+
+https://polyformproject.org/licenses/noncommercial/1.0.0
+
+Acceptance
+
+In order to get any license under these terms, you must agree
+to them as both strict obligations and conditions to all
+your licenses.
+
+Copyright License
+
+The licensor grants you a copyright license for the
+software to do everything you might do with the software
+that would otherwise infringe the licensor's copyright
+in it for any permitted purpose. However, you may
+only distribute the software according to Distribution
+License and make changes or new works
+based on the software according to Changes and New Works
+License.
+
+Distribution License
+
+The licensor grants you an additional copyright license
+to distribute copies of the software. Your license
+to distribute covers distributing the software with
+changes and new works permitted by Changes and New Works
+License.
+
+Notices
+
+You must ensure that anyone who gets a copy of any part of
+the software from you also gets a copy of these terms or the
+URL for them above, as well as copies of any plain-text lines
+beginning with `Required Notice:` that the licensor provided
+with the software. For example:
+
+> Required Notice: Copyright StackMemory AI (https://stackmemory.ai)
+
+Changes and New Works License
+
+The licensor grants you an additional copyright license to
+make changes and new works based on the software for any
+permitted purpose.
+
+Patent License
+
+The licensor grants you a patent license for the software that
+covers patent claims the licensor can license, or becomes able
+to license, that you would infringe by using the software.
+
+Noncommercial Purposes
+
+Any noncommercial purpose is a permitted purpose.
+
+Personal Uses
+
+Personal use for research, experiment, and testing for
+the benefit of public knowledge, personal study, private
+entertainment, hobby projects, amateur pursuits, or religious
+observance, without any anticipated commercial application,
+is use for a permitted purpose.
+
+Noncommercial Organizations
+
+Use by any charitable organization, educational institution,
+public research organization, public safety or health
+organization, environmental protection organization,
+or government institution is use for a permitted purpose
+regardless of the source of funding or obligations resulting
+from the funding.
+
+Fair Use
+
+You may have "fair use" rights for the software under the
+law. These terms do not limit them.
+
+No Other Rights
+
+These terms do not allow you to sublicense or transfer any of
+your licenses to anyone else, or prevent the licensor from
+granting licenses to anyone else. These terms do not imply
+any other licenses.
+
+Patent Defense
+
+If you make any written claim that the software infringes or
+contributes to infringement of any patent, your patent license
+for the software granted under these terms ends immediately. If
+your company makes such a claim, your patent license ends
+immediately for work on behalf of your company.
+
+Violations
+
+The first time you are notified in writing that you have
+violated any of these terms, or done anything with the software
+not covered by your licenses, your licenses can nonetheless
+continue if you come into full compliance with these terms,
+and take practical steps to correct past violations, within
+32 days of receiving notice. Otherwise, all your licenses
+end immediately.
+
+No Liability
+
+As far as the law allows, the software comes as is, without
+any warranty or condition, and the licensor will not be liable
+to you for any damages arising out of these terms or the use
+or nature of the software, under any kind of legal claim.
+
+Definitions
+
+The licensor is the individual or entity offering these
+terms, and the software is the software the licensor makes
+available under these terms.
+
+You refers to the individual or entity agreeing to these
+terms.
+
+Your company is any legal entity, sole proprietorship,
+or other kind of organization that you work for, plus all
+organizations that have control over, are under the control of,
+or are under common control with that organization. Control
+means ownership of substantially all the assets of an entity,
+or the power to direct its management and policies by vote,
+contract, or otherwise. Control can be direct or indirect.
+
+Your licenses are all the licenses granted to you for the
+software under these terms.
+
+Use means anything you do with the software requiring one
+of your licenses.

package/README.md

@@ -14,7 +14,7 @@ Lossless, project-scoped memory for AI coding tools. **[Website](https://stackme
 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
-- **56 MCP tools** for Claude Code integration (context, tasks, Linear, traces, discovery, cord, team, planning, providers, and more)
+- **73 MCP tools** for Claude Code integration (context, tasks, Linear, traces, discovery, cord, team, planning, providers, and more)
 - **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
@@ -97,6 +97,16 @@ stackmemory doctor
 
 Restart Claude Code and StackMemory MCP tools will be available.
 
+### Also available as `croissant-ai`
+
+[croissant.ai](https://croissant.ai) wraps StackMemory as a business-facing CLI for executive intelligence. Install via `npx croissant-ai` — all unknown commands forward to StackMemory automatically.
+
+```bash
+npx croissant-ai ask "What's our MRR?"   # croissant.ai query API
+npx croissant-ai memory capture           # → stackmemory capture
+npx croissant-ai init                     # → stackmemory init (fallback)
+```
+
 ### Wrapper Scripts
 
 StackMemory ships wrapper scripts that launch your coding tool with StackMemory context pre-loaded:
@@ -132,6 +142,44 @@ Runs as an MCP server. Editors (e.g., Claude Code) call StackMemory on each inte
 
 ---
 
+## Command Packs
+
+StackMemory ships installable command packs for Claude Code — curated slash commands that integrate session lifecycle management directly into your workflow.
+
+### Core Pack
+
+The **core** pack provides session lifecycle commands that use StackMemory for context persistence:
+
+| Command | Description |
+|---------|-------------|
+| `/start` | Boot a session — load memory, restore handoff, show git state, suggest next work |
+| `/stop` | End a session — summarize, capture handoff, review learnings |
+| `/restart` | Chain `/stop` → `/clear` → `/start` in one command |
+| `/next` | Suggest what to work on based on context |
+
+Internal dependencies (installed automatically): `/summary`, `/capture`, `/learn`, `/restore`
+
+```bash
+# Install core commands
+stackmemory setup-commands
+
+# List available packs
+stackmemory setup-commands --list
+
+# Preview what would be installed
+stackmemory setup-commands --dry-run
+
+# Reinstall (overwrite existing)
+stackmemory setup-commands --force
+
+# Remove installed commands
+stackmemory setup-commands --uninstall
+```
+
+Commands are symlinked to `~/.claude/commands/` and available immediately in Claude Code.
+
+---
+
 ## Skills System
 
 StackMemory ships Claude Code skills that integrate directly into your workflow. Skills are invoked via `/skill-name` in Claude Code or `stackmemory skills <name>` from the CLI.
@@ -272,34 +320,54 @@ claude-sm
 
 ---
 
-## RLM (Recursive Language Model) Orchestration
+## RLM-Aware Harness
+
+StackMemory includes an RLM (Recursive Language Model) system inspired by [predict-rlm](https://github.com/Trampoline-AI/predict-rlm) — three layers that make agents self-harnessing:
+
+### Layer 1: Context-as-REPL
+
+Agents access tenant data programmatically via tool functions instead of prose handoffs:
+
+- `search_knowledge(query, topK)` — vector search over tenant data
+- `read_context(query)` — knowledge graph entity/relationship queries
+- `list_runs(threadId)` — prior run history with status summaries
+- `get_run_events(runId)` — event stream replay for a specific run
+- `query_interrupts(threadId)` — pending approvals and blocks
+- `llm_summarize(prompt)` — sub-LLM (Haiku) for quick synthesis
+
+### Layer 2: Typed Dispatch
+
+Signature-based sub-agent spawning with validated I/O contracts:
+
+| Signature | Persona | Inputs | Outputs |
+|-----------|---------|--------|---------|
+| `ImplementFeature` | eng | spec, context_files | branch, changed_files, test_passed |
+| `FixBug` | eng | description, error_log | branch, changed_files, root_cause |
+| `ReviewPR` | eng | pr_url, focus_areas | verdict, comments, risk_level |
+| `Investigate` | data | question, data_sources | findings, evidence, confidence |
+| `Summarize` | data | content, format | summary, key_points |
+
+Parent runs dispatch typed sub-runs via `dispatchSubRun()` and collect validated results via `collectSubRun()` with timeout handling.
+
+### Layer 3: Critic + Self-Decomposition
 
-StackMemory includes an RLM system that handles complex tasks through recursive decomposition and parallel execution using Claude Code's Task tool.
+LLM quality gate that evaluates run output (ported from predict-rlm's critic pattern):
 
-### Key Features
+- **Score >= 80**: Pass — run ships as-is
+- **Score 50-79**: Revise — creates a new run with critic feedback appended
+- **Score < 50**: Decompose — dispatches typed sub-runs to break down the task
 
-- **Recursive Task Decomposition**: Breaks complex tasks into manageable subtasks
-- **Parallel Subagent Execution**: Run multiple specialized agents concurrently
-- **8 Specialized Agent Types**: Planning, Code, Testing, Linting, Review, Improve, Context, Publish
-- **Multi-Stage Review**: Iterative improvement cycles with quality scoring (0-1 scale)
-- **Automatic Test Generation**: Unit, integration, and E2E test creation
+Loop control: max 3 revisions, max depth 2 for decomposition.
 
-### Usage
+### Legacy RLM Orchestrator
+
+The original RLM system remains available for direct use:
 
 ```bash
-# Basic usage
 stackmemory skills rlm "Your complex task description"
-
-# With options
-stackmemory skills rlm "Refactor authentication system" \
-  --max-parallel 8 \
-  --review-stages 5 \
-  --quality-threshold 0.9 \
-  --test-mode all
+stackmemory skills rlm "Refactor auth" --max-parallel 8 --quality-threshold 0.9
 ```
 
-### Configuration Options
-
 | Option | Description | Default |
 |--------|-------------|---------|
 | `--max-parallel` | Maximum concurrent subagents | 5 |
@@ -307,7 +375,6 @@ stackmemory skills rlm "Refactor authentication system" \
 | `--review-stages` | Number of review iterations | 3 |
 | `--quality-threshold` | Target quality score (0-1) | 0.85 |
 | `--test-mode` | Test generation mode (unit/integration/e2e/all) | all |
-| `--verbose` | Show all recursive operations | false |
 
 **Note**: RLM requires Claude Code Max plan for unlimited subagent execution.
 
@@ -417,18 +484,34 @@ Options: `--until`, `--until-not`, `--until-empty`, `--until-non-empty`, `--unti
 ## Documentation
 
 - [Getting Started](./docs/GETTING_STARTED.md) — Quick start guide (5 minutes)
-- [MCP Tools Reference](https://stackmemoryai.github.io/stackmemory/tools.html) — All 56 MCP tools
+- [MCP Tools Reference](https://stackmemoryai.github.io/stackmemory/tools.html) — All 73 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
 - [Architecture](./docs/architecture.md) — System design
 - [API Reference](./docs/API_REFERENCE.md) — API documentation
-- [Vision](./vision.md) — Product vision and principles
+- [Vision](./docs/vision.md) — Product vision and principles
 - [Status](./docs/status.md) — Current project status
 - [Roadmap](./docs/roadmap.md) — Future plans
 
 ---
 
+## Substrate: The Three-Layer Vision
+
+StackMemory is the foundation of a three-layer architecture for AI-native development:
+
+| Layer | Product | Status | Purpose |
+|-------|---------|--------|---------|
+| **L1** | StackMemory | Shipped (v1.10.6) | Context persistence — lossless memory across sessions |
+| **L2** | Substrate Desktop | Shipping | Agent orchestration — multi-agent coordination with worktree isolation |
+| **L3** | Substrate Cloud | Design | Multiplayer development — shared context across teams and agents |
+
+Grounded in distributed systems theory: FLP impossibility, Byzantine→Crash conversion via test hooks, Chandra-Toueg failure detectors for agent liveness. See [COORDINATION_THEORY.md](./docs/architecture/COORDINATION_THEORY.md).
+
+---
+
 ## License
 
-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.
+Licensed under the [PolyForm Noncommercial License 1.0.0](./LICENSE).
+
+Free for personal, research, educational, and noncommercial use. Commercial use requires a separate license from StackMemory AI.

package/bin/claude-sm

@@ -3,4 +3,19 @@
  * Claude-SM CLI Launcher (ESM)
  * Delegates to built CLI in dist without requiring tsx.
  */
-import('../dist/src/cli/claude-sm.js');
+import { existsSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const target = join(__dirname, '../dist/src/cli/claude-sm.js');
+
+if (!existsSync(target)) {
+  console.error('Error: StackMemory has not been built.');
+  console.error(`Missing: ${target}`);
+  console.error('Run: npm install && npm run build');
+  process.exit(1);
+}
+
+import(target);

package/bin/claude-smd

@@ -3,4 +3,19 @@
  * Claude-SM-Danger CLI Launcher (ESM)
  * Delegates to built CLI in dist without requiring tsx.
  */
-import('../dist/src/cli/claude-sm-danger.js');
+import { existsSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const target = join(__dirname, '../dist/src/cli/claude-sm-danger.js');
+
+if (!existsSync(target)) {
+  console.error('Error: StackMemory has not been built.');
+  console.error(`Missing: ${target}`);
+  console.error('Run: npm install && npm run build');
+  process.exit(1);
+}
+
+import(target);

package/bin/codex-smd

@@ -3,4 +3,19 @@
  * Codex-SM-Danger CLI Launcher (ESM)
  * Delegates to built CLI in dist without requiring tsx.
  */
-import('../dist/src/cli/codex-sm-danger.js');
+import { existsSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const target = join(__dirname, '../dist/src/cli/codex-sm-danger.js');
+
+if (!existsSync(target)) {
+  console.error('Error: StackMemory has not been built.');
+  console.error(`Missing: ${target}`);
+  console.error('Run: npm install && npm run build');
+  process.exit(1);
+}
+
+import(target);

package/bin/gemini-sm

@@ -3,4 +3,19 @@
  * Gemini-SM CLI Launcher (ESM)
  * Delegates to built CLI in dist without requiring tsx.
  */
-import('../dist/src/cli/gemini-sm.js');
+import { existsSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const target = join(__dirname, '../dist/src/cli/gemini-sm.js');
+
+if (!existsSync(target)) {
+  console.error('Error: StackMemory has not been built.');
+  console.error(`Missing: ${target}`);
+  console.error('Run: npm install && npm run build');
+  process.exit(1);
+}
+
+import(target);

package/bin/hermes-sm

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+/**
+ * Hermes-SM CLI Launcher (ESM)
+ * Delegates to built CLI in dist without requiring tsx.
+ */
+import { existsSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const target = join(__dirname, '../dist/src/cli/hermes-sm.js');
+
+if (!existsSync(target)) {
+  console.error('Error: StackMemory has not been built.');
+  console.error(`Missing: ${target}`);
+  console.error('Run: npm install && npm run build');
+  process.exit(1);
+}
+
+import(target);

package/bin/hermes-smd

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+/**
+ * Hermes-SM-Danger CLI Launcher (ESM) — danger mode
+ * Delegates to built CLI in dist without requiring tsx.
+ */
+import { existsSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const target = join(__dirname, '../dist/src/cli/hermes-sm.js');
+
+if (!existsSync(target)) {
+  console.error('Error: StackMemory has not been built.');
+  console.error(`Missing: ${target}`);
+  console.error('Run: npm install && npm run build');
+  process.exit(1);
+}
+
+import(target);

package/bin/opencode-sm

@@ -3,4 +3,19 @@
  * OpenCode-SM CLI Launcher (ESM)
  * Delegates to built CLI in dist without requiring tsx.
  */
-import('../dist/src/cli/opencode-sm.js');
+import { existsSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const target = join(__dirname, '../dist/src/cli/opencode-sm.js');
+
+if (!existsSync(target)) {
+  console.error('Error: StackMemory has not been built.');
+  console.error(`Missing: ${target}`);
+  console.error('Run: npm install && npm run build');
+  process.exit(1);
+}
+
+import(target);