@agimon-ai/doompi-config 0.0.1-alpha.0

package/package.json

@@ -0,0 +1,150 @@
+{
+  "name": "@agimon-ai/doompi-config",
+  "version": "0.0.1-alpha.0",
+  "description": "Shared Doom configuration loading and dependency injection",
+  "homepage": "https://agimon.ai",
+  "license": "MIT",
+  "author": "Vuong Ngo",
+  "files": [
+    "dist",
+    "skills"
+  ],
+  "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"
+    },
+    "./atomicJson": {
+      "types": "./dist/atomicJson.d.mts",
+      "import": "./dist/atomicJson.mjs",
+      "require": "./dist/atomicJson.cjs"
+    },
+    "./config": {
+      "types": "./dist/config.d.mts",
+      "import": "./dist/config.mjs",
+      "require": "./dist/config.cjs"
+    },
+    "./config/schema": {
+      "types": "./dist/config/schema.d.mts",
+      "import": "./dist/config/schema.mjs",
+      "require": "./dist/config/schema.cjs"
+    },
+    "./config/piConfig": {
+      "types": "./dist/config/piConfig.d.mts",
+      "import": "./dist/config/piConfig.mjs",
+      "require": "./dist/config/piConfig.cjs"
+    },
+    "./configWriter": {
+      "types": "./dist/configWriter.d.mts",
+      "import": "./dist/configWriter.mjs",
+      "require": "./dist/configWriter.cjs"
+    },
+    "./container": {
+      "types": "./dist/container.d.mts",
+      "import": "./dist/container.mjs",
+      "require": "./dist/container.cjs"
+    },
+    "./domains": {
+      "types": "./dist/domains.d.mts",
+      "import": "./dist/domains.mjs",
+      "require": "./dist/domains.cjs"
+    },
+    "./extensions/pi": {
+      "types": "./dist/extensions/pi.d.mts",
+      "import": "./dist/extensions/pi.mjs",
+      "require": "./dist/extensions/pi.cjs"
+    },
+    "./extensions/doom": {
+      "types": "./dist/extensions/doom.d.mts",
+      "import": "./dist/extensions/doom.mjs",
+      "require": "./dist/extensions/doom.cjs"
+    },
+    "./harnessState": {
+      "types": "./dist/harnessState.d.mts",
+      "import": "./dist/harnessState.mjs",
+      "require": "./dist/harnessState.cjs"
+    },
+    "./harnessStore": {
+      "types": "./dist/harnessStore.d.mts",
+      "import": "./dist/harnessStore.mjs",
+      "require": "./dist/harnessStore.cjs"
+    },
+    "./init": {
+      "types": "./dist/init.d.mts",
+      "import": "./dist/init.mjs",
+      "require": "./dist/init.cjs"
+    },
+    "./layeredConfig": {
+      "types": "./dist/layeredConfig.d.mts",
+      "import": "./dist/layeredConfig.mjs",
+      "require": "./dist/layeredConfig.cjs"
+    },
+    "./majorModes": {
+      "types": "./dist/majorModes.d.mts",
+      "import": "./dist/majorModes.mjs",
+      "require": "./dist/majorModes.cjs"
+    },
+    "./pi": {
+      "types": "./dist/pi.d.mts",
+      "import": "./dist/pi.mjs",
+      "require": "./dist/pi.cjs"
+    },
+    "./piContext": {
+      "types": "./dist/piContext.d.mts",
+      "import": "./dist/piContext.mjs",
+      "require": "./dist/piContext.cjs"
+    },
+    "./profiles": {
+      "types": "./dist/profiles.d.mts",
+      "import": "./dist/profiles.mjs",
+      "require": "./dist/profiles.cjs"
+    },
+    "./types": {
+      "types": "./dist/types.d.mts",
+      "import": "./dist/types.mjs",
+      "require": "./dist/types.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {
+    "inversify": "8.2.1",
+    "reflect-metadata": "0.2.2",
+    "yaml": "2.9.0",
+    "@agimon-ai/doompi-telemetry": "0.0.1-alpha.0"
+  },
+  "devDependencies": {
+    "@earendil-works/pi-coding-agent": "0.84.1",
+    "@types/node": "26.1.1",
+    "@vitest/coverage-v8": "4.1.10",
+    "tsdown": "0.22.14",
+    "typescript": "6.0.3",
+    "vitest": "4.1.10"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "0.84.1"
+  },
+  "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/skills/doom-pi-config/SKILL.md

@@ -0,0 +1,26 @@
+---
+name: doom-pi-config
+description: Configure and evolve Doom Pi major modes, layers, domains, profiles, and typed session configuration. Use for changes to .doom/modes.yaml, .doom/domains.yaml, .doom/profiles.yaml, .doom/hooks.yaml, their ~/.pi/.doom global counterparts, the @agimon-ai/doompi-config package, matrix switching commands, or requireDoomConfigContext consumers.
+---
+
+# Doom Pi Config
+
+Treat major modes, domains, and profiles as separate axes:
+
+- Major modes select one named set of layers, and layers select runtime behavior and extension packages.
+- Domains select content bundles such as skills, agents, hooks, and MCP allowlists.
+- Profiles select a persona plus environment defaults.
+
+## Workflow
+
+1. Read the current .doom files and the @agimon-ai/doompi-config types before editing.
+2. Put parsing and resolution in @agimon-ai/doompi-config, not in a launcher or UI package.
+3. Consume resolved session state through requireDoomConfigContext(ctx).harness.
+4. Keep process.env only as the parent-to-child transport and live-switch write boundary.
+5. After a matrix mutation, append a Doom config selection entry and call ctx.reload().
+6. Write each plugin path in .doom/domains.yaml in full, relative to the config that declares it (repo root, or ~/.pi/.doom for the global copy).
+7. Verify with Doom Config tests, Doom Pi tests, typecheck, ./pi.sh --domains <names> --explain, and an actual session smoke.
+
+Never cache resolved configuration at module scope. Context snapshots must be immutable and recreated after reload or session replacement.
+
+Read [references/config-contract.md](references/config-contract.md) for schemas, source locations, and the typed context contract.

package/skills/doom-pi-config/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Doom Pi Config"
+  short_description: "Configure Doom Pi layers, domains, and profiles"
+  default_prompt: "Use $doom-pi-config to update Doom Pi configuration safely."

package/skills/doom-pi-config/references/config-contract.md

@@ -0,0 +1,43 @@
+# Doom Pi configuration contract
+
+## Sources
+
+- `.doom/modes.yaml` defines layers and the major modes built from them. A layer may contribute extension entry names, package extension specifiers, and hook group IDs. A major mode is a named set of layers, and a session runs under exactly one.
+- `.doom/domains.yaml` defines content bundles. A domain may contribute whole plugins or filtered plugin parts, an MCP allowlist, and shared-skill behavior. Aliases expand to domain names.
+- `.doom/profiles.yaml` defines personas and environment defaults. Each persona path must remain inside `agents/`.
+- Every `.doom` document is read from `~/.pi/.doom/` first and `<repoRoot>/.doom/` second; a repository entry replaces the global one of the same name. Relative paths inside a document resolve against the config that declares it: the repository root, or `~/.pi/.doom` for the global copy.
+
+Parsing and resolution belong to `@agimon-ai/doompi-config` (`majorModes.ts`), `domains.ts`, and `profiles.ts`. Environment transport belongs to `harnessState.ts`. Pi context integration belongs to `piContext.ts`.
+
+## Typed context
+
+`@agimon-ai/doompi-config/pi` binds an immutable snapshot to the active Pi session. Consumers pass the handler context to a typed accessor:
+
+```ts
+const config = requireDoomConfigContext(ctx);
+config.settings;
+config.harness.majorMode;
+config.harness.domains;
+config.harness.profile;
+config.requiresRelaunch;
+```
+
+The provider reads the active session branch for the latest `doom-pi:config:v1` custom entry. Without one, it snapshots the launcher environment. Published Pi creates a fresh `ctx` object for calls, so Doom Config keys its binding by `ctx.sessionManager`. The extension replaces the binding on `session_start`. It keeps the binding available through every `session_shutdown` handler, then relies on the WeakMap key becoming collectible with Pi's session manager.
+
+## Live selection changes
+
+1. Resolve and validate the requested major mode, domains, or profile.
+2. Update the child process environment with `writeHarnessState()` or the focused switcher helper.
+3. Call `appendDoomConfigSelection(pi, selection)` so the session records the choice.
+4. Call `ctx.reload()` so all extensions receive fresh context and resources.
+
+Never mutate `config.harness`. Never cache `readHarnessState()` or resolved manifests at module scope.
+
+## Verification
+
+```sh
+pnpm nx test-unit @agimon-ai/doompi-config
+pnpm nx typecheck @agimon-ai/doompi-config
+pnpm nx test-unit @agimon-ai/doompi
+./pi.sh --domains development --explain
+```