@agimon-ai/po 0.0.0-alpha.0

package/dist/services.cjs

@@ -0,0 +1,97 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_process = require("./src/cli/commands/compat/providers/process.cjs");
+const require_antigravity = require("./src/cli/commands/compat/providers/antigravity.cjs");
+const require_codex = require("./src/cli/commands/compat/providers/codex.cjs");
+const require_context = require("./src/cli/commands/compat/context.cjs");
+const require_index = require("./src/cli/commands/compat/providers/index.cjs");
+const require_index$1 = require("./src/composition/layerPackageInstaller/index.cjs");
+const require_harnessContext = require("./src/builders/cli/harnessContext.cjs");
+let _agimon_ai_po_domain_mcp = require("@agimon-ai/po-domain/mcp");
+let _agimon_ai_po_domain_resources = require("@agimon-ai/po-domain/resources");
+let _agimon_ai_po_domain_apply = require("@agimon-ai/po-domain/apply");
+let _agimon_ai_po_minor_mode_catalog = require("@agimon-ai/po-minor-mode/catalog");
+Object.defineProperty(exports, "DISPATCHER_AGENT_NAME", {
+	enumerable: true,
+	get: function() {
+		return _agimon_ai_po_domain_resources.DISPATCHER_AGENT_NAME;
+	}
+});
+Object.defineProperty(exports, "PROXY_SERVER_NAME", {
+	enumerable: true,
+	get: function() {
+		return _agimon_ai_po_domain_mcp.PROXY_SERVER_NAME;
+	}
+});
+Object.defineProperty(exports, "adaptAgentDefinition", {
+	enumerable: true,
+	get: function() {
+		return _agimon_ai_po_domain_resources.adaptAgentDefinition;
+	}
+});
+exports.adaptAntigravityMcpDefinition = require_antigravity.adaptAntigravityMcpDefinition;
+exports.antigravityCompatibilityArgs = require_antigravity.antigravityCompatibilityArgs;
+Object.defineProperty(exports, "applyDomains", {
+	enumerable: true,
+	get: function() {
+		return _agimon_ai_po_domain_apply.applyDomains;
+	}
+});
+Object.defineProperty(exports, "applyMcpAllowlist", {
+	enumerable: true,
+	get: function() {
+		return _agimon_ai_po_domain_mcp.applyMcpAllowlist;
+	}
+});
+exports.buildCompatibilityContext = require_context.buildCompatibilityContext;
+exports.buildHarnessContext = require_harnessContext.buildHarnessContext;
+exports.claudeCompatibilityArgs = require_index.claudeCompatibilityArgs;
+exports.codexCompatibilityArgs = require_codex.codexCompatibilityArgs;
+Object.defineProperty(exports, "collectResources", {
+	enumerable: true,
+	get: function() {
+		return _agimon_ai_po_domain_resources.collectResources;
+	}
+});
+exports.configurePreset = require_harnessContext.configurePreset;
+Object.defineProperty(exports, "createMinorModeCatalogHost", {
+	enumerable: true,
+	get: function() {
+		return _agimon_ai_po_minor_mode_catalog.createMinorModeCatalogHost;
+	}
+});
+exports.ensureLayerPackages = require_index$1.ensureLayerPackages;
+Object.defineProperty(exports, "filterMcpServers", {
+	enumerable: true,
+	get: function() {
+		return _agimon_ai_po_domain_mcp.filterMcpServers;
+	}
+});
+Object.defineProperty(exports, "filterProxyConfig", {
+	enumerable: true,
+	get: function() {
+		return _agimon_ai_po_domain_mcp.filterProxyConfig;
+	}
+});
+exports.launchCompatibility = require_index.launchCompatibility;
+Object.defineProperty(exports, "mergeMcpConfigs", {
+	enumerable: true,
+	get: function() {
+		return _agimon_ai_po_domain_resources.mergeMcpConfigs;
+	}
+});
+Object.defineProperty(exports, "persistMcpConfig", {
+	enumerable: true,
+	get: function() {
+		return _agimon_ai_po_domain_mcp.persistMcpConfig;
+	}
+});
+exports.resolveHarnessProfile = require_harnessContext.resolveHarnessProfile;
+Object.defineProperty(exports, "resolveMcpAllowlist", {
+	enumerable: true,
+	get: function() {
+		return _agimon_ai_po_domain_mcp.resolveMcpAllowlist;
+	}
+});
+exports.runInteractive = require_process.runInteractive;
+exports.signalExitCode = require_process.signalExitCode;
+exports.supportsCodexManagedProfile = require_codex.supportsCodexManagedProfile;

package/dist/services.d.mts

@@ -0,0 +1,12 @@
+import { CompatibilityContext, buildCompatibilityContext } from "./src/cli/commands/compat/context.mjs";
+import { adaptAntigravityMcpDefinition, antigravityCompatibilityArgs } from "./src/cli/commands/compat/providers/antigravity.mjs";
+import { HarnessContext, buildHarnessContext, configurePreset, resolveHarnessProfile } from "./src/builders/cli/harnessContext.mjs";
+import { codexCompatibilityArgs, supportsCodexManagedProfile } from "./src/cli/commands/compat/providers/codex.mjs";
+import { EnsureLayerPackagesOptions, ensureLayerPackages } from "./src/composition/layerPackageInstaller/index.mjs";
+import { runInteractive, signalExitCode } from "./src/cli/commands/compat/providers/process.mjs";
+import { claudeCompatibilityArgs, launchCompatibility } from "./src/cli/commands/compat/providers/index.mjs";
+import { PROXY_SERVER_NAME, applyMcpAllowlist, filterMcpServers, filterProxyConfig, persistMcpConfig, resolveMcpAllowlist } from "@agimon-ai/po-domain/mcp";
+import { DISPATCHER_AGENT_NAME, adaptAgentDefinition, collectResources, mergeMcpConfigs } from "@agimon-ai/po-domain/resources";
+import { applyDomains } from "@agimon-ai/po-domain/apply";
+import { MinorModeCatalogHostOptions, createMinorModeCatalogHost } from "@agimon-ai/po-minor-mode/catalog";
+export { type CompatibilityContext, DISPATCHER_AGENT_NAME, type EnsureLayerPackagesOptions, type HarnessContext, type MinorModeCatalogHostOptions, PROXY_SERVER_NAME, adaptAgentDefinition, adaptAntigravityMcpDefinition, antigravityCompatibilityArgs, applyDomains, applyMcpAllowlist, buildCompatibilityContext, buildHarnessContext, claudeCompatibilityArgs, codexCompatibilityArgs, collectResources, configurePreset, createMinorModeCatalogHost, ensureLayerPackages, filterMcpServers, filterProxyConfig, launchCompatibility, mergeMcpConfigs, persistMcpConfig, resolveHarnessProfile, resolveMcpAllowlist, runInteractive, signalExitCode, supportsCodexManagedProfile };

package/dist/services.mjs

@@ -0,0 +1,12 @@
+import { runInteractive, signalExitCode } from "./src/cli/commands/compat/providers/process.mjs";
+import { adaptAntigravityMcpDefinition, antigravityCompatibilityArgs } from "./src/cli/commands/compat/providers/antigravity.mjs";
+import { codexCompatibilityArgs, supportsCodexManagedProfile } from "./src/cli/commands/compat/providers/codex.mjs";
+import { buildCompatibilityContext } from "./src/cli/commands/compat/context.mjs";
+import { claudeCompatibilityArgs, launchCompatibility } from "./src/cli/commands/compat/providers/index.mjs";
+import { ensureLayerPackages } from "./src/composition/layerPackageInstaller/index.mjs";
+import { buildHarnessContext, configurePreset, resolveHarnessProfile } from "./src/builders/cli/harnessContext.mjs";
+import { PROXY_SERVER_NAME, applyMcpAllowlist, filterMcpServers, filterProxyConfig, persistMcpConfig, resolveMcpAllowlist } from "@agimon-ai/po-domain/mcp";
+import { DISPATCHER_AGENT_NAME, adaptAgentDefinition, collectResources, mergeMcpConfigs } from "@agimon-ai/po-domain/resources";
+import { applyDomains } from "@agimon-ai/po-domain/apply";
+import { createMinorModeCatalogHost } from "@agimon-ai/po-minor-mode/catalog";
+export { DISPATCHER_AGENT_NAME, PROXY_SERVER_NAME, adaptAgentDefinition, adaptAntigravityMcpDefinition, antigravityCompatibilityArgs, applyDomains, applyMcpAllowlist, buildCompatibilityContext, buildHarnessContext, claudeCompatibilityArgs, codexCompatibilityArgs, collectResources, configurePreset, createMinorModeCatalogHost, ensureLayerPackages, filterMcpServers, filterProxyConfig, launchCompatibility, mergeMcpConfigs, persistMcpConfig, resolveHarnessProfile, resolveMcpAllowlist, runInteractive, signalExitCode, supportsCodexManagedProfile };

package/dist/shared.cjs

@@ -0,0 +1,18 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_shared = require("./src/cli/commands/compat/providers/shared.cjs");
+exports.ADD_DIRECTORY_OPTION = require_shared.ADD_DIRECTORY_OPTION;
+exports.AGIFLOW_PROXY_SERVER_NAME = require_shared.AGIFLOW_PROXY_SERVER_NAME;
+exports.ANTIGRAVITY_MCP_PROXY_PACKAGE = require_shared.ANTIGRAVITY_MCP_PROXY_PACKAGE;
+exports.CORE_PLUGIN_NAME = require_shared.CORE_PLUGIN_NAME;
+exports.MCP_CONFIG_OPTION = require_shared.MCP_CONFIG_OPTION;
+exports.MCP_PRESTART_OPTION = require_shared.MCP_PRESTART_OPTION;
+exports.MCP_PROXY_PACKAGE = require_shared.MCP_PROXY_PACKAGE;
+exports.MCP_PROXY_VERSION = require_shared.MCP_PROXY_VERSION;
+exports.MCP_SERVERS_KEY = require_shared.MCP_SERVERS_KEY;
+exports.NPX_COMMAND = require_shared.NPX_COMMAND;
+exports.PLUGINS_DIRECTORY = require_shared.PLUGINS_DIRECTORY;
+exports.PLUGIN_MANIFEST_FILENAME = require_shared.PLUGIN_MANIFEST_FILENAME;
+exports.SKILLS_DIRECTORY = require_shared.SKILLS_DIRECTORY;
+exports.SKIP_PERMISSIONS_OPTION = require_shared.SKIP_PERMISSIONS_OPTION;
+exports.additionalDirectoryArgs = require_shared.additionalDirectoryArgs;
+exports.mcpProxyArguments = require_shared.mcpProxyArguments;

package/dist/shared.d.mts

@@ -0,0 +1,2 @@
+import { ADD_DIRECTORY_OPTION, AGIFLOW_PROXY_SERVER_NAME, ANTIGRAVITY_MCP_PROXY_PACKAGE, CORE_PLUGIN_NAME, MCP_CONFIG_OPTION, MCP_PRESTART_OPTION, MCP_PROXY_PACKAGE, MCP_PROXY_VERSION, MCP_SERVERS_KEY, NPX_COMMAND, PLUGINS_DIRECTORY, PLUGIN_MANIFEST_FILENAME, SKILLS_DIRECTORY, SKIP_PERMISSIONS_OPTION, additionalDirectoryArgs, mcpProxyArguments } from "./src/cli/commands/compat/providers/shared.mjs";
+export { ADD_DIRECTORY_OPTION, AGIFLOW_PROXY_SERVER_NAME, ANTIGRAVITY_MCP_PROXY_PACKAGE, CORE_PLUGIN_NAME, MCP_CONFIG_OPTION, MCP_PRESTART_OPTION, MCP_PROXY_PACKAGE, MCP_PROXY_VERSION, MCP_SERVERS_KEY, NPX_COMMAND, PLUGINS_DIRECTORY, PLUGIN_MANIFEST_FILENAME, SKILLS_DIRECTORY, SKIP_PERMISSIONS_OPTION, additionalDirectoryArgs, mcpProxyArguments };

package/dist/shared.mjs

@@ -0,0 +1,2 @@
+import { ADD_DIRECTORY_OPTION, AGIFLOW_PROXY_SERVER_NAME, ANTIGRAVITY_MCP_PROXY_PACKAGE, CORE_PLUGIN_NAME, MCP_CONFIG_OPTION, MCP_PRESTART_OPTION, MCP_PROXY_PACKAGE, MCP_PROXY_VERSION, MCP_SERVERS_KEY, NPX_COMMAND, PLUGINS_DIRECTORY, PLUGIN_MANIFEST_FILENAME, SKILLS_DIRECTORY, SKIP_PERMISSIONS_OPTION, additionalDirectoryArgs, mcpProxyArguments } from "./src/cli/commands/compat/providers/shared.mjs";
+export { ADD_DIRECTORY_OPTION, AGIFLOW_PROXY_SERVER_NAME, ANTIGRAVITY_MCP_PROXY_PACKAGE, CORE_PLUGIN_NAME, MCP_CONFIG_OPTION, MCP_PRESTART_OPTION, MCP_PROXY_PACKAGE, MCP_PROXY_VERSION, MCP_SERVERS_KEY, NPX_COMMAND, PLUGINS_DIRECTORY, PLUGIN_MANIFEST_FILENAME, SKILLS_DIRECTORY, SKIP_PERMISSIONS_OPTION, additionalDirectoryArgs, mcpProxyArguments };

package/dist/src/bin/agentDirectory.cjs

@@ -0,0 +1,27 @@
+const require_runtime = require("../../_virtual/_rolldown/runtime.cjs");
+const require_index = require("../composition/poHomeMigration/index.cjs");
+let node_path = require("node:path");
+node_path = require_runtime.__toESM(node_path, 1);
+let node_os = require("node:os");
+node_os = require_runtime.__toESM(node_os, 1);
+//#region src/bin/agentDirectory.ts
+/**
+* Pins Pi's agent directory to Po's own, before anything else in the process
+* reads it.
+*
+* Every Po executable imports this first. It assigns unconditionally, so a
+* PI_CODING_AGENT_DIR exported for plain Pi cannot pull Po back into `~/.pi`;
+* PO_HOME is the supported way to move Po, agent directory included. Pi reads
+* the variable on every call, and the server freezes its environment after
+* this runs, so both sides agree. It also runs the one-time copy of `~/.pi/.po`.
+*/
+const poHome = (0, require("@agimon-ai/po-core/piSettings").poHomeDirectory)();
+process.env.PI_CODING_AGENT_DIR = node_path.default.join(poHome, "agent");
+try {
+	require_index.migratePoHome(process.env.HOME ?? node_os.default.homedir(), poHome);
+} catch (error) {
+	process.stderr.write(`[po] Could not move ~/.pi/.po into ${poHome}: ${error instanceof Error ? error.message : String(error)}\n`);
+}
+//#endregion
+
+//# sourceMappingURL=agentDirectory.cjs.map

package/dist/src/bin/agentDirectory.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentDirectory.cjs","names":["poHomeDirectory","path","os"],"sources":["../../../src/bin/agentDirectory.ts"],"sourcesContent":["/**\n * Pins Pi's agent directory to Po's own, before anything else in the process\n * reads it.\n *\n * Every Po executable imports this first. It assigns unconditionally, so a\n * PI_CODING_AGENT_DIR exported for plain Pi cannot pull Po back into `~/.pi`;\n * PO_HOME is the supported way to move Po, agent directory included. Pi reads\n * the variable on every call, and the server freezes its environment after\n * this runs, so both sides agree. It also runs the one-time copy of `~/.pi/.po`.\n */\n\nimport os from 'node:os';\nimport path from 'node:path';\n\nimport { poHomeDirectory } from '@agimon-ai/po-core/piSettings';\n\nimport { migratePoHome } from '../composition/poHomeMigration';\n\nconst poHome = poHomeDirectory();\nprocess.env.PI_CODING_AGENT_DIR = path.join(poHome, 'agent');\n\n// Before anything reads configuration: copy the user's data out of ~/.pi/.po once.\n// A failed copy must not stop Po from starting; the next start tries again.\ntry {\n  migratePoHome(process.env.HOME ?? os.homedir(), poHome);\n} catch (error) {\n  process.stderr.write(\n    `[po] Could not move ~/.pi/.po into ${poHome}: ${error instanceof Error ? error.message : String(error)}\\n`,\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAkBA,MAAM,UAAA,0CAASA,CAAAA,CAAAA,gBAAAA,CAAgB;AAC/B,QAAQ,IAAI,sBAAsBC,UAAAA,QAAK,KAAK,QAAQ,OAAO;AAI3D,IAAI;CACF,cAAA,cAAc,QAAQ,IAAI,QAAQC,QAAAA,QAAG,QAAQ,GAAG,MAAM;AACxD,SAAS,OAAO;CACd,QAAQ,OAAO,MACb,sCAAsC,OAAO,IAAI,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,EAAE,GAC1G;AACF"}

package/dist/src/bin/agentDirectory.mjs

@@ -0,0 +1,26 @@
+import { migratePoHome } from "../composition/poHomeMigration/index.mjs";
+import path from "node:path";
+import os from "node:os";
+import { poHomeDirectory } from "@agimon-ai/po-core/piSettings";
+//#region src/bin/agentDirectory.ts
+/**
+* Pins Pi's agent directory to Po's own, before anything else in the process
+* reads it.
+*
+* Every Po executable imports this first. It assigns unconditionally, so a
+* PI_CODING_AGENT_DIR exported for plain Pi cannot pull Po back into `~/.pi`;
+* PO_HOME is the supported way to move Po, agent directory included. Pi reads
+* the variable on every call, and the server freezes its environment after
+* this runs, so both sides agree. It also runs the one-time copy of `~/.pi/.po`.
+*/
+const poHome = poHomeDirectory();
+process.env.PI_CODING_AGENT_DIR = path.join(poHome, "agent");
+try {
+	migratePoHome(process.env.HOME ?? os.homedir(), poHome);
+} catch (error) {
+	process.stderr.write(`[po] Could not move ~/.pi/.po into ${poHome}: ${error instanceof Error ? error.message : String(error)}\n`);
+}
+//#endregion
+export {};
+
+//# sourceMappingURL=agentDirectory.mjs.map

package/dist/src/bin/agentDirectory.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentDirectory.mjs","names":[],"sources":["../../../src/bin/agentDirectory.ts"],"sourcesContent":["/**\n * Pins Pi's agent directory to Po's own, before anything else in the process\n * reads it.\n *\n * Every Po executable imports this first. It assigns unconditionally, so a\n * PI_CODING_AGENT_DIR exported for plain Pi cannot pull Po back into `~/.pi`;\n * PO_HOME is the supported way to move Po, agent directory included. Pi reads\n * the variable on every call, and the server freezes its environment after\n * this runs, so both sides agree. It also runs the one-time copy of `~/.pi/.po`.\n */\n\nimport os from 'node:os';\nimport path from 'node:path';\n\nimport { poHomeDirectory } from '@agimon-ai/po-core/piSettings';\n\nimport { migratePoHome } from '../composition/poHomeMigration';\n\nconst poHome = poHomeDirectory();\nprocess.env.PI_CODING_AGENT_DIR = path.join(poHome, 'agent');\n\n// Before anything reads configuration: copy the user's data out of ~/.pi/.po once.\n// A failed copy must not stop Po from starting; the next start tries again.\ntry {\n  migratePoHome(process.env.HOME ?? os.homedir(), poHome);\n} catch (error) {\n  process.stderr.write(\n    `[po] Could not move ~/.pi/.po into ${poHome}: ${error instanceof Error ? error.message : String(error)}\\n`,\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;AAkBA,MAAM,SAAS,gBAAgB;AAC/B,QAAQ,IAAI,sBAAsB,KAAK,KAAK,QAAQ,OAAO;AAI3D,IAAI;CACF,cAAc,QAAQ,IAAI,QAAQ,GAAG,QAAQ,GAAG,MAAM;AACxD,SAAS,OAAO;CACd,QAAQ,OAAO,MACb,sCAAsC,OAAO,IAAI,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,EAAE,GAC1G;AACF"}

package/dist/src/builders/apiContractExport/index.cjs

@@ -0,0 +1,126 @@
+const require_runtime = require("../../../_virtual/_rolldown/runtime.cjs");
+const require_index = require("../../composition/repository/index.cjs");
+const require_sessionComposition = require("../cli/sessionComposition.cjs");
+const require_index$1 = require("../server/index.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 node_child_process = require("node:child_process");
+let _agimon_ai_po_core_apiContracts = require("@agimon-ai/po-core/apiContracts");
+let _agimon_ai_po_config_config = require("@agimon-ai/po-config/config");
+let _agimon_ai_po_config_majorModes = require("@agimon-ai/po-config/majorModes");
+let node_url = require("node:url");
+let node_crypto = require("node:crypto");
+node_crypto = require_runtime.__toESM(node_crypto, 1);
+//#region src/builders/apiContractExport/index.ts
+const execute = (0, require("node:util").promisify)(node_child_process.execFile);
+/** Imports one built contract module and prints its default export as strict JSON. */
+const CONTRACT_PRINTER = "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; }";
+function problemOf(error) {
+	return ((error !== null && typeof error === "object" && "stderr" in error && typeof error.stderr === "string" ? error.stderr.trim() : "") || (error instanceof Error ? error.message : String(error))).slice(0, 1e3);
+}
+/**
+* Reads each server facet's built `poServer.contracts.dist` straight from its installed package.
+*
+* Contracts have their own entry so exporting never imports a server facet, and each one is
+* imported in a bounded child process so its module graph, timers and errors stay out of here.
+* A package without a readable contract is recorded as a gap rather than failing the export.
+*/
+async function collectApiContracts(candidates) {
+	const packages = [];
+	for (const { declaration, owners } of candidates) {
+		const root = declaration.packageDir;
+		const manifest = JSON.parse(node_fs.default.readFileSync(node_path.default.join(root, "package.json"), "utf8"));
+		const entry = {
+			packageName: declaration.packageName,
+			packageVersion: manifest.version ?? "unknown",
+			scopes: declaration.scopes,
+			owners: [...owners]
+		};
+		packages.push(entry);
+		try {
+			const contracts = manifest.poServer?.contracts;
+			if (!contracts) throw new Error("No poServer.contracts declaration");
+			for (const value of [contracts.entry, contracts.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");
+			const built = node_fs.default.realpathSync(node_path.default.join(root, contracts.dist));
+			const relative = node_path.default.relative(node_fs.default.realpathSync(root), built);
+			if (relative.startsWith("..") || node_path.default.isAbsolute(relative)) throw new Error("Contract entry escapes package");
+			const { stdout } = await execute(process.execPath, [
+				"--input-type=module",
+				"-e",
+				CONTRACT_PRINTER,
+				(0, node_url.pathToFileURL)(built).href
+			], {
+				timeout: 1e4,
+				maxBuffer: 16777216
+			});
+			entry.contract = (0, _agimon_ai_po_core_apiContracts.parseApiContract)(JSON.parse(stdout));
+		} catch (error) {
+			entry.problem = problemOf(error);
+		}
+	}
+	const fingerprint = node_crypto.default.createHash("sha256").update(JSON.stringify(packages.map(({ packageName, packageVersion }) => [packageName, packageVersion]))).digest("hex");
+	return (0, _agimon_ai_po_core_apiContracts.parseCompiledContracts)({
+		version: 1,
+		generation: "live",
+		fingerprint,
+		packages
+	});
+}
+/** Reads the installed packages of the global root and the workspace. Export never builds or activates a facet. */
+async function exportApiContracts(options) {
+	const environment = options.environment ?? process.env;
+	const globalRoot = (0, _agimon_ai_po_config_config.globalDoomConfigDirectory)(options.homeDirectory);
+	const workspaceRoot = require_index.resolveDoomConfigurationRoot(options.cwd, options.homeDirectory);
+	const read = async (root) => ({
+		compiled: await collectApiContracts(require_index$1.serverFacetCandidates(require_sessionComposition.rootCompositions({
+			root,
+			homeDirectory: options.homeDirectory,
+			environment
+		}))),
+		config: (0, _agimon_ai_po_config_majorModes.loadMajorModesConfig)(root, options.homeDirectory, environment)
+	});
+	const global = await read(globalRoot);
+	const workspace = globalRoot === workspaceRoot ? global : await read(workspaceRoot);
+	const sessionMode = options.majorMode ?? workspace.config.defaultMajorMode;
+	const selection = (source, scope, majorMode) => ({
+		scope,
+		majorMode,
+		activeLayers: (0, _agimon_ai_po_config_majorModes.resolveLayers)(source.config, majorMode),
+		compiled: source.compiled
+	});
+	if (!Object.hasOwn(workspace.config.majorMode, sessionMode)) throw new Error(`Unknown major mode '${sessionMode}'`);
+	const documents = (0, _agimon_ai_po_core_apiContracts.createApiDocuments)([
+		selection(global, "global", global.config.defaultMajorMode),
+		selection(workspace, "workspace", workspace.config.defaultMajorMode),
+		selection(workspace, "session", sessionMode)
+	]);
+	const files = {
+		"openapi.json": (0, _agimon_ai_po_core_apiContracts.canonicalContractJson)(documents.openapi),
+		"asyncapi.json": (0, _agimon_ai_po_core_apiContracts.canonicalContractJson)(documents.asyncapi)
+	};
+	const manifest = {
+		...documents.manifest,
+		artifacts: Object.fromEntries(Object.entries(files).map(([name, bytes]) => [name, { sha256: node_crypto.default.createHash("sha256").update(bytes).digest("hex") }]))
+	};
+	node_fs.default.mkdirSync(options.outputDirectory, { recursive: true });
+	for (const [name, bytes] of Object.entries({
+		...files,
+		"manifest.json": (0, _agimon_ai_po_core_apiContracts.canonicalContractJson)(manifest)
+	})) {
+		const target = node_path.default.join(options.outputDirectory, name);
+		const temporary = `${target}.${node_crypto.default.randomUUID()}.tmp`;
+		try {
+			node_fs.default.writeFileSync(temporary, bytes, { flag: "wx" });
+			node_fs.default.renameSync(temporary, target);
+		} finally {
+			node_fs.default.rmSync(temporary, { force: true });
+		}
+	}
+	return documents.manifest;
+}
+//#endregion
+exports.exportApiContracts = exportApiContracts;
+
+//# sourceMappingURL=index.cjs.map

package/dist/src/builders/apiContractExport/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["promisify","execFile","fs","path","pathToFileURL","parseApiContract","crypto","parseCompiledContracts","globalDoomConfigDirectory","resolveDoomConfigurationRoot","serverFacetCandidates","rootCompositions","loadMajorModesConfig","resolveLayers","createApiDocuments","canonicalContractJson"],"sources":["../../../../src/builders/apiContractExport/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 { globalDoomConfigDirectory } from '@agimon-ai/po-config/config';\nimport { loadMajorModesConfig, resolveLayers } from '@agimon-ai/po-config/majorModes';\nimport {\n  canonicalContractJson,\n  createApiDocuments,\n  parseApiContract,\n  parseCompiledContracts,\n  type ApiContractSelection,\n  type ApiDocuments,\n  type DoomCompiledContracts,\n  type DoomPackageContract,\n} from '@agimon-ai/po-core/apiContracts';\n\nimport { resolveDoomConfigurationRoot } from '../../composition/repository';\nimport { rootCompositions } from '../cli/sessionComposition';\nimport { serverFacetCandidates, type ServerFacetCandidate } from '../server';\n\nconst execute = promisify(execFile);\n/** Imports one built contract module and prints its default export as strict JSON. */\nconst CONTRACT_PRINTER =\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\nfunction problemOf(error: unknown): string {\n  const stderr =\n    error !== null && typeof error === 'object' && 'stderr' in error && typeof error.stderr === 'string'\n      ? error.stderr.trim()\n      : '';\n  return (stderr || (error instanceof Error ? error.message : String(error))).slice(0, 1000);\n}\n\n/**\n * Reads each server facet's built `poServer.contracts.dist` straight from its installed package.\n *\n * Contracts have their own entry so exporting never imports a server facet, and each one is\n * imported in a bounded child process so its module graph, timers and errors stay out of here.\n * A package without a readable contract is recorded as a gap rather than failing the export.\n */\nasync function collectApiContracts(candidates: readonly ServerFacetCandidate[]): Promise<DoomCompiledContracts> {\n  const packages: DoomPackageContract[] = [];\n  for (const { declaration, owners } of candidates) {\n    const root = declaration.packageDir;\n    const manifest = JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf8')) as {\n      version?: string;\n      poServer?: { contracts?: { entry?: string; dist?: string } };\n    };\n    const entry: DoomPackageContract = {\n      packageName: declaration.packageName,\n      packageVersion: manifest.version ?? 'unknown',\n      scopes: declaration.scopes,\n      owners: [...owners],\n    };\n    packages.push(entry);\n    try {\n      const contracts = manifest.poServer?.contracts;\n      if (!contracts) throw new Error('No poServer.contracts declaration');\n      for (const value of [contracts.entry, contracts.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      }\n      const built = fs.realpathSync(path.join(root, contracts.dist!));\n      const relative = path.relative(fs.realpathSync(root), built);\n      if (relative.startsWith('..') || path.isAbsolute(relative)) throw new Error('Contract entry escapes package');\n      const { stdout } = await execute(\n        process.execPath,\n        ['--input-type=module', '-e', CONTRACT_PRINTER, pathToFileURL(built).href],\n        { timeout: 10_000, maxBuffer: 16 * 1024 * 1024 },\n      );\n      entry.contract = parseApiContract(JSON.parse(stdout));\n    } catch (error) {\n      entry.problem = problemOf(error);\n    }\n  }\n  const fingerprint = crypto\n    .createHash('sha256')\n    .update(JSON.stringify(packages.map(({ packageName, packageVersion }) => [packageName, packageVersion])))\n    .digest('hex');\n  return parseCompiledContracts({ version: 1, generation: 'live', fingerprint, packages });\n}\n\n/** Reads the installed packages of the global root and the workspace. Export never builds or activates a facet. */\nexport async function exportApiContracts(options: {\n  cwd: string;\n  homeDirectory: string;\n  outputDirectory: string;\n  majorMode?: string;\n  environment?: NodeJS.ProcessEnv;\n}): Promise<ApiDocuments['manifest']> {\n  const environment = options.environment ?? process.env;\n  const globalRoot = globalDoomConfigDirectory(options.homeDirectory);\n  const workspaceRoot = resolveDoomConfigurationRoot(options.cwd, options.homeDirectory);\n  const read = async (root: string) => ({\n    compiled: await collectApiContracts(\n      serverFacetCandidates(rootCompositions({ root, homeDirectory: options.homeDirectory, environment })),\n    ),\n    config: loadMajorModesConfig(root, options.homeDirectory, environment),\n  });\n  const global = await read(globalRoot);\n  const workspace = globalRoot === workspaceRoot ? global : await 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":";;;;;;;;;;;;;;;;AAwBA,MAAM,WAAA,sBAAUA,CAAAA,CAAAA,UAAAA,CAAUC,mBAAAA,QAAQ;;AAElC,MAAM,mBACJ;AAEF,SAAS,UAAU,OAAwB;CAKzC,SAHE,UAAU,QAAQ,OAAO,UAAU,YAAY,YAAY,SAAS,OAAO,MAAM,WAAW,WACxF,MAAM,OAAO,KAAK,IAClB,QACa,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GAAA,CAAI,MAAM,GAAG,GAAI;AAC3F;;;;;;;;AASA,eAAe,oBAAoB,YAA6E;CAC9G,MAAM,WAAkC,CAAC;CACzC,KAAK,MAAM,EAAE,aAAa,YAAY,YAAY;EAChD,MAAM,OAAO,YAAY;EACzB,MAAM,WAAW,KAAK,MAAMC,QAAAA,QAAG,aAAaC,UAAAA,QAAK,KAAK,MAAM,cAAc,GAAG,MAAM,CAAC;EAIpF,MAAM,QAA6B;GACjC,aAAa,YAAY;GACzB,gBAAgB,SAAS,WAAW;GACpC,QAAQ,YAAY;GACpB,QAAQ,CAAC,GAAG,MAAM;EACpB;EACA,SAAS,KAAK,KAAK;EACnB,IAAI;GACF,MAAM,YAAY,SAAS,UAAU;GACrC,IAAI,CAAC,WAAW,MAAM,IAAI,MAAM,mCAAmC;GACnE,KAAK,MAAM,SAAS,CAAC,UAAU,OAAO,UAAU,IAAI,GAClD,IAAI,OAAO,UAAU,YAAY,CAAC,MAAM,WAAW,IAAI,KAAK,MAAM,SAAS,IAAI,KAAK,WAAW,KAAK,KAAK,GACvG,MAAM,IAAI,MAAM,kEAAkE;GAEtF,MAAM,QAAQD,QAAAA,QAAG,aAAaC,UAAAA,QAAK,KAAK,MAAM,UAAU,IAAK,CAAC;GAC9D,MAAM,WAAWA,UAAAA,QAAK,SAASD,QAAAA,QAAG,aAAa,IAAI,GAAG,KAAK;GAC3D,IAAI,SAAS,WAAW,IAAI,KAAKC,UAAAA,QAAK,WAAW,QAAQ,GAAG,MAAM,IAAI,MAAM,gCAAgC;GAC5G,MAAM,EAAE,WAAW,MAAM,QACvB,QAAQ,UACR;IAAC;IAAuB;IAAM;KAAkBC,GAAAA,SAAAA,cAAAA,CAAc,KAAK,CAAC,CAAC;GAAI,GACzE;IAAE,SAAS;IAAQ,WAAW;GAAiB,CACjD;GACA,MAAM,YAAA,GAAWC,gCAAAA,iBAAAA,CAAiB,KAAK,MAAM,MAAM,CAAC;EACtD,SAAS,OAAO;GACd,MAAM,UAAU,UAAU,KAAK;EACjC;CACF;CACA,MAAM,cAAcC,YAAAA,QACjB,WAAW,QAAQ,CAAC,CACpB,OAAO,KAAK,UAAU,SAAS,KAAK,EAAE,aAAa,qBAAqB,CAAC,aAAa,cAAc,CAAC,CAAC,CAAC,CAAC,CACxG,OAAO,KAAK;CACf,QAAA,GAAOC,gCAAAA,uBAAAA,CAAuB;EAAE,SAAS;EAAG,YAAY;EAAQ;EAAa;CAAS,CAAC;AACzF;;AAGA,eAAsB,mBAAmB,SAMH;CACpC,MAAM,cAAc,QAAQ,eAAe,QAAQ;CACnD,MAAM,cAAA,GAAaC,4BAAAA,0BAAAA,CAA0B,QAAQ,aAAa;CAClE,MAAM,gBAAgBC,cAAAA,6BAA6B,QAAQ,KAAK,QAAQ,aAAa;CACrF,MAAM,OAAO,OAAO,UAAkB;EACpC,UAAU,MAAM,oBACdC,gBAAAA,sBAAsBC,2BAAAA,iBAAiB;GAAE;GAAM,eAAe,QAAQ;GAAe;EAAY,CAAC,CAAC,CACrG;EACA,SAAA,GAAQC,gCAAAA,qBAAAA,CAAqB,MAAM,QAAQ,eAAe,WAAW;CACvE;CACA,MAAM,SAAS,MAAM,KAAK,UAAU;CACpC,MAAM,YAAY,eAAe,gBAAgB,SAAS,MAAM,KAAK,aAAa;CAClF,MAAM,cAAc,QAAQ,aAAa,UAAU,OAAO;CAC1D,MAAM,aACJ,QACA,OACA,eAC0B;EAC1B;EACA;EACA,eAAA,GAAcC,gCAAAA,cAAAA,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,aAAA,GAAYC,gCAAAA,mBAAAA,CAAmB;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,iBAAA,GAAgBC,gCAAAA,sBAAAA,CAAsB,UAAU,OAAO;EACvD,kBAAA,GAAiBA,gCAAAA,sBAAAA,CAAsB,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,QAAQT,YAAAA,QAAO,WAAW,QAAQ,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,OAAO,KAAK,EAChE,CACF,CAAC,CACH;CACF;CACA,QAAA,QAAG,UAAU,QAAQ,iBAAiB,EAAE,WAAW,KAAK,CAAC;CAEzD,KAAK,MAAM,CAAC,MAAM,UAAU,OAAO,QAAQ;EAAE,GAAG;EAAO,kBAAA,GAAiBS,gCAAAA,sBAAAA,CAAsB,QAAQ;CAAE,CAAC,GAAG;EAC1G,MAAM,SAASZ,UAAAA,QAAK,KAAK,QAAQ,iBAAiB,IAAI;EACtD,MAAM,YAAY,GAAG,OAAO,GAAGG,YAAAA,QAAO,WAAW,EAAE;EACnD,IAAI;GACF,QAAA,QAAG,cAAc,WAAW,OAAO,EAAE,MAAM,KAAK,CAAC;GACjD,QAAA,QAAG,WAAW,WAAW,MAAM;EACjC,UAAU;GACR,QAAA,QAAG,OAAO,WAAW,EAAE,OAAO,KAAK,CAAC;EACtC;CACF;CACA,OAAO,UAAU;AACnB"}

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

@@ -0,0 +1,123 @@
+import { resolveDoomConfigurationRoot } from "../../composition/repository/index.mjs";
+import { rootCompositions } from "../cli/sessionComposition.mjs";
+import { serverFacetCandidates } from "../server/index.mjs";
+import fs from "node:fs";
+import path from "node:path";
+import { execFile } from "node:child_process";
+import { canonicalContractJson, createApiDocuments, parseApiContract, parseCompiledContracts } from "@agimon-ai/po-core/apiContracts";
+import { globalDoomConfigDirectory } from "@agimon-ai/po-config/config";
+import { loadMajorModesConfig, resolveLayers } from "@agimon-ai/po-config/majorModes";
+import { pathToFileURL } from "node:url";
+import crypto from "node:crypto";
+import { promisify } from "node:util";
+//#region src/builders/apiContractExport/index.ts
+const execute = promisify(execFile);
+/** Imports one built contract module and prints its default export as strict JSON. */
+const CONTRACT_PRINTER = "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; }";
+function problemOf(error) {
+	return ((error !== null && typeof error === "object" && "stderr" in error && typeof error.stderr === "string" ? error.stderr.trim() : "") || (error instanceof Error ? error.message : String(error))).slice(0, 1e3);
+}
+/**
+* Reads each server facet's built `poServer.contracts.dist` straight from its installed package.
+*
+* Contracts have their own entry so exporting never imports a server facet, and each one is
+* imported in a bounded child process so its module graph, timers and errors stay out of here.
+* A package without a readable contract is recorded as a gap rather than failing the export.
+*/
+async function collectApiContracts(candidates) {
+	const packages = [];
+	for (const { declaration, owners } of candidates) {
+		const root = declaration.packageDir;
+		const manifest = JSON.parse(fs.readFileSync(path.join(root, "package.json"), "utf8"));
+		const entry = {
+			packageName: declaration.packageName,
+			packageVersion: manifest.version ?? "unknown",
+			scopes: declaration.scopes,
+			owners: [...owners]
+		};
+		packages.push(entry);
+		try {
+			const contracts = manifest.poServer?.contracts;
+			if (!contracts) throw new Error("No poServer.contracts declaration");
+			for (const value of [contracts.entry, contracts.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");
+			const built = fs.realpathSync(path.join(root, contracts.dist));
+			const relative = path.relative(fs.realpathSync(root), built);
+			if (relative.startsWith("..") || path.isAbsolute(relative)) throw new Error("Contract entry escapes package");
+			const { stdout } = await execute(process.execPath, [
+				"--input-type=module",
+				"-e",
+				CONTRACT_PRINTER,
+				pathToFileURL(built).href
+			], {
+				timeout: 1e4,
+				maxBuffer: 16777216
+			});
+			entry.contract = parseApiContract(JSON.parse(stdout));
+		} catch (error) {
+			entry.problem = problemOf(error);
+		}
+	}
+	const fingerprint = crypto.createHash("sha256").update(JSON.stringify(packages.map(({ packageName, packageVersion }) => [packageName, packageVersion]))).digest("hex");
+	return parseCompiledContracts({
+		version: 1,
+		generation: "live",
+		fingerprint,
+		packages
+	});
+}
+/** Reads the installed packages of the global root and the workspace. Export never builds or activates a facet. */
+async function exportApiContracts(options) {
+	const environment = options.environment ?? process.env;
+	const globalRoot = globalDoomConfigDirectory(options.homeDirectory);
+	const workspaceRoot = resolveDoomConfigurationRoot(options.cwd, options.homeDirectory);
+	const read = async (root) => ({
+		compiled: await collectApiContracts(serverFacetCandidates(rootCompositions({
+			root,
+			homeDirectory: options.homeDirectory,
+			environment
+		}))),
+		config: loadMajorModesConfig(root, options.homeDirectory, environment)
+	});
+	const global = await read(globalRoot);
+	const workspace = globalRoot === workspaceRoot ? global : await 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/src/builders/apiContractExport/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/builders/apiContractExport/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 { globalDoomConfigDirectory } from '@agimon-ai/po-config/config';\nimport { loadMajorModesConfig, resolveLayers } from '@agimon-ai/po-config/majorModes';\nimport {\n  canonicalContractJson,\n  createApiDocuments,\n  parseApiContract,\n  parseCompiledContracts,\n  type ApiContractSelection,\n  type ApiDocuments,\n  type DoomCompiledContracts,\n  type DoomPackageContract,\n} from '@agimon-ai/po-core/apiContracts';\n\nimport { resolveDoomConfigurationRoot } from '../../composition/repository';\nimport { rootCompositions } from '../cli/sessionComposition';\nimport { serverFacetCandidates, type ServerFacetCandidate } from '../server';\n\nconst execute = promisify(execFile);\n/** Imports one built contract module and prints its default export as strict JSON. */\nconst CONTRACT_PRINTER =\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\nfunction problemOf(error: unknown): string {\n  const stderr =\n    error !== null && typeof error === 'object' && 'stderr' in error && typeof error.stderr === 'string'\n      ? error.stderr.trim()\n      : '';\n  return (stderr || (error instanceof Error ? error.message : String(error))).slice(0, 1000);\n}\n\n/**\n * Reads each server facet's built `poServer.contracts.dist` straight from its installed package.\n *\n * Contracts have their own entry so exporting never imports a server facet, and each one is\n * imported in a bounded child process so its module graph, timers and errors stay out of here.\n * A package without a readable contract is recorded as a gap rather than failing the export.\n */\nasync function collectApiContracts(candidates: readonly ServerFacetCandidate[]): Promise<DoomCompiledContracts> {\n  const packages: DoomPackageContract[] = [];\n  for (const { declaration, owners } of candidates) {\n    const root = declaration.packageDir;\n    const manifest = JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf8')) as {\n      version?: string;\n      poServer?: { contracts?: { entry?: string; dist?: string } };\n    };\n    const entry: DoomPackageContract = {\n      packageName: declaration.packageName,\n      packageVersion: manifest.version ?? 'unknown',\n      scopes: declaration.scopes,\n      owners: [...owners],\n    };\n    packages.push(entry);\n    try {\n      const contracts = manifest.poServer?.contracts;\n      if (!contracts) throw new Error('No poServer.contracts declaration');\n      for (const value of [contracts.entry, contracts.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      }\n      const built = fs.realpathSync(path.join(root, contracts.dist!));\n      const relative = path.relative(fs.realpathSync(root), built);\n      if (relative.startsWith('..') || path.isAbsolute(relative)) throw new Error('Contract entry escapes package');\n      const { stdout } = await execute(\n        process.execPath,\n        ['--input-type=module', '-e', CONTRACT_PRINTER, pathToFileURL(built).href],\n        { timeout: 10_000, maxBuffer: 16 * 1024 * 1024 },\n      );\n      entry.contract = parseApiContract(JSON.parse(stdout));\n    } catch (error) {\n      entry.problem = problemOf(error);\n    }\n  }\n  const fingerprint = crypto\n    .createHash('sha256')\n    .update(JSON.stringify(packages.map(({ packageName, packageVersion }) => [packageName, packageVersion])))\n    .digest('hex');\n  return parseCompiledContracts({ version: 1, generation: 'live', fingerprint, packages });\n}\n\n/** Reads the installed packages of the global root and the workspace. Export never builds or activates a facet. */\nexport async function exportApiContracts(options: {\n  cwd: string;\n  homeDirectory: string;\n  outputDirectory: string;\n  majorMode?: string;\n  environment?: NodeJS.ProcessEnv;\n}): Promise<ApiDocuments['manifest']> {\n  const environment = options.environment ?? process.env;\n  const globalRoot = globalDoomConfigDirectory(options.homeDirectory);\n  const workspaceRoot = resolveDoomConfigurationRoot(options.cwd, options.homeDirectory);\n  const read = async (root: string) => ({\n    compiled: await collectApiContracts(\n      serverFacetCandidates(rootCompositions({ root, homeDirectory: options.homeDirectory, environment })),\n    ),\n    config: loadMajorModesConfig(root, options.homeDirectory, environment),\n  });\n  const global = await read(globalRoot);\n  const workspace = globalRoot === workspaceRoot ? global : await 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":"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"}

package/dist/src/builders/cli/entryResolution.cjs

@@ -0,0 +1,39 @@
+const require_runtime = require("../../../_virtual/_rolldown/runtime.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 node_url = require("node:url");
+let _agimon_ai_po_core_doomPackage = require("@agimon-ai/po-core/doomPackage");
+//#region src/builders/cli/entryResolution.ts
+/** Directory of this module; the desktop bundle rewrites it to its staged package root. */
+function moduleDirectory() {
+	return node_path.default.dirname((0, node_url.fileURLToPath)(require("url").pathToFileURL(__filename).href));
+}
+/** Installed package root for the source or compiled module executing sync. */
+function poPackageRoot() {
+	const start = moduleDirectory();
+	let directory = node_path.default.resolve(start);
+	while ((0, _agimon_ai_po_core_doomPackage.manifestName)(directory) !== _agimon_ai_po_core_doomPackage.DOOM_PACKAGE_NAME) {
+		const parent = node_path.default.dirname(directory);
+		if (parent === directory) throw new Error(`Could not locate installed ${_agimon_ai_po_core_doomPackage.DOOM_PACKAGE_NAME} package from ${start}`);
+		directory = parent;
+	}
+	return directory;
+}
+/** Distribution entries must resolve relative to po, never a dependency's installation. */
+function ownEntry(name) {
+	let directory = moduleDirectory();
+	while (!node_fs.default.existsSync(node_path.default.join(directory, "package.json"))) {
+		const parent = node_path.default.dirname(directory);
+		if (parent === directory) throw new Error("Cannot locate the Po distribution");
+		directory = parent;
+	}
+	const source = require("url").pathToFileURL(__filename).href.endsWith(".ts");
+	return node_path.default.join(directory, source ? "src" : "dist", "extensions", `${name}.${source ? "ts" : "mjs"}`);
+}
+//#endregion
+exports.ownEntry = ownEntry;
+exports.poPackageRoot = poPackageRoot;
+
+//# sourceMappingURL=entryResolution.cjs.map

package/dist/src/builders/cli/entryResolution.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"entryResolution.cjs","names":["path","fileURLToPath","manifestName","DOOM_PACKAGE_NAME","fs"],"sources":["../../../../src/builders/cli/entryResolution.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nimport { DOOM_PACKAGE_NAME, manifestName } from '@agimon-ai/po-core/doomPackage';\n\n/** Directory of this module; the desktop bundle rewrites it to its staged package root. */\nfunction moduleDirectory(): string {\n  return path.dirname(fileURLToPath(import.meta.url));\n}\n\n/** Installed package root for the source or compiled module executing sync. */\nexport function poPackageRoot(): string {\n  const start = moduleDirectory();\n  let directory = path.resolve(start);\n  while (manifestName(directory) !== DOOM_PACKAGE_NAME) {\n    const parent = path.dirname(directory);\n    if (parent === directory) {\n      throw new Error(`Could not locate installed ${DOOM_PACKAGE_NAME} package from ${start}`);\n    }\n    directory = parent;\n  }\n  return directory;\n}\n\n/** Distribution entries must resolve relative to po, never a dependency's installation. */\nexport function ownEntry(name: string): string {\n  let directory = moduleDirectory();\n  while (!fs.existsSync(path.join(directory, 'package.json'))) {\n    const parent = path.dirname(directory);\n    if (parent === directory) throw new Error('Cannot locate the Po distribution');\n    directory = parent;\n  }\n  const source = import.meta.url.endsWith('.ts');\n  return path.join(directory, source ? 'src' : 'dist', 'extensions', `${name}.${source ? 'ts' : 'mjs'}`);\n}\n"],"mappings":";;;;;;;;;AAOA,SAAS,kBAA0B;CACjC,OAAOA,UAAAA,QAAK,SAAA,GAAQC,SAAAA,cAAAA,CAAAA,QAAAA,KAAAA,CAAAA,CAAAA,cAAAA,UAAAA,CAAAA,CAAAA,IAA6B,CAAC;AACpD;;AAGA,SAAgB,gBAAwB;CACtC,MAAM,QAAQ,gBAAgB;CAC9B,IAAI,YAAYD,UAAAA,QAAK,QAAQ,KAAK;CAClC,QAAA,GAAOE,+BAAAA,aAAAA,CAAa,SAAS,MAAMC,+BAAAA,mBAAmB;EACpD,MAAM,SAASH,UAAAA,QAAK,QAAQ,SAAS;EACrC,IAAI,WAAW,WACb,MAAM,IAAI,MAAM,8BAA8BG,+BAAAA,kBAAkB,gBAAgB,OAAO;EAEzF,YAAY;CACd;CACA,OAAO;AACT;;AAGA,SAAgB,SAAS,MAAsB;CAC7C,IAAI,YAAY,gBAAgB;CAChC,OAAO,CAACC,QAAAA,QAAG,WAAWJ,UAAAA,QAAK,KAAK,WAAW,cAAc,CAAC,GAAG;EAC3D,MAAM,SAASA,UAAAA,QAAK,QAAQ,SAAS;EACrC,IAAI,WAAW,WAAW,MAAM,IAAI,MAAM,mCAAmC;EAC7E,YAAY;CACd;CACA,MAAM,SAAA,QAAA,KAAA,CAAA,CAAA,cAAA,UAAA,CAAA,CAAA,KAAyB,SAAS,KAAK;CAC7C,OAAOA,UAAAA,QAAK,KAAK,WAAW,SAAS,QAAQ,QAAQ,cAAc,GAAG,KAAK,GAAG,SAAS,OAAO,OAAO;AACvG"}

package/dist/src/builders/cli/entryResolution.mjs

@@ -0,0 +1,35 @@
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { DOOM_PACKAGE_NAME, manifestName } from "@agimon-ai/po-core/doomPackage";
+//#region src/builders/cli/entryResolution.ts
+/** Directory of this module; the desktop bundle rewrites it to its staged package root. */
+function moduleDirectory() {
+	return path.dirname(fileURLToPath(import.meta.url));
+}
+/** Installed package root for the source or compiled module executing sync. */
+function poPackageRoot() {
+	const start = moduleDirectory();
+	let directory = path.resolve(start);
+	while (manifestName(directory) !== DOOM_PACKAGE_NAME) {
+		const parent = path.dirname(directory);
+		if (parent === directory) throw new Error(`Could not locate installed ${DOOM_PACKAGE_NAME} package from ${start}`);
+		directory = parent;
+	}
+	return directory;
+}
+/** Distribution entries must resolve relative to po, never a dependency's installation. */
+function ownEntry(name) {
+	let directory = moduleDirectory();
+	while (!fs.existsSync(path.join(directory, "package.json"))) {
+		const parent = path.dirname(directory);
+		if (parent === directory) throw new Error("Cannot locate the Po distribution");
+		directory = parent;
+	}
+	const source = import.meta.url.endsWith(".ts");
+	return path.join(directory, source ? "src" : "dist", "extensions", `${name}.${source ? "ts" : "mjs"}`);
+}
+//#endregion
+export { ownEntry, poPackageRoot };
+
+//# sourceMappingURL=entryResolution.mjs.map

package/dist/src/builders/cli/entryResolution.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"entryResolution.mjs","names":[],"sources":["../../../../src/builders/cli/entryResolution.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nimport { DOOM_PACKAGE_NAME, manifestName } from '@agimon-ai/po-core/doomPackage';\n\n/** Directory of this module; the desktop bundle rewrites it to its staged package root. */\nfunction moduleDirectory(): string {\n  return path.dirname(fileURLToPath(import.meta.url));\n}\n\n/** Installed package root for the source or compiled module executing sync. */\nexport function poPackageRoot(): string {\n  const start = moduleDirectory();\n  let directory = path.resolve(start);\n  while (manifestName(directory) !== DOOM_PACKAGE_NAME) {\n    const parent = path.dirname(directory);\n    if (parent === directory) {\n      throw new Error(`Could not locate installed ${DOOM_PACKAGE_NAME} package from ${start}`);\n    }\n    directory = parent;\n  }\n  return directory;\n}\n\n/** Distribution entries must resolve relative to po, never a dependency's installation. */\nexport function ownEntry(name: string): string {\n  let directory = moduleDirectory();\n  while (!fs.existsSync(path.join(directory, 'package.json'))) {\n    const parent = path.dirname(directory);\n    if (parent === directory) throw new Error('Cannot locate the Po distribution');\n    directory = parent;\n  }\n  const source = import.meta.url.endsWith('.ts');\n  return path.join(directory, source ? 'src' : 'dist', 'extensions', `${name}.${source ? 'ts' : 'mjs'}`);\n}\n"],"mappings":";;;;;;AAOA,SAAS,kBAA0B;CACjC,OAAO,KAAK,QAAQ,cAAc,YAAY,GAAG,CAAC;AACpD;;AAGA,SAAgB,gBAAwB;CACtC,MAAM,QAAQ,gBAAgB;CAC9B,IAAI,YAAY,KAAK,QAAQ,KAAK;CAClC,OAAO,aAAa,SAAS,MAAM,mBAAmB;EACpD,MAAM,SAAS,KAAK,QAAQ,SAAS;EACrC,IAAI,WAAW,WACb,MAAM,IAAI,MAAM,8BAA8B,kBAAkB,gBAAgB,OAAO;EAEzF,YAAY;CACd;CACA,OAAO;AACT;;AAGA,SAAgB,SAAS,MAAsB;CAC7C,IAAI,YAAY,gBAAgB;CAChC,OAAO,CAAC,GAAG,WAAW,KAAK,KAAK,WAAW,cAAc,CAAC,GAAG;EAC3D,MAAM,SAAS,KAAK,QAAQ,SAAS;EACrC,IAAI,WAAW,WAAW,MAAM,IAAI,MAAM,mCAAmC;EAC7E,YAAY;CACd;CACA,MAAM,SAAS,YAAY,IAAI,SAAS,KAAK;CAC7C,OAAO,KAAK,KAAK,WAAW,SAAS,QAAQ,QAAQ,cAAc,GAAG,KAAK,GAAG,SAAS,OAAO,OAAO;AACvG"}