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

package/README.md

@@ -6,14 +6,14 @@
 
 1. 在 monorepo 根目录运行 `pnpm install`。
 2. 用 `pnpm --filter @fenglimg/fabric-cli build` 构建 CLI。
-3. 在目标项目运行 `fabric init`，完成一站式初始化。
+3. 在目标项目运行 `fabric install`，完成一站式安装。
 4. 启动 `fabric serve`，再去客户端里验证 `fab_plan_context` 和 `fab_get_knowledge_sections`。
 
-`fabric init` 会自动准备 bootstrap、MCP 配置和 git hooks。公共命令面只保留 `init`、`scan`、`doctor`、`serve`。
+`fabric install` 会自动准备 bootstrap、MCP 配置和 git hooks。公共命令面只保留 `install`、`scan`、`doctor`、`serve`。
 
 ## 常用命令
 
-- `fabric init`
+- `fabric install`
 - `fabric scan`
 - `fabric doctor`
 - `fabric doctor --json`

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

@@ -88,8 +88,8 @@ async function runInitScan(targetInput, options = {}) {
   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 fabricLanguage = fabricConfig.fabric_language ?? "match-existing";
+  const resolvedLanguage = resolveFabricLanguage(fabricLanguage, target);
   const candidates = [
     buildTechStackEntry(forensic, nowIso, tags, resolvedLanguage),
     buildModuleStructureEntry(forensic, nowIso, tags, resolvedLanguage),
@@ -186,7 +186,7 @@ var scanCommand = defineCommand({
   }
 });
 var scan_default = scanCommand;
-var BASELINE_TEMPLATES = {
+var STRICT_BASELINE_TEMPLATES = {
   en: {
     "tech-stack": {
       title: ({ frameworkSummary }) => `Tech stack: ${frameworkSummary}`,
@@ -336,11 +336,16 @@ var BASELINE_TEMPLATES = {
     }
   }
 };
+var BASELINE_TEMPLATES = {
+  en: STRICT_BASELINE_TEMPLATES.en,
+  "zh-CN": STRICT_BASELINE_TEMPLATES["zh-CN"],
+  "zh-CN-hybrid": STRICT_BASELINE_TEMPLATES["zh-CN"]
+};
 function resolveTemplateTitle(template, inputs) {
   return typeof template.title === "function" ? template.title(inputs) : template.title;
 }
-function resolveKnowledgeLanguage(configured, target) {
-  if (configured === "en" || configured === "zh-CN") {
+function resolveFabricLanguage(configured, target) {
+  if (configured === "en" || configured === "zh-CN" || configured === "zh-CN-hybrid") {
     return configured;
   }
   return detectExistingLanguage(target);
@@ -392,7 +397,7 @@ function detectExistingLanguage(target) {
     return "en";
   }
   const ratio = cjkCount / denominator;
-  return ratio > ZH_CN_RATIO_THRESHOLD ? "zh-CN" : "en";
+  return ratio > ZH_CN_RATIO_THRESHOLD ? "zh-CN-hybrid" : "en";
 }
 function buildTechStackEntry(forensic, nowIso, tags, language = "en") {
   const framework = forensic.framework;
@@ -982,9 +987,9 @@ var __testing__ = {
   isBuildConfigPath,
   extractFirstParagraph,
   extractExplicitDescription,
-  // TASK-008: bilingual template registry + language detection
+  // TASK-008 / rc.12: bilingual template registry + language detection
   detectExistingLanguage,
-  resolveKnowledgeLanguage,
+  resolveFabricLanguage,
   BASELINE_TEMPLATES
 };
 

package/dist/{chunk-HQLEHH4O.js → chunk-OHWQNSLH.js}

@@ -6,7 +6,7 @@ import {
   normalizeConfigPath,
   removeJsonClientConfigEntry,
   writeJsonClientConfig
-} from "./chunk-AW3G7ZH5.js";
+} from "./chunk-X7QPY5KH.js";
 
 // src/config/resolver.ts
 import { existsSync as existsSync3 } from "fs";

package/dist/{chunk-WPTA74BY.js → chunk-Q72D24BG.js}

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import {
-  addArchiveSkillPointer,
+  addFabricKnowledgeBaseSection,
   installArchiveHintHook,
   installFabricArchiveSkill,
   installFabricImportSkill,
@@ -9,8 +9,9 @@ import {
   installKnowledgeHintNarrowHook,
   mergeClaudeCodeHookConfig,
   mergeCodexHookConfig,
-  mergeCursorHookConfig
-} from "./chunk-AW3G7ZH5.js";
+  mergeCursorHookConfig,
+  readFabricLanguagePreference
+} from "./chunk-X7QPY5KH.js";
 import {
   t
 } from "./chunk-6ICJICVU.js";
@@ -66,7 +67,8 @@ async function installHooks(target, _options = {}) {
   results.push(await runSingleStep("claude-hook-config", () => mergeClaudeCodeHookConfig(normalizedTarget)));
   results.push(await runSingleStep("codex-hook-config", () => mergeCodexHookConfig(normalizedTarget)));
   results.push(await runSingleStep("cursor-hook-config", () => mergeCursorHookConfig(normalizedTarget)));
-  results.push(...await runStep(() => addArchiveSkillPointer(normalizedTarget)));
+  const fabricLanguage = readFabricLanguagePreference(normalizedTarget);
+  results.push(...await runStep(() => addFabricKnowledgeBaseSection(normalizedTarget, fabricLanguage)));
   results.push(...validateHookPaths(normalizedTarget));
   return summarizeResults(results);
 }

package/dist/{chunk-AW3G7ZH5.js → chunk-X7QPY5KH.js}

@@ -307,10 +307,41 @@ var FABRIC_HOOK_COMMAND_PATHS = {
     knowledgeHintNarrow: ".cursor/hooks/knowledge-hint-narrow.cjs"
   }
 };
-var POINTER_LINE = "> Use the fabric-archive Skill when archiving knowledge entries (see .claude/skills/fabric-archive/SKILL.md).";
-var REVIEW_POINTER_LINE = "> Use the fabric-review Skill to review pending knowledge entries (see .claude/skills/fabric-review/SKILL.md).";
-var IMPORT_POINTER_LINE = "> Use the fabric-import Skill for cold-start enrichment from git history and docs (see .claude/skills/fabric-import/SKILL.md).";
-var POINTER_TARGETS = ["CLAUDE.md", "AGENTS.md", join2(".cursor", "rules")];
+var SECTION_TARGETS = ["CLAUDE.md", "AGENTS.md", join2(".cursor", "rules")];
+var FABRIC_SECTION_BEGIN_MARKER = "<!-- fabric:knowledge-base:begin -->";
+var FABRIC_SECTION_END_MARKER = "<!-- fabric:knowledge-base:end -->";
+var FABRIC_SECTION_REGEX = /(?:\r?\n){0,2}<!-- fabric:knowledge-base:begin -->[\s\S]*?<!-- fabric:knowledge-base:end -->/;
+function readFabricLanguagePreference(projectRoot) {
+  const configPath = join2(projectRoot, ".fabric", "fabric-config.json");
+  if (!existsSync2(configPath)) {
+    return "match-existing";
+  }
+  try {
+    const raw = readFileSync(configPath, "utf8");
+    const parsed = JSON.parse(raw);
+    if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+      return "match-existing";
+    }
+    const value = parsed["fabric_language"];
+    return typeof value === "string" && value.length > 0 ? value : "match-existing";
+  } catch {
+    return "match-existing";
+  }
+}
+function buildFabricKnowledgeBaseSection(fabricLanguage) {
+  return `${FABRIC_SECTION_BEGIN_MARKER}
+
+## Fabric Knowledge Base
+
+This project uses Fabric for persistent project knowledge under \`.fabric/knowledge/\`.
+
+- **Discovery**: SessionStart lists available entries (broad menu); editing files may surface narrow hints
+- **Usage**: call \`fab_get_knowledge_sections\` to fetch full content of any entry by id
+- **Write flows**: see fabric-archive (record), fabric-review (validate), fabric-import (backfill) Skills
+- **Language**: rendered per \`fabric_language\` in \`.fabric/fabric-config.json\` (current: \`${fabricLanguage}\`)
+
+${FABRIC_SECTION_END_MARKER}`;
+}
 async function installFabricArchiveSkill(projectRoot, _options = {}) {
   const source = await readTemplate(SKILL_TEMPLATE_REL);
   const targets = SKILL_DESTINATIONS.fabricArchive.map((rel) => join2(projectRoot, rel));
@@ -416,12 +447,13 @@ async function mergeCursorHookConfig(projectRoot, _options = {}) {
     [...HOOK_CONFIG_ARRAY_PATHS.cursor]
   );
 }
-async function addArchiveSkillPointer(projectRoot, _options = {}) {
+async function addFabricKnowledgeBaseSection(projectRoot, fabricLanguage, _options = {}) {
+  const sectionBody = buildFabricKnowledgeBaseSection(fabricLanguage);
   const results = [];
-  for (const rel of POINTER_TARGETS) {
+  for (const rel of SECTION_TARGETS) {
     const target = join2(projectRoot, rel);
     if (!existsSync2(target)) {
-      results.push({ step: "pointer", path: target, status: "skipped", message: "absent" });
+      results.push({ step: "section", path: target, status: "skipped", message: "absent" });
       continue;
     }
     let existing;
@@ -429,47 +461,43 @@ async function addArchiveSkillPointer(projectRoot, _options = {}) {
       existing = await readFile2(target, "utf8");
     } catch (error) {
       results.push({
-        step: "pointer",
+        step: "section",
         path: target,
         status: "error",
         message: error instanceof Error ? error.message : String(error)
       });
       continue;
     }
-    let next = existing;
-    let wrote = false;
-    if (next.includes(POINTER_LINE)) {
-      results.push({ step: "pointer", path: target, status: "skipped", message: "already-present" });
-    } else {
-      const trailingNewline = next.length === 0 || next.endsWith("\n") ? "" : "\n";
-      next = `${next}${trailingNewline}
-${POINTER_LINE}
+    let next;
+    const match = existing.match(FABRIC_SECTION_REGEX);
+    if (match !== null) {
+      const before = existing.slice(0, match.index ?? 0);
+      const after = existing.slice((match.index ?? 0) + match[0].length);
+      const stripped = `${before}${after.replace(/^\r?\n/, "")}`;
+      const trailingNewline = stripped.length === 0 || stripped.endsWith("\n") ? "" : "\n";
+      next = `${stripped}${trailingNewline}
+${sectionBody}
 `;
-      wrote = true;
-      results.push({ step: "pointer", path: target, status: "written" });
-    }
-    if (next.includes(REVIEW_POINTER_LINE)) {
-      results.push({ step: "pointer-review", path: target, status: "skipped", message: "already-present" });
     } else {
-      const trailingNewline = next.length === 0 || next.endsWith("\n") ? "" : "\n";
-      next = `${next}${trailingNewline}
-${REVIEW_POINTER_LINE}
+      const trailingNewline = existing.length === 0 || existing.endsWith("\n") ? "" : "\n";
+      next = `${existing}${trailingNewline}
+${sectionBody}
 `;
-      wrote = true;
-      results.push({ step: "pointer-review", path: target, status: "written" });
     }
-    if (next.includes(IMPORT_POINTER_LINE)) {
-      results.push({ step: "pointer-import", path: target, status: "skipped", message: "already-present" });
-    } else {
-      const trailingNewline = next.length === 0 || next.endsWith("\n") ? "" : "\n";
-      next = `${next}${trailingNewline}
-${IMPORT_POINTER_LINE}
-`;
-      wrote = true;
-      results.push({ step: "pointer-import", path: target, status: "written" });
+    if (next === existing) {
+      results.push({ step: "section", path: target, status: "skipped", message: "up-to-date" });
+      continue;
     }
-    if (wrote) {
+    try {
       await atomicWriteText(target, next);
+      results.push({ step: "section", path: target, status: "written" });
+    } catch (error) {
+      results.push({
+        step: "section",
+        path: target,
+        status: "error",
+        message: error instanceof Error ? error.message : String(error)
+      });
     }
   }
   return results;
@@ -559,10 +587,9 @@ export {
   HOOK_CONFIG_TARGETS,
   HOOK_CONFIG_ARRAY_PATHS,
   FABRIC_HOOK_COMMAND_PATHS,
-  POINTER_LINE,
-  REVIEW_POINTER_LINE,
-  IMPORT_POINTER_LINE,
-  POINTER_TARGETS,
+  SECTION_TARGETS,
+  FABRIC_SECTION_REGEX,
+  readFabricLanguagePreference,
   installFabricArchiveSkill,
   installFabricReviewSkill,
   installFabricImportSkill,
@@ -572,5 +599,5 @@ export {
   mergeClaudeCodeHookConfig,
   mergeCodexHookConfig,
   mergeCursorHookConfig,
-  addArchiveSkillPointer
+  addFabricKnowledgeBaseSection
 };

package/dist/{hooks-NX32PPEN.js → hooks-HIWYI3VG.js}

@@ -3,8 +3,8 @@ import {
   hooksCommand,
   hooks_default,
   installHooks
-} from "./chunk-WPTA74BY.js";
-import "./chunk-AW3G7ZH5.js";
+} from "./chunk-Q72D24BG.js";
+import "./chunk-X7QPY5KH.js";
 import "./chunk-6ICJICVU.js";
 export {
   hooks_default as default,

package/dist/index.js

@@ -8,12 +8,12 @@ import { defineCommand, runMain } from "citty";
 
 // src/commands/index.ts
 var allCommands = {
-  init: () => import("./init-C56PWHID.js").then((module) => module.default),
-  scan: () => import("./scan-66EKMNAY.js").then((module) => module.default),
+  install: () => import("./install-SLS5W27W.js").then((module) => module.default),
+  scan: () => import("./scan-VHKZPT2W.js").then((module) => module.default),
   serve: () => import("./serve-NGLXHDYC.js").then((module) => module.default),
-  uninstall: () => import("./uninstall-DBAR2JBS.js").then((module) => module.default),
+  uninstall: () => import("./uninstall-JHUSFENL.js").then((module) => module.default),
   doctor: () => import("./doctor-RILCO5OG.js").then((module) => module.default),
-  hooks: () => import("./hooks-NX32PPEN.js").then((module) => module.default),
+  hooks: () => import("./hooks-HIWYI3VG.js").then((module) => module.default),
   "plan-context-hint": () => import("./plan-context-hint-QMUPAXIB.js").then((module) => module.default)
 };
 
@@ -21,8 +21,8 @@ var allCommands = {
 var main = defineCommand({
   meta: {
     name: "fabric",
-    version: "2.0.0-rc.11",
-    description: 'Initialize and manage Fabric projects. Use "fabric init" for one-shot setup.'
+    version: "2.0.0-rc.13",
+    description: 'Initialize and manage Fabric projects. Use "fabric install" for one-shot setup.'
   },
   subCommands: allCommands
 });