@fenglimg/fabric-shared 2.3.0-rc.4 → 2.3.0-rc.5

package/dist/index.js

@@ -16,7 +16,7 @@ import {
   enMessages,
   resolveFabricLocale,
   zhCNMessages
-} from "./chunk-LDFQYCY7.js";
+} from "./chunk-P6INRP3A.js";
 import {
   GLOBAL_BINDINGS_DIR,
   GLOBAL_STATE_DIR,
@@ -116,7 +116,7 @@ import {
   scopeCoordinateSchema,
   scopeRoot,
   structuredWarningSchema
-} from "./chunk-7PS7LB5T.js";
+} from "./chunk-PPV5IQGX.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(),
@@ -612,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
@@ -1569,6 +1593,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",
@@ -1622,12 +1647,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) {

package/dist/schemas/api-contracts.d.ts

@@ -94,12 +94,9 @@ declare const planContextOutputSchema: z.ZodObject<{
             tech_stack: z.ZodArray<z.ZodString, "many">;
             impact: z.ZodArray<z.ZodString, "many">;
             must_read_if: z.ZodString;
-            entities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
             id: z.ZodOptional<z.ZodString>;
             knowledge_type: z.ZodOptional<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>>;
             maturity: z.ZodOptional<z.ZodEnum<["draft", "verified", "proven"]>>;
-            knowledge_layer: z.ZodOptional<z.ZodEnum<["personal", "team"]>>;
-            layer_reason: z.ZodOptional<z.ZodString>;
             created_at: z.ZodOptional<z.ZodString>;
             tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
             relevance_scope: z.ZodOptional<z.ZodEnum<["narrow", "broad"]>>;
@@ -115,11 +112,8 @@ declare const planContextOutputSchema: z.ZodObject<{
             id?: string | undefined;
             relevance_scope?: "narrow" | "broad" | undefined;
             relevance_paths?: string[] | undefined;
-            entities?: string[] | undefined;
             knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
             maturity?: "draft" | "verified" | "proven" | undefined;
-            knowledge_layer?: "personal" | "team" | undefined;
-            layer_reason?: string | undefined;
             tags?: string[] | undefined;
             related?: string[] | undefined;
         }, {
@@ -132,11 +126,8 @@ declare const planContextOutputSchema: z.ZodObject<{
             id?: string | undefined;
             relevance_scope?: "narrow" | "broad" | undefined;
             relevance_paths?: string[] | undefined;
-            entities?: string[] | undefined;
             knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
             maturity?: "draft" | "verified" | "proven" | undefined;
-            knowledge_layer?: "personal" | "team" | undefined;
-            layer_reason?: string | undefined;
             tags?: string[] | undefined;
             related?: string[] | undefined;
         }>;
@@ -152,11 +143,8 @@ declare const planContextOutputSchema: z.ZodObject<{
             id?: string | undefined;
             relevance_scope?: "narrow" | "broad" | undefined;
             relevance_paths?: string[] | undefined;
-            entities?: string[] | undefined;
             knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
             maturity?: "draft" | "verified" | "proven" | undefined;
-            knowledge_layer?: "personal" | "team" | undefined;
-            layer_reason?: string | undefined;
             tags?: string[] | undefined;
             related?: string[] | undefined;
         };
@@ -173,11 +161,8 @@ declare const planContextOutputSchema: z.ZodObject<{
             id?: string | undefined;
             relevance_scope?: "narrow" | "broad" | undefined;
             relevance_paths?: string[] | undefined;
-            entities?: string[] | undefined;
             knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
             maturity?: "draft" | "verified" | "proven" | undefined;
-            knowledge_layer?: "personal" | "team" | undefined;
-            layer_reason?: string | undefined;
             tags?: string[] | undefined;
             related?: string[] | undefined;
         };
@@ -259,11 +244,8 @@ declare const planContextOutputSchema: z.ZodObject<{
             id?: string | undefined;
             relevance_scope?: "narrow" | "broad" | undefined;
             relevance_paths?: string[] | undefined;
-            entities?: string[] | undefined;
             knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
             maturity?: "draft" | "verified" | "proven" | undefined;
-            knowledge_layer?: "personal" | "team" | undefined;
-            layer_reason?: string | undefined;
             tags?: string[] | undefined;
             related?: string[] | undefined;
         };
@@ -316,11 +298,8 @@ declare const planContextOutputSchema: z.ZodObject<{
             id?: string | undefined;
             relevance_scope?: "narrow" | "broad" | undefined;
             relevance_paths?: string[] | undefined;
-            entities?: string[] | undefined;
             knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
             maturity?: "draft" | "verified" | "proven" | undefined;
-            knowledge_layer?: "personal" | "team" | undefined;
-            layer_reason?: string | undefined;
             tags?: string[] | undefined;
             related?: string[] | undefined;
         };
@@ -364,17 +343,20 @@ declare const planContextHintNarrowEntrySchema: z.ZodObject<{
     maturity: z.ZodString;
     summary: z.ZodString;
     must_read_if: z.ZodOptional<z.ZodString>;
+    impact: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
     type: string;
     id: string;
     summary: string;
     maturity: string;
+    impact?: string[] | undefined;
     must_read_if?: string | undefined;
 }, {
     type: string;
     id: string;
     summary: string;
     maturity: string;
+    impact?: string[] | undefined;
     must_read_if?: string | undefined;
 }>;
 declare const planContextHintOutputSchema: z.ZodObject<{
@@ -387,17 +369,20 @@ declare const planContextHintOutputSchema: z.ZodObject<{
         maturity: z.ZodString;
         summary: z.ZodString;
         must_read_if: z.ZodOptional<z.ZodString>;
+        impact: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     }, "strip", z.ZodTypeAny, {
         type: string;
         id: string;
         summary: string;
         maturity: string;
+        impact?: string[] | undefined;
         must_read_if?: string | undefined;
     }, {
         type: string;
         id: string;
         summary: string;
         maturity: string;
+        impact?: string[] | undefined;
         must_read_if?: string | undefined;
     }>, "many">;
     broad_count: z.ZodNumber;
@@ -407,6 +392,7 @@ declare const planContextHintOutputSchema: z.ZodObject<{
         id: string;
         summary: string;
         maturity: string;
+        impact?: string[] | undefined;
         must_read_if?: string | undefined;
     }[];
     target_paths: string[];
@@ -419,6 +405,7 @@ declare const planContextHintOutputSchema: z.ZodObject<{
         id: string;
         summary: string;
         maturity: string;
+        impact?: string[] | undefined;
         must_read_if?: string | undefined;
     }[];
     target_paths: string[];
@@ -611,12 +598,9 @@ declare const recallOutputSchema: z.ZodObject<{
             tech_stack: z.ZodArray<z.ZodString, "many">;
             impact: z.ZodArray<z.ZodString, "many">;
             must_read_if: z.ZodString;
-            entities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
             id: z.ZodOptional<z.ZodString>;
             knowledge_type: z.ZodOptional<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>>;
             maturity: z.ZodOptional<z.ZodEnum<["draft", "verified", "proven"]>>;
-            knowledge_layer: z.ZodOptional<z.ZodEnum<["personal", "team"]>>;
-            layer_reason: z.ZodOptional<z.ZodString>;
             created_at: z.ZodOptional<z.ZodString>;
             tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
             relevance_scope: z.ZodOptional<z.ZodEnum<["narrow", "broad"]>>;
@@ -632,11 +616,8 @@ declare const recallOutputSchema: z.ZodObject<{
             id?: string | undefined;
             relevance_scope?: "narrow" | "broad" | undefined;
             relevance_paths?: string[] | undefined;
-            entities?: string[] | undefined;
             knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
             maturity?: "draft" | "verified" | "proven" | undefined;
-            knowledge_layer?: "personal" | "team" | undefined;
-            layer_reason?: string | undefined;
             tags?: string[] | undefined;
             related?: string[] | undefined;
         }, {
@@ -649,11 +630,8 @@ declare const recallOutputSchema: z.ZodObject<{
             id?: string | undefined;
             relevance_scope?: "narrow" | "broad" | undefined;
             relevance_paths?: string[] | undefined;
-            entities?: string[] | undefined;
             knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
             maturity?: "draft" | "verified" | "proven" | undefined;
-            knowledge_layer?: "personal" | "team" | undefined;
-            layer_reason?: string | undefined;
             tags?: string[] | undefined;
             related?: string[] | undefined;
         }>;
@@ -706,11 +684,8 @@ declare const recallOutputSchema: z.ZodObject<{
             id?: string | undefined;
             relevance_scope?: "narrow" | "broad" | undefined;
             relevance_paths?: string[] | undefined;
-            entities?: string[] | undefined;
             knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
             maturity?: "draft" | "verified" | "proven" | undefined;
-            knowledge_layer?: "personal" | "team" | undefined;
-            layer_reason?: string | undefined;
             tags?: string[] | undefined;
             related?: string[] | undefined;
         };
@@ -743,11 +718,8 @@ declare const recallOutputSchema: z.ZodObject<{
             id?: string | undefined;
             relevance_scope?: "narrow" | "broad" | undefined;
             relevance_paths?: string[] | undefined;
-            entities?: string[] | undefined;
             knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
             maturity?: "draft" | "verified" | "proven" | undefined;
-            knowledge_layer?: "personal" | "team" | undefined;
-            layer_reason?: string | undefined;
             tags?: string[] | undefined;
             related?: string[] | undefined;
         };
@@ -837,11 +809,8 @@ declare const recallOutputSchema: z.ZodObject<{
             id?: string | undefined;
             relevance_scope?: "narrow" | "broad" | undefined;
             relevance_paths?: string[] | undefined;
-            entities?: string[] | undefined;
             knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
             maturity?: "draft" | "verified" | "proven" | undefined;
-            knowledge_layer?: "personal" | "team" | undefined;
-            layer_reason?: string | undefined;
             tags?: string[] | undefined;
             related?: string[] | undefined;
         };
@@ -903,11 +872,8 @@ declare const recallOutputSchema: z.ZodObject<{
             id?: string | undefined;
             relevance_scope?: "narrow" | "broad" | undefined;
             relevance_paths?: string[] | undefined;
-            entities?: string[] | undefined;
             knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
             maturity?: "draft" | "verified" | "proven" | undefined;
-            knowledge_layer?: "personal" | "team" | undefined;
-            layer_reason?: string | undefined;
             tags?: string[] | undefined;
             related?: string[] | undefined;
         };
@@ -2594,7 +2560,6 @@ declare const KnowledgeEntryFrontmatterSchema: z.ZodObject<{
     type: z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>;
     maturity: z.ZodEnum<["draft", "verified", "proven"]>;
     layer: z.ZodEnum<["personal", "team"]>;
-    layer_reason: z.ZodOptional<z.ZodString>;
     created_at: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     created_at: string;
@@ -2602,14 +2567,12 @@ declare const KnowledgeEntryFrontmatterSchema: z.ZodObject<{
     id: string;
     layer: "personal" | "team";
     maturity: "draft" | "verified" | "proven";
-    layer_reason?: string | undefined;
 }, {
     created_at: string;
     type: "models" | "decisions" | "guidelines" | "pitfalls" | "processes";
     id: string;
     layer: "personal" | "team";
     maturity: "draft" | "verified" | "proven";
-    layer_reason?: string | undefined;
 }>;
 type KnowledgeEntryFrontmatter = z.infer<typeof KnowledgeEntryFrontmatterSchema>;
 declare const KNOWLEDGE_TYPE_CODES: {

package/dist/schemas/api-contracts.js

@@ -47,7 +47,7 @@ import {
   recallInputSchema,
   recallOutputSchema,
   structuredWarningSchema
-} from "../chunk-7PS7LB5T.js";
+} from "../chunk-PPV5IQGX.js";
 export {
   FabExtractKnowledgeInputSchema,
   FabExtractKnowledgeInputShape,

package/dist/types/index.d.ts

@@ -1,2 +1,2 @@
-export { a as AgentsIdentitySource, d as AgentsMeta, e as AgentsMetaCountersEnvelope, g as AgentsMetaKnowledgeTypeCounters, A as AgentsMetaNode, b as AgentsTopologyType, h as AiLedgerEntry, i as AuditMode, C as ClientPaths, D as DefaultLayerFilter, F as FabricConfig, j as FabricLanguage, m as HumanLedgerEntry, H as HumanLockEntry, L as LedgerEntry, n as McpPayloadLimits, o as RecallScore, p as RecallScoreBreakdown, q as RuleDescription, r as RuleDescriptionIndexItem } from '../index-C0cijMSw.js';
+export { a as AgentsIdentitySource, d as AgentsMeta, e as AgentsMetaCountersEnvelope, g as AgentsMetaKnowledgeTypeCounters, A as AgentsMetaNode, b as AgentsTopologyType, h as AiLedgerEntry, i as AuditMode, C as ClientPaths, D as DefaultLayerFilter, F as FabricConfig, j as FabricLanguage, m as HumanLedgerEntry, H as HumanLockEntry, L as LedgerEntry, n as McpPayloadLimits, o as RecallScore, p as RecallScoreBreakdown, q as RuleDescription, r as RuleDescriptionIndexItem } from '../index-Ba3sXdL4.js';
 import 'zod';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fenglimg/fabric-shared",
-  "version": "2.3.0-rc.4",
+  "version": "2.3.0-rc.5",
   "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>",