maestro-flow 0.4.1 → 0.4.2

package/.claude/commands/maestro-impeccable.md

@@ -76,81 +76,84 @@ responsive-design.md, spatial-design.md, typography.md, ux-writing.md
 
 | Chain | Steps | Scenario |
 |-------|-------|----------|
-| build | teach? → explore? → shape → craft → critique → [refine] → audit → polish | 从零新建 |
-| redesign | document → explore → shape → craft → critique → [refine] → audit → polish | 基于现有代码重设计 |
-| improve | critique → [refine] → polish → audit | 迭代改进 |
-| enhance | {cmd...} → critique → [refine] → polish | 定向增强（支持多命令） |
-| launch | harden → adapt → optimize → audit → polish | 全方位上线准备 |
-| harden | harden → audit → polish | 边界加固 |
-| foundation | teach? → explore → document → extract | 纯设计系统建设 |
-| live | live | 实时迭代 |
+| build | teach? → explore? → shape → craft → critique → [refine] → audit → polish | New from scratch |
+| redesign | document → explore → shape → craft → critique → [refine] → audit → polish | Redesign existing code |
+| improve | critique → [refine] → polish → audit | Iterative improvement |
+| enhance | {cmd...} → critique → [refine] → polish | Targeted enhancement (multi-command) |
+| launch | harden → adapt → optimize → audit → polish | Full production readiness |
+| harden | harden → audit → polish | Edge case hardening |
+| foundation | teach? → explore → document → extract | Design system setup |
+| live | live | Real-time iteration |
 
 - `?` = conditional: teach if PRODUCT.md missing; explore if DESIGN.md missing and --skip-design not set
 - `[refine]` = quality gate loop: gate fails → auto-select fix commands from findings → re-gate
-- `{cmd...}` = enhance 支持多命令，逗号分隔：`enhance colorize,typeset landing-page`
+- `{cmd...}` = enhance supports multiple commands, comma-separated: `enhance colorize,typeset landing-page`
 
 Chain flags: --threshold <N> (default 26/40), --max-loops <N> (default 3), --skip-design, --styles <N>, -y
 
 ## Free Text Routing
 
-Free text 按优先级三层匹配。命中即停，不继续向下。
+Three-layer priority matching. Stop on first match — do not continue to lower layers.
 
-### Layer 1: 意图匹配单个命令 → Direct
+### Layer 1: Single command intent → Direct
 
-将用户描述与 Command Routing 表的 Description 列语义匹配。匹配最接近的**一个**命令。
+Semantically match user description against the Command Routing table's Description column. Match the closest **single** command.
+
+**Skip condition**: If the prompt also contains a Layer 2 chain keyword AND does not focus on a single design dimension, skip this layer.
+Example: `enhance colors and typography` — "enhance" is a chain keyword + multiple design dimensions → skip to Layer 2.
 
 | Intent signal | Command |
 |---------------|---------|
-| 评审, review, 检查UX, 评分, heuristic | critique |
-| 审计, a11y, 可访问性, 技术检查, performance audit, 代码质量 | audit |
-| 加动画, 动效, transitions, micro-interactions, 过渡 | animate |
-| 配色, 颜色, palette, 色彩, OKLCH, contrast | colorize |
-| 字体, 排版, typography, font, 字号, 行高 | typeset |
-| 布局, 间距, spacing, grid, 对齐, alignment, 视觉层次 | layout |
-| 太花, 太吵, tone down, 视觉噪音, 简洁点 | quieter |
-| 太平淡, 加强, 更大胆, more personality, 更有个性 | bolder |
-| 太复杂, 简化, strip, 去掉多余, cognitive load | distill |
-| 打磨, 微调, pixel perfect, final pass, 最终润色 | polish |
-| 文案, copy, 标签, 错误提示, UX writing, microcopy | clarify |
-| 响应式, mobile, 适配, breakpoints, touch targets | adapt |
-| 性能, loading, bundle, 卡顿, jank, 速度 | optimize |
-| 边界, error states, i18n, 溢出, 空状态加固 | harden |
-| 引导, 新手, 首次使用, onboarding, empty state, 激活 | onboard |
-| 趣味, 惊喜, personality, memorable, joy | delight |
-| 炫酷, 极限, extraordinary, 超常规, 技术极限 | overdrive |
-| 规划, plan UX, wireframe, 信息架构, 视觉方向 | shape |
-| 多风格, 变体, variants, compare styles, 风格对比 | explore |
-| 品牌定义, PRODUCT.md, 产品上下文 | teach |
-| 提取设计, DESIGN.md, 设计文档化 | document |
-| 提取组件, pull tokens, 设计系统提取 | extract |
-| 实时, browser iteration, 浏览器迭代 | live |
-
-### Layer 2: 具体构建任务 → Direct craft
-
-Layer 1 未命中，但意图是"构建/创建某个具体东西"：
-- 包含具体文件路径或目标（`d:\path`, `src/pages/`, `index.html`）
-- 包含详细视觉规格（布局、风格、配色方案）
-- 包含参考素材（`参考...`, `based on...`, `like...`）
-
-→ 路由到 **craft**（Direct）
-
-### Layer 3: 项目意图 → Chain
-
-Layer 1+2 未命中，意图是泛泛的项目方向：
+| review, check UX, score, heuristic, evaluate usability | critique |
+| audit, a11y, accessibility, technical check, performance audit, code quality | audit |
+| add animation, motion, transitions, micro-interactions | animate |
+| color, palette, OKLCH, contrast, color scheme | colorize |
+| font, typography, type scale, line height, font pairing | typeset |
+| layout, spacing, grid, alignment, visual hierarchy | layout |
+| too loud, tone down, visual noise, make it simpler, too busy | quieter |
+| too bland, bolder, more personality, stronger, more contrast | bolder |
+| too complex, simplify, strip, remove clutter, cognitive load | distill |
+| polish, fine-tune, pixel perfect, final pass, refine details | polish |
+| copy, labels, error messages, UX writing, microcopy, CTAs | clarify |
+| responsive, mobile, adapt, breakpoints, touch targets | adapt |
+| performance, loading, bundle, jank, speed, rendering | optimize |
+| edge cases, error states, i18n, overflow, empty state hardening | harden |
+| onboarding, first-run, empty state, activation, progressive disclosure | onboard |
+| fun, surprise, personality, memorable, joy, delight | delight |
+| extraordinary, push limits, ambitious effects, cutting-edge | overdrive |
+| plan UX, wireframe, information architecture, visual direction | shape |
+| multi-style, variants, compare styles, style comparison | explore |
+| brand definition, PRODUCT.md, product context | teach |
+| extract design, DESIGN.md, document design system | document |
+| pull tokens, extract components, design system extraction | extract |
+| real-time, browser iteration, live editing | live |
+
+### Layer 2: Project intent → Chain
+
+Layer 1 did not match. Check for chain-level keywords — even if the prompt also contains a specific target/path, chain matching takes priority.
 
 | Pattern | Chain |
 |---------|-------|
-| 新建, create, build, new, 从零开始 | build |
-| 重做, redesign, 重新设计, rethink, 换风格, 改版 | redesign |
-| 改进, improve, iterate, better, 迭代 | improve |
-| 增强, enhance, 视觉升级, visual upgrade | enhance |
-| 上线, launch, deploy, ship, 发布准备, production-ready | launch |
-| 加固, harden, 生产化, 边界情况 | harden |
-| 设计系统, design system, tokens, 设计规范, 设计基建 | foundation |
-| 实时, live, browser | live |
+| new, create, build, from scratch, start fresh | build |
+| redo, redesign, rethink, restyle, overhaul, revamp | redesign |
+| improve, iterate, better, refine overall | improve |
+| enhance, visual upgrade, level up | enhance |
+| launch, deploy, ship, production-ready, go live | launch |
+| harden, production-harden, edge cases | harden |
+| design system, tokens, design foundation, design infrastructure | foundation |
+| real-time, live, browser | live |
 
 Ambiguous + no `-y` → AskUserQuestion.
 
+### Layer 3: Concrete build task → Direct craft
+
+Layer 1+2 both did not match, but intent is to build/create a specific thing:
+- Contains a specific file path or target (`d:\path`, `src/pages/`, `index.html`)
+- Contains detailed visual specs (layout, style, color scheme)
+- Contains reference material (`based on...`, `like...`, `similar to...`)
+
+→ Route to **craft** (Direct)
+
 ## Prerequisites
 
 Before reading any command workflow:
@@ -162,23 +165,23 @@ Before reading any command workflow:
 ## Direct Execution
 
 1. Prerequisites ✓
-2. **显示执行信息**：
+2. **Display execution info**:
    ```
    ── Command: {command} ────────────────────
    Category: {category} | Target: {target}
    ─────────────────────────────────────────
    ```
 3. Read `~/.maestro/workflows/impeccable/{command}.md`
-4. **TodoWrite 跟踪**：按 workflow 文件中的主要阶段创建 todo 项
-   - 格式：`[{command}] {phase description}`
-   - 每个阶段完成后立即标记 completed
+4. **TodoWrite tracking**: create todo items for each major phase in the workflow file
+   - Format: `[{command}] {phase description}`
+   - Mark each phase completed immediately upon finishing
 5. Follow workflow file instructions
 6. Post: suggest logical next command (teach→shape, shape→craft, craft→critique, etc.)
 
 ## Chain Execution
 
 1. Prerequisites ✓
-2. **显示执行链**：解析 chain 定义，输出完整步骤预览：
+2. **Display chain preview**: parse chain definition, output full step preview:
    ```
    ── Chain: build ──────────────────────────
     1. teach        (conditional: PRODUCT.md missing)
@@ -192,31 +195,31 @@ Before reading any command workflow:
    ─────────────────────────────────────────
    Target: {target}
    ```
-   - `◆` 标记 quality gate 步骤，显示阈值
-   - `↺` 标记 refine loop，显示最大循环次数
-   - conditional 步骤注明触发条件
-   - 跳过的 conditional 步骤标记 `(skipped)`
+   - `◆` marks quality gate steps with threshold
+   - `↺` marks refine loop with max iteration count
+   - Conditional steps show trigger condition
+   - Skipped conditional steps marked `(skipped)`
 3. Create session: `.workflow/.maestro/ui-craft-{YYYYMMDD-HHmmss}/status.json`
    ```json
    { "chain_type": "...", "target": "...", "steps": [...], "current_step": 0,
      "gate_history": [], "loop_count": 0, "status": "running" }
    ```
-4. **TodoWrite 初始化**：为 chain 所有步骤创建 todo 项
-   - 每步一项，格式：`[chain] step N: {command} — {description}`
-   - conditional 步骤若跳过，立即标记 completed
-   - quality gate 步骤标注阈值：`[chain] step 5: critique ◆ gate ≥26/40`
+4. **TodoWrite init**: create todo items for all chain steps
+   - One item per step, format: `[chain] step N: {command} — {description}`
+   - If conditional step is skipped, immediately mark completed
+   - Quality gate steps include threshold: `[chain] step 5: critique ◆ gate ≥26/40`
 5. For each step:
    - Read `~/.maestro/workflows/impeccable/{command}.md` → execute
-   - **步骤开始**：TodoWrite 标记当前步骤 in_progress
-   - **步骤完成**：TodoWrite 标记 completed + update status.json (`current_step`, step `status`)
-   - **步骤失败**：TodoWrite 标记 completed(with note) + 记录原因
+   - **Step start**: TodoWrite marks current step in_progress
+   - **Step done**: TodoWrite marks completed + update status.json (`current_step`, step `status`)
+   - **Step failed**: TodoWrite marks completed (with note) + record reason
 6. **Quality gate** (critique/audit steps):
    - Parse score: critique `**Total** | | **N/40**`, audit `**Total** | | **N/20**`
    - Count `[P0]` / `[P1]` tags
    - Pass: score ≥ threshold AND P0 == 0 → advance
    - Fail: collect suggested commands from findings → execute → re-gate
    - Max loops exceeded → force advance with warning
-   - TodoWrite：gate 结果记入当前步骤备注（score, P0/P1 count, pass/fail）
+   - TodoWrite: record gate result in current step notes (score, P0/P1 count, pass/fail)
 7. Final report: scores + trend + commands executed
 
 ## Resume

package/.codex/skills/maestro-impeccable/SKILL.md

@@ -70,14 +70,14 @@ responsive-design.md, spatial-design.md, typography.md, ux-writing.md
 
 | Chain | Steps | Scenario |
 |-------|-------|----------|
-| build | teach? → explore? → shape → craft → critique → [refine] → audit → polish | 从零新建 |
-| redesign | document → explore → shape → craft → critique → [refine] → audit → polish | 基于现有代码重设计 |
-| improve | critique → [refine] → polish → audit | 迭代改进 |
-| enhance | {cmd...} → critique → [refine] → polish | 定向增强（支持多命令） |
-| launch | harden → adapt → optimize → audit → polish | 全方位上线准备 |
-| harden | harden → audit → polish | 边界加固 |
-| foundation | teach? → explore → document → extract | 纯设计系统建设 |
-| live | live | 实时迭代 |
+| build | teach? → explore? → shape → craft → critique → [refine] → audit → polish | New from scratch |
+| redesign | document → explore → shape → craft → critique → [refine] → audit → polish | Redesign existing code |
+| improve | critique → [refine] → polish → audit | Iterative improvement |
+| enhance | {cmd...} → critique → [refine] → polish | Targeted enhancement (multi-command) |
+| launch | harden → adapt → optimize → audit → polish | Full production readiness |
+| harden | harden → audit → polish | Edge case hardening |
+| foundation | teach? → explore → document → extract | Design system setup |
+| live | live | Real-time iteration |
 
 - `?` = conditional: teach if PRODUCT.md missing; explore if DESIGN.md missing and --skip-design not set
 - `[refine]` = quality gate loop: gate fails → auto-select fix commands from findings → re-gate
@@ -85,64 +85,67 @@ responsive-design.md, spatial-design.md, typography.md, ux-writing.md
 
 ## Free Text Routing
 
-Three-layer priority matching. Stop on first match.
+Three-layer priority matching. Stop on first match — do not continue to lower layers.
 
-### Layer 1: Intent matches single command → Direct
+### Layer 1: Single command intent → Direct
 
-Match user description against Command Routing descriptions. Route to the closest single command.
+Semantically match user description against the Command Routing table's Description column. Match the closest **single** command.
+
+**Skip condition**: If the prompt also contains a Layer 2 chain keyword AND does not focus on a single design dimension, skip this layer.
+Example: `enhance colors and typography` — "enhance" is a chain keyword + multiple design dimensions → skip to Layer 2.
 
 | Intent signal | Command |
 |---------------|---------|
-| review, UX check, heuristic, 评审, 评分 | critique |
-| a11y, audit, accessibility, performance audit, 技术检查 | audit |
-| animation, motion, transitions, 动效, 加动画 | animate |
-| color, palette, contrast, OKLCH, 配色, 颜色 | colorize |
-| typography, font, type scale, 字体, 排版 | typeset |
-| layout, spacing, grid, alignment, 布局, 间距 | layout |
-| tone down, too loud, 太花, 视觉噪音 | quieter |
-| too bland, bolder, more personality, 太平淡 | bolder |
-| simplify, strip, too complex, cognitive load, 太复杂 | distill |
-| polish, micro-adjust, pixel perfect, 打磨 | polish |
-| copy, labels, error messages, UX writing, 文案 | clarify |
-| responsive, mobile, breakpoints, 适配 | adapt |
-| performance, loading, bundle, jank, 性能 | optimize |
-| edge cases, error states, i18n, overflow, 边界 | harden |
-| onboarding, first-run, empty state, 引导 | onboard |
-| delight, personality, joy, memorable, 趣味 | delight |
-| extraordinary, push limits, 炫酷, 极限 | overdrive |
-| plan UX, wireframe, information architecture, 规划 | shape |
-| variants, compare styles, multi-style, 多风格 | explore |
-| PRODUCT.md, brand definition, 品牌定义 | teach |
-| DESIGN.md, design documentation, 设计文档 | document |
-| pull tokens, extract components, 提取组件 | extract |
-| browser iteration, 实时迭代 | live |
-
-### Layer 2: Concrete build task → Direct craft
-
-Layer 1 missed, but intent is "build/create specific thing":
-- Has specific file path or target
-- Has detailed visual specs (layout, style, palette)
-- Has reference material
-
-→ Route to **craft** (Direct)
-
-### Layer 3: Project intent → Chain
-
-Layer 1+2 missed, broad project direction:
+| review, check UX, score, heuristic, evaluate usability | critique |
+| audit, a11y, accessibility, technical check, performance audit, code quality | audit |
+| add animation, motion, transitions, micro-interactions | animate |
+| color, palette, OKLCH, contrast, color scheme | colorize |
+| font, typography, type scale, line height, font pairing | typeset |
+| layout, spacing, grid, alignment, visual hierarchy | layout |
+| too loud, tone down, visual noise, make it simpler, too busy | quieter |
+| too bland, bolder, more personality, stronger, more contrast | bolder |
+| too complex, simplify, strip, remove clutter, cognitive load | distill |
+| polish, fine-tune, pixel perfect, final pass, refine details | polish |
+| copy, labels, error messages, UX writing, microcopy, CTAs | clarify |
+| responsive, mobile, adapt, breakpoints, touch targets | adapt |
+| performance, loading, bundle, jank, speed, rendering | optimize |
+| edge cases, error states, i18n, overflow, empty state hardening | harden |
+| onboarding, first-run, empty state, activation, progressive disclosure | onboard |
+| fun, surprise, personality, memorable, joy, delight | delight |
+| extraordinary, push limits, ambitious effects, cutting-edge | overdrive |
+| plan UX, wireframe, information architecture, visual direction | shape |
+| multi-style, variants, compare styles, style comparison | explore |
+| brand definition, PRODUCT.md, product context | teach |
+| extract design, DESIGN.md, document design system | document |
+| pull tokens, extract components, design system extraction | extract |
+| real-time, browser iteration, live editing | live |
+
+### Layer 2: Project intent → Chain
+
+Layer 1 did not match. Check for chain-level keywords — even if the prompt also contains a specific target/path, chain matching takes priority.
 
 | Pattern | Chain |
 |---------|-------|
-| create, build, new, from scratch | build |
-| redesign, rethink, restyle | redesign |
-| improve, iterate, better | improve |
-| enhance, visual upgrade | enhance |
-| launch, deploy, ship, production-ready | launch |
-| harden, production, edge cases | harden |
-| design system, tokens, design spec | foundation |
-| live, browser | live |
+| new, create, build, from scratch, start fresh | build |
+| redo, redesign, rethink, restyle, overhaul, revamp | redesign |
+| improve, iterate, better, refine overall | improve |
+| enhance, visual upgrade, level up | enhance |
+| launch, deploy, ship, production-ready, go live | launch |
+| harden, production-harden, edge cases | harden |
+| design system, tokens, design foundation, design infrastructure | foundation |
+| real-time, live, browser | live |
 
 Ambiguous + no `-y` → `request_user_input`.
 
+### Layer 3: Concrete build task → Direct craft
+
+Layer 1+2 both did not match, but intent is to build/create a specific thing:
+- Contains a specific file path or target (`d:\path`, `src/pages/`, `index.html`)
+- Contains detailed visual specs (layout, style, color scheme)
+- Contains reference material (`based on...`, `like...`, `similar to...`)
+
+→ Route to **craft** (Direct)
+
 <invariants>
 1. Prerequisites before any design work — never skip context loading or register detection
 2. Read workflow file before execution — never execute a command without loading its .md
@@ -161,23 +164,23 @@ Before reading any command workflow:
 ## Direct Execution
 
 1. Prerequisites ✓
-2. **显示执行信息**：
+2. **Display execution info**:
    ```
    ── Command: {command} ────────────────────
    Category: {category} | Target: {target}
    ─────────────────────────────────────────
    ```
 3. Read `~/.maestro/workflows/impeccable/{command}.md`
-4. **TodoWrite 跟踪**：按 workflow 文件中的主要阶段创建 todo 项
-   - 格式：`[{command}] {phase description}`
-   - 每个阶段完成后立即标记 completed
+4. **Progress tracking**: create todo items for each major phase in the workflow file
+   - Format: `[{command}] {phase description}`
+   - Mark each phase completed immediately upon finishing
 5. Follow workflow file instructions
 6. Post: suggest logical next command (teach→shape, shape→craft, craft→critique, etc.)
 
 ## Chain Execution
 
 1. Prerequisites ✓
-2. **显示执行链**：解析 chain 定义，输出完整步骤预览：
+2. **Display chain preview**: parse chain definition, output full step preview:
    ```
    ── Chain: build ──────────────────────────
     1. teach        (conditional: PRODUCT.md missing)
@@ -191,31 +194,31 @@ Before reading any command workflow:
    ─────────────────────────────────────────
    Target: {target}
    ```
-   - `◆` 标记 quality gate 步骤，显示阈值
-   - `↺` 标记 refine loop，显示最大循环次数
-   - conditional 步骤注明触发条件
-   - 跳过的 conditional 步骤标记 `(skipped)`
+   - `◆` marks quality gate steps with threshold
+   - `↺` marks refine loop with max iteration count
+   - Conditional steps show trigger condition
+   - Skipped conditional steps marked `(skipped)`
 3. Create session: `.workflow/.maestro/ui-craft-{YYYYMMDD-HHmmss}/status.json`
    ```json
    { "chain_type": "...", "target": "...", "steps": [...], "current_step": 0,
      "gate_history": [], "loop_count": 0, "status": "running" }
    ```
-4. **TodoWrite 初始化**：为 chain 所有步骤创建 todo 项
-   - 每步一项，格式：`[chain] step N: {command} — {description}`
-   - conditional 步骤若跳过，立即标记 completed
-   - quality gate 步骤标注阈值：`[chain] step 5: critique ◆ gate ≥26/40`
+4. **Init tracking**: create todo items for all chain steps
+   - One item per step, format: `[chain] step N: {command} — {description}`
+   - If conditional step is skipped, immediately mark completed
+   - Quality gate steps include threshold: `[chain] step 5: critique ◆ gate ≥26/40`
 5. For each step:
    - Read `~/.maestro/workflows/impeccable/{command}.md` → execute
-   - **步骤开始**：TodoWrite 标记当前步骤 in_progress
-   - **步骤完成**：TodoWrite 标记 completed + update status.json (`current_step`, step `status`)
-   - **步骤失败**：TodoWrite 标记 completed(with note) + 记录原因
+   - **Step start**: mark current step in_progress
+   - **Step done**: mark completed + update status.json (`current_step`, step `status`)
+   - **Step failed**: mark completed (with note) + record reason
 6. **Quality gate** (critique/audit steps):
    - Parse score: critique `**Total** | | **N/40**`, audit `**Total** | | **N/20**`
    - Count `[P0]` / `[P1]` tags
    - Pass: score ≥ threshold AND P0 == 0 → advance
    - Fail: collect suggested commands from findings → execute → re-gate
    - Max loops exceeded → force advance with warning
-   - TodoWrite：gate 结果记入当前步骤备注（score, P0/P1 count, pass/fail）
+   - Record gate result in current step notes (score, P0/P1 count, pass/fail)
 7. Final report: scores + trend + commands executed
 
 ## Resume

package/dist/src/commands/hooks.d.ts

@@ -39,6 +39,16 @@ export type HookLevel = 'none' | 'minimal' | 'standard' | 'full';
 export declare const HOOK_LEVELS: readonly HookLevel[];
 export declare const HOOK_LEVEL_DESCRIPTIONS: Record<HookLevel, string>;
 export declare const HOOK_DEFS: Record<string, HookDef>;
+interface CodexHookDef {
+    event: 'SessionStart' | 'PreToolUse' | 'PostToolUse' | 'UserPromptSubmit' | 'Stop';
+    matcher?: string;
+    level: HookLevel;
+    requiresWorkspace?: boolean;
+    statusMessage?: string;
+    timeout?: number;
+}
+export declare const CODEX_HOOK_DEFS: Record<string, CodexHookDef>;
+export declare const CODEX_HOOK_LEVEL_DESCRIPTIONS: Record<HookLevel, string>;
 export declare function getClaudeSettingsPath(): string;
 export declare function loadClaudeSettings(settingsPath: string): ClaudeSettings;
 export declare function removeMaestroHooks(settings: ClaudeSettings): void;
@@ -73,6 +83,45 @@ export declare function installHooksByLevel(level: HookLevel, opts?: {
     settingsPath?: string;
     skipStatusline?: boolean;
 }): InstallHooksResult;
+interface CodexHookGroup {
+    matcher?: string;
+    hooks: Array<{
+        type: string;
+        command: string;
+        statusMessage?: string;
+        timeout?: number;
+    }>;
+}
+interface CodexHooksFile {
+    hooks?: {
+        SessionStart?: CodexHookGroup[];
+        PreToolUse?: CodexHookGroup[];
+        PostToolUse?: CodexHookGroup[];
+        UserPromptSubmit?: CodexHookGroup[];
+        Stop?: CodexHookGroup[];
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+export declare function getCodexHooksPath(opts?: {
+    project?: boolean;
+}): string;
+export declare function loadCodexHooks(hooksPath: string): CodexHooksFile;
+export declare function removeCodexMaestroHooks(hooksFile: CodexHooksFile): void;
+/**
+ * Check whether `codex_hooks = true` is set in config.toml.
+ * Returns true if the flag is found; prints a hint otherwise.
+ */
+export declare function checkCodexHooksFeatureFlag(opts?: {
+    project?: boolean;
+}): boolean;
+/**
+ * Install hooks at the given level into Codex hooks.json.
+ */
+export declare function installCodexHooksByLevel(level: HookLevel, opts?: {
+    project?: boolean;
+    hooksPath?: string;
+}): InstallHooksResult;
 export declare function registerHooksCommand(program: Command): void;
 export {};
 //# sourceMappingURL=hooks.d.ts.map

package/dist/src/commands/hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/commands/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA6BzC,UAAU,SAAS;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjD;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE;QACN,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;QACzB,WAAW,CAAC,EAAE,SAAS,EAAE,CAAC;QAC1B,gBAAgB,CAAC,EAAE,SAAS,EAAE,CAAC;QAC/B,YAAY,CAAC,EAAE,SAAS,EAAE,CAAC;QAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAMD,UAAU,OAAO;IACf,KAAK,EAAE,YAAY,GAAG,aAAa,GAAG,kBAAkB,GAAG,cAAc,GAAG,MAAM,CAAC;IACnF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,KAAK,EAAE,SAAS,CAAC;IACjB,sEAAsE;IACtE,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;AAEjE,eAAO,MAAM,WAAW,EAAE,SAAS,SAAS,EAA4C,CAAC;AAEzF,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAK7D,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAY7C,CAAC;AAaF,wBAAgB,qBAAqB,IAAI,MAAM,CAG9C;AAED,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,cAAc,CAGvE;AASD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAgBjE;AAkBD,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,KAAK,EAAE,SAAS,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,MAAM,GAAG,IAAI,CAMhF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,GAAE;IACtC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CACX,GAAG,MAAM,CAoBd;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,SAAS,EAChB,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,OAAO,CAAA;CAAO,GAChF,kBAAkB,CA2CpB;AA0RD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmL3D"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/commands/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA6BzC,UAAU,SAAS;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjD;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE;QACN,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;QACzB,WAAW,CAAC,EAAE,SAAS,EAAE,CAAC;QAC1B,gBAAgB,CAAC,EAAE,SAAS,EAAE,CAAC;QAC/B,YAAY,CAAC,EAAE,SAAS,EAAE,CAAC;QAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAMD,UAAU,OAAO;IACf,KAAK,EAAE,YAAY,GAAG,aAAa,GAAG,kBAAkB,GAAG,cAAc,GAAG,MAAM,CAAC;IACnF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,KAAK,EAAE,SAAS,CAAC;IACjB,sEAAsE;IACtE,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;AAEjE,eAAO,MAAM,WAAW,EAAE,SAAS,SAAS,EAA4C,CAAC;AAEzF,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAK7D,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAY7C,CAAC;AAMF,UAAU,YAAY;IACpB,KAAK,EAAE,cAAc,GAAG,YAAY,GAAG,aAAa,GAAG,kBAAkB,GAAG,MAAM,CAAC;IACnF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,SAAS,CAAC;IACjB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAUxD,CAAC;AAEF,eAAO,MAAM,6BAA6B,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAKnE,CAAC;AAaF,wBAAgB,qBAAqB,IAAI,MAAM,CAG9C;AAED,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,cAAc,CAGvE;AASD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAgBjE;AAkBD,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,KAAK,EAAE,SAAS,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,MAAM,GAAG,IAAI,CAMhF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,GAAE;IACtC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CACX,GAAG,MAAM,CAoBd;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,SAAS,EAChB,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,OAAO,CAAA;CAAO,GAChF,kBAAkB,CA2CpB;AAMD,UAAU,cAAc;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC3F;AAED,UAAU,cAAc;IACtB,KAAK,CAAC,EAAE;QACN,YAAY,CAAC,EAAE,cAAc,EAAE,CAAC;QAChC,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;QAC9B,WAAW,CAAC,EAAE,cAAc,EAAE,CAAC;QAC/B,gBAAgB,CAAC,EAAE,cAAc,EAAE,CAAC;QACpC,IAAI,CAAC,EAAE,cAAc,EAAE,CAAC;QACxB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,wBAAgB,iBAAiB,CAAC,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,MAAM,CAI1E;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,CAIhE;AAED,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,cAAc,GAAG,IAAI,CAiBvE;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAOpF;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,SAAS,EAChB,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACnD,kBAAkB,CAwCpB;AA0RD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA8O3D"}