triflux 8.5.1 → 8.6.0

package/bin/triflux.mjs

@@ -735,7 +735,7 @@ function previewMcpRegistrationActions(mcpUrl) {
     type: "mcp-register",
     cli: "claude",
     target: "tfx-hub",
-    path: join(PKG_ROOT, ".mcp.json"),
+    path: join(process.cwd(), ".claude", "mcp.json"),
     url: mcpUrl,
     change: "check",
   });
@@ -2161,16 +2161,18 @@ function autoRegisterMcp(mcpUrl) {
     info("Gemini: 미설치 (건너뜀)");
   }
 
-  // Claude — 프로젝트 .mcp.json에 등록 (오케스트레이터용)
+  // Claude — .claude/mcp.json에 등록 (Claude Code 공식 경로)
   try {
-    const mcpJsonPath = join(PKG_ROOT, ".mcp.json");
+    const claudeDir = join(process.cwd(), ".claude");
+    if (!existsSync(claudeDir)) mkdirSync(claudeDir, { recursive: true });
+    const mcpJsonPath = join(claudeDir, "mcp.json");
     let mcpJson = {};
     if (existsSync(mcpJsonPath)) mcpJson = JSON.parse(readFileSync(mcpJsonPath, "utf8"));
     if (!mcpJson.mcpServers) mcpJson.mcpServers = {};
     if (!mcpJson.mcpServers["tfx-hub"]) {
       mcpJson.mcpServers["tfx-hub"] = { type: "url", url: mcpUrl };
       writeFileSync(mcpJsonPath, JSON.stringify(mcpJson, null, 2) + "\n");
-      ok("Claude: .mcp.json에 등록 완료");
+      ok("Claude: .claude/mcp.json에 등록 완료");
     } else {
       ok("Claude: 이미 등록됨");
     }

package/hub/team/backend.mjs

@@ -32,7 +32,7 @@ export class GeminiBackend {
   command() { return "gemini"; }
 
   buildArgs(prompt, resultFile, opts = {}) {
-    return `gemini -p ${prompt} --output-format text > '${resultFile}' 2>'${resultFile}.err'`;
+    return `gemini --prompt ${prompt} --output-format text > '${resultFile}' 2>'${resultFile}.err'`;
   }
 
   env() { return {}; }

package/hub/team/psmux.mjs

@@ -758,7 +758,7 @@ export function startCapture(sessionName, paneNameOrTarget) {
  * CLI 명령(codex/gemini)이 psmux pane의 PowerShell 환경에서 단축 플래그 충돌을
  * 일으키는 문제를 방지하기 위해 bash -c '...' 로 감싼다.
  * - codex -o flag → PS -OutVariable/OutBuffer 충돌
- * - gemini -p flag → PS -ProgressAction/PipelineVariable 충돌
+ * - gemini --prompt flag (v8.6.0: -p → --prompt, PS 충돌 해소)
  * @param {string} cmd
  * @returns {string}
  */

package/package.json

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

package/scripts/demo-tui.mjs

@@ -0,0 +1,59 @@
+#!/usr/bin/env node
+// TUI 대시보드 데모 — 5초간 시뮬레이션 후 자동 종료
+import { createLogDashboard } from "../hub/team/tui.mjs";
+
+const tui = createLogDashboard({ refreshMs: 200, forceTTY: true });
+
+// Phase 1: 워커 시작
+tui.updateWorker("worker-1", {
+  cli: "codex", role: "executor", status: "running",
+  progress: 0.1, confidence: "low", tokens: "0.3k",
+  snapshot: "analyzing codebase...",
+  detail: "mcp: serena/activate_project started",
+});
+tui.updateWorker("worker-2", {
+  cli: "gemini", role: "writer", status: "running",
+  progress: 0.05, confidence: "low",
+  snapshot: "loading context...",
+  detail: "initializing gemini session",
+});
+
+// Phase 2: 진행
+setTimeout(() => {
+  tui.updateWorker("worker-1", {
+    progress: 0.45, tokens: "1.2k", confidence: "medium",
+    snapshot: "mcp: serena/read_file (completed)",
+    detail: "mcp: serena/activate_project (completed)\nmcp: serena/read_file started\nmcp: serena/read_file (completed)\nmcp: serena/find_symbol started",
+  });
+  tui.updateWorker("worker-2", {
+    progress: 0.3, tokens: "0.8k",
+    snapshot: "writing README section...",
+    detail: "initializing gemini session\nreading existing docs\nwriting README section...",
+  });
+}, 1500);
+
+// Phase 3: worker-2 완료
+setTimeout(() => {
+  tui.updateWorker("worker-1", {
+    progress: 0.78, tokens: "2.1k", confidence: "high",
+    snapshot: "applying fix to tui.mjs",
+    detail: "mcp: serena/activate_project (completed)\nmcp: serena/read_file (completed)\nmcp: serena/find_symbol (completed)\nmcp: serena/replace_symbol_body started\napplying fix to tui.mjs",
+    handoff: { files_changed: ["hub/team/tui.mjs"] },
+  });
+  tui.updateWorker("worker-2", {
+    status: "completed", progress: 1, tokens: "1.5k", confidence: "high",
+    handoff: { status: "ok", verdict: "documentation updated", confidence: "high", files_changed: ["README.md"] },
+  });
+}, 3000);
+
+// Phase 4: 전부 완료
+setTimeout(() => {
+  tui.updateWorker("worker-1", {
+    status: "completed", progress: 1, tokens: "3.4k", confidence: "high",
+    handoff: { status: "ok", verdict: "fix applied and verified", confidence: "high", files_changed: ["hub/team/tui.mjs", "tests/unit/tui.test.mjs"] },
+  });
+  tui.updatePipeline({ phase: "verify" });
+}, 4500);
+
+// 종료
+setTimeout(() => { tui.close(); process.exit(0); }, 6000);

package/scripts/headless-guard.mjs

@@ -15,7 +15,7 @@
  *
  * 동작:
  * - psmux 설치 + Bash(tfx-route.sh) → updatedInput: tfx multi --headless --assign
- * - psmux 설치 + Bash(codex exec / gemini -p) → deny
+ * - psmux 설치 + Bash(codex exec / gemini --prompt) → deny
  * - psmux 설치 + Agent(codex/gemini CLI 래핑) → deny
  * - psmux 미설치 → 전부 통과
  * - tfx-multi 활성 + Agent(work) before dispatch → deny (A: gate)

package/scripts/tfx-route-worker.mjs

@@ -121,8 +121,12 @@ function readPromptFromStdin() {
 }
 
 function resolveDefaultMcpConfig(cwd) {
-  const candidate = resolve(cwd, '.mcp.json');
-  return existsSync(candidate) ? [candidate] : [];
+  const primary = resolve(cwd, '.claude', 'mcp.json');
+  if (existsSync(primary)) return [primary];
+  const legacy = resolve(cwd, '.mcp.json');
+  if (existsSync(legacy)) return [legacy];
+  process.stderr.write('[tfx-route-worker] warning: no MCP config found, hub unavailable\n');
+  return [];
 }
 
 const args = parseArgs(process.argv.slice(2));

package/skills/tfx-analysis/SKILL.md

@@ -1,101 +1,101 @@
----
-name: tfx-analysis
-description: "코드나 아키텍처를 분석해야 할 때 사용한다. '코드 분석', 'code analysis', '아키텍처 분석', '이 코드 어떻게 돌아가?', '구조 파악' 같은 요청에 반드시 사용. 코드 품질, 보안, 성능, 복잡도 분석이 필요한 모든 상황에 적극 활용."
-triggers:
-  - 코드 분석
-  - code analysis
-  - 아키텍처 분석
-  - analysis
-argument-hint: "<분석 대상 — 파일, 디렉토리, 또는 주제>"
----
-
-# tfx-analysis — Light Code Analysis
-
-> Codex 단일 분석으로 빠른 인사이트. SuperClaude sc:analyze 영감.
-
-## 용도
-
-- 코드 품질 빠른 점검
-- 모듈/파일 구조 분석
-- 의존성 관계 파악
-- 성능 병목 후보 식별
-- 기술 부채 탐지
-- "이 코드 어떤 상태야?" 류의 질문
-
-## 워크플로우
-
-### Step 1: 분석 대상 식별
-
-```
-우선순위:
-  1. 사용자가 파일/디렉토리 지정 → 해당 범위
-  2. 사용자가 주제 지정 (예: "인증 모듈") → 관련 파일 탐색
-  3. 지정 없음 → 프로젝트 전체 고수준 분석
-
-분석 유형 자동 감지:
-  파일 1개 → 코드 품질 + 로직 분석
-  디렉토리 → 구조 + 의존성 + 모듈 분석
-  프로젝트 전체 → 아키텍처 + 기술 부채 분석
-```
-
-### Step 2: Codex 분석 실행
-
-```bash
-codex exec --dangerously-bypass-approvals-and-sandbox --skip-git-repo-check \
-  "시니어 소프트웨어 엔지니어로서 다음을 분석하라:
-   대상: {target}
-   유형: {analysis_type}
-
-   분석 항목:
-   1. 구조 — 파일/모듈 구성, 계층, 의존성 방향
-   2. 복잡도 — 순환 복잡도 높은 함수, 깊은 중첩
-   3. 품질 — SOLID 위반, 코드 냄새, 중복
-   4. 성능 — O(n²) 패턴, 불필요한 연산, 캐싱 부재
-   5. 기술 부채 — TODO/FIXME, deprecated API, 하드코딩
-   6. 테스트 — 커버리지 추정, 테스트 부재 영역
-
-   구조화된 보고서로 출력하라."
-```
-
-### Step 3: 결과 포맷
-
-```markdown
-## 분석 결과: {target}
-
-### 구조 개요
-{파일/모듈 구조 요약 또는 의존성 다이어그램}
-
-### 주요 발견
-| # | 카테고리 | 심각도 | 설명 | 위치 |
-|---|---------|--------|------|------|
-| 1 | 복잡도 | high | {설명} | `{file}:{line}` |
-| 2 | 성능 | medium | {설명} | `{file}:{line}` |
-
-### 메트릭
-- 파일 수: {n} | 총 라인: {n}
-- 평균 복잡도: {n} | 최대 복잡도: {n} (`{file}:{function}`)
-- TODO/FIXME: {n}개
-- 테스트 커버리지 추정: {n}%
-
-### 개선 권장사항
-1. **{우선순위 1}** — {구체적 제안}
-2. **{우선순위 2}** — {구체적 제안}
-3. **{우선순위 3}** — {구체적 제안}
-```
-
-## 토큰 예산
-
-| 단계 | 토큰 |
-|------|------|
-| Step 1 (식별) | ~500 |
-| Step 2 (Codex 분석) | ~5K |
-| Step 3 (포맷) | ~2K |
-| **총합** | **~8K** |
-
-## 사용 예
-
-```
-/tfx-analysis "src/auth/"
-/tfx-analysis "이 프로젝트 전체 아키텍처 분석"
-/tfx-analysis "src/utils/parser.ts 코드 품질"
-```
+---
+name: tfx-analysis
+description: "코드나 아키텍처를 분석해야 할 때 사용한다. '코드 분석', 'code analysis', '아키텍처 분석', '이 코드 어떻게 돌아가?', '구조 파악' 같은 요청에 반드시 사용. 코드 품질, 보안, 성능, 복잡도 분석이 필요한 모든 상황에 적극 활용."
+triggers:
+  - 코드 분석
+  - code analysis
+  - 아키텍처 분석
+  - analysis
+argument-hint: "<분석 대상 — 파일, 디렉토리, 또는 주제>"
+---
+
+# tfx-analysis — Light Code Analysis
+
+> Codex 단일 분석으로 빠른 인사이트. SuperClaude sc:analyze 영감.
+
+## 용도
+
+- 코드 품질 빠른 점검
+- 모듈/파일 구조 분석
+- 의존성 관계 파악
+- 성능 병목 후보 식별
+- 기술 부채 탐지
+- "이 코드 어떤 상태야?" 류의 질문
+
+## 워크플로우
+
+### Step 1: 분석 대상 식별
+
+```
+우선순위:
+  1. 사용자가 파일/디렉토리 지정 → 해당 범위
+  2. 사용자가 주제 지정 (예: "인증 모듈") → 관련 파일 탐색
+  3. 지정 없음 → 프로젝트 전체 고수준 분석
+
+분석 유형 자동 감지:
+  파일 1개 → 코드 품질 + 로직 분석
+  디렉토리 → 구조 + 의존성 + 모듈 분석
+  프로젝트 전체 → 아키텍처 + 기술 부채 분석
+```
+
+### Step 2: Codex 분석 실행
+
+```bash
+bash ~/.claude/scripts/tfx-route.sh codex \
+  "시니어 소프트웨어 엔지니어로서 다음을 분석하라:
+   대상: {target}
+   유형: {analysis_type}
+
+   분석 항목:
+   1. 구조 — 파일/모듈 구성, 계층, 의존성 방향
+   2. 복잡도 — 순환 복잡도 높은 함수, 깊은 중첩
+   3. 품질 — SOLID 위반, 코드 냄새, 중복
+   4. 성능 — O(n²) 패턴, 불필요한 연산, 캐싱 부재
+   5. 기술 부채 — TODO/FIXME, deprecated API, 하드코딩
+   6. 테스트 — 커버리지 추정, 테스트 부재 영역
+
+   구조화된 보고서로 출력하라." analyze
+```
+
+### Step 3: 결과 포맷
+
+```markdown
+## 분석 결과: {target}
+
+### 구조 개요
+{파일/모듈 구조 요약 또는 의존성 다이어그램}
+
+### 주요 발견
+| # | 카테고리 | 심각도 | 설명 | 위치 |
+|---|---------|--------|------|------|
+| 1 | 복잡도 | high | {설명} | `{file}:{line}` |
+| 2 | 성능 | medium | {설명} | `{file}:{line}` |
+
+### 메트릭
+- 파일 수: {n} | 총 라인: {n}
+- 평균 복잡도: {n} | 최대 복잡도: {n} (`{file}:{function}`)
+- TODO/FIXME: {n}개
+- 테스트 커버리지 추정: {n}%
+
+### 개선 권장사항
+1. **{우선순위 1}** — {구체적 제안}
+2. **{우선순위 2}** — {구체적 제안}
+3. **{우선순위 3}** — {구체적 제안}
+```
+
+## 토큰 예산
+
+| 단계 | 토큰 |
+|------|------|
+| Step 1 (식별) | ~500 |
+| Step 2 (Codex 분석) | ~5K |
+| Step 3 (포맷) | ~2K |
+| **총합** | **~8K** |
+
+## 사용 예
+
+```
+/tfx-analysis "src/auth/"
+/tfx-analysis "이 프로젝트 전체 아키텍처 분석"
+/tfx-analysis "src/utils/parser.ts 코드 품질"
+```

package/skills/tfx-autopilot/SKILL.md

@@ -1,112 +1,112 @@
----
-name: tfx-autopilot
-description: "간단한 작업을 자율적으로 구현해야 할 때 사용한다. 'autopilot', '자동으로', '알아서 해', '그냥 해줘', 'auto' 같은 요청에 반드시 사용. 명확한 단일 작업을 빠르게 자동 구현+검증할 때 적극 활용."
-triggers:
-  - autopilot
-  - 자동
-  - 알아서 해
-  - auto
-argument-hint: "<구현할 작업 설명>"
----
-
-# tfx-autopilot — Light Autonomous Execution
-
-> Codex 직접 구현 → Claude 검증. 최소 토큰으로 빠른 자율 실행.
-
-## 용도
-
-- 명확한 단일 작업을 빠르게 자동 구현
-- 보일러플레이트 생성 + 검증
-- 간단한 버그 수정 자동화
-- 린트/포맷/리팩터 자동 적용
-- "알아서 해줘" 류의 명확한 요청
-
-## 워크플로우
-
-### Step 1: 작업 파싱
-
-사용자 입력에서 구현 범위와 완료 기준을 추출한다:
-
-```
-입력: "로그인 API에 rate limiting 추가"
-파싱: {
-  task: "로그인 API에 rate limiting 추가",
-  scope: ["src/routes/auth.ts", "src/middleware/"],
-  criteria: [
-    "rate limiter 미들웨어 생성",
-    "로그인 엔드포인트에 적용",
-    "기존 테스트 통과"
-  ]
-}
-```
-
-모호하면 AskUserQuestion으로 명확화.
-
-### Step 2: Codex 직접 구현
-
-```bash
-codex exec --dangerously-bypass-approvals-and-sandbox --skip-git-repo-check \
-  "다음 작업을 구현하라:
-   작업: {task}
-   프로젝트 컨텍스트: {context}
-   완료 기준: {criteria}
-
-   1. 관련 파일을 읽고 구조를 파악하라
-   2. 필요한 코드를 작성/수정하라
-   3. 기존 테스트를 실행하여 회귀가 없는지 확인하라
-   4. 변경 사항을 요약하라"
-```
-
-### Step 3: Claude 검증
-
-Codex 실행 완료 후, Claude가 변경 사항을 검증한다:
-
-```
-검증 항목:
-  1. 파일 변경 확인 — git diff로 실제 변경 내용 확인
-  2. 완료 기준 충족 — 각 criterion 대조
-  3. 회귀 여부 — 테스트 결과 확인
-  4. 코드 품질 — 명백한 결함 여부 (깊은 리뷰는 아님)
-
-판정:
-  PASS → 완료 보고
-  FAIL → Codex에 수정 지시 (1회 재시도)
-  재시도 FAIL → 사용자에게 문제 보고
-```
-
-### Step 4: 완료 보고
-
-```markdown
-## Autopilot 완료: {task}
-
-### 변경 사항
-- `{file1}` — {변경 요약}
-- `{file2}` — {변경 요약}
-
-### 검증
-- 완료 기준: {pass}/{total} 충족
-- 테스트: {pass}/{total} 통과
-- 검증: Claude ✓
-
-### 다음 단계 (선택)
-- {추가 권장 사항이 있으면}
-```
-
-## 토큰 예산
-
-| 단계 | 토큰 |
-|------|------|
-| Step 1 (파싱) | ~500 |
-| Step 2 (Codex 구현) | ~5K |
-| Step 3 (Claude 검증) | ~3K |
-| Step 4 (보고) | ~500 |
-| 재시도 (필요 시) | +4K |
-| **총합** | **~10K** |
-
-## 사용 예
-
-```
-/tfx-autopilot "이 함수에 입력 검증 추가해줘"
-/tfx-autopilot "ESLint 경고 전부 수정"
-/tfx-autopilot "알아서 해 — 이 TODO 코멘트 3개 구현"
-```
+---
+name: tfx-autopilot
+description: "간단한 작업을 자율적으로 구현해야 할 때 사용한다. 'autopilot', '자동으로', '알아서 해', '그냥 해줘', 'auto' 같은 요청에 반드시 사용. 명확한 단일 작업을 빠르게 자동 구현+검증할 때 적극 활용."
+triggers:
+  - autopilot
+  - 자동
+  - 알아서 해
+  - auto
+argument-hint: "<구현할 작업 설명>"
+---
+
+# tfx-autopilot — Light Autonomous Execution
+
+> Codex 직접 구현 → Claude 검증. 최소 토큰으로 빠른 자율 실행.
+
+## 용도
+
+- 명확한 단일 작업을 빠르게 자동 구현
+- 보일러플레이트 생성 + 검증
+- 간단한 버그 수정 자동화
+- 린트/포맷/리팩터 자동 적용
+- "알아서 해줘" 류의 명확한 요청
+
+## 워크플로우
+
+### Step 1: 작업 파싱
+
+사용자 입력에서 구현 범위와 완료 기준을 추출한다:
+
+```
+입력: "로그인 API에 rate limiting 추가"
+파싱: {
+  task: "로그인 API에 rate limiting 추가",
+  scope: ["src/routes/auth.ts", "src/middleware/"],
+  criteria: [
+    "rate limiter 미들웨어 생성",
+    "로그인 엔드포인트에 적용",
+    "기존 테스트 통과"
+  ]
+}
+```
+
+모호하면 AskUserQuestion으로 명확화.
+
+### Step 2: Codex 직접 구현
+
+```bash
+bash ~/.claude/scripts/tfx-route.sh codex \
+  "다음 작업을 구현하라:
+   작업: {task}
+   프로젝트 컨텍스트: {context}
+   완료 기준: {criteria}
+
+   1. 관련 파일을 읽고 구조를 파악하라
+   2. 필요한 코드를 작성/수정하라
+   3. 기존 테스트를 실행하여 회귀가 없는지 확인하라
+   4. 변경 사항을 요약하라" implement
+```
+
+### Step 3: Claude 검증
+
+Codex 실행 완료 후, Claude가 변경 사항을 검증한다:
+
+```
+검증 항목:
+  1. 파일 변경 확인 — git diff로 실제 변경 내용 확인
+  2. 완료 기준 충족 — 각 criterion 대조
+  3. 회귀 여부 — 테스트 결과 확인
+  4. 코드 품질 — 명백한 결함 여부 (깊은 리뷰는 아님)
+
+판정:
+  PASS → 완료 보고
+  FAIL → Codex에 수정 지시 (1회 재시도)
+  재시도 FAIL → 사용자에게 문제 보고
+```
+
+### Step 4: 완료 보고
+
+```markdown
+## Autopilot 완료: {task}
+
+### 변경 사항
+- `{file1}` — {변경 요약}
+- `{file2}` — {변경 요약}
+
+### 검증
+- 완료 기준: {pass}/{total} 충족
+- 테스트: {pass}/{total} 통과
+- 검증: Claude ✓
+
+### 다음 단계 (선택)
+- {추가 권장 사항이 있으면}
+```
+
+## 토큰 예산
+
+| 단계 | 토큰 |
+|------|------|
+| Step 1 (파싱) | ~500 |
+| Step 2 (Codex 구현) | ~5K |
+| Step 3 (Claude 검증) | ~3K |
+| Step 4 (보고) | ~500 |
+| 재시도 (필요 시) | +4K |
+| **총합** | **~10K** |
+
+## 사용 예
+
+```
+/tfx-autopilot "이 함수에 입력 검증 추가해줘"
+/tfx-autopilot "ESLint 경고 전부 수정"
+/tfx-autopilot "알아서 해 — 이 TODO 코멘트 3개 구현"
+```