@triflux/core 10.48.1 → 10.49.0

package/hooks/hook-orchestrator.mjs

@@ -469,7 +469,7 @@ async function main() {
   // UserPromptSubmit 은 턴 *시작* 에, Stop 은 매 어시스턴트 턴 *종료* 에 heartbeat
   // 한다. 둘이 함께 "대화 중이지만 매 분 새 프롬프트를 보내지는 않는" 세션을 5분
   // interactive TTL 위로 유지해, 대화 도중 stale 로 떨어져 `cto status`
-  // live_sessions / tray 에서 사라지는 것을 막는다. 진짜 완전 idle(턴 자체가 없음)
+  // live_sessions 에서 사라지는 것을 막는다. 진짜 완전 idle(턴 자체가 없음)
   // 은 여전히 TTL 후 stale 로 가며 — 그게 의도된 dead-session 신호다. UserPromptSubmit
   // 과 동일하게 fire-and-forget POST 직후 짧은 상한으로 drain 한다.
   if (eventName === "Stop") {

package/hooks/keyword-rules.json

@@ -20,8 +20,14 @@
       "id": "tfx-multi",
       "patterns": [
         {
-          "source": "(?<!\\b(?:my|the|our|omc|oh-my-claudecode)\\s)\\btfx[\\s-]?multi\\b",
-          "flags": "i"
+          "source": "(?<![\\w/.-])/tfx[\\s-]?multi\\b",
+          "flags": "i",
+          "strength": "explicit"
+        },
+        {
+          "source": "\\btfx[\\s-]?multi\\s*(?:로|으로)\\s*(?:해|돌려|처리|진행|시켜|보내|라우팅)",
+          "flags": "i",
+          "strength": "explicit"
         }
       ],
       "skill": "tfx-auto",
@@ -66,8 +72,14 @@
       "id": "tfx-harness",
       "patterns": [
         {
-          "source": "\\btfx[\\s-]?harness\\b",
-          "flags": "i"
+          "source": "(?<![\\w/.-])/tfx[\\s-]?harness\\b",
+          "flags": "i",
+          "strength": "explicit"
+        },
+        {
+          "source": "\\btfx[\\s-]?harness\\s*(?:로|으로)\\s*(?:해|돌려|처리|진행|시켜|보내|라우팅)",
+          "flags": "i",
+          "strength": "explicit"
         }
       ],
       "skill": "tfx-harness",
@@ -87,6 +99,10 @@
         {
           "source": "\\bwhich\\s+skill\\b",
           "flags": "i"
+        },
+        {
+          "source": "(?:뭐|어떤|무슨)\\s*스킬|스킬\\s*(?:있나|있어|없나|도움)",
+          "flags": "i"
         }
       ],
       "skill": "tfx-harness",
@@ -94,7 +110,9 @@
       "supersedes": ["tfx-unified"],
       "exclusive": false,
       "state": null,
-      "mcp_route": null
+      "mcp_route": null,
+      "strength": "suggest",
+      "suggest_when": "어떤 스킬·경로를 쓸지 묻는 메타 라우팅 요청"
     },
     {
       "id": "tfx-review",
@@ -112,22 +130,6 @@
       "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": [
@@ -152,7 +154,7 @@
           "flags": "i"
         }
       ],
-      "skill": "tfx-qa",
+      "skill": "tfx-review",
       "priority": 1,
       "supersedes": ["tfx-unified"],
       "exclusive": false,
@@ -176,67 +178,35 @@
       "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": [
         {
-          "source": "\\btfx[\\s-]?auto\\b",
-          "flags": "i"
-        },
-        {
-          "source": "\\btfx[\\s-]?auto[\\s-]?codex\\b",
-          "flags": "i"
-        },
-        {
-          "source": "(?:만들어|고쳐|구현해|짜줘|수정해|바꿔)",
-          "flags": "i"
+          "source": "(?<![\\w/.-])/tfx[\\s-]?auto(?:[\\s-]?codex)?\\b",
+          "flags": "i",
+          "strength": "explicit"
         },
         {
-          "source": "(?:리뷰해|검토해|봐줘|괜찮아)",
-          "flags": "i"
+          "source": "\\btfx[\\s-]?auto(?:[\\s-]?codex)?\\s*(?:로|으로)\\s*(?:해|돌려|처리|진행|시켜|보내|라우팅)",
+          "flags": "i",
+          "strength": "explicit"
         },
         {
-          "source": "(?:테스트|검증|돌려봐|QA)",
+          "source": "(?:코드|프론트|화면|버튼|위젯|셸|\\.sh|경로|콜백|생성기|함수|메서드|파일|모듈|클래스|기능|버그|결함|스크립트|훅|스킬|API|엔드포인트|컴포넌트|로직|알고리즘|테스트\\s*코드|빌드|에러|오류|UI|스키마|CLI|패턴|정규식|설정)[^.?!\\n]{0,15}?(?:구현|만들어|고쳐|수정해|짜\\s*줘|작성해|추가해|리팩터|개선해|패치해|지워|넣어|바꿔)",
           "flags": "i"
         },
         {
-          "source": "(?:분석해|계획|설계해)",
-          "flags": "i"
-        },
-        {
-          "source": "(?:찾아봐|조사해|검색해)",
-          "flags": "i"
-        },
-        {
-          "source": "(?:병렬|동시에|parallel|concurrent)",
-          "flags": "i"
-        },
-        {
-          "source": "(?:점검|진단|확인해)",
-          "flags": "i"
+          "source": "구현\\s*(?:해|하자|할\\s*거|해\\s*줘)",
+          "flags": ""
         },
         {
-          "source": "(?:계속해|이어서|진행해)",
+          "source": "\\b(?:implement|refactor)\\b|\\bfix\\s+(?:the\\s+|this\\s+|a\\s+)?(?:bug|test|build|error|issue|code)\\b",
           "flags": "i"
-        },
+        }
+      ],
+      "exclude_patterns": [
         {
-          "source": "\\b(?:implement|build|fix|review|test|plan|analyze)\\b",
+          "source": "(?:[?？]|(?:있나|없나|되나|될까|할까|인가|일까|하나|어때|맞아|맞나|건가|거야|던데|을걸|을껄))\\s*[?？]?\\s*$",
           "flags": "i"
         }
       ],
@@ -245,18 +215,21 @@
       "supersedes": ["tfx-auto-codex"],
       "exclusive": false,
       "state": null,
-      "mcp_route": null
+      "mcp_route": null,
+      "strength": "suggest",
+      "suggest_when": "코드 구현·수정 실행 요청"
     },
     {
       "id": "host-ai-slop-cleaner",
       "patterns": [
         {
-          "source": "(?:AI\\s*슬롭|ai\\s*slop|anti[\\s-]?slop|deslop)",
+          "source": "(?:AI\\s*슬롭|ai\\s*slop)",
           "flags": "i"
         },
         {
-          "source": "(?:슬롭|클린업)",
-          "flags": "i"
+          "source": "\\b(?:anti[\\s-]?slop|deslop)\\b",
+          "flags": "i",
+          "strength": "explicit"
         }
       ],
       "skill": "ai-slop-cleaner",
@@ -264,23 +237,9 @@
       "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
+      "strength": "suggest",
+      "suggest_when": "AI 슬롭 정리(deslop) 실행 요청"
     },
     {
       "id": "tfx-codex",
@@ -312,26 +271,11 @@
       "state": null,
       "mcp_route": null
     },
-    {
-      "id": "tfx-hub",
-      "patterns": [
-        {
-          "source": "\\btfx[\\s-]?hub\\b",
-          "flags": "i"
-        }
-      ],
-      "skill": "tfx-hub",
-      "priority": 1,
-      "supersedes": [],
-      "exclusive": false,
-      "state": null,
-      "mcp_route": null
-    },
     {
       "id": "tfx-doctor",
       "patterns": [
         {
-          "source": "\\btfx[\\s-]?doctor\\b",
+          "source": "\\btfx[\\s-]?(?:doctor|hub)\\b",
           "flags": "i"
         }
       ],
@@ -412,12 +356,14 @@
         }
       ],
       "skill": "tfx-wt",
-      "platform": ["win32"],
       "priority": 1,
       "supersedes": ["tfx-unified"],
       "exclusive": false,
       "state": null,
-      "mcp_route": null
+      "mcp_route": null,
+      "platform": ["win32"],
+      "strength": "suggest",
+      "suggest_when": "Windows Terminal 탭·패인 조작 요청"
     },
     {
       "id": "wt-tab-rename",
@@ -432,12 +378,14 @@
         }
       ],
       "skill": "tfx-wt",
-      "platform": ["win32"],
       "priority": 1,
       "supersedes": ["tfx-unified"],
       "exclusive": false,
       "state": null,
-      "mcp_route": null
+      "mcp_route": null,
+      "platform": ["win32"],
+      "strength": "suggest",
+      "suggest_when": "Windows Terminal 탭·패인 조작 요청"
     },
     {
       "id": "wt-tab-list",
@@ -452,12 +400,14 @@
         }
       ],
       "skill": "tfx-wt",
-      "platform": ["win32"],
       "priority": 1,
       "supersedes": ["tfx-unified"],
       "exclusive": false,
       "state": null,
-      "mcp_route": null
+      "mcp_route": null,
+      "platform": ["win32"],
+      "strength": "suggest",
+      "suggest_when": "Windows Terminal 탭·패인 조작 요청"
     },
     {
       "id": "wt-tab-close",
@@ -472,229 +422,35 @@
         }
       ],
       "skill": "tfx-wt",
-      "platform": ["win32"],
       "priority": 1,
       "supersedes": ["tfx-unified"],
       "exclusive": false,
       "state": null,
-      "mcp_route": null
-    },
-    {
-      "id": "handoff-route",
-      "patterns": [
-        {
-          "source": "(?:^|(?<=\\s))(핸드오프|handoff|세션\\s*넘기)[\\s]*(생성|만들|써줘|작성|넘겨)",
-          "flags": "i"
-        }
-      ],
-      "skill": null,
-      "action": "handoff",
-      "priority": 5,
-      "supersedes": [],
-      "exclusive": false,
-      "state": null,
-      "mcp_route": null
-    },
-    {
-      "id": "notion-route",
-      "patterns": [
-        {
-          "source": "(?:^|(?<=\\s))(노션|notion)[\\s-]?(페이지|글|조회|생성|수정|검색)(?:$|(?=\\s))",
-          "flags": "i"
-        },
-        {
-          "source": "(노션|\\bnotion\\b)",
-          "flags": "i"
-        }
-      ],
-      "skill": null,
-      "priority": 10,
-      "supersedes": [],
-      "exclusive": false,
-      "state": null,
-      "mcp_route": "antigravity"
-    },
-    {
-      "id": "chrome-route",
-      "patterns": [
-        {
-          "source": "(?:^|(?<=\\s))(크롬|chrome|브라우저)[\\s-]?(열|접속|로그인|navigate|click)(?:$|(?=\\s))",
-          "flags": "i"
-        },
-        {
-          "source": "(크롬|\\bchrome\\b)",
-          "flags": "i"
-        }
-      ],
-      "skill": null,
-      "priority": 10,
-      "supersedes": [],
-      "exclusive": false,
-      "state": null,
-      "mcp_route": "antigravity"
-    },
-    {
-      "id": "jira-route",
-      "patterns": [
-        {
-          "source": "(?:^|(?<=\\s))(jira|지라)[\\s-]?(이슈|티켓|생성|조회|스프린트)(?:$|(?=\\s))",
-          "flags": "i"
-        },
-        {
-          "source": "(지라|\\bjira\\b)",
-          "flags": "i"
-        }
-      ],
-      "skill": null,
-      "priority": 10,
-      "supersedes": [],
-      "exclusive": false,
-      "state": null,
-      "mcp_route": "codex"
-    },
-    {
-      "id": "mail-route",
-      "patterns": [
-        {
-          "source": "(?:^|(?<=\\s))(메일|gmail|이메일)[\\s-]?(보내|읽|검색|draft)(?:$|(?=\\s))",
-          "flags": "i"
-        },
-        {
-          "source": "(메일|이메일|\\bgmail\\b)",
-          "flags": "i"
-        }
-      ],
-      "skill": null,
-      "priority": 10,
-      "supersedes": [],
-      "exclusive": false,
-      "state": null,
-      "mcp_route": "antigravity"
-    },
-    {
-      "id": "calendar-route",
-      "patterns": [
-        {
-          "source": "(?:^|(?<=\\s))(일정|캘린더|calendar)[\\s-]?(생성|조회|추가)(?:$|(?=\\s))",
-          "flags": "i"
-        },
-        {
-          "source": "(일정|캘린더|\\bcalendar\\b)",
-          "flags": "i"
-        }
-      ],
-      "skill": null,
-      "priority": 10,
-      "supersedes": [],
-      "exclusive": false,
-      "state": null,
-      "mcp_route": "antigravity"
-    },
-    {
-      "id": "playwright-route",
-      "patterns": [
-        {
-          "source": "(?:^|(?<=\\s))(playwright|브라우저\\s*테스트)(?:$|(?=\\s))",
-          "flags": "i"
-        }
-      ],
-      "skill": null,
-      "priority": 10,
-      "supersedes": [],
-      "exclusive": false,
-      "state": null,
-      "mcp_route": "antigravity"
-    },
-    {
-      "id": "canva-route",
-      "patterns": [
-        {
-          "source": "(?:^|(?<=\\s))(canva|캔바|디자인\\s*생성)(?:$|(?=\\s))",
-          "flags": "i"
-        }
-      ],
-      "skill": null,
-      "priority": 10,
-      "supersedes": [],
-      "exclusive": false,
-      "state": null,
-      "mcp_route": "antigravity"
-    },
-    {
-      "id": "confluence-route",
-      "patterns": [
-        {
-          "source": "(?:^|(?<=\\s))(confluence|위키|wiki)[\\s-]?(페이지|문서|조회|생성|수정|검색)(?:$|(?=\\s))",
-          "flags": "i"
-        },
-        {
-          "source": "(위키|\\bconfluence\\b|\\bwiki\\b)",
-          "flags": "i"
-        }
-      ],
-      "skill": null,
-      "priority": 10,
-      "supersedes": [],
-      "exclusive": false,
-      "state": null,
-      "mcp_route": "antigravity"
-    },
-    {
-      "id": "slack-route",
-      "patterns": [
-        {
-          "source": "(?:^|(?<=\\s))(slack|슬랙)[\\s-]?(메시지|채널|보내|읽|검색|알림)(?:$|(?=\\s))",
-          "flags": "i"
-        },
-        {
-          "source": "(슬랙|\\bslack\\b)",
-          "flags": "i"
-        }
-      ],
-      "skill": null,
-      "priority": 10,
-      "supersedes": [],
-      "exclusive": false,
-      "state": null,
-      "mcp_route": "antigravity"
-    },
-    {
-      "id": "github-route",
-      "patterns": [
-        {
-          "source": "(?:^|(?<=\\s))(github|깃허브)[\\s-]?(이슈|issue|PR|pull|커밋|commit|리포|repo)(?:$|(?=\\s))",
-          "flags": "i"
-        },
-        {
-          "source": "(깃허브|\\bgithub\\b)",
-          "flags": "i"
-        }
-      ],
-      "skill": null,
-      "priority": 10,
-      "supersedes": [],
-      "exclusive": false,
-      "state": null,
-      "mcp_route": "codex"
+      "mcp_route": null,
+      "platform": ["win32"],
+      "strength": "suggest",
+      "suggest_when": "Windows Terminal 탭·패인 조작 요청"
     },
     {
       "id": "gstack-checkpoint",
       "patterns": [
         {
-          "source": "(?:어디까지\\s*했|뭐\\s*하고\\s*있었|뭘\\s*해야\\s*하|까먹|기억이\\s*안|이어서\\s*하|중단\\s*지점)",
+          "source": "(?:어디까지\\s*했|뭐\\s*하고\\s*있었|중단\\s*지점)",
           "flags": "i"
         },
         {
-          "source": "\\b(?:resume|pick\\s*up|where\\s*was\\s*I)\\b",
+          "source": "\\bwhere\\s*was\\s*I\\b",
           "flags": "i"
         }
       ],
-      "skill": "gstack-context-restore",
+      "skill_candidates": ["context-restore", "gstack-context-restore"],
       "priority": 5,
       "supersedes": [],
       "exclusive": false,
       "state": null,
-      "mcp_route": null
+      "mcp_route": null,
+      "strength": "suggest",
+      "suggest_when": "이전 세션의 작업 맥락을 복원하려는 요청"
     },
     {
       "id": "gstack-office-hours",
@@ -705,34 +461,45 @@
         },
         {
           "source": "\\boffice[\\s-]?hours\\b",
-          "flags": "i"
+          "flags": "i",
+          "strength": "explicit"
         }
       ],
-      "skill": "office-hours",
+      "skill_candidates": ["office-hours", "gstack-office-hours"],
       "priority": 5,
       "supersedes": [],
       "exclusive": false,
       "state": null,
-      "mcp_route": null
+      "mcp_route": null,
+      "strength": "suggest",
+      "suggest_when": "새 제품·아이디어의 문제 정의를 시작하려는 요청"
     },
     {
       "id": "gstack-ship",
       "patterns": [
         {
-          "source": "(?:배포해|PR\\s*만들|릴리스\\s*해|머지하고\\s*배포)",
+          "source": "PR\\s*(?:만들|올려|생성|열어)|머지하고\\s*배포|릴리스\\s*해",
           "flags": "i"
         },
         {
-          "source": "(?<![\\w-])ship\\b(?!.*tfx)",
+          "source": "(?<![\\w/-])ship\\s+(?:it|this)\\b",
           "flags": "i"
         }
       ],
-      "skill": "ship",
+      "exclude_patterns": [
+        {
+          "source": "(?:[?？]|(?:있나|없나|되나|될까|할까|인가|일까|하나|어때|맞아|맞나|건가|거야|던데|을걸|을껄))\\s*[?？]?\\s*$",
+          "flags": "i"
+        }
+      ],
+      "skill_candidates": ["ship", "gstack-ship"],
       "priority": 1,
       "supersedes": [],
       "exclusive": false,
       "state": null,
-      "mcp_route": null
+      "mcp_route": null,
+      "strength": "suggest",
+      "suggest_when": "일반 저장소의 PR·배포 실행 요청"
     },
     {
       "id": "gstack-investigate",
@@ -746,27 +513,36 @@
           "flags": "i"
         }
       ],
-      "skill": "investigate",
+      "skill_candidates": ["investigate", "gstack-investigate"],
       "priority": 5,
       "supersedes": [],
       "exclusive": false,
       "state": null,
-      "mcp_route": null
+      "mcp_route": null,
+      "strength": "suggest",
+      "suggest_when": "버그·장애의 원인을 조사하려는 요청"
     },
     {
       "id": "gstack-cso",
       "patterns": [
         {
-          "source": "(?:보안\\s*(?:감사|점검|리뷰|검토|스캔)|\\bcso\\b|\\bOWASP\\b|\\bSTRIDE\\b)",
+          "source": "(?:보안\\s*(?:감사|점검|리뷰|검토|스캔)|\\bOWASP\\b|\\bSTRIDE\\b)",
           "flags": "i"
+        },
+        {
+          "source": "\\bcso\\b",
+          "flags": "i",
+          "strength": "explicit"
         }
       ],
-      "skill": "cso",
+      "skill_candidates": ["cso", "gstack-cso"],
       "priority": 1,
       "supersedes": [],
       "exclusive": false,
       "state": null,
-      "mcp_route": null
+      "mcp_route": null,
+      "strength": "suggest",
+      "suggest_when": "보안 감사·점검 실행 요청"
     },
     {
       "id": "gstack-qa-browser",
@@ -780,31 +556,42 @@
           "flags": "i"
         }
       ],
-      "skill": "qa",
+      "skill_candidates": ["qa", "gstack-qa"],
       "priority": 1,
       "supersedes": [],
       "exclusive": false,
       "state": null,
-      "mcp_route": null
+      "mcp_route": null,
+      "strength": "suggest",
+      "suggest_when": "사이트·브라우저 흐름을 실제로 테스트하려는 요청"
     },
     {
       "id": "gstack-retro",
       "patterns": [
         {
-          "source": "(?:회고|이번\\s*주\\s*뭐\\s*했|주간\\s*리뷰|뭘\\s*했지)",
+          "source": "(?:주간|이번\\s*주|지난\\s*주|스프린트)\\s*(?:회고|리뷰)|이번\\s*주\\s*뭐\\s*했",
           "flags": "i"
         },
         {
-          "source": "\\bretro\\b",
-          "flags": "i"
+          "source": "(?<![\\w/-])retro\\b",
+          "flags": "i",
+          "strength": "explicit"
         }
       ],
-      "skill": "retro",
+      "exclude_patterns": [
+        {
+          "source": "회고\\s*(?:문서|록|템플릿)|회의|전사",
+          "flags": ""
+        }
+      ],
+      "skill_candidates": ["retro", "gstack-retro"],
       "priority": 5,
       "supersedes": [],
       "exclusive": false,
       "state": null,
-      "mcp_route": null
+      "mcp_route": null,
+      "strength": "suggest",
+      "suggest_when": "작업 회고를 하려는 요청"
     },
     {
       "id": "gstack-autoplan",
@@ -815,21 +602,30 @@
         },
         {
           "source": "\\bautoplan\\b",
-          "flags": "i"
+          "flags": "i",
+          "strength": "explicit"
         }
       ],
-      "skill": "autoplan",
+      "skill_candidates": ["autoplan", "gstack-autoplan"],
       "priority": 5,
       "supersedes": [],
       "exclusive": false,
       "state": null,
-      "mcp_route": null
+      "mcp_route": null,
+      "strength": "suggest",
+      "suggest_when": "계획 전체 리뷰 파이프라인 실행 요청"
     },
     {
       "id": "suppress-omc-team",
       "patterns": [
         {
-          "source": "(?<!tfx[\\s-]?)(팀|\\bteam\\b)",
+          "source": "(?<!tfx[\\s-]?)\\bteam\\b|팀\\s*(?:모드|으로|구성)",
+          "flags": "i"
+        }
+      ],
+      "exclude_patterns": [
+        {
+          "source": "(?<![\\w.-])/team\\b|레드\\s*팀|개발\\s*팀|팀\\s*저장소",
           "flags": "i"
         }
       ],
@@ -839,25 +635,19 @@
       "supersedes": [],
       "exclusive": false,
       "state": null,
-      "mcp_route": null
+      "mcp_route": null,
+      "strength": "suggest"
     },
     {
       "id": "tfx-ship",
       "patterns": [
         {
           "source": "\\btfx[\\s-]?ship\\b",
-          "flags": "i"
-        },
-        {
-          "source": "/ship\\b",
-          "flags": "i"
+          "flags": "i",
+          "strength": "explicit"
         },
         {
-          "source": "배포(?!자|사|장|처)",
-          "flags": ""
-        },
-        {
-          "source": "릴리[즈스]",
+          "source": "(?:배포|릴리[즈스])\\s*(?:해|하고|하자|진행|가자|시작)",
           "flags": ""
         },
         {
@@ -865,6 +655,12 @@
           "flags": ""
         }
       ],
+      "exclude_patterns": [
+        {
+          "source": "(?:[?？]|(?:있나|없나|되나|될까|할까|인가|일까|하나|어때|맞아|맞나|건가|거야|던데|을걸|을껄))\\s*[?？]?\\s*$",
+          "flags": "i"
+        }
+      ],
       "skill": "tfx-ship",
       "priority": 1,
       "supersedes": ["gstack-ship"],
@@ -872,7 +668,9 @@
       "state": null,
       "mcp_route": null,
       "repo_scope": ["triflux"],
-      "explicit": true
+      "explicit": true,
+      "strength": "suggest",
+      "suggest_when": "triflux 릴리즈·배포 실행 요청"
     }
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@triflux/core",
-  "version": "10.48.1",
+  "version": "10.49.0",
   "description": "triflux core — CLI routing, pipeline, adapters. Zero native dependencies.",
   "type": "module",
   "main": "hub/index.mjs",
@@ -11,7 +11,7 @@
     "./scripts/*": "./scripts/*"
   },
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=20"
   },
   "dependencies": {
     "@iarna/toml": "^2.2.5",

package/scripts/lib/keyword-rules.mjs

@@ -2,6 +2,11 @@ import { readFileSync } from "node:fs";
 
 const VALID_MCP_ROUTES = new Set(["codex", "antigravity", "gemini", "claude"]);
 
+// 주입 강도. explicit = 스킬명 직접 언급(명시 토큰) → MUST 호출 문구,
+// suggest = 자연어 매칭 → "실행 요청이면 고려하라" 수준의 제안 문구 (ADR-0021).
+const VALID_STRENGTHS = new Set(["explicit", "suggest"]);
+const DEFAULT_STRENGTH = "explicit";
+
 function logRuleError(message, error) {
   if (error) {
     console.error(`[triflux-keyword-rules] ${message}: ${error.message}`);
@@ -13,7 +18,11 @@ function logRuleError(message, error) {
 function normalizePattern(pattern) {
   if (!pattern || typeof pattern.source !== "string") return null;
   if (typeof pattern.flags !== "string") return null;
-  return { source: pattern.source, flags: pattern.flags };
+  if (pattern.strength != null && !VALID_STRENGTHS.has(pattern.strength))
+    return null;
+  const normalized = { source: pattern.source, flags: pattern.flags };
+  if (pattern.strength != null) normalized.strength = pattern.strength;
+  return normalized;
 }
 
 function normalizeState(state) {
@@ -32,13 +41,43 @@ function normalizeRule(rule) {
   if (typeof rule.priority !== "number" || !Number.isFinite(rule.priority))
     return null;
 
-  const patterns = rule.patterns.map(normalizePattern).filter(Boolean);
+  // strength: 규칙 기본 주입 강도. 패턴별 strength 가 있으면 그 패턴만 덮어쓴다.
+  // 값이 틀리면 규칙 자체를 무효로 본다 (platform 과 같은 규칙).
+  if (rule.strength != null && !VALID_STRENGTHS.has(rule.strength)) return null;
+  const strength = rule.strength ?? DEFAULT_STRENGTH;
+
+  const patterns = rule.patterns
+    .map(normalizePattern)
+    .filter(Boolean)
+    .map((p) => ({ ...p, strength: p.strength ?? strength }));
   if (patterns.length === 0) return null;
 
+  // exclude_patterns: 하나라도 맞으면 그 규칙의 suggest 매칭을 버린다.
+  // 명시 토큰(explicit) 매칭은 사용자가 스킬을 직접 부른 것이라 제외하지 않는다.
+  if (rule.exclude_patterns != null && !Array.isArray(rule.exclude_patterns))
+    return null;
+  const excludePatterns = Array.isArray(rule.exclude_patterns)
+    ? rule.exclude_patterns
+        .map(normalizePattern)
+        .filter(Boolean)
+        .map(({ source, flags }) => ({ source, flags }))
+    : [];
+
+  // skill_candidates: 머신마다 설치 이름이 다른 외부 스킬(gstack 의 `ship` /
+  // `gstack-ship`)의 후보 목록. detector 가 실행 시점에 설치된 첫 이름을 고른다.
+  // skill 이 없으면 첫 후보를 대표 이름으로 둔다.
+  if (rule.skill_candidates != null && !Array.isArray(rule.skill_candidates))
+    return null;
+  const skillCandidates = Array.isArray(rule.skill_candidates)
+    ? rule.skill_candidates
+        .filter((name) => typeof name === "string" && name.trim())
+        .map((name) => name.trim())
+    : [];
+
   const skill =
     typeof rule.skill === "string" && rule.skill.trim()
       ? rule.skill.trim()
-      : null;
+      : (skillCandidates[0] ?? null);
   const action =
     typeof rule.action === "string" && rule.action.trim()
       ? rule.action.trim()
@@ -53,6 +92,12 @@ function normalizeRule(rule) {
   const hint =
     typeof rule.hint === "string" && rule.hint.trim() ? rule.hint.trim() : null;
 
+  // suggest_when: suggest 주입문에서 "…이면 <skill> 을 고려하라"의 조건 문구.
+  const suggestWhen =
+    typeof rule.suggest_when === "string" && rule.suggest_when.trim()
+      ? rule.suggest_when.trim()
+      : null;
+
   const supersedes = Array.isArray(rule.supersedes)
     ? rule.supersedes
         .filter((id) => typeof id === "string" && id.trim())
@@ -82,7 +127,11 @@ function normalizeRule(rule) {
   return {
     id: rule.id.trim(),
     patterns,
+    exclude_patterns: excludePatterns,
+    strength,
+    suggest_when: suggestWhen,
     skill,
+    skill_candidates: skillCandidates,
     action,
     hint,
     priority: rule.priority,
@@ -124,6 +173,9 @@ export function compileRules(rules) {
           compiledPatterns: rule.patterns.map(
             (p) => new RegExp(p.source, p.flags),
           ),
+          compiledExcludes: (rule.exclude_patterns || []).map(
+            (p) => new RegExp(p.source, p.flags),
+          ),
         };
       } catch (error) {
         logRuleError(`정규식 컴파일 실패: ${rule.id}`, error);
@@ -153,12 +205,27 @@ export function matchRules(compiledRules, cleanText) {
       continue;
     }
 
-    const matched = rule.compiledPatterns.some((pattern) => {
+    // compiledPatterns[i] 와 patterns[i] 는 같은 순서다 — 패턴별 strength 를 읽는다.
+    const ruleStrength = rule.strength ?? DEFAULT_STRENGTH;
+    let explicitHit = false;
+    let suggestHit = false;
+    rule.compiledPatterns.forEach((pattern, index) => {
       pattern.lastIndex = 0;
-      return pattern.test(cleanText);
+      if (!pattern.test(cleanText)) return;
+      const strength = rule.patterns?.[index]?.strength ?? ruleStrength;
+      if (strength === "suggest") suggestHit = true;
+      else explicitHit = true;
     });
 
-    if (!matched) continue;
+    if (!explicitHit && !suggestHit) continue;
+
+    if (!explicitHit) {
+      const excluded = (rule.compiledExcludes || []).some((pattern) => {
+        pattern.lastIndex = 0;
+        return pattern.test(cleanText);
+      });
+      if (excluded) continue;
+    }
 
     matches.push({
       id: rule.id,
@@ -173,6 +240,9 @@ export function matchRules(compiledRules, cleanText) {
       repo_scope: rule.repo_scope || [],
       platform: rule.platform || [],
       explicit: rule.explicit === true,
+      strength: explicitHit ? "explicit" : "suggest",
+      suggest_when: rule.suggest_when || null,
+      skill_candidates: rule.skill_candidates || [],
     });
   }
 
@@ -197,13 +267,20 @@ export function resolveConflicts(matches) {
       seen.add(match.id);
     }
 
+    // strength 우선순위를 충돌 해소에도 적용한다 — suggest 매칭의 supersedes 는
+    // 사용자가 직접 부른 explicit 매칭을 지우지 못한다.
+    const strengthById = new Map(
+      deduped.map((match) => [match.id, match.strength ?? DEFAULT_STRENGTH]),
+    );
     const superseded = new Set();
     const resolved = [];
 
     for (const match of deduped) {
       if (superseded.has(match.id)) continue;
       resolved.push(match);
+      const fromSuggest = (match.strength ?? DEFAULT_STRENGTH) === "suggest";
       for (const targetId of match.supersedes || []) {
+        if (fromSuggest && strengthById.get(targetId) === "explicit") continue;
         superseded.add(targetId);
       }
     }