triflux 10.45.0 → 10.46.0

package/scripts/release/verify.mjs

@@ -4,6 +4,11 @@ import { fileURLToPath } from "node:url";
 import { assertVersionSync, parseArgs, ROOT } from "./lib.mjs";
 
 const NPM_VERIFY_TARGETS = ["@triflux/core", "@triflux/remote", "triflux"];
+const NPM_POLL_INTERVAL_MS = 20_000;
+
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
 
 function errorMessage(error) {
   const stderr = error?.stderr?.toString?.().trim();
@@ -16,7 +21,20 @@ export async function verifyRelease({
   rootDir = ROOT,
   dryRun = true,
   execFileSyncFn = execFileSync,
+  npmWaitSeconds = 0,
+  npmPendingOk = false,
+  nowFn = Date.now,
+  sleepFn = sleep,
 } = {}) {
+  const waitSeconds = Number(npmWaitSeconds);
+  if (
+    typeof npmWaitSeconds === "boolean" ||
+    npmWaitSeconds === "" ||
+    !Number.isFinite(waitSeconds) ||
+    waitSeconds < 0
+  ) {
+    throw new Error("--npm-wait-seconds must be a non-negative finite number");
+  }
   const sync = assertVersionSync({ rootDir });
   if (!sync.ok) {
     throw new Error("Version sync failed. Fix metadata before verify.");
@@ -31,32 +49,61 @@ export async function verifyRelease({
   ];
 
   if (!dryRun) {
-    for (const packageName of NPM_VERIFY_TARGETS) {
-      const packageSpec = `${packageName}@${releaseVersion}`;
-      try {
-        const npmVersion = execFileSyncFn(
-          "npm",
-          ["view", packageSpec, "version"],
-          {
-            cwd: rootDir,
-            encoding: "utf8",
-          },
-        ).trim();
-        checks.push({
-          name: `npm-view ${packageName}`,
-          ok: npmVersion === releaseVersion,
-          detail:
-            npmVersion === releaseVersion
-              ? npmVersion
-              : `expected ${releaseVersion}, got ${npmVersion}`,
-        });
-      } catch (error) {
-        checks.push({
-          name: `npm-view ${packageName}`,
-          ok: false,
-          detail: `npm view failed for ${packageSpec}: ${errorMessage(error)}`,
-        });
+    const deadline = nowFn() + waitSeconds * 1000;
+    const lastSeen = new Map();
+    while (true) {
+      const npmChecks = NPM_VERIFY_TARGETS.map((packageName) => {
+        const packageSpec = `${packageName}@${releaseVersion}`;
+        try {
+          const npmVersion = execFileSyncFn(
+            "npm",
+            ["view", packageSpec, "version"],
+            { cwd: rootDir, encoding: "utf8" },
+          ).trim();
+          lastSeen.set(packageName, npmVersion);
+          return {
+            name: `npm-view ${packageName}`,
+            ok: npmVersion === releaseVersion,
+            detail:
+              npmVersion === releaseVersion
+                ? npmVersion
+                : `expected ${releaseVersion}, got ${npmVersion}`,
+          };
+        } catch (error) {
+          const previous = lastSeen.get(packageName);
+          const lastSeenDetail =
+            waitSeconds > 0 ? ` (last seen ${previous ?? "unavailable"})` : "";
+          return {
+            name: `npm-view ${packageName}`,
+            ok: false,
+            detail: `npm view failed for ${packageSpec}: ${errorMessage(error)}${lastSeenDetail}`,
+          };
+        }
+      });
+      const remainingMs = deadline - nowFn();
+      if (npmChecks.every((check) => check.ok) || remainingMs <= 0) {
+        if (npmPendingOk && remainingMs <= 0) {
+          const pending = npmChecks.filter((check) => !check.ok);
+          for (const check of pending) {
+            const packageName = check.name.slice("npm-view ".length);
+            check.ok = null;
+            check.status = "pending";
+            check.detail = `expected ${releaseVersion}, last seen ${lastSeen.get(packageName) ?? "unavailable"}; npm publish-time scan may still be processing`;
+          }
+          if (pending.length && process.env.GITHUB_ACTIONS === "true") {
+            const packages = pending.map(
+              (check) =>
+                `${check.name.slice("npm-view ".length)}@${releaseVersion}`,
+            );
+            console.log(
+              `::warning::npm registry pending for ${packages.join(", ")}; npm publish-time scan may still be processing`,
+            );
+          }
+        }
+        checks.push(...npmChecks);
+        break;
       }
+      await sleepFn(Math.min(NPM_POLL_INTERVAL_MS, remainingMs));
     }
 
     const ghRelease = execFileSyncFn(
@@ -101,6 +148,8 @@ if (process.argv[1] && fileURLToPath(import.meta.url) === process.argv[1]) {
     version: args.version,
     rootDir: args.root,
     dryRun: !args.execute,
+    npmWaitSeconds: args["npm-wait-seconds"] ?? 0,
+    npmPendingOk: args["npm-pending-ok"] === true,
   });
   console.log(JSON.stringify(result, null, 2));
   process.exitCode = result.ok ? 0 : 1;

package/scripts/setup.mjs

@@ -437,17 +437,23 @@ const REQUIRED_CODEX_PROFILES = [
     name: "gpt6_astra_xhigh",
     lines: ['model = "gpt-6-astra"', 'model_reasoning_effort = "xhigh"'],
   },
+  // GPT-6 Sol: implementation, review, and verification role defaults.
   {
-    name: "gpt56_terra_high",
-    lines: ['model = "gpt-5.6-terra"', 'model_reasoning_effort = "high"'],
+    name: "gpt6_sol_high",
+    lines: ['model = "gpt-6-sol"', 'model_reasoning_effort = "high"'],
   },
   {
-    name: "gpt56_terra_med",
-    lines: ['model = "gpt-5.6-terra"', 'model_reasoning_effort = "medium"'],
+    name: "gpt6_sol_med",
+    lines: ['model = "gpt-6-sol"', 'model_reasoning_effort = "medium"'],
   },
+  // GPT-6 Luna: high for focused lanes, low for latency-first lanes.
   {
-    name: "gpt56_luna_low",
-    lines: ['model = "gpt-5.6-luna"', 'model_reasoning_effort = "low"'],
+    name: "gpt6_luna_high",
+    lines: ['model = "gpt-6-luna"', 'model_reasoning_effort = "high"'],
+  },
+  {
+    name: "gpt6_luna_low",
+    lines: ['model = "gpt-6-luna"', 'model_reasoning_effort = "low"'],
   },
 ];
 
@@ -1391,7 +1397,7 @@ function ensureCodexProfiles() {
       }
     }
     // config.toml 의 모든 inline [profiles.*] 마이그레이션 (Codex 0.134 는 inline 거부).
-    //   - 관리 gpt56_*: 위에서 canonical 별도 파일을 썼으므로 inline 만 제거.
+    //   - 관리 gpt6_*: 위에서 canonical 별도 파일을 썼으므로 inline 만 제거.
     //   - 구형 retired (codex53/spark53/gpt54/mini54): inline 제거, 재생성 안 함.
     //   - 그 외 사용자 커스텀: 본문을 보존해 별도 파일로 이관한 뒤 inline 제거.
     //     (별도 파일이 이미 있으면 덮어쓰지 않는다 — 사용자 수정 보존.)

package/scripts/tfx-route.sh

@@ -1424,7 +1424,7 @@ route_agent() {
       exit 1
     }
     IFS=$'\t' read -r policy_profile policy_timeout policy_mode policy_oversight policy_mcp policy_subcommand <<< "$policy_row"
-    case "$policy_profile" in gpt6_astra_xhigh|gpt56_terra_high|gpt56_terra_med|gpt56_luna_low) ;; *) echo "ERROR: invalid Codex profile policy" >&2; exit 1 ;; esac
+    case "$policy_profile" in gpt6_astra_xhigh|gpt6_sol_high|gpt6_sol_med|gpt6_luna_high|gpt6_luna_low) ;; *) echo "ERROR: invalid Codex profile policy" >&2; exit 1 ;; esac
     [[ "$policy_timeout" =~ ^[1-9][0-9]*$ ]] || { echo "ERROR: invalid Codex timeout policy" >&2; exit 1; }
     case "$policy_mode" in fg|bg) ;; *) echo "ERROR: invalid Codex run mode policy" >&2; exit 1 ;; esac
     case "$policy_oversight" in true|false) ;; *) echo "ERROR: invalid Codex oversight policy" >&2; exit 1 ;; esac
@@ -1495,6 +1495,9 @@ normalize_codex_profile_name() {
     gpt56_sol_xhigh) echo "gpt6_astra_xhigh" ;;
     gpt56_sol_max) echo "gpt6_astra_max" ;;
     gpt56_sol_ultra) echo "gpt6_astra_ultra" ;;
+    gpt56_terra_high) echo "gpt6_sol_high" ;;
+    gpt56_terra_med) echo "gpt6_sol_med" ;;
+    gpt56_luna_low) echo "gpt6_luna_low" ;;
     *) echo "$1" ;;
   esac
 }
@@ -1585,9 +1588,9 @@ case "$TFX_CODEX_TRANSPORT" in
     ;;
 esac
 case "$TFX_CODEX_PROFILE" in
-  auto|max|ultra|gpt56_luna_low|gpt56_terra_med|gpt56_terra_high|gpt6_astra_xhigh|gpt6_astra_max|gpt6_astra_ultra) ;;
+  auto|max|ultra|gpt6_luna_low|gpt6_luna_high|gpt6_sol_med|gpt6_sol_high|gpt6_astra_xhigh|gpt6_astra_max|gpt6_astra_ultra) ;;
   *)
-    echo "ERROR: TFX_CODEX_PROFILE 값은 auto, max, ultra 또는 canonical gpt56_*/gpt6_* profile이어야 합니다. (현재: $TFX_CODEX_PROFILE)" >&2
+    echo "ERROR: TFX_CODEX_PROFILE 값은 auto, max, ultra 또는 canonical gpt6_* profile이어야 합니다. (현재: $TFX_CODEX_PROFILE)" >&2
     exit 1
     ;;
 esac
@@ -1640,9 +1643,9 @@ apply_cli_mode() {
           designer|antigravity|agy|gemini)
             CLI_ARGS="exec --profile gpt6_astra_xhigh ${codex_base}"; CLI_EFFORT="gpt6_astra_xhigh"; DEFAULT_TIMEOUT=3600 ;;
           writer)
-            CLI_ARGS="exec --profile gpt56_luna_low ${codex_base}"; CLI_EFFORT="gpt56_luna_low"; DEFAULT_TIMEOUT=180 ;;
+            CLI_ARGS="exec --profile gpt6_luna_high ${codex_base}"; CLI_EFFORT="gpt6_luna_high"; DEFAULT_TIMEOUT=900 ;;
           *)
-            CLI_ARGS="exec --profile gpt56_terra_high ${codex_base}"; CLI_EFFORT="gpt56_terra_high"; DEFAULT_TIMEOUT=1080 ;;
+            CLI_ARGS="exec --profile gpt6_sol_high ${codex_base}"; CLI_EFFORT="gpt6_sol_high"; DEFAULT_TIMEOUT=1080 ;;
         esac
         echo "[tfx-route] TFX_CLI_MODE=codex: $AGENT_TYPE → codex($CLI_EFFORT)로 리매핑" >&2
       fi ;;
@@ -1788,10 +1791,10 @@ apply_plan_guard() {
   if [[ "$replacement" == "$CLI_EFFORT" ]]; then
     replacement=""
     case "$CLI_EFFORT" in
-      gpt55_low|spark53_low|codex53_low|gpt54_low|mini54_low) replacement="gpt56_luna_low" ;;
-      gpt55_med|spark53_med|codex53_med|mini54_med) replacement="gpt56_terra_med" ;;
+      gpt55_low|spark53_low|codex53_low|gpt54_low|mini54_low) replacement="gpt6_luna_low" ;;
+      gpt55_med|spark53_med|codex53_med|mini54_med) replacement="gpt6_sol_med" ;;
       gpt55_xhigh|codex53_xhigh|gpt54_xhigh) replacement="gpt6_astra_xhigh" ;;
-      gpt55_high|spark53_*|codex53_*|gpt54_*|mini54_*) replacement="gpt56_terra_high" ;;
+      gpt55_high|spark53_*|codex53_*|gpt54_*|mini54_*) replacement="gpt6_sol_high" ;;
     esac
   fi
   [[ -z "$replacement" ]] && return
@@ -1822,29 +1825,29 @@ apply_no_claude_native_mode() {
 
   case "$AGENT_TYPE" in
     explore)
-      CLI_ARGS="exec --profile gpt56_luna_low ${codex_base}"
-      CLI_EFFORT="gpt56_luna_low"
+      CLI_ARGS="exec --profile gpt6_luna_low ${codex_base}"
+      CLI_EFFORT="gpt6_luna_low"
       DEFAULT_TIMEOUT=600
       RUN_MODE="fg"
       OPUS_OVERSIGHT="false"
       ;;
     verifier)
-      CLI_ARGS="exec --profile gpt56_terra_high ${codex_base} review"
-      CLI_EFFORT="gpt56_terra_high"
+      CLI_ARGS="exec --profile gpt6_sol_high ${codex_base} review"
+      CLI_EFFORT="gpt6_sol_high"
       DEFAULT_TIMEOUT=1200
       RUN_MODE="fg"
       OPUS_OVERSIGHT="false"
       ;;
     test-engineer)
-      CLI_ARGS="exec --profile gpt56_terra_high ${codex_base}"
-      CLI_EFFORT="gpt56_terra_high"
+      CLI_ARGS="exec --profile gpt6_sol_high ${codex_base}"
+      CLI_EFFORT="gpt6_sol_high"
       DEFAULT_TIMEOUT=1200
       RUN_MODE="bg"
       OPUS_OVERSIGHT="false"
       ;;
     qa-tester)
-      CLI_ARGS="exec --profile gpt56_terra_high ${codex_base} review"
-      CLI_EFFORT="gpt56_terra_high"
+      CLI_ARGS="exec --profile gpt6_sol_high ${codex_base} review"
+      CLI_EFFORT="gpt6_sol_high"
       DEFAULT_TIMEOUT=1200
       RUN_MODE="bg"
       OPUS_OVERSIGHT="false"
@@ -1876,7 +1879,7 @@ resolve_safe_retry_codex_profile() {
       echo "gpt6_astra_max"
       return
       ;;
-    gpt56_luna_low|gpt56_terra_med|gpt56_terra_high|gpt6_astra_xhigh|gpt6_astra_max)
+    gpt6_luna_low|gpt6_luna_high|gpt6_sol_med|gpt6_sol_high|gpt6_astra_xhigh|gpt6_astra_max)
       echo "$profile"
       return
       ;;
@@ -1886,7 +1889,7 @@ resolve_safe_retry_codex_profile() {
   codex_home="${CODEX_HOME:-${TFX_CODEX_HOME:-${HOME:-}/.codex}}"
   profile_file="${codex_home}/${profile}.config.toml"
   if [[ ! -f "$profile_file" ]]; then
-    echo "gpt56_terra_high"
+    echo "gpt6_sol_high"
     return
   fi
   effort=$(awk -F= '
@@ -1900,7 +1903,7 @@ resolve_safe_retry_codex_profile() {
   ' "$profile_file" 2>/dev/null || true)
   case "$effort" in
     ultra) echo "gpt6_astra_max" ;;
-    "") echo "gpt56_terra_high" ;;
+    "") echo "gpt6_sol_high" ;;
     *) echo "$profile" ;;
   esac
 }
@@ -2113,8 +2116,8 @@ apply_dynamic_routing_override() {
       local codex_base
       codex_base="$(build_codex_base)"
       CLI_CMD="codex"
-      CLI_ARGS="exec --profile gpt56_terra_high ${codex_base}"
-      CLI_EFFORT="gpt56_terra_high"; DEFAULT_TIMEOUT=1080; RUN_MODE="fg"; OPUS_OVERSIGHT="false"
+      CLI_ARGS="exec --profile gpt6_sol_high ${codex_base}"
+      CLI_EFFORT="gpt6_sol_high"; DEFAULT_TIMEOUT=1080; RUN_MODE="fg"; OPUS_OVERSIGHT="false"
       ;;
     antigravity)
       CLI_CMD="agy"
@@ -3071,12 +3074,12 @@ run_codex_exec() {
   _attempt_codex_run
 
   # Tier-fallback: ChatGPT account가 높은 reasoning profile을 거부하면
-  # GPT-5.6 family low로만 1회 재시도한다. 구형 gpt-5.4 계열로는 더 이상 다운그레이드하지 않는다.
+  # GPT-6 Luna low로만 1회 재시도한다. 구형 gpt-5.4 계열로는 더 이상 다운그레이드하지 않는다.
   # 출처: Issue #211 — codex CLI tier-aware fallback.
   if [[ "$exit_code_local" -ne 0 ]] && grep -qE "is not supported when using Codex with a ChatGPT account" "$STDERR_LOG" 2>/dev/null; then
     local fallback_profile=""
     case "$CLI_EFFORT" in
-      gpt6_astra_ultra|gpt6_astra_max|gpt6_astra_xhigh|gpt56_terra_high|gpt56_terra_med) fallback_profile="gpt56_luna_low" ;;
+      gpt6_astra_ultra|gpt6_astra_max|gpt6_astra_xhigh|gpt6_sol_high|gpt6_sol_med|gpt6_luna_high) fallback_profile="gpt6_luna_low" ;;
     esac
     if [[ -n "$fallback_profile" ]]; then
       echo "[tfx-route] tier fallback: $CLI_EFFORT not supported on ChatGPT account → retry with $fallback_profile" >&2

package/skills/tfx-auto/SKILL.md

@@ -1009,10 +1009,11 @@ Agent(subagent_type="oh-my-claudecode:{agent}", model="{model}", prompt="{prompt
 
 | 입력 | CLI | MCP |
 |------|-----|-----|
-| codex / executor / spark | Codex (high; 복잡 구현은 deep-executor/xhigh) | implement |
-| debugger / deep-executor | Codex (xhigh) | implement |
-| build-fixer | Codex (low) | implement |
-| architect / planner / critic / analyst | Codex (xhigh) | analyze |
+| codex / executor | Codex (`gpt6_sol_high`; 복잡 구현은 deep-executor/xhigh) | implement |
+| debugger / deep-executor | Codex (`gpt6_astra_xhigh`) | implement |
+| build-fixer | Codex (`gpt6_luna_high`) | implement |
+| spark | Codex (`gpt6_luna_low`) | implement |
+| architect / planner / critic / analyst | Codex (`gpt6_astra_xhigh`) | analyze |
 | scientist / document-specialist | Codex | analyze |
 | code-reviewer / security-reviewer / quality-reviewer | Codex (review) | review |
 | antigravity / designer / writer | Antigravity | docs |

package/skills/tfx-live/SKILL.md

@@ -3,19 +3,20 @@ name: tfx-live
 description: >
   Use when Claude, Codex, or a Triflux worker needs live Claude↔Codex orchestration:
   start/ask/stop, multi-turn, peer relay, daemon UDS attach, or UDS-first with tmux fallback.
-argument-hint: "<start|ask|stop|probe|list-sessions|peer|converse|goal-driven> ..."
+argument-hint: "<start|ask|stop|interrupt|probe|list-sessions|peer|converse|goal-driven|orchestrate> ..."
 ---
 
-# tfx-live — Claude↔Codex live orchestration
+# tfx-live: Claude↔Codex live orchestration
 
 `tfx-live` is the Triflux-owned live bridge for Claude Code and Codex TUI sessions.
-It runs as a local CLI (`tfx-live`) and supports tmux TUI control plus Claude daemon UDS attach.
+It runs as a local CLI (`tfx-live`) and supports tmux TUI control plus Claude and Codex daemon UDS attach.
 
 ## Default transport
 
 - Claude targets with `--short` or `--session-id`: **UDS-first `auto` by default**.
 - If UDS probe/attach fails: write `~/.claude/cache/triflux/tfx-live/bug-reports/uds-fallback-*.json`, then tmux fallback when `--session` is provided.
 - Codex targets and Claude targets without a daemon ref: tmux by default.
+- Codex existing threads use explicit `--transport uds --thread <id|auto>`; `auto` transport remains Claude-only.
 - UDS completion contract: `done=true` only when `matchedCompletion===true`; `timedOut` or `closed` is not completion.
 - Bridge resolution: `--bridge` > `$TFX_BRIDGE` > `$TFX_REPO_ROOT/hub/bridge.mjs` > bundled Triflux `hub/bridge.mjs`.
 
@@ -58,7 +59,8 @@ tfx-live ask --cli claude --transport uds --short <8hex> --prompt "..." --timeou
 
 List the Codex CLI sessions already running in tmux; this does not require a
 prior `tfx-live start`. The JSON result includes the tmux session name, start
-time, current working directory, and attachment state.
+time, current working directory, attachment state, `panes: [{ target, cwd,
+command }]` for Codex panes, and `target` for the first matching pane.
 
 ```bash
 # All locally running Codex tmux sessions
@@ -70,7 +72,73 @@ tfx-live list-sessions --cli codex --cwd ~/Projects/my-worktree
 
 `probe` remains the Claude daemon/UDS discovery command. Use
 `list-sessions --cli codex` when selecting an existing Codex tmux session to
-pass to `tfx-live ask --session <name>`.
+pass to `tfx-live ask --session <name:window.pane>`.
+Discovery and peer preflight also inspect pane tty/descendant processes for
+the npm `node .../codex` shim, `codex.js`, and native `codex` executables.
+`codex-code-mode-host` does not count. With `--remote`, the process check runs
+on that host; unavailable `ps` produces a peer `preflightWarning` and allows
+attach to continue.
+
+`ask` and tmux `interrupt` accept session names, `name:window`, and
+`name:window.pane`. `start` and `stop` require a session name only; `stop`
+rejects pane targets because it kills the entire session. `--remote HOST`
+preserves the complete target.
+`stop` also rejects pane/window IDs such as `%12` and `@3`, and dotted targets.
+
+Before pasting, `ask` checks the visible pane for active work and Codex
+`model: loading`. `--if-busy wait|fail|interrupt` defaults to `wait`.
+`--busy-timeout SECONDS` defaults to `--timeout`; `--poll-interval` is in
+milliseconds. A busy timeout sends no prompt. `interrupt` sends Escape,
+then waits for idle before pasting. Results include `ifBusy` and
+`busyWaitedMs`. `converse`, `goal-driven`, and `peer` accept these flags too.
+Only the last visible `model:` header controls loading detection. Time-only
+lines are removed from the response tail; times inside the answer remain.
+
+## Existing Codex TUI thread over UDS
+
+With `daemon_auto_start` enabled, Codex TUI runs on a shared local app-server
+daemon. Its default socket is
+`$CODEX_HOME/app-server-control/app-server-control.sock`, or the same path
+under `~/.codex` when `CODEX_HOME` is unset. `--codex-socket PATH|default`
+selects an existing socket and follows symlinks. If absent, start the daemon
+with `codex app-server daemon start`.
+
+```bash
+tfx-live list-sessions --cli codex --transport uds --cwd ~/Projects/my-worktree
+tfx-live ask --cli codex --transport uds --thread auto \
+  --cwd ~/Projects/my-worktree --prompt "현재 변경사항을 요약해줘" \
+  --if-busy wait --busy-timeout 120 --timeout 120
+tfx-live ask --cli codex --transport uds --thread <id> \
+  --codex-socket default --prompt "추가 확인 사항" --if-busy fail
+```
+
+No `--session`, `--short`, or `--session-id` is required. Discovery returns
+`[{ threadId, cwd, name, status, source }]` for loaded threads. `--thread auto`
+selects exactly one loaded thread after optional realpath-normalized `--cwd`
+filtering. Start the TUI and send its first message if none is loaded. Multiple
+matches produce an error listing candidates; select an explicit thread ID.
+
+The client calls `thread/resume` with `excludeTurns: true` before `turn/start`
+to subscribe to response notifications. It does not request historical turns.
+UDS `--if-busy wait|fail|steer` defaults to `wait`.
+`steered` uses the returned turn ID and fresh `turn/started` events after
+subscription, not the earlier busy snapshot; when a current turn ID is
+available, `turn/steer` sends it as `expectedTurnId`.
+The fallback treats no fresh matching `turn/started` before completion as a
+reused turn; it relies on ordered notifications from the resumed connection.
+Completion matches the returned turn ID. Closing the client
+does not archive or delete the thread, or start or stop the shared daemon.
+Responses prefer completed `final_answer` items, joined with blank lines;
+without one, the last agent message is used. Intermediate commentary is
+returned separately. Retryable error notifications keep the turn open and
+increment `meta.retries`.
+`--max-turn SECONDS` sets the Codex UDS activity extension ceiling. Remote
+relay timeouts include busy waiting, the full turn allowance, and a relay margin.
+Codex relay budgets also allow the next lifecycle timer check after that ceiling.
+
+Codex UDS `interrupt` is unavailable: `turn/interrupt` requires a turn ID,
+which the supported metadata-only `thread/read` does not provide. Use tmux
+`interrupt --session <target>` when the TUI pane is available.
 
 ## Peer relay
 
@@ -86,9 +154,41 @@ tfx-live peer --cli-a codex --cli-b claude \
   --session-a cx-peer --session-b cl-fallback --short-b <8hex> \
   --cwd ~/Projects --mode freeform --seed "서로 응답을 다음 프롬프트로 이어받아라" \
   --rounds 2 --timeout 180
+
+# Attach both existing tmux panes without starting or stopping their sessions
+tfx-live peer --cli-a codex --cli-b claude \
+  --session-a work:0.1 --session-b work:0.2 --attach-a --attach-b \
+  --mode freeform --seed "변경을 검토해줘" --if-busy wait
+
+# Existing Codex daemon thread + existing Claude daemon session
+tfx-live peer --cli-a codex --transport-a uds --thread-a <id|auto> \
+  --codex-socket-a default --cli-b claude --transport-b uds --short-b <8hex> \
+  --cwd ~/Projects/my-worktree --mode freeform --seed "변경을 검토해줘"
 ```
 
-In `peer`, every hop sends the previous response as the next prompt to the opposite agent; the final JSON is only the transcript.
+In `peer`, every hop sends the previous response as the next prompt to the opposite agent; the final JSON includes the transcript and lifecycle metadata.
+
+`--attach-a` and `--attach-b` preflight existing tmux targets before any hop.
+Codex targets must identify a Codex pane. Attached sessions are preserved on
+success, error, SIGINT, and SIGTERM. UDS sides are always treated as attached.
+The result includes `attachedA` and `attachedB`. Side-specific UDS flags are
+`--thread-a`, `--thread-b`, `--codex-socket-a`, and `--codex-socket-b`.
+`--if-busy-a` and `--if-busy-b` accept `wait|fail|interrupt` for tmux and
+`wait|fail|steer` for Codex UDS. A common `--if-busy` must be valid for both
+sides even when one side overrides it. UDS done-marker lines are removed
+before relaying a response. `stoppedA`/`stoppedB` are true only after an owned
+session was actually stopped; attached sides stay false.
+
+## Known limits
+
+- A draft in the TUI composer can merge with the pasted prompt. Changing
+  placeholder text prevents reliable detection without terminal styling.
+- `--thread auto` can be ambiguous when an ephemeral orchestrate thread
+  remains loaded. The candidate-list error exposes this; choose a thread ID.
+- A TUI's thread stays loaded in the shared daemon after that TUI exits
+  (observed with codex-cli 0.156.1: a `tfx-live stop`ped peer session left its
+  thread in `thread/loaded/list`). Stale threads in the same cwd make
+  `--thread auto` ambiguous, so pin `--thread ID` for long-lived targets.
 
 ## Orchestrate (Claude UDS + Codex)
 
@@ -101,12 +201,17 @@ tfx-live orchestrate --task "이 변경의 위험을 한 줄로" --mode peer
 # experimental: Codex over a real `codex app-server` WebSocket-over-UDS daemon
 tfx-live orchestrate --task "이 변경의 위험을 한 줄로" \
   --mode codex-led --codex-transport app-server-uds --timeout 120
+
+# Attach the shared daemon and create a new ephemeral thread for orchestration
+tfx-live orchestrate --task "이 변경의 위험을 한 줄로" \
+  --mode codex-led --codex-socket default --timeout 120
 ```
 
 - `--mode` = `peer` (default) | `codex-led` | `claude-led`.
 - `--codex-transport` = `exec` (default, `codex exec` stdio) | `app-server-uds` (experimental).
   - `app-server-uds` spawns a private `codex app-server --listen unix://<tmp>`, attaches over WebSocket-over-UDS (RFC 6455, masked client frames), runs `initialize`→`thread/start`→`turn/start`, and resolves on `turn/completed`. Transport proven against codex-cli 0.135.0 (see `experiments/native-bridge-feasibility/codex-app-server-uds-smoke.mjs`).
-  - It is NOT the default — the existing `codex exec` path is unchanged.
+  - `--codex-socket PATH|default` implies `app-server-uds` and conflicts with explicit `--codex-transport exec`. It attaches without spawning or killing the daemon and still creates a new ephemeral thread.
+  - Without `--codex-socket`, `app-server-uds` uses the private server path; the default transport remains `exec`.
 - Requires a live Claude daemon (same as the UDS `ask` path) for the Claude side.
 
 ## Useful diagnostics

package/skills/tfx-profile/SKILL.md

@@ -45,7 +45,7 @@ options:
 ```
 | 프로파일 | 모델 | Effort |
 |----------|------|--------|
-| gpt56_terra_high | 프로필 설정의 현재 모델 | high |
+| gpt6_sol_high | 프로필 설정의 현재 모델 | high |
 | ...  | ...           | ...  |
 ```
 
@@ -75,9 +75,10 @@ options:
 2. AskUserQuestion으로 프로필/alias 선택:
    ```
    options:
-     - label: "gpt56_terra_high" → 기본 고품질 (Recommended)
-     - label: "gpt56_terra_med"  → 균형형
-     - label: "gpt56_luna_low"   → 빠른 경량
+     - label: "gpt6_sol_high"    → 구현과 리뷰 기본값 (Recommended)
+     - label: "gpt6_sol_med"     → 정리와 리팩터 균형형
+     - label: "gpt6_luna_high"   → 명확한 반복 작업
+     - label: "gpt6_luna_low"    → 지연 우선 경량
      - label: "gpt6_astra_xhigh" → 고강도 추론
      - label: "gpt6_astra_max"   → 최난도 단일 작업
      - label: "gpt6_astra_ultra" → 최상위 자동 위임 (비중첩 전용)
@@ -187,12 +188,13 @@ options:
 
 | 프로필 | 용도 |
 |------|------|
-| gpt56_terra_high | 기본 고품질 |
+| gpt6_sol_high | 구현과 리뷰 기본값 |
 | gpt6_astra_xhigh | 고강도 추론 |
 | gpt6_astra_max | 최난도 단일 작업 |
 | gpt6_astra_ultra | 최상위 자동 위임 (비중첩 전용) |
-| gpt56_terra_med | 균형형 |
-| gpt56_luna_low | 빠른 경량 |
+| gpt6_sol_med | 정리와 리팩터 균형형 |
+| gpt6_luna_high | 명확한 반복 작업 |
+| gpt6_luna_low | 지연 우선 경량 |
 | custom | 사용자가 관리하는 프로필 |
 
 ### Codex Effort 레벨

package/skills/tfx-setup/SKILL.md

@@ -112,7 +112,7 @@ Bash("triflux setup")
 #### 단계 3: Codex 프로파일
 
 `~/.codex/config.toml`을 Read 도구로 읽어 필수 프로파일 존재 여부 확인.
-필수: `gpt6_astra_ultra`, `gpt6_astra_max`, `gpt6_astra_xhigh`, `gpt56_terra_high`, `gpt56_terra_med`, `gpt56_luna_low`.
+필수: `gpt6_astra_ultra`, `gpt6_astra_max`, `gpt6_astra_xhigh`, `gpt6_sol_high`, `gpt6_sol_med`, `gpt6_luna_high`, `gpt6_luna_low`.
 
 - 모두 존재 → ✅ 표시
 - 누락 있으면 → AskUserQuestion: