pi-readseek 0.9.4 → 0.9.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-readseek",
-  "version": "0.9.4",
+  "version": "0.9.6",
   "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.9.4",
+    "@jarkkojs/readseek": "^0.9.6",
     "diff": "^9.0.0",
     "xxhash-wasm": "^1.1.0"
   },

package/prompts/def.md

@@ -4,7 +4,7 @@ Go to a symbol definition or declaration by name. Accepts qualified or unqualifi
 
 - `name` — qualified or unqualified symbol name.
 - `path` — file or directory; defaults to the current directory.
-- `lang` — language override when detection is ambiguous.
+- `language` — language override when detection is ambiguous.
 - `cached`, `others`, `ignored` — Git file selection; `ignored` requires
   `others`.
 

package/prompts/edit.md

@@ -1,6 +1,6 @@
 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`,
+Anchors come from `readSeek_digest`, `readSeek_grep`, `readSeek_search`,
 `readSeek_refs`, `readSeek_def`, or `readSeek_write`.
 
 ## Variants

package/prompts/refs.md

@@ -2,14 +2,14 @@ Find references or usages of an identifier by name or cursor binding. Results in
 
 ## Parameters
 
-- `name` — identifier to find.
+- `name` — identifier to find; required unless `scope` is set with `line`.
 - `path` — file or directory; defaults to the current directory.
-- `lang` — language override for ambiguous, extensionless, or generated source.
+- `language` — language override for ambiguous, extensionless, or generated source.
 - `scope` — restrict results to the binding at `line` / `column` in one file;
-  requires `line`.
+  requires `line`. `name` is optional when scoped.
 - `line` — one-based cursor line used with `scope`.
 - `column` — optional one-based cursor byte column for disambiguation; used with
-  `scope`.
+  `scope`. Cursor fields require `scope`.
 - `cached` — search tracked/indexed files in a Git repository.
 - `others` — search untracked files in a Git repository.
 - `ignored` — include ignored untracked files; requires `others`.

package/prompts/search.md

@@ -4,7 +4,7 @@ Search code by AST structure using ast-grep-style patterns. Results include line
 
 - `pattern` — AST pattern to match.
 - `path` — file or directory; defaults to the current directory.
-- `lang` — language override for ambiguous, extensionless, generated, or
+- `language` — language override for ambiguous, extensionless, generated, or
   JSX-like source.
 - `cached` — search tracked/indexed files in a Git repository.
 - `others` — search untracked files in a Git repository.

package/prompts/read.md

@@ -1,46 +0,0 @@
-Read anchored text by range or symbol. Standalone images require an explicit mode. Use `readSeek_view` for documents (PDF first). Use `readSeek_digest` with `select: "map"` for a structural outline.
-
-## Choose a read
-
-- Default: read a small file or an `offset` / `limit` range.
-- `symbol: "Name"`: read one mapped symbol.
-- `bundle: "local"`: include directly related symbols from the same file.
-
-## Parameters
-
-- `path` — file path.
-- `offset` / `limit` — positive line numbers; `offset` is one-based.
-- `symbol` — `Name`, `Class.method`, or `Name@<line>`; incompatible with
-  `offset` and `limit`.
-- `bundle` — only `"local"`; requires `symbol`.
-- `image` — standalone-image mode; unavailable when `imageMode` is `"off"`.
-
-Text output is capped at {{DEFAULT_MAX_LINES}} lines or {{DEFAULT_MAX_BYTES}}.
-A truncated full-file read appends a map when available; use its ranges for
-follow-up reads.
-
-Standalone images require `image`. In `"auto"`, `image: "none"` returns a
-prepared standalone image without local analysis. Documents (PDF first) are not
-readable through this tool — use `readSeek_view` for structure, content, and
-optional asset vision.
-
-## Symbol lookup
-
-| Query                                         | Result                                          |
-| --------------------------------------------- | ----------------------------------------------- |
-| `{"symbol":"processEvent"}`                   | Function or other unqualified symbol            |
-| `{"symbol":"EventEmitter"}`                   | Class, interface, type, enum, or similar symbol |
-| `{"symbol":"EventEmitter.emit"}`              | Qualified child method or member                |
-| `{"symbol":"Foo.bar@42"}`                     | Definition or overload near line 42             |
-| `{"symbol":"handleRequest","bundle":"local"}` | Symbol plus direct same-file support            |
-
-`@<line>` is a trailing disambiguator; `foo@bar` remains an ordinary name.
-Resolution prefers a containing range, then the nearest symbol at or after the
-line, then one above it.
-
-A successful lookup returns the symbol range. Ambiguous results include
-`name@<startLine>` retry hints. Verify fuzzy matches before editing. A missing or
-unmappable symbol falls back to a normal read with a warning.
-
-Anchors from text, symbol, and bundled reads remain valid for `readSeek_edit`
-until the file changes.