Skip to content

fix(context): review follow-ups — resilience, sanitize, truncation, docs#11

Merged
casabre merged 1 commit into
mainfrom
fix/review-followups
Jul 4, 2026
Merged

fix(context): review follow-ups — resilience, sanitize, truncation, docs#11
casabre merged 1 commit into
mainfrom
fix/review-followups

Conversation

@casabre

@casabre casabre commented Jul 4, 2026

Copy link
Copy Markdown
Owner

Addresses the follow-up review findings on the §0.1 context plane.

# Finding Action
3 _symbols had no per-file error handling — one bad git show sank the whole pack try/catch per file; skip the bad file (matches _testCommand)
4 Sanitization covered conventions but not file paths / symbol names / test command sanitize() now applied to all interpolated repo strings
6 ContextPack.truncated was never surfaced rendered as a header note when true (+ test)
1 typescript promoted to a runtime dep (heaviest new prod dep) documented in deployment.md (image-size note)
2 Synchronous git show × N spawns strengthened the note (git cat-file --batch / worker-thread escalation) — deferred refactor
5 Cache-miss not single-flight moot while _build() is synchronous (no await between check/set); noted for the future async case

Also documented WORKSPACE_ENABLED + AGENT_ALLOWED_REPO_ROOTS in the config reference.

Gates

typecheck ✅ · lint ✅ · test:coverage ✅ (409 tests, 100%) · build ✅.

🤖 Generated with Claude Code

…runcation

Address follow-up review findings on the §0.1 context plane:

- Per-file resilience: a single unreadable source file (git show error) is now
  skipped instead of sinking the whole context pack — the symbol pass wraps
  extraction in try/catch, matching the convention-parsing behavior.
- Sanitize consistency: augmentTaskPrompt now strips the block-closing delimiter
  from file paths, symbol names, and the test command too — not just AGENTS.md/
  CLAUDE.md — so no injected repo string can break out of <workspace-context>.
- Surface truncation: ContextPack.truncated (always false today) is now rendered
  as a header note, so once truncation exists the agent is told the list is partial.
- Docs: note that WORKSPACE_ENABLED makes `typescript` a runtime dep (heaviest new
  prod dep) and that the symbol pass is synchronous (git cat-file --batch / worker
  thread is the escalation). Documented AGENT_ALLOWED_REPO_ROOTS + WORKSPACE_ENABLED.
- Noted single-flight is moot while _build() is synchronous (revisit if async).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@casabre casabre merged commit 1295fcb into main Jul 4, 2026
10 checks passed
@casabre casabre deleted the fix/review-followups branch July 4, 2026 20:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant