@mysten-incubation/devstack 0.0.1 → 0.1.0

package/dist/orchestrators/codegen/bindings.mjs

@@ -1,17 +1,14 @@
-import { capture } from "../../substrate/runtime/observability/subprocess-capture.mjs";
-import { ContainerRuntimeService } from "../../runtime/docker/service.mjs";
-import { shellQuote, suiCliImageBuildContext } from "../../substrate/runtime/sui-move-build/index.mjs";
 import { CodegenBindingsFailed } from "./errors.mjs";
 import { emitOne } from "./emit.mjs";
+import "./permissions.mjs";
 import { Context, Effect, Layer } from "effect";
-import { basename, dirname, join, relative, sep } from "node:path";
-import { homedir, tmpdir } from "node:os";
-import { ChildProcess, ChildProcessSpawner } from "effect/unstable/process";
-import { copyFile, mkdir, mkdtemp, readFile, readdir, rm } from "node:fs/promises";
+import { join, relative, sep } from "node:path";
+import { tmpdir } from "node:os";
+import { mkdtemp, readFile, readdir, rm } from "node:fs/promises";
 import { generateFromPackageSummary } from "@mysten/codegen";
 //#region src/orchestrators/codegen/bindings.ts
-var MoveSummaryRunnerService = class extends Context.Service()("@devstack-rewrite/orchestrator/MoveSummaryRunner") {};
-var MoveCodegenService = class extends Context.Service()("@devstack-rewrite/orchestrator/MoveCodegen") {};
+var MoveSummaryRunnerService = class extends Context.Service()("@devstack/orchestrator/MoveSummaryRunner") {};
+var MoveCodegenService = class extends Context.Service()("@devstack/orchestrator/MoveCodegen") {};
 /**
 * Walk the `PackageBindings` set, filter to LOCAL packages
 * (`sourcePath !== null`), run `sui move summary` + `@mysten/codegen`
@@ -77,7 +74,8 @@ const emitBindings = (input) => Effect.gen(function* () {
 			if ((yield* emitOne({
 				path: abs,
 				content: stabilizeGeneratedBindingContent(f.content),
-				mode: 420
+				mode: 420,
+				parentMode: 493
 			}).pipe(Effect.mapError((cause) => new CodegenBindingsFailed({
 				package: pkg.name,
 				sourcePath: pkg.sourcePath,
@@ -93,184 +91,16 @@ const emitBindings = (input) => Effect.gen(function* () {
 		filesWritten
 	};
 }).pipe(Effect.withSpan("codegen.emitBindings", { attributes: { "codegen.bindingsDir": input.bindingsDir } }));
-const layerDockerMoveSummaryRunner = Layer.effect(MoveSummaryRunnerService, Effect.gen(function* () {
-	const runtime = yield* ContainerRuntimeService;
-	return MoveSummaryRunnerService.of({ runSummary: (input) => runSummaryViaDocker(runtime, input) });
-}));
-Layer.effect(MoveSummaryRunnerService, Effect.gen(function* () {
-	const spawner = yield* ChildProcessSpawner.ChildProcessSpawner;
-	return MoveSummaryRunnerService.of({ runSummary: ({ packageName, sourcePath }) => Effect.gen(function* () {
-		const scratchDir = yield* Effect.tryPromise({
-			try: () => mkdtemp(join(tmpdir(), "devstack-move-summary-")),
-			catch: (cause) => new CodegenBindingsFailed({
-				package: packageName,
-				sourcePath,
-				reason: "summary-failed",
-				hint: "Unable to create a temporary directory for Move summary output.",
-				cause
-			})
-		});
-		const summaryPath = join(scratchDir, "package");
-		const cleanupScratch = Effect.promise(() => rm(scratchDir, {
-			recursive: true,
-			force: true
-		})).pipe(Effect.ignore);
-		return {
-			packageName,
-			sourcePath,
-			summaryPath,
-			cleanupPath: scratchDir,
-			summaryJson: parseSummaryStdout((yield* Effect.gen(function* () {
-				yield* Effect.tryPromise({
-					try: async () => {
-						await mkdir(summaryPath, { recursive: true });
-						await copyFile(join(sourcePath, "Move.toml"), join(summaryPath, "Move.toml"));
-					},
-					catch: (cause) => new CodegenBindingsFailed({
-						package: packageName,
-						sourcePath,
-						reason: "summary-failed",
-						hint: "Unable to prepare a temporary Move summary package directory.",
-						cause
-					})
-				});
-				return yield* capture(spawner, ChildProcess.make("sui", [
-					"move",
-					"summary",
-					"--path",
-					".",
-					"--install-dir",
-					join(scratchDir, "install"),
-					"--output-directory",
-					join(summaryPath, "package_summaries")
-				], { cwd: sourcePath }), {
-					op: `sui move summary (${sourcePath})`,
-					nonZeroIsFailure: true,
-					stdoutTruncate: Infinity,
-					stderrTruncate: 4e3
-				}).pipe(Effect.mapError((cause) => new CodegenBindingsFailed({
-					package: packageName,
-					sourcePath,
-					reason: "summary-failed",
-					hint: "Install the Sui CLI and ensure this Move package can run `sui move summary`.",
-					cause
-				})));
-			}).pipe(Effect.tapError(() => cleanupScratch))).stdout)
-		};
-	}) });
-}));
-const runSummaryViaDocker = (runtime, input) => Effect.scoped(Effect.gen(function* () {
-	const scratchDir = yield* makeSummaryScratch(input);
-	const summaryPath = join(scratchDir, "package");
-	const cleanupScratch = Effect.promise(() => rm(scratchDir, {
-		recursive: true,
-		force: true
-	})).pipe(Effect.ignore);
-	const result = yield* Effect.gen(function* () {
-		yield* prepareSummaryPackage(summaryPath, input);
-		const image = input.buildImage ?? (yield* resolveDefaultSummaryImage(runtime, input));
-		const moveHome = join(homedir(), ".move");
-		yield* ensureMoveHome(moveHome, input);
-		const packageRoot = dirname(input.sourcePath);
-		const packageDir = basename(input.sourcePath);
-		const command = [
-			"set -e",
-			`cleanup_summary() { status=\$?; chmod -R a+rwX /summary 2>/dev/null || true; chown -R ${typeof process.getuid === "function" ? process.getuid() : 0}:${typeof process.getgid === "function" ? process.getgid() : 0} /summary 2>/dev/null || true; exit "\$status"; }`,
-			"trap cleanup_summary EXIT",
-			"mkdir -p /summary/package_summaries",
-			`sui move summary --path /workspace/${shellQuote(packageDir)} --install-dir /tmp/devstack-move-summary-install --output-directory /summary/package_summaries`
-		].join("; ");
-		const run = yield* runtime.runOneShot({
-			image,
-			entrypoint: "sh",
-			argv: ["-c", command],
-			mounts: [
-				{
-					source: packageRoot,
-					target: "/workspace"
-				},
-				{
-					source: summaryPath,
-					target: "/summary"
-				},
-				{
-					source: moveHome,
-					target: "/root/.move"
-				}
-			],
-			timeoutMillis: 5 * 6e4
-		}).pipe(Effect.mapError((cause) => new CodegenBindingsFailed({
-			package: input.packageName,
-			sourcePath: input.sourcePath,
-			reason: "summary-failed",
-			hint: "Docker runtime failed while running `sui move summary` for bindings codegen.",
-			cause
-		})));
-		if (run.exitCode !== 0) return yield* Effect.fail(new CodegenBindingsFailed({
-			package: input.packageName,
-			sourcePath: input.sourcePath,
-			reason: "summary-failed",
-			hint: `sui move summary exited ${run.exitCode}. stderr: ${run.stderr || "(empty)"}; stdout tail: ${run.stdout.slice(-400) || "(empty)"}`
-		}));
-		return run;
-	}).pipe(Effect.tapError(() => cleanupScratch));
-	return {
-		packageName: input.packageName,
-		sourcePath: input.sourcePath,
-		summaryPath,
-		cleanupPath: scratchDir,
-		summaryJson: parseSummaryStdout(result.stdout)
-	};
-}));
-const makeSummaryScratch = (input) => Effect.tryPromise({
-	try: () => mkdtemp(join(tmpdir(), "devstack-move-summary-")),
-	catch: (cause) => new CodegenBindingsFailed({
-		package: input.packageName,
-		sourcePath: input.sourcePath,
-		reason: "summary-failed",
-		hint: "Unable to create a temporary directory for Move summary output.",
-		cause
-	})
-});
-const prepareSummaryPackage = (summaryPath, input) => Effect.tryPromise({
-	try: async () => {
-		await mkdir(summaryPath, { recursive: true });
-		await copyFile(join(input.sourcePath, "Move.toml"), join(summaryPath, "Move.toml"));
-	},
-	catch: (cause) => new CodegenBindingsFailed({
-		package: input.packageName,
-		sourcePath: input.sourcePath,
-		reason: "summary-failed",
-		hint: "Unable to prepare a temporary Move summary package directory.",
-		cause
-	})
-});
-const resolveDefaultSummaryImage = (runtime, input) => runtime.ensureImage(suiCliImageBuildContext()).pipe(Effect.mapError((cause) => new CodegenBindingsFailed({
-	package: input.packageName,
-	sourcePath: input.sourcePath,
-	reason: "summary-failed",
-	hint: "Unable to resolve the Sui CLI container image for Move bindings codegen.",
-	cause
-})));
-const ensureMoveHome = (moveHome, input) => Effect.tryPromise({
-	try: () => mkdir(moveHome, { recursive: true }),
-	catch: (cause) => new CodegenBindingsFailed({
-		package: input.packageName,
-		sourcePath: input.sourcePath,
-		reason: "summary-failed",
-		hint: `Unable to create Move cache mount source "${moveHome}".`,
-		cause
-	})
-}).pipe(Effect.asVoid);
 const layerMystenMoveCodegen = Layer.succeed(MoveCodegenService, MoveCodegenService.of({ generate: (input) => Effect.tryPromise({
 	try: async () => {
 		const tmp = await mkdtemp(join(tmpdir(), "devstack-move-codegen-"));
 		try {
+			const packageName = await resolveSummaryDirName(input.sourcePath) ?? input.packageName;
 			await generateFromPackageSummary({
 				package: {
 					path: input.summary.summaryPath ?? input.sourcePath,
 					package: input.mvrPlaceholder,
-					packageName: input.packageName
+					packageName
 				},
 				prune: true,
 				outputDir: tmp,
@@ -296,14 +126,50 @@ const layerMystenMoveCodegen = Layer.succeed(MoveCodegenService, MoveCodegenServ
 	})
 }) }));
 const joinPath = (...parts) => parts.map((p, i) => i === 0 ? p.replace(/\/+$/, "") : p.replace(/^\/+|\/+$/g, "")).join("/");
-const parseSummaryStdout = (stdout) => {
-	const trimmed = stdout.trim();
-	if (trimmed.length === 0) return null;
+/**
+* Determine the `package_summaries/<dir>` subdirectory name for a local
+* Move package from its REAL source `Move.toml`. `sui move summary` keys
+* these subdirs by the NAMED ADDRESS (e.g. MoveStdlib → "std"), not the
+* `[package].name`, so when the two differ we must hand `@mysten/codegen`
+* the address label rather than the symbolic package name.
+*
+* Returns the single `[addresses]` label when the table has exactly one
+* entry (the overwhelmingly common case — and a no-op when name == address),
+* and `null` otherwise (unreadable Move.toml, no `[addresses]` table, or an
+* ambiguous multi-address table) so the caller can fall back to the package
+* name and preserve `@mysten/codegen`'s own resolution.
+*
+* Hand-parse rather than pull in a TOML dependency: the sibling Move-build
+* path already harvests `{ local = "../x" }` deps from Move.toml by regex
+* (`sui-move-build/index.ts`), and we only need the `[addresses]` section's
+* left-hand labels — never their values.
+*/
+const resolveSummaryDirName = async (sourcePath) => {
+	let toml;
 	try {
-		return JSON.parse(trimmed);
+		toml = await readFile(join(sourcePath, "Move.toml"), "utf8");
 	} catch {
-		return trimmed;
+		return null;
+	}
+	const labels = parseAddressLabels(toml);
+	return labels.length === 1 ? labels[0] : null;
+};
+/** Left-hand labels of the `[addresses]` table in a Move.toml. Scans from
+*  the `[addresses]` header to the next `[section]` header (or EOF) and
+*  collects each `name = "..."` key, ignoring blank/comment lines. */
+const parseAddressLabels = (toml) => {
+	const lines = toml.split(/\r?\n/);
+	const start = lines.findIndex((line) => /^\s*\[addresses\]\s*$/.test(line));
+	if (start === -1) return [];
+	const labels = [];
+	for (const line of lines.slice(start + 1)) {
+		if (/^\s*\[/.test(line)) break;
+		const stripped = line.replace(/#.*$/, "").trim();
+		if (stripped === "") continue;
+		const match = /^([A-Za-z_][\w-]*)\s*=/.exec(stripped);
+		if (match) labels.push(match[1]);
 	}
+	return labels;
 };
 const generatedBcsFactoryPattern = /export function ([A-Za-z_$][\w$]*)<((?:[^<>]|<[^<>]*>)+)>\((\.\.\.typeParameters: \[[\s\S]*?\n\])\) \{\n(\s*)return new (MoveStruct|MoveEnum|MoveTuple)\(/g;
 const bcsFactoryReturnType = (constructorName) => {
@@ -335,6 +201,6 @@ const collectGeneratedFiles = async (root) => {
 	return out;
 };
 //#endregion
-export { MoveCodegenService, MoveSummaryRunnerService, emitBindings, layerDockerMoveSummaryRunner, layerMystenMoveCodegen };
+export { MoveCodegenService, MoveSummaryRunnerService, emitBindings, layerMystenMoveCodegen };
 
 //# sourceMappingURL=bindings.mjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"bindings.mjs","names":[],"sources":["../../../src/orchestrators/codegen/bindings.ts"],"sourcesContent":["// Move-package bindings emission.\n//\n// Distilled-doc § \"Move-to-TS bindings: per-published-package typed\n// client modules produced from each local Move package's summary.\"\n// Calls `@mysten/codegen`'s `generateFromPackageSummary` against the\n// `sui move summary` JSON for each LOCAL package.\n//\n// sourcePath-known-vs-unknown discipline:\n//   - `Package` plugin's `Codegenable` emits a `PackageBindings`\n//     shape with `sourcePath: string | null`.\n//   - The bindings emitter filters to `sourcePath !== null` (i.e.\n//     LOCAL packages); `KnownPackage` entries (`sourcePath: null`)\n//     are skipped — their bindings come from the SDK or MVR.\n//\n// Architecture seam:\n//   - The production layer runs `sui move summary` through the\n//     container runtime's Sui CLI image. Tests and embedders can\n//     replace `MoveSummaryRunnerService` through normal Layer\n//     composition; no harness-only path exists.\n//   - The call to `@mysten/codegen.generateFromPackageSummary` is\n//     similarly behind a tagged service so unit tests can stub it\n//     without pulling in the heavyweight `@mysten/codegen` graph.\n//\n// Distilled-doc § \"Silent no-op from a downstream tool is a\n// failure\": after summary + render, we probe the output dir.\n// If it's empty, that's a `CodegenBindingsFailed` with a hint about\n// the common `Move.toml` `[addresses]` cause.\n\nimport { copyFile, mkdir, mkdtemp, readdir, readFile, rm } from 'node:fs/promises';\nimport { homedir, tmpdir } from 'node:os';\nimport { basename, dirname, join, relative, sep } from 'node:path';\n\nimport { generateFromPackageSummary } from '@mysten/codegen';\nimport { Context, Effect, FileSystem, Layer } from 'effect';\nimport { ChildProcess, ChildProcessSpawner } from 'effect/unstable/process';\n\nimport type { ContainerRuntime, ImageRef } from '../../contracts/container-runtime.ts';\nimport { ContainerRuntimeService } from '../../runtime/docker/service.ts';\nimport { capture } from '../../substrate/runtime/observability/subprocess-capture.ts';\nimport {\n\tshellQuote,\n\tsuiCliImageBuildContext,\n} from '../../substrate/runtime/sui-move-build/index.ts';\n\nimport { emitOne } from './emit.ts';\nimport { CodegenBindingsFailed } from './errors.ts';\nimport { NON_SENSITIVE_FILE_MODE } from './permissions.ts';\n\n// -----------------------------------------------------------------------------\n// Service seam — Move summary + codegen invocation\n// -----------------------------------------------------------------------------\n\n/** Result of `sui move summary` — opaque JSON the codegen generator\n *  consumes. We don't decode it here; `@mysten/codegen` owns the\n *  schema. */\nexport interface MoveSummary {\n\treadonly packageName: string;\n\treadonly sourcePath: string;\n\treadonly summaryPath?: string;\n\treadonly cleanupPath?: string;\n\treadonly summaryJson: unknown;\n}\n\nexport interface MoveSummaryInput {\n\treadonly packageName: string;\n\treadonly sourcePath: string;\n\treadonly buildImage?: ImageRef | null;\n}\n\n/** Shape of the Move summary runner. Implementations:\n *   - `dockerMoveSummary` — the `ContainerRuntime.runOneShot` path.\n *   - `hostMoveSummary` — the fallback host-binary path.\n *   - `stubMoveSummary` — used in tests (returns a fixture). */\nexport interface MoveSummaryRunner {\n\treadonly runSummary: (\n\t\tinput: MoveSummaryInput,\n\t) => Effect.Effect<MoveSummary, CodegenBindingsFailed>;\n}\n\nexport class MoveSummaryRunnerService extends Context.Service<\n\tMoveSummaryRunnerService,\n\tMoveSummaryRunner\n>()('@devstack-rewrite/orchestrator/MoveSummaryRunner') {}\n\n/** Shape of the `@mysten/codegen` invocation. Returns the rendered\n *  TS files (path → content) for one package. */\nexport interface MoveCodegen {\n\treadonly generate: (input: {\n\t\treadonly packageName: string;\n\t\treadonly sourcePath: string;\n\t\treadonly summary: MoveSummary;\n\t\treadonly mvrPlaceholder: string;\n\t\treadonly importExtension: '.ts' | '.js' | '';\n\t}) => Effect.Effect<\n\t\tReadonlyArray<{ readonly relPath: string; readonly content: string }>,\n\t\tCodegenBindingsFailed\n\t>;\n}\n\nexport class MoveCodegenService extends Context.Service<MoveCodegenService, MoveCodegen>()(\n\t'@devstack-rewrite/orchestrator/MoveCodegen',\n) {}\n\n// -----------------------------------------------------------------------------\n// Public entry — emit bindings for the local packages in a set of\n// PackageBindings contributions.\n// -----------------------------------------------------------------------------\n\nexport interface PackageBindings {\n\treadonly name: string;\n\treadonly packageId: string;\n\treadonly mvrPlaceholder: string;\n\treadonly sourcePath: string | null;\n\treadonly excluded: boolean;\n}\n\nexport interface EmitBindingsInput {\n\treadonly bindingsDir: string;\n\treadonly packages: ReadonlyArray<PackageBindings>;\n\treadonly importExtension?: '.ts' | '.js' | '';\n}\n\nexport interface EmitBindingsResult {\n\treadonly packagesEmitted: ReadonlyArray<string>;\n\treadonly packagesSkipped: ReadonlyArray<string>;\n\treadonly filesWritten: ReadonlyArray<string>;\n}\n\n/**\n * Walk the `PackageBindings` set, filter to LOCAL packages\n * (`sourcePath !== null`), run `sui move summary` + `@mysten/codegen`\n * for each, and write the rendered files into `bindingsDir/<name>/`.\n *\n * Serial within a cycle (distilled-doc § \"Serial within a cycle\":\n * shared Move build cache races). Per-package parallelism is unsafe.\n */\nexport const emitBindings = (\n\tinput: EmitBindingsInput,\n): Effect.Effect<\n\tEmitBindingsResult,\n\tCodegenBindingsFailed,\n\tFileSystem.FileSystem | MoveSummaryRunnerService | MoveCodegenService\n> =>\n\tEffect.gen(function* () {\n\t\tconst runner = yield* MoveSummaryRunnerService;\n\t\tconst generator = yield* MoveCodegenService;\n\t\tconst importExtension = input.importExtension ?? '.ts';\n\n\t\t// Dedup by package name. First-wins; distilled-doc § \"Duplicate\n\t\t// package names\": warn + skip the duplicate to avoid the HMR\n\t\t// re-emit storm.\n\t\tconst seen = new Set<string>();\n\t\tconst targets: Array<PackageBindings> = [];\n\t\tconst skipped: Array<string> = [];\n\t\tfor (const pkg of input.packages) {\n\t\t\tif (pkg.sourcePath === null) {\n\t\t\t\tskipped.push(pkg.name);\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tif (pkg.excluded) {\n\t\t\t\tskipped.push(pkg.name);\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tif (seen.has(pkg.name)) {\n\t\t\t\tyield* Effect.logWarning(\n\t\t\t\t\t`codegen.bindings: duplicate package name '${pkg.name}' — keeping ` +\n\t\t\t\t\t\t`first and skipping duplicate to avoid HMR re-emit storm. ` +\n\t\t\t\t\t\t`Rename one of the packages.`,\n\t\t\t\t);\n\t\t\t\tskipped.push(pkg.name);\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tseen.add(pkg.name);\n\t\t\ttargets.push(pkg);\n\t\t}\n\t\t// Deterministic order: lexicographic by package name.\n\t\ttargets.sort((a, b) => a.name.localeCompare(b.name));\n\n\t\tconst emitted: Array<string> = [];\n\t\tconst filesWritten: Array<string> = [];\n\t\tfor (const pkg of targets) {\n\t\t\t// sourcePath is non-null per the filter above. Narrow.\n\t\t\tif (pkg.sourcePath === null) continue;\n\t\t\tconst summary = yield* runner.runSummary({\n\t\t\t\tpackageName: pkg.name,\n\t\t\t\tsourcePath: pkg.sourcePath,\n\t\t\t});\n\t\t\tconst files = yield* generator.generate({\n\t\t\t\tpackageName: pkg.name,\n\t\t\t\tsourcePath: pkg.sourcePath,\n\t\t\t\tsummary,\n\t\t\t\tmvrPlaceholder: pkg.mvrPlaceholder,\n\t\t\t\timportExtension,\n\t\t\t});\n\t\t\t// Post-emit probe — silent no-op detection.\n\t\t\tif (files.length === 0) {\n\t\t\t\treturn yield* Effect.fail(\n\t\t\t\t\tnew CodegenBindingsFailed({\n\t\t\t\t\t\tpackage: pkg.name,\n\t\t\t\t\t\tsourcePath: pkg.sourcePath,\n\t\t\t\t\t\treason: 'no-output',\n\t\t\t\t\t\thint:\n\t\t\t\t\t\t\t'The Move codegen generator produced no files. This is ' +\n\t\t\t\t\t\t\t'usually caused by a missing `[addresses]` block in the ' +\n\t\t\t\t\t\t\t\"package's Move.toml, or a non-published address mapping.\",\n\t\t\t\t\t}),\n\t\t\t\t);\n\t\t\t}\n\t\t\tfor (const f of files) {\n\t\t\t\tif (f.relPath.includes('..') || f.relPath.startsWith('/')) {\n\t\t\t\t\treturn yield* Effect.fail(\n\t\t\t\t\t\tnew CodegenBindingsFailed({\n\t\t\t\t\t\t\tpackage: pkg.name,\n\t\t\t\t\t\t\tsourcePath: pkg.sourcePath,\n\t\t\t\t\t\t\treason: 'write-failed',\n\t\t\t\t\t\t\tcause: new Error(`generated binding path escapes output dir: ${f.relPath}`),\n\t\t\t\t\t\t}),\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\tconst abs = joinPath(input.bindingsDir, f.relPath);\n\t\t\t\tconst outcome = yield* emitOne({\n\t\t\t\t\tpath: abs,\n\t\t\t\t\tcontent: stabilizeGeneratedBindingContent(f.content),\n\t\t\t\t\tmode: NON_SENSITIVE_FILE_MODE,\n\t\t\t\t}).pipe(\n\t\t\t\t\tEffect.mapError(\n\t\t\t\t\t\t(cause) =>\n\t\t\t\t\t\t\tnew CodegenBindingsFailed({\n\t\t\t\t\t\t\t\tpackage: pkg.name,\n\t\t\t\t\t\t\t\tsourcePath: pkg.sourcePath!,\n\t\t\t\t\t\t\t\treason: 'write-failed',\n\t\t\t\t\t\t\t\tcause,\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t),\n\t\t\t\t);\n\t\t\t\tif (outcome.outcome !== 'unchanged') {\n\t\t\t\t\tfilesWritten.push(abs);\n\t\t\t\t}\n\t\t\t}\n\t\t\temitted.push(pkg.name);\n\t\t}\n\n\t\treturn {\n\t\t\tpackagesEmitted: emitted,\n\t\t\tpackagesSkipped: skipped,\n\t\t\tfilesWritten,\n\t\t};\n\t}).pipe(\n\t\tEffect.withSpan('codegen.emitBindings', {\n\t\t\tattributes: { 'codegen.bindingsDir': input.bindingsDir },\n\t\t}),\n\t);\n\n// -----------------------------------------------------------------------------\n// Stub implementations for tests\n// -----------------------------------------------------------------------------\n\n/** Stub runner — returns a synthetic summary. Used in unit tests\n *  to exercise the bindings pipeline without a real `sui` binary. */\nexport const stubMoveSummaryRunner = (\n\tsummaryFor: (sourcePath: string) => MoveSummary,\n): MoveSummaryRunner => ({\n\trunSummary: ({ sourcePath }) => Effect.succeed(summaryFor(sourcePath)),\n});\n\n/** Stub generator — returns a synthetic file set. Used in unit\n *  tests to exercise the bindings pipeline without pulling in the\n *  heavyweight `@mysten/codegen` graph. */\nexport const stubMoveCodegen = (\n\tfiles: (\n\t\tinput: Parameters<MoveCodegen['generate']>[0],\n\t) => ReadonlyArray<{ readonly relPath: string; readonly content: string }>,\n): MoveCodegen => ({\n\tgenerate: (input) => Effect.succeed(files(input)),\n});\n\n// -----------------------------------------------------------------------------\n// Production implementations\n// -----------------------------------------------------------------------------\n\nexport const layerDockerMoveSummaryRunner: Layer.Layer<\n\tMoveSummaryRunnerService,\n\tnever,\n\tContainerRuntimeService\n> = Layer.effect(\n\tMoveSummaryRunnerService,\n\tEffect.gen(function* () {\n\t\tconst runtime: ContainerRuntime = yield* ContainerRuntimeService;\n\t\treturn MoveSummaryRunnerService.of({\n\t\t\trunSummary: (input) => runSummaryViaDocker(runtime, input),\n\t\t});\n\t}),\n);\n\nexport const layerHostMoveSummaryRunner: Layer.Layer<\n\tMoveSummaryRunnerService,\n\tnever,\n\tChildProcessSpawner.ChildProcessSpawner\n> = Layer.effect(\n\tMoveSummaryRunnerService,\n\tEffect.gen(function* () {\n\t\tconst spawner = yield* ChildProcessSpawner.ChildProcessSpawner;\n\t\treturn MoveSummaryRunnerService.of({\n\t\t\trunSummary: ({ packageName, sourcePath }) =>\n\t\t\t\tEffect.gen(function* () {\n\t\t\t\t\tconst scratchDir = yield* Effect.tryPromise({\n\t\t\t\t\t\ttry: () => mkdtemp(join(tmpdir(), 'devstack-move-summary-')),\n\t\t\t\t\t\tcatch: (cause) =>\n\t\t\t\t\t\t\tnew CodegenBindingsFailed({\n\t\t\t\t\t\t\t\tpackage: packageName,\n\t\t\t\t\t\t\t\tsourcePath,\n\t\t\t\t\t\t\t\treason: 'summary-failed',\n\t\t\t\t\t\t\t\thint: 'Unable to create a temporary directory for Move summary output.',\n\t\t\t\t\t\t\t\tcause,\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t});\n\t\t\t\t\tconst summaryPath = join(scratchDir, 'package');\n\t\t\t\t\tconst cleanupScratch = Effect.promise(() =>\n\t\t\t\t\t\trm(scratchDir, { recursive: true, force: true }),\n\t\t\t\t\t).pipe(Effect.ignore);\n\t\t\t\t\tconst result = yield* Effect.gen(function* () {\n\t\t\t\t\t\tyield* Effect.tryPromise({\n\t\t\t\t\t\t\ttry: async () => {\n\t\t\t\t\t\t\t\tawait mkdir(summaryPath, { recursive: true });\n\t\t\t\t\t\t\t\tawait copyFile(join(sourcePath, 'Move.toml'), join(summaryPath, 'Move.toml'));\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\tcatch: (cause) =>\n\t\t\t\t\t\t\t\tnew CodegenBindingsFailed({\n\t\t\t\t\t\t\t\t\tpackage: packageName,\n\t\t\t\t\t\t\t\t\tsourcePath,\n\t\t\t\t\t\t\t\t\treason: 'summary-failed',\n\t\t\t\t\t\t\t\t\thint: 'Unable to prepare a temporary Move summary package directory.',\n\t\t\t\t\t\t\t\t\tcause,\n\t\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t});\n\t\t\t\t\t\tconst cmd = ChildProcess.make(\n\t\t\t\t\t\t\t'sui',\n\t\t\t\t\t\t\t[\n\t\t\t\t\t\t\t\t'move',\n\t\t\t\t\t\t\t\t'summary',\n\t\t\t\t\t\t\t\t'--path',\n\t\t\t\t\t\t\t\t'.',\n\t\t\t\t\t\t\t\t'--install-dir',\n\t\t\t\t\t\t\t\tjoin(scratchDir, 'install'),\n\t\t\t\t\t\t\t\t'--output-directory',\n\t\t\t\t\t\t\t\tjoin(summaryPath, 'package_summaries'),\n\t\t\t\t\t\t\t],\n\t\t\t\t\t\t\t{ cwd: sourcePath },\n\t\t\t\t\t\t);\n\t\t\t\t\t\treturn yield* capture(spawner, cmd, {\n\t\t\t\t\t\t\top: `sui move summary (${sourcePath})`,\n\t\t\t\t\t\t\tnonZeroIsFailure: true,\n\t\t\t\t\t\t\tstdoutTruncate: Infinity,\n\t\t\t\t\t\t\tstderrTruncate: 4_000,\n\t\t\t\t\t\t}).pipe(\n\t\t\t\t\t\t\tEffect.mapError(\n\t\t\t\t\t\t\t\t(cause) =>\n\t\t\t\t\t\t\t\t\tnew CodegenBindingsFailed({\n\t\t\t\t\t\t\t\t\t\tpackage: packageName,\n\t\t\t\t\t\t\t\t\t\tsourcePath,\n\t\t\t\t\t\t\t\t\t\treason: 'summary-failed',\n\t\t\t\t\t\t\t\t\t\thint: 'Install the Sui CLI and ensure this Move package can run `sui move summary`.',\n\t\t\t\t\t\t\t\t\t\tcause,\n\t\t\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t\t),\n\t\t\t\t\t\t);\n\t\t\t\t\t}).pipe(Effect.tapError(() => cleanupScratch));\n\t\t\t\t\treturn {\n\t\t\t\t\t\tpackageName,\n\t\t\t\t\t\tsourcePath,\n\t\t\t\t\t\tsummaryPath,\n\t\t\t\t\t\tcleanupPath: scratchDir,\n\t\t\t\t\t\tsummaryJson: parseSummaryStdout(result.stdout),\n\t\t\t\t\t};\n\t\t\t\t}),\n\t\t});\n\t}),\n);\n\nconst runSummaryViaDocker = (\n\truntime: ContainerRuntime,\n\tinput: MoveSummaryInput,\n): Effect.Effect<MoveSummary, CodegenBindingsFailed> =>\n\tEffect.scoped(\n\t\tEffect.gen(function* () {\n\t\t\tconst scratchDir = yield* makeSummaryScratch(input);\n\t\t\tconst summaryPath = join(scratchDir, 'package');\n\t\t\tconst cleanupScratch = Effect.promise(() =>\n\t\t\t\trm(scratchDir, { recursive: true, force: true }),\n\t\t\t).pipe(Effect.ignore);\n\t\t\tconst result = yield* Effect.gen(function* () {\n\t\t\t\tyield* prepareSummaryPackage(summaryPath, input);\n\t\t\t\tconst image = input.buildImage ?? (yield* resolveDefaultSummaryImage(runtime, input));\n\t\t\t\tconst moveHome = join(homedir(), '.move');\n\t\t\t\tyield* ensureMoveHome(moveHome, input);\n\t\t\t\tconst packageRoot = dirname(input.sourcePath);\n\t\t\t\tconst packageDir = basename(input.sourcePath);\n\t\t\t\tconst hostUid = typeof process.getuid === 'function' ? process.getuid() : 0;\n\t\t\t\tconst hostGid = typeof process.getgid === 'function' ? process.getgid() : 0;\n\t\t\t\tconst command = [\n\t\t\t\t\t'set -e',\n\t\t\t\t\t'cleanup_summary() { status=$?; ' +\n\t\t\t\t\t\t'chmod -R a+rwX /summary 2>/dev/null || true; ' +\n\t\t\t\t\t\t`chown -R ${hostUid}:${hostGid} /summary 2>/dev/null || true; ` +\n\t\t\t\t\t\t'exit \"$status\"; }',\n\t\t\t\t\t'trap cleanup_summary EXIT',\n\t\t\t\t\t'mkdir -p /summary/package_summaries',\n\t\t\t\t\t`sui move summary --path /workspace/${shellQuote(packageDir)} ` +\n\t\t\t\t\t\t'--install-dir /tmp/devstack-move-summary-install ' +\n\t\t\t\t\t\t'--output-directory /summary/package_summaries',\n\t\t\t\t].join('; ');\n\t\t\t\tconst run = yield* runtime\n\t\t\t\t\t.runOneShot({\n\t\t\t\t\t\timage,\n\t\t\t\t\t\tentrypoint: 'sh',\n\t\t\t\t\t\targv: ['-c', command],\n\t\t\t\t\t\tmounts: [\n\t\t\t\t\t\t\t{ source: packageRoot, target: '/workspace' },\n\t\t\t\t\t\t\t{ source: summaryPath, target: '/summary' },\n\t\t\t\t\t\t\t{ source: moveHome, target: '/root/.move' },\n\t\t\t\t\t\t],\n\t\t\t\t\t\ttimeoutMillis: 5 * 60_000,\n\t\t\t\t\t})\n\t\t\t\t\t.pipe(\n\t\t\t\t\t\tEffect.mapError(\n\t\t\t\t\t\t\t(cause) =>\n\t\t\t\t\t\t\t\tnew CodegenBindingsFailed({\n\t\t\t\t\t\t\t\t\tpackage: input.packageName,\n\t\t\t\t\t\t\t\t\tsourcePath: input.sourcePath,\n\t\t\t\t\t\t\t\t\treason: 'summary-failed',\n\t\t\t\t\t\t\t\t\thint: 'Docker runtime failed while running `sui move summary` for bindings codegen.',\n\t\t\t\t\t\t\t\t\tcause,\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\tif (run.exitCode !== 0) {\n\t\t\t\t\treturn yield* Effect.fail(\n\t\t\t\t\t\tnew CodegenBindingsFailed({\n\t\t\t\t\t\t\tpackage: input.packageName,\n\t\t\t\t\t\t\tsourcePath: input.sourcePath,\n\t\t\t\t\t\t\treason: 'summary-failed',\n\t\t\t\t\t\t\thint:\n\t\t\t\t\t\t\t\t`sui move summary exited ${run.exitCode}. ` +\n\t\t\t\t\t\t\t\t`stderr: ${run.stderr || '(empty)'}; stdout tail: ${\n\t\t\t\t\t\t\t\t\trun.stdout.slice(-400) || '(empty)'\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\t}\n\t\t\t\treturn run;\n\t\t\t}).pipe(Effect.tapError(() => cleanupScratch));\n\t\t\treturn {\n\t\t\t\tpackageName: input.packageName,\n\t\t\t\tsourcePath: input.sourcePath,\n\t\t\t\tsummaryPath,\n\t\t\t\tcleanupPath: scratchDir,\n\t\t\t\tsummaryJson: parseSummaryStdout(result.stdout),\n\t\t\t};\n\t\t}),\n\t);\n\nconst makeSummaryScratch = (\n\tinput: MoveSummaryInput,\n): Effect.Effect<string, CodegenBindingsFailed> =>\n\tEffect.tryPromise({\n\t\ttry: () => mkdtemp(join(tmpdir(), 'devstack-move-summary-')),\n\t\tcatch: (cause) =>\n\t\t\tnew CodegenBindingsFailed({\n\t\t\t\tpackage: input.packageName,\n\t\t\t\tsourcePath: input.sourcePath,\n\t\t\t\treason: 'summary-failed',\n\t\t\t\thint: 'Unable to create a temporary directory for Move summary output.',\n\t\t\t\tcause,\n\t\t\t}),\n\t});\n\nconst prepareSummaryPackage = (\n\tsummaryPath: string,\n\tinput: MoveSummaryInput,\n): Effect.Effect<void, CodegenBindingsFailed> =>\n\tEffect.tryPromise({\n\t\ttry: async () => {\n\t\t\tawait mkdir(summaryPath, { recursive: true });\n\t\t\tawait copyFile(join(input.sourcePath, 'Move.toml'), join(summaryPath, 'Move.toml'));\n\t\t},\n\t\tcatch: (cause) =>\n\t\t\tnew CodegenBindingsFailed({\n\t\t\t\tpackage: input.packageName,\n\t\t\t\tsourcePath: input.sourcePath,\n\t\t\t\treason: 'summary-failed',\n\t\t\t\thint: 'Unable to prepare a temporary Move summary package directory.',\n\t\t\t\tcause,\n\t\t\t}),\n\t});\n\nconst resolveDefaultSummaryImage = (\n\truntime: ContainerRuntime,\n\tinput: MoveSummaryInput,\n): Effect.Effect<ImageRef, CodegenBindingsFailed> =>\n\truntime.ensureImage(suiCliImageBuildContext()).pipe(\n\t\tEffect.mapError(\n\t\t\t(cause) =>\n\t\t\t\tnew CodegenBindingsFailed({\n\t\t\t\t\tpackage: input.packageName,\n\t\t\t\t\tsourcePath: input.sourcePath,\n\t\t\t\t\treason: 'summary-failed',\n\t\t\t\t\thint: 'Unable to resolve the Sui CLI container image for Move bindings codegen.',\n\t\t\t\t\tcause,\n\t\t\t\t}),\n\t\t),\n\t);\n\nconst ensureMoveHome = (\n\tmoveHome: string,\n\tinput: MoveSummaryInput,\n): Effect.Effect<void, CodegenBindingsFailed> =>\n\tEffect.tryPromise({\n\t\ttry: () => mkdir(moveHome, { recursive: true }),\n\t\tcatch: (cause) =>\n\t\t\tnew CodegenBindingsFailed({\n\t\t\t\tpackage: input.packageName,\n\t\t\t\tsourcePath: input.sourcePath,\n\t\t\t\treason: 'summary-failed',\n\t\t\t\thint: `Unable to create Move cache mount source \"${moveHome}\".`,\n\t\t\t\tcause,\n\t\t\t}),\n\t}).pipe(Effect.asVoid);\n\nexport const layerMystenMoveCodegen: Layer.Layer<MoveCodegenService> = Layer.succeed(\n\tMoveCodegenService,\n\tMoveCodegenService.of({\n\t\tgenerate: (input) =>\n\t\t\tEffect.tryPromise({\n\t\t\t\ttry: async () => {\n\t\t\t\t\tconst tmp = await mkdtemp(join(tmpdir(), 'devstack-move-codegen-'));\n\t\t\t\t\ttry {\n\t\t\t\t\t\tawait generateFromPackageSummary({\n\t\t\t\t\t\t\tpackage: {\n\t\t\t\t\t\t\t\tpath: input.summary.summaryPath ?? input.sourcePath,\n\t\t\t\t\t\t\t\tpackage: input.mvrPlaceholder,\n\t\t\t\t\t\t\t\tpackageName: input.packageName,\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\tprune: true,\n\t\t\t\t\t\t\toutputDir: tmp,\n\t\t\t\t\t\t\timportExtension: input.importExtension,\n\t\t\t\t\t\t});\n\t\t\t\t\t\treturn await collectGeneratedFiles(tmp);\n\t\t\t\t\t} finally {\n\t\t\t\t\t\tawait rm(tmp, { recursive: true, force: true });\n\t\t\t\t\t\tif (input.summary.cleanupPath !== undefined) {\n\t\t\t\t\t\t\tawait rm(input.summary.cleanupPath, { recursive: true, force: true });\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t},\n\t\t\t\tcatch: (cause) =>\n\t\t\t\t\tnew CodegenBindingsFailed({\n\t\t\t\t\t\tpackage: input.packageName,\n\t\t\t\t\t\tsourcePath: input.sourcePath,\n\t\t\t\t\t\treason: 'render-failed',\n\t\t\t\t\t\tcause,\n\t\t\t\t\t}),\n\t\t\t}),\n\t}),\n);\n\n// -----------------------------------------------------------------------------\n// Local helpers — keep the module dep-free of Path.Path so the\n// caller can compose without an extra service yield.\n// -----------------------------------------------------------------------------\n\nconst joinPath = (...parts: ReadonlyArray<string>): string =>\n\tparts.map((p, i) => (i === 0 ? p.replace(/\\/+$/, '') : p.replace(/^\\/+|\\/+$/g, ''))).join('/');\n\nconst parseSummaryStdout = (stdout: string): unknown => {\n\tconst trimmed = stdout.trim();\n\tif (trimmed.length === 0) return null;\n\ttry {\n\t\treturn JSON.parse(trimmed) as unknown;\n\t} catch {\n\t\treturn trimmed;\n\t}\n};\n\nconst generatedBcsFactoryPattern =\n\t/export function ([A-Za-z_$][\\w$]*)<((?:[^<>]|<[^<>]*>)+)>\\((\\.\\.\\.typeParameters: \\[[\\s\\S]*?\\n\\])\\) \\{\\n(\\s*)return new (MoveStruct|MoveEnum|MoveTuple)\\(/g;\n\nconst bcsFactoryReturnType = (constructorName: string): string => {\n\tif (constructorName === 'MoveEnum') {\n\t\treturn 'MoveEnum<any, string>';\n\t}\n\tif (constructorName === 'MoveTuple') {\n\t\treturn 'MoveTuple<any, string>';\n\t}\n\treturn 'MoveStruct<any, string>';\n};\n\nconst stabilizeGeneratedBindingContent = (content: string): string =>\n\tcontent.replace(\n\t\tgeneratedBcsFactoryPattern,\n\t\t(_match, name, generics, parameters, indent, constructorName: string) =>\n\t\t\t`export function ${name}<${generics}>(${parameters}): ${bcsFactoryReturnType(\n\t\t\t\tconstructorName,\n\t\t\t)} {\\n${indent}return new ${constructorName}(`,\n\t);\n\nconst collectGeneratedFiles = async (\n\troot: string,\n): Promise<ReadonlyArray<{ readonly relPath: string; readonly content: string }>> => {\n\tconst out: Array<{ readonly relPath: string; readonly content: string }> = [];\n\tconst walk = async (dir: string): Promise<void> => {\n\t\tconst entries = await readdir(dir, { withFileTypes: true });\n\t\tfor (const entry of entries) {\n\t\t\tconst abs = join(dir, entry.name);\n\t\t\tif (entry.isDirectory()) {\n\t\t\t\tawait walk(abs);\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tif (!entry.isFile()) continue;\n\t\t\tconst relPath = relative(root, abs).split(sep).join('/');\n\t\t\tout.push({ relPath, content: await readFile(abs, 'utf8') });\n\t\t}\n\t};\n\tawait walk(root);\n\tout.sort((a, b) => a.relPath.localeCompare(b.relPath));\n\treturn out;\n};\n"],"mappings":"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"}
+{"version":3,"file":"bindings.mjs","names":[],"sources":["../../../src/orchestrators/codegen/bindings.ts"],"sourcesContent":["// Move-package bindings emission.\n//\n// Distilled-doc § \"Move-to-TS bindings: per-published-package typed\n// client modules produced from each local Move package's summary.\"\n// Drives `@mysten/codegen`'s `generateFromPackageSummary` against\n// `MoveSummary` JSON contributed by a plugin-owned\n// `MoveSummaryRunnerService`.\n//\n// sourcePath-known-vs-unknown discipline:\n//   - `Package` plugin's `Codegenable` emits a `PackageBindings`\n//     shape with `sourcePath: string | null`.\n//   - The bindings emitter filters to `sourcePath !== null` (i.e.\n//     LOCAL packages); `KnownPackage` entries (`sourcePath: null`)\n//     are skipped — their bindings come from the SDK or MVR.\n//\n// Architecture seam:\n//   - `MoveSummaryRunnerService` is contributed by a plugin (the\n//     sui plugin ships `layerSuiMoveSummaryRunnerDocker` /\n//     `layerSuiMoveSummaryRunnerHost`). The codegen orchestrator\n//     consumes only the abstract service — it never names the Sui\n//     CLI binary or container image (architecture: \"Orchestrator\n//     boundaries — never names a service\").\n//   - The call to `@mysten/codegen.generateFromPackageSummary` is\n//     similarly behind a tagged service so unit tests can stub it\n//     without pulling in the heavyweight `@mysten/codegen` graph.\n//\n// Distilled-doc § \"Silent no-op from a downstream tool is a\n// failure\": after summary + render, we probe the output dir.\n// If it's empty, that's a `CodegenBindingsFailed` with a hint about\n// the common `Move.toml` `[addresses]` cause.\n\nimport { mkdtemp, readdir, readFile, rm } from 'node:fs/promises';\nimport { tmpdir } from 'node:os';\nimport { join, relative, sep } from 'node:path';\n\nimport { generateFromPackageSummary } from '@mysten/codegen';\nimport { Context, Effect, FileSystem, Layer } from 'effect';\n\nimport type { ImageRef } from '../../contracts/container-runtime.ts';\n\nimport { emitOne } from './emit.ts';\nimport { CodegenBindingsFailed } from './errors.ts';\nimport { NON_SENSITIVE_DIR_MODE, NON_SENSITIVE_FILE_MODE } from './permissions.ts';\n\n// -----------------------------------------------------------------------------\n// Service seam — Move summary + codegen invocation\n// -----------------------------------------------------------------------------\n\n/** Result of `sui move summary` — opaque JSON the codegen generator\n *  consumes. We don't decode it here; `@mysten/codegen` owns the\n *  schema. */\nexport interface MoveSummary {\n\treadonly packageName: string;\n\treadonly sourcePath: string;\n\treadonly summaryPath?: string;\n\treadonly cleanupPath?: string;\n\treadonly summaryJson: unknown;\n}\n\nexport interface MoveSummaryInput {\n\treadonly packageName: string;\n\treadonly sourcePath: string;\n\treadonly buildImage?: ImageRef | null;\n}\n\n/** Shape of the Move summary runner. Implementations live in\n *  plugin packages (e.g. `plugins/sui/move-summary-runner.ts`\n *  exports `layerSuiMoveSummaryRunnerDocker` and\n *  `layerSuiMoveSummaryRunnerHost`); tests use `stubMoveSummaryRunner`\n *  below. */\nexport interface MoveSummaryRunner {\n\treadonly runSummary: (\n\t\tinput: MoveSummaryInput,\n\t) => Effect.Effect<MoveSummary, CodegenBindingsFailed>;\n}\n\nexport class MoveSummaryRunnerService extends Context.Service<\n\tMoveSummaryRunnerService,\n\tMoveSummaryRunner\n>()('@devstack/orchestrator/MoveSummaryRunner') {}\n\n/** Shape of the `@mysten/codegen` invocation. Returns the rendered\n *  TS files (path → content) for one package. */\nexport interface MoveCodegen {\n\treadonly generate: (input: {\n\t\treadonly packageName: string;\n\t\treadonly sourcePath: string;\n\t\treadonly summary: MoveSummary;\n\t\treadonly mvrPlaceholder: string;\n\t\treadonly importExtension: '.ts' | '.js' | '';\n\t}) => Effect.Effect<\n\t\tReadonlyArray<{ readonly relPath: string; readonly content: string }>,\n\t\tCodegenBindingsFailed\n\t>;\n}\n\nexport class MoveCodegenService extends Context.Service<MoveCodegenService, MoveCodegen>()(\n\t'@devstack/orchestrator/MoveCodegen',\n) {}\n\n// -----------------------------------------------------------------------------\n// Public entry — emit bindings for the local packages in a set of\n// PackageBindings contributions.\n// -----------------------------------------------------------------------------\n\nexport interface PackageBindings {\n\treadonly name: string;\n\treadonly packageId: string;\n\treadonly mvrPlaceholder: string;\n\treadonly sourcePath: string | null;\n\treadonly excluded: boolean;\n}\n\nexport interface EmitBindingsInput {\n\treadonly bindingsDir: string;\n\treadonly packages: ReadonlyArray<PackageBindings>;\n\treadonly importExtension?: '.ts' | '.js' | '';\n}\n\nexport interface EmitBindingsResult {\n\treadonly packagesEmitted: ReadonlyArray<string>;\n\treadonly packagesSkipped: ReadonlyArray<string>;\n\treadonly filesWritten: ReadonlyArray<string>;\n}\n\n/**\n * Walk the `PackageBindings` set, filter to LOCAL packages\n * (`sourcePath !== null`), run `sui move summary` + `@mysten/codegen`\n * for each, and write the rendered files into `bindingsDir/<name>/`.\n *\n * Serial within a cycle (distilled-doc § \"Serial within a cycle\":\n * shared Move build cache races). Per-package parallelism is unsafe.\n */\nexport const emitBindings = (\n\tinput: EmitBindingsInput,\n): Effect.Effect<\n\tEmitBindingsResult,\n\tCodegenBindingsFailed,\n\tFileSystem.FileSystem | MoveSummaryRunnerService | MoveCodegenService\n> =>\n\tEffect.gen(function* () {\n\t\tconst runner = yield* MoveSummaryRunnerService;\n\t\tconst generator = yield* MoveCodegenService;\n\t\tconst importExtension = input.importExtension ?? '.ts';\n\n\t\t// Dedup by package name. First-wins; distilled-doc § \"Duplicate\n\t\t// package names\": warn + skip the duplicate to avoid the HMR\n\t\t// re-emit storm.\n\t\tconst seen = new Set<string>();\n\t\tconst targets: Array<PackageBindings> = [];\n\t\tconst skipped: Array<string> = [];\n\t\tfor (const pkg of input.packages) {\n\t\t\tif (pkg.sourcePath === null) {\n\t\t\t\tskipped.push(pkg.name);\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tif (pkg.excluded) {\n\t\t\t\tskipped.push(pkg.name);\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tif (seen.has(pkg.name)) {\n\t\t\t\tyield* Effect.logWarning(\n\t\t\t\t\t`codegen.bindings: duplicate package name '${pkg.name}' — keeping ` +\n\t\t\t\t\t\t`first and skipping duplicate to avoid HMR re-emit storm. ` +\n\t\t\t\t\t\t`Rename one of the packages.`,\n\t\t\t\t);\n\t\t\t\tskipped.push(pkg.name);\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tseen.add(pkg.name);\n\t\t\ttargets.push(pkg);\n\t\t}\n\t\t// Deterministic order: lexicographic by package name.\n\t\ttargets.sort((a, b) => a.name.localeCompare(b.name));\n\n\t\tconst emitted: Array<string> = [];\n\t\tconst filesWritten: Array<string> = [];\n\t\tfor (const pkg of targets) {\n\t\t\t// sourcePath is non-null per the filter above. Narrow.\n\t\t\tif (pkg.sourcePath === null) continue;\n\t\t\tconst summary = yield* runner.runSummary({\n\t\t\t\tpackageName: pkg.name,\n\t\t\t\tsourcePath: pkg.sourcePath,\n\t\t\t});\n\t\t\tconst files = yield* generator.generate({\n\t\t\t\tpackageName: pkg.name,\n\t\t\t\tsourcePath: pkg.sourcePath,\n\t\t\t\tsummary,\n\t\t\t\tmvrPlaceholder: pkg.mvrPlaceholder,\n\t\t\t\timportExtension,\n\t\t\t});\n\t\t\t// Post-emit probe — silent no-op detection.\n\t\t\tif (files.length === 0) {\n\t\t\t\treturn yield* Effect.fail(\n\t\t\t\t\tnew CodegenBindingsFailed({\n\t\t\t\t\t\tpackage: pkg.name,\n\t\t\t\t\t\tsourcePath: pkg.sourcePath,\n\t\t\t\t\t\treason: 'no-output',\n\t\t\t\t\t\thint:\n\t\t\t\t\t\t\t'The Move codegen generator produced no files. This is ' +\n\t\t\t\t\t\t\t'usually caused by a missing `[addresses]` block in the ' +\n\t\t\t\t\t\t\t\"package's Move.toml, or a non-published address mapping.\",\n\t\t\t\t\t}),\n\t\t\t\t);\n\t\t\t}\n\t\t\tfor (const f of files) {\n\t\t\t\tif (f.relPath.includes('..') || f.relPath.startsWith('/')) {\n\t\t\t\t\treturn yield* Effect.fail(\n\t\t\t\t\t\tnew CodegenBindingsFailed({\n\t\t\t\t\t\t\tpackage: pkg.name,\n\t\t\t\t\t\t\tsourcePath: pkg.sourcePath,\n\t\t\t\t\t\t\treason: 'write-failed',\n\t\t\t\t\t\t\tcause: new Error(`generated binding path escapes output dir: ${f.relPath}`),\n\t\t\t\t\t\t}),\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\tconst abs = joinPath(input.bindingsDir, f.relPath);\n\t\t\t\tconst outcome = yield* emitOne({\n\t\t\t\t\tpath: abs,\n\t\t\t\t\tcontent: stabilizeGeneratedBindingContent(f.content),\n\t\t\t\t\tmode: NON_SENSITIVE_FILE_MODE,\n\t\t\t\t\tparentMode: NON_SENSITIVE_DIR_MODE,\n\t\t\t\t}).pipe(\n\t\t\t\t\tEffect.mapError(\n\t\t\t\t\t\t(cause) =>\n\t\t\t\t\t\t\tnew CodegenBindingsFailed({\n\t\t\t\t\t\t\t\tpackage: pkg.name,\n\t\t\t\t\t\t\t\tsourcePath: pkg.sourcePath!,\n\t\t\t\t\t\t\t\treason: 'write-failed',\n\t\t\t\t\t\t\t\tcause,\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t),\n\t\t\t\t);\n\t\t\t\tif (outcome.outcome !== 'unchanged') {\n\t\t\t\t\tfilesWritten.push(abs);\n\t\t\t\t}\n\t\t\t}\n\t\t\temitted.push(pkg.name);\n\t\t}\n\n\t\treturn {\n\t\t\tpackagesEmitted: emitted,\n\t\t\tpackagesSkipped: skipped,\n\t\t\tfilesWritten,\n\t\t};\n\t}).pipe(\n\t\tEffect.withSpan('codegen.emitBindings', {\n\t\t\tattributes: { 'codegen.bindingsDir': input.bindingsDir },\n\t\t}),\n\t);\n\n// -----------------------------------------------------------------------------\n// Stub implementations for tests\n// -----------------------------------------------------------------------------\n\n/** Stub runner — returns a synthetic summary. Used in unit tests\n *  to exercise the bindings pipeline without a real `sui` binary. */\nexport const stubMoveSummaryRunner = (\n\tsummaryFor: (sourcePath: string) => MoveSummary,\n): MoveSummaryRunner => ({\n\trunSummary: ({ sourcePath }) => Effect.succeed(summaryFor(sourcePath)),\n});\n\n/** Stub generator — returns a synthetic file set. Used in unit\n *  tests to exercise the bindings pipeline without pulling in the\n *  heavyweight `@mysten/codegen` graph. */\nexport const stubMoveCodegen = (\n\tfiles: (\n\t\tinput: Parameters<MoveCodegen['generate']>[0],\n\t) => ReadonlyArray<{ readonly relPath: string; readonly content: string }>,\n): MoveCodegen => ({\n\tgenerate: (input) => Effect.succeed(files(input)),\n});\n\n// -----------------------------------------------------------------------------\n// Production implementations\n// -----------------------------------------------------------------------------\n//\n// Layer factories for `MoveSummaryRunnerService` are plugin-owned —\n// they live in `src/plugins/sui/move-summary-runner.ts`. The codegen\n// orchestrator does not name the Sui CLI binary or container image;\n// per \"Orchestrator boundaries — never names a service\", any plugin\n// that can produce `MoveSummary` JSON may contribute a runner Layer.\n\nexport const layerMystenMoveCodegen: Layer.Layer<MoveCodegenService> = Layer.succeed(\n\tMoveCodegenService,\n\tMoveCodegenService.of({\n\t\tgenerate: (input) =>\n\t\t\tEffect.tryPromise({\n\t\t\t\ttry: async () => {\n\t\t\t\t\tconst tmp = await mkdtemp(join(tmpdir(), 'devstack-move-codegen-'));\n\t\t\t\t\ttry {\n\t\t\t\t\t\t// `sui move summary` keys each `package_summaries/<dir>`\n\t\t\t\t\t\t// subdirectory by the package's NAMED ADDRESS, not its\n\t\t\t\t\t\t// `[package].name`. These legitimately differ (the canonical\n\t\t\t\t\t\t// example is MoveStdlib, whose package name is \"MoveStdlib\"\n\t\t\t\t\t\t// but whose named address is \"std\"). `@mysten/codegen`'s\n\t\t\t\t\t\t// resolver matches the summary subdir by either (1) a single\n\t\t\t\t\t\t// `[addresses]` label or (2) the `packageName` — but it reads\n\t\t\t\t\t\t// the Move.toml at the path WE pass it (the summary scratch\n\t\t\t\t\t\t// dir), which has NO `[addresses]` table, so its label-based\n\t\t\t\t\t\t// path (1) is defeated and it falls back to (2). We pass the\n\t\t\t\t\t\t// symbolic localPackage() NAME as `packageName`, which is the\n\t\t\t\t\t\t// `[package].name`, NOT the named address — so codegen throws\n\t\t\t\t\t\t// \"Could not identify main package directory\" whenever the two\n\t\t\t\t\t\t// differ. Recover the correct subdir name here from the REAL\n\t\t\t\t\t\t// source Move.toml's `[addresses]` table (which devstack still\n\t\t\t\t\t\t// has at `input.sourcePath`), falling back to the name when the\n\t\t\t\t\t\t// source is unreadable or ambiguous (a no-op for the common\n\t\t\t\t\t\t// case where name == address).\n\t\t\t\t\t\tconst packageName =\n\t\t\t\t\t\t\t(await resolveSummaryDirName(input.sourcePath)) ?? input.packageName;\n\t\t\t\t\t\tawait generateFromPackageSummary({\n\t\t\t\t\t\t\tpackage: {\n\t\t\t\t\t\t\t\tpath: input.summary.summaryPath ?? input.sourcePath,\n\t\t\t\t\t\t\t\tpackage: input.mvrPlaceholder,\n\t\t\t\t\t\t\t\tpackageName,\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\tprune: true,\n\t\t\t\t\t\t\toutputDir: tmp,\n\t\t\t\t\t\t\timportExtension: input.importExtension,\n\t\t\t\t\t\t});\n\t\t\t\t\t\treturn await collectGeneratedFiles(tmp);\n\t\t\t\t\t} finally {\n\t\t\t\t\t\tawait rm(tmp, { recursive: true, force: true });\n\t\t\t\t\t\tif (input.summary.cleanupPath !== undefined) {\n\t\t\t\t\t\t\tawait rm(input.summary.cleanupPath, { recursive: true, force: true });\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t},\n\t\t\t\tcatch: (cause) =>\n\t\t\t\t\tnew CodegenBindingsFailed({\n\t\t\t\t\t\tpackage: input.packageName,\n\t\t\t\t\t\tsourcePath: input.sourcePath,\n\t\t\t\t\t\treason: 'render-failed',\n\t\t\t\t\t\tcause,\n\t\t\t\t\t}),\n\t\t\t}),\n\t}),\n);\n\n// -----------------------------------------------------------------------------\n// Local helpers — keep the module dep-free of Path.Path so the\n// caller can compose without an extra service yield.\n// -----------------------------------------------------------------------------\n\nconst joinPath = (...parts: ReadonlyArray<string>): string =>\n\tparts.map((p, i) => (i === 0 ? p.replace(/\\/+$/, '') : p.replace(/^\\/+|\\/+$/g, ''))).join('/');\n\n/**\n * Determine the `package_summaries/<dir>` subdirectory name for a local\n * Move package from its REAL source `Move.toml`. `sui move summary` keys\n * these subdirs by the NAMED ADDRESS (e.g. MoveStdlib → \"std\"), not the\n * `[package].name`, so when the two differ we must hand `@mysten/codegen`\n * the address label rather than the symbolic package name.\n *\n * Returns the single `[addresses]` label when the table has exactly one\n * entry (the overwhelmingly common case — and a no-op when name == address),\n * and `null` otherwise (unreadable Move.toml, no `[addresses]` table, or an\n * ambiguous multi-address table) so the caller can fall back to the package\n * name and preserve `@mysten/codegen`'s own resolution.\n *\n * Hand-parse rather than pull in a TOML dependency: the sibling Move-build\n * path already harvests `{ local = \"../x\" }` deps from Move.toml by regex\n * (`sui-move-build/index.ts`), and we only need the `[addresses]` section's\n * left-hand labels — never their values.\n */\nconst resolveSummaryDirName = async (sourcePath: string): Promise<string | null> => {\n\tlet toml: string;\n\ttry {\n\t\ttoml = await readFile(join(sourcePath, 'Move.toml'), 'utf8');\n\t} catch {\n\t\treturn null;\n\t}\n\tconst labels = parseAddressLabels(toml);\n\treturn labels.length === 1 ? labels[0]! : null;\n};\n\n/** Left-hand labels of the `[addresses]` table in a Move.toml. Scans from\n *  the `[addresses]` header to the next `[section]` header (or EOF) and\n *  collects each `name = \"...\"` key, ignoring blank/comment lines. */\nconst parseAddressLabels = (toml: string): ReadonlyArray<string> => {\n\tconst lines = toml.split(/\\r?\\n/);\n\tconst start = lines.findIndex((line) => /^\\s*\\[addresses\\]\\s*$/.test(line));\n\tif (start === -1) return [];\n\tconst labels: Array<string> = [];\n\tfor (const line of lines.slice(start + 1)) {\n\t\t// Next table header ends the `[addresses]` section.\n\t\tif (/^\\s*\\[/.test(line)) break;\n\t\tconst stripped = line.replace(/#.*$/, '').trim();\n\t\tif (stripped === '') continue;\n\t\tconst match = /^([A-Za-z_][\\w-]*)\\s*=/.exec(stripped);\n\t\tif (match) labels.push(match[1]!);\n\t}\n\treturn labels;\n};\n\nconst generatedBcsFactoryPattern =\n\t/export function ([A-Za-z_$][\\w$]*)<((?:[^<>]|<[^<>]*>)+)>\\((\\.\\.\\.typeParameters: \\[[\\s\\S]*?\\n\\])\\) \\{\\n(\\s*)return new (MoveStruct|MoveEnum|MoveTuple)\\(/g;\n\nconst bcsFactoryReturnType = (constructorName: string): string => {\n\tif (constructorName === 'MoveEnum') {\n\t\treturn 'MoveEnum<any, string>';\n\t}\n\tif (constructorName === 'MoveTuple') {\n\t\treturn 'MoveTuple<any, string>';\n\t}\n\treturn 'MoveStruct<any, string>';\n};\n\nconst stabilizeGeneratedBindingContent = (content: string): string =>\n\tcontent.replace(\n\t\tgeneratedBcsFactoryPattern,\n\t\t(_match, name, generics, parameters, indent, constructorName: string) =>\n\t\t\t`export function ${name}<${generics}>(${parameters}): ${bcsFactoryReturnType(\n\t\t\t\tconstructorName,\n\t\t\t)} {\\n${indent}return new ${constructorName}(`,\n\t);\n\nconst collectGeneratedFiles = async (\n\troot: string,\n): Promise<ReadonlyArray<{ readonly relPath: string; readonly content: string }>> => {\n\tconst out: Array<{ readonly relPath: string; readonly content: string }> = [];\n\tconst walk = async (dir: string): Promise<void> => {\n\t\tconst entries = await readdir(dir, { withFileTypes: true });\n\t\tfor (const entry of entries) {\n\t\t\tconst abs = join(dir, entry.name);\n\t\t\tif (entry.isDirectory()) {\n\t\t\t\tawait walk(abs);\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tif (!entry.isFile()) continue;\n\t\t\tconst relPath = relative(root, abs).split(sep).join('/');\n\t\t\tout.push({ relPath, content: await readFile(abs, 'utf8') });\n\t\t}\n\t};\n\tawait walk(root);\n\tout.sort((a, b) => a.relPath.localeCompare(b.relPath));\n\treturn out;\n};\n"],"mappings":"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"}

package/dist/orchestrators/codegen/emit.mjs

@@ -1,6 +1,7 @@
 import { atomicWriteFile } from "../../substrate/runtime/atomic-write.mjs";
 import { CodegenWriteFailed } from "./errors.mjs";
 import { Effect, FileSystem } from "effect";
+import { dirname } from "node:path";
 //#region src/orchestrators/codegen/emit.ts
 /**
 * Emit one file with idempotency. The mode is re-applied even on
@@ -10,6 +11,7 @@ import { Effect, FileSystem } from "effect";
 const emitOne = (input) => Effect.gen(function* () {
 	const fs = yield* FileSystem.FileSystem;
 	const bytes = new TextEncoder().encode(input.content);
+	if (input.parentMode !== void 0) yield* ensureParentDirectory(input.path, input.parentMode);
 	const existing = yield* fs.readFileString(input.path).pipe(Effect.match({
 		onSuccess: (text) => text,
 		onFailure: () => null
@@ -21,7 +23,10 @@ const emitOne = (input) => Effect.gen(function* () {
 			outcome: drifted ? "chmod-only" : "unchanged"
 		};
 	}
-	yield* atomicWriteFile(input.path, bytes, { mode: input.mode }).pipe(Effect.mapError((cause) => new CodegenWriteFailed({
+	yield* atomicWriteFile(input.path, bytes, {
+		mode: input.mode,
+		...input.parentMode === void 0 ? {} : { parentMode: input.parentMode }
+	}).pipe(Effect.mapError((cause) => new CodegenWriteFailed({
 		outputPath: input.path,
 		stage: cause.stage === "mkdir-parent" ? "mkdir-parent" : "write",
 		cause
@@ -50,6 +55,19 @@ const checkAndRestoreMode = (path, wantedMode) => Effect.gen(function* () {
 	})));
 	return true;
 });
+const ensureParentDirectory = (path, parentMode) => Effect.gen(function* () {
+	const fs = yield* FileSystem.FileSystem;
+	const parent = dirname(path);
+	yield* fs.makeDirectory(parent, {
+		recursive: true,
+		mode: parentMode
+	}).pipe(Effect.mapError((cause) => new CodegenWriteFailed({
+		outputPath: parent,
+		stage: "mkdir-parent",
+		cause
+	})));
+	yield* checkAndRestoreMode(parent, parentMode).pipe(Effect.asVoid);
+});
 //#endregion
 export { emitOne };
 

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

@@ -1 +1 @@
-{"version":3,"file":"emit.mjs","names":[],"sources":["../../../src/orchestrators/codegen/emit.ts"],"sourcesContent":["// File emission: per-file atomic write + idempotent no-touch.\n//\n// Distilled-doc § \"No-touch on no change\": when inputs are unchanged,\n// file mtimes do not move. This is load-bearing for dev-server HMR\n// quietness — Vite watchers fire on mtime, not content.\n//\n// Flow per file:\n//   1. Read existing file (best-effort). Decode as UTF-8 string.\n//   2. Compare to rendered content. If identical, restore mode bits\n//      (defensive — distilled-doc §\"sensitive-file permission drift\")\n//      and return WITHOUT touching the file.\n//   3. Otherwise atomic-write via the substrate's `atomicWriteFile`\n//      primitive: tempfile + fsync + rename. Apply mode.\n//\n// There is no cycle-level staging directory today. Each generated\n// file is promoted independently through the substrate atomic-write\n// primitive.\n\nimport { Effect, FileSystem } from 'effect';\n\nimport { atomicWriteFile } from '../../substrate/runtime/atomic-write.ts';\n\nimport { CodegenWriteFailed } from './errors.ts';\n\nexport interface EmitOneInput {\n\treadonly path: string;\n\treadonly content: string;\n\treadonly mode: number;\n}\n\nexport interface EmitOneResult {\n\treadonly path: string;\n\t/** `wrote` — content was different and we atomically wrote.\n\t *  `unchanged` — bytes matched, we skipped the write.\n\t *  `chmod-only` — bytes matched but mode bits drifted; we\n\t *  restored the mode but did not rewrite the file. */\n\treadonly outcome: 'wrote' | 'unchanged' | 'chmod-only';\n}\n\n/**\n * Emit one file with idempotency. The mode is re-applied even on\n * the no-write path to recover from manual chmods (distilled-doc\n * §\"sensitive-file permission drift\").\n */\nexport const emitOne = (\n\tinput: EmitOneInput,\n): Effect.Effect<EmitOneResult, CodegenWriteFailed, FileSystem.FileSystem> =>\n\tEffect.gen(function* () {\n\t\tconst fs = yield* FileSystem.FileSystem;\n\t\tconst bytes = new TextEncoder().encode(input.content);\n\n\t\t// 1. Best-effort read of existing content for the no-touch\n\t\t//    short-circuit. A missing file collapses to \"no existing\n\t\t//    bytes\" → write. Any other error also collapses to write\n\t\t//    (atomic-write will report the real failure).\n\t\tconst existing = yield* fs.readFileString(input.path).pipe(\n\t\t\tEffect.match({\n\t\t\t\tonSuccess: (text) => text,\n\t\t\t\tonFailure: () => null,\n\t\t\t}),\n\t\t);\n\n\t\tif (existing !== null && existing === input.content) {\n\t\t\t// Content matches — re-apply mode to fix drift, but don't\n\t\t\t// touch the file's mtime. `chmod` updates the inode's\n\t\t\t// `ctime` only.\n\t\t\tconst drifted = yield* checkAndRestoreMode(input.path, input.mode);\n\t\t\treturn {\n\t\t\t\tpath: input.path,\n\t\t\t\toutcome: drifted ? ('chmod-only' as const) : ('unchanged' as const),\n\t\t\t};\n\t\t}\n\n\t\t// 2. Bytes differ (or file missing) — atomic write. The\n\t\t//    substrate's `atomicWriteFile` owns mkdir-parent +\n\t\t//    tempfile + fsync + rename. Mode is applied at create\n\t\t//    time via the `mode` open flag.\n\t\tyield* atomicWriteFile(input.path, bytes, { mode: input.mode }).pipe(\n\t\t\tEffect.mapError(\n\t\t\t\t(cause) =>\n\t\t\t\t\tnew CodegenWriteFailed({\n\t\t\t\t\t\toutputPath: input.path,\n\t\t\t\t\t\tstage: cause.stage === 'mkdir-parent' ? 'mkdir-parent' : 'write',\n\t\t\t\t\t\tcause,\n\t\t\t\t\t}),\n\t\t\t),\n\t\t);\n\t\treturn { path: input.path, outcome: 'wrote' as const };\n\t}).pipe(\n\t\tEffect.withSpan('codegen.emitOne', {\n\t\t\tattributes: { 'codegen.path': input.path },\n\t\t}),\n\t);\n\n/**\n * Check the file's current mode and restore it if drifted. Returns\n * true if a chmod was performed.\n */\nconst checkAndRestoreMode = (\n\tpath: string,\n\twantedMode: number,\n): Effect.Effect<boolean, CodegenWriteFailed, FileSystem.FileSystem> =>\n\tEffect.gen(function* () {\n\t\tconst fs = yield* FileSystem.FileSystem;\n\t\tconst stat = yield* fs.stat(path).pipe(\n\t\t\tEffect.match({\n\t\t\t\tonSuccess: (s) => s,\n\t\t\t\tonFailure: () => null,\n\t\t\t}),\n\t\t);\n\t\tif (stat === null) return false;\n\t\t// `stat.mode` is the full mode bits; mask to file-perm\n\t\t// bits (lowest 12 — incl. setuid/setgid/sticky).\n\t\tconst currentPermBits = stat.mode & 0o7777;\n\t\tif (currentPermBits === wantedMode) return false;\n\t\tyield* fs.chmod(path, wantedMode).pipe(\n\t\t\tEffect.mapError(\n\t\t\t\t(cause) =>\n\t\t\t\t\tnew CodegenWriteFailed({\n\t\t\t\t\t\toutputPath: path,\n\t\t\t\t\t\tstage: 'chmod',\n\t\t\t\t\t\tcause,\n\t\t\t\t\t}),\n\t\t\t),\n\t\t);\n\t\treturn true;\n\t});\n"],"mappings":";;;;;;;;;AA4CA,MAAa,WACZ,UAEA,OAAO,IAAI,aAAa;CACvB,MAAM,KAAK,OAAO,WAAW;CAC7B,MAAM,QAAQ,IAAI,aAAa,CAAC,OAAO,MAAM,QAAQ;CAMrD,MAAM,WAAW,OAAO,GAAG,eAAe,MAAM,KAAK,CAAC,KACrD,OAAO,MAAM;EACZ,YAAY,SAAS;EACrB,iBAAiB;EACjB,CAAC,CACF;AAED,KAAI,aAAa,QAAQ,aAAa,MAAM,SAAS;EAIpD,MAAM,UAAU,OAAO,oBAAoB,MAAM,MAAM,MAAM,KAAK;AAClE,SAAO;GACN,MAAM,MAAM;GACZ,SAAS,UAAW,eAA0B;GAC9C;;AAOF,QAAO,gBAAgB,MAAM,MAAM,OAAO,EAAE,MAAM,MAAM,MAAM,CAAC,CAAC,KAC/D,OAAO,UACL,UACA,IAAI,mBAAmB;EACtB,YAAY,MAAM;EAClB,OAAO,MAAM,UAAU,iBAAiB,iBAAiB;EACzD;EACA,CAAC,CACH,CACD;AACD,QAAO;EAAE,MAAM,MAAM;EAAM,SAAS;EAAkB;EACrD,CAAC,KACF,OAAO,SAAS,mBAAmB,EAClC,YAAY,EAAE,gBAAgB,MAAM,MAAM,EAC1C,CAAC,CACF;;;;;AAMF,MAAM,uBACL,MACA,eAEA,OAAO,IAAI,aAAa;CACvB,MAAM,KAAK,OAAO,WAAW;CAC7B,MAAM,OAAO,OAAO,GAAG,KAAK,KAAK,CAAC,KACjC,OAAO,MAAM;EACZ,YAAY,MAAM;EAClB,iBAAiB;EACjB,CAAC,CACF;AACD,KAAI,SAAS,KAAM,QAAO;AAI1B,MADwB,KAAK,OAAO,UACZ,WAAY,QAAO;AAC3C,QAAO,GAAG,MAAM,MAAM,WAAW,CAAC,KACjC,OAAO,UACL,UACA,IAAI,mBAAmB;EACtB,YAAY;EACZ,OAAO;EACP;EACA,CAAC,CACH,CACD;AACD,QAAO;EACN"}
+{"version":3,"file":"emit.mjs","names":[],"sources":["../../../src/orchestrators/codegen/emit.ts"],"sourcesContent":["// File emission: per-file atomic write + idempotent no-touch.\n//\n// Distilled-doc § \"No-touch on no change\": when inputs are unchanged,\n// file mtimes do not move. This is load-bearing for dev-server HMR\n// quietness — Vite watchers fire on mtime, not content.\n//\n// Flow per file:\n//   1. Read existing file (best-effort). Decode as UTF-8 string.\n//   2. Compare to rendered content. If identical, restore mode bits\n//      (defensive — distilled-doc §\"sensitive-file permission drift\")\n//      and return WITHOUT touching the file.\n//   3. Otherwise atomic-write via the substrate's `atomicWriteFile`\n//      primitive: tempfile + fsync + rename. Apply mode.\n//\n// Cycle-level atomicity lives in `service.ts.runEmitCycle`, which\n// wraps the entire pipeline in substrate `stageAndSwap`. `emitOne`\n// remains per-file atomic so the inner staging-directory writes\n// stay crash-safe, but the user-visible output dir is replaced as\n// one rename — a half-cycle never reaches consumers.\n\nimport { Effect, FileSystem } from 'effect';\nimport { dirname } from 'node:path';\n\nimport { atomicWriteFile } from '../../substrate/runtime/atomic-write.ts';\n\nimport { CodegenWriteFailed } from './errors.ts';\n\nexport interface EmitOneInput {\n\treadonly path: string;\n\treadonly content: string;\n\treadonly mode: number;\n\treadonly parentMode?: number;\n}\n\nexport interface EmitOneResult {\n\treadonly path: string;\n\t/** `wrote` — content was different and we atomically wrote.\n\t *  `unchanged` — bytes matched, we skipped the write.\n\t *  `chmod-only` — bytes matched but mode bits drifted; we\n\t *  restored the mode but did not rewrite the file. */\n\treadonly outcome: 'wrote' | 'unchanged' | 'chmod-only';\n}\n\n/**\n * Emit one file with idempotency. The mode is re-applied even on\n * the no-write path to recover from manual chmods (distilled-doc\n * §\"sensitive-file permission drift\").\n */\nexport const emitOne = (\n\tinput: EmitOneInput,\n): Effect.Effect<EmitOneResult, CodegenWriteFailed, FileSystem.FileSystem> =>\n\tEffect.gen(function* () {\n\t\tconst fs = yield* FileSystem.FileSystem;\n\t\tconst bytes = new TextEncoder().encode(input.content);\n\t\tif (input.parentMode !== undefined) {\n\t\t\tyield* ensureParentDirectory(input.path, input.parentMode);\n\t\t}\n\n\t\t// 1. Best-effort read of existing content for the no-touch\n\t\t//    short-circuit. A missing file collapses to \"no existing\n\t\t//    bytes\" → write. Any other error also collapses to write\n\t\t//    (atomic-write will report the real failure).\n\t\tconst existing = yield* fs.readFileString(input.path).pipe(\n\t\t\tEffect.match({\n\t\t\t\tonSuccess: (text) => text,\n\t\t\t\tonFailure: () => null,\n\t\t\t}),\n\t\t);\n\n\t\tif (existing !== null && existing === input.content) {\n\t\t\t// Content matches — re-apply mode to fix drift, but don't\n\t\t\t// touch the file's mtime. `chmod` updates the inode's\n\t\t\t// `ctime` only.\n\t\t\tconst drifted = yield* checkAndRestoreMode(input.path, input.mode);\n\t\t\treturn {\n\t\t\t\tpath: input.path,\n\t\t\t\toutcome: drifted ? ('chmod-only' as const) : ('unchanged' as const),\n\t\t\t};\n\t\t}\n\n\t\t// 2. Bytes differ (or file missing) — atomic write. The\n\t\t//    substrate's `atomicWriteFile` owns mkdir-parent +\n\t\t//    tempfile + fsync + rename. Mode is applied at create\n\t\t//    time via the `mode` open flag.\n\t\tyield* atomicWriteFile(input.path, bytes, {\n\t\t\tmode: input.mode,\n\t\t\t...(input.parentMode === undefined ? {} : { parentMode: input.parentMode }),\n\t\t}).pipe(\n\t\t\tEffect.mapError(\n\t\t\t\t(cause) =>\n\t\t\t\t\tnew CodegenWriteFailed({\n\t\t\t\t\t\toutputPath: input.path,\n\t\t\t\t\t\tstage: cause.stage === 'mkdir-parent' ? 'mkdir-parent' : 'write',\n\t\t\t\t\t\tcause,\n\t\t\t\t\t}),\n\t\t\t),\n\t\t);\n\t\treturn { path: input.path, outcome: 'wrote' as const };\n\t}).pipe(\n\t\tEffect.withSpan('codegen.emitOne', {\n\t\t\tattributes: { 'codegen.path': input.path },\n\t\t}),\n\t);\n\n/**\n * Check the file's current mode and restore it if drifted. Returns\n * true if a chmod was performed.\n */\nconst checkAndRestoreMode = (\n\tpath: string,\n\twantedMode: number,\n): Effect.Effect<boolean, CodegenWriteFailed, FileSystem.FileSystem> =>\n\tEffect.gen(function* () {\n\t\tconst fs = yield* FileSystem.FileSystem;\n\t\tconst stat = yield* fs.stat(path).pipe(\n\t\t\tEffect.match({\n\t\t\t\tonSuccess: (s) => s,\n\t\t\t\tonFailure: () => null,\n\t\t\t}),\n\t\t);\n\t\tif (stat === null) return false;\n\t\t// `stat.mode` is the full mode bits; mask to file-perm\n\t\t// bits (lowest 12 — incl. setuid/setgid/sticky).\n\t\tconst currentPermBits = stat.mode & 0o7777;\n\t\tif (currentPermBits === wantedMode) return false;\n\t\tyield* fs.chmod(path, wantedMode).pipe(\n\t\t\tEffect.mapError(\n\t\t\t\t(cause) =>\n\t\t\t\t\tnew CodegenWriteFailed({\n\t\t\t\t\t\toutputPath: path,\n\t\t\t\t\t\tstage: 'chmod',\n\t\t\t\t\t\tcause,\n\t\t\t\t\t}),\n\t\t\t),\n\t\t);\n\t\treturn true;\n\t});\n\nconst ensureParentDirectory = (\n\tpath: string,\n\tparentMode: number,\n): Effect.Effect<void, CodegenWriteFailed, FileSystem.FileSystem> =>\n\tEffect.gen(function* () {\n\t\tconst fs = yield* FileSystem.FileSystem;\n\t\tconst parent = dirname(path);\n\t\tyield* fs.makeDirectory(parent, { recursive: true, mode: parentMode }).pipe(\n\t\t\tEffect.mapError(\n\t\t\t\t(cause) =>\n\t\t\t\t\tnew CodegenWriteFailed({\n\t\t\t\t\t\toutputPath: parent,\n\t\t\t\t\t\tstage: 'mkdir-parent',\n\t\t\t\t\t\tcause,\n\t\t\t\t\t}),\n\t\t\t),\n\t\t);\n\t\tyield* checkAndRestoreMode(parent, parentMode).pipe(Effect.asVoid);\n\t});\n"],"mappings":";;;;;;;;;;AAgDA,MAAa,WACZ,UAEA,OAAO,IAAI,aAAa;CACvB,MAAM,KAAK,OAAO,WAAW;CAC7B,MAAM,QAAQ,IAAI,aAAa,CAAC,OAAO,MAAM,QAAQ;AACrD,KAAI,MAAM,eAAe,KAAA,EACxB,QAAO,sBAAsB,MAAM,MAAM,MAAM,WAAW;CAO3D,MAAM,WAAW,OAAO,GAAG,eAAe,MAAM,KAAK,CAAC,KACrD,OAAO,MAAM;EACZ,YAAY,SAAS;EACrB,iBAAiB;EACjB,CAAC,CACF;AAED,KAAI,aAAa,QAAQ,aAAa,MAAM,SAAS;EAIpD,MAAM,UAAU,OAAO,oBAAoB,MAAM,MAAM,MAAM,KAAK;AAClE,SAAO;GACN,MAAM,MAAM;GACZ,SAAS,UAAW,eAA0B;GAC9C;;AAOF,QAAO,gBAAgB,MAAM,MAAM,OAAO;EACzC,MAAM,MAAM;EACZ,GAAI,MAAM,eAAe,KAAA,IAAY,EAAE,GAAG,EAAE,YAAY,MAAM,YAAY;EAC1E,CAAC,CAAC,KACF,OAAO,UACL,UACA,IAAI,mBAAmB;EACtB,YAAY,MAAM;EAClB,OAAO,MAAM,UAAU,iBAAiB,iBAAiB;EACzD;EACA,CAAC,CACH,CACD;AACD,QAAO;EAAE,MAAM,MAAM;EAAM,SAAS;EAAkB;EACrD,CAAC,KACF,OAAO,SAAS,mBAAmB,EAClC,YAAY,EAAE,gBAAgB,MAAM,MAAM,EAC1C,CAAC,CACF;;;;;AAMF,MAAM,uBACL,MACA,eAEA,OAAO,IAAI,aAAa;CACvB,MAAM,KAAK,OAAO,WAAW;CAC7B,MAAM,OAAO,OAAO,GAAG,KAAK,KAAK,CAAC,KACjC,OAAO,MAAM;EACZ,YAAY,MAAM;EAClB,iBAAiB;EACjB,CAAC,CACF;AACD,KAAI,SAAS,KAAM,QAAO;AAI1B,MADwB,KAAK,OAAO,UACZ,WAAY,QAAO;AAC3C,QAAO,GAAG,MAAM,MAAM,WAAW,CAAC,KACjC,OAAO,UACL,UACA,IAAI,mBAAmB;EACtB,YAAY;EACZ,OAAO;EACP;EACA,CAAC,CACH,CACD;AACD,QAAO;EACN;AAEH,MAAM,yBACL,MACA,eAEA,OAAO,IAAI,aAAa;CACvB,MAAM,KAAK,OAAO,WAAW;CAC7B,MAAM,SAAS,QAAQ,KAAK;AAC5B,QAAO,GAAG,cAAc,QAAQ;EAAE,WAAW;EAAM,MAAM;EAAY,CAAC,CAAC,KACtE,OAAO,UACL,UACA,IAAI,mBAAmB;EACtB,YAAY;EACZ,OAAO;EACP;EACA,CAAC,CACH,CACD;AACD,QAAO,oBAAoB,QAAQ,WAAW,CAAC,KAAK,OAAO,OAAO;EACjE"}

package/dist/orchestrators/codegen/errors.mjs

@@ -1,9 +1,14 @@
 import { Schema } from "effect";
 //#region src/orchestrators/codegen/errors.ts
-/** Two `Codegenable` contributions claim the same `outputPath`. Hard
-*  failure detected BEFORE write so the user-visible output dir
-*  never sees an ambiguous overwrite. */
+/** Path-layer rejection from the codegen orchestrator.
+*  - `kind: 'duplicate'` — two `Codegenable` contributions claim the
+*    same `outputPath`. Hard failure detected BEFORE write so the
+*    user-visible output dir never sees an ambiguous overwrite.
+*  - `kind: 'non-relative'` — a plugin-authored `outputPath` escapes
+*    the codegen root (contains `..` or is absolute). Defense-in-depth
+*    for the file-layout invariants. */
 var CodegenPathConflict = class extends Schema.TaggedErrorClass()("CodegenPathConflict", {
+	kind: Schema.Literals(["duplicate", "non-relative"]),
 	outputPath: Schema.String,
 	emitters: Schema.Array(Schema.String)
 }) {};

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

@@ -1 +1 @@
-{"version":3,"file":"errors.mjs","names":[],"sources":["../../../src/orchestrators/codegen/errors.ts"],"sourcesContent":["// Typed errors for the Codegen orchestrator.\n//\n// Architecture §6 (Codegenable) failure-mode taxonomy + distilled-doc\n// §\"Refine the `CodegenError` phase taxonomy\". Today's v3 collapsed\n// \"emitter-collision at acquire\", \"binary shell-out failure\", and\n// \"pure render failure\" into a single tag; the rewrite keeps them\n// separate so callers can `catchTag` on each.\n//\n// Phase tags inside each error name the lifecycle step that failed\n// (resolve → emit → render → write → bindings → finalize) so error\n// attribution stays accurate.\n\nimport { Schema } from 'effect';\n\n/** Two `Codegenable` contributions claim the same `outputPath`. Hard\n *  failure detected BEFORE write so the user-visible output dir\n *  never sees an ambiguous overwrite. */\nexport class CodegenPathConflict extends Schema.TaggedErrorClass<CodegenPathConflict>()(\n\t'CodegenPathConflict',\n\t{\n\t\toutputPath: Schema.String,\n\t\temitters: Schema.Array(Schema.String),\n\t},\n) {}\n\n/** Two `Codegenable` contributions share the SAME `emitterName`\n *  literal but resolve to different `outputPath`s — programming\n *  bug in plugin code (emitter name should be unique). Distinct\n *  from `CodegenPathConflict` so attribution stays clean. */\nexport class CodegenEmitterCollision extends Schema.TaggedErrorClass<CodegenEmitterCollision>()(\n\t'CodegenEmitterCollision',\n\t{\n\t\temitterName: Schema.String,\n\t\toutputPaths: Schema.Array(Schema.String),\n\t},\n) {}\n\n/** A `Codegenable.emit()` wrote a value that the renderer cannot\n *  serialise (a function, a symbol, a circular reference, etc.). */\nexport class CodegenRenderError extends Schema.TaggedErrorClass<CodegenRenderError>()(\n\t'CodegenRenderError',\n\t{\n\t\temitterName: Schema.String,\n\t\toutputPath: Schema.String,\n\t\tdetail: Schema.String,\n\t\tcause: Schema.optional(Schema.Defect),\n\t},\n) {}\n\n/** `Codegenable.emit()` raised. Wraps the inner Effect failure\n *  rather than propagating it raw so the orchestrator's error\n *  channel stays closed. */\nexport class CodegenEmitFailed extends Schema.TaggedErrorClass<CodegenEmitFailed>()(\n\t'CodegenEmitFailed',\n\t{\n\t\temitterName: Schema.String,\n\t\toutputPath: Schema.String,\n\t\tcause: Schema.optional(Schema.Defect),\n\t},\n) {}\n\n/** Disk write (atomic-write or permission-tighten) failed. */\nexport class CodegenWriteFailed extends Schema.TaggedErrorClass<CodegenWriteFailed>()(\n\t'CodegenWriteFailed',\n\t{\n\t\toutputPath: Schema.String,\n\t\tstage: Schema.Literals(['mkdir-parent', 'write', 'rename', 'chmod', 'gitignore']),\n\t\tcause: Schema.optional(Schema.Defect),\n\t},\n) {}\n\n/** `@mysten/codegen` shell-out (Move-to-TS bindings) failed or\n *  silently no-op'd. Distilled-doc § \"Silent no-op from a\n *  downstream tool is a failure\" — we surface a hint about the\n *  common `Move.toml` cause. */\nexport class CodegenBindingsFailed extends Schema.TaggedErrorClass<CodegenBindingsFailed>()(\n\t'CodegenBindingsFailed',\n\t{\n\t\tpackage: Schema.String,\n\t\tsourcePath: Schema.String,\n\t\treason: Schema.Literals(['summary-failed', 'no-output', 'render-failed', 'write-failed']),\n\t\thint: Schema.optional(Schema.String),\n\t\tcause: Schema.optional(Schema.Defect),\n\t},\n) {}\n\n/** The reader of the manifest envelope detected drift between\n *  what plugins contributed and what's on disk — e.g. a stale\n *  envelope from a previous stack lifecycle. */\nexport class CodegenManifestDrift extends Schema.TaggedErrorClass<CodegenManifestDrift>()(\n\t'CodegenManifestDrift',\n\t{\n\t\tdetail: Schema.String,\n\t},\n) {}\n\nexport type CodegenError =\n\t| CodegenPathConflict\n\t| CodegenEmitterCollision\n\t| CodegenRenderError\n\t| CodegenEmitFailed\n\t| CodegenWriteFailed\n\t| CodegenBindingsFailed\n\t| CodegenManifestDrift;\n"],"mappings":";;;;;AAiBA,IAAa,sBAAb,cAAyC,OAAO,kBAAuC,CACtF,uBACA;CACC,YAAY,OAAO;CACnB,UAAU,OAAO,MAAM,OAAO,OAAO;CACrC,CACD,CAAC;;;;;AAMF,IAAa,0BAAb,cAA6C,OAAO,kBAA2C,CAC9F,2BACA;CACC,aAAa,OAAO;CACpB,aAAa,OAAO,MAAM,OAAO,OAAO;CACxC,CACD,CAAC;;;AAIF,IAAa,qBAAb,cAAwC,OAAO,kBAAsC,CACpF,sBACA;CACC,aAAa,OAAO;CACpB,YAAY,OAAO;CACnB,QAAQ,OAAO;CACf,OAAO,OAAO,SAAS,OAAO,OAAO;CACrC,CACD,CAAC;;;;AAKF,IAAa,oBAAb,cAAuC,OAAO,kBAAqC,CAClF,qBACA;CACC,aAAa,OAAO;CACpB,YAAY,OAAO;CACnB,OAAO,OAAO,SAAS,OAAO,OAAO;CACrC,CACD,CAAC;;AAGF,IAAa,qBAAb,cAAwC,OAAO,kBAAsC,CACpF,sBACA;CACC,YAAY,OAAO;CACnB,OAAO,OAAO,SAAS;EAAC;EAAgB;EAAS;EAAU;EAAS;EAAY,CAAC;CACjF,OAAO,OAAO,SAAS,OAAO,OAAO;CACrC,CACD,CAAC;;;;;AAMF,IAAa,wBAAb,cAA2C,OAAO,kBAAyC,CAC1F,yBACA;CACC,SAAS,OAAO;CAChB,YAAY,OAAO;CACnB,QAAQ,OAAO,SAAS;EAAC;EAAkB;EAAa;EAAiB;EAAe,CAAC;CACzF,MAAM,OAAO,SAAS,OAAO,OAAO;CACpC,OAAO,OAAO,SAAS,OAAO,OAAO;CACrC,CACD,CAAC;AAKwC,OAAO,kBAAwC,CACxF,wBACA,EACC,QAAQ,OAAO,QACf,CACD"}
+{"version":3,"file":"errors.mjs","names":[],"sources":["../../../src/orchestrators/codegen/errors.ts"],"sourcesContent":["// Typed errors for the Codegen orchestrator.\n//\n// Architecture §6 (Codegenable) failure-mode taxonomy + distilled-doc\n// §\"Refine the `CodegenError` phase taxonomy\". Today's v3 collapsed\n// \"emitter-collision at acquire\", \"binary shell-out failure\", and\n// \"pure render failure\" into a single tag; the rewrite keeps them\n// separate so callers can `catchTag` on each.\n//\n// Phase tags inside each error name the lifecycle step that failed\n// (resolve → emit → render → write → bindings → finalize) so error\n// attribution stays accurate.\n\nimport { Schema } from 'effect';\n\n/** Path-layer rejection from the codegen orchestrator.\n *  - `kind: 'duplicate'` — two `Codegenable` contributions claim the\n *    same `outputPath`. Hard failure detected BEFORE write so the\n *    user-visible output dir never sees an ambiguous overwrite.\n *  - `kind: 'non-relative'` — a plugin-authored `outputPath` escapes\n *    the codegen root (contains `..` or is absolute). Defense-in-depth\n *    for the file-layout invariants. */\nexport class CodegenPathConflict extends Schema.TaggedErrorClass<CodegenPathConflict>()(\n\t'CodegenPathConflict',\n\t{\n\t\tkind: Schema.Literals(['duplicate', 'non-relative']),\n\t\toutputPath: Schema.String,\n\t\temitters: Schema.Array(Schema.String),\n\t},\n) {}\n\n/** Two `Codegenable` contributions share the SAME `emitterName`\n *  literal but resolve to different `outputPath`s — programming\n *  bug in plugin code (emitter name should be unique). Distinct\n *  from `CodegenPathConflict` so attribution stays clean. */\nexport class CodegenEmitterCollision extends Schema.TaggedErrorClass<CodegenEmitterCollision>()(\n\t'CodegenEmitterCollision',\n\t{\n\t\temitterName: Schema.String,\n\t\toutputPaths: Schema.Array(Schema.String),\n\t},\n) {}\n\n/** A `Codegenable.emit()` wrote a value that the renderer cannot\n *  serialise (a function, a symbol, a circular reference, etc.). */\nexport class CodegenRenderError extends Schema.TaggedErrorClass<CodegenRenderError>()(\n\t'CodegenRenderError',\n\t{\n\t\temitterName: Schema.String,\n\t\toutputPath: Schema.String,\n\t\tdetail: Schema.String,\n\t\tcause: Schema.optional(Schema.Defect),\n\t},\n) {}\n\n/** `Codegenable.emit()` raised. Wraps the inner Effect failure\n *  rather than propagating it raw so the orchestrator's error\n *  channel stays closed. */\nexport class CodegenEmitFailed extends Schema.TaggedErrorClass<CodegenEmitFailed>()(\n\t'CodegenEmitFailed',\n\t{\n\t\temitterName: Schema.String,\n\t\toutputPath: Schema.String,\n\t\tcause: Schema.optional(Schema.Defect),\n\t},\n) {}\n\n/** Disk write (atomic-write or permission-tighten) failed. */\nexport class CodegenWriteFailed extends Schema.TaggedErrorClass<CodegenWriteFailed>()(\n\t'CodegenWriteFailed',\n\t{\n\t\toutputPath: Schema.String,\n\t\tstage: Schema.Literals(['mkdir-parent', 'write', 'rename', 'chmod', 'gitignore']),\n\t\tcause: Schema.optional(Schema.Defect),\n\t},\n) {}\n\n/** `@mysten/codegen` shell-out (Move-to-TS bindings) failed or\n *  silently no-op'd. Distilled-doc § \"Silent no-op from a\n *  downstream tool is a failure\" — we surface a hint about the\n *  common `Move.toml` cause. */\nexport class CodegenBindingsFailed extends Schema.TaggedErrorClass<CodegenBindingsFailed>()(\n\t'CodegenBindingsFailed',\n\t{\n\t\tpackage: Schema.String,\n\t\tsourcePath: Schema.String,\n\t\treason: Schema.Literals(['summary-failed', 'no-output', 'render-failed', 'write-failed']),\n\t\thint: Schema.optional(Schema.String),\n\t\tcause: Schema.optional(Schema.Defect),\n\t},\n) {}\n\n/** The reader of the manifest envelope detected drift between\n *  what plugins contributed and what's on disk — e.g. a stale\n *  envelope from a previous stack lifecycle. */\nexport class CodegenManifestDrift extends Schema.TaggedErrorClass<CodegenManifestDrift>()(\n\t'CodegenManifestDrift',\n\t{\n\t\tdetail: Schema.String,\n\t},\n) {}\n\nexport type CodegenError =\n\t| CodegenPathConflict\n\t| CodegenEmitterCollision\n\t| CodegenRenderError\n\t| CodegenEmitFailed\n\t| CodegenWriteFailed\n\t| CodegenBindingsFailed\n\t| CodegenManifestDrift;\n"],"mappings":";;;;;;;;;AAqBA,IAAa,sBAAb,cAAyC,OAAO,kBAAuC,CACtF,uBACA;CACC,MAAM,OAAO,SAAS,CAAC,aAAa,eAAe,CAAC;CACpD,YAAY,OAAO;CACnB,UAAU,OAAO,MAAM,OAAO,OAAO;CACrC,CACD,CAAC;;;;;AAMF,IAAa,0BAAb,cAA6C,OAAO,kBAA2C,CAC9F,2BACA;CACC,aAAa,OAAO;CACpB,aAAa,OAAO,MAAM,OAAO,OAAO;CACxC,CACD,CAAC;;;AAIF,IAAa,qBAAb,cAAwC,OAAO,kBAAsC,CACpF,sBACA;CACC,aAAa,OAAO;CACpB,YAAY,OAAO;CACnB,QAAQ,OAAO;CACf,OAAO,OAAO,SAAS,OAAO,OAAO;CACrC,CACD,CAAC;;;;AAKF,IAAa,oBAAb,cAAuC,OAAO,kBAAqC,CAClF,qBACA;CACC,aAAa,OAAO;CACpB,YAAY,OAAO;CACnB,OAAO,OAAO,SAAS,OAAO,OAAO;CACrC,CACD,CAAC;;AAGF,IAAa,qBAAb,cAAwC,OAAO,kBAAsC,CACpF,sBACA;CACC,YAAY,OAAO;CACnB,OAAO,OAAO,SAAS;EAAC;EAAgB;EAAS;EAAU;EAAS;EAAY,CAAC;CACjF,OAAO,OAAO,SAAS,OAAO,OAAO;CACrC,CACD,CAAC;;;;;AAMF,IAAa,wBAAb,cAA2C,OAAO,kBAAyC,CAC1F,yBACA;CACC,SAAS,OAAO;CAChB,YAAY,OAAO;CACnB,QAAQ,OAAO,SAAS;EAAC;EAAkB;EAAa;EAAiB;EAAe,CAAC;CACzF,MAAM,OAAO,SAAS,OAAO,OAAO;CACpC,OAAO,OAAO,SAAS,OAAO,OAAO;CACrC,CACD,CAAC;AAKwC,OAAO,kBAAwC,CACxF,wBACA,EACC,QAAQ,OAAO,QACf,CACD"}