doctor

OMX Doctor

このタスクカードは、インストール/検出の問題を診断するために使用します。共通の安全性、ライフサイクル、フック、チーム、自律性、キャンセルのルールは templates/AGENTS.md にあります。CODEX_HOME が設定されている場合、~/.codex は ${CODEX_HOME:-~/.codex} を意味します。

診断を実行する

omx doctor
omx doctor --team             # include Team runtime checks
omx doctor --verbose          # include detailed check evidence
omx doctor --force            # repair eligible repo artifact ownership issues
omx doctor --dry-run --force  # preview eligible ownership repairs

ローカルのソースチェックアウトの場合は、まずビルドしてから node dist/cli/omx.js doctor を実行してください。レポート用に、コマンドの出力と正確なパスを保存してください。

プラグインキャッシュとバージョン

PLUGIN_CACHE_ROOT="${CODEX_HOME:-$HOME/.codex}/plugins/cache"
CACHE_ENTRIES=$(find "$PLUGIN_CACHE_ROOT" -path "*/oh-my-codex/*" -mindepth 3 -maxdepth 3 -type d 2>/dev/null)
if [[ -z "$CACHE_ENTRIES" ]]; then
  echo "Installed plugin cache: none"
else
  while IFS= read -r d; do
    m=$(basename "$(dirname "$(dirname "$d")")"); v=$(basename "$d")
    printf 'Installed plugin cache: marketplace=%s version=%s path=%s\n' "$m" "$v" "$d"
  done <<<"$CACHE_ENTRIES"
fi
LATEST=$(npm view oh-my-codex version 2>/dev/null)
echo "Latest npm: $LATEST"

キャッシュがない場合は INFO です（npm/setup のみのインストールでは通常の状態です）。local 以外のキャッシュバージョンが LATEST と異なる場合、または 1 つのマーケットプレイスに複数のバージョンがある場合は WARN です。プラグインの検出は、npm インストールと omx setup の実行に代わるものではありません。ネイティブ/ランタイムの接続は、引き続きセットアップが担当します。

フック、AGENTS、スキルのルート

CODEX_DIR="${CODEX_HOME:-$HOME/.codex}"
ls -la "$CODEX_DIR/config.toml" "$CODEX_DIR/settings.json" 2>/dev/null
rg 'keyword-detector|persistent-mode|session-start|stop-continuation' "$CODEX_DIR/config.toml" "$CODEX_DIR/settings.json" 2>/dev/null || true
ls -la "$CODEX_DIR/hooks"/*.sh 2>/dev/null
ls -la "$CODEX_DIR/AGENTS.md" 2>/dev/null
grep -q "oh-my-codex Multi-Agent System" "$CODEX_DIR/AGENTS.md" 2>/dev/null && echo "Has OMX config" || echo "Missing OMX config"
ls -la "$CODEX_DIR/agents" "$CODEX_DIR/commands" "$CODEX_DIR/skills" "$HOME/.agents/skills" 2>/dev/null

レガシーのフック参照は CRITICAL（フックの重複）として分類してください。スクリプト keyword-detector.sh、persistent-mode.sh、session-start.sh、stop-continuation.sh は WARN です。AGENTS.md が見つからない場合は CRITICAL、OMX マーカーが見つからない場合は WARN です。${CODEX_HOME:-~/.codex}/skills が正規のユーザー用ルートです。~/.agents/skills は過去の経緯によるもので、ツリーが重複するとスキルのエントリが重複する可能性があります。レガシーの agents/ または commands/ 配下にある OMX ファイルは WARN です。

--team を指定した場合は、resume_blocker、slow_shutdown、delayed_status_lag、stale_leader、orphan_tmux_session の診断結果をすべて保持してください。失敗したチェックがあれば、終了ステータスは非ゼロになります。

レポートの規約

## OMX Doctor Report
### Summary
[HEALTHY / ISSUES FOUND]
### Checks
| Check | Status | Details |
| Plugin Version | OK/WARN/INFO | ... |
| Hook Config (config.toml / legacy settings.json) | OK/CRITICAL | ... |
| Legacy Scripts (~/.codex/hooks/) | OK/WARN | ... |
| AGENTS.md | OK/WARN/CRITICAL | ... |
| Plugin Cache | OK/WARN | ... |
| Legacy Agents / Commands | OK/WARN | ... |
| Skills (canonical / historical root) | OK/WARN | ... |
### Issues Found
1. ...
### Recommended Fixes
...

修復（ユーザーの確認後、かつ各対象が OMX の所有であることを確認した後に実施）

確認済みの OMX のレガシーコンテンツのみを削除し、無関係なユーザーファイルは保持してください。

# If settings.json exists, remove only its legacy "hooks" section.
rm -f "$CODEX_DIR/hooks/keyword-detector.sh" "$CODEX_DIR/hooks/persistent-mode.sh" "$CODEX_DIR/hooks/session-start.sh" "$CODEX_DIR/hooks/stop-continuation.sh"
PLUGIN_CACHE_ROOT="${CODEX_HOME:-$HOME/.codex}/plugins/cache"
find "$PLUGIN_CACHE_ROOT" -path "*/oh-my-codex" -type d -prune -exec rm -rf {} +

古い curl によるインストールの場合は、まず内容を確認し、OMX 管理ファイルを含むディレクトリのみを削除してください。

ls -la "$CODEX_DIR/agents" "$CODEX_DIR/commands" "$CODEX_DIR/skills" "$HOME/.agents/skills" 2>/dev/null
# Optional backups:
# mv "$CODEX_DIR/agents" "$CODEX_DIR/agents.bak"
# mv "$CODEX_DIR/commands" "$CODEX_DIR/commands.bak"
# mv "$HOME/.agents/skills" "$HOME/.agents/skills.bak"
rm -rf "$CODEX_DIR/agents" "$CODEX_DIR/commands" "$HOME/.agents/skills"

AGENTS.md が見つからない、または古い場合は、最新の raw ファイルを取得して $CODEX_DIR/AGENTS.md に書き込んでください。

WebFetch(url: "https://raw.githubusercontent.com/Yeachan-Heo/oh-my-codex/main/docs/AGENTS.md", prompt: "Return the complete raw markdown content exactly as-is")

選択したマーケットプレイスについて、最新のキャッシュバージョンのみを残すには、次を実行してください。

PLUGIN_CACHE_DIR="$PLUGIN_CACHE_ROOT/$MARKETPLACE_NAME/oh-my-codex"
KEEP_VERSION=$(for d in "$PLUGIN_CACHE_DIR"/*; do [[ -d "$d" ]] && basename "$d"; done | sort -V | tail -1)
[[ -n "$KEEP_VERSION" ]] && find "$PLUGIN_CACHE_DIR" -mindepth 1 -maxdepth 1 -type d ! -name "$KEEP_VERSION" -exec rm -rf {} +

AGENTS.md が見つからない、または古い場合は、現在のリリースソースから更新してから omx doctor を再実行してください。レガシーの ~/.agents/skills が正規のルートと重複している場合は、カスタムスキルがないことを確認したうえで、そのツリーをアーカイブまたは削除してください。修正後は Codex を再起動し、修正前後の証拠を報告してください。

終了条件

必要なパス、フック/設定のチェック、AGENTS マーカー、プラグインキャッシュの状態、（要求された場合は）Team のチェックがすべて合格した場合にのみ HEALTHY で終了してください。それ以外の場合は ISSUES FOUND を報告し、失敗した正確な証拠と、確認済みの最小限の修復内容を示してください。推奨事項だけで修正が完了したと主張しないでください。