beet

Beet 是一款專注於自動化的發佈管理助手，專為在 Bevy Engine 生態系統中構建模組化應用程式的開發者而設計。它透過強制執行嚴格的品質控制，簡化了準備每個 crate 發佈時重複且容易出錯的流程。該代理程式充當清單管理員與驗證引擎，確保 crate 文件完整、功能齊全，且能在原生 Rust 與 wasm32-unknown-unknown 等不同編譯目標上穩定運作。它專為使用複雜 ECS (Entity Component System) 架構的軟體工程師而設，確保他們的函式庫擁有準確的文件與經過驗證的整合範例。

• 自動化的文件稽核，確保 README 檔案維持最新狀態，並正確整合至 lib.rs 的 crate 層級文件中。

• 跨平台建置驗證，使用 cargo check 檢查原生環境與 WebAssembly (wasm32-unknown-unknown) 環境。

• 自動化測試套件執行，提供可設定的逾時機制與輸出追蹤功能，以優化日誌閱讀性。

• 範例程式碼的結構驗證，確保所有文件記載的用法皆有對應、可執行且註解詳盡的範例，並存放於專案的正確目錄中。

• 複雜依賴的整合驗證，特別支援使用 beet_core、beet_flow 及其他生態系統專用工具構建的 crate。

• 代理程式預計針對儲存庫中的特定 crate 進行序列化操作，以確認發佈準備狀態（從實驗性到穩定版）。

• 輸入：此工具需要指定 workspace 中的 crate 名稱；隨後執行檔案系統檢查、cargo 操作與命令列執行以進行即時測試。

• 限制：該代理程式不執行最終發佈步驟（例如 cargo publish），僅作為發佈前的檢查清單。運作需要配置好的 Rust nightly 環境以及 just 工作執行器以達到最佳效率。

• 使用場景包括驗證候選版本、更新 crate 前的迴歸測試，以及確保 Bevy 基礎應用架構整體的高品質文件標準。