ciagent
efdbd2a61d
Phase 9 (P02) ships:
- orca.v1.Dispatch service mounted at /orca.v1.Dispatch/{Submit,Status}
- orca.v1.Dispatch/Submit honors X-Orca-Idempotency-Key (REQ-037)
- orca.v1.Dispatch/Status for cross-node job state queries
- 'orca node capacity {show,set,list}' for REQ-028
- 'orca job run --target <node-id>' and --idempotency-key flags
- Bin-packing by free CPU+memory; deterministic tie-breaking
- Retry with exponential backoff (100ms, x2, 5s cap, 5 attempts);
auto-retry only when idempotent verb or X-Orca-Idempotency-Key
- mTLS client (P01 wiring reused) for cross-node dispatch
Release pipeline: tagged v0.2.2 (per feature-milestone progressive
patch versioning); tarball built with -ldflags version injection
(v0.2.2 + commit 5755f12 + build time); published via tea releases
create to coreci/orca.
Coverage:
- REQ-004 (expansion, multi-node dispatch)
- REQ-017 (context.Context propagation through dispatcher)
- REQ-021 (os/exec with WaitDelay via engine.Executor)
- REQ-028 (NodeCapacity HCL schema persistence + CLI)
- REQ-037 (X-Orca-Idempotency-Key dedupe + retry gating)
---ci---
project: orca
phase: 9
milestone: v0.2
status: ship
version: v0.2.2
requirements:
covered: [REQ-004, REQ-017, REQ-021, REQ-028, REQ-037]
partial: []
---/ci---
Orca
Offline/CLI-first orchestration engine inspired by HashiCorp Nomad, far simpler than Kubernetes.
Status
v0.1: Foundation — see .ciagent/ROADMAP.md for the 6-phase plan.
Pillars
- Simplicity — single binary, minimal dependencies
- AI-first — CLI designed for both humans and AI agents
- Offline-first — no cloud dependencies
- CLI-first — primary interface is the command line
- Security before features — NFRs ship before new functionality
- Bug fixes before features — stability is paramount
- NFRs before features — observability and auditability first
Quickstart
# Build
make build
# Run
./bin/orca version
./bin/orca --help
# Initialize local state
./bin/orca init
Subcommands
| Command | Description | Status |
|---|---|---|
orca version |
Print version info | ✅ Phase 1 |
orca init |
Initialize local orca state | ✅ Phase 1 (stub) |
orca status |
Show orca daemon status | ✅ Phase 1 (stub) |
orca node |
Node management (join, leave, list) |
Phase 2 |
orca job |
Job management (run, list, stop, logs) |
Phase 3 |
Development
make build # Build binary to ./bin/orca
make test # Run tests with race detection
make lint # Run golangci-lint
make fmt # Format code
make release # Build + create Gitea release (Phase 6)
Architecture
See .ciagent/ARCHITECTURE.md for full architecture details.
License
MIT — see LICENSE.