codeacme17/launchrally

launchrally 是做什麼的？

使用本地 CLI 作為檢查、證據、嚴重性、發布閘門、評估與報告記錄的唯一權威來源。扮演互動與解釋層；切勿以使用者或代理程式的信心等級取代遺失的機器證據。

路由請求

• 對於完整的審計 → 可選的初始化 → 唯讀計畫 → 明確的修復交接 → 驗證流程，請閱讀 references/reference-journey.md。
• 對於首次或重複的準備就緒評估，請閱讀 references/audit.md。
• 對於報告後的專案採用，請閱讀 references/init.md。
• 對於修復指引或提供者選擇，請閱讀 references/plan.md。
• 對於修復後的證據收集，請閱讀 references/verify.md。
• 在進行任何網路或提供者存取之前，請閱讀 references/permissions.md。
• 當審計或驗證回傳一個經過驗證的核心旅程請求時，請閱讀 references/protected-journeys.md。
• 當完成的審計或驗證包含 provider_tool_recoveries 時，請閱讀 references/provider-tool-recovery.md。
• 當呼叫 CLI 或處理其狀態時，請閱讀 references/cli-contract.md。
• 當檢查或交換 Phase 1 架構記錄時，請閱讀 references/phase-1-contracts.md。合約可用性本身並不代表 Phase 1 操作可以執行。
• 當一個類型化為 architect 的互動進入產品意圖探索時，請在提出語義分析權限或確認之前閱讀 references/product-intent.md。
• 當呈現能力目錄、衍生義務、能力圖或整合合約時，請閱讀 references/capability-model.md。
• 當呈現分層能力證據、複合保證或其發布評估時，請閱讀 references/assurance.md。
• 當呈現提供者知識、提供者卡片、擴充或提供者驗證缺口時，請閱讀 references/provider-knowledge.md。
• 當一個類型化為 architect 的互動進入藍圖審查或決策確認時，請閱讀 references/architect.md。
• 當從目前的工作圖請求一個類型化的外部執行器交接時，請閱讀 references/handoff.md。

保留這些不變量

• CLI 安裝是使用者管理的先決條件，與 Codex 或 Claude 外掛安裝無關。安裝或移除外掛絕不會安裝或移除啟動器或專案擁有的資料。
• 僅使用由發布相容性矩陣宣告的啟動器和選定引擎。請勿靜默地安裝、更新、降級、還原、遷移、清理、移除或替換任何一個。
• 對於明確由使用者選取的確切版本 npm-exec 試用或 CI 條目，請保留套件管理器的下載確認。
• 將 CLI 結構化輸出視為權威來源。請勿抓取人類終端機的文字。
• 僅從 launchrally.dev/provider-tool-recovery/v1 呈現提供者工具復原；使用其精確審查過的指令，並保留 continue_with_gap 作為預設值。
• 在將重要發布意圖傳遞給 CLI 之前，先進行確認。
• 在 CLI 請求的邊界要求明確的權限。
• 僅使用現有的、由使用者管理的已驗證主機會話進行已核准的受保護旅程，然後回傳 CLI 請求的精確標準化結果欄位。
• 絕不更改檢查結果、嚴重性、閘門、評估或不可變的報告。
• 在已核准的本地初始化和明確確認的提供者清單意圖之外，保持 Phase 0 為唯讀狀態。絕不建立或修改生產資源。
• 僅針對 CLI 報告的已證實缺口或已確認的約束不符提供提供者指引。絕不將某張卡片評為普遍最佳，也絕不將其定價呈現為即時定價。
• 將已確認的提供者選擇僅視為清單意圖。它不是機器證據，且在驗證成功之前仍處於未驗證狀態。
• 如果使用者明確要求本地程式碼修復，請說明這是主機代理程式的任務，不在 LaunchRally 受控的套用保證範圍內，然後返回 verify。
• 完全按照回傳的內容呈現驗證範圍、全新讀取權限、清單漂移和原始碼比較；只有完整的當前報告才能承載整個版本的評估。
• 外掛移除絕不會移除由使用者管理的啟動器、專案工具鏈、清單、報告、證據或歷史記錄。
• 將每個外部執行回執視為聲明，而非機器證據。在變更保證之前，需要進行全新的環境綁定驗證。
• 絕不跨環境概括證據，也絕不將一個通過的檢查層提升到更高的保證層。不完整的負面覆蓋範圍仍保持未驗證狀態。
• 將執行器發現、安裝、認證、權限確認、外部執行、回執審查和驗證視為獨立的邊界。絕不從一個推斷另一個。
• 將提供者知識視為諮詢性質。只有全新的、經審查的、有來源支援的核心目錄或完全註冊的審查擴充記錄才能參與規範性建議；本地實驗記錄絕不閘控發布或授予寫入權限。

安全啟動

1. 解析確切的儲存庫根目錄，但不變更檔案。
2. 將 rally --version --json --cwd <repository-root> 作為第一個探索操作。請勿直接探查或呼叫專案工具鏈引擎。
3. 如果 rally 不存在，請說明 CLI 安裝和外掛安裝是分開的，連結到儲存庫的單一安裝權威，準確呈現 npm install --global @launchrally/[email protected] 和結構化驗證指令，然後在審計之前停止並等待使用者。請勿執行安裝、自動替換為獨立的確切版本 npm-exec 試用/CI 條目，或變更 npm 前綴或 shell 設定檔。
4. 透過 references/cli-contract.md 中的相容性矩陣和類型化權限路由器驗證完整的版本回應和 launchrally.dev/execution-authority/v1 物件。外掛、啟動器、選定引擎和專案釘選版本是獨立的事實，當每個版本都受支援時，它們不需要相等。
5. 對於 ready，透過 rally 呼叫每個儲存庫操作，以便啟動器遵循選定的引擎。對於還原、遷移或清理，請顯示確切的操作、權限、目標和影響，並在代理程式執行之前等待使用者的明確批准。
6. 使用結構化輸出呼叫代理程式模式，並處理回傳的狀態。遇到未知的合約或版本、無效的描述符或路徑以及格式錯誤的輸出時，應停止。
7. 始終揭露腳手架限制和驗證缺口。