@agimon-ai/po 0.0.0-alpha.0

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

@@ -0,0 +1,85 @@
+import { createRequire } from "node:module";
+import path from "node:path";
+import { spawn } from "node:child_process";
+//#region src/cli/commands/web/index.ts
+const PO_WEB_PACKAGE = "@agimon-ai/po-web";
+const PO_WEB_MANIFEST = `${PO_WEB_PACKAGE}/package.json`;
+const PO_WEB_BIN = "po-web";
+const FORWARDED_SIGNALS = ["SIGINT", "SIGTERM"];
+const SIGNAL_EXIT_BASE = 128;
+const SIGNAL_NUMBERS = {
+	SIGINT: 2,
+	SIGTERM: 15
+};
+function defaultDependencies() {
+	const require = createRequire(import.meta.url);
+	return {
+		resolve: (specifier) => require.resolve(specifier),
+		readManifest: (manifestPath) => require(manifestPath),
+		spawn: (command, args) => spawn(command, args, { stdio: "inherit" }),
+		signals: process,
+		error: process.stderr
+	};
+}
+function binEntry(manifest) {
+	if (typeof manifest !== "object" || manifest === null) return void 0;
+	const bin = manifest.bin;
+	if (typeof bin === "string") return bin;
+	if (typeof bin !== "object" || bin === null) return void 0;
+	const entry = bin[PO_WEB_BIN];
+	return typeof entry === "string" ? entry : void 0;
+}
+/** Absolute path of the installed po-web bin, or undefined when po-web is not installed. */
+function resolvePoWebBin(dependencies) {
+	let manifestPath;
+	try {
+		manifestPath = dependencies.resolve(PO_WEB_MANIFEST);
+	} catch {
+		return;
+	}
+	const entry = binEntry(dependencies.readManifest(manifestPath));
+	return entry ? path.resolve(path.dirname(manifestPath), entry) : void 0;
+}
+function installGuidance() {
+	return `po could not find ${PO_WEB_PACKAGE}, which serves the Po web console.
+Install it next to po, for example:
+  npm install -g ${PO_WEB_PACKAGE}
+`;
+}
+/**
+* Bare `po`: runs the po-web console with the caller's arguments.
+*
+* po-web depends on po, so po locates it at runtime instead of declaring it.
+* The child inherits stdio, receives SIGINT and SIGTERM, and its exit code
+* becomes po's.
+*/
+async function runPoWeb(args, dependencies = defaultDependencies()) {
+	const bin = resolvePoWebBin(dependencies);
+	if (!bin) {
+		dependencies.error.write(installGuidance());
+		return 1;
+	}
+	const child = dependencies.spawn(process.execPath, [bin, ...args]);
+	const forwarders = FORWARDED_SIGNALS.map((signal) => {
+		const forward = () => {
+			child.kill(signal);
+		};
+		dependencies.signals.on(signal, forward);
+		return [signal, forward];
+	});
+	try {
+		return await new Promise((resolve, reject) => {
+			child.once("error", reject);
+			child.once("exit", (code, signal) => {
+				if (code !== null) resolve(code);
+				else resolve(SIGNAL_EXIT_BASE + (signal ? SIGNAL_NUMBERS[signal] ?? 0 : 0));
+			});
+		});
+	} finally {
+		for (const [signal, forward] of forwarders) dependencies.signals.off(signal, forward);
+	}
+}
+//#endregion
+export { resolvePoWebBin, runPoWeb };
+
+//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../../src/cli/commands/web/index.ts"],"sourcesContent":["import { type ChildProcess, spawn } from 'node:child_process';\nimport { createRequire } from 'node:module';\nimport path from 'node:path';\n\nconst PO_WEB_PACKAGE = '@agimon-ai/po-web';\nconst PO_WEB_MANIFEST = `${PO_WEB_PACKAGE}/package.json`;\nconst PO_WEB_BIN = 'po-web';\nconst FORWARDED_SIGNALS = ['SIGINT', 'SIGTERM'] as const;\nconst SIGNAL_EXIT_BASE = 128;\nconst SIGNAL_NUMBERS: Record<string, number> = { SIGINT: 2, SIGTERM: 15 };\n\nexport interface PoWebOutput {\n  write(chunk: string): void;\n}\n\nexport interface PoWebDependencies {\n  /** Resolves a module specifier to an absolute path, throwing when it is not installed. */\n  resolve: (specifier: string) => string;\n  /** Reads a resolved package manifest. */\n  readManifest: (manifestPath: string) => unknown;\n  spawn: (command: string, args: string[]) => ChildProcess;\n  signals: Pick<NodeJS.Process, 'on' | 'off'>;\n  error: PoWebOutput;\n}\n\nfunction defaultDependencies(): PoWebDependencies {\n  const require = createRequire(import.meta.url);\n  return {\n    resolve: (specifier) => require.resolve(specifier),\n    readManifest: (manifestPath) => require(manifestPath) as unknown,\n    spawn: (command, args) => spawn(command, args, { stdio: 'inherit' }),\n    signals: process,\n    error: process.stderr,\n  };\n}\n\nfunction binEntry(manifest: unknown): string | undefined {\n  if (typeof manifest !== 'object' || manifest === null) return undefined;\n  const bin = (manifest as { bin?: unknown }).bin;\n  if (typeof bin === 'string') return bin;\n  if (typeof bin !== 'object' || bin === null) return undefined;\n  const entry = (bin as Record<string, unknown>)[PO_WEB_BIN];\n  return typeof entry === 'string' ? entry : undefined;\n}\n\n/** Absolute path of the installed po-web bin, or undefined when po-web is not installed. */\nexport function resolvePoWebBin(dependencies: Pick<PoWebDependencies, 'resolve' | 'readManifest'>): string | undefined {\n  let manifestPath: string;\n  try {\n    manifestPath = dependencies.resolve(PO_WEB_MANIFEST);\n  } catch {\n    return undefined;\n  }\n  const entry = binEntry(dependencies.readManifest(manifestPath));\n  return entry ? path.resolve(path.dirname(manifestPath), entry) : undefined;\n}\n\nfunction installGuidance(): string {\n  return `po could not find ${PO_WEB_PACKAGE}, which serves the Po web console.\nInstall it next to po, for example:\n  npm install -g ${PO_WEB_PACKAGE}\n`;\n}\n\n/**\n * Bare `po`: runs the po-web console with the caller's arguments.\n *\n * po-web depends on po, so po locates it at runtime instead of declaring it.\n * The child inherits stdio, receives SIGINT and SIGTERM, and its exit code\n * becomes po's.\n */\nexport async function runPoWeb(\n  args: string[],\n  dependencies: PoWebDependencies = defaultDependencies(),\n): Promise<number> {\n  const bin = resolvePoWebBin(dependencies);\n  if (!bin) {\n    dependencies.error.write(installGuidance());\n    return 1;\n  }\n  const child = dependencies.spawn(process.execPath, [bin, ...args]);\n  const forwarders = FORWARDED_SIGNALS.map((signal) => {\n    const forward = (): void => {\n      child.kill(signal);\n    };\n    dependencies.signals.on(signal, forward);\n    return [signal, forward] as const;\n  });\n  try {\n    return await new Promise<number>((resolve, reject) => {\n      child.once('error', reject);\n      child.once('exit', (code, signal) => {\n        if (code !== null) resolve(code);\n        else resolve(SIGNAL_EXIT_BASE + (signal ? (SIGNAL_NUMBERS[signal] ?? 0) : 0));\n      });\n    });\n  } finally {\n    for (const [signal, forward] of forwarders) dependencies.signals.off(signal, forward);\n  }\n}\n"],"mappings":";;;;AAIA,MAAM,iBAAiB;AACvB,MAAM,kBAAkB,GAAG,eAAe;AAC1C,MAAM,aAAa;AACnB,MAAM,oBAAoB,CAAC,UAAU,SAAS;AAC9C,MAAM,mBAAmB;AACzB,MAAM,iBAAyC;CAAE,QAAQ;CAAG,SAAS;AAAG;AAgBxE,SAAS,sBAAyC;CAChD,MAAM,UAAU,cAAc,YAAY,GAAG;CAC7C,OAAO;EACL,UAAU,cAAc,QAAQ,QAAQ,SAAS;EACjD,eAAe,iBAAiB,QAAQ,YAAY;EACpD,QAAQ,SAAS,SAAS,MAAM,SAAS,MAAM,EAAE,OAAO,UAAU,CAAC;EACnE,SAAS;EACT,OAAO,QAAQ;CACjB;AACF;AAEA,SAAS,SAAS,UAAuC;CACvD,IAAI,OAAO,aAAa,YAAY,aAAa,MAAM,OAAO,KAAA;CAC9D,MAAM,MAAO,SAA+B;CAC5C,IAAI,OAAO,QAAQ,UAAU,OAAO;CACpC,IAAI,OAAO,QAAQ,YAAY,QAAQ,MAAM,OAAO,KAAA;CACpD,MAAM,QAAS,IAAgC;CAC/C,OAAO,OAAO,UAAU,WAAW,QAAQ,KAAA;AAC7C;;AAGA,SAAgB,gBAAgB,cAAuF;CACrH,IAAI;CACJ,IAAI;EACF,eAAe,aAAa,QAAQ,eAAe;CACrD,QAAQ;EACN;CACF;CACA,MAAM,QAAQ,SAAS,aAAa,aAAa,YAAY,CAAC;CAC9D,OAAO,QAAQ,KAAK,QAAQ,KAAK,QAAQ,YAAY,GAAG,KAAK,IAAI,KAAA;AACnE;AAEA,SAAS,kBAA0B;CACjC,OAAO,qBAAqB,eAAe;;mBAE1B,eAAe;;AAElC;;;;;;;;AASA,eAAsB,SACpB,MACA,eAAkC,oBAAoB,GACrC;CACjB,MAAM,MAAM,gBAAgB,YAAY;CACxC,IAAI,CAAC,KAAK;EACR,aAAa,MAAM,MAAM,gBAAgB,CAAC;EAC1C,OAAO;CACT;CACA,MAAM,QAAQ,aAAa,MAAM,QAAQ,UAAU,CAAC,KAAK,GAAG,IAAI,CAAC;CACjE,MAAM,aAAa,kBAAkB,KAAK,WAAW;EACnD,MAAM,gBAAsB;GAC1B,MAAM,KAAK,MAAM;EACnB;EACA,aAAa,QAAQ,GAAG,QAAQ,OAAO;EACvC,OAAO,CAAC,QAAQ,OAAO;CACzB,CAAC;CACD,IAAI;EACF,OAAO,MAAM,IAAI,SAAiB,SAAS,WAAW;GACpD,MAAM,KAAK,SAAS,MAAM;GAC1B,MAAM,KAAK,SAAS,MAAM,WAAW;IACnC,IAAI,SAAS,MAAM,QAAQ,IAAI;SAC1B,QAAQ,oBAAoB,SAAU,eAAe,WAAW,IAAK,EAAE;GAC9E,CAAC;EACH,CAAC;CACH,UAAU;EACR,KAAK,MAAM,CAAC,QAAQ,YAAY,YAAY,aAAa,QAAQ,IAAI,QAAQ,OAAO;CACtF;AACF"}

package/dist/src/cli/harnessOptions.cjs

@@ -0,0 +1,70 @@
+const require_runtime = require("../../_virtual/_rolldown/runtime.cjs");
+const require_options = require("./options.cjs");
+const require_index = require("../composition/harnessState/index.cjs");
+const require_index$1 = require("../composition/repository/index.cjs");
+let node_fs = require("node:fs");
+node_fs = require_runtime.__toESM(node_fs, 1);
+let node_path = require("node:path");
+node_path = require_runtime.__toESM(node_path, 1);
+let node_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_harnessState = require("@agimon-ai/po-config/harnessState");
+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/harnessOptions.ts
+/**
+* Uses the nearest configured repository, or the selected directory for an unconfigured workspace.
+* The repository root is canonical (symlinks resolved), the form the server compares
+* workspace roots and saved session checkouts in.
+*/
+function resolveConfigurationRoot(cwd) {
+	try {
+		return node_fs.default.realpathSync(require_index$1.findRepositoryRoot(cwd));
+	} catch {
+		return node_path.default.resolve(cwd);
+	}
+}
+/**
+* Settles the configuration root and the full option matrix for one run.
+*
+* Two passes are required: the first reads --cwd without touching repository
+* configuration, which keeps a run resolvable even when modes.yaml is
+* malformed, and the second applies the defaults that root supplies. An
+* inherited root wins, which is how a nested run stays pinned to the outer
+* repository rather than re-deriving one from its own cwd. When no configured
+* repository exists, the selected working directory is the configuration root.
+*/
+function resolveHarnessOptions(input) {
+	const environment = input.environment ?? process.env;
+	const cwd = input.cwd ?? process.cwd();
+	const args = [...input.args];
+	const initial = require_options.parseHarnessArgs(args, environment, cwd);
+	const inheritedRoot = require_index.readHarnessState(environment, input.report).root;
+	const repoRoot = inheritedRoot ? node_path.default.resolve(inheritedRoot) : resolveConfigurationRoot(initial.options.cwd);
+	const homeDirectory = initial.options.homeDirectory ?? environment.HOME ?? node_os.default.homedir();
+	const configRoot = input.configRoot ?? repoRoot;
+	const defaults = (0, _agimon_ai_po_config_config.loadDoomConfig)(configRoot, homeDirectory, environment).selection;
+	const selectedEnvironment = { ...environment };
+	for (const axis of [
+		"majorMode",
+		"domains",
+		"profile"
+	]) {
+		const value = defaults?.[axis];
+		if (value !== void 0 && selectedEnvironment[_agimon_ai_po_config_harnessState.HARNESS_STATE_KEYS[axis]] === void 0) selectedEnvironment[_agimon_ai_po_config_harnessState.HARNESS_STATE_KEYS[axis]] = Array.isArray(value) ? value.join(",") : value;
+	}
+	const parsed = require_options.parseHarnessArgs(args, selectedEnvironment, cwd, (0, _agimon_ai_po_config_majorModes.loadMajorModesConfig)(configRoot, homeDirectory, environment).defaultMajorMode, (0, _agimon_ai_po_config_domains.loadDomains)(configRoot, homeDirectory).defaultDomains, (0, _agimon_ai_po_config_profiles.loadProfileCatalog)(configRoot, homeDirectory).defaultProfile);
+	return {
+		repoRoot,
+		...input.configRoot === void 0 ? {} : { configRoot },
+		...parsed.options,
+		homeDirectory,
+		...input.environment === void 0 ? {} : { environment: input.environment }
+	};
+}
+//#endregion
+exports.resolveHarnessOptions = resolveHarnessOptions;
+
+//# sourceMappingURL=harnessOptions.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"harnessOptions.cjs","names":["fs","findRepositoryRoot","path","parseHarnessArgs","readHarnessState","os","loadDoomConfig","HARNESS_STATE_KEYS","loadMajorModesConfig","loadDomains","loadProfileCatalog"],"sources":["../../../src/cli/harnessOptions.ts"],"sourcesContent":["import fs from 'node:fs';\nimport 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 { HARNESS_STATE_KEYS } from '@agimon-ai/po-config/harnessState';\nimport { loadMajorModesConfig } from '@agimon-ai/po-config/majorModes';\nimport { loadProfileCatalog } from '@agimon-ai/po-config/profiles';\nimport type { HarnessFailureReporter } from '@agimon-ai/po-core/runtimeLogSinkTelemetry';\n\nimport { readHarnessState } from '../composition/harnessState';\nimport { findRepositoryRoot } from '../composition/repository';\nimport type { HarnessOptions } from '../composition/types/harness';\nimport { parseHarnessArgs } from './options';\n\nexport interface ResolveHarnessOptionsInput {\n  /** Raw launcher arguments, as the binary received them. */\n  args: readonly string[];\n  environment?: NodeJS.ProcessEnv;\n  cwd?: string;\n  /** Reads configuration from this root instead of the checkout's own. */\n  configRoot?: string;\n  /** Reports a malformed inherited harness state without failing the run. */\n  report?: HarnessFailureReporter;\n}\n\n/**\n * Uses the nearest configured repository, or the selected directory for an unconfigured workspace.\n * The repository root is canonical (symlinks resolved), the form the server compares\n * workspace roots and saved session checkouts in.\n */\nfunction resolveConfigurationRoot(cwd: string): string {\n  try {\n    return fs.realpathSync(findRepositoryRoot(cwd));\n  } catch {\n    return path.resolve(cwd);\n  }\n}\n\n/**\n * Settles the configuration root and the full option matrix for one run.\n *\n * Two passes are required: the first reads --cwd without touching repository\n * configuration, which keeps a run resolvable even when modes.yaml is\n * malformed, and the second applies the defaults that root supplies. An\n * inherited root wins, which is how a nested run stays pinned to the outer\n * repository rather than re-deriving one from its own cwd. When no configured\n * repository exists, the selected working directory is the configuration root.\n */\nexport function resolveHarnessOptions(input: ResolveHarnessOptionsInput): HarnessOptions {\n  const environment = input.environment ?? process.env;\n  const cwd = input.cwd ?? process.cwd();\n  const args = [...input.args];\n\n  const initial = parseHarnessArgs(args, environment, cwd);\n  const inheritedRoot = readHarnessState(environment, input.report).root;\n  const repoRoot = inheritedRoot ? path.resolve(inheritedRoot) : resolveConfigurationRoot(initial.options.cwd);\n  const homeDirectory = initial.options.homeDirectory ?? environment.HOME ?? os.homedir();\n  const configRoot = input.configRoot ?? repoRoot;\n  const defaults = loadDoomConfig(configRoot, homeDirectory, environment).selection;\n  const selectedEnvironment = { ...environment };\n  for (const axis of ['majorMode', 'domains', 'profile'] as const) {\n    const value = defaults?.[axis];\n    if (value !== undefined && selectedEnvironment[HARNESS_STATE_KEYS[axis]] === undefined)\n      selectedEnvironment[HARNESS_STATE_KEYS[axis]] = Array.isArray(value) ? value.join(',') : value;\n  }\n  const parsed = parseHarnessArgs(\n    args,\n    selectedEnvironment,\n    cwd,\n    loadMajorModesConfig(configRoot, homeDirectory, environment).defaultMajorMode,\n    loadDomains(configRoot, homeDirectory).defaultDomains,\n    loadProfileCatalog(configRoot, homeDirectory).defaultProfile,\n  );\n  return {\n    repoRoot,\n    ...(input.configRoot === undefined ? {} : { configRoot }),\n    ...parsed.options,\n    homeDirectory,\n    ...(input.environment === undefined ? {} : { environment: input.environment }),\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAgCA,SAAS,yBAAyB,KAAqB;CACrD,IAAI;EACF,OAAOA,QAAAA,QAAG,aAAaC,gBAAAA,mBAAmB,GAAG,CAAC;CAChD,QAAQ;EACN,OAAOC,UAAAA,QAAK,QAAQ,GAAG;CACzB;AACF;;;;;;;;;;;AAYA,SAAgB,sBAAsB,OAAmD;CACvF,MAAM,cAAc,MAAM,eAAe,QAAQ;CACjD,MAAM,MAAM,MAAM,OAAO,QAAQ,IAAI;CACrC,MAAM,OAAO,CAAC,GAAG,MAAM,IAAI;CAE3B,MAAM,UAAUC,gBAAAA,iBAAiB,MAAM,aAAa,GAAG;CACvD,MAAM,gBAAgBC,cAAAA,iBAAiB,aAAa,MAAM,MAAM,CAAC,CAAC;CAClE,MAAM,WAAW,gBAAgBF,UAAAA,QAAK,QAAQ,aAAa,IAAI,yBAAyB,QAAQ,QAAQ,GAAG;CAC3G,MAAM,gBAAgB,QAAQ,QAAQ,iBAAiB,YAAY,QAAQG,QAAAA,QAAG,QAAQ;CACtF,MAAM,aAAa,MAAM,cAAc;CACvC,MAAM,YAAA,GAAWC,4BAAAA,eAAAA,CAAe,YAAY,eAAe,WAAW,CAAC,CAAC;CACxE,MAAM,sBAAsB,EAAE,GAAG,YAAY;CAC7C,KAAK,MAAM,QAAQ;EAAC;EAAa;EAAW;CAAS,GAAY;EAC/D,MAAM,QAAQ,WAAW;EACzB,IAAI,UAAU,KAAA,KAAa,oBAAoBC,kCAAAA,mBAAmB,WAAW,KAAA,GAC3E,oBAAoBA,kCAAAA,mBAAmB,SAAS,MAAM,QAAQ,KAAK,IAAI,MAAM,KAAK,GAAG,IAAI;CAC7F;CACA,MAAM,SAASJ,gBAAAA,iBACb,MACA,qBACA,MAAA,GACAK,gCAAAA,qBAAAA,CAAqB,YAAY,eAAe,WAAW,CAAC,CAAC,mBAAA,GAC7DC,6BAAAA,YAAAA,CAAY,YAAY,aAAa,CAAC,CAAC,iBAAA,GACvCC,8BAAAA,mBAAAA,CAAmB,YAAY,aAAa,CAAC,CAAC,cAChD;CACA,OAAO;EACL;EACA,GAAI,MAAM,eAAe,KAAA,IAAY,CAAC,IAAI,EAAE,WAAW;EACvD,GAAG,OAAO;EACV;EACA,GAAI,MAAM,gBAAgB,KAAA,IAAY,CAAC,IAAI,EAAE,aAAa,MAAM,YAAY;CAC9E;AACF"}

package/dist/src/cli/harnessOptions.d.mts

@@ -0,0 +1,26 @@
+import { HarnessOptions } from "../composition/types/harness.mjs";
+import { HarnessFailureReporter } from "@agimon-ai/po-core/runtimeLogSinkTelemetry";
+//#region src/cli/harnessOptions.d.ts
+export interface ResolveHarnessOptionsInput {
+  /** Raw launcher arguments, as the binary received them. */
+  args: readonly string[];
+  environment?: NodeJS.ProcessEnv;
+  cwd?: string;
+  /** Reads configuration from this root instead of the checkout's own. */
+  configRoot?: string;
+  /** Reports a malformed inherited harness state without failing the run. */
+  report?: HarnessFailureReporter;
+}
+/**
+ * Settles the configuration root and the full option matrix for one run.
+ *
+ * Two passes are required: the first reads --cwd without touching repository
+ * configuration, which keeps a run resolvable even when modes.yaml is
+ * malformed, and the second applies the defaults that root supplies. An
+ * inherited root wins, which is how a nested run stays pinned to the outer
+ * repository rather than re-deriving one from its own cwd. When no configured
+ * repository exists, the selected working directory is the configuration root.
+ */
+export declare function resolveHarnessOptions(input: ResolveHarnessOptionsInput): HarnessOptions;
+//#endregion
+//# sourceMappingURL=harnessOptions.d.mts.map

package/dist/src/cli/harnessOptions.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harnessOptions.d.mts","names":[],"sources":["../../../src/cli/harnessOptions.ts"],"mappings":";;;iBAgBiB;;EAEf;EACA,cAAc,OAAO;EACrB;;EAEA;;EAEA,SAAS;;;;;;;;;;;;wBA0BK,sBAAsB,OAAO,6BAA6B"}

package/dist/src/cli/harnessOptions.mjs

@@ -0,0 +1,66 @@
+import { parseHarnessArgs } from "./options.mjs";
+import { readHarnessState as readHarnessState$1 } from "../composition/harnessState/index.mjs";
+import { findRepositoryRoot } from "../composition/repository/index.mjs";
+import fs from "node:fs";
+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 { HARNESS_STATE_KEYS } from "@agimon-ai/po-config/harnessState";
+import { loadMajorModesConfig } from "@agimon-ai/po-config/majorModes";
+import { loadProfileCatalog } from "@agimon-ai/po-config/profiles";
+//#region src/cli/harnessOptions.ts
+/**
+* Uses the nearest configured repository, or the selected directory for an unconfigured workspace.
+* The repository root is canonical (symlinks resolved), the form the server compares
+* workspace roots and saved session checkouts in.
+*/
+function resolveConfigurationRoot(cwd) {
+	try {
+		return fs.realpathSync(findRepositoryRoot(cwd));
+	} catch {
+		return path.resolve(cwd);
+	}
+}
+/**
+* Settles the configuration root and the full option matrix for one run.
+*
+* Two passes are required: the first reads --cwd without touching repository
+* configuration, which keeps a run resolvable even when modes.yaml is
+* malformed, and the second applies the defaults that root supplies. An
+* inherited root wins, which is how a nested run stays pinned to the outer
+* repository rather than re-deriving one from its own cwd. When no configured
+* repository exists, the selected working directory is the configuration root.
+*/
+function resolveHarnessOptions(input) {
+	const environment = input.environment ?? process.env;
+	const cwd = input.cwd ?? process.cwd();
+	const args = [...input.args];
+	const initial = parseHarnessArgs(args, environment, cwd);
+	const inheritedRoot = readHarnessState$1(environment, input.report).root;
+	const repoRoot = inheritedRoot ? path.resolve(inheritedRoot) : resolveConfigurationRoot(initial.options.cwd);
+	const homeDirectory = initial.options.homeDirectory ?? environment.HOME ?? os.homedir();
+	const configRoot = input.configRoot ?? repoRoot;
+	const defaults = loadDoomConfig(configRoot, homeDirectory, environment).selection;
+	const selectedEnvironment = { ...environment };
+	for (const axis of [
+		"majorMode",
+		"domains",
+		"profile"
+	]) {
+		const value = defaults?.[axis];
+		if (value !== void 0 && selectedEnvironment[HARNESS_STATE_KEYS[axis]] === void 0) selectedEnvironment[HARNESS_STATE_KEYS[axis]] = Array.isArray(value) ? value.join(",") : value;
+	}
+	const parsed = parseHarnessArgs(args, selectedEnvironment, cwd, loadMajorModesConfig(configRoot, homeDirectory, environment).defaultMajorMode, loadDomains(configRoot, homeDirectory).defaultDomains, loadProfileCatalog(configRoot, homeDirectory).defaultProfile);
+	return {
+		repoRoot,
+		...input.configRoot === void 0 ? {} : { configRoot },
+		...parsed.options,
+		homeDirectory,
+		...input.environment === void 0 ? {} : { environment: input.environment }
+	};
+}
+//#endregion
+export { resolveHarnessOptions };
+
+//# sourceMappingURL=harnessOptions.mjs.map

package/dist/src/cli/harnessOptions.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"harnessOptions.mjs","names":["readHarnessState"],"sources":["../../../src/cli/harnessOptions.ts"],"sourcesContent":["import fs from 'node:fs';\nimport 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 { HARNESS_STATE_KEYS } from '@agimon-ai/po-config/harnessState';\nimport { loadMajorModesConfig } from '@agimon-ai/po-config/majorModes';\nimport { loadProfileCatalog } from '@agimon-ai/po-config/profiles';\nimport type { HarnessFailureReporter } from '@agimon-ai/po-core/runtimeLogSinkTelemetry';\n\nimport { readHarnessState } from '../composition/harnessState';\nimport { findRepositoryRoot } from '../composition/repository';\nimport type { HarnessOptions } from '../composition/types/harness';\nimport { parseHarnessArgs } from './options';\n\nexport interface ResolveHarnessOptionsInput {\n  /** Raw launcher arguments, as the binary received them. */\n  args: readonly string[];\n  environment?: NodeJS.ProcessEnv;\n  cwd?: string;\n  /** Reads configuration from this root instead of the checkout's own. */\n  configRoot?: string;\n  /** Reports a malformed inherited harness state without failing the run. */\n  report?: HarnessFailureReporter;\n}\n\n/**\n * Uses the nearest configured repository, or the selected directory for an unconfigured workspace.\n * The repository root is canonical (symlinks resolved), the form the server compares\n * workspace roots and saved session checkouts in.\n */\nfunction resolveConfigurationRoot(cwd: string): string {\n  try {\n    return fs.realpathSync(findRepositoryRoot(cwd));\n  } catch {\n    return path.resolve(cwd);\n  }\n}\n\n/**\n * Settles the configuration root and the full option matrix for one run.\n *\n * Two passes are required: the first reads --cwd without touching repository\n * configuration, which keeps a run resolvable even when modes.yaml is\n * malformed, and the second applies the defaults that root supplies. An\n * inherited root wins, which is how a nested run stays pinned to the outer\n * repository rather than re-deriving one from its own cwd. When no configured\n * repository exists, the selected working directory is the configuration root.\n */\nexport function resolveHarnessOptions(input: ResolveHarnessOptionsInput): HarnessOptions {\n  const environment = input.environment ?? process.env;\n  const cwd = input.cwd ?? process.cwd();\n  const args = [...input.args];\n\n  const initial = parseHarnessArgs(args, environment, cwd);\n  const inheritedRoot = readHarnessState(environment, input.report).root;\n  const repoRoot = inheritedRoot ? path.resolve(inheritedRoot) : resolveConfigurationRoot(initial.options.cwd);\n  const homeDirectory = initial.options.homeDirectory ?? environment.HOME ?? os.homedir();\n  const configRoot = input.configRoot ?? repoRoot;\n  const defaults = loadDoomConfig(configRoot, homeDirectory, environment).selection;\n  const selectedEnvironment = { ...environment };\n  for (const axis of ['majorMode', 'domains', 'profile'] as const) {\n    const value = defaults?.[axis];\n    if (value !== undefined && selectedEnvironment[HARNESS_STATE_KEYS[axis]] === undefined)\n      selectedEnvironment[HARNESS_STATE_KEYS[axis]] = Array.isArray(value) ? value.join(',') : value;\n  }\n  const parsed = parseHarnessArgs(\n    args,\n    selectedEnvironment,\n    cwd,\n    loadMajorModesConfig(configRoot, homeDirectory, environment).defaultMajorMode,\n    loadDomains(configRoot, homeDirectory).defaultDomains,\n    loadProfileCatalog(configRoot, homeDirectory).defaultProfile,\n  );\n  return {\n    repoRoot,\n    ...(input.configRoot === undefined ? {} : { configRoot }),\n    ...parsed.options,\n    homeDirectory,\n    ...(input.environment === undefined ? {} : { environment: input.environment }),\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAgCA,SAAS,yBAAyB,KAAqB;CACrD,IAAI;EACF,OAAO,GAAG,aAAa,mBAAmB,GAAG,CAAC;CAChD,QAAQ;EACN,OAAO,KAAK,QAAQ,GAAG;CACzB;AACF;;;;;;;;;;;AAYA,SAAgB,sBAAsB,OAAmD;CACvF,MAAM,cAAc,MAAM,eAAe,QAAQ;CACjD,MAAM,MAAM,MAAM,OAAO,QAAQ,IAAI;CACrC,MAAM,OAAO,CAAC,GAAG,MAAM,IAAI;CAE3B,MAAM,UAAU,iBAAiB,MAAM,aAAa,GAAG;CACvD,MAAM,gBAAgBA,mBAAiB,aAAa,MAAM,MAAM,CAAC,CAAC;CAClE,MAAM,WAAW,gBAAgB,KAAK,QAAQ,aAAa,IAAI,yBAAyB,QAAQ,QAAQ,GAAG;CAC3G,MAAM,gBAAgB,QAAQ,QAAQ,iBAAiB,YAAY,QAAQ,GAAG,QAAQ;CACtF,MAAM,aAAa,MAAM,cAAc;CACvC,MAAM,WAAW,eAAe,YAAY,eAAe,WAAW,CAAC,CAAC;CACxE,MAAM,sBAAsB,EAAE,GAAG,YAAY;CAC7C,KAAK,MAAM,QAAQ;EAAC;EAAa;EAAW;CAAS,GAAY;EAC/D,MAAM,QAAQ,WAAW;EACzB,IAAI,UAAU,KAAA,KAAa,oBAAoB,mBAAmB,WAAW,KAAA,GAC3E,oBAAoB,mBAAmB,SAAS,MAAM,QAAQ,KAAK,IAAI,MAAM,KAAK,GAAG,IAAI;CAC7F;CACA,MAAM,SAAS,iBACb,MACA,qBACA,KACA,qBAAqB,YAAY,eAAe,WAAW,CAAC,CAAC,kBAC7D,YAAY,YAAY,aAAa,CAAC,CAAC,gBACvC,mBAAmB,YAAY,aAAa,CAAC,CAAC,cAChD;CACA,OAAO;EACL;EACA,GAAI,MAAM,eAAe,KAAA,IAAY,CAAC,IAAI,EAAE,WAAW;EACvD,GAAG,OAAO;EACV;EACA,GAAI,MAAM,gBAAgB,KAAA,IAAY,CAAC,IAAI,EAAE,aAAa,MAAM,YAAY;CAC9E;AACF"}

package/dist/src/cli/help.cjs

@@ -0,0 +1,82 @@
+const require_help = require("./commands/compat/help.cjs");
+const require_help$1 = require("./commands/init/help.cjs");
+const require_help$2 = require("./commands/sync/help.cjs");
+const require_help$3 = require("./commands/doctor/help.cjs");
+const HARNESS_VERSION = (0, require("node:module").createRequire)(require("url").pathToFileURL(__filename).href)("@agimon-ai/po/package.json").version;
+function printHelp() {
+	process.stdout.write(`po
+
+Usage: po [po-web options]
+       po --explain | --emit-mcp <dir> [harness options]
+       po init
+       po sync [matrix options] [--check]
+       po api-export --out <directory> [--major-mode <name>] [--strict]
+       po compat <codex|claude|antigravity> [matrix options] [provider arguments]
+
+Running po with no subcommand starts the po-web console (install
+@agimon-ai/po-web next to po) and passes every argument to it.
+
+Initialization:
+  po init              Fill missing files in ~/.po
+  po sync              Update packages, build, resolve, and register Po
+                            in Pi user settings
+  po sync --check      Exit non-zero when the synced config is out of date
+                            or report legacy repository-local state to migrate
+
+Po keeps its configuration, builds, and Pi agent directory under ~/.po
+(PO_HOME moves it). Po never removes old or orphaned generated directories
+automatically.
+
+After a sync, run pi directly. The synced session accepts --major-mode,
+--domains, and --profile, and /mode, /domains, and /profile switch
+without a restart. Selection defaults come from the selection block in
+.po/config.yaml.
+
+${require_help.COMPATIBILITY_MATRIX_OPTIONS}
+All other compatibility arguments pass to the provider unchanged.
+
+Harness options:
+  --major-mode <name>       Named major mode from .po/modes.yaml
+                            (default: copilot). Not --mode: Pi owns that one.
+  --profile <name>          Persona and env from .po/profiles.yaml
+  --domains <names>         Comma-separated domains (content: plugins, skills)
+  --no-domains              Load no content domains
+  --explain                 Print the resolved matrix and exit
+  --emit-mcp <dir>          Write the resolved MCP config to a directory and exit
+  --plugin-dir <path>       Load an explicit plugin directory, repeatable
+  --add-dir <path>          Add an accessible directory, repeatable
+  --preset <name>           default or kimi
+  --cwd <path>              Run Pi in this directory
+  --automation              Use print mode, JSON output, and project approval
+  --output-format vibe-lint Read a vibe-lint request from stdin and emit one JSON response
+  --allow-protected-writes  Allow writes to protected repository paths
+  --hooks, --no-hooks       Enable or disable repository and plugin hooks
+  --mcp, --no-mcp           Enable or disable MCP configuration
+  --agents, --no-agents     Enable or disable spawnable agents
+  -h, --help                Show harness help
+  -v, --version             Show harness version
+
+Interactive commands:
+  /loop                     Open the loop launcher picker
+  /loops                    List active loops and stop future scheduling
+  /effort <level>           Set and persist the thinking effort
+  /mode                     Pick a named major mode
+  /domains [names]          Show the selected domains or pick a different set
+  /profile                  List or switch persona and environment profiles
+
+Minor modes are toggled from the Leader menu, not by a slash command:
+  SPC p e                   Plan mode (repository read-only)
+  SPC w e                   Workflow tools for the agent
+
+All remaining options are passed to Pi.
+`);
+}
+//#endregion
+exports.HARNESS_VERSION = HARNESS_VERSION;
+exports.compatHelp = require_help.compatHelp;
+exports.doctorHelp = require_help$3.doctorHelp;
+exports.initHelp = require_help$1.initHelp;
+exports.printHelp = printHelp;
+exports.syncHelp = require_help$2.syncHelp;
+
+//# sourceMappingURL=help.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"help.cjs","names":["require","createRequire","COMPATIBILITY_MATRIX_OPTIONS"],"sources":["../../../src/cli/help.ts"],"sourcesContent":["import { COMPATIBILITY_MATRIX_OPTIONS } from './commands/compat/help';\nexport { initHelp } from './commands/init/help';\nexport { syncHelp } from './commands/sync/help';\nexport { compatHelp } from './commands/compat/help';\nexport { doctorHelp } from './commands/doctor/help';\nimport { createRequire } from 'node:module';\n\n// createRequire rather than a JSON import: this file runs both from src under\n// Node's strip-only TypeScript mode (how pi.sh starts it) and from dist. The\n// package self-reference resolves the same published manifest from either tree.\nconst require = createRequire(import.meta.url);\nconst PACKAGE_MANIFEST = '@agimon-ai/po/package.json';\n\nexport const HARNESS_VERSION = (require(PACKAGE_MANIFEST) as { version: string }).version;\n\nexport function printHelp(): void {\n  process.stdout.write(`po\n\nUsage: po [po-web options]\n       po --explain | --emit-mcp <dir> [harness options]\n       po init\n       po sync [matrix options] [--check]\n       po api-export --out <directory> [--major-mode <name>] [--strict]\n       po compat <codex|claude|antigravity> [matrix options] [provider arguments]\n\nRunning po with no subcommand starts the po-web console (install\n@agimon-ai/po-web next to po) and passes every argument to it.\n\nInitialization:\n  po init              Fill missing files in ~/.po\n  po sync              Update packages, build, resolve, and register Po\n                            in Pi user settings\n  po sync --check      Exit non-zero when the synced config is out of date\n                            or report legacy repository-local state to migrate\n\nPo keeps its configuration, builds, and Pi agent directory under ~/.po\n(PO_HOME moves it). Po never removes old or orphaned generated directories\nautomatically.\n\nAfter a sync, run pi directly. The synced session accepts --major-mode,\n--domains, and --profile, and /mode, /domains, and /profile switch\nwithout a restart. Selection defaults come from the selection block in\n.po/config.yaml.\n\n${COMPATIBILITY_MATRIX_OPTIONS}\nAll other compatibility arguments pass to the provider unchanged.\n\nHarness options:\n  --major-mode <name>       Named major mode from .po/modes.yaml\n                            (default: copilot). Not --mode: Pi owns that one.\n  --profile <name>          Persona and env from .po/profiles.yaml\n  --domains <names>         Comma-separated domains (content: plugins, skills)\n  --no-domains              Load no content domains\n  --explain                 Print the resolved matrix and exit\n  --emit-mcp <dir>          Write the resolved MCP config to a directory and exit\n  --plugin-dir <path>       Load an explicit plugin directory, repeatable\n  --add-dir <path>          Add an accessible directory, repeatable\n  --preset <name>           default or kimi\n  --cwd <path>              Run Pi in this directory\n  --automation              Use print mode, JSON output, and project approval\n  --output-format vibe-lint Read a vibe-lint request from stdin and emit one JSON response\n  --allow-protected-writes  Allow writes to protected repository paths\n  --hooks, --no-hooks       Enable or disable repository and plugin hooks\n  --mcp, --no-mcp           Enable or disable MCP configuration\n  --agents, --no-agents     Enable or disable spawnable agents\n  -h, --help                Show harness help\n  -v, --version             Show harness version\n\nInteractive commands:\n  /loop                     Open the loop launcher picker\n  /loops                    List active loops and stop future scheduling\n  /effort <level>           Set and persist the thinking effort\n  /mode                     Pick a named major mode\n  /domains [names]          Show the selected domains or pick a different set\n  /profile                  List or switch persona and environment profiles\n\nMinor modes are toggled from the Leader menu, not by a slash command:\n  SPC p e                   Plan mode (repository read-only)\n  SPC w e                   Workflow tools for the agent\n\nAll remaining options are passed to Pi.\n`);\n}\n"],"mappings":";;;;AAaA,MAAa,mBAHPA,wBAAUC,CAAAA,CAAAA,cAAAA,CAAAA,QAAAA,KAAAA,CAAAA,CAAAA,cAAAA,UAAAA,CAAAA,CAAAA,IAGgBD,CAAAA,CAAQ,4BAAgB,CAAC,CAAyB;AAElF,SAAgB,YAAkB;CAChC,QAAQ,OAAO,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4BrBE,aAAAA,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqC9B;AACD"}

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

@@ -0,0 +1,10 @@
+import { initHelp } from "./commands/init/help.mjs";
+import { syncHelp } from "./commands/sync/help.mjs";
+import { compatHelp } from "./commands/compat/help.mjs";
+import { doctorHelp } from "./commands/doctor/help.mjs";
+//#region src/cli/help.d.ts
+export declare const HARNESS_VERSION: string;
+export declare function printHelp(): void;
+//#endregion
+export { compatHelp, doctorHelp, initHelp, syncHelp };
+//# sourceMappingURL=help.d.mts.map

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

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

package/dist/src/cli/help.mjs

@@ -0,0 +1,78 @@
+import { COMPATIBILITY_MATRIX_OPTIONS, compatHelp } from "./commands/compat/help.mjs";
+import { initHelp } from "./commands/init/help.mjs";
+import { syncHelp } from "./commands/sync/help.mjs";
+import { doctorHelp } from "./commands/doctor/help.mjs";
+import { createRequire } from "node:module";
+const HARNESS_VERSION = createRequire(import.meta.url)("@agimon-ai/po/package.json").version;
+function printHelp() {
+	process.stdout.write(`po
+
+Usage: po [po-web options]
+       po --explain | --emit-mcp <dir> [harness options]
+       po init
+       po sync [matrix options] [--check]
+       po api-export --out <directory> [--major-mode <name>] [--strict]
+       po compat <codex|claude|antigravity> [matrix options] [provider arguments]
+
+Running po with no subcommand starts the po-web console (install
+@agimon-ai/po-web next to po) and passes every argument to it.
+
+Initialization:
+  po init              Fill missing files in ~/.po
+  po sync              Update packages, build, resolve, and register Po
+                            in Pi user settings
+  po sync --check      Exit non-zero when the synced config is out of date
+                            or report legacy repository-local state to migrate
+
+Po keeps its configuration, builds, and Pi agent directory under ~/.po
+(PO_HOME moves it). Po never removes old or orphaned generated directories
+automatically.
+
+After a sync, run pi directly. The synced session accepts --major-mode,
+--domains, and --profile, and /mode, /domains, and /profile switch
+without a restart. Selection defaults come from the selection block in
+.po/config.yaml.
+
+${COMPATIBILITY_MATRIX_OPTIONS}
+All other compatibility arguments pass to the provider unchanged.
+
+Harness options:
+  --major-mode <name>       Named major mode from .po/modes.yaml
+                            (default: copilot). Not --mode: Pi owns that one.
+  --profile <name>          Persona and env from .po/profiles.yaml
+  --domains <names>         Comma-separated domains (content: plugins, skills)
+  --no-domains              Load no content domains
+  --explain                 Print the resolved matrix and exit
+  --emit-mcp <dir>          Write the resolved MCP config to a directory and exit
+  --plugin-dir <path>       Load an explicit plugin directory, repeatable
+  --add-dir <path>          Add an accessible directory, repeatable
+  --preset <name>           default or kimi
+  --cwd <path>              Run Pi in this directory
+  --automation              Use print mode, JSON output, and project approval
+  --output-format vibe-lint Read a vibe-lint request from stdin and emit one JSON response
+  --allow-protected-writes  Allow writes to protected repository paths
+  --hooks, --no-hooks       Enable or disable repository and plugin hooks
+  --mcp, --no-mcp           Enable or disable MCP configuration
+  --agents, --no-agents     Enable or disable spawnable agents
+  -h, --help                Show harness help
+  -v, --version             Show harness version
+
+Interactive commands:
+  /loop                     Open the loop launcher picker
+  /loops                    List active loops and stop future scheduling
+  /effort <level>           Set and persist the thinking effort
+  /mode                     Pick a named major mode
+  /domains [names]          Show the selected domains or pick a different set
+  /profile                  List or switch persona and environment profiles
+
+Minor modes are toggled from the Leader menu, not by a slash command:
+  SPC p e                   Plan mode (repository read-only)
+  SPC w e                   Workflow tools for the agent
+
+All remaining options are passed to Pi.
+`);
+}
+//#endregion
+export { HARNESS_VERSION, compatHelp, doctorHelp, initHelp, printHelp, syncHelp };
+
+//# sourceMappingURL=help.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"help.mjs","names":[],"sources":["../../../src/cli/help.ts"],"sourcesContent":["import { COMPATIBILITY_MATRIX_OPTIONS } from './commands/compat/help';\nexport { initHelp } from './commands/init/help';\nexport { syncHelp } from './commands/sync/help';\nexport { compatHelp } from './commands/compat/help';\nexport { doctorHelp } from './commands/doctor/help';\nimport { createRequire } from 'node:module';\n\n// createRequire rather than a JSON import: this file runs both from src under\n// Node's strip-only TypeScript mode (how pi.sh starts it) and from dist. The\n// package self-reference resolves the same published manifest from either tree.\nconst require = createRequire(import.meta.url);\nconst PACKAGE_MANIFEST = '@agimon-ai/po/package.json';\n\nexport const HARNESS_VERSION = (require(PACKAGE_MANIFEST) as { version: string }).version;\n\nexport function printHelp(): void {\n  process.stdout.write(`po\n\nUsage: po [po-web options]\n       po --explain | --emit-mcp <dir> [harness options]\n       po init\n       po sync [matrix options] [--check]\n       po api-export --out <directory> [--major-mode <name>] [--strict]\n       po compat <codex|claude|antigravity> [matrix options] [provider arguments]\n\nRunning po with no subcommand starts the po-web console (install\n@agimon-ai/po-web next to po) and passes every argument to it.\n\nInitialization:\n  po init              Fill missing files in ~/.po\n  po sync              Update packages, build, resolve, and register Po\n                            in Pi user settings\n  po sync --check      Exit non-zero when the synced config is out of date\n                            or report legacy repository-local state to migrate\n\nPo keeps its configuration, builds, and Pi agent directory under ~/.po\n(PO_HOME moves it). Po never removes old or orphaned generated directories\nautomatically.\n\nAfter a sync, run pi directly. The synced session accepts --major-mode,\n--domains, and --profile, and /mode, /domains, and /profile switch\nwithout a restart. Selection defaults come from the selection block in\n.po/config.yaml.\n\n${COMPATIBILITY_MATRIX_OPTIONS}\nAll other compatibility arguments pass to the provider unchanged.\n\nHarness options:\n  --major-mode <name>       Named major mode from .po/modes.yaml\n                            (default: copilot). Not --mode: Pi owns that one.\n  --profile <name>          Persona and env from .po/profiles.yaml\n  --domains <names>         Comma-separated domains (content: plugins, skills)\n  --no-domains              Load no content domains\n  --explain                 Print the resolved matrix and exit\n  --emit-mcp <dir>          Write the resolved MCP config to a directory and exit\n  --plugin-dir <path>       Load an explicit plugin directory, repeatable\n  --add-dir <path>          Add an accessible directory, repeatable\n  --preset <name>           default or kimi\n  --cwd <path>              Run Pi in this directory\n  --automation              Use print mode, JSON output, and project approval\n  --output-format vibe-lint Read a vibe-lint request from stdin and emit one JSON response\n  --allow-protected-writes  Allow writes to protected repository paths\n  --hooks, --no-hooks       Enable or disable repository and plugin hooks\n  --mcp, --no-mcp           Enable or disable MCP configuration\n  --agents, --no-agents     Enable or disable spawnable agents\n  -h, --help                Show harness help\n  -v, --version             Show harness version\n\nInteractive commands:\n  /loop                     Open the loop launcher picker\n  /loops                    List active loops and stop future scheduling\n  /effort <level>           Set and persist the thinking effort\n  /mode                     Pick a named major mode\n  /domains [names]          Show the selected domains or pick a different set\n  /profile                  List or switch persona and environment profiles\n\nMinor modes are toggled from the Leader menu, not by a slash command:\n  SPC p e                   Plan mode (repository read-only)\n  SPC w e                   Workflow tools for the agent\n\nAll remaining options are passed to Pi.\n`);\n}\n"],"mappings":";;;;;AAaA,MAAa,kBAHG,cAAc,YAAY,GAGV,CAAA,CAAQ,4BAAgB,CAAC,CAAyB;AAElF,SAAgB,YAAkB;CAChC,QAAQ,OAAO,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4BrB,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqC9B;AACD"}