git-remote-ops 0.1.0 → 0.2.0

package/dist/cli.js

@@ -0,0 +1,215 @@
+#!/usr/bin/env node
+/**
+ * @module cli
+ *
+ * Commander-driven command-line front-end. Each subcommand wires the global
+ * verbosity / stats flags into a freshly built {@link RemoteGit}, executes
+ * one operation, and prints a plain-text result to stdout. Errors come back
+ * through {@link unwrap} as `[Tag] message` lines on stderr with exit 1.
+ *
+ * Subcommands:
+ *  - `probe`       — capability + filter probe
+ *  - `ls-refs`     — list advertised refs
+ *  - `cat-commit`  — fetch one commit
+ *  - `cat-tree`    — fetch a commit's root tree (or a tree by sha)
+ *  - `list-files`  — walk a snapshot and emit every file path
+ *  - `cat-blob`    — pipe one blob's raw bytes to stdout
+ */
+import { Command, InvalidArgumentError } from "commander";
+import { Logger, RemoteGit } from "./index.js";
+import { parseTree } from "./objects/index.js";
+/** Bumped in lockstep with `package.json`. Surfaced by `git-remote-ops --version`. */
+const VERSION = "0.2.0";
+/** Octal mode of a subtree entry — used to recurse during `list-files`. */
+const TREE_MODE = "40000";
+function resolveLevel(flags) {
+    if (flags.quiet)
+        return "silent";
+    if (flags.debug)
+        return "trace";
+    if (flags.verbose)
+        return "debug";
+    return "info";
+}
+function makeClient(url, flags) {
+    const logger = new Logger({
+        level: resolveLevel(flags),
+        sink: (line) => console.error(line),
+    }, "client");
+    const client = new RemoteGit(url, { logger, storeDir: flags.storeDir });
+    return { client, logger };
+}
+function unwrap(result) {
+    if (result.isErr()) {
+        console.error(`[${result.error._tag}] ${result.error.message}`);
+        process.exit(1);
+    }
+    return result.value;
+}
+function maybeStats(logger, flags) {
+    if (flags.stats)
+        console.error(logger.summary());
+}
+async function cachedTreeEntries(client, treeSha) {
+    const object = await client.getObject(treeSha);
+    if (!object) {
+        console.error(`[ObjectNotFoundError] tree not present in fetched pack: ${treeSha}`);
+        process.exit(1);
+    }
+    if (object.type !== "tree") {
+        console.error(`[ObjectDecodeError] object is not a tree: ${treeSha}`);
+        process.exit(1);
+    }
+    const entries = parseTree(object.content);
+    if (entries.isErr()) {
+        console.error(`[${entries.error._tag}] ${entries.error.message}`);
+        process.exit(1);
+    }
+    return entries.value;
+}
+async function printCachedFiles(client, entries, prefix, details) {
+    for (const entry of entries) {
+        const path = prefix ? `${prefix}/${entry.name}` : entry.name;
+        if (entry.mode === TREE_MODE) {
+            await printCachedFiles(client, await cachedTreeEntries(client, entry.sha), path, details);
+        }
+        else {
+            console.log(details ? `${entry.mode} ${entry.sha} ${path}` : path);
+        }
+    }
+}
+function parseDepth(value) {
+    const depth = Number(value);
+    if (!Number.isInteger(depth) || depth < 1) {
+        throw new InvalidArgumentError("--depth must be >= 1");
+    }
+    return depth;
+}
+function globalFlags() {
+    return program.opts();
+}
+const program = new Command()
+    .name("git-remote-ops")
+    .version(VERSION)
+    .description("Read-only Git remote operations over smart HTTP.")
+    .showHelpAfterError()
+    .option("-q, --quiet", "Suppress all log output (silent level).")
+    .option("-v, --verbose", "Enable debug-level logs to stderr.")
+    .option("--debug", "Enable trace-level logs to stderr (very chatty).")
+    .requiredOption("--store-dir <path>", "Directory for reusable loose-object cache.")
+    .option("--stats", "Print performance/analytics summary on stderr after completion.")
+    .hook("preAction", (thisCommand) => {
+    const flags = thisCommand.optsWithGlobals();
+    if (flags.quiet && (flags.verbose || flags.debug)) {
+        thisCommand.error("error: option '-q, --quiet' cannot be used with '-v, --verbose' or '--debug'");
+    }
+});
+program
+    .command("probe")
+    .description("Probe server capabilities (protocol, filter, shallow).")
+    .argument("<url>")
+    .action(async (url, command) => {
+    const flags = globalFlags();
+    const { client, logger } = makeClient(url, flags);
+    const profile = unwrap(await client.probe(true));
+    console.log(`refs=${profile.refs.size}`);
+    console.log(`protocol=${profile.protocolVersion}`);
+    console.log(`filter_blob_none=${profile.supportsFilterBlobNone}`);
+    console.log(`filter_tree_0=${profile.supportsFilterTree0}`);
+    console.log(`shallow=${profile.supportsShallow}`);
+    maybeStats(logger, flags);
+});
+program
+    .command("ls-refs")
+    .description("List remote refs as '<sha> <name>' per line.")
+    .argument("<url>")
+    .action(async (url, command) => {
+    const flags = globalFlags();
+    const { client, logger } = makeClient(url, flags);
+    for (const [name, sha] of unwrap(await client.lsRefs())) {
+        console.log(`${sha} ${name}`);
+    }
+    maybeStats(logger, flags);
+});
+program
+    .command("cat-commit")
+    .description("Fetch & print a commit object.")
+    .argument("<url>")
+    .option("--ref <ref>", "Ref or sha to resolve.", "HEAD")
+    .option("--depth <n>", "Shallow depth (ignored if server lacks shallow).", parseDepth, 1)
+    .option("--filter <spec>", "Object filter spec (e.g. blob:none, tree:0).", "blob:none")
+    .option("--no-filter", "Fetch without object filter; may download a full snapshot pack.")
+    .action(async (url, options) => {
+    const flags = globalFlags();
+    const { client, logger } = makeClient(url, flags);
+    const filter = options.filter === false ? undefined : options.filter;
+    const { sha, commit } = unwrap(await client.fetchCommit(options.ref, { depth: options.depth, filter }));
+    console.log(`commit ${sha}`);
+    console.log(`tree ${commit.tree}`);
+    if (commit.parent)
+        console.log(`parent ${commit.parent}`);
+    if (commit.author)
+        console.log(`author ${commit.author}`);
+    if (commit.committer)
+        console.log(`committer ${commit.committer}`);
+    maybeStats(logger, flags);
+});
+program
+    .command("cat-tree")
+    .description("Fetch a commit snapshot and print its root tree as '<mode> <sha> <name>' per entry.")
+    .argument("<url>")
+    .option("--ref <ref>", "Ref or commit sha to resolve.", "HEAD")
+    .option("--depth <n>", "Shallow depth (ignored if server lacks shallow).", parseDepth, 1)
+    .option("--filter <spec>", "Object filter spec (e.g. blob:none, tree:0).", "blob:none")
+    .option("--no-filter", "Fetch without object filter; downloads a full snapshot pack.")
+    .option("--tree-sha <sha>", "Fetch the tree by SHA directly (no commit snapshot).")
+    .action(async (url, options) => {
+    const flags = globalFlags();
+    const { client, logger } = makeClient(url, flags);
+    if (options.treeSha) {
+        for (const entry of unwrap(await client.fetchTree(options.treeSha))) {
+            console.log(`${entry.mode} ${entry.sha} ${entry.name}`);
+        }
+    }
+    else {
+        const filter = options.filter === false ? undefined : options.filter;
+        const result = unwrap(await client.fetchTreeForCommit(options.ref, { depth: options.depth, filter }));
+        for (const entry of result.entries) {
+            console.log(`${entry.mode} ${entry.sha} ${entry.name}`);
+        }
+    }
+    maybeStats(logger, flags);
+});
+program
+    .command("list-files")
+    .description("List all files in a commit snapshot without cloning.")
+    .argument("<url>")
+    .option("--ref <ref>", "Ref or commit sha to resolve.", "HEAD")
+    .option("--depth <n>", "Shallow depth (ignored if server lacks shallow).", parseDepth, 1)
+    .option("--filter <spec>", "Object filter spec (e.g. blob:none, tree:0).", "blob:none")
+    .option("--no-filter", "Fetch without object filter; downloads a full snapshot pack.")
+    .option("--details", "Print '<mode> <sha> <path>' instead of path only.")
+    .action(async (url, options) => {
+    const flags = globalFlags();
+    const { client, logger } = makeClient(url, flags);
+    const filter = options.filter === false ? undefined : options.filter;
+    const result = unwrap(await client.fetchTreeForCommit(options.ref, {
+        depth: options.depth,
+        filter,
+    }));
+    await printCachedFiles(client, result.entries, "", !!options.details);
+    maybeStats(logger, flags);
+});
+program
+    .command("cat-blob")
+    .description("Fetch a blob and write raw bytes to stdout.")
+    .argument("<url>")
+    .argument("<blob-sha>")
+    .action(async (url, sha, command) => {
+    const flags = globalFlags();
+    const { client, logger } = makeClient(url, flags);
+    process.stdout.write(unwrap(await client.fetchBlob(sha)));
+    maybeStats(logger, flags);
+});
+await program.parseAsync(process.argv);
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAE1D,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE/C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,sFAAsF;AACtF,MAAM,OAAO,GAAG,OAAO,CAAC;AACxB,2EAA2E;AAC3E,MAAM,SAAS,GAAG,OAAO,CAAC;AAU1B,SAAS,YAAY,CAAC,KAAkB;IACtC,IAAI,KAAK,CAAC,KAAK;QAAE,OAAO,QAAQ,CAAC;IACjC,IAAI,KAAK,CAAC,KAAK;QAAE,OAAO,OAAO,CAAC;IAChC,IAAI,KAAK,CAAC,OAAO;QAAE,OAAO,OAAO,CAAC;IAClC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,UAAU,CAAC,GAAW,EAAE,KAAkB;IACjD,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC;QACxB,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC;QAC1B,IAAI,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC;KAC5C,EAAE,QAAQ,CAAC,CAAC;IACb,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;IACxE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAC5B,CAAC;AAED,SAAS,MAAM,CAAI,MAAoC;IACrD,IAAI,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC;QACnB,OAAO,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAChE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC;AACtB,CAAC;AAED,SAAS,UAAU,CAAC,MAAc,EAAE,KAAkB;IACpD,IAAI,KAAK,CAAC,KAAK;QAAE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;AACnD,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,MAAiB,EAAE,OAAe;IACjE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC/C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,KAAK,CAAC,2DAA2D,OAAO,EAAE,CAAC,CAAC;QACpF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC3B,OAAO,CAAC,KAAK,CAAC,6CAA6C,OAAO,EAAE,CAAC,CAAC;QACtE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,OAAO,GAAG,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC1C,IAAI,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;QACpB,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAClE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,OAAO,CAAC,KAAK,CAAC;AACvB,CAAC;AAED,KAAK,UAAU,gBAAgB,CAC7B,MAAiB,EACjB,OAAoB,EACpB,MAAc,EACd,OAAgB;IAEhB,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;QAC7D,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,gBAAgB,CAAC,MAAM,EAAE,MAAM,iBAAiB,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QAC5F,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,oBAAoB,CAAC,sBAAsB,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,WAAW;IAClB,OAAO,OAAO,CAAC,IAAI,EAAe,CAAC;AACrC,CAAC;AAED,MAAM,OAAO,GAAY,IAAI,OAAO,EAAE;KACnC,IAAI,CAAC,gBAAgB,CAAC;KACtB,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,kDAAkD,CAAC;KAC/D,kBAAkB,EAAE;KACpB,MAAM,CAAC,aAAa,EAAE,yCAAyC,CAAC;KAChE,MAAM,CAAC,eAAe,EAAE,oCAAoC,CAAC;KAC7D,MAAM,CAAC,SAAS,EAAE,kDAAkD,CAAC;KACrE,cAAc,CAAC,oBAAoB,EAAE,4CAA4C,CAAC;KAClF,MAAM,CAAC,SAAS,EAAE,iEAAiE,CAAC;KACpF,IAAI,CAAC,WAAW,EAAE,CAAC,WAAW,EAAE,EAAE;IACjC,MAAM,KAAK,GAAG,WAAW,CAAC,eAAe,EAAe,CAAC;IACzD,IAAI,KAAK,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QAClD,WAAW,CAAC,KAAK,CAAC,8EAA8E,CAAC,CAAC;IACpG,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,wDAAwD,CAAC;KACrE,QAAQ,CAAC,OAAO,CAAC;KACjB,MAAM,CAAC,KAAK,EAAE,GAAW,EAAE,OAAgB,EAAE,EAAE;IAC9C,MAAM,KAAK,GAAG,WAAW,EAAE,CAAC;IAC5B,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAClD,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IACjD,OAAO,CAAC,GAAG,CAAC,QAAQ,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACzC,OAAO,CAAC,GAAG,CAAC,YAAY,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IACnD,OAAO,CAAC,GAAG,CAAC,oBAAoB,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAAC;IAClE,OAAO,CAAC,GAAG,CAAC,iBAAiB,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAC5D,OAAO,CAAC,GAAG,CAAC,WAAW,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAClD,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAC5B,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,SAAS,CAAC;KAClB,WAAW,CAAC,8CAA8C,CAAC;KAC3D,QAAQ,CAAC,OAAO,CAAC;KACjB,MAAM,CAAC,KAAK,EAAE,GAAW,EAAE,OAAgB,EAAE,EAAE;IAC9C,MAAM,KAAK,GAAG,WAAW,EAAE,CAAC;IAC5B,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAClD,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC;QACxD,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,CAAC;IAChC,CAAC;IACD,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAC5B,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,YAAY,CAAC;KACrB,WAAW,CAAC,gCAAgC,CAAC;KAC7C,QAAQ,CAAC,OAAO,CAAC;KACjB,MAAM,CAAC,aAAa,EAAE,wBAAwB,EAAE,MAAM,CAAC;KACvD,MAAM,CAAC,aAAa,EAAE,kDAAkD,EAAE,UAAU,EAAE,CAAC,CAAC;KACxF,MAAM,CAAC,iBAAiB,EAAE,8CAA8C,EAAE,WAAW,CAAC;KACtF,MAAM,CAAC,aAAa,EAAE,iEAAiE,CAAC;KACxF,MAAM,CAAC,KAAK,EAAE,GAAW,EAAE,OAA+D,EAAE,EAAE;IAC7F,MAAM,KAAK,GAAG,WAAW,EAAE,CAAC;IAC5B,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IACrE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,CAC5B,MAAM,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CACxE,CAAC;IACF,OAAO,CAAC,GAAG,CAAC,UAAU,GAAG,EAAE,CAAC,CAAC;IAC7B,OAAO,CAAC,GAAG,CAAC,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IACnC,IAAI,MAAM,CAAC,MAAM;QAAE,OAAO,CAAC,GAAG,CAAC,UAAU,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1D,IAAI,MAAM,CAAC,MAAM;QAAE,OAAO,CAAC,GAAG,CAAC,UAAU,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1D,IAAI,MAAM,CAAC,SAAS;QAAE,OAAO,CAAC,GAAG,CAAC,aAAa,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;IACnE,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAC5B,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,UAAU,CAAC;KACnB,WAAW,CAAC,qFAAqF,CAAC;KAClG,QAAQ,CAAC,OAAO,CAAC;KACjB,MAAM,CAAC,aAAa,EAAE,+BAA+B,EAAE,MAAM,CAAC;KAC9D,MAAM,CAAC,aAAa,EAAE,kDAAkD,EAAE,UAAU,EAAE,CAAC,CAAC;KACxF,MAAM,CAAC,iBAAiB,EAAE,8CAA8C,EAAE,WAAW,CAAC;KACtF,MAAM,CAAC,aAAa,EAAE,8DAA8D,CAAC;KACrF,MAAM,CAAC,kBAAkB,EAAE,sDAAsD,CAAC;KAClF,MAAM,CACL,KAAK,EACH,GAAW,EACX,OAAiF,EACjF,EAAE;IACF,MAAM,KAAK,GAAG,WAAW,EAAE,CAAC;IAC5B,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAClD,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;YACpE,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;SAAM,CAAC;QACN,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;QACrE,MAAM,MAAM,GAAG,MAAM,CACnB,MAAM,MAAM,CAAC,kBAAkB,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAC/E,CAAC;QACF,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnC,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IACD,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAC5B,CAAC,CACF,CAAC;AAEJ,OAAO;KACJ,OAAO,CAAC,YAAY,CAAC;KACrB,WAAW,CAAC,sDAAsD,CAAC;KACnE,QAAQ,CAAC,OAAO,CAAC;KACjB,MAAM,CAAC,aAAa,EAAE,+BAA+B,EAAE,MAAM,CAAC;KAC9D,MAAM,CAAC,aAAa,EAAE,kDAAkD,EAAE,UAAU,EAAE,CAAC,CAAC;KACxF,MAAM,CAAC,iBAAiB,EAAE,8CAA8C,EAAE,WAAW,CAAC;KACtF,MAAM,CAAC,aAAa,EAAE,8DAA8D,CAAC;KACrF,MAAM,CAAC,WAAW,EAAE,mDAAmD,CAAC;KACxE,MAAM,CACL,KAAK,EACH,GAAW,EACX,OAAkF,EAClF,EAAE;IACF,MAAM,KAAK,GAAG,WAAW,EAAE,CAAC;IAC5B,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IACrE,MAAM,MAAM,GAAG,MAAM,CACnB,MAAM,MAAM,CAAC,kBAAkB,CAAC,OAAO,CAAC,GAAG,EAAE;QAC3C,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM;KACP,CAAC,CACH,CAAC;IACF,MAAM,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACtE,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAC5B,CAAC,CACF,CAAC;AAEJ,OAAO;KACJ,OAAO,CAAC,UAAU,CAAC;KACnB,WAAW,CAAC,6CAA6C,CAAC;KAC1D,QAAQ,CAAC,OAAO,CAAC;KACjB,QAAQ,CAAC,YAAY,CAAC;KACtB,MAAM,CAAC,KAAK,EAAE,GAAW,EAAE,GAAW,EAAE,OAAgB,EAAE,EAAE;IAC3D,MAAM,KAAK,GAAG,WAAW,EAAE,CAAC;IAC5B,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAClD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC1D,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAC5B,CAAC,CAAC,CAAC;AAEL,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/{types → dist}/client.d.ts

@@ -5,11 +5,8 @@
  * transport, protocol, and pack layers behind a small surface: discover a
  * server, ask for commits/trees/blobs, get them back as decoded objects.
  *
- * The client caches:
- *  - a single {@link ServerProfile} (capabilities + ref advertisement);
- *  - every object materialized by any prior fetch, in a process-lifetime
- *    map. Subsequent fetches dedupe wants against this map so multi-step
- *    workflows (commit → tree → blob) only pay for what's new.
+ * The client caches a single {@link ServerProfile}; objects are stored in the
+ * caller-supplied loose-object directory and deduped across calls by SHA.
  */
 import { Result } from "better-result";
 import type { GitRemoteOpsError } from "./errors.js";
@@ -26,19 +23,17 @@ export declare class RemoteGit {
     readonly url: string;
     readonly logger: Logger;
     private profile;
-    private objects;
-    private snapshotCommits;
+    private store;
     private diagnostic?;
     private transportLogger;
     private packLogger;
     /**
      * @param url Base repository URL (e.g. `https://github.com/owner/repo.git`).
      *   Trailing slashes are stripped.
-     * @param options Optional logger / diagnostic sink. When neither is given, a
-     *   silent logger is used. Passing `diagnostic` alone gets you a `debug`
-     *   logger routed to the diagnostic function.
+     * @param options Required object store directory plus optional logger / diagnostic sink. When no
+     *   logger is given, a silent logger is used. Passing `diagnostic` alone gets you a `debug` logger.
      */
-    constructor(url: string, options?: RemoteGitOptions);
+    constructor(url: string, options: RemoteGitOptions);
     /**
      * Fetch and cache the server's ref/capability advertisement.
      *
@@ -85,9 +80,8 @@ export declare class RemoteGit {
     /**
      * Fetch the commit at `ref` *and* its root tree from a single snapshot pack.
      *
-     * Forces `parseFull: true` so the tree object — which the commit references
-     * but doesn't `want` directly — ends up in the local object store. Useful
-     * for "list files at HEAD" without a clone.
+     * Uses tree retention so the tree object — which the commit references but
+     * doesn't `want` directly — ends up in the local object store without blobs.
      */
     fetchTreeForCommit(ref: string, options?: FetchCommitOptions): Promise<Result<{
         commit: CommitInfo;
@@ -97,8 +91,10 @@ export declare class RemoteGit {
     /** Fetch and decode a single tree by sha. */
     fetchTree(sha: string): Promise<Result<TreeEntry[], GitRemoteOpsError>>;
     /** Look up an already-materialized object by sha. Does not fetch on miss. */
-    getObject(sha: string): GitObject | undefined;
+    getObject(sha: string): Promise<GitObject | undefined>;
+    private requiredObject;
     private fetchObjects;
+    private parsePackFile;
     private probeFilter;
     private fetchPack;
     private normalizeWants;

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAOrD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,KAAK,EACV,UAAU,EAEV,kBAAkB,EAClB,SAAS,EAGT,gBAAgB,EAChB,aAAa,EACb,SAAS,EACV,MAAM,YAAY,CAAC;AA8CpB;;;;;;GAMG;AACH,qBAAa,SAAS;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,UAAU,CAAC,CAAe;IAClC,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,UAAU,CAAS;IAE3B;;;;;OAKG;gBACS,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB;IAalD;;;;;;;OAOG;IACG,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,iBAAiB,CAAC,CAAC;IAoCnE;;;;;;;;;OASG;IACG,KAAK,CAAC,OAAO,UAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,iBAAiB,CAAC,CAAC;IAkB/E,8FAA8F;IACxF,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,iBAAiB,CAAC,CAAC;IAMvE;;;;;;OAMG;IACG,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAezE;;;;;;OAMG;IACG,WAAW,CACf,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,MAAM,CAAC;QAAE,MAAM,EAAE,UAAU,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,EAAE,iBAAiB,CAAC,CAAC;IAwC1E,uDAAuD;IACjD,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,iBAAiB,CAAC,CAAC;IAoB5E;;;;;OAKG;IACG,kBAAkB,CACtB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CACR,MAAM,CAAC;QAAE,MAAM,EAAE,UAAU,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,SAAS,EAAE,CAAA;KAAE,EAAE,iBAAiB,CAAC,CAC3F;IAwBD,6CAA6C;IACvC,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,iBAAiB,CAAC,CAAC;IAsB7E,6EAA6E;IACvE,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;YAK9C,cAAc;YAMd,YAAY;YAkDZ,aAAa;YAqBb,WAAW;YAoCX,SAAS;YAoCT,cAAc;IAa5B,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,GAAG;CAGZ"}

package/{esm → dist}/client.js

@@ -5,18 +5,17 @@
  * transport, protocol, and pack layers behind a small surface: discover a
  * server, ask for commits/trees/blobs, get them back as decoded objects.
  *
- * The client caches:
- *  - a single {@link ServerProfile} (capabilities + ref advertisement);
- *  - every object materialized by any prior fetch, in a process-lifetime
- *    map. Subsequent fetches dedupe wants against this map so multi-step
- *    workflows (commit → tree → blob) only pay for what's new.
+ * The client caches a single {@link ServerProfile}; objects are stored in the
+ * caller-supplied loose-object directory and deduped across calls by SHA.
  */
 import { Result } from "better-result";
-import { ObjectDecodeError, ObjectNotFoundError, RefNotFoundError } from "./errors.js";
+import { readFile, rm } from "node:fs/promises";
+import { ObjectDecodeError, ObjectNotFoundError, PackParseError, RefNotFoundError, } from "./errors.js";
 import { Logger } from "./logger.js";
 import { parseCommit, parseTree } from "./objects/index.js";
 import { parsePackfile } from "./pack/index.js";
-import { buildFetchRequest, extractPack, parseRefAdvertisement, parseV2CapabilityAdvertisement, } from "./protocol/index.js";
+import { buildFetchRequest, extractPackToFile, parseRefAdvertisement, parseV2CapabilityAdvertisement, } from "./protocol/index.js";
+import { LooseObjectStore } from "./store.js";
 import { getSmartHttp, postUploadPack } from "./transport.js";
 /**
  * Capabilities offered on every v0 fetch unless overridden. `shallow` and
@@ -33,8 +32,9 @@ const DEFAULT_CAPS = [
     "multi_ack",
     "side-band-64k",
     "ofs-delta",
-    "agent=git-remote-ops-deno/0.1",
+    "agent=git-remote-ops/0.1",
 ];
+const TREE_RETAIN_TYPES = new Set(["commit", "tree"]);
 function fail(error) {
     return Result.err(error);
 }
@@ -56,25 +56,24 @@ export class RemoteGit {
     url;
     logger;
     profile = null;
-    objects = new Map();
-    snapshotCommits = new Set();
+    store;
     diagnostic;
     transportLogger;
     packLogger;
     /**
      * @param url Base repository URL (e.g. `https://github.com/owner/repo.git`).
      *   Trailing slashes are stripped.
-     * @param options Optional logger / diagnostic sink. When neither is given, a
-     *   silent logger is used. Passing `diagnostic` alone gets you a `debug`
-     *   logger routed to the diagnostic function.
+     * @param options Required object store directory plus optional logger / diagnostic sink. When no
+     *   logger is given, a silent logger is used. Passing `diagnostic` alone gets you a `debug` logger.
      */
     constructor(url, options) {
         this.url = url.replace(/\/+$/, "");
-        this.diagnostic = options?.diagnostic;
-        this.logger = options?.logger ??
+        this.store = new LooseObjectStore(options.storeDir);
+        this.diagnostic = options.diagnostic;
+        this.logger = options.logger ??
             new Logger({
-                level: options?.diagnostic ? "debug" : "silent",
-                sink: options?.diagnostic,
+                level: options.diagnostic ? "debug" : "silent",
+                sink: options.diagnostic,
             }, "client");
         this.transportLogger = this.logger.child("transport");
         this.packLogger = this.logger.child("pack");
@@ -204,10 +203,10 @@ export class RemoteGit {
         if (options.filter !== undefined && filter === undefined) {
             this.logger.info(`server does not advertise object filters; fetching without ${options.filter}`);
         }
-        const objects = await this.fetchObjects([commitSha.value], depth, filter, options.parseFull === true);
-        if (objects.isErr())
-            return fail(objects.error);
-        const object = requiredObject(objects.value, commitSha.value);
+        const fetched = await this.fetchObjects([commitSha.value], depth, filter, options.parseScope ?? "target");
+        if (fetched.isErr())
+            return fail(fetched.error);
+        const object = await this.requiredObject(commitSha.value);
         if (object.isErr())
             return fail(object.error);
         if (object.value.type !== "commit") {
@@ -228,10 +227,10 @@ export class RemoteGit {
         const profile = this.profile ? Result.ok(this.profile) : await this.discover();
         if (profile.isErr())
             return fail(profile.error);
-        const objects = await this.fetchObjects([sha]);
-        if (objects.isErr())
-            return fail(objects.error);
-        const object = requiredObject(objects.value, sha);
+        const fetched = await this.fetchObjects([sha]);
+        if (fetched.isErr())
+            return fail(fetched.error);
+        const object = await this.requiredObject(sha);
         if (object.isErr())
             return fail(object.error);
         if (object.value.type !== "blob") {
@@ -247,30 +246,25 @@ export class RemoteGit {
     /**
      * Fetch the commit at `ref` *and* its root tree from a single snapshot pack.
      *
-     * Forces `parseFull: true` so the tree object — which the commit references
-     * but doesn't `want` directly — ends up in the local object store. Useful
-     * for "list files at HEAD" without a clone.
+     * Uses tree retention so the tree object — which the commit references but
+     * doesn't `want` directly — ends up in the local object store without blobs.
      */
     async fetchTreeForCommit(ref, options = {}) {
-        const commit = await this.fetchCommit(ref, { ...options, parseFull: true });
+        const commit = await this.fetchCommit(ref, { ...options, parseScope: "trees" });
         if (commit.isErr())
             return fail(commit.error);
-        const treeObject = this.objects.get(commit.value.commit.tree);
-        if (!treeObject) {
-            return fail(new ObjectNotFoundError({
-                sha: commit.value.commit.tree,
-                message: `tree ${commit.value.commit.tree} not present in snapshot pack`,
-            }));
-        }
-        if (treeObject.type !== "tree") {
+        const treeObject = await this.requiredObject(commit.value.commit.tree);
+        if (treeObject.isErr())
+            return fail(treeObject.error);
+        if (treeObject.value.type !== "tree") {
             return fail(new ObjectDecodeError({
                 reason: "unexpected-object-type",
                 message: `object is not a tree: ${commit.value.commit.tree}`,
-                objectType: treeObject.type,
+                objectType: treeObject.value.type,
                 sha: commit.value.commit.tree,
             }));
         }
-        const entries = parseTree(treeObject.content);
+        const entries = parseTree(treeObject.value.content);
         if (entries.isErr())
             return fail(entries.error);
         return Result.ok({
@@ -284,10 +278,10 @@ export class RemoteGit {
         const profile = this.profile ? Result.ok(this.profile) : await this.discover();
         if (profile.isErr())
             return fail(profile.error);
-        const objects = await this.fetchObjects([sha]);
-        if (objects.isErr())
-            return fail(objects.error);
-        const object = requiredObject(objects.value, sha);
+        const fetched = await this.fetchObjects([sha]);
+        if (fetched.isErr())
+            return fail(fetched.error);
+        const object = await this.requiredObject(sha);
         if (object.isErr())
             return fail(object.error);
         if (object.value.type !== "tree") {
@@ -304,39 +298,71 @@ export class RemoteGit {
         return Result.ok(tree.value);
     }
     /** Look up an already-materialized object by sha. Does not fetch on miss. */
-    getObject(sha) {
-        return this.objects.get(sha);
+    async getObject(sha) {
+        const object = await this.store.read(sha);
+        return object.isOk() ? object.value : undefined;
     }
-    async fetchObjects(wants, depth, filterSpec, parseFull = false) {
-        const normalized = this.normalizeWants(wants, depth, filterSpec);
-        if (normalized.length === 0) {
-            return Result.ok(this.objects);
-        }
+    async requiredObject(sha) {
+        const object = await this.store.read(sha);
+        if (object.isErr())
+            return fail(object.error);
+        return object;
+    }
+    async fetchObjects(wants, depth, filterSpec, parseScope = "target") {
+        const normalized = await this.normalizeWants(wants, depth, filterSpec);
+        if (normalized.length === 0)
+            return Result.ok(0);
         this.logger.debug(`fetchObjects wants=${normalized.length} depth=${depth ?? "-"} filter=${filterSpec ?? "-"}`);
         const pack = await this.fetchPack(normalized, depth, filterSpec);
         if (pack.isErr())
             return fail(pack.error);
         const parseStart = performance.now();
-        const targets = !parseFull && normalized.length === 1 ? new Set(normalized) : undefined;
-        const parsed = parsePackfile(pack.value, targets);
+        const targets = parseScope === "target" && normalized.length === 1
+            ? new Set(normalized)
+            : undefined;
+        const retainTypes = parseScope === "trees" ? TREE_RETAIN_TYPES : undefined;
+        const parsed = await this.parsePackFile(pack.value, { targets, retainTypes }, (sha, object) => {
+            const written = this.store.writeSync(object.type, object.content);
+            if (written.isErr()) {
+                return Result.err(new PackParseError({
+                    reason: "store-write-failed",
+                    message: `failed to write object ${sha}`,
+                    cause: written.error,
+                }));
+            }
+            return Result.ok(undefined);
+        });
         const parseMs = performance.now() - parseStart;
         if (parsed.isErr())
             return fail(parsed.error);
-        const counts = countByType(parsed.value);
+        const counts = parsed.value.stats.byType;
         this.packLogger.recordPack({
             bytes: pack.value.length,
             durationMs: parseMs,
             byType: counts,
         });
-        this.packLogger.debug(`parsed ${parsed.value.size} objects (${counts.commit}c/${counts.tree}t/${counts.blob}b/${counts.tag}T) in ${parseMs.toFixed(1)}ms`);
-        for (const [sha, object] of parsed.value) {
-            this.objects.set(sha, object);
-        }
+        this.packLogger.debug(`parsed ${parsed.value.stats.materialized} objects, retained ${parsed.value.stats.retained} (${counts.commit}c/${counts.tree}t/${counts.blob}b/${counts.tag}T) in ${parseMs.toFixed(1)}ms`);
         if (depth === 1 && filterSpec === undefined) {
             for (const sha of normalized)
-                this.snapshotCommits.add(sha);
+                await this.store.markSnapshot(sha);
+        }
+        return Result.ok(parsed.value.stats.retained);
+    }
+    async parsePackFile(pack, options, sink) {
+        try {
+            const packBytes = new Uint8Array(await readFile(pack.path));
+            return parsePackfile(packBytes, options, sink);
+        }
+        catch (cause) {
+            return fail(new PackParseError({
+                reason: "pack-read-failed",
+                message: `failed to read pack file: ${pack.path}`,
+                cause,
+            }));
+        }
+        finally {
+            await removeIfExists(pack.path);
         }
-        return Result.ok(this.objects);
     }
     async probeFilter(profile, sha, verbose) {
         const caps = buildCaps({ shallow: true, filter: true });
@@ -346,13 +372,13 @@ export class RemoteGit {
                 this.log(`filter blob:none probe failed: ${blobNonePack.error}`);
         }
         else {
-            const parsed = parsePackfile(blobNonePack.value);
+            const parsed = await this.parsePackFile(blobNonePack.value);
             if (parsed.isErr()) {
                 if (verbose)
                     this.log(`filter blob:none probe failed: ${parsed.error}`);
             }
             else {
-                const counts = countByType(parsed.value);
+                const counts = parsed.value.stats.byType;
                 if (verbose)
                     this.log(`filter blob:none probe: ${counts.tree} trees, ${counts.blob} blobs`);
                 profile.supportsFilterBlobNone = counts.blob === 0 ||
@@ -365,13 +391,13 @@ export class RemoteGit {
                 this.log(`filter tree:0 probe failed: ${tree0Pack.error}`);
         }
         else {
-            const parsed = parsePackfile(tree0Pack.value);
+            const parsed = await this.parsePackFile(tree0Pack.value);
             if (parsed.isErr()) {
                 if (verbose)
                     this.log(`filter tree:0 probe failed: ${parsed.error}`);
             }
             else {
-                const counts = countByType(parsed.value);
+                const counts = parsed.value.stats.byType;
                 profile.supportsFilterTree0 = counts.tree === 0;
             }
         }
@@ -391,23 +417,30 @@ export class RemoteGit {
         });
         if (body.isErr())
             return fail(body.error);
-        const response = await postUploadPack(this.url, body.value, {
+        const rawPath = this.store.incomingPath(".raw");
+        const packPath = this.store.incomingPath(".pack");
+        const response = await postUploadPack(this.url, body.value, rawPath, {
             protocolVersion,
             logger: this.transportLogger,
         });
         if (response.isErr())
             return fail(response.error);
-        const pack = extractPack(response.value.body, this.diagnostic);
-        if (pack.isErr())
+        const pack = await extractPackToFile(response.value.path, packPath, this.diagnostic);
+        await removeIfExists(response.value.path);
+        if (pack.isErr()) {
+            await removeIfExists(packPath);
             return fail(pack.error);
-        this.packLogger.debug(`extracted pack: ${pack.value.length}B`);
-        return Result.ok(pack.value);
+        }
+        this.packLogger.debug(`extracted pack: ${pack.value}B`);
+        return Result.ok({ path: packPath, length: pack.value });
     }
-    normalizeWants(wants, depth, filterSpec) {
+    async normalizeWants(wants, depth, filterSpec) {
         if (depth === 1 && filterSpec === undefined) {
-            return wants.every((want) => this.snapshotCommits.has(want)) ? [] : wants;
+            const present = await Promise.all(wants.map((want) => this.store.hasSnapshot(want)));
+            return present.every(Boolean) ? [] : wants;
         }
-        return wants.filter((want) => !this.objects.has(want));
+        const present = await Promise.all(wants.map((want) => this.store.has(want)));
+        return wants.filter((_, index) => !present[index]);
     }
     pickProbeSha(profile) {
         for (const ref of ["HEAD", "refs/heads/main", "refs/heads/master"]) {
@@ -424,16 +457,7 @@ export class RemoteGit {
         this.diagnostic?.(message);
     }
 }
-function requiredObject(objects, sha) {
-    const object = objects.get(sha);
-    if (!object) {
-        return fail(new ObjectNotFoundError({ sha, message: `object not found: ${sha}` }));
-    }
-    return Result.ok(object);
-}
-function countByType(objects) {
-    const counts = { commit: 0, tree: 0, blob: 0, tag: 0 };
-    for (const obj of objects.values())
-        counts[obj.type]++;
-    return counts;
+async function removeIfExists(path) {
+    await rm(path, { force: true });
 }
+//# sourceMappingURL=client.js.map