docs(P02): CLI reference + jobspec reference + ingress guide

P02 — operator-facing documentation (REQ-091, REQ-092, REQ-093; gate C-22).

docs/cli.md (REQ-091):
- Full CLI command/flag reference: every command/subcommand with synopsis,
  flag tables (name/type/default/description), one-line examples.
- Global flags (--json, --system, --config, --no-deprecation-warnings).
- Output modes (text/json/watch), env vars, exit codes.
- Deprecated surface callout boxes (daemon, cert, node-join-mTLS, HCL
  jobspec) pointing to v0.11 removal.

docs/jobspec.md (REQ-092):
- Markdown frontmatter schema reference: all top-level keys, block
  reference (runtime/ports/env-secrets/volumes/restart/update/service/
  health/lifecycle/constraints/affinity/tasks), kinds matrix
  (Job/Service/DaemonSet required vs allowed), CEL subset grammar, body
  byte-exact preservation (R-015), deprecated HCL callout.

docs/ingress.md (REQ-093):
- Traefik ingress reference: service->Traefik mapping (D-175), R-007
  socket-vs-TCP-bind semantics, generated YAML shape (routers/services/
  healthCheck), atomic reload (C-10), drain (weight:0), TLS (certResolver,
  trust domain, step-ca), worked-example pointer to examples/full-stack/,
  v0.11 forward limitations.

All factual claims grounded in live codebase (gate C-22). Cross-links
verified to resolve.

---ci---
project: orca
phase: 2
milestone: v0.10
status: execute
---/ci---
This commit is contained in:
Jon Chery
2026-08-05 20:57:05 +00:00
parent cfec794bb7
commit 289e5cf6e1
4 changed files with 1178 additions and 5 deletions
+5 -5
View File
@@ -1,20 +1,20 @@
{
"phase": 1,
"stage": "verify",
"phase": 2,
"stage": "execute",
"milestone": "v0.10",
"milestone_slug": "docs-cli-examples",
"phase_role": "execution",
"attempts": 0,
"updated_at": "2026-08-05T20:30:00Z",
"updated_at": "2026-08-05T20:45:00Z",
"milestone_complete": false,
"ship": {
"tag": "v0.9.0",
"tag": "v0.9.1",
"merged_to_main": false,
"milestone_branch_deleted": false,
"all_phase_branches_deleted": true
},
"requirements": {
"covered": [],
"covered": ["REQ-097", "REQ-098"],
"partial": []
},
"gates": {