refactor(pipeline): split pipeline.ts (1658 lines) into per-surface modules (patch)

[liplus-lin-lay]

目的

src/pipeline.ts (1658 行) を src/pipeline/ 配下の 10 モジュールに per-surface 分割し、 src/pipeline.ts 自体は 22 行のバレル (re-export only) に縮退。 consumer (src/poller.ts / src/webhook.ts) は import 文無変更で動作する。 読みやすさと修正局所性を上げ、 将来の surface 追加 (新 GitHub event 等) の影響範囲を限定する。

Closes #147

変更点

分割先 (src/pipeline/)

ファイル	行数	内容
ingest-filter.ts	33	MIN_COMMENT_BODY_CHARS, isBotSender, isBodyTooShort
embedding.ts	69	MAX_EMBEDDING_*, generateEmbedding, generateEmbeddingBatch
hash.ts	96	computeBodyHash, prepareEmbeddingInput, base64UrlEncode, sha256Hex, prepareDiffEmbeddingInput, prepareCommentEmbeddingInput
vector-id.ts	135	stableVectorId (private), base64UrlEncodeBytes (private), vectorId / releaseVectorId / docVectorId / wikiDocVectorId / diffVectorId / issueCommentVectorId / prReviewVectorId / prReviewCommentVectorId
types.ts	19	跨ぎ型 UpsertResult のみ
embed-issue.ts	281	GitHubIssueData, processAndUpsertIssue
embed-release.ts	168	GitHubReleaseData, processAndUpsertRelease
embed-doc.ts	219	processAndUpsertDoc, processAndUpsertWikiDoc
embed-diff.ts	309	GitHubCommitDetail, DiffUpsertResult, normaliseFileStatus (private), fetchCommitDetail, processAndUpsertCommitDiff
embed-comment.ts	416	GitHubCommentData / GitHubPRReviewData / GitHubPRReviewCommentData, CommentUpsertResult, ingestIssueComment / ingestPRReview / ingestPRReviewComment

バレル (src/pipeline.ts)

22 行に縮退。 10 個の export * 文と docstring のみ。

設計判断 (subagent → main 引き継ぎ)

• base64UrlEncodeBytes は vector-id.ts 内 private に配置 (唯一の call site)。 hash.ts の public base64UrlEncode (UTF-8 入力) とは別関数なので分離が自然
• stableVectorId の NUL セパレーター (``) は byte-for-byte 保持済み。 Vectorize 既存 vector ID と完全一致するため re-index 不要 (node の生バイト確認: 34, 0, 34 = `"` + NUL + `"`)
• UpsertResult のみ pipeline/types.ts に分離 (issue/release/doc/wiki が共有)。 DiffUpsertResult / CommentUpsertResult は owning module に同居

動作変更ゼロの検証

• 全 export name 比較: main 40 個 → branch 40 個、 差分 0 (node で export (function|interface|const|type) 抽出して set diff)
• src/poller.ts / src/webhook.ts の git diff = 0 lines (import 文不変)
• tsc --noEmit clean、 wrangler deploy --dry-run 成功

AI 自己レビュー (auto モード)

分類

• refactor 100%、 挙動変更ゼロ、 public surface 不変
• consumer 側影響ゼロ、 vector ID 互換性保持
• → patch 維持

検証ゲート (subagent 報告 + main 再検証)

ゲート	結果
tsc --noEmit	clean
wrangler deploy --dry-run	成功 (2228.62 KiB)
git diff main -- src/poller.ts src/webhook.ts	0 lines
src/pipeline.ts 行数	22 (target 30-60 内)
barrel 経由 import 残存	poller.ts:35 / webhook.ts:31 で ./pipeline.js import 維持
export name set 一致	main 40 ⇔ branch 40、 差分なし
stableVectorId NUL セパレーター	生バイト一致 (vector ID 互換)

CI pass を確認次第、 auto モード規約に従い gh pr merge --squash で直接マージする。

🤖 Generated with Claude Code

[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	96bce22	May 25 2026, 01:21 AM

[liplus-lin-lay]

AI self-review (auto mode)

分類確認

• refactor 100%、 挙動変更ゼロ、 public surface 完全一致 (40 export ⇔ 40 export)
• consumer (poller.ts / webhook.ts) git diff 0 lines、 import 文不変
• stableVectorId の NUL セパレーター 生バイト一致確認済み (34, 0, 34 = " + NUL + ") → Vectorize vector ID 互換、 re-index 不要
• → patch 維持

brake 確認

• L3 Task Layer (USER_REPO github-rag-mcp) スコープ、 Evolution_Initiator_Autonomy brake 2 (L1 Model Layer 限定) 不適用
• parallel-subagent-eval (brake 1) は Evolution_Initiator path 限定なので user repo 内 auto モード refactor では適用外、 self-review + CI で gate

diff 自己確認

• src/pipeline.ts 1658 → 22 行、 10 個の export * + docstring のみ
• src/pipeline/ 配下に 10 新ファイル (ingest-filter / embedding / hash / vector-id / types / embed-issue / embed-release / embed-doc / embed-diff / embed-comment)
• 各新ファイル先頭に role docstring 完備
• import パスは ../types.js, ../fts.js, ./hash.js 等の相対パス、 .js 拡張子付与 (ESM moduleResolution: bundler 規約)

設計判断

• base64UrlEncodeBytes を vector-id.ts 内 private に配置 (唯一の call site、 cross-module 露出回避)
• UpsertResult のみ pipeline/types.ts に切り出し (issue/release/doc/wiki 共有)、 DiffUpsertResult / CommentUpsertResult は owning module 同居
• 依存 DAG: embedding → (none); hash → embedding; vector-id → (none); types → (none); embed-* → ../types, ../fts, ./hash, ./embedding, ./vector-id, ./types, plus embed-comment → ./ingest-filter。 循環なし

CI

• test (tsc --noEmit + wrangler deploy --dry-run): pass (18s)
• CI gate: pass (3s)
• Workers Builds: pass

マージ判断

auto mode: AI 自己レビュー pass → AI 直マージ (gh pr merge --squash)。 v0.8.7 milestone 紐付け済み、 #148 と同じ release に乗る候補。