Skip to content

docs: refresh README for shipped entrypoint / diff / polyglot / API work#15

Merged
tob-scott-a merged 1 commit into
mainfrom
readme-refresh
Apr 23, 2026
Merged

docs: refresh README for shipped entrypoint / diff / polyglot / API work#15
tob-scott-a merged 1 commit into
mainfrom
readme-refresh

Conversation

@tob-scott-a

Copy link
Copy Markdown
Collaborator

The README had drifted during the recent feature sprint. This catches it up:

  • QueryEngine methods table now lists all 16 public methods, including the six added since the last README update (ancestors_of, reachable_from, entrypoint_paths_to, functions_that_raise, nodes_with_annotation, diff_against).
  • "Declaring entrypoints" section replaced with "Entrypoint detection", reflecting the four-layer detection that actually ships today (generic main + framework-aware + pyproject scripts + override file). Adds a coverage table listing the ~12 languages × 30+ frameworks currently detected, and a link to docs/entrypoint-patterns.md as the full spec for contributors adding new detectors.
  • Programmatic API example now showcases auto-language detection, transitive slicing, entrypoint-paths-to, functions_that_raise, and diff_against.
  • Normalized compact |---|---| table separators to | --- | --- | to stop the markdown-lint warnings that have been firing on every edit to this file.

Also updates tests/test_readme.py EXPECTED_METHODS to include the new QueryEngine methods so the regression guard actually catches drift in both directions going forward.

The README had drifted during the recent feature sprint. This catches
it up:

- QueryEngine methods table now lists all 16 public methods, including
  the six added since the last README update (ancestors_of,
  reachable_from, entrypoint_paths_to, functions_that_raise,
  nodes_with_annotation, diff_against).
- "Declaring entrypoints" section replaced with "Entrypoint detection",
  reflecting the four-layer detection that actually ships today
  (generic main + framework-aware + pyproject scripts + override file).
  Adds a coverage table listing the ~12 languages × 30+ frameworks
  currently detected, and a link to docs/entrypoint-patterns.md as the
  full spec for contributors adding new detectors.
- Programmatic API example now showcases auto-language detection,
  transitive slicing, entrypoint-paths-to, functions_that_raise, and
  diff_against.
- Normalized compact `|---|---|` table separators to `| --- | --- |`
  to stop the markdown-lint warnings that have been firing on every
  edit to this file.

Also updates tests/test_readme.py EXPECTED_METHODS to include the new
QueryEngine methods so the regression guard actually catches drift in
both directions going forward.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@tob-scott-a
tob-scott-a merged commit df04b98 into main Apr 23, 2026
13 checks passed
@tob-scott-a
tob-scott-a deleted the readme-refresh branch April 23, 2026 07:17
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