@triflux/core 10.0.0-alpha.1 → 10.0.0

package/scripts/lib/skill-template.mjs

@@ -0,0 +1,269 @@
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { basename, extname, join, relative } from "node:path";
+
+const IF_TAG_RE = /{{\s*(#if\s+([A-Za-z0-9_.-]+)|\/if)\s*}}/g;
+const INCLUDE_RE = /{{>\s*([A-Za-z0-9_./-]+)\s*}}/g;
+const VARIABLE_RE = /{{\s*([A-Za-z0-9_.-]+)\s*}}/g;
+const FRONTMATTER_RE = /^---\r?\n(?:([\s\S]*?)\r?\n)?---\r?\n?/;
+
+function isTruthy(value) {
+  if (typeof value === "string") return value.trim().length > 0;
+  return Boolean(value);
+}
+
+function normalizeVariable(context, key) {
+  if (Object.prototype.hasOwnProperty.call(context, key)) return context[key];
+  const upper = key.toUpperCase();
+  if (Object.prototype.hasOwnProperty.call(context, upper)) return context[upper];
+  return undefined;
+}
+
+function parseBoolean(raw) {
+  if (typeof raw !== "string") return undefined;
+  if (raw === "true") return true;
+  if (raw === "false") return false;
+  return undefined;
+}
+
+function parseScalar(raw) {
+  if (raw == null) return "";
+  const value = raw.trim();
+  if (!value) return "";
+  if (
+    (value.startsWith('"') && value.endsWith('"')) ||
+    (value.startsWith("'") && value.endsWith("'"))
+  ) {
+    return value.slice(1, -1);
+  }
+  const bool = parseBoolean(value);
+  return bool ?? value;
+}
+
+function parseMultilineValue(lines, startIndex, marker) {
+  const fold = marker.startsWith(">");
+  const chunks = [];
+  let index = startIndex;
+
+  while (index + 1 < lines.length && /^\s+/.test(lines[index + 1])) {
+    index += 1;
+    chunks.push(lines[index].replace(/^\s+/, ""));
+  }
+
+  return {
+    index,
+    value: fold ? chunks.join(" ").trim() : chunks.join("\n").trim(),
+  };
+}
+
+function parseListValue(lines, startIndex) {
+  const items = [];
+  let index = startIndex;
+
+  while (index + 1 < lines.length) {
+    const nextLine = lines[index + 1];
+    const match = nextLine.match(/^\s*-\s+(.*)$/);
+    if (match) {
+      index += 1;
+      items.push(parseScalar(match[1]));
+      continue;
+    }
+    if (/^\s*$/.test(nextLine)) {
+      index += 1;
+      continue;
+    }
+    break;
+  }
+
+  return { index, value: items };
+}
+
+function parseFrontmatterBlock(block) {
+  const lines = block.split(/\r?\n/);
+  const data = {};
+
+  for (let i = 0; i < lines.length; i += 1) {
+    const line = lines[i];
+    const match = line.match(/^([A-Za-z0-9_-]+):\s*(.*)$/);
+    if (!match) continue;
+
+    const [, rawKey, rawValue] = match;
+    const key = rawKey.trim();
+    const value = rawValue.trim();
+
+    if (value === ">" || value === "|" || value === ">-" || value === "|-") {
+      const parsed = parseMultilineValue(lines, i, value);
+      data[key] = parsed.value;
+      i = parsed.index;
+      continue;
+    }
+
+    if (!value) {
+      const parsed = parseListValue(lines, i);
+      if (parsed.index !== i) {
+        data[key] = parsed.value;
+        i = parsed.index;
+        continue;
+      }
+    }
+
+    data[key] = parseScalar(value);
+  }
+
+  return data;
+}
+
+function evaluateConditionals(source, context) {
+  const matcher = new RegExp(IF_TAG_RE.source, "g");
+
+  function walk(startIndex, nested) {
+    let output = "";
+    let cursor = startIndex;
+
+    while (true) {
+      const found = matcher.exec(source);
+      if (!found) {
+        if (nested) throw new Error("Unclosed {{#if ...}} block in template");
+        output += source.slice(cursor);
+        return { output, index: source.length };
+      }
+
+      output += source.slice(cursor, found.index);
+      cursor = matcher.lastIndex;
+
+      const directive = found[1];
+      const flag = found[2];
+      if (directive.startsWith("#if")) {
+        const nestedResult = walk(cursor, true);
+        cursor = nestedResult.index;
+        matcher.lastIndex = cursor;
+        if (isTruthy(normalizeVariable(context, flag))) {
+          output += nestedResult.output;
+        }
+        continue;
+      }
+
+      if (!nested) {
+        throw new Error("Unexpected {{/if}} without matching {{#if ...}}");
+      }
+      return { output, index: cursor };
+    }
+  }
+
+  return walk(0, false).output;
+}
+
+function renderIncludes(source, context, partials, includeStack) {
+  return source.replace(INCLUDE_RE, (_full, partialName) => {
+    const partial = partials[partialName];
+    if (partial == null) {
+      throw new Error(`Missing partial: ${partialName}`);
+    }
+    if (includeStack.includes(partialName)) {
+      const chain = [...includeStack, partialName].join(" -> ");
+      throw new Error(`Circular partial include: ${chain}`);
+    }
+    return renderWithContext(partial, context, partials, [...includeStack, partialName]);
+  });
+}
+
+function renderVariables(source, context) {
+  return source.replace(VARIABLE_RE, (full, key) => {
+    const value = normalizeVariable(context, key);
+    if (value == null) {
+      throw new Error(`Missing template variable: ${key}`);
+    }
+    return String(value);
+  });
+}
+
+function renderWithContext(source, context, partials, includeStack = []) {
+  const afterIf = evaluateConditionals(source, context);
+  const afterInclude = renderIncludes(afterIf, context, partials, includeStack);
+  return renderVariables(afterInclude, context);
+}
+
+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 files = [];
+
+  for (const entry of entries) {
+    const fullPath = join(currentDir, entry.name);
+    if (entry.isDirectory()) {
+      files.push(...readAllTemplateFiles(rootDir, fullPath));
+      continue;
+    }
+
+    if (!entry.isFile()) continue;
+    if (!entry.name.endsWith(".md") && !entry.name.endsWith(".tmpl")) continue;
+
+    const relativePath = relative(rootDir, fullPath).replace(/\\/g, "/");
+    const content = readFileSync(fullPath, "utf8");
+    files.push({ fullPath, relativePath, content });
+  }
+
+  return files;
+}
+
+function setPartial(partials, key, value) {
+  if (!key) return;
+  if (!Object.prototype.hasOwnProperty.call(partials, key)) {
+    partials[key] = value;
+  }
+}
+
+export function parseFrontmatter(source) {
+  const match = source.match(FRONTMATTER_RE);
+  if (!match) return { data: {}, body: source };
+
+  const data = parseFrontmatterBlock(match[1] ?? "");
+  const body = source.slice(match[0].length);
+  return { data, body };
+}
+
+export function buildSkillTemplateContext({ frontmatter = {}, skillDirName = "" } = {}) {
+  const context = { ...frontmatter };
+  const skillName = String(frontmatter.name || skillDirName || "").trim();
+  const skillDescription = String(frontmatter.description || "").trim();
+
+  let deep = frontmatter.DEEP ?? frontmatter.deep;
+  if (typeof deep === "string") {
+    const parsed = parseBoolean(deep.trim().toLowerCase());
+    deep = parsed ?? deep;
+  }
+  if (typeof deep !== "boolean") {
+    deep = /(^|[-_])deep($|[-_])/i.test(skillName);
+  }
+
+  context.SKILL_NAME = skillName;
+  context.SKILL_DESCRIPTION = skillDescription;
+  context.DEEP = deep;
+  return context;
+}
+
+export function loadTemplatePartials(partialsDir) {
+  const files = readAllTemplateFiles(partialsDir);
+  const partials = {};
+
+  for (const file of files) {
+    const extension = extname(file.relativePath);
+    const withoutExt = extension
+      ? file.relativePath.slice(0, -extension.length)
+      : file.relativePath;
+    const normalized = withoutExt.replace(/\\/g, "/");
+    const base = basename(normalized);
+
+    setPartial(partials, normalized, file.content);
+    setPartial(partials, base, file.content);
+  }
+
+  return partials;
+}
+
+export function renderSkillTemplate(template, context = {}, options = {}) {
+  const { partials = {} } = options;
+  return renderWithContext(template, context, partials);
+}

package/scripts/lib/claudemd-manager.mjs

@@ -1,325 +0,0 @@
-/**
- * claudemd-manager.mjs — TFX CLAUDE.md 섹션 관리
- *
- * OMC 패턴 차용: <!-- TFX:START --> / <!-- TFX:END --> 마커 기반.
- * setup/update 시 마커 사이 내용을 템플릿으로 교체.
- * doctor 시 stale 감지 + 직접 호출 충돌 경고.
- */
-
-import { readFileSync, writeFileSync, existsSync } from "node:fs";
-import { homedir } from "node:os";
-import { join, dirname } from "node:path";
-import { fileURLToPath } from "node:url";
-
-const SCRIPT_DIR = dirname(fileURLToPath(import.meta.url));
-const TEMPLATE_PATH = join(SCRIPT_DIR, "..", "templates", "claudemd-tfx-section.md");
-
-const TFX_START = "<!-- TFX:START -->";
-const TFX_END = "<!-- TFX:END -->";
-const TFX_VERSION_RE = /<!-- TFX:VERSION:([\d.]+) -->/;
-
-// 직접 호출 패턴 (TFX 블록 외부에서 발견되면 충돌)
-const DIRECT_CALL_PATTERNS = [
-  /codex\s+exec\s+--dangerously/,
-  /codex\s+--profile\s+\w+\s+exec/,
-  /gemini\s+-[yp]\s/,
-  /codex\s+exec\s+review/,
-];
-
-/**
- * 현재 triflux 버전을 package.json에서 읽기
- */
-export function getPackageVersion() {
-  try {
-    const pkgPath = join(SCRIPT_DIR, "..", "..", "package.json");
-    const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
-    return pkg.version || "0.0.0";
-  } catch {
-    return "0.0.0";
-  }
-}
-
-/**
- * 템플릿 파일 읽기
- */
-export function loadTemplate() {
-  try {
-    return readFileSync(TEMPLATE_PATH, "utf8").trim();
-  } catch (error) {
-    throw new Error(`TFX 템플릿 로드 실패: ${TEMPLATE_PATH}: ${error.message}`);
-  }
-}
-
-/**
- * CLAUDE.md에서 TFX 섹션 추출
- * @returns {{ found: boolean, version: string|null, content: string|null, startIdx: number, endIdx: number }}
- */
-export function readSection(filePath) {
-  if (!existsSync(filePath)) {
-    return { found: false, version: null, content: null, startIdx: -1, endIdx: -1 };
-  }
-
-  const raw = readFileSync(filePath, "utf8");
-  const startIdx = raw.indexOf(TFX_START);
-  const endIdx = raw.indexOf(TFX_END);
-
-  if (startIdx === -1 || endIdx === -1 || endIdx <= startIdx) {
-    return { found: false, version: null, content: null, startIdx: -1, endIdx: -1 };
-  }
-
-  const section = raw.slice(startIdx, endIdx + TFX_END.length);
-  const versionMatch = section.match(TFX_VERSION_RE);
-  const version = versionMatch ? versionMatch[1] : null;
-
-  return { found: true, version, content: section, startIdx, endIdx: endIdx + TFX_END.length };
-}
-
-/**
- * TFX 섹션 쓰기/교체
- * - 기존 마커가 있으면 교체
- * - 없으면 OMC:END 뒤에 삽입 (없으면 파일 끝)
- */
-export function writeSection(filePath, options = {}) {
-  const version = options.version || getPackageVersion();
-  const template = options.template || loadTemplate();
-
-  const block = [
-    TFX_START,
-    `<!-- TFX:VERSION:${version} -->`,
-    template,
-    TFX_END,
-  ].join("\n");
-
-  if (!existsSync(filePath)) {
-    writeFileSync(filePath, block + "\n", "utf8");
-    return { action: "created", version };
-  }
-
-  const raw = readFileSync(filePath, "utf8");
-  const existing = readSection(filePath);
-
-  if (existing.found) {
-    // 기존 TFX 블록 교체
-    const before = raw.slice(0, existing.startIdx);
-    const after = raw.slice(existing.endIdx);
-    writeFileSync(filePath, before + block + after, "utf8");
-    return { action: "updated", oldVersion: existing.version, version };
-  }
-
-  // OMC:END 뒤에 삽입
-  const omcEndIdx = raw.indexOf("<!-- OMC:END -->");
-  if (omcEndIdx !== -1) {
-    const insertAt = omcEndIdx + "<!-- OMC:END -->".length;
-    const before = raw.slice(0, insertAt);
-    const after = raw.slice(insertAt);
-    writeFileSync(filePath, before + "\n" + block + after, "utf8");
-    return { action: "inserted_after_omc", version };
-  }
-
-  // 파일 끝에 추가
-  const separator = raw.endsWith("\n") ? "" : "\n";
-  writeFileSync(filePath, raw + separator + block + "\n", "utf8");
-  return { action: "appended", version };
-}
-
-/**
- * TFX 섹션 제거
- */
-export function removeSection(filePath) {
-  if (!existsSync(filePath)) return { action: "no_file" };
-
-  const raw = readFileSync(filePath, "utf8");
-  const existing = readSection(filePath);
-
-  if (!existing.found) return { action: "not_found" };
-
-  const before = raw.slice(0, existing.startIdx);
-  const after = raw.slice(existing.endIdx);
-  // 연속 빈줄 정리
-  const cleaned = (before + after).replace(/\n{3,}/g, "\n\n");
-  writeFileSync(filePath, cleaned, "utf8");
-  return { action: "removed", oldVersion: existing.version };
-}
-
-/**
- * TFX 블록 외부에서 직접 CLI 호출 감지
- * @returns {{ conflicts: Array<{line: number, text: string, pattern: string}> }}
- */
-export function detectConflicts(filePath) {
-  if (!existsSync(filePath)) return { conflicts: [] };
-
-  const raw = readFileSync(filePath, "utf8");
-  const existing = readSection(filePath);
-
-  // TFX 블록 내부 제거 후 검사
-  let textOutside = raw;
-  if (existing.found) {
-    textOutside = raw.slice(0, existing.startIdx) + raw.slice(existing.endIdx);
-  }
-
-  const lines = textOutside.split("\n");
-  const conflicts = [];
-
-  for (let i = 0; i < lines.length; i++) {
-    const line = lines[i];
-    // 코드블록 안은 무시
-    if (line.trim().startsWith("```")) continue;
-    // 주석/금지 문맥 무시
-    if (/금지|차단|NEVER|prohibit|block/i.test(line)) continue;
-
-    for (const pattern of DIRECT_CALL_PATTERNS) {
-      if (pattern.test(line)) {
-        conflicts.push({
-          line: i + 1,
-          text: line.trim(),
-          pattern: pattern.source,
-        });
-      }
-    }
-  }
-
-  return { conflicts };
-}
-
-/**
- * Doctor 진단 — 종합 검사
- * @returns {{ status: "ok"|"warn"|"error", issues: string[] }}
- */
-export function diagnose(filePath) {
-  const issues = [];
-
-  if (!existsSync(filePath)) {
-    return { status: "error", issues: ["CLAUDE.md 파일 없음: " + filePath] };
-  }
-
-  const section = readSection(filePath);
-  if (!section.found) {
-    issues.push("TFX 섹션 없음 — `tfx setup` 또는 `/tfx-setup`으로 추가 필요");
-  } else {
-    const currentVersion = getPackageVersion();
-    if (section.version !== currentVersion) {
-      issues.push(`TFX 섹션 stale: ${section.version} → ${currentVersion} (업데이트 필요)`);
-    }
-  }
-
-  const { conflicts } = detectConflicts(filePath);
-  for (const c of conflicts) {
-    issues.push(`L${c.line}: 직접 CLI 호출 감지 — "${c.text.slice(0, 60)}..."`);
-  }
-
-  if (issues.length === 0) return { status: "ok", issues: [] };
-  if (issues.some((i) => i.includes("stale") || i.includes("없음"))) return { status: "error", issues };
-  return { status: "warn", issues };
-}
-
-// ── 기존 유저 마이그레이션 ──
-
-// 레거시 <user_cli_routing> 마커 없는 섹션 감지
-const LEGACY_PATTERNS = [
-  /<user_cli_routing>/,
-  /Codex Pro 무료 기간/,
-  /codex exec --dangerously-bypass.*skip-git-repo-check/,
-  /OMC 에이전트 → CLI 매핑/,
-  /Spark 가드레일/,
-];
-
-/**
- * 레거시 CLI 라우팅 섹션 감지
- * @returns {{ found: boolean, startIdx: number, endIdx: number, markers: string[] }}
- */
-export function detectLegacy(filePath) {
-  if (!existsSync(filePath)) return { found: false, startIdx: -1, endIdx: -1, markers: [] };
-
-  const raw = readFileSync(filePath, "utf8");
-  const markers = [];
-
-  for (const p of LEGACY_PATTERNS) {
-    if (p.test(raw)) markers.push(p.source);
-  }
-
-  if (markers.length === 0) return { found: false, startIdx: -1, endIdx: -1, markers: [] };
-
-  // <user_cli_routing> ... </user_cli_routing> 블록 범위 찾기
-  const startTag = raw.indexOf("<user_cli_routing>");
-  const endTag = raw.indexOf("</user_cli_routing>");
-
-  if (startTag !== -1 && endTag !== -1) {
-    return { found: true, startIdx: startTag, endIdx: endTag + "</user_cli_routing>".length, markers };
-  }
-
-  return { found: true, startIdx: -1, endIdx: -1, markers };
-}
-
-/**
- * 레거시 섹션을 TFX 관리 블록으로 마이그레이션
- * 1. 레거시 <user_cli_routing> 제거
- * 2. TFX 마커 블록 삽입
- * @returns {{ action: string, removed: string[], version: string }}
- */
-export function migrate(filePath, options = {}) {
-  const legacy = detectLegacy(filePath);
-  const existing = readSection(filePath);
-
-  // 이미 TFX 마커가 있고 레거시가 없으면 스킵
-  if (existing.found && !legacy.found) {
-    return { action: "already_managed", removed: [], version: existing.version };
-  }
-
-  const raw = readFileSync(filePath, "utf8");
-  let cleaned = raw;
-
-  const removed = [];
-
-  // 1. 레거시 <user_cli_routing> 블록 제거
-  if (legacy.found && legacy.startIdx !== -1) {
-    // <!-- USER OVERRIDES --> 코멘트도 같이 제거
-    let removeStart = legacy.startIdx;
-    const userOverrideComment = "<!-- USER OVERRIDES";
-    const commentIdx = cleaned.lastIndexOf(userOverrideComment, removeStart);
-    if (commentIdx !== -1 && removeStart - commentIdx < 200) {
-      removeStart = commentIdx;
-    }
-
-    const before = cleaned.slice(0, removeStart);
-    const after = cleaned.slice(legacy.endIdx);
-    cleaned = (before + after).replace(/\n{3,}/g, "\n\n");
-    removed.push("<user_cli_routing> block");
-  }
-
-  // 2. TFX 블록이 있으면 제거 (교체 위해)
-  if (existing.found) {
-    const s = readSection(filePath);
-    if (s.found) {
-      cleaned = cleaned.slice(0, cleaned.indexOf(TFX_START)) +
-        cleaned.slice(cleaned.indexOf(TFX_END) + TFX_END.length);
-      cleaned = cleaned.replace(/\n{3,}/g, "\n\n");
-      removed.push("old TFX block");
-    }
-  }
-
-  // 3. 정리된 파일 저장
-  writeFileSync(filePath, cleaned, "utf8");
-
-  // 4. 새 TFX 블록 삽입
-  const result = writeSection(filePath, options);
-
-  return { action: "migrated", removed, version: result.version };
-}
-
-/**
- * 모든 CLAUDE.md 파일 스캔 (전역 + 프로젝트)
- * @returns {string[]} 경로 목록
- */
-export function findAllClaudeMdPaths() {
-  const paths = [];
-
-  // 전역
-  const globalPath = join(homedir(), ".claude", "CLAUDE.md");
-  if (existsSync(globalPath)) paths.push(globalPath);
-
-  // 현재 프로젝트
-  const cwdPath = join(process.cwd(), "CLAUDE.md");
-  if (existsSync(cwdPath)) paths.push(cwdPath);
-
-  return paths;
-}