docs+fix: v0.9.1 final-check findings — CHANGELOG gaps, doc/log nits, review guardrail

[t0k0sh1]

Summary

v0.9.1 リリース前最終チェック(マイルストーン全44 issueの横断検証)で見つかった所見の一括修正。機能デグレはゼロで、所見はすべて CHANGELOG/doc/レビュー体制レベル。

• CHANGELOG.md [Unreleased](high 1件+medium 7件):
  • HTTP APIハンドラのエラー応答・入力検証の一貫性の破れ #623 エントリの「Every other response is byte-identical」が不正確 — 同じPR群(fix: input-validation consistency across schema/source/keyset handlers #647/fix: log cache_and_serve's dead fallback, surface a refusal's true issue count #648/fix: give the deep write path's quota refusal the same advisory as the pre-check #649)が over_limit へのコード変更・schema/audit の deny_unknown_fields・keysetカーソルの1032バイト上限・容量競合の stream_refusal 化も行っていたため、エントリを実態に合わせて拡充。
  • マイルストーン中に入った公開契約変更7件のエントリ追加: /metrics 新系列4本(registry: cue/BM25 キャッシュの静かな劣化 5 件 #563/ship/replica: クラウド障害・シャットダウン時のフェイルセーフ不備 #616)、compaction outcome の image_persisted/skipped(永続化層の診断不能な失敗経路・チョークポイントの穴 #586)、explain の limit_to_reach_reason+契約修理(検索/explain の公開契約の破れ #601)、DELETE mid-rename の 409 化(registry: rename/boot のクラッシュ安全性 9 件 #561)、ページング limit=0 の floor 1(registry メタサイドカーの静かな劣化・リビジョン後退 #585/registry: 連想retract/変更フィードの公開契約破れ #676)、taguru restore の exit code 契約と pre-manifest 世代拒否(ship/replica: クラウド障害・シャットダウン時のフェイルセーフ不備 #616/ship/replica: 未検証分岐(shipper/restore/replicaの主要分岐にテストが無い) #618/ship/replica: 重複コード・doc陳腐化・簡素化候補 #619)。
• src/registry.rs(low): embedding_failed の doc が実在しないメトリクス名 taguru_embed_refresh_total を参照 → 実名 taguru_embedding_requests_total{operation="refresh"} に訂正。
• src/registry/engine.rs(low): warn! 3箇所が '{name}': {error} の文字列補間で、同ファイルの他箇所の構造化フィールド(context = %name, %error)と不整合 → 構造化フィールドに統一(ログ文言をピン留めするテストなし、grep確認済み)。
• .coderabbit.yaml: 公開契約変更(レスポンス形状・エラーコード・メトリクス・exit code・オンディスク形式)が CHANGELOG [Unreleased] に正確に記載されているか(記載済みでも diff と矛盾しないか)を確認するレビュー観点を src/**/*.rs に追加 — 今回の記載漏れ8件の再発防止。

GitHub側の対応(このPR外): follow-up issue #690 起票(PR #636 がフラグした cross_search_passages の span 非対称)、PR #645 本文の「issue paths unchanged」誤記載を訂正済み。

Test plan

• cargo fmt --check — clean
• cargo clippy --all-targets — clean
• cargo test — full suite green (3,856 passed / 0 failed / 6 ignored)
• Pre-PR diff-scoped mutation gate: 1 mutant, 1 unviable, 0 missed

https://claude.ai/code/session_01D9qnXBxou4stoxmacnDbKb

Summary by CodeRabbit

• ドキュメント

  • 未リリース欄に、メトリクスや検索説明、コンパクション、エラー応答などの変更内容を追記しました。
  • メトリクス名と失敗時の記録例を最新仕様に更新しました。
  • Rustコード向けレビュー指示に、公開仕様と変更履歴の整合性確認を追加しました。

• 改善

  • エラーメッセージのコンテキスト表示を整理し、構造化ログで確認しやすくしました。

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: 412aac4f-4f88-44d2-8cb0-d9c05270dbe8

📥 Commits

Reviewing files that changed from the base of the PR and between aa55544 and 50bade6.

📒 Files selected for processing (4)

• .coderabbit.yaml
• CHANGELOG.md
• src/registry.rs
• src/registry/engine.rs

Included review availability: 1 review is currently available. Based on recent review activity, included reviews refill at 2 per hour.

---

📝 Walkthrough

Walkthrough

公開契約の変更を CHANGELOG.md に記録し、レビュー指示を追加しました。メトリクス例を更新し、WAL とリカバリーフラッシュの警告を構造化ログに統一しました。

Changes

公開契約とログ記録

Layer / File(s)	Summary
公開契約の記録とレビュー指示 .coderabbit.yaml, CHANGELOG.md	公開契約の変更を [Unreleased] に追加しました。レビュー指示に、変更内容との整合性を確認する項目を追加しました。
メトリクス例と構造化ログの更新 src/registry.rs, src/registry/engine.rs	埋め込みリフレッシュのメトリクス例を更新しました。WAL とリカバリーフラッシュの警告から重複したコンテキスト表示を削除しました。

Estimated code review effort: 1 (Trivial) | ~5 minutes

Merge Risk: ⚪ Minimal · up to 50bad

This PR updates release documentation, corrects metric documentation and log formatting, and adds a review guardrail; no actionable merge-blocking risk remains beyond normal checks and review.

Possibly related PRs

• t0k0sh1/taguru#572: src/registry/engine.rs の WAL 失敗処理とリカバリーログに関連します。

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	タイトルはCHANGELOGの修正、ドキュメントとログの更新、レビューガードレールの追加という主要な変更を明確に示しています。
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch fix/v091-final-check-findings

---

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