agent/docs/known-issues.md
Snider 40d2b0db16
Some checks failed
CI / test (push) Failing after 2s
fix: address Codex round 7 — path traversal + dispatch check
High/Security: sanitise input.Repo via filepath.Base to prevent
path traversal in workspace prep (../escape from CODE_PATH).

High/Security: sanitise repo.Repo from API response in syncRepos
to prevent path traversal via crafted checkin responses.

Medium: dispatchFixFromQueue now returns error, review_queue checks
success before recording fix_dispatched.

Known issues updated with async bridge provider findings.

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

1.8 KiB

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:134remember drops confidence, supersedes, expires_in from RememberInput. Standalone clients can't set persistence metadata.
  • direct.go:153recall never forwards filter.min_confidence. Direct-mode recall can't apply confidence cutoff.
  • direct.go:177recall drops API-returned tags, only synthesises source:*. Callers lose real memory tags.
  • provider.go:303list 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