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

package/dist/i18n/index.js

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

package/dist/index.d.ts

@@ -4,6 +4,7 @@ export { Locale, Messages, PROTECTED_TOKENS, ProtectedToken, TranslationKey, Tra
 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, getKnowledgeAnnotations, getKnowledgeInputSchema, getKnowledgeOutputSchema, 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 AGENTS_META_LAYERS: readonly ["L0", "L1", "L2"];
 declare const AGENTS_META_TOPOLOGY_TYPES: readonly ["mirror", "cross-cutting", "domain", "local", "global"];
@@ -1354,9 +1355,7 @@ declare const fabricConfigSchema: z.ZodObject<{
         cursor?: string | undefined;
         codexCLI?: string | undefined;
     }>>;
-    externalFixturePath: z.ZodOptional<z.ZodString>;
     scanIgnores: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    auditMode: z.ZodOptional<z.ZodEnum<["strict", "warn", "off"]>>;
     audit_mode: z.ZodOptional<z.ZodEnum<["strict", "warn", "off"]>>;
     mcpPayloadLimits: z.ZodOptional<z.ZodObject<{
         warnBytes: z.ZodOptional<z.ZodNumber>;
@@ -1415,9 +1414,7 @@ declare const fabricConfigSchema: z.ZodObject<{
         cursor?: string | undefined;
         codexCLI?: string | undefined;
     } | undefined;
-    externalFixturePath?: string | undefined;
     scanIgnores?: string[] | undefined;
-    auditMode?: "strict" | "warn" | "off" | undefined;
     audit_mode?: "strict" | "warn" | "off" | undefined;
     mcpPayloadLimits?: {
         warnBytes?: number | undefined;
@@ -1430,9 +1427,7 @@ declare const fabricConfigSchema: z.ZodObject<{
         cursor?: string | undefined;
         codexCLI?: string | undefined;
     } | undefined;
-    externalFixturePath?: string | undefined;
     scanIgnores?: string[] | undefined;
-    auditMode?: "strict" | "warn" | "off" | undefined;
     audit_mode?: "strict" | "warn" | "off" | undefined;
     mcpPayloadLimits?: {
         warnBytes?: number | undefined;
@@ -1460,6 +1455,46 @@ declare const fabricConfigSchema: z.ZodObject<{
     review_stale_pending_days?: number | undefined;
 }>;
 
+type FabricConfigSchemaShape = z.infer<typeof fabricConfigSchema>;
+type PanelFieldGroup = "A_locale" | "B_hint_threshold" | "C_audit";
+type ValidateResult = {
+    ok: true;
+    value: unknown;
+} | {
+    ok: false;
+    error: string;
+};
+interface PanelFieldMeta {
+    /** Schema key this field edits — type-checked against the inferred config shape. */
+    readonly key: keyof FabricConfigSchemaShape;
+    /** Logical grouping for panel section headers. */
+    readonly group: PanelFieldGroup;
+    /** Clack widget hint — `select` for enums, `text` for free-form numbers. */
+    readonly widget: "select" | "text";
+    /** i18n key for the field label; strings landed in TASK-006. */
+    readonly label_i18n_key: string;
+    /** i18n key for the field's description / help text. */
+    readonly description_i18n_key: string;
+    /** Default value pulled from the Zod schema's `.default(...)`. */
+    readonly default: string | number;
+    /** Enum options for `select` widgets, derived from the Zod enum schema. */
+    readonly enum_values?: readonly string[];
+    /** Validates raw user input from the TUI prompt. */
+    validate(raw: string): ValidateResult;
+    /** Renders a stored value back to the panel display string. */
+    format_for_display(value: unknown): string;
+}
+/**
+ * Returns the per-field metadata array driving the `fab config` clack panel.
+ * Group A (2) + Group B (8) + Group C (1) = 11 entries.
+ */
+declare function getPanelFields(): readonly PanelFieldMeta[];
+/**
+ * Lookup a single panel field by its config key. Returns `undefined` if the
+ * key is not panel-scoped (e.g. Group D/E plumbing).
+ */
+declare function getPanelFieldByKey(key: string): PanelFieldMeta | undefined;
+
 interface ForensicCodeSample {
     path: string;
     lines: string;
@@ -2994,26 +3029,26 @@ declare const lockDriftEventSchema: z.ZodObject<{
             end_line: number;
         }>, "many">;
     }, "strip", z.ZodTypeAny, {
-        locked: {
+        drifted: {
             file: string;
             hash: string;
             start_line: number;
             end_line: number;
         }[];
-        drifted: {
+        locked: {
             file: string;
             hash: string;
             start_line: number;
             end_line: number;
         }[];
     }, {
-        locked: {
+        drifted: {
             file: string;
             hash: string;
             start_line: number;
             end_line: number;
         }[];
-        drifted: {
+        locked: {
             file: string;
             hash: string;
             start_line: number;
@@ -3023,13 +3058,13 @@ declare const lockDriftEventSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     type: "lock:drift";
     payload: {
-        locked: {
+        drifted: {
             file: string;
             hash: string;
             start_line: number;
             end_line: number;
         }[];
-        drifted: {
+        locked: {
             file: string;
             hash: string;
             start_line: number;
@@ -3039,13 +3074,13 @@ declare const lockDriftEventSchema: z.ZodObject<{
 }, {
     type: "lock:drift";
     payload: {
-        locked: {
+        drifted: {
             file: string;
             hash: string;
             start_line: number;
             end_line: number;
         }[];
-        drifted: {
+        locked: {
             file: string;
             hash: string;
             start_line: number;
@@ -4271,26 +4306,26 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
             end_line: number;
         }>, "many">;
     }, "strip", z.ZodTypeAny, {
-        locked: {
+        drifted: {
             file: string;
             hash: string;
             start_line: number;
             end_line: number;
         }[];
-        drifted: {
+        locked: {
             file: string;
             hash: string;
             start_line: number;
             end_line: number;
         }[];
     }, {
-        locked: {
+        drifted: {
             file: string;
             hash: string;
             start_line: number;
             end_line: number;
         }[];
-        drifted: {
+        locked: {
             file: string;
             hash: string;
             start_line: number;
@@ -4300,13 +4335,13 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     type: "lock:drift";
     payload: {
-        locked: {
+        drifted: {
             file: string;
             hash: string;
             start_line: number;
             end_line: number;
         }[];
-        drifted: {
+        locked: {
             file: string;
             hash: string;
             start_line: number;
@@ -4316,13 +4351,13 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
 }, {
     type: "lock:drift";
     payload: {
-        locked: {
+        drifted: {
             file: string;
             hash: string;
             start_line: number;
             end_line: number;
         }[];
-        drifted: {
+        locked: {
             file: string;
             hash: string;
             start_line: number;
@@ -5356,6 +5391,46 @@ declare const mcpConfigMigratedEventSchema: z.ZodObject<{
     correlation_id?: string | undefined;
     session_id?: string | undefined;
 }>;
+declare const bootstrapMarkerMigratedEventSchema: z.ZodObject<{
+    event_type: z.ZodLiteral<"bootstrap_marker_migrated">;
+    path: z.ZodString;
+    migrated_count: z.ZodNumber;
+    legacy_marker: z.ZodLiteral<"fabric:knowledge-base">;
+    new_marker: z.ZodLiteral<"fabric:bootstrap">;
+    timestamp: 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, {
+    path: string;
+    id: string;
+    ts: number;
+    schema_version: 1;
+    kind: "fabric-event";
+    event_type: "bootstrap_marker_migrated";
+    migrated_count: number;
+    legacy_marker: "fabric:knowledge-base";
+    new_marker: "fabric:bootstrap";
+    timestamp: string;
+    correlation_id?: string | undefined;
+    session_id?: string | undefined;
+}, {
+    path: string;
+    id: string;
+    ts: number;
+    schema_version: 1;
+    kind: "fabric-event";
+    event_type: "bootstrap_marker_migrated";
+    migrated_count: number;
+    legacy_marker: "fabric:knowledge-base";
+    new_marker: "fabric:bootstrap";
+    timestamp: string;
+    correlation_id?: string | undefined;
+    session_id?: string | undefined;
+}>;
 declare const metaReconciledOnStartupEventSchema: z.ZodObject<{
     event_type: z.ZodLiteral<"meta_reconciled_on_startup">;
     reconciled_files: z.ZodArray<z.ZodString, "many">;
@@ -5524,7 +5599,7 @@ declare const initScanCompletedEventSchema: z.ZodObject<{
     event_type: z.ZodLiteral<"init_scan_completed">;
     written_stable_ids: z.ZodArray<z.ZodString, "many">;
     duration_ms: z.ZodNumber;
-    source: z.ZodOptional<z.ZodEnum<["init", "scan", "doctor_fix"]>>;
+    source: z.ZodOptional<z.ZodEnum<["init", "scan", "doctor_fix", "doctor-rescan"]>>;
     kind: z.ZodLiteral<"fabric-event">;
     id: z.ZodString;
     ts: z.ZodNumber;
@@ -5541,7 +5616,7 @@ declare const initScanCompletedEventSchema: z.ZodObject<{
     written_stable_ids: string[];
     correlation_id?: string | undefined;
     session_id?: string | undefined;
-    source?: "doctor_fix" | "init" | "scan" | undefined;
+    source?: "doctor_fix" | "init" | "scan" | "doctor-rescan" | undefined;
 }, {
     id: string;
     ts: number;
@@ -5552,7 +5627,7 @@ declare const initScanCompletedEventSchema: z.ZodObject<{
     written_stable_ids: string[];
     correlation_id?: string | undefined;
     session_id?: string | undefined;
-    source?: "doctor_fix" | "init" | "scan" | undefined;
+    source?: "doctor_fix" | "init" | "scan" | "doctor-rescan" | undefined;
 }>;
 declare const knowledgeProposedEventSchema: z.ZodObject<{
     event_type: z.ZodLiteral<"knowledge_proposed">;
@@ -6019,7 +6094,7 @@ declare const knowledgeScopeDegradedEventSchema: z.ZodObject<{
 }>;
 declare const doctorRunEventSchema: z.ZodObject<{
     event_type: z.ZodLiteral<"doctor_run">;
-    mode: z.ZodEnum<["lint", "apply-lint"]>;
+    mode: z.ZodEnum<["lint", "fix-knowledge"]>;
     issues: z.ZodNumber;
     mutations: z.ZodOptional<z.ZodNumber>;
     timestamp: z.ZodString;
@@ -6037,7 +6112,7 @@ declare const doctorRunEventSchema: z.ZodObject<{
     kind: "fabric-event";
     event_type: "doctor_run";
     timestamp: string;
-    mode: "lint" | "apply-lint";
+    mode: "lint" | "fix-knowledge";
     correlation_id?: string | undefined;
     session_id?: string | undefined;
     mutations?: number | undefined;
@@ -6049,7 +6124,7 @@ declare const doctorRunEventSchema: z.ZodObject<{
     kind: "fabric-event";
     event_type: "doctor_run";
     timestamp: string;
-    mode: "lint" | "apply-lint";
+    mode: "lint" | "fix-knowledge";
     correlation_id?: string | undefined;
     session_id?: string | undefined;
     mutations?: number | undefined;
@@ -6153,6 +6228,83 @@ declare const pendingAutoArchivedEventSchema: z.ZodObject<{
     correlation_id?: string | undefined;
     session_id?: string | undefined;
 }>;
+declare const assistantTurnObservedEventSchema: z.ZodObject<{
+    event_type: z.ZodLiteral<"assistant_turn_observed">;
+    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">>;
+    client: z.ZodOptional<z.ZodEnum<["cc", "codex", "cursor"]>>;
+    turn_id: z.ZodString;
+    envelope_index: z.ZodOptional<z.ZodNumber>;
+    timestamp: 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: "assistant_turn_observed";
+    timestamp: string;
+    kb_line_raw: string | null;
+    cite_ids: string[];
+    cite_tags: ("none" | "planned" | "recalled" | "chained-from" | "dismissed")[];
+    turn_id: string;
+    correlation_id?: string | undefined;
+    session_id?: string | undefined;
+    client?: "cursor" | "cc" | "codex" | undefined;
+    envelope_index?: number | undefined;
+}, {
+    id: string;
+    ts: number;
+    schema_version: 1;
+    kind: "fabric-event";
+    event_type: "assistant_turn_observed";
+    timestamp: string;
+    kb_line_raw: string | null;
+    turn_id: string;
+    correlation_id?: string | undefined;
+    session_id?: string | undefined;
+    cite_ids?: string[] | undefined;
+    cite_tags?: ("none" | "planned" | "recalled" | "chained-from" | "dismissed")[] | undefined;
+    client?: "cursor" | "cc" | "codex" | undefined;
+    envelope_index?: number | undefined;
+}>;
+declare const citePolicyActivatedEventSchema: z.ZodObject<{
+    event_type: z.ZodLiteral<"cite_policy_activated">;
+    policy_version: z.ZodString;
+    timestamp: 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: "cite_policy_activated";
+    timestamp: string;
+    policy_version: string;
+    correlation_id?: string | undefined;
+    session_id?: string | undefined;
+}, {
+    id: string;
+    ts: number;
+    schema_version: 1;
+    kind: "fabric-event";
+    event_type: "cite_policy_activated";
+    timestamp: string;
+    policy_version: string;
+    correlation_id?: string | undefined;
+    session_id?: 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">;
@@ -6550,6 +6702,45 @@ declare const eventLedgerEventSchema: z.ZodDiscriminatedUnion<"event_type", [z.Z
     removed_from: string;
     correlation_id?: string | undefined;
     session_id?: string | undefined;
+}>, z.ZodObject<{
+    event_type: z.ZodLiteral<"bootstrap_marker_migrated">;
+    path: z.ZodString;
+    migrated_count: z.ZodNumber;
+    legacy_marker: z.ZodLiteral<"fabric:knowledge-base">;
+    new_marker: z.ZodLiteral<"fabric:bootstrap">;
+    timestamp: 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, {
+    path: string;
+    id: string;
+    ts: number;
+    schema_version: 1;
+    kind: "fabric-event";
+    event_type: "bootstrap_marker_migrated";
+    migrated_count: number;
+    legacy_marker: "fabric:knowledge-base";
+    new_marker: "fabric:bootstrap";
+    timestamp: string;
+    correlation_id?: string | undefined;
+    session_id?: string | undefined;
+}, {
+    path: string;
+    id: string;
+    ts: number;
+    schema_version: 1;
+    kind: "fabric-event";
+    event_type: "bootstrap_marker_migrated";
+    migrated_count: number;
+    legacy_marker: "fabric:knowledge-base";
+    new_marker: "fabric:bootstrap";
+    timestamp: string;
+    correlation_id?: string | undefined;
+    session_id?: string | undefined;
 }>, z.ZodObject<{
     event_type: z.ZodLiteral<"meta_reconciled_on_startup">;
     reconciled_files: z.ZodArray<z.ZodString, "many">;
@@ -6713,7 +6904,7 @@ declare const eventLedgerEventSchema: z.ZodDiscriminatedUnion<"event_type", [z.Z
     event_type: z.ZodLiteral<"init_scan_completed">;
     written_stable_ids: z.ZodArray<z.ZodString, "many">;
     duration_ms: z.ZodNumber;
-    source: z.ZodOptional<z.ZodEnum<["init", "scan", "doctor_fix"]>>;
+    source: z.ZodOptional<z.ZodEnum<["init", "scan", "doctor_fix", "doctor-rescan"]>>;
     kind: z.ZodLiteral<"fabric-event">;
     id: z.ZodString;
     ts: z.ZodNumber;
@@ -6730,7 +6921,7 @@ declare const eventLedgerEventSchema: z.ZodDiscriminatedUnion<"event_type", [z.Z
     written_stable_ids: string[];
     correlation_id?: string | undefined;
     session_id?: string | undefined;
-    source?: "doctor_fix" | "init" | "scan" | undefined;
+    source?: "doctor_fix" | "init" | "scan" | "doctor-rescan" | undefined;
 }, {
     id: string;
     ts: number;
@@ -6741,7 +6932,7 @@ declare const eventLedgerEventSchema: z.ZodDiscriminatedUnion<"event_type", [z.Z
     written_stable_ids: string[];
     correlation_id?: string | undefined;
     session_id?: string | undefined;
-    source?: "doctor_fix" | "init" | "scan" | undefined;
+    source?: "doctor_fix" | "init" | "scan" | "doctor-rescan" | undefined;
 }>, z.ZodObject<{
     event_type: z.ZodLiteral<"knowledge_proposed">;
     stable_id: z.ZodOptional<z.ZodString>;
@@ -7257,7 +7448,7 @@ declare const eventLedgerEventSchema: z.ZodDiscriminatedUnion<"event_type", [z.Z
     session_id?: string | undefined;
 }>, z.ZodObject<{
     event_type: z.ZodLiteral<"doctor_run">;
-    mode: z.ZodEnum<["lint", "apply-lint"]>;
+    mode: z.ZodEnum<["lint", "fix-knowledge"]>;
     issues: z.ZodNumber;
     mutations: z.ZodOptional<z.ZodNumber>;
     timestamp: z.ZodString;
@@ -7275,7 +7466,7 @@ declare const eventLedgerEventSchema: z.ZodDiscriminatedUnion<"event_type", [z.Z
     kind: "fabric-event";
     event_type: "doctor_run";
     timestamp: string;
-    mode: "lint" | "apply-lint";
+    mode: "lint" | "fix-knowledge";
     correlation_id?: string | undefined;
     session_id?: string | undefined;
     mutations?: number | undefined;
@@ -7287,7 +7478,7 @@ declare const eventLedgerEventSchema: z.ZodDiscriminatedUnion<"event_type", [z.Z
     kind: "fabric-event";
     event_type: "doctor_run";
     timestamp: string;
-    mode: "lint" | "apply-lint";
+    mode: "lint" | "fix-knowledge";
     correlation_id?: string | undefined;
     session_id?: string | undefined;
     mutations?: number | undefined;
@@ -7324,6 +7515,81 @@ declare const eventLedgerEventSchema: z.ZodDiscriminatedUnion<"event_type", [z.Z
     touched_count: number;
     correlation_id?: string | undefined;
     session_id?: string | undefined;
+}>, z.ZodObject<{
+    event_type: z.ZodLiteral<"assistant_turn_observed">;
+    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">>;
+    client: z.ZodOptional<z.ZodEnum<["cc", "codex", "cursor"]>>;
+    turn_id: z.ZodString;
+    envelope_index: z.ZodOptional<z.ZodNumber>;
+    timestamp: 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: "assistant_turn_observed";
+    timestamp: string;
+    kb_line_raw: string | null;
+    cite_ids: string[];
+    cite_tags: ("none" | "planned" | "recalled" | "chained-from" | "dismissed")[];
+    turn_id: string;
+    correlation_id?: string | undefined;
+    session_id?: string | undefined;
+    client?: "cursor" | "cc" | "codex" | undefined;
+    envelope_index?: number | undefined;
+}, {
+    id: string;
+    ts: number;
+    schema_version: 1;
+    kind: "fabric-event";
+    event_type: "assistant_turn_observed";
+    timestamp: string;
+    kb_line_raw: string | null;
+    turn_id: string;
+    correlation_id?: string | undefined;
+    session_id?: string | undefined;
+    cite_ids?: string[] | undefined;
+    cite_tags?: ("none" | "planned" | "recalled" | "chained-from" | "dismissed")[] | undefined;
+    client?: "cursor" | "cc" | "codex" | undefined;
+    envelope_index?: number | undefined;
+}>, z.ZodObject<{
+    event_type: z.ZodLiteral<"cite_policy_activated">;
+    policy_version: z.ZodString;
+    timestamp: 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: "cite_policy_activated";
+    timestamp: string;
+    policy_version: string;
+    correlation_id?: string | undefined;
+    session_id?: string | undefined;
+}, {
+    id: string;
+    ts: number;
+    schema_version: 1;
+    kind: "fabric-event";
+    event_type: "cite_policy_activated";
+    timestamp: string;
+    policy_version: string;
+    correlation_id?: string | undefined;
+    session_id?: string | undefined;
 }>]>;
 type KnowledgeContextPlannedEvent = z.infer<typeof knowledgeContextPlannedEventSchema>;
 type KnowledgeSelectionEvent = z.infer<typeof knowledgeSelectionEventSchema>;
@@ -7334,6 +7600,7 @@ type McpEventLedgerEvent = z.infer<typeof mcpEventLedgerEventSchema>;
 type ReapplyCompletedEvent = z.infer<typeof reapplyCompletedEventSchema>;
 type EventLedgerTruncatedEvent = z.infer<typeof eventLedgerTruncatedEventSchema>;
 type McpConfigMigratedEvent = z.infer<typeof mcpConfigMigratedEventSchema>;
+type BootstrapMarkerMigratedEvent = z.infer<typeof bootstrapMarkerMigratedEventSchema>;
 type MetaReconciledOnStartupEvent = z.infer<typeof metaReconciledOnStartupEventSchema>;
 type MetaReconciledEvent = z.infer<typeof metaReconciledEventSchema>;
 type ClaudeSkillPathMigratedEvent = z.infer<typeof claudeSkillPathMigratedEventSchema>;
@@ -7357,9 +7624,11 @@ type PendingAutoArchivedEvent = z.infer<typeof pendingAutoArchivedEventSchema>;
 type KnowledgePathDangledEvent = z.infer<typeof knowledgePathDangledEventSchema>;
 type DoctorRunEvent = z.infer<typeof doctorRunEventSchema>;
 type RelevanceMigrationRunEvent = z.infer<typeof relevanceMigrationRunEventSchema>;
-type EventLedgerEvent = KnowledgeContextPlannedEvent | KnowledgeSelectionEvent | KnowledgeSectionsFetchedEvent | EditIntentCheckedEvent | KnowledgeDriftDetectedEvent | McpEventLedgerEvent | ReapplyCompletedEvent | EventLedgerTruncatedEvent | McpConfigMigratedEvent | MetaReconciledOnStartupEvent | MetaReconciledEvent | ClaudeSkillPathMigratedEvent | ClaudeHookPathMigratedEvent | CodexSkillPathMigratedEvent | InitScanCompletedEvent | KnowledgeProposedEvent | KnowledgePromoteStartedEvent | KnowledgePromotedEvent | KnowledgePromoteFailedEvent | KnowledgeLayerChangedEvent | KnowledgeSlugRenamedEvent | KnowledgeDemotedEvent | KnowledgeArchivedEvent | KnowledgeArchiveAttemptedEvent | KnowledgeDeferredEvent | KnowledgeRejectedEvent | KnowledgeConsumedEvent | KnowledgeScopeDegradedEvent | PendingAutoArchivedEvent | KnowledgePathDangledEvent | DoctorRunEvent | RelevanceMigrationRunEvent;
+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 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 CandidateFileEntry, type CandidateFileFamily, type ClaudeHookPathMigratedEvent, type ClaudeSkillPathMigratedEvent, type CodexSkillPathMigratedEvent, type DoctorRunEvent, type DriftDetectedEvent, type EditIntentCheckedEvent, type EventLedgerEvent, type EventLedgerEventInput, type EventLedgerEventType, type EventLedgerTruncatedEvent, 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 PendingAutoArchivedEvent, type ReapplyCompletedEvent, type RelevanceMigrationRunEvent, StableId, agentsIdentitySourceSchema, agentsLayerSchema, agentsMetaNodeSchema, agentsMetaSchema, agentsTopologyTypeSchema, aiLedgerEntrySchema, allocateKnowledgeId, auditModeSchema, candidateFileEntrySchema, 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, 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 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 };