@zj669/codeq-pi 0.3.3 → 0.3.4

package/README.md

@@ -4,11 +4,11 @@ Native [Pi](https://github.com/earendil-works/pi) coding-agent **extension**
 (not MCP). Same three tools as the `codeq` CLI: `find`, `grep`, `graph`.
 Queries go to the existing user-level codeq daemon. Same-name `grep` / `find`
 override Pi's builtin `rg` / `fd`; `graph` is new. Schema matches
-`@zj669/codeq@0.3.3` (locators, literal grep, opaque grep cursor). This
+`@zj669/codeq@0.3.4` (locators, literal grep, opaque grep cursor). This
 directory is **not published to npm**; install from a checkout.
 
 ```bash
-npm i -g @zj669/codeq@0.3.3
+npm i -g @zj669/codeq@0.3.4
 pi install /absolute/path/to/agent_local_search/codeq-pi
 # or, from a trusted project:
 pi install -l /absolute/path/to/agent_local_search/codeq-pi

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zj669/codeq-pi",
-  "version": "0.3.3",
+  "version": "0.3.4",
   "description": "Pi coding-agent extension: codeq find, grep, and graph (overrides builtin rg/fd)",
   "type": "module",
   "keywords": [
@@ -31,7 +31,7 @@
     "typebox": "*"
   },
   "dependencies": {
-    "@zj669/codeq": "0.3.3"
+    "@zj669/codeq": "0.3.4"
   },
   "devDependencies": {
     "typebox": "1.3.27"

package/src/extension.js

@@ -18,7 +18,7 @@ const GREP_DESCRIPTION =
   "codeq literal string search by default; this is not rg and not Pi's builtin rg. Pass regex:true for a regular expression, fuzzy:true for approximate/different identifiers. Returns matching lines.";
 
 const GRAPH_DESCRIPTION =
-  'codeq graph: identifiers or short "how does X work". Returns an entry span, direct callees, and direct callers, not an answer or source. Read the entry first; follow callees/callers only as needed. Bounded neighborhood, not an exhaustive callgraph. There is no callers tool.';
+  "codeq graph: identifiers, or a short question about how X works, where X is defined, or who calls / uses X. Returns an entry span, direct callees, and direct callers — a map, not an answer or source. For how-it-works, Read the entry. For who-calls or where-used, use the callers locators; do not grep that name first. Bounded neighborhood, not an exhaustive callgraph. There is no callers tool.";
 
 function pathField() {
   return Type.Optional(Type.String({ description: PATH_DESCRIPTION }));
@@ -337,14 +337,14 @@ export function createCodeqExtension({
       description: GRAPH_DESCRIPTION,
       promptSnippet: "Explore the code graph (codeq / CodeGraph)",
       promptGuidelines: [
-        'graph is codeq CodeGraph explore, not a written answer. Query identifiers or "how does X work" where X is identifiers — not a multi-paragraph question.',
-        "graph returns an entry span, direct callees, and direct callers. Read the entry first; follow callees/callers only as needed. There is no callers tool.",
+        "graph is codeq CodeGraph explore, not a written answer. Query identifiers, how X works, where X is defined, or who calls / uses X — not a multi-paragraph question.",
+        "graph: for how-it-works, Read the entry. For who-calls or where-used, use the callers locators; do not grep that name first. There is no callers tool.",
         "graph searches one repository per call. Pass root for another checkout; pass path to narrow. Replies are locators, never source.",
       ],
       parameters: Type.Object({
         query: Type.String({
           description:
-            'Identifiers, or "how does X work" where X is identifiers. Identifier-shaped queries match the graph; a multi-paragraph question does not.',
+            'Identifiers, or a short question about how X works, where X is defined, or who calls / uses X. Identifier-shaped queries match the graph; a multi-paragraph question does not.',
         }),
         path: pathField(),
         root: rootField(),