@fenglimg/fabric-cli 2.0.0-rc.1 → 2.0.0-rc.11

package/README.md

@@ -1,16 +1,16 @@
-# @fenglimg/fabric-cli
-
+# @fenglimg/fabric-cli
+
 `fabric` 是 Fabric 的主命令，`fab` 是永久别名，两者等价。
-
+
 ## 快速开始
 
 1. 在 monorepo 根目录运行 `pnpm install`。
 2. 用 `pnpm --filter @fenglimg/fabric-cli build` 构建 CLI。
 3. 在目标项目运行 `fabric init`，完成一站式初始化。
-4. 启动 `fabric serve`，再去客户端里验证 `fab_plan_context` 和 `fab_get_rule_sections`。
+4. 启动 `fabric serve`，再去客户端里验证 `fab_plan_context` 和 `fab_get_knowledge_sections`。
 
 `fabric init` 会自动准备 bootstrap、MCP 配置和 git hooks。公共命令面只保留 `init`、`scan`、`doctor`、`serve`。
-
+
 ## 常用命令
 
 - `fabric init`
@@ -21,4 +21,4 @@
 - `fabric doctor --fix`
 - `fabric serve`
 
-`fabric doctor --fix` 只修复确定性的派生状态，例如 `.fabric/agents.meta.json`、`.fabric/rule-test.index.json`、缺失的 `.fabric/events.jsonl` 和 stale hashes；语义冲突、缺失 rule section、未完成的初始化确认仍需要人工处理。
+`fabric doctor --fix` 只修复确定性的派生状态，例如 `.fabric/agents.meta.json`、`.fabric/.cache/knowledge-test.index.json`、缺失的 `.fabric/events.jsonl` 和 stale hashes；语义冲突、缺失 rule section、未完成的初始化确认仍需要人工处理。

package/dist/{chunk-UHNP7T7W.js → chunk-5MQ52F42.js}

@@ -1,11 +1,16 @@
 #!/usr/bin/env node
 import {
-  createDebugLogger,
   paint,
-  resolveDevMode,
-  symbol,
+  symbol
+} from "./chunk-WWNXR34K.js";
+import {
+  createDebugLogger,
+  readFabricConfig,
+  resolveDevMode
+} from "./chunk-OBQU6NHO.js";
+import {
   t
-} from "./chunk-5LOYBXWD.js";
+} from "./chunk-6ICJICVU.js";
 
 // src/commands/scan.ts
 import { createHash } from "crypto";
@@ -16,7 +21,7 @@ import { defineCommand } from "citty";
 import {
   KnowledgeIdAllocator,
   appendEventLedgerEvent,
-  writeRuleMeta
+  writeKnowledgeMeta
 } from "@fenglimg/fabric-server";
 import {
   formatKnowledgeId
@@ -82,13 +87,16 @@ async function runInitScan(targetInput, options = {}) {
   const forensic = await readForensic(forensicPath);
   const nowIso = (options.now ?? /* @__PURE__ */ new Date()).toISOString();
   const tags = deriveTagsFromForensic(forensic);
+  const fabricConfig = readFabricConfig(target);
+  const knowledgeLanguage = fabricConfig.knowledge_language ?? "match-existing";
+  const resolvedLanguage = resolveKnowledgeLanguage(knowledgeLanguage, target);
   const candidates = [
-    buildTechStackEntry(forensic, nowIso, tags),
-    buildModuleStructureEntry(forensic, nowIso, tags),
-    buildBuildConfigEntry(forensic, nowIso, tags),
-    buildCodeStyleEntry(forensic, nowIso, tags),
+    buildTechStackEntry(forensic, nowIso, tags, resolvedLanguage),
+    buildModuleStructureEntry(forensic, nowIso, tags, resolvedLanguage),
+    buildBuildConfigEntry(forensic, nowIso, tags, resolvedLanguage),
+    buildCodeStyleEntry(forensic, nowIso, tags, resolvedLanguage),
     buildCIConfigEntry(forensic, nowIso, tags),
-    buildReadmeFirstParaEntry(target, forensic, nowIso, tags),
+    buildReadmeFirstParaEntry(target, forensic, nowIso, tags, resolvedLanguage),
     buildProjectBriefEntry(target, forensic, nowIso, tags)
   ];
   const entries = candidates.filter((e) => e !== null);
@@ -119,7 +127,7 @@ async function runInitScan(targetInput, options = {}) {
   await ensureParentDirectory(sidecarPath);
   await atomicWriteJson(sidecarPath, sidecar);
   await registerKnowledgeNodesInMeta(target, placedEntries);
-  await writeRuleMeta(target, { source: "doctor_fix" });
+  await writeKnowledgeMeta(target, { source: "doctor_fix" });
   const durationMs = Date.now() - startTs;
   await appendEventLedgerEvent(target, {
     event_type: "init_scan_completed",
@@ -178,124 +186,338 @@ var scanCommand = defineCommand({
   }
 });
 var scan_default = scanCommand;
-function buildTechStackEntry(forensic, nowIso, tags) {
+var BASELINE_TEMPLATES = {
+  en: {
+    "tech-stack": {
+      title: ({ frameworkSummary }) => `Tech stack: ${frameworkSummary}`,
+      build: ({ projectName, frameworkSummary, topExtensionsLine, evidenceLines }) => ({
+        mission: `Track the primary tech stack and runtime surface used by ${projectName}.`,
+        context: [
+          `Framework: ${frameworkSummary}`,
+          `Top file extensions: ${topExtensionsLine}`,
+          `Evidence:`,
+          ...evidenceLines.map((line) => `- ${line}`)
+        ].join("\n")
+      })
+    },
+    "module-structure": {
+      title: "Module structure",
+      build: ({ projectName, totalFiles, maxDepth, dirsBlock, entriesBlock }) => ({
+        mission: `Map the high-level module layout and primary entry points of ${projectName}.`,
+        context: [
+          `Total files: ${totalFiles}`,
+          `Max directory depth: ${maxDepth}`,
+          "",
+          "Key directories:",
+          dirsBlock,
+          "",
+          "Entry points:",
+          entriesBlock
+        ].join("\n")
+      })
+    },
+    "build-config": {
+      title: "Build configuration",
+      build: ({ projectName, framework, configBlock }) => ({
+        mission: `Document the deterministic build/bootstrap configuration anchoring ${projectName}.`,
+        businessLogic: [
+          `1. Detect framework: \`${framework}\`.`,
+          `2. Read configuration files in declared order.`,
+          `3. Honor compiler/bundler boundaries before generating new code.`,
+          `4. Treat config drift as a fact-check signal \u2014 re-run \`fab scan\` after edits.`
+        ].join("\n"),
+        context: [
+          `Framework: ${framework}`,
+          "",
+          "Configuration files:",
+          configBlock
+        ].join("\n")
+      })
+    },
+    "code-style": {
+      title: "Code style guidelines",
+      build: ({ projectName, rulesBlock, patternsBlock }) => ({
+        mission: `Codify the recurring authoring conventions observed in ${projectName}.`,
+        mandatoryInjection: [
+          "When generating or modifying source files in this repo, AI agents MUST:",
+          rulesBlock
+        ].join("\n"),
+        context: [
+          "Detected patterns:",
+          patternsBlock
+        ].join("\n")
+      })
+    },
+    "readme-first-paragraph": {
+      title: "README first paragraph",
+      build: ({ lineCount, quality, excerpt }) => ({
+        mission: `Preserve the README headline and first paragraph as the canonical project elevator pitch.`,
+        context: [
+          `Source: README.md (${lineCount} lines, quality=${quality})`,
+          "",
+          "Excerpt:",
+          "> " + excerpt.split("\n").join("\n> ")
+        ].join("\n")
+      })
+    }
+  },
+  "zh-CN": {
+    "tech-stack": {
+      title: ({ frameworkSummary }) => `Tech stack: ${frameworkSummary}`,
+      build: ({ projectName, frameworkSummary, topExtensionsLine, evidenceLines }) => ({
+        mission: `\u8BB0\u5F55 ${projectName} \u6240\u4F7F\u7528\u7684\u4E3B\u8981 tech stack \u4E0E\u8FD0\u884C\u65F6\u9762\u3002`,
+        context: [
+          `Framework\uFF1A${frameworkSummary}`,
+          `\u4E3B\u8981\u6587\u4EF6\u540E\u7F00\uFF1A${topExtensionsLine}`,
+          `\u8BC1\u636E\uFF1A`,
+          ...evidenceLines.map((line) => `- ${line}`)
+        ].join("\n")
+      })
+    },
+    "module-structure": {
+      title: "Module structure",
+      build: ({ projectName, totalFiles, maxDepth, dirsBlock, entriesBlock }) => ({
+        mission: `\u68B3\u7406 ${projectName} \u7684\u9AD8\u5C42 module \u5E03\u5C40\u4E0E\u4E3B\u8981 entry point\u3002`,
+        context: [
+          `\u6587\u4EF6\u603B\u6570\uFF1A${totalFiles}`,
+          `\u6700\u5927\u76EE\u5F55\u6DF1\u5EA6\uFF1A${maxDepth}`,
+          "",
+          "\u5173\u952E\u76EE\u5F55\uFF1A",
+          dirsBlock,
+          "",
+          "Entry points\uFF1A",
+          entriesBlock
+        ].join("\n")
+      })
+    },
+    "build-config": {
+      title: "Build configuration",
+      build: ({ projectName, framework, configBlock }) => ({
+        mission: `\u8BB0\u5F55 ${projectName} \u6240\u4F9D\u8D56\u7684\u3001\u786E\u5B9A\u6027\u7684 build / bootstrap \u914D\u7F6E\u3002`,
+        businessLogic: [
+          `1. \u63A2\u6D4B framework\uFF1A\`${framework}\`\u3002`,
+          `2. \u6309\u58F0\u660E\u987A\u5E8F\u8BFB\u53D6 configuration files\u3002`,
+          `3. \u5728\u751F\u6210\u65B0\u4EE3\u7801\u4E4B\u524D\uFF0C\u5C0A\u91CD compiler / bundler \u7684\u8FB9\u754C\u3002`,
+          `4. \u628A config \u6F02\u79FB\u89C6\u4E3A fact-check \u4FE1\u53F7 \u2014\u2014 \u4FEE\u6539\u540E\u91CD\u65B0\u8FD0\u884C \`fab scan\`\u3002`
+        ].join("\n"),
+        context: [
+          `Framework\uFF1A${framework}`,
+          "",
+          "Configuration files\uFF1A",
+          configBlock
+        ].join("\n")
+      })
+    },
+    "code-style": {
+      title: "Code style guidelines",
+      build: ({ projectName, rulesBlock, patternsBlock }) => ({
+        mission: `\u56FA\u5316 ${projectName} \u4E2D\u53CD\u590D\u51FA\u73B0\u7684\u5199\u7801\u7EA6\u5B9A\u3002`,
+        mandatoryInjection: [
+          "\u5728\u672C\u4ED3\u5E93\u5185\u751F\u6210\u6216\u4FEE\u6539\u6E90\u7801\u6587\u4EF6\u65F6\uFF0CAI agent \u5FC5\u987B\uFF1A",
+          rulesBlock
+        ].join("\n"),
+        context: [
+          "\u89C2\u5BDF\u5230\u7684\u6A21\u5F0F\uFF1A",
+          patternsBlock
+        ].join("\n")
+      })
+    },
+    "readme-first-paragraph": {
+      title: "README first paragraph",
+      build: ({ lineCount, quality, excerpt }) => ({
+        mission: `\u628A README \u7684\u6807\u9898\u4E0E\u9996\u6BB5\u4FDD\u7559\u4E3A\u9879\u76EE\u5BF9\u5916\u7684 canonical elevator pitch\u3002`,
+        context: [
+          `\u6765\u6E90\uFF1AREADME.md\uFF08${lineCount} \u884C\uFF0Cquality=${quality}\uFF09`,
+          "",
+          "\u6458\u5F55\uFF1A",
+          "> " + excerpt.split("\n").join("\n> ")
+        ].join("\n")
+      })
+    }
+  }
+};
+function resolveTemplateTitle(template, inputs) {
+  return typeof template.title === "function" ? template.title(inputs) : template.title;
+}
+function resolveKnowledgeLanguage(configured, target) {
+  if (configured === "en" || configured === "zh-CN") {
+    return configured;
+  }
+  return detectExistingLanguage(target);
+}
+function detectExistingLanguage(target) {
+  const ZH_CN_RATIO_THRESHOLD = 0.3;
+  const samples = [];
+  const readmePath = join(target, "README.md");
+  if (existsSync(readmePath)) {
+    try {
+      samples.push(readFileSync(readmePath, "utf8"));
+    } catch {
+    }
+  }
+  const docsDir = join(target, "docs");
+  if (existsSync(docsDir)) {
+    try {
+      const stat = statSync(docsDir);
+      if (stat.isDirectory()) {
+        for (const entry of readdirSync(docsDir, { withFileTypes: true })) {
+          if (!entry.isFile()) continue;
+          if (!/\.(md|mdx|txt)$/iu.test(entry.name)) continue;
+          try {
+            samples.push(readFileSync(join(docsDir, entry.name), "utf8"));
+          } catch {
+          }
+        }
+      }
+    } catch {
+    }
+  }
+  if (samples.length === 0) {
+    return "en";
+  }
+  let cjkCount = 0;
+  let asciiLetterCount = 0;
+  for (const sample of samples) {
+    for (const ch of sample) {
+      const code = ch.codePointAt(0) ?? 0;
+      if (code >= 19968 && code <= 40959) {
+        cjkCount += 1;
+      } else if (code >= 65 && code <= 90 || code >= 97 && code <= 122) {
+        asciiLetterCount += 1;
+      }
+    }
+  }
+  const denominator = cjkCount + asciiLetterCount;
+  if (denominator === 0) {
+    return "en";
+  }
+  const ratio = cjkCount / denominator;
+  return ratio > ZH_CN_RATIO_THRESHOLD ? "zh-CN" : "en";
+}
+function buildTechStackEntry(forensic, nowIso, tags, language = "en") {
   const framework = forensic.framework;
   const byExt = forensic.topology.by_ext ?? {};
   const topExtensions = Object.entries(byExt).sort(([, a], [, b]) => b - a).slice(0, 5).map(([ext, count]) => `${ext} (${count})`);
+  const frameworkSummary = `${framework.kind}${framework.version ? ` ${framework.version}` : ""}${framework.subkind ? ` / ${framework.subkind}` : ""}`;
+  const topExtensionsLine = topExtensions.length > 0 ? topExtensions.join(", ") : "(none)";
   const evidenceLines = framework.evidence.length > 0 ? framework.evidence.slice(0, 6) : ["(no explicit framework evidence)"];
-  const body = renderSections({
-    mission: `Track the primary tech stack and runtime surface used by ${forensic.project_name}.`,
-    context: [
-      `Framework: ${framework.kind}${framework.version ? ` ${framework.version}` : ""}${framework.subkind ? ` / ${framework.subkind}` : ""}`,
-      `Top file extensions: ${topExtensions.length > 0 ? topExtensions.join(", ") : "(none)"}`,
-      `Evidence:`,
-      ...evidenceLines.map((line) => `- ${line}`)
-    ].join("\n")
-  });
+  const inputs = {
+    projectName: forensic.project_name,
+    frameworkSummary,
+    topExtensionsLine,
+    evidenceLines
+  };
+  const template = BASELINE_TEMPLATES[language]["tech-stack"];
+  const sections = template.build(inputs);
+  const body = renderSections(sections);
+  const relevancePaths = ["package.json", "pnpm-workspace.yaml"];
   return {
     type: "model",
     layer: "team",
     maturity: "verified",
     layer_reason: LAYER_REASON,
     created_at: nowIso,
-    title: `Tech stack: ${framework.kind}`,
+    title: resolveTemplateTitle(template, inputs),
     body,
     target_subdir: "models",
     slug: "tech-stack",
-    tags
+    tags,
+    relevance_scope: "narrow",
+    relevance_paths: relevancePaths
   };
 }
-function buildModuleStructureEntry(forensic, nowIso, tags) {
+function buildModuleStructureEntry(forensic, nowIso, tags, language = "en") {
   const keyDirs = forensic.topology.key_dirs ?? [];
   const entryPoints = forensic.entry_points ?? [];
   const totalFiles = forensic.topology.total_files ?? 0;
   const dirsBlock = keyDirs.length > 0 ? keyDirs.slice(0, 12).map((dir) => `- ${dir}`).join("\n") : "- (no key directories detected)";
   const entriesBlock = entryPoints.length > 0 ? entryPoints.slice(0, 8).map((ep) => `- ${ep.path} \u2014 ${ep.reason}`).join("\n") : "- (no entry points detected)";
-  const body = renderSections({
-    mission: `Map the high-level module layout and primary entry points of ${forensic.project_name}.`,
-    context: [
-      `Total files: ${totalFiles}`,
-      `Max directory depth: ${forensic.topology.max_depth ?? 0}`,
-      "",
-      "Key directories:",
-      dirsBlock,
-      "",
-      "Entry points:",
-      entriesBlock
-    ].join("\n")
-  });
+  const inputs = {
+    projectName: forensic.project_name,
+    totalFiles,
+    maxDepth: forensic.topology.max_depth ?? 0,
+    dirsBlock,
+    entriesBlock
+  };
+  const template = BASELINE_TEMPLATES[language]["module-structure"];
+  const body = renderSections(template.build(inputs));
+  const relevancePaths = ["packages/**/package.json"];
   return {
     type: "model",
     layer: "team",
     maturity: "verified",
     layer_reason: LAYER_REASON,
     created_at: nowIso,
-    title: "Module structure",
+    title: resolveTemplateTitle(template, inputs),
     body,
     target_subdir: "models",
     slug: "module-structure",
-    tags
+    tags,
+    relevance_scope: "narrow",
+    relevance_paths: relevancePaths
   };
 }
-function buildBuildConfigEntry(forensic, nowIso, tags) {
+function buildBuildConfigEntry(forensic, nowIso, tags, language = "en") {
   const configFiles = (forensic.candidate_files ?? []).filter((entry) => entry.family === "config").map((entry) => entry.path);
   const framework = forensic.framework.kind;
   const configBlock = configFiles.length > 0 ? configFiles.map((file) => `- ${file}`).join("\n") : "- (no config files detected)";
-  const body = renderSections({
-    mission: `Document the deterministic build/bootstrap configuration anchoring ${forensic.project_name}.`,
-    businessLogic: [
-      `1. Detect framework: \`${framework}\`.`,
-      `2. Read configuration files in declared order.`,
-      `3. Honor compiler/bundler boundaries before generating new code.`,
-      `4. Treat config drift as a fact-check signal \u2014 re-run \`fab scan\` after edits.`
-    ].join("\n"),
-    context: [
-      `Framework: ${framework}`,
-      "",
-      "Configuration files:",
-      configBlock
-    ].join("\n")
-  });
+  const inputs = {
+    projectName: forensic.project_name,
+    framework,
+    configBlock
+  };
+  const template = BASELINE_TEMPLATES[language]["build-config"];
+  const body = renderSections(template.build(inputs));
+  const discovered = configFiles.filter((path) => isBuildConfigPath(path));
+  const relevancePaths = discovered.length > 0 ? Array.from(new Set(discovered)) : ["tsconfig.json", "tsconfig.*.json", "vite.config.*", "rollup.config.*", "webpack.config.*"];
   return {
     type: "process",
     layer: "team",
     maturity: "verified",
     layer_reason: LAYER_REASON,
     created_at: nowIso,
-    title: "Build configuration",
+    title: resolveTemplateTitle(template, inputs),
     body,
     target_subdir: "processes",
     slug: "build-config",
-    tags
+    tags,
+    relevance_scope: "narrow",
+    relevance_paths: relevancePaths
   };
 }
-function buildCodeStyleEntry(forensic, nowIso, tags) {
+function buildCodeStyleEntry(forensic, nowIso, tags, language = "en") {
   const dominantPatterns = (forensic.assertions ?? []).filter((a) => a.type === "pattern" || a.type === "domain").slice(0, 4).map((a) => `- ${a.statement}`);
   const proposedRules = (forensic.assertions ?? []).map((a) => a.proposed_rule).filter((rule) => typeof rule === "string" && rule.length > 0).slice(0, 4);
   const patternsBlock = dominantPatterns.length > 0 ? dominantPatterns.join("\n") : "- (no dominant patterns detected)";
   const rulesBlock = proposedRules.length > 0 ? proposedRules.map((rule) => `- ${rule}`).join("\n") : "- Follow existing module/file patterns; do not introduce new conventions without team agreement.";
-  const body = renderSections({
-    mission: `Codify the recurring authoring conventions observed in ${forensic.project_name}.`,
-    mandatoryInjection: [
-      "When generating or modifying source files in this repo, AI agents MUST:",
-      rulesBlock
-    ].join("\n"),
-    context: [
-      "Detected patterns:",
-      patternsBlock
-    ].join("\n")
-  });
+  const inputs = {
+    projectName: forensic.project_name,
+    rulesBlock,
+    patternsBlock
+  };
+  const template = BASELINE_TEMPLATES[language]["code-style"];
+  const body = renderSections(template.build(inputs));
+  const relevancePaths = [
+    ".prettierrc",
+    ".prettierrc.*",
+    ".editorconfig",
+    "eslint.config.*",
+    ".eslintrc",
+    ".eslintrc.*"
+  ];
   return {
     type: "guideline",
     layer: "team",
     maturity: "verified",
     layer_reason: LAYER_REASON,
     created_at: nowIso,
-    title: "Code style guidelines",
+    title: resolveTemplateTitle(template, inputs),
     body,
     target_subdir: "guidelines",
     slug: "code-style",
-    tags
+    tags,
+    relevance_scope: "narrow",
+    relevance_paths: relevancePaths
   };
 }
 function buildCIConfigEntry(forensic, nowIso, tags) {
@@ -319,6 +541,12 @@ function buildCIConfigEntry(forensic, nowIso, tags) {
       filesBlock
     ].join("\n")
   });
+  const relevancePaths = [
+    ".github/workflows/**",
+    ".gitlab-ci.yml",
+    ".circleci/**",
+    "Jenkinsfile"
+  ];
   return {
     type: "process",
     layer: "team",
@@ -329,10 +557,12 @@ function buildCIConfigEntry(forensic, nowIso, tags) {
     body,
     target_subdir: "processes",
     slug: "ci-config",
-    tags
+    tags,
+    relevance_scope: "narrow",
+    relevance_paths: relevancePaths
   };
 }
-function buildReadmeFirstParaEntry(target, forensic, nowIso, tags) {
+function buildReadmeFirstParaEntry(target, forensic, nowIso, tags, language = "en") {
   if (forensic.readme.quality === "missing") {
     return null;
   }
@@ -345,26 +575,29 @@ function buildReadmeFirstParaEntry(target, forensic, nowIso, tags) {
   if (firstPara === null) {
     return null;
   }
-  const body = renderSections({
-    mission: `Preserve the README headline and first paragraph as the canonical project elevator pitch.`,
-    context: [
-      `Source: README.md (${forensic.readme.line_count} lines, quality=${forensic.readme.quality})`,
-      "",
-      "Excerpt:",
-      "> " + firstPara.split("\n").join("\n> ")
-    ].join("\n")
-  });
+  const inputs = {
+    lineCount: forensic.readme.line_count,
+    quality: forensic.readme.quality,
+    excerpt: firstPara
+  };
+  const template = BASELINE_TEMPLATES[language]["readme-first-paragraph"];
+  const body = renderSections(template.build(inputs));
   return {
     type: "model",
     layer: "team",
     maturity: "verified",
     layer_reason: LAYER_REASON,
     created_at: nowIso,
-    title: "README first paragraph",
+    title: resolveTemplateTitle(template, inputs),
     body,
     target_subdir: "models",
     slug: "readme-first-paragraph",
-    tags
+    tags,
+    // v2.0-rc.7 T2: broad by design — single repo-root file, the Phase 1.5
+    // PreToolUse blacklist already covers README. Anchoring this entry to
+    // README.md would surface it on every README edit, which is noise.
+    relevance_scope: "broad",
+    relevance_paths: []
   };
 }
 function buildProjectBriefEntry(target, forensic, nowIso, tags) {
@@ -399,7 +632,13 @@ function buildProjectBriefEntry(target, forensic, nowIso, tags) {
     body,
     target_subdir: "models",
     slug: "project-brief",
-    tags
+    tags,
+    // v2.0-rc.7 T2: broad — project brief is a cross-cutting description
+    // with no path anchor. Narrowing it to README.md would duplicate the
+    // readme-first-paragraph surface; keeping it broad lets the
+    // SessionStart broad hint do the right thing.
+    relevance_scope: "broad",
+    relevance_paths: []
   };
 }
 function renderMarkdown(entry) {
@@ -413,6 +652,7 @@ ${entry.body}
 }
 function renderFrontmatter(entry) {
   const tagsLine = entry.tags.length > 0 ? `tags: [${entry.tags.join(", ")}]` : "tags: []";
+  const relevancePathsLine = entry.relevance_paths.length > 0 ? `relevance_paths: [${entry.relevance_paths.map((p) => quoteIfNeeded(p)).join(", ")}]` : "relevance_paths: []";
   const lines = [
     "---",
     `id: ${entry.id}`,
@@ -422,6 +662,8 @@ function renderFrontmatter(entry) {
     `layer_reason: ${quoteIfNeeded(entry.layer_reason)}`,
     `created_at: ${entry.created_at}`,
     tagsLine,
+    `relevance_scope: ${entry.relevance_scope}`,
+    relevancePathsLine,
     "---"
   ];
   return lines.join("\n");
@@ -545,6 +787,19 @@ function findExistingIdForFile(sidecar, targetPath, target) {
 function isCIConfigPath(path) {
   return path.startsWith(".github/workflows/") || path.startsWith(".gitlab-ci") || path === "azure-pipelines.yml" || path === ".circleci/config.yml" || path === "Jenkinsfile" || path === ".travis.yml";
 }
+function isBuildConfigPath(path) {
+  const lower = path.toLowerCase();
+  const basename = lower.split("/").pop() ?? lower;
+  if (basename.startsWith("tsconfig") && basename.endsWith(".json")) return true;
+  if (basename === "package.json") return true;
+  if (basename === "pnpm-workspace.yaml" || basename === "pnpm-workspace.yml") return true;
+  if (basename.startsWith("vite.config.")) return true;
+  if (basename.startsWith("rollup.config.")) return true;
+  if (basename.startsWith("webpack.config.")) return true;
+  if (basename.startsWith("vitest.config.")) return true;
+  if (basename === "turbo.json" || basename === "nx.json") return true;
+  return false;
+}
 function extractFirstParagraph(readme) {
   const lines = readme.split(/\r?\n/);
   let i = 0;
@@ -724,8 +979,13 @@ var __testing__ = {
   renderMarkdown,
   stripFrontmatter,
   isCIConfigPath,
+  isBuildConfigPath,
   extractFirstParagraph,
-  extractExplicitDescription
+  extractExplicitDescription,
+  // TASK-008: bilingual template registry + language detection
+  detectExistingLanguage,
+  resolveKnowledgeLanguage,
+  BASELINE_TEMPLATES
 };
 
 export {
@@ -735,6 +995,7 @@ export {
   runInitScan,
   scanCommand,
   scan_default,
+  detectExistingLanguage,
   deriveTagsFromForensic,
   __testing__
 };

package/dist/chunk-6ICJICVU.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+
+// src/i18n.ts
+import { createTranslator, detectNodeLocale } from "@fenglimg/fabric-shared";
+var locale = detectNodeLocale();
+var t = createTranslator(locale);
+
+export {
+  t
+};