@deslop/coding-standards 0.1.1076 → 0.1.1079

package/dist/install.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { $n as symbol$1, $t as TaggedError$2, A as fromIterable$1, An as getStackTraceLimit, Ar as Prototype$1, Bn as currentFiberTypeId, Cn as isFailReason$1, Cr as constant, Dn as withFiber$1, Dr as memoizeIdempotent, E as findLast, En as makePrimitiveProto, Er as memoize, Et as none, F as isArrayNonEmpty, Fn as format$1, G as reduce, Gn as combine$1, Gt as Done$1, H as match$5, Hn as equals$1, I as isCanonicalArrayIndex, Jt as Fail, K as some$1, Kn as hash, Kt as Error$3, L as isReadonlyArrayNonEmpty, Ln as formatJson, Mn as BaseProto, Mt as Number$6, Nn as NodeInspectSymbol, Nt as String$6, On as assignProperty, Or as pipe, Ot as some, Pn as toStringUnknown, Pt as isGreaterThan$1, Qt as StackTraceKey, R as join$1, Rn as formatPath, S as filter, Sn as isExit, Sr as constVoid, St as isSome, T as findFirstIndex, Tn as makePrimitive$1, Tr as identity, Tt as match$4, U as of, Un as symbol, Ut as CauseImpl, V as map$8, Wt as Die, Xn as string$1, Xt as PipeInspectableProto, Yn as random, Yt as InterruptorStackTrace, Zn as structure, Zt as ReasonBase, _ as dedupe, _n as exitSucceed, _r as isUndefined, _t as fromNullishOr, an as causeEmpty, ar as isIterable, bn as isDone$2, br as constTrue, bt as getOrUndefined$1, c as startsWith, cn as constEmptyAnnotations, cr as isNotUndefined, ct as succeed$6, d as Error$2, dn as contE, dr as isObject, en as Yield, er as hasProperty, et as fail$5, f as TaggedError$1, fn as done$1, fr as isObjectKeyword, ft as exists, g as contains, gn as exitFailCause, gr as isTagged, hn as exitFail, hr as isString$1, ht as flatMap$4, in as causeDie, ir as isFunction, it as isFailure$1, jn as setStackTraceLimit, jr as pipeArguments, kn as internalCall, kr as Class, ln as contA, lr as isNullish, lt as normalize$1, m as append$1, mn as exitDie, n as make$29, nn as causeAnnotate, nr as isBoolean$1, on as causeFail, or as isNotNull, p as taggedEnum, pn as evaluate, qn as number$1, qt as ExitTypeId, rn as causeCombine, rr as isError, sn as causeFromReasons, sr as isNotNullish, st as match$3, tn as args, u as trimEnd, un as contAll, ur as isNumber, vn as isCause, vr as isUnknown, vt as fromUndefinedOr, w as findFirst, wn as isInterruptReason, wr as dual, xn as isEffect$1, xr as constUndefined, xt as isNone, y as empty$3, yn as isDieReason$1, yr as constFalse, yt as getOrElse, zn as formatPropertyKey, zt as mapInput } from "./MutableRef-KfyWrSvW.mjs";
+import { A as filter, An as isCause, Ar as isString$1, At as getOrUndefined$1, Bn as assignProperty, Br as identity, C as contains, Cn as contE, Cr as isNullish, D as empty$3, Dn as exitFail, Dt as fromNullishOr, En as exitDie, Er as isObjectKeyword, Fn as isFailReason$1, Fr as constTrue, Ft as match$5, G as isReadonlyArrayNonEmpty, Gn as NodeInspectSymbol, Gr as Prototype$1, Gt as isGreaterThan$1, Hn as getStackTraceLimit, Hr as memoizeIdempotent, In as isInterruptReason, Ir as constUndefined, It as none, K as join$1, Kn as toStringUnknown, Kr as pipeArguments, Ln as makePrimitive$1, Lr as constVoid, Lt as orElse, M as findFirst, Mn as isDone$2, Mr as isUndefined, Mt as isSome, N as findFirstIndex, Nn as isEffect$1, Nr as isUnknown, On as exitFailCause, Ot as fromUndefinedOr, P as findLast, Pn as isExit, Pr as constFalse, Pt as map$10, Q as of, Qn as currentFiberTypeId, R as fromIterable$1, Rn as makePrimitiveProto, Rr as constant, Rt as some, Sn as contAll, Sr as isNotUndefined, St as exists, T as dedupe, Tn as evaluate, Tr as isObject, Tt as flatMap$4, U as isArrayNonEmpty, Un as setStackTraceLimit, Ur as pipe, Ut as Number$6, Vn as internalCall, Vr as memoize, W as isCanonicalArrayIndex, Wn as BaseProto, Wr as Class, Wt as String$6, X as match$6, Xn as formatPath, Xt as mapInput, Y as map$8, Yn as formatJson, Zn as formatPropertyKey, _ as trimEnd, _n as causeEmpty, _r as isError, _t as match$4, a as takeN, an as Fail, b as taggedEnum, bn as constEmptyAnnotations, br as isNotNull, c as make$30, cn as ReasonBase, cr as number$1, dn as Yield, dr as structure, en as CauseImpl, et as reduce, fn as args, gn as causeDie, gr as isBoolean$1, h as startsWith, hn as causeCombine, i as take$1, in as ExitTypeId, ir as symbol, jn as isDieReason$1, jr as isTagged, jt as isNone, kn as exitSucceed, kt as getOrElse, ln as StackTraceKey, mn as causeAnnotate, mr as hasProperty, mt as isFailure$1, n as clear, nn as Done$1, on as InterruptorStackTrace, or as combine$1, pn as causeAddInterrupts, pr as symbol$1, qn as format$1, r as make$29, rn as Error$3, rr as equals$1, sn as PipeInspectableProto, sr as hash, t as append$1, tn as Die, tt as some$1, un as TaggedError$2, ur as string$1, ut as fail$5, v as Error$2, vn as causeFail, vr as isFunction, vt as succeed$6, wn as done$1, wr as isNumber, x as append, xn as contA, xr as isNotNullish, y as TaggedError$1, yn as causeFromReasons, yr as isIterable, yt as normalize$1, zn as withFiber$1, zr as dual } from "./MutableList-BCF17jPH.mjs";
 import * as OS from "node:os";
 import * as NodeChildProcess from "node:child_process";
 import { PassThrough } from "node:stream";
@@ -8,7 +8,7 @@ import * as NFS from "node:fs";
 import * as Path from "node:path";
 import * as NodeUrl from "node:url";
 import * as readline from "node:readline";
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/Effectable.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/Effectable.js
 /**
 * Create a low-level `Effect` prototype.
 *
@@ -34,7 +34,7 @@ const Prototype = (options) => makePrimitiveProto({
 	[evaluate]: options.evaluate
 });
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/Context.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/Context.js
 /**
 * Runtime type identifier attached to `Context` service keys and used by
 * `isKey` to recognize them.
@@ -140,11 +140,11 @@ const ServiceProto = {
 };
 const cacheKeys = /*#__PURE__*/ new Set();
 const ReferenceTypeId = "~effect/Context/Reference";
-const TypeId$33 = "~effect/Context";
+const TypeId$34 = "~effect/Context";
 const MaxDepth = 8;
 const FlattenAfterBaseHits = 8;
 const makeImpl = (cacheRoot, base, overlay, depth) => {
-	const self = Object.create(Proto$10);
+	const self = Object.create(Proto$11);
 	self.cacheRoot = cacheRoot ?? self;
 	self.base = base;
 	self.overlay = overlay;
@@ -216,12 +216,12 @@ const lookup = (self, key) => {
 * @since 4.0.0
 */
 const makeUnsafe$5 = (mapUnsafe) => makeImpl(void 0, mapUnsafe, void 0, 0);
-const Proto$10 = {
+const Proto$11 = {
 	get mapUnsafe() {
 		return flatten(this);
 	},
 	...PipeInspectableProto,
-	[TypeId$33]: { _Services: (_) => _ },
+	[TypeId$34]: { _Services: (_) => _ },
 	toJSON() {
 		return {
 			_id: "Context",
@@ -277,7 +277,7 @@ const hasSameCache = (self, that) => self.cacheRoot === that.cacheRoot;
 * @category guards
 * @since 2.0.0
 */
-const isContext = (u) => hasProperty(u, TypeId$33);
+const isContext = (u) => hasProperty(u, TypeId$34);
 /**
 * Checks whether the provided argument is a `Reference`.
 *
@@ -686,15 +686,16 @@ const mergeAll$1 = (...ctxs) => {
 */
 const Reference = Service;
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/Duration.js
-const TypeId$32 = "~effect/Duration";
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/Duration.js
+const TypeId$33 = "~effect/Duration";
 const bigint0$2 = /*#__PURE__*/ BigInt(0);
 const bigint1$2 = /*#__PURE__*/ BigInt(1);
 const bigint2 = /*#__PURE__*/ BigInt(2);
 const bigint10$1 = /*#__PURE__*/ BigInt(10);
 const bigint1e3 = /*#__PURE__*/ BigInt(1e3);
+const bigint1e6 = /*#__PURE__*/ BigInt(1e6);
 const roundTiesAwayFromZero = (input) => BigInt(Math.sign(input) * Math.round(Math.abs(input)));
-const roundMillisToNanos = (millis) => roundTiesAwayFromZero(millis * 1e6);
+const roundMillisToNanos = (millis) => Number.isInteger(millis) ? BigInt(millis) * bigint1e6 : roundTiesAwayFromZero(millis * 1e6);
 const fromNanosNumber = (nanos) => make$25(Number.isFinite(nanos) ? roundTiesAwayFromZero(nanos) : nanos);
 const parseNanos = (input, scale) => {
 	const decimalIndex = input.indexOf(".");
@@ -769,7 +770,7 @@ const fromInputUnsafe$1 = (input) => {
 		}
 		case "object": {
 			if (input === null) break;
-			if (TypeId$32 in input) return input;
+			if (TypeId$33 in input) return input;
 			if (Array.isArray(input)) {
 				if (input.length !== 2 || !input.every(isNumber)) return invalid$2(input);
 				if (Number.isNaN(input[0]) || Number.isNaN(input[1])) return zero$1;
@@ -801,13 +802,10 @@ const zeroDurationValue = {
 const infinityDurationValue = { _tag: "Infinity" };
 const negativeInfinityDurationValue = { _tag: "NegativeInfinity" };
 const DurationProto = {
-	[TypeId$32]: TypeId$32,
+	[TypeId$33]: TypeId$33,
 	[symbol$1]() {
 		switch (this.value._tag) {
-			case "Millis": {
-				const nanos = this.value.millis * 1e6;
-				return Number.isFinite(nanos) ? hash(roundTiesAwayFromZero(nanos)) : number$1(this.value.millis);
-			}
+			case "Millis": return hash(roundMillisToNanos(this.value.millis));
 			case "Nanos": return hash(this.value.nanos);
 			default: return structure(this.value);
 		}
@@ -888,7 +886,7 @@ const make$25 = (input) => {
 * @category guards
 * @since 2.0.0
 */
-const isDuration = (u) => hasProperty(u, TypeId$32);
+const isDuration = (u) => hasProperty(u, TypeId$33);
 /**
 * Checks whether a Duration is finite (not infinite).
 *
@@ -1082,7 +1080,7 @@ const weeks = (weeks) => make$25(weeks * 6048e5);
 * @category getters
 * @since 2.0.0
 */
-const toMillis = (self) => match$2(fromInputUnsafe$1(self), {
+const toMillis = (self) => match$3(fromInputUnsafe$1(self), {
 	onMillis: identity,
 	onNanos: (nanos) => Number(nanos) / 1e6,
 	onInfinity: () => Infinity,
@@ -1154,7 +1152,7 @@ const toNanosUnsafe = (input) => {
 * @category pattern matching
 * @since 2.0.0
 */
-const match$2 = /*#__PURE__*/ dual(2, (self, options) => {
+const match$3 = /*#__PURE__*/ dual(2, (self, options) => {
 	switch (self.value._tag) {
 		case "Millis": return options.onMillis(self.value.millis);
 		case "Nanos": return options.onNanos(self.value.nanos);
@@ -1201,7 +1199,7 @@ const matchPair = /*#__PURE__*/ dual(3, (self, that, options) => {
 * @category instances
 * @since 2.0.0
 */
-const Equivalence$1 = (self, that) => matchPair(self, that, {
+const Equivalence$2 = (self, that) => matchPair(self, that, {
 	onMillis: (self, that) => self === that,
 	onNanos: (self, that) => self === that,
 	onInfinity: (self, that) => self.value._tag === that.value._tag
@@ -1221,9 +1219,9 @@ const Equivalence$1 = (self, that) => matchPair(self, that, {
 * @category predicates
 * @since 2.0.0
 */
-const equals = /*#__PURE__*/ dual(2, (self, that) => Equivalence$1(self, that));
+const equals = /*#__PURE__*/ dual(2, (self, that) => Equivalence$2(self, that));
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/Scheduler.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/Scheduler.js
 /**
 * Controls how runnable Effect fiber tasks are dispatched.
 *
@@ -1460,7 +1458,7 @@ const PreventSchedulerYield = /*#__PURE__*/ Reference("effect/Scheduler/PreventS
 	defaultValue: () => false
 });
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/Tracer.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/Tracer.js
 /**
 * Defines the string key for the parent-span context service.
 *
@@ -1497,11 +1495,11 @@ const ParentSpanKey = "effect/Tracer/ParentSpan";
 */
 const TracerKey = "effect/Tracer";
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/internal/metric.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/internal/metric.js
 /** @internal */
 const FiberRuntimeMetricsKey = "effect/Metric/FiberRuntimeMetrics";
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/internal/references.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/internal/references.js
 /** @internal */
 const CurrentStackFrame = /*#__PURE__*/ Reference("effect/References/CurrentStackFrame", {
 	fiberCached: true,
@@ -1527,7 +1525,7 @@ const MinimumLogLevel$1 = /*#__PURE__*/ Reference("effect/References/MinimumLogL
 /** @internal */
 const CurrentLogSpans = /*#__PURE__*/ Reference("effect/References/CurrentLogSpans", { defaultValue: () => [] });
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/internal/effect.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/internal/effect.js
 /** @internal */
 var Interrupt = class extends ReasonBase {
 	constructor(fiberId, annotations = constEmptyAnnotations) {
@@ -1547,7 +1545,7 @@ var Interrupt = class extends ReasonBase {
 		return isInterruptReason(that) && this.fiberId === that.fiberId && this.annotations === that.annotations;
 	}
 	[symbol$1]() {
-		return combine$1(string$1(`${this._tag}:${this.fiberId}`))(random(this.annotations));
+		return string$1(`${this._tag}:${this.fiberId}`);
 	}
 };
 /** @internal */
@@ -1771,7 +1769,7 @@ var FiberImpl = class {
 		let cause = causeInterrupt(fiberId);
 		if (this.cache.stackFrame) cause = causeAnnotate(cause, make$26(StackTraceKey, this.cache.stackFrame));
 		if (annotations) cause = causeAnnotate(cause, annotations);
-		this._interruptedCause = this._interruptedCause ? causeCombine(this._interruptedCause, cause) : cause;
+		this._interruptedCause = this._interruptedCause ? causeAddInterrupts(this._interruptedCause, cause) : cause;
 		if (this.interruptible) {
 			if (this._running) this._deferredInterrupt = true;
 			else this.evaluate(failCause$3(this._interruptedCause));
@@ -2021,7 +2019,7 @@ const suspend$3 = /*#__PURE__*/ makePrimitive$1({
 	}
 });
 /** @internal */
-const fromResult$1 = /*#__PURE__*/ match$3({
+const fromResult$1 = /*#__PURE__*/ match$4({
 	onFailure: fail$4,
 	onSuccess: succeed$5
 });
@@ -2495,7 +2493,7 @@ const matchEffect$2 = /*#__PURE__*/ dual(2, (self, options) => matchCauseEffect$
 	onSuccess: options.onSuccess
 }));
 /** @internal */
-const match$1 = /*#__PURE__*/ dual(2, (self, options) => new MatchImpl(self, options));
+const match$2 = /*#__PURE__*/ dual(2, (self, options) => new MatchImpl(self, options));
 /** @internal */
 const matchEager = /*#__PURE__*/ dual(2, (self, options) => {
 	if (effectIsExit(self)) {
@@ -2504,7 +2502,7 @@ const matchEager = /*#__PURE__*/ dual(2, (self, options) => {
 		if (isFailure$1(error)) return self;
 		return exitSucceed(options.onFailure(error.success));
 	}
-	return match$1(self, options);
+	return match$2(self, options);
 });
 /** @internal */
 const exit$1 = (self) => effectIsExit(self) ? exitSucceed(self) : exitPrimitive(self);
@@ -3338,7 +3336,7 @@ const tracerLogger = /*#__PURE__*/ loggerMake(({ cause, fiber, logLevel, message
 	span.event(toStringUnknown(Array.isArray(message) && message.length === 1 ? message[0] : message), clock.currentTimeNanosUnsafe(), attributes);
 });
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/Cause.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/Cause.js
 /**
 * Narrows a `Reason` to `Fail`.
 *
@@ -3728,7 +3726,7 @@ const UnknownError = UnknownError$1;
 */
 const reasonAnnotations = reasonAnnotations$1;
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/Exit.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/Exit.js
 /**
 * Creates a successful Exit containing the given value.
 *
@@ -4005,7 +4003,7 @@ const doneUnsafe = (self, effect) => {
 	return true;
 };
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/References.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/References.js
 /**
 * Context reference for setting the minimum log level threshold. Log entries below this
 * level will be filtered out completely.
@@ -4043,7 +4041,7 @@ const doneUnsafe = (self, effect) => {
 */
 const MinimumLogLevel = MinimumLogLevel$1;
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/Scope.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/Scope.js
 /**
 * Controls how long resources stay open.
 *
@@ -4299,8 +4297,8 @@ const forkUnsafe = scopeForkUnsafe;
 */
 const close = scopeClose;
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/Layer.js
-const TypeId$30 = "~effect/Layer";
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/Layer.js
+const TypeId$31 = "~effect/Layer";
 const MemoMapTypeId = "~effect/Layer/MemoMap";
 const makeMemoMapEntry = (memoMap, layer) => {
 	const entry = {
@@ -4322,7 +4320,7 @@ const memoMapObserve = (entry, scope) => {
 	return true;
 };
 const LayerProto = {
-	[TypeId$30]: {
+	[TypeId$31]: {
 		_ROut: identity,
 		_E: identity,
 		_RIn: identity
@@ -4946,13 +4944,13 @@ const provideWith = (self, that, f) => fromBuild((memoMap, scope) => flatMap$2(A
 */
 const provideMerge = /*#__PURE__*/ dual(2, (self, that) => provideWith(self, that, (self, that) => merge$2(that, self)));
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/internal/dateTime.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/internal/dateTime.js
 /** @internal */
-const TypeId$29 = "~effect/DateTime";
+const TypeId$30 = "~effect/DateTime";
 /** @internal */
 const TimeZoneTypeId = "~effect/DateTime/TimeZone";
-const Proto$9 = {
-	[TypeId$29]: TypeId$29,
+const Proto$10 = {
+	[TypeId$30]: TypeId$30,
 	pipe() {
 		return pipeArguments(this, arguments);
 	},
@@ -4963,8 +4961,8 @@ const Proto$9 = {
 		return toDateUtc$1(this).toJSON();
 	}
 };
-({ ...Proto$9 });
-({ ...Proto$9 });
+({ ...Proto$10 });
+({ ...Proto$10 });
 const ProtoTimeZone = {
 	[TimeZoneTypeId]: TimeZoneTypeId,
 	[NodeInspectSymbol]() {
@@ -5001,7 +4999,7 @@ const round = /*#__PURE__*/ dual(2, (self, precision) => {
 	return Math.round(self * factor) / factor;
 });
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/internal/random.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/internal/random.js
 /** @internal */
 const nextBetween = (min, max, draw) => {
 	const value = draw * (max - min) + min;
@@ -5014,7 +5012,7 @@ const nextBetween = (min, max, draw) => {
 	return view.getFloat64(0);
 };
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/Pull.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/Pull.js
 /**
 * Models one low-level pull step for stream-like consumers.
 *
@@ -5192,12 +5190,12 @@ const matchEffect$1 = /*#__PURE__*/ dual(2, (self, options) => matchCauseEffect$
 	}
 }));
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/internal/layer.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/internal/layer.js
 const provideLayer = (self, layer, options) => scopedWith$1((scope) => flatMap$2(options?.local ? buildWithMemoMap(layer, makeMemoMapUnsafe(), scope) : buildWithScope(layer, scope), (context) => provideContext$1(self, context)));
 /** @internal */
 const provide$1 = /*#__PURE__*/ dual((args) => isEffect$1(args[0]), (self, source, options) => isContext(source) ? provideContext$1(self, source) : provideLayer(self, Array.isArray(source) ? mergeAll(...source) : source, options));
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/Effect.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/Effect.js
 /**
 * Checks whether a value is an `Effect`.
 *
@@ -6764,7 +6762,7 @@ const raceFirst = raceFirst$1;
 * @category pattern matching
 * @since 2.0.0
 */
-const match = match$1;
+const match$1 = match$2;
 /**
 * Handles failures with access to the cause and allows performing side effects.
 *
@@ -8094,7 +8092,7 @@ const catchEager = catchEager$1;
 */
 const fnUntracedEager = fnUntracedEager$1;
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/BigDecimal.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/BigDecimal.js
 /**
 * Decimal numbers and arithmetic for cases where JavaScript `number` rounding
 * is not precise enough. A `BigDecimal` stores digits as a `bigint` plus a
@@ -8105,9 +8103,9 @@ const fnUntracedEager = fnUntracedEager$1;
 * @stability stable
 * @since 2.0.0
 */
-const TypeId$28 = "~effect/BigDecimal";
+const TypeId$29 = "~effect/BigDecimal";
 const BigDecimalProto = {
-	[TypeId$28]: TypeId$28,
+	[TypeId$29]: TypeId$29,
 	[symbol$1]() {
 		const normalized = normalize(this);
 		return combine$1(string$1(String(normalized.value)), number$1(normalized.scale));
@@ -8155,7 +8153,7 @@ const BigDecimalProto = {
 * @category guards
 * @since 2.0.0
 */
-const isBigDecimal = (u) => hasProperty(u, TypeId$28);
+const isBigDecimal = (u) => hasProperty(u, TypeId$29);
 /**
 * Creates a `BigDecimal` from a `bigint` value and a safe integer scale.
 *
@@ -8379,7 +8377,7 @@ const toExponential = (n) => {
 */
 const isZero = (n) => n.value === bigint0$1;
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/BigInt.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/BigInt.js
 /**
 * Exposes the global bigint constructor for JavaScript bigint coercion.
 *
@@ -8444,7 +8442,7 @@ const toNumber = (b) => {
 	return some(Number(b));
 };
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/ByteSize.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/ByteSize.js
 const bigint0 = /*#__PURE__*/ BigInt(0);
 const bigint1 = /*#__PURE__*/ BigInt(1);
 const decimalBase = /*#__PURE__*/ BigInt(1e3);
@@ -8693,7 +8691,7 @@ codes[/*#__PURE__*/ "=".charCodeAt(0)] = 0;
 ({ ...BaseProto });
 ({ ...BaseProto });
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/internal/redacted.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/internal/redacted.js
 /** @internal */
 const redactedRegistry = /*#__PURE__*/ new WeakMap();
 /** @internal */
@@ -8702,7 +8700,7 @@ const value$1 = (self) => {
 	else throw new Error("Unable to get redacted value" + (self.label ? ` with label: "${self.label}"` : ""));
 };
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/Redacted.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/Redacted.js
 /**
 * Wraps sensitive values so normal output does not reveal them.
 *
@@ -8716,7 +8714,7 @@ const value$1 = (self) => {
 * @stability stable
 * @since 3.3.0
 */
-const TypeId$26 = "~effect/Redacted";
+const TypeId$27 = "~effect/Redacted";
 /**
 * Returns `true` if a value is a `Redacted` wrapper.
 *
@@ -8745,7 +8743,7 @@ const TypeId$26 = "~effect/Redacted";
 * @category guards
 * @since 3.3.0
 */
-const isRedacted = (u) => hasProperty(u, TypeId$26);
+const isRedacted = (u) => hasProperty(u, TypeId$27);
 /**
 * Creates a `Redacted` wrapper for a sensitive value.
 *
@@ -8774,13 +8772,13 @@ const isRedacted = (u) => hasProperty(u, TypeId$26);
 * @since 3.3.0
 */
 const make$20 = (value, options) => {
-	const self = Object.create(Proto$7);
+	const self = Object.create(Proto$8);
 	if (options?.label) self.label = options.label;
 	redactedRegistry.set(self, value);
 	return self;
 };
-const Proto$7 = {
-	[TypeId$26]: { _A: (_) => _ },
+const Proto$8 = {
+	[TypeId$27]: { _A: (_) => _ },
 	label: void 0,
 	...PipeInspectableProto,
 	toJSON() {
@@ -8819,9 +8817,10 @@ const Proto$7 = {
 * @since 3.3.0
 */
 const value = value$1;
+BaseProto.toString, BaseProto[NodeInspectSymbol];
 ({ ...PipeInspectableProto });
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/internal/schema/annotations.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/internal/schema/annotations.js
 /** @internal */
 function resolve$1(ast) {
 	return ast.checks ? ast.checks[ast.checks.length - 1].annotations : ast.annotations;
@@ -8837,7 +8836,7 @@ const getExpected = /*#__PURE__*/ memoize((ast) => {
 	return ast.getExpected(getExpected);
 });
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/internal/schema/parser.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/internal/schema/parser.js
 /** @internal */
 const missing = /*#__PURE__*/ Symbol();
 /** @internal */
@@ -8851,7 +8850,7 @@ const toOption = (value) => value === missing ? none() : some(value);
 /** @internal */
 const fromOptionExit = (option) => option._tag === "None" ? missingExit : succeed$1(option.value);
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/SchemaIssue.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/SchemaIssue.js
 /**
 * Describes problems found while decoding, encoding, or checking data with
 * schemas.
@@ -9348,7 +9347,7 @@ function findMessage(issue) {
 	if (typeof message === "string") return message;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/internal/schema/cause.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/internal/schema/cause.js
 /** @internal */
 function getSchemaIssue(cause) {
 	let issue;
@@ -9365,7 +9364,7 @@ function getSchemaIssueOrThrow(cause, message) {
 	return issue;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/SchemaGetter.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/SchemaGetter.js
 const makeGetter = (fields) => Object.assign(Object.create(Prototype$1), fields);
 const passthrough_$1 = /*#__PURE__*/ makeGetter({ _tag: "Passthrough" });
 function passthrough$1() {
@@ -9520,7 +9519,7 @@ function Number$4() {
 	return transform$2(globalThis.Number);
 }
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/SchemaTransformation.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/SchemaTransformation.js
 /**
 * Constructs schema middleware from its decode and encode functions.
 *
@@ -9760,7 +9759,7 @@ const defectFromJson = (options) => transform$1({
 	encode: makeEncodeDefect(options)
 });
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/SchemaAST.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/SchemaAST.js
 /**
 * Represents Effect schemas as runtime trees.
 *
@@ -10189,7 +10188,7 @@ const number = /*#__PURE__*/ new Number$3();
 * @category constructors
 * @since 4.0.0
 */
-const Boolean$4 = class extends ASTNodeImpl {
+const Boolean$5 = class extends ASTNodeImpl {
 	_tag = "Boolean";
 	/** @internal */
 	getParser() {
@@ -10215,7 +10214,7 @@ const Boolean$4 = class extends ASTNodeImpl {
 * @category constructors
 * @since 4.0.0
 */
-const boolean = /*#__PURE__*/ new Boolean$4();
+const boolean = /*#__PURE__*/ new Boolean$5();
 /**
 * Constructs a {@link Arrays}.
 *
@@ -11231,7 +11230,7 @@ function getLastEncoding(ast) {
 function annotate$1(ast, annotations) {
 	if (ast.checks) {
 		const last = ast.checks[ast.checks.length - 1];
-		return replaceChecks(ast, append$1(ast.checks.slice(0, -1), last.annotate(annotations)));
+		return replaceChecks(ast, append(ast.checks.slice(0, -1), last.annotate(annotations)));
 	}
 	return copy$1(ast, { annotations: {
 		...ast.annotations,
@@ -11257,7 +11256,7 @@ function updateLastLink(encoding, f) {
 	const links = encoding;
 	const last = links[links.length - 1];
 	const out = mapLink(last, f);
-	return out === last ? encoding : append$1(encoding.slice(0, encoding.length - 1), out);
+	return out === last ? encoding : append(encoding.slice(0, encoding.length - 1), out);
 }
 /** @internal */
 function applyToLastLink(f) {
@@ -11656,7 +11655,7 @@ const unknownToStringTree = /*#__PURE__*/ new Link(/* @__PURE__ */ new Declarati
 	toCodecStringTree: () => void 0
 }), /*#__PURE__*/ passthrough());
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/internal/schema/interpreter.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/internal/schema/interpreter.js
 const flatMapTransformation = (result, current, f) => result === sameExit ? f(current) : flatMapEager(result, f);
 function compileTransformation(transformation) {
 	if (transformation._tag === "Middleware") return (result, current, options) => {
@@ -11791,7 +11790,7 @@ function compile(ast, compile, compileField, base, specialize) {
 	};
 }
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/internal/schema/compilerRegistry.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/internal/schema/compilerRegistry.js
 /** @internal */
 const invalid = /*#__PURE__*/ Symbol();
 const cache = /*#__PURE__*/ new WeakMap();
@@ -11822,7 +11821,7 @@ function resolve(ast) {
 	return entry;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/SchemaParser.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/SchemaParser.js
 /**
 * Runs schemas against real values.
 *
@@ -12057,7 +12056,7 @@ function makeConstructorSync(ast) {
 const normalCompiler = (ast) => resolve(ast).parser;
 const constructorCompiler = (ast) => resolve(ast).makeEffect;
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/internal/schema/make.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/internal/schema/make.js
 /** @internal */
 const TypeId$21 = "~effect/Schema/Schema";
 const RebuildOptions = /*#__PURE__*/ Symbol();
@@ -12114,7 +12113,7 @@ function make$17(ast, options) {
 	return self;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/internal/schema/toCodec.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/internal/schema/toCodec.js
 function withoutConstructorDefault(context) {
 	return context.constructorDefault === void 0 ? context : new Context(context.isOptional, context.isMutable, void 0, context.annotations);
 }
@@ -12194,7 +12193,7 @@ const toCodecStringTreeAST = /*#__PURE__*/ applyToSelfOrLastLinkEncodingIdempote
 	return out;
 }, { stopAt: isCodecArrayFromSingleLink });
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/Struct.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/Struct.js
 /**
 * Wraps a plain function as a {@link Lambda} value so it can be used with
 * {@link map}, {@link mapPick}, and {@link mapOmit}.
@@ -12234,7 +12233,7 @@ const toCodecStringTreeAST = /*#__PURE__*/ applyToSelfOrLastLinkEncodingIdempote
 */
 const lambda = (f) => f;
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/internal/schemaError.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/internal/schemaError.js
 const SchemaErrorTypeId = "~effect/Schema/SchemaError";
 ({ ...BaseProto });
 ({ ...BaseProto });
@@ -12245,7 +12244,7 @@ const SchemaErrorTypeId = "~effect/Schema/SchemaError";
 ({ ...BaseProto });
 ({ ...BaseProto });
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/Schema.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/Schema.js
 const TypeId$18 = TypeId$21;
 /**
 * Error thrown or returned when schema decoding or encoding fails.
@@ -12542,7 +12541,7 @@ const String$3 = /*#__PURE__*/ make$16(string);
 * @category schemas
 * @since 4.0.0
 */
-const Boolean$3 = /*#__PURE__*/ make$16(boolean);
+const Boolean$4 = /*#__PURE__*/ make$16(boolean);
 function makeStruct(ast, fields) {
 	return make$16(ast, {
 		fields,
@@ -12698,7 +12697,7 @@ const FalseLiterals = /*#__PURE__*/ Literals([
 	"n"
 ]);
 /** @internal */
-const BooleanLiterals = /*#__PURE__*/ Literals([...TrueLiterals.literals, ...FalseLiterals.literals]).pipe(/*#__PURE__*/ decodeTo(Boolean$3, /*#__PURE__*/ transform$1({
+const BooleanLiterals = /*#__PURE__*/ Literals([...TrueLiterals.literals, ...FalseLiterals.literals]).pipe(/*#__PURE__*/ decodeTo(Boolean$4, /*#__PURE__*/ transform$1({
 	decode: (value) => value === "true" || value === "yes" || value === "on" || value === "1" || value === "y",
 	encode: (value) => value ? "true" : "false"
 })));
@@ -13096,8 +13095,32 @@ const Json = /*#__PURE__*/ make$16(/*#__PURE__*/ annotate$1(Json$1, { toCode: ()
 	runtime: "Schema.Json",
 	Type: "Schema.Json"
 }) }));
+globalThis.Boolean;
+/**
+* Chooses between two lazy branches based on a boolean value.
+*
+* **When to use**
+*
+* Use to choose between two lazy branches based on a boolean value.
+*
+* **Example** (Pattern matching on booleans)
+*
+* ```ts import.meta.vitest
+* import { Boolean } from "effect"
+*
+* Boolean.match(true, {
+*   onFalse: () => "It's false!",
+*   onTrue: () => "It's true!"
+* }) // => "It's true!"
+* ```
+*
+* @stability stable
+* @category pattern matching
+* @since 2.0.0
+*/
+const match = /*#__PURE__*/ dual(2, (value, options) => value ? options.onTrue() : options.onFalse());
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/Brand.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/Brand.js
 /**
 * Returns a `Constructor` that **does not apply any runtime checks** and just
 * returns the provided value.
@@ -13122,7 +13145,7 @@ function nominal() {
 	});
 }
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/Fiber.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/Fiber.js
 /**
 * Joins a fiber, blocking until it completes. If the fiber succeeds,
 * returns its value. If it fails, the error is propagated.
@@ -13257,7 +13280,7 @@ const getCurrent = getCurrentFiber;
 */
 const runIn = fiberRunIn;
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/Latch.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/Latch.js
 /**
 * Creates a `Latch` synchronously, outside of `Effect`.
 *
@@ -13295,222 +13318,7 @@ const runIn = fiberRunIn;
 */
 const makeUnsafe = makeLatchUnsafe;
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/MutableList.js
-/**
-* Defines the unique symbol used to represent an empty result when taking elements from a MutableList.
-* This symbol is returned by `take` when the list is empty, allowing for safe type checking.
-*
-* **When to use**
-*
-* Use to detect that `take` returned no element before handling the result as a
-* list item.
-*
-* **Example** (Checking for empty results)
-*
-* ```ts import.meta.vitest
-* import { MutableList } from "effect"
-*
-* const list = MutableList.make<string>()
-*
-* MutableList.take(list) === MutableList.Empty // => true
-* ```
-*
-* @stability stable
-* @category symbols
-* @since 4.0.0
-*/
-const Empty = /*#__PURE__*/ Symbol.for("effect/MutableList/Empty");
-/**
-* Creates an empty MutableList.
-*
-* **Example** (Creating an empty mutable list)
-*
-* ```ts import.meta.vitest
-* import { MutableList } from "effect"
-*
-* const list = MutableList.make<string>()
-*
-* list.length // => 0
-* MutableList.append(list, "first")
-* MutableList.take(list) // => "first"
-* list.length // => 0
-* ```
-*
-* @stability stable
-* @category constructors
-* @since 2.0.0
-*/
-const make$15 = () => ({
-	head: void 0,
-	tail: void 0,
-	length: 0
-});
-const compactHead = (self) => {
-	const head = self.head;
-	if (head.offset >= 1024 && head === self.tail && head.mutable && (head.array.length - head.offset) * 8 <= head.offset) self.head = self.tail = {
-		array: head.array.slice(head.offset),
-		mutable: true,
-		offset: 0,
-		next: void 0
-	};
-};
-const emptyBucket = () => ({
-	array: [],
-	mutable: true,
-	offset: 0,
-	next: void 0
-});
-/**
-* Appends an element to the end of the MutableList.
-* This operation is optimized for high-frequency usage.
-*
-* **Example** (Appending elements)
-*
-* ```ts import.meta.vitest
-* import { MutableList } from "effect"
-*
-* const list = MutableList.make<number>()
-* MutableList.append(list, 1)
-* MutableList.append(list, 2)
-* MutableList.append(list, 3)
-*
-* MutableList.toArray(list) // => [1, 2, 3]
-* list.length // => 3
-* ```
-*
-* @stability stable
-* @category mutations
-* @since 2.0.0
-*/
-const append = (self, message) => {
-	if (!self.tail) self.head = self.tail = emptyBucket();
-	else if (!self.tail.mutable) {
-		self.tail.next = emptyBucket();
-		self.tail = self.tail.next;
-	}
-	self.tail.array.push(message);
-	self.length++;
-};
-/**
-* Removes all elements from the MutableList, resetting it to an empty state.
-* This operation is highly optimized and releases all internal memory.
-*
-* **Example** (Clearing a mutable list)
-*
-* ```ts import.meta.vitest
-* import { MutableList } from "effect"
-*
-* const list = MutableList.make<number>()
-* MutableList.appendAll(list, [1, 2, 3, 4, 5])
-*
-* MutableList.clear(list)
-*
-* MutableList.toArray(list) // => []
-* list.length // => 0
-* MutableList.take(list) === MutableList.Empty // => true
-* ```
-*
-* @stability stable
-* @category mutations
-* @since 4.0.0
-*/
-const clear = (self) => {
-	self.head = self.tail = void 0;
-	self.length = 0;
-};
-/**
-* Takes up to N elements from the beginning of the MutableList and returns them as an array.
-* The taken elements are removed from the list. This operation is optimized for performance
-* and includes zero-copy optimizations when possible.
-*
-* **Details**
-*
-* Finite fractional values of `n` are rounded down. `NaN` and non-positive
-* values leave the list unchanged and return an empty array.
-*
-* **Example** (Taking batches)
-*
-* ```ts import.meta.vitest
-* import { MutableList } from "effect"
-*
-* const list = MutableList.make<number>()
-* MutableList.appendAll(list, [1, 2, 3, 4, 5, 6, 7, 8, 9, 10])
-*
-* MutableList.takeN(list, 3) // => [1, 2, 3]
-* MutableList.toArray(list) // => [4, 5, 6, 7, 8, 9, 10]
-* list.length // => 7
-* ```
-*
-* @stability stable
-* @category mutations
-* @since 4.0.0
-*/
-const takeN = (self, n) => {
-	n = normalize$1(n);
-	if (n <= 0 || !self.head) return [];
-	n = Math.min(n, self.length);
-	if (n === self.length && self.head?.offset === 0 && !self.head.next) {
-		const array = self.head.array;
-		clear(self);
-		return array;
-	}
-	const array = new Array(n);
-	let index = 0;
-	let chunk = self.head;
-	while (chunk) {
-		while (chunk.offset < chunk.array.length) {
-			array[index++] = chunk.array[chunk.offset];
-			if (chunk.mutable) chunk.array[chunk.offset] = void 0;
-			chunk.offset++;
-			if (index === n) {
-				self.head = chunk.offset === chunk.array.length && chunk.next ? chunk.next : chunk;
-				self.length -= n;
-				if (self.length === 0) clear(self);
-				else compactHead(self);
-				return array;
-			}
-		}
-		chunk = chunk.next;
-	}
-	clear(self);
-	return array;
-};
-/**
-* Takes a single element from the beginning of the MutableList.
-* Returns the element if available, or the Empty symbol if the list is empty.
-* The taken element is removed from the list.
-*
-* **Example** (Taking one element)
-*
-* ```ts import.meta.vitest
-* import { MutableList } from "effect"
-*
-* const list = MutableList.make<string>()
-* MutableList.appendAll(list, ["first", "second", "third"])
-*
-* MutableList.take(list) // => "first"
-* MutableList.toArray(list) // => ["second", "third"]
-* list.length // => 2
-* ```
-*
-* @stability stable
-* @category mutations
-* @since 4.0.0
-*/
-const take$1 = (self) => {
-	if (!self.head) return Empty;
-	const message = self.head.array[self.head.offset];
-	if (self.head.mutable) self.head.array[self.head.offset] = void 0;
-	self.head.offset++;
-	self.length--;
-	if (self.head.offset === self.head.array.length) {
-		if (self.head.next) self.head = self.head.next;
-		else clear(self);
-	} else compactHead(self);
-	return message;
-};
-//#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/Queue.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/Queue.js
 const TypeId$17 = "~effect/Queue";
 const EnqueueTypeId = "~effect/Queue/Enqueue";
 const DequeueTypeId = "~effect/Queue/Dequeue";
@@ -13574,12 +13382,12 @@ const QueueProto = {
 * @category constructors
 * @since 4.0.0
 */
-const make$14 = (options) => withFiber$1((fiber) => {
+const make$15 = (options) => withFiber$1((fiber) => {
 	const self = Object.create(QueueProto);
 	self.dispatcher = fiber.currentDispatcher;
 	self.capacity = options?.capacity ?? Number.POSITIVE_INFINITY;
 	self.strategy = options?.strategy ?? "suspend";
-	self.messages = make$15();
+	self.messages = make$29();
 	self.scheduleRunning = false;
 	self.state = {
 		_tag: "Open",
@@ -13620,7 +13428,7 @@ const make$14 = (options) => withFiber$1((fiber) => {
 * @category constructors
 * @since 2.0.0
 */
-const bounded = (capacity) => make$14({ capacity });
+const bounded = (capacity) => make$15({ capacity });
 /**
 * Adds a message to the queue. Returns `false` if the queue is done.
 *
@@ -13698,16 +13506,16 @@ const offerUnsafe = (self, message) => {
 	else if (self.messages.length >= self.capacity) {
 		if (self.strategy === "sliding") {
 			take$1(self.messages);
-			append(self.messages, message);
+			append$1(self.messages, message);
 			return true;
 		} else if (self.capacity <= 0 && self.state.takers.size > 0) {
-			append(self.messages, message);
+			append$1(self.messages, message);
 			releaseTakers(self);
 			return true;
 		}
 		return false;
 	}
-	append(self.messages, message);
+	append$1(self.messages, message);
 	scheduleReleaseTaker(self);
 	return true;
 };
@@ -14276,13 +14084,13 @@ const releaseCapacity = (self) => {
 		let n = self.capacity - self.messages.length;
 		if (n <= 0) break;
 		else if (entry._tag === "Single") {
-			append(self.messages, entry.message);
+			append$1(self.messages, entry.message);
 			self.state.offers.delete(entry);
 			entry.resume(exitTrue);
 		} else {
 			for (; entry.offset < entry.remaining.length; entry.offset++) {
 				if (n === 0) return false;
-				append(self.messages, entry.remaining[entry.offset]);
+				append$1(self.messages, entry.remaining[entry.offset]);
 				n--;
 			}
 			self.state.offers.delete(entry);
@@ -14306,7 +14114,7 @@ const finalize = (self, exit) => {
 	openState.awaiters.clear();
 };
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/Channel.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/Channel.js
 /**
 * Provides low-level building blocks for streaming data through Effect.
 *
@@ -14472,7 +14280,7 @@ const fromTransformBracket = (f) => fromTransform$1(fnUntraced(function* (upstre
 * @since 4.0.0
 */
 const toTransform = (channel) => channel.transform;
-const asyncQueue = (scope, f, options) => make$14({
+const asyncQueue = (scope, f, options) => make$15({
 	capacity: options?.bufferSize,
 	strategy: options?.strategy
 }).pipe(tap((queue) => addFinalizer$1(scope, shutdown(queue))), tap((queue) => provide$2(f(queue), scope).pipe(catchCause((cause) => failCause(queue, cause)), forkIn(scope))));
@@ -14606,7 +14414,7 @@ const mapDone = /*#__PURE__*/ dual(2, (self, f) => mapDoneEffect(self, (o) => su
 * @category sequencing
 * @since 4.0.0
 */
-const mapDoneEffect = /*#__PURE__*/ dual(2, (self, f) => transformPull$1(self, (pull) => succeed$2(catchDone(pull, (done$13) => flatMap$1(f(done$13), done)))));
+const mapDoneEffect = /*#__PURE__*/ dual(2, (self, f) => transformPull$1(self, (pull) => succeed$2(catchDone(pull, (done$14) => flatMap$1(f(done$14), done)))));
 /**
 * Returns a new channel, which is the merge of this channel and the specified
 * channel.
@@ -14684,7 +14492,7 @@ const merge$1 = /*#__PURE__*/ dual((args) => isChannel(args[0]) && isChannel(arg
 const splitLines$1 = () => fromTransform$1((upstream, _scope) => sync(() => {
 	let stringBuilder = "";
 	let midCRLF = false;
-	let done$12 = none();
+	let done$13 = none();
 	function splitLinesArray(chunk) {
 		const chunkBuilder = [];
 		function pushLine(segment) {
@@ -14729,12 +14537,12 @@ const splitLines$1 = () => fromTransform$1((upstream, _scope) => sync(() => {
 		return isReadonlyArrayNonEmpty(chunkBuilder) ? chunkBuilder : null;
 	}
 	const pullOrFlush = suspend$2(() => {
-		if (done$12._tag === "Some") return done(done$12.value);
+		if (done$13._tag === "Some") return done(done$13.value);
 		return matchEffect$1(upstream, {
 			onSuccess: loop,
 			onFailure: failCause$1,
 			onDone: (leftover) => {
-				done$12 = some(leftover);
+				done$13 = some(leftover);
 				if (stringBuilder.length > 0) {
 					const last = stringBuilder;
 					stringBuilder = "";
@@ -14886,7 +14694,7 @@ const runFold = /*#__PURE__*/ dual(3, (self, initial, f) => suspend$2(() => {
 */
 const toPullScoped = (self, scope) => toTransform(self)(done(), scope);
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/PlatformError.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/PlatformError.js
 /**
 * Normalized errors for platform APIs.
 *
@@ -15044,7 +14852,7 @@ const systemError = (options) => new PlatformError(new SystemError(options));
 */
 const badArgument = (options) => new PlatformError(new BadArgument(options));
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/internal/stream.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/internal/stream.js
 const TypeId$14 = "~effect/Stream";
 const streamVariance = {
 	_R: identity,
@@ -15063,7 +14871,7 @@ Stream.prototype = {
 /** @internal */
 const fromChannel$2 = (channel) => new Stream(channel);
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/Sink.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/Sink.js
 const TypeId$13 = "~effect/Sink";
 const endVoid = /*#__PURE__*/ succeed$2([void 0]);
 const sinkVariance = {
@@ -15254,7 +15062,7 @@ const forEachArray = (f) => fromTransform((upstream) => upstream.pipe(flatMap$1(
 */
 const unwrap$1 = (effect) => fromChannel$1(unwrap$2(map$4(effect, toChannel$1)));
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/internal/rcRef.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/internal/rcRef.js
 const TypeId$12 = "~effect/RcRef";
 const stateEmpty = { _tag: "Empty" };
 const stateClosed = { _tag: "Closed" };
@@ -15280,7 +15088,7 @@ var RcRefImpl = class {
 	}
 };
 /** @internal */
-const make$13 = (options) => withFiber((fiber) => {
+const make$14 = (options) => withFiber((fiber) => {
 	const context = fiber.context;
 	const scope = get$2(context, Scope);
 	const ref = new RcRefImpl(options.acquire, context, scope, options.idleTimeToLive !== void 0 ? fromInputUnsafe$1(options.idleTimeToLive) : void 0);
@@ -15369,7 +15177,7 @@ const release = (self, state) => {
 	return void_;
 };
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/RcRef.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/RcRef.js
 /**
 * Creates an `RcRef` from an acquire effect.
 *
@@ -15417,7 +15225,7 @@ const release = (self, state) => {
 * @category constructors
 * @since 3.5.0
 */
-const make$12 = make$13;
+const make$13 = make$14;
 /**
 * Gets the value from an `RcRef`, acquiring it first if needed.
 *
@@ -15465,7 +15273,7 @@ const make$12 = make$13;
 */
 const get = get$1;
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/Stream.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/Stream.js
 /**
 * Describes effectful sources that emit values over time.
 *
@@ -15907,7 +15715,7 @@ const runCollect = (self) => runFold(self.channel, () => [], (acc, chunk) => {
 */
 const mkString = (self) => runFold(self.channel, () => "", (acc, chunk) => acc + chunk.join(""));
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/FileSystem.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/FileSystem.js
 /**
 * Defines the portable file system service for Effect programs.
 *
@@ -15987,7 +15795,7 @@ const FileSystem = /*#__PURE__*/ Service("effect/FileSystem");
 * @category constructors
 * @since 4.0.0
 */
-const make$11 = (impl) => FileSystem.of({
+const make$12 = (impl) => FileSystem.of({
 	...impl,
 	[TypeId$10]: TypeId$10,
 	exists: (path) => pipe(impl.access(path), as(true), catchTag("PlatformError", (e) => e.reason._tag === "NotFound" ? succeed$2(false) : fail$1(e))),
@@ -16011,7 +15819,7 @@ const make$11 = (impl) => FileSystem.of({
 		return fromPull(succeed$2(flatMap$1(suspend$2(() => {
 			if (bytesToRead !== void 0 && bytesToRead <= totalBytesRead) return done();
 			return bytesToRead !== void 0 && bytesToRead - totalBytesRead < chunkSize ? file.readAlloc(Number(bytesToRead - totalBytesRead)) : readChunk;
-		}), match$4({
+		}), match$5({
 			onNone: () => done(),
 			onSome: (buf) => {
 				totalBytesRead += BigInt(buf.length);
@@ -16093,7 +15901,7 @@ const FileTypeId = "~effect/FileSystem/File";
 */
 var WatchBackend = class extends (/*#__PURE__*/ Service()("effect/FileSystem/WatchBackend")) {};
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/Path.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/Path.js
 /**
 * Provides path operations through the Effect environment.
 *
@@ -16135,8 +15943,7 @@ const TypeId$9 = "~effect/Path";
 * import { Effect, Layer, Path } from "effect"
 *
 * // Create a custom path implementation
-* const customPath: Path.Path = {
-*   [Path.TypeId]: Path.TypeId,
+* const customPath = Path.make({
 *   sep: "/",
 *   basename: (path: string, suffix?: string) => {
 *     const base = path.split("/").pop() || ""
@@ -16170,7 +15977,7 @@ const TypeId$9 = "~effect/Path";
 *   resolve: (...pathSegments: ReadonlyArray<string>) => pathSegments.join("/"),
 *   toFileUrl: (path: string) => Effect.succeed(new URL(`file://${path}`)),
 *   toNamespacedPath: (path: string) => path
-* }
+* })
 *
 * // Provide the path service
 * const customPathLayer = Layer.succeed(Path.Path)(customPath)
@@ -16189,8 +15996,40 @@ const TypeId$9 = "~effect/Path";
 * @since 4.0.0
 */
 const Path$1 = /*#__PURE__*/ Service("effect/Path");
+/**
+* Creates a `Path` service from platform path operations.
+*
+* **When to use**
+*
+* Use to build a `Path` implementation, such as a platform layer or a test
+* double, without implementing the operations that can be derived from the
+* others.
+*
+* **Details**
+*
+* Adds the `Path` type marker and derives `resolveWithin` from the provided
+* `parse`, `resolve`, `relative`, `isAbsolute`, and `sep`, so containment
+* follows the same platform rules as those operations.
+*
+* @see {@link layer} for the built-in POSIX `Path` service layer
+*
+* @stability unstable
+* @category constructors
+* @since 4.0.0
+*/
+const make$11 = (impl) => Path$1.of({
+	...impl,
+	[TypeId$9]: TypeId$9,
+	resolveWithin(root, input) {
+		if (impl.parse(input).root !== "") return none();
+		const base = impl.resolve(root);
+		const candidate = impl.resolve(base, input);
+		const relative = impl.relative(base, candidate);
+		return relative === ".." || relative.startsWith(`..${impl.sep}`) || impl.isAbsolute(relative) ? none() : some(candidate);
+	}
+});
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/ConfigProvider.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/ConfigProvider.js
 /**
 * Data sources used by `Config` to load raw configuration values. A
 * `ConfigProvider` reads paths from places such as environment variables,
@@ -16544,7 +16383,7 @@ function trieNodeAt(root, path) {
 	return node;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/Config.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/Config.js
 /**
 * Descriptions of configuration values that can be read from a
 * `ConfigProvider`. A `Config<T>` explains which keys to read, how to decode
@@ -16855,7 +16694,7 @@ function String$2(name) {
 	return schema(String$3, name);
 }
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/Console.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/Console.js
 /**
 * Context reference for the current console service in the Effect system, allowing access to the active console implementation from within the Effect context.
 *
@@ -16994,7 +16833,7 @@ const log = (...args) => consoleWith((console) => sync$1(() => {
 	console.log(...args);
 }));
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/internal/ulid.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/internal/ulid.js
 const maxTimestamp = 2 ** 48 - 1;
 const base32Chars = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
 /** @internal */
@@ -17017,7 +16856,7 @@ const ulidString = (timestampMillis, bytes) => {
 	return out;
 };
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/internal/uuid.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/internal/uuid.js
 const hex = (byte) => byte.toString(16).padStart(2, "0");
 /** @internal */
 const stringify = (bytes) => {
@@ -17051,7 +16890,7 @@ function v7Bytes(timestampMillis, bytes = randomBytes()) {
 	return bytes;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/Crypto.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/Crypto.js
 /**
 * Defines a platform-independent service for cryptographic operations.
 *
@@ -17181,7 +17020,7 @@ const validateSize = (method, size) => Number.isSafeInteger(size) && size >= 0 ?
 	description: "size must be a non-negative safe integer"
 }));
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/Runtime.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/Runtime.js
 /**
 * Helpers for turning an `Effect` program into a host application's main entry
 * point. This module is the low-level layer used by platform adapters to run a
@@ -17472,7 +17311,7 @@ const getErrorReported = (u) => {
 	return true;
 };
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/Stdio.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/Stdio.js
 /**
 * Service contract for command-line arguments and standard input, output, and
 * error output. It lets programs depend on standard I/O through the Effect
@@ -17545,7 +17384,7 @@ const make$7 = (options) => ({
 	...options
 });
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/Terminal.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/Terminal.js
 const TypeId$5 = "~effect/Terminal";
 const QuitErrorTypeId = "~effect/Terminal/QuitError";
 /**
@@ -17628,7 +17467,7 @@ const make$6 = (impl) => Terminal.of({
 	[TypeId$5]: TypeId$5
 });
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/process/ChildProcessSpawner.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/process/ChildProcessSpawner.js
 /**
 * Service boundary for starting and controlling child processes.
 *
@@ -17706,7 +17545,7 @@ const make$5 = (spawn) => {
 */
 var ChildProcessSpawner = class extends (/*#__PURE__*/ Service()("effect/process/ChildProcessSpawner")) {};
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/process/ChildProcess.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/process/ChildProcess.js
 /**
 * Describes child processes before they are started.
 *
@@ -17922,7 +17761,7 @@ const concatTokens = (prevTokens, nextTokens, isSeparated) => isSeparated || pre
 	...nextTokens.slice(1)
 ];
 //#endregion
-//#region ../../node_modules/.pnpm/@effect+platform-node-shared@4.0.4_effect@4.0.4/node_modules/@effect/platform-node-shared/dist/internal/nodeChildProcessSpawner.js
+//#region ../../node_modules/.pnpm/@effect+platform-node-shared@4.0.5_effect@4.0.5/node_modules/@effect/platform-node-shared/dist/internal/nodeChildProcessSpawner.js
 const buildSpawnOptions = (options, base, platform) => {
 	const detached = options.detached ?? platform !== "win32";
 	return {
@@ -17933,7 +17772,7 @@ const buildSpawnOptions = (options, base, platform) => {
 	};
 };
 //#endregion
-//#region ../../node_modules/.pnpm/@effect+platform-node-shared@4.0.4_effect@4.0.4/node_modules/@effect/platform-node-shared/dist/internal/utils.js
+//#region ../../node_modules/.pnpm/@effect+platform-node-shared@4.0.5_effect@4.0.5/node_modules/@effect/platform-node-shared/dist/internal/utils.js
 /** @internal */
 const handleErrnoException = (module, method) => (err, [path]) => {
 	let reason = "Unknown";
@@ -17968,7 +17807,7 @@ const handleErrnoException = (module, method) => (err, [path]) => {
 	});
 };
 //#endregion
-//#region ../../node_modules/.pnpm/@effect+platform-node-shared@4.0.4_effect@4.0.4/node_modules/@effect/platform-node-shared/dist/NodeSink.js
+//#region ../../node_modules/.pnpm/@effect+platform-node-shared@4.0.5_effect@4.0.5/node_modules/@effect/platform-node-shared/dist/NodeSink.js
 /**
 * Creates a `Sink` that writes chunks to a Node writable stream, respecting
 * backpressure, mapping writable errors with `onError`, and ending the stream
@@ -18051,7 +17890,7 @@ const pullIntoWritable = (options) => options.pull.pipe(flatMap$1((chunk) => {
 	});
 })));
 //#endregion
-//#region ../../node_modules/.pnpm/@effect+platform-node-shared@4.0.4_effect@4.0.4/node_modules/@effect/platform-node-shared/dist/NodeStream.js
+//#region ../../node_modules/.pnpm/@effect+platform-node-shared@4.0.5_effect@4.0.5/node_modules/@effect/platform-node-shared/dist/NodeStream.js
 /**
 * Adapters between Node streams and Effect streams, channels, and readables.
 *
@@ -18093,7 +17932,7 @@ const fromReadableChannel = (options) => fromTransform$1((_, scope) => readableT
 const readableToPullUnsafe = (options) => {
 	const readable = options.readable;
 	const closeOnDone = options.closeOnDone ?? true;
-	const exit = options.exit ?? make$29(void 0);
+	const exit = options.exit ?? make$30(void 0);
 	const latch = options.latch ?? makeUnsafe(false);
 	function onReadable() {
 		latch.openUnsafe();
@@ -18134,7 +17973,7 @@ const readableToPullUnsafe = (options) => {
 };
 const defaultOnError = (error) => new UnknownError(error);
 //#endregion
-//#region ../../node_modules/.pnpm/@effect+platform-node-shared@4.0.4_effect@4.0.4/node_modules/@effect/platform-node-shared/dist/NodeChildProcessSpawner.js
+//#region ../../node_modules/.pnpm/@effect+platform-node-shared@4.0.5_effect@4.0.5/node_modules/@effect/platform-node-shared/dist/NodeChildProcessSpawner.js
 const toError = (error) => error instanceof globalThis.Error ? error : new globalThis.Error(String(error));
 const toPlatformError = (method, error, command) => {
 	const { commands } = flattenCommand(command);
@@ -18596,7 +18435,7 @@ const flattenCommand = (command) => {
 	};
 };
 //#endregion
-//#region ../../node_modules/.pnpm/@effect+platform-node-shared@4.0.4_effect@4.0.4/node_modules/@effect/platform-node-shared/dist/NodeCrypto.js
+//#region ../../node_modules/.pnpm/@effect+platform-node-shared@4.0.5_effect@4.0.5/node_modules/@effect/platform-node-shared/dist/NodeCrypto.js
 /**
 * Node-compatible implementation of Effect's `Crypto` service.
 *
@@ -18627,7 +18466,7 @@ const digest = (algorithm, data) => try_({
 	})
 });
 //#endregion
-//#region ../../node_modules/.pnpm/@effect+platform-node@4.0.4_effect@4.0.4_redis@6.3.0_@opentelemetry+api@1.9.1_/node_modules/@effect/platform-node/dist/NodeCrypto.js
+//#region ../../node_modules/.pnpm/@effect+platform-node@4.0.5_effect@4.0.5_redis@6.3.0_@opentelemetry+api@1.9.1_/node_modules/@effect/platform-node/dist/NodeCrypto.js
 /**
 * The `NodeCrypto` module provides the Node.js `Crypto` service layer for
 * Effect programs. Provide {@link layer} at the edge of a Node application,
@@ -18654,7 +18493,7 @@ const layer$9 = /* @__PURE__ */ succeed$3(Crypto, /* @__PURE__ */ make$8({
 	digest
 }));
 //#endregion
-//#region ../../node_modules/.pnpm/@effect+platform-node-shared@4.0.4_effect@4.0.4/node_modules/@effect/platform-node-shared/dist/NodeFileSystem.js
+//#region ../../node_modules/.pnpm/@effect+platform-node-shared@4.0.5_effect@4.0.5/node_modules/@effect/platform-node-shared/dist/NodeFileSystem.js
 /**
 * Shared Node-compatible implementation of Effect's `FileSystem` service.
 *
@@ -18678,6 +18517,8 @@ const bigintToNumber = (value, field) => {
 	return number;
 };
 const bigintToNumberOption = (value) => flatMap$4(fromNullishOr(value), toNumber);
+const toUint64 = (value) => BigInt.asUintN(64, value);
+const toUint64Option = (value) => map$10(fromNullishOr(value), toUint64);
 const positionToNumber = (position, method) => try_({
 	try: () => bigintToNumber(position, "position"),
 	catch: handleBadArgument(method)
@@ -18952,16 +18793,16 @@ const makeFileInfo = (stat) => try_({
 		mtime: fromNullishOr(stat.mtime),
 		atime: fromNullishOr(stat.atime),
 		birthtime: fromNullishOr(stat.birthtime),
-		dev: bigintToNumber(stat.dev, "dev"),
-		rdev: bigintToNumberOption(stat.rdev),
-		ino: bigintToNumberOption(stat.ino),
+		dev: toUint64(stat.dev),
+		rdev: toUint64Option(stat.rdev),
+		ino: toUint64Option(stat.ino),
 		mode: bigintToNumber(stat.mode, "mode"),
-		nlink: bigintToNumberOption(stat.nlink),
+		nlink: toUint64Option(stat.nlink),
 		uid: bigintToNumberOption(stat.uid),
 		gid: bigintToNumberOption(stat.gid),
 		size: bytes(stat.size),
 		blksize: stat.blksize !== void 0 ? some(bytes(stat.blksize)) : none(),
-		blocks: bigintToNumberOption(stat.blocks)
+		blocks: fromNullishOr(stat.blocks)
 	}),
 	catch: handleBadArgument("stat")
 });
@@ -19019,8 +18860,8 @@ const watchNode = (path, info, options) => callback((queue) => acquireRelease(sy
 		endUnsafe(queue);
 	});
 	return watcher;
-}), (watcher) => sync(() => watcher.close())));
-const watch = (backend, path, options) => stat(path).pipe(map$4((stat) => backend.pipe(flatMap$4((_) => _.register(path, stat, options)), getOrElse(() => watchNode(path, stat, options)))), unwrap);
+}), (watcher) => sync(() => watcher.close())).pipe(tap(() => sync(() => options?.onReady?.()))));
+const watch = (backend, path, options) => all([stat(path), serviceOption(WatchBackend)]).pipe(map$4(([stat, callerBackend]) => orElse(callerBackend, () => backend).pipe(flatMap$4((_) => _.register(path, stat, options)), getOrElse(() => watchNode(path, stat, options)))), unwrap);
 const writeFile = (path, data, options) => callback$1((resume, signal) => {
 	try {
 		NFS.writeFile(path, data, {
@@ -19035,7 +18876,7 @@ const writeFile = (path, data, options) => callback$1((resume, signal) => {
 		resume(fail$1(handleBadArgument("writeFile")(err)));
 	}
 });
-const makeFileSystem = /*#__PURE__*/ map$4(/*#__PURE__*/ serviceOption(WatchBackend), (backend) => make$11({
+const makeFileSystem = /*#__PURE__*/ map$4(/*#__PURE__*/ serviceOption(WatchBackend), (backend) => make$12({
 	access,
 	chmod,
 	chown,
@@ -19065,7 +18906,7 @@ const makeFileSystem = /*#__PURE__*/ map$4(/*#__PURE__*/ serviceOption(WatchBack
 	writeFile
 }));
 //#endregion
-//#region ../../node_modules/.pnpm/@effect+platform-node@4.0.4_effect@4.0.4_redis@6.3.0_@opentelemetry+api@1.9.1_/node_modules/@effect/platform-node/dist/NodeFileSystem.js
+//#region ../../node_modules/.pnpm/@effect+platform-node@4.0.5_effect@4.0.5_redis@6.3.0_@opentelemetry+api@1.9.1_/node_modules/@effect/platform-node/dist/NodeFileSystem.js
 /**
 * Node.js `FileSystem` layer for programs that perform real filesystem I/O.
 *
@@ -19086,7 +18927,7 @@ const makeFileSystem = /*#__PURE__*/ map$4(/*#__PURE__*/ serviceOption(WatchBack
 */
 const layer$7 = /* @__PURE__ */ effect(FileSystem)(makeFileSystem);
 //#endregion
-//#region ../../node_modules/.pnpm/@effect+platform-node-shared@4.0.4_effect@4.0.4/node_modules/@effect/platform-node-shared/dist/NodePath.js
+//#region ../../node_modules/.pnpm/@effect+platform-node-shared@4.0.5_effect@4.0.5/node_modules/@effect/platform-node-shared/dist/NodePath.js
 /**
 * Node-backed provider for Effect's `Path` service.
 *
@@ -19125,7 +18966,7 @@ const fileUrlOps = (windows) => ({
 	.../*#__PURE__*/ fileUrlOps(true)
 });
 //#endregion
-//#region ../../node_modules/.pnpm/@effect+platform-node@4.0.4_effect@4.0.4_redis@6.3.0_@opentelemetry+api@1.9.1_/node_modules/@effect/platform-node/dist/NodePath.js
+//#region ../../node_modules/.pnpm/@effect+platform-node@4.0.5_effect@4.0.5_redis@6.3.0_@opentelemetry+api@1.9.1_/node_modules/@effect/platform-node/dist/NodePath.js
 /**
 * Node.js layers for Effect's `Path` service.
 *
@@ -19145,13 +18986,12 @@ const fileUrlOps = (windows) => ({
 * @category layers
 * @since 4.0.0
 */
-const layer$5 = /* @__PURE__ */ succeed$3(Path$1)({
-	[TypeId$9]: TypeId$9,
+const layer$5 = /* @__PURE__ */ succeed$3(Path$1)(/*#__PURE__*/ make$11({
 	...Path,
 	.../*#__PURE__*/ fileUrlOps(void 0)
-});
+}));
 //#endregion
-//#region ../../node_modules/.pnpm/@effect+platform-node@4.0.4_effect@4.0.4_redis@6.3.0_@opentelemetry+api@1.9.1_/node_modules/@effect/platform-node/dist/NodeStdio.js
+//#region ../../node_modules/.pnpm/@effect+platform-node@4.0.5_effect@4.0.5_redis@6.3.0_@opentelemetry+api@1.9.1_/node_modules/@effect/platform-node/dist/NodeStdio.js
 /**
 * Node.js `Stdio` layer for the current process.
 *
@@ -19218,7 +19058,7 @@ const layer$3 = /* @__PURE__ */ succeed$3(Stdio, /*#__PURE__*/ make$7({
 const layer$2 = /*#__PURE__*/ effect(Terminal, /*#__PURE__*/ (/* @__PURE__ */ fnUntraced(function* (shouldQuit = defaultShouldQuit) {
 	const stdin = process.stdin;
 	const stdout = process.stdout;
-	const lines = yield* make$14();
+	const lines = yield* make$15();
 	let inputEnded = stdin.readableEnded;
 	let readlineActive = false;
 	const onStdinEnd = () => {
@@ -19227,7 +19067,7 @@ const layer$2 = /*#__PURE__*/ effect(Terminal, /*#__PURE__*/ (/* @__PURE__ */ fn
 	};
 	stdin.once("end", onStdinEnd);
 	yield* addFinalizer(() => sync(() => stdin.off("end", onStdinEnd)));
-	const rlRef = yield* make$12({
+	const rlRef = yield* make$13({
 		acquire: acquireRelease(sync(() => {
 			const rl = readline.createInterface({
 				input: stdin,
@@ -19261,7 +19101,7 @@ const layer$2 = /*#__PURE__*/ effect(Terminal, /*#__PURE__*/ (/* @__PURE__ */ fn
 	const columns = sync(() => stdout.columns ?? 0);
 	const rows = sync(() => stdout.rows ?? 0);
 	const readInput = gen(function* () {
-		const queue = yield* make$14();
+		const queue = yield* make$15();
 		const handleKeypress = (s, k) => {
 			const userInput = {
 				input: fromUndefinedOr(s),
@@ -19293,7 +19133,7 @@ const layer$2 = /*#__PURE__*/ effect(Terminal, /*#__PURE__*/ (/* @__PURE__ */ fn
 		}
 		return queue;
 	});
-	const readLine = suspend$2(() => poll(lines).pipe(flatMap$1(match$4({
+	const readLine = suspend$2(() => poll(lines).pipe(flatMap$1(match$5({
 		onNone: () => scoped(andThen(get(rlRef), take(lines))),
 		onSome: succeed$2
 	})), mapError(() => new QuitError({}))));
@@ -19318,7 +19158,7 @@ function defaultShouldQuit(input) {
 	return key.name === "escape" || key.ctrl && (key.name === "c" || key.name === "d");
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@effect+platform-node@4.0.4_effect@4.0.4_redis@6.3.0_@opentelemetry+api@1.9.1_/node_modules/@effect/platform-node/dist/NodeServices.js
+//#region ../../node_modules/.pnpm/@effect+platform-node@4.0.5_effect@4.0.5_redis@6.3.0_@opentelemetry+api@1.9.1_/node_modules/@effect/platform-node/dist/NodeServices.js
 /**
 * Provides the default Node implementations for child process spawning,
 * filesystem, path, stdio, and terminal services.
@@ -19329,7 +19169,7 @@ function defaultShouldQuit(input) {
 */
 const layer = /*#__PURE__*/ provideMerge(layer$11, /*#__PURE__*/ mergeAll(layer$7, layer$9, layer$5, layer$3, layer$2));
 //#endregion
-//#region ../../node_modules/.pnpm/@effect+platform-node@4.0.4_effect@4.0.4_redis@6.3.0_@opentelemetry+api@1.9.1_/node_modules/@effect/platform-node/dist/NodeRuntime.js
+//#region ../../node_modules/.pnpm/@effect+platform-node@4.0.5_effect@4.0.5_redis@6.3.0_@opentelemetry+api@1.9.1_/node_modules/@effect/platform-node/dist/NodeRuntime.js
 /**
 * Node.js process runner for Effect programs.
 *
@@ -19383,7 +19223,7 @@ const runMain = /* @__PURE__ */ makeRunMain(({ fiber, teardown }) => {
 	process.on("SIGTERM", onSigint);
 });
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/cli/CliError.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/cli/CliError.js
 /**
 * Defines structured errors for the unstable CLI parser and runner.
 *
@@ -19913,7 +19753,7 @@ var ShowHelp = class extends (/*#__PURE__*/ TaggedError(`${TypeId$3}/ShowHelp`)(
 	}
 };
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/cli/Primitive.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/cli/Primitive.js
 /**
 * Parses raw command-line strings into typed values.
 *
@@ -20110,7 +19950,7 @@ const getChoiceKeys = (primitive) => primitive._tag === "Choice" ? primitive.cho
 */
 const getPathType = (primitive) => primitive._tag === "Path" ? primitive.pathType : void 0;
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/cli/internal/ansi.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/cli/internal/ansi.js
 /**
 * Internal ANSI escape sequence helpers used by the unstable CLI rendering
 * implementation. This module centralizes the control codes for text styling,
@@ -20250,7 +20090,7 @@ const eraseLines = (rows) => {
 	return command;
 };
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/cli/Prompt.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/cli/Prompt.js
 /**
 * Builds interactive terminal prompts for CLI applications.
 *
@@ -20797,7 +20637,7 @@ const handleDateClear = (options) => {
 		const resetCurrentLine = eraseLine + cursorLeft;
 		const parts = reduce(state.dateParts, "", (doc, part) => doc + part.toString());
 		const promptText = renderPrompt(parts, options.message, figures.prefix, figures.pointerSmall, figures, { plain: true });
-		const errorText = isSome(state.error) ? match$5(state.error.value.split(NEWLINE_REGEXP), {
+		const errorText = isSome(state.error) ? match$6(state.error.value.split(NEWLINE_REGEXP), {
 			onEmpty: () => "",
 			onNonEmpty: (errorLines) => separateSymbol(figures.pointerSmall, errorLines.join("\n"))
 		}) : "";
@@ -20875,7 +20715,7 @@ const processDateCursorRight = (state) => {
 };
 const processDateNext = (state) => {
 	const next = state.dateParts[state.cursor].nextPart();
-	const cursor = match$4(next, {
+	const cursor = match$5(next, {
 		onNone: () => state.dateParts.findIndex((part) => !part.isToken()),
 		onSome: (next) => state.dateParts.indexOf(next)
 	});
@@ -20964,7 +20804,7 @@ const handleDateProcess = (options) => {
 			case "down": return succeed$2(processDown(state));
 			case "tab": return succeed$2(processDateNext(state));
 			case "enter":
-			case "return": return match(options.validate(state.value), {
+			case "return": return match$1(options.validate(state.value), {
 				onFailure: (error) => Action$1.NextFrame({ state: {
 					...state,
 					error: some(error)
@@ -21218,7 +21058,7 @@ const renderPrompt = (confirm, message, leadingSymbol, trailingSymbol, theme, op
 		else if (trailingSymbol.length > 0) output += " ";
 		return output;
 	};
-	return match$5(message.split(NEWLINE_REGEXP), {
+	return match$6(message.split(NEWLINE_REGEXP), {
 		onEmpty: () => renderLine(""),
 		onNonEmpty: (promptLines) => {
 			const lines = options?.plain === true ? promptLines : map$8(promptLines, (line) => annotate(theme.colors, line, bold));
@@ -21250,7 +21090,7 @@ const renderNumberInput = (state, submitted, theme, renderOptions) => {
 	return annotate(theme.colors, value, annotation);
 };
 const renderNumberError = (state, pointer, theme, renderOptions) => {
-	if (isSome(state.error)) return match$5(state.error.value.split(NEWLINE_REGEXP), {
+	if (isSome(state.error)) return match$6(state.error.value.split(NEWLINE_REGEXP), {
 		onEmpty: () => "",
 		onNonEmpty: (errorLines) => {
 			if (renderOptions?.plain === true) return separateSymbol(pointer, errorLines.join("\n"));
@@ -21355,7 +21195,7 @@ const handleProcessInteger = (options) => {
 					...state,
 					error: some("Must provide an integer value")
 				} }));
-				else return match(options.validate(parsed), {
+				else return match$1(options.validate(parsed), {
 					onFailure: (error) => Action$1.NextFrame({ state: {
 						...state,
 						error: some(error)
@@ -21400,7 +21240,7 @@ const handleProcessFloat = (options) => {
 					...state,
 					error: some("Must provide a floating point value")
 				} }));
-				else return flatMap$1(sync(() => round(parsed, options.precision)), (rounded) => match(options.validate(rounded), {
+				else return flatMap$1(sync(() => round(parsed, options.precision)), (rounded) => match$1(options.validate(rounded), {
 					onFailure: (error) => Action$1.NextFrame({ state: {
 						...state,
 						error: some(error)
@@ -21527,7 +21367,7 @@ const renderTextInput = (nextState, options, theme, submitted, renderOptions) =>
 	}
 };
 const renderTextError = (nextState, pointer, theme, renderOptions) => {
-	if (isSome(nextState.error)) return match$5(nextState.error.value.split(NEWLINE_REGEXP), {
+	if (isSome(nextState.error)) return match$6(nextState.error.value.split(NEWLINE_REGEXP), {
 		onEmpty: () => "",
 		onNonEmpty: (errorLines) => {
 			if (renderOptions?.plain === true) return separateSymbol(pointer, errorLines.join("\n"));
@@ -21651,7 +21491,7 @@ const handleTextProcess = (options) => {
 			case "enter":
 			case "return": {
 				const value = state.value;
-				return match(options.validate(value), {
+				return match$1(options.validate(value), {
 					onFailure: (error) => Action$1.NextFrame({ state: {
 						...state,
 						value,
@@ -21757,7 +21597,7 @@ const entriesToDisplay = (cursor, total, maxVisible) => {
 	};
 };
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/cli/Param.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/cli/Param.js
 const TypeId$1 = "~effect/cli/Param";
 /**
 * Defines the kind discriminator for flag parameters.
@@ -22129,7 +21969,7 @@ const optional$1 = (param) => {
 */
 const withDefault$1 = /*#__PURE__*/ dual(2, (self, defaultValue) => {
 	if (!isEffect(defaultValue)) return map(optional$1(self), getOrElse(() => defaultValue));
-	return mapEffect(optional$1(self), match$4({
+	return mapEffect(optional$1(self), match$5({
 		onNone: () => defaultValue,
 		onSome: succeed$2
 	}));
@@ -22372,7 +22212,7 @@ const getParamMetadata = (param) => {
 	});
 };
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/cli/CliOutput.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/cli/CliOutput.js
 /**
 * Formats CLI help and errors as text.
 *
@@ -22664,1475 +22504,1485 @@ const formatHelpDocImpl = (doc, colors) => {
 	return sections.join("\n");
 };
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/cli/internal/completions/bash.js
-const escapeForBash = (s) => s.replace(/'/g, "'\\''");
-const sanitizeFunctionName = (s) => s.replace(/[^a-zA-Z0-9_]/g, "_");
-const flagNamesForWordlist = (flag) => {
-	const names = [`--${flag.name}`];
-	for (const alias of flag.aliases) names.push(alias.length === 1 ? `-${alias}` : `--${alias}`);
-	if (flag.type._tag === "Boolean") names.push(`--no-${flag.name}`);
-	return names;
-};
-/** Emit a Bash 3.2-compatible used-flag filter. */
-const buildFlagGroupDeclarations = (flags, lines) => {
-	if (flags.length === 0) return;
-	const groups = flags.map(flagNamesForWordlist);
-	lines.push(`  local ${groups.map((_, index) => `_used_${index}=""`).join(" ")}`);
-	lines.push(`  for ((i = 1; i < cword; i++)); do`);
-	lines.push(`    case "\${words[i]%%=*}" in`);
-	groups.forEach((forms, index) => {
-		lines.push(`      ${forms.join("|")}) _used_${index}=1 ;;`);
-	});
-	lines.push(`    esac`);
-	lines.push(`  done`);
-	lines.push(`  local _filtered_flags=""`);
-	groups.forEach((forms, index) => {
-		lines.push(`  [[ -n "$_used_${index}" ]] || _filtered_flags+=" ${forms.join(" ")}"`);
-	});
-	lines.push(``);
-};
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/cli/internal/config.js
 /**
-* Complete choices without `compgen -W`, which reparses quoted values. Escape
-* only the portion readline replaces for the active quote context.
+* Config Internal
+* ================
 *
-* `!` cannot be escaped inside a user-opened double quote without changing the
-* resulting argument.
+* The processed internal representation of a Command.Config declaration.
+* Separates the user's declared config shape from the flat parsing representation.
+*
+* Key concepts:
+* - ConfigInternal: The full processed form (flags, arguments, tree)
+* - ConfigInternal.Tree: Maps declaration keys to nodes
+* - ConfigInternal.Node: Param reference, Array, or Nested subtree
+*
+* Example transformation from Command.Config to Command.Config.Internal:
+*
+* ```ts
+* // User declares:
+* const config = {
+*   verbose: Flag.Boolean("verbose").pipe(Flag.withDefault(false)),
+*   server: {
+*     host: Flag.String("host"),
+*     port: Flag.Int("port")
+*   },
+*   files: Argument.String("files").pipe(Argument.variadic)
+* }
+*
+* // Becomes Config.Internal:
+* {
+*   arguments: [filesParam],           // Flat array of arguments
+*   flags: [verboseParam, hostParam, portParam],  // Flat array of flags
+*   orderedParams: [verboseParam, hostParam, portParam, filesParam],
+*   tree: {                            // Preserves nested structure
+*     verbose: { _tag: "Param", index: 0 },
+*     server: {
+*       _tag: "Nested",
+*       tree: {
+*         host: { _tag: "Param", index: 1 },
+*         port: { _tag: "Param", index: 2 }
+*       }
+*     },
+*     files: { _tag: "Param", index: 3 }
+*   }
+* }
+* ```
+*
+* This separation allows:
+* 1. Flat iteration over all params for parsing/validation
+* 2. Reconstruction of original nested shape for handler input
 */
-const choicesHelper = (helperName, lines) => {
-	lines.push(`${helperName}()`);
-	lines.push(`{`);
-	lines.push(`  local _cur="$1" _word="$2"; shift 2`);
-	lines.push(``);
-	lines.push(`  local _head="\${_cur%"$_word"}"`);
-	lines.push(`  local _open=""`);
-	lines.push(`  case "$_head" in`);
-	lines.push(`    *\\') _open="'" ;;`);
-	lines.push(`    *\\") _open='"' ;;`);
-	lines.push(`  esac`);
-	lines.push(``);
-	lines.push(`  local _prefix="$_cur" _committed="$_head"`);
-	lines.push(`  _prefix=\${_prefix//\\\\/}; _prefix=\${_prefix//\\"/}; _prefix=\${_prefix//\\'/}`);
-	lines.push(`  _committed=\${_committed//\\\\/}; _committed=\${_committed//\\"/}; _committed=\${_committed//\\'/}`);
-	lines.push(``);
-	lines.push(`  COMPREPLY=()`);
-	lines.push(`  local _choice _rest _match`);
-	lines.push(`  for _choice in "$@"; do`);
-	lines.push(`    [[ "$_choice" == "$_prefix"* ]] || continue`);
-	lines.push(`    _rest="\${_choice#"$_committed"}"`);
-	lines.push(`    case "$_open" in`);
-	lines.push(`      "'")`);
-	lines.push(`        if [[ "$_head" == "'" ]]; then`);
-	lines.push(`          _match=\${_rest//\\'/\\'\\\\\\'\\'}`);
-	lines.push(`        else`);
-	lines.push(`          [[ "$_rest" == *\\'* ]] && continue`);
-	lines.push(`          _match="$_rest"`);
-	lines.push(`        fi`);
-	lines.push(`        ;;`);
-	lines.push(`      '"')`);
-	lines.push(`        _match="\${_rest//\\\\/\\\\\\\\}"`);
-	lines.push(`        _match="\${_match//\\$/\\\\$}"`);
-	lines.push("        _match=\"${_match//\\`/\\\\\\`}\"");
-	lines.push(`        _match="\${_match//\\"/\\\\\\"}"`);
-	lines.push(`        ;;`);
-	lines.push(`      *)`);
-	lines.push(`        printf -v _match '%q' "$_rest"`);
-	lines.push(`        [[ -z "$_head" && "$_match" == '~'* ]] && _match="\\\\$_match"`);
-	lines.push(`        ;;`);
-	lines.push(`    esac`);
-	lines.push(`    [[ -n "$_open" && "$_match" == *"$_open" ]] && _match+="$_open"`);
-	lines.push(`    COMPREPLY+=("$_match")`);
-	lines.push(`  done`);
-	lines.push(`}`);
-	lines.push(``);
-};
-const choiceCompletion = (helperName, values) => `${helperName} "$cur" "$_comp_word" ${values.map((value) => `'${escapeForBash(value)}'`).join(" ")}`;
-const flagValueCompletion = (type, helperName) => {
-	switch (type._tag) {
-		case "Boolean": return;
-		case "Choice": return choiceCompletion(helperName, type.values);
-		case "Path":
-			if (type.pathType === "directory") return `COMPREPLY=( $(compgen -d -- "$cur") )`;
-			return `COMPREPLY=( $(compgen -f -- "$cur") )`;
-		default: return;
-	}
-};
-const argCompletion = (type, helperName) => {
-	switch (type._tag) {
-		case "Choice": return choiceCompletion(helperName, type.values);
-		case "Path":
-			if (type.pathType === "directory") return `COMPREPLY=( $(compgen -d -- "$cur") )`;
-			return `COMPREPLY=( $(compgen -f -- "$cur") )`;
-		default: return;
-	}
-};
-const generateFunction$1 = (descriptor, parentPath, lines, helperName) => {
-	const currentPath = [...parentPath, descriptor.name];
-	const funcName = `_${currentPath.map(sanitizeFunctionName).join("_")}`;
-	lines.push(`${funcName}()`);
-	lines.push(`{`);
-	lines.push(`  local cur prev words cword i`);
-	lines.push(parentPath.length === 0 ? `  local _command_index=0` : `  local _command_index="$1"`);
-	lines.push(`  _init_completion -n "$COMP_WORDBREAKS" || return`);
-	if (parentPath.length === 0) lines.push(`  local _comp_word="$2"`);
-	lines.push(``);
-	const flagsWithValues = descriptor.flags.filter((f) => f.type._tag !== "Boolean");
-	if (flagsWithValues.length > 0) {
-		lines.push(`  # Flag value completions`);
-		lines.push(`  case "$prev" in`);
-		for (const flag of flagsWithValues) {
-			const longNames = [`--${flag.name}`];
-			for (const alias of flag.aliases) longNames.push(alias.length === 1 ? `-${alias}` : `--${alias}`);
-			const completion = flagValueCompletion(flag.type, helperName);
-			if (completion) {
-				lines.push(`    ${longNames.join("|")})`);
-				lines.push(`      ${completion}`);
-				lines.push(`      return`);
-				lines.push(`      ;;`);
-			}
-		}
-		lines.push(`  esac`);
-		lines.push(``);
-	}
-	if (descriptor.subcommands.length > 0) {
-		lines.push(`  # Subcommand dispatch`);
-		lines.push(`  local cmd _skip_next=0`);
-		lines.push(`  for ((i = _command_index + 1; i < cword; i++)); do`);
-		lines.push(`    if (( _skip_next )); then`);
-		lines.push(`      _skip_next=0`);
-		lines.push(`      continue`);
-		lines.push(`    fi`);
-		lines.push(`    case "\${words[i]}" in`);
-		for (const flag of descriptor.flags) {
-			if (flag.type._tag === "Boolean") continue;
-			const forms = flagNamesForWordlist(flag);
-			lines.push(`      ${forms.join("|")}) _skip_next=1 ;;`);
-			lines.push(`      ${forms.map((form) => `${form}=*`).join("|")}) ;;`);
-		}
-		for (const sub of descriptor.subcommands) {
-			const subFuncName = `_${[...currentPath, sub.name].map(sanitizeFunctionName).join("_")}`;
-			lines.push(`      ${sub.name})`);
-			lines.push(`        ${subFuncName} "$i"`);
-			lines.push(`        return`);
-			lines.push(`        ;;`);
-		}
-		lines.push(`    esac`);
-		lines.push(`  done`);
-		lines.push(``);
-	}
-	buildFlagGroupDeclarations(descriptor.flags, lines);
-	if (descriptor.flags.length > 0 || descriptor.subcommands.length > 0) {
-		lines.push(`  # Complete flags (filtered) and subcommands`);
-		lines.push(`  if [[ "$cur" == -* ]]; then`);
-		if (descriptor.flags.length > 0) lines.push(`    COMPREPLY=( $(compgen -W "$_filtered_flags" -- "$cur") )`);
-		lines.push(`    return`);
-		lines.push(`  fi`);
-		lines.push(``);
+const ConfigInternalTypeId = "~effect/cli/Command/Config/Internal";
+/**
+* Parses a Command.Config into a ConfigInternal.
+*
+* Walks the config structure and:
+* 1. Extracts all Params into flat arrays (flags, arguments, orderedParams)
+* 2. Builds a tree that remembers the original nested structure
+* 3. Assigns each Param an index to link parsed values back
+*
+* @internal
+*/
+const parseConfig = (config) => {
+	const orderedParams = [];
+	const flags = [];
+	const args = [];
+	function parse(config) {
+		const tree = Object.create(null);
+		for (const key of Object.keys(config)) tree[key] = parseValue(config[key]);
+		return tree;
 	}
-	const argsWithCompletions = descriptor.arguments.flatMap((argument, index) => {
-		const completion = argCompletion(argument.type, helperName);
-		return completion === void 0 ? [] : [{
-			argument,
-			completion,
-			index
-		}];
-	});
-	if (argsWithCompletions.length > 0) {
-		lines.push(`  # Positional argument completions`);
-		lines.push(`  local _position=0 _skip_next=0 _end_of_options=0`);
-		lines.push(`  for ((i = _command_index + 1; i < cword; i++)); do`);
-		lines.push(`    if (( _skip_next )); then`);
-		lines.push(`      _skip_next=0`);
-		lines.push(`      continue`);
-		lines.push(`    fi`);
-		lines.push(`    if (( _end_of_options )); then`);
-		lines.push(`      ((_position += 1))`);
-		lines.push(`      continue`);
-		lines.push(`    fi`);
-		lines.push(`    case "\${words[i]}" in`);
-		lines.push(`      --) _end_of_options=1 ;;`);
-		for (const flag of descriptor.flags) {
-			const forms = flagNamesForWordlist(flag);
-			if (flag.type._tag === "Boolean") lines.push(`      ${forms.join("|")}) ;;`);
-			else {
-				lines.push(`      ${forms.join("|")}) _skip_next=1 ;;`);
-				lines.push(`      ${forms.map((form) => `${form}=*`).join("|")}) ;;`);
-			}
-		}
-		lines.push(`      -*) ;;`);
-		lines.push(`      *) ((_position += 1)) ;;`);
-		lines.push(`    esac`);
-		lines.push(`  done`);
-		lines.push(`  case "$_position" in`);
-		for (const { argument, completion, index } of argsWithCompletions) {
-			if (argument.variadic) continue;
-			lines.push(`    ${index})`);
-			lines.push(`      ${completion}`);
-			lines.push(`      return`);
-			lines.push(`      ;;`);
-		}
-		lines.push(`  esac`);
-		const variadic = argsWithCompletions.find(({ argument }) => argument.variadic);
-		if (variadic !== void 0) {
-			lines.push(`  if (( _position >= ${variadic.index} )); then`);
-			lines.push(`    ${variadic.completion}`);
-			lines.push(`    return`);
-			lines.push(`  fi`);
-		}
-	} else if (descriptor.subcommands.length > 0) {
-		const subNames = descriptor.subcommands.map((s) => s.name);
-		lines.push(`  COMPREPLY=( $(compgen -W '${subNames.join(" ")}' -- "$cur") )`);
+	function parseValue(value) {
+		if (Array.isArray(value)) return {
+			_tag: "Array",
+			children: value.map((v) => parseValue(v))
+		};
+		else if (isParam(value)) {
+			const index = orderedParams.length;
+			orderedParams.push(value);
+			if (value.kind === "argument") args.push(value);
+			else flags.push(value);
+			return {
+				_tag: "Param",
+				index
+			};
+		} else return {
+			_tag: "Nested",
+			tree: parse(value)
+		};
 	}
-	lines.push(`}`);
-	lines.push(``);
-	for (const sub of descriptor.subcommands) generateFunction$1(sub, currentPath, lines, helperName);
+	return {
+		[ConfigInternalTypeId]: ConfigInternalTypeId,
+		flags,
+		arguments: args,
+		orderedParams,
+		tree: parse(config)
+	};
 };
 /**
 * @internal
 */
-const generate$4 = (executableName, descriptor) => {
-	const lines = [];
-	const safeName = sanitizeFunctionName(executableName);
-	const helperName = `_${safeName}--choices`;
-	lines.push(`###-begin-${escapeForBash(executableName)}-completions-###`);
-	lines.push(`#`);
-	lines.push(`# Static completion script for Bash`);
-	lines.push(`#`);
-	lines.push(`# Installation:`);
-	lines.push(`#   ${escapeForBash(executableName)} --completions bash >> ~/.bashrc`);
-	lines.push(`#`);
-	lines.push(``);
-	lines.push(`if ! type _init_completion &>/dev/null; then`);
-	lines.push(`  _init_completion()`);
-	lines.push(`  {`);
-	lines.push(`    COMPREPLY=()`);
-	lines.push(`    local _i _j=0 _piece _line="$COMP_LINE"`);
-	lines.push(`    words=("\${COMP_WORDS[0]}")`);
-	lines.push(`    cword=0`);
-	lines.push(`    _line="\${_line#*"\${COMP_WORDS[0]}"}"`);
-	lines.push(`    for ((_i = 1; _i < \${#COMP_WORDS[@]}; _i++)); do`);
-	lines.push(`      _piece="\${COMP_WORDS[_i]}"`);
-	lines.push(`      if [[ "$_line" == [[:blank:]]* ]]; then`);
-	lines.push(`        ((_j++))`);
-	lines.push(`        words[_j]="$_piece"`);
-	lines.push(`      else`);
-	lines.push(`        words[_j]="\${words[_j]}$_piece"`);
-	lines.push(`      fi`);
-	lines.push(`      ((_i == COMP_CWORD)) && cword=$_j`);
-	lines.push(`      _line="\${_line#*"$_piece"}"`);
-	lines.push(`    done`);
-	lines.push(`    cur="\${words[cword]}"`);
-	lines.push(`    prev=""`);
-	lines.push(`    ((cword > 0)) && prev="\${words[cword-1]}"`);
-	lines.push(`    return 0`);
-	lines.push(`  }`);
-	lines.push(`fi`);
-	lines.push(``);
-	choicesHelper(helperName, lines);
-	generateFunction$1(descriptor, [], lines, helperName);
-	lines.push(`complete -F _${safeName} ${escapeForBash(executableName)}`);
-	lines.push(`###-end-${escapeForBash(executableName)}-completions-###`);
-	return lines.join("\n");
-};
-//#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/cli/internal/completions/fish.js
-const escapeFishString = (s) => s.replace(/\\/g, "\\\\").replace(/'/g, "\\'");
-/** Escape choices for Fish's second expansion of `complete -a`. */
-const escapeFishChoice = (s) => escapeFishString(s.replace(/[^A-Za-z0-9_.,/@%+-]/gu, "\\$&"));
+const emptyConfig = /*#__PURE__*/ parseConfig({});
 /**
-* Build a Fish condition that checks the current subcommand context.
+* Reconstructs the original nested config shape from parsed values.
 *
-* For root-level completions with subcommands: `__fish_use_subcommand`
-* For nested commands: verify the full parent path is active AND none of its
-* child subcommands have been entered yet.
+* Uses the tree as a blueprint to place each parsed value back into
+* its original position in the nested structure.
+*
+* @internal
 */
-const subcommandCondition = (parentPath, childSubcommandNames) => {
-	if (parentPath.length === 0) {
-		if (childSubcommandNames.length > 0) return `__fish_use_subcommand`;
-		return ``;
+const reconstructTree = (tree, results) => {
+	const output = {};
+	for (const key of Object.keys(tree)) assignProperty(output, key, nodeValue(tree[key]));
+	return output;
+	function nodeValue(node) {
+		switch (node._tag) {
+			case "Param": return results[node.index];
+			case "Array": return node.children.map((child) => nodeValue(child));
+			case "Nested": return reconstructTree(node.tree, results);
+		}
 	}
-	const parentCondition = parentPath.map((parent) => `__fish_seen_subcommand_from ${parent}`).join("; and ");
-	if (childSubcommandNames.length > 0) return `${parentCondition}; and not __fish_seen_subcommand_from ${childSubcommandNames.join(" ")}`;
-	return parentCondition;
 };
+//#endregion
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/cli/internal/command.js
 /**
-* Build a __fish_contains_opt condition that checks whether any form of this
-* flag has already been typed. Returns the condition string without wrapping
-* quotes (the caller adds those).
+* Command Implementation
+* ======================
+*
+* Internal implementation details for CLI commands.
+* Public API is in ../Command.ts
 */
-const flagContainsOptCondition = (flag) => {
-	const optArgs = [];
-	for (const alias of flag.aliases) if (alias.length === 1) optArgs.push(`-s ${alias}`);
-	optArgs.push(flag.name);
-	for (const alias of flag.aliases) if (alias.length > 1) optArgs.push(alias);
-	if (flag.type._tag === "Boolean") optArgs.push(`no-${flag.name}`);
-	return `not __fish_contains_opt ${optArgs.join(" ")}`;
-};
-/** Hide used value flags without suppressing their value completions. */
-const valueFlagDedupCondition = (flag) => {
-	const forms = [`--${flag.name}`];
-	for (const alias of flag.aliases) forms.push(alias.length === 1 ? `-${alias}` : `--${alias}`);
-	return `begin; ${flagContainsOptCondition(flag)}; or contains -- (commandline -poc)[-1] ${forms.join(" ")}; end`;
-};
-const flagCompletionArgs = (flag) => {
-	const args = [`-l ${flag.name}`];
-	for (const alias of flag.aliases) if (alias.length === 1) args.push(`-s ${alias}`);
-	else args.push(`-l ${alias}`);
-	if (flag.description) args.push(`-d '${escapeFishString(flag.description)}'`);
-	const valueArgs = flagValueArgs(flag.type);
-	if (valueArgs) args.push(valueArgs);
-	return args;
-};
-const flagValueArgs = (type) => {
-	switch (type._tag) {
-		case "Boolean": return;
-		case "Choice": return `-r -f -a '${type.values.map(escapeFishChoice).join(" ")}'`;
-		case "Path":
-			if (type.pathType === "directory") return `-r -F`;
-			return `-r -F`;
-		default: return `-r -f`;
-	}
-};
-const argValueArgs = (type) => {
-	switch (type._tag) {
-		case "Choice": return `-r -f -a '${type.values.map(escapeFishChoice).join(" ")}'`;
-		case "Path": return `-r -F`;
-		default: return;
-	}
-};
-const generateCompletions = (executableName, descriptor, parentPath, lines) => {
-	const allSubNames = descriptor.subcommands.map((s) => s.name);
-	const condition = subcommandCondition(parentPath, allSubNames);
-	const conditionArg = condition ? `-n '${condition}'` : ``;
-	if (!descriptor.arguments.some((a) => a.type._tag === "Path")) {
-		const parts = [`complete -c ${executableName}`];
-		if (conditionArg) parts.push(conditionArg);
-		parts.push(`-f`);
-		lines.push(parts.join(" "));
-	}
-	for (const sub of descriptor.subcommands) {
-		const parts = [`complete -c ${executableName}`];
-		if (conditionArg) parts.push(conditionArg);
-		parts.push(`-f -a '${escapeFishString(sub.name)}'`);
-		if (sub.description) parts.push(`-d '${escapeFishString(sub.description)}'`);
-		lines.push(parts.join(" "));
+const TypeId = "~effect/cli/Command";
+/**
+* Casts a Command to its internal implementation.
+* For use by internal modules that need access to config, parse, handle, etc.
+*/
+const toImpl = (self) => self;
+const Proto = { .../*#__PURE__*/ Prototype({
+	label: "Command",
+	evaluate() {
+		return toImpl(this).service;
 	}
-	for (const flag of descriptor.flags) {
-		const isBoolean = flag.type._tag === "Boolean";
-		const dedup = isBoolean ? flagContainsOptCondition(flag) : valueFlagDedupCondition(flag);
-		const flagCondition = condition ? `${condition}; and ${dedup}` : dedup;
-		const flagCondArg = flagCondition ? `-n '${flagCondition}'` : ``;
-		const parts = [`complete -c ${executableName}`];
-		if (flagCondArg) parts.push(flagCondArg);
-		parts.push(...flagCompletionArgs(flag));
-		lines.push(parts.join(" "));
-		if (isBoolean) {
-			const negParts = [`complete -c ${executableName}`];
-			if (flagCondArg) negParts.push(flagCondArg);
-			negParts.push(`-l no-${flag.name}`);
-			if (flag.description) negParts.push(`-d '${escapeFishString(`Disable ${flag.name}`)}'`);
-			lines.push(negParts.join(" "));
+}) };
+/**
+* Internal command constructor. Only accepts already-parsed ConfigInternal.
+*/
+const makeCommand = (options) => {
+	const config = options.config;
+	const contextConfig = options.contextConfig ?? emptyConfig;
+	const service = options.service ?? Service(`~effect/cli/Command/${options.name}`);
+	const annotations = options.annotations ?? empty$2();
+	const globalFlags = options.globalFlags ?? [];
+	const subcommands = options.subcommands ?? [];
+	const handle = (input, commandPath) => isNotUndefined(options.handle) ? options.handle(input, commandPath) : fail$1(new ShowHelp({
+		commandPath,
+		errors: []
+	}));
+	const parse = options.parse ?? makeParser(config);
+	const parseContext = options.parseContext ?? makeParser(contextConfig, { allowLeftovers: true });
+	const buildHelpDoc = (commandPath) => {
+		const args = [];
+		const flags = [];
+		for (const arg of config.arguments) {
+			const singles = extractSingleParams(arg);
+			const metadata = getParamMetadata(arg);
+			for (const single of singles) args.push({
+				name: single.name,
+				type: single.typeName ?? getTypeName(single.primitiveType),
+				description: single.description,
+				required: !metadata.isOptional && (!metadata.isVariadic || exists(metadata.variadicMin, (min) => min > 0)),
+				variadic: metadata.isVariadic
+			});
 		}
-	}
-	if (descriptor.flags.length > 0) {
-		const notDash = `not string match -q -- "-*" (commandline -ct)`;
-		const bareBase = condition ? `${condition}; and ${notDash}` : notDash;
-		for (const flag of descriptor.flags) {
-			const bareCondition = `${bareBase}; and ${flagContainsOptCondition(flag)}`;
-			const isBoolean = flag.type._tag === "Boolean";
-			const parts = [`complete -c ${executableName}`];
-			parts.push(`-n '${bareCondition}'`);
-			parts.push(`-f -a '--${flag.name}'`);
-			if (flag.description) parts.push(`-d '${escapeFishString(flag.description)}'`);
-			lines.push(parts.join(" "));
-			if (isBoolean) {
-				const negParts = [`complete -c ${executableName}`];
-				negParts.push(`-n '${bareCondition}'`);
-				negParts.push(`-f -a '--no-${flag.name}'`);
-				if (flag.description) negParts.push(`-d '${escapeFishString(`Disable ${flag.name}`)}'`);
-				lines.push(negParts.join(" "));
+		let usage = commandPath.length > 0 ? commandPath.join(" ") : options.name;
+		if (subcommands.some((group) => group.commands.some((c) => !c.unlisted))) usage += " <subcommand>";
+		usage += " [flags]";
+		for (const arg of args) {
+			const argName = arg.variadic ? `<${arg.name}...>` : `<${arg.name}>`;
+			usage += ` ${arg.required ? argName : `[${argName}]`}`;
+		}
+		for (const option of config.flags) {
+			const singles = extractSingleParams(option);
+			const metadata = getParamMetadata(option);
+			for (const single of singles) {
+				if (single.hidden) continue;
+				flags.push(toFlagDoc(single, metadata));
 			}
 		}
-	}
-	for (const arg of descriptor.arguments) {
-		const valueArg = argValueArgs(arg.type);
-		if (valueArg) {
-			const parts = [`complete -c ${executableName}`];
-			if (conditionArg) parts.push(conditionArg);
-			parts.push(valueArg);
-			if (arg.description) parts.push(`-d '${escapeFishString(arg.description)}'`);
-			lines.push(parts.join(" "));
+		const subcommandDocs = [];
+		for (const group of subcommands) {
+			const visible = group.commands.filter((c) => !c.unlisted);
+			if (visible.length === 0) continue;
+			subcommandDocs.push({
+				group: group.group,
+				commands: map$8(visible, (subcommand) => ({
+					name: subcommand.name,
+					alias: subcommand.alias,
+					shortDescription: subcommand.shortDescription,
+					description: subcommand.description ?? ""
+				}))
+			});
 		}
-	}
-	for (const sub of descriptor.subcommands) generateCompletions(executableName, sub, [...parentPath, sub.name], lines);
+		const examples = options.examples ?? [];
+		return {
+			description: options.description ?? "",
+			usage,
+			flags,
+			annotations,
+			...args.length > 0 && { args },
+			...subcommandDocs.length > 0 && { subcommands: subcommandDocs },
+			...examples.length > 0 && { examples }
+		};
+	};
+	return Object.assign(Object.create(Proto), {
+		[TypeId]: TypeId,
+		name: options.name,
+		examples: options.examples ?? [],
+		annotations,
+		globalFlags,
+		subcommands,
+		unlisted: options.unlisted ?? false,
+		config,
+		contextConfig,
+		service,
+		parse,
+		parseContext,
+		handle,
+		buildHelpDoc,
+		...isNotUndefined(options.description) ? { description: options.description } : {},
+		...isNotUndefined(options.shortDescription) ? { shortDescription: options.shortDescription } : {},
+		...isNotUndefined(options.alias) ? { alias: options.alias } : {}
+	});
 };
 /**
+* Converts a single flag param into a FlagDoc for help display.
+*
 * @internal
 */
-const generate$3 = (executableName, descriptor) => {
-	const lines = [];
-	lines.push(`###-begin-${executableName}-completions-###`);
-	lines.push(`#`);
-	lines.push(`# Static completion script for Fish`);
-	lines.push(`#`);
-	lines.push(`# Installation:`);
-	lines.push(`#   ${executableName} --completions fish > ~/.config/fish/completions/${executableName}.fish`);
-	lines.push(`#`);
-	lines.push(``);
-	generateCompletions(executableName, descriptor, [], lines);
-	lines.push(``);
-	lines.push(`###-end-${executableName}-completions-###`);
-	return lines.join("\n");
+const toFlagDoc = (single, metadata) => {
+	const formattedAliases = single.aliases.map((alias) => alias.length === 1 ? `-${alias}` : `--${alias}`);
+	const type = single.typeName ?? getTypeName(single.primitiveType);
+	return {
+		name: single.name,
+		aliases: formattedAliases,
+		type: single.optionalValue === void 0 ? type : `[=${type}]`,
+		description: appendChoiceKeys(single.description, getChoiceKeys(single.primitiveType)),
+		required: single.primitiveType._tag !== "Boolean" && !metadata.isOptional
+	};
+};
+const appendChoiceKeys = (description, choiceKeys) => {
+	if (choiceKeys === void 0 || choiceKeys.length === 0) return description;
+	const choiceSuffix = `(choices: ${choiceKeys.join(", ")})`;
+	return match$5(description, {
+		onNone: () => some(choiceSuffix),
+		onSome: (value) => some(`${value} ${choiceSuffix}`)
+	});
 };
-//#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/cli/internal/completions/powershell.js
 /**
-* Encode non-ASCII and control characters as `[char]` code units. Windows
-* PowerShell 5.1 can misread BOM-less UTF-8 as ANSI, turning some bytes into
-* PowerShell quote delimiters.
+* Creates a parser for a given config. Used as the default for both `parse`
+* and `parseContext`, and also by `withSharedFlags` to avoid constructing a
+* full throwaway command.
 */
-const quotePs = (s) => {
-	const parts = [];
-	let literal = "";
-	for (let i = 0; i < s.length; i++) {
-		const code = s.charCodeAt(i);
-		if (code >= 32 && code < 128) {
-			literal += s[i] === "'" ? "''" : s[i];
-			continue;
-		}
-		if (literal !== "" || parts.length === 0) parts.push(`'${literal}'`);
-		literal = "";
-		parts.push(`[char]0x${code.toString(16).toUpperCase().padStart(4, "0")}`);
-	}
-	if (literal !== "" || parts.length === 0) parts.push(`'${literal}'`);
-	return parts.length === 1 ? parts[0] : `(${parts.join(" + ")})`;
-};
-const psArray = (items) => `@(${items.map(quotePs).join(", ")})`;
-const psOptional = (s) => s ? quotePs(s) : "$null";
-const sanitize$1 = (s) => s.replace(/[^a-zA-Z0-9_]/g, "_");
-const flagForms = (flag) => [`--${flag.name}`, ...flag.aliases.map((alias) => alias.length === 1 ? `-${alias}` : `--${alias}`)];
-const valueFields = (type) => `values = ${psArray(type._tag === "Choice" ? type.values : [])}; pathType = ${type._tag === "Path" ? quotePs(type.pathType) : "$null"}`;
-const flagEntry = (flag) => `@{ name = ${quotePs(flag.name)}; forms = ${psArray(flagForms(flag))}; takesValue = $${flag.type._tag !== "Boolean"}; ${valueFields(flag.type)}; description = ${psOptional(flag.description)} }`;
-const argumentEntry = (argument) => `@{ name = ${quotePs(argument.name)}; variadic = $${argument.variadic}; ${valueFields(argument.type)}; description = ${psOptional(argument.description)} }`;
-const pushList = (lines, field, entries) => {
-	if (entries.length === 0) {
-		lines.push(`  ${field} = @()`);
-		return;
+const makeParser = (cfg, options) => fnUntraced(function* (input) {
+	const parsedArgs = {
+		flags: input.flags,
+		arguments: input.arguments
+	};
+	const [remainingArguments, values] = yield* parseParams(parsedArgs, cfg.orderedParams);
+	if (options?.allowLeftovers !== true && remainingArguments.length > 0) return yield* new UnexpectedArgument({ arguments: remainingArguments });
+	return reconstructTree(cfg.tree, values);
+});
+/**
+* Parses param values from parsed command arguments into their typed
+* representations.
+*/
+const parseParams = /*#__PURE__*/ fnUntraced(function* (parsedArgs, params) {
+	const results = [];
+	let currentArguments = parsedArgs.arguments;
+	for (const option of params) {
+		const [remainingArguments, parsed] = yield* option.parse({
+			flags: parsedArgs.flags,
+			arguments: currentArguments
+		});
+		results.push(parsed);
+		currentArguments = remainingArguments;
+	}
+	return [currentArguments, results];
+});
+//#endregion
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/cli/internal/completions/descriptor.js
+/**
+* CommandDescriptor — pure-data representation of a command tree for
+* shell completion generation.
+*
+* @internal
+*/
+const toFlagType = (single) => {
+	switch (single.primitiveType._tag) {
+		case "Boolean": return { _tag: "Boolean" };
+		case "Int": return { _tag: "Int" };
+		case "Finite": return { _tag: "Finite" };
+		case "Date": return { _tag: "Date" };
+		case "Choice": return {
+			_tag: "Choice",
+			values: getChoiceKeys(single.primitiveType) ?? []
+		};
+		case "Path": return {
+			_tag: "Path",
+			pathType: getPathType(single.primitiveType) ?? "either"
+		};
+		case "FileText":
+		case "FileParse":
+		case "FileSchema": return {
+			_tag: "Path",
+			pathType: "file"
+		};
+		default: return { _tag: "String" };
+	}
+};
+const toArgumentType = (single) => {
+	switch (single.primitiveType._tag) {
+		case "Int": return { _tag: "Int" };
+		case "Finite": return { _tag: "Finite" };
+		case "Date": return { _tag: "Date" };
+		case "Choice": return {
+			_tag: "Choice",
+			values: getChoiceKeys(single.primitiveType) ?? []
+		};
+		case "Path": return {
+			_tag: "Path",
+			pathType: getPathType(single.primitiveType) ?? "either"
+		};
+		case "FileText":
+		case "FileParse":
+		case "FileSchema": return {
+			_tag: "Path",
+			pathType: "file"
+		};
+		default: return { _tag: "String" };
 	}
-	lines.push(`  ${field} = @(`);
-	for (const entry of entries) lines.push(`    ${entry}`);
-	lines.push(`  )`);
 };
 /**
-* Emit one context per subcommand path. Subcommands are case-sensitive, so
-* contexts go in an ordinal hashtable instead of a hash literal, whose keys
-* ignore case.
+* @internal
 */
-const generateContexts = (dataName, descriptor, path, lines, seen) => {
-	const key = path.join(" ");
-	if (seen.has(key)) return;
-	seen.add(key);
-	lines.push(`${dataName}[${quotePs(key)}] = @{`);
-	pushList(lines, "subcommands", descriptor.subcommands.map((sub) => `@{ name = ${quotePs(sub.name)}; description = ${psOptional(sub.description)} }`));
-	pushList(lines, "flags", descriptor.flags.map(flagEntry));
-	pushList(lines, "arguments", descriptor.arguments.map(argumentEntry));
-	lines.push(`}`);
-	for (const sub of descriptor.subcommands) generateContexts(dataName, sub, [...path, sub.name], lines, seen);
+const fromCommand = (cmd, inheritedFlags = []) => {
+	const impl = toImpl(cmd);
+	const config = impl.config;
+	const flags = [];
+	const seen = /* @__PURE__ */ new Set();
+	for (const [index, flag] of [...config.flags, ...inheritedFlags].entries()) {
+		const singles = extractSingleParams(flag);
+		for (const single of singles) {
+			if (single.kind !== "flag") continue;
+			if (single.hidden) continue;
+			if (index >= config.flags.length && seen.has(single.name)) continue;
+			seen.add(single.name);
+			flags.push({
+				name: single.name,
+				aliases: single.aliases,
+				description: getOrUndefined$1(single.description),
+				type: toFlagType(single),
+				optionalValue: single.optionalValue !== void 0
+			});
+		}
+	}
+	const args = [];
+	for (const arg of config.arguments) {
+		const singles = extractSingleParams(arg);
+		const metadata = getParamMetadata(arg);
+		for (const single of singles) {
+			if (single.kind !== "argument") continue;
+			args.push({
+				name: single.name,
+				description: getOrUndefined$1(single.description),
+				required: !metadata.isOptional,
+				variadic: metadata.isVariadic,
+				type: toArgumentType(single)
+			});
+		}
+	}
+	const subcommands = [];
+	const sharedFlags = [...inheritedFlags, ...impl.contextConfig.flags];
+	for (const group of cmd.subcommands) for (const subcommand of group.commands) {
+		if (subcommand.unlisted) continue;
+		const descriptor = fromCommand(subcommand, sharedFlags);
+		subcommands.push(descriptor);
+		if (subcommand.alias && subcommand.alias !== subcommand.name) subcommands.push({
+			...descriptor,
+			name: subcommand.alias
+		});
+	}
+	return {
+		name: cmd.name,
+		description: cmd.shortDescription ?? cmd.description,
+		flags,
+		arguments: args,
+		subcommands
+	};
 };
 /**
-* Replay the committed words with the CLI lexer and parser rules: `--`, short
-* flag clusters, inline values, boolean literals, negative numbers, and
-* subcommand selection by the first value only.
+* Whether the flag reads its value from the next word.
+*
+* @internal
 */
-const completer = (dataName) => String.raw`  param($wordToComplete, $commandAst, $cursorPosition)
-
-  $spec = ${dataName}
-  $results = [System.Collections.Generic.List[System.Management.Automation.CompletionResult]]::new()
-  $booleanLiterals = @('true', 'yes', 'on', '1', 'y', 'false', 'no', 'off', '0', 'n')
-
-  $index = {
-    param($context)
-    $lookup = [hashtable]::new([System.StringComparer]::Ordinal)
-    foreach ($flag in $context.flags) {
-      foreach ($form in $flag.forms) { $lookup[$form] = $flag }
-    }
-    $lookup
-  }
-
-  $add = {
-    param([string]$value, [string]$type, $tooltip, [string]$typed, [string]$textPrefix)
-    if (-not $value.StartsWith($typed, [System.StringComparison]::OrdinalIgnoreCase)) { return }
-    $text = $value
-    if ($value -notmatch '^[\w./:%+=\\-]+$') { $text = "'" + ($value -replace "['\u2018-\u201b]", '$0$0') + "'" }
-    $text = $textPrefix + $text
-    $label = $value
-    if (-not $label) { $label = $text }
-    if (-not $tooltip) { $tooltip = $label }
-    $results.Add([System.Management.Automation.CompletionResult]::new($text, $label, $type, $tooltip))
-  }
-
-  $addValues = {
-    param($entry, [string]$typed, [string]$textPrefix)
-    foreach ($value in $entry.values) {
-      if ($textPrefix -eq '' -and (& $optionLike $value)) { continue }
-      & $add $value 'ParameterValue' $entry.description $typed $textPrefix
-    }
-    if ($entry.pathType) {
-      foreach ($file in [System.Management.Automation.CompletionCompleters]::CompleteFilename($typed)) {
-        if ($entry.pathType -eq 'directory' -and $file.ResultType -ne 'ProviderContainer') { continue }
-        $results.Add([System.Management.Automation.CompletionResult]::new($textPrefix + $file.CompletionText, $file.ListItemText, $file.ResultType, $file.ToolTip))
-      }
-    }
-  }
-
-  $addFlags = {
-    param([string]$typed)
-    foreach ($flag in $context.flags) {
-      if ($used.ContainsKey($flag.name)) { continue }
-      foreach ($form in $flag.forms) {
-        & $add $form 'ParameterName' $flag.description $typed ''
-      }
-      if (-not $flag.takesValue) {
-        $tooltip = $null
-        if ($flag.description) { $tooltip = 'Disable ' + $flag.name }
-        & $add ('--no-' + $flag.name) 'ParameterName' $tooltip $typed ''
-      }
-    }
-  }
-
-  # As in the CLI lexer, nothing after '--' is an option, and negative numbers
-  # and a lone '-' are values.
-  $optionLike = {
-    param([string]$word)
-    -not $endOfOptions -and $word -match '^-.' -and $word -notmatch '^-(\d+\.?\d*|\.\d+)([eE][+-]?\d+)?$'
-  }
-
-  # A typed value that has no candidates completes to itself, so the engine
-  # does not fall back to listing files.
-  $keepTyped = {
-    if ($results.Count -eq 0 -and $current) {
-      $results.Add([System.Management.Automation.CompletionResult]::new($current, $current, 'ParameterValue', $current))
-    }
-  }
-
-  $path = ''
-  $context = $spec[$path]
-  $lookup = & $index $context
-  $used = [hashtable]::new([System.StringComparer]::Ordinal)
-  $pending = $null
-  $endOfOptions = $false
-  $position = 0
-
-  # The engine strips the quotes from a quoted word.
-  $typed = [string]$wordToComplete
-  if ($typed -match '^([''"])(.*?)\1?$') { $typed = $Matches[2] }
-  $current = $null
-
-  $elements = $commandAst.CommandElements
-  for ($i = 1; $i -lt $elements.Count; $i++) {
-    $element = $elements[$i]
-    $word = $element.Extent.Text
-    if ($element -is [System.Management.Automation.Language.StringConstantExpressionAst]) { $word = $element.Value }
-    if ($element.Extent.EndOffset -ge $cursorPosition) {
-      if ($element -is [System.Management.Automation.Language.ConstantExpressionAst] -and $element.Extent.StartOffset -le $cursorPosition) {
-        $current = $element.Extent.Text
-        if ($element.Extent.EndOffset -eq $cursorPosition) { $typed = $word }
-      }
-      break
-    }
-
-    # A flag takes the next word as its value unless it is an option or '--';
-    # a boolean flag only takes a boolean literal.
-    $isOption = & $optionLike $word
-    if ($null -ne $pending) {
-      $flag = $pending
-      $pending = $null
-      if ($flag.takesValue) {
-        if (-not $isOption) { continue }
-      } elseif ($booleanLiterals -ccontains $word) { continue }
-    }
-    if ($endOfOptions) { $position++; continue }
-    if ($word -ceq '--') { $endOfOptions = $true; continue }
-
-    if ($isOption) {
-      $hasValue = $word.Contains('=')
-      if ($hasValue) {
-        $forms = @($word.Substring(0, $word.IndexOf('=')))
-      } elseif ($word.StartsWith('--')) {
-        $forms = @($word)
-      } else {
-        $forms = @(foreach ($char in $word.Substring(1).ToCharArray()) { '-' + $char })
-      }
-      foreach ($form in $forms) {
-        $pending = $null
-        $flag = $lookup[$form]
-        if ($null -eq $flag) {
-          if ($form.StartsWith('--no-')) {
-            $name = $form.Substring(5)
-            $flag = $lookup['--' + $name]
-            if ($null -ne $flag -and -not $flag.takesValue -and $flag.name -ceq $name) { $used[$name] = $true }
-          }
-          continue
-        }
-        $used[$flag.name] = $true
-        if (-not $hasValue) { $pending = $flag }
-      }
-      continue
-    }
-
-    if ($position -eq 0 -and $context.subcommands.name -ccontains $word) {
-      if ($path) { $path = $path + ' ' + $word } else { $path = $word }
-      $context = $spec[$path]
-      $lookup = & $index $context
-      $used = [hashtable]::new([System.StringComparer]::Ordinal)
-      continue
-    }
-    $position++
-  }
-
-  $typedIsOption = & $optionLike $typed
-  if ($null -ne $pending -and $pending.takesValue -and -not $typedIsOption) {
-    & $addValues $pending $typed ''
-    & $keepTyped
-    return $results
-  }
-
-  if ($typedIsOption) {
-    if ($typed -match '^(-[^=]+)=(.*)$') {
-      $form = $Matches[1]
-      $flag = $lookup[$form]
-      if ($null -ne $flag -and $flag.takesValue) {
-        & $addValues $flag $Matches[2] ($form + '=')
-        & $keepTyped
-      }
-    } else {
-      & $addFlags $typed
-    }
-    return $results
-  }
-
-  if (-not $endOfOptions -and $position -eq 0) {
-    foreach ($sub in $context.subcommands) {
-      & $add $sub.name 'Command' $sub.description $typed ''
-    }
-  }
-
-  $arguments = $context.arguments
-  if ($position -lt $arguments.Count) {
-    & $addValues $arguments[$position] $typed ''
-  } elseif ($arguments.Count -gt 0 -and $arguments[-1].variadic) {
-    & $addValues $arguments[-1] $typed ''
-  }
-
-  if (-not $endOfOptions) {
-    & $addFlags $typed
-  }
-  return $results`;
-/** @internal */
-const generate$2 = (executableName, descriptor) => {
-	const dataName = `$global:_${sanitize$1(executableName)}_Completions`;
-	const lines = [];
-	lines.push(`###-begin-${executableName}-completions-###`);
-	lines.push(`#`);
-	lines.push(`# Static completion script for PowerShell`);
-	lines.push(`#`);
-	lines.push(`# Installation:`);
-	lines.push(`#   ${executableName} --completions powershell > ${executableName}-completion.ps1`);
-	lines.push(`#   then add this line to your $PROFILE (use the full path to the file):`);
-	lines.push(`#   . <PATH>\\${executableName}-completion.ps1`);
-	lines.push(`#`);
-	lines.push(``);
-	lines.push(`${dataName} = [hashtable]::new([System.StringComparer]::Ordinal)`);
-	generateContexts(dataName, descriptor, [], lines, /* @__PURE__ */ new Set());
-	lines.push(``);
-	lines.push(`Register-ArgumentCompleter -Native -CommandName ${quotePs(executableName)} -ScriptBlock {`);
-	lines.push(completer(dataName));
-	lines.push(`}`);
+const takesSeparateValue = (flag) => flag.type._tag !== "Boolean" && flag.optionalValue !== true;
+//#endregion
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/cli/internal/completions/bash.js
+const escapeForBash = (s) => s.replace(/'/g, "'\\''");
+const sanitizeFunctionName = (s) => s.replace(/[^a-zA-Z0-9_]/g, "_");
+const flagNamesForWordlist = (flag) => {
+	const names = [`--${flag.name}`];
+	for (const alias of flag.aliases) names.push(alias.length === 1 ? `-${alias}` : `--${alias}`);
+	if (flag.type._tag === "Boolean") names.push(`--no-${flag.name}`);
+	return names;
+};
+/** Emit a Bash 3.2-compatible used-flag filter. */
+const buildFlagGroupDeclarations = (flags, lines) => {
+	if (flags.length === 0) return;
+	const groups = flags.map(flagNamesForWordlist);
+	lines.push(`  local ${groups.map((_, index) => `_used_${index}=""`).join(" ")}`);
+	lines.push(`  for ((i = 1; i < cword; i++)); do`);
+	lines.push(`    case "\${words[i]%%=*}" in`);
+	groups.forEach((forms, index) => {
+		lines.push(`      ${forms.join("|")}) _used_${index}=1 ;;`);
+	});
+	lines.push(`    esac`);
+	lines.push(`  done`);
+	lines.push(`  local _filtered_flags=""`);
+	groups.forEach((forms, index) => {
+		lines.push(`  [[ -n "$_used_${index}" ]] || _filtered_flags+=" ${forms.join(" ")}"`);
+	});
 	lines.push(``);
-	lines.push(`###-end-${executableName}-completions-###`);
-	return lines.join("\n");
 };
-//#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/cli/internal/completions/zsh.js
-const escapeZsh = (s) => s.replace(/\\/g, "\\\\").replace(/'/g, "'\\''").replace(/:/g, "\\:");
-const escapeZshExplanation = (s) => escapeZsh(s).replace(/]/g, "\\]");
-/** Escape choices for the second parse of a Zsh `_arguments` action. */
-const escapeZshChoice = (s) => s.replace(/[^A-Za-z0-9_.,/@%+-]/gu, "\\$&").replace(/'/g, "'\\''");
-const sanitize = (s) => s.replace(/[^a-zA-Z0-9_]/g, "_");
 /**
-* All forms of a flag (--name, -alias, --no-name) for the exclusion group.
+* Complete choices without `compgen -W`, which reparses quoted values. Escape
+* only the portion readline replaces for the active quote context.
+*
+* `!` cannot be escaped inside a user-opened double quote without changing the
+* resulting argument.
 */
-const allForms = (flag) => {
-	const forms = [`--${flag.name}`];
-	for (const alias of flag.aliases) forms.push(alias.length === 1 ? `-${alias}` : `--${alias}`);
-	if (flag.type._tag === "Boolean") forms.push(`--no-${flag.name}`);
-	return forms;
+const choicesHelper = (helperName, lines) => {
+	lines.push(`${helperName}()`);
+	lines.push(`{`);
+	lines.push(`  local _cur="$1" _word="$2"; shift 2`);
+	lines.push(``);
+	lines.push(`  local _head="\${_cur%"$_word"}"`);
+	lines.push(`  local _open=""`);
+	lines.push(`  case "$_head" in`);
+	lines.push(`    *\\') _open="'" ;;`);
+	lines.push(`    *\\") _open='"' ;;`);
+	lines.push(`  esac`);
+	lines.push(``);
+	lines.push(`  local _prefix="$_cur" _committed="$_head"`);
+	lines.push(`  _prefix=\${_prefix//\\\\/}; _prefix=\${_prefix//\\"/}; _prefix=\${_prefix//\\'/}`);
+	lines.push(`  _committed=\${_committed//\\\\/}; _committed=\${_committed//\\"/}; _committed=\${_committed//\\'/}`);
+	lines.push(``);
+	lines.push(`  COMPREPLY=()`);
+	lines.push(`  local _choice _rest _match`);
+	lines.push(`  for _choice in "$@"; do`);
+	lines.push(`    [[ "$_choice" == "$_prefix"* ]] || continue`);
+	lines.push(`    _rest="\${_choice#"$_committed"}"`);
+	lines.push(`    case "$_open" in`);
+	lines.push(`      "'")`);
+	lines.push(`        if [[ "$_head" == "'" ]]; then`);
+	lines.push(`          _match=\${_rest//\\'/\\'\\\\\\'\\'}`);
+	lines.push(`        else`);
+	lines.push(`          [[ "$_rest" == *\\'* ]] && continue`);
+	lines.push(`          _match="$_rest"`);
+	lines.push(`        fi`);
+	lines.push(`        ;;`);
+	lines.push(`      '"')`);
+	lines.push(`        _match="\${_rest//\\\\/\\\\\\\\}"`);
+	lines.push(`        _match="\${_match//\\$/\\\\$}"`);
+	lines.push("        _match=\"${_match//\\`/\\\\\\`}\"");
+	lines.push(`        _match="\${_match//\\"/\\\\\\"}"`);
+	lines.push(`        ;;`);
+	lines.push(`      *)`);
+	lines.push(`        printf -v _match '%q' "$_rest"`);
+	lines.push(`        [[ -z "$_head" && "$_match" == '~'* ]] && _match="\\\\$_match"`);
+	lines.push(`        ;;`);
+	lines.push(`    esac`);
+	lines.push(`    [[ -n "$_open" && "$_match" == *"$_open" ]] && _match+="$_open"`);
+	lines.push(`    COMPREPLY+=("$_match")`);
+	lines.push(`  done`);
+	lines.push(`}`);
+	lines.push(``);
 };
-const valueAction = (type) => {
+const choiceCompletion = (helperName, values) => `${helperName} "$cur" "$_comp_word" ${values.map((value) => `'${escapeForBash(value)}'`).join(" ")}`;
+const flagValueCompletion = (type, helperName) => {
 	switch (type._tag) {
-		case "Boolean": return "";
-		case "Choice": return `:value:(${type.values.map(escapeZshChoice).join(" ")})`;
-		case "Path": return type.pathType === "directory" ? `:directory:_directories` : `:file:_files`;
-		case "Int": return `:integer:`;
-		case "Finite": return `:float:`;
-		case "Date": return `:date:`;
-		default: return `:value:`;
+		case "Boolean": return;
+		case "Choice": return choiceCompletion(helperName, type.values);
+		case "Path":
+			if (type.pathType === "directory") return `COMPREPLY=( $(compgen -d -- "$cur") )`;
+			return `COMPREPLY=( $(compgen -f -- "$cur") )`;
+		default: return;
 	}
 };
-const argAction = (type) => {
+const argCompletion = (type, helperName) => {
 	switch (type._tag) {
-		case "Choice": return `(${type.values.map(escapeZshChoice).join(" ")})`;
-		case "Path": return type.pathType === "directory" ? `_directories` : `_files`;
-		default: return ``;
-	}
-};
-/**
-* Produce _arguments optspecs for a single flag. Each spec is a complete,
-* single-quoted string — no brace expansion, no line continuations.
-*/
-const flagSpecs = (flag) => {
-	const specs = [];
-	const desc = flag.description ? `[${escapeZshExplanation(flag.description)}]` : "";
-	const action = valueAction(flag.type);
-	const excl = `(${allForms(flag).join(" ")})`;
-	specs.push(`'${excl}--${flag.name}${desc}${action}'`);
-	for (const alias of flag.aliases) {
-		const prefix = alias.length === 1 ? "-" : "--";
-		specs.push(`'${excl}${prefix}${alias}${desc}${action}'`);
-	}
-	if (flag.type._tag === "Boolean") {
-		const negDesc = flag.description ? `[${escapeZshExplanation(`Disable ${flag.name}`)}]` : "";
-		specs.push(`'${excl}--no-${flag.name}${negDesc}'`);
+		case "Choice": return choiceCompletion(helperName, type.values);
+		case "Path":
+			if (type.pathType === "directory") return `COMPREPLY=( $(compgen -d -- "$cur") )`;
+			return `COMPREPLY=( $(compgen -f -- "$cur") )`;
+		default: return;
 	}
-	return specs;
-};
-const argSpec = (arg) => {
-	const desc = arg.description ? escapeZsh(arg.description) : arg.name;
-	const action = argAction(arg.type);
-	return `'${arg.variadic ? "*" : ""}:${desc}:${action}'`;
 };
-const generateFunction = (descriptor, parentPath, lines) => {
+const generateFunction$1 = (descriptor, parentPath, lines, helperName) => {
 	const currentPath = [...parentPath, descriptor.name];
-	const funcName = `_${currentPath.map(sanitize).join("_")}`;
-	lines.push(`${funcName}() {`);
-	if (descriptor.subcommands.length > 0) {
-		lines.push(`  local context state state_descr line`);
-		lines.push(`  typeset -A opt_args`);
-		lines.push(``);
-		lines.push(`  local -a commands`);
-		lines.push(`  commands=(`);
-		for (const sub of descriptor.subcommands) {
-			const desc = sub.description ? escapeZsh(sub.description) : "";
-			lines.push(`    '${sub.name}:${desc}'`);
-		}
-		lines.push(`  )`);
+	const funcName = `_${currentPath.map(sanitizeFunctionName).join("_")}`;
+	lines.push(`${funcName}()`);
+	lines.push(`{`);
+	lines.push(`  local cur prev words cword i`);
+	lines.push(parentPath.length === 0 ? `  local _command_index=0` : `  local _command_index="$1"`);
+	lines.push(`  _init_completion -n "$COMP_WORDBREAKS" || return`);
+	if (parentPath.length === 0) lines.push(`  local _comp_word="$2"`);
+	lines.push(``);
+	const flagsWithValues = descriptor.flags.filter(takesSeparateValue);
+	if (flagsWithValues.length > 0) {
+		lines.push(`  # Flag value completions`);
+		lines.push(`  case "$prev" in`);
+		for (const flag of flagsWithValues) {
+			const longNames = [`--${flag.name}`];
+			for (const alias of flag.aliases) longNames.push(alias.length === 1 ? `-${alias}` : `--${alias}`);
+			const completion = flagValueCompletion(flag.type, helperName);
+			if (completion) {
+				lines.push(`    ${longNames.join("|")})`);
+				lines.push(`      ${completion}`);
+				lines.push(`      return`);
+				lines.push(`      ;;`);
+			}
+		}
+		lines.push(`  esac`);
 		lines.push(``);
-		lines.push(`  local -a specs`);
-		lines.push(`  specs=(`);
-		for (const flag of descriptor.flags) for (const spec of flagSpecs(flag)) lines.push(`    ${spec}`);
-		if (descriptor.arguments.length > 0) {
-			lines.push(`    -`);
-			lines.push(`    parent-arguments`);
-			for (const arg of descriptor.arguments) lines.push(`    ${argSpec(arg)}`);
-			lines.push(`    -`);
-			lines.push(`    subcommands`);
+	}
+	if (descriptor.subcommands.length > 0) {
+		lines.push(`  # Subcommand dispatch`);
+		lines.push(`  local cmd _skip_next=0`);
+		lines.push(`  for ((i = _command_index + 1; i < cword; i++)); do`);
+		lines.push(`    if (( _skip_next )); then`);
+		lines.push(`      _skip_next=0`);
+		lines.push(`      continue`);
+		lines.push(`    fi`);
+		lines.push(`    case "\${words[i]}" in`);
+		for (const flag of descriptor.flags) {
+			if (!takesSeparateValue(flag)) continue;
+			const forms = flagNamesForWordlist(flag);
+			lines.push(`      ${forms.join("|")}) _skip_next=1 ;;`);
+			lines.push(`      ${forms.map((form) => `${form}=*`).join("|")}) ;;`);
 		}
-		lines.push(`    '1:command:->command'`);
-		lines.push(`    '*::arg:->args'`);
-		lines.push(`  )`);
+		for (const sub of descriptor.subcommands) {
+			const subFuncName = `_${[...currentPath, sub.name].map(sanitizeFunctionName).join("_")}`;
+			lines.push(`      ${sub.name})`);
+			lines.push(`        ${subFuncName} "$i"`);
+			lines.push(`        return`);
+			lines.push(`        ;;`);
+		}
+		lines.push(`    esac`);
+		lines.push(`  done`);
 		lines.push(``);
-		lines.push(`  _arguments -C "\${specs[@]}"`);
+	}
+	buildFlagGroupDeclarations(descriptor.flags, lines);
+	if (descriptor.flags.length > 0 || descriptor.subcommands.length > 0) {
+		lines.push(`  # Complete flags (filtered) and subcommands`);
+		lines.push(`  if [[ "$cur" == -* ]]; then`);
+		if (descriptor.flags.length > 0) lines.push(`    COMPREPLY=( $(compgen -W "$_filtered_flags" -- "$cur") )`);
+		lines.push(`    return`);
+		lines.push(`  fi`);
 		lines.push(``);
-		lines.push(`  case "$state" in`);
-		lines.push(`    command)`);
-		lines.push(`      _describe -t commands 'commands' commands`);
-		lines.push(`      ;;`);
-		lines.push(`    args)`);
-		lines.push(`      case "$words[1]" in`);
-		for (const sub of descriptor.subcommands) {
-			const subFunc = `_${[...currentPath, sub.name].map(sanitize).join("_")}`;
-			lines.push(`        ${sub.name})`);
-			lines.push(`          ${subFunc}`);
-			lines.push(`          ;;`);
+	}
+	const argsWithCompletions = descriptor.arguments.flatMap((argument, index) => {
+		const completion = argCompletion(argument.type, helperName);
+		return completion === void 0 ? [] : [{
+			argument,
+			completion,
+			index
+		}];
+	});
+	if (argsWithCompletions.length > 0) {
+		lines.push(`  # Positional argument completions`);
+		lines.push(`  local _position=0 _skip_next=0 _end_of_options=0`);
+		lines.push(`  for ((i = _command_index + 1; i < cword; i++)); do`);
+		lines.push(`    if (( _skip_next )); then`);
+		lines.push(`      _skip_next=0`);
+		lines.push(`      continue`);
+		lines.push(`    fi`);
+		lines.push(`    if (( _end_of_options )); then`);
+		lines.push(`      ((_position += 1))`);
+		lines.push(`      continue`);
+		lines.push(`    fi`);
+		lines.push(`    case "\${words[i]}" in`);
+		lines.push(`      --) _end_of_options=1 ;;`);
+		for (const flag of descriptor.flags) {
+			const forms = flagNamesForWordlist(flag);
+			if (!takesSeparateValue(flag)) lines.push(`      ${forms.join("|")}) ;;`);
+			else {
+				lines.push(`      ${forms.join("|")}) _skip_next=1 ;;`);
+				lines.push(`      ${forms.map((form) => `${form}=*`).join("|")}) ;;`);
+			}
+		}
+		lines.push(`      -*) ;;`);
+		lines.push(`      *) ((_position += 1)) ;;`);
+		lines.push(`    esac`);
+		lines.push(`  done`);
+		lines.push(`  case "$_position" in`);
+		for (const { argument, completion, index } of argsWithCompletions) {
+			if (argument.variadic) continue;
+			lines.push(`    ${index})`);
+			lines.push(`      ${completion}`);
+			lines.push(`      return`);
+			lines.push(`      ;;`);
 		}
-		lines.push(`      esac`);
-		lines.push(`      ;;`);
 		lines.push(`  esac`);
-	} else {
-		const allSpecs = [];
-		for (const flag of descriptor.flags) allSpecs.push(...flagSpecs(flag));
-		for (const arg of descriptor.arguments) allSpecs.push(argSpec(arg));
-		if (allSpecs.length > 0) {
-			lines.push(`  local -a specs`);
-			lines.push(`  specs=(`);
-			for (const spec of allSpecs) lines.push(`    ${spec}`);
-			lines.push(`  )`);
-			lines.push(`  _arguments "\${specs[@]}"`);
+		const variadic = argsWithCompletions.find(({ argument }) => argument.variadic);
+		if (variadic !== void 0) {
+			lines.push(`  if (( _position >= ${variadic.index} )); then`);
+			lines.push(`    ${variadic.completion}`);
+			lines.push(`    return`);
+			lines.push(`  fi`);
 		}
+	} else if (descriptor.subcommands.length > 0) {
+		const subNames = descriptor.subcommands.map((s) => s.name);
+		lines.push(`  COMPREPLY=( $(compgen -W '${subNames.join(" ")}' -- "$cur") )`);
 	}
 	lines.push(`}`);
 	lines.push(``);
-	for (const sub of descriptor.subcommands) generateFunction(sub, currentPath, lines);
+	for (const sub of descriptor.subcommands) generateFunction$1(sub, currentPath, lines, helperName);
 };
 /**
 * @internal
 */
-const generate$1 = (executableName, descriptor) => {
+const generate$4 = (executableName, descriptor) => {
 	const lines = [];
-	const safeName = sanitize(executableName);
-	lines.push(`#compdef ${executableName}`);
-	lines.push(`###-begin-${executableName}-completions-###`);
+	const safeName = sanitizeFunctionName(executableName);
+	const helperName = `_${safeName}--choices`;
+	lines.push(`###-begin-${escapeForBash(executableName)}-completions-###`);
 	lines.push(`#`);
-	lines.push(`# Static completion script for Zsh`);
+	lines.push(`# Static completion script for Bash`);
 	lines.push(`#`);
 	lines.push(`# Installation:`);
-	lines.push(`#   ${executableName} --completions zsh > ~/.zsh/completions/_${executableName}`);
-	lines.push(`#   then add ~/.zsh/completions to your fpath`);
+	lines.push(`#   ${escapeForBash(executableName)} --completions bash >> ~/.bashrc`);
 	lines.push(`#`);
 	lines.push(``);
-	generateFunction(descriptor, [], lines);
-	lines.push(`# Handle both direct invocation and autoload`);
-	lines.push(`if [[ "\${zsh_eval_context[-1]}" == "loadautofunc" ]]; then`);
-	lines.push(`  _${safeName} "$@"`);
-	lines.push(`else`);
-	lines.push(`  compdef _${safeName} ${executableName}`);
+	lines.push(`if ! type _init_completion &>/dev/null; then`);
+	lines.push(`  _init_completion()`);
+	lines.push(`  {`);
+	lines.push(`    COMPREPLY=()`);
+	lines.push(`    local _i _j=0 _piece _line="$COMP_LINE"`);
+	lines.push(`    words=("\${COMP_WORDS[0]}")`);
+	lines.push(`    cword=0`);
+	lines.push(`    _line="\${_line#*"\${COMP_WORDS[0]}"}"`);
+	lines.push(`    for ((_i = 1; _i < \${#COMP_WORDS[@]}; _i++)); do`);
+	lines.push(`      _piece="\${COMP_WORDS[_i]}"`);
+	lines.push(`      if [[ "$_line" == [[:blank:]]* ]]; then`);
+	lines.push(`        ((_j++))`);
+	lines.push(`        words[_j]="$_piece"`);
+	lines.push(`      else`);
+	lines.push(`        words[_j]="\${words[_j]}$_piece"`);
+	lines.push(`      fi`);
+	lines.push(`      ((_i == COMP_CWORD)) && cword=$_j`);
+	lines.push(`      _line="\${_line#*"$_piece"}"`);
+	lines.push(`    done`);
+	lines.push(`    cur="\${words[cword]}"`);
+	lines.push(`    prev=""`);
+	lines.push(`    ((cword > 0)) && prev="\${words[cword-1]}"`);
+	lines.push(`    return 0`);
+	lines.push(`  }`);
 	lines.push(`fi`);
-	lines.push(`###-end-${executableName}-completions-###`);
+	lines.push(``);
+	choicesHelper(helperName, lines);
+	generateFunction$1(descriptor, [], lines, helperName);
+	lines.push(`complete -F _${safeName} ${escapeForBash(executableName)}`);
+	lines.push(`###-end-${escapeForBash(executableName)}-completions-###`);
 	return lines.join("\n");
 };
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/cli/Completions.js
-/**
-* The `Completions` module turns a plain description of an Effect CLI command
-* tree into shell completion scripts for Bash, Zsh, Fish, and PowerShell. It
-* is the low-level script generation surface used by the unstable CLI package
-* and by the built-in completions global flag.
-*
-* @stability unstable
-* @since 4.0.0
-*/
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/cli/internal/completions/fish.js
+const escapeFishString = (s) => s.replace(/\\/g, "\\\\").replace(/'/g, "\\'");
+/** Escape choices for Fish's second expansion of `complete -a`. */
+const escapeFishChoice = (s) => escapeFishString(s.replace(/[^A-Za-z0-9_.,/@%+-]/gu, "\\$&"));
 /**
-* Generates a shell completion script for a command descriptor.
-*
-* **When to use**
-*
-* Use when you need an installable completion script from an existing
-* `CommandDescriptor`.
-*
-* **Details**
-*
-* Dispatches by `shell` to Bash, Zsh, Fish, or PowerShell generation and
-* returns a static script string for `executableName`.
-*
-* @see {@link Shell} for supported shell names
-* @see {@link CommandDescriptor} for the command shape used by completion generation
+* Build a Fish condition that checks the current subcommand context.
 *
-* @stability unstable
-* @category constructors
-* @since 4.0.0
+* For root-level completions with subcommands: `__fish_use_subcommand`
+* For nested commands: verify the full parent path is active AND none of its
+* child subcommands have been entered yet.
 */
-const generate = (executableName, shell, descriptor) => {
-	switch (shell) {
-		case "bash": return generate$4(executableName, descriptor);
-		case "zsh": return generate$1(executableName, descriptor);
-		case "fish": return generate$3(executableName, descriptor);
-		case "powershell": return generate$2(executableName, descriptor);
+const subcommandCondition = (parentPath, childSubcommandNames) => {
+	if (parentPath.length === 0) {
+		if (childSubcommandNames.length > 0) return `__fish_use_subcommand`;
+		return ``;
 	}
+	const parentCondition = parentPath.map((parent) => `__fish_seen_subcommand_from ${parent}`).join("; and ");
+	if (childSubcommandNames.length > 0) return `${parentCondition}; and not __fish_seen_subcommand_from ${childSubcommandNames.join(" ")}`;
+	return parentCondition;
 };
-//#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/cli/Flag.js
 /**
-* Creates a boolean flag that can be enabled or disabled.
-*
-* **Example** (Creating boolean flags)
-*
-* ```ts import.meta.vitest
-* import { Flag } from "effect/cli"
-*
-* const verboseFlag = Flag.Boolean("verbose")
-* // Usage: --verbose (true) or --no-verbose (false)
-* // Omission fails unless the flag is made optional or given a fallback.
-* verboseFlag.kind // => "flag"
-* ```
-*
-* @stability unstable
-* @category constructors
-* @since 4.0.0
-*/
-const Boolean = (name) => Boolean$1(flagKind, name);
-/**
-* Constructs option parameters that represent a choice between several inputs.
-* Each tuple maps a string flag value to an associated typed value.
-*
-* **Example** (Creating flag choices with values)
-*
-* ```ts import.meta.vitest
-* import { Flag } from "effect/cli"
-*
-* // simple enum like choice mapping directly to string union
-* const color = Flag.Literals("color", ["red", "green", "blue"])
-*
-* // choice with custom value mapping
-* const logLevel = Flag.ChoiceWithValue("log-level", [
-*   ["debug", "Debug" as const],
-*   ["info", "Info" as const],
-*   ["error", "Error" as const]
-* ])
-* const kinds = [color.kind, logLevel.kind] // => ["flag", "flag"]
-* ```
-*
-* @stability unstable
-* @category constructors
-* @since 4.0.0
-*/
-const ChoiceWithValue = (name, choices) => ChoiceWithValue$1(flagKind, name, choices);
-/**
-* Adds an alias to a flag, allowing it to be referenced by multiple names.
-*
-* **Example** (Adding flag aliases)
-*
-* ```ts import.meta.vitest
-* import { Flag } from "effect/cli"
-*
-* // Flag can be used as both --verbose and -v
-* const verboseFlag = Flag.Boolean("verbose").pipe(
-*   Flag.withAlias("v")
-* )
-*
-* // Multiple aliases can be chained
-* const helpFlag = Flag.Boolean("help").pipe(
-*   Flag.withAlias("h"),
-*   Flag.withAlias("?")
-* )
-* const kinds = [verboseFlag.kind, helpFlag.kind] // => ["flag", "flag"]
-* ```
-*
-* @stability unstable
-* @category aliasing
-* @since 4.0.0
+* Build a __fish_contains_opt condition that checks whether any form of this
+* flag has already been typed. Returns the condition string without wrapping
+* quotes (the caller adds those).
 */
-const withAlias = /*#__PURE__*/ dual(2, (self, alias) => withAlias$1(self, alias));
+const flagContainsOptCondition = (flag) => {
+	const optArgs = [];
+	for (const alias of flag.aliases) if (alias.length === 1) optArgs.push(`-s ${alias}`);
+	optArgs.push(flag.name);
+	for (const alias of flag.aliases) if (alias.length > 1) optArgs.push(alias);
+	if (flag.type._tag === "Boolean") optArgs.push(`no-${flag.name}`);
+	return `not __fish_contains_opt ${optArgs.join(" ")}`;
+};
+/** Hide used value flags without suppressing their value completions. */
+const valueFlagDedupCondition = (flag) => {
+	const forms = [`--${flag.name}`];
+	for (const alias of flag.aliases) forms.push(alias.length === 1 ? `-${alias}` : `--${alias}`);
+	return `begin; ${flagContainsOptCondition(flag)}; or contains -- (commandline -poc)[-1] ${forms.join(" ")}; end`;
+};
+const flagCompletionArgs = (flag) => {
+	const args = [`-l ${flag.name}`];
+	for (const alias of flag.aliases) if (alias.length === 1) args.push(`-s ${alias}`);
+	else args.push(`-l ${alias}`);
+	if (flag.description) args.push(`-d '${escapeFishString(flag.description)}'`);
+	const valueArgs = takesSeparateValue(flag) ? flagValueArgs(flag.type) : void 0;
+	if (valueArgs) args.push(valueArgs);
+	return args;
+};
+const flagValueArgs = (type) => {
+	switch (type._tag) {
+		case "Boolean": return;
+		case "Choice": return `-r -f -a '${type.values.map(escapeFishChoice).join(" ")}'`;
+		case "Path":
+			if (type.pathType === "directory") return `-r -F`;
+			return `-r -F`;
+		default: return `-r -f`;
+	}
+};
+const argValueArgs = (type) => {
+	switch (type._tag) {
+		case "Choice": return `-r -f -a '${type.values.map(escapeFishChoice).join(" ")}'`;
+		case "Path": return `-r -F`;
+		default: return;
+	}
+};
+const generateCompletions = (executableName, descriptor, parentPath, lines) => {
+	const allSubNames = descriptor.subcommands.map((s) => s.name);
+	const condition = subcommandCondition(parentPath, allSubNames);
+	const conditionArg = condition ? `-n '${condition}'` : ``;
+	if (!descriptor.arguments.some((a) => a.type._tag === "Path")) {
+		const parts = [`complete -c ${executableName}`];
+		if (conditionArg) parts.push(conditionArg);
+		parts.push(`-f`);
+		lines.push(parts.join(" "));
+	}
+	for (const sub of descriptor.subcommands) {
+		const parts = [`complete -c ${executableName}`];
+		if (conditionArg) parts.push(conditionArg);
+		parts.push(`-f -a '${escapeFishString(sub.name)}'`);
+		if (sub.description) parts.push(`-d '${escapeFishString(sub.description)}'`);
+		lines.push(parts.join(" "));
+	}
+	for (const flag of descriptor.flags) {
+		const dedup = takesSeparateValue(flag) ? valueFlagDedupCondition(flag) : flagContainsOptCondition(flag);
+		const flagCondition = condition ? `${condition}; and ${dedup}` : dedup;
+		const flagCondArg = flagCondition ? `-n '${flagCondition}'` : ``;
+		const parts = [`complete -c ${executableName}`];
+		if (flagCondArg) parts.push(flagCondArg);
+		parts.push(...flagCompletionArgs(flag));
+		lines.push(parts.join(" "));
+		if (flag.type._tag === "Boolean") {
+			const negParts = [`complete -c ${executableName}`];
+			if (flagCondArg) negParts.push(flagCondArg);
+			negParts.push(`-l no-${flag.name}`);
+			if (flag.description) negParts.push(`-d '${escapeFishString(`Disable ${flag.name}`)}'`);
+			lines.push(negParts.join(" "));
+		}
+	}
+	if (descriptor.flags.length > 0) {
+		const notDash = `not string match -q -- "-*" (commandline -ct)`;
+		const bareBase = condition ? `${condition}; and ${notDash}` : notDash;
+		for (const flag of descriptor.flags) {
+			const bareCondition = `${bareBase}; and ${flagContainsOptCondition(flag)}`;
+			const isBoolean = flag.type._tag === "Boolean";
+			const parts = [`complete -c ${executableName}`];
+			parts.push(`-n '${bareCondition}'`);
+			parts.push(`-f -a '--${flag.name}'`);
+			if (flag.description) parts.push(`-d '${escapeFishString(flag.description)}'`);
+			lines.push(parts.join(" "));
+			if (isBoolean) {
+				const negParts = [`complete -c ${executableName}`];
+				negParts.push(`-n '${bareCondition}'`);
+				negParts.push(`-f -a '--no-${flag.name}'`);
+				if (flag.description) negParts.push(`-d '${escapeFishString(`Disable ${flag.name}`)}'`);
+				lines.push(negParts.join(" "));
+			}
+		}
+	}
+	for (const arg of descriptor.arguments) {
+		const valueArg = argValueArgs(arg.type);
+		if (valueArg) {
+			const parts = [`complete -c ${executableName}`];
+			if (conditionArg) parts.push(conditionArg);
+			parts.push(valueArg);
+			if (arg.description) parts.push(`-d '${escapeFishString(arg.description)}'`);
+			lines.push(parts.join(" "));
+		}
+	}
+	for (const sub of descriptor.subcommands) generateCompletions(executableName, sub, [...parentPath, sub.name], lines);
+};
 /**
-* Adds a description to a flag for help documentation.
-*
-* **Example** (Adding help descriptions)
-*
-* ```ts import.meta.vitest
-* import { Flag } from "effect/cli"
-*
-* const portFlag = Flag.Int("port").pipe(
-*   Flag.withDescription("The port number to listen on")
-* )
-*
-* const configFlag = Flag.File("config").pipe(
-*   Flag.withDescription("Path to the configuration file")
-* )
-* const kinds = [portFlag.kind, configFlag.kind] // => ["flag", "flag"]
-* ```
-*
-* @stability unstable
-* @category metadata
-* @since 4.0.0
+* @internal
 */
-const withDescription$1 = /*#__PURE__*/ dual(2, (self, description) => withDescription$2(self, description));
+const generate$3 = (executableName, descriptor) => {
+	const lines = [];
+	lines.push(`###-begin-${executableName}-completions-###`);
+	lines.push(`#`);
+	lines.push(`# Static completion script for Fish`);
+	lines.push(`#`);
+	lines.push(`# Installation:`);
+	lines.push(`#   ${executableName} --completions fish > ~/.config/fish/completions/${executableName}.fish`);
+	lines.push(`#`);
+	lines.push(``);
+	generateCompletions(executableName, descriptor, [], lines);
+	lines.push(``);
+	lines.push(`###-end-${executableName}-completions-###`);
+	return lines.join("\n");
+};
+//#endregion
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/cli/internal/completions/powershell.js
 /**
-* Sets a custom metavar (placeholder name) for the flag in help documentation.
-*
-* **Details**
-*
-* The metavar is displayed in usage text to indicate what value the user should
-* provide. For example, `--output FILE` shows `FILE` as the metavar.
-*
-* **Example** (Setting metavars)
-*
-* ```ts import.meta.vitest
-* import { Flag } from "effect/cli"
-*
-* const databaseFlag = Flag.String("database-url").pipe(
-*   Flag.withMetavar("URL"),
-*   Flag.withDescription("Database connection URL")
-* )
-* // In help: --database-url URL
-*
-* const timeoutFlag = Flag.Int("timeout").pipe(
-*   Flag.withMetavar("SECONDS")
-* )
-* // In help: --timeout SECONDS
-* const kinds = [databaseFlag.kind, timeoutFlag.kind] // => ["flag", "flag"]
-* ```
-*
-* @stability unstable
-* @category metadata
-* @since 4.0.0
+* Encode non-ASCII and control characters as `[char]` code units. Windows
+* PowerShell 5.1 can misread BOM-less UTF-8 as ANSI, turning some bytes into
+* PowerShell quote delimiters.
 */
-const withMetavar = /*#__PURE__*/ dual(2, (self, metavar) => withMetavar$1(self, metavar));
+const quotePs = (s) => {
+	const parts = [];
+	let literal = "";
+	for (let i = 0; i < s.length; i++) {
+		const code = s.charCodeAt(i);
+		if (code >= 32 && code < 128) {
+			literal += s[i] === "'" ? "''" : s[i];
+			continue;
+		}
+		if (literal !== "" || parts.length === 0) parts.push(`'${literal}'`);
+		literal = "";
+		parts.push(`[char]0x${code.toString(16).toUpperCase().padStart(4, "0")}`);
+	}
+	if (literal !== "" || parts.length === 0) parts.push(`'${literal}'`);
+	return parts.length === 1 ? parts[0] : `(${parts.join(" + ")})`;
+};
+const psArray = (items) => `@(${items.map(quotePs).join(", ")})`;
+const psOptional = (s) => s ? quotePs(s) : "$null";
+const sanitize$1 = (s) => s.replace(/[^a-zA-Z0-9_]/g, "_");
+const flagForms = (flag) => [`--${flag.name}`, ...flag.aliases.map((alias) => alias.length === 1 ? `-${alias}` : `--${alias}`)];
+const valueFields = (type) => `values = ${psArray(type._tag === "Choice" ? type.values : [])}; pathType = ${type._tag === "Path" ? quotePs(type.pathType) : "$null"}`;
+const flagEntry = (flag) => `@{ name = ${quotePs(flag.name)}; forms = ${psArray(flagForms(flag))}; takesValue = $${flag.type._tag !== "Boolean"}; ` + (flag.optionalValue === true ? `optionalValue = $true; ` : "") + `${valueFields(flag.type)}; description = ${psOptional(flag.description)} }`;
+const argumentEntry = (argument) => `@{ name = ${quotePs(argument.name)}; variadic = $${argument.variadic}; ${valueFields(argument.type)}; description = ${psOptional(argument.description)} }`;
+const pushList = (lines, field, entries) => {
+	if (entries.length === 0) {
+		lines.push(`  ${field} = @()`);
+		return;
+	}
+	lines.push(`  ${field} = @(`);
+	for (const entry of entries) lines.push(`    ${entry}`);
+	lines.push(`  )`);
+};
 /**
-* Makes a flag optional, returning an Option type that can be None if not provided.
-*
-* **Example** (Making flags optional)
-*
-* ```ts import.meta.vitest
-* import { Effect, FileSystem, Layer, Option, Path, Stdio, Terminal } from "effect"
-* import { Flag } from "effect/cli"
-* import { ChildProcessSpawner } from "effect/process"
-*
-* const CliTestLayer = Layer.mergeAll(
-*   FileSystem.layerNoop({}),
-*   Path.layer,
-*   Stdio.layerTest({}),
-*   Layer.succeed(Terminal.Terminal, Terminal.make({
-*     columns: Effect.succeed(80),
-*     rows: Effect.succeed(24),
-*     readInput: Effect.die("unused"),
-*     readLine: Effect.die("unused"),
-*     display: () => Effect.void
-*   })),
-*   Layer.succeed(
-*     ChildProcessSpawner.ChildProcessSpawner,
-*     ChildProcessSpawner.make(() => Effect.die("unused"))
-*   )
-* )
-*
-* const optionalPort = Flag.optional(Flag.Int("port"))
-*
-* const program = Effect.gen(function*() {
-*   const [, port] = yield* optionalPort.parse({
-*     arguments: [],
-*     flags: { "port": ["4000"] }
-*   })
-*   return port
-* })
-*
-* await Effect.runPromise(program.pipe(Effect.provide(CliTestLayer))) // => Option.some(4000)
-* ```
-*
-* @stability unstable
-* @category optionality
-* @since 4.0.0
+* Emit one context per subcommand path. Subcommands are case-sensitive, so
+* contexts go in an ordinal hashtable instead of a hash literal, whose keys
+* ignore case.
 */
-const optional = (param) => optional$1(param);
+const generateContexts = (dataName, descriptor, path, lines, seen) => {
+	const key = path.join(" ");
+	if (seen.has(key)) return;
+	seen.add(key);
+	lines.push(`${dataName}[${quotePs(key)}] = @{`);
+	pushList(lines, "subcommands", descriptor.subcommands.map((sub) => `@{ name = ${quotePs(sub.name)}; description = ${psOptional(sub.description)} }`));
+	pushList(lines, "flags", descriptor.flags.map(flagEntry));
+	pushList(lines, "arguments", descriptor.arguments.map(argumentEntry));
+	lines.push(`}`);
+	for (const sub of descriptor.subcommands) generateContexts(dataName, sub, [...path, sub.name], lines, seen);
+};
 /**
-* Provides a default value for a flag when it's not specified.
-*
-* **Example** (Providing default values)
-*
-* ```ts import.meta.vitest
-* import { Flag } from "effect/cli"
-*
-* const portFlag = Flag.Int("port").pipe(
-*   Flag.withDefault(8080)
-* )
-* // If --port is not provided, defaults to 8080
-*
-* const hostFlag = Flag.String("host").pipe(
-*   Flag.withDefault("localhost")
-* )
-* // If --host is not provided, defaults to "localhost"
-* const kinds = [portFlag.kind, hostFlag.kind] // => ["flag", "flag"]
-* ```
-*
-* @stability unstable
-* @category optionality
-* @since 4.0.0
+* Replay the committed words with the CLI lexer and parser rules: `--`, short
+* flag clusters, inline values, boolean literals, negative numbers, and
+* subcommand selection by the first value only.
 */
-const withDefault = withDefault$1;
+const completer = (dataName) => String.raw`  param($wordToComplete, $commandAst, $cursorPosition)
+
+  $spec = ${dataName}
+  $results = [System.Collections.Generic.List[System.Management.Automation.CompletionResult]]::new()
+  $booleanLiterals = @('true', 'yes', 'on', '1', 'y', 'false', 'no', 'off', '0', 'n')
+
+  $index = {
+    param($context)
+    $lookup = [hashtable]::new([System.StringComparer]::Ordinal)
+    foreach ($flag in $context.flags) {
+      foreach ($form in $flag.forms) { $lookup[$form] = $flag }
+    }
+    $lookup
+  }
+
+  $add = {
+    param([string]$value, [string]$type, $tooltip, [string]$typed, [string]$textPrefix)
+    if (-not $value.StartsWith($typed, [System.StringComparison]::OrdinalIgnoreCase)) { return }
+    $text = $value
+    if ($value -notmatch '^[\w./:%+=\\-]+$') { $text = "'" + ($value -replace "['\u2018-\u201b]", '$0$0') + "'" }
+    $text = $textPrefix + $text
+    $label = $value
+    if (-not $label) { $label = $text }
+    if (-not $tooltip) { $tooltip = $label }
+    $results.Add([System.Management.Automation.CompletionResult]::new($text, $label, $type, $tooltip))
+  }
+
+  $addValues = {
+    param($entry, [string]$typed, [string]$textPrefix)
+    foreach ($value in $entry.values) {
+      if ($textPrefix -eq '' -and (& $optionLike $value)) { continue }
+      & $add $value 'ParameterValue' $entry.description $typed $textPrefix
+    }
+    if ($entry.pathType) {
+      foreach ($file in [System.Management.Automation.CompletionCompleters]::CompleteFilename($typed)) {
+        if ($entry.pathType -eq 'directory' -and $file.ResultType -ne 'ProviderContainer') { continue }
+        $results.Add([System.Management.Automation.CompletionResult]::new($textPrefix + $file.CompletionText, $file.ListItemText, $file.ResultType, $file.ToolTip))
+      }
+    }
+  }
+
+  $addFlags = {
+    param([string]$typed)
+    foreach ($flag in $context.flags) {
+      if ($used.ContainsKey($flag.name)) { continue }
+      foreach ($form in $flag.forms) {
+        & $add $form 'ParameterName' $flag.description $typed ''
+      }
+      if (-not $flag.takesValue) {
+        $tooltip = $null
+        if ($flag.description) { $tooltip = 'Disable ' + $flag.name }
+        & $add ('--no-' + $flag.name) 'ParameterName' $tooltip $typed ''
+      }
+    }
+  }
+
+  # As in the CLI lexer, nothing after '--' is an option, and negative numbers
+  # and a lone '-' are values.
+  $optionLike = {
+    param([string]$word)
+    -not $endOfOptions -and $word -match '^-.' -and $word -notmatch '^-(\d+\.?\d*|\.\d+)([eE][+-]?\d+)?$'
+  }
+
+  # A typed value that has no candidates completes to itself, so the engine
+  # does not fall back to listing files.
+  $keepTyped = {
+    if ($results.Count -eq 0 -and $current) {
+      $results.Add([System.Management.Automation.CompletionResult]::new($current, $current, 'ParameterValue', $current))
+    }
+  }
+
+  $path = ''
+  $context = $spec[$path]
+  $lookup = & $index $context
+  $used = [hashtable]::new([System.StringComparer]::Ordinal)
+  $pending = $null
+  $endOfOptions = $false
+  $position = 0
+
+  # The engine strips the quotes from a quoted word.
+  $typed = [string]$wordToComplete
+  if ($typed -match '^([''"])(.*?)\1?$') { $typed = $Matches[2] }
+  $current = $null
+
+  $elements = $commandAst.CommandElements
+  for ($i = 1; $i -lt $elements.Count; $i++) {
+    $element = $elements[$i]
+    $word = $element.Extent.Text
+    if ($element -is [System.Management.Automation.Language.StringConstantExpressionAst]) { $word = $element.Value }
+    if ($element.Extent.EndOffset -ge $cursorPosition) {
+      if ($element -is [System.Management.Automation.Language.ConstantExpressionAst] -and $element.Extent.StartOffset -le $cursorPosition) {
+        $current = $element.Extent.Text
+        if ($element.Extent.EndOffset -eq $cursorPosition) { $typed = $word }
+      }
+      break
+    }
+
+    # A flag takes the next word as its value unless it is an option or '--';
+    # a boolean flag only takes a boolean literal.
+    $isOption = & $optionLike $word
+    if ($null -ne $pending) {
+      $flag = $pending
+      $pending = $null
+      if ($flag.takesValue) {
+        if (-not $isOption) { continue }
+      } elseif ($booleanLiterals -ccontains $word) { continue }
+    }
+    if ($endOfOptions) { $position++; continue }
+    if ($word -ceq '--') { $endOfOptions = $true; continue }
+
+    if ($isOption) {
+      $hasValue = $word.Contains('=')
+      if ($hasValue) {
+        $forms = @($word.Substring(0, $word.IndexOf('=')))
+      } elseif ($word.StartsWith('--')) {
+        $forms = @($word)
+      } else {
+        $forms = @(foreach ($char in $word.Substring(1).ToCharArray()) { '-' + $char })
+      }
+      foreach ($form in $forms) {
+        $pending = $null
+        $flag = $lookup[$form]
+        if ($null -eq $flag) {
+          if ($form.StartsWith('--no-')) {
+            $name = $form.Substring(5)
+            $flag = $lookup['--' + $name]
+            if ($null -ne $flag -and -not $flag.takesValue -and $flag.name -ceq $name) { $used[$name] = $true }
+          }
+          continue
+        }
+        $used[$flag.name] = $true
+        # A flag with an optional value only takes a value attached with '='.
+        if (-not $hasValue -and -not $flag.optionalValue) { $pending = $flag }
+      }
+      continue
+    }
+
+    if ($position -eq 0 -and $context.subcommands.name -ccontains $word) {
+      if ($path) { $path = $path + ' ' + $word } else { $path = $word }
+      $context = $spec[$path]
+      $lookup = & $index $context
+      $used = [hashtable]::new([System.StringComparer]::Ordinal)
+      continue
+    }
+    $position++
+  }
+
+  $typedIsOption = & $optionLike $typed
+  if ($null -ne $pending -and $pending.takesValue -and -not $typedIsOption) {
+    & $addValues $pending $typed ''
+    & $keepTyped
+    return $results
+  }
+
+  if ($typedIsOption) {
+    if ($typed -match '^(-[^=]+)=(.*)$') {
+      $form = $Matches[1]
+      $flag = $lookup[$form]
+      if ($null -ne $flag -and $flag.takesValue) {
+        & $addValues $flag $Matches[2] ($form + '=')
+        & $keepTyped
+      }
+    } else {
+      & $addFlags $typed
+    }
+    return $results
+  }
+
+  if (-not $endOfOptions -and $position -eq 0) {
+    foreach ($sub in $context.subcommands) {
+      & $add $sub.name 'Command' $sub.description $typed ''
+    }
+  }
+
+  $arguments = $context.arguments
+  if ($position -lt $arguments.Count) {
+    & $addValues $arguments[$position] $typed ''
+  } elseif ($arguments.Count -gt 0 -and $arguments[-1].variadic) {
+    & $addValues $arguments[-1] $typed ''
+  }
+
+  if (-not $endOfOptions) {
+    & $addFlags $typed
+  }
+  return $results`;
+/** @internal */
+const generate$2 = (executableName, descriptor) => {
+	const dataName = `$global:_${sanitize$1(executableName)}_Completions`;
+	const lines = [];
+	lines.push(`###-begin-${executableName}-completions-###`);
+	lines.push(`#`);
+	lines.push(`# Static completion script for PowerShell`);
+	lines.push(`#`);
+	lines.push(`# Installation:`);
+	lines.push(`#   ${executableName} --completions powershell > ${executableName}-completion.ps1`);
+	lines.push(`#   then add this line to your $PROFILE (use the full path to the file):`);
+	lines.push(`#   . <PATH>\\${executableName}-completion.ps1`);
+	lines.push(`#`);
+	lines.push(``);
+	lines.push(`${dataName} = [hashtable]::new([System.StringComparer]::Ordinal)`);
+	generateContexts(dataName, descriptor, [], lines, /* @__PURE__ */ new Set());
+	lines.push(``);
+	lines.push(`Register-ArgumentCompleter -Native -CommandName ${quotePs(executableName)} -ScriptBlock {`);
+	lines.push(completer(dataName));
+	lines.push(`}`);
+	lines.push(``);
+	lines.push(`###-end-${executableName}-completions-###`);
+	return lines.join("\n");
+};
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/cli/internal/config.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/cli/internal/completions/zsh.js
+const escapeZsh = (s) => s.replace(/\\/g, "\\\\").replace(/'/g, "'\\''").replace(/:/g, "\\:");
+const escapeZshExplanation = (s) => escapeZsh(s).replace(/]/g, "\\]");
+/** Escape choices for the second parse of a Zsh `_arguments` action. */
+const escapeZshChoice = (s) => s.replace(/[^A-Za-z0-9_.,/@%+-]/gu, "\\$&").replace(/'/g, "'\\''");
+const sanitize = (s) => s.replace(/[^a-zA-Z0-9_]/g, "_");
 /**
-* Config Internal
-* ================
-*
-* The processed internal representation of a Command.Config declaration.
-* Separates the user's declared config shape from the flat parsing representation.
-*
-* Key concepts:
-* - ConfigInternal: The full processed form (flags, arguments, tree)
-* - ConfigInternal.Tree: Maps declaration keys to nodes
-* - ConfigInternal.Node: Param reference, Array, or Nested subtree
-*
-* Example transformation from Command.Config to Command.Config.Internal:
-*
-* ```ts
-* // User declares:
-* const config = {
-*   verbose: Flag.Boolean("verbose").pipe(Flag.withDefault(false)),
-*   server: {
-*     host: Flag.String("host"),
-*     port: Flag.Int("port")
-*   },
-*   files: Argument.String("files").pipe(Argument.variadic)
-* }
-*
-* // Becomes Config.Internal:
-* {
-*   arguments: [filesParam],           // Flat array of arguments
-*   flags: [verboseParam, hostParam, portParam],  // Flat array of flags
-*   orderedParams: [verboseParam, hostParam, portParam, filesParam],
-*   tree: {                            // Preserves nested structure
-*     verbose: { _tag: "Param", index: 0 },
-*     server: {
-*       _tag: "Nested",
-*       tree: {
-*         host: { _tag: "Param", index: 1 },
-*         port: { _tag: "Param", index: 2 }
-*       }
-*     },
-*     files: { _tag: "Param", index: 3 }
-*   }
-* }
-* ```
-*
-* This separation allows:
-* 1. Flat iteration over all params for parsing/validation
-* 2. Reconstruction of original nested shape for handler input
+* All forms of a flag (--name, -alias, --no-name) for the exclusion group.
 */
-const ConfigInternalTypeId = "~effect/cli/Command/Config/Internal";
+const allForms = (flag) => {
+	const forms = [`--${flag.name}`];
+	for (const alias of flag.aliases) forms.push(alias.length === 1 ? `-${alias}` : `--${alias}`);
+	if (flag.type._tag === "Boolean") forms.push(`--no-${flag.name}`);
+	return forms;
+};
+const valueAction = (type) => {
+	switch (type._tag) {
+		case "Boolean": return "";
+		case "Choice": return `:value:(${type.values.map(escapeZshChoice).join(" ")})`;
+		case "Path": return type.pathType === "directory" ? `:directory:_directories` : `:file:_files`;
+		case "Int": return `:integer:`;
+		case "Finite": return `:float:`;
+		case "Date": return `:date:`;
+		default: return `:value:`;
+	}
+};
+const argAction = (type) => {
+	switch (type._tag) {
+		case "Choice": return `(${type.values.map(escapeZshChoice).join(" ")})`;
+		case "Path": return type.pathType === "directory" ? `_directories` : `_files`;
+		default: return ``;
+	}
+};
 /**
-* Parses a Command.Config into a ConfigInternal.
-*
-* Walks the config structure and:
-* 1. Extracts all Params into flat arrays (flags, arguments, orderedParams)
-* 2. Builds a tree that remembers the original nested structure
-* 3. Assigns each Param an index to link parsed values back
-*
-* @internal
+* Produce _arguments optspecs for a single flag. Each spec is a complete,
+* single-quoted string — no brace expansion, no line continuations.
 */
-const parseConfig = (config) => {
-	const orderedParams = [];
-	const flags = [];
-	const args = [];
-	function parse(config) {
-		const tree = Object.create(null);
-		for (const key of Object.keys(config)) tree[key] = parseValue(config[key]);
-		return tree;
+const flagSpecs = (flag) => {
+	const specs = [];
+	const desc = flag.description ? `[${escapeZshExplanation(flag.description)}]` : "";
+	const optional = flag.optionalValue === true && flag.type._tag !== "Boolean";
+	const valueSuffix = optional ? "=-" : "";
+	const action = optional ? `:${valueAction(flag.type)}` : valueAction(flag.type);
+	const excl = `(${allForms(flag).join(" ")})`;
+	specs.push(`'${excl}--${flag.name}${valueSuffix}${desc}${action}'`);
+	for (const alias of flag.aliases) {
+		const prefix = alias.length === 1 ? "-" : "--";
+		specs.push(`'${excl}${prefix}${alias}${valueSuffix}${desc}${action}'`);
 	}
-	function parseValue(value) {
-		if (Array.isArray(value)) return {
-			_tag: "Array",
-			children: value.map((v) => parseValue(v))
-		};
-		else if (isParam(value)) {
-			const index = orderedParams.length;
-			orderedParams.push(value);
-			if (value.kind === "argument") args.push(value);
-			else flags.push(value);
-			return {
-				_tag: "Param",
-				index
-			};
-		} else return {
-			_tag: "Nested",
-			tree: parse(value)
-		};
+	if (flag.type._tag === "Boolean") {
+		const negDesc = flag.description ? `[${escapeZshExplanation(`Disable ${flag.name}`)}]` : "";
+		specs.push(`'${excl}--no-${flag.name}${negDesc}'`);
 	}
-	return {
-		[ConfigInternalTypeId]: ConfigInternalTypeId,
-		flags,
-		arguments: args,
-		orderedParams,
-		tree: parse(config)
-	};
+	return specs;
+};
+const argSpec = (arg) => {
+	const desc = arg.description ? escapeZsh(arg.description) : arg.name;
+	const action = argAction(arg.type);
+	return `'${arg.variadic ? "*" : ""}:${desc}:${action}'`;
+};
+const generateFunction = (descriptor, parentPath, lines) => {
+	const currentPath = [...parentPath, descriptor.name];
+	const funcName = `_${currentPath.map(sanitize).join("_")}`;
+	lines.push(`${funcName}() {`);
+	if (descriptor.subcommands.length > 0) {
+		lines.push(`  local context state state_descr line`);
+		lines.push(`  typeset -A opt_args`);
+		lines.push(``);
+		lines.push(`  local -a commands`);
+		lines.push(`  commands=(`);
+		for (const sub of descriptor.subcommands) {
+			const desc = sub.description ? escapeZsh(sub.description) : "";
+			lines.push(`    '${sub.name}:${desc}'`);
+		}
+		lines.push(`  )`);
+		lines.push(``);
+		lines.push(`  local -a specs`);
+		lines.push(`  specs=(`);
+		for (const flag of descriptor.flags) for (const spec of flagSpecs(flag)) lines.push(`    ${spec}`);
+		if (descriptor.arguments.length > 0) {
+			lines.push(`    -`);
+			lines.push(`    parent-arguments`);
+			for (const arg of descriptor.arguments) lines.push(`    ${argSpec(arg)}`);
+			lines.push(`    -`);
+			lines.push(`    subcommands`);
+		}
+		lines.push(`    '1:command:->command'`);
+		lines.push(`    '*::arg:->args'`);
+		lines.push(`  )`);
+		lines.push(``);
+		lines.push(`  _arguments -C "\${specs[@]}"`);
+		lines.push(``);
+		lines.push(`  case "$state" in`);
+		lines.push(`    command)`);
+		lines.push(`      _describe -t commands 'commands' commands`);
+		lines.push(`      ;;`);
+		lines.push(`    args)`);
+		lines.push(`      case "$words[1]" in`);
+		for (const sub of descriptor.subcommands) {
+			const subFunc = `_${[...currentPath, sub.name].map(sanitize).join("_")}`;
+			lines.push(`        ${sub.name})`);
+			lines.push(`          ${subFunc}`);
+			lines.push(`          ;;`);
+		}
+		lines.push(`      esac`);
+		lines.push(`      ;;`);
+		lines.push(`  esac`);
+	} else {
+		const allSpecs = [];
+		for (const flag of descriptor.flags) allSpecs.push(...flagSpecs(flag));
+		for (const arg of descriptor.arguments) allSpecs.push(argSpec(arg));
+		if (allSpecs.length > 0) {
+			lines.push(`  local -a specs`);
+			lines.push(`  specs=(`);
+			for (const spec of allSpecs) lines.push(`    ${spec}`);
+			lines.push(`  )`);
+			lines.push(`  _arguments "\${specs[@]}"`);
+		}
+	}
+	lines.push(`}`);
+	lines.push(``);
+	for (const sub of descriptor.subcommands) generateFunction(sub, currentPath, lines);
 };
 /**
 * @internal
 */
-const emptyConfig = /*#__PURE__*/ parseConfig({});
+const generate$1 = (executableName, descriptor) => {
+	const lines = [];
+	const safeName = sanitize(executableName);
+	lines.push(`#compdef ${executableName}`);
+	lines.push(`###-begin-${executableName}-completions-###`);
+	lines.push(`#`);
+	lines.push(`# Static completion script for Zsh`);
+	lines.push(`#`);
+	lines.push(`# Installation:`);
+	lines.push(`#   ${executableName} --completions zsh > ~/.zsh/completions/_${executableName}`);
+	lines.push(`#   then add ~/.zsh/completions to your fpath`);
+	lines.push(`#`);
+	lines.push(``);
+	generateFunction(descriptor, [], lines);
+	lines.push(`# Handle both direct invocation and autoload`);
+	lines.push(`if [[ "\${zsh_eval_context[-1]}" == "loadautofunc" ]]; then`);
+	lines.push(`  _${safeName} "$@"`);
+	lines.push(`else`);
+	lines.push(`  compdef _${safeName} ${executableName}`);
+	lines.push(`fi`);
+	lines.push(`###-end-${executableName}-completions-###`);
+	return lines.join("\n");
+};
+//#endregion
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/cli/Completions.js
 /**
-* Reconstructs the original nested config shape from parsed values.
+* The `Completions` module turns a plain description of an Effect CLI command
+* tree into shell completion scripts for Bash, Zsh, Fish, and PowerShell. It
+* is the low-level script generation surface used by the unstable CLI package
+* and by the built-in completions global flag.
 *
-* Uses the tree as a blueprint to place each parsed value back into
-* its original position in the nested structure.
+* @stability unstable
+* @since 4.0.0
+*/
+/**
+* Generates a shell completion script for a command descriptor.
 *
-* @internal
+* **When to use**
+*
+* Use when you need an installable completion script from an existing
+* `CommandDescriptor`.
+*
+* **Details**
+*
+* Dispatches by `shell` to Bash, Zsh, Fish, or PowerShell generation and
+* returns a static script string for `executableName`.
+*
+* @see {@link Shell} for supported shell names
+* @see {@link CommandDescriptor} for the command shape used by completion generation
+*
+* @stability unstable
+* @category constructors
+* @since 4.0.0
 */
-const reconstructTree = (tree, results) => {
-	const output = {};
-	for (const key of Object.keys(tree)) assignProperty(output, key, nodeValue(tree[key]));
-	return output;
-	function nodeValue(node) {
-		switch (node._tag) {
-			case "Param": return results[node.index];
-			case "Array": return node.children.map((child) => nodeValue(child));
-			case "Nested": return reconstructTree(node.tree, results);
-		}
+const generate = (executableName, shell, descriptor) => {
+	switch (shell) {
+		case "bash": return generate$4(executableName, descriptor);
+		case "zsh": return generate$1(executableName, descriptor);
+		case "fish": return generate$3(executableName, descriptor);
+		case "powershell": return generate$2(executableName, descriptor);
 	}
 };
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/cli/internal/command.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/cli/Flag.js
 /**
-* Command Implementation
-* ======================
+* Creates a boolean flag that can be enabled or disabled.
 *
-* Internal implementation details for CLI commands.
-* Public API is in ../Command.ts
-*/
-const TypeId = "~effect/cli/Command";
-/**
-* Casts a Command to its internal implementation.
-* For use by internal modules that need access to config, parse, handle, etc.
+* **Example** (Creating boolean flags)
+*
+* ```ts import.meta.vitest
+* import { Flag } from "effect/cli"
+*
+* const verboseFlag = Flag.Boolean("verbose")
+* // Usage: --verbose (true) or --no-verbose (false)
+* // Omission fails unless the flag is made optional or given a fallback.
+* verboseFlag.kind // => "flag"
+* ```
+*
+* @stability unstable
+* @category constructors
+* @since 4.0.0
 */
-const toImpl = (self) => self;
-const Proto = { .../*#__PURE__*/ Prototype({
-	label: "Command",
-	evaluate() {
-		return toImpl(this).service;
-	}
-}) };
+const Boolean = (name) => Boolean$1(flagKind, name);
 /**
-* Internal command constructor. Only accepts already-parsed ConfigInternal.
+* Constructs option parameters that represent a choice between several inputs.
+* Each tuple maps a string flag value to an associated typed value.
+*
+* **Example** (Creating flag choices with values)
+*
+* ```ts import.meta.vitest
+* import { Flag } from "effect/cli"
+*
+* // simple enum like choice mapping directly to string union
+* const color = Flag.Literals("color", ["red", "green", "blue"])
+*
+* // choice with custom value mapping
+* const logLevel = Flag.ChoiceWithValue("log-level", [
+*   ["debug", "Debug" as const],
+*   ["info", "Info" as const],
+*   ["error", "Error" as const]
+* ])
+* const kinds = [color.kind, logLevel.kind] // => ["flag", "flag"]
+* ```
+*
+* @stability unstable
+* @category constructors
+* @since 4.0.0
 */
-const makeCommand = (options) => {
-	const config = options.config;
-	const contextConfig = options.contextConfig ?? emptyConfig;
-	const service = options.service ?? Service(`~effect/cli/Command/${options.name}`);
-	const annotations = options.annotations ?? empty$2();
-	const globalFlags = options.globalFlags ?? [];
-	const subcommands = options.subcommands ?? [];
-	const handle = (input, commandPath) => isNotUndefined(options.handle) ? options.handle(input, commandPath) : fail$1(new ShowHelp({
-		commandPath,
-		errors: []
-	}));
-	const parse = options.parse ?? makeParser(config);
-	const parseContext = options.parseContext ?? makeParser(contextConfig, { allowLeftovers: true });
-	const buildHelpDoc = (commandPath) => {
-		const args = [];
-		const flags = [];
-		for (const arg of config.arguments) {
-			const singles = extractSingleParams(arg);
-			const metadata = getParamMetadata(arg);
-			for (const single of singles) args.push({
-				name: single.name,
-				type: single.typeName ?? getTypeName(single.primitiveType),
-				description: single.description,
-				required: !metadata.isOptional && (!metadata.isVariadic || exists(metadata.variadicMin, (min) => min > 0)),
-				variadic: metadata.isVariadic
-			});
-		}
-		let usage = commandPath.length > 0 ? commandPath.join(" ") : options.name;
-		if (subcommands.some((group) => group.commands.some((c) => !c.unlisted))) usage += " <subcommand>";
-		usage += " [flags]";
-		for (const arg of args) {
-			const argName = arg.variadic ? `<${arg.name}...>` : `<${arg.name}>`;
-			usage += ` ${arg.required ? argName : `[${argName}]`}`;
-		}
-		for (const option of config.flags) {
-			const singles = extractSingleParams(option);
-			const metadata = getParamMetadata(option);
-			for (const single of singles) {
-				if (single.hidden) continue;
-				flags.push(toFlagDoc(single, metadata));
-			}
-		}
-		const subcommandDocs = [];
-		for (const group of subcommands) {
-			const visible = group.commands.filter((c) => !c.unlisted);
-			if (visible.length === 0) continue;
-			subcommandDocs.push({
-				group: group.group,
-				commands: map$8(visible, (subcommand) => ({
-					name: subcommand.name,
-					alias: subcommand.alias,
-					shortDescription: subcommand.shortDescription,
-					description: subcommand.description ?? ""
-				}))
-			});
-		}
-		const examples = options.examples ?? [];
-		return {
-			description: options.description ?? "",
-			usage,
-			flags,
-			annotations,
-			...args.length > 0 && { args },
-			...subcommandDocs.length > 0 && { subcommands: subcommandDocs },
-			...examples.length > 0 && { examples }
-		};
-	};
-	return Object.assign(Object.create(Proto), {
-		[TypeId]: TypeId,
-		name: options.name,
-		examples: options.examples ?? [],
-		annotations,
-		globalFlags,
-		subcommands,
-		unlisted: options.unlisted ?? false,
-		config,
-		contextConfig,
-		service,
-		parse,
-		parseContext,
-		handle,
-		buildHelpDoc,
-		...isNotUndefined(options.description) ? { description: options.description } : {},
-		...isNotUndefined(options.shortDescription) ? { shortDescription: options.shortDescription } : {},
-		...isNotUndefined(options.alias) ? { alias: options.alias } : {}
-	});
-};
+const ChoiceWithValue = (name, choices) => ChoiceWithValue$1(flagKind, name, choices);
 /**
-* Converts a single flag param into a FlagDoc for help display.
+* Adds an alias to a flag, allowing it to be referenced by multiple names.
 *
-* @internal
-*/
-const toFlagDoc = (single, metadata) => {
-	const formattedAliases = single.aliases.map((alias) => alias.length === 1 ? `-${alias}` : `--${alias}`);
-	return {
-		name: single.name,
-		aliases: formattedAliases,
-		type: single.typeName ?? getTypeName(single.primitiveType),
-		description: appendChoiceKeys(single.description, getChoiceKeys(single.primitiveType)),
-		required: single.primitiveType._tag !== "Boolean" && !metadata.isOptional
-	};
-};
-const appendChoiceKeys = (description, choiceKeys) => {
-	if (choiceKeys === void 0 || choiceKeys.length === 0) return description;
-	const choiceSuffix = `(choices: ${choiceKeys.join(", ")})`;
-	return match$4(description, {
-		onNone: () => some(choiceSuffix),
-		onSome: (value) => some(`${value} ${choiceSuffix}`)
-	});
-};
+* **Example** (Adding flag aliases)
+*
+* ```ts import.meta.vitest
+* import { Flag } from "effect/cli"
+*
+* // Flag can be used as both --verbose and -v
+* const verboseFlag = Flag.Boolean("verbose").pipe(
+*   Flag.withAlias("v")
+* )
+*
+* // Multiple aliases can be chained
+* const helpFlag = Flag.Boolean("help").pipe(
+*   Flag.withAlias("h"),
+*   Flag.withAlias("?")
+* )
+* const kinds = [verboseFlag.kind, helpFlag.kind] // => ["flag", "flag"]
+* ```
+*
+* @stability unstable
+* @category aliasing
+* @since 4.0.0
+*/
+const withAlias = /*#__PURE__*/ dual(2, (self, alias) => withAlias$1(self, alias));
 /**
-* Creates a parser for a given config. Used as the default for both `parse`
-* and `parseContext`, and also by `withSharedFlags` to avoid constructing a
-* full throwaway command.
+* Adds a description to a flag for help documentation.
+*
+* **Example** (Adding help descriptions)
+*
+* ```ts import.meta.vitest
+* import { Flag } from "effect/cli"
+*
+* const portFlag = Flag.Int("port").pipe(
+*   Flag.withDescription("The port number to listen on")
+* )
+*
+* const configFlag = Flag.File("config").pipe(
+*   Flag.withDescription("Path to the configuration file")
+* )
+* const kinds = [portFlag.kind, configFlag.kind] // => ["flag", "flag"]
+* ```
+*
+* @stability unstable
+* @category metadata
+* @since 4.0.0
 */
-const makeParser = (cfg, options) => fnUntraced(function* (input) {
-	const parsedArgs = {
-		flags: input.flags,
-		arguments: input.arguments
-	};
-	const [remainingArguments, values] = yield* parseParams(parsedArgs, cfg.orderedParams);
-	if (options?.allowLeftovers !== true && remainingArguments.length > 0) return yield* new UnexpectedArgument({ arguments: remainingArguments });
-	return reconstructTree(cfg.tree, values);
-});
+const withDescription$1 = /*#__PURE__*/ dual(2, (self, description) => withDescription$2(self, description));
 /**
-* Parses param values from parsed command arguments into their typed
-* representations.
+* Sets a custom metavar (placeholder name) for the flag in help documentation.
+*
+* **Details**
+*
+* The metavar is displayed in usage text to indicate what value the user should
+* provide. For example, `--output FILE` shows `FILE` as the metavar.
+*
+* **Example** (Setting metavars)
+*
+* ```ts import.meta.vitest
+* import { Flag } from "effect/cli"
+*
+* const databaseFlag = Flag.String("database-url").pipe(
+*   Flag.withMetavar("URL"),
+*   Flag.withDescription("Database connection URL")
+* )
+* // In help: --database-url URL
+*
+* const timeoutFlag = Flag.Int("timeout").pipe(
+*   Flag.withMetavar("SECONDS")
+* )
+* // In help: --timeout SECONDS
+* const kinds = [databaseFlag.kind, timeoutFlag.kind] // => ["flag", "flag"]
+* ```
+*
+* @stability unstable
+* @category metadata
+* @since 4.0.0
 */
-const parseParams = /*#__PURE__*/ fnUntraced(function* (parsedArgs, params) {
-	const results = [];
-	let currentArguments = parsedArgs.arguments;
-	for (const option of params) {
-		const [remainingArguments, parsed] = yield* option.parse({
-			flags: parsedArgs.flags,
-			arguments: currentArguments
-		});
-		results.push(parsed);
-		currentArguments = remainingArguments;
-	}
-	return [currentArguments, results];
-});
-//#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/cli/internal/completions/descriptor.js
+const withMetavar = /*#__PURE__*/ dual(2, (self, metavar) => withMetavar$1(self, metavar));
 /**
-* CommandDescriptor — pure-data representation of a command tree for
-* shell completion generation.
+* Makes a flag optional, returning an Option type that can be None if not provided.
 *
-* @internal
+* **Example** (Making flags optional)
+*
+* ```ts import.meta.vitest
+* import { Effect, FileSystem, Layer, Option, Path, Stdio, Terminal } from "effect"
+* import { Flag } from "effect/cli"
+* import { ChildProcessSpawner } from "effect/process"
+*
+* const CliTestLayer = Layer.mergeAll(
+*   FileSystem.layerNoop({}),
+*   Path.layer,
+*   Stdio.layerTest({}),
+*   Layer.succeed(Terminal.Terminal, Terminal.make({
+*     columns: Effect.succeed(80),
+*     rows: Effect.succeed(24),
+*     readInput: Effect.die("unused"),
+*     readLine: Effect.die("unused"),
+*     display: () => Effect.void
+*   })),
+*   Layer.succeed(
+*     ChildProcessSpawner.ChildProcessSpawner,
+*     ChildProcessSpawner.make(() => Effect.die("unused"))
+*   )
+* )
+*
+* const optionalPort = Flag.optional(Flag.Int("port"))
+*
+* const program = Effect.gen(function*() {
+*   const [, port] = yield* optionalPort.parse({
+*     arguments: [],
+*     flags: { "port": ["4000"] }
+*   })
+*   return port
+* })
+*
+* await Effect.runPromise(program.pipe(Effect.provide(CliTestLayer))) // => Option.some(4000)
+* ```
+*
+* @stability unstable
+* @category optionality
+* @since 4.0.0
 */
-const toFlagType = (single) => {
-	switch (single.primitiveType._tag) {
-		case "Boolean": return { _tag: "Boolean" };
-		case "Int": return { _tag: "Int" };
-		case "Finite": return { _tag: "Finite" };
-		case "Date": return { _tag: "Date" };
-		case "Choice": return {
-			_tag: "Choice",
-			values: getChoiceKeys(single.primitiveType) ?? []
-		};
-		case "Path": return {
-			_tag: "Path",
-			pathType: getPathType(single.primitiveType) ?? "either"
-		};
-		case "FileText":
-		case "FileParse":
-		case "FileSchema": return {
-			_tag: "Path",
-			pathType: "file"
-		};
-		default: return { _tag: "String" };
-	}
-};
-const toArgumentType = (single) => {
-	switch (single.primitiveType._tag) {
-		case "Int": return { _tag: "Int" };
-		case "Finite": return { _tag: "Finite" };
-		case "Date": return { _tag: "Date" };
-		case "Choice": return {
-			_tag: "Choice",
-			values: getChoiceKeys(single.primitiveType) ?? []
-		};
-		case "Path": return {
-			_tag: "Path",
-			pathType: getPathType(single.primitiveType) ?? "either"
-		};
-		case "FileText":
-		case "FileParse":
-		case "FileSchema": return {
-			_tag: "Path",
-			pathType: "file"
-		};
-		default: return { _tag: "String" };
-	}
-};
+const optional = (param) => optional$1(param);
 /**
-* @internal
+* Provides a default value for a flag when it's not specified.
+*
+* **Example** (Providing default values)
+*
+* ```ts import.meta.vitest
+* import { Flag } from "effect/cli"
+*
+* const portFlag = Flag.Int("port").pipe(
+*   Flag.withDefault(8080)
+* )
+* // If --port is not provided, defaults to 8080
+*
+* const hostFlag = Flag.String("host").pipe(
+*   Flag.withDefault("localhost")
+* )
+* // If --host is not provided, defaults to "localhost"
+* const kinds = [portFlag.kind, hostFlag.kind] // => ["flag", "flag"]
+* ```
+*
+* @stability unstable
+* @category optionality
+* @since 4.0.0
 */
-const fromCommand = (cmd, inheritedFlags = []) => {
-	const impl = toImpl(cmd);
-	const config = impl.config;
-	const flags = [];
-	const seen = /* @__PURE__ */ new Set();
-	for (const [index, flag] of [...config.flags, ...inheritedFlags].entries()) {
-		const singles = extractSingleParams(flag);
-		for (const single of singles) {
-			if (single.kind !== "flag") continue;
-			if (single.hidden) continue;
-			if (index >= config.flags.length && seen.has(single.name)) continue;
-			seen.add(single.name);
-			flags.push({
-				name: single.name,
-				aliases: single.aliases,
-				description: getOrUndefined$1(single.description),
-				type: toFlagType(single)
-			});
-		}
-	}
-	const args = [];
-	for (const arg of config.arguments) {
-		const singles = extractSingleParams(arg);
-		const metadata = getParamMetadata(arg);
-		for (const single of singles) {
-			if (single.kind !== "argument") continue;
-			args.push({
-				name: single.name,
-				description: getOrUndefined$1(single.description),
-				required: !metadata.isOptional,
-				variadic: metadata.isVariadic,
-				type: toArgumentType(single)
-			});
-		}
-	}
-	const subcommands = [];
-	const sharedFlags = [...inheritedFlags, ...impl.contextConfig.flags];
-	for (const group of cmd.subcommands) for (const subcommand of group.commands) {
-		if (subcommand.unlisted) continue;
-		const descriptor = fromCommand(subcommand, sharedFlags);
-		subcommands.push(descriptor);
-		if (subcommand.alias && subcommand.alias !== subcommand.name) subcommands.push({
-			...descriptor,
-			name: subcommand.alias
-		});
-	}
-	return {
-		name: cmd.name,
-		description: cmd.shortDescription ?? cmd.description,
-		flags,
-		arguments: args,
-		subcommands
-	};
-};
+const withDefault = withDefault$1;
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/cli/internal/help.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/cli/internal/help.js
 /**
 * Help Documentation
 * ================
@@ -24242,7 +24092,7 @@ const getHelpForCommandPath = (command, commandPath, builtIns) => gen(function*
 	};
 });
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/cli/GlobalFlag.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/cli/GlobalFlag.js
 /**
 * Global flags for Effect CLI command trees. Global flags are parsed outside a
 * single command's local flags and can apply to a command and its descendants.
@@ -24425,7 +24275,7 @@ const BuiltIns = [
 	LogLevel
 ];
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/cli/CliConfig.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/cli/CliConfig.js
 /**
 * Configuration for Effect CLI command execution.
 *
@@ -24455,7 +24305,7 @@ var CliConfig = class extends (/*#__PURE__*/ Reference("effect/cli/CliConfig", {
 */
 const defaults = { builtIns: BuiltIns };
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/cli/internal/lexer.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/cli/internal/lexer.js
 /**
 * @internal
 */
@@ -24517,7 +24367,7 @@ const lexTokens = (args) => {
 	return tokens;
 };
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/cli/internal/auto-suggest.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/cli/internal/auto-suggest.js
 /**
 * Simple Levenshtein distance implementation (small N, no perf worries)
 */
@@ -24545,7 +24395,7 @@ const suggest = (input, candidates) => {
 	return distances.filter(([d]) => d === minDistance).map(([, c]) => c);
 };
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/cli/internal/parser.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/cli/internal/parser.js
 /**
 * Parsing Pipeline for CLI Commands
 * ==================================
@@ -24575,7 +24425,7 @@ const suggest = (input, candidates) => {
 /**
 * @internal
 */
-const getCommandPath = (parsedInput) => match$4(parsedInput.subcommand, {
+const getCommandPath = (parsedInput) => match$5(parsedInput.subcommand, {
 	onNone: () => [],
 	onSome: (subcommand) => [subcommand.name, ...getCommandPath(subcommand.parsedInput)]
 });
@@ -24731,8 +24581,9 @@ const asBooleanLiteral = (token) => token?._tag === "Value" && (isTrueLiteral(to
 *
 * Value resolution order:
 * 1. Inline value: --flag=value or -f=value
-* 2. Boolean special case: implicit "true" or explicit boolean literal
-* 3. Next token: consume following Value token if present
+* 2. Optional value: the flag's configured value, without consuming a token
+* 3. Boolean special case: implicit "true" or explicit boolean literal
+* 4. Next token: consume following Value token if present
 */
 const consumeFlagValue = (cursor, token, spec, negated = false) => {
 	const consumed = consumeFlagValueWithTokens(cursor, token, spec, negated);
@@ -24754,7 +24605,7 @@ const consumeFlagValueWithTokens = (cursor, token, spec, negated = false) => {
 			error: invalidNegatedFlagValue(token, spec, token.value),
 			tokens: []
 		};
-		const literal = asBooleanLiteral(cursor.peek());
+		const literal = spec.optionalValue === void 0 ? asBooleanLiteral(cursor.peek()) : void 0;
 		if (literal !== void 0) {
 			const literalToken = cursor.take();
 			return {
@@ -24774,6 +24625,11 @@ const consumeFlagValueWithTokens = (cursor, token, spec, negated = false) => {
 		value: token.value,
 		tokens: []
 	};
+	if (spec.optionalValue !== void 0) return {
+		_tag: "Value",
+		value: spec.optionalValue,
+		tokens: []
+	};
 	if (isBoolean(spec.primitiveType)) {
 		const literal = asBooleanLiteral(cursor.peek());
 		const literalToken = literal !== void 0 ? cursor.take() : void 0;
@@ -25077,7 +24933,7 @@ const scanCommandLevel = (tokens, context) => {
 	return toLeafResult(state);
 };
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/cli/internal/wizard.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/cli/internal/wizard.js
 const run$1 = /*#__PURE__*/ fnUntraced(function* (command, options) {
 	const commandPath = options?.commandPath ?? [command.name];
 	const selected = getCommandAtPath(command, commandPath);
@@ -25160,7 +25016,7 @@ const promptParam = /*#__PURE__*/ fnUntraced(function* (param) {
 	yield* param.parse(parsed);
 	yield* log();
 	if (single.kind === "argument") return values;
-	return values.flatMap((value) => value.value.startsWith("-") && value.value.length > 1 ? [commandLineArg(`--${single.name}=${value.value}`, `--${single.name}=${value.displayValue}`)] : [commandLineArg(`--${single.name}`), value]);
+	return values.flatMap((value) => single.optionalValue !== void 0 || value.value.startsWith("-") && value.value.length > 1 ? [commandLineArg(`--${single.name}=${value.value}`, `--${single.name}=${value.displayValue}`)] : [commandLineArg(`--${single.name}`), value]);
 });
 const promptSingle = (single) => {
 	const message = renderParamMessage(single);
@@ -25248,7 +25104,7 @@ const wrapCommand = (commandLine) => {
 };
 const formatShellArg = (arg) => /^[A-Za-z0-9_./:@%+=,-]+$/.test(arg) ? arg : `'${arg.replaceAll("'", `'"'"'`)}'`;
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/cli/Command.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/cli/Command.js
 /**
 * Creates a `Command` from a name, an optional configuration, and an optional
 * handler.
@@ -25681,7 +25537,7 @@ const runWith = (command, config) => {
 			const [, value] = yield* flag.flag.parse(emptyArgs);
 			program = provideService(program, flag, value);
 		}
-		const services = match$4(logLevel, {
+		const services = match$5(logLevel, {
 			onNone: () => empty$2(),
 			onSome: (level) => make$26(MinimumLogLevel, level)
 		});
@@ -25690,7 +25546,7 @@ const runWith = (command, config) => {
 };
 //#endregion
 //#region package.json
-var version = "0.1.1076";
+var version = "0.1.1079";
 //#endregion
 //#region src/install.ts
 const cli = pipe(make("deslop-coding-standards", {}, fnUntraced(function* () {
@@ -25726,7 +25582,10 @@ const cli = pipe(make("deslop-coding-standards", {}, fnUntraced(function* () {
 	const targets = dedupe([
 		...directories,
 		".claude",
-		...contains(directories, ".codex") ? [] : [".agents"]
+		...match(contains(directories, ".codex"), {
+			onFalse: () => [".agents"],
+			onTrue: () => empty$3()
+		})
 	]);
 	function isGlobal(destination) {
 		return some$1(globals, (global) => destination === global || pipe(destination, startsWith(`${global}${path.sep}`)));