query-codelisted

NOT for: $codemap-py:scan-codebase, $codemap-py:rename-refs, $codemap-py:test-impact. Test-impact split: one-off structural fact → `test-impact <target>` here; full workflow → $codemap-py:test-impact. ## Runtime note Codex exposes no plugin-root variable. Resolve the installed root as `PLUGIN_ROOT` once; shell state does not persist. ## Workflow Exact-file+symbol local edit: skip Codemap only with no unresolved caller/dependency/blast-radius/test-impact/import/source slice. Lifecycle boundary (callback/hook, cancellation/exception, scheduling/cleanup, state transfer): inspect source+named test/oracle; use `fn-rdeps` for caller or `fn-deps` for callee responsibility. Explicit structural/tool requirement overrides. Choose the smallest complete query set. | Need | Query | | --- | --- | | production module importers / blast radius | `rdeps <module> --exclude-tests` | | production centrality / highest in-degree | `central --top N --exclude-tests` | | internal-import coupling (not centrality) | `coupled --top N` | | direct production callers | `fn-rdeps <module::symbol> --exclude-tests` | | callers plus test-module importers | `fn-rdeps <module::symbol> --exclude-tests`, then `rdeps <module>` | | transitive callers / function blast | `fn-blast <module::symbol>` | | broken Sphinx cross-references | `xrefs --broken <module>` | Routing shortlist, not the parser's full surface; read `PLUGIN_ROOT/bin/codemap-py query --help`, never guess. Direct/every/all/production/blast-radiu