|
1 | 1 | # StackMemory |
2 | 2 |
|
3 | | -**Lossless, project-scoped memory for AI tools** • v0.5.40 |
| 3 | +**Lossless, project-scoped memory for AI tools** • v0.5.47 |
4 | 4 |
|
5 | 5 | StackMemory is a **production-ready memory runtime** for AI coding tools that preserves full project context across sessions: |
6 | 6 |
|
@@ -30,7 +30,7 @@ StackMemory solves this by: |
30 | 30 |
|
31 | 31 | - Storing all events, tool calls, and decisions |
32 | 32 | - Smart retrieval of relevant context |
33 | | -- Call stack organization (10,000+ frame depth) |
| 33 | +- Call stack organization for nested context |
34 | 34 | - Configurable importance scoring |
35 | 35 | - Team collaboration through shared stacks |
36 | 36 |
|
@@ -92,25 +92,14 @@ The editor never manages memory directly; it asks StackMemory for the **context |
92 | 92 |
|
93 | 93 | ## Product Health Metrics |
94 | 94 |
|
95 | | -### Current Status (v0.5.30) |
| 95 | +### Current Status (v0.5.47) |
96 | 96 |
|
97 | 97 | | Metric | Current | Target | Status | |
98 | 98 | |--------|---------|--------|--------| |
99 | 99 | | **Test Coverage** | 85% | 90% | In Progress | |
100 | | -| **Performance (p50)** | TBD | <50ms | Pending | |
101 | | -| **Documentation** | 70% | 100% | In Progress | |
102 | | -| **Active Issues** | 5 high | 0 high | In Progress | |
103 | | -| **Code Quality** | 396 tests | 400+ | Done | |
104 | | -| **npm Downloads** | Growing | 1K+/week | On Track | |
105 | | - |
106 | | -### Quality Score: 78/100 |
107 | | - |
108 | | -**Formula:** (Test Coverage × 0.3) + (Performance × 0.3) + (Documentation × 0.2) + (Issues Resolution × 0.2) |
109 | | - |
110 | | -### Next Sprint Priorities |
111 | | - |
112 | | -1. **[STA-289] Performance Optimization** - Achieve SLA targets |
113 | | -2. **[STA-291] Code Cleanup** - Zero TODOs, 90% coverage |
| 100 | +| **Tests Passing** | 490 | 500+ | On Track | |
| 101 | +| **Documentation** | 80% | 100% | In Progress | |
| 102 | +| **Active Issues** | 3 high | 0 high | In Progress | |
114 | 103 |
|
115 | 104 | --- |
116 | 105 |
|
@@ -260,40 +249,33 @@ Available MCP tools in Claude Code: |
260 | 249 |
|
261 | 250 | ## 2. Open-Source Local Mode |
262 | 251 |
|
263 | | -### Step 1: Clone |
| 252 | +### Step 1: Clone & Build |
264 | 253 |
|
265 | 254 | ```bash |
266 | | -git clone https://github.com/stackmemory/stackmemory |
| 255 | +git clone https://github.com/stackmemoryai/stackmemory |
267 | 256 | cd stackmemory |
| 257 | +npm install |
| 258 | +npm run build |
268 | 259 | ``` |
269 | 260 |
|
270 | 261 | ### Step 2: Run local MCP server |
271 | 262 |
|
272 | 263 | ```bash |
273 | | -cargo run --bin stackmemory-mcp |
274 | | -# or |
275 | | -npm run dev |
276 | | -``` |
277 | | - |
278 | | -This creates: |
279 | | - |
280 | | -``` |
281 | | -.memory/ |
282 | | - └── memory.db # SQLite |
| 264 | +npm run mcp:start |
| 265 | +# or for development |
| 266 | +npm run mcp:dev |
283 | 267 | ``` |
284 | 268 |
|
285 | | -All project memory lives locally. |
286 | | - |
287 | | ---- |
| 269 | +This creates `.stackmemory/` with SQLite storage. |
288 | 270 |
|
289 | 271 | ### Step 3: Point your editor to local MCP |
290 | 272 |
|
291 | 273 | ```json |
292 | 274 | { |
293 | | - "tools": { |
| 275 | + "mcpServers": { |
294 | 276 | "stackmemory": { |
295 | | - "command": "stackmemory-mcp", |
296 | | - "args": ["--local"] |
| 277 | + "command": "node", |
| 278 | + "args": ["dist/integrations/mcp/server.js"] |
297 | 279 | } |
298 | 280 | } |
299 | 281 | } |
@@ -506,21 +488,26 @@ stackmemory mcp-server [--port 3001] |
506 | 488 | - Hosted: **Private beta** |
507 | 489 | - OSS mirror: **Production ready** |
508 | 490 | - MCP integration: **Stable** |
509 | | -- CLI: **v0.5.40** - Zero-config setup, diagnostics, full task/context/Linear management |
| 491 | +- CLI: **v0.5.47** - Zero-config setup, diagnostics, full task/context/Linear management |
510 | 492 | - Two-tier storage: **Complete** |
511 | 493 | - Test Suite: **490 tests passing** |
512 | 494 |
|
513 | 495 | --- |
514 | 496 |
|
515 | 497 | ## Changelog |
516 | 498 |
|
| 499 | +### v0.5.47 (2026-01-27) |
| 500 | +- **Graceful database failures**: Handles native module version mismatches |
| 501 | +- **Suppress dotenv logs**: Cleaner terminal output |
| 502 | +- **TTY preservation**: Fixes interactive mode for claude-sm/claude-smd |
| 503 | +- **Silent Linear auth**: No spam when API key not configured |
| 504 | + |
517 | 505 | ### v0.5.40 (2026-01-27) |
518 | 506 | - **Zero-config onboarding**: `stackmemory init` now works without any prompts |
519 | 507 | - **New `setup-mcp` command**: Auto-configures Claude Code MCP integration |
520 | 508 | - **New `doctor` command**: Diagnoses issues and suggests fixes |
521 | 509 | - **Interactive postinstall**: Asks for consent before modifying ~/.claude |
522 | 510 | - **Better error messages**: Shows reason + fix + next step |
523 | | -- 490 tests passing |
524 | 511 |
|
525 | 512 | ### v0.5.39 (2026-01-27) |
526 | 513 | - **AsyncMutex**: Thread-safe Linear sync with stale lock detection |
@@ -567,9 +554,8 @@ stackmemory mcp-server [--port 3001] |
567 | 554 | ## Roadmap |
568 | 555 |
|
569 | 556 | **Phase 4 (Completed):** Two-tier storage system with local tiers and infinite remote storage |
570 | | -**Phase 5 (Next):** PostgreSQL production adapter, enhanced team collaboration, advanced analytics |
571 | | -**Phase 3:** Team collaboration, shared stacks, frame handoff |
572 | | -**Phase 4:** Two-tier storage, enterprise features, cost optimization |
| 557 | +**Phase 5 (Current):** PostgreSQL production adapter, enhanced team collaboration, advanced analytics |
| 558 | +**Phase 6 (Next):** Enterprise features, multi-org support, cost optimization |
573 | 559 |
|
574 | 560 | --- |
575 | 561 |
|
|
0 commit comments