単一バイナリ、markdownファイル、派生インデックス

1. 1

   フックLLM不要

   エージェントのCLIがライフサイクルフックを発火します。送りっぱなしで、持ち時間は200 msです。ネイティブフックはイベントをローカルにスプールし、切り離されたヘルパーが配送します。サーバーは202を返し、飽和時は429を返します。

2. 2

   サニタイズLLM不要

   /hookルーターがシークレットを取り除き、サイズに上限をかけます。信頼できないテキストがストアに入る経路はここだけです。

3. 3

   単一ライターLLM不要

   サニタイズ済みのイベントは1本のキューに入ります。キューを処理するのは、唯一の書き込み接続を持つ1つのスレッドです。

4. 4

   オブザベーションLLM不要

   イベントは、運用上の監査証跡としてSQLiteに記録されます。これはセッションをサイズ制限つきで投影したもので、完全なトランスクリプトになることはありません。

5. 5

   セッション終了LLM不要

   モデルを使わずルールだけで、オブザベーションをsessions/<id>.mdにまとめ、次のエージェント向けのHandoff行を開きます。すべて1つのトランザクションで行います。

6. 6

   統合LLMは任意

   プロバイダーを設定している場合、LLMが要約を書き直すか、concepts/、decisions/、gotchas/、procedures/へ展開します。リトライ可能なキューから実行され、フックのレイテンシには影響しません。

7. 7

   コミットとインデックスLLM不要

   ページの書き込みはどれもアトミック（tmp、rename、fsync）で、gitにコミットされ、その行と同じSQLiteトランザクションの中でインデックスされます。

8. 8

   クエリとブリーフィングLLM不要

   memory_queryがインデックスを検索します。次のSessionStartで、フックはそのディレクトリ向けの未受理の引き継ぎと、構造化されたブリーフィングを取得します。

• 全文検索

  ページのタイトルと本文を対象にしたSQLite FTS5です。単純なクエリからはストップワードを除外します。

• エンティティ一致

  フロントマターのentitiesとtagsにある名前の字句インデックスです。ページ頻度の逆数で重み付けします。

• グラフの隣接ページ

  linksテーブルを1ホップたどります。対象はwikilink、markdownリンク、型付きエッジ、プロジェクト間リンクです。素のSQLで、グラフデータベースは使いません。

• ベクトル（任意）

  プロセス内のローカルモデルによる埋め込みのコサイン類似度です。2.0以降はデフォルトで有効ですが、必須ではありません。意図的に総当たりで計算しています。

融合のあと

• k=60のReciprocal Rank Fusionが、各系統を順位ベースで融合します。そのため、どの系統もスコアの較正が要りません。
• 次に、上限つきの権威度の乗数が、僅差の結果を、メンテナンスされているルール、決定事項、手順、落とし穴のページ寄りに調整します。エピソード的なページや過去のページも検索対象のままで、完全に除外されるものはありません。
• 任意のLLMリランク: クエリごとに1回、最大30件のタイトルとスニペットに対して呼び出します。失敗した場合はローカルの順位をそのまま使います。ローカルのリランカーはまだありません。これはプロジェクトで最もよく指摘される不足点です。
• コンパイル済みのページが1件もヒットしない場合は、生のオブザベーションを範囲を限って検索し、raw_hitsを返します。
• explain=trueを渡すと、ヒットごとに系統別の順位、RRFの寄与、乗数を確認できます。

ARCHITECTURE.md（15個の不変条件をすべて掲載）設計上の決定と、採用しなかった選択肢