@fenglimg/fabric-shared 1.8.0-rc.2 → 2.0.0-rc.1

package/dist/{chunk-KV27CZH3.js → chunk-HACPXMLL.js}

@@ -6,20 +6,38 @@ var structuredWarningSchema = z.object({
   line: z.number().optional(),
   action_hint: z.string()
 });
+var _knowledgeTypeEnum = z.enum(["model", "decision", "guideline", "pitfall", "process"]);
+var _maturityEnum = z.enum(["draft", "verified", "proven"]);
+var _layerEnum = z.enum(["personal", "team"]);
 var _ruleDescriptionSchema = z.object({
   summary: z.string(),
   intent_clues: z.array(z.string()),
   tech_stack: z.array(z.string()),
   impact: z.array(z.string()),
   must_read_if: z.string(),
-  entities: z.array(z.string()).optional()
+  entities: z.array(z.string()).optional(),
+  // v2.0: optional knowledge-entry fields. Absent for v1.x rules; present for
+  // entries that declare frontmatter `id/type/maturity/layer`.
+  id: z.string().optional(),
+  knowledge_type: _knowledgeTypeEnum.optional(),
+  maturity: _maturityEnum.optional(),
+  knowledge_layer: _layerEnum.optional(),
+  layer_reason: z.string().optional(),
+  created_at: z.string().optional()
 });
 var _descriptionIndexItemSchema = z.object({
   stable_id: z.string(),
   level: z.enum(["L0", "L1", "L2"]),
   required: z.boolean(),
   selectable: z.boolean(),
-  description: _ruleDescriptionSchema
+  description: _ruleDescriptionSchema,
+  // v2.0: top-level knowledge surface for client-side filtering. Mirrors
+  // description.* — exposed here so MCP clients can filter without reaching
+  // into the nested payload.
+  type: _knowledgeTypeEnum.optional(),
+  maturity: _maturityEnum.optional(),
+  layer: _layerEnum.optional(),
+  layer_reason: z.string().optional()
 });
 var _requirementProfileSchema = z.object({
   target_path: z.string(),
@@ -44,7 +62,10 @@ var planContextInputSchema = z.object({
   detected_entities: z.record(z.array(z.string())).optional().describe("Optional path-keyed detected entities for the requirement profile"),
   client_hash: z.string().optional().describe("Revision hash from a prior fab_plan_context response; enables stale detection"),
   correlation_id: z.string().optional().describe("Optional caller-provided correlation id for Event Ledger records"),
-  session_id: z.string().optional().describe("Optional caller-provided session id for Event Ledger records")
+  session_id: z.string().optional().describe("Optional caller-provided session id for Event Ledger records"),
+  include_deprecated: z.boolean().optional().describe(
+    "When true, include description_index entries with maturity='deprecated'. Defaults to false (deprecated entries hidden). Note: 'deprecated' is reserved future state \u2014 today this filter is a no-op until MaturitySchema is widened."
+  )
 });
 var planContextOutputSchema = z.object({
   revision_hash: z.string(),
@@ -134,13 +155,23 @@ var ruleSectionsOutputSchema = z.object({
     })
   ),
   diagnostics: z.array(
-    z.object({
-      code: z.literal("missing_section"),
-      severity: z.literal("warn"),
-      stable_id: z.string(),
-      section: z.enum(RULE_SECTION_NAMES_TUPLE),
-      message: z.string()
-    })
+    z.discriminatedUnion("code", [
+      z.object({
+        code: z.literal("missing_section"),
+        severity: z.literal("warn"),
+        stable_id: z.string(),
+        section: z.enum(RULE_SECTION_NAMES_TUPLE),
+        message: z.string()
+      }),
+      // v2.0: warn-level diagnostic for un-migrated v1.x entries (no
+      // knowledge_type and no knowledge_layer). Does NOT block selection.
+      z.object({
+        code: z.literal("missing_knowledge_metadata"),
+        severity: z.literal("warn"),
+        stable_id: z.string(),
+        message: z.string()
+      })
+    ])
   ),
   warnings: z.array(structuredWarningSchema).optional()
 });
@@ -202,6 +233,58 @@ var annotateIntentRequestSchema = z.object({
   ledger_entry_id: z.string().min(1),
   annotation: z.string().trim().min(1)
 });
+var KnowledgeTypeSchema = z.enum([
+  "model",
+  // entities, data structures, relationships
+  "decision",
+  // architectural/technical choices with rationale
+  "guideline",
+  // recommended practices (recommend) or anti-patterns (avoid)
+  "pitfall",
+  // known risks, failure modes, troubleshooting
+  "process"
+  // workflows, state machines, operational steps
+]);
+var MaturitySchema = z.enum(["draft", "verified", "proven"]);
+var LayerSchema = z.enum(["personal", "team"]);
+var StableIdSchema = z.string().regex(/^K[PT]-(MOD|DEC|GLD|PIT|PRO)-\d{4,}$/);
+var KnowledgeEntryFrontmatterSchema = z.object({
+  id: StableIdSchema,
+  // e.g., "KT-DEC-0042"
+  type: KnowledgeTypeSchema,
+  // one of 5 types
+  maturity: MaturitySchema,
+  // draft | verified | proven
+  layer: LayerSchema,
+  // personal | team
+  layer_reason: z.string().optional(),
+  // why this layer (for ambiguous cases)
+  created_at: z.string()
+  // ISO 8601 timestamp
+  // Note: 'tags' and other fields can be added later but core schema is these 6
+});
+var KNOWLEDGE_TYPE_CODES = {
+  model: "MOD",
+  decision: "DEC",
+  guideline: "GLD",
+  pitfall: "PIT",
+  process: "PRO"
+};
+function formatKnowledgeId(layer, type, counter) {
+  const layerPrefix = layer === "personal" ? "KP" : "KT";
+  const typeCode = KNOWLEDGE_TYPE_CODES[type];
+  return `${layerPrefix}-${typeCode}-${String(counter).padStart(4, "0")}`;
+}
+function parseKnowledgeId(id) {
+  const match = id.match(/^(KP|KT)-(MOD|DEC|GLD|PIT|PRO)-(\d+)$/);
+  if (!match) return null;
+  const layer = match[1] === "KP" ? "personal" : "team";
+  const typeCode = match[2];
+  const entry = Object.entries(KNOWLEDGE_TYPE_CODES).find(([, code]) => code === typeCode);
+  if (!entry) return null;
+  const type = entry[0];
+  return { layer, type, counter: parseInt(match[3], 10) };
+}
 
 export {
   structuredWarningSchema,
@@ -219,5 +302,13 @@ export {
   historyStateQuerySchema,
   humanLockApproveRequestSchema,
   humanLockFileParamsSchema,
-  annotateIntentRequestSchema
+  annotateIntentRequestSchema,
+  KnowledgeTypeSchema,
+  MaturitySchema,
+  LayerSchema,
+  StableIdSchema,
+  KnowledgeEntryFrontmatterSchema,
+  KNOWLEDGE_TYPE_CODES,
+  formatKnowledgeId,
+  parseKnowledgeId
 };

package/dist/{chunk-BLXHC5HA.js → chunk-KHIM6MWS.js}

@@ -165,9 +165,6 @@ var enMessages = {
   "cli.init.capabilities.follow-up.install": "install client assets",
   "cli.init.capabilities.follow-up.manual": "manual step required",
   "cli.init.next-step.message": "run fab hooks install to add the Day 4 pre-commit pipeline.",
-  "cli.init.reason-message.claude-body": ".fabric/forensic.json is ready; use the fabric-init skill to finish internal Fabric initialization.",
-  "cli.init.reason-message.codex-body": ".fabric/forensic.json is ready; continue with the repo skill at .agents/skills/fabric-init/SKILL.md and enable features.codex_hooks = true for Codex hooks.",
-  "cli.init.reason-message.multi-body": ".fabric/forensic.json is ready; continue in your installed client flow: Claude can use fabric-init, and Codex can use .agents/skills/fabric-init/SKILL.md with features.codex_hooks = true.",
   "cli.init.reason-message.installable-body": ".fabric/forensic.json is ready; some detected clients support Fabric follow-up but still need client assets installed.",
   "cli.init.reason-message.manual-body": ".fabric/forensic.json is ready; some detected clients still need manual follow-up because no Fabric skill is installed for them yet.",
   "cli.init.codex-hooks.created": "{label} {path} with Codex hooks config (requires features.codex_hooks = true).",
@@ -195,6 +192,9 @@ var enMessages = {
   "cli.scan.args.target.description": "Target absolute path. Defaults to CLI arg, EXTERNAL_FIXTURE_PATH, fabric.config.json, then cwd.",
   "cli.scan.args.debug.description": "Print detection evidence in formatted output.",
   "cli.scan.args.json.description": "Print the diagnostic report as JSON.",
+  "cli.scan.error.missing-forensic": "forensic.json not found at {path}; run `fabric init` first to produce the deterministic project snapshot.",
+  "cli.scan.summary.created": "Wrote {count} knowledge entries to .fabric/knowledge/.",
+  "cli.scan.summary.skipped": "No changes detected; {count} entries already up-to-date.",
   "cli.scan.report.title": "Fabric scan report",
   "cli.scan.report.target": "Target",
   "cli.scan.report.framework": "Framework",
@@ -600,9 +600,6 @@ var zhCNMessages = {
   "cli.init.capabilities.follow-up.install": "\u5B89\u88C5\u5BA2\u6237\u7AEF\u8D44\u4EA7",
   "cli.init.capabilities.follow-up.manual": "\u9700\u8981\u624B\u52A8\u540E\u7EED\u5904\u7406",
   "cli.init.next-step.message": "\u8FD0\u884C fab hooks install \u4EE5\u6DFB\u52A0\u7B2C 4 \u5929\u7684 pre-commit \u6D41\u6C34\u7EBF\u3002",
-  "cli.init.reason-message.claude-body": ".fabric/forensic.json \u5DF2\u5C31\u7EEA\uFF1B\u8BF7\u4F7F\u7528 fabric-init skill \u5B8C\u6210 Fabric \u5185\u90E8\u521D\u59CB\u5316\u3002",
-  "cli.init.reason-message.codex-body": ".fabric/forensic.json \u5DF2\u5C31\u7EEA\uFF1B\u8BF7\u7EE7\u7EED\u4F7F\u7528\u4ED3\u5E93\u5185\u7684 .agents/skills/fabric-init/SKILL.md\uFF0C\u5E76\u4E3A Codex hooks \u542F\u7528 features.codex_hooks = true\u3002",
-  "cli.init.reason-message.multi-body": ".fabric/forensic.json \u5DF2\u5C31\u7EEA\uFF1B\u8BF7\u6309\u5DF2\u5B89\u88C5\u5BA2\u6237\u7AEF\u7EE7\u7EED\u540E\u7EED\u6D41\u7A0B\uFF1AClaude \u4F7F\u7528 fabric-init\uFF0CCodex \u4F7F\u7528 .agents/skills/fabric-init/SKILL.md\uFF0C\u5E76\u542F\u7528 features.codex_hooks = true\u3002",
   "cli.init.reason-message.installable-body": ".fabric/forensic.json \u5DF2\u5C31\u7EEA\uFF1B\u90E8\u5206\u5DF2\u68C0\u6D4B\u5230\u7684\u5BA2\u6237\u7AEF\u5DF2\u652F\u6301 Fabric \u540E\u7EED\u63A5\u529B\uFF0C\u4F46\u4ECD\u9700\u5B89\u88C5\u5BA2\u6237\u7AEF\u8D44\u4EA7\u3002",
   "cli.init.reason-message.manual-body": ".fabric/forensic.json \u5DF2\u5C31\u7EEA\uFF1B\u90E8\u5206\u5DF2\u68C0\u6D4B\u5230\u7684\u5BA2\u6237\u7AEF\u5C1A\u672A\u5B89\u88C5 Fabric skill\uFF0C\u9700\u8981\u624B\u52A8\u5B8C\u6210\u540E\u7EED\u521D\u59CB\u5316\u3002",
   "cli.init.codex-hooks.created": "{label} {path}\uFF0C\u5E76\u5199\u5165 Codex hooks \u914D\u7F6E\uFF08\u9700\u542F\u7528 features.codex_hooks = true\uFF09\u3002",
@@ -630,6 +627,9 @@ var zhCNMessages = {
   "cli.scan.args.target.description": "\u76EE\u6807\u7EDD\u5BF9\u8DEF\u5F84\u3002\u9ED8\u8BA4\u4F9D\u6B21\u4F7F\u7528 CLI \u53C2\u6570\u3001EXTERNAL_FIXTURE_PATH\u3001fabric.config.json\u3001\u5F53\u524D\u76EE\u5F55\u3002",
   "cli.scan.args.debug.description": "\u4EE5\u683C\u5F0F\u5316\u8F93\u51FA\u6253\u5370\u68C0\u6D4B\u8BC1\u636E\u3002",
   "cli.scan.args.json.description": "\u4EE5 JSON \u683C\u5F0F\u8F93\u51FA\u8BCA\u65AD\u62A5\u544A\u3002",
+  "cli.scan.error.missing-forensic": "\u672A\u627E\u5230 forensic.json\uFF08\u8DEF\u5F84 {path}\uFF09\uFF1B\u8BF7\u5148\u8FD0\u884C `fabric init` \u751F\u6210\u9879\u76EE\u5FEB\u7167\u3002",
+  "cli.scan.summary.created": "\u5DF2\u5199\u5165 {count} \u6761\u77E5\u8BC6\u6761\u76EE\u81F3 .fabric/knowledge/\u3002",
+  "cli.scan.summary.skipped": "\u65E0\u5DEE\u5F02\uFF1B{count} \u6761\u5DF2\u5B58\u5728\u7684\u6761\u76EE\u4FDD\u6301\u4E0D\u53D8\u3002",
   "cli.scan.report.title": "Fabric \u626B\u63CF\u62A5\u544A",
   "cli.scan.report.target": "\u76EE\u6807",
   "cli.scan.report.framework": "\u6846\u67B6",

package/dist/i18n/index.js

@@ -6,7 +6,7 @@ import {
   enMessages,
   normalizeLocale,
   zhCNMessages
-} from "../chunk-BLXHC5HA.js";
+} from "../chunk-KHIM6MWS.js";
 export {
   PROTECTED_TOKENS,
   createTranslator,