@fenglimg/fabric-shared 2.0.0-rc.37 → 2.0.0-rc.38

package/dist/{chunk-ZSRVKMYT.js → chunk-7CX32MYL.js}

@@ -1,6 +1,6 @@
 // src/i18n/locales/en.ts
 var enMessages = {
-  "cli.main.description": "Fabric CLI - AI agent collaboration framework.\n\nThree-step mental model:\n  Install (\u88C5) - fabric install   one-shot project setup\n  Configure (\u914D) - fabric config  interactive configuration panel\n  Run (\u8DD1) - fabric serve         launch the local MCP HTTP service\n             fabric doctor        run target-state diagnostics\n\nExamples:\n  fabric install                  install Fabric in the current project\n  fabric config                   open the interactive configuration panel\n  fabric serve --port 7373        start the MCP HTTP service\n  fabric doctor --fix             repair derived Fabric state\n  fabric uninstall --dry-run      preview uninstall without removing files",
+  "cli.main.description": "Fabric CLI \u2014 feeds your project's decisions, pitfalls & conventions to your AI assistant automatically, so it stops re-learning them every session.\n\nThree-step mental model:\n  Install (\u88C5) - fabric install   one-shot project setup\n  Configure (\u914D) - fabric config  interactive configuration panel\n  Run (\u8DD1) - fabric serve         launch the local MCP HTTP service\n             fabric doctor        run target-state diagnostics\n\nExamples:\n  fabric install                  install Fabric in the current project\n  fabric config                   open the interactive configuration panel\n  fabric serve --port 7373        start the MCP HTTP service\n  fabric doctor --fix             repair derived Fabric state\n  fabric uninstall --dry-run      preview uninstall without removing files",
   "cli.shared.created": "Created",
   "cli.shared.skipped": "Skipped",
   "cli.shared.next": "Next",
@@ -113,6 +113,9 @@ var enMessages = {
   "doctor.cite.metric.recalledUnverified": "Recalled but not verified",
   "doctor.cite.metric.expectedButMissed": "Expected cite missing",
   "doctor.cite.metric.totalTurns": "Total turns",
+  "doctor.cite.metric.complianceRate": "cite compliance rate (incl. KB:none[reason])",
+  "doctor.cite.metric.complianceNA": "N/A (no cite-expected turns)",
+  "doctor.cite.metric.uncorrelatableEdits": "Uncorrelatable edits (no session_id \u2014 stale hook? run `fabric install`)",
   "doctor.cite.section.perClient": "Per-client",
   "doctor.cite.section.dismissedReasons": "Dismissed reasons",
   "doctor.cite.dismissed.scope-mismatch": "Scope mismatch",
@@ -624,6 +627,7 @@ var enMessages = {
   // spawned by the client; already-running Claude Code / Cursor / Codex
   // sessions won't pick up the new mcp config until they restart.
   "cli.install.restart-banner": "Restart hint: any already-running Claude Code / Cursor / Codex CLI session must restart to pick up the new MCP server config; new sessions will autoload the Fabric tools.",
+  "cli.install.next-steps": 'Next steps \u2014 get your first value:\n  1. Restart your AI client (Claude Code / Codex). It now auto-surfaces this project\'s knowledge to the assistant.\n  2. Seed knowledge: just work normally \u2014 when you make a decision or hit a pitfall, the fabric-archive skill proposes an entry. Or run the fabric-import skill to backfill from git history.\n  3. Verify it works: ask your AI "what does Fabric know about this repo?", or run `fabric doctor` to check health.',
   "cli.install.capabilities.none": "No supported client was detected for bootstrap or MCP follow-up.",
   "cli.install.capabilities.header.client": "Client",
   "cli.install.capabilities.header.bootstrap": "Bootstrap",
@@ -956,7 +960,7 @@ var enMessages = {
 
 // src/i18n/locales/zh-CN.ts
 var zhCNMessages = {
-  "cli.main.description": "Fabric CLI - AI \u667A\u80FD\u4F53\u534F\u4F5C\u6846\u67B6\u3002\n\n\u4E09\u6B65\u5FC3\u667A\u6A21\u578B\uFF1A\n  \u88C5 (install) - fabric install   \u4E00\u952E\u5B8C\u6210\u9879\u76EE\u521D\u59CB\u5316\n  \u914D (config)  - fabric config    \u6253\u5F00\u4EA4\u4E92\u5F0F\u914D\u7F6E\u9762\u677F\n  \u8DD1 (run)     - fabric serve     \u542F\u52A8\u672C\u5730 MCP HTTP \u670D\u52A1\n                fabric doctor     \u8FD0\u884C\u76EE\u6807\u6001\u8BCA\u65AD\n\n\u793A\u4F8B\uFF1A\n  fabric install                  \u5728\u5F53\u524D\u9879\u76EE\u4E2D\u5B89\u88C5 Fabric\n  fabric config                   \u6253\u5F00\u4EA4\u4E92\u5F0F\u914D\u7F6E\u9762\u677F\n  fabric serve --port 7373        \u542F\u52A8 MCP HTTP \u670D\u52A1\n  fabric doctor --fix             \u4FEE\u590D Fabric \u6D3E\u751F\u72B6\u6001\n  fabric uninstall --dry-run      \u9884\u89C8\u5378\u8F7D\uFF0C\u4E0D\u5220\u9664\u6587\u4EF6",
+  "cli.main.description": "Fabric CLI \u2014 \u81EA\u52A8\u628A\u672C\u9879\u76EE\u7684\u51B3\u7B56 / \u8E29\u5751 / \u89C4\u8303\u5582\u7ED9\u4F60\u7684 AI \u52A9\u624B\uFF0C\u8BA9\u5B83\u4E0D\u5FC5\u6BCF\u6B21\u4F1A\u8BDD\u91CD\u65B0\u5B66\u3002\n\n\u4E09\u6B65\u5FC3\u667A\u6A21\u578B\uFF1A\n  \u88C5 (install) - fabric install   \u4E00\u952E\u5B8C\u6210\u9879\u76EE\u521D\u59CB\u5316\n  \u914D (config)  - fabric config    \u6253\u5F00\u4EA4\u4E92\u5F0F\u914D\u7F6E\u9762\u677F\n  \u8DD1 (run)     - fabric serve     \u542F\u52A8\u672C\u5730 MCP HTTP \u670D\u52A1\n                fabric doctor     \u8FD0\u884C\u76EE\u6807\u6001\u8BCA\u65AD\n\n\u793A\u4F8B\uFF1A\n  fabric install                  \u5728\u5F53\u524D\u9879\u76EE\u4E2D\u5B89\u88C5 Fabric\n  fabric config                   \u6253\u5F00\u4EA4\u4E92\u5F0F\u914D\u7F6E\u9762\u677F\n  fabric serve --port 7373        \u542F\u52A8 MCP HTTP \u670D\u52A1\n  fabric doctor --fix             \u4FEE\u590D Fabric \u6D3E\u751F\u72B6\u6001\n  fabric uninstall --dry-run      \u9884\u89C8\u5378\u8F7D\uFF0C\u4E0D\u5220\u9664\u6587\u4EF6",
   "cli.shared.created": "\u5DF2\u521B\u5EFA",
   "cli.shared.skipped": "\u5DF2\u8DF3\u8FC7",
   "cli.shared.next": "\u4E0B\u4E00\u6B65",
@@ -1067,6 +1071,9 @@ var zhCNMessages = {
   "doctor.cite.metric.recalledUnverified": "recalled \u4F46\u672A\u9A8C\u8BC1",
   "doctor.cite.metric.expectedButMissed": "\u5E94\u67E5\u6CA1\u67E5",
   "doctor.cite.metric.totalTurns": "\u603B\u56DE\u5408\u6570",
+  "doctor.cite.metric.complianceRate": "cite \u5408\u89C4\u7387 (\u542B KB:none[reason])",
+  "doctor.cite.metric.complianceNA": "N/A (\u65E0\u5E94 cite \u56DE\u5408)",
+  "doctor.cite.metric.uncorrelatableEdits": "\u65E0\u6CD5\u5173\u8054\u7684 edit (\u7F3A session_id \u2014 hook \u8FC7\u671F? \u8BF7\u8DD1 `fabric install`)",
   "doctor.cite.section.perClient": "\u6309\u5BA2\u6237\u7AEF\u62C6\u5206",
   "doctor.cite.section.dismissedReasons": "\u9A73\u56DE\u539F\u56E0\u5206\u5E03",
   "doctor.cite.dismissed.scope-mismatch": "\u8303\u56F4\u4E0D\u7B26",
@@ -1572,6 +1579,7 @@ var zhCNMessages = {
   // 时 spawn, 已运行的 Claude Code / Cursor / Codex session 不会自动加载
   // 新 mcp config — 必须重启才能拿到 Fabric tools。
   "cli.install.restart-banner": "\u91CD\u542F\u63D0\u793A: \u5DF2\u8FD0\u884C\u7684 Claude Code / Cursor / Codex CLI session \u9700\u91CD\u542F\u624D\u80FD\u52A0\u8F7D\u65B0 MCP server \u914D\u7F6E;\u65B0\u4F1A\u8BDD\u4F1A\u81EA\u52A8\u4F7F\u7528 Fabric tools\u3002",
+  "cli.install.next-steps": "\u4E0B\u4E00\u6B65 \u2014\u2014 \u62FF\u5230\u7B2C\u4E00\u4EFD\u4EF7\u503C:\n  1. \u91CD\u542F\u4F60\u7684 AI \u5BA2\u6237\u7AEF (Claude Code / Codex)\u3002\u5B83\u73B0\u5728\u4F1A\u81EA\u52A8\u628A\u672C\u9879\u76EE\u7684\u77E5\u8BC6 surface \u7ED9\u52A9\u624B\u3002\n  2. \u6C89\u6DC0\u77E5\u8BC6: \u6B63\u5E38\u5E72\u6D3B\u5373\u53EF \u2014\u2014 \u5F53\u4F60\u505A\u51B3\u7B56\u6216\u8E29\u5751\u65F6, fabric-archive skill \u4F1A\u63D0\u8BAE\u5165\u5E93; \u6216\u8DD1 fabric-import skill \u4ECE git \u5386\u53F2\u56DE\u704C\u3002\n  3. \u9A8C\u8BC1\u751F\u6548: \u95EE\u4F60\u7684 AI\u300CFabric \u5BF9\u8FD9\u4E2A repo \u77E5\u9053\u4E9B\u4EC0\u4E48?\u300D, \u6216\u8DD1 `fabric doctor` \u67E5\u5065\u5EB7\u3002",
   "cli.install.capabilities.none": "\u6CA1\u6709\u68C0\u6D4B\u5230\u53EF\u7528\u4E8E bootstrap \u6216 MCP \u540E\u7EED\u63A5\u529B\u7684\u53D7\u652F\u6301\u5BA2\u6237\u7AEF\u3002",
   "cli.install.capabilities.header.client": "\u5BA2\u6237\u7AEF",
   "cli.install.capabilities.header.bootstrap": "Bootstrap",

package/dist/{chunk-VWJQVRSE.js → chunk-LTDB2UDN.js}

@@ -35,13 +35,13 @@ var BOOTSTRAP_CANONICAL = `# Fabric Bootstrap
 \u5B8C\u6574 maintainer \u7248\u89C1 \`docs/USER-QUICKSTART.md\`\u3002
 
 ## \u884C\u4E3A\u89C4\u5219
-- **\u4FEE\u6539\u4EFB\u4F55\u6587\u4EF6\u524D**:\u4E24\u6B65\u8C03\u7528\u2014\u2014\u5148 \`fab_plan_context(paths=[<\u88AB\u6539\u6587\u4EF6>])\` \u62FF\u5230 \`selection_token\` \u4E0E\u5019\u9009 \`entries\`(\u6311 \`selectable===true\` \u7684 \`stable_id\`),\u518D \`fab_get_knowledge_sections({ selection_token, ai_selected_stable_ids: [<id>...] })\` \u53D6\u89C4\u5219\u6B63\u6587\u3002
+- **\u4FEE\u6539\u4EFB\u4F55\u6587\u4EF6\u524D**:\u4F18\u5148\u5355\u6B65 \`fab_recall(paths=[<\u88AB\u6539\u6587\u4EF6>])\` \u2014\u2014 \u4E00\u6B21\u8C03\u7528\u76F4\u63A5\u62FF\u56DE\u6240\u6709\u76F8\u5173 KB \u6B63\u6587(rc.37+ \u9ED8\u8BA4\u8DEF\u5F84,\u7701\u6389\u624B\u52A8\u6311 id \u7684\u73AF\u8282)\u3002**\u4EC5\u5F53\u5355\u6B65\u62C9\u56DE\u7684\u6B63\u6587\u8FC7\u591A\u3001\u5BFC\u81F4\u4E0A\u4E0B\u6587\u8FC7\u8F7D\u9700\u7CBE\u786E\u88C1\u526A\u566A\u97F3\u65F6**\u624D\u8D70\u4E24\u6B65:\u5148 \`fab_plan_context(paths=[...])\` \u62FF \`selection_token\` + \u9876\u5C42 \`candidates[]\`(\u4ECE \`candidates[].stable_id\` \u6311),\u518D \`fab_get_knowledge_sections({ selection_token, ai_selected_stable_ids: [<id>...] })\` \u53D6\u6B63\u6587\u3002
 - **\`.fabric/agents.meta.json\` \u4E25\u7981\u624B\u52A8\u7F16\u8F91**;engine \u4F1A\u81EA\u52A8\u540C\u6B65\u6D3E\u751F\u72B6\u6001,\u663E\u5F0F reconcile \u8DD1 \`fabric doctor --fix\`\u3002
 
 ## \u77E5\u8BC6\u5E93(KB)
 - **Discovery**:SessionStart hook \u5217 broad-scoped \u6761\u76EE(\u542B personal layer \`KP-*\` \u6761\u76EE,\u5F15\u7528\u65B9\u5F0F\u76F8\u540C);edit \u6587\u4EF6\u65F6 PreToolUse hook \u53EF\u80FD\u89E6\u53D1 narrow hint\u3002
-- **Usage**:\u4E24\u6B65\u5F0F\u2014\u2014\`fab_plan_context(paths=[...])\` \u8FD4\u56DE \`selection_token\` + \u5019\u9009 entries,\u518D \`fab_get_knowledge_sections({ selection_token, ai_selected_stable_ids: [<id>...] })\` \u62C9\u5168\u6587;\`selection_token\` \u5FC5\u987B\u6765\u81EA\u6700\u8FD1\u4E00\u6B21 \`fab_plan_context\`,\u4E0D\u53EF\u51ED\u7A7A\u7F16\u9020\u3002
-- **session_id**: \u8C03\u7528 \`fab_plan_context\` \u65F6, \u52A1\u5FC5\u628A\u5F53\u524D client session id \u4F5C\u4E3A \`session_id\` \u53C2\u6570\u4F20\u5165(Claude Code \u7684 session id \u5728 stdin payload \u4E2D, Codex \u7684\u5BF9\u5E94 identifier \u540C\u7406)\u3002\u8FD9\u80FD\u8BA9 \`fabric doctor --archive-history\` \u4E0E archive-hint hook \u51C6\u786E\u8BC6\u522B\u8DE8\u4F1A\u8BDD debt \u72B6\u6001\u3002
+- **Usage**:\u5E38\u6001\u8D70\u5355\u6B65 \`fab_recall(paths=[...])\` \u4E00\u6B21\u62FF\u56DE\u76F8\u5173 KB \u6B63\u6587\u3002\u4EC5\u5F53\u5355\u6B65\u6B63\u6587\u8FC7\u591A\u81F4\u4E0A\u4E0B\u6587\u8FC7\u8F7D\u3001\u9700\u7CBE\u786E\u88C1\u526A\u566A\u97F3\u65F6\u624D\u4E24\u6B65:\`fab_plan_context(paths=[...])\` \u8FD4\u56DE \`selection_token\` + \u9876\u5C42 \`candidates[]\`,\u518D \`fab_get_knowledge_sections({ selection_token, ai_selected_stable_ids: [<\u4ECE candidates[].stable_id \u6311>...] })\` \u62C9\u5168\u6587;\`selection_token\` \u5FC5\u987B\u6765\u81EA\u6700\u8FD1\u4E00\u6B21 \`fab_plan_context\`,\u4E0D\u53EF\u51ED\u7A7A\u7F16\u9020\u3002
+- **session_id**: \u8C03\u7528 \`fab_recall\` / \`fab_plan_context\` \u65F6, \u52A1\u5FC5\u628A\u5F53\u524D client session id \u4F5C\u4E3A \`session_id\` \u53C2\u6570\u4F20\u5165(Claude Code \u7684 session id \u5728 stdin payload \u4E2D, Codex \u7684\u5BF9\u5E94 identifier \u540C\u7406)\u3002\u8FD9\u80FD\u8BA9 \`fabric doctor --archive-history\` \u4E0E archive-hint hook \u51C6\u786E\u8BC6\u522B\u8DE8\u4F1A\u8BDD debt \u72B6\u6001\u3002
 - **Write flows**:\`fabric-archive\` / \`fabric-review\` / \`fabric-import\` \u4E09\u4E2A Skills\u3002
 - **Language**:\u6E32\u67D3\u6309 \`.fabric/fabric-config.json\` \u7684 \`fabric_language\` \u5B57\u6BB5\u3002
 - **Archive cadence nudge** (rc.36): \u6BCF\u5B8C\u6210 5+ \u6B21 Edit / \u663E\u8457 decision \u540E,\u5728\u5408\u9002\u56DE\u5408\u4E3B\u52A8 propose \u8C03 \`fabric-archive\` skill \u2014 archive \u6CA1\u5EFA\u7ACB\u9891\u7387\u4F1A\u8BA9 KB \u6162\u901F\u6B7B\u6389\u3002

package/dist/{chunk-DRQTQEEV.js → chunk-WVPDH4BF.js}

@@ -37,42 +37,22 @@ var _ruleDescriptionSchema = z2.object({
   maturity: _maturityEnum.optional(),
   knowledge_layer: _layerEnum.optional(),
   layer_reason: z2.string().optional(),
-  created_at: z2.string().optional()
-});
-var _descriptionIndexItemSchema = z2.object({
-  stable_id: z2.string(),
-  level: z2.enum(["L0", "L1", "L2"]),
-  required: z2.boolean(),
-  selectable: z2.boolean(),
-  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: z2.string().optional(),
-  // v2/rc.2: tag list shipped via frontmatter (commit a85121a). Exposed at
-  // the API surface so MCP clients can filter without re-parsing the
-  // description payload. Absent on legacy entries; consumers should treat
-  // missing as [].
+  created_at: z2.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,
+  // `description` becomes their canonical (and only) home, so the schema must
+  // validate them here. Optional + default-safe (tags/[]/broad) so legacy
+  // entries without frontmatter still parse.
   tags: z2.array(z2.string()).optional(),
-  // v2.0-rc.5 (C1): relevance scope/paths drive plan-context-hint narrowing.
-  // Exposed at the API surface so MCP clients (and the `fabric
-  // plan-context-hint` CLI from D1) can filter without re-parsing the
-  // description payload. Defaults applied at the parse layer
-  // (knowledge-meta-builder + agentsMetaNodeBaseSchema):
-  //   relevance_scope → 'broad'  (always-surface, safe default)
-  //   relevance_paths → []       (no path anchors)
-  // Consumers should treat missing fields as broad/[]. Optional on the wire
-  // so older servers without rc.5 schemas remain wire-compatible.
   relevance_scope: z2.enum(["narrow", "broad"]).optional(),
   relevance_paths: z2.array(z2.string()).optional()
 });
+var _descriptionIndexItemSchema = z2.object({
+  stable_id: z2.string(),
+  description: _ruleDescriptionSchema
+});
 var _requirementProfileSchema = z2.object({
   target_path: z2.string(),
-  path_segments: z2.array(z2.string()),
-  extension: z2.string(),
   known_tech: z2.array(z2.string()),
   user_intent: z2.string(),
   detected_entities: z2.array(z2.string())
@@ -104,6 +84,18 @@ var planContextInputSchema = z2.object({
     "Path context for narrow-scope relevance filtering. Defaults to `paths`; empty = no filter."
   )
 });
+var _preflightDiagnosticSchema = z2.object({
+  // v2.0.0-rc.38 UX-2: `empty_shell_suppressed` surfaces draft entries whose
+  // description carries no selection signal (summary === stable_id + empty
+  // intent_clues/tech_stack/impact). They are filtered out of `candidates` to
+  // cut noise; this diagnostic names them so `fabric doctor` /
+  // --enrich-descriptions can prompt enrichment.
+  code: z2.enum(["missing_description", "empty_shell_suppressed"]),
+  severity: z2.literal("warn"),
+  message: z2.string(),
+  stable_ids: z2.array(z2.string()).optional(),
+  path: z2.string().optional()
+});
 var planContextOutputSchema = z2.object({
   revision_hash: z2.string(),
   stale: z2.boolean(),
@@ -111,22 +103,11 @@ var planContextOutputSchema = z2.object({
   entries: z2.array(
     z2.object({
       path: z2.string(),
-      requirement_profile: _requirementProfileSchema,
-      description_index: z2.array(_descriptionIndexItemSchema)
+      requirement_profile: _requirementProfileSchema
     })
   ),
-  shared: z2.object({
-    description_index: z2.array(_descriptionIndexItemSchema),
-    preflight_diagnostics: z2.array(
-      z2.object({
-        code: z2.literal("missing_description"),
-        severity: z2.literal("warn"),
-        message: z2.string(),
-        stable_ids: z2.array(z2.string()).optional(),
-        path: z2.string().optional()
-      })
-    )
-  }),
+  candidates: z2.array(_descriptionIndexItemSchema),
+  preflight_diagnostics: z2.array(_preflightDiagnosticSchema),
   warnings: z2.array(structuredWarningSchema).optional(),
   // v2.0.0-rc.22 Scope D T-D2: optional auto-heal banner fields. Surfaced
   // ONLY when the loadActiveMetaOrStale call detected drift and rebuilt the
@@ -167,7 +148,7 @@ var planContextHintOutputSchema = z2.object({
 var knowledgeSectionsInputSchema = z2.object({
   selection_token: z2.string().min(1).describe("Selection token returned by fab_plan_context"),
   ai_selected_stable_ids: z2.array(z2.string()).describe(
-    "Stable ids picked from fab_plan_context entries[].description_index[].stable_id where selectable=true; choose 1..N to fetch bodies for"
+    "Stable ids picked from fab_plan_context candidates[].stable_id; choose 1..N to fetch bodies for"
   ),
   ai_selection_reasons: z2.record(z2.string().min(1)).describe("Reason for each AI-selected L1 stable_id"),
   correlation_id: z2.string().optional().describe("Optional caller-provided correlation id for Event Ledger records"),
@@ -179,16 +160,10 @@ var knowledgeSectionsInputSchema = z2.object({
 });
 var knowledgeSectionsOutputSchema = z2.object({
   revision_hash: z2.string(),
-  /**
-   * @deprecated rc.23 TASK-002 F3 — removed in rc.24. The L0/L1/L2 selection
-   * ceremony was fully retired in rc.5 A3 (see comment above
-   * `planContextOutputSchema`); downstream consumers should use
-   * `rules[].level` directly. Kept as optional for one rc to avoid breaking
-   * pre-rc.23 clients that destructure this field.
-   */
-  precedence: z2.tuple([z2.literal("L2"), z2.literal("L1"), z2.literal("L0")]).optional().describe(
-    "DEPRECATED (removed in rc.24): hardcoded L2/L1/L0 precedence tuple from the retired rc.5 selection ceremony. Use rules[].level instead."
-  ),
+  // v2.0.0-rc.38 UX-13 (D-MCP step-2 audit): the deprecated `precedence`
+  // L2/L1/L0 tuple (flagged "removed in rc.24" but still emitted) is gone — it
+  // was a constant 3-string field on every response read by no production
+  // consumer. Use rules[].level for ordering.
   selected_stable_ids: z2.array(z2.string()),
   rules: z2.array(
     z2.object({
@@ -267,25 +242,17 @@ var recallOutputSchema = z2.object({
   // with fab_get_knowledge_sections (e.g. fetch additional ids later) — every
   // recall response is still token-backed internally.
   selection_token: z2.string(),
+  // v2.0.0-rc.38 UX-1/UX-4: mirrors planContextOutputSchema fold ① — per-path
+  // description_index collapsed into a single top-level `candidates`, and
+  // `preflight_diagnostics` lifted out of the removed `shared` wrapper.
   entries: z2.array(
     z2.object({
       path: z2.string(),
-      requirement_profile: _requirementProfileSchema,
-      description_index: z2.array(_descriptionIndexItemSchema)
+      requirement_profile: _requirementProfileSchema
     })
   ),
-  shared: z2.object({
-    description_index: z2.array(_descriptionIndexItemSchema),
-    preflight_diagnostics: z2.array(
-      z2.object({
-        code: z2.literal("missing_description"),
-        severity: z2.literal("warn"),
-        message: z2.string(),
-        stable_ids: z2.array(z2.string()).optional(),
-        path: z2.string().optional()
-      })
-    )
-  }),
+  candidates: z2.array(_descriptionIndexItemSchema),
+  preflight_diagnostics: z2.array(_preflightDiagnosticSchema),
   // Same shape as knowledgeSectionsOutputSchema.rules — full body keyed by stable_id.
   rules: z2.array(
     z2.object({
@@ -792,7 +759,23 @@ var citeCoverageReportSchema = z2.object({
     qualifying_cites: z2.number().int().nonnegative(),
     recalled_unverified: z2.number().int().nonnegative(),
     expected_but_missed: z2.number().int().nonnegative(),
-    total_turns: z2.number().int().nonnegative()
+    total_turns: z2.number().int().nonnegative(),
+    // v2.0.0-rc.38 UX-8 (C, user-authorized): cite-policy COMPLIANCE rate —
+    // the corrected G-CITE semantic. The legacy qualifying_cites/edits ratio
+    // measured "how often an applicable KB id existed" (a function of corpus
+    // density / soak), NOT "did the AI follow the cite policy". Compliance
+    // credits every valid cite line — `KB: <id> [applied|dismissed]` AND
+    // `KB: none [reason]` (the policy explicitly allows the none sentinel) —
+    // over the turns where a cite was expected. null when no cite-expected
+    // turns observed (avoids a misleading 0/0 → 0). Range [0,1].
+    cite_compliance_rate: z2.number().min(0).max(1).nullable().optional(),
+    compliant_cites: z2.number().int().nonnegative().optional(),
+    noncompliant_cites: z2.number().int().nonnegative().optional(),
+    // Edit signals lacking session_id → uncorrelatable, silently excluded from
+    // expected_but_missed. >0 typically means a stale pre-session_id hook is
+    // installed (run `fabric install`). Surfaced so the denominator gap is
+    // visible rather than a silent 100% confound.
+    uncorrelatable_edits: z2.number().int().nonnegative().optional()
   }),
   per_client: z2.record(
     z2.string(),

package/dist/i18n/index.js

@@ -7,7 +7,7 @@ import {
   normalizeLocale,
   resolveFabricLocale,
   zhCNMessages
-} from "../chunk-ZSRVKMYT.js";
+} from "../chunk-7CX32MYL.js";
 export {
   PROTECTED_TOKENS,
   createTranslator,

package/dist/{index-BkXfeNyz.d.ts → index-UBqD9F0b.d.ts}

@@ -23,16 +23,7 @@ interface RuleDescription {
 }
 interface RuleDescriptionIndexItem {
     stable_id: string;
-    level: AgentsLayer;
-    required: boolean;
-    selectable: boolean;
     description: RuleDescription;
-    type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes";
-    maturity?: "draft" | "verified" | "proven";
-    layer?: "personal" | "team";
-    layer_reason?: string;
-    relevance_scope?: "narrow" | "broad";
-    relevance_paths?: string[];
 }
 interface AgentsMetaNodeActivation {
     tier: AgentsActivationTier;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { A as AgentsMetaNode, a as AgentsIdentitySource, b as AgentsLayer, c as AgentsTopologyType, H as HumanLockEntry, f as fabricConfigSchema, d as AgentsMeta, L as LedgerEntry } from './index-BkXfeNyz.js';
-export { e as AgentsActivationTier, g as AgentsMetaCountersEnvelope, h as AgentsMetaKnowledgeTypeCounters, i as AgentsMetaNodeActivation, j as AiLedgerEntry, k as AuditMode, C as ClientPaths, D as DefaultLayerFilter, F as FabricConfig, l as FabricLanguage, m as HumanLedgerEntry, M as McpPayloadLimits, R as RuleDescription, n as RuleDescriptionIndexItem, o as auditModeSchema, p as clientPathsSchema, q as defaultLayerFilterSchema, r as fabricLanguageSchema, s as mcpPayloadLimitsSchema, t as selectionTokenTtlMsSchema } from './index-BkXfeNyz.js';
+import { A as AgentsMetaNode, a as AgentsIdentitySource, b as AgentsLayer, c as AgentsTopologyType, H as HumanLockEntry, f as fabricConfigSchema, d as AgentsMeta, L as LedgerEntry } from './index-UBqD9F0b.js';
+export { e as AgentsActivationTier, g as AgentsMetaCountersEnvelope, h as AgentsMetaKnowledgeTypeCounters, i as AgentsMetaNodeActivation, j as AiLedgerEntry, k as AuditMode, C as ClientPaths, D as DefaultLayerFilter, F as FabricConfig, l as FabricLanguage, m as HumanLedgerEntry, M as McpPayloadLimits, R as RuleDescription, n as RuleDescriptionIndexItem, o as auditModeSchema, p as clientPathsSchema, q as defaultLayerFilterSchema, r as fabricLanguageSchema, s as mcpPayloadLimitsSchema, t as selectionTokenTtlMsSchema } from './index-UBqD9F0b.js';
 export { Locale, Messages, PROTECTED_TOKENS, ProtectedToken, TranslationKey, Translator, createTranslator, defaultMessages, detectNodeLocale, enMessages, normalizeLocale, resolveFabricLocale, zhCNMessages } from './i18n/index.js';
 import { z } from 'zod';
 import { Layer, KnowledgeType, StableId } from './schemas/api-contracts.js';

package/dist/index.js

@@ -1,4 +1,12 @@
-import "./chunk-LXNCAKJZ.js";
+import {
+  BOOTSTRAP_CANONICAL,
+  BOOTSTRAP_MARKER_BEGIN,
+  BOOTSTRAP_MARKER_END,
+  BOOTSTRAP_REGEX,
+  LEGACY_KB_MARKER_BEGIN,
+  LEGACY_KB_MARKER_END,
+  LEGACY_KB_REGEX
+} from "./chunk-LTDB2UDN.js";
 import {
   PROTECTED_TOKENS,
   createTranslator,
@@ -8,7 +16,7 @@ import {
   normalizeLocale,
   resolveFabricLocale,
   zhCNMessages
-} from "./chunk-ZSRVKMYT.js";
+} from "./chunk-7CX32MYL.js";
 import {
   FabExtractKnowledgeInputSchema,
   FabExtractKnowledgeInputShape,
@@ -56,16 +64,8 @@ import {
   recallInputSchema,
   recallOutputSchema,
   structuredWarningSchema
-} from "./chunk-DRQTQEEV.js";
-import {
-  BOOTSTRAP_CANONICAL,
-  BOOTSTRAP_MARKER_BEGIN,
-  BOOTSTRAP_MARKER_END,
-  BOOTSTRAP_REGEX,
-  LEGACY_KB_MARKER_BEGIN,
-  LEGACY_KB_MARKER_END,
-  LEGACY_KB_REGEX
-} from "./chunk-VWJQVRSE.js";
+} from "./chunk-WVPDH4BF.js";
+import "./chunk-LXNCAKJZ.js";
 
 // src/schemas/agents-meta.ts
 import { z } from "zod";