summaryrefslogtreecommitdiff
path: root/docs/development-plan.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/development-plan.md')
-rw-r--r--docs/development-plan.md48
1 files changed, 48 insertions, 0 deletions
diff --git a/docs/development-plan.md b/docs/development-plan.md
index 1dffb21..d424cf6 100644
--- a/docs/development-plan.md
+++ b/docs/development-plan.md
@@ -28,3 +28,51 @@
## Checkpoint rule
各checkpointでは公開schema、log format version、テスト結果、benchmark artifact、未解決事項を記録する。`docs/implementation-status.md`はcheckpoint完了後だけ更新する。
+
+## 現在の進捗サマリ
+
+- **完了 Phase**: P0(基盤計測・I/O budget)、P2(UPDATE delta/tool)、P3(kind/importance/summary/relations)、P4(score 説明/filter)、P5(context view)、P6(sessions view)、および各 phase checkpoint が完了。
+- **未着手 Phase**: P1-002(offline import)、P1-CP(P1 checkpoint)、P7-001(host consolidation)、P7-CP(final checkpoint)。
+- **進捗率**: 14/20 行(70%)が完了。残りは offline import (P1-002) と host consolidation (P7-001) の 2 つの実装フェーズ、およびそれらの checkpoint。
+- **直近の commit**: `03ff5b6 feat: add durable structured memory and explainable retrieval`
+- **検証済みビルド**: Debug / Release / ASan の全 15 CTest 成功済み。
+
+## 次の新規タスク向け依頼事項
+
+### 1. offline JSONL import(P1-002)
+- `read_messages` view=export の逆方向を実装する。
+- 形式: 1 行目 manifest、後続行が PUT/DEL レコードの JSONL。
+- 競合解決: 同一 `message_id` であれば import 側で上書きするか、revision ベースで拒否する方針を決める。
+- 排他 lock 下でアトミックに置換: 一時データディレクトリに読み込み、検証後に現 `store` と置換。
+- I/O 予算: 一時ファイルあたり 1 flush、最終的な swap は OS の rename。
+- テスト: conflict/rollback/round-trip、1 万/5 万件 benchmark。
+- エントリポイント: 新 MCP tool `import_messages` とするか、外部 CLI コマンドとするかを設計時に決定。
+
+### 2. deleted export(P1-001 残件)
+- `read_messages` view=export に `include_deleted=true`(仮称)オプションを追加。
+- DEL レコードも JSONL に含め、offline import 側で復元可能にする。
+- log format version / schema の互換性を維持する。
+
+### 3. 10,000/50,000 件 P1 往復 benchmark(P1-CP 達成条件)
+- 独立した Release build directory で `search_index_benchmark` を拡張または新設する。
+- 確認項目:
+ - context view: relation BFS が全件走査・二乗探索に退行していないこと。
+ - sessions view: O(n²) 集計に退行していないこと(現在は索引列挙済み)。
+ - 応答サイズが 8 MiB 以下に収まること。
+ - latency の regression が前回 checkpoint から 10% 以内であること。
+- 結果を `docs/implementation-status.md` へ追記。
+
+### 4. protocol test restart resume の退行調査
+- `tests/mcp_protocol_test.py` 内の「サーバ rebuild 後の再起動 + cursor 継続」テストを一時コメントアウトしている。
+- 再起動直後の `initialize` で exit code 1 になる原因を特定し、復活させる。
+- 切り分け: `tiny_store_open` の失敗か、`tiny_convmem_server_run` 内の失敗かを分離。
+
+### 5. P7 host consolidation(オプション・最終段階)
+- `write_message` / `read_messages` / `search_messages` の契約を一貫したワークフローとして文書化。
+- 必要に応じて `summary` memory kind の自動生成・更新を含む新 tool または利用ガイドを検討。
+- 現時点では専用 tool 追加は不要(再開メモ: 専用toolなし)。
+
+### 6. ドキュメント更新ルール
+- 各新規タスク完了、`docs/implementation-status.md` を実装結果に同期する。
+- `docs/development-plan.md` の「状態」「commit」「再開メモ」列を更新する。
+- 全テスト(Debug / Release / ASan)と `git diff --check` を成功させてからコミットする。