Files
my-pi/pi-hermes-memory/docs/0.4/TASKS.md
T
云服务部-叶林立 312bb2ba5a feat(pi-hermes-memory): 导入上游 v0.9.10 源码快照
从官方 Git 仓库导入 chandra447/pi-hermes-memory 在 tag v0.9.10
(df624056a2e8c68bc89ba0a81e1c120856ec9665,2026-10-02)的源码快照。
本次仅导入源码,尚未接入组合包:package.json、加载顺序、依赖与权限策略
均未改动。

- 原样导入 src/、tests/、docs/、scripts/、README、CHANGELOG、PLAN、
  AGENTS 与 LICENSE;该快照共 156 个上游文件。
- 剔除嵌套 .git、上游 .github 工作流、.ralph/、.claude/、node_modules、
  覆盖率与构建产物。
- 新增中文 UPSTREAM.md,记录来源,以及启用前必须完成的待决事项:
  在 pi-compaction 之前注册加载顺序、better-sqlite3 版本与根 allowScripts
  对齐、strip-ansi 解析确认。
- 说明选择 tag 而非 main 的原因:导入时上游 main 已领先至
  24fcd8ad26fc27badb8d7dbaf8034645de07b893(2026-10-11),选 tag 是为
  对应一个已发布、可复现的版本。

尚未接线。启用前还需反转 tests/extension-load.test.ts 中"不得加载
Hermes"的断言,并同步 pi-tool-search 分组、权限策略与文档。

验证:快照 156 个上游文件全部导入,目录内仅多出 UPSTREAM.md 一份;
已确认与上游 main 内容存在差异,证明取的是 tag 而非 main。
2026-10-13 23:19:35 -07:00

3.3 KiB

v0.4 Tasks: SQLite FTS5 Session Search + Hybrid Memory

Status Legend

  • [ ] Not started
  • [~] In progress
  • [x] Done

Epic 1: SQLite Foundation ✅

Task 1.1: Install better-sqlite3 and create DB module

  • Install better-sqlite3 + @types/better-sqlite3
  • Create src/store/db.ts — DatabaseManager class
  • Create tests/store/db.test.ts — 14 tests passing

Task 1.2: Create schema and migrations

  • Define schema in src/store/schema.ts
  • Add triggers to keep FTS index in sync
  • Test: schema creates cleanly on fresh DB, idempotent on existing DB

Epic 2: Session History Indexing ✅

Task 2.1: JSONL parser

  • Create src/store/session-parser.ts
  • Create tests/store/session-parser.test.ts — 14 tests passing

Task 2.2: Session indexer

  • Create src/store/session-indexer.ts
  • Create tests/store/session-indexer.test.ts — 12 tests passing

Task 2.3: /memory-index-sessions command

  • Create src/handlers/index-sessions.ts
  • Wire into src/index.ts

Epic 3: Session Search ✅

Task 3.1: Session search store

  • Create src/store/session-search.ts — FTS5 search
  • Create tests/store/session-search.test.ts — 11 tests passing

Task 3.2: session_search tool

  • Create src/tools/session-search-tool.ts
  • Register in src/index.ts

Epic 4: Extended Memory Store ✅

Task 4.1: SQLite memory store

  • Create src/store/sqlite-memory-store.ts
  • Create tests/store/sqlite-memory-store.test.ts — 19 tests passing

Task 4.2: memory_search tool

  • Create src/tools/memory-search-tool.ts
  • Register in src/index.ts

Epic 5: Char Limit Increase ✅

Task 5.1: Update defaults

  • Update src/constants.ts — 5000 defaults
  • Update src/types.ts — updated comments
  • Update README configuration table

Task 5.2: Update tests

  • Updated all tests that depend on char limits
  • Verified consolidation still works at new limits

Epic 6: Integration & Polish ✅

Task 6.1: Wire everything into index.ts

  • Initialize DatabaseManager on extension load
  • Register session_search and memory_search tools
  • Register /memory-index-sessions command
  • Auto-index session on session_shutdown event

Task 6.2: Add session indexing to background review

  • Auto-index on session_shutdown (indexes most recent session)

Task 6.3: Update README

  • Added session history search and extended memory sections
  • Updated char limits: 2200/1375 → 5000
  • Updated configuration table and JSON example
  • Updated Where Data Lives with sessions.db
  • Updated Known Limitations

Task 6.4: Version bump & release

  • Bump version to 0.4.0
  • Run full test suite — 272 tests passing
  • Publish to npm
  • Create GitHub release

Summary

Epic Files Created Tests
1. SQLite Foundation db.ts, schema.ts 14
2. Session Indexing session-parser.ts, session-indexer.ts, index-sessions.ts 26
3. Session Search session-search.ts, session-search-tool.ts 11
4. Extended Memory sqlite-memory-store.ts, memory-search-tool.ts 19
5. Char Limits constants.ts, types.ts —
6. Integration index.ts, README.md, learn-memory-tool skill —
Total 12 new files 272 tests