@zhijiewang/openharness 0.10.1 → 0.11.0

package/dist/utils/fs.js

@@ -0,0 +1,64 @@
+/**
+ * Shared filesystem utilities — directory walking and glob matching.
+ * Used by GrepTool, GlobTool, and other file-scanning tools.
+ */
+import * as fs from "fs/promises";
+import * as path from "path";
+/**
+ * Recursively walk a directory, returning all file paths.
+ * Skips dotfiles, node_modules, and unreadable directories.
+ */
+export async function walkDir(dir) {
+    const results = [];
+    try {
+        const entries = await fs.readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.name.startsWith(".") || entry.name === "node_modules")
+                continue;
+            const full = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                results.push(...(await walkDir(full)));
+            }
+            else {
+                results.push(full);
+            }
+        }
+    }
+    catch {
+        // skip unreadable directories
+    }
+    return results;
+}
+/**
+ * Match a file path against a glob pattern.
+ * Supports **, *, ?, and . escaping.
+ */
+export function matchGlob(filePath, pattern) {
+    const normalized = filePath.replace(/\\/g, "/");
+    const escaped = pattern
+        .replace(/\\/g, "/")
+        .split("")
+        .map((c, i, arr) => {
+        if (c === "*" && arr[i + 1] === "*")
+            return null;
+        if (c === "*" && arr[i - 1] === "*")
+            return "GLOBSTAR";
+        if (c === "*")
+            return "[^/]*";
+        if (c === "?")
+            return "[^/]";
+        if (c === ".")
+            return "\\.";
+        return c;
+    })
+        .filter((c) => c !== null)
+        .join("")
+        .replace(/GLOBSTAR/g, ".*");
+    try {
+        return new RegExp("(^|/)" + escaped + "$").test(normalized);
+    }
+    catch {
+        return normalized.includes(pattern.replace(/\*/g, ""));
+    }
+}
+//# sourceMappingURL=fs.js.map

package/dist/utils/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,GAAW;IACvC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc;gBAAE,SAAS;YAC1E,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACxC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACzC,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,8BAA8B;IAChC,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,QAAgB,EAAE,OAAe;IACzD,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,OAAO;SACpB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,KAAK,CAAC,EAAE,CAAC;SACT,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE;QACjB,IAAI,CAAC,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC;QACjD,IAAI,CAAC,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG;YAAE,OAAO,UAAU,CAAC;QACvD,IAAI,CAAC,KAAK,GAAG;YAAE,OAAO,OAAO,CAAC;QAC9B,IAAI,CAAC,KAAK,GAAG;YAAE,OAAO,MAAM,CAAC;QAC7B,IAAI,CAAC,KAAK,GAAG;YAAE,OAAO,KAAK,CAAC;QAC5B,OAAO,CAAC,CAAC;IACX,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC;SACzB,IAAI,CAAC,EAAE,CAAC;SACR,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IAC9B,IAAI,CAAC;QACH,OAAO,IAAI,MAAM,CAAC,OAAO,GAAG,OAAO,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC9D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;IACzD,CAAC;AACH,CAAC"}

package/dist/utils/fs.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Tests for shared filesystem utilities — walkDir and matchGlob.
+ */
+export {};
+//# sourceMappingURL=fs.test.d.ts.map

package/dist/utils/fs.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.test.d.ts","sourceRoot":"","sources":["../../src/utils/fs.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/utils/fs.test.js

@@ -0,0 +1,82 @@
+/**
+ * Tests for shared filesystem utilities — walkDir and matchGlob.
+ */
+import { describe, it } from "node:test";
+import assert from "node:assert/strict";
+import { makeTmpDir, writeFile } from "../test-helpers.js";
+import { walkDir, matchGlob } from "./fs.js";
+describe("walkDir", () => {
+    it("finds files in a flat directory", async () => {
+        const tmp = makeTmpDir();
+        writeFile(tmp, "a.txt", "a");
+        writeFile(tmp, "b.txt", "b");
+        const files = await walkDir(tmp);
+        assert.equal(files.length, 2);
+        assert.ok(files.some(f => f.endsWith("a.txt")));
+        assert.ok(files.some(f => f.endsWith("b.txt")));
+    });
+    it("recurses into subdirectories", async () => {
+        const tmp = makeTmpDir();
+        writeFile(tmp, "top.txt", "t");
+        writeFile(tmp, "sub/nested.txt", "n");
+        writeFile(tmp, "sub/deep/deeper.txt", "d");
+        const files = await walkDir(tmp);
+        assert.equal(files.length, 3);
+        assert.ok(files.some(f => f.endsWith("deeper.txt")));
+    });
+    it("skips dotfiles and dotdirs", async () => {
+        const tmp = makeTmpDir();
+        writeFile(tmp, "visible.txt", "v");
+        writeFile(tmp, ".hidden", "h");
+        writeFile(tmp, ".git/config", "g");
+        const files = await walkDir(tmp);
+        assert.equal(files.length, 1);
+        assert.ok(files[0].endsWith("visible.txt"));
+    });
+    it("skips node_modules", async () => {
+        const tmp = makeTmpDir();
+        writeFile(tmp, "src/app.ts", "a");
+        writeFile(tmp, "node_modules/pkg/index.js", "b");
+        const files = await walkDir(tmp);
+        assert.equal(files.length, 1);
+        assert.ok(files[0].endsWith("app.ts"));
+    });
+    it("returns empty for nonexistent directory", async () => {
+        const files = await walkDir("/nonexistent/path/xyz");
+        assert.deepEqual(files, []);
+    });
+    it("returns empty for empty directory", async () => {
+        const tmp = makeTmpDir();
+        const files = await walkDir(tmp);
+        assert.deepEqual(files, []);
+    });
+});
+describe("matchGlob", () => {
+    it("matches simple filename", () => {
+        assert.equal(matchGlob("foo.txt", "foo.txt"), true);
+        assert.equal(matchGlob("foo.txt", "bar.txt"), false);
+    });
+    it("matches * wildcard", () => {
+        assert.equal(matchGlob("foo.txt", "*.txt"), true);
+        assert.equal(matchGlob("foo.js", "*.txt"), false);
+    });
+    it("matches ** globstar", () => {
+        assert.equal(matchGlob("src/utils/fs.ts", "**/*.ts"), true);
+        assert.equal(matchGlob("src/utils/fs.js", "**/*.ts"), false);
+    });
+    it("matches ? single char", () => {
+        assert.equal(matchGlob("a.txt", "?.txt"), true);
+        assert.equal(matchGlob("ab.txt", "?.txt"), false);
+    });
+    it("handles dotfiles in pattern", () => {
+        assert.equal(matchGlob(".eslintrc.json", ".eslintrc.json"), true);
+    });
+    it("handles backslash paths (Windows)", () => {
+        assert.equal(matchGlob("src\\utils\\fs.ts", "**/*.ts"), true);
+    });
+    it("matches nested glob patterns", () => {
+        assert.equal(matchGlob("src/components/Button.tsx", "src/**/*.tsx"), true);
+        assert.equal(matchGlob("test/components/Button.tsx", "src/**/*.tsx"), false);
+    });
+});
+//# sourceMappingURL=fs.test.js.map

package/dist/utils/fs.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.test.js","sourceRoot":"","sources":["../../src/utils/fs.test.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAE7C,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE;IACvB,EAAE,CAAC,iCAAiC,EAAE,KAAK,IAAI,EAAE;QAC/C,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;QACzB,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;QAC7B,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;QAC7B,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAC9B,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAChD,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,KAAK,IAAI,EAAE;QAC5C,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;QACzB,SAAS,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;QAC/B,SAAS,CAAC,GAAG,EAAE,gBAAgB,EAAE,GAAG,CAAC,CAAC;QACtC,SAAS,CAAC,GAAG,EAAE,qBAAqB,EAAE,GAAG,CAAC,CAAC;QAC3C,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAC9B,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,KAAK,IAAI,EAAE;QAC1C,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;QACzB,SAAS,CAAC,GAAG,EAAE,aAAa,EAAE,GAAG,CAAC,CAAC;QACnC,SAAS,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;QAC/B,SAAS,CAAC,GAAG,EAAE,aAAa,EAAE,GAAG,CAAC,CAAC;QACnC,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAC9B,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oBAAoB,EAAE,KAAK,IAAI,EAAE;QAClC,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;QACzB,SAAS,CAAC,GAAG,EAAE,YAAY,EAAE,GAAG,CAAC,CAAC;QAClC,SAAS,CAAC,GAAG,EAAE,2BAA2B,EAAE,GAAG,CAAC,CAAC;QACjD,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAC9B,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;QACvD,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,uBAAuB,CAAC,CAAC;QACrD,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,KAAK,IAAI,EAAE;QACjD,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;IACzB,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,IAAI,CAAC,CAAC;QACpD,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,KAAK,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oBAAoB,EAAE,GAAG,EAAE;QAC5B,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC;QAClD,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,KAAK,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qBAAqB,EAAE,GAAG,EAAE;QAC7B,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,iBAAiB,EAAE,SAAS,CAAC,EAAE,IAAI,CAAC,CAAC;QAC5D,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,iBAAiB,EAAE,SAAS,CAAC,EAAE,KAAK,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAC/B,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC;QAChD,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,KAAK,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,EAAE,IAAI,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,mBAAmB,EAAE,SAAS,CAAC,EAAE,IAAI,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,2BAA2B,EAAE,cAAc,CAAC,EAAE,IAAI,CAAC,CAAC;QAC3E,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,4BAA4B,EAAE,cAAc,CAAC,EAAE,KAAK,CAAC,CAAC;IAC/E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/utils/safe-env.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Safe environment variable filtering.
+ * Blocks credential-containing vars from being passed to subprocesses.
+ */
+/**
+ * Filter process.env to remove credential-containing variables.
+ * Merges optional extra env vars on top.
+ */
+export declare function safeEnv(extra?: Record<string, string>): Record<string, string>;
+//# sourceMappingURL=safe-env.d.ts.map

package/dist/utils/safe-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-env.d.ts","sourceRoot":"","sources":["../../src/utils/safe-env.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAoBH;;;GAGG;AACH,wBAAgB,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAW9E"}

package/dist/utils/safe-env.js

@@ -0,0 +1,40 @@
+/**
+ * Safe environment variable filtering.
+ * Blocks credential-containing vars from being passed to subprocesses.
+ */
+/** Env var names that should never be passed to subprocesses */
+const BLOCKED_PATTERNS = [
+    /^ANTHROPIC_API_KEY$/i,
+    /^OPENAI_API_KEY$/i,
+    /^OPENROUTER_API_KEY$/i,
+    /^AWS_SECRET/i,
+    /^AWS_SESSION_TOKEN$/i,
+    /^GCP_SERVICE_ACCOUNT/i,
+    /^GOOGLE_APPLICATION_CREDENTIALS$/i,
+    /^AZURE_.*KEY$/i,
+    /^GITHUB_TOKEN$/i,
+    /^GH_TOKEN$/i,
+    /^NPM_TOKEN$/i,
+    /^DOCKER_.*TOKEN$/i,
+    /^SSH_.*KEY$/i,
+    /^OH_CREDENTIAL/i,
+];
+/**
+ * Filter process.env to remove credential-containing variables.
+ * Merges optional extra env vars on top.
+ */
+export function safeEnv(extra) {
+    const env = {};
+    for (const [key, value] of Object.entries(process.env)) {
+        if (value === undefined)
+            continue;
+        if (BLOCKED_PATTERNS.some(p => p.test(key)))
+            continue;
+        env[key] = value;
+    }
+    if (extra) {
+        Object.assign(env, extra);
+    }
+    return env;
+}
+//# sourceMappingURL=safe-env.js.map

package/dist/utils/safe-env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-env.js","sourceRoot":"","sources":["../../src/utils/safe-env.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,gEAAgE;AAChE,MAAM,gBAAgB,GAAG;IACvB,sBAAsB;IACtB,mBAAmB;IACnB,uBAAuB;IACvB,cAAc;IACd,sBAAsB;IACtB,uBAAuB;IACvB,mCAAmC;IACnC,gBAAgB;IAChB,iBAAiB;IACjB,aAAa;IACb,cAAc;IACd,mBAAmB;IACnB,cAAc;IACd,iBAAiB;CAClB,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,KAA8B;IACpD,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvD,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS;QAClC,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAAE,SAAS;QACtD,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACnB,CAAC;IACD,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhijiewang/openharness",
-  "version": "0.10.1",
+  "version": "0.11.0",
   "description": "Open-source terminal coding agent. Works with any LLM.",
   "type": "module",
   "bin": {
@@ -19,6 +19,7 @@
     "prepare": "tsc",
     "prepublishOnly": "npm run build",
     "test": "node scripts/test.mjs",
+    "test:coverage": "node scripts/coverage.mjs",
     "typecheck": "tsc --noEmit",
     "start": "node dist/main.js"
   },
@@ -37,6 +38,7 @@
   "devDependencies": {
     "@types/node": "^22.0.0",
     "@types/react": "^18.3.0",
+    "c8": "^11.0.0",
     "tsx": "^4.19.0",
     "typescript": "^5.8.0"
   },