v0.15.0
Highlights
Holon v0.15.0 is a major release: 85 commits, 215 files changed. The core themes are API/CLI Contract Stabilization and Runtime Model Refinement.
API & CLI Contract Stabilization
- Introduced OpenAPI Schema baseline with generated and snapshotted HTTP route manifest
- Established CLI contract snapshot system: CLI/API contract manifest, stability policy, exit code contract, control-plane JSON output normalization
- Hardened HTTP error envelope contract and success response shapes
- New CLI subcommands: WorkItem inspection, Task lifecycle, Stable Event
- Exposed WorkItem/Wait/Timer lifecycle HTTP endpoints
Runtime Core Model
- Unified Runtime ID generation strategy, allocated ledger sequence field, preserved ID entropy
- Cleaned up Trust/Authority model: removed transitional TrustLevel, unified under authority_class; backward-compatible MessageEnvelope deserialization
- Agent lifecycle alignment: hardened WaitFor runtime contract, removed blocking task wait policy
- Cross-WorkItem TaskResult downgraded to background notification, preventing duplicate completion pushes
- Text-only turn tight-loop fix; Sleep tool hidden from agent
Tool Surface Improvements
- ExecCommandBatch schema cleanup + MemoryGet cross-workspace lookup fix
- ApplyPatch diff path semantics clarification
- Tool Surface Layering RFC, aligning model-side tool contracts
Daemon Reliability
- daemon stop uses recorded runtime address, preventing accidental kill of unrelated processes
- daemon status no longer returns orphaned state for stopped daemons
- Always binds localhost listener, guarding daemon socket lifecycle
- probe_runtime correctly reports Running when socket is absent but PID is alive
WorkItem & Scheduler
- WorkItem HTTP mutation endpoint: objective/plan_status/todo_list updatable via API
- wait-for WorkItem contract: WaitFor linked with WorkItem blocked state
- Timer cancellation lifecycle endpoint
Docs & RFCs
- Three new RFCs: Runtime ID/Sequence, Visual Observation, Tool Surface Layering
- Runtime spec restructured as an aggregate index page
- Fixed docgen tool and 40 broken links on the docs site
Installation
Homebrew:
brew tap holon-run/tap
brew install holonDirect download:
curl -L "https://github.com/holon-run/holon/releases/download/v0.15.0/holon-linux-amd64.tar.gz" | tar -xz
chmod +x holon
./holon --helpFor macOS, replace holon-linux-amd64.tar.gz with holon-darwin-amd64.tar.gz or holon-darwin-arm64.tar.gz.