triflux 10.43.0 → 10.44.0

package/README.md

@@ -264,6 +264,8 @@ state without replaying the entire conversation.
 
 ## Architecture
 
+> 상세 구조·패키지 레이아웃·실행 경로는 [ARCHITECTURE.md](ARCHITECTURE.md), 문서 전체 지도는 [docs/README.md](docs/README.md) 참조.
+
 <p align="center">
   <img src="docs/assets/architecture.svg" alt="triflux architecture" width="680">
 </p>

package/adapters/codex/skills/tfx-harness/SKILL.md

@@ -0,0 +1,30 @@
+---
+name: tfx-harness
+description: >
+  Use for meta-routing questions. Read the canonical routing SSOT and return
+  exactly one branch and immediate owner; do not execute the requested work.
+---
+
+# tfx-harness — Codex adapter
+
+Read `.claude/rules/tfx-routing.md` D0–D11 before routing. This adapter only
+translates host syntax: use `$skill` for an available owner. Do not copy the
+routing tree, keyword rules, or an owner matrix here.
+
+Return:
+
+```text
+[tfx-harness]
+branch: D<n>
+owner: <exactly one immediate owner>
+availability: available | unavailable | unknown
+fallback_notice: <optional>
+status: recommendation-only | dispatching | blocked
+```
+
+- Never choose more than one branch or immediate owner.
+- With unknown availability, do not infer a fallback. With measured
+  unavailability, state `owner unavailable → tfx-X fallback` before fallback.
+- If the SSOT cannot be read, return `blocked: routing SSOT unavailable`.
+- For a “which skill/path?” question, remain recommendation-only.
+- Do not select downstream implementation agents or models.

package/adapters/codex/skills/tfx-harness/skill.json

@@ -0,0 +1,5 @@
+{
+  "name": "tfx-harness",
+  "version": "1.0.0",
+  "host": "codex"
+}

package/bin/triflux.mjs

@@ -94,6 +94,7 @@ import {
   SKILL_ALIASES,
   SYNC_MAP,
   syncAliasedSkillDir,
+  syncCodexHarnessAdapter,
 } from "../scripts/setup.mjs";
 import { cleanupTmpFiles } from "../scripts/tmp-cleanup.mjs";
 
@@ -2203,6 +2204,19 @@ function cmdSetup(options = {}) {
     }
   }
 
+  const codexHarnessSync = syncCodexHarnessAdapter();
+  if (!codexHarnessSync.ok) {
+    fail(`Codex tfx-harness: ${codexHarnessSync.reason}`);
+    return;
+  }
+  if (codexHarnessSync.action === "synced") {
+    ok("Codex tfx-harness adapter: 동기화됨");
+  } else if (codexHarnessSync.action === "skipped") {
+    warn(
+      `Codex tfx-harness adapter: 사용자 스킬 보존 (backup: ${codexHarnessSync.backupDir})`,
+    );
+  }
+
   // ── psmux 기본 셸 자동 수정 (cmd.exe → PowerShell) ──
   if (process.platform === "win32" && which("psmux")) {
     try {

package/hooks/keyword-rules.json

@@ -96,6 +96,102 @@
       "state": null,
       "mcp_route": null
     },
+    {
+      "id": "tfx-review",
+      "patterns": [
+        {
+          "source": "\\btfx[\\s-]?review\\b",
+          "flags": "i"
+        }
+      ],
+      "skill": "tfx-review",
+      "priority": 1,
+      "supersedes": ["tfx-unified"],
+      "exclusive": false,
+      "state": null,
+      "mcp_route": null,
+      "explicit": true
+    },
+    {
+      "id": "tfx-analysis",
+      "patterns": [
+        {
+          "source": "\\btfx[\\s-]?analysis\\b",
+          "flags": "i"
+        }
+      ],
+      "skill": "tfx-analysis",
+      "priority": 1,
+      "supersedes": ["tfx-unified"],
+      "exclusive": false,
+      "state": null,
+      "mcp_route": null,
+      "explicit": true
+    },
+    {
+      "id": "tfx-plan",
+      "patterns": [
+        {
+          "source": "\\btfx[\\s-]?plan\\b",
+          "flags": "i"
+        }
+      ],
+      "skill": "tfx-plan",
+      "priority": 1,
+      "supersedes": ["tfx-unified"],
+      "exclusive": false,
+      "state": null,
+      "mcp_route": null,
+      "explicit": true
+    },
+    {
+      "id": "tfx-qa",
+      "patterns": [
+        {
+          "source": "\\btfx[\\s-]?qa\\b",
+          "flags": "i"
+        }
+      ],
+      "skill": "tfx-qa",
+      "priority": 1,
+      "supersedes": ["tfx-unified"],
+      "exclusive": false,
+      "state": null,
+      "mcp_route": null,
+      "explicit": true
+    },
+    {
+      "id": "tfx-research",
+      "patterns": [
+        {
+          "source": "\\btfx[\\s-]?research\\b",
+          "flags": "i"
+        }
+      ],
+      "skill": "tfx-research",
+      "priority": 1,
+      "supersedes": ["tfx-unified"],
+      "exclusive": false,
+      "state": null,
+      "mcp_route": null,
+      "explicit": true
+    },
+    {
+      "id": "tfx-find",
+      "patterns": [
+        {
+          "source": "\\btfx[\\s-]?find\\b",
+          "flags": "i"
+        }
+      ],
+      "skill": "tfx-find",
+      "priority": 1,
+      "supersedes": ["tfx-unified"],
+      "exclusive": false,
+      "state": null,
+      "mcp_route": null,
+      "explicit": true
+    },
     {
       "id": "tfx-unified",
       "patterns": [
@@ -127,10 +223,6 @@
           "source": "(?:찾아봐|조사해|검색해)",
           "flags": "i"
         },
-        {
-          "source": "(?:정리해|슬롭|클린업)",
-          "flags": "i"
-        },
         {
           "source": "(?:병렬|동시에|parallel|concurrent)",
           "flags": "i"
@@ -155,6 +247,41 @@
       "state": null,
       "mcp_route": null
     },
+    {
+      "id": "host-ai-slop-cleaner",
+      "patterns": [
+        {
+          "source": "(?:AI\\s*슬롭|ai\\s*slop|anti[\\s-]?slop|deslop)",
+          "flags": "i"
+        },
+        {
+          "source": "(?:슬롭|클린업)",
+          "flags": "i"
+        }
+      ],
+      "skill": "ai-slop-cleaner",
+      "priority": 1,
+      "supersedes": [],
+      "exclusive": false,
+      "state": null,
+      "mcp_route": null
+    },
+    {
+      "id": "tfx-prune",
+      "patterns": [
+        {
+          "source": "\\btfx[\\s-]?prune\\b",
+          "flags": "i"
+        }
+      ],
+      "skill": "tfx-prune",
+      "priority": 1,
+      "supersedes": ["tfx-unified"],
+      "exclusive": false,
+      "state": null,
+      "mcp_route": null,
+      "explicit": true
+    },
     {
       "id": "tfx-codex",
       "patterns": [
@@ -586,7 +713,6 @@
     },
     {
       "id": "gstack-ship",
-      "disabled": true,
       "patterns": [
         {
           "source": "(?:배포해|PR\\s*만들|릴리스\\s*해|머지하고\\s*배포)",
@@ -598,7 +724,7 @@
         }
       ],
       "skill": "ship",
-      "priority": 5,
+      "priority": 1,
       "supersedes": [],
       "exclusive": false,
       "state": null,
@@ -627,12 +753,12 @@
       "id": "gstack-cso",
       "patterns": [
         {
-          "source": "(?:보안\\s*(?:감사|점검|리뷰|스캔)|\\bcso\\b|\\bOWASP\\b|\\bSTRIDE\\b)",
+          "source": "(?:보안\\s*(?:감사|점검|리뷰|검토|스캔)|\\bcso\\b|\\bOWASP\\b|\\bSTRIDE\\b)",
           "flags": "i"
         }
       ],
       "skill": "cso",
-      "priority": 5,
+      "priority": 1,
       "supersedes": [],
       "exclusive": false,
       "state": null,
@@ -651,7 +777,7 @@
         }
       ],
       "skill": "qa",
-      "priority": 5,
+      "priority": 1,
       "supersedes": [],
       "exclusive": false,
       "state": null,
@@ -722,14 +848,6 @@
           "source": "/ship\\b",
           "flags": "i"
         },
-        {
-          "source": "\\brelease\\b",
-          "flags": "i"
-        },
-        {
-          "source": "\\bpublish\\b",
-          "flags": "i"
-        },
         {
           "source": "배포(?!자|사|장|처)",
           "flags": ""
@@ -744,11 +862,13 @@
         }
       ],
       "skill": "tfx-ship",
-      "priority": 3,
+      "priority": 1,
       "supersedes": ["gstack-ship"],
       "exclusive": false,
       "state": null,
-      "mcp_route": null
+      "mcp_route": null,
+      "repo_scope": ["triflux"],
+      "explicit": true
     }
   ]
 }

package/hub/cli-adapter-base.mjs

@@ -167,7 +167,7 @@ export const CODEX_MCP_EXECUTION_EXIT_CODE = 1;
  *
  * @param {string} prompt
  * @param {string|null} resultFile — null이면 --output-last-message 생략
- * @param {{ profile?: string, skipGitRepoCheck?: boolean, sandboxBypass?: boolean, cwd?: string, mcpServers?: string[], stdinPrompt?: boolean }} [opts]
+ * @param {{ profile?: string, codexHome?: string, disallowUltra?: boolean, enforceCanonicalProfile?: boolean, skipGitRepoCheck?: boolean, sandboxBypass?: boolean, cwd?: string, mcpServers?: string[], stdinPrompt?: boolean }} [opts]
  * @returns {string} 실행할 셸 커맨드
  */
 export function buildExecCommand(prompt, resultFile = null, opts = {}) {
@@ -177,6 +177,9 @@ export function buildExecCommand(prompt, resultFile = null, opts = {}) {
     sandboxBypass = true,
     mcpServers,
     stdinPrompt,
+    codexHome,
+    disallowUltra,
+    enforceCanonicalProfile,
   } = opts;
 
   const parts = ["codex"];
@@ -185,7 +188,13 @@ export function buildExecCommand(prompt, resultFile = null, opts = {}) {
   // still contains an inline [profiles.X] table (and codex re-injects such
   // tables when it rewrites config.toml), so the `-c model=.. -c
   // model_reasoning_effort=..` form is immune and mutates no config.
-  const profileOverrides = profile ? codexProfileConfigOverrides(profile) : [];
+  const profileOverrides = profile
+    ? codexProfileConfigOverrides(profile, {
+        codexHome,
+        disallowUltra,
+        enforceCanonicalProfile,
+      })
+    : [];
 
   if (FEATURES.execSubcommand) {
     parts.push("exec");

package/hub/codex-adapter.mjs

@@ -118,6 +118,9 @@ export function buildExecArgs(opts = {}) {
   const prompt = typeof opts.prompt === "string" ? opts.prompt : "";
   const command = buildExecCommand(prompt, opts.resultFile || null, {
     profile: opts.profile,
+    codexHome: opts.codexHome,
+    disallowUltra: opts.disallowUltra,
+    enforceCanonicalProfile: opts.enforceCanonicalProfile,
     skipGitRepoCheck: true,
     sandboxBypass: true,
     cwd: opts.cwd,

package/hub/intent.mjs

@@ -3,6 +3,7 @@
 
 import { execFileSync } from "node:child_process";
 import crypto from "node:crypto";
+import { resolveCodexAgentPolicy } from "../scripts/lib/agent-route-policy.mjs";
 import { whichCommand } from "./platform.mjs";
 
 /** 캐시 엔트리: { category, confidence, ts } */
@@ -61,31 +62,27 @@ function _tryCodexClassify(prompt) {
  * triflux 특화 의도 카테고리 (10개)
  */
 export const INTENT_CATEGORIES = {
-  // 모델 정책 (2026-04-25):
-  // - GPT-5.6 family = 기존 semantic tier를 Sol/Terra/Luna lane으로 매핑
-  // - gpt-5.4-mini = 자잘/부가/가성비 (fast tier 가능)
-  // - gpt-5.3-codex = escalation 가성비 중간 (fast 미지원)
-  // - 기존 effort는 유지하고 모델만 GPT-5.6 family로 교체
-  implement: {
-    agent: "executor",
-    mcp: "implement",
-    effort: "gpt56_terra_high",
-  },
-  debug: { agent: "debugger", mcp: "implement", effort: "gpt56_sol_xhigh" },
-  analyze: { agent: "analyst", mcp: "analyze", effort: "gpt56_sol_xhigh" },
-  design: { agent: "architect", mcp: "analyze", effort: "gpt56_sol_xhigh" },
-  review: { agent: "code-reviewer", mcp: "review", effort: "gpt56_terra_high" },
-  document: { agent: "writer", mcp: "docs", effort: "pro" },
-  research: { agent: "scientist", mcp: "analyze", effort: "gpt56_terra_high" },
-  "quick-fix": {
-    agent: "build-fixer",
-    mcp: "implement",
-    effort: "gpt56_luna_low",
-  },
-  explain: { agent: "writer", mcp: "docs", effort: "flash" },
-  test: { agent: "test-engineer", mcp: null, effort: null },
+  implement: { agent: "executor", mcp: "implement" },
+  debug: { agent: "debugger", mcp: "implement" },
+  analyze: { agent: "analyst", mcp: "analyze" },
+  design: { agent: "architect", mcp: "analyze" },
+  review: { agent: "code-reviewer", mcp: "review" },
+  document: { agent: "writer", mcp: "docs" },
+  research: { agent: "scientist", mcp: "analyze" },
+  "quick-fix": { agent: "build-fixer", mcp: "implement" },
+  explain: { agent: "writer", mcp: "docs" },
+  test: { agent: "test-engineer", mcp: null },
 };
 
+function routingFor(category) {
+  const route = INTENT_CATEGORIES[category] || INTENT_CATEGORIES.implement;
+  return {
+    agent: route.agent,
+    mcp: route.mcp,
+    effort: resolveCodexAgentPolicy(route.agent).profile,
+  };
+}
+
 /** @internal 키워드 → 카테고리 매핑 패턴 */
 const KEYWORD_PATTERNS = [
   {
@@ -267,17 +264,12 @@ export function classifyIntent(prompt) {
   // 캐시 확인
   const cached = _getCached(hash);
   if (cached) {
-    const routing =
-      INTENT_CATEGORIES[cached.category] || INTENT_CATEGORIES.implement;
+    const routing = routingFor(cached.category);
     return {
       category: cached.category,
       confidence: cached.confidence,
       reasoning: `cache-hit: ${cached.category} (${cached.confidence.toFixed(2)})`,
-      routing: {
-        agent: routing.agent,
-        mcp: routing.mcp,
-        effort: routing.effort,
-      },
+      routing,
     };
   }
 
@@ -308,12 +300,12 @@ export function classifyIntent(prompt) {
   // 캐시 저장
   _intentCache.set(hash, { category, confidence, ts: Date.now() });
 
-  const routing = INTENT_CATEGORIES[category] || INTENT_CATEGORIES.implement;
+  const routing = routingFor(category);
   return {
     category,
     confidence,
     reasoning,
-    routing: { agent: routing.agent, mcp: routing.mcp, effort: routing.effort },
+    routing,
   };
 }