opencode-readseek 0.11.4 → 0.12.1

package/README.md

@@ -42,17 +42,17 @@ macOS/Windows supplied by `@jarkkojs/readseek`. Set
 
 ## Tools
 
-- Read without inference: `readseek_show_content`, `readseek_show_structure`,
-  `readseek_show_metadata`, `readseek_show_assets`.
-- Check: `readseek_check_syntax`, `readseek_check_rules`.
-- Explicit inference: `readseek_generate_caption`, `readseek_detect_objects`,
-  `readseek_recognize_text`.
-- Find: `readseek_find_text`, `readseek_find_nodes`, `readseek_find_definitions`,
-  `readseek_find_references`.
-- Mutate: `readseek_edit_text`, `readseek_rename_symbol`, `readseek_write_file`.
-
-Tool names mirror native verb-object commands, such as `show content`,
-`find nodes`, and `edit text`. Paths resolve against the project directory.
+- Read without inference: `readseek_show`, `readseek_tree`,
+  `readseek_meta`, `readseek_assets`.
+- Check: `readseek_syntax`, `readseek_check`.
+- Explicit inference: `readseek_caption`, `readseek_objects`,
+  `readseek_ocr`.
+- Find: `readseek_grep`, `readseek_search`, `readseek_def`,
+  `readseek_refs`.
+- Mutate: `readseek_edit`, `readseek_rename`, `readseek_write`.
+
+Tool names mirror native flat single-word commands, such as `show`,
+`search`, and `edit`. Paths resolve against the project directory.
 Use `at` selectors (`line:N[:COLUMN]`, `hash:H[:COLUMN]`, `symbol:NAME`,
 `page:N`, `node:ID`, or `asset:ID`) where supported. Structure defaults to
 `depth: 1`. Use separate structure, metadata, and syntax tools rather than
@@ -63,20 +63,25 @@ lines, document sections, structure trees, metadata fields, and asset paths.
 Notices identify omitted ranges and how to continue. The unchanged native result
 is retained separately in `metadata.readseek`; image attachments are unchanged.
 
-`readseek_find_nodes` accepts `pattern`, `context` with `selector`, or `rule`.
-`readseek_find_references` requires exactly one of `name` or `at`; binding
+`readseek_search` accepts `pattern`, `context` with `selector`, or `rule`.
+`readseek_refs` requires exactly one of `name` or `at`; binding
 references and renames use line or hash cursors. KDL selection/check rules
 may be inline or `@path`; tool calls cannot supply standard input.
 
-`readseek_find_text` accepts exactly one of literal `text` or regex `pattern`.
-The adapter also supports `literal`, `ignoreCase`, `glob`, `context`, `limit`,
-and per-file `summary`. Native `find text --text` searches literally.
+`readseek_grep` requires `pattern`: native UTF-8 RE2 regex by default, or exact
+text with `literal: true`. Lookaround and backreferences are unsupported.
+Native ReadSeek handles `ignoreCase`, `glob`, `context`, `summary`, and
+`scope: "symbol"` grouping. `scopeContext` requires symbol scope. The positive
+`limit` defaults to 100 matching lines, not occurrences. `gitScope` accepts
+`tracked`, `untracked`, `ignored`, or `all` (default: tracked plus untracked).
+Source hits carry editable `LINE:HASH` anchors; document hits carry node/page
+selectors and do not mark files as editable.
 
 Read fresh `LINE:HASH` anchors before editing. Each edit item contains exactly
 one nested `set_line`, `replace_lines`, `insert_after`, `replace_symbol`, or
 `replace` object. Edits and renames default to applying after a verified plan
 and edit permission; use `apply: false` to preview and `planHash` to require
-that plan when applying. `write_file` replaces complete text files.
+that plan when applying. `write` replaces complete text files.
 
 Syntax and rule checks treat exit 1 as findings, not transport failure;
 exit 0 is clean and exit 2 is failure. Syntax checks do not typecheck.