@mysten-incubation/devstack 0.0.0

package/dist/cli/main.mjs.map

@@ -0,0 +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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"}

package/dist/cli/prune-direct.mjs

@@ -0,0 +1,216 @@
+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 { 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";
+//#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 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;
+	});
+	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 makeDirectPruneDeps = (options) => ({
+	inventory: () => collectDirectPruneInventory(options),
+	prune: (selection) => pruneDirectSelection(options, selection),
+	select: (inventory, resources) => selectPruneTargets(inventory, resources)
+});
+//#endregion
+export { makeDirectPruneDeps };
+
+//# sourceMappingURL=prune-direct.mjs.map

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

@@ -0,0 +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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"}

package/dist/cli/snapshot-reader.mjs

@@ -0,0 +1,73 @@
+import { SnapshotLayout, SnapshotMetadataSchema, parseSnapshotId } from "../orchestrators/snapshot/descriptor.mjs";
+import { Effect, Schema } 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");
+		if (!existsSync(snapshotDir)) return [];
+		return readdirSync(snapshotDir, { withFileTypes: true }).filter((entry) => entry.isDirectory() && !entry.name.startsWith(".")).flatMap((entry) => {
+			const parsedEntryId = parseSnapshotId(entry.name);
+			if (parsedEntryId === null) return [];
+			const dir = resolve(snapshotDir, entry.name);
+			const fallbackCreatedAt = statSync(dir).mtimeMs;
+			const metaPath = resolve(dir, SnapshotLayout.metaFile);
+			if (!existsSync(metaPath)) return [{
+				snapshotId: parsedEntryId,
+				name: null,
+				createdAt: fallbackCreatedAt,
+				size: null
+			}];
+			try {
+				const meta = decodeSnapshotMetadata(JSON.parse(readFileSync(metaPath, "utf8")));
+				return [{
+					snapshotId: parsedEntryId,
+					name: meta.label,
+					createdAt: meta.createdAt,
+					size: null
+				}];
+			} catch {
+				return [{
+					snapshotId: parsedEntryId,
+					name: null,
+					createdAt: fallbackCreatedAt,
+					size: null
+				}];
+			}
+		});
+	};
+	return {
+		list: () => Effect.try({
+			try: readEntries,
+			catch: (cause) => cause
+		}).pipe(Effect.orElseSucceed(() => [])),
+		resolve: (snapshotRef) => Effect.try({
+			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 {
+					tag: "found",
+					entry: byName[0]
+				};
+				return {
+					tag: "ambiguous",
+					snapshotRef,
+					matches: byName
+				};
+			},
+			catch: (cause) => cause
+		}).pipe(Effect.orElseSucceed(() => ({ tag: "not-found" })))
+	};
+};
+//#endregion
+export { makeSnapshotReader };
+
+//# sourceMappingURL=snapshot-reader.mjs.map

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

@@ -0,0 +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"}

package/dist/cli/up-lifecycle.mjs

@@ -0,0 +1,28 @@
+import { resolveMode } from "../surfaces/tui/mode-detect.mjs";
+import { Effect, Queue } from "effect";
+//#region src/cli/up-lifecycle.ts
+const toRendererMode = (mode) => {
+	switch (mode) {
+		case void 0: return;
+		case "tui": return "ink";
+		case "plain":
+		case "silent": return mode;
+	}
+};
+const resolveUpRendererMode = (input) => resolveMode({
+	requested: toRendererMode(input.cliRenderer ?? input.stackRenderer),
+	stdoutIsTty: input.stdoutIsTty
+});
+const scheduleProcessExit = (exitCode) => {
+	setImmediate(() => {
+		process.exit(exitCode);
+	});
+};
+const makeQueueCommandPublisher = (commands, options = {}) => (command) => {
+	if (command.tag === "shutdown.hardKillRequested") (options.scheduleHardExit ?? scheduleProcessExit)(command.exitCode);
+	Effect.runFork(Queue.offer(commands, command));
+};
+//#endregion
+export { makeQueueCommandPublisher, resolveUpRendererMode };
+
+//# sourceMappingURL=up-lifecycle.mjs.map

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

@@ -0,0 +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"}

package/dist/contracts/capability-decl.d.mts

@@ -0,0 +1,42 @@
+import { CodegenableDecl } from "./codegenable.mjs";
+import { LivenessClassifierDecl } from "./liveness-classifier.mjs";
+import { ProjectionDecl } from "./projection.mjs";
+import { RoutableDecl } from "./routable.mjs";
+import { SnapshotableDecl } from "./snapshotable.mjs";
+import { StrategyContributorDecl } from "./strategy-contributor.mjs";
+
+//#region src/contracts/capability-decl.d.ts
+/**
+ * Capability kind registry. Module augmentation extends this interface:
+ *
+ * declare module '@mysten-incubation/devstack' {
+ *   interface DevstackCapabilityRegistry {
+ *     readonly 'health-check': { readonly url: string };
+ *   }
+ * }
+ */
+interface DevstackCapabilityRegistry {
+  readonly snapshotable: Omit<SnapshotableDecl, 'kind'>;
+  readonly routable: Omit<RoutableDecl, 'kind'>;
+  readonly codegenable: Omit<CodegenableDecl<string>, 'kind'>;
+  readonly projection: Omit<ProjectionDecl, 'kind'>;
+  readonly 'strategy-contributor': Omit<StrategyContributorDecl<string, unknown>, 'kind'>;
+  readonly 'liveness-classifier': Omit<LivenessClassifierDecl, 'kind'>;
+}
+type CapabilityKind = keyof DevstackCapabilityRegistry & string;
+type RegisteredCapabilityDecl<Kind extends CapabilityKind = CapabilityKind> = { readonly [K in Kind]: Readonly<{
+  readonly kind: K;
+} & DevstackCapabilityRegistry[K]> }[Kind];
+type ExtensionCapabilityDecl<Kind extends string = string, Payload extends object = object> = Readonly<{
+  readonly kind: Kind;
+} & Payload>;
+type CapabilityDecl<Kind extends string = string> = string extends Kind ? RegisteredCapabilityDecl | ExtensionCapabilityDecl : Kind extends CapabilityKind ? RegisteredCapabilityDecl<Kind> : ExtensionCapabilityDecl<Kind>;
+type CapabilityPayloadFor<Kind extends string> = Kind extends CapabilityKind ? DevstackCapabilityRegistry[Kind] & {
+  readonly kind?: never;
+} : object & {
+  readonly kind?: never;
+};
+type ExactCapabilityPayload<Kind extends string, Data extends object> = Kind extends CapabilityKind ? Record<Exclude<keyof Data, keyof CapabilityPayloadFor<Kind>>, never> : unknown;
+//#endregion
+export { CapabilityDecl, CapabilityKind, CapabilityPayloadFor, DevstackCapabilityRegistry, ExactCapabilityPayload };
+//# sourceMappingURL=capability-decl.d.mts.map

package/dist/contracts/chain-probe.d.mts

@@ -0,0 +1,26 @@
+import { Effect, Schema } from "effect";
+
+//#region src/contracts/chain-probe.d.ts
+type ChainProbeMode = 'lenient' | 'strict';
+/**
+ * Plugin-typed read interface. `Key` is the chain's native id
+ * shape (object id, tx digest); `Shape` is the expected decoded
+ * shape.
+ */
+/** Schema-shape accepted by the probe. We constrain `DecodingServices`
+ *  to `never` because the probe pipeline cannot inject services from
+ *  the caller — schemas with dependencies are unsupported here. */
+type ChainProbeSchema<Shape> = Schema.Codec<Shape, unknown, never, never>;
+interface ChainProbe<Key> {
+  readonly get: <Shape>(key: Key, schema: ChainProbeSchema<Shape>, mode: ChainProbeMode) => Effect.Effect<Shape | null, ChainProbeError>;
+  readonly batchGet?: <Shape>(keys: ReadonlyArray<Key>, schema: ChainProbeSchema<Shape>, mode: ChainProbeMode) => Effect.Effect<ReadonlyArray<Shape | null>, ChainProbeError>;
+}
+interface ChainProbeError {
+  readonly _tag: 'ChainProbeError';
+  readonly reason: 'decode-failed' | 'not-found' | 'transient' | 'no-probe-registered';
+  readonly chain: string;
+  readonly detail: string;
+}
+//#endregion
+export { ChainProbe, ChainProbeError, ChainProbeMode };
+//# sourceMappingURL=chain-probe.d.mts.map

package/dist/contracts/chain-probe.mjs

@@ -0,0 +1,8 @@
+//#region src/contracts/chain-probe.ts
+/** Capability-key constructor — chain-probes are dispatched through
+*  the StrategyContributor registry by this key shape. */
+const chainProbeCapabilityKey = (chain) => `chain-probe:${chain}`;
+//#endregion
+export { chainProbeCapabilityKey };
+
+//# sourceMappingURL=chain-probe.mjs.map

package/dist/contracts/chain-probe.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain-probe.mjs","names":[],"sources":["../../src/contracts/chain-probe.ts"],"sourcesContent":["// ChainProbe capability contract (architecture §9).\n//\n// Typed, schema-validated read surface over an on-chain RPC.\n// Consumers never depend on raw SDK property access.\n//\n// Lenient mode returns absence for both not-found and transient RPC\n// failure (so verify probes re-derive on the next cycle); strict\n// throws on transient failure.\n\nimport type { Effect, Schema } from 'effect';\n\nimport type { ChainId } from '../substrate/brand.ts';\n\nexport type ChainProbeMode = 'lenient' | 'strict';\n\n/** Capability-key constructor — chain-probes are dispatched through\n *  the StrategyContributor registry by this key shape. */\nexport const chainProbeCapabilityKey = (chain: ChainId): `chain-probe:${string}` =>\n\t`chain-probe:${chain}`;\n\n/**\n * Plugin-typed read interface. `Key` is the chain's native id\n * shape (object id, tx digest); `Shape` is the expected decoded\n * shape.\n */\n/** Schema-shape accepted by the probe. We constrain `DecodingServices`\n *  to `never` because the probe pipeline cannot inject services from\n *  the caller — schemas with dependencies are unsupported here. */\nexport type ChainProbeSchema<Shape> = Schema.Codec<Shape, unknown, never, never>;\n\nexport interface ChainProbe<Key> {\n\treadonly get: <Shape>(\n\t\tkey: Key,\n\t\tschema: ChainProbeSchema<Shape>,\n\t\tmode: ChainProbeMode,\n\t) => Effect.Effect<Shape | null, ChainProbeError>;\n\treadonly batchGet?: <Shape>(\n\t\tkeys: ReadonlyArray<Key>,\n\t\tschema: ChainProbeSchema<Shape>,\n\t\tmode: ChainProbeMode,\n\t) => Effect.Effect<ReadonlyArray<Shape | null>, ChainProbeError>;\n}\n\nexport interface ChainProbeError {\n\treadonly _tag: 'ChainProbeError';\n\treadonly reason: 'decode-failed' | 'not-found' | 'transient' | 'no-probe-registered';\n\treadonly chain: string;\n\treadonly detail: string;\n}\n"],"mappings":";;;AAiBA,MAAa,2BAA2B,UACvC,eAAe"}

package/dist/contracts/codegenable.d.mts

@@ -0,0 +1,43 @@
+import { Effect } from "effect";
+
+//#region src/contracts/codegenable.d.ts
+/**
+ * Opaque per-file emission context.
+ *
+ * Plugin authors declare named generated exports by calling
+ * `exportConst(...)`. The orchestrator owns how those declarations are
+ * collected, rendered, grouped, permissioned, and written. Emitters do
+ * not return a raw `{ [exportName]: value }` record, which keeps the
+ * codegen contract focused on the public generated file shape instead
+ * of an internal renderer payload.
+ */
+interface CodegenEmitContext {
+  /** Add one `export const <name> = <value> as const;` to the file. */
+  readonly exportConst: (name: string, value: unknown) => void;
+  /** Add a raw import statement before the generated exports. */
+  readonly importStatement: (statement: string) => void;
+  /** Finish emission after all exports/imports have been written. */
+  readonly done: () => CodegenEmitDone;
+}
+interface CodegenEmitDone {
+  readonly _tag: 'CodegenEmitDone';
+}
+/**
+ * Codegen contribution. `Emitter` is a literal emitter name used
+ * by the codegen orchestrator for attribution and grouping.
+ */
+interface CodegenableDecl<Emitter extends string = string> {
+  readonly kind: 'codegenable';
+  readonly emitterName: Emitter;
+  /** Relative path under the codegen staging dir. */
+  readonly outputPath: string;
+  /** Optional sensitivity flag — drives file permissions and
+   *  `.gitignore` inclusion. */
+  readonly sensitive?: boolean;
+  /** Emit operation; writes generated file declarations through the
+   *  supplied context. */
+  readonly emit: (ctx: CodegenEmitContext) => Effect.Effect<CodegenEmitDone>;
+}
+//#endregion
+export { CodegenEmitContext, CodegenEmitDone, CodegenableDecl };
+//# sourceMappingURL=codegenable.d.mts.map