musememory 1.6.0 โ 1.6.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +93 -273
- package/dist/index.js +762 -587
- package/package.json +2 -1
- package/schema.json +60 -0
package/README.md
CHANGED
|
@@ -4,10 +4,9 @@
|
|
|
4
4
|
|
|
5
5
|
|
|
6
6
|
|
|
7
|
-
|
|
8
8
|
|
|
9
|
-
|
|
9
|
+
|
|
11
10
|
|
|
12
11
|
|
|
13
12
|
**Autonomous, Self-Organizing Cognitive Memory System for AI Agents & Agency Networks**
|
|
@@ -208,7 +207,7 @@ memory migrate --provider mem0
|
|
|
208
207
|
memory migrate --provider beads
|
|
209
208
|
memory migrate --all
|
|
210
209
|
```
|
|
211
|
-
> See [`musememory-comparison.html`](
|
|
210
|
+
> See [`musememory-comparison.html`](musememory-comparison.html) for the full table-free 30-system architectural dossier.
|
|
212
211
|
|
|
213
212
|
---
|
|
214
213
|
|
|
@@ -232,169 +231,101 @@ Navigate to `http://localhost:2222` to access:
|
|
|
232
231
|
|
|
233
232
|
---
|
|
234
233
|
|
|
235
|
-
|
|
236
|
-
## ๐ป Complete CLI Command Reference
|
|
237
|
-
||||||| f9a7a44
|
|
238
|
-
## โก How Memory Grows, Reloads & Auto-Archives
|
|
239
|
-
|
|
240
|
-
```mermaid
|
|
241
|
-
flowchart TD
|
|
242
|
-
subgraph HotPath["Active Conversation (Hot Path)"]
|
|
243
|
-
User["User asks question / gives task"]
|
|
244
|
-
Agent["AI Agent executes turn"]
|
|
245
|
-
Recall["1. Auto-Retrieve Top-K Context & Active Constraints"]
|
|
246
|
-
Distill["2. Auto-Distill Fixes & Decisions (Harvest)"]
|
|
247
|
-
end
|
|
248
|
-
|
|
249
|
-
subgraph DefenseGate["Self-Contained Vibeguard"]
|
|
250
|
-
Scan["3. Zero-Leakage Secret Scan (Blocks API keys & DB URLs)"]
|
|
251
|
-
end
|
|
252
|
-
|
|
253
|
-
subgraph StoreLifecycle["Self-Organizing Knowledge Engine (.memory/)"]
|
|
254
|
-
Atomic["4. Atomic Write (m_timestamp_slug.yaml)"]
|
|
255
|
-
Lifecycle["5. Lifecycle Transitions (Candidate โ Confirmed โ Superseded)"]
|
|
256
|
-
Decay["6. Temporal Staleness Decay & Auto-Archiving"]
|
|
257
|
-
end
|
|
258
|
-
|
|
259
|
-
User --> Agent
|
|
260
|
-
Agent --> Recall
|
|
261
|
-
Recall --> Agent
|
|
262
|
-
Agent --> Distill
|
|
263
|
-
Distill --> Scan
|
|
264
|
-
Scan --> Atomic
|
|
265
|
-
Atomic --> Lifecycle
|
|
266
|
-
Lifecycle --> Decay
|
|
267
|
-
```
|
|
268
|
-
|
|
269
|
-
- **Incremental Auto-Growing**: Every decision, bug fix, operational rule, and session checkpoint is saved as a discrete, human-readable YAML document in `.memory/memories/`.
|
|
270
|
-
- **Context Reload Continuity**: On a fresh turn or session restart, `get_context` feeds only the Top-$K$ highest-salience, verified knowledge unitsโreducing context tokens by **85โ95%** and eliminating outdated hallucinations.
|
|
271
|
-
- **Smart Archiving & Controlled Forgetting**: Old approaches are marked `superseded` with explicit forward/backward links. Time-based staleness policies (e.g. 30 days for temporary discoveries, 90 days for fixes, 365 days for architecture) automatically down-weight decaying knowledge.
|
|
272
|
-
|
|
273
|
-
---
|
|
234
|
+
## ๐ Deep Technical References & Documentation
|
|
274
235
|
|
|
275
|
-
|
|
236
|
+
<details>
|
|
237
|
+
<summary><b>๐ Complete MCP Tool Reference (28 Tools)</b> โ <i>Click to expand</i></summary>
|
|
276
238
|
|
|
277
|
-
|
|
278
|
-
|
|
279
|
-
### ๐ญ 5 Zero-Fingerprint Role Archetypes
|
|
280
|
-
|
|
281
|
-
When running `memory install`, an interactive setup wizard configures your primary archetype (or choose one manually anytime):
|
|
282
|
-
|
|
283
|
-
1. **`developer`** (Default): Code-first, direct, concise, runnable diffs, strict types, fail-fast mechanics.
|
|
284
|
-
2. **`designer`**: Visual hierarchy, CSS/Tailwind systems, GSAP animations, WCAG accessibility, Figma/tokens design tokens.
|
|
285
|
-
3. **`marketer`**: Conversion-rate optimization (CRO), punchy benefit-driven copy, SEO clustering, audience hooks.
|
|
286
|
-
4. **`casual`**: Plain English, jargon-free explanations, step-by-step guidance.
|
|
287
|
-
5. **`custom`**: Clean blank template ready for personalized instructions.
|
|
288
|
-
|
|
289
|
-
```bash
|
|
290
|
-
# View active profile
|
|
291
|
-
memory user get
|
|
292
|
-
|
|
293
|
-
# Initialize with a specific archetype
|
|
294
|
-
memory user init developer
|
|
295
|
-
memory user init designer --global
|
|
296
|
-
|
|
297
|
-
# Update user profile
|
|
298
|
-
memory user set "- Prefers TypeScript, Bun, and ultra terse responses"
|
|
299
|
-
```
|
|
300
|
-
|
|
301
|
-
### ๐ง Prompt Injection Hierarchy & Proactive Self-Nudge
|
|
302
|
-
When `get_context` or `formatPromptContext()` builds the LLM prompt context, it structures information deterministically:
|
|
303
|
-
1. **`### User Profile & Preferences (USER.md)`** (Tone, role, rules)
|
|
304
|
-
2. **`### Active Working Constraints (CURRENT.md)`** (Project invariants & open loops)
|
|
305
|
-
3. **`### Relevant Memories & Learned Patterns`** (Top-$K$ ranked memories)
|
|
306
|
-
4. **`*Memory Directive: When learning durable facts, bug resolutions, or user preferences, call memory_capture immediately.*`**
|
|
239
|
+
When registered as an MCP server, `musememory` exposes the following native tools:
|
|
307
240
|
|
|
308
|
-
|
|
241
|
+
| MCP Tool | Execution Phase | Description |
|
|
242
|
+
| :--- | :--- | :--- |
|
|
243
|
+
| `get_context` | **Session Start** | Fetches Top-$K$ ranked memories, `USER.md` profile, and active `CURRENT.md` constraints. |
|
|
244
|
+
| `search` | **Investigation** | Searches memory units with query, token budget, project, type, and verification filters. |
|
|
245
|
+
| `memory_current` | **Constraints** | Reads or appends active project working constraints (`CURRENT.md`). |
|
|
246
|
+
| `memory_get_user_profile` | **Context Loading** | Reads active `USER.md` persona and communication preferences. |
|
|
247
|
+
| `memory_set_user_profile` | **Preferences** | Updates `USER.md` profile with inline secret defense. |
|
|
248
|
+
| `memory_capture` | **During Fixes** | Saves a memory entry with inline Vibeguard secret inspection. |
|
|
249
|
+
| `memory_confirm` | **Decision Approval** | Promotes candidate insight to confirmed status. |
|
|
250
|
+
| `memory_supersede` | **Refactoring** | Marks outdated knowledge superseded by a confirmed replacement. |
|
|
251
|
+
| `memory_link` | **Graph Building** | Connects related memories bidirectionally. |
|
|
252
|
+
| `memory_mark_stale` | **Deprecation** | Flags decaying knowledge with deprecation rationale. |
|
|
253
|
+
| `memory_reject` | **Hypothesis Refutation** | Marks invalidated hypotheses as rejected. |
|
|
254
|
+
| `memory_delete` | **Purge** | Permanently deletes an entry and records audit ledger log. |
|
|
255
|
+
| `memory_tree_search` | **Tree Retrieval** | Hierarchical reasoning search across partitioned memory shards. |
|
|
256
|
+
| `memory_wiki_compile` | **Wiki Compiler** | Compiles confirmed memories into Obsidian-compatible Markdown pages. |
|
|
257
|
+
| `memory_wiki_search` / `get` | **Wiki Reading** | Searches and reads compiled concept and entity wiki pages. |
|
|
258
|
+
| `memory_entities_search` / `get` | **Entity Graph** | Searches extracted entities and inspects co-occurrence strengths. |
|
|
259
|
+
| `memory_pageindex_index` | **Doc Indexing** | Builds a hierarchical reasoning tree from document content. |
|
|
260
|
+
| `memory_pageindex_search` | **Doc Search** | Searches PageIndex document tree with reasoning explanations. |
|
|
261
|
+
| `memory_pageindex_import` | **Doc Knowledge** | Imports PageIndex search insights directly into memory units. |
|
|
262
|
+
| `memory_search_transcripts` | **History Search** | Full-text search over past `.jsonl` transcripts with dialogue context windows. |
|
|
263
|
+
| `memory_harvest` | **Session End** | Distills conversation turns into structured fix/outcome units. |
|
|
264
|
+
| `memory_import_transcript` | **Transcript Sync** | Ingests `.jsonl` transcript and auto-binds memories to session nodes. |
|
|
265
|
+
| `memory_audit` | **Governance** | Queries the append-only operational audit ledger. |
|
|
266
|
+
| `memory_detect_agents` | **Onboarding** | Scans workstation for 80+ coding agent installations. |
|
|
267
|
+
| `memory_connect` | **Setup** | Auto-wires MCP server into detected installed agents with zero permissions. |
|
|
268
|
+
| `memory_detect_providers` | **Migration** | Scans machine for 29 external memory formats. |
|
|
269
|
+
| `memory_migrate` | **Migration** | Ingests external memories with state preservation and secret scrubbing. |
|
|
270
|
+
| `memory_export` / `import` | **Team Sharing** | Exports and imports portable JSON memory snapshots. |
|
|
271
|
+
| `memory_validate` | **Integrity Check** | Verifies database integrity and scans for credential leaks. |
|
|
272
|
+
| `memory_settings_get` / `set` | **Configuration** | Reads and updates unified global or project configuration settings. |
|
|
273
|
+
| `graph_status` | **AST Graph** | Inspects CodeGraph symbol overlap provider status. |
|
|
309
274
|
|
|
310
|
-
|
|
275
|
+
</details>
|
|
311
276
|
|
|
312
|
-
|
|
277
|
+
<details>
|
|
278
|
+
<summary><b>๐ป Full CLI Command Matrix (35 Commands)</b> โ <i>Click to expand</i></summary>
|
|
313
279
|
|
|
314
280
|
```bash
|
|
315
|
-
|
|
316
|
-
memory search-transcript "database connection pooling" session.jsonl --window 2 --max 5
|
|
281
|
+
memory <command> [arguments] [flags] # alias: musememory
|
|
317
282
|
```
|
|
318
283
|
|
|
319
|
-
|
|
320
|
-
|
|
321
|
-
## ๐ก๏ธ Built-In Vibeguard Secret Defense (Zero External Dependencies)
|
|
322
|
-
|
|
323
|
-
`musememory` includes a pure TypeScript, zero-dependency security scanner that protects your repositories:
|
|
324
|
-
|
|
325
|
-
- **Zero-Leakage Guarantee**: Intercepts OpenAI/Anthropic keys (`sk-*`), GitHub tokens (`ghp_*`), NPM tokens, AWS access keys (`AKIA*`), private key blocks, database connection strings, and plaintext credentials before they can ever be written to disk.
|
|
326
|
-
- **100% Standalone**: Does not require any external scripts or system installations.
|
|
327
|
-
|
|
328
|
-
---
|
|
329
|
-
|
|
330
|
-
## ๐ฎ Scope of Work & Roadmap
|
|
331
|
-
|
|
332
|
-
Every Scope-of-Work item is tracked as a GitHub issue and delivered via pull request. Status: โ planned ยท โ in progress ยท โ
done. Live status: [issue tracker](https://github.com/harshsinghmp/musememory/issues).
|
|
333
|
-
|
|
334
|
-
| Status | Item | Tracker |
|
|
284
|
+
| Command | Arguments / Flags | Description |
|
|
335
285
|
| :--- | :--- | :--- |
|
|
336
|
-
|
|
|
337
|
-
|
|
|
338
|
-
|
|
|
339
|
-
|
|
|
340
|
-
|
|
|
341
|
-
|
|
|
342
|
-
|
|
|
343
|
-
|
|
|
344
|
-
|
|
|
345
|
-
|
|
|
346
|
-
|
|
|
347
|
-
|
|
|
348
|
-
|
|
|
349
|
-
|
|
|
350
|
-
|
|
|
351
|
-
|
|
|
352
|
-
|
|
|
353
|
-
|
|
|
354
|
-
|
|
355
|
-
|
|
356
|
-
|
|
357
|
-
|
|
358
|
-
|
|
359
|
-
|
|
360
|
-
|
|
361
|
-
|
|
362
|
-
|
|
363
|
-
|
|
364
|
-
|
|
365
|
-
|
|
366
|
-
|
|
367
|
-
|
|
368
|
-
|
|
369
|
-
|
|
370
|
-
|
|
371
|
-
|
|
372
|
-
Decay["6. Temporal Staleness Decay & Auto-Archiving"]
|
|
373
|
-
end
|
|
374
|
-
|
|
375
|
-
User --> Agent
|
|
376
|
-
Agent --> Recall
|
|
377
|
-
Recall --> Agent
|
|
378
|
-
Agent --> Distill
|
|
379
|
-
Distill --> Scan
|
|
380
|
-
Scan --> Atomic
|
|
381
|
-
Atomic --> Lifecycle
|
|
382
|
-
Lifecycle --> Decay
|
|
383
|
-
```
|
|
384
|
-
|
|
385
|
-
- **Incremental Auto-Growing**: Every decision, bug fix, operational rule, and session checkpoint is saved as a discrete, human-readable YAML document in `.memory/memories/`.
|
|
386
|
-
- **Context Reload Continuity**: On a fresh turn or session restart, `get_context` feeds only the Top-$K$ highest-salience, verified knowledge unitsโreducing context tokens by **85โ95%** and eliminating outdated hallucinations.
|
|
387
|
-
- **Smart Archiving & Controlled Forgetting**: Old approaches are marked `superseded` with explicit forward/backward links. Time-based staleness policies (e.g. 30 days for temporary discoveries, 90 days for fixes, 365 days for architecture) automatically down-weight decaying knowledge.
|
|
388
|
-
|
|
389
|
-
---
|
|
390
|
-
|
|
391
|
-
## ๐ค User Persona & Preferences (`USER.md`) & Setup Wizard
|
|
286
|
+
| `install` | `[path] [--global]` | **One-line complete setup**: initializes `.memory/`, `USER.md`, and auto-wires coding agents. |
|
|
287
|
+
| `doctor` | `[path] [--global]` | **System diagnostic**: checks SQLite primary, schemas, secrets, and MCP connections. |
|
|
288
|
+
| `uninstall` | `[agent] [--purge] [--dry-run]` | **Clean uninstaller**: unwires MCP configs (and optionally purges `.memory/`). |
|
|
289
|
+
| `init` | `[path] [--legacy] [--global]` | Initialize `.memory/` directory and SQLite database. |
|
|
290
|
+
| `user` | `[get\|init\|set] [args] [--global]` | Manage `USER.md` persona & preferences across 5 clean archetypes. |
|
|
291
|
+
| `connect` | `[agent] [--all] [--force] [--dry-run]` | Auto-wire MCP into detected installed agents with zero permissions. |
|
|
292
|
+
| `agents` | *(none)* | Scan workstation for 80+ coding agents (Cursor, Claude Code, Antigravity, etc.). |
|
|
293
|
+
| `detect` | *(none)* | Scan workstation and local workspace for 29 external memory systems. |
|
|
294
|
+
| `migrate` | `[--provider P] [--all] [--dry-run] [--overwrite]` | Migrate memories into Muse Memory preserving active/archived state. |
|
|
295
|
+
| `ui` | `[--port N] [--global]` | Launch 6-view Cognitive Studio dashboard (default port: `2222`). |
|
|
296
|
+
| `context` | `[query] [--token-budget N] [--limit N]` | Retrieve Top-$K$ ranked active context for prompt injection. |
|
|
297
|
+
| `search` | `<query> [--limit N] [--token-budget N] [--type T]` | Ranked multi-factor token search with score breakdown. |
|
|
298
|
+
| `search-transcript` | `<query> [file.jsonl] [--window N]` | Full-text search past transcripts with dialogue context windows. |
|
|
299
|
+
| `harvest` | `<text\|file> --project P [--confirmed]` | Distill conversation turns into structured fix/decision memory units. |
|
|
300
|
+
| `import-transcript` | `<file.jsonl> [--project P] [--confirmed]` | Ingest raw `.jsonl` session transcripts from coding agents. |
|
|
301
|
+
| `capture` / `propose` | `<text> --project P [--title T] [--type T]` | Propose a memory entry with inline Vibeguard secret inspection. |
|
|
302
|
+
| `recall` | `<query> [--limit N] [--token-budget N]` | Rich recall displaying verification levels and related graph links. |
|
|
303
|
+
| `confirm` | `<id> [--global]` | Promote `candidate`, `disputed`, or `stale` entry to `confirmed`. |
|
|
304
|
+
| `supersede` | `<old_id> --with <new_id>` | Mark old entry superseded by new confirmed replacement. |
|
|
305
|
+
| `mark-stale` | `<id> [--reason <text>]` | Mark an entry stale with deprecation rationale. |
|
|
306
|
+
| `reject` | `<id> [--global]` | Mark an entry rejected. |
|
|
307
|
+
| `delete` | `<id> [--reason <text>]` | Permanently delete a memory entry and record audit event. |
|
|
308
|
+
| `audit` | `[--operation OP] [--entry-id ID] [--limit N]` | Query append-only operational audit trail (`.memory/audit.jsonl`). |
|
|
309
|
+
| `link` | `<id> --related <id1,id2>` | Synchronize bidirectional relation links between entries. |
|
|
310
|
+
| `export` / `import` | `[--out <file.json>]` / `<file.json>` | Export and import portable JSON memory snapshots. |
|
|
311
|
+
| `list` / `ls` | `[--status S] [--type T] [--project P]` | List memory entries with multi-field status and type filtering. |
|
|
312
|
+
| `stats` | `[--global]` | Breakdown statistics of total memories, status, and type metrics. |
|
|
313
|
+
| `briefing` | `[--limit N] [--global]` | Active summary of recent entries, status counts, and due items. |
|
|
314
|
+
| `nudge` | `[--global]` | Proactive attention list: overdue entries, stale policies, open loops. |
|
|
315
|
+
| `routine` | `run <name>` / `install [name]` | Execute `.memory/routines.yaml` steps or print crontab lines. |
|
|
316
|
+
| `wiki` | `compile\|list\|show <slug>` | Compile and browse Obsidian-compatible Markdown wiki pages. |
|
|
317
|
+
| `entities` | `list\|show <id>\|related <id>` | Inspect extracted knowledge graph entities and co-occurrence weights. |
|
|
318
|
+
| `settings` | `get\|set\|reset\|export\|import` | Manage unified settings across retrieval, wiki, PageIndex, and UI. |
|
|
319
|
+
| `current` | `get` / `set <text> --project P` | Read or append hard constraints in `.memory/CURRENT.md`. |
|
|
320
|
+
| `graph` | `status` | Query active CodeGraph provider status. |
|
|
321
|
+
| `mcp` | *(none)* | Start stdio MCP server (Protocol 2024-11-05). |
|
|
392
322
|
|
|
393
|
-
|
|
323
|
+
</details>
|
|
394
324
|
|
|
395
|
-
|
|
325
|
+
<details>
|
|
326
|
+
<summary><b>๐ค 5 Zero-Fingerprint Role Archetypes (`USER.md`)</b> โ <i>Click to expand</i></summary>
|
|
396
327
|
|
|
397
|
-
|
|
328
|
+
Muse Memory maintains a persistent user profile (`~/.memory/USER.md` globally, or `.memory/USER.md` locally) to ground AI agents in your working style:
|
|
398
329
|
|
|
399
330
|
1. **`developer`** (Default): Code-first, direct, concise, runnable diffs, strict types, fail-fast mechanics.
|
|
400
331
|
2. **`designer`**: Visual hierarchy, CSS/Tailwind systems, GSAP animations, WCAG accessibility, Figma/tokens design tokens.
|
|
@@ -414,38 +345,12 @@ memory user init designer --global
|
|
|
414
345
|
memory user set "- Prefers TypeScript, Bun, and ultra terse responses"
|
|
415
346
|
```
|
|
416
347
|
|
|
417
|
-
|
|
418
|
-
When `get_context` or `formatPromptContext()` builds the LLM prompt context, it structures information deterministically:
|
|
419
|
-
1. **`### User Profile & Preferences (USER.md)`** (Tone, role, rules)
|
|
420
|
-
2. **`### Active Working Constraints (CURRENT.md)`** (Project invariants & open loops)
|
|
421
|
-
3. **`### Relevant Memories & Learned Patterns`** (Top-$K$ ranked memories)
|
|
422
|
-
4. **`*Memory Directive: When learning durable facts, bug resolutions, or user preferences, call memory_capture immediately.*`**
|
|
423
|
-
|
|
424
|
-
---
|
|
425
|
-
|
|
426
|
-
## ๐ Full-Text Transcript Search with Conversation Bookends
|
|
427
|
-
|
|
428
|
-
Search across past `.jsonl` transcripts (Claude Code, Cursor, Antigravity, Codex) with surrounding dialogue context windows and session start/end bookends:
|
|
429
|
-
|
|
430
|
-
```bash
|
|
431
|
-
# Search transcript with dialogue window
|
|
432
|
-
memory search-transcript "database connection pooling" session.jsonl --window 2 --max 5
|
|
433
|
-
```
|
|
434
|
-
|
|
435
|
-
---
|
|
436
|
-
|
|
437
|
-
## ๐ก๏ธ Built-In Vibeguard Secret Defense (Zero External Dependencies)
|
|
348
|
+
</details>
|
|
438
349
|
|
|
439
|
-
|
|
440
|
-
|
|
441
|
-
- **Zero-Leakage Guarantee**: Intercepts OpenAI/Anthropic keys (`sk-*`), GitHub tokens (`ghp_*`), NPM tokens, AWS access keys (`AKIA*`), private key blocks, database connection strings, and plaintext credentials before they can ever be written to disk.
|
|
442
|
-
- **100% Standalone**: Does not require any external scripts or system installations.
|
|
443
|
-
|
|
444
|
-
---
|
|
350
|
+
<details>
|
|
351
|
+
<summary><b>๐ฎ SOW & Roadmap Issue Tracker</b> โ <i>Click to expand</i></summary>
|
|
445
352
|
|
|
446
|
-
|
|
447
|
-
|
|
448
|
-
Every Scope-of-Work item is tracked as a GitHub issue and delivered via pull request. Status: โ planned ยท โ in progress ยท โ
done. Live status: [issue tracker](https://github.com/harshsinghmp/musememory/issues).
|
|
353
|
+
Every Scope-of-Work item is tracked as a GitHub issue and delivered via pull request. Live status: [issue tracker](https://github.com/harshsinghmp/musememory/issues).
|
|
449
354
|
|
|
450
355
|
| Status | Item | Tracker |
|
|
451
356
|
| :--- | :--- | :--- |
|
|
@@ -457,7 +362,7 @@ Every Scope-of-Work item is tracked as a GitHub issue and delivered via pull req
|
|
|
457
362
|
| โ
| Automated Post-Turn Transcript Harvester Hook | [#5](https://github.com/harshsinghmp/musememory/issues/5) |
|
|
458
363
|
| โ
| Real-Time Agency WebSocket Hub (`memory daemon`) | [#6](https://github.com/harshsinghmp/musememory/issues/6) |
|
|
459
364
|
| โ
| Local Offline Hybrid Vector Engine | [#7](https://github.com/harshsinghmp/musememory/issues/7) |
|
|
460
|
-
| โ
| Delete Deprecated `MemoryStore` Shim *(
|
|
365
|
+
| โ
| Delete Deprecated `MemoryStore` Shim *(shipped v1.5.0)* | [#8](https://github.com/harshsinghmp/musememory/issues/8) |
|
|
461
366
|
| โ
| Self-Evolving Skill Distillation | [#9](https://github.com/harshsinghmp/musememory/issues/9) |
|
|
462
367
|
| โ
| 3-Layer Progressive Disclosure | [#10](https://github.com/harshsinghmp/musememory/issues/10) |
|
|
463
368
|
| โ
| Bi-Temporal Reinforcement Feedback | [#11](https://github.com/harshsinghmp/musememory/issues/11) |
|
|
@@ -468,94 +373,9 @@ Every Scope-of-Work item is tracked as a GitHub issue and delivered via pull req
|
|
|
468
373
|
| โ
| Open-Loop / Task Extraction from Transcripts โ SOW-103 | [#30](https://github.com/harshsinghmp/musememory/issues/30) |
|
|
469
374
|
| โ
| Calendar / Time-Aware Follow-ups (`due_at` / `expires_at`) โ SOW-104 | [#31](https://github.com/harshsinghmp/musememory/issues/31) |
|
|
470
375
|
| โ
| muse-agents โ musememory Integration Contract (`--for-agent`) โ SOW-106 | [#33](https://github.com/harshsinghmp/musememory/issues/33) |
|
|
471
|
-
|
|
|
472
|
-
|
|
473
|
-
---
|
|
474
|
-
|
|
475
|
-
## ๐ป Complete CLI Command Reference
|
|
476
|
-
|
|
477
|
-
```bash
|
|
478
|
-
memory <command> [arguments] [flags] # alias: musememory
|
|
479
|
-
```
|
|
480
|
-
|
|
481
|
-
| Command | Arguments / Flags | Description |
|
|
482
|
-
| :--- | :--- | :--- |
|
|
483
|
-
| `install` | `[path] [--global]` | **One-line complete setup**: initializes `.memory/`, `USER.md`, and auto-wires coding agents. |
|
|
484
|
-
| `doctor` | `[path] [--global]` | **System diagnostic**: checks SQLite primary, schemas, secrets, and MCP connections. |
|
|
485
|
-
| `uninstall` | `[agent] [--purge] [--dry-run]` | **Clean uninstaller**: unwires MCP configs (and optionally purges `.memory/`). |
|
|
486
|
-
| `init` | `[path] [--legacy] [--global]` | Initialize `.memory/` directory and SQLite database. |
|
|
487
|
-
| `user` | `[get\|init\|set] [args] [--global]` | Manage `USER.md` persona & preferences across 5 clean archetypes. |
|
|
488
|
-
| `connect` | `[agent] [--all] [--force] [--dry-run]` | Auto-wire MCP into detected installed agents with zero permissions. |
|
|
489
|
-
| `agents` | *(none)* | Scan workstation for 80+ coding agents (Cursor, Claude Code, Antigravity, etc.). |
|
|
490
|
-
| `detect` | *(none)* | Scan workstation and local workspace for 29 external memory systems. |
|
|
491
|
-
| `migrate` | `[--provider P] [--all] [--dry-run] [--overwrite]` | Migrate memories into Muse Memory preserving active/archived state. |
|
|
492
|
-
| `ui` | `[--port N] [--global]` | Launch 6-view Cognitive Studio dashboard (default port: `2222`). |
|
|
493
|
-
| `context` | `[query] [--token-budget N] [--limit N]` | Retrieve Top-$K$ ranked active context for prompt injection. |
|
|
494
|
-
| `search` | `<query> [--limit N] [--token-budget N] [--type T]` | Ranked multi-factor token search with score breakdown. |
|
|
495
|
-
| `search-transcript` | `<query> [file.jsonl] [--window N]` | Full-text search past transcripts with dialogue context windows. |
|
|
496
|
-
| `harvest` | `<text\|file> --project P [--confirmed]` | Distill conversation turns into structured fix/decision memory units. |
|
|
497
|
-
| `import-transcript` | `<file.jsonl> [--project P] [--confirmed]` | Ingest raw `.jsonl` session transcripts from coding agents. |
|
|
498
|
-
| `capture` / `propose` | `<text> --project P [--title T] [--type T]` | Propose a memory entry with inline Vibeguard secret inspection. |
|
|
499
|
-
| `recall` | `<query> [--limit N] [--token-budget N]` | Rich recall displaying verification levels and related graph links. |
|
|
500
|
-
| `confirm` | `<id> [--global]` | Promote `candidate`, `disputed`, or `stale` entry to `confirmed`. |
|
|
501
|
-
| `supersede` | `<old_id> --with <new_id>` | Mark old entry superseded by new confirmed replacement. |
|
|
502
|
-
| `mark-stale` | `<id> [--reason <text>]` | Mark an entry stale with deprecation rationale. |
|
|
503
|
-
| `reject` | `<id> [--global]` | Mark an entry rejected. |
|
|
504
|
-
| `delete` | `<id> [--reason <text>]` | Permanently delete a memory entry and record audit event. |
|
|
505
|
-
| `audit` | `[--operation OP] [--entry-id ID] [--limit N]` | Query append-only operational audit trail (`.memory/audit.jsonl`). |
|
|
506
|
-
| `link` | `<id> --related <id1,id2>` | Synchronize bidirectional relation links between entries. |
|
|
507
|
-
| `export` / `import` | `[--out <file.json>]` / `<file.json>` | Export and import portable JSON memory snapshots. |
|
|
508
|
-
| `list` / `ls` | `[--status S] [--type T] [--project P]` | List memory entries with multi-field status and type filtering. |
|
|
509
|
-
| `stats` | `[--global]` | Breakdown statistics of total memories, status, and type metrics. |
|
|
510
|
-
| `briefing` | `[--limit N] [--global]` | Active summary of recent entries, status counts, and due items. |
|
|
511
|
-
| `nudge` | `[--global]` | Proactive attention list: overdue entries, stale policies, open loops. |
|
|
512
|
-
| `routine` | `run <name>` / `install [name]` | Execute `.memory/routines.yaml` steps or print crontab lines. |
|
|
513
|
-
| `wiki` | `compile\|list\|show <slug>` | Compile and browse Obsidian-compatible Markdown wiki pages. |
|
|
514
|
-
| `entities` | `list\|show <id>\|related <id>` | Inspect extracted knowledge graph entities and co-occurrence weights. |
|
|
515
|
-
| `settings` | `get\|set\|reset\|export\|import` | Manage unified settings across retrieval, wiki, PageIndex, and UI. |
|
|
516
|
-
| `current` | `get` / `set <text> --project P` | Read or append hard constraints in `.memory/CURRENT.md`. |
|
|
517
|
-
| `graph` | `status` | Query active CodeGraph provider status. |
|
|
518
|
-
| `mcp` | *(none)* | Start stdio MCP server (Protocol 2024-11-05). |
|
|
519
|
-
|
|
520
|
-
---
|
|
521
|
-
|
|
522
|
-
## ๐ MCP Server Tool Reference
|
|
376
|
+
| โ
| AST Symbol Graph Integration (CodeGraph / Graphify provider) โ SOW-107 | [#35](https://github.com/harshsinghmp/musememory/issues/35) |
|
|
523
377
|
|
|
524
|
-
|
|
525
|
-
|
|
526
|
-
| MCP Tool | Execution Phase | Description |
|
|
527
|
-
| :--- | :--- | :--- |
|
|
528
|
-
| `get_context` | **Session Start** | Fetches Top-$K$ ranked memories, `USER.md` profile, and active `CURRENT.md` constraints. |
|
|
529
|
-
| `search` | **Investigation** | Searches memory units with query, token budget, project, type, and verification filters. |
|
|
530
|
-
| `memory_current` | **Constraints** | Reads or appends active project working constraints (`CURRENT.md`). |
|
|
531
|
-
| `memory_get_user_profile` | **Context Loading** | Reads active `USER.md` persona and communication preferences. |
|
|
532
|
-
| `memory_set_user_profile` | **Preferences** | Updates `USER.md` profile with inline secret defense. |
|
|
533
|
-
| `memory_capture` | **During Fixes** | Saves a memory entry with inline Vibeguard secret inspection. |
|
|
534
|
-
| `memory_confirm` | **Decision Approval** | Promotes candidate insight to confirmed status. |
|
|
535
|
-
| `memory_supersede` | **Refactoring** | Marks outdated knowledge superseded by a confirmed replacement. |
|
|
536
|
-
| `memory_link` | **Graph Building** | Connects related memories bidirectionally. |
|
|
537
|
-
| `memory_mark_stale` | **Deprecation** | Flags decaying knowledge with deprecation rationale. |
|
|
538
|
-
| `memory_reject` | **Hypothesis Refutation** | Marks invalidated hypotheses as rejected. |
|
|
539
|
-
| `memory_delete` | **Purge** | Permanently deletes an entry and records audit ledger log. |
|
|
540
|
-
| `memory_tree_search` | **Tree Retrieval** | Hierarchical reasoning search across partitioned memory shards. |
|
|
541
|
-
| `memory_wiki_compile` | **Wiki Compiler** | Compiles confirmed memories into Obsidian-compatible Markdown pages. |
|
|
542
|
-
| `memory_wiki_search` / `get` | **Wiki Reading** | Searches and reads compiled concept and entity wiki pages. |
|
|
543
|
-
| `memory_entities_search` / `get` | **Entity Graph** | Searches extracted entities and inspects co-occurrence strengths. |
|
|
544
|
-
| `memory_pageindex_index` | **Doc Indexing** | Builds a hierarchical reasoning tree from document content. |
|
|
545
|
-
| `memory_pageindex_search` | **Doc Search** | Searches PageIndex document tree with reasoning explanations. |
|
|
546
|
-
| `memory_pageindex_import` | **Doc Knowledge** | Imports PageIndex search insights directly into memory units. |
|
|
547
|
-
| `memory_search_transcripts` | **History Search** | Full-text search over past `.jsonl` transcripts with dialogue context windows. |
|
|
548
|
-
| `memory_harvest` | **Session End** | Distills conversation turns into structured fix/outcome units. |
|
|
549
|
-
| `memory_import_transcript` | **Transcript Sync** | Ingests `.jsonl` transcript and auto-binds memories to session nodes. |
|
|
550
|
-
| `memory_audit` | **Governance** | Queries the append-only operational audit ledger. |
|
|
551
|
-
| `memory_detect_agents` | **Onboarding** | Scans workstation for 80+ coding agent installations. |
|
|
552
|
-
| `memory_connect` | **Setup** | Auto-wires MCP server into detected installed agents with zero permissions. |
|
|
553
|
-
| `memory_detect_providers` | **Migration** | Scans machine for 29 external memory formats. |
|
|
554
|
-
| `memory_migrate` | **Migration** | Ingests external memories with state preservation and secret scrubbing. |
|
|
555
|
-
| `memory_export` / `import` | **Team Sharing** | Exports and imports portable JSON memory snapshots. |
|
|
556
|
-
| `memory_validate` | **Integrity Check** | Verifies database integrity and scans for credential leaks. |
|
|
557
|
-
| `memory_settings_get` / `set` | **Configuration** | Reads and updates unified global or project configuration settings. |
|
|
558
|
-
| `graph_status` | **AST Graph** | Inspects CodeGraph symbol overlap provider status. |
|
|
378
|
+
</details>
|
|
559
379
|
|
|
560
380
|
---
|
|
561
381
|
|
|
@@ -563,7 +383,7 @@ When registered as an MCP server, `musememory` exposes the following native tool
|
|
|
563
383
|
|
|
564
384
|
```bash
|
|
565
385
|
bun install
|
|
566
|
-
bun test #
|
|
386
|
+
bun test # 297 passed across 53 test files (1163 assertions)
|
|
567
387
|
bun run typecheck # 0 static type errors
|
|
568
388
|
bun run build # Clean bundled distribution build (dist/index.js)
|
|
569
389
|
```
|