dracondev/dracon-utilitiesDracon 開発者ワークスペースのための不可視インフラストラクチャ: git 同期、システムガード、および warden 暗号化ユーティリティ。
Linux 開発マシンの面倒を見る 3 つの小さな Rust CLI ツールです。1 つは git リポジトリをコミット済み・バックアップ済みの状態に保ち、1 つはディスクとメモリの破綻を防ぎ、もう 1 つはシークレットが git 履歴に紛れ込むのを防ぎます。これらは通常のユーザーレベルの systemd サービスとして動作します — root は不要です。
| ツール | 解決する問題 | 一言で言うと |
|---|---|---|
dracon-sync | 「一日中ファイルを編集したのに一度もコミットしなかった。」 | リポジトリを監視し、決定論的なメッセージで変更を自動コミットし、GitHub/GitLab/その他へプッシュします |
dracon-system | 「ビルド中にディスクが満杯になり、すべてがフリーズした。」 | ディスクとメモリのプレッシャーを監視し、既知の容量浪費要因をクリーンアップし、ストレージの問題を診断します |
dracon-warden | 「API キーを GitHub にプッシュしかけた。」 | シークレットらしきファイルを透過的に暗号化（age）し、git 上では安全な状態で保存しつつ、エディタでは平文で扱えるようにします |
ここにあるものはすべてパスで結ばれた 1 つの Cargo ワークスペースです。リポジトリルートで cargo test --workspace --locked を実行すると 3 つすべてがビルド・テストされます（2026-10-10 時点で 2347 テスト、失敗 0、無視 25）。3 つのユーティリティディレクトリはネストされた独立した git リポジトリです（独自の .git/、履歴、リモート、および 2026-09-11 以降のタグを持ち、親はメタファイルのみを追跡します）。そのため親だけを bare クローンしてもビルドできません。ユーティリティリポジトリをその隣にクローンしてください（CONTRIBUTING の Setup を参照）。
git clone https://github.com/DraconDev/dracon-utilities.git
cd dracon-utilities
# nested utility repos (see CONTRIBUTING for the clone list)
git clone https://github.com/DraconDev/dracon-sync-background-auto-commit-multi-remote.git dracon-sync
git clone https://github.com/DraconDev/dracon-system-disk-process-guard-doctor.git dracon-system
git clone https://github.com/DraconDev/dracon-warden-secret-encrypt-age-git-filter.git dracon-warden
cargo build --release --locked
./target/release/dracon-system doctor # health check of this machine
./target/release/dracon-sync status # what sync would watch
./install.sh # binaries -> ~/.local/bin
systemctl --user enable --now dracon-sync.service # background auto-commit
systemctl --user enable --now dracon-system-guard.service # background guard
./uninstall.sh # remove binaries and services (configs kept unless --purge)
`install.sh` stops the services while it works, refreshes the user
service units from the repo, installs the warden git hooks globally,
and restarts the services afterwards (see `./install.sh --help`;
`--no-restart` and `--binaries-only` opt out of parts of this).
dracon-warden はサービスではありません。インストール後に一度 dracon-warden setup-hooks --global を実行して git フックを有効化し、次に dracon-warden keygen を実行してそのマシンの age 鍵ペアを作成します。
その後、各ツールは ~/.dracon/utilities/ から自身の TOML 設定を読み込みます（サンプルは各ツールのディレクトリに同梱されています）。git で追跡されるものは決してリポジトリツリーの外には存在しません。状態は ~/.dracon/ と ~/.local/state/dracon/ に保存されます。
dracon-syncあなたが作業し、それがコミットします。監視ルート（例えば ~/Dev）を指定すると、その配下にあるすべての git リポジトリを検出し、編集が落ち着くのを待ち、決定論的な差分ベースのメッセージでコミットし、origin および設定されたすべてのミラーへプッシュします。プッシュの失敗を（STUCK/BLOCKED/BROKEN に）分類し、永遠に黙ってリトライし続けることはせず、ディスクから消えたリポジトリをフラグ立てします。
dracon-sync daemon # continuous loop (what the service runs)
dracon-sync repos # live report of every watched repo
dracon-sync sync-now ~/Dev/my-project
dracon-sync health
dracon-systemマシン自体のためのウォッチドッグです。ディスクやメモリの負荷が警告/危険のしきい値を超えると、再生成可能な不要物（ビルドディレクトリ、キャッシュ）をクリーンアップし、メモリを大量に消費するプロセスの優先度を下げてデスクトップの応答性を保ち、カーネルの out-of-memory killer を実際の原因プロセスに誘導することができます。さらに、ストレージのホットスポット、シンボリックリンク管理、zram の状態といったワンショット診断も行います。
dracon-system doctor # deterministic diagnostics pass
dracon-system storage ~/Dev # where did my disk go?
dracon-system guard clean # reclaim space (dry-run first)
dracon-system guard daemon # continuous monitoring (the service)
dracon-wardenage を使用した Git フィルタベースの暗号化。
シークレットパターン（.env、*.key など）に一致するファイルは
コミット時に暗号化され、チェックアウト時に復号されるため、リモートには
暗号文のみが保持され、作業ツリーは通常の状態に保たれます。
グローバルフックがこれを補完し、すべてのプッシュをスキャンして
シークレット形式のコンテンツを検出し、危険なものをブロックします。
dracon-warden keygen # machine age keypair
dracon-warden setup-hooks --global
dracon-warden status # what's protected on this machine
dracon-utilities/
├── dracon-sync/ # auto-commit multi-remote git sync daemon
├── dracon-system/ # disk/process guard, storage & diagnostics
├── dracon-warden/ # age-based git secret encryption (hooks + CLI)
│ └── src/security/ # embedded dracon-security crate
├── .github/workflows/ci.yml # lint / test / release-build / deny / nix
├── flake.nix # optional Nix build path
├── scripts/ # release, checks, audit tooling
└── AGENTS.md # policies for agents/operators working here
export DRACON_SYNC_GIT_BIN=/run/current-system/sw/bin/git # NixOS only
cargo test --workspace --locked
cargo clippy --workspace --locked -- -D warnings
cargo deny check
nix flake check # optional
ツールごとのビルド: cargo build --release --locked -p dracon-{sync,system,warden}。
最新のコンポーネントリリース: dracon-sync 0.113.95 · dracon-system 0.112.44 ·
dracon-warden 0.113.15 — 詳細は
Releases を参照してください。
ユーティリティのリリースはネストされたリポジトリ内でタグ付けされており（dracon-sync-vX.Y.Z など）、
ツールごとの詳細は各ディレクトリの CHANGELOG.md に記載されています。親リポジトリの
CHANGELOG.md は凍結された履歴記録です。
履歴に関する注記: 各ユーティリティはもともとそれぞれ独自のリポジトリに存在していました （
DraconDev/dracon-sync-background-auto-commit-multi-remote、...-disk-process-guard-doctor、...-secret-encrypt-age-git-filter）。 開発は、これらの同じリポジトリのネストされたスタンドアロンチェックアウトで行われ、 それらはこのメタリポジトリの隣にクローンされます（親リポジトリはユーティリティのソースを追跡していません）。
docs/ROADMAP.md が唯一のドキュメントマップです — インストール、運用、コントリビューション、セキュリティ、バージョン履歴については そこから始めてください。長期的な設計調査は docs/README.md（設計インデックス）に別途索引化されています。
AGPL-3.0-only — 詳細は LICENSE を参照してください。