| name | bp-rust |
| description | Alt の Rust Edition 2024 規約を適用する。thiserror でのドメインエラー、借用優先、tokio + tracing、配線失敗を握り潰さない、flush タスクの JoinHandle 保持、char boundary 安全な切り詰め、リトライ境界でのエラー型保持、libtorch 常駐時の jemalloc を扱う。Rust のコードを書く・直す・レビューするときに使う。ユーザが「Rust」や規約名に触れなくても、Rust サービス（rask-log-aggregator, rask-log-forwarder, recap-worker）の実装・修正に入るなら使う。 |
| paths | ["**/*.rs"] |
Rust Best Practices
以下はタスク全体を通じて有効な規約であり、一度読んで終わる手順ではない。Rust コードを書くたびに適用する。
詳細な根拠とコード例が必要になった時点で docs/best_practices/rust.md の該当セクションだけを Read する
（全 17 セクション・1124 行あるため全文読み込みはしない）。
重要原則
- Edition 2024:
edition = "2024" 必須。unsafe extern ブロック、RPIT lifetime capture の変更に注意
- thiserror でエラー型:
#[derive(Debug, Error)] でドメインエラー定義。anyhow はバイナリエントリポイントのみ
- pub(crate) デフォルト: 公開 API でないものは
pub(crate) に。pub は意図的な公開のみ
- 借用優先:
.clone() を安易に使わない。&str > String、&[T] > Vec<T> を引数に
- tokio + tracing: 非同期ランタイムは
tokio、ログは tracing クレート。println! / eprintln! 禁止
- main.rs は薄く:
lib.rs でモジュール宣言、main.rs はサーバー起動 + graceful shutdown のみ
- match 網羅性:
_ ワイルドカードより明示的なバリアント列挙。将来の追加を検出
- 配線失敗を
.ok() で握り潰さない: コンストラクタ / DI の Result は ? で起動失敗に。ダミー値・乱数フォールバックで成功を偽装しない（→ .claude/rules/di-wiring.md）
- flush タスクは fire-and-forget 禁止: JoinHandle / TaskTracker を保持し shutdown で await。buffer の drain は書き込み成功後のみ
- 文字列切り詰めは char boundary:
&s[..n] はマルチバイトで panic。char_indices を使う
- リトライ境界でエラー型を保持:
anyhow::bail! での文字列化は downcast_ref ベースのリトライ判定を殺す（429 がリトライ不能に）。ステータスコードを保持する thiserror 型で伝播（ADR-000390）
- 「全部失敗」を「空の成功」にしない:
Ok(_) を成功と見なさず、結果オブジェクトの中身（genres_stored 等）を検査して JobOutcome を判定（ADR-000149）
- libtorch 常駐は jemalloc: glibc malloc のフラグメンテーションで RSS 1.5-2 倍 → OOM kill。
unprefixed_malloc_on_supported_platforms 付きでグローバルアロケータに（ADR-000547）
参照
完全なベストプラクティスは docs/best_practices/rust.md を参照。
セクション: Edition 2024 Essentials, Project Structure, Error Handling, Ownership & Borrowing, Async, Testing, Database, Logging
