Dracon System

Disk, process, guard, doctor — local machine diagnostics and watchdog for Dracon workspaces.

This repository is the canonical "main" for dracon-system on GitHub, GitLab, and Codeberg. It contains the actual source code (mirrored from the DraconDev/dracon-utilities monorepo), the Cargo.toml, tests, examples, and the per-utility README. You can build and install this utility directly from this repo.

Quick start (standalone build)

# Clone this repo
git clone https://github.com/DraconDev/dracon-system-disk-process-guard-doctor.git
cd dracon-system-disk-process-guard-doctor

# Clone required siblings (path-dep layout)
git clone https://github.com/DraconDev/dracon-libs.git ../dracon-libs



# Build
cargo build --release

# Install (binary lands in target/release/)
sudo cp target/release/dracon-system /usr/local/bin/

What is in this repo

• src/ — utility source code
• tests/ — integration tests (if present)
• Cargo.toml — standalone build manifest with path-dep siblings
• README.md — this file (the per-utility README from the monorepo is at monorepo-README.md)
• BLUEPRINT.md — design notes
• dracon-system.example.toml — example config
• dracon-system-guard.service — systemd user-service unit
• LICENSE, SECURITY.md, .gitignore, .github/ — repo metadata
• docs/SOURCE_OF_TRUTH.md — architecture + invariants

Relationship to the monorepo

Why this name?

The descriptive name is a deliberate choice for Codeberg/Forgejo, where descriptive repo names get upvotes and free attention because readers immediately know what the project does. The full word list (no fillers, no audience/UX claims) is documented in docs/design/github-feature-repos.md.

Purpose

Protects machines from disk/process pressure and provides deterministic diagnostics for storage, links, zram, events, and the guard daemon.

Runtime

• Binary: dracon-system
• Service: dracon-system-guard.service
• Example policy: dracon-system/dracon-system.example.toml
• Common commands: dracon-system status · dracon-system doctor · dracon-system storage · dracon-system guard daemon

Maintenance

When the monorepo changes the utility source code, README, or example config, the monorepo's post-commit hook calls scripts/regenerate_facade_repos.py which mirrors the changes to this repo. The dracon-sync daemon picks up the local change in /home/dracon/Dev/facade-repos/dracon-system-disk-process-guard-doctor and auto-pushes to the 3 remotes (github, gitlab, codeberg). No manual --apply or --push-all-remotes invocation is needed in the normal flow.

License

AGPL-3.0-only — see LICENSE.