fix(mcp): force reset RagMcpAgent DO to clear stale init() schema cache #109

Activity

1. liplus-lin-lay

   added

   bug動いていない、壊れている動いていない、壊れている

   on Apr 23, 2026
2. liplus-lin-lay

   self-assigned this

   on Apr 23, 2026
3. liplus-lin-lay

   added

   memoメモとして開始した状態。見出しは必要なものだけでよいメモとして開始した状態。見出しは必要なものだけでよい

   on Apr 23, 2026
4. liplus-lin-lay

   changed the title [-]verify(mcp): type enum cache — DO init() に古い 6 値 enum が焼き付いている[/-] [+]verify(mcp): DO init() caches stale 6-value type enum[/+] on Apr 23, 2026
5. liplus-lin-lay

   added this to the v0.8.1This milestone has been deleted milestone on Apr 23, 2026
6. liplus-lin-lay

   added

   ready本文が実装開始できる形まで収束している状態。ただし更新は継続可能本文が実装開始できる形まで収束している状態。ただし更新は継続可能

   in-progress着手中、実装または検証が進行中着手中、実装または検証が進行中

   and removed

   memoメモとして開始した状態。見出しは必要なものだけでよいメモとして開始した状態。見出しは必要なものだけでよい

   on Apr 23, 2026
7. liplus-lin-lay

   changed the title [-]verify(mcp): DO init() caches stale 6-value type enum[/-] [+]fix(mcp): force reset RagMcpAgent DO to clear stale init() schema cache[/+] on Apr 23, 2026
8. liplus-lin-lay

   linked a pull request that will close this issuefix(wrangler): force reset RagMcpAgent DO to clear stale init() schema cache (patch) #110on Apr 23, 2026
9. liplus-lin-lay

   closed this as completedin #110on Apr 23, 2026
10. liplus-lin-lay commented on Apr 23, 2026

    

    liplus-lin-lay

    on Apr 23, 2026

    MemberAuthor

    More actions

    作業完了報告

    PR #110 + #112 merge 後、npm run deploy (non-versioned) を実行し V2 binding が live。

    Uploaded github-rag-mcp (3.95 sec)
    Deployed github-rag-mcp triggers (1.09 sec)
    Current Version ID: fa6ec8d3-c5b9-41b2-b1a9-0b35124ba7d2
    

    deploy 後 search_issues の scan mode が正常 return することを確認済み。V2 namespace の DO instance が cold start で新 init() を走らせた状態。

    Master verification (再起動後)

    現 Claude Code session は session 開始時点の 6 値 schema を client 側に cache しているため、本セッション内では新 schema 確認不可。次回以降の session で：

    1. search_issues type=issue_comment sort=updated_desc top_k=3 が zod エラーなしで return すること
    2. tool schema の type enum に issue_comment / pr_review / pr_review_comment が含まれること

    本件で判明した周辺 Li+ 知見

    1. Cloudflare Workers Builds は versioned deployment (gradual) を使用。DO migration は non-versioned deploy でしか適用できない (error code 10211)。migration を含む PR は Workers Builds check が構造上必ず失敗する
    2. deleted_classes migration は binding が残った状態では適用不可。binding を新 class に切り替えた上で旧 class を delete する必要がある
    3. 過去 migration で declare されたクラスは script export を維持する必要がある (error code 10064)。rename 時は V2 を追加し旧 class を stub として残す or 明示的 migration で扱う

    これらは docs/ か wiki に残す価値があるので別 issue で書き起こす予定。
11. liplus-lin-lay commented on Apr 24, 2026

    

    liplus-lin-lay

    on Apr 24, 2026

    MemberAuthor

    More actions

    真因訂正 (2026-04-23 夜セッション)

    本 issue で立てた仮説「DO init() の zod schema が cache されて stuck」は誤診断だった。正しい真因は mcp-server/server/index.js (Claude Desktop/Code 向け stdio bridge) の search_issues.inputSchema.type.enum が 6 値のまま PR #107 時点で更新漏れしていたこと。

    観測経路

    • 再セッション開始時に tool schema を読み直したところ ["issue", "pull_request", "release", "doc", "diff", "all"] の 6 値のまま (Worker は fix(wrangler): force reset RagMcpAgent DO to clear stale init() schema cache (patch) #110/fix(mcp): retain RagMcpAgent stub to satisfy migration history (patch) #112 で V2 にリネーム + migration 適用済み、zod enum は 9 値に切替え済み)
    • grep '"issue_comment"' mcp-server/server/index.js = 不一致、bridge 側の schema が Worker 側と乖離
    • installed extension (~/AppData/Roaming/Claude/Claude Extensions/local.mcpb.liplus-project.github-rag-mcp/server/index.js:463) も同じ 6 値
    • client (Claude Desktop/Code) は bridge の JSON schema で validation → issue_comment を指定すると Worker に届く前に client-side で弾かれ、Worker 側の 9 値化が意味を持たない状態だった

    V2 rename (#110/#112) の評価

    • Roll back しない。Worker 側は V2 で 9 値 zod 有効、deploy 済み、問題なく稼働
    • ただし「fix(mcp): force reset RagMcpAgent DO to clear stale init() schema cache #109 の目的達成には不要な作業だった」ことは記録しておく
    • 獲得した副産物：Cloudflare DO migration の運用制約 4 点 (versioned-deploy 拒否 / binding coupling / export 維持 / fine-grained PAT と CI trigger) を実戦で特定 → reference memory 化済み

    誤診断の教訓

    • 「Worker 側の init() schema が stuck」仮説を立てた時に、bridge 側の独立 JSON schema 存在を検査しなかった。mcp-server/ を「mcpb packaging 用」と framing して scan 対象外にしていた
    • 真因切り分けには hypothesis-negative search (仮説と無関係な原因を積極的に排除する方向の調査) が必要。今回は「DO cache が原因」と前提した上で DO migration 関連の docs ばかり追った
    • rules/model/trigger-check-gate.md の Source check 二本柱 (literal Read + RAG) を適用する時、「現象が発生する経路全体」の map を先に取らないと false-positive diagnostic になる

    後続フロー

    • fix(mcpb): sync mcp-server bridge type enum with Worker (9 values) #114 / PR fix(mcpb): sync mcp-server bridge type enum to match Worker (patch) #115 で bridge を 9 値に同期
    • v0.8.1 release で CD workflow が .mcpb を rebuild → Master が Claude Desktop に install → 次回セッションから schema が 9 値で surface