mirror of
https://bitbucket.org/siakitem/my-pi.git
synced 2026-10-26 18:55:22 +00:00
从官方 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。
3.3 KiB
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_searchandmemory_searchtools - Register
/memory-index-sessionscommand - Auto-index session on
session_shutdownevent
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 |