@agimon-ai/po-config 0.0.0-alpha.0

package/dist/init-DJ6wm-dr.mjs

@@ -0,0 +1,415 @@
+import { t as globalDoomConfigDirectory } from "./config-CKA07FxG.mjs";
+import { randomUUID } from "node:crypto";
+import fs from "node:fs";
+import path from "node:path";
+import os from "node:os";
+//#region src/services/init/index.ts
+const PRIVATE_DIRECTORY_MODE = 448;
+const PRIVATE_FILE_MODE = 384;
+const REPOSITORY_DIRECTORY_MODE = 493;
+const REPOSITORY_FILE_MODE = 420;
+const DOOM_DIRECTORY = ".po";
+const UTF8_ENCODING = "utf8";
+const FILE_ALREADY_EXISTS = "EEXIST";
+const FILE_NOT_FOUND = "ENOENT";
+/** The global seed files are processed in this fixed order. */
+const GLOBAL_DOOM_SEED_FILES = [
+	"config.yaml",
+	"modes.yaml",
+	"domains.yaml",
+	"profiles.yaml"
+];
+/** Portable defaults for a new global Doom configuration directory. */
+const DOOM_CONFIG_TEMPLATES = {
+	"config.yaml": `projectTrust: ask
+
+# Autonomous voice is opt-in and uses an explicitly configured Pi model.
+# voice:
+#   autoCapture:
+#     model: provider/model-id
+#     startPhrases:
+#       - hey doom
+#     stopPhrases:
+#       - stop speaking
+#     utteranceIdleMs: 3000
+#     # Long prompts only: open a draft, keep talking, then send it in one piece.
+#     # Short utterances are delivered as you finish them and need no phrase.
+#     composeOpenPhrases:
+#       - hey doom
+#     composeSendPhrases:
+#       - that's it
+#     composeCancelPhrases:
+#       - scratch that
+#     # Endpoint window while a draft collects, so a short command lands on its own.
+#     composeUtteranceIdleMs: 1200
+#     # Silence before Voice reminds you a draft is open. 0 turns the reminder off.
+#     composeNudgeMs: 10000
+#     tts:
+#       engine: macos-say
+#       voice: Samantha
+#       rate: 190
+`,
+	"modes.yaml": `# A layer is a reusable named bundle of packages, built-in or local extensions,
+# and hook groups. Major modes below choose which layers load together for a session.
+#
+# Layers and modes defined here apply to every repository. A repository's own
+# .po/modes.yaml is read after this file and replaces any layer or mode of the
+# same name, so a repository can override one entry without restating the rest.
+#
+# Add a layer by giving it a unique name under layers. Local Pi scripts belong
+# under extensions, while installed Pi packages belong under packages:
+#   review-tools:
+#     extensions:
+#       - './extensions/local-review.ts'
+#     packages:
+#       - '@scope/review-extension'
+# A bare extension name selects a Po built-in. A path beginning with ./ or
+# ../ loads a custom script or extension directory. A bare package loads its
+# ordered package.json pi.extensions entries, while an exported subpath selects
+# one adapter. Relative paths resolve beside this file here (~/.po), or
+# from the repository root in .po/modes.yaml.
+#
+# Use a package mapping when that package accepts configuration. Configuration
+# belongs under the package entry that consumes it, not beside packages.
+# The top-level default bundle loads before every major mode. Replace this whole
+# packages list to customize the distribution defaults. Po core packages
+# remain active independently of this list.
+default:
+  packages:
+    - '@agimon-ai/po-help'
+    - '@agimon-ai/po-hook'
+    - '@agimon-ai/po-goal'
+    - '@agimon-ai/po-voice'
+    - '@agimon-ai/po-runner'
+    - '@agimon-ai/po-read'
+    - '@agimon-ai/po-grep'
+    - '@agimon-ai/po-edit'
+    - '@agimon-ai/po-file-edit'
+    - '@agimon-ai/po-autocompact'
+    - '@agimon-ai/po-loop'
+    - '@agimon-ai/po-plan'
+    - '@agimon-ai/po-workflow'
+    - '@agimon-ai/po-log'
+    - '@agimon-ai/po-mcp'
+    - '@agimon-ai/po-template-elegant'
+layers:
+  team:
+    packages:
+      - name: '@agimon-ai/po-team'
+        # Optional Team configuration. Uncomment and choose models available to Pi.
+        # config:
+        #   models:
+        #     - model: openai-codex/gpt-5.6-luna
+        #       thinking: xhigh
+        #   # Tool names excluded from subagents launched by this package. These
+        #   # remove model-visible tools while preserving hidden team transport.
+        #   excludeTools: [ask_user_question, intercom, subagent]
+  ask-user:
+    packages:
+      - '@agimon-ai/po-user-feedback'
+  task:
+    packages:
+      - '@agimon-ai/po-task'
+# A major mode explains when it should be used and names its ordered layers.
+# Add another entry under majorMode, then select it with
+# po --major-mode <name>. Change defaultMajorMode to make it the default.
+defaultMajorMode: copilot
+majorMode:
+  minimal:
+    description: Lean mode with Team delegation and persistent tasks.
+    layers: [team, task]
+  copilot:
+    description: General-purpose coding mode with Team delegation, persistent tasks, supervised commands, and structured user feedback.
+    layers: [team, ask-user, task]
+  # review:
+  #   description: Focused review mode for inspecting changes and reporting risks.
+  #   layers: [team, task, ask-user]
+`,
+	"domains.yaml": `# Plugins are named once in this catalog, then selected by one or more domains.
+# Po automatically inspects personal and repository Codex marketplaces.
+# Each configured root may also be a folder whose direct children are plugins;
+# use roots: [plugins] to discover a repository plugin folder without one entry
+# per plugin. Discovery never scans recursively.
+defaultDomains: [default]
+plugins:
+  roots: []
+  entries: {}
+  # Local paths resolve beside this file in ~/.po. Repository paths in a
+  # repository .po/domains.yaml resolve from that repository root.
+  # entries:
+  #   development:
+  #     source: local
+  #     path: plugins/development
+  #   remote-review:
+  #     source: url
+  #     url: https://github.com/acme/review-plugin.git
+  #     ref: v1.2.0
+  #   published-review:
+  #     source: npm
+  #     package: '@acme/review-plugin'
+  #     version: 1.2.0
+# Domains carry descriptions and refer to catalog names, not filesystem paths.
+domains:
+  default:
+    description: Shared skills and repository MCP only.
+    plugins: []
+  # development:
+  #   description: TypeScript implementation and review tools.
+  #   plugins:
+  #     - development
+  #     # Mapping form can load only selected resources from a shared plugin.
+  #     - name: remote-review
+  #       skills: [typescript]
+  #       agents: [reviewer]
+  #       hooks: false
+  #       mcp: true
+  #   # Set false only when this domain should omit shared .claude/skills.
+  #   sharedSkills: false
+  #   # Domain mcp is an allowlist over servers configured elsewhere, not a
+  #   # request to start new ones. Listing servers here drops the tool schemas
+  #   # of the ones left out, usually the largest context saving a domain can
+  #   # make. Run po --explain to see the token cost before and after.
+  #   # Filtering applies only when every selected domain declares mcp, so a
+  #   # selection mixing this with a domain that omits it stays unfiltered.
+  #   mcp:
+  #     servers: [code-intel]
+  #     proxy: [repository-search]
+# Select it with po --domains development, or add it to defaultDomains.
+#
+# Aliases let one selection enable multiple domains. Replace the empty mapping
+# below with entries like the commented example.
+aliases: {}
+# aliases:
+#   work: [default, development]
+`,
+	"profiles.yaml": `# Profiles select a persona and optional environment defaults for a session.
+# Each configured root may itself be a profile or contain direct-child profile
+# folders. A folder is discovered when it contains profile.md, SOUL.md, or
+# AGENTS.md; discovery never scans recursively.
+profiles:
+  roots: []
+  entries: {}
+  # Roots resolve beside this file in ~/.po. Repository roots in a
+  # repository .po/profiles.yaml resolve from that repository root.
+  # roots: [agents/acme]
+  # Explicit entries override an automatically discovered folder of the same
+  # name. Environment values must be strings; already exported values win.
+  # entries:
+  #   writer:
+  #     persona: agents/special/writer
+  #     env:
+  #       BRAND: acme
+  #       TONE: concise
+# Doom Pi concatenates profile.md, SOUL.md, then AGENTS.md for the persona.
+# Select one with: po --profile writer
+`
+};
+/** Standalone defaults for a repository that is trying Po through DPI. */
+const REPOSITORY_DOOM_CONFIG_TEMPLATES = {
+	"config.yaml": DOOM_CONFIG_TEMPLATES["config.yaml"],
+	"modes.yaml": `# Repository-local layers and major modes. These entries override personal
+# entries with the same name from ~/.po/modes.yaml.
+# This repository-local default replaces the personal top-level default as one
+# whole package list. Edit it to customize the standalone package baseline.
+default:
+  packages:
+    - '@agimon-ai/po-help'
+    - '@agimon-ai/po-hook'
+    - '@agimon-ai/po-goal'
+    - '@agimon-ai/po-voice'
+    - '@agimon-ai/po-runner'
+    - '@agimon-ai/po-read'
+    - '@agimon-ai/po-grep'
+    - '@agimon-ai/po-edit'
+    - '@agimon-ai/po-file-edit'
+    - '@agimon-ai/po-autocompact'
+    - '@agimon-ai/po-loop'
+    - '@agimon-ai/po-plan'
+    - '@agimon-ai/po-workflow'
+    - '@agimon-ai/po-log'
+    - '@agimon-ai/po-mcp'
+    - '@agimon-ai/po-template-elegant'
+layers:
+  team:
+    packages:
+      - name: '@agimon-ai/po-team'
+  ask-user:
+    packages:
+      - '@agimon-ai/po-user-feedback'
+  task:
+    packages:
+      - '@agimon-ai/po-task'
+defaultMajorMode: copilot
+majorMode:
+  minimal:
+    description: Lean mode with Team delegation and persistent tasks.
+    layers: [team, task]
+  copilot:
+    description: General-purpose coding mode with delegation, persistent tasks, supervised commands, and structured user feedback.
+    layers: [team, ask-user, task]
+`,
+	"domains.yaml": `# Repository-local plugin catalog and domain selection.
+defaultDomains: [default]
+plugins:
+  roots: []
+  entries: {}
+domains:
+  default:
+    description: Shared skills and repository MCP only.
+    plugins: []
+aliases: {}
+`,
+	"profiles.yaml": `# Repository-local persona roots and environment defaults.
+profiles:
+  roots: []
+  entries: {}
+`
+};
+function errorCode(error) {
+	if (!(error instanceof Error)) return void 0;
+	const code = error.code;
+	return typeof code === "string" ? code : void 0;
+}
+function ensureDirectory(directory, mode) {
+	let stats;
+	try {
+		stats = fs.lstatSync(directory);
+	} catch (error) {
+		if (errorCode(error) !== FILE_NOT_FOUND) throw error;
+		try {
+			fs.mkdirSync(directory, { mode });
+			stats = fs.lstatSync(directory);
+		} catch (mkdirError) {
+			if (errorCode(mkdirError) !== FILE_ALREADY_EXISTS) throw mkdirError;
+			stats = fs.lstatSync(directory);
+		}
+	}
+	if (stats.isSymbolicLink()) throw new Error(`Refusing to initialize through symlinked directory: ${directory}`);
+	if (!stats.isDirectory()) throw new Error(`Doom config path is not a directory: ${directory}`);
+}
+function ensureDoomDirectory(directory, mode) {
+	ensureDirectory(path.dirname(directory), mode);
+	ensureDirectory(directory, mode);
+}
+function classifyTarget(targetPath) {
+	let stats;
+	try {
+		stats = fs.lstatSync(targetPath);
+	} catch (error) {
+		if (errorCode(error) === FILE_NOT_FOUND) return "missing";
+		throw error;
+	}
+	if (stats.isFile()) return "file";
+	if (stats.isSymbolicLink()) try {
+		if (fs.statSync(targetPath).isFile()) return "file";
+	} catch (error) {
+		throw new Error(`Doom config seed symlink is not file-like: ${targetPath}`, { cause: error });
+	}
+	throw new Error(`Doom config seed path is not file-like: ${targetPath}`);
+}
+function cleanupTemporaryFile(temporaryPath) {
+	try {
+		fs.unlinkSync(temporaryPath);
+	} catch (error) {
+		if (errorCode(error) !== FILE_NOT_FOUND) throw error;
+	}
+}
+function publishExclusively(targetPath, content, mode) {
+	const temporaryPath = `${targetPath}.${process.pid}.${randomUUID()}.tmp`;
+	let fileDescriptor;
+	try {
+		fileDescriptor = fs.openSync(temporaryPath, "wx", mode);
+		fs.writeFileSync(fileDescriptor, content, UTF8_ENCODING);
+		fs.fchmodSync(fileDescriptor, mode);
+		fs.fsyncSync(fileDescriptor);
+		const descriptorToClose = fileDescriptor;
+		fileDescriptor = void 0;
+		fs.closeSync(descriptorToClose);
+		try {
+			fs.linkSync(temporaryPath, targetPath);
+			return true;
+		} catch (error) {
+			if (errorCode(error) === FILE_ALREADY_EXISTS && classifyTarget(targetPath) === "file") return false;
+			throw error;
+		}
+	} finally {
+		if (fileDescriptor !== void 0) {
+			const descriptorToClose = fileDescriptor;
+			fileDescriptor = void 0;
+			fs.closeSync(descriptorToClose);
+		}
+		cleanupTemporaryFile(temporaryPath);
+	}
+}
+/**
+* Replaces a seed file with the template, atomically.
+*
+* The rename swaps the directory entry in one step, so a reader either sees the
+* whole old file or the whole new one. Renaming onto a symlinked seed replaces
+* the link rather than writing through it.
+*/
+function publishForcefully(targetPath, content, mode) {
+	const temporaryPath = `${targetPath}.${process.pid}.${randomUUID()}.tmp`;
+	let fileDescriptor;
+	try {
+		fileDescriptor = fs.openSync(temporaryPath, "wx", mode);
+		fs.writeFileSync(fileDescriptor, content, UTF8_ENCODING);
+		fs.fchmodSync(fileDescriptor, mode);
+		fs.fsyncSync(fileDescriptor);
+		const descriptorToClose = fileDescriptor;
+		fileDescriptor = void 0;
+		fs.closeSync(descriptorToClose);
+		fs.renameSync(temporaryPath, targetPath);
+	} finally {
+		if (fileDescriptor !== void 0) {
+			const descriptorToClose = fileDescriptor;
+			fileDescriptor = void 0;
+			fs.closeSync(descriptorToClose);
+		}
+		cleanupTemporaryFile(temporaryPath);
+	}
+}
+function initializeDoomConfig(directory, templates, options, directoryMode, fileMode) {
+	ensureDoomDirectory(directory, directoryMode);
+	const created = [];
+	const preserved = [];
+	const replaced = [];
+	for (const fileName of GLOBAL_DOOM_SEED_FILES) {
+		const targetPath = path.join(directory, fileName);
+		const existed = classifyTarget(targetPath) === "file";
+		if (options.force) {
+			publishForcefully(targetPath, templates[fileName], fileMode);
+			(existed ? replaced : created).push(fileName);
+			continue;
+		}
+		if (existed) {
+			preserved.push(fileName);
+			continue;
+		}
+		if (publishExclusively(targetPath, templates[fileName], fileMode)) created.push(fileName);
+		else preserved.push(fileName);
+	}
+	return {
+		directory,
+		created,
+		preserved,
+		replaced
+	};
+}
+/**
+* Fills missing global seed files.
+*
+* Existing files are left alone so that re-running init never discards
+* hand-edited config; pass `force` to overwrite them from the template.
+*/
+function initializeGlobalDoomConfig(homeDirectory = os.homedir(), options = {}) {
+	return initializeDoomConfig(globalDoomConfigDirectory(homeDirectory), DOOM_CONFIG_TEMPLATES, options, PRIVATE_DIRECTORY_MODE, PRIVATE_FILE_MODE);
+}
+/** Seeds repository-local configuration without creating or changing Pi settings. */
+function initializeRepositoryDoomConfig(repositoryRoot = process.cwd(), options = {}) {
+	return initializeDoomConfig(path.join(path.resolve(repositoryRoot), DOOM_DIRECTORY), REPOSITORY_DOOM_CONFIG_TEMPLATES, options, REPOSITORY_DIRECTORY_MODE, REPOSITORY_FILE_MODE);
+}
+//#endregion
+export { initializeRepositoryDoomConfig as a, initializeGlobalDoomConfig as i, GLOBAL_DOOM_SEED_FILES as n, REPOSITORY_DOOM_CONFIG_TEMPLATES as r, DOOM_CONFIG_TEMPLATES as t };
+
+//# sourceMappingURL=init-DJ6wm-dr.mjs.map

package/dist/init-DJ6wm-dr.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-DJ6wm-dr.mjs","names":[],"sources":["../src/services/init/index.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport fs from 'node:fs';\nimport os from 'node:os';\nimport path from 'node:path';\n\nimport { globalDoomConfigDirectory } from '../config';\n\nconst PRIVATE_DIRECTORY_MODE = 0o700;\nconst PRIVATE_FILE_MODE = 0o600;\nconst REPOSITORY_DIRECTORY_MODE = 0o755;\nconst REPOSITORY_FILE_MODE = 0o644;\nconst DOOM_DIRECTORY = '.po';\nconst UTF8_ENCODING = 'utf8';\nconst FILE_ALREADY_EXISTS = 'EEXIST';\nconst FILE_NOT_FOUND = 'ENOENT';\n\n/** The global seed files are processed in this fixed order. */\nexport const GLOBAL_DOOM_SEED_FILES = ['config.yaml', 'modes.yaml', 'domains.yaml', 'profiles.yaml'] as const;\n\ntype DoomSeedFile = (typeof GLOBAL_DOOM_SEED_FILES)[number];\n\n/** Portable defaults for a new global Doom configuration directory. */\nexport const DOOM_CONFIG_TEMPLATES: Readonly<Record<DoomSeedFile, string>> = {\n  'config.yaml': `projectTrust: ask\n\n# Autonomous voice is opt-in and uses an explicitly configured Pi model.\n# voice:\n#   autoCapture:\n#     model: provider/model-id\n#     startPhrases:\n#       - hey doom\n#     stopPhrases:\n#       - stop speaking\n#     utteranceIdleMs: 3000\n#     # Long prompts only: open a draft, keep talking, then send it in one piece.\n#     # Short utterances are delivered as you finish them and need no phrase.\n#     composeOpenPhrases:\n#       - hey doom\n#     composeSendPhrases:\n#       - that's it\n#     composeCancelPhrases:\n#       - scratch that\n#     # Endpoint window while a draft collects, so a short command lands on its own.\n#     composeUtteranceIdleMs: 1200\n#     # Silence before Voice reminds you a draft is open. 0 turns the reminder off.\n#     composeNudgeMs: 10000\n#     tts:\n#       engine: macos-say\n#       voice: Samantha\n#       rate: 190\n`,\n  'modes.yaml': `# A layer is a reusable named bundle of packages, built-in or local extensions,\n# and hook groups. Major modes below choose which layers load together for a session.\n#\n# Layers and modes defined here apply to every repository. A repository's own\n# .po/modes.yaml is read after this file and replaces any layer or mode of the\n# same name, so a repository can override one entry without restating the rest.\n#\n# Add a layer by giving it a unique name under layers. Local Pi scripts belong\n# under extensions, while installed Pi packages belong under packages:\n#   review-tools:\n#     extensions:\n#       - './extensions/local-review.ts'\n#     packages:\n#       - '@scope/review-extension'\n# A bare extension name selects a Po built-in. A path beginning with ./ or\n# ../ loads a custom script or extension directory. A bare package loads its\n# ordered package.json pi.extensions entries, while an exported subpath selects\n# one adapter. Relative paths resolve beside this file here (~/.po), or\n# from the repository root in .po/modes.yaml.\n#\n# Use a package mapping when that package accepts configuration. Configuration\n# belongs under the package entry that consumes it, not beside packages.\n# The top-level default bundle loads before every major mode. Replace this whole\n# packages list to customize the distribution defaults. Po core packages\n# remain active independently of this list.\ndefault:\n  packages:\n    - '@agimon-ai/po-help'\n    - '@agimon-ai/po-hook'\n    - '@agimon-ai/po-goal'\n    - '@agimon-ai/po-voice'\n    - '@agimon-ai/po-runner'\n    - '@agimon-ai/po-read'\n    - '@agimon-ai/po-grep'\n    - '@agimon-ai/po-edit'\n    - '@agimon-ai/po-file-edit'\n    - '@agimon-ai/po-autocompact'\n    - '@agimon-ai/po-loop'\n    - '@agimon-ai/po-plan'\n    - '@agimon-ai/po-workflow'\n    - '@agimon-ai/po-log'\n    - '@agimon-ai/po-mcp'\n    - '@agimon-ai/po-template-elegant'\nlayers:\n  team:\n    packages:\n      - name: '@agimon-ai/po-team'\n        # Optional Team configuration. Uncomment and choose models available to Pi.\n        # config:\n        #   models:\n        #     - model: openai-codex/gpt-5.6-luna\n        #       thinking: xhigh\n        #   # Tool names excluded from subagents launched by this package. These\n        #   # remove model-visible tools while preserving hidden team transport.\n        #   excludeTools: [ask_user_question, intercom, subagent]\n  ask-user:\n    packages:\n      - '@agimon-ai/po-user-feedback'\n  task:\n    packages:\n      - '@agimon-ai/po-task'\n# A major mode explains when it should be used and names its ordered layers.\n# Add another entry under majorMode, then select it with\n# po --major-mode <name>. Change defaultMajorMode to make it the default.\ndefaultMajorMode: copilot\nmajorMode:\n  minimal:\n    description: Lean mode with Team delegation and persistent tasks.\n    layers: [team, task]\n  copilot:\n    description: General-purpose coding mode with Team delegation, persistent tasks, supervised commands, and structured user feedback.\n    layers: [team, ask-user, task]\n  # review:\n  #   description: Focused review mode for inspecting changes and reporting risks.\n  #   layers: [team, task, ask-user]\n`,\n  'domains.yaml': `# Plugins are named once in this catalog, then selected by one or more domains.\n# Po automatically inspects personal and repository Codex marketplaces.\n# Each configured root may also be a folder whose direct children are plugins;\n# use roots: [plugins] to discover a repository plugin folder without one entry\n# per plugin. Discovery never scans recursively.\ndefaultDomains: [default]\nplugins:\n  roots: []\n  entries: {}\n  # Local paths resolve beside this file in ~/.po. Repository paths in a\n  # repository .po/domains.yaml resolve from that repository root.\n  # entries:\n  #   development:\n  #     source: local\n  #     path: plugins/development\n  #   remote-review:\n  #     source: url\n  #     url: https://github.com/acme/review-plugin.git\n  #     ref: v1.2.0\n  #   published-review:\n  #     source: npm\n  #     package: '@acme/review-plugin'\n  #     version: 1.2.0\n# Domains carry descriptions and refer to catalog names, not filesystem paths.\ndomains:\n  default:\n    description: Shared skills and repository MCP only.\n    plugins: []\n  # development:\n  #   description: TypeScript implementation and review tools.\n  #   plugins:\n  #     - development\n  #     # Mapping form can load only selected resources from a shared plugin.\n  #     - name: remote-review\n  #       skills: [typescript]\n  #       agents: [reviewer]\n  #       hooks: false\n  #       mcp: true\n  #   # Set false only when this domain should omit shared .claude/skills.\n  #   sharedSkills: false\n  #   # Domain mcp is an allowlist over servers configured elsewhere, not a\n  #   # request to start new ones. Listing servers here drops the tool schemas\n  #   # of the ones left out, usually the largest context saving a domain can\n  #   # make. Run po --explain to see the token cost before and after.\n  #   # Filtering applies only when every selected domain declares mcp, so a\n  #   # selection mixing this with a domain that omits it stays unfiltered.\n  #   mcp:\n  #     servers: [code-intel]\n  #     proxy: [repository-search]\n# Select it with po --domains development, or add it to defaultDomains.\n#\n# Aliases let one selection enable multiple domains. Replace the empty mapping\n# below with entries like the commented example.\naliases: {}\n# aliases:\n#   work: [default, development]\n`,\n  'profiles.yaml': `# Profiles select a persona and optional environment defaults for a session.\n# Each configured root may itself be a profile or contain direct-child profile\n# folders. A folder is discovered when it contains profile.md, SOUL.md, or\n# AGENTS.md; discovery never scans recursively.\nprofiles:\n  roots: []\n  entries: {}\n  # Roots resolve beside this file in ~/.po. Repository roots in a\n  # repository .po/profiles.yaml resolve from that repository root.\n  # roots: [agents/acme]\n  # Explicit entries override an automatically discovered folder of the same\n  # name. Environment values must be strings; already exported values win.\n  # entries:\n  #   writer:\n  #     persona: agents/special/writer\n  #     env:\n  #       BRAND: acme\n  #       TONE: concise\n# Doom Pi concatenates profile.md, SOUL.md, then AGENTS.md for the persona.\n# Select one with: po --profile writer\n`,\n};\n\n/** Standalone defaults for a repository that is trying Po through DPI. */\nexport const REPOSITORY_DOOM_CONFIG_TEMPLATES: Readonly<Record<DoomSeedFile, string>> = {\n  'config.yaml': DOOM_CONFIG_TEMPLATES['config.yaml'],\n  'modes.yaml': `# Repository-local layers and major modes. These entries override personal\n# entries with the same name from ~/.po/modes.yaml.\n# This repository-local default replaces the personal top-level default as one\n# whole package list. Edit it to customize the standalone package baseline.\ndefault:\n  packages:\n    - '@agimon-ai/po-help'\n    - '@agimon-ai/po-hook'\n    - '@agimon-ai/po-goal'\n    - '@agimon-ai/po-voice'\n    - '@agimon-ai/po-runner'\n    - '@agimon-ai/po-read'\n    - '@agimon-ai/po-grep'\n    - '@agimon-ai/po-edit'\n    - '@agimon-ai/po-file-edit'\n    - '@agimon-ai/po-autocompact'\n    - '@agimon-ai/po-loop'\n    - '@agimon-ai/po-plan'\n    - '@agimon-ai/po-workflow'\n    - '@agimon-ai/po-log'\n    - '@agimon-ai/po-mcp'\n    - '@agimon-ai/po-template-elegant'\nlayers:\n  team:\n    packages:\n      - name: '@agimon-ai/po-team'\n  ask-user:\n    packages:\n      - '@agimon-ai/po-user-feedback'\n  task:\n    packages:\n      - '@agimon-ai/po-task'\ndefaultMajorMode: copilot\nmajorMode:\n  minimal:\n    description: Lean mode with Team delegation and persistent tasks.\n    layers: [team, task]\n  copilot:\n    description: General-purpose coding mode with delegation, persistent tasks, supervised commands, and structured user feedback.\n    layers: [team, ask-user, task]\n`,\n  'domains.yaml': `# Repository-local plugin catalog and domain selection.\ndefaultDomains: [default]\nplugins:\n  roots: []\n  entries: {}\ndomains:\n  default:\n    description: Shared skills and repository MCP only.\n    plugins: []\naliases: {}\n`,\n  'profiles.yaml': `# Repository-local persona roots and environment defaults.\nprofiles:\n  roots: []\n  entries: {}\n`,\n};\n\n/** Result of filling a Doom seed directory. File arrays contain names in seed order. */\nexport interface GlobalDoomInitResult {\n  directory: string;\n  created: string[];\n  preserved: string[];\n  /** Existing files overwritten from the template. Only ever non-empty under `force`. */\n  replaced: string[];\n}\n\nexport interface GlobalDoomInitOptions {\n  /**\n   * Overwrite existing seed files instead of preserving them.\n   *\n   * Off by default: init is safe to re-run, and hand-edited config is the\n   * normal case rather than the exception.\n   */\n  force?: boolean;\n}\n\nexport type RepositoryDoomInitOptions = GlobalDoomInitOptions;\nexport type RepositoryDoomInitResult = GlobalDoomInitResult;\n\nfunction errorCode(error: unknown): string | undefined {\n  if (!(error instanceof Error)) return undefined;\n  const code = (error as NodeJS.ErrnoException).code;\n  return typeof code === 'string' ? code : undefined;\n}\n\nfunction ensureDirectory(directory: string, mode: number): void {\n  let stats: fs.Stats;\n  try {\n    stats = fs.lstatSync(directory);\n  } catch (error) {\n    if (errorCode(error) !== FILE_NOT_FOUND) throw error;\n    try {\n      fs.mkdirSync(directory, { mode });\n      stats = fs.lstatSync(directory);\n    } catch (mkdirError) {\n      if (errorCode(mkdirError) !== FILE_ALREADY_EXISTS) throw mkdirError;\n      stats = fs.lstatSync(directory);\n    }\n  }\n\n  if (stats.isSymbolicLink()) {\n    throw new Error(`Refusing to initialize through symlinked directory: ${directory}`);\n  }\n  if (!stats.isDirectory()) {\n    throw new Error(`Doom config path is not a directory: ${directory}`);\n  }\n}\n\nfunction ensureDoomDirectory(directory: string, mode: number): void {\n  ensureDirectory(path.dirname(directory), mode);\n  ensureDirectory(directory, mode);\n}\n\nfunction classifyTarget(targetPath: string): 'missing' | 'file' {\n  let stats: fs.Stats;\n  try {\n    stats = fs.lstatSync(targetPath);\n  } catch (error) {\n    if (errorCode(error) === FILE_NOT_FOUND) return 'missing';\n    throw error;\n  }\n\n  if (stats.isFile()) return 'file';\n  if (stats.isSymbolicLink()) {\n    try {\n      if (fs.statSync(targetPath).isFile()) return 'file';\n    } catch (error) {\n      throw new Error(`Doom config seed symlink is not file-like: ${targetPath}`, { cause: error });\n    }\n  }\n  throw new Error(`Doom config seed path is not file-like: ${targetPath}`);\n}\n\nfunction cleanupTemporaryFile(temporaryPath: string): void {\n  try {\n    fs.unlinkSync(temporaryPath);\n  } catch (error) {\n    if (errorCode(error) !== FILE_NOT_FOUND) throw error;\n  }\n}\n\nfunction publishExclusively(targetPath: string, content: string, mode: number): boolean {\n  const temporaryPath = `${targetPath}.${process.pid}.${randomUUID()}.tmp`;\n  let fileDescriptor: number | undefined;\n  try {\n    fileDescriptor = fs.openSync(temporaryPath, 'wx', mode);\n    fs.writeFileSync(fileDescriptor, content, UTF8_ENCODING);\n    fs.fchmodSync(fileDescriptor, mode);\n    fs.fsyncSync(fileDescriptor);\n    const descriptorToClose = fileDescriptor;\n    fileDescriptor = undefined;\n    fs.closeSync(descriptorToClose);\n\n    try {\n      fs.linkSync(temporaryPath, targetPath);\n      return true;\n    } catch (error) {\n      if (errorCode(error) === FILE_ALREADY_EXISTS && classifyTarget(targetPath) === 'file') return false;\n      throw error;\n    }\n  } finally {\n    if (fileDescriptor !== undefined) {\n      const descriptorToClose = fileDescriptor;\n      fileDescriptor = undefined;\n      fs.closeSync(descriptorToClose);\n    }\n    cleanupTemporaryFile(temporaryPath);\n  }\n}\n\n/**\n * Replaces a seed file with the template, atomically.\n *\n * The rename swaps the directory entry in one step, so a reader either sees the\n * whole old file or the whole new one. Renaming onto a symlinked seed replaces\n * the link rather than writing through it.\n */\nfunction publishForcefully(targetPath: string, content: string, mode: number): void {\n  const temporaryPath = `${targetPath}.${process.pid}.${randomUUID()}.tmp`;\n  let fileDescriptor: number | undefined;\n  try {\n    fileDescriptor = fs.openSync(temporaryPath, 'wx', mode);\n    fs.writeFileSync(fileDescriptor, content, UTF8_ENCODING);\n    fs.fchmodSync(fileDescriptor, mode);\n    fs.fsyncSync(fileDescriptor);\n    const descriptorToClose = fileDescriptor;\n    fileDescriptor = undefined;\n    fs.closeSync(descriptorToClose);\n\n    fs.renameSync(temporaryPath, targetPath);\n  } finally {\n    if (fileDescriptor !== undefined) {\n      const descriptorToClose = fileDescriptor;\n      fileDescriptor = undefined;\n      fs.closeSync(descriptorToClose);\n    }\n    cleanupTemporaryFile(temporaryPath);\n  }\n}\n\nfunction initializeDoomConfig(\n  directory: string,\n  templates: Readonly<Record<DoomSeedFile, string>>,\n  options: GlobalDoomInitOptions,\n  directoryMode: number,\n  fileMode: number,\n): GlobalDoomInitResult {\n  ensureDoomDirectory(directory, directoryMode);\n\n  const created: string[] = [];\n  const preserved: string[] = [];\n  const replaced: string[] = [];\n  for (const fileName of GLOBAL_DOOM_SEED_FILES) {\n    const targetPath = path.join(directory, fileName);\n    const existed = classifyTarget(targetPath) === 'file';\n\n    if (options.force) {\n      publishForcefully(targetPath, templates[fileName], fileMode);\n      (existed ? replaced : created).push(fileName);\n      continue;\n    }\n    if (existed) {\n      preserved.push(fileName);\n      continue;\n    }\n    if (publishExclusively(targetPath, templates[fileName], fileMode)) created.push(fileName);\n    else preserved.push(fileName);\n  }\n\n  return { directory, created, preserved, replaced };\n}\n\n/**\n * Fills missing global seed files.\n *\n * Existing files are left alone so that re-running init never discards\n * hand-edited config; pass `force` to overwrite them from the template.\n */\nexport function initializeGlobalDoomConfig(\n  homeDirectory = os.homedir(),\n  options: GlobalDoomInitOptions = {},\n): GlobalDoomInitResult {\n  return initializeDoomConfig(\n    globalDoomConfigDirectory(homeDirectory),\n    DOOM_CONFIG_TEMPLATES,\n    options,\n    PRIVATE_DIRECTORY_MODE,\n    PRIVATE_FILE_MODE,\n  );\n}\n\n/** Seeds repository-local configuration without creating or changing Pi settings. */\nexport function initializeRepositoryDoomConfig(\n  repositoryRoot = process.cwd(),\n  options: RepositoryDoomInitOptions = {},\n): RepositoryDoomInitResult {\n  return initializeDoomConfig(\n    path.join(path.resolve(repositoryRoot), DOOM_DIRECTORY),\n    REPOSITORY_DOOM_CONFIG_TEMPLATES,\n    options,\n    REPOSITORY_DIRECTORY_MODE,\n    REPOSITORY_FILE_MODE,\n  );\n}\n"],"mappings":"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"}

package/dist/init.cjs

@@ -0,0 +1,7 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_init = require("./init-C_9nyp3-.cjs");
+exports.DOOM_CONFIG_TEMPLATES = require_init.DOOM_CONFIG_TEMPLATES;
+exports.GLOBAL_DOOM_SEED_FILES = require_init.GLOBAL_DOOM_SEED_FILES;
+exports.REPOSITORY_DOOM_CONFIG_TEMPLATES = require_init.REPOSITORY_DOOM_CONFIG_TEMPLATES;
+exports.initializeGlobalDoomConfig = require_init.initializeGlobalDoomConfig;
+exports.initializeRepositoryDoomConfig = require_init.initializeRepositoryDoomConfig;

package/dist/init.d.mts

@@ -0,0 +1,2 @@
+import { a as REPOSITORY_DOOM_CONFIG_TEMPLATES, c as initializeGlobalDoomConfig, i as GlobalDoomInitResult, l as initializeRepositoryDoomConfig, n as GLOBAL_DOOM_SEED_FILES, o as RepositoryDoomInitOptions, r as GlobalDoomInitOptions, s as RepositoryDoomInitResult, t as DOOM_CONFIG_TEMPLATES } from "./index-CRcoVYXz.mjs";
+export { DOOM_CONFIG_TEMPLATES, GLOBAL_DOOM_SEED_FILES, type GlobalDoomInitOptions, type GlobalDoomInitResult, REPOSITORY_DOOM_CONFIG_TEMPLATES, type RepositoryDoomInitOptions, type RepositoryDoomInitResult, initializeGlobalDoomConfig, initializeRepositoryDoomConfig };

package/dist/init.mjs

@@ -0,0 +1,2 @@
+import { a as initializeRepositoryDoomConfig, i as initializeGlobalDoomConfig, n as GLOBAL_DOOM_SEED_FILES, r as REPOSITORY_DOOM_CONFIG_TEMPLATES, t as DOOM_CONFIG_TEMPLATES } from "./init-DJ6wm-dr.mjs";
+export { DOOM_CONFIG_TEMPLATES, GLOBAL_DOOM_SEED_FILES, REPOSITORY_DOOM_CONFIG_TEMPLATES, initializeGlobalDoomConfig, initializeRepositoryDoomConfig };

package/dist/layeredConfig-B922ibgn.mjs

@@ -0,0 +1,67 @@
+import { r as isGlobalDoomConfigRoot, t as globalDoomConfigDirectory } from "./config-CKA07FxG.mjs";
+import fs from "node:fs";
+import path from "node:path";
+import os from "node:os";
+import { parse } from "yaml";
+//#region src/services/layeredConfig/index.ts
+/** Repository-local po configuration directory, committed to git. */
+const DOOM_DIR = ".po";
+const TEXT_ENCODING = "utf8";
+/**
+* Reads one named `.po` document from the global and repository config
+* directories, lowest precedence first.
+*
+* A missing or empty file contributes nothing, so either location on its own is
+* a complete configuration. Documents are deliberately returned unmerged:
+* merging is by name, and only the caller knows what a name means in its own
+* document, so each one folds the sources itself with the repository last.
+*/
+function doomConfigCandidates(fileName, repoRoot, homeDirectory = os.homedir()) {
+	const globalDirectory = globalDoomConfigDirectory(homeDirectory);
+	const globalCandidate = {
+		filePath: path.join(globalDirectory, fileName),
+		baseDirectory: globalDirectory
+	};
+	if (isGlobalDoomConfigRoot(repoRoot, homeDirectory)) return [globalCandidate];
+	return [globalCandidate, {
+		filePath: path.join(repoRoot, ".po", fileName),
+		baseDirectory: repoRoot
+	}];
+}
+function readDoomConfigSources(fileName, repoRoot, homeDirectory = os.homedir()) {
+	const candidates = doomConfigCandidates(fileName, repoRoot, homeDirectory);
+	const sources = [];
+	for (const candidate of candidates) {
+		if (!fs.existsSync(candidate.filePath)) continue;
+		const text = fs.readFileSync(candidate.filePath, TEXT_ENCODING);
+		const document = parse(text);
+		if (document === null || document === void 0) continue;
+		sources.push({
+			...candidate,
+			text,
+			document
+		});
+	}
+	return sources;
+}
+/**
+* Merges same-named records across sources, tagging each entry with the base
+* directory of the document that supplied it.
+*
+* Later sources win outright rather than being deep-merged: a repository that
+* redefines a name is replacing it, and a half-inherited definition whose paths
+* straddle two roots would be impossible to resolve.
+*/
+function mergeNamedSources(sources, select) {
+	const merged = {};
+	for (const source of sources) for (const [name, entry] of Object.entries(select(source.document) ?? {})) merged[name] = {
+		...entry,
+		baseDirectory: source.baseDirectory,
+		filePath: source.filePath
+	};
+	return merged;
+}
+//#endregion
+export { readDoomConfigSources as i, doomConfigCandidates as n, mergeNamedSources as r, DOOM_DIR as t };
+
+//# sourceMappingURL=layeredConfig-B922ibgn.mjs.map

package/dist/layeredConfig-B922ibgn.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"layeredConfig-B922ibgn.mjs","names":["parseYaml"],"sources":["../src/services/layeredConfig/index.ts"],"sourcesContent":["import fs from 'node:fs';\nimport os from 'node:os';\nimport path from 'node:path';\n\nimport { parse as parseYaml } from 'yaml';\n\nimport { globalDoomConfigDirectory, isGlobalDoomConfigRoot } from '../config';\n\n/** Repository-local po configuration directory, committed to git. */\nexport const DOOM_DIR = '.po';\n\nconst TEXT_ENCODING = 'utf8';\n\n/** Source identity retained for diagnostics and composition fingerprints. */\nexport interface DoomConfigProvenance {\n  /** Absolute path of the declaring configuration file. */\n  filePath: string;\n  /** Directory used to resolve paths authored by that file. */\n  baseDirectory: string;\n}\n\n/** One `.po` document plus the root its relative paths resolve against. */\nexport interface DoomConfigSource<TDocument> extends DoomConfigProvenance {\n  /** Absolute path of the file the document was read from. */\n  filePath: string;\n  /**\n   * Where relative paths inside this document point.\n   *\n   * A repository document resolves against the repository root, so `plugins/x`\n   * keeps meaning the same thing it always has. A global document resolves\n   * against the global `.po` directory, so it can name plugins and extensions\n   * that live beside it in `~/.po` rather than inside whichever\n   * repository happens to be open.\n   */\n  baseDirectory: string;\n  /** Raw file contents, for callers that cache parsed results by source text. */\n  text: string;\n  document: TDocument;\n}\n\n/**\n * Reads one named `.po` document from the global and repository config\n * directories, lowest precedence first.\n *\n * A missing or empty file contributes nothing, so either location on its own is\n * a complete configuration. Documents are deliberately returned unmerged:\n * merging is by name, and only the caller knows what a name means in its own\n * document, so each one folds the sources itself with the repository last.\n */\nexport function doomConfigCandidates(\n  fileName: string,\n  repoRoot: string,\n  homeDirectory: string = os.homedir(),\n): Array<{ filePath: string; baseDirectory: string }> {\n  const globalDirectory = globalDoomConfigDirectory(homeDirectory);\n  const globalCandidate = { filePath: path.join(globalDirectory, fileName), baseDirectory: globalDirectory };\n  if (isGlobalDoomConfigRoot(repoRoot, homeDirectory)) return [globalCandidate];\n  return [globalCandidate, { filePath: path.join(repoRoot, DOOM_DIR, fileName), baseDirectory: repoRoot }];\n}\n\nexport function readDoomConfigSources<TDocument>(\n  fileName: string,\n  repoRoot: string,\n  homeDirectory: string = os.homedir(),\n): Array<DoomConfigSource<TDocument>> {\n  const candidates = doomConfigCandidates(fileName, repoRoot, homeDirectory);\n\n  const sources: Array<DoomConfigSource<TDocument>> = [];\n  for (const candidate of candidates) {\n    if (!fs.existsSync(candidate.filePath)) continue;\n    const text = fs.readFileSync(candidate.filePath, TEXT_ENCODING);\n    const document = parseYaml(text) as TDocument | null | undefined;\n    // An empty file parses to null and is treated as an absent one, so a seeded\n    // placeholder never has to be deleted to get out of the way.\n    if (document === null || document === undefined) continue;\n    sources.push({ ...candidate, text, document });\n  }\n  return sources;\n}\n\n/**\n * Merges same-named records across sources, tagging each entry with the base\n * directory of the document that supplied it.\n *\n * Later sources win outright rather than being deep-merged: a repository that\n * redefines a name is replacing it, and a half-inherited definition whose paths\n * straddle two roots would be impossible to resolve.\n */\nexport function mergeNamedSources<TDocument, TEntry extends object>(\n  sources: ReadonlyArray<DoomConfigSource<TDocument>>,\n  select: (document: TDocument) => Record<string, TEntry> | undefined,\n): Record<string, TEntry & DoomConfigProvenance> {\n  const merged: Record<string, TEntry & DoomConfigProvenance> = {};\n  for (const source of sources) {\n    for (const [name, entry] of Object.entries(select(source.document) ?? {})) {\n      merged[name] = {\n        ...entry,\n        baseDirectory: source.baseDirectory,\n        filePath: source.filePath,\n      };\n    }\n  }\n  return merged;\n}\n"],"mappings":";;;;;;;AASA,MAAa,WAAW;AAExB,MAAM,gBAAgB;;;;;;;;;;AAsCtB,SAAgB,qBACd,UACA,UACA,gBAAwB,GAAG,QAAQ,GACiB;CACpD,MAAM,kBAAkB,0BAA0B,aAAa;CAC/D,MAAM,kBAAkB;EAAE,UAAU,KAAK,KAAK,iBAAiB,QAAQ;EAAG,eAAe;CAAgB;CACzG,IAAI,uBAAuB,UAAU,aAAa,GAAG,OAAO,CAAC,eAAe;CAC5E,OAAO,CAAC,iBAAiB;EAAE,UAAU,KAAK,KAAK,UAAA,OAAoB,QAAQ;EAAG,eAAe;CAAS,CAAC;AACzG;AAEA,SAAgB,sBACd,UACA,UACA,gBAAwB,GAAG,QAAQ,GACC;CACpC,MAAM,aAAa,qBAAqB,UAAU,UAAU,aAAa;CAEzE,MAAM,UAA8C,CAAC;CACrD,KAAK,MAAM,aAAa,YAAY;EAClC,IAAI,CAAC,GAAG,WAAW,UAAU,QAAQ,GAAG;EACxC,MAAM,OAAO,GAAG,aAAa,UAAU,UAAU,aAAa;EAC9D,MAAM,WAAWA,MAAU,IAAI;EAG/B,IAAI,aAAa,QAAQ,aAAa,KAAA,GAAW;EACjD,QAAQ,KAAK;GAAE,GAAG;GAAW;GAAM;EAAS,CAAC;CAC/C;CACA,OAAO;AACT;;;;;;;;;AAUA,SAAgB,kBACd,SACA,QAC+C;CAC/C,MAAM,SAAwD,CAAC;CAC/D,KAAK,MAAM,UAAU,SACnB,KAAK,MAAM,CAAC,MAAM,UAAU,OAAO,QAAQ,OAAO,OAAO,QAAQ,KAAK,CAAC,CAAC,GACtE,OAAO,QAAQ;EACb,GAAG;EACH,eAAe,OAAO;EACtB,UAAU,OAAO;CACnB;CAGJ,OAAO;AACT"}

package/dist/layeredConfig-DdI5ysUf.cjs

@@ -0,0 +1,94 @@
+const require_rolldown_runtime = require("./rolldown-runtime-VH7oDXx4.cjs");
+const require_config = require("./config-BUw5kHsx.cjs");
+let node_fs = require("node:fs");
+node_fs = require_rolldown_runtime.__toESM(node_fs, 1);
+let node_path = require("node:path");
+node_path = require_rolldown_runtime.__toESM(node_path, 1);
+let node_os = require("node:os");
+node_os = require_rolldown_runtime.__toESM(node_os, 1);
+let yaml = require("yaml");
+//#region src/services/layeredConfig/index.ts
+/** Repository-local po configuration directory, committed to git. */
+const DOOM_DIR = ".po";
+const TEXT_ENCODING = "utf8";
+/**
+* Reads one named `.po` document from the global and repository config
+* directories, lowest precedence first.
+*
+* A missing or empty file contributes nothing, so either location on its own is
+* a complete configuration. Documents are deliberately returned unmerged:
+* merging is by name, and only the caller knows what a name means in its own
+* document, so each one folds the sources itself with the repository last.
+*/
+function doomConfigCandidates(fileName, repoRoot, homeDirectory = node_os.default.homedir()) {
+	const globalDirectory = require_config.globalDoomConfigDirectory(homeDirectory);
+	const globalCandidate = {
+		filePath: node_path.default.join(globalDirectory, fileName),
+		baseDirectory: globalDirectory
+	};
+	if (require_config.isGlobalDoomConfigRoot(repoRoot, homeDirectory)) return [globalCandidate];
+	return [globalCandidate, {
+		filePath: node_path.default.join(repoRoot, ".po", fileName),
+		baseDirectory: repoRoot
+	}];
+}
+function readDoomConfigSources(fileName, repoRoot, homeDirectory = node_os.default.homedir()) {
+	const candidates = doomConfigCandidates(fileName, repoRoot, homeDirectory);
+	const sources = [];
+	for (const candidate of candidates) {
+		if (!node_fs.default.existsSync(candidate.filePath)) continue;
+		const text = node_fs.default.readFileSync(candidate.filePath, TEXT_ENCODING);
+		const document = (0, yaml.parse)(text);
+		if (document === null || document === void 0) continue;
+		sources.push({
+			...candidate,
+			text,
+			document
+		});
+	}
+	return sources;
+}
+/**
+* Merges same-named records across sources, tagging each entry with the base
+* directory of the document that supplied it.
+*
+* Later sources win outright rather than being deep-merged: a repository that
+* redefines a name is replacing it, and a half-inherited definition whose paths
+* straddle two roots would be impossible to resolve.
+*/
+function mergeNamedSources(sources, select) {
+	const merged = {};
+	for (const source of sources) for (const [name, entry] of Object.entries(select(source.document) ?? {})) merged[name] = {
+		...entry,
+		baseDirectory: source.baseDirectory,
+		filePath: source.filePath
+	};
+	return merged;
+}
+//#endregion
+Object.defineProperty(exports, "DOOM_DIR", {
+	enumerable: true,
+	get: function() {
+		return DOOM_DIR;
+	}
+});
+Object.defineProperty(exports, "doomConfigCandidates", {
+	enumerable: true,
+	get: function() {
+		return doomConfigCandidates;
+	}
+});
+Object.defineProperty(exports, "mergeNamedSources", {
+	enumerable: true,
+	get: function() {
+		return mergeNamedSources;
+	}
+});
+Object.defineProperty(exports, "readDoomConfigSources", {
+	enumerable: true,
+	get: function() {
+		return readDoomConfigSources;
+	}
+});
+
+//# sourceMappingURL=layeredConfig-DdI5ysUf.cjs.map

package/dist/layeredConfig-DdI5ysUf.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"layeredConfig-DdI5ysUf.cjs","names":["os","globalDoomConfigDirectory","path","isGlobalDoomConfigRoot","fs","parseYaml"],"sources":["../src/services/layeredConfig/index.ts"],"sourcesContent":["import fs from 'node:fs';\nimport os from 'node:os';\nimport path from 'node:path';\n\nimport { parse as parseYaml } from 'yaml';\n\nimport { globalDoomConfigDirectory, isGlobalDoomConfigRoot } from '../config';\n\n/** Repository-local po configuration directory, committed to git. */\nexport const DOOM_DIR = '.po';\n\nconst TEXT_ENCODING = 'utf8';\n\n/** Source identity retained for diagnostics and composition fingerprints. */\nexport interface DoomConfigProvenance {\n  /** Absolute path of the declaring configuration file. */\n  filePath: string;\n  /** Directory used to resolve paths authored by that file. */\n  baseDirectory: string;\n}\n\n/** One `.po` document plus the root its relative paths resolve against. */\nexport interface DoomConfigSource<TDocument> extends DoomConfigProvenance {\n  /** Absolute path of the file the document was read from. */\n  filePath: string;\n  /**\n   * Where relative paths inside this document point.\n   *\n   * A repository document resolves against the repository root, so `plugins/x`\n   * keeps meaning the same thing it always has. A global document resolves\n   * against the global `.po` directory, so it can name plugins and extensions\n   * that live beside it in `~/.po` rather than inside whichever\n   * repository happens to be open.\n   */\n  baseDirectory: string;\n  /** Raw file contents, for callers that cache parsed results by source text. */\n  text: string;\n  document: TDocument;\n}\n\n/**\n * Reads one named `.po` document from the global and repository config\n * directories, lowest precedence first.\n *\n * A missing or empty file contributes nothing, so either location on its own is\n * a complete configuration. Documents are deliberately returned unmerged:\n * merging is by name, and only the caller knows what a name means in its own\n * document, so each one folds the sources itself with the repository last.\n */\nexport function doomConfigCandidates(\n  fileName: string,\n  repoRoot: string,\n  homeDirectory: string = os.homedir(),\n): Array<{ filePath: string; baseDirectory: string }> {\n  const globalDirectory = globalDoomConfigDirectory(homeDirectory);\n  const globalCandidate = { filePath: path.join(globalDirectory, fileName), baseDirectory: globalDirectory };\n  if (isGlobalDoomConfigRoot(repoRoot, homeDirectory)) return [globalCandidate];\n  return [globalCandidate, { filePath: path.join(repoRoot, DOOM_DIR, fileName), baseDirectory: repoRoot }];\n}\n\nexport function readDoomConfigSources<TDocument>(\n  fileName: string,\n  repoRoot: string,\n  homeDirectory: string = os.homedir(),\n): Array<DoomConfigSource<TDocument>> {\n  const candidates = doomConfigCandidates(fileName, repoRoot, homeDirectory);\n\n  const sources: Array<DoomConfigSource<TDocument>> = [];\n  for (const candidate of candidates) {\n    if (!fs.existsSync(candidate.filePath)) continue;\n    const text = fs.readFileSync(candidate.filePath, TEXT_ENCODING);\n    const document = parseYaml(text) as TDocument | null | undefined;\n    // An empty file parses to null and is treated as an absent one, so a seeded\n    // placeholder never has to be deleted to get out of the way.\n    if (document === null || document === undefined) continue;\n    sources.push({ ...candidate, text, document });\n  }\n  return sources;\n}\n\n/**\n * Merges same-named records across sources, tagging each entry with the base\n * directory of the document that supplied it.\n *\n * Later sources win outright rather than being deep-merged: a repository that\n * redefines a name is replacing it, and a half-inherited definition whose paths\n * straddle two roots would be impossible to resolve.\n */\nexport function mergeNamedSources<TDocument, TEntry extends object>(\n  sources: ReadonlyArray<DoomConfigSource<TDocument>>,\n  select: (document: TDocument) => Record<string, TEntry> | undefined,\n): Record<string, TEntry & DoomConfigProvenance> {\n  const merged: Record<string, TEntry & DoomConfigProvenance> = {};\n  for (const source of sources) {\n    for (const [name, entry] of Object.entries(select(source.document) ?? {})) {\n      merged[name] = {\n        ...entry,\n        baseDirectory: source.baseDirectory,\n        filePath: source.filePath,\n      };\n    }\n  }\n  return merged;\n}\n"],"mappings":";;;;;;;;;;;AASA,MAAa,WAAW;AAExB,MAAM,gBAAgB;;;;;;;;;;AAsCtB,SAAgB,qBACd,UACA,UACA,gBAAwBA,QAAAA,QAAG,QAAQ,GACiB;CACpD,MAAM,kBAAkBC,eAAAA,0BAA0B,aAAa;CAC/D,MAAM,kBAAkB;EAAE,UAAUC,UAAAA,QAAK,KAAK,iBAAiB,QAAQ;EAAG,eAAe;CAAgB;CACzG,IAAIC,eAAAA,uBAAuB,UAAU,aAAa,GAAG,OAAO,CAAC,eAAe;CAC5E,OAAO,CAAC,iBAAiB;EAAE,UAAUD,UAAAA,QAAK,KAAK,UAAA,OAAoB,QAAQ;EAAG,eAAe;CAAS,CAAC;AACzG;AAEA,SAAgB,sBACd,UACA,UACA,gBAAwBF,QAAAA,QAAG,QAAQ,GACC;CACpC,MAAM,aAAa,qBAAqB,UAAU,UAAU,aAAa;CAEzE,MAAM,UAA8C,CAAC;CACrD,KAAK,MAAM,aAAa,YAAY;EAClC,IAAI,CAACI,QAAAA,QAAG,WAAW,UAAU,QAAQ,GAAG;EACxC,MAAM,OAAOA,QAAAA,QAAG,aAAa,UAAU,UAAU,aAAa;EAC9D,MAAM,YAAA,GAAWC,KAAAA,MAAAA,CAAU,IAAI;EAG/B,IAAI,aAAa,QAAQ,aAAa,KAAA,GAAW;EACjD,QAAQ,KAAK;GAAE,GAAG;GAAW;GAAM;EAAS,CAAC;CAC/C;CACA,OAAO;AACT;;;;;;;;;AAUA,SAAgB,kBACd,SACA,QAC+C;CAC/C,MAAM,SAAwD,CAAC;CAC/D,KAAK,MAAM,UAAU,SACnB,KAAK,MAAM,CAAC,MAAM,UAAU,OAAO,QAAQ,OAAO,OAAO,QAAQ,KAAK,CAAC,CAAC,GACtE,OAAO,QAAQ;EACb,GAAG;EACH,eAAe,OAAO;EACtB,UAAU,OAAO;CACnB;CAGJ,OAAO;AACT"}