@agimon-ai/po 0.0.0-alpha.0

package/dist/src/cli/commands/doctor/help.cjs

@@ -0,0 +1,19 @@
+//#region src/cli/commands/doctor/help.ts
+function doctorHelp() {
+	return `Usage: po doctor
+
+Checks the Po installation and reports what is wrong without changing
+anything. Validates .po/config.yaml and .po/modes.yaml strictly, including
+the unsupported keys po sync ignores, then reports everything
+po sync --check reports.
+
+Exits non-zero when any check fails.
+
+Options:
+  -h, --help                Show this help
+`;
+}
+//#endregion
+exports.doctorHelp = doctorHelp;
+
+//# sourceMappingURL=help.cjs.map

package/dist/src/cli/commands/doctor/help.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.cjs","names":[],"sources":["../../../../../src/cli/commands/doctor/help.ts"],"sourcesContent":["export function doctorHelp(): string {\n  return `Usage: po doctor\n\nChecks the Po installation and reports what is wrong without changing\nanything. Validates .po/config.yaml and .po/modes.yaml strictly, including\nthe unsupported keys po sync ignores, then reports everything\npo sync --check reports.\n\nExits non-zero when any check fails.\n\nOptions:\n  -h, --help                Show this help\n`;\n}\n"],"mappings":";AAAA,SAAgB,aAAqB;CACnC,OAAO;;;;;;;;;;;;AAYT"}

package/dist/src/cli/commands/doctor/help.d.mts

@@ -0,0 +1,4 @@
+//#region src/cli/commands/doctor/help.d.ts
+export declare function doctorHelp(): string;
+//#endregion
+//# sourceMappingURL=help.d.mts.map

package/dist/src/cli/commands/doctor/help.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.mts","names":[],"sources":["../../../../../src/cli/commands/doctor/help.ts"],"mappings":";wBAAgB"}

package/dist/src/cli/commands/doctor/help.mjs

@@ -0,0 +1,19 @@
+//#region src/cli/commands/doctor/help.ts
+function doctorHelp() {
+	return `Usage: po doctor
+
+Checks the Po installation and reports what is wrong without changing
+anything. Validates .po/config.yaml and .po/modes.yaml strictly, including
+the unsupported keys po sync ignores, then reports everything
+po sync --check reports.
+
+Exits non-zero when any check fails.
+
+Options:
+  -h, --help                Show this help
+`;
+}
+//#endregion
+export { doctorHelp };
+
+//# sourceMappingURL=help.mjs.map

package/dist/src/cli/commands/doctor/help.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.mjs","names":[],"sources":["../../../../../src/cli/commands/doctor/help.ts"],"sourcesContent":["export function doctorHelp(): string {\n  return `Usage: po doctor\n\nChecks the Po installation and reports what is wrong without changing\nanything. Validates .po/config.yaml and .po/modes.yaml strictly, including\nthe unsupported keys po sync ignores, then reports everything\npo sync --check reports.\n\nExits non-zero when any check fails.\n\nOptions:\n  -h, --help                Show this help\n`;\n}\n"],"mappings":";AAAA,SAAgB,aAAqB;CACnC,OAAO;;;;;;;;;;;;AAYT"}

package/dist/src/cli/commands/doctor/index.cjs

@@ -0,0 +1,118 @@
+const require_runtime = require("../../../../_virtual/_rolldown/runtime.cjs");
+const require_help = require("./help.cjs");
+const require_index = require("../../../composition/repository/index.cjs");
+const require_router = require("../../router.cjs");
+const require_index$1 = require("../sync/index.cjs");
+let node_path = require("node:path");
+node_path = require_runtime.__toESM(node_path, 1);
+let node_os = require("node:os");
+node_os = require_runtime.__toESM(node_os, 1);
+let _agimon_ai_po_config_domains = require("@agimon-ai/po-config/domains");
+let _agimon_ai_po_config_config = require("@agimon-ai/po-config/config");
+let _agimon_ai_po_config_majorModes = require("@agimon-ai/po-config/majorModes");
+let _agimon_ai_po_config_profiles = require("@agimon-ai/po-config/profiles");
+//#region src/cli/commands/doctor/index.ts
+const DOCTOR_COMMAND = "doctor";
+const HARNESS_ROOT_ENV = "PO_ROOT";
+const LABEL_WIDTH = 14;
+function formatSection(section) {
+	const label = section.label.padEnd(LABEL_WIDTH);
+	if (section.problems.length === 0) return `${label}ok\n`;
+	return `${label}${section.problems.length === 1 ? "FAILED" : `${String(section.problems.length)} problem(s)`}\n${section.problems.map((problem) => `  ${problem}\n`).join("")}`;
+}
+function messageOf(error) {
+	return error instanceof Error ? error.message : String(error);
+}
+/** Runs one check, turning the throw a strict parser uses into a reported problem. */
+function check(run) {
+	try {
+		run();
+		return [];
+	} catch (error) {
+		return [messageOf(error)];
+	}
+}
+/**
+* Reports what is wrong with a Po installation without changing anything.
+*
+* The strict counterpart to `po sync`, which tolerates unknown config keys
+* so a build cannot break over one. Everything `sync --check` reports is
+* reported here too, so this is the one command to run when something is off.
+*/
+function runDoctor(args, environment = process.env, currentDirectory = process.cwd(), output = process.stdout) {
+	if (require_router.wantsHelp(args.slice(1))) {
+		output.write(require_help.doctorHelp());
+		return 0;
+	}
+	const { sections, problems } = collectDoctorReport(environment, currentDirectory);
+	for (const section of sections) output.write(formatSection(section));
+	if (problems === 0) {
+		output.write("\nno problems found\n");
+		return 0;
+	}
+	output.write(`\n${String(problems)} problem(s) found\n`);
+	return 1;
+}
+/** The CLI and session diagnostic tool run the same read-only checks. */
+function collectDoctorReport(environment, currentDirectory) {
+	const homeDirectory = environment.HOME ?? node_os.default.homedir();
+	const inheritedRoot = environment[HARNESS_ROOT_ENV];
+	const repoRoot = inheritedRoot ? node_path.default.resolve(inheritedRoot) : require_index.resolveDoomConfigurationRoot(currentDirectory, homeDirectory);
+	const sections = [
+		{
+			label: "config.yaml",
+			problems: check(() => (0, _agimon_ai_po_config_config.loadDoomConfig)(repoRoot, homeDirectory))
+		},
+		{
+			label: "modes.yaml",
+			problems: check(() => (0, _agimon_ai_po_config_majorModes.loadMajorModesConfig)(repoRoot, homeDirectory))
+		},
+		{
+			label: "domains.yaml",
+			problems: check(() => (0, _agimon_ai_po_config_domains.loadDomains)(repoRoot, homeDirectory))
+		},
+		{
+			label: "profiles.yaml",
+			problems: check(() => (0, _agimon_ai_po_config_profiles.loadProfiles)(repoRoot, homeDirectory))
+		}
+	];
+	const skipped = sections.some((section) => section.problems.length > 0) ? ["packages", "web build"] : [];
+	if (skipped.length === 0) try {
+		const readiness = require_index$1.syncReadiness(repoRoot, homeDirectory, environment);
+		sections.push({
+			label: "packages",
+			problems: readiness.packages
+		}, {
+			label: "web build",
+			problems: readiness.web
+		});
+	} catch (error) {
+		sections.push({
+			label: "installation",
+			problems: [messageOf(error)]
+		});
+	}
+	return {
+		repoRoot,
+		homeDirectory,
+		sections,
+		skipped,
+		problems: sections.reduce((total, section) => total + section.problems.length, 0)
+	};
+}
+/** Compatibility API. Executables call the command function directly. */
+var DoctorCommand = class {
+	name = DOCTOR_COMMAND;
+	matches(args) {
+		return args[0] === this.name;
+	}
+	execute(args, environment = process.env, currentDirectory = process.cwd(), output = process.stdout) {
+		return runDoctor(args, environment, currentDirectory, output);
+	}
+};
+//#endregion
+exports.DoctorCommand = DoctorCommand;
+exports.collectDoctorReport = collectDoctorReport;
+exports.runDoctor = runDoctor;
+
+//# sourceMappingURL=index.cjs.map

package/dist/src/cli/commands/doctor/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["wantsHelp","doctorHelp","os","path","resolveDoomConfigurationRoot","loadDoomConfig","loadMajorModesConfig","loadDomains","loadProfiles","syncReadiness"],"sources":["../../../../../src/cli/commands/doctor/index.ts"],"sourcesContent":["import os from 'node:os';\nimport path from 'node:path';\n\nimport { loadDoomConfig } from '@agimon-ai/po-config/config';\nimport { loadDomains } from '@agimon-ai/po-config/domains';\nimport { loadMajorModesConfig } from '@agimon-ai/po-config/majorModes';\nimport { loadProfiles } from '@agimon-ai/po-config/profiles';\n\nimport { resolveDoomConfigurationRoot } from '../../../composition/repository';\nimport { wantsHelp } from '../../router';\nimport { syncReadiness } from '../sync';\nimport { doctorHelp } from './help';\n\nconst DOCTOR_COMMAND = 'doctor';\nconst HARNESS_ROOT_ENV = 'PO_ROOT';\nconst LABEL_WIDTH = 14;\n\nexport interface DoctorOutput {\n  write(chunk: string): void;\n}\n\n/** One checked area and what it found. Empty problems means the section passed. */\ninterface Section {\n  label: string;\n  problems: string[];\n}\n\nfunction formatSection(section: Section): string {\n  const label = section.label.padEnd(LABEL_WIDTH);\n  if (section.problems.length === 0) return `${label}ok\\n`;\n  return `${label}${section.problems.length === 1 ? 'FAILED' : `${String(section.problems.length)} problem(s)`}\\n${section.problems\n    .map((problem) => `  ${problem}\\n`)\n    .join('')}`;\n}\n\nfunction messageOf(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\n/** Runs one check, turning the throw a strict parser uses into a reported problem. */\nfunction check(run: () => void): string[] {\n  try {\n    run();\n    return [];\n  } catch (error) {\n    return [messageOf(error)];\n  }\n}\n\n/**\n * Reports what is wrong with a Po installation without changing anything.\n *\n * The strict counterpart to `po sync`, which tolerates unknown config keys\n * so a build cannot break over one. Everything `sync --check` reports is\n * reported here too, so this is the one command to run when something is off.\n */\nexport function runDoctor(\n  args: string[],\n  environment: NodeJS.ProcessEnv = process.env,\n  currentDirectory = process.cwd(),\n  output: DoctorOutput = process.stdout,\n): number {\n  if (wantsHelp(args.slice(1))) {\n    output.write(doctorHelp());\n    return 0;\n  }\n  const { sections, problems } = collectDoctorReport(environment, currentDirectory);\n  for (const section of sections) output.write(formatSection(section));\n  if (problems === 0) {\n    output.write('\\nno problems found\\n');\n    return 0;\n  }\n  output.write(`\\n${String(problems)} problem(s) found\\n`);\n  return 1;\n}\n\n/** The CLI and session diagnostic tool run the same read-only checks. */\nexport function collectDoctorReport(environment: NodeJS.ProcessEnv, currentDirectory: string) {\n  const homeDirectory = environment.HOME ?? os.homedir();\n  const inheritedRoot = environment[HARNESS_ROOT_ENV];\n  const repoRoot = inheritedRoot\n    ? path.resolve(inheritedRoot)\n    : resolveDoomConfigurationRoot(currentDirectory, homeDirectory);\n  const sections: Section[] = [\n    { label: 'config.yaml', problems: check(() => loadDoomConfig(repoRoot, homeDirectory)) },\n    { label: 'modes.yaml', problems: check(() => loadMajorModesConfig(repoRoot, homeDirectory)) },\n    { label: 'domains.yaml', problems: check(() => loadDomains(repoRoot, homeDirectory)) },\n    { label: 'profiles.yaml', problems: check(() => loadProfiles(repoRoot, homeDirectory)) },\n  ];\n  const skipped = sections.some((section) => section.problems.length > 0) ? ['packages', 'web build'] : [];\n  if (skipped.length === 0) {\n    try {\n      const readiness = syncReadiness(repoRoot, homeDirectory, environment);\n      sections.push(\n        { label: 'packages', problems: readiness.packages },\n        { label: 'web build', problems: readiness.web },\n      );\n    } catch (error) {\n      sections.push({ label: 'installation', problems: [messageOf(error)] });\n    }\n  }\n  return {\n    repoRoot,\n    homeDirectory,\n    sections,\n    skipped,\n    problems: sections.reduce((total, section) => total + section.problems.length, 0),\n  };\n}\n/** Compatibility API. Executables call the command function directly. */\nexport class DoctorCommand {\n  readonly name = DOCTOR_COMMAND;\n\n  matches(args: string[]): boolean {\n    return args[0] === this.name;\n  }\n\n  execute(\n    args: string[],\n    environment: NodeJS.ProcessEnv = process.env,\n    currentDirectory = process.cwd(),\n    output: DoctorOutput = process.stdout,\n  ): number {\n    return runDoctor(args, environment, currentDirectory, output);\n  }\n}\n"],"mappings":"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"}

package/dist/src/cli/commands/doctor/index.d.mts

@@ -0,0 +1,33 @@
+//#region src/cli/commands/doctor/index.d.ts
+export interface DoctorOutput {
+  write(chunk: string): void;
+}
+/** One checked area and what it found. Empty problems means the section passed. */
+interface Section {
+  label: string;
+  problems: string[];
+}
+/**
+ * Reports what is wrong with a Po installation without changing anything.
+ *
+ * The strict counterpart to `po sync`, which tolerates unknown config keys
+ * so a build cannot break over one. Everything `sync --check` reports is
+ * reported here too, so this is the one command to run when something is off.
+ */
+export declare function runDoctor(args: string[], environment?: NodeJS.ProcessEnv, currentDirectory?: string, output?: DoctorOutput): number;
+/** The CLI and session diagnostic tool run the same read-only checks. */
+export declare function collectDoctorReport(environment: NodeJS.ProcessEnv, currentDirectory: string): {
+  repoRoot: string;
+  homeDirectory: string;
+  sections: Section[];
+  skipped: string[];
+  problems: number;
+};
+/** Compatibility API. Executables call the command function directly. */
+export declare class DoctorCommand {
+  readonly name = "doctor";
+  matches(args: string[]): boolean;
+  execute(args: string[], environment?: NodeJS.ProcessEnv, currentDirectory?: string, output?: DoctorOutput): number;
+}
+//#endregion
+//# sourceMappingURL=index.d.mts.map

package/dist/src/cli/commands/doctor/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../../../src/cli/commands/doctor/index.ts"],"mappings":";iBAiBiB;EACf,MAAM;;;UAIE;EACR;EACA;;;;;;;;;wBAgCc,UACd,gBACA,cAAa,OAAO,YACpB,2BACA,SAAQ;;wBAiBM,oBAAoB,aAAa,OAAO,YAAY;;;;;;;;qBAiCvD;WACF;EAET,QAAQ;EAIR,QACE,gBACA,cAAa,OAAO,YACpB,2BACA,SAAQ"}

package/dist/src/cli/commands/doctor/index.mjs

@@ -0,0 +1,113 @@
+import { doctorHelp } from "./help.mjs";
+import { resolveDoomConfigurationRoot } from "../../../composition/repository/index.mjs";
+import { wantsHelp } from "../../router.mjs";
+import { syncReadiness } from "../sync/index.mjs";
+import path from "node:path";
+import os from "node:os";
+import { loadDomains } from "@agimon-ai/po-config/domains";
+import { loadDoomConfig } from "@agimon-ai/po-config/config";
+import { loadMajorModesConfig } from "@agimon-ai/po-config/majorModes";
+import { loadProfiles } from "@agimon-ai/po-config/profiles";
+//#region src/cli/commands/doctor/index.ts
+const DOCTOR_COMMAND = "doctor";
+const HARNESS_ROOT_ENV = "PO_ROOT";
+const LABEL_WIDTH = 14;
+function formatSection(section) {
+	const label = section.label.padEnd(LABEL_WIDTH);
+	if (section.problems.length === 0) return `${label}ok\n`;
+	return `${label}${section.problems.length === 1 ? "FAILED" : `${String(section.problems.length)} problem(s)`}\n${section.problems.map((problem) => `  ${problem}\n`).join("")}`;
+}
+function messageOf(error) {
+	return error instanceof Error ? error.message : String(error);
+}
+/** Runs one check, turning the throw a strict parser uses into a reported problem. */
+function check(run) {
+	try {
+		run();
+		return [];
+	} catch (error) {
+		return [messageOf(error)];
+	}
+}
+/**
+* Reports what is wrong with a Po installation without changing anything.
+*
+* The strict counterpart to `po sync`, which tolerates unknown config keys
+* so a build cannot break over one. Everything `sync --check` reports is
+* reported here too, so this is the one command to run when something is off.
+*/
+function runDoctor(args, environment = process.env, currentDirectory = process.cwd(), output = process.stdout) {
+	if (wantsHelp(args.slice(1))) {
+		output.write(doctorHelp());
+		return 0;
+	}
+	const { sections, problems } = collectDoctorReport(environment, currentDirectory);
+	for (const section of sections) output.write(formatSection(section));
+	if (problems === 0) {
+		output.write("\nno problems found\n");
+		return 0;
+	}
+	output.write(`\n${String(problems)} problem(s) found\n`);
+	return 1;
+}
+/** The CLI and session diagnostic tool run the same read-only checks. */
+function collectDoctorReport(environment, currentDirectory) {
+	const homeDirectory = environment.HOME ?? os.homedir();
+	const inheritedRoot = environment[HARNESS_ROOT_ENV];
+	const repoRoot = inheritedRoot ? path.resolve(inheritedRoot) : resolveDoomConfigurationRoot(currentDirectory, homeDirectory);
+	const sections = [
+		{
+			label: "config.yaml",
+			problems: check(() => loadDoomConfig(repoRoot, homeDirectory))
+		},
+		{
+			label: "modes.yaml",
+			problems: check(() => loadMajorModesConfig(repoRoot, homeDirectory))
+		},
+		{
+			label: "domains.yaml",
+			problems: check(() => loadDomains(repoRoot, homeDirectory))
+		},
+		{
+			label: "profiles.yaml",
+			problems: check(() => loadProfiles(repoRoot, homeDirectory))
+		}
+	];
+	const skipped = sections.some((section) => section.problems.length > 0) ? ["packages", "web build"] : [];
+	if (skipped.length === 0) try {
+		const readiness = syncReadiness(repoRoot, homeDirectory, environment);
+		sections.push({
+			label: "packages",
+			problems: readiness.packages
+		}, {
+			label: "web build",
+			problems: readiness.web
+		});
+	} catch (error) {
+		sections.push({
+			label: "installation",
+			problems: [messageOf(error)]
+		});
+	}
+	return {
+		repoRoot,
+		homeDirectory,
+		sections,
+		skipped,
+		problems: sections.reduce((total, section) => total + section.problems.length, 0)
+	};
+}
+/** Compatibility API. Executables call the command function directly. */
+var DoctorCommand = class {
+	name = DOCTOR_COMMAND;
+	matches(args) {
+		return args[0] === this.name;
+	}
+	execute(args, environment = process.env, currentDirectory = process.cwd(), output = process.stdout) {
+		return runDoctor(args, environment, currentDirectory, output);
+	}
+};
+//#endregion
+export { DoctorCommand, collectDoctorReport, runDoctor };
+
+//# sourceMappingURL=index.mjs.map

package/dist/src/cli/commands/doctor/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../../src/cli/commands/doctor/index.ts"],"sourcesContent":["import os from 'node:os';\nimport path from 'node:path';\n\nimport { loadDoomConfig } from '@agimon-ai/po-config/config';\nimport { loadDomains } from '@agimon-ai/po-config/domains';\nimport { loadMajorModesConfig } from '@agimon-ai/po-config/majorModes';\nimport { loadProfiles } from '@agimon-ai/po-config/profiles';\n\nimport { resolveDoomConfigurationRoot } from '../../../composition/repository';\nimport { wantsHelp } from '../../router';\nimport { syncReadiness } from '../sync';\nimport { doctorHelp } from './help';\n\nconst DOCTOR_COMMAND = 'doctor';\nconst HARNESS_ROOT_ENV = 'PO_ROOT';\nconst LABEL_WIDTH = 14;\n\nexport interface DoctorOutput {\n  write(chunk: string): void;\n}\n\n/** One checked area and what it found. Empty problems means the section passed. */\ninterface Section {\n  label: string;\n  problems: string[];\n}\n\nfunction formatSection(section: Section): string {\n  const label = section.label.padEnd(LABEL_WIDTH);\n  if (section.problems.length === 0) return `${label}ok\\n`;\n  return `${label}${section.problems.length === 1 ? 'FAILED' : `${String(section.problems.length)} problem(s)`}\\n${section.problems\n    .map((problem) => `  ${problem}\\n`)\n    .join('')}`;\n}\n\nfunction messageOf(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\n/** Runs one check, turning the throw a strict parser uses into a reported problem. */\nfunction check(run: () => void): string[] {\n  try {\n    run();\n    return [];\n  } catch (error) {\n    return [messageOf(error)];\n  }\n}\n\n/**\n * Reports what is wrong with a Po installation without changing anything.\n *\n * The strict counterpart to `po sync`, which tolerates unknown config keys\n * so a build cannot break over one. Everything `sync --check` reports is\n * reported here too, so this is the one command to run when something is off.\n */\nexport function runDoctor(\n  args: string[],\n  environment: NodeJS.ProcessEnv = process.env,\n  currentDirectory = process.cwd(),\n  output: DoctorOutput = process.stdout,\n): number {\n  if (wantsHelp(args.slice(1))) {\n    output.write(doctorHelp());\n    return 0;\n  }\n  const { sections, problems } = collectDoctorReport(environment, currentDirectory);\n  for (const section of sections) output.write(formatSection(section));\n  if (problems === 0) {\n    output.write('\\nno problems found\\n');\n    return 0;\n  }\n  output.write(`\\n${String(problems)} problem(s) found\\n`);\n  return 1;\n}\n\n/** The CLI and session diagnostic tool run the same read-only checks. */\nexport function collectDoctorReport(environment: NodeJS.ProcessEnv, currentDirectory: string) {\n  const homeDirectory = environment.HOME ?? os.homedir();\n  const inheritedRoot = environment[HARNESS_ROOT_ENV];\n  const repoRoot = inheritedRoot\n    ? path.resolve(inheritedRoot)\n    : resolveDoomConfigurationRoot(currentDirectory, homeDirectory);\n  const sections: Section[] = [\n    { label: 'config.yaml', problems: check(() => loadDoomConfig(repoRoot, homeDirectory)) },\n    { label: 'modes.yaml', problems: check(() => loadMajorModesConfig(repoRoot, homeDirectory)) },\n    { label: 'domains.yaml', problems: check(() => loadDomains(repoRoot, homeDirectory)) },\n    { label: 'profiles.yaml', problems: check(() => loadProfiles(repoRoot, homeDirectory)) },\n  ];\n  const skipped = sections.some((section) => section.problems.length > 0) ? ['packages', 'web build'] : [];\n  if (skipped.length === 0) {\n    try {\n      const readiness = syncReadiness(repoRoot, homeDirectory, environment);\n      sections.push(\n        { label: 'packages', problems: readiness.packages },\n        { label: 'web build', problems: readiness.web },\n      );\n    } catch (error) {\n      sections.push({ label: 'installation', problems: [messageOf(error)] });\n    }\n  }\n  return {\n    repoRoot,\n    homeDirectory,\n    sections,\n    skipped,\n    problems: sections.reduce((total, section) => total + section.problems.length, 0),\n  };\n}\n/** Compatibility API. Executables call the command function directly. */\nexport class DoctorCommand {\n  readonly name = DOCTOR_COMMAND;\n\n  matches(args: string[]): boolean {\n    return args[0] === this.name;\n  }\n\n  execute(\n    args: string[],\n    environment: NodeJS.ProcessEnv = process.env,\n    currentDirectory = process.cwd(),\n    output: DoctorOutput = process.stdout,\n  ): number {\n    return runDoctor(args, environment, currentDirectory, output);\n  }\n}\n"],"mappings":";;;;;;;;;;;AAaA,MAAM,iBAAiB;AACvB,MAAM,mBAAmB;AACzB,MAAM,cAAc;AAYpB,SAAS,cAAc,SAA0B;CAC/C,MAAM,QAAQ,QAAQ,MAAM,OAAO,WAAW;CAC9C,IAAI,QAAQ,SAAS,WAAW,GAAG,OAAO,GAAG,MAAM;CACnD,OAAO,GAAG,QAAQ,QAAQ,SAAS,WAAW,IAAI,WAAW,GAAG,OAAO,QAAQ,SAAS,MAAM,EAAE,aAAa,IAAI,QAAQ,SACtH,KAAK,YAAY,KAAK,QAAQ,GAAG,CAAC,CAClC,KAAK,EAAE;AACZ;AAEA,SAAS,UAAU,OAAwB;CACzC,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAC9D;;AAGA,SAAS,MAAM,KAA2B;CACxC,IAAI;EACF,IAAI;EACJ,OAAO,CAAC;CACV,SAAS,OAAO;EACd,OAAO,CAAC,UAAU,KAAK,CAAC;CAC1B;AACF;;;;;;;;AASA,SAAgB,UACd,MACA,cAAiC,QAAQ,KACzC,mBAAmB,QAAQ,IAAI,GAC/B,SAAuB,QAAQ,QACvB;CACR,IAAI,UAAU,KAAK,MAAM,CAAC,CAAC,GAAG;EAC5B,OAAO,MAAM,WAAW,CAAC;EACzB,OAAO;CACT;CACA,MAAM,EAAE,UAAU,aAAa,oBAAoB,aAAa,gBAAgB;CAChF,KAAK,MAAM,WAAW,UAAU,OAAO,MAAM,cAAc,OAAO,CAAC;CACnE,IAAI,aAAa,GAAG;EAClB,OAAO,MAAM,uBAAuB;EACpC,OAAO;CACT;CACA,OAAO,MAAM,KAAK,OAAO,QAAQ,EAAE,oBAAoB;CACvD,OAAO;AACT;;AAGA,SAAgB,oBAAoB,aAAgC,kBAA0B;CAC5F,MAAM,gBAAgB,YAAY,QAAQ,GAAG,QAAQ;CACrD,MAAM,gBAAgB,YAAY;CAClC,MAAM,WAAW,gBACb,KAAK,QAAQ,aAAa,IAC1B,6BAA6B,kBAAkB,aAAa;CAChE,MAAM,WAAsB;EAC1B;GAAE,OAAO;GAAe,UAAU,YAAY,eAAe,UAAU,aAAa,CAAC;EAAE;EACvF;GAAE,OAAO;GAAc,UAAU,YAAY,qBAAqB,UAAU,aAAa,CAAC;EAAE;EAC5F;GAAE,OAAO;GAAgB,UAAU,YAAY,YAAY,UAAU,aAAa,CAAC;EAAE;EACrF;GAAE,OAAO;GAAiB,UAAU,YAAY,aAAa,UAAU,aAAa,CAAC;EAAE;CACzF;CACA,MAAM,UAAU,SAAS,MAAM,YAAY,QAAQ,SAAS,SAAS,CAAC,IAAI,CAAC,YAAY,WAAW,IAAI,CAAC;CACvG,IAAI,QAAQ,WAAW,GACrB,IAAI;EACF,MAAM,YAAY,cAAc,UAAU,eAAe,WAAW;EACpE,SAAS,KACP;GAAE,OAAO;GAAY,UAAU,UAAU;EAAS,GAClD;GAAE,OAAO;GAAa,UAAU,UAAU;EAAI,CAChD;CACF,SAAS,OAAO;EACd,SAAS,KAAK;GAAE,OAAO;GAAgB,UAAU,CAAC,UAAU,KAAK,CAAC;EAAE,CAAC;CACvE;CAEF,OAAO;EACL;EACA;EACA;EACA;EACA,UAAU,SAAS,QAAQ,OAAO,YAAY,QAAQ,QAAQ,SAAS,QAAQ,CAAC;CAClF;AACF;;AAEA,IAAa,gBAAb,MAA2B;CACzB,OAAgB;CAEhB,QAAQ,MAAyB;EAC/B,OAAO,KAAK,OAAO,KAAK;CAC1B;CAEA,QACE,MACA,cAAiC,QAAQ,KACzC,mBAAmB,QAAQ,IAAI,GAC/B,SAAuB,QAAQ,QACvB;EACR,OAAO,UAAU,MAAM,aAAa,kBAAkB,MAAM;CAC9D;AACF"}

package/dist/src/cli/commands/emit-mcp/index.cjs

@@ -0,0 +1,32 @@
+const require_baseCommand = require("../baseCommand.cjs");
+let _agimon_ai_po_domain_mcp = require("@agimon-ai/po-domain/mcp");
+//#region src/cli/commands/emit-mcp/index.ts
+/**
+* Writes the resolved MCP config to a directory and exits.
+*
+* Lets claude.sh and codex.sh reuse the same domain-scoped MCP surface instead
+* of reimplementing the filter in shell.
+*/
+async function runEmitMcp(context) {
+	const { options, resources } = context;
+	if (!options.emitMcp) throw new Error("--emit-mcp requires a target directory");
+	if (!resources.mcpConfigPath) throw new Error("--emit-mcp requires MCP to be enabled");
+	const emitted = await (0, _agimon_ai_po_domain_mcp.persistMcpConfig)(resources.mcpConfigPath, resources.temporaryDirectory, options.emitMcp);
+	process.stdout.write(`${emitted}\n`);
+	return 0;
+}
+/** Compatibility API. Executables call the command function directly. */
+var EmitMcpCommand = class extends require_baseCommand.BaseCommand {
+	name = "emit-mcp";
+	matches(options) {
+		return Boolean(options.emitMcp);
+	}
+	async execute(context) {
+		return runEmitMcp(context);
+	}
+};
+//#endregion
+exports.EmitMcpCommand = EmitMcpCommand;
+exports.runEmitMcp = runEmitMcp;
+
+//# sourceMappingURL=index.cjs.map

package/dist/src/cli/commands/emit-mcp/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["persistMcpConfig","BaseCommand"],"sources":["../../../../../src/cli/commands/emit-mcp/index.ts"],"sourcesContent":["import { persistMcpConfig } from '@agimon-ai/po-domain/mcp';\n\nimport type { HarnessContext } from '../../../builders/cli/harnessContext';\nimport type { HarnessOptions } from '../../../composition/types/harness';\nimport { BaseCommand } from '../baseCommand';\n\n/**\n * Writes the resolved MCP config to a directory and exits.\n *\n * Lets claude.sh and codex.sh reuse the same domain-scoped MCP surface instead\n * of reimplementing the filter in shell.\n */\nexport async function runEmitMcp(context: HarnessContext): Promise<number> {\n  const { options, resources } = context;\n  if (!options.emitMcp) throw new Error('--emit-mcp requires a target directory');\n  if (!resources.mcpConfigPath) throw new Error('--emit-mcp requires MCP to be enabled');\n\n  const emitted = await persistMcpConfig(resources.mcpConfigPath, resources.temporaryDirectory, options.emitMcp);\n  process.stdout.write(`${emitted}\\n`);\n  return 0;\n}\n\n/** Compatibility API. Executables call the command function directly. */\nexport class EmitMcpCommand extends BaseCommand {\n  readonly name = 'emit-mcp';\n\n  matches(options: HarnessOptions): boolean {\n    return Boolean(options.emitMcp);\n  }\n\n  async execute(context: HarnessContext): Promise<number> {\n    return runEmitMcp(context);\n  }\n}\n"],"mappings":";;;;;;;;;AAYA,eAAsB,WAAW,SAA0C;CACzE,MAAM,EAAE,SAAS,cAAc;CAC/B,IAAI,CAAC,QAAQ,SAAS,MAAM,IAAI,MAAM,wCAAwC;CAC9E,IAAI,CAAC,UAAU,eAAe,MAAM,IAAI,MAAM,uCAAuC;CAErF,MAAM,UAAU,OAAA,GAAMA,yBAAAA,iBAAAA,CAAiB,UAAU,eAAe,UAAU,oBAAoB,QAAQ,OAAO;CAC7G,QAAQ,OAAO,MAAM,GAAG,QAAQ,GAAG;CACnC,OAAO;AACT;;AAGA,IAAa,iBAAb,cAAoCC,oBAAAA,YAAY;CAC9C,OAAgB;CAEhB,QAAQ,SAAkC;EACxC,OAAO,QAAQ,QAAQ,OAAO;CAChC;CAEA,MAAM,QAAQ,SAA0C;EACtD,OAAO,WAAW,OAAO;CAC3B;AACF"}

package/dist/src/cli/commands/emit-mcp/index.d.mts

@@ -0,0 +1,19 @@
+import { HarnessOptions } from "../../../composition/types/harness.mjs";
+import { HarnessContext } from "../../../builders/cli/harnessContext.mjs";
+import { BaseCommand } from "../baseCommand.mjs";
+//#region src/cli/commands/emit-mcp/index.d.ts
+/**
+ * Writes the resolved MCP config to a directory and exits.
+ *
+ * Lets claude.sh and codex.sh reuse the same domain-scoped MCP surface instead
+ * of reimplementing the filter in shell.
+ */
+export declare function runEmitMcp(context: HarnessContext): Promise<number>;
+/** Compatibility API. Executables call the command function directly. */
+export declare class EmitMcpCommand extends BaseCommand {
+  readonly name = "emit-mcp";
+  matches(options: HarnessOptions): boolean;
+  execute(context: HarnessContext): Promise<number>;
+}
+//#endregion
+//# sourceMappingURL=index.d.mts.map

package/dist/src/cli/commands/emit-mcp/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../../../src/cli/commands/emit-mcp/index.ts"],"mappings":";;;;;;;;;;wBAYsB,WAAW,SAAS,iBAAiB;;qBAW9C,uBAAuB;WACzB;EAET,QAAQ,SAAS;EAIX,QAAQ,SAAS,iBAAiB"}

package/dist/src/cli/commands/emit-mcp/index.mjs

@@ -0,0 +1,31 @@
+import { BaseCommand } from "../baseCommand.mjs";
+import { persistMcpConfig } from "@agimon-ai/po-domain/mcp";
+//#region src/cli/commands/emit-mcp/index.ts
+/**
+* Writes the resolved MCP config to a directory and exits.
+*
+* Lets claude.sh and codex.sh reuse the same domain-scoped MCP surface instead
+* of reimplementing the filter in shell.
+*/
+async function runEmitMcp(context) {
+	const { options, resources } = context;
+	if (!options.emitMcp) throw new Error("--emit-mcp requires a target directory");
+	if (!resources.mcpConfigPath) throw new Error("--emit-mcp requires MCP to be enabled");
+	const emitted = await persistMcpConfig(resources.mcpConfigPath, resources.temporaryDirectory, options.emitMcp);
+	process.stdout.write(`${emitted}\n`);
+	return 0;
+}
+/** Compatibility API. Executables call the command function directly. */
+var EmitMcpCommand = class extends BaseCommand {
+	name = "emit-mcp";
+	matches(options) {
+		return Boolean(options.emitMcp);
+	}
+	async execute(context) {
+		return runEmitMcp(context);
+	}
+};
+//#endregion
+export { EmitMcpCommand, runEmitMcp };
+
+//# sourceMappingURL=index.mjs.map

package/dist/src/cli/commands/emit-mcp/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../../src/cli/commands/emit-mcp/index.ts"],"sourcesContent":["import { persistMcpConfig } from '@agimon-ai/po-domain/mcp';\n\nimport type { HarnessContext } from '../../../builders/cli/harnessContext';\nimport type { HarnessOptions } from '../../../composition/types/harness';\nimport { BaseCommand } from '../baseCommand';\n\n/**\n * Writes the resolved MCP config to a directory and exits.\n *\n * Lets claude.sh and codex.sh reuse the same domain-scoped MCP surface instead\n * of reimplementing the filter in shell.\n */\nexport async function runEmitMcp(context: HarnessContext): Promise<number> {\n  const { options, resources } = context;\n  if (!options.emitMcp) throw new Error('--emit-mcp requires a target directory');\n  if (!resources.mcpConfigPath) throw new Error('--emit-mcp requires MCP to be enabled');\n\n  const emitted = await persistMcpConfig(resources.mcpConfigPath, resources.temporaryDirectory, options.emitMcp);\n  process.stdout.write(`${emitted}\\n`);\n  return 0;\n}\n\n/** Compatibility API. Executables call the command function directly. */\nexport class EmitMcpCommand extends BaseCommand {\n  readonly name = 'emit-mcp';\n\n  matches(options: HarnessOptions): boolean {\n    return Boolean(options.emitMcp);\n  }\n\n  async execute(context: HarnessContext): Promise<number> {\n    return runEmitMcp(context);\n  }\n}\n"],"mappings":";;;;;;;;;AAYA,eAAsB,WAAW,SAA0C;CACzE,MAAM,EAAE,SAAS,cAAc;CAC/B,IAAI,CAAC,QAAQ,SAAS,MAAM,IAAI,MAAM,wCAAwC;CAC9E,IAAI,CAAC,UAAU,eAAe,MAAM,IAAI,MAAM,uCAAuC;CAErF,MAAM,UAAU,MAAM,iBAAiB,UAAU,eAAe,UAAU,oBAAoB,QAAQ,OAAO;CAC7G,QAAQ,OAAO,MAAM,GAAG,QAAQ,GAAG;CACnC,OAAO;AACT;;AAGA,IAAa,iBAAb,cAAoC,YAAY;CAC9C,OAAgB;CAEhB,QAAQ,SAAkC;EACxC,OAAO,QAAQ,QAAQ,OAAO;CAChC;CAEA,MAAM,QAAQ,SAA0C;EACtD,OAAO,WAAW,OAAO;CAC3B;AACF"}

package/dist/src/cli/commands/explain/index.cjs

@@ -0,0 +1,155 @@
+const require_runtime = require("../../../../_virtual/_rolldown/runtime.cjs");
+const require_baseCommand = require("../baseCommand.cjs");
+let node_fs = require("node:fs");
+node_fs = require_runtime.__toESM(node_fs, 1);
+let node_path = require("node:path");
+node_path = require_runtime.__toESM(node_path, 1);
+let _agimon_ai_po_config = require("@agimon-ai/po-config");
+let _agimon_ai_po_core_mcpSchemaCost = require("@agimon-ai/po-core/mcpSchemaCost");
+let _agimon_ai_po_skill_catalog = require("@agimon-ai/po-skill/catalog");
+//#region src/cli/commands/explain/index.ts
+function readMcpServers(configPath) {
+	return JSON.parse(node_fs.default.readFileSync(configPath, "utf8")).mcpServers ?? {};
+}
+/**
+* Renders the resolved matrix for --explain. Composition spans three config
+* files, so this answers "why is that loaded" in one command instead of a
+* manual trace through domains, major modes, and plugin subsets.
+*/
+function explainMatrix(explanation) {
+	const section = (label, values, empty = "(none)") => `${label}:\n${values.length === 0 ? `  ${empty}` : values.map((value) => `  ${value}`).join("\n")}\n`;
+	return [
+		`po resolved matrix\n\n`,
+		`major mode: ${explanation.majorMode}\n\n`,
+		section("profile", explanation.profile ? [explanation.profile] : [], "(none)"),
+		"\n",
+		section("persona", explanation.persona ? [explanation.persona] : [], "(none)"),
+		"\n",
+		section("domains (content)", explanation.domains),
+		"\n",
+		section("layers (behavior, from the major mode)", explanation.layers, "core only"),
+		"\n",
+		section("hook groups from layers", explanation.hookGroups, explanation.hooksEnabled ? "(core groups only)" : "(hooks disabled)"),
+		"\n",
+		section("plugins", explanation.plugins.map((directory) => node_path.default.basename(directory))),
+		"\n",
+		section("skill paths", explanation.skillDirectories.map((directory) => node_path.default.relative(process.cwd(), directory))),
+		"\n",
+		section(explanation.mcpFiltered ? "mcp servers (filtered by domain allowlist)" : "mcp servers (unfiltered)", explanation.mcpServers, "(mcp disabled)"),
+		"\n",
+		explanation.mcpProxyUpstreams ? section("mcp proxy upstreams (filtered)", explanation.mcpProxyUpstreams) : "mcp proxy upstreams:\n  (unfiltered, every upstream in mcp-config.yaml)\n",
+		"\n",
+		`skills: ${explanation.skillCount} (from ${explanation.skillDirectories.length} paths)\n`,
+		`agents: ${explanation.agentCount}\n`,
+		`mcp config: ${explanation.mcpConfigPath ?? "(disabled)"}\n`,
+		explanation.cost ? renderCost(explanation.cost) : ""
+	].join("");
+}
+const TOKEN_COLUMN = 9;
+function tokenLine(label, tokens, note = "") {
+	const row = `  ${label.padEnd(16)}${tokens.toLocaleString("en-US").padStart(TOKEN_COLUMN)}`;
+	return `${note ? `${row}  ${note}` : row}\n`;
+}
+/**
+* The bill, rendered last so the sections above keep their order.
+*
+* Skill and persona figures are derived from files on disk and MCP figures
+* from a cached handshake, so two runs of the same selection print the same
+* numbers and a reader can reproduce them without trusting this output.
+*/
+function renderCost(cost) {
+	const startup = cost.skillPromptTokens + cost.personaTokens + cost.mcpToolTokens;
+	const unpriced = cost.mcpServers.filter((server) => server.unavailable);
+	return [
+		"\ncontext cost (tokens)\n",
+		tokenLine("skills prompt", cost.skillPromptTokens, "always on"),
+		tokenLine("persona", cost.personaTokens, "always on"),
+		tokenLine("mcp tools", cost.mcpToolTokens, mcpNote(cost.mcpServers)),
+		tokenLine("startup total", startup),
+		tokenLine("skill bodies", cost.skillBodyTokens, "read on demand"),
+		...cost.mcpServers.filter((server) => !server.unavailable).map(serverLine),
+		unpriced.length > 0 ? `\n  Not priced: ${unpriced.map((server) => `${server.name} (${server.unavailable})`).join(", ")}\n` : "",
+		"\n  Excludes skills contributed by extensions, which register after startup.\n"
+	].join("");
+}
+function mcpNote(servers) {
+	const priced = servers.filter((server) => !server.unavailable);
+	if (priced.length === 0) return "always on";
+	return `always on, ${priced.reduce((total, server) => total + server.toolCount, 0)} tools from ${priced.length} server${priced.length === 1 ? "" : "s"}`;
+}
+function serverLine(server) {
+	return tokenLine(`  ${server.name}`, server.tokens, server.cached ? "cached" : "measured now");
+}
+/** Prints the fully resolved matrix instead of launching Pi. */
+async function costExplain(context) {
+	const { options, resources } = context;
+	try {
+		const [catalog, countTokens] = await Promise.all([(0, _agimon_ai_po_skill_catalog.buildSkillCatalog)({
+			repoRoot: options.repoRoot,
+			activeSkillDirectories: resources.skillDirectories,
+			extensionSources: []
+		}), (0, _agimon_ai_po_skill_catalog.counter)()]);
+		const persona = context.personaDirectory ? (0, _agimon_ai_po_config.buildPersonaPrompt)(context.personaRoot ?? options.repoRoot, context.personaDirectory) : void 0;
+		const mcp = resources.mcpConfigPath ? await (0, _agimon_ai_po_core_mcpSchemaCost.priceMcpToolSchemas)({
+			configPath: resources.mcpConfigPath,
+			homeDoomDirectory: (0, _agimon_ai_po_config.globalDoomConfigDirectory)(),
+			cwd: options.repoRoot,
+			environment: context.environment,
+			countTokens
+		}) : {
+			servers: [],
+			totalTokens: 0
+		};
+		return {
+			skillPromptTokens: catalog.promptTokens,
+			skillBodyTokens: catalog.bodyTokens,
+			personaTokens: persona ? countTokens(persona) : 0,
+			mcpServers: mcp.servers,
+			mcpToolTokens: mcp.totalTokens
+		};
+	} catch (error) {
+		const detail = error instanceof Error ? error.message : String(error);
+		process.stderr.write(`[po] explain: could not price the selection: ${detail}\n`);
+		return;
+	}
+}
+async function runExplain(context) {
+	const { options, resources, plugins, mcpAllowlist } = context;
+	const cost = await costExplain(context);
+	process.stdout.write(explainMatrix({
+		cost,
+		majorMode: options.majorMode,
+		profile: context.profile,
+		persona: context.personaDirectory,
+		domains: options.domains,
+		plugins: plugins.map((entry) => entry.directory),
+		layers: context.selectedLayers,
+		hookGroups: context.hookGroups,
+		hooksEnabled: options.hooks,
+		skillDirectories: resources.skillDirectories,
+		skillCount: resources.skillCount,
+		agentCount: resources.agentCount,
+		agentDirectories: resources.agentDirectories,
+		mcpConfigPath: resources.mcpConfigPath,
+		mcpServers: resources.mcpConfigPath ? Object.keys(readMcpServers(resources.mcpConfigPath)) : [],
+		mcpProxyUpstreams: mcpAllowlist?.proxy,
+		mcpFiltered: Boolean(mcpAllowlist)
+	}));
+	return 0;
+}
+/** Compatibility API. Executables call the command function directly. */
+var ExplainCommand = class extends require_baseCommand.BaseCommand {
+	name = "explain";
+	matches(options) {
+		return options.explain;
+	}
+	async execute(context) {
+		return runExplain(context);
+	}
+};
+//#endregion
+exports.ExplainCommand = ExplainCommand;
+exports.explainMatrix = explainMatrix;
+exports.runExplain = runExplain;
+
+//# sourceMappingURL=index.cjs.map