Skip to content

Commit 0ad84da

Browse files
docs: update README to v0.5.47
- Update version references - Add v0.5.47 changelog - Fix roadmap duplicates - Fix open-source section (Node.js, not Rust) - Remove unverifiable claims
1 parent 76cb076 commit 0ad84da

1 file changed

Lines changed: 26 additions & 40 deletions

File tree

README.md

Lines changed: 26 additions & 40 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# StackMemory
22

3-
**Lossless, project-scoped memory for AI tools** • v0.5.40
3+
**Lossless, project-scoped memory for AI tools** • v0.5.47
44

55
StackMemory is a **production-ready memory runtime** for AI coding tools that preserves full project context across sessions:
66

@@ -30,7 +30,7 @@ StackMemory solves this by:
3030

3131
- Storing all events, tool calls, and decisions
3232
- Smart retrieval of relevant context
33-
- Call stack organization (10,000+ frame depth)
33+
- Call stack organization for nested context
3434
- Configurable importance scoring
3535
- Team collaboration through shared stacks
3636

@@ -92,25 +92,14 @@ The editor never manages memory directly; it asks StackMemory for the **context
9292

9393
## Product Health Metrics
9494

95-
### Current Status (v0.5.30)
95+
### Current Status (v0.5.47)
9696

9797
| Metric | Current | Target | Status |
9898
|--------|---------|--------|--------|
9999
| **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 |
114103

115104
---
116105

@@ -260,40 +249,33 @@ Available MCP tools in Claude Code:
260249

261250
## 2. Open-Source Local Mode
262251

263-
### Step 1: Clone
252+
### Step 1: Clone & Build
264253

265254
```bash
266-
git clone https://github.com/stackmemory/stackmemory
255+
git clone https://github.com/stackmemoryai/stackmemory
267256
cd stackmemory
257+
npm install
258+
npm run build
268259
```
269260

270261
### Step 2: Run local MCP server
271262

272263
```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
283267
```
284268

285-
All project memory lives locally.
286-
287-
---
269+
This creates `.stackmemory/` with SQLite storage.
288270

289271
### Step 3: Point your editor to local MCP
290272

291273
```json
292274
{
293-
"tools": {
275+
"mcpServers": {
294276
"stackmemory": {
295-
"command": "stackmemory-mcp",
296-
"args": ["--local"]
277+
"command": "node",
278+
"args": ["dist/integrations/mcp/server.js"]
297279
}
298280
}
299281
}
@@ -506,21 +488,26 @@ stackmemory mcp-server [--port 3001]
506488
- Hosted: **Private beta**
507489
- OSS mirror: **Production ready**
508490
- 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
510492
- Two-tier storage: **Complete**
511493
- Test Suite: **490 tests passing**
512494

513495
---
514496

515497
## Changelog
516498

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+
517505
### v0.5.40 (2026-01-27)
518506
- **Zero-config onboarding**: `stackmemory init` now works without any prompts
519507
- **New `setup-mcp` command**: Auto-configures Claude Code MCP integration
520508
- **New `doctor` command**: Diagnoses issues and suggests fixes
521509
- **Interactive postinstall**: Asks for consent before modifying ~/.claude
522510
- **Better error messages**: Shows reason + fix + next step
523-
- 490 tests passing
524511

525512
### v0.5.39 (2026-01-27)
526513
- **AsyncMutex**: Thread-safe Linear sync with stale lock detection
@@ -567,9 +554,8 @@ stackmemory mcp-server [--port 3001]
567554
## Roadmap
568555

569556
**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
573559

574560
---
575561

0 commit comments

Comments
 (0)