codebase-cli 2.0.0-pre.0

package/dist/tools/file-ops.js

@@ -0,0 +1,136 @@
+import { randomBytes } from "node:crypto";
+import { existsSync, mkdirSync, renameSync, statSync, unlinkSync, writeFileSync } from "node:fs";
+import { dirname, isAbsolute, resolve, sep } from "node:path";
+import { AmbiguousMatchError, FileNotReadFirstError, FileUnexpectedlyModifiedError, NoMatchError, PartialViewEditError, PathOutsideCwdError, } from "./errors.js";
+/**
+ * Resolve a user-supplied path against cwd and reject anything that escapes.
+ * Symlinks are followed at read/stat time, so this is a best-effort guard
+ * against absolute paths and `..` traversal — combine with realpath checks
+ * before sensitive operations if you don't trust the working tree.
+ */
+export function resolveInsideCwd(cwd, requested) {
+    const absCwd = resolve(cwd);
+    const candidate = isAbsolute(requested) ? resolve(requested) : resolve(absCwd, requested);
+    if (candidate !== absCwd && !candidate.startsWith(absCwd + sep)) {
+        throw new PathOutsideCwdError(requested);
+    }
+    return candidate;
+}
+/** Detect newline style. Empty string for files with no newline. */
+export function detectEol(content) {
+    const idx = content.indexOf("\n");
+    if (idx === -1)
+        return "";
+    return idx > 0 && content[idx - 1] === "\r" ? "\r\n" : "\n";
+}
+/** Strip a UTF-8 BOM if present and return the decoded string. */
+export function stripBOM(buf) {
+    if (buf.length >= 3 && buf[0] === 0xef && buf[1] === 0xbb && buf[2] === 0xbf) {
+        return { content: buf.subarray(3).toString("utf8"), hasBOM: true };
+    }
+    return { content: buf.toString("utf8"), hasBOM: false };
+}
+/** Heuristic null-byte scan over the first 8 KB. */
+export function isLikelyBinary(buf) {
+    const slice = buf.subarray(0, Math.min(buf.length, 8192));
+    for (let i = 0; i < slice.length; i++) {
+        if (slice[i] === 0)
+            return true;
+    }
+    return false;
+}
+/**
+ * Validate a file is safe to overwrite. Throws typed errors so the LLM gets
+ * actionable feedback when its context has drifted from disk:
+ *   - missing snapshot → FileNotReadFirstError ("read it first")
+ *   - mtime/size drift → FileUnexpectedlyModifiedError ("read it again")
+ *   - partial-view read → PartialViewEditError ("read the full file")
+ */
+export function validateForOverwrite(absPath, cache) {
+    const status = cache.check(absPath);
+    if (status === "missing")
+        throw new FileNotReadFirstError(absPath);
+    if (status === "modified")
+        throw new FileUnexpectedlyModifiedError(absPath);
+    const snap = cache.get(absPath);
+    if (!snap)
+        throw new FileNotReadFirstError(absPath);
+    if (snap.isPartialView)
+        throw new PartialViewEditError(absPath);
+    return snap;
+}
+/**
+ * Apply a single string replacement. Single-match by default; replace_all
+ * substitutes every occurrence. Throws NoMatchError / AmbiguousMatchError
+ * with file-path context so the model can self-correct.
+ */
+export function applyEdit(content, opts) {
+    const { oldString, newString, replaceAll, path } = opts;
+    if (oldString.length === 0) {
+        throw new Error("old_string must be non-empty. Use write_file to create a new file.");
+    }
+    if (oldString === newString) {
+        throw new Error("old_string and new_string are identical; nothing to change.");
+    }
+    if (replaceAll) {
+        const parts = content.split(oldString);
+        if (parts.length === 1)
+            throw new NoMatchError(path);
+        return { content: parts.join(newString), replacements: parts.length - 1 };
+    }
+    const first = content.indexOf(oldString);
+    if (first === -1)
+        throw new NoMatchError(path);
+    const second = content.indexOf(oldString, first + oldString.length);
+    if (second !== -1) {
+        let count = 2;
+        let cursor = second + oldString.length;
+        while (true) {
+            const next = content.indexOf(oldString, cursor);
+            if (next === -1)
+                break;
+            count++;
+            cursor = next + oldString.length;
+        }
+        throw new AmbiguousMatchError(path, count);
+    }
+    return {
+        content: content.slice(0, first) + newString + content.slice(first + oldString.length),
+        replacements: 1,
+    };
+}
+/**
+ * Write content to disk via tmp+rename. Restores BOM and line endings from
+ * the originating snapshot so a Windows-authored file stays Windows-formatted
+ * after edits. The tmp file is removed on failure.
+ */
+export function atomicWrite(absPath, content, options = {}) {
+    const eol = options.eol ?? detectEol(content);
+    const normalized = eol === "\r\n" ? content.replace(/\r?\n/g, "\r\n") : eol === "\n" ? content.replace(/\r\n/g, "\n") : content;
+    let buf = Buffer.from(normalized, "utf8");
+    if (options.hasBOM) {
+        buf = Buffer.concat([Buffer.from([0xef, 0xbb, 0xbf]), buf]);
+    }
+    mkdirSync(dirname(absPath), { recursive: true });
+    const tmp = `${absPath}.${randomBytes(4).toString("hex")}.tmp`;
+    try {
+        writeFileSync(tmp, buf, { mode: options.mode ?? 0o644 });
+        renameSync(tmp, absPath);
+    }
+    catch (err) {
+        try {
+            unlinkSync(tmp);
+        }
+        catch {
+            // best-effort cleanup
+        }
+        throw err;
+    }
+    const stat = statSync(absPath);
+    return { mtimeMs: stat.mtimeMs, size: stat.size };
+}
+/** True if the path exists on disk (without throwing). */
+export function pathExists(absPath) {
+    return existsSync(absPath);
+}
+//# sourceMappingURL=file-ops.js.map

package/dist/tools/file-ops.js.map

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

package/dist/tools/file-state-cache.js

@@ -0,0 +1,92 @@
+import { statSync } from "node:fs";
+import { resolve } from "node:path";
+/**
+ * LRU cache of read file states. Map iteration order in JS is insertion
+ * order, which we abuse for LRU: every `get`/`record` re-inserts to push
+ * the entry to the tail; eviction takes from the head.
+ */
+export class FileStateCache {
+    snapshots = new Map();
+    bytesStored = 0;
+    maxEntries;
+    byteBudget;
+    constructor(config = {}) {
+        this.maxEntries = config.maxEntries ?? 100;
+        this.byteBudget = config.byteBudget ?? 25_000_000;
+    }
+    record(snapshot) {
+        const key = resolve(snapshot.path);
+        const existing = this.snapshots.get(key);
+        if (existing) {
+            this.bytesStored -= byteSize(existing.content);
+            this.snapshots.delete(key);
+        }
+        const stored = { ...snapshot, path: key };
+        this.snapshots.set(key, stored);
+        this.bytesStored += byteSize(snapshot.content);
+        this.evictIfNeeded();
+    }
+    get(path) {
+        const key = resolve(path);
+        const snapshot = this.snapshots.get(key);
+        if (snapshot) {
+            this.snapshots.delete(key);
+            this.snapshots.set(key, snapshot);
+        }
+        return snapshot;
+    }
+    invalidate(path) {
+        const key = resolve(path);
+        const existing = this.snapshots.get(key);
+        if (existing) {
+            this.bytesStored -= byteSize(existing.content);
+            this.snapshots.delete(key);
+        }
+    }
+    /**
+     * Compare cached state to disk:
+     *   - "fresh": cache hit and mtime matches; edit can proceed
+     *   - "modified": cache hit but mtime drifted (or file gone); caller must re-read
+     *   - "missing": no cached snapshot; caller must read first
+     */
+    check(path) {
+        const snapshot = this.get(path);
+        if (!snapshot)
+            return "missing";
+        try {
+            const stat = statSync(snapshot.path);
+            if (stat.mtimeMs !== snapshot.mtimeMs || stat.size !== snapshot.size) {
+                return "modified";
+            }
+            return "fresh";
+        }
+        catch {
+            return "modified";
+        }
+    }
+    size() {
+        return this.snapshots.size;
+    }
+    bytes() {
+        return this.bytesStored;
+    }
+    clear() {
+        this.snapshots.clear();
+        this.bytesStored = 0;
+    }
+    evictIfNeeded() {
+        while ((this.snapshots.size > this.maxEntries || this.bytesStored > this.byteBudget) && this.snapshots.size > 0) {
+            const oldestKey = this.snapshots.keys().next().value;
+            if (!oldestKey)
+                return;
+            const snap = this.snapshots.get(oldestKey);
+            if (snap)
+                this.bytesStored -= byteSize(snap.content);
+            this.snapshots.delete(oldestKey);
+        }
+    }
+}
+function byteSize(s) {
+    return Buffer.byteLength(s, "utf8");
+}
+//# sourceMappingURL=file-state-cache.js.map

package/dist/tools/file-state-cache.js.map

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

package/dist/tools/git/branch.js

@@ -0,0 +1,84 @@
+import { Type } from "typebox";
+import { requireGitRepo, runGit } from "./git-helpers.js";
+const Params = Type.Object({
+    name: Type.Optional(Type.String({
+        description: "Branch name. Omit to list branches.",
+    })),
+    create: Type.Optional(Type.Boolean({
+        description: "Create the branch (errors if it already exists). Requires name.",
+    })),
+    base: Type.Optional(Type.String({
+        description: "Base ref for new branches. Defaults to HEAD. Only used with create.",
+    })),
+});
+const DESCRIPTION = `Manage git branches.
+
+Modes (selected by which fields you set):
+- No name → list local + remote-tracking branches.
+- name only → switch to that branch (\`git switch\`). Permission-gated.
+- name + create: true → create a new branch (off base or HEAD) and switch to it. Permission-gated.
+
+Listing is read-only and skips the permission prompt. Creating or switching mutates working-tree state and prompts.`;
+export function createGitBranch(ctx) {
+    return {
+        name: "git_branch",
+        label: "Git branch",
+        description: DESCRIPTION,
+        parameters: Params,
+        executionMode: "sequential",
+        execute: async (_id, params, signal) => {
+            await requireGitRepo(ctx.cwd);
+            if (!params.name) {
+                const r = await runGit(["branch", "-a", "--no-color"], ctx.cwd, signal);
+                if (r.exitCode !== 0) {
+                    throw new Error(r.stderr.trim() || `git branch exited ${r.exitCode}`);
+                }
+                const { branches, current } = parseBranchList(r.stdout);
+                return {
+                    content: [{ type: "text", text: branches.length ? branches.join("\n") : "(no branches)" }],
+                    details: { mode: "list", branches, current: current ?? undefined },
+                };
+            }
+            if (params.create) {
+                const args = ["switch", "-c", params.name];
+                if (params.base)
+                    args.push(params.base);
+                const r = await runGit(args, ctx.cwd, signal);
+                if (r.exitCode !== 0) {
+                    throw new Error(r.stderr.trim() || `git switch -c ${params.name} exited ${r.exitCode}`);
+                }
+                return {
+                    content: [{ type: "text", text: `created and switched to ${params.name}` }],
+                    details: { mode: "create", branch: params.name },
+                };
+            }
+            const r = await runGit(["switch", params.name], ctx.cwd, signal);
+            if (r.exitCode !== 0) {
+                throw new Error(r.stderr.trim() || `git switch ${params.name} exited ${r.exitCode}`);
+            }
+            return {
+                content: [{ type: "text", text: `switched to ${params.name}` }],
+                details: { mode: "switch", branch: params.name },
+            };
+        },
+    };
+}
+function parseBranchList(output) {
+    const branches = [];
+    let current = null;
+    for (const raw of output.split("\n")) {
+        const line = raw.trim();
+        if (!line)
+            continue;
+        if (line.startsWith("* ")) {
+            const name = line.slice(2).trim();
+            current = name;
+            branches.push(`* ${name}`);
+        }
+        else {
+            branches.push(`  ${line.replace(/^[+-]\s*/, "")}`);
+        }
+    }
+    return { branches, current };
+}
+//# sourceMappingURL=branch.js.map

package/dist/tools/git/branch.js.map

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

package/dist/tools/git/commit.js

@@ -0,0 +1,83 @@
+import { Type } from "typebox";
+import { requireGitRepo, runGit } from "./git-helpers.js";
+const Params = Type.Object({
+    message: Type.String({
+        minLength: 1,
+        description: "Commit message. Multi-line messages are written via -F to preserve formatting.",
+    }),
+    files: Type.Optional(Type.Array(Type.String(), {
+        description: "Specific paths to stage before commit. Mutually exclusive with stage_all.",
+    })),
+    stage_all: Type.Optional(Type.Boolean({
+        description: "Run `git add -A` before commit. Mutually exclusive with files.",
+    })),
+});
+const DESCRIPTION = `Create a git commit. Permission-gated.
+
+Behavior:
+- If files is set, runs \`git add <paths>\` first, then commits only those.
+- If stage_all is set, runs \`git add -A\` first.
+- If neither is set, commits whatever's currently staged.
+- Multi-line messages are passed via -F (a temp file) to preserve formatting.
+- Pre-commit hooks run normally; their failure stderr surfaces to you.
+- Errors with "nothing to commit" if the index is empty after staging.`;
+export function createGitCommit(ctx) {
+    return {
+        name: "git_commit",
+        label: "Git commit",
+        description: DESCRIPTION,
+        parameters: Params,
+        executionMode: "sequential",
+        execute: async (_id, params, signal) => {
+            await requireGitRepo(ctx.cwd);
+            if (params.files && params.stage_all) {
+                throw new Error("Pass files or stage_all, not both.");
+            }
+            if (params.stage_all) {
+                const r = await runGit(["add", "-A"], ctx.cwd, signal);
+                if (r.exitCode !== 0) {
+                    throw new Error(r.stderr.trim() || `git add -A exited ${r.exitCode}`);
+                }
+            }
+            else if (params.files && params.files.length > 0) {
+                const r = await runGit(["add", "--", ...params.files], ctx.cwd, signal);
+                if (r.exitCode !== 0) {
+                    throw new Error(r.stderr.trim() || `git add exited ${r.exitCode}`);
+                }
+            }
+            const commit = await runGit(["commit", "-F", "-"], ctx.cwd, signal, params.message);
+            if (commit.exitCode !== 0) {
+                const stderr = commit.stderr.trim();
+                const stdout = commit.stdout.trim();
+                const reason = stderr || stdout || `git commit exited ${commit.exitCode}`;
+                throw new Error(reason);
+            }
+            const subject = params.message.split("\n")[0] ?? "";
+            const sha = await readHeadSha(ctx.cwd, signal);
+            const branch = await readCurrentBranch(ctx.cwd, signal);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: sha && branch ? `committed ${sha.slice(0, 7)} on ${branch}: ${subject}` : `committed: ${subject}`,
+                    },
+                ],
+                details: { sha, subject, branch },
+            };
+        },
+    };
+}
+async function readHeadSha(cwd, signal) {
+    const r = await runGit(["rev-parse", "HEAD"], cwd, signal);
+    if (r.exitCode !== 0)
+        return null;
+    return r.stdout.trim() || null;
+}
+async function readCurrentBranch(cwd, signal) {
+    const r = await runGit(["rev-parse", "--abbrev-ref", "HEAD"], cwd, signal);
+    if (r.exitCode !== 0)
+        return null;
+    const branch = r.stdout.trim();
+    return branch && branch !== "HEAD" ? branch : null;
+}
+//# sourceMappingURL=commit.js.map

package/dist/tools/git/commit.js.map

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

package/dist/tools/git/diff.js

@@ -0,0 +1,72 @@
+import { Type } from "typebox";
+import { requireGitRepo, runGit } from "./git-helpers.js";
+const Params = Type.Object({
+    staged: Type.Optional(Type.Boolean({
+        description: "Show staged changes (--cached). Default false (working-tree changes).",
+    })),
+    ref: Type.Optional(Type.String({
+        description: "Compare against a specific ref (commit, branch, tag). Mutually exclusive with staged.",
+    })),
+    path: Type.Optional(Type.String({
+        description: "Limit the diff to a path (file or directory).",
+    })),
+    max_lines: Type.Optional(Type.Integer({
+        minimum: 1,
+        maximum: 10000,
+        description: "Cap on diff output lines. Default 2000.",
+    })),
+});
+const DEFAULT_LINE_LIMIT = 2000;
+const DESCRIPTION = `Show a unified diff. Defaults to working-tree vs index. Set staged: true to see staged-vs-HEAD, or ref: <commit/branch/tag> to compare HEAD against that ref. Limit to a path with the path argument.
+
+Output is the raw diff text, capped at 2000 lines by default. Use git_log to find a ref to diff against.`;
+export function createGitDiff(ctx) {
+    return {
+        name: "git_diff",
+        label: "Git diff",
+        description: DESCRIPTION,
+        parameters: Params,
+        executionMode: "parallel",
+        execute: async (_id, params, signal) => {
+            await requireGitRepo(ctx.cwd);
+            if (params.staged && params.ref) {
+                throw new Error("Pass either staged or ref, not both.");
+            }
+            const argv = ["diff", "--no-color"];
+            let mode = "working";
+            if (params.staged) {
+                argv.push("--cached");
+                mode = "staged";
+            }
+            else if (params.ref) {
+                argv.push(params.ref);
+                mode = "ref";
+            }
+            if (params.path) {
+                argv.push("--", params.path);
+            }
+            const r = await runGit(argv, ctx.cwd, signal);
+            if (r.exitCode !== 0 && r.exitCode !== 1) {
+                // 1 means "differences found", which is normal for diff
+                throw new Error(r.stderr.trim() || `git diff exited ${r.exitCode}`);
+            }
+            const limit = params.max_lines ?? DEFAULT_LINE_LIMIT;
+            const allLines = r.stdout.split("\n");
+            const truncated = allLines.length > limit;
+            const shown = truncated ? allLines.slice(0, limit) : allLines;
+            const tail = truncated ? `\n... (showing ${limit} of ${allLines.length} lines)` : "";
+            const text = shown.join("\n") + tail;
+            return {
+                content: [{ type: "text", text: text || "(no changes)" }],
+                details: {
+                    mode,
+                    ref: params.ref ?? null,
+                    path: params.path ?? null,
+                    bytes: r.stdout.length,
+                    truncated,
+                },
+            };
+        },
+    };
+}
+//# sourceMappingURL=diff.js.map

package/dist/tools/git/diff.js.map

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

package/dist/tools/git/git-helpers.js

@@ -0,0 +1,58 @@
+import { spawn } from "node:child_process";
+/**
+ * Spawn `git` with the given args. Returns a Promise that resolves with
+ * captured stdout, stderr, and exit code. Never throws — caller decides
+ * whether non-zero is an error in their context.
+ *
+ * If `stdin` is provided it's written to the child's stdin and stdin is
+ * closed (used for `git commit -F -` to feed multi-line messages without
+ * a temp file).
+ */
+export function runGit(args, cwd, signal, stdin) {
+    return new Promise((resolveRun) => {
+        const child = spawn("git", args, {
+            cwd,
+            env: process.env,
+            stdio: [stdin === undefined ? "ignore" : "pipe", "pipe", "pipe"],
+        });
+        if (stdin !== undefined) {
+            try {
+                child.stdin?.write(stdin);
+                child.stdin?.end();
+            }
+            catch {
+                // stdin already closed by a fast exit — that's fine
+            }
+        }
+        const out = [];
+        const err = [];
+        child.stdout?.on("data", (b) => out.push(b));
+        child.stderr?.on("data", (b) => err.push(b));
+        const onAbort = () => child.kill("SIGTERM");
+        signal?.addEventListener("abort", onAbort);
+        child.on("error", (e) => {
+            signal?.removeEventListener("abort", onAbort);
+            resolveRun({ stdout: "", stderr: e.message, exitCode: 1 });
+        });
+        child.on("close", (code) => {
+            signal?.removeEventListener("abort", onAbort);
+            resolveRun({
+                stdout: Buffer.concat(out).toString("utf8"),
+                stderr: Buffer.concat(err).toString("utf8"),
+                exitCode: code ?? 1,
+            });
+        });
+    });
+}
+/** True if cwd is inside a git work tree. */
+export async function isGitRepo(cwd) {
+    const r = await runGit(["rev-parse", "--is-inside-work-tree"], cwd);
+    return r.exitCode === 0 && r.stdout.trim() === "true";
+}
+/** Throws an actionable error if cwd is not a git repo. */
+export async function requireGitRepo(cwd) {
+    if (!(await isGitRepo(cwd))) {
+        throw new Error(`Not a git repository (or any parent): ${cwd}`);
+    }
+}
+//# sourceMappingURL=git-helpers.js.map

package/dist/tools/git/git-helpers.js.map

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

package/dist/tools/git/log.js

@@ -0,0 +1,70 @@
+import { Type } from "typebox";
+import { requireGitRepo, runGit } from "./git-helpers.js";
+const Params = Type.Object({
+    count: Type.Optional(Type.Integer({
+        minimum: 1,
+        maximum: 200,
+        description: "Number of commits to show. Default 10, max 200.",
+    })),
+    oneline: Type.Optional(Type.Boolean({
+        description: "Compact one-line-per-commit output (--oneline). Default true.",
+    })),
+    path: Type.Optional(Type.String({
+        description: "Limit history to commits touching this path.",
+    })),
+    ref: Type.Optional(Type.String({
+        description: "Show history of a specific ref (branch, tag). Defaults to HEAD.",
+    })),
+});
+const DEFAULT_COUNT = 10;
+const DESCRIPTION = `Show recent commits. Defaults to 10 most recent on HEAD, in --oneline format (short SHA + subject).
+
+Pass count to fetch more, ref to log a specific branch/tag, or path to filter to commits that touched a file or directory.`;
+export function createGitLog(ctx) {
+    return {
+        name: "git_log",
+        label: "Git log",
+        description: DESCRIPTION,
+        parameters: Params,
+        executionMode: "parallel",
+        execute: async (_id, params, signal) => {
+            await requireGitRepo(ctx.cwd);
+            const count = params.count ?? DEFAULT_COUNT;
+            const oneline = params.oneline ?? true;
+            const argv = ["log", `-n${count}`, "--no-color"];
+            if (oneline)
+                argv.push("--oneline");
+            if (params.ref)
+                argv.push(params.ref);
+            if (params.path)
+                argv.push("--", params.path);
+            const r = await runGit(argv, ctx.cwd, signal);
+            if (r.exitCode !== 0) {
+                throw new Error(r.stderr.trim() || `git log exited ${r.exitCode}`);
+            }
+            const entries = oneline ? parseOneline(r.stdout) : [];
+            return {
+                content: [{ type: "text", text: r.stdout.trim() || "(no commits)" }],
+                details: {
+                    count: oneline ? entries.length : r.stdout.split("\ncommit ").length,
+                    entries,
+                    ref: params.ref ?? null,
+                    path: params.path ?? null,
+                },
+            };
+        },
+    };
+}
+function parseOneline(stdout) {
+    const entries = [];
+    for (const line of stdout.split("\n")) {
+        if (!line)
+            continue;
+        const space = line.indexOf(" ");
+        if (space === -1)
+            continue;
+        entries.push({ sha: line.slice(0, space), subject: line.slice(space + 1) });
+    }
+    return entries;
+}
+//# sourceMappingURL=log.js.map

package/dist/tools/git/log.js.map

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