@xrkseek/harness 0.5.12 → 0.5.13

package/node_modules/@xrkseek/exec-fs/dist/ripgrep.js

@@ -0,0 +1,363 @@
+/**
+ * Packaged ripgrep backend for `glob` / `grep`.
+ *
+ * Provenance (adapted, not Cordis-coupled):
+ * - DSH `@deepseek-ai/dsh-tool-fs-search` `search-core` / `glob` / `grep`
+ *   (resolveRgPath, `--no-config`, `--files` / `--json`, VCS excludes, error codes)
+ * - pi `@mariozechner/pi-coding-agent` grep (stream `--json`, kill at match limit)
+ * - Codex bundled `rg` (packaged binary, no system install)
+ *
+ * Better than a pure JS walk on monorepos: native ignore rules, mmap search,
+ * early kill at `maxResults`. Falls back only when the binary is missing.
+ */
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import { createInterface } from "node:readline";
+import path from "node:path";
+import { createLocalSubprocess } from "@xrkseek/exec-subprocess";
+import { resolveWithinRoot } from "./paths.js";
+/** Cooperative search budget (ms) — DSH / Claude Code default. */
+export const FS_SEARCH_TIMEOUT_MS = 30_000;
+/** Cap on raw `rg --files` stdout we parse — DSH `RAW_OUTPUT_MAX_BYTES`. */
+export const FS_SEARCH_RAW_OUTPUT_MAX_BYTES = 20_000_000;
+/** DSH `GLOB_VCS_EXCLUDES` — prune VCS stores under `--hidden`. */
+export const FS_GLOB_VCS_EXCLUDES = [
+    ".git",
+    ".svn",
+    ".hg",
+    ".bzr",
+    ".jj",
+    ".sl",
+];
+/**
+ * Extra prune set beyond DSH (DSH glob uses `--no-ignore` and would scrape
+ * `node_modules`). We keep gitignore (pi) AND hard-exclude these basenames.
+ */
+export const FS_GLOB_HEAVY_EXCLUDES = [
+    "node_modules",
+    "dist",
+    "build",
+    "out",
+    "coverage",
+    ".next",
+    ".nuxt",
+    ".turbo",
+    ".cache",
+    ".parcel-cache",
+    ".vite",
+    "__pycache__",
+    ".venv",
+    "venv",
+    "target",
+    ".idea",
+    ".gradle",
+    ".codegraph",
+    ".scratch-opus",
+    "Pods",
+];
+export class RipgrepUnavailableError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "RipgrepUnavailableError";
+    }
+}
+/** Reject reasons must be Errors; a `catch` binding is typed `unknown`. */
+function errorText(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+let rgPathMemo;
+/** DSH `resolveRgPath` — packaged `@vscode/ripgrep`, Electron asar unpack. */
+export function resolveRgPath() {
+    rgPathMemo ??= (async () => {
+        try {
+            const mod = await import("@vscode/ripgrep");
+            const p = mod.rgPath;
+            if (typeof p !== "string" || !p || !existsSync(p)) {
+                throw new RipgrepUnavailableError("packaged ripgrep path missing on disk");
+            }
+            return process.versions.electron === undefined
+                ? p
+                : p.replace(/\.asar(?=[\\/])/u, ".asar.unpacked");
+        }
+        catch (err) {
+            if (err instanceof RipgrepUnavailableError)
+                throw err;
+            throw new RipgrepUnavailableError("packaged ripgrep (@vscode/ripgrep) unavailable", { cause: err });
+        }
+    })();
+    return rgPathMemo;
+}
+/** Test hook. */
+export function clearRgPathCache() {
+    rgPathMemo = undefined;
+}
+function excludeGlobs(names) {
+    // DSH: bare form prunes during traversal; /** form covers root-at-dir.
+    return names.flatMap((name) => [
+        `--glob=!**/${name}`,
+        `--glob=!**/${name}/**`,
+    ]);
+}
+/**
+ * DSH `buildGlobCommand` + heavy excludes.
+ * Unlike DSH we omit `--no-ignore` (pi: respect `.gitignore`) and still prune
+ * generated trees when ignore files are missing.
+ */
+export function buildGlobCommand(input) {
+    const parts = [
+        "--no-config",
+        "--files",
+        `--glob=${input.pattern}`,
+        "--sort=modified",
+        "--hidden",
+        ...excludeGlobs(FS_GLOB_VCS_EXCLUDES),
+        ...excludeGlobs(FS_GLOB_HEAVY_EXCLUDES),
+    ];
+    if (input.path !== undefined)
+        parts.push("--", input.path);
+    return parts;
+}
+/**
+ * DSH `buildGrepCommand` (+ heavy excludes, optional `-i`).
+ * Pattern / include as `--flag=value`; scope behind `--`.
+ */
+export function buildGrepCommand(input) {
+    const parts = [
+        "--no-config",
+        "--json",
+        `--regexp=${input.pattern}`,
+        "--hidden",
+    ];
+    if (input.caseInsensitive)
+        parts.push("--ignore-case");
+    if (input.glob !== undefined)
+        parts.push(`--glob=${input.glob}`);
+    parts.push(...excludeGlobs(FS_GLOB_VCS_EXCLUDES), ...excludeGlobs(FS_GLOB_HEAVY_EXCLUDES));
+    if (input.path !== undefined)
+        parts.push("--", input.path);
+    return parts;
+}
+function malformedRecord(detail, cause) {
+    return new Error(`grep received malformed ripgrep --json output (${detail})`, { cause });
+}
+/** DSH `parseRecord` → our `FsGrepHit`. */
+export function parseGrepJsonRecord(line) {
+    let parsed;
+    try {
+        parsed = JSON.parse(line);
+    }
+    catch (error) {
+        throw malformedRecord("a line is not JSON", error);
+    }
+    if (typeof parsed !== "object" || parsed === null) {
+        throw malformedRecord("a record is not an object");
+    }
+    const record = parsed;
+    if (record.type !== "match")
+        return undefined;
+    if (typeof record.data !== "object" || record.data === null) {
+        throw malformedRecord("a match record has no data");
+    }
+    const data = record.data;
+    const pathText = typeof data.path === "object" && data.path !== null
+        ? data.path.text
+        : undefined;
+    if (typeof pathText !== "string") {
+        throw malformedRecord("a match record has no path text");
+    }
+    if (typeof data.line_number !== "number") {
+        throw malformedRecord("a match record has no line number");
+    }
+    if (typeof data.lines !== "object" || data.lines === null) {
+        throw malformedRecord("a match record has no line content");
+    }
+    const lines = data.lines;
+    let text;
+    if (typeof lines.text === "string") {
+        text = lines.text.replace(/\r?\n$/, "");
+    }
+    else if (typeof lines.bytes === "string") {
+        text = "(line is not valid UTF-8)";
+    }
+    else {
+        throw malformedRecord("a match record has neither line text nor bytes");
+    }
+    return {
+        path: pathText.replace(/\\/g, "/"),
+        line: data.line_number,
+        text: text.length > 400 ? `${text.slice(0, 400)}…` : text,
+    };
+}
+export function parseGrepMatches(stdout) {
+    const hits = [];
+    for (const line of stdout.split("\n")) {
+        if (line.length === 0)
+            continue;
+        const hit = parseGrepJsonRecord(line);
+        if (hit !== undefined)
+            hits.push(hit);
+    }
+    return hits;
+}
+function classifyRgFailure(tool, exitCode, stderr) {
+    const excerpt = stderr.trim().slice(0, 400);
+    if (/regex parse error|error parsing glob/i.test(excerpt)) {
+        return new Error(`${tool} pattern rejected by ripgrep${excerpt ? `: ${excerpt}` : ""}`);
+    }
+    return new Error(`${tool} ripgrep failed (exit ${exitCode})${excerpt ? `: ${excerpt}` : ""}`);
+}
+function toDisplayPath(p, rootAbs) {
+    const norm = p.replace(/\\/g, "/");
+    if (!path.isAbsolute(p))
+        return norm.replace(/^\.\//, "");
+    const rel = path.relative(rootAbs, p).replace(/\\/g, "/");
+    if (rel === "" || rel === ".")
+        return ".";
+    if (rel.startsWith(".."))
+        return norm;
+    return rel;
+}
+/** Glob via packaged rg `--files` (DSH). */
+export async function globWithRipgrep(root, pattern, options) {
+    const rootAbs = path.resolve(root);
+    const maxResults = options?.maxResults ?? 200;
+    const bin = await resolveRgPath();
+    const subprocess = createLocalSubprocess();
+    const result = await subprocess.spawn([bin, ...buildGlobCommand({ pattern })], {
+        cwd: rootAbs,
+        timeoutMs: FS_SEARCH_TIMEOUT_MS,
+        // Search never needs disk spill; keep the Host loop free of writeSync.
+        spill: false,
+    });
+    if (result.exitCode !== 0 && result.exitCode !== 1) {
+        throw classifyRgFailure("glob", result.exitCode ?? -1, result.stderr);
+    }
+    if (Buffer.byteLength(result.stdout, "utf8") > FS_SEARCH_RAW_OUTPUT_MAX_BYTES) {
+        throw new Error(`glob produced more than ${FS_SEARCH_RAW_OUTPUT_MAX_BYTES} bytes of raw output; narrow pattern`);
+    }
+    const out = [];
+    for (const line of result.stdout.split(/\r?\n/)) {
+        if (!line)
+            continue;
+        out.push(toDisplayPath(line, rootAbs));
+        if (out.length >= maxResults)
+            break;
+    }
+    return out;
+}
+/**
+ * Grep via packaged rg `--json`, streaming + early kill at `maxResults`
+ * (pi coding-agent). Avoids buffering multi-MB stdout on hot repos.
+ */
+export async function grepWithRipgrep(root, pattern, options) {
+    const rootAbs = path.resolve(root);
+    const maxResults = options?.maxResults ?? 100;
+    const scope = options?.path;
+    let scopedPath;
+    if (scope !== undefined && scope !== "." && scope !== "") {
+        resolveWithinRoot(rootAbs, scope);
+        scopedPath = scope;
+    }
+    const bin = await resolveRgPath();
+    const argv = buildGrepCommand({
+        pattern,
+        ...(scopedPath !== undefined ? { path: scopedPath } : {}),
+        ...(options?.glob !== undefined ? { glob: options.glob } : {}),
+        ...(options?.caseInsensitive ? { caseInsensitive: true } : {}),
+    });
+    return await new Promise((resolve, reject) => {
+        const child = spawn(bin, argv, {
+            cwd: rootAbs,
+            stdio: ["ignore", "pipe", "pipe"],
+            windowsHide: true,
+        });
+        const hits = [];
+        let stderr = "";
+        let settled = false;
+        let killedForLimit = false;
+        const timer = setTimeout(() => {
+            killedForLimit = false;
+            try {
+                child.kill();
+            }
+            catch {
+                /* ignore */
+            }
+        }, FS_SEARCH_TIMEOUT_MS);
+        const finish = (fn) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            fn();
+        };
+        child.stderr?.setEncoding("utf8");
+        child.stderr?.on("data", (chunk) => {
+            if (stderr.length < 8_192)
+                stderr += chunk;
+        });
+        const rl = createInterface({ input: child.stdout });
+        rl.on("line", (line) => {
+            if (settled || hits.length >= maxResults)
+                return;
+            if (!line.trim())
+                return;
+            let hit;
+            try {
+                hit = parseGrepJsonRecord(line);
+            }
+            catch (err) {
+                finish(() => reject(new Error(`ripgrep --json parse failed: ${errorText(err)}`, {
+                    cause: err,
+                })));
+                try {
+                    child.kill();
+                }
+                catch {
+                    /* ignore */
+                }
+                return;
+            }
+            if (hit === undefined)
+                return;
+            hits.push({
+                ...hit,
+                path: toDisplayPath(hit.path, rootAbs),
+            });
+            if (hits.length >= maxResults) {
+                killedForLimit = true;
+                try {
+                    child.kill();
+                }
+                catch {
+                    /* ignore */
+                }
+            }
+        });
+        child.on("error", (err) => {
+            finish(() => reject(new RipgrepUnavailableError(`Failed to run ripgrep: ${err.message}`, {
+                cause: err,
+            })));
+        });
+        child.on("close", (code) => {
+            rl.close();
+            finish(() => {
+                if (killedForLimit) {
+                    resolve(hits);
+                    return;
+                }
+                if (code !== 0 && code !== 1 && code !== null) {
+                    reject(classifyRgFailure("grep", code, stderr));
+                    return;
+                }
+                resolve(hits);
+            });
+        });
+    });
+}
+/** True when callers should skip ripgrep (`XRK_FS_SEARCH=js`). */
+export function preferJsSearch() {
+    const raw = process.env.XRK_FS_SEARCH?.trim().toLowerCase();
+    return raw === "js" || raw === "walk" || raw === "javascript";
+}
+//# sourceMappingURL=ripgrep.js.map

package/node_modules/@xrkseek/exec-fs/dist/ripgrep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ripgrep.js","sourceRoot":"","sources":["../src/ripgrep.ts"],"names":[],"mappings":"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"}

package/node_modules/@xrkseek/exec-fs/dist/search.d.ts

@@ -14,17 +14,46 @@ export interface FsGrepOptions {
     readonly maxResults?: number;
     readonly caseInsensitive?: boolean;
 }
+/** Skip heavy / generated trees so grep/glob stay interactive on monorepos. */
+export declare const FS_SEARCH_SKIP_DIR_NAMES: Set<string>;
+/** Soft walk ceiling (still high enough for late-sorted paths). */
+export declare const FS_SEARCH_WALK_CAP = 100000;
+/** Skip individual files larger than this for content grep. */
+export declare const FS_GREP_MAX_FILE_BYTES = 1000000;
 /** Convert a posix-ish glob to a RegExp. Supports * and ** segments. */
 export declare function globToRegExp(pattern: string): RegExp;
 export declare function matchGlob(relPosix: string, pattern: string): boolean;
+type WalkVisitor = (relPosix: string) => boolean | void | Promise<boolean | void>;
+/**
+ * Depth-first walk under `absDir`. Skips junk dir basenames. Invokes `visit`
+ * for each file (posix path relative to `rootAbs`). Stop when visit returns
+ * false or `cap` files have been visited. Yields periodically so Host LLM /
+ * mux work can interleave.
+ */
+export declare function walkFilesUnder(absDir: string, rootAbs: string, visit: WalkVisitor, cap?: number): Promise<void>;
+/**
+ * In-process glob walk (fallback when packaged ripgrep is unavailable).
+ * Matches during the walk and stops at `maxResults`.
+ */
+export declare function globWalkUnderRoot(root: string, pattern: string, options?: FsGlobOptions): Promise<readonly string[]>;
 /**
  * Collect files under `root` matching `pattern` (posix paths relative to root).
- * Walks with a generous traversal cap so later-sorted paths aren't missed;
- * only the returned list is cut at `maxResults`.
+ * Prefers packaged ripgrep (`@vscode/ripgrep`, Codex / pi / DSH); falls back
+ * to {@link globWalkUnderRoot} when the binary is missing. Set `XRK_FS_SEARCH=js`
+ * to force the walk.
  */
 export declare function globUnderRoot(root: string, pattern: string, options?: FsGlobOptions): Promise<readonly string[]>;
+/** Line scan without allocating a full `split` array (hot for large files). */
+export declare function forEachLine(text: string, fn: (line: string, lineNo: number) => boolean): void;
+/**
+ * In-process content search (fallback when packaged ripgrep is unavailable).
+ */
+export declare function grepWalkUnderRoot(root: string, pattern: string, options?: FsGrepOptions): Promise<readonly FsGrepHit[]>;
 /**
- * Search file contents under root for a JS RegExp `pattern` string.
+ * Search file contents under root. Prefers packaged ripgrep (`--json`);
+ * falls back to {@link grepWalkUnderRoot} when the binary is missing.
+ * Set `XRK_FS_SEARCH=js` to force the walk.
  */
 export declare function grepUnderRoot(root: string, pattern: string, options?: FsGrepOptions): Promise<readonly FsGrepHit[]>;
+export {};
 //# sourceMappingURL=search.d.ts.map

package/node_modules/@xrkseek/exec-fs/dist/search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,wDAAwD;IACxD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,sEAAsE;IACtE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;CACpC;AAED,wEAAwE;AACxE,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAmCpD;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAGpE;AA8BD;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAmB5B;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,SAAS,SAAS,EAAE,CAAC,CAoE/B"}
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,wDAAwD;IACxD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,sEAAsE;IACtE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;CACpC;AAED,+EAA+E;AAC/E,eAAO,MAAM,wBAAwB,aAsBnC,CAAC;AAEH,mEAAmE;AACnE,eAAO,MAAM,kBAAkB,SAAU,CAAC;AAC1C,+DAA+D;AAC/D,eAAO,MAAM,sBAAsB,UAAY,CAAC;AAIhD,wEAAwE;AACxE,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAmCpD;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAGpE;AAED,KAAK,WAAW,GAAG,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;AAElF;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,WAAW,EAClB,GAAG,GAAE,MAA2B,GAC/B,OAAO,CAAC,IAAI,CAAC,CAoCf;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAa5B;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAc5B;AAED,+EAA+E;AAC/E,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,GAC5C,IAAI,CAaN;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,SAAS,SAAS,EAAE,CAAC,CA0E/B;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,SAAS,SAAS,EAAE,CAAC,CAc/B"}