docs(init): validate v0.7 specification — hardening & completion

---ci---
project: orca
phase: 0
milestone: v0.7
status: specify
---/ci---
This commit is contained in:
Jon Chery
2026-08-03 20:28:05 +00:00
parent 55d4d699a3
commit bd4a34daa2
5 changed files with 81 additions and 9 deletions
+43
View File
@@ -275,3 +275,46 @@ auto-resolved at full autonomy within the `clarify_budget`:
ExecStartPre or a config-management runbook.
- **D-037 Ed25519**: `golang.org/x/crypto/ssh` + `golang.org/x/crypto/ed25519`
are in the same module; no additional direct dep beyond D-030.
## v0.7 Scope Summary — Hardening & Completion
v0.7 is a 4-execution-phase **NFR milestone** that closes out gaps
surfaced by the v0.7 IDEATE stage: an unreachable command tree, a
missing config file layer, low test coverage in core packages, and the
long-deferred pprof endpoint. The engine functionality from v0.1v0.6
is unchanged; this milestone is purely about **correctness, coverage,
and operability**:
- **P01 — Register `orca cert` command tree + cert_repo tests.** The
`internal/cli/cert.go` command (`cert ca-init`, `cert gen`, `cert
show`, `cert renew`, `cert fingerprint`) is fully implemented but
never wired into `rootCmd`. This phase adds the missing
`rootCmd.AddCommand(newCertCmd(...))` and adds the missing
`internal/store/cert_repo_test.go`. Covers REQ-053.
- **P02 — HCL config file parsing (`config.hcl`).** D-009 specified
`~/.orca/config.hcl` and `/etc/orca/orca.hcl` as config locations,
but no HCL config-file parser exists — the CLI relies entirely on
flags and env vars. This phase adds a minimal `internal/config`
package that loads `config.hcl` (keys: `db_path`, `listen_addr`,
`ca_path`, `server_cert_path`, `server_key_path`, `node_capacity`),
merges with env/flag overrides (flag > env > file > default), and
surfaces it via `--config` flag on the root command. Covers
REQ-054.
- **P03 — Test coverage uplift.** Adds tests for the lowest-coverage
packages: `internal/engine` (executor, dispatcher, peer — currently
8.3%), `internal/transport` (mtls, dispatch, handshake_log —
currently 26.3%), `internal/proxmox` (bootstrap SSH path —
currently 5.1%), and `internal/audit` (no tests). Target: every
package ≥ 50% coverage. Covers REQ-055.
- **P04 — `--pprof` opt-in on `orca daemon`.** Adds the long-deferred
I-308 pprof endpoint behind an opt-in `--pprof <addr>` flag (default
disabled). `net/http/pprof` mounted on a separate mux so it never
touches the mTLS daemon listener. Covers REQ-056.
- **P05 — Final review + ship + audit.** Milestone release.
The vision ("minimalist, offline-first, CLI-first orchestration
engine") is unchanged. v0.7 is a hardening milestone, not a direction
change. Milestone type: NFR (all phases are fix/test/chore); the final
phase's progressive patch IS the deliverable per `run.md` versioning
logic. Tags run on the v0.5.x patch line: `v0.5.5` (P0) … `v0.5.9` (P05
= milestone release).