@botbotgo/kit-builtin 0.0.92

package/dist/src/git/gitCommit.js

@@ -0,0 +1,56 @@
+import { createTaggedError } from "@botbotgo/kit/sdk";
+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";
+/**
+ * Create a git commit.
+ * @tool
+ * @effect local_write
+ */
+export async function gitCommit(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 message = args.message?.trim();
+    if (!message) {
+        throw createTaggedError("GIT_INVALID", "message is required", {});
+    }
+    const cmdArgs = ["commit", "-m", message];
+    if (args.all)
+        cmdArgs.push("--all");
+    if (args.noVerify)
+        cmdArgs.push("--no-verify");
+    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("commit", out);
+    return {
+        result: {
+            path: repoPath,
+            message,
+            all: args.all ?? false,
+            noVerify: args.noVerify ?? false,
+            stdout: out.stdout,
+            stderr: out.stderr,
+            exitCode: out.exitCode,
+        },
+        evidence: [
+            {
+                type: "git",
+                summary: `gitCommit: committed in ${repoPath}`,
+                createdAt: new Date().toISOString(),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=gitCommit.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gitCommit.js","sourceRoot":"","sources":["../../../src/git/gitCommit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,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,SAAS,CAAC,IAO/B;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,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC;IACrC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,iBAAiB,CAAC,aAAa,EAAE,qBAAqB,EAAE,EAAE,CAAC,CAAC;IACpE,CAAC;IAED,MAAM,OAAO,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAC1C,IAAI,IAAI,CAAC,GAAG;QAAE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACpC,IAAI,IAAI,CAAC,QAAQ;QAAE,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAE/C,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,QAAQ,EAAE,GAAG,CAAC,CAAC;IAE7B,OAAO;QACL,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,OAAO;YACP,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,KAAK;YACtB,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,KAAK;YAChC,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,2BAA2B,QAAQ,EAAE;gBAC9C,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC;SACF;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,28 @@
+/**
+ * Get git diff output for working tree or staged changes.
+ * @tool
+ * @effect none
+ */
+export declare function gitDiff(args: {
+    path: string;
+    repoPath?: string;
+    staged?: boolean;
+    filePath?: string;
+    contextLines?: number;
+    timeoutMs?: number;
+}): Promise<{
+    result: {
+        path: string;
+        staged: boolean;
+        filePath: string | null;
+        diff: string;
+        stderr: string;
+        exitCode: number;
+    };
+    evidence: {
+        type: string;
+        summary: string;
+        createdAt: string;
+    }[];
+}>;
+//# sourceMappingURL=gitDiff.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gitDiff.d.ts","sourceRoot":"","sources":["../../../src/git/gitDiff.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;;;;;;;;;;;;;;GA6CA"}

package/dist/src/git/gitDiff.js

@@ -0,0 +1,54 @@
+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";
+/**
+ * Get git diff output for working tree or staged changes.
+ * @tool
+ * @effect none
+ */
+export async function gitDiff(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 = ["--no-pager", "diff"];
+    if (args.staged)
+        cmdArgs.push("--cached");
+    if (typeof args.contextLines === "number" && Number.isFinite(args.contextLines)) {
+        cmdArgs.push(`-U${Math.max(0, Math.trunc(args.contextLines))}`);
+    }
+    if (args.filePath?.trim()) {
+        cmdArgs.push("--", args.filePath.trim());
+    }
+    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("diff", out);
+    return {
+        result: {
+            path: repoPath,
+            staged: args.staged ?? false,
+            filePath: args.filePath ?? null,
+            diff: out.stdout,
+            stderr: out.stderr,
+            exitCode: out.exitCode,
+        },
+        evidence: [
+            {
+                type: "git",
+                summary: `gitDiff: ${args.staged ? "staged" : "working tree"} diff in ${repoPath}`,
+                createdAt: new Date().toISOString(),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=gitDiff.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gitDiff.js","sourceRoot":"","sources":["../../../src/git/gitDiff.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,OAAO,CAAC,IAO7B;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,YAAY,EAAE,MAAM,CAAC,CAAC;IACvC,IAAI,IAAI,CAAC,MAAM;QAAE,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC1C,IAAI,OAAO,IAAI,CAAC,YAAY,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;QAChF,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC;IAClE,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC;QAC1B,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3C,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,MAAM,EAAE,GAAG,CAAC,CAAC;IAE3B,OAAO;QACL,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,KAAK;YAC5B,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI;YAC/B,IAAI,EAAE,GAAG,CAAC,MAAM;YAChB,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,QAAQ,EAAE,GAAG,CAAC,QAAQ;SACvB;QACD,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,KAAK;gBACX,OAAO,EAAE,YAAY,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,cAAc,YAAY,QAAQ,EAAE;gBAClF,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC;SACF;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,37 @@
+/**
+ * Track detailed git commit history, optionally scoped to a file and including patches.
+ * @tool
+ * @effect none
+ */
+export declare function gitLogHistory(args: {
+    path: string;
+    repoPath?: string;
+    filePath?: string;
+    maxCount?: number;
+    since?: string;
+    until?: string;
+    author?: string;
+    grep?: string;
+    revisionRange?: string;
+    follow?: boolean;
+    includePatch?: boolean;
+    patchMaxCommits?: number;
+    timeoutMs?: number;
+}): Promise<{
+    result: {
+        path: string;
+        filePath: string | undefined;
+        total: number;
+        commits: import("./common.js").GitHistoryCommit[];
+        patches: {
+            hash: string;
+            patch: string;
+        }[];
+    };
+    evidence: {
+        type: string;
+        summary: string;
+        createdAt: string;
+    }[];
+}>;
+//# sourceMappingURL=gitLogHistory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gitLogHistory.d.ts","sourceRoot":"","sources":["../../../src/git/gitLogHistory.ts"],"names":[],"mappings":"AAUA;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;;;;;;;kBAwC4B,MAAM;mBAAS,MAAM;;;;;;;;GAkCjD"}

package/dist/src/git/gitLogHistory.js

@@ -0,0 +1,85 @@
+import { DEFAULT_GIT_HISTORY_MAX_COUNT, DEFAULT_GIT_HISTORY_PATCH_MAX_COMMITS, DEFAULT_GIT_MAX_OUTPUT_BYTES, DEFAULT_GIT_TIMEOUT_MS, } from "./defaults.js";
+import { failOnNonZero, parseGitHistory, resolveCwd, resolveRepoPath, runProcess } from "./common.js";
+import { getExtensionContext } from "../../index.js";
+import { overrideWithConfig } from "../util/overrideWithConfig.js";
+/**
+ * Track detailed git commit history, optionally scoped to a file and including patches.
+ * @tool
+ * @effect none
+ */
+export async function gitLogHistory(args) {
+    const defaults = {
+        sandboxRoot: "",
+        gitTimeoutMs: DEFAULT_GIT_TIMEOUT_MS,
+        gitMaxOutputBytes: DEFAULT_GIT_MAX_OUTPUT_BYTES,
+        gitHistoryMaxCount: DEFAULT_GIT_HISTORY_MAX_COUNT,
+        gitHistoryPatchMaxCommits: DEFAULT_GIT_HISTORY_PATCH_MAX_COMMITS,
+    };
+    const ctx = getExtensionContext();
+    const cfg = overrideWithConfig(defaults, ctx.config);
+    const repoPath = await resolveRepoPath((args.path ?? args.repoPath ?? "").trim(), cfg.sandboxRoot ?? "");
+    const maxCount = args.maxCount ?? cfg.gitHistoryMaxCount ?? DEFAULT_GIT_HISTORY_MAX_COUNT;
+    const cmdArgs = [
+        "--no-pager",
+        "log",
+        `--max-count=${maxCount}`,
+        "--date=iso-strict",
+        "--pretty=format:%H%x1f%an%x1f%ae%x1f%ad%x1f%s%x1f%b%x1e",
+    ];
+    if (args.since?.trim())
+        cmdArgs.push(`--since=${args.since.trim()}`);
+    if (args.until?.trim())
+        cmdArgs.push(`--until=${args.until.trim()}`);
+    if (args.author?.trim())
+        cmdArgs.push(`--author=${args.author.trim()}`);
+    if (args.grep?.trim())
+        cmdArgs.push(`--grep=${args.grep.trim()}`);
+    if (args.follow ?? Boolean(args.filePath))
+        cmdArgs.push("--follow");
+    if (args.revisionRange?.trim())
+        cmdArgs.push(args.revisionRange.trim());
+    if (args.filePath?.trim())
+        cmdArgs.push("--", args.filePath.trim());
+    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("log", out);
+    const commits = parseGitHistory(out.stdout);
+    let patches = [];
+    if (args.includePatch) {
+        const patchMaxCommits = args.patchMaxCommits ?? cfg.gitHistoryPatchMaxCommits ?? DEFAULT_GIT_HISTORY_PATCH_MAX_COMMITS;
+        const limited = commits.slice(0, Math.max(0, patchMaxCommits));
+        for (const commit of limited) {
+            const show = await runProcess({
+                bin: "git",
+                cmdArgs: ["--no-pager", "show", "--format=", "--patch", "--stat", commit.hash],
+                cwd: resolveCwd(repoPath),
+                timeoutMs: args.timeoutMs ?? cfg.gitTimeoutMs ?? DEFAULT_GIT_TIMEOUT_MS,
+                maxOutputBytes: cfg.gitMaxOutputBytes ?? DEFAULT_GIT_MAX_OUTPUT_BYTES,
+            });
+            failOnNonZero(`show ${commit.hash}`, show);
+            patches.push({ hash: commit.hash, patch: show.stdout });
+        }
+    }
+    return {
+        result: {
+            path: repoPath,
+            filePath: args.filePath,
+            total: commits.length,
+            commits,
+            patches,
+        },
+        evidence: [
+            {
+                type: "git",
+                summary: `gitLogHistory: ${commits.length} commit(s) in ${repoPath}`,
+                createdAt: new Date().toISOString(),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=gitLogHistory.js.map

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

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

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

@@ -0,0 +1,26 @@
+/**
+ * View a GitHub pull request using GitHub CLI (gh pr view).
+ * @tool
+ * @effect none
+ */
+export declare function gitPrView(args: {
+    path: string;
+    repoPath?: string;
+    prNumber: number;
+    comments?: boolean;
+    jsonFields?: string[];
+    timeoutMs?: number;
+}): Promise<{
+    result: {
+        path: string;
+        prNumber: number;
+        fields: string[];
+        pr: unknown;
+    };
+    evidence: {
+        type: string;
+        summary: string;
+        createdAt: string;
+    }[];
+}>;
+//# sourceMappingURL=gitPrView.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gitPrView.d.ts","sourceRoot":"","sources":["../../../src/git/gitPrView.ts"],"names":[],"mappings":"AAUA;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;;;;;;;;;;;;GA4DA"}

package/dist/src/git/gitPrView.js

@@ -0,0 +1,66 @@
+import { createTaggedError } from "@botbotgo/kit/sdk";
+import { getExtensionContext } from "../../index.js";
+import { overrideWithConfig } from "../util/overrideWithConfig.js";
+import { DEFAULT_GH_PR_FIELDS, DEFAULT_GIT_MAX_OUTPUT_BYTES, DEFAULT_GIT_TIMEOUT_MS, } from "./defaults.js";
+import { ensureGhAvailable, failOnNonZero, resolveCwd, resolveRepoPath, runProcess } from "./common.js";
+/**
+ * View a GitHub pull request using GitHub CLI (gh pr view).
+ * @tool
+ * @effect none
+ */
+export async function gitPrView(args) {
+    const defaults = {
+        sandboxRoot: "",
+        gitTimeoutMs: DEFAULT_GIT_TIMEOUT_MS,
+        gitMaxOutputBytes: DEFAULT_GIT_MAX_OUTPUT_BYTES,
+        ghPrFields: DEFAULT_GH_PR_FIELDS,
+    };
+    const ctx = getExtensionContext();
+    const cfg = overrideWithConfig(defaults, ctx.config);
+    const repoPath = await resolveRepoPath((args.path ?? args.repoPath ?? "").trim(), cfg.sandboxRoot ?? "");
+    if (!Number.isInteger(args.prNumber) || args.prNumber <= 0) {
+        throw createTaggedError("GIT_INVALID", "prNumber must be a positive integer", {});
+    }
+    const fields = (args.jsonFields?.length ? args.jsonFields : cfg.ghPrFields ?? DEFAULT_GH_PR_FIELDS)
+        .map((f) => f.trim())
+        .filter(Boolean);
+    const uniqueFields = Array.from(new Set(fields));
+    if (args.comments && !uniqueFields.includes("comments")) {
+        uniqueFields.push("comments");
+    }
+    await ensureGhAvailable({
+        cwd: repoPath,
+        timeoutMs: args.timeoutMs ?? cfg.gitTimeoutMs ?? DEFAULT_GIT_TIMEOUT_MS,
+    });
+    const out = await runProcess({
+        bin: "gh",
+        cmdArgs: ["pr", "view", String(args.prNumber), "--json", uniqueFields.join(",")],
+        cwd: resolveCwd(repoPath),
+        timeoutMs: args.timeoutMs ?? cfg.gitTimeoutMs ?? DEFAULT_GIT_TIMEOUT_MS,
+        maxOutputBytes: cfg.gitMaxOutputBytes ?? DEFAULT_GIT_MAX_OUTPUT_BYTES,
+    });
+    failOnNonZero("gh pr view", out);
+    let pr;
+    try {
+        pr = JSON.parse(out.stdout || "{}");
+    }
+    catch {
+        throw createTaggedError("UPSTREAM_ERROR", "gh pr view returned non-JSON output", {});
+    }
+    return {
+        result: {
+            path: repoPath,
+            prNumber: args.prNumber,
+            fields: uniqueFields,
+            pr,
+        },
+        evidence: [
+            {
+                type: "git",
+                summary: `gitPrView: viewed PR #${args.prNumber} in ${repoPath}`,
+                createdAt: new Date().toISOString(),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=gitPrView.js.map

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

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

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

@@ -0,0 +1,31 @@
+/**
+ * Pull updates from remote in a repository.
+ * @tool
+ * @effect local_write
+ */
+export declare function gitPull(args: {
+    path: string;
+    repoPath?: string;
+    remote?: string;
+    branch?: string;
+    rebase?: boolean;
+    ffOnly?: boolean;
+    timeoutMs?: number;
+}): Promise<{
+    result: {
+        path: string;
+        remote: string | undefined;
+        branch: string | undefined;
+        ffOnly: boolean;
+        rebase: boolean;
+        stdout: string;
+        stderr: string;
+        exitCode: number;
+    };
+    evidence: {
+        type: string;
+        summary: string;
+        createdAt: string;
+    }[];
+}>;
+//# sourceMappingURL=gitPull.d.ts.map

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

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

package/dist/src/git/gitPull.js

@@ -0,0 +1,56 @@
+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";
+/**
+ * Pull updates from remote in a repository.
+ * @tool
+ * @effect local_write
+ */
+export async function gitPull(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 = ["pull"];
+    if (args.ffOnly)
+        cmdArgs.push("--ff-only");
+    else if (args.rebase)
+        cmdArgs.push("--rebase");
+    if (args.remote?.trim())
+        cmdArgs.push(args.remote.trim());
+    if (args.branch?.trim())
+        cmdArgs.push(args.branch.trim());
+    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("pull", out);
+    return {
+        result: {
+            path: repoPath,
+            remote: args.remote,
+            branch: args.branch,
+            ffOnly: args.ffOnly ?? false,
+            rebase: args.rebase ?? false,
+            stdout: out.stdout,
+            stderr: out.stderr,
+            exitCode: out.exitCode,
+        },
+        evidence: [
+            {
+                type: "git",
+                summary: `gitPull: pulled in ${repoPath}`,
+                createdAt: new Date().toISOString(),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=gitPull.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gitPull.js","sourceRoot":"","sources":["../../../src/git/gitPull.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,OAAO,CAAC,IAQ7B;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,MAAM,CAAC,CAAC;IACzB,IAAI,IAAI,CAAC,MAAM;QAAE,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;SACtC,IAAI,IAAI,CAAC,MAAM;QAAE,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC/C,IAAI,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE;QAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1D,IAAI,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE;QAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAE1D,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;IAEH,aAAa,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE3B,OAAO;QACL,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,KAAK;YAC5B,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,sBAAsB,QAAQ,EAAE;gBACzC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC;SACF;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,28 @@
+/**
+ * Read repository information via allowlisted git read-only subcommands.
+ * @tool
+ * @effect none
+ */
+export declare function gitRead(args: {
+    path: string;
+    repoPath?: string;
+    command: string;
+    subcommand?: string;
+    args?: string[];
+    arguments?: string[];
+    timeoutMs?: number;
+}): Promise<{
+    result: {
+        path: string;
+        command: string;
+        stdout: string;
+        stderr: string;
+        exitCode: number;
+    };
+    evidence: {
+        type: string;
+        summary: string;
+        createdAt: string;
+    }[];
+}>;
+//# sourceMappingURL=gitRead.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gitRead.d.ts","sourceRoot":"","sources":["../../../src/git/gitRead.ts"],"names":[],"mappings":"AAUA;;;;GAIG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE;IAClC,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,EAAE,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;;;;;;;;;;;;;GAyDA"}

package/dist/src/git/gitRead.js

@@ -0,0 +1,59 @@
+import { createTaggedError } from "@botbotgo/kit/sdk";
+import { getExtensionContext } from "../../index.js";
+import { overrideWithConfig } from "../util/overrideWithConfig.js";
+import { DEFAULT_GIT_MAX_OUTPUT_BYTES, DEFAULT_GIT_READ_COMMANDS, DEFAULT_GIT_TIMEOUT_MS, } from "./defaults.js";
+import { failOnNonZero, resolveCwd, resolveRepoPath, runProcess } from "./common.js";
+/**
+ * Read repository information via allowlisted git read-only subcommands.
+ * @tool
+ * @effect none
+ */
+export async function gitRead(args) {
+    const defaults = {
+        sandboxRoot: "",
+        gitReadCommands: DEFAULT_GIT_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 subcommand = (args.command ?? args.subcommand ?? "").trim();
+    if (!subcommand) {
+        throw createTaggedError("GIT_INVALID", "command is required (pass 'command' or 'subcommand')", {});
+    }
+    const allowed = Array.from((cfg.gitReadCommands ?? DEFAULT_GIT_READ_COMMANDS));
+    if (!allowed.includes(subcommand)) {
+        throw createTaggedError("GIT_NOT_ALLOWED", `gitRead only allows read-only subcommands. \"${subcommand}\" is not allowed`, { command: subcommand, allowed });
+    }
+    const cmdArgs = Array.isArray(args.args)
+        ? args.args
+        : Array.isArray(args.arguments)
+            ? args.arguments
+            : [];
+    const out = await runProcess({
+        bin: "git",
+        cmdArgs: ["--no-pager", subcommand, ...cmdArgs],
+        cwd: resolveCwd(repoPath),
+        timeoutMs: args.timeoutMs ?? cfg.gitTimeoutMs ?? DEFAULT_GIT_TIMEOUT_MS,
+        maxOutputBytes: cfg.gitMaxOutputBytes ?? DEFAULT_GIT_MAX_OUTPUT_BYTES,
+    });
+    failOnNonZero(subcommand, out);
+    return {
+        result: {
+            path: repoPath,
+            command: subcommand,
+            stdout: out.stdout,
+            stderr: out.stderr,
+            exitCode: out.exitCode,
+        },
+        evidence: [
+            {
+                type: "git",
+                summary: `gitRead: git ${subcommand} in ${repoPath}`,
+                createdAt: new Date().toISOString(),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=gitRead.js.map

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

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

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

@@ -0,0 +1,28 @@
+/**
+ * Get git working tree status.
+ * @tool
+ * @effect none
+ */
+export declare function gitStatus(args: {
+    path: string;
+    repoPath?: string;
+    porcelain?: boolean;
+    branch?: boolean;
+    timeoutMs?: number;
+}): Promise<{
+    result: {
+        path: string;
+        porcelain: boolean;
+        branch: boolean;
+        lines: string[];
+        stdout: string;
+        stderr: string;
+        exitCode: number;
+    };
+    evidence: {
+        type: string;
+        summary: string;
+        createdAt: string;
+    }[];
+}>;
+//# sourceMappingURL=gitStatus.d.ts.map

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

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