triflux 10.13.8 → 10.13.10

package/bin/triflux.mjs

@@ -318,9 +318,10 @@ const CLI_COMMAND_SCHEMAS = Object.freeze({
     ],
   },
   swarm: {
-    usage: "tfx swarm <prd-path> [--dry-run|--json|--filter <shard>]",
+    usage: "tfx swarm [run] <prd-path> [--dry-run|--json|--filter <shard>]",
     description: "PRD 기반 멀티모델 x 멀티기기 스웜 실행 (#93)",
     subcommands: {
+      run: "tfx swarm run <prd-path> — verb 명시 실행 (기본 경로와 동일)",
       plan: "tfx swarm plan <prd-path> [--json] — 실행 없이 계획만 출력",
       list: "tfx swarm list [--json] — 활성 스웜 세션 조회 (synapse status)",
       status: "tfx swarm status [--json] — list alias",
@@ -4760,7 +4761,9 @@ ${updateNotice}
     ${WHITE_BRIGHT}tfx tray${RESET}       ${GRAY}Windows 시스템 트레이 실행${RESET}
     ${DIM}  --detach${RESET}      ${GRAY}백그라운드 트레이 프로세스로 분리${RESET}
     ${WHITE_BRIGHT}tfx multi${RESET}       ${GRAY}멀티-CLI 팀 모드 (tmux + Hub)${RESET}
-    ${WHITE_BRIGHT}tfx swarm${RESET}       ${GRAY}PRD 기반 worktree 격리 병렬 실행${RESET}
+    ${WHITE_BRIGHT}tfx swarm${RESET}       ${GRAY}PRD 기반 worktree 격리 병렬 실행 (run/plan/list)${RESET}
+    ${WHITE_BRIGHT}tfx synapse${RESET}     ${GRAY}스웜 세션 registry 조회 / lease 관리${RESET}
+    ${WHITE_BRIGHT}tfx why${RESET}         ${GRAY}경로의 마지막 커밋 X-Intent 트레일러 추출${RESET}
     ${WHITE_BRIGHT}tfx codex-team${RESET} ${GRAY}Codex 전용 팀 모드 (기본 lead/agents: codex)${RESET}
     ${WHITE_BRIGHT}tfx notion-read${RESET} ${GRAY}Notion 페이지 → 마크다운 (Codex/Gemini MCP)${RESET}
     ${WHITE_BRIGHT}tfx version${RESET}    ${GRAY}버전 표시${RESET}
@@ -5829,6 +5832,7 @@ async function main() {
     ${WHITE_BRIGHT}${s.usage}${RESET}
 
   ${BOLD}Subcommands${RESET}
+    ${WHITE_BRIGHT}tfx swarm run <prd>${RESET}    ${GRAY}${s.subcommands.run}${RESET}
     ${WHITE_BRIGHT}tfx swarm plan <prd>${RESET}   ${GRAY}${s.subcommands.plan}${RESET}
     ${WHITE_BRIGHT}tfx swarm list${RESET}         ${GRAY}${s.subcommands.list}${RESET}
     ${WHITE_BRIGHT}tfx swarm status${RESET}       ${GRAY}${s.subcommands.status}${RESET}
@@ -5850,11 +5854,15 @@ ${s.options.map((o) => `    ${DIM}${o.name.padEnd(16)}${RESET} ${GRAY}${o.descri
         await cmdSwarmPlan(cmdArgs.slice(1), { json: JSON_OUTPUT });
         return;
       }
+      if (sub === "run") {
+        await cmdSwarmRun(cmdArgs.slice(1), { json: JSON_OUTPUT });
+        return;
+      }
       if (!sub || sub.startsWith("--")) {
         throw createCliError("PRD 경로가 필요합니다", {
           exitCode: EXIT_ARG_ERROR,
           reason: "argError",
-          fix: "tfx swarm <prd-path> [--dry-run|--json|--filter <shard>]",
+          fix: "tfx swarm [run] <prd-path> [--dry-run|--json|--filter <shard>]",
         });
       }
       await cmdSwarmRun(cmdArgs, { json: JSON_OUTPUT });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "triflux",
-  "version": "10.13.8",
+  "version": "10.13.10",
   "description": "CLI-first multi-model orchestrator for Claude Code — route tasks to Codex, Gemini, and Claude",
   "type": "module",
   "bin": {

package/skills/tfx-autopilot/SKILL.md

@@ -19,10 +19,16 @@ argument-hint: "<작업 설명 — tfx-auto 로 passthrough>"
 
 ## 동작
 
-1. stderr 에 1회 deprecation 경고 출력:
-   ```
-   [deprecated] tfx-autopilot -> use: tfx-auto
-   ```
+canonical 위임 **이전** 에 아래 bash 블록을 한 번 실행한다. Phase 5 (v11) 물리 삭제 게이트는 `.omc/state/alias-usage.log` 의 7일 zero-usage 검증에 의존 — 이 logging 이 빠지면 게이트가 영영 열리지 않는다.
+
+```bash
+mkdir -p .omc/state
+echo "[deprecated] tfx-autopilot -> use: tfx-auto" >&2
+echo "[DEPRECATED] tfx-autopilot — see tfx-auto"
+echo "$(date -u +%Y-%m-%dT%H:%M:%SZ) tfx-autopilot -> tfx-auto" >> .omc/state/alias-usage.log
+```
+
+1. 위 bash 블록 실행 (stderr 경고 + stdout `[DEPRECATED]` 마커 + alias-usage.log append).
 2. ARGUMENTS 를 그대로 `Skill("tfx-auto")` 에 전달한다 (추가 플래그 없음).
 3. tfx-auto 의 Step 0 스마트 라우팅과 플래그 오버라이드 로직이 나머지를 처리한다.
 

package/skills/tfx-consensus/SKILL.md

@@ -17,17 +17,18 @@ argument-hint: "<분석 주제 또는 컨텍스트 — tfx-auto 로 passthrough>
 
 ## 동작
 
-1. stderr 에 1회 경고 출력:
-   ```
-   [deprecated] tfx-consensus -> use: tfx-auto --mode consensus
-   ```
-2. stdout 머리부에 `[DEPRECATED]` 마커를 출력한다.
-3. `.omc/state/alias-usage.log` 에 아래 형식으로 append 한다:
-   ```
-   2026-04-18T12:34:56Z tfx-consensus -> tfx-auto --mode consensus
-   ```
-4. ARGUMENTS 전체 앞에 `--mode consensus` 를 prepend 하여 `Skill("tfx-auto")` 호출.
-5. `--shape` 미지정 시 기본값은 `consensus` 다. `--analysis-prompt-file`, `--cli-set`, `--resolution-threshold` 같은 합의 인자는 그대로 passthrough 한다.
+canonical 위임 **이전** 에 아래 bash 블록을 한 번 실행한다. Phase 5 (v11) 물리 삭제 게이트는 `.omc/state/alias-usage.log` 의 7일 zero-usage 검증에 의존 — 이 logging 이 빠지면 게이트가 영영 열리지 않는다.
+
+```bash
+mkdir -p .omc/state
+echo "[deprecated] tfx-consensus -> use: tfx-auto --mode consensus" >&2
+echo "[DEPRECATED] tfx-consensus — see tfx-auto --mode consensus"
+echo "$(date -u +%Y-%m-%dT%H:%M:%SZ) tfx-consensus -> tfx-auto --mode consensus" >> .omc/state/alias-usage.log
+```
+
+1. 위 bash 블록 실행 (stderr 경고 + stdout `[DEPRECATED]` 마커 + alias-usage.log append).
+2. ARGUMENTS 전체 앞에 `--mode consensus` 를 prepend 하여 `Skill("tfx-auto")` 호출.
+3. `--shape` 미지정 시 기본값은 `consensus` 다. `--analysis-prompt-file`, `--cli-set`, `--resolution-threshold` 같은 합의 인자는 그대로 passthrough 한다.
 
 ## 등가 플래그
 

package/skills/tfx-debate/SKILL.md

@@ -22,17 +22,18 @@ argument-hint: "<토론 주제 또는 질문 — tfx-auto 로 passthrough>"
 
 ## 동작
 
-1. stderr 에 1회 경고 출력:
-   ```
-   [deprecated] tfx-debate -> use: tfx-auto --mode consensus --shape debate
-   ```
-2. stdout 머리부에 `[DEPRECATED]` 마커를 출력한다.
-3. `.omc/state/alias-usage.log` 에 아래 형식으로 append 한다:
-   ```
-   2026-04-18T12:34:56Z tfx-debate -> tfx-auto --mode consensus --shape debate
-   ```
-4. ARGUMENTS 전체 앞에 `--mode consensus --shape debate` 를 prepend 하여 `Skill("tfx-auto")` 호출.
-5. `--options`, `--criteria`, `--cli-set`, `--analysis-prompt-file` 같은 debate 전용 인자는 그대로 passthrough 한다.
+canonical 위임 **이전** 에 아래 bash 블록을 한 번 실행한다. Phase 5 (v11) 물리 삭제 게이트는 `.omc/state/alias-usage.log` 의 7일 zero-usage 검증에 의존 — 이 logging 이 빠지면 게이트가 영영 열리지 않는다.
+
+```bash
+mkdir -p .omc/state
+echo "[deprecated] tfx-debate -> use: tfx-auto --mode consensus --shape debate" >&2
+echo "[DEPRECATED] tfx-debate — see tfx-auto --mode consensus --shape debate"
+echo "$(date -u +%Y-%m-%dT%H:%M:%SZ) tfx-debate -> tfx-auto --mode consensus --shape debate" >> .omc/state/alias-usage.log
+```
+
+1. 위 bash 블록 실행 (stderr 경고 + stdout `[DEPRECATED]` 마커 + alias-usage.log append).
+2. ARGUMENTS 전체 앞에 `--mode consensus --shape debate` 를 prepend 하여 `Skill("tfx-auto")` 호출.
+3. `--options`, `--criteria`, `--cli-set`, `--analysis-prompt-file` 같은 debate 전용 인자는 그대로 passthrough 한다.
 
 ## 등가 플래그
 

package/skills/tfx-fullcycle/SKILL.md

@@ -19,10 +19,16 @@ argument-hint: "<작업 설명 — tfx-auto 로 passthrough>"
 
 ## 동작
 
-1. stderr 에 1회 경고 출력:
-   ```
-   [deprecated] tfx-fullcycle -> use: tfx-auto --mode deep --parallel 1
-   ```
+canonical 위임 **이전** 에 아래 bash 블록을 한 번 실행한다. Phase 5 (v11) 물리 삭제 게이트는 `.omc/state/alias-usage.log` 의 7일 zero-usage 검증에 의존 — 이 logging 이 빠지면 게이트가 영영 열리지 않는다.
+
+```bash
+mkdir -p .omc/state
+echo "[deprecated] tfx-fullcycle -> use: tfx-auto --mode deep --parallel 1" >&2
+echo "[DEPRECATED] tfx-fullcycle — see tfx-auto --mode deep --parallel 1"
+echo "$(date -u +%Y-%m-%dT%H:%M:%SZ) tfx-fullcycle -> tfx-auto --mode deep --parallel 1" >> .omc/state/alias-usage.log
+```
+
+1. 위 bash 블록 실행 (stderr 경고 + stdout `[DEPRECATED]` 마커 + alias-usage.log append).
 2. ARGUMENTS 전체 앞에 `--mode deep --parallel 1` 를 prepend 하여 `Skill("tfx-auto")` 호출.
 3. tfx-auto 의 플래그 오버라이드 로직이 나머지 처리.
 

package/skills/tfx-multi/SKILL.md

@@ -17,10 +17,16 @@ argument-hint: "<작업 설명 — tfx-auto 로 passthrough>"
 
 ## 동작
 
-1. stderr 에 1회 경고 출력:
-   ```
-   [deprecated] tfx-multi -> use: tfx-auto --parallel N --mode deep
-   ```
+canonical 위임 **이전** 에 아래 bash 블록을 한 번 실행한다. Phase 5 (v11) 물리 삭제 게이트는 `.omc/state/alias-usage.log` 의 7일 zero-usage 검증에 의존 — 이 logging 이 빠지면 게이트가 영영 열리지 않는다.
+
+```bash
+mkdir -p .omc/state
+echo "[deprecated] tfx-multi -> use: tfx-auto --parallel N --mode deep" >&2
+echo "[DEPRECATED] tfx-multi — see tfx-auto --parallel N --mode deep"
+echo "$(date -u +%Y-%m-%dT%H:%M:%SZ) tfx-multi -> tfx-auto --parallel N --mode deep" >> .omc/state/alias-usage.log
+```
+
+1. 위 bash 블록 실행 (stderr 경고 + stdout `[DEPRECATED]` 마커 + alias-usage.log append).
 2. ARGUMENTS 전체 앞에 `--parallel N --mode deep` 를 prepend 하여 `Skill("tfx-auto")` 호출.
 3. tfx-auto 의 플래그 오버라이드 로직이 내부적으로 `tfx multi --teammate-mode headless` 를 호출한다.
 

package/skills/tfx-panel/SKILL.md

@@ -22,17 +22,18 @@ argument-hint: "<토론 주제 — tfx-auto 로 passthrough>"
 
 ## 동작
 
-1. stderr 에 1회 경고 출력:
-   ```
-   [deprecated] tfx-panel -> use: tfx-auto --mode consensus --shape panel
-   ```
-2. stdout 머리부에 `[DEPRECATED]` 마커를 출력한다.
-3. `.omc/state/alias-usage.log` 에 아래 형식으로 append 한다:
-   ```
-   2026-04-18T12:34:56Z tfx-panel -> tfx-auto --mode consensus --shape panel
-   ```
-4. ARGUMENTS 전체 앞에 `--mode consensus --shape panel` 를 prepend 하여 `Skill("tfx-auto")` 호출.
-5. `--experts`, `--cli-set`, `--analysis-prompt-file` 같은 panel 전용 인자는 그대로 passthrough 한다.
+canonical 위임 **이전** 에 아래 bash 블록을 한 번 실행한다. Phase 5 (v11) 물리 삭제 게이트는 `.omc/state/alias-usage.log` 의 7일 zero-usage 검증에 의존 — 이 logging 이 빠지면 게이트가 영영 열리지 않는다.
+
+```bash
+mkdir -p .omc/state
+echo "[deprecated] tfx-panel -> use: tfx-auto --mode consensus --shape panel" >&2
+echo "[DEPRECATED] tfx-panel — see tfx-auto --mode consensus --shape panel"
+echo "$(date -u +%Y-%m-%dT%H:%M:%SZ) tfx-panel -> tfx-auto --mode consensus --shape panel" >> .omc/state/alias-usage.log
+```
+
+1. 위 bash 블록 실행 (stderr 경고 + stdout `[DEPRECATED]` 마커 + alias-usage.log append).
+2. ARGUMENTS 전체 앞에 `--mode consensus --shape panel` 를 prepend 하여 `Skill("tfx-auto")` 호출.
+3. `--experts`, `--cli-set`, `--analysis-prompt-file` 같은 panel 전용 인자는 그대로 passthrough 한다.
 
 ## 등가 플래그
 

package/skills/tfx-persist/SKILL.md

@@ -22,10 +22,16 @@ argument-hint: "<작업 설명 — tfx-auto 로 passthrough>"
 
 ## 동작
 
-1. stderr 에 1회 경고 출력:
-   ```
-   [deprecated] tfx-persist -> use: tfx-auto --retry ralph
-   ```
+canonical 위임 **이전** 에 아래 bash 블록을 한 번 실행한다. Phase 5 (v11) 물리 삭제 게이트는 `.omc/state/alias-usage.log` 의 7일 zero-usage 검증에 의존 — 이 logging 이 빠지면 게이트가 영영 열리지 않는다.
+
+```bash
+mkdir -p .omc/state
+echo "[deprecated] tfx-persist -> use: tfx-auto --retry ralph" >&2
+echo "[DEPRECATED] tfx-persist — see tfx-auto --retry ralph"
+echo "$(date -u +%Y-%m-%dT%H:%M:%SZ) tfx-persist -> tfx-auto --retry ralph" >> .omc/state/alias-usage.log
+```
+
+1. 위 bash 블록 실행 (stderr 경고 + stdout `[DEPRECATED]` 마커 + alias-usage.log append).
 2. ARGUMENTS 전체 앞에 `--retry ralph` 를 prepend 하여 `Skill("tfx-auto")` 호출.
 3. 스킬 경유 시 기본 `--max-iterations 0` (unlimited) 로 진입. CLI 직접 호출 시 bounded 1 로 진입 (임시 합의안, Phase 3 Open question #2).
 

package/skills/tfx-psmux-rules/SKILL.md

@@ -16,6 +16,17 @@ Phase 4b부터 psmux 규칙의 source of truth는 아래 두 문서다.
 - `.claude/rules/tfx-psmux.md`
 - `AGENTS.md` 의 `TFX psmux Rules` 섹션
 
+## Deprecation logging (alias 호출 즉시 실행 필수)
+
+canonical 위임 **이전** 에 아래 bash 블록을 한 번 실행한다. Phase 5 (v11) 물리 삭제 게이트는 `.omc/state/alias-usage.log` 의 7일 zero-usage 검증에 의존.
+
+```bash
+mkdir -p .omc/state
+echo "[deprecated] tfx-psmux-rules -> see: .claude/rules/tfx-psmux.md" >&2
+echo "[DEPRECATED] tfx-psmux-rules — see .claude/rules/tfx-psmux.md"
+echo "$(date -u +%Y-%m-%dT%H:%M:%SZ) tfx-psmux-rules -> .claude/rules/tfx-psmux.md" >> .omc/state/alias-usage.log
+```
+
 ## Alias behavior
 
 - 이전 `tfx-psmux-rules` 호출은 항상-on rule 문서 참조로 안내한다.

package/skills/tfx-remote-setup/SKILL.md

@@ -11,6 +11,17 @@ argument-hint: "[--add|--edit|--probe-all|--diagnose]"
 
 이 스킬은 Phase 4b thin alias다. 새 표면은 `tfx-remote setup` 하나다.
 
+## Deprecation logging (alias 호출 즉시 실행 필수)
+
+canonical 위임 **이전** 에 아래 bash 블록을 한 번 실행한다. Phase 5 (v11) 물리 삭제 게이트는 `.omc/state/alias-usage.log` 의 7일 zero-usage 검증에 의존.
+
+```bash
+mkdir -p .omc/state
+echo "[deprecated] tfx-remote-setup -> use: tfx-remote setup" >&2
+echo "[DEPRECATED] tfx-remote-setup — see tfx-remote setup"
+echo "$(date -u +%Y-%m-%dT%H:%M:%SZ) tfx-remote-setup -> tfx-remote setup" >> .omc/state/alias-usage.log
+```
+
 ## Alias mapping
 
 - `tfx-remote-setup`

package/skills/tfx-remote-spawn/SKILL.md

@@ -12,6 +12,17 @@ argument-hint: "[spawn|list|attach|send|resume|kill|probe] ..."
 
 이 스킬은 Phase 4b thin alias다. 새 표면은 `tfx-remote` 명령군이다.
 
+## Deprecation logging (alias 호출 즉시 실행 필수)
+
+canonical 위임 **이전** 에 아래 bash 블록을 한 번 실행한다. Phase 5 (v11) 물리 삭제 게이트는 `.omc/state/alias-usage.log` 의 7일 zero-usage 검증에 의존.
+
+```bash
+mkdir -p .omc/state
+echo "[deprecated] tfx-remote-spawn -> use: tfx-remote" >&2
+echo "[DEPRECATED] tfx-remote-spawn — see tfx-remote"
+echo "$(date -u +%Y-%m-%dT%H:%M:%SZ) tfx-remote-spawn -> tfx-remote" >> .omc/state/alias-usage.log
+```
+
 ## Alias mapping
 
 - `tfx-remote-spawn <host> [prompt]` → `tfx-remote spawn <host> [prompt]`

package/skills/tfx-swarm/SKILL.md

@@ -21,10 +21,16 @@ argument-hint: "<PRD 경로 — tfx-auto 로 passthrough>"
 
 ## 동작
 
-1. stderr 에 1회 경고 출력:
-   ```
-   [deprecated] tfx-swarm -> use: tfx-auto --parallel swarm --mode consensus --isolation worktree
-   ```
+canonical 위임 **이전** 에 아래 bash 블록을 한 번 실행한다. Phase 5 (v11) 물리 삭제 게이트는 `.omc/state/alias-usage.log` 의 7일 zero-usage 검증에 의존 — 이 logging 이 빠지면 게이트가 영영 열리지 않는다.
+
+```bash
+mkdir -p .omc/state
+echo "[deprecated] tfx-swarm -> use: tfx-auto --parallel swarm --mode consensus --isolation worktree" >&2
+echo "[DEPRECATED] tfx-swarm — see tfx-auto --parallel swarm --mode consensus --isolation worktree"
+echo "$(date -u +%Y-%m-%dT%H:%M:%SZ) tfx-swarm -> tfx-auto --parallel swarm --mode consensus --isolation worktree" >> .omc/state/alias-usage.log
+```
+
+1. 위 bash 블록 실행 (stderr 경고 + stdout `[DEPRECATED]` 마커 + alias-usage.log append).
 2. ARGUMENTS 전체 앞에 `--parallel swarm --mode consensus --isolation worktree` 를 prepend 하여 `Skill("tfx-auto")` 호출.
 3. tfx-auto 의 플래그 오버라이드 로직이 `tfx swarm <prd>` CLI 를 호출한다 (실제 swarm 엔진은 변경 없음).