@fenglimg/fabric-shared 2.2.0-rc.3 → 2.2.0-rc.4

package/dist/chunk-4N6DMOOW.js

@@ -0,0 +1,128 @@
+// src/node/atomic-write.ts
+import { appendFile, mkdir, open, readFile, rename, stat, unlink, writeFile } from "fs/promises";
+import { dirname } from "path";
+import { randomUUID } from "crypto";
+function makeTmpSuffix() {
+  const rand = Math.floor(Math.random() * 65535).toString(16).padStart(4, "0");
+  return `.${process.pid}.${Date.now()}.${rand}.tmp`;
+}
+async function atomicWriteText(path, content, opts) {
+  const tmpPath = path + makeTmpSuffix();
+  try {
+    if (opts?.fsync) {
+      const fd = await open(tmpPath, "w");
+      try {
+        await fd.writeFile(content, "utf8");
+        await fd.datasync();
+      } finally {
+        await fd.close();
+      }
+    } else {
+      await writeFile(tmpPath, content, "utf8");
+    }
+    await rename(tmpPath, path);
+  } catch (err) {
+    try {
+      await unlink(tmpPath);
+    } catch {
+    }
+    throw err;
+  }
+}
+async function atomicWriteJson(path, value, opts) {
+  const indent = opts?.indent ?? 2;
+  const content = JSON.stringify(value, null, indent) + "\n";
+  await atomicWriteText(path, content, { fsync: opts?.fsync });
+}
+function isErrnoException(err) {
+  return err instanceof Error && typeof err.code === "string";
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function withFileLock(lockPath, fn, opts = {}) {
+  const staleMs = opts.staleMs ?? 1e4;
+  const retryDelayMs = opts.retryDelayMs ?? 20;
+  const maxWaitMs = opts.maxWaitMs ?? 1e4;
+  await mkdir(dirname(lockPath), { recursive: true });
+  const token = `${process.pid}.${randomUUID()}`;
+  const start = Date.now();
+  for (; ; ) {
+    let handle;
+    try {
+      handle = await open(lockPath, "wx");
+    } catch (err) {
+      if (!isErrnoException(err) || err.code !== "EEXIST") throw err;
+      try {
+        const st = await stat(lockPath);
+        if (Date.now() - st.mtimeMs > staleMs) {
+          const staleToken = await readFile(lockPath, "utf8").catch(() => null);
+          if (staleToken !== null) {
+            await unlinkIfToken(lockPath, staleToken);
+          }
+          continue;
+        }
+      } catch {
+        continue;
+      }
+      if (Date.now() - start > maxWaitMs) {
+        throw new Error(`withFileLock: timed out acquiring ${lockPath} after ${maxWaitMs}ms`);
+      }
+      await sleep(retryDelayMs);
+      continue;
+    }
+    try {
+      await handle.writeFile(token, "utf8");
+      await handle.close();
+      return await fn();
+    } finally {
+      await unlinkIfToken(lockPath, token);
+    }
+  }
+}
+async function unlinkIfToken(lockPath, expected) {
+  try {
+    const current = await readFile(lockPath, "utf8");
+    if (current === expected) {
+      await unlink(lockPath).catch(() => void 0);
+    }
+  } catch {
+  }
+}
+function createLedgerWriteQueue() {
+  const chains = /* @__PURE__ */ new Map();
+  async function doAppend(path, line) {
+    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) {
+      return enqueue(path, () => doAppend(path, line));
+    },
+    runExclusive(path, fn) {
+      return enqueue(path, fn);
+    }
+  };
+}
+
+export {
+  atomicWriteText,
+  atomicWriteJson,
+  withFileLock,
+  createLedgerWriteQueue
+};

package/dist/{chunk-QSD4PN4W.js → chunk-KUYCTRFI.js}

@@ -390,6 +390,11 @@ var enMessages = {
   "doctor.check.counter_desync.message.plural": "{count} knowledge counters desynced from observed stable_ids. {counterPath} = {current} but observed {observedId}. Run `fabric doctor --fix` to bump counters.",
   "doctor.check.counter_desync.remediation": "Run `fabric doctor --fix` to bump agents.meta.json counters to the maximum observed counter value.",
   "doctor.check.counter_desync.ok": "agents.meta.json counters envelope is consistent with observed stable_ids.",
+  "doctor.check.store_counter_drift.name": "Store counter drift",
+  "doctor.check.store_counter_drift.message.singular": "{count} store counter is below its on-disk max stable_id ({detail}). The next allocation in that store would re-mint an existing id. Run `fabric doctor --fix` to floor the store counters.json.",
+  "doctor.check.store_counter_drift.message.plural": "{count} store counters are below their on-disk max stable_id ({detail}). The next allocation in those stores would re-mint an existing id. Run `fabric doctor --fix` to floor the store counters.json.",
+  "doctor.check.store_counter_drift.remediation": "Run `fabric doctor --fix` to floor each store's counters.json at the highest stable_id observed on disk (the floor never lowers \u2014 KT-DEC-0004 monotonic invariant).",
+  "doctor.check.store_counter_drift.ok": "Every read-set store's counters.json is floored at its on-disk max stable_id.",
   "doctor.check.preexisting_root_files.name": "Preexisting root markdown",
   "doctor.check.preexisting_root_files.ok": "No CLAUDE.md or AGENTS.md detected at project root.",
   "doctor.check.preexisting_root_files.message": "{files} detected at project root. These root files are not auto-loaded by Fabric MCP.",
@@ -529,6 +534,11 @@ var enMessages = {
   "doctor.check.knowledge_summary_opaque.ok": "{opaque}/{total} entries have summary == stable_id; opacity ratio is within the healthy band.",
   "doctor.check.knowledge_summary_opaque.message.warn": "{opaque}/{total} entries ({pct}%) have description.summary equal to their stable_id, exceeding the {threshold}% threshold. Narrow-hint output renders as `<id> \xB7 <id>`, signaling nothing useful, and AI clients skip the fetch. First opaque: {sample}.",
   "doctor.check.knowledge_summary_opaque.remediation": "Run the fabric-review skill to rewrite opaque summaries with one short human-readable phrase. The rc.35 hint renderer fallback (TASK-06) will also synthesize a temporary summary from the entry's `## Summary` section.",
+  // v2.2 W4 (G-GUARD / A6): store scope lint.
+  "doctor.check.store_scope_lint.name": "Store scope lint",
+  "doctor.check.store_scope_lint.ok": "All read-set store entries carry valid scope metadata (semantic_scope + visibility_store, no personal leak, no dangling project).",
+  "doctor.check.store_scope_lint.message": "{total} store scope issue(s): {breakdown}. e.g. {sample}.",
+  "doctor.check.store_scope_lint.remediation": "Run `fabric store backfill-scope` to add missing semantic_scope/visibility_store; `fabric store re-scope` to fix a dangling project: coordinate; move any personal-scope entry out of a shared store (personal knowledge lives only in your personal store, R5#3).",
   "doctor.check.skill_md_yaml_invalid.name": "Skill markdown YAML",
   "doctor.check.skill_md_yaml_invalid.ok": "All .claude/.codex SKILL.md frontmatter values parse as strict YAML.",
   "doctor.check.skill_md_yaml_invalid.message.singular": "{count} SKILL.md frontmatter value contains an unquoted ': ' that strict YAML parsers reject (Claude Code tolerates it; Codex CLI drops the skill at load). First: {detail}.",
@@ -1413,6 +1423,11 @@ var zhCNMessages = {
   "doctor.check.counter_desync.message.plural": "{count} \u4E2A knowledge counters \u4E0E\u89C2\u6D4B\u5230\u7684 stable_ids \u4E0D\u540C\u6B65\u3002{counterPath} = {current}\uFF0C\u4F46\u68C0\u6D4B\u5230 {observedId}\u3002\u8FD0\u884C `fabric doctor --fix` bump counters\u3002",
   "doctor.check.counter_desync.remediation": "\u8FD0\u884C `fabric doctor --fix` \u5C06 agents.meta.json counters \u63D0\u5347\u5230\u89C2\u6D4B\u5230\u7684\u6700\u5927 counter \u503C\u3002",
   "doctor.check.counter_desync.ok": "agents.meta.json counters envelope \u4E0E\u89C2\u6D4B\u5230\u7684 stable_ids \u4E00\u81F4\u3002",
+  "doctor.check.store_counter_drift.name": "Store counter drift",
+  "doctor.check.store_counter_drift.message.singular": "{count} \u4E2A store counter \u4F4E\u4E8E\u78C1\u76D8\u4E0A\u7684\u6700\u5927 stable_id\uFF08{detail}\uFF09\u3002\u8BE5 store \u4E0B\u4E00\u6B21\u94F8\u53F7\u4F1A\u590D\u7528\u5DF2\u5B58\u5728\u7684 id\u3002\u8FD0\u884C `fabric doctor --fix` \u5C06 store counters.json \u63D0\u5347\u5230\u78C1\u76D8\u6700\u5927\u503C\u3002",
+  "doctor.check.store_counter_drift.message.plural": "{count} \u4E2A store counter \u4F4E\u4E8E\u78C1\u76D8\u4E0A\u7684\u6700\u5927 stable_id\uFF08{detail}\uFF09\u3002\u8FD9\u4E9B store \u4E0B\u4E00\u6B21\u94F8\u53F7\u4F1A\u590D\u7528\u5DF2\u5B58\u5728\u7684 id\u3002\u8FD0\u884C `fabric doctor --fix` \u5C06 store counters.json \u63D0\u5347\u5230\u78C1\u76D8\u6700\u5927\u503C\u3002",
+  "doctor.check.store_counter_drift.remediation": "\u8FD0\u884C `fabric doctor --fix` \u5C06\u6BCF\u4E2A store \u7684 counters.json \u63D0\u5347\uFF08floor\uFF09\u5230\u78C1\u76D8\u4E0A\u89C2\u6D4B\u5230\u7684\u6700\u5927 stable_id\uFF08floor \u53EA\u5347\u4E0D\u964D\u2014\u2014KT-DEC-0004 \u5355\u8C03\u4E0D\u53D8\u91CF\uFF09\u3002",
+  "doctor.check.store_counter_drift.ok": "read-set \u5185\u6BCF\u4E2A store \u7684 counters.json \u90FD\u5DF2 floor \u5230\u78C1\u76D8\u6700\u5927 stable_id\u3002",
   "doctor.check.preexisting_root_files.name": "Preexisting root markdown",
   "doctor.check.preexisting_root_files.ok": "project root \u672A\u68C0\u6D4B\u5230 CLAUDE.md \u6216 AGENTS.md\u3002",
   "doctor.check.preexisting_root_files.message": "project root \u68C0\u6D4B\u5230 {files}\u3002\u8FD9\u4E9B root files \u4E0D\u4F1A\u88AB Fabric MCP \u81EA\u52A8\u52A0\u8F7D\u3002",
@@ -1552,6 +1567,11 @@ var zhCNMessages = {
   "doctor.check.knowledge_summary_opaque.ok": "{opaque}/{total} \u4E2A entry \u7684 summary == stable_id\uFF0C\u6BD4\u4F8B\u5728\u5065\u5EB7\u8303\u56F4\u5185\u3002",
   "doctor.check.knowledge_summary_opaque.message.warn": "{opaque}/{total} \u4E2A entry ({pct}%) \u7684 description.summary \u7B49\u4E8E stable_id\uFF0C\u8D85\u8FC7 {threshold}% \u9608\u503C\u3002narrow hint \u8F93\u51FA\u4F1A\u53D8\u6210 `<id> \xB7 <id>` \u800C\u975E\u771F\u5B9E\u6982\u8981\uFF0CAI \u770B\u4E0D\u5230\u4FE1\u606F\u4F1A\u4E3B\u52A8\u8DF3\u8FC7 fetch\u3002\u9996\u6279\u4E0D\u900F\u660E: {sample}\u3002",
   "doctor.check.knowledge_summary_opaque.remediation": "\u8C03 fabric-review skill \u91CD\u5199\u4E0D\u900F\u660E summary \u4E3A\u4E00\u53E5\u4EBA\u7C7B\u53EF\u8BFB\u7684\u6982\u8981\u3002rc.35 hint renderer fallback (TASK-06) \u4E5F\u4F1A\u4ECE entry \u7684 `## Summary` \u6BB5\u81EA\u52A8\u5408\u6210\u4E34\u65F6 summary\u3002",
+  // v2.2 W4 (G-GUARD / A6): store scope lint。
+  "doctor.check.store_scope_lint.name": "Store scope lint",
+  "doctor.check.store_scope_lint.ok": "read-set \u5185\u6240\u6709 store \u6761\u76EE scope \u5143\u6570\u636E\u9F50\u5907(semantic_scope + visibility_store,\u65E0 personal \u6CC4\u6F0F,\u65E0 dangling project)\u3002",
+  "doctor.check.store_scope_lint.message": "{total} \u4E2A store scope \u95EE\u9898: {breakdown}\u3002\u4F8B\u5982 {sample}\u3002",
+  "doctor.check.store_scope_lint.remediation": "\u8C03 `fabric store backfill-scope` \u8865\u7F3A\u5931\u7684 semantic_scope/visibility_store;`fabric store re-scope` \u4FEE dangling \u7684 project: \u5750\u6807;\u628A personal-scope \u6761\u76EE\u79FB\u51FA shared store(personal \u77E5\u8BC6\u53EA\u5B58\u4E2A\u4EBA store,R5#3)\u3002",
   "doctor.check.skill_md_yaml_invalid.name": "Skill markdown YAML",
   "doctor.check.skill_md_yaml_invalid.ok": "\u6240\u6709 .claude/.codex SKILL.md frontmatter values \u90FD\u80FD\u6309 strict YAML \u89E3\u6790\u3002",
   "doctor.check.skill_md_yaml_invalid.message.singular": "{count} \u4E2A SKILL.md frontmatter value \u5305\u542B\u672A\u52A0\u5F15\u53F7\u7684 ': '\uFF0Cstrict YAML parsers \u4F1A\u62D2\u7EDD\uFF08Claude Code tolerates it\uFF1BCodex CLI drops the skill at load\uFF09\u3002\u9996\u4E2A\uFF1A{detail}\u3002",

package/dist/{chunk-VW5QGPIN.js → chunk-VDSM73PK.js}

@@ -39,6 +39,9 @@ var GenericConfigError = class extends ConfigError {
 var StoreWriteTargetUnresolvedError = class extends ConfigError {
   code = "store_write_target_unresolved";
 };
+var PersonalScopeLeakError = class extends ConfigError {
+  code = "personal_scope_leak";
+};
 
 // src/errors/rule-error.ts
 var RuleError = class extends FabricError {
@@ -82,6 +85,7 @@ export {
   ConfigPathInvalidError,
   GenericConfigError,
   StoreWriteTargetUnresolvedError,
+  PersonalScopeLeakError,
   RuleError,
   RuleValidationError,
   IOFabricError,

package/dist/errors/index.d.ts

@@ -31,6 +31,9 @@ declare class GenericConfigError extends ConfigError {
 declare class StoreWriteTargetUnresolvedError extends ConfigError {
     readonly code = "store_write_target_unresolved";
 }
+declare class PersonalScopeLeakError extends ConfigError {
+    readonly code = "personal_scope_leak";
+}
 
 declare abstract class RuleError extends FabricError {
     readonly httpStatus: number;
@@ -65,4 +68,4 @@ declare class InitFrameworkUnknownError extends InitError {
     readonly code = "init_framework_unknown";
 }
 
-export { ConfigError, ConfigPathInvalidError, FabricError, GenericConfigError, GenericIOError, IOFabricError, InitError, InitFrameworkUnknownError, MCPError, McpToolError, PathEscapeError, RuleError, RuleValidationError, StoreWriteTargetUnresolvedError };
+export { ConfigError, ConfigPathInvalidError, FabricError, GenericConfigError, GenericIOError, IOFabricError, InitError, InitFrameworkUnknownError, MCPError, McpToolError, PathEscapeError, PersonalScopeLeakError, RuleError, RuleValidationError, StoreWriteTargetUnresolvedError };

package/dist/errors/index.js

@@ -10,10 +10,11 @@ import {
   MCPError,
   McpToolError,
   PathEscapeError,
+  PersonalScopeLeakError,
   RuleError,
   RuleValidationError,
   StoreWriteTargetUnresolvedError
-} from "../chunk-VW5QGPIN.js";
+} from "../chunk-VDSM73PK.js";
 export {
   ConfigError,
   ConfigPathInvalidError,
@@ -26,6 +27,7 @@ export {
   MCPError,
   McpToolError,
   PathEscapeError,
+  PersonalScopeLeakError,
   RuleError,
   RuleValidationError,
   StoreWriteTargetUnresolvedError

package/dist/i18n/index.js

@@ -7,7 +7,7 @@ import {
   normalizeLocale,
   resolveFabricLocale,
   zhCNMessages
-} from "../chunk-QSD4PN4W.js";
+} from "../chunk-KUYCTRFI.js";
 export {
   PROTECTED_TOKENS,
   createTranslator,

package/dist/{index-Dm4IJWwB.d.ts → index-BqA89S9q.d.ts}

@@ -15,6 +15,7 @@ interface RuleDescription {
     knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes";
     maturity?: "draft" | "verified" | "proven";
     knowledge_layer?: "personal" | "team";
+    semantic_scope?: string;
     layer_reason?: string;
     created_at?: string;
     tags?: string[];
@@ -149,6 +150,7 @@ declare const fabricConfigSchema: z.ZodObject<{
         suggested_remote?: string | undefined;
     }>, "many">>;
     active_write_store: z.ZodOptional<z.ZodString>;
+    active_project: z.ZodOptional<z.ZodString>;
     scanIgnores: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     audit_mode: z.ZodOptional<z.ZodEnum<["strict", "warn", "off"]>>;
     mcpPayloadLimits: z.ZodOptional<z.ZodObject<{
@@ -265,6 +267,7 @@ declare const fabricConfigSchema: z.ZodObject<{
         suggested_remote?: string | undefined;
     }[] | undefined;
     active_write_store?: string | undefined;
+    active_project?: string | undefined;
     scanIgnores?: string[] | undefined;
     audit_mode?: "strict" | "warn" | "off" | undefined;
     mcpPayloadLimits?: {
@@ -295,6 +298,7 @@ declare const fabricConfigSchema: z.ZodObject<{
         suggested_remote?: string | undefined;
     }[] | undefined;
     active_write_store?: string | undefined;
+    active_project?: string | undefined;
     scanIgnores?: string[] | undefined;
     audit_mode?: "strict" | "warn" | "off" | undefined;
     mcpPayloadLimits?: {

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { A as AgentsMetaNode, a as AgentsIdentitySource, b as AgentsLayer, c as AgentsTopologyType, H as HumanLockEntry, f as fabricConfigSchema, F as FabricConfig, d as AgentsMeta, L as LedgerEntry } from './index-Dm4IJWwB.js';
-export { e as AgentsActivationTier, g as AgentsMetaCountersEnvelope, h as AgentsMetaKnowledgeTypeCounters, i as AgentsMetaNodeActivation, j as AiLedgerEntry, k as AuditMode, C as ClientPaths, D as DefaultLayerFilter, l as FabricLanguage, m as HumanLedgerEntry, M as McpPayloadLimits, R as RuleDescription, n as RuleDescriptionIndexItem, o as auditModeSchema, p as clientPathsSchema, q as defaultLayerFilterSchema, r as fabricLanguageSchema, s as mcpPayloadLimitsSchema, t as planContextTopKSchema, u as selectionTokenTtlMsSchema } from './index-Dm4IJWwB.js';
+import { A as AgentsMetaNode, a as AgentsIdentitySource, b as AgentsLayer, c as AgentsTopologyType, H as HumanLockEntry, f as fabricConfigSchema, F as FabricConfig, d as AgentsMeta, L as LedgerEntry } from './index-BqA89S9q.js';
+export { e as AgentsActivationTier, g as AgentsMetaCountersEnvelope, h as AgentsMetaKnowledgeTypeCounters, i as AgentsMetaNodeActivation, j as AiLedgerEntry, k as AuditMode, C as ClientPaths, D as DefaultLayerFilter, l as FabricLanguage, m as HumanLedgerEntry, M as McpPayloadLimits, R as RuleDescription, n as RuleDescriptionIndexItem, o as auditModeSchema, p as clientPathsSchema, q as defaultLayerFilterSchema, r as fabricLanguageSchema, s as mcpPayloadLimitsSchema, t as planContextTopKSchema, u as selectionTokenTtlMsSchema } from './index-BqA89S9q.js';
 import { Translator } from './i18n/index.js';
 export { Locale, Messages, PROTECTED_TOKENS, ProtectedToken, TranslationKey, createTranslator, defaultMessages, detectNodeLocale, enMessages, normalizeLocale, resolveFabricLocale, zhCNMessages } from './i18n/index.js';
 import { z } from 'zod';
@@ -1413,6 +1413,49 @@ declare const storeIdentitySchema: z.ZodObject<{
     allowed_scopes?: string[] | undefined;
 }>;
 type StoreIdentity = z.infer<typeof storeIdentitySchema>;
+declare const STORE_PROJECT_ID_PATTERN: RegExp;
+declare const storeProjectSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    created_at: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    created_at: string;
+    id: string;
+    name?: string | undefined;
+}, {
+    created_at: string;
+    id: string;
+    name?: string | undefined;
+}>;
+type StoreProject = z.infer<typeof storeProjectSchema>;
+declare const storeProjectsFileSchema: z.ZodObject<{
+    projects: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        created_at: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        created_at: string;
+        id: string;
+        name?: string | undefined;
+    }, {
+        created_at: string;
+        id: string;
+        name?: string | undefined;
+    }>, "many">>;
+}, "strict", z.ZodTypeAny, {
+    projects: {
+        created_at: string;
+        id: string;
+        name?: string | undefined;
+    }[];
+}, {
+    projects?: {
+        created_at: string;
+        id: string;
+        name?: string | undefined;
+    }[] | undefined;
+}>;
+type StoreProjectsFile = z.infer<typeof storeProjectsFileSchema>;
 declare const requiredStoreEntrySchema: z.ZodObject<{
     id: z.ZodString;
     suggested_remote: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodLiteral<"$personal">]>>;
@@ -1427,6 +1470,8 @@ type RequiredStoreEntry = z.infer<typeof requiredStoreEntrySchema>;
 declare const STORE_KNOWLEDGE_TYPE_DIRS: readonly ["models", "decisions", "guidelines", "pitfalls", "processes"];
 declare const STORE_LAYOUT: {
     readonly identityFile: "store.json";
+    readonly projectsFile: "projects.json";
+    readonly countersFile: "counters.json";
     readonly knowledgeDir: "knowledge";
     readonly bindingsDir: "bindings";
     readonly stateDir: "state";
@@ -3054,8 +3099,42 @@ interface MountedStoreDir {
 }
 declare function listStoreKnowledge(store: MountedStoreDir): StoreKnowledgeRef[];
 declare function readKnowledgeAcrossStores(stores: MountedStoreDir[]): StoreKnowledgeRef[];
+declare function readStoreProjects(storeDir: string): StoreProject[];
+declare function storeHasProject(storeDir: string, id: string): boolean;
+declare function addStoreProject(storeDir: string, project: StoreProject): StoreProject[];
 declare function aggregatePendingAcrossStores(stores: MountedStoreDir[]): StoreKnowledgeRef[];
 
+declare function storeCountersPath(storeDir: string): string;
+declare function readStoreCounters(storeDir: string): AgentsMetaCounters;
+/**
+ * Allocate the next stable_id for `(layer, type)` in the given store and persist
+ * the advanced counter to `<storeDir>/counters.json`.
+ *
+ * The read → mutate → atomic-write is guarded by a cross-process advisory lock
+ * keyed on the counters path so two concurrent allocate calls (two windows
+ * approving knowledge into the same store at once) can never read the same
+ * counter and mint a duplicate id (the same invariant the retired
+ * KnowledgeIdAllocator held over agents.meta).
+ */
+declare function allocateStoreKnowledgeId(layer: Layer, type: KnowledgeType, storeDir: string): Promise<StableId>;
+/**
+ * Floor a store's `counters.json` at the highest stable_id actually present on
+ * disk, persisting and returning the reconciled envelope.
+ *
+ * This is the producer↔consumer bridge (W4 F1): a BULK import (`store migrate`)
+ * writes entries whose ids were minted elsewhere (collision-remapped from
+ * disk-max) WITHOUT advancing this store's counters.json. Without reconciliation
+ * the next `allocateStoreKnowledgeId` would start from a stale zero and re-mint
+ * an already-present id. Flooring is also the self-heal `doctor` runs to repair a
+ * drifted ledger.
+ *
+ * Floor — never lower — preserves the monotonic invariant (KT-DEC-0004): a slot
+ * already advanced past disk-max (because the highest entry was deleted) keeps
+ * its higher value. Sync write (no lock) because the only callers run in
+ * exclusive one-shot contexts (post-migrate CLI step, `doctor --fix`).
+ */
+declare function reconcileStoreCounters(storeDir: string): AgentsMetaCounters;
+
 declare function resolveGlobalRoot(): string;
 declare function globalConfigPath(globalRoot?: string): string;
 declare function loadGlobalConfig(globalRoot?: string): GlobalConfig | null;
@@ -4054,14 +4133,14 @@ declare const initContextDomainGroupSchema: z.ZodObject<{
     topology_type: z.ZodOptional<z.ZodEnum<["mirror", "cross-cutting"]>>;
     target_path: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    paths: string[];
     name: string;
+    paths: string[];
     summary?: string | undefined;
     target_path?: string | undefined;
     topology_type?: "mirror" | "cross-cutting" | undefined;
 }, {
-    paths: string[];
     name: string;
+    paths: string[];
     summary?: string | undefined;
     target_path?: string | undefined;
     topology_type?: "mirror" | "cross-cutting" | undefined;
@@ -4156,14 +4235,14 @@ declare const initContextSchema: z.ZodObject<{
         topology_type: z.ZodOptional<z.ZodEnum<["mirror", "cross-cutting"]>>;
         target_path: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        paths: string[];
         name: string;
+        paths: string[];
         summary?: string | undefined;
         target_path?: string | undefined;
         topology_type?: "mirror" | "cross-cutting" | undefined;
     }, {
-        paths: string[];
         name: string;
+        paths: string[];
         summary?: string | undefined;
         target_path?: string | undefined;
         topology_type?: "mirror" | "cross-cutting" | undefined;
@@ -4209,8 +4288,8 @@ declare const initContextSchema: z.ZodObject<{
         }[] | undefined;
     }[];
     domain_groups: {
-        paths: string[];
         name: string;
+        paths: string[];
         summary?: string | undefined;
         target_path?: string | undefined;
         topology_type?: "mirror" | "cross-cutting" | undefined;
@@ -4244,8 +4323,8 @@ declare const initContextSchema: z.ZodObject<{
         }[] | undefined;
     }[];
     domain_groups: {
-        paths: string[];
         name: string;
+        paths: string[];
         summary?: string | undefined;
         target_path?: string | undefined;
         topology_type?: "mirror" | "cross-cutting" | undefined;
@@ -11361,4 +11440,4 @@ declare function resolveRetrievalBudget(overrides?: RetrievalBudgetOverrides): R
 /** Exposed for tests / introspection — the raw profile table. */
 declare function retrievalBudgetProfile(profile: RetrievalBudgetProfile): ResolvedRetrievalBudget;
 
-export { AGENTS_META_IDENTITY_SOURCES, AGENTS_META_LAYERS, AGENTS_META_TOPOLOGY_TYPES, AgentsIdentitySource, AgentsLayer, AgentsMeta, type AgentsMetaCounters, AgentsMetaCountersSchema, AgentsMetaNode, AgentsTopologyType, type AssistantTurnObservedEvent, type BootstrapMarkerMigratedEvent, type CandidateFileEntry, type CandidateFileFamily, type CiteCommitment, type CiteCommitmentOperator, type CiteCommitmentOperatorKind, type CiteContractPolicyActivatedEvent, type CitePolicyActivatedEvent, type CiteTag, type ClaudeHookPathMigratedEvent, type ClaudeSkillPathMigratedEvent, type ClientCapabilitySnapshotEvent, type CodexSkillPathMigratedEvent, type CrossStoreLintInput, type CrossStoreRefViolation, DEFAULT_RETRIEVAL_BUDGET_PROFILE, type DebugBundle, type DebugBundleInput, type DoctorRunEvent, type DriftDetectedEvent, type EditIntentCheckedEvent, type EntryLayer, type EntryScopeMetadata, type EventLedgerEvent, type EventLedgerEventInput, type EventLedgerEventType, type EventLedgerTruncatedEvent, type EventsRotatedEvent, FabricConfig, type FabricConfigSchemaShape, type FabricEvent, type FailureStage, type FailureTrace, type FileMutatedEvent, type FindStoreExecutableViolationsOptions, type ForensicAssertion, type ForensicAssertionConfidence, type ForensicAssertionCoverage, type ForensicAssertionType, type ForensicCodeSample, type ForensicEntryPoint, type ForensicEvidenceAnchor, type ForensicFramework, type ForensicReadme, type ForensicReport, type ForensicSamplingBudget, type ForensicTopology, GLOBAL_BINDINGS_DIR, GLOBAL_REF_PATTERN, GLOBAL_STATE_DIR, type GlobalConfig, type GlobalRef, type GraphEdgeCandidateRequestedEvent, type HookSignalEmittedEvent, type HookSurfaceEmittedEvent, HumanLockEntry, type HumanLockFile, type InitContext, type InitContextDomainGroup, type InitContextFramework, type InitContextInterviewTrailEntry, type InitContextInvariant, type InitContextInvariantConfidenceSnapshot, type InitContextSourceEvidence, type InitScanCompletedEvent, type InitStoreOptions, type InstallDiffAppliedEvent, KNOWLEDGE_TEST_INDEX_SCHEMA_VERSION, KNOWN_SCOPE_PREFIXES, type KnowledgeArchiveAttemptedEvent, type KnowledgeArchivedEvent, type KnowledgeConsumedEvent, type KnowledgeContextPlannedEvent, type KnowledgeDeferredEvent, type KnowledgeDemotedEvent, type KnowledgeDriftDetectedEvent, type KnowledgeEnrichedEvent, type KnowledgeIdRedirectEvent, type KnowledgeLayerChangedEvent, type KnowledgeMetaAutoHealedEvent, type KnowledgePathDangledEvent, type KnowledgePromoteFailedEvent, type KnowledgePromoteStartedEvent, type KnowledgePromotedEvent, type KnowledgeProposedEvent, type KnowledgeProvenance, type KnowledgeRejectedEvent, type KnowledgeScopeDegradedEvent, type KnowledgeSectionsFetchedEvent, type KnowledgeSelectionEvent, type KnowledgeSlugRenamedEvent, type KnowledgeTestIndex, type KnowledgeTestLink, type KnowledgeTestOrphanAnnotation, KnowledgeType, type KnowledgeUnarchivedEvent, Layer, type LedgerAppendedEvent, LedgerEntry, type LlmJudgeRunEvent, type LocalKnowledgeId, type LockApprovedEvent, type LockDriftEvent, MCP_STORE_AWARE_CONTRACTS, MCP_STORE_AWARE_TOOLS, type McpConfigMigratedEvent, type McpEventLedgerEvent, type McpStdioTraceEvent, type McpStoreAwareContract, type McpStoreAwareTool, type MetaReconciledEvent, type MetaReconciledOnStartupEvent, type MetaUpdatedEvent, type MountedStore, type MountedStoreDir, ONBOARD_SLOT_NAMES, ONBOARD_SLOT_TOTAL, type OnboardSlot, PARITY_CLIENTS, PARITY_SURFACES, PERSONAL_SCOPE, PERSONAL_STORE_SENTINEL, PROJECT_ROOT_SIGNALS, type PanelFieldGroup, type PanelFieldMeta, type ParityCapability, type ParityClient, type ParityClientExpectation, type ParityMatrix, type ParitySurface, type ParseCiteLineResult, type ParsedGlobalRef, type PayloadGuardObservedEvent, type PendingAutoArchivedEvent, type PrecompactObservedEvent, type ProjectRootGoldenCase, type ProjectRootResolution, type ProjectRootResolver, type ProjectRootSignal, type ProjectRootSignals, type QualifiedCandidate, type QualifiedIdResolution, REDACTION_PLACEHOLDER_PREFIX, type ReadSetEntry, type ReadSetGoldenCase, type ReapplyCompletedEvent, type RelevanceMigrationRunEvent, type RequiredStoreEntry, type ResolutionCandidate, type ResolutionResult, type ResolutionWarning, type ResolveOptions, type ResolvedBindingsSnapshot, type ResolvedEntry, type ResolvedRetrievalBudget, ResolverNotImplementedError, type RetrievalBudgetOverrides, type RetrievalBudgetProfile, SCOPE_COORDINATE_PATTERN, STORES_ROOT_DIR, STORE_GITIGNORE, STORE_KNOWLEDGE_TYPE_DIRS, STORE_LAYOUT, STORE_PENDING_DIR, STORE_RESOLVER_WARNING_CODES, STORE_UUID_PATTERN, type ScanRecommendationInput, type ScopeCoordinate, type SecretFinding, type ServeLockClearedEvent, type SessionArchiveAttemptedEvent, type SessionEndedEvent, type SkillInvocationCompletedEvent, type SkillInvocationStartedEvent, type SkillPhaseTransitionEvent, type SkillTriggerCandidateEvent, StableId, type StoreAwareEntry, type StoreCounters, type StoreExplain, type StoreIdentity, type StoreKnowledgeRef, type StoreLayout, type StoreReadSet, type StoreResolveInput, type StoreResolver, type StoreResolverWarning, type StoreResolverWarningCode, type StoreVisibility, Translator, UID_SEGMENT_PATTERN, type Uid, type ValidateResult, type WriteBindingsSnapshotOptions, type WriteTarget, type WrittenToStore, addMountedStore, agentsIdentitySourceSchema, agentsLayerSchema, agentsMetaNodeSchema, agentsMetaSchema, agentsTopologyTypeSchema, aggregatePendingAcrossStores, aiLedgerEntrySchema, allocateKnowledgeId, assistantTurnObservedEventSchema, bindRequiredStore, bindingsSnapshotPath, bootstrapMarkerMigratedEventSchema, buildDebugBundle, buildFailureTrace, buildScanRecommendations, buildStoreResolveInput, candidateFileEntrySchema, citeContractPolicyActivatedEventSchema, citePolicyActivatedEventSchema, claudeHookPathMigratedEventSchema, claudeSkillPathMigratedEventSchema, clientCapabilitySnapshotEventSchema, codexSkillPathMigratedEventSchema, createProjectRootResolver, createStoreResolver, defaultAgentsMetaCounters, deriveAgentsMetaIdentitySource, deriveAgentsMetaLayer, deriveAgentsMetaStableId, deriveAgentsMetaTopologyType, detachMountedStore, doctorRunEventSchema, driftDetectedEventSchema, editIntentCheckedEventSchema, entryScopeMetadataSchema, eventLedgerEventSchema, eventLedgerTruncatedEventSchema, eventsRotatedEventSchema, explainStore, fabricConfigSchema, fabricEventSchema, fileMutatedEventSchema, findMountedStore, findStoreExecutableViolations, forensicAssertionCoverageSchema, forensicAssertionSchema, forensicCodeSampleSchema, forensicEntryPointSchema, forensicEvidenceAnchorSchema, forensicFrameworkSchema, forensicReadmeSchema, forensicReportSchema, forensicSamplingBudgetSchema, forensicTopologySchema, formatGlobalRef, getPanelFieldByKey, getPanelFields, globalConfigPath, globalConfigSchema, globalRefSchema, graphEdgeCandidateRequestedEventSchema, hasSecrets, hookSignalEmittedEventSchema, hookSurfaceEmittedEventSchema, humanLedgerEntrySchema, humanLockEntrySchema, humanLockFileSchema, initContextDomainGroupSchema, initContextFrameworkSchema, initContextInterviewTrailEntrySchema, initContextInvariantConfidenceSnapshotSchema, initContextInvariantSchema, initContextSchema, initContextSourceEvidenceSchema, initScanCompletedEventSchema, initStore, installDiffAppliedEventSchema, isKnowledgeStableId, isPersonalLeakIntoSharedStore, isPersonalScope, knowledgeArchiveAttemptedEventSchema, knowledgeArchivedEventSchema, knowledgeConsumedEventSchema, knowledgeContextPlannedEventSchema, knowledgeDeferredEventSchema, knowledgeDemotedEventSchema, knowledgeDriftDetectedEventSchema, knowledgeEnrichedEventSchema, knowledgeIdRedirectEventSchema, knowledgeLayerChangedEventSchema, knowledgeMetaAutoHealedEventSchema, knowledgePathDangledEventSchema, knowledgePromoteFailedEventSchema, knowledgePromoteStartedEventSchema, knowledgePromotedEventSchema, knowledgeProposedEventSchema, knowledgeProvenanceSchema, knowledgeRejectedEventSchema, knowledgeScopeDegradedEventSchema, knowledgeSectionsFetchedEventSchema, knowledgeSelectionEventSchema, knowledgeSlugRenamedEventSchema, knowledgeTestIndexSchema, knowledgeTestLinkSchema, knowledgeTestOrphanAnnotationSchema, knowledgeUnarchivedEventSchema, ledgerAppendedEventSchema, ledgerEntrySchema, lintCrossStoreReferences, listStoreKnowledge, llmJudgeRunEventSchema, loadGlobalConfig, loadProjectConfig, localKnowledgeIdSchema, lockApprovedEventSchema, lockDriftEventSchema, mcpConfigMigratedEventSchema, mcpEventLedgerEventSchema, mcpStdioTraceEventSchema, metaReconciledEventSchema, metaReconciledOnStartupEventSchema, metaUpdatedEventSchema, mountedStoreSchema, normalizeCiteTag, onboardSlotSchema, parityCapabilitySchema, parityClientExpectationSchema, parityClientSchema, parityMatrixSchema, paritySurfaceSchema, parseCiteLine, parseGlobalRef, payloadGuardObservedEventSchema, pendingAutoArchivedEventSchema, precompactObservedEventSchema, projectConfigPath, projectRootGoldenCaseSchema, projectRootGoldenFileSchema, projectRootResolutionSchema, projectRootSignalSchema, projectRootSignalsSchema, readBindingsSnapshot, readKnowledgeAcrossStores, readSetEntrySchema, readSetGoldenCaseSchema, readSetGoldenFileSchema, readStoreIdentity, reapplyCompletedEventSchema, recognizeStoreDir, redactSecrets, relevanceMigrationRunEventSchema, requiredStoreEntrySchema, resolveCandidates, resolveGlobalRoot, resolveRetrievalBudget, resolveStoreQualifiedId, resolvedBindingsSnapshotSchema, retrievalBudgetProfile, ruleDescriptionIndexItemSchema, ruleDescriptionSchema, saveGlobalConfig, saveProjectConfig, scanForSecrets, scopeCoordinateSchema, scopeRoot, scrubRemoteUrl, serveLockClearedEventSchema, sessionArchiveAttemptedEventSchema, sessionEndedEventSchema, skillInvocationCompletedEventSchema, skillInvocationStartedEventSchema, skillPhaseTransitionEventSchema, skillTriggerCandidateEventSchema, storeAwareEntrySchema, storeCountersSchema, storeIdentitySchema, storeKnowledgeTypeDir, storeReadSetSchema, storeRelativePath, storeResolveInputSchema, storeResolverWarningCodeSchema, storeResolverWarningSchema, storeUuidSchema, tokenize, uidSchema, withDerivedAgentsMetaNodeDefaults, writeBindingsSnapshot, writeTargetSchema, writtenToStoreSchema };
+export { AGENTS_META_IDENTITY_SOURCES, AGENTS_META_LAYERS, AGENTS_META_TOPOLOGY_TYPES, AgentsIdentitySource, AgentsLayer, AgentsMeta, type AgentsMetaCounters, AgentsMetaCountersSchema, AgentsMetaNode, AgentsTopologyType, type AssistantTurnObservedEvent, type BootstrapMarkerMigratedEvent, type CandidateFileEntry, type CandidateFileFamily, type CiteCommitment, type CiteCommitmentOperator, type CiteCommitmentOperatorKind, type CiteContractPolicyActivatedEvent, type CitePolicyActivatedEvent, type CiteTag, type ClaudeHookPathMigratedEvent, type ClaudeSkillPathMigratedEvent, type ClientCapabilitySnapshotEvent, type CodexSkillPathMigratedEvent, type CrossStoreLintInput, type CrossStoreRefViolation, DEFAULT_RETRIEVAL_BUDGET_PROFILE, type DebugBundle, type DebugBundleInput, type DoctorRunEvent, type DriftDetectedEvent, type EditIntentCheckedEvent, type EntryLayer, type EntryScopeMetadata, type EventLedgerEvent, type EventLedgerEventInput, type EventLedgerEventType, type EventLedgerTruncatedEvent, type EventsRotatedEvent, FabricConfig, type FabricConfigSchemaShape, type FabricEvent, type FailureStage, type FailureTrace, type FileMutatedEvent, type FindStoreExecutableViolationsOptions, type ForensicAssertion, type ForensicAssertionConfidence, type ForensicAssertionCoverage, type ForensicAssertionType, type ForensicCodeSample, type ForensicEntryPoint, type ForensicEvidenceAnchor, type ForensicFramework, type ForensicReadme, type ForensicReport, type ForensicSamplingBudget, type ForensicTopology, GLOBAL_BINDINGS_DIR, GLOBAL_REF_PATTERN, GLOBAL_STATE_DIR, type GlobalConfig, type GlobalRef, type GraphEdgeCandidateRequestedEvent, type HookSignalEmittedEvent, type HookSurfaceEmittedEvent, HumanLockEntry, type HumanLockFile, type InitContext, type InitContextDomainGroup, type InitContextFramework, type InitContextInterviewTrailEntry, type InitContextInvariant, type InitContextInvariantConfidenceSnapshot, type InitContextSourceEvidence, type InitScanCompletedEvent, type InitStoreOptions, type InstallDiffAppliedEvent, KNOWLEDGE_TEST_INDEX_SCHEMA_VERSION, KNOWN_SCOPE_PREFIXES, type KnowledgeArchiveAttemptedEvent, type KnowledgeArchivedEvent, type KnowledgeConsumedEvent, type KnowledgeContextPlannedEvent, type KnowledgeDeferredEvent, type KnowledgeDemotedEvent, type KnowledgeDriftDetectedEvent, type KnowledgeEnrichedEvent, type KnowledgeIdRedirectEvent, type KnowledgeLayerChangedEvent, type KnowledgeMetaAutoHealedEvent, type KnowledgePathDangledEvent, type KnowledgePromoteFailedEvent, type KnowledgePromoteStartedEvent, type KnowledgePromotedEvent, type KnowledgeProposedEvent, type KnowledgeProvenance, type KnowledgeRejectedEvent, type KnowledgeScopeDegradedEvent, type KnowledgeSectionsFetchedEvent, type KnowledgeSelectionEvent, type KnowledgeSlugRenamedEvent, type KnowledgeTestIndex, type KnowledgeTestLink, type KnowledgeTestOrphanAnnotation, KnowledgeType, type KnowledgeUnarchivedEvent, Layer, type LedgerAppendedEvent, LedgerEntry, type LlmJudgeRunEvent, type LocalKnowledgeId, type LockApprovedEvent, type LockDriftEvent, MCP_STORE_AWARE_CONTRACTS, MCP_STORE_AWARE_TOOLS, type McpConfigMigratedEvent, type McpEventLedgerEvent, type McpStdioTraceEvent, type McpStoreAwareContract, type McpStoreAwareTool, type MetaReconciledEvent, type MetaReconciledOnStartupEvent, type MetaUpdatedEvent, type MountedStore, type MountedStoreDir, ONBOARD_SLOT_NAMES, ONBOARD_SLOT_TOTAL, type OnboardSlot, PARITY_CLIENTS, PARITY_SURFACES, PERSONAL_SCOPE, PERSONAL_STORE_SENTINEL, PROJECT_ROOT_SIGNALS, type PanelFieldGroup, type PanelFieldMeta, type ParityCapability, type ParityClient, type ParityClientExpectation, type ParityMatrix, type ParitySurface, type ParseCiteLineResult, type ParsedGlobalRef, type PayloadGuardObservedEvent, type PendingAutoArchivedEvent, type PrecompactObservedEvent, type ProjectRootGoldenCase, type ProjectRootResolution, type ProjectRootResolver, type ProjectRootSignal, type ProjectRootSignals, type QualifiedCandidate, type QualifiedIdResolution, REDACTION_PLACEHOLDER_PREFIX, type ReadSetEntry, type ReadSetGoldenCase, type ReapplyCompletedEvent, type RelevanceMigrationRunEvent, type RequiredStoreEntry, type ResolutionCandidate, type ResolutionResult, type ResolutionWarning, type ResolveOptions, type ResolvedBindingsSnapshot, type ResolvedEntry, type ResolvedRetrievalBudget, ResolverNotImplementedError, type RetrievalBudgetOverrides, type RetrievalBudgetProfile, SCOPE_COORDINATE_PATTERN, STORES_ROOT_DIR, STORE_GITIGNORE, STORE_KNOWLEDGE_TYPE_DIRS, STORE_LAYOUT, STORE_PENDING_DIR, STORE_PROJECT_ID_PATTERN, STORE_RESOLVER_WARNING_CODES, STORE_UUID_PATTERN, type ScanRecommendationInput, type ScopeCoordinate, type SecretFinding, type ServeLockClearedEvent, type SessionArchiveAttemptedEvent, type SessionEndedEvent, type SkillInvocationCompletedEvent, type SkillInvocationStartedEvent, type SkillPhaseTransitionEvent, type SkillTriggerCandidateEvent, StableId, type StoreAwareEntry, type StoreCounters, type StoreExplain, type StoreIdentity, type StoreKnowledgeRef, type StoreLayout, type StoreProject, type StoreProjectsFile, type StoreReadSet, type StoreResolveInput, type StoreResolver, type StoreResolverWarning, type StoreResolverWarningCode, type StoreVisibility, Translator, UID_SEGMENT_PATTERN, type Uid, type ValidateResult, type WriteBindingsSnapshotOptions, type WriteTarget, type WrittenToStore, addMountedStore, addStoreProject, agentsIdentitySourceSchema, agentsLayerSchema, agentsMetaNodeSchema, agentsMetaSchema, agentsTopologyTypeSchema, aggregatePendingAcrossStores, aiLedgerEntrySchema, allocateKnowledgeId, allocateStoreKnowledgeId, assistantTurnObservedEventSchema, bindRequiredStore, bindingsSnapshotPath, bootstrapMarkerMigratedEventSchema, buildDebugBundle, buildFailureTrace, buildScanRecommendations, buildStoreResolveInput, candidateFileEntrySchema, citeContractPolicyActivatedEventSchema, citePolicyActivatedEventSchema, claudeHookPathMigratedEventSchema, claudeSkillPathMigratedEventSchema, clientCapabilitySnapshotEventSchema, codexSkillPathMigratedEventSchema, createProjectRootResolver, createStoreResolver, defaultAgentsMetaCounters, deriveAgentsMetaIdentitySource, deriveAgentsMetaLayer, deriveAgentsMetaStableId, deriveAgentsMetaTopologyType, detachMountedStore, doctorRunEventSchema, driftDetectedEventSchema, editIntentCheckedEventSchema, entryScopeMetadataSchema, eventLedgerEventSchema, eventLedgerTruncatedEventSchema, eventsRotatedEventSchema, explainStore, fabricConfigSchema, fabricEventSchema, fileMutatedEventSchema, findMountedStore, findStoreExecutableViolations, forensicAssertionCoverageSchema, forensicAssertionSchema, forensicCodeSampleSchema, forensicEntryPointSchema, forensicEvidenceAnchorSchema, forensicFrameworkSchema, forensicReadmeSchema, forensicReportSchema, forensicSamplingBudgetSchema, forensicTopologySchema, formatGlobalRef, getPanelFieldByKey, getPanelFields, globalConfigPath, globalConfigSchema, globalRefSchema, graphEdgeCandidateRequestedEventSchema, hasSecrets, hookSignalEmittedEventSchema, hookSurfaceEmittedEventSchema, humanLedgerEntrySchema, humanLockEntrySchema, humanLockFileSchema, initContextDomainGroupSchema, initContextFrameworkSchema, initContextInterviewTrailEntrySchema, initContextInvariantConfidenceSnapshotSchema, initContextInvariantSchema, initContextSchema, initContextSourceEvidenceSchema, initScanCompletedEventSchema, initStore, installDiffAppliedEventSchema, isKnowledgeStableId, isPersonalLeakIntoSharedStore, isPersonalScope, knowledgeArchiveAttemptedEventSchema, knowledgeArchivedEventSchema, knowledgeConsumedEventSchema, knowledgeContextPlannedEventSchema, knowledgeDeferredEventSchema, knowledgeDemotedEventSchema, knowledgeDriftDetectedEventSchema, knowledgeEnrichedEventSchema, knowledgeIdRedirectEventSchema, knowledgeLayerChangedEventSchema, knowledgeMetaAutoHealedEventSchema, knowledgePathDangledEventSchema, knowledgePromoteFailedEventSchema, knowledgePromoteStartedEventSchema, knowledgePromotedEventSchema, knowledgeProposedEventSchema, knowledgeProvenanceSchema, knowledgeRejectedEventSchema, knowledgeScopeDegradedEventSchema, knowledgeSectionsFetchedEventSchema, knowledgeSelectionEventSchema, knowledgeSlugRenamedEventSchema, knowledgeTestIndexSchema, knowledgeTestLinkSchema, knowledgeTestOrphanAnnotationSchema, knowledgeUnarchivedEventSchema, ledgerAppendedEventSchema, ledgerEntrySchema, lintCrossStoreReferences, listStoreKnowledge, llmJudgeRunEventSchema, loadGlobalConfig, loadProjectConfig, localKnowledgeIdSchema, lockApprovedEventSchema, lockDriftEventSchema, mcpConfigMigratedEventSchema, mcpEventLedgerEventSchema, mcpStdioTraceEventSchema, metaReconciledEventSchema, metaReconciledOnStartupEventSchema, metaUpdatedEventSchema, mountedStoreSchema, normalizeCiteTag, onboardSlotSchema, parityCapabilitySchema, parityClientExpectationSchema, parityClientSchema, parityMatrixSchema, paritySurfaceSchema, parseCiteLine, parseGlobalRef, payloadGuardObservedEventSchema, pendingAutoArchivedEventSchema, precompactObservedEventSchema, projectConfigPath, projectRootGoldenCaseSchema, projectRootGoldenFileSchema, projectRootResolutionSchema, projectRootSignalSchema, projectRootSignalsSchema, readBindingsSnapshot, readKnowledgeAcrossStores, readSetEntrySchema, readSetGoldenCaseSchema, readSetGoldenFileSchema, readStoreCounters, readStoreIdentity, readStoreProjects, reapplyCompletedEventSchema, recognizeStoreDir, reconcileStoreCounters, redactSecrets, relevanceMigrationRunEventSchema, requiredStoreEntrySchema, resolveCandidates, resolveGlobalRoot, resolveRetrievalBudget, resolveStoreQualifiedId, resolvedBindingsSnapshotSchema, retrievalBudgetProfile, ruleDescriptionIndexItemSchema, ruleDescriptionSchema, saveGlobalConfig, saveProjectConfig, scanForSecrets, scopeCoordinateSchema, scopeRoot, scrubRemoteUrl, serveLockClearedEventSchema, sessionArchiveAttemptedEventSchema, sessionEndedEventSchema, skillInvocationCompletedEventSchema, skillInvocationStartedEventSchema, skillPhaseTransitionEventSchema, skillTriggerCandidateEventSchema, storeAwareEntrySchema, storeCountersPath, storeCountersSchema, storeHasProject, storeIdentitySchema, storeKnowledgeTypeDir, storeProjectSchema, storeProjectsFileSchema, storeReadSetSchema, storeRelativePath, storeResolveInputSchema, storeResolverWarningCodeSchema, storeResolverWarningSchema, storeUuidSchema, tokenize, uidSchema, withDerivedAgentsMetaNodeDefaults, writeBindingsSnapshot, writeTargetSchema, writtenToStoreSchema };

package/dist/index.js

@@ -1,4 +1,12 @@
-import "./chunk-LXNCAKJZ.js";
+import {
+  BOOTSTRAP_CANONICAL,
+  BOOTSTRAP_MARKER_BEGIN,
+  BOOTSTRAP_MARKER_END,
+  BOOTSTRAP_REGEX,
+  LEGACY_KB_MARKER_BEGIN,
+  LEGACY_KB_MARKER_END,
+  LEGACY_KB_REGEX
+} from "./chunk-AFT7DB4P.js";
 import {
   PROTECTED_TOKENS,
   createTranslator,
@@ -8,7 +16,11 @@ import {
   normalizeLocale,
   resolveFabricLocale,
   zhCNMessages
-} from "./chunk-QSD4PN4W.js";
+} from "./chunk-KUYCTRFI.js";
+import {
+  atomicWriteJson,
+  withFileLock
+} from "./chunk-4N6DMOOW.js";
 import {
   FabExtractKnowledgeInputSchema,
   FabExtractKnowledgeInputShape,
@@ -57,15 +69,7 @@ import {
   recallOutputSchema,
   structuredWarningSchema
 } from "./chunk-355LUDLW.js";
-import {
-  BOOTSTRAP_CANONICAL,
-  BOOTSTRAP_MARKER_BEGIN,
-  BOOTSTRAP_MARKER_END,
-  BOOTSTRAP_REGEX,
-  LEGACY_KB_MARKER_BEGIN,
-  LEGACY_KB_MARKER_END,
-  LEGACY_KB_REGEX
-} from "./chunk-AFT7DB4P.js";
+import "./chunk-LXNCAKJZ.js";
 
 // src/schemas/agents-meta.ts
 import { z } from "zod";
@@ -358,6 +362,18 @@ var storeIdentitySchema = z5.object({
   // time in P2). Open coordinate strings — see schemas/scope.ts.
   allowed_scopes: z5.array(z5.string()).optional()
 }).strict();
+var STORE_PROJECT_ID_PATTERN = /^[a-z0-9_-]+$/u;
+var storeProjectSchema = z5.object({
+  // Single scope segment forming the `project:<id>` coordinate. Immutable.
+  id: z5.string().regex(STORE_PROJECT_ID_PATTERN, "project id must be a single lowercase [a-z0-9_-] segment"),
+  // Optional human-facing label surfaced in `store project list`.
+  name: z5.string().optional(),
+  // ISO-8601. When the project was first registered in this store.
+  created_at: z5.string()
+}).strict();
+var storeProjectsFileSchema = z5.object({
+  projects: z5.array(storeProjectSchema).default([])
+}).strict();
 var requiredStoreEntrySchema = z5.object({
   id: z5.string().min(1),
   suggested_remote: z5.union([z5.string().min(1), z5.literal(PERSONAL_STORE_SENTINEL)]).optional()
@@ -371,6 +387,16 @@ var STORE_KNOWLEDGE_TYPE_DIRS = [
 ];
 var STORE_LAYOUT = {
   identityFile: "store.json",
+  // Store-internal project registry (W1/A2). Committed parallel to store.json.
+  projectsFile: "projects.json",
+  // v2.2 W4 (agents.meta decolo) — per-store monotonic stable_id counters.
+  // COMMITTED parallel to store.json/projects.json (NOT gitignored like the
+  // derived agents.meta) because the counter ledger is non-derivable state that
+  // must travel with the store on clone: a fresh clone rebuilding from disk-max
+  // would re-mint a deleted entry's id and corrupt cite history (KT-DEC-0004
+  // monotonic invariant). Replaces the retired co-location
+  // <projectRoot>/.fabric/agents.meta.json#counters.
+  countersFile: "counters.json",
   knowledgeDir: "knowledge",
   bindingsDir: "bindings",
   stateDir: "state"
@@ -455,6 +481,15 @@ var fabricConfigSchema = z6.object({
   // activeWriteAlias. Absent → no active write store yet. Personal-scope
   // writes always target the implicit personal store regardless (R5#3).
   active_write_store: z6.string().optional(),
+  // v2.1 global-refactor (W1/A2 — store project registry): the project this repo
+  // currently participates in, as the SINGLE scope segment forming the
+  // `project:<id>` coordinate (schemas/scope.ts). Set by `store bind --project
+  // <id>` (validated against the bound store's projects.json). Drives:
+  //   - write: project-scoped writes get `semantic_scope: project:<active_project>`.
+  //   - recall: keep `project:<active_project>` + non-project coords, drop other
+  //     `project:*` entries (G-FILTER).
+  // Absent → the repo has no project binding; recall does not project-filter.
+  active_project: z6.string().optional(),
   // rc.17 (R-cut): the dev/test fixture-path config field was removed
   // end-to-end. The `EXTERNAL_FIXTURE_PATH` env var is now the sole source
   // consumed by `resolveDevMode()`. No z.preprocess alias — pre-rc.17
@@ -1491,7 +1526,7 @@ function resolveCandidates(candidates, options = {}) {
 
 // src/store/core.ts
 import { execFileSync } from "child_process";
-import { existsSync as existsSync2, mkdirSync, readdirSync as readdirSync2, writeFileSync } from "fs";
+import { existsSync as existsSync2, mkdirSync, readdirSync as readdirSync2, readFileSync as readFileSync2, writeFileSync } from "fs";
 import { join as join2 } from "path";
 var STORE_PENDING_DIR = "pending";
 var STORE_GITIGNORE = [
@@ -1546,6 +1581,38 @@ function listStoreKnowledge(store) {
 function readKnowledgeAcrossStores(stores) {
   return stores.flatMap((store) => listStoreKnowledge(store));
 }
+function storeProjectsPath(storeDir) {
+  return join2(storeDir, STORE_LAYOUT.projectsFile);
+}
+function readStoreProjects(storeDir) {
+  const path = storeProjectsPath(storeDir);
+  if (!existsSync2(path)) {
+    return [];
+  }
+  let raw;
+  try {
+    raw = JSON.parse(readFileSync2(path, "utf8"));
+  } catch {
+    return [];
+  }
+  const parsed = storeProjectsFileSchema.safeParse(raw);
+  return parsed.success ? parsed.data.projects : [];
+}
+function storeHasProject(storeDir, id) {
+  return readStoreProjects(storeDir).some((p) => p.id === id);
+}
+function addStoreProject(storeDir, project) {
+  const parsed = storeProjectSchema.parse(project);
+  const existing = readStoreProjects(storeDir);
+  if (existing.some((p) => p.id === parsed.id)) {
+    throw new Error(`project '${parsed.id}' already exists in store at ${storeDir}`);
+  }
+  const next = [...existing, parsed];
+  const validated = storeProjectsFileSchema.parse({ projects: next });
+  writeFileSync(storeProjectsPath(storeDir), `${JSON.stringify(validated, null, 2)}
+`, "utf8");
+  return validated.projects;
+}
 function aggregatePendingAcrossStores(stores) {
   return stores.flatMap(
     (store) => listMarkdown(join2(store.dir, STORE_LAYOUT.knowledgeDir, STORE_PENDING_DIR)).map((file) => ({
@@ -1557,47 +1624,122 @@ function aggregatePendingAcrossStores(stores) {
   );
 }
 
+// src/store/store-counters.ts
+import { existsSync as existsSync3, readFileSync as readFileSync3, readdirSync as readdirSync3, writeFileSync as writeFileSync2 } from "fs";
+import { join as join3 } from "path";
+function storeCountersPath(storeDir) {
+  return join3(storeDir, STORE_LAYOUT.countersFile);
+}
+function readStoreCounters(storeDir) {
+  let raw;
+  try {
+    raw = readFileSync3(storeCountersPath(storeDir), "utf8");
+  } catch {
+    return defaultAgentsMetaCounters();
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    return defaultAgentsMetaCounters();
+  }
+  const result = AgentsMetaCountersSchema.safeParse(parsed);
+  return result.success ? result.data : defaultAgentsMetaCounters();
+}
+async function allocateStoreKnowledgeId(layer, type, storeDir) {
+  const countersPath = storeCountersPath(storeDir);
+  return withFileLock(`${countersPath}.lock`, async () => {
+    const counters = readStoreCounters(storeDir);
+    const { id, nextCounters } = allocateKnowledgeId(layer, type, counters);
+    await atomicWriteJson(countersPath, nextCounters, { indent: 2 });
+    return id;
+  });
+}
+function readEntryId(file) {
+  let content;
+  try {
+    content = readFileSync3(file, "utf8");
+  } catch {
+    return null;
+  }
+  const match = content.match(/^id:\s*(\S+)\s*$/mu);
+  if (match) {
+    return match[1] ?? null;
+  }
+  const stem = file.slice(file.lastIndexOf("/") + 1).replace(/\.md$/u, "");
+  const idPart = stem.split("--")[0];
+  return idPart.length > 0 ? idPart : null;
+}
+function reconcileStoreCounters(storeDir) {
+  const current = readStoreCounters(storeDir);
+  const next = {
+    KP: { ...current.KP },
+    KT: { ...current.KT }
+  };
+  for (const type of STORE_KNOWLEDGE_TYPE_DIRS) {
+    const dir = join3(storeDir, STORE_LAYOUT.knowledgeDir, type);
+    if (!existsSync3(dir)) {
+      continue;
+    }
+    for (const name of readdirSync3(dir)) {
+      if (!name.endsWith(".md")) {
+        continue;
+      }
+      const parsed = parseKnowledgeId(readEntryId(join3(dir, name)) ?? "");
+      if (parsed === null) {
+        continue;
+      }
+      const layerKey = parsed.layer === "personal" ? "KP" : "KT";
+      const typeCode = KNOWLEDGE_TYPE_CODES[parsed.type];
+      next[layerKey][typeCode] = Math.max(next[layerKey][typeCode], parsed.counter);
+    }
+  }
+  writeFileSync2(storeCountersPath(storeDir), `${JSON.stringify(next, null, 2)}
+`, "utf8");
+  return next;
+}
+
 // src/store/global-config-io.ts
-import { existsSync as existsSync3, mkdirSync as mkdirSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "fs";
+import { existsSync as existsSync4, mkdirSync as mkdirSync2, readFileSync as readFileSync4, writeFileSync as writeFileSync3 } from "fs";
 import { homedir } from "os";
-import { join as join3 } from "path";
+import { join as join4 } from "path";
 function resolveGlobalRoot() {
-  return join3(process.env.FABRIC_HOME ?? homedir(), ".fabric");
+  return join4(process.env.FABRIC_HOME ?? homedir(), ".fabric");
 }
 function globalConfigPath(globalRoot = resolveGlobalRoot()) {
-  return join3(globalRoot, "fabric-global.json");
+  return join4(globalRoot, "fabric-global.json");
 }
 function loadGlobalConfig(globalRoot = resolveGlobalRoot()) {
   const path = globalConfigPath(globalRoot);
-  if (!existsSync3(path)) {
+  if (!existsSync4(path)) {
     return null;
   }
-  return globalConfigSchema.parse(JSON.parse(readFileSync2(path, "utf8")));
+  return globalConfigSchema.parse(JSON.parse(readFileSync4(path, "utf8")));
 }
 function saveGlobalConfig(config, globalRoot = resolveGlobalRoot()) {
   const validated = globalConfigSchema.parse(config);
   mkdirSync2(globalRoot, { recursive: true });
-  writeFileSync2(globalConfigPath(globalRoot), `${JSON.stringify(validated, null, 2)}
+  writeFileSync3(globalConfigPath(globalRoot), `${JSON.stringify(validated, null, 2)}
 `, "utf8");
 }
 
 // src/store/project-config-io.ts
-import { existsSync as existsSync4, mkdirSync as mkdirSync3, readFileSync as readFileSync3, writeFileSync as writeFileSync3 } from "fs";
-import { join as join4 } from "path";
+import { existsSync as existsSync5, mkdirSync as mkdirSync3, readFileSync as readFileSync5, writeFileSync as writeFileSync4 } from "fs";
+import { join as join5 } from "path";
 function projectConfigPath(projectRoot) {
-  return join4(projectRoot, ".fabric", "fabric-config.json");
+  return join5(projectRoot, ".fabric", "fabric-config.json");
 }
 function loadProjectConfig(projectRoot) {
   const path = projectConfigPath(projectRoot);
-  if (!existsSync4(path)) {
+  if (!existsSync5(path)) {
     return null;
   }
-  return fabricConfigSchema.parse(JSON.parse(readFileSync3(path, "utf8")));
+  return fabricConfigSchema.parse(JSON.parse(readFileSync5(path, "utf8")));
 }
 function saveProjectConfig(config, projectRoot) {
   const validated = fabricConfigSchema.parse(config);
-  mkdirSync3(join4(projectRoot, ".fabric"), { recursive: true });
-  writeFileSync3(projectConfigPath(projectRoot), `${JSON.stringify(validated, null, 2)}
+  mkdirSync3(join5(projectRoot, ".fabric"), { recursive: true });
+  writeFileSync4(projectConfigPath(projectRoot), `${JSON.stringify(validated, null, 2)}
 `, "utf8");
 }
 
@@ -1847,8 +1989,8 @@ var resolvedBindingsSnapshotSchema = z14.object({
 }).strict();
 
 // src/store/bindings.ts
-import { existsSync as existsSync5, mkdirSync as mkdirSync4, readFileSync as readFileSync4, writeFileSync as writeFileSync4 } from "fs";
-import { join as join5, resolve, sep } from "path";
+import { existsSync as existsSync6, mkdirSync as mkdirSync4, readFileSync as readFileSync6, writeFileSync as writeFileSync5 } from "fs";
+import { join as join6, resolve, sep } from "path";
 var SAFE_PROJECT_ID = /^[A-Za-z0-9._-]+$/;
 function assertSafeProjectId(projectId) {
   if (!SAFE_PROJECT_ID.test(projectId) || projectId.includes("..")) {
@@ -1859,8 +2001,8 @@ function assertSafeProjectId(projectId) {
 }
 function bindingsSnapshotPath(globalRoot, projectId) {
   assertSafeProjectId(projectId);
-  const bindingsDir = resolve(join5(globalRoot, GLOBAL_STATE_DIR, GLOBAL_BINDINGS_DIR));
-  const path = resolve(join5(bindingsDir, `${projectId}_resolved.json`));
+  const bindingsDir = resolve(join6(globalRoot, GLOBAL_STATE_DIR, GLOBAL_BINDINGS_DIR));
+  const path = resolve(join6(bindingsDir, `${projectId}_resolved.json`));
   if (path !== bindingsDir && !path.startsWith(bindingsDir + sep)) {
     throw new Error(`bindingsSnapshotPath: resolved path escapes bindings dir for ${JSON.stringify(projectId)}`);
   }
@@ -1878,18 +2020,18 @@ function writeBindingsSnapshot(options) {
     write_target: target
   });
   const path = bindingsSnapshotPath(options.globalRoot, options.projectId);
-  mkdirSync4(join5(path, ".."), { recursive: true });
-  writeFileSync4(path, `${JSON.stringify(snapshot, null, 2)}
+  mkdirSync4(join6(path, ".."), { recursive: true });
+  writeFileSync5(path, `${JSON.stringify(snapshot, null, 2)}
 `, "utf8");
   return snapshot;
 }
 function readBindingsSnapshot(globalRoot, projectId) {
   const path = bindingsSnapshotPath(globalRoot, projectId);
-  if (!existsSync5(path)) {
+  if (!existsSync6(path)) {
     return null;
   }
   try {
-    const parsed = resolvedBindingsSnapshotSchema.safeParse(JSON.parse(readFileSync4(path, "utf8")));
+    const parsed = resolvedBindingsSnapshotSchema.safeParse(JSON.parse(readFileSync6(path, "utf8")));
     return parsed.success ? parsed.data : null;
   } catch {
     return null;
@@ -2967,11 +3109,13 @@ export {
   STORE_KNOWLEDGE_TYPE_DIRS,
   STORE_LAYOUT,
   STORE_PENDING_DIR,
+  STORE_PROJECT_ID_PATTERN,
   STORE_RESOLVER_WARNING_CODES,
   STORE_UUID_PATTERN,
   StableIdSchema,
   UID_SEGMENT_PATTERN,
   addMountedStore,
+  addStoreProject,
   agentsIdentitySourceSchema,
   agentsLayerSchema,
   agentsMetaNodeSchema,
@@ -2980,6 +3124,7 @@ export {
   aggregatePendingAcrossStores,
   aiLedgerEntrySchema,
   allocateKnowledgeId,
+  allocateStoreKnowledgeId,
   annotateIntentRequestSchema,
   archiveScanAnnotations,
   archiveScanInputSchema,
@@ -3153,12 +3298,15 @@ export {
   readSetEntrySchema,
   readSetGoldenCaseSchema,
   readSetGoldenFileSchema,
+  readStoreCounters,
   readStoreIdentity,
+  readStoreProjects,
   reapplyCompletedEventSchema,
   recallAnnotations,
   recallInputSchema,
   recallOutputSchema,
   recognizeStoreDir,
+  reconcileStoreCounters,
   redactSecrets,
   relevanceMigrationRunEventSchema,
   requiredStoreEntrySchema,
@@ -3186,9 +3334,13 @@ export {
   skillPhaseTransitionEventSchema,
   skillTriggerCandidateEventSchema,
   storeAwareEntrySchema,
+  storeCountersPath,
   storeCountersSchema,
+  storeHasProject,
   storeIdentitySchema,
   storeKnowledgeTypeDir,
+  storeProjectSchema,
+  storeProjectsFileSchema,
   storeReadSetSchema,
   storeRelativePath,
   storeResolveInputSchema,

package/dist/node/atomic-write.js

@@ -1,124 +1,9 @@
-// src/node/atomic-write.ts
-import { appendFile, mkdir, open, readFile, rename, stat, unlink, writeFile } from "fs/promises";
-import { dirname } from "path";
-import { randomUUID } from "crypto";
-function makeTmpSuffix() {
-  const rand = Math.floor(Math.random() * 65535).toString(16).padStart(4, "0");
-  return `.${process.pid}.${Date.now()}.${rand}.tmp`;
-}
-async function atomicWriteText(path, content, opts) {
-  const tmpPath = path + makeTmpSuffix();
-  try {
-    if (opts?.fsync) {
-      const fd = await open(tmpPath, "w");
-      try {
-        await fd.writeFile(content, "utf8");
-        await fd.datasync();
-      } finally {
-        await fd.close();
-      }
-    } else {
-      await writeFile(tmpPath, content, "utf8");
-    }
-    await rename(tmpPath, path);
-  } catch (err) {
-    try {
-      await unlink(tmpPath);
-    } catch {
-    }
-    throw err;
-  }
-}
-async function atomicWriteJson(path, value, opts) {
-  const indent = opts?.indent ?? 2;
-  const content = JSON.stringify(value, null, indent) + "\n";
-  await atomicWriteText(path, content, { fsync: opts?.fsync });
-}
-function isErrnoException(err) {
-  return err instanceof Error && typeof err.code === "string";
-}
-function sleep(ms) {
-  return new Promise((resolve) => setTimeout(resolve, ms));
-}
-async function withFileLock(lockPath, fn, opts = {}) {
-  const staleMs = opts.staleMs ?? 1e4;
-  const retryDelayMs = opts.retryDelayMs ?? 20;
-  const maxWaitMs = opts.maxWaitMs ?? 1e4;
-  await mkdir(dirname(lockPath), { recursive: true });
-  const token = `${process.pid}.${randomUUID()}`;
-  const start = Date.now();
-  for (; ; ) {
-    let handle;
-    try {
-      handle = await open(lockPath, "wx");
-    } catch (err) {
-      if (!isErrnoException(err) || err.code !== "EEXIST") throw err;
-      try {
-        const st = await stat(lockPath);
-        if (Date.now() - st.mtimeMs > staleMs) {
-          const staleToken = await readFile(lockPath, "utf8").catch(() => null);
-          if (staleToken !== null) {
-            await unlinkIfToken(lockPath, staleToken);
-          }
-          continue;
-        }
-      } catch {
-        continue;
-      }
-      if (Date.now() - start > maxWaitMs) {
-        throw new Error(`withFileLock: timed out acquiring ${lockPath} after ${maxWaitMs}ms`);
-      }
-      await sleep(retryDelayMs);
-      continue;
-    }
-    try {
-      await handle.writeFile(token, "utf8");
-      await handle.close();
-      return await fn();
-    } finally {
-      await unlinkIfToken(lockPath, token);
-    }
-  }
-}
-async function unlinkIfToken(lockPath, expected) {
-  try {
-    const current = await readFile(lockPath, "utf8");
-    if (current === expected) {
-      await unlink(lockPath).catch(() => void 0);
-    }
-  } catch {
-  }
-}
-function createLedgerWriteQueue() {
-  const chains = /* @__PURE__ */ new Map();
-  async function doAppend(path, line) {
-    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) {
-      return enqueue(path, () => doAppend(path, line));
-    },
-    runExclusive(path, fn) {
-      return enqueue(path, fn);
-    }
-  };
-}
+import {
+  atomicWriteJson,
+  atomicWriteText,
+  createLedgerWriteQueue,
+  withFileLock
+} from "../chunk-4N6DMOOW.js";
 export {
   atomicWriteJson,
   atomicWriteText,

package/dist/node/mcp-payload-guard.js

@@ -1,6 +1,6 @@
 import {
   MCPError
-} from "../chunk-VW5QGPIN.js";
+} from "../chunk-VDSM73PK.js";
 
 // src/node/mcp-payload-guard.ts
 var McpPayloadTooLargeError = class extends MCPError {

package/dist/types/index.d.ts

@@ -1,2 +1,2 @@
-export { e as AgentsActivationTier, a as AgentsIdentitySource, b as AgentsLayer, d as AgentsMeta, g as AgentsMetaCountersEnvelope, h as AgentsMetaKnowledgeTypeCounters, A as AgentsMetaNode, i as AgentsMetaNodeActivation, c as AgentsTopologyType, j as AiLedgerEntry, k as AuditMode, C as ClientPaths, D as DefaultLayerFilter, F as FabricConfig, l as FabricLanguage, m as HumanLedgerEntry, H as HumanLockEntry, L as LedgerEntry, M as McpPayloadLimits, R as RuleDescription, n as RuleDescriptionIndexItem } from '../index-Dm4IJWwB.js';
+export { e as AgentsActivationTier, a as AgentsIdentitySource, b as AgentsLayer, d as AgentsMeta, g as AgentsMetaCountersEnvelope, h as AgentsMetaKnowledgeTypeCounters, A as AgentsMetaNode, i as AgentsMetaNodeActivation, c as AgentsTopologyType, j as AiLedgerEntry, k as AuditMode, C as ClientPaths, D as DefaultLayerFilter, F as FabricConfig, l as FabricLanguage, m as HumanLedgerEntry, H as HumanLockEntry, L as LedgerEntry, M as McpPayloadLimits, R as RuleDescription, n as RuleDescriptionIndexItem } from '../index-BqA89S9q.js';
 import 'zod';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fenglimg/fabric-shared",
-  "version": "2.2.0-rc.3",
+  "version": "2.2.0-rc.4",
   "description": "Fabric shared types — Zod schemas, i18n, atomic-write helpers, MCP payload guard, error classes. Consumed by @fenglimg/fabric-server + @fenglimg/fabric-cli.",
   "license": "MIT",
   "author": "wangzhichao <fenglimg90@gmail.com>",