agent/docs
Snider 9628e5d088 feat(agent/brain): non-Laravel callers route through shared OpenBrain client (#121)
Audit + remediation pass on non-Laravel Brain callers per #121.

docs/brain-callers-audit.md (NEW): audit baseline. Lists every PHP +
Go + script call site, current protections (org auth, retry, circuit
breaker), and gaps. Cross-references recent fixes (#312, #998, #1052,
#1055, #1006, #985).

New pkg/agentic/brain_client.go helper: routes Go callers through
the shared OpenBrain client path with org injection (CORE_BRAIN_ORG
fallback) and a shared circuit breaker.

Patched call sites:
- pkg/agentic/prep.go (line ~1200)
- pkg/agentic/session.go (line ~826)
- pkg/agentic/brain_seed_memory.go (line ~153)
- pkg/brain/direct.go (line ~106)

These previously made raw Brain HTTP posts. Now they go through the
hardened client path inheriting #998 (key-perm), #1052 (bearer SSRF
guard), #1055 (jitter), and the circuit breaker.

Remaining non-Laravel gaps (documented in audit doc, not patched here
because they're outside this lane's path-allowlist):
- core/mcp/pkg/mcp/agentic/prep.go
- Hermes Python plugins
- Claude shell hooks
- plugins/core-go api-endpoints SKILL example

Follow-up tickets needed for those (file separately).

Co-authored-by: Codex <noreply@openai.com>
Closes tasks.lthn.sh/view.php?id=121
2026-04-25 20:33:33 +01:00
..
audits test(agentic): add HTTPS cert regression tests + fleet sync audit 2026-04-23 18:40:02 +01:00
flow revert fcb9c189e5 2026-04-23 12:32:57 +01:00
php-agent docs(openbrain): deprecate stale per-repo RFCs, redirect to authoritative spec 2026-04-23 18:40:10 +01:00
plans revert fcb9c189e5 2026-04-23 12:32:57 +01:00
plugins revert fcb9c189e5 2026-04-23 12:32:57 +01:00
reviews revert fcb9c189e5 2026-04-23 12:32:57 +01:00
.DS_Store revert fcb9c189e5 2026-04-23 12:32:57 +01:00
architecture.md revert fcb9c189e5 2026-04-23 12:32:57 +01:00
AUDIT-openbrain-20260424.md docs(openbrain): alignment audit 2026-04-24 — PARTIAL verdict 2026-04-24 05:36:59 +01:00
brain-callers-audit.md feat(agent/brain): non-Laravel callers route through shared OpenBrain client (#121) 2026-04-25 20:33:33 +01:00
CHARON-ONBOARDING.md revert fcb9c189e5 2026-04-23 12:32:57 +01:00
development.md revert fcb9c189e5 2026-04-23 12:32:57 +01:00
github-app-setup.md revert fcb9c189e5 2026-04-23 12:32:57 +01:00
index.md revert fcb9c189e5 2026-04-23 12:32:57 +01:00
known-issues.md revert fcb9c189e5 2026-04-23 12:32:57 +01:00
RFC-AGENT-INDEX.md revert fcb9c189e5 2026-04-23 12:32:57 +01:00
RFC-AGENT-PIPELINE.md revert fcb9c189e5 2026-04-23 12:32:57 +01:00
RFC-AGENT-PLAN.md revert fcb9c189e5 2026-04-23 12:32:57 +01:00
RFC-AGENT-PLUGIN-RESTRUCTURE.md feat(plugins): scaffold core-go/core-php/infra plugin directories 2026-04-23 18:21:40 +01:00
RFC-AGENT-TOPOLOGY.md revert fcb9c189e5 2026-04-23 12:32:57 +01:00
RFC-AGENT.md revert fcb9c189e5 2026-04-23 12:32:57 +01:00
RFC-CORE-008-AGENT-EXPERIENCE.md revert fcb9c189e5 2026-04-23 12:32:57 +01:00
RFC-GO-AGENT-COMMANDS.md revert fcb9c189e5 2026-04-23 12:32:57 +01:00
RFC-GO-AGENT-IMPORTS.md revert fcb9c189e5 2026-04-23 12:32:57 +01:00
RFC-GO-AGENT-MODELS.md revert fcb9c189e5 2026-04-23 12:32:57 +01:00
RFC-GO-AGENT-README.md revert fcb9c189e5 2026-04-23 12:32:57 +01:00
RFC-GO-AGENT.md revert fcb9c189e5 2026-04-23 12:32:57 +01:00
RFC.md revert fcb9c189e5 2026-04-23 12:32:57 +01:00
RFC.plan.md revert fcb9c189e5 2026-04-23 12:32:57 +01:00