humanish 0.15.0 → 0.15.2

package/dist/core/git-state.js

@@ -1,9 +1,26 @@
 import { spawn } from "node:child_process";
+import os from "node:os";
+import { inspectVerifiedGitWorkspace } from "./git-workspace.js";
 export const GIT_STATE_SCHEMA = "humanish.git-state.v1";
+const DEFAULT_GIT_COMMAND_TIMEOUT_MS = 15_000;
 export async function captureGitState(cwd, options = {}) {
     const capturedAt = toIsoString(options.capturedAt ?? new Date());
-    const runner = options.runner ?? runGitCommand;
-    const inside = await runner(["rev-parse", "--is-inside-work-tree"], cwd);
+    const inspection = await inspectVerifiedGitWorkspace(cwd);
+    if (inspection.status === "unsafe") {
+        return unavailableState(capturedAt, inspection.note);
+    }
+    if (inspection.status === "missing") {
+        return missingState(capturedAt);
+    }
+    const commandTimeoutMs = normalizeCommandTimeout(options.commandTimeoutMs);
+    const runner = options.runner
+        ? (args, commandCwd) => runGitRunnerWithDeadline(options.runner, args, commandCwd, commandTimeoutMs)
+        : (args) => runGitCommand(args, inspection.workspace, commandTimeoutMs);
+    const commandCwd = inspection.workspace.worktreeRoot;
+    const inside = await runner(["rev-parse", "--is-inside-work-tree"], commandCwd);
+    if (inside.timedOut) {
+        return unavailableState(capturedAt, "Git work-tree detection timed out.");
+    }
     if (inside.exitCode === null) {
         return unavailableState(capturedAt, "Git command could not be started.");
     }
@@ -20,16 +37,39 @@ export async function captureGitState(cwd, options = {}) {
             note: "No git work tree was detected."
         };
     }
-    const statusOutput = await runner(["status", "--porcelain=v1"], cwd);
+    const statusOutput = await runner([
+        "status",
+        "--porcelain=v1",
+        "--untracked-files=all",
+        "--ignore-submodules=all"
+    ], commandCwd);
+    if (statusOutput.timedOut) {
+        return unavailableState(capturedAt, "Git status capture timed out.");
+    }
     if (statusOutput.exitCode === null) {
         return unavailableState(capturedAt, "Git status command could not be started.");
     }
     if (statusOutput.exitCode !== 0) {
         return unavailableState(capturedAt, "Git status could not be captured.");
     }
-    const headOutput = await runner(["rev-parse", "--short=12", "HEAD"], cwd);
+    const headOutput = await runner(["rev-parse", "--short=12", "HEAD"], commandCwd);
+    if (headOutput.timedOut) {
+        return unavailableState(capturedAt, "Git HEAD capture timed out.");
+    }
+    if (headOutput.exitCode === null) {
+        return unavailableState(capturedAt, "Git HEAD command could not be started.");
+    }
     const shortSha = headOutput.exitCode === 0 ? normalizeNullableText(headOutput.stdout) : null;
-    const refState = await captureRefState(runner, cwd, shortSha);
+    const symbolicRef = await runner(["symbolic-ref", "--quiet", "HEAD"], commandCwd);
+    if (symbolicRef.timedOut) {
+        return unavailableState(capturedAt, "Git ref-state capture timed out.");
+    }
+    if (symbolicRef.exitCode === null) {
+        return unavailableState(capturedAt, "Git ref-state command could not be started.");
+    }
+    const refState = symbolicRef.exitCode === 0
+        ? "attached"
+        : shortSha === null ? "unborn" : "detached";
     const changes = summarizePorcelainStatus(statusOutput.stdout);
     const status = changes.total === 0 ? "clean" : "dirty";
     return {
@@ -72,34 +112,62 @@ export function summarizePorcelainStatus(output) {
         total: lines.length
     };
 }
-async function captureRefState(runner, cwd, shortSha) {
-    const symbolicRef = await runner(["symbolic-ref", "--quiet", "HEAD"], cwd);
-    if (symbolicRef.exitCode === 0) {
-        return "attached";
-    }
-    return shortSha === null ? "unborn" : "detached";
-}
-async function runGitCommand(args, cwd) {
+async function runGitCommand(args, workspace, timeoutMs) {
     return await new Promise((resolve) => {
-        const child = spawn("git", args, {
-            cwd,
+        const child = spawn("git", [
+            `--git-dir=${workspace.gitDir}`,
+            `--work-tree=${workspace.worktreeRoot}`,
+            "-c",
+            "core.fsmonitor=false",
+            "-c",
+            "core.untrackedCache=false",
+            "-c",
+            `core.excludesFile=${os.devNull}`,
+            "-c",
+            `core.attributesFile=${os.devNull}`,
+            "-c",
+            "core.alternateRefsCommand=",
+            "-c",
+            "core.alternateRefsPrefixes=",
+            ...workspace.configOverrides.flatMap((override) => ["-c", override]),
+            ...args
+        ], {
+            cwd: workspace.worktreeRoot,
+            env: isolatedGitEnvironment(process.env),
             stdio: ["ignore", "pipe", "pipe"]
         });
         const stdout = [];
         const stderr = [];
+        let settled = false;
+        const finish = (result) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            resolve(result);
+        };
+        const timer = setTimeout(() => {
+            child.kill("SIGKILL");
+            finish({
+                exitCode: null,
+                stdout: stdout.join(""),
+                stderr: "Git command timed out.",
+                timedOut: true
+            });
+        }, timeoutMs);
         child.stdout.setEncoding("utf8");
         child.stderr.setEncoding("utf8");
         child.stdout.on("data", (chunk) => stdout.push(chunk));
         child.stderr.on("data", (chunk) => stderr.push(chunk));
         child.on("error", (error) => {
-            resolve({
+            finish({
                 exitCode: null,
                 stdout: stdout.join(""),
                 stderr: error.message
             });
         });
         child.on("close", (exitCode) => {
-            resolve({
+            finish({
                 exitCode,
                 stdout: stdout.join(""),
                 stderr: stderr.join("")
@@ -107,6 +175,60 @@ async function runGitCommand(args, cwd) {
         });
     });
 }
+async function runGitRunnerWithDeadline(runner, args, cwd, timeoutMs) {
+    return await new Promise((resolve) => {
+        let settled = false;
+        const finish = (result) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            resolve(result);
+        };
+        const timer = setTimeout(() => {
+            finish({
+                exitCode: null,
+                stdout: "",
+                stderr: "Git command timed out.",
+                timedOut: true
+            });
+        }, timeoutMs);
+        void runner(args, cwd).then(finish, (error) => {
+            finish({
+                exitCode: null,
+                stdout: "",
+                stderr: error instanceof Error ? error.message : String(error)
+            });
+        });
+    });
+}
+function isolatedGitEnvironment(source) {
+    const isolated = {};
+    for (const [name, value] of Object.entries(source)) {
+        if (!name.toUpperCase().startsWith("GIT_")) {
+            isolated[name] = value;
+        }
+    }
+    return {
+        ...isolated,
+        GIT_ATTR_NOSYSTEM: "1",
+        GIT_CONFIG_GLOBAL: os.devNull,
+        GIT_CONFIG_NOSYSTEM: "1",
+        GIT_NO_LAZY_FETCH: "1",
+        GIT_NO_REPLACE_OBJECTS: "1",
+        GIT_OPTIONAL_LOCKS: "0",
+        GIT_TERMINAL_PROMPT: "0"
+    };
+}
+function normalizeCommandTimeout(value) {
+    if (value === undefined) {
+        return DEFAULT_GIT_COMMAND_TIMEOUT_MS;
+    }
+    if (!Number.isSafeInteger(value) || value < 1) {
+        throw new Error("Git command timeout must be a positive safe integer.");
+    }
+    return value;
+}
 function unavailableState(capturedAt, note) {
     return {
         schema: GIT_STATE_SCHEMA,
@@ -120,6 +242,19 @@ function unavailableState(capturedAt, note) {
         note
     };
 }
+function missingState(capturedAt) {
+    return {
+        schema: GIT_STATE_SCHEMA,
+        status: "missing",
+        capturedAt,
+        head: {
+            shortSha: null,
+            refState: "unknown"
+        },
+        changes: emptyChanges(),
+        note: "No git work tree was detected."
+    };
+}
 function emptyChanges() {
     return {
         staged: 0,

package/dist/core/git-state.js.map

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

package/dist/core/git-workspace.d.ts

@@ -0,0 +1,31 @@
+export declare const GIT_METADATA_INSPECTION_FAILED_NOTE = "Git metadata could not be inspected safely.";
+export declare const GIT_METADATA_CONTAINMENT_FAILED_NOTE = "Git metadata failed containment validation.";
+export interface VerifiedGitWorkspace {
+    readonly commonDir: string;
+    readonly configOverrides: readonly string[];
+    readonly gitDir: string;
+    readonly kind: "directory" | "linked-worktree";
+    readonly trustRoot: string;
+    readonly worktreeRoot: string;
+}
+export type GitWorkspaceInspection = {
+    readonly status: "missing";
+} | {
+    readonly note: typeof GIT_METADATA_INSPECTION_FAILED_NOTE | typeof GIT_METADATA_CONTAINMENT_FAILED_NOTE;
+    readonly status: "unsafe";
+    readonly worktreeRoot: string;
+} | {
+    readonly status: "verified";
+    readonly workspace: VerifiedGitWorkspace;
+};
+/**
+ * Resolve one physical Git worktree without trusting ambient Git discovery.
+ *
+ * A regular `.git` file is accepted only for Git's exact linked-worktree
+ * topology: `<common>/.git/worktrees/<name>` plus single-link `commondir` and
+ * `gitdir` backpointer files. Arbitrary `gitdir:` redirects (including valid
+ * separate-git-dir repositories) are deliberately unavailable because they
+ * delegate metadata authority outside the selected project without a
+ * verifiable backlink.
+ */
+export declare function inspectVerifiedGitWorkspace(cwdInput: string): Promise<GitWorkspaceInspection>;