@agimon-ai/doompi-profile 0.0.1-alpha.4 → 0.0.1-alpha.42

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("../../types/telemetry.cjs"),n=require("../../services/profileText.cjs"),r=require("../../commands/profileCommand.cjs");let i=require("@agimon-ai/doompi-extension-contracts/config"),a=require("@agimon-ai/doompi-extension-contracts/cordis-host"),o=require("@agimon-ai/doompi-config/piContext"),s=require("@agimon-ai/doompi-extension-contracts/help"),c=require("@agimon-ai/doompi-extension-contracts/transition");const l=`@agimon-ai/doompi-profile`;async function u(e,n){try{let[{requireHarnessRoot:t},{loadProfiles:n}]=await Promise.all([import(`@agimon-ai/doompi-config/harnessStore`),import(`@agimon-ai/doompi-config/profiles`)]);return n(t(e)).length>0}catch(e){return n.recordError(t.PROFILE_EVENT.profileLoadFailed,e),!0}}async function d(t,n=e.createProfileTelemetry()){let r=await(0,a.connectDoomCordisHost)(t,l),i=r.root.plugin(f,{pi:t,telemetry:n});try{await i}catch(e){try{await i.dispose()}finally{await r.dispose()}throw e}let o;t.on(`session_shutdown`,()=>o??=(async()=>{try{await i.dispose()}finally{await r.dispose()}})())}function f(e,t){e.inject([s.DOOM_HELP_SERVICE],e=>{let t=(0,s.requireDoomHelpService)(e).register({source:l,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 a,d=e.inject([i.DOOM_CONFIG_SERVICE,c.DOOM_TRANSITION_SERVICE],e=>(a=e,()=>{a===e&&(a=void 0)})),f=()=>{if(!a)throw Error(`Doom profile runtime is waiting for the session config service.`);return a};e.effect(function*(){r.registerProfileCommand(t.pi,t.telemetry,f),t.pi.on(`session_start`,async(e,r)=>{await d.await();let i=(0,o.requireDoomConfigContext)(f()).harness,a=n.profileStatus(i.profile,await u(i,t.telemetry));a!==void 0&&r.ui.setStatus(n.PROFILE_STATUS_KEY,a)}),yield()=>void 0},l)}exports.default=d,exports.profileExtension=d;
 //# 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":["PROFILE_EVENT","createProfileTelemetry","connectDoomCordisHost","DOOM_HELP_SERVICE","requireDoomHelpService","DOOM_CONFIG_SERVICE","DOOM_TRANSITION_SERVICE","requireDoomConfigContext","profileStatus","PROFILE_STATUS_KEY"],"sources":["../../../src/adapters/pi/extension.ts"],"sourcesContent":["import type { HarnessState } from '@agimon-ai/doompi-config/types';\nimport { requireDoomConfigContext } from '@agimon-ai/doompi-config/piContext';\nimport { 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 { PROFILE_STATUS_KEY, profileStatus } from '../../services/profileText.ts';\nimport { PROFILE_EVENT, type ProfileTelemetry } from '../../types/telemetry.ts';\nimport { createProfileTelemetry } from '../telemetry/logSinkTelemetry.ts';\n\nconst PACKAGE_SOURCE = '@agimon-ai/doompi-profile';\n\n/**\n * Whether the session has any profiles to offer. Reading the catalogue is\n * the one startup cost the axis needs; a broken catalogue reports true so\n * the axis stays on the bar and /profile can explain the failure.\n */\nasync function profileCatalogueExists(\n  state: Pick<HarnessState, 'root'>,\n  telemetry: ProfileTelemetry,\n): Promise<boolean> {\n  try {\n    const [{ requireHarnessRoot }, { loadProfiles }] = await Promise.all([\n      import('@agimon-ai/doompi-config/harnessStore'),\n      import('@agimon-ai/doompi-config/profiles'),\n    ]);\n    return loadProfiles(requireHarnessRoot(state)).length > 0;\n  } catch (error) {\n    void telemetry.recordError(PROFILE_EVENT.profileLoadFailed, error);\n    return true;\n  }\n}\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  const runtimeInjection = 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    config.pi.on('session_start', async (_event, ctx) => {\n      await runtimeInjection.await();\n      const state = requireDoomConfigContext(requireRuntimeContext()).harness;\n      const status = profileStatus(state.profile, await profileCatalogueExists(state, config.telemetry));\n      if (status !== undefined) ctx.ui.setStatus(PROFILE_STATUS_KEY, status);\n    });\n    yield () => undefined;\n  }, PACKAGE_SOURCE);\n}\n\nexport default profileExtension;\n"],"mappings":"0dAaA,MAAM,EAAiB,4BAOvB,eAAe,EACb,EACA,EACkB,CAClB,GAAI,CACF,GAAM,CAAC,CAAE,sBAAsB,CAAE,iBAAkB,MAAM,QAAQ,IAAI,CACnE,OAAO,yCACP,OAAO,oCACT,CAAC,EACD,OAAO,EAAa,EAAmB,CAAK,CAAC,CAAC,CAAC,OAAS,CAC1D,OAAS,EAAO,CAEd,OADA,EAAe,YAAYA,EAAAA,cAAc,kBAAmB,CAAK,EAC1D,EACT,CACF,CAKA,eAAsB,EACpB,EACA,EAA8BC,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,EACE,EAAmB,EAAO,OAAO,CAACC,EAAAA,oBAAqBC,EAAAA,uBAAuB,EAAI,IACtF,EAAgB,MACH,CACP,IAAkB,IAAS,EAAgB,IAAA,GACjD,EACD,EACK,MAAuC,CAC3C,GAAI,CAAC,EAAe,MAAU,MAAM,iEAAiE,EACrG,OAAO,CACT,EACA,EAAO,OAAO,WAAa,CACzB,EAAA,uBAAuB,EAAO,GAAI,EAAO,UAAW,CAAqB,EACzE,EAAO,GAAG,GAAG,gBAAiB,MAAO,EAAQ,IAAQ,CACnD,MAAM,EAAiB,MAAM,EAC7B,IAAM,GAAA,EAAQC,EAAAA,yBAAAA,CAAyB,EAAsB,CAAC,CAAC,CAAC,QAC1D,EAASC,EAAAA,cAAc,EAAM,QAAS,MAAM,EAAuB,EAAO,EAAO,SAAS,CAAC,EAC7F,IAAW,IAAA,IAAW,EAAI,GAAG,UAAUC,EAAAA,mBAAoB,CAAM,CACvE,CAAC,EACD,SAAY,IAAA,EACd,EAAG,CAAc,CACnB"}

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

@@ -4,7 +4,7 @@ import { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 /**
  * The package's single standard Pi factory.
  */
-declare function profileExtension(pi: ExtensionAPI, telemetry?: ProfileTelemetry): Promise<void>;
+export declare function profileExtension(pi: ExtensionAPI, telemetry?: ProfileTelemetry): Promise<void>;
 //#endregion
-export { profileExtension as default, profileExtension };
+export { profileExtension as default };
 //# sourceMappingURL=extension.d.cts.map

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":";;;;;;wBAuCsB,iBACpB,IAAI,cACJ,YAAW,mBACV"}

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

@@ -4,7 +4,7 @@ import { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 /**
  * The package's single standard Pi factory.
  */
-declare function profileExtension(pi: ExtensionAPI, telemetry?: ProfileTelemetry): Promise<void>;
+export declare function profileExtension(pi: ExtensionAPI, telemetry?: ProfileTelemetry): Promise<void>;
 //#endregion
-export { profileExtension as default, profileExtension };
+export { profileExtension as default };
 //# sourceMappingURL=extension.d.mts.map

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":";;;;;;wBAuCsB,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{PROFILE_EVENT as t}from"../../types/telemetry.mjs";import{PROFILE_STATUS_KEY as n,profileStatus as r}from"../../services/profileText.mjs";import{registerProfileCommand as i}from"../../commands/profileCommand.mjs";import{DOOM_CONFIG_SERVICE as a}from"@agimon-ai/doompi-extension-contracts/config";import{connectDoomCordisHost as o}from"@agimon-ai/doompi-extension-contracts/cordis-host";import{requireDoomConfigContext as s}from"@agimon-ai/doompi-config/piContext";import{DOOM_HELP_SERVICE as c,requireDoomHelpService as l}from"@agimon-ai/doompi-extension-contracts/help";import{DOOM_TRANSITION_SERVICE as u}from"@agimon-ai/doompi-extension-contracts/transition";const d=`@agimon-ai/doompi-profile`;async function f(e,n){try{let[{requireHarnessRoot:t},{loadProfiles:n}]=await Promise.all([import(`@agimon-ai/doompi-config/harnessStore`),import(`@agimon-ai/doompi-config/profiles`)]);return n(t(e)).length>0}catch(e){return n.recordError(t.profileLoadFailed,e),!0}}async function p(t,n=e()){let r=await o(t,d),i=r.root.plugin(m,{pi:t,telemetry:n});try{await i}catch(e){try{await i.dispose()}finally{await r.dispose()}throw e}let a;t.on(`session_shutdown`,()=>a??=(async()=>{try{await i.dispose()}finally{await r.dispose()}})())}function m(e,t){e.inject([c],e=>{let t=l(e).register({source:d,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 o,p=e.inject([a,u],e=>(o=e,()=>{o===e&&(o=void 0)})),m=()=>{if(!o)throw Error(`Doom profile runtime is waiting for the session config service.`);return o};e.effect(function*(){i(t.pi,t.telemetry,m),t.pi.on(`session_start`,async(e,i)=>{await p.await();let a=s(m()).harness,o=r(a.profile,await f(a,t.telemetry));o!==void 0&&i.ui.setStatus(n,o)}),yield()=>void 0},d)}export{p as default,p 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 type { HarnessState } from '@agimon-ai/doompi-config/types';\nimport { requireDoomConfigContext } from '@agimon-ai/doompi-config/piContext';\nimport { 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 { PROFILE_STATUS_KEY, profileStatus } from '../../services/profileText.ts';\nimport { PROFILE_EVENT, type ProfileTelemetry } from '../../types/telemetry.ts';\nimport { createProfileTelemetry } from '../telemetry/logSinkTelemetry.ts';\n\nconst PACKAGE_SOURCE = '@agimon-ai/doompi-profile';\n\n/**\n * Whether the session has any profiles to offer. Reading the catalogue is\n * the one startup cost the axis needs; a broken catalogue reports true so\n * the axis stays on the bar and /profile can explain the failure.\n */\nasync function profileCatalogueExists(\n  state: Pick<HarnessState, 'root'>,\n  telemetry: ProfileTelemetry,\n): Promise<boolean> {\n  try {\n    const [{ requireHarnessRoot }, { loadProfiles }] = await Promise.all([\n      import('@agimon-ai/doompi-config/harnessStore'),\n      import('@agimon-ai/doompi-config/profiles'),\n    ]);\n    return loadProfiles(requireHarnessRoot(state)).length > 0;\n  } catch (error) {\n    void telemetry.recordError(PROFILE_EVENT.profileLoadFailed, error);\n    return true;\n  }\n}\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  const runtimeInjection = 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    config.pi.on('session_start', async (_event, ctx) => {\n      await runtimeInjection.await();\n      const state = requireDoomConfigContext(requireRuntimeContext()).harness;\n      const status = profileStatus(state.profile, await profileCatalogueExists(state, config.telemetry));\n      if (status !== undefined) ctx.ui.setStatus(PROFILE_STATUS_KEY, status);\n    });\n    yield () => undefined;\n  }, PACKAGE_SOURCE);\n}\n\nexport default profileExtension;\n"],"mappings":"wuBAaA,MAAM,EAAiB,4BAOvB,eAAe,EACb,EACA,EACkB,CAClB,GAAI,CACF,GAAM,CAAC,CAAE,sBAAsB,CAAE,iBAAkB,MAAM,QAAQ,IAAI,CACnE,OAAO,yCACP,OAAO,oCACT,CAAC,EACD,OAAO,EAAa,EAAmB,CAAK,CAAC,CAAC,CAAC,OAAS,CAC1D,OAAS,EAAO,CAEd,OADA,EAAe,YAAY,EAAc,kBAAmB,CAAK,EAC1D,EACT,CACF,CAKA,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,EACE,EAAmB,EAAO,OAAO,CAAC,EAAqB,CAAuB,EAAI,IACtF,EAAgB,MACH,CACP,IAAkB,IAAS,EAAgB,IAAA,GACjD,EACD,EACK,MAAuC,CAC3C,GAAI,CAAC,EAAe,MAAU,MAAM,iEAAiE,EACrG,OAAO,CACT,EACA,EAAO,OAAO,WAAa,CACzB,EAAuB,EAAO,GAAI,EAAO,UAAW,CAAqB,EACzE,EAAO,GAAG,GAAG,gBAAiB,MAAO,EAAQ,IAAQ,CACnD,MAAM,EAAiB,MAAM,EAC7B,IAAM,EAAQ,EAAyB,EAAsB,CAAC,CAAC,CAAC,QAC1D,EAAS,EAAc,EAAM,QAAS,MAAM,EAAuB,EAAO,EAAO,SAAS,CAAC,EAC7F,IAAW,IAAA,IAAW,EAAI,GAAG,UAAU,EAAoB,CAAM,CACvE,CAAC,EACD,SAAY,IAAA,EACd,EAAG,CAAc,CACnB"}

package/dist/adapters/pi/persona.d.cts

@@ -2,7 +2,7 @@ import { ProfileTelemetry } from "../../types/telemetry.cjs";
 import "@deepseek-ai/cordis";
 import { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 //#region src/adapters/pi/persona.d.ts
-declare function personaExtension(pi: ExtensionAPI, telemetry?: ProfileTelemetry): Promise<void>;
+export declare function personaExtension(pi: ExtensionAPI, telemetry?: ProfileTelemetry): Promise<void>;
 //#endregion
-export { personaExtension as default, personaExtension };
+export { personaExtension as default };
 //# sourceMappingURL=persona.d.cts.map

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

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

package/dist/adapters/pi/persona.d.mts

@@ -2,7 +2,7 @@ import { ProfileTelemetry } from "../../types/telemetry.mjs";
 import "@deepseek-ai/cordis";
 import { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 //#region src/adapters/pi/persona.d.ts
-declare function personaExtension(pi: ExtensionAPI, telemetry?: ProfileTelemetry): Promise<void>;
+export declare function personaExtension(pi: ExtensionAPI, telemetry?: ProfileTelemetry): Promise<void>;
 //#endregion
-export { personaExtension as default, personaExtension };
+export { personaExtension as default };
 //# sourceMappingURL=persona.d.mts.map

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

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

package/dist/adapters/telemetry/logSinkTelemetry.d.cts

@@ -1,14 +1,13 @@
 import { ProfileTelemetry } from "../../types/telemetry.cjs";
 import { DoomTelemetryOptions } from "@agimon-ai/doompi-telemetry";
 //#region src/adapters/telemetry/logSinkTelemetry.d.ts
-interface ProfileTelemetryOptions {
+export interface ProfileTelemetryOptions {
   cwd?: string;
   workspaceRoot?: string;
   env?: NodeJS.ProcessEnv;
   telemetryFactory?: NonNullable<DoomTelemetryOptions['telemetryFactory']>;
   warn?: (message: string) => void;
 }
-declare function createProfileTelemetry(options?: ProfileTelemetryOptions): ProfileTelemetry;
+export declare function createProfileTelemetry(options?: ProfileTelemetryOptions): ProfileTelemetry;
 //#endregion
-export { ProfileTelemetryOptions, createProfileTelemetry };
 //# sourceMappingURL=logSinkTelemetry.d.cts.map

package/dist/adapters/telemetry/logSinkTelemetry.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"logSinkTelemetry.d.cts","names":[],"sources":["../../../src/adapters/telemetry/logSinkTelemetry.ts"],"mappings":";;;UAMiB;EACf;EACA;EACA,MAAM,OAAO;EACb,mBAAmB,YAAY;EAC/B,QAAQ;;iBAGM,uBAAuB,UAAS,0BAA+B"}
+{"version":3,"file":"logSinkTelemetry.d.cts","names":[],"sources":["../../../src/adapters/telemetry/logSinkTelemetry.ts"],"mappings":";;;iBAMiB;EACf;EACA;EACA,MAAM,OAAO;EACb,mBAAmB,YAAY;EAC/B,QAAQ;;wBAGM,uBAAuB,UAAS,0BAA+B"}

package/dist/adapters/telemetry/logSinkTelemetry.d.mts

@@ -1,14 +1,13 @@
 import { ProfileTelemetry } from "../../types/telemetry.mjs";
 import { DoomTelemetryOptions } from "@agimon-ai/doompi-telemetry";
 //#region src/adapters/telemetry/logSinkTelemetry.d.ts
-interface ProfileTelemetryOptions {
+export interface ProfileTelemetryOptions {
   cwd?: string;
   workspaceRoot?: string;
   env?: NodeJS.ProcessEnv;
   telemetryFactory?: NonNullable<DoomTelemetryOptions['telemetryFactory']>;
   warn?: (message: string) => void;
 }
-declare function createProfileTelemetry(options?: ProfileTelemetryOptions): ProfileTelemetry;
+export declare function createProfileTelemetry(options?: ProfileTelemetryOptions): ProfileTelemetry;
 //#endregion
-export { ProfileTelemetryOptions, createProfileTelemetry };
 //# sourceMappingURL=logSinkTelemetry.d.mts.map

package/dist/adapters/telemetry/logSinkTelemetry.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"logSinkTelemetry.d.mts","names":[],"sources":["../../../src/adapters/telemetry/logSinkTelemetry.ts"],"mappings":";;;UAMiB;EACf;EACA;EACA,MAAM,OAAO;EACb,mBAAmB,YAAY;EAC/B,QAAQ;;iBAGM,uBAAuB,UAAS,0BAA+B"}
+{"version":3,"file":"logSinkTelemetry.d.mts","names":[],"sources":["../../../src/adapters/telemetry/logSinkTelemetry.ts"],"mappings":";;;iBAMiB;EACf;EACA;EACA,MAAM,OAAO;EACb,mBAAmB,YAAY;EAC/B,QAAQ;;wBAGM,uBAAuB,UAAS,0BAA+B"}

package/dist/commands/profileCommand.cjs

@@ -1,2 +1,2 @@
-const e=require("../types/telemetry.cjs"),t=require("../services/profileText.cjs");let n=require("@agimon-ai/doompi-extension-contracts/transition"),r=require("@agimon-ai/doompi-config/piContext");const i=`warning`,a=`info`,o=`.doom/profiles.yaml`;function s(){let e,t,n,r,i;return{harnessStore:()=>e??=import(`@agimon-ai/doompi-config/harnessStore`),journal:()=>t??=import(`@agimon-ai/doompi-config/piContext`),picker:()=>n??=import(`@agimon-ai/doompi-ui/components/matrixPicker`),profiles:()=>r??=import(`@agimon-ai/doompi-config/profiles`),selection:()=>i??=import(`@agimon-ai/doompi-config/selectionSwitch`)}}async function c(e,n,r,i){let a=t.profileTitle(r);if(e.mode!==`tui`)return e.ui.select(a,n.map(e=>e.name));let{MatrixPickerComponent:o}=await i();return(await e.ui.custom((e,i,s,c)=>new o({title:a,items:t.profileItems(n),selected:r?[r]:[],multi:!1},i,s,c)))?.[0]}function l(l,u,d){let f=s();l.registerCommand(`profile`,{description:`Show profiles and load a different persona and environment`,handler:async(s,p)=>{let m=d(),h=(0,r.requireDoomConfigContext)(m).harness,[{requireHarnessRoot:g},{loadProfiles:_}]=await Promise.all([f.harnessStore(),f.profiles()]),v=g(h),y=h.profile,b;try{b=_(v)}catch(t){let n=t instanceof Error?t.message:String(t);u.recordError(e.PROFILE_EVENT.profileLoadFailed,t),p.ui.notify(`Could not load ${o}: ${n}`,i);return}if(b.length===0){p.ui.notify(`No profiles found in ${o}.`,i);return}let x=await c(p,b,y,f.picker),S=b.find(e=>e.name===x);if(!S)return;if(S.name===y){p.ui.notify(t.profileSummary(S),a);return}let C=(0,n.requireDoomTransitionCoordinator)(m),w,T=await C.execute({sessionId:p.sessionManager.getSessionId(),hostGeneration:C.hostGeneration,operationId:crypto.randomUUID(),source:p.mode===`tui`?`ui`:`command`,target:{axis:`profile`,profile:S.name}},async(t,r)=>{w=(0,n.prepareMinorModeReloadHandoff)(m,p.sessionManager.getSessionId(),C.hostGeneration,r.operationId,r.previous.minorModes);try{let{applyProfile:t}=await f.selection();p.ui.notify(await t(S,h),a);let{persistHarnessSelection:n}=await f.journal();return n(l,{...h,profile:S.name}),u.recordEvent(e.PROFILE_EVENT.profileApplied,{"harness.profile":S.name,...y?{"harness.profile.previous":y}:{},"harness.transition.disposition":r.disposition,"harness.transition.operation_id":r.operationId}),`applied`}catch(e){throw w?.discard(),w=void 0,e}});if(T.outcome===`rejected`||T.outcome===`stale`){w?.discard(),p.ui.notify(`Profile transition was ${T.outcome}: ${T.diagnostics.join(`, `)}`,i);return}if(T.outcome!==`applied`){w?.discard();return}try{await p.waitForIdle(),await p.reload()}catch(e){throw w?.discard(),e}}})}exports.registerProfileCommand=l;
+const e=require("../types/telemetry.cjs"),t=require("../services/profileText.cjs");let n=require("@agimon-ai/doompi-config/piContext"),r=require("@agimon-ai/doompi-extension-contracts/transition");const i=`warning`,a=`info`,o=`.doom/profiles.yaml`;function s(){let e,t,n,r,i;return{harnessStore:()=>e??=import(`@agimon-ai/doompi-config/harnessStore`),journal:()=>t??=import(`@agimon-ai/doompi-config/piContext`),picker:()=>n??=import(`@agimon-ai/doompi-ui/components/matrixPicker`),profiles:()=>r??=import(`@agimon-ai/doompi-config/profiles`),selection:()=>i??=import(`@agimon-ai/doompi-config/selectionSwitch`)}}async function c(e,n,r,i){let a=t.profileTitle(r);if(e.mode!==`tui`)return e.ui.select(a,n.map(e=>e.name));let{MatrixPickerComponent:o}=await i();return(await e.ui.custom((e,i,s,c)=>new o({title:a,items:t.profileItems(n),selected:r?[r]:[],multi:!1},i,s,c)))?.[0]}function l(l,u,d){let f=s();l.registerCommand(`profile`,{description:`Show profiles and load a different persona and environment`,handler:async(s,p)=>{let m=d(),h=(0,n.requireDoomConfigContext)(m).harness,[{requireHarnessRoot:g},{loadProfiles:_}]=await Promise.all([f.harnessStore(),f.profiles()]),v=g(h),y=h.profile,b;try{b=_(v)}catch(t){let n=t instanceof Error?t.message:String(t);u.recordError(e.PROFILE_EVENT.profileLoadFailed,t),p.ui.notify(`Could not load ${o}: ${n}`,i);return}if(b.length===0){p.ui.notify(`No profiles found in ${o}.`,i);return}let x=await c(p,b,y,f.picker),S=b.find(e=>e.name===x);if(!S)return;if(S.name===y){p.ui.notify(t.profileSummary(S),a);return}let C=(0,r.requireDoomTransitionCoordinator)(m),w,T=await C.execute({sessionId:p.sessionManager.getSessionId(),hostGeneration:C.hostGeneration,operationId:crypto.randomUUID(),source:p.mode===`tui`?`ui`:`command`,target:{axis:`profile`,profile:S.name}},async(t,n)=>{w=(0,r.prepareMinorModeReloadHandoff)(m,p.sessionManager.getSessionId(),C.hostGeneration,n.operationId,n.previous.minorModes);try{let{applyProfile:t}=await f.selection();p.ui.notify(await t(S,h),a);let{persistHarnessSelection:r}=await f.journal();return r(l,{...h,profile:S.name}),u.recordEvent(e.PROFILE_EVENT.profileApplied,{"harness.profile":S.name,...y?{"harness.profile.previous":y}:{},"harness.transition.disposition":n.disposition,"harness.transition.operation_id":n.operationId}),`applied`}catch(e){throw w?.discard(),w=void 0,e}});if(T.outcome===`rejected`||T.outcome===`stale`){w?.discard(),p.ui.notify(`Profile transition was ${T.outcome}: ${T.diagnostics.join(`, `)}`,i);return}if(T.outcome!==`applied`){w?.discard();return}try{await p.waitForIdle(),await p.reload()}catch(e){throw w?.discard(),e}}})}exports.registerProfileCommand=l;
 //# sourceMappingURL=profileCommand.cjs.map

package/dist/commands/profileCommand.mjs

@@ -1,2 +1,2 @@
-import{PROFILE_EVENT as e}from"../types/telemetry.mjs";import{profileItems as t,profileSummary as n,profileTitle as r}from"../services/profileText.mjs";import{prepareMinorModeReloadHandoff as i,requireDoomTransitionCoordinator as a}from"@agimon-ai/doompi-extension-contracts/transition";import{requireDoomConfigContext as o}from"@agimon-ai/doompi-config/piContext";const s=`warning`,c=`info`,l=`.doom/profiles.yaml`;function u(){let e,t,n,r,i;return{harnessStore:()=>e??=import(`@agimon-ai/doompi-config/harnessStore`),journal:()=>t??=import(`@agimon-ai/doompi-config/piContext`),picker:()=>n??=import(`@agimon-ai/doompi-ui/components/matrixPicker`),profiles:()=>r??=import(`@agimon-ai/doompi-config/profiles`),selection:()=>i??=import(`@agimon-ai/doompi-config/selectionSwitch`)}}async function d(e,n,i,a){let o=r(i);if(e.mode!==`tui`)return e.ui.select(o,n.map(e=>e.name));let{MatrixPickerComponent:s}=await a();return(await e.ui.custom((e,r,a,c)=>new s({title:o,items:t(n),selected:i?[i]:[],multi:!1},r,a,c)))?.[0]}function f(t,r,f){let p=u();t.registerCommand(`profile`,{description:`Show profiles and load a different persona and environment`,handler:async(u,m)=>{let h=f(),g=o(h).harness,[{requireHarnessRoot:_},{loadProfiles:v}]=await Promise.all([p.harnessStore(),p.profiles()]),y=_(g),b=g.profile,x;try{x=v(y)}catch(t){let n=t instanceof Error?t.message:String(t);r.recordError(e.profileLoadFailed,t),m.ui.notify(`Could not load ${l}: ${n}`,s);return}if(x.length===0){m.ui.notify(`No profiles found in ${l}.`,s);return}let S=await d(m,x,b,p.picker),C=x.find(e=>e.name===S);if(!C)return;if(C.name===b){m.ui.notify(n(C),c);return}let w=a(h),T,E=await w.execute({sessionId:m.sessionManager.getSessionId(),hostGeneration:w.hostGeneration,operationId:crypto.randomUUID(),source:m.mode===`tui`?`ui`:`command`,target:{axis:`profile`,profile:C.name}},async(n,a)=>{T=i(h,m.sessionManager.getSessionId(),w.hostGeneration,a.operationId,a.previous.minorModes);try{let{applyProfile:n}=await p.selection();m.ui.notify(await n(C,g),c);let{persistHarnessSelection:i}=await p.journal();return i(t,{...g,profile:C.name}),r.recordEvent(e.profileApplied,{"harness.profile":C.name,...b?{"harness.profile.previous":b}:{},"harness.transition.disposition":a.disposition,"harness.transition.operation_id":a.operationId}),`applied`}catch(e){throw T?.discard(),T=void 0,e}});if(E.outcome===`rejected`||E.outcome===`stale`){T?.discard(),m.ui.notify(`Profile transition was ${E.outcome}: ${E.diagnostics.join(`, `)}`,s);return}if(E.outcome!==`applied`){T?.discard();return}try{await m.waitForIdle(),await m.reload()}catch(e){throw T?.discard(),e}}})}export{f as registerProfileCommand};
+import{PROFILE_EVENT as e}from"../types/telemetry.mjs";import{profileItems as t,profileSummary as n,profileTitle as r}from"../services/profileText.mjs";import{requireDoomConfigContext as i}from"@agimon-ai/doompi-config/piContext";import{prepareMinorModeReloadHandoff as a,requireDoomTransitionCoordinator as o}from"@agimon-ai/doompi-extension-contracts/transition";const s=`warning`,c=`info`,l=`.doom/profiles.yaml`;function u(){let e,t,n,r,i;return{harnessStore:()=>e??=import(`@agimon-ai/doompi-config/harnessStore`),journal:()=>t??=import(`@agimon-ai/doompi-config/piContext`),picker:()=>n??=import(`@agimon-ai/doompi-ui/components/matrixPicker`),profiles:()=>r??=import(`@agimon-ai/doompi-config/profiles`),selection:()=>i??=import(`@agimon-ai/doompi-config/selectionSwitch`)}}async function d(e,n,i,a){let o=r(i);if(e.mode!==`tui`)return e.ui.select(o,n.map(e=>e.name));let{MatrixPickerComponent:s}=await a();return(await e.ui.custom((e,r,a,c)=>new s({title:o,items:t(n),selected:i?[i]:[],multi:!1},r,a,c)))?.[0]}function f(t,r,f){let p=u();t.registerCommand(`profile`,{description:`Show profiles and load a different persona and environment`,handler:async(u,m)=>{let h=f(),g=i(h).harness,[{requireHarnessRoot:_},{loadProfiles:v}]=await Promise.all([p.harnessStore(),p.profiles()]),y=_(g),b=g.profile,x;try{x=v(y)}catch(t){let n=t instanceof Error?t.message:String(t);r.recordError(e.profileLoadFailed,t),m.ui.notify(`Could not load ${l}: ${n}`,s);return}if(x.length===0){m.ui.notify(`No profiles found in ${l}.`,s);return}let S=await d(m,x,b,p.picker),C=x.find(e=>e.name===S);if(!C)return;if(C.name===b){m.ui.notify(n(C),c);return}let w=o(h),T,E=await w.execute({sessionId:m.sessionManager.getSessionId(),hostGeneration:w.hostGeneration,operationId:crypto.randomUUID(),source:m.mode===`tui`?`ui`:`command`,target:{axis:`profile`,profile:C.name}},async(n,i)=>{T=a(h,m.sessionManager.getSessionId(),w.hostGeneration,i.operationId,i.previous.minorModes);try{let{applyProfile:n}=await p.selection();m.ui.notify(await n(C,g),c);let{persistHarnessSelection:a}=await p.journal();return a(t,{...g,profile:C.name}),r.recordEvent(e.profileApplied,{"harness.profile":C.name,...b?{"harness.profile.previous":b}:{},"harness.transition.disposition":i.disposition,"harness.transition.operation_id":i.operationId}),`applied`}catch(e){throw T?.discard(),T=void 0,e}});if(E.outcome===`rejected`||E.outcome===`stale`){T?.discard(),m.ui.notify(`Profile transition was ${E.outcome}: ${E.diagnostics.join(`, `)}`,s);return}if(E.outcome!==`applied`){T?.discard();return}try{await m.waitForIdle(),await m.reload()}catch(e){throw T?.discard(),e}}})}export{f as registerProfileCommand};
 //# sourceMappingURL=profileCommand.mjs.map

package/dist/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./adapters/telemetry/logSinkTelemetry.cjs"),t=require("./types/telemetry.cjs"),n=require("./adapters/pi/persona.cjs"),r=require("./services/profileText.cjs"),i=require("./adapters/pi/extension.cjs");exports.PROFILE_EVENT=t.PROFILE_EVENT,exports.createProfileTelemetry=e.createProfileTelemetry,exports.personaExtension=n.default,exports.profileDescription=r.profileDescription,exports.profileExtension=i.default,exports.profileItems=r.profileItems,exports.profileSummary=r.profileSummary,exports.profileTitle=r.profileTitle;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./adapters/telemetry/logSinkTelemetry.cjs"),t=require("./types/telemetry.cjs"),n=require("./adapters/pi/persona.cjs"),r=require("./services/profileText.cjs"),i=require("./adapters/pi/extension.cjs");exports.PROFILE_EVENT=t.PROFILE_EVENT,exports.PROFILE_STATUS_KEY=r.PROFILE_STATUS_KEY,exports.createProfileTelemetry=e.createProfileTelemetry,exports.personaExtension=n.default,exports.profileDescription=r.profileDescription,exports.profileExtension=i.default,exports.profileItems=r.profileItems,exports.profileStatus=r.profileStatus,exports.profileSummary=r.profileSummary,exports.profileTitle=r.profileTitle;

package/dist/index.d.cts

@@ -2,5 +2,5 @@ import { PROFILE_EVENT, ProfileEventAttributes, ProfileEventName, ProfileTelemet
 import personaExtension from "./adapters/pi/persona.cjs";
 import profileExtension from "./adapters/pi/extension.cjs";
 import { ProfileTelemetryOptions, createProfileTelemetry } from "./adapters/telemetry/logSinkTelemetry.cjs";
-import { profileDescription, profileItems, profileSummary, profileTitle } from "./services/profileText.cjs";
-export { PROFILE_EVENT, type ProfileEventAttributes, type ProfileEventName, type ProfileTelemetry, type ProfileTelemetryOptions, createProfileTelemetry, personaExtension, profileDescription, profileExtension, profileItems, profileSummary, profileTitle };
+import { PROFILE_STATUS_KEY, profileDescription, profileItems, profileStatus, profileSummary, profileTitle } from "./services/profileText.cjs";
+export { PROFILE_EVENT, PROFILE_STATUS_KEY, type ProfileEventAttributes, type ProfileEventName, type ProfileTelemetry, type ProfileTelemetryOptions, createProfileTelemetry, personaExtension, profileDescription, profileExtension, profileItems, profileStatus, profileSummary, profileTitle };

package/dist/index.d.mts

@@ -2,5 +2,5 @@ import { PROFILE_EVENT, ProfileEventAttributes, ProfileEventName, ProfileTelemet
 import personaExtension from "./adapters/pi/persona.mjs";
 import profileExtension from "./adapters/pi/extension.mjs";
 import { ProfileTelemetryOptions, createProfileTelemetry } from "./adapters/telemetry/logSinkTelemetry.mjs";
-import { profileDescription, profileItems, profileSummary, profileTitle } from "./services/profileText.mjs";
-export { PROFILE_EVENT, type ProfileEventAttributes, type ProfileEventName, type ProfileTelemetry, type ProfileTelemetryOptions, createProfileTelemetry, personaExtension, profileDescription, profileExtension, profileItems, profileSummary, profileTitle };
+import { PROFILE_STATUS_KEY, profileDescription, profileItems, profileStatus, profileSummary, profileTitle } from "./services/profileText.mjs";
+export { PROFILE_EVENT, PROFILE_STATUS_KEY, type ProfileEventAttributes, type ProfileEventName, type ProfileTelemetry, type ProfileTelemetryOptions, createProfileTelemetry, personaExtension, profileDescription, profileExtension, profileItems, profileStatus, profileSummary, profileTitle };

package/dist/index.mjs

@@ -1 +1 @@
-import{createProfileTelemetry as e}from"./adapters/telemetry/logSinkTelemetry.mjs";import{PROFILE_EVENT as t}from"./types/telemetry.mjs";import n from"./adapters/pi/persona.mjs";import{profileDescription as r,profileItems as i,profileSummary as a,profileTitle as o}from"./services/profileText.mjs";import s from"./adapters/pi/extension.mjs";export{t as PROFILE_EVENT,e as createProfileTelemetry,n as personaExtension,r as profileDescription,s as profileExtension,i as profileItems,a as profileSummary,o as profileTitle};
+import{createProfileTelemetry as e}from"./adapters/telemetry/logSinkTelemetry.mjs";import{PROFILE_EVENT as t}from"./types/telemetry.mjs";import n from"./adapters/pi/persona.mjs";import{PROFILE_STATUS_KEY as r,profileDescription as i,profileItems as a,profileStatus as o,profileSummary as s,profileTitle as c}from"./services/profileText.mjs";import l from"./adapters/pi/extension.mjs";export{t as PROFILE_EVENT,r as PROFILE_STATUS_KEY,e as createProfileTelemetry,n as personaExtension,i as profileDescription,l as profileExtension,a as profileItems,o as profileStatus,s as profileSummary,c as profileTitle};

package/dist/services/profileText.cjs

@@ -1,3 +1,3 @@
-const e=`(none)`;function t(e){return e.map(e=>({value:e.name,label:e.name,description:n(e)}))}function n(e){let t=Object.keys(e.env).sort();return t.length>0?`${e.persona} (env: ${t.join(`, `)})`:e.persona}function r(t){let n=Object.keys(t.env).sort();return[`Profile ${t.name}`,`Persona: ${t.persona}`,`Env: ${n.join(`, `)||e}`,`Already loaded.`].join(`
-`)}function i(t){return`Profile (current: ${t??e})`}exports.profileDescription=n,exports.profileItems=t,exports.profileSummary=r,exports.profileTitle=i;
+const e=`(none)`;function t(e,t){return e||(t?``:void 0)}function n(e){return e.map(e=>({value:e.name,label:e.name,description:r(e)}))}function r(e){let t=Object.keys(e.env).sort();return t.length>0?`${e.persona} (env: ${t.join(`, `)})`:e.persona}function i(t){let n=Object.keys(t.env).sort();return[`Profile ${t.name}`,`Persona: ${t.persona}`,`Env: ${n.join(`, `)||e}`,`Already loaded.`].join(`
+`)}function a(t){return`Profile (current: ${t??e})`}exports.PROFILE_STATUS_KEY=`doom-profile`,exports.profileDescription=r,exports.profileItems=n,exports.profileStatus=t,exports.profileSummary=i,exports.profileTitle=a;
 //# sourceMappingURL=profileText.cjs.map

package/dist/services/profileText.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"profileText.cjs","names":[],"sources":["../../src/services/profileText.ts"],"sourcesContent":["import type { AgentProfile } from '@agimon-ai/doompi-config/profiles';\nimport type { SelectItem } from '@earendil-works/pi-tui';\n\nconst NONE = '(none)';\n\n/** Rows for the single-select profile picker. */\nexport function profileItems(profiles: AgentProfile[]): SelectItem[] {\n  return profiles.map((profile) => ({\n    value: profile.name,\n    label: profile.name,\n    description: profileDescription(profile),\n  }));\n}\n\nexport function profileDescription(profile: AgentProfile): string {\n  const environmentKeys = Object.keys(profile.env).sort();\n  return environmentKeys.length > 0 ? `${profile.persona} (env: ${environmentKeys.join(', ')})` : profile.persona;\n}\n\n/** Shown when the picked profile is already active. */\nexport function profileSummary(profile: AgentProfile): string {\n  const environmentKeys = Object.keys(profile.env).sort();\n  return [\n    `Profile ${profile.name}`,\n    `Persona: ${profile.persona}`,\n    `Env: ${environmentKeys.join(', ') || NONE}`,\n    'Already loaded.',\n  ].join('\\n');\n}\n\nexport function profileTitle(current?: string): string {\n  return `Profile (current: ${current ?? NONE})`;\n}\n"],"mappings":"AAGA,MAAM,EAAO,SAGb,SAAgB,EAAa,EAAwC,CACnE,OAAO,EAAS,IAAK,IAAa,CAChC,MAAO,EAAQ,KACf,MAAO,EAAQ,KACf,YAAa,EAAmB,CAAO,CACzC,EAAE,CACJ,CAEA,SAAgB,EAAmB,EAA+B,CAChE,IAAM,EAAkB,OAAO,KAAK,EAAQ,GAAG,CAAC,CAAC,KAAK,EACtD,OAAO,EAAgB,OAAS,EAAI,GAAG,EAAQ,QAAQ,SAAS,EAAgB,KAAK,IAAI,EAAE,GAAK,EAAQ,OAC1G,CAGA,SAAgB,EAAe,EAA+B,CAC5D,IAAM,EAAkB,OAAO,KAAK,EAAQ,GAAG,CAAC,CAAC,KAAK,EACtD,MAAO,CACL,WAAW,EAAQ,OACnB,YAAY,EAAQ,UACpB,QAAQ,EAAgB,KAAK,IAAI,GAAK,IACtC,iBACF,CAAC,CAAC,KAAK;CAAI,CACb,CAEA,SAAgB,EAAa,EAA0B,CACrD,MAAO,qBAAqB,GAAW,EAAK,EAC9C"}
+{"version":3,"file":"profileText.cjs","names":[],"sources":["../../src/services/profileText.ts"],"sourcesContent":["import type { AgentProfile } from '@agimon-ai/doompi-config/profiles';\nimport type { SelectItem } from '@earendil-works/pi-tui';\n\nconst NONE = '(none)';\n\n/** Footer status key the cockpit's profile axis reads. */\nexport const PROFILE_STATUS_KEY = 'doom-profile';\n\n/**\n * The published axis content: the active profile's name, empty while\n * profiles exist with none active, and undefined to withhold the status so\n * the cockpit keeps the axis off the bar entirely.\n */\nexport function profileStatus(current: string | undefined, hasProfiles: boolean): string | undefined {\n  if (current) return current;\n  return hasProfiles ? '' : undefined;\n}\n\n/** Rows for the single-select profile picker. */\nexport function profileItems(profiles: AgentProfile[]): SelectItem[] {\n  return profiles.map((profile) => ({\n    value: profile.name,\n    label: profile.name,\n    description: profileDescription(profile),\n  }));\n}\n\nexport function profileDescription(profile: AgentProfile): string {\n  const environmentKeys = Object.keys(profile.env).sort();\n  return environmentKeys.length > 0 ? `${profile.persona} (env: ${environmentKeys.join(', ')})` : profile.persona;\n}\n\n/** Shown when the picked profile is already active. */\nexport function profileSummary(profile: AgentProfile): string {\n  const environmentKeys = Object.keys(profile.env).sort();\n  return [\n    `Profile ${profile.name}`,\n    `Persona: ${profile.persona}`,\n    `Env: ${environmentKeys.join(', ') || NONE}`,\n    'Already loaded.',\n  ].join('\\n');\n}\n\nexport function profileTitle(current?: string): string {\n  return `Profile (current: ${current ?? NONE})`;\n}\n"],"mappings":"AAGA,MAAM,EAAO,SAUb,SAAgB,EAAc,EAA6B,EAA0C,CAEnG,OADI,IACG,EAAc,GAAK,IAAA,GAC5B,CAGA,SAAgB,EAAa,EAAwC,CACnE,OAAO,EAAS,IAAK,IAAa,CAChC,MAAO,EAAQ,KACf,MAAO,EAAQ,KACf,YAAa,EAAmB,CAAO,CACzC,EAAE,CACJ,CAEA,SAAgB,EAAmB,EAA+B,CAChE,IAAM,EAAkB,OAAO,KAAK,EAAQ,GAAG,CAAC,CAAC,KAAK,EACtD,OAAO,EAAgB,OAAS,EAAI,GAAG,EAAQ,QAAQ,SAAS,EAAgB,KAAK,IAAI,EAAE,GAAK,EAAQ,OAC1G,CAGA,SAAgB,EAAe,EAA+B,CAC5D,IAAM,EAAkB,OAAO,KAAK,EAAQ,GAAG,CAAC,CAAC,KAAK,EACtD,MAAO,CACL,WAAW,EAAQ,OACnB,YAAY,EAAQ,UACpB,QAAQ,EAAgB,KAAK,IAAI,GAAK,IACtC,iBACF,CAAC,CAAC,KAAK;CAAI,CACb,CAEA,SAAgB,EAAa,EAA0B,CACrD,MAAO,qBAAqB,GAAW,EAAK,EAC9C"}

package/dist/services/profileText.d.cts

@@ -1,12 +1,19 @@
 import { AgentProfile } from "@agimon-ai/doompi-config/profiles";
 import { SelectItem } from "@earendil-works/pi-tui";
 //#region src/services/profileText.d.ts
+/** Footer status key the cockpit's profile axis reads. */
+export declare const PROFILE_STATUS_KEY = "doom-profile";
+/**
+ * The published axis content: the active profile's name, empty while
+ * profiles exist with none active, and undefined to withhold the status so
+ * the cockpit keeps the axis off the bar entirely.
+ */
+export declare function profileStatus(current: string | undefined, hasProfiles: boolean): string | undefined;
 /** Rows for the single-select profile picker. */
-declare function profileItems(profiles: AgentProfile[]): SelectItem[];
-declare function profileDescription(profile: AgentProfile): string;
+export declare function profileItems(profiles: AgentProfile[]): SelectItem[];
+export declare function profileDescription(profile: AgentProfile): string;
 /** Shown when the picked profile is already active. */
-declare function profileSummary(profile: AgentProfile): string;
-declare function profileTitle(current?: string): string;
+export declare function profileSummary(profile: AgentProfile): string;
+export declare function profileTitle(current?: string): string;
 //#endregion
-export { profileDescription, profileItems, profileSummary, profileTitle };
 //# sourceMappingURL=profileText.d.cts.map

package/dist/services/profileText.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"profileText.d.cts","names":[],"sources":["../../src/services/profileText.ts"],"mappings":";;;;iBAMgB,aAAa,UAAU,iBAAiB;iBAQxC,mBAAmB,SAAS;;iBAM5B,eAAe,SAAS;iBAUxB,aAAa"}
+{"version":3,"file":"profileText.d.cts","names":[],"sources":["../../src/services/profileText.ts"],"mappings":";;;;qBAMa;;;;;;wBAOG,cAAc,6BAA6B;;wBAM3C,aAAa,UAAU,iBAAiB;wBAQxC,mBAAmB,SAAS;;wBAM5B,eAAe,SAAS;wBAUxB,aAAa"}

package/dist/services/profileText.d.mts

@@ -1,12 +1,19 @@
 import { AgentProfile } from "@agimon-ai/doompi-config/profiles";
 import { SelectItem } from "@earendil-works/pi-tui";
 //#region src/services/profileText.d.ts
+/** Footer status key the cockpit's profile axis reads. */
+export declare const PROFILE_STATUS_KEY = "doom-profile";
+/**
+ * The published axis content: the active profile's name, empty while
+ * profiles exist with none active, and undefined to withhold the status so
+ * the cockpit keeps the axis off the bar entirely.
+ */
+export declare function profileStatus(current: string | undefined, hasProfiles: boolean): string | undefined;
 /** Rows for the single-select profile picker. */
-declare function profileItems(profiles: AgentProfile[]): SelectItem[];
-declare function profileDescription(profile: AgentProfile): string;
+export declare function profileItems(profiles: AgentProfile[]): SelectItem[];
+export declare function profileDescription(profile: AgentProfile): string;
 /** Shown when the picked profile is already active. */
-declare function profileSummary(profile: AgentProfile): string;
-declare function profileTitle(current?: string): string;
+export declare function profileSummary(profile: AgentProfile): string;
+export declare function profileTitle(current?: string): string;
 //#endregion
-export { profileDescription, profileItems, profileSummary, profileTitle };
 //# sourceMappingURL=profileText.d.mts.map

package/dist/services/profileText.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"profileText.d.mts","names":[],"sources":["../../src/services/profileText.ts"],"mappings":";;;;iBAMgB,aAAa,UAAU,iBAAiB;iBAQxC,mBAAmB,SAAS;;iBAM5B,eAAe,SAAS;iBAUxB,aAAa"}
+{"version":3,"file":"profileText.d.mts","names":[],"sources":["../../src/services/profileText.ts"],"mappings":";;;;qBAMa;;;;;;wBAOG,cAAc,6BAA6B;;wBAM3C,aAAa,UAAU,iBAAiB;wBAQxC,mBAAmB,SAAS;;wBAM5B,eAAe,SAAS;wBAUxB,aAAa"}

package/dist/services/profileText.mjs

@@ -1,3 +1,3 @@
-const e=`(none)`;function t(e){return e.map(e=>({value:e.name,label:e.name,description:n(e)}))}function n(e){let t=Object.keys(e.env).sort();return t.length>0?`${e.persona} (env: ${t.join(`, `)})`:e.persona}function r(t){let n=Object.keys(t.env).sort();return[`Profile ${t.name}`,`Persona: ${t.persona}`,`Env: ${n.join(`, `)||e}`,`Already loaded.`].join(`
-`)}function i(t){return`Profile (current: ${t??e})`}export{n as profileDescription,t as profileItems,r as profileSummary,i as profileTitle};
+const e=`(none)`,t=`doom-profile`;function n(e,t){return e||(t?``:void 0)}function r(e){return e.map(e=>({value:e.name,label:e.name,description:i(e)}))}function i(e){let t=Object.keys(e.env).sort();return t.length>0?`${e.persona} (env: ${t.join(`, `)})`:e.persona}function a(t){let n=Object.keys(t.env).sort();return[`Profile ${t.name}`,`Persona: ${t.persona}`,`Env: ${n.join(`, `)||e}`,`Already loaded.`].join(`
+`)}function o(t){return`Profile (current: ${t??e})`}export{t as PROFILE_STATUS_KEY,i as profileDescription,r as profileItems,n as profileStatus,a as profileSummary,o as profileTitle};
 //# sourceMappingURL=profileText.mjs.map

package/dist/services/profileText.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"profileText.mjs","names":[],"sources":["../../src/services/profileText.ts"],"sourcesContent":["import type { AgentProfile } from '@agimon-ai/doompi-config/profiles';\nimport type { SelectItem } from '@earendil-works/pi-tui';\n\nconst NONE = '(none)';\n\n/** Rows for the single-select profile picker. */\nexport function profileItems(profiles: AgentProfile[]): SelectItem[] {\n  return profiles.map((profile) => ({\n    value: profile.name,\n    label: profile.name,\n    description: profileDescription(profile),\n  }));\n}\n\nexport function profileDescription(profile: AgentProfile): string {\n  const environmentKeys = Object.keys(profile.env).sort();\n  return environmentKeys.length > 0 ? `${profile.persona} (env: ${environmentKeys.join(', ')})` : profile.persona;\n}\n\n/** Shown when the picked profile is already active. */\nexport function profileSummary(profile: AgentProfile): string {\n  const environmentKeys = Object.keys(profile.env).sort();\n  return [\n    `Profile ${profile.name}`,\n    `Persona: ${profile.persona}`,\n    `Env: ${environmentKeys.join(', ') || NONE}`,\n    'Already loaded.',\n  ].join('\\n');\n}\n\nexport function profileTitle(current?: string): string {\n  return `Profile (current: ${current ?? NONE})`;\n}\n"],"mappings":"AAGA,MAAM,EAAO,SAGb,SAAgB,EAAa,EAAwC,CACnE,OAAO,EAAS,IAAK,IAAa,CAChC,MAAO,EAAQ,KACf,MAAO,EAAQ,KACf,YAAa,EAAmB,CAAO,CACzC,EAAE,CACJ,CAEA,SAAgB,EAAmB,EAA+B,CAChE,IAAM,EAAkB,OAAO,KAAK,EAAQ,GAAG,CAAC,CAAC,KAAK,EACtD,OAAO,EAAgB,OAAS,EAAI,GAAG,EAAQ,QAAQ,SAAS,EAAgB,KAAK,IAAI,EAAE,GAAK,EAAQ,OAC1G,CAGA,SAAgB,EAAe,EAA+B,CAC5D,IAAM,EAAkB,OAAO,KAAK,EAAQ,GAAG,CAAC,CAAC,KAAK,EACtD,MAAO,CACL,WAAW,EAAQ,OACnB,YAAY,EAAQ,UACpB,QAAQ,EAAgB,KAAK,IAAI,GAAK,IACtC,iBACF,CAAC,CAAC,KAAK;CAAI,CACb,CAEA,SAAgB,EAAa,EAA0B,CACrD,MAAO,qBAAqB,GAAW,EAAK,EAC9C"}
+{"version":3,"file":"profileText.mjs","names":[],"sources":["../../src/services/profileText.ts"],"sourcesContent":["import type { AgentProfile } from '@agimon-ai/doompi-config/profiles';\nimport type { SelectItem } from '@earendil-works/pi-tui';\n\nconst NONE = '(none)';\n\n/** Footer status key the cockpit's profile axis reads. */\nexport const PROFILE_STATUS_KEY = 'doom-profile';\n\n/**\n * The published axis content: the active profile's name, empty while\n * profiles exist with none active, and undefined to withhold the status so\n * the cockpit keeps the axis off the bar entirely.\n */\nexport function profileStatus(current: string | undefined, hasProfiles: boolean): string | undefined {\n  if (current) return current;\n  return hasProfiles ? '' : undefined;\n}\n\n/** Rows for the single-select profile picker. */\nexport function profileItems(profiles: AgentProfile[]): SelectItem[] {\n  return profiles.map((profile) => ({\n    value: profile.name,\n    label: profile.name,\n    description: profileDescription(profile),\n  }));\n}\n\nexport function profileDescription(profile: AgentProfile): string {\n  const environmentKeys = Object.keys(profile.env).sort();\n  return environmentKeys.length > 0 ? `${profile.persona} (env: ${environmentKeys.join(', ')})` : profile.persona;\n}\n\n/** Shown when the picked profile is already active. */\nexport function profileSummary(profile: AgentProfile): string {\n  const environmentKeys = Object.keys(profile.env).sort();\n  return [\n    `Profile ${profile.name}`,\n    `Persona: ${profile.persona}`,\n    `Env: ${environmentKeys.join(', ') || NONE}`,\n    'Already loaded.',\n  ].join('\\n');\n}\n\nexport function profileTitle(current?: string): string {\n  return `Profile (current: ${current ?? NONE})`;\n}\n"],"mappings":"AAGA,MAAM,EAAO,SAGA,EAAqB,eAOlC,SAAgB,EAAc,EAA6B,EAA0C,CAEnG,OADI,IACG,EAAc,GAAK,IAAA,GAC5B,CAGA,SAAgB,EAAa,EAAwC,CACnE,OAAO,EAAS,IAAK,IAAa,CAChC,MAAO,EAAQ,KACf,MAAO,EAAQ,KACf,YAAa,EAAmB,CAAO,CACzC,EAAE,CACJ,CAEA,SAAgB,EAAmB,EAA+B,CAChE,IAAM,EAAkB,OAAO,KAAK,EAAQ,GAAG,CAAC,CAAC,KAAK,EACtD,OAAO,EAAgB,OAAS,EAAI,GAAG,EAAQ,QAAQ,SAAS,EAAgB,KAAK,IAAI,EAAE,GAAK,EAAQ,OAC1G,CAGA,SAAgB,EAAe,EAA+B,CAC5D,IAAM,EAAkB,OAAO,KAAK,EAAQ,GAAG,CAAC,CAAC,KAAK,EACtD,MAAO,CACL,WAAW,EAAQ,OACnB,YAAY,EAAQ,UACpB,QAAQ,EAAgB,KAAK,IAAI,GAAK,IACtC,iBACF,CAAC,CAAC,KAAK;CAAI,CACb,CAEA,SAAgB,EAAa,EAA0B,CACrD,MAAO,qBAAqB,GAAW,EAAK,EAC9C"}

package/dist/types/telemetry.d.cts

@@ -1,16 +1,15 @@
 //#region src/types/telemetry.d.ts
 /** Telemetry events this package reports, and the port that records them. */
-declare const PROFILE_EVENT: {
-  readonly profileApplied: "doom_pi_profile.applied";
-  readonly profileLoadFailed: "doom_pi_profile.load_failed";
-  readonly personaReadFailed: "doom_pi_profile.persona_read_failed";
+export declare const PROFILE_EVENT: {
+  readonly profileApplied: 'doom_pi_profile.applied';
+  readonly profileLoadFailed: 'doom_pi_profile.load_failed';
+  readonly personaReadFailed: 'doom_pi_profile.persona_read_failed';
 };
-type ProfileEventName = (typeof PROFILE_EVENT)[keyof typeof PROFILE_EVENT];
-type ProfileEventAttributes = Record<string, string | number | boolean>;
-interface ProfileTelemetry {
+export type ProfileEventName = (typeof PROFILE_EVENT)[keyof typeof PROFILE_EVENT];
+export type ProfileEventAttributes = Record<string, string | number | boolean>;
+export interface ProfileTelemetry {
   recordError(event: ProfileEventName, error: unknown, attributes?: ProfileEventAttributes): Promise<void>;
   recordEvent(event: ProfileEventName, attributes?: ProfileEventAttributes): Promise<void>;
 }
 //#endregion
-export { PROFILE_EVENT, ProfileEventAttributes, ProfileEventName, ProfileTelemetry };
 //# sourceMappingURL=telemetry.d.cts.map

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

@@ -1 +1 @@
-{"version":3,"file":"telemetry.d.cts","names":[],"sources":["../../src/types/telemetry.ts"],"mappings":";;cACa;;;;;KAMD,2BAA2B,4BAA4B;KACvD,yBAAyB;UAEpB;EACf,YAAY,OAAO,kBAAkB,gBAAgB,aAAa,yBAAyB;EAC3F,YAAY,OAAO,kBAAkB,aAAa,yBAAyB"}
+{"version":3,"file":"telemetry.d.cts","names":[],"sources":["../../src/types/telemetry.ts"],"mappings":";;qBACa;WACX;WACA;WACA;;YAGU,2BAA2B,4BAA4B;YACvD,yBAAyB;iBAEpB;EACf,YAAY,OAAO,kBAAkB,gBAAgB,aAAa,yBAAyB;EAC3F,YAAY,OAAO,kBAAkB,aAAa,yBAAyB"}

package/dist/types/telemetry.d.mts

@@ -1,16 +1,15 @@
 //#region src/types/telemetry.d.ts
 /** Telemetry events this package reports, and the port that records them. */
-declare const PROFILE_EVENT: {
-  readonly profileApplied: "doom_pi_profile.applied";
-  readonly profileLoadFailed: "doom_pi_profile.load_failed";
-  readonly personaReadFailed: "doom_pi_profile.persona_read_failed";
+export declare const PROFILE_EVENT: {
+  readonly profileApplied: 'doom_pi_profile.applied';
+  readonly profileLoadFailed: 'doom_pi_profile.load_failed';
+  readonly personaReadFailed: 'doom_pi_profile.persona_read_failed';
 };
-type ProfileEventName = (typeof PROFILE_EVENT)[keyof typeof PROFILE_EVENT];
-type ProfileEventAttributes = Record<string, string | number | boolean>;
-interface ProfileTelemetry {
+export type ProfileEventName = (typeof PROFILE_EVENT)[keyof typeof PROFILE_EVENT];
+export type ProfileEventAttributes = Record<string, string | number | boolean>;
+export interface ProfileTelemetry {
   recordError(event: ProfileEventName, error: unknown, attributes?: ProfileEventAttributes): Promise<void>;
   recordEvent(event: ProfileEventName, attributes?: ProfileEventAttributes): Promise<void>;
 }
 //#endregion
-export { PROFILE_EVENT, ProfileEventAttributes, ProfileEventName, ProfileTelemetry };
 //# sourceMappingURL=telemetry.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"telemetry.d.mts","names":[],"sources":["../../src/types/telemetry.ts"],"mappings":";;cACa;;;;;KAMD,2BAA2B,4BAA4B;KACvD,yBAAyB;UAEpB;EACf,YAAY,OAAO,kBAAkB,gBAAgB,aAAa,yBAAyB;EAC3F,YAAY,OAAO,kBAAkB,aAAa,yBAAyB"}
+{"version":3,"file":"telemetry.d.mts","names":[],"sources":["../../src/types/telemetry.ts"],"mappings":";;qBACa;WACX;WACA;WACA;;YAGU,2BAA2B,4BAA4B;YACvD,yBAAyB;iBAEpB;EACf,YAAY,OAAO,kBAAkB,gBAAgB,aAAa,yBAAyB;EAC3F,YAAY,OAAO,kBAAkB,aAAa,yBAAyB"}

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.4",
+  "version": "0.0.1-alpha.42",
   "description": "Persona and environment profile switching for DoomPi sessions.",
   "keywords": [
     "agent-persona",
@@ -15,12 +15,23 @@
     "system-prompt"
   ],
   "homepage": "https://agimon.ai",
+  "bugs": {
+    "url": "https://github.com/AgiFlow/doompi/issues"
+  },
   "license": "MIT",
   "author": "Vuong Ngo",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AgiFlow/doompi.git",
+    "directory": "packages/core/doompi-profile"
+  },
   "files": [
     "dist",
+    "src/web",
+    "src/exports/webClient.ts",
     "llms.txt",
     "README.md",
+    "src/prompts",
     "LICENSE",
     "package.json"
   ],
@@ -50,26 +61,27 @@
     "access": "public"
   },
   "dependencies": {
-    "@deepseek-ai/cordis": "4.0.1",
-    "@agimon-ai/doompi-ui": "0.0.1-alpha.26",
-    "@agimon-ai/doompi-config": "0.0.1-alpha.26",
-    "@agimon-ai/doompi-telemetry": "0.0.1-alpha.26",
-    "@agimon-ai/doompi-extension-contracts": "0.0.1-alpha.26"
+    "@deepseek-ai/cordis": "4.0.2",
+    "@agimon-ai/doompi-config": "0.0.1-alpha.63",
+    "@agimon-ai/doompi-telemetry": "0.0.1-alpha.62",
+    "@agimon-ai/doompi-ui": "0.0.1-alpha.64",
+    "@agimon-ai/doompi-web-contracts": "0.0.1-alpha.26",
+    "@agimon-ai/doompi-extension-contracts": "0.0.1-alpha.63"
   },
   "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.1.1",
-    "@vitest/coverage-v8": "4.1.10",
-    "tsdown": "0.22.14",
-    "typescript": "6.0.3",
-    "vitest": "4.1.10",
-    "@agimon-ai/vibe-lint-plugin-doom-extension": "0.0.1-alpha.26"
+    "@deepseek-ai/cordis": "4.0.2",
+    "@earendil-works/pi-coding-agent": "0.85.1",
+    "@earendil-works/pi-tui": "0.85.1",
+    "@types/node": "26.4.1",
+    "@vitest/coverage-v8": "5.0.0",
+    "tsdown": "0.23.0",
+    "typescript": "7.0.2",
+    "vitest": "5.0.0",
+    "@agimon-ai/vibe-lint-plugin-doom-extension": "0.0.1-alpha.60"
   },
   "peerDependencies": {
-    "@earendil-works/pi-coding-agent": "0.84.2",
-    "@earendil-works/pi-tui": "0.84.2"
+    "@earendil-works/pi-coding-agent": "0.85.1",
+    "@earendil-works/pi-tui": "0.85.1"
   },
   "peerDependenciesMeta": {
     "@earendil-works/pi-coding-agent": {
@@ -82,6 +94,11 @@
   "engines": {
     "node": ">=22.19.0"
   },
+  "doompiWeb": {
+    "pluginId": "profile",
+    "channels": [],
+    "client": "./src/exports/webClient.ts"
+  },
   "pi": {
     "extensions": [
       "./dist/extensions/pi.mjs"
@@ -90,7 +107,7 @@
   "scripts": {
     "build": "tsdown",
     "test": "vitest --run",
-    "typecheck": "tsc --noEmit",
+    "typecheck": "tsc --noEmit && tsc --noEmit -p src/web/tsconfig.json",
     "lint": "oxlint . && oxfmt . --check",
     "fixcode": "oxlint . --fix && oxfmt ."
   }

package/src/exports/webClient.ts

@@ -0,0 +1 @@
+export { webPlugin } from '../web/index.ts';

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.

package/src/web/index.ts

@@ -0,0 +1,14 @@
+import { defineWebPlugin } from '@agimon-ai/doompi-web-contracts';
+
+/**
+ * This package's cockpit presence: pure metadata. The selection bar renders
+ * the profile axis from what the session reports through the 'doom-profile'
+ * footer status; a session with no profiles publishes nothing and the axis
+ * stays off the bar.
+ */
+export const webPlugin = defineWebPlugin({
+  id: 'profile',
+  selectionAxes: [
+    { name: 'profile', command: 'profile', statusKey: 'doom-profile', emptyLabel: 'no profile', order: 10 },
+  ],
+});

package/src/web/tsconfig.json

@@ -0,0 +1,22 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["ES2023", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "jsx": "react-jsx",
+    "strict": true,
+    "noImplicitAny": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true,
+    "noEmit": true,
+    "resolveJsonModule": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "allowImportingTsExtensions": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": [".", "../types", "../exports/webClient.ts"]
+}