@agimon-ai/doompi-profile 0.0.1-alpha.6 → 0.0.1-alpha.7

package/README.md

@@ -3,8 +3,8 @@
 Persona and environment profile switching for [DoomPi](https://www.npmjs.com/package/@agimon-ai/doompi)
 sessions.
 
-A **profile** is one of the four axes of a DoomPi selection, alongside domains, the major mode and
-the minor modes. It names a persona directory and a set of environment defaults:
+A **profile** is one of the four axes of a DoomPi selection, alongside domains, the major mode,
+and the minor modes. It names a persona directory and a set of environment defaults:
 
 ```yaml
 # .doom/profiles.yaml
@@ -17,21 +17,21 @@ profiles:
         REVIEW_STRICTNESS: high
 ```
 
-The persona is `profile.md`, `SOUL.md` and `AGENTS.md` concatenated from the named directory. The
+The persona is `profile.md`, `SOUL.md`, and `AGENTS.md` concatenated from the named directory. The
 harness assembles them into one file in the run directory and records its path; the persona entry
 appends that file to the system prompt on every agent start, so the repository's own `AGENTS.md`
 keeps applying underneath it.
 
 ## What it registers
 
-| Entry                  | Surface                                                                                 |
-| ---------------------- | --------------------------------------------------------------------------------------- |
-| `./extensions/pi`      | the `/profile` command — lists profiles, switches persona and environment, then reloads |
-| `./extensions/persona` | a `before_agent_start` hook that appends the active persona to the system prompt        |
+| Entry                  | Surface                                                                                      |
+| ---------------------- | -------------------------------------------------------------------------------------------- |
+| `./extensions/pi`      | the `/profile` command, which lists profiles, switches persona and environment, then reloads |
+| `./extensions/persona` | a `before_agent_start` hook that appends the active persona to the system prompt             |
 
-Two entries rather than one because a detached child session needs the persona but has no
-transition coordinator to run a switch through. DoomPi activates `./extensions/pi` in the parent
-and `./extensions/persona` in both.
+DoomPi uses two entries because a detached child session needs the persona but has no transition
+coordinator to run a switch through. DoomPi activates `./extensions/pi` in the parent and
+`./extensions/persona` in both.
 
 ## Switching
 
@@ -40,6 +40,26 @@ A profile change is always a `pi-reload`: the extension set does not change, but
 have to be dropped so every extension re-reads the environment. Active minor modes are captured
 before the reload and restored after it.
 
+## Configuration
+
+Personal profiles load from `~/.pi/.doom/profiles.yaml`, then repository profiles load from
+`.doom/profiles.yaml`. Roots discover either one persona folder or direct-child persona folders.
+Explicit entries provide a persona path and optional string environment defaults. Resolution runs
+from personal discovery to repository discovery, then personal explicit entries to repository
+explicit entries. A later profile replaces an earlier profile with the same name.
+
+Persona paths must stay inside the declaring config's `agents/` directory or a profile root from
+that same file. Directory and persona-file symlinks cannot escape those boundaries. See the
+shipped [profiles contract](./src/prompts/doompi-author-profile/references/profiles-contract.md) for
+the full configuration model and verification steps.
+
+## Help
+
+The package registers `doompi-author-profile` with the session's `doom/help` Cordis service. Its
+package guidance becomes visible to the AI only while the parent Help minor mode is active. The
+registration follows the Help provider lifecycle and is withdrawn when this package or the provider
+is disposed.
+
 ## Installation
 
 DoomPi depends on this package and activates it as fixed host core, so a DoomPi install already has

package/dist/adapters/pi/extension.cjs

@@ -1,2 +1,2 @@
-const e=require("../telemetry/logSinkTelemetry.cjs"),t=require("../../commands/profileCommand.cjs");let n=require("@agimon-ai/doompi-extension-contracts/config"),r=require("@agimon-ai/doompi-extension-contracts/cordis-host"),i=require("@agimon-ai/doompi-extension-contracts/transition");const a=`@agimon-ai/doompi-profile`;async function o(t,n=e.createProfileTelemetry()){let i=await(0,r.connectDoomCordisHost)(t,a),o=i.root.plugin(s,{pi:t,telemetry:n});try{await o}catch(e){try{await o.dispose()}finally{await i.dispose()}throw e}let c;t.on(`session_shutdown`,()=>c??=(async()=>{try{await o.dispose()}finally{await i.dispose()}})())}function s(e,r){let o;e.inject([n.DOOM_CONFIG_SERVICE,i.DOOM_TRANSITION_SERVICE],e=>(o=e,()=>{o===e&&(o=void 0)}));let s=()=>{if(!o)throw Error(`Doom profile runtime is waiting for the session config service.`);return o};e.effect(function*(){t.registerProfileCommand(r.pi,r.telemetry,s),yield()=>void 0},a)}exports.default=o,exports.profileExtension=o;
+const e=require("../telemetry/logSinkTelemetry.cjs"),t=require("../../commands/profileCommand.cjs");let n=require("@agimon-ai/doompi-extension-contracts/config"),r=require("@agimon-ai/doompi-extension-contracts/cordis-host"),i=require("@agimon-ai/doompi-extension-contracts/help"),a=require("@agimon-ai/doompi-extension-contracts/transition");const o=`@agimon-ai/doompi-profile`;async function s(t,n=e.createProfileTelemetry()){let i=await(0,r.connectDoomCordisHost)(t,o),a=i.root.plugin(c,{pi:t,telemetry:n});try{await a}catch(e){try{await a.dispose()}finally{await i.dispose()}throw e}let s;t.on(`session_shutdown`,()=>s??=(async()=>{try{await a.dispose()}finally{await i.dispose()}})())}function c(e,r){e.inject([i.DOOM_HELP_SERVICE],e=>{let t=(0,i.requireDoomHelpService)(e).register({source:o,moduleUrl:require("url").pathToFileURL(__filename).href,skills:[{name:`doompi-author-profile`,description:`Configure DoomPi profile discovery, personas, environment defaults, and precedence in profiles.yaml. Use when creating or changing personal or repository profiles. Do not use for config.yaml runtime settings, modes.yaml, or domains.yaml.`}]});return()=>t.dispose()});let s;e.inject([n.DOOM_CONFIG_SERVICE,a.DOOM_TRANSITION_SERVICE],e=>(s=e,()=>{s===e&&(s=void 0)}));let c=()=>{if(!s)throw Error(`Doom profile runtime is waiting for the session config service.`);return s};e.effect(function*(){t.registerProfileCommand(r.pi,r.telemetry,c),yield()=>void 0},o)}exports.default=s,exports.profileExtension=s;
 //# sourceMappingURL=extension.cjs.map

package/dist/adapters/pi/extension.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"extension.cjs","names":["createProfileTelemetry","connectDoomCordisHost","DOOM_CONFIG_SERVICE","DOOM_TRANSITION_SERVICE"],"sources":["../../../src/adapters/pi/extension.ts"],"sourcesContent":["import { DOOM_CONFIG_SERVICE } from '@agimon-ai/doompi-extension-contracts/config';\nimport { connectDoomCordisHost } from '@agimon-ai/doompi-extension-contracts/cordis-host';\nimport { DOOM_TRANSITION_SERVICE } from '@agimon-ai/doompi-extension-contracts/transition';\nimport type { Context } from '@deepseek-ai/cordis';\nimport type { ExtensionAPI } from '@earendil-works/pi-coding-agent';\nimport { registerProfileCommand } from '../../commands/profileCommand.ts';\nimport type { ProfileTelemetry } from '../../types/telemetry.ts';\nimport { createProfileTelemetry } from '../telemetry/logSinkTelemetry.ts';\n\nconst PACKAGE_SOURCE = '@agimon-ai/doompi-profile';\n\n/**\n * The package's single standard Pi factory.\n */\nexport async function profileExtension(\n  pi: ExtensionAPI,\n  telemetry: ProfileTelemetry = createProfileTelemetry(),\n): Promise<void> {\n  const connection = await connectDoomCordisHost(pi, PACKAGE_SOURCE);\n  const fiber = connection.root.plugin(profilePlugin, { pi, telemetry });\n  try {\n    await fiber;\n  } catch (error) {\n    try {\n      await fiber.dispose();\n    } finally {\n      await connection.dispose();\n    }\n    throw error;\n  }\n  let disposal: Promise<void> | undefined;\n  pi.on(\n    'session_shutdown',\n    () =>\n      (disposal ??= (async () => {\n        try {\n          await fiber.dispose();\n        } finally {\n          await connection.dispose();\n        }\n      })()),\n  );\n}\n\ninterface ProfilePluginConfig {\n  readonly pi: ExtensionAPI;\n  readonly telemetry: ProfileTelemetry;\n}\n\nfunction profilePlugin(cordis: Context, config: ProfilePluginConfig): void {\n  let activeContext: Context | undefined;\n  cordis.inject([DOOM_CONFIG_SERVICE, DOOM_TRANSITION_SERVICE], (context) => {\n    activeContext = context;\n    return () => {\n      if (activeContext === context) activeContext = undefined;\n    };\n  });\n  const requireRuntimeContext = (): Context => {\n    if (!activeContext) throw new Error('Doom profile runtime is waiting for the session config service.');\n    return activeContext;\n  };\n  cordis.effect(function* () {\n    registerProfileCommand(config.pi, config.telemetry, requireRuntimeContext);\n    yield () => undefined;\n  }, PACKAGE_SOURCE);\n}\n\nexport default profileExtension;\n"],"mappings":"+RASA,MAAM,EAAiB,4BAKvB,eAAsB,EACpB,EACA,EAA8BA,EAAAA,uBAAuB,EACtC,CACf,IAAM,EAAa,MAAA,EAAMC,EAAAA,sBAAAA,CAAsB,EAAI,CAAc,EAC3D,EAAQ,EAAW,KAAK,OAAO,EAAe,CAAE,KAAI,WAAU,CAAC,EACrE,GAAI,CACF,MAAM,CACR,OAAS,EAAO,CACd,GAAI,CACF,MAAM,EAAM,QAAQ,CACtB,QAAU,CACR,MAAM,EAAW,QAAQ,CAC3B,CACA,MAAM,CACR,CACA,IAAI,EACJ,EAAG,GACD,uBAEG,KAAc,SAAY,CACzB,GAAI,CACF,MAAM,EAAM,QAAQ,CACtB,QAAU,CACR,MAAM,EAAW,QAAQ,CAC3B,CACF,EAAA,CAAG,CACP,CACF,CAOA,SAAS,EAAc,EAAiB,EAAmC,CACzE,IAAI,EACJ,EAAO,OAAO,CAACC,EAAAA,oBAAqBC,EAAAA,uBAAuB,EAAI,IAC7D,EAAgB,MACH,CACP,IAAkB,IAAS,EAAgB,IAAA,GACjD,EACD,EACD,IAAM,MAAuC,CAC3C,GAAI,CAAC,EAAe,MAAU,MAAM,iEAAiE,EACrG,OAAO,CACT,EACA,EAAO,OAAO,WAAa,CACzB,EAAA,uBAAuB,EAAO,GAAI,EAAO,UAAW,CAAqB,EACzE,SAAY,IAAA,EACd,EAAG,CAAc,CACnB"}
+{"version":3,"file":"extension.cjs","names":["createProfileTelemetry","connectDoomCordisHost","DOOM_HELP_SERVICE","requireDoomHelpService","DOOM_CONFIG_SERVICE","DOOM_TRANSITION_SERVICE"],"sources":["../../../src/adapters/pi/extension.ts"],"sourcesContent":["import { DOOM_CONFIG_SERVICE } from '@agimon-ai/doompi-extension-contracts/config';\nimport { connectDoomCordisHost } from '@agimon-ai/doompi-extension-contracts/cordis-host';\nimport { DOOM_HELP_SERVICE, requireDoomHelpService } from '@agimon-ai/doompi-extension-contracts/help';\nimport { DOOM_TRANSITION_SERVICE } from '@agimon-ai/doompi-extension-contracts/transition';\nimport type { Context } from '@deepseek-ai/cordis';\nimport type { ExtensionAPI } from '@earendil-works/pi-coding-agent';\nimport { registerProfileCommand } from '../../commands/profileCommand.ts';\nimport type { ProfileTelemetry } from '../../types/telemetry.ts';\nimport { createProfileTelemetry } from '../telemetry/logSinkTelemetry.ts';\n\nconst PACKAGE_SOURCE = '@agimon-ai/doompi-profile';\n\n/**\n * The package's single standard Pi factory.\n */\nexport async function profileExtension(\n  pi: ExtensionAPI,\n  telemetry: ProfileTelemetry = createProfileTelemetry(),\n): Promise<void> {\n  const connection = await connectDoomCordisHost(pi, PACKAGE_SOURCE);\n  const fiber = connection.root.plugin(profilePlugin, { pi, telemetry });\n  try {\n    await fiber;\n  } catch (error) {\n    try {\n      await fiber.dispose();\n    } finally {\n      await connection.dispose();\n    }\n    throw error;\n  }\n  let disposal: Promise<void> | undefined;\n  pi.on(\n    'session_shutdown',\n    () =>\n      (disposal ??= (async () => {\n        try {\n          await fiber.dispose();\n        } finally {\n          await connection.dispose();\n        }\n      })()),\n  );\n}\n\ninterface ProfilePluginConfig {\n  readonly pi: ExtensionAPI;\n  readonly telemetry: ProfileTelemetry;\n}\n\nfunction profilePlugin(cordis: Context, config: ProfilePluginConfig): void {\n  cordis.inject([DOOM_HELP_SERVICE], (helpContext) => {\n    const contribution = requireDoomHelpService(helpContext).register({\n      source: PACKAGE_SOURCE,\n      moduleUrl: import.meta.url,\n      skills: [\n        {\n          name: 'doompi-author-profile',\n          description:\n            'Configure DoomPi profile discovery, personas, environment defaults, and precedence in profiles.yaml. Use when creating or changing personal or repository profiles. Do not use for config.yaml runtime settings, modes.yaml, or domains.yaml.',\n        },\n      ],\n    });\n    return () => contribution.dispose();\n  });\n\n  let activeContext: Context | undefined;\n  cordis.inject([DOOM_CONFIG_SERVICE, DOOM_TRANSITION_SERVICE], (context) => {\n    activeContext = context;\n    return () => {\n      if (activeContext === context) activeContext = undefined;\n    };\n  });\n  const requireRuntimeContext = (): Context => {\n    if (!activeContext) throw new Error('Doom profile runtime is waiting for the session config service.');\n    return activeContext;\n  };\n  cordis.effect(function* () {\n    registerProfileCommand(config.pi, config.telemetry, requireRuntimeContext);\n    yield () => undefined;\n  }, PACKAGE_SOURCE);\n}\n\nexport default profileExtension;\n"],"mappings":"uVAUA,MAAM,EAAiB,4BAKvB,eAAsB,EACpB,EACA,EAA8BA,EAAAA,uBAAuB,EACtC,CACf,IAAM,EAAa,MAAA,EAAMC,EAAAA,sBAAAA,CAAsB,EAAI,CAAc,EAC3D,EAAQ,EAAW,KAAK,OAAO,EAAe,CAAE,KAAI,WAAU,CAAC,EACrE,GAAI,CACF,MAAM,CACR,OAAS,EAAO,CACd,GAAI,CACF,MAAM,EAAM,QAAQ,CACtB,QAAU,CACR,MAAM,EAAW,QAAQ,CAC3B,CACA,MAAM,CACR,CACA,IAAI,EACJ,EAAG,GACD,uBAEG,KAAc,SAAY,CACzB,GAAI,CACF,MAAM,EAAM,QAAQ,CACtB,QAAU,CACR,MAAM,EAAW,QAAQ,CAC3B,CACF,EAAA,CAAG,CACP,CACF,CAOA,SAAS,EAAc,EAAiB,EAAmC,CACzE,EAAO,OAAO,CAACC,EAAAA,iBAAiB,EAAI,GAAgB,CAClD,IAAM,GAAA,EAAeC,EAAAA,uBAAAA,CAAuB,CAAW,CAAC,CAAC,SAAS,CAChE,OAAQ,EACR,UAAA,QAAA,KAAA,CAAA,CAAA,cAAA,UAAA,CAAA,CAAA,KACA,OAAQ,CACN,CACE,KAAM,wBACN,YACE,+OACJ,CACF,CACF,CAAC,EACD,UAAa,EAAa,QAAQ,CACpC,CAAC,EAED,IAAI,EACJ,EAAO,OAAO,CAACC,EAAAA,oBAAqBC,EAAAA,uBAAuB,EAAI,IAC7D,EAAgB,MACH,CACP,IAAkB,IAAS,EAAgB,IAAA,GACjD,EACD,EACD,IAAM,MAAuC,CAC3C,GAAI,CAAC,EAAe,MAAU,MAAM,iEAAiE,EACrG,OAAO,CACT,EACA,EAAO,OAAO,WAAa,CACzB,EAAA,uBAAuB,EAAO,GAAI,EAAO,UAAW,CAAqB,EACzE,SAAY,IAAA,EACd,EAAG,CAAc,CACnB"}

package/dist/adapters/pi/extension.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"extension.d.cts","names":[],"sources":["../../../src/adapters/pi/extension.ts"],"mappings":";;;;;;iBAcsB,iBACpB,IAAI,cACJ,YAAW,mBACV"}
+{"version":3,"file":"extension.d.cts","names":[],"sources":["../../../src/adapters/pi/extension.ts"],"mappings":";;;;;;iBAesB,iBACpB,IAAI,cACJ,YAAW,mBACV"}

package/dist/adapters/pi/extension.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"extension.d.mts","names":[],"sources":["../../../src/adapters/pi/extension.ts"],"mappings":";;;;;;iBAcsB,iBACpB,IAAI,cACJ,YAAW,mBACV"}
+{"version":3,"file":"extension.d.mts","names":[],"sources":["../../../src/adapters/pi/extension.ts"],"mappings":";;;;;;iBAesB,iBACpB,IAAI,cACJ,YAAW,mBACV"}

package/dist/adapters/pi/extension.mjs

@@ -1,2 +1,2 @@
-import{createProfileTelemetry as e}from"../telemetry/logSinkTelemetry.mjs";import{registerProfileCommand as t}from"../../commands/profileCommand.mjs";import{DOOM_CONFIG_SERVICE as n}from"@agimon-ai/doompi-extension-contracts/config";import{connectDoomCordisHost as r}from"@agimon-ai/doompi-extension-contracts/cordis-host";import{DOOM_TRANSITION_SERVICE as i}from"@agimon-ai/doompi-extension-contracts/transition";const a=`@agimon-ai/doompi-profile`;async function o(t,n=e()){let i=await r(t,a),o=i.root.plugin(s,{pi:t,telemetry:n});try{await o}catch(e){try{await o.dispose()}finally{await i.dispose()}throw e}let c;t.on(`session_shutdown`,()=>c??=(async()=>{try{await o.dispose()}finally{await i.dispose()}})())}function s(e,r){let o;e.inject([n,i],e=>(o=e,()=>{o===e&&(o=void 0)}));let s=()=>{if(!o)throw Error(`Doom profile runtime is waiting for the session config service.`);return o};e.effect(function*(){t(r.pi,r.telemetry,s),yield()=>void 0},a)}export{o as default,o as profileExtension};
+import{createProfileTelemetry as e}from"../telemetry/logSinkTelemetry.mjs";import{registerProfileCommand as t}from"../../commands/profileCommand.mjs";import{DOOM_CONFIG_SERVICE as n}from"@agimon-ai/doompi-extension-contracts/config";import{connectDoomCordisHost as r}from"@agimon-ai/doompi-extension-contracts/cordis-host";import{DOOM_HELP_SERVICE as i,requireDoomHelpService as a}from"@agimon-ai/doompi-extension-contracts/help";import{DOOM_TRANSITION_SERVICE as o}from"@agimon-ai/doompi-extension-contracts/transition";const s=`@agimon-ai/doompi-profile`;async function c(t,n=e()){let i=await r(t,s),a=i.root.plugin(l,{pi:t,telemetry:n});try{await a}catch(e){try{await a.dispose()}finally{await i.dispose()}throw e}let o;t.on(`session_shutdown`,()=>o??=(async()=>{try{await a.dispose()}finally{await i.dispose()}})())}function l(e,r){e.inject([i],e=>{let t=a(e).register({source:s,moduleUrl:import.meta.url,skills:[{name:`doompi-author-profile`,description:`Configure DoomPi profile discovery, personas, environment defaults, and precedence in profiles.yaml. Use when creating or changing personal or repository profiles. Do not use for config.yaml runtime settings, modes.yaml, or domains.yaml.`}]});return()=>t.dispose()});let c;e.inject([n,o],e=>(c=e,()=>{c===e&&(c=void 0)}));let l=()=>{if(!c)throw Error(`Doom profile runtime is waiting for the session config service.`);return c};e.effect(function*(){t(r.pi,r.telemetry,l),yield()=>void 0},s)}export{c as default,c as profileExtension};
 //# sourceMappingURL=extension.mjs.map

package/dist/adapters/pi/extension.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"extension.mjs","names":[],"sources":["../../../src/adapters/pi/extension.ts"],"sourcesContent":["import { DOOM_CONFIG_SERVICE } from '@agimon-ai/doompi-extension-contracts/config';\nimport { connectDoomCordisHost } from '@agimon-ai/doompi-extension-contracts/cordis-host';\nimport { DOOM_TRANSITION_SERVICE } from '@agimon-ai/doompi-extension-contracts/transition';\nimport type { Context } from '@deepseek-ai/cordis';\nimport type { ExtensionAPI } from '@earendil-works/pi-coding-agent';\nimport { registerProfileCommand } from '../../commands/profileCommand.ts';\nimport type { ProfileTelemetry } from '../../types/telemetry.ts';\nimport { createProfileTelemetry } from '../telemetry/logSinkTelemetry.ts';\n\nconst PACKAGE_SOURCE = '@agimon-ai/doompi-profile';\n\n/**\n * The package's single standard Pi factory.\n */\nexport async function profileExtension(\n  pi: ExtensionAPI,\n  telemetry: ProfileTelemetry = createProfileTelemetry(),\n): Promise<void> {\n  const connection = await connectDoomCordisHost(pi, PACKAGE_SOURCE);\n  const fiber = connection.root.plugin(profilePlugin, { pi, telemetry });\n  try {\n    await fiber;\n  } catch (error) {\n    try {\n      await fiber.dispose();\n    } finally {\n      await connection.dispose();\n    }\n    throw error;\n  }\n  let disposal: Promise<void> | undefined;\n  pi.on(\n    'session_shutdown',\n    () =>\n      (disposal ??= (async () => {\n        try {\n          await fiber.dispose();\n        } finally {\n          await connection.dispose();\n        }\n      })()),\n  );\n}\n\ninterface ProfilePluginConfig {\n  readonly pi: ExtensionAPI;\n  readonly telemetry: ProfileTelemetry;\n}\n\nfunction profilePlugin(cordis: Context, config: ProfilePluginConfig): void {\n  let activeContext: Context | undefined;\n  cordis.inject([DOOM_CONFIG_SERVICE, DOOM_TRANSITION_SERVICE], (context) => {\n    activeContext = context;\n    return () => {\n      if (activeContext === context) activeContext = undefined;\n    };\n  });\n  const requireRuntimeContext = (): Context => {\n    if (!activeContext) throw new Error('Doom profile runtime is waiting for the session config service.');\n    return activeContext;\n  };\n  cordis.effect(function* () {\n    registerProfileCommand(config.pi, config.telemetry, requireRuntimeContext);\n    yield () => undefined;\n  }, PACKAGE_SOURCE);\n}\n\nexport default profileExtension;\n"],"mappings":"8ZASA,MAAM,EAAiB,4BAKvB,eAAsB,EACpB,EACA,EAA8B,EAAuB,EACtC,CACf,IAAM,EAAa,MAAM,EAAsB,EAAI,CAAc,EAC3D,EAAQ,EAAW,KAAK,OAAO,EAAe,CAAE,KAAI,WAAU,CAAC,EACrE,GAAI,CACF,MAAM,CACR,OAAS,EAAO,CACd,GAAI,CACF,MAAM,EAAM,QAAQ,CACtB,QAAU,CACR,MAAM,EAAW,QAAQ,CAC3B,CACA,MAAM,CACR,CACA,IAAI,EACJ,EAAG,GACD,uBAEG,KAAc,SAAY,CACzB,GAAI,CACF,MAAM,EAAM,QAAQ,CACtB,QAAU,CACR,MAAM,EAAW,QAAQ,CAC3B,CACF,EAAA,CAAG,CACP,CACF,CAOA,SAAS,EAAc,EAAiB,EAAmC,CACzE,IAAI,EACJ,EAAO,OAAO,CAAC,EAAqB,CAAuB,EAAI,IAC7D,EAAgB,MACH,CACP,IAAkB,IAAS,EAAgB,IAAA,GACjD,EACD,EACD,IAAM,MAAuC,CAC3C,GAAI,CAAC,EAAe,MAAU,MAAM,iEAAiE,EACrG,OAAO,CACT,EACA,EAAO,OAAO,WAAa,CACzB,EAAuB,EAAO,GAAI,EAAO,UAAW,CAAqB,EACzE,SAAY,IAAA,EACd,EAAG,CAAc,CACnB"}
+{"version":3,"file":"extension.mjs","names":[],"sources":["../../../src/adapters/pi/extension.ts"],"sourcesContent":["import { DOOM_CONFIG_SERVICE } from '@agimon-ai/doompi-extension-contracts/config';\nimport { connectDoomCordisHost } from '@agimon-ai/doompi-extension-contracts/cordis-host';\nimport { DOOM_HELP_SERVICE, requireDoomHelpService } from '@agimon-ai/doompi-extension-contracts/help';\nimport { DOOM_TRANSITION_SERVICE } from '@agimon-ai/doompi-extension-contracts/transition';\nimport type { Context } from '@deepseek-ai/cordis';\nimport type { ExtensionAPI } from '@earendil-works/pi-coding-agent';\nimport { registerProfileCommand } from '../../commands/profileCommand.ts';\nimport type { ProfileTelemetry } from '../../types/telemetry.ts';\nimport { createProfileTelemetry } from '../telemetry/logSinkTelemetry.ts';\n\nconst PACKAGE_SOURCE = '@agimon-ai/doompi-profile';\n\n/**\n * The package's single standard Pi factory.\n */\nexport async function profileExtension(\n  pi: ExtensionAPI,\n  telemetry: ProfileTelemetry = createProfileTelemetry(),\n): Promise<void> {\n  const connection = await connectDoomCordisHost(pi, PACKAGE_SOURCE);\n  const fiber = connection.root.plugin(profilePlugin, { pi, telemetry });\n  try {\n    await fiber;\n  } catch (error) {\n    try {\n      await fiber.dispose();\n    } finally {\n      await connection.dispose();\n    }\n    throw error;\n  }\n  let disposal: Promise<void> | undefined;\n  pi.on(\n    'session_shutdown',\n    () =>\n      (disposal ??= (async () => {\n        try {\n          await fiber.dispose();\n        } finally {\n          await connection.dispose();\n        }\n      })()),\n  );\n}\n\ninterface ProfilePluginConfig {\n  readonly pi: ExtensionAPI;\n  readonly telemetry: ProfileTelemetry;\n}\n\nfunction profilePlugin(cordis: Context, config: ProfilePluginConfig): void {\n  cordis.inject([DOOM_HELP_SERVICE], (helpContext) => {\n    const contribution = requireDoomHelpService(helpContext).register({\n      source: PACKAGE_SOURCE,\n      moduleUrl: import.meta.url,\n      skills: [\n        {\n          name: 'doompi-author-profile',\n          description:\n            'Configure DoomPi profile discovery, personas, environment defaults, and precedence in profiles.yaml. Use when creating or changing personal or repository profiles. Do not use for config.yaml runtime settings, modes.yaml, or domains.yaml.',\n        },\n      ],\n    });\n    return () => contribution.dispose();\n  });\n\n  let activeContext: Context | undefined;\n  cordis.inject([DOOM_CONFIG_SERVICE, DOOM_TRANSITION_SERVICE], (context) => {\n    activeContext = context;\n    return () => {\n      if (activeContext === context) activeContext = undefined;\n    };\n  });\n  const requireRuntimeContext = (): Context => {\n    if (!activeContext) throw new Error('Doom profile runtime is waiting for the session config service.');\n    return activeContext;\n  };\n  cordis.effect(function* () {\n    registerProfileCommand(config.pi, config.telemetry, requireRuntimeContext);\n    yield () => undefined;\n  }, PACKAGE_SOURCE);\n}\n\nexport default profileExtension;\n"],"mappings":"ygBAUA,MAAM,EAAiB,4BAKvB,eAAsB,EACpB,EACA,EAA8B,EAAuB,EACtC,CACf,IAAM,EAAa,MAAM,EAAsB,EAAI,CAAc,EAC3D,EAAQ,EAAW,KAAK,OAAO,EAAe,CAAE,KAAI,WAAU,CAAC,EACrE,GAAI,CACF,MAAM,CACR,OAAS,EAAO,CACd,GAAI,CACF,MAAM,EAAM,QAAQ,CACtB,QAAU,CACR,MAAM,EAAW,QAAQ,CAC3B,CACA,MAAM,CACR,CACA,IAAI,EACJ,EAAG,GACD,uBAEG,KAAc,SAAY,CACzB,GAAI,CACF,MAAM,EAAM,QAAQ,CACtB,QAAU,CACR,MAAM,EAAW,QAAQ,CAC3B,CACF,EAAA,CAAG,CACP,CACF,CAOA,SAAS,EAAc,EAAiB,EAAmC,CACzE,EAAO,OAAO,CAAC,CAAiB,EAAI,GAAgB,CAClD,IAAM,EAAe,EAAuB,CAAW,CAAC,CAAC,SAAS,CAChE,OAAQ,EACR,UAAW,YAAY,IACvB,OAAQ,CACN,CACE,KAAM,wBACN,YACE,+OACJ,CACF,CACF,CAAC,EACD,UAAa,EAAa,QAAQ,CACpC,CAAC,EAED,IAAI,EACJ,EAAO,OAAO,CAAC,EAAqB,CAAuB,EAAI,IAC7D,EAAgB,MACH,CACP,IAAkB,IAAS,EAAgB,IAAA,GACjD,EACD,EACD,IAAM,MAAuC,CAC3C,GAAI,CAAC,EAAe,MAAU,MAAM,iEAAiE,EACrG,OAAO,CACT,EACA,EAAO,OAAO,WAAa,CACzB,EAAuB,EAAO,GAAI,EAAO,UAAW,CAAqB,EACzE,SAAY,IAAA,EACd,EAAG,CAAc,CACnB"}

package/llms.txt

@@ -1,7 +1,12 @@
 # Doom Pi Profile
 
-Persona and environment profile switching for Doom Pi sessions.
+Package-owned guidance for DoomPi profile discovery, personas, environment defaults, and precedence.
 
-## Resources
+## How to author
 
-- [Package README](./README.md): the `/profile` command, the persona system-prompt entry, and how a profile resolves.
+- [Author DoomPi profiles](./src/prompts/doompi-author-profile/SKILL.md): Configure personal and repository profiles.
+- [Profiles authoring contract](./src/prompts/doompi-author-profile/references/profiles-contract.md): File locations, discovery, precedence, path safety, environment defaults, and verification.
+
+## Package reference
+
+- [Package README](./README.md): Profile behavior, activation, and public package entries.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agimon-ai/doompi-profile",
-  "version": "0.0.1-alpha.6",
+  "version": "0.0.1-alpha.7",
   "description": "Persona and environment profile switching for DoomPi sessions.",
   "keywords": [
     "agent-persona",
@@ -21,6 +21,7 @@
     "dist",
     "llms.txt",
     "README.md",
+    "src/prompts",
     "LICENSE",
     "package.json"
   ],
@@ -51,13 +52,12 @@
   },
   "dependencies": {
     "@deepseek-ai/cordis": "4.0.1",
-    "@agimon-ai/doompi-config": "0.0.1-alpha.28",
-    "@agimon-ai/doompi-telemetry": "0.0.1-alpha.28",
-    "@agimon-ai/doompi-ui": "0.0.1-alpha.28",
-    "@agimon-ai/doompi-extension-contracts": "0.0.1-alpha.28"
+    "@agimon-ai/doompi-config": "0.0.1-alpha.29",
+    "@agimon-ai/doompi-extension-contracts": "0.0.1-alpha.29",
+    "@agimon-ai/doompi-telemetry": "0.0.1-alpha.29",
+    "@agimon-ai/doompi-ui": "0.0.1-alpha.29"
   },
   "devDependencies": {
-    "@agimon-ai/vibe-lint-plugin-doom-extension": "0.0.1-alpha.26",
     "@deepseek-ai/cordis": "4.0.1",
     "@earendil-works/pi-coding-agent": "0.84.2",
     "@earendil-works/pi-tui": "0.84.2",
@@ -65,7 +65,8 @@
     "@vitest/coverage-v8": "4.1.11",
     "tsdown": "0.22.14",
     "typescript": "7.0.2",
-    "vitest": "4.1.11"
+    "vitest": "4.1.11",
+    "@agimon-ai/vibe-lint-plugin-doom-extension": "0.0.1-alpha.27"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "0.84.2",

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

@@ -0,0 +1,20 @@
+---
+name: doompi-author-profile
+description: Configure DoomPi profile discovery, personas, environment defaults, and precedence in profiles.yaml. Use when creating or changing personal or repository profiles. Do not use for config.yaml runtime settings, modes.yaml, or domains.yaml.
+---
+
+# Author DoomPi profiles
+
+Configure a profile as one persona plus optional environment defaults.
+
+## Workflow
+
+1. Read both `~/.pi/.doom/profiles.yaml` and the repository's `.doom/profiles.yaml` when they exist.
+2. Use `profiles.roots` for one-level persona discovery. Use `profiles.entries` when a profile needs an explicit persona path or environment defaults.
+3. Resolve relative roots and persona paths against the file that declares them. Keep an explicit persona inside that file's `agents/` directory or one of its configured roots.
+4. Put instructions in `profile.md`, `SOUL.md`, or `AGENTS.md`. DoomPi concatenates non-empty files in that order.
+5. Keep every `env` value a string. Treat it as a default because an already exported value wins.
+6. Preserve the precedence rules. Explicit entries override discoveries, and repository entries override personal entries at the same precedence level.
+7. Verify the selection with `doompi --profile <name> --explain`, then smoke-test `/profile` when changing live switching behavior.
+
+Read [references/profiles-contract.md](references/profiles-contract.md) before changing discovery, precedence, path handling, or profile application.

package/src/prompts/doompi-author-profile/references/profiles-contract.md

@@ -0,0 +1,100 @@
+# DoomPi profiles authoring contract
+
+## Sources and shape
+
+DoomPi reads profile declarations in this order:
+
+1. `~/.pi/.doom/profiles.yaml`
+2. `<repoRoot>/.doom/profiles.yaml`
+
+The current catalog shape is:
+
+```yaml
+profiles:
+  roots: [agents/acme]
+  entries:
+    writer:
+      persona: agents/special/writer
+      env:
+        BRAND: acme
+        TONE: concise
+```
+
+The document may contain only the `profiles` mapping. In catalog form, `profiles` may contain only
+`roots` and `entries`. DoomPi still accepts the earlier flat form, where profile names appear
+directly below `profiles`, but new configuration should use catalog form.
+
+Every relative root or persona path resolves against the file that declares it. Repository paths
+resolve from the repository root. Personal paths resolve from `~/.pi/.doom`.
+
+## Root discovery
+
+Each `profiles.roots` value must resolve to an existing directory.
+
+- If the root directly contains `profile.md`, `SOUL.md`, or `AGENTS.md`, the root is one profile.
+  Its directory name is the profile name, and its children are not scanned.
+- Otherwise, DoomPi inspects only the root's direct-child directories. A child becomes a profile
+  when it directly contains at least one persona file.
+- Discovery does not recurse. Add another root or an explicit entry for a deeper persona.
+- A discovered profile has an empty environment mapping.
+- Unreadable candidates and candidates whose real path or persona files escape the configured root
+  are ignored. An invalid configured root itself is an error.
+
+## Explicit entries and path confinement
+
+An explicit entry may contain only `persona` and `env`. `persona` is required, must be a non-empty
+relative path, and must resolve to a directory containing readable persona content.
+
+The persona must remain inside either:
+
+- the `agents/` directory beside the declaring repository root or personal `.doom` directory, or
+- one of the `profiles.roots` directories declared in that same file.
+
+DoomPi checks both the lexical path and the real filesystem path. A persona-directory symlink cannot
+escape an allowed root. Each resolved persona file must also remain inside the real persona
+directory, so a file symlink cannot import instructions from outside it. Invalid explicit entries
+fail loading instead of being skipped.
+
+Persona content is assembled from non-empty files in this order:
+
+1. `profile.md`
+2. `SOUL.md`
+3. `AGENTS.md`
+
+## Precedence
+
+DoomPi resolves names in four passes, from lowest to highest precedence:
+
+1. Personal root discoveries
+2. Repository root discoveries
+3. Personal explicit entries
+4. Repository explicit entries
+
+A later profile replaces an earlier profile with the same name. This means any explicit entry
+overrides discovery, including a personal explicit entry replacing a repository discovery. A
+repository explicit entry wins over a personal explicit entry. Unrelated names from all sources
+remain available, and the final list is sorted by profile name.
+
+## Environment defaults and activation
+
+Every `env` key maps to a string. Applying a profile writes only variables that are not already
+exported by the caller. When switching profiles, DoomPi removes a value contributed by the previous
+profile only if that value has not since changed, then applies the next profile's defaults.
+
+The `/profile` command resolves the named profile and executes the change through the session
+transition coordinator. A profile change uses Pi reload so extensions re-read the environment.
+DoomPi assembles the persona into a private run-directory file, and the persona Pi entry appends
+that content to the system prompt after reload.
+
+## Verification
+
+```sh
+pnpm nx test @agimon-ai/doompi-config
+pnpm nx typecheck @agimon-ai/doompi-config
+pnpm nx test @agimon-ai/doompi-profile
+pnpm nx typecheck @agimon-ai/doompi-profile
+pnpm --filter @agimon-ai/doompi exec doompi --profile writer --explain
+```
+
+Use an actual parent session to smoke-test `/profile` when changing transition, environment, or
+persona application behavior.