@fenglimg/fabric-shared 2.3.0-rc.12 → 2.3.0-rc.15

package/dist/index.js

@@ -7,7 +7,7 @@ import {
   BOOTSTRAP_REGEX,
   matchBootstrapCanonicalLocale,
   resolveBootstrapCanonical
-} from "./chunk-KFFBQRL5.js";
+} from "./chunk-DNIICOSG.js";
 import "./chunk-LXNCAKJZ.js";
 import {
   PROTECTED_TOKENS,
@@ -16,7 +16,7 @@ import {
   enMessages,
   resolveFabricLocale,
   zhCNMessages
-} from "./chunk-YLIWE46B.js";
+} from "./chunk-47M6HKBU.js";
 import {
   GLOBAL_BINDINGS_DIR,
   GLOBAL_STATE_DIR,
@@ -40,6 +40,7 @@ import {
   resolveGlobalLocale,
   resolveGlobalRoot,
   saveGlobalConfig,
+  saveGlobalConfigAsync,
   storeAliasSchema,
   storeIdentitySchema,
   storeKnowledgeTypeDir,
@@ -51,7 +52,7 @@ import {
   storeRelativePath,
   storeRelativePathForMount,
   storeUuidSchema
-} from "./chunk-ASS2KBB7.js";
+} from "./chunk-OX6DWUK4.js";
 import {
   atomicWriteJson,
   withFileLock
@@ -116,7 +117,7 @@ import {
   scopeCoordinateSchema,
   scopeRoot,
   structuredWarningSchema
-} from "./chunk-TEITGZY3.js";
+} from "./chunk-5M3HB554.js";
 
 // src/schemas/agents-meta.ts
 import { z } from "zod";
@@ -1646,12 +1647,11 @@ async function initStore(absDir, identity, options = {}) {
   await mkdir(join2(absDir, STORE_LAYOUT.knowledgeDir, STORE_PENDING_DIR), { recursive: true });
   await mkdir(join2(absDir, STORE_LAYOUT.bindingsDir), { recursive: true });
   await mkdir(join2(absDir, STORE_LAYOUT.stateDir), { recursive: true });
-  await writeFile(identityFile, `${JSON.stringify(parsed, null, 2)}
-`, "utf8");
   await writeFile(join2(absDir, ".gitignore"), STORE_GITIGNORE, "utf8");
   if (options.git !== false) {
     await git(absDir, ["init", "-b", "main"]);
   }
+  await atomicWriteJson(identityFile, parsed, { indent: 2 });
   const readBack = await readStoreIdentityAsync(absDir);
   if (readBack === null) {
     throw new Error(`store init wrote an unrecognizable store.json at ${absDir}`);
@@ -1699,41 +1699,78 @@ async function readKnowledgeAcrossStores(stores) {
 function storeProjectsPath(storeDir) {
   return join2(storeDir, STORE_LAYOUT.projectsFile);
 }
+function storeProjectsLockPath(storeDir) {
+  return `${storeProjectsPath(storeDir)}.lock`;
+}
 async function readStoreProjects(storeDir) {
   const path = storeProjectsPath(storeDir);
+  let text;
+  try {
+    text = await readFile2(path, "utf8");
+  } catch (err) {
+    if (err && typeof err === "object" && "code" in err && err.code === "ENOENT") {
+      return [];
+    }
+    throw err;
+  }
   let raw;
   try {
-    raw = JSON.parse(await readFile2(path, "utf8"));
+    raw = JSON.parse(text);
   } catch {
-    return [];
+    throw new Error(
+      `projects.json at ${path} is not valid JSON \u2014 refusing to treat as empty (would risk overwrite on next add)`
+    );
   }
   const parsed = storeProjectsFileSchema.safeParse(raw);
-  return parsed.success ? parsed.data.projects : [];
+  if (!parsed.success) {
+    throw new Error(
+      `projects.json at ${path} failed schema validation \u2014 refusing to treat as empty (would risk overwrite on next add): ${parsed.error.message}`
+    );
+  }
+  return parsed.data.projects;
 }
 async function storeHasProject(storeDir, id) {
   return (await readStoreProjects(storeDir)).some((p) => p.id === id);
 }
 async function addStoreProject(storeDir, project) {
   const parsed = storeProjectSchema.parse(project);
-  const existing = await 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 });
-  await writeFile(storeProjectsPath(storeDir), `${JSON.stringify(validated, null, 2)}
-`, "utf8");
-  return validated.projects;
+  return withFileLock(storeProjectsLockPath(storeDir), async () => {
+    const existing = await 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 });
+    await atomicWriteJson(storeProjectsPath(storeDir), validated, { indent: 2 });
+    return validated.projects;
+  });
 }
 async function aggregatePendingAcrossStores(stores) {
-  const lists = await Promise.all(stores.map(
-    async (store) => (await listMarkdown(join2(store.dir, STORE_LAYOUT.knowledgeDir, STORE_PENDING_DIR))).map((file) => ({
-      store_uuid: store.store_uuid,
-      alias: store.alias,
-      type: STORE_PENDING_DIR,
-      file
-    }))
-  ));
+  const lists = await Promise.all(
+    stores.map(async (store) => {
+      const pendingRoot = join2(store.dir, STORE_LAYOUT.knowledgeDir, STORE_PENDING_DIR);
+      const refs = [];
+      for (const type of STORE_KNOWLEDGE_TYPE_DIRS) {
+        for (const file of await listMarkdown(join2(pendingRoot, type))) {
+          refs.push({
+            store_uuid: store.store_uuid,
+            alias: store.alias,
+            type: STORE_PENDING_DIR,
+            file
+          });
+        }
+      }
+      for (const file of await listMarkdown(pendingRoot)) {
+        refs.push({
+          store_uuid: store.store_uuid,
+          alias: store.alias,
+          type: STORE_PENDING_DIR,
+          file
+        });
+      }
+      return refs;
+    })
+  );
   return lists.flat();
 }
 
@@ -2101,7 +2138,8 @@ var MCP_STORE_AWARE_TOOLS = [
   "fab_get_knowledge_sections",
   "fab_archive_scan",
   "fab_propose",
-  "fab_review"
+  "fab_review",
+  "fab_pending"
 ];
 var storeAwareEntrySchema = z11.object({
   stable_id: z11.string(),
@@ -2130,7 +2168,10 @@ var MCP_STORE_AWARE_CONTRACTS = {
     surfacesEntries: false,
     echoesWrittenStore: true
   },
-  fab_review: { tool: "fab_review", surfacesEntries: true, echoesWrittenStore: true }
+  fab_review: { tool: "fab_review", surfacesEntries: true, echoesWrittenStore: true },
+  // W3-K K2: read-only list/search lifted from fab_review — surfaces pending/
+  // canonical entries with store provenance, does not write.
+  fab_pending: { tool: "fab_pending", surfacesEntries: true, echoesWrittenStore: false }
 };
 
 // src/schemas/bindings-snapshot.ts
@@ -3180,6 +3221,54 @@ var fileMutatedEventSchema = z16.object({
   source_event_id: z16.string().optional(),
   store_id: z16.string().optional()
 });
+var storeMountedEventSchema = z16.object({
+  ...eventLedgerEnvelopeSchema,
+  event_type: z16.literal("store_mounted"),
+  alias: z16.string(),
+  store_uuid: z16.string(),
+  personal: z16.boolean().optional(),
+  source: z16.string().optional()
+});
+var storeDetachedEventSchema = z16.object({
+  ...eventLedgerEnvelopeSchema,
+  event_type: z16.literal("store_detached"),
+  alias: z16.string(),
+  store_uuid: z16.string().optional(),
+  source: z16.string().optional()
+});
+var storeBoundEventSchema = z16.object({
+  ...eventLedgerEnvelopeSchema,
+  event_type: z16.literal("store_bound"),
+  alias: z16.string(),
+  store_uuid: z16.string().optional(),
+  project: z16.string().optional(),
+  source: z16.string().optional()
+});
+var writeStoreSwitchedEventSchema = z16.object({
+  ...eventLedgerEnvelopeSchema,
+  event_type: z16.literal("write_store_switched"),
+  alias: z16.string(),
+  previous_alias: z16.string().optional(),
+  // Named switch_kind (not `kind`) so it never shadows the envelope
+  // kind: "fabric-event" discriminator required by every ledger row.
+  switch_kind: z16.enum(["project_write", "personal"]).optional(),
+  source: z16.string().optional()
+});
+var writeRouteChangedEventSchema = z16.object({
+  ...eventLedgerEnvelopeSchema,
+  event_type: z16.literal("write_route_changed"),
+  scope: z16.string(),
+  alias: z16.string(),
+  previous_alias: z16.string().optional(),
+  source: z16.string().optional()
+});
+var narrowHintFailedEventSchema = z16.object({
+  ...eventLedgerEnvelopeSchema,
+  event_type: z16.literal("narrow_hint_failed"),
+  hook_name: z16.string(),
+  reason: z16.string(),
+  bin: z16.string().optional()
+});
 var knowledgeBodyReadEventSchema = z16.object({
   ...eventLedgerEnvelopeSchema,
   event_type: z16.literal("knowledge_body_read"),
@@ -3292,6 +3381,14 @@ var eventLedgerEventSchema = z16.discriminatedUnion("event_type", [
   // lifecycle-refactor Wave 2 — dormant-hook activation markers.
   sessionEndedEventSchema,
   fileMutatedEventSchema,
+  // ISS-20260711-127: store topology admin events
+  storeMountedEventSchema,
+  storeDetachedEventSchema,
+  storeBoundEventSchema,
+  writeStoreSwitchedEventSchema,
+  writeRouteChangedEventSchema,
+  // ISS-20260711-215: narrow_hint_failed — CLI failure observability for narrow hook
+  narrowHintFailedEventSchema,
   // KT-DEC-0030: knowledge_body_read — PostToolUse native-Read consumption marker
   // (replaces knowledge_consumed as the funnel's "body opened" signal).
   knowledgeBodyReadEventSchema,
@@ -3621,6 +3718,7 @@ export {
   metaUpdatedEventSchema,
   migrateRequiredStores,
   mountedStoreSchema,
+  narrowHintFailedEventSchema,
   normalizeCiteTag,
   normalizeLocale,
   nudgeModeSchema,
@@ -3679,6 +3777,7 @@ export {
   ruleDescriptionIndexItemSchema,
   ruleDescriptionSchema,
   saveGlobalConfig,
+  saveGlobalConfigAsync,
   saveProjectConfig,
   scanForSecrets,
   scopeCoordinateSchema,
@@ -3694,14 +3793,17 @@ export {
   skillTriggerCandidateEventSchema,
   storeAliasSchema,
   storeAwareEntrySchema,
+  storeBoundEventSchema,
   storeCountersPath,
   storeCountersSchema,
+  storeDetachedEventSchema,
   storeHasProject,
   storeIdentitySchema,
   storeKnowledgeTypeDir,
   storeMountGroup,
   storeMountNameSchema,
   storeMountSubPath,
+  storeMountedEventSchema,
   storeProjectSchema,
   storeProjectsFileSchema,
   storeReadSetSchema,
@@ -3716,7 +3818,9 @@ export {
   uidSchema,
   withDerivedAgentsMetaNodeDefaults,
   writeBindingsSnapshot,
+  writeRouteChangedEventSchema,
   writeRouteSchema,
+  writeStoreSwitchedEventSchema,
   writeTargetSchema,
   writtenToStoreSchema,
   zhCNMessages