Skip to content

feat(context): token-efficient symbols overview fast-path (closes #254) - #264

Merged
Wolfvin merged 1 commit into
mainfrom
feat/issue-254-symbols-overview
Jul 13, 2026
Merged

feat(context): token-efficient symbols overview fast-path (closes #254)#264
Wolfvin merged 1 commit into
mainfrom
feat/issue-254-symbols-overview

Conversation

@Wolfvin

@Wolfvin Wolfvin commented Jul 13, 2026

Copy link
Copy Markdown
Owner

Summary

  • Adds `context --check overview` — queries `graph_nodes` directly (no re-parse, no LSP) and returns compact per-file symbol map (name + kind + line)
  • Workspace-wide in 1 call vs outline --all paginating 20 files/call
  • Supports `--file` filter for per-file mode and `--max-files` cap (default 200)

Patch Peta

  • `scripts/commands/symbols_overview.py` (new) — sqlite3 query on graph_nodes, groups by file, filters noise kinds
  • `scripts/commands/context.py` — registered `overview` in `_CHECKS`, namespace branch, epilog updated
  • `tests/test_command_registry.py` — symbols_overview added to allowlist
  • `tests/test_symbols_overview.py` (new) — 6 tests
  • `docs/design/0254-symbols-overview.md` (new)

Testing

  • 6 unit tests: no-registry graceful degradation, grouping, file filter, noise exclusion, truncation, no-reparse invariant
  • End-to-end verified: `codelens context .. --check overview` → 200 files, 2054 symbols
  • Per-file: 1100 chars vs outline 1600 chars (31% smaller); workspace: 1 call covers 200 files

Closes #254

@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

@Wolfvin
Wolfvin merged commit 1d99322 into main Jul 13, 2026
1 of 7 checks passed
@sonarqubecloud

Copy link
Copy Markdown

@Wolfvin
Wolfvin deleted the feat/issue-254-symbols-overview branch July 13, 2026 10:51
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.

feat(context): token-efficient hierarchical symbols-overview fast-path (like Serena get_symbols_overview)

1 participant