@mysten-incubation/devstack 0.0.1 → 0.1.1

package/dist/orchestrators/codegen/service.mjs

@@ -1,32 +1,120 @@
-import { CodegenEmitFailed, CodegenEmitterCollision, CodegenPathConflict } from "./errors.mjs";
+import { acquireStackLock } from "../../substrate/runtime/cross-process/stack-lock.mjs";
+import { mintRandomSuffix } from "../../substrate/runtime/random-suffix.mjs";
+import { StageAndSwapError, stageAndSwap } from "../../substrate/runtime/stage-and-swap/index.mjs";
+import { CodegenEmitFailed, CodegenEmitterCollision, CodegenPathConflict, CodegenWriteFailed } from "./errors.mjs";
 import { emitOne } from "./emit.mjs";
-import { modeFor } from "./permissions.mjs";
-import { emitBindings } from "./bindings.mjs";
+import { dirModeFor, modeFor } from "./permissions.mjs";
+import { MoveCodegenService, MoveSummaryRunnerService, emitBindings } from "./bindings.mjs";
 import { CodegenPathsService } from "./paths.mjs";
 import { renderFile } from "./format.mjs";
 import { writeGitignore } from "./gitignore.mjs";
 import { Context, Effect, Layer, Order, Ref } from "effect";
+import { dirname } from "node:path";
 //#region src/orchestrators/codegen/service.ts
-const runEmitCycle = (input) => Effect.gen(function* () {
+const buildParentModeResolver = (paths, decls) => Effect.gen(function* () {
+	const byParent = /* @__PURE__ */ new Map();
+	for (const decl of decls) {
+		const parent = dirname(yield* paths.resolve(decl.outputPath));
+		const current = byParent.get(parent);
+		if (current === void 0) byParent.set(parent, [decl]);
+		else current.push(decl);
+	}
+	const modes = /* @__PURE__ */ new Map();
+	for (const [parent, parentDecls] of byParent) modes.set(parent, dirModeFor(parentDecls));
+	return (absolutePath) => modes.get(dirname(absolutePath)) ?? 493;
+});
+/**
+* Per-cycle lock acquire timeout. Codegen cycles can be file-system
+* heavy (multi-emitter, Move-bindings compilation), so we allow more
+* than the substrate's default 5s for `stack.lock` — a custom CLI
+* caller that hits a supervisor mid-cycle should wait, not error.
+* Mirrors `MOVE_BUILD_LOCK_TIMEOUT_MS` (5 minutes).
+*/
+const CODEGEN_CYCLE_LOCK_TIMEOUT_MS = 5 * 6e4;
+const runEmitCycle = (input) => Effect.scoped(Effect.gen(function* () {
 	const paths = yield* CodegenPathsService;
-	const fileEmitters = [];
-	for (const decl of input.contributions) fileEmitters.push(decl);
-	yield* validateUniqueness(fileEmitters);
-	yield* validateAggregatePathAvailability(fileEmitters);
+	yield* acquireStackLock(paths.codegenLockFile, CODEGEN_CYCLE_LOCK_TIMEOUT_MS).pipe(Effect.mapError((cause) => new CodegenWriteFailed({
+		outputPath: paths.codegenLockFile,
+		stage: "write",
+		cause
+	})));
+	return yield* runEmitCycleLocked(input);
+}));
+const runEmitCycleLocked = (input) => Effect.gen(function* () {
+	const paths = yield* CodegenPathsService;
+	const moveRunner = yield* MoveSummaryRunnerService;
+	const moveCodegen = yield* MoveCodegenService;
+	yield* validateUniqueness(input.contributions);
+	yield* validateAggregatePathAvailability(input.contributions);
+	const cycleId = mintRandomSuffix(16);
+	const stagingPaths = paths.withRoot(`${paths.outputDir}.staging.${cycleId}`);
+	return yield* stageAndSwap({
+		targetPath: paths.outputDir,
+		idSuffix: cycleId,
+		preserveOnPreseed: true,
+		build: Effect.gen(function* () {
+			return rewriteResultPaths(yield* runEmitCycleInner(input, stagingPaths).pipe(Effect.provideService(MoveSummaryRunnerService, moveRunner), Effect.provideService(MoveCodegenService, moveCodegen)), stagingPaths.outputDir, paths.outputDir);
+		})
+	}).pipe(Effect.mapError((e) => {
+		if (e instanceof StageAndSwapError) return new CodegenWriteFailed({
+			outputPath: paths.outputDir,
+			stage: "rename",
+			cause: e
+		});
+		return e;
+	}), Effect.withSpan("codegen.runEmitCycle", { attributes: {
+		"codegen.contributions": input.contributions.length,
+		"codegen.cycleId": cycleId,
+		"codegen.stagingDir": stagingPaths.outputDir
+	} }));
+});
+/**
+* Project a staging-rooted `RunEmitCycleResult` back into the user-
+* visible `outputDir` namespace. The build effect writes through
+* `stagingDir` paths; callers (and tests) expect to see the final
+* post-rename locations.
+*/
+const rewriteResultPaths = (result, stagingDir, outputDir) => {
+	const stripped = stagingDir.replace(/\/+$/, "");
+	const target = outputDir.replace(/\/+$/, "");
+	const rewrite = (p) => p.startsWith(stripped) ? `${target}${p.slice(stripped.length)}` : p;
+	return {
+		filesWritten: result.filesWritten.map(rewrite),
+		filesUnchanged: result.filesUnchanged.map(rewrite),
+		filesChmod: result.filesChmod.map(rewrite),
+		bindings: result.bindings === null ? null : {
+			...result.bindings,
+			filesWritten: result.bindings.filesWritten.map(rewrite)
+		}
+	};
+};
+/**
+* The body of one emit cycle. Pulled out of `runEmitCycle` so the
+* stage-and-swap wrapper can drive it against a redirected
+* `CodegenPathsService` (the staging tree). Validation runs BEFORE
+* this function so callers know the contribution set is well-formed.
+*/
+const runEmitCycleInner = (input, paths) => Effect.gen(function* () {
+	const fileEmitters = [...input.contributions];
 	const filesWritten = [];
 	const filesUnchanged = [];
 	const filesChmod = [];
-	const aggregates = emptyAggregateBuckets();
+	const aggregates = /* @__PURE__ */ new Map();
 	const packageContribs = [];
 	const sortedDecls = [...fileEmitters].sort(Order.mapInput(Order.String, (d) => d.outputPath));
+	const parentModeFor = yield* buildParentModeResolver(paths, fileEmitters);
 	for (const decl of sortedDecls) {
 		const emission = yield* runEmitter(decl);
 		const exported = emission.exports;
-		collectAggregateExport(aggregates, decl, exported);
-		if (decl.emitterName === "package") {
-			const bindings = exported["packageBindings"];
-			if (isPackageBindings(bindings)) packageContribs.push(bindings);
+		if (decl.aggregate !== void 0) {
+			const projected = decl.aggregate.project(exported);
+			if (projected !== null) {
+				const bucket = aggregates.get(decl.aggregate.bucket) ?? {};
+				Object.assign(bucket, projected);
+				aggregates.set(decl.aggregate.bucket, bucket);
+			}
 		}
+		for (const value of Object.values(exported)) if (isPackageBindings(value)) packageContribs.push(value);
 		const rendered = renderFile({
 			emitterName: decl.emitterName,
 			outputPath: decl.outputPath,
@@ -34,12 +122,13 @@ const runEmitCycle = (input) => Effect.gen(function* () {
 			exports: exported,
 			imports: emission.imports
 		});
-		if (rendered instanceof Error) return yield* Effect.fail(rendered);
-		const abs = paths.resolve(decl.outputPath);
+		if (!rendered.ok) return yield* Effect.fail(rendered.error);
+		const abs = yield* paths.resolve(decl.outputPath);
 		switch ((yield* emitOne({
 			path: abs,
-			content: rendered,
-			mode: modeFor(decl)
+			content: rendered.text,
+			mode: modeFor(decl),
+			parentMode: parentModeFor(abs)
 		})).outcome) {
 			case "wrote":
 				filesWritten.push(abs);
@@ -59,12 +148,13 @@ const runEmitCycle = (input) => Effect.gen(function* () {
 			sensitive: false,
 			exports: aggregate.exports
 		});
-		if (rendered instanceof Error) return yield* Effect.fail(rendered);
-		const abs = paths.resolve(aggregate.outputPath);
+		if (!rendered.ok) return yield* Effect.fail(rendered.error);
+		const abs = yield* paths.resolve(aggregate.outputPath);
 		switch ((yield* emitOne({
 			path: abs,
-			content: rendered,
-			mode: 420
+			content: rendered.text,
+			mode: 420,
+			parentMode: parentModeFor(abs)
 		})).outcome) {
 			case "wrote":
 				filesWritten.push(abs);
@@ -87,7 +177,8 @@ const runEmitCycle = (input) => Effect.gen(function* () {
 	const sensitivePaths = fileEmitters.filter((d) => d.sensitive === true).map((d) => d.outputPath);
 	yield* writeGitignore({
 		path: paths.gitignoreFile,
-		sensitivePaths
+		sensitivePaths,
+		parentMode: parentModeFor(paths.gitignoreFile)
 	});
 	return {
 		filesWritten,
@@ -95,7 +186,7 @@ const runEmitCycle = (input) => Effect.gen(function* () {
 		filesChmod,
 		bindings
 	};
-}).pipe(Effect.withSpan("codegen.runEmitCycle", { attributes: { "codegen.contributions": input.contributions.length } }));
+});
 const runEmitter = (decl) => Effect.gen(function* () {
 	const exports = {};
 	const imports = [];
@@ -119,10 +210,11 @@ const runEmitter = (decl) => Effect.gen(function* () {
 	};
 });
 /**
-* Uniqueness check: emitter name (literal) must be unique EXCEPT
-* for the `package` emitter, which legitimately appears once per
-* Package contribution. Output paths must be unique across ALL
-* emitters (including each `package`-emitted pointer file).
+* Uniqueness check: emitter name (literal) must be unique unless
+* the decl opts into repetition via `allowEmitterNameRepetition`
+* (used by per-item plugins like Package, which emit one decl per
+* published package under a shared emitter name). Output paths
+* must be unique across ALL emitters.
 */
 const validateUniqueness = (decls) => Effect.gen(function* () {
 	const byPath = /* @__PURE__ */ new Map();
@@ -131,12 +223,13 @@ const validateUniqueness = (decls) => Effect.gen(function* () {
 		const ps = byPath.get(d.outputPath) ?? [];
 		ps.push(d.emitterName);
 		byPath.set(d.outputPath, ps);
-		if (d.emitterName === "package") continue;
+		if (d.allowEmitterNameRepetition === true) continue;
 		const ns = byName.get(d.emitterName) ?? [];
 		ns.push(d.outputPath);
 		byName.set(d.emitterName, ns);
 	}
 	for (const [path, emitters] of byPath) if (emitters.length > 1) return yield* Effect.fail(new CodegenPathConflict({
+		kind: "duplicate",
 		outputPath: path,
 		emitters
 	}));
@@ -145,98 +238,57 @@ const validateUniqueness = (decls) => Effect.gen(function* () {
 		outputPaths
 	}));
 });
-const AGGREGATE_OUTPUTS = {
-	accounts: "accounts.ts",
-	coins: "coins.ts",
-	packages: "packages.ts",
-	services: "services.ts"
-};
-const aggregatePathFor = (decl) => {
-	if (decl.emitterName.startsWith("account/")) return AGGREGATE_OUTPUTS.accounts;
-	if (decl.emitterName.startsWith("coin/")) return AGGREGATE_OUTPUTS.coins;
-	if (decl.emitterName === "package") return AGGREGATE_OUTPUTS.packages;
-	if (decl.emitterName === "sui-network") return AGGREGATE_OUTPUTS.services;
-	return null;
-};
+/**
+* Reject contribution sets that would have an aggregate bucket
+* collide with a per-decl `outputPath`. The orchestrator only knows
+* bucket names because plugins declared them via `aggregate.bucket`;
+* it does not enumerate or recognize plugin identities here.
+*/
 const validateAggregatePathAvailability = (decls) => Effect.gen(function* () {
 	const aggregatePaths = /* @__PURE__ */ new Set();
-	for (const decl of decls) {
-		const path = aggregatePathFor(decl);
-		if (path !== null) aggregatePaths.add(path);
-	}
+	for (const decl of decls) if (decl.aggregate !== void 0) aggregatePaths.add(decl.aggregate.bucket);
 	for (const path of aggregatePaths) {
 		const colliding = decls.filter((decl) => decl.outputPath === path);
 		if (colliding.length > 0) return yield* Effect.fail(new CodegenPathConflict({
+			kind: "duplicate",
 			outputPath: path,
 			emitters: [...colliding.map((decl) => decl.emitterName), `aggregate/${path}`]
 		}));
 	}
 });
-const emptyAggregateBuckets = () => ({
-	accounts: {},
-	coins: {},
-	packages: {},
-	services: {}
-});
-const collectAggregateExport = (buckets, decl, exported) => {
-	if (decl.emitterName.startsWith("account/")) {
-		Object.assign(buckets.accounts, exported);
-		return;
-	}
-	if (decl.emitterName.startsWith("coin/")) {
-		Object.assign(buckets.coins, exported);
-		return;
-	}
-	if (decl.emitterName === "package") {
-		const bindings = exported["packageBindings"];
-		if (isPackageBindings(bindings)) buckets.packages[bindings.name] = bindings;
-		return;
-	}
-	if (decl.emitterName === "sui-network") {
-		const network = exported["suiNetwork"];
-		if (isRecord(network)) {
-			const rpcUrl = stringField(network, "rpcUrl");
-			const faucetUrl = stringField(network, "faucetUrl");
-			const graphqlUrl = stringField(network, "graphqlUrl");
-			buckets.services["sui"] = {
-				rpc: { url: rpcUrl ?? "" },
-				faucet: faucetUrl === null ? null : { url: faucetUrl },
-				graphql: graphqlUrl === null ? null : { url: graphqlUrl }
-			};
-		}
-	}
-};
+/**
+* Synthesize one `AggregateFile` per non-empty bucket. The exports
+* map is keyed by the bucket's stem (e.g. `accounts.ts` → `accounts`)
+* so the rendered file exports `export const <stem> = { ... }`. The
+* orchestrator picks the export key from the bucket filename; the
+* stem itself is not a plugin identifier — it is the filename
+* without the `.ts` extension, derived mechanically.
+*/
 const buildAggregateFiles = (buckets) => {
 	const files = [];
-	if (Object.keys(buckets.accounts).length > 0) files.push({
-		emitterName: "aggregate/accounts",
-		outputPath: AGGREGATE_OUTPUTS.accounts,
-		exports: { accounts: buckets.accounts }
-	});
-	if (Object.keys(buckets.coins).length > 0) files.push({
-		emitterName: "aggregate/coins",
-		outputPath: AGGREGATE_OUTPUTS.coins,
-		exports: { coins: buckets.coins }
-	});
-	if (Object.keys(buckets.packages).length > 0) files.push({
-		emitterName: "aggregate/packages",
-		outputPath: AGGREGATE_OUTPUTS.packages,
-		exports: { packages: buckets.packages }
-	});
-	if (Object.keys(buckets.services).length > 0) files.push({
-		emitterName: "aggregate/services",
-		outputPath: AGGREGATE_OUTPUTS.services,
-		exports: { services: buckets.services }
-	});
+	const sortedEntries = [...buckets.entries()].sort(([a], [b]) => a.localeCompare(b));
+	for (const [bucket, contents] of sortedEntries) {
+		if (Object.keys(contents).length === 0) continue;
+		const stem = bucketStem(bucket);
+		files.push({
+			emitterName: `aggregate/${stem}`,
+			outputPath: bucket,
+			exports: { [stem]: contents }
+		});
+	}
 	return files;
 };
+const bucketStem = (bucket) => bucket.replace(/\.ts$/, "").replace(/^.*\//, "");
+/**
+* Consumer-side shape guard: does this aggregated value look like a
+* Move-bindings contribution that `emitBindings` knows how to
+* consume? This is structural validation of the orchestrator's own
+* input contract, NOT a plugin-name match. Any plugin whose
+* `aggregate.project` returns objects with this shape will be
+* forwarded to the Move bindings emitter.
+*/
 const isPackageBindings = (v) => typeof v === "object" && v !== null && "name" in v && "packageId" in v && "mvrPlaceholder" in v && "sourcePath" in v;
-const isRecord = (v) => typeof v === "object" && v !== null;
-const stringField = (record, key) => {
-	const value = record[key];
-	return typeof value === "string" && value.length > 0 ? value : null;
-};
-var CodegenOrchestratorService = class extends Context.Service()("@devstack-rewrite/orchestrators/Codegen") {};
+var CodegenOrchestratorService = class extends Context.Service()("@devstack/orchestrators/Codegen") {};
 /** Layer-wired codegen orchestrator. No upstream requirements at boot
 *  time — the per-cycle effect carries the `FileSystem` + Move-codegen
 *  service requirements through to the caller. */

package/dist/orchestrators/codegen/service.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"service.mjs","names":[],"sources":["../../../src/orchestrators/codegen/service.ts"],"sourcesContent":["// Codegen orchestrator — main service.\n//\n// Architecture §6 (Codegenable):\n//   \"Codegen is a surface (L4) that walks the plugin-emitted\n//    `Codegenable` capability decls.\"\n//\n// Hard boundary (distilled-doc §\"Hard boundary\"):\n//   \"Apps consume codegen output, NOT devstack.\" Every runtime value\n//   the app needs flows through codegen-emitted TS files. The\n//   orchestrator owns the only legitimate channel from stack state\n//   to app code.\n//\n// Lifecycle (distilled-doc §\"Lifecycle states\"):\n//   - at-up:       per supervisor cycle, run all emitters serially,\n//                  with per-file atomic/idempotent writes.\n//   - on-change:   re-run as part of the new cycle when the\n//                  supervisor restarts.\n//   - on-demand:   same emit pipeline for snapshot resume.\n//   - idempotency: per-file no-touch on unchanged content.\n//\n// Pipeline (one cycle):\n//   1. Collect `Codegenable` contributions from the active stack\n//      members (the supervisor walks `member.capabilities`).\n//   2. Validate uniqueness: emitter name (literal) is globally\n//      unique; output path is globally unique.\n//   3. Run each emitter serially (distilled-doc § \"Serial within a\n//      cycle\"). Each emit writes exports through a per-file context.\n//   4. Render each collected file emission to a TS source string.\n//   5. Emit each file with an atomic write + per-file no-touch\n//      idempotency.\n//   6. Run the Move-bindings emitter against the collected\n//      `package`-emitted contributions.\n//   7. Write the `.gitignore`.\n//\n// What this module does NOT do:\n//   - Construct plugin-level resolved blobs (plugins pass them at\n//     factory-build time).\n//   - Decode the manifest envelope (see `manifest-bridge.ts`).\n//   - Watch files (see `watcher.ts`).\n//   - Walk the user's Move-source mtimes (see `bindings.ts`).\n\nimport { Context, Effect, FileSystem, Layer, Order, Ref, Scope } from 'effect';\n\nimport type {\n\tCodegenableDecl,\n\tCodegenEmitDone,\n\tCodegenEmitContext,\n} from '../../contracts/codegenable.ts';\n\nimport {\n\temitBindings,\n\ttype EmitBindingsResult,\n\tMoveCodegenService,\n\tMoveSummaryRunnerService,\n\ttype PackageBindings,\n} from './bindings.ts';\nimport { emitOne } from './emit.ts';\nimport {\n\tCodegenEmitFailed,\n\tCodegenEmitterCollision,\n\tCodegenPathConflict,\n\ttype CodegenError,\n} from './errors.ts';\nimport { renderFile } from './format.ts';\nimport { writeGitignore } from './gitignore.ts';\nimport { CodegenPathsService } from './paths.ts';\nimport { modeFor } from './permissions.ts';\n\n// -----------------------------------------------------------------------------\n// Public types\n// -----------------------------------------------------------------------------\n\n/** A type alias the orchestrator uses internally to avoid restating\n *  the wide-erased `CodegenableDecl` generic in every signature. */\nexport type Codegenable = CodegenableDecl<string>;\n\nexport interface RunEmitCycleInput {\n\t/** All Codegenable contributions, as collected from the active\n\t *  stack members' `capabilities` tuples. The orchestrator does\n\t *  not look at plugins — only at the decl set. */\n\treadonly contributions: ReadonlyArray<Codegenable>;\n\t/** Optional: import-extension for bindings emission. Default `.ts`. */\n\treadonly bindingsImportExtension?: '.ts' | '.js' | '';\n}\n\nexport interface RunEmitCycleResult {\n\treadonly filesWritten: ReadonlyArray<string>;\n\treadonly filesUnchanged: ReadonlyArray<string>;\n\treadonly filesChmod: ReadonlyArray<string>;\n\treadonly bindings: EmitBindingsResult | null;\n}\n\n// -----------------------------------------------------------------------------\n// Main entry — one cycle of the codegen pipeline\n// -----------------------------------------------------------------------------\n\nexport const runEmitCycle = (\n\tinput: RunEmitCycleInput,\n): Effect.Effect<\n\tRunEmitCycleResult,\n\tCodegenError,\n\tFileSystem.FileSystem | CodegenPathsService | MoveSummaryRunnerService | MoveCodegenService\n> =>\n\tEffect.gen(function* () {\n\t\tconst paths = yield* CodegenPathsService;\n\n\t\t// 1. All contributions go through the generic file emit path.\n\t\t//    Package outputs are collected for the bindings emitter\n\t\t//    from the same single evaluated result used to render the\n\t\t//    package pointer file.\n\t\tconst fileEmitters: Array<Codegenable> = [];\n\t\tfor (const decl of input.contributions) {\n\t\t\tfileEmitters.push(decl);\n\t\t}\n\n\t\t// 2. Validate uniqueness — both `emitterName` and `outputPath`.\n\t\t//    Detected BEFORE write so the user-visible tree is\n\t\t//    never half-written. `package` is the one exception:\n\t\t//    multiple instances (one per Package) share the same\n\t\t//    `emitterName` literal by design.\n\t\tyield* validateUniqueness(fileEmitters);\n\t\tyield* validateAggregatePathAvailability(fileEmitters);\n\n\t\t// 3-5. Run + render + emit each non-bindings contribution.\n\t\tconst filesWritten: Array<string> = [];\n\t\tconst filesUnchanged: Array<string> = [];\n\t\tconst filesChmod: Array<string> = [];\n\t\tconst aggregates = emptyAggregateBuckets();\n\t\tconst packageContribs: Array<PackageBindings> = [];\n\t\tconst sortedDecls = [...fileEmitters].sort(\n\t\t\tOrder.mapInput(Order.String, (d: Codegenable) => d.outputPath),\n\t\t);\n\t\tfor (const decl of sortedDecls) {\n\t\t\tconst emission = yield* runEmitter(decl);\n\t\t\tconst exported = emission.exports;\n\t\t\tcollectAggregateExport(aggregates, decl, exported);\n\t\t\tif (decl.emitterName === 'package') {\n\t\t\t\tconst bindings = exported['packageBindings'];\n\t\t\t\tif (isPackageBindings(bindings)) {\n\t\t\t\t\tpackageContribs.push(bindings);\n\t\t\t\t}\n\t\t\t}\n\t\t\tconst rendered = renderFile({\n\t\t\t\temitterName: decl.emitterName,\n\t\t\t\toutputPath: decl.outputPath,\n\t\t\t\tsensitive: decl.sensitive === true,\n\t\t\t\texports: exported,\n\t\t\t\timports: emission.imports,\n\t\t\t});\n\t\t\tif (rendered instanceof Error) {\n\t\t\t\t// `renderFile` returns either a string or a\n\t\t\t\t// `CodegenRenderError` (extends Error). Yield the\n\t\t\t\t// tagged form.\n\t\t\t\treturn yield* Effect.fail(rendered as CodegenError);\n\t\t\t}\n\t\t\tconst abs = paths.resolve(decl.outputPath);\n\t\t\tconst outcome = yield* emitOne({\n\t\t\t\tpath: abs,\n\t\t\t\tcontent: rendered,\n\t\t\t\tmode: modeFor(decl),\n\t\t\t});\n\t\t\tswitch (outcome.outcome) {\n\t\t\t\tcase 'wrote':\n\t\t\t\t\tfilesWritten.push(abs);\n\t\t\t\t\tbreak;\n\t\t\t\tcase 'unchanged':\n\t\t\t\t\tfilesUnchanged.push(abs);\n\t\t\t\t\tbreak;\n\t\t\t\tcase 'chmod-only':\n\t\t\t\t\tfilesChmod.push(abs);\n\t\t\t\t\tbreak;\n\t\t\t}\n\t\t}\n\n\t\tfor (const aggregate of buildAggregateFiles(aggregates)) {\n\t\t\tconst rendered = renderFile({\n\t\t\t\temitterName: aggregate.emitterName,\n\t\t\t\toutputPath: aggregate.outputPath,\n\t\t\t\tsensitive: false,\n\t\t\t\texports: aggregate.exports,\n\t\t\t});\n\t\t\tif (rendered instanceof Error) {\n\t\t\t\treturn yield* Effect.fail(rendered as CodegenError);\n\t\t\t}\n\t\t\tconst abs = paths.resolve(aggregate.outputPath);\n\t\t\tconst outcome = yield* emitOne({\n\t\t\t\tpath: abs,\n\t\t\t\tcontent: rendered,\n\t\t\t\tmode: 0o644,\n\t\t\t});\n\t\t\tswitch (outcome.outcome) {\n\t\t\t\tcase 'wrote':\n\t\t\t\t\tfilesWritten.push(abs);\n\t\t\t\t\tbreak;\n\t\t\t\tcase 'unchanged':\n\t\t\t\t\tfilesUnchanged.push(abs);\n\t\t\t\t\tbreak;\n\t\t\t\tcase 'chmod-only':\n\t\t\t\t\tfilesChmod.push(abs);\n\t\t\t\t\tbreak;\n\t\t\t}\n\t\t}\n\n\t\t// 6. Bindings emitter. Skipped when there are no local\n\t\t//    packages (distilled-doc § \"Skip-emit is explicit and\n\t\t//    logged\").\n\t\tlet bindings: EmitBindingsResult | null = null;\n\t\tif (packageContribs.length > 0) {\n\t\t\tbindings = yield* emitBindings({\n\t\t\t\tbindingsDir: paths.bindingsDir,\n\t\t\t\tpackages: packageContribs,\n\t\t\t\timportExtension: input.bindingsImportExtension,\n\t\t\t});\n\t\t} else {\n\t\t\tyield* Effect.logInfo(\n\t\t\t\t'codegen: no package contributions; skipping Move-to-TS bindings step.',\n\t\t\t);\n\t\t}\n\n\t\t// 7. Gitignore. Sensitive paths get an explicit mention.\n\t\tconst sensitivePaths = fileEmitters\n\t\t\t.filter((d) => d.sensitive === true)\n\t\t\t.map((d) => d.outputPath);\n\t\tyield* writeGitignore({\n\t\t\tpath: paths.gitignoreFile,\n\t\t\tsensitivePaths,\n\t\t});\n\n\t\treturn {\n\t\t\tfilesWritten,\n\t\t\tfilesUnchanged,\n\t\t\tfilesChmod,\n\t\t\tbindings,\n\t\t};\n\t}).pipe(\n\t\tEffect.withSpan('codegen.runEmitCycle', {\n\t\t\tattributes: {\n\t\t\t\t'codegen.contributions': input.contributions.length,\n\t\t\t},\n\t\t}),\n\t);\n\n// -----------------------------------------------------------------------------\n// Internals\n// -----------------------------------------------------------------------------\n\ninterface CodegenEmission {\n\treadonly exports: { readonly [key: string]: unknown };\n\treadonly imports: ReadonlyArray<string>;\n}\n\nconst runEmitter = (decl: Codegenable): Effect.Effect<CodegenEmission, CodegenEmitFailed> =>\n\tEffect.gen(function* () {\n\t\tconst exports: Record<string, unknown> = {};\n\t\tconst imports: Array<string> = [];\n\t\tconst done: CodegenEmitDone = { _tag: 'CodegenEmitDone' };\n\t\tconst ctx: CodegenEmitContext = {\n\t\t\texportConst: (name, value) => {\n\t\t\t\texports[name] = value;\n\t\t\t},\n\t\t\timportStatement: (statement) => {\n\t\t\t\timports.push(statement);\n\t\t\t},\n\t\t\tdone: () => done,\n\t\t};\n\t\tyield* decl.emit(ctx).pipe(\n\t\t\tEffect.mapError(\n\t\t\t\t(cause) =>\n\t\t\t\t\tnew CodegenEmitFailed({\n\t\t\t\t\t\temitterName: decl.emitterName,\n\t\t\t\t\t\toutputPath: decl.outputPath,\n\t\t\t\t\t\tcause,\n\t\t\t\t\t}),\n\t\t\t),\n\t\t);\n\t\treturn { exports, imports };\n\t});\n\n/**\n * Uniqueness check: emitter name (literal) must be unique EXCEPT\n * for the `package` emitter, which legitimately appears once per\n * Package contribution. Output paths must be unique across ALL\n * emitters (including each `package`-emitted pointer file).\n */\nconst validateUniqueness = (\n\tdecls: ReadonlyArray<Codegenable>,\n): Effect.Effect<void, CodegenPathConflict | CodegenEmitterCollision> =>\n\tEffect.gen(function* () {\n\t\tconst byPath = new Map<string, Array<string>>();\n\t\tconst byName = new Map<string, Array<string>>();\n\t\tfor (const d of decls) {\n\t\t\tconst ps = byPath.get(d.outputPath) ?? [];\n\t\t\tps.push(d.emitterName);\n\t\t\tbyPath.set(d.outputPath, ps);\n\t\t\t// `package` is allowed to repeat — it's per-Package by design.\n\t\t\tif (d.emitterName === 'package') continue;\n\t\t\tconst ns = byName.get(d.emitterName) ?? [];\n\t\t\tns.push(d.outputPath);\n\t\t\tbyName.set(d.emitterName, ns);\n\t\t}\n\t\tfor (const [path, emitters] of byPath) {\n\t\t\tif (emitters.length > 1) {\n\t\t\t\treturn yield* Effect.fail(\n\t\t\t\t\tnew CodegenPathConflict({\n\t\t\t\t\t\toutputPath: path,\n\t\t\t\t\t\temitters,\n\t\t\t\t\t}),\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\t\tfor (const [name, outputPaths] of byName) {\n\t\t\tif (outputPaths.length > 1) {\n\t\t\t\treturn yield* Effect.fail(\n\t\t\t\t\tnew CodegenEmitterCollision({\n\t\t\t\t\t\temitterName: name,\n\t\t\t\t\t\toutputPaths,\n\t\t\t\t\t}),\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\t});\n\nconst AGGREGATE_OUTPUTS = {\n\taccounts: 'accounts.ts',\n\tcoins: 'coins.ts',\n\tpackages: 'packages.ts',\n\tservices: 'services.ts',\n} as const;\n\nconst aggregatePathFor = (decl: Codegenable): string | null => {\n\tif (decl.emitterName.startsWith('account/')) return AGGREGATE_OUTPUTS.accounts;\n\tif (decl.emitterName.startsWith('coin/')) return AGGREGATE_OUTPUTS.coins;\n\tif (decl.emitterName === 'package') return AGGREGATE_OUTPUTS.packages;\n\tif (decl.emitterName === 'sui-network') return AGGREGATE_OUTPUTS.services;\n\treturn null;\n};\n\nconst validateAggregatePathAvailability = (\n\tdecls: ReadonlyArray<Codegenable>,\n): Effect.Effect<void, CodegenPathConflict> =>\n\tEffect.gen(function* () {\n\t\tconst aggregatePaths = new Set<string>();\n\t\tfor (const decl of decls) {\n\t\t\tconst path = aggregatePathFor(decl);\n\t\t\tif (path !== null) aggregatePaths.add(path);\n\t\t}\n\t\tfor (const path of aggregatePaths) {\n\t\t\tconst colliding = decls.filter((decl) => decl.outputPath === path);\n\t\t\tif (colliding.length > 0) {\n\t\t\t\treturn yield* Effect.fail(\n\t\t\t\t\tnew CodegenPathConflict({\n\t\t\t\t\t\toutputPath: path,\n\t\t\t\t\t\temitters: [...colliding.map((decl) => decl.emitterName), `aggregate/${path}`],\n\t\t\t\t\t}),\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\t});\n\ninterface AggregateBuckets {\n\treadonly accounts: Record<string, unknown>;\n\treadonly coins: Record<string, unknown>;\n\treadonly packages: Record<string, unknown>;\n\treadonly services: Record<string, unknown>;\n}\n\nconst emptyAggregateBuckets = (): AggregateBuckets => ({\n\taccounts: {},\n\tcoins: {},\n\tpackages: {},\n\tservices: {},\n});\n\nconst collectAggregateExport = (\n\tbuckets: AggregateBuckets,\n\tdecl: Codegenable,\n\texported: { readonly [key: string]: unknown },\n): void => {\n\tif (decl.emitterName.startsWith('account/')) {\n\t\tObject.assign(buckets.accounts, exported);\n\t\treturn;\n\t}\n\tif (decl.emitterName.startsWith('coin/')) {\n\t\tObject.assign(buckets.coins, exported);\n\t\treturn;\n\t}\n\tif (decl.emitterName === 'package') {\n\t\tconst bindings = exported['packageBindings'];\n\t\tif (isPackageBindings(bindings)) {\n\t\t\tbuckets.packages[bindings.name] = bindings;\n\t\t}\n\t\treturn;\n\t}\n\tif (decl.emitterName === 'sui-network') {\n\t\tconst network = exported['suiNetwork'];\n\t\tif (isRecord(network)) {\n\t\t\tconst rpcUrl = stringField(network, 'rpcUrl');\n\t\t\tconst faucetUrl = stringField(network, 'faucetUrl');\n\t\t\tconst graphqlUrl = stringField(network, 'graphqlUrl');\n\t\t\tbuckets.services['sui'] = {\n\t\t\t\trpc: { url: rpcUrl ?? '' },\n\t\t\t\tfaucet: faucetUrl === null ? null : { url: faucetUrl },\n\t\t\t\tgraphql: graphqlUrl === null ? null : { url: graphqlUrl },\n\t\t\t};\n\t\t}\n\t}\n};\n\ninterface AggregateFile {\n\treadonly emitterName: string;\n\treadonly outputPath: string;\n\treadonly exports: { readonly [key: string]: unknown };\n}\n\nconst buildAggregateFiles = (buckets: AggregateBuckets): ReadonlyArray<AggregateFile> => {\n\tconst files: Array<AggregateFile> = [];\n\tif (Object.keys(buckets.accounts).length > 0) {\n\t\tfiles.push({\n\t\t\temitterName: 'aggregate/accounts',\n\t\t\toutputPath: AGGREGATE_OUTPUTS.accounts,\n\t\t\texports: { accounts: buckets.accounts },\n\t\t});\n\t}\n\tif (Object.keys(buckets.coins).length > 0) {\n\t\tfiles.push({\n\t\t\temitterName: 'aggregate/coins',\n\t\t\toutputPath: AGGREGATE_OUTPUTS.coins,\n\t\t\texports: { coins: buckets.coins },\n\t\t});\n\t}\n\tif (Object.keys(buckets.packages).length > 0) {\n\t\tfiles.push({\n\t\t\temitterName: 'aggregate/packages',\n\t\t\toutputPath: AGGREGATE_OUTPUTS.packages,\n\t\t\texports: { packages: buckets.packages },\n\t\t});\n\t}\n\tif (Object.keys(buckets.services).length > 0) {\n\t\tfiles.push({\n\t\t\temitterName: 'aggregate/services',\n\t\t\toutputPath: AGGREGATE_OUTPUTS.services,\n\t\t\texports: { services: buckets.services },\n\t\t});\n\t}\n\treturn files;\n};\n\nconst isPackageBindings = (v: unknown): v is PackageBindings =>\n\ttypeof v === 'object' &&\n\tv !== null &&\n\t'name' in v &&\n\t'packageId' in v &&\n\t'mvrPlaceholder' in v &&\n\t'sourcePath' in v;\n\nconst isRecord = (v: unknown): v is Readonly<Record<string, unknown>> =>\n\ttypeof v === 'object' && v !== null;\n\nconst stringField = (record: Readonly<Record<string, unknown>>, key: string): string | null => {\n\tconst value = record[key];\n\treturn typeof value === 'string' && value.length > 0 ? value : null;\n};\n\n// -----------------------------------------------------------------------------\n// Service surface — registration API + emit-cycle trigger\n// -----------------------------------------------------------------------------\n\n/**\n * The codegen orchestrator's Context-bound service. The substrate's\n * supervisor calls `registerContribution(pluginKey, decl)` once per\n * `CodegenableDecl` on each plugin's `capabilities` tuple, scope-bound\n * to that plugin's acquire scope. `runCycle()` walks the registered\n * set and runs one full emit pipeline.\n */\nexport interface CodegenOrchestrator {\n\t/** Register a `CodegenableDecl` from a plugin. Scope-bound — when\n\t *  the caller's scope (the plugin's acquire scope) closes, the\n\t *  registration is reaped. */\n\treadonly registerContribution: (\n\t\tpluginKey: string,\n\t\tdecl: Codegenable,\n\t) => Effect.Effect<void, never, Scope.Scope>;\n\n\t/** Run one emit cycle against the currently-registered set.\n\t *  `extraContributions` are merged into the active set (callers\n\t *  that have a one-off decl not tied to a plugin scope).\n\t *  `bindingsImportExtension` mirrors `runEmitCycle`. */\n\treadonly runCycle: (args?: {\n\t\treadonly extraContributions?: ReadonlyArray<Codegenable>;\n\t\treadonly bindingsImportExtension?: '.ts' | '.js' | '';\n\t}) => Effect.Effect<\n\t\tRunEmitCycleResult,\n\t\tCodegenError,\n\t\tFileSystem.FileSystem | CodegenPathsService | MoveSummaryRunnerService | MoveCodegenService\n\t>;\n}\n\nexport class CodegenOrchestratorService extends Context.Service<\n\tCodegenOrchestratorService,\n\tCodegenOrchestrator\n>()('@devstack-rewrite/orchestrators/Codegen') {}\n\ninterface RegisteredCodegenEntry {\n\treadonly pluginKey: string;\n\treadonly decl: Codegenable;\n\treadonly seq: number;\n}\n\n/** Layer-wired codegen orchestrator. No upstream requirements at boot\n *  time — the per-cycle effect carries the `FileSystem` + Move-codegen\n *  service requirements through to the caller. */\nexport const layerCodegenOrchestrator: Layer.Layer<CodegenOrchestratorService> = Layer.effect(\n\tCodegenOrchestratorService,\n\tEffect.gen(function* () {\n\t\tconst contributionsRef = yield* Ref.make<ReadonlyArray<RegisteredCodegenEntry>>([]);\n\t\tconst seqRef = yield* Ref.make(0);\n\n\t\tconst registerContribution: CodegenOrchestrator['registerContribution'] = (pluginKey, decl) =>\n\t\t\tEffect.gen(function* () {\n\t\t\t\tconst seq = yield* Ref.updateAndGet(seqRef, (n) => n + 1);\n\t\t\t\tconst entry: RegisteredCodegenEntry = { pluginKey, decl, seq };\n\t\t\t\tyield* Ref.update(contributionsRef, (xs) => [...xs, entry]);\n\t\t\t\tyield* Effect.addFinalizer(() =>\n\t\t\t\t\tRef.update(contributionsRef, (xs) => xs.filter((e) => e.seq !== seq)),\n\t\t\t\t);\n\t\t\t\tyield* Effect.annotateCurrentSpan({\n\t\t\t\t\t'codegen.contribution.plugin': pluginKey,\n\t\t\t\t\t'codegen.contribution.emitter': decl.emitterName,\n\t\t\t\t\t'codegen.contribution.outputPath': decl.outputPath,\n\t\t\t\t});\n\t\t\t}).pipe(Effect.withSpan('orchestrator.codegen.registerContribution')) as Effect.Effect<\n\t\t\t\tvoid,\n\t\t\t\tnever,\n\t\t\t\tScope.Scope\n\t\t\t>;\n\n\t\tconst runCycle: CodegenOrchestrator['runCycle'] = (args) =>\n\t\t\tEffect.gen(function* () {\n\t\t\t\tconst registered = (yield* Ref.get(contributionsRef)).map((e) => e.decl);\n\t\t\t\tconst merged: ReadonlyArray<Codegenable> = args?.extraContributions\n\t\t\t\t\t? [...registered, ...args.extraContributions]\n\t\t\t\t\t: registered;\n\t\t\t\treturn yield* runEmitCycle({\n\t\t\t\t\tcontributions: merged,\n\t\t\t\t\tbindingsImportExtension: args?.bindingsImportExtension,\n\t\t\t\t});\n\t\t\t}).pipe(Effect.withSpan('orchestrator.codegen.runCycle'));\n\n\t\treturn CodegenOrchestratorService.of({\n\t\t\tregisterContribution,\n\t\t\trunCycle,\n\t\t});\n\t}),\n);\n"],"mappings":"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"}
+{"version":3,"file":"service.mjs","names":[],"sources":["../../../src/orchestrators/codegen/service.ts"],"sourcesContent":["// Codegen orchestrator — main service.\n//\n// Architecture §6 (Codegenable):\n//   \"Codegen is a surface (L4) that walks the plugin-emitted\n//    `Codegenable` capability decls.\"\n//\n// Hard boundary (distilled-doc §\"Hard boundary\"):\n//   \"Apps consume codegen output, NOT devstack.\" Every runtime value\n//   the app needs flows through codegen-emitted TS files. The\n//   orchestrator owns the only legitimate channel from stack state\n//   to app code.\n//\n// Lifecycle (distilled-doc §\"Lifecycle states\"):\n//   - at-up:       per supervisor cycle, run all emitters serially,\n//                  with per-file atomic/idempotent writes inside a\n//                  cycle-level stage-and-swap (rollback on any\n//                  per-file failure leaves the user-visible tree\n//                  unchanged).\n//   - on-change:   re-run as part of the new cycle when the\n//                  supervisor restarts.\n//   - on-demand:   same emit pipeline for snapshot resume.\n//   - idempotency: per-file no-touch on unchanged content.\n//\n// Pipeline (one cycle):\n//   1. Collect `Codegenable` contributions from the active stack\n//      members (the supervisor walks `member.capabilities`).\n//   2. Validate uniqueness: emitter name (literal) is globally\n//      unique; output path is globally unique.\n//   3. Run each emitter serially (distilled-doc § \"Serial within a\n//      cycle\"). Each emit writes exports through a per-file context.\n//   4. Render each collected file emission to a TS source string.\n//   5. Emit each file with an atomic write + per-file no-touch\n//      idempotency.\n//   6. Run the Move-bindings emitter against the collected\n//      `package`-emitted contributions.\n//   7. Write the `.gitignore`.\n//\n// What this module does NOT do:\n//   - Construct plugin-level resolved blobs (plugins pass them at\n//     factory-build time).\n//   - Decode the manifest envelope (see `manifest-bridge.ts`).\n//   - Watch files. Re-emit is driven by the supervisor cycle (and\n//     on-demand by the CLI); the app's own toolchain (Vite/HMR)\n//     watches the emitted output tree.\n//   - Walk the user's Move-source mtimes (see `bindings.ts`).\n\nimport { Context, Effect, FileSystem, Layer, Order, Ref, Scope } from 'effect';\nimport { dirname } from 'node:path';\n\nimport type {\n\tCodegenableDecl,\n\tCodegenEmitDone,\n\tCodegenEmitContext,\n} from '../../contracts/codegenable.ts';\nimport { acquireStackLock } from '../../substrate/runtime/cross-process/stack-lock.ts';\nimport { mintRandomSuffix } from '../../substrate/runtime/random-suffix.ts';\nimport { stageAndSwap, StageAndSwapError } from '../../substrate/runtime/stage-and-swap/index.ts';\n\nimport {\n\temitBindings,\n\ttype EmitBindingsResult,\n\tMoveCodegenService,\n\tMoveSummaryRunnerService,\n\ttype PackageBindings,\n} from './bindings.ts';\nimport { emitOne } from './emit.ts';\nimport {\n\tCodegenEmitFailed,\n\tCodegenEmitterCollision,\n\tCodegenPathConflict,\n\tCodegenWriteFailed,\n\ttype CodegenError,\n} from './errors.ts';\nimport { renderFile } from './format.ts';\nimport { writeGitignore } from './gitignore.ts';\nimport { CodegenPathsService, type CodegenPaths } from './paths.ts';\nimport { dirModeFor, modeFor, NON_SENSITIVE_DIR_MODE } from './permissions.ts';\n\n// -----------------------------------------------------------------------------\n// Public types\n// -----------------------------------------------------------------------------\n\n/** A type alias the orchestrator uses internally to avoid restating\n *  the wide-erased `CodegenableDecl` generic in every signature. */\nexport type Codegenable = CodegenableDecl<string>;\n\nexport interface RunEmitCycleInput {\n\t/** All Codegenable contributions, as collected from the active\n\t *  stack members' `capabilities` tuples. The orchestrator does\n\t *  not look at plugins — only at the decl set. */\n\treadonly contributions: ReadonlyArray<Codegenable>;\n\t/** Optional: import-extension for bindings emission. Default `.ts`. */\n\treadonly bindingsImportExtension?: '.ts' | '.js' | '';\n}\n\nexport interface RunEmitCycleResult {\n\treadonly filesWritten: ReadonlyArray<string>;\n\treadonly filesUnchanged: ReadonlyArray<string>;\n\treadonly filesChmod: ReadonlyArray<string>;\n\treadonly bindings: EmitBindingsResult | null;\n}\n\nconst buildParentModeResolver = (\n\tpaths: CodegenPaths,\n\tdecls: ReadonlyArray<Codegenable>,\n): Effect.Effect<(absolutePath: string) => number, CodegenPathConflict> =>\n\tEffect.gen(function* () {\n\t\tconst byParent = new Map<string, Array<Pick<Codegenable, 'sensitive'>>>();\n\t\tfor (const decl of decls) {\n\t\t\tconst parent = dirname(yield* paths.resolve(decl.outputPath));\n\t\t\tconst current = byParent.get(parent);\n\t\t\tif (current === undefined) {\n\t\t\t\tbyParent.set(parent, [decl]);\n\t\t\t} else {\n\t\t\t\tcurrent.push(decl);\n\t\t\t}\n\t\t}\n\t\tconst modes = new Map<string, number>();\n\t\tfor (const [parent, parentDecls] of byParent) {\n\t\t\tmodes.set(parent, dirModeFor(parentDecls));\n\t\t}\n\t\treturn (absolutePath: string) => modes.get(dirname(absolutePath)) ?? NON_SENSITIVE_DIR_MODE;\n\t});\n\n// -----------------------------------------------------------------------------\n// Main entry — one cycle of the codegen pipeline\n// -----------------------------------------------------------------------------\n\n/**\n * Per-cycle lock acquire timeout. Codegen cycles can be file-system\n * heavy (multi-emitter, Move-bindings compilation), so we allow more\n * than the substrate's default 5s for `stack.lock` — a custom CLI\n * caller that hits a supervisor mid-cycle should wait, not error.\n * Mirrors `MOVE_BUILD_LOCK_TIMEOUT_MS` (5 minutes).\n */\nconst CODEGEN_CYCLE_LOCK_TIMEOUT_MS = 5 * 60_000;\n\nexport const runEmitCycle = (\n\tinput: RunEmitCycleInput,\n): Effect.Effect<\n\tRunEmitCycleResult,\n\tCodegenError,\n\tFileSystem.FileSystem | CodegenPathsService | MoveSummaryRunnerService | MoveCodegenService\n> =>\n\t// Per-process lock. The supervisor's serialized post-acquire path\n\t// is fine for the normal lifecycle, but custom callers (CLI direct\n\t// invocations, future watcher hooks) can call `runCycle`\n\t// concurrently. With `stageAndSwap` writing under shared\n\t// `<outputDir>.staging.<cycleId>` and `<outputDir>.bak.<cycleId>`\n\t// siblings — and with the pre-seed `fs.copy` reading from the\n\t// shared `outputDir` — two overlapping cycles can stage from a\n\t// half-published tree of the other. The lock serializes them.\n\t//\n\t// Dedicated `codegenLockFile` (NOT the substrate `stack.lock`):\n\t// codegen cycles can run for many seconds when Move bindings\n\t// compile, and the substrate's `stack.lock` is reserved for short\n\t// critical sections (roster mutations, snapshot reservation). A\n\t// dedicated lock isolates codegen contention from those subsystems.\n\tEffect.scoped(\n\t\tEffect.gen(function* () {\n\t\t\tconst paths = yield* CodegenPathsService;\n\t\t\tyield* acquireStackLock(paths.codegenLockFile, CODEGEN_CYCLE_LOCK_TIMEOUT_MS).pipe(\n\t\t\t\tEffect.mapError(\n\t\t\t\t\t(cause) =>\n\t\t\t\t\t\tnew CodegenWriteFailed({\n\t\t\t\t\t\t\toutputPath: paths.codegenLockFile,\n\t\t\t\t\t\t\tstage: 'write',\n\t\t\t\t\t\t\tcause,\n\t\t\t\t\t\t}),\n\t\t\t\t),\n\t\t\t);\n\t\t\treturn yield* runEmitCycleLocked(input);\n\t\t}),\n\t);\n\nconst runEmitCycleLocked = (\n\tinput: RunEmitCycleInput,\n): Effect.Effect<\n\tRunEmitCycleResult,\n\tCodegenError,\n\tFileSystem.FileSystem | CodegenPathsService | MoveSummaryRunnerService | MoveCodegenService\n> =>\n\tEffect.gen(function* () {\n\t\tconst paths = yield* CodegenPathsService;\n\t\t// Yield the Move-codegen services here (outside the\n\t\t// stage-and-swap build) so the build's R-channel collapses to\n\t\t// just `FileSystem.FileSystem` — the substrate `stageAndSwap`\n\t\t// primitive constrains `build`'s requirements to\n\t\t// `FileSystem.FileSystem`.\n\t\tconst moveRunner = yield* MoveSummaryRunnerService;\n\t\tconst moveCodegen = yield* MoveCodegenService;\n\n\t\t// Pre-flight contribution-set validation. Detected BEFORE the\n\t\t// stage-and-swap so a programming-bug rejection (duplicate\n\t\t// emitterName / outputPath collision) never opens an empty\n\t\t// staging dir on disk. `package` is the one exception:\n\t\t// multiple instances (one per Package) legitimately share the\n\t\t// `emitterName` literal by design.\n\t\tyield* validateUniqueness(input.contributions);\n\t\tyield* validateAggregatePathAvailability(input.contributions);\n\n\t\t// Cycle-level atomicity: substrate stage-and-swap. The build\n\t\t// populates `<outputDir>.staging.<cycleId>/`; on success the\n\t\t// substrate renames it into place; on any failure the previous\n\t\t// tree (if any) is restored byte-for-byte. Without this wrapper\n\t\t// a mid-cycle emit failure would leave `src/generated/`\n\t\t// half-rewritten — see STYLE_GUIDE §19.\n\t\t//\n\t\t// `preserveOnPreseed: true` — substrate clones the current\n\t\t// target into staging before `build` runs so the per-file\n\t\t// no-touch idempotency (and gitignore user-block preservation)\n\t\t// sees the right baseline. Files this cycle rewrites are\n\t\t// overwritten in staging; files this cycle does NOT touch\n\t\t// survive into the next target verbatim with their original\n\t\t// mtimes (HMR watchers stay quiet for unchanged outputs).\n\t\t//\n\t\t// Cycle id is a random suffix. STYLE_GUIDE §17 mandates 8\n\t\t// hex chars for external-facing identifiers; this is a\n\t\t// deliberate 16-char carve-out because the value only\n\t\t// appears in transient staging-directory names\n\t\t// (`.staging.<id>` / `.bak.<id>`) that the substrate rm's\n\t\t// after publish. The extra entropy is defense-in-depth for\n\t\t// the race-window where two concurrent emit cycles under a\n\t\t// custom-CLI caller could mint overlapping staging dirs\n\t\t// against the same shared `outputDir`; a collision there\n\t\t// would corrupt a half-built tree, not just clash an\n\t\t// operator-visible name.\n\t\tconst cycleId = mintRandomSuffix(16);\n\t\tconst stagingPaths = paths.withRoot(`${paths.outputDir}.staging.${cycleId}`);\n\n\t\treturn yield* stageAndSwap({\n\t\t\ttargetPath: paths.outputDir,\n\t\t\tidSuffix: cycleId,\n\t\t\tpreserveOnPreseed: true,\n\t\t\tbuild: Effect.gen(function* () {\n\t\t\t\tconst inner = yield* runEmitCycleInner(input, stagingPaths).pipe(\n\t\t\t\t\tEffect.provideService(MoveSummaryRunnerService, moveRunner),\n\t\t\t\t\tEffect.provideService(MoveCodegenService, moveCodegen),\n\t\t\t\t);\n\t\t\t\t// Rewrite paths so callers see the final user-visible\n\t\t\t\t// `outputDir` location, not the staging directory that\n\t\t\t\t// only exists for the duration of the build.\n\t\t\t\treturn rewriteResultPaths(inner, stagingPaths.outputDir, paths.outputDir);\n\t\t\t}),\n\t\t}).pipe(\n\t\t\tEffect.mapError((e): CodegenError => {\n\t\t\t\tif (e instanceof StageAndSwapError) {\n\t\t\t\t\treturn new CodegenWriteFailed({\n\t\t\t\t\t\toutputPath: paths.outputDir,\n\t\t\t\t\t\tstage: 'rename',\n\t\t\t\t\t\tcause: e,\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t\treturn e;\n\t\t\t}),\n\t\t\tEffect.withSpan('codegen.runEmitCycle', {\n\t\t\t\tattributes: {\n\t\t\t\t\t'codegen.contributions': input.contributions.length,\n\t\t\t\t\t'codegen.cycleId': cycleId,\n\t\t\t\t\t'codegen.stagingDir': stagingPaths.outputDir,\n\t\t\t\t},\n\t\t\t}),\n\t\t);\n\t});\n\n/**\n * Project a staging-rooted `RunEmitCycleResult` back into the user-\n * visible `outputDir` namespace. The build effect writes through\n * `stagingDir` paths; callers (and tests) expect to see the final\n * post-rename locations.\n */\nconst rewriteResultPaths = (\n\tresult: RunEmitCycleResult,\n\tstagingDir: string,\n\toutputDir: string,\n): RunEmitCycleResult => {\n\tconst stripped = stagingDir.replace(/\\/+$/, '');\n\tconst target = outputDir.replace(/\\/+$/, '');\n\tconst rewrite = (p: string): string =>\n\t\tp.startsWith(stripped) ? `${target}${p.slice(stripped.length)}` : p;\n\treturn {\n\t\tfilesWritten: result.filesWritten.map(rewrite),\n\t\tfilesUnchanged: result.filesUnchanged.map(rewrite),\n\t\tfilesChmod: result.filesChmod.map(rewrite),\n\t\tbindings:\n\t\t\tresult.bindings === null\n\t\t\t\t? null\n\t\t\t\t: {\n\t\t\t\t\t\t...result.bindings,\n\t\t\t\t\t\tfilesWritten: result.bindings.filesWritten.map(rewrite),\n\t\t\t\t\t},\n\t};\n};\n\n/**\n * The body of one emit cycle. Pulled out of `runEmitCycle` so the\n * stage-and-swap wrapper can drive it against a redirected\n * `CodegenPathsService` (the staging tree). Validation runs BEFORE\n * this function so callers know the contribution set is well-formed.\n */\nconst runEmitCycleInner = (\n\tinput: RunEmitCycleInput,\n\tpaths: CodegenPaths,\n): Effect.Effect<\n\tRunEmitCycleResult,\n\tCodegenError,\n\tFileSystem.FileSystem | MoveSummaryRunnerService | MoveCodegenService\n> =>\n\tEffect.gen(function* () {\n\t\tconst fileEmitters: Array<Codegenable> = [...input.contributions];\n\n\t\tconst filesWritten: Array<string> = [];\n\t\tconst filesUnchanged: Array<string> = [];\n\t\tconst filesChmod: Array<string> = [];\n\t\t// Aggregate buckets keyed by plugin-supplied bucket name. The\n\t\t// orchestrator treats bucket names as opaque tags chosen by\n\t\t// the contributor; it never branches on plugin identity. See\n\t\t// `CodegenableDecl.aggregate` (contracts/codegenable.ts).\n\t\tconst aggregates = new Map<string, Record<string, unknown>>();\n\t\tconst packageContribs: Array<PackageBindings> = [];\n\t\tconst sortedDecls = [...fileEmitters].sort(\n\t\t\tOrder.mapInput(Order.String, (d: Codegenable) => d.outputPath),\n\t\t);\n\t\tconst parentModeFor = yield* buildParentModeResolver(paths, fileEmitters);\n\t\tfor (const decl of sortedDecls) {\n\t\t\tconst emission = yield* runEmitter(decl);\n\t\t\tconst exported = emission.exports;\n\t\t\tif (decl.aggregate !== undefined) {\n\t\t\t\tconst projected = decl.aggregate.project(exported);\n\t\t\t\tif (projected !== null) {\n\t\t\t\t\tconst bucket = aggregates.get(decl.aggregate.bucket) ?? {};\n\t\t\t\t\tObject.assign(bucket, projected);\n\t\t\t\t\taggregates.set(decl.aggregate.bucket, bucket);\n\t\t\t\t}\n\t\t\t}\n\t\t\t// Move-bindings collection: any export whose shape matches\n\t\t\t// the orchestrator's `PackageBindings` consumer contract is\n\t\t\t// forwarded to `emitBindings`. Runs against the raw `exported`\n\t\t\t// map (not via `aggregate.project`) so direct `codegenable(...)`\n\t\t\t// contributions — which carry no `aggregate` — are picked up\n\t\t\t// too. The orchestrator validates the shape it consumes; it\n\t\t\t// does NOT name the plugin that produced it.\n\t\t\tfor (const value of Object.values(exported)) {\n\t\t\t\tif (isPackageBindings(value)) {\n\t\t\t\t\tpackageContribs.push(value);\n\t\t\t\t}\n\t\t\t}\n\t\t\tconst rendered = renderFile({\n\t\t\t\temitterName: decl.emitterName,\n\t\t\t\toutputPath: decl.outputPath,\n\t\t\t\tsensitive: decl.sensitive === true,\n\t\t\t\texports: exported,\n\t\t\t\timports: emission.imports,\n\t\t\t});\n\t\t\tif (!rendered.ok) {\n\t\t\t\treturn yield* Effect.fail(rendered.error);\n\t\t\t}\n\t\t\tconst abs = yield* paths.resolve(decl.outputPath);\n\t\t\tconst outcome = yield* emitOne({\n\t\t\t\tpath: abs,\n\t\t\t\tcontent: rendered.text,\n\t\t\t\tmode: modeFor(decl),\n\t\t\t\tparentMode: parentModeFor(abs),\n\t\t\t});\n\t\t\tswitch (outcome.outcome) {\n\t\t\t\tcase 'wrote':\n\t\t\t\t\tfilesWritten.push(abs);\n\t\t\t\t\tbreak;\n\t\t\t\tcase 'unchanged':\n\t\t\t\t\tfilesUnchanged.push(abs);\n\t\t\t\t\tbreak;\n\t\t\t\tcase 'chmod-only':\n\t\t\t\t\tfilesChmod.push(abs);\n\t\t\t\t\tbreak;\n\t\t\t}\n\t\t}\n\n\t\tfor (const aggregate of buildAggregateFiles(aggregates)) {\n\t\t\tconst rendered = renderFile({\n\t\t\t\temitterName: aggregate.emitterName,\n\t\t\t\toutputPath: aggregate.outputPath,\n\t\t\t\tsensitive: false,\n\t\t\t\texports: aggregate.exports,\n\t\t\t});\n\t\t\tif (!rendered.ok) {\n\t\t\t\treturn yield* Effect.fail(rendered.error);\n\t\t\t}\n\t\t\tconst abs = yield* paths.resolve(aggregate.outputPath);\n\t\t\tconst outcome = yield* emitOne({\n\t\t\t\tpath: abs,\n\t\t\t\tcontent: rendered.text,\n\t\t\t\tmode: 0o644,\n\t\t\t\tparentMode: parentModeFor(abs),\n\t\t\t});\n\t\t\tswitch (outcome.outcome) {\n\t\t\t\tcase 'wrote':\n\t\t\t\t\tfilesWritten.push(abs);\n\t\t\t\t\tbreak;\n\t\t\t\tcase 'unchanged':\n\t\t\t\t\tfilesUnchanged.push(abs);\n\t\t\t\t\tbreak;\n\t\t\t\tcase 'chmod-only':\n\t\t\t\t\tfilesChmod.push(abs);\n\t\t\t\t\tbreak;\n\t\t\t}\n\t\t}\n\n\t\tlet bindings: EmitBindingsResult | null = null;\n\t\tif (packageContribs.length > 0) {\n\t\t\tbindings = yield* emitBindings({\n\t\t\t\tbindingsDir: paths.bindingsDir,\n\t\t\t\tpackages: packageContribs,\n\t\t\t\timportExtension: input.bindingsImportExtension,\n\t\t\t});\n\t\t} else {\n\t\t\tyield* Effect.logInfo(\n\t\t\t\t'codegen: no package contributions; skipping Move-to-TS bindings step.',\n\t\t\t);\n\t\t}\n\n\t\tconst sensitivePaths = fileEmitters\n\t\t\t.filter((d) => d.sensitive === true)\n\t\t\t.map((d) => d.outputPath);\n\t\tyield* writeGitignore({\n\t\t\tpath: paths.gitignoreFile,\n\t\t\tsensitivePaths,\n\t\t\tparentMode: parentModeFor(paths.gitignoreFile),\n\t\t});\n\n\t\treturn {\n\t\t\tfilesWritten,\n\t\t\tfilesUnchanged,\n\t\t\tfilesChmod,\n\t\t\tbindings,\n\t\t};\n\t});\n\n// -----------------------------------------------------------------------------\n// Internals\n// -----------------------------------------------------------------------------\n\ninterface CodegenEmission {\n\treadonly exports: { readonly [key: string]: unknown };\n\treadonly imports: ReadonlyArray<string>;\n}\n\nconst runEmitter = (decl: Codegenable): Effect.Effect<CodegenEmission, CodegenEmitFailed> =>\n\tEffect.gen(function* () {\n\t\tconst exports: Record<string, unknown> = {};\n\t\tconst imports: Array<string> = [];\n\t\tconst done: CodegenEmitDone = { _tag: 'CodegenEmitDone' };\n\t\tconst ctx: CodegenEmitContext = {\n\t\t\texportConst: (name, value) => {\n\t\t\t\texports[name] = value;\n\t\t\t},\n\t\t\timportStatement: (statement) => {\n\t\t\t\timports.push(statement);\n\t\t\t},\n\t\t\tdone: () => done,\n\t\t};\n\t\tyield* decl.emit(ctx).pipe(\n\t\t\tEffect.mapError(\n\t\t\t\t(cause) =>\n\t\t\t\t\tnew CodegenEmitFailed({\n\t\t\t\t\t\temitterName: decl.emitterName,\n\t\t\t\t\t\toutputPath: decl.outputPath,\n\t\t\t\t\t\tcause,\n\t\t\t\t\t}),\n\t\t\t),\n\t\t);\n\t\treturn { exports, imports };\n\t});\n\n/**\n * Uniqueness check: emitter name (literal) must be unique unless\n * the decl opts into repetition via `allowEmitterNameRepetition`\n * (used by per-item plugins like Package, which emit one decl per\n * published package under a shared emitter name). Output paths\n * must be unique across ALL emitters.\n */\nconst validateUniqueness = (\n\tdecls: ReadonlyArray<Codegenable>,\n): Effect.Effect<void, CodegenPathConflict | CodegenEmitterCollision> =>\n\tEffect.gen(function* () {\n\t\tconst byPath = new Map<string, Array<string>>();\n\t\tconst byName = new Map<string, Array<string>>();\n\t\tfor (const d of decls) {\n\t\t\tconst ps = byPath.get(d.outputPath) ?? [];\n\t\t\tps.push(d.emitterName);\n\t\t\tbyPath.set(d.outputPath, ps);\n\t\t\tif (d.allowEmitterNameRepetition === true) continue;\n\t\t\tconst ns = byName.get(d.emitterName) ?? [];\n\t\t\tns.push(d.outputPath);\n\t\t\tbyName.set(d.emitterName, ns);\n\t\t}\n\t\tfor (const [path, emitters] of byPath) {\n\t\t\tif (emitters.length > 1) {\n\t\t\t\treturn yield* Effect.fail(\n\t\t\t\t\tnew CodegenPathConflict({\n\t\t\t\t\t\tkind: 'duplicate',\n\t\t\t\t\t\toutputPath: path,\n\t\t\t\t\t\temitters,\n\t\t\t\t\t}),\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\t\tfor (const [name, outputPaths] of byName) {\n\t\t\tif (outputPaths.length > 1) {\n\t\t\t\treturn yield* Effect.fail(\n\t\t\t\t\tnew CodegenEmitterCollision({\n\t\t\t\t\t\temitterName: name,\n\t\t\t\t\t\toutputPaths,\n\t\t\t\t\t}),\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\t});\n\n/**\n * Reject contribution sets that would have an aggregate bucket\n * collide with a per-decl `outputPath`. The orchestrator only knows\n * bucket names because plugins declared them via `aggregate.bucket`;\n * it does not enumerate or recognize plugin identities here.\n */\nconst validateAggregatePathAvailability = (\n\tdecls: ReadonlyArray<Codegenable>,\n): Effect.Effect<void, CodegenPathConflict> =>\n\tEffect.gen(function* () {\n\t\tconst aggregatePaths = new Set<string>();\n\t\tfor (const decl of decls) {\n\t\t\tif (decl.aggregate !== undefined) aggregatePaths.add(decl.aggregate.bucket);\n\t\t}\n\t\tfor (const path of aggregatePaths) {\n\t\t\tconst colliding = decls.filter((decl) => decl.outputPath === path);\n\t\t\tif (colliding.length > 0) {\n\t\t\t\treturn yield* Effect.fail(\n\t\t\t\t\tnew CodegenPathConflict({\n\t\t\t\t\t\tkind: 'duplicate',\n\t\t\t\t\t\toutputPath: path,\n\t\t\t\t\t\temitters: [...colliding.map((decl) => decl.emitterName), `aggregate/${path}`],\n\t\t\t\t\t}),\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\t});\n\ninterface AggregateFile {\n\treadonly emitterName: string;\n\treadonly outputPath: string;\n\treadonly exports: { readonly [key: string]: unknown };\n}\n\n/**\n * Synthesize one `AggregateFile` per non-empty bucket. The exports\n * map is keyed by the bucket's stem (e.g. `accounts.ts` → `accounts`)\n * so the rendered file exports `export const <stem> = { ... }`. The\n * orchestrator picks the export key from the bucket filename; the\n * stem itself is not a plugin identifier — it is the filename\n * without the `.ts` extension, derived mechanically.\n */\nconst buildAggregateFiles = (\n\tbuckets: ReadonlyMap<string, Record<string, unknown>>,\n): ReadonlyArray<AggregateFile> => {\n\tconst files: Array<AggregateFile> = [];\n\tconst sortedEntries = [...buckets.entries()].sort(([a], [b]) => a.localeCompare(b));\n\tfor (const [bucket, contents] of sortedEntries) {\n\t\tif (Object.keys(contents).length === 0) continue;\n\t\tconst stem = bucketStem(bucket);\n\t\tfiles.push({\n\t\t\temitterName: `aggregate/${stem}`,\n\t\t\toutputPath: bucket,\n\t\t\texports: { [stem]: contents },\n\t\t});\n\t}\n\treturn files;\n};\n\nconst bucketStem = (bucket: string): string => bucket.replace(/\\.ts$/, '').replace(/^.*\\//, '');\n\n/**\n * Consumer-side shape guard: does this aggregated value look like a\n * Move-bindings contribution that `emitBindings` knows how to\n * consume? This is structural validation of the orchestrator's own\n * input contract, NOT a plugin-name match. Any plugin whose\n * `aggregate.project` returns objects with this shape will be\n * forwarded to the Move bindings emitter.\n */\nconst isPackageBindings = (v: unknown): v is PackageBindings =>\n\ttypeof v === 'object' &&\n\tv !== null &&\n\t'name' in v &&\n\t'packageId' in v &&\n\t'mvrPlaceholder' in v &&\n\t'sourcePath' in v;\n\n// -----------------------------------------------------------------------------\n// Service surface — registration API + emit-cycle trigger\n// -----------------------------------------------------------------------------\n\n/**\n * The codegen orchestrator's Context-bound service. The substrate's\n * supervisor calls `registerContribution(pluginKey, decl)` once per\n * `CodegenableDecl` on each plugin's `capabilities` tuple, scope-bound\n * to that plugin's acquire scope. `runCycle()` walks the registered\n * set and runs one full emit pipeline.\n */\nexport interface CodegenOrchestrator {\n\t/** Register a `CodegenableDecl` from a plugin. Scope-bound — when\n\t *  the caller's scope (the plugin's acquire scope) closes, the\n\t *  registration is reaped. */\n\treadonly registerContribution: (\n\t\tpluginKey: string,\n\t\tdecl: Codegenable,\n\t) => Effect.Effect<void, never, Scope.Scope>;\n\n\t/** Run one emit cycle against the currently-registered set.\n\t *  `extraContributions` are merged into the active set (callers\n\t *  that have a one-off decl not tied to a plugin scope).\n\t *  `bindingsImportExtension` mirrors `runEmitCycle`. */\n\treadonly runCycle: (args?: {\n\t\treadonly extraContributions?: ReadonlyArray<Codegenable>;\n\t\treadonly bindingsImportExtension?: '.ts' | '.js' | '';\n\t}) => Effect.Effect<\n\t\tRunEmitCycleResult,\n\t\tCodegenError,\n\t\tFileSystem.FileSystem | CodegenPathsService | MoveSummaryRunnerService | MoveCodegenService\n\t>;\n}\n\nexport class CodegenOrchestratorService extends Context.Service<\n\tCodegenOrchestratorService,\n\tCodegenOrchestrator\n>()('@devstack/orchestrators/Codegen') {}\n\ninterface RegisteredCodegenEntry {\n\treadonly pluginKey: string;\n\treadonly decl: Codegenable;\n\treadonly seq: number;\n}\n\n/** Layer-wired codegen orchestrator. No upstream requirements at boot\n *  time — the per-cycle effect carries the `FileSystem` + Move-codegen\n *  service requirements through to the caller. */\nexport const layerCodegenOrchestrator: Layer.Layer<CodegenOrchestratorService> = Layer.effect(\n\tCodegenOrchestratorService,\n\tEffect.gen(function* () {\n\t\tconst contributionsRef = yield* Ref.make<ReadonlyArray<RegisteredCodegenEntry>>([]);\n\t\tconst seqRef = yield* Ref.make(0);\n\n\t\tconst registerContribution: CodegenOrchestrator['registerContribution'] = (pluginKey, decl) =>\n\t\t\tEffect.gen(function* () {\n\t\t\t\tconst seq = yield* Ref.updateAndGet(seqRef, (n) => n + 1);\n\t\t\t\tconst entry: RegisteredCodegenEntry = { pluginKey, decl, seq };\n\t\t\t\tyield* Ref.update(contributionsRef, (xs) => [...xs, entry]);\n\t\t\t\tyield* Effect.addFinalizer(() =>\n\t\t\t\t\tRef.update(contributionsRef, (xs) => xs.filter((e) => e.seq !== seq)),\n\t\t\t\t);\n\t\t\t\tyield* Effect.annotateCurrentSpan({\n\t\t\t\t\t'codegen.contribution.plugin': pluginKey,\n\t\t\t\t\t'codegen.contribution.emitter': decl.emitterName,\n\t\t\t\t\t'codegen.contribution.outputPath': decl.outputPath,\n\t\t\t\t});\n\t\t\t}).pipe(Effect.withSpan('orchestrator.codegen.registerContribution')) as Effect.Effect<\n\t\t\t\tvoid,\n\t\t\t\tnever,\n\t\t\t\tScope.Scope\n\t\t\t>;\n\n\t\tconst runCycle: CodegenOrchestrator['runCycle'] = (args) =>\n\t\t\tEffect.gen(function* () {\n\t\t\t\tconst registered = (yield* Ref.get(contributionsRef)).map((e) => e.decl);\n\t\t\t\tconst merged: ReadonlyArray<Codegenable> = args?.extraContributions\n\t\t\t\t\t? [...registered, ...args.extraContributions]\n\t\t\t\t\t: registered;\n\t\t\t\treturn yield* runEmitCycle({\n\t\t\t\t\tcontributions: merged,\n\t\t\t\t\tbindingsImportExtension: args?.bindingsImportExtension,\n\t\t\t\t});\n\t\t\t}).pipe(Effect.withSpan('orchestrator.codegen.runCycle'));\n\n\t\treturn CodegenOrchestratorService.of({\n\t\t\tregisterContribution,\n\t\t\trunCycle,\n\t\t});\n\t}),\n);\n"],"mappings":"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"}

package/dist/orchestrators/lifecycle-prune/errors.mjs

@@ -0,0 +1,31 @@
+import { Schema } from "effect";
+//#region src/orchestrators/lifecycle-prune/errors.ts
+/** Phase discriminator: which step of the cross-stack sweep failed.
+*  `inventory` covers the parallel listDevstack* fan-out and the
+*  per-group bucketing; the four `remove-*` phases cover the
+*  resource-specific sweep loops in `runLifecyclePrune`. */
+const LifecyclePrunePhase = Schema.Literals([
+	"inventory",
+	"remove-containers",
+	"remove-networks",
+	"remove-volumes",
+	"remove-images"
+]);
+var LifecyclePruneError = class extends Schema.TaggedErrorClass()("LifecyclePruneError", {
+	phase: LifecyclePrunePhase,
+	detail: Schema.String,
+	cause: Schema.optional(Schema.Defect)
+}) {};
+/** Curry: `phase` → `(DockerRuntimeError) → LifecyclePruneError`.
+*  Used as `Effect.mapError(failPhase('inventory'))` to project the L1
+*  docker error union onto a single phase-tagged envelope while
+*  preserving the underlying cause for diagnostics. */
+const failPhase = (phase) => (cause) => new LifecyclePruneError({
+	phase,
+	detail: `${phase}: ${cause._tag}`,
+	cause
+});
+//#endregion
+export { LifecyclePruneError, LifecyclePrunePhase, failPhase };
+
+//# sourceMappingURL=errors.mjs.map

package/dist/orchestrators/lifecycle-prune/errors.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.mjs","names":[],"sources":["../../../src/orchestrators/lifecycle-prune/errors.ts"],"sourcesContent":["// Tagged failures for the lifecycle-prune orchestrator.\n//\n// Per STYLE_GUIDE §2.2: orchestrator-level failures use\n// `Schema.TaggedErrorClass`; never plain `Error`; never `unknown` at\n// the public surface. The orchestrator's underlying L1 docker calls\n// raise `DockerRuntimeError` (itself a union of 16+ tagged errors);\n// we project each underlying failure onto a single phase-tagged\n// envelope so CLI consumers can `Effect.catchTag('LifecyclePruneError')`\n// and branch on `phase` instead of inspecting the L1 union directly.\n\nimport { Schema } from 'effect';\n\nimport type { DockerRuntimeError } from '../../runtime/docker/errors.ts';\n\n/** Phase discriminator: which step of the cross-stack sweep failed.\n *  `inventory` covers the parallel listDevstack* fan-out and the\n *  per-group bucketing; the four `remove-*` phases cover the\n *  resource-specific sweep loops in `runLifecyclePrune`. */\nexport const LifecyclePrunePhase = Schema.Literals([\n\t'inventory',\n\t'remove-containers',\n\t'remove-networks',\n\t'remove-volumes',\n\t'remove-images',\n]);\nexport type LifecyclePrunePhase = typeof LifecyclePrunePhase.Type;\n\nexport class LifecyclePruneError extends Schema.TaggedErrorClass<LifecyclePruneError>()(\n\t'LifecyclePruneError',\n\t{\n\t\tphase: LifecyclePrunePhase,\n\t\tdetail: Schema.String,\n\t\tcause: Schema.optional(Schema.Defect),\n\t},\n) {}\n\n/** Curry: `phase` → `(DockerRuntimeError) → LifecyclePruneError`.\n *  Used as `Effect.mapError(failPhase('inventory'))` to project the L1\n *  docker error union onto a single phase-tagged envelope while\n *  preserving the underlying cause for diagnostics. */\nexport const failPhase =\n\t(phase: LifecyclePrunePhase) =>\n\t(cause: DockerRuntimeError): LifecyclePruneError =>\n\t\tnew LifecyclePruneError({\n\t\t\tphase,\n\t\t\tdetail: `${phase}: ${cause._tag}`,\n\t\t\tcause,\n\t\t});\n"],"mappings":";;;;;;AAkBA,MAAa,sBAAsB,OAAO,SAAS;CAClD;CACA;CACA;CACA;CACA;CACA,CAAC;AAGF,IAAa,sBAAb,cAAyC,OAAO,kBAAuC,CACtF,uBACA;CACC,OAAO;CACP,QAAQ,OAAO;CACf,OAAO,OAAO,SAAS,OAAO,OAAO;CACrC,CACD,CAAC;;;;;AAMF,MAAa,aACX,WACA,UACA,IAAI,oBAAoB;CACvB;CACA,QAAQ,GAAG,MAAM,IAAI,MAAM;CAC3B;CACA,CAAC"}