@prestyj/cli 5.11.0 → 5.12.0

package/dist/tools/grep-parity.test.js

@@ -0,0 +1,92 @@
+import { beforeAll, describe, expect, it } from "vitest";
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { createGrepTool, detectExternalScanner } from "./grep.js";
+function context() {
+    return { signal: new AbortController().signal, toolCallId: "test" };
+}
+/**
+ * One fixture covering the inputs where two regex engines and two file walkers
+ * are most likely to disagree: dot-directories, ignored paths, non-ASCII text,
+ * CRLF endings, a line past the truncation cap, and a binary blob.
+ */
+async function makeFixture() {
+    const dir = await fs.mkdtemp(path.join(os.tmpdir(), "ez-grep-parity-"));
+    const files = {
+        ".gitignore": "ignored/\n*.min.js\n",
+        ".github/workflows/ci.yml": "name: ci\njobs:\n  build:\n    runs-on: ubuntu-latest\n",
+        "src/alpha.ts": "export const alpha = 1;\nconst TOKEN = 'alpha';\n// alpha again\n",
+        "src/beta.ts": "export function beta() {\n  return 'ALPHA';\n}\n",
+        // A nested ignore file must NOT take effect: only the search root's
+        // .gitignore applies, on both scanner paths.
+        "src/nested/.gitignore": "deep/\n",
+        "src/nested/deep/gamma.ts": "// alpha in a deep file\nexport const gamma = 2;\n",
+        "src/unicode.ts": "const caf\u00e9 = '\u00e9l\u00e8ve \u2014 alpha';\nconst \u65e5\u672c = 'alpha \u6f22\u5b57';\n",
+        "src/crlf.ts": "const a = 1;\r\nconst alpha = 2;\r\nconst c = 3;\r\n",
+        "src/long.ts": `const long = "${"alpha ".repeat(120)}";\n`,
+        "ignored/hidden.ts": "export const alpha = 'should not be searched';\n",
+        "vendor/bundle.min.js": "var alpha=1;\n",
+        "docs/notes.md": "Alpha, beta and gamma.\n",
+    };
+    for (const [rel, content] of Object.entries(files)) {
+        const abs = path.join(dir, rel);
+        await fs.mkdir(path.dirname(abs), { recursive: true });
+        await fs.writeFile(abs, content);
+    }
+    await fs
+        .writeFile(path.join(dir, "assets", "blob.bin"), Buffer.from([0, 1, 2, 97, 108, 112, 104, 97, 0, 3]))
+        .catch(async () => {
+        await fs.mkdir(path.join(dir, "assets"), { recursive: true });
+        await fs.writeFile(path.join(dir, "assets", "blob.bin"), Buffer.from([0, 1, 2, 97, 108, 112, 104, 97, 0, 3]));
+    });
+    return dir;
+}
+const queries = [
+    { label: "literal", args: { pattern: "alpha", max_results: 200 } },
+    {
+        label: "case-insensitive",
+        args: { pattern: "alpha", case_insensitive: true, max_results: 200 },
+    },
+    { label: "inline (?i) flag", args: { pattern: "(?i)ALPHA", max_results: 200 } },
+    { label: "anchored", args: { pattern: "^export ", max_results: 200 } },
+    { label: "character class", args: { pattern: "const [a-z]+ =", max_results: 200 } },
+    { label: "include filter", args: { pattern: "alpha", include: "*.ts", max_results: 200 } },
+    { label: "unicode literal", args: { pattern: "\u6f22\u5b57", max_results: 200 } },
+    { label: "result cap", args: { pattern: "alpha", max_results: 3 } },
+    { label: "no matches", args: { pattern: "zzz-not-present-zzz", max_results: 200 } },
+];
+let externalAvailable = false;
+beforeAll(async () => {
+    externalAvailable = (await detectExternalScanner()) !== undefined;
+});
+describe("grep scanner parity", () => {
+    it.each(queries)("returns identical output for $label", async ({ args }) => {
+        if (!externalAvailable) {
+            // `rg` is optional. Skipping loudly beats a silently green run.
+            console.warn("skipping grep parity: the external scanner `rg` is not on PATH");
+            return;
+        }
+        const dir = await makeFixture();
+        const inProcess = await createGrepTool(dir, undefined, {
+            useExternalScanner: () => false,
+        }).execute(args, context());
+        const external = await createGrepTool(dir, undefined, {
+            useExternalScanner: () => true,
+        }).execute(args, context());
+        expect(String(external)).toBe(String(inProcess));
+    });
+    it("falls back in-process for lookahead, which the external engine cannot run", async () => {
+        const dir = await makeFixture();
+        const args = { pattern: "alpha(?= again)", max_results: 200 };
+        const forced = await createGrepTool(dir, undefined, {
+            useExternalScanner: () => true,
+        }).execute(args, context());
+        const reference = await createGrepTool(dir, undefined, {
+            useExternalScanner: () => false,
+        }).execute(args, context());
+        expect(String(forced)).toBe(String(reference));
+        expect(String(forced)).toContain("alpha again");
+    });
+});
+//# sourceMappingURL=grep-parity.test.js.map

package/dist/tools/grep-parity.test.js.map

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

package/dist/tools/grep-recall.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=grep-recall.test.d.ts.map

package/dist/tools/grep-recall.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grep-recall.test.d.ts","sourceRoot":"","sources":["../../src/tools/grep-recall.test.ts"],"names":[],"mappings":""}

package/dist/tools/grep-recall.test.js

@@ -0,0 +1,114 @@
+import { describe, expect, it } from "vitest";
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import readline from "node:readline";
+import { createReadStream } from "node:fs";
+import { createGrepTool } from "./grep.js";
+function context() {
+    return { signal: new AbortController().signal, toolCallId: "test" };
+}
+async function makeFixture(files) {
+    const dir = await fs.mkdtemp(path.join(os.tmpdir(), "ez-grep-recall-"));
+    for (const [rel, content] of Object.entries(files)) {
+        const abs = path.join(dir, rel);
+        await fs.mkdir(path.dirname(abs), { recursive: true });
+        await fs.writeFile(abs, content);
+    }
+    return dir;
+}
+/** Both scanner paths, so recall is asserted for whichever one a host uses. */
+const scanners = [
+    { label: "in-process", useExternalScanner: () => false },
+    { label: "external", useExternalScanner: () => true },
+];
+describe.each(scanners)("grep recall ($label)", ({ useExternalScanner }) => {
+    const grep = (dir) => createGrepTool(dir, undefined, { useExternalScanner });
+    it("searches dot-directories", async () => {
+        const dir = await makeFixture({
+            ".github/workflows/ci.yml": "jobs:\n  build:\n    runs-on: ubuntu-latest\n",
+            "README.md": "no jobs here\n",
+        });
+        const result = await grep(dir).execute({ pattern: "runs-on" }, context());
+        expect(result).toContain(path.join(".github", "workflows", "ci.yml") + ":3:");
+    });
+    it("skips files matched by .gitignore", async () => {
+        const dir = await makeFixture({
+            ".gitignore": "dist/\n*.log\n",
+            "src/app.ts": "export const marker = 1;\n",
+            "dist/app.js": "export const marker = 1;\n",
+            "debug.log": "marker\n",
+        });
+        const result = await grep(dir).execute({ pattern: "marker" }, context());
+        expect(result).toContain(path.join("src", "app.ts") + ":1:");
+        expect(result).not.toContain("dist");
+        expect(result).not.toContain("debug.log");
+    });
+    it("still searches an ignored directory when it is the explicit path", async () => {
+        const dir = await makeFixture({
+            ".gitignore": "dist/\n",
+            "dist/app.js": "export const marker = 1;\n",
+        });
+        const result = await grep(dir).execute({ pattern: "marker", path: "dist" }, context());
+        expect(result).toContain("app.js:1:");
+    });
+    it("never scans node_modules or .git", async () => {
+        const dir = await makeFixture({
+            "node_modules/dep/index.js": "marker\n",
+            ".git/COMMIT_EDITMSG": "marker\n",
+            "src/keep.ts": "marker\n",
+        });
+        const result = await grep(dir).execute({ pattern: "marker" }, context());
+        expect(result).toContain(path.join("src", "keep.ts") + ":1:");
+        expect(result).not.toContain("node_modules");
+        expect(result).not.toContain(".git");
+    });
+});
+describe("grep scan ordering", () => {
+    it("matches a sequential scan over the same candidate list", async () => {
+        const files = {};
+        // Enough files to fill several scan waves, with matches spread across them.
+        for (let i = 0; i < 50; i++) {
+            files[`pkg${String(i).padStart(2, "0")}/mod.ts`] =
+                `line one\nconst marker${i} = ${i};\nmarker tail\n`;
+        }
+        const dir = await makeFixture(files);
+        const parallel = await createGrepTool(dir, undefined, {
+            useExternalScanner: () => false,
+        }).execute({ pattern: "marker", max_results: 500 }, context());
+        const expected = await sequentialScan(dir, /marker/g);
+        expect(String(parallel).split("\n\n")[0]).toBe(expected.join("\n"));
+    });
+});
+/**
+ * Reference implementation: one file at a time, candidates in sorted order.
+ *
+ * fast-glob always yields POSIX-separated paths, while the tool reports
+ * `path.relative` output — native separators, so backslashes on Windows.
+ * Normalizing here keeps this test about ORDER and CONTENT; asserting the raw
+ * glob strings instead silently made it a path-format test that only failed on
+ * Windows.
+ */
+async function sequentialScan(dir, regex) {
+    const fg = await import("fast-glob");
+    const entries = (await fg.default("**/*", { cwd: dir, dot: true, onlyFiles: true, suppressErrors: true }))
+        .sort()
+        .map((entry) => path.normalize(entry));
+    const results = [];
+    for (const entry of entries) {
+        const rl = readline.createInterface({
+            input: createReadStream(path.join(dir, entry), "utf-8"),
+            crlfDelay: Infinity,
+        });
+        let lineNum = 0;
+        for await (const line of rl) {
+            lineNum++;
+            regex.lastIndex = 0;
+            if (regex.test(line))
+                results.push(`${entry}:${lineNum}:${line}`);
+        }
+        rl.close();
+    }
+    return results;
+}
+//# sourceMappingURL=grep-recall.test.js.map

package/dist/tools/grep-recall.test.js.map

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

package/dist/tools/grep-spawn.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=grep-spawn.test.d.ts.map

package/dist/tools/grep-spawn.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grep-spawn.test.d.ts","sourceRoot":"","sources":["../../src/tools/grep-spawn.test.ts"],"names":[],"mappings":""}

package/dist/tools/grep-spawn.test.js

@@ -0,0 +1,66 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+const spawnMock = vi.hoisted(() => vi.fn());
+// Importing `spawn` from the mocked module would hand back the mock itself, so
+// delegating to it recurses. Capture the genuine implementation inside the mock
+// factory instead.
+const actualSpawn = vi.hoisted(() => ({ fn: undefined }));
+vi.mock("node:child_process", async () => {
+    const actual = await vi.importActual("node:child_process");
+    actualSpawn.fn = actual.spawn;
+    return { ...actual, spawn: spawnMock };
+});
+const { createGrepTool, detectExternalScanner, resetExternalScannerProbe } = await import("./grep.js");
+function context() {
+    return { signal: new AbortController().signal, toolCallId: "test" };
+}
+let tmpDir;
+beforeEach(async () => {
+    tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), "ez-grep-spawn-"));
+    await fs.writeFile(path.join(tmpDir, "a.ts"), "const marker = 1;\n");
+    resetExternalScannerProbe();
+    spawnMock.mockReset();
+    // Delegate to the genuine spawn so the tool behaves normally; we only assert
+    // the options it was handed.
+    spawnMock.mockImplementation((...args) => actualSpawn.fn(...args));
+});
+afterEach(async () => {
+    resetExternalScannerProbe();
+    await fs.rm(tmpDir, { recursive: true, force: true });
+});
+describe("grep external scanner spawn options", () => {
+    it("hides the console window when probing for the scanner", async () => {
+        await detectExternalScanner();
+        expect(spawnMock).toHaveBeenCalledWith("rg", ["--version"], expect.objectContaining({ windowsHide: true }));
+    });
+    it("hides the console window when running a search", async () => {
+        const tool = createGrepTool(tmpDir, undefined, { useExternalScanner: () => true });
+        await tool.execute({ pattern: "marker" }, context());
+        const searchCall = spawnMock.mock.calls.find((call) => Array.isArray(call[1]) && !call[1].includes("--version"));
+        // `rg` is optional. When it is absent the in-process path legitimately
+        // never spawns — but assert that is the actual reason, so this test can
+        // never pass merely because the search silently failed to run.
+        if (!searchCall) {
+            expect(await detectExternalScanner()).toBeUndefined();
+            return;
+        }
+        expect(searchCall[2]).toEqual(expect.objectContaining({ windowsHide: true }));
+        expect(searchCall[2]).toEqual(expect.objectContaining({ cwd: tmpDir }));
+    });
+    it("never spawns a scan once the budget is already spent", async () => {
+        const tool = createGrepTool(tmpDir, undefined, {
+            useExternalScanner: () => true,
+            deadlineMs: 0,
+        });
+        const result = String(await tool.execute({ pattern: "marker" }, context()));
+        // The child's budget is floored at 1ms, so spawning here would race the
+        // scanner: whenever the child won, an expired budget still returned real
+        // matches — and only sometimes, which is how it slipped through as a flake.
+        expect(spawnMock).not.toHaveBeenCalled();
+        expect(result).toContain("No matches found.");
+        expect(result).not.toContain("a.ts:1:");
+    });
+});
+//# sourceMappingURL=grep-spawn.test.js.map

package/dist/tools/grep-spawn.test.js.map

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

package/dist/tools/grep.d.ts

@@ -8,8 +8,18 @@ declare const GrepParams: z.ZodObject<{
     max_results: z.ZodOptional<z.ZodNumber>;
     case_insensitive: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
-export declare function createGrepTool(cwd: string, ops?: ToolOperations, 
-/** Wall-clock budget for one call. Overridable so tests can trip it without a 5s wait. */
-deadlineMs?: number): AgentTool<typeof GrepParams>;
+export interface GrepToolOptions {
+    /** Wall-clock budget for one call. Overridable so tests can trip it without a 5s wait. */
+    deadlineMs?: number;
+    /**
+     * Whether the external `rg` scanner may be used when it is on PATH. Read
+     * lazily so a settings change takes effect without rebuilding the toolset.
+     */
+    useExternalScanner?: () => boolean;
+}
+export declare function createGrepTool(cwd: string, ops?: ToolOperations, options?: GrepToolOptions): AgentTool<typeof GrepParams>;
+export declare function detectExternalScanner(): Promise<string | undefined>;
+/** Test seam: forget the cached probe result. */
+export declare function resetExternalScannerProbe(): void;
 export {};
 //# sourceMappingURL=grep.d.ts.map

package/dist/tools/grep.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"grep.d.ts","sourceRoot":"","sources":["../../src/tools/grep.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAIhD,OAAO,EAAmB,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEvE,QAAA,MAAM,UAAU;;;;;;iBAWd,CAAC;AAiHH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,GAAG,GAAE,cAAgC;AACrC,0FAA0F;AAC1F,UAAU,GAAE,MAAyB,GACpC,SAAS,CAAC,OAAO,UAAU,CAAC,CA+F9B"}
+{"version":3,"file":"grep.d.ts","sourceRoot":"","sources":["../../src/tools/grep.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAIhD,OAAO,EAAmB,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEvE,QAAA,MAAM,UAAU;;;;;;iBAcd,CAAC;AA0HH,MAAM,WAAW,eAAe;IAC9B,0FAA0F;IAC1F,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,OAAO,CAAC;CACpC;AAED,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,GAAG,GAAE,cAAgC,EACrC,OAAO,GAAE,eAAoB,GAC5B,SAAS,CAAC,OAAO,UAAU,CAAC,CA4F9B;AA6JD,wBAAgB,qBAAqB,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAgBnE;AAED,iDAAiD;AACjD,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD"}