oh-my-codex 0.1.1

package/dist/hooks/agents-overlay.js

@@ -0,0 +1,265 @@
+/**
+ * AGENTS.md Runtime Overlay for oh-my-codex
+ *
+ * Dynamically injects session-specific context into AGENTS.md before Codex
+ * launches, then strips it after session ends. Uses marker-bounded sections
+ * for idempotent apply/strip cycles.
+ *
+ * Injected context:
+ * - Active mode state (ralph iteration, autopilot phase, etc.)
+ * - Priority notepad content
+ * - Project memory summary (tech stack, conventions, directives)
+ * - Compaction survival instructions
+ * - Session metadata
+ */
+import { readFile, writeFile, mkdir, rm } from 'fs/promises';
+import { join } from 'path';
+import { existsSync } from 'fs';
+import { omxStateDir, omxNotepadPath, omxProjectMemoryPath } from '../utils/paths.js';
+const START_MARKER = '<!-- OMX:RUNTIME:START -->';
+const END_MARKER = '<!-- OMX:RUNTIME:END -->';
+const MAX_OVERLAY_SIZE = 2000;
+// ── Lock helpers ─────────────────────────────────────────────────────────────
+function lockPath(cwd) {
+    return join(cwd, '.omx', 'state', 'agents-md.lock');
+}
+async function acquireLock(cwd, timeoutMs = 5000) {
+    const lock = lockPath(cwd);
+    // Ensure parent directory exists
+    const { dirname } = await import('path');
+    await mkdir(dirname(lock), { recursive: true });
+    const start = Date.now();
+    while (Date.now() - start < timeoutMs) {
+        try {
+            await mkdir(lock, { recursive: false });
+            // Write owner metadata for stale detection
+            const ownerFile = join(lock, 'owner.json');
+            await writeFile(ownerFile, JSON.stringify({ pid: process.pid, ts: Date.now() }));
+            return; // Lock acquired
+        }
+        catch {
+            // Lock exists - check if owner is dead
+            try {
+                const ownerFile = join(lock, 'owner.json');
+                const ownerData = JSON.parse(await readFile(ownerFile, 'utf-8'));
+                try {
+                    process.kill(ownerData.pid, 0);
+                }
+                catch {
+                    // Owner PID is dead, safe to reap
+                    await rm(lock, { recursive: true, force: true }).catch(() => { });
+                    continue; // Retry acquire immediately
+                }
+            }
+            catch { /* no owner file or parse error, wait */ }
+            await new Promise(r => setTimeout(r, 100));
+        }
+    }
+    // Timeout: do NOT silently proceed - throw so caller knows lock failed
+    throw new Error('Failed to acquire AGENTS.md lock within timeout');
+}
+async function releaseLock(cwd) {
+    try {
+        await rm(lockPath(cwd), { recursive: true, force: true });
+    }
+    catch { /* ignore */ }
+}
+async function withAgentsMdLock(cwd, fn) {
+    await acquireLock(cwd);
+    try {
+        return await fn();
+    }
+    finally {
+        await releaseLock(cwd);
+    }
+}
+// ── Truncation helpers ───────────────────────────────────────────────────────
+function truncate(text, maxLen) {
+    if (text.length <= maxLen)
+        return text;
+    return text.slice(0, maxLen - 3) + '...';
+}
+async function readActiveModes(cwd) {
+    const stateDir = omxStateDir(cwd);
+    if (!existsSync(stateDir))
+        return '';
+    const { readdir } = await import('fs/promises');
+    const files = await readdir(stateDir);
+    const modes = [];
+    for (const f of files) {
+        if (!f.endsWith('-state.json') || f === 'session.json')
+            continue;
+        try {
+            const data = JSON.parse(await readFile(join(stateDir, f), 'utf-8'));
+            if (data.active) {
+                const mode = f.replace('-state.json', '');
+                const details = [];
+                if (data.iteration !== undefined)
+                    details.push(`iteration ${data.iteration}/${data.max_iterations || '?'}`);
+                if (data.current_phase)
+                    details.push(`phase: ${data.current_phase}`);
+                modes.push(`- ${mode}: ${details.join(', ') || 'active'}`);
+            }
+        }
+        catch { /* skip malformed */ }
+    }
+    return modes.length > 0 ? modes.join('\n') : '';
+}
+async function readNotepadPriority(cwd) {
+    const notePath = omxNotepadPath(cwd);
+    if (!existsSync(notePath))
+        return '';
+    try {
+        const content = await readFile(notePath, 'utf-8');
+        const header = '## PRIORITY';
+        const idx = content.indexOf(header);
+        if (idx < 0)
+            return '';
+        const nextHeader = content.indexOf('\n## ', idx + header.length);
+        const section = nextHeader < 0
+            ? content.slice(idx + header.length).trim()
+            : content.slice(idx + header.length, nextHeader).trim();
+        return section || '';
+    }
+    catch {
+        return '';
+    }
+}
+async function readProjectMemorySummary(cwd) {
+    const memPath = omxProjectMemoryPath(cwd);
+    if (!existsSync(memPath))
+        return '';
+    try {
+        const data = JSON.parse(await readFile(memPath, 'utf-8'));
+        const parts = [];
+        if (data.techStack)
+            parts.push(`- Stack: ${data.techStack}`);
+        if (data.conventions)
+            parts.push(`- Conventions: ${data.conventions}`);
+        if (data.build)
+            parts.push(`- Build: ${data.build}`);
+        if (data.directives && Array.isArray(data.directives)) {
+            const highPriority = data.directives.filter((d) => d.priority === 'high');
+            for (const d of highPriority.slice(0, 3)) {
+                parts.push(`- Directive: ${d.directive}`);
+            }
+        }
+        return parts.join('\n');
+    }
+    catch {
+        return '';
+    }
+}
+function getCompactionInstructions() {
+    return [
+        'Before context compaction, preserve critical state:',
+        '1. Write progress checkpoint via state_write MCP tool',
+        '2. Save key decisions to notepad via notepad_write_working',
+        '3. If context is >80% full, proactively checkpoint state',
+    ].join('\n');
+}
+/**
+ * Generate the overlay content to inject into AGENTS.md.
+ * Total output is capped at MAX_OVERLAY_SIZE chars.
+ */
+export async function generateOverlay(cwd, sessionId) {
+    const [activeModes, notepadPriority, projectMemory] = await Promise.all([
+        readActiveModes(cwd),
+        readNotepadPriority(cwd),
+        readProjectMemorySummary(cwd),
+    ]);
+    // Build sections with priority-ordered truncation
+    const sections = [];
+    // Session metadata (max 200 chars)
+    const sessionMeta = `**Session:** ${sessionId || 'unknown'} | ${new Date().toISOString()}`;
+    sections.push(truncate(sessionMeta, 200));
+    // Active modes (max 300 chars)
+    if (activeModes) {
+        sections.push(`**Active Modes:**\n${truncate(activeModes, 280)}`);
+    }
+    // Priority notepad (max 300 chars)
+    if (notepadPriority) {
+        sections.push(`**Priority Notes:**\n${truncate(notepadPriority, 280)}`);
+    }
+    // Project memory (max 500 chars)
+    if (projectMemory) {
+        sections.push(`**Project Context:**\n${truncate(projectMemory, 480)}`);
+    }
+    // Compaction protocol (max 400 chars)
+    sections.push(`**Compaction Protocol:**\n${truncate(getCompactionInstructions(), 380)}`);
+    // Compose final overlay
+    let body = sections.join('\n\n');
+    // Ensure total fits within cap (markers + body)
+    const markerOverhead = START_MARKER.length + END_MARKER.length + 30; // newlines
+    const maxBody = MAX_OVERLAY_SIZE - markerOverhead;
+    if (body.length > maxBody) {
+        body = body.slice(0, maxBody - 3) + '...';
+    }
+    return `${START_MARKER}\n<session_context>\n${body}\n</session_context>\n${END_MARKER}`;
+}
+/**
+ * Apply overlay to AGENTS.md. Strips any existing overlay first (idempotent).
+ * Uses file locking to prevent concurrent access corruption.
+ */
+export async function applyOverlay(agentsMdPath, overlay, cwd) {
+    const dir = cwd || join(agentsMdPath, '..');
+    await withAgentsMdLock(dir, async () => {
+        let content = '';
+        if (existsSync(agentsMdPath)) {
+            content = await readFile(agentsMdPath, 'utf-8');
+        }
+        // Strip existing overlay
+        content = stripOverlayContent(content);
+        // Append new overlay
+        content = content.trimEnd() + '\n\n' + overlay + '\n';
+        await writeFile(agentsMdPath, content);
+    });
+}
+/**
+ * Strip overlay from AGENTS.md, restoring it to clean state.
+ * Uses file locking to prevent concurrent access corruption.
+ */
+export async function stripOverlay(agentsMdPath, cwd) {
+    if (!existsSync(agentsMdPath))
+        return;
+    const dir = cwd || join(agentsMdPath, '..');
+    await withAgentsMdLock(dir, async () => {
+        const content = await readFile(agentsMdPath, 'utf-8');
+        const stripped = stripOverlayContent(content);
+        if (stripped !== content) {
+            await writeFile(agentsMdPath, stripped);
+        }
+    });
+}
+/**
+ * Remove overlay markers and content from a string (pure function).
+ */
+function stripOverlayContent(content) {
+    // Strip all marker-bounded segments (handles multiple overlays from corruption)
+    let result = content;
+    let iterations = 0;
+    const MAX_STRIP_ITERATIONS = 5; // Safety bound
+    while (iterations < MAX_STRIP_ITERATIONS) {
+        const startIdx = result.indexOf(START_MARKER);
+        if (startIdx < 0)
+            break;
+        const endIdx = result.indexOf(END_MARKER, startIdx);
+        if (endIdx < 0) {
+            // Malformed: remove from start marker to end of file
+            result = result.slice(0, startIdx).trimEnd() + '\n';
+            break;
+        }
+        const before = result.slice(0, startIdx).trimEnd();
+        const after = result.slice(endIdx + END_MARKER.length).trimStart();
+        result = after ? before + '\n' + after : before + '\n';
+        iterations++;
+    }
+    return result;
+}
+/**
+ * Check if AGENTS.md currently has an overlay applied.
+ */
+export function hasOverlay(content) {
+    return content.includes(START_MARKER) && content.includes(END_MARKER);
+}
+//# sourceMappingURL=agents-overlay.js.map

package/dist/hooks/agents-overlay.js.map

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

package/dist/hooks/emulator.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Hook Emulation Layer for oh-my-codex
+ *
+ * Since Codex CLI's hooks are limited (AfterAgent + AfterToolUse only, fire-and-forget),
+ * we emulate the full OMC hook pipeline through alternative mechanisms:
+ *
+ * 1. SessionStart -> AGENTS.md (native Codex CLI, no hook needed)
+ * 2. PreToolUse -> AGENTS.md instructions (inline guidance, no hook needed)
+ * 3. PostToolUse -> notify config (fire-and-forget, no context injection)
+ * 4. UserPromptSubmit -> AGENTS.md keyword detection instructions
+ * 5. SubagentStart/Stop -> Codex CLI collab system (native tracking)
+ * 6. PreCompact -> Not available (Codex manages compaction internally)
+ * 7. Stop -> notify config (can detect turn completion)
+ *
+ * For features that require context injection (keyword detection triggering
+ * skill loading), we rely on the AGENTS.md orchestration brain to instruct
+ * the model to self-invoke skills when it detects keywords.
+ *
+ * This is the key architectural difference from OMC:
+ * - OMC: External hook detects keyword -> injects skill prompt via system-reminder
+ * - OMX: AGENTS.md instructs model -> model self-detects keyword -> model loads skill
+ */
+/**
+ * Hook event types (for compatibility with OMC concepts)
+ */
+export type HookEvent = 'SessionStart' | 'PreToolUse' | 'PostToolUse' | 'UserPromptSubmit' | 'SubagentStart' | 'SubagentStop' | 'PreCompact' | 'Stop' | 'SessionEnd';
+/**
+ * Mapping of OMC hook capabilities to OMX equivalents
+ */
+export declare const HOOK_MAPPING: Record<HookEvent, {
+    mechanism: string;
+    capability: 'full' | 'partial' | 'none';
+    notes: string;
+}>;
+/**
+ * Keyword detection configuration (embedded in AGENTS.md)
+ * Instead of external hook detection, the model is instructed to self-detect
+ */
+export declare const KEYWORD_TRIGGERS: Record<string, string>;
+/**
+ * Generate the keyword detection section for AGENTS.md
+ */
+export declare function generateKeywordDetectionSection(): string;
+//# sourceMappingURL=emulator.d.ts.map

package/dist/hooks/emulator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emulator.d.ts","sourceRoot":"","sources":["../../src/hooks/emulator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH;;GAEG;AACH,MAAM,MAAM,SAAS,GACjB,cAAc,GACd,YAAY,GACZ,aAAa,GACb,kBAAkB,GAClB,eAAe,GACf,cAAc,GACd,YAAY,GACZ,MAAM,GACN,YAAY,CAAC;AAEjB;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,SAAS,EAAE;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;IACxC,KAAK,EAAE,MAAM,CAAC;CACf,CA8CA,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAanD,CAAC;AAEF;;GAEG;AACH,wBAAgB,+BAA+B,IAAI,MAAM,CAcxD"}

package/dist/hooks/emulator.js

@@ -0,0 +1,108 @@
+/**
+ * Hook Emulation Layer for oh-my-codex
+ *
+ * Since Codex CLI's hooks are limited (AfterAgent + AfterToolUse only, fire-and-forget),
+ * we emulate the full OMC hook pipeline through alternative mechanisms:
+ *
+ * 1. SessionStart -> AGENTS.md (native Codex CLI, no hook needed)
+ * 2. PreToolUse -> AGENTS.md instructions (inline guidance, no hook needed)
+ * 3. PostToolUse -> notify config (fire-and-forget, no context injection)
+ * 4. UserPromptSubmit -> AGENTS.md keyword detection instructions
+ * 5. SubagentStart/Stop -> Codex CLI collab system (native tracking)
+ * 6. PreCompact -> Not available (Codex manages compaction internally)
+ * 7. Stop -> notify config (can detect turn completion)
+ *
+ * For features that require context injection (keyword detection triggering
+ * skill loading), we rely on the AGENTS.md orchestration brain to instruct
+ * the model to self-invoke skills when it detects keywords.
+ *
+ * This is the key architectural difference from OMC:
+ * - OMC: External hook detects keyword -> injects skill prompt via system-reminder
+ * - OMX: AGENTS.md instructs model -> model self-detects keyword -> model loads skill
+ */
+/**
+ * Mapping of OMC hook capabilities to OMX equivalents
+ */
+export const HOOK_MAPPING = {
+    SessionStart: {
+        mechanism: 'AGENTS.md native loading + runtime overlay',
+        capability: 'full',
+        notes: 'Codex CLI reads AGENTS.md at start; omx preLaunch injects dynamic overlay (modes, notepad, memory, compaction protocol)',
+    },
+    PreToolUse: {
+        mechanism: 'AGENTS.md inline guidance',
+        capability: 'partial',
+        notes: 'No pre-tool interception, but AGENTS.md can instruct model behavior before tool use',
+    },
+    PostToolUse: {
+        mechanism: 'notify config (fire-and-forget)',
+        capability: 'partial',
+        notes: 'Can log and update state, but cannot inject context back into conversation',
+    },
+    UserPromptSubmit: {
+        mechanism: 'AGENTS.md self-detection instructions',
+        capability: 'partial',
+        notes: 'Model detects keywords via AGENTS.md instructions instead of external hook',
+    },
+    SubagentStart: {
+        mechanism: 'Codex CLI collab system',
+        capability: 'full',
+        notes: 'Native sub-agent lifecycle tracking via collab feature',
+    },
+    SubagentStop: {
+        mechanism: 'Codex CLI collab system',
+        capability: 'full',
+        notes: 'Native sub-agent lifecycle tracking via collab feature',
+    },
+    PreCompact: {
+        mechanism: 'AGENTS.md overlay compaction protocol',
+        capability: 'partial',
+        notes: 'Overlay includes compaction survival instructions; no event interception but model is instructed to checkpoint state',
+    },
+    Stop: {
+        mechanism: 'notify config + postLaunch cleanup',
+        capability: 'full',
+        notes: 'notify fires on agent-turn-complete; postLaunch strips overlay and archives session on exit',
+    },
+    SessionEnd: {
+        mechanism: 'omx postLaunch lifecycle phase',
+        capability: 'partial',
+        notes: 'postLaunch runs after Codex exits: strips overlay, archives session, cancels active modes',
+    },
+};
+/**
+ * Keyword detection configuration (embedded in AGENTS.md)
+ * Instead of external hook detection, the model is instructed to self-detect
+ */
+export const KEYWORD_TRIGGERS = {
+    'autopilot': 'Activate autopilot skill for autonomous execution',
+    'ralph': 'Activate ralph persistence loop with verification',
+    'ultrawork': 'Activate ultrawork parallel execution mode',
+    'ulw': 'Activate ultrawork parallel execution mode',
+    'ecomode': 'Activate ecomode for token-efficient execution',
+    'eco': 'Activate ecomode for token-efficient execution',
+    'plan': 'Activate planning skill',
+    'ralplan': 'Activate consensus planning (planner + architect + critic)',
+    'team': 'Activate coordinated team mode',
+    'pipeline': 'Activate sequential pipeline mode',
+    'research': 'Activate parallel research mode',
+    'cancel': 'Cancel active execution modes',
+};
+/**
+ * Generate the keyword detection section for AGENTS.md
+ */
+export function generateKeywordDetectionSection() {
+    const lines = Object.entries(KEYWORD_TRIGGERS)
+        .map(([keyword, action]) => `- When user says "${keyword}": ${action}`)
+        .join('\n');
+    return `
+<keyword_detection>
+When you see these keywords in user messages, activate the corresponding skill:
+${lines}
+
+To activate a skill, use the corresponding slash command or invoke the skill directly.
+If a keyword is detected, announce the activation to the user before proceeding.
+</keyword_detection>
+`;
+}
+//# sourceMappingURL=emulator.js.map

package/dist/hooks/emulator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emulator.js","sourceRoot":"","sources":["../../src/hooks/emulator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAgBH;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAIpB;IACH,YAAY,EAAE;QACZ,SAAS,EAAE,4CAA4C;QACvD,UAAU,EAAE,MAAM;QAClB,KAAK,EAAE,yHAAyH;KACjI;IACD,UAAU,EAAE;QACV,SAAS,EAAE,2BAA2B;QACtC,UAAU,EAAE,SAAS;QACrB,KAAK,EAAE,qFAAqF;KAC7F;IACD,WAAW,EAAE;QACX,SAAS,EAAE,iCAAiC;QAC5C,UAAU,EAAE,SAAS;QACrB,KAAK,EAAE,4EAA4E;KACpF;IACD,gBAAgB,EAAE;QAChB,SAAS,EAAE,uCAAuC;QAClD,UAAU,EAAE,SAAS;QACrB,KAAK,EAAE,4EAA4E;KACpF;IACD,aAAa,EAAE;QACb,SAAS,EAAE,yBAAyB;QACpC,UAAU,EAAE,MAAM;QAClB,KAAK,EAAE,wDAAwD;KAChE;IACD,YAAY,EAAE;QACZ,SAAS,EAAE,yBAAyB;QACpC,UAAU,EAAE,MAAM;QAClB,KAAK,EAAE,wDAAwD;KAChE;IACD,UAAU,EAAE;QACV,SAAS,EAAE,uCAAuC;QAClD,UAAU,EAAE,SAAS;QACrB,KAAK,EAAE,sHAAsH;KAC9H;IACD,IAAI,EAAE;QACJ,SAAS,EAAE,oCAAoC;QAC/C,UAAU,EAAE,MAAM;QAClB,KAAK,EAAE,6FAA6F;KACrG;IACD,UAAU,EAAE;QACV,SAAS,EAAE,gCAAgC;QAC3C,UAAU,EAAE,SAAS;QACrB,KAAK,EAAE,2FAA2F;KACnG;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAA2B;IACtD,WAAW,EAAE,mDAAmD;IAChE,OAAO,EAAE,mDAAmD;IAC5D,WAAW,EAAE,4CAA4C;IACzD,KAAK,EAAE,4CAA4C;IACnD,SAAS,EAAE,gDAAgD;IAC3D,KAAK,EAAE,gDAAgD;IACvD,MAAM,EAAE,yBAAyB;IACjC,SAAS,EAAE,4DAA4D;IACvE,MAAM,EAAE,gCAAgC;IACxC,UAAU,EAAE,mCAAmC;IAC/C,UAAU,EAAE,iCAAiC;IAC7C,QAAQ,EAAE,+BAA+B;CAC1C,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,+BAA+B;IAC7C,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC;SAC3C,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,qBAAqB,OAAO,MAAM,MAAM,EAAE,CAAC;SACtE,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO;;;EAGP,KAAK;;;;;CAKN,CAAC;AACF,CAAC"}

package/dist/hooks/keyword-detector.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Keyword Detection Engine
+ *
+ * In OMC, this runs as a UserPromptSubmit hook that detects magic keywords
+ * and injects skill prompts via system-reminder.
+ *
+ * In OMX, this logic is embedded in the AGENTS.md orchestration brain,
+ * and can also be used by the notify hook for state tracking.
+ *
+ * When Codex CLI adds pre-hook support, this module can be promoted
+ * to an external hook handler.
+ */
+export interface KeywordMatch {
+    keyword: string;
+    skill: string;
+    priority: number;
+}
+/**
+ * Detect keywords in user input text
+ * Returns matching skills sorted by priority (highest first)
+ */
+export declare function detectKeywords(text: string): KeywordMatch[];
+/**
+ * Get the highest-priority keyword match
+ */
+export declare function detectPrimaryKeyword(text: string): KeywordMatch | null;
+//# sourceMappingURL=keyword-detector.d.ts.map

package/dist/hooks/keyword-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyword-detector.d.ts","sourceRoot":"","sources":["../../src/hooks/keyword-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAgCD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,EAAE,CAe3D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAGtE"}

package/dist/hooks/keyword-detector.js

@@ -0,0 +1,63 @@
+/**
+ * Keyword Detection Engine
+ *
+ * In OMC, this runs as a UserPromptSubmit hook that detects magic keywords
+ * and injects skill prompts via system-reminder.
+ *
+ * In OMX, this logic is embedded in the AGENTS.md orchestration brain,
+ * and can also be used by the notify hook for state tracking.
+ *
+ * When Codex CLI adds pre-hook support, this module can be promoted
+ * to an external hook handler.
+ */
+const KEYWORD_MAP = [
+    // Execution modes
+    { pattern: /\bautopilot\b/i, skill: 'autopilot', priority: 10 },
+    { pattern: /\bralph\b/i, skill: 'ralph', priority: 10 },
+    { pattern: /\bultrawork\b|\bulw\b/i, skill: 'ultrawork', priority: 10 },
+    { pattern: /\becomode\b|\beco\b/i, skill: 'ecomode', priority: 10 },
+    { pattern: /\bultrapilot\b/i, skill: 'ultrapilot', priority: 10 },
+    // Planning
+    { pattern: /\bralplan\b/i, skill: 'ralplan', priority: 9 },
+    { pattern: /\bplan\s+(?:this|the)\b/i, skill: 'plan', priority: 8 },
+    // Coordination
+    { pattern: /\bteam\b.*\bagent/i, skill: 'team', priority: 8 },
+    { pattern: /\bpipeline\b/i, skill: 'pipeline', priority: 8 },
+    { pattern: /\bresearch\b/i, skill: 'research', priority: 7 },
+    // Shortcuts
+    { pattern: /\banalyze\b|\bdebug\b|\binvestigate\b/i, skill: 'analyze', priority: 6 },
+    { pattern: /\bdeepsearch\b|\bsearch.*codebase\b/i, skill: 'deepsearch', priority: 6 },
+    { pattern: /\btdd\b|\btest.first\b/i, skill: 'tdd', priority: 6 },
+    { pattern: /\bfix.build\b|\btype.errors?\b/i, skill: 'build-fix', priority: 6 },
+    { pattern: /\breview.code\b|\bcode.review\b/i, skill: 'code-review', priority: 6 },
+    { pattern: /\bsecurity.review\b/i, skill: 'security-review', priority: 6 },
+    { pattern: /\bdeepinit\b/i, skill: 'deepinit', priority: 6 },
+    // Utilities
+    { pattern: /\bcancel\b.*\b(?:mode|all)\b/i, skill: 'cancel', priority: 5 },
+];
+/**
+ * Detect keywords in user input text
+ * Returns matching skills sorted by priority (highest first)
+ */
+export function detectKeywords(text) {
+    const matches = [];
+    for (const { pattern, skill, priority } of KEYWORD_MAP) {
+        const match = text.match(pattern);
+        if (match) {
+            matches.push({
+                keyword: match[0],
+                skill,
+                priority,
+            });
+        }
+    }
+    return matches.sort((a, b) => b.priority - a.priority);
+}
+/**
+ * Get the highest-priority keyword match
+ */
+export function detectPrimaryKeyword(text) {
+    const matches = detectKeywords(text);
+    return matches.length > 0 ? matches[0] : null;
+}
+//# sourceMappingURL=keyword-detector.js.map

package/dist/hooks/keyword-detector.js.map

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

package/dist/hooks/session.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Session Lifecycle Manager for oh-my-codex
+ *
+ * Tracks session start/end, detects stale sessions from crashed launches,
+ * and provides structured logging for session events.
+ */
+export interface SessionState {
+    session_id: string;
+    started_at: string;
+    cwd: string;
+    pid: number;
+}
+/**
+ * Reset session-scoped HUD/metrics files at launch so stale values do not leak
+ * into a new Codex session.
+ */
+export declare function resetSessionMetrics(cwd: string): Promise<void>;
+/**
+ * Read current session state. Returns null if no session file exists.
+ */
+export declare function readSessionState(cwd: string): Promise<SessionState | null>;
+/**
+ * Check if a session is stale (PID dead or started >2h ago).
+ */
+export declare function isSessionStale(state: SessionState): boolean;
+/**
+ * Write session start state.
+ */
+export declare function writeSessionStart(cwd: string, sessionId: string): Promise<void>;
+/**
+ * Write session end: archive to history, delete session.json.
+ */
+export declare function writeSessionEnd(cwd: string, sessionId: string): Promise<void>;
+/**
+ * Append a structured JSONL entry to the daily log file.
+ */
+export declare function appendToLog(cwd: string, entry: Record<string, unknown>): Promise<void>;
+//# sourceMappingURL=session.d.ts.map

package/dist/hooks/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/hooks/session.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAeD;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAuBpE;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAUhF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAS3D;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBrF;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA4BnF;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAS5F"}