@botbotgo/kit-builtin 0.0.92

package/dist/src/fs/sha256.js

@@ -0,0 +1,51 @@
+import { createReadStream } from "node:fs";
+import { stat } from "node:fs/promises";
+import { createChecksumAccumulator } from "@botbotgo/common/utils";
+import { getExtensionContext } from "../../index.js";
+import { createTaggedError } from "@botbotgo/kit/sdk";
+import { resolveSandboxedPath } from "../platform/securityCompat.js";
+import { DEFAULT_SANDBOX_ROOT } from "./defaults.js";
+import { overrideWithConfig } from "../util/overrideWithConfig.js";
+/**
+ * Compute SHA-256 hash of a file in the sandbox.
+ * @tool
+ * @effect none
+ */
+export async function sha256(args) {
+    // Step 1: Defaults, then override with extension config; validate path input.
+    const defaults = { sandboxRoot: DEFAULT_SANDBOX_ROOT, enableSandboxValidation: false };
+    const ctx = getExtensionContext();
+    const cfg = overrideWithConfig(defaults, ctx.config);
+    const sandboxRoot = cfg.sandboxRoot ?? "";
+    const inputPath = args.path?.trim();
+    if (!inputPath) {
+        throw createTaggedError("FS_INVALID", "path is required", {});
+    }
+    // Step 2: Resolve path and stream file to compute SHA-256.
+    const resolvedPath = await resolveSandboxedPath(inputPath, sandboxRoot);
+    const fileStat = await stat(resolvedPath);
+    const hash = await new Promise((resolve, reject) => {
+        const hasher = createChecksumAccumulator();
+        const stream = createReadStream(resolvedPath);
+        stream.on("data", (chunk) => hasher.update(chunk));
+        stream.on("end", () => resolve(hasher.digest()));
+        stream.on("error", reject);
+    });
+    // Step 3: Return hash and evidence.
+    return {
+        result: {
+            sha256: hash,
+            path: resolvedPath,
+            bytes: fileStat.size,
+        },
+        evidence: [
+            {
+                type: "file",
+                ref: resolvedPath,
+                summary: `SHA-256 of ${resolvedPath} (${fileStat.size} bytes): ${hash.slice(0, 16)}...`,
+                createdAt: new Date().toISOString(),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=sha256.js.map

package/dist/src/fs/sha256.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sha256.js","sourceRoot":"","sources":["../../../src/fs/sha256.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAEnE;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAE5B;IACC,8EAA8E;IAC9E,MAAM,QAAQ,GAAG,EAAE,WAAW,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,KAAK,EAAE,CAAC;IACvF,MAAM,GAAG,GAAG,mBAAmB,EAAE,CAAC;IAClC,MAAM,GAAG,GAAG,kBAAkB,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACrD,MAAM,WAAW,GAAG,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC;IAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;IACpC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,iBAAiB,CAAC,YAAY,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,2DAA2D;IAC3D,MAAM,YAAY,GAAG,MAAM,oBAAoB,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IACxE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,CAAC;IAE1C,MAAM,IAAI,GAAG,MAAM,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACzD,MAAM,MAAM,GAAG,yBAAyB,EAAE,CAAC;QAC3C,MAAM,MAAM,GAAG,gBAAgB,CAAC,YAAY,CAAC,CAAC;QAC9C,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACnD,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACjD,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,oCAAoC;IACpC,OAAO;QACL,MAAM,EAAE;YACN,MAAM,EAAE,IAAI;YACZ,IAAI,EAAE,YAAY;YAClB,KAAK,EAAE,QAAQ,CAAC,IAAI;SACrB;QACD,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,GAAG,EAAE,YAAY;gBACjB,OAAO,EAAE,cAAc,YAAY,KAAK,QAAQ,CAAC,IAAI,YAAY,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK;gBACvF,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/src/fs/writeText.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Create or overwrite a UTF-8 text file in the sandbox, with auto mkdir and overwrite protection.
+ * @tool
+ * @effect local_write
+ */
+export declare function writeText(args: {
+    /** Path to write (within sandbox). */
+    path?: string;
+    /** File body. */
+    content?: string;
+    /** If true, overwrite existing file. Default false (fails if file exists). */
+    overwrite?: boolean;
+    /** If true, create parent directories. Default true. */
+    mkdirp?: boolean;
+}): Promise<{
+    result: {
+        path: string;
+        bytes: number;
+        sha256: string;
+    };
+    evidence: {
+        type: string;
+        ref: string;
+        summary: string;
+        createdAt: string;
+    }[];
+}>;
+//# sourceMappingURL=writeText.d.ts.map

package/dist/src/fs/writeText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writeText.d.ts","sourceRoot":"","sources":["../../../src/fs/writeText.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE;IACpC,sCAAsC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iBAAiB;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,wDAAwD;IACxD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;;;;;;;;;;;;GA4DA"}

package/dist/src/fs/writeText.js

@@ -0,0 +1,68 @@
+import { writeFile, mkdir } from "node:fs/promises";
+import { dirname } from "node:path";
+import { computeChecksum } from "@botbotgo/common/utils";
+import { getExtensionContext } from "../../index.js";
+import { resolveSandboxedPath } from "../platform/securityCompat.js";
+import { DEFAULT_SANDBOX_ROOT } from "./defaults.js";
+import { overrideWithConfig } from "../util/overrideWithConfig.js";
+/**
+ * Create or overwrite a UTF-8 text file in the sandbox, with auto mkdir and overwrite protection.
+ * @tool
+ * @effect local_write
+ */
+export async function writeText(args) {
+    // Step 1: Defaults, then override with extension config; validate path/content input.
+    const defaults = { sandboxRoot: DEFAULT_SANDBOX_ROOT, enableSandboxValidation: false };
+    const ctx = getExtensionContext();
+    const cfg = overrideWithConfig(defaults, ctx.config);
+    const sandboxRoot = cfg.sandboxRoot ?? "";
+    const inputPath = args.path?.trim();
+    if (!inputPath) {
+        throw new Error("path is required");
+    }
+    const text = (args.content ?? "").toString();
+    const overwrite = args.overwrite ?? false;
+    const mkdirp = args.mkdirp ?? true;
+    // Step 2: Resolve path, check overwrite, create parent dirs if needed.
+    const resolvedPath = await resolveSandboxedPath(inputPath, sandboxRoot);
+    if (!overwrite) {
+        const { access } = await import("node:fs/promises");
+        try {
+            await access(resolvedPath);
+            throw new Error(`File already exists: ${resolvedPath}. Set overwrite=true to allow overwriting.`);
+        }
+        catch (err) {
+            // File not found is expected — proceed
+            if (err instanceof Error && !err.message.includes("already exists")) {
+                // access threw ENOENT — file doesn't exist, continue
+            }
+            else {
+                throw err;
+            }
+        }
+    }
+    // Create parent directories if needed
+    if (mkdirp) {
+        await mkdir(dirname(resolvedPath), { recursive: true });
+    }
+    // Step 3: Write file and return result with evidence.
+    await writeFile(resolvedPath, text, "utf-8");
+    const bytes = Buffer.byteLength(text, "utf-8");
+    const sha256 = computeChecksum(text);
+    return {
+        result: {
+            path: resolvedPath,
+            bytes,
+            sha256,
+        },
+        evidence: [
+            {
+                type: "file",
+                ref: resolvedPath,
+                summary: `Wrote ${bytes} bytes to ${resolvedPath} (sha256: ${sha256.slice(0, 12)}...)`,
+                createdAt: new Date().toISOString(),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=writeText.js.map

package/dist/src/fs/writeText.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writeText.js","sourceRoot":"","sources":["../../../src/fs/writeText.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAEnE;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAS/B;IACC,sFAAsF;IACtF,MAAM,QAAQ,GAAG,EAAE,WAAW,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,KAAK,EAAE,CAAC;IACvF,MAAM,GAAG,GAAG,mBAAmB,EAAE,CAAC;IAClC,MAAM,GAAG,GAAG,kBAAkB,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACrD,MAAM,WAAW,GAAG,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC;IAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;IACpC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;IACtC,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC7C,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC;IAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC;IAEnC,uEAAuE;IACvE,MAAM,YAAY,GAAG,MAAM,oBAAoB,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IAExE,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;QACpD,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;YAC3B,MAAM,IAAI,KAAK,CACb,wBAAwB,YAAY,4CAA4C,CACjF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,uCAAuC;YACvC,IAAI,GAAG,YAAY,KAAK,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;gBACpE,qDAAqD;YACvD,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;IACH,CAAC;IAED,sCAAsC;IACtC,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,sDAAsD;IACtD,MAAM,SAAS,CAAC,YAAY,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAE7C,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAErC,OAAO;QACL,MAAM,EAAE;YACN,IAAI,EAAE,YAAY;YAClB,KAAK;YACL,MAAM;SACP;QACD,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,GAAG,EAAE,YAAY;gBACjB,OAAO,EAAE,SAAS,KAAK,aAAa,YAAY,aAAa,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM;gBACtF,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/src/git/common.d.ts

@@ -0,0 +1,34 @@
+export interface GitExecResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+export interface GitHistoryCommit {
+    hash: string;
+    authorName: string;
+    authorEmail: string;
+    date: string;
+    subject: string;
+    body: string;
+}
+export declare function runProcess(args: {
+    bin: string;
+    cmdArgs: string[];
+    cwd: string;
+    timeoutMs: number;
+    maxOutputBytes: number;
+}): Promise<GitExecResult>;
+export declare function resolveRepoPath(inputPath: string, sandboxRoot: string): Promise<string>;
+export declare function failOnNonZero(command: string, out: GitExecResult): void;
+export declare function parseGitHistory(stdout: string): GitHistoryCommit[];
+export declare function buildGitConfig(): {
+    sandboxRoot: string;
+    gitTimeoutMs: number;
+    gitMaxOutputBytes: number;
+};
+export declare function ensureGhAvailable(args: {
+    cwd: string;
+    timeoutMs: number;
+}): Promise<void>;
+export declare function resolveCwd(repoPath: string): string;
+//# sourceMappingURL=common.d.ts.map

package/dist/src/git/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../src/git/common.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB,GAAG,OAAO,CAAC,aAAa,CAAC,CA0EzB;AAED,wBAAsB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAK7F;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,GAAG,IAAI,CAQvE;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAiBlE;AAED,wBAAgB,cAAc;;;;EAQ7B;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,IAAI,CAAC,CAehB;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEnD"}

package/dist/src/git/common.js

@@ -0,0 +1,120 @@
+import { spawn } from "node:child_process";
+import { resolve as pathResolve } from "node:path";
+import { createTaggedError } from "@botbotgo/kit/sdk";
+import { resolveSandboxedPath } from "../platform/securityCompat.js";
+import { getExtensionContext } from "../../index.js";
+import { overrideWithConfig } from "../util/overrideWithConfig.js";
+import { DEFAULT_GIT_MAX_OUTPUT_BYTES, DEFAULT_GIT_TIMEOUT_MS, } from "./defaults.js";
+export async function runProcess(args) {
+    return new Promise((resolvePromise, rejectPromise) => {
+        const proc = spawn(args.bin, args.cmdArgs, {
+            cwd: args.cwd,
+            shell: false,
+            stdio: ["ignore", "pipe", "pipe"],
+            env: { ...process.env, GIT_PAGER: "cat" },
+        });
+        let stdout = "";
+        let stderr = "";
+        let totalBytes = 0;
+        let settled = false;
+        const failOnce = (err) => {
+            if (settled)
+                return;
+            settled = true;
+            rejectPromise(err);
+        };
+        const doneOnce = (value) => {
+            if (settled)
+                return;
+            settled = true;
+            resolvePromise(value);
+        };
+        const append = (chunk, dest) => {
+            const len = Buffer.byteLength(chunk, "utf-8");
+            if (totalBytes + len > args.maxOutputBytes) {
+                proc.kill("SIGKILL");
+                failOnce(createTaggedError("GIT_OUTPUT_TOO_LARGE", `Git command output exceeded ${args.maxOutputBytes} bytes`, { maxBytes: args.maxOutputBytes }));
+                return;
+            }
+            totalBytes += len;
+            if (dest === "stdout")
+                stdout += chunk;
+            else
+                stderr += chunk;
+        };
+        proc.stdout?.setEncoding("utf-8");
+        proc.stderr?.setEncoding("utf-8");
+        proc.stdout?.on("data", (chunk) => append(chunk, "stdout"));
+        proc.stderr?.on("data", (chunk) => append(chunk, "stderr"));
+        const timer = setTimeout(() => {
+            proc.kill("SIGKILL");
+            failOnce(createTaggedError("GIT_TIMEOUT", `${args.bin} ${args.cmdArgs.join(" ")} timed out after ${args.timeoutMs}ms`, { timeoutMs: args.timeoutMs }));
+        }, args.timeoutMs);
+        proc.on("error", (err) => {
+            clearTimeout(timer);
+            failOnce(createTaggedError("GIT_SPAWN_ERROR", err.message, { command: args.bin }));
+        });
+        proc.on("close", (code) => {
+            clearTimeout(timer);
+            doneOnce({
+                stdout,
+                stderr,
+                exitCode: code ?? 1,
+            });
+        });
+    });
+}
+export async function resolveRepoPath(inputPath, sandboxRoot) {
+    if (!inputPath.trim()) {
+        throw createTaggedError("GIT_INVALID", "path is required", {});
+    }
+    return resolveSandboxedPath(inputPath, sandboxRoot);
+}
+export function failOnNonZero(command, out) {
+    if (out.exitCode !== 0) {
+        throw createTaggedError("GIT_COMMAND_FAILED", `git ${command} failed with exit ${out.exitCode}: ${(out.stderr || out.stdout).slice(0, 500)}`, { exitCode: out.exitCode });
+    }
+}
+export function parseGitHistory(stdout) {
+    return stdout
+        .split("\x1e")
+        .map((s) => s.trim())
+        .filter(Boolean)
+        .map((row) => {
+        const parts = row.split("\x1f");
+        return {
+            hash: parts[0] ?? "",
+            authorName: parts[1] ?? "",
+            authorEmail: parts[2] ?? "",
+            date: parts[3] ?? "",
+            subject: parts[4] ?? "",
+            body: parts[5] ?? "",
+        };
+    })
+        .filter((c) => c.hash !== "");
+}
+export function buildGitConfig() {
+    const defaults = {
+        sandboxRoot: "",
+        gitTimeoutMs: DEFAULT_GIT_TIMEOUT_MS,
+        gitMaxOutputBytes: DEFAULT_GIT_MAX_OUTPUT_BYTES,
+    };
+    const ctx = getExtensionContext();
+    return overrideWithConfig(defaults, ctx.config);
+}
+export async function ensureGhAvailable(args) {
+    const check = await runProcess({
+        bin: "gh",
+        cmdArgs: ["--version"],
+        cwd: pathResolve(args.cwd),
+        timeoutMs: args.timeoutMs,
+        maxOutputBytes: 1024 * 32,
+    }).catch((err) => {
+        throw createTaggedError("GIT_TOOL_MISSING", `GitHub CLI (gh) is required: ${err instanceof Error ? err.message : String(err)}`, {});
+    });
+    failOnNonZero("gh --version", check);
+}
+export function resolveCwd(repoPath) {
+    return pathResolve(repoPath);
+}
+//# sourceMappingURL=common.js.map

package/dist/src/git/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../../src/git/common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EACL,4BAA4B,EAC5B,sBAAsB,GACvB,MAAM,eAAe,CAAC;AAiBvB,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAMhC;IACC,OAAO,IAAI,OAAO,CAAgB,CAAC,cAAc,EAAE,aAAa,EAAE,EAAE;QAClE,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,EAAE;YACzC,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;YACjC,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE;SAC1C,CAAC,CAAC;QAEH,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,IAAI,OAAO,GAAG,KAAK,CAAC;QAEpB,MAAM,QAAQ,GAAG,CAAC,GAAU,EAAE,EAAE;YAC9B,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,aAAa,CAAC,GAAG,CAAC,CAAC;QACrB,CAAC,CAAC;QAEF,MAAM,QAAQ,GAAG,CAAC,KAAoB,EAAE,EAAE;YACxC,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,cAAc,CAAC,KAAK,CAAC,CAAC;QACxB,CAAC,CAAC;QAEF,MAAM,MAAM,GAAG,CAAC,KAAa,EAAE,IAAyB,EAAE,EAAE;YAC1D,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAC9C,IAAI,UAAU,GAAG,GAAG,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;gBAC3C,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBACrB,QAAQ,CACN,iBAAiB,CACf,sBAAsB,EACtB,+BAA+B,IAAI,CAAC,cAAc,QAAQ,EAC1D,EAAE,QAAQ,EAAE,IAAI,CAAC,cAAc,EAAE,CAClC,CACF,CAAC;gBACF,OAAO;YACT,CAAC;YACD,UAAU,IAAI,GAAG,CAAC;YAClB,IAAI,IAAI,KAAK,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC;;gBAClC,MAAM,IAAI,KAAK,CAAC;QACvB,CAAC,CAAC;QAEF,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;QAClC,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;QAClC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;QACpE,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;QAEpE,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACrB,QAAQ,CACN,iBAAiB,CACf,aAAa,EACb,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,oBAAoB,IAAI,CAAC,SAAS,IAAI,EAC3E,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAC9B,CACF,CAAC;QACJ,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAEnB,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACvB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,QAAQ,CAAC,iBAAiB,CAAC,iBAAiB,EAAE,GAAG,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrF,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACxB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,QAAQ,CAAC;gBACP,MAAM;gBACN,MAAM;gBACN,QAAQ,EAAE,IAAI,IAAI,CAAC;aACpB,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,SAAiB,EAAE,WAAmB;IAC1E,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,CAAC;QACtB,MAAM,iBAAiB,CAAC,aAAa,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,oBAAoB,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAe,EAAE,GAAkB;IAC/D,IAAI,GAAG,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,iBAAiB,CACrB,oBAAoB,EACpB,OAAO,OAAO,qBAAqB,GAAG,CAAC,QAAQ,KAAK,CAAC,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAC9F,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,CAC3B,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,OAAO,MAAM;SACV,KAAK,CAAC,MAAM,CAAC;SACb,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,OAAO,CAAC;SACf,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACX,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAChC,OAAO;YACL,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE;YACpB,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE;YAC1B,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE;YAC3B,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE;YACpB,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE;YACvB,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE;SACrB,CAAC;IACJ,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,MAAM,QAAQ,GAAG;QACf,WAAW,EAAE,EAAE;QACf,YAAY,EAAE,sBAAsB;QACpC,iBAAiB,EAAE,4BAA4B;KAChD,CAAC;IACF,MAAM,GAAG,GAAG,mBAAmB,EAAE,CAAC;IAClC,OAAO,kBAAkB,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAGvC;IACC,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC;QAC7B,GAAG,EAAE,IAAI;QACT,OAAO,EAAE,CAAC,WAAW,CAAC;QACtB,GAAG,EAAE,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC;QAC1B,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,cAAc,EAAE,IAAI,GAAG,EAAE;KAC1B,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QACf,MAAM,iBAAiB,CACrB,kBAAkB,EAClB,gCAAgC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAClF,EAAE,CACH,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,aAAa,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,QAAgB;IACzC,OAAO,WAAW,CAAC,QAAQ,CAAC,CAAC;AAC/B,CAAC"}

package/dist/src/git/defaults.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Git tool defaults. All overridable via extension config.
+ */
+export declare const DEFAULT_GIT_READ_COMMANDS: readonly ["status", "log", "show", "diff", "branch", "rev-parse", "remote", "tag", "reflog", "blame", "ls-files", "grep", "shortlog", "describe", "ls-remote", "cat-file"];
+export declare const DEFAULT_GH_READ_COMMANDS: readonly ["repo view", "pr list", "pr view", "issue list", "issue view", "search prs", "search issues", "release list", "release view", "workflow list", "workflow view", "run list", "run view"];
+export declare const DEFAULT_GIT_TIMEOUT_MS = 30000;
+export declare const DEFAULT_GIT_MAX_OUTPUT_BYTES: number;
+export declare const DEFAULT_GIT_HISTORY_MAX_COUNT = 100;
+export declare const DEFAULT_GIT_HISTORY_PATCH_MAX_COMMITS = 5;
+export declare const DEFAULT_GH_PR_FIELDS: readonly ["number", "title", "state", "author", "baseRefName", "headRefName", "isDraft", "url", "mergeable", "reviewDecision", "body"];
+//# sourceMappingURL=defaults.d.ts.map

package/dist/src/git/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../../src/git/defaults.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,yBAAyB,4KAiB5B,CAAC;AAEX,eAAO,MAAM,wBAAwB,mMAc3B,CAAC;AAEX,eAAO,MAAM,sBAAsB,QAAS,CAAC;AAC7C,eAAO,MAAM,4BAA4B,QAAkB,CAAC;AAC5D,eAAO,MAAM,6BAA6B,MAAM,CAAC;AACjD,eAAO,MAAM,qCAAqC,IAAI,CAAC;AAEvD,eAAO,MAAM,oBAAoB,wIAYvB,CAAC"}

package/dist/src/git/defaults.js

@@ -0,0 +1,54 @@
+/**
+ * Git tool defaults. All overridable via extension config.
+ */
+export const DEFAULT_GIT_READ_COMMANDS = [
+    "status",
+    "log",
+    "show",
+    "diff",
+    "branch",
+    "rev-parse",
+    "remote",
+    "tag",
+    "reflog",
+    "blame",
+    "ls-files",
+    "grep",
+    "shortlog",
+    "describe",
+    "ls-remote",
+    "cat-file",
+];
+export const DEFAULT_GH_READ_COMMANDS = [
+    "repo view",
+    "pr list",
+    "pr view",
+    "issue list",
+    "issue view",
+    "search prs",
+    "search issues",
+    "release list",
+    "release view",
+    "workflow list",
+    "workflow view",
+    "run list",
+    "run view",
+];
+export const DEFAULT_GIT_TIMEOUT_MS = 30_000;
+export const DEFAULT_GIT_MAX_OUTPUT_BYTES = 2 * 1024 * 1024;
+export const DEFAULT_GIT_HISTORY_MAX_COUNT = 100;
+export const DEFAULT_GIT_HISTORY_PATCH_MAX_COMMITS = 5;
+export const DEFAULT_GH_PR_FIELDS = [
+    "number",
+    "title",
+    "state",
+    "author",
+    "baseRefName",
+    "headRefName",
+    "isDraft",
+    "url",
+    "mergeable",
+    "reviewDecision",
+    "body",
+];
+//# sourceMappingURL=defaults.js.map

package/dist/src/git/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../../src/git/defaults.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,QAAQ;IACR,KAAK;IACL,MAAM;IACN,MAAM;IACN,QAAQ;IACR,WAAW;IACX,QAAQ;IACR,KAAK;IACL,QAAQ;IACR,OAAO;IACP,UAAU;IACV,MAAM;IACN,UAAU;IACV,UAAU;IACV,WAAW;IACX,UAAU;CACF,CAAC;AAEX,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,WAAW;IACX,SAAS;IACT,SAAS;IACT,YAAY;IACZ,YAAY;IACZ,YAAY;IACZ,eAAe;IACf,cAAc;IACd,cAAc;IACd,eAAe;IACf,eAAe;IACf,UAAU;IACV,UAAU;CACF,CAAC;AAEX,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC;AAC7C,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAC5D,MAAM,CAAC,MAAM,6BAA6B,GAAG,GAAG,CAAC;AACjD,MAAM,CAAC,MAAM,qCAAqC,GAAG,CAAC,CAAC;AAEvD,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,QAAQ;IACR,OAAO;IACP,OAAO;IACP,QAAQ;IACR,aAAa;IACb,aAAa;IACb,SAAS;IACT,KAAK;IACL,WAAW;IACX,gBAAgB;IAChB,MAAM;CACE,CAAC"}

package/dist/src/git/ghRead.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Read-only GitHub CLI execution with allowlisted gh command/subcommand pairs.
+ * @tool
+ * @effect none
+ */
+export declare function ghRead(args: {
+    path: string;
+    repoPath?: string;
+    command: string;
+    subcommand?: string;
+    args?: string[];
+    timeoutMs?: number;
+}): Promise<{
+    result: {
+        path: string;
+        command: string;
+        subcommand: string | null;
+        args: string[];
+        stdout: string;
+        stderr: string;
+        exitCode: number;
+    };
+    evidence: {
+        type: string;
+        summary: string;
+        createdAt: string;
+    }[];
+}>;
+//# sourceMappingURL=ghRead.d.ts.map

package/dist/src/git/ghRead.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ghRead.d.ts","sourceRoot":"","sources":["../../../src/git/ghRead.ts"],"names":[],"mappings":"AAUA;;;;GAIG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;;;;;;;;;;;;;;;GA6DA"}

package/dist/src/git/ghRead.js

@@ -0,0 +1,63 @@
+import { createTaggedError } from "@botbotgo/kit/sdk";
+import { getExtensionContext } from "../../index.js";
+import { overrideWithConfig } from "../util/overrideWithConfig.js";
+import { DEFAULT_GH_READ_COMMANDS, DEFAULT_GIT_MAX_OUTPUT_BYTES, DEFAULT_GIT_TIMEOUT_MS, } from "./defaults.js";
+import { ensureGhAvailable, failOnNonZero, resolveCwd, resolveRepoPath, runProcess } from "./common.js";
+/**
+ * Read-only GitHub CLI execution with allowlisted gh command/subcommand pairs.
+ * @tool
+ * @effect none
+ */
+export async function ghRead(args) {
+    const defaults = {
+        sandboxRoot: "",
+        ghReadCommands: DEFAULT_GH_READ_COMMANDS,
+        gitTimeoutMs: DEFAULT_GIT_TIMEOUT_MS,
+        gitMaxOutputBytes: DEFAULT_GIT_MAX_OUTPUT_BYTES,
+    };
+    const ctx = getExtensionContext();
+    const cfg = overrideWithConfig(defaults, ctx.config);
+    const repoPath = await resolveRepoPath((args.path ?? args.repoPath ?? "").trim(), cfg.sandboxRoot ?? "");
+    const command = args.command?.trim();
+    const subcommand = args.subcommand?.trim();
+    if (!command) {
+        throw createTaggedError("GIT_INVALID", "command is required", {});
+    }
+    const commandKey = subcommand ? `${command} ${subcommand}` : command;
+    const allowed = Array.from((cfg.ghReadCommands ?? DEFAULT_GH_READ_COMMANDS));
+    if (!allowed.includes(commandKey)) {
+        throw createTaggedError("GIT_NOT_ALLOWED", `ghRead only allows read-only commands. \"${commandKey}\" is not allowed`, { command: commandKey, allowed });
+    }
+    await ensureGhAvailable({
+        cwd: repoPath,
+        timeoutMs: args.timeoutMs ?? cfg.gitTimeoutMs ?? DEFAULT_GIT_TIMEOUT_MS,
+    });
+    const cmdArgs = [command, ...(subcommand ? [subcommand] : []), ...(args.args ?? [])];
+    const out = await runProcess({
+        bin: "gh",
+        cmdArgs,
+        cwd: resolveCwd(repoPath),
+        timeoutMs: args.timeoutMs ?? cfg.gitTimeoutMs ?? DEFAULT_GIT_TIMEOUT_MS,
+        maxOutputBytes: cfg.gitMaxOutputBytes ?? DEFAULT_GIT_MAX_OUTPUT_BYTES,
+    });
+    failOnNonZero(`gh ${commandKey}`, out);
+    return {
+        result: {
+            path: repoPath,
+            command,
+            subcommand: subcommand ?? null,
+            args: args.args ?? [],
+            stdout: out.stdout,
+            stderr: out.stderr,
+            exitCode: out.exitCode,
+        },
+        evidence: [
+            {
+                type: "git",
+                summary: `ghRead: gh ${commandKey} in ${repoPath}`,
+                createdAt: new Date().toISOString(),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=ghRead.js.map

package/dist/src/git/ghRead.js.map

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

package/dist/src/git/gitAdd.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Stage files in git index.
+ * @tool
+ * @effect local_write
+ */
+export declare function gitAdd(args: {
+    path: string;
+    repoPath?: string;
+    files?: string[];
+    all?: boolean;
+    update?: boolean;
+    timeoutMs?: number;
+}): Promise<{
+    result: {
+        path: string;
+        files: string[];
+        all: boolean;
+        update: boolean;
+        stdout: string;
+        stderr: string;
+        exitCode: number;
+    };
+    evidence: {
+        type: string;
+        summary: string;
+        createdAt: string;
+    }[];
+}>;
+//# sourceMappingURL=gitAdd.d.ts.map

package/dist/src/git/gitAdd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitAdd.d.ts","sourceRoot":"","sources":["../../../src/git/gitAdd.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;;;;;;;;;;;;;;;GA8CA"}

package/dist/src/git/gitAdd.js

@@ -0,0 +1,57 @@
+import { DEFAULT_GIT_MAX_OUTPUT_BYTES, DEFAULT_GIT_TIMEOUT_MS, } from "./defaults.js";
+import { failOnNonZero, resolveCwd, resolveRepoPath, runProcess } from "./common.js";
+import { getExtensionContext } from "../../index.js";
+import { overrideWithConfig } from "../util/overrideWithConfig.js";
+/**
+ * Stage files in git index.
+ * @tool
+ * @effect local_write
+ */
+export async function gitAdd(args) {
+    const defaults = {
+        sandboxRoot: "",
+        gitTimeoutMs: DEFAULT_GIT_TIMEOUT_MS,
+        gitMaxOutputBytes: DEFAULT_GIT_MAX_OUTPUT_BYTES,
+    };
+    const ctx = getExtensionContext();
+    const cfg = overrideWithConfig(defaults, ctx.config);
+    const repoPath = await resolveRepoPath((args.path ?? args.repoPath ?? "").trim(), cfg.sandboxRoot ?? "");
+    const cmdArgs = ["add"];
+    if (args.all)
+        cmdArgs.push("--all");
+    if (args.update)
+        cmdArgs.push("--update");
+    if (Array.isArray(args.files) && args.files.length > 0) {
+        cmdArgs.push("--", ...args.files.map((f) => f.trim()).filter(Boolean));
+    }
+    else if (!args.all && !args.update) {
+        cmdArgs.push("--all");
+    }
+    const out = await runProcess({
+        bin: "git",
+        cmdArgs,
+        cwd: resolveCwd(repoPath),
+        timeoutMs: args.timeoutMs ?? cfg.gitTimeoutMs ?? DEFAULT_GIT_TIMEOUT_MS,
+        maxOutputBytes: cfg.gitMaxOutputBytes ?? DEFAULT_GIT_MAX_OUTPUT_BYTES,
+    });
+    failOnNonZero("add", out);
+    return {
+        result: {
+            path: repoPath,
+            files: args.files ?? [],
+            all: args.all ?? (!args.files?.length && !args.update),
+            update: args.update ?? false,
+            stdout: out.stdout,
+            stderr: out.stderr,
+            exitCode: out.exitCode,
+        },
+        evidence: [
+            {
+                type: "git",
+                summary: `gitAdd: staged changes in ${repoPath}`,
+                createdAt: new Date().toISOString(),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=gitAdd.js.map

package/dist/src/git/gitAdd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitAdd.js","sourceRoot":"","sources":["../../../src/git/gitAdd.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,EAC5B,sBAAsB,GACvB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACrF,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAEnE;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAO5B;IACC,MAAM,QAAQ,GAAG;QACf,WAAW,EAAE,EAAE;QACf,YAAY,EAAE,sBAAsB;QACpC,iBAAiB,EAAE,4BAA4B;KAChD,CAAC;IACF,MAAM,GAAG,GAAG,mBAAmB,EAAE,CAAC;IAClC,MAAM,GAAG,GAAG,kBAAkB,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAErD,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;IACzG,MAAM,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC;IACxB,IAAI,IAAI,CAAC,GAAG;QAAE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACpC,IAAI,IAAI,CAAC,MAAM;QAAE,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC1C,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvD,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IACzE,CAAC;SAAM,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QACrC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACxB,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC;QAC3B,GAAG,EAAE,KAAK;QACV,OAAO;QACP,GAAG,EAAE,UAAU,CAAC,QAAQ,CAAC;QACzB,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,GAAG,CAAC,YAAY,IAAI,sBAAsB;QACvE,cAAc,EAAE,GAAG,CAAC,iBAAiB,IAAI,4BAA4B;KACtE,CAAC,CAAC;IACH,aAAa,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAE1B,OAAO;QACL,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE;YACvB,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;YACtD,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,KAAK;YAC5B,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,QAAQ,EAAE,GAAG,CAAC,QAAQ;SACvB;QACD,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,KAAK;gBACX,OAAO,EAAE,6BAA6B,QAAQ,EAAE;gBAChD,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/src/git/gitCommit.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Create a git commit.
+ * @tool
+ * @effect local_write
+ */
+export declare function gitCommit(args: {
+    path: string;
+    repoPath?: string;
+    message: string;
+    all?: boolean;
+    noVerify?: boolean;
+    timeoutMs?: number;
+}): Promise<{
+    result: {
+        path: string;
+        message: string;
+        all: boolean;
+        noVerify: boolean;
+        stdout: string;
+        stderr: string;
+        exitCode: number;
+    };
+    evidence: {
+        type: string;
+        summary: string;
+        createdAt: string;
+    }[];
+}>;
+//# sourceMappingURL=gitCommit.d.ts.map

package/dist/src/git/gitCommit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitCommit.d.ts","sourceRoot":"","sources":["../../../src/git/gitCommit.ts"],"names":[],"mappings":"AASA;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;;;;;;;;;;;;;;;GA8CA"}