fleetfizz 0.8.1 → 0.9.0

package/dist/fleetfizz.mjs

@@ -2750,9 +2750,9 @@ const Prototype = (options) => makePrimitiveProto({
 /**
 * @since 2.0.0
 */
-const TypeId$34 = "~effect/Option";
+const TypeId$35 = "~effect/Option";
 const CommonProto$1 = {
-	[TypeId$34]: { _A: (_) => _ },
+	[TypeId$35]: { _A: (_) => _ },
 	...PipeInspectableProto,
 	[Symbol.iterator]() {
 		return new SingleShotGen(this);
@@ -2802,7 +2802,7 @@ const NoneProto = /*#__PURE__*/ Object.assign(/*#__PURE__*/ Object.create(Common
 	}
 });
 /** @internal */
-const isOption = (input) => hasProperty(input, TypeId$34);
+const isOption = (input) => hasProperty(input, TypeId$35);
 /** @internal */
 const isNone$1 = (fa) => fa._tag === "None";
 /** @internal */
@@ -2818,9 +2818,9 @@ SomeImpl.prototype = SomeProto;
 const some$1 = (value) => new SomeImpl(value);
 //#endregion
 //#region ../../node_modules/.pnpm/effect@4.0.2/node_modules/effect/dist/internal/result.js
-const TypeId$33 = "~effect/Result";
+const TypeId$34 = "~effect/Result";
 const CommonProto = {
-	[TypeId$33]: {
+	[TypeId$34]: {
 		/* v8 ignore next 2 */
 		_A: (_) => _,
 		_E: (_) => _
@@ -2871,7 +2871,7 @@ const FailureProto = /*#__PURE__*/ Object.assign(/*#__PURE__*/ Object.create(Com
 	}
 });
 /** @internal */
-const isResult = (input) => hasProperty(input, TypeId$33);
+const isResult = (input) => hasProperty(input, TypeId$34);
 /** @internal */
 const isFailure$2 = (result) => result._tag === "Failure";
 /** @internal */
@@ -2941,7 +2941,7 @@ const succeed$8 = (success) => new SuccessImpl(success);
 * @category constructors
 * @since 2.0.0
 */
-function make$28(compare) {
+function make$29(compare) {
 	return (self, that) => self === that ? 0 : compare(self, that);
 }
 /**
@@ -2972,7 +2972,7 @@ function make$28(compare) {
 * @category instances
 * @since 4.0.0
 */
-const String$8 = /*#__PURE__*/ make$28((self, that) => self < that ? -1 : 1);
+const String$9 = /*#__PURE__*/ make$29((self, that) => self < that ? -1 : 1);
 /**
 * Order instance for numbers that compares them numerically.
 *
@@ -3005,7 +3005,7 @@ const String$8 = /*#__PURE__*/ make$28((self, that) => self < that ? -1 : 1);
 * @category instances
 * @since 4.0.0
 */
-const Number$6 = /*#__PURE__*/ make$28((self, that) => {
+const Number$6 = /*#__PURE__*/ make$29((self, that) => {
 	if (globalThis.Number.isNaN(self) && globalThis.Number.isNaN(that)) return 0;
 	if (globalThis.Number.isNaN(self)) return -1;
 	if (globalThis.Number.isNaN(that)) return 1;
@@ -3044,7 +3044,7 @@ const Number$6 = /*#__PURE__*/ make$28((self, that) => {
 * @category mapping
 * @since 2.0.0
 */
-const mapInput = /*#__PURE__*/ dual(2, (self, f) => make$28((b1, b2) => self(f(b1), f(b2))));
+const mapInput = /*#__PURE__*/ dual(2, (self, f) => make$29((b1, b2) => self(f(b1), f(b2))));
 /**
 * Checks whether one value is strictly greater than another according to the given order.
 *
@@ -3555,7 +3555,7 @@ const ServiceProto = {
 		return self;
 	},
 	context(self) {
-		return make$27(this, self);
+		return make$28(this, self);
 	},
 	use(f) {
 		return withFiber$1((fiber) => f(get$2(fiber.context, this)));
@@ -3566,7 +3566,7 @@ const ServiceProto = {
 };
 const cacheKeys = /*#__PURE__*/ new Set();
 const ReferenceTypeId = "~effect/Context/Reference";
-const TypeId$32 = "~effect/Context";
+const TypeId$33 = "~effect/Context";
 const MaxDepth = 8;
 const FlattenAfterBaseHits = 8;
 const makeImpl = (cacheRoot, base, overlay, depth) => {
@@ -3647,7 +3647,7 @@ const Proto$8 = {
 		return flatten(this);
 	},
 	...PipeInspectableProto,
-	[TypeId$32]: { _Services: (_) => _ },
+	[TypeId$33]: { _Services: (_) => _ },
 	toJSON() {
 		return {
 			_id: "Context",
@@ -3703,7 +3703,7 @@ const hasSameCache = (self, that) => self.cacheRoot === that.cacheRoot;
 * @category guards
 * @since 2.0.0
 */
-const isContext = (u) => hasProperty(u, TypeId$32);
+const isContext = (u) => hasProperty(u, TypeId$33);
 /**
 * Checks whether the provided argument is a `Reference`.
 *
@@ -3760,7 +3760,7 @@ const emptyContext = /*#__PURE__*/ makeUnsafe$5(/*#__PURE__*/ new Map());
 * @category constructors
 * @since 2.0.0
 */
-const make$27 = (key, service) => makeUnsafe$5(/* @__PURE__ */ new Map([[key.key, service]]));
+const make$28 = (key, service) => makeUnsafe$5(/* @__PURE__ */ new Map([[key.key, service]]));
 /**
 * Adds a service to a given `Context`.
 *
@@ -4715,7 +4715,7 @@ const dedupe = (self) => {
 };
 //#endregion
 //#region ../../node_modules/.pnpm/effect@4.0.2/node_modules/effect/dist/Duration.js
-const TypeId$31 = "~effect/Duration";
+const TypeId$32 = "~effect/Duration";
 const bigint0$3 = /*#__PURE__*/ BigInt(0);
 const bigint1$2 = /*#__PURE__*/ BigInt(1);
 const bigint2 = /*#__PURE__*/ BigInt(2);
@@ -4792,13 +4792,13 @@ const fromInputUnsafe$1 = (input) => {
 		}
 		case "object": {
 			if (input === null) break;
-			if (TypeId$31 in input) return input;
+			if (TypeId$32 in input) return input;
 			if (Array.isArray(input)) {
 				if (input.length !== 2 || !input.every(isNumber)) return invalid$2(input);
 				if (Number.isNaN(input[0]) || Number.isNaN(input[1])) return zero$1;
 				if (input[0] === -Infinity || input[1] === -Infinity) return negativeInfinity;
 				if (input[0] === Infinity || input[1] === Infinity) return infinity;
-				return make$26(roundTiesAwayFromZero(input[0] * 1e9 + input[1]));
+				return make$27(roundTiesAwayFromZero(input[0] * 1e9 + input[1]));
 			}
 			const obj = input;
 			let millis = 0;
@@ -4808,8 +4808,8 @@ const fromInputUnsafe$1 = (input) => {
 			if (obj.minutes) millis += obj.minutes * 6e4;
 			if (obj.seconds) millis += obj.seconds * 1e3;
 			if (obj.milliseconds) millis += obj.milliseconds;
-			if (!obj.microseconds && !obj.nanoseconds) return make$26(millis);
-			return make$26(roundTiesAwayFromZero(millis * 1e6 + (obj.microseconds ?? 0) * 1e3 + (obj.nanoseconds ?? 0)));
+			if (!obj.microseconds && !obj.nanoseconds) return make$27(millis);
+			return make$27(roundTiesAwayFromZero(millis * 1e6 + (obj.microseconds ?? 0) * 1e3 + (obj.nanoseconds ?? 0)));
 		}
 	}
 	return invalid$2(input);
@@ -4824,7 +4824,7 @@ const zeroDurationValue = {
 const infinityDurationValue = { _tag: "Infinity" };
 const negativeInfinityDurationValue = { _tag: "NegativeInfinity" };
 const DurationProto = {
-	[TypeId$31]: TypeId$31,
+	[TypeId$32]: TypeId$32,
 	[symbol$1]() {
 		switch (this.value._tag) {
 			case "Millis": {
@@ -4875,7 +4875,7 @@ const DurationProto = {
 		return pipeArguments(this, arguments);
 	}
 };
-const make$26 = (input) => {
+const make$27 = (input) => {
 	const duration = Object.create(DurationProto);
 	if (typeof input === "number") {
 		if (isNaN(input) || input === 0 || Object.is(input, -0)) duration.value = zeroDurationValue;
@@ -4911,7 +4911,7 @@ const make$26 = (input) => {
 * @category guards
 * @since 2.0.0
 */
-const isDuration = (u) => hasProperty(u, TypeId$31);
+const isDuration = (u) => hasProperty(u, TypeId$32);
 /**
 * Checks whether a Duration is finite (not infinite).
 *
@@ -4944,7 +4944,7 @@ const isFinite$1 = (self) => self.value._tag !== "Infinity" && self.value._tag !
 * @category constructors
 * @since 2.0.0
 */
-const zero$1 = /*#__PURE__*/ make$26(0);
+const zero$1 = /*#__PURE__*/ make$27(0);
 /**
 * A Duration representing infinite time.
 *
@@ -4960,7 +4960,7 @@ const zero$1 = /*#__PURE__*/ make$26(0);
 * @category constructors
 * @since 2.0.0
 */
-const infinity = /*#__PURE__*/ make$26(Infinity);
+const infinity = /*#__PURE__*/ make$27(Infinity);
 /**
 * A Duration representing negative infinite time.
 *
@@ -4976,7 +4976,7 @@ const infinity = /*#__PURE__*/ make$26(Infinity);
 * @category constructors
 * @since 4.0.0
 */
-const negativeInfinity = /*#__PURE__*/ make$26(-Infinity);
+const negativeInfinity = /*#__PURE__*/ make$27(-Infinity);
 /**
 * Creates a Duration from nanoseconds.
 *
@@ -4992,7 +4992,7 @@ const negativeInfinity = /*#__PURE__*/ make$26(-Infinity);
 * @category constructors
 * @since 2.0.0
 */
-const nanos = (nanos) => make$26(nanos);
+const nanos = (nanos) => make$27(nanos);
 /**
 * Creates a Duration from milliseconds.
 *
@@ -5008,7 +5008,7 @@ const nanos = (nanos) => make$26(nanos);
 * @category constructors
 * @since 2.0.0
 */
-const millis = (millis) => make$26(millis);
+const millis = (millis) => make$27(millis);
 /**
 * Creates a Duration from seconds.
 *
@@ -5024,7 +5024,7 @@ const millis = (millis) => make$26(millis);
 * @category constructors
 * @since 2.0.0
 */
-const seconds = (seconds) => make$26(seconds * 1e3);
+const seconds = (seconds) => make$27(seconds * 1e3);
 /**
 * Creates a Duration from minutes.
 *
@@ -5040,7 +5040,7 @@ const seconds = (seconds) => make$26(seconds * 1e3);
 * @category constructors
 * @since 2.0.0
 */
-const minutes = (minutes) => make$26(minutes * 6e4);
+const minutes = (minutes) => make$27(minutes * 6e4);
 /**
 * Creates a Duration from hours.
 *
@@ -5056,7 +5056,7 @@ const minutes = (minutes) => make$26(minutes * 6e4);
 * @category constructors
 * @since 2.0.0
 */
-const hours = (hours) => make$26(hours * 36e5);
+const hours = (hours) => make$27(hours * 36e5);
 /**
 * Creates a Duration from days.
 *
@@ -5072,7 +5072,7 @@ const hours = (hours) => make$26(hours * 36e5);
 * @category constructors
 * @since 2.0.0
 */
-const days = (days) => make$26(days * 864e5);
+const days = (days) => make$27(days * 864e5);
 /**
 * Creates a Duration from weeks.
 *
@@ -5088,7 +5088,7 @@ const days = (days) => make$26(days * 864e5);
 * @category constructors
 * @since 2.0.0
 */
-const weeks = (weeks) => make$26(weeks * 6048e5);
+const weeks = (weeks) => make$27(weeks * 6048e5);
 /**
 * Converts a Duration to milliseconds.
 *
@@ -5779,7 +5779,7 @@ var ParentSpan = class extends (/*#__PURE__*/ Service()(ParentSpanKey, { fiberCa
 * @category constructors
 * @since 2.0.0
 */
-const make$25 = (options) => options;
+const make$26 = (options) => options;
 /**
 * Context reference for disabling trace propagation.
 *
@@ -5884,7 +5884,7 @@ const TracerKey = "effect/Tracer";
 * @category references
 * @since 4.0.0
 */
-const nativeTracer = /*#__PURE__*/ make$25({ span: (options) => new NativeSpan(options) });
+const nativeTracer = /*#__PURE__*/ make$26({ span: (options) => new NativeSpan(options) });
 /**
 * Default in-memory `Span` implementation used by the native tracer. It
 * generates span and trace identifiers, stores attributes, events, and links,
@@ -5988,7 +5988,7 @@ const TracerSpanAnnotations = /*#__PURE__*/ Reference("effect/References/TracerS
 /** @internal */
 const TracerSpanLinks = /*#__PURE__*/ Reference("effect/References/TracerSpanLinks", { defaultValue: () => [] });
 /** @internal */
-const CurrentLogAnnotations = /*#__PURE__*/ Reference("effect/References/CurrentLogAnnotations", { defaultValue: () => ({}) });
+const CurrentLogAnnotations$1 = /*#__PURE__*/ Reference("effect/References/CurrentLogAnnotations", { defaultValue: () => ({}) });
 /** @internal */
 const CurrentLogLevel = /*#__PURE__*/ Reference("effect/References/CurrentLogLevel", {
 	fiberCached: true,
@@ -6258,7 +6258,7 @@ var FiberImpl = class {
 	interruptUnsafe(fiberId, annotations) {
 		if (this._exit) return;
 		let cause = causeInterrupt(fiberId);
-		if (this.cache.stackFrame) cause = causeAnnotate(cause, make$27(StackTraceKey, this.cache.stackFrame));
+		if (this.cache.stackFrame) cause = causeAnnotate(cause, make$28(StackTraceKey, this.cache.stackFrame));
 		if (annotations) cause = causeAnnotate(cause, annotations);
 		this._interruptedCause = this._interruptedCause ? causeCombine(this._interruptedCause, cause) : cause;
 		if (this.interruptible) {
@@ -6852,6 +6852,8 @@ const exitIsFailure = (self) => self._tag === "Failure";
 /** @internal */
 const exitFilterCause = (self) => self._tag === "Failure" ? succeed$7(self.cause) : fail$5(self);
 /** @internal */
+const exitHasInterrupts = (self) => self._tag === "Failure" && hasInterrupts(self.cause);
+/** @internal */
 const exitVoid = /*#__PURE__*/ exitSucceed(void 0);
 /** @internal */
 const exitMap = /*#__PURE__*/ dual(2, (self, f) => self._tag === "Success" ? exitSucceed(f(self.value)) : self);
@@ -7247,6 +7249,45 @@ const onExitFilter = /*#__PURE__*/ dual(3, (self, filter, f) => onExit$1(self, (
 }));
 /** @internal */
 const onError$1 = /*#__PURE__*/ dual(2, (self, f) => onExitFilter(self, exitFilterCause, f));
+const infiniteTTL = /*#__PURE__*/ constant(Infinity);
+const makeCachedUnsafe = (self, ttlMillis) => {
+	let expiresAt = 0;
+	let exit;
+	let current;
+	const join = (fiber, run) => {
+		run.awaiters++;
+		onExitUnsafe(fiber, () => {
+			if (--run.awaiters > 0 || current !== run) return;
+			current = void 0;
+			return fiberInterrupt(run.fiber);
+		});
+		return fiberJoin(run.fiber);
+	};
+	return [withFiber$1((fiber) => {
+		if (current !== void 0) return join(fiber, current);
+		if (exit !== void 0 && (expiresAt === Infinity || fiber.getRef(ClockRef).currentTimeMillisUnsafe() < expiresAt)) return exit;
+		exit = void 0;
+		const clock = fiber.getRef(ClockRef);
+		const run = {
+			fiber: void 0,
+			awaiters: 0
+		};
+		current = run;
+		run.fiber = forkUnsafe$1(fiber, onExitPrimitive$1(self, (exit_) => {
+			if (current !== run) return;
+			current = void 0;
+			if (exitHasInterrupts(exit_)) return;
+			const duration = ttlMillis(exit_);
+			expiresAt = duration === Infinity ? Infinity : clock.currentTimeMillisUnsafe() + duration;
+			exit = exit_;
+		}), true, true);
+		return run.fiber._exit ?? join(fiber, run);
+	}), sync$1(() => {
+		exit = void 0;
+	})];
+};
+/** @internal */
+const cached$1 = (self) => sync$1(() => makeCachedUnsafe(self, infiniteTTL)[0]);
 /** @internal */
 const interrupt$2 = /*#__PURE__*/ withFiber$1((fiber) => failCause$3(causeInterrupt(fiber.id)));
 /** @internal */
@@ -7503,6 +7544,8 @@ const forkUnsafe$1 = (parent, effect, immediate = false, daemon = false, uninter
 	return child;
 };
 /** @internal */
+const forkDetach = /*#__PURE__*/ dual((args) => isEffect$1(args[0]), (self, options) => withFiber$1((fiber) => succeed$6(forkUnsafe$1(fiber, self, options?.startImmediately, true, options?.uninterruptible))));
+/** @internal */
 const forkIn$1 = /*#__PURE__*/ dual((args) => isEffect$1(args[0]), (self, scope, options) => withFiber$1((parent) => {
 	const fiber = forkUnsafe$1(parent, self, options?.startImmediately, true, options?.uninterruptible);
 	if (!fiber._exit) {
@@ -7816,7 +7859,7 @@ const logLevelToOrder = (level) => {
 /** @internal */
 const isLogLevelGreaterThan = /*#__PURE__*/ isGreaterThan$1(/* @__PURE__ */ mapInput(Number$6, logLevelToOrder));
 /** @internal */
-const CurrentLoggers = /*#__PURE__*/ Reference("effect/Logger/CurrentLoggers", { defaultValue: () => /* @__PURE__ */ new Set([defaultLogger, tracerLogger]) });
+const CurrentLoggers$1 = /*#__PURE__*/ Reference("effect/Logger/CurrentLoggers", { defaultValue: () => /* @__PURE__ */ new Set([defaultLogger, tracerLogger]) });
 /** @internal */
 const LogToStderr = /*#__PURE__*/ Reference("effect/Logger/LogToStderr", { defaultValue: constFalse });
 const LoggerProto = {
@@ -7866,7 +7909,7 @@ const logWithLevel = (level) => (...message) => {
 		const logLevel = level ?? fiber.cache.logLevel;
 		if (isLogLevelGreaterThan(fiber.cache.minimumLogLevel, logLevel)) return void_$2;
 		const clock = fiber.getRef(ClockRef);
-		const loggers = fiber.getRef(CurrentLoggers);
+		const loggers = fiber.getRef(CurrentLoggers$1);
 		if (loggers.size > 0) {
 			const date = new Date(clock.currentTimeMillisUnsafe());
 			for (const logger of loggers) logger.log({
@@ -7902,7 +7945,7 @@ const defaultLogger = /*#__PURE__*/ loggerMake(({ cause, date, fiber, logLevel,
 	const spans = fiber.getRef(CurrentLogSpans);
 	let spanString = "";
 	for (const span of spans) spanString += ` ${formatLogSpan(span, now)}`;
-	const annotations = fiber.getRef(CurrentLogAnnotations);
+	const annotations = fiber.getRef(CurrentLogAnnotations$1);
 	if (Object.keys(annotations).length > 0) message_.push(annotations);
 	const console = fiber.getRef(ConsoleRef);
 	(fiber.getRef(LogToStderr) ? console.error : console.log)(`[${defaultDateFormat(date)}] ${logLevel.toUpperCase()} (#${fiber.id})${spanString}:`, ...message_);
@@ -7910,7 +7953,7 @@ const defaultLogger = /*#__PURE__*/ loggerMake(({ cause, date, fiber, logLevel,
 /** @internal */
 const tracerLogger = /*#__PURE__*/ loggerMake(({ cause, fiber, logLevel, message }) => {
 	const clock = fiber.getRef(ClockRef);
-	const annotations = fiber.getRef(CurrentLogAnnotations);
+	const annotations = fiber.getRef(CurrentLogAnnotations$1);
 	const span = fiber.cache.span;
 	if (span === void 0 || span._tag === "ExternalSpan") return;
 	const attributes = {};
@@ -8135,6 +8178,51 @@ const map$6 = causeMap;
 */
 const squash = causeSquash;
 /**
+* Formats a `Cause` as a human-readable string for logging or debugging.
+*
+* **When to use**
+*
+* Use to render a whole cause as one human-readable string for logs or
+* diagnostics.
+*
+* **Details**
+*
+* Delegates to {@link prettyErrors} to convert each reason to an `Error`,
+* then joins their stack traces with newlines. Nested `Error.cause` chains
+* are rendered inline with indentation:
+*
+* ```text
+* ErrorName: message
+*     at ...
+*     at ... {
+*   [cause]: NestedError: message
+*       at ...
+* }
+* ```
+*
+* Span annotations are appended to the relevant stack frames when available.
+*
+* **Gotchas**
+*
+* Rendering an empty cause produces an empty string because there are no
+* errors to render.
+*
+* **Example** (Rendering a cause)
+*
+* ```ts import.meta.vitest
+* import { Cause } from "effect"
+*
+* Cause.pretty(Cause.fail("something went wrong")).includes("something went wrong") // => true
+* ```
+*
+* @see {@link prettyErrors} — get the individual `Error` instances
+*
+* @stability stable
+* @category formatting
+* @since 2.0.0
+*/
+const pretty = causePretty;
+/**
 * Checks whether an arbitrary value is a `Done` signal.
 *
 * **Example** (Checking the runtime type)
@@ -8504,6 +8592,66 @@ const doneUnsafe = (self, effect) => {
 //#endregion
 //#region ../../node_modules/.pnpm/effect@4.0.2/node_modules/effect/dist/References.js
 /**
+* Context reference for managing log annotations that are automatically added to all log entries.
+* These annotations provide contextual metadata that appears in every log message.
+*
+* **When to use**
+*
+* Use to attach shared contextual metadata to every log entry emitted in the
+* current context.
+*
+* **Example** (Managing log annotations)
+*
+* ```ts import.meta.vitest
+* import { Effect, References } from "effect"
+*
+* const logAnnotationExample = Effect.gen(function*() {
+*   // Get current annotations (empty by default)
+*   const current = yield* References.CurrentLogAnnotations
+*   const defaultCount = Object.keys(current).length
+*
+*   // Run with custom log annotations
+*   const custom = yield* Effect.provideService(
+*     Effect.gen(function*() {
+*       const annotations = yield* References.CurrentLogAnnotations
+*       return [annotations.requestId, annotations.userId, annotations.version]
+*     }),
+*     References.CurrentLogAnnotations,
+*     {
+*       requestId: "req-123",
+*       userId: "user-456",
+*       version: "1.0.0"
+*     }
+*   )
+*
+*   // Run with extended annotations
+*   const extended = yield* Effect.provideService(
+*     Effect.gen(function*() {
+*       const annotations = yield* References.CurrentLogAnnotations
+*       return [annotations.operation, annotations.timestamp]
+*     }),
+*     References.CurrentLogAnnotations,
+*     {
+*       requestId: "req-123",
+*       userId: "user-456",
+*       version: "1.0.0",
+*       operation: "data-sync",
+*       timestamp: 1234567890
+*     }
+*   )
+*
+*   return [defaultCount, custom, extended]
+* })
+*
+* await Effect.runPromise(logAnnotationExample) // => [0, ["req-123", "user-456", "1.0.0"], ["data-sync", 1234567890]]
+* ```
+*
+* @stability stable
+* @category references
+* @since 4.0.0
+*/
+const CurrentLogAnnotations = CurrentLogAnnotations$1;
+/**
 * Context reference for setting the minimum log level threshold. Log entries below this
 * level will be filtered out completely.
 *
@@ -8797,7 +8945,7 @@ const forkUnsafe = scopeForkUnsafe;
 const close = scopeClose;
 //#endregion
 //#region ../../node_modules/.pnpm/effect@4.0.2/node_modules/effect/dist/Layer.js
-const TypeId$29 = "~effect/Layer";
+const TypeId$30 = "~effect/Layer";
 const MemoMapTypeId = "~effect/Layer/MemoMap";
 const makeMemoMapEntry = (memoMap, layer) => {
 	const entry = {
@@ -8819,7 +8967,7 @@ const memoMapObserve = (entry, scope) => {
 	return true;
 };
 const LayerProto = {
-	[TypeId$29]: {
+	[TypeId$30]: {
 		_ROut: identity,
 		_E: identity,
 		_RIn: identity
@@ -9163,8 +9311,8 @@ const buildWithScope = /*#__PURE__*/ dual(2, (self, scope) => withFiber$1((fiber
 * @since 2.0.0
 */
 const succeed$4 = function() {
-	if (arguments.length === 1) return (resource) => succeedContext(make$27(arguments[0], resource));
-	return succeedContext(make$27(arguments[0], arguments[1]));
+	if (arguments.length === 1) return (resource) => succeedContext(make$28(arguments[0], resource));
+	return succeedContext(make$28(arguments[0], arguments[1]));
 };
 /**
 * Constructs a layer that provides all services in an already available
@@ -9258,7 +9406,7 @@ const effect = function() {
 	if (arguments.length === 1) return (effect) => effectImpl(arguments[0], effect);
 	return effectImpl(arguments[0], arguments[1]);
 };
-const effectImpl = (service, effect) => effectContext(map$7(effect, (value) => make$27(service, value)));
+const effectImpl = (service, effect) => effectContext(map$7(effect, (value) => make$28(service, value)));
 /**
 * Constructs a layer from an effect that produces all services in a `Context`.
 *
@@ -9487,11 +9635,11 @@ const currentTimeMillis = currentTimeMillis$1;
 //#endregion
 //#region ../../node_modules/.pnpm/effect@4.0.2/node_modules/effect/dist/internal/dateTime.js
 /** @internal */
-const TypeId$28 = "~effect/DateTime";
+const TypeId$29 = "~effect/DateTime";
 /** @internal */
 const TimeZoneTypeId = "~effect/DateTime/TimeZone";
 const Proto$7 = {
-	[TypeId$28]: TypeId$28,
+	[TypeId$29]: TypeId$29,
 	pipe() {
 		return pipeArguments(this, arguments);
 	},
@@ -9525,7 +9673,7 @@ const ProtoTimeZone = {
 ({ ...ProtoTimeZone });
 ({ ...ProtoTimeZone });
 /** @internal */
-const isDateTime$1 = (u) => hasProperty(u, TypeId$28);
+const isDateTime$1 = (u) => hasProperty(u, TypeId$29);
 const isDateTimeArgs = (args) => isDateTime$1(args[0]);
 const makeUtc = (epochMillis) => {
 	const self = Object.create(ProtoUtc);
@@ -9800,7 +9948,7 @@ const matchEffect$1 = /*#__PURE__*/ dual(2, (self, options) => matchCauseEffect$
 }));
 //#endregion
 //#region ../../node_modules/.pnpm/effect@4.0.2/node_modules/effect/dist/Schedule.js
-const TypeId$27 = "~effect/Schedule";
+const TypeId$28 = "~effect/Schedule";
 /**
 * Context reference containing metadata for the currently running schedule step.
 *
@@ -9826,7 +9974,7 @@ const CurrentMetadata = /*#__PURE__*/ Reference("effect/Schedule/CurrentMetadata
 	elapsedSincePrevious: 0
 }) });
 const ScheduleProto = {
-	[TypeId$27]: {
+	[TypeId$28]: {
 		_Out: identity,
 		_In: identity,
 		_Env: identity
@@ -9856,7 +10004,7 @@ const ScheduleProto = {
 * @category guards
 * @since 2.0.0
 */
-const isSchedule = (u) => hasProperty(u, TypeId$27);
+const isSchedule = (u) => hasProperty(u, TypeId$28);
 /**
 * Creates a Schedule from a step function that returns a Pull.
 *
@@ -12482,6 +12630,63 @@ const onExitPrimitive = onExitPrimitive$1;
 */
 const onExit = onExit$1;
 /**
+* Returns an effect that lazily computes a result and caches it for subsequent
+* evaluations.
+*
+* **When to use**
+*
+* Use when you need an expensive or time-consuming operation to be evaluated
+* once and reused by later callers.
+*
+* **Details**
+*
+* This function wraps an effect and ensures that its result is computed only
+* once. Once the result is computed, it is cached, meaning that subsequent
+* evaluations of the same effect will return the cached result without
+* re-executing the logic.
+*
+* Concurrent callers share the pending computation, which is interrupted only
+* once every caller waiting on it has been interrupted. Interrupted
+* computations are never cached, so the next evaluation starts a fresh
+* computation.
+*
+* **Example** (Memoizing an effect until invalidated)
+*
+* ```ts import.meta.vitest
+* import { Effect } from "effect"
+* const output: Array<unknown> = []
+* const record = (value: unknown) => Effect.sync(() => { output.push(value) })
+*
+* let i = 1
+* const expensiveTask = Effect.sync(() => {
+*   void output.push("expensive task...")
+*   return `result ${i++}`
+* })
+*
+* const program = Effect.gen(function*() {
+*   void output.push("non-cached version:")
+*   yield* expensiveTask.pipe(Effect.andThen(record))
+*   yield* expensiveTask.pipe(Effect.andThen(record))
+*   void output.push("cached version:")
+*   const cached = yield* Effect.cached(expensiveTask)
+*   yield* cached.pipe(Effect.andThen(record))
+*   yield* cached.pipe(Effect.andThen(record))
+* })
+*
+* await Effect.runPromise(program)
+* output // => ["non-cached version:", "expensive task...", "result 1", "expensive task...", "result 2", "cached version:", "expensive task...", "result 3", "result 3"]
+* ```
+*
+* @see {@link cachedWithTTL} for a similar function that includes a
+* time-to-live duration for the cached value.
+* @see {@link cachedInvalidateWithTTL} for a similar function that includes an
+* additional effect for manually invalidating the cached value.
+* @stability stable
+* @category caching
+* @since 2.0.0
+*/
+const cached = cached$1;
+/**
 * Returns an effect that is immediately interrupted.
 *
 * **Example** (Creating an interrupted effect)
@@ -13078,6 +13283,31 @@ const fn = fn$1;
 */
 const clockWith = clockWith$1;
 /**
+* Logs one or more messages at the WARNING level.
+*
+* **Example** (Logging warnings)
+*
+* ```ts import.meta.vitest
+* import { Effect, Logger } from "effect"
+* const output: Array<unknown> = []
+*
+* const program = Effect.gen(function*() {
+*   yield* Effect.logWarning("API rate limit approaching")
+* })
+*
+* const logger = Logger.make<unknown, void>(({ logLevel, message }) => {
+*   void output.push(`${logLevel}: ${Array.isArray(message) ? message.map(String).join(" ") : String(message)}`)
+* })
+* Effect.runSync(Effect.provide(program, Logger.layer([logger])))
+* output // => ["Warn: API rate limit approaching"]
+* ```
+*
+* @stability stable
+* @category logging
+* @since 2.0.0
+*/
+const logWarning = /*#__PURE__*/ logWithLevel("Warn");
+/**
 * Logs one or more messages at the ERROR level.
 *
 * **Example** (Logging errors)
@@ -13103,6 +13333,105 @@ const clockWith = clockWith$1;
 */
 const logError = /*#__PURE__*/ logWithLevel("Error");
 /**
+* Logs one or more messages at the INFO level.
+*
+* **Example** (Logging information)
+*
+* ```ts import.meta.vitest
+* import { Effect, Logger } from "effect"
+* const output: Array<unknown> = []
+*
+* const program = Effect.gen(function*() {
+*   yield* Effect.logInfo("Application starting up")
+* })
+*
+* const logger = Logger.make<unknown, void>(({ logLevel, message }) => {
+*   void output.push(`${logLevel}: ${Array.isArray(message) ? message.map(String).join(" ") : String(message)}`)
+* })
+* Effect.runSync(Effect.provide(program, Logger.layer([logger])))
+* output // => ["Info: Application starting up"]
+* ```
+*
+* @stability stable
+* @category logging
+* @since 2.0.0
+*/
+const logInfo = /*#__PURE__*/ logWithLevel("Info");
+/**
+* Logs one or more messages at the DEBUG level.
+*
+* **Example** (Logging debug messages)
+*
+* ```ts import.meta.vitest
+* import { Effect, Logger, References } from "effect"
+* const output: Array<unknown> = []
+*
+* const program = Effect.gen(function*() {
+*   yield* Effect.logDebug("Debug mode enabled")
+* })
+*
+* const logger = Logger.make<unknown, void>(({ logLevel, message }) => {
+*   void output.push(`${logLevel}: ${Array.isArray(message) ? message.map(String).join(" ") : String(message)}`)
+* })
+* const runnable = program.pipe(
+*   Effect.provideService(References.MinimumLogLevel, "Debug"),
+*   Effect.provide(Logger.layer([logger]))
+* )
+* Effect.runSync(runnable)
+* output // => ["Debug: Debug mode enabled"]
+* ```
+*
+* @stability stable
+* @category logging
+* @since 2.0.0
+*/
+const logDebug = /*#__PURE__*/ logWithLevel("Debug");
+/**
+* Adds an annotation to each log line in this effect.
+*
+* **Example** (Adding log annotations)
+*
+* ```ts import.meta.vitest
+* import { Effect, Logger } from "effect"
+* const output: Array<unknown> = []
+*
+* const program = Effect.gen(function*() {
+*   yield* Effect.log("Starting operation")
+* })
+*
+* // Add annotations to all log messages
+* const annotatedProgram = Effect.annotateLogs(program, {
+*   userId: "user123",
+*   operation: "data-processing"
+* })
+*
+* // Also supports single key-value annotations
+* const singleAnnotated = Effect.annotateLogs(program, "requestId", "req-456")
+*
+* const logger = Logger.make<unknown, void>(({ message }) =>
+*   void output.push(Array.isArray(message) ? message.join(" ") : String(message))
+* )
+* const run = (effect: Effect.Effect<void>) =>
+*   Effect.runSync(Effect.provide(effect, Logger.layer([logger])))
+* run(annotatedProgram)
+* run(singleAnnotated)
+* output // => ["Starting operation", "Starting operation"]
+* ```
+*
+* @stability stable
+* @category logging
+* @since 2.0.0
+*/
+const annotateLogs = /*#__PURE__*/ dual((args) => isEffect(args[0]), (effect, ...args) => updateService(effect, CurrentLogAnnotations, (annotations) => {
+	const newAnnotations = args.length === 1 ? {
+		...annotations,
+		...args[0]
+	} : { ...annotations };
+	if (args.length === 1) return newAnnotations;
+	else assignProperty(newAnnotations, args[0], args[1]);
+	return newAnnotations;
+}));
+/**
 * Converts an error-first callback API into a function that returns an
 * `Effect`.
 *
@@ -13859,13 +14188,13 @@ const binaryUnits = [
 ];
 const allUnits = [...decimalUnits, .../*#__PURE__*/ binaryUnits.slice(1)];
 const unitsByName = /*#__PURE__*/ new Map(/*#__PURE__*/ allUnits.flatMap((unit) => unit.names.map((name) => [name, unit])));
-const make$23 = (value) => value;
+const make$24 = (value) => value;
 const invalid$1 = (message) => {
 	throw new Error(`Invalid ByteSize: ${message}`);
 };
 const fromNumber = (input) => {
 	if (!Number.isSafeInteger(input) || input < 0) return invalid$1(`expected a non-negative safe integer, received ${input}`);
-	return make$23(BigInt(input));
+	return make$24(BigInt(input));
 };
 /**
 * Parses a byte-size string and throws for invalid syntax, unsupported units,
@@ -13891,7 +14220,7 @@ const fromStringUnsafe = (input) => {
 	const scale = BigInt(10) ** BigInt(fraction.length);
 	const numerator = BigInt(match[1] + fraction) * unit.factor;
 	if (numerator % scale !== bigint0$1) return invalid$1(`${JSON.stringify(input)} does not represent an integral number of bytes`);
-	return make$23(numerator / scale);
+	return make$24(numerator / scale);
 };
 /**
 * Decodes a trusted input into a byte size and throws for invalid input.
@@ -13904,7 +14233,7 @@ const fromInputUnsafe = (input) => {
 	switch (typeof input) {
 		case "bigint":
 			if (input < bigint0$1) return invalid$1(`expected a non-negative bigint, received ${input}`);
-			return make$23(input);
+			return make$24(input);
 		case "number": return fromNumber(input);
 		case "string": return fromStringUnsafe(input);
 	}
@@ -13932,7 +14261,7 @@ const bytes = (value) => typeof value === "bigint" ? fromInputUnsafe(value) : fr
 * @stability unstable
 * @since 4.0.0
 */
-const TypeId$26 = "~effect/PlatformError";
+const TypeId$27 = "~effect/PlatformError";
 /**
 * Error data for an invalid argument passed to a platform API.
 *
@@ -14045,7 +14374,7 @@ var PlatformError = class extends (/*#__PURE__*/ TaggedError$1("PlatformError"))
 	*
 	* @since 4.0.0
 	*/
-	[TypeId$26] = TypeId$26;
+	[TypeId$27] = TypeId$27;
 	get message() {
 		return this.reason.message;
 	}
@@ -14251,9 +14580,9 @@ const runIn = fiberRunIn;
 const makeUnsafe$1 = makeLatchUnsafe;
 //#endregion
 //#region ../../node_modules/.pnpm/effect@4.0.2/node_modules/effect/dist/MutableRef.js
-const TypeId$25 = "~effect/MutableRef";
+const TypeId$26 = "~effect/MutableRef";
 const MutableRefProto = {
-	[TypeId$25]: TypeId$25,
+	[TypeId$26]: TypeId$26,
 	...PipeInspectableProto,
 	toJSON() {
 		return {
@@ -14295,7 +14624,7 @@ const MutableRefProto = {
 * @category constructors
 * @since 2.0.0
 */
-const make$22 = (value) => {
+const make$23 = (value) => {
 	const ref = Object.create(MutableRefProto);
 	ref.current = value;
 	return ref;
@@ -14346,7 +14675,7 @@ const Empty = /*#__PURE__*/ Symbol.for("effect/MutableList/Empty");
 * @category constructors
 * @since 2.0.0
 */
-const make$21 = () => ({
+const make$22 = () => ({
 	head: void 0,
 	tail: void 0,
 	length: 0
@@ -14517,7 +14846,7 @@ const take$1 = (self) => {
 };
 //#endregion
 //#region ../../node_modules/.pnpm/effect@4.0.2/node_modules/effect/dist/Queue.js
-const TypeId$24 = "~effect/Queue";
+const TypeId$25 = "~effect/Queue";
 const EnqueueTypeId = "~effect/Queue/Enqueue";
 const DequeueTypeId = "~effect/Queue/Dequeue";
 const variance$1 = {
@@ -14525,7 +14854,7 @@ const variance$1 = {
 	_E: identity
 };
 const QueueProto = {
-	[TypeId$24]: variance$1,
+	[TypeId$25]: variance$1,
 	[EnqueueTypeId]: variance$1,
 	[DequeueTypeId]: variance$1,
 	...PipeInspectableProto,
@@ -14580,12 +14909,12 @@ const QueueProto = {
 * @category constructors
 * @since 4.0.0
 */
-const make$20 = (options) => withFiber$1((fiber) => {
+const make$21 = (options) => withFiber$1((fiber) => {
 	const self = Object.create(QueueProto);
 	self.dispatcher = fiber.currentDispatcher;
 	self.capacity = options?.capacity ?? Number.POSITIVE_INFINITY;
 	self.strategy = options?.strategy ?? "suspend";
-	self.messages = make$21();
+	self.messages = make$22();
 	self.scheduleRunning = false;
 	self.state = {
 		_tag: "Open",
@@ -14626,7 +14955,7 @@ const make$20 = (options) => withFiber$1((fiber) => {
 * @category constructors
 * @since 2.0.0
 */
-const bounded = (capacity) => make$20({ capacity });
+const bounded = (capacity) => make$21({ capacity });
 /**
 * Adds a message to the queue. Returns `false` if the queue is done.
 *
@@ -15333,7 +15662,7 @@ const finalize = (self, exit) => {
 * @category type IDs
 * @since 4.0.0
 */
-const TypeId$23 = "~effect/Channel";
+const TypeId$24 = "~effect/Channel";
 /**
 * Checks whether a value is a `Channel`.
 *
@@ -15351,9 +15680,9 @@ const TypeId$23 = "~effect/Channel";
 * @category guards
 * @since 3.5.4
 */
-const isChannel = (u) => hasProperty(u, TypeId$23);
+const isChannel = (u) => hasProperty(u, TypeId$24);
 const ChannelProto = {
-	[TypeId$23]: {
+	[TypeId$24]: {
 		_Env: identity,
 		_InErr: identity,
 		_InElem: identity,
@@ -15478,7 +15807,7 @@ const fromTransformBracket = (f) => fromTransform$1(fnUntraced(function* (upstre
 * @since 4.0.0
 */
 const toTransform = (channel) => channel.transform;
-const asyncQueue = (scope, f, options) => make$20({
+const asyncQueue = (scope, f, options) => make$21({
 	capacity: options?.bufferSize,
 	strategy: options?.strategy
 }).pipe(tap((queue) => addFinalizer$1(scope, shutdown(queue))), tap((queue) => provide$2(f(queue), scope).pipe(catchCause((cause) => failCause(queue, cause)), forkIn(scope))));
@@ -15994,7 +16323,7 @@ const runFold = /*#__PURE__*/ dual(3, (self, initial, f) => suspend$2(() => {
 const toPullScoped = (self, scope) => toTransform(self)(done(), scope);
 //#endregion
 //#region ../../node_modules/.pnpm/effect@4.0.2/node_modules/effect/dist/internal/stream.js
-const TypeId$22 = "~effect/Stream";
+const TypeId$23 = "~effect/Stream";
 const streamVariance = {
 	_R: identity,
 	_E: identity,
@@ -16004,7 +16333,7 @@ const Stream$1 = function(channel) {
 	this.channel = channel;
 };
 Stream$1.prototype = {
-	[TypeId$22]: streamVariance,
+	[TypeId$23]: streamVariance,
 	pipe() {
 		return pipeArguments(this, arguments);
 	}
@@ -16013,7 +16342,7 @@ Stream$1.prototype = {
 const fromChannel$2 = (channel) => new Stream$1(channel);
 //#endregion
 //#region ../../node_modules/.pnpm/effect@4.0.2/node_modules/effect/dist/Sink.js
-const TypeId$21 = "~effect/Sink";
+const TypeId$22 = "~effect/Sink";
 const endVoid = /*#__PURE__*/ succeed$3([void 0]);
 const sinkVariance = {
 	_A: identity,
@@ -16023,7 +16352,7 @@ const sinkVariance = {
 	_R: identity
 };
 const SinkProto = {
-	[TypeId$21]: sinkVariance,
+	[TypeId$22]: sinkVariance,
 	pipe() {
 		return pipeArguments(this, arguments);
 	}
@@ -16047,7 +16376,7 @@ const SinkProto = {
 * @category guards
 * @since 4.0.0
 */
-const isSink = (u) => hasProperty(u, TypeId$21);
+const isSink = (u) => hasProperty(u, TypeId$22);
 /**
 * Creates a sink from a `Channel`.
 *
@@ -16204,7 +16533,7 @@ const forEachArray = (f) => fromTransform((upstream) => upstream.pipe(flatMap$1(
 const unwrap$1 = (effect) => fromChannel$1(unwrap$2(map$5(effect, toChannel$1)));
 //#endregion
 //#region ../../node_modules/.pnpm/effect@4.0.2/node_modules/effect/dist/internal/rcRef.js
-const TypeId$20 = "~effect/RcRef";
+const TypeId$21 = "~effect/RcRef";
 const stateEmpty = { _tag: "Empty" };
 const stateClosed = { _tag: "Closed" };
 const variance = {
@@ -16212,7 +16541,7 @@ const variance = {
 	_E: identity
 };
 var RcRefImpl = class {
-	[TypeId$20] = variance;
+	[TypeId$21] = variance;
 	pipe() {
 		return pipeArguments(this, arguments);
 	}
@@ -16229,7 +16558,7 @@ var RcRefImpl = class {
 	}
 };
 /** @internal */
-const make$19 = (options) => withFiber((fiber) => {
+const make$20 = (options) => withFiber((fiber) => {
 	const context = fiber.context;
 	const scope = get$2(context, Scope);
 	const ref = new RcRefImpl(options.acquire, context, scope, options.idleTimeToLive !== void 0 ? fromInputUnsafe$1(options.idleTimeToLive) : void 0);
@@ -16366,7 +16695,7 @@ const release = (self, state) => {
 * @category constructors
 * @since 3.5.0
 */
-const make$18 = make$19;
+const make$19 = make$20;
 /**
 * Gets the value from an `RcRef`, acquiring it first if needed.
 *
@@ -16443,7 +16772,7 @@ const get = get$1;
 * @category type IDs
 * @since 4.0.0
 */
-const TypeId$19 = "~effect/Stream";
+const TypeId$20 = "~effect/Stream";
 /**
 * Checks whether a value is a Stream.
 *
@@ -16460,7 +16789,7 @@ const TypeId$19 = "~effect/Stream";
 * @category guards
 * @since 4.0.0
 */
-const isStream = (u) => hasProperty(u, TypeId$19);
+const isStream = (u) => hasProperty(u, TypeId$20);
 /**
 * Creates a stream from a array-emitting `Channel`.
 *
@@ -16616,7 +16945,7 @@ const empty = /*#__PURE__*/ fromChannel(empty$1);
 * @category constructors
 * @since 2.0.0
 */
-const make$17 = (...values) => fromArray(values);
+const make$18 = (...values) => fromArray(values);
 /**
 * Creates a lazily constructed stream.
 *
@@ -16994,7 +17323,7 @@ const mkString = (self) => runFold(self.channel, () => "", (acc, chunk) => acc +
 * @stability unstable
 * @since 4.0.0
 */
-const TypeId$18 = "~effect/FileSystem";
+const TypeId$19 = "~effect/FileSystem";
 /**
 * Service tag for platform file-system operations.
 *
@@ -17060,9 +17389,9 @@ const FileSystem = /*#__PURE__*/ Service("effect/FileSystem");
 * @category constructors
 * @since 4.0.0
 */
-const make$16 = (impl) => FileSystem.of({
+const make$17 = (impl) => FileSystem.of({
 	...impl,
-	[TypeId$18]: TypeId$18,
+	[TypeId$19]: TypeId$19,
 	exists: (path) => pipe$1(impl.access(path), as(true), catchTag("PlatformError", (e) => e.reason._tag === "NotFound" ? succeed$3(false) : fail$1(e))),
 	readFileString: (path, encoding) => flatMap$1(impl.readFile(path), (_) => try_({
 		try: () => new TextDecoder(encoding).decode(_),
@@ -17194,7 +17523,7 @@ var WatchBackend = class extends (/*#__PURE__*/ Service()("effect/FileSystem/Wat
 * @category type IDs
 * @since 4.0.0
 */
-const TypeId$17 = "~effect/Path";
+const TypeId$18 = "~effect/Path";
 /**
 * Service tag for accessing the current `Path` implementation.
 *
@@ -17347,7 +17676,7 @@ const fromOptionExit = (option) => option._tag === "None" ? missingExit : succee
 * @stability stable
 * @since 4.0.0
 */
-const TypeId$16 = "~effect/SchemaIssue/Issue";
+const TypeId$17 = "~effect/SchemaIssue/Issue";
 /**
 * Returns `true` if the given value is an {@link Issue}.
 *
@@ -17378,7 +17707,7 @@ const TypeId$16 = "~effect/SchemaIssue/Issue";
 * @since 4.0.0
 */
 function isIssue(u) {
-	return hasProperty(u, TypeId$16) && u[TypeId$16] === TypeId$16;
+	return hasProperty(u, TypeId$17) && u[TypeId$17] === TypeId$17;
 }
 /**
 * Returns `true` when an issue contains an input reported by the schema parser.
@@ -17414,7 +17743,7 @@ function hasInput(issue) {
 	return Object.hasOwn(issue, "input");
 }
 var IssueNodeImpl = class {
-	[TypeId$16] = TypeId$16;
+	[TypeId$17] = TypeId$17;
 	constructor(input, options) {
 		if (options?.reportInput === true && input !== missing) this.input = input;
 	}
@@ -18076,7 +18405,7 @@ function transformEffect$1(f) {
 * @category converting
 * @since 4.0.0
 */
-function String$7() {
+function String$8() {
 	return transform$2(globalThis.String);
 }
 /**
@@ -18170,9 +18499,9 @@ function stringifyJson(options) {
 * @stability stable
 * @since 2.0.0
 */
-const TypeId$15 = "~effect/BigDecimal";
+const TypeId$16 = "~effect/BigDecimal";
 const BigDecimalProto = {
-	[TypeId$15]: TypeId$15,
+	[TypeId$16]: TypeId$16,
 	[symbol$1]() {
 		const normalized = normalize(this);
 		return combine$1(string$1(String(normalized.value)), number$1(normalized.scale));
@@ -18220,7 +18549,7 @@ const BigDecimalProto = {
 * @category guards
 * @since 2.0.0
 */
-const isBigDecimal = (u) => hasProperty(u, TypeId$15);
+const isBigDecimal = (u) => hasProperty(u, TypeId$16);
 /**
 * Creates a `BigDecimal` from a `bigint` value and a safe integer scale.
 *
@@ -18253,7 +18582,7 @@ const isBigDecimal = (u) => hasProperty(u, TypeId$15);
 * @category constructors
 * @since 2.0.0
 */
-const make$14 = (value, scale) => {
+const make$15 = (value, scale) => {
 	if (!Number.isSafeInteger(scale)) throw new RangeError(`Scale must be a safe integer, got ${scale}`);
 	const o = Object.create(BigDecimalProto);
 	o.value = value;
@@ -18261,7 +18590,7 @@ const make$14 = (value, scale) => {
 	return o;
 };
 const makeNormalized = (value, scale) => {
-	const o = make$14(value, scale);
+	const o = make$15(value, scale);
 	o.normalized = o;
 	return o;
 };
@@ -18316,7 +18645,7 @@ const compareMagnitude = (self, that) => {
 	const exponentDifference = BigInt(selfDigits.length - thatDigits.length) - BigInt(self.scale) + BigInt(that.scale);
 	if (exponentDifference !== bigint0) return exponentDifference < bigint0 ? -1 : 1;
 	const length = Math.max(selfDigits.length, thatDigits.length);
-	return String$8(selfDigits.padEnd(length, "0"), thatDigits.padEnd(length, "0"));
+	return String$9(selfDigits.padEnd(length, "0"), thatDigits.padEnd(length, "0"));
 };
 const compare = (self, that) => {
 	if (self.scale === that.scale) return compareBigInt(self.value, that.value);
@@ -18465,7 +18794,7 @@ const Middleware = class extends Class$1 {
 		return new Middleware(this.encode, this.decode);
 	}
 };
-const TypeId$14 = "~effect/SchemaTransformation/Transformation";
+const TypeId$15 = "~effect/SchemaTransformation/Transformation";
 /**
 * Constructs a bidirectional schema transformation from its decode and encode getters.
 *
@@ -18474,7 +18803,7 @@ const TypeId$14 = "~effect/SchemaTransformation/Transformation";
 * @since 4.0.0
 */
 const Transformation = class extends Class$1 {
-	[TypeId$14] = TypeId$14;
+	[TypeId$15] = TypeId$15;
 	_tag = "Transformation";
 	decode;
 	encode;
@@ -18517,7 +18846,7 @@ const Transformation = class extends Class$1 {
 * @since 4.0.0
 */
 function isTransformation(u) {
-	return hasProperty(u, TypeId$14) && u[TypeId$14] === TypeId$14;
+	return hasProperty(u, TypeId$15) && u[TypeId$15] === TypeId$15;
 }
 /**
 * Constructs a `Transformation` from an object with `decode` and `encode`
@@ -18638,7 +18967,7 @@ function passthrough() {
 * @category converting
 * @since 4.0.0
 */
-const numberFromString = /*#__PURE__*/ new Transformation(/*#__PURE__*/ Number$4(), /*#__PURE__*/ String$7());
+const numberFromString = /*#__PURE__*/ new Transformation(/*#__PURE__*/ Number$4(), /*#__PURE__*/ String$8());
 const isJsonError = (input) => isObject(input) && typeof input["message"] === "string";
 const decodeJsonError = (input) => {
 	const err = Object.hasOwn(input, "cause") ? new Error(input.message, { cause: decodeDefect(input.cause) }) : new Error(input.message);
@@ -18861,9 +19190,9 @@ const Context = class {
 		this.annotations = annotations;
 	}
 };
-const TypeId$13 = "~effect/Schema";
+const TypeId$14 = "~effect/Schema";
 var ASTNodeImpl = class {
-	[TypeId$13] = TypeId$13;
+	[TypeId$14] = TypeId$14;
 	annotations;
 	checks;
 	encoding;
@@ -19052,7 +19381,7 @@ function literalToString(ast) {
 * @category constructors
 * @since 4.0.0
 */
-const String$6 = class extends ASTNodeImpl {
+const String$7 = class extends ASTNodeImpl {
 	_tag = "String";
 	/** @internal */
 	getParser() {
@@ -19082,7 +19411,7 @@ const String$6 = class extends ASTNodeImpl {
 * @category constructors
 * @since 4.0.0
 */
-const string = /*#__PURE__*/ new String$6();
+const string = /*#__PURE__*/ new String$7();
 /**
 * Constructs a {@link Number}.
 *
@@ -20272,7 +20601,7 @@ const optionalKey$1 = /*#__PURE__*/ memoizeIdempotent((ast) => {
 });
 const optionalKeyLastLink = /*#__PURE__*/ applyToLastLink(optionalKey$1);
 /** @internal */
-const optional$3 = /*#__PURE__*/ memoize((ast) => optionalKey$1(new Union$1([ast, undefined_])));
+const optional$4 = /*#__PURE__*/ memoize((ast) => optionalKey$1(new Union$1([ast, undefined_])));
 /** @internal */
 function withConstructorDefault$1(ast, defaultValue) {
 	return replaceContext(ast, ast.context ? new Context(ast.context.isOptional, ast.context.isMutable, defaultValue, ast.context.annotations) : new Context(false, false, defaultValue));
@@ -20735,7 +21064,7 @@ const makeHandle = (params) => Object.setPrototypeOf({ ...params }, HandleProto)
 * @category constructors
 * @since 4.0.0
 */
-const make$13 = (spawn) => {
+const make$14 = (spawn) => {
 	const streamString = (command, options) => spawn(command).pipe(map$5((handle) => decodeText(options?.includeStderr === true ? handle.all : handle.stdout)), unwrap);
 	const streamLines = (command, options) => splitLines(streamString(command, options));
 	return ChildProcessSpawner.of({
@@ -20769,7 +21098,7 @@ var ChildProcessSpawner = class extends (/*#__PURE__*/ Service()("effect/process
 * @stability unstable
 * @since 4.0.0
 */
-const TypeId$12 = "~effect/process/ChildProcess";
+const TypeId$13 = "~effect/process/ChildProcess";
 const Proto$6 = {
 	.../*#__PURE__*/ Prototype({
 		label: "Command",
@@ -20777,7 +21106,7 @@ const Proto$6 = {
 			return getUnsafe(fiber.context, ChildProcessSpawner).spawn(this);
 		}
 	}),
-	[TypeId$12]: TypeId$12
+	[TypeId$13]: TypeId$13
 };
 const makeStandardCommand = (command, args, options) => Object.assign(Object.create(Proto$6), {
 	_tag: "StandardCommand",
@@ -20819,7 +21148,7 @@ const makeStandardCommand = (command, args, options) => Object.assign(Object.cre
 * @category constructors
 * @since 4.0.0
 */
-const make$12 = function make(...args) {
+const make$13 = function make(...args) {
 	if (isTemplateString(args[0])) {
 		const [templates, ...expressions] = args;
 		const tokens = parseTemplates(templates, expressions);
@@ -21143,7 +21472,7 @@ const fromReadableChannel = (options) => fromTransform$1((_, scope) => readableT
 const readableToPullUnsafe = (options) => {
 	const readable = options.readable;
 	const closeOnDone = options.closeOnDone ?? true;
-	const exit = options.exit ?? make$22(void 0);
+	const exit = options.exit ?? make$23(void 0);
 	const latch = options.latch ?? makeUnsafe$1(false);
 	function onReadable() {
 		latch.openUnsafe();
@@ -21220,7 +21549,7 @@ const taskkill = (childProcess, onExit = () => {}) => NodeChildProcess.execFile(
 * @category layers
 * @since 4.0.0
 */
-const layer$12 = /*#__PURE__*/ effect(ChildProcessSpawner, /* @__PURE__ */ gen(function* () {
+const layer$13 = /*#__PURE__*/ effect(ChildProcessSpawner, /* @__PURE__ */ gen(function* () {
 	const fs = yield* FileSystem;
 	const path = yield* Path$1;
 	const resolveWorkingDirectory = fnUntraced(function* (options) {
@@ -21542,7 +21871,7 @@ const layer$12 = /*#__PURE__*/ effect(ChildProcessSpawner, /* @__PURE__ */ gen(f
 					const stdinConfig = resolveStdinOption(command.options);
 					const sourceStream = unwrap(succeed$3(getSourceStream(handles[handles.length - 1], options.from)));
 					const toOption = options.to ?? "stdin";
-					if (toOption === "stdin") handles.push(yield* spawnCommand(make$12(command.command, command.args, {
+					if (toOption === "stdin") handles.push(yield* spawnCommand(make$13(command.command, command.args, {
 						...command.options,
 						stdin: {
 							...stdinConfig,
@@ -21554,7 +21883,7 @@ const layer$12 = /*#__PURE__*/ effect(ChildProcessSpawner, /* @__PURE__ */ gen(f
 						if (isNotUndefined(fd)) {
 							const fdName$1 = fdName(fd);
 							const existingFds = command.options.additionalFds ?? {};
-							handles.push(yield* spawnCommand(make$12(command.command, command.args, {
+							handles.push(yield* spawnCommand(make$13(command.command, command.args, {
 								...command.options,
 								additionalFds: {
 									...existingFds,
@@ -21564,7 +21893,7 @@ const layer$12 = /*#__PURE__*/ effect(ChildProcessSpawner, /* @__PURE__ */ gen(f
 									}
 								}
 							})));
-						} else handles.push(yield* spawnCommand(make$12(command.command, command.args, {
+						} else handles.push(yield* spawnCommand(make$13(command.command, command.args, {
 							...command.options,
 							stdin: {
 								...stdinConfig,
@@ -21596,7 +21925,7 @@ const layer$12 = /*#__PURE__*/ effect(ChildProcessSpawner, /* @__PURE__ */ gen(f
 			}
 		}
 	});
-	return make$13(spawnCommand);
+	return make$14(spawnCommand);
 }));
 /**
 * Flattens a `Command` into an array of `StandardCommand`s along with pipe
@@ -21703,7 +22032,7 @@ const v7String = (timestampMillis, bytes) => stringify(bytes === void 0 ? v7Byte
 * @stability unstable
 * @since 4.0.0
 */
-const TypeId$11 = "~effect/Crypto";
+const TypeId$12 = "~effect/Crypto";
 /**
 * Service tag for platform cryptography.
 *
@@ -21762,7 +22091,7 @@ const Crypto = /*#__PURE__*/ Service("effect/Crypto");
 * @category constructors
 * @since 4.0.0
 */
-const make$10 = (impl) => {
+const make$11 = (impl) => {
 	const randomBytesUnsafe = impl.randomBytes;
 	const randomBytes = (size) => map$5(validateSize("randomBytes", size), randomBytesUnsafe);
 	const readUint53 = (bytes) => (bytes[0] & 31) * 2 ** 48 + bytes[1] * 2 ** 40 + bytes[2] * 2 ** 32 + bytes[3] * 2 ** 24 + bytes[4] * 2 ** 16 + bytes[5] * 256 + bytes[6];
@@ -21776,7 +22105,7 @@ const make$10 = (impl) => {
 		}
 	};
 	return Crypto.of({
-		[TypeId$11]: TypeId$11,
+		[TypeId$12]: TypeId$12,
 		randomBytes,
 		nextDoubleUnsafe,
 		nextIntUnsafe,
@@ -21867,7 +22196,7 @@ const digest = (algorithm, data) => try_({
 * @category layers
 * @since 1.0.0
 */
-const layer$10 = /* @__PURE__ */ succeed$4(Crypto, /* @__PURE__ */ make$10({
+const layer$11 = /* @__PURE__ */ succeed$4(Crypto, /* @__PURE__ */ make$11({
 	randomBytes: NodeCrypto.randomBytes,
 	digest
 }));
@@ -22217,7 +22546,7 @@ const writeFile = (path, data, options) => callback$1((resume, signal) => {
 		resume(fail$1(handleBadArgument("writeFile")(err)));
 	}
 });
-const makeFileSystem = /*#__PURE__*/ map$5(/*#__PURE__*/ serviceOption(WatchBackend), (backend) => make$16({
+const makeFileSystem = /*#__PURE__*/ map$5(/*#__PURE__*/ serviceOption(WatchBackend), (backend) => make$17({
 	access,
 	chmod,
 	chown,
@@ -22266,7 +22595,7 @@ const makeFileSystem = /*#__PURE__*/ map$5(/*#__PURE__*/ serviceOption(WatchBack
 * @category layers
 * @since 4.0.0
 */
-const layer$8 = /* @__PURE__ */ effect(FileSystem)(makeFileSystem);
+const layer$9 = /* @__PURE__ */ effect(FileSystem)(makeFileSystem);
 //#endregion
 //#region ../../node_modules/.pnpm/@effect+platform-node-shared@4.0.2_effect@4.0.2/node_modules/@effect/platform-node-shared/dist/NodePath.js
 /**
@@ -22327,8 +22656,8 @@ const fileUrlOps = (windows) => ({
 * @category layers
 * @since 4.0.0
 */
-const layer$6 = /* @__PURE__ */ succeed$4(Path$1)({
-	[TypeId$17]: TypeId$17,
+const layer$7 = /* @__PURE__ */ succeed$4(Path$1)({
+	[TypeId$18]: TypeId$18,
 	...Path,
 	.../*#__PURE__*/ fileUrlOps(void 0)
 });
@@ -22360,7 +22689,7 @@ const layer$6 = /* @__PURE__ */ succeed$4(Path$1)({
 * @category type IDs
 * @since 4.0.0
 */
-const TypeId$10 = "~effect/Stdio";
+const TypeId$11 = "~effect/Stdio";
 /**
 * Service tag for process standard I/O.
 *
@@ -22376,7 +22705,7 @@ const TypeId$10 = "~effect/Stdio";
 * @category services
 * @since 4.0.0
 */
-const Stdio = /*#__PURE__*/ Service(TypeId$10);
+const Stdio = /*#__PURE__*/ Service(TypeId$11);
 /**
 * Creates a `Stdio` service implementation from the provided fields and
 * attaches the `Stdio` type identifier.
@@ -22398,8 +22727,8 @@ const Stdio = /*#__PURE__*/ Service(TypeId$10);
 * @category constructors
 * @since 4.0.0
 */
-const make$8 = (options) => ({
-	[TypeId$10]: TypeId$10,
+const make$9 = (options) => ({
+	[TypeId$11]: TypeId$11,
 	stdinIsTerminal: succeed$3(false),
 	stdoutIsTerminal: succeed$3(false),
 	...options
@@ -22425,7 +22754,7 @@ const make$8 = (options) => ({
 * @category layers
 * @since 4.0.0
 */
-const layer$4 = /* @__PURE__ */ succeed$4(Stdio, /*#__PURE__*/ make$8({
+const layer$5 = /* @__PURE__ */ succeed$4(Stdio, /*#__PURE__*/ make$9({
 	args: /*#__PURE__*/ sync(() => process.argv.slice(2)),
 	stdinIsTerminal: /*#__PURE__*/ sync(() => process.stdin.isTTY === true),
 	stdoutIsTerminal: /*#__PURE__*/ sync(() => process.stdout.isTTY === true),
@@ -22486,7 +22815,7 @@ const value$2 = (self) => {
 * @stability stable
 * @since 3.3.0
 */
-const TypeId$8 = "~effect/Redacted";
+const TypeId$9 = "~effect/Redacted";
 /**
 * Returns `true` if a value is a `Redacted` wrapper.
 *
@@ -22515,7 +22844,7 @@ const TypeId$8 = "~effect/Redacted";
 * @category guards
 * @since 3.3.0
 */
-const isRedacted = (u) => hasProperty(u, TypeId$8);
+const isRedacted = (u) => hasProperty(u, TypeId$9);
 /**
 * Creates a `Redacted` wrapper for a sensitive value.
 *
@@ -22543,14 +22872,14 @@ const isRedacted = (u) => hasProperty(u, TypeId$8);
 * @category constructors
 * @since 3.3.0
 */
-const make$7 = (value, options) => {
+const make$8 = (value, options) => {
 	const self = Object.create(Proto$4);
 	if (options?.label) self.label = options.label;
 	redactedRegistry.set(self, value);
 	return self;
 };
 const Proto$4 = {
-	[TypeId$8]: { _A: (_) => _ },
+	[TypeId$9]: { _A: (_) => _ },
 	label: void 0,
 	...PipeInspectableProto,
 	toJSON() {
@@ -22853,7 +23182,7 @@ function makeOption(schema) {
 * @category constructors
 * @since 4.0.0
 */
-function make$5(schema) {
+function make$6(schema) {
 	return makeConstructorSync(toType$1(schema.ast));
 }
 /**
@@ -23072,12 +23401,12 @@ const constructorCompiler = (ast) => resolve(ast).makeEffect;
 //#endregion
 //#region ../../node_modules/.pnpm/effect@4.0.2/node_modules/effect/dist/internal/schema/make.js
 /** @internal */
-const TypeId$6 = "~effect/Schema/Schema";
+const TypeId$7 = "~effect/Schema/Schema";
 const RebuildOptions = /*#__PURE__*/ Symbol();
 const SchemaProto = {
-	[TypeId$6]: TypeId$6,
+	[TypeId$7]: TypeId$7,
 	get make() {
-		const value = make$5(this);
+		const value = make$6(this);
 		Object.defineProperty(this, "make", {
 			value,
 			enumerable: true
@@ -23113,11 +23442,11 @@ const SchemaProto = {
 		return this.rebuild(appendChecks(this.ast, checks));
 	},
 	rebuild(ast) {
-		return make$4(ast, this[RebuildOptions]);
+		return make$5(ast, this[RebuildOptions]);
 	}
 };
 /** @internal */
-function make$4(ast, options) {
+function make$5(ast, options) {
 	function Schema() {}
 	const self = Object.setPrototypeOf(Schema, SchemaProto);
 	if (options && (Object.hasOwn(options, "name") || Object.hasOwn(options, "length") || Object.hasOwn(options, "__proto__"))) Object.defineProperties(self, Object.getOwnPropertyDescriptors({ ...options }));
@@ -23370,7 +23699,7 @@ function toCodecJsonASTStep(ast, recur) {
 		case "Declaration": {
 			const getLink = ast.annotations?.toCodecJson ?? ast.annotations?.toCodec;
 			if (!isFunction(getLink)) return replaceEncoding(ast, [unknownToJson]);
-			const link = getLink(ast.typeParameters.map((tp) => make$4(toEncoded(tp))));
+			const link = getLink(ast.typeParameters.map((tp) => make$5(toEncoded(tp))));
 			return link === void 0 ? ast : replaceEncoding(ast, [mapLink(link, recur)]);
 		}
 		case "Unknown": return replaceEncoding(ast, [unknownToJson]);
@@ -23397,7 +23726,7 @@ function toCodecJsonASTStep(ast, recur) {
 }
 /** @internal */
 function toCodecStringTree$1(schema) {
-	return make$4(toCodecStringTreeAST(schema.ast), { schema });
+	return make$5(toCodecStringTreeAST(schema.ast), { schema });
 }
 const toStringTreeReorder = /*#__PURE__*/ makeReorder((ast) => {
 	switch (ast._tag) {
@@ -23413,7 +23742,7 @@ const toStringTreeReorder = /*#__PURE__*/ makeReorder((ast) => {
 function toCodecStringTreeASTStep(ast, recur, onMissingAnnotation) {
 	switch (ast._tag) {
 		case "Declaration": {
-			const typeParameters = ast.typeParameters.map((tp) => make$4(recur(toEncoded(tp))));
+			const typeParameters = ast.typeParameters.map((tp) => make$5(recur(toEncoded(tp))));
 			const getStringTreeLink = ast.annotations?.toCodecStringTree;
 			if (isFunction(getStringTreeLink)) {
 				const link = getStringTreeLink(typeParameters);
@@ -23450,7 +23779,7 @@ function toCodecStringTreeASTStep(ast, recur, onMissingAnnotation) {
 	return ast;
 }
 const nullToString = /*#__PURE__*/ new Link(/*#__PURE__*/ new Literal$1("null"), /*#__PURE__*/ new Transformation(/*#__PURE__*/ transform$2(() => null), /*#__PURE__*/ transform$2(() => "null")));
-const booleanToString = /*#__PURE__*/ new Link(/*#__PURE__*/ new Union$1([/*#__PURE__*/ new Literal$1("true"), /*#__PURE__*/ new Literal$1("false")]), /*#__PURE__*/ new Transformation(/*#__PURE__*/ transform$2((s) => s === "true"), /*#__PURE__*/ String$7()));
+const booleanToString = /*#__PURE__*/ new Link(/*#__PURE__*/ new Union$1([/*#__PURE__*/ new Literal$1("true"), /*#__PURE__*/ new Literal$1("false")]), /*#__PURE__*/ new Transformation(/*#__PURE__*/ transform$2((s) => s === "true"), /*#__PURE__*/ String$8()));
 const arrayFromSingleTransformation = /*#__PURE__*/ new Transformation(/*#__PURE__*/ transform$2((input) => typeof input === "string" ? [input] : input), /*#__PURE__*/ passthrough$1());
 const isCodecArrayFromSingleLink = (link) => link.transformation === arrayFromSingleTransformation;
 const toCodecStringTreeAST = /*#__PURE__*/ applyToSelfOrLastLinkEncodingIdempotent((ast) => {
@@ -24365,7 +24694,7 @@ function isSchemaError$1(u) {
 * @stability stable
 * @since 4.0.0
 */
-const TypeId$5 = TypeId$6;
+const TypeId$6 = TypeId$7;
 /**
 * Error thrown or returned when schema decoding or encoding fails.
 *
@@ -24752,7 +25081,7 @@ const encodeSync = encodeUnknownSync;
 * @category constructors
 * @since 3.10.0
 */
-const make$3 = make$4;
+const make$4 = make$5;
 /**
 * Checks whether a value is a `Schema`.
 *
@@ -24761,7 +25090,7 @@ const make$3 = make$4;
 * @since 3.10.0
 */
 function isSchema(u) {
-	return hasProperty(u, TypeId$5) && u[TypeId$5] === TypeId$5;
+	return hasProperty(u, TypeId$6) && u[TypeId$6] === TypeId$6;
 }
 /**
 * Creates an exact optional key schema for struct fields. Unlike `optional`,
@@ -24786,7 +25115,7 @@ function isSchema(u) {
 * @category combinators
 * @since 4.0.0
 */
-const optionalKey = /*#__PURE__*/ lambda((schema) => make$3(optionalKey$1(schema.ast), { schema }));
+const optionalKey = /*#__PURE__*/ lambda((schema) => make$4(optionalKey$1(schema.ast), { schema }));
 /**
 * Marks a struct field as optional, allowing the key to be absent or
 * `undefined`.
@@ -24817,9 +25146,9 @@ const optionalKey = /*#__PURE__*/ lambda((schema) => make$3(optionalKey$1(schema
 * @category combinators
 * @since 3.10.0
 */
-const optional$2 = /*#__PURE__*/ lambda((self) => {
+const optional$3 = /*#__PURE__*/ lambda((self) => {
 	const schema = UndefinedOr(self);
-	return make$3(optional$3(self.ast), { schema });
+	return make$4(optional$4(self.ast), { schema });
 });
 /**
 * Extracts the type-side schema: sets `Encoded` to equal the decoded `Type`,
@@ -24829,7 +25158,7 @@ const optional$2 = /*#__PURE__*/ lambda((self) => {
 * @category transforming
 * @since 4.0.0
 */
-const toType = /*#__PURE__*/ lambda((schema) => make$3(toType$1(schema.ast), { schema }));
+const toType = /*#__PURE__*/ lambda((schema) => make$4(toType$1(schema.ast), { schema }));
 /**
 * Creates a schema for a single literal value (string, number, bigint, boolean, or null).
 *
@@ -24851,7 +25180,7 @@ const toType = /*#__PURE__*/ lambda((schema) => make$3(toType$1(schema.ast), { s
 * @since 3.10.0
 */
 function Literal(literal) {
-	const out = make$3(new Literal$1(literal), {
+	const out = make$4(new Literal$1(literal), {
 		literal,
 		transform(to) {
 			return out.pipe(decodeTo(Literal(to), {
@@ -24875,7 +25204,7 @@ function Literal(literal) {
 * @category schemas
 * @since 3.10.0
 */
-const Unknown = /*#__PURE__*/ make$3(unknown);
+const Unknown = /*#__PURE__*/ make$4(unknown);
 /**
 * Schema for the `null` literal. Validates that the input is strictly `null`.
 *
@@ -24884,7 +25213,7 @@ const Unknown = /*#__PURE__*/ make$3(unknown);
 * @category schemas
 * @since 3.10.0
 */
-const Null = /*#__PURE__*/ make$3(null_);
+const Null = /*#__PURE__*/ make$4(null_);
 /**
 * Schema for the `undefined` literal. Validates that the input is strictly `undefined`.
 *
@@ -24893,7 +25222,7 @@ const Null = /*#__PURE__*/ make$3(null_);
 * @category schemas
 * @since 3.10.0
 */
-const Undefined = /*#__PURE__*/ make$3(undefined_);
+const Undefined = /*#__PURE__*/ make$4(undefined_);
 /**
 * Schema for `string` values. Validates that the input is `typeof` `"string"`.
 *
@@ -24901,7 +25230,7 @@ const Undefined = /*#__PURE__*/ make$3(undefined_);
 * @category schemas
 * @since 4.0.0
 */
-const String$5 = /*#__PURE__*/ make$3(string);
+const String$6 = /*#__PURE__*/ make$4(string);
 /**
 * Schema for `number` values, including `NaN`, `Infinity`, and `-Infinity`.
 *
@@ -24917,7 +25246,7 @@ const String$5 = /*#__PURE__*/ make$3(string);
 * @category schemas
 * @since 4.0.0
 */
-const Number$2 = /*#__PURE__*/ make$3(number);
+const Number$2 = /*#__PURE__*/ make$4(number);
 /**
 * Schema for `boolean` values. Validates that the input is `typeof` `"boolean"`.
 *
@@ -24931,9 +25260,9 @@ const Number$2 = /*#__PURE__*/ make$3(number);
 * @category schemas
 * @since 4.0.0
 */
-const Boolean$4 = /*#__PURE__*/ make$3(boolean);
+const Boolean$4 = /*#__PURE__*/ make$4(boolean);
 function makeStruct(ast, fields) {
-	return make$3(ast, {
+	return make$4(ast, {
 		fields,
 		mapFields(f, options) {
 			const fields = f(this.fields);
@@ -25019,7 +25348,7 @@ function Struct(fields) {
 * @since 3.10.0
 */
 function Record(key, value) {
-	return make$3(record(key.ast, value.ast), {
+	return make$4(record(key.ast, value.ast), {
 		key,
 		value
 	});
@@ -25028,7 +25357,7 @@ function Record(key, value) {
 * @category constructors
 * @since 4.0.0
 */
-const ArraySchema = /*#__PURE__*/ lambda((schema) => make$3(new Arrays(false, [], [schema.ast]), { value: schema }));
+const ArraySchema = /*#__PURE__*/ lambda((schema) => make$4(new Arrays(false, [], [schema.ast]), { value: schema }));
 /**
 * Defines a non-empty `ReadonlyArray` schema — at least one element required.
 * Type is `readonly [T, ...T[]]`.
@@ -25047,9 +25376,9 @@ const ArraySchema = /*#__PURE__*/ lambda((schema) => make$3(new Arrays(false, []
 * @category constructors
 * @since 3.10.0
 */
-const NonEmptyArray = /*#__PURE__*/ lambda((schema) => make$3(new Arrays(false, [schema.ast], [schema.ast]), { value: schema }));
+const NonEmptyArray = /*#__PURE__*/ lambda((schema) => make$4(new Arrays(false, [schema.ast], [schema.ast]), { value: schema }));
 function makeUnion(ast, members) {
-	return make$3(ast, {
+	return make$4(ast, {
 		members,
 		mapMembers(f, options) {
 			const members = f(this.members);
@@ -25104,7 +25433,7 @@ function Union(members, options) {
 */
 function Literals$2(literals) {
 	const members = literals.map(Literal);
-	return make$3(union(members, void 0, void 0), {
+	return make$4(union(members, void 0, void 0), {
 		literals,
 		members,
 		mapMembers(f) {
@@ -25136,7 +25465,7 @@ const NullOr = /*#__PURE__*/ lambda((self) => Union([self, Null]));
 const UndefinedOr = /*#__PURE__*/ lambda((self) => Union([self, Undefined]));
 function decodeTo(to, transformation) {
 	return (from) => {
-		return make$3(decodeTo$1(from.ast, to.ast, transformation ? makeTransformation(transformation) : passthrough()), {
+		return make$4(decodeTo$1(from.ast, to.ast, transformation ? makeTransformation(transformation) : passthrough()), {
 			from,
 			to
 		});
@@ -25191,7 +25520,7 @@ const BooleanLiterals = /*#__PURE__*/ Literals$2([...TrueLiterals.literals, ...F
 * @since 3.10.0
 */
 function withConstructorDefault(defaultValue) {
-	return (schema) => make$3(withConstructorDefault$1(schema.ast, defaultValue), { schema });
+	return (schema) => make$4(withConstructorDefault$1(schema.ast, defaultValue), { schema });
 }
 /**
 * Combines a {@link Literal} schema with {@link withConstructorDefault}, making it ideal
@@ -25484,7 +25813,7 @@ function isUnique(annotations) {
 * @category schemas
 * @since 3.10.0
 */
-const NonEmptyString = /*#__PURE__*/ String$5.check(/*#__PURE__*/ isNonEmpty());
+const NonEmptyString = /*#__PURE__*/ String$6.check(/*#__PURE__*/ isNonEmpty());
 const getErrorOptionsKey = (options) => (options?.includeStack === true ? 1 : 0) | (options?.excludeCause === true ? 2 : 0);
 const getErrorOptions = (key) => {
 	switch (key) {
@@ -25550,7 +25879,7 @@ function Defect(options) {
 }
 globalThis.RegExp;
 globalThis.URL;
-const JsonString = /*#__PURE__*/ String$5.annotate({
+const JsonString = /*#__PURE__*/ String$6.annotate({
 	expected: "a string that will be decoded as JSON",
 	contentMediaType: "application/json"
 });
@@ -25609,7 +25938,7 @@ function makeClass(Inherited, identifier, struct$1, annotations, proto) {
 				}
 			});
 		}
-		static [TypeId$5] = TypeId$5;
+		static [TypeId$6] = TypeId$6;
 		get [ClassTypeId]() {
 			return ClassTypeId;
 		}
@@ -25626,7 +25955,7 @@ function makeClass(Inherited, identifier, struct$1, annotations, proto) {
 			return getClassSchema(this).rebuild(ast);
 		}
 		static make(input, options) {
-			return make$5(getClassSchema(this))(input ?? {}, options);
+			return make$6(getClassSchema(this))(input ?? {}, options);
 		}
 		static makeOption(input, options) {
 			return makeOption(getClassSchema(this))(input ?? {}, options);
@@ -25677,7 +26006,7 @@ function getClassSchemaFactory(from, identifier, annotations) {
 		const ClassTypeId = getClassTypeId(identifier);
 		const isClassValue = (input) => input instanceof self || hasProperty(input, ClassTypeId);
 		const transformation = getClassTransformation(self);
-		return memo = decodeTo(make$3(new Declaration([from.ast], () => (input, ast, options) => {
+		return memo = decodeTo(make$4(new Declaration([from.ast], () => (input, ast, options) => {
 			return isClassValue(input) ? succeed$3(input) : fail$1(new InvalidType(ast, input, options));
 		}, {
 			identifier,
@@ -25877,13 +26206,13 @@ const toCodecStringTree = toCodecStringTree$1;
 * @category schemas
 * @since 4.0.0
 */
-const Json = /*#__PURE__*/ make$3(/*#__PURE__*/ annotate$1(Json$1, { toCode: () => ({
+const Json = /*#__PURE__*/ make$4(/*#__PURE__*/ annotate$1(Json$1, { toCode: () => ({
 	runtime: "Schema.Json",
 	Type: "Schema.Json"
 }) }));
 //#endregion
 //#region ../../node_modules/.pnpm/effect@4.0.2/node_modules/effect/dist/Terminal.js
-const TypeId$4 = "~effect/Terminal";
+const TypeId$5 = "~effect/Terminal";
 const QuitErrorTypeId = "~effect/Terminal/QuitError";
 /**
 * Represents an error that occurs when a user attempts to
@@ -25960,9 +26289,9 @@ const Terminal = /*#__PURE__*/ Service("effect/Terminal");
 * @category constructors
 * @since 4.0.0
 */
-const make$2 = (impl) => Terminal.of({
+const make$3 = (impl) => Terminal.of({
 	...impl,
-	[TypeId$4]: TypeId$4
+	[TypeId$5]: TypeId$5
 });
 /**
 * Provides the default process-backed `Terminal` service, ending key input on
@@ -25972,10 +26301,10 @@ const make$2 = (impl) => Terminal.of({
 * @category layers
 * @since 4.0.0
 */
-const layer$3 = /*#__PURE__*/ effect(Terminal, /*#__PURE__*/ (/* @__PURE__ */ fnUntraced(function* (shouldQuit = defaultShouldQuit) {
+const layer$4 = /*#__PURE__*/ effect(Terminal, /*#__PURE__*/ (/* @__PURE__ */ fnUntraced(function* (shouldQuit = defaultShouldQuit) {
 	const stdin = process.stdin;
 	const stdout = process.stdout;
-	const lines = yield* make$20();
+	const lines = yield* make$21();
 	let inputEnded = stdin.readableEnded;
 	let readlineActive = false;
 	const onStdinEnd = () => {
@@ -25984,7 +26313,7 @@ const layer$3 = /*#__PURE__*/ effect(Terminal, /*#__PURE__*/ (/* @__PURE__ */ fn
 	};
 	stdin.once("end", onStdinEnd);
 	yield* addFinalizer(() => sync(() => stdin.off("end", onStdinEnd)));
-	const rlRef = yield* make$18({
+	const rlRef = yield* make$19({
 		acquire: acquireRelease(sync(() => {
 			const rl = readline.createInterface({
 				input: stdin,
@@ -26018,7 +26347,7 @@ const layer$3 = /*#__PURE__*/ effect(Terminal, /*#__PURE__*/ (/* @__PURE__ */ fn
 	const columns = sync(() => stdout.columns ?? 0);
 	const rows = sync(() => stdout.rows ?? 0);
 	const readInput = gen(function* () {
-		const queue = yield* make$20();
+		const queue = yield* make$21();
 		const handleKeypress = (s, k) => {
 			const userInput = {
 				input: fromUndefinedOr(s),
@@ -26062,7 +26391,7 @@ const layer$3 = /*#__PURE__*/ effect(Terminal, /*#__PURE__*/ (/* @__PURE__ */ fn
 			cause: err
 		}))));
 	}));
-	return make$2({
+	return make$3({
 		columns,
 		rows,
 		readInput,
@@ -26083,7 +26412,7 @@ function defaultShouldQuit(input) {
 * @category layers
 * @since 4.0.0
 */
-const layer$1 = /*#__PURE__*/ provideMerge(layer$12, /*#__PURE__*/ mergeAll(layer$8, layer$10, layer$6, layer$4, layer$3));
+const layer$2 = /*#__PURE__*/ provideMerge(layer$13, /*#__PURE__*/ mergeAll(layer$9, layer$11, layer$7, layer$5, layer$4));
 //#endregion
 //#region ../../node_modules/.pnpm/effect@4.0.2/node_modules/effect/dist/cli/CliError.js
 /**
@@ -26104,7 +26433,7 @@ const layer$1 = /*#__PURE__*/ provideMerge(layer$12, /*#__PURE__*/ mergeAll(laye
 * @category type IDs
 * @since 4.0.0
 */
-const TypeId$3 = "~effect/cli/CliError";
+const TypeId$4 = "~effect/cli/CliError";
 /**
 * Type guard to check if a value is a CLI error.
 *
@@ -26126,7 +26455,7 @@ const TypeId$3 = "~effect/cli/CliError";
 * @category guards
 * @since 4.0.0
 */
-const isCliError = (u) => hasProperty(u, TypeId$3);
+const isCliError = (u) => hasProperty(u, TypeId$4);
 /**
 * Error thrown when an unrecognized option is encountered.
 *
@@ -26161,10 +26490,10 @@ const isCliError = (u) => hasProperty(u, TypeId$3);
 * @category errors
 * @since 4.0.0
 */
-var UnrecognizedOption = class extends (/*#__PURE__*/ TaggedError(`${TypeId$3}/UnrecognizedOption`)("UnrecognizedOption", {
-	option: String$5,
-	command: /*#__PURE__*/ optional$2(/*#__PURE__*/ ArraySchema(String$5)),
-	suggestions: /*#__PURE__*/ ArraySchema(String$5)
+var UnrecognizedOption = class extends (/*#__PURE__*/ TaggedError(`${TypeId$4}/UnrecognizedOption`)("UnrecognizedOption", {
+	option: String$6,
+	command: /*#__PURE__*/ optional$3(/*#__PURE__*/ ArraySchema(String$6)),
+	suggestions: /*#__PURE__*/ ArraySchema(String$6)
 })) {
 	/**
 	* Marks this value as a CLI parsing error for runtime guards.
@@ -26172,7 +26501,7 @@ var UnrecognizedOption = class extends (/*#__PURE__*/ TaggedError(`${TypeId$3}/U
 	* @stability unstable
 	* @since 4.0.0
 	*/
-	[TypeId$3] = TypeId$3;
+	[TypeId$4] = TypeId$4;
 	/**
 	* Formats the unrecognized option with command context and suggestions.
 	*
@@ -26208,10 +26537,10 @@ var UnrecognizedOption = class extends (/*#__PURE__*/ TaggedError(`${TypeId$3}/U
 * @category errors
 * @since 4.0.0
 */
-var DuplicateOption = class extends (/*#__PURE__*/ TaggedError(`${TypeId$3}/DuplicateOption`)("DuplicateOption", {
-	option: String$5,
-	parentCommand: String$5,
-	childCommand: String$5
+var DuplicateOption = class extends (/*#__PURE__*/ TaggedError(`${TypeId$4}/DuplicateOption`)("DuplicateOption", {
+	option: String$6,
+	parentCommand: String$6,
+	childCommand: String$6
 })) {
 	/**
 	* Marks this value as a CLI configuration error for runtime guards.
@@ -26219,7 +26548,7 @@ var DuplicateOption = class extends (/*#__PURE__*/ TaggedError(`${TypeId$3}/Dupl
 	* @stability unstable
 	* @since 4.0.0
 	*/
-	[TypeId$3] = TypeId$3;
+	[TypeId$4] = TypeId$4;
 	/**
 	* Explains which parent and child commands define the duplicate option.
 	*
@@ -26263,14 +26592,14 @@ var DuplicateOption = class extends (/*#__PURE__*/ TaggedError(`${TypeId$3}/Dupl
 * @category errors
 * @since 4.0.0
 */
-var MissingOption = class extends (/*#__PURE__*/ TaggedError(`${TypeId$3}/MissingOption`)("MissingOption", { option: String$5 })) {
+var MissingOption = class extends (/*#__PURE__*/ TaggedError(`${TypeId$4}/MissingOption`)("MissingOption", { option: String$6 })) {
 	/**
 	* Marks this value as a missing CLI option error for runtime guards.
 	*
 	* @stability unstable
 	* @since 4.0.0
 	*/
-	[TypeId$3] = TypeId$3;
+	[TypeId$4] = TypeId$4;
 	/**
 	* Formats the missing required flag for display.
 	*
@@ -26313,14 +26642,14 @@ var MissingOption = class extends (/*#__PURE__*/ TaggedError(`${TypeId$3}/Missin
 * @category errors
 * @since 4.0.0
 */
-var MissingArgument = class extends (/*#__PURE__*/ TaggedError(`${TypeId$3}/MissingArgument`)("MissingArgument", { argument: String$5 })) {
+var MissingArgument = class extends (/*#__PURE__*/ TaggedError(`${TypeId$4}/MissingArgument`)("MissingArgument", { argument: String$6 })) {
 	/**
 	* Marks this value as a missing CLI argument error for runtime guards.
 	*
 	* @stability unstable
 	* @since 4.0.0
 	*/
-	[TypeId$3] = TypeId$3;
+	[TypeId$4] = TypeId$4;
 	/**
 	* Formats the missing required positional argument for display.
 	*
@@ -26351,14 +26680,14 @@ var MissingArgument = class extends (/*#__PURE__*/ TaggedError(`${TypeId$3}/Miss
 * @category errors
 * @since 4.0.0
 */
-var UnexpectedArgument = class extends (/*#__PURE__*/ TaggedError(`${TypeId$3}/UnexpectedArgument`)("UnexpectedArgument", { arguments: /*#__PURE__*/ ArraySchema(String$5) })) {
+var UnexpectedArgument = class extends (/*#__PURE__*/ TaggedError(`${TypeId$4}/UnexpectedArgument`)("UnexpectedArgument", { arguments: /*#__PURE__*/ ArraySchema(String$6) })) {
 	/**
 	* Marks this value as an unexpected CLI argument error for runtime guards.
 	*
 	* @stability unstable
 	* @since 4.0.0
 	*/
-	[TypeId$3] = TypeId$3;
+	[TypeId$4] = TypeId$4;
 	/**
 	* Formats the unexpected positional arguments for display.
 	*
@@ -26404,10 +26733,10 @@ var UnexpectedArgument = class extends (/*#__PURE__*/ TaggedError(`${TypeId$3}/U
 * @category errors
 * @since 4.0.0
 */
-var InvalidValue = class extends (/*#__PURE__*/ TaggedError(`${TypeId$3}/InvalidValue`)("InvalidValue", {
-	option: String$5,
-	value: String$5,
-	expected: String$5,
+var InvalidValue = class extends (/*#__PURE__*/ TaggedError(`${TypeId$4}/InvalidValue`)("InvalidValue", {
+	option: String$6,
+	value: String$6,
+	expected: String$6,
 	kind: /*#__PURE__*/ Union([/*#__PURE__*/ Literal("flag"), /*#__PURE__*/ Literal("argument")])
 })) {
 	/**
@@ -26416,7 +26745,7 @@ var InvalidValue = class extends (/*#__PURE__*/ TaggedError(`${TypeId$3}/Invalid
 	* @stability unstable
 	* @since 4.0.0
 	*/
-	[TypeId$3] = TypeId$3;
+	[TypeId$4] = TypeId$4;
 	/**
 	* Formats the invalid flag or argument value with the expected input.
 	*
@@ -26467,10 +26796,10 @@ var InvalidValue = class extends (/*#__PURE__*/ TaggedError(`${TypeId$3}/Invalid
 * @category errors
 * @since 4.0.0
 */
-var UnknownSubcommand = class extends (/*#__PURE__*/ TaggedError(`${TypeId$3}/UnknownSubcommand`)("UnknownSubcommand", {
-	subcommand: String$5,
-	parent: /*#__PURE__*/ optional$2(/*#__PURE__*/ ArraySchema(String$5)),
-	suggestions: /*#__PURE__*/ ArraySchema(String$5)
+var UnknownSubcommand = class extends (/*#__PURE__*/ TaggedError(`${TypeId$4}/UnknownSubcommand`)("UnknownSubcommand", {
+	subcommand: String$6,
+	parent: /*#__PURE__*/ optional$3(/*#__PURE__*/ ArraySchema(String$6)),
+	suggestions: /*#__PURE__*/ ArraySchema(String$6)
 })) {
 	/**
 	* Marks this value as an unknown CLI subcommand error for runtime guards.
@@ -26478,7 +26807,7 @@ var UnknownSubcommand = class extends (/*#__PURE__*/ TaggedError(`${TypeId$3}/Un
 	* @stability unstable
 	* @since 4.0.0
 	*/
-	[TypeId$3] = TypeId$3;
+	[TypeId$4] = TypeId$4;
 	/**
 	* Formats the unknown subcommand with parent command context and suggestions.
 	*
@@ -26536,9 +26865,9 @@ var UnknownSubcommand = class extends (/*#__PURE__*/ TaggedError(`${TypeId$3}/Un
 * @category errors
 * @since 4.0.0
 */
-var UserError = class extends (/*#__PURE__*/ TaggedError(`${TypeId$3}/UserError`)("UserError", {
+var UserError = class extends (/*#__PURE__*/ TaggedError(`${TypeId$4}/UserError`)("UserError", {
 	cause: /*#__PURE__*/ Defect(),
-	userMessage: /*#__PURE__*/ optionalKey(String$5)
+	userMessage: /*#__PURE__*/ optionalKey(String$6)
 })) {
 	/**
 	* Marks this value as a user handler error for runtime guards.
@@ -26546,7 +26875,7 @@ var UserError = class extends (/*#__PURE__*/ TaggedError(`${TypeId$3}/UserError`
 	* @stability unstable
 	* @since 4.0.0
 	*/
-	[TypeId$3] = TypeId$3;
+	[TypeId$4] = TypeId$4;
 	/**
 	* Controls whether the runtime logger should report this error. The CLI
 	* runner sets this to `false` after rendering the error itself.
@@ -26603,11 +26932,11 @@ const NonShowHelpErrors = /*#__PURE__*/ Union([
 * @category errors
 * @since 4.0.0
 */
-var ShowHelp = class extends (/*#__PURE__*/ TaggedError(`${TypeId$3}/ShowHelp`)("ShowHelp", {
-	commandPath: /*#__PURE__*/ ArraySchema(String$5),
+var ShowHelp = class extends (/*#__PURE__*/ TaggedError(`${TypeId$4}/ShowHelp`)("ShowHelp", {
+	commandPath: /*#__PURE__*/ ArraySchema(String$6),
 	errors: /*#__PURE__*/ ArraySchema(NonShowHelpErrors)
 })) {
-	[TypeId$3] = TypeId$3;
+	[TypeId$4] = TypeId$4;
 	[errorExitCode] = this.errors.length ? 1 : 0;
 	[errorReported] = false;
 	get message() {
@@ -26738,7 +27067,7 @@ const Boolean$3 = /*#__PURE__*/ makeSchemaPrimitive("Boolean", BooleanLiterals);
 * @category constructors
 * @since 4.0.0
 */
-const String$4 = /*#__PURE__*/ makePrimitive("String", (value) => succeed$3(value));
+const String$5 = /*#__PURE__*/ makePrimitive("String", (value) => succeed$3(value));
 /**
 * Creates a primitive that accepts only specific choice values mapped to custom types.
 *
@@ -26989,7 +27318,7 @@ const eraseLines$1 = (rows) => {
 * @stability unstable
 * @since 4.0.0
 */
-const TypeId$2 = "~effect/cli/Prompt";
+const TypeId$3 = "~effect/cli/Prompt";
 const defaultTheme = {
 	prefix: "?",
 	arrowUp: "↑",
@@ -27285,7 +27614,7 @@ const map$2 = /*#__PURE__*/ dual(2, (self, f) => flatMap(self, (a) => succeed(f(
 * @category constructors
 * @since 4.0.0
 */
-const Password = (options) => basePrompt(options, "password").pipe(map$2(make$7));
+const Password = (options) => basePrompt(options, "password").pipe(map$2(make$8));
 /**
 * Runs a prompt by reading terminal input and rendering prompt frames until the
 * prompt submits a value.
@@ -27364,7 +27693,7 @@ const succeed = (value) => {
 * @category constructors
 * @since 4.0.0
 */
-const String$3 = (options) => basePrompt(options, "text");
+const String$4 = (options) => basePrompt(options, "text");
 /**
 * Creates a toggle prompt that lets the user switch between active and inactive
 * states and returns the selected boolean value.
@@ -27393,7 +27722,7 @@ const proto$1 = {
 			return run$2(this);
 		}
 	}),
-	[TypeId$2]: { _Output: (_) => _ }
+	[TypeId$3]: { _Output: (_) => _ }
 };
 const runWithInput = (prompt, terminal, input) => suspend$2(() => {
 	const op = prompt;
@@ -28478,7 +28807,23 @@ const entriesToDisplay = (cursor, total, maxVisible) => {
 };
 //#endregion
 //#region ../../node_modules/.pnpm/effect@4.0.2/node_modules/effect/dist/cli/Param.js
-const TypeId$1 = "~effect/cli/Param";
+const TypeId$2 = "~effect/cli/Param";
+/**
+* Defines the kind discriminator for positional argument parameters.
+*
+* **When to use**
+*
+* Use to build low-level `Param` constructors or type positions for positional
+* argument parameters.
+*
+* @see {@link flagKind} for the named flag parameter discriminator
+* @see {@link ParamKind} for the full parameter kind union
+*
+* @stability unstable
+* @category constants
+* @since 4.0.0
+*/
+const argumentKind = "argument";
 /**
 * Defines the kind discriminator for flag parameters.
 *
@@ -28495,7 +28840,7 @@ const TypeId$1 = "~effect/cli/Param";
 */
 const flagKind = "flag";
 const Proto$1 = {
-	[TypeId$1]: { _A: identity },
+	[TypeId$2]: { _A: identity },
 	pipe() {
 		return pipeArguments(this, arguments);
 	}
@@ -28517,7 +28862,7 @@ const Proto$1 = {
 * @category guards
 * @since 4.0.0
 */
-const isParam = (u) => hasProperty(u, TypeId$1);
+const isParam = (u) => hasProperty(u, TypeId$2);
 /**
 * Type guard to check if a Single param is a flag (not an argument).
 *
@@ -28570,9 +28915,9 @@ const makeSingle = (params) => {
 * @category constructors
 * @since 4.0.0
 */
-const String$2 = (kind, name) => makeSingle({
+const String$3 = (kind, name) => makeSingle({
 	name,
-	primitiveType: String$4,
+	primitiveType: String$5,
 	kind
 });
 /**
@@ -28731,7 +29076,7 @@ const withAlias$1 = /*#__PURE__*/ dual(2, (self, alias) => {
 * @category combinators
 * @since 4.0.0
 */
-const withDescription$2 = /*#__PURE__*/ dual(2, (self, description) => {
+const withDescription$3 = /*#__PURE__*/ dual(2, (self, description) => {
 	return transformSingle(self, (single) => makeSingle({
 		...single,
 		description: some(description)
@@ -28857,7 +29202,7 @@ const mapEffect = /*#__PURE__*/ dual(2, (self, f) => transform(self, (parse) =>
 * @category combinators
 * @since 4.0.0
 */
-const optional$1 = (param) => {
+const optional$2 = (param) => {
 	const parse = (args) => param.parse(args).pipe(map$5(([leftover, value]) => [leftover, some(value)]), catchTags({
 		MissingOption: () => succeed$3([args.arguments, none()]),
 		MissingArgument: () => succeed$3([args.arguments, none()])
@@ -28901,8 +29246,8 @@ const optional$1 = (param) => {
 * @since 4.0.0
 */
 const withDefault$1 = /*#__PURE__*/ dual(2, (self, defaultValue) => {
-	if (!isEffect(defaultValue)) return map$1(optional$1(self), getOrElse(() => defaultValue));
-	return mapEffect(optional$1(self), match$5({
+	if (!isEffect(defaultValue)) return map$1(optional$2(self), getOrElse(() => defaultValue));
+	return mapEffect(optional$2(self), match$5({
 		onNone: () => defaultValue,
 		onSome: succeed$3
 	}));
@@ -29115,7 +29460,7 @@ const transformSingle = (param, f) => {
 		Single: (single) => f(single),
 		Map: (mapped) => map$1(transformSingle(mapped.param, f), mapped.f),
 		Transform: (mapped) => transform(transformSingle(mapped.param, f), mapped.f, mapped.alternatives.map((alternative) => () => transformSingle(alternative(), f))),
-		Optional: (p) => optional$1(transformSingle(p.param, f)),
+		Optional: (p) => optional$2(transformSingle(p.param, f)),
 		Variadic: (p) => variadic(transformSingle(p.param, f), {
 			min: getOrUndefined$1(p.min),
 			max: getOrUndefined$1(p.max)
@@ -29177,6 +29522,61 @@ const getParamMetadata = (param) => {
 	});
 };
 //#endregion
+//#region ../../node_modules/.pnpm/effect@4.0.2/node_modules/effect/dist/cli/Argument.js
+/**
+* Creates a positional string argument.
+*
+* **Example** (Creating a string argument)
+*
+* ```ts import.meta.vitest
+* import { Argument } from "effect/cli"
+*
+* const filename = Argument.String("filename")
+* filename.kind // => "argument"
+* ```
+*
+* @stability unstable
+* @category constructors
+* @since 4.0.0
+*/
+const String$2 = (name) => String$3(argumentKind, name);
+/**
+* Makes a positional argument optional.
+*
+* **Example** (Making an argument optional)
+*
+* ```ts import.meta.vitest
+* import { Argument } from "effect/cli"
+*
+* const optionalVersion = Argument.String("version").pipe(Argument.optional)
+* optionalVersion.kind // => "argument"
+* ```
+*
+* @stability unstable
+* @category combinators
+* @since 4.0.0
+*/
+const optional$1 = (arg) => optional$2(arg);
+/**
+* Adds a description to a positional argument.
+*
+* **Example** (Adding an argument description)
+*
+* ```ts import.meta.vitest
+* import { Argument } from "effect/cli"
+*
+* const filename = Argument.String("filename").pipe(
+*   Argument.withDescription("The input file to process")
+* )
+* filename.kind // => "argument"
+* ```
+*
+* @stability unstable
+* @category combinators
+* @since 4.0.0
+*/
+const withDescription$2 = /*#__PURE__*/ dual(2, (self, description) => withDescription$3(self, description));
+//#endregion
 //#region ../../node_modules/.pnpm/effect@4.0.2/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.
@@ -30207,7 +30607,7 @@ const generate = (executableName, shell, descriptor) => {
 * @category constructors
 * @since 4.0.0
 */
-const String$1 = (name) => String$2(flagKind, name);
+const String$1 = (name) => String$3(flagKind, name);
 /**
 * Creates a boolean flag that can be enabled or disabled.
 *
@@ -30311,7 +30711,7 @@ const withAlias = /*#__PURE__*/ dual(2, (self, alias) => withAlias$1(self, alias
 * @category metadata
 * @since 4.0.0
 */
-const withDescription$1 = /*#__PURE__*/ dual(2, (self, description) => withDescription$2(self, description));
+const withDescription$1 = /*#__PURE__*/ dual(2, (self, description) => withDescription$3(self, description));
 /**
 * Sets a custom metavar (placeholder name) for the flag in help documentation.
 *
@@ -30387,7 +30787,7 @@ const withMetavar = /*#__PURE__*/ dual(2, (self, metavar) => withMetavar$1(self,
 * @category optionality
 * @since 4.0.0
 */
-const optional = (param) => optional$1(param);
+const optional = (param) => optional$2(param);
 /**
 * Provides a default value for a flag when it's not specified.
 *
@@ -30592,7 +30992,7 @@ const reconstructTree = (tree, results) => {
 * Internal implementation details for CLI commands.
 * Public API is in ../Command.ts
 */
-const TypeId = "~effect/cli/Command";
+const TypeId$1 = "~effect/cli/Command";
 /**
 * Casts a Command to its internal implementation.
 * For use by internal modules that need access to config, parse, handle, etc.
@@ -30675,7 +31075,7 @@ const makeCommand = (options) => {
 		};
 	};
 	return Object.assign(Object.create(Proto), {
-		[TypeId]: TypeId,
+		[TypeId$1]: TypeId$1,
 		name: options.name,
 		examples: options.examples ?? [],
 		annotations,
@@ -31943,7 +32343,7 @@ const promptSingle = (single) => {
 		case "Finite": return map$5(run$2(Number$1({ message })), (value) => commandLineArg(String(value)));
 		case "Int": return map$5(run$2(Int({ message })), (value) => commandLineArg(String(value)));
 		case "Redacted": return map$5(run$2(Password({ message })), (value) => commandLineArg(value$1(value), "<redacted>"));
-		default: return map$5(run$2(String$3({ message })), commandLineArg);
+		default: return map$5(run$2(String$4({ message })), commandLineArg);
 	}
 };
 const commandLineArg = (value, displayValue = value) => ({
@@ -32014,7 +32414,7 @@ const formatShellArg = (arg) => /^[A-Za-z0-9_./:@%+=,-]+$/.test(arg) ? arg : `'$
 * @category guards
 * @since 4.0.0
 */
-const isCommand = (u) => hasProperty(u, TypeId);
+const isCommand = (u) => hasProperty(u, TypeId$1);
 /**
 * Creates a `Command` from a name, an optional configuration, and an optional
 * handler.
@@ -32104,7 +32504,7 @@ const isCommand = (u) => hasProperty(u, TypeId);
 * @category constructors
 * @since 4.0.0
 */
-const make = (name, config, handler) => {
+const make$1 = (name, config, handler) => {
 	const parsedConfig = parseConfig$1(config ?? {});
 	return makeCommand({
 		name,
@@ -32625,14 +33025,264 @@ const runWith = (command, config) => {
 		}
 		const services = match$5(logLevel, {
 			onNone: () => empty$3(),
-			onSome: (level) => make$27(MinimumLogLevel, level)
+			onSome: (level) => make$28(MinimumLogLevel, level)
 		});
 		yield* provideContext(program, services);
 	}, catchFilter((error) => isCliError(error) && error._tag === "ShowHelp" ? succeed$7(error) : fail$5(error), (error) => andThen(showHelp(command, error, config.renderErrors !== false), fail$1(error))), catchFilter((error) => config.renderErrors !== false && isCliError(error) && error._tag === "UserError" ? succeed$7(error) : fail$5(error), (error) => andThen(showUserError(error), fail$1(error))), catchFilter((e) => isQuitError(e) ? succeed$7(e) : fail$5(e), (_) => interrupt$1));
 };
 //#endregion
 //#region package.json
-var version = "0.8.1";
+var version = "0.9.0";
+//#endregion
+//#region ../../node_modules/.pnpm/effect@4.0.2/node_modules/effect/dist/Logger.js
+const TypeId = "~effect/Logger";
+/**
+* Returns `true` if the specified value is a `Logger`, otherwise returns `false`.
+*
+* **Example** (Checking logger values)
+*
+* ```ts import.meta.vitest
+* import { Logger } from "effect"
+*
+* const myLogger = Logger.make(() => undefined)
+*
+* Logger.isLogger(myLogger) // => true
+* Logger.isLogger("not a logger") // => false
+* Logger.isLogger({ log: () => {} }) // => false
+* ```
+*
+* @stability stable
+* @category guards
+* @since 4.0.0
+*/
+const isLogger = (u) => hasProperty(u, TypeId);
+/**
+* Context reference containing the active loggers for the current fiber.
+*
+* **Details**
+*
+* By default this set includes the default logger and the tracer logger.
+* Providing `Logger.layer` replaces or merges with this set depending on its
+* options.
+*
+* **Example** (Accessing current loggers)
+*
+* ```ts import.meta.vitest
+* import { Effect, Logger } from "effect"
+*
+* const messages: Array<unknown> = []
+* const customLogger = Logger.make((options) => {
+*   messages.push(options.message)
+* })
+* const program = Effect.gen(function*() {
+*   const currentLoggers = yield* Effect.service(Logger.CurrentLoggers)
+*   yield* Effect.log("Hello from custom logger").pipe(
+*     Effect.provide(Logger.layer([customLogger]))
+*   )
+*   return currentLoggers.has(Logger.defaultLogger)
+* })
+*
+* Effect.runSync(program) // => true
+* messages // => [["Hello from custom logger"]]
+* ```
+*
+* @stability stable
+* @category services
+* @since 4.0.0
+*/
+const CurrentLoggers = CurrentLoggers$1;
+/**
+* Creates a new `Logger` from a log function.
+*
+* **Details**
+*
+* The log function receives an options object containing the message, log level,
+* cause, fiber information, and timestamp, and should return the desired output.
+*
+* **Example** (Creating loggers from functions)
+*
+* ```ts import.meta.vitest
+* import { Effect, Logger } from "effect"
+*
+* const outputs: Array<string> = []
+* const textLogger = Logger.make((options) =>
+*   `${options.logLevel}: ${options.message}`
+* )
+* const collector = Logger.make((options) => outputs.push(textLogger.log(options)))
+*
+* const program = Effect.log("Hello World").pipe(
+*   Effect.provide(Logger.layer([collector]))
+* )
+* Effect.runSync(program)
+* outputs // => ["Info: Hello World"]
+* ```
+*
+* @stability stable
+* @category constructors
+* @since 2.0.0
+*/
+const make = loggerMake;
+/**
+* Creates a scoped logger that batches the output of another logger.
+*
+* **Details**
+*
+* The returned effect starts a scoped background process that periodically
+* passes buffered outputs to `flush`. When the scope closes, the background
+* process is interrupted and any remaining buffered entries are flushed.
+*
+* **Example** (Batching logger output)
+*
+* ```ts import.meta.vitest
+* import { Effect, Logger } from "effect"
+*
+* const flushed: Array<ReadonlyArray<string>> = []
+* const messageLogger = Logger.make((options) => String(options.message))
+* const batchedLogger = Logger.batched(messageLogger, {
+*   window: "1 hour",
+*   flush: (messages) =>
+*     Effect.sync(() => {
+*       flushed.push(messages)
+*     })
+* })
+*
+* const program = Effect.scoped(Effect.gen(function*() {
+*   const logger = yield* batchedLogger
+*   yield* Effect.log("Event 1").pipe(Effect.provide(Logger.layer([logger])))
+*   yield* Effect.log("Event 2").pipe(Effect.provide(Logger.layer([logger])))
+* }))
+* await Effect.runPromise(program)
+* flushed // => [["Event 1", "Event 2"]]
+* ```
+*
+* @stability stable
+* @category constructors
+* @since 2.0.0
+*/
+const batched = /*#__PURE__*/ dual(2, (self, options) => suspend$3(() => {
+	let buffer = [];
+	const flush = uninterruptible$1(suspend$3(() => {
+		if (buffer.length === 0) return void_$2;
+		const arr = buffer;
+		buffer = [];
+		return options.flush(arr);
+	}));
+	return uninterruptibleMask$1((restore) => restore(sleep$1(options.window).pipe(andThen$1(flush), forever$2)).pipe(forkDetach, flatMap$2((fiber) => addFinalizer$2(() => andThen$1(fiberInterrupt(fiber), flush))), as$1(loggerMake((options) => {
+		buffer.push(self.log(options));
+	}))));
+}));
+/**
+* Creates a `Layer` which will overwrite the current set of loggers with the
+* specified array of `loggers`.
+*
+* **Details**
+*
+* If the specified array of `loggers` should be _merged_ with the current set
+* of loggers (instead of overwriting them), set `mergeWithExisting` to `true`.
+*
+* **Example** (Providing logger layers)
+*
+* ```ts import.meta.vitest
+* import { Effect, Logger } from "effect"
+*
+* const messages: Array<unknown> = []
+* const customLogger = Logger.make((options) => {
+*   messages.push(options.message)
+* })
+* const CustomLoggerLayer = Logger.layer([customLogger])
+*
+* const program = Effect.log("Application started").pipe(
+*   Effect.provide(CustomLoggerLayer)
+* )
+* Effect.runSync(program)
+* messages // => [["Application started"]]
+* ```
+*
+* @stability stable
+* @category layers
+* @since 4.0.0
+*/
+const layer$1 = (loggers, options) => effect(CurrentLoggers, withFiber$1(fnUntraced$1(function* (fiber) {
+	const currentLoggers = new Set(options?.mergeWithExisting === true ? fiber.getRef(CurrentLoggers$1) : []);
+	for (const logger of loggers) currentLoggers.add(isEffect$1(logger) ? yield* logger : logger);
+	return currentLoggers;
+})));
+/**
+* Creates a scoped logger that writes string logger output to a file.
+*
+* **Details**
+*
+* The returned effect requires `FileSystem` and `Scope`. The file logger batches
+* string output, writes each batch to the specified path, and flushes remaining
+* entries when the scope closes.
+*
+* **Example** (Writing JSON logs to a file)
+*
+* ```ts import.meta.vitest
+* import { Effect, FileSystem, Logger } from "effect"
+*
+* const writes: Array<string> = []
+* const file = {
+*   writeAll: (buffer: Uint8Array) => Effect.sync(() => {
+*     writes.push(new TextDecoder().decode(buffer).trim())
+*   })
+* } as unknown as FileSystem.File
+* const fileSystem = FileSystem.makeNoop({ open: () => Effect.succeed(file) })
+* const messageLogger = Logger.make((options) => String(options.message))
+*
+* const program = Effect.scoped(Effect.gen(function*() {
+*   const fileLogger = yield* Logger.toFile(messageLogger, "/tmp/log.txt")
+*   yield* Effect.log("a").pipe(Effect.provide(Logger.layer([fileLogger])))
+*   yield* Effect.log("b").pipe(Effect.provide(Logger.layer([fileLogger])))
+*   yield* Effect.log("c").pipe(Effect.provide(Logger.layer([fileLogger])))
+* })).pipe(Effect.provideService(FileSystem.FileSystem, fileSystem))
+*
+* await Effect.runPromise(program)
+* writes // => ["a\nb\nc"]
+* ```
+*
+* **Example** (Writing logs to files)
+*
+* ```ts import.meta.vitest
+* import { Effect, FileSystem, Logger } from "effect"
+*
+* const writes: Array<string> = []
+* const file = {
+*   writeAll: (buffer: Uint8Array) => Effect.sync(() => {
+*     writes.push(new TextDecoder().decode(buffer).trim())
+*   })
+* } as unknown as FileSystem.File
+* const fileSystem = FileSystem.makeNoop({ open: () => Effect.succeed(file) })
+* const messageLogger = Logger.make((options) => String(options.message))
+*
+* const program = Effect.scoped(Effect.gen(function*() {
+*   const fileLogger = yield* Logger.toFile(messageLogger, "/tmp/app.log", {
+*     batchWindow: "1 hour"
+*   })
+*   yield* Effect.log("Application started").pipe(
+*     Effect.provide(Logger.layer([fileLogger]))
+*   )
+* })).pipe(Effect.provideService(FileSystem.FileSystem, fileSystem))
+*
+* await Effect.runPromise(program)
+* writes // => ["Application started"]
+* ```
+*
+* @stability unstable
+* @category logging
+* @since 4.0.0
+*/
+const toFile = /*#__PURE__*/ dual((args) => isLogger(args[0]), (self, path, options) => gen$1(function* () {
+	const logFile = yield* (yield* FileSystem).open(path, {
+		flag: "a+",
+		...options
+	});
+	const encoder = new TextEncoder();
+	return yield* batched(self, {
+		window: options?.batchWindow ?? 1e3,
+		flush: (output) => ignore$1(logFile.writeAll(encoder.encode(output.join("\n") + "\n")))
+	});
+}));
 //#endregion
 //#region ../../node_modules/.pnpm/jsonc-parser@3.3.1/node_modules/jsonc-parser/lib/esm/impl/scanner.js
 /**
@@ -35288,9 +35938,9 @@ var import_semver = /* @__PURE__ */ __toESM((/* @__PURE__ */ __commonJSMin(((exp
 	};
 })))(), 1);
 var BumpError = class extends TaggedError()("BumpError", {
-	path: String$5,
-	at: String$5,
-	reason: String$5
+	path: String$6,
+	at: String$6,
+	reason: String$6
 }) {
 	get message() {
 		return `${this.path}: cannot bump ${this.at}: ${this.reason}`;
@@ -35332,7 +35982,7 @@ const Targeting = {
 	platforms: optionalKey(NonEmptyArray(Literals$2(["darwin", "linux"]))).annotateKey({ description: "`darwin`, `linux`, or both." }),
 	machines: optionalKey(NonEmptyArray(NonEmptyString)).annotateKey({ description: "Machine names from `machines`." })
 };
-const Origin = String$5.check(isPattern(/^[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+$/, {
+const Origin = String$6.check(isPattern(/^[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+$/, {
 	title: "GitHub origin",
 	description: "a GitHub \"owner/repo\""
 }));
@@ -35423,10 +36073,10 @@ const ReposSection = section({ cloneRoot: optionalKey(variants(withShorthand(Str
 	encode: (root) => root.path
 }))).annotateKey({ description: `Where a Machine keeps its Managed Clones: a path, or a list of \`{ path, platforms?, machines? }\` where a Machine gets the first that targets it. \`~\` expands on that Machine. Default: \`${DEFAULT_CLONE_ROOT}\`.` }) }, Record(NonEmptyString, variants(TrackedRepo)), `Tracked Repos, keyed by name, which names the Managed Clone and the \`repos:<name>\` Item. Each is \`{ origin, ref, install, ... }\`, ${VARIANTS}.`);
 const FleetConfig = Struct({
-	$schema: optionalKey(String$5),
-	shippedAt: optionalKey(String$5),
+	$schema: optionalKey(String$6),
+	shippedAt: optionalKey(String$6),
 	shippedFrom: optionalKey(NonEmptyString),
-	shippedTo: optionalKey(Record(NonEmptyString, String$5)),
+	shippedTo: optionalKey(Record(NonEmptyString, String$6)),
 	machines: ArraySchema(NonEmptyString).check(isMinLength(1, { message: "list at least one Machine" }), isUnique({ message: "list each Machine once" })).annotateKey({ description: "The Fleet: each Machine's tailnet name. A tailnet member that is not listed is not part of the Fleet." }),
 	repos: optionalKey(ReposSection).annotateKey({ description: "Each Tracked Repo is cloned on every targeted Machine and installed from its origin ref." }),
 	vp: optionalKey(VpSection).annotateKey({ description: "The vite-plus toolchain." }),
@@ -35452,14 +36102,14 @@ const SCHEMA_FILE = "schema.json";
 const configDir = (env) => `${env.XDG_CONFIG_HOME || `${env.HOME ?? "~"}/.config`}/fleetfizz`;
 const configPath = (env) => `${configDir(env)}/${CONFIG_FILE}`;
 var ConfigError = class extends TaggedError()("ConfigError", {
-	path: String$5,
-	problems: ArraySchema(String$5)
+	path: String$6,
+	problems: ArraySchema(String$6)
 }) {
 	get message() {
 		return [`${this.path}:`, ...this.problems.map((p) => `  ${p}`)].join("\n");
 	}
 };
-var ConfigNotFound = class extends TaggedError()("ConfigNotFound", { path: String$5 }) {
+var ConfigNotFound = class extends TaggedError()("ConfigNotFound", { path: String$6 }) {
 	get message() {
 		return `no config at ${this.path}; write one there (the README has an example) or pass --config`;
 	}
@@ -35596,6 +36246,7 @@ const fingerprintFn = [
 //#region ../../packages/remote/src/check.ts
 const STATE_DIR = "~/.local/state/fleetfizz";
 const RECORDS_DIR = `${STATE_DIR}/records`;
+const LOGS_DIR = `${STATE_DIR}/logs`;
 const CONFIG_DIR_SH = "\"${XDG_CONFIG_HOME:-$HOME/.config}/fleetfizz\"";
 const recordDir = (provider) => `${quotePath(RECORDS_DIR)}/${quote(provider)}`;
 const recordFile = (provider, item) => `${recordDir(provider)}/${quote(`${item}.json`)}`;
@@ -35621,16 +36272,16 @@ const checkScript = (input) => {
 };
 //#endregion
 //#region ../../packages/remote/src/protocol.ts
-const Fact = Record(String$5, Unknown);
-const StepStart = Struct({ id: String$5 });
+const Fact = Record(String$6, Unknown);
+const StepStart = Struct({ id: String$6 });
 const StepDone = Struct({
-	id: String$5,
+	id: String$6,
 	ok: Boolean$4,
 	code: optionalKey(Number$2)
 });
 const StepSkip = Struct({
-	id: String$5,
-	reason: String$5
+	id: String$6,
+	reason: String$6
 });
 const decodeFact$3 = decodeUnknownResult(fromJsonString(Fact));
 const decodeStart = decodeUnknownResult(fromJsonString(StepStart));
@@ -35743,16 +36394,16 @@ const applyScript = (plan) => [
 //#endregion
 //#region ../../packages/remote/src/tailnet.ts
 const StatusNode = Struct({
-	DNSName: String$5,
-	OS: String$5,
+	DNSName: String$6,
+	OS: String$6,
 	Online: optionalKey(Boolean$4),
-	sshHostKeys: optionalKey(NullOr(ArraySchema(String$5)))
+	sshHostKeys: optionalKey(NullOr(ArraySchema(String$6)))
 });
 const TailscaleStatus = Struct({
 	Self: StatusNode,
-	Peer: optionalKey(NullOr(Record(String$5, StatusNode)))
+	Peer: optionalKey(NullOr(Record(String$6, StatusNode)))
 });
-var TailnetError = class extends TaggedError()("TailnetError", { reason: String$5 }) {
+var TailnetError = class extends TaggedError()("TailnetError", { reason: String$6 }) {
 	get message() {
 		return `tailscale: ${this.reason}`;
 	}
@@ -35788,7 +36439,7 @@ const parseTailnet = fn("parseTailnet")(function* (status) {
 const readTailnet = fn("readTailnet")(function* () {
 	const spawner = yield* ChildProcessSpawner;
 	const output = yield* scoped(gen(function* () {
-		const handle = yield* spawner.spawn(make$12("tailscale", ["status", "--json"], {
+		const handle = yield* spawner.spawn(make$13("tailscale", ["status", "--json"], {
 			stdout: "pipe",
 			stderr: "pipe"
 		}));
@@ -35808,7 +36459,7 @@ const readTailnet = fn("readTailnet")(function* () {
 const readLentToken = fn("readLentToken")(function* () {
 	const spawner = yield* ChildProcessSpawner;
 	return yield* scoped(gen(function* () {
-		const handle = yield* spawner.spawn(make$12("gh", ["auth", "token"], {
+		const handle = yield* spawner.spawn(make$13("gh", ["auth", "token"], {
 			stdout: "pipe",
 			stderr: "pipe"
 		}));
@@ -35831,8 +36482,8 @@ const readLentToken = fn("readLentToken")(function* () {
 //#endregion
 //#region ../../packages/remote/src/transport.ts
 var SpawnError = class extends TaggedError()("SpawnError", {
-	machine: String$5,
-	reason: String$5
+	machine: String$6,
+	reason: String$6
 }) {
 	get message() {
 		return `${this.machine}: could not start ${this.reason}`;
@@ -35840,12 +36491,12 @@ var SpawnError = class extends TaggedError()("SpawnError", {
 };
 const command = (target, script, secrets) => {
 	const options = {
-		stdin: encodeText(make$17(secrets.map((s) => `${s}\n`).join(""))),
+		stdin: encodeText(make$18(secrets.map((s) => `${s}\n`).join(""))),
 		stdout: "pipe",
 		stderr: "pipe",
 		forceKillAfter: "5 seconds"
 	};
-	return target.local ? make$12(process.env.SHELL ?? "/bin/sh", ["-lc", script], options) : make$12("tailscale", [
+	return target.local ? make$13(process.env.SHELL ?? "/bin/sh", ["-lc", script], options) : make$13("tailscale", [
 		"ssh",
 		target.name,
 		script
@@ -35864,11 +36515,11 @@ const runScript = fn("runScript")(function* (target, script, secrets, onLine) {
 });
 //#endregion
 //#region ../../packages/remote/src/versions.ts
-const Versions = fromJsonString(Union([ArraySchema(String$5), String$5]));
+const Versions = fromJsonString(Union([ArraySchema(String$6), String$6]));
 const resolveOne = fn("resolveOne")(function* (pkg) {
 	const spawner = yield* ChildProcessSpawner;
 	const output = yield* scoped(gen(function* () {
-		const handle = yield* spawner.spawn(make$12("npm", [
+		const handle = yield* spawner.spawn(make$13("npm", [
 			"view",
 			pkg,
 			"versions",
@@ -35893,6 +36544,103 @@ const resolveVersions = fn("resolveVersions")(function* (packages) {
 	const entries = yield* forEach$1(unique, (pkg) => resolveOne(pkg).pipe(map$5((v) => [pkg, v])), { concurrency: 8 });
 	return Object.fromEntries(entries);
 });
+var LogsError = class extends Error {
+	name = "LogsError";
+};
+const shipId = (started, from) => `${formatIso(started).slice(0, 19).replaceAll(":", "-")}Z-${from}`;
+const parseShipId = (id) => {
+	const [, day, h, m, s, from] = /^(\d{4}-\d{2}-\d{2})T(\d{2})-(\d{2})-(\d{2})Z-(.+)$/.exec(id) ?? [];
+	if (from === void 0) return void 0;
+	return {
+		started: Date.parse(`${day}T${h}:${m}:${s}Z`),
+		from
+	};
+};
+const lineFormat = (hidden) => make(({ message, logLevel, date, cause, fiber }) => {
+	const { machine, phase } = fiber.getRef(CurrentLogAnnotations);
+	const scope = [machine, phase].filter((s) => typeof s === "string").join(" ");
+	const prefix = `${date.toISOString()} ${logLevel.toUpperCase().padEnd(5)}${scope === "" ? "" : ` [${scope}]`}`;
+	const parts = (Array.isArray(message) ? message : [message]).map((m) => typeof m === "string" ? m : JSON.stringify(m));
+	if (cause.reasons.length > 0) parts.push(pretty(cause));
+	let text = parts.join(" ");
+	for (const secret of hidden) text = text.replaceAll(secret, "[hidden]");
+	return text.split("\n").map((line) => `${prefix} ${line}`).join("\n");
+});
+const machineOf = (line) => /^\S+ +\S+ +\[([^\] ]+)/.exec(line)?.[1];
+const toPrune = (names) => {
+	const logs = names.filter((name) => name.endsWith(".log")).toSorted();
+	return logs.slice(0, Math.max(0, logs.length - 19));
+};
+const logsDir = () => LOGS_DIR.replace(/^~/, process.env.HOME ?? "~");
+const openShipLog = fn("openShipLog")(function* (id, hidden) {
+	const fs = yield* FileSystem;
+	const dir = logsDir();
+	yield* fs.makeDirectory(dir, { recursive: true });
+	for (const name of toPrune(yield* fs.readDirectory(dir))) yield* fs.remove(`${dir}/${name}`);
+	return yield* toFile(lineFormat(hidden), `${dir}/${id}.log`);
+});
+const read = fn("read")(function* (target, script, onLine) {
+	const code = yield* runScript(target, script, [], onLine);
+	if (!target.local && code === 255) return yield* fail$1(new LogsError(`could not reach ${target.name} over tailscale ssh`));
+});
+const shipIds = fn("shipIds")(function* (target) {
+	const ids = [];
+	yield* read(target, `ls -1 ${quotePath(LOGS_DIR)} 2>/dev/null`, (line) => sync(() => {
+		if (line.endsWith(".log")) ids.push(line.slice(0, -4));
+	}));
+	return ids.toSorted();
+});
+const MISSING = "ff-missing";
+const logs = fn("logs")(function* (flags) {
+	const here = {
+		name: "this Machine",
+		local: true
+	};
+	const local = yield* shipIds(here);
+	const self = parseShipId(local.at(-1) ?? "")?.from;
+	const tailnet = yield* cached(readTailnet());
+	const targetOf = fn("targetOf")(function* (name) {
+		if (name === self) return here;
+		const { self: me, fleet } = yield* tailnet;
+		if (name === me.name) return here;
+		const machine = fleet.find((m) => m.name === name);
+		if (machine === void 0) return yield* fail$1(new LogsError(`no Machine ${name} on the tailnet`));
+		if (!machine.online) return yield* fail$1(new LogsError(`${name} is offline; its logs are there`));
+		return {
+			name,
+			local: false
+		};
+	});
+	if (flags.list) {
+		if (local.length === 0) return yield* log("no Ship Log on this Machine yet");
+		for (const id of local.toReversed()) yield* log(id);
+		return;
+	}
+	const id = flags.id ?? (yield* latestShip(local, self, targetOf));
+	const ship = parseShipId(id);
+	if (ship === void 0) return yield* fail$1(new LogsError(`not a Ship id: ${id} (fizz logs --list shows them)`));
+	let missing = false;
+	yield* read(local.includes(id) ? here : yield* targetOf(ship.from), `ff_log=${quotePath(LOGS_DIR)}/${quote(`${id}.log`)}\nif [ -f "$ff_log" ]; then cat "$ff_log"; else echo ${MISSING}; fi`, (line) => {
+		if (line === MISSING) return sync(() => void (missing = true));
+		if (flags.machine !== void 0 && machineOf(line) !== flags.machine) return void_;
+		return log(line);
+	});
+	if (missing) return yield* fail$1(new LogsError(`no log for ${id} on ${ship.from}; a Machine keeps its last 20`));
+});
+const latestShip = fn("latestShip")(function* (local, self, targetOf) {
+	const newest = local.at(-1);
+	const config = getOrUndefined$1(yield* loadConfig(configPath(process.env)).pipe(option));
+	const from = config?.shippedFrom;
+	const at = Date.parse(config?.shippedAt ?? "");
+	const newestStarted = parseShipId(newest ?? "")?.started ?? -Infinity;
+	if (from !== void 0 && from !== self && at > newestStarted) {
+		const there = (yield* shipIds(yield* targetOf(from))).filter((id) => (parseShipId(id)?.started ?? Infinity) <= at).at(-1);
+		if (there === void 0) return yield* fail$1(new LogsError(`the last Ship to reach this Machine (from ${from} at ${config?.shippedAt}) has no log there`));
+		return there;
+	}
+	if (newest === void 0) return yield* fail$1(new LogsError("no Ship Log on this Machine yet"));
+	return newest;
+});
 //#endregion
 //#region ../../node_modules/.pnpm/react@19.3.0/node_modules/react/cjs/react.production.js
 /**
@@ -64268,27 +65016,27 @@ const decideInstall = (record, now, rebuild) => {
 const EngineFact = Union([
 	Struct({
 		fact: Literal("home"),
-		path: String$5
+		path: String$6
 	}),
 	Struct({ fact: Literal("end") }),
 	Struct({
 		fact: Literal("config"),
 		present: Boolean$4,
-		base64: optionalKey(String$5)
+		base64: optionalKey(String$6)
 	}),
 	Struct({
 		fact: Literal("record"),
-		provider: String$5,
-		item: String$5,
+		provider: String$6,
+		item: String$6,
 		record: Unknown
 	})
 ]);
-const ProviderFact = Struct({ provider: String$5 });
+const ProviderFact = Struct({ provider: String$6 });
 const AtFact = Struct({
-	provider: String$5,
+	provider: String$6,
 	fact: Literal("at"),
-	item: String$5,
-	at: String$5
+	item: String$6,
+	at: String$6
 });
 const decodeEngineFact = decodeUnknownOption(EngineFact);
 const decodeProviderFact = decodeUnknownOption(ProviderFact);
@@ -64358,18 +65106,18 @@ const Note = Struct({
 		"answer",
 		"info"
 	]),
-	text: String$5
+	text: String$6
 });
 const Item = Struct({
-	name: String$5,
+	name: String$6,
 	kind: Literals$2([
 		"range",
 		"record",
 		"config"
 	]),
-	from: optionalKey(String$5),
-	to: optionalKey(String$5),
-	reason: optionalKey(String$5),
+	from: optionalKey(String$6),
+	to: optionalKey(String$6),
+	reason: optionalKey(String$6),
 	changes: Boolean$4,
 	status: Literals$2([
 		"idle",
@@ -64378,18 +65126,18 @@ const Item = Struct({
 		"failed",
 		"skipped"
 	]),
-	doing: optionalKey(String$5),
-	detail: optionalKey(String$5),
-	output: optionalKey(ArraySchema(String$5)),
+	doing: optionalKey(String$6),
+	detail: optionalKey(String$6),
+	output: optionalKey(ArraySchema(String$6)),
 	steps: ArraySchema(Struct({
-		id: String$5,
-		doing: String$5
+		id: String$6,
+		doing: String$6
 	})),
 	started: optionalKey(Number$2),
 	ended: optionalKey(Number$2)
 });
 const MachineEntry = Struct({
-	name: String$5,
+	name: String$6,
 	status: Literals$2([
 		"checking",
 		"waiting",
@@ -64399,14 +65147,14 @@ const MachineEntry = Struct({
 		"skipped",
 		"failed"
 	]),
-	detail: optionalKey(String$5),
-	output: optionalKey(ArraySchema(String$5)),
+	detail: optionalKey(String$6),
+	output: optionalKey(ArraySchema(String$6)),
 	items: ArraySchema(Item),
 	started: optionalKey(Number$2),
 	ended: optionalKey(Number$2)
 });
 const LedgerState = Struct({
-	from: String$5,
+	from: String$6,
 	dryRun: Boolean$4,
 	notes: ArraySchema(Note),
 	machines: ArraySchema(MachineEntry),
@@ -64506,6 +65254,7 @@ const makeLedger = fn("makeLedger")(function* (input) {
 		},
 		tick: update((state) => state)
 	};
+	const log = (name, entry) => annotateLogs(entry, { machine: name });
 	return {
 		ledger: {
 			note: fn("ledger.note")(function* (kind, text) {
@@ -64520,39 +65269,43 @@ const makeLedger = fn("makeLedger")(function* (input) {
 					kind,
 					text
 				});
+				yield* logInfo(`${kind}: ${text}`);
 			}),
 			checked: (name) => machine(name, (m) => ({
 				...m,
 				status: "waiting"
-			})),
+			})).pipe(andThen(log(name, logInfo("checked")))),
 			skip: (name, reason) => machine(name, (m) => ({
 				...m,
 				status: "skipped",
 				detail: reason
-			})),
+			})).pipe(andThen(log(name, logWarning(`skipped: ${reason}`)))),
 			fail: (name, [reason = "failed", ...output]) => machine(name, (m, now) => ({
 				...m,
 				status: "failed",
 				detail: reason,
 				...output.length === 0 ? {} : { output },
 				ended: now
-			})),
+			})).pipe(andThen(log(name, logError(`failed: ${reason}`)))),
 			plan: (name, p) => machine(name, (m) => ({
 				...m,
 				status: "planned",
 				items: itemsOf(p)
-			})),
+			})).pipe(andThen(forEach$1(p.providers.flatMap((pp) => pp.decisions.map((d) => ({
+				pp,
+				d
+			}))), ({ pp, d }) => log(name, logInfo(`plan ${address(pp.name, d.item)}:`, d)), { discard: true }))),
 			start: (name) => machine(name, (m, now) => ({
 				...m,
 				status: "running",
 				started: now
-			})),
+			})).pipe(andThen(log(name, logInfo("applying")))),
 			stepStarted: (name, id) => items(name, id, (item, now) => item.status === "failed" || item.status === "skipped" ? item : {
 				...item,
 				status: "running",
 				doing: item.steps.find((step) => step.id === id)?.doing ?? "running",
 				started: item.started ?? now
-			}),
+			}).pipe(andThen(log(name, logInfo(`step ${id}`)))),
 			stepDone: (name, id, result) => items(name, id, (item, now) => {
 				if (item.status === "failed" || item.status === "skipped") return item;
 				if (!result.ok) return {
@@ -64570,7 +65323,7 @@ const makeLedger = fn("makeLedger")(function* (input) {
 					status: "ok",
 					ended: now
 				};
-			}),
+			}).pipe(andThen(log(name, result.ok ? logInfo(`step ${id}: done`) : logWarning(`step ${id}: ${result.detail}`)))),
 			stepSkipped: (name, id, reason) => items(name, id, (item, now) => {
 				if (item.status === "failed") return item;
 				const { doing: _, ...rest } = item;
@@ -64580,7 +65333,7 @@ const makeLedger = fn("makeLedger")(function* (input) {
 					detail: reason,
 					ended: now
 				};
-			}),
+			}).pipe(andThen(log(name, logInfo(`step ${id}: skipped, ${reason}`)))),
 			reached: (name, item, at) => machine(name, (m) => ({
 				...m,
 				items: m.items.map((i) => i.name !== item ? i : {
@@ -64588,12 +65341,12 @@ const makeLedger = fn("makeLedger")(function* (input) {
 					to: at,
 					changes: i.status === "failed" || i.from !== at
 				})
-			})),
+			})).pipe(andThen(log(name, logInfo(`${item} reached ${at}`)))),
 			finish: (name, outcome) => machine(name, (m, now) => ({
 				...m,
 				status: m.status === "failed" ? "failed" : outcome,
 				ended: m.ended ?? now
-			})),
+			})).pipe(andThen(log(name, logInfo(`finished: ${outcome}`)))),
 			end: gen(function* () {
 				yield* update((state, now) => ({
 					...state,
@@ -66943,6 +67696,10 @@ const ledgerText = (state, options, color) => toText(/* @__PURE__ */ (0, import_
 	...options
 }), color);
 const noteText = (note, color) => toText(/* @__PURE__ */ (0, import_jsx_runtime.jsx)(NoteLine, { note }), color);
+const hintText = (text, color) => toText(/* @__PURE__ */ (0, import_jsx_runtime.jsx)(T, {
+	tone: "dim",
+	children: text
+}), color);
 //#endregion
 //#region src/report.tsx
 const reportPath = () => `${STATE_DIR.replace(/^~/, process.env.HOME ?? "~")}/last-ship.json`;
@@ -66984,7 +67741,7 @@ const report = fn("report")(function* () {
 });
 const decodeFact$2 = decodeUnknownOption(Union([Struct({
 	fact: Literal("brew"),
-	version: NullOr(String$5)
+	version: NullOr(String$6)
 }), AtFact]));
 const NO_BREW = "Homebrew is not installed; install it first";
 function homebrew(name) {
@@ -67114,28 +67871,28 @@ const cask = homebrew("cask");
 const decodeFact$1 = decodeUnknownOption(Union([
 	Struct({
 		fact: Literal("cloneRoot"),
-		path: String$5,
+		path: String$6,
 		present: Boolean$4
 	}),
 	Struct({
 		fact: Literal("repo"),
-		name: String$5,
+		name: String$6,
 		present: Boolean$4,
-		head: optionalKey(String$5),
-		origin: optionalKey(String$5)
+		head: optionalKey(String$6),
+		origin: optionalKey(String$6)
 	}),
 	Struct({
 		fact: Literal("output"),
-		repo: String$5,
-		path: String$5,
-		fingerprint: NullOr(String$5)
+		repo: String$6,
+		path: String$6,
+		fingerprint: NullOr(String$6)
 	})
 ]));
 const decodeRecord = decodeUnknownOption(Struct({
-	commit: String$5,
-	path: String$5,
-	install: String$5,
-	outputs: Record(String$5, String$5)
+	commit: String$6,
+	path: String$6,
+	install: String$6,
+	outputs: Record(String$6, String$6)
 }));
 const branchKey = (repo) => `${repo.origin}#${repo.ref}`;
 const cloneRoot = (config, machine) => {
@@ -67145,7 +67902,7 @@ const cloneRoot = (config, machine) => {
 const originUrl = (origin) => `https://github.com/${origin}.git`;
 const short = (commit) => commit.slice(0, 7);
 const expandHome = (path, home) => path === "~" ? home : path.startsWith("~/") ? `${home}${path.slice(1)}` : path;
-const jsonString = encodeSync(fromJsonString(String$5));
+const jsonString = encodeSync(fromJsonString(String$6));
 const lsRemote = fn("lsRemote")(function* (repo, token) {
 	const spawner = yield* ChildProcessSpawner;
 	const auth = token === void 0 ? [] : [
@@ -67155,7 +67912,7 @@ const lsRemote = fn("lsRemote")(function* (repo, token) {
 		"credential.helper=!f() { echo username=x-access-token; echo \"password=$FF_TOKEN\"; }; f"
 	];
 	return yield* scoped(gen(function* () {
-		const handle = yield* spawner.spawn(make$12("git", [
+		const handle = yield* spawner.spawn(make$13("git", [
 			...auth,
 			"ls-remote",
 			originUrl(repo.origin),
@@ -67372,20 +68129,20 @@ const TOOL_PACKAGES = {
 	bun: ["bun"]
 };
 const GlobalEntry = Struct({
-	name: String$5,
-	version: String$5,
-	platform: optionalKey(Struct({ node: optionalKey(String$5) }))
+	name: String$6,
+	version: String$6,
+	platform: optionalKey(Struct({ node: optionalKey(String$6) }))
 });
 const decodeFact = decodeUnknownOption(Union([
 	Struct({
 		fact: Literal("vp"),
-		version: NullOr(String$5),
-		path: optionalKey(String$5)
+		version: NullOr(String$6),
+		path: optionalKey(String$6)
 	}),
 	Struct({
 		fact: Literal("default"),
-		tool: String$5,
-		version: String$5
+		tool: String$6,
+		version: String$6
 	}),
 	Struct({
 		fact: Literal("mode"),
@@ -67799,14 +68556,18 @@ const canRedraw = () => Boolean(process.stdout.isTTY) && process.env.TERM !== "d
 const decodeAt = decodeUnknownOption(AtFact);
 const runOn = fn("runOn")(function* (target, script, secrets, onLine, ledger) {
 	let first;
+	yield* logDebug(`script:\n${script}`);
+	const started = yield* currentTimeMillis;
 	const run = yield* runScript(target, script, secrets, (line) => {
 		const parsed = parseLine(line);
 		if (parsed.kind === "text" && first === void 0 && line.trim() !== "") first = line.trim();
-		return onLine(parsed);
+		return logDebug(`> ${line}`).pipe(andThen(onLine(parsed)));
 	}).pipe(map$5((exitCode) => ({
 		kind: "ran",
 		exitCode
 	})), catch_((e) => ledger.fail(target.name, [e.message]).pipe(as({ kind: "failed" }))));
+	const ended = yield* currentTimeMillis;
+	yield* logInfo(`${run.kind === "ran" ? `exit ${run.exitCode}` : "could not start"} after ${duration(ended - started)}`);
 	if (!target.local && run.kind === "ran" && run.exitCode === 255) {
 		yield* ledger.skip(target.name, `ssh: ${first?.replace(/^tailscale: /, "") ?? "connection failed"}`);
 		return { kind: "skipped" };
@@ -68003,9 +68764,19 @@ const staleConfigs = fn("staleConfigs")(function* (config, own, checked, ledger)
 });
 const schemaJson = encodeSync(fromJsonString(Unknown, { space: 2 }));
 const ship = fn("ship")(function* (flags) {
-	while ((yield* shipPass(flags)) === "adopted");
-});
-const shipPass = fn("shipPass")(function* (flags) {
+	const tailnet = yield* readTailnet();
+	const id = shipId(yield* now, tailnet.self.name);
+	const hidden = /* @__PURE__ */ new Set();
+	const logger = yield* openShipLog(id, hidden).pipe(catch_((e) => error(`could not open the Ship Log: ${e.message}`).pipe(as(void 0))));
+	if (logger !== void 0) yield* addFinalizer(() => log(hintText(`log: fizz logs ${id}`)));
+	yield* gen(function* () {
+		yield* logInfo(`Ship ${id}: fleetfizz ${flags.version}, node ${process.version} on ${process.platform}`);
+		yield* logInfo(`fizz ${process.argv.slice(2).join(" ")}`);
+		for (const m of tailnet.fleet) yield* logInfo(`tailnet: ${m.name} ${m.platform}${m.online ? "" : " offline"}${m.ssh ? "" : " no-ssh"}${m.name === tailnet.self.name ? " (this Machine)" : ""}`);
+		while ((yield* shipPass(flags, tailnet, hidden)) === "adopted");
+	}).pipe(onExit((exit) => isSuccess(exit) ? logInfo("the Ship ended") : logError("the Ship stopped", exit.cause)), provide(layer$1(logger === void 0 ? [] : [logger])), provideService(MinimumLogLevel, "Debug"));
+}, scoped);
+const shipPass = fn("shipPass")(function* (flags, tailnet, hidden) {
 	const fs = yield* FileSystem;
 	const parsed = parseAnswers(flags.answers);
 	if ("invalid" in parsed) return yield* fail$1(new ShipError(parsed.invalid));
@@ -68014,10 +68785,11 @@ const shipPass = fn("shipPass")(function* (flags) {
 	if (notAddress !== void 0) return yield* fail$1(new ShipError(`--rebuild ${notAddress}: expected a record Item (repos:<name>) or all`));
 	const path = flags.config ?? configPath(process.env);
 	const config = yield* loadConfig(path);
+	yield* logInfo(`config ${path}`);
+	yield* logDebug(yield* fs.readFileString(path));
 	const ordered = orderProviders(PROVIDERS, (p) => dependenciesOf(p, config));
 	if ("cycle" in ordered) return yield* fail$1(new ShipError(`dependsOn cycle: ${ordered.cycle.join(" → ")}`));
 	const providers = ordered.order;
-	const tailnet = yield* readTailnet();
 	const problem = unshippable(config, tailnet, flags.only, path);
 	if (problem !== void 0) return yield* fail$1(new ShipError(problem));
 	const fleet = new Set(config.machines);
@@ -68025,6 +68797,7 @@ const shipPass = fn("shipPass")(function* (flags) {
 	const order = config.machines;
 	const targetsList = tailnet.fleet.filter((m) => fleet.has(m.name) && (flags.only.length === 0 || flags.only.includes(m.name))).toSorted((a, b) => order.indexOf(a.name) - order.indexOf(b.name));
 	const count = `${targetsList.length} machine${targetsList.length === 1 ? "" : "s"}`;
+	yield* logInfo(`${flags.dryRun ? "dry run, " : ""}targets: ${targetsList.map((m) => m.name).join(", ")}`);
 	yield* log(`${flags.dryRun ? "dry run, " : ""}${count} from ${tailnet.self.name}`);
 	const color = colorful();
 	const { ledger, store } = yield* makeLedger({
@@ -68087,7 +68860,10 @@ const shipPass = fn("shipPass")(function* (flags) {
 			local,
 			state: result.state
 		};
-	}), { concurrency: "unbounded" }).pipe(map$5((list) => list.filter((g) => g !== void 0)));
+	}, (effect, machine) => annotateLogs(effect, {
+		machine: machine.name,
+		phase: "check"
+	})), { concurrency: "unbounded" }).pipe(map$5((list) => list.filter((g) => g !== void 0)));
 	const stale = yield* staleConfigs(config, own, checked, ledger);
 	if (stale.length > 0) {
 		const what = `newer config on ${stale.map((s) => s.description).join(", ")}`;
@@ -68136,6 +68912,8 @@ const shipPass = fn("shipPass")(function* (flags) {
 		items: checked.flatMap(({ machine }) => targetedItems(provider, config, machine))
 	}));
 	const lent = targeted.some(({ provider, items }) => provider.name === "repos" && items.length > 0) ? yield* readLentToken() : { token: void 0 };
+	if (lent.token !== void 0) hidden.add(lent.token);
+	yield* logInfo(lent.token !== void 0 ? "gh token: lent" : `gh token: none (${lent.reason ?? "no repos"})`);
 	if (lent.token === void 0 && lent.reason !== void 0) yield* ledger.note("info", `no gh token (${lent.reason}); private repos will fail`);
 	const resolved = Object.fromEntries(yield* forEach$1(targeted, ({ provider, items }) => provider.resolve(items, lent.token === void 0 ? {} : { token: lent.token }).pipe(map$5((r) => [provider.name, r])), { concurrency: "unbounded" }));
 	const planAll = (cfg, answer) => checked.map((g) => ({
@@ -68201,6 +68979,7 @@ const shipPass = fn("shipPass")(function* (flags) {
 	});
 	const stamped = stampWith(planned.map((g) => g.machine.name));
 	yield* fs.writeFileString(path, stamped);
+	yield* logInfo(`stamped the config: shippedAt ${shippedAt}`);
 	const schema = `${schemaJson(fleetConfigJsonSchema())}\n`;
 	const stdin = applyStdin(lent.token, stamped, schema);
 	const delivered = yield* forEach$1(planned, fn("applyOne")(function* ({ machine, local, plan: p }) {
@@ -68208,12 +68987,20 @@ const shipPass = fn("shipPass")(function* (flags) {
 			name: machine.name,
 			local
 		}, p, applyScript(p), stdin, ledger)).done.includes("config") ? machine.name : void 0;
-	}), { concurrency: "unbounded" }).pipe(map$5((list) => list.filter((name) => name !== void 0)));
+	}, (effect, { machine }) => annotateLogs(effect, {
+		machine: machine.name,
+		phase: "apply"
+	})), { concurrency: "unbounded" }).pipe(map$5((list) => list.filter((name) => name !== void 0)));
+	yield* logInfo(`the config reached: ${delivered.join(", ")}`);
 	yield* fs.writeFileString(path, stampWith(delivered));
 }, scoped);
 //#endregion
 //#region src/command.ts
-const shipCommand = make("ship", {
+const printProblems = (effect) => effect.pipe(catch_((e) => gen(function* () {
+	yield* error(e.message);
+	process.exitCode = 1;
+})));
+const shipCommand = make$1("ship", {
 	dryRun: Boolean$1("dry-run").pipe(withDefault(false), withDescription$1("Check and plan only. Print every Machine's plan and change nothing.")),
 	only: String$1("only").pipe(atLeast(0), withMetavar("machine"), withDescription$1("Ship only to this Machine. Repeat the flag for more.")),
 	rebuild: String$1("rebuild").pipe(atLeast(0), withMetavar("item"), withDescription$1("Rebuild a record Item (`repos:<name>`) even when it is up to date. `all` for every one.")),
@@ -68232,15 +69019,25 @@ const shipCommand = make("ship", {
 		...flags.enforce ? ["range=downgrade"] : [],
 		...flags.overwriteConfig ? ["config=overwrite"] : []
 	],
-	config: flags.config._tag === "Some" ? flags.config.value : void 0,
+	config: getOrUndefined$1(flags.config),
 	version
-}).pipe(catch_((e) => gen(function* () {
-	yield* error(e.message);
-	process.exitCode = 1;
-})))));
-const reportCommand = make("report", {}).pipe(withDescription("Print the full Ledger of the last Ship from this Machine."), withHandler(() => report()));
+}).pipe(printProblems)));
+const reportCommand = make$1("report", {}).pipe(withDescription("Print the full Ledger of the last Ship from this Machine."), withHandler(() => report()));
+const logsCommand = make$1("logs", {
+	ship: String$2("ship").pipe(optional$1, withDescription$2("The Ship id, printed at the end of every Ship.")),
+	machine: String$1("machine").pipe(optional, withMetavar("machine"), withDescription$1("Print only this Machine's lines.")),
+	list: Boolean$1("list").pipe(withDefault(false), withDescription$1(`List the Ships started here whose logs this Machine keeps (its last 20).`))
+}).pipe(withDescription("Print the Ship Log of a Ship: every script, every line each Machine printed, and every decision. Without a Ship id, the latest Ship that started on or reached this Machine, read over tailscale ssh when another Machine started it."), withHandler((flags) => logs({
+	id: getOrUndefined$1(flags.ship),
+	machine: getOrUndefined$1(flags.machine),
+	list: flags.list
+}).pipe(printProblems)));
 //#endregion
 //#region src/bin.ts
-run(make("fizz").pipe(withDescription("Keep every Machine on your tailnet in line with one config."), withSubcommands([shipCommand, reportCommand])), { version }).pipe(provide(layer$1), runMain);
+run(make$1("fizz").pipe(withDescription("Keep every Machine on your tailnet in line with one config."), withSubcommands([
+	shipCommand,
+	reportCommand,
+	logsCommand
+])), { version }).pipe(provide(layer$2), runMain);
 //#endregion
 export {};