omniconductor 0.6.0 → 1.0.1

package/adapters/claude/transform.sh

@@ -34,6 +34,7 @@ set -eu
 
 TARGET=""
 RECIPES=""
+MODE="full"
 DRY_RUN="false"
 MEASURE_BASELINE="false"
 NO_PROMPT="false"
@@ -48,6 +49,7 @@ WIZARD_SHOW_ANTI_PATTERNS="false"
 while [ $# -gt 0 ]; do
   case "$1" in
     --recipes=*) RECIPES="${1#--recipes=}" ;;
+    --mode=*)    MODE="${1#--mode=}" ;;
     --dry-run)   DRY_RUN="true" ;;
     --measure-baseline) MEASURE_BASELINE="true" ;;
     --no-prompt) NO_PROMPT="true" ;;
@@ -60,6 +62,11 @@ Usage: bash adapters/claude/transform.sh <target-project> [options]
 
 Options:
   --recipes=A,B,C       Comma-separated list of recipes to install
+  --mode=<m>            Install preset (ADR-044): full (default) | minimal (rules + recipes
+                        text + docs + CLAUDE.md; no agents/hooks/hookify) | strict (abort if
+                        CLAUDE.md exists) | recipes-only (ONLY the selected recipe rule files;
+                        requires --recipes=) | reflector-only (self-improvement loop standalone:
+                        recipe + reflector agent + trajectory hook + /reflect)
   --dry-run             Preview only — no files written
   --measure-baseline    After install, measure cache token baseline (opt-in)
   --no-prompt           Skip all interactive prompts; apply sensible defaults (CI-safe)
@@ -92,12 +99,32 @@ if [ -z "$TARGET" ]; then
   exit 1
 fi
 
+case "$MODE" in
+  full|minimal|strict|recipes-only|reflector-only) : ;;
+  *) echo "Error: unknown --mode '$MODE' (one of: full, minimal, strict, recipes-only, reflector-only)" >&2; exit 1 ;;
+esac
+if [ "$MODE" = "reflector-only" ]; then
+  if [ -n "$RECIPES" ] && [ "$RECIPES" != "self-improvement" ]; then
+    echo "NOTE: --mode=reflector-only ignores --recipes (installs self-improvement only)" >&2
+  fi
+  RECIPES="self-improvement"
+fi
+if [ "$MODE" = "recipes-only" ] && [ -z "$RECIPES" ] && [ "$UNINSTALL" != "true" ]; then
+  echo "Error: --mode=recipes-only requires --recipes=A,B,..." >&2
+  exit 1
+fi
+
 # Resolve CONDUCTOR root (where this script lives: adapters/claude/).
 CONDUCTOR_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
 CORE_ROOT="$CONDUCTOR_ROOT/core"
 TOOLS_ROOT="$CONDUCTOR_ROOT/tools"
 [ -d "$CORE_ROOT" ] || { echo "Error: core/ not found at $CORE_ROOT" >&2; exit 1; }
 
+# CONDUCTOR package version for the manifest — parsed at runtime from package.json
+# so releases never drift the manifest (falls back to "unknown" on any error).
+CONDUCTOR_VERSION="$(/usr/bin/sed -n -E 's/^[[:space:]]*"version"[[:space:]]*:[[:space:]]*"([^"]+)".*/\1/p' "$CONDUCTOR_ROOT/package.json" 2>/dev/null | /usr/bin/head -n 1)"
+[ -n "$CONDUCTOR_VERSION" ] || CONDUCTOR_VERSION="unknown"
+
 if [ "$DRY_RUN" = "true" ]; then
   mkdir -p "$TARGET"
 fi
@@ -243,7 +270,7 @@ backup_if_exists() {
 # Manifest is generated using only POSIX shell (no jq dependency). Format:
 #
 #   {
-#     "version": "v0.2.0",
+#     "version": "v<CONDUCTOR package.json version>",
 #     "install_timestamp": "2026-05-10T12:00:00Z",
 #     "conductor_root": "/abs/path/to/conductor",
 #     "recipes_enabled": ["monorepo", "i18n"],
@@ -267,6 +294,9 @@ MANIFEST_STAGE_PATH=""   # set by init_manifest()
 MANIFEST_TS=""           # ISO-8601 install timestamp (set by init_manifest)
 MANIFEST_LAST_BACKUP=""  # backup_if_exists writes the backup path here; emit helpers read it
 
+# shellcheck source=../../tools/manifest-safety.sh
+. "$CONDUCTOR_ROOT/tools/manifest-safety.sh"
+
 init_manifest() {
   # Called once at install start (after wizard, before any emit).
   if [ "$DRY_RUN" = "true" ]; then
@@ -289,12 +319,13 @@ record_emit() {
   local had_backup="false"
   [ -n "$backup" ] && had_backup="true"
   # Escape backslashes and double quotes for JSON.
-  local esc_path esc_src esc_backup
+  local esc_path esc_src esc_backup emitted_sha
   esc_path="$(printf '%s' "$relpath" | /usr/bin/sed 's/\\/\\\\/g; s/"/\\"/g')"
   esc_src="$(printf '%s' "$src" | /usr/bin/sed 's/\\/\\\\/g; s/"/\\"/g')"
   esc_backup="$(printf '%s' "$backup" | /usr/bin/sed 's/\\/\\\\/g; s/"/\\"/g')"
-  printf '    {"path": "%s", "source": "%s", "had_backup": %s, "backup_path": "%s"},\n' \
-    "$esc_path" "$esc_src" "$had_backup" "$esc_backup" >> "$MANIFEST_STAGE_PATH"
+  emitted_sha="$(conductor_sha256_file "$TARGET_ABS/$relpath")"
+  printf '    {"path": "%s", "source": "%s", "had_backup": %s, "backup_path": "%s", "sha256": "%s"},\n' \
+    "$esc_path" "$esc_src" "$had_backup" "$esc_backup" "$emitted_sha" >> "$MANIFEST_STAGE_PATH"
 }
 
 finalize_manifest() {
@@ -343,7 +374,9 @@ finalize_manifest() {
 
   /bin/cat > "$MANIFEST_PATH" <<EOF
 {
-  "version": "v0.2.0",
+  "version": "v$CONDUCTOR_VERSION",
+  "adapter": "claude",
+  "mode": "$MODE",
   "install_timestamp": "$MANIFEST_TS",
   "conductor_root": "$CONDUCTOR_ROOT",
   "recipes_enabled": $recipes_json,
@@ -359,21 +392,19 @@ EOF
 # Wrappers around backup_if_exists / cp / write that also remember the backup path so the
 # next record_emit() call can reference it. Keeps emit-step changes minimal.
 backup_and_remember() {
-  # backup_and_remember <dest>
-  MANIFEST_LAST_BACKUP=""
-  if [ -f "$1" ]; then
-    if [ "$DRY_RUN" = "true" ]; then
-      log "would back up existing $1 -> $1.conductor-backup-<ts>"
-      MANIFEST_LAST_BACKUP=""
-    else
-      local ts
-      ts="$(/bin/date +%Y%m%d-%H%M%S)"
-      local backup="$1.conductor-backup-$ts"
-      /bin/cp "$1" "$backup"
-      log "  backed up existing $1 -> $backup"
-      # Store relative-to-target path for portability.
-      MANIFEST_LAST_BACKUP="${backup#$TARGET_ABS/}"
-    fi
+  conductor_manifest_backup_and_remember "$1"
+}
+
+# ----- framework detection (ADR-044 — suggest, NEVER auto-switch) ----------
+
+detect_coexisting_frameworks() {
+  local found=""
+  [ -d "$TARGET_ABS/.specify" ] && found="$found Spec-Kit"
+  { [ -d "$TARGET_ABS/_bmad" ] || [ -d "$TARGET_ABS/.bmad-core" ]; } && found="$found BMAD"
+  if [ -n "$found" ] && [ "$MODE" = "full" ]; then
+    log "NOTE: detected coexisting framework(s):$found"
+    log "      Consider --mode=recipes-only or --mode=reflector-only to coexist without"
+    log "      overlapping workflow rules (suggestion only — nothing was changed)."
   fi
 }
 
@@ -424,6 +455,7 @@ do_uninstall() {
   local restored=0
   local deleted=0
   local missing=0
+  local preserved=0
 
   # Iterate manifest entries by line. Tolerate trailing comma absence on last entry.
   while IFS= read -r line; do
@@ -433,16 +465,27 @@ do_uninstall() {
       *) continue ;;
     esac
     entries_count=$((entries_count + 1))
-    local rel_path src had_backup backup_path
+    local rel_path src had_backup backup_path expected_sha
     rel_path="$(printf '%s' "$line" | /usr/bin/sed -E 's/.*"path": *"([^"]*)".*/\1/')"
     src="$(printf '%s' "$line" | /usr/bin/sed -E 's/.*"source": *"([^"]*)".*/\1/')"
     had_backup="$(printf '%s' "$line" | /usr/bin/sed -E 's/.*"had_backup": *(true|false).*/\1/')"
     backup_path="$(printf '%s' "$line" | /usr/bin/sed -E 's/.*"backup_path": *"([^"]*)".*/\1/')"
+    expected_sha="$(conductor_manifest_field "$line" sha256 2>/dev/null || true)"
 
     local abs_dest="$TARGET_ABS/$rel_path"
     local abs_backup=""
     [ -n "$backup_path" ] && abs_backup="$TARGET_ABS/$backup_path"
 
+    if [ -f "$abs_dest" ] && ! conductor_manifest_file_matches "$abs_dest" "$expected_sha"; then
+      if [ -z "$expected_sha" ]; then
+        log "  WARNING: preserving $rel_path (legacy manifest has no checksum)"
+      else
+        log "  WARNING: preserving user-modified $rel_path"
+      fi
+      preserved=$((preserved + 1))
+      continue
+    fi
+
     if [ "$had_backup" = "true" ] && [ -n "$abs_backup" ]; then
       if [ -f "$abs_backup" ]; then
         if [ "$DRY_RUN" = "true" ]; then
@@ -518,6 +561,7 @@ do_uninstall() {
   echo "  Backups restored: $restored"
   echo "  Files deleted: $deleted"
   echo "  Backup-missing deletes: $missing"
+  [ "$preserved" -gt 0 ] && echo "  User-modified files preserved: $preserved"
   echo "========================================================"
 }
 
@@ -565,6 +609,26 @@ if [ -d "$TARGET_ABS/.claude" ] || [ -f "$TARGET_ABS/CLAUDE.md" ]; then
   IS_ADOPTER_CASE="true"
 fi
 
+detect_coexisting_frameworks
+
+# --mode=strict: never overwrite an existing baseline, even with a backup (ADR-044).
+if [ "$MODE" = "strict" ]; then
+  if [ -f "$TARGET_ABS/CLAUDE.md" ]; then
+    echo "Error (--mode=strict): $TARGET_ABS/CLAUDE.md already exists — strict mode aborts instead of overwriting a baseline." >&2
+    echo "  Use --mode=full (timestamped backup + manifest-based restore), or move the file first." >&2
+    exit 3
+  fi
+  if [ -d "$TARGET_ABS/.claude/rules" ] && [ -n "$(/bin/ls -A "$TARGET_ABS/.claude/rules" 2>/dev/null)" ]; then
+    echo "Error (--mode=strict): $TARGET_ABS/.claude/rules/ already has files — strict mode never writes next to an existing rules surface." >&2
+    exit 3
+  fi
+fi
+
+# À-la-carte modes are non-interactive by design.
+if [ "$MODE" != "full" ] && [ "$MODE" != "strict" ]; then
+  NO_PROMPT="true"
+fi
+
 if [ "$IS_ADOPTER_CASE" = "true" ] && [ "$NO_PROMPT" = "false" ] && [ "$DRY_RUN" = "false" ]; then
   echo ""
   echo "========================================================"
@@ -633,7 +697,9 @@ fi
 # Initialize manifest before any emit happens.
 init_manifest
 
-if [ "$WIZARD_APPLY_RULES" = "true" ]; then
+if [ "$MODE" = "recipes-only" ] || [ "$MODE" = "reflector-only" ]; then
+  log "Step 1/6: universal-rules — skipped (--mode=$MODE is à la carte)"
+elif [ "$WIZARD_APPLY_RULES" = "true" ]; then
   log "Step 1/6: universal-rules → .claude/rules/"
   mkdir_if_real "$TARGET_ABS/.claude/rules"
 
@@ -654,9 +720,16 @@ fi
 
 # ----- step 2: roles -----------------------------------------------------
 
-if [ "$WIZARD_APPLY_RULES" = "true" ]; then
+if [ "$MODE" = "minimal" ]; then
+  log "Step 2/6: roles — skipped (--mode=minimal ships text only)"
+elif [ "$WIZARD_APPLY_RULES" = "true" ]; then
   log "Step 2/6: roles → .claude/agents/"
-  mkdir_if_real "$TARGET_ABS/.claude/agents"
+  # À la carte without self-improvement must not leave an empty .claude/agents/.
+  if [ "$MODE" != "recipes-only" ] && [ "$MODE" != "reflector-only" ]; then
+    mkdir_if_real "$TARGET_ABS/.claude/agents"
+  else
+    case ",$RECIPES," in *",self-improvement,"*) mkdir_if_real "$TARGET_ABS/.claude/agents" ;; esac
+  fi
 
   # Map each universal role to Claude-native agent frontmatter.
   declare_agent() {
@@ -683,12 +756,16 @@ EOF
     record_emit ".claude/agents/$role.md" "core/roles/$role.md" "$MANIFEST_LAST_BACKUP"
   }
 
+  if [ "$MODE" != "recipes-only" ] && [ "$MODE" != "reflector-only" ]; then
   declare_agent planner  "Architecture, gap analysis, ADRs, trade-off decisions. No implementation code."  opus
   declare_agent builder  "Multi-file or cross-cutting code implementation (3+ files)."                       opus
   declare_agent reviewer "Plan validation before implementation. Read-only gatekeeper."                      opus
   declare_agent helper   "Single-file or 1-2-file work where the pattern is established."                    sonnet
   declare_agent designer "UI / UX implementation. Visual components, design tokens, accessibility."          sonnet
   declare_agent scribe   "Documentation sync after implementation. No code edits."                           sonnet
+  else
+    log "  (à la carte — the 6 universal role agents skipped)"
+  fi
   case ",$RECIPES," in *",self-improvement,"*)
     declare_agent reflector "Reads session trajectories; proposes atomic lesson deltas for human approval. No code, no auto-apply." opus ;;
   esac
@@ -699,7 +776,9 @@ fi
 # ----- step 3: recipes (opt-in) ------------------------------------------
 
 log "Step 3/6: recipes (opt-in) → .claude/rules/"
+RECIPES_EMITTED=0
 if [ -n "$RECIPES" ]; then
+  mkdir_if_real "$TARGET_ABS/.claude/rules"
   IFS=',' read -ra RECIPE_LIST <<< "$RECIPES"
   for r in "${RECIPE_LIST[@]}"; do
     src="$CORE_ROOT/recipes/$r.md"
@@ -711,20 +790,71 @@ if [ -n "$RECIPES" ]; then
     backup_and_remember "$dest"
     copy_with_paths_frontmatter "$src" "$dest" "**"
     record_emit ".claude/rules/$r.md" "core/recipes/$r.md" "$MANIFEST_LAST_BACKUP"
+    RECIPES_EMITTED=$((RECIPES_EMITTED + 1))
   done
 else
   log "  (no recipes selected — pass --recipes=name1,name2 to install)"
 fi
+if [ "$MODE" = "recipes-only" ] && [ "${RECIPES_EMITTED:-0}" -eq 0 ] && [ "$DRY_RUN" != "true" ]; then
+  echo "Error: --mode=recipes-only resolved ZERO valid recipes from '--recipes=$RECIPES' — nothing to install (check the names)." >&2
+  /bin/rm -f "$MANIFEST_STAGE_PATH"
+  exit 1
+fi
 
 # ----- step 4: hooks + settings.json -------------------------------------
 
+INSTALLED_HOOKS=()
+
+if [ "$MODE" = "minimal" ]; then
+  log "Step 4/6: hooks + settings.json — skipped (--mode=minimal ships text only)"
+elif [ "$MODE" = "recipes-only" ] || [ "$MODE" = "reflector-only" ]; then
+  # À la carte: only the Reflector's trajectory hook (when self-improvement is selected).
+  case ",$RECIPES," in
+    *",self-improvement,"*)
+      log "Step 4/6: hooks — à la carte: stop-trajectory-log only (--mode=$MODE)"
+      mkdir_if_real "$TARGET_ABS/.claude/hooks"
+      src="$CORE_ROOT/hooks/stop-trajectory-log.sh.template"
+      dest="$TARGET_ABS/.claude/hooks/stop-trajectory-log.sh"
+      if [ -f "$src" ]; then
+        backup_and_remember "$dest"
+        substitute_template "$src" "$dest"
+        record_emit ".claude/hooks/stop-trajectory-log.sh" "core/hooks/stop-trajectory-log.sh.template" "$MANIFEST_LAST_BACKUP"
+      fi
+      SETTINGS_PATH="$TARGET_ABS/.claude/settings.json"
+      if [ -f "$SETTINGS_PATH" ]; then
+        log "  $SETTINGS_PATH exists — add the Stop hook manually: \"\$CLAUDE_PROJECT_DIR\"/.claude/hooks/stop-trajectory-log.sh"
+      elif [ "$DRY_RUN" = "true" ]; then
+        log "would write minimal $SETTINGS_PATH (trajectory Stop hook only)"
+      else
+        /bin/cat > "$SETTINGS_PATH" <<'MINSETTINGS_EOF'
+{
+  "$comment": "Minimal project settings generated by CONDUCTOR (à-la-carte mode): registers only the Reflector trajectory Stop hook.",
+  "hooks": {
+    "Stop": [
+      {
+        "hooks": [
+          { "type": "command", "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/stop-trajectory-log.sh" }
+        ]
+      }
+    ]
+  }
+}
+MINSETTINGS_EOF
+        log "  wrote minimal $SETTINGS_PATH (trajectory Stop hook only)"
+        record_emit ".claude/settings.json" "<synthesized:minimal>" ""
+      fi
+      ;;
+    *)
+      log "Step 4/6: hooks — skipped (--mode=$MODE without self-improvement)"
+      ;;
+  esac
+else
 log "Step 4/6: hooks → .claude/hooks/"
 mkdir_if_real "$TARGET_ABS/.claude/hooks"
 
 # Core hooks (always emitted when template exists). Optional hooks (cache-hit baseline, large-file
 # read guard) emit only if their templates are present in the CONDUCTOR core/ tree, allowing the
 # adapter to remain forward-compatible with P1.7 work in progress.
-INSTALLED_HOOKS=()
 for hook in pretool-agent-routing stop-session-log-check stop-r6-review-check stop-cache-hit-baseline-check pretool-large-file-read-guard pretool-commit-current-work-check pretool-commit-test-coverage-check stop-trajectory-log stop-git-hygiene-guard pretool-loop-guard; do
   src="$CORE_ROOT/hooks/$hook.sh.template"
   dest="$TARGET_ABS/.claude/hooks/$hook.sh"
@@ -821,6 +951,7 @@ SETTINGS_EOF
   log "  wrote $SETTINGS_PATH ($(printf '%s' "${INSTALLED_HOOKS[*]}" | /usr/bin/wc -w | /usr/bin/tr -d ' ') hook(s) installed in .claude/hooks; settings.json registers 10 core hooks: 5 PreToolUse + 5 Stop)"
   record_emit ".claude/settings.json" "<synthesized>" ""
 fi
+fi
 
 # ----- step 4.5: hookify rule templates ----------------------------------
 #
@@ -833,7 +964,9 @@ fi
 # Forward-compat: silent skip if the hookify-templates directory is empty or missing.
 
 HOOKIFY_TEMPLATE_DIR="$CONDUCTOR_ROOT/adapters/claude/hookify-templates"
-if [ -d "$HOOKIFY_TEMPLATE_DIR" ]; then
+if [ "$MODE" != "full" ] && [ "$MODE" != "strict" ]; then
+  log "Step 4.5/6: hookify rules — skipped (--mode=$MODE)"
+elif [ -d "$HOOKIFY_TEMPLATE_DIR" ]; then
   log "Step 4.5/6: hookify rules → .claude/hookify.*.local.md"
   HOOKIFY_INSTALLED=0
   HOOKIFY_SKIPPED=0
@@ -866,7 +999,13 @@ if [ -d "$HOOKIFY_TEMPLATE_DIR" ]; then
 fi
 
 # ---- Step 4.6: self-improvement runtime artifacts (only when recipe selected) ----
-case ",$RECIPES," in
+if [ "$MODE" = "minimal" ]; then
+  RECIPES_FOR_RUNTIME=""
+  log "Step 4.6: self-improvement runtime — skipped (--mode=minimal ships text only)"
+else
+  RECIPES_FOR_RUNTIME="$RECIPES"
+fi
+case ",$RECIPES_FOR_RUNTIME," in
   *",self-improvement,"*)
     log "Step 4.6: emitting self-improvement runtime (prune script + /reflect command)"
     # prune script → .conductor/reflect/prune-lessons.sh
@@ -929,6 +1068,9 @@ esac
 
 # ----- step 5: docs templates --------------------------------------------
 
+if [ "$MODE" = "recipes-only" ] || [ "$MODE" = "reflector-only" ]; then
+  log "Step 5/6: docs templates — skipped (--mode=$MODE is à la carte)"
+else
 log "Step 5/6: docs templates → docs/"
 mkdir_if_real "$TARGET_ABS/docs"
 mkdir_if_real "$TARGET_ABS/docs/specs"
@@ -962,8 +1104,13 @@ if [ -f "$CORE_ROOT/docs-templates/specs/_example.md" ]; then
   fi
 fi
 
+fi
+
 # ----- step 6: synthesize CLAUDE.md --------------------------------------
 
+if [ "$MODE" = "recipes-only" ] || [ "$MODE" = "reflector-only" ]; then
+  log "Step 6/6: CLAUDE.md — skipped (--mode=$MODE is à la carte)"
+else
 log "Step 6/6: synthesize CLAUDE.md"
 CLAUDE_MD="$TARGET_ABS/CLAUDE.md"
 
@@ -1050,6 +1197,8 @@ else
 fi
 
 # Finalize manifest now that all emits are complete (before optional baseline measurement).
+fi
+
 finalize_manifest
 
 # ----- step 7 (optional): baseline measurement ---------------------------
@@ -1157,20 +1306,35 @@ echo ""
 echo "========================================================"
 echo " Done."
 echo "  Target: $TARGET_ABS"
-echo "  Universal rules: 5"
-case ",$RECIPES," in
-  *",self-improvement,"*) echo "  Roles: 7 (incl. reflector)" ;;
-  *)                      echo "  Roles: 6" ;;
-esac
+echo "  Mode: $MODE"
+if [ "$MODE" = "recipes-only" ] || [ "$MODE" = "reflector-only" ]; then
+  echo "  Universal rules: 0 (à la carte)"
+  case ",$RECIPES," in
+    *",self-improvement,"*) echo "  Roles: 1 (reflector only)" ;;
+    *)                      echo "  Roles: 0" ;;
+  esac
+else
+  echo "  Universal rules: 5"
+  if [ "$MODE" = "minimal" ]; then
+    echo "  Roles: 0 (--mode=minimal)"
+  else
+    case ",$RECIPES," in
+      *",self-improvement,"*) echo "  Roles: 7 (incl. reflector)" ;;
+      *)                      echo "  Roles: 6" ;;
+    esac
+  fi
+fi
 echo "  Recipes installed: ${RECIPES:-(none)}"
 echo "  Hooks: ${#INSTALLED_HOOKS[@]} (${INSTALLED_HOOKS[*]:-none})"
-echo "  Settings: .claude/settings.json (permissions allowlist + hooks registry)"
+if [ -f "$TARGET_ABS/.claude/settings.json" ]; then
+  echo "  Settings: .claude/settings.json (permissions allowlist + hooks registry)"
+fi
 echo ""
 echo " Run \`claude\` (Claude Code restart) to activate new rules."
 echo "========================================================"
 echo ""
 echo "Next steps for the project:"
 echo "  1. Open $TARGET_ABS in Claude Code."
-echo "  2. Edit docs/CURRENT_WORK.md with your project's current state."
+[ -d "$TARGET_ABS/docs" ] && echo "  2. Edit docs/CURRENT_WORK.md with your project's current state."
 echo "  3. Edit CLAUDE.md if you have project-specific orchestrator rules to add."
 echo "  4. Verify hook installation: ls -la $TARGET_ABS/.claude/hooks/"

package/adapters/codex/README.md

@@ -1,20 +1,16 @@
-# Adapter — Codex (T3)
+# Adapter — Codex (T2)
 
-OpenAI Codex (the modern shell-driven agent — not the deprecated original Codex API) is a T3 target because:
+OpenAI Codex (the modern shell-driven agent — not the deprecated original Codex API) is a T2 target because:
 
-- It supports a single project rules file at `AGENTS.md` (project root — the established cross-agent convention).
-- It excels at shell-driven scripting and one-shot tasks.
+- It supports a single project rules file at `AGENTS.md` (project root — the established cross-agent convention), auto-loaded on session start.
+- It excels at shell-driven scripting and agentic terminal work.
 
-It is **T3** because:
+**Tool capability vs CONDUCTOR emission (ADR-031):** as of 2026 Codex ships hooks (default-on), sub-agent dispatch, custom agents, per-task model routing, commands, and built-in managed memory. What is limited today is what CONDUCTOR **emits** for it — rule text + docs + the opt-in Reflector loop; the enforcement guard hooks, role agents, and model-routing config are Phase-2 emission (ADR-034). That is a CONDUCTOR gap, not a Codex limitation. Real tool-side caveat: rules scope by nested-file hierarchy, not glob — the adapter bundles everything into one `AGENTS.md`.
 
-- ❌ No per-pattern rule scoping.
-- ❌ No sub-agent dispatch.
-- ❌ No hooks.
-- ❌ No per-call model routing.
-- ❌ No built-in memory directory.
-- ⚠️ Limited multi-step orchestration capability vs Claude/Cursor.
+**Tier**: T2 (see `docs/COMPATIBILITY-MATRIX.md`). Live-verified via the automated headless probe (`tools/live-verify.sh` — current status in `docs/ADAPTER-LIVE-VERIFICATION.md`).
+
+> Enumerable facts about this adapter (output paths / tier / capabilities / live verification / headless CLI) are machine-readable in [`metadata.json`](./metadata.json) and CI-checked against `transform.sh` + the validator (ADR-040).
 
-**Tier**: T3 — Basic. Rule TEXT installs but most CONDUCTOR mechanism doesn't apply.
 
 ## Installation path
 
@@ -39,37 +35,37 @@ bash adapters/codex/transform.sh <target> --uninstall              # revert (man
     └── specs/_example.md
 ```
 
-## Native features supported
+- `--recipes=self-improvement` additionally emits the Reflector loop: session-end trajectory hook config (`.codex/hooks.json`), `/reflect` command, reflector agent, prune script, and the `.conductor/reflect/` weekly runner (ADR-032/033).
+
+## Native features supported (emitted today)
 
 - ✅ Always-loaded baseline (`AGENTS.md`).
 - ✅ All universal rule TEXT.
 - ✅ All doc templates.
+- ✅ Reflector loop (opt-in recipe).
 - ✅ Strong shell-task execution (Codex's primary strength).
 
-## Features NOT supported
+## Not emitted yet (Phase 2 — Codex supports these natively, ADR-031/034)
 
-| Feature | Workaround |
+| Feature | Interim workaround |
 |---|---|
-| Per-pattern rule scoping | All rules always-loaded. |
-| Sub-agent dispatch | Human plays orchestrator (or breaks task into sequential prompts). |
-| Hooks | Pair with project pre-commit git hooks. |
-| Per-call model routing | Single model per Codex invocation. |
-| Built-in memory directory | DIY at `.memory/`. |
-| Multi-step orchestration | Limited — Codex shines at one-shot shell tasks. For multi-step, use Claude/Cursor. |
+| Per-pattern rule scoping | All rules always-loaded in one `AGENTS.md` (Codex scopes by nested-file hierarchy, not globs). |
+| Enforcement guard hooks | Self-police, or pair with project pre-commit git hooks. Only the Reflector session-end hook is emitted today (`--recipes=self-improvement`). |
+| The 6 role agents (sub-agent dispatch) | Codex has native sub-agents; CONDUCTOR doesn't emit its role definitions for Codex yet. Human plays orchestrator. |
+| Per-call model-routing config | Pick the model per invocation via Codex's own model selection. |
+| 4-type memory pattern | Self-managed at `.memory/` (gitignored); Codex's built-in managed memory is separate. |
 
 ## Best fit use cases
 
-- Shell scripts.
-- One-shot file transformations.
-- Quick git operations.
-- "Run this command and tell me the output" tasks.
+- Shell-driven agentic work and scripting.
+- One-shot file transformations and quick git operations.
+- Headless automation (`codex exec` — the Reflector weekly runner uses it).
 
 ## After install — first steps
 
 1. Verify Codex reads `AGENTS.md` (auto-loaded from project root on session start).
 2. Customize `AGENTS.md` for your project as needed.
 3. Add `.memory/` to `.gitignore`.
-4. Use Codex for shell tasks; rely on Claude/Cursor for multi-step orchestration.
 
 ## Quirks / known issues
 
@@ -84,4 +80,4 @@ bash adapters/codex/transform.sh <target> --uninstall              # revert (man
 - ✅ `SUPPORTED-FEATURES.md`
 - ✅ `transform-spec.md`
 - ✅ `transform.sh` (implemented — single-file `AGENTS.md` bundle, recipes, dry-run, manifest-based uninstall)
-- ⏳ `notes.md` (real-Codex install verification deferred)
+- ✅ Live-verified (auto-probe `tools/live-verify.sh` — see `docs/ADAPTER-LIVE-VERIFICATION.md`)

package/adapters/codex/metadata.json

@@ -0,0 +1,35 @@
+{
+  "_comment": "Single source for enumerable adapter facts (ADR-040). CI asserts transform.sh / validator / matrix agree with this file. Update HERE first; docs follow.",
+  "tool": "codex",
+  "display_name": "Codex",
+  "tier": "T2",
+  "outputs": [
+    { "path": "AGENTS.md", "kind": "always_loaded", "validated": true },
+    { "path": "docs/CURRENT_WORK.md", "kind": "docs", "validated": false }
+  ],
+  "reflector_outputs": [
+    { "path": ".codex/hooks.json", "note": "Stop trajectory hook config (recipe-gated)" },
+    { "path": ".conductor/reflect", "note": "runner + brief + scheduling (recipe-gated)" }
+  ],
+  "install": { "ala_carte": "block" },
+  "legacy_paths": [".codex/codex.md"],
+  "capabilities": {
+    "tool_native": {
+      "hooks": "yes",
+      "sub_agents": "yes",
+      "model_routing": "yes",
+      "commands": "yes",
+      "glob_scoping": "no",
+      "scheduler": "local"
+    },
+    "conductor_emitted": {
+      "rules": "full",
+      "guard_hooks": "none",
+      "reflector_loop": "recipe",
+      "role_agents": "none",
+      "model_routing": "none"
+    }
+  },
+  "live_verification": { "status": "verified", "date": "2026-07-09", "cli": "codex-cli 0.144.0", "note": "headless probe listed 4/5 rules + read-CURRENT_WORK-first" },
+  "headless_cli": { "command": "codex", "invocation": "codex exec" }
+}

package/adapters/codex/transform-spec.md

@@ -41,7 +41,7 @@ adapters/codex/_native/codex.md.tpl              # Header template (Codex-flavor
     └── specs/_example.md
 ```
 
-## `.codex/codex.md` composition (in order)
+## `AGENTS.md` composition (in order)
 
 1. **Header from `_native/codex.md.tpl`** — bilingual (한/영) intro adapted for Codex (one-shot model, shell-task strength).
 2. **ABSOLUTE rules section** — R1-R8 minus Claude-only sub-agent enforcement. R-prefix renumbered.
@@ -60,9 +60,8 @@ Same as Gemini adapter — strip front-matter, concatenate, replace tool-specifi
 
 | Case | Adapter behavior |
 |---|---|
-| `.codex/` doesn't exist | Create it. |
-| Existing `.codex/codex.md` | Skip; report "SKIP (exists)". |
-| `.codex/codex.md` exceeds Codex context budget | Warn; document trim strategy in `notes.md`. |
+| Existing `AGENTS.md` | Back up, then write (manifest-tracked; `--uninstall` restores). |
+| `AGENTS.md` exceeds Codex context budget | Warn; document trim strategy in `notes.md`. |
 
 ## Idempotency check
 
@@ -71,14 +70,14 @@ Re-run reports "SKIP (exists)" for everything.
 ## Verification commands (P3.5 will fill)
 
 ```bash
-test -f "<target>/.codex/codex.md"                     || echo "MISSING codex.md"
+test -f "<target>/AGENTS.md"                           || echo "MISSING AGENTS.md"
 
 # Run Codex in <target>; verify it follows ABSOLUTE rules + universal conventions.
 ```
 
 ## P3.5 Codex version compatibility check
 
-- Confirm `.codex/codex.md` IS the canonical project-rules location.
+- Confirm `AGENTS.md` IS the canonical project-rules location. (Confirmed — live-verified; current status in `docs/ADAPTER-LIVE-VERIFICATION.md`.)
 - Confirm Codex auto-loads it on session start.
 - Confirm Codex follows the rule TEXT in its inline code generation.