pi-readseek 0.3.2 → 0.3.4

package/src/ls.ts

@@ -1,293 +0,0 @@
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
-import { Text } from "@earendil-works/pi-tui";
-import { Type } from "@sinclair/typebox";
-import { defineToolPromptMetadata } from "./tool-prompt-metadata.js";
-import { readdir, stat } from "node:fs/promises";
-import { resolveToCwd } from "./path-utils.js";
-import { buildReadseekError } from "./readseek-value.js";
-import { coerceObviousBase10Int } from "./coerce-obvious-int.js";
-import { clampLineToWidth, clampLinesToWidth, isRendererExpanded, linkToolPath, renderToolLabel, summaryLine } from "./tui-render-utils.js";
-
-const MAX_BYTES = 50 * 1024; // 50 KB
-const DEFAULT_LIMIT = 500;
-
-const LS_PROMPT_METADATA = defineToolPromptMetadata({
-  promptUrl: new URL("../prompts/ls.md", import.meta.url),
-  promptSnippet: "List one directory with directories first and dotfiles included",
-  promptGuidelines: [
-    "Use ls to inspect one directory; use find for recursive discovery.",
-    "Use ls glob to narrow a single-directory listing.",
-    "Use read, not ls, for file contents.",
-  ],
-});
-
-export const LS_READSEEK = {
-  callable: true,
-  enabled: true,
-  policy: "read-only" as const,
-  readOnly: true,
-  pythonName: "ls",
-  defaultExposure: "safe-by-default" as const,
-};
-
-export interface LsEntry {
-  name: string;
-  type: "file" | "dir";
-}
-
-export interface LsReadseekValue {
-  tool: "ls";
-  path: string;
-  totalEntries: number;
-  truncated: boolean;
-  entries: LsEntry[];
-}
-
-function sortEntries(entries: LsEntry[]): LsEntry[] {
-  const dirs = entries.filter((e) => e.type === "dir");
-  const files = entries.filter((e) => e.type === "file");
-  const cmp = (a: LsEntry, b: LsEntry) => {
-    const lower = a.name.toLowerCase().localeCompare(b.name.toLowerCase());
-    return lower !== 0 ? lower : a.name.localeCompare(b.name);
-  };
-  dirs.sort(cmp);
-  files.sort(cmp);
-  return [...dirs, ...files];
-}
-
-function formatOutput(entries: LsEntry[], totalCount: number, truncated: boolean): string {
-  const lines: string[] = [];
-  for (const e of entries) {
-    lines.push(e.type === "dir" ? `${e.name}/` : e.name);
-  }
-  if (truncated) {
-    const remaining = totalCount - entries.length;
-    lines.push(`[… ${remaining} more entries — use glob to narrow results]`);
-  }
-  if (entries.length === 0 && !truncated) {
-    return "(empty directory)";
-  }
-  let text = lines.join("\n");
-  const bytes = Buffer.byteLength(text, "utf8");
-  if (bytes > MAX_BYTES) {
-    text = Buffer.from(text, "utf8").subarray(0, MAX_BYTES).toString("utf8") + "\n[… truncated at 50 KB]";
-  }
-  return text;
-}
-
-function validateGlobBalance(glob: string): string | null {
-  let brackets = 0;
-  let braces = 0;
-  for (let i = 0; i < glob.length; i++) {
-    const ch = glob[i];
-    if (ch === "\\") {
-      i++;
-      continue;
-    }
-    if (ch === "[") brackets++;
-    else if (ch === "]") {
-      if (brackets === 0) return "Unmatched ']'.";
-      brackets--;
-    } else if (ch === "{") braces++;
-    else if (ch === "}") {
-      if (braces === 0) return "Unmatched '}'.";
-      braces--;
-    }
-  }
-  if (brackets !== 0) return "Unterminated character class.";
-  if (braces !== 0) return "Unterminated brace expansion.";
-  return null;
-}
-
-export function registerLsTool(pi: ExtensionAPI) {
-  const tool: Parameters<ExtensionAPI["registerTool"]>[0] & { ptc: typeof LS_READSEEK } = {
-    name: "ls",
-    label: "ls",
-    description: LS_PROMPT_METADATA.description,
-    promptSnippet: LS_PROMPT_METADATA.promptSnippet,
-    promptGuidelines: LS_PROMPT_METADATA.promptGuidelines,
-    ptc: LS_READSEEK,
-    parameters: Type.Object({
-      path: Type.Optional(Type.String({ description: "Directory path" })),
-      limit: Type.Optional(
-        Type.Union(
-          [Type.Number(), Type.String()],
-          { description: "Max entries" },
-        ),
-      ),
-      glob: Type.Optional(Type.String({ description: "Glob filter" })),
-    }),
-    async execute(
-      _toolCallId: string,
-      params: { path?: string; limit?: number | string; glob?: string },
-      _signal: AbortSignal | undefined,
-      _onUpdate: any,
-      ctx: any,
-    ) {
-      const cwd: string = ctx?.cwd ?? process.cwd();
-      const targetPath = params.path ? resolveToCwd(params.path, cwd) : cwd;
-      const limitCoerced = coerceObviousBase10Int(params.limit, "limit");
-      if (!limitCoerced.ok) {
-        return {
-          content: [{ type: "text" as const, text: limitCoerced.message }],
-          isError: true,
-          details: {
-            readseekValue: {
-              tool: "ls" as const,
-              ok: false,
-              path: params.path ?? targetPath,
-              error: buildReadseekError("invalid-limit", limitCoerced.message),
-            },
-          },
-        };
-      }
-      if (limitCoerced.value !== undefined && limitCoerced.value < 1) {
-        const message = `Invalid limit: expected a positive integer, received ${limitCoerced.value}.`;
-        return {
-          content: [{ type: "text" as const, text: message }],
-          isError: true,
-          details: {
-            readseekValue: {
-              tool: "ls" as const,
-              ok: false,
-              path: params.path ?? targetPath,
-              error: buildReadseekError("invalid-limit", message),
-            },
-          },
-        };
-      }
-      const limit = limitCoerced.value ?? DEFAULT_LIMIT;
-
-      // Check if path exists and is a directory
-      let pathStat;
-      try {
-        pathStat = await stat(targetPath);
-      } catch (err: any) {
-        const target = params.path ?? targetPath;
-        const code =
-          err?.code === "EACCES" || err?.code === "EPERM"
-            ? "permission-denied"
-            : err?.code === "ENOENT"
-              ? "path-not-found"
-              : "fs-error";
-        const message =
-          code === "permission-denied"
-            ? `Error: permission denied for path '${target}'`
-            : code === "path-not-found"
-              ? `Error: path '${target}' does not exist`
-              : `Error: could not access path '${target}': ${err?.message ?? String(err)}`;
-        return {
-          content: [{ type: "text" as const, text: message }],
-          isError: true,
-          details: {
-            readseekValue: {
-              tool: "ls",
-              ok: false,
-              path: target,
-              error: buildReadseekError(code, message, undefined, code === "fs-error"
-                ? { fsCode: err?.code, fsMessage: err?.message }
-                : undefined),
-            },
-          },
-        };
-      }
-      if (!pathStat.isDirectory()) {
-        const message = `Error: '${params.path ?? targetPath}' is a file, not a directory. Use read to inspect files.`;
-        return {
-          content: [{ type: "text" as const, text: message }],
-          isError: true,
-          details: {
-            readseekValue: {
-              tool: "ls",
-              ok: false,
-              path: params.path ?? targetPath,
-              error: buildReadseekError(
-                "path-not-directory",
-                message,
-                `Use read(${JSON.stringify(params.path ?? targetPath)}) to inspect files.`,
-              ),
-            },
-          },
-        };
-      }
-
-      // Read directory
-      const dirents = await readdir(targetPath, { withFileTypes: true });
-      let allEntries: LsEntry[] = dirents.map((d) => ({
-        name: d.name,
-        type: d.isDirectory() ? ("dir" as const) : ("file" as const),
-      }));
-
-      // Apply glob filter
-      if (params.glob) {
-        const balanceError = validateGlobBalance(params.glob);
-        if (balanceError) {
-          const message = `Invalid glob ${JSON.stringify(params.glob)}: ${balanceError}`;
-          return {
-            content: [{ type: "text" as const, text: message }],
-            isError: true,
-            details: {
-              readseekValue: {
-                tool: "ls" as const,
-                ok: false,
-                path: params.path ?? targetPath,
-                error: buildReadseekError("invalid-params-combo", message),
-              },
-            },
-          };
-        }
-        const picomatch = (await import("picomatch" as any)).default;
-        const isMatch = picomatch(params.glob);
-        allEntries = allEntries.filter((e) => isMatch(e.name));
-      }
-
-      // Sort: dirs first, then files, each group alpha case-insensitive
-      const sorted = sortEntries(allEntries);
-      const totalCount = sorted.length;
-      const truncated = totalCount > limit;
-      const displayed = truncated ? sorted.slice(0, limit) : sorted;
-
-      const text = formatOutput(displayed, totalCount, truncated);
-      const readseekValue: LsReadseekValue = {
-        tool: "ls",
-        path: targetPath,
-        totalEntries: totalCount,
-        truncated,
-        entries: displayed,
-      };
-
-      return {
-        content: [{ type: "text" as const, text }],
-        details: { readseekValue },
-      };
-    },
-
-    renderCall(args: any, theme: any, context: any = {}) {
-      const { path } = args as { path?: string };
-      const cwd = context.cwd ?? process.cwd();
-      const displayPath = path ?? ".";
-      const linkedPath = linkToolPath(theme.fg("muted", displayPath), displayPath, cwd);
-      return new Text(clampLineToWidth(`${renderToolLabel(theme, "ls")} ${linkedPath}`, context.width), 0, 0);
-    },
-
-    renderResult(result: any, options: any, theme: any, context: any = {}) {
-      const expanded = isRendererExpanded(options, context);
-      const width = context.width ?? options?.width;
-      const output = result.content[0]?.type === "text" ? (result.content[0] as { type: "text"; text: string }).text : "";
-      if (result.isError || context.isError) {
-        const firstLine = output.split("\n")[0] || "error";
-        const body = expanded && output ? output : firstLine;
-        return new Text(clampLinesToWidth(summaryLine(body).split("\n"), width).join("\n"), 0, 0);
-      }
-      const readseekValue = result.details?.readseekValue as { totalEntries?: number } | undefined;
-      const total = readseekValue?.totalEntries ?? output.split("\n").filter(Boolean).length;
-      if (total === 0) return new Text(summaryLine("no entries"), 0, 0);
-      let text = summaryLine(`${total} ${total === 1 ? "entry" : "entries"} returned`, { hidden: !!output && !expanded });
-      if (expanded && output) text += `\n${output}`;
-      return new Text(clampLinesToWidth(text.split("\n"), width).join("\n"), 0, 0);
-    },
-  };
-
-  pi.registerTool(tool);
-  return tool;
-}

package/src/readseek-command.ts

@@ -1,155 +0,0 @@
-import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
-import { Key, matchesKey, truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
-import { existsSync, readFileSync, rmSync, writeFileSync } from "node:fs";
-import { dirname, join, relative } from "node:path";
-import { findReadseekDir, initReadseekDir } from "./readseek-repo.js";
-
-type ReadseekAction = "init" | "deinit" | null;
-
-function stripFromGitignore(dir: string): void {
-	const gitignorePath = join(dir, ".gitignore");
-	if (!existsSync(gitignorePath)) return;
-	const lines = readFileSync(gitignorePath, "utf-8").split("\n");
-	const filtered = lines.filter((line) => line.trim() !== "/.readseek");
-	writeFileSync(gitignorePath, filtered.join("\n"), "utf-8");
-}
-
-async function deinit(ctx: ExtensionContext): Promise<void> {
-	const dir = findReadseekDir(ctx.cwd);
-	if (!dir) {
-		ctx.ui.notify("No .readseek directory found", "info");
-		return;
-	}
-	const projectDir = dirname(dir);
-	rmSync(dir, { recursive: true, force: true });
-	stripFromGitignore(projectDir);
-	ctx.ui.notify("Removed .readseek/", "info");
-}
-
-async function init(ctx: ExtensionContext): Promise<void> {
-	const projectDir = ctx.cwd;
-	if (findReadseekDir(projectDir)) {
-		ctx.ui.notify(".readseek/ already exists", "info");
-		return;
-	}
-	initReadseekDir(projectDir);
-	ctx.ui.notify("Initialized .readseek/", "info");
-}
-
-export function registerReadseekCommand(pi: ExtensionAPI): void {
-	const maybePi = pi as ExtensionAPI & {
-		registerCommand?: ExtensionAPI["registerCommand"];
-	};
-
-	maybePi.registerCommand?.("readseek", {
-		description: "Manage .readseek/ map cache",
-		handler: async (_args, ctx) => {
-			if (!ctx.hasUI) return;
-
-			const action = await new Promise<ReadseekAction>((resolve) => {
-				const initialized = findReadseekDir(ctx.cwd) !== null;
-
-				void ctx.ui.custom<ReadseekAction>(
-					(tui, theme, _kb, done) => {
-						return {
-							render(width: number): string[] {
-								const innerW = Math.max(1, width - 4);
-								const border = theme.fg("border", "│");
-								const dim = (s: string) => theme.fg("dim", s);
-								const accent = (s: string) => theme.fg("accent", s);
-								const borderFg = (s: string) => theme.fg("border", s);
-
-								function row(content: string): string {
-									const line = truncateToWidth(content, innerW);
-									const pad = Math.max(0, innerW - visibleWidth(line));
-									return `${border} ${line}${" ".repeat(pad)} ${border}`;
-								}
-
-								const lines: string[] = [];
-
-								const label = " Readseek ";
-								const topFill = borderFg(
-									"─".repeat(Math.max(0, width - 4 - visibleWidth(label))),
-								);
-								lines.push(
-									`${borderFg("╭─")}${accent(label)}${topFill}${borderFg("─╮")}`,
-								);
-
-								lines.push(row(""));
-
-								const readseekDir = findReadseekDir(ctx.cwd);
-								const statusDot = initialized
-									? theme.fg("success", "●")
-									: theme.fg("warning", "●");
-								const statusLabel = initialized ? "Initialized" : "Not initialized";
-								const statusColor = initialized
-									? theme.fg("success", statusLabel)
-									: theme.fg("warning", statusLabel);
-								const pathText = readseekDir
-									? dim(relative(ctx.cwd, readseekDir) || readseekDir)
-									: dim(".readseek");
-								lines.push(
-									row(`${statusDot} ${statusColor} ${dim("·")} ${pathText}`),
-								);
-
-								lines.push(row(""));
-
-								if (initialized) {
-									lines.push(
-										row(`${accent("▶")} ${dim("[d]")} Deinit  ${dim("remove .readseek/")}`),
-									);
-								} else {
-									lines.push(
-										row(
-											`${accent("▶")} ${dim("[i]")} Init  ${dim("create .readseek/ map cache")}`,
-										),
-									);
-								}
-
-								lines.push(row(""));
-								lines.push(row(dim("esc close")));
-
-								lines.push(
-									`${borderFg("╰")}${borderFg("─".repeat(Math.max(0, width - 2)))}${borderFg("╯")}`,
-								);
-
-								return lines;
-							},
-
-							handleInput(data: string): void {
-								if (matchesKey(data, Key.escape) || matchesKey(data, Key.ctrl("c"))) {
-									done(null);
-									return;
-								}
-
-								if (!initialized && (data === "i" || data === "I")) {
-									done("init");
-									return;
-								}
-								if (initialized && (data === "d" || data === "D")) {
-									done("deinit");
-									return;
-								}
-							},
-
-							invalidate(): void {},
-						};
-					},
-					{
-						overlay: true,
-						overlayOptions: {
-							anchor: "center",
-							width: 60,
-							margin: 2,
-						},
-					},
-				).then((result) => {
-					resolve(result ?? null);
-				});
-			});
-
-			if (action === "init") await init(ctx);
-			else if (action === "deinit") await deinit(ctx);
-		},
-	});
-}

package/src/readseek-repo.ts

@@ -1,50 +0,0 @@
-import { appendFileSync, existsSync, mkdirSync, readFileSync } from "node:fs";
-import { dirname, join, resolve } from "node:path";
-
-export function findReadseekDir(cwd: string): string | null {
-	const abs = resolve(cwd);
-	for (let dir = abs; ; dir = dirname(dir)) {
-		const candidate = join(dir, ".readseek");
-		if (existsSync(candidate)) return candidate;
-		const parent = dirname(dir);
-		if (parent === dir) break;
-	}
-	return null;
-}
-
-export function hasReadseekDir(cwd: string): boolean {
-	return findReadseekDir(cwd) !== null;
-}
-
-export function initReadseekDir(cwd: string): string {
-	const abs = resolve(cwd);
-	const readseekDir = join(abs, ".readseek");
-	const mapsDir = join(readseekDir, "maps");
-
-	if (existsSync(readseekDir)) {
-		throw new Error(`.readseek/ already exists in ${abs}`);
-	}
-
-	mkdirSync(mapsDir, { recursive: true });
-
-	const gitignore = join(abs, ".gitignore");
-	const entry = "/.readseek";
-	const needsAppend = (() => {
-		if (!existsSync(gitignore)) return true;
-		const contents = readFileSync(gitignore, "utf-8");
-		return !contents.split("\n").some((line) => line.trim() === entry);
-	})();
-
-	if (needsAppend) {
-		let prefix = "";
-		if (existsSync(gitignore)) {
-			const contents = readFileSync(gitignore, "utf-8");
-			if (contents.length > 0 && !contents.endsWith("\n")) {
-				prefix = "\n";
-			}
-		}
-		appendFileSync(gitignore, `${prefix}${entry}\n`, "utf-8");
-	}
-
-	return readseekDir;
-}