oh-my-codex-pennix 0.18.13

package/dist/hooks/codebase-map.js

@@ -0,0 +1,234 @@
+/**
+ * Codebase Map Generator for oh-my-codex
+ *
+ * Generates a lightweight snapshot of the project's source structure and
+ * key exported symbols, injected into agent context at session start.
+ *
+ * Goal: eliminate blind exploration by giving agents an upfront map of
+ * where things live — without reading full file contents.
+ *
+ * Design constraints:
+ * - Fast: uses `git ls-files` (no filesystem walk), regex export scan
+ * - Minimal: groups files by directory, no full source read
+ * - Safe: all errors return empty string (never blocks session start)
+ */
+import { statSync } from 'node:fs';
+import { mkdir, readFile, rename, rm, writeFile } from 'node:fs/promises';
+import { basename, extname, join } from 'node:path';
+import { execSync } from 'node:child_process';
+import { findGitLayout } from '../utils/git-layout.js';
+import { omxRoot } from '../utils/paths.js';
+/** Max chars for the whole map output. */
+const MAX_MAP_CHARS = 1000;
+/** Max files listed per directory entry. */
+const MAX_FILES_PER_DIR = 10;
+/** Max directories to include. */
+const MAX_DIRS = 14;
+/** Source extensions whose exports are worth scanning. */
+const SOURCE_EXTS = new Set(['.ts', '.tsx', '.js', '.mjs']);
+const CACHE_VERSION = 1;
+function cachePathForWorktree(worktreeRoot) {
+    return join(omxRoot(worktreeRoot), 'cache', 'codebase-map.json');
+}
+function readGitIndexSignature(gitDir) {
+    try {
+        const stat = statSync(join(gitDir, 'index'));
+        return { mtimeMs: stat.mtimeMs, size: stat.size };
+    }
+    catch {
+        return null;
+    }
+}
+async function readCachedCodebaseMap(worktreeRoot, gitDir, indexSignature) {
+    try {
+        const parsed = JSON.parse(await readFile(cachePathForWorktree(worktreeRoot), 'utf-8'));
+        if (parsed.version !== CACHE_VERSION)
+            return null;
+        if (parsed.worktreeRoot !== worktreeRoot)
+            return null;
+        if (parsed.gitDir !== gitDir)
+            return null;
+        if (parsed.indexMtimeMs !== indexSignature.mtimeMs)
+            return null;
+        if (parsed.indexSize !== indexSignature.size)
+            return null;
+        return typeof parsed.map === 'string' ? parsed.map : null;
+    }
+    catch {
+        return null;
+    }
+}
+async function writeCachedCodebaseMap(worktreeRoot, gitDir, indexSignature, map) {
+    const targetPath = cachePathForWorktree(worktreeRoot);
+    const tempPath = `${targetPath}.${process.pid}.${Date.now()}.tmp`;
+    try {
+        await mkdir(join(omxRoot(worktreeRoot), 'cache'), { recursive: true });
+        const payload = {
+            version: CACHE_VERSION,
+            worktreeRoot,
+            gitDir,
+            indexMtimeMs: indexSignature.mtimeMs,
+            indexSize: indexSignature.size,
+            map,
+            createdAt: new Date().toISOString(),
+        };
+        await writeFile(tempPath, JSON.stringify(payload, null, 2));
+        await rename(tempPath, targetPath);
+    }
+    catch {
+        await rm(tempPath, { force: true }).catch(() => { });
+    }
+}
+/**
+ * Return git-tracked source files relative to cwd.
+ * Falls back to empty array if git is unavailable or times out.
+ */
+function getTrackedSourceFiles(cwd) {
+    try {
+        const out = execSync('git ls-files --cached', {
+            cwd,
+            encoding: 'utf-8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+            timeout: 4000,
+            windowsHide: true,
+        });
+        return out
+            .trim()
+            .split('\n')
+            .filter((f) => f && !f.split('/').includes('.omx') && SOURCE_EXTS.has(extname(f)));
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Group relative file paths by their top-level directory segment.
+ * Files at the root level map to key '.'.
+ */
+function groupByTopDir(files) {
+    const map = new Map();
+    for (const f of files) {
+        const sep = f.indexOf('/');
+        const dir = sep >= 0 ? f.slice(0, sep) : '.';
+        if (!map.has(dir))
+            map.set(dir, []);
+        const arr = map.get(dir);
+        if (arr)
+            arr.push(f);
+    }
+    return map;
+}
+/**
+ * Sort directory entries: src/ and scripts/ first, then alphabetical,
+ * dotfiles and root last.
+ */
+function sortDirs(dirs) {
+    const priority = ['src', 'scripts', 'bin', 'prompts', 'agents', 'skills', 'templates'];
+    return dirs.slice().sort((a, b) => {
+        const ai = priority.indexOf(a);
+        const bi = priority.indexOf(b);
+        if (ai >= 0 && bi >= 0)
+            return ai - bi;
+        if (ai >= 0)
+            return -1;
+        if (bi >= 0)
+            return 1;
+        // Dotfiles and root sink to the bottom
+        const aIsLow = a.startsWith('.') || a === '.';
+        const bIsLow = b.startsWith('.') || b === '.';
+        if (aIsLow && !bIsLow)
+            return 1;
+        if (!aIsLow && bIsLow)
+            return -1;
+        return a.localeCompare(b);
+    });
+}
+/**
+ * Build a single directory line.
+ * Format: `  src/hooks/: agents-overlay, codebase-map, session`
+ */
+function buildDirLine(dir, files) {
+    const names = files
+        .slice(0, MAX_FILES_PER_DIR)
+        .map((f) => basename(f).replace(/\.(ts|tsx|js|mjs)$/, ''))
+        .filter((n, _index, arr) => n !== 'index' || arr.length === 1); // keep index only if sole file
+    if (names.length === 0)
+        return '';
+    const label = dir === '.' ? '(root)' : `${dir}/`;
+    return `  ${label}: ${names.join(', ')}`;
+}
+/**
+ * Generate a compact codebase map for the project at `cwd`.
+ *
+ * Returns an empty string if:
+ * - No git-tracked source files exist
+ * - Any error occurs (always safe to call)
+ */
+export async function generateCodebaseMap(cwd) {
+    try {
+        const layout = findGitLayout(cwd);
+        const indexSignature = layout ? readGitIndexSignature(layout.gitDir) : null;
+        if (layout && indexSignature) {
+            const cached = await readCachedCodebaseMap(layout.worktreeRoot, layout.gitDir, indexSignature);
+            if (cached !== null)
+                return cached;
+        }
+        const files = getTrackedSourceFiles(cwd);
+        if (files.length === 0) {
+            if (layout && indexSignature) {
+                await writeCachedCodebaseMap(layout.worktreeRoot, layout.gitDir, indexSignature, '');
+            }
+            return '';
+        }
+        const grouped = groupByTopDir(files);
+        const sortedDirs = sortDirs([...grouped.keys()]);
+        // For the src/ directory, break down sub-directories for finer granularity
+        const lines = [];
+        for (const dir of sortedDirs.slice(0, MAX_DIRS)) {
+            const dirFiles = grouped.get(dir) ?? [];
+            if (dir === 'src') {
+                // Sub-group src by its immediate subdirectory
+                const subGrouped = new Map();
+                for (const f of dirFiles) {
+                    const parts = f.split('/');
+                    const subDir = parts.length >= 3 ? `src/${parts[1]}` : 'src';
+                    if (!subGrouped.has(subDir))
+                        subGrouped.set(subDir, []);
+                    const arr = subGrouped.get(subDir);
+                    if (arr)
+                        arr.push(f);
+                }
+                const sortedSubs = [...subGrouped.keys()].sort((a, b) => a.localeCompare(b));
+                for (const sub of sortedSubs.slice(0, MAX_DIRS)) {
+                    const subFiles = subGrouped.get(sub) ?? [];
+                    const line = buildDirLine(sub, subFiles);
+                    if (line)
+                        lines.push(line);
+                }
+            }
+            else {
+                const line = buildDirLine(dir, dirFiles);
+                if (line)
+                    lines.push(line);
+            }
+        }
+        if (lines.length === 0) {
+            if (layout && indexSignature) {
+                await writeCachedCodebaseMap(layout.worktreeRoot, layout.gitDir, indexSignature, '');
+            }
+            return '';
+        }
+        const body = lines.join('\n');
+        const map = body.length <= MAX_MAP_CHARS
+            ? body
+            : body.slice(0, MAX_MAP_CHARS - 3) + '...';
+        if (layout && indexSignature) {
+            await writeCachedCodebaseMap(layout.worktreeRoot, layout.gitDir, indexSignature, map);
+        }
+        return map;
+    }
+    catch {
+        return '';
+    }
+}
+//# sourceMappingURL=codebase-map.js.map

package/dist/hooks/codebase-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codebase-map.js","sourceRoot":"","sources":["../../src/hooks/codebase-map.ts"],"names":[],"mappings":"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"}

package/dist/hooks/deep-interview-config-instruction.d.ts

@@ -0,0 +1,3 @@
+import type { SkillActiveState } from './keyword-detector.js';
+export declare function buildDeepInterviewConfigInstruction(cwd: string, skillState?: SkillActiveState | null): string | null;
+//# sourceMappingURL=deep-interview-config-instruction.d.ts.map

package/dist/hooks/deep-interview-config-instruction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-interview-config-instruction.d.ts","sourceRoot":"","sources":["../../src/hooks/deep-interview-config-instruction.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAgB9D,wBAAgB,mCAAmC,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,gBAAgB,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAyBpH"}

package/dist/hooks/deep-interview-config-instruction.js

@@ -0,0 +1,47 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { getBaseStateDir } from '../mcp/state-paths.js';
+function safeString(value) {
+    return typeof value === 'string' ? value : '';
+}
+function resolveInitializedStatePath(cwd, statePath) {
+    if (statePath.startsWith('/'))
+        return statePath;
+    const normalized = statePath.replace(/\\/g, '/');
+    const statePrefix = '.omx/state/';
+    if (normalized.startsWith(statePrefix)) {
+        return join(getBaseStateDir(cwd), normalized.slice(statePrefix.length));
+    }
+    return resolve(cwd, statePath);
+}
+export function buildDeepInterviewConfigInstruction(cwd, skillState) {
+    if (skillState?.initialized_mode !== 'deep-interview' || !skillState.initialized_state_path)
+        return null;
+    const statePath = resolveInitializedStatePath(cwd, skillState.initialized_state_path);
+    try {
+        if (!existsSync(statePath))
+            return null;
+        const parsed = JSON.parse(readFileSync(statePath, 'utf-8'));
+        const nested = parsed.deep_interview_config && typeof parsed.deep_interview_config === 'object'
+            ? parsed.deep_interview_config
+            : {};
+        const profile = safeString(parsed.profile ?? nested.profile).trim();
+        const sourcePath = safeString(parsed.config_source ?? nested.sourcePath).trim();
+        const threshold = typeof parsed.threshold === 'number' ? parsed.threshold : nested.threshold;
+        const maxRounds = typeof parsed.max_rounds === 'number' ? parsed.max_rounds : nested.maxRounds;
+        const enableChallengeModes = typeof parsed.enable_challenge_modes === 'boolean'
+            ? parsed.enable_challenge_modes
+            : nested.enableChallengeModes;
+        if (!profile || typeof threshold !== 'number' || typeof maxRounds !== 'number')
+            return null;
+        return [
+            `Deep-interview config override active${sourcePath ? ` from ${sourcePath}` : ''}:`,
+            `profile=${profile}, threshold=${threshold}, max_rounds=${maxRounds}, enableChallengeModes=${enableChallengeModes !== false}.`,
+            'Use these values instead of SKILL.md defaults for ambiguity scoring, challenge-mode gating, and round caps. Treat max_rounds as a cap, not a target; once ambiguity is at or below threshold and readiness gates pass, crystallize instead of asking another ordinary question.',
+        ].join(' ');
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=deep-interview-config-instruction.js.map

package/dist/hooks/deep-interview-config-instruction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-interview-config-instruction.js","sourceRoot":"","sources":["../../src/hooks/deep-interview-config-instruction.ts"],"names":[],"mappings":"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"}

package/dist/hooks/explore-routing.d.ts

@@ -0,0 +1,5 @@
+export declare const OMX_EXPLORE_CMD_ENV = "USE_OMX_EXPLORE_CMD";
+export declare function isExploreCommandRoutingEnabled(env?: NodeJS.ProcessEnv): boolean;
+export declare function isSimpleExplorationPrompt(text: string): boolean;
+export declare function buildExploreRoutingGuidance(): string;
+//# sourceMappingURL=explore-routing.d.ts.map

package/dist/hooks/explore-routing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explore-routing.d.ts","sourceRoot":"","sources":["../../src/hooks/explore-routing.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,wBAAwB,CAAC;AAoBzD,wBAAgB,8BAA8B,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAI5F;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAK/D;AAED,wBAAgB,2BAA2B,IAAI,MAAM,CAKpD"}

package/dist/hooks/explore-routing.js

@@ -0,0 +1,37 @@
+export const OMX_EXPLORE_CMD_ENV = 'USE_OMX_EXPLORE_CMD';
+const DISABLED_VALUES = new Set(['0', 'false', 'no', 'off']);
+const SIMPLE_EXPLORATION_PATTERNS = [
+    /\b(where|find|locate|search|grep|ripgrep)\b/i,
+    /\b(file|files|path|paths|symbol|symbols|usage|usages|reference|references)\b/i,
+    /\b(pattern|patterns|match|matches|matching)\b/i,
+    /\bhow does\b/i,
+    /\bwhich\b.*\b(contain|contains|define|defines|use|uses)\b/i,
+    /\b(read[- ]only|explor(e|ation)|inspect|lookup|look up|map)\b/i,
+];
+const NON_EXPLORATION_PATTERNS = [
+    /\b(implement|write|edit|modify|change|refactor|fix|patch|add|remove|delete)\b/i,
+    /\b(build|create)\b.*\b(feature|system|workflow|integration|module)\b/i,
+    /\b(migrate|rewrite|overhaul|redesign)\b/i,
+    /\b(test|lint|typecheck|compile|deploy)\b/i,
+];
+export function isExploreCommandRoutingEnabled(env = process.env) {
+    const raw = env[OMX_EXPLORE_CMD_ENV];
+    if (typeof raw !== 'string')
+        return false;
+    return !DISABLED_VALUES.has(raw.trim().toLowerCase());
+}
+export function isSimpleExplorationPrompt(text) {
+    const trimmed = text.trim();
+    if (!trimmed)
+        return false;
+    if (NON_EXPLORATION_PATTERNS.some((pattern) => pattern.test(trimmed)))
+        return false;
+    return SIMPLE_EXPLORATION_PATTERNS.some((pattern) => pattern.test(trimmed));
+}
+export function buildExploreRoutingGuidance() {
+    return [
+        '**Repository Lookup Routing:** use normal Codex repository inspection tools/subagents as the default surface for simple read-only repository lookup and implementation context.',
+        '- Use `omx sparkshell -- <command>` only for explicit shell-native read-only evidence or `--tmux-pane` summaries; it does not replace raw evidence capture.',
+    ].join("\n");
+}
+//# sourceMappingURL=explore-routing.js.map

package/dist/hooks/explore-routing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explore-routing.js","sourceRoot":"","sources":["../../src/hooks/explore-routing.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG,qBAAqB,CAAC;AAEzD,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;AAE7D,MAAM,2BAA2B,GAAa;IAC5C,8CAA8C;IAC9C,+EAA+E;IAC/E,gDAAgD;IAChD,eAAe;IACf,4DAA4D;IAC5D,gEAAgE;CACjE,CAAC;AAEF,MAAM,wBAAwB,GAAa;IACzC,gFAAgF;IAChF,uEAAuE;IACvE,0CAA0C;IAC1C,2CAA2C;CAC5C,CAAC;AAEF,MAAM,UAAU,8BAA8B,CAAC,MAAyB,OAAO,CAAC,GAAG;IACjF,MAAM,GAAG,GAAG,GAAG,CAAC,mBAAmB,CAAC,CAAC;IACrC,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC1C,OAAO,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,IAAY;IACpD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAC3B,IAAI,wBAAwB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IACpF,OAAO,2BAA2B,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,2BAA2B;IACzC,OAAO;QACL,iLAAiL;QACjL,6JAA6J;KAC9J,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/hooks/extensibility/__tests__/dispatcher.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=dispatcher.test.d.ts.map

package/dist/hooks/extensibility/__tests__/dispatcher.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.test.d.ts","sourceRoot":"","sources":["../../../../src/hooks/extensibility/__tests__/dispatcher.test.ts"],"names":[],"mappings":""}

package/dist/hooks/extensibility/__tests__/dispatcher.test.js

@@ -0,0 +1,265 @@
+import assert from 'node:assert/strict';
+import { mkdtemp, mkdir, readFile, rm, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { describe, it } from 'node:test';
+import { isHookPluginFeatureEnabled, dispatchHookEvent } from '../dispatcher.js';
+import { buildHookEvent } from '../events.js';
+function processExists(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function waitForProcessExit(pid, timeoutMs = 2_000) {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        if (!processExists(pid))
+            return;
+        await new Promise((resolve) => setTimeout(resolve, 25));
+    }
+    assert.fail(`process ${pid} should exit before timeout`);
+}
+describe('isHookPluginFeatureEnabled', () => {
+    it('returns true when OMX_HOOK_PLUGINS=1', () => {
+        assert.equal(isHookPluginFeatureEnabled({ OMX_HOOK_PLUGINS: '1' }), true);
+    });
+    it('returns true when env var is missing', () => {
+        assert.equal(isHookPluginFeatureEnabled({}), true);
+    });
+    it('returns false for "0"', () => {
+        assert.equal(isHookPluginFeatureEnabled({ OMX_HOOK_PLUGINS: '0' }), false);
+    });
+});
+describe('dispatchHookEvent', () => {
+    it('returns disabled summary when plugins are disabled', async () => {
+        const cwd = await mkdtemp(join(tmpdir(), 'omx-dispatch-'));
+        try {
+            const event = buildHookEvent('session-start');
+            const result = await dispatchHookEvent(event, {
+                cwd,
+                env: {},
+                enabled: false,
+            });
+            assert.equal(result.enabled, false);
+            assert.equal(result.reason, 'disabled');
+            assert.equal(result.event, 'session-start');
+            assert.equal(result.plugin_count, 0);
+            assert.deepEqual(result.results, []);
+        }
+        finally {
+            await rm(cwd, { recursive: true, force: true });
+        }
+    });
+    it('returns enabled summary with zero plugins for native events even when env is unset', async () => {
+        const cwd = await mkdtemp(join(tmpdir(), 'omx-dispatch-'));
+        try {
+            const event = buildHookEvent('session-start');
+            const result = await dispatchHookEvent(event, {
+                cwd,
+                env: {},
+            });
+            assert.equal(result.enabled, true);
+            assert.equal(result.reason, 'ok');
+            assert.equal(result.plugin_count, 0);
+            assert.deepEqual(result.results, []);
+        }
+        finally {
+            await rm(cwd, { recursive: true, force: true });
+        }
+    });
+    it('reports invalid_export for plugins without onHookEvent', async () => {
+        const cwd = await mkdtemp(join(tmpdir(), 'omx-dispatch-'));
+        try {
+            const dir = join(cwd, '.omx', 'hooks');
+            await mkdir(dir, { recursive: true });
+            await writeFile(join(dir, 'bad.mjs'), 'export const x = 1;');
+            const event = buildHookEvent('session-start');
+            const result = await dispatchHookEvent(event, {
+                cwd,
+                env: { OMX_HOOK_PLUGINS: '1' },
+            });
+            assert.equal(result.enabled, true);
+            assert.equal(result.plugin_count, 1);
+            assert.equal(result.results.length, 1);
+            assert.equal(result.results[0].ok, false);
+            assert.equal(result.results[0].status, 'invalid_export');
+        }
+        finally {
+            await rm(cwd, { recursive: true, force: true });
+        }
+    });
+    it('dispatches valid plugins successfully', async () => {
+        const cwd = await mkdtemp(join(tmpdir(), 'omx-dispatch-'));
+        try {
+            const dir = join(cwd, '.omx', 'hooks');
+            await mkdir(dir, { recursive: true });
+            await writeFile(join(dir, 'good.mjs'), 'export async function onHookEvent(event, sdk) { await sdk.state.write("ran", true); }');
+            const event = buildHookEvent('session-start');
+            const result = await dispatchHookEvent(event, {
+                cwd,
+                env: { ...process.env, OMX_HOOK_PLUGINS: '1' },
+            });
+            assert.equal(result.enabled, true);
+            assert.equal(result.plugin_count, 1);
+            assert.equal(result.results.length, 1);
+            assert.equal(result.results[0].ok, true);
+            assert.equal(result.results[0].plugin, 'good');
+        }
+        finally {
+            await rm(cwd, { recursive: true, force: true });
+        }
+    });
+    it('does not execute plugin top-level code in the parent process', async () => {
+        const cwd = await mkdtemp(join(tmpdir(), 'omx-dispatch-'));
+        try {
+            const dir = join(cwd, '.omx', 'hooks');
+            await mkdir(dir, { recursive: true });
+            await writeFile(join(dir, 'top-level-side-effect.mjs'), `import { appendFileSync } from 'node:fs';
+import { join } from 'node:path';
+appendFileSync(join(process.cwd(), '.omx', 'top-level-pids.log'), String(process.pid) + '\\n');
+export async function onHookEvent() {}
+`);
+            const event = buildHookEvent('session-start');
+            const result = await dispatchHookEvent(event, {
+                cwd,
+                env: { ...process.env, OMX_HOOK_PLUGINS: '1' },
+            });
+            assert.equal(result.enabled, true);
+            assert.equal(result.results.length, 1);
+            assert.equal(result.results[0].ok, true);
+            const pids = (await readFile(join(cwd, '.omx', 'top-level-pids.log'), 'utf-8'))
+                .trim()
+                .split('\n')
+                .filter(Boolean);
+            assert.equal(pids.length, 1);
+            assert.notEqual(pids[0], String(process.pid));
+        }
+        finally {
+            await rm(cwd, { recursive: true, force: true });
+        }
+    });
+    it('respects explicit enabled=true option', async () => {
+        const cwd = await mkdtemp(join(tmpdir(), 'omx-dispatch-'));
+        try {
+            const event = buildHookEvent('session-start');
+            const result = await dispatchHookEvent(event, {
+                cwd,
+                env: {},
+                enabled: true,
+            });
+            assert.equal(result.enabled, true);
+            assert.equal(result.plugin_count, 0);
+        }
+        finally {
+            await rm(cwd, { recursive: true, force: true });
+        }
+    });
+    it('includes source from event in summary', async () => {
+        const cwd = await mkdtemp(join(tmpdir(), 'omx-dispatch-'));
+        try {
+            const event = buildHookEvent('needs-input');
+            const result = await dispatchHookEvent(event, {
+                cwd,
+            });
+            assert.equal(result.source, 'derived');
+            assert.equal(result.event, 'needs-input');
+            assert.equal(result.enabled, true);
+        }
+        finally {
+            await rm(cwd, { recursive: true, force: true });
+        }
+    });
+    it('disables side effects for team workers by default', async () => {
+        const cwd = await mkdtemp(join(tmpdir(), 'omx-dispatch-'));
+        try {
+            const dir = join(cwd, '.omx', 'hooks');
+            await mkdir(dir, { recursive: true });
+            await writeFile(join(dir, 'se-test.mjs'), `export async function onHookEvent(event, sdk) {
+          const result = await sdk.tmux.sendKeys({ text: 'hello' });
+          await sdk.state.write('send_result', result.reason);
+        }`);
+            const event = buildHookEvent('session-start');
+            const result = await dispatchHookEvent(event, {
+                cwd,
+                env: { ...process.env, OMX_HOOK_PLUGINS: '1', OMX_TEAM_WORKER: 'worker-1' },
+            });
+            assert.equal(result.enabled, true);
+            assert.equal(result.results.length, 1);
+            assert.equal(result.results[0].ok, true);
+        }
+        finally {
+            await rm(cwd, { recursive: true, force: true });
+        }
+    });
+    it('returns timeout promptly when plugin ignores SIGTERM', async () => {
+        const cwd = await mkdtemp(join(tmpdir(), 'omx-dispatch-'));
+        try {
+            const dir = join(cwd, '.omx', 'hooks');
+            await mkdir(dir, { recursive: true });
+            const pidFile = join(cwd, 'plugin-runner.pid');
+            await writeFile(join(dir, 'ignore-sigterm.mjs'), `import { writeFileSync } from 'node:fs';
+        export async function onHookEvent() {
+          writeFileSync(process.env.OMX_TEST_PLUGIN_PID_FILE, String(process.pid));
+          process.on('SIGTERM', () => {});
+          setInterval(() => {}, 60_000);
+          await new Promise(() => {});
+        }`);
+            const event = buildHookEvent('session-start');
+            const startedAt = Date.now();
+            const result = await dispatchHookEvent(event, {
+                cwd,
+                timeoutMs: 300,
+                env: { ...process.env, OMX_HOOK_PLUGINS: '1', OMX_TEST_PLUGIN_PID_FILE: pidFile },
+            });
+            const elapsedMs = Date.now() - startedAt;
+            const pid = Number(await readFile(pidFile, 'utf8'));
+            assert.equal(result.enabled, true);
+            assert.equal(result.plugin_count, 1);
+            assert.equal(result.results.length, 1);
+            assert.equal(result.results[0].ok, false);
+            assert.equal(result.results[0].status, 'timeout');
+            assert.ok(elapsedMs < 1500, `dispatch should timeout promptly (elapsed=${elapsedMs}ms)`);
+            await waitForProcessExit(pid);
+        }
+        finally {
+            await rm(cwd, { recursive: true, force: true });
+        }
+    });
+    it('dedupes repeated native lifecycle hook dispatches for the same session/turn fingerprint', async () => {
+        const cwd = await mkdtemp(join(tmpdir(), 'omx-dispatch-dedupe-'));
+        try {
+            const dir = join(cwd, '.omx', 'hooks');
+            await mkdir(dir, { recursive: true });
+            await writeFile(join(dir, 'good.mjs'), 'export async function onHookEvent(event, sdk) { const count = Number((await sdk.state.read("count", 0)) || 0); await sdk.state.write("count", count + 1); }');
+            const event = buildHookEvent('keyword-detector', {
+                source: 'native',
+                session_id: 'sess-1',
+                thread_id: 'thread-1',
+                turn_id: 'turn-1',
+                context: { phase: 'prompt-submitted', marker: 'same-turn' },
+            });
+            const first = await dispatchHookEvent(event, {
+                cwd,
+                env: { ...process.env, OMX_HOOK_PLUGINS: '1' },
+            });
+            const second = await dispatchHookEvent(event, {
+                cwd,
+                env: { ...process.env, OMX_HOOK_PLUGINS: '1' },
+            });
+            assert.equal(first.enabled, true);
+            assert.equal(first.results.length, 1);
+            assert.equal(first.results[0].ok, true);
+            assert.equal(second.enabled, true);
+            assert.equal(second.reason, 'deduped');
+            assert.equal(second.results.length, 0);
+        }
+        finally {
+            await rm(cwd, { recursive: true, force: true });
+        }
+    });
+});
+//# sourceMappingURL=dispatcher.test.js.map