@clarvis/agent-tools 0.1.0

package/dist/lib/atomic.js

@@ -0,0 +1,307 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { ToolError } from "../errors.js";
+import { uniqueToken } from "./token.js";
+const locks = new Map();
+export function withFileLock(absPath, fn) {
+    const prev = locks.get(absPath) ?? Promise.resolve();
+    const next = prev.then(fn, fn);
+    const tail = next
+        .catch(() => { })
+        .finally(() => {
+        if (locks.get(absPath) === tail)
+            locks.delete(absPath);
+    });
+    locks.set(absPath, tail);
+    return next;
+}
+export function withFileLocks(paths, fn) {
+    const sorted = [...new Set(paths)].sort();
+    return sorted.reduceRight((acc, p) => () => withFileLock(p, acc), fn)();
+}
+function tempPath(target) {
+    const dir = path.dirname(target);
+    return path.join(dir, `.clarvis-tmp-${uniqueToken()}`);
+}
+async function stage(target, content) {
+    const dir = path.dirname(target);
+    const createdDir = await fs.mkdir(dir, { recursive: true });
+    const tmp = tempPath(target);
+    const fh = await fs.open(tmp, "wx");
+    try {
+        await fh.writeFile(content, "utf8");
+        await fh.sync();
+    }
+    finally {
+        await fh.close();
+    }
+    return { tmp, createdDir };
+}
+async function removeCreatedDirs(dirs) {
+    for (const dir of dirs) {
+        if (dir !== undefined)
+            await fs.rm(dir, { recursive: true, force: true }).catch(() => { });
+    }
+}
+async function captureMode(target) {
+    try {
+        return (await fs.stat(target)).mode & 0o777;
+    }
+    catch {
+        return undefined;
+    }
+}
+async function assertNotSymlink(target) {
+    const lst = await fs.lstat(target).catch(() => null);
+    if (lst?.isSymbolicLink()) {
+        throw new ToolError("invalid_input", `Refusing to write through a symlink: ${target}`, {
+            path: target,
+        });
+    }
+}
+async function fsyncDir(dir) {
+    let dh;
+    try {
+        dh = await fs.open(dir, "r");
+    }
+    catch {
+        return;
+    }
+    try {
+        await dh.sync();
+    }
+    catch {
+        return;
+    }
+    finally {
+        await dh.close();
+    }
+}
+export async function writeAtomic(target, content) {
+    await assertNotSymlink(target);
+    const { tmp, createdDir } = await stage(target, content);
+    try {
+        const mode = await captureMode(target);
+        if (mode !== undefined)
+            await fs.chmod(tmp, mode);
+        await fs.rename(tmp, target);
+    }
+    catch (err) {
+        await fs.rm(tmp, { force: true });
+        await removeCreatedDirs([createdDir]);
+        throw err;
+    }
+    await fsyncDir(path.dirname(target));
+}
+async function cleanupStaged(staged) {
+    for (const tmp of staged.values())
+        await fs.rm(tmp, { force: true }).catch(() => { });
+}
+async function stageAll(ops, createdDirs) {
+    const staged = new Map();
+    try {
+        for (const op of ops) {
+            if (op.type === "create" || op.type === "modify") {
+                const { tmp, createdDir } = await stage(op.path, op.content ?? "");
+                staged.set(op.path, tmp);
+                createdDirs.push(createdDir);
+            }
+            else if (op.type === "rename") {
+                if (op.content !== undefined) {
+                    const { tmp, createdDir } = await stage(op.path, op.content);
+                    staged.set(op.path, tmp);
+                    createdDirs.push(createdDir);
+                }
+                else {
+                    createdDirs.push(await fs.mkdir(path.dirname(op.path), { recursive: true }));
+                }
+            }
+        }
+    }
+    catch (err) {
+        await cleanupStaged(staged);
+        throw err;
+    }
+    return staged;
+}
+async function validateTargets(ops) {
+    const modes = new Map();
+    for (const op of ops) {
+        if (op.type === "rename") {
+            const from = op.from;
+            const to = op.path;
+            await assertNotSymlink(from);
+            await assertNotSymlink(to);
+            let stFrom;
+            try {
+                stFrom = await fs.stat(from);
+            }
+            catch (err) {
+                if (err.code === "ENOENT") {
+                    throw new ToolError("not_found", `Rename source does not exist: ${from}`, { path: from });
+                }
+                throw err;
+            }
+            if (stFrom.isDirectory()) {
+                throw new ToolError("not_a_file", `Rename source is a directory: ${from}`, { path: from });
+            }
+            let toExists = true;
+            try {
+                await fs.stat(to);
+            }
+            catch (err) {
+                if (err.code === "ENOENT")
+                    toExists = false;
+                else
+                    throw err;
+            }
+            if (toExists) {
+                throw new ToolError("invalid_input", `Rename destination already exists: ${to}`, {
+                    path: to,
+                });
+            }
+            modes.set(to, stFrom.mode & 0o777);
+            continue;
+        }
+        await assertNotSymlink(op.path);
+        let st;
+        try {
+            st = await fs.stat(op.path);
+        }
+        catch (err) {
+            if (err.code !== "ENOENT")
+                throw err;
+            modes.set(op.path, undefined);
+            continue;
+        }
+        if (st.isDirectory()) {
+            throw new ToolError("not_a_file", `Path is a directory: ${op.path}`, { path: op.path });
+        }
+        modes.set(op.path, st.mode & 0o777);
+    }
+    return modes;
+}
+async function commitWithRollback(ops, staged, modes) {
+    const committed = [];
+    try {
+        for (const op of ops) {
+            if (op.type === "rename") {
+                const from = op.from;
+                const to = op.path;
+                const mode = modes.get(to);
+                const rec = { op, backup: undefined };
+                committed.push(rec);
+                const tmp = staged.get(to);
+                if (tmp !== undefined) {
+                    const fromBkp = tempPath(from);
+                    await fs.rename(from, fromBkp);
+                    rec.fromBackup = fromBkp;
+                    if (mode !== undefined)
+                        await fs.chmod(tmp, mode);
+                    await fs.rename(tmp, to);
+                }
+                else {
+                    await fs.rename(from, to);
+                    rec.renamed = true;
+                }
+                continue;
+            }
+            const mode = modes.get(op.path);
+            let backup;
+            const bkp = tempPath(op.path);
+            try {
+                await fs.rename(op.path, bkp);
+                backup = bkp;
+            }
+            catch (err) {
+                if (err.code !== "ENOENT")
+                    throw err;
+                backup = undefined;
+            }
+            committed.push({ op, backup });
+            if (op.type !== "delete") {
+                const tmp = staged.get(op.path);
+                if (tmp === undefined)
+                    throw new Error(`internal: no staged content for ${op.path}`);
+                if (mode !== undefined)
+                    await fs.chmod(tmp, mode);
+                await fs.rename(tmp, op.path);
+            }
+        }
+    }
+    catch (err) {
+        const unrestored = [];
+        for (let i = committed.length - 1; i >= 0; i--) {
+            const rec = committed[i];
+            const { op, backup } = rec;
+            try {
+                if (op.type === "rename") {
+                    const from = op.from;
+                    const to = op.path;
+                    if (rec.fromBackup !== undefined) {
+                        await fs.rm(to, { force: true });
+                        await fs.rename(rec.fromBackup, from);
+                    }
+                    else if (rec.renamed) {
+                        await fs.rename(to, from);
+                    }
+                    continue;
+                }
+                if (op.type !== "delete")
+                    await fs.rm(op.path, { force: true });
+                if (backup !== undefined)
+                    await fs.rename(backup, op.path);
+            }
+            catch {
+                if (op.type === "rename" && rec.renamed && rec.fromBackup === undefined) {
+                    unrestored.push(`${op.from} (original content preserved at ${op.path})`);
+                }
+                else {
+                    unrestored.push(`${op.type === "rename" ? op.from : op.path} ` +
+                        "(original content preserved in an adjacent .clarvis-tmp-* backup)");
+                }
+            }
+        }
+        await cleanupStaged(staged);
+        if (unrestored.length > 0) {
+            throw new ToolError("io_error", `${err.message}; rollback could not restore ${unrestored.join(", ")}`);
+        }
+        throw err;
+    }
+    return committed;
+}
+export async function applyOpsAtomic(ops) {
+    const createdDirs = [];
+    try {
+        const staged = await stageAll(ops, createdDirs);
+        let modes;
+        try {
+            modes = await validateTargets(ops);
+        }
+        catch (err) {
+            await cleanupStaged(staged);
+            throw err;
+        }
+        const committed = await commitWithRollback(ops, staged, modes);
+        const dirs = new Set();
+        for (const op of ops) {
+            dirs.add(path.dirname(op.path));
+            if (op.type === "rename" && op.from !== undefined)
+                dirs.add(path.dirname(op.from));
+        }
+        for (const dir of dirs) {
+            await fsyncDir(dir);
+        }
+        for (const { backup, fromBackup } of committed) {
+            if (backup !== undefined)
+                await fs.rm(backup, { force: true }).catch(() => { });
+            if (fromBackup !== undefined)
+                await fs.rm(fromBackup, { force: true }).catch(() => { });
+        }
+    }
+    catch (err) {
+        await removeCreatedDirs(createdDirs);
+        throw err;
+    }
+}
+//# sourceMappingURL=atomic.js.map

package/dist/lib/atomic.js.map

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

package/dist/lib/binary.d.ts

@@ -0,0 +1,3 @@
+export declare function isBinary(buf: Buffer): boolean;
+export declare function isUtf16Bom(buf: Buffer): boolean;
+//# sourceMappingURL=binary.d.ts.map

package/dist/lib/binary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary.d.ts","sourceRoot":"","sources":["../../src/lib/binary.ts"],"names":[],"mappings":"AAEA,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAW7C;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAK/C"}

package/dist/lib/binary.js

@@ -0,0 +1,20 @@
+const SCAN_BYTES = 8000;
+export function isBinary(buf) {
+    const head = Math.min(buf.length, SCAN_BYTES);
+    for (let i = 0; i < head; i++) {
+        if (buf[i] === 0)
+            return true;
+    }
+    if (buf.length > SCAN_BYTES) {
+        for (let i = Math.max(head, buf.length - SCAN_BYTES); i < buf.length; i++) {
+            if (buf[i] === 0)
+                return true;
+        }
+    }
+    return false;
+}
+export function isUtf16Bom(buf) {
+    return (buf.length >= 2 &&
+        ((buf[0] === 0xff && buf[1] === 0xfe) || (buf[0] === 0xfe && buf[1] === 0xff)));
+}
+//# sourceMappingURL=binary.js.map

package/dist/lib/binary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary.js","sourceRoot":"","sources":["../../src/lib/binary.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,GAAG,IAAI,CAAC;AAExB,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC9C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9B,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;IAChC,CAAC;IACD,IAAI,GAAG,CAAC,MAAM,GAAG,UAAU,EAAE,CAAC;QAC5B,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,GAAG,UAAU,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1E,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC;QAChC,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,OAAO,CACL,GAAG,CAAC,MAAM,IAAI,CAAC;QACf,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAC/E,CAAC;AACJ,CAAC"}

package/dist/lib/files.d.ts

@@ -0,0 +1,9 @@
+import { type Stats } from "node:fs";
+export declare const STAT_CONCURRENCY = 32;
+export declare function statDirectory(absPath: string, relForError: string): Promise<Stats>;
+export declare function mapLimit<T, R>(items: T[], limit: number, fn: (item: T) => Promise<R>): Promise<R[]>;
+export declare function listFiles(base: string, workspaceRoot: string, opts: {
+    pattern: string;
+    respectGitignore: boolean;
+}): Promise<string[]>;
+//# sourceMappingURL=files.d.ts.map

package/dist/lib/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/lib/files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,KAAK,EAAE,MAAM,SAAS,CAAC;AAMrD,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAEnC,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAWxF;AAED,wBAAsB,QAAQ,CAAC,CAAC,EAAE,CAAC,EACjC,KAAK,EAAE,CAAC,EAAE,EACV,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAC1B,OAAO,CAAC,CAAC,EAAE,CAAC,CAWd;AAED,wBAAsB,SAAS,CAC7B,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,OAAO,CAAA;CAAE,GACnD,OAAO,CAAC,MAAM,EAAE,CAAC,CAenB"}

package/dist/lib/files.js

@@ -0,0 +1,49 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { glob as tinyglob } from "tinyglobby";
+import { ToolError, fsError } from "../errors.js";
+import { loadIgnore } from "./ignore.js";
+export const STAT_CONCURRENCY = 32;
+export async function statDirectory(absPath, relForError) {
+    let stat;
+    try {
+        stat = await fs.stat(absPath);
+    }
+    catch (err) {
+        throw fsError(err, relForError);
+    }
+    if (!stat.isDirectory()) {
+        throw new ToolError("not_a_file", `Not a directory: ${relForError}`, { path: relForError });
+    }
+    return stat;
+}
+export async function mapLimit(items, limit, fn) {
+    const results = new Array(items.length);
+    let next = 0;
+    async function worker() {
+        while (next < items.length) {
+            const idx = next++;
+            results[idx] = await fn(items[idx]);
+        }
+    }
+    await Promise.all(Array.from({ length: Math.min(limit, items.length) }, () => worker()));
+    return results;
+}
+export async function listFiles(base, workspaceRoot, opts) {
+    const rels = await tinyglob(opts.pattern, {
+        cwd: base,
+        dot: true,
+        onlyFiles: true,
+        absolute: false,
+    });
+    const ig = opts.respectGitignore ? loadIgnore(workspaceRoot) : null;
+    const kept = [];
+    for (const rel of rels) {
+        const abs = path.resolve(base, rel);
+        if (ig && ig.ignores(path.relative(workspaceRoot, abs)))
+            continue;
+        kept.push(abs);
+    }
+    return kept;
+}
+//# sourceMappingURL=files.js.map

package/dist/lib/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../../src/lib/files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAc,MAAM,SAAS,CAAC;AACrD,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,IAAI,IAAI,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAEnC,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAe,EAAE,WAAmB;IACtE,IAAI,IAAI,CAAC;IACT,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,CAAC,GAA4B,EAAE,WAAW,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;QACxB,MAAM,IAAI,SAAS,CAAC,YAAY,EAAE,oBAAoB,WAAW,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;IAC9F,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,KAAU,EACV,KAAa,EACb,EAA2B;IAE3B,MAAM,OAAO,GAAQ,IAAI,KAAK,CAAI,KAAK,CAAC,MAAM,CAAC,CAAC;IAChD,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,UAAU,MAAM;QACnB,OAAO,IAAI,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YAC3B,MAAM,GAAG,GAAG,IAAI,EAAE,CAAC;YACnB,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,CAAE,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IACD,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACzF,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,IAAY,EACZ,aAAqB,EACrB,IAAoD;IAEpD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE;QACxC,GAAG,EAAE,IAAI;QACT,GAAG,EAAE,IAAI;QACT,SAAS,EAAE,IAAI;QACf,QAAQ,EAAE,KAAK;KAChB,CAAC,CAAC;IACH,MAAM,EAAE,GAAG,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACpE,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACpC,IAAI,EAAE,IAAI,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;YAAE,SAAS;QAClE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/lib/ignore.d.ts

@@ -0,0 +1,5 @@
+export interface Matcher {
+    ignores(relPath: string): boolean;
+}
+export declare function loadIgnore(workspaceRoot: string): Matcher;
+//# sourceMappingURL=ignore.d.ts.map

package/dist/lib/ignore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ignore.d.ts","sourceRoot":"","sources":["../../src/lib/ignore.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,OAAO;IACtB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;CACnC;AAgCD,wBAAgB,UAAU,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAoEzD"}

package/dist/lib/ignore.js

@@ -0,0 +1,106 @@
+import { createRequire } from "node:module";
+import { existsSync, readFileSync } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { warn } from "./log.js";
+const makeIgnore = createRequire(import.meta.url)("ignore");
+function readFileSafe(p) {
+    try {
+        return readFileSync(p, "utf8");
+    }
+    catch {
+        return undefined;
+    }
+}
+function findIgnoreRoot(start) {
+    let dir = start;
+    for (;;) {
+        if (existsSync(path.join(dir, ".git")))
+            return dir;
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            return start;
+        dir = parent;
+    }
+}
+function globalExcludesPath() {
+    const xdg = process.env.XDG_CONFIG_HOME;
+    const candidate = xdg
+        ? path.join(xdg, "git", "ignore")
+        : path.join(os.homedir(), ".config", "git", "ignore");
+    return existsSync(candidate) ? candidate : undefined;
+}
+function toPosix(p) {
+    return p.split(path.sep).join("/");
+}
+export function loadIgnore(workspaceRoot) {
+    const ignoreRoot = findIgnoreRoot(workspaceRoot);
+    const base = makeIgnore();
+    base.add(".git\n.clarvis\n.clarvis-tmp-*");
+    const infoExclude = readFileSafe(path.join(ignoreRoot, ".git", "info", "exclude"));
+    if (infoExclude !== undefined)
+        base.add(infoExclude);
+    const globalPath = globalExcludesPath();
+    if (globalPath) {
+        const g = readFileSafe(globalPath);
+        if (g !== undefined)
+            base.add(g);
+    }
+    const perDir = new Map();
+    function dirMatcher(dir) {
+        const cached = perDir.get(dir);
+        if (cached !== undefined)
+            return cached;
+        const gitignorePath = path.join(dir, ".gitignore");
+        const content = readFileSafe(gitignorePath);
+        if (content === undefined && existsSync(gitignorePath)) {
+            warn(`clarvis-agent-tools: warning: cannot read ${gitignorePath}\n`);
+        }
+        const m = content !== undefined ? makeIgnore().add(content) : null;
+        perDir.set(dir, m);
+        return m;
+    }
+    function dirsFromRootTo(dir) {
+        const chain = [];
+        let cur = dir;
+        for (;;) {
+            chain.push(cur);
+            if (cur === ignoreRoot)
+                return chain.reverse();
+            const parent = path.dirname(cur);
+            if (parent === cur)
+                return [];
+            cur = parent;
+        }
+    }
+    function apply(m, rel, current) {
+        if (!rel || rel.startsWith("../"))
+            return current;
+        const r = m.test(rel);
+        if (r.ignored)
+            return true;
+        if (r.unignored)
+            return false;
+        return current;
+    }
+    return {
+        ignores(relPath) {
+            if (!relPath || relPath === ".")
+                return false;
+            const norm = toPosix(relPath);
+            if (norm.startsWith("../") || path.isAbsolute(norm))
+                return false;
+            const abs = path.resolve(workspaceRoot, relPath);
+            if (toPosix(path.relative(ignoreRoot, abs)).split("/").includes(".git"))
+                return true;
+            let decision = apply(base, toPosix(path.relative(ignoreRoot, abs)), undefined);
+            for (const dir of dirsFromRootTo(path.dirname(abs))) {
+                const m = dirMatcher(dir);
+                if (m)
+                    decision = apply(m, toPosix(path.relative(dir, abs)), decision);
+            }
+            return decision === true;
+        },
+    };
+}
+//# sourceMappingURL=ignore.js.map

package/dist/lib/ignore.js.map

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

package/dist/lib/log.d.ts

@@ -0,0 +1,4 @@
+export type WarnSink = (message: string) => void;
+export declare function warn(message: string): void;
+export declare function setWarnSink(fn: WarnSink | null): void;
+//# sourceMappingURL=log.d.ts.map

package/dist/lib/log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../src/lib/log.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;AAQjD,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI,CAErD"}

package/dist/lib/log.js

@@ -0,0 +1,11 @@
+const defaultSink = (message) => {
+    process.stderr.write(message);
+};
+let sink = defaultSink;
+export function warn(message) {
+    sink(message);
+}
+export function setWarnSink(fn) {
+    sink = fn ?? defaultSink;
+}
+//# sourceMappingURL=log.js.map

package/dist/lib/log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../../src/lib/log.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,GAAa,CAAC,OAAO,EAAE,EAAE;IACxC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC,CAAC;AAEF,IAAI,IAAI,GAAa,WAAW,CAAC;AAEjC,MAAM,UAAU,IAAI,CAAC,OAAe;IAClC,IAAI,CAAC,OAAO,CAAC,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,EAAmB;IAC7C,IAAI,GAAG,EAAE,IAAI,WAAW,CAAC;AAC3B,CAAC"}

package/dist/lib/match-cascade.d.ts

@@ -0,0 +1,10 @@
+export interface Span {
+    start: number;
+    end: number;
+}
+export declare const trimEnds: (s: string) => string;
+export declare function scanLineBlocks(hay: string[], need: string[], eq: (hayLine: string, needLine: string) => boolean, cap?: number): number[];
+export declare function findCascadeMatch(text: string, oldString: string): {
+    spans: Span[];
+} | null;
+//# sourceMappingURL=match-cascade.d.ts.map

package/dist/lib/match-cascade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"match-cascade.d.ts","sourceRoot":"","sources":["../../src/lib/match-cascade.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,IAAI;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,eAAO,MAAM,QAAQ,GAAI,GAAG,MAAM,KAAG,MAAyD,CAAC;AA0B/F,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EAAE,EACb,IAAI,EAAE,MAAM,EAAE,EACd,EAAE,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,EAClD,GAAG,SAAW,GACb,MAAM,EAAE,CAiBV;AAkGD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,IAAI,EAAE,CAAA;CAAE,GAAG,IAAI,CAyB1F"}