@fenglimg/fabric-shared 2.3.0-rc.1 → 2.3.0-rc.3

package/dist/{chunk-D7HUHWBI.js → chunk-7PS7LB5T.js}

@@ -313,7 +313,26 @@ var _recallEntrySchema = z3.object({
   store: z3.object({ alias: z3.string() }).optional(),
   // true when this entry's body is ALSO injected at SessionStart (broad
   // model/guideline "ALWAYS-ACTIVE") — skip the Read, it is already in context.
-  body_in_context: z3.boolean().optional()
+  body_in_context: z3.boolean().optional(),
+  // P1 recall-observability: the fused relevance score this entry scored during
+  // the plan-context sort (was computed internally but dropped before this wave).
+  // Optional + additive — backward-compatible. MUST be declared here or zod
+  // .strip() silently drops it at the MCP boundary (KT-PIT-0005).
+  score: z3.number().optional(),
+  // P1 recall-observability: numbers-only decomposition of `score` into its
+  // weighted signal contributions. NEVER carries body/description text — preserves
+  // the lean read_path contract (KT-DEC-0019 / KT-GLD-0005). bm25_rank/vector_rank
+  // are reserved for a later RRF wave (declared so the wire never strips them).
+  score_breakdown: z3.object({
+    final: z3.number(),
+    bm25: z3.number().optional(),
+    bm25_rank: z3.number().optional(),
+    vector: z3.number().optional(),
+    vector_rank: z3.number().optional(),
+    salience: z3.number(),
+    recency: z3.number(),
+    locality: z3.number()
+  }).optional()
 });
 var recallOutputSchema = z3.object({
   revision_hash: z3.string(),

package/dist/{chunk-2GLIAZ5M.js → chunk-ASS2KBB7.js}

@@ -151,11 +151,15 @@ var mountedStoreSchema = z.object({
   // Git remote locator for this clone, if any. Absent = local-only store
   // (valid; doctor nudges to add a remote for backup — R5#5, P6).
   remote: z.string().min(1).optional(),
-  // v2.1.0-rc.1 P3: marks the implicit personal store (the one minted by
-  // `install --global`). Exactly one mounted store carries personal=true; it
-  // is the write target for personal-scope entries (R5#3) and always in the
-  // read-set (S11). Optional (no default) so the output type stays a plain
-  // optional — consumers coalesce `?? false` when building resolver input.
+  // v2.1.0-rc.1 P3: marks a personal store (the kind minted by
+  // `install --global`). 语义 A (multi-personal): MULTIPLE mounted stores may
+  // carry personal=true — a machine can mount several personal stores and
+  // switch which is ACTIVE via globalConfig.active_personal_store. The ACTIVE
+  // personal is the write target for personal-scope entries (R5#3) and the one
+  // in the read-set (S11); non-active personal stores stay mounted but out of
+  // the read-set. Absent active pointer ⇒ resolver falls back to the first
+  // mounted personal (back-compat). Optional (no default) so the output type
+  // stays a plain optional — consumers coalesce `?? false`.
   personal: z.boolean().optional(),
   // Whether writes are accepted into this store from this machine. Optional;
   // consumers coalesce `?? true`. Shared stores cloned read-only set false.
@@ -174,15 +178,34 @@ var globalConfigSchema = z.object({
   // All stores mounted on this machine. The implicit personal store is
   // included here once initialized. Default empty so a fresh global config
   // (before `install --global`) parses cleanly.
-  stores: z.array(mountedStoreSchema).optional().default([])
+  stores: z.array(mountedStoreSchema).optional().default([]),
+  // 语义 A (multi-personal): alias/UUID of the ACTIVE personal store among the
+  // possibly-many `personal:true` stores in `stores[]`. Machine-wide (personal
+  // is uid-scoped identity, KT-DEC-0020) — switching it in any repo takes
+  // effect everywhere. Set by `fabric store switch-personal <alias>` and the
+  // install personal slot. Absent ⇒ the resolver falls back to the first
+  // mounted personal, so legacy single-personal configs are unchanged.
+  active_personal_store: z.string().min(1).optional()
 }).passthrough();
 
 // src/store/global-config-io.ts
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
 import { homedir } from "os";
 import { join } from "path";
+function isTestRuntime() {
+  return process.env.VITEST !== void 0 || process.env.VITEST_WORKER_ID !== void 0;
+}
 function resolveGlobalRoot() {
-  return join(process.env.FABRIC_HOME ?? homedir(), ".fabric");
+  const fabricHome = process.env.FABRIC_HOME;
+  if (fabricHome !== void 0 && fabricHome !== "") {
+    return join(fabricHome, ".fabric");
+  }
+  if (isTestRuntime()) {
+    throw new Error(
+      "resolveGlobalRoot(): FABRIC_HOME must be set under the test runner \u2014 refusing to fall back to the real home dir (~/.fabric). Repoint process.env.FABRIC_HOME to an isolated temp dir in beforeEach (see plan-context.test.ts for the pattern)."
+    );
+  }
+  return join(homedir(), ".fabric");
 }
 function globalConfigPath(globalRoot = resolveGlobalRoot()) {
   return join(globalRoot, "fabric-global.json");

package/dist/{chunk-SQKWD7X6.js → chunk-KFFBQRL5.js}

@@ -1,6 +1,6 @@
 import {
   resolveGlobalLocale
-} from "./chunk-2GLIAZ5M.js";
+} from "./chunk-ASS2KBB7.js";
 
 // src/templates/bootstrap-canonical.ts
 var BOOTSTRAP_MARKER_BEGIN = "<!-- fabric:bootstrap:begin -->";