@amalgm/shell 0.1.164-preview.36072132286 → 0.1.164-preview.36809057014

package/dist/git-command.d.ts

@@ -1,8 +1,61 @@
-export declare function runGit(cwd: string, args: readonly string[], input?: Uint8Array): Buffer;
-/** Git grep uses exit 1 to mean a valid search with no matches. */
-export declare function runGitSearch(cwd: string, args: readonly string[]): Buffer;
-/** Stream a potentially large Git result directly to a private destination. */
-export declare function runGitToFile(cwd: string, args: readonly string[], input: Uint8Array, file: string): void;
-export declare function tryGit(cwd: string, args: readonly string[]): Buffer | null;
-export declare const gitText: (cwd: string, args: readonly string[]) => string;
-export declare function tryGitText(cwd: string, args: readonly string[]): string | null;
+/** The one Git installation this process reads through. The launching
+ * environment is not repository ground: no inherited GIT_* variable and no
+ * machine configuration can redirect storage, configuration or the index.
+ * Resolved once, so opening and closing reads always share one invocation,
+ * and its key enters every retained Git observation. */
+export interface GitHost {
+    /** The toolchain's own binary, never a launcher that chooses one per run. */
+    readonly executable: string;
+    readonly version: string;
+    readonly environment: Readonly<NodeJS.ProcessEnv>;
+    /** The toolchain generation: the pinned binary's identity, its version and
+     * the frozen HOME a `~/` include resolves against. */
+    readonly key: string;
+}
+export declare function gitHost(): GitHost;
+/** A retained Git answer is reusable only under the generation that produced
+ * it. A replaced binary retires that generation for the whole process: the
+ * next read resolves the toolchain again, so no later answer carries the old
+ * key. One metadata read, never a hash of the executable. */
+export declare function currentGitHost(): GitHost;
+/** A generation as plain data, so a content thread reads through exactly the
+ * toolchain its dispatcher resolved instead of resolving one of its own. */
+export type GitHostPin = GitHost & {
+    readonly identity: string;
+};
+export declare function gitHostPin(): GitHostPin;
+/** A replaced binary still retires the pinned generation at the next check. */
+export declare function pinGitHost(pin: GitHostPin): void;
+/** A profile adds only the settings it deliberately owns (private storage,
+ * object alternates, locale); the host environment beneath it never changes. */
+export type GitProfile = Readonly<Record<string, string>>;
+/** Which question a Git process answers. Evidence only, never an input. */
+export type GitPurpose = "binding" | "configuration" | "card" | "checkpoint" | "transport" | "apply";
+export interface GitInvocation {
+    /** Bytes, or a stream whose own errors fail the invocation. */
+    readonly input?: Uint8Array | AsyncIterable<Uint8Array>;
+    readonly profile?: GitProfile;
+    readonly purpose?: GitPurpose;
+    /** A re-read that closes a retained observation rather than opening one. */
+    readonly closing?: boolean;
+}
+/** A completed Git process that did not succeed. Exit status and both output
+ * streams are retained so a caller can recognize a documented answer. `code`
+ * names the absence of the directory Git ran in, when it no longer stood once
+ * Git failed: that address emptied, whatever Git or the spawn said about it. */
+export declare class GitFailure extends Error {
+    readonly status: number | null;
+    readonly signal: NodeJS.Signals | null;
+    readonly stdout: Buffer;
+    readonly stderr: Buffer;
+    readonly code?: "ENOENT" | "ENOTDIR" | undefined;
+    constructor(args: readonly string[], status: number | null, signal: NodeJS.Signals | null, stdout: Buffer, stderr: Buffer, cause?: unknown, code?: "ENOENT" | "ENOTDIR" | undefined);
+}
+export declare function runGit(cwd: string, args: readonly string[], invocation?: GitInvocation): Promise<Buffer>;
+/** Only callers whose Git command documents exit 1 as absence/no-match may
+ * use this helper. Other failures always remain failures. */
+export declare function runGitSearch(cwd: string, args: readonly string[], invocation?: GitInvocation): Promise<Buffer>;
+/** Stream a potentially large Git result directly to a private destination.
+ * The descriptor closes only after the writing process has exited. */
+export declare function runGitToFile(cwd: string, args: readonly string[], file: string, invocation?: GitInvocation): Promise<void>;
+export declare const gitText: (cwd: string, args: readonly string[], invocation?: GitInvocation) => Promise<string>;

package/dist/git-command.js

@@ -1,84 +1,238 @@
-import { execFileSync } from "node:child_process";
-import { closeSync, openSync } from "node:fs";
+import { execFileSync, spawn } from "node:child_process";
+import { channel } from "node:diagnostics_channel";
+import { accessSync, closeSync, constants, openSync, realpathSync, statSync } from "node:fs";
+import { delimiter, isAbsolute, join } from "node:path";
+import { pipeline } from "node:stream/promises";
 const MAX_GIT_BUFFER = 512 * 1024 * 1024;
-function explainGitFailure(error, args) {
-    const failure = error;
-    const stderr = failure.stderr?.toString("utf8").trim();
-    failure.message = `git ${args.join(" ")} failed${stderr ? `: ${stderr}` : ""}`;
-    throw failure;
+const DEV_NULL = process.platform === "win32" ? "NUL" : "/dev/null";
+/** Settings every Shell Git invocation owns, whatever else its profile adds. */
+const OWNED = Object.freeze({
+    GIT_TERMINAL_PROMPT: "0",
+    // Internal commands own piped output; a user's interactive pager is not a
+    // repository input and must never start another process here.
+    GIT_PAGER: "cat",
+    // Reader commands must neither weaken required flushes nor refresh indexes.
+    GIT_TEST_FSYNC: "1",
+    GIT_OPTIONAL_LOCKS: "0",
+    // Reading a source repository never fetches from a promisor remote.
+    GIT_NO_LAZY_FETCH: "1",
+    // A repository answer depends only on repository-owned bytes and this Git
+    // installation. System and user configuration, attributes and ignores are
+    // one machine's policy that no other machine sees; they must never enter a
+    // Card, a Checkpoint or an Apply decision.
+    GIT_CONFIG_NOSYSTEM: "1",
+    GIT_CONFIG_SYSTEM: DEV_NULL,
+    GIT_CONFIG_GLOBAL: DEV_NULL,
+    GIT_ATTR_NOSYSTEM: "1",
+    GIT_CONFIG_COUNT: "2",
+    GIT_CONFIG_KEY_0: "core.attributesFile",
+    GIT_CONFIG_VALUE_0: "",
+    GIT_CONFIG_KEY_1: "core.excludesFile",
+    GIT_CONFIG_VALUE_1: "",
+});
+function findExecutable(path) {
+    for (const directory of path.split(delimiter).filter(isAbsolute)) {
+        const candidate = join(directory, process.platform === "win32" ? "git.exe" : "git");
+        try {
+            accessSync(candidate, constants.X_OK);
+            return candidate;
+        }
+        catch { /* keep searching PATH */ }
+    }
+    throw new Error("git executable not found on PATH");
 }
-export function runGit(cwd, args, input) {
+/** A launcher such as the xcode-select shim picks a toolchain afresh on every
+ * run. The toolchain's exec path names the binary it dispatches to; that
+ * binary, not the launcher, is what this process runs and identifies. */
+function pinnedExecutable(launcher, environment) {
     try {
-        return execFileSync("git", [...args], {
-            cwd,
-            input,
-            maxBuffer: MAX_GIT_BUFFER,
-            stdio: ["pipe", "pipe", "pipe"],
-            env: {
-                ...process.env,
-                GIT_TERMINAL_PROMPT: "0",
-                // A machine's Git test setting cannot turn a successful writer flush
-                // into a no-op. Individual commands still select their fsync policy.
-                GIT_TEST_FSYNC: "1",
-                // Background observation must not create the index lock events it is
-                // itself listening for. Git still takes every lock required for a
-                // requested write; this disables only optional side effects such as
-                // refreshing the index during a read.
-                GIT_OPTIONAL_LOCKS: "0",
-            },
-        });
+        const execPath = execFileSync(launcher, ["--exec-path"], { env: environment }).toString("utf8").trim();
+        const binary = realpathSync(join(execPath, process.platform === "win32" ? "git.exe" : "git"));
+        accessSync(binary, constants.X_OK);
+        return binary;
     }
-    catch (error) {
-        explainGitFailure(error, args);
+    catch {
+        return realpathSync(launcher);
     }
 }
-/** Git grep uses exit 1 to mean a valid search with no matches. */
-export function runGitSearch(cwd, args) {
+const identity = (executable) => {
+    const stat = statSync(executable, { bigint: true });
+    return [stat.dev, stat.ino, stat.size, stat.mtimeNs, stat.ctimeNs].join(":");
+};
+/** An environment name as the platform compares it: Windows names are
+ * case-insensitive (`Path` is PATH, `git_dir` is GIT_DIR) once copied out of
+ * process.env into a plain object. */
+const variable = (name) => process.platform === "win32" ? name.toUpperCase() : name;
+let host;
+export function gitHost() {
+    if (host)
+        return host;
+    const environment = Object.freeze({
+        ...Object.fromEntries(Object.entries(process.env).filter(([name]) => !variable(name).startsWith("GIT_"))),
+        ...OWNED,
+    });
+    const path = Object.entries(environment).find(([name]) => variable(name) === "PATH")?.[1];
+    const executable = pinnedExecutable(findExecutable(path ?? ""), environment);
+    const stamp = identity(executable);
+    // Once per generation, before any repository read: the installation is fixed.
+    const version = execFileSync(executable, ["--version"], { env: environment }).toString("utf8").trim();
+    host = Object.freeze({ executable, version, environment, identity: stamp,
+        key: JSON.stringify([executable, stamp, version, environment.HOME ?? null]) });
+    return host;
+}
+/** A retained Git answer is reusable only under the generation that produced
+ * it. A replaced binary retires that generation for the whole process: the
+ * next read resolves the toolchain again, so no later answer carries the old
+ * key. One metadata read, never a hash of the executable. */
+export function currentGitHost() {
     try {
-        return runGit(cwd, args);
+        if (host && identity(host.executable) !== host.identity)
+            host = undefined;
     }
-    catch (error) {
-        const failure = error;
-        if (failure.status === 1)
-            return failure.stdout ?? Buffer.alloc(0);
-        throw error;
+    catch {
+        host = undefined;
     }
+    return gitHost();
 }
-/** Stream a potentially large Git result directly to a private destination. */
-export function runGitToFile(cwd, args, input, file) {
-    const descriptor = openSync(file, "wx", 0o600);
+export function gitHostPin() {
+    currentGitHost();
+    return host;
+}
+/** A replaced binary still retires the pinned generation at the next check. */
+export function pinGitHost(pin) {
+    if (host?.key === pin.key)
+        return;
+    host = Object.freeze({ ...pin, environment: Object.freeze({ ...pin.environment }) });
+}
+/** One event per finished process, published only while someone listens. */
+const gitSpawns = channel("amalgm:git");
+const commandOf = (args) => {
+    for (let index = 0; index < args.length; index++) {
+        if (args[index] === "-c" || args[index] === "-C")
+            index++;
+        else if (!args[index].startsWith("-"))
+            return args[index];
+    }
+    return "";
+};
+/** A completed Git process that did not succeed. Exit status and both output
+ * streams are retained so a caller can recognize a documented answer. `code`
+ * names the absence of the directory Git ran in, when it no longer stood once
+ * Git failed: that address emptied, whatever Git or the spawn said about it. */
+export class GitFailure extends Error {
+    status;
+    signal;
+    stdout;
+    stderr;
+    code;
+    constructor(args, status, signal, stdout, stderr, cause, code) {
+        const detail = stderr.toString("utf8").trim() || (signal ? `signal ${signal}` : cause ? String(cause) : "");
+        super(`git ${args.join(" ")} failed${detail ? `: ${detail}` : ""}`, cause === undefined ? undefined : { cause });
+        this.status = status;
+        this.signal = signal;
+        this.stdout = stdout;
+        this.stderr = stderr;
+        this.code = code;
+        this.name = "GitFailure";
+    }
+}
+/** Why the directory Git ran in no longer stands, if it does not. */
+function absence(cwd) {
     try {
-        execFileSync("git", [...args], {
-            cwd,
-            input,
-            maxBuffer: MAX_GIT_BUFFER,
-            stdio: ["pipe", descriptor, "pipe"],
-            env: {
-                ...process.env,
-                GIT_TERMINAL_PROMPT: "0",
-                GIT_TEST_FSYNC: "1",
-                GIT_OPTIONAL_LOCKS: "0",
-            },
-        });
+        return statSync(cwd).isDirectory() ? undefined : "ENOTDIR";
     }
     catch (error) {
-        explainGitFailure(error, args);
-    }
-    finally {
-        closeSync(descriptor);
+        const code = error.code;
+        return code === "ENOENT" || code === "ENOTDIR" ? code : undefined;
     }
 }
-export function tryGit(cwd, args) {
+/** The one Git runner. The event loop stays free while Git works; the result
+ * resolves only after the process has exited and both pipes have drained. */
+function execute(cwd, args, invocation, stdout) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(gitHost().executable, [...args], {
+            cwd, env: { ...gitHost().environment, ...invocation.profile }, stdio: ["pipe", stdout, "pipe"],
+        });
+        const out = [], err = [];
+        const started = performance.now();
+        let outBytes = 0, errBytes = 0, failure, settled = false;
+        const publish = (exitCode, signal) => {
+            if (gitSpawns.hasSubscribers)
+                gitSpawns.publish({
+                    cwd, purpose: invocation.purpose ?? "unlabelled", closing: invocation.closing === true, command: commandOf(args),
+                    queuedMs: 0, durationMs: performance.now() - started, exitCode, signal, stdoutBytes: outBytes, stderrBytes: errBytes,
+                });
+        };
+        const fail = (error) => { failure ??= error; child.kill(); };
+        child.stdout?.on("data", (chunk) => {
+            outBytes += chunk.length;
+            if (outBytes > MAX_GIT_BUFFER)
+                fail(new RangeError("Git output exceeds its buffer bound"));
+            else
+                out.push(chunk);
+        });
+        child.stderr.on("data", (chunk) => { errBytes += chunk.length; err.push(chunk); });
+        child.once("error", error => {
+            // A process that never started emits no close.
+            if (child.pid === undefined && !settled) {
+                settled = true;
+                publish(null, null);
+                reject(new GitFailure(args, null, null, Buffer.alloc(0), Buffer.alloc(0), error, absence(cwd)));
+            }
+            else
+                fail(error);
+        });
+        // Git may finish without reading all input; its exit status decides.
+        const ignoreEarlyExit = (error) => { if (error.code !== "EPIPE")
+            fail(error); };
+        const { input } = invocation;
+        let fed = Promise.resolve();
+        if (input === undefined || input instanceof Uint8Array) {
+            child.stdin.on("error", ignoreEarlyExit);
+            child.stdin.end(input);
+        }
+        else
+            fed = pipeline(input, child.stdin).catch(ignoreEarlyExit);
+        // Completion is the child's close and the end of its input producer, so
+        // a producer failure is never lost behind an already-resolved result.
+        child.once("close", (status, signal) => void fed.then(() => {
+            if (settled)
+                return;
+            settled = true;
+            publish(status, signal);
+            const output = Buffer.concat(out);
+            if (status === 0 && failure === undefined)
+                resolve(output);
+            else
+                reject(new GitFailure(args, status, signal, output, Buffer.concat(err), failure, absence(cwd)));
+        }));
+    });
+}
+export function runGit(cwd, args, invocation = {}) {
+    return execute(cwd, args, invocation, "pipe");
+}
+/** Only callers whose Git command documents exit 1 as absence/no-match may
+ * use this helper. Other failures always remain failures. */
+export async function runGitSearch(cwd, args, invocation) {
     try {
-        return runGit(cwd, args);
+        return await runGit(cwd, args, invocation);
     }
-    catch {
-        return null;
+    catch (error) {
+        if (error instanceof GitFailure && error.status === 1)
+            return error.stdout;
+        throw error;
     }
 }
-export const gitText = (cwd, args) => runGit(cwd, args).toString("utf8").trim();
-export function tryGitText(cwd, args) {
-    const value = tryGit(cwd, args);
-    return value === null ? null : value.toString("utf8").trim();
+/** Stream a potentially large Git result directly to a private destination.
+ * The descriptor closes only after the writing process has exited. */
+export async function runGitToFile(cwd, args, file, invocation = {}) {
+    const descriptor = openSync(file, "wx", 0o600);
+    try {
+        await execute(cwd, args, invocation, descriptor);
+    }
+    finally {
+        closeSync(descriptor);
+    }
 }
+export const gitText = async (cwd, args, invocation) => (await runGit(cwd, args, invocation)).toString("utf8").trim();
 //# sourceMappingURL=git-command.js.map

package/dist/git-command.js.map

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

package/dist/git-configuration.d.ts

@@ -0,0 +1,40 @@
+import { type RepoRemote } from "@amalgm/live";
+import { type NativeIndexBinding } from "./git-binding.js";
+import type { SourceProof } from "./source-proof.js";
+export declare function configurationRemotes(bytes: Buffer): readonly RepoRemote[];
+/** Every source's witness at observation, and the branch chain's names once
+ * a conditional include makes them an input. */
+export interface GitConfigurationWitness {
+    readonly kind: "git-configuration";
+    readonly sources: readonly (readonly [string, string])[];
+    readonly branch: {
+        readonly gitDir: string;
+        readonly names: string;
+    } | null;
+}
+export declare function judgeGitConfiguration(witness: GitConfigurationWitness): void;
+/** Effective configuration is Git's answer over repository-owned sources
+ * (local, worktree and their includes) plus the host's fixed command scope;
+ * machine configuration is never read. Its semantic witness is that answer;
+ * its physical witnesses are the bytes of every source the answer depends on. */
+export interface GitConfigurationObservation extends SourceProof {
+    /** Equality of original ordered answers and Git host, never a fresh read. */
+    readonly fingerprint: string;
+    has(key: string): boolean;
+    readonly remotes: readonly RepoRemote[];
+    /** Every path the answer depends on, absent include targets included. */
+    readonly sources: readonly string[];
+    /** True when the physical witnesses close every input of this answer, so an
+     * unchanged witness set may stand for a fresh read. */
+    readonly reusable: boolean;
+    /** This stamp is meaningful only on the actual O result proved by its owner.
+     * Routing may compare it but must never establish or refresh it. */
+    stamp(uuid: string, payloadVersion: string, binding: NativeIndexBinding): string;
+}
+export declare function observeGitConfiguration(repository: string): Promise<GitConfigurationObservation>;
+/** Ground a repository reader depends on beyond its checkout: external Git
+ * storage and every configuration source, include targets included, each at
+ * its synchronization address (a source read through a link depends on the
+ * link and its target). A collection requires all of it in its lease before
+ * admitting what it read; sources inside the checkout are already covered. */
+export declare function repositoryFootprint(binding: NativeIndexBinding, configuration: GitConfigurationObservation): string[];