リリース: フィードバックトリアージの TypeSafe 化・提案駅リランクの土台・Gemini でのターン失敗修正

[TinyKitten]

dev に溜まった #30 / #32 / #33 / #34 を master（リリースブランチ）へ反映する。

内容

前回リリース（#28）以降に増えたのは 4 本。

PR	内容
#30	master を dev へ取り込み AGENTS.md を同期する
#32	フィードバックトリアージの判定を TypeSafe に切り替える（closes #31 / refs #11）
#33	提案駅のリランクを TypeSafe で判定して対話ターンへ組み込む
#34	リランクの注記を user ロールで注入し Gemini でのターン失敗を直す

Files changed は 15 ファイル。master を取り込んだので、過去のリリース済み PR は差分に並ばない。

挙動の変化

フィードバックトリアージ（#32）

• 判定（スパム・カテゴリ・優先度・原因コンポーネント）が Workers AI から TypeSafe（System One / Jev）へ移る。 Workers AI（AI_TRIAGE_MODEL）の担当はタイトルと要約の生成だけになる
• PUBLIC_ISSUE_MIN_CONFIDENCE = 0.7（公開リポジトリへスタブ Issue を立ててよいかの門）が比較する componentConfidence が、モデルが JSON に自分で書いた数値から Choice の確率分布由来の値に変わる。門が根拠を持つようになる
• 実測（実チケット 44 件・人手で 15 件ラベル補正）: isSpam 44/44、category 41/44、component 39/44。正当な報告をスパムと誤判定したものは 0 件。コストは 44 件で $0.004、1 件あたり約 270ms
• 既存の looksLikeSpam / applySpamHeuristic は残置。既存テスト 66 件は書き換えていない
• 判定を取得できなかった場合は、タイトルと要約を保ったまま「原因を絞り込めなかった」扱いに倒す。componentConfidence が 0 になるので公開リポジトリへの起票は行われず、❓ Unknown Type が付いて人手確認に回る。フィードバック自体は失われない

/agent/chat の提案駅リランク（#33 / #34）

• 既定では無効。CONFIG_KV の config:remote に agent_rerank_threshold（0 < x <= 1 の数値）が入るまで、判定も TypeSafe へのリクエストも発生しない。 本 PR を本番へ反映した時点の /agent/chat の挙動は現行と同一
• 有効化すると、ツール検索が走ったターンで実在確認済みの候補を TypeSafe の noul で判定し、「提案してよい駅」を本文生成前に注入する。判定に失敗したときは何も注入せず、モデルが自分で選ぶ現行挙動へフォールバックする（sanitizeSuggestions の実在性検証もそのまま）
• 判定はターンに 1 回だけ。実測のレイテンシは 1 項目あたり 364ms。閾値の計測値は 0.70（20 項目のグリッド最良値なので、コードではなく KV 側で持つ）
• 同一物理駅の路線別レコードを groupId で畳み込むため、提案 5 枠が同じ駅で埋まらなくなる
• リランクの注記を user ロールで注入し Gemini でのターン失敗を直す #34 は 提案駅のリランクをTypeSafeで判定して対話ターンへ組み込む #33 の不具合修正。注記を role: 'system' で会話の末尾に差し込むと @ai-sdk/google の convertToGoogleMessages が UnsupportedFunctionalityError を投げ、AGENT_MODEL が Gemini の環境ではリランクが成功したターンが必ず失敗していた。ロールを user に変えて解消している。リランクが無効な間は発生しない経路なので、提案駅のリランクをTypeSafeで判定して対話ターンへ組み込む #33 と リランクの注記を user ロールで注入し Gemini でのターン失敗を直す #34 を同時に出す限り本番に影響は出ない
• アプリ側・SSE 仕様の変更はなし。config:remote の未知キーはアプリにも配信されるため、有効化すると agent_rerank_threshold がアプリ側の設定取得にも現れる（agent_daily_turn_limit と同じ扱い）

設定の変更

vars（wrangler.jsonc、dev / production 両方）

• 追加: TYPESAFE_MODEL = jev-latest。confidence の閾値を特定バージョンに合わせて調整したら、エイリアスではなく jev-1.13.0 のようにバージョンを固定すること（エイリアスは新リリースで指す先が動く）

シークレット（デプロイ前に投入が必要）

• 追加: TYPESAFE_API_KEY。./scripts/put-secrets.sh --env production で投入する。未投入のままデプロイするとトリアージの判定が毎回失敗し、分類が丸ごと効かなくなる（上記のとおりフィードバックは失われず、❓ Unknown Type で人手確認に回る）。リランク側は API キーが無ければそもそも有効化されない

KV

• CONFIG_KV の config:remote に agent_rerank_threshold を読む（任意・未設定で無効）。有効化するときはオブジェクトを上書きせずマージすること。丸ごと置き換えると ai_agent_enabled / agent_daily_turn_limit が消える

Service Binding / R2 / Queue / Cron: 定義の変更なし。依存追加もなし。

その他: package.json の scripts に計測用の typesafe-spike / typesafe-rerank-spike を追加（実行時に TYPESAFE_API_KEY を環境変数で渡す手元用スクリプト）。API のリクエスト／レスポンス形状の変更はなし。

デプロイ

本 PR を master へマージすると deploy_production.yml が起動し、production へ自動デプロイされる（src/** / package.json / wrangler.jsonc が paths に含まれるため）。TYPESAFE_API_KEY はマージ前に投入しておくこと。

ブランチについて

AGENTS.md の git-flow ではリリースを release/<version> 経由にする運用だが、本 PR は依頼の指定により claude/production-pr-is3ffc を head にしている。

master は過去のリリースを squash マージしているため dev と履歴が分岐しており、そのままでは競合する（#18 / #21 / #28 と同じ）。687a32d で master を取り込み、5 ファイル（.secrets.env.example / src/consumers/feedbackTriage.ts / src/consumers/feedbackTriage.test.ts / src/types.ts / wrangler.jsonc）の競合をすべて dev 側の内容で解決した。いずれも「dev の追加・置き換えに対して master が移行前の内容を持っている」だけの競合で、master 固有の変更は含まれていない。

• git diff origin/dev HEAD が空（マージ結果のツリーが dev と完全一致）
• git diff --name-status origin/master HEAD が master を dev へ取り込み AGENTS.md を同期する #30 / フィードバックトリアージの判定をTypeSafeに切り替える #32 / 提案駅のリランクをTypeSafeで判定して対話ターンへ組み込む #33 / リランクの注記を user ロールで注入し Gemini でのターン失敗を直す #34 の 15 ファイルのみ、D なし

#30 で AGENTS.md を dev 側へ同期済みのため、過去のリリースであった「master 固有の AGENTS.md が削除される」問題は起きない。

確認

687a32d（コンフリクト解消後）で実行済み。

• npm run lint（68 files、指摘なし）
• npm run typecheck
• npm test（18 suites / 311 tests パス）
• npx wrangler deploy --dry-run --env="" / --env production（gzip 602.42 KiB）
• 本番デプロイ後、実フィードバックを 1 件流して TypeSafe の判定が付くこと（❓ Unknown Type に倒れていないこと）
• 本番デプロイ後、Deploy to production ワークフローが成功していること
• リランクを有効化する場合は、config:remote をマージ更新したうえで dev で 1 ターン通し、Vertex の実 API が user 連続メッセージを受けること（リランクの注記を user ロールで注入し Gemini でのターン失敗を直す #34 の残課題）

既知の残課題

• リランクの注記を user ロールで注入し Gemini でのターン失敗を直す #34 の「末尾が user 連続になる形を Vertex の実 API が受けるか」はローカルでは未確認（GOOGLE_VERTEX_SA_KEY が手元に無いため、スタブ fetch での変換再現まで）。リランクを有効化するまで通らない経路なので、リリース自体のブロッカーにはならない
• リランクの評価セットは 20 項目・日本語中心で、英語は 1 項目のみ。「新宿御苑」に対する「新宿」（0.68）のような境界事例が残っている

🤖 Generated with Claude Code

https://claude.ai/code/session_019ebJ3d9GmbUKPde94ic4DZ

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Essentials

Run ID: 6f71a5d6-fb61-44ef-a31a-1b00684a318f

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

_{Comment @coderabbitai help to get the list of available commands.}