musememory 1.3.0 → 1.4.0

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.
Files changed (3) hide show
  1. package/README.md +24 -2
  2. package/dist/index.js +2865 -336
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -6,7 +6,7 @@
6
6
  ![NPM Version](https://img.shields.io/npm/v/musememory?style=for-the-badge&logo=npm&color=red)
7
7
  ![Bun](https://img.shields.io/badge/Bun-1.3.14-black?style=for-the-badge&logo=bun)
8
8
  ![MCP](https://img.shields.io/badge/MCP-2024--11--05-green?style=for-the-badge&logo=anthropic)
9
- ![CI Tests](https://img.shields.io/badge/Tests-128%20Passed-brightgreen?style=for-the-badge&logo=checkmarx)
9
+ ![CI Tests](https://img.shields.io/badge/Tests-249%20Passed-brightgreen?style=for-the-badge&logo=checkmarx)
10
10
  ![Docker Ready](https://img.shields.io/badge/Docker-Ready-2496ED?style=for-the-badge&logo=docker)
11
11
  ![License](https://img.shields.io/badge/License-MIT-purple?style=for-the-badge)
12
12
 
@@ -363,6 +363,12 @@ Every Scope-of-Work item is tracked as a GitHub issue and delivered via pull req
363
363
  | ✅ | Open-Loop / Task Extraction from Transcripts — SOW-103 | [#30](https://github.com/harshsinghmp/musememory/issues/30) |
364
364
  | ✅ | Calendar / Time-Aware Follow-ups (`due_at` / `expires_at`) — SOW-104 | [#31](https://github.com/harshsinghmp/musememory/issues/31) |
365
365
  | ✅ | muse-agents ↔ musememory Integration Contract (`--for-agent`) — SOW-106 | [#33](https://github.com/harshsinghmp/musememory/issues/33) |
366
+ | ✅ | Tree-Indexed Partitioned Shards & Retrieval (`memory search --tree`) — SOW-107 | [#34](https://github.com/harshsinghmp/musememory/issues/34) |
367
+ | ✅ | Markdown Wiki Compilation Engine (`memory wiki`) — SOW-108 | [#35](https://github.com/harshsinghmp/musememory/issues/35) |
368
+ | ✅ | Named Entity & Concept Extraction (`memory extract-entities` / `entities`) — SOW-109 | [#36](https://github.com/harshsinghmp/musememory/issues/36) |
369
+ | ✅ | PageIndex Native Reasoning Tree Engine (`memory_pageindex_*`) — SOW-110 | [#37](https://github.com/harshsinghmp/musememory/issues/37) |
370
+ | ✅ | Scaled Graph UI with Barnes-Hut Repulsion ($O(n \log n)$) & Standalone Export — SOW-111 | [#38](https://github.com/harshsinghmp/musememory/issues/38) |
371
+ | ✅ | Unified Global & Project Settings Module (`memory settings`) — SOW-112 | [#39](https://github.com/harshsinghmp/musememory/issues/39) |
366
372
 
367
373
  ---
368
374
 
@@ -408,6 +414,10 @@ memory <command> [arguments] [flags] # alias: musememory
408
414
  | `routine` | `run <name>` / `install [name]` | Execute `.memory/routines.yaml` steps or print crontab lines (cron-invoked, no daemon). |
409
415
  | `stale` | `[--days N] [--global]` | Audit active entries exceeding per-type staleness policies. |
410
416
  | `session` | `start --project P [--note T]` / `end <id>` | Record session start/end timeline nodes. |
417
+ | `wiki` | `compile\|list\|show <slug> [--project P] [--type T]` | Compile and browse Obsidian-compatible Markdown wiki pages (`wiki/concepts/`, `wiki/entities/`). |
418
+ | `extract-entities` | `[--project P] [--dry-run]` | Extract named entities (persons, products, orgs, files, concepts) from confirmed memories into `entities.json`. |
419
+ | `entities` | `list\|show <id>\|related <id> [--type T] [--project P]` | Inspect extracted knowledge graph entities and co-occurrence relationship strengths. |
420
+ | `settings` | `get\|set\|reset\|export\|import [key] [val] [--project P]` | Manage unified configuration across retrieval, wiki, PageIndex, extraction, and UI subsystems. |
411
421
  | `current` | `get` / `set <text> --project P` | Read or append hard constraints to `.memory/CURRENT.md`. |
412
422
  | `graph` | `status` | Query active CodeGraph provider status. |
413
423
  | `mcp` | *(none)* | Start stdio MCP server. |
@@ -424,6 +434,18 @@ When registered as an MCP server, `musememory` exposes the following tools to an
424
434
  | :-------------------------- | :--------------------------------------------------------------------------------------------------- |
425
435
  | `get_context` | Fetches Top-$K$ ranked memories tailored for active prompt injection with optional `token_budget`. |
426
436
  | `search` | Searches memory units with query, token budget, project, type, and verification filters. |
437
+ | `memory_tree_search` | Hierarchical tree-indexed reasoning search across partitioned memory shards. |
438
+ | `memory_wiki_compile` | Compiles confirmed memories into structured Obsidian-compatible Markdown wiki pages. |
439
+ | `memory_wiki_search` | Lists compiled wiki pages with optional project/type filtering. |
440
+ | `memory_wiki_get` | Reads a compiled wiki page (concept, entity, index, or log). |
441
+ | `memory_entities_search` | Lists extracted entities with type/project filtering. |
442
+ | `memory_entities_get` | Inspects extracted entity details and related co-occurrence connections. |
443
+ | `memory_pageindex_index` | Builds a PageIndex hierarchical reasoning tree from document/text (up to 10MB). |
444
+ | `memory_pageindex_search` | Searches a PageIndex tree index with reasoning explanations and depth budgeting. |
445
+ | `memory_pageindex_import` | Imports PageIndex insights directly as memory units. |
446
+ | `memory_disconnect_pageindex`| Disconnects and cleans up PageIndex tree indexes. |
447
+ | `memory_settings_get` | Reads unified global or project configuration settings. |
448
+ | `memory_settings_set` | Updates unified configuration settings with schema validation. |
427
449
  | `memory_get_user_profile` | Reads the active user persona and preferences (`USER.md`). |
428
450
  | `memory_set_user_profile` | Updates `USER.md` persona and preferences with inline secret defense. |
429
451
  | `memory_search_transcripts` | Full-text search over past `.jsonl` transcripts with conversation bookends and context window. |
@@ -500,7 +522,7 @@ rm -f ~/.local/bin/memory ~/.local/bin/musememory
500
522
 
501
523
  ```bash
502
524
  bun install
503
- bun test # 128 tests passing across 22 test suites
525
+ bun test # 249 tests passing across 43 test suites
504
526
  bunx tsc --noEmit # 0 type errors
505
527
  bun run build # Clean bundled distribution build (dist/index.js)
506
528
  ```