pi-readseek 0.7.0 → 0.7.1

package/README.md

@@ -5,6 +5,10 @@ editing, anchored grep, structural maps, symbol navigation, and structural searc
 Pi's built-in tools remain unchanged by default. `replacedTools` can register the
 corresponding ReadSeek implementations under built-in names.
 
+When the ReadSeek binary is available, the extension adds model guidance that
+prefers its anchored read, edit, write, rename, and syntax-check workflow while
+leaving Pi's built-ins available as fallbacks.
+
 ## Installation
 
 ```sh
@@ -18,17 +22,19 @@ binary automatically on supported platforms.
 
 - `readSeek_read`: reads text with `LINE:HASH` anchors; when image modes are
   enabled, images and PDFs can be returned as base64 or analyzed locally.
-  PDF reads return one selected page at a time by default.
+  PDF reads select one page by default and accept an explicit page.
 - `readSeek_edit`: edits existing text files using fresh `LINE:HASH` anchors.
 - `readSeek_grep`: searches text and returns edit-ready anchors.
 - `readSeek_search`: searches code by structural AST pattern.
 - `readSeek_refs`: finds identifier references with enclosing symbols.
-- `readSeek_rename`: plans or applies binding-aware renames; workspace matches are
-  name-based where binding support is unavailable.
+- `readSeek_rename`: applies a binding-aware verified rename by default;
+  `apply: false` returns a dry-run plan. Workspace matches are name-based where
+  binding support is unavailable.
 - `readSeek_hover`: identifies the cursor token and enclosing symbol.
 - `readSeek_def`: finds structural symbol definitions.
 - `readSeek_check`: checks a source file for parser errors and missing syntax.
-- `readSeek_view`: views an indexed PDF overview or narrows it by page, node, kind, or depth.
+- `readSeek_view`: creates or reuses a PDF index, returns its overview, or
+  narrows it by page, node, kind, or depth.
 - `readSeek_write`: creates or overwrites whole files and returns anchors.
 
 ## Settings

package/index.ts

@@ -47,6 +47,16 @@ function formatSettingsWarning(warning: ReadSeekSettingsWarning): string {
 	return `${warning.message} (${warning.source})`;
 }
 
+function editingPolicy(readName: string, editName: string, writeName: string): string {
+	return [
+		"ReadSeek editing policy:",
+		`- Prefer ${readName} when preparing to edit existing text; its LINE:HASH anchors are required by ${editName}.`,
+		`- Prefer ${editName} for existing text files, ${writeName} for whole-file creation or replacement, and readSeek_rename for symbol renames.`,
+		"- Do not use Pi's built-in edit or write when the corresponding ReadSeek tool is available.",
+		"- Use readSeek_check after source edits for a quick syntax check.",
+	].join("\n");
+}
+
 export default function piReadSeekExtension(pi: ExtensionAPI): void {
 	const sessionAnchors = new SessionAnchors();
 	const markAnchored = (absolutePath: string) => sessionAnchors.markAnchored(absolutePath);
@@ -92,6 +102,11 @@ export default function piReadSeekExtension(pi: ExtensionAPI): void {
 	registerViewTool(pi);
 	registerWriteTool(pi, { onFileAnchored: markAnchored, name: writeName });
 
+	pi.on("before_agent_start", (event) => {
+		if (!binaryAvailable) return;
+		return { systemPrompt: `${event.systemPrompt}\n\n${editingPolicy(readName, editName, writeName)}` };
+	});
+
 	pi.on("session_start", (_event, ctx) => {
 		sessionAnchors.clear();
 		const { warnings } = resolveReadSeekJsonSettings();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-readseek",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "Pi extension for readseek-backed hash-anchored read/edit/grep, structural code maps, structural search, and file exploration",
   "type": "module",
   "exports": {
@@ -39,7 +39,7 @@
     "node": ">=20.0.0"
   },
   "dependencies": {
-    "@jarkkojs/readseek": "^0.7.0",
+    "@jarkkojs/readseek": "^0.7.1",
     "diff": "^8.0.3",
     "xxhash-wasm": "^1.1.0"
   },