@mysten-incubation/devstack 0.1.1 → 0.2.0

package/dist/orchestrators/runtime-composition.d.mts

@@ -1,10 +0,0 @@
-import { Context, Effect, FileSystem, Layer, Scope } from "effect";
-//#region src/orchestrators/runtime-composition.d.ts
-interface ProductionCodegenOptions {
-  readonly appRoot?: string;
-  readonly outputDir?: string;
-  readonly stackSubdir?: string | null;
-}
-//#endregion
-export { ProductionCodegenOptions };
-//# sourceMappingURL=runtime-composition.d.mts.map

package/dist/orchestrators/runtime-composition.mjs

@@ -1,252 +0,0 @@
-import { endpointKey } from "../substrate/brand.mjs";
-import { StackPathsService } from "../substrate/runtime/paths.mjs";
-import { readResolvedSync } from "../substrate/runtime/lifecycle/plugin-registry.mjs";
-import { SnapshotOrchestratorService, layerSnapshotOrchestrator } from "./snapshot/service.mjs";
-import "../substrate/runtime/lifecycle/index.mjs";
-import { operationalEndpointEventsFromResolvedValue } from "../substrate/runtime/projection/operational-endpoints.mjs";
-import { PostAcquireTasksService } from "../substrate/runtime/post-acquire-tasks.mjs";
-import { MoveCodegenService, MoveSummaryRunnerService, layerMystenMoveCodegen } from "./codegen/bindings.mjs";
-import { layerSuiMoveSummaryRunnerDocker } from "../plugins/sui/move-summary-runner.mjs";
-import { CodegenPathsService, layerCodegenPaths, layerCodegenRoot } from "./codegen/paths.mjs";
-import { CodegenOrchestratorService, layerCodegenOrchestrator } from "./codegen/service.mjs";
-import { layerTraefikContainerOpsDocker } from "./router/traefik-container.mjs";
-import { makeDefaultRouterProfile } from "./router/profile.mjs";
-import { layerEntrypointRegistry } from "./router/entrypoints.mjs";
-import { RouterService, layerDockerUpstreamResolver, layerRouterConfigLiteral, layerRouterService } from "./router/service.mjs";
-import "./router/index.mjs";
-import { BUILT_IN_ENTRYPOINTS } from "../plugins/router-entrypoints.mjs";
-import "./snapshot/index.mjs";
-import { ManifestExtrasLookupError, resolveManifestExtras } from "../substrate/manifest.mjs";
-import { buildEnvelope, writeManifest } from "../substrate/runtime/manifest/manifest.mjs";
-import "../substrate/runtime/manifest/index.mjs";
-import { Context, Effect, FileSystem, Layer, Ref } from "effect";
-import { isAbsolute, join, resolve } from "node:path";
-//#region src/orchestrators/runtime-composition.ts
-var ManifestEndpointRegistryService = class extends Context.Service()("@devstack/orchestrators/ManifestEndpointRegistry") {};
-const layerManifestEndpointRegistry = Layer.effect(ManifestEndpointRegistryService, Effect.gen(function* () {
-	const entriesRef = yield* Ref.make([]);
-	const seqRef = yield* Ref.make(0);
-	const register = (entry) => Effect.gen(function* () {
-		const seq = yield* Ref.updateAndGet(seqRef, (n) => n + 1);
-		yield* Ref.update(entriesRef, (entries) => [...entries, {
-			...entry,
-			seq
-		}]);
-		yield* Effect.addFinalizer(() => Ref.update(entriesRef, (entries) => entries.filter((candidate) => candidate.seq !== seq)));
-	});
-	return ManifestEndpointRegistryService.of({
-		register,
-		entries: Ref.get(entriesRef).pipe(Effect.map((entries) => entries.map((entryWithSeq) => {
-			const { seq, ...entry } = entryWithSeq;
-			return entry;
-		})))
-	});
-}));
-const productionRouterProfile = (options = {}) => makeDefaultRouterProfile(options);
-const productionCodegenOutputDir = (appRoot, outputDir) => {
-	const target = outputDir ?? "src/generated";
-	return isAbsolute(target) ? target : resolve(appRoot, target);
-};
-/** Codegenable wrapping the resolved manifest-extras blob into a
-*  generated `extras.ts` for app-side consumption. Single-callsite
-*  helper — declared here to keep the orchestrator's view of the
-*  contribution self-contained. */
-const makeExtrasCodegenable = (extras) => ({
-	kind: "codegenable",
-	emitterName: "app-extras",
-	outputPath: "extras.ts",
-	sensitive: true,
-	emit: (ctx) => Effect.sync(() => {
-		ctx.exportConst("extras", extras);
-		return ctx.done();
-	})
-});
-const layerProductionOrchestrators = (router = {}) => {
-	const profile = router.profile ?? productionRouterProfile();
-	return Layer.mergeAll(layerSnapshotOrchestrator, layerManifestEndpointRegistry, layerRouterService.pipe(Layer.provideMerge(Layer.mergeAll(layerEntrypointRegistry(BUILT_IN_ENTRYPOINTS), layerTraefikContainerOpsDocker, layerDockerUpstreamResolver(profile), layerRouterConfigLiteral({
-		disabled: router.disabled ?? false,
-		profile,
-		image: router.image ?? "traefik:v3.5",
-		routeReadinessProbe: { enabled: router.disabled !== true }
-	})))), layerCodegenOrchestrator, layerCodegenPaths.pipe(Layer.provideMerge(layerCodegenRoot({
-		outputDir: productionCodegenOutputDir(router.codegen?.appRoot ?? process.cwd(), router.codegen?.outputDir),
-		stackSubdir: router.codegen?.stackSubdir ?? null
-	}))), layerSuiMoveSummaryRunnerDocker, layerMystenMoveCodegen);
-};
-Effect.gen(function* () {
-	yield* (yield* RouterService).boot().pipe(Effect.orDie);
-});
-/** Project a `(pluginKey, EndpointUrl)` pair into the field-set both
-*  the engine event and the manifest entry stamp identically. Callers
-*  spread this and then add their output-specific fields (the engine
-*  event's branded `endpointKey` + `registeredAt`; the manifest
-*  entry's stringified `endpointKey` + `pluginKey`). */
-const routableToEndpointFields = (pluginKey, endpoint) => ({
-	name: endpoint.endpointName,
-	url: endpoint.url,
-	displayUrl: null,
-	wireProtocol: endpoint.wireProtocol,
-	endpointKeyString: `${pluginKey}:${endpoint.endpointName}`
-});
-const endpointEventFromRoutable = (pluginKey, endpoint, registeredAt = Date.now()) => {
-	const { endpointKeyString, ...common } = routableToEndpointFields(pluginKey, endpoint);
-	return {
-		tag: "endpoint.registered",
-		endpoint: {
-			...common,
-			endpointKey: endpointKey(endpointKeyString),
-			pluginKey,
-			registeredAt
-		}
-	};
-};
-const manifestEndpointEntryFromRoutable = (pluginKey, endpoint) => {
-	const { endpointKeyString, ...common } = routableToEndpointFields(pluginKey, endpoint);
-	return {
-		...common,
-		endpointKey: endpointKeyString,
-		pluginKey: String(pluginKey)
-	};
-};
-const manifestEndpointEntryFromOperationalEndpoint = (endpoint) => ({
-	endpointKey: String(endpoint.endpointKey),
-	name: endpoint.name,
-	url: endpoint.url,
-	displayUrl: endpoint.displayUrl,
-	wireProtocol: endpoint.wireProtocol,
-	pluginKey: String(endpoint.pluginKey)
-});
-const orchestratorSink = (sink) => sink;
-const makeProjectionCapabilitySink = () => orchestratorSink({
-	kind: "projection",
-	accept: (decl, ctx) => Effect.gen(function* () {
-		const payload = decl.event.payload;
-		const payloadWithRowKey = payload !== null && typeof payload === "object" && "rowKey" in payload && payload.rowKey === null ? {
-			...payload,
-			rowKey: ctx.pluginKey
-		} : payload;
-		yield* ctx.publish({
-			...decl.event,
-			payload: payloadWithRowKey
-		});
-	})
-});
-const makeStrategyContributorCapabilitySink = () => orchestratorSink({
-	kind: "strategy-contributor",
-	accept: (decl, ctx) => Effect.gen(function* () {
-		yield* ctx.registerStrategy(decl);
-		const at = Date.now();
-		yield* ctx.publish({
-			tag: "strategy.registered",
-			capabilityKey: decl.capabilityKey,
-			autoMounted: decl.autoMounted,
-			at
-		});
-		yield* Effect.addFinalizer(() => ctx.publish({
-			tag: "strategy.unregistered",
-			capabilityKey: decl.capabilityKey,
-			at: Date.now()
-		}));
-	})
-});
-const buildProductionOrchestratorSinks = (observers = {}) => Effect.gen(function* () {
-	const snapshot = yield* SnapshotOrchestratorService;
-	const router = yield* RouterService;
-	const codegen = yield* CodegenOrchestratorService;
-	const manifestEndpoints = yield* ManifestEndpointRegistryService;
-	return [
-		orchestratorSink({
-			kind: "snapshotable",
-			accept: (decl, ctx) => snapshot.registerParticipant(ctx.pluginKey, decl)
-		}),
-		orchestratorSink({
-			kind: "routable",
-			accept: (decl, ctx) => router.boot().pipe(Effect.andThen(router.contributeRoute(decl)), Effect.flatMap((endpoint) => {
-				const event = endpointEventFromRoutable(ctx.pluginKey, endpoint);
-				const manifestEntry = manifestEndpointEntryFromRoutable(ctx.pluginKey, endpoint);
-				return manifestEndpoints.register(manifestEntry).pipe(Effect.andThen(ctx.publish(event)), Effect.andThen(observers.routable ? observers.routable(ctx.pluginKey, endpoint, event) : Effect.void));
-			}))
-		}),
-		orchestratorSink({
-			kind: "codegenable",
-			accept: (decl, ctx) => codegen.registerContribution(ctx.pluginKey, decl).pipe(Effect.flatMap(() => observers.codegenable ? observers.codegenable(ctx.pluginKey, decl) : Effect.void))
-		}),
-		makeProjectionCapabilitySink(),
-		makeStrategyContributorCapabilitySink()
-	];
-});
-const makeManifestExtrasContext = (ctx) => {
-	const resourceIdToKey = /* @__PURE__ */ new Map();
-	for (const [key, node] of ctx.graph.nodes) resourceIdToKey.set(node.member.id, key);
-	const lookup = (resourceId) => {
-		const key = resourceIdToKey.get(resourceId);
-		if (key === void 0) throw new ManifestExtrasLookupError({
-			kind: "unknown-resource",
-			resourceId
-		});
-		const resolved = readResolvedSync(ctx.registry, key);
-		if (resolved === void 0) throw new ManifestExtrasLookupError({
-			kind: "unresolved-resource",
-			resourceId
-		});
-		return resolved;
-	};
-	return { value: (resource) => lookup(resource.id) };
-};
-const operationalManifestEndpointEntries = (ctx, routableEntries) => {
-	const routablePluginKeys = new Set(routableEntries.map((entry) => entry.pluginKey));
-	const registeredAt = Date.now();
-	const entries = [];
-	for (const [key] of ctx.graph.nodes) {
-		if (routablePluginKeys.has(String(key))) continue;
-		const resolved = readResolvedSync(ctx.registry, key);
-		if (resolved === void 0) continue;
-		for (const event of operationalEndpointEventsFromResolvedValue(key, resolved, registeredAt)) entries.push(manifestEndpointEntryFromOperationalEndpoint(event.endpoint));
-	}
-	return entries;
-};
-const buildProductionPostAcquireHook = (options = {}) => Effect.gen(function* () {
-	const codegen = yield* CodegenOrchestratorService;
-	const paths = yield* CodegenPathsService;
-	const summaryRunner = yield* MoveSummaryRunnerService;
-	const moveCodegen = yield* MoveCodegenService;
-	const fs = yield* FileSystem.FileSystem;
-	const stackPaths = yield* StackPathsService;
-	const postAcquireTasks = yield* PostAcquireTasksService;
-	const manifestEndpoints = yield* ManifestEndpointRegistryService;
-	return (ctx) => Effect.gen(function* () {
-		const extras = yield* resolveManifestExtras(options.extras, makeManifestExtrasContext(ctx));
-		const routableEndpoints = yield* manifestEndpoints.entries;
-		const endpoints = [...routableEndpoints, ...operationalManifestEndpointEntries(ctx, routableEndpoints)];
-		yield* writeManifest(yield* buildEnvelope({
-			identity: {
-				app: ctx.identity.app,
-				stack: ctx.identity.stack,
-				chain: ctx.identity.chain
-			},
-			contributions: [],
-			endpoints,
-			extras,
-			codegen: { generatedDir: paths.outputDir }
-		}), join(stackPaths.stackRoot, "manifest.json")).pipe(Effect.provideService(FileSystem.FileSystem, fs));
-		const result = yield* codegen.runCycle({ extraContributions: [makeExtrasCodegenable(extras)] }).pipe(Effect.provideService(CodegenPathsService, paths), Effect.provideService(MoveSummaryRunnerService, summaryRunner), Effect.provideService(MoveCodegenService, moveCodegen), Effect.provideService(FileSystem.FileSystem, fs));
-		yield* postAcquireTasks.runAll;
-		return [{
-			tag: "manifest.flushed",
-			manifestVersion: 1,
-			at: Date.now()
-		}, {
-			tag: "codegen.emitted",
-			files: [
-				...result.filesWritten,
-				...result.filesChmod,
-				...result.bindings?.filesWritten ?? []
-			],
-			at: Date.now()
-		}];
-	});
-});
-//#endregion
-export { buildProductionOrchestratorSinks, buildProductionPostAcquireHook, layerProductionOrchestrators };
-
-//# sourceMappingURL=runtime-composition.mjs.map

package/dist/orchestrators/runtime-composition.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"runtime-composition.mjs","names":[],"sources":["../../src/orchestrators/runtime-composition.ts"],"sourcesContent":["// Shared production orchestrator composition.\n//\n// CLI, programmatic runStack, and the e2e boot harness all use this\n// module for capability delivery. Tests may swap service\n// implementations (Traefik ops, upstream resolver, codegen paths), but\n// the sink registrations and router boot step stay shared.\n\nimport { Context, Effect, FileSystem, Layer, Ref, Scope } from 'effect';\nimport { isAbsolute, join, resolve } from 'node:path';\n\nimport {\n\tlayerMystenMoveCodegen,\n\tMoveCodegenService,\n\tMoveSummaryRunnerService,\n} from './codegen/bindings.ts';\nimport { layerSuiMoveSummaryRunnerDocker } from '../plugins/sui/move-summary-runner.ts';\nimport { CodegenPathsService, layerCodegenPaths, layerCodegenRoot } from './codegen/paths.ts';\nimport {\n\tCodegenOrchestratorService,\n\tlayerCodegenOrchestrator,\n\ttype Codegenable,\n} from './codegen/service.ts';\nimport type { CodegenableDecl } from '../contracts/codegenable.ts';\nimport {\n\tDEFAULT_TRAEFIK_IMAGE,\n\tlayerDockerUpstreamResolver,\n\tlayerEntrypointRegistry,\n\tlayerRouterConfigLiteral,\n\tlayerRouterService,\n\tlayerTraefikContainerOpsDocker,\n\tRouterService,\n\ttype EndpointUrl,\n\ttype ResolvedRoute,\n} from './router/index.ts';\nimport { BUILT_IN_ENTRYPOINTS } from '../plugins/router-entrypoints.ts';\nimport {\n\tmakeDefaultRouterProfile,\n\ttype DefaultRouterProfileOptions,\n\ttype RouterProfile,\n} from './router/profile.ts';\nimport { layerSnapshotOrchestrator, SnapshotOrchestratorService } from './snapshot/index.ts';\nimport type { ProjectionDecl } from '../contracts/projection.ts';\nimport type { RoutableDecl } from '../contracts/routable.ts';\nimport type { SnapshotableDecl } from '../contracts/snapshotable.ts';\nimport type { StrategyContributorDecl } from '../contracts/strategy-contributor.ts';\nimport { endpointKey, type PluginKey } from '../substrate/brand.ts';\nimport type { EngineEvent } from '../substrate/events.ts';\nimport {\n\tbuildEnvelope,\n\tCURRENT_MANIFEST_VERSION,\n\twriteManifest,\n} from '../substrate/runtime/manifest/index.ts';\nimport { readResolvedSync } from '../substrate/runtime/lifecycle/index.ts';\nimport { operationalEndpointEventsFromResolvedValue } from '../substrate/runtime/projection/operational-endpoints.ts';\nimport {\n\tManifestExtrasLookupError,\n\tresolveManifestExtras,\n\ttype EndpointEntry,\n\ttype ManifestExtras,\n\ttype ManifestExtrasInput,\n} from '../substrate/manifest.ts';\nimport { StackPathsService } from '../substrate/runtime/paths.ts';\nimport { PostAcquireTasksService } from '../substrate/runtime/post-acquire-tasks.ts';\nimport type {\n\tCapabilitySink,\n\tContributionKind,\n\tHarvestContext,\n\tOrchestratorSinks,\n} from '../substrate/runtime/capability-sinks/index.ts';\nimport type {\n\tSupervisorPostAcquireContext,\n\tSupervisorPostAcquireHook,\n} from '../substrate/runtime/supervisor/index.ts';\n\nexport interface ProductionCodegenOptions {\n\treadonly appRoot?: string;\n\treadonly outputDir?: string;\n\treadonly stackSubdir?: string | null;\n}\n\nexport interface ProductionRouterOptions {\n\treadonly codegen?: ProductionCodegenOptions;\n\treadonly disabled?: boolean;\n\treadonly image?: string;\n\treadonly profile?: RouterProfile;\n}\n\nexport interface ProductionPostAcquireOptions {\n\treadonly extras?: ManifestExtrasInput;\n}\n\nexport interface ManifestEndpointRegistry {\n\treadonly register: (entry: EndpointEntry) => Effect.Effect<void, never, Scope.Scope>;\n\treadonly entries: Effect.Effect<ReadonlyArray<EndpointEntry>>;\n}\n\nexport class ManifestEndpointRegistryService extends Context.Service<\n\tManifestEndpointRegistryService,\n\tManifestEndpointRegistry\n>()('@devstack/orchestrators/ManifestEndpointRegistry') {}\n\nexport const layerManifestEndpointRegistry: Layer.Layer<ManifestEndpointRegistryService> =\n\tLayer.effect(\n\t\tManifestEndpointRegistryService,\n\t\tEffect.gen(function* () {\n\t\t\tconst entriesRef = yield* Ref.make<ReadonlyArray<EndpointEntry & { readonly seq: number }>>(\n\t\t\t\t[],\n\t\t\t);\n\t\t\tconst seqRef = yield* Ref.make(0);\n\n\t\t\tconst register = (entry: EndpointEntry): Effect.Effect<void, never, Scope.Scope> =>\n\t\t\t\tEffect.gen(function* () {\n\t\t\t\t\tconst seq = yield* Ref.updateAndGet(seqRef, (n) => n + 1);\n\t\t\t\t\tyield* Ref.update(entriesRef, (entries) => [...entries, { ...entry, seq }]);\n\t\t\t\t\tyield* Effect.addFinalizer(() =>\n\t\t\t\t\t\tRef.update(entriesRef, (entries) =>\n\t\t\t\t\t\t\tentries.filter((candidate) => candidate.seq !== seq),\n\t\t\t\t\t\t),\n\t\t\t\t\t);\n\t\t\t\t});\n\n\t\t\treturn ManifestEndpointRegistryService.of({\n\t\t\t\tregister,\n\t\t\t\tentries: Ref.get(entriesRef).pipe(\n\t\t\t\t\tEffect.map((entries) =>\n\t\t\t\t\t\tentries.map((entryWithSeq) => {\n\t\t\t\t\t\t\tconst { seq, ...entry } = entryWithSeq;\n\t\t\t\t\t\t\tvoid seq;\n\t\t\t\t\t\t\treturn entry;\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\t);\n\nexport interface CapabilityDeliveryObservers {\n\treadonly routable?: (\n\t\tpluginKey: PluginKey,\n\t\tendpoint: EndpointUrl,\n\t\tevent: Extract<EngineEvent, { readonly tag: 'endpoint.registered' }>,\n\t) => Effect.Effect<void, never, Scope.Scope>;\n\treadonly codegenable?: (\n\t\tpluginKey: PluginKey,\n\t\tdecl: Codegenable,\n\t) => Effect.Effect<void, never, Scope.Scope>;\n}\n\nexport const productionRouterProfile = (options: DefaultRouterProfileOptions = {}): RouterProfile =>\n\tmakeDefaultRouterProfile(options);\n\nconst productionCodegenOutputDir = (appRoot: string, outputDir: string | undefined): string => {\n\tconst target = outputDir ?? 'src/generated';\n\treturn isAbsolute(target) ? target : resolve(appRoot, target);\n};\n\n/** Codegenable wrapping the resolved manifest-extras blob into a\n *  generated `extras.ts` for app-side consumption. Single-callsite\n *  helper — declared here to keep the orchestrator's view of the\n *  contribution self-contained. */\nconst makeExtrasCodegenable = (extras: ManifestExtras): CodegenableDecl<'app-extras'> => ({\n\tkind: 'codegenable',\n\temitterName: 'app-extras',\n\toutputPath: 'extras.ts',\n\tsensitive: true,\n\temit: (ctx) =>\n\t\tEffect.sync(() => {\n\t\t\tctx.exportConst('extras', extras);\n\t\t\treturn ctx.done();\n\t\t}),\n});\n\nexport const layerProductionOrchestrators = (router: ProductionRouterOptions = {}) => {\n\tconst profile = router.profile ?? productionRouterProfile();\n\treturn Layer.mergeAll(\n\t\tlayerSnapshotOrchestrator,\n\t\tlayerManifestEndpointRegistry,\n\t\tlayerRouterService.pipe(\n\t\t\tLayer.provideMerge(\n\t\t\t\tLayer.mergeAll(\n\t\t\t\t\tlayerEntrypointRegistry(BUILT_IN_ENTRYPOINTS),\n\t\t\t\t\tlayerTraefikContainerOpsDocker,\n\t\t\t\t\tlayerDockerUpstreamResolver(profile),\n\t\t\t\t\tlayerRouterConfigLiteral({\n\t\t\t\t\t\tdisabled: router.disabled ?? false,\n\t\t\t\t\t\tprofile,\n\t\t\t\t\t\timage: router.image ?? DEFAULT_TRAEFIK_IMAGE,\n\t\t\t\t\t\trouteReadinessProbe: {\n\t\t\t\t\t\t\tenabled: router.disabled !== true,\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\t\tlayerCodegenOrchestrator,\n\t\tlayerCodegenPaths.pipe(\n\t\t\tLayer.provideMerge(\n\t\t\t\tlayerCodegenRoot({\n\t\t\t\t\toutputDir: productionCodegenOutputDir(\n\t\t\t\t\t\trouter.codegen?.appRoot ?? process.cwd(),\n\t\t\t\t\t\trouter.codegen?.outputDir,\n\t\t\t\t\t),\n\t\t\t\t\tstackSubdir: router.codegen?.stackSubdir ?? null,\n\t\t\t\t}),\n\t\t\t),\n\t\t),\n\t\tlayerSuiMoveSummaryRunnerDocker,\n\t\tlayerMystenMoveCodegen,\n\t);\n};\n\nexport const bootRouterOrchestrator: Effect.Effect<void, never, RouterService> = Effect.gen(\n\tfunction* () {\n\t\tconst router = yield* RouterService;\n\t\tyield* router.boot().pipe(Effect.orDie);\n\t},\n);\n\n/** Project a `(pluginKey, EndpointUrl)` pair into the field-set both\n *  the engine event and the manifest entry stamp identically. Callers\n *  spread this and then add their output-specific fields (the engine\n *  event's branded `endpointKey` + `registeredAt`; the manifest\n *  entry's stringified `endpointKey` + `pluginKey`). */\nconst routableToEndpointFields = (\n\tpluginKey: PluginKey,\n\tendpoint: EndpointUrl,\n): {\n\treadonly name: string;\n\treadonly url: string;\n\treadonly displayUrl: null;\n\treadonly wireProtocol: EndpointUrl['wireProtocol'];\n\treadonly endpointKeyString: string;\n} => ({\n\tname: endpoint.endpointName,\n\turl: endpoint.url,\n\tdisplayUrl: null,\n\twireProtocol: endpoint.wireProtocol,\n\tendpointKeyString: `${pluginKey}:${endpoint.endpointName}`,\n});\n\nexport const endpointEventFromRoutable = (\n\tpluginKey: PluginKey,\n\tendpoint: EndpointUrl,\n\tregisteredAt = Date.now(),\n): Extract<EngineEvent, { readonly tag: 'endpoint.registered' }> => {\n\tconst { endpointKeyString, ...common } = routableToEndpointFields(pluginKey, endpoint);\n\treturn {\n\t\ttag: 'endpoint.registered',\n\t\tendpoint: {\n\t\t\t...common,\n\t\t\tendpointKey: endpointKey(endpointKeyString),\n\t\t\tpluginKey,\n\t\t\tregisteredAt,\n\t\t},\n\t};\n};\n\nexport const manifestEndpointEntryFromRoutable = (\n\tpluginKey: PluginKey,\n\tendpoint: EndpointUrl,\n): EndpointEntry => {\n\tconst { endpointKeyString, ...common } = routableToEndpointFields(pluginKey, endpoint);\n\treturn {\n\t\t...common,\n\t\tendpointKey: endpointKeyString,\n\t\tpluginKey: String(pluginKey),\n\t};\n};\n\nconst manifestEndpointEntryFromOperationalEndpoint = (\n\tendpoint: Extract<EngineEvent, { readonly tag: 'endpoint.registered' }>['endpoint'],\n): EndpointEntry => ({\n\tendpointKey: String(endpoint.endpointKey),\n\tname: endpoint.name,\n\turl: endpoint.url,\n\tdisplayUrl: endpoint.displayUrl,\n\twireProtocol: endpoint.wireProtocol,\n\tpluginKey: String(endpoint.pluginKey),\n});\n\nconst orchestratorSink = <K extends ContributionKind, TDecl>(\n\tsink: CapabilitySink<K, TDecl>,\n): OrchestratorSinks[number] => sink as OrchestratorSinks[number];\n\nexport const makeProjectionCapabilitySink = (): OrchestratorSinks[number] =>\n\torchestratorSink<'projection', ProjectionDecl>({\n\t\tkind: 'projection',\n\t\taccept: (decl, ctx) =>\n\t\t\tEffect.gen(function* () {\n\t\t\t\t// Stamp `rowKey` (when absent) so projection consumers can\n\t\t\t\t// attribute the row to the contributing plugin. The payload\n\t\t\t\t// stays opaque from the substrate's POV; we project just\n\t\t\t\t// enough to set the row-key field if the payload exposes it.\n\t\t\t\tconst payload = decl.event.payload;\n\t\t\t\tconst payloadWithRowKey =\n\t\t\t\t\tpayload !== null &&\n\t\t\t\t\ttypeof payload === 'object' &&\n\t\t\t\t\t'rowKey' in payload &&\n\t\t\t\t\t(payload as { rowKey: unknown }).rowKey === null\n\t\t\t\t\t\t? { ...payload, rowKey: ctx.pluginKey }\n\t\t\t\t\t\t: payload;\n\t\t\t\tyield* ctx.publish({\n\t\t\t\t\t...decl.event,\n\t\t\t\t\tpayload: payloadWithRowKey,\n\t\t\t\t});\n\t\t\t}),\n\t});\n\nexport const makeStrategyContributorCapabilitySink = (): OrchestratorSinks[number] =>\n\torchestratorSink<'strategy-contributor', StrategyContributorDecl<string, unknown>>({\n\t\tkind: 'strategy-contributor',\n\t\taccept: (decl, ctx) =>\n\t\t\tEffect.gen(function* () {\n\t\t\t\tyield* ctx.registerStrategy(decl);\n\t\t\t\tconst at = Date.now();\n\t\t\t\tyield* ctx.publish({\n\t\t\t\t\ttag: 'strategy.registered',\n\t\t\t\t\tcapabilityKey: decl.capabilityKey,\n\t\t\t\t\tautoMounted: decl.autoMounted,\n\t\t\t\t\tat,\n\t\t\t\t});\n\t\t\t\tyield* Effect.addFinalizer(() =>\n\t\t\t\t\tctx.publish({\n\t\t\t\t\t\ttag: 'strategy.unregistered',\n\t\t\t\t\t\tcapabilityKey: decl.capabilityKey,\n\t\t\t\t\t\tat: Date.now(),\n\t\t\t\t\t}),\n\t\t\t\t);\n\t\t\t}),\n\t});\n\nexport const buildProductionOrchestratorSinks = (\n\tobservers: CapabilityDeliveryObservers = {},\n): Effect.Effect<\n\tOrchestratorSinks,\n\tnever,\n\t| SnapshotOrchestratorService\n\t| RouterService\n\t| CodegenOrchestratorService\n\t| ManifestEndpointRegistryService\n> =>\n\tEffect.gen(function* () {\n\t\tconst snapshot = yield* SnapshotOrchestratorService;\n\t\tconst router = yield* RouterService;\n\t\tconst codegen = yield* CodegenOrchestratorService;\n\t\tconst manifestEndpoints = yield* ManifestEndpointRegistryService;\n\t\treturn [\n\t\t\torchestratorSink<'snapshotable', SnapshotableDecl>({\n\t\t\t\tkind: 'snapshotable',\n\t\t\t\taccept: (decl, ctx) => snapshot.registerParticipant(ctx.pluginKey, decl),\n\t\t\t}),\n\t\t\torchestratorSink<'routable', RoutableDecl>({\n\t\t\t\tkind: 'routable',\n\t\t\t\taccept: (decl, ctx: HarvestContext) =>\n\t\t\t\t\trouter.boot().pipe(\n\t\t\t\t\t\tEffect.andThen(router.contributeRoute(decl)),\n\t\t\t\t\t\tEffect.flatMap((endpoint) => {\n\t\t\t\t\t\t\tconst event = endpointEventFromRoutable(ctx.pluginKey, endpoint);\n\t\t\t\t\t\t\tconst manifestEntry = manifestEndpointEntryFromRoutable(ctx.pluginKey, endpoint);\n\t\t\t\t\t\t\treturn manifestEndpoints\n\t\t\t\t\t\t\t\t.register(manifestEntry)\n\t\t\t\t\t\t\t\t.pipe(\n\t\t\t\t\t\t\t\t\tEffect.andThen(ctx.publish(event)),\n\t\t\t\t\t\t\t\t\tEffect.andThen(\n\t\t\t\t\t\t\t\t\t\tobservers.routable\n\t\t\t\t\t\t\t\t\t\t\t? observers.routable(ctx.pluginKey, endpoint, event)\n\t\t\t\t\t\t\t\t\t\t\t: Effect.void,\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}),\n\t\t\t\t\t),\n\t\t\t}),\n\t\t\torchestratorSink<'codegenable', Codegenable>({\n\t\t\t\tkind: 'codegenable',\n\t\t\t\taccept: (decl, ctx) =>\n\t\t\t\t\tcodegen\n\t\t\t\t\t\t.registerContribution(ctx.pluginKey, decl)\n\t\t\t\t\t\t.pipe(\n\t\t\t\t\t\t\tEffect.flatMap(() =>\n\t\t\t\t\t\t\t\tobservers.codegenable ? observers.codegenable(ctx.pluginKey, decl) : Effect.void,\n\t\t\t\t\t\t\t),\n\t\t\t\t\t\t),\n\t\t\t}),\n\t\t\tmakeProjectionCapabilitySink(),\n\t\t\tmakeStrategyContributorCapabilitySink(),\n\t\t];\n\t});\n\nconst makeManifestExtrasContext = (ctx: SupervisorPostAcquireContext) => {\n\tconst resourceIdToKey = new Map<string, PluginKey>();\n\tfor (const [key, node] of ctx.graph.nodes) {\n\t\tresourceIdToKey.set(node.member.id, key);\n\t}\n\t// `lookup` throws `ManifestExtrasLookupError` synchronously from\n\t// inside the user-supplied `extras` factory.\n\t// `resolveManifestExtras` invokes that factory under `Effect.try`\n\t// with a typed `catch` mapper, so the throw promotes to the typed\n\t// failure channel — callers `catchTag('ManifestExtrasLookupError',\n\t// ...)` rather than reading the die-cause. Non-tagged throws stay\n\t// defects, preserving the previous semantics for genuine\n\t// programmer errors inside the factory body.\n\tconst lookup = (resourceId: string): unknown => {\n\t\tconst key = resourceIdToKey.get(resourceId);\n\t\tif (key === undefined) {\n\t\t\tthrow new ManifestExtrasLookupError({\n\t\t\t\tkind: 'unknown-resource',\n\t\t\t\tresourceId,\n\t\t\t});\n\t\t}\n\t\tconst resolved = readResolvedSync(ctx.registry, key);\n\t\tif (resolved === undefined) {\n\t\t\tthrow new ManifestExtrasLookupError({\n\t\t\t\tkind: 'unresolved-resource',\n\t\t\t\tresourceId,\n\t\t\t});\n\t\t}\n\t\treturn resolved;\n\t};\n\treturn {\n\t\tvalue: (resource: { readonly id: string }) => lookup(resource.id),\n\t};\n};\n\nconst operationalManifestEndpointEntries = (\n\tctx: SupervisorPostAcquireContext,\n\troutableEntries: ReadonlyArray<EndpointEntry>,\n): ReadonlyArray<EndpointEntry> => {\n\tconst routablePluginKeys = new Set(routableEntries.map((entry) => entry.pluginKey));\n\tconst registeredAt = Date.now();\n\tconst entries: EndpointEntry[] = [];\n\tfor (const [key] of ctx.graph.nodes) {\n\t\tif (routablePluginKeys.has(String(key))) continue;\n\t\tconst resolved = readResolvedSync(ctx.registry, key);\n\t\tif (resolved === undefined) continue;\n\t\tfor (const event of operationalEndpointEventsFromResolvedValue(key, resolved, registeredAt)) {\n\t\t\tentries.push(manifestEndpointEntryFromOperationalEndpoint(event.endpoint));\n\t\t}\n\t}\n\treturn entries;\n};\n\nexport const buildProductionPostAcquireHook = (\n\toptions: ProductionPostAcquireOptions = {},\n): Effect.Effect<\n\tSupervisorPostAcquireHook,\n\tnever,\n\t| CodegenOrchestratorService\n\t| CodegenPathsService\n\t| MoveSummaryRunnerService\n\t| MoveCodegenService\n\t| FileSystem.FileSystem\n\t| StackPathsService\n\t| PostAcquireTasksService\n\t| ManifestEndpointRegistryService\n> =>\n\tEffect.gen(function* () {\n\t\tconst codegen = yield* CodegenOrchestratorService;\n\t\tconst paths = yield* CodegenPathsService;\n\t\tconst summaryRunner = yield* MoveSummaryRunnerService;\n\t\tconst moveCodegen = yield* MoveCodegenService;\n\t\tconst fs = yield* FileSystem.FileSystem;\n\t\tconst stackPaths = yield* StackPathsService;\n\t\tconst postAcquireTasks = yield* PostAcquireTasksService;\n\t\tconst manifestEndpoints = yield* ManifestEndpointRegistryService;\n\t\treturn (ctx) =>\n\t\t\tEffect.gen(function* () {\n\t\t\t\tconst extras = yield* resolveManifestExtras(options.extras, makeManifestExtrasContext(ctx));\n\t\t\t\tconst routableEndpoints = yield* manifestEndpoints.entries;\n\t\t\t\tconst endpoints = [\n\t\t\t\t\t...routableEndpoints,\n\t\t\t\t\t...operationalManifestEndpointEntries(ctx, routableEndpoints),\n\t\t\t\t];\n\t\t\t\tconst envelope = yield* buildEnvelope({\n\t\t\t\t\tidentity: {\n\t\t\t\t\t\tapp: ctx.identity.app,\n\t\t\t\t\t\tstack: ctx.identity.stack,\n\t\t\t\t\t\tchain: ctx.identity.chain,\n\t\t\t\t\t},\n\t\t\t\t\tcontributions: [],\n\t\t\t\t\tendpoints,\n\t\t\t\t\textras,\n\t\t\t\t\t// Record the EXACT dir codegen emits into for this stack so\n\t\t\t\t\t// the read-side `@generated` alias (the Vite plugin) points\n\t\t\t\t\t// where the files actually are — one decision, one source of\n\t\t\t\t\t// truth (notes/per-stack-codegen-design.md §\"Resolved: read\n\t\t\t\t\t// and write share one gate\"). `paths.outputDir` is already\n\t\t\t\t\t// the resolved, stack-subdir-applied absolute path the emit\n\t\t\t\t\t// pipeline writes to.\n\t\t\t\t\tcodegen: { generatedDir: paths.outputDir },\n\t\t\t\t});\n\t\t\t\tconst manifestPath = join(stackPaths.stackRoot, 'manifest.json');\n\t\t\t\tyield* writeManifest(envelope, manifestPath).pipe(\n\t\t\t\t\tEffect.provideService(FileSystem.FileSystem, fs),\n\t\t\t\t);\n\t\t\t\tconst result = yield* codegen\n\t\t\t\t\t.runCycle({ extraContributions: [makeExtrasCodegenable(extras)] })\n\t\t\t\t\t.pipe(\n\t\t\t\t\t\tEffect.provideService(CodegenPathsService, paths),\n\t\t\t\t\t\tEffect.provideService(MoveSummaryRunnerService, summaryRunner),\n\t\t\t\t\t\tEffect.provideService(MoveCodegenService, moveCodegen),\n\t\t\t\t\t\tEffect.provideService(FileSystem.FileSystem, fs),\n\t\t\t\t\t);\n\t\t\t\tyield* postAcquireTasks.runAll;\n\t\t\t\treturn [\n\t\t\t\t\t{\n\t\t\t\t\t\ttag: 'manifest.flushed' as const,\n\t\t\t\t\t\tmanifestVersion: CURRENT_MANIFEST_VERSION,\n\t\t\t\t\t\tat: Date.now(),\n\t\t\t\t\t},\n\t\t\t\t\t{\n\t\t\t\t\t\ttag: 'codegen.emitted' as const,\n\t\t\t\t\t\tfiles: [\n\t\t\t\t\t\t\t...result.filesWritten,\n\t\t\t\t\t\t\t...result.filesChmod,\n\t\t\t\t\t\t\t...(result.bindings?.filesWritten ?? []),\n\t\t\t\t\t\t],\n\t\t\t\t\t\tat: Date.now(),\n\t\t\t\t\t},\n\t\t\t\t];\n\t\t\t});\n\t});\n\nexport type { EndpointUrl, ResolvedRoute };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAgGA,IAAa,kCAAb,cAAqD,QAAQ,SAG1D,CAAC,mDAAmD,CAAC;AAExD,MAAa,gCACZ,MAAM,OACL,iCACA,OAAO,IAAI,aAAa;CACvB,MAAM,aAAa,OAAO,IAAI,KAC7B,EAAE,CACF;CACD,MAAM,SAAS,OAAO,IAAI,KAAK,EAAE;CAEjC,MAAM,YAAY,UACjB,OAAO,IAAI,aAAa;EACvB,MAAM,MAAM,OAAO,IAAI,aAAa,SAAS,MAAM,IAAI,EAAE;AACzD,SAAO,IAAI,OAAO,aAAa,YAAY,CAAC,GAAG,SAAS;GAAE,GAAG;GAAO;GAAK,CAAC,CAAC;AAC3E,SAAO,OAAO,mBACb,IAAI,OAAO,aAAa,YACvB,QAAQ,QAAQ,cAAc,UAAU,QAAQ,IAAI,CACpD,CACD;GACA;AAEH,QAAO,gCAAgC,GAAG;EACzC;EACA,SAAS,IAAI,IAAI,WAAW,CAAC,KAC5B,OAAO,KAAK,YACX,QAAQ,KAAK,iBAAiB;GAC7B,MAAM,EAAE,KAAK,GAAG,UAAU;AAE1B,UAAO;IACN,CACF,CACD;EACD,CAAC;EACD,CACF;AAcF,MAAa,2BAA2B,UAAuC,EAAE,KAChF,yBAAyB,QAAQ;AAElC,MAAM,8BAA8B,SAAiB,cAA0C;CAC9F,MAAM,SAAS,aAAa;AAC5B,QAAO,WAAW,OAAO,GAAG,SAAS,QAAQ,SAAS,OAAO;;;;;;AAO9D,MAAM,yBAAyB,YAA2D;CACzF,MAAM;CACN,aAAa;CACb,YAAY;CACZ,WAAW;CACX,OAAO,QACN,OAAO,WAAW;AACjB,MAAI,YAAY,UAAU,OAAO;AACjC,SAAO,IAAI,MAAM;GAChB;CACH;AAED,MAAa,gCAAgC,SAAkC,EAAE,KAAK;CACrF,MAAM,UAAU,OAAO,WAAW,yBAAyB;AAC3D,QAAO,MAAM,SACZ,2BACA,+BACA,mBAAmB,KAClB,MAAM,aACL,MAAM,SACL,wBAAwB,qBAAqB,EAC7C,gCACA,4BAA4B,QAAQ,EACpC,yBAAyB;EACxB,UAAU,OAAO,YAAY;EAC7B;EACA,OAAO,OAAO,SAAA;EACd,qBAAqB,EACpB,SAAS,OAAO,aAAa,MAC7B;EACD,CAAC,CACF,CACD,CACD,EACD,0BACA,kBAAkB,KACjB,MAAM,aACL,iBAAiB;EAChB,WAAW,2BACV,OAAO,SAAS,WAAW,QAAQ,KAAK,EACxC,OAAO,SAAS,UAChB;EACD,aAAa,OAAO,SAAS,eAAe;EAC5C,CAAC,CACF,CACD,EACD,iCACA,uBACA;;AAG+E,OAAO,IACvF,aAAa;AAEZ,SAAO,OADe,eACR,MAAM,CAAC,KAAK,OAAO,MAAM;EAExC;;;;;;AAOD,MAAM,4BACL,WACA,cAOK;CACL,MAAM,SAAS;CACf,KAAK,SAAS;CACd,YAAY;CACZ,cAAc,SAAS;CACvB,mBAAmB,GAAG,UAAU,GAAG,SAAS;CAC5C;AAED,MAAa,6BACZ,WACA,UACA,eAAe,KAAK,KAAK,KAC0C;CACnE,MAAM,EAAE,mBAAmB,GAAG,WAAW,yBAAyB,WAAW,SAAS;AACtF,QAAO;EACN,KAAK;EACL,UAAU;GACT,GAAG;GACH,aAAa,YAAY,kBAAkB;GAC3C;GACA;GACA;EACD;;AAGF,MAAa,qCACZ,WACA,aACmB;CACnB,MAAM,EAAE,mBAAmB,GAAG,WAAW,yBAAyB,WAAW,SAAS;AACtF,QAAO;EACN,GAAG;EACH,aAAa;EACb,WAAW,OAAO,UAAU;EAC5B;;AAGF,MAAM,gDACL,cACoB;CACpB,aAAa,OAAO,SAAS,YAAY;CACzC,MAAM,SAAS;CACf,KAAK,SAAS;CACd,YAAY,SAAS;CACrB,cAAc,SAAS;CACvB,WAAW,OAAO,SAAS,UAAU;CACrC;AAED,MAAM,oBACL,SAC+B;AAEhC,MAAa,qCACZ,iBAA+C;CAC9C,MAAM;CACN,SAAS,MAAM,QACd,OAAO,IAAI,aAAa;EAKvB,MAAM,UAAU,KAAK,MAAM;EAC3B,MAAM,oBACL,YAAY,QACZ,OAAO,YAAY,YACnB,YAAY,WACX,QAAgC,WAAW,OACzC;GAAE,GAAG;GAAS,QAAQ,IAAI;GAAW,GACrC;AACJ,SAAO,IAAI,QAAQ;GAClB,GAAG,KAAK;GACR,SAAS;GACT,CAAC;GACD;CACH,CAAC;AAEH,MAAa,8CACZ,iBAAmF;CAClF,MAAM;CACN,SAAS,MAAM,QACd,OAAO,IAAI,aAAa;AACvB,SAAO,IAAI,iBAAiB,KAAK;EACjC,MAAM,KAAK,KAAK,KAAK;AACrB,SAAO,IAAI,QAAQ;GAClB,KAAK;GACL,eAAe,KAAK;GACpB,aAAa,KAAK;GAClB;GACA,CAAC;AACF,SAAO,OAAO,mBACb,IAAI,QAAQ;GACX,KAAK;GACL,eAAe,KAAK;GACpB,IAAI,KAAK,KAAK;GACd,CAAC,CACF;GACA;CACH,CAAC;AAEH,MAAa,oCACZ,YAAyC,EAAE,KAS3C,OAAO,IAAI,aAAa;CACvB,MAAM,WAAW,OAAO;CACxB,MAAM,SAAS,OAAO;CACtB,MAAM,UAAU,OAAO;CACvB,MAAM,oBAAoB,OAAO;AACjC,QAAO;EACN,iBAAmD;GAClD,MAAM;GACN,SAAS,MAAM,QAAQ,SAAS,oBAAoB,IAAI,WAAW,KAAK;GACxE,CAAC;EACF,iBAA2C;GAC1C,MAAM;GACN,SAAS,MAAM,QACd,OAAO,MAAM,CAAC,KACb,OAAO,QAAQ,OAAO,gBAAgB,KAAK,CAAC,EAC5C,OAAO,SAAS,aAAa;IAC5B,MAAM,QAAQ,0BAA0B,IAAI,WAAW,SAAS;IAChE,MAAM,gBAAgB,kCAAkC,IAAI,WAAW,SAAS;AAChF,WAAO,kBACL,SAAS,cAAc,CACvB,KACA,OAAO,QAAQ,IAAI,QAAQ,MAAM,CAAC,EAClC,OAAO,QACN,UAAU,WACP,UAAU,SAAS,IAAI,WAAW,UAAU,MAAM,GAClD,OAAO,KACV,CACD;KACD,CACF;GACF,CAAC;EACF,iBAA6C;GAC5C,MAAM;GACN,SAAS,MAAM,QACd,QACE,qBAAqB,IAAI,WAAW,KAAK,CACzC,KACA,OAAO,cACN,UAAU,cAAc,UAAU,YAAY,IAAI,WAAW,KAAK,GAAG,OAAO,KAC5E,CACD;GACH,CAAC;EACF,8BAA8B;EAC9B,uCAAuC;EACvC;EACA;AAEH,MAAM,6BAA6B,QAAsC;CACxE,MAAM,kCAAkB,IAAI,KAAwB;AACpD,MAAK,MAAM,CAAC,KAAK,SAAS,IAAI,MAAM,MACnC,iBAAgB,IAAI,KAAK,OAAO,IAAI,IAAI;CAUzC,MAAM,UAAU,eAAgC;EAC/C,MAAM,MAAM,gBAAgB,IAAI,WAAW;AAC3C,MAAI,QAAQ,KAAA,EACX,OAAM,IAAI,0BAA0B;GACnC,MAAM;GACN;GACA,CAAC;EAEH,MAAM,WAAW,iBAAiB,IAAI,UAAU,IAAI;AACpD,MAAI,aAAa,KAAA,EAChB,OAAM,IAAI,0BAA0B;GACnC,MAAM;GACN;GACA,CAAC;AAEH,SAAO;;AAER,QAAO,EACN,QAAQ,aAAsC,OAAO,SAAS,GAAG,EACjE;;AAGF,MAAM,sCACL,KACA,oBACkC;CAClC,MAAM,qBAAqB,IAAI,IAAI,gBAAgB,KAAK,UAAU,MAAM,UAAU,CAAC;CACnF,MAAM,eAAe,KAAK,KAAK;CAC/B,MAAM,UAA2B,EAAE;AACnC,MAAK,MAAM,CAAC,QAAQ,IAAI,MAAM,OAAO;AACpC,MAAI,mBAAmB,IAAI,OAAO,IAAI,CAAC,CAAE;EACzC,MAAM,WAAW,iBAAiB,IAAI,UAAU,IAAI;AACpD,MAAI,aAAa,KAAA,EAAW;AAC5B,OAAK,MAAM,SAAS,2CAA2C,KAAK,UAAU,aAAa,CAC1F,SAAQ,KAAK,6CAA6C,MAAM,SAAS,CAAC;;AAG5E,QAAO;;AAGR,MAAa,kCACZ,UAAwC,EAAE,KAa1C,OAAO,IAAI,aAAa;CACvB,MAAM,UAAU,OAAO;CACvB,MAAM,QAAQ,OAAO;CACrB,MAAM,gBAAgB,OAAO;CAC7B,MAAM,cAAc,OAAO;CAC3B,MAAM,KAAK,OAAO,WAAW;CAC7B,MAAM,aAAa,OAAO;CAC1B,MAAM,mBAAmB,OAAO;CAChC,MAAM,oBAAoB,OAAO;AACjC,SAAQ,QACP,OAAO,IAAI,aAAa;EACvB,MAAM,SAAS,OAAO,sBAAsB,QAAQ,QAAQ,0BAA0B,IAAI,CAAC;EAC3F,MAAM,oBAAoB,OAAO,kBAAkB;EACnD,MAAM,YAAY,CACjB,GAAG,mBACH,GAAG,mCAAmC,KAAK,kBAAkB,CAC7D;AAoBD,SAAO,cAAc,OAnBG,cAAc;GACrC,UAAU;IACT,KAAK,IAAI,SAAS;IAClB,OAAO,IAAI,SAAS;IACpB,OAAO,IAAI,SAAS;IACpB;GACD,eAAe,EAAE;GACjB;GACA;GAQA,SAAS,EAAE,cAAc,MAAM,WAAW;GAC1C,CAAC,EACmB,KAAK,WAAW,WAAW,gBACL,CAAC,CAAC,KAC5C,OAAO,eAAe,WAAW,YAAY,GAAG,CAChD;EACD,MAAM,SAAS,OAAO,QACpB,SAAS,EAAE,oBAAoB,CAAC,sBAAsB,OAAO,CAAC,EAAE,CAAC,CACjE,KACA,OAAO,eAAe,qBAAqB,MAAM,EACjD,OAAO,eAAe,0BAA0B,cAAc,EAC9D,OAAO,eAAe,oBAAoB,YAAY,EACtD,OAAO,eAAe,WAAW,YAAY,GAAG,CAChD;AACF,SAAO,iBAAiB;AACxB,SAAO,CACN;GACC,KAAK;GACL,iBAAA;GACA,IAAI,KAAK,KAAK;GACd,EACD;GACC,KAAK;GACL,OAAO;IACN,GAAG,OAAO;IACV,GAAG,OAAO;IACV,GAAI,OAAO,UAAU,gBAAgB,EAAE;IACvC;GACD,IAAI,KAAK,KAAK;GACd,CACD;GACA;EACF"}

package/dist/orchestrators/snapshot/capture-command.d.mts

@@ -1 +0,0 @@
-import { Effect, FileSystem } from "effect";

package/dist/orchestrators/snapshot/capture-command.mjs

@@ -1,25 +0,0 @@
-import { SnapshotOrchestratorService } from "./service.mjs";
-import { Effect } from "effect";
-//#region src/orchestrators/snapshot/capture-command.ts
-/** Capture a snapshot via the registered `SnapshotOrchestratorService`.
-*  Returns the orchestrator's typed `SnapshotMetadata` on success;
-*  fails with the orchestrator's tagged `SnapshotOrchestratorError`
-*  union (callers `catchTags` on the precise tags they care about).
-*
-*  The required context — `SnapshotOrchestratorService` and the
-*  `FileSystem` service the orchestrator's `capture` call consumes —
-*  flows in through the ambient Effect Context (NOT closure args);
-*  identity and stack-paths come transitively from the orchestrator
-*  layer's own requirements.
-*/
-const captureSnapshot = (args) => Effect.gen(function* () {
-	return yield* (yield* SnapshotOrchestratorService).capture({
-		id: args.snapshotId,
-		label: args.name,
-		onProgress: args.onProgress
-	});
-});
-//#endregion
-export { captureSnapshot };
-
-//# sourceMappingURL=capture-command.mjs.map

package/dist/orchestrators/snapshot/capture-command.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"capture-command.mjs","names":[],"sources":["../../../src/orchestrators/snapshot/capture-command.ts"],"sourcesContent":["// Shared `captureSnapshot` command primitive.\n//\n// This is the hoisted core of `EngineCommand` `snapshot.capture` —\n// the single Effect both publishers reach for:\n//\n//   - The supervisor's command handler in `cli/wirings/up.ts`\n//     consumes a queued `snapshot.capture` EngineCommand and forwards\n//     its `{ snapshotId, name }` payload here (with `onProgress`\n//     wired to `handlerCtx.publish` so progress lands on the engine\n//     event stream).\n//\n//   - The CLI's direct/offline `snapshot save` path in\n//     `cli/wirings/snapshot.ts` calls this from inside its one-shot\n//     `superviseStackEffect` scope (no supervisor alive).\n//\n//   - A future web-dashboard command receiver lands here too — it\n//     only needs the `SnapshotOrchestratorService` + `FileSystem` in\n//     its layer stack, with no CLI wiring imported.\n//\n// The primitive's contract is intentionally narrow: it owns the\n// EngineCommand-payload → orchestrator-call shape and nothing else.\n// CLI-specific concerns (logger config, exit codes, ack/event\n// shaping, error narration) stay at the call sites — this file\n// MUST NOT bake them in.\n\nimport { Effect, FileSystem } from 'effect';\n\nimport type { SnapshotProgressReporter } from './capture.ts';\nimport type { SnapshotMetadata } from './descriptor.ts';\nimport {\n\tSnapshotOrchestratorService,\n\ttype SnapshotOrchestratorError,\n} from './service.ts';\n\n/** Inputs mirror the `snapshot.capture` EngineCommand payload\n *  (`{ snapshotId?, name? }`) plus the optional progress reporter\n *  the supervisor wires into its event-publish bridge. The offline\n *  CLI path passes the same payload (from CLI flags) and omits\n *  `onProgress` (no engine stream to publish to). */\nexport interface CaptureSnapshotArgs {\n\treadonly snapshotId?: string;\n\treadonly name?: string;\n\treadonly onProgress?: SnapshotProgressReporter;\n}\n\n/** Capture a snapshot via the registered `SnapshotOrchestratorService`.\n *  Returns the orchestrator's typed `SnapshotMetadata` on success;\n *  fails with the orchestrator's tagged `SnapshotOrchestratorError`\n *  union (callers `catchTags` on the precise tags they care about).\n *\n *  The required context — `SnapshotOrchestratorService` and the\n *  `FileSystem` service the orchestrator's `capture` call consumes —\n *  flows in through the ambient Effect Context (NOT closure args);\n *  identity and stack-paths come transitively from the orchestrator\n *  layer's own requirements.\n */\nexport const captureSnapshot = (\n\targs: CaptureSnapshotArgs,\n): Effect.Effect<\n\tSnapshotMetadata,\n\tSnapshotOrchestratorError,\n\tSnapshotOrchestratorService | FileSystem.FileSystem\n> =>\n\tEffect.gen(function* () {\n\t\tconst snapshot = yield* SnapshotOrchestratorService;\n\t\treturn yield* snapshot.capture({\n\t\t\tid: args.snapshotId,\n\t\t\tlabel: args.name,\n\t\t\tonProgress: args.onProgress,\n\t\t});\n\t});\n"],"mappings":";;;;;;;;;;;;;;AAwDA,MAAa,mBACZ,SAMA,OAAO,IAAI,aAAa;AAEvB,QAAO,QAAO,OADU,6BACD,QAAQ;EAC9B,IAAI,KAAK;EACT,OAAO,KAAK;EACZ,YAAY,KAAK;EACjB,CAAC;EACD"}

package/dist/orchestrators/snapshot/pending-marker.mjs

@@ -1,99 +0,0 @@
-import { versionedDocSchema } from "../../substrate/versioned-doc-schema.mjs";
-import { atomicWriteFile } from "../../substrate/runtime/atomic-write.mjs";
-import { Effect, FileSystem, Schema } from "effect";
-const RESTORE_PENDING_FILE_NAME = "snapshot.restore-pending.json";
-const RestorePendingContainerSchema = Schema.Struct({
-	plugin: Schema.String,
-	role: Schema.String,
-	targetImageName: Schema.String,
-	stagedImageTag: Schema.String,
-	/** Content-addressed image identity (e.g. `sha256:...`). The
-	*  scanner uses this as the third-and-final recovery source when
-	*  both `targetImageName` and `stagedImageTag` have been removed
-	*  from the daemon (e.g. operator `docker system prune` between
-	*  crash and restart). Digests survive prune because they ARE the
-	*  image — Docker can re-tag from any digest still backed by a
-	*  pinned layer. */
-	digest: Schema.String
-});
-/** v2 marker variant — current shape. New variants are added by
-*  appending another `versionedDocSchema(N, ...)` arm to the Union
-*  below; consumers switch on `version` after decode. */
-const RestorePendingDocumentV2Schema = versionedDocSchema(2, {
-	snapshotId: Schema.String,
-	artifactDir: Schema.String,
-	app: Schema.String,
-	stack: Schema.String,
-	network: Schema.String,
-	containers: Schema.Array(RestorePendingContainerSchema)
-});
-/** Discriminated union of every supported marker version. Today only
-*  v2 is on disk; the Union shape exists so a v3 migration is a
-*  one-line `Schema.Union(...v2, ...v3)` extension here plus a new
-*  `case` in the recovery scanner. Stale pre-v2 markers fail decode
-*  cleanly — the scanner translates that into a "leave on disk for
-*  operator review" warning rather than a fatal error. */
-const RestorePendingDocumentSchema = Schema.Union([RestorePendingDocumentV2Schema]);
-/** Path the marker lives at, relative to a runtime stack root or
-*  staged-tree root. */
-const pendingMarkerPath = (root) => `${root}/${RESTORE_PENDING_FILE_NAME}`;
-/** Failure shape for marker IO. The scanner / restore both map this
-*  onto their own typed channels. */
-var RestorePendingMarkerIoError = class extends Schema.TaggedErrorClass()("SnapshotRestorePendingMarkerIoError", {
-	op: Schema.Literals([
-		"read",
-		"write",
-		"remove",
-		"decode"
-	]),
-	path: Schema.String,
-	detail: Schema.String,
-	cause: Schema.optional(Schema.Defect)
-}) {};
-/** Write or rewrite the marker. The serialized payload is one trailing
-*  newline larger than `JSON.stringify(doc, null, 2)`. */
-const writePendingMarker = (root, doc) => Effect.gen(function* () {
-	const path = pendingMarkerPath(root);
-	yield* atomicWriteFile(path, new TextEncoder().encode(`${JSON.stringify(doc, null, 2)}\n`)).pipe(Effect.catch((cause) => Effect.fail(new RestorePendingMarkerIoError({
-		op: "write",
-		path,
-		detail: `write ${RESTORE_PENDING_FILE_NAME} failed`,
-		cause
-	}))));
-});
-/** Build a marker document from the snapshot metadata + outstanding
-*  per-image entries. Caller decides what's outstanding. */
-const makePendingMarkerDocument = (args) => ({
-	version: 2,
-	snapshotId: args.meta.id,
-	artifactDir: args.artifactDir,
-	app: args.meta.app,
-	stack: args.meta.stack,
-	network: args.meta.network,
-	containers: args.containers
-});
-/** Rewrite an existing marker, replacing the `containers` list.
-*  The recovery scanner uses this to whittle the outstanding entry
-*  list down as it retags each image — the next supervise (or the
-*  next loop iteration after a transient daemon hiccup) sees an
-*  up-to-date marker without re-deriving identity from `meta.json`. */
-const rewritePendingMarkerContainers = (doc, containers) => ({
-	...doc,
-	containers
-});
-/** Remove the marker. Idempotent — `force: true` swallows "already
-*  gone". Other IO failures surface as `RestorePendingMarkerIoError`. */
-const removePendingMarker = (root) => Effect.gen(function* () {
-	const fs = yield* FileSystem.FileSystem;
-	const path = pendingMarkerPath(root);
-	yield* fs.remove(path, { force: true }).pipe(Effect.catch((cause) => Effect.fail(new RestorePendingMarkerIoError({
-		op: "remove",
-		path,
-		detail: `remove ${RESTORE_PENDING_FILE_NAME} failed`,
-		cause
-	}))));
-});
-//#endregion
-export { RESTORE_PENDING_FILE_NAME, RestorePendingDocumentSchema, RestorePendingMarkerIoError, makePendingMarkerDocument, pendingMarkerPath, removePendingMarker, rewritePendingMarkerContainers, writePendingMarker };
-
-//# sourceMappingURL=pending-marker.mjs.map

package/dist/orchestrators/snapshot/pending-marker.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"pending-marker.mjs","names":[],"sources":["../../../src/orchestrators/snapshot/pending-marker.ts"],"sourcesContent":["// Restore-pending marker — shared schema + IO between `restore.ts`\n// (writer/clearer) and `recover-pending.ts` (reader/recoverer).\n//\n// Recovery contract:\n//\n//   The marker is written into the snapshot's staged tree BEFORE the\n//   atomic stage-and-swap publish, then survives the swap into the\n//   restored runtime root. After publish, `runRestore` runs the\n//   Docker handoff (promote staged tags → recorded names, remove\n//   captured managed containers) under `Effect.uninterruptible`. If\n//   the process is hard-killed mid-handoff — or any step fails after\n//   K of N images promoted — the marker stays on disk and lists which\n//   `(targetImageName ← stagedImageTag, digest)` operations remain\n//   pending. The digest is the loaded image's content-addressed\n//   identity; the scanner falls back to it when the staging tag has\n//   been pruned from the daemon between crash and restart.\n//\n//   On the next supervise startup, `recoverPendingRestore` reads the\n//   marker, retries each pending entry's `tagImage`, removes the\n//   marker only when every entry verifies, and is idempotent: a\n//   marker present with zero outstanding entries is treated as\n//   already-recovered and cleared in one call.\n//\n//   The marker is updated AFTER EACH successful image promote in the\n//   happy path (see `restore.ts:promoteStagedImages`) so the\n//   recovery scanner only has to address the entries still listed —\n//   it never has to know which of the original N images was the one\n//   that failed.\n\nimport { Effect, FileSystem, Schema } from 'effect';\n\nimport { atomicWriteFile } from '../../substrate/runtime/atomic-write.ts';\nimport { versionedDocSchema } from '../../substrate/versioned-doc-schema.ts';\nimport type { SnapshotMetadata } from './descriptor.ts';\n\nexport const SNAPSHOT_RESTORE_PENDING_VERSION = 2 as const;\nexport const RESTORE_PENDING_FILE_NAME = 'snapshot.restore-pending.json' as const;\n\nexport const RestorePendingContainerSchema = Schema.Struct({\n\tplugin: Schema.String,\n\trole: Schema.String,\n\ttargetImageName: Schema.String,\n\tstagedImageTag: Schema.String,\n\t/** Content-addressed image identity (e.g. `sha256:...`). The\n\t *  scanner uses this as the third-and-final recovery source when\n\t *  both `targetImageName` and `stagedImageTag` have been removed\n\t *  from the daemon (e.g. operator `docker system prune` between\n\t *  crash and restart). Digests survive prune because they ARE the\n\t *  image — Docker can re-tag from any digest still backed by a\n\t *  pinned layer. */\n\tdigest: Schema.String,\n});\nexport type RestorePendingContainer = Schema.Schema.Type<typeof RestorePendingContainerSchema>;\n\nconst RestorePendingDocumentV2Payload = {\n\tsnapshotId: Schema.String,\n\tartifactDir: Schema.String,\n\tapp: Schema.String,\n\tstack: Schema.String,\n\tnetwork: Schema.String,\n\tcontainers: Schema.Array(RestorePendingContainerSchema),\n} as const;\n\n/** v2 marker variant — current shape. New variants are added by\n *  appending another `versionedDocSchema(N, ...)` arm to the Union\n *  below; consumers switch on `version` after decode. */\nexport const RestorePendingDocumentV2Schema = versionedDocSchema(\n\tSNAPSHOT_RESTORE_PENDING_VERSION,\n\tRestorePendingDocumentV2Payload,\n);\nexport type RestorePendingDocumentV2 = Schema.Schema.Type<typeof RestorePendingDocumentV2Schema>;\n\n/** Discriminated union of every supported marker version. Today only\n *  v2 is on disk; the Union shape exists so a v3 migration is a\n *  one-line `Schema.Union(...v2, ...v3)` extension here plus a new\n *  `case` in the recovery scanner. Stale pre-v2 markers fail decode\n *  cleanly — the scanner translates that into a \"leave on disk for\n *  operator review\" warning rather than a fatal error. */\nexport const RestorePendingDocumentSchema = Schema.Union([RestorePendingDocumentV2Schema]);\nexport type RestorePendingDocument = Schema.Schema.Type<typeof RestorePendingDocumentSchema>;\n\n/** Path the marker lives at, relative to a runtime stack root or\n *  staged-tree root. */\nexport const pendingMarkerPath = (root: string): string =>\n\t`${root}/${RESTORE_PENDING_FILE_NAME}`;\n\n/** Failure shape for marker IO. The scanner / restore both map this\n *  onto their own typed channels. */\nexport class RestorePendingMarkerIoError extends Schema.TaggedErrorClass<RestorePendingMarkerIoError>()(\n\t'SnapshotRestorePendingMarkerIoError',\n\t{\n\t\top: Schema.Literals(['read', 'write', 'remove', 'decode']),\n\t\tpath: Schema.String,\n\t\tdetail: Schema.String,\n\t\tcause: Schema.optional(Schema.Defect),\n\t},\n) {}\n\n/** Write or rewrite the marker. The serialized payload is one trailing\n *  newline larger than `JSON.stringify(doc, null, 2)`. */\nexport const writePendingMarker = (\n\troot: string,\n\tdoc: RestorePendingDocument,\n): Effect.Effect<void, RestorePendingMarkerIoError, FileSystem.FileSystem> =>\n\tEffect.gen(function* () {\n\t\tconst path = pendingMarkerPath(root);\n\t\t// The marker is durable cross-process state on the LIVE runtime\n\t\t// root (recovery scanner reads it on the next supervise). Route\n\t\t// through the canonical atomic primitive (STYLE_GUIDE §17) so a\n\t\t// crashed mid-rewrite never leaves the scanner a half-written /\n\t\t// undecodable marker. `atomicWriteFile` (not `atomicWriteJson`)\n\t\t// preserves the exact `JSON.stringify(…, 2)` + trailing-newline\n\t\t// byte shape this writer has always produced.\n\t\tconst bytes = new TextEncoder().encode(`${JSON.stringify(doc, null, 2)}\\n`);\n\t\tyield* atomicWriteFile(path, bytes).pipe(\n\t\t\tEffect.catch(\n\t\t\t\t(cause): Effect.Effect<never, RestorePendingMarkerIoError> =>\n\t\t\t\t\tEffect.fail(\n\t\t\t\t\t\tnew RestorePendingMarkerIoError({\n\t\t\t\t\t\t\top: 'write',\n\t\t\t\t\t\t\tpath,\n\t\t\t\t\t\t\tdetail: `write ${RESTORE_PENDING_FILE_NAME} failed`,\n\t\t\t\t\t\t\tcause,\n\t\t\t\t\t\t}),\n\t\t\t\t\t),\n\t\t\t),\n\t\t);\n\t});\n\n/** Build a marker document from the snapshot metadata + outstanding\n *  per-image entries. Caller decides what's outstanding. */\nexport const makePendingMarkerDocument = (args: {\n\treadonly meta: SnapshotMetadata;\n\treadonly artifactDir: string;\n\treadonly containers: ReadonlyArray<RestorePendingContainer>;\n}): RestorePendingDocument => ({\n\tversion: SNAPSHOT_RESTORE_PENDING_VERSION,\n\tsnapshotId: args.meta.id,\n\tartifactDir: args.artifactDir,\n\tapp: args.meta.app,\n\tstack: args.meta.stack,\n\tnetwork: args.meta.network,\n\tcontainers: args.containers,\n});\n\n/** Rewrite an existing marker, replacing the `containers` list.\n *  The recovery scanner uses this to whittle the outstanding entry\n *  list down as it retags each image — the next supervise (or the\n *  next loop iteration after a transient daemon hiccup) sees an\n *  up-to-date marker without re-deriving identity from `meta.json`. */\nexport const rewritePendingMarkerContainers = (\n\tdoc: RestorePendingDocument,\n\tcontainers: ReadonlyArray<RestorePendingContainer>,\n): RestorePendingDocument => ({\n\t...doc,\n\tcontainers,\n});\n\n/** Remove the marker. Idempotent — `force: true` swallows \"already\n *  gone\". Other IO failures surface as `RestorePendingMarkerIoError`. */\nexport const removePendingMarker = (\n\troot: string,\n): Effect.Effect<void, RestorePendingMarkerIoError, FileSystem.FileSystem> =>\n\tEffect.gen(function* () {\n\t\tconst fs = yield* FileSystem.FileSystem;\n\t\tconst path = pendingMarkerPath(root);\n\t\tyield* fs.remove(path, { force: true }).pipe(\n\t\t\tEffect.catch(\n\t\t\t\t(cause): Effect.Effect<never, RestorePendingMarkerIoError> =>\n\t\t\t\t\tEffect.fail(\n\t\t\t\t\t\tnew RestorePendingMarkerIoError({\n\t\t\t\t\t\t\top: 'remove',\n\t\t\t\t\t\t\tpath,\n\t\t\t\t\t\t\tdetail: `remove ${RESTORE_PENDING_FILE_NAME} failed`,\n\t\t\t\t\t\t\tcause,\n\t\t\t\t\t\t}),\n\t\t\t\t\t),\n\t\t\t),\n\t\t);\n\t});\n"],"mappings":";;;AAoCA,MAAa,4BAA4B;AAEzC,MAAa,gCAAgC,OAAO,OAAO;CAC1D,QAAQ,OAAO;CACf,MAAM,OAAO;CACb,iBAAiB,OAAO;CACxB,gBAAgB,OAAO;;;;;;;;CAQvB,QAAQ,OAAO;CACf,CAAC;;;;AAeF,MAAa,iCAAiC,mBAAA,GAE7C;CAbA,YAAY,OAAO;CACnB,aAAa,OAAO;CACpB,KAAK,OAAO;CACZ,OAAO,OAAO;CACd,SAAS,OAAO;CAChB,YAAY,OAAO,MAAM,8BAA8B;CAQvD,CACA;;;;;;;AASD,MAAa,+BAA+B,OAAO,MAAM,CAAC,+BAA+B,CAAC;;;AAK1F,MAAa,qBAAqB,SACjC,GAAG,KAAK,GAAG;;;AAIZ,IAAa,8BAAb,cAAiD,OAAO,kBAA+C,CACtG,uCACA;CACC,IAAI,OAAO,SAAS;EAAC;EAAQ;EAAS;EAAU;EAAS,CAAC;CAC1D,MAAM,OAAO;CACb,QAAQ,OAAO;CACf,OAAO,OAAO,SAAS,OAAO,OAAO;CACrC,CACD,CAAC;;;AAIF,MAAa,sBACZ,MACA,QAEA,OAAO,IAAI,aAAa;CACvB,MAAM,OAAO,kBAAkB,KAAK;AASpC,QAAO,gBAAgB,MADT,IAAI,aAAa,CAAC,OAAO,GAAG,KAAK,UAAU,KAAK,MAAM,EAAE,CAAC,IACrC,CAAC,CAAC,KACnC,OAAO,OACL,UACA,OAAO,KACN,IAAI,4BAA4B;EAC/B,IAAI;EACJ;EACA,QAAQ,SAAS,0BAA0B;EAC3C;EACA,CAAC,CACF,CACF,CACD;EACA;;;AAIH,MAAa,6BAA6B,UAIX;CAC9B,SAAA;CACA,YAAY,KAAK,KAAK;CACtB,aAAa,KAAK;CAClB,KAAK,KAAK,KAAK;CACf,OAAO,KAAK,KAAK;CACjB,SAAS,KAAK,KAAK;CACnB,YAAY,KAAK;CACjB;;;;;;AAOD,MAAa,kCACZ,KACA,gBAC6B;CAC7B,GAAG;CACH;CACA;;;AAID,MAAa,uBACZ,SAEA,OAAO,IAAI,aAAa;CACvB,MAAM,KAAK,OAAO,WAAW;CAC7B,MAAM,OAAO,kBAAkB,KAAK;AACpC,QAAO,GAAG,OAAO,MAAM,EAAE,OAAO,MAAM,CAAC,CAAC,KACvC,OAAO,OACL,UACA,OAAO,KACN,IAAI,4BAA4B;EAC/B,IAAI;EACJ;EACA,QAAQ,UAAU,0BAA0B;EAC5C;EACA,CAAC,CACF,CACF,CACD;EACA"}