triflux 10.9.26 → 10.9.28

package/CLAUDE.md

@@ -0,0 +1,212 @@
+<!-- prompt-hygiene:ignore line_count_warning -->
+# triflux — Claude Code 운영 가이드
+
+<core-systems>
+## 핵심 스킬 시스템 (항상 인지)
+
+이 프로젝트는 3개의 스킬 시스템을 동시에 사용한다. 어떤 작업이든 해당 시스템의 스킬이 있는지 먼저 확인한다.
+
+| 시스템 | 접두사 | 용도 | 스킬 수 |
+|--------|--------|------|---------|
+| **triflux** | `/tfx-*` | CLI 라우팅, 멀티모델 오케스트레이션, 스웜, 원격 실행 | ~40개 |
+| **gstack** | `/` (접두사 없음) | QA, ship, investigate, design, review, checkpoint | ~35개 |
+| **omc** | `/oh-my-claudecode:*` | autopilot, ralph, team, ultrawork, ccg | ~25개 |
+
+스킬을 모르면 자연어 라우팅(아래)으로 자동 매핑된다.
+세션 종료 전 메모리 파일이 3개+ 변경됐으면 `/memory-hygiene` 제안을 검토한다.
+</core-systems>
+
+<psmux-wt>
+## psmux/WT 규칙
+
+psmux 세션·WT 패인을 생성/조작/정리할 때 `tfx-psmux-rules` 스킬을 참조한다.
+WT 프리징 방지: exit → sleep 2 → kill 순서. 바로 kill하지 않는다.
+
+### wt.exe → wt-manager 경유
+
+safety-guard가 `wt.exe`, `wt new-tab`, `wt split-pane`, `Start-Process wt`를 차단한다.
+`hub/team/wt-manager.mjs`의 API를 사용한다.
+
+| 용도 | API |
+|------|-----|
+| 새 탭 | `createTab({ title, command, profile, cwd })` |
+| 패인 분할 | `splitPane({ direction: 'H'\|'V', title, command })` |
+| 다중 배치 | `applySplitLayout([{ title, command, direction }])` |
+| 탭 정리 | `closeTab(title)` / `closeStale({ olderThanMs, titlePattern })` |
+
+차단과 대안은 항상 쌍으로 존재해야 한다. 차단만 추가하고 대안을 안 만들면 데드락.
+
+### psmux에서 Codex 실행
+
+| 방식 | 동작 | 이유 |
+|------|------|------|
+| `codex` (interactive) | 불가 | psmux에서 TTY를 못 잡음 |
+| `codex < prompt.md` | 불가 | "stdin is not a terminal" |
+| `codex exec "$(cat prompt.md)" -s danger-full-access --dangerously-bypass-approvals-and-sandbox` | 사용 | 유일한 안전 경로 |
+
+`codex exec`는 config.toml `approval_mode`를 무시하므로 `--dangerously-bypass-approvals-and-sandbox` 필수.
+`-s` 유효값: read-only, workspace-write, danger-full-access.
+</psmux-wt>
+
+<codex-config>
+## Codex config.toml
+
+config.toml에 이미 설정된 값은 CLI 플래그로 중복 지정하지 않는다.
+
+| config.toml에 있으면 | CLI에서 생략 |
+|---------------------|-------------|
+| `approval_mode = "auto"` | `-a`, `--full-auto` |
+| `sandbox = "workspace-write"` | `-s`, `--full-auto` |
+
+안전 패턴: config.toml에 기본값을 두고, CLI에서는 `--profile` 선택만 한다.
+</codex-config>
+
+<account-broker>
+## AccountBroker (계정 브로커)
+
+conductor, headless, swarm-hypervisor가 하나의 AccountBroker 싱글턴을 공유한다.
+
+| 항목 | 설명 |
+|------|------|
+| 계정별 CircuitBreaker | 장애 격리 — 한 계정 오류가 다른 계정에 전파되지 않음 |
+| busy 플래그 | 동일 계정 이중 임대(double-lease) 방지 |
+| `/broker/reload` | 장시간 세션 중 accounts.json 핫리로드 |
+| EventEmitter 이벤트 | `lease`, `release`, `cooldown`, `tierFallback`, `circuitOpen`, `circuitClose`, `noAvailableAccounts` — HUD 연동용 |
+</account-broker>
+
+<remote>
+## 원격 실행
+
+### 스킬 구분
+
+| 스킬 | 대상 | 방식 |
+|------|------|------|
+| tfx-codex-swarm | 로컬 전용 | 로컬 worktree + psmux |
+| tfx-remote-spawn | Claude Code 원격 | SSH → Claude Code 세션 → 내부 tfx 라우팅 |
+
+codex를 SSH 너머로 직접 실행하지 않는다. config.toml 충돌 + TTY 문제.
+원격에서 codex가 필요하면: remote-spawn → Claude Code → Claude가 내부에서 codex 호출.
+
+### SSH 패턴
+
+hosts.json `os` 필드로 대상 셸을 판단한다. safety-guard도 이 필드를 참조.
+
+| 대상 OS | 셸 | 패턴 |
+|---------|-----|------|
+| windows | PowerShell | scp + `pwsh -File` 필수. `$var` → `$env:VAR`, `2>/dev/null` → `2>$null` |
+| darwin | zsh | 인라인 가능. brew PATH 주의 (`/opt/homebrew/bin`) |
+| linux | bash | 인라인 가능. 표준 POSIX |
+
+- `~` → `$HOME` 변환은 모든 OS 공통
+</remote>
+
+<headless-retrieval>
+## Headless 결과 회수
+
+background로 실행한 headless 결과는 **반드시 task-notification 완료 후** 읽는다.
+
+| 패턴 | 올바름 | 이유 |
+|------|--------|------|
+| task-notification 후 output 파일 읽기 | YES | 프로세스 종료 = 워커 전부 완료 |
+| task-notification 전 output 파일 tail | NO | 시작 메시지만 보이고 "실패"로 오진 |
+| psmux capture-pane으로 중간 체크 | NO | 워커 진행 중이면 빈 화면일 수 있음 |
+
+완료 마커: `=== HEADLESS_COMPLETE succeeded=N failed=N total=N ===`
+워커 상세: `$TMPDIR/tfx-headless/{sessionName}-worker-N.txt`
+</headless-retrieval>
+
+<cross-review>
+## 교차 검증
+
+- Claude 작성 코드 → Codex 리뷰
+- Codex 작성 코드 → Claude 리뷰
+- 동일 모델 self-approve 하지 않는다
+- git commit 전 미검증 파일 감지 시 nudge
+</cross-review>
+
+<session-context>
+## 맥락 이탈 판단
+
+현재 세션 맥락과 무관한 요청이 감지되면 psmux 격리를 제안한다.
+
+| 확신도 | 신호 | 행동 |
+|--------|------|------|
+| 확실 | "새 탭", "별도로", "새 세션" | 바로 psmux spawn |
+| 높음 | 다른 프로젝트/스택 언급 | 분리 제안 |
+| 중간 | 작업 유형 전환 | 분리 제안 + 현재 세션 옵션 |
+| 낮음 | 현재 작업 연장 | 세션 유지 |
+</session-context>
+
+<routing>
+## 자연어 → 스킬 라우팅
+
+사용자가 스킬명을 모르더라도 자연어로 요청하면 아래 규칙에 따라 적절한 스킬을 호출한다.
+
+### 행동 유형 → 스킬 매핑
+
+| 의도 | 자연어 신호 | 스킬 |
+|------|-----------|------|
+| 구현/수정 | 만들어, 고쳐, 구현해, 짜줘, 수정해, 바꿔 | tfx-auto |
+| 리뷰 | 봐줘, 리뷰해, 검토해, 괜찮아? | tfx-review |
+| 분석 | 분석해, 어떻게 돌아가?, 구조가 뭐야 | tfx-analysis |
+| 계획 | 계획, 어떻게 하지, 설계해 | tfx-plan |
+| 검색 | 찾아, 어디있어, 파일 찾아 | tfx-find |
+| 리서치 (빠른) | 검색해줘, 찾아봐, 공식문서, 이거 뭐야 | tfx-research |
+| 리서치 (자율) | 자율 리서치, 검색하고 정리해, research and plan | tfx-autoresearch |
+| 테스트 | 테스트, 검증, 돌려봐, QA | tfx-qa |
+| 정리 | 정리해, 슬롭 제거, 클린업 | tfx-prune |
+| 토론 | 뭐가 나을까, 비교해, A vs B | tfx-debate |
+
+### 깊이 수정자
+
+| 수정자 | 신호 | 효과 |
+|--------|------|------|
+| 기본 | (없음), 빠르게, 간단히 | Light 스킬 |
+| 깊이 | 제대로, 꼼꼼히, 철저히 | Deep 스킬 (tfx-deep-*). 예외: tfx-deep-interview는 Gemini 단독 |
+| 합의 | 3자, 교차, 다각도 | consensus 프로토콜 |
+| 반복 | 끝까지, 멈추지마, ralph | persist 모드 |
+| 자율 | 알아서, 자동으로, autopilot | autopilot 모드 |
+
+### CLI 라우팅
+
+headless-guard가 `codex exec` / `gemini -y -p` 직접 호출을 차단한다. tfx 스킬 경유 필수.
+
+**Layer 1 — Light** (tfx-route.sh → 단일 CLI)
+
+| 스킬 | CLI | 용도 |
+|------|-----|------|
+| tfx-auto | 자동 | 통합 진입점 |
+| tfx-codex | Codex | Codex 전용 |
+| tfx-gemini | Gemini | Gemini 전용 |
+| tfx-autopilot | Codex→검증 | 단일 파일, 5분 이내 |
+| tfx-autoroute | 자동 승격 | 실패→더 강한 모델 |
+
+**Layer 2 — Deep** (headless 3-CLI 합의)
+
+tfx-deep-review, tfx-deep-qa, tfx-deep-plan, tfx-deep-research, tfx-consensus, tfx-debate, tfx-panel, tfx-fullcycle, tfx-persist
+
+**Layer 3 — Remote/병렬**
+
+| 스킬 | 용도 |
+|------|------|
+| tfx-multi | 2+개 태스크 headless 병렬 |
+| tfx-swarm | PRD별 worktree + 다중 모델(Codex/Gemini/Claude) + 다중 기기(로컬+원격) |
+| tfx-remote-spawn | Claude Code 원격 세션 (SSH, setup 필수) |
+
+**Claude 네이티브** (CLI 불필요): tfx-find, tfx-forge, tfx-prune, tfx-index, tfx-setup, tfx-doctor, tfx-hooks, tfx-hub
+
+자원 우선순위: remote-spawn > swarm > multi > Light > 로컬 단독
+
+### 충돌 해소
+
+- ralph = persist alias
+- "auto" 단독 → tfx-auto. "알아서 해" → tfx-autopilot
+- "코드에서 찾아" → tfx-find. "알아봐" → tfx-research
+- 복합 의도: "구현하고 리뷰까지" → tfx-auto → cross-review hook
+
+### Q-Learning 동적 라우팅 (실험적)
+
+- `TRIFLUX_DYNAMIC_ROUTING=true` 또는 `1` 설정 시 Q-Learning 기반 동적 스킬 라우팅 활성화
+- `routing-weights.json` + Q-table로 스킬 선택 최적화
+- 기본 비활성
+</routing>

package/hub/server.mjs

@@ -809,7 +809,7 @@ export async function startHub({
       if (path === "/synapse/heartbeat" && req.method === "POST") {
         try {
           const body = await parseBody(req);
-          const { sessionId, partial } = body || {};
+          const { sessionId, ...partial } = body || {};
           const ok = synapseRegistry.heartbeat(sessionId, partial);
           if (!ok) {
             throw new Error("heartbeat failed");

package/hub/team/conductor.mjs

@@ -733,6 +733,9 @@ export function createConductor(opts = {}) {
       if (code === 0) {
         transition(session, STATES.COMPLETED, `exit_${code}`);
         emitter.emit("completed", { sessionId: session.id });
+        if (typeof session.config.onCompleted === "function") {
+          session.config.onCompleted({ sessionId: session.id });
+        }
         maybeAutoShutdown();
       } else {
         handleFailure(session, `remote_exit_${code}`);
@@ -891,6 +894,7 @@ export function createConductor(opts = {}) {
     }
 
     if (!session.child) return false;
+    if (!session.child.stdin?.writable) return false;
     try {
       session.child.stdin.write(`${text}\n`);
       eventLog.append("stdin", { session: id, text: text.slice(0, 100) });

package/hub/workers/gemini-worker.mjs

@@ -21,7 +21,7 @@ function toStringList(value) {
  * 빈 문자열은 ""로, 특수문자 포함 시 큰따옴표로 감싼다.
  */
 function quoteWindowsCmdArg(value) {
-  const raw = String(value ?? "");
+  const raw = String(value ?? "").replace(/[\r\n]/g, " ");
   if (raw.length === 0) return '""';
   if (!/[\s"()^&|<>%!]/.test(raw)) return raw;
   const escaped = raw
@@ -55,7 +55,7 @@ function buildSpawnSpec(command, args) {
 
   if (/\.(cmd|bat)$/i.test(resolved)) {
     const line = [resolved, ...args].map(quoteWindowsCmdArg).join(" ");
-    return { command: "cmd.exe", args: ["/d", "/s", "/c", line], shell: false };
+    return { command: "cmd.exe", args: ["/d", "/s", "/v:off", "/c", line], shell: false };
   }
 
   return { command: resolved, args, shell: false };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "triflux",
-  "version": "10.9.26",
+  "version": "10.9.28",
   "description": "CLI-first multi-model orchestrator for Claude Code — route tasks to Codex, Gemini, and Claude",
   "type": "module",
   "bin": {
@@ -13,75 +13,26 @@
     "tfx-doctor-tui": "bin/tfx-doctor-tui.mjs",
     "tfx-setup-tui": "bin/tfx-setup-tui.mjs"
   },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@triflux/core": "10.0.1",
+    "@triflux/remote": "^10.0.0-alpha.1"
+  },
   "files": [
     "bin",
-    "tui",
-    "hub",
-    "config",
     "skills",
-    "!skills/tfx-workspace",
-    "!**/failure-reports",
-    "scripts",
     "hooks",
     "hud",
+    "scripts",
+    "hub",
     "mesh",
-    ".claude-plugin",
+    "references",
+    "CLAUDE.md",
     "README.md",
-    "README.ko.md",
     "LICENSE"
   ],
-  "workspaces": [
-    "packages/core",
-    "packages/remote",
-    "packages/triflux"
-  ],
-  "scripts": {
-    "pack": "node scripts/pack.mjs all",
-    "pack:core": "node scripts/pack.mjs core",
-    "pack:remote": "node scripts/pack.mjs remote",
-    "setup": "node scripts/setup.mjs",
-    "preinstall": "node scripts/preinstall.mjs",
-    "postinstall": "node scripts/setup.mjs",
-    "lint": "biome check bin config hooks hub hud mesh scripts tests .claude-plugin .github package.json package-lock.json biome.json",
-    "lint:fix": "biome check --write bin config hooks hub hud mesh scripts tests .claude-plugin .github package.json package-lock.json biome.json",
-    "health": "npm test && npm run lint",
-    "test": "node scripts/test-lock.mjs --test --test-force-exit --test-concurrency=8 \"tests/**/*.test.mjs\" \"scripts/__tests__/**/*.test.mjs\"",
-    "test:unit": "node scripts/test-lock.mjs --test --test-force-exit --test-concurrency=8 tests/unit/**/*.test.mjs",
-    "test:integration": "node scripts/test-lock.mjs --test --test-force-exit --test-concurrency=8 tests/integration/**/*.test.mjs",
-    "test:route-smoke": "node scripts/test-lock.mjs --test scripts/test-tfx-route-no-claude-native.mjs",
-    "test:contract": "node scripts/test-lock.mjs --test --test-force-exit --test-concurrency=8 tests/contract/**/*.test.mjs",
-    "test:coverage": "node --experimental-test-coverage --test-coverage-lines=60 --test-coverage-functions=60 --test --test-force-exit --test-concurrency=8 \"tests/**/*.test.mjs\"",
-    "gen:skill-docs": "node scripts/gen-skill-docs.mjs",
-    "gen:skill-manifest": "node scripts/gen-skill-manifest.mjs",
-    "release:check-sync": "node scripts/release/check-sync.mjs",
-    "release:check-sync:fix": "node scripts/release/check-sync.mjs --fix",
-    "release:bump": "node scripts/release/bump-version.mjs",
-    "release:prepare": "node scripts/release/prepare.mjs",
-    "release:publish": "node scripts/release/publish.mjs",
-    "release:verify": "node scripts/release/verify.mjs"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/tellang/triflux.git"
-  },
-  "homepage": "https://github.com/tellang/triflux#readme",
-  "author": "tellang",
-  "license": "MIT",
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.27.1",
-    "better-sqlite3": "^12.6.2",
-    "pino": "^10.3.1",
-    "pino-pretty": "^13.1.3",
-    "systray2": "^2.1.4",
-    "zod": "^4.0.0"
-  },
-  "devDependencies": {
-    "@biomejs/biome": "^2.0.0",
-    "knip": "^6.3.0"
-  },
   "keywords": [
     "claude-code",
     "plugin",
@@ -92,5 +43,13 @@
     "multi-model",
     "triflux",
     "tfx"
-  ]
+  ],
+  "author": "tellang",
+  "license": "MIT",
+  "homepage": "https://github.com/tellang/triflux#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tellang/triflux.git",
+    "directory": "packages/triflux"
+  }
 }

package/references/hosts.json

@@ -0,0 +1,46 @@
+{
+  "hosts": {
+    "ultra4": {
+      "description": "Windows 데스크탑 (22코어/64GB RAM)",
+      "aliases": ["울트라", "울트라4", "데스크탑"],
+      "default_dir": "~/Desktop/Projects/cli/triflux",
+      "tailscale": {
+        "ip": "100.110.136.64",
+        "dns": "ultra-book-4-1",
+        "ssh_mode": "ssh-over-vpn"
+      },
+      "ssh_user": "SSAFY",
+      "os": "windows",
+      "specs": {
+        "cores": 22,
+        "ram_gb": 64,
+        "codex": "0.118.0",
+        "node": "24.14.0"
+      },
+      "capabilities": ["codex", "claude", "high-memory"]
+    },
+    "m2": {
+      "description": "MacBook Air M2 (8코어/16GB RAM)",
+      "aliases": ["맥", "맥북", "m2"],
+      "default_dir": "~/Desktop/Projects/triflux",
+      "tailscale": {
+        "ip": "100.104.61.126",
+        "dns": "tellang의-macbook-air",
+        "ssh_mode": "ssh-over-vpn"
+      },
+      "ssh_user": "tellang",
+      "os": "darwin",
+      "specs": {
+        "cores": 8,
+        "ram_gb": 16,
+        "claude": "2.1.89",
+        "codex": "0.114.0",
+        "gemini": "0.33.1",
+        "node": "25.9.0"
+      },
+      "capabilities": ["codex", "claude", "gemini"]
+    }
+  },
+  "default_host": "m2",
+  "triggers": ["원격에서", "다른 머신에서", "다른 컴퓨터에서"]
+}

package/scripts/tfx-route-worker.mjs

@@ -7,9 +7,9 @@ import { fileURLToPath, pathToFileURL } from "node:url";
 
 const SCRIPT_DIR = dirname(fileURLToPath(import.meta.url));
 const FACTORY_CANDIDATES = [
-  resolve(process.cwd(), "hub/workers/factory.mjs"),
   resolve(SCRIPT_DIR, "../hub/workers/factory.mjs"),
   resolve(SCRIPT_DIR, "./hub/workers/factory.mjs"),
+  resolve(process.cwd(), "hub/workers/factory.mjs"),
 ];
 
 // MCP transport 실패 시 tfx-route.sh가 exec fallback을 수행할 수 있도록

package/skills/tfx-workspace/async-tests/run-tests.sh

@@ -0,0 +1,203 @@
+#!/usr/bin/env bash
+# tfx-route.sh v2.5 async job system — 통합 테스트
+set -uo pipefail
+
+ROUTE="scripts/tfx-route.sh"
+PASS=0
+FAIL=0
+TOTAL=0
+
+assert_eq() {
+  local name="$1" expected="$2" actual="$3"
+  TOTAL=$((TOTAL + 1))
+  if [[ "$actual" == *"$expected"* ]]; then
+    echo "  ✓ $name"
+    PASS=$((PASS + 1))
+  else
+    echo "  ✗ $name — expected: '$expected', got: '$actual'"
+    FAIL=$((FAIL + 1))
+  fi
+}
+
+assert_neq() {
+  local name="$1" unexpected="$2" actual="$3"
+  TOTAL=$((TOTAL + 1))
+  if [[ "$actual" != *"$unexpected"* ]]; then
+    echo "  ✓ $name"
+    PASS=$((PASS + 1))
+  else
+    echo "  ✗ $name — should NOT contain: '$unexpected', got: '$actual'"
+    FAIL=$((FAIL + 1))
+  fi
+}
+
+assert_exit() {
+  local name="$1" expected="$2" actual="$3"
+  TOTAL=$((TOTAL + 1))
+  if [[ "$actual" -eq "$expected" ]]; then
+    echo "  ✓ $name"
+    PASS=$((PASS + 1))
+  else
+    echo "  ✗ $name — expected exit=$expected, got exit=$actual"
+    FAIL=$((FAIL + 1))
+  fi
+}
+
+echo "═══ tfx-route.sh v2.5 Async Job System Tests ═══"
+echo ""
+
+# ── Test 1: --async 기본 동작 ──
+echo "Test 1: --async 기본 시작 + job_id 반환"
+JOB_ID=$(bash "$ROUTE" --async executor "echo hello" none 30 2>/dev/null)
+EC=$?
+assert_exit "exit code 0" 0 "$EC"
+TOTAL=$((TOTAL + 1))
+if [[ -n "$JOB_ID" ]]; then echo "  ✓ job_id not empty ($JOB_ID)"; PASS=$((PASS + 1)); else echo "  ✗ job_id is empty"; FAIL=$((FAIL + 1)); fi
+assert_neq "job_id not error" "error" "$JOB_ID"
+echo ""
+
+# ── Test 2: --job-status running → done 전이 ──
+echo "Test 2: --job-status 상태 전이 (running → done)"
+LONG_JOB=$(bash "$ROUTE" --async executor "sleep 3 && echo done" none 60 2>/dev/null)
+STATUS_EARLY=$(bash "$ROUTE" --job-status "$LONG_JOB" 2>/dev/null)
+assert_eq "initial status: running" "running" "$STATUS_EARLY"
+
+# Codex 시작 ~10초 + sleep 3초 + 후처리 → 최대 25초 대기
+for i in $(seq 1 5); do
+  sleep 5
+  STATUS_LATE=$(bash "$ROUTE" --job-status "$LONG_JOB" 2>/dev/null)
+  [[ "$STATUS_LATE" == "done" ]] && break
+done
+assert_eq "final status: done" "done" "$STATUS_LATE"
+echo ""
+
+# ── Test 3: --job-status 존재하지 않는 job ──
+echo "Test 3: --job-status 존재하지 않는 job"
+RESULT=$(bash "$ROUTE" --job-status "nonexistent-12345" 2>/dev/null)
+EC=$?
+assert_eq "returns error" "error" "$RESULT"
+assert_exit "exit code 1" 1 "$EC"
+echo ""
+
+# ── Test 4: --job-result 완료된 job ──
+echo "Test 4: --job-result 완료된 job 결과 읽기"
+# Test 1의 JOB_ID 재사용 — Codex 완료 대기
+for i in $(seq 1 6); do
+  S=$(bash "$ROUTE" --job-status "$JOB_ID" 2>/dev/null)
+  [[ "$S" == "done" ]] && break
+  sleep 5
+done
+RESULT=$(bash "$ROUTE" --job-result "$JOB_ID" 2>/dev/null)
+EC=$?
+assert_exit "exit code 0" 0 "$EC"
+TOTAL=$((TOTAL + 1))
+if [[ -n "$RESULT" ]]; then echo "  ✓ result not empty (${#RESULT} bytes)"; PASS=$((PASS + 1)); else echo "  ✗ result is empty"; FAIL=$((FAIL + 1)); fi
+assert_neq "result not error" "error:" "$RESULT"
+echo ""
+
+# ── Test 5: --job-result 아직 실행 중인 job ──
+echo "Test 5: --job-result 실행 중인 job → 에러"
+RUNNING_JOB=$(bash "$ROUTE" --async executor "sleep 30" none 60 2>/dev/null)
+RESULT=$(bash "$ROUTE" --job-result "$RUNNING_JOB" 2>/dev/null)
+EC=$?
+assert_eq "returns error" "error: job still running" "$RESULT"
+assert_exit "exit code 1" 1 "$EC"
+# cleanup
+JOB_DIR="${TMPDIR:-/tmp}/tfx-jobs/$RUNNING_JOB"
+[[ -f "$JOB_DIR/pid" ]] && kill "$(cat "$JOB_DIR/pid")" 2>/dev/null
+echo ""
+
+# ── Test 6: --job-wait 완료 감지 ──
+echo "Test 6: --job-wait 완료 감지"
+WAIT_JOB=$(bash "$ROUTE" --async executor "echo wait-test-ok" none 30 2>/dev/null)
+sleep 15  # codex 실행 대기
+WAIT_RESULT=$(bash "$ROUTE" --job-wait "$WAIT_JOB" 60 2>/dev/null)
+assert_eq "wait returns done" "done" "$WAIT_RESULT"
+echo ""
+
+# ── Test 7: --job-wait still_running (max_wait < 실행시간) ──
+echo "Test 7: --job-wait still_running (짧은 max_wait)"
+SLOW_JOB=$(bash "$ROUTE" --async executor "sleep 60" none 120 2>/dev/null)
+sleep 1
+WAIT_RESULT=$(bash "$ROUTE" --job-wait "$SLOW_JOB" 5 2>/dev/null)
+assert_eq "wait returns still_running" "still_running" "$WAIT_RESULT"
+# cleanup
+JOB_DIR="${TMPDIR:-/tmp}/tfx-jobs/$SLOW_JOB"
+[[ -f "$JOB_DIR/pid" ]] && kill "$(cat "$JOB_DIR/pid")" 2>/dev/null
+echo ""
+
+# ── Test 8: exit code 전파 ──
+echo "Test 8: 실패한 job의 exit code 전파"
+FAIL_JOB=$(bash "$ROUTE" --async executor "exit 42" none 30 2>/dev/null)
+# Codex 완료 대기
+for i in $(seq 1 8); do
+  S=$(bash "$ROUTE" --job-status "$FAIL_JOB" 2>/dev/null)
+  [[ "$S" != *"running"* ]] && break
+  sleep 5
+done
+STATUS=$(bash "$ROUTE" --job-status "$FAIL_JOB" 2>/dev/null)
+# Codex가 exit 42를 감싸서 성공/실패 둘 다 가능 — "running이 아님"만 확인
+TOTAL=$((TOTAL + 1))
+if [[ "$STATUS" == "done" || "$STATUS" == *"failed"* || "$STATUS" == "timeout" ]]; then
+  echo "  ✓ status is terminal: $STATUS"; PASS=$((PASS + 1))
+else
+  echo "  ✗ status not terminal: $STATUS"; FAIL=$((FAIL + 1))
+fi
+# Codex는 exit 42를 감싸서 다른 코드로 반환할 수 있음 — 완료 자체만 확인
+TOTAL=$((TOTAL + 1))
+if [[ "$STATUS" != *"running"* ]]; then echo "  ✓ job completed (not stuck running)"; PASS=$((PASS + 1)); else echo "  ✗ job still running"; FAIL=$((FAIL + 1)); fi
+echo ""
+
+# ── Test 9: job 디렉토리 구조 검증 ──
+echo "Test 9: job 디렉토리 구조"
+STRUCT_JOB=$(bash "$ROUTE" --async executor "echo structure-test" none 30 2>/dev/null)
+JOB_DIR="${TMPDIR:-/tmp}/tfx-jobs/$STRUCT_JOB"
+assert_eq "pid file exists" "true" "$([ -f "$JOB_DIR/pid" ] && echo true || echo false)"
+assert_eq "agent_type file exists" "true" "$([ -f "$JOB_DIR/agent_type" ] && echo true || echo false)"
+assert_eq "start_time file exists" "true" "$([ -f "$JOB_DIR/start_time" ] && echo true || echo false)"
+AGENT=$(cat "$JOB_DIR/agent_type" 2>/dev/null)
+assert_eq "agent_type == executor" "executor" "$AGENT"
+echo ""
+
+# ── Test 10: native.mjs 프롬프트 검증 ──
+echo "Test 10: native.mjs buildSlimWrapperPrompt async 키워드"
+PROMPT_CHECK=$(node -e "
+import('./hub/team/native.mjs').then(m => {
+  const p = m.buildSlimWrapperPrompt('codex', {
+    subtask: 'test task',
+    role: 'scientist',
+    teamName: 'test-team',
+    taskId: 'task-1',
+    agentName: 'codex-worker-1',
+  });
+  const checks = {
+    has_async: p.includes('--async'),
+    has_job_wait: p.includes('--job-wait'),
+    has_job_result: p.includes('--job-result'),
+    has_route_timeout: p.includes('auto 1800'),
+    no_old_bashTimeout: !p.includes('timeout: 1860000'),
+    has_launch_timeout: p.includes('timeout: 15000'),
+    has_wait_timeout: p.includes('timeout: 570000'),
+    has_result_timeout: p.includes('timeout: 30000'),
+  };
+  for (const [k, v] of Object.entries(checks)) {
+    console.log(k + '=' + v);
+  }
+});
+" 2>/dev/null)
+for line in $PROMPT_CHECK; do
+  key="${line%%=*}"
+  val="${line##*=}"
+  assert_eq "$key" "true" "$val"
+done
+echo ""
+
+# ── 결과 요약 ──
+echo "═══════════════════════════════════════════════════"
+echo "  Results: $PASS/$TOTAL passed, $FAIL failed"
+echo "═══════════════════════════════════════════════════"
+
+if [[ "$FAIL" -gt 0 ]]; then
+  exit 1
+fi
+exit 0