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

package/README.md

@@ -1,11 +1,21 @@
 # @agimon-ai/doompi-hook
 
-Claude-Code-compatible repository and plugin hooks for
+Claude Code-compatible repository and plugin hooks for
 [DoomPi](https://www.npmjs.com/package/@agimon-ai/doompi) sessions.
 
 A **hook** is a shell command the repository runs at a point in the session: before a tool call,
 after one, at session start, when the agent settles, and at session end. Commands are declared in
-`.doom/hooks.yaml`, grouped so a mode can turn a whole family of them on or off:
+`.doom/hooks.yaml`, grouped so a mode can turn a whole family of them on or off.
+
+> **Alpha:** hook configuration and runtime contracts may change between releases.
+
+## Requirements
+
+- Node.js 22.19.0 or newer
+- Pi 0.85.0
+- `/bin/bash`
+
+Configure hooks in `.doom/hooks.yaml`:
 
 ```yaml
 # .doom/hooks.yaml
@@ -25,14 +35,15 @@ groups:
           skipInSubagent: true
 ```
 
-A group marked `core: true` always loads. Every other group loads only when the active mode selected
-it. The same document is read from the global `.doom` directory and from the repository, and a
-repository group replaces the global group of the same id outright.
+A group marked `core: true` always loads. Every other group loads only when the active mode selects
+it. The same document is read from the global `.doom` directory and from the repository. A
+repository group replaces the global group of the same ID outright.
 
 ## Activation
 
-The DoomPi distribution activates this package by default. Layers only declare the `hookGroups`
-that should run in a major mode:
+The distribution activates this package by default through the `default.packages` list written by
+`doompi init` and `dpi init` in `.doom/modes.yaml`. Keep it there, or declare it in a selected layer,
+for hooks to run. Layers only declare the `hookGroups` to select; they do not define the hook commands:
 
 ```yaml
 # .doom/modes.yaml
@@ -41,14 +52,16 @@ layers:
     hookGroups: [safety, workflow]
 ```
 
-A session with no selected `hookGroups` still runs groups marked `core: true`; other groups remain inactive.
+A session with no selected `hookGroups` still runs groups marked `core: true`; other groups remain
+inactive.
 
 ## What a hook sees and can say
 
 Each command is run through `/bin/bash -c` in the repository root, with the Claude Code payload for
-the event on stdin and `CLAUDE_PROJECT_DIR`, `CODEX_REPO_ROOT`, `ORIGINAL_REPO_PATH` and — for a
-hook declared by a plugin or a global config — `CLAUDE_PLUGIN_ROOT` in the environment. Tool names
-in the payload and in `matcher` are Claude names (`Bash`, `Write`), not Pi's.
+the event on stdin. The environment includes `CLAUDE_PROJECT_DIR`, `CODEX_REPO_ROOT`, and
+`ORIGINAL_REPO_PATH`. Every resolved hook also receives `CLAUDE_PLUGIN_ROOT`, set to the root that
+declared its repository, personal, or plugin configuration. Tool names in the payload and in
+`matcher` are Claude names (`Bash`, `Write`), not Pi's.
 
 The last stdout line that starts with `{` is read as the hook's decision:
 
@@ -70,14 +83,38 @@ indistinguishable from one that passed.
 expires, is sent `SIGTERM` and then `SIGKILL` two seconds later, so a stalled hook does not leave
 the processes it started behind.
 
-## Installation
+## Help guidance
 
-DoomPi already includes this package. For standalone Pi installation:
+While the Help minor mode is active, this package contributes `doompi-author-hook`. The prompt
+covers `.doom/hooks.yaml`, group activation, commands, payloads, decisions, and verification, and
+is withdrawn when the package or Help provider unloads.
+
+## Install
+
+For standalone Pi installation:
 
 ```bash
 pi install npm:@agimon-ai/doompi-hook
 ```
 
+## Public API
+
+```ts
+import { createBashHookRunner, hookExtension } from '@agimon-ai/doompi-hook';
+import type { HookDecision, HookEventName } from '@agimon-ai/doompi-hook';
+```
+
+## Development
+
+```bash
+pnpm build
+pnpm typecheck
+pnpm test
+pnpm lint
+```
+
+Maintained by [Agimon](https://agimon.ai/about).
+
 ## License
 
 MIT

package/dist/adapters/hookDocuments.d.cts

@@ -1,7 +1,7 @@
 import { HookDocumentReader } from "../types/hooks.cjs";
 import { HookTelemetry } from "../types/telemetry.cjs";
 //#region src/adapters/hookDocuments.d.ts
-interface HookDocumentReaderOptions {
+export interface HookDocumentReaderOptions {
   telemetry?: HookTelemetry;
   /** Where the global `.doom` directory lives. Defaults to the user's home. */
   homeDirectory?: string;
@@ -17,7 +17,6 @@ interface HookDocumentReaderOptions {
  * inside the same filesystem timestamp granularity. Both caches are keyed on
  * contents instead, so parsing — the expensive half — is what they skip.
  */
-declare function createHookDocumentReader(options?: HookDocumentReaderOptions): HookDocumentReader;
+export declare function createHookDocumentReader(options?: HookDocumentReaderOptions): HookDocumentReader;
 //#endregion
-export { HookDocumentReaderOptions, createHookDocumentReader };
 //# sourceMappingURL=hookDocuments.d.cts.map

package/dist/adapters/hookDocuments.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"hookDocuments.d.cts","names":[],"sources":["../../src/adapters/hookDocuments.ts"],"mappings":";;;UAsBiB;EACf,YAAY;;EAEZ;EACA,YAAY,qBAAqB;EACjC,QAAQ;;;;;;;;;;;iBAoBM,yBAAyB,UAAS,4BAAiC"}
+{"version":3,"file":"hookDocuments.d.cts","names":[],"sources":["../../src/adapters/hookDocuments.ts"],"mappings":";;;iBAsBiB;EACf,YAAY;;EAEZ;EACA,YAAY,qBAAqB;EACjC,QAAQ;;;;;;;;;;;wBAoBM,yBAAyB,UAAS,4BAAiC"}

package/dist/adapters/hookDocuments.d.mts

@@ -1,7 +1,7 @@
 import { HookDocumentReader } from "../types/hooks.mjs";
 import { HookTelemetry } from "../types/telemetry.mjs";
 //#region src/adapters/hookDocuments.d.ts
-interface HookDocumentReaderOptions {
+export interface HookDocumentReaderOptions {
   telemetry?: HookTelemetry;
   /** Where the global `.doom` directory lives. Defaults to the user's home. */
   homeDirectory?: string;
@@ -17,7 +17,6 @@ interface HookDocumentReaderOptions {
  * inside the same filesystem timestamp granularity. Both caches are keyed on
  * contents instead, so parsing — the expensive half — is what they skip.
  */
-declare function createHookDocumentReader(options?: HookDocumentReaderOptions): HookDocumentReader;
+export declare function createHookDocumentReader(options?: HookDocumentReaderOptions): HookDocumentReader;
 //#endregion
-export { HookDocumentReaderOptions, createHookDocumentReader };
 //# sourceMappingURL=hookDocuments.d.mts.map

package/dist/adapters/hookDocuments.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"hookDocuments.d.mts","names":[],"sources":["../../src/adapters/hookDocuments.ts"],"mappings":";;;UAsBiB;EACf,YAAY;;EAEZ;EACA,YAAY,qBAAqB;EACjC,QAAQ;;;;;;;;;;;iBAoBM,yBAAyB,UAAS,4BAAiC"}
+{"version":3,"file":"hookDocuments.d.mts","names":[],"sources":["../../src/adapters/hookDocuments.ts"],"mappings":";;;iBAsBiB;EACf,YAAY;;EAEZ;EACA,YAAY,qBAAqB;EACjC,QAAQ;;;;;;;;;;;wBAoBM,yBAAyB,UAAS,4BAAiC"}

package/dist/adapters/hookRunner.d.cts

@@ -2,7 +2,7 @@ import { HookRunner } from "../types/hooks.cjs";
 import { HookTelemetry } from "../types/telemetry.cjs";
 import { spawn } from "node:child_process";
 //#region src/adapters/hookRunner.d.ts
-interface BashHookRunnerOptions {
+export interface BashHookRunnerOptions {
   telemetry?: HookTelemetry;
   env?: NodeJS.ProcessEnv;
   platform?: NodeJS.Platform;
@@ -16,7 +16,6 @@ interface BashHookRunnerOptions {
  * group and terminated as one: a hook that starts a server and stalls should
  * not leave the server behind when the timeout fires.
  */
-declare function createBashHookRunner(options?: BashHookRunnerOptions): HookRunner;
+export declare function createBashHookRunner(options?: BashHookRunnerOptions): HookRunner;
 //#endregion
-export { BashHookRunnerOptions, createBashHookRunner };
 //# sourceMappingURL=hookRunner.d.cts.map

package/dist/adapters/hookRunner.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"hookRunner.d.cts","names":[],"sources":["../../src/adapters/hookRunner.ts"],"mappings":";;;;UAsBiB;EACf,YAAY;EACZ,MAAM,OAAO;EACb,WAAW,OAAO;EAClB,eAAe;EACf,QAAQ;;;;;;;;;iBAcM,qBAAqB,UAAS,wBAA6B"}
+{"version":3,"file":"hookRunner.d.cts","names":[],"sources":["../../src/adapters/hookRunner.ts"],"mappings":";;;;iBAsBiB;EACf,YAAY;EACZ,MAAM,OAAO;EACb,WAAW,OAAO;EAClB,eAAe;EACf,QAAQ;;;;;;;;;wBAcM,qBAAqB,UAAS,wBAA6B"}

package/dist/adapters/hookRunner.d.mts

@@ -2,7 +2,7 @@ import { HookRunner } from "../types/hooks.mjs";
 import { HookTelemetry } from "../types/telemetry.mjs";
 import { spawn } from "node:child_process";
 //#region src/adapters/hookRunner.d.ts
-interface BashHookRunnerOptions {
+export interface BashHookRunnerOptions {
   telemetry?: HookTelemetry;
   env?: NodeJS.ProcessEnv;
   platform?: NodeJS.Platform;
@@ -16,7 +16,6 @@ interface BashHookRunnerOptions {
  * group and terminated as one: a hook that starts a server and stalls should
  * not leave the server behind when the timeout fires.
  */
-declare function createBashHookRunner(options?: BashHookRunnerOptions): HookRunner;
+export declare function createBashHookRunner(options?: BashHookRunnerOptions): HookRunner;
 //#endregion
-export { BashHookRunnerOptions, createBashHookRunner };
 //# sourceMappingURL=hookRunner.d.mts.map

package/dist/adapters/hookRunner.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"hookRunner.d.mts","names":[],"sources":["../../src/adapters/hookRunner.ts"],"mappings":";;;;UAsBiB;EACf,YAAY;EACZ,MAAM,OAAO;EACb,WAAW,OAAO;EAClB,eAAe;EACf,QAAQ;;;;;;;;;iBAcM,qBAAqB,UAAS,wBAA6B"}
+{"version":3,"file":"hookRunner.d.mts","names":[],"sources":["../../src/adapters/hookRunner.ts"],"mappings":";;;;iBAsBiB;EACf,YAAY;EACZ,MAAM,OAAO;EACb,WAAW,OAAO;EAClB,eAAe;EACf,QAAQ;;;;;;;;;wBAcM,qBAAqB,UAAS,wBAA6B"}

package/dist/adapters/pi/extension.cjs

@@ -1,2 +1,2 @@
-const e=require("../hookDocuments.cjs"),t=require("../hookRunner.cjs"),n=require("../telemetry/logSinkTelemetry.cjs"),r=require("./hookHandlers.cjs");let i=require("@agimon-ai/doompi-extension-contracts/readiness"),a=require("@agimon-ai/doompi-extension-contracts/cordis-host"),o=require("@agimon-ai/doompi-extension-contracts/config"),s=require("@agimon-ai/doompi-config/piContext");const c=`@agimon-ai/doompi-hook`;function l(r,i){let a=i.telemetry,o=()=>a??=n.createHookTelemetry();return{config:()=>(0,s.requireDoomConfigContext)(r),runner:i.runner??t.createBashHookRunner({telemetry:o()}),documents:i.documents??e.createHookDocumentReader({telemetry:o()})}}function u(e,t){let n=l(e,t),r=!0,a=0,o;return{session:n,readiness:{start(t,n){let s=++a,l=()=>r&&s===a,u=(0,i.readDoomReadinessCoordinator)(e);if(!u)return n(new AbortController().signal,l);let d=o,f=(async()=>{d?.coordinator===u&&await d.operation.catch(()=>void 0),l()&&await u.start(c,`${t.sessionManager.getSessionId()}:${s}`,async e=>(await n(e,l),{value:void 0})).wait()})();f.catch(()=>void 0),o={sessionManager:t.sessionManager,coordinator:u,operation:f}},async wait(e){let t=o;if(t){if(t.sessionManager!==e.sessionManager)throw Error(`Hook readiness belongs to a stale Pi session.`);if(await t.operation,!r||t!==o)throw Error(`Hook readiness belongs to a stale extension generation.`)}}},isCurrent:()=>r,dispose(){r=!1,a+=1,o=void 0}}}function d(e,{pi:t,options:n}){let i;e.inject([o.DOOM_CONFIG_SERVICE],e=>{let t=u(e,n);i=t,e.effect(()=>()=>{t.dispose(),i===t&&(i=void 0)},`${c}/config-runtime`)}),e.effect(function*(){for(let e of r.registerHookHandlers(t,()=>i))yield e;yield()=>{i=void 0}},c);let a;t.on(`session_shutdown`,(e,t)=>{let n=i;if(n?.isCurrent())return a??=r.runSessionEndHooks(n.session,t),a})}async function f(e,t={}){let n=await(0,a.connectDoomCordisHost)(e,c),r=n.root.plugin(d,{pi:e,options:t});try{await r}catch(e){try{await r.dispose()}finally{await n.dispose()}throw e}let i;e.on(`session_shutdown`,()=>i??=(async()=>{try{await r.dispose()}finally{await n.dispose()}})())}exports.default=f,exports.hookExtension=f;
+const e=require("../hookDocuments.cjs"),t=require("../hookRunner.cjs"),n=require("../telemetry/logSinkTelemetry.cjs"),r=require("./hookHandlers.cjs");let i=require("@agimon-ai/doompi-extension-contracts/readiness"),a=require("@agimon-ai/doompi-extension-contracts/cordis-host"),o=require("@agimon-ai/doompi-extension-contracts/config"),s=require("@agimon-ai/doompi-extension-contracts/help"),c=require("@agimon-ai/doompi-config/piContext");const l=`@agimon-ai/doompi-hook`;function u(r,i){let a=i.telemetry,o=()=>a??=n.createHookTelemetry();return{config:()=>(0,c.requireDoomConfigContext)(r),runner:i.runner??t.createBashHookRunner({telemetry:o()}),documents:i.documents??e.createHookDocumentReader({telemetry:o()})}}function d(e,t){let n=u(e,t),r=!0,a=0,o;return{session:n,readiness:{start(t,n){let s=++a,c=()=>r&&s===a,u=(0,i.readDoomReadinessCoordinator)(e);if(!u)return n(new AbortController().signal,c);let d=o,f=(async()=>{d?.coordinator===u&&await d.operation.catch(()=>void 0),c()&&await u.start(l,`${t.sessionManager.getSessionId()}:${s}`,async e=>(await n(e,c),{value:void 0})).wait()})();f.catch(()=>void 0),o={sessionManager:t.sessionManager,coordinator:u,operation:f}},async wait(e){let t=o;if(t){if(t.sessionManager!==e.sessionManager)throw Error(`Hook readiness belongs to a stale Pi session.`);if(await t.operation,!r||t!==o)throw Error(`Hook readiness belongs to a stale extension generation.`)}}},isCurrent:()=>r,dispose(){r=!1,a+=1,o=void 0}}}function f(e,{pi:t,options:n}){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-hook`,description:`Author DoomPi repository or plugin hooks. Use when creating or changing .doom/hooks.yaml, selecting hook groups from modes.yaml, writing hook commands, or adapting Claude Code hook payloads and decisions to DoomPi.`}]});return()=>t.dispose()});let i;e.inject([o.DOOM_CONFIG_SERVICE],e=>{let t=d(e,n);i=t,e.effect(()=>()=>{t.dispose(),i===t&&(i=void 0)},`${l}/config-runtime`)}),e.effect(function*(){for(let e of r.registerHookHandlers(t,()=>i))yield e;yield()=>{i=void 0}},l);let a;t.on(`session_shutdown`,(e,t)=>{let n=i;if(n?.isCurrent())return a??=r.runSessionEndHooks(n.session,t),a})}async function p(e,t={}){let n=await(0,a.connectDoomCordisHost)(e,l),r=n.root.plugin(f,{pi:e,options:t});try{await r}catch(e){try{await r.dispose()}finally{await n.dispose()}throw e}let i;e.on(`session_shutdown`,()=>i??=(async()=>{try{await r.dispose()}finally{await n.dispose()}})())}exports.default=p,exports.hookExtension=p;
 //# sourceMappingURL=extension.cjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"extension.cjs","names":["createHookTelemetry","requireDoomConfigContext","createBashHookRunner","createHookDocumentReader","readDoomReadinessCoordinator","DOOM_CONFIG_SERVICE","registerHookHandlers","runSessionEndHooks","connectDoomCordisHost"],"sources":["../../../src/adapters/pi/extension.ts"],"sourcesContent":["import {\n  type DoomReadinessCoordinator,\n  readDoomReadinessCoordinator,\n} from '@agimon-ai/doompi-extension-contracts/readiness';\nimport { connectDoomCordisHost } from '@agimon-ai/doompi-extension-contracts/cordis-host';\nimport { DOOM_CONFIG_SERVICE } from '@agimon-ai/doompi-extension-contracts/config';\nimport { requireDoomConfigContext } from '@agimon-ai/doompi-config/piContext';\nimport type { Context } from '@deepseek-ai/cordis';\nimport type { ExtensionAPI, ExtensionContext } from '@earendil-works/pi-coding-agent';\nimport type { HookDocumentReader, HookRunner } from '../../types/hooks.ts';\nimport type { HookTelemetry } from '../../types/telemetry.ts';\nimport { createHookDocumentReader } from '../hookDocuments.ts';\nimport { createBashHookRunner } from '../hookRunner.ts';\nimport { createHookTelemetry } from '../telemetry/logSinkTelemetry.ts';\nimport {\n  type HookReadinessGate,\n  type HookRuntime,\n  type HookSession,\n  registerHookHandlers,\n  runSessionEndHooks,\n} from './hookHandlers.ts';\n\nconst PACKAGE_SOURCE = '@agimon-ai/doompi-hook';\n\nexport interface HookExtensionOptions {\n  telemetry?: HookTelemetry;\n  runner?: HookRunner;\n  documents?: HookDocumentReader;\n}\n\nfunction hookSession(cordis: Context, options: HookExtensionOptions): HookSession {\n  // The log sink is only built if something actually reports to it, so a fully\n  // stubbed session never touches the telemetry backend.\n  let telemetry = options.telemetry;\n  const requireTelemetry = (): HookTelemetry => (telemetry ??= createHookTelemetry());\n  return {\n    config: () => requireDoomConfigContext(cordis),\n    runner: options.runner ?? createBashHookRunner({ telemetry: requireTelemetry() }),\n    documents: options.documents ?? createHookDocumentReader({ telemetry: requireTelemetry() }),\n  };\n}\n\ninterface HookPluginConfig {\n  readonly pi: ExtensionAPI;\n  readonly options: HookExtensionOptions;\n}\n\ninterface HookRuntimeBinding extends HookRuntime {\n  dispose(): void;\n}\n\nfunction createHookRuntime(cordis: Context, options: HookExtensionOptions): HookRuntimeBinding {\n  const session = hookSession(cordis, options);\n  let active = true;\n  let generation = 0;\n  let readiness:\n    | {\n        readonly sessionManager: object;\n        readonly coordinator: DoomReadinessCoordinator;\n        readonly operation: Promise<void>;\n      }\n    | undefined;\n  const readinessGate: HookReadinessGate = {\n    start(context, operation) {\n      const ownGeneration = ++generation;\n      const isCurrent = (): boolean => active && ownGeneration === generation;\n      const coordinator = readDoomReadinessCoordinator(cordis);\n      if (!coordinator) return operation(new AbortController().signal, isCurrent);\n\n      const previous = readiness;\n      const readinessOperation = (async (): Promise<void> => {\n        if (previous?.coordinator === coordinator) await previous.operation.catch(() => undefined);\n        if (!isCurrent()) return;\n        const handle = coordinator.start(\n          PACKAGE_SOURCE,\n          `${context.sessionManager.getSessionId()}:${ownGeneration}`,\n          async (signal) => {\n            await operation(signal, isCurrent);\n            return { value: undefined };\n          },\n        );\n        await handle.wait();\n      })();\n      // Config's coordinator owns the single user-facing failure notification.\n      void readinessOperation.catch(() => undefined);\n      readiness = {\n        sessionManager: context.sessionManager,\n        coordinator,\n        operation: readinessOperation,\n      };\n      return undefined;\n    },\n    async wait(context: ExtensionContext): Promise<void> {\n      const current = readiness;\n      if (!current) return;\n      if (current.sessionManager !== context.sessionManager) {\n        throw new Error('Hook readiness belongs to a stale Pi session.');\n      }\n      await current.operation;\n      if (!active || current !== readiness) {\n        throw new Error('Hook readiness belongs to a stale extension generation.');\n      }\n    },\n  };\n  return {\n    session,\n    readiness: readinessGate,\n    isCurrent: () => active,\n    dispose() {\n      active = false;\n      generation += 1;\n      readiness = undefined;\n    },\n  };\n}\n\nfunction hookPlugin(cordis: Context, { pi, options }: HookPluginConfig): void {\n  let runtime: HookRuntimeBinding | undefined;\n  cordis.inject([DOOM_CONFIG_SERVICE], (configContext) => {\n    const binding = createHookRuntime(configContext, options);\n    runtime = binding;\n    configContext.effect(\n      () => () => {\n        binding.dispose();\n        if (runtime === binding) runtime = undefined;\n      },\n      `${PACKAGE_SOURCE}/config-runtime`,\n    );\n  });\n\n  cordis.effect(function* () {\n    for (const disposeRegistration of registerHookHandlers(pi, () => runtime)) yield disposeRegistration;\n    yield () => {\n      runtime = undefined;\n    };\n  }, PACKAGE_SOURCE);\n\n  let shutdown: Promise<void> | undefined;\n  pi.on('session_shutdown', (_event, ctx) => {\n    const current = runtime;\n    if (!current?.isCurrent()) return undefined;\n    shutdown ??= runSessionEndHooks(current.session, ctx);\n    return shutdown;\n  });\n}\n\n/** The package's single standard Pi factory. */\nexport async function hookExtension(pi: ExtensionAPI, options: HookExtensionOptions = {}): Promise<void> {\n  const connection = await connectDoomCordisHost(pi, PACKAGE_SOURCE);\n  const fiber = connection.root.plugin(hookPlugin, { pi, options });\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\nexport default hookExtension;\n"],"mappings":"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"}
+{"version":3,"file":"extension.cjs","names":["createHookTelemetry","requireDoomConfigContext","createBashHookRunner","createHookDocumentReader","readDoomReadinessCoordinator","DOOM_HELP_SERVICE","requireDoomHelpService","DOOM_CONFIG_SERVICE","registerHookHandlers","runSessionEndHooks","connectDoomCordisHost"],"sources":["../../../src/adapters/pi/extension.ts"],"sourcesContent":["import {\n  type DoomReadinessCoordinator,\n  readDoomReadinessCoordinator,\n} from '@agimon-ai/doompi-extension-contracts/readiness';\nimport { connectDoomCordisHost } from '@agimon-ai/doompi-extension-contracts/cordis-host';\nimport { DOOM_CONFIG_SERVICE } from '@agimon-ai/doompi-extension-contracts/config';\nimport { DOOM_HELP_SERVICE, requireDoomHelpService } from '@agimon-ai/doompi-extension-contracts/help';\nimport { requireDoomConfigContext } from '@agimon-ai/doompi-config/piContext';\nimport type { Context } from '@deepseek-ai/cordis';\nimport type { ExtensionAPI, ExtensionContext } from '@earendil-works/pi-coding-agent';\nimport type { HookDocumentReader, HookRunner } from '../../types/hooks.ts';\nimport type { HookTelemetry } from '../../types/telemetry.ts';\nimport { createHookDocumentReader } from '../hookDocuments.ts';\nimport { createBashHookRunner } from '../hookRunner.ts';\nimport { createHookTelemetry } from '../telemetry/logSinkTelemetry.ts';\nimport {\n  type HookReadinessGate,\n  type HookRuntime,\n  type HookSession,\n  registerHookHandlers,\n  runSessionEndHooks,\n} from './hookHandlers.ts';\n\nconst PACKAGE_SOURCE = '@agimon-ai/doompi-hook';\n\nexport interface HookExtensionOptions {\n  telemetry?: HookTelemetry;\n  runner?: HookRunner;\n  documents?: HookDocumentReader;\n}\n\nfunction hookSession(cordis: Context, options: HookExtensionOptions): HookSession {\n  // The log sink is only built if something actually reports to it, so a fully\n  // stubbed session never touches the telemetry backend.\n  let telemetry = options.telemetry;\n  const requireTelemetry = (): HookTelemetry => (telemetry ??= createHookTelemetry());\n  return {\n    config: () => requireDoomConfigContext(cordis),\n    runner: options.runner ?? createBashHookRunner({ telemetry: requireTelemetry() }),\n    documents: options.documents ?? createHookDocumentReader({ telemetry: requireTelemetry() }),\n  };\n}\n\ninterface HookPluginConfig {\n  readonly pi: ExtensionAPI;\n  readonly options: HookExtensionOptions;\n}\n\ninterface HookRuntimeBinding extends HookRuntime {\n  dispose(): void;\n}\n\nfunction createHookRuntime(cordis: Context, options: HookExtensionOptions): HookRuntimeBinding {\n  const session = hookSession(cordis, options);\n  let active = true;\n  let generation = 0;\n  let readiness:\n    | {\n        readonly sessionManager: object;\n        readonly coordinator: DoomReadinessCoordinator;\n        readonly operation: Promise<void>;\n      }\n    | undefined;\n  const readinessGate: HookReadinessGate = {\n    start(context, operation) {\n      const ownGeneration = ++generation;\n      const isCurrent = (): boolean => active && ownGeneration === generation;\n      const coordinator = readDoomReadinessCoordinator(cordis);\n      if (!coordinator) return operation(new AbortController().signal, isCurrent);\n\n      const previous = readiness;\n      const readinessOperation = (async (): Promise<void> => {\n        if (previous?.coordinator === coordinator) await previous.operation.catch(() => undefined);\n        if (!isCurrent()) return;\n        const handle = coordinator.start(\n          PACKAGE_SOURCE,\n          `${context.sessionManager.getSessionId()}:${ownGeneration}`,\n          async (signal) => {\n            await operation(signal, isCurrent);\n            return { value: undefined };\n          },\n        );\n        await handle.wait();\n      })();\n      // Config's coordinator owns the single user-facing failure notification.\n      void readinessOperation.catch(() => undefined);\n      readiness = {\n        sessionManager: context.sessionManager,\n        coordinator,\n        operation: readinessOperation,\n      };\n      return undefined;\n    },\n    async wait(context: ExtensionContext): Promise<void> {\n      const current = readiness;\n      if (!current) return;\n      if (current.sessionManager !== context.sessionManager) {\n        throw new Error('Hook readiness belongs to a stale Pi session.');\n      }\n      await current.operation;\n      if (!active || current !== readiness) {\n        throw new Error('Hook readiness belongs to a stale extension generation.');\n      }\n    },\n  };\n  return {\n    session,\n    readiness: readinessGate,\n    isCurrent: () => active,\n    dispose() {\n      active = false;\n      generation += 1;\n      readiness = undefined;\n    },\n  };\n}\n\nfunction hookPlugin(cordis: Context, { pi, options }: HookPluginConfig): 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-hook',\n          description:\n            'Author DoomPi repository or plugin hooks. Use when creating or changing .doom/hooks.yaml, selecting hook groups from modes.yaml, writing hook commands, or adapting Claude Code hook payloads and decisions to DoomPi.',\n        },\n      ],\n    });\n    return () => contribution.dispose();\n  });\n\n  let runtime: HookRuntimeBinding | undefined;\n  cordis.inject([DOOM_CONFIG_SERVICE], (configContext) => {\n    const binding = createHookRuntime(configContext, options);\n    runtime = binding;\n    configContext.effect(\n      () => () => {\n        binding.dispose();\n        if (runtime === binding) runtime = undefined;\n      },\n      `${PACKAGE_SOURCE}/config-runtime`,\n    );\n  });\n\n  cordis.effect(function* () {\n    for (const disposeRegistration of registerHookHandlers(pi, () => runtime)) yield disposeRegistration;\n    yield () => {\n      runtime = undefined;\n    };\n  }, PACKAGE_SOURCE);\n\n  let shutdown: Promise<void> | undefined;\n  pi.on('session_shutdown', (_event, ctx) => {\n    const current = runtime;\n    if (!current?.isCurrent()) return undefined;\n    shutdown ??= runSessionEndHooks(current.session, ctx);\n    return shutdown;\n  });\n}\n\n/** The package's single standard Pi factory. */\nexport async function hookExtension(pi: ExtensionAPI, options: HookExtensionOptions = {}): Promise<void> {\n  const connection = await connectDoomCordisHost(pi, PACKAGE_SOURCE);\n  const fiber = connection.root.plugin(hookPlugin, { pi, options });\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\nexport default hookExtension;\n"],"mappings":"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"}

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

@@ -2,13 +2,13 @@ import { HookDocumentReader, HookRunner } from "../../types/hooks.cjs";
 import { HookTelemetry } from "../../types/telemetry.cjs";
 import { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 //#region src/adapters/pi/extension.d.ts
-interface HookExtensionOptions {
+export interface HookExtensionOptions {
   telemetry?: HookTelemetry;
   runner?: HookRunner;
   documents?: HookDocumentReader;
 }
 /** The package's single standard Pi factory. */
-declare function hookExtension(pi: ExtensionAPI, options?: HookExtensionOptions): Promise<void>;
+export declare function hookExtension(pi: ExtensionAPI, options?: HookExtensionOptions): Promise<void>;
 //#endregion
-export { HookExtensionOptions, hookExtension as default, hookExtension };
+export { hookExtension 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":";;;;UAwBiB;EACf,YAAY;EACZ,SAAS;EACT,YAAY;;;iBAwHQ,cAAc,IAAI,cAAc,UAAS,uBAA4B"}
+{"version":3,"file":"extension.d.cts","names":[],"sources":["../../../src/adapters/pi/extension.ts"],"mappings":";;;;iBAyBiB;EACf,YAAY;EACZ,SAAS;EACT,YAAY;;;wBAuIQ,cAAc,IAAI,cAAc,UAAS,uBAA4B"}

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

@@ -2,13 +2,13 @@ import { HookDocumentReader, HookRunner } from "../../types/hooks.mjs";
 import { HookTelemetry } from "../../types/telemetry.mjs";
 import { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 //#region src/adapters/pi/extension.d.ts
-interface HookExtensionOptions {
+export interface HookExtensionOptions {
   telemetry?: HookTelemetry;
   runner?: HookRunner;
   documents?: HookDocumentReader;
 }
 /** The package's single standard Pi factory. */
-declare function hookExtension(pi: ExtensionAPI, options?: HookExtensionOptions): Promise<void>;
+export declare function hookExtension(pi: ExtensionAPI, options?: HookExtensionOptions): Promise<void>;
 //#endregion
-export { HookExtensionOptions, hookExtension as default, hookExtension };
+export { hookExtension 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":";;;;UAwBiB;EACf,YAAY;EACZ,SAAS;EACT,YAAY;;;iBAwHQ,cAAc,IAAI,cAAc,UAAS,uBAA4B"}
+{"version":3,"file":"extension.d.mts","names":[],"sources":["../../../src/adapters/pi/extension.ts"],"mappings":";;;;iBAyBiB;EACf,YAAY;EACZ,SAAS;EACT,YAAY;;;wBAuIQ,cAAc,IAAI,cAAc,UAAS,uBAA4B"}

package/dist/adapters/pi/extension.mjs

@@ -1,2 +1,2 @@
-import{createHookDocumentReader as e}from"../hookDocuments.mjs";import{createBashHookRunner as t}from"../hookRunner.mjs";import{createHookTelemetry as n}from"../telemetry/logSinkTelemetry.mjs";import{registerHookHandlers as r,runSessionEndHooks as i}from"./hookHandlers.mjs";import{readDoomReadinessCoordinator as a}from"@agimon-ai/doompi-extension-contracts/readiness";import{connectDoomCordisHost as o}from"@agimon-ai/doompi-extension-contracts/cordis-host";import{DOOM_CONFIG_SERVICE as s}from"@agimon-ai/doompi-extension-contracts/config";import{requireDoomConfigContext as c}from"@agimon-ai/doompi-config/piContext";const l=`@agimon-ai/doompi-hook`;function u(r,i){let a=i.telemetry,o=()=>a??=n();return{config:()=>c(r),runner:i.runner??t({telemetry:o()}),documents:i.documents??e({telemetry:o()})}}function d(e,t){let n=u(e,t),r=!0,i=0,o;return{session:n,readiness:{start(t,n){let s=++i,c=()=>r&&s===i,u=a(e);if(!u)return n(new AbortController().signal,c);let d=o,f=(async()=>{d?.coordinator===u&&await d.operation.catch(()=>void 0),c()&&await u.start(l,`${t.sessionManager.getSessionId()}:${s}`,async e=>(await n(e,c),{value:void 0})).wait()})();f.catch(()=>void 0),o={sessionManager:t.sessionManager,coordinator:u,operation:f}},async wait(e){let t=o;if(t){if(t.sessionManager!==e.sessionManager)throw Error(`Hook readiness belongs to a stale Pi session.`);if(await t.operation,!r||t!==o)throw Error(`Hook readiness belongs to a stale extension generation.`)}}},isCurrent:()=>r,dispose(){r=!1,i+=1,o=void 0}}}function f(e,{pi:t,options:n}){let a;e.inject([s],e=>{let t=d(e,n);a=t,e.effect(()=>()=>{t.dispose(),a===t&&(a=void 0)},`${l}/config-runtime`)}),e.effect(function*(){for(let e of r(t,()=>a))yield e;yield()=>{a=void 0}},l);let o;t.on(`session_shutdown`,(e,t)=>{let n=a;if(n?.isCurrent())return o??=i(n.session,t),o})}async function p(e,t={}){let n=await o(e,l),r=n.root.plugin(f,{pi:e,options:t});try{await r}catch(e){try{await r.dispose()}finally{await n.dispose()}throw e}let i;e.on(`session_shutdown`,()=>i??=(async()=>{try{await r.dispose()}finally{await n.dispose()}})())}export{p as default,p as hookExtension};
+import{createHookDocumentReader as e}from"../hookDocuments.mjs";import{createBashHookRunner as t}from"../hookRunner.mjs";import{createHookTelemetry as n}from"../telemetry/logSinkTelemetry.mjs";import{registerHookHandlers as r,runSessionEndHooks as i}from"./hookHandlers.mjs";import{readDoomReadinessCoordinator as a}from"@agimon-ai/doompi-extension-contracts/readiness";import{connectDoomCordisHost as o}from"@agimon-ai/doompi-extension-contracts/cordis-host";import{DOOM_CONFIG_SERVICE as s}from"@agimon-ai/doompi-extension-contracts/config";import{DOOM_HELP_SERVICE as c,requireDoomHelpService as l}from"@agimon-ai/doompi-extension-contracts/help";import{requireDoomConfigContext as u}from"@agimon-ai/doompi-config/piContext";const d=`@agimon-ai/doompi-hook`;function f(r,i){let a=i.telemetry,o=()=>a??=n();return{config:()=>u(r),runner:i.runner??t({telemetry:o()}),documents:i.documents??e({telemetry:o()})}}function p(e,t){let n=f(e,t),r=!0,i=0,o;return{session:n,readiness:{start(t,n){let s=++i,c=()=>r&&s===i,l=a(e);if(!l)return n(new AbortController().signal,c);let u=o,f=(async()=>{u?.coordinator===l&&await u.operation.catch(()=>void 0),c()&&await l.start(d,`${t.sessionManager.getSessionId()}:${s}`,async e=>(await n(e,c),{value:void 0})).wait()})();f.catch(()=>void 0),o={sessionManager:t.sessionManager,coordinator:l,operation:f}},async wait(e){let t=o;if(t){if(t.sessionManager!==e.sessionManager)throw Error(`Hook readiness belongs to a stale Pi session.`);if(await t.operation,!r||t!==o)throw Error(`Hook readiness belongs to a stale extension generation.`)}}},isCurrent:()=>r,dispose(){r=!1,i+=1,o=void 0}}}function m(e,{pi:t,options:n}){e.inject([c],e=>{let t=l(e).register({source:d,moduleUrl:import.meta.url,skills:[{name:`doompi-author-hook`,description:`Author DoomPi repository or plugin hooks. Use when creating or changing .doom/hooks.yaml, selecting hook groups from modes.yaml, writing hook commands, or adapting Claude Code hook payloads and decisions to DoomPi.`}]});return()=>t.dispose()});let a;e.inject([s],e=>{let t=p(e,n);a=t,e.effect(()=>()=>{t.dispose(),a===t&&(a=void 0)},`${d}/config-runtime`)}),e.effect(function*(){for(let e of r(t,()=>a))yield e;yield()=>{a=void 0}},d);let o;t.on(`session_shutdown`,(e,t)=>{let n=a;if(n?.isCurrent())return o??=i(n.session,t),o})}async function h(e,t={}){let n=await o(e,d),r=n.root.plugin(m,{pi:e,options:t});try{await r}catch(e){try{await r.dispose()}finally{await n.dispose()}throw e}let i;e.on(`session_shutdown`,()=>i??=(async()=>{try{await r.dispose()}finally{await n.dispose()}})())}export{h as default,h as hookExtension};
 //# 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 {\n  type DoomReadinessCoordinator,\n  readDoomReadinessCoordinator,\n} from '@agimon-ai/doompi-extension-contracts/readiness';\nimport { connectDoomCordisHost } from '@agimon-ai/doompi-extension-contracts/cordis-host';\nimport { DOOM_CONFIG_SERVICE } from '@agimon-ai/doompi-extension-contracts/config';\nimport { requireDoomConfigContext } from '@agimon-ai/doompi-config/piContext';\nimport type { Context } from '@deepseek-ai/cordis';\nimport type { ExtensionAPI, ExtensionContext } from '@earendil-works/pi-coding-agent';\nimport type { HookDocumentReader, HookRunner } from '../../types/hooks.ts';\nimport type { HookTelemetry } from '../../types/telemetry.ts';\nimport { createHookDocumentReader } from '../hookDocuments.ts';\nimport { createBashHookRunner } from '../hookRunner.ts';\nimport { createHookTelemetry } from '../telemetry/logSinkTelemetry.ts';\nimport {\n  type HookReadinessGate,\n  type HookRuntime,\n  type HookSession,\n  registerHookHandlers,\n  runSessionEndHooks,\n} from './hookHandlers.ts';\n\nconst PACKAGE_SOURCE = '@agimon-ai/doompi-hook';\n\nexport interface HookExtensionOptions {\n  telemetry?: HookTelemetry;\n  runner?: HookRunner;\n  documents?: HookDocumentReader;\n}\n\nfunction hookSession(cordis: Context, options: HookExtensionOptions): HookSession {\n  // The log sink is only built if something actually reports to it, so a fully\n  // stubbed session never touches the telemetry backend.\n  let telemetry = options.telemetry;\n  const requireTelemetry = (): HookTelemetry => (telemetry ??= createHookTelemetry());\n  return {\n    config: () => requireDoomConfigContext(cordis),\n    runner: options.runner ?? createBashHookRunner({ telemetry: requireTelemetry() }),\n    documents: options.documents ?? createHookDocumentReader({ telemetry: requireTelemetry() }),\n  };\n}\n\ninterface HookPluginConfig {\n  readonly pi: ExtensionAPI;\n  readonly options: HookExtensionOptions;\n}\n\ninterface HookRuntimeBinding extends HookRuntime {\n  dispose(): void;\n}\n\nfunction createHookRuntime(cordis: Context, options: HookExtensionOptions): HookRuntimeBinding {\n  const session = hookSession(cordis, options);\n  let active = true;\n  let generation = 0;\n  let readiness:\n    | {\n        readonly sessionManager: object;\n        readonly coordinator: DoomReadinessCoordinator;\n        readonly operation: Promise<void>;\n      }\n    | undefined;\n  const readinessGate: HookReadinessGate = {\n    start(context, operation) {\n      const ownGeneration = ++generation;\n      const isCurrent = (): boolean => active && ownGeneration === generation;\n      const coordinator = readDoomReadinessCoordinator(cordis);\n      if (!coordinator) return operation(new AbortController().signal, isCurrent);\n\n      const previous = readiness;\n      const readinessOperation = (async (): Promise<void> => {\n        if (previous?.coordinator === coordinator) await previous.operation.catch(() => undefined);\n        if (!isCurrent()) return;\n        const handle = coordinator.start(\n          PACKAGE_SOURCE,\n          `${context.sessionManager.getSessionId()}:${ownGeneration}`,\n          async (signal) => {\n            await operation(signal, isCurrent);\n            return { value: undefined };\n          },\n        );\n        await handle.wait();\n      })();\n      // Config's coordinator owns the single user-facing failure notification.\n      void readinessOperation.catch(() => undefined);\n      readiness = {\n        sessionManager: context.sessionManager,\n        coordinator,\n        operation: readinessOperation,\n      };\n      return undefined;\n    },\n    async wait(context: ExtensionContext): Promise<void> {\n      const current = readiness;\n      if (!current) return;\n      if (current.sessionManager !== context.sessionManager) {\n        throw new Error('Hook readiness belongs to a stale Pi session.');\n      }\n      await current.operation;\n      if (!active || current !== readiness) {\n        throw new Error('Hook readiness belongs to a stale extension generation.');\n      }\n    },\n  };\n  return {\n    session,\n    readiness: readinessGate,\n    isCurrent: () => active,\n    dispose() {\n      active = false;\n      generation += 1;\n      readiness = undefined;\n    },\n  };\n}\n\nfunction hookPlugin(cordis: Context, { pi, options }: HookPluginConfig): void {\n  let runtime: HookRuntimeBinding | undefined;\n  cordis.inject([DOOM_CONFIG_SERVICE], (configContext) => {\n    const binding = createHookRuntime(configContext, options);\n    runtime = binding;\n    configContext.effect(\n      () => () => {\n        binding.dispose();\n        if (runtime === binding) runtime = undefined;\n      },\n      `${PACKAGE_SOURCE}/config-runtime`,\n    );\n  });\n\n  cordis.effect(function* () {\n    for (const disposeRegistration of registerHookHandlers(pi, () => runtime)) yield disposeRegistration;\n    yield () => {\n      runtime = undefined;\n    };\n  }, PACKAGE_SOURCE);\n\n  let shutdown: Promise<void> | undefined;\n  pi.on('session_shutdown', (_event, ctx) => {\n    const current = runtime;\n    if (!current?.isCurrent()) return undefined;\n    shutdown ??= runSessionEndHooks(current.session, ctx);\n    return shutdown;\n  });\n}\n\n/** The package's single standard Pi factory. */\nexport async function hookExtension(pi: ExtensionAPI, options: HookExtensionOptions = {}): Promise<void> {\n  const connection = await connectDoomCordisHost(pi, PACKAGE_SOURCE);\n  const fiber = connection.root.plugin(hookPlugin, { pi, options });\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\nexport default hookExtension;\n"],"mappings":"6mBAsBA,MAAM,EAAiB,yBAQvB,SAAS,EAAY,EAAiB,EAA4C,CAGhF,IAAI,EAAY,EAAQ,UAClB,MAAyC,IAAc,EAAoB,EACjF,MAAO,CACL,WAAc,EAAyB,CAAM,EAC7C,OAAQ,EAAQ,QAAU,EAAqB,CAAE,UAAW,EAAiB,CAAE,CAAC,EAChF,UAAW,EAAQ,WAAa,EAAyB,CAAE,UAAW,EAAiB,CAAE,CAAC,CAC5F,CACF,CAWA,SAAS,EAAkB,EAAiB,EAAmD,CAC7F,IAAM,EAAU,EAAY,EAAQ,CAAO,EACvC,EAAS,GACT,EAAa,EACb,EAiDJ,MAAO,CACL,UACA,UAAW,CA3CX,MAAM,EAAS,EAAW,CACxB,IAAM,EAAgB,EAAE,EAClB,MAA2B,GAAU,IAAkB,EACvD,EAAc,EAA6B,CAAM,EACvD,GAAI,CAAC,EAAa,OAAO,EAAU,IAAI,gBAAgB,CAAC,CAAC,OAAQ,CAAS,EAE1E,IAAM,EAAW,EACX,GAAsB,SAA2B,CACjD,GAAU,cAAgB,GAAa,MAAM,EAAS,UAAU,UAAY,IAAA,EAAS,EACpF,EAAU,GASf,MARe,EAAY,MACzB,EACA,GAAG,EAAQ,eAAe,aAAa,EAAE,GAAG,IAC5C,KAAO,KACL,MAAM,EAAU,EAAQ,CAAS,EAC1B,CAAE,MAAO,IAAA,EAAU,EAGnB,CAAC,CAAC,KAAK,CACpB,EAAA,CAAG,EAEH,EAAwB,UAAY,IAAA,EAAS,EAC7C,EAAY,CACV,eAAgB,EAAQ,eACxB,cACA,UAAW,CACb,CAEF,EACA,MAAM,KAAK,EAA0C,CACnD,IAAM,EAAU,EACX,KACL,IAAI,EAAQ,iBAAmB,EAAQ,eACrC,MAAU,MAAM,+CAA+C,EAGjE,GADA,MAAM,EAAQ,UACV,CAAC,GAAU,IAAY,EACzB,MAAU,MAAM,yDAAyD,CAJV,CAMnE,CAIuB,EACvB,cAAiB,EACjB,SAAU,CACR,EAAS,GACT,GAAc,EACd,EAAY,IAAA,EACd,CACF,CACF,CAEA,SAAS,EAAW,EAAiB,CAAE,KAAI,WAAmC,CAC5E,IAAI,EACJ,EAAO,OAAO,CAAC,CAAmB,EAAI,GAAkB,CACtD,IAAM,EAAU,EAAkB,EAAe,CAAO,EACxD,EAAU,EACV,EAAc,eACA,CACV,EAAQ,QAAQ,EACZ,IAAY,IAAS,EAAU,IAAA,GACrC,EACA,GAAG,EAAe,gBACpB,CACF,CAAC,EAED,EAAO,OAAO,WAAa,CACzB,IAAK,IAAM,KAAuB,EAAqB,MAAU,CAAO,EAAG,MAAM,EACjF,SAAY,CACV,EAAU,IAAA,EACZ,CACF,EAAG,CAAc,EAEjB,IAAI,EACJ,EAAG,GAAG,oBAAqB,EAAQ,IAAQ,CACzC,IAAM,EAAU,EACX,MAAS,UAAU,EAExB,MADA,KAAa,EAAmB,EAAQ,QAAS,CAAG,EAC7C,CACT,CAAC,CACH,CAGA,eAAsB,EAAc,EAAkB,EAAgC,CAAC,EAAkB,CACvG,IAAM,EAAa,MAAM,EAAsB,EAAI,CAAc,EAC3D,EAAQ,EAAW,KAAK,OAAO,EAAY,CAAE,KAAI,SAAQ,CAAC,EAChE,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"}
+{"version":3,"file":"extension.mjs","names":[],"sources":["../../../src/adapters/pi/extension.ts"],"sourcesContent":["import {\n  type DoomReadinessCoordinator,\n  readDoomReadinessCoordinator,\n} from '@agimon-ai/doompi-extension-contracts/readiness';\nimport { connectDoomCordisHost } from '@agimon-ai/doompi-extension-contracts/cordis-host';\nimport { DOOM_CONFIG_SERVICE } from '@agimon-ai/doompi-extension-contracts/config';\nimport { DOOM_HELP_SERVICE, requireDoomHelpService } from '@agimon-ai/doompi-extension-contracts/help';\nimport { requireDoomConfigContext } from '@agimon-ai/doompi-config/piContext';\nimport type { Context } from '@deepseek-ai/cordis';\nimport type { ExtensionAPI, ExtensionContext } from '@earendil-works/pi-coding-agent';\nimport type { HookDocumentReader, HookRunner } from '../../types/hooks.ts';\nimport type { HookTelemetry } from '../../types/telemetry.ts';\nimport { createHookDocumentReader } from '../hookDocuments.ts';\nimport { createBashHookRunner } from '../hookRunner.ts';\nimport { createHookTelemetry } from '../telemetry/logSinkTelemetry.ts';\nimport {\n  type HookReadinessGate,\n  type HookRuntime,\n  type HookSession,\n  registerHookHandlers,\n  runSessionEndHooks,\n} from './hookHandlers.ts';\n\nconst PACKAGE_SOURCE = '@agimon-ai/doompi-hook';\n\nexport interface HookExtensionOptions {\n  telemetry?: HookTelemetry;\n  runner?: HookRunner;\n  documents?: HookDocumentReader;\n}\n\nfunction hookSession(cordis: Context, options: HookExtensionOptions): HookSession {\n  // The log sink is only built if something actually reports to it, so a fully\n  // stubbed session never touches the telemetry backend.\n  let telemetry = options.telemetry;\n  const requireTelemetry = (): HookTelemetry => (telemetry ??= createHookTelemetry());\n  return {\n    config: () => requireDoomConfigContext(cordis),\n    runner: options.runner ?? createBashHookRunner({ telemetry: requireTelemetry() }),\n    documents: options.documents ?? createHookDocumentReader({ telemetry: requireTelemetry() }),\n  };\n}\n\ninterface HookPluginConfig {\n  readonly pi: ExtensionAPI;\n  readonly options: HookExtensionOptions;\n}\n\ninterface HookRuntimeBinding extends HookRuntime {\n  dispose(): void;\n}\n\nfunction createHookRuntime(cordis: Context, options: HookExtensionOptions): HookRuntimeBinding {\n  const session = hookSession(cordis, options);\n  let active = true;\n  let generation = 0;\n  let readiness:\n    | {\n        readonly sessionManager: object;\n        readonly coordinator: DoomReadinessCoordinator;\n        readonly operation: Promise<void>;\n      }\n    | undefined;\n  const readinessGate: HookReadinessGate = {\n    start(context, operation) {\n      const ownGeneration = ++generation;\n      const isCurrent = (): boolean => active && ownGeneration === generation;\n      const coordinator = readDoomReadinessCoordinator(cordis);\n      if (!coordinator) return operation(new AbortController().signal, isCurrent);\n\n      const previous = readiness;\n      const readinessOperation = (async (): Promise<void> => {\n        if (previous?.coordinator === coordinator) await previous.operation.catch(() => undefined);\n        if (!isCurrent()) return;\n        const handle = coordinator.start(\n          PACKAGE_SOURCE,\n          `${context.sessionManager.getSessionId()}:${ownGeneration}`,\n          async (signal) => {\n            await operation(signal, isCurrent);\n            return { value: undefined };\n          },\n        );\n        await handle.wait();\n      })();\n      // Config's coordinator owns the single user-facing failure notification.\n      void readinessOperation.catch(() => undefined);\n      readiness = {\n        sessionManager: context.sessionManager,\n        coordinator,\n        operation: readinessOperation,\n      };\n      return undefined;\n    },\n    async wait(context: ExtensionContext): Promise<void> {\n      const current = readiness;\n      if (!current) return;\n      if (current.sessionManager !== context.sessionManager) {\n        throw new Error('Hook readiness belongs to a stale Pi session.');\n      }\n      await current.operation;\n      if (!active || current !== readiness) {\n        throw new Error('Hook readiness belongs to a stale extension generation.');\n      }\n    },\n  };\n  return {\n    session,\n    readiness: readinessGate,\n    isCurrent: () => active,\n    dispose() {\n      active = false;\n      generation += 1;\n      readiness = undefined;\n    },\n  };\n}\n\nfunction hookPlugin(cordis: Context, { pi, options }: HookPluginConfig): 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-hook',\n          description:\n            'Author DoomPi repository or plugin hooks. Use when creating or changing .doom/hooks.yaml, selecting hook groups from modes.yaml, writing hook commands, or adapting Claude Code hook payloads and decisions to DoomPi.',\n        },\n      ],\n    });\n    return () => contribution.dispose();\n  });\n\n  let runtime: HookRuntimeBinding | undefined;\n  cordis.inject([DOOM_CONFIG_SERVICE], (configContext) => {\n    const binding = createHookRuntime(configContext, options);\n    runtime = binding;\n    configContext.effect(\n      () => () => {\n        binding.dispose();\n        if (runtime === binding) runtime = undefined;\n      },\n      `${PACKAGE_SOURCE}/config-runtime`,\n    );\n  });\n\n  cordis.effect(function* () {\n    for (const disposeRegistration of registerHookHandlers(pi, () => runtime)) yield disposeRegistration;\n    yield () => {\n      runtime = undefined;\n    };\n  }, PACKAGE_SOURCE);\n\n  let shutdown: Promise<void> | undefined;\n  pi.on('session_shutdown', (_event, ctx) => {\n    const current = runtime;\n    if (!current?.isCurrent()) return undefined;\n    shutdown ??= runSessionEndHooks(current.session, ctx);\n    return shutdown;\n  });\n}\n\n/** The package's single standard Pi factory. */\nexport async function hookExtension(pi: ExtensionAPI, options: HookExtensionOptions = {}): Promise<void> {\n  const connection = await connectDoomCordisHost(pi, PACKAGE_SOURCE);\n  const fiber = connection.root.plugin(hookPlugin, { pi, options });\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\nexport default hookExtension;\n"],"mappings":"wtBAuBA,MAAM,EAAiB,yBAQvB,SAAS,EAAY,EAAiB,EAA4C,CAGhF,IAAI,EAAY,EAAQ,UAClB,MAAyC,IAAc,EAAoB,EACjF,MAAO,CACL,WAAc,EAAyB,CAAM,EAC7C,OAAQ,EAAQ,QAAU,EAAqB,CAAE,UAAW,EAAiB,CAAE,CAAC,EAChF,UAAW,EAAQ,WAAa,EAAyB,CAAE,UAAW,EAAiB,CAAE,CAAC,CAC5F,CACF,CAWA,SAAS,EAAkB,EAAiB,EAAmD,CAC7F,IAAM,EAAU,EAAY,EAAQ,CAAO,EACvC,EAAS,GACT,EAAa,EACb,EAiDJ,MAAO,CACL,UACA,UAAW,CA3CX,MAAM,EAAS,EAAW,CACxB,IAAM,EAAgB,EAAE,EAClB,MAA2B,GAAU,IAAkB,EACvD,EAAc,EAA6B,CAAM,EACvD,GAAI,CAAC,EAAa,OAAO,EAAU,IAAI,gBAAgB,CAAC,CAAC,OAAQ,CAAS,EAE1E,IAAM,EAAW,EACX,GAAsB,SAA2B,CACjD,GAAU,cAAgB,GAAa,MAAM,EAAS,UAAU,UAAY,IAAA,EAAS,EACpF,EAAU,GASf,MARe,EAAY,MACzB,EACA,GAAG,EAAQ,eAAe,aAAa,EAAE,GAAG,IAC5C,KAAO,KACL,MAAM,EAAU,EAAQ,CAAS,EAC1B,CAAE,MAAO,IAAA,EAAU,EAGnB,CAAC,CAAC,KAAK,CACpB,EAAA,CAAG,EAEH,EAAwB,UAAY,IAAA,EAAS,EAC7C,EAAY,CACV,eAAgB,EAAQ,eACxB,cACA,UAAW,CACb,CAEF,EACA,MAAM,KAAK,EAA0C,CACnD,IAAM,EAAU,EACX,KACL,IAAI,EAAQ,iBAAmB,EAAQ,eACrC,MAAU,MAAM,+CAA+C,EAGjE,GADA,MAAM,EAAQ,UACV,CAAC,GAAU,IAAY,EACzB,MAAU,MAAM,yDAAyD,CAJV,CAMnE,CAIuB,EACvB,cAAiB,EACjB,SAAU,CACR,EAAS,GACT,GAAc,EACd,EAAY,IAAA,EACd,CACF,CACF,CAEA,SAAS,EAAW,EAAiB,CAAE,KAAI,WAAmC,CAC5E,EAAO,OAAO,CAAC,CAAiB,EAAI,GAAgB,CAClD,IAAM,EAAe,EAAuB,CAAW,CAAC,CAAC,SAAS,CAChE,OAAQ,EACR,UAAW,YAAY,IACvB,OAAQ,CACN,CACE,KAAM,qBACN,YACE,wNACJ,CACF,CACF,CAAC,EACD,UAAa,EAAa,QAAQ,CACpC,CAAC,EAED,IAAI,EACJ,EAAO,OAAO,CAAC,CAAmB,EAAI,GAAkB,CACtD,IAAM,EAAU,EAAkB,EAAe,CAAO,EACxD,EAAU,EACV,EAAc,eACA,CACV,EAAQ,QAAQ,EACZ,IAAY,IAAS,EAAU,IAAA,GACrC,EACA,GAAG,EAAe,gBACpB,CACF,CAAC,EAED,EAAO,OAAO,WAAa,CACzB,IAAK,IAAM,KAAuB,EAAqB,MAAU,CAAO,EAAG,MAAM,EACjF,SAAY,CACV,EAAU,IAAA,EACZ,CACF,EAAG,CAAc,EAEjB,IAAI,EACJ,EAAG,GAAG,oBAAqB,EAAQ,IAAQ,CACzC,IAAM,EAAU,EACX,MAAS,UAAU,EAExB,MADA,KAAa,EAAmB,EAAQ,QAAS,CAAG,EAC7C,CACT,CAAC,CACH,CAGA,eAAsB,EAAc,EAAkB,EAAgC,CAAC,EAAkB,CACvG,IAAM,EAAa,MAAM,EAAsB,EAAI,CAAc,EAC3D,EAAQ,EAAW,KAAK,OAAO,EAAY,CAAE,KAAI,SAAQ,CAAC,EAChE,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"}

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

@@ -1,14 +1,13 @@
 import { HookTelemetry } from "../../types/telemetry.cjs";
 import { DoomTelemetryOptions } from "@agimon-ai/doompi-telemetry";
 //#region src/adapters/telemetry/logSinkTelemetry.d.ts
-interface HookTelemetryOptions {
+export interface HookTelemetryOptions {
   cwd?: string;
   workspaceRoot?: string;
   env?: NodeJS.ProcessEnv;
   telemetryFactory?: NonNullable<DoomTelemetryOptions['telemetryFactory']>;
   warn?: (message: string) => void;
 }
-declare function createHookTelemetry(options?: HookTelemetryOptions): HookTelemetry;
+export declare function createHookTelemetry(options?: HookTelemetryOptions): HookTelemetry;
 //#endregion
-export { HookTelemetryOptions, createHookTelemetry };
 //# 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,oBAAoB,UAAS,uBAA4B"}
+{"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,oBAAoB,UAAS,uBAA4B"}

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

@@ -1,14 +1,13 @@
 import { HookTelemetry } from "../../types/telemetry.mjs";
 import { DoomTelemetryOptions } from "@agimon-ai/doompi-telemetry";
 //#region src/adapters/telemetry/logSinkTelemetry.d.ts
-interface HookTelemetryOptions {
+export interface HookTelemetryOptions {
   cwd?: string;
   workspaceRoot?: string;
   env?: NodeJS.ProcessEnv;
   telemetryFactory?: NonNullable<DoomTelemetryOptions['telemetryFactory']>;
   warn?: (message: string) => void;
 }
-declare function createHookTelemetry(options?: HookTelemetryOptions): HookTelemetry;
+export declare function createHookTelemetry(options?: HookTelemetryOptions): HookTelemetry;
 //#endregion
-export { HookTelemetryOptions, createHookTelemetry };
 //# 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,oBAAoB,UAAS,uBAA4B"}
+{"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,oBAAoB,UAAS,uBAA4B"}

package/dist/services/hookDecisions.d.cts

@@ -1,19 +1,18 @@
 import { HookDecision, HookFailure, HookOutcome } from "../types/hooks.cjs";
 //#region src/services/hookDecisions.d.ts
-declare function decisionsFrom(outcomes: ReadonlyArray<HookOutcome>): HookDecision[];
-declare function failuresFrom(outcomes: ReadonlyArray<HookOutcome>): HookFailure[];
+export declare function decisionsFrom(outcomes: ReadonlyArray<HookOutcome>): HookDecision[];
+export declare function failuresFrom(outcomes: ReadonlyArray<HookOutcome>): HookFailure[];
 /** Both spellings a hook may use to refuse the call it observed. */
-declare function isDenied(decision: HookDecision | undefined): boolean;
-declare function decisionReason(decision: HookDecision | undefined): string | undefined;
+export declare function isDenied(decision: HookDecision | undefined): boolean;
+export declare function decisionReason(decision: HookDecision | undefined): string | undefined;
 /** Context a hook wants added to the conversation rather than used to block. */
-declare function additionalContextsFrom(decisions: ReadonlyArray<HookDecision>): string[];
+export declare function additionalContextsFrom(decisions: ReadonlyArray<HookDecision>): string[];
 /** What a post-tool hook has to say, whichever field it said it in. */
-declare function toolResultMessages(decisions: ReadonlyArray<HookDecision>): string[];
+export declare function toolResultMessages(decisions: ReadonlyArray<HookDecision>): string[];
 /**
  * A guardrail that never ran looks exactly like one that passed, so the agent is
  * told which checks were missed and what its options are.
  */
-declare function hookFailureMessage(failures: ReadonlyArray<HookFailure>): string;
+export declare function hookFailureMessage(failures: ReadonlyArray<HookFailure>): string;
 //#endregion
-export { additionalContextsFrom, decisionReason, decisionsFrom, failuresFrom, hookFailureMessage, isDenied, toolResultMessages };
 //# sourceMappingURL=hookDecisions.d.cts.map

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

@@ -1 +1 @@
-{"version":3,"file":"hookDecisions.d.cts","names":[],"sources":["../../src/services/hookDecisions.ts"],"mappings":";;iBAKgB,cAAc,UAAU,cAAc,eAAe;iBAIrD,aAAa,UAAU,cAAc,eAAe;;iBAKpD,SAAS,UAAU;iBAInB,eAAe,UAAU;;iBAKzB,uBAAuB,WAAW,cAAc;;iBAOhD,mBAAmB,WAAW,cAAc;;;;;iBAU5C,mBAAmB,UAAU,cAAc"}
+{"version":3,"file":"hookDecisions.d.cts","names":[],"sources":["../../src/services/hookDecisions.ts"],"mappings":";;wBAKgB,cAAc,UAAU,cAAc,eAAe;wBAIrD,aAAa,UAAU,cAAc,eAAe;;wBAKpD,SAAS,UAAU;wBAInB,eAAe,UAAU;;wBAKzB,uBAAuB,WAAW,cAAc;;wBAOhD,mBAAmB,WAAW,cAAc;;;;;wBAU5C,mBAAmB,UAAU,cAAc"}

package/dist/services/hookDecisions.d.mts

@@ -1,19 +1,18 @@
 import { HookDecision, HookFailure, HookOutcome } from "../types/hooks.mjs";
 //#region src/services/hookDecisions.d.ts
-declare function decisionsFrom(outcomes: ReadonlyArray<HookOutcome>): HookDecision[];
-declare function failuresFrom(outcomes: ReadonlyArray<HookOutcome>): HookFailure[];
+export declare function decisionsFrom(outcomes: ReadonlyArray<HookOutcome>): HookDecision[];
+export declare function failuresFrom(outcomes: ReadonlyArray<HookOutcome>): HookFailure[];
 /** Both spellings a hook may use to refuse the call it observed. */
-declare function isDenied(decision: HookDecision | undefined): boolean;
-declare function decisionReason(decision: HookDecision | undefined): string | undefined;
+export declare function isDenied(decision: HookDecision | undefined): boolean;
+export declare function decisionReason(decision: HookDecision | undefined): string | undefined;
 /** Context a hook wants added to the conversation rather than used to block. */
-declare function additionalContextsFrom(decisions: ReadonlyArray<HookDecision>): string[];
+export declare function additionalContextsFrom(decisions: ReadonlyArray<HookDecision>): string[];
 /** What a post-tool hook has to say, whichever field it said it in. */
-declare function toolResultMessages(decisions: ReadonlyArray<HookDecision>): string[];
+export declare function toolResultMessages(decisions: ReadonlyArray<HookDecision>): string[];
 /**
  * A guardrail that never ran looks exactly like one that passed, so the agent is
  * told which checks were missed and what its options are.
  */
-declare function hookFailureMessage(failures: ReadonlyArray<HookFailure>): string;
+export declare function hookFailureMessage(failures: ReadonlyArray<HookFailure>): string;
 //#endregion
-export { additionalContextsFrom, decisionReason, decisionsFrom, failuresFrom, hookFailureMessage, isDenied, toolResultMessages };
 //# sourceMappingURL=hookDecisions.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"hookDecisions.d.mts","names":[],"sources":["../../src/services/hookDecisions.ts"],"mappings":";;iBAKgB,cAAc,UAAU,cAAc,eAAe;iBAIrD,aAAa,UAAU,cAAc,eAAe;;iBAKpD,SAAS,UAAU;iBAInB,eAAe,UAAU;;iBAKzB,uBAAuB,WAAW,cAAc;;iBAOhD,mBAAmB,WAAW,cAAc;;;;;iBAU5C,mBAAmB,UAAU,cAAc"}
+{"version":3,"file":"hookDecisions.d.mts","names":[],"sources":["../../src/services/hookDecisions.ts"],"mappings":";;wBAKgB,cAAc,UAAU,cAAc,eAAe;wBAIrD,aAAa,UAAU,cAAc,eAAe;;wBAKpD,SAAS,UAAU;wBAInB,eAAe,UAAU;;wBAKzB,uBAAuB,WAAW,cAAc;;wBAOhD,mBAAmB,WAAW,cAAc;;;;;wBAU5C,mBAAmB,UAAU,cAAc"}

package/dist/services/hookPayload.d.cts

@@ -1,9 +1,8 @@
 import { HookPayload, HookToolEvent } from "../types/hooks.cjs";
 //#region src/services/hookPayload.d.ts
 /** The payload shape a Claude Code session hook is written against. */
-declare function toolHookPayload(event: HookToolEvent, hookEventName: string, repoRoot: string, sessionId: string): HookPayload;
+export declare function toolHookPayload(event: HookToolEvent, hookEventName: string, repoRoot: string, sessionId: string): HookPayload;
 /** Session lifecycle hooks observe no tool, so they only need where and who. */
-declare function sessionHookPayload(sessionId: string, repoRoot: string): HookPayload;
+export declare function sessionHookPayload(sessionId: string, repoRoot: string): HookPayload;
 //#endregion
-export { sessionHookPayload, toolHookPayload };
 //# sourceMappingURL=hookPayload.d.cts.map

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

@@ -1 +1 @@
-{"version":3,"file":"hookPayload.d.cts","names":[],"sources":["../../src/services/hookPayload.ts"],"mappings":";;;iBAMgB,gBACd,OAAO,eACP,uBACA,kBACA,oBACC;;iBAaa,mBAAmB,mBAAmB,mBAAmB"}
+{"version":3,"file":"hookPayload.d.cts","names":[],"sources":["../../src/services/hookPayload.ts"],"mappings":";;;wBAMgB,gBACd,OAAO,eACP,uBACA,kBACA,oBACC;;wBAaa,mBAAmB,mBAAmB,mBAAmB"}

package/dist/services/hookPayload.d.mts

@@ -1,9 +1,8 @@
 import { HookPayload, HookToolEvent } from "../types/hooks.mjs";
 //#region src/services/hookPayload.d.ts
 /** The payload shape a Claude Code session hook is written against. */
-declare function toolHookPayload(event: HookToolEvent, hookEventName: string, repoRoot: string, sessionId: string): HookPayload;
+export declare function toolHookPayload(event: HookToolEvent, hookEventName: string, repoRoot: string, sessionId: string): HookPayload;
 /** Session lifecycle hooks observe no tool, so they only need where and who. */
-declare function sessionHookPayload(sessionId: string, repoRoot: string): HookPayload;
+export declare function sessionHookPayload(sessionId: string, repoRoot: string): HookPayload;
 //#endregion
-export { sessionHookPayload, toolHookPayload };
 //# sourceMappingURL=hookPayload.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"hookPayload.d.mts","names":[],"sources":["../../src/services/hookPayload.ts"],"mappings":";;;iBAMgB,gBACd,OAAO,eACP,uBACA,kBACA,oBACC;;iBAaa,mBAAmB,mBAAmB,mBAAmB"}
+{"version":3,"file":"hookPayload.d.mts","names":[],"sources":["../../src/services/hookPayload.ts"],"mappings":";;;wBAMgB,gBACd,OAAO,eACP,uBACA,kBACA,oBACC;;wBAaa,mBAAmB,mBAAmB,mBAAmB"}

package/dist/services/hookRegistry.d.cts

@@ -1,7 +1,7 @@
 import { HookDocumentSource, ParsedRegistrySource, RegistryEntry, ResolvedHook } from "../types/hooks.cjs";
 //#region src/services/hookRegistry.d.ts
 /** Which rows a dispatch keeps, once the session's selection is known. */
-interface RegistrySelection {
+export interface RegistrySelection {
   event: string;
   toolName?: string;
   /** Selected group ids, or undefined for "every group", the standalone default. */
@@ -15,7 +15,7 @@ interface RegistrySelection {
  * rewrite and needs no invalidation hook. Reading both files is cheap; parsing
  * is what a cache built on this skips.
  */
-declare function registryCacheKey(sources: ReadonlyArray<HookDocumentSource>): string;
+export declare function registryCacheKey(sources: ReadonlyArray<HookDocumentSource>): string;
 /**
  * Flattens parsed registry documents into sorted rows, keeping only bindings
  * that declare a `pi` frontend.
@@ -23,7 +23,7 @@ declare function registryCacheKey(sources: ReadonlyArray<HookDocumentSource>): s
  * A later source replaces the group of the same id outright rather than merging
  * into it, so a repository that redefines a group owns it completely.
  */
-declare function registryEntries(sources: ReadonlyArray<ParsedRegistrySource>): RegistryEntry[];
+export declare function registryEntries(sources: ReadonlyArray<ParsedRegistrySource>): RegistryEntry[];
 /**
  * The rows one dispatch runs.
  *
@@ -31,7 +31,6 @@ declare function registryEntries(sources: ReadonlyArray<ParsedRegistrySource>):
  * applied per call rather than being baked into a cached parse. Core groups
  * always load; the rest are gated by the layers the harness resolved.
  */
-declare function selectRegistryHooks(entries: ReadonlyArray<RegistryEntry>, selection: RegistrySelection): ResolvedHook[];
+export declare function selectRegistryHooks(entries: ReadonlyArray<RegistryEntry>, selection: RegistrySelection): ResolvedHook[];
 //#endregion
-export { RegistrySelection, registryCacheKey, registryEntries, selectRegistryHooks };
 //# sourceMappingURL=hookRegistry.d.cts.map

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

@@ -1 +1 @@
-{"version":3,"file":"hookRegistry.d.cts","names":[],"sources":["../../src/services/hookRegistry.ts"],"mappings":";;;UAIiB;EACf;EACA;;EAEA;EACA;;;;;;;;;iBAUc,iBAAiB,SAAS,cAAc;;;;;;;;iBAWxC,gBAAgB,SAAS,cAAc,wBAAwB;;;;;;;;iBAqC/D,oBACd,SAAS,cAAc,gBACvB,WAAW,oBACV"}
+{"version":3,"file":"hookRegistry.d.cts","names":[],"sources":["../../src/services/hookRegistry.ts"],"mappings":";;;iBAIiB;EACf;EACA;;EAEA;EACA;;;;;;;;;wBAUc,iBAAiB,SAAS,cAAc;;;;;;;;wBAWxC,gBAAgB,SAAS,cAAc,wBAAwB;;;;;;;;wBAqC/D,oBACd,SAAS,cAAc,gBACvB,WAAW,oBACV"}

package/dist/services/hookRegistry.d.mts

@@ -1,7 +1,7 @@
 import { HookDocumentSource, ParsedRegistrySource, RegistryEntry, ResolvedHook } from "../types/hooks.mjs";
 //#region src/services/hookRegistry.d.ts
 /** Which rows a dispatch keeps, once the session's selection is known. */
-interface RegistrySelection {
+export interface RegistrySelection {
   event: string;
   toolName?: string;
   /** Selected group ids, or undefined for "every group", the standalone default. */
@@ -15,7 +15,7 @@ interface RegistrySelection {
  * rewrite and needs no invalidation hook. Reading both files is cheap; parsing
  * is what a cache built on this skips.
  */
-declare function registryCacheKey(sources: ReadonlyArray<HookDocumentSource>): string;
+export declare function registryCacheKey(sources: ReadonlyArray<HookDocumentSource>): string;
 /**
  * Flattens parsed registry documents into sorted rows, keeping only bindings
  * that declare a `pi` frontend.
@@ -23,7 +23,7 @@ declare function registryCacheKey(sources: ReadonlyArray<HookDocumentSource>): s
  * A later source replaces the group of the same id outright rather than merging
  * into it, so a repository that redefines a group owns it completely.
  */
-declare function registryEntries(sources: ReadonlyArray<ParsedRegistrySource>): RegistryEntry[];
+export declare function registryEntries(sources: ReadonlyArray<ParsedRegistrySource>): RegistryEntry[];
 /**
  * The rows one dispatch runs.
  *
@@ -31,7 +31,6 @@ declare function registryEntries(sources: ReadonlyArray<ParsedRegistrySource>):
  * applied per call rather than being baked into a cached parse. Core groups
  * always load; the rest are gated by the layers the harness resolved.
  */
-declare function selectRegistryHooks(entries: ReadonlyArray<RegistryEntry>, selection: RegistrySelection): ResolvedHook[];
+export declare function selectRegistryHooks(entries: ReadonlyArray<RegistryEntry>, selection: RegistrySelection): ResolvedHook[];
 //#endregion
-export { RegistrySelection, registryCacheKey, registryEntries, selectRegistryHooks };
 //# sourceMappingURL=hookRegistry.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"hookRegistry.d.mts","names":[],"sources":["../../src/services/hookRegistry.ts"],"mappings":";;;UAIiB;EACf;EACA;;EAEA;EACA;;;;;;;;;iBAUc,iBAAiB,SAAS,cAAc;;;;;;;;iBAWxC,gBAAgB,SAAS,cAAc,wBAAwB;;;;;;;;iBAqC/D,oBACd,SAAS,cAAc,gBACvB,WAAW,oBACV"}
+{"version":3,"file":"hookRegistry.d.mts","names":[],"sources":["../../src/services/hookRegistry.ts"],"mappings":";;;iBAIiB;EACf;EACA;;EAEA;EACA;;;;;;;;;wBAUc,iBAAiB,SAAS,cAAc;;;;;;;;wBAWxC,gBAAgB,SAAS,cAAc,wBAAwB;;;;;;;;wBAqC/D,oBACd,SAAS,cAAc,gBACvB,WAAW,oBACV"}