v0.1.0 — substrate complete
First public release. Three primitives shipped and validated end-to-end.
What's in v0.1.0
swarm_lib.claims— atomic-rename queue primitives (enqueue/try_claim/complete) backed by POSIXos.replace. Multiple workers race for tasks; exactly one wins.swarm_lib.status—status.jsoncheckpoint state with strict schema versioning, idempotentappend_completed, additive-mergewrite, freshinitialize.swarm_lib.cli—swarm-cliconsole entry point exposing all primitives for shell consumers. jq-friendly single-line JSON output.swarm_lib/worker_loop.sh— generic consumer loop that ties everything together. Polls a queue, claims atomically, invokes a user-supplied handler, marks done/failed.examples/seven-step-chain/— Tribunal-shaped reference consumer (driver + self-chaining handler) demonstrating the substrate against a real-world multi-step workflow.
What's validated
48 total smoke checks pass across the substrate:
- 14 unit-level (claims + status + claims↔status integration)
- 13 CLI + worker_loop end-to-end
- 21 seven-step chain (full Tribunal-shaped workflow runs to completion)
Site + docs
- Site: https://dpdanpittman.github.io/swarm-lib/ (will migrate to
mabus.ai/swarm/once the Caddy block lands) - Design spec:
DESIGN.md/DESIGN.html
Next: v0.2
- HMD triage layer (cheap-model classify → expensive-model escalation)
- Orphan cleanup daemon
- A real Tribunal port using this substrate (in the
dpdanpittman/tribunalrepo)