coding-os 0.3.2__py3-none-any.whl

adapters/codex/hooks/codex-pretool-dispatch.sh

@@ -0,0 +1,82 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+export COS_AGENT=codex
+HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
+source "$HOOK_DIR/cos-env.sh" 2>/dev/null || source "$HOOK_DIR/../../../core/hooks/cos-env.sh" 2>/dev/null || true
+if ! command -v cos_log_hook >/dev/null 2>&1; then
+  cos_log_hook() { :; }
+fi
+
+INPUT=$(cat)
+if command -v cos_panel_upgrade_from_payload >/dev/null 2>&1; then
+  cos_panel_upgrade_from_payload "$INPUT" >/dev/null 2>&1 || true
+fi
+cos_log_hook codex-pretool-dispatch fire "tool=Bash"
+
+WORK_DIR="$(mktemp -d "${TMPDIR:-/tmp}/codex-pretool.XXXXXX")"
+trap 'rm -rf "$WORK_DIR"' EXIT
+OUTPUTS=()
+RUN_INDEX=0
+
+delegate_path() {
+  local delegate="$1"
+  if [[ -f "$HOOK_DIR/$delegate" ]]; then
+    printf '%s\n' "$HOOK_DIR/$delegate"
+  else
+    printf '%s\n' "$HOOK_DIR/../../../core/hooks/$delegate"
+  fi
+}
+
+run_delegate() {
+  local delegate="$1"
+  local stdout_file stderr_file rc
+  RUN_INDEX=$((RUN_INDEX + 1))
+  stdout_file="$WORK_DIR/$RUN_INDEX.out"
+  stderr_file="$WORK_DIR/$RUN_INDEX.err"
+
+  set +e
+  bash "$(delegate_path "$delegate")" <<< "$INPUT" >"$stdout_file" 2>"$stderr_file"
+  rc=$?
+  set -e
+
+  [[ -s "$stdout_file" ]] && OUTPUTS+=("$stdout_file")
+  [[ -s "$stderr_file" ]] && cat "$stderr_file" >&2
+  if [[ "$rc" -eq 0 ]]; then
+    return 0
+  fi
+  if [[ "$rc" -eq 2 ]]; then
+    cos_log_hook codex-pretool-dispatch block "delegate=${delegate}"
+    exit 2
+  fi
+
+  cos_log_hook codex-pretool-dispatch warn "delegate=${delegate} rc=${rc}"
+  return 0
+}
+
+for delegate in \
+  block-secrets.sh \
+  block-dangerous-commands.sh \
+  branch-guard.sh \
+  enforce-commit-message.sh \
+  block-uv-heredoc.sh \
+  enforce-verify.sh \
+  test-governor.sh \
+  search-enforce-inventory.sh \
+  nudge-task-discovery.sh \
+  warn-diff-size.sh \
+  agent-presence.sh; do
+  run_delegate "$delegate"
+done
+
+MERGER="$HOOK_DIR/codex-merge-hook-output.py"
+if [[ ! -f "$MERGER" ]]; then
+  SCRIPT_SOURCE="${BASH_SOURCE[0]}"
+  while [[ -L "$SCRIPT_SOURCE" ]]; do
+    SOURCE_DIR="$(cd -P "$(dirname "$SCRIPT_SOURCE")" && pwd)"
+    SCRIPT_SOURCE="$(readlink "$SCRIPT_SOURCE")"
+    [[ "$SCRIPT_SOURCE" != /* ]] && SCRIPT_SOURCE="$SOURCE_DIR/$SCRIPT_SOURCE"
+  done
+  MERGER="$(cd -P "$(dirname "$SCRIPT_SOURCE")" && pwd)/codex-merge-hook-output.py"
+fi
+python3 "$MERGER" PreToolUse "${OUTPUTS[@]}"

adapters/codex/hooks/codex-sessionend-dispatch.sh

@@ -0,0 +1,20 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+export COS_AGENT=codex
+HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
+source "$HOOK_DIR/cos-env.sh" 2>/dev/null || source "$HOOK_DIR/../../../core/hooks/cos-env.sh" 2>/dev/null || true
+
+INPUT="$(cos_read_stdin_bounded 2)"
+if command -v cos_panel_upgrade_from_payload >/dev/null 2>&1; then
+  cos_panel_upgrade_from_payload "$INPUT" >/dev/null 2>&1 || true
+fi
+
+for delegate in agent-presence.sh; do
+  if [[ -f "$HOOK_DIR/$delegate" ]]; then
+    DELEGATE_PATH="$HOOK_DIR/$delegate"
+  else
+    DELEGATE_PATH="$HOOK_DIR/../../../core/hooks/$delegate"
+  fi
+  bash "$DELEGATE_PATH" <<<"$INPUT"
+done

adapters/codex/hooks/codex-sessionstart-dispatch.sh

@@ -0,0 +1,68 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+export COS_AGENT=codex
+HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
+source "$HOOK_DIR/cos-env.sh" 2>/dev/null || source "$HOOK_DIR/../../../core/hooks/cos-env.sh" 2>/dev/null || true
+if ! command -v cos_log_hook >/dev/null 2>&1; then
+  cos_log_hook() { :; }
+fi
+
+INPUT=$(cat)
+SOURCE=$(echo "$INPUT" | jq -r '.source // "startup"' 2>/dev/null || echo "startup")
+if command -v cos_panel_upgrade_from_payload >/dev/null 2>&1; then
+  cos_panel_upgrade_from_payload "$INPUT" >/dev/null 2>&1 || true
+fi
+cos_log_hook codex-sessionstart-dispatch fire "source=${SOURCE}"
+
+WORK_DIR="$(mktemp -d "${TMPDIR:-/tmp}/codex-sessionstart.XXXXXX")"
+trap 'rm -rf "$WORK_DIR"' EXIT
+OUTPUTS=()
+RUN_INDEX=0
+
+delegate_path() {
+  local delegate="$1"
+  if [[ -f "$HOOK_DIR/$delegate" ]]; then
+    printf '%s\n' "$HOOK_DIR/$delegate"
+  else
+    printf '%s\n' "$HOOK_DIR/../../../core/hooks/$delegate"
+  fi
+}
+
+for delegate in \
+  session-context.sh \
+  warn-mcp-down.sh \
+  check-mcp-extras.sh \
+  rules-primer.sh \
+  session-skill-primer.sh \
+  remind-daily.sh \
+  warn-graph-empty.sh \
+  auto-brain-decay.sh \
+  agent-presence.sh \
+  pr-reap.sh; do
+  DELEGATE_PATH="$(delegate_path "$delegate")"
+  RUN_INDEX=$((RUN_INDEX + 1))
+  OUTPUT="$WORK_DIR/$RUN_INDEX.out"
+  ERROR="$WORK_DIR/$RUN_INDEX.err"
+  set +e
+  bash "$DELEGATE_PATH" <<<"$INPUT" >"$OUTPUT" 2>"$ERROR"
+  RC=$?
+  set -e
+  [[ -s "$OUTPUT" ]] && OUTPUTS+=("$OUTPUT")
+  [[ -s "$ERROR" ]] && cat "$ERROR" >&2
+  if [[ "$RC" -ne 0 ]]; then
+    cos_log_hook codex-sessionstart-dispatch warn "delegate=${delegate} source=${SOURCE}"
+  fi
+done
+
+MERGER="$HOOK_DIR/codex-merge-hook-output.py"
+if [[ ! -f "$MERGER" ]]; then
+  SCRIPT_SOURCE="${BASH_SOURCE[0]}"
+  while [[ -L "$SCRIPT_SOURCE" ]]; do
+    SOURCE_DIR="$(cd -P "$(dirname "$SCRIPT_SOURCE")" && pwd)"
+    SCRIPT_SOURCE="$(readlink "$SCRIPT_SOURCE")"
+    [[ "$SCRIPT_SOURCE" != /* ]] && SCRIPT_SOURCE="$SOURCE_DIR/$SCRIPT_SOURCE"
+  done
+  MERGER="$(cd -P "$(dirname "$SCRIPT_SOURCE")" && pwd)/codex-merge-hook-output.py"
+fi
+python3 "$MERGER" SessionStart "${OUTPUTS[@]}"

adapters/codex/hooks/codex-stop-dispatch.sh

@@ -0,0 +1,73 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+export COS_AGENT=codex
+HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
+source "$HOOK_DIR/cos-env.sh" 2>/dev/null || source "$HOOK_DIR/../../../core/hooks/cos-env.sh" 2>/dev/null || true
+if ! command -v cos_log_hook >/dev/null 2>&1; then
+  cos_log_hook() { :; }
+fi
+
+INPUT=$(cat)
+if command -v cos_panel_upgrade_from_payload >/dev/null 2>&1; then
+  cos_panel_upgrade_from_payload "$INPUT" >/dev/null 2>&1 || true
+fi
+cos_log_hook codex-stop-dispatch fire
+
+WORK_DIR="$(mktemp -d "${TMPDIR:-/tmp}/codex-stop.XXXXXX")"
+trap 'rm -rf "$WORK_DIR"' EXIT
+OUTPUTS=()
+RUN_INDEX=0
+
+delegate_path() {
+  local delegate="$1"
+  if [[ -f "$HOOK_DIR/$delegate" ]]; then
+    printf '%s\n' "$HOOK_DIR/$delegate"
+  else
+    printf '%s\n' "$HOOK_DIR/../../../core/hooks/$delegate"
+  fi
+}
+
+run_delegate() {
+  local delegate="$1"
+  local stdout_file stderr_file rc
+  RUN_INDEX=$((RUN_INDEX + 1))
+  stdout_file="$WORK_DIR/$RUN_INDEX.out"
+  stderr_file="$WORK_DIR/$RUN_INDEX.err"
+
+  set +e
+  bash "$(delegate_path "$delegate")" <<< "$INPUT" >"$stdout_file" 2>"$stderr_file"
+  rc=$?
+  set -e
+
+  [[ -s "$stdout_file" ]] && OUTPUTS+=("$stdout_file")
+  if [[ -s "$stderr_file" ]]; then
+    cat "$stderr_file" >&2
+  fi
+  if [[ "$rc" -eq 0 ]]; then
+    return 0
+  fi
+  if [[ "$rc" -eq 2 ]]; then
+    cos_log_hook codex-stop-dispatch block "delegate=${delegate}"
+    exit 2
+  fi
+
+  cos_log_hook codex-stop-dispatch warn "delegate=${delegate} rc=${rc}"
+  return 0
+}
+
+for delegate in session-end.sh warn-abandoned-task.sh nudge-learn-narrative.sh check-capture-worked.sh auto-trace-rotate.sh snapshot-transcript.sh drain-embedding-outbox.sh agent-presence.sh; do
+  run_delegate "$delegate"
+done
+
+MERGER="$HOOK_DIR/codex-merge-hook-output.py"
+if [[ ! -f "$MERGER" ]]; then
+  SCRIPT_SOURCE="${BASH_SOURCE[0]}"
+  while [[ -L "$SCRIPT_SOURCE" ]]; do
+    SOURCE_DIR="$(cd -P "$(dirname "$SCRIPT_SOURCE")" && pwd)"
+    SCRIPT_SOURCE="$(readlink "$SCRIPT_SOURCE")"
+    [[ "$SCRIPT_SOURCE" != /* ]] && SCRIPT_SOURCE="$SOURCE_DIR/$SCRIPT_SOURCE"
+  done
+  MERGER="$(cd -P "$(dirname "$SCRIPT_SOURCE")" && pwd)/codex-merge-hook-output.py"
+fi
+python3 "$MERGER" Stop "${OUTPUTS[@]}"

adapters/codex/hooks/codex-userpromptsubmit-dispatch.sh

@@ -0,0 +1,74 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+export COS_AGENT=codex
+HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
+source "${HOOK_DIR}/cos-env.sh" 2>/dev/null || source "${HOOK_DIR}/../../../core/hooks/cos-env.sh" 2>/dev/null || true
+if ! command -v cos_log_hook >/dev/null 2>&1; then cos_log_hook() { :; }; fi
+
+INPUT="$(cat 2>/dev/null || true)"
+if command -v cos_panel_upgrade_from_payload >/dev/null 2>&1; then
+  cos_panel_upgrade_from_payload "$INPUT" >/dev/null 2>&1 || true
+fi
+WORK_DIR="$(mktemp -d "${TMPDIR:-/tmp}/codex-userprompt.XXXXXX")"
+trap 'rm -rf "$WORK_DIR"' EXIT
+OUTPUTS=()
+RUN_INDEX=0
+
+delegate_path() {
+  local name="$1"
+  if [[ -f "${HOOK_DIR}/${name}" ]]; then
+    printf '%s\n' "${HOOK_DIR}/${name}"
+  else
+    printf '%s\n' "${HOOK_DIR}/../../../core/hooks/${name}"
+  fi
+}
+
+run_delegate() {
+  local name="$1"
+  local path output error rc
+  path="$(delegate_path "$name")"
+  if [[ ! -x "$path" ]]; then
+    return 0
+  fi
+  RUN_INDEX=$((RUN_INDEX + 1))
+  output="$WORK_DIR/$RUN_INDEX.out"
+  error="$WORK_DIR/$RUN_INDEX.err"
+  set +e
+  bash "$path" <<<"$INPUT" >"$output" 2>"$error"
+  rc=$?
+  set -e
+  [[ -s "$output" ]] && OUTPUTS+=("$output")
+  [[ -s "$error" ]] && cat "$error" >&2
+  if [[ "$rc" -ne 0 ]]; then
+    cos_log_hook codex-userpromptsubmit-dispatch warn "delegate=${name} rc=${rc}"
+  fi
+  return 0
+}
+
+for delegate in \
+  session-context.sh \
+  classify-task-mode.sh \
+  nudge-thinking-os.sh \
+  nudge-graph-os.sh \
+  nudge-model-routing.sh \
+  nudge-git-mode.sh \
+  nudge-reentry.sh \
+  nudge-task-discovery.sh \
+  nudge-docs-first.sh \
+  auto-compose-roles.sh \
+  agent-presence.sh; do
+  run_delegate "$delegate"
+done
+
+MERGER="$HOOK_DIR/codex-merge-hook-output.py"
+if [[ ! -f "$MERGER" ]]; then
+  SCRIPT_SOURCE="${BASH_SOURCE[0]}"
+  while [[ -L "$SCRIPT_SOURCE" ]]; do
+    SOURCE_DIR="$(cd -P "$(dirname "$SCRIPT_SOURCE")" && pwd)"
+    SCRIPT_SOURCE="$(readlink "$SCRIPT_SOURCE")"
+    [[ "$SCRIPT_SOURCE" != /* ]] && SCRIPT_SOURCE="$SOURCE_DIR/$SCRIPT_SOURCE"
+  done
+  MERGER="$(cd -P "$(dirname "$SCRIPT_SOURCE")" && pwd)/codex-merge-hook-output.py"
+fi
+python3 "$MERGER" UserPromptSubmit "${OUTPUTS[@]}"

adapters/codex/hooks.template.json

@@ -0,0 +1,208 @@
+{
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "env COS_AGENT=codex \"{{HOOKS_DIR}}/codex-pretool-dispatch.sh\""
+          }
+        ]
+      },
+      {
+        "matcher": "Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "env COS_AGENT=codex \"{{HOOKS_DIR}}/codex-preedit-dispatch.sh\""
+          }
+        ]
+      },
+      {
+        "matcher": "mcp__coding-os__cos_task_move",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "env COS_AGENT=codex \"{{HOOKS_DIR}}/inject-mcp-caller-session.sh\"",
+            "statusMessage": "🪪 Attributing task move to this panel...",
+            "timeout": 5
+          }
+        ]
+      },
+      {
+        "matcher": "mcp__coding-os__cos_task_create",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "env COS_AGENT=codex \"{{HOOKS_DIR}}/inject-mcp-caller-session.sh\"",
+            "statusMessage": "🪪 Attributing task create to this panel...",
+            "timeout": 5
+          }
+        ]
+      },
+      {
+        "matcher": "mcp__coding-os__cos_work_log_append",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "env COS_AGENT=codex \"{{HOOKS_DIR}}/inject-mcp-caller-session.sh\"",
+            "statusMessage": "🪪 Attributing work-log to this panel...",
+            "timeout": 5
+          }
+        ]
+      },
+      {
+        "matcher": "Read",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "env COS_AGENT=codex \"{{HOOKS_DIR}}/enforce-graph-first-read.sh\"",
+            "statusMessage": "🧭 Checking graph-first discipline before Read...",
+            "timeout": 10
+          },
+          {
+            "type": "command",
+            "command": "env COS_AGENT=codex \"{{HOOKS_DIR}}/nudge-task-discovery.sh\"",
+            "statusMessage": "🗂️ Suggesting cos task-show over a docs/tasks Read...",
+            "timeout": 10
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "env COS_AGENT=codex \"{{HOOKS_DIR}}/codex-posttool-dispatch.sh\""
+          }
+        ]
+      },
+      {
+        "matcher": "Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "env COS_AGENT=codex \"{{HOOKS_DIR}}/codex-postedit-dispatch.sh\""
+          }
+        ]
+      },
+      {
+        "matcher": "mcp__coding-os__cos_task_move",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "env COS_AGENT=codex \"{{HOOKS_DIR}}/sync-task-current.sh\"",
+            "statusMessage": "📌 Syncing .task-current...",
+            "timeout": 10
+          }
+        ]
+      },
+      {
+        "matcher": "mcp__coding-os__cos_backtrack_log",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "env COS_AGENT=codex \"{{HOOKS_DIR}}/track-backtrack.sh\"",
+            "statusMessage": "↩️ Backtrack counter updated...",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "SessionStart": [
+      {
+        "matcher": "startup",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "env COS_AGENT=codex \"{{HOOKS_DIR}}/codex-sessionstart-dispatch.sh\"",
+            "statusMessage": "🚀 Loading session context + MCP health..."
+          }
+        ]
+      },
+      {
+        "matcher": "compact|resume",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "env COS_AGENT=codex \"{{HOOKS_DIR}}/codex-sessionstart-dispatch.sh\"",
+            "statusMessage": "🔄 Recovering workflow context + MCP health..."
+          }
+        ]
+      },
+      {
+        "matcher": "clear",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "env COS_AGENT=codex \"{{HOOKS_DIR}}/codex-sessionstart-dispatch.sh\"",
+            "statusMessage": "Loading clean session context..."
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "env COS_AGENT=codex \"{{HOOKS_DIR}}/codex-userpromptsubmit-dispatch.sh\""
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "env COS_AGENT=codex \"{{HOOKS_DIR}}/codex-stop-dispatch.sh\"",
+            "statusMessage": "📝 Finalizing session recap + memory enrichment...",
+            "timeout": 5000
+          }
+        ]
+      }
+    ],
+    "SubagentStart": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "env COS_AGENT=codex \"{{HOOKS_DIR}}/agent-presence.sh\"",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "SubagentStop": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "env COS_AGENT=codex \"{{HOOKS_DIR}}/agent-presence.sh\"",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "SessionEnd": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "env COS_AGENT=codex \"{{HOOKS_DIR}}/codex-sessionend-dispatch.sh\"",
+            "timeout": 3
+          }
+        ]
+      }
+    ]
+  }
+}

adapters/codex/install.sh

@@ -0,0 +1,83 @@
+#!/usr/bin/env bash
+# Codex adapter installer for coding-os.
+#
+# Thin wrapper: delegates the common install work (dirs, hooks, rules,
+# skills, commands, role prompts, agent identity) to
+# src/core/scripts/install-adapter.sh, then performs Codex-specific
+# finalization (.codex/hooks.json render, project-local config.toml
+# with hooks feature flag + MCP server entry).
+#
+# Why Codex-specific finalization stays here:
+#   • hooks.json is generated from registry.yaml-rendered template via
+#     `make regen-adapter-templates`; install.sh just substitutes the
+#     absolute hooks path so commands resolve from any cwd.
+#   • Codex enables hooks via the `hooks = true` flag in
+#     `.codex/config.toml` (see developers.openai.com/codex/hooks).
+#   • MCP servers for Codex are project-scoped via the same TOML.
+set -euo pipefail
+shopt -s nullglob
+
+CODING_OS_ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
+PROJECT_ROOT="${PWD}"
+
+echo "⚙️  Installing coding-os Codex adapter..."
+
+# 1-8. Common install steps (shared with claude).
+bash "${CODING_OS_ROOT}/core/scripts/install-adapter.sh" \
+  --adapter codex --agent-dir .codex \
+  --coding-os-root "$CODING_OS_ROOT" --project-root "$PROJECT_ROOT"
+
+# 9. .codex/hooks.json from registry-rendered template.
+# Use absolute hook paths so a Codex session launched in a nested cwd
+# still resolves the script. (Codex runs `sh -c <command>` with the
+# session cwd, not the project root.)
+TEMPLATE="${CODING_OS_ROOT}/adapters/codex/hooks.template.json"
+HOOKS_ABS="${PROJECT_ROOT}/.codex/hooks"
+HOOKS_ESCAPED=$(printf '%s' "$HOOKS_ABS" | sed 's/[&|]/\\&/g')
+sed "s|{{HOOKS_DIR}}|${HOOKS_ESCAPED}|g" "$TEMPLATE" > "${PROJECT_ROOT}/.codex/hooks.json"
+
+# 10. Drop legacy .codex/instructions.md from older adapter versions.
+# It was never a real Codex convention and Codex CLI doesn't load it.
+# AGENTS.md at the project root replaces it.
+if [[ -f "${PROJECT_ROOT}/.codex/instructions.md" ]]; then
+  rm -f "${PROJECT_ROOT}/.codex/instructions.md"
+fi
+
+# 11. Project-local .codex/config.toml — feature flag + MCP server entry.
+CODEX_CONFIG="${PROJECT_ROOT}/.codex/config.toml"
+mkdir -p "${PROJECT_ROOT}/.codex"
+
+ENABLE_HELPER="${CODING_OS_ROOT}/adapters/codex/enable_codex_hooks.py"
+if [[ -x "$ENABLE_HELPER" || -f "$ENABLE_HELPER" ]]; then
+  HOOKS_STATUS="$(python3 "$ENABLE_HELPER" "$CODEX_CONFIG" 2>&1 || echo 'failed to enable hooks (see stderr)')"
+else
+  HOOKS_STATUS="helper missing at $ENABLE_HELPER"
+fi
+
+MCP_HELPER="${CODING_OS_ROOT}/adapters/codex/ensure_codex_mcp.py"
+if command -v cos >/dev/null 2>&1; then
+  MCP_CMD="cos"
+  MCP_ARGS=("server-start")
+else
+  # Pre-`uv tool install` fallback. Use the current Python interpreter so
+  # MCP startup does not depend on uv cache access inside Codex's sandbox.
+  PYTHON_BIN="$(python3 -c 'import sys; print(sys.executable)')"
+  MCP_CMD="$PYTHON_BIN"
+  MCP_ARGS=("${CODING_OS_ROOT}/core/thinking_os/server.py")
+fi
+
+if [[ -x "$MCP_HELPER" || -f "$MCP_HELPER" ]]; then
+  MCP_STATUS="$(python3 "$MCP_HELPER" "$CODEX_CONFIG" "$MCP_CMD" "${MCP_ARGS[@]}" 2>&1 || echo 'failed to configure coding-os MCP (see stderr)')"
+else
+  MCP_STATUS="helper missing at $MCP_HELPER"
+fi
+
+echo ""
+echo "✅ Codex adapter installed."
+echo "  Hooks config: .codex/hooks.json (generated)"
+echo "  SSOT:         AGENTS.md at project root (read by Codex)"
+echo "  Hooks flag:   ${HOOKS_STATUS}"
+echo "  MCP:          ${MCP_STATUS}"
+echo ""
+echo "ACTION: Start Codex and run /hooks to review and trust the installed project hooks."
+echo "        Repeat that review whenever a hook file changes; Codex keys trust to its hash."