@agimon-ai/po 0.0.0-alpha.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["fs","path","buildSkillCatalog","counter","buildPersonaPrompt","priceMcpToolSchemas","globalDoomConfigDirectory","BaseCommand"],"sources":["../../../../../src/cli/commands/explain/index.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\n\nimport { buildPersonaPrompt, globalDoomConfigDirectory } from '@agimon-ai/po-config';\nimport { type McpServerCost, priceMcpToolSchemas } from '@agimon-ai/po-core/mcpSchemaCost';\nimport { buildSkillCatalog, counter } from '@agimon-ai/po-skill/catalog';\n\nimport type { HarnessContext } from '../../../builders/cli/harnessContext';\nimport type { HarnessOptions } from '../../../composition/types/harness';\nimport { BaseCommand } from '../baseCommand';\n\n/**\n * What the selection costs before the first prompt, in tokens.\n *\n * Every figure is an estimate of what the provider will be sent, not a billed\n * total: skills are counted from files on disk and MCP tools from the schemas\n * their servers advertise, both with the same tokenizer.\n */\nexport interface MatrixCost {\n  /** The always-on skill block Pi puts in the system prompt. */\n  skillPromptTokens: number;\n  /** Skill bodies on disk, read only when a skill is invoked. */\n  skillBodyTokens: number;\n  /** The persona prompt, when a profile selected one. */\n  personaTokens: number;\n  /** Always-on tool schemas, per configured MCP server. */\n  mcpServers: McpServerCost[];\n  mcpToolTokens: number;\n}\n\nexport interface MatrixExplanation {\n  majorMode: string;\n  profile?: string;\n  persona?: string;\n  domains: string[];\n  plugins: string[];\n  layers: string[];\n  hookGroups: string[];\n  hooksEnabled: boolean;\n  skillDirectories: string[];\n  skillCount: number;\n  agentCount: number;\n  agentDirectories: string[];\n  mcpConfigPath?: string;\n  mcpServers: string[];\n  mcpProxyUpstreams?: string[];\n  mcpFiltered: boolean;\n  cost?: MatrixCost;\n}\n\nfunction readMcpServers(configPath: string): Record<string, unknown> {\n  const config = JSON.parse(fs.readFileSync(configPath, 'utf8')) as { mcpServers?: Record<string, unknown> };\n  return config.mcpServers ?? {};\n}\n\n/**\n * Renders the resolved matrix for --explain. Composition spans three config\n * files, so this answers \"why is that loaded\" in one command instead of a\n * manual trace through domains, major modes, and plugin subsets.\n */\nexport function explainMatrix(explanation: MatrixExplanation): string {\n  const section = (label: string, values: string[], empty = '(none)'): string =>\n    `${label}:\\n${values.length === 0 ? `  ${empty}` : values.map((value) => `  ${value}`).join('\\n')}\\n`;\n\n  return [\n    `po resolved matrix\\n\\n`,\n    `major mode: ${explanation.majorMode}\\n\\n`,\n    section('profile', explanation.profile ? [explanation.profile] : [], '(none)'),\n    '\\n',\n    section('persona', explanation.persona ? [explanation.persona] : [], '(none)'),\n    '\\n',\n    section('domains (content)', explanation.domains),\n    '\\n',\n    section('layers (behavior, from the major mode)', explanation.layers, 'core only'),\n    '\\n',\n    section(\n      'hook groups from layers',\n      explanation.hookGroups,\n      explanation.hooksEnabled ? '(core groups only)' : '(hooks disabled)',\n    ),\n    '\\n',\n    section(\n      'plugins',\n      explanation.plugins.map((directory) => path.basename(directory)),\n    ),\n    '\\n',\n    section(\n      'skill paths',\n      explanation.skillDirectories.map((directory) => path.relative(process.cwd(), directory)),\n    ),\n    '\\n',\n    section(\n      explanation.mcpFiltered ? 'mcp servers (filtered by domain allowlist)' : 'mcp servers (unfiltered)',\n      explanation.mcpServers,\n      '(mcp disabled)',\n    ),\n    '\\n',\n    explanation.mcpProxyUpstreams\n      ? section('mcp proxy upstreams (filtered)', explanation.mcpProxyUpstreams)\n      : 'mcp proxy upstreams:\\n  (unfiltered, every upstream in mcp-config.yaml)\\n',\n    '\\n',\n    `skills: ${explanation.skillCount} (from ${explanation.skillDirectories.length} paths)\\n`,\n    `agents: ${explanation.agentCount}\\n`,\n    `mcp config: ${explanation.mcpConfigPath ?? '(disabled)'}\\n`,\n    explanation.cost ? renderCost(explanation.cost) : '',\n  ].join('');\n}\n\nconst TOKEN_COLUMN = 9;\n\nfunction tokenLine(label: string, tokens: number, note = ''): string {\n  const row = `  ${label.padEnd(16)}${tokens.toLocaleString('en-US').padStart(TOKEN_COLUMN)}`;\n  return `${note ? `${row}  ${note}` : row}\\n`;\n}\n\n/**\n * The bill, rendered last so the sections above keep their order.\n *\n * Skill and persona figures are derived from files on disk and MCP figures\n * from a cached handshake, so two runs of the same selection print the same\n * numbers and a reader can reproduce them without trusting this output.\n */\nfunction renderCost(cost: MatrixCost): string {\n  const startup = cost.skillPromptTokens + cost.personaTokens + cost.mcpToolTokens;\n  const unpriced = cost.mcpServers.filter((server) => server.unavailable);\n  return [\n    '\\ncontext cost (tokens)\\n',\n    tokenLine('skills prompt', cost.skillPromptTokens, 'always on'),\n    tokenLine('persona', cost.personaTokens, 'always on'),\n    tokenLine('mcp tools', cost.mcpToolTokens, mcpNote(cost.mcpServers)),\n    tokenLine('startup total', startup),\n    tokenLine('skill bodies', cost.skillBodyTokens, 'read on demand'),\n    ...cost.mcpServers.filter((server) => !server.unavailable).map(serverLine),\n    unpriced.length > 0\n      ? `\\n  Not priced: ${unpriced.map((server) => `${server.name} (${server.unavailable})`).join(', ')}\\n`\n      : '',\n    '\\n  Excludes skills contributed by extensions, which register after startup.\\n',\n  ].join('');\n}\n\nfunction mcpNote(servers: McpServerCost[]): string {\n  const priced = servers.filter((server) => !server.unavailable);\n  if (priced.length === 0) return 'always on';\n  const tools = priced.reduce((total, server) => total + server.toolCount, 0);\n  return `always on, ${tools} tools from ${priced.length} server${priced.length === 1 ? '' : 's'}`;\n}\n\nfunction serverLine(server: McpServerCost): string {\n  return tokenLine(`  ${server.name}`, server.tokens, server.cached ? 'cached' : 'measured now');\n}\n\n/** Prints the fully resolved matrix instead of launching Pi. */\nasync function costExplain(context: HarnessContext): Promise<MatrixCost | undefined> {\n  const { options, resources } = context;\n  try {\n    const [catalog, countTokens] = await Promise.all([\n      buildSkillCatalog({\n        repoRoot: options.repoRoot,\n        activeSkillDirectories: resources.skillDirectories,\n        extensionSources: [],\n      }),\n      counter(),\n    ]);\n    const persona = context.personaDirectory\n      ? buildPersonaPrompt(context.personaRoot ?? options.repoRoot, context.personaDirectory)\n      : undefined;\n    const mcp = resources.mcpConfigPath\n      ? await priceMcpToolSchemas({\n          configPath: resources.mcpConfigPath,\n          homeDoomDirectory: globalDoomConfigDirectory(),\n          cwd: options.repoRoot,\n          environment: context.environment,\n          countTokens,\n        })\n      : { servers: [], totalTokens: 0 };\n    return {\n      skillPromptTokens: catalog.promptTokens,\n      skillBodyTokens: catalog.bodyTokens,\n      personaTokens: persona ? countTokens(persona) : 0,\n      mcpServers: mcp.servers,\n      mcpToolTokens: mcp.totalTokens,\n    };\n  } catch (error) {\n    // Pricing reads the skill files, so an unreadable one must not take the\n    // whole explanation down: the resolved matrix is the point, the bill is\n    // the extra. Reported rather than swallowed.\n    const detail = error instanceof Error ? error.message : String(error);\n    process.stderr.write(`[po] ${'explain'}: could not price the selection: ${detail}\\n`);\n    return undefined;\n  }\n}\n\nexport async function runExplain(context: HarnessContext): Promise<number> {\n  const { options, resources, plugins, mcpAllowlist } = context;\n  const cost = await costExplain(context);\n\n  process.stdout.write(\n    explainMatrix({\n      cost,\n      majorMode: options.majorMode,\n      profile: context.profile,\n      persona: context.personaDirectory,\n      domains: options.domains,\n      plugins: plugins.map((entry) => entry.directory),\n      layers: context.selectedLayers,\n      hookGroups: context.hookGroups,\n      hooksEnabled: options.hooks,\n      skillDirectories: resources.skillDirectories,\n      skillCount: resources.skillCount,\n      agentCount: resources.agentCount,\n      agentDirectories: resources.agentDirectories,\n      mcpConfigPath: resources.mcpConfigPath,\n      // Read back from the generated config so this reports what Pi will\n      // actually load, not what the allowlist intended.\n      mcpServers: resources.mcpConfigPath ? Object.keys(readMcpServers(resources.mcpConfigPath)) : [],\n      mcpProxyUpstreams: mcpAllowlist?.proxy,\n      mcpFiltered: Boolean(mcpAllowlist),\n    }),\n  );\n  return 0;\n}\n\n/** Compatibility API. Executables call the command function directly. */\nexport class ExplainCommand extends BaseCommand {\n  readonly name = 'explain';\n\n  matches(options: HarnessOptions): boolean {\n    return options.explain;\n  }\n\n  async execute(context: HarnessContext): Promise<number> {\n    return runExplain(context);\n  }\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,57 @@
+import { HarnessOptions } from "../../../composition/types/harness.mjs";
+import { HarnessContext } from "../../../builders/cli/harnessContext.mjs";
+import { BaseCommand } from "../baseCommand.mjs";
+import { McpServerCost } from "@agimon-ai/po-core/mcpSchemaCost";
+//#region src/cli/commands/explain/index.d.ts
+/**
+ * What the selection costs before the first prompt, in tokens.
+ *
+ * Every figure is an estimate of what the provider will be sent, not a billed
+ * total: skills are counted from files on disk and MCP tools from the schemas
+ * their servers advertise, both with the same tokenizer.
+ */
+export interface MatrixCost {
+  /** The always-on skill block Pi puts in the system prompt. */
+  skillPromptTokens: number;
+  /** Skill bodies on disk, read only when a skill is invoked. */
+  skillBodyTokens: number;
+  /** The persona prompt, when a profile selected one. */
+  personaTokens: number;
+  /** Always-on tool schemas, per configured MCP server. */
+  mcpServers: McpServerCost[];
+  mcpToolTokens: number;
+}
+export interface MatrixExplanation {
+  majorMode: string;
+  profile?: string;
+  persona?: string;
+  domains: string[];
+  plugins: string[];
+  layers: string[];
+  hookGroups: string[];
+  hooksEnabled: boolean;
+  skillDirectories: string[];
+  skillCount: number;
+  agentCount: number;
+  agentDirectories: string[];
+  mcpConfigPath?: string;
+  mcpServers: string[];
+  mcpProxyUpstreams?: string[];
+  mcpFiltered: boolean;
+  cost?: MatrixCost;
+}
+/**
+ * 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.
+ */
+export declare function explainMatrix(explanation: MatrixExplanation): string;
+export declare function runExplain(context: HarnessContext): Promise<number>;
+/** Compatibility API. Executables call the command function directly. */
+export declare class ExplainCommand extends BaseCommand {
+  readonly name = "explain";
+  matches(options: HarnessOptions): boolean;
+  execute(context: HarnessContext): Promise<number>;
+}
+//#endregion
+//# sourceMappingURL=index.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../../../src/cli/commands/explain/index.ts"],"mappings":";;;;;;;;;;;;iBAkBiB;;EAEf;;EAEA;;EAEA;;EAEA,YAAY;EACZ;;iBAGe;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,OAAO;;;;;;;wBAaO,cAAc,aAAa;wBAoIrB,WAAW,SAAS,iBAAiB;;qBA+B9C,uBAAuB;WACzB;EAET,QAAQ,SAAS;EAIX,QAAQ,SAAS,iBAAiB"}

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

@@ -0,0 +1,150 @@
+import { BaseCommand } from "../baseCommand.mjs";
+import fs from "node:fs";
+import path from "node:path";
+import { buildPersonaPrompt, globalDoomConfigDirectory } from "@agimon-ai/po-config";
+import { priceMcpToolSchemas } from "@agimon-ai/po-core/mcpSchemaCost";
+import { buildSkillCatalog, counter } from "@agimon-ai/po-skill/catalog";
+//#region src/cli/commands/explain/index.ts
+function readMcpServers(configPath) {
+	return JSON.parse(fs.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) => path.basename(directory))),
+		"\n",
+		section("skill paths", explanation.skillDirectories.map((directory) => path.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([buildSkillCatalog({
+			repoRoot: options.repoRoot,
+			activeSkillDirectories: resources.skillDirectories,
+			extensionSources: []
+		}), counter()]);
+		const persona = context.personaDirectory ? buildPersonaPrompt(context.personaRoot ?? options.repoRoot, context.personaDirectory) : void 0;
+		const mcp = resources.mcpConfigPath ? await priceMcpToolSchemas({
+			configPath: resources.mcpConfigPath,
+			homeDoomDirectory: 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 BaseCommand {
+	name = "explain";
+	matches(options) {
+		return options.explain;
+	}
+	async execute(context) {
+		return runExplain(context);
+	}
+};
+//#endregion
+export { ExplainCommand, explainMatrix, runExplain };
+
+//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../../src/cli/commands/explain/index.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\n\nimport { buildPersonaPrompt, globalDoomConfigDirectory } from '@agimon-ai/po-config';\nimport { type McpServerCost, priceMcpToolSchemas } from '@agimon-ai/po-core/mcpSchemaCost';\nimport { buildSkillCatalog, counter } from '@agimon-ai/po-skill/catalog';\n\nimport type { HarnessContext } from '../../../builders/cli/harnessContext';\nimport type { HarnessOptions } from '../../../composition/types/harness';\nimport { BaseCommand } from '../baseCommand';\n\n/**\n * What the selection costs before the first prompt, in tokens.\n *\n * Every figure is an estimate of what the provider will be sent, not a billed\n * total: skills are counted from files on disk and MCP tools from the schemas\n * their servers advertise, both with the same tokenizer.\n */\nexport interface MatrixCost {\n  /** The always-on skill block Pi puts in the system prompt. */\n  skillPromptTokens: number;\n  /** Skill bodies on disk, read only when a skill is invoked. */\n  skillBodyTokens: number;\n  /** The persona prompt, when a profile selected one. */\n  personaTokens: number;\n  /** Always-on tool schemas, per configured MCP server. */\n  mcpServers: McpServerCost[];\n  mcpToolTokens: number;\n}\n\nexport interface MatrixExplanation {\n  majorMode: string;\n  profile?: string;\n  persona?: string;\n  domains: string[];\n  plugins: string[];\n  layers: string[];\n  hookGroups: string[];\n  hooksEnabled: boolean;\n  skillDirectories: string[];\n  skillCount: number;\n  agentCount: number;\n  agentDirectories: string[];\n  mcpConfigPath?: string;\n  mcpServers: string[];\n  mcpProxyUpstreams?: string[];\n  mcpFiltered: boolean;\n  cost?: MatrixCost;\n}\n\nfunction readMcpServers(configPath: string): Record<string, unknown> {\n  const config = JSON.parse(fs.readFileSync(configPath, 'utf8')) as { mcpServers?: Record<string, unknown> };\n  return config.mcpServers ?? {};\n}\n\n/**\n * Renders the resolved matrix for --explain. Composition spans three config\n * files, so this answers \"why is that loaded\" in one command instead of a\n * manual trace through domains, major modes, and plugin subsets.\n */\nexport function explainMatrix(explanation: MatrixExplanation): string {\n  const section = (label: string, values: string[], empty = '(none)'): string =>\n    `${label}:\\n${values.length === 0 ? `  ${empty}` : values.map((value) => `  ${value}`).join('\\n')}\\n`;\n\n  return [\n    `po resolved matrix\\n\\n`,\n    `major mode: ${explanation.majorMode}\\n\\n`,\n    section('profile', explanation.profile ? [explanation.profile] : [], '(none)'),\n    '\\n',\n    section('persona', explanation.persona ? [explanation.persona] : [], '(none)'),\n    '\\n',\n    section('domains (content)', explanation.domains),\n    '\\n',\n    section('layers (behavior, from the major mode)', explanation.layers, 'core only'),\n    '\\n',\n    section(\n      'hook groups from layers',\n      explanation.hookGroups,\n      explanation.hooksEnabled ? '(core groups only)' : '(hooks disabled)',\n    ),\n    '\\n',\n    section(\n      'plugins',\n      explanation.plugins.map((directory) => path.basename(directory)),\n    ),\n    '\\n',\n    section(\n      'skill paths',\n      explanation.skillDirectories.map((directory) => path.relative(process.cwd(), directory)),\n    ),\n    '\\n',\n    section(\n      explanation.mcpFiltered ? 'mcp servers (filtered by domain allowlist)' : 'mcp servers (unfiltered)',\n      explanation.mcpServers,\n      '(mcp disabled)',\n    ),\n    '\\n',\n    explanation.mcpProxyUpstreams\n      ? section('mcp proxy upstreams (filtered)', explanation.mcpProxyUpstreams)\n      : 'mcp proxy upstreams:\\n  (unfiltered, every upstream in mcp-config.yaml)\\n',\n    '\\n',\n    `skills: ${explanation.skillCount} (from ${explanation.skillDirectories.length} paths)\\n`,\n    `agents: ${explanation.agentCount}\\n`,\n    `mcp config: ${explanation.mcpConfigPath ?? '(disabled)'}\\n`,\n    explanation.cost ? renderCost(explanation.cost) : '',\n  ].join('');\n}\n\nconst TOKEN_COLUMN = 9;\n\nfunction tokenLine(label: string, tokens: number, note = ''): string {\n  const row = `  ${label.padEnd(16)}${tokens.toLocaleString('en-US').padStart(TOKEN_COLUMN)}`;\n  return `${note ? `${row}  ${note}` : row}\\n`;\n}\n\n/**\n * The bill, rendered last so the sections above keep their order.\n *\n * Skill and persona figures are derived from files on disk and MCP figures\n * from a cached handshake, so two runs of the same selection print the same\n * numbers and a reader can reproduce them without trusting this output.\n */\nfunction renderCost(cost: MatrixCost): string {\n  const startup = cost.skillPromptTokens + cost.personaTokens + cost.mcpToolTokens;\n  const unpriced = cost.mcpServers.filter((server) => server.unavailable);\n  return [\n    '\\ncontext cost (tokens)\\n',\n    tokenLine('skills prompt', cost.skillPromptTokens, 'always on'),\n    tokenLine('persona', cost.personaTokens, 'always on'),\n    tokenLine('mcp tools', cost.mcpToolTokens, mcpNote(cost.mcpServers)),\n    tokenLine('startup total', startup),\n    tokenLine('skill bodies', cost.skillBodyTokens, 'read on demand'),\n    ...cost.mcpServers.filter((server) => !server.unavailable).map(serverLine),\n    unpriced.length > 0\n      ? `\\n  Not priced: ${unpriced.map((server) => `${server.name} (${server.unavailable})`).join(', ')}\\n`\n      : '',\n    '\\n  Excludes skills contributed by extensions, which register after startup.\\n',\n  ].join('');\n}\n\nfunction mcpNote(servers: McpServerCost[]): string {\n  const priced = servers.filter((server) => !server.unavailable);\n  if (priced.length === 0) return 'always on';\n  const tools = priced.reduce((total, server) => total + server.toolCount, 0);\n  return `always on, ${tools} tools from ${priced.length} server${priced.length === 1 ? '' : 's'}`;\n}\n\nfunction serverLine(server: McpServerCost): string {\n  return tokenLine(`  ${server.name}`, server.tokens, server.cached ? 'cached' : 'measured now');\n}\n\n/** Prints the fully resolved matrix instead of launching Pi. */\nasync function costExplain(context: HarnessContext): Promise<MatrixCost | undefined> {\n  const { options, resources } = context;\n  try {\n    const [catalog, countTokens] = await Promise.all([\n      buildSkillCatalog({\n        repoRoot: options.repoRoot,\n        activeSkillDirectories: resources.skillDirectories,\n        extensionSources: [],\n      }),\n      counter(),\n    ]);\n    const persona = context.personaDirectory\n      ? buildPersonaPrompt(context.personaRoot ?? options.repoRoot, context.personaDirectory)\n      : undefined;\n    const mcp = resources.mcpConfigPath\n      ? await priceMcpToolSchemas({\n          configPath: resources.mcpConfigPath,\n          homeDoomDirectory: globalDoomConfigDirectory(),\n          cwd: options.repoRoot,\n          environment: context.environment,\n          countTokens,\n        })\n      : { servers: [], totalTokens: 0 };\n    return {\n      skillPromptTokens: catalog.promptTokens,\n      skillBodyTokens: catalog.bodyTokens,\n      personaTokens: persona ? countTokens(persona) : 0,\n      mcpServers: mcp.servers,\n      mcpToolTokens: mcp.totalTokens,\n    };\n  } catch (error) {\n    // Pricing reads the skill files, so an unreadable one must not take the\n    // whole explanation down: the resolved matrix is the point, the bill is\n    // the extra. Reported rather than swallowed.\n    const detail = error instanceof Error ? error.message : String(error);\n    process.stderr.write(`[po] ${'explain'}: could not price the selection: ${detail}\\n`);\n    return undefined;\n  }\n}\n\nexport async function runExplain(context: HarnessContext): Promise<number> {\n  const { options, resources, plugins, mcpAllowlist } = context;\n  const cost = await costExplain(context);\n\n  process.stdout.write(\n    explainMatrix({\n      cost,\n      majorMode: options.majorMode,\n      profile: context.profile,\n      persona: context.personaDirectory,\n      domains: options.domains,\n      plugins: plugins.map((entry) => entry.directory),\n      layers: context.selectedLayers,\n      hookGroups: context.hookGroups,\n      hooksEnabled: options.hooks,\n      skillDirectories: resources.skillDirectories,\n      skillCount: resources.skillCount,\n      agentCount: resources.agentCount,\n      agentDirectories: resources.agentDirectories,\n      mcpConfigPath: resources.mcpConfigPath,\n      // Read back from the generated config so this reports what Pi will\n      // actually load, not what the allowlist intended.\n      mcpServers: resources.mcpConfigPath ? Object.keys(readMcpServers(resources.mcpConfigPath)) : [],\n      mcpProxyUpstreams: mcpAllowlist?.proxy,\n      mcpFiltered: Boolean(mcpAllowlist),\n    }),\n  );\n  return 0;\n}\n\n/** Compatibility API. Executables call the command function directly. */\nexport class ExplainCommand extends BaseCommand {\n  readonly name = 'explain';\n\n  matches(options: HarnessOptions): boolean {\n    return options.explain;\n  }\n\n  async execute(context: HarnessContext): Promise<number> {\n    return runExplain(context);\n  }\n}\n"],"mappings":"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"}

package/dist/src/cli/commands/init/constants.cjs

@@ -0,0 +1,11 @@
+//#region src/cli/commands/init/constants.ts
+const SEED_FILE_GUIDANCE = {
+	"config.yaml": "project trust and optional voice defaults",
+	"modes.yaml": "layers, packages, and the default major mode",
+	"domains.yaml": "plugin catalog, domain groups, and aliases",
+	"profiles.yaml": "profile roots, personas, and string environment defaults"
+};
+//#endregion
+exports.SEED_FILE_GUIDANCE = SEED_FILE_GUIDANCE;
+
+//# sourceMappingURL=constants.cjs.map

package/dist/src/cli/commands/init/constants.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.cjs","names":[],"sources":["../../../../../src/cli/commands/init/constants.ts"],"sourcesContent":["export const SEED_FILE_GUIDANCE = {\n  'config.yaml': 'project trust and optional voice defaults',\n  'modes.yaml': 'layers, packages, and the default major mode',\n  'domains.yaml': 'plugin catalog, domain groups, and aliases',\n  'profiles.yaml': 'profile roots, personas, and string environment defaults',\n} as const;\n"],"mappings":";AAAA,MAAa,qBAAqB;CAChC,eAAe;CACf,cAAc;CACd,gBAAgB;CAChB,iBAAiB;AACnB"}

package/dist/src/cli/commands/init/constants.mjs

@@ -0,0 +1,11 @@
+//#region src/cli/commands/init/constants.ts
+const SEED_FILE_GUIDANCE = {
+	"config.yaml": "project trust and optional voice defaults",
+	"modes.yaml": "layers, packages, and the default major mode",
+	"domains.yaml": "plugin catalog, domain groups, and aliases",
+	"profiles.yaml": "profile roots, personas, and string environment defaults"
+};
+//#endregion
+export { SEED_FILE_GUIDANCE };
+
+//# sourceMappingURL=constants.mjs.map

package/dist/src/cli/commands/init/constants.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.mjs","names":[],"sources":["../../../../../src/cli/commands/init/constants.ts"],"sourcesContent":["export const SEED_FILE_GUIDANCE = {\n  'config.yaml': 'project trust and optional voice defaults',\n  'modes.yaml': 'layers, packages, and the default major mode',\n  'domains.yaml': 'plugin catalog, domain groups, and aliases',\n  'profiles.yaml': 'profile roots, personas, and string environment defaults',\n} as const;\n"],"mappings":";AAAA,MAAa,qBAAqB;CAChC,eAAe;CACf,cAAc;CACd,gBAAgB;CAChB,iBAAiB;AACnB"}

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

@@ -0,0 +1,17 @@
+//#region src/cli/commands/init/help.ts
+function initHelp() {
+	return `Usage: po init [--force]
+
+Fills missing files in ~/.po and removes the Po entries and theme that
+earlier versions registered in ~/.pi/agent/settings.json.
+
+Options:
+  --force                   Replace the four personal .po files with current
+                            templates instead of only filling missing ones
+  -h, --help                Show this help
+`;
+}
+//#endregion
+exports.initHelp = initHelp;
+
+//# sourceMappingURL=help.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"help.cjs","names":[],"sources":["../../../../../src/cli/commands/init/help.ts"],"sourcesContent":["export function initHelp(): string {\n  return `Usage: po init [--force]\n\nFills missing files in ~/.po and removes the Po entries and theme that\nearlier versions registered in ~/.pi/agent/settings.json.\n\nOptions:\n  --force                   Replace the four personal .po files with current\n                            templates instead of only filling missing ones\n  -h, --help                Show this help\n`;\n}\n"],"mappings":";AAAA,SAAgB,WAAmB;CACjC,OAAO;;;;;;;;;;AAUT"}

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

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

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

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

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

@@ -0,0 +1,17 @@
+//#region src/cli/commands/init/help.ts
+function initHelp() {
+	return `Usage: po init [--force]
+
+Fills missing files in ~/.po and removes the Po entries and theme that
+earlier versions registered in ~/.pi/agent/settings.json.
+
+Options:
+  --force                   Replace the four personal .po files with current
+                            templates instead of only filling missing ones
+  -h, --help                Show this help
+`;
+}
+//#endregion
+export { initHelp };
+
+//# sourceMappingURL=help.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"help.mjs","names":[],"sources":["../../../../../src/cli/commands/init/help.ts"],"sourcesContent":["export function initHelp(): string {\n  return `Usage: po init [--force]\n\nFills missing files in ~/.po and removes the Po entries and theme that\nearlier versions registered in ~/.pi/agent/settings.json.\n\nOptions:\n  --force                   Replace the four personal .po files with current\n                            templates instead of only filling missing ones\n  -h, --help                Show this help\n`;\n}\n"],"mappings":";AAAA,SAAgB,WAAmB;CACjC,OAAO;;;;;;;;;;AAUT"}

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

@@ -0,0 +1,67 @@
+const require_runtime = require("../../../../_virtual/_rolldown/runtime.cjs");
+const require_help = require("./help.cjs");
+const require_router = require("../../router.cjs");
+const require_presenter = require("./presenter.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_core_piSettings = require("@agimon-ai/po-core/piSettings");
+let _agimon_ai_po_config = require("@agimon-ai/po-config");
+//#region src/cli/commands/init/index.ts
+const INIT_COMMAND = "init";
+const FORCE_FLAG = "--force";
+const SETUP_STAGE_COUNT = 2;
+function setupFailure(activity, target, error) {
+	const detail = error instanceof Error ? error.message : String(error);
+	return new Error(`po init failed while ${activity} at ${target}: ${detail}`, { cause: error });
+}
+/** Handles the repository-independent `po init` command. */
+async function runInit(args, homeDirectory = node_os.default.homedir(), output = process.stdout, environment = process.env) {
+	const flags = args.slice(1);
+	const unknown = flags.find((flag) => flag !== FORCE_FLAG);
+	if (require_router.wantsHelp(args)) {
+		process.stdout.write(require_help.initHelp());
+		return 0;
+	}
+	if (unknown !== void 0) throw new Error(`po init does not accept ${unknown}`);
+	const presenter = new require_presenter.InitPresenter(output, environment);
+	presenter.brand();
+	const configDirectory = (0, _agimon_ai_po_config.globalDoomConfigDirectory)(homeDirectory);
+	presenter.stage(1, SETUP_STAGE_COUNT, "WRITE CONFIGURATION", configDirectory);
+	let configResult;
+	try {
+		configResult = (0, _agimon_ai_po_config.initializeGlobalDoomConfig)(homeDirectory, { force: flags.includes(FORCE_FLAG) });
+		presenter.stageReady("Configuration files are ready.");
+	} catch (error) {
+		presenter.stageFailed("Configuration setup failed.", ["Fix the reported path or permissions, then run po init again."]);
+		throw setupFailure("writing configuration", configDirectory, error);
+	}
+	const agentDirectory = node_path.default.join(homeDirectory, ".pi", "agent");
+	presenter.stage(2, SETUP_STAGE_COUNT, "REMOVE PI REGISTRATION", agentDirectory);
+	let removed;
+	try {
+		removed = (0, _agimon_ai_po_core_piSettings.removePoPiSettings)(agentDirectory);
+		presenter.stageReady(removed.length > 0 ? "Removed Po entries from Pi." : "No Po entries in Pi.");
+	} catch (error) {
+		presenter.stageFailed("Pi cleanup failed.", [`Your Po configuration remains at ${configResult.directory}.`, "Fix the reported settings or filesystem issue, then run po init again."]);
+		throw setupFailure("removing Po from Pi settings", agentDirectory, error);
+	}
+	presenter.complete(configResult, removed);
+	return 0;
+}
+/** Compatibility API. Executables call the command function directly. */
+var InitCommand = class {
+	name = INIT_COMMAND;
+	matches(args) {
+		return args[0] === this.name;
+	}
+	async execute(args, homeDirectory = node_os.default.homedir(), output = process.stdout, environment = process.env) {
+		return runInit(args, homeDirectory, output, environment);
+	}
+};
+//#endregion
+exports.InitCommand = InitCommand;
+exports.runInit = runInit;
+
+//# sourceMappingURL=index.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["os","wantsHelp","initHelp","InitPresenter","globalDoomConfigDirectory","initializeGlobalDoomConfig","path","removePoPiSettings"],"sources":["../../../../../src/cli/commands/init/index.ts"],"sourcesContent":["import os from 'node:os';\nimport path from 'node:path';\n\nimport { type GlobalDoomInitResult, globalDoomConfigDirectory, initializeGlobalDoomConfig } from '@agimon-ai/po-config';\nimport { removePoPiSettings } from '@agimon-ai/po-core/piSettings';\n\nimport { wantsHelp } from '../../router';\nimport { initHelp } from './help';\nimport { InitPresenter, type InitOutput } from './presenter';\n\nconst INIT_COMMAND = 'init';\nconst FORCE_FLAG = '--force';\nconst SETUP_STAGE_COUNT = 2;\n\nfunction setupFailure(activity: string, target: string, error: unknown): Error {\n  const detail = error instanceof Error ? error.message : String(error);\n  return new Error(`po init failed while ${activity} at ${target}: ${detail}`, { cause: error });\n}\n\n/** Handles the repository-independent `po init` command. */\nexport async function runInit(\n  args: string[],\n  homeDirectory = os.homedir(),\n  output: InitOutput = process.stdout,\n  environment: NodeJS.ProcessEnv = process.env,\n): Promise<number> {\n  const flags = args.slice(1);\n  const unknown = flags.find((flag) => flag !== FORCE_FLAG);\n  if (wantsHelp(args)) {\n    process.stdout.write(initHelp());\n    return 0;\n  }\n  if (unknown !== undefined) throw new Error(`po init does not accept ${unknown}`);\n\n  const presenter = new InitPresenter(output, environment);\n  presenter.brand();\n\n  const configDirectory = globalDoomConfigDirectory(homeDirectory);\n  presenter.stage(1, SETUP_STAGE_COUNT, 'WRITE CONFIGURATION', configDirectory);\n  let configResult: GlobalDoomInitResult;\n  try {\n    configResult = initializeGlobalDoomConfig(homeDirectory, { force: flags.includes(FORCE_FLAG) });\n    presenter.stageReady('Configuration files are ready.');\n  } catch (error) {\n    presenter.stageFailed('Configuration setup failed.', [\n      'Fix the reported path or permissions, then run po init again.',\n    ]);\n    throw setupFailure('writing configuration', configDirectory, error);\n  }\n\n  // Po no longer registers with Pi; init only removes what earlier versions wrote.\n  const agentDirectory = path.join(homeDirectory, '.pi', 'agent');\n  presenter.stage(2, SETUP_STAGE_COUNT, 'REMOVE PI REGISTRATION', agentDirectory);\n  let removed: string[];\n  try {\n    removed = removePoPiSettings(agentDirectory);\n    presenter.stageReady(removed.length > 0 ? 'Removed Po entries from Pi.' : 'No Po entries in Pi.');\n  } catch (error) {\n    presenter.stageFailed('Pi cleanup failed.', [\n      `Your Po configuration remains at ${configResult.directory}.`,\n      'Fix the reported settings or filesystem issue, then run po init again.',\n    ]);\n    throw setupFailure('removing Po from Pi settings', agentDirectory, error);\n  }\n\n  presenter.complete(configResult, removed);\n  return 0;\n}\n\n/** Compatibility API. Executables call the command function directly. */\nexport class InitCommand {\n  readonly name = INIT_COMMAND;\n\n  matches(args: string[]): boolean {\n    return args[0] === this.name;\n  }\n\n  async execute(\n    args: string[],\n    homeDirectory = os.homedir(),\n    output: InitOutput = process.stdout,\n    environment: NodeJS.ProcessEnv = process.env,\n  ): Promise<number> {\n    return runInit(args, homeDirectory, output, environment);\n  }\n}\n"],"mappings":";;;;;;;;;;;AAUA,MAAM,eAAe;AACrB,MAAM,aAAa;AACnB,MAAM,oBAAoB;AAE1B,SAAS,aAAa,UAAkB,QAAgB,OAAuB;CAC7E,MAAM,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;CACpE,OAAO,IAAI,MAAM,wBAAwB,SAAS,MAAM,OAAO,IAAI,UAAU,EAAE,OAAO,MAAM,CAAC;AAC/F;;AAGA,eAAsB,QACpB,MACA,gBAAgBA,QAAAA,QAAG,QAAQ,GAC3B,SAAqB,QAAQ,QAC7B,cAAiC,QAAQ,KACxB;CACjB,MAAM,QAAQ,KAAK,MAAM,CAAC;CAC1B,MAAM,UAAU,MAAM,MAAM,SAAS,SAAS,UAAU;CACxD,IAAIC,eAAAA,UAAU,IAAI,GAAG;EACnB,QAAQ,OAAO,MAAMC,aAAAA,SAAS,CAAC;EAC/B,OAAO;CACT;CACA,IAAI,YAAY,KAAA,GAAW,MAAM,IAAI,MAAM,2BAA2B,SAAS;CAE/E,MAAM,YAAY,IAAIC,kBAAAA,cAAc,QAAQ,WAAW;CACvD,UAAU,MAAM;CAEhB,MAAM,mBAAA,GAAkBC,qBAAAA,0BAAAA,CAA0B,aAAa;CAC/D,UAAU,MAAM,GAAG,mBAAmB,uBAAuB,eAAe;CAC5E,IAAI;CACJ,IAAI;EACF,gBAAA,GAAeC,qBAAAA,2BAAAA,CAA2B,eAAe,EAAE,OAAO,MAAM,SAAS,UAAU,EAAE,CAAC;EAC9F,UAAU,WAAW,gCAAgC;CACvD,SAAS,OAAO;EACd,UAAU,YAAY,+BAA+B,CACnD,+DACF,CAAC;EACD,MAAM,aAAa,yBAAyB,iBAAiB,KAAK;CACpE;CAGA,MAAM,iBAAiBC,UAAAA,QAAK,KAAK,eAAe,OAAO,OAAO;CAC9D,UAAU,MAAM,GAAG,mBAAmB,0BAA0B,cAAc;CAC9E,IAAI;CACJ,IAAI;EACF,WAAA,GAAUC,8BAAAA,mBAAAA,CAAmB,cAAc;EAC3C,UAAU,WAAW,QAAQ,SAAS,IAAI,gCAAgC,sBAAsB;CAClG,SAAS,OAAO;EACd,UAAU,YAAY,sBAAsB,CAC1C,oCAAoC,aAAa,UAAU,IAC3D,wEACF,CAAC;EACD,MAAM,aAAa,gCAAgC,gBAAgB,KAAK;CAC1E;CAEA,UAAU,SAAS,cAAc,OAAO;CACxC,OAAO;AACT;;AAGA,IAAa,cAAb,MAAyB;CACvB,OAAgB;CAEhB,QAAQ,MAAyB;EAC/B,OAAO,KAAK,OAAO,KAAK;CAC1B;CAEA,MAAM,QACJ,MACA,gBAAgBP,QAAAA,QAAG,QAAQ,GAC3B,SAAqB,QAAQ,QAC7B,cAAiC,QAAQ,KACxB;EACjB,OAAO,QAAQ,MAAM,eAAe,QAAQ,WAAW;CACzD;AACF"}

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

@@ -0,0 +1,12 @@
+import { InitOutput } from "./presenter.mjs";
+//#region src/cli/commands/init/index.d.ts
+/** Handles the repository-independent `po init` command. */
+export declare function runInit(args: string[], homeDirectory?: string, output?: InitOutput, environment?: NodeJS.ProcessEnv): Promise<number>;
+/** Compatibility API. Executables call the command function directly. */
+export declare class InitCommand {
+  readonly name = "init";
+  matches(args: string[]): boolean;
+  execute(args: string[], homeDirectory?: string, output?: InitOutput, environment?: NodeJS.ProcessEnv): Promise<number>;
+}
+//#endregion
+//# sourceMappingURL=index.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../../../src/cli/commands/init/index.ts"],"mappings":";;;wBAoBsB,QACpB,gBACA,wBACA,SAAQ,YACR,cAAa,OAAO,aACnB;;qBA6CU;WACF;EAET,QAAQ;EAIF,QACJ,gBACA,wBACA,SAAQ,YACR,cAAa,OAAO,aACnB"}

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

@@ -0,0 +1,63 @@
+import { initHelp } from "./help.mjs";
+import { wantsHelp } from "../../router.mjs";
+import { InitPresenter } from "./presenter.mjs";
+import path from "node:path";
+import os from "node:os";
+import { removePoPiSettings } from "@agimon-ai/po-core/piSettings";
+import { globalDoomConfigDirectory, initializeGlobalDoomConfig } from "@agimon-ai/po-config";
+//#region src/cli/commands/init/index.ts
+const INIT_COMMAND = "init";
+const FORCE_FLAG = "--force";
+const SETUP_STAGE_COUNT = 2;
+function setupFailure(activity, target, error) {
+	const detail = error instanceof Error ? error.message : String(error);
+	return new Error(`po init failed while ${activity} at ${target}: ${detail}`, { cause: error });
+}
+/** Handles the repository-independent `po init` command. */
+async function runInit(args, homeDirectory = os.homedir(), output = process.stdout, environment = process.env) {
+	const flags = args.slice(1);
+	const unknown = flags.find((flag) => flag !== FORCE_FLAG);
+	if (wantsHelp(args)) {
+		process.stdout.write(initHelp());
+		return 0;
+	}
+	if (unknown !== void 0) throw new Error(`po init does not accept ${unknown}`);
+	const presenter = new InitPresenter(output, environment);
+	presenter.brand();
+	const configDirectory = globalDoomConfigDirectory(homeDirectory);
+	presenter.stage(1, SETUP_STAGE_COUNT, "WRITE CONFIGURATION", configDirectory);
+	let configResult;
+	try {
+		configResult = initializeGlobalDoomConfig(homeDirectory, { force: flags.includes(FORCE_FLAG) });
+		presenter.stageReady("Configuration files are ready.");
+	} catch (error) {
+		presenter.stageFailed("Configuration setup failed.", ["Fix the reported path or permissions, then run po init again."]);
+		throw setupFailure("writing configuration", configDirectory, error);
+	}
+	const agentDirectory = path.join(homeDirectory, ".pi", "agent");
+	presenter.stage(2, SETUP_STAGE_COUNT, "REMOVE PI REGISTRATION", agentDirectory);
+	let removed;
+	try {
+		removed = removePoPiSettings(agentDirectory);
+		presenter.stageReady(removed.length > 0 ? "Removed Po entries from Pi." : "No Po entries in Pi.");
+	} catch (error) {
+		presenter.stageFailed("Pi cleanup failed.", [`Your Po configuration remains at ${configResult.directory}.`, "Fix the reported settings or filesystem issue, then run po init again."]);
+		throw setupFailure("removing Po from Pi settings", agentDirectory, error);
+	}
+	presenter.complete(configResult, removed);
+	return 0;
+}
+/** Compatibility API. Executables call the command function directly. */
+var InitCommand = class {
+	name = INIT_COMMAND;
+	matches(args) {
+		return args[0] === this.name;
+	}
+	async execute(args, homeDirectory = os.homedir(), output = process.stdout, environment = process.env) {
+		return runInit(args, homeDirectory, output, environment);
+	}
+};
+//#endregion
+export { InitCommand, runInit };
+
+//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../../src/cli/commands/init/index.ts"],"sourcesContent":["import os from 'node:os';\nimport path from 'node:path';\n\nimport { type GlobalDoomInitResult, globalDoomConfigDirectory, initializeGlobalDoomConfig } from '@agimon-ai/po-config';\nimport { removePoPiSettings } from '@agimon-ai/po-core/piSettings';\n\nimport { wantsHelp } from '../../router';\nimport { initHelp } from './help';\nimport { InitPresenter, type InitOutput } from './presenter';\n\nconst INIT_COMMAND = 'init';\nconst FORCE_FLAG = '--force';\nconst SETUP_STAGE_COUNT = 2;\n\nfunction setupFailure(activity: string, target: string, error: unknown): Error {\n  const detail = error instanceof Error ? error.message : String(error);\n  return new Error(`po init failed while ${activity} at ${target}: ${detail}`, { cause: error });\n}\n\n/** Handles the repository-independent `po init` command. */\nexport async function runInit(\n  args: string[],\n  homeDirectory = os.homedir(),\n  output: InitOutput = process.stdout,\n  environment: NodeJS.ProcessEnv = process.env,\n): Promise<number> {\n  const flags = args.slice(1);\n  const unknown = flags.find((flag) => flag !== FORCE_FLAG);\n  if (wantsHelp(args)) {\n    process.stdout.write(initHelp());\n    return 0;\n  }\n  if (unknown !== undefined) throw new Error(`po init does not accept ${unknown}`);\n\n  const presenter = new InitPresenter(output, environment);\n  presenter.brand();\n\n  const configDirectory = globalDoomConfigDirectory(homeDirectory);\n  presenter.stage(1, SETUP_STAGE_COUNT, 'WRITE CONFIGURATION', configDirectory);\n  let configResult: GlobalDoomInitResult;\n  try {\n    configResult = initializeGlobalDoomConfig(homeDirectory, { force: flags.includes(FORCE_FLAG) });\n    presenter.stageReady('Configuration files are ready.');\n  } catch (error) {\n    presenter.stageFailed('Configuration setup failed.', [\n      'Fix the reported path or permissions, then run po init again.',\n    ]);\n    throw setupFailure('writing configuration', configDirectory, error);\n  }\n\n  // Po no longer registers with Pi; init only removes what earlier versions wrote.\n  const agentDirectory = path.join(homeDirectory, '.pi', 'agent');\n  presenter.stage(2, SETUP_STAGE_COUNT, 'REMOVE PI REGISTRATION', agentDirectory);\n  let removed: string[];\n  try {\n    removed = removePoPiSettings(agentDirectory);\n    presenter.stageReady(removed.length > 0 ? 'Removed Po entries from Pi.' : 'No Po entries in Pi.');\n  } catch (error) {\n    presenter.stageFailed('Pi cleanup failed.', [\n      `Your Po configuration remains at ${configResult.directory}.`,\n      'Fix the reported settings or filesystem issue, then run po init again.',\n    ]);\n    throw setupFailure('removing Po from Pi settings', agentDirectory, error);\n  }\n\n  presenter.complete(configResult, removed);\n  return 0;\n}\n\n/** Compatibility API. Executables call the command function directly. */\nexport class InitCommand {\n  readonly name = INIT_COMMAND;\n\n  matches(args: string[]): boolean {\n    return args[0] === this.name;\n  }\n\n  async execute(\n    args: string[],\n    homeDirectory = os.homedir(),\n    output: InitOutput = process.stdout,\n    environment: NodeJS.ProcessEnv = process.env,\n  ): Promise<number> {\n    return runInit(args, homeDirectory, output, environment);\n  }\n}\n"],"mappings":";;;;;;;;AAUA,MAAM,eAAe;AACrB,MAAM,aAAa;AACnB,MAAM,oBAAoB;AAE1B,SAAS,aAAa,UAAkB,QAAgB,OAAuB;CAC7E,MAAM,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;CACpE,OAAO,IAAI,MAAM,wBAAwB,SAAS,MAAM,OAAO,IAAI,UAAU,EAAE,OAAO,MAAM,CAAC;AAC/F;;AAGA,eAAsB,QACpB,MACA,gBAAgB,GAAG,QAAQ,GAC3B,SAAqB,QAAQ,QAC7B,cAAiC,QAAQ,KACxB;CACjB,MAAM,QAAQ,KAAK,MAAM,CAAC;CAC1B,MAAM,UAAU,MAAM,MAAM,SAAS,SAAS,UAAU;CACxD,IAAI,UAAU,IAAI,GAAG;EACnB,QAAQ,OAAO,MAAM,SAAS,CAAC;EAC/B,OAAO;CACT;CACA,IAAI,YAAY,KAAA,GAAW,MAAM,IAAI,MAAM,2BAA2B,SAAS;CAE/E,MAAM,YAAY,IAAI,cAAc,QAAQ,WAAW;CACvD,UAAU,MAAM;CAEhB,MAAM,kBAAkB,0BAA0B,aAAa;CAC/D,UAAU,MAAM,GAAG,mBAAmB,uBAAuB,eAAe;CAC5E,IAAI;CACJ,IAAI;EACF,eAAe,2BAA2B,eAAe,EAAE,OAAO,MAAM,SAAS,UAAU,EAAE,CAAC;EAC9F,UAAU,WAAW,gCAAgC;CACvD,SAAS,OAAO;EACd,UAAU,YAAY,+BAA+B,CACnD,+DACF,CAAC;EACD,MAAM,aAAa,yBAAyB,iBAAiB,KAAK;CACpE;CAGA,MAAM,iBAAiB,KAAK,KAAK,eAAe,OAAO,OAAO;CAC9D,UAAU,MAAM,GAAG,mBAAmB,0BAA0B,cAAc;CAC9E,IAAI;CACJ,IAAI;EACF,UAAU,mBAAmB,cAAc;EAC3C,UAAU,WAAW,QAAQ,SAAS,IAAI,gCAAgC,sBAAsB;CAClG,SAAS,OAAO;EACd,UAAU,YAAY,sBAAsB,CAC1C,oCAAoC,aAAa,UAAU,IAC3D,wEACF,CAAC;EACD,MAAM,aAAa,gCAAgC,gBAAgB,KAAK;CAC1E;CAEA,UAAU,SAAS,cAAc,OAAO;CACxC,OAAO;AACT;;AAGA,IAAa,cAAb,MAAyB;CACvB,OAAgB;CAEhB,QAAQ,MAAyB;EAC/B,OAAO,KAAK,OAAO,KAAK;CAC1B;CAEA,MAAM,QACJ,MACA,gBAAgB,GAAG,QAAQ,GAC3B,SAAqB,QAAQ,QAC7B,cAAiC,QAAQ,KACxB;EACjB,OAAO,QAAQ,MAAM,eAAe,QAAQ,WAAW;CACzD;AACF"}