@trebired/git-host 3.0.0 → 3.1.0

package/dist/core/inspection/shared.d.ts

@@ -0,0 +1,18 @@
+import type { GitInspectionEmptyBehavior, GitInspectionProgressEvent, GitInspectionProgressPhase, GitInspectionRef, GitInspectionTarget, GitLinguistProgressEvent, GitRepositoryHandle, GitRepositoryLinguist, MaybePromise } from "../../types.js";
+type InspectionProgressCallback = (event: GitInspectionProgressEvent) => MaybePromise<void>;
+type InspectionProgressReporter = {
+    emit: (phase: GitInspectionProgressPhase, update?: Partial<Omit<GitInspectionProgressEvent, "emitted_at" | "phase" | "repository_id" | "requested_ref">>) => Promise<void>;
+    emitLinguist: (event: GitLinguistProgressEvent) => Promise<void>;
+};
+declare function normalizeInspectionPath(value: unknown): string;
+declare function normalizeInspectionRef(value: unknown): GitInspectionRef;
+declare function isExplicitInspectionRef(ref: GitInspectionRef): boolean;
+declare function resolveEmptyBehavior(value: unknown, explicitRef: boolean): GitInspectionEmptyBehavior;
+declare function inspectionSnapshotRef(target: GitInspectionTarget): string;
+declare function createEmptyLinguistSnapshot(ref: string): GitRepositoryLinguist;
+declare function countTextLines(content: string): number;
+declare function getParentPath(pathInput: string): string | null;
+declare function createInspectionProgressReporter(repository: GitRepositoryHandle, requestedRef: GitInspectionRef, onProgress?: InspectionProgressCallback): InspectionProgressReporter;
+export { countTextLines, createEmptyLinguistSnapshot, createInspectionProgressReporter, getParentPath, inspectionSnapshotRef, isExplicitInspectionRef, normalizeInspectionPath, normalizeInspectionRef, resolveEmptyBehavior, };
+export type { InspectionProgressReporter };
+//# sourceMappingURL=shared.d.ts.map

package/dist/core/inspection/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/core/inspection/shared.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,0BAA0B,EAC1B,0BAA0B,EAC1B,0BAA0B,EAC1B,gBAAgB,EAChB,mBAAmB,EACnB,wBAAwB,EACxB,mBAAmB,EACnB,qBAAqB,EACrB,YAAY,EACb,MAAM,eAAe,CAAC;AAIvB,KAAK,0BAA0B,GAAG,CAAC,KAAK,EAAE,0BAA0B,KAAK,YAAY,CAAC,IAAI,CAAC,CAAC;AAE5F,KAAK,0BAA0B,GAAG;IAChC,IAAI,EAAE,CACJ,KAAK,EAAE,0BAA0B,EACjC,MAAM,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,0BAA0B,EAAE,YAAY,GAAG,OAAO,GAAG,eAAe,GAAG,eAAe,CAAC,CAAC,KAC3G,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,YAAY,EAAE,CAAC,KAAK,EAAE,wBAAwB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAClE,CAAC;AAEF,iBAAS,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAGvD;AAED,iBAAS,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAGhE;AAED,iBAAS,uBAAuB,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAE/D;AAED,iBAAS,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,GAAG,0BAA0B,CAI9F;AAED,iBAAS,qBAAqB,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAGlE;AAED,iBAAS,2BAA2B,CAAC,GAAG,EAAE,MAAM,GAAG,qBAAqB,CAiCvE;AAED,iBAAS,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAG/C;AAED,iBAAS,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMvD;AAED,iBAAS,gCAAgC,CACvC,UAAU,EAAE,mBAAmB,EAC/B,YAAY,EAAE,gBAAgB,EAC9B,UAAU,CAAC,EAAE,0BAA0B,GACtC,0BAA0B,CAwC5B;AAED,OAAO,EACL,cAAc,EACd,2BAA2B,EAC3B,gCAAgC,EAChC,aAAa,EACb,qBAAqB,EACrB,uBAAuB,EACvB,uBAAuB,EACvB,sBAAsB,EACtB,oBAAoB,GACrB,CAAC;AACF,YAAY,EAAE,0BAA0B,EAAE,CAAC"}

package/dist/core/inspection/shared.js

@@ -0,0 +1,112 @@
+import { normalizeRepositoryRelativePath } from "../../utils/paths.js";
+import { text } from "../../utils/text.js";
+function normalizeInspectionPath(value) {
+    const raw = text(value);
+    return raw ? normalizeRepositoryRelativePath(raw) : "";
+}
+function normalizeInspectionRef(value) {
+    const raw = text(value);
+    return raw || "auto";
+}
+function isExplicitInspectionRef(ref) {
+    return text(ref) !== "auto";
+}
+function resolveEmptyBehavior(value, explicitRef) {
+    const normalized = text(value);
+    if (normalized === "error" || normalized === "empty")
+        return normalized;
+    return explicitRef ? "error" : "empty";
+}
+function inspectionSnapshotRef(target) {
+    if (target.state === "resolved")
+        return target.resolved_ref;
+    return target.resolved_ref || (target.requested_ref === "auto" ? "HEAD" : target.requested_ref);
+}
+function createEmptyLinguistSnapshot(ref) {
+    return {
+        commit: "",
+        files: {
+            bytes: 0,
+            count: 0,
+            lines: {
+                content: 0,
+                total: 0,
+            },
+            results: {},
+        },
+        languages: {
+            bytes: 0,
+            count: 0,
+            lines: {
+                content: 0,
+                total: 0,
+            },
+            results: {},
+        },
+        ref,
+        unknown: {
+            bytes: 0,
+            count: 0,
+            extensions: {},
+            filenames: {},
+            lines: {
+                content: 0,
+                total: 0,
+            },
+        },
+    };
+}
+function countTextLines(content) {
+    if (!content)
+        return 0;
+    return content.split(/\r?\n/).length;
+}
+function getParentPath(pathInput) {
+    const normalized = normalizeInspectionPath(pathInput);
+    if (!normalized)
+        return null;
+    const parts = normalized.split("/").filter(Boolean);
+    parts.pop();
+    return parts.length ? parts.join("/") : "";
+}
+function createInspectionProgressReporter(repository, requestedRef, onProgress) {
+    const callback = typeof onProgress === "function" ? onProgress : null;
+    return {
+        async emit(phase, update = {}) {
+            if (!callback)
+                return;
+            await callback({
+                commit: typeof update.commit === "string" ? update.commit : undefined,
+                emitted_at: new Date().toISOString(),
+                error: update.error,
+                message: text(update.message, phase),
+                percent: Number.isFinite(Number(update.percent)) ? Math.max(0, Math.min(100, Number(update.percent) || 0)) : 0,
+                phase,
+                raw_linguist: update.raw_linguist,
+                repository_id: repository.id,
+                requested_ref: requestedRef,
+                resolved_ref: update.resolved_ref === undefined ? undefined : update.resolved_ref,
+                source: update.source,
+            });
+        },
+        async emitLinguist(event) {
+            if (!callback)
+                return;
+            await callback({
+                commit: event.commit,
+                emitted_at: new Date().toISOString(),
+                error: event.error,
+                message: text(event.message, "Running repository linguist analysis."),
+                percent: Number.isFinite(Number(event.percent)) ? Math.max(0, Math.min(100, Number(event.percent) || 0)) : 0,
+                phase: "running_linguist",
+                raw_linguist: event,
+                repository_id: repository.id,
+                requested_ref: requestedRef,
+                resolved_ref: text(event.ref) || undefined,
+                source: "linguist",
+            });
+        },
+    };
+}
+export { countTextLines, createEmptyLinguistSnapshot, createInspectionProgressReporter, getParentPath, inspectionSnapshotRef, isExplicitInspectionRef, normalizeInspectionPath, normalizeInspectionRef, resolveEmptyBehavior, };
+//# sourceMappingURL=shared.js.map

package/dist/core/inspection/shared.js.map

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

package/dist/core/inspection/snapshots.d.ts

@@ -0,0 +1,6 @@
+import type { GitDirectorySnapshot, GitFileSnapshot, GitRepositoryHandle, GitTreeSnapshot, ReadDirectoryOptions, ReadFileOptions, ReadTreeOptions } from "../../types.js";
+declare function readRepositoryTree(repository: GitRepositoryHandle, options?: ReadTreeOptions): Promise<GitTreeSnapshot>;
+declare function readRepositoryDirectory(repository: GitRepositoryHandle, options?: ReadDirectoryOptions): Promise<GitDirectorySnapshot>;
+declare function readRepositoryFile(repository: GitRepositoryHandle, options: ReadFileOptions): Promise<GitFileSnapshot>;
+export { readRepositoryDirectory, readRepositoryFile, readRepositoryTree };
+//# sourceMappingURL=snapshots.d.ts.map

package/dist/core/inspection/snapshots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshots.d.ts","sourceRoot":"","sources":["../../../src/core/inspection/snapshots.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,oBAAoB,EACpB,eAAe,EAGf,mBAAmB,EAGnB,eAAe,EAEf,oBAAoB,EACpB,eAAe,EACf,eAAe,EAChB,MAAM,eAAe,CAAC;AA0FvB,iBAAe,kBAAkB,CAC/B,UAAU,EAAE,mBAAmB,EAC/B,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,eAAe,CAAC,CAwE1B;AAED,iBAAe,uBAAuB,CACpC,UAAU,EAAE,mBAAmB,EAC/B,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,oBAAoB,CAAC,CA4D/B;AAED,iBAAe,kBAAkB,CAC/B,UAAU,EAAE,mBAAmB,EAC/B,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,eAAe,CAAC,CAiG1B;AACD,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/core/inspection/snapshots.js

@@ -0,0 +1,270 @@
+import { GitHostError } from "../../errors.js";
+import { readRepositoryBlob, readRepositoryLinguist, readRepositoryTreeEntries } from "../inspect.js";
+import { resolveTreeEntryIcon } from "../inspect/icon_theme.js";
+import { formatTreeAscii, nestTreeEntries, normalizeDirectoryEntry } from "./tree.js";
+import { countTextLines, createEmptyLinguistSnapshot, createInspectionProgressReporter, getParentPath, inspectionSnapshotRef, normalizeInspectionPath, normalizeInspectionRef, } from "./shared.js";
+import { resolveRepositoryInspectionTarget } from "./target.js";
+async function readLineCountForEntry(repository, ref, entry) {
+    if (entry.kind !== "file")
+        return undefined;
+    const blob = await readRepositoryBlob(repository, {
+        path: entry.path,
+        ref,
+    });
+    if (blob.is_binary || blob.encoding !== "utf8")
+        return undefined;
+    return countTextLines(blob.content);
+}
+async function readEntriesForTarget(repository, target, options) {
+    const path = normalizeInspectionPath(options.path);
+    await options.progress.emit("reading_tree", {
+        commit: target.commit,
+        message: path ? `Reading repository tree at "${path}".` : "Reading repository tree.",
+        percent: 20,
+        resolved_ref: target.resolved_ref,
+        source: "tree",
+    });
+    const rawEntries = await readRepositoryTreeEntries(repository, {
+        path,
+        recursive: options.recursive === true,
+        ref: target.resolved_ref,
+    });
+    if (path && rawEntries.length === 0) {
+        throw new GitHostError("path_not_found", `Path "${path}" does not exist.`, {
+            path,
+            ref: target.resolved_ref,
+            repositoryId: repository.id,
+        });
+    }
+    let linguist = null;
+    if (options.linguist === true) {
+        linguist = await readRepositoryLinguist(repository, {
+            async onProgress(event) {
+                if (typeof options.onLinguistProgress === "function") {
+                    await options.onLinguistProgress(event);
+                }
+                await options.progress.emitLinguist(event);
+            },
+            ref: target.resolved_ref,
+        });
+    }
+    const entries = rawEntries.map((entry) => ({
+        ...entry,
+        ...(options.icons === true ? { icon: resolveTreeEntryIcon(entry) } : {}),
+        ...(options.linguist === true
+            ? {
+                language: linguist && Object.prototype.hasOwnProperty.call(linguist.files.results, entry.path)
+                    ? linguist.files.results[entry.path]
+                    : null,
+            }
+            : {}),
+    }));
+    return { entries, linguist };
+}
+async function readRepositoryTree(repository, options = {}) {
+    const requestedRef = normalizeInspectionRef(options.ref);
+    const progress = createInspectionProgressReporter(repository, requestedRef, options.onProgress);
+    await progress.emit("resolving_ref", {
+        message: "Resolving repository ref.",
+        percent: 5,
+        source: "tree",
+    });
+    const target = await resolveRepositoryInspectionTarget(repository, options);
+    const path = normalizeInspectionPath(options.path);
+    if (target.state === "empty") {
+        const emptyLinguist = options.linguist === true ? createEmptyLinguistSnapshot(inspectionSnapshotRef(target)) : null;
+        const snapshot = {
+            ...(options.ascii === true ? { ascii: "" } : {}),
+            empty: true,
+            entries: [],
+            ...(options.linguist === true ? { linguist: emptyLinguist } : {}),
+            ...(options.nested === true ? { nested: [] } : {}),
+            path,
+            target,
+        };
+        await progress.emit("completed", {
+            message: "Resolved empty repository snapshot.",
+            percent: 100,
+            resolved_ref: target.resolved_ref,
+            source: "tree",
+        });
+        return snapshot;
+    }
+    const { entries, linguist } = await readEntriesForTarget(repository, target, {
+        icons: options.icons,
+        linguist: options.linguist,
+        onLinguistProgress: options.onLinguistProgress,
+        path,
+        progress,
+        recursive: options.recursive,
+    });
+    await progress.emit("enriching", {
+        commit: target.commit,
+        message: "Building tree snapshot.",
+        percent: 90,
+        resolved_ref: target.resolved_ref,
+        source: "tree",
+    });
+    const nested = options.nested === true ? nestTreeEntries(entries) : undefined;
+    const ascii = options.ascii === true ? formatTreeAscii(nested || nestTreeEntries(entries)) : undefined;
+    const snapshot = {
+        ...(ascii !== undefined ? { ascii } : {}),
+        empty: false,
+        entries,
+        ...(options.linguist === true ? { linguist } : {}),
+        ...(nested !== undefined ? { nested } : {}),
+        path,
+        target,
+    };
+    await progress.emit("completed", {
+        commit: target.commit,
+        message: "Completed tree snapshot.",
+        percent: 100,
+        resolved_ref: target.resolved_ref,
+        source: "tree",
+    });
+    return snapshot;
+}
+async function readRepositoryDirectory(repository, options = {}) {
+    const path = normalizeInspectionPath(options.path);
+    const tree = await readRepositoryTree(repository, {
+        icons: options.icons,
+        linguist: options.linguist,
+        onLinguistProgress: options.onLinguistProgress,
+        onProgress: options.onProgress,
+        path,
+        recursive: false,
+        ref: options.ref,
+        ifMissingRef: options.ifMissingRef,
+        ifUnborn: options.ifUnborn,
+    });
+    if (tree.empty) {
+        return {
+            empty: true,
+            entries: [],
+            kind: "dir",
+            parent_path: getParentPath(path),
+            path,
+            target: tree.target,
+        };
+    }
+    const fileEntry = path
+        ? tree.entries.find((entry) => entry.path === path && entry.type === "blob") || null
+        : null;
+    if (fileEntry) {
+        const normalized = normalizeDirectoryEntry(fileEntry);
+        if (options.includeLineCounts === true) {
+            normalized.line_count = await readLineCountForEntry(repository, inspectionSnapshotRef(tree.target), normalized);
+        }
+        return {
+            empty: false,
+            entry: normalized,
+            kind: "file",
+            parent_path: getParentPath(path),
+            path,
+            target: tree.target,
+        };
+    }
+    const entries = tree.entries.map(normalizeDirectoryEntry);
+    if (options.includeLineCounts === true) {
+        await Promise.all(entries.map(async (entry) => {
+            entry.line_count = await readLineCountForEntry(repository, inspectionSnapshotRef(tree.target), entry);
+        }));
+    }
+    return {
+        empty: false,
+        entries,
+        kind: "dir",
+        parent_path: getParentPath(path),
+        path,
+        target: tree.target,
+    };
+}
+async function readRepositoryFile(repository, options) {
+    const filePath = normalizeInspectionPath(options && options.path);
+    if (!filePath) {
+        throw new TypeError("readFile() requires a repository-relative path.");
+    }
+    const requestedRef = normalizeInspectionRef(options.ref);
+    const progress = createInspectionProgressReporter(repository, requestedRef, options.onProgress);
+    await progress.emit("resolving_ref", {
+        message: "Resolving repository ref.",
+        percent: 5,
+        source: "blob",
+    });
+    const target = await resolveRepositoryInspectionTarget(repository, options);
+    if (target.state === "empty") {
+        await progress.emit("completed", {
+            message: "Resolved empty repository file snapshot.",
+            percent: 100,
+            resolved_ref: target.resolved_ref,
+            source: "blob",
+        });
+        return {
+            blob: null,
+            empty: true,
+            ...(options.includeIcon === true ? { icon: null } : {}),
+            ...(options.includeLanguage === true ? { language: null } : {}),
+            line_count: null,
+            parent_path: getParentPath(filePath),
+            path: filePath,
+            target,
+            text: null,
+        };
+    }
+    await progress.emit("reading_blob", {
+        commit: target.commit,
+        message: `Reading repository file "${filePath}".`,
+        percent: 35,
+        resolved_ref: target.resolved_ref,
+        source: "blob",
+    });
+    const blob = await readRepositoryBlob(repository, {
+        path: filePath,
+        ref: target.resolved_ref,
+    });
+    let treeEntry = null;
+    if (options.includeIcon === true || options.includeLanguage === true) {
+        const treeEntries = await readEntriesForTarget(repository, target, {
+            icons: options.includeIcon,
+            linguist: options.includeLanguage,
+            path: filePath,
+            progress,
+            recursive: false,
+        });
+        treeEntry = treeEntries.entries.find((entry) => entry.path === filePath) || null;
+    }
+    await progress.emit("enriching", {
+        commit: target.commit,
+        message: "Building file snapshot.",
+        percent: 90,
+        resolved_ref: target.resolved_ref,
+        source: "blob",
+    });
+    const textContent = blob.is_binary
+        ? null
+        : (blob.encoding === "utf8"
+            ? blob.content
+            : Buffer.from(blob.content, "base64").toString("utf8"));
+    const snapshot = {
+        blob,
+        empty: false,
+        ...(options.includeIcon === true ? { icon: treeEntry ? (treeEntry.icon ?? null) : null } : {}),
+        ...(options.includeLanguage === true ? { language: treeEntry ? (treeEntry.language ?? null) : null } : {}),
+        line_count: textContent == null ? null : countTextLines(textContent),
+        parent_path: getParentPath(filePath),
+        path: filePath,
+        target,
+        text: textContent,
+    };
+    await progress.emit("completed", {
+        commit: target.commit,
+        message: "Completed file snapshot.",
+        percent: 100,
+        resolved_ref: target.resolved_ref,
+        source: "blob",
+    });
+    return snapshot;
+}
+export { readRepositoryDirectory, readRepositoryFile, readRepositoryTree };
+//# sourceMappingURL=snapshots.js.map

package/dist/core/inspection/snapshots.js.map

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

package/dist/core/inspection/target.d.ts

@@ -0,0 +1,4 @@
+import type { GitInspectionTarget, GitRepositoryHandle, ResolveInspectionTargetOptions } from "../../types.js";
+declare function resolveRepositoryInspectionTarget(repository: GitRepositoryHandle, options?: ResolveInspectionTargetOptions): Promise<GitInspectionTarget>;
+export { resolveRepositoryInspectionTarget };
+//# sourceMappingURL=target.d.ts.map

package/dist/core/inspection/target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"target.d.ts","sourceRoot":"","sources":["../../../src/core/inspection/target.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,mBAAmB,EAGnB,mBAAmB,EACnB,8BAA8B,EAC/B,MAAM,eAAe,CAAC;AAqFvB,iBAAe,iCAAiC,CAC9C,UAAU,EAAE,mBAAmB,EAC/B,OAAO,GAAE,8BAAmC,GAC3C,OAAO,CAAC,mBAAmB,CAAC,CA2C9B;AAED,OAAO,EAAE,iCAAiC,EAAE,CAAC"}

package/dist/core/inspection/target.js

@@ -0,0 +1,97 @@
+import { GitHostError } from "../../errors.js";
+import { text } from "../../utils/text.js";
+import { assertRepositoryReady } from "../inspect/helpers.js";
+import { runGit } from "../run_git.js";
+import { inspectionSnapshotRef, isExplicitInspectionRef, normalizeInspectionRef, resolveEmptyBehavior, } from "./shared.js";
+async function tryResolveCommitForRef(repository, ref) {
+    const revision = text(ref);
+    if (!revision)
+        return null;
+    const revisionRes = await runGit(["rev-parse", "--verify", `${revision}^{commit}`], { cwd: repository.path });
+    if (!revisionRes.ok)
+        return null;
+    return {
+        commit: text(revisionRes.stdout),
+        ref: revision,
+    };
+}
+async function hasRepositoryHeadCommit(repository) {
+    const revisionRes = await runGit(["rev-parse", "--verify", "HEAD^{commit}"], { cwd: repository.path });
+    return revisionRes.ok;
+}
+async function readCurrentBranchRef(repository) {
+    const branchRes = await runGit(["symbolic-ref", "--quiet", "--short", "HEAD"], { cwd: repository.path });
+    if (!branchRes.ok)
+        return null;
+    const branch = text(branchRes.stdout);
+    return branch || null;
+}
+function buildResolvedInspectionTarget(requestedRef, resolvedRef, commit, explicitRef) {
+    return {
+        commit,
+        explicit_ref: explicitRef,
+        requested_ref: requestedRef,
+        resolved_ref: resolvedRef,
+        state: "resolved",
+    };
+}
+function buildEmptyInspectionTarget(requestedRef, resolvedRef, reason, explicitRef) {
+    return {
+        explicit_ref: explicitRef,
+        reason,
+        requested_ref: requestedRef,
+        resolved_ref: resolvedRef,
+        state: "empty",
+    };
+}
+function throwInspectionTargetError(repository, target) {
+    if (target.reason === "unborn") {
+        throw new GitHostError("repository_unborn", `Repository "${repository.id}" has no commits yet.`, {
+            reason: target.reason,
+            ref: target.resolved_ref || null,
+            repositoryId: repository.id,
+        });
+    }
+    throw new GitHostError("ref_not_found", `Repository ref "${inspectionSnapshotRef(target)}" does not exist.`, {
+        reason: target.reason,
+        ref: inspectionSnapshotRef(target),
+        repositoryId: repository.id,
+    });
+}
+async function resolveRepositoryInspectionTarget(repository, options = {}) {
+    await assertRepositoryReady(repository);
+    const requestedRef = normalizeInspectionRef(options.ref);
+    const explicitRef = isExplicitInspectionRef(requestedRef);
+    const ifUnborn = resolveEmptyBehavior(options.ifUnborn, explicitRef);
+    const ifMissingRef = resolveEmptyBehavior(options.ifMissingRef, explicitRef);
+    if (explicitRef) {
+        const resolved = await tryResolveCommitForRef(repository, text(requestedRef));
+        if (resolved) {
+            return buildResolvedInspectionTarget(requestedRef, resolved.ref, resolved.commit, true);
+        }
+        const hasHead = await hasRepositoryHeadCommit(repository);
+        const emptyTarget = buildEmptyInspectionTarget(requestedRef, text(requestedRef), hasHead ? "missing_ref" : "unborn", true);
+        if (emptyTarget.reason === "unborn" && ifUnborn === "empty")
+            return emptyTarget;
+        if (emptyTarget.reason === "missing_ref" && ifMissingRef === "empty")
+            return emptyTarget;
+        throwInspectionTargetError(repository, emptyTarget);
+    }
+    const currentBranch = await readCurrentBranchRef(repository);
+    if (currentBranch) {
+        const branchTarget = await tryResolveCommitForRef(repository, currentBranch);
+        if (branchTarget) {
+            return buildResolvedInspectionTarget("auto", branchTarget.ref, branchTarget.commit, false);
+        }
+    }
+    const headTarget = await tryResolveCommitForRef(repository, "HEAD");
+    if (headTarget) {
+        return buildResolvedInspectionTarget("auto", headTarget.ref, headTarget.commit, false);
+    }
+    const emptyTarget = buildEmptyInspectionTarget("auto", currentBranch, "unborn", false);
+    if (ifUnborn === "empty")
+        return emptyTarget;
+    throwInspectionTargetError(repository, emptyTarget);
+}
+export { resolveRepositoryInspectionTarget };
+//# sourceMappingURL=target.js.map

package/dist/core/inspection/target.js.map

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

package/dist/core/inspection/tree.d.ts

@@ -0,0 +1,6 @@
+import type { GitDirectoryEntry, GitTreeEntry, GitTreeNode } from "../../types.js";
+declare function normalizeDirectoryEntry(entry: GitTreeEntry): GitDirectoryEntry;
+declare function nestTreeEntries(entries: GitTreeEntry[]): GitTreeNode[];
+declare function formatTreeAscii(nodes: GitTreeNode[], prefix?: string): string;
+export { formatTreeAscii, nestTreeEntries, normalizeDirectoryEntry, };
+//# sourceMappingURL=tree.d.ts.map

package/dist/core/inspection/tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["../../../src/core/inspection/tree.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,YAAY,EACZ,WAAW,EACZ,MAAM,eAAe,CAAC;AAMvB,iBAAS,uBAAuB,CAAC,KAAK,EAAE,YAAY,GAAG,iBAAiB,CAWvE;AA4DD,iBAAS,eAAe,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,WAAW,EAAE,CAkB/D;AAED,iBAAS,eAAe,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,MAAM,SAAK,GAAG,MAAM,CAalE;AAED,OAAO,EACL,eAAe,EACf,eAAe,EACf,uBAAuB,GACxB,CAAC"}