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

package/dist/index.js

@@ -7,7 +7,7 @@ import {
   BOOTSTRAP_REGEX,
   matchBootstrapCanonicalLocale,
   resolveBootstrapCanonical
-} from "./chunk-SQKWD7X6.js";
+} from "./chunk-KFFBQRL5.js";
 import "./chunk-LXNCAKJZ.js";
 import {
   PROTECTED_TOKENS,
@@ -16,7 +16,7 @@ import {
   enMessages,
   resolveFabricLocale,
   zhCNMessages
-} from "./chunk-IFMFEX3V.js";
+} from "./chunk-XRX6RVZY.js";
 import {
   GLOBAL_BINDINGS_DIR,
   GLOBAL_STATE_DIR,
@@ -51,7 +51,7 @@ import {
   storeRelativePath,
   storeRelativePathForMount,
   storeUuidSchema
-} from "./chunk-2GLIAZ5M.js";
+} from "./chunk-ASS2KBB7.js";
 import {
   atomicWriteJson,
   withFileLock
@@ -116,7 +116,7 @@ import {
   scopeCoordinateSchema,
   scopeRoot,
   structuredWarningSchema
-} from "./chunk-D7HUHWBI.js";
+} from "./chunk-TV264D7E.js";
 
 // src/schemas/agents-meta.ts
 import { z } from "zod";
@@ -138,7 +138,6 @@ var ruleDescriptionSchema = z.object({
   tech_stack: z.array(z.string()),
   impact: z.array(z.string()),
   must_read_if: z.string(),
-  entities: z.array(z.string()).optional(),
   // v2.0 knowledge entry fields (TASK-002 schemas). All optional for backward compat.
   id: z.string().optional(),
   // rc.31 NEW-1: forward-compat for legacy on-disk agents.meta.json carrying
@@ -151,8 +150,8 @@ var ruleDescriptionSchema = z.object({
     z.enum(["models", "decisions", "guidelines", "pitfalls", "processes"])
   ).optional(),
   maturity: z.enum(["draft", "verified", "proven"]).optional(),
-  knowledge_layer: z.enum(["personal", "team"]).optional(),
-  layer_reason: z.string().optional(),
+  // W4/Track1: `knowledge_layer` removed — an entry's layer is derived from its
+  // stable_id prefix (KP-→personal, else team; KT-DEC-0004), never a field.
   created_at: z.string().optional(),
   // v2/rc.2: flat flow-style YAML array; populated by init-scan from forensic tech stack and editable by user. Used by rc.3 review skill for tag-filter search.
   tags: z.array(z.string()).default([]).optional(),
@@ -355,6 +354,32 @@ var humanLockFileSchema = z4.object({
 
 // src/schemas/fabric-config.ts
 import { z as z5 } from "zod";
+function isNonPersonalRequiredStore(entry) {
+  return entry.id !== PERSONAL_STORE_SENTINEL;
+}
+function refineMaxOneTeamStore(entries, ctx) {
+  const teamCount = entries.filter(isNonPersonalRequiredStore).length;
+  if (teamCount > 1) {
+    ctx.addIssue({
+      code: z5.ZodIssueCode.custom,
+      message: `a project may bind at most one team store (found ${teamCount}); run \`fabric install\` to migrate to the single team slot`
+    });
+  }
+}
+function migrateRequiredStores(config) {
+  const declared = config.required_stores;
+  if (declared === void 0) {
+    return config;
+  }
+  const team = declared.filter(isNonPersonalRequiredStore);
+  if (team.length <= 1) {
+    return config;
+  }
+  const personal = declared.filter((entry) => !isNonPersonalRequiredStore(entry));
+  const active = config.active_write_store;
+  const kept = (active !== void 0 ? team.find((entry) => entry.id === active) : void 0) ?? team[0];
+  return { ...config, required_stores: [...personal, kept] };
+}
 var auditModeSchema = z5.enum(["strict", "warn", "off"]);
 var clientPathsSchema = z5.object({
   claudeCodeCLI: z5.string().optional(),
@@ -401,7 +426,9 @@ var fabricConfigSchema = z5.object({
   // `$personal` sentinel). Drives the read-set (required_stores ∪ implicit
   // personal, S11/S54) and `clone`'s missing-store onboarding (S51). Optional
   // + absent → read-set is just the implicit personal store.
-  required_stores: z5.array(requiredStoreEntrySchema).optional(),
+  // W2 dual-slot (TASK-002 / R6): at most ONE non-personal (team-type) store —
+  // the two-slot model. >1 fails parse and is migrated by `migrateRequiredStores`.
+  required_stores: z5.array(requiredStoreEntrySchema).superRefine(refineMaxOneTeamStore).optional(),
   // v2.1.0-rc.1 P3 (S60 / `store switch-write`): alias of the store that
   // non-personal-scope writes land in for this project. Set by
   // `fabric store switch-write <alias>`; consumed as the resolver's
@@ -584,12 +611,37 @@ var fabricConfigSchema = z5.object({
   // banner silently truncates. Default 50; range 20..500 (read inline by
   // knowledge-hint-broad.cjs#readBroadIndexBackstop with the same bounds).
   broad_index_backstop: z5.number().int().min(20).max(500).optional().default(50),
-  // v2.0.0-rc.37 NEW-16: durable per-signal dismiss for the fabric-hint Stop
-  // hook nudges. Any signal type listed here is suppressed at emit time across
+  // v2.0.0-rc.37 NEW-16: durable per-signal dismiss for the fabric-hint hook
+  // nudges. Any signal type listed here is suppressed at emit time across
   // all sessions (the session-scoped sibling lives in a .fabric/.cache sidecar
   // written on request). Mirrors the cite_evict_interval=0 opt-out convention —
   // a knob for an existing surface, not a new feature. Unknown types ignored.
-  hint_dismiss_signals: z5.array(z5.enum(["archive", "review", "import", "maintenance"])).optional(),
+  //
+  // TASK-005 (grill G5 / C-004 "全 nudge MUST 可 dismiss"): the enum now spans
+  // ALL nudge surfaces, not just the fabric-hint Stop signals:
+  //   - Stop (fabric-hint):        archive / review / import / maintenance
+  //   - SessionStart (broad):      review / import / maintenance now surface as
+  //                                the SessionStart summary line (see
+  //                                buildSessionStartSinks H4 ladder) — the same
+  //                                dismiss key silences them there too.
+  //   - PreToolUse (per-edit):     "narrow" (knowledge-hint-narrow) and
+  //                                "cite-evict" (cite-before-edit nudge).
+  // C-004 semantics are enforced at the trigger sites, NOT here: "narrow"
+  // defaults ON (impact-bearing) and "cite-evict" defaults OFF-able; listing
+  // either key here is the durable opt-out. Adding enum values is backward
+  // compatible — legacy configs that omit the new keys parse unchanged, and
+  // unknown on-disk values are dropped by the lenient root parser.
+  hint_dismiss_signals: z5.array(
+    z5.enum([
+      "archive",
+      "review",
+      "import",
+      "maintenance",
+      // per-edit (PreToolUse) nudge surfaces — TASK-005
+      "narrow",
+      "cite-evict"
+    ])
+  ).optional(),
   // v2.1 ADJ-NEWN-4: user-override escape hatches for the two strong behavioral
   // policies (cite-before-edit + self-archive). The strong policies can make an
   // agent feel like a "stubborn parrot" (D2 user-in-control red line); these
@@ -649,6 +701,27 @@ var fabricConfigSchema = z5.object({
   orphan_demote_proven_days: z5.number().int().min(1).max(3650).optional(),
   orphan_demote_verified_days: z5.number().int().min(1).max(3650).optional(),
   orphan_demote_draft_days: z5.number().int().min(1).max(3650).optional(),
+  // PLN-004 F1 (credibility content-age decay): per-knowledge-type half-lives
+  // (days) for the recall-scoring credibility MULTIPLIER. Orthogonal to the
+  // orphan_demote usage-inactivity ladder above (that is last-activity age; this
+  // is content age off created_at) and to recencyBoost (a 7-day additive
+  // freshness bump). Team-curated knowledge decays slower than transient work, so
+  // defaults run longer than upstream: decisions 180 / guidelines 150 / models
+  // 150 / pitfalls 120 / processes 120 (applied in config-loader). Each optional;
+  // absent → the loader default. Range 1..3650 mirrors orphan_demote.
+  credibility_half_life_decisions_days: z5.number().int().min(1).max(3650).optional(),
+  credibility_half_life_guidelines_days: z5.number().int().min(1).max(3650).optional(),
+  credibility_half_life_models_days: z5.number().int().min(1).max(3650).optional(),
+  credibility_half_life_pitfalls_days: z5.number().int().min(1).max(3650).optional(),
+  credibility_half_life_processes_days: z5.number().int().min(1).max(3650).optional(),
+  // PLN-004 F1: per-maturity floor the credibility multiplier never decays below
+  // (a stale-but-endorsed entry keeps a minimum weight). Higher maturity → higher
+  // floor: draft 0.4 / verified 0.55 / proven 0.7 (config-loader defaults). Range
+  // [0,1]. This is the softened form of the "content leads structural" invariant —
+  // credibility may sink a stale match but never zero it.
+  credibility_floor_draft: z5.number().min(0).max(1).optional(),
+  credibility_floor_verified: z5.number().min(0).max(1).optional(),
+  credibility_floor_proven: z5.number().min(0).max(1).optional(),
   // v2.2 C1 (processes/maturity-promotion-rubric-v1): days a `broad` entry may
   // go without a fab-review re-confirmation before doctor surfaces a RECHECK
   // nudge. `broad` is EXEMPT from usage-age decay (it is SessionStart-pushed,
@@ -706,10 +779,13 @@ var fabricConfigSchema = z5.object({
   // sole retrieval knob (plan_context_top_k above); payload limits pass through
   // explicit `mcpPayloadLimits`, else the fixed PAYLOAD_LIMIT_DEFAULT_* guardrail.
   // v2.2 C2-vector (W2-T7): OPTIONAL dense-embedding semantic retrieval, layered
-  // as a recall supplement after BM25. Default OFF (`--no-embed` is the baseline);
-  // requires the operator to install the optional `fastembed` package — absent →
-  // text-only fallback. Never grows the default install footprint.
-  embed_enabled: z5.boolean().optional().default(false),
+  // as a recall supplement after BM25. P1 recall-engine-refactor (TASK-004):
+  // Default ON — `fastembed` is now an optionalDependency (auto-installed; absent →
+  // degrade-safe text-only fallback), so CJK semantic recall is on out of the box.
+  // OFF only when set explicitly to false. This default mirrors the runtime read in
+  // config-loader.ts (`embed_enabled !== false`); keep the two in sync so config
+  // introspection never reports a default that contradicts runtime behavior.
+  embed_enabled: z5.boolean().optional().default(true),
   // Weight applied to the 0..1 cosine similarity before it joins the additive
   // score. Capped at 49 — strictly BELOW BM25_WEIGHT (50) — so a perfect vector
   // match (weight × 1) can never outscore a single strong BM25 term match. This
@@ -734,8 +810,25 @@ var fabricConfigSchema = z5.object({
     "fast-bge-base-en-v1.5",
     "fast-bge-base-en",
     "fast-all-MiniLM-L6-v2"
-  ]).optional().default("fast-bge-small-zh-v1.5")
-});
+  ]).optional().default("fast-bge-small-zh-v1.5"),
+  // P1 recall-engine-refactor (TASK-003 + follow-up): content-channel fusion
+  // strategy. 'additive' = the weighted-sum path (BM25_WEIGHT·bm25 + vectorWeight·
+  // vector + structural); the vector term is structurally minor (cosine·30 vs an
+  // unbounded BM25), so additive is effectively BM25-led. 'rrf' = Reciprocal Rank
+  // Fusion over the two CONTENT channels (bm25_rank, vector_rank, equal footing)
+  // + a re-scaled structural tiebreaker — lets semantic recall actually matter.
+  // 'auto' (DEFAULT) = adaptive: use 'rrf' WHEN the vector channel is actually
+  // producing scores (embeddings installed + model warm), else fall back to
+  // 'additive'. This is the safe default — real-store shadow showed single-channel
+  // rrf (no vectors) is strictly worse than additive, so auto never lets that
+  // happen. no-query ranking is byte-identical under every value.
+  fusion: z5.enum(["additive", "rrf", "auto"]).optional().default("auto")
+});
+var fabricConfigLoadSchema = fabricConfigSchema.merge(
+  z5.object({
+    required_stores: z5.array(requiredStoreEntrySchema).optional()
+  })
+);
 
 // src/schemas/fabric-config-introspect.ts
 import { z as z6 } from "zod";
@@ -900,9 +993,15 @@ var PANEL_FIELDS = [
   // nudge_mode — the master switch for the human-visible nudge experience
   // (the most user-facing runtime knob, previously JSON-only). embed_enabled —
   // vector semantic recall, panel-editable now that config lives in `.fabric`
-  // (A1); enabling also needs the host-side `fabric install --enable-embed`.
+  // (A1). TASK-004: default ON (fastembed is an optionalDependency, degrade-safe
+  // when absent) — this introspection default mirrors the runtime read in
+  // config-loader.ts so the panel never shows a default that contradicts behavior.
   makeEnumField("nudge_mode", "D_behavior", nudgeModeSchema.options, "normal"),
-  makeBooleanField("embed_enabled", false)
+  makeBooleanField("embed_enabled", true),
+  // P1 recall-engine-refactor (follow-up): the content-channel fusion strategy,
+  // panel-editable so it sits next to embed_enabled (the two go together — rrf
+  // only pays off when embeddings are on). 'auto' is the safe adaptive default.
+  makeEnumField("fusion", "D_behavior", ["additive", "rrf", "auto"], "auto")
 ];
 
 // src/schemas/store-stable-id.ts
@@ -1069,6 +1168,13 @@ var storeResolveInputSchema = z9.object({
   ),
   // Alias selected as the active write store for non-personal scopes, if any.
   activeWriteAlias: z9.string().min(1).optional(),
+  // Alias/UUID of the ACTIVE personal store among possibly-many mounted
+  // `personal:true` stores (语义 A: singleton-at-a-time). Drives the SINGLE
+  // personal choke point (findPersonal) → both read-set inclusion and the
+  // personal-scope write-target. Absent or dangling ⇒ the resolver falls back
+  // to the first mounted personal, so legacy single-personal configs are
+  // unchanged. Sourced from `~/.fabric/fabric-global.json` → active_personal_store.
+  activePersonalAlias: z9.string().min(1).optional(),
   // Scope-aware write routes. Exact scope wins first, then longest prefix route.
   writeRoutes: z9.array(
     z9.object({
@@ -1131,7 +1237,16 @@ function createProjectRootResolver() {
 
 // src/resolver/store-resolver.ts
 function findPersonal(input) {
-  return input.mountedStores.find((s) => s.personal);
+  const actives = input.mountedStores.filter((s) => s.personal);
+  if (input.activePersonalAlias !== void 0) {
+    const picked = actives.find(
+      (s) => s.alias === input.activePersonalAlias || s.store_uuid === input.activePersonalAlias
+    );
+    if (picked !== void 0) {
+      return picked;
+    }
+  }
+  return actives[0];
 }
 function personalEntry(input) {
   const p = findPersonal(input);
@@ -1499,6 +1614,7 @@ import { execFile } from "child_process";
 import { access, mkdir, readdir, readFile as readFile2, writeFile } from "fs/promises";
 import { join as join2 } from "path";
 import { promisify } from "util";
+var STORE_PROJECTS_DIR = "projects";
 var STORE_PENDING_DIR = "pending";
 var STORE_GITIGNORE = [
   "# v2.1 store \u2014 volatile / derived data is never committed",
@@ -1552,12 +1668,28 @@ async function listMarkdown(dir) {
   return entries.filter((name) => name.endsWith(".md")).sort().map((name) => join2(dir, name));
 }
 async function listStoreKnowledge(store) {
+  const knowledgeDir = join2(store.dir, STORE_LAYOUT.knowledgeDir);
   const refs = [];
   for (const type of STORE_KNOWLEDGE_TYPE_DIRS) {
-    for (const file of await listMarkdown(join2(store.dir, STORE_LAYOUT.knowledgeDir, type))) {
+    for (const file of await listMarkdown(join2(knowledgeDir, type))) {
       refs.push({ store_uuid: store.store_uuid, alias: store.alias, type, file });
     }
   }
+  let projectEntries;
+  try {
+    projectEntries = await readdir(join2(knowledgeDir, STORE_PROJECTS_DIR));
+  } catch {
+    return refs;
+  }
+  const reserved = /* @__PURE__ */ new Set([STORE_PROJECTS_DIR, ...STORE_KNOWLEDGE_TYPE_DIRS]);
+  const projectIds = projectEntries.filter((id) => STORE_PROJECT_ID_PATTERN.test(id) && !reserved.has(id)).sort();
+  for (const project of projectIds) {
+    for (const type of STORE_KNOWLEDGE_TYPE_DIRS) {
+      for (const file of await listMarkdown(join2(knowledgeDir, STORE_PROJECTS_DIR, project, type))) {
+        refs.push({ store_uuid: store.store_uuid, alias: store.alias, type, file, project });
+      }
+    }
+  }
   return refs;
 }
 async function readKnowledgeAcrossStores(stores) {
@@ -1720,7 +1852,12 @@ function loadProjectConfig(projectRoot) {
   if (!existsSync3(path)) {
     return null;
   }
-  return fabricConfigSchema.parse(JSON.parse(readFileSync3(path, "utf8")));
+  const raw = JSON.parse(readFileSync3(path, "utf8"));
+  const parsed = fabricConfigSchema.safeParse(raw);
+  if (parsed.success) {
+    return parsed.data;
+  }
+  return fabricConfigLoadSchema.parse(raw);
 }
 function saveProjectConfig(config, projectRoot) {
   const validated = fabricConfigSchema.parse(config);
@@ -1753,6 +1890,7 @@ function buildStoreResolveInput(projectRoot, globalRoot = resolveGlobalRoot()) {
       })
     ),
     ...project?.active_write_store === void 0 ? {} : { activeWriteAlias: project.active_write_store },
+    ...global.active_personal_store === void 0 ? {} : { activePersonalAlias: global.active_personal_store },
     writeRoutes: project?.write_routes ?? [],
     ...project?.default_write_store === void 0 ? {} : { defaultWriteAlias: project.default_write_store }
   };
@@ -3161,6 +3299,49 @@ var eventLedgerEventSchema = z16.discriminatedUnion("event_type", [
   graphEdgeCandidateRequestedEventSchema
 ]);
 
+// src/high-value-predicate.ts
+var HIGH_VALUE_ARCHIVE_EVENT_TYPES = /* @__PURE__ */ new Set([
+  "knowledge_context_planned",
+  "edit_paths_recorded",
+  "edit_intent_checked"
+  // the real high-freq edit signal (rc.37 NEW-14/B3)
+]);
+var NORMATIVE_KEYWORDS = [
+  "\u4EE5\u540E",
+  "always",
+  "never",
+  "from now on",
+  "\u4E0B\u6B21",
+  "\u8BB0\u4E00\u4E0B",
+  "\u6C38\u8FDC\u4E0D\u8981"
+];
+function isHighValueArchiveCandidate(events, sessionId, watermarkTs) {
+  if (!Array.isArray(events)) return false;
+  if (typeof sessionId !== "string" || sessionId.length === 0) return false;
+  const wm = typeof watermarkTs === "number" ? watermarkTs : 0;
+  let latestTurn = null;
+  for (const raw of events) {
+    const e = raw;
+    if (!e || typeof e.ts !== "number" || e.ts <= wm) continue;
+    if (e.session_id !== sessionId) continue;
+    if (typeof e.event_type === "string" && HIGH_VALUE_ARCHIVE_EVENT_TYPES.has(e.event_type)) {
+      return true;
+    }
+    if (e.event_type === "assistant_turn_observed") {
+      if (latestTurn === null || typeof latestTurn.ts === "number" && e.ts > latestTurn.ts) {
+        latestTurn = e;
+      }
+    }
+  }
+  if (latestTurn !== null) {
+    const haystack = JSON.stringify(latestTurn).toLowerCase();
+    for (const kw of NORMATIVE_KEYWORDS) {
+      if (haystack.includes(kw.toLowerCase())) return true;
+    }
+  }
+  return false;
+}
+
 // src/text-tokenize.ts
 var CJK_CLASS = "\\u3400-\\u4dbf\\u4e00-\\u9fff\\uf900-\\ufaff\\u3040-\\u30ff\\uac00-\\ud7af";
 var RUN_RE = new RegExp(`[a-z0-9]+|[${CJK_CLASS}]+`, "gu");
@@ -3339,6 +3520,7 @@ export {
   fabExtractKnowledgeAnnotations,
   fabPendingAnnotations,
   fabReviewAnnotations,
+  fabricConfigLoadSchema,
   fabricConfigSchema,
   fabricEventSchema,
   fabricLanguageSchema,
@@ -3382,7 +3564,9 @@ export {
   initScanCompletedEventSchema,
   initStore,
   installDiffAppliedEventSchema,
+  isHighValueArchiveCandidate,
   isKnowledgeStableId,
+  isNonPersonalRequiredStore,
   isPersonalLeakIntoSharedStore,
   isPersonalScope,
   knowledgeArchiveAttemptedEventSchema,
@@ -3435,6 +3619,7 @@ export {
   metaReconciledEventSchema,
   metaReconciledOnStartupEventSchema,
   metaUpdatedEventSchema,
+  migrateRequiredStores,
   mountedStoreSchema,
   normalizeCiteTag,
   normalizeLocale,