{"slug":"query-code-2","title":"query-code","summary":"Query Codemap.","platform":"Claude","tags":[],"authorName":"LLM Mart","authorSlug":"llm-mart","score":0,"source":"github","price":null,"verified":false,"createdAt":"2026-08-24T05:35:31.371098Z","repo":{"url":"https://github.com/Borda/AI-Rig","stars":27,"forks":4,"license":"Apache-2.0","updatedAt":"2026-09-23T12:41:42Z"},"bodyHtml":"<hr>\n<h2>name: query-code\ndescription: Query Codemap.</h2>\n<p>NOT for: $codemap-py:scan-codebase, $codemap-py:rename-refs, $codemap-py:test-impact.</p>\n<p>Test-impact split: one-off structural fact → <code>test-impact &lt;target&gt;</code> here; full workflow → $codemap-py:test-impact.</p>\n<h2>Runtime note</h2>\n<p>Codex exposes no plugin-root variable. Resolve the installed root as <code>PLUGIN_ROOT</code> once; shell state does not persist.</p>\n<h2>Workflow</h2>\n<p>Exact-file+symbol local edit: skip Codemap only with no unresolved caller/dependency/blast-radius/test-impact/import/source slice. A lifecycle boundary (callback/hook, cancellation/exception, scheduling/cleanup, state transfer) requires inspect source plus named test/oracle; use <code>fn-rdeps</code> for caller or <code>fn-deps</code> for callee responsibility. Explicit structural/tool requirement overrides. Choose the smallest complete query set.</p>\n<table>\n<thead>\n<tr>\n<th>Need</th>\n<th>Query</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>production module importers / blast radius</td>\n<td><code>rdeps &lt;module&gt; --exclude-tests</code></td>\n</tr>\n<tr>\n<td>production centrality / highest in-degree</td>\n<td><code>central --top N --exclude-tests</code></td>\n</tr>\n<tr>\n<td>internal-import coupling (not centrality)</td>\n<td><code>coupled --top N</code></td>\n</tr>\n<tr>\n<td>direct production callers</td>\n<td><code>fn-rdeps &lt;module::symbol&gt; --exclude-tests</code></td>\n</tr>\n<tr>\n<td>callers plus test-module importers</td>\n<td><code>fn-rdeps &lt;module::symbol&gt; --exclude-tests</code>, then <code>rdeps &lt;module&gt;</code></td>\n</tr>\n<tr>\n<td>transitive callers / function blast</td>\n<td><code>fn-blast &lt;module::symbol&gt;</code></td>\n</tr>\n<tr>\n<td>broken Sphinx cross-references</td>\n<td><code>xrefs --broken &lt;module&gt;</code></td>\n</tr>\n</tbody>\n</table>\n<p>Routing shortlist, not the parser's full surface; read <code>PLUGIN_ROOT/bin/codemap-py query --help</code>, never guess. Direct/every/all/production/blast-radius callers → <code>fn-rdeps &lt;module::symbol&gt; --exclude-tests</code>; <code>fn-blast &lt;module::symbol&gt;</code> only for explicit transitive, closure, hops, or all-levels requests. Query first; no unconditional pre-scan/freshness probe. Use <code>test-impact</code> for test choice, not direct test-module imports. Direct test-module imports: <code>rdeps &lt;module&gt;</code>; filter/report tests. <code>test-impact &lt;target&gt;</code> selects transitive affected tests.</p>\n<p><code>symbol &lt;name&gt;</code> accepts <code>authenticate</code> or <code>MyClass.method</code>; imports use <code>symbol &lt;name&gt; --with-imports</code>. <code>module::symbol</code> belongs to <code>fn-*</code> call-graph queries. Chain returned <code>module</code>+<code>qualified_name</code> → <code>&lt;module&gt;::&lt;qualified_name&gt;</code> (<code>mypackage.module::MyClass.method</code>). For a requested qualified extension method, query <code>symbol MyClass.add_feature</code>, not nearby <code>symbol MyClass</code>/<code>symbols &lt;module&gt;</code> listing.</p>\n<p><code>find-symbol '&lt;ClassSuffix&gt;\\.&lt;method&gt;$' --exclude-tests --limit 0</code> finds same-name override candidates; names are candidates, not inheritance proof—verify ancestry/package boundaries in source. Run each compact query alone: <code>PLUGIN_ROOT/bin/codemap-py query --compact &lt;subcommand&gt; [arguments]</code>.</p>\n<p><code>fn-blast</code>: never <code>--depth</code>; never invent flags. A complete, untruncated result settles its graph fact: do not re-query/read/grep it. Complete-query paths are caller-repo-relative, never Skill-relative. Ordinary repository reads remain allowed for a distinct independent AST/oracle view or source-body implementation/runtime detail. Otherwise name the gap and target only it. Missing index: request $codemap-py:scan-codebase.</p>\n<p>Truncation at 20 items is a real cap unless <code>--limit 0</code> is passed (<code>symbol</code>/<code>find-symbol</code> default). <code>query_complete</code> scores graph coverage only: true may mean 20-of-N. <code>index.confidence</code> is <code>exact</code> for the whole set and <code>partial</code> when capped/stale; <code>index.truncated</code>+<code>index.total_available</code> give N. Re-run capped lists with <code>--limit 0</code> before applying the stop rule.</p>\n","files":[{"path":"SKILL.md","sizeBytes":5123,"isText":true}],"reviewScore":null,"reviewSummary":null,"trust":{"provenance":"trusted-source-unreviewed","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow.","bodySource":null},"bodyLocked":false,"purchaseUrl":null,"sourceUrl":null,"report":{"provenance":"trusted-source-unreviewed","screen":{"ran":true,"outcome":"clean","suspicious":0,"notes":0,"hiddenCharacters":false},"virusScan":{"engine":"clamav","status":"clean","scannedAt":"2026-09-23T13:53:27.267109Z","sha256":"9B923E534BCC8A73A7BB5591172382788B2BECF5BF0BD4EC2AAA23CB723D4B42","sizeBytes":2506},"review":null,"source":{"repositoryUrl":"https://github.com/Borda/AI-Rig","path":"plugins/codemap-py/codex-skills/query-code","license":"Apache-2.0","commit":"39e3a48d0da96e7dcba0ca9e2c23c2cd23e54cd8","subtreeSha":"4590AADDF1B05879AAF580BA5F977A54577A73F57232C6C891289A1324F43FAB","lastSyncedAt":"2026-09-23T13:51:19.979623Z"},"reviewedAt":"2026-09-23T13:55:30.136747Z","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow."},"install":[{"target":"skills-cli","command":"npx skills add https://github.com/Borda/AI-Rig/tree/main/plugins/codemap-py/codex-skills/query-code"},{"target":"claude-code","command":"claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install borda-ai-rig@llmmart"},{"target":"git","command":"git clone https://github.com/Borda/AI-Rig.git"}]}