@mokly/mokly 0.8.0

package/dist/review/component_result_sources.js

@@ -0,0 +1,94 @@
+import { variantAddress } from "./component_pairing.js";
+import { generatedViews } from "../components/views.js";
+import { affectedConsumers } from "./component_affected.js";
+import { address, entryPairs, metadata } from "./component_metadata.js";
+import { snapshotPath } from "./paths.js";
+import { requireEqual, reviewInvalid } from "./result_helpers.js";
+import { parseReviewResult } from "./result_validation.js";
+/** Validate result coverage, addresses, data, dependency and usage references against both manifests. */
+export function validateComponentReviewSources(result, before, after, implementationImpact) {
+    parseReviewResult(result);
+    const pairs = entryPairs(before, after);
+    const expectedScreens = pairs.filter((pair) => (pair.after ?? pair.before).kind === "screen");
+    const expectedComponents = pairs.filter((pair) => (pair.after ?? pair.before).kind === "component");
+    if (expectedScreens.length !== result.screens.length ||
+        expectedComponents.length !== result.components.length)
+        reviewInvalid("source/result coverage differs");
+    for (const pair of pairs) {
+        const entry = (pair.after ?? pair.before);
+        const sides = {
+            ...(pair.before ? { before: address(pair.before) } : {}),
+            ...(pair.after ? { after: address(pair.after) } : {}),
+        };
+        const record = entry.kind === "screen"
+            ? result.screens.find((screen) => screen.route === entry.route)
+            : entry.kind === "component"
+                ? result.components.find((component) => component.id === entry.id)
+                : undefined;
+        if (entry.kind !== "use-case" && !record)
+            reviewInvalid("source entry has no result");
+        if (record)
+            requireEqual({ before: record.before, after: record.after }, sides);
+        const change = result.changes.find((change) => change.kind === entry.kind &&
+            (change.after ?? change.before).route === entry.route);
+        if (change) {
+            requireEqual({ before: change.before, after: change.after }, sides);
+            for (const reason of change.reasons) {
+                if (reason.kind === "metadata" &&
+                    (!pair.before ||
+                        !pair.after ||
+                        metadata(pair.before, before) === metadata(pair.after, after)))
+                    reviewInvalid("metadata reason has no source difference");
+                if (reason.kind === "screen" &&
+                    ![pair.before, pair.after].some((candidate, index) => candidate?.kind === "use-case" &&
+                        candidate.steps.some((step) => (index === 0 ? before : after).entries.some((screen) => screen.kind === "screen" &&
+                            screen.id === step.screenId &&
+                            screen.route === reason.route))))
+                    reviewInvalid("use case does not use the changed screen");
+            }
+        }
+        if (!record)
+            continue;
+        const baseViews = pair.before ? generatedViews(pair.before) : [];
+        const headViews = pair.after ? generatedViews(pair.after) : [];
+        if ("views" in record)
+            validateViews(record.views, baseViews, headViews);
+        else {
+            const baseVariants = pair.before?.kind === "component" ? pair.before.variants : [];
+            const headVariants = pair.after?.kind === "component" ? pair.after.variants : [];
+            const ids = [
+                ...new Set([
+                    ...headVariants.map((variant) => variant.id),
+                    ...baseVariants.map((variant) => variant.id),
+                ]),
+            ];
+            requireEqual(record.variants.map((variant) => variant.id), ids);
+            for (const variant of record.variants) {
+                const base = baseVariants.find((candidate) => candidate.id === variant.id);
+                const head = headVariants.find((candidate) => candidate.id === variant.id);
+                requireEqual({ before: variant.before, after: variant.after }, {
+                    before: base ? variantAddress(base) : undefined,
+                    after: head ? variantAddress(head) : undefined,
+                });
+                validateViews(variant.views, baseViews.filter((view) => view.variantId === variant.id), headViews.filter((view) => view.variantId === variant.id));
+            }
+        }
+    }
+    requireEqual(result.affectedConsumers, affectedConsumers(before, after, implementationImpact));
+}
+function validateViews(views, before, after) {
+    const key = (view) => `${view.viewport}:${view.colorScheme}`;
+    const bases = new Map(before.map((view) => [key(view), view.path]));
+    const heads = new Map(after.map((view) => [key(view), view.path]));
+    if (views.length !== new Set([...bases.keys(), ...heads.keys()]).size)
+        reviewInvalid("view union is incomplete");
+    for (const view of views) {
+        const base = bases.get(key(view));
+        const head = heads.get(key(view));
+        requireEqual({ beforePath: view.beforePath, afterPath: view.afterPath }, {
+            beforePath: base ? snapshotPath("before", base) : undefined,
+            afterPath: head ? snapshotPath("after", head) : undefined,
+        });
+    }
+}
+//# sourceMappingURL=component_result_sources.js.map

package/dist/review/component_result_sources.js.map

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

package/dist/review/component_types.d.ts

@@ -0,0 +1,78 @@
+import type { ColorScheme, Viewport } from "../authoring/types.js";
+import type { ManifestComponentVariant } from "../components/manifest_types.js";
+import type { ReviewResultV2, ReviewState, ScreenReview, ViewReview } from "./types.js";
+export interface ReviewEntryAddress {
+    id: string;
+    route: string;
+    title: string;
+}
+export interface ReviewEntrySides {
+    before?: ReviewEntryAddress;
+    after?: ReviewEntryAddress;
+}
+export interface ScreenReviewV3 extends ScreenReview, ReviewEntrySides {
+}
+export type ReviewVariantAddress = Pick<ManifestComponentVariant, "id" | "title" | "description" | "props" | "suppliedSlots">;
+export interface ComponentVariantReview {
+    id: string;
+    title: string;
+    before?: ReviewVariantAddress;
+    after?: ReviewVariantAddress;
+    state: ReviewState;
+    views: readonly ViewReview[];
+}
+export interface ComponentReview extends Omit<ScreenReview, "views">, ReviewEntrySides {
+    variants: readonly ComponentVariantReview[];
+}
+export type EntryChangeReason = {
+    kind: "added" | "removed" | "metadata" | "material" | "inputs" | "structure";
+} | {
+    kind: "dependency";
+    path: string;
+} | {
+    kind: "screen";
+    route: string;
+};
+export interface ChangedEntry extends ReviewEntrySides {
+    kind: "screen" | "component" | "use-case";
+    reasons: readonly EntryChangeReason[];
+}
+export type ComponentUsageContext = {
+    kind: "screen";
+    entry: ReviewEntryAddress;
+    viewport: Viewport;
+    colorScheme: ColorScheme;
+} | {
+    kind: "component";
+    entry: ReviewEntryAddress;
+    variantId: string;
+    viewport: Viewport;
+    colorScheme: ColorScheme;
+};
+export interface AffectedUsageEvidence {
+    side: "before" | "after";
+    context: ComponentUsageContext;
+    via: readonly {
+        componentId: string;
+        instanceKey: string;
+    }[];
+}
+export interface AffectedConsumer {
+    changedComponentId: string;
+    consumer: {
+        kind: "screen";
+        route: string;
+    } | {
+        kind: "component";
+        id: string;
+    };
+    evidence: readonly AffectedUsageEvidence[];
+}
+export interface ReviewResultV3 extends Omit<ReviewResultV2, "schemaVersion" | "screens"> {
+    schemaVersion: 3;
+    screens: readonly ScreenReviewV3[];
+    components: readonly ComponentReview[];
+    changes: readonly ChangedEntry[];
+    affectedConsumers: readonly AffectedConsumer[];
+}
+//# sourceMappingURL=component_types.d.ts.map

package/dist/review/component_types.d.ts.map

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

package/dist/review/component_types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=component_types.js.map

package/dist/review/component_types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component_types.js","sourceRoot":"","sources":["../../src/review/component_types.ts"],"names":[],"mappings":""}

package/dist/review/component_view.d.ts

@@ -0,0 +1,20 @@
+import type { GeneratedComponentView } from "../components/views.js";
+import type { EntryChangeReason } from "./component_types.js";
+import type { ViewReview } from "./types.js";
+import type { ComponentDependencyPolicy } from "./component_metadata.js";
+import type { ComponentMaterialReader } from "./component_resources.js";
+export interface ComparedComponentView {
+    view: ViewReview;
+    reasons: readonly EntryChangeReason[];
+    changedImplementations: ReadonlySet<string>;
+}
+export interface ComponentViewContext {
+    beforeReader: ComponentMaterialReader;
+    afterReader: ComponentMaterialReader;
+    dependencies: ComponentDependencyPolicy;
+    changed: ReadonlySet<string>;
+    prefix: string;
+}
+/** Compare material and declared inputs without altering the retained view documents. */
+export declare function compareComponentView(context: ComponentViewContext, before: GeneratedComponentView | undefined, after: GeneratedComponentView | undefined, root?: string): Promise<ComparedComponentView>;
+//# sourceMappingURL=component_view.d.ts.map

package/dist/review/component_view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component_view.d.ts","sourceRoot":"","sources":["../../src/review/component_view.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAMrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG7C,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACzE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAExE,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACtC,sBAAsB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC7C;AACD,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,uBAAuB,CAAC;IACtC,WAAW,EAAE,uBAAuB,CAAC;IACrC,YAAY,EAAE,yBAAyB,CAAC;IACxC,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;CAChB;AACD,yFAAyF;AACzF,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,sBAAsB,GAAG,SAAS,EAC1C,KAAK,EAAE,sBAAsB,GAAG,SAAS,EACzC,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,qBAAqB,CAAC,CAmHhC"}

package/dist/review/component_view.js

@@ -0,0 +1,76 @@
+import { stripHistoricalMarkers, stripMarkers, } from "../components/comparison_material.js";
+import { validateComponentRanges } from "../components/ranges.js";
+import { changedComponentImplementations, projectComponentPair, } from "../components/comparison_projection.js";
+import { normalizeReviewPair, normalizeSingleDocument } from "./ignore.js";
+import { snapshotPath } from "./paths.js";
+/** Compare material and declared inputs without altering the retained view documents. */
+export async function compareComponentView(context, before, after, root) {
+    const selected = after ?? before;
+    if (!selected)
+        throw new Error("Comparison view requires at least one side");
+    const base = before
+        ? await context.beforeReader.text(before.path)
+        : undefined;
+    const head = after ? await context.afterReader.text(after.path) : undefined;
+    const baseRanges = base !== undefined && before?.usage
+        ? validateComponentRanges(base, before.usage.ranges, "historical")
+        : undefined;
+    const headRanges = head !== undefined && after?.usage
+        ? validateComponentRanges(head, after.usage.ranges)
+        : undefined;
+    const view = {
+        viewport: selected.viewport,
+        colorScheme: selected.colorScheme,
+        ignoredIds: [],
+        ...(before ? { beforePath: snapshotPath("before", before.path) } : {}),
+        ...(after ? { afterPath: snapshotPath("after", after.path) } : {}),
+        state: before ? "removed" : "added",
+    };
+    if (base === undefined || head === undefined) {
+        normalizeSingleDocument(base !== undefined
+            ? stripHistoricalMarkers(base)
+            : stripMarkers(head, after.usage, headRanges), selected.path);
+        return {
+            view,
+            reasons: [{ kind: "material" }],
+            changedImplementations: new Set(),
+        };
+    }
+    const projected = projectComponentPair(base, head, before?.usage, after?.usage, selected.path, root, baseRanges, headRanges);
+    const reasons = [];
+    if (projected.before !== projected.after)
+        reasons.push({ kind: "material" });
+    if (projected.inputs)
+        reasons.push({ kind: "inputs" });
+    if (projected.structure)
+        reasons.push({ kind: "structure" });
+    const repoPath = (path) => context.prefix ? `${context.prefix}/${path}` : path;
+    const excluded = (path) => context.dependencies.suppressResource(repoPath(path), path, projected.pairedComponentIds, before?.usage, after?.usage, root);
+    const baseResources = await context.beforeReader.resources(before.path, projected.before, excluded);
+    const headResources = await context.afterReader.resources(after.path, projected.after, excluded);
+    for (const resource of new Set([...baseResources, ...headResources])) {
+        const path = repoPath(resource);
+        if (context.changed.has(path) && !excluded(resource))
+            reasons.push({ kind: "dependency", path });
+    }
+    const actual = normalizeReviewPair(stripHistoricalMarkers(base), stripMarkers(head, after?.usage, headRanges), selected.path);
+    const actualBefore = await context.beforeReader.resources(before.path, actual.base, () => false);
+    const actualAfter = await context.afterReader.resources(after.path, actual.head, () => false);
+    const actualResourceChange = [
+        ...new Set([...actualBefore, ...actualAfter]),
+    ].some((resource) => context.changed.has(repoPath(resource)));
+    return {
+        changedImplementations: changedComponentImplementations(base, head, before?.usage, after?.usage, baseRanges, headRanges),
+        view: {
+            ...view,
+            ignoredIds: actual.ignoredIds,
+            state: actual.base !== actual.head || actualResourceChange
+                ? "changed"
+                : projected.rawEqual
+                    ? "unchanged"
+                    : "ignored-only",
+        },
+        reasons,
+    };
+}
+//# sourceMappingURL=component_view.js.map

package/dist/review/component_view.js.map

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

package/dist/review/evidence_assets.d.ts

@@ -0,0 +1,17 @@
+import { FileSystemReviewAssetReader, type LocatedReviewAsset, type ReviewAssetReader } from "./assets.js";
+export declare class EvidenceAssetReader extends FileSystemReviewAssetReader {
+    readonly digests: Record<string, string>;
+    readLocated(route: string): Promise<LocatedReviewAsset>;
+}
+/** Bounded capture shared by all reads on a snapshot side, including transitive assets. */
+export declare class SelectedAssetReader implements ReviewAssetReader {
+    private readonly reader;
+    private readonly signal;
+    private readonly digests?;
+    private readonly files;
+    private bytes;
+    constructor(reader: ReviewAssetReader, signal: AbortSignal, digests?: Readonly<Record<string, string>> | undefined);
+    read(route: string): Promise<Uint8Array>;
+    readMany(routes: readonly string[]): Promise<ReadonlyMap<string, Uint8Array>>;
+}
+//# sourceMappingURL=evidence_assets.d.ts.map

package/dist/review/evidence_assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence_assets.d.ts","sourceRoot":"","sources":["../../src/review/evidence_assets.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,2BAA2B,EAC3B,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACvB,MAAM,aAAa,CAAC;AAErB,qBAAa,mBAAoB,SAAQ,2BAA2B;IAClE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAuB;IAEhD,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAUvE;AAED,2FAA2F;AAC3F,qBAAa,mBAAoB,YAAW,iBAAiB;IAIzD,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;IAL3B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiC;IACvD,OAAO,CAAC,KAAK,CAAK;gBAEC,MAAM,EAAE,iBAAiB,EACzB,MAAM,EAAE,WAAW,EACnB,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,YAAA;IAGvD,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAIxC,QAAQ,CACZ,MAAM,EAAE,SAAS,MAAM,EAAE,GACxB,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CAoC5C"}

package/dist/review/evidence_assets.js

@@ -0,0 +1,66 @@
+/** Record the checked bytes so later comparisons cannot silently use edited output. */
+import { createHash } from "node:crypto";
+import { MoklyError } from "../errors.js";
+import { FileSystemReviewAssetReader, } from "./assets.js";
+export class EvidenceAssetReader extends FileSystemReviewAssetReader {
+    digests = Object.create(null);
+    async readLocated(route) {
+        const asset = await super.readLocated(route);
+        if (asset.content !== undefined) {
+            const digest = assetDigest(asset.content);
+            if (this.digests[route] && this.digests[route] !== digest)
+                throw changedAsset(route);
+            this.digests[route] = digest;
+        }
+        return asset;
+    }
+}
+/** Bounded capture shared by all reads on a snapshot side, including transitive assets. */
+export class SelectedAssetReader {
+    reader;
+    signal;
+    digests;
+    files = new Map();
+    bytes = 0;
+    constructor(reader, signal, digests) {
+        this.reader = reader;
+        this.signal = signal;
+        this.digests = digests;
+    }
+    async read(route) {
+        return (await this.readMany([route])).get(route);
+    }
+    async readMany(routes) {
+        this.signal.throwIfAborted();
+        const missing = [...new Set(routes)].filter((route) => !this.files.has(route));
+        const loaded = this.reader.readMany && missing.length
+            ? await this.reader.readMany(missing)
+            : undefined;
+        for (const route of missing) {
+            this.signal.throwIfAborted();
+            const content = loaded
+                ? loaded.get(route)
+                : await this.reader.read(route);
+            if (content === undefined)
+                throw new MoklyError("review-invalid", `Snapshot file is missing: ${route}`);
+            const expected = this.digests && Object.hasOwn(this.digests, route)
+                ? this.digests[route]
+                : undefined;
+            if (expected && assetDigest(content) !== expected)
+                throw changedAsset(route);
+            this.bytes += content.byteLength;
+            if (this.bytes > 64 * 1024 * 1024)
+                throw new MoklyError("review-invalid", "Selected comparison exceeds 64 MiB");
+            this.files.set(route, content);
+        }
+        this.signal.throwIfAborted();
+        return new Map(routes.map((route) => [route, this.files.get(route)]));
+    }
+}
+function assetDigest(content) {
+    return createHash("sha256").update(content).digest("hex");
+}
+function changedAsset(route) {
+    return new MoklyError("review-invalid", `Comparison input changed since the catalogue was checked: ${route}`);
+}
+//# sourceMappingURL=evidence_assets.js.map

package/dist/review/evidence_assets.js.map

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

package/dist/review/git.d.ts

@@ -0,0 +1,49 @@
+/** Repository object classification used before reading Review dependencies. */
+export type GitFileKind = "missing" | "other" | "regular" | "symlink";
+/** A requested Git tree entry, with bytes retained only for regular files. */
+export type GitFile = {
+    readonly bytes: Uint8Array;
+    readonly kind: "regular";
+} | {
+    readonly kind: Exclude<GitFileKind, "regular">;
+};
+/** Git operations required by Review without checking out the branch point. */
+export interface GitClient {
+    changedPaths(commit: string, excludedPaths?: readonly string[]): Promise<readonly string[]>;
+    fileExists(commit: string, repoRelativePath: string): Promise<boolean>;
+    fileKind(commit: string, repoRelativePath: string): Promise<GitFileKind>;
+    readFile(commit: string, repoRelativePath: string): Promise<string>;
+    readFileBytes(commit: string, repoRelativePath: string): Promise<Uint8Array>;
+    readFiles?(commit: string, repoRelativePaths: readonly string[]): Promise<ReadonlyMap<string, GitFile>>;
+    mergeBase(baseReference: string, headReference: string): Promise<string>;
+}
+/** Injected subprocess runner for Git commands. */
+export interface GitCommandRunner {
+    run(arguments_: readonly string[]): Promise<string>;
+    runBytes?(arguments_: readonly string[]): Promise<Uint8Array>;
+    runBytesWithInput?(arguments_: readonly string[], input: Uint8Array): Promise<Uint8Array>;
+}
+/** Operating-system Git subprocess implementation. */
+export declare class NodeGitCommandRunner implements GitCommandRunner {
+    private readonly cwd;
+    private readonly signal?;
+    constructor(cwd: string, signal?: AbortSignal | undefined);
+    run(arguments_: readonly string[]): Promise<string>;
+    runBytes(arguments_: readonly string[]): Promise<Uint8Array>;
+    runBytesWithInput(arguments_: readonly string[], input: Uint8Array): Promise<Uint8Array>;
+}
+/** Git client with typed, contextual command failures. */
+export declare class RepositoryGitClient implements GitClient {
+    private readonly runner;
+    constructor(runner: GitCommandRunner);
+    mergeBase(baseReference: string, headReference: string): Promise<string>;
+    readFile(commit: string, repoRelativePath: string): Promise<string>;
+    fileExists(commit: string, repoRelativePath: string): Promise<boolean>;
+    fileKind(commit: string, repoRelativePath: string): Promise<GitFileKind>;
+    readFileBytes(commit: string, repoRelativePath: string): Promise<Uint8Array>;
+    readFiles(commit: string, repoRelativePaths: readonly string[]): Promise<ReadonlyMap<string, GitFile>>;
+    changedPaths(commit: string, excludedPaths?: readonly string[]): Promise<readonly string[]>;
+    private run;
+    private runBytes;
+}
+//# sourceMappingURL=git.d.ts.map

package/dist/review/git.d.ts.map

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

package/dist/review/git.js

@@ -0,0 +1,142 @@
+import { MoklyError, errorMessage } from "../errors.js";
+import { readGitFiles } from "./git_batch.js";
+import { executeGit } from "./git_process.js";
+/** Operating-system Git subprocess implementation. */
+export class NodeGitCommandRunner {
+    cwd;
+    signal;
+    constructor(cwd, signal) {
+        this.cwd = cwd;
+        this.signal = signal;
+    }
+    async run(arguments_) {
+        return Buffer.from(await this.runBytes(arguments_)).toString("utf8");
+    }
+    runBytes(arguments_) {
+        return executeGit(this.cwd, arguments_, this.signal);
+    }
+    runBytesWithInput(arguments_, input) {
+        return executeGit(this.cwd, arguments_, this.signal, input);
+    }
+}
+/** Git client with typed, contextual command failures. */
+export class RepositoryGitClient {
+    runner;
+    constructor(runner) {
+        this.runner = runner;
+    }
+    async mergeBase(baseReference, headReference) {
+        const output = await this.run(["merge-base", "--", baseReference, headReference], `find merge base of ${baseReference} and ${headReference}`);
+        const commit = output.trim();
+        if (!/^[a-f0-9]{40,64}$/.test(commit)) {
+            throw new MoklyError("git-failed", `Git returned an invalid merge base for ${baseReference} and ${headReference}`);
+        }
+        return commit;
+    }
+    async readFile(commit, repoRelativePath) {
+        assertGitPath(repoRelativePath);
+        return this.run(["show", `${commit}:${repoRelativePath}`], `read ${repoRelativePath} at ${commit}`);
+    }
+    async fileExists(commit, repoRelativePath) {
+        return (await this.fileKind(commit, repoRelativePath)) !== "missing";
+    }
+    async fileKind(commit, repoRelativePath) {
+        assertGitPath(repoRelativePath);
+        const output = await this.run([
+            "ls-tree",
+            "--format=%(objectmode)",
+            commit,
+            "--",
+            `:(literal)${repoRelativePath}`,
+        ], `inspect ${repoRelativePath} at ${commit}`);
+        const modes = output
+            .split("\n")
+            .map((mode) => mode.trim())
+            .filter(Boolean);
+        if (modes.length === 0)
+            return "missing";
+        if (modes.length !== 1) {
+            throw new MoklyError("git-failed", `Git returned multiple entries for ${repoRelativePath}`);
+        }
+        const mode = modes[0] ?? "";
+        if (/^100[0-7]{3}$/.test(mode))
+            return "regular";
+        if (mode === "120000")
+            return "symlink";
+        return "other";
+    }
+    async readFileBytes(commit, repoRelativePath) {
+        assertGitPath(repoRelativePath);
+        return this.runBytes(["show", `${commit}:${repoRelativePath}`], `read ${repoRelativePath} at ${commit}`);
+    }
+    async readFiles(commit, repoRelativePaths) {
+        for (const repoRelativePath of repoRelativePaths) {
+            assertGitPath(repoRelativePath);
+        }
+        if (this.runner.runBytesWithInput) {
+            return readGitFiles(this.runner, commit, repoRelativePaths);
+        }
+        const files = new Map();
+        for (const repoRelativePath of [...new Set(repoRelativePaths)].sort()) {
+            const kind = await this.fileKind(commit, repoRelativePath);
+            files.set(repoRelativePath, kind === "regular"
+                ? {
+                    bytes: await this.readFileBytes(commit, repoRelativePath),
+                    kind,
+                }
+                : { kind });
+        }
+        return files;
+    }
+    async changedPaths(commit, excludedPaths = []) {
+        for (const excluded of excludedPaths)
+            assertGitPath(excluded);
+        const pathspecs = excludedPaths.map((excluded) => `:(exclude,top,literal)${excluded}`);
+        const tracked = await this.run(["diff", "--name-only", commit, "--", ...pathspecs], `diff workspace against ${commit}`);
+        const untracked = await this.run(["ls-files", "--others", "--exclude-standard", "--", ...pathspecs], "list untracked workspace paths");
+        return [
+            ...new Set(`${tracked}\n${untracked}`
+                .split("\n")
+                .map((value) => value.trim())
+                .filter((value) => value.length > 0 &&
+                !excludedPaths.some((excluded) => pathBelongsTo(value, excluded)))),
+        ].sort();
+    }
+    async run(arguments_, context) {
+        try {
+            return await this.runner.run(arguments_);
+        }
+        catch (error) {
+            throw new MoklyError("git-failed", `${context}: ${errorMessage(error)}`, {
+                cause: error,
+            });
+        }
+    }
+    async runBytes(arguments_, context) {
+        try {
+            if (this.runner.runBytes)
+                return await this.runner.runBytes(arguments_);
+            return Buffer.from(await this.runner.run(arguments_), "utf8");
+        }
+        catch (error) {
+            throw new MoklyError("git-failed", `${context}: ${errorMessage(error)}`, {
+                cause: error,
+            });
+        }
+    }
+}
+function pathBelongsTo(candidate, root) {
+    return candidate === root || candidate.startsWith(`${root}/`);
+}
+function assertGitPath(value) {
+    if (value === "" ||
+        value.startsWith("/") ||
+        value.includes("\\") ||
+        value
+            .split("/")
+            .some((part) => part === "" || part === "." || part === "..") ||
+        value.includes(":")) {
+        throw new MoklyError("git-failed", `unsafe Git path: ${value}`);
+    }
+}
+//# sourceMappingURL=git.js.map

package/dist/review/git.js.map

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

package/dist/review/git_batch.d.ts

@@ -0,0 +1,4 @@
+import type { GitCommandRunner, GitFile } from "./git.js";
+/** Read many regular files from one Git tree with bounded batch processes. */
+export declare function readGitFiles(runner: GitCommandRunner, commit: string, repoRelativePaths: readonly string[]): Promise<ReadonlyMap<string, GitFile>>;
+//# sourceMappingURL=git_batch.d.ts.map

package/dist/review/git_batch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git_batch.d.ts","sourceRoot":"","sources":["../../src/review/git_batch.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAe,MAAM,UAAU,CAAC;AAmBvE,8EAA8E;AAC9E,wBAAsB,YAAY,CAChC,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,MAAM,EACd,iBAAiB,EAAE,SAAS,MAAM,EAAE,GACnC,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA6BvC"}