@fenglimg/fabric-shared 2.0.0-rc.23 → 2.0.0-rc.26

package/dist/i18n/index.d.ts

@@ -10,6 +10,26 @@ declare function createTranslator(locale: Locale, messages?: Record<Locale, Mess
 
 declare function detectNodeLocale(): Locale;
 
+/**
+ * Resolve the effective runtime locale for a given project root.
+ *
+ * Resolution order (rc.26 — closes KT-DEC-9004 runtime gap):
+ *   1. Read `<projectRoot>/.fabric/fabric-config.json` and inspect
+ *      `fabric_language`.
+ *   2. If the value is `"en"` or `"zh-CN"` (the two concrete Locale members),
+ *      return it verbatim — this is the eager-resolved value `fab init` is
+ *      supposed to write back per KT-DEC-9004.
+ *   3. If the value is `"match-existing"` or `"zh-CN-hybrid"` (placeholders
+ *      that should NEVER survive `fab init` per KT-DEC-9004's invariant),
+ *      emit a `console.warn` and fall through to `detectNodeLocale()`.
+ *   4. If the file is missing, unreadable, malformed JSON, or `fabric_language`
+ *      is absent / has any other shape, silently fall through to
+ *      `detectNodeLocale()` (env-driven: `FAB_LANG` → `LANG` → `"en"`).
+ *
+ * Never throws — all failure paths degrade to `detectNodeLocale()`.
+ */
+declare function resolveFabricLocale(projectRoot: string): Locale;
+
 declare function normalizeLocale(raw: string | null | undefined): Locale;
 
 declare const PROTECTED_TOKENS: readonly ["fab_plan_context", "fab_get_knowledge_sections", "fab_extract_knowledge", "fab_review", "AGENTS.md", ".fabric/agents/", ".fabric/agents/_cross/", ".fabric/agents.meta.json", ".fabric/human-lock.json", ".fabric/events.jsonl", ".fabric/knowledge/", "knowledge_proposed", "relevance_scope", "relevance_paths", "narrow", "broad", "source_sessions", "proposed_reason", "session_context", "layer", "team", "personal", "pending_path", "knowledge_scope_degraded", "@HUMAN", "MUST", "NEVER"];
@@ -19,4 +39,4 @@ declare const enMessages: Messages;
 
 declare const zhCNMessages: Messages;
 
-export { type Locale, type Messages, PROTECTED_TOKENS, type ProtectedToken, type TranslationKey, type Translator, createTranslator, defaultMessages, detectNodeLocale, enMessages, normalizeLocale, zhCNMessages };
+export { type Locale, type Messages, PROTECTED_TOKENS, type ProtectedToken, type TranslationKey, type Translator, createTranslator, defaultMessages, detectNodeLocale, enMessages, normalizeLocale, resolveFabricLocale, zhCNMessages };

package/dist/i18n/index.js

@@ -5,8 +5,9 @@ import {
   detectNodeLocale,
   enMessages,
   normalizeLocale,
+  resolveFabricLocale,
   zhCNMessages
-} from "../chunk-GYIALPMW.js";
+} from "../chunk-E5LHOWTN.js";
 export {
   PROTECTED_TOKENS,
   createTranslator,
@@ -14,5 +15,6 @@ export {
   detectNodeLocale,
   enMessages,
   normalizeLocale,
+  resolveFabricLocale,
   zhCNMessages
 };

package/dist/index.d.ts

@@ -1,9 +1,9 @@
 import { AgentsMetaNode, AgentsIdentitySource, AgentsLayer, AgentsTopologyType, HumanLockEntry, AgentsMeta, LedgerEntry } from './types/index.js';
 export { AgentsActivationTier, AgentsMetaCountersEnvelope, AgentsMetaKnowledgeTypeCounters, AgentsMetaNodeActivation, AiLedgerEntry, AuditMode, ClientPaths, DefaultLayerFilter, FabricConfig, FabricLanguage, HumanLedgerEntry, McpPayloadLimits, RuleDescription, RuleDescriptionIndexItem } from './types/index.js';
-export { Locale, Messages, PROTECTED_TOKENS, ProtectedToken, TranslationKey, Translator, createTranslator, defaultMessages, detectNodeLocale, enMessages, normalizeLocale, zhCNMessages } from './i18n/index.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';
-export { FabExtractKnowledgeInput, FabExtractKnowledgeInputSchema, FabExtractKnowledgeInputShape, FabExtractKnowledgeOutput, FabExtractKnowledgeOutputSchema, FabReviewInput, FabReviewInputSchema, FabReviewInputShape, FabReviewOutput, FabReviewOutputSchema, FabReviewOutputShape, KNOWLEDGE_TYPE_CODES, KnowledgeEntryFrontmatter, KnowledgeEntryFrontmatterSchema, KnowledgeTypeCode, KnowledgeTypeSchema, LayerSchema, Maturity, MaturitySchema, PROPOSED_REASON_DESCRIPTIONS, ProposedReason, ProposedReasonSchema, StableIdSchema, annotateIntentRequestSchema, fabExtractKnowledgeAnnotations, fabReviewAnnotations, formatKnowledgeId, historyStateQuerySchema, humanLockApproveRequestSchema, humanLockFileParamsSchema, knowledgeSectionsAnnotations, knowledgeSectionsInputSchema, knowledgeSectionsOutputSchema, ledgerQuerySchema, ledgerSourceSchema, parseKnowledgeId, planContextAnnotations, planContextHintNarrowEntrySchema, planContextHintOutputSchema, planContextInputSchema, planContextOutputSchema, structuredWarningSchema } from './schemas/api-contracts.js';
+export { CiteContractMetrics, CiteCoverageReport, CiteLayerTypeBreakdown, FabExtractKnowledgeInput, FabExtractKnowledgeInputSchema, FabExtractKnowledgeInputShape, FabExtractKnowledgeOutput, FabExtractKnowledgeOutputSchema, FabReviewInput, FabReviewInputSchema, FabReviewInputShape, FabReviewOutput, FabReviewOutputSchema, FabReviewOutputShape, KNOWLEDGE_TYPE_CODES, KnowledgeEntryFrontmatter, KnowledgeEntryFrontmatterSchema, KnowledgeTypeCode, KnowledgeTypeSchema, LayerSchema, Maturity, MaturitySchema, PROPOSED_REASON_DESCRIPTIONS, ProposedReason, ProposedReasonSchema, StableIdSchema, annotateIntentRequestSchema, citeContractMetricsSchema, citeCoverageReportSchema, citeLayerTypeBreakdownSchema, fabExtractKnowledgeAnnotations, fabReviewAnnotations, formatKnowledgeId, historyStateQuerySchema, humanLockApproveRequestSchema, humanLockFileParamsSchema, knowledgeSectionsAnnotations, knowledgeSectionsInputSchema, knowledgeSectionsOutputSchema, ledgerQuerySchema, ledgerSourceSchema, parseKnowledgeId, planContextAnnotations, planContextHintNarrowEntrySchema, planContextHintOutputSchema, planContextInputSchema, planContextOutputSchema, structuredWarningSchema } from './schemas/api-contracts.js';
 export { BOOTSTRAP_CANONICAL, BOOTSTRAP_MARKER_BEGIN, BOOTSTRAP_MARKER_END, BOOTSTRAP_REGEX, LEGACY_KB_MARKER_BEGIN, LEGACY_KB_MARKER_END, LEGACY_KB_REGEX } from './templates/bootstrap-canonical.js';
 
 declare const ONBOARD_SLOT_NAMES: readonly ["tech-stack-decision", "architecture-pattern", "code-style-tone", "build-system-idiom", "domain-vocabulary"];
@@ -1091,8 +1091,8 @@ declare const knowledgeTestIndexSchema: z.ZodObject<{
         previous_test_hash?: string | undefined;
     }>, "many">;
 }, "strict", z.ZodTypeAny, {
-    schema_version: 1;
     generated_at: string;
+    schema_version: 1;
     links: {
         rule_stable_id: string;
         rule_file: string;
@@ -1113,8 +1113,8 @@ declare const knowledgeTestIndexSchema: z.ZodObject<{
     revision?: string | undefined;
     previous_revision?: string | undefined;
 }, {
-    schema_version: 1;
     generated_at: string;
+    schema_version: 1;
     links: {
         rule_stable_id: string;
         rule_file: string;
@@ -1321,14 +1321,14 @@ declare const clientPathsSchema: z.ZodObject<{
     cursor: z.ZodOptional<z.ZodString>;
     codexCLI: z.ZodOptional<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
+    cursor?: string | undefined;
     claudeCodeCLI?: string | undefined;
     claudeCodeDesktop?: string | undefined;
-    cursor?: string | undefined;
     codexCLI?: string | undefined;
 }, {
+    cursor?: string | undefined;
     claudeCodeCLI?: string | undefined;
     claudeCodeDesktop?: string | undefined;
-    cursor?: string | undefined;
     codexCLI?: string | undefined;
 }>;
 declare const mcpPayloadLimitsSchema: z.ZodOptional<z.ZodObject<{
@@ -1350,14 +1350,14 @@ declare const fabricConfigSchema: z.ZodObject<{
         cursor: z.ZodOptional<z.ZodString>;
         codexCLI: z.ZodOptional<z.ZodString>;
     }, "strict", z.ZodTypeAny, {
+        cursor?: string | undefined;
         claudeCodeCLI?: string | undefined;
         claudeCodeDesktop?: string | undefined;
-        cursor?: string | undefined;
         codexCLI?: string | undefined;
     }, {
+        cursor?: string | undefined;
         claudeCodeCLI?: string | undefined;
         claudeCodeDesktop?: string | undefined;
-        cursor?: string | undefined;
         codexCLI?: string | undefined;
     }>>;
     scanIgnores: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -1417,9 +1417,9 @@ declare const fabricConfigSchema: z.ZodObject<{
     review_stale_pending_days: number;
     onboard_slots_opted_out: string[];
     clientPaths?: {
+        cursor?: string | undefined;
         claudeCodeCLI?: string | undefined;
         claudeCodeDesktop?: string | undefined;
-        cursor?: string | undefined;
         codexCLI?: string | undefined;
     } | undefined;
     scanIgnores?: string[] | undefined;
@@ -1431,9 +1431,9 @@ declare const fabricConfigSchema: z.ZodObject<{
     fabric_event_retention_days?: 7 | 30 | 90 | undefined;
 }, {
     clientPaths?: {
+        cursor?: string | undefined;
         claudeCodeCLI?: string | undefined;
         claudeCodeDesktop?: string | undefined;
-        cursor?: string | undefined;
         codexCLI?: string | undefined;
     } | undefined;
     scanIgnores?: string[] | undefined;
@@ -6247,6 +6247,31 @@ declare const assistantTurnObservedEventSchema: z.ZodObject<{
     kb_line_raw: z.ZodNullable<z.ZodString>;
     cite_ids: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
     cite_tags: z.ZodDefault<z.ZodArray<z.ZodEnum<["planned", "recalled", "chained-from", "dismissed", "none"]>, "many">>;
+    cite_commitments: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        operators: z.ZodArray<z.ZodObject<{
+            kind: z.ZodEnum<["edit", "not_edit", "require", "forbid"]>;
+            target: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            kind: "require" | "edit" | "not_edit" | "forbid";
+            target: string;
+        }, {
+            kind: "require" | "edit" | "not_edit" | "forbid";
+            target: string;
+        }>, "many">;
+        skip_reason: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        operators: {
+            kind: "require" | "edit" | "not_edit" | "forbid";
+            target: string;
+        }[];
+        skip_reason: string | null;
+    }, {
+        operators: {
+            kind: "require" | "edit" | "not_edit" | "forbid";
+            target: string;
+        }[];
+        skip_reason: string | null;
+    }>, "many">>;
     client: z.ZodOptional<z.ZodEnum<["cc", "codex", "cursor"]>>;
     turn_id: z.ZodString;
     envelope_index: z.ZodOptional<z.ZodNumber>;
@@ -6267,10 +6292,17 @@ declare const assistantTurnObservedEventSchema: z.ZodObject<{
     kb_line_raw: string | null;
     cite_ids: string[];
     cite_tags: ("none" | "planned" | "recalled" | "chained-from" | "dismissed")[];
+    cite_commitments: {
+        operators: {
+            kind: "require" | "edit" | "not_edit" | "forbid";
+            target: string;
+        }[];
+        skip_reason: string | null;
+    }[];
     turn_id: string;
     correlation_id?: string | undefined;
     session_id?: string | undefined;
-    client?: "cursor" | "cc" | "codex" | undefined;
+    client?: "cc" | "codex" | "cursor" | undefined;
     envelope_index?: number | undefined;
 }, {
     id: string;
@@ -6285,7 +6317,14 @@ declare const assistantTurnObservedEventSchema: z.ZodObject<{
     session_id?: string | undefined;
     cite_ids?: string[] | undefined;
     cite_tags?: ("none" | "planned" | "recalled" | "chained-from" | "dismissed")[] | undefined;
-    client?: "cursor" | "cc" | "codex" | undefined;
+    cite_commitments?: {
+        operators: {
+            kind: "require" | "edit" | "not_edit" | "forbid";
+            target: string;
+        }[];
+        skip_reason: string | null;
+    }[] | undefined;
+    client?: "cc" | "codex" | "cursor" | undefined;
     envelope_index?: number | undefined;
 }>;
 declare const citePolicyActivatedEventSchema: z.ZodObject<{
@@ -6319,6 +6358,31 @@ declare const citePolicyActivatedEventSchema: z.ZodObject<{
     correlation_id?: string | undefined;
     session_id?: string | undefined;
 }>;
+declare const citeContractPolicyActivatedEventSchema: z.ZodObject<{
+    event_type: z.ZodLiteral<"cite_contract_policy_activated">;
+    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: "cite_contract_policy_activated";
+    correlation_id?: string | undefined;
+    session_id?: string | undefined;
+}, {
+    id: string;
+    ts: number;
+    schema_version: 1;
+    kind: "fabric-event";
+    event_type: "cite_contract_policy_activated";
+    correlation_id?: string | undefined;
+    session_id?: string | undefined;
+}>;
 declare const eventsRotatedEventSchema: z.ZodObject<{
     event_type: z.ZodLiteral<"events_rotated">;
     cutoff_ts: z.ZodString;
@@ -6464,6 +6528,43 @@ declare const knowledgeEnrichedEventSchema: z.ZodObject<{
     correlation_id?: string | undefined;
     session_id?: string | undefined;
 }>;
+declare const sessionArchiveAttemptedEventSchema: z.ZodObject<{
+    event_type: z.ZodLiteral<"session_archive_attempted">;
+    outcome: z.ZodEnum<["proposed", "viability_failed", "user_dismissed", "skipped_no_signal"]>;
+    covered_through_ts: z.ZodNumber;
+    candidates_proposed: z.ZodDefault<z.ZodNumber>;
+    knowledge_proposed_ids: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    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: "session_archive_attempted";
+    outcome: "proposed" | "viability_failed" | "user_dismissed" | "skipped_no_signal";
+    covered_through_ts: number;
+    candidates_proposed: number;
+    knowledge_proposed_ids: string[];
+    correlation_id?: string | undefined;
+    session_id?: string | undefined;
+}, {
+    id: string;
+    ts: number;
+    schema_version: 1;
+    kind: "fabric-event";
+    event_type: "session_archive_attempted";
+    outcome: "proposed" | "viability_failed" | "user_dismissed" | "skipped_no_signal";
+    covered_through_ts: number;
+    correlation_id?: string | undefined;
+    session_id?: string | undefined;
+    candidates_proposed?: number | undefined;
+    knowledge_proposed_ids?: string[] | undefined;
+}>;
 declare const eventLedgerEventSchema: z.ZodDiscriminatedUnion<"event_type", [z.ZodObject<{
     event_type: z.ZodLiteral<"knowledge_context_planned">;
     target_paths: z.ZodArray<z.ZodString, "many">;
@@ -7682,6 +7783,31 @@ declare const eventLedgerEventSchema: z.ZodDiscriminatedUnion<"event_type", [z.Z
     kb_line_raw: z.ZodNullable<z.ZodString>;
     cite_ids: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
     cite_tags: z.ZodDefault<z.ZodArray<z.ZodEnum<["planned", "recalled", "chained-from", "dismissed", "none"]>, "many">>;
+    cite_commitments: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        operators: z.ZodArray<z.ZodObject<{
+            kind: z.ZodEnum<["edit", "not_edit", "require", "forbid"]>;
+            target: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            kind: "require" | "edit" | "not_edit" | "forbid";
+            target: string;
+        }, {
+            kind: "require" | "edit" | "not_edit" | "forbid";
+            target: string;
+        }>, "many">;
+        skip_reason: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        operators: {
+            kind: "require" | "edit" | "not_edit" | "forbid";
+            target: string;
+        }[];
+        skip_reason: string | null;
+    }, {
+        operators: {
+            kind: "require" | "edit" | "not_edit" | "forbid";
+            target: string;
+        }[];
+        skip_reason: string | null;
+    }>, "many">>;
     client: z.ZodOptional<z.ZodEnum<["cc", "codex", "cursor"]>>;
     turn_id: z.ZodString;
     envelope_index: z.ZodOptional<z.ZodNumber>;
@@ -7702,10 +7828,17 @@ declare const eventLedgerEventSchema: z.ZodDiscriminatedUnion<"event_type", [z.Z
     kb_line_raw: string | null;
     cite_ids: string[];
     cite_tags: ("none" | "planned" | "recalled" | "chained-from" | "dismissed")[];
+    cite_commitments: {
+        operators: {
+            kind: "require" | "edit" | "not_edit" | "forbid";
+            target: string;
+        }[];
+        skip_reason: string | null;
+    }[];
     turn_id: string;
     correlation_id?: string | undefined;
     session_id?: string | undefined;
-    client?: "cursor" | "cc" | "codex" | undefined;
+    client?: "cc" | "codex" | "cursor" | undefined;
     envelope_index?: number | undefined;
 }, {
     id: string;
@@ -7720,7 +7853,14 @@ declare const eventLedgerEventSchema: z.ZodDiscriminatedUnion<"event_type", [z.Z
     session_id?: string | undefined;
     cite_ids?: string[] | undefined;
     cite_tags?: ("none" | "planned" | "recalled" | "chained-from" | "dismissed")[] | undefined;
-    client?: "cursor" | "cc" | "codex" | undefined;
+    cite_commitments?: {
+        operators: {
+            kind: "require" | "edit" | "not_edit" | "forbid";
+            target: string;
+        }[];
+        skip_reason: string | null;
+    }[] | undefined;
+    client?: "cc" | "codex" | "cursor" | undefined;
     envelope_index?: number | undefined;
 }>, z.ZodObject<{
     event_type: z.ZodLiteral<"cite_policy_activated">;
@@ -7752,6 +7892,30 @@ 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<"cite_contract_policy_activated">;
+    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: "cite_contract_policy_activated";
+    correlation_id?: string | undefined;
+    session_id?: string | undefined;
+}, {
+    id: string;
+    ts: number;
+    schema_version: 1;
+    kind: "fabric-event";
+    event_type: "cite_contract_policy_activated";
+    correlation_id?: string | undefined;
+    session_id?: string | undefined;
 }>, z.ZodObject<{
     event_type: z.ZodLiteral<"knowledge_meta_auto_healed">;
     previous_revision_hash: z.ZodString;
@@ -7893,6 +8057,42 @@ declare const eventLedgerEventSchema: z.ZodDiscriminatedUnion<"event_type", [z.Z
     added_fields: ("intent_clues" | "tech_stack" | "impact" | "must_read_if")[];
     correlation_id?: string | undefined;
     session_id?: string | undefined;
+}>, z.ZodObject<{
+    event_type: z.ZodLiteral<"session_archive_attempted">;
+    outcome: z.ZodEnum<["proposed", "viability_failed", "user_dismissed", "skipped_no_signal"]>;
+    covered_through_ts: z.ZodNumber;
+    candidates_proposed: z.ZodDefault<z.ZodNumber>;
+    knowledge_proposed_ids: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    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: "session_archive_attempted";
+    outcome: "proposed" | "viability_failed" | "user_dismissed" | "skipped_no_signal";
+    covered_through_ts: number;
+    candidates_proposed: number;
+    knowledge_proposed_ids: string[];
+    correlation_id?: string | undefined;
+    session_id?: string | undefined;
+}, {
+    id: string;
+    ts: number;
+    schema_version: 1;
+    kind: "fabric-event";
+    event_type: "session_archive_attempted";
+    outcome: "proposed" | "viability_failed" | "user_dismissed" | "skipped_no_signal";
+    covered_through_ts: number;
+    correlation_id?: string | undefined;
+    session_id?: string | undefined;
+    candidates_proposed?: number | undefined;
+    knowledge_proposed_ids?: string[] | undefined;
 }>]>;
 type KnowledgeContextPlannedEvent = z.infer<typeof knowledgeContextPlannedEventSchema>;
 type KnowledgeSelectionEvent = z.infer<typeof knowledgeSelectionEventSchema>;
@@ -7929,13 +8129,39 @@ 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 CiteContractPolicyActivatedEvent = z.infer<typeof citeContractPolicyActivatedEventSchema>;
 type KnowledgeMetaAutoHealedEvent = z.infer<typeof knowledgeMetaAutoHealedEventSchema>;
 type EventsRotatedEvent = z.infer<typeof eventsRotatedEventSchema>;
 type ServeLockClearedEvent = z.infer<typeof serveLockClearedEventSchema>;
 type KnowledgeEnrichedEvent = z.infer<typeof knowledgeEnrichedEventSchema>;
-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 | ServeLockClearedEvent | KnowledgeEnrichedEvent;
+type SessionArchiveAttemptedEvent = z.infer<typeof sessionArchiveAttemptedEventSchema>;
+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 | CiteContractPolicyActivatedEvent | KnowledgeMetaAutoHealedEvent | EventsRotatedEvent | ServeLockClearedEvent | KnowledgeEnrichedEvent | SessionArchiveAttemptedEvent;
 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 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 KnowledgeEnrichedEvent, 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, ONBOARD_SLOT_NAMES, ONBOARD_SLOT_TOTAL, type OnboardSlot, type PanelFieldGroup, type PanelFieldMeta, type PendingAutoArchivedEvent, type ReapplyCompletedEvent, type RelevanceMigrationRunEvent, type ServeLockClearedEvent, 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, knowledgeEnrichedEventSchema, 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, onboardSlotSchema, pendingAutoArchivedEventSchema, reapplyCompletedEventSchema, relevanceMigrationRunEventSchema, ruleDescriptionIndexItemSchema, ruleDescriptionSchema, serveLockClearedEventSchema, withDerivedAgentsMetaNodeDefaults };
+type CiteTag = "planned" | "recalled" | "chained-from" | "dismissed" | "none";
+type CiteCommitmentOperatorKind = "edit" | "not_edit" | "require" | "forbid";
+interface CiteCommitmentOperator {
+    kind: CiteCommitmentOperatorKind;
+    target: string;
+}
+interface CiteCommitment {
+    operators: CiteCommitmentOperator[];
+    skip_reason: string | null;
+}
+interface ParseCiteLineResult {
+    cite_ids: string[];
+    cite_tags: CiteTag[];
+    cite_commitments: CiteCommitment[];
+}
+/**
+ * Parse one or more newline-separated `KB:` cite lines into structured
+ * arrays matching the assistant_turn_observed event-ledger fields.
+ *
+ * Tolerates whitespace, CR/LF line endings, blank lines, and non-KB
+ * interleaved prose. Index contract documented above.
+ */
+declare function parseCiteLine(raw: string): ParseCiteLineResult;
+
+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 CiteCommitment, type CiteCommitmentOperator, type CiteCommitmentOperatorKind, type CiteContractPolicyActivatedEvent, type CitePolicyActivatedEvent, type CiteTag, 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 KnowledgeEnrichedEvent, 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, ONBOARD_SLOT_NAMES, ONBOARD_SLOT_TOTAL, type OnboardSlot, type PanelFieldGroup, type PanelFieldMeta, type ParseCiteLineResult, type PendingAutoArchivedEvent, type ReapplyCompletedEvent, type RelevanceMigrationRunEvent, type ServeLockClearedEvent, type SessionArchiveAttemptedEvent, StableId, type ValidateResult, agentsIdentitySourceSchema, agentsLayerSchema, agentsMetaNodeSchema, agentsMetaSchema, agentsTopologyTypeSchema, aiLedgerEntrySchema, allocateKnowledgeId, assistantTurnObservedEventSchema, auditModeSchema, bootstrapMarkerMigratedEventSchema, candidateFileEntrySchema, citeContractPolicyActivatedEventSchema, 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, knowledgeEnrichedEventSchema, 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, onboardSlotSchema, parseCiteLine, pendingAutoArchivedEventSchema, reapplyCompletedEventSchema, relevanceMigrationRunEventSchema, ruleDescriptionIndexItemSchema, ruleDescriptionSchema, serveLockClearedEventSchema, sessionArchiveAttemptedEventSchema, withDerivedAgentsMetaNodeDefaults };