@savvy-web/silk 3.4.1 → 3.5.0

package/changesets-markdownlint.js

@@ -1,5 +1,5 @@
 import { builtinModules, createRequire } from "node:module";
-import { Context, Data, Duration, Effect, Equal, Exit, FileSystem, Function, Hash, HashMap, Layer, Option, Order, Path, Pipeable, PlatformError, Predicate, Result, Schema, SchemaIssue, SchemaTransformation, Stream } from "effect";
+import { Context, Data, Duration, Effect, Equal, Exit, FileSystem, Function, Hash, HashMap, Layer, Option, Order, Path, Pipeable, PlatformError, Predicate, Redacted, Ref, Result, Schema, SchemaIssue, SchemaTransformation, Stdio, Stream } from "effect";
 import * as path$1 from "node:path";
 import { basename, delimiter, dirname, isAbsolute, join, normalize, relative, resolve } from "node:path";
 import { ChildProcess, ChildProcessSpawner } from "effect/unstable/process";
@@ -2352,7 +2352,7 @@ var GlobSet = class GlobSet extends Schema.Class("GlobSet")(Schema.Struct({ patt
 };
 
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+lockfiles@0.3.2_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__@effected+npm@0._ff048038a9678f5144f817ad24d8f96e/node_modules/@effected/lockfiles/BunExtension.js
+//#region ../../node_modules/.pnpm/@effected+lockfiles@0.3.2_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__@effected+npm@0._3c1784fba62fde9a5bac4cf15387fd04/node_modules/@effected/lockfiles/BunExtension.js
 /**
 * Extension data specific to bun lockfiles, attached to `Lockfile.extension`
 * when the format is `"bun"`.
@@ -2374,7 +2374,7 @@ var BunExtension = class extends Schema.Class("BunExtension")({
 }) {};
 
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+npm@0.8.2_@effected+semver@0.3.2_effect@4.0.0-beta.101__effect@4.0.0-beta.101/node_modules/@effected/npm/CatalogResolver.js
+//#region ../../node_modules/.pnpm/@effected+npm@0.8.3_@effected+semver@0.3.2_effect@4.0.0-beta.101__effect@4.0.0-beta.101/node_modules/@effected/npm/CatalogResolver.js
 /**
 * Contract for resolving pnpm `catalog:` dependency specifiers to concrete
 * version ranges.
@@ -2421,7 +2421,7 @@ var CatalogResolver = class CatalogResolver extends Context.Service()("@effected
 };
 
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+npm@0.8.2_@effected+semver@0.3.2_effect@4.0.0-beta.101__effect@4.0.0-beta.101/node_modules/@effected/npm/WorkspaceResolver.js
+//#region ../../node_modules/.pnpm/@effected+npm@0.8.3_@effected+semver@0.3.2_effect@4.0.0-beta.101__effect@4.0.0-beta.101/node_modules/@effected/npm/WorkspaceResolver.js
 /**
 * Raised when a `catalog:` or `workspace:` specifier cannot be resolved
 * because the resolution mechanism itself failed — not for an ordinary
@@ -2483,7 +2483,7 @@ var WorkspaceResolver = class WorkspaceResolver extends Context.Service()("@effe
 };
 
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+npm@0.8.2_@effected+semver@0.3.2_effect@4.0.0-beta.101__effect@4.0.0-beta.101/node_modules/@effected/npm/CatalogAssemblyError.js
+//#region ../../node_modules/.pnpm/@effected+npm@0.8.3_@effected+semver@0.3.2_effect@4.0.0-beta.101__effect@4.0.0-beta.101/node_modules/@effected/npm/CatalogAssemblyError.js
 /**
 * Raised when a workspace's catalogs cannot be assembled — a `pnpm-workspace.yaml`
 * that is unreadable or not valid YAML, a root `package.json` `workspaces` field
@@ -2528,7 +2528,7 @@ var CatalogAssemblyError = class extends Schema.TaggedErrorClass()("CatalogAssem
 };
 
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+npm@0.8.2_@effected+semver@0.3.2_effect@4.0.0-beta.101__effect@4.0.0-beta.101/node_modules/@effected/npm/DependencySection.js
+//#region ../../node_modules/.pnpm/@effected+npm@0.8.3_@effected+semver@0.3.2_effect@4.0.0-beta.101__effect@4.0.0-beta.101/node_modules/@effected/npm/DependencySection.js
 /**
 * The short dependency kind: which dependency map an entry came from, named the
 * way consumers branch on it.
@@ -4152,7 +4152,7 @@ const isComparatorSetSubset = (sub, sup) => {
 };
 
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+npm@0.8.2_@effected+semver@0.3.2_effect@4.0.0-beta.101__effect@4.0.0-beta.101/node_modules/@effected/npm/DependencySpecifier.js
+//#region ../../node_modules/.pnpm/@effected+npm@0.8.3_@effected+semver@0.3.2_effect@4.0.0-beta.101__effect@4.0.0-beta.101/node_modules/@effected/npm/DependencySpecifier.js
 /**
 * Indicates that a string could not be parsed as a valid dependency specifier.
 *
@@ -4360,7 +4360,7 @@ const DependencySpecifier = Object.assign(brandedSpecifier, {
 });
 
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+npm@0.8.2_@effected+semver@0.3.2_effect@4.0.0-beta.101__effect@4.0.0-beta.101/node_modules/@effected/npm/IntegrityHash.js
+//#region ../../node_modules/.pnpm/@effected+npm@0.8.3_@effected+semver@0.3.2_effect@4.0.0-beta.101__effect@4.0.0-beta.101/node_modules/@effected/npm/IntegrityHash.js
 const SRI_RE = /^(sha1|sha256|sha384|sha512)-[A-Za-z0-9+/]+={0,2}$/;
 const COREPACK_RE = /^(sha1|sha224|sha256|sha384|sha512)\.[0-9a-f]+$/;
 const YARN_RE = /^[0-9]+(c[0-9]+)?\/[0-9a-f]+$/;
@@ -4466,7 +4466,7 @@ const IntegrityHash = Object.assign(brandedIntegrity, {
 const CorepackIntegrityHash = brandedIntegrity.pipe(Schema.check(Schema.makeFilter((value) => isCorepack(value) ? void 0 : "Expected a corepack (<algo>.<hex>) integrity hash")));
 
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+commands@0.2.1_effect@4.0.0-beta.101/node_modules/@effected/commands/LocalExec.js
+//#region ../../node_modules/.pnpm/@effected+commands@0.3.1_effect@4.0.0-beta.101/node_modules/@effected/commands/LocalExec.js
 /**
 * The package managers whose project-local exec argv this package knows.
 *
@@ -4675,7 +4675,681 @@ var LocalExec = class LocalExec extends Context.Service()("@effected/commands/Lo
 };
 
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+npm@0.8.2_@effected+semver@0.3.2_effect@4.0.0-beta.101__effect@4.0.0-beta.101/node_modules/@effected/npm/ReleaseAgeGate.js
+//#region ../../node_modules/.pnpm/@effected+commands@0.3.1_effect@4.0.0-beta.101/node_modules/@effected/commands/Redaction.js
+/**
+* Argument tokens whose *following* positional (or `=`-joined value) is a
+* secret. Lowercase; matching is case-insensitive.
+*
+* @remarks
+* This is the heuristic backstop, not the primary mechanism — it can only know
+* about flags someone thought to list. The primary mechanism is
+* {@link Redaction.applyArgs}, which redacts by **value**: the caller says what
+* its secrets are and every occurrence goes, whatever flag carried it.
+*
+* @public
+*/
+const SECRET_FLAGS = /* @__PURE__ */ new Set([
+	"--access-token",
+	"--api-key",
+	"--auth",
+	"--auth-token",
+	"--otp",
+	"--password",
+	"--registry-token",
+	"--token"
+]);
+/**
+* npm config keys whose value is a credential (`//registry/:_authToken`,
+* `//registry/:_password`).
+*/
+const AUTH_KEY = /:(?:_authtoken|_password)$/i;
+/**
+* The distinct, non-empty secret values, longest first.
+*
+* @remarks
+* Longest-first is load-bearing: redacting `"ab"` before `"abcd"` rewrites
+* `"abcd"` to `"***cd"`, leaking `"cd"` — a fragment of the longer secret.
+* Empty values are dropped because `"abc".split("").join("***")` would insert
+* the placeholder between every character.
+*/
+const prepare = (secrets) => [...new Set(secrets.map(Redacted.value))].filter((value) => value.length > 0).sort((a, b) => b.length - a.length);
+/** Replaces each prepared value with {@link REDACTED}, literally (never as a pattern). */
+const replaceAll = (text, values) => {
+	let out = text;
+	for (const value of values) out = out.split(value).join("***");
+	return out;
+};
+const apply = (text, secrets) => secrets.length === 0 ? text : replaceAll(text, prepare(secrets));
+const applyArgs = (args, secrets) => {
+	if (secrets.length === 0) return args;
+	const values = prepare(secrets);
+	return args.map((arg) => replaceAll(arg, values));
+};
+/** Whether `name` introduces a credential value. */
+const isSecretName = (name, extra) => {
+	const lower = name.toLowerCase();
+	return SECRET_FLAGS.has(lower) || extra.has(lower) || AUTH_KEY.test(name);
+};
+const scrubArgs = (args, options) => {
+	const extra = new Set((options?.flags ?? []).map((flag) => flag.toLowerCase()));
+	const out = [];
+	for (let index = 0; index < args.length; index++) {
+		const arg = args[index] ?? "";
+		const equals = arg.indexOf("=");
+		if (equals > 0 && isSecretName(arg.slice(0, equals), extra)) {
+			out.push(`${arg.slice(0, equals)}=***`);
+			continue;
+		}
+		out.push(arg);
+		if (isSecretName(arg, extra) && index + 1 < args.length) {
+			out.push("***");
+			index++;
+		}
+	}
+	return out;
+};
+/**
+* Secret scrubbing for command arguments and captured output.
+*
+* @remarks
+* Two mechanisms, deliberately layered. {@link Redaction.apply} and
+* {@link Redaction.applyArgs} redact **by value** — the caller declares its
+* secrets as `Redacted` and every occurrence is removed wherever it appears.
+* {@link Redaction.scrubArgs} is a **flag heuristic** that runs in addition, for
+* the secrets a caller forgot to declare.
+*
+* @public
+*/
+var Redaction = class {
+	constructor() {}
+	/**
+	* Replaces every occurrence of every secret's value in `text` with
+	* {@link REDACTED}.
+	*
+	* @remarks
+	* Exact, literal matching — no pattern compilation, no encoding-aware search. A
+	* secret that reaches the text base64-encoded, URL-encoded, or split across a
+	* line break is **not** found; declare the encoded form as a secret too if that
+	* is a real risk.
+	*
+	* A secret composed only of the placeholder's own characters (`*`, `**`, `***`)
+	* cannot be fully removed, because the replacement reintroduces it. That is a
+	* documented limitation, not a defect.
+	*/
+	static apply = apply;
+	/**
+	* {@link Redaction.apply} over each entry of an argv array. An entry is
+	* redacted whether it *is* a secret or merely *contains* one
+	* (`--url=https://u:s3cr3t@host`).
+	*/
+	static applyArgs = applyArgs;
+	/**
+	* Heuristic backstop: redact any argv value that is introduced by a known
+	* secret-bearing flag or npm auth key, in either the separated
+	* (`--token abc`) or inline (`--token=abc`) form.
+	*
+	* @remarks
+	* This catches secrets the caller forgot to declare; it cannot catch a flag
+	* nobody listed. Prefer {@link Redaction.applyArgs} with the actual
+	* `Redacted` values — this runs *in addition*, never instead.
+	*/
+	static scrubArgs = scrubArgs;
+	/** Flags treated as secret-bearing by {@link Redaction.scrubArgs}. See {@link SECRET_FLAGS}. */
+	static SECRET_FLAGS = SECRET_FLAGS;
+};
+
+//#endregion
+//#region ../../node_modules/.pnpm/@effected+commands@0.3.1_effect@4.0.0-beta.101/node_modules/@effected/commands/internal/capture.js
+/**
+* Raised when a captured stream exceeds its byte budget.
+*
+* @remarks
+* Internal and never exported from the package: `Run` maps it to the public
+* `CommandOutputError`. `Data.TaggedError` is appropriate precisely because it
+* never escapes — it is an in-process signal, not a contract.
+*/
+var OutputTooLarge = class extends Data.TaggedError("OutputTooLarge") {};
+/**
+* Collects a byte stream into a string, failing once more than `limit` bytes
+* have arrived.
+*
+* @remarks
+* The budget is enforced **during** accumulation, not after: checking the
+* length of an already-collected string would mean the memory was already
+* spent, which is the exact failure the budget exists to prevent. Counting is
+* on raw bytes, before decoding, because bytes are what the process actually
+* produced.
+*/
+const collectBounded = (stream, limit) => Effect.gen(function* () {
+	const seen = yield* Ref.make(0);
+	const bounded = Stream.mapEffect(stream, (chunk) => Effect.flatMap(Ref.updateAndGet(seen, (total) => total + chunk.length), (total) => total > limit ? Effect.fail(new OutputTooLarge({ limit })) : Effect.succeed(chunk)));
+	return yield* Stream.mkString(Stream.decodeText(bounded));
+});
+
+//#endregion
+//#region ../../node_modules/.pnpm/@effected+commands@0.3.1_effect@4.0.0-beta.101/node_modules/@effected/commands/Run.js
+/**
+* Default ceiling on captured bytes per stream (16 MiB).
+*
+* @remarks
+* Collecting a child's output without a bound is a memory-exhaustion vector.
+* Output genuinely larger than this belongs on {@link Run.stream}, which never
+* accumulates.
+*
+* @public
+*/
+const DEFAULT_MAX_OUTPUT_BYTES = 16777216;
+/** Characters shown from the tail of captured output in an error message. */
+const MAX_MESSAGE_CHARS = 2e3;
+/**
+* What one completed run produced.
+*
+* @public
+*/
+var CommandOutput = class extends Schema.Class("CommandOutput")({
+	/** Captured standard output, redacted. */
+	stdout: Schema.String,
+	/** Captured standard error, redacted. */
+	stderr: Schema.String,
+	/** The process exit code. A non-zero value is NOT an error at this level. */
+	exitCode: Schema.Number
+}) {
+	/** Whether the process exited zero. */
+	get succeeded() {
+		return this.exitCode === 0;
+	}
+};
+/** The executable and argv an error should report for `command`. */
+const describeCommand = (command) => {
+	if (ChildProcess.isStandardCommand(command)) return {
+		command: command.command,
+		args: command.args
+	};
+	const left = describeCommand(command.left);
+	const right = describeCommand(command.right);
+	return {
+		command: `${left.command} | ${right.command}`,
+		args: []
+	};
+};
+/** argv as an error should store it: declared secrets removed, then the flag heuristic. */
+const safeArgs = (args, secrets) => Redaction.scrubArgs(Redaction.applyArgs(args, secrets ?? []));
+/** Captured text as an error should store it. */
+const safeText = (text, secrets) => Redaction.apply(text, secrets ?? []);
+/** Tail-bounded rendering: tools write warnings first and the real error last. */
+const tail = (text) => {
+	const trimmed = text.trim();
+	if (trimmed.length <= MAX_MESSAGE_CHARS) return trimmed;
+	return `...[${trimmed.length - MAX_MESSAGE_CHARS} chars truncated from head]...\n${trimmed.slice(-2e3)}`;
+};
+/**
+* A command that could not be run, or that ran and failed.
+*
+* @remarks
+* `kind` is the routing surface, never the message: `"nonZero"` (the process
+* ran and exited non-zero), `"spawn"` (it never started — the executable is
+* missing, or the platform refused), `"timeout"` (a caller-supplied ceiling
+* elapsed). Composed retry and fallback logic branches on `kind`; nothing in
+* this package asks a caller to match on prose.
+*
+* `args` is **always** stored redacted.
+*
+* @public
+*/
+var CommandFailedError = class CommandFailedError extends Schema.TaggedErrorClass()("CommandFailedError", {
+	/** Why it failed. */
+	kind: Schema.Literals([
+		"nonZero",
+		"spawn",
+		"timeout"
+	]),
+	/** The executable (or `"a | b"` for a pipeline). */
+	command: Schema.String,
+	/** argv, redacted. */
+	args: Schema.Array(Schema.String),
+	/** The exit code, when the process ran. */
+	exitCode: Schema.optionalKey(Schema.Number),
+	/** Captured standard error, redacted, when the process ran. */
+	stderr: Schema.optionalKey(Schema.String),
+	/** Captured standard output, redacted, when the process ran. */
+	stdout: Schema.optionalKey(Schema.String),
+	/** The absorbed platform failure, for `"spawn"`. */
+	cause: Schema.optionalKey(Schema.Defect())
+}) {
+	/** The process ran and exited non-zero. */
+	static nonZero = (command, output, secrets) => {
+		const described = describeCommand(command);
+		return new CommandFailedError({
+			kind: "nonZero",
+			command: described.command,
+			args: safeArgs(described.args, secrets),
+			exitCode: output.exitCode,
+			stderr: output.stderr,
+			stdout: output.stdout
+		});
+	};
+	/** The process never started. */
+	static spawn = (command, cause, secrets) => {
+		const described = describeCommand(command);
+		return new CommandFailedError({
+			kind: "spawn",
+			command: described.command,
+			args: safeArgs(described.args, secrets),
+			cause
+		});
+	};
+	/** A caller-supplied ceiling elapsed; the child was killed with its scope. */
+	static timedOut = (command, secrets) => {
+		const described = describeCommand(command);
+		return new CommandFailedError({
+			kind: "timeout",
+			command: described.command,
+			args: safeArgs(described.args, secrets)
+		});
+	};
+	/**
+	* Whether this is a spawn failure caused by the executable not existing —
+	* the structural "tool is not installed" signal.
+	*/
+	get notFound() {
+		return this.kind === "spawn" && this.cause instanceof PlatformError.PlatformError && this.cause.reason._tag === "NotFound";
+	}
+	/** Names the command and surfaces the tail of whichever stream carries the cause. */
+	get message() {
+		const parts = [`Command "${this.args.length > 0 ? `${this.command} ${this.args.join(" ")}` : this.command}" failed`];
+		if (this.kind === "timeout") parts.push("(timed out)");
+		if (this.exitCode !== void 0) parts.push(`(exit ${this.exitCode})`);
+		const stream = this.stderr?.trim() ? this.stderr : this.stdout?.trim() ? this.stdout : void 0;
+		if (stream !== void 0) parts.push(`:\n${tail(stream)}`);
+		return parts.join(" ");
+	}
+};
+/**
+* A command ran, but its output could not be used.
+*
+* @remarks
+* Separate from {@link CommandFailedError} because the process itself
+* succeeded: `"notJson"` (stdout is not JSON), `"schema"` (it is JSON but does
+* not decode), `"tooLarge"` (capture exceeded its byte budget). Keeping the two
+* distinguishable is the point — a schema drift and a crashed tool call for
+* different responses.
+*
+* The context fields (`exitCode`, `stderr`, `stdout`) are populated by
+* {@link Run.jsonLine}, whose payload framing parses regardless of exit code —
+* when no payload arrives, the exit code and captured streams are the only
+* evidence of what actually went wrong. Both streams are **always** stored
+* redacted.
+*
+* @public
+*/
+var CommandOutputError = class extends Schema.TaggedErrorClass()("CommandOutputError", {
+	/** Which way the output was unusable. */
+	kind: Schema.Literals([
+		"notJson",
+		"schema",
+		"tooLarge"
+	]),
+	/** The executable that produced it. */
+	command: Schema.String,
+	/** The underlying parse or decode failure. */
+	cause: Schema.optionalKey(Schema.Defect()),
+	/** The exit code, when the combinator parses independently of it. */
+	exitCode: Schema.optionalKey(Schema.Number),
+	/** Captured standard error, redacted, when the process ran. */
+	stderr: Schema.optionalKey(Schema.String),
+	/** Captured standard output, redacted, when the process ran. */
+	stdout: Schema.optionalKey(Schema.String)
+}) {
+	get message() {
+		const parts = [];
+		if (this.kind === "notJson") parts.push(`Command "${this.command}" did not produce JSON`);
+		else if (this.kind === "schema") parts.push(`Command "${this.command}" produced JSON that did not match the expected schema`);
+		else parts.push(`Command "${this.command}" produced more output than the configured limit`);
+		if (this.exitCode !== void 0) parts.push(`(exit ${this.exitCode})`);
+		if (this.stderr !== void 0 && this.stderr.trim().length > 0) parts.push(`:\n${tail(this.stderr)}`);
+		return parts.join(" ");
+	}
+};
+/** Spawns, collects both streams concurrently, and awaits exit. */
+const collectRaw = (command, options, tee) => Effect.scoped(Effect.gen(function* () {
+	const handle = yield* (yield* ChildProcessSpawner.ChildProcessSpawner).spawn(command);
+	const limit = options?.maxOutputBytes ?? 16777216;
+	const out = tee === void 0 ? handle.stdout : Stream.tapSink(handle.stdout, tee.stdout());
+	const err = tee === void 0 ? handle.stderr : Stream.tapSink(handle.stderr, tee.stderr());
+	const [stdout, stderr, exitCode] = yield* Effect.all([
+		collectBounded(out, limit),
+		collectBounded(err, limit),
+		handle.exitCode
+	], { concurrency: "unbounded" });
+	const secrets = options?.redact;
+	return CommandOutput.make({
+		stdout: safeText(stdout, secrets),
+		stderr: safeText(stderr, secrets),
+		exitCode: Number(exitCode)
+	});
+}));
+/** Maps the raw failure modes onto this package's taxonomy, and applies any ceiling. */
+const collectClassified = (command, options, tee) => {
+	const described = describeCommand(command);
+	const classified = collectRaw(command, options, tee).pipe(Effect.catch((error) => Effect.fail(error instanceof OutputTooLarge ? new CommandOutputError({
+		kind: "tooLarge",
+		command: described.command,
+		cause: error
+	}) : CommandFailedError.spawn(command, error, options?.redact))));
+	return options?.timeout === void 0 ? classified : Effect.timeoutOrElse(classified, {
+		duration: options.timeout,
+		orElse: () => Effect.fail(CommandFailedError.timedOut(command, options.redact))
+	});
+};
+/** Fails a run whose process exited non-zero. */
+const requireZero = (command, output, options) => output.succeeded ? Effect.succeed(output) : Effect.fail(CommandFailedError.nonZero(command, output, options?.redact));
+/** Span attributes: what ran and how many arguments — never the arguments. */
+const annotate = (command) => {
+	const described = describeCommand(command);
+	return Effect.annotateCurrentSpan({
+		command: described.command,
+		argc: described.args.length
+	});
+};
+const collect = Effect.fn("Run.collect")(function* (command, options) {
+	yield* annotate(command);
+	return yield* collectClassified(command, options, void 0);
+});
+const collectTee = Effect.fn("Run.collectTee")(function* (command, options) {
+	yield* annotate(command);
+	const stdio = yield* Stdio.Stdio;
+	return yield* collectClassified(command, options, stdio);
+});
+const text$4 = Effect.fn("Run.text")(function* (command, options) {
+	yield* annotate(command);
+	const output = yield* collectClassified(command, options, void 0);
+	return (yield* requireZero(command, output, options)).stdout.trim();
+});
+const lines = Effect.fn("Run.lines")(function* (command, options) {
+	yield* annotate(command);
+	const output = yield* collectClassified(command, options, void 0);
+	return (yield* requireZero(command, output, options)).stdout.split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0);
+});
+const json = Effect.fn("Run.json")(function* (command, schema, options) {
+	yield* annotate(command);
+	const described = describeCommand(command);
+	const output = yield* collectClassified(command, options, void 0);
+	const checked = yield* requireZero(command, output, options);
+	const parsed = yield* Effect.try({
+		try: () => JSON.parse(checked.stdout),
+		catch: (cause) => new CommandOutputError({
+			kind: "notJson",
+			command: described.command,
+			cause
+		})
+	});
+	return yield* Schema.decodeUnknownEffect(schema)(parsed).pipe(Effect.catch((cause) => Effect.fail(new CommandOutputError({
+		kind: "schema",
+		command: described.command,
+		cause
+	}))));
+});
+const jsonLine = Effect.fn("Run.jsonLine")(function* (command, schema, options) {
+	yield* annotate(command);
+	const described = describeCommand(command);
+	const output = yield* collectClassified(command, options, void 0);
+	const context = {
+		exitCode: output.exitCode,
+		stderr: output.stderr,
+		stdout: output.stdout
+	};
+	const candidates = output.stdout.split(/\r?\n/).filter((candidate) => candidate.trim().length > 0);
+	if (candidates.length === 0) return yield* Effect.fail(new CommandOutputError({
+		kind: "notJson",
+		command: described.command,
+		cause: /* @__PURE__ */ new Error("stdout carried no non-empty line"),
+		...context
+	}));
+	let notJsonCause;
+	let schemaCause;
+	for (let index = candidates.length - 1; index >= 0; index--) {
+		const candidate = candidates[index];
+		if (candidate === void 0) continue;
+		let parsed;
+		try {
+			parsed = JSON.parse(candidate);
+		} catch (cause) {
+			notJsonCause ??= cause;
+			continue;
+		}
+		const decoded = yield* Effect.result(Schema.decodeUnknownEffect(schema)(parsed));
+		if (Result.isSuccess(decoded)) return decoded.success;
+		schemaCause ??= decoded.failure;
+	}
+	return yield* Effect.fail(schemaCause !== void 0 ? new CommandOutputError({
+		kind: "schema",
+		command: described.command,
+		cause: schemaCause,
+		...context
+	}) : new CommandOutputError({
+		kind: "notJson",
+		command: described.command,
+		cause: notJsonCause,
+		...context
+	}));
+});
+const exitCode = Effect.fn("Run.exitCode")(function* (command, options) {
+	yield* annotate(command);
+	return (yield* collectClassified(command, options, void 0)).exitCode;
+});
+const succeeds = Effect.fn("Run.succeeds")(function* (command, options) {
+	yield* annotate(command);
+	return yield* collectClassified(command, options, void 0).pipe(Effect.map((output) => output.succeeded), Effect.catch(() => Effect.succeed(false)));
+});
+const detach = Effect.fn("Run.detach")(function* (command) {
+	yield* annotate(command);
+	return yield* Effect.scoped(Effect.gen(function* () {
+		const handle = yield* (yield* ChildProcessSpawner.ChildProcessSpawner).spawn(command);
+		yield* handle.unref;
+		return handle.pid;
+	})).pipe(Effect.catch((error) => Effect.fail(CommandFailedError.spawn(command, error))));
+});
+const stream = (command, options) => Stream.unwrap(Effect.map(ChildProcessSpawner.ChildProcessSpawner, (spawner) => spawner.streamLines(command, { includeStderr: options?.includeStderr ?? false }))).pipe(Stream.mapError((error) => CommandFailedError.spawn(command, error)));
+const extendEnv = Function.dual(2, (self, env) => {
+	if (ChildProcess.isStandardCommand(self)) {
+		const merged = self.options.env === void 0 ? env : {
+			...self.options.env,
+			...env
+		};
+		return ChildProcess.make(self.command, self.args, {
+			...self.options,
+			env: merged,
+			extendEnv: true
+		});
+	}
+	return ChildProcess.pipeTo(extendEnv(self.left, env), extendEnv(self.right, env), self.options);
+});
+/**
+* Structured running of core `ChildProcess.Command` values.
+*
+* @remarks
+* These are free functions over core's contract, **not** a service: core's
+* `ChildProcessSpawner` already is the subprocess service, and wrapping it in a
+* second one is the re-declaration this package exists not to repeat. Tests
+* stub the spawner (`ChildProcessSpawner.make(mockSpawn)`), not these.
+*
+* A non-zero exit is a *result* for {@link Run.collect}, {@link Run.exitCode},
+* {@link Run.succeeds} and {@link Run.jsonLine}, and a typed *failure* for
+* {@link Run.text}, {@link Run.lines} and {@link Run.json} — the split is
+* deliberate, matching core (where a non-zero exit is a success) at the
+* reporting level while giving the interpreting helpers the ergonomics callers
+* actually want.
+*
+* The interpreting helpers also **trim**: {@link Run.text} strips leading and
+* trailing whitespace from the whole result — not just a trailing newline —
+* and {@link Run.lines} trims each line. Fixed-column output whose first
+* column can be whitespace (`git status --porcelain`) silently loses that
+* column through either, producing plausible wrong values rather than an
+* error. Parse that kind of output from the untrimmed `stdout` of
+* {@link Run.collect}'s {@link CommandOutput} instead.
+*
+* @public
+*/
+var Run = class {
+	constructor() {}
+	/**
+	* Spawns `command`, collects stdout and stderr concurrently, and resolves
+	* with the {@link CommandOutput} once the process exits.
+	*
+	* @remarks
+	* A non-zero exit is a *result* here, not a failure — see {@link Run}'s
+	* remarks for the split against {@link Run.text}, {@link Run.lines} and
+	* {@link Run.json}.
+	*/
+	static collect = collect;
+	/**
+	* Like {@link Run.collect}, but also tees each stream to the `Stdio` in `R`
+	* as it arrives, for a caller that wants live output alongside the captured
+	* {@link CommandOutput}.
+	*/
+	static collectTee = collectTee;
+	/**
+	* Runs `command` and resolves with trimmed stdout on a zero exit.
+	*
+	* @remarks
+	* A non-zero exit is a typed failure here — {@link CommandFailedError} —
+	* unlike {@link Run.collect}, {@link Run.exitCode} and {@link Run.succeeds},
+	* which treat it as a result.
+	*
+	* The trim strips **leading and trailing whitespace**, not just the trailing
+	* newline. For parse-sensitive output where leading whitespace is data
+	* (`git status --porcelain`, whose first entry's status column it would
+	* silently eat), use {@link Run.collect} and read its {@link CommandOutput}'s
+	* untrimmed `stdout` instead.
+	*/
+	static text = text$4;
+	/**
+	* Runs `command` and resolves with stdout split into trimmed, non-empty
+	* lines on a zero exit.
+	*
+	* @remarks
+	* A non-zero exit is a typed failure here — {@link CommandFailedError} —
+	* matching {@link Run.text} and {@link Run.json}.
+	*/
+	static lines = lines;
+	/**
+	* Runs `command`, parses stdout as JSON and decodes it against `schema` on
+	* a zero exit.
+	*
+	* @remarks
+	* Fails with {@link CommandOutputError} when stdout is not JSON or does not
+	* decode; a non-zero exit fails with {@link CommandFailedError}, matching
+	* {@link Run.text} and {@link Run.lines}.
+	*
+	* This parses the **whole** of stdout and requires a zero exit. For a
+	* protocol payload located by scanning stdout lines from the end — tolerant
+	* of noise around it and of a non-zero exit — use {@link Run.jsonLine}
+	* instead.
+	*/
+	static json = json;
+	/**
+	* Runs `command` and, **scanning stdout lines from the end**, resolves with
+	* the first line that both parses as JSON and decodes against `schema` —
+	* the framing variant of {@link Run.json}, for a child that reports through
+	* a single JSON protocol payload near the end of its output.
+	*
+	* @remarks
+	* The framing tolerates noise on **both sides** of the payload: noise before
+	* it (a subprocess-loaded hook's own `console.log`, a tool's warnings) and
+	* noise after it (a hook logging from `process.on("exit", ...)` fires after
+	* the payload has flushed — the trigger for widening the old "last non-empty
+	* line must decode" contract, spencerbeggs/effected#292). Lines are split on
+	* `\r?\n`, whitespace-only lines are dropped, and the scan runs from the last
+	* line backwards until one decodes. The tolerance is positional, not
+	* volumetric: the whole of stdout is still captured under
+	* {@link RunOptions.maxOutputBytes} (default
+	* {@link DEFAULT_MAX_OUTPUT_BYTES}, 16 MiB), so a child whose noise exceeds
+	* the ceiling fails typed as `"tooLarge"` before any line is examined —
+	* raise the ceiling for a child known to be loud in volume.
+	*
+	* The scan's consequence: when **multiple** lines decode under `schema`, the
+	* **last** one wins. A child must therefore never emit two schema-valid
+	* lines, and a consumer schema should be shaped so an accidental log line
+	* cannot satisfy it — a discriminated envelope with a required literal field
+	* (`ok: true | false`, the shape `@effected/workspaces`' `ReplayPayload`
+	* uses) rather than a permissive record a stray `console.log(someObject)`
+	* might match.
+	*
+	* Unlike {@link Run.json}, this parses **regardless of the exit code** — a
+	* deliberate posture, not an oversight. A protocol payload discriminates
+	* success in-band (its own `ok` field, its own error shape), so the payload
+	* outranks the exit code: a child that crashes *after* flushing its payload
+	* still reported, and a caller that wants exit-code semantics has
+	* {@link Run.json}. When no line decodes anywhere, the typed
+	* {@link CommandOutputError} carries the exit code and both captured streams
+	* (redacted) as context, so the failure is diagnosable without re-running.
+	* Its `kind` preserves the near-miss diagnostic: `"schema"` when at least
+	* one line parsed as JSON but none decoded — with the **last parseable
+	* line's** decode failure as `cause`, that line being the most probable
+	* intended payload — and `"notJson"` only when no non-empty line was JSON at
+	* all (carrying the last non-empty line's parse error). A spawn failure or
+	* an opted-in timeout still fails with {@link CommandFailedError}.
+	*/
+	static jsonLine = jsonLine;
+	/**
+	* Runs `command` and resolves with its exit code alone.
+	*
+	* @remarks
+	* A non-zero exit is a *result* here, not a failure — see {@link Run}'s
+	* remarks for the split against {@link Run.text}, {@link Run.lines} and
+	* {@link Run.json}.
+	*/
+	static exitCode = exitCode;
+	/**
+	* Runs `command` and resolves with whether it exited zero, collapsing a
+	* spawn or other classified failure to `false` rather than propagating it.
+	*/
+	static succeeds = succeeds;
+	/** Decoded stdout lines as they arrive, for output too large or too long-lived to collect. */
+	static stream = stream;
+	/**
+	* Spawns `command` and resolves with its pid without waiting for exit.
+	*
+	* @remarks
+	* Unrefs the child **before** this scope closes, so it survives the
+	* caller's scope closing — the Node backend's release skips the kill for an
+	* unref'd child, and reversing that order kills it with the scope instead.
+	* Fails with {@link CommandFailedError} if the process never starts.
+	*/
+	static detach = detach;
+	/**
+	* Adds environment variables to a command WITHOUT losing the parent
+	* environment: merges `env` over any existing command environment (new values
+	* win, matching core's `ChildProcess.setEnv`) and sets `extendEnv: true`.
+	*
+	* @remarks
+	* This combinator exists because of a core trap: `ChildProcess.setEnv` merges
+	* into `options.env` but never sets `extendEnv`, and the Node spawner resolves
+	* the child environment as `extendEnv ? { ...process.env, ...env } : env` — so
+	* a command built with bare `setEnv({ SOME_VAR: x })` spawns a child whose
+	* ENTIRE environment is that one variable: no `PATH`, no `HOME`. The failure is
+	* silent at the type level and surfaces as "spawned tool cannot find its own
+	* binary" at runtime.
+	*
+	* Deliberately forces `extendEnv: true` even where construction set it `false`
+	* — inheriting the parent environment is this combinator's entire purpose. A
+	* caller who wants a hermetic environment uses core's `setEnv` or construction
+	* options (`ChildProcess.make(cmd, args, { env, extendEnv: false })`) directly.
+	*
+	* For a pipeline, applies to every command in the pipeline (mirroring core's
+	* `setEnv`), preserving the pipe's own options. Composes core's public
+	* vocabulary (`ChildProcess.make`, `ChildProcess.pipeTo`) — it re-declares
+	* nothing.
+	*/
+	static extendEnv = extendEnv;
+	/** Default ceiling on captured bytes per stream. See {@link DEFAULT_MAX_OUTPUT_BYTES}. */
+	static DEFAULT_MAX_OUTPUT_BYTES = DEFAULT_MAX_OUTPUT_BYTES;
+	/** The placeholder written in place of a redacted secret. See {@link REDACTED}. */
+	static REDACTED = "***";
+};
+
+//#endregion
+//#region ../../node_modules/.pnpm/@effected+npm@0.8.3_@effected+semver@0.3.2_effect@4.0.0-beta.101__effect@4.0.0-beta.101/node_modules/@effected/npm/ReleaseAgeGate.js
 const MS_PER_MINUTE = 6e4;
 /**
 * A source's partial contribution to a {@link ReleaseAgeGate}: the effective
@@ -4846,7 +5520,7 @@ var ReleaseAgeGate = class ReleaseAgeGate extends Schema.Class("ReleaseAgeGate")
 };
 
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+lockfiles@0.3.2_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__@effected+npm@0._ff048038a9678f5144f817ad24d8f96e/node_modules/@effected/lockfiles/ImporterDependency.js
+//#region ../../node_modules/.pnpm/@effected+lockfiles@0.3.2_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__@effected+npm@0._3c1784fba62fde9a5bac4cf15387fd04/node_modules/@effected/lockfiles/ImporterDependency.js
 /**
 * One declared dependency of one workspace importer, as the lockfile records it.
 *
@@ -4885,7 +5559,7 @@ var ImporterDependency = class extends Schema.Class("ImporterDependency")({
 }) {};
 
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+lockfiles@0.3.2_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__@effected+npm@0._ff048038a9678f5144f817ad24d8f96e/node_modules/@effected/lockfiles/LockfileImporter.js
+//#region ../../node_modules/.pnpm/@effected+lockfiles@0.3.2_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__@effected+npm@0._3c1784fba62fde9a5bac4cf15387fd04/node_modules/@effected/lockfiles/LockfileImporter.js
 /**
 * One workspace importer's declared dependencies, as the lockfile records them.
 *
@@ -4910,7 +5584,7 @@ var LockfileImporter = class extends Schema.Class("LockfileImporter")({
 }) {};
 
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+lockfiles@0.3.2_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__@effected+npm@0._ff048038a9678f5144f817ad24d8f96e/node_modules/@effected/lockfiles/ResolvedPackage.js
+//#region ../../node_modules/.pnpm/@effected+lockfiles@0.3.2_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__@effected+npm@0._3c1784fba62fde9a5bac4cf15387fd04/node_modules/@effected/lockfiles/ResolvedPackage.js
 const EMPTY_DEPENDENCIES = {};
 /**
 * A package resolved from a lockfile.
@@ -4946,7 +5620,7 @@ var ResolvedPackage = class extends Schema.Class("ResolvedPackage")({
 }) {};
 
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+lockfiles@0.3.2_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__@effected+npm@0._ff048038a9678f5144f817ad24d8f96e/node_modules/@effected/lockfiles/WorkspaceDependency.js
+//#region ../../node_modules/.pnpm/@effected+lockfiles@0.3.2_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__@effected+npm@0._3c1784fba62fde9a5bac4cf15387fd04/node_modules/@effected/lockfiles/WorkspaceDependency.js
 /**
 * A directed dependency edge between two workspace packages as recorded in
 * the lockfile.
@@ -4969,7 +5643,7 @@ var WorkspaceDependency = class extends Schema.Class("WorkspaceDependency")({
 }) {};
 
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+lockfiles@0.3.2_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__@effected+npm@0._ff048038a9678f5144f817ad24d8f96e/node_modules/@effected/lockfiles/PnpmExtension.js
+//#region ../../node_modules/.pnpm/@effected+lockfiles@0.3.2_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__@effected+npm@0._3c1784fba62fde9a5bac4cf15387fd04/node_modules/@effected/lockfiles/PnpmExtension.js
 /**
 * Extension data specific to pnpm lockfiles, attached to `Lockfile.extension`
 * when the format is `"pnpm"`.
@@ -4995,7 +5669,7 @@ var PnpmExtension = class extends Schema.Class("PnpmExtension")({
 }) {};
 
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+lockfiles@0.3.2_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__@effected+npm@0._ff048038a9678f5144f817ad24d8f96e/node_modules/@effected/lockfiles/LockfileFormat.js
+//#region ../../node_modules/.pnpm/@effected+lockfiles@0.3.2_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__@effected+npm@0._3c1784fba62fde9a5bac4cf15387fd04/node_modules/@effected/lockfiles/LockfileFormat.js
 /**
 * The lockfile formats this package parses: bun's `bun.lock` (JSONC), npm's
 * `package-lock.json` (v2/v3 JSON), pnpm's `pnpm-lock.yaml` and yarn Berry's
@@ -5034,7 +5708,7 @@ const FILENAMES = {
 const filenameFor = (format) => FILENAMES[format][0];
 
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+lockfiles@0.3.2_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__@effected+npm@0._ff048038a9678f5144f817ad24d8f96e/node_modules/@effected/lockfiles/internal/shared.js
+//#region ../../node_modules/.pnpm/@effected+lockfiles@0.3.2_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__@effected+npm@0._3c1784fba62fde9a5bac4cf15387fd04/node_modules/@effected/lockfiles/internal/shared.js
 /**
 * The four dependency sections of a manifest, in a stable order — the shared
 * dependency-sections table (v3's `DEP_SECTIONS`). Each entry is both the
@@ -7006,7 +7680,7 @@ var JsoncModifier = class {
 };
 
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+lockfiles@0.3.2_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__@effected+npm@0._ff048038a9678f5144f817ad24d8f96e/node_modules/@effected/lockfiles/internal/bun.js
+//#region ../../node_modules/.pnpm/@effected+lockfiles@0.3.2_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__@effected+npm@0._3c1784fba62fde9a5bac4cf15387fd04/node_modules/@effected/lockfiles/internal/bun.js
 const DepRecord$2 = Schema.optionalKey(Schema.Record(Schema.String, Schema.String));
 const BunWorkspaceEntry = Schema.Struct({
 	name: Schema.optionalKey(Schema.String),
@@ -7100,7 +7774,7 @@ const toFields$3 = (raw) => Effect.gen(function* () {
 });
 
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+lockfiles@0.3.2_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__@effected+npm@0._ff048038a9678f5144f817ad24d8f96e/node_modules/@effected/lockfiles/internal/npm.js
+//#region ../../node_modules/.pnpm/@effected+lockfiles@0.3.2_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__@effected+npm@0._3c1784fba62fde9a5bac4cf15387fd04/node_modules/@effected/lockfiles/internal/npm.js
 const DepRecord$1 = Schema.optionalKey(Schema.Record(Schema.String, Schema.String));
 const NpmPackageEntry = Schema.Struct({
 	name: Schema.optionalKey(Schema.String),
@@ -14128,7 +14802,7 @@ function deepEqualValues(a, b) {
 }
 
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+lockfiles@0.3.2_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__@effected+npm@0._ff048038a9678f5144f817ad24d8f96e/node_modules/@effected/lockfiles/internal/documents.js
+//#region ../../node_modules/.pnpm/@effected+lockfiles@0.3.2_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__@effected+npm@0._3c1784fba62fde9a5bac4cf15387fd04/node_modules/@effected/lockfiles/internal/documents.js
 /**
 * An empty YAML document composes to `null` (`Yaml.parseAll("")` is `[null]`,
 * and the trailing document of an env-only `pnpm-lock.yaml` is `null` too).
@@ -14199,7 +14873,7 @@ const selectSoleDocument = (content) => Effect.gen(function* () {
 });
 
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+lockfiles@0.3.2_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__@effected+npm@0._ff048038a9678f5144f817ad24d8f96e/node_modules/@effected/lockfiles/internal/pnpm.js
+//#region ../../node_modules/.pnpm/@effected+lockfiles@0.3.2_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__@effected+npm@0._3c1784fba62fde9a5bac4cf15387fd04/node_modules/@effected/lockfiles/internal/pnpm.js
 const PnpmImporterDeps = Schema.optionalKey(Schema.Record(Schema.String, Schema.Struct({
 	specifier: Schema.String,
 	version: Schema.String
@@ -14325,7 +14999,7 @@ const toFields$1 = (raw) => Effect.gen(function* () {
 });
 
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+lockfiles@0.3.2_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__@effected+npm@0._ff048038a9678f5144f817ad24d8f96e/node_modules/@effected/lockfiles/internal/yarn.js
+//#region ../../node_modules/.pnpm/@effected+lockfiles@0.3.2_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__@effected+npm@0._3c1784fba62fde9a5bac4cf15387fd04/node_modules/@effected/lockfiles/internal/yarn.js
 const YarnLockfileRaw = Schema.Record(Schema.String, Schema.Unknown);
 const DepRecord = Schema.optionalKey(Schema.Record(Schema.String, Schema.String));
 const YarnEntry = Schema.Struct({
@@ -14449,7 +15123,7 @@ const cleanYarnDeps = (deps) => {
 };
 
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+lockfiles@0.3.2_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__@effected+npm@0._ff048038a9678f5144f817ad24d8f96e/node_modules/@effected/lockfiles/Lockfile.js
+//#region ../../node_modules/.pnpm/@effected+lockfiles@0.3.2_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__@effected+npm@0._3c1784fba62fde9a5bac4cf15387fd04/node_modules/@effected/lockfiles/Lockfile.js
 const EMPTY_IMPORTERS = [];
 /**
 * Failure of `Lockfile.parse`: the given content is not a valid lockfile of
@@ -14694,7 +15368,7 @@ var Lockfile = class Lockfile extends Schema.Class("Lockfile")({
 };
 
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+lockfiles@0.3.2_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__@effected+npm@0._ff048038a9678f5144f817ad24d8f96e/node_modules/@effected/lockfiles/LockfileIntegrity.js
+//#region ../../node_modules/.pnpm/@effected+lockfiles@0.3.2_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__@effected+npm@0._3c1784fba62fde9a5bac4cf15387fd04/node_modules/@effected/lockfiles/LockfileIntegrity.js
 /**
 * The minimal manifest shape {@link LockfileIntegrity.compare} checks a
 * lockfile against: a package name plus the four optional dependency maps.
@@ -17555,7 +18229,7 @@ var Package = class Package extends Schema.Class("Package")({
 };
 
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+workspaces@0.9.5_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__effect@4.0.0-beta.101/node_modules/@effected/workspaces/WorkspacePackage.js
+//#region ../../node_modules/.pnpm/@effected+workspaces@0.10.2_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__@effected+semv_feff9e309e6abeafa28f7ea259b8a9bf/node_modules/@effected/workspaces/WorkspacePackage.js
 const EMPTY$1 = Object.freeze(Object.create(null));
 const EMPTY_MANIFEST = Object.freeze(Object.create(null));
 /**
@@ -18157,7 +18831,7 @@ var Walker$1 = class {
 };
 
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+workspaces@0.9.5_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__effect@4.0.0-beta.101/node_modules/@effected/workspaces/WorkspaceRoot.js
+//#region ../../node_modules/.pnpm/@effected+workspaces@0.10.2_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__@effected+semv_feff9e309e6abeafa28f7ea259b8a9bf/node_modules/@effected/workspaces/WorkspaceRoot.js
 /**
 * The marker filenames {@link WorkspaceRoot} probes for, in priority order.
 *
@@ -18345,7 +19019,7 @@ var WorkspaceRoot = class WorkspaceRoot extends Context.Service()("@effected/wor
 };
 
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+workspaces@0.9.5_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__effect@4.0.0-beta.101/node_modules/@effected/workspaces/internal/limits.js
+//#region ../../node_modules/.pnpm/@effected+workspaces@0.10.2_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__@effected+semv_feff9e309e6abeafa28f7ea259b8a9bf/node_modules/@effected/workspaces/internal/limits.js
 /**
 * Hard ceiling on directories the enumerator will visit for one pattern set.
 * Guards the pathological case a depth cap alone does not: a wide, shallow
@@ -18364,7 +19038,7 @@ const MAX_ENUMERATION_ENTRIES = 1e5;
 const PRUNED_DIRECTORIES = /* @__PURE__ */ new Set([".git", "node_modules"]);
 
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+workspaces@0.9.5_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__effect@4.0.0-beta.101/node_modules/@effected/workspaces/internal/traverse.js
+//#region ../../node_modules/.pnpm/@effected+workspaces@0.10.2_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__@effected+semv_feff9e309e6abeafa28f7ea259b8a9bf/node_modules/@effected/workspaces/internal/traverse.js
 /** Directory names never descended into. */
 const isPruned = (entry) => PRUNED_DIRECTORIES.has(entry);
 /** Join root-relative POSIX segments; `""` is the root itself. */
@@ -18455,7 +19129,7 @@ var Traversal = class {
 };
 
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+workspaces@0.9.5_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__effect@4.0.0-beta.101/node_modules/@effected/workspaces/internal/enumerate.js
+//#region ../../node_modules/.pnpm/@effected+workspaces@0.10.2_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__@effected+semv_feff9e309e6abeafa28f7ea259b8a9bf/node_modules/@effected/workspaces/internal/enumerate.js
 /** Strip a trailing slash from `GlobPattern.enumerationPrefix` to get a relative directory. */
 const baseOf = (pattern) => pattern.enumerationPrefix.replace(/\/$/, "");
 /**
@@ -18526,7 +19200,7 @@ const enumerate = (root, globs, options) => Effect.gen(function* () {
 });
 
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+workspaces@0.9.5_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__effect@4.0.0-beta.101/node_modules/@effected/workspaces/internal/patterns.js
+//#region ../../node_modules/.pnpm/@effected+workspaces@0.10.2_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__@effected+semv_feff9e309e6abeafa28f7ea259b8a9bf/node_modules/@effected/workspaces/internal/patterns.js
 const stringsOf = (value) => Array.isArray(value) ? value.filter((entry) => typeof entry === "string") : void 0;
 /** The `packages:` list of a `pnpm-workspace.yaml` document. Total on a parsed document. */
 const pnpmPatternsOf = (document) => {
@@ -18584,7 +19258,7 @@ const readPatterns = (root) => Effect.gen(function* () {
 });
 
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+workspaces@0.9.5_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__effect@4.0.0-beta.101/node_modules/@effected/workspaces/WorkspaceDiscovery.js
+//#region ../../node_modules/.pnpm/@effected+workspaces@0.10.2_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__@effected+semv_feff9e309e6abeafa28f7ea259b8a9bf/node_modules/@effected/workspaces/WorkspaceDiscovery.js
 /**
 * Raised when a workspace member's `package.json` cannot be read, parsed, or
 * used — it is missing, malformed, or lacks a `name` or `version`.
@@ -18837,6 +19511,15 @@ var WorkspaceDiscovery = class WorkspaceDiscovery extends Context.Service()("@ef
 			for (const entry of index) if (filePath.startsWith(entry.prefix)) return Option.some(entry.package);
 			return Option.none();
 		};
+		const packageIndexes = /* @__PURE__ */ new WeakMap();
+		const packagesByName = (all) => {
+			const cached = packageIndexes.get(all);
+			if (cached !== void 0) return cached;
+			const index = /* @__PURE__ */ new Map();
+			for (const pkg of all) if (!index.has(pkg.name)) index.set(pkg.name, pkg);
+			packageIndexes.set(all, index);
+			return index;
+		};
 		return {
 			info: Effect.fn("WorkspaceDiscovery.info")(function* () {
 				return (yield* memo).info;
@@ -18850,7 +19533,7 @@ var WorkspaceDiscovery = class WorkspaceDiscovery extends Context.Service()("@ef
 			}),
 			getPackage: Effect.fn("WorkspaceDiscovery.getPackage")(function* (name) {
 				const all = yield* packages;
-				const found = all.find((pkg) => pkg.name === name);
+				const found = packagesByName(all).get(name);
 				if (found !== void 0) return found;
 				return yield* Effect.fail(new PackageNotFoundError({
 					name,
@@ -19014,7 +19697,16 @@ var WorkspaceDiscovery = class WorkspaceDiscovery extends Context.Service()("@ef
 	*/
 	static workspaceResolver = Layer.effect(WorkspaceResolver, Effect.gen(function* () {
 		const discovery = yield* WorkspaceDiscovery;
-		return { versionOf: (packageName) => discovery.listPackages().pipe(Effect.map((all) => Option.fromUndefinedOr(all.find((pkg) => pkg.name === packageName)?.version)), Effect.mapError((cause) => new DependencyResolutionError({
+		const versionIndexes = /* @__PURE__ */ new WeakMap();
+		const versionsByName = (all) => {
+			const cached = versionIndexes.get(all);
+			if (cached !== void 0) return cached;
+			const index = /* @__PURE__ */ new Map();
+			for (const pkg of all) if (!index.has(pkg.name)) index.set(pkg.name, pkg.version);
+			versionIndexes.set(all, index);
+			return index;
+		};
+		return { versionOf: (packageName) => discovery.listPackages().pipe(Effect.map((all) => Option.fromUndefinedOr(versionsByName(all).get(packageName))), Effect.mapError((cause) => new DependencyResolutionError({
 			specifier: `workspace:${packageName}`,
 			cause
 		}))) };
@@ -19023,7 +19715,7 @@ var WorkspaceDiscovery = class WorkspaceDiscovery extends Context.Service()("@ef
 const isStringRecord$2 = (value) => value !== null && typeof value === "object" && !Array.isArray(value) && Object.values(value).every((entry) => typeof entry === "string");
 
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+workspaces@0.9.5_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__effect@4.0.0-beta.101/node_modules/@effected/workspaces/DependencyGraph.js
+//#region ../../node_modules/.pnpm/@effected+workspaces@0.10.2_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__@effected+semv_feff9e309e6abeafa28f7ea259b8a9bf/node_modules/@effected/workspaces/DependencyGraph.js
 /**
 * Raised when the workspace dependency graph cannot be topologically ordered
 * because it contains a cycle.
@@ -19257,10 +19949,32 @@ const kahn = (edges) => {
 };
 
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+git@0.5.2_effect@4.0.0-beta.101/node_modules/@effected/git/GitCommand.js
+//#region ../../node_modules/.pnpm/@effected+git@0.6.0_effect@4.0.0-beta.101/node_modules/@effected/git/GitCommand.js
+/** The mask every whole-value sensitive positional is replaced with. */
+const REDACTED = "<redacted>";
+const secretValue = (value) => ({
+	redact: "value",
+	value
+});
+const secretUrl = (value) => ({
+	redact: "url",
+	value
+});
+/**
+* Masks the userinfo component of a URL (`scheme://user:token@host/...` →
+* `scheme://<redacted>@host/...`). A value carrying no embedded userinfo — a
+* remote name, a credential-free URL, an scp-style `host:path` — passes
+* through untouched, so the common case stays fully debuggable.
+*
+* The userinfo match is greedy (`[^/]*@` — everything through the LAST `@`
+* before the first path slash): URL authorities split at the last `@`, so a
+* password containing a literal `@` (`user:p\@ss\@host/...`) must be
+* consumed whole or its tail would survive into `redactedArgs`.
+*/
+const redactUrlUserinfo = (value) => value.replace(/^([a-z][a-z0-9+.-]*:\/\/)[^/]*@/i, `$1${REDACTED}@`);
 /**
-* Builds a `git` `ChildProcess.StandardCommand` with the argv this package
-* classifies against.
+* Builds a `git` {@link GitInvocation} with the argv this package classifies
+* against.
 *
 * @remarks
 * `LC_ALL=C` is pinned on every invocation because git's stderr
@@ -19276,10 +19990,18 @@ const kahn = (edges) => {
 * the working directory per invocation via `ChildProcess.setCwd`, which
 * returns a new command and leaves this one unchanged.
 */
-const git = (args) => ChildProcess.make("git", args, {
-	env: { LC_ALL: "C" },
-	extendEnv: true
-});
+const git = (args, stdin) => {
+	const raw = args.map((arg) => typeof arg === "string" ? arg : arg.value);
+	const redactedArgs = args.map((arg) => typeof arg === "string" ? arg : arg.redact === "value" ? REDACTED : redactUrlUserinfo(arg.value));
+	return {
+		command: ChildProcess.make("git", raw, {
+			env: { LC_ALL: "C" },
+			extendEnv: true,
+			...stdin !== void 0 ? { stdin: Stream.make(new TextEncoder().encode(stdin)) } : {}
+		}),
+		redactedArgs
+	};
+};
 const show = (ref, path) => git(["show", `${ref}:${path}`]);
 const lsTree = (ref, pathspec = []) => git([
 	"ls-tree",
@@ -19338,7 +20060,7 @@ const checkout = (ref, detach = false) => git([
 const fetch$1 = (remote, ref, depth, tag = false) => git([
 	"fetch",
 	...depth !== void 0 ? ["--depth", String(depth)] : [],
-	remote,
+	secretUrl(remote),
 	...tag ? ["tag"] : [],
 	ref
 ]);
@@ -19354,7 +20076,7 @@ const submoduleAdd = (url, path, depth) => git([
 	"add",
 	...depth !== void 0 ? ["--depth", String(depth)] : [],
 	"--",
-	url,
+	secretUrl(url),
 	path
 ]);
 const sparseCheckoutSet = (patterns, cone) => git([
@@ -19367,13 +20089,55 @@ const configSet = (key, value, file) => git([
 	"config",
 	...file !== void 0 ? ["-f", file] : [],
 	key,
-	value
+	secretValue(value)
 ]);
 const add = (paths) => git([
 	"add",
 	"--",
 	...paths
 ]);
+const reset = (mode = "mixed", ref) => git([
+	"reset",
+	`--${mode}`,
+	...ref !== void 0 ? [ref] : []
+]);
+const clean = (directories = false, ignored = false, paths = []) => git([
+	"clean",
+	"--force",
+	...directories ? ["-d"] : [],
+	...ignored ? ["-x"] : [],
+	...paths.length > 0 ? ["--", ...paths] : []
+]);
+const restore = (paths, source, staged = false, worktree = false) => git([
+	"restore",
+	...source !== void 0 ? ["--source", source] : [],
+	...staged ? ["--staged"] : [],
+	...worktree ? ["--worktree"] : [],
+	"--",
+	...paths
+]);
+const branchCreate = (name, startPoint, checkout = false, force = false) => checkout ? git([
+	"checkout",
+	force ? "-B" : "-b",
+	name,
+	...startPoint !== void 0 ? [startPoint] : []
+]) : git([
+	"branch",
+	...force ? ["-f"] : [],
+	name,
+	...startPoint !== void 0 ? [startPoint] : []
+]);
+const branchDelete = (name, force = false) => git([
+	"branch",
+	force ? "-D" : "-d",
+	name
+]);
+const isShallow = () => git(["rev-parse", "--is-shallow-repository"]);
+const fetchUnshallow = (remote = "origin") => git([
+	"fetch",
+	"--unshallow",
+	secretUrl(remote)
+]);
 const nameStatus = (base, head, relative = false) => git([
 	"diff",
 	"--name-status",
@@ -19414,37 +20178,273 @@ const status = () => git([
 	"--porcelain",
 	"-z"
 ]);
-/**
-* Pure constructors for the `git` `ChildProcess.Command` values this package
-* spawns.
-*
-* @remarks
-* Every constructor returns a cwd-less, argv-only `Command` — no spawning,
-* no working directory baked in. `Git` applies the working directory per
-* call with `ChildProcess.setCwd` and owns the actual spawn, timeout, and
-* error classification.
-*
-* @public
-*/
-var GitCommand = class {
-	constructor() {}
-	/**
-	* `git show <ref>:<path>` — the contents of `path` as it existed at `ref`,
-	* without checking anything out.
-	*/
-	static show = show;
-	/**
-	* `git ls-tree -r -z <ref> [-- <pathspec>...]` — every path in the tree at
-	* `ref`, recursively, NUL-terminated, optionally scoped to `pathspec`.
-	*
-	* @remarks
-	* `-z` is load-bearing: git paths may themselves contain newlines, so the
-	* caller must split on `"\0"`, never on `"\n"`. When `pathspec` is provided,
-	* a literal `--` separator is inserted before the pathspec entries to prevent
-	* git from interpreting pathspec values as options.
-	*/
-	static lsTree = lsTree;
-	/**
+const submoduleStatus = (paths = [], recursive = false) => git([
+	"submodule",
+	"status",
+	...recursive ? ["--recursive"] : [],
+	...paths.length > 0 ? ["--", ...paths] : []
+]);
+const submoduleInit = (paths = []) => git([
+	"submodule",
+	"init",
+	...paths.length > 0 ? ["--", ...paths] : []
+]);
+const submoduleDeinit = (paths, all = false, force = false) => git([
+	"submodule",
+	"deinit",
+	...force ? ["--force"] : [],
+	...all ? ["--all"] : ["--", ...paths]
+]);
+const submoduleSync = (paths = [], recursive = false) => git([
+	"submodule",
+	"sync",
+	...recursive ? ["--recursive"] : [],
+	...paths.length > 0 ? ["--", ...paths] : []
+]);
+const submoduleSetUrl = (path, url) => git([
+	"submodule",
+	"set-url",
+	"--",
+	path,
+	secretUrl(url)
+]);
+const submoduleSetBranch = (path, branch) => git([
+	"submodule",
+	"set-branch",
+	...branch === void 0 ? ["--default"] : ["--branch", branch],
+	"--",
+	path
+]);
+const submoduleAbsorbgitdirs = (paths = []) => git([
+	"submodule",
+	"absorbgitdirs",
+	...paths.length > 0 ? ["--", ...paths] : []
+]);
+const submoduleForeach = (command, recursive = false) => git([
+	"submodule",
+	"foreach",
+	...recursive ? ["--recursive"] : [],
+	command
+]);
+const lsRemote = (remote, heads = false, tags = false, patterns = []) => git([
+	"ls-remote",
+	...heads ? ["--heads"] : [],
+	...tags ? ["--tags"] : [],
+	secretUrl(remote),
+	...patterns
+]);
+const remoteAdd = (name, url) => git([
+	"remote",
+	"add",
+	name,
+	secretUrl(url)
+]);
+const remoteRemove = (name) => git([
+	"remote",
+	"remove",
+	name
+]);
+const remoteSetUrl = (name, url) => git([
+	"remote",
+	"set-url",
+	name,
+	secretUrl(url)
+]);
+const stashRef = (index) => `stash@{${index}}`;
+const stashPush = (message, includeUntracked = false, paths = []) => git([
+	"stash",
+	"push",
+	...includeUntracked ? ["--include-untracked"] : [],
+	...message !== void 0 ? ["-m", message] : [],
+	...paths.length > 0 ? ["--", ...paths] : []
+]);
+const stashPop = (index) => git([
+	"stash",
+	"pop",
+	...index !== void 0 ? [stashRef(index)] : []
+]);
+const stashApply = (index) => git([
+	"stash",
+	"apply",
+	...index !== void 0 ? [stashRef(index)] : []
+]);
+const stashDrop = (index) => git([
+	"stash",
+	"drop",
+	...index !== void 0 ? [stashRef(index)] : []
+]);
+const stashList = () => git([
+	"stash",
+	"list",
+	"-z",
+	"--format=%gd%x1f%H%x1f%gs"
+]);
+const branchList = (remotes = false, all = false) => git([
+	"branch",
+	"--list",
+	...all ? ["--all"] : remotes ? ["--remotes"] : [],
+	"--format=%(HEAD)%00%(refname:short)%00%(objectname)"
+]);
+const tagCreate = (name, ref, message, force = false) => git([
+	"tag",
+	...force ? ["--force"] : [],
+	...message !== void 0 ? ["-m", message] : [],
+	name,
+	...ref !== void 0 ? [ref] : []
+]);
+const tagDelete = (name) => git([
+	"tag",
+	"--delete",
+	name
+]);
+const tagList = (pattern) => git([
+	"tag",
+	"--list",
+	...pattern !== void 0 ? [pattern] : []
+]);
+const forEachRef = (patterns = []) => git([
+	"for-each-ref",
+	"--format=%(refname)%00%(objectname)%00%(objecttype)",
+	...patterns
+]);
+const revList = (ref, limit, firstParent = false) => git([
+	"rev-list",
+	...limit !== void 0 ? [`--max-count=${limit}`] : [],
+	...firstParent ? ["--first-parent"] : [],
+	ref
+]);
+const commit = (message, all = false, allowEmpty = false, amend = false, author) => git([
+	"commit",
+	...all ? ["--all"] : [],
+	...allowEmpty ? ["--allow-empty"] : [],
+	...amend ? ["--amend"] : [],
+	...author !== void 0 ? [`--author=${author}`] : [],
+	"-m",
+	message
+]);
+const push$1 = (remote, refspec, force = false, forceWithLease = false, tags = false, setUpstream = false) => git([
+	"push",
+	...force ? ["--force"] : [],
+	...forceWithLease ? ["--force-with-lease"] : [],
+	...tags ? ["--tags"] : [],
+	...setUpstream ? ["--set-upstream"] : [],
+	secretUrl(remote),
+	...refspec !== void 0 ? [refspec] : []
+]);
+const pull = (remote, ref, rebase = false, ffOnly = false) => git([
+	"pull",
+	...rebase ? ["--rebase"] : [],
+	...ffOnly ? ["--ff-only"] : [],
+	secretUrl(remote),
+	...ref !== void 0 ? [ref] : []
+]);
+const configList = (file) => git([
+	"config",
+	...file !== void 0 ? ["-f", file] : [],
+	"--list",
+	"-z"
+]);
+const configGetAll = (key, file) => git([
+	"config",
+	...file !== void 0 ? ["-f", file] : [],
+	"--get-all",
+	"-z",
+	key
+]);
+const configUnset = (key, file, all = false) => git([
+	"config",
+	...file !== void 0 ? ["-f", file] : [],
+	all ? "--unset-all" : "--unset",
+	key
+]);
+const rm = (paths, cached = false, recursive = false, force = false) => git([
+	"rm",
+	...cached ? ["--cached"] : [],
+	...recursive ? ["-r"] : [],
+	...force ? ["--force"] : [],
+	"--",
+	...paths
+]);
+const mv = (source, destination, force = false) => git([
+	"mv",
+	...force ? ["--force"] : [],
+	"--",
+	source,
+	destination
+]);
+const checkIgnore = (paths) => git([
+	"check-ignore",
+	"-z",
+	"--stdin"
+], paths.map((path) => `${path}\0`).join(""));
+const worktreeAdd = (path, ref, detach = false, force = false) => git([
+	"worktree",
+	"add",
+	...force ? ["--force"] : [],
+	...detach ? ["--detach"] : [],
+	path,
+	...ref !== void 0 ? [ref] : []
+]);
+const worktreeList = () => git([
+	"worktree",
+	"list",
+	"--porcelain",
+	"-z"
+]);
+const worktreeRemove = (path, force = false) => git([
+	"worktree",
+	"remove",
+	...force ? ["--force"] : [],
+	path
+]);
+const lsFiles = (pathspec = []) => git([
+	"ls-files",
+	"--stage",
+	"-z",
+	...pathspec.length > 0 ? ["--", ...pathspec] : []
+]);
+/**
+* Pure constructors for the `git` {@link GitInvocation} values this package
+* spawns.
+*
+* @remarks
+* Every constructor returns a cwd-less, argv-only {@link GitInvocation} — no
+* spawning, no working directory baked in. `Git` applies the working
+* directory per call with `ChildProcess.setCwd` on `invocation.command` and
+* owns the actual spawn, timeout, and error classification.
+*
+* **Redaction policy.** A constructor whose argv carries a sensitive
+* positional — a config value (`configSet`), or a URL that may embed
+* userinfo (the remote of `fetch`, `fetchUnshallow`, `lsRemote`, `push` and
+* `pull`, and the url of `submoduleAdd`, `submoduleSetUrl`, `remoteAdd` and
+* `remoteSetUrl`) —
+* masks it in {@link GitInvocation.redactedArgs}: a config value becomes
+* `<redacted>` wholesale, a URL keeps everything but its `userinfo@`
+* component. The `Git` service persists only the redacted argv in error
+* values, and its span annotations carry stable identifiers only (`cwd`,
+* keys, paths, remote/ref names) — never config values, never URLs.
+*
+* @public
+*/
+var GitCommand = class {
+	constructor() {}
+	/**
+	* `git show <ref>:<path>` — the contents of `path` as it existed at `ref`,
+	* without checking anything out.
+	*/
+	static show = show;
+	/**
+	* `git ls-tree -r -z <ref> [-- <pathspec>...]` — every path in the tree at
+	* `ref`, recursively, NUL-terminated, optionally scoped to `pathspec`.
+	*
+	* @remarks
+	* `-z` is load-bearing: git paths may themselves contain newlines, so the
+	* caller must split on `"\0"`, never on `"\n"`. When `pathspec` is provided,
+	* a literal `--` separator is inserted before the pathspec entries to prevent
+	* git from interpreting pathspec values as options.
+	*/
+	static lsTree = lsTree;
+	/**
 	* `git cat-file -e <ref>` — checks whether `ref` resolves to an existing
 	* object, without printing it. A non-zero exit means the ref does not exist.
 	*/
@@ -19520,9 +20520,106 @@ var GitCommand = class {
 	/**
 	* Mutating: `git fetch [--depth <n>] <remote> [tag] <ref>` — fetches the given
 	* ref from a remote, optionally with a depth limit and the `tag` keyword.
+	*
+	* @remarks
+	* `remote` may be a URL as well as a remote name; an embedded
+	* `userinfo@` credential is masked in {@link GitInvocation.redactedArgs}.
 	*/
 	static fetch = fetch$1;
 	/**
+	* Mutating: `git fetch --unshallow <remote>` — converts a shallow clone
+	* into a complete one by fetching the missing history.
+	*
+	* @remarks
+	* `--unshallow` is a distinct MODE, not a depth value: git rejects it
+	* outright in a repository that is not shallow, with
+	* `--unshallow on a complete repository does not make sense`, so it
+	* cannot be expressed as `fetch`'s `depth` option. The caller decides
+	* whether to run it — probe with `Git.isShallow` first.
+	*
+	* `remote` may be a URL as well as a remote name; an embedded `userinfo@`
+	* credential is masked in {@link GitInvocation.redactedArgs}.
+	*/
+	static fetchUnshallow = fetchUnshallow;
+	/**
+	* `git rev-parse --is-shallow-repository` — prints `true` when the
+	* repository is a shallow clone, `false` otherwise.
+	*
+	* @remarks
+	* A dedicated probe constructor, deliberately separate from
+	* {@link GitCommand.revParse}: `revParse` takes a REF and resolves it,
+	* while this takes nothing and answers a repository-shape question.
+	* Folding the flag into `revParse` would make that constructor
+	* sometimes-takes-a-ref, sometimes-takes-a-flag.
+	*/
+	static isShallow = isShallow;
+	/**
+	* Mutating: `git reset --soft|--mixed|--hard [<ref>]` — moves `HEAD` (and,
+	* per mode, the index and working tree) to `ref`.
+	*
+	* @remarks
+	* The mode flag is always explicit — `--mixed` is emitted for the default
+	* rather than omitted — so the argv states what runs. `ref` may be any
+	* commit-ish, including a gitlink sha.
+	*/
+	static reset = reset;
+	/**
+	* Mutating: `git clean --force [-d] [-x] [-- <paths>...]` — deletes
+	* untracked files from the working tree.
+	*
+	* @remarks
+	* `--force` is unconditional: this constructor exists so a consumer can
+	* restore a tree to a known state (e.g. before retrying a non-idempotent
+	* operation), and without `--force` git refuses to clean at all under the
+	* default `clean.requireForce` config — a clean that silently did nothing
+	* would hand the retry the same dirty tree. `-d` removes untracked
+	* directories too; `-x` removes ignored files as well. The literal `--`
+	* separator makes the optional pathspec injection-safe by construction.
+	*/
+	static clean = clean;
+	/**
+	* Mutating: `git restore [--source <ref>] [--staged] [--worktree] -- <paths...>`
+	* — restores the given paths from the index (or from `source`), the
+	* `checkout -- <paths>`-shaped operation.
+	*
+	* @remarks
+	* This is a separate constructor precisely because {@link GitCommand.checkout}'s
+	* service guard refuses `--` and option-like refs by design — `restore` is
+	* git's own verb for pathspec restoration, and its paths always sit behind
+	* a literal `--`, so they are injection-safe by construction. With neither
+	* `staged` nor `worktree` set, git defaults to restoring the working tree.
+	*/
+	static restore = restore;
+	/**
+	* Mutating: `git branch [-f] <name> [<start-point>]`, or
+	* `git checkout (-b | -B) <name> [<start-point>]` when `checkout` is true —
+	* creates a branch, optionally from an explicit start point, optionally
+	* switching to it, optionally force-resetting an existing branch.
+	*
+	* @remarks
+	* Branch creation is a branch-member concern, NOT a widening of
+	* {@link GitCommand.checkout}: `checkout`'s contract stays "move to an
+	* existing ref" and its option-like-ref refusal stays intact. The `-b` /
+	* `-B` here is this constructor's own literal, never caller data.
+	*
+	* `force` with `checkout` exists because the delete-then-create longhand
+	* (`branch -D` swallowed, then `checkout -b`) papers over a real edge:
+	* `git branch -D` refuses to delete the currently checked-out branch,
+	* while `checkout -B` resets it fine — one invocation handles both
+	* states.
+	*/
+	static branchCreate = branchCreate;
+	/**
+	* Mutating: `git branch -d <name>` (or `-D` when `force` is true) —
+	* deletes a local branch.
+	*
+	* @remarks
+	* The default `-d` refuses to delete a branch not fully merged — a typed
+	* failure, which is usually the honest answer. `force: true` emits `-D`
+	* and deletes regardless.
+	*/
+	static branchDelete = branchDelete;
+	/**
 	* Mutating: `git submodule update [--init] [--depth <n>] [-- <paths>...]` — updates
 	* registered submodules, optionally initializing them, with an optional depth limit,
 	* and scoped to specific paths. The literal `--` separator makes the pathspec
@@ -19533,6 +20630,10 @@ var GitCommand = class {
 	* Mutating: `git submodule add [--depth <n>] -- <url> <path>` — registers and
 	* initializes a new submodule. The literal `--` separator makes the url and path
 	* injection-safe by construction.
+	*
+	* @remarks
+	* An embedded `userinfo@` credential in `url` is masked in
+	* {@link GitInvocation.redactedArgs}.
 	*/
 	static submoduleAdd = submoduleAdd;
 	/**
@@ -19545,6 +20646,13 @@ var GitCommand = class {
 	/**
 	* Mutating: `git config [-f <file>] <key> <value>` — writes a configuration value,
 	* optionally into an explicit configuration file (e.g., `.gitmodules`).
+	*
+	* @remarks
+	* `value` may be a secret (a token, a credential-bearing URL), so it is
+	* masked wholesale — as `<redacted>` — in
+	* {@link GitInvocation.redactedArgs}. The key and file stay visible: they
+	* are stable identifiers, and they are what a caller debugging a failed
+	* write actually needs.
 	*/
 	static configSet = configSet;
 	/**
@@ -19627,10 +20735,305 @@ var GitCommand = class {
 	* Each entry is a pair of status codes followed by a space and the path.
 	*/
 	static status = status;
+	/**
+	* `git submodule status [--recursive] [-- <paths>...]` — one line per
+	* registered submodule: a state prefix, the checked-out (or gitlink) sha,
+	* the path, and — when the submodule is initialized — a `git describe`
+	* suffix in parentheses.
+	*
+	* @remarks
+	* `git submodule status` has no `-z` mode, so its output is line-based —
+	* the one path-emitting constructor in this package that cannot follow
+	* the `-z` rule. A submodule path containing a newline would corrupt the
+	* parse; accepted as a git-imposed limitation.
+	*/
+	static submoduleStatus = submoduleStatus;
+	/**
+	* Mutating: `git submodule init [-- <paths>...]` — registers the
+	* submodules from `.gitmodules` into `.git/config` (all of them, or only
+	* `paths`), without cloning or checking anything out.
+	*/
+	static submoduleInit = submoduleInit;
+	/**
+	* Mutating: `git submodule deinit [--force] (--all | -- <paths>...)` —
+	* unregisters submodules: clears their working trees and removes their
+	* `.git/config` registration. The literal `--` separator makes the
+	* pathspec injection-safe by construction.
+	*/
+	static submoduleDeinit = submoduleDeinit;
+	/**
+	* Mutating: `git submodule sync [--recursive] [-- <paths>...]` —
+	* re-copies each submodule's URL from `.gitmodules` into `.git/config`
+	* (and into the submodule's own `remote.origin.url`), so a `.gitmodules`
+	* URL change actually reaches git's live configuration.
+	*/
+	static submoduleSync = submoduleSync;
+	/**
+	* Mutating: `git submodule set-url -- <path> <url>` — rewrites the
+	* submodule's URL in `.gitmodules` and synchronizes it into
+	* `.git/config`. The literal `--` separator makes the path and url
+	* injection-safe by construction.
+	*
+	* @remarks
+	* An embedded `userinfo@` credential in `url` is masked in
+	* {@link GitInvocation.redactedArgs}.
+	*/
+	static submoduleSetUrl = submoduleSetUrl;
+	/**
+	* Mutating: `git submodule set-branch (--branch <branch> | --default) -- <path>`
+	* — records (or clears, when `branch` is omitted) the branch a submodule
+	* tracks in `.gitmodules`. The literal `--` separator makes the path
+	* injection-safe by construction.
+	*/
+	static submoduleSetBranch = submoduleSetBranch;
+	/**
+	* Mutating: `git submodule absorbgitdirs [-- <paths>...]` — moves each
+	* submodule's embedded `.git` directory into the superproject's
+	* `.git/modules/` and leaves a gitfile pointer behind.
+	*/
+	static submoduleAbsorbgitdirs = submoduleAbsorbgitdirs;
+	/**
+	* Mutating: `git submodule foreach [--recursive] <command>` — runs a shell
+	* command in every checked-out submodule. `command` is a single shell
+	* string, evaluated by git in each submodule's directory; it can mutate
+	* anything, which is why the constructor is marked mutating regardless of
+	* what the command does.
+	*
+	* @remarks
+	* This is the ONE constructor whose argument cannot be made injection-safe
+	* by construction: git evaluates `command` with `sh -c`, so every character
+	* of it is shell code — a `--` separator or quoting cannot help. Callers
+	* must treat `command` as a trusted literal and never interpolate untrusted
+	* data into it.
+	*/
+	static submoduleForeach = submoduleForeach;
+	/**
+	* `git ls-remote [--heads] [--tags] <remote> [<patterns>...]` — the refs a
+	* remote advertises (sha + refname), optionally filtered to branch heads,
+	* tags, and/or shell-glob patterns.
+	*
+	* @remarks
+	* A read that talks to the NETWORK, not to the local repository — the one
+	* non-mutating constructor in this package that does. An embedded
+	* `userinfo@` credential in `remote` is masked in
+	* {@link GitInvocation.redactedArgs}. An annotated tag advertises two
+	* entries: `refs/tags/<name>` (the tag object) and `refs/tags/<name>^{}`
+	* (the peeled commit).
+	*/
+	static lsRemote = lsRemote;
+	/**
+	* Mutating: `git remote add <name> <url>` — registers a new remote.
+	*
+	* @remarks
+	* An embedded `userinfo@` credential in `url` is masked in
+	* {@link GitInvocation.redactedArgs}.
+	*/
+	static remoteAdd = remoteAdd;
+	/**
+	* Mutating: `git remote remove <name>` — deletes a remote and its
+	* remote-tracking refs and configuration.
+	*/
+	static remoteRemove = remoteRemove;
+	/**
+	* Mutating: `git remote set-url <name> <url>` — rewrites a remote's fetch
+	* URL.
+	*
+	* @remarks
+	* An embedded `userinfo@` credential in `url` is masked in
+	* {@link GitInvocation.redactedArgs}.
+	*/
+	static remoteSetUrl = remoteSetUrl;
+	/**
+	* Mutating: `git stash push [--include-untracked] [-m <message>] [-- <paths>...]`
+	* — saves the working tree (and index) state onto the stash stack. The
+	* literal `--` separator makes the optional pathspec injection-safe by
+	* construction; the message rides behind `-m`, which git consumes as a
+	* value even when it begins with `-`.
+	*/
+	static stashPush = stashPush;
+	/**
+	* Mutating: `git stash pop [stash@{n}]` — applies a stash entry and drops
+	* it on success. The stash ref is rendered from an INTEGER index by this
+	* package, never caller text.
+	*/
+	static stashPop = stashPop;
+	/**
+	* Mutating: `git stash apply [stash@{n}]` — applies a stash entry and
+	* keeps it on the stack. The stash ref is rendered from an INTEGER index
+	* by this package, never caller text.
+	*/
+	static stashApply = stashApply;
+	/**
+	* Mutating: `git stash drop [stash@{n}]` — deletes a stash entry without
+	* applying it. The stash ref is rendered from an INTEGER index by this
+	* package, never caller text.
+	*/
+	static stashDrop = stashDrop;
+	/**
+	* `git stash list -z --format=%gd%x1f%H%x1f%gs` — every stash entry as a
+	* NUL-terminated record of unit-separated fields: the reflog selector
+	* (`stash@{0}`), the stash commit sha, and the reflog subject.
+	*
+	* @remarks
+	* The `%x1f` (ASCII unit separator) field separator plus `-z` record
+	* terminator keeps the parse split-safe: a stash message cannot contain
+	* either byte (reflog subjects are single-line).
+	*/
+	static stashList = stashList;
+	/**
+	* `git branch --list [--remotes | --all] --format=%(HEAD)%00%(refname:short)%00%(objectname)`
+	* — every branch as a NUL-separated triple: the current-branch marker, the
+	* short name, and the tip sha.
+	*
+	* @remarks
+	* Records are newline-separated, which is split-safe here: git refnames
+	* cannot contain a newline (or a space), so the only NUL bytes are the
+	* format's own field separators. `all` wins over `remotes` when both are
+	* set.
+	*/
+	static branchList = branchList;
+	/**
+	* Mutating: `git tag [--force] [-m <message>] <name> [<ref>]` — creates a
+	* lightweight tag, or an annotated one when `message` is given (`-m`
+	* implies `-a`).
+	*/
+	static tagCreate = tagCreate;
+	/** Mutating: `git tag --delete <name>` — deletes a local tag. */
+	static tagDelete = tagDelete;
+	/**
+	* `git tag --list [<pattern>]` — tag names, optionally filtered by a
+	* shell-glob pattern, one per line (refnames cannot contain newlines).
+	*/
+	static tagList = tagList;
+	/**
+	* `git for-each-ref --format=%(refname)%00%(objectname)%00%(objecttype) [<patterns>...]`
+	* — every matching ref as a NUL-separated triple: full refname, sha, and
+	* object type.
+	*
+	* @remarks
+	* The format is this package's own fixed triple — the parse contract and
+	* the argv are decided together, so the format string is a constructor
+	* literal, never caller data. An annotated tag's `objecttype` is `tag`
+	* (the tag object), not `commit`.
+	*/
+	static forEachRef = forEachRef;
+	/**
+	* `git rev-list [--max-count=<n>] [--first-parent] <ref-or-range>` — commit
+	* shas reachable from the ref (or range, e.g. `main..feat`), newest first.
+	*/
+	static revList = revList;
+	/**
+	* Mutating: `git commit [--all] [--allow-empty] [--amend] [--author=<author>] -m <message>`
+	* — records a commit. The message always rides argv behind `-m` (git
+	* consumes it as a value even when it begins with `-`); committer identity
+	* comes from the caller's environment — this constructor sets no
+	* `GIT_AUTHOR_*`/`GIT_COMMITTER_*` variables, and the optional `author`
+	* override is the fused `--author=` form.
+	*/
+	static commit = commit;
+	/**
+	* Mutating: `git push [--force | --force-with-lease] [--tags] [--set-upstream] <remote> [<refspec>]`
+	* — updates remote refs.
+	*
+	* @remarks
+	* `remote` may be a URL as well as a remote name; an embedded `userinfo@`
+	* credential is masked in {@link GitInvocation.redactedArgs}.
+	*/
+	static push = push$1;
+	/**
+	* Mutating: `git pull [--rebase] [--ff-only] <remote> [<ref>]` — fetches
+	* and integrates.
+	*
+	* @remarks
+	* `remote` may be a URL as well as a remote name; an embedded `userinfo@`
+	* credential is masked in {@link GitInvocation.redactedArgs}.
+	*/
+	static pull = pull;
+	/**
+	* `git config [-f <file>] --list -z` — every configuration entry in scope
+	* (or in the given file only), NUL-terminated, the key separated from the
+	* value by a newline within each record.
+	*
+	* @remarks
+	* `-z` is load-bearing: a config VALUE may contain newlines; only the NUL
+	* record terminator plus first-newline field split parses it losslessly.
+	* A valueless key (git's boolean-true shorthand) emits no newline at all.
+	*/
+	static configList = configList;
+	/**
+	* `git config [-f <file>] --get-all -z <key>` — every value of a
+	* (possibly multi-valued) key, NUL-terminated. An unset key exits 1 with
+	* silent stderr.
+	*/
+	static configGetAll = configGetAll;
+	/**
+	* Mutating: `git config [-f <file>] (--unset | --unset-all) <key>` —
+	* removes a key (or, with `all`, every value of a multi-valued key).
+	*
+	* @remarks
+	* git exits 5, silently, when the key was not set — a loud failure by
+	* this package's classification, deliberately: an unset that silently did
+	* nothing is indistinguishable from one that worked.
+	*/
+	static configUnset = configUnset;
+	/**
+	* Mutating: `git rm [--cached] [-r] [--force] -- <paths...>` — removes
+	* paths from the index (and, without `cached`, the working tree). The
+	* literal `--` separator makes the pathspec injection-safe by
+	* construction.
+	*/
+	static rm = rm;
+	/**
+	* Mutating: `git mv [--force] -- <source> <destination>` — moves or
+	* renames a tracked path. The literal `--` separator makes both positionals
+	* injection-safe by construction.
+	*/
+	static mv = mv;
+	/**
+	* `git check-ignore -z --stdin` — which of the given paths git would
+	* ignore, paths fed NUL-separated via stdin and answers returned
+	* NUL-separated.
+	*
+	* @remarks
+	* The `--stdin -z` form is the only fully robust one: `-z` without
+	* `--stdin` is rejected by git outright, and the non-`-z` output C-quotes
+	* special-character paths. Feeding paths via stdin also makes them
+	* injection-safe by construction — nothing caller-controlled enters the
+	* argv. When NO path is ignored, git exits 1 with silent stderr.
+	*/
+	static checkIgnore = checkIgnore;
+	/**
+	* Mutating: `git worktree add [--force] [--detach] <path> [<ref>]` —
+	* creates a linked working tree at `path`, checked out at `ref` (or the
+	* branch named after `path`'s basename).
+	*/
+	static worktreeAdd = worktreeAdd;
+	/**
+	* `git worktree list --porcelain -z` — every working tree as a block of
+	* NUL-terminated attributes (`worktree <path>`, `HEAD <sha>`,
+	* `branch <ref>` / `detached`, `bare`, `locked [<reason>]`,
+	* `prunable [<reason>]`), blocks separated by an empty attribute.
+	*/
+	static worktreeList = worktreeList;
+	/** Mutating: `git worktree remove [--force] <path>` — removes a linked working tree. */
+	static worktreeRemove = worktreeRemove;
+	/**
+	* `git ls-files --stage -z [-- <pathspec>...]` — every INDEX entry (mode,
+	* oid, stage number, path), NUL-terminated, optionally scoped to
+	* `pathspec`.
+	*
+	* @remarks
+	* The index-side sibling of {@link GitCommand.lsTree}: `lsTree` reads a
+	* COMMITTED tree at a ref, while this reads the staging area — the only
+	* place a staged-but-uncommitted gitlink (`160000 <oid> 0 <path>`) is
+	* visible. `-z` is load-bearing twice over: paths may contain newlines,
+	* and the non-`-z` output C-quotes special-character paths.
+	*/
+	static lsFiles = lsFiles;
 };
 
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+git@0.5.2_effect@4.0.0-beta.101/node_modules/@effected/git/internal/run.js
+//#region ../../node_modules/.pnpm/@effected+git@0.6.0_effect@4.0.0-beta.101/node_modules/@effected/git/internal/run.js
 /**
 * Spawns `command` and collects its stdout, stderr, and exit code as a single
 * triple.
@@ -19658,7 +21061,7 @@ const runCollected = (command) => Effect.scoped(Effect.gen(function* () {
 }));
 
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+git@0.5.2_effect@4.0.0-beta.101/node_modules/@effected/git/Git.js
+//#region ../../node_modules/.pnpm/@effected+git@0.6.0_effect@4.0.0-beta.101/node_modules/@effected/git/Git.js
 /** git's own ceiling: a run that has not answered in 30s is not going to. */
 const GIT_TIMEOUT = Duration.seconds(30);
 /**
@@ -19686,7 +21089,16 @@ var GitCommandError = class extends Schema.TaggedErrorClass()("GitCommandError",
 	* logic routes on this instead of matching `detail` prose.
 	*/
 	kind: Schema.Literals(["refused", "failed"]),
-	/** The argument vector, without the leading `git`. */
+	/**
+	* The REDACTED argument vector, without the leading `git`.
+	*
+	* Sensitive positionals — config values, a URL's embedded userinfo — are
+	* already masked by the constructor's redaction mask before this error is
+	* constructed (`configSet`'s value reads `<redacted>`; a
+	* `https://user:token@host/...` remote keeps everything but its
+	* `userinfo@`). The raw argv is never persisted in an error value, and
+	* `message` renders this redacted vector.
+	*/
 	args: Schema.Array(Schema.String),
 	/** The working directory the command ran in. */
 	cwd: Schema.String,
@@ -19732,12 +21144,77 @@ var UnknownRefError = class extends Schema.TaggedErrorClass()("UnknownRefError",
 	}
 };
 /**
-* One entry of a `git ls-tree` listing.
+* A `git push` was rejected because the remote ref has moved: the classic
+* non-fast-forward rejection (`fetch first` / `non-fast-forward`), or a
+* `--force-with-lease` lease failure (`stale info`).
+*
+* @remarks
+* The typed signal a fetch-then-retry (or rebase-then-retry) fallback
+* branches on — every other push failure stays a {@link GitCommandError}.
+* Only `Git.push` can fail with this error.
 *
 * @public
 */
-var LsTreeEntry = class extends Schema.Class("LsTreeEntry")({
-	/** The entry's file mode, e.g. `100644`. */
+var NonFastForwardError = class extends Schema.TaggedErrorClass()("NonFastForwardError", {
+	/** The working directory the push ran in. */
+	cwd: Schema.String,
+	/** The refspec that was rejected, when the caller passed one. */
+	refspec: Schema.optionalKey(Schema.String)
+}) {
+	/** Renders the rejected push into a one-line message. */
+	get message() {
+		return this.refspec !== void 0 ? `push of '${this.refspec}' rejected as non-fast-forward in ${this.cwd}` : `push rejected as non-fast-forward in ${this.cwd}`;
+	}
+};
+/**
+* A merge-shaped operation (`pull`, `stash pop`, `stash apply`) stopped with
+* conflict markers in the working tree.
+*
+* @remarks
+* The typed signal a resolve-or-abort recovery branches on. The conflicted
+* state is REAL: git has already written conflict markers, and (for `pull`)
+* `MERGE_HEAD` is set — the caller owns resolving or aborting. Detection
+* matches git's conflict report, which lands on STDOUT for a merge and on
+* stderr for a rebase-mode pull; both streams are inspected.
+*
+* @public
+*/
+var MergeConflictError = class extends Schema.TaggedErrorClass()("MergeConflictError", { 
+/** The working directory the merge ran in. */
+cwd: Schema.String }) {
+	/** Renders the conflicted merge into a one-line message. */
+	get message() {
+		return `merge conflict in ${this.cwd}: fix conflicts (or abort) before continuing`;
+	}
+};
+/**
+* A merge-shaped operation refused to start because local modifications would
+* be overwritten — git's refusal reads
+* `Your local changes ... would be overwritten by merge`.
+*
+* @remarks
+* The typed "commit or stash first" signal. Unlike {@link MergeConflictError}
+* the working tree is UNTOUCHED — git aborted before changing anything.
+* Only the merge-shaped methods (`pull`, `stashPop`, `stashApply`) can fail
+* with this error.
+*
+* @public
+*/
+var DirtyWorktreeError = class extends Schema.TaggedErrorClass()("DirtyWorktreeError", { 
+/** The working directory whose local changes blocked the operation. */
+cwd: Schema.String }) {
+	/** Renders the blocked operation into a one-line message. */
+	get message() {
+		return `local changes would be overwritten in ${this.cwd}: commit or stash them first`;
+	}
+};
+/**
+* One entry of a `git ls-tree` listing.
+*
+* @public
+*/
+var LsTreeEntry = class extends Schema.Class("LsTreeEntry")({
+	/** The entry's file mode, e.g. `100644`. */
 	mode: Schema.String,
 	/** The kind of object the entry points at. */
 	type: Schema.Literals([
@@ -19792,11 +21269,26 @@ const UNKNOWN_REF_PATTERNS = [
 	"couldn't find remote ref"
 ];
 const ABSENT_AT_REF_PATTERNS = ["does not exist in", "exists on disk, but not in"];
+const PUSH_REJECTED_PATTERNS = [
+	"non-fast-forward",
+	"fetch first",
+	"stale info"
+];
+const MERGE_CONFLICT_PATTERNS = [
+	"CONFLICT (",
+	"Automatic merge failed",
+	"could not apply"
+];
+const DIRTY_WORKTREE_PATTERN = "would be overwritten by";
 const matchesAny = (stderr, patterns) => patterns.some((pattern) => stderr.includes(pattern));
 /**
 * Classifies one completed run (or spawn-level `PlatformError`) against
 * git's stderr taxonomy. Written once — every `Git` method funnels through
 * this before deciding its own return value.
+*
+* `args` is the invocation's REDACTED argv: it is the only argv this
+* function may persist into a `GitCommandError`, per the #86 redaction
+* policy.
 */
 const classify = (cwd, args, outcome, kind) => {
 	if (outcome instanceof PlatformError.PlatformError) {
@@ -19819,6 +21311,11 @@ const classify = (cwd, args, outcome, kind) => {
 	};
 	if (stderr.includes(NOT_A_REPOSITORY)) return { _tag: "notARepository" };
 	if (matchesAny(stderr, UNKNOWN_REF_PATTERNS)) return { _tag: "unknownRef" };
+	if (kind === "push" && stderr.includes("[rejected]") && matchesAny(stderr, PUSH_REJECTED_PATTERNS)) return { _tag: "nonFastForward" };
+	if (kind === "merge") {
+		if (stderr.includes(DIRTY_WORKTREE_PATTERN)) return { _tag: "dirtyWorktree" };
+		if (matchesAny(stdout, MERGE_CONFLICT_PATTERNS) || matchesAny(stderr, MERGE_CONFLICT_PATTERNS)) return { _tag: "mergeConflict" };
+	}
 	if (kind === "quiet" && exitCode === 1 && stderr === "") return { _tag: "absent" };
 	if (kind === "noSuchRemote" && stderr.includes("No such remote")) return { _tag: "absent" };
 	if (kind === "show" && matchesAny(stderr, ABSENT_AT_REF_PATTERNS)) return { _tag: "absent" };
@@ -19835,13 +21332,19 @@ const classify = (cwd, args, outcome, kind) => {
 	};
 };
 /**
-* Runs `command`, classifies the outcome, and never fails: a spawn-level
-* `PlatformError` and a per-run timeout are both absorbed into the
-* `"failure"` classification rather than escaping the effect's error
-* channel.
+* Runs an invocation's command in `cwd`, classifies the outcome, and never
+* fails: a spawn-level `PlatformError` and a per-run timeout are both
+* absorbed into the `"failure"` classification rather than escaping the
+* effect's error channel.
+*
+* The argv handed to `classify` — and therefore persisted into any
+* `GitCommandError` — is the invocation's REDACTED argv, never the raw one:
+* the redaction mask the pure constructor carries is applied here, at the
+* single classification choke point (the #86 redaction policy).
 */
-const runClassified = (command, cwd, kind) => {
-	const args = ChildProcess.isStandardCommand(command) ? command.args : [];
+const runClassified = (invocation, cwd, kind) => {
+	const args = invocation.redactedArgs;
+	const command = ChildProcess.setCwd(invocation.command, cwd);
 	return runCollected(command).pipe(Effect.map((collected) => classify(cwd, args, collected, kind)), Effect.catch((platformError) => Effect.succeed(classify(cwd, args, platformError, kind))), Effect.timeoutOrElse({
 		duration: GIT_TIMEOUT,
 		orElse: () => Effect.succeed({
@@ -19971,7 +21474,43 @@ var StatusEntry = class extends Schema.Class("StatusEntry")({
 	path: Schema.String,
 	/** The original path; present only on rename/copy entries. */
 	origPath: Schema.optionalKey(Schema.String)
-}) {};
+}) {
+	/**
+	* Renders this entry back to one porcelain-shaped line: `XY <path>`.
+	*
+	* @remarks
+	* **The rename convention is decided here, once, for every consumer.** By
+	* default a rename/copy entry renders its NEW path only — `path` IS the
+	* entry's current path, the one a line-oriented downstream can actually
+	* open — which is a deliberate divergence from git's own non-`-z`
+	* rendering (`orig -> new`). The arrow form is ambiguous to naive
+	* line/whitespace splitters (paths may contain spaces, or a literal
+	* `" -> "`), so it is opt-in via `renames: "arrow"` for consumers that
+	* want git parity.
+	*
+	* A second recorded divergence: git's non-`-z` porcelain C-quotes paths
+	* containing special characters; this renderer emits paths raw. It exists
+	* for whitespace-insensitive text consumers — a machine parser should
+	* consume the decoded {@link StatusEntry} values (or `-z` output)
+	* directly, never re-parse this rendering.
+	*/
+	toLine(options) {
+		const rendered = options?.renames === "arrow" && this.origPath !== void 0 ? `${this.origPath} -> ${this.path}` : this.path;
+		return `${this.x}${this.y} ${rendered}`;
+	}
+	/**
+	* Renders entries back to porcelain-shaped text: one {@link StatusEntry.toLine}
+	* line per entry, newline-joined, no trailing newline.
+	*
+	* @remarks
+	* The route back from `Git.status`'s parsed entries to line-oriented text,
+	* so a consumer whose downstream contract is porcelain-shaped text does
+	* not hand-roll its own renderer (and re-decide the rename convention —
+	* see {@link StatusEntry.toLine} for that decision). An empty array
+	* renders as the empty string.
+	*/
+	static format = (entries, options) => entries.map((entry) => entry.toLine(options)).join("\n");
+};
 /**
 * Parses `git log -1 --format=%H%x00%G?%x00%B` output: exactly two NUL
 * separators, everything after the second is the raw message, untrimmed.
@@ -20025,6 +21564,360 @@ const parseStatus = (output) => {
 	return entries;
 };
 /**
+* One line of a `git submodule status` listing.
+*
+* @remarks
+* The `state` decodes git's one-character prefix: `" "` → `"current"` (the
+* checked-out commit matches the index gitlink), `"-"` → `"uninitialized"`,
+* `"+"` → `"outOfSync"` (the checked-out commit differs from the gitlink),
+* `"U"` → `"conflict"` (merge conflicts). `describe` carries the
+* parenthesized `git describe` suffix git appends for initialized
+* submodules.
+*
+* @public
+*/
+var SubmoduleStatusEntry = class extends Schema.Class("SubmoduleStatusEntry")({
+	/** The decoded state prefix. */
+	state: Schema.Literals([
+		"current",
+		"uninitialized",
+		"outOfSync",
+		"conflict"
+	]),
+	/** The submodule's checked-out (or, uninitialized, gitlink) commit sha. */
+	sha: Schema.String,
+	/** The submodule's path relative to the superproject root. */
+	path: Schema.String,
+	/** The `git describe` suffix, present only for initialized submodules. */
+	describe: Schema.optionalKey(Schema.String)
+}) {};
+/**
+* Parses `git submodule status` output. Line-based — the one parser in this
+* package without a `-z` mode to lean on, because git does not offer one for
+* `submodule status`; a submodule path containing a newline (or a literal
+* ` (` suffix mimicking the describe parenthesis) would corrupt the parse.
+* Accepted as a git-imposed limitation.
+*/
+const parseSubmoduleStatus = (output) => {
+	const entries = [];
+	for (const line of output.split("\n")) {
+		const trimmedEnd = line.endsWith("\r") ? line.slice(0, -1) : line;
+		if (trimmedEnd === "") continue;
+		const prefix = trimmedEnd.charAt(0);
+		const state = prefix === "-" ? "uninitialized" : prefix === "+" ? "outOfSync" : prefix === "U" ? "conflict" : "current";
+		const rest = prefix === " " || prefix === "-" || prefix === "+" || prefix === "U" ? trimmedEnd.slice(1) : trimmedEnd;
+		const shaEnd = rest.indexOf(" ");
+		const sha = shaEnd === -1 ? rest : rest.slice(0, shaEnd);
+		const remainder = shaEnd === -1 ? "" : rest.slice(shaEnd + 1);
+		const describeStart = remainder.endsWith(")") ? remainder.lastIndexOf(" (") : -1;
+		if (describeStart === -1) entries.push(SubmoduleStatusEntry.make({
+			state,
+			sha,
+			path: remainder
+		}));
+		else entries.push(SubmoduleStatusEntry.make({
+			state,
+			sha,
+			path: remainder.slice(0, describeStart),
+			describe: remainder.slice(describeStart + 2, -1)
+		}));
+	}
+	return entries;
+};
+/**
+* One ref a remote advertises, from `git ls-remote`.
+*
+* @remarks
+* `ref` is the FULL refname as advertised (`refs/heads/main`,
+* `refs/tags/v1`), including the `^{}` suffix on an annotated tag's peeled
+* entry — an annotated tag appears twice, once as the tag object and once
+* peeled to its commit.
+*
+* @public
+*/
+var LsRemoteEntry = class LsRemoteEntry extends Schema.Class("LsRemoteEntry")({
+	/** The sha the advertised ref points at. */
+	sha: Schema.String,
+	/** The full advertised refname, `^{}` peel suffix included. */
+	ref: Schema.String
+}) {
+	/**
+	* The human-facing short name of an advertised refname: the
+	* `refs/heads/` / `refs/tags/` / `refs/remotes/` prefix and any `^{}`
+	* peel suffix stripped (`refs/tags/v1^{}` → `v1`).
+	*/
+	static shortName = (ref) => {
+		const base = ref.endsWith("^{}") ? ref.slice(0, -3) : ref;
+		for (const prefix of [
+			"refs/heads/",
+			"refs/tags/",
+			"refs/remotes/"
+		]) if (base.startsWith(prefix)) return base.slice(prefix.length);
+		return base;
+	};
+	/**
+	* The entries whose short name is a NEAR MISS for `ref`: not an exact
+	* match, but ending in `ref` right behind a separator (`@`, `/`, `-`,
+	* `_`) — the monorepo-prefixed-tag case, where a caller asks for
+	* `4.0.0-beta.101` and the remote advertises `effect@4.0.0-beta.101`.
+	*
+	* @remarks
+	* A pure, decode-side helper for validate-before-mutate flows: run
+	* `lsRemote`, look for the wanted ref, and when it is absent hand the
+	* listing to this to compute a suggestion. Deliberately a helper on the
+	* ENTRY value rather than behavior baked into the service — the service
+	* returns the full listing and the caller owns the matching policy. An
+	* annotated tag's peeled `^{}` entry shares its base short name, so a
+	* near miss on such a tag can surface both of its entries.
+	*/
+	static nearMatches = (entries, ref) => {
+		const separators = [
+			"@",
+			"/",
+			"-",
+			"_"
+		];
+		return entries.filter((entry) => {
+			const short = LsRemoteEntry.shortName(entry.ref);
+			if (short === ref || !short.endsWith(ref)) return false;
+			return separators.includes(short.charAt(short.length - ref.length - 1));
+		});
+	};
+};
+/**
+* Parses `git ls-remote` output: one `<sha>\t<refname>` line per advertised
+* ref. Line-based deliberately — refnames cannot contain a newline (or a
+* tab), so the split is safe without a `-z` mode (which `ls-remote` does not
+* offer).
+*/
+const parseLsRemote = (output) => output.split("\n").filter((line) => line.length > 0).map((line) => {
+	const tabIndex = line.indexOf("	");
+	return LsRemoteEntry.make({
+		sha: line.slice(0, tabIndex),
+		ref: line.slice(tabIndex + 1)
+	});
+});
+/**
+* One stash entry, from `git stash list`.
+*
+* @public
+*/
+var StashEntry = class extends Schema.Class("StashEntry")({
+	/** The reflog selector (`stash@{0}`) — the index other stash methods take. */
+	ref: Schema.String,
+	/** The stash commit's sha. */
+	sha: Schema.String,
+	/** The reflog subject: `WIP on <branch>: ...` or `On <branch>: <message>`. */
+	message: Schema.String
+}) {};
+/**
+* Parses `git stash list -z --format=%gd%x1f%H%x1f%gs` output: NUL-terminated
+* records of unit-separated (`\x1f`) fields. Reflog subjects are single-line
+* and cannot contain either separator byte.
+*/
+const parseStashList = (output) => parseNulSeparated(output).map((record) => {
+	const [ref = "", sha = "", ...rest] = record.split("");
+	return StashEntry.make({
+		ref,
+		sha,
+		message: rest.join("")
+	});
+});
+/**
+* One local (or remote-tracking) branch, from `git branch --list`.
+*
+* @public
+*/
+var BranchEntry = class extends Schema.Class("BranchEntry")({
+	/** The short branch name (`main`, or `origin/main` for a remote branch). */
+	name: Schema.String,
+	/** The branch tip's sha. */
+	sha: Schema.String,
+	/** Whether this branch is checked out in the current working tree. */
+	current: Schema.Boolean
+}) {};
+/**
+* Parses `git branch --list --format=%(HEAD)%00%(refname:short)%00%(objectname)`
+* output: newline-separated records (refnames cannot contain newlines) of
+* NUL-separated fields. The `%(HEAD)` marker is `*` for the checked-out
+* branch; anything else (` `, or `+` for a branch checked out in a linked
+* worktree) is not-current.
+*/
+const parseBranchList = (output) => output.split("\n").filter((line) => line.length > 0).map((line) => {
+	const [marker = "", name = "", sha = ""] = line.split("\0");
+	return BranchEntry.make({
+		name,
+		sha,
+		current: marker === "*"
+	});
+});
+/**
+* One ref, from `git for-each-ref`.
+*
+* @public
+*/
+var RefEntry = class extends Schema.Class("RefEntry")({
+	/** The full refname (`refs/tags/v1`). */
+	ref: Schema.String,
+	/** The sha of the object the ref points at. */
+	sha: Schema.String,
+	/**
+	* The pointed-at object's type. An annotated tag is `tag` (the tag
+	* object itself, not its target commit).
+	*/
+	objectType: Schema.Literals([
+		"commit",
+		"tag",
+		"tree",
+		"blob"
+	])
+}) {};
+/**
+* Parses `git for-each-ref --format=%(refname)%00%(objectname)%00%(objecttype)`
+* output: newline-separated records (refnames cannot contain newlines) of
+* NUL-separated fields.
+*/
+const parseForEachRef = (output) => output.split("\n").filter((line) => line.length > 0).map((line) => {
+	const [ref = "", sha = "", objectType = "commit"] = line.split("\0");
+	return RefEntry.make({
+		ref,
+		sha,
+		objectType
+	});
+});
+/**
+* One configuration entry, from `git config --list`.
+*
+* @public
+*/
+var ConfigListEntry = class extends Schema.Class("ConfigListEntry")({
+	/** The canonical dotted key (`section.subsection.key`). */
+	key: Schema.String,
+	/**
+	* The raw value. A valueless key (git's boolean-true shorthand,
+	* `[section]` + bare `key`) surfaces as the empty string — distinguish it
+	* with `configGetAll` if the difference matters.
+	*/
+	value: Schema.String
+}) {};
+/**
+* Parses `git config --list -z` output: NUL-terminated records, key separated
+* from value by the FIRST newline (a config value may itself contain
+* newlines — the reason `-z` is load-bearing). A record with no newline is a
+* valueless boolean-shorthand key.
+*/
+const parseConfigList = (output) => parseNulSeparated(output).map((record) => {
+	const newlineIndex = record.indexOf("\n");
+	return newlineIndex === -1 ? ConfigListEntry.make({
+		key: record,
+		value: ""
+	}) : ConfigListEntry.make({
+		key: record.slice(0, newlineIndex),
+		value: record.slice(newlineIndex + 1)
+	});
+});
+/**
+* One working tree, from `git worktree list --porcelain`.
+*
+* @public
+*/
+var WorktreeEntry = class extends Schema.Class("WorktreeEntry")({
+	/** The working tree's absolute path. */
+	path: Schema.String,
+	/** The checked-out commit sha; absent for a bare repository entry. */
+	head: Schema.optionalKey(Schema.String),
+	/** The checked-out branch's full refname; absent when detached or bare. */
+	branch: Schema.optionalKey(Schema.String),
+	/** Whether the working tree is in detached-HEAD state. */
+	detached: Schema.Boolean,
+	/** Whether the entry is the bare repository itself. */
+	bare: Schema.Boolean,
+	/** Present when the worktree is locked; holds the lock reason (possibly empty). */
+	locked: Schema.optionalKey(Schema.String),
+	/** Present when the worktree is prunable; holds the reason (possibly empty). */
+	prunable: Schema.optionalKey(Schema.String)
+}) {};
+/**
+* Parses `git worktree list --porcelain -z` output: NUL-terminated attribute
+* lines, one blank attribute terminating each entry. Attribute vocabulary:
+* `worktree <path>`, `HEAD <sha>`, `branch <ref>`, and the flag/annotation
+* attributes `detached`, `bare`, `locked [<reason>]`, `prunable [<reason>]`.
+*/
+const parseWorktreeList = (output) => {
+	const entries = [];
+	let path;
+	let head;
+	let branch;
+	let detached = false;
+	let bare = false;
+	let locked;
+	let prunable;
+	const flush = () => {
+		if (path !== void 0) entries.push(WorktreeEntry.make({
+			path,
+			detached,
+			bare,
+			...head !== void 0 ? { head } : {},
+			...branch !== void 0 ? { branch } : {},
+			...locked !== void 0 ? { locked } : {},
+			...prunable !== void 0 ? { prunable } : {}
+		}));
+		path = void 0;
+		head = void 0;
+		branch = void 0;
+		detached = false;
+		bare = false;
+		locked = void 0;
+		prunable = void 0;
+	};
+	for (const attribute of output.split("\0")) if (attribute === "") flush();
+	else if (attribute.startsWith("worktree ")) path = attribute.slice(9);
+	else if (attribute.startsWith("HEAD ")) head = attribute.slice(5);
+	else if (attribute.startsWith("branch ")) branch = attribute.slice(7);
+	else if (attribute === "detached") detached = true;
+	else if (attribute === "bare") bare = true;
+	else if (attribute === "locked" || attribute.startsWith("locked ")) locked = attribute === "locked" ? "" : attribute.slice(7);
+	else if (attribute === "prunable" || attribute.startsWith("prunable ")) prunable = attribute === "prunable" ? "" : attribute.slice(9);
+	flush();
+	return entries;
+};
+/**
+* One index (staging area) entry, from `git ls-files --stage`.
+*
+* @remarks
+* The index-side sibling of {@link LsTreeEntry}: this is the ONLY place a
+* staged-but-uncommitted gitlink (`mode` `160000`) is visible — `lsTree`
+* reads the committed tree and misses exactly that window.
+*
+* @public
+*/
+var LsFilesEntry = class extends Schema.Class("LsFilesEntry")({
+	/** The entry's file mode, e.g. `100644` — `160000` for a gitlink. */
+	mode: Schema.String,
+	/** The staged object id. */
+	oid: Schema.String,
+	/** The merge stage: `0` normally; `1`/`2`/`3` during an unresolved merge. */
+	stage: Schema.Number,
+	/** The entry's path, relative to `cwd`. May contain spaces or newlines. */
+	path: Schema.String
+}) {};
+/**
+* Parses `git ls-files --stage -z` output: each NUL-terminated entry is
+* `<mode> <oid> <stage>\t<path>`. `path` is everything after the first tab,
+* so a path containing spaces or newlines is preserved intact — the same
+* split rule as `parseLsTree`.
+*/
+const parseLsFiles = (output) => parseNulSeparated(output).map((entry) => {
+	const tabIndex = entry.indexOf("	");
+	const header = entry.slice(0, tabIndex).split(" ");
+	return LsFilesEntry.make({
+		mode: header[0] ?? "",
+		oid: header[1] ?? "",
+		stage: Number(header[2] ?? "0"),
+		path: entry.slice(tabIndex + 1)
+	});
+});
+/**
 * Refuse a caller-supplied ref or range that git would parse as an option.
 *
 * Refs are caller-controlled and land in git's argv as positional entries; a
@@ -20034,20 +21927,49 @@ const parseStatus = (output) => {
 * refused outright, before any spawn, as a typed {@link GitCommandError}.
 * `show`'s `path` needs no guard: it is fused after the ref into one
 * `ref:path` token, which cannot begin with `-` unless the ref does.
+*
+* `sensitive` values get the same check but a REDACTED report: a refused
+* sensitive positional (a `configSet` value) must not leak into
+* `GitCommandError.args`/`detail` any more than a spawned one may — the #86
+* redaction policy applies to guard rejections too.
 */
-const rejectOptionLikeRefs = (cwd, refs) => {
+const rejectOptionLikeRefs = (cwd, refs, sensitive = []) => {
 	const offending = refs.find((ref) => ref.startsWith("-"));
-	return offending === void 0 ? Effect.void : Effect.fail(new GitCommandError({
+	if (offending !== void 0) return Effect.fail(new GitCommandError({
 		kind: "refused",
 		args: [offending],
 		cwd,
 		stderr: "",
 		detail: `refused a ref argument git would parse as an option: ${JSON.stringify(offending)}`
 	}));
+	return sensitive.find((value) => value.startsWith("-")) === void 0 ? Effect.void : Effect.fail(new GitCommandError({
+		kind: "refused",
+		args: ["<redacted>"],
+		cwd,
+		stderr: "",
+		detail: "refused a sensitive argument git would parse as an option (value redacted)"
+	}));
 };
+/**
+* Refuse a caller-supplied numeric index/limit that is not a non-negative
+* integer.
+*
+* Every relational comparison against `NaN` is `false`, so a bare
+* `value < 0` guard admits `NaN` (and a fractional value truncates nothing —
+* it rides straight into the argv as `stash@{1.5}` / `--max-count=NaN`).
+* Integrality and range are therefore checked together, pre-spawn, as a
+* typed refusal.
+*/
+const rejectNonNaturalNumber = (cwd, label, value) => value === void 0 || Number.isInteger(value) && value >= 0 ? Effect.void : Effect.fail(new GitCommandError({
+	kind: "refused",
+	args: [String(value)],
+	cwd,
+	stderr: "",
+	detail: `refused ${label}: expected a non-negative integer, received ${value}`
+}));
 /** Builds the `Git.Service` shape over an already-resolved `ChildProcessSpawner`. */
 const make = (spawner) => {
-	const runFor = (command, cwd, kind) => runClassified(command, cwd, kind).pipe(Effect.provideService(ChildProcessSpawner.ChildProcessSpawner, spawner));
+	const runFor = (invocation, cwd, kind) => runClassified(invocation, cwd, kind).pipe(Effect.provideService(ChildProcessSpawner.ChildProcessSpawner, spawner));
 	const show = Effect.fn("Git.show")(function* (cwd, ref, path) {
 		yield* Effect.annotateCurrentSpan({
 			cwd,
@@ -20055,8 +21977,7 @@ const make = (spawner) => {
 			path
 		});
 		yield* rejectOptionLikeRefs(cwd, [ref]);
-		const command = ChildProcess.setCwd(GitCommand.show(ref, path), cwd);
-		const classified = yield* runFor(command, cwd, "show");
+		const classified = yield* runFor(GitCommand.show(ref, path), cwd, "show");
 		switch (classified._tag) {
 			case "success": return Option.some(classified.output);
 			case "absent": return Option.none();
@@ -20075,8 +21996,7 @@ const make = (spawner) => {
 			ref
 		});
 		yield* rejectOptionLikeRefs(cwd, [ref]);
-		const command = ChildProcess.setCwd(GitCommand.lsTree(ref, options?.pathspec ?? []), cwd);
-		const classified = yield* runFor(command, cwd, "generic");
+		const classified = yield* runFor(GitCommand.lsTree(ref, options?.pathspec ?? []), cwd, "generic");
 		switch (classified._tag) {
 			case "success": return parseLsTree(classified.output);
 			case "notARepository": return yield* Effect.fail(new NotARepositoryError({ cwd }));
@@ -20094,8 +22014,7 @@ const make = (spawner) => {
 			ref
 		});
 		yield* rejectOptionLikeRefs(cwd, [ref]);
-		const command = ChildProcess.setCwd(GitCommand.refExists(ref), cwd);
-		const classified = yield* runFor(command, cwd, "refExists");
+		const classified = yield* runFor(GitCommand.refExists(ref), cwd, "refExists");
 		switch (classified._tag) {
 			case "success": return true;
 			case "refMissing": return false;
@@ -20112,8 +22031,7 @@ const make = (spawner) => {
 			b
 		});
 		yield* rejectOptionLikeRefs(cwd, [a, b]);
-		const command = ChildProcess.setCwd(GitCommand.mergeBase(a, b), cwd);
-		const classified = yield* runFor(command, cwd, "generic");
+		const classified = yield* runFor(GitCommand.mergeBase(a, b), cwd, "generic");
 		switch (classified._tag) {
 			case "success": return classified.output.trim();
 			case "notARepository": return yield* Effect.fail(new NotARepositoryError({ cwd }));
@@ -20134,8 +22052,7 @@ const make = (spawner) => {
 			relative
 		});
 		yield* rejectOptionLikeRefs(cwd, [options.base, options.head]);
-		const command = ChildProcess.setCwd(GitCommand.changedFiles(options.base, options.head, relative), cwd);
-		const classified = yield* runFor(command, cwd, "generic");
+		const classified = yield* runFor(GitCommand.changedFiles(options.base, options.head, relative), cwd, "generic");
 		switch (classified._tag) {
 			case "success": return parseNulSeparated(classified.output);
 			case "notARepository": return yield* Effect.fail(new NotARepositoryError({ cwd }));
@@ -20147,8 +22064,8 @@ const make = (spawner) => {
 			default: return yield* Effect.die(`Git.changedFiles: unexpected classification "${classified._tag}"`);
 		}
 	});
-	const collectPaths = (method, command, cwd) => Effect.gen(function* () {
-		const classified = yield* runFor(command, cwd, "generic");
+	const collectPaths = (method, invocation, cwd) => Effect.gen(function* () {
+		const classified = yield* runFor(invocation, cwd, "generic");
 		switch (classified._tag) {
 			case "success": return parseNulSeparated(classified.output);
 			case "notARepository": return yield* Effect.fail(new NotARepositoryError({ cwd }));
@@ -20166,7 +22083,7 @@ const make = (spawner) => {
 			cwd,
 			relative
 		});
-		return yield* collectPaths("Git.unstagedChanges", ChildProcess.setCwd(GitCommand.unstagedChanges(relative), cwd), cwd);
+		return yield* collectPaths("Git.unstagedChanges", GitCommand.unstagedChanges(relative), cwd);
 	});
 	const stagedChanges = Effect.fn("Git.stagedChanges")(function* (cwd, options) {
 		const relative = options?.relative ?? false;
@@ -20174,7 +22091,7 @@ const make = (spawner) => {
 			cwd,
 			relative
 		});
-		return yield* collectPaths("Git.stagedChanges", ChildProcess.setCwd(GitCommand.stagedChanges(relative), cwd), cwd);
+		return yield* collectPaths("Git.stagedChanges", GitCommand.stagedChanges(relative), cwd);
 	});
 	const untrackedFiles = Effect.fn("Git.untrackedFiles")(function* (cwd, options) {
 		const relative = options?.relative ?? false;
@@ -20182,7 +22099,7 @@ const make = (spawner) => {
 			cwd,
 			relative
 		});
-		return yield* collectPaths("Git.untrackedFiles", ChildProcess.setCwd(GitCommand.untrackedFiles(relative), cwd), cwd);
+		return yield* collectPaths("Git.untrackedFiles", GitCommand.untrackedFiles(relative), cwd);
 	});
 	const workingChanges = Effect.fn("Git.workingChanges")(function* (cwd, options) {
 		yield* Effect.annotateCurrentSpan({
@@ -20207,80 +22124,669 @@ const make = (spawner) => {
 			relative
 		});
 		yield* rejectOptionLikeRefs(cwd, options.head === void 0 ? [options.base] : [options.base, options.head]);
-		const command = ChildProcess.setCwd(GitCommand.nameStatus(options.base, options.head, relative), cwd);
-		const classified = yield* runFor(command, cwd, "generic");
+		const classified = yield* runFor(GitCommand.nameStatus(options.base, options.head, relative), cwd, "generic");
+		switch (classified._tag) {
+			case "success": return parseNameStatus(classified.output);
+			case "notARepository": return yield* Effect.fail(new NotARepositoryError({ cwd }));
+			case "unknownRef": return yield* Effect.fail(new UnknownRefError({
+				ref: options.head === void 0 ? options.base : `${options.base}...${options.head}`,
+				cwd
+			}));
+			case "failure": return yield* Effect.fail(classified.error);
+			default: return yield* Effect.die(`Git.nameStatus: unexpected classification "${classified._tag}"`);
+		}
+	});
+	const revParse = Effect.fn("Git.revParse")(function* (cwd, ref) {
+		yield* Effect.annotateCurrentSpan({
+			cwd,
+			ref
+		});
+		yield* rejectOptionLikeRefs(cwd, [ref]);
+		const classified = yield* runFor(GitCommand.revParse(ref), cwd, "generic");
+		switch (classified._tag) {
+			case "success": return classified.output.trim();
+			case "notARepository": return yield* Effect.fail(new NotARepositoryError({ cwd }));
+			case "unknownRef": return yield* Effect.fail(new UnknownRefError({
+				ref,
+				cwd
+			}));
+			case "failure": return yield* Effect.fail(classified.error);
+			default: return yield* Effect.die(`Git.revParse: unexpected classification "${classified._tag}"`);
+		}
+	});
+	const checkout = Effect.fn("Git.checkout")(function* (cwd, ref, options) {
+		const detach = options?.detach ?? false;
+		yield* Effect.annotateCurrentSpan({
+			cwd,
+			ref,
+			detach
+		});
+		yield* rejectOptionLikeRefs(cwd, [ref]);
+		const classified = yield* runFor(GitCommand.checkout(ref, detach), cwd, "generic");
+		switch (classified._tag) {
+			case "success": return;
+			case "notARepository": return yield* Effect.fail(new NotARepositoryError({ cwd }));
+			case "unknownRef": return yield* Effect.fail(new UnknownRefError({
+				ref,
+				cwd
+			}));
+			case "failure": return yield* Effect.fail(classified.error);
+			default: return yield* Effect.die(`Git.checkout: unexpected classification "${classified._tag}"`);
+		}
+	});
+	const reset = Effect.fn("Git.reset")(function* (cwd, options) {
+		const mode = options?.mode ?? "mixed";
+		yield* Effect.annotateCurrentSpan({
+			cwd,
+			mode,
+			ref: options?.ref ?? "HEAD"
+		});
+		if (options?.ref !== void 0) yield* rejectOptionLikeRefs(cwd, [options.ref]);
+		const classified = yield* runFor(GitCommand.reset(mode, options?.ref), cwd, "generic");
+		switch (classified._tag) {
+			case "success": return;
+			case "notARepository": return yield* Effect.fail(new NotARepositoryError({ cwd }));
+			case "unknownRef": return yield* Effect.fail(new UnknownRefError({
+				ref: options?.ref ?? "HEAD",
+				cwd
+			}));
+			case "failure": return yield* Effect.fail(classified.error);
+			default: return yield* Effect.die(`Git.reset: unexpected classification "${classified._tag}"`);
+		}
+	});
+	const clean = Effect.fn("Git.clean")(function* (cwd, options) {
+		const directories = options?.directories ?? false;
+		const ignored = options?.ignored ?? false;
+		yield* Effect.annotateCurrentSpan({
+			cwd,
+			directories,
+			ignored
+		});
+		const classified = yield* runFor(GitCommand.clean(directories, ignored, options?.paths ?? []), cwd, "generic");
+		switch (classified._tag) {
+			case "success": return;
+			case "notARepository": return yield* Effect.fail(new NotARepositoryError({ cwd }));
+			case "unknownRef": return yield* Effect.fail(new UnknownRefError({
+				ref: "working tree",
+				cwd
+			}));
+			case "failure": return yield* Effect.fail(classified.error);
+			default: return yield* Effect.die(`Git.clean: unexpected classification "${classified._tag}"`);
+		}
+	});
+	const restore = Effect.fn("Git.restore")(function* (cwd, paths, options) {
+		yield* Effect.annotateCurrentSpan({
+			cwd,
+			count: paths.length,
+			source: options?.source ?? "(index)"
+		});
+		if (options?.source !== void 0) yield* rejectOptionLikeRefs(cwd, [options.source]);
+		const classified = yield* runFor(GitCommand.restore(paths, options?.source, options?.staged ?? false, options?.worktree ?? false), cwd, "generic");
+		switch (classified._tag) {
+			case "success": return;
+			case "notARepository": return yield* Effect.fail(new NotARepositoryError({ cwd }));
+			case "unknownRef": return yield* Effect.fail(new UnknownRefError({
+				ref: options?.source ?? "working tree",
+				cwd
+			}));
+			case "failure": return yield* Effect.fail(classified.error);
+			default: return yield* Effect.die(`Git.restore: unexpected classification "${classified._tag}"`);
+		}
+	});
+	const branchCreate = Effect.fn("Git.branchCreate")(function* (cwd, name, options) {
+		const checkoutBranch = options?.checkout ?? false;
+		const force = options?.force ?? false;
+		yield* Effect.annotateCurrentSpan({
+			cwd,
+			name,
+			startPoint: options?.startPoint ?? "HEAD",
+			checkout: checkoutBranch,
+			force
+		});
+		yield* rejectOptionLikeRefs(cwd, [name, ...options?.startPoint !== void 0 ? [options.startPoint] : []]);
+		const classified = yield* runFor(GitCommand.branchCreate(name, options?.startPoint, checkoutBranch, force), cwd, "generic");
+		switch (classified._tag) {
+			case "success": return;
+			case "notARepository": return yield* Effect.fail(new NotARepositoryError({ cwd }));
+			case "unknownRef": return yield* Effect.fail(new UnknownRefError({
+				ref: options?.startPoint ?? name,
+				cwd
+			}));
+			case "failure": return yield* Effect.fail(classified.error);
+			default: return yield* Effect.die(`Git.branchCreate: unexpected classification "${classified._tag}"`);
+		}
+	});
+	const branchDelete = Effect.fn("Git.branchDelete")(function* (cwd, name, options) {
+		yield* Effect.annotateCurrentSpan({
+			cwd,
+			name,
+			force: options?.force ?? false
+		});
+		yield* rejectOptionLikeRefs(cwd, [name]);
+		const classified = yield* runFor(GitCommand.branchDelete(name, options?.force ?? false), cwd, "generic");
+		switch (classified._tag) {
+			case "success": return;
+			case "notARepository": return yield* Effect.fail(new NotARepositoryError({ cwd }));
+			case "unknownRef": return yield* Effect.fail(new UnknownRefError({
+				ref: name,
+				cwd
+			}));
+			case "failure": return yield* Effect.fail(classified.error);
+			default: return yield* Effect.die(`Git.branchDelete: unexpected classification "${classified._tag}"`);
+		}
+	});
+	const isShallow = Effect.fn("Git.isShallow")(function* (cwd) {
+		yield* Effect.annotateCurrentSpan({ cwd });
+		const classified = yield* runFor(GitCommand.isShallow(), cwd, "generic");
+		switch (classified._tag) {
+			case "success": return classified.output.trim() === "true";
+			case "notARepository": return yield* Effect.fail(new NotARepositoryError({ cwd }));
+			case "unknownRef": return yield* Effect.fail(new UnknownRefError({
+				ref: "HEAD",
+				cwd
+			}));
+			case "failure": return yield* Effect.fail(classified.error);
+			default: return yield* Effect.die(`Git.isShallow: unexpected classification "${classified._tag}"`);
+		}
+	});
+	const fetchUnshallow = Effect.fn("Git.fetchUnshallow")(function* (cwd, options) {
+		const remote = options?.remote ?? "origin";
+		yield* Effect.annotateCurrentSpan({ cwd });
+		yield* rejectOptionLikeRefs(cwd, [remote]);
+		const classified = yield* runFor(GitCommand.fetchUnshallow(remote), cwd, "generic");
+		switch (classified._tag) {
+			case "success": return;
+			case "notARepository": return yield* Effect.fail(new NotARepositoryError({ cwd }));
+			case "unknownRef": return yield* Effect.fail(new UnknownRefError({
+				ref: "--unshallow",
+				cwd
+			}));
+			case "failure": return yield* Effect.fail(classified.error);
+			default: return yield* Effect.die(`Git.fetchUnshallow: unexpected classification "${classified._tag}"`);
+		}
+	});
+	const fetch = Effect.fn("Git.fetch")(function* (cwd, options) {
+		const remote = options.remote ?? "origin";
+		const tag = options.tag ?? false;
+		yield* Effect.annotateCurrentSpan({
+			cwd,
+			ref: options.ref,
+			tag
+		});
+		yield* rejectOptionLikeRefs(cwd, [remote, options.ref]);
+		yield* rejectNonNaturalNumber(cwd, "a fetch depth", options.depth);
+		const classified = yield* runFor(GitCommand.fetch(remote, options.ref, options.depth, tag), cwd, "generic");
+		switch (classified._tag) {
+			case "success": return;
+			case "notARepository": return yield* Effect.fail(new NotARepositoryError({ cwd }));
+			case "unknownRef": return yield* Effect.fail(new UnknownRefError({
+				ref: options.ref,
+				cwd
+			}));
+			case "failure": return yield* Effect.fail(classified.error);
+			default: return yield* Effect.die(`Git.fetch: unexpected classification "${classified._tag}"`);
+		}
+	});
+	const fetchAny = Effect.fn("Git.fetchAny")(function* (cwd, options) {
+		yield* Effect.annotateCurrentSpan({
+			cwd,
+			ref: options.ref
+		});
+		return yield* fetch(cwd, {
+			...options,
+			tag: true
+		}).pipe(Effect.catchTag(["UnknownRefError", "GitCommandError"], (error) => error._tag === "GitCommandError" && error.kind === "refused" ? Effect.fail(error) : fetch(cwd, options)));
+	});
+	const submoduleUpdate = Effect.fn("Git.submoduleUpdate")(function* (cwd, options) {
+		const init = options?.init ?? false;
+		yield* Effect.annotateCurrentSpan({
+			cwd,
+			init
+		});
+		yield* rejectNonNaturalNumber(cwd, "a submodule update depth", options?.depth);
+		const classified = yield* runFor(GitCommand.submoduleUpdate(init, options?.depth, options?.paths ?? []), cwd, "generic");
+		switch (classified._tag) {
+			case "success": return;
+			case "notARepository": return yield* Effect.fail(new NotARepositoryError({ cwd }));
+			case "unknownRef": return yield* Effect.fail(new UnknownRefError({
+				ref: "submodule update",
+				cwd
+			}));
+			case "failure": return yield* Effect.fail(classified.error);
+			default: return yield* Effect.die(`Git.submoduleUpdate: unexpected classification "${classified._tag}"`);
+		}
+	});
+	const submoduleAdd = Effect.fn("Git.submoduleAdd")(function* (cwd, options) {
+		yield* Effect.annotateCurrentSpan({
+			cwd,
+			path: options.path
+		});
+		yield* rejectNonNaturalNumber(cwd, "a submodule add depth", options.depth);
+		const classified = yield* runFor(GitCommand.submoduleAdd(options.url, options.path, options.depth), cwd, "generic");
+		switch (classified._tag) {
+			case "success": return;
+			case "notARepository": return yield* Effect.fail(new NotARepositoryError({ cwd }));
+			case "unknownRef": return yield* Effect.fail(new UnknownRefError({
+				ref: options.path,
+				cwd
+			}));
+			case "failure": return yield* Effect.fail(classified.error);
+			default: return yield* Effect.die(`Git.submoduleAdd: unexpected classification "${classified._tag}"`);
+		}
+	});
+	const sparseCheckoutSet = Effect.fn("Git.sparseCheckoutSet")(function* (cwd, patterns, options) {
+		yield* Effect.annotateCurrentSpan({
+			cwd,
+			cone: options.cone
+		});
+		yield* rejectOptionLikeRefs(cwd, patterns);
+		const classified = yield* runFor(GitCommand.sparseCheckoutSet(patterns, options.cone), cwd, "generic");
+		switch (classified._tag) {
+			case "success": return;
+			case "notARepository": return yield* Effect.fail(new NotARepositoryError({ cwd }));
+			case "unknownRef": return yield* Effect.fail(new UnknownRefError({
+				ref: "sparse-checkout",
+				cwd
+			}));
+			case "failure": return yield* Effect.fail(classified.error);
+			default: return yield* Effect.die(`Git.sparseCheckoutSet: unexpected classification "${classified._tag}"`);
+		}
+	});
+	const configSet = Effect.fn("Git.configSet")(function* (cwd, key, value, options) {
+		yield* Effect.annotateCurrentSpan({
+			cwd,
+			key,
+			file: options?.file ?? "(repository config)"
+		});
+		yield* rejectOptionLikeRefs(cwd, [key, ...options?.file !== void 0 ? [options.file] : []], [value]);
+		const classified = yield* runFor(GitCommand.configSet(key, value, options?.file), cwd, "generic");
+		switch (classified._tag) {
+			case "success": return;
+			case "notARepository": return yield* Effect.fail(new NotARepositoryError({ cwd }));
+			case "unknownRef": return yield* Effect.fail(new UnknownRefError({
+				ref: key,
+				cwd
+			}));
+			case "failure": return yield* Effect.fail(classified.error);
+			default: return yield* Effect.die(`Git.configSet: unexpected classification "${classified._tag}"`);
+		}
+	});
+	const add = Effect.fn("Git.add")(function* (cwd, paths) {
+		yield* Effect.annotateCurrentSpan({
+			cwd,
+			count: paths.length
+		});
+		const classified = yield* runFor(GitCommand.add(paths), cwd, "generic");
+		switch (classified._tag) {
+			case "success": return;
+			case "notARepository": return yield* Effect.fail(new NotARepositoryError({ cwd }));
+			case "unknownRef": return yield* Effect.fail(new UnknownRefError({
+				ref: "working tree",
+				cwd
+			}));
+			case "failure": return yield* Effect.fail(classified.error);
+			default: return yield* Effect.die(`Git.add: unexpected classification "${classified._tag}"`);
+		}
+	});
+	const defaultBranch = Effect.fn("Git.defaultBranch")(function* (cwd, options) {
+		const remote = options?.remote ?? "origin";
+		yield* Effect.annotateCurrentSpan({
+			cwd,
+			remote
+		});
+		yield* rejectOptionLikeRefs(cwd, [remote]);
+		const classified = yield* runFor(GitCommand.defaultBranch(remote), cwd, "quiet");
+		switch (classified._tag) {
+			case "success": {
+				const short = classified.output.trim();
+				const prefix = `${remote}/`;
+				return Option.some(short.startsWith(prefix) ? short.slice(prefix.length) : short);
+			}
+			case "absent": return Option.none();
+			case "notARepository": return yield* Effect.fail(new NotARepositoryError({ cwd }));
+			case "unknownRef": return yield* Effect.fail(new UnknownRefError({
+				ref: `refs/remotes/${remote}/HEAD`,
+				cwd
+			}));
+			case "failure": return yield* Effect.fail(classified.error);
+			default: return yield* Effect.die(`Git.defaultBranch: unexpected classification "${classified._tag}"`);
+		}
+	});
+	const currentBranch = Effect.fn("Git.currentBranch")(function* (cwd) {
+		yield* Effect.annotateCurrentSpan({ cwd });
+		const classified = yield* runFor(GitCommand.currentBranch(), cwd, "generic");
+		switch (classified._tag) {
+			case "success": {
+				const name = classified.output.trim();
+				return name === "HEAD" ? Option.none() : Option.some(name);
+			}
+			case "notARepository": return yield* Effect.fail(new NotARepositoryError({ cwd }));
+			case "unknownRef": return yield* Effect.fail(new UnknownRefError({
+				ref: "HEAD",
+				cwd
+			}));
+			case "failure": return yield* Effect.fail(classified.error);
+			default: return yield* Effect.die(`Git.currentBranch: unexpected classification "${classified._tag}"`);
+		}
+	});
+	const repoRoot = Effect.fn("Git.repoRoot")(function* (cwd) {
+		yield* Effect.annotateCurrentSpan({ cwd });
+		const classified = yield* runFor(GitCommand.repoRoot(), cwd, "generic");
+		switch (classified._tag) {
+			case "success": return classified.output.trim();
+			case "notARepository": return yield* Effect.fail(new NotARepositoryError({ cwd }));
+			case "unknownRef": return yield* Effect.fail(new UnknownRefError({
+				ref: "working tree",
+				cwd
+			}));
+			case "failure": return yield* Effect.fail(classified.error);
+			default: return yield* Effect.die(`Git.repoRoot: unexpected classification "${classified._tag}"`);
+		}
+	});
+	const configGet = Effect.fn("Git.configGet")(function* (cwd, key) {
+		yield* Effect.annotateCurrentSpan({
+			cwd,
+			key
+		});
+		yield* rejectOptionLikeRefs(cwd, [key]);
+		const classified = yield* runFor(GitCommand.configGet(key), cwd, "quiet");
+		switch (classified._tag) {
+			case "success": return Option.some(classified.output.trim());
+			case "absent": return Option.none();
+			case "notARepository": return yield* Effect.fail(new NotARepositoryError({ cwd }));
+			case "unknownRef": return yield* Effect.fail(new UnknownRefError({
+				ref: key,
+				cwd
+			}));
+			case "failure": return yield* Effect.fail(classified.error);
+			default: return yield* Effect.die(`Git.configGet: unexpected classification "${classified._tag}"`);
+		}
+	});
+	const remoteUrl = Effect.fn("Git.remoteUrl")(function* (cwd, options) {
+		const remote = options?.remote ?? "origin";
+		yield* Effect.annotateCurrentSpan({
+			cwd,
+			remote
+		});
+		yield* rejectOptionLikeRefs(cwd, [remote]);
+		const classified = yield* runFor(GitCommand.remoteUrl(remote), cwd, "noSuchRemote");
+		switch (classified._tag) {
+			case "success": return Option.some(classified.output.trim());
+			case "absent": return Option.none();
+			case "notARepository": return yield* Effect.fail(new NotARepositoryError({ cwd }));
+			case "unknownRef": return yield* Effect.fail(new UnknownRefError({
+				ref: remote,
+				cwd
+			}));
+			case "failure": return yield* Effect.fail(classified.error);
+			default: return yield* Effect.die(`Git.remoteUrl: unexpected classification "${classified._tag}"`);
+		}
+	});
+	const commitInfo = Effect.fn("Git.commitInfo")(function* (cwd, ref) {
+		const target = ref ?? "HEAD";
+		yield* Effect.annotateCurrentSpan({
+			cwd,
+			ref: target
+		});
+		yield* rejectOptionLikeRefs(cwd, [target]);
+		const classified = yield* runFor(GitCommand.commitInfo(target), cwd, "generic");
+		switch (classified._tag) {
+			case "success": return parseCommitInfo(classified.output);
+			case "notARepository": return yield* Effect.fail(new NotARepositoryError({ cwd }));
+			case "unknownRef": return yield* Effect.fail(new UnknownRefError({
+				ref: target,
+				cwd
+			}));
+			case "failure": return yield* Effect.fail(classified.error);
+			default: return yield* Effect.die(`Git.commitInfo: unexpected classification "${classified._tag}"`);
+		}
+	});
+	const status = Effect.fn("Git.status")(function* (cwd) {
+		yield* Effect.annotateCurrentSpan({ cwd });
+		const classified = yield* runFor(GitCommand.status(), cwd, "generic");
+		switch (classified._tag) {
+			case "success": return parseStatus(classified.output);
+			case "notARepository": return yield* Effect.fail(new NotARepositoryError({ cwd }));
+			case "unknownRef": return yield* Effect.fail(new UnknownRefError({
+				ref: "working tree",
+				cwd
+			}));
+			case "failure": return yield* Effect.fail(classified.error);
+			default: return yield* Effect.die(`Git.status: unexpected classification "${classified._tag}"`);
+		}
+	});
+	const submoduleStatus = Effect.fn("Git.submoduleStatus")(function* (cwd, options) {
+		yield* Effect.annotateCurrentSpan({
+			cwd,
+			recursive: options?.recursive ?? false
+		});
+		const classified = yield* runFor(GitCommand.submoduleStatus(options?.paths ?? [], options?.recursive ?? false), cwd, "generic");
+		switch (classified._tag) {
+			case "success": return parseSubmoduleStatus(classified.output);
+			case "notARepository": return yield* Effect.fail(new NotARepositoryError({ cwd }));
+			case "unknownRef": return yield* Effect.fail(new UnknownRefError({
+				ref: "submodule status",
+				cwd
+			}));
+			case "failure": return yield* Effect.fail(classified.error);
+			default: return yield* Effect.die(`Git.submoduleStatus: unexpected classification "${classified._tag}"`);
+		}
+	});
+	const submoduleInit = Effect.fn("Git.submoduleInit")(function* (cwd, options) {
+		yield* Effect.annotateCurrentSpan({ cwd });
+		const classified = yield* runFor(GitCommand.submoduleInit(options?.paths ?? []), cwd, "generic");
+		switch (classified._tag) {
+			case "success": return;
+			case "notARepository": return yield* Effect.fail(new NotARepositoryError({ cwd }));
+			case "unknownRef": return yield* Effect.fail(new UnknownRefError({
+				ref: "submodule init",
+				cwd
+			}));
+			case "failure": return yield* Effect.fail(classified.error);
+			default: return yield* Effect.die(`Git.submoduleInit: unexpected classification "${classified._tag}"`);
+		}
+	});
+	const submoduleDeinit = Effect.fn("Git.submoduleDeinit")(function* (cwd, options) {
+		const paths = options.paths ?? [];
+		const all = options.all ?? false;
+		yield* Effect.annotateCurrentSpan({
+			cwd,
+			all,
+			count: paths.length
+		});
+		if (!all && paths.length === 0) return yield* Effect.fail(new GitCommandError({
+			kind: "refused",
+			args: ["submodule", "deinit"],
+			cwd,
+			stderr: "",
+			detail: "refused: submoduleDeinit needs either paths or all: true"
+		}));
+		const classified = yield* runFor(GitCommand.submoduleDeinit(paths, all, options.force ?? false), cwd, "generic");
+		switch (classified._tag) {
+			case "success": return;
+			case "notARepository": return yield* Effect.fail(new NotARepositoryError({ cwd }));
+			case "unknownRef": return yield* Effect.fail(new UnknownRefError({
+				ref: "submodule deinit",
+				cwd
+			}));
+			case "failure": return yield* Effect.fail(classified.error);
+			default: return yield* Effect.die(`Git.submoduleDeinit: unexpected classification "${classified._tag}"`);
+		}
+	});
+	const submoduleSync = Effect.fn("Git.submoduleSync")(function* (cwd, options) {
+		yield* Effect.annotateCurrentSpan({
+			cwd,
+			recursive: options?.recursive ?? false
+		});
+		const classified = yield* runFor(GitCommand.submoduleSync(options?.paths ?? [], options?.recursive ?? false), cwd, "generic");
+		switch (classified._tag) {
+			case "success": return;
+			case "notARepository": return yield* Effect.fail(new NotARepositoryError({ cwd }));
+			case "unknownRef": return yield* Effect.fail(new UnknownRefError({
+				ref: "submodule sync",
+				cwd
+			}));
+			case "failure": return yield* Effect.fail(classified.error);
+			default: return yield* Effect.die(`Git.submoduleSync: unexpected classification "${classified._tag}"`);
+		}
+	});
+	const submoduleSetUrl = Effect.fn("Git.submoduleSetUrl")(function* (cwd, path, url) {
+		yield* Effect.annotateCurrentSpan({
+			cwd,
+			path
+		});
+		const classified = yield* runFor(GitCommand.submoduleSetUrl(path, url), cwd, "generic");
+		switch (classified._tag) {
+			case "success": return;
+			case "notARepository": return yield* Effect.fail(new NotARepositoryError({ cwd }));
+			case "unknownRef": return yield* Effect.fail(new UnknownRefError({
+				ref: path,
+				cwd
+			}));
+			case "failure": return yield* Effect.fail(classified.error);
+			default: return yield* Effect.die(`Git.submoduleSetUrl: unexpected classification "${classified._tag}"`);
+		}
+	});
+	const submoduleSetBranch = Effect.fn("Git.submoduleSetBranch")(function* (cwd, path, options) {
+		const branch = options?.branch;
+		yield* Effect.annotateCurrentSpan({
+			cwd,
+			path,
+			branch: branch ?? "(default)"
+		});
+		if (branch !== void 0) yield* rejectOptionLikeRefs(cwd, [branch]);
+		const classified = yield* runFor(GitCommand.submoduleSetBranch(path, branch), cwd, "generic");
+		switch (classified._tag) {
+			case "success": return;
+			case "notARepository": return yield* Effect.fail(new NotARepositoryError({ cwd }));
+			case "unknownRef": return yield* Effect.fail(new UnknownRefError({
+				ref: branch ?? path,
+				cwd
+			}));
+			case "failure": return yield* Effect.fail(classified.error);
+			default: return yield* Effect.die(`Git.submoduleSetBranch: unexpected classification "${classified._tag}"`);
+		}
+	});
+	const submoduleAbsorbgitdirs = Effect.fn("Git.submoduleAbsorbgitdirs")(function* (cwd, options) {
+		yield* Effect.annotateCurrentSpan({ cwd });
+		const classified = yield* runFor(GitCommand.submoduleAbsorbgitdirs(options?.paths ?? []), cwd, "generic");
 		switch (classified._tag) {
-			case "success": return parseNameStatus(classified.output);
+			case "success": return;
 			case "notARepository": return yield* Effect.fail(new NotARepositoryError({ cwd }));
 			case "unknownRef": return yield* Effect.fail(new UnknownRefError({
-				ref: options.head === void 0 ? options.base : `${options.base}...${options.head}`,
+				ref: "submodule absorbgitdirs",
 				cwd
 			}));
 			case "failure": return yield* Effect.fail(classified.error);
-			default: return yield* Effect.die(`Git.nameStatus: unexpected classification "${classified._tag}"`);
+			default: return yield* Effect.die(`Git.submoduleAbsorbgitdirs: unexpected classification "${classified._tag}"`);
 		}
 	});
-	const revParse = Effect.fn("Git.revParse")(function* (cwd, ref) {
+	const submoduleForeach = Effect.fn("Git.submoduleForeach")(function* (cwd, command, options) {
 		yield* Effect.annotateCurrentSpan({
 			cwd,
-			ref
+			recursive: options?.recursive ?? false
 		});
-		yield* rejectOptionLikeRefs(cwd, [ref]);
-		const command = ChildProcess.setCwd(GitCommand.revParse(ref), cwd);
-		const classified = yield* runFor(command, cwd, "generic");
+		yield* rejectOptionLikeRefs(cwd, [command]);
+		const classified = yield* runFor(GitCommand.submoduleForeach(command, options?.recursive ?? false), cwd, "generic");
 		switch (classified._tag) {
-			case "success": return classified.output.trim();
+			case "success": return classified.output;
 			case "notARepository": return yield* Effect.fail(new NotARepositoryError({ cwd }));
 			case "unknownRef": return yield* Effect.fail(new UnknownRefError({
-				ref,
+				ref: "submodule foreach",
 				cwd
 			}));
 			case "failure": return yield* Effect.fail(classified.error);
-			default: return yield* Effect.die(`Git.revParse: unexpected classification "${classified._tag}"`);
+			default: return yield* Effect.die(`Git.submoduleForeach: unexpected classification "${classified._tag}"`);
 		}
 	});
-	const checkout = Effect.fn("Git.checkout")(function* (cwd, ref, options) {
-		const detach = options?.detach ?? false;
-		yield* Effect.annotateCurrentSpan({
-			cwd,
-			ref,
-			detach
-		});
-		yield* rejectOptionLikeRefs(cwd, [ref]);
-		const command = ChildProcess.setCwd(GitCommand.checkout(ref, detach), cwd);
-		const classified = yield* runFor(command, cwd, "generic");
+	const runVoid = (method, invocation, cwd, refLabel) => Effect.gen(function* () {
+		const classified = yield* runFor(invocation, cwd, "generic");
 		switch (classified._tag) {
 			case "success": return;
 			case "notARepository": return yield* Effect.fail(new NotARepositoryError({ cwd }));
 			case "unknownRef": return yield* Effect.fail(new UnknownRefError({
-				ref,
+				ref: refLabel,
 				cwd
 			}));
 			case "failure": return yield* Effect.fail(classified.error);
-			default: return yield* Effect.die(`Git.checkout: unexpected classification "${classified._tag}"`);
+			default: return yield* Effect.die(`${method}: unexpected classification "${classified._tag}"`);
 		}
 	});
-	const fetch = Effect.fn("Git.fetch")(function* (cwd, options) {
-		const remote = options.remote ?? "origin";
-		const tag = options.tag ?? false;
+	const runParsed = (method, invocation, cwd, refLabel, kind, parse, absent) => Effect.gen(function* () {
+		const classified = yield* runFor(invocation, cwd, kind);
+		switch (classified._tag) {
+			case "success": return parse(classified.output);
+			case "absent":
+				if (absent !== void 0) return absent();
+				return yield* Effect.die(`${method}: unexpected classification "absent"`);
+			case "notARepository": return yield* Effect.fail(new NotARepositoryError({ cwd }));
+			case "unknownRef": return yield* Effect.fail(new UnknownRefError({
+				ref: refLabel,
+				cwd
+			}));
+			case "failure": return yield* Effect.fail(classified.error);
+			default: return yield* Effect.die(`${method}: unexpected classification "${classified._tag}"`);
+		}
+	});
+	const lsRemote = Effect.fn("Git.lsRemote")(function* (cwd, remote, options) {
 		yield* Effect.annotateCurrentSpan({
 			cwd,
-			remote,
-			ref: options.ref,
-			tag
+			heads: options?.heads ?? false,
+			tags: options?.tags ?? false,
+			patterns: (options?.patterns ?? []).length
 		});
-		yield* rejectOptionLikeRefs(cwd, [remote, options.ref]);
-		const command = ChildProcess.setCwd(GitCommand.fetch(remote, options.ref, options.depth, tag), cwd);
-		const classified = yield* runFor(command, cwd, "generic");
+		yield* rejectOptionLikeRefs(cwd, [remote, ...options?.patterns ?? []]);
+		return yield* runParsed("Git.lsRemote", GitCommand.lsRemote(remote, options?.heads ?? false, options?.tags ?? false, options?.patterns ?? []), cwd, "ls-remote", "generic", parseLsRemote);
+	});
+	const remoteAdd = Effect.fn("Git.remoteAdd")(function* (cwd, name, url) {
+		yield* Effect.annotateCurrentSpan({
+			cwd,
+			name
+		});
+		yield* rejectOptionLikeRefs(cwd, [name, url]);
+		return yield* runVoid("Git.remoteAdd", GitCommand.remoteAdd(name, url), cwd, name);
+	});
+	const remoteRemove = Effect.fn("Git.remoteRemove")(function* (cwd, name) {
+		yield* Effect.annotateCurrentSpan({
+			cwd,
+			name
+		});
+		yield* rejectOptionLikeRefs(cwd, [name]);
+		return yield* runVoid("Git.remoteRemove", GitCommand.remoteRemove(name), cwd, name);
+	});
+	const remoteSetUrl = Effect.fn("Git.remoteSetUrl")(function* (cwd, name, url) {
+		yield* Effect.annotateCurrentSpan({
+			cwd,
+			name
+		});
+		yield* rejectOptionLikeRefs(cwd, [name, url]);
+		return yield* runVoid("Git.remoteSetUrl", GitCommand.remoteSetUrl(name, url), cwd, name);
+	});
+	const stashPush = Effect.fn("Git.stashPush")(function* (cwd, options) {
+		yield* Effect.annotateCurrentSpan({
+			cwd,
+			includeUntracked: options?.includeUntracked ?? false
+		});
+		return yield* runVoid("Git.stashPush", GitCommand.stashPush(options?.message, options?.includeUntracked ?? false, options?.paths ?? []), cwd, "stash");
+	});
+	const stashRestore = (method, invocation) => Effect.fn(method)(function* (cwd, options) {
+		yield* Effect.annotateCurrentSpan({
+			cwd,
+			index: options?.index ?? 0
+		});
+		yield* rejectNonNaturalNumber(cwd, "a stash index", options?.index);
+		const classified = yield* runFor(invocation(options?.index), cwd, "merge");
 		switch (classified._tag) {
 			case "success": return;
+			case "dirtyWorktree": return yield* Effect.fail(new DirtyWorktreeError({ cwd }));
+			case "mergeConflict": return yield* Effect.fail(new MergeConflictError({ cwd }));
 			case "notARepository": return yield* Effect.fail(new NotARepositoryError({ cwd }));
 			case "unknownRef": return yield* Effect.fail(new UnknownRefError({
-				ref: options.ref,
+				ref: "stash",
 				cwd
 			}));
 			case "failure": return yield* Effect.fail(classified.error);
-			default: return yield* Effect.die(`Git.fetch: unexpected classification "${classified._tag}"`);
+			default: return yield* Effect.die(`${method}: unexpected classification "${classified._tag}"`);
 		}
 	});
 	return {
@@ -20293,254 +22799,235 @@ const make = (spawner) => {
 		revParse,
 		checkout,
 		fetch,
-		fetchAny: Effect.fn("Git.fetchAny")(function* (cwd, options) {
-			const remote = options.remote ?? "origin";
+		fetchAny,
+		fetchUnshallow,
+		isShallow,
+		reset,
+		clean,
+		restore,
+		branchCreate,
+		branchDelete,
+		submoduleUpdate,
+		submoduleAdd,
+		submoduleStatus,
+		submoduleInit,
+		submoduleDeinit,
+		submoduleSync,
+		submoduleSetUrl,
+		submoduleSetBranch,
+		submoduleAbsorbgitdirs,
+		submoduleForeach,
+		sparseCheckoutSet,
+		configSet,
+		add,
+		nameStatus,
+		unstagedChanges,
+		stagedChanges,
+		untrackedFiles,
+		defaultBranch,
+		currentBranch,
+		repoRoot,
+		configGet,
+		remoteUrl,
+		commitInfo,
+		status,
+		lsRemote,
+		remoteAdd,
+		remoteRemove,
+		remoteSetUrl,
+		stashPush,
+		stashPop: stashRestore("Git.stashPop", GitCommand.stashPop),
+		stashApply: stashRestore("Git.stashApply", GitCommand.stashApply),
+		stashDrop: Effect.fn("Git.stashDrop")(function* (cwd, options) {
 			yield* Effect.annotateCurrentSpan({
 				cwd,
-				remote,
-				ref: options.ref
+				index: options?.index ?? 0
 			});
-			return yield* fetch(cwd, {
-				...options,
-				tag: true
-			}).pipe(Effect.catchTag(["UnknownRefError", "GitCommandError"], (error) => error._tag === "GitCommandError" && error.kind === "refused" ? Effect.fail(error) : fetch(cwd, options)));
+			yield* rejectNonNaturalNumber(cwd, "a stash index", options?.index);
+			return yield* runVoid("Git.stashDrop", GitCommand.stashDrop(options?.index), cwd, "stash");
+		}),
+		stashList: Effect.fn("Git.stashList")(function* (cwd) {
+			yield* Effect.annotateCurrentSpan({ cwd });
+			return yield* runParsed("Git.stashList", GitCommand.stashList(), cwd, "stash", "generic", parseStashList);
 		}),
-		submoduleUpdate: Effect.fn("Git.submoduleUpdate")(function* (cwd, options) {
-			const init = options?.init ?? false;
+		branchList: Effect.fn("Git.branchList")(function* (cwd, options) {
 			yield* Effect.annotateCurrentSpan({
 				cwd,
-				init
+				remotes: options?.remotes ?? false,
+				all: options?.all ?? false
 			});
-			const command = ChildProcess.setCwd(GitCommand.submoduleUpdate(init, options?.depth, options?.paths ?? []), cwd);
-			const classified = yield* runFor(command, cwd, "generic");
-			switch (classified._tag) {
-				case "success": return;
-				case "notARepository": return yield* Effect.fail(new NotARepositoryError({ cwd }));
-				case "unknownRef": return yield* Effect.fail(new UnknownRefError({
-					ref: "submodule update",
-					cwd
-				}));
-				case "failure": return yield* Effect.fail(classified.error);
-				default: return yield* Effect.die(`Git.submoduleUpdate: unexpected classification "${classified._tag}"`);
-			}
+			return yield* runParsed("Git.branchList", GitCommand.branchList(options?.remotes ?? false, options?.all ?? false), cwd, "branches", "generic", parseBranchList);
 		}),
-		submoduleAdd: Effect.fn("Git.submoduleAdd")(function* (cwd, options) {
+		tagCreate: Effect.fn("Git.tagCreate")(function* (cwd, name, options) {
 			yield* Effect.annotateCurrentSpan({
 				cwd,
-				url: options.url,
-				path: options.path
+				name,
+				ref: options?.ref ?? "HEAD",
+				force: options?.force ?? false
 			});
-			const command = ChildProcess.setCwd(GitCommand.submoduleAdd(options.url, options.path, options.depth), cwd);
-			const classified = yield* runFor(command, cwd, "generic");
-			switch (classified._tag) {
-				case "success": return;
-				case "notARepository": return yield* Effect.fail(new NotARepositoryError({ cwd }));
-				case "unknownRef": return yield* Effect.fail(new UnknownRefError({
-					ref: options.url,
-					cwd
-				}));
-				case "failure": return yield* Effect.fail(classified.error);
-				default: return yield* Effect.die(`Git.submoduleAdd: unexpected classification "${classified._tag}"`);
-			}
+			yield* rejectOptionLikeRefs(cwd, [name, ...options?.ref !== void 0 ? [options.ref] : []]);
+			return yield* runVoid("Git.tagCreate", GitCommand.tagCreate(name, options?.ref, options?.message, options?.force ?? false), cwd, options?.ref ?? name);
 		}),
-		sparseCheckoutSet: Effect.fn("Git.sparseCheckoutSet")(function* (cwd, patterns, options) {
+		tagDelete: Effect.fn("Git.tagDelete")(function* (cwd, name) {
 			yield* Effect.annotateCurrentSpan({
 				cwd,
-				cone: options.cone
+				name
 			});
-			yield* rejectOptionLikeRefs(cwd, patterns);
-			const command = ChildProcess.setCwd(GitCommand.sparseCheckoutSet(patterns, options.cone), cwd);
-			const classified = yield* runFor(command, cwd, "generic");
-			switch (classified._tag) {
-				case "success": return;
-				case "notARepository": return yield* Effect.fail(new NotARepositoryError({ cwd }));
-				case "unknownRef": return yield* Effect.fail(new UnknownRefError({
-					ref: "sparse-checkout",
-					cwd
-				}));
-				case "failure": return yield* Effect.fail(classified.error);
-				default: return yield* Effect.die(`Git.sparseCheckoutSet: unexpected classification "${classified._tag}"`);
-			}
+			yield* rejectOptionLikeRefs(cwd, [name]);
+			return yield* runVoid("Git.tagDelete", GitCommand.tagDelete(name), cwd, name);
+		}),
+		tagList: Effect.fn("Git.tagList")(function* (cwd, options) {
+			yield* Effect.annotateCurrentSpan({ cwd });
+			yield* rejectOptionLikeRefs(cwd, options?.pattern !== void 0 ? [options.pattern] : []);
+			return yield* runParsed("Git.tagList", GitCommand.tagList(options?.pattern), cwd, "tags", "generic", (output) => output.split("\n").filter((line) => line.length > 0));
 		}),
-		configSet: Effect.fn("Git.configSet")(function* (cwd, key, value, options) {
+		forEachRef: Effect.fn("Git.forEachRef")(function* (cwd, options) {
 			yield* Effect.annotateCurrentSpan({
 				cwd,
-				key,
-				file: options?.file ?? "(repository config)"
+				patterns: (options?.patterns ?? []).length
 			});
-			yield* rejectOptionLikeRefs(cwd, [
-				key,
-				value,
-				...options?.file !== void 0 ? [options.file] : []
-			]);
-			const command = ChildProcess.setCwd(GitCommand.configSet(key, value, options?.file), cwd);
-			const classified = yield* runFor(command, cwd, "generic");
-			switch (classified._tag) {
-				case "success": return;
-				case "notARepository": return yield* Effect.fail(new NotARepositoryError({ cwd }));
-				case "unknownRef": return yield* Effect.fail(new UnknownRefError({
-					ref: key,
-					cwd
-				}));
-				case "failure": return yield* Effect.fail(classified.error);
-				default: return yield* Effect.die(`Git.configSet: unexpected classification "${classified._tag}"`);
-			}
+			yield* rejectOptionLikeRefs(cwd, options?.patterns ?? []);
+			return yield* runParsed("Git.forEachRef", GitCommand.forEachRef(options?.patterns ?? []), cwd, "for-each-ref", "generic", parseForEachRef);
 		}),
-		add: Effect.fn("Git.add")(function* (cwd, paths) {
+		revList: Effect.fn("Git.revList")(function* (cwd, ref, options) {
 			yield* Effect.annotateCurrentSpan({
 				cwd,
-				count: paths.length
+				ref,
+				firstParent: options?.firstParent ?? false
+			});
+			yield* rejectOptionLikeRefs(cwd, [ref]);
+			yield* rejectNonNaturalNumber(cwd, "a rev-list limit", options?.limit);
+			return yield* runParsed("Git.revList", GitCommand.revList(ref, options?.limit, options?.firstParent ?? false), cwd, ref, "generic", (output) => output.split("\n").filter((line) => line.length > 0));
+		}),
+		commit: Effect.fn("Git.commit")(function* (cwd, message, options) {
+			yield* Effect.annotateCurrentSpan({
+				cwd,
+				amend: options?.amend ?? false
+			});
+			return yield* runVoid("Git.commit", GitCommand.commit(message, options?.all ?? false, options?.allowEmpty ?? false, options?.amend ?? false, options?.author), cwd, "HEAD");
+		}),
+		push: Effect.fn("Git.push")(function* (cwd, options) {
+			const remote = options?.remote ?? "origin";
+			yield* Effect.annotateCurrentSpan({
+				cwd,
+				refspec: options?.refspec ?? "(current branch)",
+				forceWithLease: options?.forceWithLease ?? false
 			});
-			const command = ChildProcess.setCwd(GitCommand.add(paths), cwd);
-			const classified = yield* runFor(command, cwd, "generic");
+			yield* rejectOptionLikeRefs(cwd, [remote, ...options?.refspec !== void 0 ? [options.refspec] : []]);
+			const classified = yield* runFor(GitCommand.push(remote, options?.refspec, options?.force ?? false, options?.forceWithLease ?? false, options?.tags ?? false, options?.setUpstream ?? false), cwd, "push");
 			switch (classified._tag) {
 				case "success": return;
+				case "nonFastForward": return yield* Effect.fail(new NonFastForwardError({
+					cwd,
+					...options?.refspec !== void 0 ? { refspec: options.refspec } : {}
+				}));
 				case "notARepository": return yield* Effect.fail(new NotARepositoryError({ cwd }));
 				case "unknownRef": return yield* Effect.fail(new UnknownRefError({
-					ref: "working tree",
+					ref: options?.refspec ?? "HEAD",
 					cwd
 				}));
 				case "failure": return yield* Effect.fail(classified.error);
-				default: return yield* Effect.die(`Git.add: unexpected classification "${classified._tag}"`);
+				default: return yield* Effect.die(`Git.push: unexpected classification "${classified._tag}"`);
 			}
 		}),
-		nameStatus,
-		unstagedChanges,
-		stagedChanges,
-		untrackedFiles,
-		defaultBranch: Effect.fn("Git.defaultBranch")(function* (cwd, options) {
+		pull: Effect.fn("Git.pull")(function* (cwd, options) {
 			const remote = options?.remote ?? "origin";
 			yield* Effect.annotateCurrentSpan({
 				cwd,
-				remote
+				ref: options?.ref ?? "(upstream)",
+				rebase: options?.rebase ?? false
 			});
-			yield* rejectOptionLikeRefs(cwd, [remote]);
-			const command = ChildProcess.setCwd(GitCommand.defaultBranch(remote), cwd);
-			const classified = yield* runFor(command, cwd, "quiet");
+			yield* rejectOptionLikeRefs(cwd, [remote, ...options?.ref !== void 0 ? [options.ref] : []]);
+			const classified = yield* runFor(GitCommand.pull(remote, options?.ref, options?.rebase ?? false, options?.ffOnly ?? false), cwd, "merge");
 			switch (classified._tag) {
-				case "success": {
-					const short = classified.output.trim();
-					const prefix = `${remote}/`;
-					return Option.some(short.startsWith(prefix) ? short.slice(prefix.length) : short);
-				}
-				case "absent": return Option.none();
+				case "success": return;
+				case "dirtyWorktree": return yield* Effect.fail(new DirtyWorktreeError({ cwd }));
+				case "mergeConflict": return yield* Effect.fail(new MergeConflictError({ cwd }));
 				case "notARepository": return yield* Effect.fail(new NotARepositoryError({ cwd }));
 				case "unknownRef": return yield* Effect.fail(new UnknownRefError({
-					ref: `refs/remotes/${remote}/HEAD`,
+					ref: options?.ref ?? "(upstream)",
 					cwd
 				}));
 				case "failure": return yield* Effect.fail(classified.error);
-				default: return yield* Effect.die(`Git.defaultBranch: unexpected classification "${classified._tag}"`);
+				default: return yield* Effect.die(`Git.pull: unexpected classification "${classified._tag}"`);
 			}
 		}),
-		currentBranch: Effect.fn("Git.currentBranch")(function* (cwd) {
-			yield* Effect.annotateCurrentSpan({ cwd });
-			const command = ChildProcess.setCwd(GitCommand.currentBranch(), cwd);
-			const classified = yield* runFor(command, cwd, "generic");
-			switch (classified._tag) {
-				case "success": {
-					const name = classified.output.trim();
-					return name === "HEAD" ? Option.none() : Option.some(name);
-				}
-				case "notARepository": return yield* Effect.fail(new NotARepositoryError({ cwd }));
-				case "unknownRef": return yield* Effect.fail(new UnknownRefError({
-					ref: "HEAD",
-					cwd
-				}));
-				case "failure": return yield* Effect.fail(classified.error);
-				default: return yield* Effect.die(`Git.currentBranch: unexpected classification "${classified._tag}"`);
-			}
+		configList: Effect.fn("Git.configList")(function* (cwd, options) {
+			yield* Effect.annotateCurrentSpan({
+				cwd,
+				file: options?.file ?? "(repository config)"
+			});
+			yield* rejectOptionLikeRefs(cwd, options?.file !== void 0 ? [options.file] : []);
+			return yield* runParsed("Git.configList", GitCommand.configList(options?.file), cwd, "config", "generic", parseConfigList);
 		}),
-		repoRoot: Effect.fn("Git.repoRoot")(function* (cwd) {
-			yield* Effect.annotateCurrentSpan({ cwd });
-			const command = ChildProcess.setCwd(GitCommand.repoRoot(), cwd);
-			const classified = yield* runFor(command, cwd, "generic");
-			switch (classified._tag) {
-				case "success": return classified.output.trim();
-				case "notARepository": return yield* Effect.fail(new NotARepositoryError({ cwd }));
-				case "unknownRef": return yield* Effect.fail(new UnknownRefError({
-					ref: "working tree",
-					cwd
-				}));
-				case "failure": return yield* Effect.fail(classified.error);
-				default: return yield* Effect.die(`Git.repoRoot: unexpected classification "${classified._tag}"`);
-			}
+		configGetAll: Effect.fn("Git.configGetAll")(function* (cwd, key, options) {
+			yield* Effect.annotateCurrentSpan({
+				cwd,
+				key,
+				file: options?.file ?? "(repository config)"
+			});
+			yield* rejectOptionLikeRefs(cwd, [key, ...options?.file !== void 0 ? [options.file] : []]);
+			return yield* runParsed("Git.configGetAll", GitCommand.configGetAll(key, options?.file), cwd, key, "quiet", parseNulSeparated, () => []);
 		}),
-		configGet: Effect.fn("Git.configGet")(function* (cwd, key) {
+		configUnset: Effect.fn("Git.configUnset")(function* (cwd, key, options) {
 			yield* Effect.annotateCurrentSpan({
 				cwd,
-				key
+				key,
+				file: options?.file ?? "(repository config)"
 			});
-			yield* rejectOptionLikeRefs(cwd, [key]);
-			const command = ChildProcess.setCwd(GitCommand.configGet(key), cwd);
-			const classified = yield* runFor(command, cwd, "quiet");
-			switch (classified._tag) {
-				case "success": return Option.some(classified.output.trim());
-				case "absent": return Option.none();
-				case "notARepository": return yield* Effect.fail(new NotARepositoryError({ cwd }));
-				case "unknownRef": return yield* Effect.fail(new UnknownRefError({
-					ref: key,
-					cwd
-				}));
-				case "failure": return yield* Effect.fail(classified.error);
-				default: return yield* Effect.die(`Git.configGet: unexpected classification "${classified._tag}"`);
-			}
+			yield* rejectOptionLikeRefs(cwd, [key, ...options?.file !== void 0 ? [options.file] : []]);
+			return yield* runVoid("Git.configUnset", GitCommand.configUnset(key, options?.file, options?.all ?? false), cwd, key);
 		}),
-		remoteUrl: Effect.fn("Git.remoteUrl")(function* (cwd, options) {
-			const remote = options?.remote ?? "origin";
+		rm: Effect.fn("Git.rm")(function* (cwd, paths, options) {
 			yield* Effect.annotateCurrentSpan({
 				cwd,
-				remote
+				count: paths.length,
+				cached: options?.cached ?? false
 			});
-			yield* rejectOptionLikeRefs(cwd, [remote]);
-			const command = ChildProcess.setCwd(GitCommand.remoteUrl(remote), cwd);
-			const classified = yield* runFor(command, cwd, "noSuchRemote");
-			switch (classified._tag) {
-				case "success": return Option.some(classified.output.trim());
-				case "absent": return Option.none();
-				case "notARepository": return yield* Effect.fail(new NotARepositoryError({ cwd }));
-				case "unknownRef": return yield* Effect.fail(new UnknownRefError({
-					ref: remote,
-					cwd
-				}));
-				case "failure": return yield* Effect.fail(classified.error);
-				default: return yield* Effect.die(`Git.remoteUrl: unexpected classification "${classified._tag}"`);
-			}
+			return yield* runVoid("Git.rm", GitCommand.rm(paths, options?.cached ?? false, options?.recursive ?? false, options?.force ?? false), cwd, "working tree");
 		}),
-		commitInfo: Effect.fn("Git.commitInfo")(function* (cwd, ref) {
-			const target = ref ?? "HEAD";
+		mv: Effect.fn("Git.mv")(function* (cwd, source, destination, options) {
 			yield* Effect.annotateCurrentSpan({
 				cwd,
-				ref: target
+				source,
+				destination
 			});
-			yield* rejectOptionLikeRefs(cwd, [target]);
-			const command = ChildProcess.setCwd(GitCommand.commitInfo(target), cwd);
-			const classified = yield* runFor(command, cwd, "generic");
-			switch (classified._tag) {
-				case "success": return parseCommitInfo(classified.output);
-				case "notARepository": return yield* Effect.fail(new NotARepositoryError({ cwd }));
-				case "unknownRef": return yield* Effect.fail(new UnknownRefError({
-					ref: target,
-					cwd
-				}));
-				case "failure": return yield* Effect.fail(classified.error);
-				default: return yield* Effect.die(`Git.commitInfo: unexpected classification "${classified._tag}"`);
-			}
+			return yield* runVoid("Git.mv", GitCommand.mv(source, destination, options?.force ?? false), cwd, "working tree");
+		}),
+		checkIgnore: Effect.fn("Git.checkIgnore")(function* (cwd, paths) {
+			yield* Effect.annotateCurrentSpan({
+				cwd,
+				count: paths.length
+			});
+			return yield* runParsed("Git.checkIgnore", GitCommand.checkIgnore(paths), cwd, "check-ignore", "quiet", parseNulSeparated, () => []);
+		}),
+		worktreeAdd: Effect.fn("Git.worktreeAdd")(function* (cwd, path, options) {
+			yield* Effect.annotateCurrentSpan({
+				cwd,
+				path,
+				ref: options?.ref ?? "(default)"
+			});
+			yield* rejectOptionLikeRefs(cwd, [path, ...options?.ref !== void 0 ? [options.ref] : []]);
+			return yield* runVoid("Git.worktreeAdd", GitCommand.worktreeAdd(path, options?.ref, options?.detach ?? false, options?.force ?? false), cwd, options?.ref ?? path);
 		}),
-		status: Effect.fn("Git.status")(function* (cwd) {
+		worktreeList: Effect.fn("Git.worktreeList")(function* (cwd) {
 			yield* Effect.annotateCurrentSpan({ cwd });
-			const command = ChildProcess.setCwd(GitCommand.status(), cwd);
-			const classified = yield* runFor(command, cwd, "generic");
-			switch (classified._tag) {
-				case "success": return parseStatus(classified.output);
-				case "notARepository": return yield* Effect.fail(new NotARepositoryError({ cwd }));
-				case "unknownRef": return yield* Effect.fail(new UnknownRefError({
-					ref: "working tree",
-					cwd
-				}));
-				case "failure": return yield* Effect.fail(classified.error);
-				default: return yield* Effect.die(`Git.status: unexpected classification "${classified._tag}"`);
-			}
+			return yield* runParsed("Git.worktreeList", GitCommand.worktreeList(), cwd, "worktrees", "generic", parseWorktreeList);
+		}),
+		worktreeRemove: Effect.fn("Git.worktreeRemove")(function* (cwd, path, options) {
+			yield* Effect.annotateCurrentSpan({
+				cwd,
+				path
+			});
+			yield* rejectOptionLikeRefs(cwd, [path]);
+			return yield* runVoid("Git.worktreeRemove", GitCommand.worktreeRemove(path, options?.force ?? false), cwd, path);
+		}),
+		lsFiles: Effect.fn("Git.lsFiles")(function* (cwd, options) {
+			yield* Effect.annotateCurrentSpan({
+				cwd,
+				patterns: (options?.pathspec ?? []).length
+			});
+			return yield* runParsed("Git.lsFiles", GitCommand.lsFiles(options?.pathspec ?? []), cwd, "index", "generic", parseLsFiles);
 		})
 	};
 };
@@ -20552,17 +23039,23 @@ const make = (spawner) => {
 const notStubbed = (method) => () => Effect.die(/* @__PURE__ */ new Error(`Git.makeTest: ${method}() was called but not stubbed — no honest default exists for a test double; pass a \`${method}\` override.`));
 /**
 * Typed git introspection over core's `ChildProcessSpawner`: read a
-* repository's state at any ref without checking it out, plus the mutating
-* tier (`checkout`, `fetch`, `fetchAny`, `submoduleUpdate`, `submoduleAdd`,
-* `sparseCheckoutSet`, `configSet`, `add`) that changes it.
+* repository's state at any ref without checking it out (including the
+* network read `lsRemote` and the index read `lsFiles`), plus the mutating
+* tier — checkout/fetch, the working-tree restore trio and stash, branches
+* and tags, remotes, worktrees, commit/push/pull, submodules,
+* sparse-checkout, config writes and staging — that changes it. Every
+* mutating method's TSDoc opens with the literal word `Mutating:`.
 *
 * @remarks
 * Every method takes `cwd` explicitly and classifies git's stderr/exit-code
 * taxonomy exactly once, in this module's private `classify` step — a
 * spawn-level `PlatformError` and `Cause.TimeoutError` never escape a `Git`
 * method; every failure surfaces as {@link GitCommandError},
-* {@link NotARepositoryError}, or {@link UnknownRefError}, or degrades to
-* the documented non-error (`Option.none`, `false`).
+* {@link NotARepositoryError}, {@link UnknownRefError}, or one of the three
+* consumer-branchable classifications ({@link NonFastForwardError} from
+* `push`; {@link MergeConflictError} and {@link DirtyWorktreeError} from the
+* merge-shaped `pull` / `stashPop` / `stashApply`), or degrades to the
+* documented non-error (`Option.none`, `false`, the empty array).
 *
 * Every method whose TSDoc opens "Mutating:" changes the working tree,
 * `HEAD`, the index, the repository config, the object database and
@@ -20571,6 +23064,12 @@ const notStubbed = (method) => () => Effect.die(/* @__PURE__ */ new Error(`Git.m
 * that — a caller running two mutating calls (or a mutating call alongside a
 * read) against one `cwd` at once owns the race.
 *
+* **Redaction policy (documented, not just convention).** Error values
+* persist only the constructor's REDACTED argv (see `GitCommandError.args`),
+* and span annotations carry stable identifiers only — `cwd`, refs, keys,
+* paths, remote names — never config values and never URLs, which can embed
+* userinfo. A new method must follow both halves before it ships.
+*
 * @public
 */
 var Git = class Git extends Context.Service()("@effected/git/Git") {
@@ -20585,7 +23084,7 @@ var Git = class Git extends Context.Service()("@effected/git/Git") {
 	*
 	* @remarks
 	* Unlike `WorkspaceDiscovery.makeTest`, **no method here has an honest
-	* default** — the shape is twenty-six unrelated git operations, and a
+	* default** — the shape is unrelated git operations, and a
 	* fabricated answer for any of them (an empty tree, a made-up sha, a silent
 	* no-op `checkout`) would leak into consumer logic as fact. So every
 	* unstubbed method fails loudly as a defect
@@ -20624,8 +23123,23 @@ var Git = class Git extends Context.Service()("@effected/git/Git") {
 		checkout: notStubbed("checkout"),
 		fetch: notStubbed("fetch"),
 		fetchAny: notStubbed("fetchAny"),
+		fetchUnshallow: notStubbed("fetchUnshallow"),
+		isShallow: notStubbed("isShallow"),
+		reset: notStubbed("reset"),
+		clean: notStubbed("clean"),
+		restore: notStubbed("restore"),
+		branchCreate: notStubbed("branchCreate"),
+		branchDelete: notStubbed("branchDelete"),
 		submoduleUpdate: notStubbed("submoduleUpdate"),
 		submoduleAdd: notStubbed("submoduleAdd"),
+		submoduleStatus: notStubbed("submoduleStatus"),
+		submoduleInit: notStubbed("submoduleInit"),
+		submoduleDeinit: notStubbed("submoduleDeinit"),
+		submoduleSync: notStubbed("submoduleSync"),
+		submoduleSetUrl: notStubbed("submoduleSetUrl"),
+		submoduleSetBranch: notStubbed("submoduleSetBranch"),
+		submoduleAbsorbgitdirs: notStubbed("submoduleAbsorbgitdirs"),
+		submoduleForeach: notStubbed("submoduleForeach"),
 		sparseCheckoutSet: notStubbed("sparseCheckoutSet"),
 		configSet: notStubbed("configSet"),
 		add: notStubbed("add"),
@@ -20640,6 +23154,34 @@ var Git = class Git extends Context.Service()("@effected/git/Git") {
 		remoteUrl: notStubbed("remoteUrl"),
 		commitInfo: notStubbed("commitInfo"),
 		status: notStubbed("status"),
+		lsRemote: notStubbed("lsRemote"),
+		remoteAdd: notStubbed("remoteAdd"),
+		remoteRemove: notStubbed("remoteRemove"),
+		remoteSetUrl: notStubbed("remoteSetUrl"),
+		stashPush: notStubbed("stashPush"),
+		stashPop: notStubbed("stashPop"),
+		stashApply: notStubbed("stashApply"),
+		stashDrop: notStubbed("stashDrop"),
+		stashList: notStubbed("stashList"),
+		branchList: notStubbed("branchList"),
+		tagCreate: notStubbed("tagCreate"),
+		tagDelete: notStubbed("tagDelete"),
+		tagList: notStubbed("tagList"),
+		forEachRef: notStubbed("forEachRef"),
+		revList: notStubbed("revList"),
+		commit: notStubbed("commit"),
+		push: notStubbed("push"),
+		pull: notStubbed("pull"),
+		configList: notStubbed("configList"),
+		configGetAll: notStubbed("configGetAll"),
+		configUnset: notStubbed("configUnset"),
+		rm: notStubbed("rm"),
+		mv: notStubbed("mv"),
+		checkIgnore: notStubbed("checkIgnore"),
+		worktreeAdd: notStubbed("worktreeAdd"),
+		worktreeList: notStubbed("worktreeList"),
+		worktreeRemove: notStubbed("worktreeRemove"),
+		lsFiles: notStubbed("lsFiles"),
 		...overrides
 	});
 	/**
@@ -20669,7 +23211,7 @@ var Git = class Git extends Context.Service()("@effected/git/Git") {
 };
 
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+workspaces@0.9.5_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__effect@4.0.0-beta.101/node_modules/@effected/workspaces/ChangeDetector.js
+//#region ../../node_modules/.pnpm/@effected+workspaces@0.10.2_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__@effected+semv_feff9e309e6abeafa28f7ea259b8a9bf/node_modules/@effected/workspaces/ChangeDetector.js
 /**
 * Which git refs to compare, and whether to fold in the working tree.
 *
@@ -20969,7 +23511,7 @@ function resolveFromCatalog(catalogs, wantedDependency) {
 }
 
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+workspaces@0.9.5_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__effect@4.0.0-beta.101/node_modules/@effected/workspaces/internal/catalogs.js
+//#region ../../node_modules/.pnpm/@effected+workspaces@0.10.2_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__@effected+semv_feff9e309e6abeafa28f7ea259b8a9bf/node_modules/@effected/workspaces/internal/catalogs.js
 /** Project a pnpm-workspace manifest's `catalog` / `catalogs` fields into a `Catalogs` map. */
 const inlineCatalogs = (manifest) => {
 	if (manifest.catalog === void 0 && manifest.catalogs === void 0) return {};
@@ -21035,7 +23577,7 @@ const rangeOf = (catalogs, dependency, specifier) => {
 };
 
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+workspaces@0.9.5_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__effect@4.0.0-beta.101/node_modules/@effected/workspaces/ConfigDependencyHooks.js
+//#region ../../node_modules/.pnpm/@effected+workspaces@0.10.2_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__@effected+semv_feff9e309e6abeafa28f7ea259b8a9bf/node_modules/@effected/workspaces/ConfigDependencyHooks.js
 /** Whether `value` is a non-null, non-array object. */
 const isObject$2 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 /**
@@ -21128,6 +23670,141 @@ const updateConfigOf = (mod) => {
 	}
 };
 /**
+* The subprocess replay program {@link ConfigDependencyHooks.layerSubprocess}
+* hands to `node --input-type=module -e`.
+*
+* @remarks
+* A **static** string constant, deliberately: a bundler compiles a *computed*
+* dynamic `import()` into a context module that cannot resolve a runtime path
+* (`Cannot find module 'file:///…'`), so the computed import has to run in a
+* child process whose program text carries **no interpolated runtime value** —
+* the workspace root, the seed and the dependency names all arrive via argv
+* (`process.argv.slice(1)` under `-e`), never spliced into the script.
+*
+* The script mirrors this module's in-process semantics exactly so the two
+* layers are drop-in interchangeable: `pnpmfile.mjs` before `pnpmfile.cjs`
+* (pnpm 11's loader order), the `ERR_MODULE_NOT_FOUND`-for-the-candidate-itself
+* skip discrimination (`err.url` equality), the same hook-locator shapes, the
+* same tolerant threading of returned data (`configOf` / `finiteNumberOr` /
+* `stringArrayOr` clones below), and the same synchronous hook call. Only the
+* *mechanism* failures are reported: the script prints one final line of JSON —
+* `{ ok: true, config }` on success, `{ ok: false, name, message, stack? }`
+* naming the offending dependency on a load/replay failure — and exits through
+* the write callback so the payload is flushed even if a hook left the event
+* loop occupied. The final-line framing tolerates a hook's own `console.log`
+* noise on stdout.
+*/
+const REPLAY_SCRIPT = `
+const [root, seedJson, ...names] = process.argv.slice(1);
+const { pathToFileURL } = await import("node:url");
+const { join } = await import("node:path");
+const isObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const finiteNumberOr = (value, fallback) => (typeof value === "number" && Number.isFinite(value) ? value : fallback);
+const stringArrayOr = (value, fallback) =>
+	Array.isArray(value) && value.every((entry) => typeof entry === "string") ? value : fallback;
+const configOf = (value, fallback) =>
+	isObject(value)
+		? {
+				catalog: isObject(value.catalog) ? value.catalog : fallback.catalog,
+				catalogs: isObject(value.catalogs) ? value.catalogs : fallback.catalogs,
+				minimumReleaseAge: finiteNumberOr(value.minimumReleaseAge, fallback.minimumReleaseAge),
+				minimumReleaseAgeExclude: stringArrayOr(value.minimumReleaseAgeExclude, fallback.minimumReleaseAgeExclude),
+			}
+		: fallback;
+const failure = (name, cause) => ({
+	ok: false,
+	name,
+	message: cause instanceof Error ? cause.message : String(cause),
+	...(cause instanceof Error && typeof cause.stack === "string" ? { stack: cause.stack } : {}),
+});
+const replay = async () => {
+	let catalog = {};
+	const catalogs = {};
+	for (const [name, entries] of Object.entries(JSON.parse(seedJson))) {
+		if (name === "default") catalog = { ...entries };
+		else catalogs[name] = { ...entries };
+	}
+	let config = { catalog, catalogs, minimumReleaseAge: undefined, minimumReleaseAgeExclude: undefined };
+	for (const name of names) {
+		let loaded;
+		let found = false;
+		for (const filename of ["pnpmfile.mjs", "pnpmfile.cjs"]) {
+			const candidate = pathToFileURL(join(root, "node_modules", ".pnpm-config", name, filename)).href;
+			try {
+				loaded = await import(candidate);
+				found = true;
+				break;
+			} catch (cause) {
+				const url =
+					isObject(cause) && cause.code === "ERR_MODULE_NOT_FOUND" && typeof cause.url === "string"
+						? cause.url
+						: undefined;
+				if (url === candidate) continue;
+				return failure(name, cause);
+			}
+		}
+		if (!found) continue;
+		let hook;
+		for (const candidate of [loaded, isObject(loaded) ? loaded.default : undefined]) {
+			if (!isObject(candidate)) continue;
+			if (isObject(candidate.hooks) && typeof candidate.hooks.updateConfig === "function") {
+				hook = candidate.hooks.updateConfig;
+				break;
+			}
+			if (typeof candidate.updateConfig === "function") {
+				hook = candidate.updateConfig;
+				break;
+			}
+		}
+		if (hook === undefined) continue;
+		try {
+			config = configOf(hook(config), config);
+		} catch (cause) {
+			return failure(name, cause);
+		}
+	}
+	return { ok: true, config };
+};
+const payload = await replay();
+process.stdout.write("\\n" + JSON.stringify(payload) + "\\n", () => process.exit(0));
+`;
+/**
+* The ceiling on one subprocess replay. A config dependency's `updateConfig`
+* reads and rewrites a config object — no install work, no network — so thirty
+* seconds is generous. Without a ceiling a pnpmfile that loops or awaits a
+* promise that never settles hangs `inject`, and through it the one memoized
+* {@link WorkspaceCatalogs} assemble pass every catalog read blocks on. Expiry
+* kills the child (`Run` scopes it) and surfaces as a `CommandFailedError`
+* through the same typed transport-failure path as any other mechanism failure.
+*/
+const REPLAY_TIMEOUT = Duration.seconds(30);
+/**
+* The subprocess protocol payload — a single JSON line near the end of the
+* child's stdout, framed and parsed by `Run.jsonLine`, which scans lines from
+* the end for the first that decodes (so a hook logging after the payload —
+* e.g. from `process.on("exit", ...)` — cannot displace it). The `ok`
+* discriminant is what keeps an accidental log line from satisfying the
+* envelope. The envelope is strict (a payload without a usable
+* `ok` discriminant is a mechanism failure, typed); the `config` slice inside a
+* success stays `Unknown` because a hook's returned *data* is tolerantly
+* threaded (`configOf`), never fatal.
+*/
+const ReplayPayload = Schema.Union([Schema.Struct({
+	ok: Schema.Literal(true),
+	config: Schema.Unknown
+}), Schema.Struct({
+	ok: Schema.Literal(false),
+	name: Schema.optionalKey(Schema.String),
+	message: Schema.optionalKey(Schema.String),
+	stack: Schema.optionalKey(Schema.String)
+})]);
+/** Rebuild the subprocess's serialized failure as an `Error`, preserving the child-side stack when it carried one. */
+const replayFailureCause = (payload) => {
+	const error = new Error(payload.message ?? "config dependency hook replay failed");
+	if (payload.stack !== void 0) error.stack = payload.stack;
+	return error;
+};
+/**
 * Replays a workspace's `configDependencies` `updateConfig` hooks over the inline
 * catalogs — the opt-in seam that lets hook-injected catalogs participate in
 * assembly.
@@ -21220,10 +23897,99 @@ var ConfigDependencyHooks = class ConfigDependencyHooks extends Context.Service(
 			releaseAge: releaseAgeOf(config)
 		};
 	}) });
+	/**
+	* The subprocess layer: replays each config dependency's pnpmfile in a `node`
+	* child process instead of an in-process dynamic `import()`, with identical
+	* typed semantics to {@link ConfigDependencyHooks.layerLive} — the two are
+	* drop-in interchangeable.
+	*
+	* @remarks
+	* `layerLive` computes the `import()` path at runtime, and a bundler (rspack,
+	* for one) compiles a *computed* dynamic import into a context module that
+	* throws `Cannot find module 'file:///…'` at runtime — so in any bundled
+	* consumer, a GitHub Action above all, the in-process replay is unreachable.
+	* This layer keeps every computed load out of the bundle graph: the replay
+	* program is a **static** string constant passed via argv
+	* (`node --input-type=module -e <script> <root> <seed> <...names>`), and the
+	* child process performs the computed imports where no bundler rewrote them.
+	* A subprocess also keeps config-dependency code out of the consumer's own
+	* process.
+	*
+	* The contract's semantics are unchanged, not the downstream fail-open shape:
+	* an empty `configDependencies` returns the seed without spawning anything; a
+	* `..` path segment in a dependency name fails typed **before** any spawn; a
+	* missing pnpmfile (neither `.mjs` nor `.cjs`) is the one legitimate skip,
+	* discriminated inside the child by `err.url` equality exactly as
+	* `layerLive` discriminates in process; any other load failure — a syntax
+	* error, a throwing top level, an `ERR_MODULE_NOT_FOUND` for a module the
+	* pnpmfile itself imports — and a hook that throws when called are serialized
+	* back per-name and surface typed as a `hooks`-source `CatalogAssemblyError`
+	* naming that dependency. A hook's returned *data* stays tolerantly threaded
+	* (last well-formed write wins), never fatal. Spawn and transport failures —
+	* `node` absent, a non-zero exit without a result payload, unparseable
+	* output — fail typed too, never a defect and never a silent skip.
+	*
+	* Two bounds this layer imposes that `layerLive` cannot: the replay is
+	* given thirty seconds (a pnpmfile that loops or awaits forever fails typed
+	* instead of hanging the memoized assemble pass — a subprocess is killable,
+	* while `layerLive`'s in-process synchronous hook call is not interruptible
+	* by any means, so the asymmetry is inherent, not a parity violation), and
+	* the child's stdout is captured under `Run.jsonLine`'s 16 MiB default
+	* ceiling (a hook that logs more than that fails typed as `tooLarge`, where
+	* `layerLive` — which captures nothing — would succeed).
+	*
+	* Catalog folding and normalization stay in the **parent** (the same
+	* `@pnpm/catalogs`-derived path `layerLive` uses); the child returns only the
+	* raw threaded config slice, since the script cannot import kit code.
+	*
+	* Requires core's `ChildProcessSpawner`, resolved when the layer is built —
+	* the consumer provides it once at the edge (`@effect/platform-node`'s
+	* `NodeServices.layer`), the same discharge `@effected/git` uses. Wired by
+	* `WorkspaceCatalogs.layerWithConfigDependenciesSubprocess` /
+	* `Workspaces.layerWithConfigDependenciesSubprocess`.
+	*/
+	static layerSubprocess = Layer.effect(ConfigDependencyHooks, Effect.gen(function* () {
+		const spawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+		return { inject: (root, configDependencies, seed) => Effect.gen(function* () {
+			const names = Object.keys(configDependencies);
+			if (names.length === 0) return {
+				catalogs: seed,
+				releaseAge: {}
+			};
+			for (const name of names) if (hasTraversalSegment(name)) return yield* Effect.fail(new CatalogAssemblyError({
+				source: "hooks",
+				path: name,
+				cause: /* @__PURE__ */ new Error(`config dependency name has a '..' path segment: ${name}`)
+			}));
+			const command = ChildProcess.make("node", [
+				"--input-type=module",
+				"-e",
+				REPLAY_SCRIPT,
+				root,
+				JSON.stringify(seed),
+				...names
+			]);
+			const payload = yield* Run.jsonLine(command, ReplayPayload, { timeout: REPLAY_TIMEOUT }).pipe(Effect.provideService(ChildProcessSpawner.ChildProcessSpawner, spawner), Effect.catch((cause) => Effect.fail(new CatalogAssemblyError({
+				source: "hooks",
+				path: root,
+				cause
+			}))));
+			if (payload.ok === false) return yield* Effect.fail(new CatalogAssemblyError({
+				source: "hooks",
+				path: payload.name ?? root,
+				cause: replayFailureCause(payload)
+			}));
+			const config = configOf(payload.config, seedToConfig(seed));
+			return {
+				catalogs: configToEntries(config),
+				releaseAge: releaseAgeOf(config)
+			};
+		}) };
+	}));
 };
 
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+workspaces@0.9.5_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__effect@4.0.0-beta.101/node_modules/@effected/workspaces/PackageManagerName.js
+//#region ../../node_modules/.pnpm/@effected+workspaces@0.10.2_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__@effected+semv_feff9e309e6abeafa28f7ea259b8a9bf/node_modules/@effected/workspaces/PackageManagerName.js
 /**
 * The four package managers this package understands.
 *
@@ -21552,7 +24318,7 @@ var PackageManagerDetector = class PackageManagerDetector extends Context.Servic
 };
 
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+workspaces@0.9.5_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__effect@4.0.0-beta.101/node_modules/@effected/workspaces/LockfileReader.js
+//#region ../../node_modules/.pnpm/@effected+workspaces@0.10.2_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__@effected+semv_feff9e309e6abeafa28f7ea259b8a9bf/node_modules/@effected/workspaces/LockfileReader.js
 /**
 * Raised when the workspace's lockfile cannot be read off disk.
 *
@@ -21733,7 +24499,7 @@ var LockfileReader = class LockfileReader extends Context.Service()("@effected/w
 };
 
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+workspaces@0.9.5_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__effect@4.0.0-beta.101/node_modules/@effected/workspaces/Publishability.js
+//#region ../../node_modules/.pnpm/@effected+workspaces@0.10.2_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__@effected+semv_feff9e309e6abeafa28f7ea259b8a9bf/node_modules/@effected/workspaces/Publishability.js
 /** The public npm registry, used when `publishConfig.registry` says nothing. */
 const DEFAULT_REGISTRY = "https://registry.npmjs.org/";
 /**
@@ -21893,7 +24659,7 @@ var PublishabilityDetector = class extends Context.Service()("@effected/workspac
 };
 
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+workspaces@0.9.5_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__effect@4.0.0-beta.101/node_modules/@effected/workspaces/internal/importerVersions.js
+//#region ../../node_modules/.pnpm/@effected+workspaces@0.10.2_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__@effected+semv_feff9e309e6abeafa28f7ea259b8a9bf/node_modules/@effected/workspaces/internal/importerVersions.js
 /**
 * Strip pnpm's peer-disambiguation suffix from a recorded importer version.
 *
@@ -21980,7 +24746,7 @@ const unanimousVersionOf = (index, dependency) => {
 };
 
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+workspaces@0.9.5_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__effect@4.0.0-beta.101/node_modules/@effected/workspaces/WorkspaceCatalogs.js
+//#region ../../node_modules/.pnpm/@effected+workspaces@0.10.2_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__@effected+semv_feff9e309e6abeafa28f7ea259b8a9bf/node_modules/@effected/workspaces/WorkspaceCatalogs.js
 /**
 * An immutable, fully-normalized catalog collection — the one catalog
 * resolution semantic in the package.
@@ -22401,6 +25167,24 @@ var WorkspaceCatalogs = class WorkspaceCatalogs extends Context.Service()("@effe
 	*/
 	static layerWithConfigDependencies = (options) => Layer.effect(WorkspaceCatalogs, WorkspaceCatalogs.make(options)).pipe(Layer.provide(ConfigDependencyHooks.layerLive));
 	/**
+	* The opt-in layer that replays config-dependency `pnpmfile` hooks in a
+	* `node` **child process**: it wires
+	* {@link ConfigDependencyHooks.layerSubprocess} in place of the in-process
+	* `layerLive`.
+	*
+	* @remarks
+	* Same typed semantics as {@link WorkspaceCatalogs.layerWithConfigDependencies}
+	* — the two hook layers are drop-in interchangeable — but the replay's
+	* computed dynamic `import()` runs in the subprocess, so it survives bundling
+	* (a bundler compiles a computed in-process `import()` into a context module
+	* that cannot resolve at runtime — every bundled GitHub Action hits this).
+	* The cost is one extra requirement: core's `ChildProcessSpawner`, provided
+	* once at the edge (`@effect/platform-node`'s `NodeServices.layer`) — the
+	* same sanctioned R-widening as `Workspaces.layerWithGit`. Parameterized, so
+	* bind it to a `const` and reuse it.
+	*/
+	static layerWithConfigDependenciesSubprocess = (options) => Layer.effect(WorkspaceCatalogs, WorkspaceCatalogs.make(options)).pipe(Layer.provide(ConfigDependencyHooks.layerSubprocess));
+	/**
 	* A test double satisfying the full {@link WorkspaceCatalogsShape} with no
 	* filesystem, lockfile read, or hook replay.
 	*
@@ -22490,7 +25274,7 @@ var WorkspaceCatalogs = class WorkspaceCatalogs extends Context.Service()("@effe
 };
 
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+workspaces@0.9.5_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__effect@4.0.0-beta.101/node_modules/@effected/workspaces/WorkspaceStateSnapshot.js
+//#region ../../node_modules/.pnpm/@effected+workspaces@0.10.2_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__@effected+semv_feff9e309e6abeafa28f7ea259b8a9bf/node_modules/@effected/workspaces/WorkspaceStateSnapshot.js
 const EMPTY = Object.freeze(Object.create(null));
 const DependencyMap = Schema.Record(Schema.String, Schema.String).pipe(Schema.withDecodingDefaultKey(Effect.succeed(EMPTY)), Schema.withConstructorDefault(Effect.succeed(EMPTY)));
 /**
@@ -22714,7 +25498,7 @@ var WorkspaceStateSnapshot = class extends Schema.Class("WorkspaceStateSnapshot"
 };
 
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+workspaces@0.9.5_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__effect@4.0.0-beta.101/node_modules/@effected/workspaces/WorkspaceSnapshots.js
+//#region ../../node_modules/.pnpm/@effected+workspaces@0.10.2_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__@effected+semv_feff9e309e6abeafa28f7ea259b8a9bf/node_modules/@effected/workspaces/WorkspaceSnapshots.js
 /** Whether `value` is a non-null, non-array object. */
 const isObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 /** Whether every value in a record is a string — a usable dependency map. */
@@ -22992,7 +25776,7 @@ var WorkspaceSnapshots = class WorkspaceSnapshots extends Context.Service()("@ef
 };
 
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+workspaces@0.9.5_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__effect@4.0.0-beta.101/node_modules/@effected/workspaces/Workspaces.js
+//#region ../../node_modules/.pnpm/@effected+workspaces@0.10.2_@effected+jsonc@0.5.2_effect@4.0.0-beta.101__@effected+semv_feff9e309e6abeafa28f7ea259b8a9bf/node_modules/@effected/workspaces/Workspaces.js
 const compose = (options, catalogsFactory) => {
 	const roots = WorkspaceRoot.layer;
 	const detector = PackageManagerDetector.layer;
@@ -23009,6 +25793,7 @@ const layerWithGit = (options) => {
 };
 const resolvers = Layer.mergeAll(WorkspaceCatalogs.catalogResolver, WorkspaceDiscovery.workspaceResolver);
 const layerWithConfigDependencies = (options) => compose(options, WorkspaceCatalogs.layerWithConfigDependencies);
+const layerWithConfigDependenciesSubprocess = (options) => compose(options, WorkspaceCatalogs.layerWithConfigDependenciesSubprocess);
 const resolverLayer = (options) => resolvers.pipe(Layer.provide(layerWithConfigDependencies(options)));
 const resolveManifest = Effect.fn("Workspaces.resolveManifest")(function* (manifest, options) {
 	return yield* manifest.resolve().pipe(Effect.provide(resolverLayer(options)));
@@ -23090,6 +25875,32 @@ var Workspaces = class {
 	*/
 	static layerWithConfigDependencies = layerWithConfigDependencies;
 	/**
+	* The git-free composite with config-dependency hook replay in a `node`
+	* **child process** —
+	* {@link WorkspaceCatalogs.layerWithConfigDependenciesSubprocess} in place of
+	* the in-process replay.
+	*
+	* @remarks
+	* Same typed semantics as {@link Workspaces.layerWithConfigDependencies}; the
+	* difference is mechanism, and it matters in exactly one environment class: a
+	* **bundled** consumer. The in-process replay's computed dynamic `import()`
+	* is compiled by bundlers (rspack among them) into a context module that
+	* throws `Cannot find module 'file:///…'` at runtime, which makes
+	* `WorkspaceCatalogs.releaseAgeGate()` unreachable from any bundled GitHub
+	* Action. Here the computed import runs inside a `node` child process whose
+	* program text is a static string handed over argv, so nothing computed
+	* enters the bundle graph.
+	*
+	* The extra requirement is core's `ChildProcessSpawner`, provided once at
+	* the edge (`@effect/platform-node`'s `NodeServices.layer`) — the same
+	* sanctioned R-widening as {@link Workspaces.layerWithGit}, and the reason
+	* this is a separate composite rather than a flag: a consumer that keeps the
+	* in-process replay should not have to be able to spawn a subprocess.
+	*
+	* **Bind the result to a `const`.**
+	*/
+	static layerWithConfigDependenciesSubprocess = layerWithConfigDependenciesSubprocess;
+	/**
 	* The git-free composite plus {@link ChangeDetector} and
 	* {@link WorkspaceSnapshots}, over `@effected/git`'s `Git` service.
 	*
@@ -23099,7 +25910,8 @@ var Workspaces = class {
 	* never detects changes or reads at a ref should not have to be able to
 	* spawn a subprocess. The consumer provides `ChildProcessSpawner` once at
 	* the edge (`@effect/platform-node`'s `NodeServices.layer`); a test
-	* provides `Layer.succeed(Git, …)` and needs no repository on disk.
+	* provides `Git.layerTest({ … })` — git's own shipped double, whose
+	* unstubbed members die named — and needs no repository on disk.
 	*/
 	static layerWithGit = layerWithGit;
 	/**
@@ -23148,9 +25960,14 @@ var Workspaces = class {
 	* import { Workspaces } from "@effected/workspaces";
 	* import { Layer } from "effect";
 	*
+	* // Bound to consts per the warning above: each factory call mints a
+	* // fresh layer reference, and layers memoize by reference.
+	* const LocalExecLayer = Workspaces.localExecLayer();
+	* const WorkspacesLayer = Workspaces.layer();
+	*
 	* const AppLayer = ToolDiscovery.layer.pipe(
-	*   Layer.provide(Workspaces.localExecLayer()),
-	*   Layer.provide(Workspaces.layer()),
+	*   Layer.provide(LocalExecLayer),
+	*   Layer.provide(WorkspacesLayer),
 	*   Layer.provide(NodeServices.layer),
 	* );
 	* ```