Ironloom

Ironloom is a Rust supervisor runtime for auditable autonomous engineering operations. It coordinates Discord operator commands, GitHub source-of-truth state, SonarCloud quality gates, worker execution, immutable artifacts, and k3s deployment through typed Rust crates.

Workspace

• crates/ironloom-runtime: deployable binary and health/readiness server.
• crates/ironloom-supervisor: process graph route selection and worker dispatch.
• crates/ironloom-discord: thread-aware operator adapter.
• crates/ironloom-github: GitHub source-of-truth projections.
• crates/ironloom-sonarcloud: SonarCloud bootstrap and quality contracts.
• crates/ironloom-storage: .ironloom filesystem-backed state.
• docs/site: mdBook public landing page, operator docs, and developer docs.
• docker/ironloom-runtime: runtime image.
• deploy/helm/ironloom: k3s-friendly Helm chart.

Validation

cargo fmt --check
cargo clippy --workspace --all-targets --all-features -- -D warnings
cargo test --workspace --all-features
cargo run -p ironloom-schemas -- --check
cargo deny check
cargo audit
mdbook build docs/site
helm lint deploy/helm/ironloom
helm template ironloom deploy/helm/ironloom

Runtime

Run the local health server:

IRONLOOM_BIND_ADDR=127.0.0.1:8080 \
IRONLOOM_PUBLIC_URL=https://ironloom.dev \
IRONLOOM_STATE_ROOT=/tmp/ironloom/.ironloom \
IRONLOOM_DISCORD_TOKEN=local-discord-token \
IRONLOOM_GITHUB_TOKEN=local-github-token \
IRONLOOM_SONARCLOUD_TOKEN=local-sonar-token \
cargo run -p ironloom-runtime --bin ironloom -- serve

Health endpoints:

• GET /healthz
• GET /readyz

Deployment

Build the runtime image:

docker build -f docker/ironloom-runtime/Dockerfile -t ironloom:local .

Render the chart:

helm template ironloom deploy/helm/ironloom