go/docs
Snider c847b5d274 feat(rfc): Pass Eight — type safety analysis, 50 hidden panic sites
CRITICAL: 79% of type assertions on Result.Value are bare (no comma-ok).
50 panic sites in core/go, ~100 in core/agent. Every r.Value.(string)
is a deferred panic that (string, error) would catch at compile time.

P8-1: 50/63 assertions bare — panic on wrong type
P8-2: Result is one type for everything — no compile-time safety
P8-3: Message/Query/Task all 'any' — no type routing
P8-4: Option.Value is 'any' — config becomes untyped bag
P8-5: ServiceFor returns (T,bool) not Result — Go generics limitation
P8-6: Fs validatePath returns Result then callers bare-assert string
P8-7: HandleIPCEvents wrong signature silently fails to register
P8-8: The Guardrail Paradox — Core trades compile-time safety for LOC

The fundamental tension: Result reduces LOC but every type assertion
is a deferred panic. Resolution: AX-7 Ugly tests + typed convenience
methods + accept that Result is a runtime contract.

Eight passes, 64 findings, RFC at 2,930+ lines.

Co-Authored-By: Virgil <virgil@lethean.io>
2026-03-25 12:56:29 +00:00
..
pkg docs: rewrite documentation suite against AX spec 2026-03-21 10:05:04 +00:00
plans docs: remove implemented plans, annotate partial ones 2026-03-14 08:09:20 +00:00
commands.md docs: rewrite documentation suite against AX spec 2026-03-21 10:05:04 +00:00
configuration.md docs: rewrite documentation suite against AX spec 2026-03-21 10:05:04 +00:00
errors.md docs: rewrite documentation suite against AX spec 2026-03-21 10:05:04 +00:00
getting-started.md docs: rewrite documentation suite against AX spec 2026-03-21 10:05:04 +00:00
index.md docs: rewrite documentation suite against AX spec 2026-03-21 10:05:04 +00:00
lifecycle.md docs: rewrite documentation suite against AX spec 2026-03-21 10:05:04 +00:00
messaging.md docs: rewrite documentation suite against AX spec 2026-03-21 10:05:04 +00:00
primitives.md docs: rewrite documentation suite against AX spec 2026-03-21 10:05:04 +00:00
RFC.md feat(rfc): Pass Eight — type safety analysis, 50 hidden panic sites 2026-03-25 12:56:29 +00:00
services.md docs: rewrite documentation suite against AX spec 2026-03-21 10:05:04 +00:00
subsystems.md docs: rewrite documentation suite against AX spec 2026-03-21 10:05:04 +00:00
testing.md docs: rewrite documentation suite against AX spec 2026-03-21 10:05:04 +00:00