@fenglimg/fabric-shared 1.8.0-rc.3 → 2.0.0-rc.10

package/dist/index.js

@@ -1,4 +1,3 @@
-import "./chunk-LXNCAKJZ.js";
 import {
   PROTECTED_TOKENS,
   createTranslator,
@@ -7,25 +6,47 @@ import {
   enMessages,
   normalizeLocale,
   zhCNMessages
-} from "./chunk-FEEWLYO3.js";
+} from "./chunk-YGEE3WMC.js";
 import {
+  FabExtractKnowledgeInputSchema,
+  FabExtractKnowledgeInputShape,
+  FabExtractKnowledgeOutputSchema,
+  FabReviewInputSchema,
+  FabReviewInputShape,
+  FabReviewOutputSchema,
+  FabReviewOutputShape,
+  KNOWLEDGE_TYPE_CODES,
+  KnowledgeEntryFrontmatterSchema,
+  KnowledgeTypeSchema,
+  LayerSchema,
+  MaturitySchema,
+  PROPOSED_REASON_DESCRIPTIONS,
+  ProposedReasonSchema,
+  StableIdSchema,
   annotateIntentRequestSchema,
-  getRulesAnnotations,
-  getRulesInputSchema,
-  getRulesOutputSchema,
+  fabExtractKnowledgeAnnotations,
+  fabReviewAnnotations,
+  formatKnowledgeId,
+  getKnowledgeAnnotations,
+  getKnowledgeInputSchema,
+  getKnowledgeOutputSchema,
   historyStateQuerySchema,
   humanLockApproveRequestSchema,
   humanLockFileParamsSchema,
+  knowledgeSectionsAnnotations,
+  knowledgeSectionsInputSchema,
+  knowledgeSectionsOutputSchema,
   ledgerQuerySchema,
   ledgerSourceSchema,
+  parseKnowledgeId,
   planContextAnnotations,
+  planContextHintNarrowEntrySchema,
+  planContextHintOutputSchema,
   planContextInputSchema,
   planContextOutputSchema,
-  ruleSectionsAnnotations,
-  ruleSectionsInputSchema,
-  ruleSectionsOutputSchema,
   structuredWarningSchema
-} from "./chunk-KV27CZH3.js";
+} from "./chunk-G4IKTNY4.js";
+import "./chunk-LXNCAKJZ.js";
 
 // src/schemas/agents-meta.ts
 import { z } from "zod";
@@ -42,7 +63,22 @@ 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()
+  entities: z.array(z.string()).optional(),
+  // v2.0 knowledge entry fields (TASK-002 schemas). All optional for backward compat.
+  id: z.string().optional(),
+  knowledge_type: z.enum(["model", "decision", "guideline", "pitfall", "process"]).optional(),
+  maturity: z.enum(["draft", "verified", "proven"]).optional(),
+  knowledge_layer: z.enum(["personal", "team"]).optional(),
+  layer_reason: z.string().optional(),
+  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(),
+  // v2.0-rc.5 (C1): relevance scope/paths drive plan-context-hint narrowing.
+  // Defaults applied so existing entries lacking these fields parse cleanly:
+  //   relevance_scope → 'broad'   (always-surface, safe default)
+  //   relevance_paths → []        (no path anchors)
+  relevance_scope: z.enum(["narrow", "broad"]).default("broad"),
+  relevance_paths: z.array(z.string()).default([])
 }).strict();
 var ruleDescriptionIndexItemSchema = z.object({
   stable_id: z.string(),
@@ -55,11 +91,6 @@ var agentsMetaNodeBaseSchema = z.object({
   file: z.string(),
   content_ref: z.string().optional(),
   scope_glob: z.string(),
-  deps: z.array(z.string()),
-  priority: z.enum(["high", "medium", "low"]),
-  level: agentsLayerSchema.optional(),
-  layer: agentsLayerSchema,
-  topology_type: agentsTopologyTypeSchema,
   hash: z.string(),
   stable_id: z.string().optional(),
   identity_source: agentsIdentitySourceSchema.optional(),
@@ -69,20 +100,40 @@ var agentsMetaNodeBaseSchema = z.object({
   }).optional(),
   description: ruleDescriptionSchema.optional(),
   sections: z.array(z.string()).optional()
-});
+}).passthrough();
 var agentsMetaNodeSchema = z.preprocess((value) => {
   if (!isRecord(value) || typeof value.file !== "string") {
     return value;
   }
   return withDerivedAgentsMetaNodeDefaults(value);
 }, agentsMetaNodeBaseSchema);
+var knowledgeTypeCountersSchema = z.object({
+  MOD: z.number().int().nonnegative().default(0),
+  DEC: z.number().int().nonnegative().default(0),
+  GLD: z.number().int().nonnegative().default(0),
+  PIT: z.number().int().nonnegative().default(0),
+  PRO: z.number().int().nonnegative().default(0)
+}).default({ MOD: 0, DEC: 0, GLD: 0, PIT: 0, PRO: 0 });
+var AgentsMetaCountersSchema = z.object({
+  KP: knowledgeTypeCountersSchema,
+  KT: knowledgeTypeCountersSchema
+}).default({
+  KP: { MOD: 0, DEC: 0, GLD: 0, PIT: 0, PRO: 0 },
+  KT: { MOD: 0, DEC: 0, GLD: 0, PIT: 0, PRO: 0 }
+});
 var agentsMetaSchema = z.object({
   revision: z.string(),
-  nodes: z.record(agentsMetaNodeSchema)
+  nodes: z.record(agentsMetaNodeSchema),
+  counters: AgentsMetaCountersSchema.optional()
 });
+var KNOWLEDGE_STABLE_ID_PATTERN = /^K[PT]-(MOD|DEC|GLD|PIT|PRO)-\d{4,}$/u;
+function isKnowledgeStableId(stableId) {
+  return stableId !== void 0 && KNOWLEDGE_STABLE_ID_PATTERN.test(stableId);
+}
 function withDerivedAgentsMetaNodeDefaults(node) {
+  const isKnowledgeEntry = isKnowledgeStableId(node.stable_id);
   const stableId = node.stable_id ?? deriveAgentsMetaStableId(node.file);
-  const identitySource = deriveAgentsMetaIdentitySource(node);
+  const identitySource = isKnowledgeEntry ? "declared" : deriveAgentsMetaIdentitySource(node);
   return {
     ...node,
     layer: node.layer ?? node.level ?? deriveAgentsMetaLayer(node.file),
@@ -92,6 +143,27 @@ function withDerivedAgentsMetaNodeDefaults(node) {
     identity_source: identitySource
   };
 }
+function allocateKnowledgeId(layer, type, current) {
+  const layerKey = layer === "personal" ? "KP" : "KT";
+  const typeCode = KNOWLEDGE_TYPE_CODES[type];
+  const previousCount = current[layerKey][typeCode] ?? 0;
+  const nextCount = previousCount + 1;
+  const id = formatKnowledgeId(layer, type, nextCount);
+  const nextCounters = {
+    ...current,
+    [layerKey]: {
+      ...current[layerKey],
+      [typeCode]: nextCount
+    }
+  };
+  return { id, nextCounters };
+}
+function defaultAgentsMetaCounters() {
+  return {
+    KP: { MOD: 0, DEC: 0, GLD: 0, PIT: 0, PRO: 0 },
+    KT: { MOD: 0, DEC: 0, GLD: 0, PIT: 0, PRO: 0 }
+  };
+}
 function deriveAgentsMetaStableId(file) {
   const normalized = normalizePath(file);
   if (normalized === "AGENTS.md" || normalized === ".fabric/bootstrap/README.md") {
@@ -103,6 +175,9 @@ function deriveAgentsMetaIdentitySource(node) {
   if (node.identity_source !== void 0) {
     return node.identity_source;
   }
+  if (isKnowledgeStableId(node.stable_id)) {
+    return "declared";
+  }
   const derivedStableId = deriveAgentsMetaStableId(node.file);
   return node.stable_id !== void 0 && node.stable_id !== derivedStableId ? "declared" : "derived";
 }
@@ -144,11 +219,11 @@ function isRecord(value) {
   return typeof value === "object" && value !== null;
 }
 
-// src/schemas/rule-test-index.ts
+// src/schemas/knowledge-test-index.ts
 import { z as z2 } from "zod";
-var RULE_TEST_INDEX_SCHEMA_VERSION = 1;
+var KNOWLEDGE_TEST_INDEX_SCHEMA_VERSION = 1;
 var hashSchema = z2.string().min(1);
-var ruleTestLinkSchema = z2.object({
+var knowledgeTestLinkSchema = z2.object({
   rule_stable_id: z2.string().min(1),
   rule_file: z2.string().min(1),
   rule_hash: hashSchema,
@@ -158,20 +233,20 @@ var ruleTestLinkSchema = z2.object({
   previous_test_hash: hashSchema.optional(),
   annotation_line: z2.number().int().positive()
 }).strict();
-var ruleTestOrphanAnnotationSchema = z2.object({
+var knowledgeTestOrphanAnnotationSchema = z2.object({
   rule_stable_id: z2.string().min(1),
   test_file: z2.string().min(1),
   test_hash: hashSchema,
   previous_test_hash: hashSchema.optional(),
   annotation_line: z2.number().int().positive()
 }).strict();
-var ruleTestIndexSchema = z2.object({
-  schema_version: z2.literal(RULE_TEST_INDEX_SCHEMA_VERSION),
+var knowledgeTestIndexSchema = z2.object({
+  schema_version: z2.literal(KNOWLEDGE_TEST_INDEX_SCHEMA_VERSION),
   generated_at: z2.string().datetime({ offset: true }),
   revision: z2.string().min(1).optional(),
   previous_revision: z2.string().min(1).optional(),
-  links: z2.array(ruleTestLinkSchema),
-  orphan_annotations: z2.array(ruleTestOrphanAnnotationSchema)
+  links: z2.array(knowledgeTestLinkSchema),
+  orphan_annotations: z2.array(knowledgeTestOrphanAnnotationSchema)
 }).strict();
 
 // src/schemas/ledger-entry.ts
@@ -226,18 +301,79 @@ var clientPathsSchema = z5.object({
   claudeCodeDesktop: z5.string().optional(),
   cursor: z5.string().optional(),
   codexCLI: z5.string().optional()
-}).passthrough();
+}).strict();
 var mcpPayloadLimitsSchema = z5.object({
   warnBytes: z5.number().int().positive().optional(),
   hardBytes: z5.number().int().positive().optional()
 }).optional();
+var knowledgeLanguageSchema = z5.enum(["match-existing", "zh-CN", "en"]);
+var defaultLayerFilterSchema = z5.enum(["team", "personal", "both"]);
 var fabricConfigSchema = z5.object({
   clientPaths: clientPathsSchema.optional(),
   externalFixturePath: z5.string().optional(),
   scanIgnores: z5.array(z5.string()).optional(),
   auditMode: auditModeSchema.optional(),
   audit_mode: auditModeSchema.optional(),
-  mcpPayloadLimits: mcpPayloadLimitsSchema
+  mcpPayloadLimits: mcpPayloadLimitsSchema,
+  // Backward-compat: both fields are optional with defaults so existing
+  // fabric-config.json files (pre-grill-followup) parse unchanged. The default
+  // values themselves are load-bearing — see docs/data-schema.md.
+  knowledge_language: knowledgeLanguageSchema.optional().default("match-existing"),
+  default_layer_filter: defaultLayerFilterSchema.optional().default("both"),
+  // Cooldown for the fabric-hint Stop hook (formerly archive-hint, renamed in
+  // rc.5 TASK-010). After ANY of the three signals (archive / review / import)
+  // fires, that signal stays silent for this many hours regardless of state
+  // drift — purely a reminder throttle. Default 12 means "at most twice per
+  // day if the user keeps ignoring it." Set to 24 to align with the archive
+  // trigger threshold. The legacy `archive_hint_` key is retained for backward
+  // compat with existing user fabric-config.json files.
+  archive_hint_cooldown_hours: z5.number().int().positive().optional().default(12),
+  // Underseed-node threshold for the fabric-hint Stop hook's import signal
+  // (rc.5 TASK-010). When the canonical knowledge node count is strictly less
+  // than this value AND a successful `init_scan_completed` event happened at
+  // least 24h ago AND no `knowledge_proposed` event has fired in the last 24h,
+  // the hook recommends running the fabric-import skill. Default 10 reflects
+  // the rule-of-thumb that a workspace with fewer than ten knowledge entries
+  // is below the floor for plan_context retrieval to be meaningful. Also
+  // consumed by `doctor` lint #22 (knowledge_underseeded).
+  underseed_node_threshold: z5.number().int().positive().optional().default(10),
+  // Edit-count threshold for the fabric-hint Stop hook's Signal A
+  // (rc.6 TASK-022 / E5). Signal A fires when EITHER (a) >=24h have elapsed
+  // since the last `knowledge_proposed` event, OR (b) >=archive_edit_threshold
+  // PreToolUse fires have been recorded in `.fabric/.cache/edit-counter` since
+  // the last `knowledge_proposed` event. The edit-counter sidecar is populated
+  // by the rc.6 PreToolUse hook (TASK-020 / E4) — one ISO-8601 line per fire.
+  // Default 20 reflects the rule-of-thumb "after ~20 Edit/Write operations
+  // there is probably something worth archiving"; lowered values nag more
+  // aggressively, higher values rely on the 24h fallback. Missing or absent
+  // edit-counter file degrades safely to the 24h-only path.
+  archive_edit_threshold: z5.number().int().positive().optional().default(20),
+  // rc.7 T7: hours-since-last-knowledge_proposed cutoff for Signal A's
+  // time branch. Was hardcoded as 24 in fabric-hint.cjs's THRESHOLD_HOURS;
+  // externalized so chatty workspaces can lower the bar and quiet ones can
+  // raise it. Default 24 preserves rc.6 behavior. See docs/configuration.md.
+  archive_hint_hours: z5.number().int().positive().optional().default(24),
+  // rc.7 T7: pending-count cutoff for Signal B (review skill). Was
+  // hardcoded as 10 in fabric-hint.cjs's THRESHOLD_PENDING_COUNT.
+  // Default 10 preserves rc.6 behavior. See docs/configuration.md for
+  // small/medium/large repo recommendations.
+  review_hint_pending_count: z5.number().int().positive().optional().default(10),
+  // rc.7 T7: pending-age cutoff (in days) for Signal B (review skill).
+  // Was hardcoded as 7 in fabric-hint.cjs's THRESHOLD_PENDING_AGE_DAYS.
+  // Default 7 preserves rc.6 behavior. See docs/configuration.md.
+  review_hint_pending_age_days: z5.number().int().positive().optional().default(7),
+  // rc.7 T7 + T10 pre-wiring: days-since-last-doctor cutoff for the future
+  // Signal D (maintenance hint). T10 will consume this to decide when the
+  // fabric-hint Stop hook surfaces a "run `fabric doctor`" reminder.
+  // Default 14 reflects a fortnightly cadence — long enough to avoid nag,
+  // short enough to catch index drift before it compounds.
+  maintenance_hint_days: z5.number().int().positive().optional().default(14),
+  // rc.7 T7 + T10 pre-wiring: cooldown between Signal D reminders, in
+  // days. Once Signal D fires, it stays silent for this many days even if
+  // the user doesn't run doctor. Default 7 keeps the reminder weekly at
+  // worst — pairing 14d trigger + 7d cooldown means at most ~2 reminders
+  // per month for a workspace that ignores them.
+  maintenance_hint_cooldown_days: z5.number().int().positive().optional().default(7)
 });
 
 // src/schemas/forensic-report.ts
@@ -408,9 +544,9 @@ var eventLedgerEnvelopeSchema = {
   session_id: z9.string().optional()
 };
 var stringRecordSchema = z9.record(z9.string());
-var ruleContextPlannedEventSchema = z9.object({
+var knowledgeContextPlannedEventSchema = z9.object({
   ...eventLedgerEnvelopeSchema,
-  event_type: z9.literal("rule_context_planned"),
+  event_type: z9.literal("knowledge_context_planned"),
   target_paths: z9.array(z9.string()),
   required_stable_ids: z9.array(z9.string()),
   ai_selectable_stable_ids: z9.array(z9.string()),
@@ -421,9 +557,9 @@ var ruleContextPlannedEventSchema = z9.object({
   known_tech: z9.array(z9.string()).optional(),
   diagnostics: z9.array(z9.unknown()).optional()
 });
-var ruleSelectionEventSchema = z9.object({
+var knowledgeSelectionEventSchema = z9.object({
   ...eventLedgerEnvelopeSchema,
-  event_type: z9.literal("rule_selection"),
+  event_type: z9.literal("knowledge_selection"),
   selection_token: z9.string(),
   target_paths: z9.array(z9.string()),
   required_stable_ids: z9.array(z9.string()),
@@ -434,9 +570,9 @@ var ruleSelectionEventSchema = z9.object({
   rejected_stable_ids: z9.array(z9.string()),
   ignored_stable_ids: z9.array(z9.string())
 });
-var ruleSectionsFetchedEventSchema = z9.object({
+var knowledgeSectionsFetchedEventSchema = z9.object({
   ...eventLedgerEnvelopeSchema,
-  event_type: z9.literal("rule_sections_fetched"),
+  event_type: z9.literal("knowledge_sections_fetched"),
   selection_token: z9.string(),
   target_paths: z9.array(z9.string()).optional(),
   requested_sections: z9.array(z9.string()),
@@ -460,9 +596,9 @@ var editIntentCheckedEventSchema = z9.object({
   matched_rule_context_ts: z9.number().int().nonnegative().nullable(),
   window_ms: z9.number().int().nonnegative()
 });
-var ruleDriftDetectedEventSchema = z9.object({
+var knowledgeDriftDetectedEventSchema = z9.object({
   ...eventLedgerEnvelopeSchema,
-  event_type: z9.literal("rule_drift_detected"),
+  event_type: z9.literal("knowledge_drift_detected"),
   revision: z9.string().optional(),
   drifted_stable_ids: z9.array(z9.string()),
   missing_files: z9.array(z9.string()),
@@ -476,23 +612,6 @@ var ruleDriftDetectedEventSchema = z9.object({
     })
   ).optional()
 });
-var ruleBaselineAcceptedEventSchema = z9.object({
-  ...eventLedgerEnvelopeSchema,
-  event_type: z9.literal("rule_baseline_accepted"),
-  revision: z9.string(),
-  previous_revision: z9.string().optional(),
-  accepted_stable_ids: z9.array(z9.string()),
-  source: z9.enum(["doctor_fix", "sync_meta"]).optional()
-});
-var baselineSyncedEventSchema = z9.object({
-  ...eventLedgerEnvelopeSchema,
-  event_type: z9.literal("baseline_synced"),
-  revision: z9.string(),
-  previous_revision: z9.string().optional(),
-  synced_files: z9.array(z9.string()),
-  accepted_stable_ids: z9.array(z9.string()),
-  source: z9.enum(["doctor_fix", "sync_meta"])
-});
 var mcpEventLedgerEventSchema = z9.object({
   ...eventLedgerEnvelopeSchema,
   event_type: z9.literal("mcp_event"),
@@ -525,7 +644,7 @@ var metaReconciledOnStartupEventSchema = z9.object({
   event_type: z9.literal("meta_reconciled_on_startup"),
   reconciled_files: z9.array(z9.string()),
   duration_ms: z9.number().int().nonnegative(),
-  source: z9.literal("reconcileRules")
+  source: z9.literal("reconcileKnowledge")
 });
 var metaReconciledEventSchema = z9.object({
   ...eventLedgerEnvelopeSchema,
@@ -533,7 +652,7 @@ var metaReconciledEventSchema = z9.object({
   reconciled_files: z9.array(z9.string()),
   duration_ms: z9.number().int().nonnegative(),
   trigger: z9.enum(["doctor", "manual"]),
-  source: z9.literal("reconcileRules")
+  source: z9.literal("reconcileKnowledge")
 });
 var claudeSkillPathMigratedEventSchema = z9.object({
   ...eventLedgerEnvelopeSchema,
@@ -553,19 +672,138 @@ var codexSkillPathMigratedEventSchema = z9.object({
   from: z9.string(),
   to: z9.string()
 });
-var legacyClientPathPresentEventSchema = z9.object({
+var initScanCompletedEventSchema = z9.object({
+  ...eventLedgerEnvelopeSchema,
+  event_type: z9.literal("init_scan_completed"),
+  written_stable_ids: z9.array(z9.string()),
+  duration_ms: z9.number().int().nonnegative(),
+  source: z9.enum(["init", "scan", "doctor_fix"]).optional()
+});
+var knowledgeProposedEventSchema = z9.object({
+  ...eventLedgerEnvelopeSchema,
+  event_type: z9.literal("knowledge_proposed"),
+  stable_id: z9.string().optional(),
+  timestamp: z9.string().datetime(),
+  reason: z9.string().optional()
+});
+var knowledgePromoteStartedEventSchema = z9.object({
+  ...eventLedgerEnvelopeSchema,
+  event_type: z9.literal("knowledge_promote_started"),
+  stable_id: z9.string().optional(),
+  timestamp: z9.string().datetime(),
+  reason: z9.string().optional()
+});
+var knowledgePromotedEventSchema = z9.object({
+  ...eventLedgerEnvelopeSchema,
+  event_type: z9.literal("knowledge_promoted"),
+  stable_id: z9.string().optional(),
+  timestamp: z9.string().datetime(),
+  reason: z9.string().optional()
+});
+var knowledgePromoteFailedEventSchema = z9.object({
+  ...eventLedgerEnvelopeSchema,
+  event_type: z9.literal("knowledge_promote_failed"),
+  stable_id: z9.string().optional(),
+  timestamp: z9.string().datetime(),
+  reason: z9.string()
+});
+var knowledgeLayerChangedEventSchema = z9.object({
+  ...eventLedgerEnvelopeSchema,
+  event_type: z9.literal("knowledge_layer_changed"),
+  stable_id: z9.string().optional(),
+  timestamp: z9.string().datetime(),
+  reason: z9.string().optional(),
+  from_layer: z9.enum(["team", "personal"]),
+  to_layer: z9.enum(["team", "personal"])
+});
+var knowledgeSlugRenamedEventSchema = z9.object({
+  ...eventLedgerEnvelopeSchema,
+  event_type: z9.literal("knowledge_slug_renamed"),
+  stable_id: z9.string().optional(),
+  timestamp: z9.string().datetime(),
+  reason: z9.string().optional(),
+  from_slug: z9.string(),
+  to_slug: z9.string()
+});
+var knowledgeDemotedEventSchema = z9.object({
+  ...eventLedgerEnvelopeSchema,
+  event_type: z9.literal("knowledge_demoted"),
+  stable_id: z9.string().optional(),
+  timestamp: z9.string().datetime(),
+  reason: z9.string().optional()
+});
+var knowledgeArchivedEventSchema = z9.object({
+  ...eventLedgerEnvelopeSchema,
+  event_type: z9.literal("knowledge_archived"),
+  stable_id: z9.string().optional(),
+  timestamp: z9.string().datetime(),
+  reason: z9.string().optional()
+});
+var knowledgeArchiveAttemptedEventSchema = z9.object({
+  ...eventLedgerEnvelopeSchema,
+  event_type: z9.literal("knowledge_archive_attempted"),
+  stable_id: z9.string().optional(),
+  timestamp: z9.string().datetime(),
+  reason: z9.string().optional()
+});
+var knowledgeDeferredEventSchema = z9.object({
+  ...eventLedgerEnvelopeSchema,
+  event_type: z9.literal("knowledge_deferred"),
+  stable_id: z9.string().optional(),
+  timestamp: z9.string().datetime(),
+  reason: z9.string().optional(),
+  until: z9.string().datetime().optional()
+});
+var knowledgeRejectedEventSchema = z9.object({
+  ...eventLedgerEnvelopeSchema,
+  event_type: z9.literal("knowledge_rejected"),
+  stable_id: z9.string().optional(),
+  timestamp: z9.string().datetime(),
+  reason: z9.string()
+});
+var knowledgeConsumedEventSchema = z9.object({
+  ...eventLedgerEnvelopeSchema,
+  event_type: z9.literal("knowledge_consumed"),
+  stable_id: z9.string(),
+  consumed_at: z9.string().datetime(),
+  client_hash: z9.string()
+});
+var knowledgeScopeDegradedEventSchema = z9.object({
+  ...eventLedgerEnvelopeSchema,
+  event_type: z9.literal("knowledge_scope_degraded"),
+  stable_id: z9.string(),
+  timestamp: z9.string().datetime(),
+  from_scope: z9.enum(["narrow", "broad"]),
+  to_scope: z9.enum(["narrow", "broad"]),
+  reason: z9.string()
+});
+var doctorRunEventSchema = z9.object({
+  ...eventLedgerEnvelopeSchema,
+  event_type: z9.literal("doctor_run"),
+  mode: z9.enum(["lint", "apply-lint"]),
+  issues: z9.number().int().nonnegative(),
+  mutations: z9.number().int().nonnegative().optional(),
+  timestamp: z9.string().datetime()
+});
+var knowledgePathDangledEventSchema = z9.object({
+  ...eventLedgerEnvelopeSchema,
+  event_type: z9.literal("knowledge_path_dangled"),
+  stable_id: z9.string(),
+  removed_glob: z9.string()
+});
+var pendingAutoArchivedEventSchema = z9.object({
   ...eventLedgerEnvelopeSchema,
-  event_type: z9.literal("legacy_client_path_present"),
-  removed: z9.array(z9.string())
+  event_type: z9.literal("pending_auto_archived"),
+  pending_path: z9.string(),
+  archived_to: z9.string(),
+  reason: z9.string()
 });
 var eventLedgerEventSchema = z9.discriminatedUnion("event_type", [
-  ruleContextPlannedEventSchema,
-  ruleSelectionEventSchema,
-  ruleSectionsFetchedEventSchema,
+  knowledgeContextPlannedEventSchema,
+  knowledgeSelectionEventSchema,
+  knowledgeSectionsFetchedEventSchema,
   editIntentCheckedEventSchema,
-  ruleDriftDetectedEventSchema,
-  ruleBaselineAcceptedEventSchema,
-  baselineSyncedEventSchema,
+  knowledgeDriftDetectedEventSchema,
   mcpEventLedgerEventSchema,
   reapplyCompletedEventSchema,
   eventLedgerTruncatedEventSchema,
@@ -575,40 +813,85 @@ var eventLedgerEventSchema = z9.discriminatedUnion("event_type", [
   claudeSkillPathMigratedEventSchema,
   claudeHookPathMigratedEventSchema,
   codexSkillPathMigratedEventSchema,
-  legacyClientPathPresentEventSchema
+  initScanCompletedEventSchema,
+  // v2.0 rc.2 grill-followup TASK-004: knowledge.* lifecycle pre-registration
+  knowledgeProposedEventSchema,
+  knowledgePromoteStartedEventSchema,
+  knowledgePromotedEventSchema,
+  knowledgePromoteFailedEventSchema,
+  knowledgeLayerChangedEventSchema,
+  knowledgeSlugRenamedEventSchema,
+  knowledgeDemotedEventSchema,
+  knowledgeArchivedEventSchema,
+  knowledgeArchiveAttemptedEventSchema,
+  knowledgeDeferredEventSchema,
+  knowledgeRejectedEventSchema,
+  // v2.0 rc.5 TASK-014: knowledge_consumed (consumption tracking)
+  knowledgeConsumedEventSchema,
+  // v2.0 rc.5 TASK-012 (C3): knowledge_scope_degraded — narrow→broad auto-degrade
+  knowledgeScopeDegradedEventSchema,
+  // v2.0 rc.5 TASK-009 (B2): pending_auto_archived — doctor --apply-lint moves
+  // pending entries >30d old into the .archive/pending/ subtree.
+  pendingAutoArchivedEventSchema,
+  // v2.0 rc.5 TASK-013 (C4): knowledge_path_dangled — emitted by doctor lint
+  // #24 when a glob in relevance_paths resolves to zero filesystem matches.
+  knowledgePathDangledEventSchema,
+  // v2.0.0-rc.7 T10: doctor_run — emitted by `fabric doctor` to drive Signal D.
+  doctorRunEventSchema
 ]);
 export {
   AGENTS_META_IDENTITY_SOURCES,
   AGENTS_META_LAYERS,
   AGENTS_META_TOPOLOGY_TYPES,
+  AgentsMetaCountersSchema,
+  FabExtractKnowledgeInputSchema,
+  FabExtractKnowledgeInputShape,
+  FabExtractKnowledgeOutputSchema,
+  FabReviewInputSchema,
+  FabReviewInputShape,
+  FabReviewOutputSchema,
+  FabReviewOutputShape,
+  KNOWLEDGE_TEST_INDEX_SCHEMA_VERSION,
+  KNOWLEDGE_TYPE_CODES,
+  KnowledgeEntryFrontmatterSchema,
+  KnowledgeTypeSchema,
+  LayerSchema,
+  MaturitySchema,
+  PROPOSED_REASON_DESCRIPTIONS,
   PROTECTED_TOKENS,
-  RULE_TEST_INDEX_SCHEMA_VERSION,
+  ProposedReasonSchema,
+  StableIdSchema,
   agentsIdentitySourceSchema,
   agentsLayerSchema,
   agentsMetaNodeSchema,
   agentsMetaSchema,
   agentsTopologyTypeSchema,
   aiLedgerEntrySchema,
+  allocateKnowledgeId,
   annotateIntentRequestSchema,
   auditModeSchema,
-  baselineSyncedEventSchema,
   candidateFileEntrySchema,
   claudeHookPathMigratedEventSchema,
   claudeSkillPathMigratedEventSchema,
   clientPathsSchema,
   codexSkillPathMigratedEventSchema,
   createTranslator,
+  defaultAgentsMetaCounters,
+  defaultLayerFilterSchema,
   defaultMessages,
   deriveAgentsMetaIdentitySource,
   deriveAgentsMetaLayer,
   deriveAgentsMetaStableId,
   deriveAgentsMetaTopologyType,
   detectNodeLocale,
+  doctorRunEventSchema,
   driftDetectedEventSchema,
   editIntentCheckedEventSchema,
   enMessages,
   eventLedgerEventSchema,
   eventLedgerTruncatedEventSchema,
+  fabExtractKnowledgeAnnotations,
+  fabReviewAnnotations,
   fabricConfigSchema,
   fabricEventSchema,
   forensicAssertionCoverageSchema,
@@ -621,9 +904,10 @@ export {
   forensicReportSchema,
   forensicSamplingBudgetSchema,
   forensicTopologySchema,
-  getRulesAnnotations,
-  getRulesInputSchema,
-  getRulesOutputSchema,
+  formatKnowledgeId,
+  getKnowledgeAnnotations,
+  getKnowledgeInputSchema,
+  getKnowledgeOutputSchema,
   historyStateQuerySchema,
   humanLedgerEntrySchema,
   humanLockApproveRequestSchema,
@@ -637,11 +921,37 @@ export {
   initContextInvariantSchema,
   initContextSchema,
   initContextSourceEvidenceSchema,
+  initScanCompletedEventSchema,
+  isKnowledgeStableId,
+  knowledgeArchiveAttemptedEventSchema,
+  knowledgeArchivedEventSchema,
+  knowledgeConsumedEventSchema,
+  knowledgeContextPlannedEventSchema,
+  knowledgeDeferredEventSchema,
+  knowledgeDemotedEventSchema,
+  knowledgeDriftDetectedEventSchema,
+  knowledgeLanguageSchema,
+  knowledgeLayerChangedEventSchema,
+  knowledgePathDangledEventSchema,
+  knowledgePromoteFailedEventSchema,
+  knowledgePromoteStartedEventSchema,
+  knowledgePromotedEventSchema,
+  knowledgeProposedEventSchema,
+  knowledgeRejectedEventSchema,
+  knowledgeScopeDegradedEventSchema,
+  knowledgeSectionsAnnotations,
+  knowledgeSectionsFetchedEventSchema,
+  knowledgeSectionsInputSchema,
+  knowledgeSectionsOutputSchema,
+  knowledgeSelectionEventSchema,
+  knowledgeSlugRenamedEventSchema,
+  knowledgeTestIndexSchema,
+  knowledgeTestLinkSchema,
+  knowledgeTestOrphanAnnotationSchema,
   ledgerAppendedEventSchema,
   ledgerEntrySchema,
   ledgerQuerySchema,
   ledgerSourceSchema,
-  legacyClientPathPresentEventSchema,
   lockApprovedEventSchema,
   lockDriftEventSchema,
   mcpConfigMigratedEventSchema,
@@ -651,23 +961,16 @@ export {
   metaReconciledOnStartupEventSchema,
   metaUpdatedEventSchema,
   normalizeLocale,
+  parseKnowledgeId,
+  pendingAutoArchivedEventSchema,
   planContextAnnotations,
+  planContextHintNarrowEntrySchema,
+  planContextHintOutputSchema,
   planContextInputSchema,
   planContextOutputSchema,
   reapplyCompletedEventSchema,
-  ruleBaselineAcceptedEventSchema,
-  ruleContextPlannedEventSchema,
   ruleDescriptionIndexItemSchema,
   ruleDescriptionSchema,
-  ruleDriftDetectedEventSchema,
-  ruleSectionsAnnotations,
-  ruleSectionsFetchedEventSchema,
-  ruleSectionsInputSchema,
-  ruleSectionsOutputSchema,
-  ruleSelectionEventSchema,
-  ruleTestIndexSchema,
-  ruleTestLinkSchema,
-  ruleTestOrphanAnnotationSchema,
   structuredWarningSchema,
   withDerivedAgentsMetaNodeDefaults,
   zhCNMessages