audit-tools 0.28.0

package/dist/audit/types/reviewPlanning.d.ts

@@ -0,0 +1,513 @@
+import { z } from "zod";
+export declare const ReviewPacketGraphEdgeSchema: z.ZodObject<Pick<{
+    from: z.ZodString;
+    to: z.ZodString;
+    kind: z.ZodOptional<z.ZodString>;
+    direction: z.ZodOptional<z.ZodEnum<["directed", "undirected"]>>;
+    confidence: z.ZodOptional<z.ZodNumber>;
+    reason: z.ZodOptional<z.ZodString>;
+}, "reason" | "confidence" | "kind" | "from" | "to">, "strict", z.ZodTypeAny, {
+    from: string;
+    to: string;
+    reason?: string | undefined;
+    confidence?: number | undefined;
+    kind?: string | undefined;
+}, {
+    from: string;
+    to: string;
+    reason?: string | undefined;
+    confidence?: number | undefined;
+    kind?: string | undefined;
+}>;
+export type ReviewPacketGraphEdge = z.infer<typeof ReviewPacketGraphEdgeSchema>;
+export declare const ReviewPacketQualitySchema: z.ZodObject<{
+    cohesion_score: z.ZodNumber;
+    internal_edge_count: z.ZodNumber;
+    boundary_edge_count: z.ZodNumber;
+    unexplained_file_count: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    cohesion_score: number;
+    internal_edge_count: number;
+    boundary_edge_count: number;
+    unexplained_file_count: number;
+}, {
+    cohesion_score: number;
+    internal_edge_count: number;
+    boundary_edge_count: number;
+    unexplained_file_count: number;
+}>;
+export type ReviewPacketQuality = z.infer<typeof ReviewPacketQualitySchema>;
+export declare const WeaklyExplainedPacketSampleSchema: z.ZodObject<{
+    packet_id: z.ZodString;
+    primary_gap: z.ZodEnum<["missing_internal_edges", "unexplained_files", "partial_cohesion"]>;
+    file_count: z.ZodNumber;
+    sample_file_paths: z.ZodArray<z.ZodString, "many">;
+    cohesion_score: z.ZodNumber;
+    internal_edge_count: z.ZodNumber;
+    boundary_edge_count: z.ZodNumber;
+    unexplained_file_count: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    cohesion_score: number;
+    internal_edge_count: number;
+    boundary_edge_count: number;
+    unexplained_file_count: number;
+    packet_id: string;
+    primary_gap: "missing_internal_edges" | "unexplained_files" | "partial_cohesion";
+    file_count: number;
+    sample_file_paths: string[];
+}, {
+    cohesion_score: number;
+    internal_edge_count: number;
+    boundary_edge_count: number;
+    unexplained_file_count: number;
+    packet_id: string;
+    primary_gap: "missing_internal_edges" | "unexplained_files" | "partial_cohesion";
+    file_count: number;
+    sample_file_paths: string[];
+}>;
+export type WeaklyExplainedPacketSample = z.infer<typeof WeaklyExplainedPacketSampleSchema>;
+export declare const ReviewPacketSchema: z.ZodObject<{
+    packet_id: z.ZodString;
+    task_ids: z.ZodArray<z.ZodString, "many">;
+    unit_ids: z.ZodArray<z.ZodString, "many">;
+    pass_ids: z.ZodArray<z.ZodString, "many">;
+    lenses: z.ZodArray<z.ZodString, "many">;
+    file_paths: z.ZodArray<z.ZodString, "many">;
+    file_line_counts: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    total_lines: z.ZodNumber;
+    priority: z.ZodEnum<["high", "medium", "low"]>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    entrypoints: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    key_edges: z.ZodOptional<z.ZodArray<z.ZodObject<Pick<{
+        from: z.ZodString;
+        to: z.ZodString;
+        kind: z.ZodOptional<z.ZodString>;
+        direction: z.ZodOptional<z.ZodEnum<["directed", "undirected"]>>;
+        confidence: z.ZodOptional<z.ZodNumber>;
+        reason: z.ZodOptional<z.ZodString>;
+    }, "reason" | "confidence" | "kind" | "from" | "to">, "strict", z.ZodTypeAny, {
+        from: string;
+        to: string;
+        reason?: string | undefined;
+        confidence?: number | undefined;
+        kind?: string | undefined;
+    }, {
+        from: string;
+        to: string;
+        reason?: string | undefined;
+        confidence?: number | undefined;
+        kind?: string | undefined;
+    }>, "many">>;
+    boundary_files: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    quality: z.ZodObject<{
+        cohesion_score: z.ZodNumber;
+        internal_edge_count: z.ZodNumber;
+        boundary_edge_count: z.ZodNumber;
+        unexplained_file_count: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        cohesion_score: number;
+        internal_edge_count: number;
+        boundary_edge_count: number;
+        unexplained_file_count: number;
+    }, {
+        cohesion_score: number;
+        internal_edge_count: number;
+        boundary_edge_count: number;
+        unexplained_file_count: number;
+    }>;
+    rationale: z.ZodString;
+    estimated_tokens: z.ZodNumber;
+    /**
+     * Max member risk (in [0,1]) from the just-in-time graph partition — the
+     * signal that routes this packet to a relative model rank. Present only on
+     * dispatch-time packets built via `buildReviewPacketsFromPartition`; the
+     * plan-time builder has no partition and leaves it unset.
+     */
+    routing_risk: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    unit_ids: string[];
+    rationale: string;
+    file_paths: string[];
+    file_line_counts: Record<string, number>;
+    priority: "high" | "low" | "medium";
+    total_lines: number;
+    packet_id: string;
+    task_ids: string[];
+    pass_ids: string[];
+    lenses: string[];
+    quality: {
+        cohesion_score: number;
+        internal_edge_count: number;
+        boundary_edge_count: number;
+        unexplained_file_count: number;
+    };
+    estimated_tokens: number;
+    entrypoints?: string[] | undefined;
+    tags?: string[] | undefined;
+    key_edges?: {
+        from: string;
+        to: string;
+        reason?: string | undefined;
+        confidence?: number | undefined;
+        kind?: string | undefined;
+    }[] | undefined;
+    boundary_files?: string[] | undefined;
+    routing_risk?: number | undefined;
+}, {
+    unit_ids: string[];
+    rationale: string;
+    file_paths: string[];
+    file_line_counts: Record<string, number>;
+    priority: "high" | "low" | "medium";
+    total_lines: number;
+    packet_id: string;
+    task_ids: string[];
+    pass_ids: string[];
+    lenses: string[];
+    quality: {
+        cohesion_score: number;
+        internal_edge_count: number;
+        boundary_edge_count: number;
+        unexplained_file_count: number;
+    };
+    estimated_tokens: number;
+    entrypoints?: string[] | undefined;
+    tags?: string[] | undefined;
+    key_edges?: {
+        from: string;
+        to: string;
+        reason?: string | undefined;
+        confidence?: number | undefined;
+        kind?: string | undefined;
+    }[] | undefined;
+    boundary_files?: string[] | undefined;
+    routing_risk?: number | undefined;
+}>;
+export type ReviewPacket = z.infer<typeof ReviewPacketSchema>;
+/**
+ * Aggregate quality signals for a planned set of review packets — cohesion,
+ * boundary-crossing counts, and the weakly-explained-packet diagnostics. Promoted
+ * from an inline anonymous object on {@link AuditPlanMetrics} so it can be named
+ * and referenced.
+ */
+export declare const PacketQualitySchema: z.ZodObject<{
+    average_cohesion_score: z.ZodNumber;
+    boundary_crossing_count: z.ZodNumber;
+    merge_edge_kind_counts: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    boundary_edge_kind_counts: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    orphan_task_count: z.ZodNumber;
+    high_fan_in_file_count: z.ZodNumber;
+    high_fan_out_file_count: z.ZodNumber;
+    weakly_explained_gap_counts: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    weakly_explained_file_extension_counts: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    weakly_explained_packet_count: z.ZodNumber;
+    weakly_explained_packet_ids: z.ZodArray<z.ZodString, "many">;
+    weakly_explained_packet_samples: z.ZodArray<z.ZodObject<{
+        packet_id: z.ZodString;
+        primary_gap: z.ZodEnum<["missing_internal_edges", "unexplained_files", "partial_cohesion"]>;
+        file_count: z.ZodNumber;
+        sample_file_paths: z.ZodArray<z.ZodString, "many">;
+        cohesion_score: z.ZodNumber;
+        internal_edge_count: z.ZodNumber;
+        boundary_edge_count: z.ZodNumber;
+        unexplained_file_count: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        cohesion_score: number;
+        internal_edge_count: number;
+        boundary_edge_count: number;
+        unexplained_file_count: number;
+        packet_id: string;
+        primary_gap: "missing_internal_edges" | "unexplained_files" | "partial_cohesion";
+        file_count: number;
+        sample_file_paths: string[];
+    }, {
+        cohesion_score: number;
+        internal_edge_count: number;
+        boundary_edge_count: number;
+        unexplained_file_count: number;
+        packet_id: string;
+        primary_gap: "missing_internal_edges" | "unexplained_files" | "partial_cohesion";
+        file_count: number;
+        sample_file_paths: string[];
+    }>, "many">;
+    largest_unexplained_packet_id: z.ZodOptional<z.ZodString>;
+    largest_unexplained_packet_files: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    average_cohesion_score: number;
+    boundary_crossing_count: number;
+    merge_edge_kind_counts: Record<string, number>;
+    boundary_edge_kind_counts: Record<string, number>;
+    orphan_task_count: number;
+    high_fan_in_file_count: number;
+    high_fan_out_file_count: number;
+    weakly_explained_gap_counts: Record<string, number>;
+    weakly_explained_file_extension_counts: Record<string, number>;
+    weakly_explained_packet_count: number;
+    weakly_explained_packet_ids: string[];
+    weakly_explained_packet_samples: {
+        cohesion_score: number;
+        internal_edge_count: number;
+        boundary_edge_count: number;
+        unexplained_file_count: number;
+        packet_id: string;
+        primary_gap: "missing_internal_edges" | "unexplained_files" | "partial_cohesion";
+        file_count: number;
+        sample_file_paths: string[];
+    }[];
+    largest_unexplained_packet_files: number;
+    largest_unexplained_packet_id?: string | undefined;
+}, {
+    average_cohesion_score: number;
+    boundary_crossing_count: number;
+    merge_edge_kind_counts: Record<string, number>;
+    boundary_edge_kind_counts: Record<string, number>;
+    orphan_task_count: number;
+    high_fan_in_file_count: number;
+    high_fan_out_file_count: number;
+    weakly_explained_gap_counts: Record<string, number>;
+    weakly_explained_file_extension_counts: Record<string, number>;
+    weakly_explained_packet_count: number;
+    weakly_explained_packet_ids: string[];
+    weakly_explained_packet_samples: {
+        cohesion_score: number;
+        internal_edge_count: number;
+        boundary_edge_count: number;
+        unexplained_file_count: number;
+        packet_id: string;
+        primary_gap: "missing_internal_edges" | "unexplained_files" | "partial_cohesion";
+        file_count: number;
+        sample_file_paths: string[];
+    }[];
+    largest_unexplained_packet_files: number;
+    largest_unexplained_packet_id?: string | undefined;
+}>;
+export type PacketQuality = z.infer<typeof PacketQualitySchema>;
+export declare const AuditPlanMetricsSchema: z.ZodObject<{
+    generated_at: z.ZodString;
+    task_count: z.ZodNumber;
+    packet_count: z.ZodNumber;
+    estimated_agent_reduction: z.ZodNumber;
+    estimated_agent_reduction_ratio: z.ZodNumber;
+    unique_file_count: z.ZodNumber;
+    task_file_reference_count: z.ZodNumber;
+    repeated_file_reference_count: z.ZodNumber;
+    total_task_lines: z.ZodNumber;
+    total_packet_lines: z.ZodNumber;
+    repeated_line_reference_count: z.ZodNumber;
+    min_task_lines: z.ZodNumber;
+    max_task_lines: z.ZodNumber;
+    average_task_lines: z.ZodNumber;
+    largest_task_id: z.ZodOptional<z.ZodString>;
+    largest_packet_id: z.ZodOptional<z.ZodString>;
+    lens_task_counts: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    priority_task_counts: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    packet_quality: z.ZodObject<{
+        average_cohesion_score: z.ZodNumber;
+        boundary_crossing_count: z.ZodNumber;
+        merge_edge_kind_counts: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        boundary_edge_kind_counts: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        orphan_task_count: z.ZodNumber;
+        high_fan_in_file_count: z.ZodNumber;
+        high_fan_out_file_count: z.ZodNumber;
+        weakly_explained_gap_counts: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        weakly_explained_file_extension_counts: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        weakly_explained_packet_count: z.ZodNumber;
+        weakly_explained_packet_ids: z.ZodArray<z.ZodString, "many">;
+        weakly_explained_packet_samples: z.ZodArray<z.ZodObject<{
+            packet_id: z.ZodString;
+            primary_gap: z.ZodEnum<["missing_internal_edges", "unexplained_files", "partial_cohesion"]>;
+            file_count: z.ZodNumber;
+            sample_file_paths: z.ZodArray<z.ZodString, "many">;
+            cohesion_score: z.ZodNumber;
+            internal_edge_count: z.ZodNumber;
+            boundary_edge_count: z.ZodNumber;
+            unexplained_file_count: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            cohesion_score: number;
+            internal_edge_count: number;
+            boundary_edge_count: number;
+            unexplained_file_count: number;
+            packet_id: string;
+            primary_gap: "missing_internal_edges" | "unexplained_files" | "partial_cohesion";
+            file_count: number;
+            sample_file_paths: string[];
+        }, {
+            cohesion_score: number;
+            internal_edge_count: number;
+            boundary_edge_count: number;
+            unexplained_file_count: number;
+            packet_id: string;
+            primary_gap: "missing_internal_edges" | "unexplained_files" | "partial_cohesion";
+            file_count: number;
+            sample_file_paths: string[];
+        }>, "many">;
+        largest_unexplained_packet_id: z.ZodOptional<z.ZodString>;
+        largest_unexplained_packet_files: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        average_cohesion_score: number;
+        boundary_crossing_count: number;
+        merge_edge_kind_counts: Record<string, number>;
+        boundary_edge_kind_counts: Record<string, number>;
+        orphan_task_count: number;
+        high_fan_in_file_count: number;
+        high_fan_out_file_count: number;
+        weakly_explained_gap_counts: Record<string, number>;
+        weakly_explained_file_extension_counts: Record<string, number>;
+        weakly_explained_packet_count: number;
+        weakly_explained_packet_ids: string[];
+        weakly_explained_packet_samples: {
+            cohesion_score: number;
+            internal_edge_count: number;
+            boundary_edge_count: number;
+            unexplained_file_count: number;
+            packet_id: string;
+            primary_gap: "missing_internal_edges" | "unexplained_files" | "partial_cohesion";
+            file_count: number;
+            sample_file_paths: string[];
+        }[];
+        largest_unexplained_packet_files: number;
+        largest_unexplained_packet_id?: string | undefined;
+    }, {
+        average_cohesion_score: number;
+        boundary_crossing_count: number;
+        merge_edge_kind_counts: Record<string, number>;
+        boundary_edge_kind_counts: Record<string, number>;
+        orphan_task_count: number;
+        high_fan_in_file_count: number;
+        high_fan_out_file_count: number;
+        weakly_explained_gap_counts: Record<string, number>;
+        weakly_explained_file_extension_counts: Record<string, number>;
+        weakly_explained_packet_count: number;
+        weakly_explained_packet_ids: string[];
+        weakly_explained_packet_samples: {
+            cohesion_score: number;
+            internal_edge_count: number;
+            boundary_edge_count: number;
+            unexplained_file_count: number;
+            packet_id: string;
+            primary_gap: "missing_internal_edges" | "unexplained_files" | "partial_cohesion";
+            file_count: number;
+            sample_file_paths: string[];
+        }[];
+        largest_unexplained_packet_files: number;
+        largest_unexplained_packet_id?: string | undefined;
+    }>;
+    packet_size: z.ZodObject<{
+        single_task_packets: z.ZodNumber;
+        multi_task_packets: z.ZodNumber;
+        max_tasks_per_packet: z.ZodNumber;
+        max_files_per_packet: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        single_task_packets: number;
+        multi_task_packets: number;
+        max_tasks_per_packet: number;
+        max_files_per_packet: number;
+    }, {
+        single_task_packets: number;
+        multi_task_packets: number;
+        max_tasks_per_packet: number;
+        max_files_per_packet: number;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    generated_at: string;
+    task_count: number;
+    packet_count: number;
+    estimated_agent_reduction: number;
+    estimated_agent_reduction_ratio: number;
+    unique_file_count: number;
+    task_file_reference_count: number;
+    repeated_file_reference_count: number;
+    total_task_lines: number;
+    total_packet_lines: number;
+    repeated_line_reference_count: number;
+    min_task_lines: number;
+    max_task_lines: number;
+    average_task_lines: number;
+    lens_task_counts: Record<string, number>;
+    priority_task_counts: Record<string, number>;
+    packet_quality: {
+        average_cohesion_score: number;
+        boundary_crossing_count: number;
+        merge_edge_kind_counts: Record<string, number>;
+        boundary_edge_kind_counts: Record<string, number>;
+        orphan_task_count: number;
+        high_fan_in_file_count: number;
+        high_fan_out_file_count: number;
+        weakly_explained_gap_counts: Record<string, number>;
+        weakly_explained_file_extension_counts: Record<string, number>;
+        weakly_explained_packet_count: number;
+        weakly_explained_packet_ids: string[];
+        weakly_explained_packet_samples: {
+            cohesion_score: number;
+            internal_edge_count: number;
+            boundary_edge_count: number;
+            unexplained_file_count: number;
+            packet_id: string;
+            primary_gap: "missing_internal_edges" | "unexplained_files" | "partial_cohesion";
+            file_count: number;
+            sample_file_paths: string[];
+        }[];
+        largest_unexplained_packet_files: number;
+        largest_unexplained_packet_id?: string | undefined;
+    };
+    packet_size: {
+        single_task_packets: number;
+        multi_task_packets: number;
+        max_tasks_per_packet: number;
+        max_files_per_packet: number;
+    };
+    largest_task_id?: string | undefined;
+    largest_packet_id?: string | undefined;
+}, {
+    generated_at: string;
+    task_count: number;
+    packet_count: number;
+    estimated_agent_reduction: number;
+    estimated_agent_reduction_ratio: number;
+    unique_file_count: number;
+    task_file_reference_count: number;
+    repeated_file_reference_count: number;
+    total_task_lines: number;
+    total_packet_lines: number;
+    repeated_line_reference_count: number;
+    min_task_lines: number;
+    max_task_lines: number;
+    average_task_lines: number;
+    lens_task_counts: Record<string, number>;
+    priority_task_counts: Record<string, number>;
+    packet_quality: {
+        average_cohesion_score: number;
+        boundary_crossing_count: number;
+        merge_edge_kind_counts: Record<string, number>;
+        boundary_edge_kind_counts: Record<string, number>;
+        orphan_task_count: number;
+        high_fan_in_file_count: number;
+        high_fan_out_file_count: number;
+        weakly_explained_gap_counts: Record<string, number>;
+        weakly_explained_file_extension_counts: Record<string, number>;
+        weakly_explained_packet_count: number;
+        weakly_explained_packet_ids: string[];
+        weakly_explained_packet_samples: {
+            cohesion_score: number;
+            internal_edge_count: number;
+            boundary_edge_count: number;
+            unexplained_file_count: number;
+            packet_id: string;
+            primary_gap: "missing_internal_edges" | "unexplained_files" | "partial_cohesion";
+            file_count: number;
+            sample_file_paths: string[];
+        }[];
+        largest_unexplained_packet_files: number;
+        largest_unexplained_packet_id?: string | undefined;
+    };
+    packet_size: {
+        single_task_packets: number;
+        multi_task_packets: number;
+        max_tasks_per_packet: number;
+        max_files_per_packet: number;
+    };
+    largest_task_id?: string | undefined;
+    largest_packet_id?: string | undefined;
+}>;
+export type AuditPlanMetrics = z.infer<typeof AuditPlanMetricsSchema>;
+//# sourceMappingURL=reviewPlanning.d.ts.map

package/dist/audit/types/reviewPlanning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reviewPlanning.d.ts","sourceRoot":"","sources":["../../../src/audit/types/reviewPlanning.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;EAMtC,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;EAKpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;EAS5C,CAAC;AACH,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAC/C,OAAO,iCAAiC,CACzC,CAAC;AAEF,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAiB7B;;;;;OAKG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEH,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiB9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2BjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/audit/types/reviewPlanning.js

@@ -0,0 +1,109 @@
+import { z } from "zod";
+import { GraphEdgeSchema } from "audit-tools/shared";
+const PrioritySchema = z.enum(["high", "medium", "low"]);
+const PrimaryGapSchema = z.enum([
+    "missing_internal_edges",
+    "unexplained_files",
+    "partial_cohesion",
+]);
+export const ReviewPacketGraphEdgeSchema = GraphEdgeSchema.pick({
+    from: true,
+    to: true,
+    kind: true,
+    confidence: true,
+    reason: true,
+});
+export const ReviewPacketQualitySchema = z.object({
+    cohesion_score: z.number(),
+    internal_edge_count: z.number(),
+    boundary_edge_count: z.number(),
+    unexplained_file_count: z.number(),
+});
+export const WeaklyExplainedPacketSampleSchema = z.object({
+    packet_id: z.string(),
+    primary_gap: PrimaryGapSchema,
+    file_count: z.number(),
+    sample_file_paths: z.array(z.string()),
+    cohesion_score: z.number(),
+    internal_edge_count: z.number(),
+    boundary_edge_count: z.number(),
+    unexplained_file_count: z.number(),
+});
+export const ReviewPacketSchema = z.object({
+    packet_id: z.string(),
+    task_ids: z.array(z.string()),
+    unit_ids: z.array(z.string()),
+    pass_ids: z.array(z.string()),
+    lenses: z.array(z.string()),
+    file_paths: z.array(z.string()),
+    file_line_counts: z.record(z.string(), z.number()),
+    total_lines: z.number(),
+    priority: PrioritySchema,
+    tags: z.array(z.string()).optional(),
+    entrypoints: z.array(z.string()).optional(),
+    key_edges: z.array(ReviewPacketGraphEdgeSchema).optional(),
+    boundary_files: z.array(z.string()).optional(),
+    quality: ReviewPacketQualitySchema,
+    rationale: z.string(),
+    estimated_tokens: z.number(),
+    /**
+     * Max member risk (in [0,1]) from the just-in-time graph partition — the
+     * signal that routes this packet to a relative model rank. Present only on
+     * dispatch-time packets built via `buildReviewPacketsFromPartition`; the
+     * plan-time builder has no partition and leaves it unset.
+     */
+    routing_risk: z.number().optional(),
+});
+/**
+ * Aggregate quality signals for a planned set of review packets — cohesion,
+ * boundary-crossing counts, and the weakly-explained-packet diagnostics. Promoted
+ * from an inline anonymous object on {@link AuditPlanMetrics} so it can be named
+ * and referenced.
+ */
+export const PacketQualitySchema = z.object({
+    average_cohesion_score: z.number().min(0).max(1),
+    boundary_crossing_count: z.number(),
+    merge_edge_kind_counts: z.record(z.string(), z.number()),
+    boundary_edge_kind_counts: z.record(z.string(), z.number()),
+    orphan_task_count: z.number(),
+    high_fan_in_file_count: z.number(),
+    high_fan_out_file_count: z.number(),
+    // Keyed by PrimaryGap at runtime; typed as a full string-record so values are
+    // non-optional (z.record(enum, …) infers a Partial record).
+    weakly_explained_gap_counts: z.record(z.string(), z.number()),
+    weakly_explained_file_extension_counts: z.record(z.string(), z.number()),
+    weakly_explained_packet_count: z.number(),
+    weakly_explained_packet_ids: z.array(z.string()),
+    weakly_explained_packet_samples: z.array(WeaklyExplainedPacketSampleSchema),
+    largest_unexplained_packet_id: z.string().optional(),
+    largest_unexplained_packet_files: z.number(),
+});
+export const AuditPlanMetricsSchema = z.object({
+    generated_at: z.string(),
+    task_count: z.number(),
+    packet_count: z.number(),
+    estimated_agent_reduction: z.number(),
+    estimated_agent_reduction_ratio: z.number(),
+    unique_file_count: z.number(),
+    task_file_reference_count: z.number(),
+    repeated_file_reference_count: z.number(),
+    total_task_lines: z.number(),
+    total_packet_lines: z.number(),
+    repeated_line_reference_count: z.number(),
+    min_task_lines: z.number(),
+    max_task_lines: z.number(),
+    average_task_lines: z.number(),
+    largest_task_id: z.string().optional(),
+    largest_packet_id: z.string().optional(),
+    lens_task_counts: z.record(z.string(), z.number()),
+    // Keyed by priority at runtime; full string-record (see gap-counts note).
+    priority_task_counts: z.record(z.string(), z.number()),
+    packet_quality: PacketQualitySchema,
+    packet_size: z.object({
+        single_task_packets: z.number(),
+        multi_task_packets: z.number(),
+        max_tasks_per_packet: z.number(),
+        max_files_per_packet: z.number(),
+    }),
+});
+//# sourceMappingURL=reviewPlanning.js.map

package/dist/audit/types/reviewPlanning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reviewPlanning.js","sourceRoot":"","sources":["../../../src/audit/types/reviewPlanning.ts"],"names":[],"mappings":"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"}