@mysten-incubation/devstack 0.0.0

package/dist/orchestrators/codegen/format.mjs

@@ -0,0 +1,109 @@
+import { CodegenRenderError } from "./errors.mjs";
+//#region src/orchestrators/codegen/format.ts
+const GENERATED_HEADER = [
+	"// THIS FILE IS AUTO-GENERATED BY @mysten/devstack.",
+	"// Do not edit by hand — your changes will be overwritten on the next",
+	"// `devstack up` cycle. Apps consume codegen output; codegen output never",
+	"// imports from devstack."
+].join("\n");
+const SENSITIVE_HEADER = [
+	"// !!! DO NOT COMMIT THIS FILE !!!",
+	"// This file carries sensitive material (wallet pair token, database",
+	"// credentials, or user extras). The output directory ships a .gitignore",
+	"// covering it; this banner is a belt-and-braces reminder."
+].join("\n");
+/** Render an emitted file to a TS source string. Throws a tagged
+*  error class when the value is unserialisable. */
+const renderFile = (input) => {
+	const lines = [];
+	lines.push(GENERATED_HEADER);
+	if (input.sensitive) {
+		lines.push("");
+		lines.push(SENSITIVE_HEADER);
+	}
+	lines.push("");
+	if (input.imports && input.imports.length > 0) {
+		for (const imp of input.imports) {
+			if (isForbiddenGeneratedImport(imp)) return new CodegenRenderError({
+				emitterName: input.emitterName,
+				outputPath: input.outputPath,
+				detail: `generated files must not import devstack source: ${imp}`
+			});
+			lines.push(imp);
+		}
+		lines.push("");
+	}
+	const keys = Object.keys(input.exports).sort();
+	for (const key of keys) {
+		const value = input.exports[key];
+		const rendered = tryRender(value, /* @__PURE__ */ new Set());
+		if (rendered instanceof Error) return new CodegenRenderError({
+			emitterName: input.emitterName,
+			outputPath: input.outputPath,
+			detail: `export '${key}': ${rendered.message}`
+		});
+		if (!isIdentifier(key)) return new CodegenRenderError({
+			emitterName: input.emitterName,
+			outputPath: input.outputPath,
+			detail: `export key '${key}' is not a valid TS identifier`
+		});
+		lines.push(`export const ${key} = ${rendered} as const;`);
+		lines.push("");
+	}
+	while (lines.length > 1 && lines[lines.length - 1] === "" && lines[lines.length - 2] === "") lines.pop();
+	return lines.join("\n") + (lines[lines.length - 1] === "" ? "" : "\n");
+};
+const INDENT = "	";
+const tryRender = (value, seen, depth = 1) => {
+	if (value === null) return "null";
+	if (value === void 0) return /* @__PURE__ */ new Error("undefined is not serialisable — emit null instead");
+	const t = typeof value;
+	if (t === "string") return JSON.stringify(value);
+	if (t === "number") {
+		if (!Number.isFinite(value)) return /* @__PURE__ */ new Error("non-finite number");
+		return String(value);
+	}
+	if (t === "boolean") return String(value);
+	if (t === "bigint") return JSON.stringify(value.toString());
+	if (t === "function" || t === "symbol") return /* @__PURE__ */ new Error(`${t} is not serialisable`);
+	if (Array.isArray(value)) {
+		if (seen.has(value)) return /* @__PURE__ */ new Error("circular reference");
+		seen.add(value);
+		if (value.length === 0) return "[]";
+		const inner = [];
+		for (const item of value) {
+			const r = tryRender(item, seen, depth + 1);
+			if (r instanceof Error) return r;
+			inner.push(INDENT.repeat(depth) + r);
+		}
+		seen.delete(value);
+		return `[\n${inner.join(",\n")},\n${INDENT.repeat(depth - 1)}]`;
+	}
+	if (t === "object") {
+		const obj = value;
+		if (seen.has(obj)) return /* @__PURE__ */ new Error("circular reference");
+		seen.add(obj);
+		const keys = Object.keys(obj).sort();
+		if (keys.length === 0) return "{}";
+		const lines = [];
+		for (const k of keys) {
+			const v = obj[k];
+			if (v === void 0) continue;
+			const r = tryRender(v, seen, depth + 1);
+			if (r instanceof Error) return r;
+			const keyText = isIdentifier(k) ? k : JSON.stringify(k);
+			lines.push(`${INDENT.repeat(depth)}${keyText}: ${r}`);
+		}
+		seen.delete(obj);
+		if (lines.length === 0) return "{}";
+		return `{\n${lines.join(",\n")},\n${INDENT.repeat(depth - 1)}}`;
+	}
+	return /* @__PURE__ */ new Error(`unsupported value type ${t}`);
+};
+const IDENT_RE = /^[A-Za-z_$][A-Za-z0-9_$]*$/;
+const isIdentifier = (s) => IDENT_RE.test(s);
+const isForbiddenGeneratedImport = (line) => /\bfrom\s+["']@mysten-incubation\/devstack(?:-rewrite)?(?:\/|["'])/.test(line) || /\bimport\s*\(\s*["']@mysten-incubation\/devstack(?:-rewrite)?(?:\/|["'])/.test(line) || /\bfrom\s+["'][./][^"']*\/src\//.test(line) || /\bimport\s*\(\s*["'][./][^"']*\/src\//.test(line);
+//#endregion
+export { renderFile };
+
+//# sourceMappingURL=format.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"format.mjs","names":[],"sources":["../../../src/orchestrators/codegen/format.ts"],"sourcesContent":["// TypeScript source rendering for codegen-emitted files.\n//\n// Distilled-doc § \"Hand-rolled TS-object-literal rendering ... drifts\n// subtly between emitters; a small shared renderer would absorb the\n// variation and own the bigint policy in one place.\" This module IS\n// that shared renderer.\n//\n// Output shape (one emitted file):\n//\n//   <generated-header>\n//   <do-not-commit-banner if sensitive>\n//   <imports?>\n//   <one `export const <name> = <literal> as const;` per export>\n//   <trailing newline>\n//\n// The renderer:\n//   - sorts object keys (deterministic re-emit, distilled-doc\n//     invariant \"Deterministic re-emit\"),\n//   - quotes identifier-unsafe keys with double-quoted strings,\n//   - serialises bigints as quoted decimal strings for\n//     `BigInt(<string>)` consumers,\n//   - refuses functions / symbols / undefined / circular refs with a\n//     typed render error,\n//   - emits arrays and records as readonly literal forms.\n//\n// The renderer does NOT format with prettier; it aims for\n// prettier-compatible spacing (two-space indent, trailing commas,\n// double-quoted strings, semicolons) so a prettier-on-write user\n// hook is a no-op on emitted bytes — that's load-bearing for the\n// \"no mtime touch on identical content\" idempotency invariant.\n\nimport { CodegenRenderError } from './errors.ts';\n\n// -----------------------------------------------------------------------------\n// Headers\n// -----------------------------------------------------------------------------\n\nconst GENERATED_HEADER = [\n\t'// THIS FILE IS AUTO-GENERATED BY @mysten/devstack.',\n\t'// Do not edit by hand — your changes will be overwritten on the next',\n\t'// `devstack up` cycle. Apps consume codegen output; codegen output never',\n\t'// imports from devstack.',\n].join('\\n');\n\nconst SENSITIVE_HEADER = [\n\t'// !!! DO NOT COMMIT THIS FILE !!!',\n\t'// This file carries sensitive material (wallet pair token, database',\n\t'// credentials, or user extras). The output directory ships a .gitignore',\n\t'// covering it; this banner is a belt-and-braces reminder.',\n].join('\\n');\n\n// -----------------------------------------------------------------------------\n// Public render entry\n// -----------------------------------------------------------------------------\n\nexport interface RenderInput {\n\treadonly emitterName: string;\n\treadonly outputPath: string;\n\treadonly sensitive: boolean;\n\t/** The declarations written by `Codegenable.emit(ctx)`. Each entry\n\t *  becomes one `export const <key> = <literal> as const;`. */\n\treadonly exports: { readonly [key: string]: unknown };\n\t/** Optional import lines the emitter wants prepended (e.g. a\n\t *  type import from `@mysten/dapp-kit` for the wallet config).\n\t *  Each entry is a raw import statement string. */\n\treadonly imports?: ReadonlyArray<string>;\n}\n\n/** Render an emitted file to a TS source string. Throws a tagged\n *  error class when the value is unserialisable. */\nexport const renderFile = (input: RenderInput): string | CodegenRenderError => {\n\tconst lines: Array<string> = [];\n\tlines.push(GENERATED_HEADER);\n\tif (input.sensitive) {\n\t\tlines.push('');\n\t\tlines.push(SENSITIVE_HEADER);\n\t}\n\tlines.push('');\n\tif (input.imports && input.imports.length > 0) {\n\t\tfor (const imp of input.imports) {\n\t\t\tif (isForbiddenGeneratedImport(imp)) {\n\t\t\t\treturn new CodegenRenderError({\n\t\t\t\t\temitterName: input.emitterName,\n\t\t\t\t\toutputPath: input.outputPath,\n\t\t\t\t\tdetail: `generated files must not import devstack source: ${imp}`,\n\t\t\t\t});\n\t\t\t}\n\t\t\tlines.push(imp);\n\t\t}\n\t\tlines.push('');\n\t}\n\t// Stable export order: keys lexicographically sorted.\n\tconst keys = Object.keys(input.exports).sort();\n\tfor (const key of keys) {\n\t\tconst value = input.exports[key];\n\t\tconst rendered = tryRender(value, new Set());\n\t\tif (rendered instanceof Error) {\n\t\t\treturn new CodegenRenderError({\n\t\t\t\temitterName: input.emitterName,\n\t\t\t\toutputPath: input.outputPath,\n\t\t\t\tdetail: `export '${key}': ${rendered.message}`,\n\t\t\t});\n\t\t}\n\t\tif (!isIdentifier(key)) {\n\t\t\treturn new CodegenRenderError({\n\t\t\t\temitterName: input.emitterName,\n\t\t\t\toutputPath: input.outputPath,\n\t\t\t\tdetail: `export key '${key}' is not a valid TS identifier`,\n\t\t\t});\n\t\t}\n\t\tlines.push(`export const ${key} = ${rendered} as const;`);\n\t\tlines.push('');\n\t}\n\t// Single trailing newline; never two.\n\twhile (lines.length > 1 && lines[lines.length - 1] === '' && lines[lines.length - 2] === '') {\n\t\tlines.pop();\n\t}\n\treturn lines.join('\\n') + (lines[lines.length - 1] === '' ? '' : '\\n');\n};\n\n// -----------------------------------------------------------------------------\n// Value rendering\n// -----------------------------------------------------------------------------\n\nconst INDENT = '\\t';\n\nconst tryRender = (value: unknown, seen: Set<object>, depth = 1): string | Error => {\n\tif (value === null) return 'null';\n\tif (value === undefined) {\n\t\treturn new Error('undefined is not serialisable — emit null instead');\n\t}\n\tconst t = typeof value;\n\tif (t === 'string') return JSON.stringify(value);\n\tif (t === 'number') {\n\t\tif (!Number.isFinite(value as number)) {\n\t\t\treturn new Error('non-finite number');\n\t\t}\n\t\treturn String(value);\n\t}\n\tif (t === 'boolean') return String(value);\n\tif (t === 'bigint') {\n\t\treturn JSON.stringify(value.toString());\n\t}\n\tif (t === 'function' || t === 'symbol') {\n\t\treturn new Error(`${t} is not serialisable`);\n\t}\n\tif (Array.isArray(value)) {\n\t\tif (seen.has(value)) return new Error('circular reference');\n\t\tseen.add(value);\n\t\tif (value.length === 0) return '[]';\n\t\tconst inner: Array<string> = [];\n\t\tfor (const item of value) {\n\t\t\tconst r = tryRender(item, seen, depth + 1);\n\t\t\tif (r instanceof Error) return r;\n\t\t\tinner.push(INDENT.repeat(depth) + r);\n\t\t}\n\t\tseen.delete(value);\n\t\treturn `[\\n${inner.join(',\\n')},\\n${INDENT.repeat(depth - 1)}]`;\n\t}\n\tif (t === 'object') {\n\t\tconst obj = value as Record<string, unknown>;\n\t\tif (seen.has(obj)) return new Error('circular reference');\n\t\tseen.add(obj);\n\t\tconst keys = Object.keys(obj).sort();\n\t\tif (keys.length === 0) return '{}';\n\t\tconst lines: Array<string> = [];\n\t\tfor (const k of keys) {\n\t\t\tconst v = obj[k];\n\t\t\tif (v === undefined) continue; // drop undefined props (distilled-doc skip-emit-explicit)\n\t\t\tconst r = tryRender(v, seen, depth + 1);\n\t\t\tif (r instanceof Error) return r;\n\t\t\tconst keyText = isIdentifier(k) ? k : JSON.stringify(k);\n\t\t\tlines.push(`${INDENT.repeat(depth)}${keyText}: ${r}`);\n\t\t}\n\t\tseen.delete(obj);\n\t\tif (lines.length === 0) return '{}';\n\t\treturn `{\\n${lines.join(',\\n')},\\n${INDENT.repeat(depth - 1)}}`;\n\t}\n\treturn new Error(`unsupported value type ${t}`);\n};\n\nconst IDENT_RE = /^[A-Za-z_$][A-Za-z0-9_$]*$/;\nconst isIdentifier = (s: string): boolean => IDENT_RE.test(s);\n\nconst isForbiddenGeneratedImport = (line: string): boolean =>\n\t/\\bfrom\\s+[\"']@mysten-incubation\\/devstack(?:-rewrite)?(?:\\/|[\"'])/.test(line) ||\n\t/\\bimport\\s*\\(\\s*[\"']@mysten-incubation\\/devstack(?:-rewrite)?(?:\\/|[\"'])/.test(line) ||\n\t/\\bfrom\\s+[\"'][./][^\"']*\\/src\\//.test(line) ||\n\t/\\bimport\\s*\\(\\s*[\"'][./][^\"']*\\/src\\//.test(line);\n"],"mappings":"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"}

package/dist/orchestrators/codegen/gitignore.mjs

@@ -0,0 +1,67 @@
+import { CodegenWriteFailed } from "./errors.mjs";
+import { emitOne } from "./emit.mjs";
+import { Effect, FileSystem } from "effect";
+//#region src/orchestrators/codegen/gitignore.ts
+const USER_BLOCK_START = "# user: customisations below preserved across re-emits";
+const USER_BLOCK_END = "# /user: do not edit below this line";
+const DEFAULT_USER_BLOCK = `${USER_BLOCK_START}\n${USER_BLOCK_END}`;
+const HEADER = [
+	"# THIS FILE IS AUTO-GENERATED BY @mysten/devstack.",
+	"# The codegen output directory is engine-managed; the whole tree is",
+	"# ignored from git by default. Sensitive files have an explicit mention",
+	"# below for documentation. Add user customisations inside the `# user:`",
+	"# block; the rest is rewritten on every emit cycle."
+].join("\n");
+/**
+* Compose the gitignore content, preserving any user customisations
+* between the `# user:` markers in any existing file at `path`.
+*/
+const composeGitignore = (existing, input) => {
+	const userBlock = existing !== null ? extractUserBlock(existing) : null;
+	const sortedSensitive = [...input.sensitivePaths].sort();
+	const lines = [];
+	lines.push(HEADER);
+	lines.push("");
+	lines.push("# default policy: ignore the whole output directory.");
+	lines.push("*");
+	lines.push("# but keep this .gitignore tracked so cloners get the policy.");
+	lines.push("!.gitignore");
+	if (sortedSensitive.length > 0) {
+		lines.push("");
+		lines.push("# sensitive files — never commit even if you override the `*` above.");
+		for (const p of sortedSensitive) lines.push(p);
+	}
+	lines.push("");
+	lines.push(userBlock !== null ? userBlock : DEFAULT_USER_BLOCK);
+	return lines.join("\n") + "\n";
+};
+/**
+* Write the gitignore. Idempotent via `emitOne`'s no-touch path.
+*/
+const writeGitignore = (input) => Effect.gen(function* () {
+	const content = composeGitignore(yield* (yield* FileSystem.FileSystem).readFileString(input.path).pipe(Effect.match({
+		onSuccess: (text) => text,
+		onFailure: () => null
+	})), input);
+	yield* emitOne({
+		path: input.path,
+		content,
+		mode: 420
+	}).pipe(Effect.mapError((e) => new CodegenWriteFailed({
+		outputPath: input.path,
+		stage: "gitignore",
+		cause: e
+	})));
+}).pipe(Effect.withSpan("codegen.writeGitignore", { attributes: { "codegen.path": input.path } }));
+const extractUserBlock = (text) => {
+	const startIdx = text.indexOf(USER_BLOCK_START);
+	const endIdx = text.indexOf(USER_BLOCK_END);
+	if (startIdx === -1 || endIdx === -1 || endIdx < startIdx) return null;
+	const endLineEnd = text.indexOf("\n", endIdx);
+	const stop = endLineEnd === -1 ? text.length : endLineEnd;
+	return text.slice(startIdx, stop);
+};
+//#endregion
+export { writeGitignore };
+
+//# sourceMappingURL=gitignore.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gitignore.mjs","names":[],"sources":["../../../src/orchestrators/codegen/gitignore.ts"],"sourcesContent":["// .gitignore emission for the codegen output directory.\n//\n// Distilled-doc §\"Boundary helpers\": \"A `.gitignore` inside the\n// output directory, covering sensitive emitted files by default and\n// preserving user customizations.\" Two design points:\n//\n//   1. The entire output directory is engine-managed and the\n//      pragmatic default is \"ignore everything emitted here\". The\n//      `*` line lives at the top of the file with a comment\n//      explaining the policy.\n//   2. Sensitive files get an explicit second mention so the\n//      `.gitignore` reads as documentation in addition to enforcing\n//      the policy.\n//   3. User customisations land in a tracked `# user:` block — any\n//      content the user adds between the `# user:` and `# /user:`\n//      markers is preserved verbatim across re-emits.\n//\n// The `.gitignore` is emitted with the same per-file atomic writer as\n// the rest of the codegen tree.\n\nimport { Effect, FileSystem } from 'effect';\n\nimport { emitOne } from './emit.ts';\nimport { CodegenWriteFailed } from './errors.ts';\nimport { NON_SENSITIVE_FILE_MODE } from './permissions.ts';\n\nconst USER_BLOCK_START = '# user: customisations below preserved across re-emits';\nconst USER_BLOCK_END = '# /user: do not edit below this line';\n\nconst DEFAULT_USER_BLOCK = `${USER_BLOCK_START}\\n${USER_BLOCK_END}`;\n\nconst HEADER = [\n\t'# THIS FILE IS AUTO-GENERATED BY @mysten/devstack.',\n\t'# The codegen output directory is engine-managed; the whole tree is',\n\t'# ignored from git by default. Sensitive files have an explicit mention',\n\t'# below for documentation. Add user customisations inside the `# user:`',\n\t'# block; the rest is rewritten on every emit cycle.',\n].join('\\n');\n\nexport interface GitignoreInput {\n\treadonly path: string;\n\t/** Relative paths inside the output dir that are sensitive — get\n\t *  an explicit gitignore line. Sorted lexicographically. */\n\treadonly sensitivePaths: ReadonlyArray<string>;\n}\n\n/**\n * Compose the gitignore content, preserving any user customisations\n * between the `# user:` markers in any existing file at `path`.\n */\nexport const composeGitignore = (existing: string | null, input: GitignoreInput): string => {\n\tconst userBlock = existing !== null ? extractUserBlock(existing) : null;\n\tconst sortedSensitive = [...input.sensitivePaths].sort();\n\tconst lines: Array<string> = [];\n\tlines.push(HEADER);\n\tlines.push('');\n\tlines.push('# default policy: ignore the whole output directory.');\n\tlines.push('*');\n\tlines.push('# but keep this .gitignore tracked so cloners get the policy.');\n\tlines.push('!.gitignore');\n\tif (sortedSensitive.length > 0) {\n\t\tlines.push('');\n\t\tlines.push('# sensitive files — never commit even if you override the `*` above.');\n\t\tfor (const p of sortedSensitive) lines.push(p);\n\t}\n\tlines.push('');\n\tlines.push(userBlock !== null ? userBlock : DEFAULT_USER_BLOCK);\n\treturn lines.join('\\n') + '\\n';\n};\n\n/**\n * Write the gitignore. Idempotent via `emitOne`'s no-touch path.\n */\nexport const writeGitignore = (\n\tinput: GitignoreInput,\n): Effect.Effect<void, CodegenWriteFailed, FileSystem.FileSystem> =>\n\tEffect.gen(function* () {\n\t\tconst fs = yield* FileSystem.FileSystem;\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\t\tconst content = composeGitignore(existing, input);\n\t\tyield* emitOne({\n\t\t\tpath: input.path,\n\t\t\tcontent,\n\t\t\tmode: NON_SENSITIVE_FILE_MODE,\n\t\t}).pipe(\n\t\t\tEffect.mapError(\n\t\t\t\t(e) =>\n\t\t\t\t\tnew CodegenWriteFailed({\n\t\t\t\t\t\toutputPath: input.path,\n\t\t\t\t\t\tstage: 'gitignore',\n\t\t\t\t\t\tcause: e,\n\t\t\t\t\t}),\n\t\t\t),\n\t\t);\n\t}).pipe(\n\t\tEffect.withSpan('codegen.writeGitignore', {\n\t\t\tattributes: { 'codegen.path': input.path },\n\t\t}),\n\t);\n\nconst extractUserBlock = (text: string): string | null => {\n\tconst startIdx = text.indexOf(USER_BLOCK_START);\n\tconst endIdx = text.indexOf(USER_BLOCK_END);\n\tif (startIdx === -1 || endIdx === -1 || endIdx < startIdx) return null;\n\t// Include both markers in the returned block.\n\tconst endLineEnd = text.indexOf('\\n', endIdx);\n\tconst stop = endLineEnd === -1 ? text.length : endLineEnd;\n\treturn text.slice(startIdx, stop);\n};\n"],"mappings":";;;;AA0BA,MAAM,mBAAmB;AACzB,MAAM,iBAAiB;AAEvB,MAAM,qBAAqB,GAAG,iBAAiB,IAAI;AAEnD,MAAM,SAAS;CACd;CACA;CACA;CACA;CACA;CACA,CAAC,KAAK,KAAK;;;;;AAaZ,MAAa,oBAAoB,UAAyB,UAAkC;CAC3F,MAAM,YAAY,aAAa,OAAO,iBAAiB,SAAS,GAAG;CACnE,MAAM,kBAAkB,CAAC,GAAG,MAAM,eAAe,CAAC,MAAM;CACxD,MAAM,QAAuB,EAAE;AAC/B,OAAM,KAAK,OAAO;AAClB,OAAM,KAAK,GAAG;AACd,OAAM,KAAK,uDAAuD;AAClE,OAAM,KAAK,IAAI;AACf,OAAM,KAAK,gEAAgE;AAC3E,OAAM,KAAK,cAAc;AACzB,KAAI,gBAAgB,SAAS,GAAG;AAC/B,QAAM,KAAK,GAAG;AACd,QAAM,KAAK,uEAAuE;AAClF,OAAK,MAAM,KAAK,gBAAiB,OAAM,KAAK,EAAE;;AAE/C,OAAM,KAAK,GAAG;AACd,OAAM,KAAK,cAAc,OAAO,YAAY,mBAAmB;AAC/D,QAAO,MAAM,KAAK,KAAK,GAAG;;;;;AAM3B,MAAa,kBACZ,UAEA,OAAO,IAAI,aAAa;CAQvB,MAAM,UAAU,iBAAiB,QANT,OADN,WAAW,YACF,eAAe,MAAM,KAAK,CAAC,KACrD,OAAO,MAAM;EACZ,YAAY,SAAS;EACrB,iBAAiB;EACjB,CAAC,CACF,EAC0C,MAAM;AACjD,QAAO,QAAQ;EACd,MAAM,MAAM;EACZ;EACA,MAAA;EACA,CAAC,CAAC,KACF,OAAO,UACL,MACA,IAAI,mBAAmB;EACtB,YAAY,MAAM;EAClB,OAAO;EACP,OAAO;EACP,CAAC,CACH,CACD;EACA,CAAC,KACF,OAAO,SAAS,0BAA0B,EACzC,YAAY,EAAE,gBAAgB,MAAM,MAAM,EAC1C,CAAC,CACF;AAEF,MAAM,oBAAoB,SAAgC;CACzD,MAAM,WAAW,KAAK,QAAQ,iBAAiB;CAC/C,MAAM,SAAS,KAAK,QAAQ,eAAe;AAC3C,KAAI,aAAa,MAAM,WAAW,MAAM,SAAS,SAAU,QAAO;CAElE,MAAM,aAAa,KAAK,QAAQ,MAAM,OAAO;CAC7C,MAAM,OAAO,eAAe,KAAK,KAAK,SAAS;AAC/C,QAAO,KAAK,MAAM,UAAU,KAAK"}

package/dist/orchestrators/codegen/paths.d.mts

@@ -0,0 +1 @@
+import { Context, Layer, Path } from "effect";

package/dist/orchestrators/codegen/paths.mjs

@@ -0,0 +1,33 @@
+import { Context, Effect, Layer, Path } from "effect";
+//#region src/orchestrators/codegen/paths.ts
+var CodegenRoot = class extends Context.Service()("@devstack-rewrite/orchestrator/CodegenRoot") {};
+/** Build a `CodegenRoot` layer pinned to a literal path. */
+const layerCodegenRoot = (root) => Layer.succeed(CodegenRoot)(root);
+var CodegenPathsService = class extends Context.Service()("@devstack-rewrite/orchestrator/CodegenPaths") {};
+/**
+* Materialize the resolver from `CodegenRoot` + Effect's `Path`
+* service. Stack subdir, if present, is appended:
+*   `<outputDir>` or `<outputDir>/<stackSubdir>`.
+*/
+const layerCodegenPaths = Layer.effect(CodegenPathsService, Effect.gen(function* () {
+	const root = yield* CodegenRoot;
+	const path = yield* Path.Path;
+	const outputDir = root.stackSubdir ? path.join(root.outputDir, root.stackSubdir) : root.outputDir;
+	const bindingsDir = path.join(outputDir, "bindings");
+	const resolve = (outputPath) => {
+		if (outputPath.includes("..") || outputPath.startsWith("/")) throw new Error(`codegen.outputPath must be a relative path without '..'; got '${outputPath}'`);
+		return path.join(outputDir, outputPath);
+	};
+	const resolveBindingsPackage = (packageName) => path.join(bindingsDir, packageName);
+	return CodegenPathsService.of({
+		outputDir,
+		gitignoreFile: path.join(outputDir, ".gitignore"),
+		bindingsDir,
+		resolve,
+		resolveBindingsPackage
+	});
+}));
+//#endregion
+export { CodegenPathsService, layerCodegenPaths, layerCodegenRoot };
+
+//# sourceMappingURL=paths.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paths.mjs","names":[],"sources":["../../../src/orchestrators/codegen/paths.ts"],"sourcesContent":["// Codegen output-path layout.\n//\n// Distilled-doc § \"All outputs land under a single user-chosen\n// directory (default `./src/generated/`)\" + §\"Stable output paths\".\n// One file owns the layout so emitters never assemble paths by hand.\n//\n// Default root is `<appRoot>/src/generated/`. Tests and parallel\n// stacks pin a per-test root; the substrate's `RuntimeRoot` is for\n// engine-private state (~/.devstack/...), NOT for codegen output.\n// Codegen output lives in the USER's source tree.\n\nimport { Context, Effect, Layer, Path } from 'effect';\n\n/**\n * Codegen output root — the directory codegen owns and overwrites.\n * Pinned at boot time from the user's `defineDevstack` options\n * (default `./src/generated/` resolved against the app's cwd).\n *\n * Held as a service so emitters can yield it without a function\n * argument; mirrors the substrate's `RuntimeRoot` pattern.\n */\nexport interface CodegenRootShape {\n\t/** Absolute path to the output directory. The orchestrator\n\t *  manages it; the user never writes here. */\n\treadonly outputDir: string;\n\t/** Optional per-stack subdirectory under `outputDir`. When set,\n\t *  parallel stacks emit into sibling directories under the same\n\t *  output root (distilled-doc §\"per-stack subdirectory\"). */\n\treadonly stackSubdir: string | null;\n}\n\nexport class CodegenRoot extends Context.Service<CodegenRoot, CodegenRootShape>()(\n\t'@devstack-rewrite/orchestrator/CodegenRoot',\n) {}\n\n/** Build a `CodegenRoot` layer pinned to a literal path. */\nexport const layerCodegenRoot = (root: CodegenRootShape): Layer.Layer<CodegenRoot> =>\n\tLayer.succeed(CodegenRoot)(root);\n\n/** Closed bundle the resolver returns. Mirrors substrate `StackPaths`. */\nexport interface CodegenPaths {\n\t/** The directory the orchestrator emits into (after applying\n\t *  per-stack subdirectory if configured). The watcher MUST\n\t *  exclude this directory. */\n\treadonly outputDir: string;\n\t/** Path to the `.gitignore` inside `outputDir`. Written every\n\t *  emit (the dir is gitignored). */\n\treadonly gitignoreFile: string;\n\t/** Subtree where Move-to-TS bindings land. */\n\treadonly bindingsDir: string;\n\t/** Helper: resolve an emitter's `outputPath` (e.g. `sui/network.ts`)\n\t *  against the output root. */\n\treadonly resolve: (outputPath: string) => string;\n\t/** Helper: resolve a per-package bindings subtree path. */\n\treadonly resolveBindingsPackage: (packageName: string) => string;\n}\n\nexport class CodegenPathsService extends Context.Service<CodegenPathsService, CodegenPaths>()(\n\t'@devstack-rewrite/orchestrator/CodegenPaths',\n) {}\n\n/**\n * Materialize the resolver from `CodegenRoot` + Effect's `Path`\n * service. Stack subdir, if present, is appended:\n *   `<outputDir>` or `<outputDir>/<stackSubdir>`.\n */\nexport const layerCodegenPaths: Layer.Layer<CodegenPathsService, never, CodegenRoot | Path.Path> =\n\tLayer.effect(\n\t\tCodegenPathsService,\n\t\tEffect.gen(function* () {\n\t\t\tconst root = yield* CodegenRoot;\n\t\t\tconst path = yield* Path.Path;\n\t\t\tconst outputDir = root.stackSubdir\n\t\t\t\t? path.join(root.outputDir, root.stackSubdir)\n\t\t\t\t: root.outputDir;\n\t\t\tconst bindingsDir = path.join(outputDir, 'bindings');\n\t\t\tconst resolve = (outputPath: string): string => {\n\t\t\t\t// Defense-in-depth: refuse `..` traversal so an emitter\n\t\t\t\t// can't write outside its declared output dir. The\n\t\t\t\t// declared `CodegenableDecl.outputPath` is plugin-authored\n\t\t\t\t// and trusted but the check costs nothing.\n\t\t\t\tif (outputPath.includes('..') || outputPath.startsWith('/')) {\n\t\t\t\t\tthrow new Error(\n\t\t\t\t\t\t`codegen.outputPath must be a relative path without '..'; got '${outputPath}'`,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\treturn path.join(outputDir, outputPath);\n\t\t\t};\n\t\t\tconst resolveBindingsPackage = (packageName: string): string =>\n\t\t\t\tpath.join(bindingsDir, packageName);\n\t\t\treturn CodegenPathsService.of({\n\t\t\t\toutputDir,\n\t\t\t\tgitignoreFile: path.join(outputDir, '.gitignore'),\n\t\t\t\tbindingsDir,\n\t\t\t\tresolve,\n\t\t\t\tresolveBindingsPackage,\n\t\t\t});\n\t\t}),\n\t);\n"],"mappings":";;AA+BA,IAAa,cAAb,cAAiC,QAAQ,SAAwC,CAChF,6CACA,CAAC;;AAGF,MAAa,oBAAoB,SAChC,MAAM,QAAQ,YAAY,CAAC,KAAK;AAoBjC,IAAa,sBAAb,cAAyC,QAAQ,SAA4C,CAC5F,8CACA,CAAC;;;;;;AAOF,MAAa,oBACZ,MAAM,OACL,qBACA,OAAO,IAAI,aAAa;CACvB,MAAM,OAAO,OAAO;CACpB,MAAM,OAAO,OAAO,KAAK;CACzB,MAAM,YAAY,KAAK,cACpB,KAAK,KAAK,KAAK,WAAW,KAAK,YAAY,GAC3C,KAAK;CACR,MAAM,cAAc,KAAK,KAAK,WAAW,WAAW;CACpD,MAAM,WAAW,eAA+B;AAK/C,MAAI,WAAW,SAAS,KAAK,IAAI,WAAW,WAAW,IAAI,CAC1D,OAAM,IAAI,MACT,iEAAiE,WAAW,GAC5E;AAEF,SAAO,KAAK,KAAK,WAAW,WAAW;;CAExC,MAAM,0BAA0B,gBAC/B,KAAK,KAAK,aAAa,YAAY;AACpC,QAAO,oBAAoB,GAAG;EAC7B;EACA,eAAe,KAAK,KAAK,WAAW,aAAa;EACjD;EACA;EACA;EACA,CAAC;EACD,CACF"}

package/dist/orchestrators/codegen/permissions.mjs

@@ -0,0 +1,6 @@
+/** File mode for one codegen contribution. */
+const modeFor = (decl) => decl.sensitive === true ? 384 : 420;
+//#endregion
+export { modeFor };
+
+//# sourceMappingURL=permissions.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.mjs","names":[],"sources":["../../../src/orchestrators/codegen/permissions.ts"],"sourcesContent":["// Permission policy for codegen-emitted files.\n//\n// Distilled-doc § \"Sensitive emitted files have restrictive\n// filesystem permissions, re-applied on every emit (not just on\n// create) to recover from manual chmods\". The orchestrator hands the\n// emit/swap layer the mode it should apply.\n//\n// Two-axis policy:\n//   - `sensitive: true` → 0o600 (rw user only).\n//   - `sensitive: false` → 0o644 (rw user, r world).\n// The parent directory the emit lives in inherits the strictest\n// sensitivity of any file inside it — 0o700 when any file is\n// sensitive, 0o755 otherwise. The orchestrator applies parent mode\n// at swap time, separate from per-file modes.\n\nimport type { CodegenableDecl } from '../../contracts/codegenable.ts';\n\nexport const SENSITIVE_FILE_MODE = 0o600;\nexport const NON_SENSITIVE_FILE_MODE = 0o644;\nexport const SENSITIVE_DIR_MODE = 0o700;\nexport const NON_SENSITIVE_DIR_MODE = 0o755;\n\n/** File mode for one codegen contribution. */\nexport const modeFor = (decl: Pick<CodegenableDecl, 'sensitive'>): number =>\n\tdecl.sensitive === true ? SENSITIVE_FILE_MODE : NON_SENSITIVE_FILE_MODE;\n\n/** Parent-directory mode given a set of contributions inside it. */\nexport const dirModeFor = (decls: ReadonlyArray<Pick<CodegenableDecl, 'sensitive'>>): number =>\n\tdecls.some((d) => d.sensitive === true) ? SENSITIVE_DIR_MODE : NON_SENSITIVE_DIR_MODE;\n\n/** True if ANY contribution in the set is sensitive — gates the\n *  `.gitignore` \"cover by default\" rule and the parent-mode policy. */\nexport const anySensitive = (decls: ReadonlyArray<Pick<CodegenableDecl, 'sensitive'>>): boolean =>\n\tdecls.some((d) => d.sensitive === true);\n"],"mappings":";AAuBA,MAAa,WAAW,SACvB,KAAK,cAAc,OAAA,MAAA"}

package/dist/orchestrators/codegen/service.d.mts

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

package/dist/orchestrators/codegen/service.mjs

@@ -0,0 +1,276 @@
+import { CodegenEmitFailed, CodegenEmitterCollision, CodegenPathConflict } from "./errors.mjs";
+import { emitOne } from "./emit.mjs";
+import { modeFor } from "./permissions.mjs";
+import { 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";
+//#region src/orchestrators/codegen/service.ts
+const runEmitCycle = (input) => Effect.gen(function* () {
+	const paths = yield* CodegenPathsService;
+	const fileEmitters = [];
+	for (const decl of input.contributions) fileEmitters.push(decl);
+	yield* validateUniqueness(fileEmitters);
+	yield* validateAggregatePathAvailability(fileEmitters);
+	const filesWritten = [];
+	const filesUnchanged = [];
+	const filesChmod = [];
+	const aggregates = emptyAggregateBuckets();
+	const packageContribs = [];
+	const sortedDecls = [...fileEmitters].sort(Order.mapInput(Order.String, (d) => d.outputPath));
+	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);
+		}
+		const rendered = renderFile({
+			emitterName: decl.emitterName,
+			outputPath: decl.outputPath,
+			sensitive: decl.sensitive === true,
+			exports: exported,
+			imports: emission.imports
+		});
+		if (rendered instanceof Error) return yield* Effect.fail(rendered);
+		const abs = paths.resolve(decl.outputPath);
+		switch ((yield* emitOne({
+			path: abs,
+			content: rendered,
+			mode: modeFor(decl)
+		})).outcome) {
+			case "wrote":
+				filesWritten.push(abs);
+				break;
+			case "unchanged":
+				filesUnchanged.push(abs);
+				break;
+			case "chmod-only":
+				filesChmod.push(abs);
+				break;
+		}
+	}
+	for (const aggregate of buildAggregateFiles(aggregates)) {
+		const rendered = renderFile({
+			emitterName: aggregate.emitterName,
+			outputPath: aggregate.outputPath,
+			sensitive: false,
+			exports: aggregate.exports
+		});
+		if (rendered instanceof Error) return yield* Effect.fail(rendered);
+		const abs = paths.resolve(aggregate.outputPath);
+		switch ((yield* emitOne({
+			path: abs,
+			content: rendered,
+			mode: 420
+		})).outcome) {
+			case "wrote":
+				filesWritten.push(abs);
+				break;
+			case "unchanged":
+				filesUnchanged.push(abs);
+				break;
+			case "chmod-only":
+				filesChmod.push(abs);
+				break;
+		}
+	}
+	let bindings = null;
+	if (packageContribs.length > 0) bindings = yield* emitBindings({
+		bindingsDir: paths.bindingsDir,
+		packages: packageContribs,
+		importExtension: input.bindingsImportExtension
+	});
+	else yield* Effect.logInfo("codegen: no package contributions; skipping Move-to-TS bindings step.");
+	const sensitivePaths = fileEmitters.filter((d) => d.sensitive === true).map((d) => d.outputPath);
+	yield* writeGitignore({
+		path: paths.gitignoreFile,
+		sensitivePaths
+	});
+	return {
+		filesWritten,
+		filesUnchanged,
+		filesChmod,
+		bindings
+	};
+}).pipe(Effect.withSpan("codegen.runEmitCycle", { attributes: { "codegen.contributions": input.contributions.length } }));
+const runEmitter = (decl) => Effect.gen(function* () {
+	const exports = {};
+	const imports = [];
+	const done = { _tag: "CodegenEmitDone" };
+	yield* decl.emit({
+		exportConst: (name, value) => {
+			exports[name] = value;
+		},
+		importStatement: (statement) => {
+			imports.push(statement);
+		},
+		done: () => done
+	}).pipe(Effect.mapError((cause) => new CodegenEmitFailed({
+		emitterName: decl.emitterName,
+		outputPath: decl.outputPath,
+		cause
+	})));
+	return {
+		exports,
+		imports
+	};
+});
+/**
+* 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).
+*/
+const validateUniqueness = (decls) => Effect.gen(function* () {
+	const byPath = /* @__PURE__ */ new Map();
+	const byName = /* @__PURE__ */ new Map();
+	for (const d of decls) {
+		const ps = byPath.get(d.outputPath) ?? [];
+		ps.push(d.emitterName);
+		byPath.set(d.outputPath, ps);
+		if (d.emitterName === "package") 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({
+		outputPath: path,
+		emitters
+	}));
+	for (const [name, outputPaths] of byName) if (outputPaths.length > 1) return yield* Effect.fail(new CodegenEmitterCollision({
+		emitterName: name,
+		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;
+};
+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 path of aggregatePaths) {
+		const colliding = decls.filter((decl) => decl.outputPath === path);
+		if (colliding.length > 0) return yield* Effect.fail(new CodegenPathConflict({
+			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 }
+			};
+		}
+	}
+};
+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 }
+	});
+	return files;
+};
+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") {};
+/** 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. */
+const layerCodegenOrchestrator = Layer.effect(CodegenOrchestratorService, Effect.gen(function* () {
+	const contributionsRef = yield* Ref.make([]);
+	const seqRef = yield* Ref.make(0);
+	const registerContribution = (pluginKey, decl) => Effect.gen(function* () {
+		const seq = yield* Ref.updateAndGet(seqRef, (n) => n + 1);
+		const entry = {
+			pluginKey,
+			decl,
+			seq
+		};
+		yield* Ref.update(contributionsRef, (xs) => [...xs, entry]);
+		yield* Effect.addFinalizer(() => Ref.update(contributionsRef, (xs) => xs.filter((e) => e.seq !== seq)));
+		yield* Effect.annotateCurrentSpan({
+			"codegen.contribution.plugin": pluginKey,
+			"codegen.contribution.emitter": decl.emitterName,
+			"codegen.contribution.outputPath": decl.outputPath
+		});
+	}).pipe(Effect.withSpan("orchestrator.codegen.registerContribution"));
+	const runCycle = (args) => Effect.gen(function* () {
+		const registered = (yield* Ref.get(contributionsRef)).map((e) => e.decl);
+		return yield* runEmitCycle({
+			contributions: args?.extraContributions ? [...registered, ...args.extraContributions] : registered,
+			bindingsImportExtension: args?.bindingsImportExtension
+		});
+	}).pipe(Effect.withSpan("orchestrator.codegen.runCycle"));
+	return CodegenOrchestratorService.of({
+		registerContribution,
+		runCycle
+	});
+}));
+//#endregion
+export { CodegenOrchestratorService, layerCodegenOrchestrator };
+
+//# sourceMappingURL=service.mjs.map

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

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