pi-readseek 0.5.3 → 0.5.5

package/README.md

@@ -48,7 +48,7 @@ optional (defaults shown):
 ```json
 {
   "readseek": {
-    "replaceTools": [],
+    "replacedTools": [],
     "imageMode": "force",
     "syntaxValidation": "warn",
     "timeoutMs": 120000,
@@ -60,7 +60,7 @@ optional (defaults shown):
 }
 ```
 
-- **replaceTools:** built-in tool names to replace with their `readSeek_*` equivalents.
+- **replacedTools:** built-in tool names to replace with their `readSeek_*` equivalents.
   Valid values are `"read"`, `"edit"`, `"write"`, and `"grep"`. For a
   readseek-only file surface, use `["read", "edit", "write", "grep"]`.
 - **imageMode:** image OCR/caption/object analysis in `readSeek_read`: `"force"`

package/index.ts

@@ -45,7 +45,7 @@ export default function piReadSeekExtension(pi: ExtensionAPI): void {
 
 	pi.on("session_start", (_event, ctx) => {
 		const { settings, warnings } = resolveReadSeekJsonSettings();
-		const replaceTools = new Set<string>(settings.replaceTools ?? []);
+		const replacedTools = new Set<string>(settings.replacedTools ?? []);
 		const problems = warnings.map(formatSettingsWarning);
 
 		const availability = readSeekBinaryAvailability();
@@ -61,7 +61,7 @@ export default function piReadSeekExtension(pi: ExtensionAPI): void {
 		if (!availability.available) return;
 
 		const activeTools = [...pi.getActiveTools(), ...READSEEK_TOOL_NAMES]
-			.filter((name) => !replaceTools.has(name));
+			.filter((name) => !replacedTools.has(name));
 		pi.setActiveTools([...new Set(activeTools)]);
 	});
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-readseek",
-  "version": "0.5.3",
+  "version": "0.5.5",
   "description": "Pi extension for readseek-backed hash-anchored read/edit/grep, structural code maps, structural search, and file exploration",
   "type": "module",
   "exports": {

package/src/readseek-settings.ts

@@ -19,7 +19,7 @@ const READSEEK_TOOL_REPLACEMENTS = {
 type ReadSeekReplacementTool = keyof typeof READSEEK_TOOL_REPLACEMENTS;
 
 interface ReadSeekJsonSettings {
-  replaceTools?: ReadSeekReplacementTool[];
+  replacedTools?: ReadSeekReplacementTool[];
   imageMode?: ReadSeekImageAnalysisMode;
   syntaxValidation?: ReadSeekSyntaxValidationMode;
   timeoutMs?: number;
@@ -37,7 +37,7 @@ export interface ReadSeekSettingsResult {
   warnings: ReadSeekSettingsWarning[];
 }
 
-const READSEEK_KEYS = ["replaceTools", "imageMode", "syntaxValidation", "timeoutMs", "grep"];
+const READSEEK_KEYS = ["replacedTools", "imageMode", "syntaxValidation", "timeoutMs", "grep"];
 const READSEEK_GREP_KEYS = ["maxLines", "maxBytes"];
 
 function globalSettingsPath(): string {
@@ -112,15 +112,15 @@ function readImageMode(
   return undefined;
 }
 
-function readReplaceTools(
+function readReplacedTools(
   raw: Record<string, unknown>,
   source: string,
   warnings: ReadSeekSettingsWarning[],
 ): ReadSeekReplacementTool[] | undefined {
-  if (!("replaceTools" in raw)) return undefined;
-  const value = raw.replaceTools;
+  if (!("replacedTools" in raw)) return undefined;
+  const value = raw.replacedTools;
   if (!Array.isArray(value)) {
-    warnings.push(invalid(source, "readseek.replaceTools"));
+    warnings.push(invalid(source, "readseek.replacedTools"));
     return undefined;
   }
 
@@ -129,7 +129,7 @@ function readReplaceTools(
     if (typeof tool === "string" && Object.hasOwn(READSEEK_TOOL_REPLACEMENTS, tool)) {
       tools.push(tool as ReadSeekReplacementTool);
     } else {
-      warnings.push(invalid(source, `readseek.replaceTools[${index}]`));
+      warnings.push(invalid(source, `readseek.replacedTools[${index}]`));
     }
   });
   return tools;
@@ -143,8 +143,13 @@ function validateSettings(raw: unknown, source: string): ReadSeekSettingsResult
     return { settings, warnings };
   }
   if (!("readseek" in raw)) {
-    if (Object.keys(raw).length > 0) {
-      warnings.push({ source, path: "readseek", message: "Missing readseek section: every setting belongs under \"readseek\"" });
+    const misplaced = READSEEK_KEYS.filter((key) => key in raw);
+    if (misplaced.length > 0) {
+      warnings.push({
+        source,
+        path: misplaced[0],
+        message: `Readseek setting at top level: move ${misplaced.join(", ")} under "readseek"`,
+      });
     }
     return { settings, warnings };
   }
@@ -156,8 +161,8 @@ function validateSettings(raw: unknown, source: string): ReadSeekSettingsResult
   const section = raw.readseek;
   warnUnknownKeys(section, READSEEK_KEYS, "readseek", source, warnings);
 
-  const replaceTools = readReplaceTools(section, source, warnings);
-  if (replaceTools !== undefined) settings.replaceTools = replaceTools;
+  const replacedTools = readReplacedTools(section, source, warnings);
+  if (replacedTools !== undefined) settings.replacedTools = replacedTools;
 
   const imageMode = readImageMode(section, source, warnings);
   if (imageMode !== undefined) settings.imageMode = imageMode;