Files

T

Jon Chery aa3cccead5 feat(P01): CLI skeleton with Cobra, subcommand stubs, pre-push hook

Implements Phase 1 of v0.1 Foundation:
- go.mod with Go 1.25
- cmd/orca/main.go entry point
- internal/cli/root.go with global --json flag
- internal/cli/version.go (orca version)
- internal/cli/init.go (orca init - creates ~/.orca/)
- internal/cli/status.go (orca status - shows daemon info)
- internal/cli/node.go (orca node {join,leave,list} - stubs)
- internal/cli/job.go (orca job {run,list,stop,logs} - stubs)
- Makefile (build, test, lint, fmt, release)
- LICENSE (MIT)
- README.md with quickstart
- .gitignore
- .githooks/pre-push + scripts/trigger_coreci.sh (CoreCI trigger)
- Smoke tests in internal/cli/root_test.go

Verified: go build, go test, go vet, gofmt all pass.

---ci---
project: orca
phase: 1
milestone: v0.1
status: execute
req_covered:
  - REQ-001
  - REQ-002
  - REQ-013
  - REQ-015
  - REQ-016
  - REQ-019
  - REQ-024
---/ci---

2026-06-03 12:23:37 +00:00

1.6 KiB

Raw Blame History

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.

1.6 KiB Raw Blame History