triflux 9.7.13 → 9.8.0

package/skills/.omc/state/agent-replay-8f0e10a9-9693-4410-96f5-a6b07e8ed995.jsonl

@@ -0,0 +1 @@
+{"t":0,"agent":"adb34b0","agent_type":"general-purpose","event":"agent_stop","success":true}

package/skills/.omc/state/idle-notif-cooldown.json

@@ -0,0 +1,3 @@
+{
+  "lastSentAt": "2026-03-29T03:41:07.256Z"
+}

package/skills/.omc/state/last-tool-error.json

@@ -0,0 +1,7 @@
+{
+  "tool_name": "Bash",
+  "tool_input_preview": "{\"command\":\"ls -la \\\"C:/Users/tellang/Desktop/Projects/triflux/skills/tfx-deslop/\\\" 2>/dev/null; echo \\\"===\\\"; ls -la \\\"C:/Users/tellang/Desktop/Projects/triflux/skills/tfx-codebase-search/\\\" 2>/dev/n...",
+  "error": "Exit code 2\n===",
+  "timestamp": "2026-03-29T03:40:35.913Z",
+  "retry_count": 1
+}

package/skills/.omc/state/subagent-tracking.json

@@ -0,0 +1,7 @@
+{
+  "agents": [],
+  "total_spawned": 0,
+  "total_completed": 0,
+  "total_failed": 0,
+  "last_updated": "2026-03-29T03:41:34.338Z"
+}

package/skills/tfx-codex-swarm/SKILL.md

@@ -431,6 +431,9 @@ wt.exe -w 0 -p triflux --title "swarm-dashboard" bash -c '
     for s in $(psmux list-sessions -F "#{session_name}" 2>/dev/null | grep codex-swarm); do
       echo "  [$s] $(psmux capture-pane -t "$s" -p | tail -1)"
     done
+    echo ""
+    echo "Attach: psmux attach -t <session-name>"
+    echo "Close:  detach first (Ctrl+B,D), then close pane. NEVER close pane directly!"
     sleep 10
   done
 '
@@ -536,13 +539,21 @@ Step 1 진입 전에 사전 검사한다. 미설치 시 스캔을 시작하기
 ```bash
 command -v psmux >/dev/null 2>&1 || {
   echo "ERROR: psmux가 설치되어 있지 않습니다."
-  echo "설치: npm install -g psmux"
+  echo "설치 방법 (택 1):"
+  echo "  winget install marlocarlo.psmux"
+  echo "  scoop install psmux"
+  echo "  choco install psmux"
+  echo "  cargo install psmux"
   exit 1
 }
 ```
 
 Step 1 진입 전에 사전 검사한다. 미설치 시 즉시 중단한다.
 
+> 설치만 확인하지 말고 `tfx doctor --json`으로 **버전/capability preflight**를 함께 확인한다.
+> 최소 확인 항목: `new-session`, `attach-session`, `kill-session`, `capture-pane`
+> (`detach-client` 지원 여부도 같이 확인하면 attach/detach hardening 상태까지 파악 가능)
+
 > 두 사전 검사(codex, psmux)를 하나의 preflight 블록으로 묶어 Step 1 전에 실행하는 것을 권장한다.
 
 ```bash
@@ -572,6 +583,10 @@ fi
 
 ## 정리
 
+> **중요: WT split pane에 attach된 psmux 세션을 직접 kill하면 WT가 크래시한다.**
+> WT 1.24의 ConPTY close 레이스 버그 ([#17871](https://github.com/microsoft/terminal/issues/17871)).
+> 반드시 detach → WT pane 닫기 → kill 순서를 지켜야 한다.
+
 전체 스웜 종료 시:
 
 > **WT 프리징 방지**: `kill-session` 전에 반드시 각 세션에 `exit`을 보내
@@ -579,20 +594,40 @@ fi
 > 강제 kill하면 WT가 응답 없음 상태로 전환될 수 있다.
 
 ```bash
-# 1) graceful exit — 각 세션에 exit 전송 (WT 패인 자연 종료 유도)
+# 1) detach — 모든 swarm 세션에서 WT detach (ConPTY 안전 해제)
+for s in $(psmux list-sessions -F '#{session_name}' 2>/dev/null | grep codex-swarm); do
+  psmux detach-client -t "$s" 2>/dev/null
+done
+
+# 2) WT가 pane을 정리할 시간 확보
+sleep 2
+
+# 3) graceful exit — 각 세션에 exit 전송
 for s in $(psmux list-sessions -F '#{session_name}' 2>/dev/null | grep codex-swarm); do
   psmux send-keys -t "$s" "exit" Enter 2>/dev/null || true
 done
 
-# 2) 프로세스 종료 대기 (WT 패인이 닫힐 시간 확보)
+# 4) 프로세스 종료 대기
 sleep 2
 
-# 3) 잔여 세션 강제 종료 (exit이 먹히지 않은 경우)
+# 5) 잔여 세션 강제 종료
 for s in $(psmux list-sessions -F '#{session_name}' 2>/dev/null | grep codex-swarm); do
   psmux kill-session -t "$s" 2>/dev/null || true
 done
 
-# 4) worktree 정리 (머지 완료된 것만)
+# 6) worktree 정리 (머지 완료된 것만)
 git worktree prune
 rm -rf .codex-swarm/
 ```
+
+### 개별 세션 닫기 (WT pane에서)
+
+WT split pane을 직접 닫지 말 것. 대신:
+```bash
+# pane 안에서:
+psmux detach        # 또는 Ctrl+B, D
+# detach 후 WT pane이 자동으로 닫힘 (안전)
+
+# 세션 자체를 종료하려면 detach 후:
+psmux kill-session -t codex-swarm-{id}
+```

package/skills/tfx-codex-swarm/mcp-daemon/register-autostart.ps1

@@ -0,0 +1,32 @@
+# Register MCP daemon auto-start via Task Scheduler
+# Runs start-daemons.ps1 at user logon so daemons survive WT crashes/reboots
+# Usage: powershell -ExecutionPolicy Bypass -File register-autostart.ps1
+
+$taskName = "OMX-MCP-Daemons"
+$scriptPath = Join-Path (Split-Path -Parent $MyInvocation.MyCommand.Path) "start-daemons.ps1"
+
+# Remove existing task if any
+Unregister-ScheduledTask -TaskName $taskName -Confirm:$false -ErrorAction SilentlyContinue
+
+$action = New-ScheduledTaskAction `
+    -Execute "powershell.exe" `
+    -Argument "-ExecutionPolicy Bypass -WindowStyle Hidden -File `"$scriptPath`""
+
+$trigger = New-ScheduledTaskTrigger -AtLogOn -User $env:USERNAME
+
+$settings = New-ScheduledTaskSettingsSet `
+    -AllowStartIfOnBatteries `
+    -DontStopIfGoingOnBatteries `
+    -StartWhenAvailable `
+    -ExecutionTimeLimit (New-TimeSpan -Minutes 5)
+
+Register-ScheduledTask `
+    -TaskName $taskName `
+    -Action $action `
+    -Trigger $trigger `
+    -Settings $settings `
+    -Description "Start OMX MCP singleton daemons (supergateway on ports 9001-9005)" `
+    -RunLevel Limited
+
+Write-Host "[OK] Task '$taskName' registered. Daemons will auto-start at logon."
+Write-Host "     Manual run: schtasks /Run /TN $taskName"

package/skills/tfx-doctor/SKILL.md

@@ -146,6 +146,9 @@ options:
 - tfx-route.sh 설치 상태
 - HUD 설치 및 설정 상태
 - Codex/Gemini/Claude CLI 경로 (크로스 셸)
+- **psmux 버전 / capability preflight**
+  - `new-session`, `attach-session`, `kill-session`, `capture-pane`, `detach-client`
+  - 권장 버전 이상인지 여부
 - Codex Profiles (필수 프로파일 존재 여부)
 - 스킬 설치 상태
 - 플러그인 등록 상태

package/skills/tfx-fullcycle/SKILL.md

@@ -17,6 +17,55 @@ argument-hint: "<구현할 기능 전체 설명>"
 
 > 5-Phase 파이프라인: Expansion → Planning → Execution → QA → Validation.
 > OMC autopilot + Superpowers TDD + MetaGPT SOP 영감. 처음부터 끝까지 자율 실행.
+> 실행 전 컨텍스트 grounding, deep-interview 산출물 재사용, phase-state/resume 계약을 포함한다.
+
+## PRE-CONTEXT GATE
+
+Phase 1 시작 전 아래 intake를 먼저 수행한다.
+
+1. task slug를 생성한다.
+2. 최근 관련 컨텍스트/산출물을 탐색한다.
+3. 현재 작업용 스냅샷을 생성한다.
+4. ambiguity가 높으면 `/deep-interview` 또는 기존 인터뷰 산출물 재사용을 우선 고려한다.
+
+**필수 스냅샷 필드**
+- task statement
+- desired outcome
+- known facts / evidence
+- constraints
+- unknowns / open questions
+- likely codebase touchpoints
+
+**권장 저장 경로**
+- `.tfx/fullcycle/{run-id}/context-snapshot.md`
+
+## STATE & ARTIFACT CONTRACT
+
+`tfx-fullcycle`은 phase별로 산출물과 상태를 남긴다.
+
+**기본 아티팩트 디렉토리**
+- `.tfx/fullcycle/{run-id}/`
+
+**최소 산출물**
+- `context-snapshot.md`
+- `expanded-spec.md`
+- `implementation-plan.md`
+- `execution-summary.md`
+- `qa-findings.md`
+- `validation-decision.md`
+- `state.json`
+
+**phase-state 필드**
+- current phase
+- started_at
+- last_successful_phase
+- retry_count
+- failure_reason
+
+**resume 규칙**
+- 재실행 시 전체를 처음부터 다시 돌리지 않는다.
+- `state.json`을 읽고 마지막 미완료 phase부터 resume한다.
+- QA / Validation 재시도는 해당 phase만 다시 실행한다.
 
 ## HARD RULES
 
@@ -48,10 +97,13 @@ argument-hint: "<구현할 기능 전체 설명>"
 
 **Claude가 직접 실행한다.** Agent 호출 없이 Claude 자신이 아키텍트 역할을 수행한다.
 
-1. 사용자 요청에서 구현 범위, 영향 파일, 엣지 케이스, 암묵적 요구사항을 분석한다.
-2. 검증 가능한 acceptance criteria 목록을 도출한다.
-3. 모호한 점이 있으면 AskUserQuestion으로 사용자에게 확인한다.
-4. 출력: `{expanded_requirements}`, `{acceptance_criteria}` (이후 Phase에서 사용)
+1. `.tfx/plans/interview-*.md` 산출물이 있으면 관련 문서를 먼저 탐색한다.
+2. 인터뷰 산출물이 충분히 명확하면 raw prompt에서 다시 시작하지 말고 해당 문서를 Expansion 입력으로 재사용한다.
+3. 인터뷰 산출물이 없거나 부족하면 사용자 요청에서 구현 범위, 영향 파일, 엣지 케이스, 암묵적 요구사항을 분석한다.
+4. 검증 가능한 acceptance criteria 목록을 도출한다.
+5. 모호한 점이 남아 있으면 AskUserQuestion 또는 `/deep-interview`로 명확화한다.
+6. 출력: `{expanded_requirements}`, `{acceptance_criteria}`
+7. 산출물 저장: `.tfx/fullcycle/{run-id}/expanded-spec.md`
 
 ### Phase 2: Planning
 
@@ -83,6 +135,9 @@ Bash("tfx multi --teammate-mode headless --auto-attach --dashboard \
 - Consensus Score < 70 → 3자 결과를 교차 공유 후 Round 2 재합의
 - Round 2 후에도 < 60 → AskUserQuestion으로 불일치 항목 제시 + 방향 결정 요청
 
+**산출물 저장**
+- `.tfx/fullcycle/{run-id}/implementation-plan.md`
+
 ### Phase 3: Execution
 
 태스크를 라우팅 규칙에 따라 병렬 실행한다. 독립 태스크는 같은 응답에서 동시 호출한다.
@@ -112,6 +167,9 @@ Bash("tfx multi --teammate-mode headless --auto-attach --dashboard \
 
 각 태스크 완료 시 테스트 통과 여부를 확인하고 다음 태스크로 진행한다.
 
+**산출물 저장**
+- 변경 파일 목록과 태스크별 결과를 `.tfx/fullcycle/{run-id}/execution-summary.md`에 기록한다.
+
 ### Phase 4: QA
 
 **아래 2개 도구를 반드시 같은 응답에서 동시에 호출하라.**
@@ -139,6 +197,13 @@ Bash("tfx multi --teammate-mode headless --auto-attach --dashboard \
   --timeout 600")
 ```
 
+**QA 반복 규칙**
+- 동일한 실패 / 동일한 에러가 3회 반복되면 무한 루프를 중단한다.
+- 이 경우 `.tfx/fullcycle/{run-id}/qa-findings.md`에 근본 이슈 보고서를 남기고 사용자 판단을 요청한다.
+
+**산출물 저장**
+- `.tfx/fullcycle/{run-id}/qa-findings.md`
+
 ### Phase 5: Validation
 
 Phase 4의 3자 결과에 Consensus 프로토콜을 적용한다.
@@ -148,6 +213,9 @@ Phase 4의 3자 결과에 Consensus 프로토콜을 적용한다.
 - Score < 70 → 미합의 항목 수정 → Phase 4 재실행 (최대 2회)
 - 2회 재실행 후에도 < 70 → AskUserQuestion으로 현황 보고 + 사용자 판단 요청
 
+**산출물 저장**
+- `.tfx/fullcycle/{run-id}/validation-decision.md`
+
 ### Final: 완료 보고
 
 ```markdown
@@ -180,6 +248,12 @@ Phase 4의 3자 결과에 Consensus 프로토콜을 적용한다.
 - {항목}: {각 CLI 입장}
 ```
 
+## CLEANUP & CANCEL RULES
+
+- 성공 시 `state.json`을 complete 상태로 기록하고 orphan state가 남지 않도록 정리한다.
+- 취소/비정상 종료 시에도 마지막 phase, failure_reason, 재개 힌트를 남겨 다음 실행에서 resume 가능해야 한다.
+- cleanup은 상태를 무조건 삭제하는 것이 아니라, 성공/취소 여부가 판별되도록 메타데이터를 남긴 뒤 정리한다.
+
 ## ERROR RECOVERY
 
 | 상황 | 대응 |
@@ -188,6 +262,7 @@ Phase 4의 3자 결과에 Consensus 프로토콜을 적용한다.
 | Consensus 2회 연속 실패 | AskUserQuestion으로 미합의 항목 제시 + 사용자 판단 요청 |
 | 특정 Phase 결과 누락 | 해당 Phase만 단독 재실행 |
 | 빌드/테스트 실패 | Codex에 실패 로그 전달하여 수정 지시 |
+| 동일 QA 에러 3회 반복 | 루프 중단 + 근본 이슈 보고서 작성 + 사용자 판단 요청 |
 
 ## TOKEN BUDGET
 

package/skills/tfx-hub/SKILL.md

@@ -91,7 +91,9 @@ Bash("curl -s http://127.0.0.1:27888/status 2>/dev/null || echo '{\"error\":\"hu
 허브 시작 후 각 CLI에 MCP 서버로 등록:
 
 ```bash
-# Codex
+# Codex (수동 opt-in 예시)
+# triflux는 config.json을 자동 관리하며, standalone Codex 노이즈 방지를 위해
+# 사전 등록은 disabled로 두고 `tfx hub start` 이후에만 enabled로 전환한다.
 codex mcp add tfx-hub --url http://127.0.0.1:27888/mcp
 
 # Gemini (settings.json)

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

@@ -153,55 +153,41 @@ Get-Content 'C:\path\prompts\prompt.md' -Raw | codex
 
 ---
 
-## RULE 5: WT 세션 정리 — CRITICAL (프리징 치명 버그)
+## RULE 5: WT 패인 정리 — CRITICAL (크래시/프리징 방지)
 
-> **이 규칙을 위반하면 Windows Terminal이 완전히 프리징된다.**
-> 복구 방법은 작업 관리자에서 WindowsTerminal.exe 강제 종료뿐이다.
-> **모든 열린 탭/세션이 유실된다.** 절대 위반하지 마라.
+> **이 규칙을 위반하면 Windows Terminal이 크래시/프리징된다.**
+> 원인: WT 1.24의 ConPTY close 레이스 버그 ([microsoft/terminal#17871](https://github.com/microsoft/terminal/issues/17871)).
+> `kill-session`은 물론 `send-keys "exit"`도 ConPTY 파이프 끊김 → 동일 레이스 가능.
+> **유일한 안전 경로: detach-client로 WT와 ConPTY 연결을 먼저 분리.**
 
-### 프리징 원인
-
-WT 패인이 `psmux attach-session`으로 세션에 연결된 상태에서
-`psmux kill-session`을 직접 호출하면 WT의 PTY 핸들이 dangling 상태가 되어
-**전체 WT 프로세스가 응답 불능**이 된다.
-
-### MUST — 3단계 정리 (순서 반드시 준수)
+### MUST — 3단계 정리 (detach-first, 순서 반드시 준수)
 
 ```bash
-# 1) graceful exit — 각 세션 내 프로세스를 정상 종료
+# 1) WT 클라이언트를 세션에서 detach (ConPTY 연결 안전 분리)
 for s in $(psmux list-sessions -F '#{session_name}' 2>/dev/null | grep "$PREFIX"); do
-  psmux send-keys -t "$s" "exit" Enter 2>/dev/null || true
+  psmux detach-client -t "$s" 2>/dev/null || true
 done
 
-# 2) WT 패인 분리 대기 — exit이 WT에 전파되는 시간 필요
+# 2) WT가 detach된 pane을 정리할 시간 확보
 sleep 2
 
-# 3) 잔여 세션 강제 종료 — exit이 먹히지 않은 경우만
+# 3) detach된 세션을 안전하게 kill (WT와 무관)
 for s in $(psmux list-sessions -F '#{session_name}' 2>/dev/null | grep "$PREFIX"); do
   psmux kill-session -t "$s" 2>/dev/null || true
 done
 ```
 
-### MUST NOT — 아래 패턴은 전부 프리징 유발
+### MUST NOT — 아래 패턴은 전부 크래시/프리징 유발
 
 ```bash
-# WRONG 1 — exit 없이 바로 kill
-psmux kill-session -t "$session"
+# WRONG 1 — detach 없이 바로 kill
+psmux kill-session -t "$s"
 
-# WRONG 2 — sleep 없이 exit 직후 kill
+# WRONG 2 — exit도 ConPTY 파이프 끊김 → 같은 레이스
 psmux send-keys -t "$s" "exit" Enter
-psmux kill-session -t "$s"   # ← WT가 아직 PTY를 잡고 있음
-
-# WRONG 3 — detach 직후 kill
-psmux send-keys -t "$s" "psmux detach" Enter
-psmux kill-session -t "$s"   # ← detach 완료 전에 kill → 프리징
-```
-
-### WT 패인 직접 닫기 (세션이 아닌 WT 쪽에서 정리)
 
-```bash
-# WT 패인을 닫는 것이 세션 kill보다 안전
-wt.exe -w 0 close-pane    # 현재 포커스된 패인 닫기
+# WRONG 3 — WT split pane 직접 닫기 (Ctrl+Shift+W 금지)
+# 대신: pane 안에서 psmux detach (또는 Ctrl+B, D) → pane이 자동으로 닫힘
 ```
 
 ---
@@ -220,7 +206,43 @@ psmux는 환경마다 설치 위치가 다르다. `hub/team/psmux.mjs`의 `PSMUX
 
 ---
 
-## RULE 5-2: WT 명령 치트시트
+## RULE 5-2: 설치 / 업데이트 preflight
+
+`psmux`는 단순히 PATH에 있다고 끝이 아니다. Triflux는 아래 capability를 전제로 한다.
+
+- `new-session`
+- `attach-session`
+- `kill-session`
+- `capture-pane`
+- `detach-client` (있으면 attach/detach cleanup hardening에 활용)
+
+설치/업데이트가 의심될 때는 먼저:
+
+```bash
+tfx doctor --json
+```
+
+공식 설치/업데이트 기준:
+
+```bash
+# install
+winget install marlocarlo.psmux
+scoop install psmux
+choco install psmux
+cargo install psmux
+
+# update
+winget upgrade marlocarlo.psmux
+scoop update psmux
+choco upgrade psmux
+cargo install psmux --force
+```
+
+**금지:** 문서/스크립트에서 `npm install -g psmux`를 표준 설치 경로처럼 안내하지 않는다.
+
+---
+
+## RULE 5-3: WT 명령 치트시트
 
 ### 패인 분할
 

package/skills/tfx-remote-spawn/references/hosts.json

@@ -1,16 +1,16 @@
-{
-  "hosts": {
-    "ultra4": {
-      "description": "Windows 데스크탑 (SSAFY)",
-      "aliases": ["울트라", "데스크탑"],
-      "default_dir": "~/Desktop/Projects"
-    },
-    "m2": {
-      "description": "MacBook Pro",
-      "aliases": ["맥북", "맥"],
-      "default_dir": "~/projects"
-    }
-  },
-  "default_host": "ultra4",
-  "triggers": ["원격에서", "다른 머신에서", "다른 컴퓨터에서"]
-}
+{
+  "hosts": {
+    "ultra4": {
+      "description": "Windows 데스크탑 (SSAFY)",
+      "aliases": ["울트라", "데스크탑"],
+      "default_dir": "~/Desktop/Projects"
+    },
+    "m2": {
+      "description": "MacBook Pro",
+      "aliases": ["맥북", "맥"],
+      "default_dir": "~/projects"
+    }
+  },
+  "default_host": "ultra4",
+  "triggers": ["원격에서", "다른 머신에서", "다른 컴퓨터에서"]
+}

package/skills/tfx-setup/SKILL.md

@@ -132,6 +132,15 @@ Bash("triflux setup")
 
 #### 단계 4: CLI 진단
 
+`triflux doctor --json`에는 psmux 설치 여부뿐 아니라 **버전/capability preflight**도 포함된다.
+특히 Windows에서는 아래 capability가 모두 있어야 headless 멀티모델 오케스트레이션을 안전하게 쓸 수 있다:
+
+- `new-session`
+- `attach-session`
+- `kill-session`
+- `capture-pane`
+- `detach-client` 지원 여부도 함께 확인 (attach/detach hardening 참고)
+
 `triflux doctor --json`을 Bash로 실행하여 CLI 존재 여부 확인.
 결과를 테이블로 표시.
 

package/tui/doctor.mjs

@@ -28,6 +28,7 @@ const CACHE_FILES = [
   { name: "mcp-inventory.json", desc: "MCP 인벤토리" },
   { name: "cli-issues.jsonl", desc: "CLI 이슈 로그" },
   { name: "triflux-update-check.json", desc: "업데이트 체크" },
+  { name: "tfx-preflight.json", desc: "Preflight 캐시 (CLI/Hub 가용성)" },
 ];
 
 // ── Run triflux doctor --json ──