@fenglimg/fabric-shared 2.0.0-rc.15 → 2.0.0-rc.22

package/dist/node/atomic-write.d.ts

@@ -8,6 +8,22 @@ declare function atomicWriteText(path: string, content: string, opts?: AtomicWri
 declare function atomicWriteJson(path: string, value: unknown, opts?: AtomicWriteJsonOptions): Promise<void>;
 interface LedgerWriteQueue {
     append(path: string, line: string): Promise<void>;
+    /**
+     * Run `fn` with exclusive access to `path` against all other queue operations
+     * (other `runExclusive` calls and `append` calls) on the same path within
+     * this LedgerWriteQueue instance.
+     *
+     * Scope: per-path, in-process (same Node process, same queue instance).
+     * Does NOT provide cross-process locking — separate concern.
+     *
+     * Error semantics: a rejection from `fn` is propagated to the returned
+     * Promise but does NOT poison the chain — subsequent `runExclusive` /
+     * `append` calls on the same path will still acquire and run.
+     *
+     * Ordering: submission-order FIFO. Calls on different paths run independently
+     * (in parallel where possible).
+     */
+    runExclusive<T>(path: string, fn: () => Promise<T>): Promise<T>;
 }
 declare function createLedgerWriteQueue(): LedgerWriteQueue;
 

package/dist/node/atomic-write.js

@@ -38,18 +38,27 @@ function createLedgerWriteQueue() {
     const normalized = line.endsWith("\n") ? line : line + "\n";
     await appendFile(path, normalized, "utf8");
   }
+  function enqueue(path, work) {
+    const prev = chains.get(path) ?? Promise.resolve();
+    const result = prev.catch(() => void 0).then(() => work());
+    const chainSlot = result.then(
+      () => void 0,
+      () => void 0
+    );
+    chains.set(path, chainSlot);
+    chainSlot.finally(() => {
+      if (chains.get(path) === chainSlot) {
+        chains.delete(path);
+      }
+    });
+    return result;
+  }
   return {
     append(path, line) {
-      const prev = chains.get(path) ?? Promise.resolve();
-      const next = prev.catch(() => void 0).then(() => doAppend(path, line));
-      chains.set(path, next);
-      const guarded = next.catch(() => void 0);
-      guarded.finally(() => {
-        if (chains.get(path) === next) {
-          chains.delete(path);
-        }
-      });
-      return next;
+      return enqueue(path, () => doAppend(path, line));
+    },
+    runExclusive(path, fn) {
+      return enqueue(path, fn);
     }
   };
 }

package/dist/schemas/api-contracts.d.ts

@@ -467,6 +467,8 @@ declare const planContextOutputSchema: z.ZodObject<{
         action_hint: string;
         line?: number | undefined;
     }>, "many">>;
+    auto_healed: z.ZodOptional<z.ZodBoolean>;
+    previous_revision_hash: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     stale: boolean;
     entries: {
@@ -551,6 +553,8 @@ declare const planContextOutputSchema: z.ZodObject<{
         action_hint: string;
         line?: number | undefined;
     }[] | undefined;
+    auto_healed?: boolean | undefined;
+    previous_revision_hash?: string | undefined;
 }, {
     stale: boolean;
     entries: {
@@ -635,6 +639,8 @@ declare const planContextOutputSchema: z.ZodObject<{
         action_hint: string;
         line?: number | undefined;
     }[] | undefined;
+    auto_healed?: boolean | undefined;
+    previous_revision_hash?: string | undefined;
 }>;
 declare const planContextAnnotations: {
     readonly readOnlyHint: true;

package/dist/schemas/api-contracts.js

@@ -36,7 +36,7 @@ import {
   planContextInputSchema,
   planContextOutputSchema,
   structuredWarningSchema
-} from "../chunk-NNDFOOBO.js";
+} from "../chunk-WK4WINAZ.js";
 export {
   FabExtractKnowledgeInputSchema,
   FabExtractKnowledgeInputShape,

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**;engine \u4F1A\u81EA\u52A8\u540C\u6B65\u6D3E\u751F\u72B6\u6001,\u663E\u5F0F reconcile \u8DD1 `fab doctor --fix`\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-BEABJYVL.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,7 +111,6 @@ type FabricLanguage = "match-existing" | "zh-CN" | "en" | "zh-CN-hybrid";
 type DefaultLayerFilter = "team" | "personal" | "both";
 interface FabricConfig {
     clientPaths?: ClientPaths;
-    externalFixturePath?: string;
     scanIgnores?: string[];
     audit_mode?: AuditMode;
     mcpPayloadLimits?: McpPayloadLimits;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fenglimg/fabric-shared",
-  "version": "2.0.0-rc.15",
+  "version": "2.0.0-rc.22",
   "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"
   }