@agimon-ai/doompi-domain 0.0.1-alpha.10

package/dist/types/resources.d.cts

@@ -0,0 +1,65 @@
+import { PluginHookSource } from "@agimon-ai/doompi-config/types";
+import { DoomMcpProjection, DoomMcpProjectionSource } from "@agimon-ai/doompi-extension-contracts/mcp-projection";
+//#region src/types/resources.d.ts
+/** A JSON document the harness owns on disk, before it is given a shape. */
+type JsonObject = Record<string, unknown>;
+/** A skill or agent that has been located and named, but not yet staged. */
+interface NamedResource {
+  name: string;
+  path: string;
+  digest?: string;
+}
+interface HarnessResourceOptions {
+  agents: boolean;
+  mcp: boolean;
+  temporaryDirectory?: string;
+  /** Persistent metadata cache; defaults to the home-scoped worktree cache. */
+  skillCacheDirectory?: string;
+  /** Domain MCP allowlist. Omit to keep every configured server. */
+  mcpAllowlist?: {
+    servers?: string[];
+    proxy?: string[];
+  };
+  /** Include .claude/skills as fallbacks after selected plugin skills. Defaults to true. */
+  sharedSkills?: boolean;
+  /** Persistent root for Agent Plugin data; defaults to the user's Doom config directory. */
+  pluginDataRoot?: string;
+}
+interface McpResourceOptions {
+  enabled: boolean;
+  temporaryDirectory: string;
+  /** Domain MCP allowlist. Omit to keep every configured server. */
+  mcpAllowlist?: {
+    servers?: string[];
+    proxy?: string[];
+  };
+  /** Persistent root for Agent Plugin data; defaults to the user's Doom config directory. */
+  pluginDataRoot?: string;
+}
+interface StagedMcpResources {
+  mcpConfigPath?: string;
+  mcpProjection: DoomMcpProjection;
+  pluginMcpSources: DoomMcpProjectionSource[];
+  pluginMcpConfigPaths: string[];
+}
+interface HarnessResources {
+  temporaryDirectory: string;
+  /** Exact SKILL.md paths compiled from the selected discovery roots. */
+  skillDirectories: string[];
+  /** Number of discovered SKILL.md files, which is what reaches the model. */
+  skillCount: number;
+  agentCount: number;
+  agentDirectories: string[];
+  pluginHooks: PluginHookSource[];
+  mcpConfigPath?: string;
+  /** Immutable source snapshot published through the replacement session's Cordis registry. */
+  mcpProjection: DoomMcpProjection;
+  /** Ordered plugin descriptors retained for focused resource diagnostics. */
+  pluginMcpSources: DoomMcpProjectionSource[];
+  /** Legacy path-only view of the selected plugin MCP sources, in precedence order. */
+  pluginMcpConfigPaths: string[];
+  cleanup(): Promise<void>;
+}
+//#endregion
+export { HarnessResourceOptions, HarnessResources, JsonObject, McpResourceOptions, NamedResource, StagedMcpResources };
+//# sourceMappingURL=resources.d.cts.map

package/dist/types/resources.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.cts","names":[],"sources":["../../src/types/resources.ts"],"mappings":";;;;KAIY,aAAa;;UAGR;EACf;EACA;EACA;;UAGe;EACf;EACA;EACA;;EAEA;;EAEA;IAAiB;IAAoB;;;EAErC;;EAEA;;UAGe;EACf;EACA;;EAEA;IAAiB;IAAoB;;;EAErC;;UAGe;EACf;EACA,eAAe;EACf,kBAAkB;EAClB;;UAGe;EACf;;EAEA;;EAEA;EACA;EACA;EACA,aAAa;EACb;;EAEA,eAAe;;EAEf,kBAAkB;;EAElB;EACA,WAAW"}

package/dist/types/resources.d.mts

@@ -0,0 +1,65 @@
+import { DoomMcpProjection, DoomMcpProjectionSource } from "@agimon-ai/doompi-extension-contracts/mcp-projection";
+import { PluginHookSource } from "@agimon-ai/doompi-config/types";
+//#region src/types/resources.d.ts
+/** A JSON document the harness owns on disk, before it is given a shape. */
+type JsonObject = Record<string, unknown>;
+/** A skill or agent that has been located and named, but not yet staged. */
+interface NamedResource {
+  name: string;
+  path: string;
+  digest?: string;
+}
+interface HarnessResourceOptions {
+  agents: boolean;
+  mcp: boolean;
+  temporaryDirectory?: string;
+  /** Persistent metadata cache; defaults to the home-scoped worktree cache. */
+  skillCacheDirectory?: string;
+  /** Domain MCP allowlist. Omit to keep every configured server. */
+  mcpAllowlist?: {
+    servers?: string[];
+    proxy?: string[];
+  };
+  /** Include .claude/skills as fallbacks after selected plugin skills. Defaults to true. */
+  sharedSkills?: boolean;
+  /** Persistent root for Agent Plugin data; defaults to the user's Doom config directory. */
+  pluginDataRoot?: string;
+}
+interface McpResourceOptions {
+  enabled: boolean;
+  temporaryDirectory: string;
+  /** Domain MCP allowlist. Omit to keep every configured server. */
+  mcpAllowlist?: {
+    servers?: string[];
+    proxy?: string[];
+  };
+  /** Persistent root for Agent Plugin data; defaults to the user's Doom config directory. */
+  pluginDataRoot?: string;
+}
+interface StagedMcpResources {
+  mcpConfigPath?: string;
+  mcpProjection: DoomMcpProjection;
+  pluginMcpSources: DoomMcpProjectionSource[];
+  pluginMcpConfigPaths: string[];
+}
+interface HarnessResources {
+  temporaryDirectory: string;
+  /** Exact SKILL.md paths compiled from the selected discovery roots. */
+  skillDirectories: string[];
+  /** Number of discovered SKILL.md files, which is what reaches the model. */
+  skillCount: number;
+  agentCount: number;
+  agentDirectories: string[];
+  pluginHooks: PluginHookSource[];
+  mcpConfigPath?: string;
+  /** Immutable source snapshot published through the replacement session's Cordis registry. */
+  mcpProjection: DoomMcpProjection;
+  /** Ordered plugin descriptors retained for focused resource diagnostics. */
+  pluginMcpSources: DoomMcpProjectionSource[];
+  /** Legacy path-only view of the selected plugin MCP sources, in precedence order. */
+  pluginMcpConfigPaths: string[];
+  cleanup(): Promise<void>;
+}
+//#endregion
+export { HarnessResourceOptions, HarnessResources, JsonObject, McpResourceOptions, NamedResource, StagedMcpResources };
+//# sourceMappingURL=resources.d.mts.map

package/dist/types/resources.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.mts","names":[],"sources":["../../src/types/resources.ts"],"mappings":";;;;KAIY,aAAa;;UAGR;EACf;EACA;EACA;;UAGe;EACf;EACA;EACA;;EAEA;;EAEA;IAAiB;IAAoB;;;EAErC;;EAEA;;UAGe;EACf;EACA;;EAEA;IAAiB;IAAoB;;;EAErC;;UAGe;EACf;EACA,eAAe;EACf,kBAAkB;EAClB;;UAGe;EACf;;EAEA;;EAEA;EACA;EACA;EACA,aAAa;EACb;;EAEA,eAAe;;EAEf,kBAAkB;;EAElB;EACA,WAAW"}

package/dist/types/telemetry.cjs

@@ -0,0 +1,2 @@
+const e={domainsSwitched:`doom_pi_domains.switched`,domainsSwitchFailed:`doom_pi_domains.switch_failed`};exports.DOMAIN_EVENT=e;
+//# sourceMappingURL=telemetry.cjs.map

package/dist/types/telemetry.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.cjs","names":[],"sources":["../../src/types/telemetry.ts"],"sourcesContent":["/** Telemetry events this package reports, and the port that records them. */\nexport const DOMAIN_EVENT = {\n  domainsSwitched: 'doom_pi_domains.switched',\n  domainsSwitchFailed: 'doom_pi_domains.switch_failed',\n} as const;\n\nexport type DomainEventName = (typeof DOMAIN_EVENT)[keyof typeof DOMAIN_EVENT];\nexport type DomainEventAttributes = Record<string, string | number | boolean>;\n\nexport interface DomainTelemetry {\n  recordError(event: DomainEventName, error: unknown, attributes?: DomainEventAttributes): Promise<void>;\n  recordEvent(event: DomainEventName, attributes?: DomainEventAttributes): Promise<void>;\n}\n"],"mappings":"AACA,MAAa,EAAe,CAC1B,gBAAiB,2BACjB,oBAAqB,+BACvB"}

package/dist/types/telemetry.d.cts

@@ -0,0 +1,15 @@
+//#region src/types/telemetry.d.ts
+/** Telemetry events this package reports, and the port that records them. */
+declare const DOMAIN_EVENT: {
+  readonly domainsSwitched: 'doom_pi_domains.switched';
+  readonly domainsSwitchFailed: 'doom_pi_domains.switch_failed';
+};
+type DomainEventName = (typeof DOMAIN_EVENT)[keyof typeof DOMAIN_EVENT];
+type DomainEventAttributes = Record<string, string | number | boolean>;
+interface DomainTelemetry {
+  recordError(event: DomainEventName, error: unknown, attributes?: DomainEventAttributes): Promise<void>;
+  recordEvent(event: DomainEventName, attributes?: DomainEventAttributes): Promise<void>;
+}
+//#endregion
+export { DOMAIN_EVENT, DomainEventAttributes, DomainEventName, DomainTelemetry };
+//# sourceMappingURL=telemetry.d.cts.map

package/dist/types/telemetry.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.cts","names":[],"sources":["../../src/types/telemetry.ts"],"mappings":";;cACa;WACX;WACA;;KAGU,0BAA0B,2BAA2B;KACrD,wBAAwB;UAEnB;EACf,YAAY,OAAO,iBAAiB,gBAAgB,aAAa,wBAAwB;EACzF,YAAY,OAAO,iBAAiB,aAAa,wBAAwB"}

package/dist/types/telemetry.d.mts

@@ -0,0 +1,15 @@
+//#region src/types/telemetry.d.ts
+/** Telemetry events this package reports, and the port that records them. */
+declare const DOMAIN_EVENT: {
+  readonly domainsSwitched: 'doom_pi_domains.switched';
+  readonly domainsSwitchFailed: 'doom_pi_domains.switch_failed';
+};
+type DomainEventName = (typeof DOMAIN_EVENT)[keyof typeof DOMAIN_EVENT];
+type DomainEventAttributes = Record<string, string | number | boolean>;
+interface DomainTelemetry {
+  recordError(event: DomainEventName, error: unknown, attributes?: DomainEventAttributes): Promise<void>;
+  recordEvent(event: DomainEventName, attributes?: DomainEventAttributes): Promise<void>;
+}
+//#endregion
+export { DOMAIN_EVENT, DomainEventAttributes, DomainEventName, DomainTelemetry };
+//# sourceMappingURL=telemetry.d.mts.map

package/dist/types/telemetry.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.mts","names":[],"sources":["../../src/types/telemetry.ts"],"mappings":";;cACa;WACX;WACA;;KAGU,0BAA0B,2BAA2B;KACrD,wBAAwB;UAEnB;EACf,YAAY,OAAO,iBAAiB,gBAAgB,aAAa,wBAAwB;EACzF,YAAY,OAAO,iBAAiB,aAAa,wBAAwB"}

package/dist/types/telemetry.mjs

@@ -0,0 +1,2 @@
+const e={domainsSwitched:`doom_pi_domains.switched`,domainsSwitchFailed:`doom_pi_domains.switch_failed`};export{e as DOMAIN_EVENT};
+//# sourceMappingURL=telemetry.mjs.map

package/dist/types/telemetry.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.mjs","names":[],"sources":["../../src/types/telemetry.ts"],"sourcesContent":["/** Telemetry events this package reports, and the port that records them. */\nexport const DOMAIN_EVENT = {\n  domainsSwitched: 'doom_pi_domains.switched',\n  domainsSwitchFailed: 'doom_pi_domains.switch_failed',\n} as const;\n\nexport type DomainEventName = (typeof DOMAIN_EVENT)[keyof typeof DOMAIN_EVENT];\nexport type DomainEventAttributes = Record<string, string | number | boolean>;\n\nexport interface DomainTelemetry {\n  recordError(event: DomainEventName, error: unknown, attributes?: DomainEventAttributes): Promise<void>;\n  recordEvent(event: DomainEventName, attributes?: DomainEventAttributes): Promise<void>;\n}\n"],"mappings":"AACA,MAAa,EAAe,CAC1B,gBAAiB,2BACjB,oBAAqB,+BACvB"}

package/llms.txt

@@ -0,0 +1,12 @@
+# Doom Pi Domain
+
+Domain selection and resource staging for Doom Pi sessions.
+
+## How to author
+
+- [Author DoomPi domains](./src/prompts/doompi-author-domain/SKILL.md): Routing and safeguards for editing domain configuration.
+- [`domains.yaml` authoring contract](./src/prompts/doompi-author-domain/references/domains-contract.md): Schemas, source forms, layering, filtering, pinning, and verification.
+
+## Package reference
+
+- [Package README](./README.md): The `/domains` command, voice tools, and what a domain switch stages.

package/package.json

@@ -0,0 +1,117 @@
+{
+  "name": "@agimon-ai/doompi-domain",
+  "version": "0.0.1-alpha.10",
+  "description": "Domain selection, resource staging, and MCP scoping for DoomPi sessions.",
+  "keywords": [
+    "ai",
+    "coding-agent",
+    "developer-tools",
+    "domains",
+    "doompi",
+    "mcp",
+    "pi-coding-agent",
+    "pi-extension",
+    "pi-package",
+    "plugins",
+    "session-reload",
+    "skills"
+  ],
+  "homepage": "https://agimon.ai",
+  "license": "MIT",
+  "author": "Vuong Ngo",
+  "files": [
+    "dist",
+    "llms.txt",
+    "src/prompts",
+    "README.md",
+    "LICENSE",
+    "package.json"
+  ],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "types": "./dist/index.d.mts",
+  "jsnext:main": "./dist/index.mjs",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    },
+    "./apply": {
+      "types": "./dist/apply.d.mts",
+      "import": "./dist/apply.mjs",
+      "require": "./dist/apply.cjs"
+    },
+    "./extensions/pi": {
+      "types": "./dist/extensions/pi.d.mts",
+      "import": "./dist/extensions/pi.mjs",
+      "require": "./dist/extensions/pi.cjs"
+    },
+    "./mcp": {
+      "types": "./dist/mcp.d.mts",
+      "import": "./dist/mcp.mjs",
+      "require": "./dist/mcp.cjs"
+    },
+    "./plugins": {
+      "types": "./dist/plugins.d.mts",
+      "import": "./dist/plugins.mjs",
+      "require": "./dist/plugins.cjs"
+    },
+    "./resources": {
+      "types": "./dist/resources.d.mts",
+      "import": "./dist/resources.mjs",
+      "require": "./dist/resources.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@deepseek-ai/cordis": "4.0.1",
+    "typebox": "1.3.16",
+    "yaml": "2.9.0",
+    "@agimon-ai/doompi-config": "0.0.1-alpha.32",
+    "@agimon-ai/doompi-extension-contracts": "0.0.1-alpha.32",
+    "@agimon-ai/doompi-telemetry": "0.0.1-alpha.32",
+    "@agimon-ai/doompi-ui": "0.0.1-alpha.32"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "4.0.1",
+    "@earendil-works/pi-coding-agent": "0.84.2",
+    "@earendil-works/pi-tui": "0.84.2",
+    "@types/node": "26.2.0",
+    "@vitest/coverage-v8": "4.1.11",
+    "tsdown": "0.22.14",
+    "typescript": "7.0.2",
+    "vitest": "4.1.11",
+    "@agimon-ai/vibe-lint-plugin-doom-extension": "0.0.1-alpha.30"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "0.84.2",
+    "@earendil-works/pi-tui": "0.84.2"
+  },
+  "peerDependenciesMeta": {
+    "@earendil-works/pi-coding-agent": {
+      "optional": true
+    },
+    "@earendil-works/pi-tui": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "pi": {
+    "extensions": [
+      "./dist/extensions/pi.mjs"
+    ]
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest --run",
+    "typecheck": "tsc --noEmit",
+    "lint": "oxlint . && oxfmt . --check",
+    "fixcode": "oxlint . --fix && oxfmt ."
+  }
+}

package/src/prompts/doompi-author-domain/SKILL.md

@@ -0,0 +1,16 @@
+---
+name: doompi-author-domain
+description: Configure DoomPi plugin catalogs and domain resource selections in domains.yaml. Use when creating or editing .doom/domains.yaml or ~/.pi/.doom/domains.yaml, choosing local, Git, or npm plugins, filtering plugin resources, setting aliases or defaults, or verifying resolved domain composition.
+---
+
+# Author DoomPi domain configuration
+
+Keep plugin locations in `plugins` and make domains refer to catalog IDs. Do not put filesystem paths directly in a domain's `plugins` list.
+
+Before editing, read both `~/.pi/.doom/domains.yaml` and the repository's `.doom/domains.yaml` when they exist. Preserve their layered ownership and resolve every relative path from the file that declares it.
+
+Use the smallest source form that preserves intent. Pin Git sources with `sha` and npm sources with an exact `version` when reproducibility matters. Use a domain plugin mapping only when the domain needs resource filters or must disable plugin hooks or MCP.
+
+After editing, validate the intended selection with `doompi --domains <name[,name...]> --explain`, then run `doompi sync --check`. Run mutating `doompi sync` only when the user intends to materialize or refresh synchronized artifacts.
+
+Read [references/domains-contract.md](references/domains-contract.md) for the complete schema, precedence rules, source forms, filters, and verification checks.

package/src/prompts/doompi-author-domain/references/domains-contract.md

@@ -0,0 +1,165 @@
+# `domains.yaml` authoring contract
+
+## Files and precedence
+
+DoomPi reads `~/.pi/.doom/domains.yaml` first and `<repo>/.doom/domains.yaml` second. The document accepts only these top-level keys:
+
+- `plugins`: plugin discovery roots and explicit catalog entries.
+- `domains`: named resource selections.
+- `aliases`: names that expand to arrays of concrete domain names.
+- `defaultDomains`: the selection used when no higher-precedence source names domains.
+
+Relative paths in the personal file resolve from `~/.pi/.doom`. Relative paths in the repository file resolve from the repository root.
+
+Plugin roots from both files accumulate in source order and exact duplicate roots are removed. Explicit plugin entries, domains, and aliases merge by name. A repository definition replaces the complete personal definition with the same name, rather than deep-merging it. A repository `defaultDomains` replaces the personal value when present; omitting it inherits the personal value. `defaultDomains: []` is an explicit empty default.
+
+At selection time, a present `DOOMPI_DOMAINS` value outranks `defaultDomains`, including an explicitly empty environment value. When neither exists, the compatibility fallback is `marketing` for the marketing major mode and `default` otherwise. Command-line or persisted session selections are applied by their caller before this fallback is needed.
+
+## Complete example
+
+```yaml
+defaultDomains: [work]
+
+plugins:
+  roots: [plugins]
+  entries:
+    repository-tools:
+      source: local
+      path: tools/repository-plugin
+      description: Repository implementation tools.
+    review-tools:
+      source: url
+      url: https://github.com/acme/review-tools.git
+      path: plugins/review
+      ref: v2
+      sha: 0123456789abcdef0123456789abcdef01234567
+    incident-tools:
+      source: npm
+      package: '@acme/incident-tools'
+      version: 3.1.0
+
+domains:
+  development:
+    description: Implementation and review resources.
+    plugins:
+      - repository-tools
+      - name: review-tools
+        skills: [typescript, review-*]
+        agents: [reviewer]
+        hooks: false
+        mcp: true
+    sharedSkills: true
+    mcp:
+      servers: [code-intel, agiflow-proxy]
+      proxy: [repository-search]
+  operations:
+    description: Incident response resources.
+    plugins: [incident-tools]
+    mcp:
+      servers: [agiflow-proxy]
+      proxy: [production-observability]
+
+aliases:
+  work: [development, operations]
+```
+
+## Plugin discovery roots
+
+`plugins.roots` is an array. Each path can identify:
+
+- a supported marketplace root or its manifest;
+- one plugin root; or
+- a container whose direct-child directories are plugins.
+
+Discovery does not recurse beyond direct children. Use another root or an explicit entry for a deeper plugin. DoomPi recognizes schema-gated Agent Plugins v1 `plugin.json` files and the legacy `.codex-plugin/plugin.json`, `.claude-plugin/plugin.json`, and `.cursor-plugin/plugin.json` locations. A discovered plugin uses its manifest `name`, or its directory name when the manifest omits one.
+
+DoomPi also inspects supported personal and repository marketplace locations automatically. Marketplace IDs are qualified as `plugin@marketplace`. When the same marketplace ID appears more than once, the first discovered marketplace entry wins. Explicit `plugins.entries` are applied last and may intentionally replace discovered IDs.
+
+## Explicit plugin sources
+
+Every `plugins.entries` key is the stable ID that domains reference.
+
+Local plugins can use a path shorthand or the canonical mapping:
+
+```yaml
+plugins:
+  entries:
+    short-local: plugins/short-local
+    local-tool:
+      source: local
+      path: plugins/local-tool
+```
+
+Git repositories use `source: url`. Use `source: git-subdir` when `path` is required by the declaration:
+
+```yaml
+plugins:
+  entries:
+    whole-repository:
+      source: url
+      url: acme/whole-plugin
+      sha: 0123456789abcdef0123456789abcdef01234567
+    monorepo-plugin:
+      source: git-subdir
+      url: ssh://git@example.com/acme/plugins.git
+      path: packages/doom-plugin
+      ref: main
+      sha: fedcba9876543210fedcba9876543210fedcba98
+```
+
+Git URLs may be HTTP, HTTPS, SSH, `file:`, scp-like `git@host:path`, absolute paths, declaring-root-relative `./` paths, or `owner/repository` GitHub shorthand. A remote `path` must remain inside the checkout. `git-subdir` requires it. When `sha` is present, DoomPi checks out and verifies that commit; otherwise it uses `ref` when supplied.
+
+npm plugins use a valid package name, plus optional version and registry:
+
+```yaml
+plugins:
+  entries:
+    published-tool:
+      source: npm
+      package: '@acme/published-tool'
+      version: 1.4.2
+      registry: https://registry.npmjs.org
+```
+
+Git and npm sources materialize under `~/.pi/.doom/plugin-cache`. Cache identity includes the complete source descriptor. An existing cache is reused and does not refresh a mutable branch, tag, npm range, or unversioned package automatically. Prefer a full Git `sha` or exact npm `version`. Change the descriptor to produce a new cache identity when updating deliberately.
+
+## Domains and resource filters
+
+A domain accepts only `description`, `plugins`, `mcp`, and `sharedSkills`.
+
+A string in `plugins` selects every supported resource from that catalog entry. The mapping form selects the same plugin with optional controls:
+
+- `skills`: skill frontmatter names to retain. Exact names and `*` wildcards are supported.
+- `agents`: agent frontmatter names to retain. Exact names and `*` wildcards are supported.
+- `hooks`: set `false` to omit the plugin's `hooks/hooks.json`; omission keeps it.
+- `mcp`: set `false` to omit the plugin's MCP source; omission keeps it.
+
+`sharedSkills: false` opts out of repository `.claude/skills`. Shared skills remain enabled unless every selected concrete domain sets it to `false`.
+
+The domain-level `mcp.servers` list keeps named servers from the merged repository and plugin MCP configuration. `mcp.proxy` keeps named upstreams from the `agiflow-proxy` configuration. Allowlist values from selected domains are unioned, but filtering activates only when every selected concrete domain declares `mcp`. If any selected domain omits `mcp`, the selection remains unfiltered. An omitted or empty `servers` or `proxy` list also leaves that slice unfiltered; an empty array is not a deny-all policy.
+
+Aliases expand once to their listed concrete domain names. Keep alias targets concrete rather than chaining aliases. Domain and alias names both appear in `/domains` discovery. Plugin directories are deduplicated by resolved directory in first-selection order.
+
+## Verification
+
+From the repository root:
+
+```sh
+doompi --domains development --explain
+doompi --domains development,operations --explain
+doompi sync --check
+```
+
+Confirm the explanation lists the expected domains, plugin names, skill paths, agents, MCP servers, and proxy upstreams. Start a session and use `/domains` or `list_domains` to confirm the active and available names. A live switch uses `/domains <name[,name...]>` and reloads the session after validation and resource staging.
+
+Run mutating `doompi sync` only when the user intends to materialize remote sources or refresh
+synchronized runtime artifacts.
+
+For source changes in this repository, run:
+
+```sh
+pnpm nx lint @agimon-ai/doompi-domain
+pnpm nx typecheck @agimon-ai/doompi-domain
+pnpm nx build @agimon-ai/doompi-domain
+pnpm nx test @agimon-ai/doompi-domain
+```