feat(opencode): wire 29-point CLI lifecycle scripts, drift-C reconciler, and skill docs

.agents/skills/multi-agent-mux-create/SKILL.md

@@ -129,7 +129,7 @@ herdr_sessions:
 
 ```bash
 WORKSPACE=/path/to/project
-AGENT=claude  # claude | agy | hermes | grok — always pass it explicitly
+AGENT=claude  # claude | agy | hermes | grok | opencode — always pass it explicitly
 source .agents/skills/lib.sh
 SESSION_NAME="$(derive_session_name "$WORKSPACE" "$AGENT")"
 
@@ -160,7 +160,10 @@ case "$AGENT" in
   grok)
     herdr new-session -d -s "$SESSION_NAME" -x 140 -y 40 -c "$WORKSPACE" "grok --permission-mode bypassPermissions"
     ;;
-  *) echo "ERROR: --agent must be claude, agy, hermes, or grok, got: $AGENT"; exit 2 ;;
+  opencode)
+    herdr new-session -d -s "$SESSION_NAME" -x 140 -y 40 -c "$WORKSPACE" "opencode --auto --agent build"
+    ;;
+  *) echo "ERROR: --agent must be claude, agy, hermes, grok, or opencode, got: $AGENT"; exit 2 ;;
 esac
 
 # 3. Wait for agent TUI to be ready (varies: claude ~5s, agy ~3s)

.agents/skills/multi-agent-mux-create/scripts/create_session.sh

@@ -1,7 +1,7 @@
 #!/usr/bin/env bash
 # create_session.sh — multi-agent-mux-create 의 부속 스크립트
 # Usage:
-#   bash create_session.sh --workspace <path> --agent <claude|agy|hermes|grok> --role <role> [--session <name>] [--herdr-session <name>] [--wrapper]
+#   bash create_session.sh --workspace <path> --agent <claude|agy|hermes|grok|opencode> --role <role> [--session <name>] [--herdr-session <name>] [--wrapper]
 #
 # 동작:
 #   1) preflight: herdr/claude/agy 가용성, workspace 존재
@@ -26,11 +26,11 @@ source "$_lib_sh"
 
 usage() {
   cat <<EOF
-Usage: $0 --workspace <path> --agent <claude|agy|hermes|grok> --role <role> [options]
+Usage: $0 --workspace <path> --agent <claude|agy|hermes|grok|opencode> --role <role> [options]
 
 Options:
   --workspace PATH    project directory (required)
-  --agent AGENT       claude | agy | hermes | grok (required)
+  --agent AGENT       claude | agy | hermes | grok | opencode (required)
   --role ROLE         assigned role (required)
   --session NAME      herdr session name (default: derived from workspace)
   --wrapper           force use of ~/.local/bin/<session> wrapper even if not present
@@ -90,8 +90,8 @@ fi
 [ -n "$WORKSPACE" ] || { echo "ERROR: --workspace required" >&2; usage; exit 2; }
 [ -n "$AGENT" ]    || { echo "ERROR: --agent required" >&2; usage; exit 2; }
 case "$AGENT" in
-  claude|agy|hermes|grok) ;;
-  *) echo "ERROR: --agent must be claude, agy, hermes or grok, got: $AGENT" >&2; exit 2 ;;
+  claude|agy|hermes|grok|opencode) ;;
+  *) echo "ERROR: --agent must be claude, agy, hermes, grok, or opencode, got: $AGENT" >&2; exit 2 ;;
 esac
 [ -n "$ROLE" ]     || { echo "ERROR: --role required" >&2; usage; exit 2; }
 [ -d "$WORKSPACE" ] || { echo "ERROR: workspace $WORKSPACE not a directory" >&2; exit 1; }
@@ -126,6 +126,13 @@ elif [ "$AGENT" = "grok" ]; then
     echo "ERROR: grok is not functional or configured." >&2
     exit 1
   fi
+elif [ "$AGENT" = "opencode" ]; then
+  if [ -f "$HOME/.local/share/opencode/auth.json" ] || [ -n "${ANTHROPIC_API_KEY:-}" ] || [ -n "${OPENAI_API_KEY:-}" ] || [ -n "${GEMINI_API_KEY:-}" ] || [ -n "${GROQ_API_KEY:-}" ]; then
+    true
+  elif ! opencode --version >/dev/null 2>&1; then
+    echo "ERROR: opencode is not functional or configured." >&2
+    exit 1
+  fi
 fi
 
 # 세션 이름 — lib.sh::derive_session_name 이 단일 소스 (P0-A)
@@ -181,6 +188,8 @@ if [ -z "$CMD_FULL" ]; then
     claude) CMD_FULL="${RESOLVED_BIN} --dangerously-skip-permissions --session-id ${SESSION_UUID}" ;;
     agy)    CMD_FULL="${RESOLVED_BIN} --dangerously-skip-permissions" ;;
     hermes) CMD_FULL="${RESOLVED_BIN} --yolo --accept-hooks" ;;
+    grok)   CMD_FULL="${RESOLVED_BIN} --permission-mode bypassPermissions" ;;
+    opencode) CMD_FULL="${RESOLVED_BIN} --auto --agent build" ;;
   esac
 fi
 
@@ -204,7 +213,13 @@ spawn() {
     agy|hermes|grok)
       HERDR_SESSION_NAME="$HERDR_SESSION_NAME" _herdr new-session -d -s "$SESSION_NAME" -x 140 -y 40 -c "$WORKSPACE" "$CMD_FULL"
       ;;
-    *) echo "ERROR: --agent must be claude, agy, hermes or grok, got: $AGENT" >&2; exit 2 ;;
+    opencode)
+      if [ -z "${OPENCODE_PERMISSION:-}" ]; then
+        export OPENCODE_PERMISSION='{"*":"allow"}'
+      fi
+      HERDR_SESSION_NAME="$HERDR_SESSION_NAME" _herdr new-session -d -s "$SESSION_NAME" -x 140 -y 40 -c "$WORKSPACE" "$CMD_FULL"
+      ;;
+    *) echo "ERROR: --agent must be claude, agy, hermes, grok, or opencode, got: $AGENT" >&2; exit 2 ;;
   esac
 }
 
@@ -312,6 +327,7 @@ if [ -n "$SUBMIT_JOB_PROMPT" ]; then
       hermes) delegate_agent="hermes-agent" ;;
       agy)    delegate_agent="antigravity-cli" ;;
       grok)   delegate_agent="grok-build" ;;
+      opencode) delegate_agent="opencode-cli" ;;
       *) echo "ERROR: cannot resolve delegate agent key for '$AGENT'" >&2; exit 2 ;;
     esac
   fi
@@ -419,6 +435,13 @@ elif agent == 'grok':
     entry['session_id_source'] = 'assigned' if assigned else 'pending-discovery'
     entry['session_id_verified'] = False
     entry['last_visible_status'] = "assigned (awaiting first message)" if assigned else "unverified"
+elif agent == 'opencode':
+    cp = os.environ.get('CHILD_PID', '0')
+    entry['child_pid'] = int(cp) if cp.isdigit() else 0
+    entry['opencode_session_id_own'] = None
+    entry['session_id_source'] = 'pending-discovery'
+    entry['session_id_verified'] = False
+    entry['last_visible_status'] = "unverified"
 
 last_vis_override = os.environ.get('LAST_VISIBLE_STATUS_OVERRIDE', '')
 if last_vis_override: