コントリビューション

バグの報告

バグは GitHub の Issue トラッカーに報告してください。Sinter のバージョン（sinter --version）、コントローラとターゲットの OS、問題を再現する最小の recipe とコマンドライン、出力（--verbose や --format json が役立ちます）を含めてください。実際のホスト名、認証情報、鍵、トークンはプレースホルダに置き換えてください。

セキュリティ脆弱性の報告

脆弱性の疑いがある問題を公開 Issue に書かないでください。 GitHub のプライベート脆弱性報告から非公開で報告してください。詳細は SECURITY.md を参照してください。

変更の提案

小さな修正を超える変更は、実装する前に Issue を開いて方針を合意してください。変更は main に対する pull request として提出してください。提出する前に:

品質ゲートを実行し、動作を変える変更にはテストを含めてください。
ドキュメントを変更した場合は、docs-site/ で npm run check、 npm run webmcp:check、npm run build を実行してください（ドキュメントを参照）。

ビルド

cargo build --release

品質ゲート

リリースで使われるローカルのゲート一式:

cargo fmt --check
cargo clippy --locked --all-targets --all-features -- -D warnings
cargo test --locked
git diff --check

継続的インテグレーション

push と pull request のたびに、2 つの GitHub Actions ワークフローが実行されます。

CI は、ルートの crate と gateway/ のフォーマットと clippy を確認し、ルートのテストバイナリをビルドだけして（実行はしません）、gateway のテスト、インストーラとリリースチェッカーのテストを実行します。いずれも実行するマシンを変更しません。
Dependency advisories は、Cargo.lock と gateway/Cargo.lock を OSV.dev と照合します。OSV.dev には GitHub がレビューした advisory と RustSec の advisory が含まれます。依存関係が変わらなくても新しい advisory に気付けるよう、毎週も実行されます。Dependabot alerts もリポジトリを監視しています。

これらのチェックが報告するのは、各データベースで公開済みの advisory だけで、バージョン範囲もデータベースの記録どおりです。データベースには反映の遅れや、範囲の記録漏れがあり得ます。失敗した実行は、後続のコミットで修正します。テストは自動では再試行しません。CI は RELEASE.md のリリースゲートやターゲットでの受け入れ検証の代わりにはなりません。

ルートのテストスイート（リポジトリ直下での cargo test）は、CI ではなくリリースゲートで実行します。パスワードなしの sudo が使える環境では、一部のテストが実行するマシン自体を変更します（apt パッケージのインストールと削除、systemd ユニットの作成、ホストの SSH サービスの有効化と再起動）。専用の使い捨て Linux マシンでだけ実行してください。

advisory の例外は、lockfile と同じディレクトリの osv-scanner.toml に、理由と期限（ignoreUntil。その日付以降は実行が失敗します）を付けて記録します。現在の例外は、gateway のテストだけが使う依存 rsa に対する RUSTSEC-2023-0071 の 1 件だけです。rsa が gateway の normal または build の依存グラフに入ると、ワークフローは失敗します。

GitHub は、公開リポジトリで 60 日間活動がないと、スケジュール実行のワークフローを無効にします。その間は Dependabot alerts だけが監視を続けます。

テスト構成

スイート	範囲
lib ユニットテスト	値モデル、フロントエンド、式、パス、argv クォート
`frontends`	YAML/TOML 等価性、スキーマ拒否、include
`engine`	file/dir/link/template、plan の安全性、冪等性、fail-fast
`commands`	ガード、register、changed_when、環境ベースライン、終了コード
`handlers`	遅延ハンドラ、重複排除、検証ゲート
`package_service`	apt/dnf インストール/削除/冪等性、systemd の状態
`file_safety`	信頼境界、シンボリックリンク拒否、アトミック公開
`truthfulness`	結果次元のマトリクス
`cli`	終了コード、JSON 出力、sensitive マスク
`ssh`	実際の SSH 統合テスト（環境変数でゲート）

SSH 統合テストには使い捨ての Ubuntu ターゲットが必要です:

export SINTER_TEST_SSH_HOST=127.0.0.1
export SINTER_TEST_SSH_PORT=22
export SINTER_TEST_SSH_USER=ubuntu
export SINTER_TEST_SSH_KNOWN_HOSTS=/path/to/known_hosts
export SINTER_TEST_SSH_IDENTITY=/path/to/test_key
cargo test --test ssh

ドキュメント

このサイトは docs-site/（Astro + Starlight）にあります:

cd docs-site
npm ci
npm run dev      # ローカル開発サーバ
npm run build    # dist/ への静的ビルド

ドキュメントと WebMCP ツールで共有されるリソースメタデータは src/data/resources.json にあります。リソースパラメータを変更したときは更新してください。日本語の説明文は src/data/resources.ja.json で、同じリソースタイプとパラメータ名をキーにオーバーレイされます。

リリース

リリース手順: リポジトリの RELEASE.mdを参照してください。