@agimon-ai/doompi-hook 0.0.1-alpha.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vuong Ngo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,83 @@
+# @agimon-ai/doompi-hook
+
+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:
+
+```yaml
+# .doom/hooks.yaml
+groups:
+  safety:
+    core: true
+    hooks:
+      - event: PreToolUse
+        pi:
+          matcher: Bash
+          command: .doom/hooks/guard-destructive-commands.sh
+  workflow:
+    hooks:
+      - event: Stop
+        pi:
+          command: .doom/hooks/close-workflow-step.sh
+          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.
+
+## Activation
+
+The DoomPi distribution activates this package by default. Layers only declare the `hookGroups`
+that should run in a major mode:
+
+```yaml
+# .doom/modes.yaml
+layers:
+  repository-hooks:
+    hookGroups: [safety, workflow]
+```
+
+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 last stdout line that starts with `{` is read as the hook's decision:
+
+| Event mapping                   | A decision can                                                     |
+| ------------------------------- | ------------------------------------------------------------------ |
+| `SessionStart` → session start  | add `additionalContext` to the conversation                        |
+| `PreToolUse` → tool call        | block the call with a reason, or steer it with `additionalContext` |
+| `PostToolUse` → tool result     | append text to the result and mark it an error                     |
+| `Stop` → agent settled          | nothing; the hook runs for its side effects                        |
+| `SessionEnd` → session shutdown | nothing; plugin hooks only                                         |
+
+A hook that exits non-zero, times out, cannot be spawned, or prints unparseable JSON does not fail
+the turn. It is reported to the agent instead, because a guardrail that never ran is otherwise
+indistinguishable from one that passed.
+
+## Timeouts
+
+`timeout` is in seconds and defaults to 10. A hook is spawned in its own process group and, when it
+expires, is sent `SIGTERM` and then `SIGKILL` two seconds later, so a stalled hook does not leave
+the processes it started behind.
+
+## Installation
+
+DoomPi already includes this package. For standalone Pi installation:
+
+```bash
+pi install npm:@agimon-ai/doompi-hook
+```
+
+## License
+
+MIT

package/dist/_virtual/_rolldown/runtime.cjs

@@ -0,0 +1 @@
+var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},s=(n,r,s)=>(s=n==null?{}:e(i(n)),o(r||!n||!n.__esModule||!a.call(n,`default`)?t(s,`default`,{value:n,enumerable:!0}):s,n));exports.__toESM=s;

package/dist/adapters/hookDocuments.cjs

@@ -0,0 +1,2 @@
+const e=require("../_virtual/_rolldown/runtime.cjs"),t=require("../types/telemetry.cjs"),n=require("../services/hookRegistry.cjs");let r=require("node:fs");r=e.__toESM(r,1);let i=require("@agimon-ai/doompi-config/layeredConfig"),a=require("yaml");function o(e){return e instanceof Error?e.message:String(e)}function s(e){return e?.code===`ENOENT`}function c(e={}){let c=e.readFile??(e=>r.default.promises.readFile(e,`utf8`)),l=e.telemetry,u=e.warn??(e=>void process.stderr.write(e)),d,f=[],p=new Map,m=async e=>{try{return{baseDirectory:e.baseDirectory,text:await c(e.filePath)}}catch(e){if(s(e))return;throw e}},h=e=>{let t=n.registryCacheKey(e);return d===t?f:(f=n.registryEntries(e.map(e=>({baseDirectory:e.baseDirectory,document:(0,a.parse)(e.text)??{}}))),d=t,f)};return{async registry(n){let r=(0,i.doomConfigCandidates)(`hooks.yaml`,n,e.homeDirectory),a=r.map(e=>e.filePath).join(` and `);try{let e=(await Promise.all(r.map(m))).filter(e=>e!==void 0);return{entries:h(e)}}catch(e){return l?.recordError(t.HOOK_TELEMETRY_EVENT.hookRegistryReadFailed,e,{"hook.registry.source":`repository`}),u(`[pi-hook] could not read ${a}: ${o(e)}\n`),{entries:[],failure:{command:a,message:o(e),reason:`registry_read`}}}},async plugins(e){let t=[],n=[];for(let r of e)try{let e=await c(r.configPath),n=p.get(r.configPath),i=n?.source===e?n.config:JSON.parse(e);p.set(r.configPath,{source:e,config:i}),t.push({pluginRoot:r.pluginRoot,config:i})}catch(e){n.push({command:r.configPath,message:o(e),reason:`plugin_config`})}return{documents:t,failures:n}}}}exports.createHookDocumentReader=c;
+//# sourceMappingURL=hookDocuments.cjs.map

package/dist/adapters/hookDocuments.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"hookDocuments.cjs","names":["fs","registryCacheKey","registryEntries","parseYaml","doomConfigCandidates","HOOK_TELEMETRY_EVENT"],"sources":["../../src/adapters/hookDocuments.ts"],"sourcesContent":["import fs from 'node:fs';\nimport { doomConfigCandidates } from '@agimon-ai/doompi-config/layeredConfig';\nimport { parse as parseYaml } from 'yaml';\nimport type {\n  HookDocumentReader,\n  HookDocumentSource,\n  PluginDocumentRead,\n  PluginHookConfig,\n  PluginHookDocument,\n  PluginHookSourceRef,\n  RegistryDocument,\n  RegistryEntry,\n  RegistryRead,\n} from '../types/hooks.ts';\nimport { HOOK_TELEMETRY_EVENT, type HookTelemetry } from '../types/telemetry.ts';\nimport { registryCacheKey, registryEntries } from '../services/hookRegistry.ts';\n\nconst HOOKS_FILE = 'hooks.yaml';\nconst FILE_ENCODING = 'utf8';\nconst FILE_NOT_FOUND_ERROR = 'ENOENT';\nconst REGISTRY_SOURCE_ATTRIBUTE = 'repository';\n\nexport interface HookDocumentReaderOptions {\n  telemetry?: HookTelemetry;\n  /** Where the global `.doom` directory lives. Defaults to the user's home. */\n  homeDirectory?: string;\n  readFile?: (filePath: string) => Promise<string>;\n  warn?: (message: string) => void;\n}\n\nfunction reason(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\nfunction isMissingFile(error: unknown): boolean {\n  return (error as NodeJS.ErrnoException | undefined)?.code === FILE_NOT_FOUND_ERROR;\n}\n\n/**\n * Reads `.doom/hooks.yaml` from the global config directory and the repository,\n * and the plugin hook configs the harness resolved.\n *\n * Every file is re-read on every dispatch: it costs almost nothing and keeps an\n * in-place rewrite visible, which an mtime check would miss when two writes land\n * inside the same filesystem timestamp granularity. Both caches are keyed on\n * contents instead, so parsing — the expensive half — is what they skip.\n */\nexport function createHookDocumentReader(options: HookDocumentReaderOptions = {}): HookDocumentReader {\n  const readFile = options.readFile ?? ((filePath: string) => fs.promises.readFile(filePath, FILE_ENCODING));\n  const telemetry = options.telemetry;\n  const warn = options.warn ?? ((message: string) => void process.stderr.write(message));\n  let cachedRegistryKey: string | undefined;\n  let cachedRegistryEntries: RegistryEntry[] = [];\n  const pluginConfigCache = new Map<string, { source: string; config: PluginHookConfig }>();\n\n  const readSource = async (candidate: {\n    filePath: string;\n    baseDirectory: string;\n  }): Promise<HookDocumentSource | undefined> => {\n    try {\n      return { baseDirectory: candidate.baseDirectory, text: await readFile(candidate.filePath) };\n    } catch (error) {\n      if (isMissingFile(error)) return undefined;\n      throw error;\n    }\n  };\n\n  const parseSources = (sources: ReadonlyArray<HookDocumentSource>): RegistryEntry[] => {\n    const key = registryCacheKey(sources);\n    if (cachedRegistryKey === key) return cachedRegistryEntries;\n    cachedRegistryEntries = registryEntries(\n      sources.map((source) => ({\n        baseDirectory: source.baseDirectory,\n        document: (parseYaml(source.text) ?? {}) as RegistryDocument,\n      })),\n    );\n    cachedRegistryKey = key;\n    return cachedRegistryEntries;\n  };\n\n  return {\n    async registry(repoRoot: string): Promise<RegistryRead> {\n      const candidates = doomConfigCandidates(HOOKS_FILE, repoRoot, options.homeDirectory);\n      // Named for the error path only. A registry absent from both locations is\n      // a repository with no hooks, not a failure, so only a file that exists\n      // and cannot be read or parsed reaches the catch below.\n      const registryPath = candidates.map((candidate) => candidate.filePath).join(' and ');\n      try {\n        const sources = (await Promise.all(candidates.map(readSource))).filter(\n          (source): source is HookDocumentSource => source !== undefined,\n        );\n        return { entries: parseSources(sources) };\n      } catch (error) {\n        // This empties the registry for the whole dispatch, so every repository\n        // hook silently stops running rather than any one of them failing.\n        void telemetry?.recordError(HOOK_TELEMETRY_EVENT.hookRegistryReadFailed, error, {\n          'hook.registry.source': REGISTRY_SOURCE_ATTRIBUTE,\n        });\n        warn(`[pi-hook] could not read ${registryPath}: ${reason(error)}\\n`);\n        return { entries: [], failure: { command: registryPath, message: reason(error), reason: 'registry_read' } };\n      }\n    },\n\n    async plugins(sources: readonly PluginHookSourceRef[]): Promise<PluginDocumentRead> {\n      const documents: PluginHookDocument[] = [];\n      const failures: PluginDocumentRead['failures'] = [];\n      for (const source of sources) {\n        try {\n          const text = await readFile(source.configPath);\n          const cached = pluginConfigCache.get(source.configPath);\n          const config = cached?.source === text ? cached.config : (JSON.parse(text) as PluginHookConfig);\n          pluginConfigCache.set(source.configPath, { source: text, config });\n          documents.push({ pluginRoot: source.pluginRoot, config });\n        } catch (error) {\n          failures.push({ command: source.configPath, message: reason(error), reason: 'plugin_config' });\n        }\n      }\n      return { documents, failures };\n    },\n  };\n}\n"],"mappings":"uPA8BA,SAAS,EAAO,EAAwB,CACtC,OAAO,aAAiB,MAAQ,EAAM,QAAU,OAAO,CAAK,CAC9D,CAEA,SAAS,EAAc,EAAyB,CAC9C,OAAQ,GAA6C,OAAS,QAChE,CAWA,SAAgB,EAAyB,EAAqC,CAAC,EAAuB,CACpG,IAAM,EAAW,EAAQ,WAAc,GAAqBA,EAAAA,QAAG,SAAS,SAAS,EAAU,MAAa,GAClG,EAAY,EAAQ,UACpB,EAAO,EAAQ,OAAU,GAAoB,KAAK,QAAQ,OAAO,MAAM,CAAO,GAChF,EACA,EAAyC,CAAC,EACxC,EAAoB,IAAI,IAExB,EAAa,KAAO,IAGqB,CAC7C,GAAI,CACF,MAAO,CAAE,cAAe,EAAU,cAAe,KAAM,MAAM,EAAS,EAAU,QAAQ,CAAE,CAC5F,OAAS,EAAO,CACd,GAAI,EAAc,CAAK,EAAG,OAC1B,MAAM,CACR,CACF,EAEM,EAAgB,GAAgE,CACpF,IAAM,EAAMC,EAAAA,iBAAiB,CAAO,EASpC,OARI,IAAsB,EAAY,GACtC,EAAwBC,EAAAA,gBACtB,EAAQ,IAAK,IAAY,CACvB,cAAe,EAAO,cACtB,UAAA,EAAWC,EAAAA,MAAAA,CAAU,EAAO,IAAI,GAAK,CAAC,CACxC,EAAE,CACJ,EACA,EAAoB,EACb,EACT,EAEA,MAAO,CACL,MAAM,SAAS,EAAyC,CACtD,IAAM,GAAA,EAAaC,EAAAA,qBAAAA,CAAqB,aAAY,EAAU,EAAQ,aAAa,EAI7E,EAAe,EAAW,IAAK,GAAc,EAAU,QAAQ,CAAC,CAAC,KAAK,OAAO,EACnF,GAAI,CACF,IAAM,GAAW,MAAM,QAAQ,IAAI,EAAW,IAAI,CAAU,CAAC,EAAA,CAAG,OAC7D,GAAyC,IAAW,IAAA,EACvD,EACA,MAAO,CAAE,QAAS,EAAa,CAAO,CAAE,CAC1C,OAAS,EAAO,CAOd,OAJA,GAAgB,YAAYC,EAAAA,qBAAqB,uBAAwB,EAAO,CAC9E,uBAAwB,YAC1B,CAAC,EACD,EAAK,4BAA4B,EAAa,IAAI,EAAO,CAAK,EAAE,GAAG,EAC5D,CAAE,QAAS,CAAC,EAAG,QAAS,CAAE,QAAS,EAAc,QAAS,EAAO,CAAK,EAAG,OAAQ,eAAgB,CAAE,CAC5G,CACF,EAEA,MAAM,QAAQ,EAAsE,CAClF,IAAM,EAAkC,CAAC,EACnC,EAA2C,CAAC,EAClD,IAAK,IAAM,KAAU,EACnB,GAAI,CACF,IAAM,EAAO,MAAM,EAAS,EAAO,UAAU,EACvC,EAAS,EAAkB,IAAI,EAAO,UAAU,EAChD,EAAS,GAAQ,SAAW,EAAO,EAAO,OAAU,KAAK,MAAM,CAAI,EACzE,EAAkB,IAAI,EAAO,WAAY,CAAE,OAAQ,EAAM,QAAO,CAAC,EACjE,EAAU,KAAK,CAAE,WAAY,EAAO,WAAY,QAAO,CAAC,CAC1D,OAAS,EAAO,CACd,EAAS,KAAK,CAAE,QAAS,EAAO,WAAY,QAAS,EAAO,CAAK,EAAG,OAAQ,eAAgB,CAAC,CAC/F,CAEF,MAAO,CAAE,YAAW,UAAS,CAC/B,CACF,CACF"}

package/dist/adapters/hookDocuments.d.cts

@@ -0,0 +1,23 @@
+import { HookDocumentReader } from "../types/hooks.cjs";
+import { HookTelemetry } from "../types/telemetry.cjs";
+//#region src/adapters/hookDocuments.d.ts
+interface HookDocumentReaderOptions {
+  telemetry?: HookTelemetry;
+  /** Where the global `.doom` directory lives. Defaults to the user's home. */
+  homeDirectory?: string;
+  readFile?: (filePath: string) => Promise<string>;
+  warn?: (message: string) => void;
+}
+/**
+ * Reads `.doom/hooks.yaml` from the global config directory and the repository,
+ * and the plugin hook configs the harness resolved.
+ *
+ * Every file is re-read on every dispatch: it costs almost nothing and keeps an
+ * in-place rewrite visible, which an mtime check would miss when two writes land
+ * 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;
+//#endregion
+export { HookDocumentReaderOptions, createHookDocumentReader };
+//# sourceMappingURL=hookDocuments.d.cts.map

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

@@ -0,0 +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"}

package/dist/adapters/hookDocuments.d.mts

@@ -0,0 +1,23 @@
+import { HookDocumentReader } from "../types/hooks.mjs";
+import { HookTelemetry } from "../types/telemetry.mjs";
+//#region src/adapters/hookDocuments.d.ts
+interface HookDocumentReaderOptions {
+  telemetry?: HookTelemetry;
+  /** Where the global `.doom` directory lives. Defaults to the user's home. */
+  homeDirectory?: string;
+  readFile?: (filePath: string) => Promise<string>;
+  warn?: (message: string) => void;
+}
+/**
+ * Reads `.doom/hooks.yaml` from the global config directory and the repository,
+ * and the plugin hook configs the harness resolved.
+ *
+ * Every file is re-read on every dispatch: it costs almost nothing and keeps an
+ * in-place rewrite visible, which an mtime check would miss when two writes land
+ * 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;
+//#endregion
+export { HookDocumentReaderOptions, createHookDocumentReader };
+//# sourceMappingURL=hookDocuments.d.mts.map

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

@@ -0,0 +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"}

package/dist/adapters/hookDocuments.mjs

@@ -0,0 +1,2 @@
+import{HOOK_TELEMETRY_EVENT as e}from"../types/telemetry.mjs";import{registryCacheKey as t,registryEntries as n}from"../services/hookRegistry.mjs";import r from"node:fs";import{doomConfigCandidates as i}from"@agimon-ai/doompi-config/layeredConfig";import{parse as a}from"yaml";function o(e){return e instanceof Error?e.message:String(e)}function s(e){return e?.code===`ENOENT`}function c(c={}){let l=c.readFile??(e=>r.promises.readFile(e,`utf8`)),u=c.telemetry,d=c.warn??(e=>void process.stderr.write(e)),f,p=[],m=new Map,h=async e=>{try{return{baseDirectory:e.baseDirectory,text:await l(e.filePath)}}catch(e){if(s(e))return;throw e}},g=e=>{let r=t(e);return f===r?p:(p=n(e.map(e=>({baseDirectory:e.baseDirectory,document:a(e.text)??{}}))),f=r,p)};return{async registry(t){let n=i(`hooks.yaml`,t,c.homeDirectory),r=n.map(e=>e.filePath).join(` and `);try{let e=(await Promise.all(n.map(h))).filter(e=>e!==void 0);return{entries:g(e)}}catch(t){return u?.recordError(e.hookRegistryReadFailed,t,{"hook.registry.source":`repository`}),d(`[pi-hook] could not read ${r}: ${o(t)}\n`),{entries:[],failure:{command:r,message:o(t),reason:`registry_read`}}}},async plugins(e){let t=[],n=[];for(let r of e)try{let e=await l(r.configPath),n=m.get(r.configPath),i=n?.source===e?n.config:JSON.parse(e);m.set(r.configPath,{source:e,config:i}),t.push({pluginRoot:r.pluginRoot,config:i})}catch(e){n.push({command:r.configPath,message:o(e),reason:`plugin_config`})}return{documents:t,failures:n}}}}export{c as createHookDocumentReader};
+//# sourceMappingURL=hookDocuments.mjs.map

package/dist/adapters/hookDocuments.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"hookDocuments.mjs","names":["parseYaml"],"sources":["../../src/adapters/hookDocuments.ts"],"sourcesContent":["import fs from 'node:fs';\nimport { doomConfigCandidates } from '@agimon-ai/doompi-config/layeredConfig';\nimport { parse as parseYaml } from 'yaml';\nimport type {\n  HookDocumentReader,\n  HookDocumentSource,\n  PluginDocumentRead,\n  PluginHookConfig,\n  PluginHookDocument,\n  PluginHookSourceRef,\n  RegistryDocument,\n  RegistryEntry,\n  RegistryRead,\n} from '../types/hooks.ts';\nimport { HOOK_TELEMETRY_EVENT, type HookTelemetry } from '../types/telemetry.ts';\nimport { registryCacheKey, registryEntries } from '../services/hookRegistry.ts';\n\nconst HOOKS_FILE = 'hooks.yaml';\nconst FILE_ENCODING = 'utf8';\nconst FILE_NOT_FOUND_ERROR = 'ENOENT';\nconst REGISTRY_SOURCE_ATTRIBUTE = 'repository';\n\nexport interface HookDocumentReaderOptions {\n  telemetry?: HookTelemetry;\n  /** Where the global `.doom` directory lives. Defaults to the user's home. */\n  homeDirectory?: string;\n  readFile?: (filePath: string) => Promise<string>;\n  warn?: (message: string) => void;\n}\n\nfunction reason(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\nfunction isMissingFile(error: unknown): boolean {\n  return (error as NodeJS.ErrnoException | undefined)?.code === FILE_NOT_FOUND_ERROR;\n}\n\n/**\n * Reads `.doom/hooks.yaml` from the global config directory and the repository,\n * and the plugin hook configs the harness resolved.\n *\n * Every file is re-read on every dispatch: it costs almost nothing and keeps an\n * in-place rewrite visible, which an mtime check would miss when two writes land\n * inside the same filesystem timestamp granularity. Both caches are keyed on\n * contents instead, so parsing — the expensive half — is what they skip.\n */\nexport function createHookDocumentReader(options: HookDocumentReaderOptions = {}): HookDocumentReader {\n  const readFile = options.readFile ?? ((filePath: string) => fs.promises.readFile(filePath, FILE_ENCODING));\n  const telemetry = options.telemetry;\n  const warn = options.warn ?? ((message: string) => void process.stderr.write(message));\n  let cachedRegistryKey: string | undefined;\n  let cachedRegistryEntries: RegistryEntry[] = [];\n  const pluginConfigCache = new Map<string, { source: string; config: PluginHookConfig }>();\n\n  const readSource = async (candidate: {\n    filePath: string;\n    baseDirectory: string;\n  }): Promise<HookDocumentSource | undefined> => {\n    try {\n      return { baseDirectory: candidate.baseDirectory, text: await readFile(candidate.filePath) };\n    } catch (error) {\n      if (isMissingFile(error)) return undefined;\n      throw error;\n    }\n  };\n\n  const parseSources = (sources: ReadonlyArray<HookDocumentSource>): RegistryEntry[] => {\n    const key = registryCacheKey(sources);\n    if (cachedRegistryKey === key) return cachedRegistryEntries;\n    cachedRegistryEntries = registryEntries(\n      sources.map((source) => ({\n        baseDirectory: source.baseDirectory,\n        document: (parseYaml(source.text) ?? {}) as RegistryDocument,\n      })),\n    );\n    cachedRegistryKey = key;\n    return cachedRegistryEntries;\n  };\n\n  return {\n    async registry(repoRoot: string): Promise<RegistryRead> {\n      const candidates = doomConfigCandidates(HOOKS_FILE, repoRoot, options.homeDirectory);\n      // Named for the error path only. A registry absent from both locations is\n      // a repository with no hooks, not a failure, so only a file that exists\n      // and cannot be read or parsed reaches the catch below.\n      const registryPath = candidates.map((candidate) => candidate.filePath).join(' and ');\n      try {\n        const sources = (await Promise.all(candidates.map(readSource))).filter(\n          (source): source is HookDocumentSource => source !== undefined,\n        );\n        return { entries: parseSources(sources) };\n      } catch (error) {\n        // This empties the registry for the whole dispatch, so every repository\n        // hook silently stops running rather than any one of them failing.\n        void telemetry?.recordError(HOOK_TELEMETRY_EVENT.hookRegistryReadFailed, error, {\n          'hook.registry.source': REGISTRY_SOURCE_ATTRIBUTE,\n        });\n        warn(`[pi-hook] could not read ${registryPath}: ${reason(error)}\\n`);\n        return { entries: [], failure: { command: registryPath, message: reason(error), reason: 'registry_read' } };\n      }\n    },\n\n    async plugins(sources: readonly PluginHookSourceRef[]): Promise<PluginDocumentRead> {\n      const documents: PluginHookDocument[] = [];\n      const failures: PluginDocumentRead['failures'] = [];\n      for (const source of sources) {\n        try {\n          const text = await readFile(source.configPath);\n          const cached = pluginConfigCache.get(source.configPath);\n          const config = cached?.source === text ? cached.config : (JSON.parse(text) as PluginHookConfig);\n          pluginConfigCache.set(source.configPath, { source: text, config });\n          documents.push({ pluginRoot: source.pluginRoot, config });\n        } catch (error) {\n          failures.push({ command: source.configPath, message: reason(error), reason: 'plugin_config' });\n        }\n      }\n      return { documents, failures };\n    },\n  };\n}\n"],"mappings":"qRA8BA,SAAS,EAAO,EAAwB,CACtC,OAAO,aAAiB,MAAQ,EAAM,QAAU,OAAO,CAAK,CAC9D,CAEA,SAAS,EAAc,EAAyB,CAC9C,OAAQ,GAA6C,OAAS,QAChE,CAWA,SAAgB,EAAyB,EAAqC,CAAC,EAAuB,CACpG,IAAM,EAAW,EAAQ,WAAc,GAAqB,EAAG,SAAS,SAAS,EAAU,MAAa,GAClG,EAAY,EAAQ,UACpB,EAAO,EAAQ,OAAU,GAAoB,KAAK,QAAQ,OAAO,MAAM,CAAO,GAChF,EACA,EAAyC,CAAC,EACxC,EAAoB,IAAI,IAExB,EAAa,KAAO,IAGqB,CAC7C,GAAI,CACF,MAAO,CAAE,cAAe,EAAU,cAAe,KAAM,MAAM,EAAS,EAAU,QAAQ,CAAE,CAC5F,OAAS,EAAO,CACd,GAAI,EAAc,CAAK,EAAG,OAC1B,MAAM,CACR,CACF,EAEM,EAAgB,GAAgE,CACpF,IAAM,EAAM,EAAiB,CAAO,EASpC,OARI,IAAsB,EAAY,GACtC,EAAwB,EACtB,EAAQ,IAAK,IAAY,CACvB,cAAe,EAAO,cACtB,SAAWA,EAAU,EAAO,IAAI,GAAK,CAAC,CACxC,EAAE,CACJ,EACA,EAAoB,EACb,EACT,EAEA,MAAO,CACL,MAAM,SAAS,EAAyC,CACtD,IAAM,EAAa,EAAqB,aAAY,EAAU,EAAQ,aAAa,EAI7E,EAAe,EAAW,IAAK,GAAc,EAAU,QAAQ,CAAC,CAAC,KAAK,OAAO,EACnF,GAAI,CACF,IAAM,GAAW,MAAM,QAAQ,IAAI,EAAW,IAAI,CAAU,CAAC,EAAA,CAAG,OAC7D,GAAyC,IAAW,IAAA,EACvD,EACA,MAAO,CAAE,QAAS,EAAa,CAAO,CAAE,CAC1C,OAAS,EAAO,CAOd,OAJA,GAAgB,YAAY,EAAqB,uBAAwB,EAAO,CAC9E,uBAAwB,YAC1B,CAAC,EACD,EAAK,4BAA4B,EAAa,IAAI,EAAO,CAAK,EAAE,GAAG,EAC5D,CAAE,QAAS,CAAC,EAAG,QAAS,CAAE,QAAS,EAAc,QAAS,EAAO,CAAK,EAAG,OAAQ,eAAgB,CAAE,CAC5G,CACF,EAEA,MAAM,QAAQ,EAAsE,CAClF,IAAM,EAAkC,CAAC,EACnC,EAA2C,CAAC,EAClD,IAAK,IAAM,KAAU,EACnB,GAAI,CACF,IAAM,EAAO,MAAM,EAAS,EAAO,UAAU,EACvC,EAAS,EAAkB,IAAI,EAAO,UAAU,EAChD,EAAS,GAAQ,SAAW,EAAO,EAAO,OAAU,KAAK,MAAM,CAAI,EACzE,EAAkB,IAAI,EAAO,WAAY,CAAE,OAAQ,EAAM,QAAO,CAAC,EACjE,EAAU,KAAK,CAAE,WAAY,EAAO,WAAY,QAAO,CAAC,CAC1D,OAAS,EAAO,CACd,EAAS,KAAK,CAAE,QAAS,EAAO,WAAY,QAAS,EAAO,CAAK,EAAG,OAAQ,eAAgB,CAAC,CAC/F,CAEF,MAAO,CAAE,YAAW,UAAS,CAC/B,CACF,CACF"}

package/dist/adapters/hookRunner.cjs

@@ -0,0 +1,2 @@
+const e=require("../types/telemetry.cjs");let t=require("node:child_process");const n=`ESRCH`,r=/\r?\n/;function i(e){return e instanceof Error&&`code`in e?String(e.code):void 0}function a(a={}){let o=a.spawn??t.spawn,s=a.telemetry,c=a.warn??(e=>void process.stderr.write(e)),l=(a.platform??process.platform)!==`win32`,u=(e,t)=>r=>{try{if(l&&e!==void 0){process.kill(-e,r);return}t(r)}catch(e){i(e)!==n&&process.emitWarning(`Could not signal repository hook process: ${String(e)}`)}};return{run(t,d,f){let p=t.timeout??10,m=a.env??process.env;return new Promise(a=>{let h=o(`/bin/bash`,[`-c`,t.command],{cwd:f.repoRoot,env:{...m,CLAUDE_PROJECT_DIR:f.repoRoot,CODEX_REPO_ROOT:f.repoRoot,ORIGINAL_REPO_PATH:m.ORIGINAL_REPO_PATH??f.repoRoot,...f.pluginRoot?{CLAUDE_PLUGIN_ROOT:f.pluginRoot}:{}},stdio:[`pipe`,`pipe`,`pipe`],detached:l}),g=``,_=``,v=!1,y=!1,b=!1,x=null,S,C=u(h.pid,e=>h.kill(e)),w=()=>{if(!l||h.pid===void 0)return!b;try{return process.kill(-h.pid,0),!0}catch(e){return i(e)!==n}},T=(e={})=>{v||(v=!0,clearTimeout(D),S&&clearTimeout(S),a(e))},E=()=>{let n=`Hook timed out after ${p} seconds.`;s?.recordWarning(e.HOOK_TELEMETRY_EVENT.hookFailed,n,{"hook.reason":`timeout`,"hook.exit_code":x??-1}),c(`[pi-hook] advisory hook timed out: ${t.command}\n${_}`),T({failure:{command:t.command,message:n,reason:`timeout`}})},D=setTimeout(()=>{y=!0,C(`SIGTERM`),S=setTimeout(()=>{w()&&C(`SIGKILL`),E()},2e3)},p*1e3);h.stdout?.on(`data`,e=>{g+=e.toString()}),h.stderr?.on(`data`,e=>{_+=e.toString()}),h.once(`error`,n=>{y||(s?.recordError(e.HOOK_TELEMETRY_EVENT.hookFailed,n,{"hook.reason":`spawn_failed`}),c(`[pi-hook] advisory hook failed: ${n.message}\n`),T({failure:{command:t.command,message:n.message,reason:`spawn_failed`}}))}),h.once(`exit`,n=>{if(b=!0,x=n,y)return;if(n!==0){let r=_.trim()||`Advisory hook exited with code ${n??`unknown`}`;s?.recordWarning(e.HOOK_TELEMETRY_EVENT.hookFailed,r,{"hook.reason":`non_zero_exit`,"hook.exit_code":n??-1}),c(`[pi-hook] advisory hook failed (${n}): ${t.command}\n${_}`),T({failure:{command:t.command,message:r,reason:`non_zero_exit`}});return}let i=g.trim().split(r).reverse().find(e=>e.startsWith(`{`));if(!i){T();return}try{T({decision:JSON.parse(i)})}catch(n){s?.recordWarning(e.HOOK_TELEMETRY_EVENT.hookFailed,n,{"hook.reason":`invalid_json`}),c(`[pi-hook] advisory hook returned invalid JSON: ${t.command}\n`),T({failure:{command:t.command,message:n instanceof Error?n.message:String(n),reason:`invalid_json`}})}}),h.stdin?.end(JSON.stringify(d))})}}}exports.createBashHookRunner=a;
+//# sourceMappingURL=hookRunner.cjs.map

package/dist/adapters/hookRunner.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"hookRunner.cjs","names":["spawnProcess","HOOK_TELEMETRY_EVENT"],"sources":["../../src/adapters/hookRunner.ts"],"sourcesContent":["import { spawn as spawnProcess } from 'node:child_process';\nimport type {\n  HookCommand,\n  HookDecision,\n  HookOutcome,\n  HookPayload,\n  HookRunOptions,\n  HookRunner,\n} from '../types/hooks.ts';\nimport { HOOK_TELEMETRY_EVENT, type HookTelemetry } from '../types/telemetry.ts';\n\nconst HOOK_SHELL = '/bin/bash';\nconst HOOK_SHELL_COMMAND_FLAG = '-c';\nconst HOOK_TERMINATION_GRACE_MS = 2_000;\nconst DEFAULT_HOOK_TIMEOUT_SECONDS = 10;\nconst MILLISECONDS_PER_SECOND = 1_000;\nconst PROCESS_NOT_FOUND_ERROR = 'ESRCH';\nconst WINDOWS_PLATFORM = 'win32';\nconst UNKNOWN_EXIT_CODE = -1;\nconst JSON_LINE_START = '{';\nconst LINE_BREAK = /\\r?\\n/;\n\nexport interface BashHookRunnerOptions {\n  telemetry?: HookTelemetry;\n  env?: NodeJS.ProcessEnv;\n  platform?: NodeJS.Platform;\n  spawn?: typeof spawnProcess;\n  warn?: (message: string) => void;\n}\n\nfunction errorCode(error: unknown): string | undefined {\n  return error instanceof Error && 'code' in error ? String(error.code) : undefined;\n}\n\n/**\n * Runs advisory hook commands through bash and reports what each one decided.\n *\n * A hook is a command the repository owns, so it is spawned in its own process\n * group and terminated as one: a hook that starts a server and stalls should\n * not leave the server behind when the timeout fires.\n */\nexport function createBashHookRunner(options: BashHookRunnerOptions = {}): HookRunner {\n  const spawn = options.spawn ?? spawnProcess;\n  const telemetry = options.telemetry;\n  const warn = options.warn ?? ((message: string) => void process.stderr.write(message));\n  const useProcessGroup = (options.platform ?? process.platform) !== WINDOWS_PLATFORM;\n\n  const signalOwnedProcess = (\n    pid: number | undefined,\n    kill: (signal: NodeJS.Signals) => void,\n  ): ((signal: NodeJS.Signals) => void) => {\n    return (signal) => {\n      try {\n        if (useProcessGroup && pid !== undefined) {\n          process.kill(-pid, signal);\n          return;\n        }\n        kill(signal);\n      } catch (error) {\n        if (errorCode(error) !== PROCESS_NOT_FOUND_ERROR) {\n          process.emitWarning(`Could not signal repository hook process: ${String(error)}`);\n        }\n      }\n    };\n  };\n\n  return {\n    run(hook: HookCommand, payload: HookPayload, runOptions: HookRunOptions): Promise<HookOutcome> {\n      const timeoutSeconds = hook.timeout ?? DEFAULT_HOOK_TIMEOUT_SECONDS;\n      const environment = options.env ?? process.env;\n      return new Promise((resolve) => {\n        // -c, not -lc. Hooks run on every tool call, and a login shell would\n        // source the developer's profile each time: per-call latency plus hook\n        // behavior that varies with their dotfiles. The child inherits the\n        // environment below, so it keeps the PATH the launcher started with.\n        const child = spawn(HOOK_SHELL, [HOOK_SHELL_COMMAND_FLAG, hook.command], {\n          cwd: runOptions.repoRoot,\n          env: {\n            ...environment,\n            CLAUDE_PROJECT_DIR: runOptions.repoRoot,\n            CODEX_REPO_ROOT: runOptions.repoRoot,\n            ORIGINAL_REPO_PATH: environment.ORIGINAL_REPO_PATH ?? runOptions.repoRoot,\n            ...(runOptions.pluginRoot ? { CLAUDE_PLUGIN_ROOT: runOptions.pluginRoot } : {}),\n          },\n          stdio: ['pipe', 'pipe', 'pipe'],\n          detached: useProcessGroup,\n        });\n        let stdout = '';\n        let stderr = '';\n        let settled = false;\n        let timedOut = false;\n        let childExited = false;\n        let timeoutExitCode: number | null = null;\n        let escalationTimer: NodeJS.Timeout | undefined;\n\n        const signal = signalOwnedProcess(child.pid, (value) => child.kill(value));\n\n        const ownedProcessIsAlive = (): boolean => {\n          if (!useProcessGroup || child.pid === undefined) return !childExited;\n          try {\n            process.kill(-child.pid, 0);\n            return true;\n          } catch (error) {\n            return errorCode(error) !== PROCESS_NOT_FOUND_ERROR;\n          }\n        };\n\n        const finish = (outcome: HookOutcome = {}): void => {\n          if (settled) return;\n          settled = true;\n          clearTimeout(timer);\n          if (escalationTimer) clearTimeout(escalationTimer);\n          resolve(outcome);\n        };\n\n        const finishTimeout = (): void => {\n          const message = `Hook timed out after ${timeoutSeconds} seconds.`;\n          void telemetry?.recordWarning(HOOK_TELEMETRY_EVENT.hookFailed, message, {\n            'hook.reason': 'timeout',\n            'hook.exit_code': timeoutExitCode ?? UNKNOWN_EXIT_CODE,\n          });\n          warn(`[pi-hook] advisory hook timed out: ${hook.command}\\n${stderr}`);\n          finish({ failure: { command: hook.command, message, reason: 'timeout' } });\n        };\n\n        const timer = setTimeout(() => {\n          timedOut = true;\n          signal('SIGTERM');\n          escalationTimer = setTimeout(() => {\n            if (ownedProcessIsAlive()) signal('SIGKILL');\n            finishTimeout();\n          }, HOOK_TERMINATION_GRACE_MS);\n        }, timeoutSeconds * MILLISECONDS_PER_SECOND);\n\n        child.stdout?.on('data', (chunk: Buffer) => {\n          stdout += chunk.toString();\n        });\n        child.stderr?.on('data', (chunk: Buffer) => {\n          stderr += chunk.toString();\n        });\n        child.once('error', (error: Error) => {\n          if (timedOut) return;\n          // A guardrail that never ran is indistinguishable from one that\n          // passed, which is the whole reason these are worth reporting.\n          void telemetry?.recordError(HOOK_TELEMETRY_EVENT.hookFailed, error, { 'hook.reason': 'spawn_failed' });\n          warn(`[pi-hook] advisory hook failed: ${error.message}\\n`);\n          finish({ failure: { command: hook.command, message: error.message, reason: 'spawn_failed' } });\n        });\n        child.once('exit', (code: number | null) => {\n          childExited = true;\n          timeoutExitCode = code;\n          if (timedOut) return;\n          if (code !== 0) {\n            const message = stderr.trim() || `Advisory hook exited with code ${code ?? 'unknown'}`;\n            void telemetry?.recordWarning(HOOK_TELEMETRY_EVENT.hookFailed, message, {\n              'hook.reason': 'non_zero_exit',\n              'hook.exit_code': code ?? UNKNOWN_EXIT_CODE,\n            });\n            warn(`[pi-hook] advisory hook failed (${code}): ${hook.command}\\n${stderr}`);\n            finish({ failure: { command: hook.command, message, reason: 'non_zero_exit' } });\n            return;\n          }\n          const jsonLine = stdout\n            .trim()\n            .split(LINE_BREAK)\n            .reverse()\n            .find((line) => line.startsWith(JSON_LINE_START));\n          if (!jsonLine) {\n            finish();\n            return;\n          }\n          try {\n            finish({ decision: JSON.parse(jsonLine) as HookDecision });\n          } catch (error) {\n            // The hook ran and had an opinion, and it was dropped.\n            void telemetry?.recordWarning(HOOK_TELEMETRY_EVENT.hookFailed, error, { 'hook.reason': 'invalid_json' });\n            warn(`[pi-hook] advisory hook returned invalid JSON: ${hook.command}\\n`);\n            finish({\n              failure: {\n                command: hook.command,\n                message: error instanceof Error ? error.message : String(error),\n                reason: 'invalid_json',\n              },\n            });\n          }\n        });\n        child.stdin?.end(JSON.stringify(payload));\n      });\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/adapters/hookRunner.d.cts

@@ -0,0 +1,22 @@
+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 {
+  telemetry?: HookTelemetry;
+  env?: NodeJS.ProcessEnv;
+  platform?: NodeJS.Platform;
+  spawn?: typeof spawn;
+  warn?: (message: string) => void;
+}
+/**
+ * Runs advisory hook commands through bash and reports what each one decided.
+ *
+ * A hook is a command the repository owns, so it is spawned in its own process
+ * 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;
+//#endregion
+export { BashHookRunnerOptions, createBashHookRunner };
+//# sourceMappingURL=hookRunner.d.cts.map

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

@@ -0,0 +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"}

package/dist/adapters/hookRunner.d.mts

@@ -0,0 +1,22 @@
+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 {
+  telemetry?: HookTelemetry;
+  env?: NodeJS.ProcessEnv;
+  platform?: NodeJS.Platform;
+  spawn?: typeof spawn;
+  warn?: (message: string) => void;
+}
+/**
+ * Runs advisory hook commands through bash and reports what each one decided.
+ *
+ * A hook is a command the repository owns, so it is spawned in its own process
+ * 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;
+//#endregion
+export { BashHookRunnerOptions, createBashHookRunner };
+//# sourceMappingURL=hookRunner.d.mts.map

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

@@ -0,0 +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"}

package/dist/adapters/hookRunner.mjs

@@ -0,0 +1,2 @@
+import{HOOK_TELEMETRY_EVENT as e}from"../types/telemetry.mjs";import{spawn as t}from"node:child_process";const n=`ESRCH`,r=/\r?\n/;function i(e){return e instanceof Error&&`code`in e?String(e.code):void 0}function a(a={}){let o=a.spawn??t,s=a.telemetry,c=a.warn??(e=>void process.stderr.write(e)),l=(a.platform??process.platform)!==`win32`,u=(e,t)=>r=>{try{if(l&&e!==void 0){process.kill(-e,r);return}t(r)}catch(e){i(e)!==n&&process.emitWarning(`Could not signal repository hook process: ${String(e)}`)}};return{run(t,d,f){let p=t.timeout??10,m=a.env??process.env;return new Promise(a=>{let h=o(`/bin/bash`,[`-c`,t.command],{cwd:f.repoRoot,env:{...m,CLAUDE_PROJECT_DIR:f.repoRoot,CODEX_REPO_ROOT:f.repoRoot,ORIGINAL_REPO_PATH:m.ORIGINAL_REPO_PATH??f.repoRoot,...f.pluginRoot?{CLAUDE_PLUGIN_ROOT:f.pluginRoot}:{}},stdio:[`pipe`,`pipe`,`pipe`],detached:l}),g=``,_=``,v=!1,y=!1,b=!1,x=null,S,C=u(h.pid,e=>h.kill(e)),w=()=>{if(!l||h.pid===void 0)return!b;try{return process.kill(-h.pid,0),!0}catch(e){return i(e)!==n}},T=(e={})=>{v||(v=!0,clearTimeout(D),S&&clearTimeout(S),a(e))},E=()=>{let n=`Hook timed out after ${p} seconds.`;s?.recordWarning(e.hookFailed,n,{"hook.reason":`timeout`,"hook.exit_code":x??-1}),c(`[pi-hook] advisory hook timed out: ${t.command}\n${_}`),T({failure:{command:t.command,message:n,reason:`timeout`}})},D=setTimeout(()=>{y=!0,C(`SIGTERM`),S=setTimeout(()=>{w()&&C(`SIGKILL`),E()},2e3)},p*1e3);h.stdout?.on(`data`,e=>{g+=e.toString()}),h.stderr?.on(`data`,e=>{_+=e.toString()}),h.once(`error`,n=>{y||(s?.recordError(e.hookFailed,n,{"hook.reason":`spawn_failed`}),c(`[pi-hook] advisory hook failed: ${n.message}\n`),T({failure:{command:t.command,message:n.message,reason:`spawn_failed`}}))}),h.once(`exit`,n=>{if(b=!0,x=n,y)return;if(n!==0){let r=_.trim()||`Advisory hook exited with code ${n??`unknown`}`;s?.recordWarning(e.hookFailed,r,{"hook.reason":`non_zero_exit`,"hook.exit_code":n??-1}),c(`[pi-hook] advisory hook failed (${n}): ${t.command}\n${_}`),T({failure:{command:t.command,message:r,reason:`non_zero_exit`}});return}let i=g.trim().split(r).reverse().find(e=>e.startsWith(`{`));if(!i){T();return}try{T({decision:JSON.parse(i)})}catch(n){s?.recordWarning(e.hookFailed,n,{"hook.reason":`invalid_json`}),c(`[pi-hook] advisory hook returned invalid JSON: ${t.command}\n`),T({failure:{command:t.command,message:n instanceof Error?n.message:String(n),reason:`invalid_json`}})}}),h.stdin?.end(JSON.stringify(d))})}}}export{a as createBashHookRunner};
+//# sourceMappingURL=hookRunner.mjs.map

package/dist/adapters/hookRunner.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"hookRunner.mjs","names":["spawn","spawnProcess"],"sources":["../../src/adapters/hookRunner.ts"],"sourcesContent":["import { spawn as spawnProcess } from 'node:child_process';\nimport type {\n  HookCommand,\n  HookDecision,\n  HookOutcome,\n  HookPayload,\n  HookRunOptions,\n  HookRunner,\n} from '../types/hooks.ts';\nimport { HOOK_TELEMETRY_EVENT, type HookTelemetry } from '../types/telemetry.ts';\n\nconst HOOK_SHELL = '/bin/bash';\nconst HOOK_SHELL_COMMAND_FLAG = '-c';\nconst HOOK_TERMINATION_GRACE_MS = 2_000;\nconst DEFAULT_HOOK_TIMEOUT_SECONDS = 10;\nconst MILLISECONDS_PER_SECOND = 1_000;\nconst PROCESS_NOT_FOUND_ERROR = 'ESRCH';\nconst WINDOWS_PLATFORM = 'win32';\nconst UNKNOWN_EXIT_CODE = -1;\nconst JSON_LINE_START = '{';\nconst LINE_BREAK = /\\r?\\n/;\n\nexport interface BashHookRunnerOptions {\n  telemetry?: HookTelemetry;\n  env?: NodeJS.ProcessEnv;\n  platform?: NodeJS.Platform;\n  spawn?: typeof spawnProcess;\n  warn?: (message: string) => void;\n}\n\nfunction errorCode(error: unknown): string | undefined {\n  return error instanceof Error && 'code' in error ? String(error.code) : undefined;\n}\n\n/**\n * Runs advisory hook commands through bash and reports what each one decided.\n *\n * A hook is a command the repository owns, so it is spawned in its own process\n * group and terminated as one: a hook that starts a server and stalls should\n * not leave the server behind when the timeout fires.\n */\nexport function createBashHookRunner(options: BashHookRunnerOptions = {}): HookRunner {\n  const spawn = options.spawn ?? spawnProcess;\n  const telemetry = options.telemetry;\n  const warn = options.warn ?? ((message: string) => void process.stderr.write(message));\n  const useProcessGroup = (options.platform ?? process.platform) !== WINDOWS_PLATFORM;\n\n  const signalOwnedProcess = (\n    pid: number | undefined,\n    kill: (signal: NodeJS.Signals) => void,\n  ): ((signal: NodeJS.Signals) => void) => {\n    return (signal) => {\n      try {\n        if (useProcessGroup && pid !== undefined) {\n          process.kill(-pid, signal);\n          return;\n        }\n        kill(signal);\n      } catch (error) {\n        if (errorCode(error) !== PROCESS_NOT_FOUND_ERROR) {\n          process.emitWarning(`Could not signal repository hook process: ${String(error)}`);\n        }\n      }\n    };\n  };\n\n  return {\n    run(hook: HookCommand, payload: HookPayload, runOptions: HookRunOptions): Promise<HookOutcome> {\n      const timeoutSeconds = hook.timeout ?? DEFAULT_HOOK_TIMEOUT_SECONDS;\n      const environment = options.env ?? process.env;\n      return new Promise((resolve) => {\n        // -c, not -lc. Hooks run on every tool call, and a login shell would\n        // source the developer's profile each time: per-call latency plus hook\n        // behavior that varies with their dotfiles. The child inherits the\n        // environment below, so it keeps the PATH the launcher started with.\n        const child = spawn(HOOK_SHELL, [HOOK_SHELL_COMMAND_FLAG, hook.command], {\n          cwd: runOptions.repoRoot,\n          env: {\n            ...environment,\n            CLAUDE_PROJECT_DIR: runOptions.repoRoot,\n            CODEX_REPO_ROOT: runOptions.repoRoot,\n            ORIGINAL_REPO_PATH: environment.ORIGINAL_REPO_PATH ?? runOptions.repoRoot,\n            ...(runOptions.pluginRoot ? { CLAUDE_PLUGIN_ROOT: runOptions.pluginRoot } : {}),\n          },\n          stdio: ['pipe', 'pipe', 'pipe'],\n          detached: useProcessGroup,\n        });\n        let stdout = '';\n        let stderr = '';\n        let settled = false;\n        let timedOut = false;\n        let childExited = false;\n        let timeoutExitCode: number | null = null;\n        let escalationTimer: NodeJS.Timeout | undefined;\n\n        const signal = signalOwnedProcess(child.pid, (value) => child.kill(value));\n\n        const ownedProcessIsAlive = (): boolean => {\n          if (!useProcessGroup || child.pid === undefined) return !childExited;\n          try {\n            process.kill(-child.pid, 0);\n            return true;\n          } catch (error) {\n            return errorCode(error) !== PROCESS_NOT_FOUND_ERROR;\n          }\n        };\n\n        const finish = (outcome: HookOutcome = {}): void => {\n          if (settled) return;\n          settled = true;\n          clearTimeout(timer);\n          if (escalationTimer) clearTimeout(escalationTimer);\n          resolve(outcome);\n        };\n\n        const finishTimeout = (): void => {\n          const message = `Hook timed out after ${timeoutSeconds} seconds.`;\n          void telemetry?.recordWarning(HOOK_TELEMETRY_EVENT.hookFailed, message, {\n            'hook.reason': 'timeout',\n            'hook.exit_code': timeoutExitCode ?? UNKNOWN_EXIT_CODE,\n          });\n          warn(`[pi-hook] advisory hook timed out: ${hook.command}\\n${stderr}`);\n          finish({ failure: { command: hook.command, message, reason: 'timeout' } });\n        };\n\n        const timer = setTimeout(() => {\n          timedOut = true;\n          signal('SIGTERM');\n          escalationTimer = setTimeout(() => {\n            if (ownedProcessIsAlive()) signal('SIGKILL');\n            finishTimeout();\n          }, HOOK_TERMINATION_GRACE_MS);\n        }, timeoutSeconds * MILLISECONDS_PER_SECOND);\n\n        child.stdout?.on('data', (chunk: Buffer) => {\n          stdout += chunk.toString();\n        });\n        child.stderr?.on('data', (chunk: Buffer) => {\n          stderr += chunk.toString();\n        });\n        child.once('error', (error: Error) => {\n          if (timedOut) return;\n          // A guardrail that never ran is indistinguishable from one that\n          // passed, which is the whole reason these are worth reporting.\n          void telemetry?.recordError(HOOK_TELEMETRY_EVENT.hookFailed, error, { 'hook.reason': 'spawn_failed' });\n          warn(`[pi-hook] advisory hook failed: ${error.message}\\n`);\n          finish({ failure: { command: hook.command, message: error.message, reason: 'spawn_failed' } });\n        });\n        child.once('exit', (code: number | null) => {\n          childExited = true;\n          timeoutExitCode = code;\n          if (timedOut) return;\n          if (code !== 0) {\n            const message = stderr.trim() || `Advisory hook exited with code ${code ?? 'unknown'}`;\n            void telemetry?.recordWarning(HOOK_TELEMETRY_EVENT.hookFailed, message, {\n              'hook.reason': 'non_zero_exit',\n              'hook.exit_code': code ?? UNKNOWN_EXIT_CODE,\n            });\n            warn(`[pi-hook] advisory hook failed (${code}): ${hook.command}\\n${stderr}`);\n            finish({ failure: { command: hook.command, message, reason: 'non_zero_exit' } });\n            return;\n          }\n          const jsonLine = stdout\n            .trim()\n            .split(LINE_BREAK)\n            .reverse()\n            .find((line) => line.startsWith(JSON_LINE_START));\n          if (!jsonLine) {\n            finish();\n            return;\n          }\n          try {\n            finish({ decision: JSON.parse(jsonLine) as HookDecision });\n          } catch (error) {\n            // The hook ran and had an opinion, and it was dropped.\n            void telemetry?.recordWarning(HOOK_TELEMETRY_EVENT.hookFailed, error, { 'hook.reason': 'invalid_json' });\n            warn(`[pi-hook] advisory hook returned invalid JSON: ${hook.command}\\n`);\n            finish({\n              failure: {\n                command: hook.command,\n                message: error instanceof Error ? error.message : String(error),\n                reason: 'invalid_json',\n              },\n            });\n          }\n        });\n        child.stdin?.end(JSON.stringify(payload));\n      });\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/adapters/pi/extension.cjs

@@ -0,0 +1,2 @@
+const e=require("../hookDocuments.cjs"),t=require("../hookRunner.cjs"),n=require("../telemetry/logSinkTelemetry.cjs"),r=require("./hookHandlers.cjs");let i=require("@deepseek-ai/cordis");function a(r){let i=r.telemetry,a=()=>i??=n.createHookTelemetry();return{runner:r.runner??t.createBashHookRunner({telemetry:a()}),documents:r.documents??e.createHookDocumentReader({telemetry:a()})}}async function o(e,t={}){let n=a(t),o=new i.Context,s,c=()=>(s??=o.fiber.dispose(),s);try{o.effect(function*(){for(let t of r.registerHookHandlers(e,n))yield t},`@agimon-ai/doompi-hook`)}catch(e){throw await c(),e}e.on(`session_shutdown`,async(e,t)=>{if(s)return s;try{await r.runSessionEndHooks(n,t)}finally{await c()}})}exports.default=o,exports.hookExtension=o;
+//# sourceMappingURL=extension.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extension.cjs","names":["createHookTelemetry","createBashHookRunner","createHookDocumentReader","Context","registerHookHandlers","runSessionEndHooks"],"sources":["../../../src/adapters/pi/extension.ts"],"sourcesContent":["import { Context } from '@deepseek-ai/cordis';\nimport type { ExtensionAPI } 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 { type HookSession, registerHookHandlers, runSessionEndHooks } from './hookHandlers.ts';\n\nconst PACKAGE_SOURCE = '@agimon-ai/doompi-hook';\nconst SESSION_SHUTDOWN_EVENT = 'session_shutdown';\n\nexport interface HookExtensionOptions {\n  telemetry?: HookTelemetry;\n  runner?: HookRunner;\n  documents?: HookDocumentReader;\n}\n\nfunction hookSession(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    runner: options.runner ?? createBashHookRunner({ telemetry: requireTelemetry() }),\n    documents: options.documents ?? createHookDocumentReader({ telemetry: requireTelemetry() }),\n  };\n}\n\n/**\n * The package's single standard Pi factory, and the owner of the cordis Context.\n *\n * Pi can reload an extension in-process, so every registration is yielded to the\n * fiber and one dispose on session shutdown unwinds them in reverse. Shutdown\n * runs the plugin SessionEnd hooks first: they need the session that dispose\n * ends.\n */\nexport async function hookExtension(pi: ExtensionAPI, options: HookExtensionOptions = {}): Promise<void> {\n  const session = hookSession(options);\n  const cordis = new Context();\n  let disposal: Promise<void> | undefined;\n  const dispose = (): Promise<void> => {\n    disposal ??= cordis.fiber.dispose();\n    return disposal;\n  };\n\n  try {\n    cordis.effect(function* () {\n      for (const disposeRegistration of registerHookHandlers(pi, session)) yield disposeRegistration;\n    }, PACKAGE_SOURCE);\n  } catch (error) {\n    await dispose();\n    throw error;\n  }\n\n  pi.on(SESSION_SHUTDOWN_EVENT, async (_event, ctx) => {\n    // Pi can fire session_shutdown more than once across a reload, and the\n    // SessionEnd hooks are side effects that must not run twice.\n    if (disposal) return disposal;\n    try {\n      await runSessionEndHooks(session, ctx);\n    } finally {\n      await dispose();\n    }\n  });\n}\n\nexport default hookExtension;\n"],"mappings":"2LAkBA,SAAS,EAAY,EAA4C,CAG/D,IAAI,EAAY,EAAQ,UAClB,MAAyC,IAAcA,EAAAA,oBAAoB,EACjF,MAAO,CACL,OAAQ,EAAQ,QAAUC,EAAAA,qBAAqB,CAAE,UAAW,EAAiB,CAAE,CAAC,EAChF,UAAW,EAAQ,WAAaC,EAAAA,yBAAyB,CAAE,UAAW,EAAiB,CAAE,CAAC,CAC5F,CACF,CAUA,eAAsB,EAAc,EAAkB,EAAgC,CAAC,EAAkB,CACvG,IAAM,EAAU,EAAY,CAAO,EAC7B,EAAS,IAAIC,EAAAA,QACf,EACE,OACJ,IAAa,EAAO,MAAM,QAAQ,EAC3B,GAGT,GAAI,CACF,EAAO,OAAO,WAAa,CACzB,IAAK,IAAM,KAAuBC,EAAAA,qBAAqB,EAAI,CAAO,EAAG,MAAM,CAC7E,EAAG,wBAAc,CACnB,OAAS,EAAO,CAEd,MADA,MAAM,EAAQ,EACR,CACR,CAEA,EAAG,GAAG,mBAAwB,MAAO,EAAQ,IAAQ,CAGnD,GAAI,EAAU,OAAO,EACrB,GAAI,CACF,MAAMC,EAAAA,mBAAmB,EAAS,CAAG,CACvC,QAAU,CACR,MAAM,EAAQ,CAChB,CACF,CAAC,CACH"}

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

@@ -0,0 +1,21 @@
+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 {
+  telemetry?: HookTelemetry;
+  runner?: HookRunner;
+  documents?: HookDocumentReader;
+}
+/**
+ * The package's single standard Pi factory, and the owner of the cordis Context.
+ *
+ * Pi can reload an extension in-process, so every registration is yielded to the
+ * fiber and one dispose on session shutdown unwinds them in reverse. Shutdown
+ * runs the plugin SessionEnd hooks first: they need the session that dispose
+ * ends.
+ */
+declare function hookExtension(pi: ExtensionAPI, options?: HookExtensionOptions): Promise<void>;
+//#endregion
+export { HookExtensionOptions, hookExtension as default, hookExtension };
+//# sourceMappingURL=extension.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extension.d.cts","names":[],"sources":["../../../src/adapters/pi/extension.ts"],"mappings":";;;;UAYiB;EACf,YAAY;EACZ,SAAS;EACT,YAAY;;;;;;;;;;iBAsBQ,cAAc,IAAI,cAAc,UAAS,uBAA4B"}

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

@@ -0,0 +1,21 @@
+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 {
+  telemetry?: HookTelemetry;
+  runner?: HookRunner;
+  documents?: HookDocumentReader;
+}
+/**
+ * The package's single standard Pi factory, and the owner of the cordis Context.
+ *
+ * Pi can reload an extension in-process, so every registration is yielded to the
+ * fiber and one dispose on session shutdown unwinds them in reverse. Shutdown
+ * runs the plugin SessionEnd hooks first: they need the session that dispose
+ * ends.
+ */
+declare function hookExtension(pi: ExtensionAPI, options?: HookExtensionOptions): Promise<void>;
+//#endregion
+export { HookExtensionOptions, hookExtension as default, hookExtension };
+//# sourceMappingURL=extension.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extension.d.mts","names":[],"sources":["../../../src/adapters/pi/extension.ts"],"mappings":";;;;UAYiB;EACf,YAAY;EACZ,SAAS;EACT,YAAY;;;;;;;;;;iBAsBQ,cAAc,IAAI,cAAc,UAAS,uBAA4B"}

package/dist/adapters/pi/extension.mjs

@@ -0,0 +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{Context as a}from"@deepseek-ai/cordis";function o(r){let i=r.telemetry,a=()=>i??=n();return{runner:r.runner??t({telemetry:a()}),documents:r.documents??e({telemetry:a()})}}async function s(e,t={}){let n=o(t),s=new a,c,l=()=>(c??=s.fiber.dispose(),c);try{s.effect(function*(){for(let t of r(e,n))yield t},`@agimon-ai/doompi-hook`)}catch(e){throw await l(),e}e.on(`session_shutdown`,async(e,t)=>{if(c)return c;try{await i(n,t)}finally{await l()}})}export{s as default,s as hookExtension};
+//# sourceMappingURL=extension.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extension.mjs","names":[],"sources":["../../../src/adapters/pi/extension.ts"],"sourcesContent":["import { Context } from '@deepseek-ai/cordis';\nimport type { ExtensionAPI } 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 { type HookSession, registerHookHandlers, runSessionEndHooks } from './hookHandlers.ts';\n\nconst PACKAGE_SOURCE = '@agimon-ai/doompi-hook';\nconst SESSION_SHUTDOWN_EVENT = 'session_shutdown';\n\nexport interface HookExtensionOptions {\n  telemetry?: HookTelemetry;\n  runner?: HookRunner;\n  documents?: HookDocumentReader;\n}\n\nfunction hookSession(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    runner: options.runner ?? createBashHookRunner({ telemetry: requireTelemetry() }),\n    documents: options.documents ?? createHookDocumentReader({ telemetry: requireTelemetry() }),\n  };\n}\n\n/**\n * The package's single standard Pi factory, and the owner of the cordis Context.\n *\n * Pi can reload an extension in-process, so every registration is yielded to the\n * fiber and one dispose on session shutdown unwinds them in reverse. Shutdown\n * runs the plugin SessionEnd hooks first: they need the session that dispose\n * ends.\n */\nexport async function hookExtension(pi: ExtensionAPI, options: HookExtensionOptions = {}): Promise<void> {\n  const session = hookSession(options);\n  const cordis = new Context();\n  let disposal: Promise<void> | undefined;\n  const dispose = (): Promise<void> => {\n    disposal ??= cordis.fiber.dispose();\n    return disposal;\n  };\n\n  try {\n    cordis.effect(function* () {\n      for (const disposeRegistration of registerHookHandlers(pi, session)) yield disposeRegistration;\n    }, PACKAGE_SOURCE);\n  } catch (error) {\n    await dispose();\n    throw error;\n  }\n\n  pi.on(SESSION_SHUTDOWN_EVENT, async (_event, ctx) => {\n    // Pi can fire session_shutdown more than once across a reload, and the\n    // SessionEnd hooks are side effects that must not run twice.\n    if (disposal) return disposal;\n    try {\n      await runSessionEndHooks(session, ctx);\n    } finally {\n      await dispose();\n    }\n  });\n}\n\nexport default hookExtension;\n"],"mappings":"iUAkBA,SAAS,EAAY,EAA4C,CAG/D,IAAI,EAAY,EAAQ,UAClB,MAAyC,IAAc,EAAoB,EACjF,MAAO,CACL,OAAQ,EAAQ,QAAU,EAAqB,CAAE,UAAW,EAAiB,CAAE,CAAC,EAChF,UAAW,EAAQ,WAAa,EAAyB,CAAE,UAAW,EAAiB,CAAE,CAAC,CAC5F,CACF,CAUA,eAAsB,EAAc,EAAkB,EAAgC,CAAC,EAAkB,CACvG,IAAM,EAAU,EAAY,CAAO,EAC7B,EAAS,IAAI,EACf,EACE,OACJ,IAAa,EAAO,MAAM,QAAQ,EAC3B,GAGT,GAAI,CACF,EAAO,OAAO,WAAa,CACzB,IAAK,IAAM,KAAuB,EAAqB,EAAI,CAAO,EAAG,MAAM,CAC7E,EAAG,wBAAc,CACnB,OAAS,EAAO,CAEd,MADA,MAAM,EAAQ,EACR,CACR,CAEA,EAAG,GAAG,mBAAwB,MAAO,EAAQ,IAAQ,CAGnD,GAAI,EAAU,OAAO,EACrB,GAAI,CACF,MAAM,EAAmB,EAAS,CAAG,CACvC,QAAU,CACR,MAAM,EAAQ,CAChB,CACF,CAAC,CACH"}

package/dist/adapters/pi/hookHandlers.cjs

@@ -0,0 +1,8 @@
+const e=require("../../services/hookRegistry.cjs"),t=require("../../services/hookDecisions.cjs"),n=require("../../services/hookPayload.cjs"),r=require("../../services/pluginHooks.cjs"),i=require("../../types/hooks.cjs");let a=require("@agimon-ai/doompi-config/piContext");const o=`repository-hooks`,s={deliverAs:`steer`};async function c(t,n,i,o){let s=(0,a.requireDoomConfigContext)(n).harness,c=s.root??n.cwd,[l,u]=await Promise.all([t.documents.registry(c),t.documents.plugins(s.pluginHooks)]),d=[...e.selectRegistryHooks(l.entries,{event:i,toolName:o,allowedGroups:s.hookGroups,inSubagent:!!process.env.PI_SUBAGENT_CHILD}),...r.selectPluginHooks(u.documents,i,o)];return{repoRoot:c,sessionId:n.sessionManager.getSessionId(),hooks:d,failures:[...l.failure?[l.failure]:[],...u.failures]}}async function l(e,t,n){let i=(0,a.requireDoomConfigContext)(t).harness,o=await e.documents.plugins(i.pluginHooks);return{repoRoot:i.root??t.cwd,sessionId:t.sessionManager.getSessionId(),hooks:r.selectPluginHooks(o.documents,n),failures:o.failures}}async function u(e,t,n,r,i,a){let o=[];try{for(let[s,c]of n.hooks.entries())t.hasUI&&t.ui.setStatus(i,`${a} (${s+1}/${n.hooks.length})...`),o.push(await e.runner.run(c.hook,r,{repoRoot:n.repoRoot,pluginRoot:c.root}))}finally{t.hasUI&&t.ui.setStatus(i,void 0)}return o}function d(e,n){return[...e.failures,...t.failuresFrom(n)]}function f(e,n){n.length!==0&&e.sendMessage({customType:`repository-hook-failure`,content:t.hookFailureMessage(n),display:!0},s)}function p(e,r){e.on(`session_start`,async(a,l)=>{let p=await c(r,l,i.HOOK_EVENT.sessionStart),m=await u(r,l,p,n.sessionHookPayload(p.sessionId,p.repoRoot),`${o}:${p.sessionId}:start`,`Running session-start hooks`);f(e,d(p,m));let h=t.additionalContextsFrom(t.decisionsFrom(m)).join(`
+
+`);h&&e.sendMessage({customType:`repository-hook-context`,content:h,display:!0},s)})}function m(e,r){e.on(`tool_call`,async(a,s)=>{let l=await c(r,s,i.HOOK_EVENT.preToolUse,a.toolName),p=await u(r,s,l,n.toolHookPayload(a,i.HOOK_EVENT.preToolUse,l.repoRoot,l.sessionId),`${o}:${a.toolCallId}:pre`,`Running pre-tool hooks for ${a.toolName}`),m=t.decisionsFrom(p);f(e,d(l,p));let h=m.find(t.isDenied);if(h)return{block:!0,reason:t.decisionReason(h)??`Blocked by repository hook`};let g=t.additionalContextsFrom(m).join(`
+
+`);return g?{block:!0,reason:g}:void 0})}function h(e,r){e.on(`tool_result`,async(e,a)=>{let s=await c(r,a,i.HOOK_EVENT.postToolUse,e.toolName),l=await u(r,a,s,n.toolHookPayload(e,i.HOOK_EVENT.postToolUse,s.repoRoot,s.sessionId),`${o}:${e.toolCallId}:post`,`Running post-tool hooks for ${e.toolName}`),f=t.decisionsFrom(l),p=d(s,l),m=t.toolResultMessages(f);if(p.length>0&&m.push(t.hookFailureMessage(p)),m.length!==0)return{content:[...e.content,{type:`text`,text:m.join(`
+
+`)}],isError:e.isError||f.some(t.isDenied)}})}function g(e,t){e.on(`agent_settled`,async(e,r)=>{let a=await c(t,r,i.HOOK_EVENT.stop);await u(t,r,a,n.sessionHookPayload(a.sessionId,a.repoRoot),`${o}:${a.sessionId}:stop`,`Running stop hooks`)})}function _(e,t){return[p,m,h,g].map(n=>(n(e,t),()=>void 0))}async function v(e,t){let r=await l(e,t,i.HOOK_EVENT.sessionEnd);await u(e,t,r,n.sessionHookPayload(r.sessionId,r.repoRoot),`${o}:${r.sessionId}:end`,`Running session-end hooks`)}exports.registerHookHandlers=_,exports.runSessionEndHooks=v;
+//# sourceMappingURL=hookHandlers.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hookHandlers.cjs","names":["requireDoomConfigContext","selectRegistryHooks","selectPluginHooks","failuresFrom","hookFailureMessage","HOOK_EVENT","sessionHookPayload","additionalContextsFrom","decisionsFrom","toolHookPayload","isDenied","decisionReason","toolResultMessages"],"sources":["../../../src/adapters/pi/hookHandlers.ts"],"sourcesContent":["import { requireDoomConfigContext } from '@agimon-ai/doompi-config/piContext';\nimport type { ExtensionAPI, ExtensionContext } from '@earendil-works/pi-coding-agent';\nimport {\n  additionalContextsFrom,\n  decisionReason,\n  decisionsFrom,\n  failuresFrom,\n  hookFailureMessage,\n  isDenied,\n  toolResultMessages,\n} from '../../services/hookDecisions.ts';\nimport { sessionHookPayload, toolHookPayload } from '../../services/hookPayload.ts';\nimport { selectRegistryHooks } from '../../services/hookRegistry.ts';\nimport { selectPluginHooks } from '../../services/pluginHooks.ts';\nimport {\n  HOOK_EVENT,\n  type HookDocumentReader,\n  type HookFailure,\n  type HookOutcome,\n  type HookPayload,\n  type HookRunner,\n  type HookToolEvent,\n  type ResolvedHook,\n} from '../../types/hooks.ts';\n\nconst STATUS_PREFIX = 'repository-hooks';\nconst FAILURE_MESSAGE_TYPE = 'repository-hook-failure';\nconst CONTEXT_MESSAGE_TYPE = 'repository-hook-context';\nconst STEER = { deliverAs: 'steer' } as const;\nconst BLOCKED_BY_HOOK = 'Blocked by repository hook';\nconst SUBAGENT_ENVIRONMENT_FLAG = 'PI_SUBAGENT_CHILD';\nconst CONTEXT_SEPARATOR = '\\n\\n';\n\n/** The two collaborators a dispatch needs, both replaceable in tests. */\nexport interface HookSession {\n  runner: HookRunner;\n  documents: HookDocumentReader;\n}\n\n/** Everything one dispatch resolved before it ran anything. */\ninterface HookDispatch {\n  repoRoot: string;\n  sessionId: string;\n  hooks: ResolvedHook[];\n  failures: HookFailure[];\n}\n\n/**\n * Registry rows plus plugin hooks for one event, in that order.\n *\n * Both sources are read on every dispatch because either can change mid-session:\n * /mode switches the selected groups and a plugin can rewrite its own config.\n */\nasync function resolveHooks(\n  session: HookSession,\n  ctx: ExtensionContext,\n  eventName: string,\n  toolName?: string,\n): Promise<HookDispatch> {\n  const harness = requireDoomConfigContext(ctx).harness;\n  const repoRoot = harness.root ?? ctx.cwd;\n  const [registry, plugins] = await Promise.all([\n    session.documents.registry(repoRoot),\n    session.documents.plugins(harness.pluginHooks),\n  ]);\n  const hooks = [\n    ...selectRegistryHooks(registry.entries, {\n      event: eventName,\n      toolName,\n      allowedGroups: harness.hookGroups,\n      inSubagent: Boolean(process.env[SUBAGENT_ENVIRONMENT_FLAG]),\n    }),\n    ...selectPluginHooks(plugins.documents, eventName, toolName),\n  ];\n  return {\n    repoRoot,\n    sessionId: ctx.sessionManager.getSessionId(),\n    hooks,\n    failures: [...(registry.failure ? [registry.failure] : []), ...plugins.failures],\n  };\n}\n\n/** Session end is plugin-only: the registry has no binding for it. */\nasync function resolvePluginHooks(\n  session: HookSession,\n  ctx: ExtensionContext,\n  eventName: string,\n): Promise<HookDispatch> {\n  const harness = requireDoomConfigContext(ctx).harness;\n  const plugins = await session.documents.plugins(harness.pluginHooks);\n  return {\n    repoRoot: harness.root ?? ctx.cwd,\n    sessionId: ctx.sessionManager.getSessionId(),\n    hooks: selectPluginHooks(plugins.documents, eventName),\n    failures: plugins.failures,\n  };\n}\n\nasync function runHooks(\n  session: HookSession,\n  ctx: ExtensionContext,\n  dispatch: HookDispatch,\n  payload: HookPayload,\n  statusKey: string,\n  statusLabel: string,\n): Promise<HookOutcome[]> {\n  const outcomes: HookOutcome[] = [];\n  try {\n    for (const [index, resolved] of dispatch.hooks.entries()) {\n      if (ctx.hasUI) ctx.ui.setStatus(statusKey, `${statusLabel} (${index + 1}/${dispatch.hooks.length})...`);\n      outcomes.push(\n        await session.runner.run(resolved.hook, payload, { repoRoot: dispatch.repoRoot, pluginRoot: resolved.root }),\n      );\n    }\n  } finally {\n    if (ctx.hasUI) ctx.ui.setStatus(statusKey, undefined);\n  }\n  return outcomes;\n}\n\nfunction allFailures(dispatch: HookDispatch, outcomes: ReadonlyArray<HookOutcome>): HookFailure[] {\n  return [...dispatch.failures, ...failuresFrom(outcomes)];\n}\n\nfunction steerHookFailures(pi: ExtensionAPI, failures: ReadonlyArray<HookFailure>): void {\n  if (failures.length === 0) return;\n  pi.sendMessage({ customType: FAILURE_MESSAGE_TYPE, content: hookFailureMessage(failures), display: true }, STEER);\n}\n\nfunction registerSessionStart(pi: ExtensionAPI, session: HookSession): void {\n  pi.on('session_start', async (_event, ctx) => {\n    const dispatch = await resolveHooks(session, ctx, HOOK_EVENT.sessionStart);\n    const outcomes = await runHooks(\n      session,\n      ctx,\n      dispatch,\n      sessionHookPayload(dispatch.sessionId, dispatch.repoRoot),\n      `${STATUS_PREFIX}:${dispatch.sessionId}:start`,\n      'Running session-start hooks',\n    );\n    steerHookFailures(pi, allFailures(dispatch, outcomes));\n    const context = additionalContextsFrom(decisionsFrom(outcomes)).join(CONTEXT_SEPARATOR);\n    if (context) pi.sendMessage({ customType: CONTEXT_MESSAGE_TYPE, content: context, display: true }, STEER);\n  });\n}\n\nfunction registerToolCall(pi: ExtensionAPI, session: HookSession): void {\n  pi.on('tool_call', async (event, ctx) => {\n    const dispatch = await resolveHooks(session, ctx, HOOK_EVENT.preToolUse, event.toolName);\n    const payload = toolHookPayload(\n      event as HookToolEvent,\n      HOOK_EVENT.preToolUse,\n      dispatch.repoRoot,\n      dispatch.sessionId,\n    );\n    const outcomes = await runHooks(\n      session,\n      ctx,\n      dispatch,\n      payload,\n      `${STATUS_PREFIX}:${event.toolCallId}:pre`,\n      `Running pre-tool hooks for ${event.toolName}`,\n    );\n    const decisions = decisionsFrom(outcomes);\n    steerHookFailures(pi, allFailures(dispatch, outcomes));\n    const denied = decisions.find(isDenied);\n    if (denied) return { block: true, reason: decisionReason(denied) ?? BLOCKED_BY_HOOK };\n    const context = additionalContextsFrom(decisions).join(CONTEXT_SEPARATOR);\n    return context ? { block: true, reason: context } : undefined;\n  });\n}\n\nfunction registerToolResult(pi: ExtensionAPI, session: HookSession): void {\n  pi.on('tool_result', async (event, ctx) => {\n    const dispatch = await resolveHooks(session, ctx, HOOK_EVENT.postToolUse, event.toolName);\n    const payload = toolHookPayload(\n      event as HookToolEvent,\n      HOOK_EVENT.postToolUse,\n      dispatch.repoRoot,\n      dispatch.sessionId,\n    );\n    const outcomes = await runHooks(\n      session,\n      ctx,\n      dispatch,\n      payload,\n      `${STATUS_PREFIX}:${event.toolCallId}:post`,\n      `Running post-tool hooks for ${event.toolName}`,\n    );\n    const decisions = decisionsFrom(outcomes);\n    const failures = allFailures(dispatch, outcomes);\n    const messages = toolResultMessages(decisions);\n    if (failures.length > 0) messages.push(hookFailureMessage(failures));\n    if (messages.length === 0) return undefined;\n    // The result is appended to rather than replaced, so the tool's own output\n    // still reaches the model alongside whatever the hook had to say.\n    return {\n      content: [...event.content, { type: 'text' as const, text: messages.join(CONTEXT_SEPARATOR) }],\n      isError: event.isError || decisions.some(isDenied),\n    };\n  });\n}\n\nfunction registerAgentSettled(pi: ExtensionAPI, session: HookSession): void {\n  pi.on('agent_settled', async (_event, ctx) => {\n    const dispatch = await resolveHooks(session, ctx, HOOK_EVENT.stop);\n    // skipInSubagent on the workflow-stop binding keeps subagents from closing\n    // the parent's workflow step.\n    await runHooks(\n      session,\n      ctx,\n      dispatch,\n      sessionHookPayload(dispatch.sessionId, dispatch.repoRoot),\n      `${STATUS_PREFIX}:${dispatch.sessionId}:stop`,\n      'Running stop hooks',\n    );\n  });\n}\n\n/**\n * Registers the four in-session lifecycle events and returns one disposer each.\n *\n * Pi owns handler deregistration across a reload, so each disposer only has to\n * drop this package's own reference to the session.\n */\nexport function registerHookHandlers(pi: ExtensionAPI, session: HookSession): Array<() => void> {\n  return [registerSessionStart, registerToolCall, registerToolResult, registerAgentSettled].map((register) => {\n    register(pi, session);\n    return () => undefined;\n  });\n}\n\n/** Runs the plugin SessionEnd hooks while the session is still usable. */\nexport async function runSessionEndHooks(session: HookSession, ctx: ExtensionContext): Promise<void> {\n  const dispatch = await resolvePluginHooks(session, ctx, HOOK_EVENT.sessionEnd);\n  await runHooks(\n    session,\n    ctx,\n    dispatch,\n    sessionHookPayload(dispatch.sessionId, dispatch.repoRoot),\n    `${STATUS_PREFIX}:${dispatch.sessionId}:end`,\n    'Running session-end hooks',\n  );\n}\n"],"mappings":"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"}

package/dist/adapters/pi/hookHandlers.mjs

@@ -0,0 +1,8 @@
+import{selectRegistryHooks as e}from"../../services/hookRegistry.mjs";import{additionalContextsFrom as t,decisionReason as n,decisionsFrom as r,failuresFrom as i,hookFailureMessage as a,isDenied as o,toolResultMessages as s}from"../../services/hookDecisions.mjs";import{sessionHookPayload as c,toolHookPayload as l}from"../../services/hookPayload.mjs";import{selectPluginHooks as u}from"../../services/pluginHooks.mjs";import{HOOK_EVENT as d}from"../../types/hooks.mjs";import{requireDoomConfigContext as f}from"@agimon-ai/doompi-config/piContext";const p=`repository-hooks`,m={deliverAs:`steer`};async function h(t,n,r,i){let a=f(n).harness,o=a.root??n.cwd,[s,c]=await Promise.all([t.documents.registry(o),t.documents.plugins(a.pluginHooks)]),l=[...e(s.entries,{event:r,toolName:i,allowedGroups:a.hookGroups,inSubagent:!!process.env.PI_SUBAGENT_CHILD}),...u(c.documents,r,i)];return{repoRoot:o,sessionId:n.sessionManager.getSessionId(),hooks:l,failures:[...s.failure?[s.failure]:[],...c.failures]}}async function g(e,t,n){let r=f(t).harness,i=await e.documents.plugins(r.pluginHooks);return{repoRoot:r.root??t.cwd,sessionId:t.sessionManager.getSessionId(),hooks:u(i.documents,n),failures:i.failures}}async function _(e,t,n,r,i,a){let o=[];try{for(let[s,c]of n.hooks.entries())t.hasUI&&t.ui.setStatus(i,`${a} (${s+1}/${n.hooks.length})...`),o.push(await e.runner.run(c.hook,r,{repoRoot:n.repoRoot,pluginRoot:c.root}))}finally{t.hasUI&&t.ui.setStatus(i,void 0)}return o}function v(e,t){return[...e.failures,...i(t)]}function y(e,t){t.length!==0&&e.sendMessage({customType:`repository-hook-failure`,content:a(t),display:!0},m)}function b(e,n){e.on(`session_start`,async(i,a)=>{let o=await h(n,a,d.sessionStart),s=await _(n,a,o,c(o.sessionId,o.repoRoot),`${p}:${o.sessionId}:start`,`Running session-start hooks`);y(e,v(o,s));let l=t(r(s)).join(`
+
+`);l&&e.sendMessage({customType:`repository-hook-context`,content:l,display:!0},m)})}function x(e,i){e.on(`tool_call`,async(a,s)=>{let c=await h(i,s,d.preToolUse,a.toolName),u=await _(i,s,c,l(a,d.preToolUse,c.repoRoot,c.sessionId),`${p}:${a.toolCallId}:pre`,`Running pre-tool hooks for ${a.toolName}`),f=r(u);y(e,v(c,u));let m=f.find(o);if(m)return{block:!0,reason:n(m)??`Blocked by repository hook`};let g=t(f).join(`
+
+`);return g?{block:!0,reason:g}:void 0})}function S(e,t){e.on(`tool_result`,async(e,n)=>{let i=await h(t,n,d.postToolUse,e.toolName),c=await _(t,n,i,l(e,d.postToolUse,i.repoRoot,i.sessionId),`${p}:${e.toolCallId}:post`,`Running post-tool hooks for ${e.toolName}`),u=r(c),f=v(i,c),m=s(u);if(f.length>0&&m.push(a(f)),m.length!==0)return{content:[...e.content,{type:`text`,text:m.join(`
+
+`)}],isError:e.isError||u.some(o)}})}function C(e,t){e.on(`agent_settled`,async(e,n)=>{let r=await h(t,n,d.stop);await _(t,n,r,c(r.sessionId,r.repoRoot),`${p}:${r.sessionId}:stop`,`Running stop hooks`)})}function w(e,t){return[b,x,S,C].map(n=>(n(e,t),()=>void 0))}async function T(e,t){let n=await g(e,t,d.sessionEnd);await _(e,t,n,c(n.sessionId,n.repoRoot),`${p}:${n.sessionId}:end`,`Running session-end hooks`)}export{w as registerHookHandlers,T as runSessionEndHooks};
+//# sourceMappingURL=hookHandlers.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hookHandlers.mjs","names":[],"sources":["../../../src/adapters/pi/hookHandlers.ts"],"sourcesContent":["import { requireDoomConfigContext } from '@agimon-ai/doompi-config/piContext';\nimport type { ExtensionAPI, ExtensionContext } from '@earendil-works/pi-coding-agent';\nimport {\n  additionalContextsFrom,\n  decisionReason,\n  decisionsFrom,\n  failuresFrom,\n  hookFailureMessage,\n  isDenied,\n  toolResultMessages,\n} from '../../services/hookDecisions.ts';\nimport { sessionHookPayload, toolHookPayload } from '../../services/hookPayload.ts';\nimport { selectRegistryHooks } from '../../services/hookRegistry.ts';\nimport { selectPluginHooks } from '../../services/pluginHooks.ts';\nimport {\n  HOOK_EVENT,\n  type HookDocumentReader,\n  type HookFailure,\n  type HookOutcome,\n  type HookPayload,\n  type HookRunner,\n  type HookToolEvent,\n  type ResolvedHook,\n} from '../../types/hooks.ts';\n\nconst STATUS_PREFIX = 'repository-hooks';\nconst FAILURE_MESSAGE_TYPE = 'repository-hook-failure';\nconst CONTEXT_MESSAGE_TYPE = 'repository-hook-context';\nconst STEER = { deliverAs: 'steer' } as const;\nconst BLOCKED_BY_HOOK = 'Blocked by repository hook';\nconst SUBAGENT_ENVIRONMENT_FLAG = 'PI_SUBAGENT_CHILD';\nconst CONTEXT_SEPARATOR = '\\n\\n';\n\n/** The two collaborators a dispatch needs, both replaceable in tests. */\nexport interface HookSession {\n  runner: HookRunner;\n  documents: HookDocumentReader;\n}\n\n/** Everything one dispatch resolved before it ran anything. */\ninterface HookDispatch {\n  repoRoot: string;\n  sessionId: string;\n  hooks: ResolvedHook[];\n  failures: HookFailure[];\n}\n\n/**\n * Registry rows plus plugin hooks for one event, in that order.\n *\n * Both sources are read on every dispatch because either can change mid-session:\n * /mode switches the selected groups and a plugin can rewrite its own config.\n */\nasync function resolveHooks(\n  session: HookSession,\n  ctx: ExtensionContext,\n  eventName: string,\n  toolName?: string,\n): Promise<HookDispatch> {\n  const harness = requireDoomConfigContext(ctx).harness;\n  const repoRoot = harness.root ?? ctx.cwd;\n  const [registry, plugins] = await Promise.all([\n    session.documents.registry(repoRoot),\n    session.documents.plugins(harness.pluginHooks),\n  ]);\n  const hooks = [\n    ...selectRegistryHooks(registry.entries, {\n      event: eventName,\n      toolName,\n      allowedGroups: harness.hookGroups,\n      inSubagent: Boolean(process.env[SUBAGENT_ENVIRONMENT_FLAG]),\n    }),\n    ...selectPluginHooks(plugins.documents, eventName, toolName),\n  ];\n  return {\n    repoRoot,\n    sessionId: ctx.sessionManager.getSessionId(),\n    hooks,\n    failures: [...(registry.failure ? [registry.failure] : []), ...plugins.failures],\n  };\n}\n\n/** Session end is plugin-only: the registry has no binding for it. */\nasync function resolvePluginHooks(\n  session: HookSession,\n  ctx: ExtensionContext,\n  eventName: string,\n): Promise<HookDispatch> {\n  const harness = requireDoomConfigContext(ctx).harness;\n  const plugins = await session.documents.plugins(harness.pluginHooks);\n  return {\n    repoRoot: harness.root ?? ctx.cwd,\n    sessionId: ctx.sessionManager.getSessionId(),\n    hooks: selectPluginHooks(plugins.documents, eventName),\n    failures: plugins.failures,\n  };\n}\n\nasync function runHooks(\n  session: HookSession,\n  ctx: ExtensionContext,\n  dispatch: HookDispatch,\n  payload: HookPayload,\n  statusKey: string,\n  statusLabel: string,\n): Promise<HookOutcome[]> {\n  const outcomes: HookOutcome[] = [];\n  try {\n    for (const [index, resolved] of dispatch.hooks.entries()) {\n      if (ctx.hasUI) ctx.ui.setStatus(statusKey, `${statusLabel} (${index + 1}/${dispatch.hooks.length})...`);\n      outcomes.push(\n        await session.runner.run(resolved.hook, payload, { repoRoot: dispatch.repoRoot, pluginRoot: resolved.root }),\n      );\n    }\n  } finally {\n    if (ctx.hasUI) ctx.ui.setStatus(statusKey, undefined);\n  }\n  return outcomes;\n}\n\nfunction allFailures(dispatch: HookDispatch, outcomes: ReadonlyArray<HookOutcome>): HookFailure[] {\n  return [...dispatch.failures, ...failuresFrom(outcomes)];\n}\n\nfunction steerHookFailures(pi: ExtensionAPI, failures: ReadonlyArray<HookFailure>): void {\n  if (failures.length === 0) return;\n  pi.sendMessage({ customType: FAILURE_MESSAGE_TYPE, content: hookFailureMessage(failures), display: true }, STEER);\n}\n\nfunction registerSessionStart(pi: ExtensionAPI, session: HookSession): void {\n  pi.on('session_start', async (_event, ctx) => {\n    const dispatch = await resolveHooks(session, ctx, HOOK_EVENT.sessionStart);\n    const outcomes = await runHooks(\n      session,\n      ctx,\n      dispatch,\n      sessionHookPayload(dispatch.sessionId, dispatch.repoRoot),\n      `${STATUS_PREFIX}:${dispatch.sessionId}:start`,\n      'Running session-start hooks',\n    );\n    steerHookFailures(pi, allFailures(dispatch, outcomes));\n    const context = additionalContextsFrom(decisionsFrom(outcomes)).join(CONTEXT_SEPARATOR);\n    if (context) pi.sendMessage({ customType: CONTEXT_MESSAGE_TYPE, content: context, display: true }, STEER);\n  });\n}\n\nfunction registerToolCall(pi: ExtensionAPI, session: HookSession): void {\n  pi.on('tool_call', async (event, ctx) => {\n    const dispatch = await resolveHooks(session, ctx, HOOK_EVENT.preToolUse, event.toolName);\n    const payload = toolHookPayload(\n      event as HookToolEvent,\n      HOOK_EVENT.preToolUse,\n      dispatch.repoRoot,\n      dispatch.sessionId,\n    );\n    const outcomes = await runHooks(\n      session,\n      ctx,\n      dispatch,\n      payload,\n      `${STATUS_PREFIX}:${event.toolCallId}:pre`,\n      `Running pre-tool hooks for ${event.toolName}`,\n    );\n    const decisions = decisionsFrom(outcomes);\n    steerHookFailures(pi, allFailures(dispatch, outcomes));\n    const denied = decisions.find(isDenied);\n    if (denied) return { block: true, reason: decisionReason(denied) ?? BLOCKED_BY_HOOK };\n    const context = additionalContextsFrom(decisions).join(CONTEXT_SEPARATOR);\n    return context ? { block: true, reason: context } : undefined;\n  });\n}\n\nfunction registerToolResult(pi: ExtensionAPI, session: HookSession): void {\n  pi.on('tool_result', async (event, ctx) => {\n    const dispatch = await resolveHooks(session, ctx, HOOK_EVENT.postToolUse, event.toolName);\n    const payload = toolHookPayload(\n      event as HookToolEvent,\n      HOOK_EVENT.postToolUse,\n      dispatch.repoRoot,\n      dispatch.sessionId,\n    );\n    const outcomes = await runHooks(\n      session,\n      ctx,\n      dispatch,\n      payload,\n      `${STATUS_PREFIX}:${event.toolCallId}:post`,\n      `Running post-tool hooks for ${event.toolName}`,\n    );\n    const decisions = decisionsFrom(outcomes);\n    const failures = allFailures(dispatch, outcomes);\n    const messages = toolResultMessages(decisions);\n    if (failures.length > 0) messages.push(hookFailureMessage(failures));\n    if (messages.length === 0) return undefined;\n    // The result is appended to rather than replaced, so the tool's own output\n    // still reaches the model alongside whatever the hook had to say.\n    return {\n      content: [...event.content, { type: 'text' as const, text: messages.join(CONTEXT_SEPARATOR) }],\n      isError: event.isError || decisions.some(isDenied),\n    };\n  });\n}\n\nfunction registerAgentSettled(pi: ExtensionAPI, session: HookSession): void {\n  pi.on('agent_settled', async (_event, ctx) => {\n    const dispatch = await resolveHooks(session, ctx, HOOK_EVENT.stop);\n    // skipInSubagent on the workflow-stop binding keeps subagents from closing\n    // the parent's workflow step.\n    await runHooks(\n      session,\n      ctx,\n      dispatch,\n      sessionHookPayload(dispatch.sessionId, dispatch.repoRoot),\n      `${STATUS_PREFIX}:${dispatch.sessionId}:stop`,\n      'Running stop hooks',\n    );\n  });\n}\n\n/**\n * Registers the four in-session lifecycle events and returns one disposer each.\n *\n * Pi owns handler deregistration across a reload, so each disposer only has to\n * drop this package's own reference to the session.\n */\nexport function registerHookHandlers(pi: ExtensionAPI, session: HookSession): Array<() => void> {\n  return [registerSessionStart, registerToolCall, registerToolResult, registerAgentSettled].map((register) => {\n    register(pi, session);\n    return () => undefined;\n  });\n}\n\n/** Runs the plugin SessionEnd hooks while the session is still usable. */\nexport async function runSessionEndHooks(session: HookSession, ctx: ExtensionContext): Promise<void> {\n  const dispatch = await resolvePluginHooks(session, ctx, HOOK_EVENT.sessionEnd);\n  await runHooks(\n    session,\n    ctx,\n    dispatch,\n    sessionHookPayload(dispatch.sessionId, dispatch.repoRoot),\n    `${STATUS_PREFIX}:${dispatch.sessionId}:end`,\n    'Running session-end hooks',\n  );\n}\n"],"mappings":"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"}

package/dist/adapters/telemetry/logSinkTelemetry.cjs

@@ -0,0 +1,2 @@
+let e=require("@agimon-ai/doompi-telemetry");function t(t={}){let n=(0,e.createDoomTelemetry)({serviceName:`doom-pi-hook`,packageName:`@agimon-ai/doompi-hook`,cwd:t.cwd,workspaceRoot:t.workspaceRoot,env:t.env,telemetryFactory:t.telemetryFactory,warn:t.warn,enableLogs:!0,enableTraces:!0});return{recordError:(e,t,r)=>n.recordError(e,t,r),recordWarning:(e,t,r)=>n.recordWarning(e,t,r)}}exports.createHookTelemetry=t;
+//# sourceMappingURL=logSinkTelemetry.cjs.map

package/dist/adapters/telemetry/logSinkTelemetry.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"logSinkTelemetry.cjs","names":["createDoomTelemetry"],"sources":["../../../src/adapters/telemetry/logSinkTelemetry.ts"],"sourcesContent":["import { createDoomTelemetry, type DoomTelemetry, type DoomTelemetryOptions } from '@agimon-ai/doompi-telemetry';\nimport type { HookTelemetry } from '../../types/telemetry.ts';\n\nconst SERVICE_NAME = 'doom-pi-hook';\nconst PACKAGE_NAME = '@agimon-ai/doompi-hook';\n\nexport interface HookTelemetryOptions {\n  cwd?: string;\n  workspaceRoot?: string;\n  env?: NodeJS.ProcessEnv;\n  telemetryFactory?: NonNullable<DoomTelemetryOptions['telemetryFactory']>;\n  warn?: (message: string) => void;\n}\n\nexport function createHookTelemetry(options: HookTelemetryOptions = {}): HookTelemetry {\n  const telemetry: DoomTelemetry = createDoomTelemetry({\n    serviceName: SERVICE_NAME,\n    packageName: PACKAGE_NAME,\n    cwd: options.cwd,\n    workspaceRoot: options.workspaceRoot,\n    env: options.env,\n    telemetryFactory: options.telemetryFactory,\n    warn: options.warn,\n    enableLogs: true,\n    enableTraces: true,\n  });\n  return {\n    recordError: (event, error, attributes) => telemetry.recordError(event, error, attributes),\n    recordWarning: (event, error, attributes) => telemetry.recordWarning(event, error, attributes),\n  };\n}\n"],"mappings":"6CAcA,SAAgB,EAAoB,EAAgC,CAAC,EAAkB,CACrF,IAAM,GAAA,EAA2BA,EAAAA,oBAAAA,CAAoB,CACnD,YAAa,eACb,YAAa,yBACb,IAAK,EAAQ,IACb,cAAe,EAAQ,cACvB,IAAK,EAAQ,IACb,iBAAkB,EAAQ,iBAC1B,KAAM,EAAQ,KACd,WAAY,GACZ,aAAc,EAChB,CAAC,EACD,MAAO,CACL,aAAc,EAAO,EAAO,IAAe,EAAU,YAAY,EAAO,EAAO,CAAU,EACzF,eAAgB,EAAO,EAAO,IAAe,EAAU,cAAc,EAAO,EAAO,CAAU,CAC/F,CACF"}

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

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

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

@@ -0,0 +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"}

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

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

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

@@ -0,0 +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"}

package/dist/adapters/telemetry/logSinkTelemetry.mjs

@@ -0,0 +1,2 @@
+import{createDoomTelemetry as e}from"@agimon-ai/doompi-telemetry";function t(t={}){let n=e({serviceName:`doom-pi-hook`,packageName:`@agimon-ai/doompi-hook`,cwd:t.cwd,workspaceRoot:t.workspaceRoot,env:t.env,telemetryFactory:t.telemetryFactory,warn:t.warn,enableLogs:!0,enableTraces:!0});return{recordError:(e,t,r)=>n.recordError(e,t,r),recordWarning:(e,t,r)=>n.recordWarning(e,t,r)}}export{t as createHookTelemetry};
+//# sourceMappingURL=logSinkTelemetry.mjs.map

package/dist/adapters/telemetry/logSinkTelemetry.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"logSinkTelemetry.mjs","names":[],"sources":["../../../src/adapters/telemetry/logSinkTelemetry.ts"],"sourcesContent":["import { createDoomTelemetry, type DoomTelemetry, type DoomTelemetryOptions } from '@agimon-ai/doompi-telemetry';\nimport type { HookTelemetry } from '../../types/telemetry.ts';\n\nconst SERVICE_NAME = 'doom-pi-hook';\nconst PACKAGE_NAME = '@agimon-ai/doompi-hook';\n\nexport interface HookTelemetryOptions {\n  cwd?: string;\n  workspaceRoot?: string;\n  env?: NodeJS.ProcessEnv;\n  telemetryFactory?: NonNullable<DoomTelemetryOptions['telemetryFactory']>;\n  warn?: (message: string) => void;\n}\n\nexport function createHookTelemetry(options: HookTelemetryOptions = {}): HookTelemetry {\n  const telemetry: DoomTelemetry = createDoomTelemetry({\n    serviceName: SERVICE_NAME,\n    packageName: PACKAGE_NAME,\n    cwd: options.cwd,\n    workspaceRoot: options.workspaceRoot,\n    env: options.env,\n    telemetryFactory: options.telemetryFactory,\n    warn: options.warn,\n    enableLogs: true,\n    enableTraces: true,\n  });\n  return {\n    recordError: (event, error, attributes) => telemetry.recordError(event, error, attributes),\n    recordWarning: (event, error, attributes) => telemetry.recordWarning(event, error, attributes),\n  };\n}\n"],"mappings":"kEAcA,SAAgB,EAAoB,EAAgC,CAAC,EAAkB,CACrF,IAAM,EAA2B,EAAoB,CACnD,YAAa,eACb,YAAa,yBACb,IAAK,EAAQ,IACb,cAAe,EAAQ,cACvB,IAAK,EAAQ,IACb,iBAAkB,EAAQ,iBAC1B,KAAM,EAAQ,KACd,WAAY,GACZ,aAAc,EAChB,CAAC,EACD,MAAO,CACL,aAAc,EAAO,EAAO,IAAe,EAAU,YAAY,EAAO,EAAO,CAAU,EACzF,eAAgB,EAAO,EAAO,IAAe,EAAU,cAAc,EAAO,EAAO,CAAU,CAC/F,CACF"}

package/dist/extensions/pi.cjs

@@ -0,0 +1 @@
+Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:`Module`}});const e=require("../adapters/pi/extension.cjs");exports.default=e.default,exports.hookExtension=e.default;

package/dist/extensions/pi.d.cts

@@ -0,0 +1,2 @@
+import hookExtension, { HookExtensionOptions } from "../adapters/pi/extension.cjs";
+export { type HookExtensionOptions, hookExtension as default, hookExtension };