core/agent
8
0
Fork 0
Code Issues 5 Pull requests Projects Releases Packages Wiki Activity Actions
agent/docs/known-issues.md
Snider 6d28fc439b
Some checks failed
CI / test (push) Failing after 2s
Details
docs: update known-issues after 9 rounds of Codex review 
77+ findings across 9 rounds, 73+ fixed. False positive rate
climbing in round 9 — codebase is converging.

Co-Authored-By: Virgil <virgil@lethean.io>
2026-03-21 17:57:55 +00:00

1.9 KiB
Raw Blame History

Known Issues — core/agent

Accepted issues from 7 rounds of Codex review. These are acknowledged trade-offs or enhancement requests, not bugs.

API Enhancements (brain/direct.go)

  • direct.go:134 — remember drops confidence, supersedes, expires_in from RememberInput. Standalone clients can't set persistence metadata.
  • direct.go:153 — recall never forwards filter.min_confidence. Direct-mode recall can't apply confidence cutoff.
  • direct.go:177 — recall drops API-returned tags, only synthesises source:*. Callers lose real memory tags.
  • provider.go:303 — list forwards limit as query-string value instead of integer. REST path diverges from MCP contract.

Test Coverage Gaps

  • pkg/lib has no dedicated tests for template extraction or embedded prompt/task loading.
  • dispatch/review_queue/spawnAgent have no integration tests. Need test infrastructure for process mocking.
  • drainQueue complex logic has no unit tests with filesystem scaffolding.

Conventions

  • defaultBranch falls back to main/master when origin/HEAD unavailable. Acceptable — covers 99% of repos.
  • CODE_PATH interpreted differently by syncRepos (repo root) vs rest of tooling (CODE_PATH/core). Known inconsistency.

Async Bridge Returns (brain/provider.go)

  • provider.go:247 — recall HTTP handler forwards to bridge but returns empty RecallOutput. Results arrive async via WebSocket — by design for the IDE bridge path.
  • provider.go:297 — list HTTP handler same pattern. Only affects bridge-mode clients, not DirectSubsystem.

Compile Issues

  • pkg/setup doesn't compile — calls lib.RenderFile, lib.ListDirTemplates, lib.ExtractDir which don't exist yet. Package is not imported by anything.

Changelog

  • 2026-03-21: Created from 7 rounds of Codex static review
  • 2026-03-21: Updated after 9 total rounds (77+ findings, 73+ fixed, 4 false positives)