@agimon-ai/doompi 0.0.1-alpha.76 → 0.0.1-alpha.78

package/dist/builders/apiContractExport/index.mjs

@@ -0,0 +1,77 @@
+import { resolveDoomConfigurationRoot } from "../../composition/repository/index.mjs";
+import { readSyncDrift } from "../../composition/syncDrift/index.mjs";
+import { canonicalContractJson, createApiDocuments, parseCompiledContracts } from "@agimon-ai/doompi-core/api-contracts";
+import fs from "node:fs";
+import path from "node:path";
+import { readSyncRegistration } from "@agimon-ai/doompi-core/sync-registration";
+import { globalDoomConfigDirectory } from "@agimon-ai/doompi-config/config";
+import { loadMajorModesConfig, resolveLayers } from "@agimon-ai/doompi-config/majorModes";
+import crypto from "node:crypto";
+import { parseDoomServerBundle } from "@agimon-ai/doompi-core/server-facet";
+//#region src/builders/apiContractExport/index.ts
+/** Read only published generations. Export must never implicitly sync or activate a facet. */
+function exportApiContracts(options) {
+	const globalRoot = globalDoomConfigDirectory(options.homeDirectory);
+	const workspaceRoot = resolveDoomConfigurationRoot(options.cwd, options.homeDirectory);
+	const read = (root) => {
+		const drift = readSyncDrift({
+			repoRoot: root,
+			homeDirectory: options.homeDirectory,
+			requireFreshSources: false
+		});
+		if (!drift.fresh) throw new Error(`Run doompi sync for '${root}' before exporting API contracts: ${drift.reasons.join(", ")}`);
+		const registration = readSyncRegistration(root, options.homeDirectory);
+		if (!registration?.serverBundle) throw new Error(`No synced server bundle for '${root}'`);
+		const descriptor = parseDoomServerBundle(JSON.parse(fs.readFileSync(registration.serverBundle.path, "utf8")));
+		if (!descriptor.contracts) throw new Error(`Resync '${root}' to generate API contracts`);
+		const file = path.resolve(path.dirname(registration.serverBundle.path), descriptor.contracts.file);
+		const bytes = fs.readFileSync(file);
+		if (crypto.createHash("sha256").update(bytes).digest("hex") !== descriptor.contracts.sha256) throw new Error(`API contract checksum mismatch for '${root}'`);
+		return {
+			compiled: parseCompiledContracts(JSON.parse(bytes.toString("utf8"))),
+			config: loadMajorModesConfig(root, options.homeDirectory)
+		};
+	};
+	const global = read(globalRoot);
+	const workspace = globalRoot === workspaceRoot ? global : read(workspaceRoot);
+	const sessionMode = options.majorMode ?? workspace.config.defaultMajorMode;
+	const selection = (source, scope, majorMode) => ({
+		scope,
+		majorMode,
+		activeLayers: resolveLayers(source.config, majorMode),
+		compiled: source.compiled
+	});
+	if (!Object.hasOwn(workspace.config.majorMode, sessionMode)) throw new Error(`Unknown major mode '${sessionMode}'`);
+	const documents = createApiDocuments([
+		selection(global, "global", global.config.defaultMajorMode),
+		selection(workspace, "workspace", workspace.config.defaultMajorMode),
+		selection(workspace, "session", sessionMode)
+	]);
+	const files = {
+		"openapi.json": canonicalContractJson(documents.openapi),
+		"asyncapi.json": canonicalContractJson(documents.asyncapi)
+	};
+	const manifest = {
+		...documents.manifest,
+		artifacts: Object.fromEntries(Object.entries(files).map(([name, bytes]) => [name, { sha256: crypto.createHash("sha256").update(bytes).digest("hex") }]))
+	};
+	fs.mkdirSync(options.outputDirectory, { recursive: true });
+	for (const [name, bytes] of Object.entries({
+		...files,
+		"manifest.json": canonicalContractJson(manifest)
+	})) {
+		const target = path.join(options.outputDirectory, name);
+		const temporary = `${target}.${crypto.randomUUID()}.tmp`;
+		try {
+			fs.writeFileSync(temporary, bytes, { flag: "wx" });
+			fs.renameSync(temporary, target);
+		} finally {
+			fs.rmSync(temporary, { force: true });
+		}
+	}
+	return documents.manifest;
+}
+//#endregion
+export { exportApiContracts };
+
+//# sourceMappingURL=index.mjs.map

package/dist/builders/apiContractExport/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/builders/apiContractExport/index.ts"],"sourcesContent":["import crypto from 'node:crypto';\nimport fs from 'node:fs';\nimport path from 'node:path';\n\nimport { globalDoomConfigDirectory } from '@agimon-ai/doompi-config/config';\nimport { loadMajorModesConfig, resolveLayers } from '@agimon-ai/doompi-config/majorModes';\nimport {\n  canonicalContractJson,\n  createApiDocuments,\n  parseCompiledContracts,\n  type ApiContractSelection,\n  type ApiDocuments,\n} from '@agimon-ai/doompi-core/api-contracts';\nimport { parseDoomServerBundle } from '@agimon-ai/doompi-core/server-facet';\nimport { readSyncRegistration } from '@agimon-ai/doompi-core/sync-registration';\n\nimport { resolveDoomConfigurationRoot } from '../../composition/repository';\nimport { readSyncDrift } from '../../composition/syncDrift';\n\n/** Read only published generations. Export must never implicitly sync or activate a facet. */\nexport function exportApiContracts(options: {\n  cwd: string;\n  homeDirectory: string;\n  outputDirectory: string;\n  majorMode?: string;\n}): ApiDocuments['manifest'] {\n  const globalRoot = globalDoomConfigDirectory(options.homeDirectory);\n  const workspaceRoot = resolveDoomConfigurationRoot(options.cwd, options.homeDirectory);\n  const read = (root: string) => {\n    const drift = readSyncDrift({\n      repoRoot: root,\n      homeDirectory: options.homeDirectory,\n      requireFreshSources: false,\n    });\n    if (!drift.fresh)\n      throw new Error(`Run doompi sync for '${root}' before exporting API contracts: ${drift.reasons.join(', ')}`);\n    const registration = readSyncRegistration(root, options.homeDirectory);\n    if (!registration?.serverBundle) throw new Error(`No synced server bundle for '${root}'`);\n    const descriptor = parseDoomServerBundle(JSON.parse(fs.readFileSync(registration.serverBundle.path, 'utf8')));\n    if (!descriptor.contracts) throw new Error(`Resync '${root}' to generate API contracts`);\n    const file = path.resolve(path.dirname(registration.serverBundle.path), descriptor.contracts.file);\n    const bytes = fs.readFileSync(file);\n    if (crypto.createHash('sha256').update(bytes).digest('hex') !== descriptor.contracts.sha256)\n      throw new Error(`API contract checksum mismatch for '${root}'`);\n    return {\n      compiled: parseCompiledContracts(JSON.parse(bytes.toString('utf8'))),\n      config: loadMajorModesConfig(root, options.homeDirectory),\n    };\n  };\n  const global = read(globalRoot);\n  const workspace = globalRoot === workspaceRoot ? global : read(workspaceRoot);\n  const sessionMode = options.majorMode ?? workspace.config.defaultMajorMode;\n  const selection = (\n    source: typeof global,\n    scope: ApiContractSelection['scope'],\n    majorMode: string,\n  ): ApiContractSelection => ({\n    scope,\n    majorMode,\n    activeLayers: resolveLayers(source.config, majorMode),\n    compiled: source.compiled,\n  });\n  // A typo must not silently export an empty session surface.\n  if (!Object.hasOwn(workspace.config.majorMode, sessionMode)) throw new Error(`Unknown major mode '${sessionMode}'`);\n  const documents = createApiDocuments([\n    selection(global, 'global', global.config.defaultMajorMode),\n    selection(workspace, 'workspace', workspace.config.defaultMajorMode),\n    selection(workspace, 'session', sessionMode),\n  ]);\n  const files = {\n    'openapi.json': canonicalContractJson(documents.openapi),\n    'asyncapi.json': canonicalContractJson(documents.asyncapi),\n  };\n  const manifest = {\n    ...documents.manifest,\n    artifacts: Object.fromEntries(\n      Object.entries(files).map(([name, bytes]) => [\n        name,\n        {\n          sha256: crypto.createHash('sha256').update(bytes).digest('hex'),\n        },\n      ]),\n    ),\n  };\n  fs.mkdirSync(options.outputDirectory, { recursive: true });\n  // Write the manifest last. Consumers verify both checksums before accepting the bundle.\n  for (const [name, bytes] of Object.entries({ ...files, 'manifest.json': canonicalContractJson(manifest) })) {\n    const target = path.join(options.outputDirectory, name);\n    const temporary = `${target}.${crypto.randomUUID()}.tmp`;\n    try {\n      fs.writeFileSync(temporary, bytes, { flag: 'wx' });\n      fs.renameSync(temporary, target);\n    } finally {\n      fs.rmSync(temporary, { force: true });\n    }\n  }\n  return documents.manifest;\n}\n"],"mappings":";;;;;;;;;;;;AAoBA,SAAgB,mBAAmB,SAKN;CAC3B,MAAM,aAAa,0BAA0B,QAAQ,aAAa;CAClE,MAAM,gBAAgB,6BAA6B,QAAQ,KAAK,QAAQ,aAAa;CACrF,MAAM,QAAQ,SAAiB;EAC7B,MAAM,QAAQ,cAAc;GAC1B,UAAU;GACV,eAAe,QAAQ;GACvB,qBAAqB;EACvB,CAAC;EACD,IAAI,CAAC,MAAM,OACT,MAAM,IAAI,MAAM,wBAAwB,KAAK,oCAAoC,MAAM,QAAQ,KAAK,IAAI,GAAG;EAC7G,MAAM,eAAe,qBAAqB,MAAM,QAAQ,aAAa;EACrE,IAAI,CAAC,cAAc,cAAc,MAAM,IAAI,MAAM,gCAAgC,KAAK,EAAE;EACxF,MAAM,aAAa,sBAAsB,KAAK,MAAM,GAAG,aAAa,aAAa,aAAa,MAAM,MAAM,CAAC,CAAC;EAC5G,IAAI,CAAC,WAAW,WAAW,MAAM,IAAI,MAAM,WAAW,KAAK,4BAA4B;EACvF,MAAM,OAAO,KAAK,QAAQ,KAAK,QAAQ,aAAa,aAAa,IAAI,GAAG,WAAW,UAAU,IAAI;EACjG,MAAM,QAAQ,GAAG,aAAa,IAAI;EAClC,IAAI,OAAO,WAAW,QAAQ,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,OAAO,KAAK,MAAM,WAAW,UAAU,QACnF,MAAM,IAAI,MAAM,uCAAuC,KAAK,EAAE;EAChE,OAAO;GACL,UAAU,uBAAuB,KAAK,MAAM,MAAM,SAAS,MAAM,CAAC,CAAC;GACnE,QAAQ,qBAAqB,MAAM,QAAQ,aAAa;EAC1D;CACF;CACA,MAAM,SAAS,KAAK,UAAU;CAC9B,MAAM,YAAY,eAAe,gBAAgB,SAAS,KAAK,aAAa;CAC5E,MAAM,cAAc,QAAQ,aAAa,UAAU,OAAO;CAC1D,MAAM,aACJ,QACA,OACA,eAC0B;EAC1B;EACA;EACA,cAAc,cAAc,OAAO,QAAQ,SAAS;EACpD,UAAU,OAAO;CACnB;CAEA,IAAI,CAAC,OAAO,OAAO,UAAU,OAAO,WAAW,WAAW,GAAG,MAAM,IAAI,MAAM,uBAAuB,YAAY,EAAE;CAClH,MAAM,YAAY,mBAAmB;EACnC,UAAU,QAAQ,UAAU,OAAO,OAAO,gBAAgB;EAC1D,UAAU,WAAW,aAAa,UAAU,OAAO,gBAAgB;EACnE,UAAU,WAAW,WAAW,WAAW;CAC7C,CAAC;CACD,MAAM,QAAQ;EACZ,gBAAgB,sBAAsB,UAAU,OAAO;EACvD,iBAAiB,sBAAsB,UAAU,QAAQ;CAC3D;CACA,MAAM,WAAW;EACf,GAAG,UAAU;EACb,WAAW,OAAO,YAChB,OAAO,QAAQ,KAAK,CAAC,CAAC,KAAK,CAAC,MAAM,WAAW,CAC3C,MACA,EACE,QAAQ,OAAO,WAAW,QAAQ,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,OAAO,KAAK,EAChE,CACF,CAAC,CACH;CACF;CACA,GAAG,UAAU,QAAQ,iBAAiB,EAAE,WAAW,KAAK,CAAC;CAEzD,KAAK,MAAM,CAAC,MAAM,UAAU,OAAO,QAAQ;EAAE,GAAG;EAAO,iBAAiB,sBAAsB,QAAQ;CAAE,CAAC,GAAG;EAC1G,MAAM,SAAS,KAAK,KAAK,QAAQ,iBAAiB,IAAI;EACtD,MAAM,YAAY,GAAG,OAAO,GAAG,OAAO,WAAW,EAAE;EACnD,IAAI;GACF,GAAG,cAAc,WAAW,OAAO,EAAE,MAAM,KAAK,CAAC;GACjD,GAAG,WAAW,WAAW,MAAM;EACjC,UAAU;GACR,GAAG,OAAO,WAAW,EAAE,OAAO,KAAK,CAAC;EACtC;CACF;CACA,OAAO,UAAU;AACnB"}

package/dist/builders/apiContracts/index.cjs

@@ -0,0 +1,87 @@
+const require_runtime = require("../../_virtual/_rolldown/runtime.cjs");
+const require_index = require("../../compiler/index.cjs");
+let _agimon_ai_doompi_core_api_contracts = require("@agimon-ai/doompi-core/api-contracts");
+let node_fs = require("node:fs");
+node_fs = require_runtime.__toESM(node_fs, 1);
+let node_path = require("node:path");
+node_path = require_runtime.__toESM(node_path, 1);
+let node_url = require("node:url");
+let node_child_process = require("node:child_process");
+let node_util = require("node:util");
+let node_crypto = require("node:crypto");
+node_crypto = require_runtime.__toESM(node_crypto, 1);
+//#region src/builders/apiContracts/index.ts
+const execute = (0, node_util.promisify)(node_child_process.execFile);
+const CONTRACT_MANIFEST_SUFFIX = "#contracts";
+/** Contracts have a separate entry graph so exporting never imports a server facet. */
+async function compileApiContracts(input) {
+	node_fs.default.mkdirSync(input.outputDirectory, { recursive: true });
+	const compiled = {
+		version: 1,
+		generation: input.descriptor.generation,
+		fingerprint: input.descriptor.fingerprint,
+		packages: []
+	};
+	const compilerManifests = {};
+	const gaps = [];
+	for (const [index, facet] of input.descriptor.entries.entries()) {
+		const root = input.packageRoots.get(facet.packageName);
+		const manifest = JSON.parse(node_fs.default.readFileSync(node_path.default.join(root, "package.json"), "utf8"));
+		const entry = {
+			packageName: facet.packageName,
+			packageVersion: manifest.version ?? "unknown",
+			scopes: facet.scopes,
+			owners: facet.owners
+		};
+		compiled.packages.push(entry);
+		try {
+			const declaration = manifest.doompiServer?.contracts;
+			if (!declaration) throw new Error("No doompiServer.contracts declaration");
+			for (const value of [declaration.entry, declaration.dist]) {
+				if (typeof value !== "string" || !value.startsWith("./") || value.includes("..") || /[\\%?#]/u.test(value)) throw new Error("Contract entry and dist must be contained package-relative files");
+				if (value === declaration.dist) {
+					const relative = node_path.default.relative(node_fs.default.realpathSync(root), node_fs.default.realpathSync(node_path.default.join(root, value)));
+					if (relative.startsWith("..") || node_path.default.isAbsolute(relative)) throw new Error("Contract entry escapes package");
+				}
+			}
+			const built = node_path.default.resolve(root, declaration.dist);
+			const options = {
+				repositoryRoot: input.repositoryRoot,
+				sharedCacheDirectory: input.sharedCacheDirectory,
+				outputDirectory: node_path.default.join(input.outputDirectory, "contracts", String(index)),
+				outputName: "contract"
+			};
+			const module = await require_index.compileExtensionModule(built, input.cacheDirectory, options);
+			compilerManifests[`${facet.packageName}${CONTRACT_MANIFEST_SUFFIX}`] = require_index.extensionModuleManifestPath(built, input.cacheDirectory, options);
+			entry.module = `./${node_path.default.relative(input.outputDirectory, module).split(node_path.default.sep).join("/")}`;
+			const { stdout } = await execute(process.execPath, [
+				"--input-type=module",
+				"-e",
+				"try { const m = await import(process.argv[1]); process.stdout.write(JSON.stringify(m.default, (_key, value) => { if (typeof value === \"function\" || typeof value === \"bigint\" || typeof value === \"undefined\" || (typeof value === \"number\" && !Number.isFinite(value))) throw new Error(\"Contract contains non-JSON data\"); return value; })); } catch (error) { process.stderr.write(error instanceof Error ? `${error.name}: ${error.message}` : String(error)); process.exitCode = 1; }",
+				(0, node_url.pathToFileURL)(module).href
+			], {
+				timeout: 1e4,
+				maxBuffer: 16777216
+			});
+			entry.contract = (0, _agimon_ai_doompi_core_api_contracts.parseApiContract)(JSON.parse(stdout));
+		} catch (error) {
+			entry.problem = (error !== null && typeof error === "object" && "stderr" in error && typeof error.stderr === "string" && error.stderr.trim() ? error.stderr.trim() : error instanceof Error ? error.message : String(error)).slice(0, 1e3);
+			gaps.push(`${facet.packageName}: ${entry.problem}`);
+		}
+	}
+	const bytes = (0, _agimon_ai_doompi_core_api_contracts.canonicalContractJson)(compiled);
+	node_fs.default.writeFileSync(node_path.default.join(input.outputDirectory, _agimon_ai_doompi_core_api_contracts.DOOM_API_CONTRACT_FILE), bytes);
+	return {
+		contracts: {
+			file: `./${_agimon_ai_doompi_core_api_contracts.DOOM_API_CONTRACT_FILE}`,
+			sha256: node_crypto.default.createHash("sha256").update(bytes).digest("hex")
+		},
+		compilerManifests,
+		gaps
+	};
+}
+//#endregion
+exports.CONTRACT_MANIFEST_SUFFIX = CONTRACT_MANIFEST_SUFFIX;
+exports.compileApiContracts = compileApiContracts;
+
+//# sourceMappingURL=index.cjs.map

package/dist/builders/apiContracts/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["promisify","execFile","fs","path","compileExtensionModule","extensionModuleManifestPath","pathToFileURL","parseApiContract","canonicalContractJson","DOOM_API_CONTRACT_FILE","crypto"],"sources":["../../../src/builders/apiContracts/index.ts"],"sourcesContent":["import { execFile } from 'node:child_process';\nimport crypto from 'node:crypto';\nimport fs from 'node:fs';\nimport path from 'node:path';\nimport { pathToFileURL } from 'node:url';\nimport { promisify } from 'node:util';\n\nimport {\n  canonicalContractJson,\n  DOOM_API_CONTRACT_FILE,\n  parseApiContract,\n  type DoomCompiledContracts,\n  type DoomPackageContract,\n} from '@agimon-ai/doompi-core/api-contracts';\nimport type { DoomServerBundle } from '@agimon-ai/doompi-core/server-facet';\n\nimport { compileExtensionModule, extensionModuleManifestPath } from '../../compiler';\n\nconst execute = promisify(execFile);\nexport const CONTRACT_MANIFEST_SUFFIX = '#contracts';\n\n/** Contracts have a separate entry graph so exporting never imports a server facet. */\nexport async function compileApiContracts(input: {\n  descriptor: DoomServerBundle;\n  packageRoots: ReadonlyMap<string, string>;\n  repositoryRoot: string;\n  outputDirectory: string;\n  cacheDirectory: string;\n  sharedCacheDirectory?: string;\n}): Promise<{\n  contracts: { file: string; sha256: string };\n  compilerManifests: Record<string, string>;\n  gaps: string[];\n}> {\n  fs.mkdirSync(input.outputDirectory, { recursive: true });\n  const compiled: DoomCompiledContracts = {\n    version: 1,\n    generation: input.descriptor.generation,\n    fingerprint: input.descriptor.fingerprint,\n    packages: [],\n  };\n  const compilerManifests: Record<string, string> = {};\n  const gaps: string[] = [];\n  for (const [index, facet] of input.descriptor.entries.entries()) {\n    const root = input.packageRoots.get(facet.packageName)!;\n    const manifest = JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf8')) as {\n      version?: string;\n      doompiServer?: { contracts?: { entry?: string; dist?: string } };\n    };\n    const entry: DoomPackageContract = {\n      packageName: facet.packageName,\n      packageVersion: manifest.version ?? 'unknown',\n      scopes: facet.scopes,\n      owners: facet.owners,\n    };\n    compiled.packages.push(entry);\n    try {\n      const declaration = manifest.doompiServer?.contracts;\n      if (!declaration) throw new Error('No doompiServer.contracts declaration');\n      for (const value of [declaration.entry, declaration.dist]) {\n        if (typeof value !== 'string' || !value.startsWith('./') || value.includes('..') || /[\\\\%?#]/u.test(value))\n          throw new Error('Contract entry and dist must be contained package-relative files');\n        if (value === declaration.dist) {\n          const relative = path.relative(fs.realpathSync(root), fs.realpathSync(path.join(root, value)));\n          if (relative.startsWith('..') || path.isAbsolute(relative)) throw new Error('Contract entry escapes package');\n        }\n      }\n      const built = path.resolve(root, declaration.dist!);\n      const options = {\n        repositoryRoot: input.repositoryRoot,\n        sharedCacheDirectory: input.sharedCacheDirectory,\n        outputDirectory: path.join(input.outputDirectory, 'contracts', String(index)),\n        outputName: 'contract',\n      };\n      const module = await compileExtensionModule(built, input.cacheDirectory, options);\n      compilerManifests[`${facet.packageName}${CONTRACT_MANIFEST_SUFFIX}`] = extensionModuleManifestPath(\n        built,\n        input.cacheDirectory,\n        options,\n      );\n      entry.module = `./${path.relative(input.outputDirectory, module).split(path.sep).join('/')}`;\n      // A bounded separate process keeps module caches, timers and errors out of sync.\n      const { stdout } = await execute(\n        process.execPath,\n        [\n          '--input-type=module',\n          '-e',\n          'try { const m = await import(process.argv[1]); process.stdout.write(JSON.stringify(m.default, (_key, value) => { if (typeof value === \"function\" || typeof value === \"bigint\" || typeof value === \"undefined\" || (typeof value === \"number\" && !Number.isFinite(value))) throw new Error(\"Contract contains non-JSON data\"); return value; })); } catch (error) { process.stderr.write(error instanceof Error ? `${error.name}: ${error.message}` : String(error)); process.exitCode = 1; }',\n          pathToFileURL(module).href,\n        ],\n        { timeout: 10_000, maxBuffer: 16 * 1024 * 1024 },\n      );\n      entry.contract = parseApiContract(JSON.parse(stdout));\n    } catch (error) {\n      entry.problem = (\n        error !== null &&\n        typeof error === 'object' &&\n        'stderr' in error &&\n        typeof error.stderr === 'string' &&\n        error.stderr.trim()\n          ? error.stderr.trim()\n          : error instanceof Error\n            ? error.message\n            : String(error)\n      ).slice(0, 1000);\n      gaps.push(`${facet.packageName}: ${entry.problem}`);\n    }\n  }\n  const bytes = canonicalContractJson(compiled);\n  fs.writeFileSync(path.join(input.outputDirectory, DOOM_API_CONTRACT_FILE), bytes);\n  return {\n    contracts: { file: `./${DOOM_API_CONTRACT_FILE}`, sha256: crypto.createHash('sha256').update(bytes).digest('hex') },\n    compilerManifests,\n    gaps,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;AAkBA,MAAM,WAAA,GAAUA,UAAAA,UAAAA,CAAUC,mBAAAA,QAAQ;AAClC,MAAa,2BAA2B;;AAGxC,eAAsB,oBAAoB,OAWvC;CACD,QAAA,QAAG,UAAU,MAAM,iBAAiB,EAAE,WAAW,KAAK,CAAC;CACvD,MAAM,WAAkC;EACtC,SAAS;EACT,YAAY,MAAM,WAAW;EAC7B,aAAa,MAAM,WAAW;EAC9B,UAAU,CAAC;CACb;CACA,MAAM,oBAA4C,CAAC;CACnD,MAAM,OAAiB,CAAC;CACxB,KAAK,MAAM,CAAC,OAAO,UAAU,MAAM,WAAW,QAAQ,QAAQ,GAAG;EAC/D,MAAM,OAAO,MAAM,aAAa,IAAI,MAAM,WAAW;EACrD,MAAM,WAAW,KAAK,MAAMC,QAAAA,QAAG,aAAaC,UAAAA,QAAK,KAAK,MAAM,cAAc,GAAG,MAAM,CAAC;EAIpF,MAAM,QAA6B;GACjC,aAAa,MAAM;GACnB,gBAAgB,SAAS,WAAW;GACpC,QAAQ,MAAM;GACd,QAAQ,MAAM;EAChB;EACA,SAAS,SAAS,KAAK,KAAK;EAC5B,IAAI;GACF,MAAM,cAAc,SAAS,cAAc;GAC3C,IAAI,CAAC,aAAa,MAAM,IAAI,MAAM,uCAAuC;GACzE,KAAK,MAAM,SAAS,CAAC,YAAY,OAAO,YAAY,IAAI,GAAG;IACzD,IAAI,OAAO,UAAU,YAAY,CAAC,MAAM,WAAW,IAAI,KAAK,MAAM,SAAS,IAAI,KAAK,WAAW,KAAK,KAAK,GACvG,MAAM,IAAI,MAAM,kEAAkE;IACpF,IAAI,UAAU,YAAY,MAAM;KAC9B,MAAM,WAAWA,UAAAA,QAAK,SAASD,QAAAA,QAAG,aAAa,IAAI,GAAGA,QAAAA,QAAG,aAAaC,UAAAA,QAAK,KAAK,MAAM,KAAK,CAAC,CAAC;KAC7F,IAAI,SAAS,WAAW,IAAI,KAAKA,UAAAA,QAAK,WAAW,QAAQ,GAAG,MAAM,IAAI,MAAM,gCAAgC;IAC9G;GACF;GACA,MAAM,QAAQA,UAAAA,QAAK,QAAQ,MAAM,YAAY,IAAK;GAClD,MAAM,UAAU;IACd,gBAAgB,MAAM;IACtB,sBAAsB,MAAM;IAC5B,iBAAiBA,UAAAA,QAAK,KAAK,MAAM,iBAAiB,aAAa,OAAO,KAAK,CAAC;IAC5E,YAAY;GACd;GACA,MAAM,SAAS,MAAMC,cAAAA,uBAAuB,OAAO,MAAM,gBAAgB,OAAO;GAChF,kBAAkB,GAAG,MAAM,cAAc,8BAA8BC,cAAAA,4BACrE,OACA,MAAM,gBACN,OACF;GACA,MAAM,SAAS,KAAKF,UAAAA,QAAK,SAAS,MAAM,iBAAiB,MAAM,CAAC,CAAC,MAAMA,UAAAA,QAAK,GAAG,CAAC,CAAC,KAAK,GAAG;GAEzF,MAAM,EAAE,WAAW,MAAM,QACvB,QAAQ,UACR;IACE;IACA;IACA;KACAG,GAAAA,SAAAA,cAAAA,CAAc,MAAM,CAAC,CAAC;GACxB,GACA;IAAE,SAAS;IAAQ,WAAW;GAAiB,CACjD;GACA,MAAM,YAAA,GAAWC,qCAAAA,iBAAAA,CAAiB,KAAK,MAAM,MAAM,CAAC;EACtD,SAAS,OAAO;GACd,MAAM,WACJ,UAAU,QACV,OAAO,UAAU,YACjB,YAAY,SACZ,OAAO,MAAM,WAAW,YACxB,MAAM,OAAO,KAAK,IACd,MAAM,OAAO,KAAK,IAClB,iBAAiB,QACf,MAAM,UACN,OAAO,KAAK,EAAA,CAClB,MAAM,GAAG,GAAI;GACf,KAAK,KAAK,GAAG,MAAM,YAAY,IAAI,MAAM,SAAS;EACpD;CACF;CACA,MAAM,SAAA,GAAQC,qCAAAA,sBAAAA,CAAsB,QAAQ;CAC5C,QAAA,QAAG,cAAcL,UAAAA,QAAK,KAAK,MAAM,iBAAiBM,qCAAAA,sBAAsB,GAAG,KAAK;CAChF,OAAO;EACL,WAAW;GAAE,MAAM,KAAKA,qCAAAA;GAA0B,QAAQC,YAAAA,QAAO,WAAW,QAAQ,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,OAAO,KAAK;EAAE;EAClH;EACA;CACF;AACF"}

package/dist/builders/apiContracts/index.mjs

@@ -0,0 +1,82 @@
+import { compileExtensionModule, extensionModuleManifestPath } from "../../compiler/index.mjs";
+import { DOOM_API_CONTRACT_FILE, canonicalContractJson, parseApiContract } from "@agimon-ai/doompi-core/api-contracts";
+import fs from "node:fs";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import crypto from "node:crypto";
+//#region src/builders/apiContracts/index.ts
+const execute = promisify(execFile);
+const CONTRACT_MANIFEST_SUFFIX = "#contracts";
+/** Contracts have a separate entry graph so exporting never imports a server facet. */
+async function compileApiContracts(input) {
+	fs.mkdirSync(input.outputDirectory, { recursive: true });
+	const compiled = {
+		version: 1,
+		generation: input.descriptor.generation,
+		fingerprint: input.descriptor.fingerprint,
+		packages: []
+	};
+	const compilerManifests = {};
+	const gaps = [];
+	for (const [index, facet] of input.descriptor.entries.entries()) {
+		const root = input.packageRoots.get(facet.packageName);
+		const manifest = JSON.parse(fs.readFileSync(path.join(root, "package.json"), "utf8"));
+		const entry = {
+			packageName: facet.packageName,
+			packageVersion: manifest.version ?? "unknown",
+			scopes: facet.scopes,
+			owners: facet.owners
+		};
+		compiled.packages.push(entry);
+		try {
+			const declaration = manifest.doompiServer?.contracts;
+			if (!declaration) throw new Error("No doompiServer.contracts declaration");
+			for (const value of [declaration.entry, declaration.dist]) {
+				if (typeof value !== "string" || !value.startsWith("./") || value.includes("..") || /[\\%?#]/u.test(value)) throw new Error("Contract entry and dist must be contained package-relative files");
+				if (value === declaration.dist) {
+					const relative = path.relative(fs.realpathSync(root), fs.realpathSync(path.join(root, value)));
+					if (relative.startsWith("..") || path.isAbsolute(relative)) throw new Error("Contract entry escapes package");
+				}
+			}
+			const built = path.resolve(root, declaration.dist);
+			const options = {
+				repositoryRoot: input.repositoryRoot,
+				sharedCacheDirectory: input.sharedCacheDirectory,
+				outputDirectory: path.join(input.outputDirectory, "contracts", String(index)),
+				outputName: "contract"
+			};
+			const module = await compileExtensionModule(built, input.cacheDirectory, options);
+			compilerManifests[`${facet.packageName}${CONTRACT_MANIFEST_SUFFIX}`] = extensionModuleManifestPath(built, input.cacheDirectory, options);
+			entry.module = `./${path.relative(input.outputDirectory, module).split(path.sep).join("/")}`;
+			const { stdout } = await execute(process.execPath, [
+				"--input-type=module",
+				"-e",
+				"try { const m = await import(process.argv[1]); process.stdout.write(JSON.stringify(m.default, (_key, value) => { if (typeof value === \"function\" || typeof value === \"bigint\" || typeof value === \"undefined\" || (typeof value === \"number\" && !Number.isFinite(value))) throw new Error(\"Contract contains non-JSON data\"); return value; })); } catch (error) { process.stderr.write(error instanceof Error ? `${error.name}: ${error.message}` : String(error)); process.exitCode = 1; }",
+				pathToFileURL(module).href
+			], {
+				timeout: 1e4,
+				maxBuffer: 16777216
+			});
+			entry.contract = parseApiContract(JSON.parse(stdout));
+		} catch (error) {
+			entry.problem = (error !== null && typeof error === "object" && "stderr" in error && typeof error.stderr === "string" && error.stderr.trim() ? error.stderr.trim() : error instanceof Error ? error.message : String(error)).slice(0, 1e3);
+			gaps.push(`${facet.packageName}: ${entry.problem}`);
+		}
+	}
+	const bytes = canonicalContractJson(compiled);
+	fs.writeFileSync(path.join(input.outputDirectory, DOOM_API_CONTRACT_FILE), bytes);
+	return {
+		contracts: {
+			file: `./${DOOM_API_CONTRACT_FILE}`,
+			sha256: crypto.createHash("sha256").update(bytes).digest("hex")
+		},
+		compilerManifests,
+		gaps
+	};
+}
+//#endregion
+export { CONTRACT_MANIFEST_SUFFIX, compileApiContracts };
+
+//# sourceMappingURL=index.mjs.map

package/dist/builders/apiContracts/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/builders/apiContracts/index.ts"],"sourcesContent":["import { execFile } from 'node:child_process';\nimport crypto from 'node:crypto';\nimport fs from 'node:fs';\nimport path from 'node:path';\nimport { pathToFileURL } from 'node:url';\nimport { promisify } from 'node:util';\n\nimport {\n  canonicalContractJson,\n  DOOM_API_CONTRACT_FILE,\n  parseApiContract,\n  type DoomCompiledContracts,\n  type DoomPackageContract,\n} from '@agimon-ai/doompi-core/api-contracts';\nimport type { DoomServerBundle } from '@agimon-ai/doompi-core/server-facet';\n\nimport { compileExtensionModule, extensionModuleManifestPath } from '../../compiler';\n\nconst execute = promisify(execFile);\nexport const CONTRACT_MANIFEST_SUFFIX = '#contracts';\n\n/** Contracts have a separate entry graph so exporting never imports a server facet. */\nexport async function compileApiContracts(input: {\n  descriptor: DoomServerBundle;\n  packageRoots: ReadonlyMap<string, string>;\n  repositoryRoot: string;\n  outputDirectory: string;\n  cacheDirectory: string;\n  sharedCacheDirectory?: string;\n}): Promise<{\n  contracts: { file: string; sha256: string };\n  compilerManifests: Record<string, string>;\n  gaps: string[];\n}> {\n  fs.mkdirSync(input.outputDirectory, { recursive: true });\n  const compiled: DoomCompiledContracts = {\n    version: 1,\n    generation: input.descriptor.generation,\n    fingerprint: input.descriptor.fingerprint,\n    packages: [],\n  };\n  const compilerManifests: Record<string, string> = {};\n  const gaps: string[] = [];\n  for (const [index, facet] of input.descriptor.entries.entries()) {\n    const root = input.packageRoots.get(facet.packageName)!;\n    const manifest = JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf8')) as {\n      version?: string;\n      doompiServer?: { contracts?: { entry?: string; dist?: string } };\n    };\n    const entry: DoomPackageContract = {\n      packageName: facet.packageName,\n      packageVersion: manifest.version ?? 'unknown',\n      scopes: facet.scopes,\n      owners: facet.owners,\n    };\n    compiled.packages.push(entry);\n    try {\n      const declaration = manifest.doompiServer?.contracts;\n      if (!declaration) throw new Error('No doompiServer.contracts declaration');\n      for (const value of [declaration.entry, declaration.dist]) {\n        if (typeof value !== 'string' || !value.startsWith('./') || value.includes('..') || /[\\\\%?#]/u.test(value))\n          throw new Error('Contract entry and dist must be contained package-relative files');\n        if (value === declaration.dist) {\n          const relative = path.relative(fs.realpathSync(root), fs.realpathSync(path.join(root, value)));\n          if (relative.startsWith('..') || path.isAbsolute(relative)) throw new Error('Contract entry escapes package');\n        }\n      }\n      const built = path.resolve(root, declaration.dist!);\n      const options = {\n        repositoryRoot: input.repositoryRoot,\n        sharedCacheDirectory: input.sharedCacheDirectory,\n        outputDirectory: path.join(input.outputDirectory, 'contracts', String(index)),\n        outputName: 'contract',\n      };\n      const module = await compileExtensionModule(built, input.cacheDirectory, options);\n      compilerManifests[`${facet.packageName}${CONTRACT_MANIFEST_SUFFIX}`] = extensionModuleManifestPath(\n        built,\n        input.cacheDirectory,\n        options,\n      );\n      entry.module = `./${path.relative(input.outputDirectory, module).split(path.sep).join('/')}`;\n      // A bounded separate process keeps module caches, timers and errors out of sync.\n      const { stdout } = await execute(\n        process.execPath,\n        [\n          '--input-type=module',\n          '-e',\n          'try { const m = await import(process.argv[1]); process.stdout.write(JSON.stringify(m.default, (_key, value) => { if (typeof value === \"function\" || typeof value === \"bigint\" || typeof value === \"undefined\" || (typeof value === \"number\" && !Number.isFinite(value))) throw new Error(\"Contract contains non-JSON data\"); return value; })); } catch (error) { process.stderr.write(error instanceof Error ? `${error.name}: ${error.message}` : String(error)); process.exitCode = 1; }',\n          pathToFileURL(module).href,\n        ],\n        { timeout: 10_000, maxBuffer: 16 * 1024 * 1024 },\n      );\n      entry.contract = parseApiContract(JSON.parse(stdout));\n    } catch (error) {\n      entry.problem = (\n        error !== null &&\n        typeof error === 'object' &&\n        'stderr' in error &&\n        typeof error.stderr === 'string' &&\n        error.stderr.trim()\n          ? error.stderr.trim()\n          : error instanceof Error\n            ? error.message\n            : String(error)\n      ).slice(0, 1000);\n      gaps.push(`${facet.packageName}: ${entry.problem}`);\n    }\n  }\n  const bytes = canonicalContractJson(compiled);\n  fs.writeFileSync(path.join(input.outputDirectory, DOOM_API_CONTRACT_FILE), bytes);\n  return {\n    contracts: { file: `./${DOOM_API_CONTRACT_FILE}`, sha256: crypto.createHash('sha256').update(bytes).digest('hex') },\n    compilerManifests,\n    gaps,\n  };\n}\n"],"mappings":";;;;;;;;;AAkBA,MAAM,UAAU,UAAU,QAAQ;AAClC,MAAa,2BAA2B;;AAGxC,eAAsB,oBAAoB,OAWvC;CACD,GAAG,UAAU,MAAM,iBAAiB,EAAE,WAAW,KAAK,CAAC;CACvD,MAAM,WAAkC;EACtC,SAAS;EACT,YAAY,MAAM,WAAW;EAC7B,aAAa,MAAM,WAAW;EAC9B,UAAU,CAAC;CACb;CACA,MAAM,oBAA4C,CAAC;CACnD,MAAM,OAAiB,CAAC;CACxB,KAAK,MAAM,CAAC,OAAO,UAAU,MAAM,WAAW,QAAQ,QAAQ,GAAG;EAC/D,MAAM,OAAO,MAAM,aAAa,IAAI,MAAM,WAAW;EACrD,MAAM,WAAW,KAAK,MAAM,GAAG,aAAa,KAAK,KAAK,MAAM,cAAc,GAAG,MAAM,CAAC;EAIpF,MAAM,QAA6B;GACjC,aAAa,MAAM;GACnB,gBAAgB,SAAS,WAAW;GACpC,QAAQ,MAAM;GACd,QAAQ,MAAM;EAChB;EACA,SAAS,SAAS,KAAK,KAAK;EAC5B,IAAI;GACF,MAAM,cAAc,SAAS,cAAc;GAC3C,IAAI,CAAC,aAAa,MAAM,IAAI,MAAM,uCAAuC;GACzE,KAAK,MAAM,SAAS,CAAC,YAAY,OAAO,YAAY,IAAI,GAAG;IACzD,IAAI,OAAO,UAAU,YAAY,CAAC,MAAM,WAAW,IAAI,KAAK,MAAM,SAAS,IAAI,KAAK,WAAW,KAAK,KAAK,GACvG,MAAM,IAAI,MAAM,kEAAkE;IACpF,IAAI,UAAU,YAAY,MAAM;KAC9B,MAAM,WAAW,KAAK,SAAS,GAAG,aAAa,IAAI,GAAG,GAAG,aAAa,KAAK,KAAK,MAAM,KAAK,CAAC,CAAC;KAC7F,IAAI,SAAS,WAAW,IAAI,KAAK,KAAK,WAAW,QAAQ,GAAG,MAAM,IAAI,MAAM,gCAAgC;IAC9G;GACF;GACA,MAAM,QAAQ,KAAK,QAAQ,MAAM,YAAY,IAAK;GAClD,MAAM,UAAU;IACd,gBAAgB,MAAM;IACtB,sBAAsB,MAAM;IAC5B,iBAAiB,KAAK,KAAK,MAAM,iBAAiB,aAAa,OAAO,KAAK,CAAC;IAC5E,YAAY;GACd;GACA,MAAM,SAAS,MAAM,uBAAuB,OAAO,MAAM,gBAAgB,OAAO;GAChF,kBAAkB,GAAG,MAAM,cAAc,8BAA8B,4BACrE,OACA,MAAM,gBACN,OACF;GACA,MAAM,SAAS,KAAK,KAAK,SAAS,MAAM,iBAAiB,MAAM,CAAC,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG;GAEzF,MAAM,EAAE,WAAW,MAAM,QACvB,QAAQ,UACR;IACE;IACA;IACA;IACA,cAAc,MAAM,CAAC,CAAC;GACxB,GACA;IAAE,SAAS;IAAQ,WAAW;GAAiB,CACjD;GACA,MAAM,WAAW,iBAAiB,KAAK,MAAM,MAAM,CAAC;EACtD,SAAS,OAAO;GACd,MAAM,WACJ,UAAU,QACV,OAAO,UAAU,YACjB,YAAY,SACZ,OAAO,MAAM,WAAW,YACxB,MAAM,OAAO,KAAK,IACd,MAAM,OAAO,KAAK,IAClB,iBAAiB,QACf,MAAM,UACN,OAAO,KAAK,EAAA,CAClB,MAAM,GAAG,GAAI;GACf,KAAK,KAAK,GAAG,MAAM,YAAY,IAAI,MAAM,SAAS;EACpD;CACF;CACA,MAAM,QAAQ,sBAAsB,QAAQ;CAC5C,GAAG,cAAc,KAAK,KAAK,MAAM,iBAAiB,sBAAsB,GAAG,KAAK;CAChF,OAAO;EACL,WAAW;GAAE,MAAM,KAAK;GAA0B,QAAQ,OAAO,WAAW,QAAQ,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,OAAO,KAAK;EAAE;EAClH;EACA;CACF;AACF"}

package/dist/builders/cli/bootstrapClaim.cjs

@@ -0,0 +1,53 @@
+const require_runtime = require("../../_virtual/_rolldown/runtime.cjs");
+let node_path = require("node:path");
+node_path = require_runtime.__toESM(node_path, 1);
+//#region src/builders/cli/bootstrapClaim.ts
+/**
+* Process-wide ownership of one repository's DoomPi load cycle.
+*
+* Pi unions the extension lists of its user and project settings scopes and
+* dedupes only by the resolved file's real path, so registering DoomPi in both
+* scopes loads two separate installs of the same package. Each one would
+* otherwise read, recompile, and rewrite the same home-scoped worktree state
+* for the same repository, and two installs at different versions disagree about the state
+* contract. A process-global symbol survives the distinct module URLs those
+* installs have, so the first factory owns the cycle and the rest stand down.
+* Pi resolves project resources before user ones, which makes the owner the
+* repository-local install whenever both scopes register the package.
+*/
+const BOOTSTRAP_CLAIM_KEY = Symbol.for("@agimon-ai/doompi:bootstrap-claim");
+/**
+* The registry shared by every DoomPi install in this process.
+*
+* The symbol description is part of the cross-install contract and must stay
+* exactly as written: two installs only meet here when they compute the same
+* key. A value of another shape belongs to an install that spelled the
+* registry differently, so this one starts its own rather than corrupting it.
+*/
+function claimRegistry() {
+	const existing = Reflect.get(globalThis, BOOTSTRAP_CLAIM_KEY);
+	if (existing instanceof Map) return existing;
+	const created = /* @__PURE__ */ new Map();
+	Reflect.set(globalThis, BOOTSTRAP_CLAIM_KEY, created);
+	return created;
+}
+/**
+* Claims the load cycle for one repository, or reports that it is already owned.
+*
+* Callers must acquire before their first `await`, because releasing happens on
+* `session_start` and an interleaved second factory would otherwise slip in.
+*/
+function acquireBootstrapClaim(repoRoot) {
+	const registry = claimRegistry();
+	const key = node_path.default.resolve(repoRoot);
+	if (registry.has(key)) return void 0;
+	const claim = Symbol("doompi-bootstrap");
+	registry.set(key, claim);
+	return () => {
+		if (registry.get(key) === claim) registry.delete(key);
+	};
+}
+//#endregion
+exports.acquireBootstrapClaim = acquireBootstrapClaim;
+
+//# sourceMappingURL=bootstrapClaim.cjs.map

package/dist/builders/cli/bootstrapClaim.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrapClaim.cjs","names":["path"],"sources":["../../../src/builders/cli/bootstrapClaim.ts"],"sourcesContent":["import path from 'node:path';\n\n/**\n * Process-wide ownership of one repository's DoomPi load cycle.\n *\n * Pi unions the extension lists of its user and project settings scopes and\n * dedupes only by the resolved file's real path, so registering DoomPi in both\n * scopes loads two separate installs of the same package. Each one would\n * otherwise read, recompile, and rewrite the same home-scoped worktree state\n * for the same repository, and two installs at different versions disagree about the state\n * contract. A process-global symbol survives the distinct module URLs those\n * installs have, so the first factory owns the cycle and the rest stand down.\n * Pi resolves project resources before user ones, which makes the owner the\n * repository-local install whenever both scopes register the package.\n */\n\nconst BOOTSTRAP_CLAIM_KEY = Symbol.for('@agimon-ai/doompi:bootstrap-claim');\n\nexport type ReleaseBootstrapClaim = () => void;\n\n/**\n * The registry shared by every DoomPi install in this process.\n *\n * The symbol description is part of the cross-install contract and must stay\n * exactly as written: two installs only meet here when they compute the same\n * key. A value of another shape belongs to an install that spelled the\n * registry differently, so this one starts its own rather than corrupting it.\n */\nfunction claimRegistry(): Map<string, symbol> {\n  const existing = Reflect.get(globalThis, BOOTSTRAP_CLAIM_KEY);\n  if (existing instanceof Map) return existing as Map<string, symbol>;\n  const created = new Map<string, symbol>();\n  Reflect.set(globalThis, BOOTSTRAP_CLAIM_KEY, created);\n  return created;\n}\n\n/**\n * Claims the load cycle for one repository, or reports that it is already owned.\n *\n * Callers must acquire before their first `await`, because releasing happens on\n * `session_start` and an interleaved second factory would otherwise slip in.\n */\nexport function acquireBootstrapClaim(repoRoot: string): ReleaseBootstrapClaim | undefined {\n  const registry = claimRegistry();\n  const key = path.resolve(repoRoot);\n  if (registry.has(key)) return undefined;\n\n  const claim = Symbol('doompi-bootstrap');\n  registry.set(key, claim);\n  return () => {\n    if (registry.get(key) === claim) registry.delete(key);\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAgBA,MAAM,sBAAsB,OAAO,IAAI,mCAAmC;;;;;;;;;AAY1E,SAAS,gBAAqC;CAC5C,MAAM,WAAW,QAAQ,IAAI,YAAY,mBAAmB;CAC5D,IAAI,oBAAoB,KAAK,OAAO;CACpC,MAAM,0BAAU,IAAI,IAAoB;CACxC,QAAQ,IAAI,YAAY,qBAAqB,OAAO;CACpD,OAAO;AACT;;;;;;;AAQA,SAAgB,sBAAsB,UAAqD;CACzF,MAAM,WAAW,cAAc;CAC/B,MAAM,MAAMA,UAAAA,QAAK,QAAQ,QAAQ;CACjC,IAAI,SAAS,IAAI,GAAG,GAAG,OAAO,KAAA;CAE9B,MAAM,QAAQ,OAAO,kBAAkB;CACvC,SAAS,IAAI,KAAK,KAAK;CACvB,aAAa;EACX,IAAI,SAAS,IAAI,GAAG,MAAM,OAAO,SAAS,OAAO,GAAG;CACtD;AACF"}

package/dist/builders/cli/bootstrapClaim.mjs

@@ -0,0 +1,51 @@
+import path from "node:path";
+//#region src/builders/cli/bootstrapClaim.ts
+/**
+* Process-wide ownership of one repository's DoomPi load cycle.
+*
+* Pi unions the extension lists of its user and project settings scopes and
+* dedupes only by the resolved file's real path, so registering DoomPi in both
+* scopes loads two separate installs of the same package. Each one would
+* otherwise read, recompile, and rewrite the same home-scoped worktree state
+* for the same repository, and two installs at different versions disagree about the state
+* contract. A process-global symbol survives the distinct module URLs those
+* installs have, so the first factory owns the cycle and the rest stand down.
+* Pi resolves project resources before user ones, which makes the owner the
+* repository-local install whenever both scopes register the package.
+*/
+const BOOTSTRAP_CLAIM_KEY = Symbol.for("@agimon-ai/doompi:bootstrap-claim");
+/**
+* The registry shared by every DoomPi install in this process.
+*
+* The symbol description is part of the cross-install contract and must stay
+* exactly as written: two installs only meet here when they compute the same
+* key. A value of another shape belongs to an install that spelled the
+* registry differently, so this one starts its own rather than corrupting it.
+*/
+function claimRegistry() {
+	const existing = Reflect.get(globalThis, BOOTSTRAP_CLAIM_KEY);
+	if (existing instanceof Map) return existing;
+	const created = /* @__PURE__ */ new Map();
+	Reflect.set(globalThis, BOOTSTRAP_CLAIM_KEY, created);
+	return created;
+}
+/**
+* Claims the load cycle for one repository, or reports that it is already owned.
+*
+* Callers must acquire before their first `await`, because releasing happens on
+* `session_start` and an interleaved second factory would otherwise slip in.
+*/
+function acquireBootstrapClaim(repoRoot) {
+	const registry = claimRegistry();
+	const key = path.resolve(repoRoot);
+	if (registry.has(key)) return void 0;
+	const claim = Symbol("doompi-bootstrap");
+	registry.set(key, claim);
+	return () => {
+		if (registry.get(key) === claim) registry.delete(key);
+	};
+}
+//#endregion
+export { acquireBootstrapClaim };
+
+//# sourceMappingURL=bootstrapClaim.mjs.map

package/dist/builders/cli/bootstrapClaim.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrapClaim.mjs","names":[],"sources":["../../../src/builders/cli/bootstrapClaim.ts"],"sourcesContent":["import path from 'node:path';\n\n/**\n * Process-wide ownership of one repository's DoomPi load cycle.\n *\n * Pi unions the extension lists of its user and project settings scopes and\n * dedupes only by the resolved file's real path, so registering DoomPi in both\n * scopes loads two separate installs of the same package. Each one would\n * otherwise read, recompile, and rewrite the same home-scoped worktree state\n * for the same repository, and two installs at different versions disagree about the state\n * contract. A process-global symbol survives the distinct module URLs those\n * installs have, so the first factory owns the cycle and the rest stand down.\n * Pi resolves project resources before user ones, which makes the owner the\n * repository-local install whenever both scopes register the package.\n */\n\nconst BOOTSTRAP_CLAIM_KEY = Symbol.for('@agimon-ai/doompi:bootstrap-claim');\n\nexport type ReleaseBootstrapClaim = () => void;\n\n/**\n * The registry shared by every DoomPi install in this process.\n *\n * The symbol description is part of the cross-install contract and must stay\n * exactly as written: two installs only meet here when they compute the same\n * key. A value of another shape belongs to an install that spelled the\n * registry differently, so this one starts its own rather than corrupting it.\n */\nfunction claimRegistry(): Map<string, symbol> {\n  const existing = Reflect.get(globalThis, BOOTSTRAP_CLAIM_KEY);\n  if (existing instanceof Map) return existing as Map<string, symbol>;\n  const created = new Map<string, symbol>();\n  Reflect.set(globalThis, BOOTSTRAP_CLAIM_KEY, created);\n  return created;\n}\n\n/**\n * Claims the load cycle for one repository, or reports that it is already owned.\n *\n * Callers must acquire before their first `await`, because releasing happens on\n * `session_start` and an interleaved second factory would otherwise slip in.\n */\nexport function acquireBootstrapClaim(repoRoot: string): ReleaseBootstrapClaim | undefined {\n  const registry = claimRegistry();\n  const key = path.resolve(repoRoot);\n  if (registry.has(key)) return undefined;\n\n  const claim = Symbol('doompi-bootstrap');\n  registry.set(key, claim);\n  return () => {\n    if (registry.get(key) === claim) registry.delete(key);\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;AAgBA,MAAM,sBAAsB,OAAO,IAAI,mCAAmC;;;;;;;;;AAY1E,SAAS,gBAAqC;CAC5C,MAAM,WAAW,QAAQ,IAAI,YAAY,mBAAmB;CAC5D,IAAI,oBAAoB,KAAK,OAAO;CACpC,MAAM,0BAAU,IAAI,IAAoB;CACxC,QAAQ,IAAI,YAAY,qBAAqB,OAAO;CACpD,OAAO;AACT;;;;;;;AAQA,SAAgB,sBAAsB,UAAqD;CACzF,MAAM,WAAW,cAAc;CAC/B,MAAM,MAAM,KAAK,QAAQ,QAAQ;CACjC,IAAI,SAAS,IAAI,GAAG,GAAG,OAAO,KAAA;CAE9B,MAAM,QAAQ,OAAO,kBAAkB;CACvC,SAAS,IAAI,KAAK,KAAK;CACvB,aAAa;EACX,IAAI,SAAS,IAAI,GAAG,MAAM,OAAO,SAAS,OAAO,GAAG;CACtD;AACF"}

package/dist/builders/cli/bootstrapLocator/index.cjs

@@ -0,0 +1,204 @@
+const require_runtime = require("../../../_virtual/_rolldown/runtime.cjs");
+const require_index = require("../../../composition/repository/index.cjs");
+const require_entryResolution = require("../entryResolution.cjs");
+const require_index$1 = require("../../../composition/syncState/index.cjs");
+const require_inputs = require("../../../compiler/inputs.cjs");
+let node_fs = require("node:fs");
+node_fs = require_runtime.__toESM(node_fs, 1);
+let node_path = require("node:path");
+node_path = require_runtime.__toESM(node_path, 1);
+let _agimon_ai_doompi_core_sync_registration = require("@agimon-ai/doompi-core/sync-registration");
+let node_os = require("node:os");
+node_os = require_runtime.__toESM(node_os, 1);
+let node_crypto = require("node:crypto");
+node_crypto = require_runtime.__toESM(node_crypto, 1);
+let _agimon_ai_doompi_core_sync_state_contract = require("@agimon-ai/doompi-core/sync-state-contract");
+//#region src/builders/cli/bootstrapLocator/index.ts
+const BOOTSTRAP_ENTRY_ENV = "DOOMPI_BOOTSTRAP_ENTRY";
+const SHA256 = /^[a-f0-9]{64}$/u;
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function stringRecord(value) {
+	if (!isRecord(value)) return {};
+	return Object.fromEntries(Object.entries(value).filter((entry) => typeof entry[1] === "string"));
+}
+function canonicalPath(target) {
+	const absolute = node_path.default.resolve(target);
+	try {
+		return node_fs.default.realpathSync(absolute);
+	} catch {
+		const parent = node_path.default.dirname(absolute);
+		if (parent === absolute) return absolute;
+		return node_path.default.join(canonicalPath(parent), node_path.default.basename(absolute));
+	}
+}
+function isInside(directory, target) {
+	const relative = node_path.default.relative(canonicalPath(directory), canonicalPath(target));
+	return relative === "" || !relative.startsWith("..") && !node_path.default.isAbsolute(relative);
+}
+function parseFingerprints(value) {
+	if (!Array.isArray(value)) return void 0;
+	const fingerprints = value.map(require_inputs.parseInputFingerprint);
+	return fingerprints.some((fingerprint) => fingerprint === void 0) ? void 0 : fingerprints;
+}
+function packagedDoomEntry() {
+	return process.env[BOOTSTRAP_ENTRY_ENV] || require_entryResolution.ownEntry("composedPi");
+}
+function locationHasState(repoRoot, homeDirectory) {
+	return (0, _agimon_ai_doompi_core_sync_registration.readSyncRegistration)(repoRoot, homeDirectory) !== void 0;
+}
+/** Finds the nearest configured repository with generated Doom sync state. */
+function findSyncedRoot(cwd, homeDirectory = node_os.default.homedir()) {
+	if (locationHasState(cwd, homeDirectory)) return canonicalPath(cwd);
+	const root = require_index.resolveDoomConfigurationRoot(cwd, homeDirectory);
+	return locationHasState(root, homeDirectory) ? canonicalPath(root) : void 0;
+}
+function readBootstrapState(repoRoot, homeDirectory = node_os.default.homedir()) {
+	const registration = (0, _agimon_ai_doompi_core_sync_registration.readSyncRegistration)(repoRoot, homeDirectory);
+	if (!registration) return void 0;
+	const statePath = registration.statePath;
+	const generatedDirectory = registration.generationRoot;
+	const state = require_index$1.readSyncState(repoRoot, homeDirectory);
+	if (!state) return void 0;
+	const bootstrap = typeof state.bootstrap === "string" ? state.bootstrap : void 0;
+	if (bootstrap && !isInside(generatedDirectory, bootstrap)) throw new Error(`Doom bootstrap must stay inside ${generatedDirectory}: ${bootstrap}`);
+	let precompile;
+	if (state.precompile !== void 0) {
+		const value = state.precompile;
+		if (!isRecord(value) || typeof value.version !== "number" || value.strategy !== _agimon_ai_doompi_core_sync_state_contract.BUNDLED_PRECOMPILE_STRATEGY || typeof value.bootstrapEntry !== "string" || typeof value.bootstrapManifest !== "string" || !isRecord(value.bundleManifests) || Object.values(value.bundleManifests).some((manifest) => typeof manifest !== "string")) throw new Error(`Doom sync state at ${statePath} has an invalid precompile record`);
+		precompile = {
+			version: value.version,
+			strategy: value.strategy,
+			bootstrapEntry: value.bootstrapEntry,
+			bootstrapManifest: value.bootstrapManifest,
+			bundleManifests: value.bundleManifests
+		};
+	}
+	return {
+		statePath,
+		generatedDirectory,
+		bootstrap,
+		bundles: stringRecord(state.bundles),
+		precompile
+	};
+}
+function readCompilerManifest(manifestPath, generatedDirectory) {
+	if (!isInside(generatedDirectory, manifestPath)) return void 0;
+	try {
+		const parsed = JSON.parse(node_fs.default.readFileSync(manifestPath, "utf8"));
+		if (!isRecord(parsed) || typeof parsed.output !== "string" || !Array.isArray(parsed.artifacts) || parsed.artifacts.some((artifact) => typeof artifact !== "string") || !Array.isArray(parsed.entries) || parsed.entries.some((entry) => typeof entry !== "string") || !Array.isArray(parsed.inputs) || parsed.artifactInputs !== void 0 && !Array.isArray(parsed.artifactInputs)) return;
+		const inputs = parseFingerprints(parsed.inputs);
+		const artifactInputs = parsed.artifactInputs === void 0 ? void 0 : parseFingerprints(parsed.artifactInputs);
+		if (!inputs || parsed.artifactInputs !== void 0 && !artifactInputs) return void 0;
+		const artifacts = parsed.artifacts;
+		const entries = parsed.entries;
+		if (!isInside(generatedDirectory, parsed.output) || artifacts.some((artifact) => !isInside(generatedDirectory, artifact))) return;
+		return {
+			output: parsed.output,
+			artifacts,
+			entries,
+			inputs,
+			...artifactInputs ? { artifactInputs } : {}
+		};
+	} catch {
+		return;
+	}
+}
+function artifactInputsAreIntact(manifest, generatedDirectory) {
+	try {
+		if (!manifest.artifactInputs || manifest.artifactInputs.length === 0) return false;
+		const expected = new Set([manifest.output, ...manifest.artifacts].map(canonicalPath));
+		const seen = /* @__PURE__ */ new Set();
+		for (const input of manifest.artifactInputs) {
+			if (!SHA256.test(input.sha256) || !isInside(generatedDirectory, input.path)) return false;
+			const target = canonicalPath(input.path);
+			if (!expected.has(target)) return false;
+			const stat = node_fs.default.statSync(target);
+			if (!stat.isFile() || stat.size !== input.size) return false;
+			if (node_crypto.default.createHash("sha256").update(node_fs.default.readFileSync(target)).digest("hex") !== input.sha256) return false;
+			seen.add(target);
+		}
+		return seen.size === expected.size;
+	} catch {
+		return false;
+	}
+}
+function compilerManifestIsUsable(manifest, generatedDirectory) {
+	return artifactInputsAreIntact(manifest, generatedDirectory);
+}
+function compilerManifestIsFresh(manifest, generatedDirectory) {
+	return compilerManifestIsUsable(manifest, generatedDirectory) && require_inputs.inputsAreFresh(manifest.inputs);
+}
+function bootstrapRecord(state, expectedBootstrapEntry, requireFreshInputs) {
+	if (!state.bootstrap || !state.precompile) return void 0;
+	if (state.precompile.version !== _agimon_ai_doompi_core_sync_state_contract.PRECOMPILE_STATE_VERSION || canonicalPath(state.precompile.bootstrapEntry) !== canonicalPath(expectedBootstrapEntry)) return;
+	const record = readCompilerManifest(state.precompile.bootstrapManifest, state.generatedDirectory);
+	if (!record || !compilerManifestIsUsable(record, state.generatedDirectory) || requireFreshInputs && !compilerManifestIsFresh(record, state.generatedDirectory) || record.output !== state.bootstrap || record.entries.length !== 1 || canonicalPath(record.entries[0] ?? "") !== canonicalPath(expectedBootstrapEntry)) return;
+	return record;
+}
+function usableBootstrapRecord(state, expectedBootstrapEntry) {
+	return bootstrapRecord(state, expectedBootstrapEntry, false);
+}
+function freshBootstrapRecord(state, expectedBootstrapEntry) {
+	return bootstrapRecord(state, expectedBootstrapEntry, true);
+}
+/** Validates only the bootstrap graph needed before the generated bootstrap is imported. */
+function readStartupBootstrapStatus(repoRoot, expectedBootstrapEntry, homeDirectory = node_os.default.homedir()) {
+	const state = readBootstrapState(repoRoot, homeDirectory);
+	const expected = expectedBootstrapEntry ?? packagedDoomEntry();
+	if (!state) return {
+		bootstrap: void 0,
+		fresh: false
+	};
+	return {
+		bootstrap: state.bootstrap,
+		fresh: usableBootstrapRecord(state, expected) !== void 0
+	};
+}
+/** Validates one selected composition without touching any inactive bundle inputs. */
+function readBundleStatus(repoRoot, compositionFingerprint, homeDirectory = node_os.default.homedir()) {
+	const state = readBootstrapState(repoRoot, homeDirectory);
+	const bundle = state?.bundles[compositionFingerprint];
+	const manifestPath = state?.precompile?.bundleManifests[compositionFingerprint];
+	if (!state || state.precompile?.version !== _agimon_ai_doompi_core_sync_state_contract.PRECOMPILE_STATE_VERSION || !bundle || !manifestPath) return {
+		bundle,
+		fresh: false
+	};
+	const manifest = readCompilerManifest(manifestPath, state.generatedDirectory);
+	return {
+		bundle,
+		fresh: Boolean(manifest && manifest.output === bundle && compilerManifestIsUsable(manifest, state.generatedDirectory))
+	};
+}
+/** Validates the bootstrap and every bundle for `doompi sync --check` diagnostics. */
+function readBootstrapStatus(repoRoot, expectedBootstrapEntry, homeDirectory = node_os.default.homedir()) {
+	const state = readBootstrapState(repoRoot, homeDirectory);
+	const expected = expectedBootstrapEntry ?? packagedDoomEntry();
+	if (!state?.bootstrap || !state.precompile || !freshBootstrapRecord(state, expected)) return {
+		bootstrap: state?.bootstrap,
+		fresh: false
+	};
+	const manifests = Object.values(state.precompile.bundleManifests);
+	if (new Set(manifests).size !== manifests.length) return {
+		bootstrap: state.bootstrap,
+		fresh: false
+	};
+	const fresh = Object.entries(state.bundles).every(([fingerprint, bundle]) => {
+		const manifestPath = state.precompile?.bundleManifests[fingerprint];
+		if (!manifestPath) return false;
+		const manifest = readCompilerManifest(manifestPath, state.generatedDirectory);
+		return Boolean(manifest && manifest.output === bundle && compilerManifestIsFresh(manifest, state.generatedDirectory));
+	});
+	return {
+		bootstrap: state.bootstrap,
+		fresh
+	};
+}
+//#endregion
+exports.findSyncedRoot = findSyncedRoot;
+exports.readBootstrapStatus = readBootstrapStatus;
+exports.readBundleStatus = readBundleStatus;
+exports.readStartupBootstrapStatus = readStartupBootstrapStatus;
+
+//# sourceMappingURL=index.cjs.map