@mysten-incubation/devstack 0.0.1 → 0.1.1

package/dist/cli/wirings/apply.mjs

@@ -0,0 +1,95 @@
+import { StackPathsService } from "../../substrate/runtime/paths.mjs";
+import { makeProjectionRef } from "../../substrate/runtime/projection/state-ref.mjs";
+import { writeProjectionSnapshot } from "../../substrate/runtime/projection/persisted.mjs";
+import { commandChannelPaths, makeCommandChannelPublisher } from "../../substrate/runtime/cross-process/command-channel/channel.mjs";
+import { SnapshotOrchestratorService } from "../../orchestrators/snapshot/service.mjs";
+import "../../substrate/runtime/index.mjs";
+import { superviseStackEffect } from "../../orchestrators/run.mjs";
+import "../../orchestrators/snapshot/index.mjs";
+import { buildProductionOrchestratorSinks, buildProductionPostAcquireHook } from "../../orchestrators/runtime-composition.mjs";
+import { extendBuiltInPluginContext, layerBuiltInPluginRuntime } from "../../orchestrators/built-in-plugin-layers.mjs";
+import { ExitCode } from "../../surfaces/cli/sysexits.mjs";
+import { CliInternalError } from "../../surfaces/cli/errors.mjs";
+import { probeSupervisorPresence } from "../../surfaces/cli/commands/supervisor-presence.mjs";
+import "../../surfaces/cli/commands/index.mjs";
+import { cliErrorFromConfigExit } from "../bail.mjs";
+import { makeConfigLoader } from "./config-loader.mjs";
+import { identityValueFor, resolvedIdentityForStack, stackRootFor } from "./identity.mjs";
+import { buildVerbLayers } from "./build-verb-layers.mjs";
+import { Cause, Effect, Exit, Logger, SubscriptionRef } from "effect";
+import { dirname, resolve } from "node:path";
+//#region src/cli/wirings/apply.ts
+const LIVE_APPLY_ACK_TIMEOUT_MILLIS = 600 * 1e3;
+/** Probe the roster file; if a supervisor is live, publish
+*  `apply.requested` and await its ack. */
+const runApplyAgainstLiveSupervisor = (identity, identityValue) => Effect.gen(function* () {
+	const stackRoot = stackRootFor(identity.runtimeRoot, String(identityValue.stack));
+	if (!(yield* probeSupervisorPresence(resolve(stackRoot, "roster.json")).pipe(Effect.catch(() => Effect.succeed({
+		live: false,
+		pid: null,
+		hostname: null
+	})))).live) return { kind: "direct" };
+	const exit = yield* Effect.exit(Effect.gen(function* () {
+		const publisher = yield* makeCommandChannelPublisher(commandChannelPaths(stackRoot));
+		const published = yield* publisher.publish({ tag: "apply.requested" });
+		const reply = yield* publisher.awaitCompletion(published, { timeoutMillis: LIVE_APPLY_ACK_TIMEOUT_MILLIS });
+		if (!reply.ok) return yield* Effect.fail(reply.message);
+	}));
+	if (Exit.isFailure(exit)) return {
+		kind: "live-failed",
+		error: new CliInternalError({
+			message: "live stack apply failed",
+			cause: Cause.pretty(exit.cause)
+		})
+	};
+	return { kind: "live-ok" };
+});
+const runApplyLive = (configPath, identity) => {
+	const loader = makeConfigLoader();
+	return Effect.gen(function* () {
+		const loadExit = yield* Effect.exit(loader.load(configPath));
+		if (Exit.isFailure(loadExit)) return yield* Effect.fail(cliErrorFromConfigExit(loadExit));
+		const loaded = loadExit.value;
+		const stack = loaded.stack;
+		const effectiveIdentity = resolvedIdentityForStack(identity, stack);
+		const identityValue = identityValueFor(effectiveIdentity);
+		const dispatch = yield* runApplyAgainstLiveSupervisor(effectiveIdentity, identityValue);
+		if (dispatch.kind === "live-failed") return yield* Effect.fail(dispatch.error);
+		if (dispatch.kind === "live-ok") return { exitCode: ExitCode.OK };
+		const substrateLayers = buildVerbLayers({
+			identity: identityValue,
+			stack,
+			appRoot: dirname(loaded.resolvedConfigPath),
+			runtimeRoot: effectiveIdentity.runtimeRoot
+		});
+		return yield* Effect.gen(function* () {
+			const state = yield* makeProjectionRef();
+			const orchestratorSinks = yield* buildProductionOrchestratorSinks();
+			const postAcquireHook = yield* buildProductionPostAcquireHook({ extras: stack.options.extras });
+			yield* (yield* SnapshotOrchestratorService).recoverPendingRestore.pipe(Effect.tapCause((cause) => Effect.sync(() => {
+				process.stderr.write(`snapshot recovery scan failed: ${Cause.pretty(cause)}\n`);
+			})), Effect.catch(() => Effect.succeed(null)));
+			yield* superviseStackEffect({
+				_tag: "Stack",
+				members: stack.members,
+				options: stack.options
+			}, identityValue, state, {
+				orchestratorSinks,
+				postAcquireHook,
+				lifetime: "one-shot",
+				extendContext: extendBuiltInPluginContext
+			}).pipe(Effect.provide(layerBuiltInPluginRuntime(orchestratorSinks)));
+			yield* writeProjectionSnapshot((yield* StackPathsService).stackRoot, yield* SubscriptionRef.get(state));
+		}).pipe(Effect.provide(substrateLayers), Effect.provide(Logger.layer([Logger.consolePretty()])), Effect.matchCauseEffect({
+			onFailure: (cause) => Effect.fail(new CliInternalError({
+				message: "stack apply failed",
+				cause: Cause.pretty(cause)
+			})),
+			onSuccess: () => Effect.succeed({ exitCode: ExitCode.OK })
+		}));
+	});
+};
+//#endregion
+export { runApplyLive };
+
+//# sourceMappingURL=apply.mjs.map

package/dist/cli/wirings/apply.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.mjs","names":["resolvePath"],"sources":["../../../src/cli/wirings/apply.ts"],"sourcesContent":["// `devstack apply` verb wiring.\n//\n// Live-aware: if a supervisor owns the selected stack, publish an\n// `apply.requested` command and await its ack. Otherwise run a\n// one-shot supervise that exits when all plugins are ready.\n//\n// Logger layer: `Logger.consolePretty()`. `apply` is the documented\n// one-shot mode (no TUI) — its consumers are CI logs and ad-hoc\n// operator runs that read raw stderr. Structured `Effect.log*` records\n// are the only operator-visible diagnostic for non-TUI surfaces, so we\n// route them through the pretty console layer. The sibling `up` verb\n// silences this layer (see `wirings/up.ts` header) because it owns the\n// TUI and would render duplicate / scrambled output otherwise.\n\nimport { dirname, resolve as resolvePath } from 'node:path';\n\nimport { Cause, Effect, Exit, Logger, SubscriptionRef } from 'effect';\n\nimport type { Identity } from '../../substrate/identity.ts';\nimport { StackPathsService } from '../../substrate/runtime/paths.ts';\nimport {\n\tcommandChannelPaths,\n\tmakeCommandChannelPublisher,\n\tmakeProjectionRef,\n\ttype SupervisedStack,\n\twriteProjectionSnapshot,\n} from '../../substrate/runtime/index.ts';\nimport { superviseStackEffect } from '../../orchestrators/run.ts';\nimport {\n\tbuildProductionOrchestratorSinks,\n\tbuildProductionPostAcquireHook,\n} from '../../orchestrators/runtime-composition.ts';\nimport {\n\textendBuiltInPluginContext,\n\tlayerBuiltInPluginRuntime,\n} from '../../orchestrators/built-in-plugin-layers.ts';\nimport { SnapshotOrchestratorService } from '../../orchestrators/snapshot/index.ts';\nimport { type CliError, CliInternalError } from '../../surfaces/cli/errors.ts';\nimport { type CommandResult, probeSupervisorPresence } from '../../surfaces/cli/commands/index.ts';\nimport { ExitCode } from '../../surfaces/cli/sysexits.ts';\nimport type { LoadedConfig } from '../../surfaces/cli/commands/config-loader.ts';\n\nimport { cliErrorFromConfigExit } from '../bail.ts';\nimport { makeConfigLoader } from './config-loader.ts';\nimport {\n\tidentityValueFor,\n\tresolvedIdentityForStack,\n\tstackRootFor,\n\ttype ResolvedIdentity,\n} from './identity.ts';\nimport { buildVerbLayers } from './build-verb-layers.ts';\n\nconst LIVE_APPLY_ACK_TIMEOUT_MILLIS = 10 * 60 * 1000;\n\n/** Outcome of the live-supervisor probe + dispatch:\n *  - `kind: 'direct'` — no supervisor; caller runs the direct path.\n *  - `kind: 'live-ok'` — live supervisor acked; verb is done.\n *  - `kind: 'live-failed'` — live supervisor refused/timed-out; caller\n *    surfaces the typed `CliError` via the dispatcher envelope. */\ntype ApplyDispatch =\n\t| { readonly kind: 'direct' }\n\t| { readonly kind: 'live-ok' }\n\t| { readonly kind: 'live-failed'; readonly error: CliError };\n\n/** Probe the roster file; if a supervisor is live, publish\n *  `apply.requested` and await its ack. */\nconst runApplyAgainstLiveSupervisor = (\n\tidentity: ResolvedIdentity,\n\tidentityValue: Identity,\n): Effect.Effect<ApplyDispatch> =>\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 { kind: 'direct' as const };\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, {\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\treturn {\n\t\t\t\tkind: 'live-failed' as const,\n\t\t\t\terror: new CliInternalError({\n\t\t\t\t\tmessage: 'live stack apply failed',\n\t\t\t\t\tcause: Cause.pretty(exit.cause as Cause.Cause<unknown>),\n\t\t\t\t}),\n\t\t\t};\n\t\t}\n\n\t\treturn { kind: 'live-ok' as const };\n\t});\n\nexport const runApplyLive = (\n\tconfigPath: string | undefined,\n\tidentity: ResolvedIdentity,\n): Effect.Effect<CommandResult, CliError> => {\n\tconst loader = makeConfigLoader();\n\treturn Effect.gen(function* () {\n\t\t// Config-load failures surface as typed `CliError`s; the\n\t\t// dispatcher's outer `emitFailure` renders the envelope.\n\t\tconst loadExit = yield* Effect.exit(loader.load(configPath));\n\t\tif (Exit.isFailure(loadExit)) {\n\t\t\treturn yield* Effect.fail(cliErrorFromConfigExit(loadExit));\n\t\t}\n\t\tconst loaded = loadExit.value;\n\t\tconst stack = (loaded as LoadedConfig & { readonly stack: SupervisedStack }).stack;\n\t\t// Re-derive the identity against the EFFECTIVE stack (explicit\n\t\t// `--stack`/`$DEVSTACK_STACK` > `config.stackName` > inferred) so\n\t\t// the live-supervisor probe + roster paths target the same stack\n\t\t// the operator selected — matching `snapshot.ts`. An explicit\n\t\t// `--stack` must NOT be overridden by `config.stackName`, otherwise\n\t\t// `apply` would probe/boot the wrong stack's supervisor.\n\t\tconst effectiveIdentity = resolvedIdentityForStack(identity, stack);\n\t\tconst identityValue: Identity = identityValueFor(effectiveIdentity);\n\t\tconst dispatch = yield* runApplyAgainstLiveSupervisor(effectiveIdentity, identityValue);\n\t\tif (dispatch.kind === 'live-failed') {\n\t\t\treturn yield* Effect.fail(dispatch.error);\n\t\t}\n\t\tif (dispatch.kind === 'live-ok') {\n\t\t\treturn { exitCode: ExitCode.OK };\n\t\t}\n\t\tconst appRoot = dirname(loaded.resolvedConfigPath);\n\t\tconst substrateLayers = buildVerbLayers({\n\t\t\tidentity: identityValue,\n\t\t\tstack,\n\t\t\tappRoot,\n\t\t\truntimeRoot: effectiveIdentity.runtimeRoot,\n\t\t});\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\t// Mirror the up-path recovery: reconcile any half-promoted\n\t\t\t// snapshot restore from a prior supervise BEFORE the one-shot\n\t\t\t// apply starts the stack. Idempotent + no-op when no marker.\n\t\t\tconst snapshot = yield* SnapshotOrchestratorService;\n\t\t\tyield* snapshot.recoverPendingRestore.pipe(\n\t\t\t\tEffect.tapCause((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`snapshot recovery scan 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\tEffect.catch(() => Effect.succeed(null)),\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\treturn yield* 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): Effect.Effect<CommandResult, CliError> =>\n\t\t\t\t\tEffect.fail(\n\t\t\t\t\t\tnew CliInternalError({\n\t\t\t\t\t\t\tmessage: 'stack apply failed',\n\t\t\t\t\t\t\tcause: Cause.pretty(cause as Cause.Cause<unknown>),\n\t\t\t\t\t\t}),\n\t\t\t\t\t),\n\t\t\t\tonSuccess: (): Effect.Effect<CommandResult, CliError> =>\n\t\t\t\t\tEffect.succeed({ exitCode: ExitCode.OK }),\n\t\t\t}),\n\t\t);\n\t});\n};\n"],"mappings":"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"}

package/dist/cli/wirings/build-verb-layers.mjs

@@ -0,0 +1,42 @@
+import { buildSubstrateLayers } from "../../orchestrators/run.mjs";
+import { layerProductionOrchestrators } from "../../orchestrators/runtime-composition.mjs";
+import { resolveCodegenOutput } from "../../orchestrators/codegen/output-location.mjs";
+import { Layer } from "effect";
+//#region src/cli/wirings/build-verb-layers.ts
+/** Compose substrate + orchestrator Layers for a verb that knows its
+*  stack-config (i.e. has a `loaded` config and can pass codegen
+*  options). Use `buildDirectSnapshotLayers` when the verb does NOT
+*  load a config (e.g. restore/delete/wipe).
+*
+*  Resolves the per-stack codegen output location HERE — the one boot
+*  seam where both the primary stack (`stack.options.stackName`) and the
+*  EFFECTIVE stack (`String(identity.stack)`, already run through the
+*  explicit-`--stack` > `config.stackName` > inferred precedence ladder
+*  by `resolvedIdentityForStack`/`identityValueFor` upstream) are in
+*  scope. The primary run emits into `src/generated/`; a secondary run
+*  (concurrent `--stack e2e`/etc.) emits into
+*  `.devstack/stacks/<stack>/generated/` so the two never clobber. The
+*  resolved literal `outputDir`/`stackSubdir` flow into
+*  `layerProductionOrchestrators` unchanged — `paths.ts` keeps consuming
+*  a literal, minimal blast radius. */
+const buildVerbLayers = (params) => {
+	const codegenOutput = resolveCodegenOutput({
+		appRoot: params.appRoot,
+		effectiveStack: String(params.identity.stack),
+		primaryStack: params.stack.options.stackName,
+		explicitOutputDir: params.stack.options.codegen?.outputDir,
+		explicitStackSubdir: params.stack.options.codegen?.stackSubdir ?? null
+	});
+	return layerProductionOrchestrators({ codegen: {
+		appRoot: params.appRoot,
+		outputDir: codegenOutput.outputDir,
+		stackSubdir: codegenOutput.stackSubdir
+	} }).pipe(Layer.provideMerge(buildSubstrateLayers(params.identity, params.runtimeRoot)));
+};
+/** Substrate + (default-codegen) orchestrator Layers for verbs that
+*  don't load a config. */
+const buildDirectSnapshotLayers = (params) => layerProductionOrchestrators().pipe(Layer.provideMerge(buildSubstrateLayers(params.identity, params.runtimeRoot)));
+//#endregion
+export { buildDirectSnapshotLayers, buildVerbLayers };
+
+//# sourceMappingURL=build-verb-layers.mjs.map

package/dist/cli/wirings/build-verb-layers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-verb-layers.mjs","names":[],"sources":["../../../src/cli/wirings/build-verb-layers.ts"],"sourcesContent":["// Shared substrate + orchestrator Layer composition for verb wirings.\n//\n// The CLI verbs that boot a substrate (`up`, `apply --direct`, snapshot\n// capture --direct) all build the same composition:\n//   - `layerProductionOrchestrators({ codegen })` on top of\n//   - `buildSubstrateLayers(identity, runtimeRoot)`.\n//\n// Extracted here so each wiring file references one helper instead of\n// rebuilding the composition inline (formerly ~5 sites in `main.ts`).\n\nimport { Layer } from 'effect';\n\nimport type { Identity } from '../../substrate/identity.ts';\nimport { buildSubstrateLayers } from '../../orchestrators/run.ts';\nimport { layerProductionOrchestrators } from '../../orchestrators/runtime-composition.ts';\nimport { resolveCodegenOutput } from '../../orchestrators/codegen/output-location.ts';\nimport type { SupervisedStack } from '../../substrate/runtime/index.ts';\n\n/** Compose substrate + orchestrator Layers for a verb that knows its\n *  stack-config (i.e. has a `loaded` config and can pass codegen\n *  options). Use `buildDirectSnapshotLayers` when the verb does NOT\n *  load a config (e.g. restore/delete/wipe).\n *\n *  Resolves the per-stack codegen output location HERE — the one boot\n *  seam where both the primary stack (`stack.options.stackName`) and the\n *  EFFECTIVE stack (`String(identity.stack)`, already run through the\n *  explicit-`--stack` > `config.stackName` > inferred precedence ladder\n *  by `resolvedIdentityForStack`/`identityValueFor` upstream) are in\n *  scope. The primary run emits into `src/generated/`; a secondary run\n *  (concurrent `--stack e2e`/etc.) emits into\n *  `.devstack/stacks/<stack>/generated/` so the two never clobber. The\n *  resolved literal `outputDir`/`stackSubdir` flow into\n *  `layerProductionOrchestrators` unchanged — `paths.ts` keeps consuming\n *  a literal, minimal blast radius. */\nexport const buildVerbLayers = (params: {\n\treadonly identity: Identity;\n\treadonly stack: SupervisedStack;\n\treadonly appRoot: string;\n\treadonly runtimeRoot: string;\n}) => {\n\tconst codegenOutput = resolveCodegenOutput({\n\t\tappRoot: params.appRoot,\n\t\teffectiveStack: String(params.identity.stack),\n\t\tprimaryStack: params.stack.options.stackName,\n\t\texplicitOutputDir: params.stack.options.codegen?.outputDir,\n\t\texplicitStackSubdir: params.stack.options.codegen?.stackSubdir ?? null,\n\t});\n\treturn layerProductionOrchestrators({\n\t\tcodegen: {\n\t\t\tappRoot: params.appRoot,\n\t\t\toutputDir: codegenOutput.outputDir,\n\t\t\tstackSubdir: codegenOutput.stackSubdir,\n\t\t},\n\t}).pipe(Layer.provideMerge(buildSubstrateLayers(params.identity, params.runtimeRoot)));\n};\n\n/** Substrate + (default-codegen) orchestrator Layers for verbs that\n *  don't load a config. */\nexport const buildDirectSnapshotLayers = (params: {\n\treadonly identity: Identity;\n\treadonly runtimeRoot: string;\n}) =>\n\tlayerProductionOrchestrators().pipe(\n\t\tLayer.provideMerge(buildSubstrateLayers(params.identity, params.runtimeRoot)),\n\t);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAkCA,MAAa,mBAAmB,WAK1B;CACL,MAAM,gBAAgB,qBAAqB;EAC1C,SAAS,OAAO;EAChB,gBAAgB,OAAO,OAAO,SAAS,MAAM;EAC7C,cAAc,OAAO,MAAM,QAAQ;EACnC,mBAAmB,OAAO,MAAM,QAAQ,SAAS;EACjD,qBAAqB,OAAO,MAAM,QAAQ,SAAS,eAAe;EAClE,CAAC;AACF,QAAO,6BAA6B,EACnC,SAAS;EACR,SAAS,OAAO;EAChB,WAAW,cAAc;EACzB,aAAa,cAAc;EAC3B,EACD,CAAC,CAAC,KAAK,MAAM,aAAa,qBAAqB,OAAO,UAAU,OAAO,YAAY,CAAC,CAAC;;;;AAKvF,MAAa,6BAA6B,WAIzC,8BAA8B,CAAC,KAC9B,MAAM,aAAa,qBAAqB,OAAO,UAAU,OAAO,YAAY,CAAC,CAC7E"}

package/dist/cli/wirings/config-loader.mjs

@@ -0,0 +1,69 @@
+import { readStackEngine } from "../../api/define-devstack.mjs";
+import { CliConfigInvalidError, CliConfigNotFoundError } from "../../surfaces/cli/errors.mjs";
+import "../../surfaces/cli/index.mjs";
+import { Effect } from "effect";
+import { existsSync } from "node:fs";
+import { isAbsolute, resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+//#region src/cli/wirings/config-loader.ts
+const DEFAULT_CONFIG_PATH = "./devstack.config.ts";
+/** Resolve a `--config <path>` argument to an absolute path, falling
+*  through to a parent-directory search when the default value is
+*  used. Returns `null` when no candidate exists. */
+const resolveConfigPath = (configPath) => {
+	const target = configPath ?? "./devstack.config.ts";
+	const explicit = isAbsolute(target) ? target : resolve(process.cwd(), target);
+	if (existsSync(explicit)) return explicit;
+	if (configPath !== void 0 && configPath !== "./devstack.config.ts") return null;
+	let dir = process.cwd();
+	for (;;) {
+		const candidate = resolve(dir, "devstack.config.ts");
+		if (existsSync(candidate)) return candidate;
+		const parent = resolve(dir, "..");
+		if (parent === dir) return null;
+		dir = parent;
+	}
+};
+const validateStackModule = (resolvedConfigPath, mod) => {
+	const def = mod.default;
+	if (def === null || typeof def !== "object" || def._tag !== "Stack") throw new CliConfigInvalidError({ message: `config at ${resolvedConfigPath} does not default-export a Stack value (got _tag=${String(def?._tag)})` });
+	let stack;
+	try {
+		stack = readStackEngine(def);
+	} catch (cause) {
+		throw new CliConfigInvalidError({ message: `config at ${resolvedConfigPath} default-exported an invalid Stack handle: ${cause instanceof Error ? cause.message : String(cause)}` });
+	}
+	return {
+		stack,
+		resolvedConfigPath
+	};
+};
+const makeConfigLoader = () => ({ load: (configPath) => Effect.gen(function* () {
+	const abs = resolveConfigPath(configPath);
+	if (abs === null) {
+		const attempted = configPath !== void 0 ? resolve(process.cwd(), configPath) : resolve(process.cwd(), DEFAULT_CONFIG_PATH);
+		return yield* Effect.fail(new CliConfigNotFoundError({
+			message: `devstack config not found at ${attempted}`,
+			searchedPaths: [attempted]
+		}));
+	}
+	const url = pathToFileURL(abs).href;
+	const mod = yield* Effect.tryPromise({
+		try: () => import(url),
+		catch: (cause) => new CliConfigInvalidError({
+			message: `failed to import ${abs}: ${cause instanceof Error ? cause.message : String(cause)}`,
+			cause
+		})
+	});
+	return yield* Effect.try({
+		try: () => validateStackModule(abs, mod),
+		catch: (cause) => cause instanceof CliConfigInvalidError ? cause : new CliConfigInvalidError({
+			message: `invalid config at ${abs}`,
+			cause
+		})
+	});
+}) });
+//#endregion
+export { makeConfigLoader, resolveConfigPath };
+
+//# sourceMappingURL=config-loader.mjs.map

package/dist/cli/wirings/config-loader.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.mjs","names":["resolvePath","m"],"sources":["../../../src/cli/wirings/config-loader.ts"],"sourcesContent":["// Shared config loader consumed by every verb wiring that imports a\n// `devstack.config.ts`. Returns a `LoadedConfig` whose `stack` field\n// is the validated `SupervisedStack` value.\n\nimport { existsSync } from 'node:fs';\nimport { isAbsolute, resolve as resolvePath } from 'node:path';\nimport { pathToFileURL } from 'node:url';\n\nimport { Effect } from 'effect';\n\nimport { readStackEngine, type Stack } from '../../api/define-devstack.ts';\nimport type { LoadedConfig } from '../../surfaces/cli/commands/config-loader.ts';\nimport { CliConfigInvalidError, CliConfigNotFoundError } from '../../surfaces/cli/index.ts';\nimport type { SupervisedStack } from '../../substrate/runtime/index.ts';\n\nexport const DEFAULT_CONFIG_PATH = './devstack.config.ts';\n\n/** Resolve a `--config <path>` argument to an absolute path, falling\n *  through to a parent-directory search when the default value is\n *  used. Returns `null` when no candidate exists. */\nexport const 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\nexport interface ConfigLoader {\n\treadonly load: (\n\t\tconfigPath: string | undefined,\n\t) => Effect.Effect<LoadedConfig, CliConfigNotFoundError | CliConfigInvalidError>;\n}\n\nexport const makeConfigLoader = (): ConfigLoader => ({\n\tload: (configPath) =>\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"],"mappings":";;;;;;;;AAeA,MAAa,sBAAsB;;;;AAKnC,MAAa,qBAAqB,eAAkD;CACnF,MAAM,SAAS,cAAA;CACf,MAAM,WAAW,WAAW,OAAO,GAAG,SAASA,QAAY,QAAQ,KAAK,EAAE,OAAO;AACjF,KAAI,WAAW,SAAS,CAAE,QAAO;AACjC,KAAI,eAAe,KAAA,KAAa,eAAA,uBAAoC,QAAO;CAC3E,IAAI,MAAM,QAAQ,KAAK;AACvB,UAAS;EACR,MAAM,YAAYA,QAAY,KAAK,qBAAqB;AACxD,MAAI,WAAW,UAAU,CAAE,QAAO;EAClC,MAAM,SAASA,QAAY,KAAK,KAAK;AACrC,MAAI,WAAW,IAAK,QAAO;AAC3B,QAAM;;;AAQR,MAAM,uBACL,oBACA,QACwD;CAExD,MAAM,MAAMC,IAAE;AACd,KAAI,QAAQ,QAAQ,OAAO,QAAQ,YAAa,IAA2B,SAAS,QACnF,OAAM,IAAI,sBAAsB,EAC/B,SAAS,aAAa,mBAAmB,mDAAmD,OAAQ,KAA4B,KAAK,CAAC,IACtI,CAAC;CAEH,IAAI;AACJ,KAAI;AACH,UAAQ,gBAAgB,IAAyC;UACzD,OAAO;AACf,QAAM,IAAI,sBAAsB,EAC/B,SAAS,aAAa,mBAAmB,6CAA6C,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,IAC5I,CAAC;;AAEH,QAAO;EACN;EACA;EACA;;AASF,MAAa,0BAAwC,EACpD,OAAO,eACN,OAAO,IAAI,aAAa;CACvB,MAAM,MAAM,kBAAkB,WAAW;AACzC,KAAI,QAAQ,MAAM;EACjB,MAAM,YACL,eAAe,KAAA,IACZD,QAAY,QAAQ,KAAK,EAAE,WAAW,GACtCA,QAAY,QAAQ,KAAK,EAAE,oBAAoB;AACnD,SAAO,OAAO,OAAO,KACpB,IAAI,uBAAuB;GAC1B,SAAS,gCAAgC;GACzC,eAAe,CAAC,UAAU;GAC1B,CAAC,CACF;;CAEF,MAAM,MAAM,cAAc,IAAI,CAAC;CAC/B,MAAM,MAAM,OAAO,OAAO,WAAW;EACpC,WAAW,OAAO;EAClB,QAAQ,UACP,IAAI,sBAAsB;GACzB,SAAS,oBAAoB,IAAI,IAAI,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;GAC3F;GACA,CAAC;EACH,CAAC;AACF,QAAO,OAAO,OAAO,IAAI;EACxB,WAAW,oBAAoB,KAAK,IAAI;EACxC,QAAQ,UACP,iBAAiB,wBACd,QACA,IAAI,sBAAsB;GAC1B,SAAS,qBAAqB;GAC9B;GACA,CAAC;EACL,CAAC;EACD,EACH"}

package/dist/cli/wirings/engine-command.mjs

@@ -0,0 +1,30 @@
+//#region src/cli/wirings/engine-command.ts
+const hasString = (value, key) => typeof value[key] === "string";
+const isEngineCommand = (value) => {
+	if (typeof value !== "object" || value === null) return false;
+	const record = value;
+	const tag = record.tag;
+	if (typeof tag !== "string") return false;
+	switch (tag) {
+		case "stack.start":
+		case "stack.stop":
+		case "stack.restart":
+		case "codegen.requested":
+		case "snapshot.list":
+		case "wipe.requested":
+		case "prune.requested":
+		case "shutdown.requested": return true;
+		case "snapshot.restore":
+		case "snapshot.delete": return hasString(record, "snapshotId");
+		case "advance-clock.requested": return typeof record.toMillis === "number";
+		case "shutdown.hardKillRequested": return (record.signal === "SIGINT" || record.signal === "SIGTERM") && typeof record.exitCode === "number" && typeof record.at === "number";
+		case "selective-restart.requested": return hasString(record, "pluginKey");
+		case "apply.requested": return record.pluginKey === void 0 || typeof record.pluginKey === "string";
+		case "snapshot.capture": return (record.snapshotId === void 0 || typeof record.snapshotId === "string") && (record.name === void 0 || typeof record.name === "string");
+		default: return false;
+	}
+};
+//#endregion
+export { isEngineCommand };
+
+//# sourceMappingURL=engine-command.mjs.map

package/dist/cli/wirings/engine-command.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-command.mjs","names":["knownTag"],"sources":["../../../src/cli/wirings/engine-command.ts"],"sourcesContent":["// Type guard for `EngineCommand` records arriving over the\n// cross-process command channel. Exhaustive switch over the union's\n// tag — a new variant added without a corresponding case here fails\n// typecheck on the `_exhaustive: never` proof so we never drift.\n\nimport type { EngineCommand } from '../../substrate/events.ts';\n\nconst hasString = (value: Record<string, unknown>, key: string): boolean =>\n\ttypeof value[key] === 'string';\n\nexport const isEngineCommand = (value: unknown): value is EngineCommand => {\n\tif (typeof value !== 'object' || value === null) return false;\n\tconst record = value as Record<string, unknown>;\n\tconst tag = record.tag;\n\tif (typeof tag !== 'string') return false;\n\tconst knownTag = tag as EngineCommand['tag'];\n\tswitch (knownTag) {\n\t\tcase 'stack.start':\n\t\tcase 'stack.stop':\n\t\tcase 'stack.restart':\n\t\tcase 'codegen.requested':\n\t\tcase 'snapshot.list':\n\t\tcase 'wipe.requested':\n\t\tcase 'prune.requested':\n\t\tcase 'shutdown.requested':\n\t\t\treturn true;\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\tconst _exhaustive: never = knownTag;\n\t\t\tvoid _exhaustive;\n\t\t\treturn false;\n\t\t}\n\t}\n};\n"],"mappings":";AAOA,MAAM,aAAa,OAAgC,QAClD,OAAO,MAAM,SAAS;AAEvB,MAAa,mBAAmB,UAA2C;AAC1E,KAAI,OAAO,UAAU,YAAY,UAAU,KAAM,QAAO;CACxD,MAAM,SAAS;CACf,MAAM,MAAM,OAAO;AACnB,KAAI,OAAO,QAAQ,SAAU,QAAO;AAEpC,SAAQA,KAAR;EACC,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK,qBACJ,QAAO;EACR,KAAK;EACL,KAAK,kBACJ,QAAO,UAAU,QAAQ,aAAa;EACvC,KAAK,0BACJ,QAAO,OAAO,OAAO,aAAa;EACnC,KAAK,6BACJ,SACE,OAAO,WAAW,YAAY,OAAO,WAAW,cACjD,OAAO,OAAO,aAAa,YAC3B,OAAO,OAAO,OAAO;EAEvB,KAAK,8BACJ,QAAO,UAAU,QAAQ,YAAY;EACtC,KAAK,kBACJ,QAAO,OAAO,cAAc,KAAA,KAAa,OAAO,OAAO,cAAc;EACtE,KAAK,mBACJ,SACE,OAAO,eAAe,KAAA,KAAa,OAAO,OAAO,eAAe,cAChE,OAAO,SAAS,KAAA,KAAa,OAAO,OAAO,SAAS;EAEvD,QAGC,QAAO"}

package/dist/cli/wirings/identity.mjs

@@ -0,0 +1,72 @@
+import { appName, chainId, stackName } from "../../substrate/brand.mjs";
+import { CliSupervisorLiveError } from "../../surfaces/cli/errors.mjs";
+import { probeSupervisorPresence } from "../../surfaces/cli/commands/supervisor-presence.mjs";
+import "../../surfaces/cli/commands/index.mjs";
+import "../../surfaces/cli/index.mjs";
+import { Cause, Effect } from "effect";
+import { resolve } from "node:path";
+//#region src/cli/wirings/identity.ts
+const stackRootFor = (runtimeRoot, stack) => resolve(runtimeRoot, "stacks", stack);
+/** Stack-name precedence ladder, mirrored from the state-dir ladder in
+*  `main.ts` (`--state-dir` flag > `config.stateDir` > env > default):
+*
+*    explicit `--stack` / `$DEVSTACK_STACK` (`identity.explicitStack`)
+*      > config's `defineDevstack({ stackName })` (`stack.options.stackName`)
+*      > cwd/package inference (already folded into `identity.stack`,
+*        default `'main'`).
+*
+*  The explicit rung MUST win over a config `stackName` so an operator
+*  can run `pnpm dev` (default stack) and `pnpm test:e2e` (a `test`/`e2e`
+*  stack via `--stack`/env) against the SAME config concurrently — the
+*  two supervisors then claim distinct stack roots instead of colliding
+*  on `error: supervisor live for <app>/<stack>` (exit 40). `runStack`
+*  (`api/run-stack.ts`) already prefers its explicit option over
+*  `stack.options.stackName`; this keeps the CLI consistent with it. */
+const effectiveStackName = (identity, stack) => identity.explicitStack ?? stack?.options.stackName ?? identity.stack;
+const identityValueFor = (identity, stack) => ({
+	app: appName(identity.app),
+	stack: stackName(effectiveStackName(identity, stack)),
+	chain: chainId(identity.network)
+});
+/** When a verb loads a config whose `stackName` may differ from the
+*  effective stack, re-derive the `ResolvedIdentity` against the
+*  effective stack so the stack-root, roster file, and command channel
+*  paths all target the same stack the supervisor uses. The effective
+*  stack follows the precedence ladder documented on `effectiveStackName`
+*  (explicit flag/env > config `stackName` > inferred), so an explicit
+*  `--stack`/`$DEVSTACK_STACK` is NOT overridden by `config.stackName`. */
+const resolvedIdentityForStack = (identity, stack) => {
+	const stackValue = effectiveStackName(identity, stack);
+	const stackRoot = stackRootFor(identity.runtimeRoot, stackValue);
+	return {
+		...identity,
+		stack: stackValue,
+		stackRoot,
+		rosterFile: resolve(stackRoot, "roster.json")
+	};
+};
+/** Probe the roster file; if a supervisor is live, refuse the verb
+*  with a `CliSupervisorLiveError` carrying the operator hint. */
+const ensureNoLiveSupervisor = (identity, hint) => Effect.gen(function* () {
+	if ((yield* probeSupervisorPresence(identity.rosterFile).pipe(Effect.catch(() => Effect.succeed({
+		live: false,
+		pid: null,
+		hostname: null
+	})))).live) return yield* Effect.fail(new CliSupervisorLiveError({
+		app: identity.app,
+		stack: identity.stack,
+		hint
+	}));
+});
+const findCliSupervisorLiveError = (cause) => {
+	for (const reason of cause.reasons) {
+		if (!Cause.isFailReason(reason)) continue;
+		const error = reason.error;
+		if (typeof error === "object" && error !== null && error._tag === "CliSupervisorLiveError") return error;
+	}
+	return null;
+};
+//#endregion
+export { ensureNoLiveSupervisor, findCliSupervisorLiveError, identityValueFor, resolvedIdentityForStack, stackRootFor };
+
+//# sourceMappingURL=identity.mjs.map

package/dist/cli/wirings/identity.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.mjs","names":["resolvePath"],"sources":["../../../src/cli/wirings/identity.ts"],"sourcesContent":["// Shared identity types + helpers consumed by every verb wiring.\n//\n// `ResolvedIdentity` is the flat CLI-internal identity bundle (app /\n// stack / network / runtimeRoot / stackRoot) that the `main.ts` argv\n// pre-parser produces. Wirings consume it directly; they do NOT\n// re-derive identity from process.env.\n\nimport { resolve as resolvePath } from 'node:path';\n\nimport { Cause, Effect } from 'effect';\n\nimport { appName, chainId, stackName } from '../../substrate/brand.ts';\nimport type { Identity } from '../../substrate/identity.ts';\nimport type { SupervisedStack } from '../../substrate/runtime/index.ts';\nimport { CliSupervisorLiveError } from '../../surfaces/cli/index.ts';\nimport { probeSupervisorPresence } from '../../surfaces/cli/commands/index.ts';\n\nexport interface 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\t/** The stack name the operator supplied EXPLICITLY via the `--stack`\n\t *  flag or `$DEVSTACK_STACK` env var — `undefined` when neither was\n\t *  given (i.e. `stack` above was cwd/package-inferred). Threaded from\n\t *  `main.ts`'s argv pre-parser so the stack-precedence ladder below\n\t *  can let an explicit flag/env beat a config-declared `stackName`. */\n\treadonly explicitStack?: string | undefined;\n}\n\nexport const stackRootFor = (runtimeRoot: string, stack: string): string =>\n\tresolvePath(runtimeRoot, 'stacks', stack);\n\n/** Stack-name precedence ladder, mirrored from the state-dir ladder in\n *  `main.ts` (`--state-dir` flag > `config.stateDir` > env > default):\n *\n *    explicit `--stack` / `$DEVSTACK_STACK` (`identity.explicitStack`)\n *      > config's `defineDevstack({ stackName })` (`stack.options.stackName`)\n *      > cwd/package inference (already folded into `identity.stack`,\n *        default `'main'`).\n *\n *  The explicit rung MUST win over a config `stackName` so an operator\n *  can run `pnpm dev` (default stack) and `pnpm test:e2e` (a `test`/`e2e`\n *  stack via `--stack`/env) against the SAME config concurrently — the\n *  two supervisors then claim distinct stack roots instead of colliding\n *  on `error: supervisor live for <app>/<stack>` (exit 40). `runStack`\n *  (`api/run-stack.ts`) already prefers its explicit option over\n *  `stack.options.stackName`; this keeps the CLI consistent with it. */\nconst effectiveStackName = (identity: ResolvedIdentity, stack?: SupervisedStack): string =>\n\tidentity.explicitStack ?? stack?.options.stackName ?? identity.stack;\n\nexport const identityValueFor = (\n\tidentity: ResolvedIdentity,\n\tstack?: SupervisedStack,\n): Identity => ({\n\tapp: appName(identity.app),\n\tstack: stackName(effectiveStackName(identity, stack)),\n\tchain: chainId(identity.network),\n});\n\n/** When a verb loads a config whose `stackName` may differ from the\n *  effective stack, re-derive the `ResolvedIdentity` against the\n *  effective stack so the stack-root, roster file, and command channel\n *  paths all target the same stack the supervisor uses. The effective\n *  stack follows the precedence ladder documented on `effectiveStackName`\n *  (explicit flag/env > config `stackName` > inferred), so an explicit\n *  `--stack`/`$DEVSTACK_STACK` is NOT overridden by `config.stackName`. */\nexport const resolvedIdentityForStack = (\n\tidentity: ResolvedIdentity,\n\tstack: SupervisedStack,\n): ResolvedIdentity => {\n\tconst stackValue = effectiveStackName(identity, stack);\n\tconst stackRoot = stackRootFor(identity.runtimeRoot, stackValue);\n\treturn {\n\t\t...identity,\n\t\tstack: stackValue,\n\t\tstackRoot,\n\t\trosterFile: resolvePath(stackRoot, 'roster.json'),\n\t};\n};\n\n/** Probe the roster file; if a supervisor is live, refuse the verb\n *  with a `CliSupervisorLiveError` carrying the operator hint. */\nexport const 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\nexport const findCliSupervisorLiveError = (\n\tcause: Cause.Cause<unknown>,\n): 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 (\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"],"mappings":";;;;;;;;AAiCA,MAAa,gBAAgB,aAAqB,UACjDA,QAAY,aAAa,UAAU,MAAM;;;;;;;;;;;;;;;;AAiB1C,MAAM,sBAAsB,UAA4B,UACvD,SAAS,iBAAiB,OAAO,QAAQ,aAAa,SAAS;AAEhE,MAAa,oBACZ,UACA,WACe;CACf,KAAK,QAAQ,SAAS,IAAI;CAC1B,OAAO,UAAU,mBAAmB,UAAU,MAAM,CAAC;CACrD,OAAO,QAAQ,SAAS,QAAQ;CAChC;;;;;;;;AASD,MAAa,4BACZ,UACA,UACsB;CACtB,MAAM,aAAa,mBAAmB,UAAU,MAAM;CACtD,MAAM,YAAY,aAAa,SAAS,aAAa,WAAW;AAChE,QAAO;EACN,GAAG;EACH,OAAO;EACP;EACA,YAAYA,QAAY,WAAW,cAAc;EACjD;;;;AAKF,MAAa,0BACZ,UACA,SAEA,OAAO,IAAI,aAAa;AAIvB,MAAI,OAHoB,wBAAwB,SAAS,WAAW,CAAC,KACpE,OAAO,YAAY,OAAO,QAAQ;EAAE,MAAM;EAAO,KAAK;EAAM,UAAU;EAAM,CAAC,CAAC,CAC9E,EACY,KACZ,QAAO,OAAO,OAAO,KACpB,IAAI,uBAAuB;EAC1B,KAAK,SAAS;EACd,OAAO,SAAS;EAChB;EACA,CAAC,CACF;EAED;AAEH,MAAa,8BACZ,UACmC;AACnC,MAAK,MAAM,UAAU,MAAM,SAAS;AACnC,MAAI,CAAC,MAAM,aAAa,OAAO,CAAE;EACjC,MAAM,QAAQ,OAAO;AACrB,MACC,OAAO,UAAU,YACjB,UAAU,QACT,MAAsC,SAAS,yBAEhD,QAAO;;AAGT,QAAO"}

package/dist/cli/wirings/provide-file-system.mjs

@@ -0,0 +1,7 @@
+import { Effect, FileSystem } from "effect";
+//#region src/cli/wirings/provide-file-system.ts
+const provideFileSystem = (fs, effect) => effect.pipe(Effect.provideService(FileSystem.FileSystem, fs));
+//#endregion
+export { provideFileSystem };
+
+//# sourceMappingURL=provide-file-system.mjs.map

package/dist/cli/wirings/provide-file-system.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"provide-file-system.mjs","names":[],"sources":["../../../src/cli/wirings/provide-file-system.ts"],"sourcesContent":["// Shared `provideFileSystem` helper for verb wirings.\n//\n// Several wirings (`up`, `snapshot`, `wipe`) hoist a `FileSystem.FileSystem`\n// out of an enclosing Effect and re-thread it into sub-Effects that depend\n// on it. Factor the one-liner so we don't drift on signature/import (and so\n// later changes — e.g. tagging the call site with a span — happen in one\n// place).\n\nimport { Effect, FileSystem } from 'effect';\n\nexport const provideFileSystem = <A, E, R>(\n\tfs: FileSystem.FileSystem,\n\teffect: Effect.Effect<A, E, R | FileSystem.FileSystem>,\n): Effect.Effect<A, E, Exclude<R, FileSystem.FileSystem>> =>\n\teffect.pipe(Effect.provideService(FileSystem.FileSystem, fs)) as Effect.Effect<\n\t\tA,\n\t\tE,\n\t\tExclude<R, FileSystem.FileSystem>\n\t>;\n"],"mappings":";;AAUA,MAAa,qBACZ,IACA,WAEA,OAAO,KAAK,OAAO,eAAe,WAAW,YAAY,GAAG,CAAC"}

package/dist/cli/wirings/snapshot.mjs

@@ -0,0 +1,177 @@
+import { StackPathsService } from "../../substrate/runtime/paths.mjs";
+import { makeProjectionRef } from "../../substrate/runtime/projection/state-ref.mjs";
+import { writeProjectionSnapshot } from "../../substrate/runtime/projection/persisted.mjs";
+import { commandChannelPaths, makeCommandChannelPublisher } from "../../substrate/runtime/cross-process/command-channel/channel.mjs";
+import { mintRandomSuffix } from "../../substrate/runtime/random-suffix.mjs";
+import { SnapshotOrchestratorService } from "../../orchestrators/snapshot/service.mjs";
+import "../../substrate/runtime/index.mjs";
+import { superviseStackEffect } from "../../orchestrators/run.mjs";
+import { captureSnapshot } from "../../orchestrators/snapshot/capture-command.mjs";
+import "../../orchestrators/snapshot/index.mjs";
+import { buildProductionOrchestratorSinks, buildProductionPostAcquireHook } from "../../orchestrators/runtime-composition.mjs";
+import { extendBuiltInPluginContext, layerBuiltInPluginRuntime } from "../../orchestrators/built-in-plugin-layers.mjs";
+import { CliInternalError, CliUnavailableError } from "../../surfaces/cli/errors.mjs";
+import { probeSupervisorPresence } from "../../surfaces/cli/commands/supervisor-presence.mjs";
+import "../../surfaces/cli/commands/index.mjs";
+import "../../surfaces/cli/index.mjs";
+import { makeConfigLoader, resolveConfigPath } from "./config-loader.mjs";
+import { ensureNoLiveSupervisor, identityValueFor, resolvedIdentityForStack } from "./identity.mjs";
+import { buildDirectSnapshotLayers, buildVerbLayers } from "./build-verb-layers.mjs";
+import { provideFileSystem } from "./provide-file-system.mjs";
+import { Effect, Exit, FileSystem, Logger, SubscriptionRef } from "effect";
+import { dirname } from "node:path";
+//#region src/cli/wirings/snapshot.ts
+const LIVE_SNAPSHOT_CAPTURE_TIMEOUT_MILLIS = 3600 * 1e3;
+const mintCliSnapshotId = () => `snap-${Date.now()}-${mintRandomSuffix(8)}`;
+const isCapturePayload = (value) => {
+	if (typeof value !== "object" || value === null) return false;
+	const kind = value.kind;
+	return kind === "captured" || kind === "failed" || kind === "skipped";
+};
+/** Publish `snapshot.capture` to a live supervisor and surface its
+*  structured ack/error payload. The reply payload carries the
+*  captured metadata (success) or failure summary (failure) — no
+*  side-channel event tail required. Returns `null` if no supervisor
+*  is live so the caller can fall through to the direct path. */
+const runSnapshotCaptureAgainstLiveSupervisor = (identity, args) => Effect.gen(function* () {
+	if (!(yield* probeSupervisorPresence(identity.rosterFile).pipe(Effect.catch(() => Effect.succeed({
+		live: false,
+		pid: null,
+		hostname: null
+	})))).live) return null;
+	const snapshotId = args.snapshotId ?? mintCliSnapshotId();
+	return yield* Effect.scoped(Effect.gen(function* () {
+		const publisher = yield* makeCommandChannelPublisher(commandChannelPaths(identity.stackRoot));
+		const published = yield* publisher.publish({
+			tag: "snapshot.capture",
+			snapshotId,
+			...args.name === void 0 ? {} : { name: args.name }
+		});
+		const reply = yield* publisher.awaitCompletion(published, { timeoutMillis: LIVE_SNAPSHOT_CAPTURE_TIMEOUT_MILLIS });
+		if (reply.ok) {
+			const payload = isCapturePayload(reply.payload) ? reply.payload : null;
+			if (payload?.kind === "captured" && typeof payload.snapshotId === "string") return {
+				snapshotId: payload.snapshotId,
+				name: payload.name ?? args.name ?? payload.snapshotId
+			};
+			return {
+				snapshotId,
+				name: args.name ?? snapshotId
+			};
+		}
+		const payload = isCapturePayload(reply.payload) ? reply.payload : null;
+		if (payload?.kind === "skipped") return yield* Effect.fail(new CliUnavailableError({
+			service: "snapshot capture",
+			message: "another snapshot capture is already running",
+			hint: "wait for the current snapshot to finish and try again"
+		}));
+		if (payload?.kind === "failed") return yield* Effect.fail(new CliInternalError({ message: `snapshot capture failed: ${payload.summary ?? reply.message}` }));
+		if (/already running/i.test(reply.message)) return yield* Effect.fail(new CliUnavailableError({
+			service: "snapshot capture",
+			message: "another snapshot capture is already running",
+			hint: "wait for the current snapshot to finish and try again"
+		}));
+		return yield* Effect.fail(new CliUnavailableError({
+			service: "devstack supervisor",
+			message: reply.message,
+			hint: "check the attached `devstack up` session and try again"
+		}));
+	}));
+});
+const snapshotIdentityParticipants = (meta) => Object.entries(meta.identity).map(([plugin, value]) => ({
+	plugin,
+	liveIdentity: Effect.succeed({ [plugin]: value })
+}));
+const runSnapshotRestoreDirect = (identity, snapshotId) => {
+	const restored = Effect.gen(function* () {
+		const snapshot = yield* SnapshotOrchestratorService;
+		const fs = yield* FileSystem.FileSystem;
+		const meta = (yield* provideFileSystem(fs, snapshot.list)).find((entry) => entry.id === snapshotId)?.metadata ?? null;
+		const participants = meta === null ? [] : snapshotIdentityParticipants(meta);
+		yield* provideFileSystem(fs, snapshot.restore({
+			id: snapshotId,
+			participants
+		}));
+	}).pipe(Effect.provide(buildDirectSnapshotLayers({
+		identity: identityValueFor(identity),
+		runtimeRoot: identity.runtimeRoot
+	})), Effect.provide(Logger.layer([Logger.consolePretty()])));
+	return ensureNoLiveSupervisor(identity, "shut down the attached `devstack up` session before restoring a snapshot").pipe(Effect.andThen(restored));
+};
+const runSnapshotDeleteDirect = (identity, snapshotId) => {
+	return Effect.gen(function* () {
+		const snapshot = yield* SnapshotOrchestratorService;
+		yield* provideFileSystem(yield* FileSystem.FileSystem, snapshot.delete(snapshotId));
+	}).pipe(Effect.provide(buildDirectSnapshotLayers({
+		identity: identityValueFor(identity),
+		runtimeRoot: identity.runtimeRoot
+	})), Effect.provide(Logger.layer([Logger.consolePretty()])));
+};
+const runSnapshotCaptureDirect = (identity, args) => {
+	const loader = makeConfigLoader();
+	return Effect.gen(function* () {
+		return yield* runSnapshotCaptureDirectLoaded(identity, yield* loader.load(args.configPath), args);
+	});
+};
+const runSnapshotCaptureDirectLoaded = (identity, loaded, args) => Effect.gen(function* () {
+	const stack = loaded.stack;
+	const effectiveIdentity = resolvedIdentityForStack(identity, stack);
+	const identityValue = identityValueFor(effectiveIdentity);
+	const substrateLayers = buildVerbLayers({
+		identity: identityValue,
+		stack,
+		appRoot: dirname(loaded.resolvedConfigPath),
+		runtimeRoot: effectiveIdentity.runtimeRoot
+	});
+	const program = Effect.gen(function* () {
+		const state = yield* makeProjectionRef();
+		const orchestratorSinks = yield* buildProductionOrchestratorSinks();
+		const postAcquireHook = yield* buildProductionPostAcquireHook({ extras: stack.options.extras });
+		let captureExit = Exit.succeed(void 0);
+		const capturedMeta = { current: null };
+		yield* superviseStackEffect({
+			_tag: "Stack",
+			members: stack.members,
+			options: stack.options
+		}, identityValue, state, {
+			orchestratorSinks,
+			postAcquireHook,
+			lifetime: "one-shot",
+			extendContext: extendBuiltInPluginContext,
+			withinScope: () => captureSnapshot({
+				snapshotId: args.snapshotId,
+				name: args.name
+			}).pipe(Effect.tap((meta) => Effect.sync(() => {
+				capturedMeta.current = meta;
+			})), Effect.asVoid, Effect.exit, Effect.tap((exit) => Effect.sync(() => {
+				captureExit = exit;
+			})), Effect.asVoid)
+		}).pipe(Effect.provide(layerBuiltInPluginRuntime(orchestratorSinks)));
+		if (Exit.isFailure(captureExit)) yield* Effect.failCause(captureExit.cause);
+		if (capturedMeta.current === null) return yield* Effect.die("snapshot capture completed without metadata");
+		const meta = capturedMeta.current;
+		yield* writeProjectionSnapshot((yield* StackPathsService).stackRoot, yield* SubscriptionRef.get(state));
+		return {
+			snapshotId: meta.id,
+			name: meta.label ?? meta.id
+		};
+	});
+	return yield* ensureNoLiveSupervisor(effectiveIdentity, "shut down the attached `devstack up` session before saving a snapshot").pipe(Effect.andThen(program.pipe(Effect.provide(substrateLayers), Effect.provide(Logger.layer([Logger.consolePretty()])))));
+});
+const runSnapshotCaptureLiveAware = (identity, args) => Effect.gen(function* () {
+	if (args.configPath === void 0 && resolveConfigPath(void 0) === null) {
+		const live = yield* runSnapshotCaptureAgainstLiveSupervisor(identity, args);
+		if (live !== null) return live;
+		return yield* runSnapshotCaptureDirect(identity, args);
+	}
+	const loaded = yield* makeConfigLoader().load(args.configPath);
+	const stack = loaded.stack;
+	const effectiveIdentity = resolvedIdentityForStack(identity, stack);
+	const live = yield* runSnapshotCaptureAgainstLiveSupervisor(effectiveIdentity, args);
+	if (live !== null) return live;
+	return yield* runSnapshotCaptureDirectLoaded(effectiveIdentity, loaded, args);
+});
+//#endregion
+export { runSnapshotCaptureLiveAware, runSnapshotDeleteDirect, runSnapshotRestoreDirect };
+
+//# sourceMappingURL=snapshot.mjs.map

package/dist/cli/wirings/snapshot.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.mjs","names":[],"sources":["../../../src/cli/wirings/snapshot.ts"],"sourcesContent":["// `devstack snapshot save / restore / delete` verb wirings.\n//\n// `save` is live-aware: when a supervisor owns the stack, publish a\n// `snapshot.capture` command and read the structured result from the\n// command-channel reply payload (no tail-fiber). `restore` and\n// `delete` are direct/offline only; they refuse to run when a\n// supervisor is live.\n\nimport { dirname } from 'node:path';\n\nimport { Effect, Exit, FileSystem, Logger, SubscriptionRef } from 'effect';\n\nimport type { Identity } from '../../substrate/identity.ts';\nimport { StackPathsService } from '../../substrate/runtime/paths.ts';\nimport { mintRandomSuffix } from '../../substrate/runtime/random-suffix.ts';\nimport {\n\tcommandChannelPaths,\n\tmakeCommandChannelPublisher,\n\tmakeProjectionRef,\n\ttype SupervisedStack,\n\twriteProjectionSnapshot,\n} from '../../substrate/runtime/index.ts';\nimport { superviseStackEffect } from '../../orchestrators/run.ts';\nimport {\n\tbuildProductionOrchestratorSinks,\n\tbuildProductionPostAcquireHook,\n} from '../../orchestrators/runtime-composition.ts';\nimport {\n\textendBuiltInPluginContext,\n\tlayerBuiltInPluginRuntime,\n} from '../../orchestrators/built-in-plugin-layers.ts';\nimport {\n\tcaptureSnapshot,\n\tSnapshotOrchestratorService,\n\ttype RestoreParticipant,\n\ttype SnapshotMetadata,\n} from '../../orchestrators/snapshot/index.ts';\nimport {\n\tCliInternalError,\n\tCliUnavailableError,\n} from '../../surfaces/cli/index.ts';\nimport { probeSupervisorPresence } from '../../surfaces/cli/commands/index.ts';\nimport type { LoadedConfig } from '../../surfaces/cli/commands/config-loader.ts';\n\nimport { makeConfigLoader, resolveConfigPath } from './config-loader.ts';\nimport {\n\tensureNoLiveSupervisor,\n\tidentityValueFor,\n\tresolvedIdentityForStack,\n\ttype ResolvedIdentity,\n} from './identity.ts';\nimport { buildDirectSnapshotLayers, buildVerbLayers } from './build-verb-layers.ts';\nimport { provideFileSystem } from './provide-file-system.ts';\n\nconst LIVE_SNAPSHOT_CAPTURE_TIMEOUT_MILLIS = 60 * 60 * 1000;\n\nconst mintCliSnapshotId = (): string => `snap-${Date.now()}-${mintRandomSuffix(8)}`;\n\n/** Structured payload that the supervisor's command-channel bridge\n *  attaches to the ack/error reply for `snapshot.capture`. Mirrors the\n *  shape produced by `cli/wirings/up.ts:snapshotCaptureAckFromEvent`. */\ninterface SnapshotCaptureAckPayload {\n\treadonly kind: 'captured' | 'failed' | 'skipped';\n\treadonly snapshotId?: string;\n\treadonly name?: string;\n\treadonly summary?: string;\n\treadonly reason?: string;\n}\n\nconst isCapturePayload = (value: unknown): value is SnapshotCaptureAckPayload => {\n\tif (typeof value !== 'object' || value === null) return false;\n\tconst kind = (value as { readonly kind?: unknown }).kind;\n\treturn kind === 'captured' || kind === 'failed' || kind === 'skipped';\n};\n\n/** Publish `snapshot.capture` to a live supervisor and surface its\n *  structured ack/error payload. The reply payload carries the\n *  captured metadata (success) or failure summary (failure) — no\n *  side-channel event tail required. Returns `null` if no supervisor\n *  is live so the caller can fall through to the direct path. */\nexport const runSnapshotCaptureAgainstLiveSupervisor = (\n\tidentity: ResolvedIdentity,\n\targs: { readonly snapshotId?: string; readonly name?: string },\n): Effect.Effect<{ readonly snapshotId: string; readonly name: string } | null, unknown> =>\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) return null;\n\n\t\tconst snapshotId = args.snapshotId ?? mintCliSnapshotId();\n\t\treturn yield* Effect.scoped(\n\t\t\tEffect.gen(function* () {\n\t\t\t\tconst publisher = yield* makeCommandChannelPublisher(\n\t\t\t\t\tcommandChannelPaths(identity.stackRoot),\n\t\t\t\t);\n\t\t\t\tconst published = yield* publisher.publish({\n\t\t\t\t\ttag: 'snapshot.capture',\n\t\t\t\t\tsnapshotId,\n\t\t\t\t\t...(args.name === undefined ? {} : { name: args.name }),\n\t\t\t\t});\n\t\t\t\tconst reply = yield* publisher.awaitCompletion(published, {\n\t\t\t\t\ttimeoutMillis: LIVE_SNAPSHOT_CAPTURE_TIMEOUT_MILLIS,\n\t\t\t\t});\n\n\t\t\t\tif (reply.ok) {\n\t\t\t\t\tconst payload = isCapturePayload(reply.payload) ? reply.payload : null;\n\t\t\t\t\tif (payload?.kind === 'captured' && typeof payload.snapshotId === 'string') {\n\t\t\t\t\t\treturn {\n\t\t\t\t\t\t\tsnapshotId: payload.snapshotId,\n\t\t\t\t\t\t\tname: payload.name ?? args.name ?? payload.snapshotId,\n\t\t\t\t\t\t};\n\t\t\t\t\t}\n\t\t\t\t\t// Older supervisor without structured payload (or a peer mock\n\t\t\t\t\t// in tests): synthesize from the request — the supervisor\n\t\t\t\t\t// already accepted our snapshotId, so it's authoritative.\n\t\t\t\t\treturn {\n\t\t\t\t\t\tsnapshotId,\n\t\t\t\t\t\tname: args.name ?? snapshotId,\n\t\t\t\t\t};\n\t\t\t\t}\n\n\t\t\t\tconst payload = isCapturePayload(reply.payload) ? reply.payload : null;\n\t\t\t\tif (payload?.kind === 'skipped') {\n\t\t\t\t\treturn yield* Effect.fail(\n\t\t\t\t\t\tnew CliUnavailableError({\n\t\t\t\t\t\t\tservice: 'snapshot capture',\n\t\t\t\t\t\t\tmessage: 'another snapshot capture is already running',\n\t\t\t\t\t\t\thint: 'wait for the current snapshot to finish and try again',\n\t\t\t\t\t\t}),\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\tif (payload?.kind === 'failed') {\n\t\t\t\t\treturn yield* Effect.fail(\n\t\t\t\t\t\tnew CliInternalError({\n\t\t\t\t\t\t\tmessage: `snapshot capture failed: ${payload.summary ?? reply.message}`,\n\t\t\t\t\t\t}),\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\t// No structured payload — surface the raw reply.message.\n\t\t\t\tif (/already running/i.test(reply.message)) {\n\t\t\t\t\treturn yield* Effect.fail(\n\t\t\t\t\t\tnew CliUnavailableError({\n\t\t\t\t\t\t\tservice: 'snapshot capture',\n\t\t\t\t\t\t\tmessage: 'another snapshot capture is already running',\n\t\t\t\t\t\t\thint: 'wait for the current snapshot to finish and try again',\n\t\t\t\t\t\t}),\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\treturn yield* Effect.fail(\n\t\t\t\t\tnew CliUnavailableError({\n\t\t\t\t\t\tservice: 'devstack supervisor',\n\t\t\t\t\t\tmessage: reply.message,\n\t\t\t\t\t\thint: 'check the attached `devstack up` session and try again',\n\t\t\t\t\t}),\n\t\t\t\t);\n\t\t\t}),\n\t\t);\n\t});\n\nconst snapshotIdentityParticipants = (\n\tmeta: SnapshotMetadata,\n): ReadonlyArray<RestoreParticipant> =>\n\tObject.entries(meta.identity).map(([plugin, value]) => ({\n\t\tplugin,\n\t\tliveIdentity: Effect.succeed({ [plugin]: value }),\n\t}));\n\nexport const 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(\n\t\t\tbuildDirectSnapshotLayers({\n\t\t\t\tidentity: identityValueFor(identity),\n\t\t\t\truntimeRoot: identity.runtimeRoot,\n\t\t\t}),\n\t\t),\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\nexport const 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(\n\t\t\tbuildDirectSnapshotLayers({\n\t\t\t\tidentity: identityValueFor(identity),\n\t\t\t\truntimeRoot: identity.runtimeRoot,\n\t\t\t}),\n\t\t),\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\treturn yield* runSnapshotCaptureDirectLoaded(identity, loaded, args);\n\t});\n};\n\nexport const runSnapshotCaptureDirectLoaded = (\n\tidentity: ResolvedIdentity,\n\tloaded: LoadedConfig,\n\targs: { readonly snapshotId?: string; readonly name?: string },\n): Effect.Effect<{ readonly snapshotId: string; readonly name: string }, unknown> =>\n\tEffect.gen(function* () {\n\t\tconst stack = (loaded as LoadedConfig & { readonly stack: SupervisedStack }).stack;\n\t\tconst effectiveIdentity = resolvedIdentityForStack(identity, stack);\n\t\tconst identityValue: Identity = identityValueFor(effectiveIdentity);\n\t\tconst appRoot = dirname(loaded.resolvedConfigPath);\n\t\tconst substrateLayers = buildVerbLayers({\n\t\t\tidentity: identityValue,\n\t\t\tstack,\n\t\t\tappRoot,\n\t\t\truntimeRoot: effectiveIdentity.runtimeRoot,\n\t\t});\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\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\tcaptureSnapshot({ snapshotId: args.snapshotId, name: 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* ensureNoLiveSupervisor(\n\t\t\teffectiveIdentity,\n\t\t\t'shut down the attached `devstack up` session before saving a snapshot',\n\t\t).pipe(\n\t\t\tEffect.andThen(\n\t\t\t\tprogram.pipe(\n\t\t\t\t\tEffect.provide(substrateLayers),\n\t\t\t\t\tEffect.provide(Logger.layer([Logger.consolePretty()])),\n\t\t\t\t),\n\t\t\t),\n\t\t);\n\t});\n\nexport const runSnapshotCaptureLiveAware = (\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\tEffect.gen(function* () {\n\t\tif (args.configPath === undefined && resolveConfigPath(undefined) === null) {\n\t\t\tconst live = yield* runSnapshotCaptureAgainstLiveSupervisor(identity, args);\n\t\t\tif (live !== null) return live;\n\t\t\treturn yield* runSnapshotCaptureDirect(identity, args);\n\t\t}\n\t\tconst loaded = yield* makeConfigLoader().load(args.configPath);\n\t\tconst stack = (loaded as LoadedConfig & { readonly stack: SupervisedStack }).stack;\n\t\tconst effectiveIdentity = resolvedIdentityForStack(identity, stack);\n\t\tconst live = yield* runSnapshotCaptureAgainstLiveSupervisor(effectiveIdentity, args);\n\t\tif (live !== null) return live;\n\t\treturn yield* runSnapshotCaptureDirectLoaded(effectiveIdentity, loaded, args);\n\t});\n"],"mappings":"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"}