triflux 10.61.2 → 10.63.0

package/scripts/setup.mjs

@@ -36,6 +36,10 @@ import {
   recordFile,
   renderCliResult,
 } from "./lib/cli-output.mjs";
+import {
+  ensureManagedCodexProfiles,
+  normalizeCodexProfileName,
+} from "./lib/codex-profile-config.mjs";
 import { ensureGeminiProfiles } from "./lib/gemini-profiles.mjs";
 import {
   retireInstallLeftovers,
@@ -56,6 +60,7 @@ import {
   resolveMachineProfilePath,
   resolveTrifluxHome,
 } from "./lib/machine-profile.mjs";
+import { CODEX_FAMILY_PROFILES } from "./lib/model-family-resolver.mjs";
 import { parseFrontmatter } from "./lib/skill-template.mjs";
 import { resolveStableNodeBin } from "./lib/stable-node.mjs";
 import { isTestRun, writesRealHomeInTest } from "./lib/test-env.mjs";
@@ -568,39 +573,12 @@ const BREADCRUMB_PATH = join(CLAUDE_DIR, "scripts", ".tfx-pkg-root");
 const SETTINGS_PATH = join(CLAUDE_DIR, "settings.json");
 const HUD_PATH = join(CLAUDE_DIR, "hud", "hud-qos-status.mjs");
 
-const REQUIRED_CODEX_PROFILES = [
-  // GPT-6 Astra: max/ultra are explicit exception lanes, not role defaults.
-  {
-    name: "gpt6_astra_ultra",
-    lines: ['model = "gpt-6-astra"', 'model_reasoning_effort = "ultra"'],
-  },
-  {
-    name: "gpt6_astra_max",
-    lines: ['model = "gpt-6-astra"', 'model_reasoning_effort = "max"'],
-  },
-  {
-    name: "gpt6_astra_xhigh",
-    lines: ['model = "gpt-6-astra"', 'model_reasoning_effort = "xhigh"'],
-  },
-  // GPT-6.1 Sol: implementation, review, and verification role defaults.
-  {
-    name: "gpt61_sol_high",
-    lines: ['model = "gpt-6.1-sol"', 'model_reasoning_effort = "high"'],
-  },
-  {
-    name: "gpt61_sol_med",
-    lines: ['model = "gpt-6.1-sol"', 'model_reasoning_effort = "medium"'],
-  },
-  // GPT-6 Luna: high for focused lanes, low for latency-first lanes.
-  {
-    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"'],
-  },
-];
+const REQUIRED_CODEX_PROFILES = Object.entries(CODEX_FAMILY_PROFILES).map(
+  ([name, { model, effort }]) => ({
+    name,
+    lines: [`model = "${model}"`, `model_reasoning_effort = "${effort}"`],
+  }),
+);
 
 // Codex 0.134 마이그레이션: triflux 가 과거에 inline [profiles.*] 로 썼던 구형 프로필.
 // config.toml 에서 제거 대상 (retired 모델 — 별도 파일로 만들지 않는다).
@@ -1586,19 +1564,12 @@ function ensureCodexProfiles() {
     // 키)을 읽고, config.toml 의 inline [profiles.X] 테이블은 거부한다. 따라서
     // (a) 각 프로필을 별도 파일로 쓰고 (b) config.toml 의 inline 테이블을 제거한다.
     // ref: developers.openai.com/codex/config-advanced#profiles
-    for (const profile of REQUIRED_CODEX_PROFILES) {
-      const profilePath = join(CODEX_DIR, `${profile.name}.config.toml`);
-      const desiredContent = `${profile.lines.join("\n")}\n`;
-      const existingContent = existsSync(profilePath)
-        ? readFileSync(profilePath, "utf8")
-        : null;
-      if (existingContent !== desiredContent) {
-        writeFileSync(profilePath, desiredContent, CODEX_FILE_WRITE);
-        changed++;
-      }
-    }
+    changed += ensureManagedCodexProfiles({
+      home: _TFX_HOME,
+      codexHome: CODEX_DIR,
+    }).changed;
     // config.toml 의 모든 inline [profiles.*] 마이그레이션 (Codex 0.134 는 inline 거부).
-    //   - 관리 gpt6_*: 위에서 canonical 별도 파일을 썼으므로 inline 만 제거.
+    //   - 관리 가족 별칭과 옛 이름: 위에서 별도 파일을 썼으므로 inline 만 제거.
     //   - 구형 retired (codex53/spark53/gpt54/mini54): inline 제거, 재생성 안 함.
     //   - 그 외 사용자 커스텀: 본문을 보존해 별도 파일로 이관한 뒤 inline 제거.
     //     (별도 파일이 이미 있으면 덮어쓰지 않는다 — 사용자 수정 보존.)
@@ -1607,7 +1578,10 @@ function ensureCodexProfiles() {
     );
     const retiredProfileNames = new Set(LEGACY_CODEX_PROFILE_NAMES);
     for (const name of listInlineProfileNames(updated)) {
-      if (!managedProfileNames.has(name) && !retiredProfileNames.has(name)) {
+      if (
+        !managedProfileNames.has(normalizeCodexProfileName(name)) &&
+        !retiredProfileNames.has(name)
+      ) {
         const customPath = join(CODEX_DIR, `${name}.config.toml`);
         if (!existsSync(customPath)) {
           const lines = extractProfileLines(updated, name);
@@ -2432,7 +2406,7 @@ async function runDeferredWithIo(stdinData, io) {
   const geminiDir = join(_TFX_HOME, ".gemini");
   if (!isProtectedSetupEnv() && existsSync(geminiDir)) {
     geminiProfilesResult = ensureGeminiProfiles({ geminiDir });
-    if (geminiProfilesResult.ok && geminiProfilesResult.added > 0) synced++;
+    if (geminiProfilesResult.ok && geminiProfilesResult.changed) synced++;
     else if (!geminiProfilesResult.ok)
       io.warn(
         "gemini-profiles",

package/scripts/tfx-route.sh

@@ -903,96 +903,26 @@ capture_workspace_signature() {
 }
 
 # ── Gemini 모델 프로필 해석 ──
-_GEMINI_PROFILE_CACHE=""
 resolve_gemini_profile() {
-  local profile="$1"
-  if [[ "$profile" == gemini-* ]]; then
-    echo "$profile"
-    return
-  fi
-  if [[ -z "$_GEMINI_PROFILE_CACHE" && -f "$GEMINI_PROFILES_PATH" ]]; then
-    _GEMINI_PROFILE_CACHE=$(cat "$GEMINI_PROFILES_PATH" 2>/dev/null || echo "{}")
-  fi
   local result
-  result=$("$NODE_BIN" -e "
-    const name = process.argv[1];
-    const primaryRaw = process.argv[2] || '{}';
-    const defaults = {
-      flash38_low: 'Gemini 3.8 Flash (Low)',
-      flash38: 'Gemini 3.8 Flash (Medium)',
-      flash38_high: 'Gemini 3.8 Flash (High)'
-    };
-
-    if (typeof name === 'string' && name.startsWith('gemini-')) {
-      process.stdout.write(name);
-      process.exit(0);
-    }
-
-    const parseJson = (raw) => {
-      try {
-        const parsed = JSON.parse(raw);
-        return parsed && typeof parsed === 'object' ? parsed : {};
-      } catch {
-        return {};
-      }
-    };
-
-    const getModelValue = (entry) => {
-      if (!entry) return '';
-      if (typeof entry === 'string') return entry;
-      if (typeof entry !== 'object') return '';
-      if (typeof entry.model === 'string') return entry.model;
-      if (typeof entry.name === 'string' && entry.name.startsWith('gemini-')) return entry.name;
-      if (entry.model && typeof entry.model.name === 'string') return entry.model.name;
-      return '';
-    };
-
-    const getProfileBuckets = (cfg) => {
-      const buckets = [];
-      if (cfg.profiles && typeof cfg.profiles === 'object') buckets.push(cfg.profiles);
-      if (cfg.model?.profiles && typeof cfg.model.profiles === 'object') buckets.push(cfg.model.profiles);
-      if (cfg.modelProfiles && typeof cfg.modelProfiles === 'object') buckets.push(cfg.modelProfiles);
-      if (cfg.models && typeof cfg.models === 'object') buckets.push(cfg.models);
-      return buckets;
-    };
-
-    const getDefaultModel = (cfg) => {
-      return (
-        (typeof cfg.defaultModel === 'string' && cfg.defaultModel) ||
-        (typeof cfg.default_profile === 'string' && cfg.default_profile) ||
-        (typeof cfg.defaultProfile === 'string' && cfg.defaultProfile) ||
-        (typeof cfg.model === 'string' && cfg.model) ||
-        (typeof cfg.model?.default === 'string' && cfg.model.default) ||
-        ''
-      );
-    };
-
-    const sources = [parseJson(primaryRaw)];
-    for (const cfg of sources) {
-      for (const bucket of getProfileBuckets(cfg)) {
-        const value = getModelValue(bucket[name]);
-        if (value) {
-          process.stdout.write(value);
-          process.exit(0);
-        }
-      }
-    }
-
-    if (name === 'default') {
-      for (const cfg of sources) {
-        const value = getDefaultModel(cfg);
-        if (value) {
-          process.stdout.write(value);
-          process.exit(0);
-        }
-      }
-    }
-
-    process.stdout.write(defaults[name] || defaults[process.env.TFX_GEMINI_DEFAULT_PROFILE] || defaults.flash38);
-  " "$profile" "$_GEMINI_PROFILE_CACHE" 2>/dev/null)
+  result=$("$NODE_BIN" --input-type=module -e '
+    import { pathToFileURL } from "node:url";
+    const { ensureGeminiProfiles, resolveGeminiModel } = await import(pathToFileURL(process.argv[1]).href);
+    const opts = { profilesPath: process.argv[3], command: process.argv[4] };
+    ensureGeminiProfiles(opts);
+    process.stdout.write(resolveGeminiModel(process.argv[2], opts));
+  ' "${CODEX_PROFILE_MODULE%/*}/gemini-profiles.mjs" "$1" "$GEMINI_PROFILES_PATH" "$CLI_CMD" 2>/dev/null)
   echo "${result:-Gemini 3.8 Flash (Medium)}"
 }
 
+refresh_codex_profiles() {
+  "$NODE_BIN" --input-type=module -e '
+    import { pathToFileURL } from "node:url";
+    const { ensureManagedCodexProfiles } = await import(pathToFileURL(process.argv[1]).href);
+    ensureManagedCodexProfiles({ command: process.argv[2] });
+  ' "$CODEX_PROFILE_MODULE" "$CLI_CMD" 2>/dev/null || true
+}
+
 # ── 라우팅 테이블 ──
 # CLI_TYPE/CLI_CMD는 agent-map, 역할별 설정은 agent-route-policy에서 조회한다.
 # 반환: CLI_TYPE, CLI_CMD, CLI_ARGS, CLI_EFFORT, DEFAULT_TIMEOUT
@@ -1258,11 +1188,11 @@ resolve_safe_retry_codex_profile() {
   local profile
   profile="$1"
   case "$profile" in
-    ultra|gpt6_astra_ultra|*_ultra)
-      echo "gpt6_astra_max"
+    ultra|astra_ultra|*_ultra)
+      echo "astra_max"
       return
       ;;
-    gpt6_luna_low|gpt6_luna_high|gpt61_sol_med|gpt61_sol_high|gpt6_astra_xhigh|gpt6_astra_max)
+    luna_low|luna_high|sol_med|sol_high|astra_xhigh|astra_max)
       echo "$profile"
       return
       ;;
@@ -1272,14 +1202,14 @@ 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 "gpt61_sol_high"
+    echo "sol_high"
     return 0
   fi
   local effort
   effort="$(read_codex_profile_effort "$profile")"
   case "$effort" in
-    ultra) echo "gpt6_astra_max" ;;
-    "") echo "gpt61_sol_high" ;;
+    ultra) echo "astra_max" ;;
+    "") echo "sol_high" ;;
     *) echo "$profile" ;;
   esac
 }
@@ -1328,18 +1258,18 @@ apply_codex_concrete_effort_guard() {
   [[ -n "$profile" ]] || return 0
 
   local allow_ultra=0
-  if [[ "$CODEX_OVERRIDE_PROFILE" == "gpt6_astra_ultra" && -z "${TFX_RETRY_SNAPSHOT:-${TFX_RETRY_SNAPSHOT_FILE:-}}" ]]; then
+  if [[ "$CODEX_OVERRIDE_PROFILE" == "astra_ultra" && -z "${TFX_RETRY_SNAPSHOT:-${TFX_RETRY_SNAPSHOT_FILE:-}}" ]]; then
     allow_ultra=1
   fi
   local effort target_profile=""
   effort="$(read_codex_profile_effort "$profile")"
   case "$profile" in
-    gpt6_astra_max) target_profile="gpt6_astra_max" ;;
-    gpt6_astra_ultra) target_profile="gpt6_astra_max" ;;
-    *) [[ "$effort" != "ultra" ]] || target_profile="gpt6_astra_max" ;;
+    astra_max) target_profile="astra_max" ;;
+    astra_ultra) target_profile="astra_max" ;;
+    *) [[ "$effort" != "ultra" ]] || target_profile="astra_max" ;;
   esac
   [[ -n "$target_profile" ]] || return 0
-  [[ "$allow_ultra" -ne 1 ]] || target_profile="gpt6_astra_ultra"
+  [[ "$allow_ultra" -ne 1 ]] || target_profile="astra_ultra"
   for ((i = 0; i < ${#args[@]}; i++)); do
     case "${args[$i]}" in
       --profile) args[$((i + 1))]="$target_profile" ;;
@@ -1944,7 +1874,7 @@ run_antigravity_exec() {
   # "${agy_args[@]}" expand 시 단일 인자로 보존된다. 모델 SSOT 는 프로필 설정이다.
   if [[ -z "${TFX_GEMINI_NO_MODEL:-}" ]]; then
     local _agy_model
-    _agy_model="$(resolve_gemini_profile "${TFX_GEMINI_PROFILE:-${GEMINI_PROFILE:-flash38}}")"
+    _agy_model="$(resolve_gemini_profile "${TFX_GEMINI_PROFILE:-${GEMINI_PROFILE:-flash}}")"
     if [[ -n "$_agy_model" ]]; then
       agy_args+=("--model" "$_agy_model")
     fi
@@ -2118,6 +2048,7 @@ _codex_stdout_has_meaningful_output() {
 }
 
 run_codex_exec() {
+  refresh_codex_profiles
   local prompt="$1"
   local use_tee_flag="$2"
   local exit_code_local=0
@@ -2152,7 +2083,7 @@ run_codex_exec() {
   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|gpt61_sol_high|gpt61_sol_med|gpt6_luna_high) fallback_profile="gpt6_luna_low" ;;
+      astra_ultra|astra_max|astra_xhigh|sol_high|sol_med|luna_high) fallback_profile="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

@@ -166,7 +166,7 @@ agy 레인은 `TFX_AGY_ANTI_OVERCLAIM`(기본 on) 으로 완료/grounding 규율
 
 `DEFAULT_ESCALATION_CHAIN`의 프로필 설정은 `.claude/rules/tfx-escalation-chain.md`와 CLI 프로필 설정을 따른다.
 
-1. Codex: `gpt6_astra_max` 프로필
+1. Codex: `astra_max` 프로필
 2. Claude: 최종 수단 프로필
 
 체인 규칙:

package/skills/tfx-lead/SKILL.md

@@ -50,14 +50,14 @@ tmux ls         # 없으면
 | 역할 | 모델 | 비고 |
 | --- | --- | --- |
 | 리드 (Claude) | Claude 최상위 tier, effort high | 지휘와 판정만 맡는다 |
-| 리드 (Codex) | `gpt6_astra_xhigh` | 지휘와 판정만 맡는다 |
+| 리드 (Codex) | `astra_xhigh` | 지휘와 판정만 맡는다 |
 | 판단 중심 긴 작업 | Claude `opus` | 설계 검토, 긴 구현 |
 | 반복 검증, 정형 문서 | Claude `sonnet` | 테스트 재실행, 표 갱신 |
 | `opus`로 안 풀리는 난제 | Claude `fable` | 최종 수단 |
-| Codex 설계, 비평, 디버그 | `gpt6_astra_xhigh` | |
-| Codex 일반 구현, 리뷰 | `gpt61_sol_high` | |
-| Codex 정리 | `gpt61_sol_med` | |
-| Codex 반복 작업 | `gpt6_luna_high` | |
+| Codex 설계, 비평, 디버그 | `astra_xhigh` | |
+| Codex 일반 구현, 리뷰 | `sol_high` | |
+| Codex 정리 | `sol_med` | |
+| Codex 반복 작업 | `luna_high` | |
 | Codex 시험용 | 역할 프로필에 effort low | 연결 확인용 |
 
 - Codex 주간 한도가 낮으면 새 Codex 워커 대신 Claude 로 돌린다.

package/skills/tfx-live/SKILL.md

@@ -3,7 +3,7 @@ name: tfx-live
 description: >
   Claude·Codex·agy 세션을 실시간으로 생성·질의·대기·압축·종료하거나,
   tmux/daemon UDS 연결과 peer 중계를 운영할 때 사용한다.
-argument-hint: "<start|ask|wait|queue|compact|stop|rename|interrupt|probe|list-sessions|peer|converse|goal-driven> [--cli codex|claude|agy] ..."
+argument-hint: "<start|ask|wait|queue|goal|compact|stop|rename|interrupt|probe|list-sessions|peer|converse|goal-driven> [--cli codex|claude|agy] ..."
 ---
 
 # tfx-live
@@ -53,11 +53,13 @@ agy `ask`의 기본 `--if-busy queue`는 바쁜 턴에도 바로 전송한다. a
 
 | 동작 | 적용 조건과 실행 |
 | --- | --- |
-| compact | 같은 목표와 담당이 이어지고 파일과 git에서 상태를 복구할 수 있을 때. Claude는 `tfx-live compact` 또는 `/compact <보존 지침>`, Codex는 `/compact` 뒤 리드가 파일 경로와 검증 명령을 다시 전달한다. agy는 수동 compact가 없어 handoff한다. |
+| compact | 같은 목표와 담당이 이어지고 파일과 git에서 상태를 복구할 수 있을 때. Claude와 Codex는 `tfx-live compact --then "다음 지시" --no-wait`로 압축 제출을 확인하고 다음 지시를 미리 넣는다. 압축 뒤에 필요한 파일 경로와 검증 명령도 `--then`에 싣는다. agy는 수동 compact가 없어 handoff한다. |
 | clear | 무관한 작업으로 전환하거나 같은 문제를 두 번 넘게 고쳐도 실패할 때, 스펙에서 구현으로 또는 작성자에서 리뷰어로 바뀔 때. 미완료 상태를 정리한 뒤 Claude는 `/rename`과 `/clear`, Codex는 작업 종료 뒤 `/new <이름>`, agy는 `/clear`를 쓴다. |
 | handoff | 담당·CLI·모델·소유자가 바뀌거나 긴 작업이 창을 넘길 때. 인계 파일에 목표, 완료 조건, 체크아웃과 변경 상태, 확정 결정, 증거 경로, PASS/FAIL/SKIP, 미완료 작업과 프로세스, 다음 행동과 소유자, `predecessorSessionId`를 적는다. 승계 세션이 경로를 확인하면 이전 세션을 닫는다. |
 | close | 결과와 인계를 확인한 즉시 닫는다. Claude 백그라운드는 `claude stop <id>`, tmux는 `tfx-live stop --session`, Claude 팀원은 shutdown, Codex 서브에이전트는 `close_agent`, agy 서브에이전트는 `/agents` 패널의 K를 쓴다. |
 
+Claude TUI는 바쁠 때 들어온 입력을 대기열에 넣고 현재 턴(압축 포함)이 끝나면 순서대로 처리한다. transcript에는 `queue-operation`의 `enqueue`와 `dequeue`로 남는다. Codex app-server 큐도 바쁜 턴 뒤에 순서대로 처리한다. 리드는 compact를 보내고 `--then`으로 다음 지시를 넣는 것을 기본 절차로 쓴다.
+
 두 번째 compact 전에는 handoff가 맞는지 점검한다. compact 횟수는 고정하지 않는다.
 
 리드 역할 절차(역할별 모델, 지시서, 교차 리뷰, 릴리스 조율)는 `tfx-lead` 스킬을 따른다.
@@ -80,6 +82,23 @@ tfx-live queue --cli codex --thread <UUID> --delete <queuedMessageId>
 
 `queue`는 TUI가 아직 가져가지 않은 항목을 보고 지운다. Codex app-server의 실험 API `thread/queue/list`·`thread/queue/delete`를 stdio로 호출하며 큐 저장소 파일은 건드리지 않는다. 목록 항목은 `id`(ask 결과의 `queuedMessageId`와 같다), `requestId`, `text`다. 삭제 결과의 `missing`은 이미 TUI가 가져갔거나 없는 항목이다. 유휴 TUI는 쌓인 항목을 곧 가져가므로 지울 수 있는 것은 사실상 바쁜 세션과 닫힌 세션의 항목이다. 가져간 뒤의 처리 여부는 `wait`로 확인한다.
 
+### 네이티브 goal
+
+```bash
+tfx-live goal set --session cl1 --condition "관련 단위 테스트가 모두 통과한다"
+tfx-live goal set --session cx1 --cli codex --condition "관련 단위 테스트가 모두 통과한다" --budget 100000
+tfx-live goal status --session cx1
+tfx-live goal clear --session cx1
+```
+
+`--cli`를 생략하면 세션 프로세스에서 추정한다. 로컬 Claude와 Codex만 지원하며 `--remote`와 agy는 거부한다. `--budget`은 Codex set의 daemon 경로에서만 받고 Claude와 tmux 폴백에서는 오류로 거부한다.
+
+Claude는 tmux로 `/goal <조건>`과 `/goal clear`를 보내고 transcript의 마지막 `goal_status`로 상태를 읽는다. 별도 평가자의 완료는 `complete`, 수동 해제는 `none`이며 `judgedBy: "evaluator"`와 평가 이유를 보고한다. transcript를 찾지 못하면 상태는 `null`이고 경고를 남긴다. set/clear 뒤 새 sentinel을 최대 15초 확인하며 없으면 `confirmed: false`와 경고를 반환한다. 이미 해제된 goal의 clear는 입력 없이 `alreadyCleared: true`로 답한다. set은 기본 `--if-busy wait`, clear는 미충족 goal이 턴을 계속 이어 가도 끊을 수 있게 기본 `--if-busy interrupt`다. 평가자가 해제하지 않고 멈춘 goal은 `active`로 남으므로 리드가 `goal clear`로 정리한다.
+
+Codex는 공유 daemon UDS의 `thread/goal/*`를 우선 쓴다. `--codex-socket PATH|default`로 소켓을 고르고 기존 thread 해석 순서와 `--thread UUID`를 따른다. 새 goal은 `origin: "user"`로 clear 후 active set한다. 소켓이 없거나 thread가 미적재면 set/clear는 tmux 슬래시로, status는 `$CODEX_HOME/goals_1.sqlite`의 읽기 전용 조회로 폴백한다. `node:sqlite`를 지원하지 않는 Node에서는 상태를 `null`로 두고 경고한다. 결과에 `transport: "daemon"|"tmux"|"sqlite"`와 폴백 이유를 남긴다. tmux 폴백의 set/clear는 sqlite로 최대 15초 확인하고, 확인하지 못하면 재전송을 막으려고 오류 대신 `confirmed: false`와 경고를 반환한다. Codex의 `judgedBy: "model"`, `complete`는 모델 자기 판정이므로 리드의 교차 검증이 필요하다.
+
+Claude와 Codex는 네이티브 goal을 우선 쓰고, goal-driven은 agy처럼 네이티브 goal이 없을 때 쓰는 방식이다. 현재 agy의 goal-driven 실행은 지원하지 않는다.
+
 ### 컨텍스트 판단
 
 분모는 공식 모델 창이고 실행 한도가 더 작으면 그 한도 아래에서 운영한다. 아래 비율은 공식 권고가 아닌 **[추론] 운영값**이다. 모델 문서가 바뀌면 한도도 갱신한다.
@@ -99,13 +118,19 @@ Claude는 85% 도달 시 바로 handoff를 지시한다. agy 행은 운영 지
 ### 수동 compact와 종료
 
 ```bash
-tfx-live compact --cli claude --session cl1 --instructions "변경 파일과 검증 명령을 보존하라" --timeout 120
+tfx-live compact --cli claude --session cl1 --instructions "변경 파일과 검증 명령을 보존하라" --then "인계 파일을 읽고 검증을 이어가라" --no-wait
+tfx-live compact --cli codex --session cx1 --then "src/main.mjs를 확인하고 지정된 단위 테스트를 실행하라" --no-wait
+tfx-live wait --cli codex --session cx1 --request-id <then.requestId> --timeout 120
 tfx-live stop --cli claude --short <8hex>
 tfx-live stop --cli claude --session-id <id>
 tfx-live stop --session cl1
 ```
 
-`compact`는 로컬 Claude tmux `--session`에서 `/compact <instructions>`를 중계 표식 없이 보낸다. 기본 `--if-busy fail`이며 바쁜 세션에는 전송하지 않는다. 새 `compact_boundary`를 확인하면 `compacted: true`, `preTokens`, `postTokens`를 반환한다. 시간 안에 없으면 `compacted: false, timedOut: true`다. UDS compact는 지원하지 않는다.
+`compact --session S [--cli claude|codex] [--instructions TEXT] [--then PROMPT] [--no-wait]`는 로컬 tmux에서 `/compact`를 중계 표식 없이 보낸다. CLI 기본값은 Claude다. `--instructions`는 Claude에서만 받으며 Codex는 인자를 받지 않아 거부한다. 기본 `--if-busy fail`이며 바쁜 세션에는 compact를 전송하지 않는다. UDS compact는 지원하지 않는다.
+
+`--no-wait`는 압축 진행 표시 또는 새 완료 기록으로 제출을 확인한 뒤 반환한다. Codex에서 확인되지 않으면 Enter를 한 번 더 보내고, 그래도 확인되지 않으면 `--then`을 보내지 않고 오류로 끝낸다. `--then`은 일반 텍스트 지시만 받으며 슬래시 명령은 거부한다. 제출 확인 직후 Claude에는 표식을 붙여 tmux로 보내고 화면의 `queued messages` 또는 transcript의 `enqueue`로 확인한다. Claude 압축이 먼저 끝나 지시가 이미 처리에 들어갔으면 `then.queued: false, delivered: true`로 보고한다. Codex에는 기존 queue 경로로만 보내며 tmux로 전환하지 않는다. 결과의 `then.requestId`로 `wait --request-id`에서 압축 뒤 응답을 받는다.
+
+`--no-wait`가 없으면 Claude의 새 `compact_boundary`, Codex rollout의 새 `compacted`까지 기다린다. 결과에 `compact: {submitted: true, done}`과 `then: {requestId, queued, transport}`를 추가하고 기존 `compacted`, `preTokens`, `postTokens`를 유지한다. 토큰 수는 기록에 있는 값만 보고하며 Codex의 압축 후 token_count가 아직 없으면 `postTokens`는 `null`이다. 시간 안에 완료 기록이 없으면 `compacted: false, timedOut: true`다.
 
 `stop --short`와 `stop --session-id`는 `claude stop <id>`를 호출하고 `stopped: true, conversationKept: true`를 반환한다. `claude attach`로 대화를 재개할 수 있다. `/exit`, `←`, Ctrl+Z는 백그라운드 세션의 연결만 끊는다. macOS의 `sysctl -n kern.memorystatus_vm_pressure_level`이 2 이상이면 새 세션을 띄우기 전 정리한다. 원격 배정 전에는 `tfx-remote probe <host>`의 `ready`와 `warnings`를 확인한다.
 
@@ -120,7 +145,7 @@ tfx-live ask --cli codex --session cx1 --prompt "진행 상황을 보고해줘"
 tfx-live wait --cli codex --session cx1 --request-id <requestId> --timeout 120
 ```
 
-`ask --no-wait`는 Claude와 tmux에서 `status: "submitted"`, Codex queue에서 `status: "queued"`와 함께 `inputSent: true`, `done: false`, `submittedAt`, `target`, `requestId`를 반환한다. `ask`, `peer`, `converse`, `goal-driven`은 `[tfx-live req=<requestId>]`를 프롬프트 앞에 붙인다. `--no-relay-tag`로 제거하면 `wait --request-id`가 해당 요청을 찾을 수 없다.
+`ask --no-wait`는 Claude와 tmux에서 `status: "submitted"`, Codex queue에서 `status: "queued"`와 함께 `inputSent: true`, `done: false`, `submittedAt`, `target`, `requestId`를 반환한다. `ask`, `peer`, `converse`, `goal-driven`은 `[tfx-live req=<requestId>]`를 프롬프트 앞에 붙인다. `--no-relay-tag`로 제거하면 `wait --request-id`가 해당 요청을 찾을 수 없다. 슬래시 명령(`/rename`, `/clear` 등)은 CLI와 상관없이 표식 없이 보낸다. 응답 턴이 없는 Claude 내장 명령(`/rename`, `/clear`, `/compact`, `/model`, `/effort`, `/color`)은 기다리지 않고 `status: "submitted"`로 반환한다. 압축 완료까지 기다리려면 `compact` 명령을 쓴다.
 
 `wait`는 Claude transcript에서 표식을 user 메시지, `queue-operation`의 `enqueue` content, queued command attachment에서 찾는다. 표식이 소비된 턴이 끝난 뒤 마지막 assistant 텍스트를 응답으로 쓴다. 표식 없는 `wait`는 최신 user turn을 본다. `isSidechain`과 합성 API 오류 메시지는 정상 응답에서 제외한다. 요청을 소비한 턴에서 합성 오류가 나타나면 오류 문구와 `status: "failed"`를 반환한다. daemon의 `idle`만으로 완료를 단정하지 않는다. timeout은 `status: "working"`, `timedOut: true`, `done: false`다.
 

package/skills/tfx-setup/SKILL.md

@@ -18,7 +18,7 @@ HUD의 `statusLine`이 비어 있으면 triflux HUD를 등록한다. 이미 trif
 
 Codex 프로필은 `~/.codex/<이름>.config.toml`로 관리한다. 기본 설정 키는 `approval_policy`, `sandbox_mode`이며 CLI에는 `--profile`만 전달한다. 프로젝트 지침은 [CLAUDE.md](../../CLAUDE.md)의 `<codex-config>`를 따른다.
 
-Antigravity 프로필은 `~/.gemini/triflux-profiles.json`에서 Gemini 3.8 Flash Low, Medium, High를 사용한다. `agy`와 `codex`가 설치되지 않았으면 선택적 CLI 누락으로 보고한다.
+Antigravity 프로필은 `~/.gemini/triflux-profiles.json`에서 `flash_low`, `flash`, `flash_high` 가족 프로필을 자동 갱신한다. `agy`와 `codex`가 설치되지 않았으면 선택적 CLI 누락으로 보고한다.
 
 mods(사용량 band, 서브에이전트 effort 강제)는 `tfx setup --mods`로 설치한다. Claude Code 2.1.287 이상이 필요하다. 기본 setup은 marketplace 등록과 안내 한 줄만 한다.