@harness-engineering/core 0.26.3 → 0.27.0

package/dist/chunk-IIEDD47I.mjs

@@ -0,0 +1,125 @@
+// src/architecture/types.ts
+import { z } from "zod";
+var ArchMetricCategorySchema = z.enum([
+  "circular-deps",
+  "layer-violations",
+  "complexity",
+  "coupling",
+  "forbidden-imports",
+  "module-size",
+  "dependency-depth"
+]);
+var ViolationSchema = z.object({
+  id: z.string(),
+  // stable hash: sha256(relativePath + ':' + category + ':' + normalizedDetail)
+  file: z.string(),
+  // relative to project root
+  category: ArchMetricCategorySchema.optional(),
+  // context for baseline reporting
+  detail: z.string(),
+  // human-readable description
+  severity: z.enum(["error", "warning"])
+});
+var MetricResultSchema = z.object({
+  category: ArchMetricCategorySchema,
+  scope: z.string(),
+  // e.g., 'project', 'src/services', 'src/api/routes.ts'
+  value: z.number(),
+  // numeric metric (violation count, complexity score, etc.)
+  violations: z.array(ViolationSchema),
+  metadata: z.record(z.unknown()).optional()
+});
+var CategoryBaselineSchema = z.object({
+  value: z.number(),
+  // aggregate metric value at baseline time
+  violationIds: z.array(z.string())
+  // stable IDs of known violations (the allowlist)
+});
+var ArchBaselineSchema = z.object({
+  version: z.literal(1),
+  updatedAt: z.string().datetime(),
+  // ISO 8601
+  updatedFrom: z.string(),
+  // commit hash
+  metrics: z.record(ArchMetricCategorySchema, CategoryBaselineSchema)
+});
+var CategoryRegressionSchema = z.object({
+  category: ArchMetricCategorySchema,
+  baselineValue: z.number(),
+  currentValue: z.number(),
+  delta: z.number()
+});
+var ArchDiffResultSchema = z.object({
+  passed: z.boolean(),
+  newViolations: z.array(ViolationSchema),
+  // in current but not in baseline -> FAIL
+  resolvedViolations: z.array(z.string()),
+  // in baseline but not in current -> celebrate
+  preExisting: z.array(z.string()),
+  // in both -> allowed, tracked
+  regressions: z.array(CategoryRegressionSchema)
+  // aggregate value exceeded baseline
+});
+var ThresholdConfigSchema = z.record(
+  ArchMetricCategorySchema,
+  z.union([z.number(), z.record(z.string(), z.number())])
+);
+var ArchConfigSchema = z.object({
+  enabled: z.boolean().default(true),
+  baselinePath: z.string().default(".harness/arch/baselines.json"),
+  thresholds: ThresholdConfigSchema.default({}),
+  modules: z.record(z.string(), ThresholdConfigSchema).default({})
+});
+var ConstraintRuleSchema = z.object({
+  id: z.string(),
+  // stable hash: sha256(category + ':' + scope + ':' + description)
+  category: ArchMetricCategorySchema,
+  description: z.string(),
+  // e.g., "Layer 'services' must not import from 'ui'"
+  scope: z.string(),
+  // e.g., 'src/services/', 'project'
+  targets: z.array(z.string()).optional()
+  // forward-compat for governs edges
+});
+var ViolationSnapshotSchema = z.object({
+  timestamp: z.string().datetime(),
+  violations: z.array(ViolationSchema)
+});
+var ViolationHistorySchema = z.object({
+  version: z.literal(1),
+  snapshots: z.array(ViolationSnapshotSchema)
+});
+var EmergenceConfidenceSchema = z.enum(["low", "medium", "high"]);
+var EmergentConstraintSuggestionSchema = z.object({
+  suggestedRule: ConstraintRuleSchema,
+  confidence: EmergenceConfidenceSchema,
+  occurrences: z.number(),
+  uniqueFiles: z.number(),
+  pattern: z.string(),
+  sampleViolations: z.array(ViolationSchema),
+  rationale: z.string()
+});
+var EmergenceResultSchema = z.object({
+  suggestions: z.array(EmergentConstraintSuggestionSchema),
+  totalViolationsAnalyzed: z.number(),
+  windowWeeks: z.number(),
+  minOccurrences: z.number()
+});
+
+export {
+  ArchMetricCategorySchema,
+  ViolationSchema,
+  MetricResultSchema,
+  CategoryBaselineSchema,
+  ArchBaselineSchema,
+  CategoryRegressionSchema,
+  ArchDiffResultSchema,
+  ThresholdConfigSchema,
+  ArchConfigSchema,
+  ConstraintRuleSchema,
+  ViolationSnapshotSchema,
+  ViolationHistorySchema,
+  EmergenceConfidenceSchema,
+  EmergentConstraintSuggestionSchema,
+  EmergenceResultSchema
+};