triflux 10.0.5 → 10.0.6

package/hub/team/swarm-hypervisor.mjs

@@ -19,6 +19,8 @@ import { createConductor, STATES } from './conductor.mjs';
 import { createSwarmLocks } from './swarm-locks.mjs';
 import { createEventLog } from './event-log.mjs';
 import { probeRemoteEnv, resolveRemoteDir } from './remote-session.mjs';
+import { fetchRemoteShard } from './worktree-lifecycle.mjs';
+import { getHostConfig } from '../lib/ssh-command.mjs';
 
 // ── Swarm states ──────────────────────────────────────────────
 
@@ -337,6 +339,28 @@ export function createSwarmHypervisor(opts) {
       const worker = workers.get(shardName);
       if (!worker) continue;
 
+      // Fetch remote shard branch to local (push-blocked hosts like Ultra4)
+      const shard = plan.shards.find((s) => s.name === shardName);
+      if (shard?.host && shard._remoteEnv) {
+        const hostConfig = getHostConfig(shard.host, config.rootDir);
+        const sshUser = hostConfig?.ssh_user || shard.host;
+        const remoteRepoPath = resolveRemoteDir(config.rootDir || process.cwd(), shard._remoteEnv);
+        const fetchResult = await fetchRemoteShard({
+          host: shard.host,
+          sshUser,
+          remoteRepoPath,
+          branchName: worker.branchName || `swarm/${config.runId}/${shardName}`,
+          rootDir: config.rootDir || process.cwd(),
+        });
+
+        if (!fetchResult.ok) {
+          eventLog.append('remote_fetch_failed', { shard: shardName, error: fetchResult.error });
+          integrationFailures.push(shardName);
+          continue;
+        }
+        eventLog.append('remote_fetch_ok', { shard: shardName, headCommit: fetchResult.headCommit });
+      }
+
       // Read shard output log for changed files
       const changedFiles = detectChangedFiles(shardName, worker);
 

package/hub/team/worktree-lifecycle.mjs

@@ -6,7 +6,7 @@
 import { execFile } from 'node:child_process';
 import { resolve, normalize } from 'node:path';
 import { mkdir, rm, access } from 'node:fs/promises';
-import { remoteGit } from './remote-session.mjs';
+import { remoteGit, validateHost } from './remote-session.mjs';
 
 const SWARM_ROOT = '.codex-swarm';
 const SLEEP_MS = 2000; // WT race-guard (MEMORY.md: wt-attach-spacing)
@@ -191,3 +191,39 @@ export async function pruneWorktree({ worktreePath, branchName, rootDir = proces
     try { await git(['branch', '-D', branchName], rootDir); } catch { /* may not exist */ }
   }
 }
+
+/**
+ * Fetch a remote shard's branch to the local repo via SSH.
+ * Workaround for hosts that cannot push to GitHub (e.g. Ultra4).
+ *
+ * Flow: add temp remote → fetch branch → remove remote.
+ *
+ * @param {object} opts
+ * @param {string} opts.host — SSH host (e.g. "ultra4")
+ * @param {string} opts.sshUser — SSH user (e.g. "SSAFY")
+ * @param {string} opts.remoteRepoPath — absolute path on remote (e.g. "/c/Users/SSAFY/Desktop/Projects/cli/triflux")
+ * @param {string} opts.branchName — branch to fetch (e.g. "swarm/run123/auth")
+ * @param {string} [opts.rootDir=process.cwd()] — local repo root
+ * @returns {Promise<{ ok: boolean, localRef?: string, error?: string }>}
+ */
+export async function fetchRemoteShard({ host, sshUser, remoteRepoPath, branchName, rootDir = process.cwd() }) {
+  validateHost(host);
+
+  const remoteName = `_swarm-${host}-${Date.now()}`;
+  const sshUrl = `ssh://${sshUser}@${host}${remoteRepoPath}`;
+
+  try {
+    await git(['remote', 'add', remoteName, sshUrl], rootDir);
+
+    await git(['fetch', remoteName, branchName, '--no-tags'], rootDir);
+
+    const localRef = `${remoteName}/${branchName}`;
+    const headCommit = await git(['rev-parse', `FETCH_HEAD`], rootDir);
+
+    return { ok: true, localRef, headCommit };
+  } catch (err) {
+    return { ok: false, error: err.message };
+  } finally {
+    try { await git(['remote', 'remove', remoteName], rootDir); } catch { /* cleanup */ }
+  }
+}

package/package.json

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

package/scripts/__tests__/keyword-detector.test.mjs

@@ -29,7 +29,7 @@ const { extractPrompt, sanitizeForKeywordDetection } = detectorModule;
 
 function loadCompiledRules() {
   const rules = loadRules(rulesPath);
-  assert.equal(rules.length, 33);
+  assert.equal(rules.length, 31);
   return compileRules(rules);
 }
 
@@ -100,8 +100,8 @@ test("sanitizeForKeywordDetection: 코드블록/URL/파일경로/XML 태그 제
 
 test("loadRules: 유효한 JSON 로드", () => {
   const rules = loadRules(rulesPath);
-  assert.equal(rules.length, 33);
-  assert.equal(rules.filter((rule) => rule.skill).length, 20);
+  assert.equal(rules.length, 31);
+  assert.equal(rules.filter((rule) => rule.skill).length, 18);
   assert.equal(rules.filter((rule) => rule.mcp_route).length, 10);
 });
 
@@ -122,7 +122,7 @@ test("loadRules: 잘못된 파일 처리", () => {
 test("compileRules: 정규식 컴파일 성공", () => {
   const rules = loadRules(rulesPath);
   const compiled = compileRules(rules);
-  assert.equal(compiled.length, 33);
+  assert.equal(compiled.length, 31);
   for (const rule of compiled) {
     assert.ok(Array.isArray(rule.compiledPatterns));
     assert.ok(rule.compiledPatterns.length > 0);
@@ -153,7 +153,7 @@ test("matchRules: tfx 키워드 매칭", () => {
   const compiledRules = loadCompiledRules();
   const cases = [
     { text: "tfx multi 세션 시작", expectedId: "tfx-multi" },
-    { text: "tfx auto 돌려줘", expectedId: "tfx-auto" },
+    { text: "tfx auto 돌려줘", expectedId: "tfx-unified" },
     { text: "tfx codex 로 실행", expectedId: "tfx-codex" },
     { text: "tfx gemini 로 실행", expectedId: "tfx-gemini" },
     { text: "canceltfx", expectedId: "tfx-cancel" }

package/scripts/pack.mjs

@@ -227,7 +227,7 @@ export { createSwarmLocks } from './team/swarm-locks.mjs';
 export { parseShards, buildFileLeaseMap, buildMcpManifest, computeMergeOrder, planSwarm } from './team/swarm-planner.mjs';
 export { createSwarmHypervisor, SWARM_STATES } from './team/swarm-hypervisor.mjs';
 export { reconcile, buildRedundantIds, shouldRunRedundant } from './team/swarm-reconciler.mjs';
-export { ensureWorktree, prepareIntegrationBranch, rebaseShardOntoIntegration, pruneWorktree } from './team/worktree-lifecycle.mjs';
+export { ensureWorktree, prepareIntegrationBranch, rebaseShardOntoIntegration, pruneWorktree, fetchRemoteShard } from './team/worktree-lifecycle.mjs';
 `;
 
 function writeIndex(dest, content) {

package/skills/tfx-auto/SKILL.md

@@ -40,6 +40,51 @@ argument-hint: "<command|task> [args...]"
 > - Errors: 실패 시 원인/복구/재시도 여부를 구조화해 기록한다.
 
 
+### Step 0: 스마트 라우팅 (tfx-auto 진입 시 자동 실행)
+
+preamble에서 routing-weights.json을 읽고, 사용자 입력을 분석하여 dispatch 결정.
+
+```bash
+SLUG=$(basename "$(git rev-parse --show-toplevel 2>/dev/null)" 2>/dev/null || echo "unknown")
+WEIGHTS_FILE="$HOME/.gstack/projects/$SLUG/routing-weights.json"
+USER_MODE=""
+if [ -f "$WEIGHTS_FILE" ]; then
+  USER_MODE=$(node -e "
+    const w=JSON.parse(require('fs').readFileSync('$WEIGHTS_FILE','utf8'));
+    const m=w.weights?.mode_bias||{};
+    const top=Object.entries(m).sort((a,b)=>b[1]-a[1])[0];
+    if(top && top[1]>0.3) console.log(top[0]);
+  " 2>/dev/null)
+fi
+echo "USER_PREFERRED_MODE: ${USER_MODE:-none}"
+```
+
+판단 기준 (우선순위 순):
+
+1. **사용자 명시 키워드** (최우선):
+   - "병렬", "swarm", "PRD 돌려" → `Skill("tfx-swarm")` dispatch
+   - "꼼꼼히", "제대로", "deep" → 해당 `tfx-deep-*` dispatch
+   - "끝까지", "멈추지마", "ralph" → `Skill("tfx-persist")` dispatch
+   - "multi", "팀", "협업" → `Skill("tfx-multi")` dispatch
+   - "codex로", "gemini로" → `Skill("tfx-codex")` 또는 `Skill("tfx-gemini")` dispatch
+
+2. **PRD 인자 분석**:
+   - PRD 경로 2개 이상 → `Skill("tfx-swarm")` dispatch
+   - PRD 1개 + XL 규모 → `Skill("tfx-fullcycle")` dispatch
+
+3. **선호도 가중치** (tiebreaker):
+   - USER_PREFERRED_MODE가 있고 가중치 > 0.3이면 제안
+   - "[tfx] 사용자 선호: {mode}. 이 모드로 실행할까요?" 1줄 표시
+   - 응답 없으면 기본(auto) 진행
+
+4. **기본**: 기존 tfx-auto 워크플로우 그대로 실행
+
+dispatch 시 해당 스킬을 Skill 도구로 호출하고 **이 워크플로우를 종료**한다. dispatch하지 않으면 아래 기존 워크플로우 진행.
+
+라우팅 결정 후 1줄 표시:
+```
+[tfx] 규모: {S/M/L/XL}, 모드: {mode} ({profile}) — 오버라이드: /tfx-multi, /tfx-swarm 등
+```
 
 > **MANDATORY RULES**
 >

package/skills/tfx-codex/SKILL.md

@@ -1,4 +1,5 @@
 ---
+internal: true
 name: tfx-codex
 description: >
   Codex-Only 오케스트레이터. tfx-auto 워크플로우를 Codex 전용으로 고정합니다.

package/skills/tfx-codex/skill.json

@@ -4,5 +4,6 @@
   "triggers": [
     "tfx-codex"
   ],
-  "argument_hint": "\\\"작업 설명\\\" | N:codex \\\"작업 설명\\\""
+  "argument_hint": "\\\"작업 설명\\\" | N:codex \\\"작업 설명\\\"",
+  "internal": true
 }

package/skills/tfx-find/SKILL.md

@@ -1,4 +1,5 @@
 ---
+internal: true
 name: tfx-find
 description: >
   코드베이스에서 파일, 함수, 클래스, 문자열을 빠르게 찾을 때 사용한다.

package/skills/tfx-find/skill.json

@@ -8,5 +8,6 @@
     "코드에서 찾기",
     "코드베이스 검색"
   ],
-  "argument_hint": "<검색 패턴 또는 질문>"
+  "argument_hint": "<검색 패턴 또는 질문>",
+  "internal": true
 }

package/skills/tfx-plan/SKILL.md

@@ -1,4 +1,5 @@
 ---
+internal: true
 name: tfx-plan
 description: "구현 계획이 필요할 때 사용한다. '계획 세워줘', 'plan', '플랜', '어떻게 구현하지', '태스크 분해', '작업 순서' 같은 요청에 반드시 사용. 기능 구현 전 영향 범위 파악과 태스크 분해가 필요할 때 적극 활용. 작업 분해, 순서 정리, '어떤 순서로', '먼저 뭐 해야', 'breakdown', 'decompose', 'task list' 같은 요청에도 적극 활용. 단순 계획은 이 스킬, 3자 합의 계획은 tfx-deep-plan을 사용."
 triggers:

package/skills/tfx-plan/skill.json

@@ -7,5 +7,6 @@
     "플랜",
     "설계"
   ],
-  "argument_hint": "<구현할 기능 설명>"
+  "argument_hint": "<구현할 기능 설명>",
+  "internal": true
 }

package/skills/tfx-qa/SKILL.md

@@ -1,4 +1,5 @@
 ---
+internal: true
 name: tfx-qa
 description: "테스트 실행하고 실패하면 수정해서 통과시켜야 할 때 사용한다. 'qa', '검증해', '테스트 돌려', 'test-fix', '테스트 통과시켜' 같은 요청에 반드시 사용. 테스트 실패를 반복 수정하여 전부 통과시켜야 할 때 적극 활용."
 triggers:

package/skills/tfx-qa/skill.json

@@ -7,5 +7,6 @@
     "테스트 검증",
     "test-fix"
   ],
-  "argument_hint": "[테스트 명령 또는 파일 경로]"
+  "argument_hint": "[테스트 명령 또는 파일 경로]",
+  "internal": true
 }

package/skills/tfx-research/SKILL.md

@@ -1,4 +1,5 @@
 ---
+internal: true
 name: tfx-research
 description: "빠른 웹 검색과 요약이 필요할 때 사용한다. '검색해줘', '찾아봐', '최신 정보', '이거 뭐야', 'search', '공식 문서 확인' 같은 요청에 반드시 사용. 라이브러리 문서, API 레퍼런스, 에러 해결, 최신 뉴스, 팩트 체크 등 외부 정보가 필요한 모든 상황에 적극 활용한다."
 triggers:

package/skills/tfx-research/skill.json

@@ -9,5 +9,6 @@
     "search",
     "web search"
   ],
-  "argument_hint": "<검색 주제>"
+  "argument_hint": "<검색 주제>",
+  "internal": true
 }

package/skills/tfx-review/SKILL.md

@@ -1,4 +1,5 @@
 ---
+internal: true
 name: tfx-review
 description: "코드 리뷰가 필요할 때 사용한다. 'review', '리뷰해줘', '코드 봐줘', '이거 괜찮아?', 'PR 리뷰', '변경사항 확인' 같은 요청에 반드시 사용. git diff, 특정 파일, 또는 최근 변경에 대한 빠른 피드백이 필요할 때 적극 활용. 코드 변경사항 확인, '이거 문제 없어?', 'looks good?', 'LGTM?', '머지해도 될까' 같은 요청에도 적극 활용. 꼼꼼한 심층 리뷰는 tfx-deep-review를 사용."
 triggers:

package/skills/tfx-review/skill.json

@@ -7,5 +7,6 @@
     "코드 리뷰",
     "code review"
   ],
-  "argument_hint": "[파일 경로 또는 변경 설명]"
+  "argument_hint": "[파일 경로 또는 변경 설명]",
+  "internal": true
 }