@fenglimg/fabric-shared 2.0.0-rc.13 → 2.0.0-rc.21

package/dist/templates/bootstrap-canonical.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Canonical Fabric bootstrap content + marker constants — single source of truth
+ * consumed by both `fab install` (writer) and the server-side doctor (drift
+ * comparator). Mirrors the rc.18 banner-i18n shared-module pattern: shared
+ * constants in `packages/shared` so the cross-package boundary stays clean
+ * (server has zero dep on cli).
+ *
+ * rc.19 bootstrap-consolidation TASK-001: hoisted from per-writer ad-hoc
+ * strings. The canonical body is fixed for all projects — no interpolation —
+ * and intentionally zh-CN-hybrid per locked clarification 3.
+ *
+ * IMPORTANT: the {@link BOOTSTRAP_CANONICAL} body is byte-locked. Do not edit
+ * casually — downstream drift detection asserts byte-identical equality, and
+ * the published-package version becomes the contract between Fabric CLI and
+ * any Fabric server.
+ */
+/**
+ * HTML-comment marker pair delimiting the managed Fabric bootstrap section.
+ * Both writer (idempotent in-place replace) and uninstall helper match these
+ * as plain substrings — keep byte-identical.
+ */
+declare const BOOTSTRAP_MARKER_BEGIN = "<!-- fabric:bootstrap:begin -->";
+declare const BOOTSTRAP_MARKER_END = "<!-- fabric:bootstrap:end -->";
+/**
+ * Legacy marker pair from rc.12-rc.18 era (when the managed section was
+ * branded "Fabric Knowledge Base"). Retained here for one-time migration
+ * detection only: rc.19 install path scans for legacy markers, strips the
+ * legacy region, and rewrites with the new bootstrap markers.
+ */
+declare const LEGACY_KB_MARKER_BEGIN = "<!-- fabric:knowledge-base:begin -->";
+declare const LEGACY_KB_MARKER_END = "<!-- fabric:knowledge-base:end -->";
+/**
+ * Regex matching the entire managed bootstrap section, markers inclusive,
+ * with an optional preceding blank-line separator (so re-install / uninstall
+ * don't leave orphan blank lines). Non-greedy body matches any content
+ * between the begin/end markers, including newlines. Mirrors the shape of
+ * the existing `FABRIC_SECTION_REGEX` in `packages/cli/src/install/skills-and-hooks.ts`.
+ */
+declare const BOOTSTRAP_REGEX: RegExp;
+/**
+ * Legacy-marker variant used for one-time migration detection during rc.19
+ * install — same shape as {@link BOOTSTRAP_REGEX} but targets the older
+ * `knowledge-base` marker pair.
+ */
+declare const LEGACY_KB_REGEX: RegExp;
+/**
+ * Canonical bootstrap body — byte-locked per rc.19 locked clarification 3.
+ * Rendered into the managed block between {@link BOOTSTRAP_MARKER_BEGIN} and
+ * {@link BOOTSTRAP_MARKER_END} by `fab install` across all three supported
+ * clients (Claude Code, Cursor, Codex CLI).
+ *
+ * Length guarantee: ≥ 400 bytes.
+ */
+declare const BOOTSTRAP_CANONICAL = "# Fabric Bootstrap\n\n\u672C\u9879\u76EE\u4F7F\u7528 Fabric \u7BA1\u7406\u8DE8\u5BA2\u6237\u7AEF AI \u77E5\u8BC6\u4E0E\u884C\u4E3A\u89C4\u5219\u3002\u672C\u6587\u4EF6\u7531 `fab install` \u540C\u6B65\u5230\u4E09\u7AEF managed block,**\u4E0D\u8981\u624B\u52A8\u7F16\u8F91\u4E09\u7AEF\u7684 block**,\u53EA\u6539\u8FD9\u91CC + \u91CD\u8DD1 `fab install`\u3002\n\n## \u884C\u4E3A\u89C4\u5219\n- **\u4FEE\u6539\u4EFB\u4F55\u6587\u4EF6\u524D**:\u5FC5\u987B\u5148\u8C03 `fab_plan_context(paths=[<\u88AB\u6539\u6587\u4EF6>])`,\u518D\u8C03 `fab_get_knowledge_sections` \u53D6\u76F8\u5173\u89C4\u5219\u6BB5\u843D\u3002\n- **`.fabric/agents.meta.json` \u4E25\u7981\u624B\u52A8\u7F16\u8F91**:baseline \u53D8\u66F4\u53EA\u80FD\u901A\u8FC7 `fabric doctor --fix` \u63A5\u53D7\u3002\n\n## \u77E5\u8BC6\u5E93(KB)\n- **Discovery**:SessionStart hook \u5217 broad-scoped \u6761\u76EE;edit \u6587\u4EF6\u65F6 PreToolUse hook \u53EF\u80FD\u89E6\u53D1 narrow hint\u3002\n- **Usage**:\u7528 `fab_get_knowledge_sections(id=...)` \u6309 id \u53D6\u6761\u76EE\u5168\u6587\u3002\n- **Write flows**:`fabric-archive` / `fabric-review` / `fabric-import` \u4E09\u4E2A Skills\u3002\n- **Language**:\u6E32\u67D3\u6309 `.fabric/fabric-config.json` \u7684 `fabric_language` \u5B57\u6BB5\u3002\n\n## Cite policy\n\n- **\u89E6\u53D1**: \u505A edit / decide / propose plan \u4E4B\u524D,**\u56DE\u590D\u9996\u884C**\u5FC5\u987B\u5199 `KB: <id> (<\u22648\u5B57 \u7528\u6CD5>) [planned|recalled|chained-from <id>|dismissed:<reason>]` \u6216 `KB: none`\u3002\n- **`[recalled]` \u9A8C\u8BC1**: \u5FC5\u987B\u7D27\u8DDF\u4E00\u6B21 `fab_get_knowledge_sections(id=...)`,\u9632\u6B62\u7F16\u9020 id\u3002\n- **\u7528\u6237\u53E3\u5934\u63D0\u89C4\u5219\u6CA1\u7ED9 id**: \u5148\u8C03 `fab_extract_knowledge` \u6216 `search_context` \u53CD\u67E5\u3002\n- **dismissed reason**: \u679A\u4E3E `scope-mismatch | outdated | not-applicable | other:<text>`\u3002\n- **\u7A3D\u6838**: `fab doctor --cite-coverage [--since=7d] [--client=cc|codex|all]` \u8F93\u51FA cite \u8986\u76D6\u7387\u3002\u672C\u89C4\u5219\u4E0D\u963B\u65AD\u4F60\u5DE5\u4F5C,\u53EA\u8BB0\u5F55\u3002\n";
+
+export { BOOTSTRAP_CANONICAL, BOOTSTRAP_MARKER_BEGIN, BOOTSTRAP_MARKER_END, BOOTSTRAP_REGEX, LEGACY_KB_MARKER_BEGIN, LEGACY_KB_MARKER_END, LEGACY_KB_REGEX };

package/dist/templates/bootstrap-canonical.js

@@ -0,0 +1,18 @@
+import {
+  BOOTSTRAP_CANONICAL,
+  BOOTSTRAP_MARKER_BEGIN,
+  BOOTSTRAP_MARKER_END,
+  BOOTSTRAP_REGEX,
+  LEGACY_KB_MARKER_BEGIN,
+  LEGACY_KB_MARKER_END,
+  LEGACY_KB_REGEX
+} from "../chunk-QZNUUIL3.js";
+export {
+  BOOTSTRAP_CANONICAL,
+  BOOTSTRAP_MARKER_BEGIN,
+  BOOTSTRAP_MARKER_END,
+  BOOTSTRAP_REGEX,
+  LEGACY_KB_MARKER_BEGIN,
+  LEGACY_KB_MARKER_END,
+  LEGACY_KB_REGEX
+};

package/dist/types/index.d.ts

@@ -111,9 +111,7 @@ type FabricLanguage = "match-existing" | "zh-CN" | "en" | "zh-CN-hybrid";
 type DefaultLayerFilter = "team" | "personal" | "both";
 interface FabricConfig {
     clientPaths?: ClientPaths;
-    externalFixturePath?: string;
     scanIgnores?: string[];
-    auditMode?: AuditMode;
     audit_mode?: AuditMode;
     mcpPayloadLimits?: McpPayloadLimits;
     fabric_language?: FabricLanguage;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fenglimg/fabric-shared",
-  "version": "2.0.0-rc.13",
+  "version": "2.0.0-rc.21",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -36,6 +36,10 @@
     "./schemas/api-contracts": {
       "types": "./dist/schemas/api-contracts.d.ts",
       "import": "./dist/schemas/api-contracts.js"
+    },
+    "./templates/bootstrap-canonical": {
+      "types": "./dist/templates/bootstrap-canonical.d.ts",
+      "import": "./dist/templates/bootstrap-canonical.js"
     }
   },
   "files": [
@@ -52,8 +56,8 @@
     "vitest": "^3.2.4"
   },
   "scripts": {
-    "build": "tsup src/index.ts src/i18n/index.ts src/types/index.ts src/node.ts src/node/atomic-write.ts src/node/mcp-payload-guard.ts src/errors/index.ts src/schemas/api-contracts.ts --format esm --dts --clean",
-    "dev": "tsup src/index.ts src/i18n/index.ts src/types/index.ts src/node.ts src/node/atomic-write.ts src/node/mcp-payload-guard.ts src/errors/index.ts src/schemas/api-contracts.ts --format esm --dts --watch",
+    "build": "tsup src/index.ts src/i18n/index.ts src/types/index.ts src/node.ts src/node/atomic-write.ts src/node/mcp-payload-guard.ts src/errors/index.ts src/schemas/api-contracts.ts src/templates/bootstrap-canonical.ts --format esm --dts --clean",
+    "dev": "tsup src/index.ts src/i18n/index.ts src/types/index.ts src/node.ts src/node/atomic-write.ts src/node/mcp-payload-guard.ts src/errors/index.ts src/schemas/api-contracts.ts src/templates/bootstrap-canonical.ts --format esm --dts --watch",
     "test": "vitest run",
     "test:coverage": "vitest run --coverage"
   }