このプロジェクトについて

Assuraは、ソフトウェアプロジェクト向けのコマンドライン検証ツールであり、Rustで記述され、MIT/Apache-2.0のデュアルライセンスで提供されています。その目的は、修正が容易な段階でプロジェクトの乖離を検知することにあり、リポジトリ構造、命名、ファイルやセクションの制限、Markdown、参照、ブランチやワークツリーの変更負荷、およびプロジェクト固有のポリシーに対する迅速なローカル信号層を提供します。 プロジェクトのワークフローは「一度オンボードし、作業中にレビューし、必要に応じて説明し、マージ前にチェックする」という構成で、レビュー(レーダー)とチェック(ゲート)を分離しています。 READMEで説明されている機能には、命名、配置、必須または禁止パス、子要素やファイルの制限、Markdown、参照、生成された出力の境界に関するプロジェクトレベルの検証が含まれます。また、設定されたチェック、非アクティブな機能、ブランチ/ワークツリーの変更、ホットディレクトリ、優先順位付けされた次のアクションを表示するコンパクトなプロジェクトレビュー機能や、テキスト、JSON、YAML、アドバイス、ステータス、エージェント形式での出力機能も備えています。さらに、ベースラインを確立しプロジェクト固有のガイダンスをインストールするエージェント対応のオンボーディング、言語非依存から開始し必要に応じて言語やドメインのルールを追加できる再利用可能なポリシー層、LS-Lint 2.3設定の移行、コールド/ウォーム時のパフォーマンス証明、および編集バーストを統合してカバレッジ範囲を報告する継続的なローカル検証が含まれます。 インストールは、パブリックシェルインストーラー、Linux/macOS/Windows向けのビルド済みリリースアーカイブ(assuraとassura-fullのペアが必要)、またはcargoによるソースビルドから可能です。エージェント向けの典型的な開始手順は「agent onboard, review, explain, watch, check」であり、最小限の構造のみの場合は「init」の後に「check」を実行します。設定は.assura/config.ymlで行い、ファイルやディレクトリの命名規則や除外グロブをYAMLブロックで記述します。 プロジェクトは現在1.0未満であり、v0.3.0が最新リリースです。レビュー、説明、オンボーディング、イベントフィードバック、マネージドホストのアクティベーション契約はv0.4.0候補に割り当てられており、リリースゲートを通過した後に公開されます。サポート状況として、チェック機能やその出力形式、init/status/migrate/hooks、パフォーマンスレポートはv0.3.0およびv0.4.0候補でサポートされています。一方、レビュー、doctor、説明、エージェント関連のライフサイクルコマンド、Markdown/リンク/参照/ガイダンスチェック、監視/キャッシュ/デーモン/セッションはv0.4.0候補の機能です。assura info、Markdownの安全な修正、ファーストパーティ拡張ポリシーファミリーは実験的段階にあり、ホスト型ダッシュボード、自動広域修復、リモートプラグイン読み込み、プラグインマーケットプレイス、エージェントごとの検証エンジンはサポート対象外です。 リリースはタグ駆動型で、バージョンとノートの更新、リリース候補ゲートの通過、アノテーション付きv*タグのプッシュを経て、Linux/macOS/Windowsのアーカイブがチェックサム付きでビルドされます。開発には階層化されたcargo xtaskコマンド(fast, pr, release-size, release-smoke, release-live, full)を使用し、パフォーマンスはLS-Lintとの比較を含むcargoベンチマークで追跡されます。ドキュメントには、導入ガイド、設定、CLI/APIリファレンス、サポートポリシー、リリースノート、貢献方法、セキュリティ情報が含まれています。