Deterministic AST-to-graph prototype for Agentic Hierarchical GraphRAG
GraphCode provides 22 tools with consistent naming (verb_noun pattern) and reasonable descriptions (avg ~120 chars). All tools have input schemas with typed parameters and descriptions. However, output schemas are not documented in the source code provided, and error handling guidance is absent. Tool descriptions lack WHEN/WHY context needed for LLM selection (pattern:tool-description). No tool annotations (readOnlyHint, destructiveHint) despite all tools being READ_ONLY. Parameter descriptions are minimal (avg ~40 chars) and lack format/constraint details. Legacy aliases (list_orbits, zoom_in) add cognitive load without clear deprecation guidance.
Bootstrap-only helper that turns rough hints into candidate anchors.
Tell you which side or boundary of the flow to inspect first.
Return a focused group-level slice with frontier spillover.
Materialize the shortlist of nodes, files, and bridges around one structural corridor.
Expand a raw neighborhood from frontier nodes.
Return one shortest raw path.
Return multiple raw candidate paths.
Output schemas not documented. LLMs cannot plan downstream calls or extract required fields without knowing response structure. All 22 tools lack documented return types.
No tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite all tools being READ_ONLY. Agents cannot distinguish safe tools from destructive ones without explicit hints.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 56 | 2026-07-28+ | v2 |
Quickly judge whether a structural path exists and how risky or weak it looks.
Focus one macro group and surface its hotspots, files, and local structure for the next inspection step.
Fallback snippet reader for environments where Serena or another code navigator is unavailable.
Fetch a bounded neighborhood around a seed node or group.
Return the denser upstream/downstream/scope slice around one seed.
Summarize the likely blast radius around one node or file location before you open concrete code.
List macro groups with representative paths and counts after you open a large or unfamiliar workspace.
Legacy alias for list_groups. List macro groups with representative paths and counts after you open a large or unfamiliar workspace.
Resolve the cross-group path between source and target before looking at file-level detail.
Open a new project by mapping major groups, subsystems, and cross-group links.
Legacy context bundle builder for end-to-end LLM workflows.
Legacy compact summary of prepare_context.
Set the workspace repository path and optional graph path for subsequent tool calls.
Return the recommended GraphCode workflows, tool tiers, and deprecated surfaces.
Legacy alias for focus_group. Focus one macro group and surface its hotspots, files, and local structure for the next inspection step.
Legacy aliases (list_orbits, zoom_in) create cognitive load and duplicate tool slots. Deprecation path unclear, no guidance on when aliases will be removed or which name to prefer in new code.
Parameter descriptions are minimal (avg ~40 chars) and lack format/constraint details. E.g., 'repo_path' lacks guidance on absolute vs relative paths, symlink handling, or validation rules.
No error handling guidance. Tools lack recovery hints (e.g., 'If repo_path is invalid, call set_workspace() first'). LLMs cannot self-correct on failures.