Specrew

0.38.0

hosts/codex/host.psd1

                                @{

    # Identity

    Kind          = 'codex'

    DisplayName   = 'OpenAI Codex CLI'

    Status        = 'supported'

    SchemaVersion = 1

    MenuPriority  = 2  # Interactive host-selection menu priority (iter-011)

    # Binary detection

    Binary           = 'codex'

    InstallUrl       = 'https://developers.openai.com/codex/cli'

    InstallGuidance  = 'Codex CLI not found on PATH. Install: https://developers.openai.com/codex/cli'

    # Runtime layout

    SkillRoot                  = '.agents/skills'

    HasUserSlashCommandSurface = $false   # FR-013: Codex has no user-defined slash-command surface

    SharedSkillRootWith        = @('antigravity')

    AgentDir                   = '.codex/agents/'

    InstructionsFile           = 'AGENTS.md'

    StructuredQuestionPrimitive = 'request_user_input'

    StructuredQuestionGuidance  = 'Use the Codex structured user-input/menu primitive for human approval gates when it is available in the current session.'

    # Spec-kit + Squad coupling

    SpeckitAiFlag  = 'codex'

    PreferredAgent = 'codex'

    # Phase B handler file (not yet present)

    HandlersFile         = 'handlers.ps1'

    CoordinatorRulesFile = 'coordinator-rules.psd1'

    # Feature 171 (FR-013, T014): refocus hook bindings — FULL TRIAD. Verified

    # live 2026-06-07 (research-matrix.md): SessionStart matchers identical to

    # Claude (startup|resume|clear|compact) route B1/B2; UserPromptSubmit

    # (additionalContext) is the per-human-prompt B3 carrier. PreToolUse dormant.

    RefocusHookBindings = @{

        BoundTriggers  = @('b1', 'b2', 'b3')

        Events         = @('SessionStart', 'UserPromptSubmit')

        SettingsFile   = '~/.codex/hooks.json'   # user-level; dispatcher self-gates per project

        OptOutMarkerFile = '.specrew/runtime/refocus-hooks-optout-codex'

        DispatcherPath = '.specify/extensions/specrew-speckit/scripts/specrew-hook-dispatcher.ps1'

        ConfigShape    = 'event-map'

        CommandMode    = 'launcher-file'

        MigrateLegacyTopLevelEventMap = $true

        DispatcherRuntime = @{

            BootstrapDeliveryEvents = @('SessionStart')

            B3DeliveryEvents        = @('PostToolUse', 'UserPromptSubmit')

            RefocusTriggerByEvent   = @{ PostToolUse = 'b3'; UserPromptSubmit = 'b3' }

            SuppressedRefocusEvents = @()

            OutputShape             = 'hookSpecificOutput'

            DecisionOnlyEvents      = @()

            BootstrapDeliveryMode   = 'pointer'

        }

        Registrations  = @(

            @{ Event = 'SessionStart'; DispatcherEvent = 'SessionStart'; HandlerShape = 'hooks-array'; Timeout = 30 },

            @{ Event = 'UserPromptSubmit'; DispatcherEvent = 'UserPromptSubmit'; HandlerShape = 'hooks-array'; Timeout = 30 },

            @{ Event = 'Stop'; DispatcherEvent = 'Stop'; HandlerShape = 'hooks-array'; Timeout = 30 }

        )

    }

}