@agimon-ai/doompi 0.0.1-alpha.76 → 0.0.1-alpha.78

package/dist/cli/help.mjs

@@ -0,0 +1,83 @@
+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 { historyExportHelp } from "./commands/history-export/help.mjs";
+import { historyImportHelp } from "./commands/history-import/help.mjs";
+import { createRequire } from "node:module";
+const HARNESS_VERSION = createRequire(import.meta.url)("@agimon-ai/doompi/package.json").version;
+function printHelp() {
+	process.stdout.write(`doompi
+
+Usage: doompi [harness options] [Pi options] [prompt]
+       doompi init
+       doompi sync [matrix options] [--check]
+       doompi api-export --out <directory> [--major-mode <name>] [--strict]
+       doompi compat <codex|claude|antigravity> [matrix options] [provider arguments]
+       doompi history-export <v4-source> <v3-destination> [options]
+       doompi history-import <v3-source> <v4-destination> --confirm-offline
+
+Initialization:
+  doompi init              Fill missing files in ~/.pi/.doom
+  doompi sync              Update packages, build, resolve, and register DoomPi
+                            in Pi user settings
+  doompi sync --check      Exit non-zero when the synced config is out of date
+                            or report legacy repository-local state to migrate
+
+Sync artifacts live under ~/.pi/.doom/sync in a repository- and worktree-specific
+namespace. Linked worktrees isolate state, dist, manifests, resources, and run
+files while sharing immutable repository build objects. A legacy <repo>/.pi/doom
+state is read only when no global state exists; run doompi sync to migrate it.
+DoomPi never removes old or orphaned generated directories automatically.
+
+After a sync, run pi directly. The synced session accepts --major-mode,
+--domains, --profile, and --mute, and /mode, /domains, and /profile switch
+without a restart. Selection defaults come from the selection block in
+.doom/config.yaml.
+
+${COMPATIBILITY_MATRIX_OPTIONS}
+All other compatibility arguments pass to the provider unchanged.
+
+Harness options:
+  --major-mode <name>       Named major mode from .doom/modes.yaml
+                            (default: copilot). Not --mode: Pi owns that one.
+  --profile <name>          Persona and env from .doom/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, kimi, or ollama
+  --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
+  --mute                    Disable the notification extension for this run
+  --auto-stop               Exit interactive Pi when the agent settles
+  --sandbox                 Run the agent in the sandbox container a layer provides
+  --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, historyExportHelp, historyImportHelp, initHelp, printHelp, syncHelp };
+
+//# sourceMappingURL=help.mjs.map

package/dist/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';\nexport { historyExportHelp } from './commands/history-export/help';\nexport { historyImportHelp } from './commands/history-import/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/doompi/package.json';\n\nexport const HARNESS_VERSION = (require(PACKAGE_MANIFEST) as { version: string }).version;\n\nexport function printHelp(): void {\n  process.stdout.write(`doompi\n\nUsage: doompi [harness options] [Pi options] [prompt]\n       doompi init\n       doompi sync [matrix options] [--check]\n       doompi api-export --out <directory> [--major-mode <name>] [--strict]\n       doompi compat <codex|claude|antigravity> [matrix options] [provider arguments]\n       doompi history-export <v4-source> <v3-destination> [options]\n       doompi history-import <v3-source> <v4-destination> --confirm-offline\n\nInitialization:\n  doompi init              Fill missing files in ~/.pi/.doom\n  doompi sync              Update packages, build, resolve, and register DoomPi\n                            in Pi user settings\n  doompi sync --check      Exit non-zero when the synced config is out of date\n                            or report legacy repository-local state to migrate\n\nSync artifacts live under ~/.pi/.doom/sync in a repository- and worktree-specific\nnamespace. Linked worktrees isolate state, dist, manifests, resources, and run\nfiles while sharing immutable repository build objects. A legacy <repo>/.pi/doom\nstate is read only when no global state exists; run doompi sync to migrate it.\nDoomPi never removes old or orphaned generated directories automatically.\n\nAfter a sync, run pi directly. The synced session accepts --major-mode,\n--domains, --profile, and --mute, and /mode, /domains, and /profile switch\nwithout a restart. Selection defaults come from the selection block in\n.doom/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 .doom/modes.yaml\n                            (default: copilot). Not --mode: Pi owns that one.\n  --profile <name>          Persona and env from .doom/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, kimi, or ollama\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  --mute                    Disable the notification extension for this run\n  --auto-stop               Exit interactive Pi when the agent settles\n  --sandbox                 Run the agent in the sandbox container a layer provides\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":";;;;;;;AAeA,MAAa,kBAHG,cAAc,YAAY,GAGV,CAAA,CAAQ,gCAAgB,CAAC,CAAyB;AAElF,SAAgB,YAAkB;CAChC,QAAQ,OAAO,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4BrB,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwC9B;AACD"}

package/dist/cli/matrixOptions.cjs

@@ -0,0 +1,178 @@
+const require_runtime = require("../_virtual/_rolldown/runtime.cjs");
+let node_path = require("node:path");
+node_path = require_runtime.__toESM(node_path, 1);
+//#region src/cli/matrixOptions.ts
+/**
+* Matrix selection shared by the Pi and compatibility parsers.
+*
+* Both frontends pick the same three axes (profile, domains, major mode) out of
+* the same environment variables with the same defaults. They used to hold two
+* copies of that logic, and the copies drifted: the inline `--name=value` forms
+* and the strict value reader existed in the compatibility parser only, so
+* `./pi.sh --profile=x` silently forwarded an unknown flag to Pi. One copy here
+* is what keeps them honest.
+*/
+/**
+* One variable per axis.
+*
+* These used to come in pairs, `DOOM_PI_*` for what the caller selected and
+* `DOOMPI_*` for what the harness resolved and published, with the second
+* outranking the first. A nested run still inherits its launcher's choice under
+* one name, because the launcher projects into the child environment and
+* overwrites the same key. Two names for one value only ever meant two ways to
+* disagree.
+*/
+const DOOMPI_PROFILE_ENV = "DOOMPI_PROFILE";
+const DOOMPI_DOMAINS_ENV = "DOOMPI_DOMAINS";
+const DOOMPI_MAJOR_MODE_ENV = "DOOMPI_MAJOR_MODE";
+const DOOMPI_ADDITIONAL_DIRECTORIES_ENV = "DOOMPI_ADDITIONAL_DIRS";
+const DOOMPI_PRESET_ENV = "DOOMPI_PRESET";
+/** Removed spelling of the major mode axis, reported rather than honored. */
+const REMOVED_DOOMPI_LAYER_ENV = "DOOMPI_LAYER";
+/**
+* The whole retired namespace, reported rather than ignored.
+*
+* A prefix scan rather than a constant per variable: there were 28 of them, and
+* a list maintained by hand is a list that misses one. A stale
+* `export AGENT_HARNESS_MAJOR_MODE=dev` in a shell profile would otherwise
+* silently start the session on `copilot`.
+*/
+const RETIRED_ENV_PREFIX = "AGENT_HARNESS_";
+const CURRENT_ENV_PREFIX = "DOOMPI_";
+const PROFILE_OPTION = "--profile";
+const DOMAIN_OPTION = "--domain";
+const DOMAINS_OPTION = "--domains";
+/**
+* The major mode flag.
+*
+* Not `--mode`: Pi owns that one for its output mode, and for a value outside
+* `text|json|rpc` it consumes both tokens and ignores them without a
+* diagnostic. A synced `pi --mode dev` would have failed silently.
+*/
+const MAJOR_MODE_OPTION = "--major-mode";
+const ADD_DIRECTORY_OPTION = "--add-dir";
+const REMOVED_LAYER_OPTION = "--layer";
+const REMOVED_LAYERS_OPTION = "--layers";
+const REMOVED_TARGET_OPTION = "--target";
+const DEFAULT_MAJOR_MODE = "copilot";
+const DEFAULT_DOMAIN = "default";
+const CSV_DELIMITER = ",";
+const OPTION_PREFIX = "--";
+/**
+* Reads `--name value` or `--name=value`, returning undefined for anything else.
+*
+* A value starting with `--` is rejected rather than consumed, so
+* `--profile --explain` reports a missing value instead of swallowing the next
+* flag. In compatibility mode this is also what stops the `--` provider
+* delimiter being taken as a matrix value.
+*/
+function readOption(args, index, name) {
+	const arg = args[index];
+	if (arg === name) {
+		const value = args[index + 1];
+		if (!value || value.startsWith(OPTION_PREFIX)) throw new Error(`${name} requires a value`);
+		return {
+			value,
+			nextIndex: index + 1,
+			inline: false
+		};
+	}
+	const inlinePrefix = `${name}=`;
+	if (!arg.startsWith(inlinePrefix)) return void 0;
+	const value = arg.slice(inlinePrefix.length);
+	if (!value) throw new Error(`${name} requires a value`);
+	return {
+		value,
+		nextIndex: index,
+		inline: true
+	};
+}
+/** Matches `--name` or `--name=value`, for reporting options that were removed. */
+function matchesOption(arg, name) {
+	return arg === name || arg.startsWith(`${name}=`);
+}
+function parseCsv(value) {
+	return value.split(CSV_DELIMITER).map((item) => item.trim()).filter(Boolean);
+}
+function parseRequiredCsv(value, option) {
+	const values = parseCsv(value);
+	if (values.length === 0) throw new Error(`${option} requires a value`);
+	return values;
+}
+function parseMajorMode(value, source) {
+	const majorMode = value.trim();
+	if (!majorMode) throw new Error(`${source} requires a value`);
+	if (majorMode.includes(CSV_DELIMITER)) throw new Error(`${source} accepts one major mode name`);
+	return majorMode;
+}
+function parseProfileValue(value, source) {
+	if (value.includes(CSV_DELIMITER)) throw new Error(`${source} accepts one profile name`);
+	if (!value.trim()) throw new Error(`${source} requires a value`);
+	return value;
+}
+/**
+* Reports any variable left over from the retired `AGENT_HARNESS_*` namespace.
+*
+* Called before anything reads the environment, so a stale export fails the
+* session instead of being quietly outvoted by a default. Both prefixes are
+* built from the constants above rather than written inline, because a
+* search-and-replace over this repository is exactly what retired the old one.
+*/
+function assertNoRetiredEnvironment(environment) {
+	const stale = Object.keys(environment).filter((key) => key.startsWith(RETIRED_ENV_PREFIX)).sort();
+	if (stale.length === 0) return;
+	const replacements = stale.map((key) => `${key} -> ${CURRENT_ENV_PREFIX}${key.slice(14)}`);
+	throw new Error(`The ${RETIRED_ENV_PREFIX}* environment was replaced by ${CURRENT_ENV_PREFIX}*. Unset or rename: ${replacements.join(", ")}`);
+}
+/**
+* The major mode a nested run inherits from its launcher, or the default.
+*
+* The removed spelling throws rather than being ignored. A stale
+* `export DOOMPI_LAYER=dev` left in a shell profile would otherwise silently
+* select `copilot`, which is the exact confusion the rename removed.
+*/
+function resolveInheritedMajorMode(environment, defaultMajorMode = DEFAULT_MAJOR_MODE) {
+	assertNoRetiredEnvironment(environment);
+	if (environment["DOOMPI_LAYER"]) throw new Error(`${REMOVED_DOOMPI_LAYER_ENV} was replaced by ${DOOMPI_MAJOR_MODE_ENV}`);
+	const inherited = environment[DOOMPI_MAJOR_MODE_ENV];
+	return parseMajorMode(inherited || defaultMajorMode, inherited ? DOOMPI_MAJOR_MODE_ENV : "defaultMajorMode");
+}
+/** The profile a run inherits from its environment, validated once up front. */
+function resolveInheritedProfile(environment) {
+	const inherited = environment["DOOMPI_PROFILE"] || void 0;
+	if (inherited?.includes(CSV_DELIMITER)) throw new Error(`${DOOMPI_PROFILE_ENV} accepts one profile name`);
+	return inherited;
+}
+/** Directories inherited from the launcher environment. */
+function resolveAdditionalDirectories(environment, baseDirectory) {
+	return (environment["DOOMPI_ADDITIONAL_DIRS"] ?? "").split(node_path.default.delimiter).filter(Boolean).map((directory) => node_path.default.resolve(baseDirectory, directory));
+}
+//#endregion
+exports.ADD_DIRECTORY_OPTION = ADD_DIRECTORY_OPTION;
+exports.DEFAULT_DOMAIN = DEFAULT_DOMAIN;
+exports.DEFAULT_MAJOR_MODE = DEFAULT_MAJOR_MODE;
+exports.DOMAINS_OPTION = DOMAINS_OPTION;
+exports.DOMAIN_OPTION = DOMAIN_OPTION;
+exports.DOOMPI_ADDITIONAL_DIRECTORIES_ENV = DOOMPI_ADDITIONAL_DIRECTORIES_ENV;
+exports.DOOMPI_DOMAINS_ENV = DOOMPI_DOMAINS_ENV;
+exports.DOOMPI_MAJOR_MODE_ENV = DOOMPI_MAJOR_MODE_ENV;
+exports.DOOMPI_PRESET_ENV = DOOMPI_PRESET_ENV;
+exports.DOOMPI_PROFILE_ENV = DOOMPI_PROFILE_ENV;
+exports.MAJOR_MODE_OPTION = MAJOR_MODE_OPTION;
+exports.PROFILE_OPTION = PROFILE_OPTION;
+exports.REMOVED_DOOMPI_LAYER_ENV = REMOVED_DOOMPI_LAYER_ENV;
+exports.REMOVED_LAYERS_OPTION = REMOVED_LAYERS_OPTION;
+exports.REMOVED_LAYER_OPTION = REMOVED_LAYER_OPTION;
+exports.REMOVED_TARGET_OPTION = REMOVED_TARGET_OPTION;
+exports.assertNoRetiredEnvironment = assertNoRetiredEnvironment;
+exports.matchesOption = matchesOption;
+exports.parseCsv = parseCsv;
+exports.parseMajorMode = parseMajorMode;
+exports.parseProfileValue = parseProfileValue;
+exports.parseRequiredCsv = parseRequiredCsv;
+exports.readOption = readOption;
+exports.resolveAdditionalDirectories = resolveAdditionalDirectories;
+exports.resolveInheritedMajorMode = resolveInheritedMajorMode;
+exports.resolveInheritedProfile = resolveInheritedProfile;
+
+//# sourceMappingURL=matrixOptions.cjs.map

package/dist/cli/matrixOptions.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"matrixOptions.cjs","names":["path"],"sources":["../../src/cli/matrixOptions.ts"],"sourcesContent":["import path from 'node:path';\n\n/**\n * Matrix selection shared by the Pi and compatibility parsers.\n *\n * Both frontends pick the same three axes (profile, domains, major mode) out of\n * the same environment variables with the same defaults. They used to hold two\n * copies of that logic, and the copies drifted: the inline `--name=value` forms\n * and the strict value reader existed in the compatibility parser only, so\n * `./pi.sh --profile=x` silently forwarded an unknown flag to Pi. One copy here\n * is what keeps them honest.\n */\n\n/**\n * One variable per axis.\n *\n * These used to come in pairs, `DOOM_PI_*` for what the caller selected and\n * `DOOMPI_*` for what the harness resolved and published, with the second\n * outranking the first. A nested run still inherits its launcher's choice under\n * one name, because the launcher projects into the child environment and\n * overwrites the same key. Two names for one value only ever meant two ways to\n * disagree.\n */\nexport const DOOMPI_PROFILE_ENV = 'DOOMPI_PROFILE';\nexport const DOOMPI_DOMAINS_ENV = 'DOOMPI_DOMAINS';\nexport const DOOMPI_MAJOR_MODE_ENV = 'DOOMPI_MAJOR_MODE';\nexport const DOOMPI_ADDITIONAL_DIRECTORIES_ENV = 'DOOMPI_ADDITIONAL_DIRS';\nexport const DOOMPI_PRESET_ENV = 'DOOMPI_PRESET';\n\n/** Removed spelling of the major mode axis, reported rather than honored. */\nexport const REMOVED_DOOMPI_LAYER_ENV = 'DOOMPI_LAYER';\n\n/**\n * The whole retired namespace, reported rather than ignored.\n *\n * A prefix scan rather than a constant per variable: there were 28 of them, and\n * a list maintained by hand is a list that misses one. A stale\n * `export AGENT_HARNESS_MAJOR_MODE=dev` in a shell profile would otherwise\n * silently start the session on `copilot`.\n */\nconst RETIRED_ENV_PREFIX = 'AGENT_HARNESS_';\nconst CURRENT_ENV_PREFIX = 'DOOMPI_';\n\nexport const PROFILE_OPTION = '--profile';\nexport const DOMAIN_OPTION = '--domain';\nexport const DOMAINS_OPTION = '--domains';\n/**\n * The major mode flag.\n *\n * Not `--mode`: Pi owns that one for its output mode, and for a value outside\n * `text|json|rpc` it consumes both tokens and ignores them without a\n * diagnostic. A synced `pi --mode dev` would have failed silently.\n */\nexport const MAJOR_MODE_OPTION = '--major-mode';\nexport const ADD_DIRECTORY_OPTION = '--add-dir';\nexport const REMOVED_LAYER_OPTION = '--layer';\nexport const REMOVED_LAYERS_OPTION = '--layers';\nexport const REMOVED_TARGET_OPTION = '--target';\n\nexport const DEFAULT_MAJOR_MODE = 'copilot';\nexport const DEFAULT_DOMAIN = 'default';\n\nconst CSV_DELIMITER = ',';\nconst OPTION_PREFIX = '--';\n\nexport interface OptionMatch {\n  value: string;\n  /** Index of the last argument consumed, for the caller's loop cursor. */\n  nextIndex: number;\n  /** True for `--name=value`. Callers that re-emit an option preserve the form. */\n  inline: boolean;\n}\n\n/**\n * Reads `--name value` or `--name=value`, returning undefined for anything else.\n *\n * A value starting with `--` is rejected rather than consumed, so\n * `--profile --explain` reports a missing value instead of swallowing the next\n * flag. In compatibility mode this is also what stops the `--` provider\n * delimiter being taken as a matrix value.\n */\nexport function readOption(args: string[], index: number, name: string): OptionMatch | undefined {\n  // Callers walk `args` by index, so this is always in range.\n  const arg = args[index]!;\n  if (arg === name) {\n    const value = args[index + 1];\n    if (!value || value.startsWith(OPTION_PREFIX)) throw new Error(`${name} requires a value`);\n    return { value, nextIndex: index + 1, inline: false };\n  }\n  const inlinePrefix = `${name}=`;\n  if (!arg.startsWith(inlinePrefix)) return undefined;\n  const value = arg.slice(inlinePrefix.length);\n  if (!value) throw new Error(`${name} requires a value`);\n  return { value, nextIndex: index, inline: true };\n}\n\n/** Matches `--name` or `--name=value`, for reporting options that were removed. */\nexport function matchesOption(arg: string, name: string): boolean {\n  return arg === name || arg.startsWith(`${name}=`);\n}\n\nexport function parseCsv(value: string): string[] {\n  return value\n    .split(CSV_DELIMITER)\n    .map((item) => item.trim())\n    .filter(Boolean);\n}\n\nexport function parseRequiredCsv(value: string, option: string): string[] {\n  const values = parseCsv(value);\n  if (values.length === 0) throw new Error(`${option} requires a value`);\n  return values;\n}\n\nexport function parseMajorMode(value: string, source: string): string {\n  const majorMode = value.trim();\n  if (!majorMode) throw new Error(`${source} requires a value`);\n  if (majorMode.includes(CSV_DELIMITER)) throw new Error(`${source} accepts one major mode name`);\n  return majorMode;\n}\n\nexport function parseProfileValue(value: string, source: string): string {\n  if (value.includes(CSV_DELIMITER)) throw new Error(`${source} accepts one profile name`);\n  if (!value.trim()) throw new Error(`${source} requires a value`);\n  return value;\n}\n\n/**\n * Reports any variable left over from the retired `AGENT_HARNESS_*` namespace.\n *\n * Called before anything reads the environment, so a stale export fails the\n * session instead of being quietly outvoted by a default. Both prefixes are\n * built from the constants above rather than written inline, because a\n * search-and-replace over this repository is exactly what retired the old one.\n */\nexport function assertNoRetiredEnvironment(environment: NodeJS.ProcessEnv): void {\n  const stale = Object.keys(environment)\n    .filter((key) => key.startsWith(RETIRED_ENV_PREFIX))\n    .sort();\n  if (stale.length === 0) return;\n  const replacements = stale.map((key) => `${key} -> ${CURRENT_ENV_PREFIX}${key.slice(RETIRED_ENV_PREFIX.length)}`);\n  throw new Error(\n    `The ${RETIRED_ENV_PREFIX}* environment was replaced by ${CURRENT_ENV_PREFIX}*. Unset or rename: ${replacements.join(', ')}`,\n  );\n}\n\n/**\n * The major mode a nested run inherits from its launcher, or the default.\n *\n * The removed spelling throws rather than being ignored. A stale\n * `export DOOMPI_LAYER=dev` left in a shell profile would otherwise silently\n * select `copilot`, which is the exact confusion the rename removed.\n */\nexport function resolveInheritedMajorMode(\n  environment: NodeJS.ProcessEnv,\n  defaultMajorMode: string = DEFAULT_MAJOR_MODE,\n): string {\n  assertNoRetiredEnvironment(environment);\n  if (environment[REMOVED_DOOMPI_LAYER_ENV]) {\n    throw new Error(`${REMOVED_DOOMPI_LAYER_ENV} was replaced by ${DOOMPI_MAJOR_MODE_ENV}`);\n  }\n  const inherited = environment[DOOMPI_MAJOR_MODE_ENV];\n  return parseMajorMode(inherited || defaultMajorMode, inherited ? DOOMPI_MAJOR_MODE_ENV : 'defaultMajorMode');\n}\n\n/** The profile a run inherits from its environment, validated once up front. */\nexport function resolveInheritedProfile(environment: NodeJS.ProcessEnv): string | undefined {\n  const inherited = environment[DOOMPI_PROFILE_ENV] || undefined;\n  if (inherited?.includes(CSV_DELIMITER)) throw new Error(`${DOOMPI_PROFILE_ENV} accepts one profile name`);\n  return inherited;\n}\n\n/** Directories inherited from the launcher environment. */\nexport function resolveAdditionalDirectories(environment: NodeJS.ProcessEnv, baseDirectory: string): string[] {\n  return (environment[DOOMPI_ADDITIONAL_DIRECTORIES_ENV] ?? '')\n    .split(path.delimiter)\n    .filter(Boolean)\n    .map((directory) => path.resolve(baseDirectory, directory));\n}\n"],"mappings":"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"}

package/dist/cli/matrixOptions.d.cts

@@ -0,0 +1,90 @@
+//#region src/cli/matrixOptions.d.ts
+/**
+ * Matrix selection shared by the Pi and compatibility parsers.
+ *
+ * Both frontends pick the same three axes (profile, domains, major mode) out of
+ * the same environment variables with the same defaults. They used to hold two
+ * copies of that logic, and the copies drifted: the inline `--name=value` forms
+ * and the strict value reader existed in the compatibility parser only, so
+ * `./pi.sh --profile=x` silently forwarded an unknown flag to Pi. One copy here
+ * is what keeps them honest.
+ */
+/**
+ * One variable per axis.
+ *
+ * These used to come in pairs, `DOOM_PI_*` for what the caller selected and
+ * `DOOMPI_*` for what the harness resolved and published, with the second
+ * outranking the first. A nested run still inherits its launcher's choice under
+ * one name, because the launcher projects into the child environment and
+ * overwrites the same key. Two names for one value only ever meant two ways to
+ * disagree.
+ */
+export declare const DOOMPI_PROFILE_ENV = "DOOMPI_PROFILE";
+export declare const DOOMPI_DOMAINS_ENV = "DOOMPI_DOMAINS";
+export declare const DOOMPI_MAJOR_MODE_ENV = "DOOMPI_MAJOR_MODE";
+export declare const DOOMPI_ADDITIONAL_DIRECTORIES_ENV = "DOOMPI_ADDITIONAL_DIRS";
+export declare const DOOMPI_PRESET_ENV = "DOOMPI_PRESET";
+/** Removed spelling of the major mode axis, reported rather than honored. */
+export declare const REMOVED_DOOMPI_LAYER_ENV = "DOOMPI_LAYER";
+export declare const PROFILE_OPTION = "--profile";
+export declare const DOMAIN_OPTION = "--domain";
+export declare const DOMAINS_OPTION = "--domains";
+/**
+ * The major mode flag.
+ *
+ * Not `--mode`: Pi owns that one for its output mode, and for a value outside
+ * `text|json|rpc` it consumes both tokens and ignores them without a
+ * diagnostic. A synced `pi --mode dev` would have failed silently.
+ */
+export declare const MAJOR_MODE_OPTION = "--major-mode";
+export declare const ADD_DIRECTORY_OPTION = "--add-dir";
+export declare const REMOVED_LAYER_OPTION = "--layer";
+export declare const REMOVED_LAYERS_OPTION = "--layers";
+export declare const REMOVED_TARGET_OPTION = "--target";
+export declare const DEFAULT_MAJOR_MODE = "copilot";
+export declare const DEFAULT_DOMAIN = "default";
+export interface OptionMatch {
+  value: string;
+  /** Index of the last argument consumed, for the caller's loop cursor. */
+  nextIndex: number;
+  /** True for `--name=value`. Callers that re-emit an option preserve the form. */
+  inline: boolean;
+}
+/**
+ * Reads `--name value` or `--name=value`, returning undefined for anything else.
+ *
+ * A value starting with `--` is rejected rather than consumed, so
+ * `--profile --explain` reports a missing value instead of swallowing the next
+ * flag. In compatibility mode this is also what stops the `--` provider
+ * delimiter being taken as a matrix value.
+ */
+export declare function readOption(args: string[], index: number, name: string): OptionMatch | undefined;
+/** Matches `--name` or `--name=value`, for reporting options that were removed. */
+export declare function matchesOption(arg: string, name: string): boolean;
+export declare function parseCsv(value: string): string[];
+export declare function parseRequiredCsv(value: string, option: string): string[];
+export declare function parseMajorMode(value: string, source: string): string;
+export declare function parseProfileValue(value: string, source: string): string;
+/**
+ * Reports any variable left over from the retired `AGENT_HARNESS_*` namespace.
+ *
+ * Called before anything reads the environment, so a stale export fails the
+ * session instead of being quietly outvoted by a default. Both prefixes are
+ * built from the constants above rather than written inline, because a
+ * search-and-replace over this repository is exactly what retired the old one.
+ */
+export declare function assertNoRetiredEnvironment(environment: NodeJS.ProcessEnv): void;
+/**
+ * The major mode a nested run inherits from its launcher, or the default.
+ *
+ * The removed spelling throws rather than being ignored. A stale
+ * `export DOOMPI_LAYER=dev` left in a shell profile would otherwise silently
+ * select `copilot`, which is the exact confusion the rename removed.
+ */
+export declare function resolveInheritedMajorMode(environment: NodeJS.ProcessEnv, defaultMajorMode?: string): string;
+/** The profile a run inherits from its environment, validated once up front. */
+export declare function resolveInheritedProfile(environment: NodeJS.ProcessEnv): string | undefined;
+/** Directories inherited from the launcher environment. */
+export declare function resolveAdditionalDirectories(environment: NodeJS.ProcessEnv, baseDirectory: string): string[];
+//#endregion
+//# sourceMappingURL=matrixOptions.d.cts.map

package/dist/cli/matrixOptions.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matrixOptions.d.cts","names":[],"sources":["../../src/cli/matrixOptions.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;qBAuBa;qBACA;qBACA;qBACA;qBACA;;qBAGA;qBAaA;qBACA;qBACA;;;;;;;;qBAQA;qBACA;qBACA;qBACA;qBACA;qBAEA;qBACA;iBAKI;EACf;;EAEA;;EAEA;;;;;;;;;;wBAWc,WAAW,gBAAgB,eAAe,eAAe;;wBAgBzD,cAAc,aAAa;wBAI3B,SAAS;wBAOT,iBAAiB,eAAe;wBAMhC,eAAe,eAAe;wBAO9B,kBAAkB,eAAe;;;;;;;;;wBAcjC,2BAA2B,aAAa,OAAO;;;;;;;;wBAkB/C,0BACd,aAAa,OAAO,YACpB;;wBAWc,wBAAwB,aAAa,OAAO;;wBAO5C,6BAA6B,aAAa,OAAO,YAAY"}

package/dist/cli/matrixOptions.d.mts

@@ -0,0 +1,90 @@
+//#region src/cli/matrixOptions.d.ts
+/**
+ * Matrix selection shared by the Pi and compatibility parsers.
+ *
+ * Both frontends pick the same three axes (profile, domains, major mode) out of
+ * the same environment variables with the same defaults. They used to hold two
+ * copies of that logic, and the copies drifted: the inline `--name=value` forms
+ * and the strict value reader existed in the compatibility parser only, so
+ * `./pi.sh --profile=x` silently forwarded an unknown flag to Pi. One copy here
+ * is what keeps them honest.
+ */
+/**
+ * One variable per axis.
+ *
+ * These used to come in pairs, `DOOM_PI_*` for what the caller selected and
+ * `DOOMPI_*` for what the harness resolved and published, with the second
+ * outranking the first. A nested run still inherits its launcher's choice under
+ * one name, because the launcher projects into the child environment and
+ * overwrites the same key. Two names for one value only ever meant two ways to
+ * disagree.
+ */
+export declare const DOOMPI_PROFILE_ENV = "DOOMPI_PROFILE";
+export declare const DOOMPI_DOMAINS_ENV = "DOOMPI_DOMAINS";
+export declare const DOOMPI_MAJOR_MODE_ENV = "DOOMPI_MAJOR_MODE";
+export declare const DOOMPI_ADDITIONAL_DIRECTORIES_ENV = "DOOMPI_ADDITIONAL_DIRS";
+export declare const DOOMPI_PRESET_ENV = "DOOMPI_PRESET";
+/** Removed spelling of the major mode axis, reported rather than honored. */
+export declare const REMOVED_DOOMPI_LAYER_ENV = "DOOMPI_LAYER";
+export declare const PROFILE_OPTION = "--profile";
+export declare const DOMAIN_OPTION = "--domain";
+export declare const DOMAINS_OPTION = "--domains";
+/**
+ * The major mode flag.
+ *
+ * Not `--mode`: Pi owns that one for its output mode, and for a value outside
+ * `text|json|rpc` it consumes both tokens and ignores them without a
+ * diagnostic. A synced `pi --mode dev` would have failed silently.
+ */
+export declare const MAJOR_MODE_OPTION = "--major-mode";
+export declare const ADD_DIRECTORY_OPTION = "--add-dir";
+export declare const REMOVED_LAYER_OPTION = "--layer";
+export declare const REMOVED_LAYERS_OPTION = "--layers";
+export declare const REMOVED_TARGET_OPTION = "--target";
+export declare const DEFAULT_MAJOR_MODE = "copilot";
+export declare const DEFAULT_DOMAIN = "default";
+export interface OptionMatch {
+  value: string;
+  /** Index of the last argument consumed, for the caller's loop cursor. */
+  nextIndex: number;
+  /** True for `--name=value`. Callers that re-emit an option preserve the form. */
+  inline: boolean;
+}
+/**
+ * Reads `--name value` or `--name=value`, returning undefined for anything else.
+ *
+ * A value starting with `--` is rejected rather than consumed, so
+ * `--profile --explain` reports a missing value instead of swallowing the next
+ * flag. In compatibility mode this is also what stops the `--` provider
+ * delimiter being taken as a matrix value.
+ */
+export declare function readOption(args: string[], index: number, name: string): OptionMatch | undefined;
+/** Matches `--name` or `--name=value`, for reporting options that were removed. */
+export declare function matchesOption(arg: string, name: string): boolean;
+export declare function parseCsv(value: string): string[];
+export declare function parseRequiredCsv(value: string, option: string): string[];
+export declare function parseMajorMode(value: string, source: string): string;
+export declare function parseProfileValue(value: string, source: string): string;
+/**
+ * Reports any variable left over from the retired `AGENT_HARNESS_*` namespace.
+ *
+ * Called before anything reads the environment, so a stale export fails the
+ * session instead of being quietly outvoted by a default. Both prefixes are
+ * built from the constants above rather than written inline, because a
+ * search-and-replace over this repository is exactly what retired the old one.
+ */
+export declare function assertNoRetiredEnvironment(environment: NodeJS.ProcessEnv): void;
+/**
+ * The major mode a nested run inherits from its launcher, or the default.
+ *
+ * The removed spelling throws rather than being ignored. A stale
+ * `export DOOMPI_LAYER=dev` left in a shell profile would otherwise silently
+ * select `copilot`, which is the exact confusion the rename removed.
+ */
+export declare function resolveInheritedMajorMode(environment: NodeJS.ProcessEnv, defaultMajorMode?: string): string;
+/** The profile a run inherits from its environment, validated once up front. */
+export declare function resolveInheritedProfile(environment: NodeJS.ProcessEnv): string | undefined;
+/** Directories inherited from the launcher environment. */
+export declare function resolveAdditionalDirectories(environment: NodeJS.ProcessEnv, baseDirectory: string): string[];
+//#endregion
+//# sourceMappingURL=matrixOptions.d.mts.map

package/dist/cli/matrixOptions.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matrixOptions.d.mts","names":[],"sources":["../../src/cli/matrixOptions.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;qBAuBa;qBACA;qBACA;qBACA;qBACA;;qBAGA;qBAaA;qBACA;qBACA;;;;;;;;qBAQA;qBACA;qBACA;qBACA;qBACA;qBAEA;qBACA;iBAKI;EACf;;EAEA;;EAEA;;;;;;;;;;wBAWc,WAAW,gBAAgB,eAAe,eAAe;;wBAgBzD,cAAc,aAAa;wBAI3B,SAAS;wBAOT,iBAAiB,eAAe;wBAMhC,eAAe,eAAe;wBAO9B,kBAAkB,eAAe;;;;;;;;;wBAcjC,2BAA2B,aAAa,OAAO;;;;;;;;wBAkB/C,0BACd,aAAa,OAAO,YACpB;;wBAWc,wBAAwB,aAAa,OAAO;;wBAO5C,6BAA6B,aAAa,OAAO,YAAY"}

package/dist/cli/matrixOptions.mjs

@@ -0,0 +1,151 @@
+import path from "node:path";
+//#region src/cli/matrixOptions.ts
+/**
+* Matrix selection shared by the Pi and compatibility parsers.
+*
+* Both frontends pick the same three axes (profile, domains, major mode) out of
+* the same environment variables with the same defaults. They used to hold two
+* copies of that logic, and the copies drifted: the inline `--name=value` forms
+* and the strict value reader existed in the compatibility parser only, so
+* `./pi.sh --profile=x` silently forwarded an unknown flag to Pi. One copy here
+* is what keeps them honest.
+*/
+/**
+* One variable per axis.
+*
+* These used to come in pairs, `DOOM_PI_*` for what the caller selected and
+* `DOOMPI_*` for what the harness resolved and published, with the second
+* outranking the first. A nested run still inherits its launcher's choice under
+* one name, because the launcher projects into the child environment and
+* overwrites the same key. Two names for one value only ever meant two ways to
+* disagree.
+*/
+const DOOMPI_PROFILE_ENV = "DOOMPI_PROFILE";
+const DOOMPI_DOMAINS_ENV = "DOOMPI_DOMAINS";
+const DOOMPI_MAJOR_MODE_ENV = "DOOMPI_MAJOR_MODE";
+const DOOMPI_ADDITIONAL_DIRECTORIES_ENV = "DOOMPI_ADDITIONAL_DIRS";
+const DOOMPI_PRESET_ENV = "DOOMPI_PRESET";
+/** Removed spelling of the major mode axis, reported rather than honored. */
+const REMOVED_DOOMPI_LAYER_ENV = "DOOMPI_LAYER";
+/**
+* The whole retired namespace, reported rather than ignored.
+*
+* A prefix scan rather than a constant per variable: there were 28 of them, and
+* a list maintained by hand is a list that misses one. A stale
+* `export AGENT_HARNESS_MAJOR_MODE=dev` in a shell profile would otherwise
+* silently start the session on `copilot`.
+*/
+const RETIRED_ENV_PREFIX = "AGENT_HARNESS_";
+const CURRENT_ENV_PREFIX = "DOOMPI_";
+const PROFILE_OPTION = "--profile";
+const DOMAIN_OPTION = "--domain";
+const DOMAINS_OPTION = "--domains";
+/**
+* The major mode flag.
+*
+* Not `--mode`: Pi owns that one for its output mode, and for a value outside
+* `text|json|rpc` it consumes both tokens and ignores them without a
+* diagnostic. A synced `pi --mode dev` would have failed silently.
+*/
+const MAJOR_MODE_OPTION = "--major-mode";
+const ADD_DIRECTORY_OPTION = "--add-dir";
+const REMOVED_LAYER_OPTION = "--layer";
+const REMOVED_LAYERS_OPTION = "--layers";
+const REMOVED_TARGET_OPTION = "--target";
+const DEFAULT_MAJOR_MODE = "copilot";
+const DEFAULT_DOMAIN = "default";
+const CSV_DELIMITER = ",";
+const OPTION_PREFIX = "--";
+/**
+* Reads `--name value` or `--name=value`, returning undefined for anything else.
+*
+* A value starting with `--` is rejected rather than consumed, so
+* `--profile --explain` reports a missing value instead of swallowing the next
+* flag. In compatibility mode this is also what stops the `--` provider
+* delimiter being taken as a matrix value.
+*/
+function readOption(args, index, name) {
+	const arg = args[index];
+	if (arg === name) {
+		const value = args[index + 1];
+		if (!value || value.startsWith(OPTION_PREFIX)) throw new Error(`${name} requires a value`);
+		return {
+			value,
+			nextIndex: index + 1,
+			inline: false
+		};
+	}
+	const inlinePrefix = `${name}=`;
+	if (!arg.startsWith(inlinePrefix)) return void 0;
+	const value = arg.slice(inlinePrefix.length);
+	if (!value) throw new Error(`${name} requires a value`);
+	return {
+		value,
+		nextIndex: index,
+		inline: true
+	};
+}
+/** Matches `--name` or `--name=value`, for reporting options that were removed. */
+function matchesOption(arg, name) {
+	return arg === name || arg.startsWith(`${name}=`);
+}
+function parseCsv(value) {
+	return value.split(CSV_DELIMITER).map((item) => item.trim()).filter(Boolean);
+}
+function parseRequiredCsv(value, option) {
+	const values = parseCsv(value);
+	if (values.length === 0) throw new Error(`${option} requires a value`);
+	return values;
+}
+function parseMajorMode(value, source) {
+	const majorMode = value.trim();
+	if (!majorMode) throw new Error(`${source} requires a value`);
+	if (majorMode.includes(CSV_DELIMITER)) throw new Error(`${source} accepts one major mode name`);
+	return majorMode;
+}
+function parseProfileValue(value, source) {
+	if (value.includes(CSV_DELIMITER)) throw new Error(`${source} accepts one profile name`);
+	if (!value.trim()) throw new Error(`${source} requires a value`);
+	return value;
+}
+/**
+* Reports any variable left over from the retired `AGENT_HARNESS_*` namespace.
+*
+* Called before anything reads the environment, so a stale export fails the
+* session instead of being quietly outvoted by a default. Both prefixes are
+* built from the constants above rather than written inline, because a
+* search-and-replace over this repository is exactly what retired the old one.
+*/
+function assertNoRetiredEnvironment(environment) {
+	const stale = Object.keys(environment).filter((key) => key.startsWith(RETIRED_ENV_PREFIX)).sort();
+	if (stale.length === 0) return;
+	const replacements = stale.map((key) => `${key} -> ${CURRENT_ENV_PREFIX}${key.slice(14)}`);
+	throw new Error(`The ${RETIRED_ENV_PREFIX}* environment was replaced by ${CURRENT_ENV_PREFIX}*. Unset or rename: ${replacements.join(", ")}`);
+}
+/**
+* The major mode a nested run inherits from its launcher, or the default.
+*
+* The removed spelling throws rather than being ignored. A stale
+* `export DOOMPI_LAYER=dev` left in a shell profile would otherwise silently
+* select `copilot`, which is the exact confusion the rename removed.
+*/
+function resolveInheritedMajorMode(environment, defaultMajorMode = DEFAULT_MAJOR_MODE) {
+	assertNoRetiredEnvironment(environment);
+	if (environment["DOOMPI_LAYER"]) throw new Error(`${REMOVED_DOOMPI_LAYER_ENV} was replaced by ${DOOMPI_MAJOR_MODE_ENV}`);
+	const inherited = environment[DOOMPI_MAJOR_MODE_ENV];
+	return parseMajorMode(inherited || defaultMajorMode, inherited ? DOOMPI_MAJOR_MODE_ENV : "defaultMajorMode");
+}
+/** The profile a run inherits from its environment, validated once up front. */
+function resolveInheritedProfile(environment) {
+	const inherited = environment["DOOMPI_PROFILE"] || void 0;
+	if (inherited?.includes(CSV_DELIMITER)) throw new Error(`${DOOMPI_PROFILE_ENV} accepts one profile name`);
+	return inherited;
+}
+/** Directories inherited from the launcher environment. */
+function resolveAdditionalDirectories(environment, baseDirectory) {
+	return (environment["DOOMPI_ADDITIONAL_DIRS"] ?? "").split(path.delimiter).filter(Boolean).map((directory) => path.resolve(baseDirectory, directory));
+}
+//#endregion
+export { ADD_DIRECTORY_OPTION, DEFAULT_DOMAIN, DEFAULT_MAJOR_MODE, DOMAINS_OPTION, DOMAIN_OPTION, DOOMPI_ADDITIONAL_DIRECTORIES_ENV, DOOMPI_DOMAINS_ENV, DOOMPI_MAJOR_MODE_ENV, DOOMPI_PRESET_ENV, DOOMPI_PROFILE_ENV, MAJOR_MODE_OPTION, PROFILE_OPTION, REMOVED_DOOMPI_LAYER_ENV, REMOVED_LAYERS_OPTION, REMOVED_LAYER_OPTION, REMOVED_TARGET_OPTION, assertNoRetiredEnvironment, matchesOption, parseCsv, parseMajorMode, parseProfileValue, parseRequiredCsv, readOption, resolveAdditionalDirectories, resolveInheritedMajorMode, resolveInheritedProfile };
+
+//# sourceMappingURL=matrixOptions.mjs.map