@fenglimg/fabric-shared 2.0.0-rc.21 → 2.0.0-rc.22

package/dist/{chunk-QZNUUIL3.js → chunk-BEABJYVL.js}

@@ -11,7 +11,7 @@ var BOOTSTRAP_CANONICAL = `# Fabric Bootstrap
 
 ## \u884C\u4E3A\u89C4\u5219
 - **\u4FEE\u6539\u4EFB\u4F55\u6587\u4EF6\u524D**:\u5FC5\u987B\u5148\u8C03 \`fab_plan_context(paths=[<\u88AB\u6539\u6587\u4EF6>])\`,\u518D\u8C03 \`fab_get_knowledge_sections\` \u53D6\u76F8\u5173\u89C4\u5219\u6BB5\u843D\u3002
-- **\`.fabric/agents.meta.json\` \u4E25\u7981\u624B\u52A8\u7F16\u8F91**:baseline \u53D8\u66F4\u53EA\u80FD\u901A\u8FC7 \`fabric doctor --fix\` \u63A5\u53D7\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 \`fab doctor --fix\`\u3002
 
 ## \u77E5\u8BC6\u5E93(KB)
 - **Discovery**:SessionStart hook \u5217 broad-scoped \u6761\u76EE;edit \u6587\u4EF6\u65F6 PreToolUse hook \u53EF\u80FD\u89E6\u53D1 narrow hint\u3002

package/dist/{chunk-NNDFOOBO.js → chunk-WK4WINAZ.js}

@@ -111,7 +111,14 @@ var planContextOutputSchema = z.object({
       })
     )
   }),
-  warnings: z.array(structuredWarningSchema).optional()
+  warnings: z.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
+  // meta in-place. Downstream CLI / hint renderers use this pair to render a
+  // "knowledge meta auto-healed (was <prev>, now <curr>)" notice without
+  // having to query the event ledger.
+  auto_healed: z.boolean().optional(),
+  previous_revision_hash: z.string().optional()
 });
 var planContextAnnotations = {
   readOnlyHint: true,

package/dist/index.d.ts

@@ -1387,6 +1387,7 @@ declare const fabricConfigSchema: z.ZodObject<{
     archive_digest_max_sessions: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     review_topic_result_cap: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     review_stale_pending_days: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    fabric_event_retention_days: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<7>, z.ZodLiteral<30>, z.ZodLiteral<90>]>>;
 }, "strip", z.ZodTypeAny, {
     fabric_language: "match-existing" | "zh-CN" | "en" | "zh-CN-hybrid";
     default_layer_filter: "personal" | "team" | "both";
@@ -1420,6 +1421,7 @@ declare const fabricConfigSchema: z.ZodObject<{
         warnBytes?: number | undefined;
         hardBytes?: number | undefined;
     } | undefined;
+    fabric_event_retention_days?: 7 | 30 | 90 | undefined;
 }, {
     clientPaths?: {
         claudeCodeCLI?: string | undefined;
@@ -1453,6 +1455,7 @@ declare const fabricConfigSchema: z.ZodObject<{
     archive_digest_max_sessions?: number | undefined;
     review_topic_result_cap?: number | undefined;
     review_stale_pending_days?: number | undefined;
+    fabric_event_retention_days?: 7 | 30 | 90 | undefined;
 }>;
 
 type FabricConfigSchemaShape = z.infer<typeof fabricConfigSchema>;
@@ -5471,6 +5474,7 @@ declare const metaReconciledEventSchema: z.ZodObject<{
     duration_ms: z.ZodNumber;
     trigger: z.ZodEnum<["doctor", "manual"]>;
     source: z.ZodLiteral<"reconcileKnowledge">;
+    force_write_reason: z.ZodOptional<z.ZodEnum<["revision_drift"]>>;
     kind: z.ZodLiteral<"fabric-event">;
     id: z.ZodString;
     ts: z.ZodNumber;
@@ -5489,6 +5493,7 @@ declare const metaReconciledEventSchema: z.ZodObject<{
     trigger: "manual" | "doctor";
     correlation_id?: string | undefined;
     session_id?: string | undefined;
+    force_write_reason?: "revision_drift" | undefined;
 }, {
     id: string;
     source: "reconcileKnowledge";
@@ -5501,6 +5506,7 @@ declare const metaReconciledEventSchema: z.ZodObject<{
     trigger: "manual" | "doctor";
     correlation_id?: string | undefined;
     session_id?: string | undefined;
+    force_write_reason?: "revision_drift" | undefined;
 }>;
 declare const claudeSkillPathMigratedEventSchema: z.ZodObject<{
     event_type: z.ZodLiteral<"claude_skill_path_migrated">;
@@ -6305,6 +6311,80 @@ declare const citePolicyActivatedEventSchema: z.ZodObject<{
     correlation_id?: string | undefined;
     session_id?: string | undefined;
 }>;
+declare const eventsRotatedEventSchema: z.ZodObject<{
+    event_type: z.ZodLiteral<"events_rotated">;
+    cutoff_ts: z.ZodString;
+    archived_count: z.ZodNumber;
+    kept_count: z.ZodNumber;
+    archive_path: z.ZodString;
+    kind: z.ZodLiteral<"fabric-event">;
+    id: z.ZodString;
+    ts: z.ZodNumber;
+    schema_version: z.ZodLiteral<1>;
+    correlation_id: z.ZodOptional<z.ZodString>;
+    session_id: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    ts: number;
+    schema_version: 1;
+    kind: "fabric-event";
+    event_type: "events_rotated";
+    cutoff_ts: string;
+    archived_count: number;
+    kept_count: number;
+    archive_path: string;
+    correlation_id?: string | undefined;
+    session_id?: string | undefined;
+}, {
+    id: string;
+    ts: number;
+    schema_version: 1;
+    kind: "fabric-event";
+    event_type: "events_rotated";
+    cutoff_ts: string;
+    archived_count: number;
+    kept_count: number;
+    archive_path: string;
+    correlation_id?: string | undefined;
+    session_id?: string | undefined;
+}>;
+declare const knowledgeMetaAutoHealedEventSchema: z.ZodObject<{
+    event_type: z.ZodLiteral<"knowledge_meta_auto_healed">;
+    previous_revision_hash: z.ZodString;
+    revision_hash: z.ZodString;
+    trigger: z.ZodLiteral<"read">;
+    caller: z.ZodOptional<z.ZodEnum<["planContext", "getKnowledgeSections", "getKnowledge", "extractKnowledge"]>>;
+    kind: z.ZodLiteral<"fabric-event">;
+    id: z.ZodString;
+    ts: z.ZodNumber;
+    schema_version: z.ZodLiteral<1>;
+    correlation_id: z.ZodOptional<z.ZodString>;
+    session_id: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    revision_hash: string;
+    previous_revision_hash: string;
+    ts: number;
+    schema_version: 1;
+    kind: "fabric-event";
+    event_type: "knowledge_meta_auto_healed";
+    trigger: "read";
+    correlation_id?: string | undefined;
+    session_id?: string | undefined;
+    caller?: "planContext" | "getKnowledgeSections" | "getKnowledge" | "extractKnowledge" | undefined;
+}, {
+    id: string;
+    revision_hash: string;
+    previous_revision_hash: string;
+    ts: number;
+    schema_version: 1;
+    kind: "fabric-event";
+    event_type: "knowledge_meta_auto_healed";
+    trigger: "read";
+    correlation_id?: string | undefined;
+    session_id?: string | undefined;
+    caller?: "planContext" | "getKnowledgeSections" | "getKnowledge" | "extractKnowledge" | undefined;
+}>;
 declare const eventLedgerEventSchema: z.ZodDiscriminatedUnion<"event_type", [z.ZodObject<{
     event_type: z.ZodLiteral<"knowledge_context_planned">;
     target_paths: z.ZodArray<z.ZodString, "many">;
@@ -6780,6 +6860,7 @@ declare const eventLedgerEventSchema: z.ZodDiscriminatedUnion<"event_type", [z.Z
     duration_ms: z.ZodNumber;
     trigger: z.ZodEnum<["doctor", "manual"]>;
     source: z.ZodLiteral<"reconcileKnowledge">;
+    force_write_reason: z.ZodOptional<z.ZodEnum<["revision_drift"]>>;
     kind: z.ZodLiteral<"fabric-event">;
     id: z.ZodString;
     ts: z.ZodNumber;
@@ -6798,6 +6879,7 @@ declare const eventLedgerEventSchema: z.ZodDiscriminatedUnion<"event_type", [z.Z
     trigger: "manual" | "doctor";
     correlation_id?: string | undefined;
     session_id?: string | undefined;
+    force_write_reason?: "revision_drift" | undefined;
 }, {
     id: string;
     source: "reconcileKnowledge";
@@ -6810,6 +6892,7 @@ declare const eventLedgerEventSchema: z.ZodDiscriminatedUnion<"event_type", [z.Z
     trigger: "manual" | "doctor";
     correlation_id?: string | undefined;
     session_id?: string | undefined;
+    force_write_reason?: "revision_drift" | undefined;
 }>, z.ZodObject<{
     event_type: z.ZodLiteral<"claude_skill_path_migrated">;
     from: z.ZodString;
@@ -7590,6 +7673,78 @@ declare const eventLedgerEventSchema: z.ZodDiscriminatedUnion<"event_type", [z.Z
     policy_version: string;
     correlation_id?: string | undefined;
     session_id?: string | undefined;
+}>, z.ZodObject<{
+    event_type: z.ZodLiteral<"knowledge_meta_auto_healed">;
+    previous_revision_hash: z.ZodString;
+    revision_hash: z.ZodString;
+    trigger: z.ZodLiteral<"read">;
+    caller: z.ZodOptional<z.ZodEnum<["planContext", "getKnowledgeSections", "getKnowledge", "extractKnowledge"]>>;
+    kind: z.ZodLiteral<"fabric-event">;
+    id: z.ZodString;
+    ts: z.ZodNumber;
+    schema_version: z.ZodLiteral<1>;
+    correlation_id: z.ZodOptional<z.ZodString>;
+    session_id: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    revision_hash: string;
+    previous_revision_hash: string;
+    ts: number;
+    schema_version: 1;
+    kind: "fabric-event";
+    event_type: "knowledge_meta_auto_healed";
+    trigger: "read";
+    correlation_id?: string | undefined;
+    session_id?: string | undefined;
+    caller?: "planContext" | "getKnowledgeSections" | "getKnowledge" | "extractKnowledge" | undefined;
+}, {
+    id: string;
+    revision_hash: string;
+    previous_revision_hash: string;
+    ts: number;
+    schema_version: 1;
+    kind: "fabric-event";
+    event_type: "knowledge_meta_auto_healed";
+    trigger: "read";
+    correlation_id?: string | undefined;
+    session_id?: string | undefined;
+    caller?: "planContext" | "getKnowledgeSections" | "getKnowledge" | "extractKnowledge" | undefined;
+}>, z.ZodObject<{
+    event_type: z.ZodLiteral<"events_rotated">;
+    cutoff_ts: z.ZodString;
+    archived_count: z.ZodNumber;
+    kept_count: z.ZodNumber;
+    archive_path: z.ZodString;
+    kind: z.ZodLiteral<"fabric-event">;
+    id: z.ZodString;
+    ts: z.ZodNumber;
+    schema_version: z.ZodLiteral<1>;
+    correlation_id: z.ZodOptional<z.ZodString>;
+    session_id: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    ts: number;
+    schema_version: 1;
+    kind: "fabric-event";
+    event_type: "events_rotated";
+    cutoff_ts: string;
+    archived_count: number;
+    kept_count: number;
+    archive_path: string;
+    correlation_id?: string | undefined;
+    session_id?: string | undefined;
+}, {
+    id: string;
+    ts: number;
+    schema_version: 1;
+    kind: "fabric-event";
+    event_type: "events_rotated";
+    cutoff_ts: string;
+    archived_count: number;
+    kept_count: number;
+    archive_path: string;
+    correlation_id?: string | undefined;
+    session_id?: string | undefined;
 }>]>;
 type KnowledgeContextPlannedEvent = z.infer<typeof knowledgeContextPlannedEventSchema>;
 type KnowledgeSelectionEvent = z.infer<typeof knowledgeSelectionEventSchema>;
@@ -7626,9 +7781,11 @@ type DoctorRunEvent = z.infer<typeof doctorRunEventSchema>;
 type RelevanceMigrationRunEvent = z.infer<typeof relevanceMigrationRunEventSchema>;
 type AssistantTurnObservedEvent = z.infer<typeof assistantTurnObservedEventSchema>;
 type CitePolicyActivatedEvent = z.infer<typeof citePolicyActivatedEventSchema>;
-type EventLedgerEvent = KnowledgeContextPlannedEvent | KnowledgeSelectionEvent | KnowledgeSectionsFetchedEvent | EditIntentCheckedEvent | KnowledgeDriftDetectedEvent | McpEventLedgerEvent | ReapplyCompletedEvent | EventLedgerTruncatedEvent | McpConfigMigratedEvent | BootstrapMarkerMigratedEvent | MetaReconciledOnStartupEvent | MetaReconciledEvent | ClaudeSkillPathMigratedEvent | ClaudeHookPathMigratedEvent | CodexSkillPathMigratedEvent | InitScanCompletedEvent | KnowledgeProposedEvent | KnowledgePromoteStartedEvent | KnowledgePromotedEvent | KnowledgePromoteFailedEvent | KnowledgeLayerChangedEvent | KnowledgeSlugRenamedEvent | KnowledgeDemotedEvent | KnowledgeArchivedEvent | KnowledgeArchiveAttemptedEvent | KnowledgeDeferredEvent | KnowledgeRejectedEvent | KnowledgeConsumedEvent | KnowledgeScopeDegradedEvent | PendingAutoArchivedEvent | KnowledgePathDangledEvent | DoctorRunEvent | RelevanceMigrationRunEvent | AssistantTurnObservedEvent | CitePolicyActivatedEvent;
+type KnowledgeMetaAutoHealedEvent = z.infer<typeof knowledgeMetaAutoHealedEventSchema>;
+type EventsRotatedEvent = z.infer<typeof eventsRotatedEventSchema>;
+type EventLedgerEvent = KnowledgeContextPlannedEvent | KnowledgeSelectionEvent | KnowledgeSectionsFetchedEvent | EditIntentCheckedEvent | KnowledgeDriftDetectedEvent | McpEventLedgerEvent | ReapplyCompletedEvent | EventLedgerTruncatedEvent | McpConfigMigratedEvent | BootstrapMarkerMigratedEvent | MetaReconciledOnStartupEvent | MetaReconciledEvent | ClaudeSkillPathMigratedEvent | ClaudeHookPathMigratedEvent | CodexSkillPathMigratedEvent | InitScanCompletedEvent | KnowledgeProposedEvent | KnowledgePromoteStartedEvent | KnowledgePromotedEvent | KnowledgePromoteFailedEvent | KnowledgeLayerChangedEvent | KnowledgeSlugRenamedEvent | KnowledgeDemotedEvent | KnowledgeArchivedEvent | KnowledgeArchiveAttemptedEvent | KnowledgeDeferredEvent | KnowledgeRejectedEvent | KnowledgeConsumedEvent | KnowledgeScopeDegradedEvent | PendingAutoArchivedEvent | KnowledgePathDangledEvent | DoctorRunEvent | RelevanceMigrationRunEvent | AssistantTurnObservedEvent | CitePolicyActivatedEvent | KnowledgeMetaAutoHealedEvent | EventsRotatedEvent;
 type EventLedgerEventType = EventLedgerEvent["event_type"];
 type EventLedgerEventInputFor<T extends EventLedgerEvent> = T extends EventLedgerEvent ? Omit<T, "kind" | "id" | "ts" | "schema_version" | "correlation_id" | "session_id"> & Partial<Pick<T, "id" | "ts" | "correlation_id" | "session_id">> : never;
 type EventLedgerEventInput = EventLedgerEventInputFor<EventLedgerEvent>;
 
-export { AGENTS_META_IDENTITY_SOURCES, AGENTS_META_LAYERS, AGENTS_META_TOPOLOGY_TYPES, AgentsIdentitySource, AgentsLayer, AgentsMeta, type AgentsMetaCounters, AgentsMetaCountersSchema, AgentsMetaNode, AgentsTopologyType, type AssistantTurnObservedEvent, type BootstrapMarkerMigratedEvent, type CandidateFileEntry, type CandidateFileFamily, type CitePolicyActivatedEvent, type ClaudeHookPathMigratedEvent, type ClaudeSkillPathMigratedEvent, type CodexSkillPathMigratedEvent, type DoctorRunEvent, type DriftDetectedEvent, type EditIntentCheckedEvent, type EventLedgerEvent, type EventLedgerEventInput, type EventLedgerEventType, type EventLedgerTruncatedEvent, type FabricConfigSchemaShape, type FabricEvent, type ForensicAssertion, type ForensicAssertionConfidence, type ForensicAssertionCoverage, type ForensicAssertionType, type ForensicCodeSample, type ForensicEntryPoint, type ForensicEvidenceAnchor, type ForensicFramework, type ForensicReadme, type ForensicReport, type ForensicSamplingBudget, type ForensicTopology, HumanLockEntry, type HumanLockFile, type InitContext, type InitContextDomainGroup, type InitContextFramework, type InitContextInterviewTrailEntry, type InitContextInvariant, type InitContextInvariantConfidenceSnapshot, type InitContextSourceEvidence, type InitScanCompletedEvent, KNOWLEDGE_TEST_INDEX_SCHEMA_VERSION, type KnowledgeArchiveAttemptedEvent, type KnowledgeArchivedEvent, type KnowledgeConsumedEvent, type KnowledgeContextPlannedEvent, type KnowledgeDeferredEvent, type KnowledgeDemotedEvent, type KnowledgeDriftDetectedEvent, type KnowledgeLayerChangedEvent, type KnowledgePathDangledEvent, type KnowledgePromoteFailedEvent, type KnowledgePromoteStartedEvent, type KnowledgePromotedEvent, type KnowledgeProposedEvent, type KnowledgeRejectedEvent, type KnowledgeScopeDegradedEvent, type KnowledgeSectionsFetchedEvent, type KnowledgeSelectionEvent, type KnowledgeSlugRenamedEvent, type KnowledgeTestIndex, type KnowledgeTestLink, type KnowledgeTestOrphanAnnotation, KnowledgeType, Layer, type LedgerAppendedEvent, LedgerEntry, type LockApprovedEvent, type LockDriftEvent, type McpConfigMigratedEvent, type McpEventLedgerEvent, type MetaReconciledEvent, type MetaReconciledOnStartupEvent, type MetaUpdatedEvent, type PanelFieldGroup, type PanelFieldMeta, type PendingAutoArchivedEvent, type ReapplyCompletedEvent, type RelevanceMigrationRunEvent, StableId, type ValidateResult, agentsIdentitySourceSchema, agentsLayerSchema, agentsMetaNodeSchema, agentsMetaSchema, agentsTopologyTypeSchema, aiLedgerEntrySchema, allocateKnowledgeId, assistantTurnObservedEventSchema, auditModeSchema, bootstrapMarkerMigratedEventSchema, candidateFileEntrySchema, citePolicyActivatedEventSchema, claudeHookPathMigratedEventSchema, claudeSkillPathMigratedEventSchema, clientPathsSchema, codexSkillPathMigratedEventSchema, defaultAgentsMetaCounters, defaultLayerFilterSchema, deriveAgentsMetaIdentitySource, deriveAgentsMetaLayer, deriveAgentsMetaStableId, deriveAgentsMetaTopologyType, doctorRunEventSchema, driftDetectedEventSchema, editIntentCheckedEventSchema, eventLedgerEventSchema, eventLedgerTruncatedEventSchema, fabricConfigSchema, fabricEventSchema, fabricLanguageSchema, forensicAssertionCoverageSchema, forensicAssertionSchema, forensicCodeSampleSchema, forensicEntryPointSchema, forensicEvidenceAnchorSchema, forensicFrameworkSchema, forensicReadmeSchema, forensicReportSchema, forensicSamplingBudgetSchema, forensicTopologySchema, getPanelFieldByKey, getPanelFields, humanLedgerEntrySchema, humanLockEntrySchema, humanLockFileSchema, initContextDomainGroupSchema, initContextFrameworkSchema, initContextInterviewTrailEntrySchema, initContextInvariantConfidenceSnapshotSchema, initContextInvariantSchema, initContextSchema, initContextSourceEvidenceSchema, initScanCompletedEventSchema, isKnowledgeStableId, knowledgeArchiveAttemptedEventSchema, knowledgeArchivedEventSchema, knowledgeConsumedEventSchema, knowledgeContextPlannedEventSchema, knowledgeDeferredEventSchema, knowledgeDemotedEventSchema, knowledgeDriftDetectedEventSchema, knowledgeLayerChangedEventSchema, knowledgePathDangledEventSchema, knowledgePromoteFailedEventSchema, knowledgePromoteStartedEventSchema, knowledgePromotedEventSchema, knowledgeProposedEventSchema, knowledgeRejectedEventSchema, knowledgeScopeDegradedEventSchema, knowledgeSectionsFetchedEventSchema, knowledgeSelectionEventSchema, knowledgeSlugRenamedEventSchema, knowledgeTestIndexSchema, knowledgeTestLinkSchema, knowledgeTestOrphanAnnotationSchema, ledgerAppendedEventSchema, ledgerEntrySchema, lockApprovedEventSchema, lockDriftEventSchema, mcpConfigMigratedEventSchema, mcpEventLedgerEventSchema, mcpPayloadLimitsSchema, metaReconciledEventSchema, metaReconciledOnStartupEventSchema, metaUpdatedEventSchema, pendingAutoArchivedEventSchema, reapplyCompletedEventSchema, relevanceMigrationRunEventSchema, ruleDescriptionIndexItemSchema, ruleDescriptionSchema, withDerivedAgentsMetaNodeDefaults };
+export { AGENTS_META_IDENTITY_SOURCES, AGENTS_META_LAYERS, AGENTS_META_TOPOLOGY_TYPES, AgentsIdentitySource, AgentsLayer, AgentsMeta, type AgentsMetaCounters, AgentsMetaCountersSchema, AgentsMetaNode, AgentsTopologyType, type AssistantTurnObservedEvent, type BootstrapMarkerMigratedEvent, type CandidateFileEntry, type CandidateFileFamily, type CitePolicyActivatedEvent, type ClaudeHookPathMigratedEvent, type ClaudeSkillPathMigratedEvent, type CodexSkillPathMigratedEvent, type DoctorRunEvent, type DriftDetectedEvent, type EditIntentCheckedEvent, type EventLedgerEvent, type EventLedgerEventInput, type EventLedgerEventType, type EventLedgerTruncatedEvent, type EventsRotatedEvent, type FabricConfigSchemaShape, type FabricEvent, type ForensicAssertion, type ForensicAssertionConfidence, type ForensicAssertionCoverage, type ForensicAssertionType, type ForensicCodeSample, type ForensicEntryPoint, type ForensicEvidenceAnchor, type ForensicFramework, type ForensicReadme, type ForensicReport, type ForensicSamplingBudget, type ForensicTopology, HumanLockEntry, type HumanLockFile, type InitContext, type InitContextDomainGroup, type InitContextFramework, type InitContextInterviewTrailEntry, type InitContextInvariant, type InitContextInvariantConfidenceSnapshot, type InitContextSourceEvidence, type InitScanCompletedEvent, KNOWLEDGE_TEST_INDEX_SCHEMA_VERSION, type KnowledgeArchiveAttemptedEvent, type KnowledgeArchivedEvent, type KnowledgeConsumedEvent, type KnowledgeContextPlannedEvent, type KnowledgeDeferredEvent, type KnowledgeDemotedEvent, type KnowledgeDriftDetectedEvent, type KnowledgeLayerChangedEvent, type KnowledgeMetaAutoHealedEvent, type KnowledgePathDangledEvent, type KnowledgePromoteFailedEvent, type KnowledgePromoteStartedEvent, type KnowledgePromotedEvent, type KnowledgeProposedEvent, type KnowledgeRejectedEvent, type KnowledgeScopeDegradedEvent, type KnowledgeSectionsFetchedEvent, type KnowledgeSelectionEvent, type KnowledgeSlugRenamedEvent, type KnowledgeTestIndex, type KnowledgeTestLink, type KnowledgeTestOrphanAnnotation, KnowledgeType, Layer, type LedgerAppendedEvent, LedgerEntry, type LockApprovedEvent, type LockDriftEvent, type McpConfigMigratedEvent, type McpEventLedgerEvent, type MetaReconciledEvent, type MetaReconciledOnStartupEvent, type MetaUpdatedEvent, type PanelFieldGroup, type PanelFieldMeta, type PendingAutoArchivedEvent, type ReapplyCompletedEvent, type RelevanceMigrationRunEvent, StableId, type ValidateResult, agentsIdentitySourceSchema, agentsLayerSchema, agentsMetaNodeSchema, agentsMetaSchema, agentsTopologyTypeSchema, aiLedgerEntrySchema, allocateKnowledgeId, assistantTurnObservedEventSchema, auditModeSchema, bootstrapMarkerMigratedEventSchema, candidateFileEntrySchema, citePolicyActivatedEventSchema, claudeHookPathMigratedEventSchema, claudeSkillPathMigratedEventSchema, clientPathsSchema, codexSkillPathMigratedEventSchema, defaultAgentsMetaCounters, defaultLayerFilterSchema, deriveAgentsMetaIdentitySource, deriveAgentsMetaLayer, deriveAgentsMetaStableId, deriveAgentsMetaTopologyType, doctorRunEventSchema, driftDetectedEventSchema, editIntentCheckedEventSchema, eventLedgerEventSchema, eventLedgerTruncatedEventSchema, eventsRotatedEventSchema, fabricConfigSchema, fabricEventSchema, fabricLanguageSchema, forensicAssertionCoverageSchema, forensicAssertionSchema, forensicCodeSampleSchema, forensicEntryPointSchema, forensicEvidenceAnchorSchema, forensicFrameworkSchema, forensicReadmeSchema, forensicReportSchema, forensicSamplingBudgetSchema, forensicTopologySchema, getPanelFieldByKey, getPanelFields, humanLedgerEntrySchema, humanLockEntrySchema, humanLockFileSchema, initContextDomainGroupSchema, initContextFrameworkSchema, initContextInterviewTrailEntrySchema, initContextInvariantConfidenceSnapshotSchema, initContextInvariantSchema, initContextSchema, initContextSourceEvidenceSchema, initScanCompletedEventSchema, isKnowledgeStableId, knowledgeArchiveAttemptedEventSchema, knowledgeArchivedEventSchema, knowledgeConsumedEventSchema, knowledgeContextPlannedEventSchema, knowledgeDeferredEventSchema, knowledgeDemotedEventSchema, knowledgeDriftDetectedEventSchema, knowledgeLayerChangedEventSchema, knowledgeMetaAutoHealedEventSchema, knowledgePathDangledEventSchema, knowledgePromoteFailedEventSchema, knowledgePromoteStartedEventSchema, knowledgePromotedEventSchema, knowledgeProposedEventSchema, knowledgeRejectedEventSchema, knowledgeScopeDegradedEventSchema, knowledgeSectionsFetchedEventSchema, knowledgeSelectionEventSchema, knowledgeSlugRenamedEventSchema, knowledgeTestIndexSchema, knowledgeTestLinkSchema, knowledgeTestOrphanAnnotationSchema, ledgerAppendedEventSchema, ledgerEntrySchema, lockApprovedEventSchema, lockDriftEventSchema, mcpConfigMigratedEventSchema, mcpEventLedgerEventSchema, mcpPayloadLimitsSchema, metaReconciledEventSchema, metaReconciledOnStartupEventSchema, metaUpdatedEventSchema, pendingAutoArchivedEventSchema, reapplyCompletedEventSchema, relevanceMigrationRunEventSchema, ruleDescriptionIndexItemSchema, ruleDescriptionSchema, withDerivedAgentsMetaNodeDefaults };

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-BEABJYVL.js";
 import {
   PROTECTED_TOKENS,
   createTranslator,
@@ -46,16 +54,8 @@ import {
   planContextInputSchema,
   planContextOutputSchema,
   structuredWarningSchema
-} from "./chunk-NNDFOOBO.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-QZNUUIL3.js";
+} from "./chunk-WK4WINAZ.js";
+import "./chunk-LXNCAKJZ.js";
 
 // src/schemas/agents-meta.ts
 import { z } from "zod";
@@ -450,7 +450,20 @@ var fabricConfigSchema = z5.object({
   // for explicit resolve-or-drop decision. Default 14; tighter than the
   // 7d Signal-B trigger because review specifically targets the long
   // tail. Large repos with slower cadence can raise to 30.
-  review_stale_pending_days: z5.number().int().positive().optional().default(14)
+  review_stale_pending_days: z5.number().int().positive().optional().default(14),
+  // v2.0.0-rc.22 Scope A T3: sliding-window retention (in days) for the
+  // event ledger rotation primitive (`rotateEventLedgerIfNeeded`). Lines
+  // whose `ts` is older than `now - fabric_event_retention_days * 86_400_000`
+  // are partitioned into `.fabric/events.archive/events-rotated-YYYY-MM-DD.jsonl`.
+  // Locked to 7/30/90 — three operator-friendly preset windows. Default 30
+  // is applied at the consumer site (rotateEventLedgerIfNeeded), so this
+  // field stays `.optional()` without a `.default()` to keep the schema
+  // surface honest: absence means "use the library default", not "schema
+  // default of 30 was injected." 7 = ~tight, 30 = balanced, 90 = forensic.
+  // Mirrors cite-policy precedent of locking enum-style numeric tunables
+  // to a small literal set (vs free `.positive()`) to prevent fat-finger
+  // misconfig.
+  fabric_event_retention_days: z5.union([z5.literal(7), z5.literal(30), z5.literal(90)]).optional()
 });
 
 // src/schemas/fabric-config-introspect.ts
@@ -876,7 +889,12 @@ var metaReconciledEventSchema = z10.object({
   reconciled_files: z10.array(z10.string()),
   duration_ms: z10.number().int().nonnegative(),
   trigger: z10.enum(["doctor", "manual"]),
-  source: z10.literal("reconcileKnowledge")
+  source: z10.literal("reconcileKnowledge"),
+  // v2.0.0-rc.22 TASK-014 (Scope E): set when reconcileKnowledge forced a
+  // writeKnowledgeMeta on revision drift alone (no per-file content drift).
+  // Distinguishes top-level schema/revision repair from the standard per-file
+  // drift path. Optional so existing emitters stay unchanged.
+  force_write_reason: z10.enum(["revision_drift"]).optional()
 });
 var claudeSkillPathMigratedEventSchema = z10.object({
   ...eventLedgerEnvelopeSchema,
@@ -1046,6 +1064,22 @@ var citePolicyActivatedEventSchema = z10.object({
   policy_version: z10.string(),
   timestamp: z10.string().datetime()
 });
+var eventsRotatedEventSchema = z10.object({
+  ...eventLedgerEnvelopeSchema,
+  event_type: z10.literal("events_rotated"),
+  cutoff_ts: z10.string().datetime(),
+  archived_count: z10.number().int().nonnegative(),
+  kept_count: z10.number().int().nonnegative(),
+  archive_path: z10.string()
+});
+var knowledgeMetaAutoHealedEventSchema = z10.object({
+  ...eventLedgerEnvelopeSchema,
+  event_type: z10.literal("knowledge_meta_auto_healed"),
+  previous_revision_hash: z10.string(),
+  revision_hash: z10.string(),
+  trigger: z10.literal("read"),
+  caller: z10.enum(["planContext", "getKnowledgeSections", "getKnowledge", "extractKnowledge"]).optional()
+});
 var eventLedgerEventSchema = z10.discriminatedUnion("event_type", [
   knowledgeContextPlannedEventSchema,
   knowledgeSelectionEventSchema,
@@ -1097,7 +1131,14 @@ var eventLedgerEventSchema = z10.discriminatedUnion("event_type", [
   assistantTurnObservedEventSchema,
   // v2.0.0-rc.20 TASK-02: cite_policy_activated — session/policy-bump
   // marker recording when a given policy_version became active.
-  citePolicyActivatedEventSchema
+  citePolicyActivatedEventSchema,
+  // v2.0.0-rc.22 Scope D T-D1: knowledge_meta_auto_healed — emitted by
+  // loadActiveMeta when read-path drift triggers an in-place meta rebuild.
+  knowledgeMetaAutoHealedEventSchema,
+  // v2.0.0-rc.22 Scope A T3: events_rotated — emitted as the first line of
+  // the post-rotation events.jsonl when sliding-window-by-age rotation moves
+  // stale entries to events.archive/events-rotated-YYYY-MM-DD.jsonl.
+  eventsRotatedEventSchema
 ]);
 export {
   AGENTS_META_IDENTITY_SOURCES,
@@ -1160,6 +1201,7 @@ export {
   enMessages,
   eventLedgerEventSchema,
   eventLedgerTruncatedEventSchema,
+  eventsRotatedEventSchema,
   fabExtractKnowledgeAnnotations,
   fabReviewAnnotations,
   fabricConfigSchema,
@@ -1204,6 +1246,7 @@ export {
   knowledgeDemotedEventSchema,
   knowledgeDriftDetectedEventSchema,
   knowledgeLayerChangedEventSchema,
+  knowledgeMetaAutoHealedEventSchema,
   knowledgePathDangledEventSchema,
   knowledgePromoteFailedEventSchema,
   knowledgePromoteStartedEventSchema,

package/dist/node/atomic-write.d.ts

@@ -8,6 +8,22 @@ declare function atomicWriteText(path: string, content: string, opts?: AtomicWri
 declare function atomicWriteJson(path: string, value: unknown, opts?: AtomicWriteJsonOptions): Promise<void>;
 interface LedgerWriteQueue {
     append(path: string, line: string): Promise<void>;
+    /**
+     * Run `fn` with exclusive access to `path` against all other queue operations
+     * (other `runExclusive` calls and `append` calls) on the same path within
+     * this LedgerWriteQueue instance.
+     *
+     * Scope: per-path, in-process (same Node process, same queue instance).
+     * Does NOT provide cross-process locking — separate concern.
+     *
+     * Error semantics: a rejection from `fn` is propagated to the returned
+     * Promise but does NOT poison the chain — subsequent `runExclusive` /
+     * `append` calls on the same path will still acquire and run.
+     *
+     * Ordering: submission-order FIFO. Calls on different paths run independently
+     * (in parallel where possible).
+     */
+    runExclusive<T>(path: string, fn: () => Promise<T>): Promise<T>;
 }
 declare function createLedgerWriteQueue(): LedgerWriteQueue;
 

package/dist/node/atomic-write.js

@@ -38,18 +38,27 @@ function createLedgerWriteQueue() {
     const normalized = line.endsWith("\n") ? line : line + "\n";
     await appendFile(path, normalized, "utf8");
   }
+  function enqueue(path, work) {
+    const prev = chains.get(path) ?? Promise.resolve();
+    const result = prev.catch(() => void 0).then(() => work());
+    const chainSlot = result.then(
+      () => void 0,
+      () => void 0
+    );
+    chains.set(path, chainSlot);
+    chainSlot.finally(() => {
+      if (chains.get(path) === chainSlot) {
+        chains.delete(path);
+      }
+    });
+    return result;
+  }
   return {
     append(path, line) {
-      const prev = chains.get(path) ?? Promise.resolve();
-      const next = prev.catch(() => void 0).then(() => doAppend(path, line));
-      chains.set(path, next);
-      const guarded = next.catch(() => void 0);
-      guarded.finally(() => {
-        if (chains.get(path) === next) {
-          chains.delete(path);
-        }
-      });
-      return next;
+      return enqueue(path, () => doAppend(path, line));
+    },
+    runExclusive(path, fn) {
+      return enqueue(path, fn);
     }
   };
 }

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

@@ -467,6 +467,8 @@ declare const planContextOutputSchema: z.ZodObject<{
         action_hint: string;
         line?: number | undefined;
     }>, "many">>;
+    auto_healed: z.ZodOptional<z.ZodBoolean>;
+    previous_revision_hash: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     stale: boolean;
     entries: {
@@ -551,6 +553,8 @@ declare const planContextOutputSchema: z.ZodObject<{
         action_hint: string;
         line?: number | undefined;
     }[] | undefined;
+    auto_healed?: boolean | undefined;
+    previous_revision_hash?: string | undefined;
 }, {
     stale: boolean;
     entries: {
@@ -635,6 +639,8 @@ declare const planContextOutputSchema: z.ZodObject<{
         action_hint: string;
         line?: number | undefined;
     }[] | undefined;
+    auto_healed?: boolean | undefined;
+    previous_revision_hash?: string | undefined;
 }>;
 declare const planContextAnnotations: {
     readonly readOnlyHint: true;

package/dist/schemas/api-contracts.js

@@ -36,7 +36,7 @@ import {
   planContextInputSchema,
   planContextOutputSchema,
   structuredWarningSchema
-} from "../chunk-NNDFOOBO.js";
+} from "../chunk-WK4WINAZ.js";
 export {
   FabExtractKnowledgeInputSchema,
   FabExtractKnowledgeInputShape,

package/dist/templates/bootstrap-canonical.d.ts

@@ -51,6 +51,6 @@ declare const LEGACY_KB_REGEX: RegExp;
  *
  * Length guarantee: ≥ 400 bytes.
  */
-declare const BOOTSTRAP_CANONICAL = "# Fabric Bootstrap\n\n\u672C\u9879\u76EE\u4F7F\u7528 Fabric \u7BA1\u7406\u8DE8\u5BA2\u6237\u7AEF AI \u77E5\u8BC6\u4E0E\u884C\u4E3A\u89C4\u5219\u3002\u672C\u6587\u4EF6\u7531 `fab install` \u540C\u6B65\u5230\u4E09\u7AEF managed block,**\u4E0D\u8981\u624B\u52A8\u7F16\u8F91\u4E09\u7AEF\u7684 block**,\u53EA\u6539\u8FD9\u91CC + \u91CD\u8DD1 `fab install`\u3002\n\n## \u884C\u4E3A\u89C4\u5219\n- **\u4FEE\u6539\u4EFB\u4F55\u6587\u4EF6\u524D**:\u5FC5\u987B\u5148\u8C03 `fab_plan_context(paths=[<\u88AB\u6539\u6587\u4EF6>])`,\u518D\u8C03 `fab_get_knowledge_sections` \u53D6\u76F8\u5173\u89C4\u5219\u6BB5\u843D\u3002\n- **`.fabric/agents.meta.json` \u4E25\u7981\u624B\u52A8\u7F16\u8F91**:baseline \u53D8\u66F4\u53EA\u80FD\u901A\u8FC7 `fabric doctor --fix` \u63A5\u53D7\u3002\n\n## \u77E5\u8BC6\u5E93(KB)\n- **Discovery**:SessionStart hook \u5217 broad-scoped \u6761\u76EE;edit \u6587\u4EF6\u65F6 PreToolUse hook \u53EF\u80FD\u89E6\u53D1 narrow hint\u3002\n- **Usage**:\u7528 `fab_get_knowledge_sections(id=...)` \u6309 id \u53D6\u6761\u76EE\u5168\u6587\u3002\n- **Write flows**:`fabric-archive` / `fabric-review` / `fabric-import` \u4E09\u4E2A Skills\u3002\n- **Language**:\u6E32\u67D3\u6309 `.fabric/fabric-config.json` \u7684 `fabric_language` \u5B57\u6BB5\u3002\n\n## Cite policy\n\n- **\u89E6\u53D1**: \u505A edit / decide / propose plan \u4E4B\u524D,**\u56DE\u590D\u9996\u884C**\u5FC5\u987B\u5199 `KB: <id> (<\u22648\u5B57 \u7528\u6CD5>) [planned|recalled|chained-from <id>|dismissed:<reason>]` \u6216 `KB: none`\u3002\n- **`[recalled]` \u9A8C\u8BC1**: \u5FC5\u987B\u7D27\u8DDF\u4E00\u6B21 `fab_get_knowledge_sections(id=...)`,\u9632\u6B62\u7F16\u9020 id\u3002\n- **\u7528\u6237\u53E3\u5934\u63D0\u89C4\u5219\u6CA1\u7ED9 id**: \u5148\u8C03 `fab_extract_knowledge` \u6216 `search_context` \u53CD\u67E5\u3002\n- **dismissed reason**: \u679A\u4E3E `scope-mismatch | outdated | not-applicable | other:<text>`\u3002\n- **\u7A3D\u6838**: `fab doctor --cite-coverage [--since=7d] [--client=cc|codex|all]` \u8F93\u51FA cite \u8986\u76D6\u7387\u3002\u672C\u89C4\u5219\u4E0D\u963B\u65AD\u4F60\u5DE5\u4F5C,\u53EA\u8BB0\u5F55\u3002\n";
+declare const BOOTSTRAP_CANONICAL = "# Fabric Bootstrap\n\n\u672C\u9879\u76EE\u4F7F\u7528 Fabric \u7BA1\u7406\u8DE8\u5BA2\u6237\u7AEF AI \u77E5\u8BC6\u4E0E\u884C\u4E3A\u89C4\u5219\u3002\u672C\u6587\u4EF6\u7531 `fab install` \u540C\u6B65\u5230\u4E09\u7AEF managed block,**\u4E0D\u8981\u624B\u52A8\u7F16\u8F91\u4E09\u7AEF\u7684 block**,\u53EA\u6539\u8FD9\u91CC + \u91CD\u8DD1 `fab install`\u3002\n\n## \u884C\u4E3A\u89C4\u5219\n- **\u4FEE\u6539\u4EFB\u4F55\u6587\u4EF6\u524D**:\u5FC5\u987B\u5148\u8C03 `fab_plan_context(paths=[<\u88AB\u6539\u6587\u4EF6>])`,\u518D\u8C03 `fab_get_knowledge_sections` \u53D6\u76F8\u5173\u89C4\u5219\u6BB5\u843D\u3002\n- **`.fabric/agents.meta.json` \u4E25\u7981\u624B\u52A8\u7F16\u8F91**;engine \u4F1A\u81EA\u52A8\u540C\u6B65\u6D3E\u751F\u72B6\u6001,\u663E\u5F0F reconcile \u8DD1 `fab doctor --fix`\u3002\n\n## \u77E5\u8BC6\u5E93(KB)\n- **Discovery**:SessionStart hook \u5217 broad-scoped \u6761\u76EE;edit \u6587\u4EF6\u65F6 PreToolUse hook \u53EF\u80FD\u89E6\u53D1 narrow hint\u3002\n- **Usage**:\u7528 `fab_get_knowledge_sections(id=...)` \u6309 id \u53D6\u6761\u76EE\u5168\u6587\u3002\n- **Write flows**:`fabric-archive` / `fabric-review` / `fabric-import` \u4E09\u4E2A Skills\u3002\n- **Language**:\u6E32\u67D3\u6309 `.fabric/fabric-config.json` \u7684 `fabric_language` \u5B57\u6BB5\u3002\n\n## Cite policy\n\n- **\u89E6\u53D1**: \u505A edit / decide / propose plan \u4E4B\u524D,**\u56DE\u590D\u9996\u884C**\u5FC5\u987B\u5199 `KB: <id> (<\u22648\u5B57 \u7528\u6CD5>) [planned|recalled|chained-from <id>|dismissed:<reason>]` \u6216 `KB: none`\u3002\n- **`[recalled]` \u9A8C\u8BC1**: \u5FC5\u987B\u7D27\u8DDF\u4E00\u6B21 `fab_get_knowledge_sections(id=...)`,\u9632\u6B62\u7F16\u9020 id\u3002\n- **\u7528\u6237\u53E3\u5934\u63D0\u89C4\u5219\u6CA1\u7ED9 id**: \u5148\u8C03 `fab_extract_knowledge` \u6216 `search_context` \u53CD\u67E5\u3002\n- **dismissed reason**: \u679A\u4E3E `scope-mismatch | outdated | not-applicable | other:<text>`\u3002\n- **\u7A3D\u6838**: `fab doctor --cite-coverage [--since=7d] [--client=cc|codex|all]` \u8F93\u51FA cite \u8986\u76D6\u7387\u3002\u672C\u89C4\u5219\u4E0D\u963B\u65AD\u4F60\u5DE5\u4F5C,\u53EA\u8BB0\u5F55\u3002\n";
 
 export { BOOTSTRAP_CANONICAL, BOOTSTRAP_MARKER_BEGIN, BOOTSTRAP_MARKER_END, BOOTSTRAP_REGEX, LEGACY_KB_MARKER_BEGIN, LEGACY_KB_MARKER_END, LEGACY_KB_REGEX };

package/dist/templates/bootstrap-canonical.js

@@ -6,7 +6,7 @@ import {
   LEGACY_KB_MARKER_BEGIN,
   LEGACY_KB_MARKER_END,
   LEGACY_KB_REGEX
-} from "../chunk-QZNUUIL3.js";
+} from "../chunk-BEABJYVL.js";
 export {
   BOOTSTRAP_CANONICAL,
   BOOTSTRAP_MARKER_BEGIN,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fenglimg/fabric-shared",
-  "version": "2.0.0-rc.21",
+  "version": "2.0.0-rc.22",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",