@mcptoolshop/research-os 0.3.0 → 0.3.2

package/dist/index.d.ts

@@ -136,18 +136,62 @@ declare const GateConfigSchema: z.ZodObject<{
         extension_requires_evidence?: boolean | undefined;
     } | undefined;
 }>;
+declare const SectionScopedWaiverSchema: z.ZodObject<{
+    section_id: z.ZodString;
+    scope: z.ZodEnum<["min_independent_publishers", "primary_sources_required"]>;
+    reason: z.ZodString;
+    compensating_controls: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    section_id: string;
+    scope: "primary_sources_required" | "min_independent_publishers";
+    reason: string;
+    compensating_controls: string[];
+}, {
+    section_id: string;
+    scope: "primary_sources_required" | "min_independent_publishers";
+    reason: string;
+    compensating_controls: string[];
+}>;
 declare const PrimarySourceWaiverSchema: z.ZodObject<{
     status: z.ZodDefault<z.ZodEnum<["none", "requested", "granted"]>>;
     reason: z.ZodOptional<z.ZodString>;
     compensating_controls: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    section_waivers: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        section_id: z.ZodString;
+        scope: z.ZodEnum<["min_independent_publishers", "primary_sources_required"]>;
+        reason: z.ZodString;
+        compensating_controls: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        section_id: string;
+        scope: "primary_sources_required" | "min_independent_publishers";
+        reason: string;
+        compensating_controls: string[];
+    }, {
+        section_id: string;
+        scope: "primary_sources_required" | "min_independent_publishers";
+        reason: string;
+        compensating_controls: string[];
+    }>, "many">>;
 }, "strip", z.ZodTypeAny, {
     status: "none" | "requested" | "granted";
     compensating_controls: string[];
+    section_waivers: {
+        section_id: string;
+        scope: "primary_sources_required" | "min_independent_publishers";
+        reason: string;
+        compensating_controls: string[];
+    }[];
     reason?: string | undefined;
 }, {
     status?: "none" | "requested" | "granted" | undefined;
     reason?: string | undefined;
     compensating_controls?: string[] | undefined;
+    section_waivers?: {
+        section_id: string;
+        scope: "primary_sources_required" | "min_independent_publishers";
+        reason: string;
+        compensating_controls: string[];
+    }[] | undefined;
 }>;
 declare const ResearchYamlSchema: z.ZodObject<{
     research_os_version: z.ZodString;
@@ -172,14 +216,42 @@ declare const ResearchYamlSchema: z.ZodObject<{
         status: z.ZodDefault<z.ZodEnum<["none", "requested", "granted"]>>;
         reason: z.ZodOptional<z.ZodString>;
         compensating_controls: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        section_waivers: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            section_id: z.ZodString;
+            scope: z.ZodEnum<["min_independent_publishers", "primary_sources_required"]>;
+            reason: z.ZodString;
+            compensating_controls: z.ZodArray<z.ZodString, "many">;
+        }, "strip", z.ZodTypeAny, {
+            section_id: string;
+            scope: "primary_sources_required" | "min_independent_publishers";
+            reason: string;
+            compensating_controls: string[];
+        }, {
+            section_id: string;
+            scope: "primary_sources_required" | "min_independent_publishers";
+            reason: string;
+            compensating_controls: string[];
+        }>, "many">>;
     }, "strip", z.ZodTypeAny, {
         status: "none" | "requested" | "granted";
         compensating_controls: string[];
+        section_waivers: {
+            section_id: string;
+            scope: "primary_sources_required" | "min_independent_publishers";
+            reason: string;
+            compensating_controls: string[];
+        }[];
         reason?: string | undefined;
     }, {
         status?: "none" | "requested" | "granted" | undefined;
         reason?: string | undefined;
         compensating_controls?: string[] | undefined;
+        section_waivers?: {
+            section_id: string;
+            scope: "primary_sources_required" | "min_independent_publishers";
+            reason: string;
+            compensating_controls: string[];
+        }[] | undefined;
     }>>;
     sections: z.ZodDefault<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
@@ -354,6 +426,12 @@ declare const ResearchYamlSchema: z.ZodObject<{
     primary_source_waiver: {
         status: "none" | "requested" | "granted";
         compensating_controls: string[];
+        section_waivers: {
+            section_id: string;
+            scope: "primary_sources_required" | "min_independent_publishers";
+            reason: string;
+            compensating_controls: string[];
+        }[];
         reason?: string | undefined;
     };
     sections: {
@@ -416,6 +494,12 @@ declare const ResearchYamlSchema: z.ZodObject<{
         status?: "none" | "requested" | "granted" | undefined;
         reason?: string | undefined;
         compensating_controls?: string[] | undefined;
+        section_waivers?: {
+            section_id: string;
+            scope: "primary_sources_required" | "min_independent_publishers";
+            reason: string;
+            compensating_controls: string[];
+        }[] | undefined;
     } | undefined;
     sections?: {
         id: string;
@@ -464,6 +548,7 @@ declare const ResearchYamlSchema: z.ZodObject<{
 type Section = z.infer<typeof SectionSchema>;
 type GateConfig = z.infer<typeof GateConfigSchema>;
 type PrimarySourceWaiver = z.infer<typeof PrimarySourceWaiverSchema>;
+type SectionScopedWaiver = z.infer<typeof SectionScopedWaiverSchema>;
 type ResearchYaml = z.infer<typeof ResearchYamlSchema>;
 
 interface InitOptions {
@@ -519,8 +604,8 @@ declare const SectionGatesYamlSchema: z.ZodObject<{
     primary_sources_required: number;
     contradictions_required: boolean;
     status: "draft" | "gathering" | "gated" | "reviewed" | "frozen";
-    created_at: string;
     section_id: string;
+    created_at: string;
 }, {
     purpose: string;
     max_time_minutes: number;
@@ -528,8 +613,8 @@ declare const SectionGatesYamlSchema: z.ZodObject<{
     primary_sources_required: number;
     contradictions_required: boolean;
     status: "draft" | "gathering" | "gated" | "reviewed" | "frozen";
-    created_at: string;
     section_id: string;
+    created_at: string;
 }>;
 type SectionGatesYaml = z.infer<typeof SectionGatesYamlSchema>;
 
@@ -668,6 +753,7 @@ declare const SourceCardSchema: z.ZodObject<{
     extracted_at: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     section_id: string;
+    scope: string | null;
     receipt_id: string;
     source_id: string;
     final_url: string | null;
@@ -676,17 +762,17 @@ declare const SourceCardSchema: z.ZodObject<{
     url: string;
     publisher: string | null;
     published_at: string | null;
-    source_type: "primary" | "secondary" | "forum" | "benchmark" | "docs" | "unknown";
+    source_type: "unknown" | "primary" | "secondary" | "forum" | "benchmark" | "docs";
     relevance: "unknown" | "high" | "medium" | "low";
     key_points: string[];
     limitations: string[];
     asserts: string;
-    scope: string | null;
     not: string | null;
     extracted_by: "heuristic" | "ollama-intern";
     extracted_at: string;
 }, {
     section_id: string;
+    scope: string | null;
     receipt_id: string;
     source_id: string;
     final_url: string | null;
@@ -695,12 +781,11 @@ declare const SourceCardSchema: z.ZodObject<{
     url: string;
     publisher: string | null;
     published_at: string | null;
-    source_type: "primary" | "secondary" | "forum" | "benchmark" | "docs" | "unknown";
+    source_type: "unknown" | "primary" | "secondary" | "forum" | "benchmark" | "docs";
     relevance: "unknown" | "high" | "medium" | "low";
     key_points: string[];
     limitations: string[];
     asserts: string;
-    scope: string | null;
     not: string | null;
     extracted_by: "heuristic" | "ollama-intern";
     extracted_at: string;
@@ -1035,8 +1120,8 @@ declare const ClaimDensityAuditSchema: z.ZodObject<{
         affects_claim_ids?: string[] | undefined;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
-    research_os_version: string;
     section_id: string;
+    research_os_version: string;
     claims_per_1k_words: number;
     weak_scope_count: number;
     generic_scope_count: number;
@@ -1068,8 +1153,8 @@ declare const ClaimDensityAuditSchema: z.ZodObject<{
         affects_claim_ids: string[];
     }[];
 }, {
-    research_os_version: string;
     section_id: string;
+    research_os_version: string;
     claims_per_1k_words: number;
     weak_scope_count: number;
     generic_scope_count: number;
@@ -1167,10 +1252,10 @@ declare const ClaimSchema: z.ZodObject<{
     created_at: z.ZodString;
     review_state: z.ZodEnum<["candidate", "gated", "reviewed", "rejected", "accepted"]>;
 }, "strip", z.ZodTypeAny, {
-    created_at: string;
     section_id: string;
-    asserts: string;
     scope: string | null;
+    created_at: string;
+    asserts: string;
     not: string | null;
     evidence_excerpt_ids: string[];
     evidence_location: string | null;
@@ -1183,10 +1268,10 @@ declare const ClaimSchema: z.ZodObject<{
     extraction_method: string;
     review_state: "gated" | "reviewed" | "candidate" | "rejected" | "accepted";
 }, {
-    created_at: string;
     section_id: string;
-    asserts: string;
     scope: string | null;
+    created_at: string;
+    asserts: string;
     not: string | null;
     evidence_location: string | null;
     confidence: "high" | "medium" | "low";
@@ -1358,9 +1443,9 @@ declare const ContradictionSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     status: "rejected" | "unresolved" | "reconciled" | "preserved_deliberately";
     type: "direct_conflict" | "scope_conflict" | "temporal_conflict" | "definition_conflict" | "evidence_conflict" | "overgeneralization_risk";
+    section_id: string;
     created_at: string;
     evidence: string;
-    section_id: string;
     confidence: "high" | "medium" | "low";
     source_ids: string[];
     claim_ids: string[];
@@ -1374,9 +1459,9 @@ declare const ContradictionSchema: z.ZodObject<{
 }, {
     status: "rejected" | "unresolved" | "reconciled" | "preserved_deliberately";
     type: "direct_conflict" | "scope_conflict" | "temporal_conflict" | "definition_conflict" | "evidence_conflict" | "overgeneralization_risk";
+    section_id: string;
     created_at: string;
     evidence: string;
-    section_id: string;
     confidence: "high" | "medium" | "low";
     source_ids: string[];
     claim_ids: string[];
@@ -1423,9 +1508,9 @@ declare const ReviewFindingSchema: z.ZodObject<{
     confidence: z.ZodEnum<["low", "medium", "high"]>;
     created_at: z.ZodString;
 }, "strip", z.ZodTypeAny, {
+    section_id: string;
     created_at: string;
     evidence: string;
-    section_id: string;
     confidence: "high" | "medium" | "low";
     source_ids: string[];
     claim_ids: string[];
@@ -1437,9 +1522,9 @@ declare const ReviewFindingSchema: z.ZodObject<{
     reviewer: "heuristic" | "ollama-intern";
     review_method: string;
 }, {
+    section_id: string;
     created_at: string;
     evidence: string;
-    section_id: string;
     confidence: "high" | "medium" | "low";
     source_ids: string[];
     claim_ids: string[];
@@ -1497,9 +1582,9 @@ declare const ReviewSnapshotSchema: z.ZodObject<{
         confidence: z.ZodEnum<["low", "medium", "high"]>;
         created_at: z.ZodString;
     }, "strip", z.ZodTypeAny, {
+        section_id: string;
         created_at: string;
         evidence: string;
-        section_id: string;
         confidence: "high" | "medium" | "low";
         source_ids: string[];
         claim_ids: string[];
@@ -1511,9 +1596,9 @@ declare const ReviewSnapshotSchema: z.ZodObject<{
         reviewer: "heuristic" | "ollama-intern";
         review_method: string;
     }, {
+        section_id: string;
         created_at: string;
         evidence: string;
-        section_id: string;
         confidence: "high" | "medium" | "low";
         source_ids: string[];
         claim_ids: string[];
@@ -1561,9 +1646,9 @@ declare const ReviewSnapshotSchema: z.ZodObject<{
     review_method: string;
     reviewed_at: string;
     findings: {
+        section_id: string;
         created_at: string;
         evidence: string;
-        section_id: string;
         confidence: "high" | "medium" | "low";
         source_ids: string[];
         claim_ids: string[];
@@ -1595,9 +1680,9 @@ declare const ReviewSnapshotSchema: z.ZodObject<{
     review_method: string;
     reviewed_at: string;
     findings: {
+        section_id: string;
         created_at: string;
         evidence: string;
-        section_id: string;
         confidence: "high" | "medium" | "low";
         source_ids: string[];
         claim_ids: string[];
@@ -1926,22 +2011,22 @@ declare const SectionGateResultSchema: z.ZodObject<{
         independent_publishers: z.ZodNumber;
         failed_fetches: z.ZodNumber;
     }, "strip", z.ZodTypeAny, {
+        unknown: number;
         primary: number;
         secondary: number;
         forum: number;
         benchmark: number;
         docs: number;
-        unknown: number;
         total: number;
         independent_publishers: number;
         failed_fetches: number;
     }, {
+        unknown: number;
         primary: number;
         secondary: number;
         forum: number;
         benchmark: number;
         docs: number;
-        unknown: number;
         total: number;
         independent_publishers: number;
         failed_fetches: number;
@@ -2051,12 +2136,12 @@ declare const SectionGateResultSchema: z.ZodObject<{
         orphans: number;
     };
     source_counts: {
+        unknown: number;
         primary: number;
         secondary: number;
         forum: number;
         benchmark: number;
         docs: number;
-        unknown: number;
         total: number;
         independent_publishers: number;
         failed_fetches: number;
@@ -2132,12 +2217,12 @@ declare const SectionGateResultSchema: z.ZodObject<{
         orphans: number;
     };
     source_counts: {
+        unknown: number;
         primary: number;
         secondary: number;
         forum: number;
         benchmark: number;
         docs: number;
-        unknown: number;
         total: number;
         independent_publishers: number;
         failed_fetches: number;
@@ -2377,6 +2462,7 @@ declare function deriveClaimReviews(args: {
     findings: ReviewFinding[];
     reviewer: ReviewerName;
     reviewMethod: string;
+    activeSectionWaivers?: SectionScopedWaiver[];
 }): ClaimReview[];
 
 declare function renderReviewMarkdown(snapshot: ReviewSnapshot): string;
@@ -2567,18 +2653,18 @@ declare const ClaimSynthesisDispositionSchema: z.ZodObject<{
     created_at: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     status: "parked_not_for_synthesis" | "preserved_for_human_note" | "needs_human_review_excluded" | "out_of_bounds_regression_fixture";
+    section_id: string;
     reason: string;
     created_at: string;
-    section_id: string;
     claim_id: string;
     source: string;
     decided_by: string;
     authorized_by: string;
 }, {
     status: "parked_not_for_synthesis" | "preserved_for_human_note" | "needs_human_review_excluded" | "out_of_bounds_regression_fixture";
+    section_id: string;
     reason: string;
     created_at: string;
-    section_id: string;
     claim_id: string;
     source: string;
     decided_by: string;
@@ -2759,15 +2845,15 @@ declare const WaiverEntrySchema: z.ZodObject<{
     compensating_controls: z.ZodArray<z.ZodString, "many">;
     applied_to: z.ZodString;
 }, "strip", z.ZodTypeAny, {
+    scope: "pack" | "gate";
     reason: string;
     compensating_controls: string[];
-    scope: "pack" | "gate";
     family: string;
     applied_to: string;
 }, {
+    scope: "pack" | "gate";
     reason: string;
     compensating_controls: string[];
-    scope: "pack" | "gate";
     family: string;
     applied_to: string;
 }>;
@@ -2789,12 +2875,12 @@ declare const ReviewDecisionCountSchema: z.ZodObject<{
     decision: z.ZodString;
     count: z.ZodNumber;
 }, "strip", z.ZodTypeAny, {
-    decision: string;
     section_id: string;
+    decision: string;
     count: number;
 }, {
-    decision: string;
     section_id: string;
+    decision: string;
     count: number;
 }>;
 declare const CoworkHandoffPayloadSchema: z.ZodObject<{
@@ -2961,15 +3047,15 @@ declare const CoworkHandoffPayloadSchema: z.ZodObject<{
         compensating_controls: z.ZodArray<z.ZodString, "many">;
         applied_to: z.ZodString;
     }, "strip", z.ZodTypeAny, {
+        scope: "pack" | "gate";
         reason: string;
         compensating_controls: string[];
-        scope: "pack" | "gate";
         family: string;
         applied_to: string;
     }, {
+        scope: "pack" | "gate";
         reason: string;
         compensating_controls: string[];
-        scope: "pack" | "gate";
         family: string;
         applied_to: string;
     }>, "many">;
@@ -2991,12 +3077,12 @@ declare const CoworkHandoffPayloadSchema: z.ZodObject<{
         decision: z.ZodString;
         count: z.ZodNumber;
     }, "strip", z.ZodTypeAny, {
-        decision: string;
         section_id: string;
+        decision: string;
         count: number;
     }, {
-        decision: string;
         section_id: string;
+        decision: string;
         count: number;
     }>, "many">;
     recommended_next_actions: z.ZodArray<z.ZodString, "many">;
@@ -3043,9 +3129,9 @@ declare const CoworkHandoffPayloadSchema: z.ZodObject<{
     }[];
     summary: string;
     waivers: {
+        scope: "pack" | "gate";
         reason: string;
         compensating_controls: string[];
-        scope: "pack" | "gate";
         family: string;
         applied_to: string;
     }[];
@@ -3065,8 +3151,8 @@ declare const CoworkHandoffPayloadSchema: z.ZodObject<{
     synthesis_allowed: boolean;
     blocked_claim_ids: string[];
     review_decisions: {
-        decision: string;
         section_id: string;
+        decision: string;
         count: number;
     }[];
     recommended_next_actions: string[];
@@ -3112,9 +3198,9 @@ declare const CoworkHandoffPayloadSchema: z.ZodObject<{
     }[];
     summary: string;
     waivers: {
+        scope: "pack" | "gate";
         reason: string;
         compensating_controls: string[];
-        scope: "pack" | "gate";
         family: string;
         applied_to: string;
     }[];
@@ -3133,8 +3219,8 @@ declare const CoworkHandoffPayloadSchema: z.ZodObject<{
     synthesis_allowed: boolean;
     blocked_claim_ids: string[];
     review_decisions: {
-        decision: string;
         section_id: string;
+        decision: string;
         count: number;
     }[];
     recommended_next_actions: string[];
@@ -3363,16 +3449,16 @@ declare const WaiverDependencySchema: z.ZodObject<{
     applied_to: z.ZodString;
     must_disclose_in: z.ZodEnum<["decision-brief.md", "final-report.md", "both"]>;
 }, "strip", z.ZodTypeAny, {
+    scope: "pack" | "gate";
     reason: string;
     compensating_controls: string[];
-    scope: "pack" | "gate";
     family: string;
     applied_to: string;
     must_disclose_in: "decision-brief.md" | "final-report.md" | "both";
 }, {
+    scope: "pack" | "gate";
     reason: string;
     compensating_controls: string[];
-    scope: "pack" | "gate";
     family: string;
     applied_to: string;
     must_disclose_in: "decision-brief.md" | "final-report.md" | "both";
@@ -3387,16 +3473,16 @@ declare const AllowedSynthesisInputSchema: z.ZodObject<{
     source_ids: z.ZodArray<z.ZodString, "many">;
 }, "strip", z.ZodTypeAny, {
     section_id: string;
-    asserts: string;
     scope: string | null;
+    asserts: string;
     not: string | null;
     claim_id: string;
     source_ids: string[];
     artifact_path: string;
 }, {
     section_id: string;
-    asserts: string;
     scope: string | null;
+    asserts: string;
     not: string | null;
     claim_id: string;
     source_ids: string[];
@@ -3408,14 +3494,14 @@ declare const ForbiddenInputSchema: z.ZodObject<{
     decision: z.ZodString;
     reason: z.ZodString;
 }, "strip", z.ZodTypeAny, {
+    section_id: string;
     reason: string;
     decision: string;
-    section_id: string;
     claim_id: string;
 }, {
+    section_id: string;
     reason: string;
     decision: string;
-    section_id: string;
     claim_id: string;
 }>;
 declare const CrossSectionMapSchema: z.ZodObject<{
@@ -3533,16 +3619,16 @@ declare const CrossSectionMapSchema: z.ZodObject<{
         applied_to: z.ZodString;
         must_disclose_in: z.ZodEnum<["decision-brief.md", "final-report.md", "both"]>;
     }, "strip", z.ZodTypeAny, {
+        scope: "pack" | "gate";
         reason: string;
         compensating_controls: string[];
-        scope: "pack" | "gate";
         family: string;
         applied_to: string;
         must_disclose_in: "decision-brief.md" | "final-report.md" | "both";
     }, {
+        scope: "pack" | "gate";
         reason: string;
         compensating_controls: string[];
-        scope: "pack" | "gate";
         family: string;
         applied_to: string;
         must_disclose_in: "decision-brief.md" | "final-report.md" | "both";
@@ -3558,16 +3644,16 @@ declare const CrossSectionMapSchema: z.ZodObject<{
         source_ids: z.ZodArray<z.ZodString, "many">;
     }, "strip", z.ZodTypeAny, {
         section_id: string;
-        asserts: string;
         scope: string | null;
+        asserts: string;
         not: string | null;
         claim_id: string;
         source_ids: string[];
         artifact_path: string;
     }, {
         section_id: string;
-        asserts: string;
         scope: string | null;
+        asserts: string;
         not: string | null;
         claim_id: string;
         source_ids: string[];
@@ -3579,14 +3665,14 @@ declare const CrossSectionMapSchema: z.ZodObject<{
         decision: z.ZodString;
         reason: z.ZodString;
     }, "strip", z.ZodTypeAny, {
+        section_id: string;
         reason: string;
         decision: string;
-        section_id: string;
         claim_id: string;
     }, {
+        section_id: string;
         reason: string;
         decision: string;
-        section_id: string;
         claim_id: string;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
@@ -3633,9 +3719,9 @@ declare const CrossSectionMapSchema: z.ZodObject<{
         contradiction_id: string;
     }[];
     waiver_dependencies: {
+        scope: "pack" | "gate";
         reason: string;
         compensating_controls: string[];
-        scope: "pack" | "gate";
         family: string;
         applied_to: string;
         must_disclose_in: "decision-brief.md" | "final-report.md" | "both";
@@ -3643,17 +3729,17 @@ declare const CrossSectionMapSchema: z.ZodObject<{
     open_questions: string[];
     allowed_synthesis_inputs: {
         section_id: string;
-        asserts: string;
         scope: string | null;
+        asserts: string;
         not: string | null;
         claim_id: string;
         source_ids: string[];
         artifact_path: string;
     }[];
     forbidden_inputs: {
+        section_id: string;
         reason: string;
         decision: string;
-        section_id: string;
         claim_id: string;
     }[];
 }, {
@@ -3700,9 +3786,9 @@ declare const CrossSectionMapSchema: z.ZodObject<{
         contradiction_id: string;
     }[];
     waiver_dependencies: {
+        scope: "pack" | "gate";
         reason: string;
         compensating_controls: string[];
-        scope: "pack" | "gate";
         family: string;
         applied_to: string;
         must_disclose_in: "decision-brief.md" | "final-report.md" | "both";
@@ -3710,17 +3796,17 @@ declare const CrossSectionMapSchema: z.ZodObject<{
     open_questions: string[];
     allowed_synthesis_inputs: {
         section_id: string;
-        asserts: string;
         scope: string | null;
+        asserts: string;
         not: string | null;
         claim_id: string;
         source_ids: string[];
         artifact_path: string;
     }[];
     forbidden_inputs: {
+        section_id: string;
         reason: string;
         decision: string;
-        section_id: string;
         claim_id: string;
     }[];
 }>;
@@ -3753,6 +3839,8 @@ interface WeakSourceRow {
     details: string;
     evidence_ids: string[];
     artifact_path: string;
+    waived?: boolean;
+    waiver_reason?: string;
 }
 interface UnresolvedContradictionRow {
     contradiction_id: string;
@@ -3775,6 +3863,8 @@ interface SourceDiversityGapRow {
     section_id: string;
     details: string;
     evidence_ids: string[];
+    waived?: boolean;
+    waiver_reason?: string;
 }
 interface SynthesisReadinessRow {
     section_id: string;
@@ -3937,14 +4027,14 @@ declare const OrphanClaimRowSchema: z.ZodObject<{
     details: z.ZodString;
     artifact_path: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    reason: "missing_source_card" | "missing_source_hash" | "missing_evidence_excerpt" | "unresolvable_source_id";
     section_id: string;
+    reason: "missing_source_card" | "missing_source_hash" | "missing_evidence_excerpt" | "unresolvable_source_id";
     claim_id: string;
     artifact_path: string;
     details: string;
 }, {
-    reason: "missing_source_card" | "missing_source_hash" | "missing_evidence_excerpt" | "unresolvable_source_id";
     section_id: string;
+    reason: "missing_source_card" | "missing_source_hash" | "missing_evidence_excerpt" | "unresolvable_source_id";
     claim_id: string;
     artifact_path: string;
     details: string;
@@ -3970,8 +4060,8 @@ declare const StaleSourceRowSchema: z.ZodObject<{
         max_source_age_months: number | null;
     }>;
 }, "strip", z.ZodTypeAny, {
-    reason: "too_old" | "missing_date" | "unparseable_date";
     section_id: string;
+    reason: "too_old" | "missing_date" | "unparseable_date";
     source_id: string;
     publisher: string | null;
     artifact_path: string;
@@ -3982,8 +4072,8 @@ declare const StaleSourceRowSchema: z.ZodObject<{
         max_source_age_months: number | null;
     };
 }, {
-    reason: "too_old" | "missing_date" | "unparseable_date";
     section_id: string;
+    reason: "too_old" | "missing_date" | "unparseable_date";
     source_id: string;
     publisher: string | null;
     artifact_path: string;
@@ -4001,14 +4091,14 @@ declare const WeakSourceRowSchema: z.ZodObject<{
     evidence_ids: z.ZodArray<z.ZodString, "many">;
     artifact_path: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    reason: "source_cluster_monopoly" | "low_independent_publishers" | "missing_primary_source" | "excessive_type_imbalance" | "failed_fetches_reducing_floor";
     section_id: string;
+    reason: "source_cluster_monopoly" | "low_independent_publishers" | "missing_primary_source" | "excessive_type_imbalance" | "failed_fetches_reducing_floor";
     artifact_path: string;
     details: string;
     evidence_ids: string[];
 }, {
-    reason: "source_cluster_monopoly" | "low_independent_publishers" | "missing_primary_source" | "excessive_type_imbalance" | "failed_fetches_reducing_floor";
     section_id: string;
+    reason: "source_cluster_monopoly" | "low_independent_publishers" | "missing_primary_source" | "excessive_type_imbalance" | "failed_fetches_reducing_floor";
     artifact_path: string;
     details: string;
     evidence_ids: string[];
@@ -4045,14 +4135,14 @@ declare const ScopeWideningRiskRowSchema: z.ZodObject<{
     details: z.ZodString;
     artifact_path: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    reason: "overgeneralization_finding" | "scope_null_in_use" | "missing_not_flagged" | "contextual_to_universal_risk";
     section_id: string;
+    reason: "overgeneralization_finding" | "scope_null_in_use" | "missing_not_flagged" | "contextual_to_universal_risk";
     claim_id: string;
     artifact_path: string;
     details: string;
 }, {
-    reason: "overgeneralization_finding" | "scope_null_in_use" | "missing_not_flagged" | "contextual_to_universal_risk";
     section_id: string;
+    reason: "overgeneralization_finding" | "scope_null_in_use" | "missing_not_flagged" | "contextual_to_universal_risk";
     claim_id: string;
     artifact_path: string;
     details: string;
@@ -4063,13 +4153,13 @@ declare const SourceDiversityGapRowSchema: z.ZodObject<{
     details: z.ZodString;
     evidence_ids: z.ZodArray<z.ZodString, "many">;
 }, "strip", z.ZodTypeAny, {
-    reason: "section_publisher_monopoly" | "low_section_publisher_count" | "cross_section_publisher_overlap" | "section_has_no_sources";
     section_id: string;
+    reason: "section_publisher_monopoly" | "low_section_publisher_count" | "cross_section_publisher_overlap" | "section_has_no_sources";
     details: string;
     evidence_ids: string[];
 }, {
-    reason: "section_publisher_monopoly" | "low_section_publisher_count" | "cross_section_publisher_overlap" | "section_has_no_sources";
     section_id: string;
+    reason: "section_publisher_monopoly" | "low_section_publisher_count" | "cross_section_publisher_overlap" | "section_has_no_sources";
     details: string;
     evidence_ids: string[];
 }>;
@@ -4230,24 +4320,24 @@ declare const PackAuditPayloadSchema: z.ZodObject<{
         sections_with_sources: z.ZodNumber;
         sections_without_sources: z.ZodNumber;
     }, "strip", z.ZodTypeAny, {
+        unknown: number;
         primary: number;
         secondary: number;
         forum: number;
         benchmark: number;
         docs: number;
-        unknown: number;
         total: number;
         independent_publishers: number;
         failed_fetches: number;
         sections_with_sources: number;
         sections_without_sources: number;
     }, {
+        unknown: number;
         primary: number;
         secondary: number;
         forum: number;
         benchmark: number;
         docs: number;
-        unknown: number;
         total: number;
         independent_publishers: number;
         failed_fetches: number;
@@ -4384,12 +4474,12 @@ declare const PackAuditPayloadSchema: z.ZodObject<{
         not_null: number;
     };
     source_summary: {
+        unknown: number;
         primary: number;
         secondary: number;
         forum: number;
         benchmark: number;
         docs: number;
-        unknown: number;
         total: number;
         independent_publishers: number;
         failed_fetches: number;
@@ -4469,12 +4559,12 @@ declare const PackAuditPayloadSchema: z.ZodObject<{
         not_null: number;
     };
     source_summary: {
+        unknown: number;
         primary: number;
         secondary: number;
         forum: number;
         benchmark: number;
         docs: number;
-        unknown: number;
         total: number;
         independent_publishers: number;
         failed_fetches: number;
@@ -4951,10 +5041,10 @@ declare const ReviewInvalidationReceiptSchema: z.ZodObject<{
     }>, "many">;
     notes: z.ZodNullable<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
+    section_id: string;
     reason: string;
     notes: string | null;
     research_os_version: string;
-    section_id: string;
     receipt_id: string;
     contract_label: string;
     invalidated_at: string;
@@ -4963,10 +5053,10 @@ declare const ReviewInvalidationReceiptSchema: z.ZodObject<{
         dst: string;
     }[];
 }, {
+    section_id: string;
     reason: string;
     notes: string | null;
     research_os_version: string;
-    section_id: string;
     receipt_id: string;
     contract_label: string;
     invalidated_at: string;
@@ -5445,8 +5535,8 @@ declare const SectionReportSchema: z.ZodObject<{
     gate_synthesis_eligible: z.ZodNullable<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     status: string;
-    research_os_version: string;
     section_id: string;
+    research_os_version: string;
     extraction: {
         claims_per_1k_words: number;
         weak_scope_count: number;
@@ -5506,8 +5596,8 @@ declare const SectionReportSchema: z.ZodObject<{
     gate_synthesis_eligible: boolean | null;
 }, {
     status: string;
-    research_os_version: string;
     section_id: string;
+    research_os_version: string;
     extraction: {
         claims_per_1k_words: number;
         weak_scope_count: number;
@@ -5613,20 +5703,20 @@ declare const ClaimTriageSchema: z.ZodObject<{
     triage_method: z.ZodString;
     created_at: z.ZodString;
 }, "strip", z.ZodTypeAny, {
+    section_id: string;
     reason: string;
     created_at: string;
     decision: "selected_for_review" | "parked_duplicate" | "parked_overdense_source" | "parked_weak_scope" | "parked_low_value" | "needs_scope_repair" | "needs_human_review";
-    section_id: string;
     claim_id: string;
     triage_id: string;
     rank: number | null;
     quality_score: number;
     triage_method: string;
 }, {
+    section_id: string;
     reason: string;
     created_at: string;
     decision: "selected_for_review" | "parked_duplicate" | "parked_overdense_source" | "parked_weak_scope" | "parked_low_value" | "needs_scope_repair" | "needs_human_review";
-    section_id: string;
     claim_id: string;
     triage_id: string;
     rank: number | null;
@@ -5658,8 +5748,8 @@ declare const TriageSummarySchema: z.ZodObject<{
         total: number;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
-    research_os_version: string;
     section_id: string;
+    research_os_version: string;
     triage_method: string;
     summary_id: string;
     triaged_at: string;
@@ -5674,8 +5764,8 @@ declare const TriageSummarySchema: z.ZodObject<{
         total: number;
     }[];
 }, {
-    research_os_version: string;
     section_id: string;
+    research_os_version: string;
     triage_method: string;
     summary_id: string;
     triaged_at: string;
@@ -5712,14 +5802,14 @@ declare const DiscoveryCandidateSchema: z.ZodObject<{
     reason: z.ZodDefault<z.ZodNullable<z.ZodString>>;
 }, "strip", z.ZodTypeAny, {
     status: "candidate" | "rejected" | "approved";
-    reason: string | null;
     section_id: string;
+    reason: string | null;
     title: string;
     url: string;
     publisher: string | null;
     rank: number;
     candidate_id: string;
-    source_type_guess: "primary" | "forum" | "benchmark" | "docs" | "unknown" | "article" | "paper" | "standard";
+    source_type_guess: "unknown" | "primary" | "forum" | "benchmark" | "docs" | "article" | "paper" | "standard";
     why_relevant: string;
     query: string;
     discovered_at: string;
@@ -5732,7 +5822,7 @@ declare const DiscoveryCandidateSchema: z.ZodObject<{
     publisher: string | null;
     rank: number;
     candidate_id: string;
-    source_type_guess: "primary" | "forum" | "benchmark" | "docs" | "unknown" | "article" | "paper" | "standard";
+    source_type_guess: "unknown" | "primary" | "forum" | "benchmark" | "docs" | "article" | "paper" | "standard";
     why_relevant: string;
     query: string;
     discovered_at: string;
@@ -5751,8 +5841,8 @@ declare const DiscoverySummarySchema: z.ZodObject<{
     candidates_rejected_invalid_url: z.ZodNumber;
     warnings: z.ZodArray<z.ZodString, "many">;
 }, "strip", z.ZodTypeAny, {
-    research_os_version: string;
     section_id: string;
+    research_os_version: string;
     summary_id: string;
     warnings: string[];
     query: string;
@@ -5762,8 +5852,8 @@ declare const DiscoverySummarySchema: z.ZodObject<{
     candidates_validated: number;
     candidates_rejected_invalid_url: number;
 }, {
-    research_os_version: string;
     section_id: string;
+    research_os_version: string;
     summary_id: string;
     warnings: string[];
     query: string;
@@ -5920,6 +6010,6 @@ declare class SynthesisNotReadyError extends ResearchOSError {
     constructor(mode: string);
 }
 
-declare const RESEARCH_OS_VERSION = "0.3.0";
+declare const RESEARCH_OS_VERSION = "0.3.2";
 
 export { type AllowedSynthesisInput, AllowedSynthesisInputSchema, type ApproveOptions, type ApproveResult, type ArchivedArtifact, ArchivedArtifactSchema, type ArtifactHash, ArtifactHashSchema, type AuditDensityOptions, type AuditDensityResult, type HandoffMode as AuditHandoffMode, HandoffModeSchema as AuditHandoffModeSchema, type AuditOptions, type AuditSummary, type CitationCoverage, type Claim, type ClaimCluster, ClaimClusterSchema, type ClaimCounts, type ClaimDensityAudit, ClaimDensityAuditSchema, type ClaimExtractionInput, type ClaimExtractionResult, type ClaimExtractor, type ClaimExtractorAdapter, ClaimExtractorSchema, type ClaimReview, ClaimReviewSchema, ClaimSchema, type ClaimSummary, type ClaimTriage, ClaimTriageSchema, type Confidence, ConfidenceSchema, type Contradiction, ContradictionConfidenceSchema, type ContradictionCounts, type ContradictionDetector, type ContradictionDetectorName, ContradictionDetectorSchema, type ContradictionResolution, ContradictionResolutionSchema, ContradictionSchema, type ContradictionStatus, ContradictionStatusSchema, type ContradictionSummary, type ContradictionType, ContradictionTypeSchema, type CoworkHandoffPayload$1 as CoworkHandoffPayload, CoworkHandoffPayloadSchema, type CrossSectionContradictionRef, CrossSectionContradictionRefSchema, type CrossSectionMap, CrossSectionMapSchema, DEFAULT_PROFILE, type DensityFlag, DensityFlagSchema, type DetectionResult, type DetectorMode, type DiscoverOptions, type DiscoverProposal, type DiscoverProvider, type DiscoverProviderInput, type DiscoverProviderResult, type DiscoverResult, type DiscoveryCandidate, DiscoveryCandidateSchema, type DiscoveryCandidateStatus, DiscoveryCandidateStatusSchema, type DiscoverySummary, DiscoverySummarySchema, type DraftClaim, type DraftContradiction, type DraftFinding, EXCERPT_ID_PATTERN, type Excerpt, type ExcerptDraft, type ExcerptOrigin, ExcerptOriginSchema, ExcerptSchema, type ExportOptions, type ExportSummary, type ExportUrlsOptions, type ExportUrlsResult, type ExtractClaimsOptions, type ExtractClaimsSummary, type ExtractionInput, type ExtractionResult, type Extractor, type ExtractorName, ExtractorNameSchema, FORBIDDEN_ACTIONS_ALWAYS, type FetchReceipt, FetchReceiptSchema, type FindingCategory, FindingCategorySchema, type FindingSeverity, FindingSeveritySchema, type ForbiddenInput, ForbiddenInputSchema, type FreezeOptions, type FreezeReceiptPayload, FreezeReceiptPayloadSchema, type FreezeRefusalPayload, FreezeRefusalPayloadSchema, type FreezeSummary, type FreshnessSummary, type GateCheckResult, GateCheckResultSchema, type GateCheckStatus, GateCheckStatusSchema, type GateConfig, GateConfigSchema, type GateFamily, GateFamilySchema, type GateInput, type GateVerdictEntry, GateVerdictEntrySchema, type GatherOptions, type GatherSummary, type HandoffMode$1 as HandoffMode, HandoffModeSchema$1 as HandoffModeSchema, HandoffNotFoundError, type HandoffOptions, type HandoffSummary, HeuristicClaimExtractor, HeuristicContradictionDetector, HeuristicExtractor, HeuristicReviewer, type IndexBuildOptions, type IndexBuildSummary, IndexNotBuiltError, type IndexQueryOptions, type IndexQuerySummary, type IndexStatus, IndexStatusSchema, type InitOptions, type InitResult, IntakeValidationError, type IntegrityCheck, IntegrityCheckSchema, InvalidSectionIdError, type InvalidateExtractionOptions, type InvalidateExtractionResult, type InvalidateReviewOptions, type InvalidateReviewResult, type InvalidationReceipt, InvalidationReceiptSchema, LlmHeuristicDiscoverProvider, type LoadOrBuildArgs, type LoadOrBuildResult, type MapOptions, type MapSummary, type NearDuplicateCluster, NearDuplicateClusterSchema, NoSourcesGatheredError, NoUrlsProvidedError, OllamaInternClaimExtractor, OllamaInternContradictionDetector, OllamaInternExtractor, OllamaInternReviewer, type OrphanClaimRow, OrphanClaimRowSchema, type OverlapAssessment, OverlapAssessmentSchema, type PackAuditPayload, PackAuditPayloadSchema, PackExistsError, PackNotFoundError, type PackVerdict, PackVerdictSchema, type PairedDraft, type PerSourceDensity, PerSourceDensitySchema, type PrimarySourceWaiver, PrimarySourceWaiverSchema, type PromoteOptions, type PromoteResult, type QueryHit, RESEARCH_OS_VERSION, type ReadinessSummary, type RecordType, type RejectOptions, type RejectResult, type Relevance, RelevanceSchema, ResearchOSError, type ResearchYaml, ResearchYamlSchema, type ResolutionStatus, ResolutionStatusSchema, type ReviewActive, ReviewActiveSchema, ReviewConfidenceSchema, type ReviewDecision, type ReviewDecisionCount, ReviewDecisionCountSchema, ReviewDecisionSchema, type ReviewFinding, ReviewFindingSchema, type ReviewInvalidationReceipt, ReviewInvalidationReceiptSchema, type ReviewSnapshot, ReviewSnapshotSchema, type ReviewState, ReviewStateSchema, type ReviewSummary, type Reviewer, type ReviewerInput, type ReviewerName, ReviewerNameSchema, type ReviewerResult, type RunGateOptions, type RunReviewOptions, type RunReviewSummary, SCHEMA_VERSION, type ScopeIntegritySummary, type ScopeOverlap, ScopeOverlapSchema, type ScopeWideningRiskRow, ScopeWideningRiskRowSchema, type Section, type SectionAcceptedSummary, SectionAcceptedSummarySchema, type SectionAddOptions, type SectionAddResult, SectionExistsError, type SectionGateResult$1 as SectionGateResult, SectionGateResultSchema, type SectionGatesYaml, SectionGatesYamlSchema, SectionNotFoundError, type SectionReport, SectionReportAcceptanceSchema, SectionReportContradictionsSchema, SectionReportExtractionSchema, type SectionReportOptions, type SectionReportResult, SectionReportReviewSchema, SectionReportSchema, SectionReportSourcesSchema, SectionSchema, type SectionState, SectionStateSchema, type SectionStatusChange, SectionStatusChangeSchema, type Severity, SeveritySchema, type SharedSource, SharedSourceSchema, type SourceCard, SourceCardSchema, type SourceCounts, type SourceDiversityGapRow, SourceDiversityGapRowSchema, type SourceFetchPair, type SourceSummary, type SourceType, type SourceTypeGuess, SourceTypeGuessSchema, SourceTypeSchema, type StaleSourceRow, StaleSourceRowSchema, type SyncOptions, type SyncSummary, SynthesisNotReadyError, type SynthesisReadinessRow, SynthesisReadinessRowSchema, TemplateNotFoundError, type TriageDecision, TriageDecisionSchema, type TriageOptions, type TriageRunResult, type TriageSummary, TriageSummarySchema, type UnresolvedContradictionRow, UnresolvedContradictionRowSchema, type Verdict, VerdictSchema, type WaiverApplication, WaiverApplicationSchema, type WaiverDependency, WaiverDependencySchema, type WaiverEntry, WaiverEntrySchema, type WaiverSummary, type WeakSourceRow, WeakSourceRowSchema, type WorkspaceOptions, type WorkspaceSummary, add, aggregate, appendFetchLog, appendSectionSourceId, applySchema, applyWaivers, approve, assessScopeOverlap, audit, auditDensity, build, buildCard, buildExcerptIndex, buildResearchYaml, checkClaimIntegrity, checkContradiction, checkFreshness, checkScopeIntegrity, checkSectionBudget, checkSourceFloor, chunkKeyPoints, chunkRawText, collectUrls, dedupeAndValidate, defaultClaimExtractors, defaultContradictionDetectors, defaultExtractors, defaultReviewers, derive, deriveClaimReviews, deriveCrossSectionMap, discover, evidenceGrounded, exportRepoKnowledge, exportUrls, extract, extractClaimCitations, extractContradictionDisclosures, extractWaiverDisclosures, fetchOnce, freeze, gate, gather, handoff, hasNegation, indexDbPath, init, invalidateExtraction, invalidateReview, isValidProfileName, jaccardSimilarity, ledgerPathFor, loadOrBuildLedger, makeReceiptId, makeSourceId, map, normalizeOllamaHost, openIndexDb, parseUrlsFileText, pickClaimExtractor, pickContradictionDetector, pickExtractor, pickReviewer, profileDir, promote, query, readActiveProfile, readTriagedClaimIds, readUrlsFile, reject, renderCoworkMaster, renderCrossSectionMapMarkdown, renderDecisionBrief, renderFinalReport, renderFreezeReceiptMarkdown, renderFreezeRefusalMarkdown, renderGateMarkdown, renderLedgerForPrompt, renderMarkdownView, renderOrphanClaimsMarkdown, renderPackAuditMarkdown, renderReviewMarkdown, renderScopeWideningRisksMarkdown, renderSourceDiversityGapsMarkdown, renderStaleSourcesMarkdown, renderSynthesisReadinessMarkdown, renderUnresolvedContradictionsMarkdown, renderWeakSourcesMarkdown, renderWorkingReport, reportSection, resolve, review, reviewActivePath, slugify, syncRepoKnowledge, tokenize, triage, workspace, writeActiveProfile, writeSourceCard };