triflux 10.3.4 → 10.7.0

package/scripts/lib/mcp-server-catalog.mjs

@@ -1,79 +1,312 @@
-export const SEARCH_SERVER_ORDER = Object.freeze(['brave-search', 'tavily', 'exa']);
+export const SEARCH_SERVER_ORDER = Object.freeze([
+  "brave-search",
+  "tavily",
+  "exa",
+]);
 
 export const MCP_SERVER_TOOL_CATALOG = Object.freeze({
-  context7: Object.freeze(['resolve-library-id', 'query-docs']),
-  'brave-search': Object.freeze(['brave_web_search', 'brave_news_search']),
-  exa: Object.freeze(['web_search_exa', 'get_code_context_exa']),
-  tavily: Object.freeze(['tavily_search', 'tavily_extract']),
+  context7: Object.freeze(["resolve-library-id", "query-docs"]),
+  "brave-search": Object.freeze(["brave_web_search", "brave_news_search"]),
+  exa: Object.freeze(["web_search_exa", "get_code_context_exa"]),
+  tavily: Object.freeze(["tavily_search", "tavily_extract"]),
   playwright: Object.freeze([
-    'browser_navigate',
-    'browser_navigate_back',
-    'browser_snapshot',
-    'browser_take_screenshot',
-    'browser_wait_for',
+    "browser_navigate",
+    "browser_navigate_back",
+    "browser_snapshot",
+    "browser_take_screenshot",
+    "browser_wait_for",
   ]),
-  'sequential-thinking': Object.freeze(['sequentialthinking']),
+  "sequential-thinking": Object.freeze(["sequentialthinking"]),
 });
 
 export const MCP_SERVER_DOMAIN_TAGS = Object.freeze({
-  context7: Object.freeze(['docs', 'reference', 'api', 'sdk', 'library']),
-  'brave-search': Object.freeze(['web', 'search', 'news', 'current']),
-  exa: Object.freeze(['code', 'repository', 'examples', 'search']),
-  tavily: Object.freeze(['research', 'search', 'news', 'verification', 'current']),
-  playwright: Object.freeze(['browser', 'ui', 'visual', 'e2e']),
-  'sequential-thinking': Object.freeze(['analysis', 'planning', 'reasoning', 'security', 'review']),
+  context7: Object.freeze(["docs", "reference", "api", "sdk", "library"]),
+  "brave-search": Object.freeze(["web", "search", "news", "current"]),
+  exa: Object.freeze(["code", "repository", "examples", "search"]),
+  tavily: Object.freeze([
+    "research",
+    "search",
+    "news",
+    "verification",
+    "current",
+  ]),
+  playwright: Object.freeze(["browser", "ui", "visual", "e2e"]),
+  "sequential-thinking": Object.freeze([
+    "analysis",
+    "planning",
+    "reasoning",
+    "security",
+    "review",
+  ]),
 });
 
 export const DOMAIN_TAG_KEYWORDS = Object.freeze({
-  docs: Object.freeze(['docs', 'documentation', 'manual', 'guide', '문서', '가이드', '매뉴얼']),
-  reference: Object.freeze(['reference', 'spec', 'schema', 'official', '레퍼런스', '공식', '스펙', '스키마']),
-  api: Object.freeze(['api', 'endpoint', 'interface', 'sdk', '호출', '엔드포인트']),
-  sdk: Object.freeze(['sdk', 'library', 'package', 'framework', '라이브러리', '패키지', '프레임워크']),
-  library: Object.freeze(['library', 'package', 'framework', 'module', '라이브러리', '패키지', '모듈']),
-  web: Object.freeze(['web', 'site', 'article', 'forum', 'blog', 'reddit', '웹', '사이트', '기사', '포럼', '블로그']),
-  search: Object.freeze(['search', 'browse', 'lookup', 'find', '검색', '조회', '탐색', '찾아']),
-  news: Object.freeze(['latest', 'recent', 'news', 'today', 'release', 'announcement', '최신', '최근', '뉴스', '오늘', '릴리즈', '공지']),
-  current: Object.freeze(['current', 'status', 'pricing', 'changelog', 'up-to-date', '현재', '상태', '가격', '변경사항']),
-  research: Object.freeze(['research', 'verify', 'fact-check', 'investigate', '리서치', '검증', '조사']),
-  verification: Object.freeze(['verify', 'validation', 'fact-check', 'audit', '검증', '확인', '감사']),
-  code: Object.freeze(['code', 'repo', 'repository', 'source', 'implementation', 'bug', 'fix', 'test', 'snippet', 'cli', '코드', '리포', '저장소', '구현', '버그', '테스트', '예제', '스크립트']),
-  repository: Object.freeze(['repo', 'repository', 'source', 'git', 'github', '리포', '저장소', '소스']),
-  examples: Object.freeze(['example', 'examples', 'snippet', 'sample', '예제', '샘플']),
-  browser: Object.freeze(['browser', 'page', 'dom', 'screenshot', 'render', '브라우저', '페이지', '스크린샷', '렌더']),
-  ui: Object.freeze(['ui', 'ux', 'layout', 'responsive', 'css', 'html', '디자인', '레이아웃', '반응형']),
-  visual: Object.freeze(['visual', 'screenshot', 'layout', 'render', 'screen', '화면', '시각', '스크린샷']),
-  e2e: Object.freeze(['playwright', 'e2e', 'click', 'navigate', 'automation', 'playwright', '클릭', '이동', '자동화']),
-  analysis: Object.freeze(['analysis', 'analyze', 'audit', 'compare', 'root cause', '분석', '검토', '비교', '원인']),
-  planning: Object.freeze(['plan', 'planning', 'strategy', 'design', '계획', '전략', '설계']),
-  reasoning: Object.freeze(['reason', 'reasoning', 'think', 'critique', '추론', '사고', '비평']),
-  security: Object.freeze(['security', 'risk', 'threat', 'vulnerability', '보안', '위험', '취약점']),
-  review: Object.freeze(['review', 'reviewer', 'inspect', '리뷰', '검수']),
+  docs: Object.freeze([
+    "docs",
+    "documentation",
+    "manual",
+    "guide",
+    "문서",
+    "가이드",
+    "매뉴얼",
+  ]),
+  reference: Object.freeze([
+    "reference",
+    "spec",
+    "schema",
+    "official",
+    "레퍼런스",
+    "공식",
+    "스펙",
+    "스키마",
+  ]),
+  api: Object.freeze([
+    "api",
+    "endpoint",
+    "interface",
+    "sdk",
+    "호출",
+    "엔드포인트",
+  ]),
+  sdk: Object.freeze([
+    "sdk",
+    "library",
+    "package",
+    "framework",
+    "라이브러리",
+    "패키지",
+    "프레임워크",
+  ]),
+  library: Object.freeze([
+    "library",
+    "package",
+    "framework",
+    "module",
+    "라이브러리",
+    "패키지",
+    "모듈",
+  ]),
+  web: Object.freeze([
+    "web",
+    "site",
+    "article",
+    "forum",
+    "blog",
+    "reddit",
+    "웹",
+    "사이트",
+    "기사",
+    "포럼",
+    "블로그",
+  ]),
+  search: Object.freeze([
+    "search",
+    "browse",
+    "lookup",
+    "find",
+    "검색",
+    "조회",
+    "탐색",
+    "찾아",
+  ]),
+  news: Object.freeze([
+    "latest",
+    "recent",
+    "news",
+    "today",
+    "release",
+    "announcement",
+    "최신",
+    "최근",
+    "뉴스",
+    "오늘",
+    "릴리즈",
+    "공지",
+  ]),
+  current: Object.freeze([
+    "current",
+    "status",
+    "pricing",
+    "changelog",
+    "up-to-date",
+    "현재",
+    "상태",
+    "가격",
+    "변경사항",
+  ]),
+  research: Object.freeze([
+    "research",
+    "verify",
+    "fact-check",
+    "investigate",
+    "리서치",
+    "검증",
+    "조사",
+  ]),
+  verification: Object.freeze([
+    "verify",
+    "validation",
+    "fact-check",
+    "audit",
+    "검증",
+    "확인",
+    "감사",
+  ]),
+  code: Object.freeze([
+    "code",
+    "repo",
+    "repository",
+    "source",
+    "implementation",
+    "bug",
+    "fix",
+    "test",
+    "snippet",
+    "cli",
+    "코드",
+    "리포",
+    "저장소",
+    "구현",
+    "버그",
+    "테스트",
+    "예제",
+    "스크립트",
+  ]),
+  repository: Object.freeze([
+    "repo",
+    "repository",
+    "source",
+    "git",
+    "github",
+    "리포",
+    "저장소",
+    "소스",
+  ]),
+  examples: Object.freeze([
+    "example",
+    "examples",
+    "snippet",
+    "sample",
+    "예제",
+    "샘플",
+  ]),
+  browser: Object.freeze([
+    "browser",
+    "page",
+    "dom",
+    "screenshot",
+    "render",
+    "브라우저",
+    "페이지",
+    "스크린샷",
+    "렌더",
+  ]),
+  ui: Object.freeze([
+    "ui",
+    "ux",
+    "layout",
+    "responsive",
+    "css",
+    "html",
+    "디자인",
+    "레이아웃",
+    "반응형",
+  ]),
+  visual: Object.freeze([
+    "visual",
+    "screenshot",
+    "layout",
+    "render",
+    "screen",
+    "화면",
+    "시각",
+    "스크린샷",
+  ]),
+  e2e: Object.freeze([
+    "playwright",
+    "e2e",
+    "click",
+    "navigate",
+    "automation",
+    "playwright",
+    "클릭",
+    "이동",
+    "자동화",
+  ]),
+  analysis: Object.freeze([
+    "analysis",
+    "analyze",
+    "audit",
+    "compare",
+    "root cause",
+    "분석",
+    "검토",
+    "비교",
+    "원인",
+  ]),
+  planning: Object.freeze([
+    "plan",
+    "planning",
+    "strategy",
+    "design",
+    "계획",
+    "전략",
+    "설계",
+  ]),
+  reasoning: Object.freeze([
+    "reason",
+    "reasoning",
+    "think",
+    "critique",
+    "추론",
+    "사고",
+    "비평",
+  ]),
+  security: Object.freeze([
+    "security",
+    "risk",
+    "threat",
+    "vulnerability",
+    "보안",
+    "위험",
+    "취약점",
+  ]),
+  review: Object.freeze(["review", "reviewer", "inspect", "리뷰", "검수"]),
 });
 
 export const SERVER_EXPLICIT_KEYWORDS = Object.freeze({
-  context7: Object.freeze(['context7']),
-  'brave-search': Object.freeze(['brave', 'brave-search']),
-  exa: Object.freeze(['exa']),
-  tavily: Object.freeze(['tavily']),
-  playwright: Object.freeze(['playwright']),
-  'sequential-thinking': Object.freeze(['sequential-thinking', 'sequential thinking']),
+  context7: Object.freeze(["context7"]),
+  "brave-search": Object.freeze(["brave", "brave-search"]),
+  exa: Object.freeze(["exa"]),
+  tavily: Object.freeze(["tavily"]),
+  playwright: Object.freeze(["playwright"]),
+  "sequential-thinking": Object.freeze([
+    "sequential-thinking",
+    "sequential thinking",
+  ]),
 });
 
 export function uniqueStrings(values = []) {
-  return [...new Set(
-    values
-      .filter((value) => typeof value === 'string' && value.trim())
-      .map((value) => value.trim()),
-  )];
+  return [
+    ...new Set(
+      values
+        .filter((value) => typeof value === "string" && value.trim())
+        .map((value) => value.trim()),
+    ),
+  ];
 }
 
-export function inferDomainTagsFromText(text = '') {
-  if (typeof text !== 'string' || !text.trim()) return [];
+export function inferDomainTagsFromText(text = "") {
+  if (typeof text !== "string" || !text.trim()) return [];
   const normalized = text.toLocaleLowerCase();
   const matched = [];
 
   for (const [tag, keywords] of Object.entries(DOMAIN_TAG_KEYWORDS)) {
-    if (keywords.some((keyword) => normalized.includes(String(keyword).toLocaleLowerCase()))) {
+    if (
+      keywords.some((keyword) =>
+        normalized.includes(String(keyword).toLocaleLowerCase()),
+      )
+    ) {
       matched.push(tag);
     }
   }
@@ -81,7 +314,7 @@ export function inferDomainTagsFromText(text = '') {
   return uniqueStrings(matched);
 }
 
-export function getDefaultServerMetadata(serverName = '') {
+export function getDefaultServerMetadata(serverName = "") {
   const toolCount = MCP_SERVER_TOOL_CATALOG[serverName]?.length || 0;
   const domainTags = uniqueStrings([
     ...(MCP_SERVER_DOMAIN_TAGS[serverName] || []),
@@ -94,7 +327,7 @@ export function getDefaultServerMetadata(serverName = '') {
   };
 }
 
-export function normalizeServerMetadata(serverName = '', metadata = {}) {
+export function normalizeServerMetadata(serverName = "", metadata = {}) {
   const fallback = getDefaultServerMetadata(serverName);
   const toolCount = Number.isFinite(metadata.tool_count)
     ? Math.max(0, Math.trunc(metadata.tool_count))
@@ -102,13 +335,17 @@ export function normalizeServerMetadata(serverName = '', metadata = {}) {
   const domainTags = uniqueStrings([
     ...fallback.domain_tags,
     ...(Array.isArray(metadata.domain_tags) ? metadata.domain_tags : []),
-    ...inferDomainTagsFromText([
-      serverName,
-      typeof metadata.command === 'string' ? metadata.command : '',
-      typeof metadata.url === 'string' ? metadata.url : '',
-      ...(Array.isArray(metadata.args) ? metadata.args : []),
-      ...(metadata.env && typeof metadata.env === 'object' ? Object.keys(metadata.env) : []),
-    ].join(' ')),
+    ...inferDomainTagsFromText(
+      [
+        serverName,
+        typeof metadata.command === "string" ? metadata.command : "",
+        typeof metadata.url === "string" ? metadata.url : "",
+        ...(Array.isArray(metadata.args) ? metadata.args : []),
+        ...(metadata.env && typeof metadata.env === "object"
+          ? Object.keys(metadata.env)
+          : []),
+      ].join(" "),
+    ),
   ]);
 
   return {

package/scripts/lib/psmux-info.mjs

@@ -8,9 +8,7 @@ export const PSMUX_REQUIRED_COMMANDS = [
   "capture-pane",
 ];
 
-export const PSMUX_OPTIONAL_COMMANDS = [
-  "detach-client",
-];
+export const PSMUX_OPTIONAL_COMMANDS = ["detach-client"];
 
 export const PSMUX_INSTALL_COMMANDS = [
   "winget install marlocarlo.psmux",
@@ -26,7 +24,10 @@ export const PSMUX_UPDATE_COMMANDS = [
   "cargo install psmux --force",
 ];
 
-export function formatPsmuxCommandList(commands = PSMUX_INSTALL_COMMANDS, indent = "") {
+export function formatPsmuxCommandList(
+  commands = PSMUX_INSTALL_COMMANDS,
+  indent = "",
+) {
   return commands.map((command) => `${indent}${command}`).join("\n");
 }
 
@@ -44,8 +45,12 @@ export function parsePsmuxVersion(output = "") {
 }
 
 export function compareSemver(a, b) {
-  const left = String(a || "").split(".").map((part) => Number.parseInt(part, 10) || 0);
-  const right = String(b || "").split(".").map((part) => Number.parseInt(part, 10) || 0);
+  const left = String(a || "")
+    .split(".")
+    .map((part) => Number.parseInt(part, 10) || 0);
+  const right = String(b || "")
+    .split(".")
+    .map((part) => Number.parseInt(part, 10) || 0);
   for (let index = 0; index < 3; index += 1) {
     if (left[index] > right[index]) return 1;
     if (left[index] < right[index]) return -1;

package/scripts/lib/remote-spawn-transfer.mjs

@@ -13,22 +13,37 @@ function normalizeMarkdownTarget(raw) {
 function sanitizeToken(raw) {
   let token = String(raw || "").trim();
   if (!token) return "";
-  token = token.replace(/^[<(]+/u, "").replace(/[)>.,;:!?]+$/u, "").trim();
+  token = token
+    .replace(/^[<(]+/u, "")
+    .replace(/[)>.,;:!?]+$/u, "")
+    .trim();
   return token;
 }
 
 function isLikelyPathToken(token) {
   if (!token || URL_LIKE_RE.test(token)) return false;
-  if (token.startsWith("app://") || token.startsWith("plugin://") || token.startsWith("mention://")) return false;
+  if (
+    token.startsWith("app://") ||
+    token.startsWith("plugin://") ||
+    token.startsWith("mention://")
+  )
+    return false;
   if (token === "~") return false;
 
   const hasPathSeparator = token.includes("/") || token.includes("\\");
-  const hasDotPrefix = token.startsWith("./") || token.startsWith("../") || token.startsWith(".");
+  const hasDotPrefix =
+    token.startsWith("./") || token.startsWith("../") || token.startsWith(".");
   const isHomeRelative = token.startsWith("~/") || token.startsWith("~\\");
   const isWindowsAbs = WINDOWS_ABS_RE.test(token);
   const hasFileLikeSuffix = /\.[a-zA-Z0-9]{1,16}$/u.test(token);
 
-  return hasPathSeparator || hasDotPrefix || isHomeRelative || isWindowsAbs || hasFileLikeSuffix;
+  return (
+    hasPathSeparator ||
+    hasDotPrefix ||
+    isHomeRelative ||
+    isWindowsAbs ||
+    hasFileLikeSuffix
+  );
 }
 
 export function extractExplicitFileTokens(text) {
@@ -67,7 +82,9 @@ function validateTransferFile(filePath, maxBytes) {
     throw new Error(`referenced path is not a file: ${filePath}`);
   }
   if (stats.size > maxBytes) {
-    throw new Error(`referenced file too large: ${stats.size} bytes (max ${maxBytes}) for ${filePath}`);
+    throw new Error(
+      `referenced file too large: ${stats.size} bytes (max ${maxBytes}) for ${filePath}`,
+    );
   }
   return stats.size;
 }
@@ -132,16 +149,23 @@ export function buildRemoteTransferPlan(options = {}) {
   validateTransferFile(absoluteHandoffPath, maxBytes);
   const handoffContent = readFileSync(absoluteHandoffPath, "utf8").trim();
 
-  const stagedHandoffPath = toRemotePath(remoteStageRoot, `handoff/${basename(absoluteHandoffPath)}`);
-  const transfers = [{
-    localPath: absoluteHandoffPath,
-    remotePath: stagedHandoffPath,
-    type: "handoff",
-  }];
+  const stagedHandoffPath = toRemotePath(
+    remoteStageRoot,
+    `handoff/${basename(absoluteHandoffPath)}`,
+  );
+  const transfers = [
+    {
+      localPath: absoluteHandoffPath,
+      remotePath: stagedHandoffPath,
+      type: "handoff",
+    },
+  ];
 
   const tokens = extractExplicitFileTokens(handoffContent);
   if (tokens.length > maxReferenceFiles) {
-    throw new Error(`too many referenced files: ${tokens.length} (max ${maxReferenceFiles})`);
+    throw new Error(
+      `too many referenced files: ${tokens.length} (max ${maxReferenceFiles})`,
+    );
   }
 
   const stagedByLocalPath = new Map();
@@ -166,7 +190,10 @@ export function buildRemoteTransferPlan(options = {}) {
       });
     }
 
-    replacements.push({ token, stagedPath: stagedByLocalPath.get(resolvedPath) });
+    replacements.push({
+      token,
+      stagedPath: stagedByLocalPath.get(resolvedPath),
+    });
   }
 
   const replacementEntries = Array.from(
@@ -189,7 +216,10 @@ export function buildRemoteTransferPlan(options = {}) {
 
   return {
     prompt,
-    replacements: replacementEntries.map(([token, stagedPath]) => ({ stagedPath, token })),
+    replacements: replacementEntries.map(([token, stagedPath]) => ({
+      stagedPath,
+      token,
+    })),
     stagedHandoffPath,
     transfers,
   };

package/scripts/lib/skill-template.mjs

@@ -1,5 +1,12 @@
 import { existsSync, readdirSync, readFileSync } from "node:fs";
-import { basename, extname, isAbsolute, join, relative, resolve } from "node:path";
+import {
+  basename,
+  extname,
+  isAbsolute,
+  join,
+  relative,
+  resolve,
+} from "node:path";
 
 const IF_TAG_RE = /{{\s*(#if\s+([A-Za-z0-9_.-]+)|\/if)\s*}}/g;
 const PARTIAL_RE = /{{>\s*([A-Za-z0-9_./-]+)\s*}}/g;
@@ -187,7 +194,8 @@ function resolveIncludeContent(includeName, options) {
   const fullPath = resolve(baseDir, normalizedName);
   const relativePath = relative(baseDir, fullPath);
   const isInsideBaseDir =
-    relativePath === "" || (!relativePath.startsWith("..") && !isAbsolute(relativePath));
+    relativePath === "" ||
+    (!relativePath.startsWith("..") && !isAbsolute(relativePath));
 
   if (!isInsideBaseDir || !existsSync(fullPath)) {
     throw new Error(`Missing include: ${normalizedName}`);
@@ -223,9 +231,21 @@ function renderVariables(source, context) {
   });
 }
 
-function renderWithContext(source, context, partials, options, includeStack = []) {
+function renderWithContext(
+  source,
+  context,
+  partials,
+  options,
+  includeStack = [],
+) {
   const afterIf = evaluateConditionals(source, context);
-  const afterPartials = renderPartials(afterIf, context, partials, options, includeStack);
+  const afterPartials = renderPartials(
+    afterIf,
+    context,
+    partials,
+    options,
+    includeStack,
+  );
   const afterFileIncludes = renderFileIncludes(
     afterPartials,
     context,
@@ -239,8 +259,8 @@ function renderWithContext(source, context, partials, options, includeStack = []
 function readAllTemplateFiles(rootDir, currentDir = rootDir) {
   if (!rootDir || !existsSync(rootDir)) return [];
 
-  const entries = readdirSync(currentDir, { withFileTypes: true }).sort((left, right) =>
-    left.name.localeCompare(right.name),
+  const entries = readdirSync(currentDir, { withFileTypes: true }).sort(
+    (left, right) => left.name.localeCompare(right.name),
   );
   const files = [];
 
@@ -278,7 +298,10 @@ export function parseFrontmatter(source) {
   return { data, body };
 }
 
-export function buildSkillTemplateContext({ frontmatter = {}, skillDirName = "" } = {}) {
+export function buildSkillTemplateContext({
+  frontmatter = {},
+  skillDirName = "",
+} = {}) {
   const context = { ...frontmatter };
   const skillName = String(frontmatter.name || skillDirName || "").trim();
   const skillDescription = String(frontmatter.description || "").trim();