@agimon-ai/po 0.0.0-alpha.0

package/dist/src/composition/syncService/localBuilds.mjs

@@ -0,0 +1,358 @@
+import fs from "node:fs";
+import path from "node:path";
+import { writeFileAtomic } from "@agimon-ai/po-core/runtimeJson";
+import { spawn, spawnSync } from "node:child_process";
+import crypto from "node:crypto";
+//#region src/composition/syncService/localBuilds.ts
+/**
+* Builds the packages sync roots name by local path, so the web, native and MCP builds read
+* current output. Each package builds at most once per sync, in dependency order within the
+* local set, with the package manager its nearest lockfile names. Install never runs.
+*/
+const LOCAL_SOURCE_DIRECTORY = "src";
+const PACKAGE_MANIFEST = "package.json";
+const NODE_MODULES = "node_modules";
+const LOCAL_BUILDS_FILE = path.join("build", "local-builds.json");
+const BUILD_SCRIPT = "build";
+/** Bytes of stderr kept per build while it runs; older output is dropped as it arrives. */
+const STDERR_TAIL_BYTES = 65536;
+/**
+* A local build that runs longer than this is stopped and reported as failed. Sync holds its
+* lock while a build runs, so a hung build must not hold it forever.
+*/
+const LOCAL_BUILD_TIMEOUT_MS = 6e5;
+/** How long a build's stderr may stay open after it exits, held by a process it left running. */
+const STDERR_CLOSE_GRACE_MS = 1e3;
+const MILLISECONDS_PER_SECOND = 1e3;
+const LOGIN_SHELL_TIMEOUT_MS = 1e4;
+const DEFAULT_PACKAGE_MANAGER = "npm";
+const NO_SUCH_PROCESS = "ESRCH";
+/** Checked nearest-first in each folder; the first lockfile found names the package manager. */
+const LOCKFILES = [
+	["pnpm-lock.yaml", "pnpm"],
+	["bun.lock", "bun"],
+	["bun.lockb", "bun"],
+	["yarn.lock", "yarn"],
+	["package-lock.json", "npm"]
+];
+/** Variables a Po session or another harness exports; a package build must not see them. */
+const HARNESS_PREFIXES = [
+	"PO_",
+	"PI_",
+	"CLAUDE_",
+	"CODEX_"
+];
+const HARNESS_VARIABLES = /* @__PURE__ */ new Set([
+	"CLAUDECODE",
+	"MCP_UI_VIEWER",
+	"npm_config_user_agent"
+]);
+const DEPENDENCY_FIELDS = [
+	"dependencies",
+	"devDependencies",
+	"peerDependencies",
+	"optionalDependencies"
+];
+function sourceFiles(directory) {
+	let entries;
+	try {
+		entries = fs.readdirSync(directory, { withFileTypes: true });
+	} catch {
+		return [];
+	}
+	return entries.flatMap((entry) => {
+		const full = path.join(directory, entry.name);
+		if (entry.isDirectory()) return entry.name === NODE_MODULES ? [] : sourceFiles(full);
+		return entry.isFile() ? [full] : [];
+	});
+}
+/**
+* The build stamp of a local package: an mtime and size signature over its `package.json`
+* and every file under `src/`.
+* ponytail: it misses edits to dependencies outside the package; a content hash is the upgrade.
+*/
+function localBuildStamp(packageDirectory) {
+	const files = [path.join(packageDirectory, PACKAGE_MANIFEST), ...sourceFiles(path.join(packageDirectory, LOCAL_SOURCE_DIRECTORY))];
+	const hash = crypto.createHash("sha256");
+	for (const file of files.sort()) {
+		const relative = path.relative(packageDirectory, file);
+		try {
+			const stat = fs.statSync(file);
+			hash.update(`${relative}\0${String(stat.size)}\0${String(stat.mtimeMs)}\n`);
+		} catch {
+			hash.update(`${relative}\0missing\n`);
+		}
+	}
+	return hash.digest("hex");
+}
+function localBuildsPath(globalRoot) {
+	return path.join(globalRoot, LOCAL_BUILDS_FILE);
+}
+function readStamps(globalRoot) {
+	try {
+		const parsed = JSON.parse(fs.readFileSync(localBuildsPath(globalRoot), "utf8"));
+		return typeof parsed === "object" && parsed !== null ? parsed : {};
+	} catch {
+		return {};
+	}
+}
+function readManifest(directory) {
+	try {
+		return JSON.parse(fs.readFileSync(path.join(directory, PACKAGE_MANIFEST), "utf8"));
+	} catch {
+		return;
+	}
+}
+/** The package manager the nearest lockfile names, walking up from the package. */
+function packageManagerFor(directory) {
+	let current = path.resolve(directory);
+	for (;;) {
+		for (const [lockfile, manager] of LOCKFILES) if (fs.existsSync(path.join(current, lockfile))) return manager;
+		const parent = path.dirname(current);
+		if (parent === current) return DEFAULT_PACKAGE_MANAGER;
+		current = parent;
+	}
+}
+function findOnPath(binary, searchPath) {
+	for (const directory of (searchPath ?? "").split(path.delimiter).filter(Boolean)) {
+		const candidate = path.join(directory, binary);
+		try {
+			fs.accessSync(candidate, fs.constants.X_OK);
+			if (fs.statSync(candidate).isFile()) return candidate;
+		} catch {}
+	}
+}
+/**
+* The login shell's PATH. Desktop apps launched from Finder get a minimal PATH (inferred,
+* not checked here), so a package manager installed through a shell profile is missing.
+*/
+function loginShellPath(environment) {
+	const shell = environment.SHELL ?? "/bin/zsh";
+	const result = spawnSync(shell, ["-ilc", "printf %s \"$PATH\""], {
+		encoding: "utf8",
+		timeout: LOGIN_SHELL_TIMEOUT_MS
+	});
+	return result.status === 0 && result.stdout.trim() !== "" ? result.stdout.trim() : void 0;
+}
+/** The build environment: the caller's minus every `PO_*` and harness variable. */
+function buildEnvironment(environment) {
+	return Object.fromEntries(Object.entries(environment).filter(([name]) => !HARNESS_VARIABLES.has(name) && !HARNESS_PREFIXES.some((prefix) => name.startsWith(prefix))));
+}
+function entryPaths(value) {
+	if (typeof value === "string") return [value];
+	if (Array.isArray(value)) return value.flatMap(entryPaths);
+	if (typeof value === "object" && value !== null) return Object.values(value).flatMap(entryPaths);
+	return [];
+}
+/** Whether every file `main`, `module` and `exports` name exists; false when they name none. */
+function builtEntriesPresent(directory, manifest) {
+	const entries = [
+		manifest.main,
+		manifest.module,
+		manifest.exports
+	].flatMap(entryPaths).filter((entry) => !entry.includes("*"));
+	return entries.length > 0 && entries.every((entry) => fs.existsSync(path.resolve(directory, entry)));
+}
+/** The directories ordered so each local package builds after the local packages it depends on. */
+function dependencyOrder(directories, manifests) {
+	const byName = /* @__PURE__ */ new Map();
+	for (const directory of directories) {
+		const name = manifests.get(directory)?.name;
+		if (name !== void 0) byName.set(name, directory);
+	}
+	const ordered = [];
+	const visiting = /* @__PURE__ */ new Set();
+	const visit = (directory) => {
+		if (ordered.includes(directory) || visiting.has(directory)) return;
+		visiting.add(directory);
+		const manifest = manifests.get(directory);
+		for (const field of DEPENDENCY_FIELDS) {
+			const dependencies = manifest?.[field];
+			if (typeof dependencies !== "object" || dependencies === null) continue;
+			for (const name of Object.keys(dependencies)) {
+				const dependency = byName.get(name);
+				if (dependency !== void 0) visit(dependency);
+			}
+		}
+		visiting.delete(directory);
+		ordered.push(directory);
+	};
+	for (const directory of directories) visit(directory);
+	return ordered;
+}
+function stderrTail(stderr) {
+	return stderr.trimEnd().split("\n").filter(Boolean).slice(-20);
+}
+/** Signals that end this process; a build in its own process group would not receive them. */
+const FORWARDED_SIGNALS = [
+	"SIGINT",
+	"SIGTERM",
+	"SIGHUP"
+];
+const SEPARATE_PROCESS_GROUPS = process.platform !== "win32";
+/**
+* Kills the build and everything it started. The build leads its own process group, so the
+* package manager's tsc or vite children die with it.
+* ponytail: Windows has no process groups here, so only the package manager is killed there;
+* `taskkill /T /F` is the upgrade if Windows builds must stop their children too.
+*/
+function killBuild(child) {
+	if (!SEPARATE_PROCESS_GROUPS || child.pid === void 0) {
+		child.kill("SIGKILL");
+		return;
+	}
+	try {
+		process.kill(-child.pid, "SIGKILL");
+	} catch (error) {
+		if (error.code !== NO_SUCH_PROCESS) child.kill("SIGKILL");
+	}
+}
+/**
+* Runs one build script without buffering its output: stdout is discarded and only the stderr
+* tail is kept. A build still running after `timeoutMs` is killed with every process it started
+* and reported as timed out. A build that exits while something it started still holds stderr
+* open has that process group killed when the grace ends, so nothing writes after it returns.
+*/
+function runBuildScript(binary, directory, environment, timeoutMs) {
+	return new Promise((resolve) => {
+		let tail = Buffer.alloc(0);
+		let timedOut = false;
+		let leftRunning = false;
+		let settled = false;
+		let grace;
+		const child = spawn(binary, ["run", BUILD_SCRIPT], {
+			cwd: directory,
+			env: environment,
+			stdio: [
+				"ignore",
+				"ignore",
+				"pipe"
+			],
+			detached: SEPARATE_PROCESS_GROUPS
+		});
+		const forward = (signal) => {
+			killBuild(child);
+			if (process.listenerCount(signal) > 1) return;
+			process.removeListener(signal, forward);
+			process.kill(process.pid, signal);
+		};
+		if (SEPARATE_PROCESS_GROUPS) for (const signal of FORWARDED_SIGNALS) process.on(signal, forward);
+		const finish = (result) => {
+			if (settled) return;
+			settled = true;
+			clearTimeout(timer);
+			clearTimeout(grace);
+			for (const signal of FORWARDED_SIGNALS) process.removeListener(signal, forward);
+			child.stderr?.destroy();
+			resolve({
+				...result,
+				timedOut,
+				leftRunning,
+				stderr: tail.toString("utf8")
+			});
+		};
+		const timer = setTimeout(() => {
+			timedOut = true;
+			killBuild(child);
+		}, timeoutMs);
+		child.stderr?.on("data", (chunk) => {
+			tail = Buffer.concat([tail, chunk]);
+			if (tail.length > STDERR_TAIL_BYTES) tail = tail.subarray(tail.length - STDERR_TAIL_BYTES);
+		});
+		child.on("error", (error) => finish({
+			status: null,
+			signal: null,
+			error
+		}));
+		child.on("close", (status, signal) => finish({
+			status,
+			signal
+		}));
+		child.on("exit", (status, signal) => {
+			grace = setTimeout(() => {
+				if (!timedOut) leftRunning = true;
+				killBuild(child);
+				finish({
+					status,
+					signal
+				});
+			}, timedOut ? 0 : STDERR_CLOSE_GRACE_MS);
+		});
+	});
+}
+/**
+* Builds every local package that changed since its last successful build, and returns each
+* directory's outcome. A failure never stops the others.
+*/
+async function buildLocalPackages(input) {
+	const { globalRoot, environment, onCommand, onNotice } = input;
+	const timeoutMs = input.timeoutMs ?? 6e5;
+	const directories = [...new Set(input.directories)];
+	const manifests = new Map(directories.map((directory) => [directory, readManifest(directory)]));
+	const stamps = readStamps(globalRoot);
+	const outcomes = /* @__PURE__ */ new Map();
+	const childEnvironment = buildEnvironment(environment);
+	let searchPath = environment.PATH;
+	let loginPathTried = false;
+	const resolveBinary = (manager) => {
+		const found = findOnPath(manager, searchPath);
+		if (found !== void 0 || loginPathTried || process.platform !== "darwin") return found;
+		loginPathTried = true;
+		const loginPath = loginShellPath(environment);
+		if (loginPath === void 0) return void 0;
+		searchPath = loginPath;
+		childEnvironment.PATH = loginPath;
+		return findOnPath(manager, searchPath);
+	};
+	for (const directory of dependencyOrder(directories, manifests)) {
+		const manifest = manifests.get(directory);
+		if (manifest === void 0) {
+			outcomes.set(directory, {
+				status: "failed",
+				reason: `'${directory}' has no readable package.json`
+			});
+			continue;
+		}
+		const stamp = localBuildStamp(directory);
+		if (stamps[directory] === stamp) {
+			outcomes.set(directory, { status: "cached" });
+			continue;
+		}
+		if (typeof manifest.scripts?.[BUILD_SCRIPT] !== "string") {
+			outcomes.set(directory, builtEntriesPresent(directory, manifest) ? { status: "cached" } : {
+				status: "failed",
+				reason: "it has no build script and no built entries"
+			});
+			continue;
+		}
+		const manager = packageManagerFor(directory);
+		const binary = resolveBinary(manager);
+		if (binary === void 0) {
+			outcomes.set(directory, {
+				status: "failed",
+				reason: `${manager} is not on PATH`
+			});
+			continue;
+		}
+		onCommand(`${binary} run ${BUILD_SCRIPT} (in ${directory})`);
+		onNotice(`building ${manifest.name ?? directory}`);
+		const result = await runBuildScript(binary, directory, childEnvironment, timeoutMs);
+		if (result.status === 0 && !result.timedOut && !result.leftRunning) {
+			stamps[directory] = localBuildStamp(directory);
+			writeFileAtomic(localBuildsPath(globalRoot), `${JSON.stringify(stamps, null, 2)}\n`);
+			outcomes.set(directory, { status: "built" });
+			continue;
+		}
+		const exit = result.timedOut ? `timed out after ${String(timeoutMs / MILLISECONDS_PER_SECOND)} s` : result.status === 0 && result.leftRunning ? "it exited but left processes running, which were stopped" : result.error?.message ?? `exit ${String(result.status ?? result.signal)}`;
+		outcomes.set(directory, {
+			status: "failed",
+			reason: `${manager} run ${BUILD_SCRIPT} failed (${exit})`,
+			stderr: stderrTail(result.stderr)
+		});
+	}
+	return outcomes;
+}
+//#endregion
+export { LOCAL_BUILD_TIMEOUT_MS, buildEnvironment, buildLocalPackages, localBuildStamp, localBuildsPath, packageManagerFor };
+
+//# sourceMappingURL=localBuilds.mjs.map

package/dist/src/composition/syncService/localBuilds.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"localBuilds.mjs","names":[],"sources":["../../../../src/composition/syncService/localBuilds.ts"],"sourcesContent":["import { type ChildProcess, spawn, spawnSync } from 'node:child_process';\nimport crypto from 'node:crypto';\nimport fs from 'node:fs';\nimport path from 'node:path';\n\nimport { writeFileAtomic } from '@agimon-ai/po-core/runtimeJson';\n\n/**\n * Builds the packages sync roots name by local path, so the web, native and MCP builds read\n * current output. Each package builds at most once per sync, in dependency order within the\n * local set, with the package manager its nearest lockfile names. Install never runs.\n */\n\nconst LOCAL_SOURCE_DIRECTORY = 'src';\nconst PACKAGE_MANIFEST = 'package.json';\nconst NODE_MODULES = 'node_modules';\nconst LOCAL_BUILDS_FILE = path.join('build', 'local-builds.json');\nconst BUILD_SCRIPT = 'build';\nconst STDERR_TAIL_LINES = 20;\n/** Bytes of stderr kept per build while it runs; older output is dropped as it arrives. */\nconst STDERR_TAIL_BYTES = 64 * 1024;\n/**\n * A local build that runs longer than this is stopped and reported as failed. Sync holds its\n * lock while a build runs, so a hung build must not hold it forever.\n */\nexport const LOCAL_BUILD_TIMEOUT_MS = 10 * 60 * 1000;\n/** How long a build's stderr may stay open after it exits, held by a process it left running. */\nconst STDERR_CLOSE_GRACE_MS = 1000;\nconst MILLISECONDS_PER_SECOND = 1000;\nconst LOGIN_SHELL_TIMEOUT_MS = 10_000;\nconst DEFAULT_PACKAGE_MANAGER = 'npm';\nconst NO_SUCH_PROCESS = 'ESRCH';\n/** Checked nearest-first in each folder; the first lockfile found names the package manager. */\nconst LOCKFILES: readonly (readonly [string, string])[] = [\n  ['pnpm-lock.yaml', 'pnpm'],\n  ['bun.lock', 'bun'],\n  ['bun.lockb', 'bun'],\n  ['yarn.lock', 'yarn'],\n  ['package-lock.json', 'npm'],\n];\n/** Variables a Po session or another harness exports; a package build must not see them. */\nconst HARNESS_PREFIXES = ['PO_', 'PI_', 'CLAUDE_', 'CODEX_'];\nconst HARNESS_VARIABLES = new Set(['CLAUDECODE', 'MCP_UI_VIEWER', 'npm_config_user_agent']);\nconst DEPENDENCY_FIELDS = ['dependencies', 'devDependencies', 'peerDependencies', 'optionalDependencies'];\n\nexport interface LocalPackage {\n  /** The selector as a root's configuration names it. */\n  selector: string;\n  directory: string;\n}\n\nexport type LocalBuildOutcome =\n  | { status: 'built' | 'cached' }\n  | { status: 'failed'; reason: string; stderr?: string[] };\n\nexport interface LocalBuildInput {\n  globalRoot: string;\n  environment: NodeJS.ProcessEnv;\n  directories: readonly string[];\n  /** Receives each command line as it starts. */\n  onCommand: (command: string) => void;\n  onNotice: (message: string) => void;\n  /** Overrides `LOCAL_BUILD_TIMEOUT_MS`. */\n  timeoutMs?: number;\n}\n\ninterface Manifest {\n  name?: string;\n  main?: unknown;\n  module?: unknown;\n  exports?: unknown;\n  scripts?: Record<string, unknown>;\n  [field: string]: unknown;\n}\n\nfunction sourceFiles(directory: string): string[] {\n  let entries: fs.Dirent[];\n  try {\n    entries = fs.readdirSync(directory, { withFileTypes: true });\n  } catch {\n    // A package without a source folder has only its manifest to stamp.\n    return [];\n  }\n  return entries.flatMap((entry) => {\n    const full = path.join(directory, entry.name);\n    if (entry.isDirectory()) return entry.name === NODE_MODULES ? [] : sourceFiles(full);\n    return entry.isFile() ? [full] : [];\n  });\n}\n\n/**\n * The build stamp of a local package: an mtime and size signature over its `package.json`\n * and every file under `src/`.\n * ponytail: it misses edits to dependencies outside the package; a content hash is the upgrade.\n */\nexport function localBuildStamp(packageDirectory: string): string {\n  const files = [\n    path.join(packageDirectory, PACKAGE_MANIFEST),\n    ...sourceFiles(path.join(packageDirectory, LOCAL_SOURCE_DIRECTORY)),\n  ];\n  const hash = crypto.createHash('sha256');\n  for (const file of files.sort()) {\n    const relative = path.relative(packageDirectory, file);\n    try {\n      const stat = fs.statSync(file);\n      hash.update(`${relative}\\0${String(stat.size)}\\0${String(stat.mtimeMs)}\\n`);\n    } catch {\n      // Recorded as missing, so the stamp moves when the file appears.\n      hash.update(`${relative}\\0missing\\n`);\n    }\n  }\n  return hash.digest('hex');\n}\n\nexport function localBuildsPath(globalRoot: string): string {\n  return path.join(globalRoot, LOCAL_BUILDS_FILE);\n}\n\nfunction readStamps(globalRoot: string): Record<string, string> {\n  try {\n    const parsed = JSON.parse(fs.readFileSync(localBuildsPath(globalRoot), 'utf8')) as unknown;\n    return typeof parsed === 'object' && parsed !== null ? (parsed as Record<string, string>) : {};\n  } catch {\n    // Missing or unreadable: every package builds once.\n    return {};\n  }\n}\n\nfunction readManifest(directory: string): Manifest | undefined {\n  try {\n    return JSON.parse(fs.readFileSync(path.join(directory, PACKAGE_MANIFEST), 'utf8')) as Manifest;\n  } catch {\n    return undefined;\n  }\n}\n\n/** The package manager the nearest lockfile names, walking up from the package. */\nexport function packageManagerFor(directory: string): string {\n  let current = path.resolve(directory);\n  for (;;) {\n    for (const [lockfile, manager] of LOCKFILES) if (fs.existsSync(path.join(current, lockfile))) return manager;\n    const parent = path.dirname(current);\n    if (parent === current) return DEFAULT_PACKAGE_MANAGER;\n    current = parent;\n  }\n}\n\nfunction findOnPath(binary: string, searchPath: string | undefined): string | undefined {\n  for (const directory of (searchPath ?? '').split(path.delimiter).filter(Boolean)) {\n    const candidate = path.join(directory, binary);\n    try {\n      fs.accessSync(candidate, fs.constants.X_OK);\n      if (fs.statSync(candidate).isFile()) return candidate;\n    } catch {\n      // Not in this folder.\n    }\n  }\n  return undefined;\n}\n\n/**\n * The login shell's PATH. Desktop apps launched from Finder get a minimal PATH (inferred,\n * not checked here), so a package manager installed through a shell profile is missing.\n */\nfunction loginShellPath(environment: NodeJS.ProcessEnv): string | undefined {\n  const shell = environment.SHELL ?? '/bin/zsh';\n  const result = spawnSync(shell, ['-ilc', 'printf %s \"$PATH\"'], {\n    encoding: 'utf8',\n    timeout: LOGIN_SHELL_TIMEOUT_MS,\n  });\n  return result.status === 0 && result.stdout.trim() !== '' ? result.stdout.trim() : undefined;\n}\n\n/** The build environment: the caller's minus every `PO_*` and harness variable. */\nexport function buildEnvironment(environment: NodeJS.ProcessEnv): NodeJS.ProcessEnv {\n  return Object.fromEntries(\n    Object.entries(environment).filter(\n      ([name]) => !HARNESS_VARIABLES.has(name) && !HARNESS_PREFIXES.some((prefix) => name.startsWith(prefix)),\n    ),\n  );\n}\n\nfunction entryPaths(value: unknown): string[] {\n  if (typeof value === 'string') return [value];\n  if (Array.isArray(value)) return value.flatMap(entryPaths);\n  if (typeof value === 'object' && value !== null) return Object.values(value).flatMap(entryPaths);\n  return [];\n}\n\n/** Whether every file `main`, `module` and `exports` name exists; false when they name none. */\nfunction builtEntriesPresent(directory: string, manifest: Manifest): boolean {\n  const entries = [manifest.main, manifest.module, manifest.exports]\n    .flatMap(entryPaths)\n    .filter((entry) => !entry.includes('*'));\n  return entries.length > 0 && entries.every((entry) => fs.existsSync(path.resolve(directory, entry)));\n}\n\n/** The directories ordered so each local package builds after the local packages it depends on. */\nfunction dependencyOrder(directories: readonly string[], manifests: Map<string, Manifest | undefined>): string[] {\n  const byName = new Map<string, string>();\n  for (const directory of directories) {\n    const name = manifests.get(directory)?.name;\n    if (name !== undefined) byName.set(name, directory);\n  }\n  const ordered: string[] = [];\n  const visiting = new Set<string>();\n  const visit = (directory: string): void => {\n    if (ordered.includes(directory) || visiting.has(directory)) return;\n    visiting.add(directory);\n    const manifest = manifests.get(directory);\n    for (const field of DEPENDENCY_FIELDS) {\n      const dependencies = manifest?.[field];\n      if (typeof dependencies !== 'object' || dependencies === null) continue;\n      for (const name of Object.keys(dependencies)) {\n        const dependency = byName.get(name);\n        if (dependency !== undefined) visit(dependency);\n      }\n    }\n    visiting.delete(directory);\n    ordered.push(directory);\n  };\n  for (const directory of directories) visit(directory);\n  return ordered;\n}\n\nfunction stderrTail(stderr: string): string[] {\n  return stderr.trimEnd().split('\\n').filter(Boolean).slice(-STDERR_TAIL_LINES);\n}\n\ninterface BuildRun {\n  status: number | null;\n  signal: NodeJS.Signals | null;\n  error?: Error;\n  timedOut: boolean;\n  /** It exited while a process it started still held stderr open; that process was stopped. */\n  leftRunning: boolean;\n  /** The last `STDERR_TAIL_BYTES` of stderr. */\n  stderr: string;\n}\n\n/** Signals that end this process; a build in its own process group would not receive them. */\nconst FORWARDED_SIGNALS: readonly NodeJS.Signals[] = ['SIGINT', 'SIGTERM', 'SIGHUP'];\nconst SEPARATE_PROCESS_GROUPS = process.platform !== 'win32';\n\n/**\n * Kills the build and everything it started. The build leads its own process group, so the\n * package manager's tsc or vite children die with it.\n * ponytail: Windows has no process groups here, so only the package manager is killed there;\n * `taskkill /T /F` is the upgrade if Windows builds must stop their children too.\n */\nfunction killBuild(child: ChildProcess): void {\n  if (!SEPARATE_PROCESS_GROUPS || child.pid === undefined) {\n    child.kill('SIGKILL');\n    return;\n  }\n  try {\n    process.kill(-child.pid, 'SIGKILL');\n  } catch (error) {\n    // ESRCH: every process of the group has exited already, which is the goal. Anything else\n    // (EPERM) falls back to the package manager alone rather than crash inside a timer.\n    if ((error as NodeJS.ErrnoException).code !== NO_SUCH_PROCESS) child.kill('SIGKILL');\n  }\n}\n\n/**\n * Runs one build script without buffering its output: stdout is discarded and only the stderr\n * tail is kept. A build still running after `timeoutMs` is killed with every process it started\n * and reported as timed out. A build that exits while something it started still holds stderr\n * open has that process group killed when the grace ends, so nothing writes after it returns.\n */\nfunction runBuildScript(\n  binary: string,\n  directory: string,\n  environment: NodeJS.ProcessEnv,\n  timeoutMs: number,\n): Promise<BuildRun> {\n  return new Promise((resolve) => {\n    let tail = Buffer.alloc(0);\n    let timedOut = false;\n    let leftRunning = false;\n    let settled = false;\n    let grace: NodeJS.Timeout | undefined;\n    // Its own process group, so a kill reaches its children. Still awaited: never unref'd.\n    const child = spawn(binary, ['run', BUILD_SCRIPT], {\n      cwd: directory,\n      env: environment,\n      stdio: ['ignore', 'ignore', 'pipe'],\n      detached: SEPARATE_PROCESS_GROUPS,\n    });\n    // A detached build no longer gets the terminal's Ctrl+C, so this process passes it on.\n    const forward = (signal: NodeJS.Signals): void => {\n      killBuild(child);\n      if (process.listenerCount(signal) > 1) return;\n      // Only this handler was listening: end as the signal would have without it.\n      process.removeListener(signal, forward);\n      process.kill(process.pid, signal);\n    };\n    if (SEPARATE_PROCESS_GROUPS) for (const signal of FORWARDED_SIGNALS) process.on(signal, forward);\n    const finish = (result: Pick<BuildRun, 'status' | 'signal' | 'error'>): void => {\n      if (settled) return;\n      settled = true;\n      clearTimeout(timer);\n      clearTimeout(grace);\n      for (const signal of FORWARDED_SIGNALS) process.removeListener(signal, forward);\n      child.stderr?.destroy();\n      resolve({ ...result, timedOut, leftRunning, stderr: tail.toString('utf8') });\n    };\n    const timer = setTimeout(() => {\n      timedOut = true;\n      killBuild(child);\n    }, timeoutMs);\n    child.stderr?.on('data', (chunk: Buffer) => {\n      tail = Buffer.concat([tail, chunk]);\n      if (tail.length > STDERR_TAIL_BYTES) tail = tail.subarray(tail.length - STDERR_TAIL_BYTES);\n    });\n    child.on('error', (error) => finish({ status: null, signal: null, error }));\n    child.on('close', (status, signal) => finish({ status, signal }));\n    // A process the build left running can hold stderr open, so 'close' may never come.\n    child.on('exit', (status, signal) => {\n      grace = setTimeout(\n        () => {\n          if (!timedOut) leftRunning = true;\n          killBuild(child);\n          finish({ status, signal });\n        },\n        timedOut ? 0 : STDERR_CLOSE_GRACE_MS,\n      );\n    });\n  });\n}\n\n/**\n * Builds every local package that changed since its last successful build, and returns each\n * directory's outcome. A failure never stops the others.\n */\nexport async function buildLocalPackages(input: LocalBuildInput): Promise<Map<string, LocalBuildOutcome>> {\n  const { globalRoot, environment, onCommand, onNotice } = input;\n  const timeoutMs = input.timeoutMs ?? LOCAL_BUILD_TIMEOUT_MS;\n  const directories = [...new Set(input.directories)];\n  const manifests = new Map(directories.map((directory) => [directory, readManifest(directory)]));\n  const stamps = readStamps(globalRoot);\n  const outcomes = new Map<string, LocalBuildOutcome>();\n  const childEnvironment = buildEnvironment(environment);\n  let searchPath = environment.PATH;\n  let loginPathTried = false;\n  const resolveBinary = (manager: string): string | undefined => {\n    const found = findOnPath(manager, searchPath);\n    if (found !== undefined || loginPathTried || process.platform !== 'darwin') return found;\n    loginPathTried = true;\n    const loginPath = loginShellPath(environment);\n    if (loginPath === undefined) return undefined;\n    searchPath = loginPath;\n    childEnvironment.PATH = loginPath;\n    return findOnPath(manager, searchPath);\n  };\n\n  for (const directory of dependencyOrder(directories, manifests)) {\n    const manifest = manifests.get(directory);\n    if (manifest === undefined) {\n      outcomes.set(directory, { status: 'failed', reason: `'${directory}' has no readable package.json` });\n      continue;\n    }\n    const stamp = localBuildStamp(directory);\n    // ponytail: an unchanged stamp skips the build even when a dependency outside the\n    // package changed; a content hash over the dependency closure is the upgrade.\n    if (stamps[directory] === stamp) {\n      outcomes.set(directory, { status: 'cached' });\n      continue;\n    }\n    if (typeof manifest.scripts?.[BUILD_SCRIPT] !== 'string') {\n      outcomes.set(\n        directory,\n        builtEntriesPresent(directory, manifest)\n          ? { status: 'cached' }\n          : { status: 'failed', reason: 'it has no build script and no built entries' },\n      );\n      continue;\n    }\n    const manager = packageManagerFor(directory);\n    const binary = resolveBinary(manager);\n    if (binary === undefined) {\n      outcomes.set(directory, { status: 'failed', reason: `${manager} is not on PATH` });\n      continue;\n    }\n    const command = `${binary} run ${BUILD_SCRIPT} (in ${directory})`;\n    onCommand(command);\n    onNotice(`building ${manifest.name ?? directory}`);\n    const result = await runBuildScript(binary, directory, childEnvironment, timeoutMs);\n    if (result.status === 0 && !result.timedOut && !result.leftRunning) {\n      // The stamp after the build, as the sync pointer records it: a build that writes into\n      // src/ or package.json must not look changed to the next sync.\n      stamps[directory] = localBuildStamp(directory);\n      writeFileAtomic(localBuildsPath(globalRoot), `${JSON.stringify(stamps, null, 2)}\\n`);\n      outcomes.set(directory, { status: 'built' });\n      continue;\n    }\n    const exit = result.timedOut\n      ? `timed out after ${String(timeoutMs / MILLISECONDS_PER_SECOND)} s`\n      : result.status === 0 && result.leftRunning\n        ? 'it exited but left processes running, which were stopped'\n        : (result.error?.message ?? `exit ${String(result.status ?? result.signal)}`);\n    outcomes.set(directory, {\n      status: 'failed',\n      reason: `${manager} run ${BUILD_SCRIPT} failed (${exit})`,\n      stderr: stderrTail(result.stderr),\n    });\n  }\n  return outcomes;\n}\n"],"mappings":"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"}

package/dist/src/composition/transitionLayers.cjs

@@ -0,0 +1,17 @@
+//#region src/composition/transitionLayers.ts
+function extensionLayers(config, names) {
+	return names.filter((name) => {
+		const layer = config.layers[name];
+		return Boolean(layer && ((layer.extensions?.length ?? 0) > 0 || (layer.packages?.length ?? 0) > 0));
+	});
+}
+function needsRelaunch(config, before, after) {
+	const previous = extensionLayers(config, before);
+	const candidate = extensionLayers(config, after);
+	return previous.length !== candidate.length || previous.some((name, index) => name !== candidate[index]);
+}
+//#endregion
+exports.extensionLayers = extensionLayers;
+exports.needsRelaunch = needsRelaunch;
+
+//# sourceMappingURL=transitionLayers.cjs.map

package/dist/src/composition/transitionLayers.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"transitionLayers.cjs","names":[],"sources":["../../../src/composition/transitionLayers.ts"],"sourcesContent":["import type { MajorModesConfig } from '@agimon-ai/po-config/majorModes';\nexport function extensionLayers(config: MajorModesConfig, names: readonly string[]): string[] {\n  return names.filter((name) => {\n    const layer = config.layers[name];\n    return Boolean(layer && ((layer.extensions?.length ?? 0) > 0 || (layer.packages?.length ?? 0) > 0));\n  });\n}\n\nexport function needsRelaunch(config: MajorModesConfig, before: readonly string[], after: readonly string[]): boolean {\n  const previous = extensionLayers(config, before);\n  const candidate = extensionLayers(config, after);\n  return previous.length !== candidate.length || previous.some((name, index) => name !== candidate[index]);\n}\n"],"mappings":";AACA,SAAgB,gBAAgB,QAA0B,OAAoC;CAC5F,OAAO,MAAM,QAAQ,SAAS;EAC5B,MAAM,QAAQ,OAAO,OAAO;EAC5B,OAAO,QAAQ,WAAW,MAAM,YAAY,UAAU,KAAK,MAAM,MAAM,UAAU,UAAU,KAAK,EAAE;CACpG,CAAC;AACH;AAEA,SAAgB,cAAc,QAA0B,QAA2B,OAAmC;CACpH,MAAM,WAAW,gBAAgB,QAAQ,MAAM;CAC/C,MAAM,YAAY,gBAAgB,QAAQ,KAAK;CAC/C,OAAO,SAAS,WAAW,UAAU,UAAU,SAAS,MAAM,MAAM,UAAU,SAAS,UAAU,MAAM;AACzG"}

package/dist/src/composition/transitionLayers.d.mts

@@ -0,0 +1,6 @@
+import { MajorModesConfig } from "@agimon-ai/po-config/majorModes";
+//#region src/composition/transitionLayers.d.ts
+export declare function extensionLayers(config: MajorModesConfig, names: readonly string[]): string[];
+export declare function needsRelaunch(config: MajorModesConfig, before: readonly string[], after: readonly string[]): boolean;
+//#endregion
+//# sourceMappingURL=transitionLayers.d.mts.map

package/dist/src/composition/transitionLayers.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transitionLayers.d.mts","names":[],"sources":["../../../src/composition/transitionLayers.ts"],"mappings":";;wBACgB,gBAAgB,QAAQ,kBAAkB;wBAO1C,cAAc,QAAQ,kBAAkB,2BAA2B"}

package/dist/src/composition/transitionLayers.mjs

@@ -0,0 +1,16 @@
+//#region src/composition/transitionLayers.ts
+function extensionLayers(config, names) {
+	return names.filter((name) => {
+		const layer = config.layers[name];
+		return Boolean(layer && ((layer.extensions?.length ?? 0) > 0 || (layer.packages?.length ?? 0) > 0));
+	});
+}
+function needsRelaunch(config, before, after) {
+	const previous = extensionLayers(config, before);
+	const candidate = extensionLayers(config, after);
+	return previous.length !== candidate.length || previous.some((name, index) => name !== candidate[index]);
+}
+//#endregion
+export { extensionLayers, needsRelaunch };
+
+//# sourceMappingURL=transitionLayers.mjs.map

package/dist/src/composition/transitionLayers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"transitionLayers.mjs","names":[],"sources":["../../../src/composition/transitionLayers.ts"],"sourcesContent":["import type { MajorModesConfig } from '@agimon-ai/po-config/majorModes';\nexport function extensionLayers(config: MajorModesConfig, names: readonly string[]): string[] {\n  return names.filter((name) => {\n    const layer = config.layers[name];\n    return Boolean(layer && ((layer.extensions?.length ?? 0) > 0 || (layer.packages?.length ?? 0) > 0));\n  });\n}\n\nexport function needsRelaunch(config: MajorModesConfig, before: readonly string[], after: readonly string[]): boolean {\n  const previous = extensionLayers(config, before);\n  const candidate = extensionLayers(config, after);\n  return previous.length !== candidate.length || previous.some((name, index) => name !== candidate[index]);\n}\n"],"mappings":";AACA,SAAgB,gBAAgB,QAA0B,OAAoC;CAC5F,OAAO,MAAM,QAAQ,SAAS;EAC5B,MAAM,QAAQ,OAAO,OAAO;EAC5B,OAAO,QAAQ,WAAW,MAAM,YAAY,UAAU,KAAK,MAAM,MAAM,UAAU,UAAU,KAAK,EAAE;CACpG,CAAC;AACH;AAEA,SAAgB,cAAc,QAA0B,QAA2B,OAAmC;CACpH,MAAM,WAAW,gBAAgB,QAAQ,MAAM;CAC/C,MAAM,YAAY,gBAAgB,QAAQ,KAAK;CAC/C,OAAO,SAAS,WAAW,UAAU,UAAU,SAAS,MAAM,MAAM,UAAU,SAAS,UAAU,MAAM;AACzG"}

package/dist/src/composition/types/harness.d.mts

@@ -0,0 +1,52 @@
+//#region src/composition/types/harness.d.ts
+export type HarnessPreset = 'default' | 'kimi';
+export type HarnessOutputFormat = 'native' | 'vibe-lint';
+export interface HarnessOptions {
+  /** The checkout the run executes in. */
+  repoRoot: string;
+  /**
+   * Where modes, domains, profiles, plugins and MCP config are read from. Set when the checkout
+   * belongs to a workspace rooted elsewhere, such as a worktree; defaults to repoRoot.
+   */
+  configRoot?: string;
+  /** Injected home root for home-scoped generated artifacts. */
+  homeDirectory?: string;
+  cwd: string;
+  /** Execution environment supplied by the caller; defaults to process.env. */
+  environment?: NodeJS.ProcessEnv;
+  /** One persona and its environment defaults from `.po/profiles.yaml`. */
+  profile?: string;
+  /** Domain names that select plugins, skills, agents, and MCP scope. */
+  domains: string[];
+  /** One named major mode from `.po/modes.yaml`. */
+  majorMode: string;
+  /** Print the resolved matrix and exit instead of launching Pi. */
+  explain: boolean;
+  /** Write the resolved MCP config into this directory and exit. */
+  emitMcp?: string;
+  /**
+   * Stage resources here instead of in a temporary directory.
+   *
+   * Set by `po sync`, whose output has to survive the process so plain Pi
+   * can load it. The caller then owns the directory and its removal.
+   */
+  resourceDirectory?: string;
+  pluginDirectories: string[];
+  additionalDirectories: string[];
+  preset: HarnessPreset;
+  /** Native Pi output or one vibe-lint script-provider response object. */
+  outputFormat: HarnessOutputFormat;
+  automation: boolean;
+  allowProtectedWrites: boolean;
+  hooks: boolean;
+  mcp: boolean;
+  agents: boolean;
+  piArgs: string[];
+}
+export interface ParsedHarnessArgs {
+  options: Omit<HarnessOptions, 'repoRoot'>;
+  help: boolean;
+  version: boolean;
+}
+//#endregion
+//# sourceMappingURL=harness.d.mts.map

package/dist/src/composition/types/harness.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness.d.mts","names":[],"sources":["../../../../src/composition/types/harness.ts"],"mappings":";YAAY;YACA;iBAEK;;EAEf;;;;;EAKA;;EAEA;EACA;;EAEA,cAAc,OAAO;;EAErB;;EAEA;;EAEA;;EAEA;;EAEA;;;;;;;EAOA;EACA;EACA;EACA,QAAQ;;EAER,cAAc;EACd;EACA;EACA;EACA;EACA;EACA;;iBAGe;EACf,SAAS,KAAK;EACd;EACA"}

package/dist/src/extensions/setupDiagnostics.cjs

@@ -0,0 +1,65 @@
+const require_index = require("../cli/commands/doctor/index.cjs");
+let _agimon_ai_po_config_harnessState = require("@agimon-ai/po-config/harnessState");
+let _agimon_ai_po_core_serverFacet = require("@agimon-ai/po-core/serverFacet");
+let _agimon_ai_po_core_help = require("@agimon-ai/po-core/help");
+let typebox = require("typebox");
+//#region src/extensions/setupDiagnostics.ts
+const DIAGNOSE_SETUP_NAME = "diagnose_setup";
+const guidance = {
+	"config.yaml": "po-author-config",
+	"modes.yaml": "po-author-major-mode",
+	"domains.yaml": "po-author-domain",
+	"profiles.yaml": "po-author-profile"
+};
+function createSetupDiagnosticsTool(readScope, authorize) {
+	return (0, _agimon_ai_po_core_serverFacet.defineTool)({
+		name: DIAGNOSE_SETUP_NAME,
+		description: "Check this session's saved configuration, installed packages, and the global web build without changing anything. Returns scoped check results and the relevant setup guidance, never configuration values or credentials.",
+		parameters: typebox.Type.Object({}, { additionalProperties: false }),
+		when: _agimon_ai_po_core_help.DOOM_HELP_WHEN,
+		executionMode: "serial",
+		async execute(_input, execution) {
+			const signal = authorize(execution.signal);
+			const scope = readScope();
+			const environment = (0, _agimon_ai_po_config_harnessState.projectHarnessEnvironment)({
+				root: scope.repoRoot,
+				majorMode: scope.selection.majorMode,
+				domains: [...scope.selection.domains],
+				profile: scope.selection.profile
+			}, { ...scope.environment });
+			const report = require_index.collectDoctorReport(environment, scope.cwd);
+			signal.throwIfAborted();
+			authorize(execution.signal);
+			const result = {
+				scope: "current-session",
+				configurationRoot: report.repoRoot,
+				appliedSelection: {
+					majorMode: scope.selection.majorMode,
+					domains: [...scope.selection.domains],
+					profile: scope.selection.profile
+				},
+				status: report.problems === 0 && report.skipped.length === 0 ? "checks-passed" : "issues-found",
+				checks: report.sections.map((section) => ({
+					area: section.label,
+					status: section.problems.length ? "failed" : "passed",
+					problemCount: section.problems.length,
+					guidance: guidance[section.label] ?? "po-use-help"
+				})),
+				skipped: report.skipped,
+				limitations: "These are saved configuration and installation checks, not a network authentication or agent health test. Error text and configuration values are omitted to protect credentials. Inspect a failed area with its package guidance before proposing a repair."
+			};
+			return {
+				content: [{
+					type: "text",
+					text: JSON.stringify(result, null, 2)
+				}],
+				details: result
+			};
+		}
+	});
+}
+//#endregion
+exports.DIAGNOSE_SETUP_NAME = DIAGNOSE_SETUP_NAME;
+exports.createSetupDiagnosticsTool = createSetupDiagnosticsTool;
+
+//# sourceMappingURL=setupDiagnostics.cjs.map

package/dist/src/extensions/setupDiagnostics.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"setupDiagnostics.cjs","names":["defineTool","Type","HELP_WHEN","projectHarnessEnvironment","collectDoctorReport"],"sources":["../../../src/extensions/setupDiagnostics.ts"],"sourcesContent":["import { projectHarnessEnvironment } from '@agimon-ai/po-config/harnessState';\nimport type { DoomHeadlessSelection } from '@agimon-ai/po-core/headless';\nimport { DOOM_HELP_WHEN as HELP_WHEN } from '@agimon-ai/po-core/help';\nimport { defineTool } from '@agimon-ai/po-core/serverFacet';\nimport { Type } from 'typebox';\n\nimport { collectDoctorReport } from '../cli/commands/doctor';\n\nexport const DIAGNOSE_SETUP_NAME = 'diagnose_setup';\nexport interface SetupDiagnosticScope {\n  repoRoot: string;\n  cwd: string;\n  environment: Readonly<Record<string, string | undefined>>;\n  selection: Pick<DoomHeadlessSelection, 'majorMode' | 'domains' | 'profile'>;\n}\n\nconst guidance: Readonly<Record<string, string>> = {\n  'config.yaml': 'po-author-config',\n  'modes.yaml': 'po-author-major-mode',\n  'domains.yaml': 'po-author-domain',\n  'profiles.yaml': 'po-author-profile',\n};\n\nexport function createSetupDiagnosticsTool(\n  readScope: () => SetupDiagnosticScope,\n  authorize: (signal?: AbortSignal) => AbortSignal,\n) {\n  return defineTool({\n    name: DIAGNOSE_SETUP_NAME,\n    description:\n      \"Check this session's saved configuration, installed packages, and the global web build without changing anything. Returns scoped check results and the relevant setup guidance, never configuration values or credentials.\",\n    parameters: Type.Object({}, { additionalProperties: false }),\n    when: HELP_WHEN,\n    executionMode: 'serial',\n    async execute(_input, execution) {\n      const signal = authorize(execution.signal);\n      const scope = readScope();\n      const environment = projectHarnessEnvironment(\n        {\n          root: scope.repoRoot,\n          majorMode: scope.selection.majorMode,\n          domains: [...scope.selection.domains],\n          profile: scope.selection.profile,\n        },\n        { ...scope.environment },\n      );\n      const report = collectDoctorReport(environment, scope.cwd);\n      signal.throwIfAborted();\n      authorize(execution.signal);\n      const result = {\n        scope: 'current-session',\n        configurationRoot: report.repoRoot,\n        appliedSelection: {\n          majorMode: scope.selection.majorMode,\n          domains: [...scope.selection.domains],\n          profile: scope.selection.profile,\n        },\n        status: report.problems === 0 && report.skipped.length === 0 ? 'checks-passed' : 'issues-found',\n        checks: report.sections.map((section) => ({\n          area: section.label,\n          status: section.problems.length ? 'failed' : 'passed',\n          problemCount: section.problems.length,\n          guidance: guidance[section.label] ?? 'po-use-help',\n        })),\n        skipped: report.skipped,\n        limitations:\n          'These are saved configuration and installation checks, not a network authentication or agent health test. Error text and configuration values are omitted to protect credentials. Inspect a failed area with its package guidance before proposing a repair.',\n      };\n      return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }], details: result };\n    },\n  });\n}\n"],"mappings":";;;;;;AAQA,MAAa,sBAAsB;AAQnC,MAAM,WAA6C;CACjD,eAAe;CACf,cAAc;CACd,gBAAgB;CAChB,iBAAiB;AACnB;AAEA,SAAgB,2BACd,WACA,WACA;CACA,QAAA,GAAOA,+BAAAA,WAAAA,CAAW;EAChB,MAAM;EACN,aACE;EACF,YAAYC,QAAAA,KAAK,OAAO,CAAC,GAAG,EAAE,sBAAsB,MAAM,CAAC;EAC3D,MAAMC,wBAAAA;EACN,eAAe;EACf,MAAM,QAAQ,QAAQ,WAAW;GAC/B,MAAM,SAAS,UAAU,UAAU,MAAM;GACzC,MAAM,QAAQ,UAAU;GACxB,MAAM,eAAA,GAAcC,kCAAAA,0BAAAA,CAClB;IACE,MAAM,MAAM;IACZ,WAAW,MAAM,UAAU;IAC3B,SAAS,CAAC,GAAG,MAAM,UAAU,OAAO;IACpC,SAAS,MAAM,UAAU;GAC3B,GACA,EAAE,GAAG,MAAM,YAAY,CACzB;GACA,MAAM,SAASC,cAAAA,oBAAoB,aAAa,MAAM,GAAG;GACzD,OAAO,eAAe;GACtB,UAAU,UAAU,MAAM;GAC1B,MAAM,SAAS;IACb,OAAO;IACP,mBAAmB,OAAO;IAC1B,kBAAkB;KAChB,WAAW,MAAM,UAAU;KAC3B,SAAS,CAAC,GAAG,MAAM,UAAU,OAAO;KACpC,SAAS,MAAM,UAAU;IAC3B;IACA,QAAQ,OAAO,aAAa,KAAK,OAAO,QAAQ,WAAW,IAAI,kBAAkB;IACjF,QAAQ,OAAO,SAAS,KAAK,aAAa;KACxC,MAAM,QAAQ;KACd,QAAQ,QAAQ,SAAS,SAAS,WAAW;KAC7C,cAAc,QAAQ,SAAS;KAC/B,UAAU,SAAS,QAAQ,UAAU;IACvC,EAAE;IACF,SAAS,OAAO;IAChB,aACE;GACJ;GACA,OAAO;IAAE,SAAS,CAAC;KAAE,MAAM;KAAQ,MAAM,KAAK,UAAU,QAAQ,MAAM,CAAC;IAAE,CAAC;IAAG,SAAS;GAAO;EAC/F;CACF,CAAC;AACH"}