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

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

@@ -709,187 +709,8 @@ declare const planContextHintOutputSchema: z.ZodObject<{
     version: 1;
     broad_count: number;
 }>;
-declare const getKnowledgeInputSchema: z.ZodObject<{
-    path: z.ZodString;
-    client_hash: z.ZodOptional<z.ZodString>;
-    correlation_id: z.ZodOptional<z.ZodString>;
-    session_id: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    path: string;
-    client_hash?: string | undefined;
-    correlation_id?: string | undefined;
-    session_id?: string | undefined;
-}, {
-    path: string;
-    client_hash?: string | undefined;
-    correlation_id?: string | undefined;
-    session_id?: string | undefined;
-}>;
-declare const getKnowledgeOutputSchema: z.ZodObject<{
-    revision_hash: z.ZodString;
-    stale: z.ZodBoolean;
-    rules: z.ZodObject<{
-        L0: z.ZodString;
-        L1: z.ZodArray<z.ZodObject<{
-            path: z.ZodString;
-            content: z.ZodString;
-        }, "strip", z.ZodTypeAny, {
-            path: string;
-            content: string;
-        }, {
-            path: string;
-            content: string;
-        }>, "many">;
-        L2: z.ZodArray<z.ZodObject<{
-            path: z.ZodString;
-            content: z.ZodString;
-        }, "strip", z.ZodTypeAny, {
-            path: string;
-            content: string;
-        }, {
-            path: string;
-            content: string;
-        }>, "many">;
-        human_locked_nearby: z.ZodArray<z.ZodObject<{
-            file: z.ZodString;
-            excerpt: z.ZodString;
-        }, "strip", z.ZodTypeAny, {
-            file: string;
-            excerpt: string;
-        }, {
-            file: string;
-            excerpt: string;
-        }>, "many">;
-        description_stubs: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            path: z.ZodString;
-            description: z.ZodString;
-        }, "strip", z.ZodTypeAny, {
-            path: string;
-            description: string;
-        }, {
-            path: string;
-            description: string;
-        }>, "many">>;
-    }, "strip", z.ZodTypeAny, {
-        L0: string;
-        L1: {
-            path: string;
-            content: string;
-        }[];
-        L2: {
-            path: string;
-            content: string;
-        }[];
-        human_locked_nearby: {
-            file: string;
-            excerpt: string;
-        }[];
-        description_stubs?: {
-            path: string;
-            description: string;
-        }[] | undefined;
-    }, {
-        L0: string;
-        L1: {
-            path: string;
-            content: string;
-        }[];
-        L2: {
-            path: string;
-            content: string;
-        }[];
-        human_locked_nearby: {
-            file: string;
-            excerpt: string;
-        }[];
-        description_stubs?: {
-            path: string;
-            description: string;
-        }[] | undefined;
-    }>;
-    warnings: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        code: z.ZodString;
-        file: z.ZodString;
-        line: z.ZodOptional<z.ZodNumber>;
-        action_hint: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        file: string;
-        code: string;
-        action_hint: string;
-        line?: number | undefined;
-    }, {
-        file: string;
-        code: string;
-        action_hint: string;
-        line?: number | undefined;
-    }>, "many">>;
-}, "strip", z.ZodTypeAny, {
-    stale: boolean;
-    revision_hash: string;
-    rules: {
-        L0: string;
-        L1: {
-            path: string;
-            content: string;
-        }[];
-        L2: {
-            path: string;
-            content: string;
-        }[];
-        human_locked_nearby: {
-            file: string;
-            excerpt: string;
-        }[];
-        description_stubs?: {
-            path: string;
-            description: string;
-        }[] | undefined;
-    };
-    warnings?: {
-        file: string;
-        code: string;
-        action_hint: string;
-        line?: number | undefined;
-    }[] | undefined;
-}, {
-    stale: boolean;
-    revision_hash: string;
-    rules: {
-        L0: string;
-        L1: {
-            path: string;
-            content: string;
-        }[];
-        L2: {
-            path: string;
-            content: string;
-        }[];
-        human_locked_nearby: {
-            file: string;
-            excerpt: string;
-        }[];
-        description_stubs?: {
-            path: string;
-            description: string;
-        }[] | undefined;
-    };
-    warnings?: {
-        file: string;
-        code: string;
-        action_hint: string;
-        line?: number | undefined;
-    }[] | undefined;
-}>;
-declare const getKnowledgeAnnotations: {
-    readonly readOnlyHint: true;
-    readonly idempotentHint: true;
-    readonly destructiveHint: false;
-    readonly openWorldHint: false;
-    readonly title: "Get rule content";
-};
 declare const knowledgeSectionsInputSchema: z.ZodObject<{
     selection_token: z.ZodString;
-    sections: z.ZodArray<z.ZodEnum<["MISSION_STATEMENT", "MANDATORY_INJECTION", "BUSINESS_LOGIC_CHUNKS", "CONTEXT_INFO"]>, "many">;
     ai_selected_stable_ids: z.ZodArray<z.ZodString, "many">;
     ai_selection_reasons: z.ZodRecord<z.ZodString, z.ZodString>;
     correlation_id: z.ZodOptional<z.ZodString>;
@@ -897,7 +718,6 @@ declare const knowledgeSectionsInputSchema: z.ZodObject<{
     client_hash: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     selection_token: string;
-    sections: ("MISSION_STATEMENT" | "MANDATORY_INJECTION" | "BUSINESS_LOGIC_CHUNKS" | "CONTEXT_INFO")[];
     ai_selected_stable_ids: string[];
     ai_selection_reasons: Record<string, string>;
     client_hash?: string | undefined;
@@ -905,7 +725,6 @@ declare const knowledgeSectionsInputSchema: z.ZodObject<{
     session_id?: string | undefined;
 }, {
     selection_token: string;
-    sections: ("MISSION_STATEMENT" | "MANDATORY_INJECTION" | "BUSINESS_LOGIC_CHUNKS" | "CONTEXT_INFO")[];
     ai_selected_stable_ids: string[];
     ai_selection_reasons: Record<string, string>;
     client_hash?: string | undefined;
@@ -914,43 +733,32 @@ declare const knowledgeSectionsInputSchema: z.ZodObject<{
 }>;
 declare const knowledgeSectionsOutputSchema: z.ZodObject<{
     revision_hash: z.ZodString;
-    precedence: z.ZodTuple<[z.ZodLiteral<"L2">, z.ZodLiteral<"L1">, z.ZodLiteral<"L0">], null>;
+    /**
+     * @deprecated rc.23 TASK-002 F3 — removed in rc.24. The L0/L1/L2 selection
+     * ceremony was fully retired in rc.5 A3 (see comment above
+     * `planContextOutputSchema`); downstream consumers should use
+     * `rules[].level` directly. Kept as optional for one rc to avoid breaking
+     * pre-rc.23 clients that destructure this field.
+     */
+    precedence: z.ZodOptional<z.ZodTuple<[z.ZodLiteral<"L2">, z.ZodLiteral<"L1">, z.ZodLiteral<"L0">], null>>;
     selected_stable_ids: z.ZodArray<z.ZodString, "many">;
     rules: z.ZodArray<z.ZodObject<{
         stable_id: z.ZodString;
         level: z.ZodEnum<["L0", "L1", "L2"]>;
         path: z.ZodString;
-        sections: z.ZodRecord<z.ZodString, z.ZodString>;
+        body: z.ZodString;
     }, "strip", z.ZodTypeAny, {
         path: string;
         stable_id: string;
         level: "L0" | "L1" | "L2";
-        sections: Record<string, string>;
+        body: string;
     }, {
         path: string;
         stable_id: string;
         level: "L0" | "L1" | "L2";
-        sections: Record<string, string>;
+        body: string;
     }>, "many">;
-    diagnostics: z.ZodArray<z.ZodDiscriminatedUnion<"code", [z.ZodObject<{
-        code: z.ZodLiteral<"missing_section">;
-        severity: z.ZodLiteral<"warn">;
-        stable_id: z.ZodString;
-        section: z.ZodEnum<["MISSION_STATEMENT", "MANDATORY_INJECTION", "BUSINESS_LOGIC_CHUNKS", "CONTEXT_INFO"]>;
-        message: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        code: "missing_section";
-        message: string;
-        stable_id: string;
-        severity: "warn";
-        section: "MISSION_STATEMENT" | "MANDATORY_INJECTION" | "BUSINESS_LOGIC_CHUNKS" | "CONTEXT_INFO";
-    }, {
-        code: "missing_section";
-        message: string;
-        stable_id: string;
-        severity: "warn";
-        section: "MISSION_STATEMENT" | "MANDATORY_INJECTION" | "BUSINESS_LOGIC_CHUNKS" | "CONTEXT_INFO";
-    }>, z.ZodObject<{
+    diagnostics: z.ZodArray<z.ZodObject<{
         code: z.ZodLiteral<"missing_knowledge_metadata">;
         severity: z.ZodLiteral<"warn">;
         stable_id: z.ZodString;
@@ -965,7 +773,7 @@ declare const knowledgeSectionsOutputSchema: z.ZodObject<{
         message: string;
         stable_id: string;
         severity: "warn";
-    }>]>, "many">;
+    }>, "many">;
     redirect_to: z.ZodOptional<z.ZodObject<{
         stable_id: z.ZodString;
     }, "strip", z.ZodTypeAny, {
@@ -991,63 +799,51 @@ declare const knowledgeSectionsOutputSchema: z.ZodObject<{
     }>, "many">>;
 }, "strip", z.ZodTypeAny, {
     revision_hash: string;
+    selected_stable_ids: string[];
     rules: {
         path: string;
         stable_id: string;
         level: "L0" | "L1" | "L2";
-        sections: Record<string, string>;
+        body: string;
     }[];
-    precedence: ["L2", "L1", "L0"];
-    selected_stable_ids: string[];
-    diagnostics: ({
-        code: "missing_section";
-        message: string;
-        stable_id: string;
-        severity: "warn";
-        section: "MISSION_STATEMENT" | "MANDATORY_INJECTION" | "BUSINESS_LOGIC_CHUNKS" | "CONTEXT_INFO";
-    } | {
+    diagnostics: {
         code: "missing_knowledge_metadata";
         message: string;
         stable_id: string;
         severity: "warn";
-    })[];
+    }[];
     warnings?: {
         file: string;
         code: string;
         action_hint: string;
         line?: number | undefined;
     }[] | undefined;
+    precedence?: ["L2", "L1", "L0"] | undefined;
     redirect_to?: {
         stable_id: string;
     } | undefined;
 }, {
     revision_hash: string;
+    selected_stable_ids: string[];
     rules: {
         path: string;
         stable_id: string;
         level: "L0" | "L1" | "L2";
-        sections: Record<string, string>;
+        body: string;
     }[];
-    precedence: ["L2", "L1", "L0"];
-    selected_stable_ids: string[];
-    diagnostics: ({
-        code: "missing_section";
-        message: string;
-        stable_id: string;
-        severity: "warn";
-        section: "MISSION_STATEMENT" | "MANDATORY_INJECTION" | "BUSINESS_LOGIC_CHUNKS" | "CONTEXT_INFO";
-    } | {
+    diagnostics: {
         code: "missing_knowledge_metadata";
         message: string;
         stable_id: string;
         severity: "warn";
-    })[];
+    }[];
     warnings?: {
         file: string;
         code: string;
         action_hint: string;
         line?: number | undefined;
     }[] | undefined;
+    precedence?: ["L2", "L1", "L0"] | undefined;
     redirect_to?: {
         stable_id: string;
     } | undefined;
@@ -1063,8 +859,7 @@ declare const ProposedReasonSchema: z.ZodEnum<["explicit-user-mark", "diagnostic
 type ProposedReason = z.infer<typeof ProposedReasonSchema>;
 declare const PROPOSED_REASON_DESCRIPTIONS: Record<ProposedReason, string>;
 declare const FabExtractKnowledgeInputSchema: z.ZodEffects<z.ZodObject<{
-    source_sessions: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], unknown>>;
-    source_session: z.ZodOptional<z.ZodString>;
+    source_sessions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     recent_paths: z.ZodArray<z.ZodString, "many">;
     user_messages_summary: z.ZodString;
     type: z.ZodEnum<["decisions", "pitfalls", "guidelines", "models", "processes"]>;
@@ -1074,6 +869,11 @@ declare const FabExtractKnowledgeInputSchema: z.ZodEffects<z.ZodObject<{
     session_context: z.ZodString;
     relevance_scope: z.ZodOptional<z.ZodEnum<["narrow", "broad"]>>;
     relevance_paths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    intent_clues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    tech_stack: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    impact: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    must_read_if: z.ZodOptional<z.ZodString>;
+    onboard_slot: z.ZodOptional<z.ZodEnum<["tech-stack-decision", "architecture-pattern", "code-style-tone", "build-system-idiom", "domain-vocabulary"]>>;
 }, "strip", z.ZodTypeAny, {
     proposed_reason: "explicit-user-mark" | "diagnostic-then-fix" | "decision-confirmation" | "wrong-turn-revert" | "new-dependency-or-pattern" | "dismissal-with-reason";
     session_context: string;
@@ -1085,7 +885,11 @@ declare const FabExtractKnowledgeInputSchema: z.ZodEffects<z.ZodObject<{
     relevance_paths?: string[] | undefined;
     source_sessions?: string[] | undefined;
     layer?: "personal" | "team" | undefined;
-    source_session?: string | undefined;
+    intent_clues?: string[] | undefined;
+    tech_stack?: string[] | undefined;
+    impact?: string[] | undefined;
+    must_read_if?: string | undefined;
+    onboard_slot?: "tech-stack-decision" | "architecture-pattern" | "code-style-tone" | "build-system-idiom" | "domain-vocabulary" | undefined;
 }, {
     proposed_reason: "explicit-user-mark" | "diagnostic-then-fix" | "decision-confirmation" | "wrong-turn-revert" | "new-dependency-or-pattern" | "dismissal-with-reason";
     session_context: string;
@@ -1095,9 +899,13 @@ declare const FabExtractKnowledgeInputSchema: z.ZodEffects<z.ZodObject<{
     slug: string;
     relevance_scope?: "narrow" | "broad" | undefined;
     relevance_paths?: string[] | undefined;
-    source_sessions?: unknown;
+    source_sessions?: string[] | undefined;
     layer?: "personal" | "team" | undefined;
-    source_session?: string | undefined;
+    intent_clues?: string[] | undefined;
+    tech_stack?: string[] | undefined;
+    impact?: string[] | undefined;
+    must_read_if?: string | undefined;
+    onboard_slot?: "tech-stack-decision" | "architecture-pattern" | "code-style-tone" | "build-system-idiom" | "domain-vocabulary" | undefined;
 }>, {
     proposed_reason: "explicit-user-mark" | "diagnostic-then-fix" | "decision-confirmation" | "wrong-turn-revert" | "new-dependency-or-pattern" | "dismissal-with-reason";
     session_context: string;
@@ -1109,7 +917,11 @@ declare const FabExtractKnowledgeInputSchema: z.ZodEffects<z.ZodObject<{
     relevance_paths?: string[] | undefined;
     source_sessions?: string[] | undefined;
     layer?: "personal" | "team" | undefined;
-    source_session?: string | undefined;
+    intent_clues?: string[] | undefined;
+    tech_stack?: string[] | undefined;
+    impact?: string[] | undefined;
+    must_read_if?: string | undefined;
+    onboard_slot?: "tech-stack-decision" | "architecture-pattern" | "code-style-tone" | "build-system-idiom" | "domain-vocabulary" | undefined;
 }, {
     proposed_reason: "explicit-user-mark" | "diagnostic-then-fix" | "decision-confirmation" | "wrong-turn-revert" | "new-dependency-or-pattern" | "dismissal-with-reason";
     session_context: string;
@@ -1119,13 +931,16 @@ declare const FabExtractKnowledgeInputSchema: z.ZodEffects<z.ZodObject<{
     slug: string;
     relevance_scope?: "narrow" | "broad" | undefined;
     relevance_paths?: string[] | undefined;
-    source_sessions?: unknown;
+    source_sessions?: string[] | undefined;
     layer?: "personal" | "team" | undefined;
-    source_session?: string | undefined;
+    intent_clues?: string[] | undefined;
+    tech_stack?: string[] | undefined;
+    impact?: string[] | undefined;
+    must_read_if?: string | undefined;
+    onboard_slot?: "tech-stack-decision" | "architecture-pattern" | "code-style-tone" | "build-system-idiom" | "domain-vocabulary" | undefined;
 }>;
 declare const FabExtractKnowledgeInputShape: {
-    source_sessions: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], unknown>>;
-    source_session: z.ZodOptional<z.ZodString>;
+    source_sessions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     recent_paths: z.ZodArray<z.ZodString, "many">;
     user_messages_summary: z.ZodString;
     type: z.ZodEnum<["decisions", "pitfalls", "guidelines", "models", "processes"]>;
@@ -1135,17 +950,50 @@ declare const FabExtractKnowledgeInputShape: {
     session_context: z.ZodString;
     relevance_scope: z.ZodOptional<z.ZodEnum<["narrow", "broad"]>>;
     relevance_paths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    intent_clues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    tech_stack: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    impact: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    must_read_if: z.ZodOptional<z.ZodString>;
+    onboard_slot: z.ZodOptional<z.ZodEnum<["tech-stack-decision", "architecture-pattern", "code-style-tone", "build-system-idiom", "domain-vocabulary"]>>;
 };
 type FabExtractKnowledgeInput = z.infer<typeof FabExtractKnowledgeInputSchema>;
 declare const FabExtractKnowledgeOutputSchema: z.ZodObject<{
     pending_path: z.ZodString;
     idempotency_key: z.ZodString;
+    warnings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        file: z.ZodString;
+        line: z.ZodOptional<z.ZodNumber>;
+        action_hint: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        file: string;
+        code: string;
+        action_hint: string;
+        line?: number | undefined;
+    }, {
+        file: string;
+        code: string;
+        action_hint: string;
+        line?: number | undefined;
+    }>, "many">>;
 }, "strip", z.ZodTypeAny, {
     pending_path: string;
     idempotency_key: string;
+    warnings?: {
+        file: string;
+        code: string;
+        action_hint: string;
+        line?: number | undefined;
+    }[] | undefined;
 }, {
     pending_path: string;
     idempotency_key: string;
+    warnings?: {
+        file: string;
+        code: string;
+        action_hint: string;
+        line?: number | undefined;
+    }[] | undefined;
 }>;
 type FabExtractKnowledgeOutput = z.infer<typeof FabExtractKnowledgeOutputSchema>;
 declare const fabExtractKnowledgeAnnotations: {
@@ -1408,6 +1256,22 @@ declare const FabReviewOutputSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObj
         title?: string | undefined;
         origin?: "personal" | "team" | undefined;
     }>, "many">;
+    warnings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        file: z.ZodString;
+        line: z.ZodOptional<z.ZodNumber>;
+        action_hint: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        file: string;
+        code: string;
+        action_hint: string;
+        line?: number | undefined;
+    }, {
+        file: string;
+        code: string;
+        action_hint: string;
+        line?: number | undefined;
+    }>, "many">>;
 }, "strip", z.ZodTypeAny, {
     action: "list";
     items: {
@@ -1420,6 +1284,12 @@ declare const FabReviewOutputSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObj
         title?: string | undefined;
         origin?: "personal" | "team" | undefined;
     }[];
+    warnings?: {
+        file: string;
+        code: string;
+        action_hint: string;
+        line?: number | undefined;
+    }[] | undefined;
 }, {
     action: "list";
     items: {
@@ -1432,6 +1302,12 @@ declare const FabReviewOutputSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObj
         title?: string | undefined;
         origin?: "personal" | "team" | undefined;
     }[];
+    warnings?: {
+        file: string;
+        code: string;
+        action_hint: string;
+        line?: number | undefined;
+    }[] | undefined;
 }>, z.ZodObject<{
     action: z.ZodLiteral<"approve">;
     approved: z.ZodArray<z.ZodObject<{
@@ -1444,40 +1320,124 @@ declare const FabReviewOutputSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObj
         pending_path: string;
         stable_id: string;
     }>, "many">;
+    warnings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        file: z.ZodString;
+        line: z.ZodOptional<z.ZodNumber>;
+        action_hint: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        file: string;
+        code: string;
+        action_hint: string;
+        line?: number | undefined;
+    }, {
+        file: string;
+        code: string;
+        action_hint: string;
+        line?: number | undefined;
+    }>, "many">>;
 }, "strip", z.ZodTypeAny, {
     approved: {
         pending_path: string;
         stable_id: string;
     }[];
     action: "approve";
+    warnings?: {
+        file: string;
+        code: string;
+        action_hint: string;
+        line?: number | undefined;
+    }[] | undefined;
 }, {
     approved: {
         pending_path: string;
         stable_id: string;
     }[];
     action: "approve";
+    warnings?: {
+        file: string;
+        code: string;
+        action_hint: string;
+        line?: number | undefined;
+    }[] | undefined;
 }>, z.ZodObject<{
     action: z.ZodLiteral<"reject">;
     rejected: z.ZodArray<z.ZodString, "many">;
+    warnings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        file: z.ZodString;
+        line: z.ZodOptional<z.ZodNumber>;
+        action_hint: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        file: string;
+        code: string;
+        action_hint: string;
+        line?: number | undefined;
+    }, {
+        file: string;
+        code: string;
+        action_hint: string;
+        line?: number | undefined;
+    }>, "many">>;
 }, "strip", z.ZodTypeAny, {
     action: "reject";
     rejected: string[];
+    warnings?: {
+        file: string;
+        code: string;
+        action_hint: string;
+        line?: number | undefined;
+    }[] | undefined;
 }, {
     action: "reject";
     rejected: string[];
+    warnings?: {
+        file: string;
+        code: string;
+        action_hint: string;
+        line?: number | undefined;
+    }[] | undefined;
 }>, z.ZodObject<{
     action: z.ZodLiteral<"modify">;
     pending_path: z.ZodString;
     prior_stable_id: z.ZodOptional<z.ZodString>;
     new_stable_id: z.ZodOptional<z.ZodString>;
+    warnings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        file: z.ZodString;
+        line: z.ZodOptional<z.ZodNumber>;
+        action_hint: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        file: string;
+        code: string;
+        action_hint: string;
+        line?: number | undefined;
+    }, {
+        file: string;
+        code: string;
+        action_hint: string;
+        line?: number | undefined;
+    }>, "many">>;
 }, "strip", z.ZodTypeAny, {
     pending_path: string;
     action: "modify";
+    warnings?: {
+        file: string;
+        code: string;
+        action_hint: string;
+        line?: number | undefined;
+    }[] | undefined;
     prior_stable_id?: string | undefined;
     new_stable_id?: string | undefined;
 }, {
     pending_path: string;
     action: "modify";
+    warnings?: {
+        file: string;
+        code: string;
+        action_hint: string;
+        line?: number | undefined;
+    }[] | undefined;
     prior_stable_id?: string | undefined;
     new_stable_id?: string | undefined;
 }>, z.ZodObject<{
@@ -1510,6 +1470,22 @@ declare const FabReviewOutputSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObj
         title?: string | undefined;
         origin?: "personal" | "team" | undefined;
     }>, "many">;
+    warnings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        file: z.ZodString;
+        line: z.ZodOptional<z.ZodNumber>;
+        action_hint: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        file: string;
+        code: string;
+        action_hint: string;
+        line?: number | undefined;
+    }, {
+        file: string;
+        code: string;
+        action_hint: string;
+        line?: number | undefined;
+    }>, "many">>;
 }, "strip", z.ZodTypeAny, {
     action: "search";
     items: {
@@ -1522,6 +1498,12 @@ declare const FabReviewOutputSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObj
         title?: string | undefined;
         origin?: "personal" | "team" | undefined;
     }[];
+    warnings?: {
+        file: string;
+        code: string;
+        action_hint: string;
+        line?: number | undefined;
+    }[] | undefined;
 }, {
     action: "search";
     items: {
@@ -1534,15 +1516,49 @@ declare const FabReviewOutputSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObj
         title?: string | undefined;
         origin?: "personal" | "team" | undefined;
     }[];
+    warnings?: {
+        file: string;
+        code: string;
+        action_hint: string;
+        line?: number | undefined;
+    }[] | undefined;
 }>, z.ZodObject<{
     action: z.ZodLiteral<"defer">;
     deferred: z.ZodArray<z.ZodString, "many">;
+    warnings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        file: z.ZodString;
+        line: z.ZodOptional<z.ZodNumber>;
+        action_hint: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        file: string;
+        code: string;
+        action_hint: string;
+        line?: number | undefined;
+    }, {
+        file: string;
+        code: string;
+        action_hint: string;
+        line?: number | undefined;
+    }>, "many">>;
 }, "strip", z.ZodTypeAny, {
     action: "defer";
     deferred: string[];
+    warnings?: {
+        file: string;
+        code: string;
+        action_hint: string;
+        line?: number | undefined;
+    }[] | undefined;
 }, {
     action: "defer";
     deferred: string[];
+    warnings?: {
+        file: string;
+        code: string;
+        action_hint: string;
+        line?: number | undefined;
+    }[] | undefined;
 }>]>;
 type FabReviewOutput = z.infer<typeof FabReviewOutputSchema>;
 declare const FabReviewOutputShape: {
@@ -1590,6 +1606,22 @@ declare const FabReviewOutputShape: {
     readonly prior_stable_id: z.ZodOptional<z.ZodString>;
     readonly new_stable_id: z.ZodOptional<z.ZodString>;
     readonly deferred: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    readonly warnings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        file: z.ZodString;
+        line: z.ZodOptional<z.ZodNumber>;
+        action_hint: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        file: string;
+        code: string;
+        action_hint: string;
+        line?: number | undefined;
+    }, {
+        file: string;
+        code: string;
+        action_hint: string;
+        line?: number | undefined;
+    }>, "many">>;
 };
 declare const fabReviewAnnotations: {
     readonly readOnlyHint: false;
@@ -1598,6 +1630,208 @@ declare const fabReviewAnnotations: {
     readonly openWorldHint: false;
     readonly title: "Review pending knowledge entries";
 };
+declare const citeContractMetricsSchema: z.ZodObject<{
+    decisions_cited: z.ZodNumber;
+    pitfalls_cited: z.ZodNumber;
+    contract_with: z.ZodNumber;
+    contract_missing: z.ZodNumber;
+    hard_violated: z.ZodNumber;
+    cite_id_unresolved: z.ZodNumber;
+    skip_count: z.ZodRecord<z.ZodString, z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    decisions_cited: number;
+    pitfalls_cited: number;
+    contract_with: number;
+    contract_missing: number;
+    hard_violated: number;
+    cite_id_unresolved: number;
+    skip_count: Record<string, number>;
+}, {
+    decisions_cited: number;
+    pitfalls_cited: number;
+    contract_with: number;
+    contract_missing: number;
+    hard_violated: number;
+    cite_id_unresolved: number;
+    skip_count: Record<string, number>;
+}>;
+type CiteContractMetrics = z.infer<typeof citeContractMetricsSchema>;
+declare const citeLayerTypeBreakdownSchema: z.ZodObject<{
+    team: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    personal: z.ZodRecord<z.ZodString, z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    personal: Record<string, number>;
+    team: Record<string, number>;
+}, {
+    personal: Record<string, number>;
+    team: Record<string, number>;
+}>;
+type CiteLayerTypeBreakdown = z.infer<typeof citeLayerTypeBreakdownSchema>;
+declare const citeCoverageReportSchema: z.ZodObject<{
+    status: z.ZodEnum<["ok", "skipped"]>;
+    marker_ts: z.ZodNumber;
+    marker_emitted_now: z.ZodBoolean;
+    since_ts: z.ZodNumber;
+    client_filter: z.ZodEnum<["cc", "codex", "cursor", "all"]>;
+    layer_filter: z.ZodOptional<z.ZodEnum<["team", "personal", "all"]>>;
+    metrics: z.ZodObject<{
+        edits_touched: z.ZodNumber;
+        qualifying_cites: z.ZodNumber;
+        recalled_unverified: z.ZodNumber;
+        expected_but_missed: z.ZodNumber;
+        total_turns: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        edits_touched: number;
+        qualifying_cites: number;
+        recalled_unverified: number;
+        expected_but_missed: number;
+        total_turns: number;
+    }, {
+        edits_touched: number;
+        qualifying_cites: number;
+        recalled_unverified: number;
+        expected_but_missed: number;
+        total_turns: number;
+    }>;
+    per_client: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        edits_touched: z.ZodOptional<z.ZodNumber>;
+        qualifying_cites: z.ZodOptional<z.ZodNumber>;
+        recalled_unverified: z.ZodOptional<z.ZodNumber>;
+        expected_but_missed: z.ZodOptional<z.ZodNumber>;
+        total_turns: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        edits_touched?: number | undefined;
+        qualifying_cites?: number | undefined;
+        recalled_unverified?: number | undefined;
+        expected_but_missed?: number | undefined;
+        total_turns?: number | undefined;
+    }, {
+        edits_touched?: number | undefined;
+        qualifying_cites?: number | undefined;
+        recalled_unverified?: number | undefined;
+        expected_but_missed?: number | undefined;
+        total_turns?: number | undefined;
+    }>>>;
+    dismissed_reason_histogram: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+    none_reason_histogram: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+    contract_metrics_status: z.ZodOptional<z.ZodEnum<["ok", "skipped:bootstrap_drift", "awaiting_marker"]>>;
+    contract_metrics: z.ZodOptional<z.ZodObject<{
+        decisions_cited: z.ZodNumber;
+        pitfalls_cited: z.ZodNumber;
+        contract_with: z.ZodNumber;
+        contract_missing: z.ZodNumber;
+        hard_violated: z.ZodNumber;
+        cite_id_unresolved: z.ZodNumber;
+        skip_count: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        decisions_cited: number;
+        pitfalls_cited: number;
+        contract_with: number;
+        contract_missing: number;
+        hard_violated: number;
+        cite_id_unresolved: number;
+        skip_count: Record<string, number>;
+    }, {
+        decisions_cited: number;
+        pitfalls_cited: number;
+        contract_with: number;
+        contract_missing: number;
+        hard_violated: number;
+        cite_id_unresolved: number;
+        skip_count: Record<string, number>;
+    }>>;
+    per_layer_type: z.ZodOptional<z.ZodObject<{
+        team: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        personal: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        personal: Record<string, number>;
+        team: Record<string, number>;
+    }, {
+        personal: Record<string, number>;
+        team: Record<string, number>;
+    }>>;
+    contract_marker_ts: z.ZodOptional<z.ZodNumber>;
+    generated_at: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    status: "ok" | "skipped";
+    marker_ts: number;
+    marker_emitted_now: boolean;
+    since_ts: number;
+    client_filter: "all" | "cc" | "codex" | "cursor";
+    metrics: {
+        edits_touched: number;
+        qualifying_cites: number;
+        recalled_unverified: number;
+        expected_but_missed: number;
+        total_turns: number;
+    };
+    generated_at: string;
+    layer_filter?: "personal" | "team" | "all" | undefined;
+    per_client?: Record<string, {
+        edits_touched?: number | undefined;
+        qualifying_cites?: number | undefined;
+        recalled_unverified?: number | undefined;
+        expected_but_missed?: number | undefined;
+        total_turns?: number | undefined;
+    }> | undefined;
+    dismissed_reason_histogram?: Record<string, number> | undefined;
+    none_reason_histogram?: Record<string, number> | undefined;
+    contract_metrics_status?: "ok" | "skipped:bootstrap_drift" | "awaiting_marker" | undefined;
+    contract_metrics?: {
+        decisions_cited: number;
+        pitfalls_cited: number;
+        contract_with: number;
+        contract_missing: number;
+        hard_violated: number;
+        cite_id_unresolved: number;
+        skip_count: Record<string, number>;
+    } | undefined;
+    per_layer_type?: {
+        personal: Record<string, number>;
+        team: Record<string, number>;
+    } | undefined;
+    contract_marker_ts?: number | undefined;
+}, {
+    status: "ok" | "skipped";
+    marker_ts: number;
+    marker_emitted_now: boolean;
+    since_ts: number;
+    client_filter: "all" | "cc" | "codex" | "cursor";
+    metrics: {
+        edits_touched: number;
+        qualifying_cites: number;
+        recalled_unverified: number;
+        expected_but_missed: number;
+        total_turns: number;
+    };
+    generated_at: string;
+    layer_filter?: "personal" | "team" | "all" | undefined;
+    per_client?: Record<string, {
+        edits_touched?: number | undefined;
+        qualifying_cites?: number | undefined;
+        recalled_unverified?: number | undefined;
+        expected_but_missed?: number | undefined;
+        total_turns?: number | undefined;
+    }> | undefined;
+    dismissed_reason_histogram?: Record<string, number> | undefined;
+    none_reason_histogram?: Record<string, number> | undefined;
+    contract_metrics_status?: "ok" | "skipped:bootstrap_drift" | "awaiting_marker" | undefined;
+    contract_metrics?: {
+        decisions_cited: number;
+        pitfalls_cited: number;
+        contract_with: number;
+        contract_missing: number;
+        hard_violated: number;
+        cite_id_unresolved: number;
+        skip_count: Record<string, number>;
+    } | undefined;
+    per_layer_type?: {
+        personal: Record<string, number>;
+        team: Record<string, number>;
+    } | undefined;
+    contract_marker_ts?: number | undefined;
+}>;
+type CiteCoverageReport = z.infer<typeof citeCoverageReportSchema>;
 declare const ledgerSourceSchema: z.ZodEnum<["ai", "human"]>;
 declare const ledgerQuerySchema: z.ZodObject<{
     source: z.ZodOptional<z.ZodEnum<["ai", "human"]>>;
@@ -1704,4 +1938,4 @@ declare function parseKnowledgeId(id: string): {
     counter: number;
 } | null;
 
-export { type FabExtractKnowledgeInput, FabExtractKnowledgeInputSchema, FabExtractKnowledgeInputShape, type FabExtractKnowledgeOutput, FabExtractKnowledgeOutputSchema, type FabReviewInput, FabReviewInputSchema, FabReviewInputShape, type FabReviewOutput, FabReviewOutputSchema, FabReviewOutputShape, KNOWLEDGE_TYPE_CODES, type KnowledgeEntryFrontmatter, KnowledgeEntryFrontmatterSchema, type KnowledgeType, type KnowledgeTypeCode, KnowledgeTypeSchema, type Layer, LayerSchema, type Maturity, MaturitySchema, PROPOSED_REASON_DESCRIPTIONS, type ProposedReason, ProposedReasonSchema, type StableId, StableIdSchema, annotateIntentRequestSchema, fabExtractKnowledgeAnnotations, fabReviewAnnotations, formatKnowledgeId, getKnowledgeAnnotations, getKnowledgeInputSchema, getKnowledgeOutputSchema, historyStateQuerySchema, humanLockApproveRequestSchema, humanLockFileParamsSchema, knowledgeSectionsAnnotations, knowledgeSectionsInputSchema, knowledgeSectionsOutputSchema, ledgerQuerySchema, ledgerSourceSchema, parseKnowledgeId, planContextAnnotations, planContextHintNarrowEntrySchema, planContextHintOutputSchema, planContextInputSchema, planContextOutputSchema, structuredWarningSchema };
+export { type CiteContractMetrics, type CiteCoverageReport, type CiteLayerTypeBreakdown, type FabExtractKnowledgeInput, FabExtractKnowledgeInputSchema, FabExtractKnowledgeInputShape, type FabExtractKnowledgeOutput, FabExtractKnowledgeOutputSchema, type FabReviewInput, FabReviewInputSchema, FabReviewInputShape, type FabReviewOutput, FabReviewOutputSchema, FabReviewOutputShape, KNOWLEDGE_TYPE_CODES, type KnowledgeEntryFrontmatter, KnowledgeEntryFrontmatterSchema, type KnowledgeType, type KnowledgeTypeCode, KnowledgeTypeSchema, type Layer, LayerSchema, type Maturity, MaturitySchema, PROPOSED_REASON_DESCRIPTIONS, type ProposedReason, ProposedReasonSchema, type StableId, StableIdSchema, annotateIntentRequestSchema, citeContractMetricsSchema, citeCoverageReportSchema, citeLayerTypeBreakdownSchema, fabExtractKnowledgeAnnotations, fabReviewAnnotations, formatKnowledgeId, historyStateQuerySchema, humanLockApproveRequestSchema, humanLockFileParamsSchema, knowledgeSectionsAnnotations, knowledgeSectionsInputSchema, knowledgeSectionsOutputSchema, ledgerQuerySchema, ledgerSourceSchema, parseKnowledgeId, planContextAnnotations, planContextHintNarrowEntrySchema, planContextHintOutputSchema, planContextInputSchema, planContextOutputSchema, structuredWarningSchema };