@mysten-incubation/devstack 0.0.1 → 0.1.0

package/dist/cli/main.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"main.mjs","names":["resolvePath","m"],"sources":["../../src/cli/main.ts"],"sourcesContent":["// devstack CLI bin entry — argv → dispatch → exit.\n//\n// This file is the executable entry the `bin: { devstack: ... }`\n// package.json field points at. Build output: `dist/cli/main.mjs`.\n//\n// Architecture invariant (surfaces/cli/index.ts header):\n//   \"`up` must hand its long-running effect to the outer Node runtime\n//    directly, not nest a runtime — otherwise SIGINT cannot reach\n//    scope finalizers and container teardown leaks.\"\n//\n// Shape:\n//   1. The Stricli-backed dispatcher validates argv and builds command-\n//      scoped flags.\n//   2. Attached `up` constructs substrate Layers directly so signals\n//      reach scope finalizers.\n//   3. `apply` is live-aware: publish to an attached supervisor when\n//      one owns the selected stack; otherwise run the one-shot path.\n//   4. Offline/direct commands read or mutate the selected stack root\n//      without publishing peer commands to a live supervisor.\n\nimport { existsSync, realpathSync } from 'node:fs';\nimport { dirname, isAbsolute, resolve as resolvePath } from 'node:path';\nimport { fileURLToPath, pathToFileURL } from 'node:url';\n\nimport {\n\tCause,\n\tEffect,\n\tExit,\n\tFileSystem,\n\tLayer,\n\tLogger,\n\tQueue,\n\tScope,\n\tStream,\n\tSubscriptionRef,\n} from 'effect';\n\nimport { appName, chainId, stackName } from '../substrate/brand.ts';\nimport type { Identity } from '../substrate/identity.ts';\nimport type { EngineCommand, EngineEvent } from '../substrate/events.ts';\nimport type { SubscribableState } from '../substrate/projection.ts';\nimport { StackPathsService } from '../substrate/runtime/paths.ts';\nimport {\n\tmakeProjectionRef,\n\tpersistProjectionChanges,\n\treadProjectionSnapshot,\n\tclaim,\n\tcommandChannelPaths,\n\theartbeatFiber,\n\tmakeCommandChannelPublisher,\n\tmakeCommandChannelSubscriber,\n\trelease,\n\ttype SupervisedStack,\n\ttype SupervisorCommandHandler,\n\ttype SupervisorHandle,\n\twriteProjectionSnapshot,\n} from '../substrate/runtime/index.ts';\nimport { buildSubstrateLayers, superviseStackEffect } from '../substrate/runtime/run.ts';\n\nimport {\n\tdispatch,\n\ttype CliDeps,\n\tCliConfigInvalidError,\n\tCliConfigNotFoundError,\n\tCliSupervisorLiveError,\n} from '../surfaces/cli/index.ts';\nimport { defaultProbes, probeSupervisorPresence } from '../surfaces/cli/commands/index.ts';\nimport { nodeConfirmPrompt } from '../surfaces/cli/commands/confirm-node.ts';\nimport type { LoadedConfig } from '../surfaces/cli/commands/config-loader.ts';\nimport {\n\tSnapshotOrchestratorService,\n\ttype RestoreParticipant,\n\ttype SnapshotMetadata,\n} from '../orchestrators/snapshot/index.ts';\nimport {\n\tbuildProductionOrchestratorSinks,\n\tbuildProductionPostAcquireHook,\n\tlayerProductionOrchestrators,\n} from '../orchestrators/runtime-composition.ts';\nimport {\n\textendBuiltInPluginContext,\n\tlayerBuiltInPluginRuntime,\n} from '../runtime/built-in-plugin-layers.ts';\nimport type { StatusReader } from '../surfaces/cli/commands/status.ts';\nimport type { GlobalFlags } from '../surfaces/cli/flags.ts';\nimport { ExitCode } from '../surfaces/cli/sysexits.ts';\nimport { makeTuiSurface } from '../surfaces/tui/index.ts';\nimport { makeSnapshotReader } from './snapshot-reader.ts';\nimport { makeQueueCommandPublisher, resolveUpRendererMode } from './up-lifecycle.ts';\nimport { resolveAppName, resolveStackName } from '../api/inference-network.ts';\nimport { readStackEngine, type Stack } from '../api/define-devstack.ts';\nimport { makeDirectPruneDeps } from './prune-direct.ts';\nimport { removeRouterDispatchFilesForStack } from '../orchestrators/router/cleanup.ts';\n\n// -----------------------------------------------------------------------------\n// Config loader (default-export = Stack)\n// -----------------------------------------------------------------------------\n\nconst DEFAULT_CONFIG_PATH = './devstack.config.ts';\nconst LIVE_APPLY_ACK_TIMEOUT_MILLIS = 10 * 60 * 1000;\n\nconst stackRootFor = (runtimeRoot: string, stack: string): string =>\n\tresolvePath(runtimeRoot, 'stacks', stack);\n\nconst rosterPathsFor = (stackRoot: string) => ({\n\tstackLockFile: resolvePath(stackRoot, 'stack.lock'),\n\trosterFile: resolvePath(stackRoot, 'roster.json'),\n});\n\nconst ENGINE_COMMAND_TAGS = new Set<EngineCommand['tag']>([\n\t'stack.start',\n\t'stack.stop',\n\t'stack.restart',\n\t'apply.requested',\n\t'codegen.requested',\n\t'snapshot.capture',\n\t'snapshot.restore',\n\t'snapshot.list',\n\t'snapshot.delete',\n\t'wipe.requested',\n\t'prune.requested',\n\t'advance-clock.requested',\n\t'shutdown.requested',\n\t'shutdown.hardKillRequested',\n\t'selective-restart.requested',\n]);\n\nconst hasString = (value: Record<string, unknown>, key: string): boolean =>\n\ttypeof value[key] === 'string';\n\nconst isEngineCommand = (value: unknown): value is EngineCommand => {\n\tif (typeof value !== 'object' || value === null) return false;\n\tconst record = value as Record<string, unknown>;\n\tif (\n\t\ttypeof record.tag !== 'string' ||\n\t\t!ENGINE_COMMAND_TAGS.has(record.tag as EngineCommand['tag'])\n\t) {\n\t\treturn false;\n\t}\n\tswitch (record.tag) {\n\t\tcase 'snapshot.restore':\n\t\tcase 'snapshot.delete':\n\t\t\treturn hasString(record, 'snapshotId');\n\t\tcase 'advance-clock.requested':\n\t\t\treturn typeof record.toMillis === 'number';\n\t\tcase 'shutdown.hardKillRequested':\n\t\t\treturn (\n\t\t\t\t(record.signal === 'SIGINT' || record.signal === 'SIGTERM') &&\n\t\t\t\ttypeof record.exitCode === 'number' &&\n\t\t\t\ttypeof record.at === 'number'\n\t\t\t);\n\t\tcase 'selective-restart.requested':\n\t\t\treturn hasString(record, 'pluginKey');\n\t\tcase 'apply.requested':\n\t\t\treturn record.pluginKey === undefined || typeof record.pluginKey === 'string';\n\t\tcase 'snapshot.capture':\n\t\t\treturn (\n\t\t\t\t(record.snapshotId === undefined || typeof record.snapshotId === 'string') &&\n\t\t\t\t(record.name === undefined || typeof record.name === 'string')\n\t\t\t);\n\t\tdefault:\n\t\t\treturn true;\n\t}\n};\n\nconst findCliSupervisorLiveError = (cause: Cause.Cause<unknown>): CliSupervisorLiveError | null => {\n\tfor (const reason of cause.reasons) {\n\t\tif (!Cause.isFailReason(reason)) continue;\n\t\tconst error = reason.error;\n\t\tif (error instanceof CliSupervisorLiveError) return error;\n\t\tif (\n\t\t\ttypeof error === 'object' &&\n\t\t\terror !== null &&\n\t\t\t(error as { readonly _tag?: unknown })._tag === 'CliSupervisorLiveError'\n\t\t) {\n\t\t\treturn error as CliSupervisorLiveError;\n\t\t}\n\t}\n\treturn null;\n};\n\nconst resolveConfigPath = (configPath: string | undefined): string | null => {\n\tconst target = configPath ?? DEFAULT_CONFIG_PATH;\n\tconst explicit = isAbsolute(target) ? target : resolvePath(process.cwd(), target);\n\tif (existsSync(explicit)) return explicit;\n\tif (configPath !== undefined && configPath !== DEFAULT_CONFIG_PATH) return null;\n\tlet dir = process.cwd();\n\tfor (;;) {\n\t\tconst candidate = resolvePath(dir, 'devstack.config.ts');\n\t\tif (existsSync(candidate)) return candidate;\n\t\tconst parent = resolvePath(dir, '..');\n\t\tif (parent === dir) return null;\n\t\tdir = parent;\n\t}\n};\n\ninterface RawConfigModule {\n\treadonly default?: unknown;\n}\n\nconst validateStackModule = (\n\tresolvedConfigPath: string,\n\tmod: unknown,\n): LoadedConfig & { readonly stack: SupervisedStack } => {\n\tconst m = mod as RawConfigModule;\n\tconst def = m.default;\n\tif (def === null || typeof def !== 'object' || (def as { _tag?: unknown })._tag !== 'Stack') {\n\t\tthrow new CliConfigInvalidError({\n\t\t\tmessage: `config at ${resolvedConfigPath} does not default-export a Stack value (got _tag=${String((def as { _tag?: unknown })?._tag)})`,\n\t\t});\n\t}\n\tlet stack: SupervisedStack;\n\ttry {\n\t\tstack = readStackEngine(def as Stack<SupervisedStack['members']>);\n\t} catch (cause) {\n\t\tthrow new CliConfigInvalidError({\n\t\t\tmessage: `config at ${resolvedConfigPath} default-exported an invalid Stack handle: ${cause instanceof Error ? cause.message : String(cause)}`,\n\t\t});\n\t}\n\treturn {\n\t\tstack,\n\t\tresolvedConfigPath,\n\t};\n};\n\nconst makeConfigLoader = () => ({\n\tload: (configPath: string | undefined) =>\n\t\tEffect.gen(function* () {\n\t\t\tconst abs = resolveConfigPath(configPath);\n\t\t\tif (abs === null) {\n\t\t\t\tconst attempted =\n\t\t\t\t\tconfigPath !== undefined\n\t\t\t\t\t\t? resolvePath(process.cwd(), configPath)\n\t\t\t\t\t\t: resolvePath(process.cwd(), DEFAULT_CONFIG_PATH);\n\t\t\t\treturn yield* Effect.fail(\n\t\t\t\t\tnew CliConfigNotFoundError({\n\t\t\t\t\t\tmessage: `devstack config not found at ${attempted}`,\n\t\t\t\t\t\tsearchedPaths: [attempted],\n\t\t\t\t\t}),\n\t\t\t\t);\n\t\t\t}\n\t\t\tconst url = pathToFileURL(abs).href;\n\t\t\tconst mod = yield* Effect.tryPromise({\n\t\t\t\ttry: () => import(url) as Promise<unknown>,\n\t\t\t\tcatch: (cause) =>\n\t\t\t\t\tnew CliConfigInvalidError({\n\t\t\t\t\t\tmessage: `failed to import ${abs}: ${cause instanceof Error ? cause.message : String(cause)}`,\n\t\t\t\t\t\tcause,\n\t\t\t\t\t}),\n\t\t\t});\n\t\t\treturn yield* Effect.try({\n\t\t\t\ttry: () => validateStackModule(abs, mod),\n\t\t\t\tcatch: (cause) =>\n\t\t\t\t\tcause instanceof CliConfigInvalidError\n\t\t\t\t\t\t? cause\n\t\t\t\t\t\t: new CliConfigInvalidError({\n\t\t\t\t\t\t\t\tmessage: `invalid config at ${abs}`,\n\t\t\t\t\t\t\t\tcause,\n\t\t\t\t\t\t\t}),\n\t\t\t});\n\t\t}) as Effect.Effect<LoadedConfig, CliConfigNotFoundError | CliConfigInvalidError>,\n});\n\n// -----------------------------------------------------------------------------\n// Identity resolution\n// -----------------------------------------------------------------------------\n\ninterface ResolvedIdentity {\n\treadonly app: string;\n\treadonly stack: string;\n\treadonly network: string;\n\treadonly runtimeRoot: string;\n\treadonly stacksRoot: string;\n\treadonly stackRoot: string;\n\treadonly rosterFile: string;\n}\n\n/** Resolve identity from flags + env. App and stack fall through the\n *  shared cwd/package metadata resolver before their defaults. */\nconst resolveIdentity = (params: {\n\treadonly app: string | undefined;\n\treadonly stack: string | undefined;\n\treadonly network: string | undefined;\n\treadonly stateDir: string | undefined;\n\treadonly cwd?: string;\n}): ResolvedIdentity => {\n\tconst cwd = params.cwd ?? process.cwd();\n\tconst app = resolveAppName({\n\t\texplicit: params.app,\n\t\tcwd,\n\t});\n\tconst stateDir =\n\t\tparams.stateDir ??\n\t\tprocess.env.DEVSTACK_STATE_DIR ??\n\t\tresolvePath(process.env.HOME ?? process.cwd(), '.devstack');\n\tconst runtimeRoot = resolvePath(stateDir);\n\tconst stacksRoot = resolvePath(runtimeRoot, 'stacks');\n\tconst stack = resolveStackName({\n\t\texplicit: params.stack,\n\t\tcwd,\n\t});\n\tconst network = params.network ?? process.env.DEVSTACK_NETWORK ?? 'sui:local';\n\tconst stackRoot = resolvePath(stacksRoot, stack);\n\treturn {\n\t\tapp,\n\t\tstack,\n\t\tnetwork,\n\t\truntimeRoot,\n\t\tstacksRoot,\n\t\tstackRoot,\n\t\trosterFile: resolvePath(stackRoot, 'roster.json'),\n\t};\n};\n\n// -----------------------------------------------------------------------------\n// Verb deps composition (attached + direct/offline)\n// -----------------------------------------------------------------------------\n\nconst projectionStatusReader = (identity: ResolvedIdentity): StatusReader => ({\n\treadState: (_app, _stack) =>\n\t\tEffect.sync(() => readProjectionSnapshot(identity.stackRoot) as SubscribableState | null),\n});\n\nconst commandResultFromProcess = (): { readonly exitCode: number } => ({\n\texitCode: typeof process.exitCode === 'number' ? process.exitCode : 0,\n});\n\nconst buildDirectDeps = (identity: ResolvedIdentity): CliDeps => {\n\tconst loader = makeConfigLoader();\n\treturn {\n\t\tup: {\n\t\t\trun: (flags) =>\n\t\t\t\trunUpLive(flags.configPath, identity, {\n\t\t\t\t\trenderer: flags.renderer,\n\t\t\t\t\tstdoutIsTty: Boolean((process.stdout as { isTTY?: boolean }).isTTY),\n\t\t\t\t}).pipe(Effect.map(() => commandResultFromProcess())),\n\t\t},\n\t\tapply: {\n\t\t\trun: (flags) =>\n\t\t\t\trunApplyLive(flags.configPath, identity).pipe(Effect.map(() => commandResultFromProcess())),\n\t\t},\n\t\tstatus: { reader: projectionStatusReader(identity) },\n\t\tsnapshot: makeDirectSnapshotDeps(identity),\n\t\tprune: makeDirectPruneDeps({ runtimeRoot: identity.runtimeRoot }),\n\t\tdoctor: {\n\t\t\tprobes: defaultProbes({\n\t\t\t\tstateDir: identity.runtimeRoot,\n\t\t\t\tappRoot: identity.stacksRoot,\n\t\t\t}),\n\t\t},\n\t\tconfig: { loader },\n\t\twipe: {\n\t\t\twipe: () => runWipeDirect(identity),\n\t\t\tconfirm: nodeConfirmPrompt,\n\t\t},\n\t};\n};\n\n// -----------------------------------------------------------------------------\n// `up` — live wiring\n// -----------------------------------------------------------------------------\n\nconst makeSnapshotCommandHandler = (params: {\n\treadonly snapshot: import('../orchestrators/snapshot/index.ts').SnapshotOrchestrator;\n\treadonly fs: FileSystem.FileSystem;\n}): SupervisorCommandHandler => {\n\tconst provideFileSystem = <A, E>(\n\t\teffect: Effect.Effect<A, E, FileSystem.FileSystem>,\n\t): Effect.Effect<A, E, never> =>\n\t\teffect.pipe(Effect.provideService(FileSystem.FileSystem, params.fs));\n\n\treturn (cmd, handlerCtx) => {\n\t\tswitch (cmd.tag) {\n\t\t\tcase 'snapshot.capture':\n\t\t\t\treturn provideFileSystem(\n\t\t\t\t\tparams.snapshot.capture({\n\t\t\t\t\t\tid: cmd.snapshotId,\n\t\t\t\t\t\tlabel: cmd.name,\n\t\t\t\t\t\tonProgress: (progress) =>\n\t\t\t\t\t\t\thandlerCtx.publish({\n\t\t\t\t\t\t\t\ttag: 'snapshot.captureProgress',\n\t\t\t\t\t\t\t\t...(cmd.snapshotId === undefined ? {} : { snapshotId: cmd.snapshotId }),\n\t\t\t\t\t\t\t\t...(cmd.name === undefined ? {} : { name: cmd.name }),\n\t\t\t\t\t\t\t\tphase: progress.phase,\n\t\t\t\t\t\t\t\t...(progress.detail === undefined ? {} : { detail: progress.detail }),\n\t\t\t\t\t\t\t\t...(progress.pausedContainers === undefined\n\t\t\t\t\t\t\t\t\t? {}\n\t\t\t\t\t\t\t\t\t: { pausedContainers: progress.pausedContainers }),\n\t\t\t\t\t\t\t\t...(progress.totalContainers === undefined\n\t\t\t\t\t\t\t\t\t? {}\n\t\t\t\t\t\t\t\t\t: { totalContainers: progress.totalContainers }),\n\t\t\t\t\t\t\t\tat: Date.now(),\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t}),\n\t\t\t\t).pipe(\n\t\t\t\t\tEffect.map((meta) => [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\ttag: 'snapshot.captured',\n\t\t\t\t\t\t\tsnapshotId: meta.id,\n\t\t\t\t\t\t\t...(meta.label === null ? {} : { name: meta.label }),\n\t\t\t\t\t\t\tat: Date.now(),\n\t\t\t\t\t\t},\n\t\t\t\t\t]),\n\t\t\t\t);\n\t\t\tcase 'snapshot.restore':\n\t\t\t\treturn provideFileSystem(params.snapshot.restore({ id: cmd.snapshotId })).pipe(\n\t\t\t\t\tEffect.map((meta) => [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\ttag: 'snapshot.restored',\n\t\t\t\t\t\t\tsnapshotId: meta.id,\n\t\t\t\t\t\t\tat: Date.now(),\n\t\t\t\t\t\t},\n\t\t\t\t\t]),\n\t\t\t\t);\n\t\t\tcase 'snapshot.list':\n\t\t\t\treturn provideFileSystem(params.snapshot.list).pipe(Effect.as([]));\n\t\t\tcase 'snapshot.delete':\n\t\t\t\treturn provideFileSystem(params.snapshot.delete(cmd.snapshotId)).pipe(Effect.as([]));\n\t\t\tcase 'wipe.requested':\n\t\t\t\treturn provideFileSystem(params.snapshot.wipe({})).pipe(Effect.as([]));\n\t\t\tcase 'prune.requested':\n\t\t\t\treturn provideFileSystem(params.snapshot.prune({})).pipe(Effect.as([]));\n\t\t\tdefault:\n\t\t\t\treturn Effect.succeed([]);\n\t\t}\n\t};\n};\n\nconst installLiveSupervisorRoster = (params: {\n\treadonly stackRoot: string;\n\treadonly app: string;\n\treadonly stack: string;\n}): Effect.Effect<void, unknown, Scope.Scope> =>\n\tEffect.gen(function* () {\n\t\tconst paths = rosterPathsFor(params.stackRoot);\n\t\tconst claimed = yield* claim(paths);\n\t\tif (!claimed.soleHolder) {\n\t\t\tyield* release(paths).pipe(Effect.catch(() => Effect.void));\n\t\t\treturn yield* Effect.fail(\n\t\t\t\tnew CliSupervisorLiveError({\n\t\t\t\t\tapp: params.app,\n\t\t\t\t\tstack: params.stack,\n\t\t\t\t\thint: 'use `devstack apply` from another shell, or choose a different --stack name',\n\t\t\t\t}),\n\t\t\t);\n\t\t}\n\t\tyield* Effect.addFinalizer(() => release(paths).pipe(Effect.catch(() => Effect.void)));\n\t\tyield* Effect.forkScoped(heartbeatFiber(paths));\n\t});\n\nconst installCommandChannelBridge = (params: {\n\treadonly stackRoot: string;\n\treadonly handle: SupervisorHandle;\n}): Effect.Effect<\n\t{\n\t\treadonly publishEvent: (event: EngineEvent) => Effect.Effect<void>;\n\t},\n\tunknown,\n\tScope.Scope\n> =>\n\tEffect.gen(function* () {\n\t\tconst subscriber = yield* makeCommandChannelSubscriber(commandChannelPaths(params.stackRoot), {\n\t\t\tfromOffset: 'current',\n\t\t});\n\n\t\tyield* Effect.forkScoped(\n\t\t\tsubscriber.commands.pipe(\n\t\t\t\tStream.runForEach((record) =>\n\t\t\t\t\tEffect.gen(function* () {\n\t\t\t\t\t\tif (!isEngineCommand(record.command)) {\n\t\t\t\t\t\t\tyield* subscriber\n\t\t\t\t\t\t\t\t.fail(record.id, 'invalid command', 'command payload did not match EngineCommand')\n\t\t\t\t\t\t\t\t.pipe(Effect.catch(() => Effect.void));\n\t\t\t\t\t\t\treturn;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tyield* params.handle.runCommand(record.command).pipe(\n\t\t\t\t\t\t\tEffect.andThen(subscriber.ack(record.id)),\n\t\t\t\t\t\t\tEffect.catchCause((cause) =>\n\t\t\t\t\t\t\t\tsubscriber\n\t\t\t\t\t\t\t\t\t.fail(record.id, 'command failed', Cause.pretty(cause as Cause.Cause<unknown>))\n\t\t\t\t\t\t\t\t\t.pipe(Effect.catch(() => Effect.void)),\n\t\t\t\t\t\t\t),\n\t\t\t\t\t\t);\n\t\t\t\t\t}),\n\t\t\t\t),\n\t\t\t\tEffect.catchCause((cause) =>\n\t\t\t\t\tEffect.sync(() => {\n\t\t\t\t\t\tprocess.stderr.write(\n\t\t\t\t\t\t\t`command channel failed: ${Cause.pretty(cause as Cause.Cause<unknown>)}\\n`,\n\t\t\t\t\t\t);\n\t\t\t\t\t}),\n\t\t\t\t),\n\t\t\t),\n\t\t);\n\n\t\treturn {\n\t\t\tpublishEvent: (event: EngineEvent) =>\n\t\t\t\tsubscriber.publishEvent(event).pipe(Effect.catch(() => Effect.void)),\n\t\t};\n\t});\n\n/**\n * Run `devstack up`. Wires the substrate Layer stack, supervisor,\n * attached renderer, and in-process TUI command queue. The Effect runs\n * as the outer Node fiber so SIGINT reaches scope finalizers.\n */\nconst runUpLive = (\n\tconfigPath: string | undefined,\n\tidentity: ResolvedIdentity,\n\toptions: {\n\t\treadonly renderer: GlobalFlags['renderer'];\n\t\treadonly stdoutIsTty: boolean;\n\t},\n): Effect.Effect<void> => {\n\tconst loader = makeConfigLoader();\n\treturn Effect.gen(function* () {\n\t\tconst loaded = yield* loader.load(configPath).pipe(\n\t\t\tEffect.catch((err) =>\n\t\t\t\tEffect.sync(() => {\n\t\t\t\t\tprocess.stderr.write(`error: ${err.message}\\n`);\n\t\t\t\t\tprocess.exitCode = err._tag === 'CliConfigNotFoundError' ? 66 : 78;\n\t\t\t\t\treturn null;\n\t\t\t\t}),\n\t\t\t),\n\t\t);\n\t\tif (loaded === null) return;\n\t\tconst stack = (loaded as LoadedConfig & { readonly stack: SupervisedStack }).stack;\n\n\t\tconst identityValue: Identity = {\n\t\t\tapp: appName(identity.app),\n\t\t\tstack: stackName(stack.options.stackName ?? identity.stack),\n\t\t\tchain: chainId(identity.network),\n\t\t};\n\n\t\tconst appRoot = dirname(loaded.resolvedConfigPath);\n\t\tconst rendererMode = resolveUpRendererMode({\n\t\t\tcliRenderer: options.renderer,\n\t\t\tstackRenderer: stack.options.renderer,\n\t\t\tstdoutIsTty: options.stdoutIsTty,\n\t\t});\n\t\tconst substrateLayers = layerProductionOrchestrators({\n\t\t\tcodegen: {\n\t\t\t\tappRoot,\n\t\t\t\toutputDir: stack.options.codegen?.outputDir,\n\t\t\t\tstackSubdir: stack.options.codegen?.stackSubdir ?? null,\n\t\t\t},\n\t\t}).pipe(Layer.provideMerge(buildSubstrateLayers(identityValue, identity.runtimeRoot)));\n\n\t\tconst program = Effect.gen(function* () {\n\t\t\tconst state = yield* makeProjectionRef();\n\t\t\tconst snapshot = yield* SnapshotOrchestratorService;\n\t\t\tconst fs = yield* FileSystem.FileSystem;\n\t\t\tconst snapshotCommandHandler = makeSnapshotCommandHandler({ snapshot, fs });\n\t\t\tconst orchestratorSinks = yield* buildProductionOrchestratorSinks();\n\t\t\tconst postAcquireHook = yield* buildProductionPostAcquireHook({\n\t\t\t\textras: stack.options.extras,\n\t\t\t});\n\t\t\tyield* superviseStackEffect(\n\t\t\t\t{ _tag: 'Stack', members: stack.members, options: stack.options },\n\t\t\t\tidentityValue,\n\t\t\t\tstate,\n\t\t\t\t{\n\t\t\t\t\torchestratorSinks,\n\t\t\t\t\tcommandHandler: snapshotCommandHandler,\n\t\t\t\t\tpostAcquireHook,\n\t\t\t\t\textendContext: extendBuiltInPluginContext,\n\t\t\t\t\tbeforeInitialAcquire: (handle) =>\n\t\t\t\t\t\tEffect.gen(function* () {\n\t\t\t\t\t\t\tconst stackPaths = yield* StackPathsService;\n\t\t\t\t\t\t\tconst commandChannel = yield* installCommandChannelBridge({\n\t\t\t\t\t\t\t\tstackRoot: stackPaths.stackRoot,\n\t\t\t\t\t\t\t\thandle,\n\t\t\t\t\t\t\t});\n\t\t\t\t\t\t\tyield* installLiveSupervisorRoster({\n\t\t\t\t\t\t\t\tstackRoot: stackPaths.stackRoot,\n\t\t\t\t\t\t\t\tapp: String(identityValue.app),\n\t\t\t\t\t\t\t\tstack: String(identityValue.stack),\n\t\t\t\t\t\t\t});\n\t\t\t\t\t\t\tconst rendererEvents = yield* Queue.unbounded<EngineEvent>();\n\t\t\t\t\t\t\tconst renderer = makeTuiSurface({\n\t\t\t\t\t\t\t\tmode: rendererMode,\n\t\t\t\t\t\t\t\tpublishCommand: makeQueueCommandPublisher(handle.commands),\n\t\t\t\t\t\t\t});\n\t\t\t\t\t\t\tyield* Effect.addFinalizer(() =>\n\t\t\t\t\t\t\t\trenderer.flush.pipe(Effect.catch(() => Effect.void)),\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\tyield* Effect.forkScoped(\n\t\t\t\t\t\t\t\trenderer.mount(handle.state, Stream.fromQueue(rendererEvents)).pipe(\n\t\t\t\t\t\t\t\t\tEffect.catch((cause) =>\n\t\t\t\t\t\t\t\t\t\tEffect.sync(() => {\n\t\t\t\t\t\t\t\t\t\t\tprocess.stderr.write(`renderer failed: ${cause.detail ?? String(cause)}\\n`);\n\t\t\t\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t\t\t\t),\n\t\t\t\t\t\t\t\t),\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\tyield* Effect.forkScoped(\n\t\t\t\t\t\t\t\tpersistProjectionChanges(stackPaths.stackRoot, handle.state),\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\tyield* Effect.forkScoped(\n\t\t\t\t\t\t\t\tStream.fromQueue(handle.events).pipe(\n\t\t\t\t\t\t\t\t\tStream.runForEach((event) =>\n\t\t\t\t\t\t\t\t\t\tEffect.gen(function* () {\n\t\t\t\t\t\t\t\t\t\t\tyield* Queue.offer(rendererEvents, event);\n\t\t\t\t\t\t\t\t\t\t\tyield* commandChannel.publishEvent(event);\n\t\t\t\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t\t\t\t),\n\t\t\t\t\t\t\t\t),\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\t}),\n\t\t\t\t},\n\t\t\t).pipe(Effect.provide(layerBuiltInPluginRuntime(orchestratorSinks)));\n\t\t});\n\n\t\tyield* program.pipe(\n\t\t\tEffect.provide(substrateLayers),\n\t\t\tEffect.provide(Logger.layer([])),\n\t\t\tEffect.matchCauseEffect({\n\t\t\t\tonFailure: (cause) =>\n\t\t\t\t\tEffect.sync(() => {\n\t\t\t\t\t\tconst live = findCliSupervisorLiveError(cause as Cause.Cause<unknown>);\n\t\t\t\t\t\tif (live !== null) {\n\t\t\t\t\t\t\tprocess.stderr.write(`error: supervisor live for ${live.app}/${live.stack}\\n`);\n\t\t\t\t\t\t\tif (live.hint !== undefined) {\n\t\t\t\t\t\t\t\tprocess.stderr.write(`hint: ${live.hint}\\n`);\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\tprocess.exitCode = ExitCode.SUPERVISOR_LIVE;\n\t\t\t\t\t\t\treturn;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tprocess.stderr.write(\n\t\t\t\t\t\t\t`\\nerror: stack failed\\n${Cause.pretty(cause as Cause.Cause<unknown>)}\\n`,\n\t\t\t\t\t\t);\n\t\t\t\t\t\tprocess.exitCode = 1;\n\t\t\t\t\t}),\n\t\t\t\tonSuccess: () =>\n\t\t\t\t\tEffect.sync(() => {\n\t\t\t\t\t\tprocess.exitCode ??= 0;\n\t\t\t\t\t}),\n\t\t\t}),\n\t\t);\n\t});\n};\n\nconst runApplyAgainstLiveSupervisor = (\n\tidentity: ResolvedIdentity,\n\tidentityValue: Identity,\n): Effect.Effect<boolean> =>\n\tEffect.gen(function* () {\n\t\tconst stackRoot = stackRootFor(identity.runtimeRoot, String(identityValue.stack));\n\t\tconst presence = yield* probeSupervisorPresence(resolvePath(stackRoot, 'roster.json')).pipe(\n\t\t\tEffect.catch(() => Effect.succeed({ live: false, pid: null, hostname: null })),\n\t\t);\n\t\tif (!presence.live) return false;\n\n\t\tconst exit = yield* Effect.exit(\n\t\t\tEffect.gen(function* () {\n\t\t\t\tconst publisher = yield* makeCommandChannelPublisher(commandChannelPaths(stackRoot));\n\t\t\t\tconst published = yield* publisher.publish({ tag: 'apply.requested' });\n\t\t\t\tconst reply = yield* publisher.awaitCompletion(published.id, {\n\t\t\t\t\ttimeoutMillis: LIVE_APPLY_ACK_TIMEOUT_MILLIS,\n\t\t\t\t});\n\t\t\t\tif (!reply.ok) {\n\t\t\t\t\treturn yield* Effect.fail(reply.message);\n\t\t\t\t}\n\t\t\t}),\n\t\t);\n\n\t\tif (Exit.isFailure(exit)) {\n\t\t\tprocess.stderr.write(\n\t\t\t\t`\\nerror: live stack apply failed\\n${Cause.pretty(exit.cause as Cause.Cause<unknown>)}\\n`,\n\t\t\t);\n\t\t\tprocess.exitCode = 1;\n\t\t\treturn true;\n\t\t}\n\n\t\tprocess.exitCode ??= 0;\n\t\treturn true;\n\t});\n\nconst runApplyLive = (\n\tconfigPath: string | undefined,\n\tidentity: ResolvedIdentity,\n): Effect.Effect<void> => {\n\tconst loader = makeConfigLoader();\n\treturn Effect.gen(function* () {\n\t\tconst loaded = yield* loader.load(configPath).pipe(\n\t\t\tEffect.matchEffect({\n\t\t\t\tonFailure: (err) =>\n\t\t\t\t\tEffect.gen(function* () {\n\t\t\t\t\t\tprocess.stderr.write(`error: ${err.message}\\n`);\n\t\t\t\t\t\tprocess.exitCode = err._tag === 'CliConfigNotFoundError' ? 66 : 78;\n\t\t\t\t\t\treturn yield* Effect.fail('config-load-failed' as const);\n\t\t\t\t\t}),\n\t\t\t\tonSuccess: (v) => Effect.succeed(v),\n\t\t\t}),\n\t\t);\n\t\tconst stack = (loaded as LoadedConfig & { readonly stack: SupervisedStack }).stack;\n\t\tconst identityValue: Identity = {\n\t\t\tapp: appName(identity.app),\n\t\t\tstack: stackName(stack.options.stackName ?? identity.stack),\n\t\t\tchain: chainId(identity.network),\n\t\t};\n\t\tif (yield* runApplyAgainstLiveSupervisor(identity, identityValue)) {\n\t\t\treturn;\n\t\t}\n\t\tconst appRoot = dirname(loaded.resolvedConfigPath);\n\t\tconst substrateLayers = layerProductionOrchestrators({\n\t\t\tcodegen: {\n\t\t\t\tappRoot,\n\t\t\t\toutputDir: stack.options.codegen?.outputDir,\n\t\t\t\tstackSubdir: stack.options.codegen?.stackSubdir ?? null,\n\t\t\t},\n\t\t}).pipe(Layer.provideMerge(buildSubstrateLayers(identityValue, identity.runtimeRoot)));\n\n\t\tconst program = Effect.gen(function* () {\n\t\t\tconst state = yield* makeProjectionRef();\n\t\t\tconst orchestratorSinks = yield* buildProductionOrchestratorSinks();\n\t\t\tconst postAcquireHook = yield* buildProductionPostAcquireHook({\n\t\t\t\textras: stack.options.extras,\n\t\t\t});\n\t\t\tyield* superviseStackEffect(\n\t\t\t\t{ _tag: 'Stack', members: stack.members, options: stack.options },\n\t\t\t\tidentityValue,\n\t\t\t\tstate,\n\t\t\t\t{\n\t\t\t\t\torchestratorSinks,\n\t\t\t\t\tpostAcquireHook,\n\t\t\t\t\tlifetime: 'one-shot',\n\t\t\t\t\textendContext: extendBuiltInPluginContext,\n\t\t\t\t},\n\t\t\t).pipe(Effect.provide(layerBuiltInPluginRuntime(orchestratorSinks)));\n\t\t\tconst stackPaths = yield* StackPathsService;\n\t\t\tyield* writeProjectionSnapshot(stackPaths.stackRoot, yield* SubscriptionRef.get(state));\n\t\t});\n\n\t\tyield* program.pipe(\n\t\t\tEffect.provide(substrateLayers),\n\t\t\tEffect.provide(Logger.layer([Logger.consolePretty()])),\n\t\t\tEffect.matchCauseEffect({\n\t\t\t\tonFailure: (cause) =>\n\t\t\t\t\tEffect.sync(() => {\n\t\t\t\t\t\tprocess.stderr.write(\n\t\t\t\t\t\t\t`\\nerror: stack apply failed\\n${Cause.pretty(cause as Cause.Cause<unknown>)}\\n`,\n\t\t\t\t\t\t);\n\t\t\t\t\t\tprocess.exitCode = 1;\n\t\t\t\t\t}),\n\t\t\t\tonSuccess: () =>\n\t\t\t\t\tEffect.sync(() => {\n\t\t\t\t\t\tprocess.exitCode ??= 0;\n\t\t\t\t\t}),\n\t\t\t}),\n\t\t);\n\t}).pipe(Effect.catch(() => Effect.void));\n};\n\nconst snapshotIdentityParticipants = (meta: SnapshotMetadata): ReadonlyArray<RestoreParticipant> =>\n\tObject.entries(meta.identity).map(([plugin, value]) => ({\n\t\tplugin,\n\t\tliveIdentity: Effect.succeed({ [plugin]: value }),\n\t}));\n\nconst identityValueFor = (identity: ResolvedIdentity, stack?: SupervisedStack): Identity => ({\n\tapp: appName(identity.app),\n\tstack: stackName(stack?.options.stackName ?? identity.stack),\n\tchain: chainId(identity.network),\n});\n\nconst directSnapshotLayers = (identity: ResolvedIdentity) =>\n\tlayerProductionOrchestrators().pipe(\n\t\tLayer.provideMerge(buildSubstrateLayers(identityValueFor(identity), identity.runtimeRoot)),\n\t);\n\nconst provideFileSystem = <A, E>(\n\tfs: FileSystem.FileSystem,\n\teffect: Effect.Effect<A, E, FileSystem.FileSystem>,\n): Effect.Effect<A, E, never> => effect.pipe(Effect.provideService(FileSystem.FileSystem, fs));\n\nconst ensureNoLiveSupervisor = (\n\tidentity: ResolvedIdentity,\n\thint: string,\n): Effect.Effect<void, CliSupervisorLiveError> =>\n\tEffect.gen(function* () {\n\t\tconst presence = yield* probeSupervisorPresence(identity.rosterFile).pipe(\n\t\t\tEffect.catch(() => Effect.succeed({ live: false, pid: null, hostname: null })),\n\t\t);\n\t\tif (presence.live) {\n\t\t\treturn yield* Effect.fail(\n\t\t\t\tnew CliSupervisorLiveError({\n\t\t\t\t\tapp: identity.app,\n\t\t\t\t\tstack: identity.stack,\n\t\t\t\t\thint,\n\t\t\t\t}),\n\t\t\t);\n\t\t}\n\t});\n\nconst runSnapshotRestoreDirect = (\n\tidentity: ResolvedIdentity,\n\tsnapshotId: string,\n): Effect.Effect<void, unknown> => {\n\tconst program = Effect.gen(function* () {\n\t\tconst snapshot = yield* SnapshotOrchestratorService;\n\t\tconst fs = yield* FileSystem.FileSystem;\n\t\tconst entries = yield* provideFileSystem(fs, snapshot.list);\n\t\tconst meta = entries.find((entry) => entry.id === snapshotId)?.metadata ?? null;\n\t\tconst participants = meta === null ? [] : snapshotIdentityParticipants(meta);\n\t\tyield* provideFileSystem(fs, snapshot.restore({ id: snapshotId, participants }));\n\t});\n\tconst restored = program.pipe(\n\t\tEffect.provide(directSnapshotLayers(identity)),\n\t\tEffect.provide(Logger.layer([Logger.consolePretty()])),\n\t);\n\treturn ensureNoLiveSupervisor(\n\t\tidentity,\n\t\t'shut down the attached `devstack up` session before restoring a snapshot',\n\t).pipe(Effect.andThen(restored));\n};\n\nconst runSnapshotDeleteDirect = (\n\tidentity: ResolvedIdentity,\n\tsnapshotId: string,\n): Effect.Effect<void, unknown> => {\n\tconst program = Effect.gen(function* () {\n\t\tconst snapshot = yield* SnapshotOrchestratorService;\n\t\tconst fs = yield* FileSystem.FileSystem;\n\t\tyield* provideFileSystem(fs, snapshot.delete(snapshotId));\n\t});\n\treturn program.pipe(\n\t\tEffect.provide(directSnapshotLayers(identity)),\n\t\tEffect.provide(Logger.layer([Logger.consolePretty()])),\n\t);\n};\n\nconst runSnapshotCaptureDirect = (\n\tidentity: ResolvedIdentity,\n\targs: { readonly snapshotId?: string; readonly name?: string; readonly configPath?: string },\n): Effect.Effect<{ readonly snapshotId: string; readonly name: string }, unknown> => {\n\tconst loader = makeConfigLoader();\n\treturn Effect.gen(function* () {\n\t\tconst loaded = yield* loader.load(args.configPath);\n\t\tconst stack = (loaded as LoadedConfig & { readonly stack: SupervisedStack }).stack;\n\t\tconst identityValue = identityValueFor(identity, stack);\n\t\tconst appRoot = dirname(loaded.resolvedConfigPath);\n\t\tconst substrateLayers = layerProductionOrchestrators({\n\t\t\tcodegen: {\n\t\t\t\tappRoot,\n\t\t\t\toutputDir: stack.options.codegen?.outputDir,\n\t\t\t\tstackSubdir: stack.options.codegen?.stackSubdir ?? null,\n\t\t\t},\n\t\t}).pipe(Layer.provideMerge(buildSubstrateLayers(identityValue, identity.runtimeRoot)));\n\n\t\tconst program = Effect.gen(function* () {\n\t\t\tconst state = yield* makeProjectionRef();\n\t\t\tconst snapshot = yield* SnapshotOrchestratorService;\n\t\t\tconst fs = yield* FileSystem.FileSystem;\n\t\t\tconst orchestratorSinks = yield* buildProductionOrchestratorSinks();\n\t\t\tconst postAcquireHook = yield* buildProductionPostAcquireHook({\n\t\t\t\textras: stack.options.extras,\n\t\t\t});\n\t\t\tlet captureExit: Exit.Exit<void, unknown> = Exit.succeed(undefined);\n\t\t\tconst capturedMeta: { current: SnapshotMetadata | null } = { current: null };\n\t\t\tyield* superviseStackEffect(\n\t\t\t\t{ _tag: 'Stack', members: stack.members, options: stack.options },\n\t\t\t\tidentityValue,\n\t\t\t\tstate,\n\t\t\t\t{\n\t\t\t\t\torchestratorSinks,\n\t\t\t\t\tpostAcquireHook,\n\t\t\t\t\tlifetime: 'one-shot',\n\t\t\t\t\textendContext: extendBuiltInPluginContext,\n\t\t\t\t\twithinScope: () =>\n\t\t\t\t\t\tprovideFileSystem(fs, snapshot.capture({ id: args.snapshotId, label: args.name })).pipe(\n\t\t\t\t\t\t\tEffect.tap((meta) =>\n\t\t\t\t\t\t\t\tEffect.sync(() => {\n\t\t\t\t\t\t\t\t\tcapturedMeta.current = meta;\n\t\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t\t),\n\t\t\t\t\t\t\tEffect.asVoid,\n\t\t\t\t\t\t\tEffect.exit,\n\t\t\t\t\t\t\tEffect.tap((exit) =>\n\t\t\t\t\t\t\t\tEffect.sync(() => {\n\t\t\t\t\t\t\t\t\tcaptureExit = exit;\n\t\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t\t),\n\t\t\t\t\t\t\tEffect.asVoid,\n\t\t\t\t\t\t),\n\t\t\t\t},\n\t\t\t).pipe(Effect.provide(layerBuiltInPluginRuntime(orchestratorSinks)));\n\t\t\tif (Exit.isFailure(captureExit)) {\n\t\t\t\tyield* Effect.failCause(captureExit.cause);\n\t\t\t}\n\t\t\tif (capturedMeta.current === null) {\n\t\t\t\treturn yield* Effect.die('snapshot capture completed without metadata');\n\t\t\t}\n\t\t\tconst meta = capturedMeta.current;\n\t\t\tconst stackPaths = yield* StackPathsService;\n\t\t\tyield* writeProjectionSnapshot(stackPaths.stackRoot, yield* SubscriptionRef.get(state));\n\t\t\treturn { snapshotId: meta.id, name: meta.label ?? meta.id };\n\t\t});\n\n\t\treturn yield* program.pipe(\n\t\t\tEffect.provide(substrateLayers),\n\t\t\tEffect.provide(Logger.layer([Logger.consolePretty()])),\n\t\t);\n\t});\n};\n\nconst makeDirectSnapshotDeps = (identity: ResolvedIdentity): CliDeps['snapshot'] => ({\n\treader: makeSnapshotReader(identity),\n\tcapture: (args) => runSnapshotCaptureDirect(identity, args),\n\trestore: (snapshotId) => runSnapshotRestoreDirect(identity, snapshotId),\n\tdelete: (snapshotId) => runSnapshotDeleteDirect(identity, snapshotId),\n\tconfirm: nodeConfirmPrompt,\n});\n\nconst runWipeDirect = (identity: ResolvedIdentity): Effect.Effect<void, unknown> =>\n\tEffect.gen(function* () {\n\t\tyield* ensureNoLiveSupervisor(identity, 'shut down the attached `devstack up` session first');\n\t\tconst program = Effect.gen(function* () {\n\t\t\tconst snapshot = yield* SnapshotOrchestratorService;\n\t\t\tconst fs = yield* FileSystem.FileSystem;\n\t\t\tyield* provideFileSystem(fs, snapshot.wipe({}));\n\t\t\tyield* removeRouterDispatchFilesForStack({\n\t\t\t\truntimeRoot: identity.runtimeRoot,\n\t\t\t\tapp: identity.app,\n\t\t\t\tstack: identity.stack,\n\t\t\t});\n\t\t});\n\t\treturn yield* program.pipe(\n\t\t\tEffect.provide(directSnapshotLayers(identity)),\n\t\t\tEffect.provide(Logger.layer([Logger.consolePretty()])),\n\t\t);\n\t});\n\nconst identityInputsFromArgv = (\n\targv: ReadonlyArray<string>,\n\tenv: Readonly<Record<string, string | undefined>>,\n) => {\n\tlet app = env.DEVSTACK_APP;\n\tlet stack = env.DEVSTACK_STACK;\n\tlet network = env.DEVSTACK_NETWORK;\n\tlet stateDir = env.DEVSTACK_STATE_DIR;\n\tlet configPath = env.DEVSTACK_CONFIG;\n\tfor (let i = 0; i < argv.length; i += 1) {\n\t\tconst token = argv[i]!;\n\t\tconst readValue = (name: string): string | undefined => {\n\t\t\tif (token.startsWith(`--${name}=`)) return token.slice(name.length + 3);\n\t\t\tif (token === `--${name}`) return argv[i + 1];\n\t\t\treturn undefined;\n\t\t};\n\t\tapp = readValue('app') ?? app;\n\t\tstack = readValue('stack') ?? stack;\n\t\tnetwork = readValue('network') ?? network;\n\t\tstateDir = readValue('state-dir') ?? stateDir;\n\t\tconfigPath = readValue('config') ?? configPath;\n\t}\n\treturn { app, stack, network, stateDir, configPath };\n};\n\nconst identityCwdFromConfig = (configPath: string | undefined): string => {\n\tconst resolved = resolveConfigPath(configPath);\n\treturn resolved === null ? process.cwd() : dirname(resolved);\n};\n\n// -----------------------------------------------------------------------------\n// Bin entry\n// -----------------------------------------------------------------------------\n\nexport const runCli = async (\n\targv: ReadonlyArray<string> = process.argv.slice(2),\n): Promise<void> => {\n\tconst stdinIsTty = Boolean((process.stdin as { isTTY?: boolean }).isTTY);\n\tconst env: Record<string, string | undefined> = { ...process.env };\n\tconst identityInputs = identityInputsFromArgv(argv, env);\n\tconst identity = resolveIdentity({\n\t\tapp: identityInputs.app,\n\t\tstack: identityInputs.stack,\n\t\tnetwork: identityInputs.network,\n\t\tstateDir: identityInputs.stateDir,\n\t\tcwd: identityCwdFromConfig(identityInputs.configPath),\n\t});\n\tconst deps = buildDirectDeps(identity);\n\tawait Effect.runPromise(\n\t\tdispatch(deps, {\n\t\t\targv,\n\t\t\tenv: {\n\t\t\t\t...env,\n\t\t\t\tDEVSTACK_APP: identity.app,\n\t\t\t\tDEVSTACK_STACK: identity.stack,\n\t\t\t\tDEVSTACK_STATE_DIR: identity.runtimeRoot,\n\t\t\t},\n\t\t\tstdinIsTty,\n\t\t}),\n\t);\n};\n\nconst isMainEntrypoint = (): boolean => {\n\tconst argvPath = process.argv[1];\n\tif (argvPath === undefined) return false;\n\ttry {\n\t\treturn realpathSync(argvPath) === realpathSync(fileURLToPath(import.meta.url));\n\t} catch {\n\t\treturn import.meta.url === pathToFileURL(argvPath).href;\n\t}\n};\n\nif (isMainEntrypoint()) {\n\trunCli()\n\t\t.catch((err) => {\n\t\t\tprocess.stderr.write(`error: ${err instanceof Error ? err.message : String(err)}\\n`);\n\t\t\tprocess.exitCode = 1;\n\t\t})\n\t\t.then(() => {\n\t\t\tprocess.exit(process.exitCode ?? 0);\n\t\t});\n}\n"],"mappings":"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"}
+{"version":3,"file":"main.mjs","names":["resolvePath"],"sources":["../../src/cli/main.ts"],"sourcesContent":["// devstack CLI bin entry — argv → identity → deps → dispatch → exit.\n//\n// This file is the executable entry the `bin: { devstack: ... }`\n// package.json field points at. Build output: `dist/cli/main.mjs`.\n//\n// Architecture invariant (surfaces/cli/index.ts header):\n//   \"`up` must hand its long-running effect to the outer Node runtime\n//    directly, not nest a runtime — otherwise SIGINT cannot reach\n//    scope finalizers and container teardown leaks.\"\n//\n// Shape:\n//   1. Pre-parse identity inputs from argv + env (see\n//      `identityInputsFromArgv`).\n//   2. Resolve identity (app / stack / network / runtime root) via the\n//      shared `api/inference-network` helpers.\n//   3. Build the dispatcher's `CliDeps` bundle from each verb's wiring\n//      module in `cli/wirings/`.\n//   4. Hand control to the Stricli-backed dispatcher, which routes to\n//      the verb-scoped wiring function.\n\nimport { realpathSync } from 'node:fs';\nimport { dirname, resolve as resolvePath } from 'node:path';\nimport { fileURLToPath, pathToFileURL } from 'node:url';\n\nimport { Effect } from 'effect';\n\nimport { readProjectionSnapshot } from '../substrate/runtime/index.ts';\nimport type { SubscribableState } from '../substrate/projection.ts';\nimport { dispatch, type CliDeps, CliUsageError } from '../surfaces/cli/index.ts';\nimport { emitFailure, nodeProcessIO } from '../surfaces/cli/output.ts';\nimport { ENV_VARS } from '../surfaces/cli/flags.ts';\nimport { defaultProbes } from './doctor-probes.ts';\nimport { nodeConfirmPrompt } from '../surfaces/cli/commands/confirm-node.ts';\nimport type { StatusReader } from '../surfaces/cli/commands/status.ts';\nimport { ExitCode } from '../surfaces/cli/sysexits.ts';\nimport { makeSnapshotReader } from './snapshot-reader.ts';\nimport {\n\tDevstackNetworkParseError,\n\tresolveAppName,\n\tresolveNetworkSync,\n\tresolveStackName,\n\tresolveStateDir,\n} from '../api/inference-network.ts';\nimport { makeDirectPruneDeps } from './prune-direct.ts';\nimport { runUpLive } from './wirings/up.ts';\nimport { runApplyLive } from './wirings/apply.ts';\nimport {\n\trunSnapshotCaptureLiveAware,\n\trunSnapshotDeleteDirect,\n\trunSnapshotRestoreDirect,\n} from './wirings/snapshot.ts';\nimport { runWipeDirect, runWipePlanDirect } from './wirings/wipe.ts';\nimport { makeConfigLoader, resolveConfigPath } from './wirings/config-loader.ts';\nimport type { ResolvedIdentity } from './wirings/identity.ts';\n\n// -----------------------------------------------------------------------------\n// Identity resolution\n// -----------------------------------------------------------------------------\n\n/** Resolve identity from flags + env. App and stack fall through the\n *  shared cwd/package metadata resolver before their defaults.\n *\n *  State-dir precedence ladder:\n *    `--state-dir` flag (`stateDir`) > `config.options.stateDir`\n *    (`configStateDir`) > `$DEVSTACK_STATE_DIR` > `<cwd>/.devstack`.\n *  The flag maps to `resolveStateDir`'s top `runtimeRoot` rung and the\n *  config value to its `stateDir` rung so the flag always wins over a\n *  config-declared `defineDevstack({ stateDir })`.\n *\n *  Stack-name precedence ladder (the SAME flag-beats-config shape as\n *  state-dir, so the two are consistent and reviewable side-by-side):\n *    `--stack` flag / `$DEVSTACK_STACK` (`params.stack`)\n *      > config's `defineDevstack({ stackName })`\n *      > cwd/package inference (default `'main'`).\n *  Config-vs-explicit resolution can't happen here (the config isn't\n *  loaded yet for the no-config verbs), so we record the explicit value\n *  on `ResolvedIdentity.explicitStack` and let the verb wirings apply\n *  `config.stackName` ONLY when no explicit stack was given — see\n *  `effectiveStackName` in `cli/wirings/identity.ts`. `params.stack` is\n *  exactly the explicit `--stack`-or-`$DEVSTACK_STACK` value (the argv\n *  pre-parser seeds it from env, then lets the flag overwrite it), and\n *  is `undefined` when neither was provided. */\nconst resolveIdentity = (params: {\n\treadonly app: string | undefined;\n\treadonly stack: string | undefined;\n\treadonly network: string | undefined;\n\treadonly stateDir: string | undefined;\n\treadonly configStateDir?: string | undefined;\n\treadonly cwd?: string;\n}): ResolvedIdentity => {\n\tconst cwd = params.cwd ?? process.cwd();\n\tconst app = resolveAppName({\n\t\texplicit: params.app,\n\t\tcwd,\n\t});\n\tconst runtimeRoot = resolveStateDir({\n\t\truntimeRoot: params.stateDir,\n\t\tstateDir: params.configStateDir,\n\t\tenv: process.env.DEVSTACK_STATE_DIR,\n\t\tcwd,\n\t});\n\tconst stacksRoot = resolvePath(runtimeRoot, 'stacks');\n\t// `resolveStackName` here folds explicit (flag/env) > inferred >\n\t// default. Crucially it does NOT see `config.stackName`: a non-empty\n\t// `params.stack` means the operator was explicit, so `stack` already\n\t// equals the explicit value and `config.stackName` must not override\n\t// it downstream. An empty `params.stack` falls through to the\n\t// inferred/default name, which a verb's `config.stackName` may then\n\t// supersede via `effectiveStackName`.\n\tconst explicitStack =\n\t\tparams.stack !== undefined && params.stack.length > 0 ? params.stack : undefined;\n\tconst stack = resolveStackName({\n\t\texplicit: params.stack,\n\t\tcwd,\n\t});\n\t// Centralized explicit > env > default ladder. Throws\n\t// `DevstackNetworkParseError` on a malformed value so the CLI fails\n\t// fast with a structured error instead of a downstream cryptic\n\t// chain-probe failure. The raw input is preserved (not the\n\t// canonical name) so chain-keyed cache namespaces stay stable.\n\tconst network = resolveNetworkSync({\n\t\texplicit: params.network,\n\t\tenv: process.env.DEVSTACK_NETWORK,\n\t\texplicitSource: '--network',\n\t}).raw;\n\tconst stackRoot = resolvePath(stacksRoot, stack);\n\treturn {\n\t\tapp,\n\t\tstack,\n\t\tnetwork,\n\t\truntimeRoot,\n\t\tstacksRoot,\n\t\tstackRoot,\n\t\trosterFile: resolvePath(stackRoot, 'roster.json'),\n\t\texplicitStack,\n\t};\n};\n\n// -----------------------------------------------------------------------------\n// Verb deps composition\n// -----------------------------------------------------------------------------\n\nconst projectionStatusReader = (identity: ResolvedIdentity): StatusReader => ({\n\treadState: () =>\n\t\tEffect.sync(() => readProjectionSnapshot(identity.stackRoot) as SubscribableState | null),\n});\n\nconst buildDirectDeps = (identity: ResolvedIdentity): CliDeps => {\n\treturn {\n\t\tup: {\n\t\t\trun: (flags) =>\n\t\t\t\trunUpLive(flags.configPath, identity, {\n\t\t\t\t\trenderer: flags.renderer,\n\t\t\t\t\tstdoutIsTty: Boolean((process.stdout as { isTTY?: boolean }).isTTY),\n\t\t\t\t}),\n\t\t},\n\t\tapply: {\n\t\t\trun: (flags) => runApplyLive(flags.configPath, identity),\n\t\t},\n\t\tstatus: { reader: projectionStatusReader(identity) },\n\t\tsnapshot: {\n\t\t\treader: makeSnapshotReader(identity),\n\t\t\tcapture: (args) => runSnapshotCaptureLiveAware(identity, args),\n\t\t\trestore: (snapshotId) => runSnapshotRestoreDirect(identity, snapshotId),\n\t\t\tdelete: (snapshotId) => runSnapshotDeleteDirect(identity, snapshotId),\n\t\t\tconfirm: nodeConfirmPrompt,\n\t\t},\n\t\tprune: makeDirectPruneDeps({ runtimeRoot: identity.runtimeRoot }),\n\t\tdoctor: {\n\t\t\tprobes: defaultProbes({\n\t\t\t\tstateDir: identity.runtimeRoot,\n\t\t\t\tappRoot: identity.stacksRoot,\n\t\t\t}),\n\t\t},\n\t\tconfig: { loader: makeConfigLoader() },\n\t\twipe: {\n\t\t\twipe: () => runWipeDirect(identity),\n\t\t\tplan: () => runWipePlanDirect(identity),\n\t\t\tconfirm: nodeConfirmPrompt,\n\t\t},\n\t};\n};\n\n// -----------------------------------------------------------------------------\n// Argv pre-parser\n// -----------------------------------------------------------------------------\n\n/** @internal Exported for tests. Resolves identity flag inputs from a\n *  `--app <x>` / `--stack <x>` / `--network <x>` / `--state-dir <x>` /\n *  `--config <x>` argv, falling back to `DEVSTACK_*` env vars. Throws\n *  on a missing or flag-shaped value so a typo doesn't silently demote\n *  a downstream flag, and on a duplicate flag (`--app a --app b`) so\n *  the pre-parser does not silently last-write-wins a value that\n *  Stricli will later reject outright. */\nexport const identityInputsFromArgv = (\n\targv: ReadonlyArray<string>,\n\tenv: Readonly<Record<string, string | undefined>>,\n) => {\n\tlet app = env.DEVSTACK_APP;\n\tlet stack = env.DEVSTACK_STACK;\n\tlet network = env.DEVSTACK_NETWORK;\n\t// `stateDir` intentionally captures the `--state-dir` flag ONLY. The\n\t// full ladder — `--state-dir` flag > `config.options.stateDir`\n\t// (`defineDevstack({ stateDir })`) > `$DEVSTACK_STATE_DIR` >\n\t// `<cwd>/.devstack` — is assembled at the `resolveStateDir(...)`\n\t// call-site in `resolveIdentity`: the flag wins (top `runtimeRoot`\n\t// rung), the best-effort config value sits below it (`stateDir`\n\t// rung), then env, then the cwd default. Keeping the pre-parser a\n\t// thin flag-extractor means config + env precedence live in one place.\n\tlet stateDir: string | undefined;\n\tlet configPath = env.DEVSTACK_CONFIG;\n\t// Tracks which flags have been seen on the argv side so a second\n\t// occurrence trips a usage error before the value silently overwrites\n\t// the first. Env-sourced defaults are NOT counted (they are not user\n\t// argv).\n\tconst seenArgvFlags = new Set<string>();\n\tfor (let i = 0; i < argv.length; i += 1) {\n\t\tconst token = argv[i]!;\n\t\tconst readValue = (name: string): string | undefined => {\n\t\t\tlet value: string | undefined;\n\t\t\t// `--name=value` form: trust the literal between `=` and end.\n\t\t\tif (token.startsWith(`--${name}=`)) {\n\t\t\t\tvalue = token.slice(name.length + 3);\n\t\t\t}\n\t\t\t// `--name value` form: peek the next token. Reject another\n\t\t\t// flag token (`--foo`) as the value — it almost certainly\n\t\t\t// means the user meant `--name <empty>` (typo / forgotten\n\t\t\t// argument) and quietly absorbing `--foo` as the value\n\t\t\t// silently demotes a downstream flag.\n\t\t\telse if (token === `--${name}`) {\n\t\t\t\tconst next = argv[i + 1];\n\t\t\t\tif (next === undefined) {\n\t\t\t\t\tthrow new CliUsageError({ message: `flag --${name} requires a value` });\n\t\t\t\t}\n\t\t\t\tif (next.startsWith('--')) {\n\t\t\t\t\tthrow new CliUsageError({\n\t\t\t\t\t\tmessage: `flag --${name} requires a value; got \"${next}\" which looks like a flag`,\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t\tvalue = next;\n\t\t\t}\n\t\t\tif (value === undefined) return undefined;\n\t\t\tif (seenArgvFlags.has(name)) {\n\t\t\t\tthrow new CliUsageError({ message: `flag --${name} given more than once` });\n\t\t\t}\n\t\t\tseenArgvFlags.add(name);\n\t\t\treturn value;\n\t\t};\n\t\tapp = readValue('app') ?? app;\n\t\tstack = readValue('stack') ?? stack;\n\t\tnetwork = readValue('network') ?? network;\n\t\tstateDir = readValue('state-dir') ?? stateDir;\n\t\tconfigPath = readValue('config') ?? configPath;\n\t}\n\treturn { app, stack, network, stateDir, configPath };\n};\n\nconst identityCwdFromConfig = (configPath: string | undefined): string => {\n\tconst resolved = resolveConfigPath(configPath);\n\treturn resolved === null ? process.cwd() : dirname(resolved);\n};\n\n/** Whether the resolved argv is a purely-informational invocation that\n *  never consumes `identity.runtimeRoot` (the only value the config\n *  pre-load feeds). For these we SKIP `configStateDirBestEffort` so we\n *  don't dynamic-import (and run the top-level side effects of) the\n *  user's `devstack.config.ts` — plus walk parent dirs — for commands\n *  the file header itself says must stay cheap:\n *\n *   - empty argv  → Stricli prints root help\n *   - `--help`/`-h` or `--version`/`-v` anywhere → Stricli short-circuits\n *   - first token `schema` → emits the static CLI schema (no state dir)\n *\n *  An unknown verb also never reaches a state-dir consumer (Stricli\n *  fails the parse), but we keep pre-loading on the general path: the\n *  pre-parser already accepted the identity flags, and gating on a\n *  closed verb set here would duplicate the dispatcher's route table.\n *  The two flagged-as-wasteful informational paths (help/version/schema)\n *  are the ones with a registered short-circuit, so skipping exactly\n *  those removes the eager-import surprise without re-deriving routes. */\nconst argvSkipsConfigPreload = (argv: ReadonlyArray<string>): boolean => {\n\tif (argv.length === 0) return true;\n\tfor (const token of argv) {\n\t\tif (token === '--help' || token === '-h' || token === '--version' || token === '-v') {\n\t\t\treturn true;\n\t\t}\n\t}\n\tconst firstVerb = argv.find((token) => !token.startsWith('-'));\n\treturn firstVerb === 'schema';\n};\n\n/** Best-effort read of `config.options.stateDir` (the value a program\n *  sets via `defineDevstack({ stateDir })`) for the state-dir precedence\n *  ladder in `resolveIdentity`. Swallows EVERY config-loader failure\n *  (not-found AND evaluation errors) and returns `undefined`:\n *\n *   - No-config verbs (`prune`, `wipe`) MUST keep resolving identity\n *     without a config, so a missing config silently falls through to\n *     the flag > env > cwd ladder.\n *   - A genuinely malformed config is NOT surfaced here — the verbs that\n *     actually consume config (`up` / `apply` via `makeConfigLoader`)\n *     re-load it and surface the typed `CliConfig*` error through the\n *     normal envelope path, so behavior for those verbs is unchanged.\n *\n *  This is one redundant config evaluation for `up` / `apply` (the verb\n *  wiring re-loads via its own loader); threading the loaded value into\n *  the verb dispatch would require touching the off-limits `wirings/up.ts`\n *  signature, so the duplicate import is accepted deliberately. */\nconst configStateDirBestEffort = async (\n\tconfigPath: string | undefined,\n): Promise<string | undefined> => {\n\tconst loaded = await Effect.runPromise(makeConfigLoader().load(configPath).pipe(Effect.option));\n\tif (loaded._tag === 'None') return undefined;\n\tconst options = (loaded.value.stack as { readonly options?: { readonly stateDir?: string } })\n\t\t.options;\n\tconst stateDir = options?.stateDir;\n\treturn stateDir !== undefined && stateDir.length > 0 ? stateDir : undefined;\n};\n\n// -----------------------------------------------------------------------------\n// Bin entry\n// -----------------------------------------------------------------------------\n\nexport const runCli = async (\n\targv: ReadonlyArray<string> = process.argv.slice(2),\n): Promise<void> => {\n\tconst stdinIsTty = Boolean((process.stdin as { isTTY?: boolean }).isTTY);\n\tconst env: Record<string, string | undefined> = { ...process.env };\n\tlet identityInputs: ReturnType<typeof identityInputsFromArgv>;\n\ttry {\n\t\tidentityInputs = identityInputsFromArgv(argv, env);\n\t} catch (cause) {\n\t\tconst error =\n\t\t\tcause instanceof CliUsageError\n\t\t\t\t? cause\n\t\t\t\t: new CliUsageError({\n\t\t\t\t\t\tmessage: cause instanceof Error ? cause.message : String(cause),\n\t\t\t\t\t});\n\t\tconst jsonMode = env[ENV_VARS.JSON] === '1' || argv.includes('--json');\n\t\tawait Effect.runPromise(\n\t\t\temitFailure(nodeProcessIO, jsonMode ? 'json' : 'human', {\n\t\t\t\tcommand: '(parse-argv)',\n\t\t\t\telapsedMs: 0,\n\t\t\t\terror,\n\t\t\t}),\n\t\t);\n\t\treturn;\n\t}\n\t// Best-effort config pre-load for the state-dir ladder. Swallows\n\t// not-found / malformed configs so no-config verbs (prune/wipe) keep\n\t// working; the `--state-dir` flag still wins over the config value.\n\t// Skipped for informational invocations (help/version/schema/empty)\n\t// that never read `identity.runtimeRoot`, so those commands don't\n\t// dynamic-import the user's config (and run its top-level side\n\t// effects) just to print help.\n\tconst configStateDir = argvSkipsConfigPreload(argv)\n\t\t? undefined\n\t\t: await configStateDirBestEffort(identityInputs.configPath);\n\tlet identity: ResolvedIdentity;\n\ttry {\n\t\tidentity = resolveIdentity({\n\t\t\tapp: identityInputs.app,\n\t\t\tstack: identityInputs.stack,\n\t\t\tnetwork: identityInputs.network,\n\t\t\tstateDir: identityInputs.stateDir,\n\t\t\tconfigStateDir,\n\t\t\tcwd: identityCwdFromConfig(identityInputs.configPath),\n\t\t});\n\t} catch (cause) {\n\t\t// `resolveIdentity` -> `resolveNetworkSync` throws\n\t\t// `DevstackNetworkParseError` (a plain Error, NOT a CliError) on a\n\t\t// malformed `--network`/`$DEVSTACK_NETWORK` value. This runs OUTSIDE\n\t\t// the argv pre-parse try/catch above and BEFORE dispatch, so without\n\t\t// this guard the throw escapes to the bin entry's generic `.catch`\n\t\t// (exit 1, no envelope). Convert to `CliUsageError` and route through\n\t\t// the same envelope path the parse-argv block uses so a bad value\n\t\t// exits USAGE (64) with a JSON envelope in `--json` mode — never the\n\t\t// disallowed generic exit 1.\n\t\tconst error =\n\t\t\tcause instanceof DevstackNetworkParseError\n\t\t\t\t? new CliUsageError({ message: cause.message })\n\t\t\t\t: cause instanceof CliUsageError\n\t\t\t\t\t? cause\n\t\t\t\t\t: new CliUsageError({\n\t\t\t\t\t\t\tmessage: cause instanceof Error ? cause.message : String(cause),\n\t\t\t\t\t\t});\n\t\tconst jsonMode = env[ENV_VARS.JSON] === '1' || argv.includes('--json');\n\t\tawait Effect.runPromise(\n\t\t\temitFailure(nodeProcessIO, jsonMode ? 'json' : 'human', {\n\t\t\t\tcommand: '(resolve-identity)',\n\t\t\t\telapsedMs: 0,\n\t\t\t\terror,\n\t\t\t}),\n\t\t);\n\t\treturn;\n\t}\n\tconst deps = buildDirectDeps(identity);\n\tawait Effect.runPromise(\n\t\tdispatch(deps, {\n\t\t\targv,\n\t\t\tenv: {\n\t\t\t\t...env,\n\t\t\t\tDEVSTACK_APP: identity.app,\n\t\t\t\tDEVSTACK_STACK: identity.stack,\n\t\t\t\tDEVSTACK_STATE_DIR: identity.runtimeRoot,\n\t\t\t},\n\t\t\tstdinIsTty,\n\t\t}),\n\t);\n};\n\nconst isMainEntrypoint = (): boolean => {\n\tconst argvPath = process.argv[1];\n\tif (argvPath === undefined) return false;\n\ttry {\n\t\treturn realpathSync(argvPath) === realpathSync(fileURLToPath(import.meta.url));\n\t} catch {\n\t\treturn import.meta.url === pathToFileURL(argvPath).href;\n\t}\n};\n\nif (isMainEntrypoint()) {\n\t// Intentionally do NOT call `process.exit(...)` after `runCli`:\n\t// `process.exit` synchronously terminates the event loop before any\n\t// pending `setImmediate` work flushes. The `up` lifecycle's hard-kill\n\t// path schedules its escalation via `setImmediate(process.exit)` in\n\t// `up-lifecycle.ts:scheduleProcessExit` (the file-header invariant for\n\t// SIGINT → finalizers requires the outer Node fiber to drain\n\t// naturally). Letting Node's natural exit handle the shutdown\n\t// preserves that invariant. We only set `process.exitCode` so the\n\t// final OS exit code reflects the verb's outcome.\n\trunCli().catch((err) => {\n\t\tprocess.stderr.write(`error: ${err instanceof Error ? err.message : String(err)}\\n`);\n\t\tprocess.exitCode = ExitCode.GENERIC;\n\t});\n}\n"],"mappings":"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"}

package/dist/cli/prune-direct.mjs

@@ -1,213 +1,43 @@
-import { checkHolderLiveness } from "../substrate/runtime/cross-process/liveness.mjs";
-import { DockerSpawner, layerDockerHostDefault } from "../runtime/docker/client.mjs";
-import { readRoster } from "../substrate/runtime/cross-process/roster.mjs";
-import { LabelKey } from "../runtime/docker/labels.mjs";
-import { listDevstackContainers, listDevstackImages, listDevstackNetworks, listDevstackRouterContainers, listDevstackVolumes } from "../runtime/docker/inventory.mjs";
-import { removeDevstackContainers, removeDevstackImages, removeDevstackNetworksBestEffort, removeDevstackRouterContainers, removeDevstackVolumes } from "../runtime/docker/sweep.mjs";
-import { ROUTER_SHARED_APP, removeRouterProfileStateForDockerStack } from "../orchestrators/router/cleanup.mjs";
+import { collectLifecyclePruneInventory, runLifecyclePrune } from "../orchestrators/lifecycle-prune/index.mjs";
 import { summarizePruneGroups } from "../surfaces/cli/commands/prune.mjs";
-import { selectPruneTargets } from "../surfaces/cli/commands/prune-picker.mjs";
-import { Effect, Layer } from "effect";
-import { existsSync } from "node:fs";
-import { join } from "node:path";
-import * as NodeFileSystem from "@effect/platform-node/NodeFileSystem";
-import * as NodePath from "@effect/platform-node/NodePath";
-import * as NodeChildProcessSpawner from "@effect/platform-node/NodeChildProcessSpawner";
-import { ChildProcessSpawner } from "effect/unstable/process/ChildProcessSpawner";
+import "../surfaces/cli/commands/index.mjs";
+import { selectPruneTargets } from "../surfaces/cli/commands/prune-picker-entry.mjs";
+import { Effect } from "effect";
 //#region src/cli/prune-direct.ts
-const layerDockerSpawnerFromNode = Layer.effect(DockerSpawner, Effect.gen(function* () {
-	return yield* ChildProcessSpawner;
-}));
-const dockerLayer = Layer.merge(layerDockerHostDefault, layerDockerSpawnerFromNode.pipe(Layer.provideMerge(NodeChildProcessSpawner.layer.pipe(Layer.provideMerge(Layer.mergeAll(NodeFileSystem.layer, NodePath.layer))))));
-const emptyBucket = () => ({
-	containers: 0,
-	runningContainers: 0,
-	networks: 0,
-	volumes: 0,
-	images: 0
+const adaptGroup = (group) => ({
+	key: group.key,
+	app: group.app,
+	stack: group.stack,
+	live: group.live,
+	livePids: group.livePids,
+	shared: group.shared,
+	sharedKind: group.sharedKind,
+	autoPrunable: group.autoPrunable,
+	containers: group.containers,
+	runningContainers: group.runningContainers,
+	networks: group.networks,
+	volumes: group.volumes,
+	images: group.images
 });
-const groupKey = (app, stack) => `${app}/${stack}`;
-const readAppStack = (labels) => {
-	const app = labels[LabelKey.app];
-	const stack = labels[LabelKey.stack];
-	if (app === void 0 || app.length === 0) return null;
-	if (stack === void 0 || stack.length === 0) return null;
-	return {
-		app,
-		stack
-	};
-};
-const routerStackForContainer = (name) => ({
-	app: ROUTER_SHARED_APP,
-	stack: name
-});
-const addBucket = (buckets, identity) => {
-	const key = groupKey(identity.app, identity.stack);
-	let bucket = buckets.get(key);
-	if (bucket === void 0) {
-		bucket = emptyBucket();
-		buckets.set(key, bucket);
-	}
-	return bucket;
-};
-const livePidsForStack = (runtimeRoot, stack) => {
-	const rosterFile = join(runtimeRoot, "stacks", stack, "roster.json");
-	if (!existsSync(rosterFile)) return Effect.succeed([]);
-	return Effect.gen(function* () {
-		const doc = yield* readRoster(rosterFile).pipe(Effect.catch(() => Effect.succeed(null)));
-		if (doc === null) return [];
-		const pids = [];
-		for (const holder of doc.holders) if ((yield* checkHolderLiveness(holder).pipe(Effect.catch(() => Effect.succeed("alive")))) === "alive") pids.push(holder.pid);
-		return pids;
-	});
-};
-const isSharedGroup = (app, stack) => stack === "_per-app_" || app === "devstack-router";
-const isRouterGroup = (group) => group.app === "devstack-router" && group.stack.startsWith(`devstack-router-`);
-const collectDirectPruneInventory = (options) => Effect.gen(function* () {
-	const [containers, routerContainers, networks, volumes, images] = yield* Effect.all([
-		listDevstackContainers(),
-		listDevstackRouterContainers(),
-		listDevstackNetworks(),
-		listDevstackVolumes(),
-		listDevstackImages()
-	], { concurrency: "unbounded" }).pipe(Effect.provide(dockerLayer));
-	const buckets = /* @__PURE__ */ new Map();
-	for (const container of containers) {
-		const identity = readAppStack(container.labels);
-		if (identity === null) continue;
-		const bucket = addBucket(buckets, identity);
-		bucket.containers += 1;
-		if (container.state === "running") bucket.runningContainers += 1;
-	}
-	for (const container of routerContainers) {
-		const bucket = addBucket(buckets, routerStackForContainer(container.name));
-		bucket.containers += 1;
-		if (container.state === "running") bucket.runningContainers += 1;
-	}
-	for (const network of networks) {
-		const identity = readAppStack(network.labels);
-		if (identity === null) continue;
-		addBucket(buckets, identity).networks += 1;
-	}
-	for (const volume of volumes) {
-		const identity = readAppStack(volume.labels);
-		if (identity === null) continue;
-		addBucket(buckets, identity).volumes += 1;
-	}
-	for (const image of images) {
-		const identity = readAppStack(image.labels);
-		if (identity === null) continue;
-		addBucket(buckets, identity).images += 1;
-	}
-	const groups = [];
-	for (const [key, bucket] of buckets) {
-		const [app, stack] = key.split("/");
-		const routerGroup = app === ROUTER_SHARED_APP;
-		const livePids = routerGroup ? [] : yield* livePidsForStack(options.runtimeRoot, stack);
-		groups.push({
-			key,
-			app,
-			stack,
-			live: routerGroup ? bucket.runningContainers > 0 : livePids.length > 0,
-			livePids,
-			shared: isSharedGroup(app, stack),
-			containers: bucket.containers,
-			runningContainers: bucket.runningContainers,
-			networks: bucket.networks,
-			volumes: bucket.volumes,
-			images: bucket.images
-		});
-	}
-	groups.sort((a, b) => {
-		if (a.app !== b.app) return a.app < b.app ? -1 : 1;
-		return a.stack < b.stack ? -1 : a.stack > b.stack ? 1 : 0;
-	});
+const adaptInventory = (inventory) => {
+	const groups = inventory.groups.map(adaptGroup);
 	return {
 		groups,
 		totals: summarizePruneGroups(groups)
 	};
-});
-const selectedGroups = (inventory, selection) => {
-	const selected = new Set(selection.groupKeys);
-	return inventory.groups.filter((group) => selected.has(group.key));
 };
-const pruneDirectSelection = (options, selection) => Effect.gen(function* () {
-	const groups = selectedGroups(yield* collectDirectPruneInventory(options), selection);
-	let skippedLiveGroups = 0;
-	let containersRemoved = 0;
-	let networksRemoved = 0;
-	let networksSkipped = 0;
-	let volumesRemoved = 0;
-	let imagesRemoved = 0;
-	const prunableGroups = [];
-	for (const group of groups) {
-		if (group.live) {
-			skippedLiveGroups += 1;
-			continue;
-		}
-		prunableGroups.push(group);
-		if (selection.dryRun) {
-			if (selection.resources.containers) containersRemoved += group.containers;
-			if (selection.resources.networks) networksRemoved += group.networks;
-			if (selection.resources.volumes) volumesRemoved += group.volumes;
-			if (selection.resources.images) imagesRemoved += group.images;
-			continue;
-		}
-	}
-	if (!selection.dryRun && selection.resources.containers) for (const group of prunableGroups) if (isRouterGroup(group)) containersRemoved += yield* removeDevstackRouterContainers(group.stack).pipe(Effect.provide(dockerLayer));
-	else {
-		const match = {
-			app: group.app,
-			stack: group.stack
-		};
-		containersRemoved += yield* removeDevstackContainers(match).pipe(Effect.provide(dockerLayer));
-	}
-	if (!selection.dryRun && selection.resources.networks) for (const group of prunableGroups) {
-		const result = yield* removeDevstackNetworksBestEffort({
-			app: group.app,
-			stack: group.stack
-		}).pipe(Effect.provide(dockerLayer));
-		networksRemoved += result.removed;
-		networksSkipped += result.skippedInUse;
-	}
-	if (!selection.dryRun && selection.resources.volumes) for (const group of prunableGroups) {
-		const match = {
-			app: group.app,
-			stack: group.stack
-		};
-		volumesRemoved += yield* removeDevstackVolumes(match).pipe(Effect.provide(dockerLayer));
-	}
-	if (!selection.dryRun && selection.resources.images) for (const group of prunableGroups) {
-		const match = {
-			app: group.app,
-			stack: group.stack
-		};
-		imagesRemoved += yield* removeDevstackImages(match).pipe(Effect.provide(dockerLayer));
-	}
-	if (!selection.dryRun) for (const group of prunableGroups) {
-		if (!isRouterGroup(group)) continue;
-		yield* removeRouterProfileStateForDockerStack({
-			runtimeRoot: options.runtimeRoot,
-			routerStack: group.stack
-		});
-	}
-	return {
-		kind: "completed",
-		summary: {
-			inspectedGroups: groups.length,
-			selectedGroups: groups.length,
-			skippedLiveGroups,
-			containersRemoved,
-			networksRemoved,
-			networksSkipped,
-			volumesRemoved,
-			imagesRemoved
-		}
-	};
-});
+const collectInventory = (options) => collectLifecyclePruneInventory(options).pipe(Effect.map(adaptInventory));
+const pruneSelection = (options, selection) => runLifecyclePrune(options, {
+	groupKeys: selection.groupKeys,
+	resources: selection.resources,
+	dryRun: selection.dryRun
+}).pipe(Effect.map((summary) => ({
+	kind: "completed",
+	summary
+})));
 const makeDirectPruneDeps = (options) => ({
-	inventory: () => collectDirectPruneInventory(options),
-	prune: (selection) => pruneDirectSelection(options, selection),
+	inventory: () => collectInventory(options),
+	prune: (selection) => pruneSelection(options, selection),
 	select: (inventory, resources) => selectPruneTargets(inventory, resources)
 });
 //#endregion

package/dist/cli/prune-direct.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"prune-direct.mjs","names":["joinPath"],"sources":["../../src/cli/prune-direct.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport { join as joinPath } from 'node:path';\n\nimport * as NodeChildProcessSpawner from '@effect/platform-node/NodeChildProcessSpawner';\nimport * as NodeFileSystem from '@effect/platform-node/NodeFileSystem';\nimport * as NodePath from '@effect/platform-node/NodePath';\nimport { Effect, Layer } from 'effect';\nimport { ChildProcessSpawner } from 'effect/unstable/process/ChildProcessSpawner';\n\nimport {\n\tDockerHost,\n\tDockerSpawner,\n\tLabelKey,\n\tlayerDockerHostDefault,\n\tlistDevstackContainers,\n\tlistDevstackImages,\n\tlistDevstackNetworks,\n\tlistDevstackRouterContainers,\n\tlistDevstackVolumes,\n\tremoveDevstackContainers,\n\tremoveDevstackImages,\n\tremoveDevstackNetworksBestEffort,\n\tremoveDevstackRouterContainers,\n\tremoveDevstackVolumes,\n} from '../runtime/docker/index.ts';\nimport {\n\tROUTER_SHARED_APP,\n\tremoveRouterProfileStateForDockerStack,\n} from '../orchestrators/router/cleanup.ts';\nimport { checkHolderLiveness, readRoster } from '../substrate/runtime/cross-process/index.ts';\nimport {\n\tsummarizePruneGroups,\n\ttype PruneDeps,\n\ttype PruneGroup,\n\ttype PruneInventory,\n\ttype PruneOutcome,\n\ttype PruneSelection,\n} from '../surfaces/cli/commands/index.ts';\nimport { selectPruneTargets } from '../surfaces/cli/commands/prune-picker.tsx';\n\ninterface DirectPruneOptions {\n\treadonly runtimeRoot: string;\n}\n\ntype ResourceBucket = {\n\tcontainers: number;\n\trunningContainers: number;\n\tnetworks: number;\n\tvolumes: number;\n\timages: number;\n};\n\nconst layerDockerSpawnerFromNode: Layer.Layer<DockerSpawner, never, ChildProcessSpawner> =\n\tLayer.effect(\n\t\tDockerSpawner,\n\t\tEffect.gen(function* () {\n\t\t\treturn yield* ChildProcessSpawner;\n\t\t}),\n\t);\n\nconst dockerLayer: Layer.Layer<DockerHost | DockerSpawner> = Layer.merge(\n\tlayerDockerHostDefault,\n\tlayerDockerSpawnerFromNode.pipe(\n\t\tLayer.provideMerge(\n\t\t\tNodeChildProcessSpawner.layer.pipe(\n\t\t\t\tLayer.provideMerge(Layer.mergeAll(NodeFileSystem.layer, NodePath.layer)),\n\t\t\t),\n\t\t),\n\t),\n);\n\nconst emptyBucket = (): ResourceBucket => ({\n\tcontainers: 0,\n\trunningContainers: 0,\n\tnetworks: 0,\n\tvolumes: 0,\n\timages: 0,\n});\n\nconst groupKey = (app: string, stack: string): string => `${app}/${stack}`;\n\nconst readAppStack = (\n\tlabels: Readonly<Record<string, string>>,\n): { readonly app: string; readonly stack: string } | null => {\n\tconst app = labels[LabelKey.app];\n\tconst stack = labels[LabelKey.stack];\n\tif (app === undefined || app.length === 0) return null;\n\tif (stack === undefined || stack.length === 0) return null;\n\treturn { app, stack };\n};\n\nconst routerStackForContainer = (\n\tname: string,\n): { readonly app: string; readonly stack: string } => ({\n\tapp: ROUTER_SHARED_APP,\n\tstack: name,\n});\n\nconst addBucket = (\n\tbuckets: Map<string, ResourceBucket>,\n\tidentity: { readonly app: string; readonly stack: string },\n): ResourceBucket => {\n\tconst key = groupKey(identity.app, identity.stack);\n\tlet bucket = buckets.get(key);\n\tif (bucket === undefined) {\n\t\tbucket = emptyBucket();\n\t\tbuckets.set(key, bucket);\n\t}\n\treturn bucket;\n};\n\nconst livePidsForStack = (\n\truntimeRoot: string,\n\tstack: string,\n): Effect.Effect<ReadonlyArray<number>> => {\n\tconst rosterFile = joinPath(runtimeRoot, 'stacks', stack, 'roster.json');\n\tif (!existsSync(rosterFile)) return Effect.succeed([]);\n\treturn Effect.gen(function* () {\n\t\tconst doc = yield* readRoster(rosterFile).pipe(Effect.catch(() => Effect.succeed(null)));\n\t\tif (doc === null) return [];\n\t\tconst pids: Array<number> = [];\n\t\tfor (const holder of doc.holders) {\n\t\t\tconst live = yield* checkHolderLiveness(holder).pipe(\n\t\t\t\tEffect.catch(() => Effect.succeed('alive' as const)),\n\t\t\t);\n\t\t\tif (live === 'alive') pids.push(holder.pid);\n\t\t}\n\t\treturn pids;\n\t});\n};\n\nconst isSharedGroup = (app: string, stack: string): boolean =>\n\tstack === '_per-app_' || app === ROUTER_SHARED_APP;\n\nconst isRouterGroup = (group: Pick<PruneGroup, 'app' | 'stack'>): boolean =>\n\tgroup.app === ROUTER_SHARED_APP && group.stack.startsWith(`${ROUTER_SHARED_APP}-`);\n\nexport const collectDirectPruneInventory = (\n\toptions: DirectPruneOptions,\n): Effect.Effect<PruneInventory, unknown> =>\n\tEffect.gen(function* () {\n\t\tconst [containers, routerContainers, networks, volumes, images] = yield* Effect.all(\n\t\t\t[\n\t\t\t\tlistDevstackContainers(),\n\t\t\t\tlistDevstackRouterContainers(),\n\t\t\t\tlistDevstackNetworks(),\n\t\t\t\tlistDevstackVolumes(),\n\t\t\t\tlistDevstackImages(),\n\t\t\t],\n\t\t\t{ concurrency: 'unbounded' },\n\t\t).pipe(Effect.provide(dockerLayer));\n\n\t\tconst buckets = new Map<string, ResourceBucket>();\n\n\t\tfor (const container of containers) {\n\t\t\tconst identity = readAppStack(container.labels);\n\t\t\tif (identity === null) continue;\n\t\t\tconst bucket = addBucket(buckets, identity);\n\t\t\tbucket.containers += 1;\n\t\t\tif (container.state === 'running') bucket.runningContainers += 1;\n\t\t}\n\t\tfor (const container of routerContainers) {\n\t\t\tconst bucket = addBucket(buckets, routerStackForContainer(container.name));\n\t\t\tbucket.containers += 1;\n\t\t\tif (container.state === 'running') bucket.runningContainers += 1;\n\t\t}\n\t\tfor (const network of networks) {\n\t\t\tconst identity = readAppStack(network.labels);\n\t\t\tif (identity === null) continue;\n\t\t\taddBucket(buckets, identity).networks += 1;\n\t\t}\n\t\tfor (const volume of volumes) {\n\t\t\tconst identity = readAppStack(volume.labels);\n\t\t\tif (identity === null) continue;\n\t\t\taddBucket(buckets, identity).volumes += 1;\n\t\t}\n\t\tfor (const image of images) {\n\t\t\tconst identity = readAppStack(image.labels);\n\t\t\tif (identity === null) continue;\n\t\t\taddBucket(buckets, identity).images += 1;\n\t\t}\n\n\t\tconst groups: Array<PruneGroup> = [];\n\t\tfor (const [key, bucket] of buckets) {\n\t\t\tconst [app, stack] = key.split('/') as [string, string];\n\t\t\tconst routerGroup = app === ROUTER_SHARED_APP;\n\t\t\tconst livePids = routerGroup ? [] : yield* livePidsForStack(options.runtimeRoot, stack);\n\t\t\tgroups.push({\n\t\t\t\tkey,\n\t\t\t\tapp,\n\t\t\t\tstack,\n\t\t\t\tlive: routerGroup ? bucket.runningContainers > 0 : livePids.length > 0,\n\t\t\t\tlivePids,\n\t\t\t\tshared: isSharedGroup(app, stack),\n\t\t\t\tcontainers: bucket.containers,\n\t\t\t\trunningContainers: bucket.runningContainers,\n\t\t\t\tnetworks: bucket.networks,\n\t\t\t\tvolumes: bucket.volumes,\n\t\t\t\timages: bucket.images,\n\t\t\t});\n\t\t}\n\n\t\tgroups.sort((a, b) => {\n\t\t\tif (a.app !== b.app) return a.app < b.app ? -1 : 1;\n\t\t\treturn a.stack < b.stack ? -1 : a.stack > b.stack ? 1 : 0;\n\t\t});\n\n\t\treturn { groups, totals: summarizePruneGroups(groups) };\n\t});\n\nconst selectedGroups = (\n\tinventory: PruneInventory,\n\tselection: PruneSelection,\n): ReadonlyArray<PruneGroup> => {\n\tconst selected = new Set(selection.groupKeys);\n\treturn inventory.groups.filter((group) => selected.has(group.key));\n};\n\nexport const pruneDirectSelection = (\n\toptions: DirectPruneOptions,\n\tselection: PruneSelection,\n): Effect.Effect<PruneOutcome, unknown> =>\n\tEffect.gen(function* () {\n\t\tconst inventory = yield* collectDirectPruneInventory(options);\n\t\tconst groups = selectedGroups(inventory, selection);\n\t\tlet skippedLiveGroups = 0;\n\t\tlet containersRemoved = 0;\n\t\tlet networksRemoved = 0;\n\t\tlet networksSkipped = 0;\n\t\tlet volumesRemoved = 0;\n\t\tlet imagesRemoved = 0;\n\n\t\tconst prunableGroups: Array<PruneGroup> = [];\n\t\tfor (const group of groups) {\n\t\t\tif (group.live) {\n\t\t\t\tskippedLiveGroups += 1;\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tprunableGroups.push(group);\n\t\t\tif (selection.dryRun) {\n\t\t\t\tif (selection.resources.containers) containersRemoved += group.containers;\n\t\t\t\tif (selection.resources.networks) networksRemoved += group.networks;\n\t\t\t\tif (selection.resources.volumes) volumesRemoved += group.volumes;\n\t\t\t\tif (selection.resources.images) imagesRemoved += group.images;\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t}\n\n\t\tif (!selection.dryRun && selection.resources.containers) {\n\t\t\tfor (const group of prunableGroups) {\n\t\t\t\tif (isRouterGroup(group)) {\n\t\t\t\t\tcontainersRemoved += yield* removeDevstackRouterContainers(group.stack).pipe(\n\t\t\t\t\t\tEffect.provide(dockerLayer),\n\t\t\t\t\t);\n\t\t\t\t} else {\n\t\t\t\t\tconst match = { app: group.app, stack: group.stack };\n\t\t\t\t\tcontainersRemoved += yield* removeDevstackContainers(match).pipe(\n\t\t\t\t\t\tEffect.provide(dockerLayer),\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\tif (!selection.dryRun && selection.resources.networks) {\n\t\t\tfor (const group of prunableGroups) {\n\t\t\t\tconst match = { app: group.app, stack: group.stack };\n\t\t\t\tconst result = yield* removeDevstackNetworksBestEffort(match).pipe(\n\t\t\t\t\tEffect.provide(dockerLayer),\n\t\t\t\t);\n\t\t\t\tnetworksRemoved += result.removed;\n\t\t\t\tnetworksSkipped += result.skippedInUse;\n\t\t\t}\n\t\t}\n\n\t\tif (!selection.dryRun && selection.resources.volumes) {\n\t\t\tfor (const group of prunableGroups) {\n\t\t\t\tconst match = { app: group.app, stack: group.stack };\n\t\t\t\tvolumesRemoved += yield* removeDevstackVolumes(match).pipe(Effect.provide(dockerLayer));\n\t\t\t}\n\t\t}\n\n\t\tif (!selection.dryRun && selection.resources.images) {\n\t\t\tfor (const group of prunableGroups) {\n\t\t\t\tconst match = { app: group.app, stack: group.stack };\n\t\t\t\timagesRemoved += yield* removeDevstackImages(match).pipe(Effect.provide(dockerLayer));\n\t\t\t}\n\t\t}\n\n\t\tif (!selection.dryRun) {\n\t\t\tfor (const group of prunableGroups) {\n\t\t\t\tif (!isRouterGroup(group)) continue;\n\t\t\t\tyield* removeRouterProfileStateForDockerStack({\n\t\t\t\t\truntimeRoot: options.runtimeRoot,\n\t\t\t\t\trouterStack: group.stack,\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\n\t\treturn {\n\t\t\tkind: 'completed' as const,\n\t\t\tsummary: {\n\t\t\t\tinspectedGroups: groups.length,\n\t\t\t\tselectedGroups: groups.length,\n\t\t\t\tskippedLiveGroups,\n\t\t\t\tcontainersRemoved,\n\t\t\t\tnetworksRemoved,\n\t\t\t\tnetworksSkipped,\n\t\t\t\tvolumesRemoved,\n\t\t\t\timagesRemoved,\n\t\t\t},\n\t\t};\n\t});\n\nexport const makeDirectPruneDeps = (options: DirectPruneOptions): PruneDeps => ({\n\tinventory: () => collectDirectPruneInventory(options),\n\tprune: (selection) => pruneDirectSelection(options, selection),\n\tselect: (inventory, resources) => selectPruneTargets(inventory, resources),\n});\n"],"mappings":"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"}
+{"version":3,"file":"prune-direct.mjs","names":[],"sources":["../../src/cli/prune-direct.ts"],"sourcesContent":["// L4-adjacent CLI infrastructure for `devstack prune`.\n//\n// Per STYLE_GUIDE §7: `cli/*.ts` modules sit alongside the bin entry\n// (`cli/main.ts`) and may import L3 orchestrator/substrate barrels —\n// they are NOT L4 surfaces proper. The actual cross-stack Docker\n// orchestration lives at `orchestrators/lifecycle-prune/`; this file\n// is the deps-builder the bin entry hands to the `prune` verb runner.\n\nimport { Effect } from 'effect';\n\nimport {\n\tcollectLifecyclePruneInventory,\n\ttype LifecyclePruneError,\n\ttype LifecyclePruneGroup,\n\ttype LifecyclePruneInventory,\n\ttype LifecyclePruneOptions,\n\trunLifecyclePrune,\n} from '../orchestrators/lifecycle-prune/index.ts';\nimport {\n\tsummarizePruneGroups,\n\ttype PruneDeps,\n\ttype PruneGroup,\n\ttype PruneInventory,\n\ttype PruneOutcome,\n\ttype PruneSelection,\n} from '../surfaces/cli/commands/index.ts';\nimport { selectPruneTargets } from '../surfaces/cli/commands/prune-picker-entry.ts';\n\nconst adaptGroup = (group: LifecyclePruneGroup): PruneGroup => ({\n\tkey: group.key,\n\tapp: group.app,\n\tstack: group.stack,\n\tlive: group.live,\n\tlivePids: group.livePids,\n\tshared: group.shared,\n\tsharedKind: group.sharedKind,\n\tautoPrunable: group.autoPrunable,\n\tcontainers: group.containers,\n\trunningContainers: group.runningContainers,\n\tnetworks: group.networks,\n\tvolumes: group.volumes,\n\timages: group.images,\n});\n\nconst adaptInventory = (inventory: LifecyclePruneInventory): PruneInventory => {\n\tconst groups = inventory.groups.map(adaptGroup);\n\treturn { groups, totals: summarizePruneGroups(groups) };\n};\n\n// Internal helpers preserve the orchestrator's typed `LifecyclePruneError`\n// channel. The `PruneDeps` surface contract still accepts `unknown` for\n// the E channel (the surface module owns its own CliError projection via\n// `mapUnknownPruneError`); Effect's covariant E channel means\n// `LifecyclePruneError` flows up cleanly without erasing the type here.\n\nconst collectInventory = (\n\toptions: LifecyclePruneOptions,\n): Effect.Effect<PruneInventory, LifecyclePruneError> =>\n\tcollectLifecyclePruneInventory(options).pipe(Effect.map(adaptInventory));\n\nconst pruneSelection = (\n\toptions: LifecyclePruneOptions,\n\tselection: PruneSelection,\n): Effect.Effect<PruneOutcome, LifecyclePruneError> =>\n\trunLifecyclePrune(options, {\n\t\tgroupKeys: selection.groupKeys,\n\t\tresources: selection.resources,\n\t\tdryRun: selection.dryRun,\n\t}).pipe(Effect.map((summary) => ({ kind: 'completed' as const, summary })));\n\nexport const makeDirectPruneDeps = (options: LifecyclePruneOptions): PruneDeps => ({\n\tinventory: () => collectInventory(options),\n\tprune: (selection) => pruneSelection(options, selection),\n\tselect: (inventory, resources) => selectPruneTargets(inventory, resources),\n});\n"],"mappings":";;;;;;AA4BA,MAAM,cAAc,WAA4C;CAC/D,KAAK,MAAM;CACX,KAAK,MAAM;CACX,OAAO,MAAM;CACb,MAAM,MAAM;CACZ,UAAU,MAAM;CAChB,QAAQ,MAAM;CACd,YAAY,MAAM;CAClB,cAAc,MAAM;CACpB,YAAY,MAAM;CAClB,mBAAmB,MAAM;CACzB,UAAU,MAAM;CAChB,SAAS,MAAM;CACf,QAAQ,MAAM;CACd;AAED,MAAM,kBAAkB,cAAuD;CAC9E,MAAM,SAAS,UAAU,OAAO,IAAI,WAAW;AAC/C,QAAO;EAAE;EAAQ,QAAQ,qBAAqB,OAAO;EAAE;;AASxD,MAAM,oBACL,YAEA,+BAA+B,QAAQ,CAAC,KAAK,OAAO,IAAI,eAAe,CAAC;AAEzE,MAAM,kBACL,SACA,cAEA,kBAAkB,SAAS;CAC1B,WAAW,UAAU;CACrB,WAAW,UAAU;CACrB,QAAQ,UAAU;CAClB,CAAC,CAAC,KAAK,OAAO,KAAK,aAAa;CAAE,MAAM;CAAsB;CAAS,EAAE,CAAC;AAE5E,MAAa,uBAAuB,aAA+C;CAClF,iBAAiB,iBAAiB,QAAQ;CAC1C,QAAQ,cAAc,eAAe,SAAS,UAAU;CACxD,SAAS,WAAW,cAAc,mBAAmB,WAAW,UAAU;CAC1E"}

package/dist/cli/snapshot-reader.mjs

@@ -1,9 +1,10 @@
+import { decodeJsonTextSync } from "../substrate/runtime/runtime-decode.mjs";
 import { SnapshotLayout, SnapshotMetadataSchema, parseSnapshotId } from "../orchestrators/snapshot/descriptor.mjs";
-import { Effect, Schema } from "effect";
+import "../orchestrators/snapshot/index.mjs";
+import { Effect } from "effect";
 import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
 import { resolve } from "node:path";
 //#region src/cli/snapshot-reader.ts
-const decodeSnapshotMetadata = Schema.decodeUnknownSync(SnapshotMetadataSchema);
 const makeSnapshotReader = (identity) => {
 	const readEntries = () => {
 		const snapshotDir = resolve(identity.stackRoot, "snapshots");
@@ -21,7 +22,10 @@ const makeSnapshotReader = (identity) => {
 				size: null
 			}];
 			try {
-				const meta = decodeSnapshotMetadata(JSON.parse(readFileSync(metaPath, "utf8")));
+				const meta = decodeJsonTextSync(SnapshotMetadataSchema, readFileSync(metaPath, "utf8"), {
+					source: metaPath,
+					mkError: (issue) => issue
+				});
 				return [{
 					snapshotId: parsedEntryId,
 					name: meta.label,
@@ -47,20 +51,19 @@ const makeSnapshotReader = (identity) => {
 			try: () => {
 				const entries = readEntries();
 				const byId = entries.find((entry) => entry.snapshotId === snapshotRef);
-				if (byId !== void 0) return {
-					tag: "found",
-					entry: byId
-				};
 				const byName = entries.filter((entry) => entry.name === snapshotRef);
-				if (byName.length === 0) return { tag: "not-found" };
-				if (byName.length === 1) return {
+				const distinct = /* @__PURE__ */ new Map();
+				if (byId !== void 0) distinct.set(byId.snapshotId, byId);
+				for (const entry of byName) distinct.set(entry.snapshotId, entry);
+				if (distinct.size === 0) return { tag: "not-found" };
+				if (distinct.size === 1) return {
 					tag: "found",
-					entry: byName[0]
+					entry: distinct.values().next().value
 				};
 				return {
 					tag: "ambiguous",
 					snapshotRef,
-					matches: byName
+					matches: Array.from(distinct.values())
 				};
 			},
 			catch: (cause) => cause

package/dist/cli/snapshot-reader.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"snapshot-reader.mjs","names":["resolvePath"],"sources":["../../src/cli/snapshot-reader.ts"],"sourcesContent":["import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';\nimport { resolve as resolvePath } from 'node:path';\n\nimport { Effect, Schema } from 'effect';\n\nimport {\n\tSnapshotLayout,\n\tSnapshotMetadataSchema,\n\tparseSnapshotId,\n} from '../orchestrators/snapshot/index.ts';\nimport type {\n\tSnapshotEntry,\n\tSnapshotReader,\n\tSnapshotResolveResult,\n} from '../surfaces/cli/commands/snapshot.ts';\n\nconst decodeSnapshotMetadata = Schema.decodeUnknownSync(SnapshotMetadataSchema);\n\nexport interface SnapshotReaderIdentity {\n\treadonly stackRoot: string;\n}\n\nexport const makeSnapshotReader = (identity: SnapshotReaderIdentity): SnapshotReader => {\n\tconst readEntries = (): ReadonlyArray<SnapshotEntry> => {\n\t\tconst snapshotDir = resolvePath(identity.stackRoot, 'snapshots');\n\t\tif (!existsSync(snapshotDir)) return [];\n\t\treturn readdirSync(snapshotDir, { withFileTypes: true })\n\t\t\t.filter((entry) => entry.isDirectory() && !entry.name.startsWith('.'))\n\t\t\t.flatMap((entry) => {\n\t\t\t\tconst parsedEntryId = parseSnapshotId(entry.name);\n\t\t\t\tif (parsedEntryId === null) return [];\n\t\t\t\tconst dir = resolvePath(snapshotDir, entry.name);\n\t\t\t\tconst fallbackCreatedAt = statSync(dir).mtimeMs;\n\t\t\t\tconst metaPath = resolvePath(dir, SnapshotLayout.metaFile);\n\t\t\t\tif (!existsSync(metaPath)) {\n\t\t\t\t\treturn [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tsnapshotId: parsedEntryId,\n\t\t\t\t\t\t\tname: null,\n\t\t\t\t\t\t\tcreatedAt: fallbackCreatedAt,\n\t\t\t\t\t\t\tsize: null,\n\t\t\t\t\t\t} satisfies SnapshotEntry,\n\t\t\t\t\t];\n\t\t\t\t}\n\t\t\t\ttry {\n\t\t\t\t\tconst parsed = JSON.parse(readFileSync(metaPath, 'utf8')) as unknown;\n\t\t\t\t\tconst meta = decodeSnapshotMetadata(parsed);\n\t\t\t\t\treturn [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tsnapshotId: parsedEntryId,\n\t\t\t\t\t\t\tname: meta.label,\n\t\t\t\t\t\t\tcreatedAt: meta.createdAt,\n\t\t\t\t\t\t\tsize: null,\n\t\t\t\t\t\t} satisfies SnapshotEntry,\n\t\t\t\t\t];\n\t\t\t\t} catch {\n\t\t\t\t\treturn [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tsnapshotId: parsedEntryId,\n\t\t\t\t\t\t\tname: null,\n\t\t\t\t\t\t\tcreatedAt: fallbackCreatedAt,\n\t\t\t\t\t\t\tsize: null,\n\t\t\t\t\t\t} satisfies SnapshotEntry,\n\t\t\t\t\t];\n\t\t\t\t}\n\t\t\t});\n\t};\n\treturn {\n\t\tlist: () =>\n\t\t\tEffect.try({\n\t\t\t\ttry: readEntries,\n\t\t\t\tcatch: (cause) => cause,\n\t\t\t}).pipe(Effect.orElseSucceed(() => [])),\n\t\tresolve: (snapshotRef) =>\n\t\t\tEffect.try({\n\t\t\t\ttry: (): SnapshotResolveResult => {\n\t\t\t\t\tconst entries = readEntries();\n\t\t\t\t\tconst byId = entries.find((entry) => entry.snapshotId === snapshotRef);\n\t\t\t\t\tif (byId !== undefined) return { tag: 'found', entry: byId };\n\t\t\t\t\tconst byName = entries.filter((entry) => entry.name === snapshotRef);\n\t\t\t\t\tif (byName.length === 0) return { tag: 'not-found' };\n\t\t\t\t\tif (byName.length === 1) return { tag: 'found', entry: byName[0]! };\n\t\t\t\t\treturn { tag: 'ambiguous', snapshotRef, matches: byName };\n\t\t\t\t},\n\t\t\t\tcatch: (cause) => cause,\n\t\t\t}).pipe(Effect.orElseSucceed((): SnapshotResolveResult => ({ tag: 'not-found' }))),\n\t};\n};\n"],"mappings":";;;;;AAgBA,MAAM,yBAAyB,OAAO,kBAAkB,uBAAuB;AAM/E,MAAa,sBAAsB,aAAqD;CACvF,MAAM,oBAAkD;EACvD,MAAM,cAAcA,QAAY,SAAS,WAAW,YAAY;AAChE,MAAI,CAAC,WAAW,YAAY,CAAE,QAAO,EAAE;AACvC,SAAO,YAAY,aAAa,EAAE,eAAe,MAAM,CAAC,CACtD,QAAQ,UAAU,MAAM,aAAa,IAAI,CAAC,MAAM,KAAK,WAAW,IAAI,CAAC,CACrE,SAAS,UAAU;GACnB,MAAM,gBAAgB,gBAAgB,MAAM,KAAK;AACjD,OAAI,kBAAkB,KAAM,QAAO,EAAE;GACrC,MAAM,MAAMA,QAAY,aAAa,MAAM,KAAK;GAChD,MAAM,oBAAoB,SAAS,IAAI,CAAC;GACxC,MAAM,WAAWA,QAAY,KAAK,eAAe,SAAS;AAC1D,OAAI,CAAC,WAAW,SAAS,CACxB,QAAO,CACN;IACC,YAAY;IACZ,MAAM;IACN,WAAW;IACX,MAAM;IACN,CACD;AAEF,OAAI;IAEH,MAAM,OAAO,uBADE,KAAK,MAAM,aAAa,UAAU,OAAO,CACd,CAAC;AAC3C,WAAO,CACN;KACC,YAAY;KACZ,MAAM,KAAK;KACX,WAAW,KAAK;KAChB,MAAM;KACN,CACD;WACM;AACP,WAAO,CACN;KACC,YAAY;KACZ,MAAM;KACN,WAAW;KACX,MAAM;KACN,CACD;;IAED;;AAEJ,QAAO;EACN,YACC,OAAO,IAAI;GACV,KAAK;GACL,QAAQ,UAAU;GAClB,CAAC,CAAC,KAAK,OAAO,oBAAoB,EAAE,CAAC,CAAC;EACxC,UAAU,gBACT,OAAO,IAAI;GACV,WAAkC;IACjC,MAAM,UAAU,aAAa;IAC7B,MAAM,OAAO,QAAQ,MAAM,UAAU,MAAM,eAAe,YAAY;AACtE,QAAI,SAAS,KAAA,EAAW,QAAO;KAAE,KAAK;KAAS,OAAO;KAAM;IAC5D,MAAM,SAAS,QAAQ,QAAQ,UAAU,MAAM,SAAS,YAAY;AACpE,QAAI,OAAO,WAAW,EAAG,QAAO,EAAE,KAAK,aAAa;AACpD,QAAI,OAAO,WAAW,EAAG,QAAO;KAAE,KAAK;KAAS,OAAO,OAAO;KAAK;AACnE,WAAO;KAAE,KAAK;KAAa;KAAa,SAAS;KAAQ;;GAE1D,QAAQ,UAAU;GAClB,CAAC,CAAC,KAAK,OAAO,qBAA4C,EAAE,KAAK,aAAa,EAAE,CAAC;EACnF"}
+{"version":3,"file":"snapshot-reader.mjs","names":["resolvePath"],"sources":["../../src/cli/snapshot-reader.ts"],"sourcesContent":["import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';\nimport { resolve as resolvePath } from 'node:path';\n\nimport { Effect } from 'effect';\n\nimport {\n\tSnapshotLayout,\n\tSnapshotMetadataSchema,\n\tparseSnapshotId,\n} from '../orchestrators/snapshot/index.ts';\nimport { decodeJsonTextSync } from '../substrate/runtime/runtime-decode.ts';\nimport type {\n\tSnapshotEntry,\n\tSnapshotReader,\n\tSnapshotResolveResult,\n} from '../surfaces/cli/commands/snapshot.ts';\n\nexport interface SnapshotReaderIdentity {\n\treadonly stackRoot: string;\n}\n\nexport const makeSnapshotReader = (identity: SnapshotReaderIdentity): SnapshotReader => {\n\tconst readEntries = (): ReadonlyArray<SnapshotEntry> => {\n\t\tconst snapshotDir = resolvePath(identity.stackRoot, 'snapshots');\n\t\tif (!existsSync(snapshotDir)) return [];\n\t\treturn readdirSync(snapshotDir, { withFileTypes: true })\n\t\t\t.filter((entry) => entry.isDirectory() && !entry.name.startsWith('.'))\n\t\t\t.flatMap((entry) => {\n\t\t\t\tconst parsedEntryId = parseSnapshotId(entry.name);\n\t\t\t\tif (parsedEntryId === null) return [];\n\t\t\t\tconst dir = resolvePath(snapshotDir, entry.name);\n\t\t\t\tconst fallbackCreatedAt = statSync(dir).mtimeMs;\n\t\t\t\tconst metaPath = resolvePath(dir, SnapshotLayout.metaFile);\n\t\t\t\tif (!existsSync(metaPath)) {\n\t\t\t\t\treturn [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tsnapshotId: parsedEntryId,\n\t\t\t\t\t\t\tname: null,\n\t\t\t\t\t\t\tcreatedAt: fallbackCreatedAt,\n\t\t\t\t\t\t\tsize: null,\n\t\t\t\t\t\t} satisfies SnapshotEntry,\n\t\t\t\t\t];\n\t\t\t\t}\n\t\t\t\ttry {\n\t\t\t\t\tconst meta = decodeJsonTextSync(SnapshotMetadataSchema, readFileSync(metaPath, 'utf8'), {\n\t\t\t\t\t\tsource: metaPath,\n\t\t\t\t\t\tmkError: (issue) => issue,\n\t\t\t\t\t});\n\t\t\t\t\treturn [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tsnapshotId: parsedEntryId,\n\t\t\t\t\t\t\tname: meta.label,\n\t\t\t\t\t\t\tcreatedAt: meta.createdAt,\n\t\t\t\t\t\t\tsize: null,\n\t\t\t\t\t\t} satisfies SnapshotEntry,\n\t\t\t\t\t];\n\t\t\t\t} catch {\n\t\t\t\t\treturn [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tsnapshotId: parsedEntryId,\n\t\t\t\t\t\t\tname: null,\n\t\t\t\t\t\t\tcreatedAt: fallbackCreatedAt,\n\t\t\t\t\t\t\tsize: null,\n\t\t\t\t\t\t} satisfies SnapshotEntry,\n\t\t\t\t\t];\n\t\t\t\t}\n\t\t\t});\n\t};\n\treturn {\n\t\tlist: () =>\n\t\t\tEffect.try({\n\t\t\t\ttry: readEntries,\n\t\t\t\tcatch: (cause) => cause,\n\t\t\t}).pipe(Effect.orElseSucceed(() => [])),\n\t\tresolve: (snapshotRef) =>\n\t\t\tEffect.try({\n\t\t\t\ttry: (): SnapshotResolveResult => {\n\t\t\t\t\tconst entries = readEntries();\n\t\t\t\t\t// Resolve id-vs-name in a single pass so a ref that matches\n\t\t\t\t\t// BOTH an id AND a name (different entries) surfaces as\n\t\t\t\t\t// ambiguous instead of silently shadowing the name match\n\t\t\t\t\t// with the id match. The auto-mint format\n\t\t\t\t\t// (`snap-<ts>-<uuid>`) satisfies the same grammar as a\n\t\t\t\t\t// user-supplied name, so id-first fall-through was a real\n\t\t\t\t\t// foot-gun: a user typing a label that happened to equal\n\t\t\t\t\t// an existing snapshot id would restore the wrong artifact.\n\t\t\t\t\tconst byId = entries.find((entry) => entry.snapshotId === snapshotRef);\n\t\t\t\t\tconst byName = entries.filter((entry) => entry.name === snapshotRef);\n\n\t\t\t\t\t// Same entry matched by both axes (unusual but well-defined):\n\t\t\t\t\t// caller's intent is unambiguous because there is exactly\n\t\t\t\t\t// one matching artifact.\n\t\t\t\t\tconst distinct = new Map<string, SnapshotEntry>();\n\t\t\t\t\tif (byId !== undefined) distinct.set(byId.snapshotId, byId);\n\t\t\t\t\tfor (const entry of byName) distinct.set(entry.snapshotId, entry);\n\n\t\t\t\t\tif (distinct.size === 0) return { tag: 'not-found' };\n\t\t\t\t\tif (distinct.size === 1) {\n\t\t\t\t\t\tconst only = distinct.values().next().value as SnapshotEntry;\n\t\t\t\t\t\treturn { tag: 'found', entry: only };\n\t\t\t\t\t}\n\t\t\t\t\treturn {\n\t\t\t\t\t\ttag: 'ambiguous',\n\t\t\t\t\t\tsnapshotRef,\n\t\t\t\t\t\tmatches: Array.from(distinct.values()),\n\t\t\t\t\t};\n\t\t\t\t},\n\t\t\t\tcatch: (cause) => cause,\n\t\t\t}).pipe(Effect.orElseSucceed((): SnapshotResolveResult => ({ tag: 'not-found' }))),\n\t};\n};\n"],"mappings":";;;;;;;AAqBA,MAAa,sBAAsB,aAAqD;CACvF,MAAM,oBAAkD;EACvD,MAAM,cAAcA,QAAY,SAAS,WAAW,YAAY;AAChE,MAAI,CAAC,WAAW,YAAY,CAAE,QAAO,EAAE;AACvC,SAAO,YAAY,aAAa,EAAE,eAAe,MAAM,CAAC,CACtD,QAAQ,UAAU,MAAM,aAAa,IAAI,CAAC,MAAM,KAAK,WAAW,IAAI,CAAC,CACrE,SAAS,UAAU;GACnB,MAAM,gBAAgB,gBAAgB,MAAM,KAAK;AACjD,OAAI,kBAAkB,KAAM,QAAO,EAAE;GACrC,MAAM,MAAMA,QAAY,aAAa,MAAM,KAAK;GAChD,MAAM,oBAAoB,SAAS,IAAI,CAAC;GACxC,MAAM,WAAWA,QAAY,KAAK,eAAe,SAAS;AAC1D,OAAI,CAAC,WAAW,SAAS,CACxB,QAAO,CACN;IACC,YAAY;IACZ,MAAM;IACN,WAAW;IACX,MAAM;IACN,CACD;AAEF,OAAI;IACH,MAAM,OAAO,mBAAmB,wBAAwB,aAAa,UAAU,OAAO,EAAE;KACvF,QAAQ;KACR,UAAU,UAAU;KACpB,CAAC;AACF,WAAO,CACN;KACC,YAAY;KACZ,MAAM,KAAK;KACX,WAAW,KAAK;KAChB,MAAM;KACN,CACD;WACM;AACP,WAAO,CACN;KACC,YAAY;KACZ,MAAM;KACN,WAAW;KACX,MAAM;KACN,CACD;;IAED;;AAEJ,QAAO;EACN,YACC,OAAO,IAAI;GACV,KAAK;GACL,QAAQ,UAAU;GAClB,CAAC,CAAC,KAAK,OAAO,oBAAoB,EAAE,CAAC,CAAC;EACxC,UAAU,gBACT,OAAO,IAAI;GACV,WAAkC;IACjC,MAAM,UAAU,aAAa;IAS7B,MAAM,OAAO,QAAQ,MAAM,UAAU,MAAM,eAAe,YAAY;IACtE,MAAM,SAAS,QAAQ,QAAQ,UAAU,MAAM,SAAS,YAAY;IAKpE,MAAM,2BAAW,IAAI,KAA4B;AACjD,QAAI,SAAS,KAAA,EAAW,UAAS,IAAI,KAAK,YAAY,KAAK;AAC3D,SAAK,MAAM,SAAS,OAAQ,UAAS,IAAI,MAAM,YAAY,MAAM;AAEjE,QAAI,SAAS,SAAS,EAAG,QAAO,EAAE,KAAK,aAAa;AACpD,QAAI,SAAS,SAAS,EAErB,QAAO;KAAE,KAAK;KAAS,OADV,SAAS,QAAQ,CAAC,MAAM,CAAC;KACF;AAErC,WAAO;KACN,KAAK;KACL;KACA,SAAS,MAAM,KAAK,SAAS,QAAQ,CAAC;KACtC;;GAEF,QAAQ,UAAU;GAClB,CAAC,CAAC,KAAK,OAAO,qBAA4C,EAAE,KAAK,aAAa,EAAE,CAAC;EACnF"}

package/dist/cli/up-lifecycle.mjs

@@ -19,7 +19,10 @@ const scheduleProcessExit = (exitCode) => {
 	});
 };
 const makeQueueCommandPublisher = (commands, options = {}) => (command) => {
-	if (command.tag === "shutdown.hardKillRequested") (options.scheduleHardExit ?? scheduleProcessExit)(command.exitCode);
+	if (command.tag === "shutdown.hardKillRequested") {
+		(options.scheduleHardExit ?? scheduleProcessExit)(command.exitCode);
+		return;
+	}
 	Effect.runFork(Queue.offer(commands, command));
 };
 //#endregion

package/dist/cli/up-lifecycle.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"up-lifecycle.mjs","names":[],"sources":["../../src/cli/up-lifecycle.ts"],"sourcesContent":["import { Effect, Queue } from 'effect';\n\nimport type { EngineCommand } from '../substrate/events.ts';\nimport { resolveMode, type RendererMode } from '../surfaces/tui/mode-detect.ts';\nimport type { CliRendererMode } from '../surfaces/cli/flags.ts';\n\nexport interface ResolveUpRendererModeInput {\n\treadonly cliRenderer: CliRendererMode | undefined;\n\treadonly stackRenderer: 'tui' | 'plain' | 'silent' | undefined;\n\treadonly stdoutIsTty: boolean;\n}\n\nconst toRendererMode = (\n\tmode: CliRendererMode | 'tui' | 'plain' | 'silent' | undefined,\n): RendererMode | undefined => {\n\tswitch (mode) {\n\t\tcase undefined:\n\t\t\treturn undefined;\n\t\tcase 'tui':\n\t\t\treturn 'ink';\n\t\tcase 'plain':\n\t\tcase 'silent':\n\t\t\treturn mode;\n\t}\n};\n\nexport const resolveUpRendererMode = (input: ResolveUpRendererModeInput): RendererMode =>\n\tresolveMode({\n\t\trequested: toRendererMode(input.cliRenderer ?? input.stackRenderer),\n\t\tstdoutIsTty: input.stdoutIsTty,\n\t});\n\nexport interface QueueCommandPublisherOptions {\n\treadonly scheduleHardExit?: (exitCode: number) => void;\n}\n\nconst scheduleProcessExit = (exitCode: number): void => {\n\tsetImmediate(() => {\n\t\tprocess.exit(exitCode);\n\t});\n};\n\nexport const makeQueueCommandPublisher =\n\t(\n\t\tcommands: Queue.Enqueue<EngineCommand>,\n\t\toptions: QueueCommandPublisherOptions = {},\n\t): ((command: EngineCommand) => void) =>\n\t(command) => {\n\t\tif (command.tag === 'shutdown.hardKillRequested') {\n\t\t\t(options.scheduleHardExit ?? scheduleProcessExit)(command.exitCode);\n\t\t}\n\t\tEffect.runFork(Queue.offer(commands, command));\n\t};\n"],"mappings":";;;AAYA,MAAM,kBACL,SAC8B;AAC9B,SAAQ,MAAR;EACC,KAAK,KAAA,EACJ;EACD,KAAK,MACJ,QAAO;EACR,KAAK;EACL,KAAK,SACJ,QAAO;;;AAIV,MAAa,yBAAyB,UACrC,YAAY;CACX,WAAW,eAAe,MAAM,eAAe,MAAM,cAAc;CACnE,aAAa,MAAM;CACnB,CAAC;AAMH,MAAM,uBAAuB,aAA2B;AACvD,oBAAmB;AAClB,UAAQ,KAAK,SAAS;GACrB;;AAGH,MAAa,6BAEX,UACA,UAAwC,EAAE,MAE1C,YAAY;AACZ,KAAI,QAAQ,QAAQ,6BACnB,EAAC,QAAQ,oBAAoB,qBAAqB,QAAQ,SAAS;AAEpE,QAAO,QAAQ,MAAM,MAAM,UAAU,QAAQ,CAAC"}
+{"version":3,"file":"up-lifecycle.mjs","names":[],"sources":["../../src/cli/up-lifecycle.ts"],"sourcesContent":["import { Effect, Queue } from 'effect';\n\nimport type { EngineCommand } from '../substrate/events.ts';\nimport { resolveMode, type RendererMode } from '../surfaces/tui/mode-detect.ts';\nimport type { CliRendererMode } from '../surfaces/cli/flags.ts';\n\nexport interface ResolveUpRendererModeInput {\n\treadonly cliRenderer: CliRendererMode | undefined;\n\treadonly stackRenderer: 'tui' | 'plain' | 'silent' | undefined;\n\treadonly stdoutIsTty: boolean;\n}\n\nconst toRendererMode = (\n\tmode: CliRendererMode | 'tui' | 'plain' | 'silent' | undefined,\n): RendererMode | undefined => {\n\tswitch (mode) {\n\t\tcase undefined:\n\t\t\treturn undefined;\n\t\tcase 'tui':\n\t\t\treturn 'ink';\n\t\tcase 'plain':\n\t\tcase 'silent':\n\t\t\treturn mode;\n\t}\n};\n\nexport const resolveUpRendererMode = (input: ResolveUpRendererModeInput): RendererMode =>\n\tresolveMode({\n\t\trequested: toRendererMode(input.cliRenderer ?? input.stackRenderer),\n\t\tstdoutIsTty: input.stdoutIsTty,\n\t});\n\nexport interface QueueCommandPublisherOptions {\n\treadonly scheduleHardExit?: (exitCode: number) => void;\n}\n\nconst scheduleProcessExit = (exitCode: number): void => {\n\tsetImmediate(() => {\n\t\tprocess.exit(exitCode);\n\t});\n};\n\nexport const makeQueueCommandPublisher =\n\t(\n\t\tcommands: Queue.Enqueue<EngineCommand>,\n\t\toptions: QueueCommandPublisherOptions = {},\n\t): ((command: EngineCommand) => void) =>\n\t(command) => {\n\t\t// `hardKillRequested` escalates directly via `process.exit` —\n\t\t// `setImmediate(process.exit)` fires before the supervisor's\n\t\t// command loop can dequeue in the same tick, so any queue offer\n\t\t// here would be dead code. The supervisor still observes the\n\t\t// hard-kill through the signal handler chain\n\t\t// (`substrate/runtime/lifecycle/signals.ts`); this publisher\n\t\t// only handles the TUI keypress path and the platform exit is\n\t\t// authoritative for it.\n\t\tif (command.tag === 'shutdown.hardKillRequested') {\n\t\t\t(options.scheduleHardExit ?? scheduleProcessExit)(command.exitCode);\n\t\t\treturn;\n\t\t}\n\t\tEffect.runFork(Queue.offer(commands, command));\n\t};\n"],"mappings":";;;AAYA,MAAM,kBACL,SAC8B;AAC9B,SAAQ,MAAR;EACC,KAAK,KAAA,EACJ;EACD,KAAK,MACJ,QAAO;EACR,KAAK;EACL,KAAK,SACJ,QAAO;;;AAIV,MAAa,yBAAyB,UACrC,YAAY;CACX,WAAW,eAAe,MAAM,eAAe,MAAM,cAAc;CACnE,aAAa,MAAM;CACnB,CAAC;AAMH,MAAM,uBAAuB,aAA2B;AACvD,oBAAmB;AAClB,UAAQ,KAAK,SAAS;GACrB;;AAGH,MAAa,6BAEX,UACA,UAAwC,EAAE,MAE1C,YAAY;AASZ,KAAI,QAAQ,QAAQ,8BAA8B;AACjD,GAAC,QAAQ,oBAAoB,qBAAqB,QAAQ,SAAS;AACnE;;AAED,QAAO,QAAQ,MAAM,MAAM,UAAU,QAAQ,CAAC"}