@kb-labs/quality-contracts 2.94.0 → 2.98.0

package/dist/index.d.ts

@@ -116,20 +116,66 @@ interface TestRunResult {
 }
 
 /**
- * Types for quality:stats command
+ * Quality snapshot types — persistent history for trend tracking
  */
+interface DimensionScore {
+    score: number;
+    grade: 'A' | 'B' | 'C' | 'D' | 'F';
+    details: string[];
+}
+interface DimensionScores {
+    architecture: DimensionScore;
+    typescript: DimensionScore;
+    deadCode: DimensionScore;
+    depHygiene: DimensionScore;
+    testCoverage: DimensionScore;
+}
+interface QualitySnapshot {
+    id: string;
+    timestamp: string;
+    git: {
+        commit: string;
+        branch: string;
+        message: string;
+    };
+    score: number;
+    grade: 'A' | 'B' | 'C' | 'D' | 'F';
+    dimensions: DimensionScores;
+    /** Raw counters for delta computation */
+    counters: {
+        layeringViolations: number;
+        avgInstability: number;
+        anyCount: number;
+        tsIgnoreCount: number;
+        unusedFiles: number;
+        unusedDeps: number;
+    };
+}
+interface SnapshotDelta {
+    score: number;
+    layeringViolations: number;
+    anyCount: number;
+    tsIgnoreCount: number;
+    unusedFiles: number;
+    unusedDeps: number;
+    avgInstability: number;
+}
+interface SnapshotHistory {
+    snapshots: QualitySnapshot[];
+    /** Delta vs previous snapshot, if history has >= 2 entries */
+    delta: SnapshotDelta | null;
+    latest: QualitySnapshot | null;
+}
 
 /**
- * Health score for a package or repository
+ * Types for quality:stats and quality:health commands
  */
+
 interface HealthScore {
     score: number;
     grade: 'A' | 'B' | 'C' | 'D' | 'F';
-    issues: Issue[];
+    dimensions: DimensionScores;
 }
-/**
- * Package statistics
- */
 interface PackageStats {
     name: string;
     path?: string;
@@ -138,9 +184,6 @@ interface PackageStats {
     lines: number;
     bytes: number;
 }
-/**
- * Repository statistics
- */
 interface RepositoryStats {
     name: string;
     packages: number;
@@ -148,9 +191,6 @@ interface RepositoryStats {
     lines: number;
     bytes: number;
 }
-/**
- * Dependency statistics
- */
 interface DependencyStats {
     total: number;
     workspace: number;
@@ -161,9 +201,6 @@ interface DependencyStats {
         count: number;
     }>;
 }
-/**
- * Statistics result from quality:stats
- */
 interface StatsResult {
     overview: {
         totalPackages: number;
@@ -179,126 +216,68 @@ interface StatsResult {
 }
 
 /**
- * Constants for Quality Plugin
- */
-/**
- * Environment variables
+ * Architecture analysis types — layering violations and coupling metrics
  */
-declare const QUALITY_ENV_VARS: readonly ["KB_QUALITY_CACHE_TTL", "KB_QUALITY_MAX_PACKAGES"];
-/**
- * Cache namespace prefix
- */
-declare const QUALITY_CACHE_PREFIX = "quality:";
-/**
- * Cache keys
- */
-declare const CACHE_KEYS: {
-    readonly STATS: "quality:stats";
-    readonly HEALTH: "quality:health";
-    readonly IMPORTS: "quality:imports";
-    readonly EXPORTS: "quality:exports";
-    readonly TYPES: "quality:types";
-    readonly DUPLICATES: "quality:duplicates";
-    readonly BUILDS: "quality:builds";
-    readonly TYPE_ANALYSIS: "quality:type-analysis";
-    readonly TESTS: "quality:tests";
-    readonly DEAD_CODE: "quality:dead-code";
-};
-/**
- * Default timeouts (milliseconds)
- */
-declare const DEFAULT_TIMEOUTS: {
-    readonly STATS: 60000;
-    readonly HEALTH: 120000;
-    readonly CHECK_IMPORTS: 60000;
-    readonly CHECK_EXPORTS: 60000;
-    readonly CHECK_TYPES: 90000;
-    readonly TYPES_AUDIT: 180000;
-    readonly FIX_DEPS: 300000;
-    readonly CI: 600000;
-    readonly DEAD_CODE: 120000;
-};
-/**
- * Health score grades
- */
-declare const HEALTH_GRADES: {
-    readonly A: {
-        readonly min: 90;
-        readonly max: 100;
-        readonly label: "Excellent";
-    };
-    readonly B: {
-        readonly min: 80;
-        readonly max: 89;
-        readonly label: "Good";
-    };
-    readonly C: {
-        readonly min: 70;
-        readonly max: 79;
-        readonly label: "Fair";
-    };
-    readonly D: {
-        readonly min: 60;
-        readonly max: 69;
-        readonly label: "Poor";
-    };
-    readonly F: {
-        readonly min: 0;
-        readonly max: 59;
-        readonly label: "Failing";
-    };
-};
+/** A single import that crosses layer boundaries */
+interface LayeringViolation {
+    file: string;
+    fromPackage: string;
+    fromLayer: number;
+    toPackage: string;
+    toLayer: number;
+    importSpecifier: string;
+}
+interface LayeringReport {
+    violations: LayeringViolation[];
+    totalViolations: number;
+    affectedPackages: string[];
+    /** Layer map used for analysis */
+    layerMap: Record<string, number>;
+}
+interface PackageCoupling {
+    name: string;
+    /** Afferent coupling: packages that depend on this */
+    afferent: number;
+    /** Efferent coupling: packages this depends on */
+    efferent: number;
+    /** Instability = Ce/(Ca+Ce). 0 = stable, 1 = unstable */
+    instability: number;
+}
+interface CouplingReport {
+    packages: PackageCoupling[];
+    avgInstability: number;
+    mostUnstable: PackageCoupling[];
+    mostCoupled: PackageCoupling[];
+}
 
 /**
- * @module @kb-labs/quality-contracts/routes
- * REST API route constants for quality plugin
- */
-/**
- * REST API base path for quality plugin
- */
-declare const QUALITY_BASE_PATH: "/v1/plugins/quality";
-/**
- * REST API route paths (relative to basePath)
- */
-declare const QUALITY_ROUTES: {
-    /** GET /stats - Get monorepo statistics */
-    readonly STATS: "/stats";
-    /** GET /health - Get health score */
-    readonly HEALTH: "/health";
-    /** GET /dependencies - Get dependency issues */
-    readonly DEPENDENCIES: "/dependencies";
-    /** GET /build-order - Get build order */
-    readonly BUILD_ORDER: "/build-order";
-    /** GET /cycles - Get circular dependencies */
-    readonly CYCLES: "/cycles";
-    /** GET /graph - Get dependency graph */
-    readonly GRAPH: "/graph";
-    /** GET /stale - Get stale packages */
-    readonly STALE: "/stale";
-    /** GET /builds - Get build status */
-    readonly BUILDS: "/builds";
-    /** GET /types - Get type safety analysis */
-    readonly TYPES: "/types";
-    /** GET /tests - Get test results and coverage */
-    readonly TESTS: "/tests";
-};
-/**
- * Full REST API URLs (basePath + route)
- * Useful for testing and documentation
+ * Quality plugin configuration — stored in kb.config.json under "quality" section
  */
-declare const QUALITY_FULL_ROUTES: {
-    readonly STATS: "/v1/plugins/quality/stats";
-    readonly HEALTH: "/v1/plugins/quality/health";
-    readonly DEPENDENCIES: "/v1/plugins/quality/dependencies";
-    readonly BUILD_ORDER: "/v1/plugins/quality/build-order";
-    readonly CYCLES: "/v1/plugins/quality/cycles";
-    readonly GRAPH: "/v1/plugins/quality/graph";
-    readonly STALE: "/v1/plugins/quality/stale";
-    readonly BUILDS: "/v1/plugins/quality/builds";
-    readonly TYPES: "/v1/plugins/quality/types";
-    readonly TESTS: "/v1/plugins/quality/tests";
-};
-type QualityRoute = typeof QUALITY_ROUTES[keyof typeof QUALITY_ROUTES];
+interface QualityLayerMap {
+    [pathPrefix: string]: number;
+}
+interface QualityThresholds {
+    /** Minimum health score before exit 1. Default: 70 */
+    health: number;
+    /** Instability threshold for warning. Default: 0.85 */
+    instability: number;
+}
+interface QualityKnipConfig {
+    /** Whether to run knip for dead code / dep analysis. Default: true */
+    enabled: boolean;
+}
+interface QualityPluginConfig {
+    /** Max snapshots to retain in history. Default: 30 */
+    maxSnapshots: number;
+    knip: QualityKnipConfig;
+    /**
+     * Layer map: path prefix → layer index.
+     * Defaults to KB Labs standard layers from CLAUDE.md.
+     */
+    layers: QualityLayerMap;
+    thresholds: QualityThresholds;
+}
+declare const defaultQualityConfig: QualityPluginConfig;
 
 /**
  * Types for dead code file detection
@@ -384,6 +363,131 @@ interface DeadCodeRemovalResult {
     exportsCleanedUp: number;
     manifest: DeadCodeBackupManifest;
 }
+interface KnipUnusedExport {
+    file: string;
+    symbol: string;
+}
+interface KnipUnusedDependency {
+    package: string;
+    workspace: string;
+}
+/** Parsed output from `knip --reporter json` */
+interface KnipReport {
+    unusedFiles: string[];
+    unusedExports: KnipUnusedExport[];
+    unusedDependencies: KnipUnusedDependency[];
+    unlistedDependencies: KnipUnusedDependency[];
+    /** Total issue count for quick health scoring */
+    totalIssues: number;
+}
+
+/**
+ * Constants for Quality Plugin
+ */
+declare const QUALITY_ENV_VARS: readonly ["KB_QUALITY_CACHE_TTL", "KB_QUALITY_MAX_PACKAGES"];
+declare const QUALITY_CACHE_PREFIX = "quality:";
+declare const CACHE_KEYS: {
+    readonly STATS: "quality:stats";
+    readonly HEALTH: "quality:health";
+    readonly IMPORTS: "quality:imports";
+    readonly EXPORTS: "quality:exports";
+    readonly TYPES: "quality:types";
+    readonly DUPLICATES: "quality:duplicates";
+    readonly BUILDS: "quality:builds";
+    readonly TYPE_ANALYSIS: "quality:type-analysis";
+    readonly TESTS: "quality:tests";
+    readonly DEAD_CODE: "quality:dead-code";
+    readonly KNIP: "quality:knip";
+    readonly LAYERS: "quality:layers";
+    readonly COUPLING: "quality:coupling";
+};
+/** Cache TTLs in milliseconds */
+declare const CACHE_TTLS: {
+    readonly FAST: number;
+    readonly SLOW: number;
+};
+declare const DEFAULT_TIMEOUTS: {
+    readonly STATS: 60000;
+    readonly HEALTH: 120000;
+    readonly LAYERS: 60000;
+    readonly COUPLING: 30000;
+    readonly KNIP: 180000;
+    readonly CHECK_TYPES: 90000;
+    readonly FIX_DEPS: 300000;
+    readonly CI: 600000;
+};
+declare const HEALTH_GRADES: {
+    readonly A: {
+        readonly min: 90;
+        readonly max: 100;
+        readonly label: "Excellent";
+    };
+    readonly B: {
+        readonly min: 80;
+        readonly max: 89;
+        readonly label: "Good";
+    };
+    readonly C: {
+        readonly min: 70;
+        readonly max: 79;
+        readonly label: "Fair";
+    };
+    readonly D: {
+        readonly min: 60;
+        readonly max: 69;
+        readonly label: "Poor";
+    };
+    readonly F: {
+        readonly min: 0;
+        readonly max: 59;
+        readonly label: "Failing";
+    };
+};
+/** Dimension weights for composite health score */
+declare const DIMENSION_WEIGHTS: {
+    readonly architecture: 0.3;
+    readonly typescript: 0.25;
+    readonly deadCode: 0.2;
+    readonly depHygiene: 0.15;
+    readonly testCoverage: 0.1;
+};
+declare const SNAPSHOT_DIR = ".kb/quality/snapshots";
+declare const SNAPSHOT_FILE = "quality.json";
+declare const MAX_SNAPSHOTS_DEFAULT = 30;
+
+/**
+ * @module @kb-labs/quality-contracts/routes
+ * REST API route constants for quality plugin
+ */
+declare const QUALITY_BASE_PATH: "/v1/plugins/quality";
+declare const QUALITY_ROUTES: {
+    /** GET /stats */
+    readonly STATS: "/stats";
+    /** GET /health */
+    readonly HEALTH: "/health";
+    /** GET /dependencies */
+    readonly DEPENDENCIES: "/dependencies";
+    /** GET /build-order */
+    readonly BUILD_ORDER: "/build-order";
+    /** GET /cycles */
+    readonly CYCLES: "/cycles";
+    /** GET /graph */
+    readonly GRAPH: "/graph";
+    /** GET /stale */
+    readonly STALE: "/stale";
+    /** GET /layers — layering violation report */
+    readonly LAYERS: "/layers";
+    /** GET /coupling — coupling metrics */
+    readonly COUPLING: "/coupling";
+    /** GET /dead-code — knip report */
+    readonly DEAD_CODE: "/dead-code";
+    /** GET /history — snapshot history */
+    readonly HISTORY: "/history";
+    /** POST /snapshot — save snapshot */
+    readonly SNAPSHOT: "/snapshot";
+};
+declare const QUALITY_FULL_ROUTES: { [K in keyof typeof QUALITY_ROUTES]: string; };
+type QualityRoute = (typeof QUALITY_ROUTES)[keyof typeof QUALITY_ROUTES];
 
 /**
  * REST API Request/Response Types and Zod Schemas for Quality Plugin
@@ -963,5 +1067,1595 @@ declare const StaleResponseSchema: z.ZodObject<{
     }[] | undefined;
 }>;
 type StaleResponse = z.infer<typeof StaleResponseSchema>;
+declare const DimensionScoreSchema: z.ZodObject<{
+    score: z.ZodNumber;
+    grade: z.ZodEnum<["A", "B", "C", "D", "F"]>;
+    details: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    grade: "A" | "B" | "C" | "D" | "F";
+    score: number;
+    details: string[];
+}, {
+    grade: "A" | "B" | "C" | "D" | "F";
+    score: number;
+    details: string[];
+}>;
+declare const DimensionScoresSchema: z.ZodObject<{
+    architecture: z.ZodObject<{
+        score: z.ZodNumber;
+        grade: z.ZodEnum<["A", "B", "C", "D", "F"]>;
+        details: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        grade: "A" | "B" | "C" | "D" | "F";
+        score: number;
+        details: string[];
+    }, {
+        grade: "A" | "B" | "C" | "D" | "F";
+        score: number;
+        details: string[];
+    }>;
+    typescript: z.ZodObject<{
+        score: z.ZodNumber;
+        grade: z.ZodEnum<["A", "B", "C", "D", "F"]>;
+        details: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        grade: "A" | "B" | "C" | "D" | "F";
+        score: number;
+        details: string[];
+    }, {
+        grade: "A" | "B" | "C" | "D" | "F";
+        score: number;
+        details: string[];
+    }>;
+    deadCode: z.ZodObject<{
+        score: z.ZodNumber;
+        grade: z.ZodEnum<["A", "B", "C", "D", "F"]>;
+        details: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        grade: "A" | "B" | "C" | "D" | "F";
+        score: number;
+        details: string[];
+    }, {
+        grade: "A" | "B" | "C" | "D" | "F";
+        score: number;
+        details: string[];
+    }>;
+    depHygiene: z.ZodObject<{
+        score: z.ZodNumber;
+        grade: z.ZodEnum<["A", "B", "C", "D", "F"]>;
+        details: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        grade: "A" | "B" | "C" | "D" | "F";
+        score: number;
+        details: string[];
+    }, {
+        grade: "A" | "B" | "C" | "D" | "F";
+        score: number;
+        details: string[];
+    }>;
+    testCoverage: z.ZodObject<{
+        score: z.ZodNumber;
+        grade: z.ZodEnum<["A", "B", "C", "D", "F"]>;
+        details: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        grade: "A" | "B" | "C" | "D" | "F";
+        score: number;
+        details: string[];
+    }, {
+        grade: "A" | "B" | "C" | "D" | "F";
+        score: number;
+        details: string[];
+    }>;
+}, "strip", z.ZodTypeAny, {
+    architecture: {
+        grade: "A" | "B" | "C" | "D" | "F";
+        score: number;
+        details: string[];
+    };
+    typescript: {
+        grade: "A" | "B" | "C" | "D" | "F";
+        score: number;
+        details: string[];
+    };
+    deadCode: {
+        grade: "A" | "B" | "C" | "D" | "F";
+        score: number;
+        details: string[];
+    };
+    depHygiene: {
+        grade: "A" | "B" | "C" | "D" | "F";
+        score: number;
+        details: string[];
+    };
+    testCoverage: {
+        grade: "A" | "B" | "C" | "D" | "F";
+        score: number;
+        details: string[];
+    };
+}, {
+    architecture: {
+        grade: "A" | "B" | "C" | "D" | "F";
+        score: number;
+        details: string[];
+    };
+    typescript: {
+        grade: "A" | "B" | "C" | "D" | "F";
+        score: number;
+        details: string[];
+    };
+    deadCode: {
+        grade: "A" | "B" | "C" | "D" | "F";
+        score: number;
+        details: string[];
+    };
+    depHygiene: {
+        grade: "A" | "B" | "C" | "D" | "F";
+        score: number;
+        details: string[];
+    };
+    testCoverage: {
+        grade: "A" | "B" | "C" | "D" | "F";
+        score: number;
+        details: string[];
+    };
+}>;
+declare const HealthV2ResponseSchema: z.ZodObject<{
+    score: z.ZodNumber;
+    grade: z.ZodEnum<["A", "B", "C", "D", "F"]>;
+    dimensions: z.ZodObject<{
+        architecture: z.ZodObject<{
+            score: z.ZodNumber;
+            grade: z.ZodEnum<["A", "B", "C", "D", "F"]>;
+            details: z.ZodArray<z.ZodString, "many">;
+        }, "strip", z.ZodTypeAny, {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        }, {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        }>;
+        typescript: z.ZodObject<{
+            score: z.ZodNumber;
+            grade: z.ZodEnum<["A", "B", "C", "D", "F"]>;
+            details: z.ZodArray<z.ZodString, "many">;
+        }, "strip", z.ZodTypeAny, {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        }, {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        }>;
+        deadCode: z.ZodObject<{
+            score: z.ZodNumber;
+            grade: z.ZodEnum<["A", "B", "C", "D", "F"]>;
+            details: z.ZodArray<z.ZodString, "many">;
+        }, "strip", z.ZodTypeAny, {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        }, {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        }>;
+        depHygiene: z.ZodObject<{
+            score: z.ZodNumber;
+            grade: z.ZodEnum<["A", "B", "C", "D", "F"]>;
+            details: z.ZodArray<z.ZodString, "many">;
+        }, "strip", z.ZodTypeAny, {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        }, {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        }>;
+        testCoverage: z.ZodObject<{
+            score: z.ZodNumber;
+            grade: z.ZodEnum<["A", "B", "C", "D", "F"]>;
+            details: z.ZodArray<z.ZodString, "many">;
+        }, "strip", z.ZodTypeAny, {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        }, {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        architecture: {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        };
+        typescript: {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        };
+        deadCode: {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        };
+        depHygiene: {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        };
+        testCoverage: {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        };
+    }, {
+        architecture: {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        };
+        typescript: {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        };
+        deadCode: {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        };
+        depHygiene: {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        };
+        testCoverage: {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        };
+    }>;
+}, "strip", z.ZodTypeAny, {
+    grade: "A" | "B" | "C" | "D" | "F";
+    score: number;
+    dimensions: {
+        architecture: {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        };
+        typescript: {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        };
+        deadCode: {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        };
+        depHygiene: {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        };
+        testCoverage: {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        };
+    };
+}, {
+    grade: "A" | "B" | "C" | "D" | "F";
+    score: number;
+    dimensions: {
+        architecture: {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        };
+        typescript: {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        };
+        deadCode: {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        };
+        depHygiene: {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        };
+        testCoverage: {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        };
+    };
+}>;
+type HealthV2Response = z.infer<typeof HealthV2ResponseSchema>;
+declare const LayeringViolationSchema: z.ZodObject<{
+    file: z.ZodString;
+    fromPackage: z.ZodString;
+    fromLayer: z.ZodNumber;
+    toPackage: z.ZodString;
+    toLayer: z.ZodNumber;
+    importSpecifier: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    file: string;
+    fromPackage: string;
+    fromLayer: number;
+    toPackage: string;
+    toLayer: number;
+    importSpecifier: string;
+}, {
+    file: string;
+    fromPackage: string;
+    fromLayer: number;
+    toPackage: string;
+    toLayer: number;
+    importSpecifier: string;
+}>;
+declare const LayeringResponseSchema: z.ZodObject<{
+    violations: z.ZodArray<z.ZodObject<{
+        file: z.ZodString;
+        fromPackage: z.ZodString;
+        fromLayer: z.ZodNumber;
+        toPackage: z.ZodString;
+        toLayer: z.ZodNumber;
+        importSpecifier: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        file: string;
+        fromPackage: string;
+        fromLayer: number;
+        toPackage: string;
+        toLayer: number;
+        importSpecifier: string;
+    }, {
+        file: string;
+        fromPackage: string;
+        fromLayer: number;
+        toPackage: string;
+        toLayer: number;
+        importSpecifier: string;
+    }>, "many">;
+    totalViolations: z.ZodNumber;
+    affectedPackages: z.ZodArray<z.ZodString, "many">;
+    layerMap: z.ZodRecord<z.ZodString, z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    affectedPackages: string[];
+    violations: {
+        file: string;
+        fromPackage: string;
+        fromLayer: number;
+        toPackage: string;
+        toLayer: number;
+        importSpecifier: string;
+    }[];
+    totalViolations: number;
+    layerMap: Record<string, number>;
+}, {
+    affectedPackages: string[];
+    violations: {
+        file: string;
+        fromPackage: string;
+        fromLayer: number;
+        toPackage: string;
+        toLayer: number;
+        importSpecifier: string;
+    }[];
+    totalViolations: number;
+    layerMap: Record<string, number>;
+}>;
+type LayeringResponse = z.infer<typeof LayeringResponseSchema>;
+declare const PackageCouplingSchema: z.ZodObject<{
+    name: z.ZodString;
+    afferent: z.ZodNumber;
+    efferent: z.ZodNumber;
+    instability: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    afferent: number;
+    efferent: number;
+    instability: number;
+}, {
+    name: string;
+    afferent: number;
+    efferent: number;
+    instability: number;
+}>;
+declare const CouplingResponseSchema: z.ZodObject<{
+    packages: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        afferent: z.ZodNumber;
+        efferent: z.ZodNumber;
+        instability: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        afferent: number;
+        efferent: number;
+        instability: number;
+    }, {
+        name: string;
+        afferent: number;
+        efferent: number;
+        instability: number;
+    }>, "many">;
+    avgInstability: z.ZodNumber;
+    mostUnstable: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        afferent: z.ZodNumber;
+        efferent: z.ZodNumber;
+        instability: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        afferent: number;
+        efferent: number;
+        instability: number;
+    }, {
+        name: string;
+        afferent: number;
+        efferent: number;
+        instability: number;
+    }>, "many">;
+    mostCoupled: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        afferent: z.ZodNumber;
+        efferent: z.ZodNumber;
+        instability: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        afferent: number;
+        efferent: number;
+        instability: number;
+    }, {
+        name: string;
+        afferent: number;
+        efferent: number;
+        instability: number;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    packages: {
+        name: string;
+        afferent: number;
+        efferent: number;
+        instability: number;
+    }[];
+    avgInstability: number;
+    mostUnstable: {
+        name: string;
+        afferent: number;
+        efferent: number;
+        instability: number;
+    }[];
+    mostCoupled: {
+        name: string;
+        afferent: number;
+        efferent: number;
+        instability: number;
+    }[];
+}, {
+    packages: {
+        name: string;
+        afferent: number;
+        efferent: number;
+        instability: number;
+    }[];
+    avgInstability: number;
+    mostUnstable: {
+        name: string;
+        afferent: number;
+        efferent: number;
+        instability: number;
+    }[];
+    mostCoupled: {
+        name: string;
+        afferent: number;
+        efferent: number;
+        instability: number;
+    }[];
+}>;
+type CouplingResponse = z.infer<typeof CouplingResponseSchema>;
+declare const KnipUnusedExportSchema: z.ZodObject<{
+    file: z.ZodString;
+    symbol: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    symbol: string;
+    file: string;
+}, {
+    symbol: string;
+    file: string;
+}>;
+declare const KnipUnusedDependencySchema: z.ZodObject<{
+    package: z.ZodString;
+    workspace: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    package: string;
+    workspace: string;
+}, {
+    package: string;
+    workspace: string;
+}>;
+declare const DeadCodeResponseSchema: z.ZodObject<{
+    unusedFiles: z.ZodArray<z.ZodString, "many">;
+    unusedExports: z.ZodArray<z.ZodObject<{
+        file: z.ZodString;
+        symbol: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        symbol: string;
+        file: string;
+    }, {
+        symbol: string;
+        file: string;
+    }>, "many">;
+    unusedDependencies: z.ZodArray<z.ZodObject<{
+        package: z.ZodString;
+        workspace: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        package: string;
+        workspace: string;
+    }, {
+        package: string;
+        workspace: string;
+    }>, "many">;
+    unlistedDependencies: z.ZodArray<z.ZodObject<{
+        package: z.ZodString;
+        workspace: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        package: string;
+        workspace: string;
+    }, {
+        package: string;
+        workspace: string;
+    }>, "many">;
+    totalIssues: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    totalIssues: number;
+    unusedFiles: string[];
+    unusedExports: {
+        symbol: string;
+        file: string;
+    }[];
+    unusedDependencies: {
+        package: string;
+        workspace: string;
+    }[];
+    unlistedDependencies: {
+        package: string;
+        workspace: string;
+    }[];
+}, {
+    totalIssues: number;
+    unusedFiles: string[];
+    unusedExports: {
+        symbol: string;
+        file: string;
+    }[];
+    unusedDependencies: {
+        package: string;
+        workspace: string;
+    }[];
+    unlistedDependencies: {
+        package: string;
+        workspace: string;
+    }[];
+}>;
+type DeadCodeResponse = z.infer<typeof DeadCodeResponseSchema>;
+declare const QualitySnapshotSchema: z.ZodObject<{
+    id: z.ZodString;
+    timestamp: z.ZodString;
+    git: z.ZodObject<{
+        commit: z.ZodString;
+        branch: z.ZodString;
+        message: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        message: string;
+        commit: string;
+        branch: string;
+    }, {
+        message: string;
+        commit: string;
+        branch: string;
+    }>;
+    score: z.ZodNumber;
+    grade: z.ZodEnum<["A", "B", "C", "D", "F"]>;
+    dimensions: z.ZodObject<{
+        architecture: z.ZodObject<{
+            score: z.ZodNumber;
+            grade: z.ZodEnum<["A", "B", "C", "D", "F"]>;
+            details: z.ZodArray<z.ZodString, "many">;
+        }, "strip", z.ZodTypeAny, {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        }, {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        }>;
+        typescript: z.ZodObject<{
+            score: z.ZodNumber;
+            grade: z.ZodEnum<["A", "B", "C", "D", "F"]>;
+            details: z.ZodArray<z.ZodString, "many">;
+        }, "strip", z.ZodTypeAny, {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        }, {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        }>;
+        deadCode: z.ZodObject<{
+            score: z.ZodNumber;
+            grade: z.ZodEnum<["A", "B", "C", "D", "F"]>;
+            details: z.ZodArray<z.ZodString, "many">;
+        }, "strip", z.ZodTypeAny, {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        }, {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        }>;
+        depHygiene: z.ZodObject<{
+            score: z.ZodNumber;
+            grade: z.ZodEnum<["A", "B", "C", "D", "F"]>;
+            details: z.ZodArray<z.ZodString, "many">;
+        }, "strip", z.ZodTypeAny, {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        }, {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        }>;
+        testCoverage: z.ZodObject<{
+            score: z.ZodNumber;
+            grade: z.ZodEnum<["A", "B", "C", "D", "F"]>;
+            details: z.ZodArray<z.ZodString, "many">;
+        }, "strip", z.ZodTypeAny, {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        }, {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        architecture: {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        };
+        typescript: {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        };
+        deadCode: {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        };
+        depHygiene: {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        };
+        testCoverage: {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        };
+    }, {
+        architecture: {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        };
+        typescript: {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        };
+        deadCode: {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        };
+        depHygiene: {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        };
+        testCoverage: {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        };
+    }>;
+    counters: z.ZodObject<{
+        layeringViolations: z.ZodNumber;
+        avgInstability: z.ZodNumber;
+        anyCount: z.ZodNumber;
+        tsIgnoreCount: z.ZodNumber;
+        unusedFiles: z.ZodNumber;
+        unusedDeps: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        avgInstability: number;
+        unusedFiles: number;
+        layeringViolations: number;
+        anyCount: number;
+        tsIgnoreCount: number;
+        unusedDeps: number;
+    }, {
+        avgInstability: number;
+        unusedFiles: number;
+        layeringViolations: number;
+        anyCount: number;
+        tsIgnoreCount: number;
+        unusedDeps: number;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    grade: "A" | "B" | "C" | "D" | "F";
+    score: number;
+    dimensions: {
+        architecture: {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        };
+        typescript: {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        };
+        deadCode: {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        };
+        depHygiene: {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        };
+        testCoverage: {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        };
+    };
+    id: string;
+    timestamp: string;
+    git: {
+        message: string;
+        commit: string;
+        branch: string;
+    };
+    counters: {
+        avgInstability: number;
+        unusedFiles: number;
+        layeringViolations: number;
+        anyCount: number;
+        tsIgnoreCount: number;
+        unusedDeps: number;
+    };
+}, {
+    grade: "A" | "B" | "C" | "D" | "F";
+    score: number;
+    dimensions: {
+        architecture: {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        };
+        typescript: {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        };
+        deadCode: {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        };
+        depHygiene: {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        };
+        testCoverage: {
+            grade: "A" | "B" | "C" | "D" | "F";
+            score: number;
+            details: string[];
+        };
+    };
+    id: string;
+    timestamp: string;
+    git: {
+        message: string;
+        commit: string;
+        branch: string;
+    };
+    counters: {
+        avgInstability: number;
+        unusedFiles: number;
+        layeringViolations: number;
+        anyCount: number;
+        tsIgnoreCount: number;
+        unusedDeps: number;
+    };
+}>;
+declare const SnapshotDeltaSchema: z.ZodObject<{
+    score: z.ZodNumber;
+    layeringViolations: z.ZodNumber;
+    anyCount: z.ZodNumber;
+    tsIgnoreCount: z.ZodNumber;
+    unusedFiles: z.ZodNumber;
+    unusedDeps: z.ZodNumber;
+    avgInstability: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    score: number;
+    avgInstability: number;
+    unusedFiles: number;
+    layeringViolations: number;
+    anyCount: number;
+    tsIgnoreCount: number;
+    unusedDeps: number;
+}, {
+    score: number;
+    avgInstability: number;
+    unusedFiles: number;
+    layeringViolations: number;
+    anyCount: number;
+    tsIgnoreCount: number;
+    unusedDeps: number;
+}>;
+declare const HistoryResponseSchema: z.ZodObject<{
+    snapshots: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        timestamp: z.ZodString;
+        git: z.ZodObject<{
+            commit: z.ZodString;
+            branch: z.ZodString;
+            message: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            message: string;
+            commit: string;
+            branch: string;
+        }, {
+            message: string;
+            commit: string;
+            branch: string;
+        }>;
+        score: z.ZodNumber;
+        grade: z.ZodEnum<["A", "B", "C", "D", "F"]>;
+        dimensions: z.ZodObject<{
+            architecture: z.ZodObject<{
+                score: z.ZodNumber;
+                grade: z.ZodEnum<["A", "B", "C", "D", "F"]>;
+                details: z.ZodArray<z.ZodString, "many">;
+            }, "strip", z.ZodTypeAny, {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            }, {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            }>;
+            typescript: z.ZodObject<{
+                score: z.ZodNumber;
+                grade: z.ZodEnum<["A", "B", "C", "D", "F"]>;
+                details: z.ZodArray<z.ZodString, "many">;
+            }, "strip", z.ZodTypeAny, {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            }, {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            }>;
+            deadCode: z.ZodObject<{
+                score: z.ZodNumber;
+                grade: z.ZodEnum<["A", "B", "C", "D", "F"]>;
+                details: z.ZodArray<z.ZodString, "many">;
+            }, "strip", z.ZodTypeAny, {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            }, {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            }>;
+            depHygiene: z.ZodObject<{
+                score: z.ZodNumber;
+                grade: z.ZodEnum<["A", "B", "C", "D", "F"]>;
+                details: z.ZodArray<z.ZodString, "many">;
+            }, "strip", z.ZodTypeAny, {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            }, {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            }>;
+            testCoverage: z.ZodObject<{
+                score: z.ZodNumber;
+                grade: z.ZodEnum<["A", "B", "C", "D", "F"]>;
+                details: z.ZodArray<z.ZodString, "many">;
+            }, "strip", z.ZodTypeAny, {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            }, {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            architecture: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+            typescript: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+            deadCode: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+            depHygiene: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+            testCoverage: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+        }, {
+            architecture: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+            typescript: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+            deadCode: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+            depHygiene: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+            testCoverage: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+        }>;
+        counters: z.ZodObject<{
+            layeringViolations: z.ZodNumber;
+            avgInstability: z.ZodNumber;
+            anyCount: z.ZodNumber;
+            tsIgnoreCount: z.ZodNumber;
+            unusedFiles: z.ZodNumber;
+            unusedDeps: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            avgInstability: number;
+            unusedFiles: number;
+            layeringViolations: number;
+            anyCount: number;
+            tsIgnoreCount: number;
+            unusedDeps: number;
+        }, {
+            avgInstability: number;
+            unusedFiles: number;
+            layeringViolations: number;
+            anyCount: number;
+            tsIgnoreCount: number;
+            unusedDeps: number;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        grade: "A" | "B" | "C" | "D" | "F";
+        score: number;
+        dimensions: {
+            architecture: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+            typescript: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+            deadCode: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+            depHygiene: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+            testCoverage: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+        };
+        id: string;
+        timestamp: string;
+        git: {
+            message: string;
+            commit: string;
+            branch: string;
+        };
+        counters: {
+            avgInstability: number;
+            unusedFiles: number;
+            layeringViolations: number;
+            anyCount: number;
+            tsIgnoreCount: number;
+            unusedDeps: number;
+        };
+    }, {
+        grade: "A" | "B" | "C" | "D" | "F";
+        score: number;
+        dimensions: {
+            architecture: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+            typescript: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+            deadCode: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+            depHygiene: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+            testCoverage: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+        };
+        id: string;
+        timestamp: string;
+        git: {
+            message: string;
+            commit: string;
+            branch: string;
+        };
+        counters: {
+            avgInstability: number;
+            unusedFiles: number;
+            layeringViolations: number;
+            anyCount: number;
+            tsIgnoreCount: number;
+            unusedDeps: number;
+        };
+    }>, "many">;
+    delta: z.ZodNullable<z.ZodObject<{
+        score: z.ZodNumber;
+        layeringViolations: z.ZodNumber;
+        anyCount: z.ZodNumber;
+        tsIgnoreCount: z.ZodNumber;
+        unusedFiles: z.ZodNumber;
+        unusedDeps: z.ZodNumber;
+        avgInstability: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        score: number;
+        avgInstability: number;
+        unusedFiles: number;
+        layeringViolations: number;
+        anyCount: number;
+        tsIgnoreCount: number;
+        unusedDeps: number;
+    }, {
+        score: number;
+        avgInstability: number;
+        unusedFiles: number;
+        layeringViolations: number;
+        anyCount: number;
+        tsIgnoreCount: number;
+        unusedDeps: number;
+    }>>;
+    latest: z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        timestamp: z.ZodString;
+        git: z.ZodObject<{
+            commit: z.ZodString;
+            branch: z.ZodString;
+            message: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            message: string;
+            commit: string;
+            branch: string;
+        }, {
+            message: string;
+            commit: string;
+            branch: string;
+        }>;
+        score: z.ZodNumber;
+        grade: z.ZodEnum<["A", "B", "C", "D", "F"]>;
+        dimensions: z.ZodObject<{
+            architecture: z.ZodObject<{
+                score: z.ZodNumber;
+                grade: z.ZodEnum<["A", "B", "C", "D", "F"]>;
+                details: z.ZodArray<z.ZodString, "many">;
+            }, "strip", z.ZodTypeAny, {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            }, {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            }>;
+            typescript: z.ZodObject<{
+                score: z.ZodNumber;
+                grade: z.ZodEnum<["A", "B", "C", "D", "F"]>;
+                details: z.ZodArray<z.ZodString, "many">;
+            }, "strip", z.ZodTypeAny, {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            }, {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            }>;
+            deadCode: z.ZodObject<{
+                score: z.ZodNumber;
+                grade: z.ZodEnum<["A", "B", "C", "D", "F"]>;
+                details: z.ZodArray<z.ZodString, "many">;
+            }, "strip", z.ZodTypeAny, {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            }, {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            }>;
+            depHygiene: z.ZodObject<{
+                score: z.ZodNumber;
+                grade: z.ZodEnum<["A", "B", "C", "D", "F"]>;
+                details: z.ZodArray<z.ZodString, "many">;
+            }, "strip", z.ZodTypeAny, {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            }, {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            }>;
+            testCoverage: z.ZodObject<{
+                score: z.ZodNumber;
+                grade: z.ZodEnum<["A", "B", "C", "D", "F"]>;
+                details: z.ZodArray<z.ZodString, "many">;
+            }, "strip", z.ZodTypeAny, {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            }, {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            architecture: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+            typescript: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+            deadCode: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+            depHygiene: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+            testCoverage: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+        }, {
+            architecture: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+            typescript: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+            deadCode: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+            depHygiene: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+            testCoverage: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+        }>;
+        counters: z.ZodObject<{
+            layeringViolations: z.ZodNumber;
+            avgInstability: z.ZodNumber;
+            anyCount: z.ZodNumber;
+            tsIgnoreCount: z.ZodNumber;
+            unusedFiles: z.ZodNumber;
+            unusedDeps: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            avgInstability: number;
+            unusedFiles: number;
+            layeringViolations: number;
+            anyCount: number;
+            tsIgnoreCount: number;
+            unusedDeps: number;
+        }, {
+            avgInstability: number;
+            unusedFiles: number;
+            layeringViolations: number;
+            anyCount: number;
+            tsIgnoreCount: number;
+            unusedDeps: number;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        grade: "A" | "B" | "C" | "D" | "F";
+        score: number;
+        dimensions: {
+            architecture: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+            typescript: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+            deadCode: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+            depHygiene: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+            testCoverage: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+        };
+        id: string;
+        timestamp: string;
+        git: {
+            message: string;
+            commit: string;
+            branch: string;
+        };
+        counters: {
+            avgInstability: number;
+            unusedFiles: number;
+            layeringViolations: number;
+            anyCount: number;
+            tsIgnoreCount: number;
+            unusedDeps: number;
+        };
+    }, {
+        grade: "A" | "B" | "C" | "D" | "F";
+        score: number;
+        dimensions: {
+            architecture: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+            typescript: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+            deadCode: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+            depHygiene: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+            testCoverage: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+        };
+        id: string;
+        timestamp: string;
+        git: {
+            message: string;
+            commit: string;
+            branch: string;
+        };
+        counters: {
+            avgInstability: number;
+            unusedFiles: number;
+            layeringViolations: number;
+            anyCount: number;
+            tsIgnoreCount: number;
+            unusedDeps: number;
+        };
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    snapshots: {
+        grade: "A" | "B" | "C" | "D" | "F";
+        score: number;
+        dimensions: {
+            architecture: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+            typescript: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+            deadCode: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+            depHygiene: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+            testCoverage: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+        };
+        id: string;
+        timestamp: string;
+        git: {
+            message: string;
+            commit: string;
+            branch: string;
+        };
+        counters: {
+            avgInstability: number;
+            unusedFiles: number;
+            layeringViolations: number;
+            anyCount: number;
+            tsIgnoreCount: number;
+            unusedDeps: number;
+        };
+    }[];
+    delta: {
+        score: number;
+        avgInstability: number;
+        unusedFiles: number;
+        layeringViolations: number;
+        anyCount: number;
+        tsIgnoreCount: number;
+        unusedDeps: number;
+    } | null;
+    latest: {
+        grade: "A" | "B" | "C" | "D" | "F";
+        score: number;
+        dimensions: {
+            architecture: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+            typescript: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+            deadCode: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+            depHygiene: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+            testCoverage: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+        };
+        id: string;
+        timestamp: string;
+        git: {
+            message: string;
+            commit: string;
+            branch: string;
+        };
+        counters: {
+            avgInstability: number;
+            unusedFiles: number;
+            layeringViolations: number;
+            anyCount: number;
+            tsIgnoreCount: number;
+            unusedDeps: number;
+        };
+    } | null;
+}, {
+    snapshots: {
+        grade: "A" | "B" | "C" | "D" | "F";
+        score: number;
+        dimensions: {
+            architecture: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+            typescript: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+            deadCode: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+            depHygiene: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+            testCoverage: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+        };
+        id: string;
+        timestamp: string;
+        git: {
+            message: string;
+            commit: string;
+            branch: string;
+        };
+        counters: {
+            avgInstability: number;
+            unusedFiles: number;
+            layeringViolations: number;
+            anyCount: number;
+            tsIgnoreCount: number;
+            unusedDeps: number;
+        };
+    }[];
+    delta: {
+        score: number;
+        avgInstability: number;
+        unusedFiles: number;
+        layeringViolations: number;
+        anyCount: number;
+        tsIgnoreCount: number;
+        unusedDeps: number;
+    } | null;
+    latest: {
+        grade: "A" | "B" | "C" | "D" | "F";
+        score: number;
+        dimensions: {
+            architecture: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+            typescript: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+            deadCode: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+            depHygiene: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+            testCoverage: {
+                grade: "A" | "B" | "C" | "D" | "F";
+                score: number;
+                details: string[];
+            };
+        };
+        id: string;
+        timestamp: string;
+        git: {
+            message: string;
+            commit: string;
+            branch: string;
+        };
+        counters: {
+            avgInstability: number;
+            unusedFiles: number;
+            layeringViolations: number;
+            anyCount: number;
+            tsIgnoreCount: number;
+            unusedDeps: number;
+        };
+    } | null;
+}>;
+type HistoryResponse = z.infer<typeof HistoryResponseSchema>;
 
-export { type AliveReason, type BuildCheckResult, type BuildOrderRequest, BuildOrderRequestSchema, type BuildOrderResponse, BuildOrderResponseSchema, CACHE_KEYS, type CyclesRequest, CyclesRequestSchema, type CyclesResponse, CyclesResponseSchema, DEFAULT_TIMEOUTS, type DeadCodeBackupManifest, type DeadCodeOptions, type DeadCodeRemovalResult, type DeadCodeResult, type DeadFile, type DependenciesRequest, DependenciesRequestSchema, type DependenciesResponse, DependenciesResponseSchema, type DependencyStats, type DuplicateDependency, DuplicateDependencySchema, type GraphMode, GraphModeSchema, type GraphNode, GraphNodeSchema, type GraphRequest, GraphRequestSchema, type GraphResponse, GraphResponseSchema, type GraphStats, GraphStatsSchema, HEALTH_GRADES, type HealthIssue, HealthIssueSchema, type HealthRequest, HealthRequestSchema, type HealthResponse, HealthResponseSchema, type HealthScore, type Issue, type IssueSeverity, type MissingDependency, MissingDependencySchema, type PackageDeadCodeResult, type PackageInfo, type PackageStats, QUALITY_BASE_PATH, QUALITY_CACHE_PREFIX, QUALITY_ENV_VARS, QUALITY_FULL_ROUTES, QUALITY_ROUTES, type QualityRoute, type Recommendation, type RepositoryInfo, type RepositoryStats, type StaleChain, StaleChainSchema, type StalePackage, StalePackageSchema, type StaleRequest, StaleRequestSchema, type StaleResponse, StaleResponseSchema, type StatsRequest, StatsRequestSchema, type StatsResponse, StatsResponseSchema, type StatsResult, type TestRunResult, type TypeAnalysisResult, type UnusedDependency, UnusedDependencySchema, type VersionInfo, VersionInfoSchema };
+export { type AliveReason, type BuildCheckResult, type BuildOrderRequest, BuildOrderRequestSchema, type BuildOrderResponse, BuildOrderResponseSchema, CACHE_KEYS, CACHE_TTLS, type CouplingReport, type CouplingResponse, CouplingResponseSchema, type CyclesRequest, CyclesRequestSchema, type CyclesResponse, CyclesResponseSchema, DEFAULT_TIMEOUTS, DIMENSION_WEIGHTS, type DeadCodeBackupManifest, type DeadCodeOptions, type DeadCodeRemovalResult, type DeadCodeResponse, DeadCodeResponseSchema, type DeadCodeResult, type DeadFile, type DependenciesRequest, DependenciesRequestSchema, type DependenciesResponse, DependenciesResponseSchema, type DependencyStats, type DimensionScore, DimensionScoreSchema, type DimensionScores, DimensionScoresSchema, type DuplicateDependency, DuplicateDependencySchema, type GraphMode, GraphModeSchema, type GraphNode, GraphNodeSchema, type GraphRequest, GraphRequestSchema, type GraphResponse, GraphResponseSchema, type GraphStats, GraphStatsSchema, HEALTH_GRADES, type HealthIssue, HealthIssueSchema, type HealthRequest, HealthRequestSchema, type HealthResponse, HealthResponseSchema, type HealthScore, type HealthV2Response, HealthV2ResponseSchema, type HistoryResponse, HistoryResponseSchema, type Issue, type IssueSeverity, type KnipReport, type KnipUnusedDependency, KnipUnusedDependencySchema, type KnipUnusedExport, KnipUnusedExportSchema, type LayeringReport, type LayeringResponse, LayeringResponseSchema, type LayeringViolation, LayeringViolationSchema, MAX_SNAPSHOTS_DEFAULT, type MissingDependency, MissingDependencySchema, type PackageCoupling, PackageCouplingSchema, type PackageDeadCodeResult, type PackageInfo, type PackageStats, QUALITY_BASE_PATH, QUALITY_CACHE_PREFIX, QUALITY_ENV_VARS, QUALITY_FULL_ROUTES, QUALITY_ROUTES, type QualityKnipConfig, type QualityLayerMap, type QualityPluginConfig, type QualityRoute, type QualitySnapshot, QualitySnapshotSchema, type QualityThresholds, type Recommendation, type RepositoryInfo, type RepositoryStats, SNAPSHOT_DIR, SNAPSHOT_FILE, type SnapshotDelta, SnapshotDeltaSchema, type SnapshotHistory, type StaleChain, StaleChainSchema, type StalePackage, StalePackageSchema, type StaleRequest, StaleRequestSchema, type StaleResponse, StaleResponseSchema, type StatsRequest, StatsRequestSchema, type StatsResponse, StatsResponseSchema, type StatsResult, type TestRunResult, type TypeAnalysisResult, type UnusedDependency, UnusedDependencySchema, type VersionInfo, VersionInfoSchema, defaultQualityConfig };