@agimon-ai/po 0.0.0-alpha.0

package/dist/src/builders/web/webPluginVite.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"webPluginVite.cjs","names":["fs","path","createRequire","PLUGIN_ROOTS_ENV","devPluginRoots","compositionPackageRoots","rootCompositions"],"sources":["../../../../src/builders/web/webPluginVite.ts"],"sourcesContent":["import fs from 'node:fs';\nimport { createRequire } from 'node:module';\nimport path from 'node:path';\n\nimport type { Alias, Plugin } from 'vite';\n\nimport { rootCompositions } from '../cli/sessionComposition';\nimport { compositionPackageRoots } from './index';\nimport { devPluginRoots, PLUGIN_ROOTS_ENV } from './webDevRoots';\nimport type { WebPluginRegistryModules } from './webPluginGenerate';\n\nconst PO_ROOT_ENV = 'PO_ROOT';\n\n/**\n * The modules the cockpit supplies page-wide, rather than each plugin\n * carrying its own copy.\n *\n * Build-time metadata, and it stays here rather than in a browser-facing\n * barrel on purpose: exporting it from po-core/web put the literal list\n * into the shipped cockpit bundle, where a plugin's own specifier strings\n * would then appear as data.\n */\nexport const WEB_PLUGIN_RUNTIME_SPECIFIERS = [\n  'react',\n  'react/jsx-runtime',\n  'react/jsx-dev-runtime',\n  'react-dom',\n  'react-dom/client',\n  '@tanstack/store',\n  '@tanstack/react-store',\n  '@tanstack/react-router',\n  '@agimon-ai/po-web-dashboard',\n  '@agimon-ai/po-web-dashboard/views',\n  '@agimon-ai/po-core/web',\n  '@agimon-ai/po-web-components',\n  '@agimon-ai/po-web-security/browser',\n  '@codemirror/state',\n  '@codemirror/view',\n] as const;\n\nconst WEB_PLUGIN_RUNTIME_PROPERTIES: Record<(typeof WEB_PLUGIN_RUNTIME_SPECIFIERS)[number], string> = {\n  react: 'react',\n  'react/jsx-runtime': 'reactJsxRuntime',\n  'react/jsx-dev-runtime': 'reactJsxDevRuntime',\n  'react-dom': 'reactDom',\n  'react-dom/client': 'reactDomClient',\n  '@tanstack/store': 'tanstackStore',\n  '@tanstack/react-store': 'tanstackReactStore',\n  '@tanstack/react-router': 'tanstackRouter',\n  '@agimon-ai/po-web-dashboard': 'dashboard',\n  '@agimon-ai/po-web-dashboard/views': 'dashboardViews',\n  '@agimon-ai/po-core/web': 'webContracts',\n  '@agimon-ai/po-web-components': 'webComponents',\n  '@agimon-ai/po-web-security/browser': 'webSecurityBrowser',\n  '@codemirror/state': 'codemirrorState',\n  '@codemirror/view': 'codemirrorView',\n};\n\ntype WebPluginRuntimeSpecifier = (typeof WEB_PLUGIN_RUNTIME_SPECIFIERS)[number];\n\n/** Expression for a shared module supplied by the session shell. */\nexport function webPluginRuntimeGlobal(specifier: WebPluginRuntimeSpecifier): string {\n  return `globalThis.PoWebPluginRuntime.${WEB_PLUGIN_RUNTIME_PROPERTIES[specifier]}`;\n}\n\n/** The React family ships CommonJS, so its names come from loading it rather than parsing it. */\nconst COMMONJS_RUNTIME_SPECIFIERS: ReadonlySet<string> = new Set([\n  'react',\n  'react/jsx-runtime',\n  'react/jsx-dev-runtime',\n  'react-dom',\n  'react-dom/client',\n]);\n\nconst FACADE_PREFIX = '\\0po-web-runtime:';\n/** The chunk every facade lands in, so each shared module is read from the runtime once. */\nexport const WEB_PLUGIN_FACADE_CHUNK = 'po-web-runtime';\n\n/** True for a module id that is one of the shared-module facades. */\nexport function isWebPluginFacade(id: string): boolean {\n  return id.startsWith(FACADE_PREFIX);\n}\n\n/** The ES module name of a default export. */\nconst DEFAULT_EXPORT = 'default';\n\ntype AstNode = { type: string; [key: string]: unknown };\n\nfunction patternNames(pattern: AstNode): string[] {\n  switch (pattern.type) {\n    case 'Identifier':\n      return [pattern.name as string];\n    case 'ObjectPattern':\n      return (pattern.properties as AstNode[]).flatMap((property) =>\n        patternNames((property.type === 'RestElement' ? property.argument : property.value) as AstNode),\n      );\n    case 'ArrayPattern':\n      return (pattern.elements as (AstNode | null)[]).flatMap((element) => (element ? patternNames(element) : []));\n    case 'RestElement':\n      return patternNames(pattern.argument as AstNode);\n    case 'AssignmentPattern':\n      return patternNames(pattern.left as AstNode);\n    default:\n      return [];\n  }\n}\n\nfunction exportedName(node: AstNode): string {\n  return node.type === 'Identifier' ? (node.name as string) : String(node.value);\n}\n\n/** Static reading of an ES module's export names, as the facade plugin needs it. */\nexport interface ExportNameReader {\n  parse: (code: string) => { body: unknown[] };\n  /** Resolves a bare specifier from the file that imports it, to a file path. */\n  resolve: (source: string, importer: string) => Promise<string | undefined>;\n}\n\n/**\n * The export names of an ES module file. `export *` is followed through relative paths,\n * and through a bare specifier only when that specifier is itself a shared module\n * (resolved from the re-exporting file, since that is the copy the runtime object holds).\n * Any other bare `export *` and any unparseable file fail the build.\n */\nexport async function esModuleExportNames(\n  specifier: string,\n  file: string,\n  reader: ExportNameReader,\n  seen: Set<string> = new Set(),\n): Promise<Set<string>> {\n  const names = new Set<string>();\n  if (seen.has(file)) return names;\n  seen.add(file);\n  let body: AstNode[];\n  try {\n    body = reader.parse(fs.readFileSync(file, 'utf8')).body as AstNode[];\n  } catch (error) {\n    throw new Error(\n      `The shared module '${specifier}' cannot be parsed at ${file}: ${error instanceof Error ? error.message : String(error)}`,\n    );\n  }\n  const shared: ReadonlySet<string> = new Set(WEB_PLUGIN_RUNTIME_SPECIFIERS);\n  for (const node of body) {\n    if (node.type === 'ExportDefaultDeclaration') names.add(DEFAULT_EXPORT);\n    if (node.type === 'ExportNamedDeclaration') {\n      const declaration = node.declaration as AstNode | null;\n      if (declaration?.type === 'VariableDeclaration') {\n        for (const declarator of declaration.declarations as AstNode[])\n          for (const name of patternNames(declarator.id as AstNode)) names.add(name);\n      } else if (declaration) {\n        names.add((declaration.id as AstNode).name as string);\n      }\n      for (const entry of (node.specifiers as AstNode[] | undefined) ?? [])\n        names.add(exportedName(entry.exported as AstNode));\n    }\n    if (node.type === 'ExportAllDeclaration') {\n      if (node.exported) {\n        names.add(exportedName(node.exported as AstNode));\n        continue;\n      }\n      const source = String((node.source as AstNode).value);\n      let target: string | undefined;\n      if (source.startsWith('./') || source.startsWith('../')) target = path.resolve(path.dirname(file), source);\n      else if (shared.has(source)) {\n        target = await reader.resolve(source, file);\n        if (target === undefined)\n          throw new Error(\n            `The shared module '${specifier}' re-exports '${source}', which does not resolve from ${file}.`,\n          );\n      } else\n        throw new Error(\n          `The shared module '${specifier}' re-exports everything from the bare specifier '${source}' (${file}), which is not a shared module; its names cannot be listed.`,\n        );\n      for (const name of await esModuleExportNames(specifier, target, reader, seen))\n        if (name !== DEFAULT_EXPORT) names.add(name);\n    }\n  }\n  return names;\n}\n\nconst IDENTIFIER = /^[A-Za-z_$][\\w$]*$/u;\n\n/** A module that reads one shared module from the page runtime and re-exports the given names. */\nexport function renderWebPluginFacade(specifier: WebPluginRuntimeSpecifier, names: Iterable<string>): string {\n  const all = new Set(names);\n  const lines = [`const runtime = ${webPluginRuntimeGlobal(specifier)};`];\n  const exported: string[] = [];\n  let index = 0;\n  for (const name of [...all].sort()) {\n    if (name === DEFAULT_EXPORT) continue;\n    const local = `_${String(index++)}`;\n    lines.push(`const ${local} = runtime[${JSON.stringify(name)}];`);\n    exported.push(`${local} as ${IDENTIFIER.test(name) ? name : JSON.stringify(name)}`);\n  }\n  if (exported.length > 0) lines.push(`export { ${exported.join(', ')} };`);\n  // CommonJS has no default export of its own; interop treats the whole object as one.\n  if (all.has(DEFAULT_EXPORT)) lines.push('export default runtime[\"default\"];');\n  else if (COMMONJS_RUNTIME_SPECIFIERS.has(specifier)) lines.push('export default runtime;');\n  lines.push('');\n  return lines.join('\\n');\n}\n\n/**\n * Resolves every shared runtime specifier to a virtual facade that re-exports, by name,\n * from `globalThis.PoWebPluginRuntime`, so ES-module slot entries can import them without\n * the page providing an import map. Names come from the host's own copy of each module.\n */\nexport function webPluginRuntimeFacadePlugin(hostRoot: string): Plugin {\n  const shared: ReadonlySet<string> = new Set(WEB_PLUGIN_RUNTIME_SPECIFIERS);\n  const hostImporter = path.join(hostRoot, 'package.json');\n  const hostRequire = createRequire(hostImporter);\n  return {\n    name: 'po-web-runtime-facades',\n    enforce: 'pre',\n    resolveId(source) {\n      return shared.has(source) ? `${FACADE_PREFIX}${source}` : null;\n    },\n    async load(id) {\n      if (!isWebPluginFacade(id)) return null;\n      const specifier = id.slice(FACADE_PREFIX.length) as WebPluginRuntimeSpecifier;\n      if (COMMONJS_RUNTIME_SPECIFIERS.has(specifier))\n        return renderWebPluginFacade(specifier, Object.keys(hostRequire(specifier) as object));\n      const resolveFile = async (source: string, importer: string): Promise<string | undefined> => {\n        const resolved = await this.resolve(source, importer, { skipSelf: true });\n        return resolved ? (resolved.id.split('?')[0] ?? resolved.id) : undefined;\n      };\n      const file = await resolveFile(specifier, hostImporter);\n      if (file === undefined) throw new Error(`The shared module '${specifier}' does not resolve from ${hostRoot}.`);\n      const { parseAst } = await import('vite');\n      return renderWebPluginFacade(\n        specifier,\n        await esModuleExportNames(specifier, file, { parse: (code) => parseAst(code), resolve: resolveFile }),\n      );\n    },\n  };\n}\n\n/** Resolves generated JSX imports from the host instead of a plugin's optional React peer tree. */\nexport function webPluginRuntimeAliases(clientRoot: string): Alias[] {\n  const runtimeRequire = createRequire(path.join(clientRoot, 'index.html'));\n  return WEB_PLUGIN_RUNTIME_SPECIFIERS.filter((specifier) => specifier.startsWith('react/jsx-')).map((specifier) => ({\n    find: new RegExp(`^${specifier.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')}$`, 'u'),\n    replacement: runtimeRequire.resolve(specifier),\n  }));\n}\n\n/**\n * Swaps the committed builtin registry modules for generated ones. A\n * resolveId hook rather than resolve.alias because aliases match raw import\n * specifiers while these two are known by their resolved paths. Both the\n * sync-time build and the dev server use it, so a plugin edit in dev is the\n * same module the bundle would carry.\n */\nexport function webPluginOverridePlugin(clientRoot: string, generated: WebPluginRegistryModules): Plugin {\n  const overrides = new Map([\n    [path.join(clientRoot, 'app', 'webPlugins.generated.ts'), generated.clientModulePath],\n    [path.join(clientRoot, 'styles', 'webPluginSources.generated.css'), generated.cssModulePath],\n  ]);\n  return {\n    name: 'po-web-plugin-overrides',\n    enforce: 'pre',\n    async resolveId(source, importer, options) {\n      if (!source.includes('webPlugins.generated') && !source.includes('webPluginSources.generated.css')) return null;\n      const resolved = await this.resolve(source, importer, { ...options, skipSelf: true });\n      if (!resolved) return null;\n      return overrides.get(resolved.id) ?? null;\n    },\n  };\n}\n\n/**\n * The CSS sources module cannot ride the resolveId hook: Vite and Tailwind\n * resolve CSS @import through Vite's own id resolver, which consults aliases\n * but no plugin hooks. Without this the builtin (empty) @source list ships\n * and every plugin-only utility class is missing.\n */\nexport function webPluginCssAlias(generated: WebPluginRegistryModules): Alias {\n  return { find: /^\\.\\/webPluginSources\\.generated\\.css$/, replacement: generated.cssModulePath };\n}\n\n/** The plugin package roots the dev server should serve, from an explicit override or PO_ROOT. */\nexport function readDevPluginRoots(environment: NodeJS.ProcessEnv, homeDirectory: string): string[] {\n  const explicit = environment[PLUGIN_ROOTS_ENV];\n  if (explicit !== undefined && explicit !== '') {\n    return devPluginRoots({ envValue: explicit, rootsFileText: undefined, delimiter: path.delimiter });\n  }\n  const repoRoot = environment[PO_ROOT_ENV];\n  if (repoRoot === undefined || repoRoot === '') return [];\n  // Resolved live from the root's configuration and installed packages, as the server does.\n  return compositionPackageRoots(rootCompositions({ root: repoRoot, homeDirectory, environment }));\n}\n"],"mappings":"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"}

package/dist/src/builders/web/webPluginVite.d.mts

@@ -0,0 +1,64 @@
+import { WebPluginRegistryModules } from "./webPluginGenerate.mjs";
+import { Alias, Plugin } from "vite";
+//#region src/builders/web/webPluginVite.d.ts
+/**
+ * The modules the cockpit supplies page-wide, rather than each plugin
+ * carrying its own copy.
+ *
+ * Build-time metadata, and it stays here rather than in a browser-facing
+ * barrel on purpose: exporting it from po-core/web put the literal list
+ * into the shipped cockpit bundle, where a plugin's own specifier strings
+ * would then appear as data.
+ */
+export declare const WEB_PLUGIN_RUNTIME_SPECIFIERS: readonly ['react', 'react/jsx-runtime', 'react/jsx-dev-runtime', 'react-dom', 'react-dom/client', '@tanstack/store', '@tanstack/react-store', '@tanstack/react-router', '@agimon-ai/po-web-dashboard', '@agimon-ai/po-web-dashboard/views', '@agimon-ai/po-core/web', '@agimon-ai/po-web-components', '@agimon-ai/po-web-security/browser', '@codemirror/state', '@codemirror/view'];
+type WebPluginRuntimeSpecifier = (typeof WEB_PLUGIN_RUNTIME_SPECIFIERS)[number];
+/** Expression for a shared module supplied by the session shell. */
+export declare function webPluginRuntimeGlobal(specifier: WebPluginRuntimeSpecifier): string;
+/** The chunk every facade lands in, so each shared module is read from the runtime once. */
+export declare const WEB_PLUGIN_FACADE_CHUNK = "po-web-runtime";
+/** True for a module id that is one of the shared-module facades. */
+export declare function isWebPluginFacade(id: string): boolean;
+/** Static reading of an ES module's export names, as the facade plugin needs it. */
+export interface ExportNameReader {
+  parse: (code: string) => {
+    body: unknown[];
+  };
+  /** Resolves a bare specifier from the file that imports it, to a file path. */
+  resolve: (source: string, importer: string) => Promise<string | undefined>;
+}
+/**
+ * The export names of an ES module file. `export *` is followed through relative paths,
+ * and through a bare specifier only when that specifier is itself a shared module
+ * (resolved from the re-exporting file, since that is the copy the runtime object holds).
+ * Any other bare `export *` and any unparseable file fail the build.
+ */
+export declare function esModuleExportNames(specifier: string, file: string, reader: ExportNameReader, seen?: Set<string>): Promise<Set<string>>;
+/** A module that reads one shared module from the page runtime and re-exports the given names. */
+export declare function renderWebPluginFacade(specifier: WebPluginRuntimeSpecifier, names: Iterable<string>): string;
+/**
+ * Resolves every shared runtime specifier to a virtual facade that re-exports, by name,
+ * from `globalThis.PoWebPluginRuntime`, so ES-module slot entries can import them without
+ * the page providing an import map. Names come from the host's own copy of each module.
+ */
+export declare function webPluginRuntimeFacadePlugin(hostRoot: string): Plugin;
+/** Resolves generated JSX imports from the host instead of a plugin's optional React peer tree. */
+export declare function webPluginRuntimeAliases(clientRoot: string): Alias[];
+/**
+ * Swaps the committed builtin registry modules for generated ones. A
+ * resolveId hook rather than resolve.alias because aliases match raw import
+ * specifiers while these two are known by their resolved paths. Both the
+ * sync-time build and the dev server use it, so a plugin edit in dev is the
+ * same module the bundle would carry.
+ */
+export declare function webPluginOverridePlugin(clientRoot: string, generated: WebPluginRegistryModules): Plugin;
+/**
+ * The CSS sources module cannot ride the resolveId hook: Vite and Tailwind
+ * resolve CSS @import through Vite's own id resolver, which consults aliases
+ * but no plugin hooks. Without this the builtin (empty) @source list ships
+ * and every plugin-only utility class is missing.
+ */
+export declare function webPluginCssAlias(generated: WebPluginRegistryModules): Alias;
+/** The plugin package roots the dev server should serve, from an explicit override or PO_ROOT. */
+export declare function readDevPluginRoots(environment: NodeJS.ProcessEnv, homeDirectory: string): string[];
+//#endregion
+//# sourceMappingURL=webPluginVite.d.mts.map

package/dist/src/builders/web/webPluginVite.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webPluginVite.d.mts","names":[],"sources":["../../../../src/builders/web/webPluginVite.ts"],"mappings":";;;;;;;;;;;;qBAsBa;KAoCR,oCAAoC;;wBAGzB,uBAAuB,WAAW;;qBAerC;;wBAGG,kBAAkB;;iBAiCjB;EACf,QAAQ;IAAmB;;;EAE3B,UAAU,gBAAgB,qBAAqB;;;;;;;;wBAS3B,oBACpB,mBACA,cACA,QAAQ,kBACR,OAAM,cACL,QAAQ;;wBAsDK,sBAAsB,WAAW,2BAA2B,OAAO;;;;;;wBAwBnE,6BAA6B,mBAAmB;;wBA+BhD,wBAAwB,qBAAqB;;;;;;;;wBAe7C,wBAAwB,oBAAoB,WAAW,2BAA2B;;;;;;;wBAuBlF,kBAAkB,WAAW,2BAA2B;;wBAKxD,mBAAmB,aAAa,OAAO,YAAY"}

package/dist/src/builders/web/webPluginVite.mjs

@@ -0,0 +1,242 @@
+import { compositionPackageRoots } from "./index.mjs";
+import { rootCompositions } from "../cli/sessionComposition.mjs";
+import { PLUGIN_ROOTS_ENV, devPluginRoots } from "./webDevRoots.mjs";
+import { createRequire } from "node:module";
+import fs from "node:fs";
+import path from "node:path";
+//#region src/builders/web/webPluginVite.ts
+const PO_ROOT_ENV = "PO_ROOT";
+/**
+* The modules the cockpit supplies page-wide, rather than each plugin
+* carrying its own copy.
+*
+* Build-time metadata, and it stays here rather than in a browser-facing
+* barrel on purpose: exporting it from po-core/web put the literal list
+* into the shipped cockpit bundle, where a plugin's own specifier strings
+* would then appear as data.
+*/
+const WEB_PLUGIN_RUNTIME_SPECIFIERS = [
+	"react",
+	"react/jsx-runtime",
+	"react/jsx-dev-runtime",
+	"react-dom",
+	"react-dom/client",
+	"@tanstack/store",
+	"@tanstack/react-store",
+	"@tanstack/react-router",
+	"@agimon-ai/po-web-dashboard",
+	"@agimon-ai/po-web-dashboard/views",
+	"@agimon-ai/po-core/web",
+	"@agimon-ai/po-web-components",
+	"@agimon-ai/po-web-security/browser",
+	"@codemirror/state",
+	"@codemirror/view"
+];
+const WEB_PLUGIN_RUNTIME_PROPERTIES = {
+	react: "react",
+	"react/jsx-runtime": "reactJsxRuntime",
+	"react/jsx-dev-runtime": "reactJsxDevRuntime",
+	"react-dom": "reactDom",
+	"react-dom/client": "reactDomClient",
+	"@tanstack/store": "tanstackStore",
+	"@tanstack/react-store": "tanstackReactStore",
+	"@tanstack/react-router": "tanstackRouter",
+	"@agimon-ai/po-web-dashboard": "dashboard",
+	"@agimon-ai/po-web-dashboard/views": "dashboardViews",
+	"@agimon-ai/po-core/web": "webContracts",
+	"@agimon-ai/po-web-components": "webComponents",
+	"@agimon-ai/po-web-security/browser": "webSecurityBrowser",
+	"@codemirror/state": "codemirrorState",
+	"@codemirror/view": "codemirrorView"
+};
+/** Expression for a shared module supplied by the session shell. */
+function webPluginRuntimeGlobal(specifier) {
+	return `globalThis.PoWebPluginRuntime.${WEB_PLUGIN_RUNTIME_PROPERTIES[specifier]}`;
+}
+/** The React family ships CommonJS, so its names come from loading it rather than parsing it. */
+const COMMONJS_RUNTIME_SPECIFIERS = /* @__PURE__ */ new Set([
+	"react",
+	"react/jsx-runtime",
+	"react/jsx-dev-runtime",
+	"react-dom",
+	"react-dom/client"
+]);
+const FACADE_PREFIX = "\0po-web-runtime:";
+/** The chunk every facade lands in, so each shared module is read from the runtime once. */
+const WEB_PLUGIN_FACADE_CHUNK = "po-web-runtime";
+/** True for a module id that is one of the shared-module facades. */
+function isWebPluginFacade(id) {
+	return id.startsWith(FACADE_PREFIX);
+}
+/** The ES module name of a default export. */
+const DEFAULT_EXPORT = "default";
+function patternNames(pattern) {
+	switch (pattern.type) {
+		case "Identifier": return [pattern.name];
+		case "ObjectPattern": return pattern.properties.flatMap((property) => patternNames(property.type === "RestElement" ? property.argument : property.value));
+		case "ArrayPattern": return pattern.elements.flatMap((element) => element ? patternNames(element) : []);
+		case "RestElement": return patternNames(pattern.argument);
+		case "AssignmentPattern": return patternNames(pattern.left);
+		default: return [];
+	}
+}
+function exportedName(node) {
+	return node.type === "Identifier" ? node.name : String(node.value);
+}
+/**
+* The export names of an ES module file. `export *` is followed through relative paths,
+* and through a bare specifier only when that specifier is itself a shared module
+* (resolved from the re-exporting file, since that is the copy the runtime object holds).
+* Any other bare `export *` and any unparseable file fail the build.
+*/
+async function esModuleExportNames(specifier, file, reader, seen = /* @__PURE__ */ new Set()) {
+	const names = /* @__PURE__ */ new Set();
+	if (seen.has(file)) return names;
+	seen.add(file);
+	let body;
+	try {
+		body = reader.parse(fs.readFileSync(file, "utf8")).body;
+	} catch (error) {
+		throw new Error(`The shared module '${specifier}' cannot be parsed at ${file}: ${error instanceof Error ? error.message : String(error)}`);
+	}
+	const shared = new Set(WEB_PLUGIN_RUNTIME_SPECIFIERS);
+	for (const node of body) {
+		if (node.type === "ExportDefaultDeclaration") names.add(DEFAULT_EXPORT);
+		if (node.type === "ExportNamedDeclaration") {
+			const declaration = node.declaration;
+			if (declaration?.type === "VariableDeclaration") for (const declarator of declaration.declarations) for (const name of patternNames(declarator.id)) names.add(name);
+			else if (declaration) names.add(declaration.id.name);
+			for (const entry of node.specifiers ?? []) names.add(exportedName(entry.exported));
+		}
+		if (node.type === "ExportAllDeclaration") {
+			if (node.exported) {
+				names.add(exportedName(node.exported));
+				continue;
+			}
+			const source = String(node.source.value);
+			let target;
+			if (source.startsWith("./") || source.startsWith("../")) target = path.resolve(path.dirname(file), source);
+			else if (shared.has(source)) {
+				target = await reader.resolve(source, file);
+				if (target === void 0) throw new Error(`The shared module '${specifier}' re-exports '${source}', which does not resolve from ${file}.`);
+			} else throw new Error(`The shared module '${specifier}' re-exports everything from the bare specifier '${source}' (${file}), which is not a shared module; its names cannot be listed.`);
+			for (const name of await esModuleExportNames(specifier, target, reader, seen)) if (name !== DEFAULT_EXPORT) names.add(name);
+		}
+	}
+	return names;
+}
+const IDENTIFIER = /^[A-Za-z_$][\w$]*$/u;
+/** A module that reads one shared module from the page runtime and re-exports the given names. */
+function renderWebPluginFacade(specifier, names) {
+	const all = new Set(names);
+	const lines = [`const runtime = ${webPluginRuntimeGlobal(specifier)};`];
+	const exported = [];
+	let index = 0;
+	for (const name of [...all].sort()) {
+		if (name === DEFAULT_EXPORT) continue;
+		const local = `_${String(index++)}`;
+		lines.push(`const ${local} = runtime[${JSON.stringify(name)}];`);
+		exported.push(`${local} as ${IDENTIFIER.test(name) ? name : JSON.stringify(name)}`);
+	}
+	if (exported.length > 0) lines.push(`export { ${exported.join(", ")} };`);
+	if (all.has(DEFAULT_EXPORT)) lines.push("export default runtime[\"default\"];");
+	else if (COMMONJS_RUNTIME_SPECIFIERS.has(specifier)) lines.push("export default runtime;");
+	lines.push("");
+	return lines.join("\n");
+}
+/**
+* Resolves every shared runtime specifier to a virtual facade that re-exports, by name,
+* from `globalThis.PoWebPluginRuntime`, so ES-module slot entries can import them without
+* the page providing an import map. Names come from the host's own copy of each module.
+*/
+function webPluginRuntimeFacadePlugin(hostRoot) {
+	const shared = new Set(WEB_PLUGIN_RUNTIME_SPECIFIERS);
+	const hostImporter = path.join(hostRoot, "package.json");
+	const hostRequire = createRequire(hostImporter);
+	return {
+		name: "po-web-runtime-facades",
+		enforce: "pre",
+		resolveId(source) {
+			return shared.has(source) ? `${FACADE_PREFIX}${source}` : null;
+		},
+		async load(id) {
+			if (!isWebPluginFacade(id)) return null;
+			const specifier = id.slice(16);
+			if (COMMONJS_RUNTIME_SPECIFIERS.has(specifier)) return renderWebPluginFacade(specifier, Object.keys(hostRequire(specifier)));
+			const resolveFile = async (source, importer) => {
+				const resolved = await this.resolve(source, importer, { skipSelf: true });
+				return resolved ? resolved.id.split("?")[0] ?? resolved.id : void 0;
+			};
+			const file = await resolveFile(specifier, hostImporter);
+			if (file === void 0) throw new Error(`The shared module '${specifier}' does not resolve from ${hostRoot}.`);
+			const { parseAst } = await import("vite");
+			return renderWebPluginFacade(specifier, await esModuleExportNames(specifier, file, {
+				parse: (code) => parseAst(code),
+				resolve: resolveFile
+			}));
+		}
+	};
+}
+/** Resolves generated JSX imports from the host instead of a plugin's optional React peer tree. */
+function webPluginRuntimeAliases(clientRoot) {
+	const runtimeRequire = createRequire(path.join(clientRoot, "index.html"));
+	return WEB_PLUGIN_RUNTIME_SPECIFIERS.filter((specifier) => specifier.startsWith("react/jsx-")).map((specifier) => ({
+		find: new RegExp(`^${specifier.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}$`, "u"),
+		replacement: runtimeRequire.resolve(specifier)
+	}));
+}
+/**
+* Swaps the committed builtin registry modules for generated ones. A
+* resolveId hook rather than resolve.alias because aliases match raw import
+* specifiers while these two are known by their resolved paths. Both the
+* sync-time build and the dev server use it, so a plugin edit in dev is the
+* same module the bundle would carry.
+*/
+function webPluginOverridePlugin(clientRoot, generated) {
+	const overrides = /* @__PURE__ */ new Map([[path.join(clientRoot, "app", "webPlugins.generated.ts"), generated.clientModulePath], [path.join(clientRoot, "styles", "webPluginSources.generated.css"), generated.cssModulePath]]);
+	return {
+		name: "po-web-plugin-overrides",
+		enforce: "pre",
+		async resolveId(source, importer, options) {
+			if (!source.includes("webPlugins.generated") && !source.includes("webPluginSources.generated.css")) return null;
+			const resolved = await this.resolve(source, importer, {
+				...options,
+				skipSelf: true
+			});
+			if (!resolved) return null;
+			return overrides.get(resolved.id) ?? null;
+		}
+	};
+}
+/**
+* The CSS sources module cannot ride the resolveId hook: Vite and Tailwind
+* resolve CSS @import through Vite's own id resolver, which consults aliases
+* but no plugin hooks. Without this the builtin (empty) @source list ships
+* and every plugin-only utility class is missing.
+*/
+function webPluginCssAlias(generated) {
+	return {
+		find: /^\.\/webPluginSources\.generated\.css$/,
+		replacement: generated.cssModulePath
+	};
+}
+/** The plugin package roots the dev server should serve, from an explicit override or PO_ROOT. */
+function readDevPluginRoots(environment, homeDirectory) {
+	const explicit = environment[PLUGIN_ROOTS_ENV];
+	if (explicit !== void 0 && explicit !== "") return devPluginRoots({
+		envValue: explicit,
+		rootsFileText: void 0,
+		delimiter: path.delimiter
+	});
+	const repoRoot = environment[PO_ROOT_ENV];
+	if (repoRoot === void 0 || repoRoot === "") return [];
+	return compositionPackageRoots(rootCompositions({
+		root: repoRoot,
+		homeDirectory,
+		environment
+	}));
+}
+//#endregion
+export { WEB_PLUGIN_FACADE_CHUNK, WEB_PLUGIN_RUNTIME_SPECIFIERS, esModuleExportNames, isWebPluginFacade, readDevPluginRoots, renderWebPluginFacade, webPluginCssAlias, webPluginOverridePlugin, webPluginRuntimeAliases, webPluginRuntimeFacadePlugin, webPluginRuntimeGlobal };
+
+//# sourceMappingURL=webPluginVite.mjs.map

package/dist/src/builders/web/webPluginVite.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"webPluginVite.mjs","names":[],"sources":["../../../../src/builders/web/webPluginVite.ts"],"sourcesContent":["import fs from 'node:fs';\nimport { createRequire } from 'node:module';\nimport path from 'node:path';\n\nimport type { Alias, Plugin } from 'vite';\n\nimport { rootCompositions } from '../cli/sessionComposition';\nimport { compositionPackageRoots } from './index';\nimport { devPluginRoots, PLUGIN_ROOTS_ENV } from './webDevRoots';\nimport type { WebPluginRegistryModules } from './webPluginGenerate';\n\nconst PO_ROOT_ENV = 'PO_ROOT';\n\n/**\n * The modules the cockpit supplies page-wide, rather than each plugin\n * carrying its own copy.\n *\n * Build-time metadata, and it stays here rather than in a browser-facing\n * barrel on purpose: exporting it from po-core/web put the literal list\n * into the shipped cockpit bundle, where a plugin's own specifier strings\n * would then appear as data.\n */\nexport const WEB_PLUGIN_RUNTIME_SPECIFIERS = [\n  'react',\n  'react/jsx-runtime',\n  'react/jsx-dev-runtime',\n  'react-dom',\n  'react-dom/client',\n  '@tanstack/store',\n  '@tanstack/react-store',\n  '@tanstack/react-router',\n  '@agimon-ai/po-web-dashboard',\n  '@agimon-ai/po-web-dashboard/views',\n  '@agimon-ai/po-core/web',\n  '@agimon-ai/po-web-components',\n  '@agimon-ai/po-web-security/browser',\n  '@codemirror/state',\n  '@codemirror/view',\n] as const;\n\nconst WEB_PLUGIN_RUNTIME_PROPERTIES: Record<(typeof WEB_PLUGIN_RUNTIME_SPECIFIERS)[number], string> = {\n  react: 'react',\n  'react/jsx-runtime': 'reactJsxRuntime',\n  'react/jsx-dev-runtime': 'reactJsxDevRuntime',\n  'react-dom': 'reactDom',\n  'react-dom/client': 'reactDomClient',\n  '@tanstack/store': 'tanstackStore',\n  '@tanstack/react-store': 'tanstackReactStore',\n  '@tanstack/react-router': 'tanstackRouter',\n  '@agimon-ai/po-web-dashboard': 'dashboard',\n  '@agimon-ai/po-web-dashboard/views': 'dashboardViews',\n  '@agimon-ai/po-core/web': 'webContracts',\n  '@agimon-ai/po-web-components': 'webComponents',\n  '@agimon-ai/po-web-security/browser': 'webSecurityBrowser',\n  '@codemirror/state': 'codemirrorState',\n  '@codemirror/view': 'codemirrorView',\n};\n\ntype WebPluginRuntimeSpecifier = (typeof WEB_PLUGIN_RUNTIME_SPECIFIERS)[number];\n\n/** Expression for a shared module supplied by the session shell. */\nexport function webPluginRuntimeGlobal(specifier: WebPluginRuntimeSpecifier): string {\n  return `globalThis.PoWebPluginRuntime.${WEB_PLUGIN_RUNTIME_PROPERTIES[specifier]}`;\n}\n\n/** The React family ships CommonJS, so its names come from loading it rather than parsing it. */\nconst COMMONJS_RUNTIME_SPECIFIERS: ReadonlySet<string> = new Set([\n  'react',\n  'react/jsx-runtime',\n  'react/jsx-dev-runtime',\n  'react-dom',\n  'react-dom/client',\n]);\n\nconst FACADE_PREFIX = '\\0po-web-runtime:';\n/** The chunk every facade lands in, so each shared module is read from the runtime once. */\nexport const WEB_PLUGIN_FACADE_CHUNK = 'po-web-runtime';\n\n/** True for a module id that is one of the shared-module facades. */\nexport function isWebPluginFacade(id: string): boolean {\n  return id.startsWith(FACADE_PREFIX);\n}\n\n/** The ES module name of a default export. */\nconst DEFAULT_EXPORT = 'default';\n\ntype AstNode = { type: string; [key: string]: unknown };\n\nfunction patternNames(pattern: AstNode): string[] {\n  switch (pattern.type) {\n    case 'Identifier':\n      return [pattern.name as string];\n    case 'ObjectPattern':\n      return (pattern.properties as AstNode[]).flatMap((property) =>\n        patternNames((property.type === 'RestElement' ? property.argument : property.value) as AstNode),\n      );\n    case 'ArrayPattern':\n      return (pattern.elements as (AstNode | null)[]).flatMap((element) => (element ? patternNames(element) : []));\n    case 'RestElement':\n      return patternNames(pattern.argument as AstNode);\n    case 'AssignmentPattern':\n      return patternNames(pattern.left as AstNode);\n    default:\n      return [];\n  }\n}\n\nfunction exportedName(node: AstNode): string {\n  return node.type === 'Identifier' ? (node.name as string) : String(node.value);\n}\n\n/** Static reading of an ES module's export names, as the facade plugin needs it. */\nexport interface ExportNameReader {\n  parse: (code: string) => { body: unknown[] };\n  /** Resolves a bare specifier from the file that imports it, to a file path. */\n  resolve: (source: string, importer: string) => Promise<string | undefined>;\n}\n\n/**\n * The export names of an ES module file. `export *` is followed through relative paths,\n * and through a bare specifier only when that specifier is itself a shared module\n * (resolved from the re-exporting file, since that is the copy the runtime object holds).\n * Any other bare `export *` and any unparseable file fail the build.\n */\nexport async function esModuleExportNames(\n  specifier: string,\n  file: string,\n  reader: ExportNameReader,\n  seen: Set<string> = new Set(),\n): Promise<Set<string>> {\n  const names = new Set<string>();\n  if (seen.has(file)) return names;\n  seen.add(file);\n  let body: AstNode[];\n  try {\n    body = reader.parse(fs.readFileSync(file, 'utf8')).body as AstNode[];\n  } catch (error) {\n    throw new Error(\n      `The shared module '${specifier}' cannot be parsed at ${file}: ${error instanceof Error ? error.message : String(error)}`,\n    );\n  }\n  const shared: ReadonlySet<string> = new Set(WEB_PLUGIN_RUNTIME_SPECIFIERS);\n  for (const node of body) {\n    if (node.type === 'ExportDefaultDeclaration') names.add(DEFAULT_EXPORT);\n    if (node.type === 'ExportNamedDeclaration') {\n      const declaration = node.declaration as AstNode | null;\n      if (declaration?.type === 'VariableDeclaration') {\n        for (const declarator of declaration.declarations as AstNode[])\n          for (const name of patternNames(declarator.id as AstNode)) names.add(name);\n      } else if (declaration) {\n        names.add((declaration.id as AstNode).name as string);\n      }\n      for (const entry of (node.specifiers as AstNode[] | undefined) ?? [])\n        names.add(exportedName(entry.exported as AstNode));\n    }\n    if (node.type === 'ExportAllDeclaration') {\n      if (node.exported) {\n        names.add(exportedName(node.exported as AstNode));\n        continue;\n      }\n      const source = String((node.source as AstNode).value);\n      let target: string | undefined;\n      if (source.startsWith('./') || source.startsWith('../')) target = path.resolve(path.dirname(file), source);\n      else if (shared.has(source)) {\n        target = await reader.resolve(source, file);\n        if (target === undefined)\n          throw new Error(\n            `The shared module '${specifier}' re-exports '${source}', which does not resolve from ${file}.`,\n          );\n      } else\n        throw new Error(\n          `The shared module '${specifier}' re-exports everything from the bare specifier '${source}' (${file}), which is not a shared module; its names cannot be listed.`,\n        );\n      for (const name of await esModuleExportNames(specifier, target, reader, seen))\n        if (name !== DEFAULT_EXPORT) names.add(name);\n    }\n  }\n  return names;\n}\n\nconst IDENTIFIER = /^[A-Za-z_$][\\w$]*$/u;\n\n/** A module that reads one shared module from the page runtime and re-exports the given names. */\nexport function renderWebPluginFacade(specifier: WebPluginRuntimeSpecifier, names: Iterable<string>): string {\n  const all = new Set(names);\n  const lines = [`const runtime = ${webPluginRuntimeGlobal(specifier)};`];\n  const exported: string[] = [];\n  let index = 0;\n  for (const name of [...all].sort()) {\n    if (name === DEFAULT_EXPORT) continue;\n    const local = `_${String(index++)}`;\n    lines.push(`const ${local} = runtime[${JSON.stringify(name)}];`);\n    exported.push(`${local} as ${IDENTIFIER.test(name) ? name : JSON.stringify(name)}`);\n  }\n  if (exported.length > 0) lines.push(`export { ${exported.join(', ')} };`);\n  // CommonJS has no default export of its own; interop treats the whole object as one.\n  if (all.has(DEFAULT_EXPORT)) lines.push('export default runtime[\"default\"];');\n  else if (COMMONJS_RUNTIME_SPECIFIERS.has(specifier)) lines.push('export default runtime;');\n  lines.push('');\n  return lines.join('\\n');\n}\n\n/**\n * Resolves every shared runtime specifier to a virtual facade that re-exports, by name,\n * from `globalThis.PoWebPluginRuntime`, so ES-module slot entries can import them without\n * the page providing an import map. Names come from the host's own copy of each module.\n */\nexport function webPluginRuntimeFacadePlugin(hostRoot: string): Plugin {\n  const shared: ReadonlySet<string> = new Set(WEB_PLUGIN_RUNTIME_SPECIFIERS);\n  const hostImporter = path.join(hostRoot, 'package.json');\n  const hostRequire = createRequire(hostImporter);\n  return {\n    name: 'po-web-runtime-facades',\n    enforce: 'pre',\n    resolveId(source) {\n      return shared.has(source) ? `${FACADE_PREFIX}${source}` : null;\n    },\n    async load(id) {\n      if (!isWebPluginFacade(id)) return null;\n      const specifier = id.slice(FACADE_PREFIX.length) as WebPluginRuntimeSpecifier;\n      if (COMMONJS_RUNTIME_SPECIFIERS.has(specifier))\n        return renderWebPluginFacade(specifier, Object.keys(hostRequire(specifier) as object));\n      const resolveFile = async (source: string, importer: string): Promise<string | undefined> => {\n        const resolved = await this.resolve(source, importer, { skipSelf: true });\n        return resolved ? (resolved.id.split('?')[0] ?? resolved.id) : undefined;\n      };\n      const file = await resolveFile(specifier, hostImporter);\n      if (file === undefined) throw new Error(`The shared module '${specifier}' does not resolve from ${hostRoot}.`);\n      const { parseAst } = await import('vite');\n      return renderWebPluginFacade(\n        specifier,\n        await esModuleExportNames(specifier, file, { parse: (code) => parseAst(code), resolve: resolveFile }),\n      );\n    },\n  };\n}\n\n/** Resolves generated JSX imports from the host instead of a plugin's optional React peer tree. */\nexport function webPluginRuntimeAliases(clientRoot: string): Alias[] {\n  const runtimeRequire = createRequire(path.join(clientRoot, 'index.html'));\n  return WEB_PLUGIN_RUNTIME_SPECIFIERS.filter((specifier) => specifier.startsWith('react/jsx-')).map((specifier) => ({\n    find: new RegExp(`^${specifier.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')}$`, 'u'),\n    replacement: runtimeRequire.resolve(specifier),\n  }));\n}\n\n/**\n * Swaps the committed builtin registry modules for generated ones. A\n * resolveId hook rather than resolve.alias because aliases match raw import\n * specifiers while these two are known by their resolved paths. Both the\n * sync-time build and the dev server use it, so a plugin edit in dev is the\n * same module the bundle would carry.\n */\nexport function webPluginOverridePlugin(clientRoot: string, generated: WebPluginRegistryModules): Plugin {\n  const overrides = new Map([\n    [path.join(clientRoot, 'app', 'webPlugins.generated.ts'), generated.clientModulePath],\n    [path.join(clientRoot, 'styles', 'webPluginSources.generated.css'), generated.cssModulePath],\n  ]);\n  return {\n    name: 'po-web-plugin-overrides',\n    enforce: 'pre',\n    async resolveId(source, importer, options) {\n      if (!source.includes('webPlugins.generated') && !source.includes('webPluginSources.generated.css')) return null;\n      const resolved = await this.resolve(source, importer, { ...options, skipSelf: true });\n      if (!resolved) return null;\n      return overrides.get(resolved.id) ?? null;\n    },\n  };\n}\n\n/**\n * The CSS sources module cannot ride the resolveId hook: Vite and Tailwind\n * resolve CSS @import through Vite's own id resolver, which consults aliases\n * but no plugin hooks. Without this the builtin (empty) @source list ships\n * and every plugin-only utility class is missing.\n */\nexport function webPluginCssAlias(generated: WebPluginRegistryModules): Alias {\n  return { find: /^\\.\\/webPluginSources\\.generated\\.css$/, replacement: generated.cssModulePath };\n}\n\n/** The plugin package roots the dev server should serve, from an explicit override or PO_ROOT. */\nexport function readDevPluginRoots(environment: NodeJS.ProcessEnv, homeDirectory: string): string[] {\n  const explicit = environment[PLUGIN_ROOTS_ENV];\n  if (explicit !== undefined && explicit !== '') {\n    return devPluginRoots({ envValue: explicit, rootsFileText: undefined, delimiter: path.delimiter });\n  }\n  const repoRoot = environment[PO_ROOT_ENV];\n  if (repoRoot === undefined || repoRoot === '') return [];\n  // Resolved live from the root's configuration and installed packages, as the server does.\n  return compositionPackageRoots(rootCompositions({ root: repoRoot, homeDirectory, environment }));\n}\n"],"mappings":"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"}

package/dist/src/cli/cliApp.cjs

@@ -0,0 +1,187 @@
+const require_help = require("./help.cjs");
+const require_options = require("./options.cjs");
+//#region src/cli/cliApp.ts
+const NO_HARNESS_COMMAND = "No harness command selected: pass --explain or --emit-mcp, or run po to start po-web.";
+/**
+* Main CLI Application
+*
+* Owns command registration and dispatch. Preparation is shared: the context
+* is built once and handed to whichever command claims the run.
+*/
+async function selectHarnessCommand(options) {
+	if (options.emitMcp) return (await Promise.resolve().then(() => require("./commands/emit-mcp/index.cjs"))).runEmitMcp;
+	if (options.explain) return (await Promise.resolve().then(() => require("./commands/explain/index.cjs"))).runExplain;
+	throw new Error(NO_HARNESS_COMMAND);
+}
+async function selectLegacyCommand(options) {
+	if (options.emitMcp) {
+		const { EmitMcpCommand } = await Promise.resolve().then(() => require("./commands/emit-mcp/index.cjs"));
+		return new EmitMcpCommand();
+	}
+	if (options.explain) {
+		const { ExplainCommand } = await Promise.resolve().then(() => require("./commands/explain/index.cjs"));
+		return new ExplainCommand();
+	}
+	throw new Error(NO_HARNESS_COMMAND);
+}
+/**
+* The terminal app reads only what sync prepared. Packages the selected layers name that do not
+* resolve yet start a detached background sync from the repository, which registers it as a
+* workspace so sync covers its packages, and they arrive on the next launch.
+*/
+async function requestUnsyncedPackages(repoRoot, context) {
+	const [{ missingLayerPackageSpecifiers }, { createLayerResolvers }, { createBackgroundSync }] = await Promise.all([
+		Promise.resolve().then(() => require("../composition/layerPackageInstaller/index.cjs")),
+		Promise.resolve().then(() => require("../../builders/cli/extensionAssembler/index.cjs")),
+		Promise.resolve().then(() => require("../builders/server/backgroundSync.cjs"))
+	]);
+	const missing = missingLayerPackageSpecifiers(context.majorModesConfig, context.selectedLayers, createLayerResolvers(repoRoot, context.environment));
+	if (missing.length === 0) return;
+	const notice = (message) => {
+		process.stderr.write(`${message}\n`);
+	};
+	notice(createBackgroundSync({
+		environment: context.environment,
+		onNotice: notice,
+		detached: true,
+		repoRoot
+	}).request("the terminal app found unsynced packages") ? `Po is syncing ${missing.join(", ")} in the background; they arrive on the next launch.` : `${missing.join(", ")} ${missing.length === 1 ? "is" : "are"} not synced; run po sync to prepare them.`);
+}
+/** Only the diagnostic commands consume a harness context; bare `po` runs po-web. */
+function wantsHarnessCommand(options) {
+	return Boolean(options.emitMcp) || options.explain;
+}
+function createCliApplication(initialTelemetry) {
+	let telemetry = initialTelemetry;
+	let ownsTelemetry = false;
+	async function getTelemetry() {
+		if (telemetry) return telemetry;
+		const { createHarnessTelemetry } = await import("@agimon-ai/po-core/runtimeLogSinkTelemetry");
+		telemetry = createHarnessTelemetry({ deferSpans: true });
+		ownsTelemetry = true;
+		return telemetry;
+	}
+	async function runHarness(options) {
+		const telemetry = await getTelemetry();
+		const [{ buildHarnessContext }, { HARNESS_EVENT }] = await Promise.all([Promise.resolve().then(() => require("../builders/cli/harnessContext.cjs")), import("@agimon-ai/po-core/runtimeLogSinkTelemetry")]);
+		return telemetry.runInSpan("doom_pi.run", {
+			"harness.major_mode": options.majorMode,
+			"harness.domain_count": options.domains.length,
+			"harness.agents": options.agents,
+			"harness.mcp": options.mcp,
+			"harness.hooks": options.hooks,
+			...options.profile ? { "harness.profile": options.profile } : {},
+			...options.preset ? { "harness.preset": options.preset } : {}
+		}, async () => {
+			const context = await buildHarnessContext(options, telemetry);
+			try {
+				await requestUnsyncedPackages(options.repoRoot, context);
+				return await (await selectHarnessCommand(context.options))(context, telemetry);
+			} catch (error) {
+				await telemetry.recordError(HARNESS_EVENT.cliFailed, error);
+				throw error;
+			} finally {
+				await context.cleanup();
+			}
+		});
+	}
+	async function run(args) {
+		if (args[0] === "init") {
+			const { runInit } = await Promise.resolve().then(() => require("./commands/init/index.cjs"));
+			return runInit(args);
+		}
+		if (args[0] === "sync") {
+			const { runSync } = await Promise.resolve().then(() => require("./commands/sync/workflow.cjs"));
+			return runSync(args);
+		}
+		if (args[0] === "api-export") {
+			const { runApiExport } = await Promise.resolve().then(() => require("./commands/api-export/index.cjs"));
+			return runApiExport(args);
+		}
+		if (args[0] === "doctor") {
+			const { runDoctor } = await Promise.resolve().then(() => require("./commands/doctor/index.cjs"));
+			return runDoctor(args);
+		}
+		if (args[0] === "compat") {
+			const [{ runCompatibility }, telemetry] = await Promise.all([Promise.resolve().then(() => require("./commands/compat/index.cjs")), getTelemetry()]);
+			return runCompatibility(args, void 0, void 0, telemetry);
+		}
+		const initial = require_options.parseHarnessArgs(args);
+		if (initial.help) {
+			require_help.printHelp();
+			return 0;
+		}
+		if (initial.version) {
+			process.stdout.write(`${require_help.HARNESS_VERSION}\n`);
+			return 0;
+		}
+		if (!wantsHarnessCommand(initial.options)) {
+			const { runPoWeb } = await Promise.resolve().then(() => require("./commands/web/index.cjs"));
+			return runPoWeb(args);
+		}
+		const telemetry = await getTelemetry();
+		const [{ resolveHarnessOptions }, { toFailureReporter }] = await Promise.all([Promise.resolve().then(() => require("./harnessOptions.cjs")), import("@agimon-ai/po-core/runtimeLogSinkTelemetry")]);
+		return runHarness(resolveHarnessOptions({
+			args,
+			report: toFailureReporter(telemetry)
+		}));
+	}
+	async function shutdown() {
+		if (ownsTelemetry) await telemetry?.shutdown();
+	}
+	return {
+		run,
+		runHarness,
+		shutdown
+	};
+}
+/** Public compatibility API; execution is implemented by the application functions. */
+var CliApp = class {
+	app;
+	constructor(telemetry) {
+		this.app = createCliApplication(telemetry);
+	}
+	selectCommand(options) {
+		return selectLegacyCommand(options);
+	}
+	runHarness(options) {
+		return this.app.runHarness(options);
+	}
+	run(args) {
+		return this.app.run(args);
+	}
+	shutdown() {
+		return this.app.shutdown();
+	}
+};
+/**
+* Convenience wrapper kept so the binary and tests need no CliApp knowledge.
+*
+* Telemetry is shut down here rather than inside runHarness, because this is
+* the only scope that owns the process: flushing earlier would drop the records
+* a later command still emits.
+*/
+async function runCli(args) {
+	const app = createCliApplication();
+	try {
+		return await app.run(args);
+	} finally {
+		await app.shutdown();
+	}
+}
+/** Runs an already-resolved option set, skipping argument parsing. */
+async function runHarness(options) {
+	const app = createCliApplication();
+	try {
+		return await app.runHarness(options);
+	} finally {
+		await app.shutdown();
+	}
+}
+//#endregion
+exports.CliApp = CliApp;
+exports.requestUnsyncedPackages = requestUnsyncedPackages;
+exports.runCli = runCli;
+exports.runHarness = runHarness;
+
+//# sourceMappingURL=cliApp.cjs.map

package/dist/src/cli/cliApp.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliApp.cjs","names":["parseHarnessArgs","HARNESS_VERSION"],"sources":["../../../src/cli/cliApp.ts"],"sourcesContent":["import type { HarnessTelemetry } from '@agimon-ai/po-core/runtimeLogSinkTelemetry';\n\nimport type { HarnessOptions } from '../composition/types/harness';\nimport type { BaseCommand } from './commands/baseCommand';\nimport { HARNESS_VERSION, printHelp } from './help';\nimport { parseHarnessArgs } from './options';\n\nconst NO_HARNESS_COMMAND = 'No harness command selected: pass --explain or --emit-mcp, or run po to start po-web.';\n\n/**\n * Main CLI Application\n *\n * Owns command registration and dispatch. Preparation is shared: the context\n * is built once and handed to whichever command claims the run.\n */\nasync function selectHarnessCommand(\n  options: HarnessOptions,\n): Promise<\n  (context: import('../builders/cli/harnessContext').HarnessContext, telemetry: HarnessTelemetry) => Promise<number>\n> {\n  if (options.emitMcp) return (await import('./commands/emit-mcp')).runEmitMcp;\n  if (options.explain) return (await import('./commands/explain')).runExplain;\n  throw new Error(NO_HARNESS_COMMAND);\n}\nasync function selectLegacyCommand(options: HarnessOptions): Promise<BaseCommand> {\n  if (options.emitMcp) {\n    const { EmitMcpCommand } = await import('./commands/emit-mcp');\n    return new EmitMcpCommand();\n  }\n  if (options.explain) {\n    const { ExplainCommand } = await import('./commands/explain');\n    return new ExplainCommand();\n  }\n  throw new Error(NO_HARNESS_COMMAND);\n}\n/**\n * The terminal app reads only what sync prepared. Packages the selected layers name that do not\n * resolve yet start a detached background sync from the repository, which registers it as a\n * workspace so sync covers its packages, and they arrive on the next launch.\n */\nexport async function requestUnsyncedPackages(\n  repoRoot: string,\n  context: Pick<\n    import('../builders/cli/harnessContext').HarnessContext,\n    'majorModesConfig' | 'selectedLayers' | 'environment'\n  >,\n): Promise<void> {\n  const [{ missingLayerPackageSpecifiers }, { createLayerResolvers }, { createBackgroundSync }] = await Promise.all([\n    import('../composition/layerPackageInstaller'),\n    import('../builders/cli/extensionAssembler'),\n    import('../builders/server/backgroundSync'),\n  ]);\n  const missing = missingLayerPackageSpecifiers(\n    context.majorModesConfig,\n    context.selectedLayers,\n    createLayerResolvers(repoRoot, context.environment),\n  );\n  if (missing.length === 0) return;\n  const notice = (message: string): void => {\n    process.stderr.write(`${message}\\n`);\n  };\n  const started = createBackgroundSync({\n    environment: context.environment,\n    onNotice: notice,\n    detached: true,\n    repoRoot,\n  }).request('the terminal app found unsynced packages');\n  notice(\n    started\n      ? `Po is syncing ${missing.join(', ')} in the background; they arrive on the next launch.`\n      : `${missing.join(', ')} ${missing.length === 1 ? 'is' : 'are'} not synced; run po sync to prepare them.`,\n  );\n}\n/** Only the diagnostic commands consume a harness context; bare `po` runs po-web. */\nfunction wantsHarnessCommand(options: Pick<HarnessOptions, 'emitMcp' | 'explain'>): boolean {\n  return Boolean(options.emitMcp) || options.explain;\n}\nfunction createCliApplication(initialTelemetry?: HarnessTelemetry) {\n  let telemetry = initialTelemetry;\n  let ownsTelemetry = false;\n  async function getTelemetry(): Promise<HarnessTelemetry> {\n    if (telemetry) return telemetry;\n    const { createHarnessTelemetry } = await import('@agimon-ai/po-core/runtimeLogSinkTelemetry');\n    // Telemetry's transport graph costs roughly one launcher budget slice by\n    // itself. Startup callbacks and lifecycle events buffer until shutdown, so\n    // transport initialization cannot compete with the Pi child for input.\n    telemetry = createHarnessTelemetry({ deferSpans: true });\n    ownsTelemetry = true;\n    return telemetry;\n  }\n\n  async function runHarness(options: HarnessOptions): Promise<number> {\n    const telemetry = await getTelemetry();\n    const [{ buildHarnessContext }, { HARNESS_EVENT }] = await Promise.all([\n      import('../builders/cli/harnessContext'),\n      import('@agimon-ai/po-core/runtimeLogSinkTelemetry'),\n    ]);\n    return telemetry.runInSpan(\n      'doom_pi.run',\n      {\n        'harness.major_mode': options.majorMode,\n        'harness.domain_count': options.domains.length,\n        'harness.agents': options.agents,\n        'harness.mcp': options.mcp,\n        'harness.hooks': options.hooks,\n        ...(options.profile ? { 'harness.profile': options.profile } : {}),\n        ...(options.preset ? { 'harness.preset': options.preset } : {}),\n      },\n      async () => {\n        const context = await buildHarnessContext(options, telemetry);\n        try {\n          await requestUnsyncedPackages(options.repoRoot, context);\n          const command = await selectHarnessCommand(context.options);\n          // Selection uses the same resolved options used to build the context.\n          return await command(context, telemetry);\n        } catch (error) {\n          await telemetry.recordError(HARNESS_EVENT.cliFailed, error);\n          throw error;\n        } finally {\n          await context.cleanup();\n        }\n      },\n    );\n  }\n\n  async function run(args: string[]): Promise<number> {\n    if (args[0] === 'init') {\n      const { runInit } = await import('./commands/init');\n      return runInit(args);\n    }\n    if (args[0] === 'sync') {\n      const { runSync } = await import('./commands/sync/workflow');\n      return runSync(args);\n    }\n    if (args[0] === 'api-export') {\n      const { runApiExport } = await import('./commands/api-export');\n      return runApiExport(args);\n    }\n    if (args[0] === 'doctor') {\n      const { runDoctor } = await import('./commands/doctor');\n      return runDoctor(args);\n    }\n    if (args[0] === 'compat') {\n      const [{ runCompatibility }, telemetry] = await Promise.all([import('./commands/compat'), getTelemetry()]);\n      return runCompatibility(args, undefined, undefined, telemetry);\n    }\n\n    // The first pass resolves --cwd without touching repository configuration,\n    // which keeps help and version available even when modes.yaml is malformed.\n    const initial = parseHarnessArgs(args);\n    if (initial.help) {\n      printHelp();\n      return 0;\n    }\n    if (initial.version) {\n      process.stdout.write(`${HARNESS_VERSION}\\n`);\n      return 0;\n    }\n    // Bare `po` serves the web console. po-web owns its own arguments, so they\n    // pass through untouched and never reach repository configuration here.\n    if (!wantsHarnessCommand(initial.options)) {\n      const { runPoWeb } = await import('./commands/web');\n      return runPoWeb(args);\n    }\n    const telemetry = await getTelemetry();\n    const [{ resolveHarnessOptions }, { toFailureReporter }] = await Promise.all([\n      import('./harnessOptions'),\n      import('@agimon-ai/po-core/runtimeLogSinkTelemetry'),\n    ]);\n    return runHarness(resolveHarnessOptions({ args, report: toFailureReporter(telemetry) }));\n  }\n\n  async function shutdown(): Promise<void> {\n    if (ownsTelemetry) await telemetry?.shutdown();\n  }\n  return { run, runHarness, shutdown };\n}\n/** Public compatibility API; execution is implemented by the application functions. */\nexport class CliApp {\n  private readonly app: ReturnType<typeof createCliApplication>;\n  constructor(telemetry?: HarnessTelemetry) {\n    this.app = createCliApplication(telemetry);\n  }\n  selectCommand(options: HarnessOptions): Promise<BaseCommand> {\n    return selectLegacyCommand(options);\n  }\n  runHarness(options: HarnessOptions): Promise<number> {\n    return this.app.runHarness(options);\n  }\n  run(args: string[]): Promise<number> {\n    return this.app.run(args);\n  }\n  shutdown(): Promise<void> {\n    return this.app.shutdown();\n  }\n}\n\n/**\n * Convenience wrapper kept so the binary and tests need no CliApp knowledge.\n *\n * Telemetry is shut down here rather than inside runHarness, because this is\n * the only scope that owns the process: flushing earlier would drop the records\n * a later command still emits.\n */\nexport async function runCli(args: string[]): Promise<number> {\n  const app = createCliApplication();\n  try {\n    return await app.run(args);\n  } finally {\n    await app.shutdown();\n  }\n}\n\n/** Runs an already-resolved option set, skipping argument parsing. */\nexport async function runHarness(options: HarnessOptions): Promise<number> {\n  const app = createCliApplication();\n  try {\n    return await app.runHarness(options);\n  } finally {\n    await app.shutdown();\n  }\n}\n"],"mappings":"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"}