feat(graph): opt-in GraphRAG layer over Decision Structure (D1 edges + traversal)

[liplus-lin-lay]

Closes #155

概要

dense(Vectorize)＋sparse(D1 FTS5) の RRF ハイブリッドに、判断知(Decision Structure = wiki エントリ)の関係を索引化する additive なグラフ層を追加。search に opt-in の graph_expand を足し、関連 wiki ページを辿って結果末尾に append する。

設計原則

• 完全 additive・既定 off: graph_expand=false(既定)時は既存 retrieval と byte-identical(回帰なし)。on の時だけグラフを読む。
• エッジ抽出は決定的 slug-match(LLM 不要・ロスなし)。dst の vector_id は wikiDocVectorId で計算でき lookup 不要(dangling 可)。
• まず generic "mention" edge のみ(typed supersede/depend/conflict は後続)。

変更

• migrations/0002_graph_edges.sql: doc_edges テーブル(src/dst/repo/slugs/edge_kind)＋index。
• src/graph.ts(新規): 抽出(indexWikiEdges)/ upsert / delete / 再帰CTE traversal(queryNeighbors)/ neighbor enrich。
• src/pipeline/embed-doc.ts: wiki index 直後に抽出フック(失敗しても本体 index を壊さない)。
• src/mcp.ts: search に graph_expand/graph_hops param、RRF 後の最終結果を seed に neighbor を append、ResultItem に graph_hop/graph_from、response に graph_expanded/graph_neighbors。
• src/poller.ts: wiki 削除時の edge delete fan-out。
• src/index.ts: POST /admin/backfill-edges?repo=...(GITHUB_TOKEN 認証)で既存 wiki から一括抽出(GitHub 再取得不要)。
• docs/0-requirements.{ja,}.md: graph 層の節を追記(同一 PR)。

検証

• tsc --noEmit 通過(exit 0)。
• 再帰 CTE の SQL を実 SQLite(=D1 同エンジン)で実行検証: seeds→1-2hop neighbor を正しく辿り provenance も正確、repo フィルタも動作。
• deploy 後: graph_expand 省略時の回帰なし確認 → backfill 実行 → 実 DS クエリで on/off 比較を実運用観測(Li+ ネイティブ評価)。

デプロイ(auto モード)

AI self-review → merge → wrangler d1 migrations apply github-rag-fts → wrangler deploy → backfill → observe(~5分/次 cron)。Master が "実装して ship＋実運用観測" を go 済み。

[cloudflare-workers-and-pages]

Deploying with    Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status	Name	Latest Commit	Updated (UTC)
✅ Deployment successful! View logs	github-rag-mcp	6b9341f	Jun 14 2026, 04:52 AM

[liplus-lin-lay]

自己レビュー（auto モード / AI self-review）

整合・安全

• 完全 additive・既定 off: graph_expand 省略時、retrieval は dense+sparse+RRF の既存パスのみを通り byte-identical（graph 層は読まれない）。回帰リスクなし。
• 抽出フック / delete fan-out / backfill / graph 展開は全て try/catch の best-effort で、失敗しても本体 index・retrieval を壊さない。
• migration は IF NOT EXISTS・追加テーブルのみ（既存スキーマ非破壊）。

検証

• tsc --noEmit exit 0。
• 再帰 CTE を実 SQLite（=D1 同エンジン）で実行検証済（seeds→1-2hop neighbor 正確・provenance 正確・repo フィルタ動作）。
• CI: test / CI / Workers Builds 全 pass、mergeStateStatus=CLEAN。

deploy（Master go 済み: 「実装して ship＋実運用観測」）

merge 後: wrangler d1 migrations apply github-rag-fts → wrangler deploy → POST /admin/backfill-edges → observe(~5分/次 cron)。回帰確認(graph_expand 省略=不変) を最優先で実施。

判定: マージ可。