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

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 -->";

package/dist/{chunk-D7HUHWBI.js → chunk-TV264D7E.js}

@@ -47,21 +47,25 @@ var structuredWarningSchema = z3.object({
 });
 var _knowledgeTypeEnum = z3.enum(["models", "decisions", "guidelines", "pitfalls", "processes"]);
 var _maturityEnum = z3.enum(["draft", "verified", "proven"]);
-var _layerEnum = z3.enum(["personal", "team"]);
 var _ruleDescriptionSchema = z3.object({
   summary: z3.string(),
   intent_clues: z3.array(z3.string()),
-  tech_stack: z3.array(z3.string()),
-  impact: z3.array(z3.string()),
+  // wire-slim (payload): fab_recall projects a LEAN description (summary +
+  // must_read_if + intent_clues + knowledge_type — the selection signal), leaving
+  // tech_stack/impact to be Read on demand via read_path (KT-DEC-0026 lean
+  // contract at the field level). So they are optional on the wire. plan-context
+  // still returns them in full — zod keeps optional-present values, only ABSENT is
+  // now allowed, so no plan-context consumer regresses.
+  tech_stack: z3.array(z3.string()).optional(),
+  impact: z3.array(z3.string()).optional(),
   must_read_if: z3.string(),
-  entities: z3.array(z3.string()).optional(),
   // v2.0: optional knowledge-entry fields. Absent for v1.x rules; present for
-  // entries that declare frontmatter `id/type/maturity/layer`.
+  // entries that declare frontmatter `id/type/maturity`. W4/Track1: the redundant
+  // `knowledge_layer` field was removed — a candidate's layer is derived from its
+  // stable_id prefix (KP-→personal, else team; KT-DEC-0004).
   id: z3.string().optional(),
   knowledge_type: _knowledgeTypeEnum.optional(),
   maturity: _maturityEnum.optional(),
-  knowledge_layer: _layerEnum.optional(),
-  layer_reason: z3.string().optional(),
   created_at: z3.string().optional(),
   // v2.0.0-rc.38 UX-3 (D-MCP fold ③): these three were previously carried ONLY
   // as top-level mirrors on the index item. With the mirrors removed,
@@ -75,7 +79,12 @@ var _ruleDescriptionSchema = z3.object({
   // schema must also carry `related`, else zod strips the graph edges on output
   // validation and they never reach the client (MC1 include_related / fabric-
   // connect would see nothing). Mirrors the agents-meta ruleDescriptionSchema.
-  related: z3.array(z3.string()).optional()
+  related: z3.array(z3.string()).optional(),
+  // v2.2 glossary aliases FIELD (C-001): mirrors agents.ts RuleDescription.
+  // MUST be declared here or zod .strip() drops aliases on output validation
+  // before plan-context feeds them into the BM25 body — long-tail alias terms
+  // would never reach the lexical/vector index (KT-PIT-0018 zod-strip lesson).
+  aliases: z3.array(z3.string()).optional()
 });
 var _descriptionIndexItemSchema = z3.object({
   stable_id: z3.string(),
@@ -194,7 +203,11 @@ var planContextHintNarrowEntrySchema = z3.object({
   // W2-2 (KT-DEC-0027): the entry's must_read_if trigger hook, forwarded for the
   // SessionStart REFERENCE rendering (decision/pitfall/process → title + hook).
   // Optional — omitted when the frontmatter declares none.
-  must_read_if: z3.string().optional()
+  must_read_if: z3.string().optional(),
+  // TASK-003 (impact-map MVP): the entry's impact list, forwarded so the narrow
+  // PreToolUse hint can surface the consequences of ignoring this knowledge when
+  // editing a matching relevance path. Optional — omitted when none declared.
+  impact: z3.array(z3.string()).optional()
 });
 var planContextHintOutputSchema = z3.object({
   version: z3.literal(1),
@@ -242,8 +255,8 @@ var knowledgeSectionsOutputSchema = z3.object({
   diagnostics: z3.array(
     // v2.0.0-rc.23 TASK-013 (F8b): `missing_section` was removed alongside the
     // A-set enum. `missing_knowledge_metadata` stays as the warn-level signal
-    // for un-migrated v1.x entries (no knowledge_type AND no knowledge_layer
-    // in frontmatter). Does NOT block selection.
+    // for un-migrated v1.x entries (no knowledge_type in frontmatter). Does NOT
+    // block selection.
     z3.object({
       code: z3.enum(["missing_knowledge_metadata", "unresolved_selected_id"]),
       severity: z3.literal("warn"),
@@ -313,7 +326,33 @@ 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(),
+    // BORROW-008 proximity boost — MUST be declared or zod .strip() drops it at
+    // the MCP boundary (KT-PIT-0005), desyncing wire `final` from its components.
+    proximity: z3.number(),
+    // PLN-004 F1 credibility content-age decay MULTIPLIER factor — optional
+    // (only present once the multiplier is wired). MUST be declared or zod
+    // .strip() drops it at the MCP boundary (KT-PIT-0005).
+    credibility: z3.number().optional()
+  }).optional()
 });
 var recallOutputSchema = z3.object({
   revision_hash: z3.string(),
@@ -642,7 +681,19 @@ var _fabReviewModifyChangesSchema = z3.object({
   // edges via fab_recall and sends the merged set. Absent this field the modify
   // path silently dropped `related` via zod .strip() (KT-PIT-0005 recurrence),
   // leaving the only programmatic related-write path non-functional.
-  related: z3.array(z3.string()).optional()
+  related: z3.array(z3.string()).optional(),
+  // rc.9 (2026-07-06): discovery-signal scalar patches — must_read_if triggers
+  // Reference-type entry surfacing; intent_clues drives the AI's "should I Read
+  // the body?" judgment; impact enumerates consequence prose surfaced in the
+  // BM25F body slot. Before rc.9 these three fields were undeclared here, so
+  // fab_review modify silently .strip()'d them (KT-PIT-0005 recurrence) and the
+  // only path to fix a bad-shape must_read_if / missing intent_clues was direct
+  // Edit — bypassing the skill audit trail. All three are REPLACE semantics
+  // (mirror tags/related). must_read_if is a scalar string; intent_clues +
+  // impact are flow-arrays.
+  must_read_if: z3.string().optional(),
+  intent_clues: z3.array(z3.string()).optional(),
+  impact: z3.array(z3.string()).optional()
 });
 var FabReviewInputSchema = z3.discriminatedUnion("action", [
   z3.object({
@@ -1073,8 +1124,6 @@ var KnowledgeEntryFrontmatterSchema = z3.object({
   // draft | verified | proven
   layer: LayerSchema,
   // personal | team
-  layer_reason: z3.string().optional(),
-  // why this layer (for ambiguous cases)
   created_at: z3.string()
   // ISO 8601 timestamp
   // Note: 'tags' and other fields can be added later but core schema is these 6