docs(governance): CI/CD Runner Architecture — local Mac Act runner doctrine #51

Merged
core-labs merged 1 commit from docs/ci-runner-doctrine into main 2026-07-16 20:17:27 +00:00

1 commit

Author SHA1 Message Date
Shay
fc38a6c7ee docs(governance): CI/CD Runner Architecture doctrine — local Mac Act runner
Some checks failed
lane-shas / verify pinned lane SHAs (pull_request) Successful in 3m15s
smoke / smoke (-m "not quarantine") (pull_request) Failing after 21m42s
Ports the runner-migration doctrine (authored by the Gemini session against
a stale checkout; grafted here onto current main so the #40-era Local-First
protocol section is preserved, not clobbered):

- CI jobs dispatch to a local Act runner on the primary developer's Mac
  (label ubuntu-latest:host = native macOS host execution; the ubuntu name
  is a fiction — no Linux-only steps).
- The GCP e2-micro server-side runner was REMOVED 2026-07-16; never
  re-provision it (1GB RAM, OOM class). A waiting queue while the Mac is
  asleep is intentional — pre-push local gates are the real discipline.
- Workflows remain canonical and install the locked universe (uv sync
  --locked, committed uv.lock). GitHub mirror Actions are billing-locked
  dead signals.
- CLAUDE.md gains a one-line pointer (policy stays in AGENTS.md).

[Verification]: smoke suite passed locally (175 passed); docs-only.
2026-07-16 10:31:57 -07:00