pi-readseek 0.8.20 → 0.8.22

package/dist/index.ts

@@ -6213,7 +6213,7 @@ function mergeRanges(ranges) {
 }
 var SEARCH_PROMPT_METADATA = defineToolPromptMetadata({
   promptUrl: new URL("../prompts/search.md", import.meta.url),
-  promptSnippet: "Search source code with AST patterns"
+  promptSnippet: "Search code by AST structure using ast-grep-style patterns"
 });
 function linesFromSearchResult(result, ranges) {
   const lineMap = new Map;
@@ -6376,7 +6376,7 @@ function buildRefsOutput(input) {
 // src/refs.ts
 var REFS_PROMPT_METADATA = defineToolPromptMetadata({
   promptUrl: new URL("../prompts/refs.md", import.meta.url),
-  promptSnippet: "Find identifier usages or a cursor binding"
+  promptSnippet: "Find references by identifier name or cursor binding"
 });
 function refsLine(reference) {
   return {
@@ -6490,7 +6490,7 @@ import path5 from "node:path";
 import { Text as Text6 } from "@earendil-works/pi-tui";
 var RENAME_PROMPT_METADATA = defineToolPromptMetadata({
   promptUrl: new URL("../prompts/rename.md", import.meta.url),
-  promptSnippet: "Rename a cursor symbol with verified edits"
+  promptSnippet: "Rename a symbol at a source location with verified edits"
 });
 var renameSchema = Type8.Object({
   path: filePathParam(),
@@ -6633,7 +6633,7 @@ import { Type as Type9 } from "@sinclair/typebox";
 import { Text as Text7 } from "@earendil-works/pi-tui";
 var HOVER_PROMPT_METADATA = defineToolPromptMetadata({
   promptUrl: new URL("../prompts/hover.md", import.meta.url),
-  promptSnippet: "Identify the token and enclosing symbol at a cursor"
+  promptSnippet: "Inspect the symbol at a source location"
 });
 var hoverSchema = Type9.Object({
   path: filePathParam(),
@@ -7029,7 +7029,7 @@ import { Type as Type11 } from "@sinclair/typebox";
 import path6 from "node:path";
 var DEF_PROMPT_METADATA = defineToolPromptMetadata({
   promptUrl: new URL("../prompts/def.md", import.meta.url),
-  promptSnippet: "Find symbol declarations by name"
+  promptSnippet: "Go to a symbol definition or declaration by name"
 });
 async function executeDef(opts) {
   const { params, signal, cwd, onFileAnchored } = opts;
@@ -7134,7 +7134,7 @@ import { Text as Text9 } from "@earendil-works/pi-tui";
 import { Type as Type12 } from "@sinclair/typebox";
 var CHECK_PROMPT_METADATA = defineToolPromptMetadata({
   promptUrl: new URL("../prompts/check.md", import.meta.url),
-  promptSnippet: "Run a quick syntax check on a source file"
+  promptSnippet: "Check source syntax for parser errors after edits"
 });
 async function executeCheck(opts) {
   const { params, signal, cwd } = opts;
@@ -7227,7 +7227,7 @@ var NODE_KINDS = [
 ];
 var VIEW_PROMPT_METADATA = defineToolPromptMetadata({
   promptUrl: new URL("../prompts/view.md", import.meta.url),
-  promptSnippet: "View PDF structure or selected content"
+  promptSnippet: "Inspect a PDF's structure or selected content"
 });
 async function executeView(opts) {
   const { params, signal, cwd } = opts;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-readseek",
-  "version": "0.8.20",
+  "version": "0.8.22",
   "description": "Pi extension for LINE:HASH-anchored file operations and structural code navigation",
   "type": "module",
   "exports": {
@@ -40,7 +40,7 @@
     "node": ">=20.0.0"
   },
   "dependencies": {
-    "@jarkkojs/readseek": "^0.8.20",
+    "@jarkkojs/readseek": "^0.8.22",
     "diff": "^9.0.0",
     "xxhash-wasm": "^1.1.0"
   },

package/prompts/check.md

@@ -1,4 +1,4 @@
-Run a quick syntax check on a source file. Use after edits to find parser errors and missing syntax; this is not a compiler or linter.
+Check a source file for parser errors or missing syntax after edits. Validation requires a supported tree-sitter language; files without a supported parser are not checked. This is not a compiler, type checker, test runner, or linter.
 
 ## Parameters
 
@@ -7,3 +7,4 @@ Run a quick syntax check on a source file. Use after edits to find parser errors
 ## Output
 
 Returns parser error and missing-node counts with affected line ranges.
+Files without a supported parser are not validated.

package/prompts/def.md

@@ -1,4 +1,4 @@
-Find symbol declarations by qualified or unqualified name. Use this instead of text search when locating a function, class, type, or other definition.
+Go to a symbol definition or declaration by name. Accepts qualified or unqualified names; use this instead of text search for functions, methods, classes, types, and other declarations.
 
 ## Parameters
 
@@ -8,4 +8,4 @@ Find symbol declarations by qualified or unqualified name. Use this instead of t
 - `cached`, `others`, `ignored` — Git file selection; `ignored` requires
   `others`.
 
-After `readSeek_hover`, prefer its qualified symbol name.
+After `readSeek_hover`, use `identifier.text` for the token under the cursor. Use `symbol.qualified_name` only when intentionally navigating to the enclosing declaration.

package/prompts/edit.md

@@ -1,7 +1,7 @@
 Edit existing text files with fresh `LINE:HASH` anchors. Read or search the file first when no fresh anchors are available. Each `edits[]` item must use exactly one nested object: `{"set_line":{"anchor":"LINE:HASH","new_text":"..."}}`, `{"replace_lines":{"start_anchor":"LINE:HASH","end_anchor":"LINE:HASH","new_text":"..."}}`, `{"insert_after":{"anchor":"LINE:HASH","new_text":"..."}}`, `{"replace_symbol":{"symbol":"name","new_body":"..."}}`, or `{"replace":{"old_text":"...","new_text":"..."}}`.
 
-Anchors come from `readSeek_read`, `readSeek_grep`, `readSeek_search`, or
-`readSeek_write`.
+Anchors come from `readSeek_read`, `readSeek_grep`, `readSeek_search`,
+`readSeek_refs`, `readSeek_def`, or `readSeek_write`.
 
 ## Variants
 

package/prompts/hover.md

@@ -1,4 +1,4 @@
-Identify the token and enclosing symbol at a cursor. Use before definition lookup or rename, or to identify a line's enclosing symbol.
+Inspect the symbol at a source location. This identifies the token and enclosing symbol; use it before definition lookup or binding-specific references.
 
 ## Parameters
 

package/prompts/refs.md

@@ -1,4 +1,4 @@
-Find identifier usages with enclosing symbols and edit-ready `LINE:HASH` anchors. Add cursor scope to follow one binding and exclude shadows.
+Find references or usages of an identifier by name or cursor binding. Results include enclosing symbols and edit-ready `LINE:HASH` anchors. Without cursor scope, results are identifier-name matches; with scope, they follow one binding and exclude shadows. Use text search for literal occurrences in strings or comments, and use this tool before renaming or deleting a symbol.
 
 ## Parameters
 

package/prompts/rename.md

@@ -1,4 +1,4 @@
-Rename the symbol at a cursor while preserving resolvable same-named bindings. Set `apply: false` to preview the verified plan.
+Rename a symbol at a source location. Resolvable same-named bindings are preserved; verified edits apply by default. Set `apply: false` to preview the plan before changing files.
 
 ## Parameters
 

package/prompts/search.md

@@ -1,4 +1,4 @@
-Search AST patterns (ast-grep style) and return edit-ready `LINE:HASH` anchors. Use `readSeek_grep` for plain text or regex.
+Search code by AST structure using ast-grep-style patterns. Results include edit-ready `LINE:HASH` anchors. Use `readSeek_grep` for identifiers, strings, comments, configuration, documentation, or other plain text and regex.
 
 ## Parameters
 

package/prompts/view.md

@@ -1,4 +1,4 @@
-View the structure or selected content of a PDF. Start with the overview, then narrow by page or node instead of reading the whole document.
+Inspect a PDF's structure or selected content. Start with the overview, then narrow by page, node, kind, or depth instead of reading the whole document.
 
 ## Parameters