@triflux/remote 10.50.2 → 10.51.0

package/scripts/lib/skill-template.mjs

@@ -1,31 +1,5 @@
-import { existsSync, readdirSync, readFileSync } from "node:fs";
-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;
-const FILE_INCLUDE_RE = /{{#include\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.hasOwn(context, key)) return context[key];
-  const upper = key.toUpperCase();
-  if (Object.hasOwn(context, upper)) return context[upper];
-  return undefined;
-}
-
 function parseBoolean(raw) {
   if (typeof raw !== "string") return undefined;
   if (raw === "true") return true;
@@ -120,175 +94,6 @@ function parseFrontmatterBlock(block) {
   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 renderPartials(source, context, partials, options, includeStack) {
-  return source.replace(PARTIAL_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, options, [
-      ...includeStack,
-      partialName,
-    ]);
-  });
-}
-
-function normalizeIncludeName(includeName) {
-  return includeName.replace(/\\/g, "/");
-}
-
-function resolveIncludeContent(includeName, options) {
-  const normalizedName = normalizeIncludeName(includeName);
-  if (Object.hasOwn(options.includes, normalizedName)) {
-    return options.includes[normalizedName];
-  }
-  if (!options.includeBaseDir) {
-    throw new Error(`Missing include: ${normalizedName}`);
-  }
-
-  const baseDir = resolve(options.includeBaseDir);
-  const fullPath = resolve(baseDir, normalizedName);
-  const relativePath = relative(baseDir, fullPath);
-  const isInsideBaseDir =
-    relativePath === "" ||
-    (!relativePath.startsWith("..") && !isAbsolute(relativePath));
-
-  if (!isInsideBaseDir || !existsSync(fullPath)) {
-    throw new Error(`Missing include: ${normalizedName}`);
-  }
-
-  const content = readFileSync(fullPath, "utf8");
-  options.includes[normalizedName] = content;
-  return content;
-}
-
-function renderFileIncludes(source, context, partials, options, includeStack) {
-  return source.replace(FILE_INCLUDE_RE, (_full, includeName) => {
-    const normalizedName = normalizeIncludeName(includeName);
-    const content = resolveIncludeContent(normalizedName, options);
-    if (includeStack.includes(normalizedName)) {
-      const chain = [...includeStack, normalizedName].join(" -> ");
-      throw new Error(`Circular template include: ${chain}`);
-    }
-    return renderWithContext(content, context, partials, options, [
-      ...includeStack,
-      normalizedName,
-    ]);
-  });
-}
-
-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,
-  options,
-  includeStack = [],
-) {
-  const afterIf = evaluateConditionals(source, context);
-  const afterPartials = renderPartials(
-    afterIf,
-    context,
-    partials,
-    options,
-    includeStack,
-  );
-  const afterFileIncludes = renderFileIncludes(
-    afterPartials,
-    context,
-    partials,
-    options,
-    includeStack,
-  );
-  return renderVariables(afterFileIncludes, 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.hasOwn(partials, key)) {
-    partials[key] = value;
-  }
-}
-
 export function parseFrontmatter(source) {
   const match = source.match(FRONTMATTER_RE);
   if (!match) return { data: {}, body: source };
@@ -297,53 +102,3 @@ export function parseFrontmatter(source) {
   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 = {}, includes = {}, includeBaseDir = "" } = options;
-  return renderWithContext(template, context, partials, {
-    includeBaseDir,
-    includes: { ...includes },
-  });
-}

package/hub/team/build-worker-prompt.mjs

@@ -1,92 +0,0 @@
-// hub/team/build-worker-prompt.mjs — append Completion Protocol to PRD prompt (#125)
-//
-// swarm-hypervisor injects a Completion Protocol appendix into every worker
-// prompt so that workers emit a sentinel-framed JSON payload conductor.mjs can
-// reliably capture (see sentinel-capture.mjs and extract-completion-payload.mjs).
-//
-// Pure module — no I/O — so the appendix and merge logic can be unit-tested
-// without spawning conductors.
-
-import { SENTINEL_BEGIN, SENTINEL_END } from "./sentinel-capture.mjs";
-
-function normalizeLeaseFiles(leaseFiles) {
-  if (!Array.isArray(leaseFiles)) return [];
-  return leaseFiles
-    .map((file) => (typeof file === "string" ? file.trim() : ""))
-    .filter(Boolean);
-}
-
-function formatLeaseFiles(leaseFiles) {
-  const normalized = normalizeLeaseFiles(leaseFiles);
-  if (normalized.length === 0) return "- (none declared)";
-  return normalized.map((file) => `- ${file}`).join("\n");
-}
-
-function normalizeWorktreePath(worktreePath) {
-  return typeof worktreePath === "string" ? worktreePath.trim() : "";
-}
-
-export function buildLeaseScopedAcceptanceAppendix({
-  leaseFiles = [],
-  worktreePath,
-} = {}) {
-  const normalizedWorktreePath = normalizeWorktreePath(worktreePath);
-  const rootLine = normalizedWorktreePath
-    ? `작업 루트(절대경로): ${normalizedWorktreePath} — 아래 lease 경로와 모든 상대경로는 이 루트 기준으로만 해석한다.\n`
-    : "";
-
-  return `
-
-## Lease-scoped Acceptance / Lint Guard (자동 삽입됨)
-${rootLine}- 위 PRD 본문의 모든 제약과 acceptance 기준은 이 appendix 이후에도 그대로 유효하다.
-- 이 shard 의 파일 lease:
-${formatLeaseFiles(leaseFiles)}
-- Acceptance, lint, and format checks are scoped to files changed by this shard; if that set is unclear, use only the lease list above.
-- Do not run repo-wide format/lint fixers such as \`biome check --write .\`, \`biome --write .\`, \`npm run lint:fix\`, or broad \`npm run lint\` to absorb unrelated drift.
-- For Biome, use \`npx biome check <changed-files-or-lease-files>\`; add \`--write\` only when every target is a changed/leased file you intend to commit.
-- Pre-existing lint drift outside the lease is not this shard's acceptance responsibility; report it instead of editing it.
-`;
-}
-
-export const COMPLETION_PROTOCOL_APPENDIX = `
-
-## Completion Protocol (자동 삽입됨)
-<!-- swarm hypervisor 가 이 섹션을 worker prompt 에 자동 주입합니다.
-     PRD 작성자는 이 섹션을 수정하지 마세요.
-     상세: hub/team/build-worker-prompt.mjs / sentinel-capture.mjs (#125). -->
-
-작업의 마지막 단계로, stdout 에 다음 형식의 완료 payload 를 정확히 한 번 출력하라:
-
-${SENTINEL_BEGIN}
-{"shard":"<shard name>","status":"ok","commits_made":[{"sha":"<40-char full sha>","message":"<commit msg>"}]}
-${SENTINEL_END}
-
-규약:
-- 두 sentinel 마커는 각자 자기 줄에 단독으로 출력 (앞뒤 newline)
-- 마커 사이 본문은 단일 JSON object (배열/primitive 금지)
-- status 값은 ok | failed | blocked 중 하나
-- payload 출력 직전 \`git log -1 --format=%H\` 로 보고할 sha 가 실재하는지 검증하라
-- 코드 변경이 기대되는 shard 에서 변경/커밋을 못 했으면 status:failed 와 함께 reason 필드로 사유를 보고하라 — 그 경우 빈 commits_made 에 status:ok 는 금지
-- no-op shard 는 status:ok + 빈 commits_made 배열 허용
-- 마커 쌍은 stdout 에 정확히 한 번만 출력해야 함. 재emit 시 conductor 는 첫 BEGIN..END 한 쌍만 채택하며, 이후 stdout 은 무시한다.
-- ${SENTINEL_BEGIN} 만 출력하고 ${SENTINEL_END} 누락 시 conductor 가 truncation 으로 명확히 reject
-`;
-
-/**
- * Append the Completion Protocol section to a PRD prompt.
- *
- * @param {string|null|undefined} prdPrompt — original PRD body
- * @param {{ leaseFiles?: string[], worktreePath?: string }} [opts] — shard file lease and absolute worktree root for scoped acceptance
- * @returns {string} prompt with appendix
- */
-export function buildWorkerPrompt(prdPrompt, opts = {}) {
-  const body = typeof prdPrompt === "string" ? prdPrompt : "";
-  return (
-    body +
-    buildLeaseScopedAcceptanceAppendix({
-      leaseFiles: opts.leaseFiles,
-      worktreePath: opts.worktreePath,
-    }) +
-    COMPLETION_PROTOCOL_APPENDIX
-  );
-}

package/hub/team/check-mcp-hub.mjs

@@ -1,49 +0,0 @@
-// hub/team/check-mcp-hub.mjs — health-probe L2 용 hub /health ping 체커.
-// health-probe.mjs 의 checkMcp 로 주입되어 `mcp_initializing` state 판정에 사용.
-// hub /health 가 200 이면 OK (MCP transport 인프라 살아있음), 그 외는 fail.
-
-const DEFAULT_HUB_URL = "http://127.0.0.1:27888";
-const DEFAULT_TIMEOUT_MS = 3000;
-
-function resolveHubHealthUrl(hubUrl) {
-  const base = hubUrl || process.env.TFX_HUB_URL || DEFAULT_HUB_URL;
-  // `/mcp` suffix 제거 (triflux convention — bridge.mjs:54, hub-client.mjs,
-  // lead-control.mjs, session-sync.mjs 전부 TFX_HUB_URL 을 MCP transport URL
-  // 로 쓰고 base URL 이 필요할 때 `/mcp$` 를 strip 한다). 제거하지 않으면
-  // `.../mcp/health` 가 되어 hub 가 404 로 응답 → L2 영구 fail → heartbeat
-  // 이 지속적으로 `mcp_initializing` 로 grace — #173 Codex P2 review.
-  return base.replace(/\/mcp\/?$/, "").replace(/\/+$/, "") + "/health";
-}
-
-/**
- * Hub /health 기반 L2 checker factory.
- * @param {object} [opts]
- * @param {string} [opts.hubUrl] — override. 미지정 시 TFX_HUB_URL env 또는 default.
- * @param {number} [opts.timeoutMs=3000] — fetch timeout (ms).
- * @param {typeof fetch} [opts.fetchFn] — fetch 오버라이드 (테스트용).
- * @returns {() => Promise<boolean>} — true = hub healthy, false = degraded/down/timeout.
- */
-export function createHubHealthChecker(opts = {}) {
-  const url = resolveHubHealthUrl(opts.hubUrl);
-  const timeoutMs = Number.isFinite(opts.timeoutMs)
-    ? opts.timeoutMs
-    : DEFAULT_TIMEOUT_MS;
-  const fetchFn = opts.fetchFn || globalThis.fetch;
-
-  return async function checkMcpHubHealth() {
-    if (typeof fetchFn !== "function") return false;
-    const controller = new AbortController();
-    const timer = setTimeout(() => controller.abort(), timeoutMs);
-    try {
-      const res = await fetchFn(url, {
-        method: "GET",
-        signal: controller.signal,
-      });
-      return res.ok === true;
-    } catch {
-      return false;
-    } finally {
-      clearTimeout(timer);
-    }
-  };
-}