@deslop/stash 0.1.1076 → 0.1.1079

package/dist/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env -S node --max-old-space-size=16384 --heapsnapshot-near-heap-limit=3 --report-on-fatalerror
-import { $d as identity, $n as value, $o as runForkWith, Ao as match$2, Ba as catchCauseIf, Bo as orDie, Bs as isEmpty, Cs as void_, Ct as Defect, D as option, Do as map$2, Dt as FalseLiterals, Ei as runHead, El as taggedEnum, Eo as makeSpanScoped, Fi as unwrap, Fl as filter$1, Fo as onError, Ft as NonEmptyArray, Fu as Reference, Ga as catchTag, Gi as bounded, Go as provideService, Ha as catchFilter, Hu as getUnsafe, I as layerJson, Ic as Scope, Iu as Service, J as isStreamSchema, Ja as context, Ji as failCause, Ju as exists, Ka as catchTags, Ks as replace, La as cached, Lc as addFinalizer, Ld as hasProperty, Ll as findFirst, Lu as add, Ml as empty$2, Ms as min, N as withRunClient, Na as annotateLogs, Nd as format, Ns as spaced, Os as withParentSpan, Ou as succeed$2, P as RpcSerialization, Pu as toMillis, Q as makeCollectorUnsafe, Qa as ensuring, Qn as make$2, R as RequestId, Ra as callback, Rc as addFinalizerExit, Rl as findFirstIndex, Ro as onInterrupt, Ru as empty$1, Sn as tag, So as logError, Ss as useSpan, Td as assignProperty, Ts as withFiber, Tt as Error$1, Tu as isSuccess, Un as empty, Uo as provide, Ut as TaggedError, Uu as make$3, V as constPing, Vd as isNotUndefined, Vs as isNonEmpty, Vt as String$6, Vu as getOrUndefinedUnsafe, W as exitSchema, Wn as fromInput, Wo as provideContext, Wt as TrueLiterals, X as spanName, Xa as delay, Xl as isReadonlyArrayNonEmpty, Y as spanAttributes, Yd as constVoid, Yo as result, Z as Collector, Zd as dual, Zi as offerAll, Zl as join, Zo as retryOrElse, Zr as filter, Zt as Union, _ as QuitError, _c as interruptors, _o as interrupt$1, _t as ArraySchema, aa as makeUnsafe, ad as isSome, ai as fromQueue, al as isFailure, as as succeed$1, bd as Prototype, bn as optional$2, c as NotesError, ca as interrupt$2, cd as map$3, cl as ConsoleRef, co as forever, cs as sync$1, do as forkScoped, ea as shutdownUnsafe, ed as fromUndefinedOr, ef as pipe, el as die, en as decodeSync, eo as fail$1, et as Socket, eu as map$4, fc as findError, fs as timeout, ft as HttpClientErrorSchema, g as layer, gl as sync, go as ignoreCause, h as errorReported, hc as hasInterrupts, ho as ignore, id as isNone, in as encodeEffect, is as serviceOption, it as SocketReadError, iu as reduce, j as Stdio, ja as andThen, jc as provide$1, jo as matchCauseEffect, js as exponential, jt as Literal, ko as mapError, ld as match$1, ln as is, m as errorExitCode, mo as gen, ms as timeoutOrElse, nc as round, nl as failCause$1, nn as decodeUnknownEffect, ns as scoped, nt as SocketErrorReason, oo as fnUntraced, ot as layerWebSocket, ou as some$1, p as runMain, pd as some, q as getStreamSchemas, qc as MinimumLogLevel, qi as end, qn as merge, qo as raceFirst, rc as Clock, rd as getOrUndefined, rl as interrupt, ro as flatMap$1, sa as getCurrent, so as forEach, ss as suspend, st as layerWebSocketConstructorGlobal, t as RpcContracts, ta as take, td as getOrElse, tf as pipeArguments, tl as fail, tt as SocketError, tu as match, u as LogToStderr, ud as none, uo as forkIn, us as tapCause, v as Terminal, vo as interruptible, w as String$7, wc as effect, wd as withFiber$1, wn as toCodecStringTree, wo as logInfo, ws as whileLoop, x as Crypto, xc as squash, xn as optionalKey, y as isQuitError, yo as isEffect, ys as uninterruptibleMask, yt as BooleanLiterals, yu as fail$2, za as catchCause, zl as findLast, zu as get } from "./contracts-DgOSCO2p.mjs";
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/workers/WorkerError.js
+import { $a as catchCauseIf, $d as isNotUndefined, $l as findLast, $o as orDie, $u as getOrUndefinedUnsafe, Al as sync, Ao as interrupt$1, Bl as taggedEnum, Bo as map$2, Bu as succeed$2, Co as forkIn, Cs as tapCause, Ct as Defect, D as option, Do as gen, Ds as timeoutOrElse, Dt as FalseLiterals, Ec as findError, Fc as squash, Fo as logError, Fs as useSpan, Ft as NonEmptyArray, Gc as provide$1, Gd as format, Gs as exponential, Ho as mapError, Hs as withParentSpan, I as layerJson, Id as withFiber$1, Is as void_, J as isStreamSchema, Ji as bounded, Jo as onError, Ju as Service, Ka as annotateLogs, Kl as empty$2, Kn as empty, Ks as min, Ku as toMillis, Ld as assignProperty, Lo as logInfo, Md as Prototype, Mo as isEffect, Ms as uninterruptibleMask, N as withRunClient, Nu as fail$2, Oo as ignore, P as RpcSerialization, Q as makeCollectorUnsafe, Qa as catchCause, Qc as addFinalizerExit, Ql as findFirstIndex, R as RequestId, Rc as effect, Ri as unwrap, Rs as whileLoop, Ru as isSuccess, Sd as none, Sl as ConsoleRef, Sn as tag, Td as some, Ts as timeout, Tt as Error$1, Uo as match$2, Ut as TaggedError, V as constPing, Vt as String$6, W as exitSchema, Wa as andThen, Wo as matchCauseEffect, Wt as TrueLiterals, X as spanName, Xa as cached, Xc as Scope, Xi as end, Xn as merge, Xu as empty$1, Y as spanAttributes, Yd as hasProperty, Yl as filter$1, Yu as add, Z as Collector, Za as callback, Zc as addFinalizer, Zi as failCause, Zl as findFirst, Zo as onInterrupt, Zt as Union, Zu as get, _ as QuitError, _c as Clock, _d as isSome, _l as interrupt, _s as serviceOption, _t as ArraySchema, ao as catchTags, bd as map$3, bn as optional$2, bo as forEach, bs as suspend, bu as some$1, c as NotesError, ca as makeUnsafe, ci as fromQueue, cs as result, da as interrupt$2, df as identity, do as ensuring, du as join, ea as offerAll, ec as isEmpty, ed as getUnsafe, ei as filter, en as decodeSync, et as Socket, fd as fromUndefinedOr, ff as pipe, fs as runForkWith, ft as HttpClientErrorSchema, g as layer, gc as round, gd as isNone, gl as failCause$1, go as flatMap$1, h as errorReported, hd as getOrUndefined, hl as fail, hs as scoped, hu as match, ia as take, in as encodeEffect, io as catchTag, is as provideService, it as SocketReadError, j as Stdio, jc as interruptors, jo as interruptible, jt as Literal, kc as hasInterrupts, ki as runHead, ko as ignoreCause, lf as dual, ln as is, lo as delay, m as errorExitCode, ml as die, mu as map$4, nn as decodeUnknownEffect, nr as value, ns as provide, nt as SocketErrorReason, oc as replace, od as exists, os as raceFirst, ot as layerWebSocket, p as runMain, pd as getOrElse, pf as pipeArguments, po as fail$1, q as getStreamSchemas, qn as fromInput, qs as spaced, qu as Reference, ra as shutdownUnsafe, rs as provideContext, sf as constVoid, sl as MinimumLogLevel, so as context, st as layerWebSocketConstructorGlobal, t as RpcContracts, tc as isNonEmpty, td as make$3, to as catchFilter, tr as make$2, tt as SocketError, u as LogToStderr, ua as getCurrent, us as retryOrElse, uu as isReadonlyArrayNonEmpty, v as Terminal, vs as succeed$1, vu as reduce, w as String$7, wn as toCodecStringTree, wo as forkScoped, x as Crypto, xd as match$1, xn as optionalKey, xo as forever, xs as sync$1, y as isQuitError, yl as isFailure, yo as fnUntraced, yt as BooleanLiterals, zo as makeSpanScoped, zs as withFiber } from "./contracts-Cc_B2S3-.mjs";
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/workers/WorkerError.js
 /**
 * Worker error reason for failures while spawning or setting up a worker.
 *
@@ -64,7 +64,7 @@ const WorkerErrorReason = /*#__PURE__*/ Union([
 	WorkerUnknownError
 ]);
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/rpc/RpcClientError.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/rpc/RpcClientError.js
 /**
 * Client-side protocol failures reported by unstable RPC transports.
 *
@@ -119,7 +119,7 @@ var RpcClientError = class extends (/*#__PURE__*/ Error$1(TypeId$4)({
 	}
 };
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/rpc/RpcClient.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/rpc/RpcClient.js
 let requestIdCounter = 0;
 /**
 * Creates an RPC client for an already-decoded message channel, returning the
@@ -620,16 +620,19 @@ const makePinger = /*#__PURE__*/ fnUntraced(function* (writePing, options) {
 	const interval = options?.pingInterval ?? "5 seconds";
 	const timeoutMillis = toMillis(options?.pingTimeout ?? interval);
 	let lastSeen = clock.currentTimeMillisUnsafe();
+	let awaitingResponse = false;
 	const latch = makeUnsafe();
 	const onFrame = () => {
 		lastSeen = clock.currentTimeMillisUnsafe();
+		awaitingResponse = false;
 	};
 	const reset = () => {
 		onFrame();
 		latch.closeUnsafe();
 	};
 	yield* suspend(() => {
-		if (clock.currentTimeMillisUnsafe() - lastSeen > timeoutMillis) return latch.open;
+		if (awaitingResponse && clock.currentTimeMillisUnsafe() - lastSeen > timeoutMillis) return latch.open;
+		awaitingResponse = true;
 		return writePing;
 	}).pipe(delay(interval), ignore, forever, interruptible, forkScoped);
 	return {
@@ -669,7 +672,7 @@ const layerProtocolSocket = (options) => effect(Protocol)(makeProtocolSocket(opt
 */
 var ConnectionHooks = class extends (/*#__PURE__*/ Service()("effect/rpc/RpcClient/ConnectionHooks")) {};
 //#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.
 *
@@ -808,7 +811,7 @@ const log = (...args) => consoleWith((console) => sync(() => {
 	console.log(...args);
 }));
 //#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.
 *
@@ -1338,7 +1341,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.
 *
@@ -1577,7 +1580,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,
@@ -1717,7 +1720,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.
 *
@@ -3224,7 +3227,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
 /**
 * Defines the shared parameter model for CLI arguments and flags.
 *
@@ -3933,7 +3936,7 @@ const getParamMetadata = (param) => {
 	});
 };
 //#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/cli/Argument.js
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/cli/Argument.js
 /**
 * Creates a positional string argument.
 *
@@ -3971,7 +3974,7 @@ const String$2 = (name) => String$3(argumentKind, name);
 */
 const withDescription$2 = /*#__PURE__*/ dual(2, (self, description) => withDescription$3(self, description));
 //#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.
 *
@@ -4263,484 +4266,916 @@ 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 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 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;
+	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)
+		};
 	}
+	return {
+		[ConfigInternalTypeId]: ConfigInternalTypeId,
+		flags,
+		arguments: args,
+		orderedParams,
+		tree: parse(config)
+	};
 };
-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(`        ;;`);
+/**
+* @internal
+*/
+const emptyConfig = /*#__PURE__*/ parseConfig({});
+/**
+* Reconstructs the original nested config shape from parsed values.
+*
+* Uses the tree as a blueprint to place each parsed value back into
+* its original position in the nested structure.
+*
+* @internal
+*/
+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);
 		}
-		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(``);
+};
+//#endregion
+//#region ../../node_modules/.pnpm/effect@4.0.5/node_modules/effect/dist/cli/internal/command.js
+/**
+* Command Implementation
+* ======================
+*
+* 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.
+*/
+const toImpl = (self) => self;
+const Proto = { .../*#__PURE__*/ Prototype({
+	label: "Command",
+	evaluate() {
+		return toImpl(this).service;
 	}
-	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("|")}) ;;`);
-			}
+}) };
+/**
+* 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$1();
+	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
+			});
 		}
-		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(`      ;;`);
+		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}]`}`;
 		}
-		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`);
+		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));
+			}
 		}
-	} 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$1(sub, currentPath, lines, helperName);
+		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$4(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 } : {}
+	});
 };
 /**
+* Converts a single flag param into a FlagDoc for help display.
+*
 * @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");
+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
+	};
 };
-//#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, "\\$&"));
-/**
-* Build a Fish condition that checks the current subcommand context.
-*
-* 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 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;
+const appendChoiceKeys = (description, choiceKeys) => {
+	if (choiceKeys === void 0 || choiceKeys.length === 0) return description;
+	const choiceSuffix = `(choices: ${choiceKeys.join(", ")})`;
+	return match$1(description, {
+		onNone: () => some(choiceSuffix),
+		onSome: (value) => some(`${value} ${choiceSuffix}`)
+	});
 };
 /**
-* 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).
+* 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 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 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;
 	}
-};
-const argValueArgs = (type) => {
-	switch (type._tag) {
-		case "Choice": return `-r -f -a '${type.values.map(escapeFishChoice).join(" ")}'`;
-		case "Path": return `-r -F`;
-		default: return;
+	return [currentArguments, results];
+});
+/**
+* Checks that inherited parent context flags do not reuse names declared by
+* child command flags.
+*
+* When `contextConfig` is supplied, it is used as the inherited flag set;
+* otherwise the parent's current context config is checked.
+*/
+const checkForDuplicateFlags = (parent, subcommands, options) => {
+	const parentImpl = toImpl(parent);
+	const parentOptionNames = /* @__PURE__ */ new Set();
+	const extractNames = (flags) => {
+		for (const option of flags) {
+			const singles = extractSingleParams(option);
+			for (const single of singles) parentOptionNames.add(single.name);
+		}
+	};
+	extractNames((options?.contextConfig ?? parentImpl.contextConfig).flags);
+	for (const subcommand of subcommands) {
+		const subImpl = toImpl(subcommand);
+		for (const option of subImpl.config.flags) {
+			const singles = extractSingleParams(option);
+			for (const single of singles) if (parentOptionNames.has(single.name)) throw new DuplicateOption({
+				option: single.name,
+				parentCommand: parent.name,
+				childCommand: subcommand.name
+			});
+		}
 	}
 };
-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(" "));
+//#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" };
 	}
-	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 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" };
 	}
-	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
+*/
+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(single.description),
+				type: toFlagType(single),
+				optionalValue: single.optionalValue !== void 0
+			});
 		}
 	}
-	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(" "));
-			}
+	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(single.description),
+				required: !metadata.isOptional,
+				variadic: metadata.isVariadic,
+				type: toArgumentType(single)
+			});
 		}
 	}
-	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 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
+		});
 	}
-	for (const sub of descriptor.subcommands) generateCompletions(executableName, sub, [...parentPath, sub.name], lines);
+	return {
+		name: cmd.name,
+		description: cmd.shortDescription ?? cmd.description,
+		flags,
+		arguments: args,
+		subcommands
+	};
 };
 /**
+* Whether the flag reads its value from the next word.
+*
 * @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 takesSeparateValue = (flag) => flag.type._tag !== "Boolean" && flag.optionalValue !== true;
 //#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.
+//#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(``);
+};
+/**
+* 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 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")}`);
+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;
 	}
-	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 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;
 	}
-	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.
-*/
-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));
+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(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(``);
+	}
+	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("|")}) ;;`);
+		}
+		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 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`);
+		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(`}`);
-	for (const sub of descriptor.subcommands) generateContexts(dataName, sub, [...path, sub.name], lines, seen);
+	lines.push(``);
+	for (const sub of descriptor.subcommands) generateFunction$1(sub, currentPath, lines, helperName);
 };
 /**
-* 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.
+* @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.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, "\\$&"));
+/**
+* Build a Fish condition that checks the current subcommand context.
+*
+* 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 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;
+};
+/**
+* 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 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);
+};
+/**
+* @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");
+};
+//#endregion
+//#region ../../node_modules/.pnpm/effect@4.0.5/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.
+*/
+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(`  )`);
+};
+/**
+* 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 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);
+};
+/**
+* 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 completer = (dataName) => String.raw`  param($wordToComplete, $commandAst, $cursorPosition)
 
@@ -4873,7 +5308,8 @@ const completer = (dataName) => String.raw`  param($wordToComplete, $commandAst,
           continue
         }
         $used[$flag.name] = $true
-        if (-not $hasValue) { $pending = $flag }
+        # A flag with an optional value only takes a value attached with '='.
+        if (-not $hasValue -and -not $flag.optionalValue) { $pending = $flag }
       }
       continue
     }
@@ -4942,863 +5378,440 @@ const generate$2 = (executableName, descriptor) => {
 	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/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.
-*/
-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 ``;
-	}
-};
-/**
-* 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}'`);
-	}
-	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 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.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
-*/
-/**
-* 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
-*
-* @stability unstable
-* @category constructors
-* @since 4.0.0
-*/
-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/Flag.js
-/**
-* Creates a string flag that accepts text input.
-*
-* **Example** (Creating string flags)
-*
-* ```ts import.meta.vitest
-* import { Flag } from "effect/cli"
-*
-* const nameFlag = Flag.String("name")
-* // Usage: --name "John Doe"
-* nameFlag.kind // => "flag"
-* ```
-*
-* @stability unstable
-* @category constructors
-* @since 4.0.0
-*/
-const String$1 = (name) => String$3(flagKind, name);
-/**
-* 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
-*/
-const withAlias = /*#__PURE__*/ dual(2, (self, alias) => withAlias$1(self, alias));
-/**
-* 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 withDescription$1 = /*#__PURE__*/ dual(2, (self, description) => withDescription$3(self, description));
-/**
-* 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 withMetavar = /*#__PURE__*/ dual(2, (self, metavar) => withMetavar$1(self, metavar));
-/**
-* 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
-*/
-const optional = (param) => optional$1(param);
-/**
-* 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 withDefault = withDefault$1;
-/**
-* Adds a fallback config that is loaded when a required flag is missing.
-*
-* **Example** (Falling back to config)
-*
-* ```ts import.meta.vitest
-* import { Config } from "effect"
-* import { Flag } from "effect/cli"
-*
-* const verbose = Flag.Boolean("verbose").pipe(
-*   Flag.withFallbackConfig(Config.Boolean("VERBOSE"))
-* )
-* verbose.kind // => "flag"
-* ```
-*
-* @stability unstable
-* @category combinators
-* @since 4.0.0
-*/
-const withFallbackConfig = /*#__PURE__*/ dual(2, (self, config) => withFallbackConfig$1(self, config));
+	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.
+*
+* **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
 *
-* @internal
+* @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 string flag that accepts text input.
 *
-* Internal implementation details for CLI commands.
-* Public API is in ../Command.ts
+* **Example** (Creating string flags)
+*
+* ```ts import.meta.vitest
+* import { Flag } from "effect/cli"
+*
+* const nameFlag = Flag.String("name")
+* // Usage: --name "John Doe"
+* nameFlag.kind // => "flag"
+* ```
+*
+* @stability unstable
+* @category constructors
+* @since 4.0.0
 */
-const TypeId = "~effect/cli/Command";
+const String$1 = (name) => String$3(flagKind, name);
 /**
-* Casts a Command to its internal implementation.
-* For use by internal modules that need access to config, parse, handle, etc.
+* 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 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$1();
-	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$4(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
+* **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 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$1(description, {
-		onNone: () => some(choiceSuffix),
-		onSome: (value) => some(`${value} ${choiceSuffix}`)
-	});
-};
+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$3(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];
-});
+const withMetavar = /*#__PURE__*/ dual(2, (self, metavar) => withMetavar$1(self, metavar));
 /**
-* Checks that inherited parent context flags do not reuse names declared by
-* child command flags.
+* Makes a flag optional, returning an Option type that can be None if not provided.
 *
-* When `contextConfig` is supplied, it is used as the inherited flag set;
-* otherwise the parent's current context config is checked.
+* **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 checkForDuplicateFlags = (parent, subcommands, options) => {
-	const parentImpl = toImpl(parent);
-	const parentOptionNames = /* @__PURE__ */ new Set();
-	const extractNames = (flags) => {
-		for (const option of flags) {
-			const singles = extractSingleParams(option);
-			for (const single of singles) parentOptionNames.add(single.name);
-		}
-	};
-	extractNames((options?.contextConfig ?? parentImpl.contextConfig).flags);
-	for (const subcommand of subcommands) {
-		const subImpl = toImpl(subcommand);
-		for (const option of subImpl.config.flags) {
-			const singles = extractSingleParams(option);
-			for (const single of singles) if (parentOptionNames.has(single.name)) throw new DuplicateOption({
-				option: single.name,
-				parentCommand: parent.name,
-				childCommand: subcommand.name
-			});
-		}
-	}
-};
-//#endregion
-//#region ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/cli/internal/completions/descriptor.js
+const optional = (param) => optional$1(param);
 /**
-* CommandDescriptor — pure-data representation of a command tree for
-* shell completion generation.
+* Provides a default value for a flag when it's not specified.
 *
-* @internal
+* **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 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 withDefault = withDefault$1;
 /**
-* @internal
+* Adds a fallback config that is loaded when a required flag is missing.
+*
+* **Example** (Falling back to config)
+*
+* ```ts import.meta.vitest
+* import { Config } from "effect"
+* import { Flag } from "effect/cli"
+*
+* const verbose = Flag.Boolean("verbose").pipe(
+*   Flag.withFallbackConfig(Config.Boolean("VERBOSE"))
+* )
+* verbose.kind // => "flag"
+* ```
+*
+* @stability unstable
+* @category combinators
+* @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(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(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 withFallbackConfig = /*#__PURE__*/ dual(2, (self, config) => withFallbackConfig$1(self, config));
 //#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
 * ================
@@ -5908,7 +5921,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.
@@ -6091,7 +6104,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.
 *
@@ -6121,7 +6134,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
 */
@@ -6183,7 +6196,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)
 */
@@ -6211,7 +6224,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
 * ==================================
@@ -6397,8 +6410,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);
@@ -6420,7 +6434,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 {
@@ -6440,6 +6454,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;
@@ -6743,7 +6762,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);
@@ -6826,7 +6845,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);
@@ -6914,7 +6933,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
 /**
 * Returns `true` if the provided value is a `Command`.
 *
@@ -7523,11 +7542,12 @@ const runWith = (command, config) => {
 };
 //#endregion
 //#region package.json
-var version = "0.1.1076";
+var version = "0.1.1079";
 //#endregion
 //#region src/main.cli.ts
 function section(title, text) {
-	return isEmpty(text) ? "" : `## ${title}\n\n${text}`;
+	if (isEmpty(text)) return "";
+	return `## ${title}\n\n${text}`;
 }
 const save = pipe(make("save", {
 	entry: pipe(String$2("text"), withDescription$2("A link, or the text of a note")),