@kb-labs/quality-contracts 0.6.0

package/dist/index.js

@@ -0,0 +1,210 @@
+import { z } from 'zod';
+
+// src/constants.ts
+var QUALITY_ENV_VARS = [
+  "KB_QUALITY_CACHE_TTL",
+  "KB_QUALITY_MAX_PACKAGES"
+];
+var QUALITY_CACHE_PREFIX = "quality:";
+var CACHE_KEYS = {
+  STATS: "quality:stats",
+  HEALTH: "quality:health",
+  IMPORTS: "quality:imports",
+  EXPORTS: "quality:exports",
+  TYPES: "quality:types",
+  DUPLICATES: "quality:duplicates",
+  BUILDS: "quality:builds",
+  TYPE_ANALYSIS: "quality:type-analysis",
+  TESTS: "quality:tests",
+  DEAD_CODE: "quality:dead-code"
+};
+var DEFAULT_TIMEOUTS = {
+  STATS: 6e4,
+  // 1 min
+  HEALTH: 12e4,
+  // 2 min
+  CHECK_IMPORTS: 6e4,
+  // 1 min
+  CHECK_EXPORTS: 6e4,
+  // 1 min
+  CHECK_TYPES: 9e4,
+  // 1.5 min
+  TYPES_AUDIT: 18e4,
+  // 3 min
+  FIX_DEPS: 3e5,
+  // 5 min
+  CI: 6e5,
+  // 10 min
+  DEAD_CODE: 12e4
+  // 2 min
+};
+var HEALTH_GRADES = {
+  A: { min: 90, max: 100, label: "Excellent" },
+  B: { min: 80, max: 89, label: "Good" },
+  C: { min: 70, max: 79, label: "Fair" },
+  D: { min: 60, max: 69, label: "Poor" },
+  F: { min: 0, max: 59, label: "Failing" }
+};
+
+// src/routes.ts
+var QUALITY_BASE_PATH = "/v1/plugins/quality";
+var QUALITY_ROUTES = {
+  /** GET /stats - Get monorepo statistics */
+  STATS: "/stats",
+  /** GET /health - Get health score */
+  HEALTH: "/health",
+  /** GET /dependencies - Get dependency issues */
+  DEPENDENCIES: "/dependencies",
+  /** GET /build-order - Get build order */
+  BUILD_ORDER: "/build-order",
+  /** GET /cycles - Get circular dependencies */
+  CYCLES: "/cycles",
+  /** GET /graph - Get dependency graph */
+  GRAPH: "/graph",
+  /** GET /stale - Get stale packages */
+  STALE: "/stale",
+  /** GET /builds - Get build status */
+  BUILDS: "/builds",
+  /** GET /types - Get type safety analysis */
+  TYPES: "/types",
+  /** GET /tests - Get test results and coverage */
+  TESTS: "/tests"
+};
+var QUALITY_FULL_ROUTES = {
+  STATS: `${QUALITY_BASE_PATH}${QUALITY_ROUTES.STATS}`,
+  HEALTH: `${QUALITY_BASE_PATH}${QUALITY_ROUTES.HEALTH}`,
+  DEPENDENCIES: `${QUALITY_BASE_PATH}${QUALITY_ROUTES.DEPENDENCIES}`,
+  BUILD_ORDER: `${QUALITY_BASE_PATH}${QUALITY_ROUTES.BUILD_ORDER}`,
+  CYCLES: `${QUALITY_BASE_PATH}${QUALITY_ROUTES.CYCLES}`,
+  GRAPH: `${QUALITY_BASE_PATH}${QUALITY_ROUTES.GRAPH}`,
+  STALE: `${QUALITY_BASE_PATH}${QUALITY_ROUTES.STALE}`,
+  BUILDS: `${QUALITY_BASE_PATH}${QUALITY_ROUTES.BUILDS}`,
+  TYPES: `${QUALITY_BASE_PATH}${QUALITY_ROUTES.TYPES}`,
+  TESTS: `${QUALITY_BASE_PATH}${QUALITY_ROUTES.TESTS}`
+};
+var StatsRequestSchema = z.object({
+  includeHealth: z.boolean().optional()
+});
+var StatsResponseSchema = z.object({
+  packages: z.number(),
+  loc: z.number(),
+  size: z.string(),
+  health: z.number().optional(),
+  grade: z.string().optional()
+});
+var HealthRequestSchema = z.object({
+  detailed: z.boolean().optional()
+});
+var HealthIssueSchema = z.object({
+  type: z.string(),
+  severity: z.number(),
+  description: z.string(),
+  packages: z.array(z.string()).optional(),
+  count: z.number().optional()
+});
+var HealthResponseSchema = z.object({
+  score: z.number(),
+  grade: z.string(),
+  issues: z.array(HealthIssueSchema).optional()
+});
+var DependenciesRequestSchema = z.object({});
+var VersionInfoSchema = z.object({
+  version: z.string(),
+  packages: z.array(z.string()),
+  count: z.number()
+});
+var DuplicateDependencySchema = z.object({
+  name: z.string(),
+  versions: z.array(VersionInfoSchema),
+  totalPackages: z.number()
+});
+var UnusedDependencySchema = z.object({
+  name: z.string(),
+  packages: z.array(z.string())
+});
+var MissingDependencySchema = z.object({
+  name: z.string(),
+  packages: z.array(z.string()),
+  importedIn: z.array(z.string())
+});
+var DependenciesResponseSchema = z.object({
+  duplicates: z.array(DuplicateDependencySchema),
+  unused: z.array(UnusedDependencySchema),
+  missing: z.array(MissingDependencySchema),
+  totalIssues: z.number()
+});
+var BuildOrderRequestSchema = z.object({
+  packageName: z.string().optional()
+});
+var BuildOrderResponseSchema = z.object({
+  layers: z.array(z.array(z.string())),
+  sorted: z.array(z.string()),
+  circular: z.array(z.array(z.string())),
+  packageCount: z.number(),
+  layerCount: z.number(),
+  hasCircular: z.boolean()
+});
+var CyclesRequestSchema = z.object({});
+var CyclesResponseSchema = z.object({
+  cycles: z.array(z.array(z.string())),
+  count: z.number(),
+  hasCircular: z.boolean(),
+  affected: z.array(z.string())
+});
+var GraphModeSchema = z.enum(["tree", "reverse", "impact", "stats"]);
+var GraphRequestSchema = z.object({
+  packageName: z.string().optional(),
+  mode: GraphModeSchema
+});
+var GraphNodeSchema = z.lazy(
+  () => z.object({
+    name: z.string(),
+    children: z.array(GraphNodeSchema).optional()
+  })
+);
+var GraphStatsSchema = z.object({
+  totalPackages: z.number(),
+  maxDepth: z.number(),
+  avgDependencies: z.number(),
+  mostDepended: z.array(
+    z.object({
+      name: z.string(),
+      count: z.number()
+    })
+  )
+});
+var GraphResponseSchema = z.object({
+  mode: GraphModeSchema,
+  packageName: z.string().optional(),
+  tree: GraphNodeSchema.optional(),
+  packages: z.array(z.string()).optional(),
+  stats: GraphStatsSchema.optional()
+});
+var StaleRequestSchema = z.object({
+  detailed: z.boolean().optional()
+});
+var StalePackageSchema = z.object({
+  name: z.string(),
+  path: z.string(),
+  reason: z.enum(["source-newer", "dependency-rebuilt", "missing-dist"]),
+  sourceModified: z.string().optional(),
+  distModified: z.string().optional(),
+  affectedPackages: z.array(z.string()),
+  affectedCount: z.number(),
+  severity: z.enum(["critical", "high", "medium", "low"])
+});
+var StaleChainSchema = z.object({
+  root: z.string(),
+  affected: z.array(z.string()),
+  depth: z.number()
+});
+var StaleResponseSchema = z.object({
+  stalePackages: z.array(StalePackageSchema),
+  totalStale: z.number(),
+  totalAffected: z.number(),
+  criticalChains: z.array(StaleChainSchema).optional()
+});
+
+export { BuildOrderRequestSchema, BuildOrderResponseSchema, CACHE_KEYS, CyclesRequestSchema, CyclesResponseSchema, DEFAULT_TIMEOUTS, DependenciesRequestSchema, DependenciesResponseSchema, DuplicateDependencySchema, GraphModeSchema, GraphNodeSchema, GraphRequestSchema, GraphResponseSchema, GraphStatsSchema, HEALTH_GRADES, HealthIssueSchema, HealthRequestSchema, HealthResponseSchema, MissingDependencySchema, QUALITY_BASE_PATH, QUALITY_CACHE_PREFIX, QUALITY_ENV_VARS, QUALITY_FULL_ROUTES, QUALITY_ROUTES, StaleChainSchema, StalePackageSchema, StaleRequestSchema, StaleResponseSchema, StatsRequestSchema, StatsResponseSchema, UnusedDependencySchema, VersionInfoSchema };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/constants.ts","../src/routes.ts","../src/types/rest-api.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Constants for Quality Plugin\n */\n\n/**\n * Environment variables\n */\nexport const QUALITY_ENV_VARS = [\n  'KB_QUALITY_CACHE_TTL',\n  'KB_QUALITY_MAX_PACKAGES',\n] as const;\n\n/**\n * Cache namespace prefix\n */\nexport const QUALITY_CACHE_PREFIX = 'quality:';\n\n/**\n * Cache keys\n */\nexport const CACHE_KEYS = {\n  STATS: 'quality:stats',\n  HEALTH: 'quality:health',\n  IMPORTS: 'quality:imports',\n  EXPORTS: 'quality:exports',\n  TYPES: 'quality:types',\n  DUPLICATES: 'quality:duplicates',\n  BUILDS: 'quality:builds',\n  TYPE_ANALYSIS: 'quality:type-analysis',\n  TESTS: 'quality:tests',\n  DEAD_CODE: 'quality:dead-code',\n} as const;\n\n/**\n * Default timeouts (milliseconds)\n */\nexport const DEFAULT_TIMEOUTS = {\n  STATS: 60000, // 1 min\n  HEALTH: 120000, // 2 min\n  CHECK_IMPORTS: 60000, // 1 min\n  CHECK_EXPORTS: 60000, // 1 min\n  CHECK_TYPES: 90000, // 1.5 min\n  TYPES_AUDIT: 180000, // 3 min\n  FIX_DEPS: 300000, // 5 min\n  CI: 600000, // 10 min\n  DEAD_CODE: 120000, // 2 min\n} as const;\n\n/**\n * Health score grades\n */\nexport const HEALTH_GRADES = {\n  A: { min: 90, max: 100, label: 'Excellent' },\n  B: { min: 80, max: 89, label: 'Good' },\n  C: { min: 70, max: 79, label: 'Fair' },\n  D: { min: 60, max: 69, label: 'Poor' },\n  F: { min: 0, max: 59, label: 'Failing' },\n} as const;\n","/**\n * @module @kb-labs/quality-contracts/routes\n * REST API route constants for quality plugin\n */\n\n/**\n * REST API base path for quality plugin\n */\nexport const QUALITY_BASE_PATH = '/v1/plugins/quality' as const;\n\n/**\n * REST API route paths (relative to basePath)\n */\nexport const QUALITY_ROUTES = {\n  /** GET /stats - Get monorepo statistics */\n  STATS: '/stats',\n\n  /** GET /health - Get health score */\n  HEALTH: '/health',\n\n  /** GET /dependencies - Get dependency issues */\n  DEPENDENCIES: '/dependencies',\n\n  /** GET /build-order - Get build order */\n  BUILD_ORDER: '/build-order',\n\n  /** GET /cycles - Get circular dependencies */\n  CYCLES: '/cycles',\n\n  /** GET /graph - Get dependency graph */\n  GRAPH: '/graph',\n\n  /** GET /stale - Get stale packages */\n  STALE: '/stale',\n\n  /** GET /builds - Get build status */\n  BUILDS: '/builds',\n\n  /** GET /types - Get type safety analysis */\n  TYPES: '/types',\n\n  /** GET /tests - Get test results and coverage */\n  TESTS: '/tests',\n} as const;\n\n/**\n * Full REST API URLs (basePath + route)\n * Useful for testing and documentation\n */\nexport const QUALITY_FULL_ROUTES = {\n  STATS: `${QUALITY_BASE_PATH}${QUALITY_ROUTES.STATS}`,\n  HEALTH: `${QUALITY_BASE_PATH}${QUALITY_ROUTES.HEALTH}`,\n  DEPENDENCIES: `${QUALITY_BASE_PATH}${QUALITY_ROUTES.DEPENDENCIES}`,\n  BUILD_ORDER: `${QUALITY_BASE_PATH}${QUALITY_ROUTES.BUILD_ORDER}`,\n  CYCLES: `${QUALITY_BASE_PATH}${QUALITY_ROUTES.CYCLES}`,\n  GRAPH: `${QUALITY_BASE_PATH}${QUALITY_ROUTES.GRAPH}`,\n  STALE: `${QUALITY_BASE_PATH}${QUALITY_ROUTES.STALE}`,\n  BUILDS: `${QUALITY_BASE_PATH}${QUALITY_ROUTES.BUILDS}`,\n  TYPES: `${QUALITY_BASE_PATH}${QUALITY_ROUTES.TYPES}`,\n  TESTS: `${QUALITY_BASE_PATH}${QUALITY_ROUTES.TESTS}`,\n} as const;\n\nexport type QualityRoute = typeof QUALITY_ROUTES[keyof typeof QUALITY_ROUTES];\n","/**\n * REST API Request/Response Types and Zod Schemas for Quality Plugin\n */\n\nimport { z } from 'zod';\n\n// ============================================================================\n// Stats API\n// ============================================================================\n\nexport const StatsRequestSchema = z.object({\n  includeHealth: z.boolean().optional(),\n});\n\nexport type StatsRequest = z.infer<typeof StatsRequestSchema>;\n\nexport const StatsResponseSchema = z.object({\n  packages: z.number(),\n  loc: z.number(),\n  size: z.string(),\n  health: z.number().optional(),\n  grade: z.string().optional(),\n});\n\nexport type StatsResponse = z.infer<typeof StatsResponseSchema>;\n\n// ============================================================================\n// Health API\n// ============================================================================\n\nexport const HealthRequestSchema = z.object({\n  detailed: z.boolean().optional(),\n});\n\nexport type HealthRequest = z.infer<typeof HealthRequestSchema>;\n\nexport const HealthIssueSchema = z.object({\n  type: z.string(),\n  severity: z.number(),\n  description: z.string(),\n  packages: z.array(z.string()).optional(),\n  count: z.number().optional(),\n});\n\nexport type HealthIssue = z.infer<typeof HealthIssueSchema>;\n\nexport const HealthResponseSchema = z.object({\n  score: z.number(),\n  grade: z.string(),\n  issues: z.array(HealthIssueSchema).optional(),\n});\n\nexport type HealthResponse = z.infer<typeof HealthResponseSchema>;\n\n// ============================================================================\n// Dependencies API\n// ============================================================================\n\nexport const DependenciesRequestSchema = z.object({});\n\nexport type DependenciesRequest = z.infer<typeof DependenciesRequestSchema>;\n\nexport const VersionInfoSchema = z.object({\n  version: z.string(),\n  packages: z.array(z.string()),\n  count: z.number(),\n});\n\nexport type VersionInfo = z.infer<typeof VersionInfoSchema>;\n\nexport const DuplicateDependencySchema = z.object({\n  name: z.string(),\n  versions: z.array(VersionInfoSchema),\n  totalPackages: z.number(),\n});\n\nexport type DuplicateDependency = z.infer<typeof DuplicateDependencySchema>;\n\nexport const UnusedDependencySchema = z.object({\n  name: z.string(),\n  packages: z.array(z.string()),\n});\n\nexport type UnusedDependency = z.infer<typeof UnusedDependencySchema>;\n\nexport const MissingDependencySchema = z.object({\n  name: z.string(),\n  packages: z.array(z.string()),\n  importedIn: z.array(z.string()),\n});\n\nexport type MissingDependency = z.infer<typeof MissingDependencySchema>;\n\nexport const DependenciesResponseSchema = z.object({\n  duplicates: z.array(DuplicateDependencySchema),\n  unused: z.array(UnusedDependencySchema),\n  missing: z.array(MissingDependencySchema),\n  totalIssues: z.number(),\n});\n\nexport type DependenciesResponse = z.infer<typeof DependenciesResponseSchema>;\n\n// ============================================================================\n// Build Order API\n// ============================================================================\n\nexport const BuildOrderRequestSchema = z.object({\n  packageName: z.string().optional(),\n});\n\nexport type BuildOrderRequest = z.infer<typeof BuildOrderRequestSchema>;\n\nexport const BuildOrderResponseSchema = z.object({\n  layers: z.array(z.array(z.string())),\n  sorted: z.array(z.string()),\n  circular: z.array(z.array(z.string())),\n  packageCount: z.number(),\n  layerCount: z.number(),\n  hasCircular: z.boolean(),\n});\n\nexport type BuildOrderResponse = z.infer<typeof BuildOrderResponseSchema>;\n\n// ============================================================================\n// Cycles API\n// ============================================================================\n\nexport const CyclesRequestSchema = z.object({});\n\nexport type CyclesRequest = z.infer<typeof CyclesRequestSchema>;\n\nexport const CyclesResponseSchema = z.object({\n  cycles: z.array(z.array(z.string())),\n  count: z.number(),\n  hasCircular: z.boolean(),\n  affected: z.array(z.string()),\n});\n\nexport type CyclesResponse = z.infer<typeof CyclesResponseSchema>;\n\n// ============================================================================\n// Graph API\n// ============================================================================\n\nexport const GraphModeSchema = z.enum(['tree', 'reverse', 'impact', 'stats']);\n\nexport type GraphMode = z.infer<typeof GraphModeSchema>;\n\nexport const GraphRequestSchema = z.object({\n  packageName: z.string().optional(),\n  mode: GraphModeSchema,\n});\n\nexport type GraphRequest = z.infer<typeof GraphRequestSchema>;\n\nexport const GraphNodeSchema: z.ZodType<GraphNode> = z.lazy(() =>\n  z.object({\n    name: z.string(),\n    children: z.array(GraphNodeSchema).optional(),\n  })\n);\n\nexport type GraphNode = {\n  name: string;\n  children?: GraphNode[];\n};\n\nexport const GraphStatsSchema = z.object({\n  totalPackages: z.number(),\n  maxDepth: z.number(),\n  avgDependencies: z.number(),\n  mostDepended: z.array(\n    z.object({\n      name: z.string(),\n      count: z.number(),\n    })\n  ),\n});\n\nexport type GraphStats = z.infer<typeof GraphStatsSchema>;\n\nexport const GraphResponseSchema = z.object({\n  mode: GraphModeSchema,\n  packageName: z.string().optional(),\n  tree: GraphNodeSchema.optional(),\n  packages: z.array(z.string()).optional(),\n  stats: GraphStatsSchema.optional(),\n});\n\nexport type GraphResponse = z.infer<typeof GraphResponseSchema>;\n\n// ============================================================================\n// Stale API\n// ============================================================================\n\nexport const StaleRequestSchema = z.object({\n  detailed: z.boolean().optional(),\n});\n\nexport type StaleRequest = z.infer<typeof StaleRequestSchema>;\n\nexport const StalePackageSchema = z.object({\n  name: z.string(),\n  path: z.string(),\n  reason: z.enum(['source-newer', 'dependency-rebuilt', 'missing-dist']),\n  sourceModified: z.string().optional(),\n  distModified: z.string().optional(),\n  affectedPackages: z.array(z.string()),\n  affectedCount: z.number(),\n  severity: z.enum(['critical', 'high', 'medium', 'low']),\n});\n\nexport type StalePackage = z.infer<typeof StalePackageSchema>;\n\nexport const StaleChainSchema = z.object({\n  root: z.string(),\n  affected: z.array(z.string()),\n  depth: z.number(),\n});\n\nexport type StaleChain = z.infer<typeof StaleChainSchema>;\n\nexport const StaleResponseSchema = z.object({\n  stalePackages: z.array(StalePackageSchema),\n  totalStale: z.number(),\n  totalAffected: z.number(),\n  criticalChains: z.array(StaleChainSchema).optional(),\n});\n\nexport type StaleResponse = z.infer<typeof StaleResponseSchema>;\n"]}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@kb-labs/quality-contracts",
+  "version": "0.6.0",
+  "type": "module",
+  "description": "Type-safe contracts for Quality Plugin. Types, schemas, and constants for monorepo analysis and quality checks.",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./contract": {
+      "import": "./dist/contract.js",
+      "types": "./dist/contract.d.ts"
+    },
+    "./schema": {
+      "import": "./dist/schema.js",
+      "types": "./dist/schema.d.ts"
+    },
+    "./dist/*": "./dist/*"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "pretype-check": "pnpm --filter @kb-labs/quality-contracts build",
+    "clean": "rimraf dist",
+    "build": "tsup --config tsup.config.ts",
+    "dev": "tsup --config tsup.config.ts --watch",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint . --fix",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@kb-labs/devkit": "link:../../../../infra/kb-labs-devkit",
+    "@types/node": "^24.3.3",
+    "eslint": "^9",
+    "rimraf": "^6.0.1",
+    "tsup": "^8.5.0",
+    "typescript": "^5.6.3",
+    "vitest": "^3.2.4"
+  },
+  "engines": {
+    "node": ">=20.0.0",
+    "pnpm": ">=9.0.0"
+  }
+}