@harness-engineering/core 0.19.0 → 0.21.0

package/dist/index.d.mts

@@ -1,8 +1,8 @@
 import { Result, SessionSectionName, SessionEntry, SessionSections, WorkflowStep, WorkflowStepResult, Workflow, WorkflowResult, SkillLifecycleHooks, SkillContext, SkillResult, TurnContext, CICheckName, CIFailOnSeverity, CICheckReport, Roadmap, FeatureStatus, RoadmapFeature, ExternalTicket, ExternalTicketState, TrackerSyncConfig, SyncResult, ModelPricing, UsageRecord, DailyUsage, SessionUsage } from '@harness-engineering/types';
 export * from '@harness-engineering/types';
 import { z } from 'zod';
-import { C as Collector, A as ArchConfig, a as ConstraintRule, M as MetricResult, b as ArchMetricCategory, c as ArchBaseline, d as ArchDiffResult, T as ThresholdConfig } from './matchers-Dj1t5vpg.mjs';
-export { e as ArchBaselineSchema, f as ArchConfigSchema, g as ArchDiffResultSchema, h as ArchHandle, i as ArchMetricCategorySchema, j as ArchitectureOptions, k as CategoryBaseline, l as CategoryBaselineSchema, m as CategoryRegression, n as CategoryRegressionSchema, o as ConstraintRuleSchema, p as MetricResultSchema, q as ThresholdConfigSchema, V as Violation, r as ViolationSchema, s as archMatchers, t as archModule, u as architecture } from './matchers-Dj1t5vpg.mjs';
+import { C as Collector, A as ArchConfig, a as ConstraintRule, M as MetricResult, b as ArchMetricCategory, c as ArchBaseline, d as ArchDiffResult, T as ThresholdConfig } from './matchers-D20x48U9.mjs';
+export { e as ArchBaselineSchema, f as ArchConfigSchema, g as ArchDiffResultSchema, h as ArchHandle, i as ArchMetricCategorySchema, j as ArchitectureOptions, k as CategoryBaseline, l as CategoryBaselineSchema, m as CategoryRegression, n as CategoryRegressionSchema, o as ConstraintRuleSchema, p as MetricResultSchema, q as ThresholdConfigSchema, V as Violation, r as ViolationSchema, s as archMatchers, t as archModule, u as architecture } from './matchers-D20x48U9.mjs';
 import Parser from 'web-tree-sitter';
 
 /**
@@ -594,12 +594,12 @@ declare const ManifestSchema: z.ZodObject<{
         schema: string;
     }>, "many">>;
 }, "strip", z.ZodTypeAny, {
-    version: string;
     name: string;
+    version: string;
     include: string[];
     keywords: string[];
-    description?: string | undefined;
     layers?: Record<string, string[]> | undefined;
+    description?: string | undefined;
     minHarnessVersion?: string | undefined;
     boundaries?: {
         name: string;
@@ -608,11 +608,11 @@ declare const ManifestSchema: z.ZodObject<{
         schema: string;
     }[] | undefined;
 }, {
-    version: string;
     name: string;
+    version: string;
     include: string[];
-    description?: string | undefined;
     layers?: Record<string, string[]> | undefined;
+    description?: string | undefined;
     minHarnessVersion?: string | undefined;
     keywords?: string[] | undefined;
     boundaries?: {
@@ -747,12 +747,12 @@ declare const BundleSchema: z.ZodObject<{
             schema: string;
         }>, "many">>;
     }, "strip", z.ZodTypeAny, {
-        version: string;
         name: string;
+        version: string;
         include: string[];
         keywords: string[];
-        description?: string | undefined;
         layers?: Record<string, string[]> | undefined;
+        description?: string | undefined;
         minHarnessVersion?: string | undefined;
         boundaries?: {
             name: string;
@@ -761,11 +761,11 @@ declare const BundleSchema: z.ZodObject<{
             schema: string;
         }[] | undefined;
     }, {
-        version: string;
         name: string;
+        version: string;
         include: string[];
-        description?: string | undefined;
         layers?: Record<string, string[]> | undefined;
+        description?: string | undefined;
         minHarnessVersion?: string | undefined;
         keywords?: string[] | undefined;
         boundaries?: {
@@ -871,15 +871,15 @@ declare const BundleSchema: z.ZodObject<{
     }>;
     contributions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, "strip", z.ZodTypeAny, {
-    version: string;
     name: string;
+    version: string;
     manifest: {
-        version: string;
         name: string;
+        version: string;
         include: string[];
         keywords: string[];
-        description?: string | undefined;
         layers?: Record<string, string[]> | undefined;
+        description?: string | undefined;
         minHarnessVersion?: string | undefined;
         boundaries?: {
             name: string;
@@ -914,14 +914,14 @@ declare const BundleSchema: z.ZodObject<{
     minHarnessVersion?: string | undefined;
     contributions?: Record<string, unknown> | undefined;
 }, {
-    version: string;
     name: string;
+    version: string;
     manifest: {
-        version: string;
         name: string;
+        version: string;
         include: string[];
-        description?: string | undefined;
         layers?: Record<string, string[]> | undefined;
+        description?: string | undefined;
         minHarnessVersion?: string | undefined;
         keywords?: string[] | undefined;
         boundaries?: {
@@ -970,16 +970,16 @@ declare const LockfilePackageSchema: z.ZodObject<{
     integrity: z.ZodOptional<z.ZodString>;
     provenance: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
-    version: string;
     source: string;
+    version: string;
     installedAt: string;
     contributions?: Record<string, unknown> | null | undefined;
     resolved?: string | undefined;
     integrity?: string | undefined;
     provenance?: string[] | undefined;
 }, {
-    version: string;
     source: string;
+    version: string;
     installedAt: string;
     contributions?: Record<string, unknown> | null | undefined;
     resolved?: string | undefined;
@@ -998,16 +998,16 @@ declare const LockfileSchema: z.ZodEffects<z.ZodObject<{
         integrity: z.ZodOptional<z.ZodString>;
         provenance: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     }, "strip", z.ZodTypeAny, {
-        version: string;
         source: string;
+        version: string;
         installedAt: string;
         contributions?: Record<string, unknown> | null | undefined;
         resolved?: string | undefined;
         integrity?: string | undefined;
         provenance?: string[] | undefined;
     }, {
-        version: string;
         source: string;
+        version: string;
         installedAt: string;
         contributions?: Record<string, unknown> | null | undefined;
         resolved?: string | undefined;
@@ -1016,8 +1016,8 @@ declare const LockfileSchema: z.ZodEffects<z.ZodObject<{
     }>>;
 }, "strip", z.ZodTypeAny, {
     packages: Record<string, {
-        version: string;
         source: string;
+        version: string;
         installedAt: string;
         contributions?: Record<string, unknown> | null | undefined;
         resolved?: string | undefined;
@@ -1028,8 +1028,8 @@ declare const LockfileSchema: z.ZodEffects<z.ZodObject<{
     lockfileVersion?: 1 | undefined;
 }, {
     packages: Record<string, {
-        version: string;
         source: string;
+        version: string;
         installedAt: string;
         contributions?: Record<string, unknown> | null | undefined;
         resolved?: string | undefined;
@@ -1040,8 +1040,8 @@ declare const LockfileSchema: z.ZodEffects<z.ZodObject<{
     lockfileVersion?: 1 | undefined;
 }>, {
     packages: Record<string, {
-        version: string;
         source: string;
+        version: string;
         installedAt: string;
         contributions?: Record<string, unknown> | null | undefined;
         resolved?: string | undefined;
@@ -1052,8 +1052,8 @@ declare const LockfileSchema: z.ZodEffects<z.ZodObject<{
     lockfileVersion?: 1 | undefined;
 }, {
     packages: Record<string, {
-        version: string;
         source: string;
+        version: string;
         installedAt: string;
         contributions?: Record<string, unknown> | null | undefined;
         resolved?: string | undefined;
@@ -1924,12 +1924,12 @@ declare const PatternConfigSchema: z.ZodObject<{
             match: z.ZodString;
             convention: z.ZodEnum<["camelCase", "PascalCase", "UPPER_SNAKE", "kebab-case"]>;
         }, "strip", z.ZodTypeAny, {
-            type: "naming";
             match: string;
+            type: "naming";
             convention: "camelCase" | "PascalCase" | "UPPER_SNAKE" | "kebab-case";
         }, {
-            type: "naming";
             match: string;
+            type: "naming";
             convention: "camelCase" | "PascalCase" | "UPPER_SNAKE" | "kebab-case";
         }>, z.ZodObject<{
             type: z.ZodLiteral<"max-exports">;
@@ -1961,10 +1961,10 @@ declare const PatternConfigSchema: z.ZodObject<{
         }>]>;
         message: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        severity: "error" | "warning";
-        description: string;
         files: string[];
         name: string;
+        description: string;
+        severity: "error" | "warning";
         rule: {
             type: "must-export";
             names: string[];
@@ -1982,8 +1982,8 @@ declare const PatternConfigSchema: z.ZodObject<{
             type: "no-import";
             from: string;
         } | {
-            type: "naming";
             match: string;
+            type: "naming";
             convention: "camelCase" | "PascalCase" | "UPPER_SNAKE" | "kebab-case";
         } | {
             type: "max-exports";
@@ -1997,10 +1997,10 @@ declare const PatternConfigSchema: z.ZodObject<{
         };
         message?: string | undefined;
     }, {
-        severity: "error" | "warning";
-        description: string;
         files: string[];
         name: string;
+        description: string;
+        severity: "error" | "warning";
         rule: {
             type: "must-export";
             names: string[];
@@ -2018,8 +2018,8 @@ declare const PatternConfigSchema: z.ZodObject<{
             type: "no-import";
             from: string;
         } | {
-            type: "naming";
             match: string;
+            type: "naming";
             convention: "camelCase" | "PascalCase" | "UPPER_SNAKE" | "kebab-case";
         } | {
             type: "max-exports";
@@ -2037,10 +2037,10 @@ declare const PatternConfigSchema: z.ZodObject<{
     ignoreFiles: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
     patterns: {
-        severity: "error" | "warning";
-        description: string;
         files: string[];
         name: string;
+        description: string;
+        severity: "error" | "warning";
         rule: {
             type: "must-export";
             names: string[];
@@ -2058,8 +2058,8 @@ declare const PatternConfigSchema: z.ZodObject<{
             type: "no-import";
             from: string;
         } | {
-            type: "naming";
             match: string;
+            type: "naming";
             convention: "camelCase" | "PascalCase" | "UPPER_SNAKE" | "kebab-case";
         } | {
             type: "max-exports";
@@ -2077,10 +2077,10 @@ declare const PatternConfigSchema: z.ZodObject<{
     ignoreFiles?: string[] | undefined;
 }, {
     patterns: {
-        severity: "error" | "warning";
-        description: string;
         files: string[];
         name: string;
+        description: string;
+        severity: "error" | "warning";
         rule: {
             type: "must-export";
             names: string[];
@@ -2098,8 +2098,8 @@ declare const PatternConfigSchema: z.ZodObject<{
             type: "no-import";
             from: string;
         } | {
-            type: "naming";
             match: string;
+            type: "naming";
             convention: "camelCase" | "PascalCase" | "UPPER_SNAKE" | "kebab-case";
         } | {
             type: "max-exports";
@@ -2218,12 +2218,12 @@ declare const EntropyConfigSchema: z.ZodObject<{
                     match: z.ZodString;
                     convention: z.ZodEnum<["camelCase", "PascalCase", "UPPER_SNAKE", "kebab-case"]>;
                 }, "strip", z.ZodTypeAny, {
-                    type: "naming";
                     match: string;
+                    type: "naming";
                     convention: "camelCase" | "PascalCase" | "UPPER_SNAKE" | "kebab-case";
                 }, {
-                    type: "naming";
                     match: string;
+                    type: "naming";
                     convention: "camelCase" | "PascalCase" | "UPPER_SNAKE" | "kebab-case";
                 }>, z.ZodObject<{
                     type: z.ZodLiteral<"max-exports">;
@@ -2255,10 +2255,10 @@ declare const EntropyConfigSchema: z.ZodObject<{
                 }>]>;
                 message: z.ZodOptional<z.ZodString>;
             }, "strip", z.ZodTypeAny, {
-                severity: "error" | "warning";
-                description: string;
                 files: string[];
                 name: string;
+                description: string;
+                severity: "error" | "warning";
                 rule: {
                     type: "must-export";
                     names: string[];
@@ -2276,8 +2276,8 @@ declare const EntropyConfigSchema: z.ZodObject<{
                     type: "no-import";
                     from: string;
                 } | {
-                    type: "naming";
                     match: string;
+                    type: "naming";
                     convention: "camelCase" | "PascalCase" | "UPPER_SNAKE" | "kebab-case";
                 } | {
                     type: "max-exports";
@@ -2291,10 +2291,10 @@ declare const EntropyConfigSchema: z.ZodObject<{
                 };
                 message?: string | undefined;
             }, {
-                severity: "error" | "warning";
-                description: string;
                 files: string[];
                 name: string;
+                description: string;
+                severity: "error" | "warning";
                 rule: {
                     type: "must-export";
                     names: string[];
@@ -2312,8 +2312,8 @@ declare const EntropyConfigSchema: z.ZodObject<{
                     type: "no-import";
                     from: string;
                 } | {
-                    type: "naming";
                     match: string;
+                    type: "naming";
                     convention: "camelCase" | "PascalCase" | "UPPER_SNAKE" | "kebab-case";
                 } | {
                     type: "max-exports";
@@ -2331,10 +2331,10 @@ declare const EntropyConfigSchema: z.ZodObject<{
             ignoreFiles: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         }, "strip", z.ZodTypeAny, {
             patterns: {
-                severity: "error" | "warning";
-                description: string;
                 files: string[];
                 name: string;
+                description: string;
+                severity: "error" | "warning";
                 rule: {
                     type: "must-export";
                     names: string[];
@@ -2352,8 +2352,8 @@ declare const EntropyConfigSchema: z.ZodObject<{
                     type: "no-import";
                     from: string;
                 } | {
-                    type: "naming";
                     match: string;
+                    type: "naming";
                     convention: "camelCase" | "PascalCase" | "UPPER_SNAKE" | "kebab-case";
                 } | {
                     type: "max-exports";
@@ -2371,10 +2371,10 @@ declare const EntropyConfigSchema: z.ZodObject<{
             ignoreFiles?: string[] | undefined;
         }, {
             patterns: {
-                severity: "error" | "warning";
-                description: string;
                 files: string[];
                 name: string;
+                description: string;
+                severity: "error" | "warning";
                 rule: {
                     type: "must-export";
                     names: string[];
@@ -2392,8 +2392,8 @@ declare const EntropyConfigSchema: z.ZodObject<{
                     type: "no-import";
                     from: string;
                 } | {
-                    type: "naming";
                     match: string;
+                    type: "naming";
                     convention: "camelCase" | "PascalCase" | "UPPER_SNAKE" | "kebab-case";
                 } | {
                     type: "max-exports";
@@ -2427,10 +2427,10 @@ declare const EntropyConfigSchema: z.ZodObject<{
         } | undefined;
         patterns?: boolean | {
             patterns: {
-                severity: "error" | "warning";
-                description: string;
                 files: string[];
                 name: string;
+                description: string;
+                severity: "error" | "warning";
                 rule: {
                     type: "must-export";
                     names: string[];
@@ -2448,8 +2448,8 @@ declare const EntropyConfigSchema: z.ZodObject<{
                     type: "no-import";
                     from: string;
                 } | {
-                    type: "naming";
                     match: string;
+                    type: "naming";
                     convention: "camelCase" | "PascalCase" | "UPPER_SNAKE" | "kebab-case";
                 } | {
                     type: "max-exports";
@@ -2483,10 +2483,10 @@ declare const EntropyConfigSchema: z.ZodObject<{
         } | undefined;
         patterns?: boolean | {
             patterns: {
-                severity: "error" | "warning";
-                description: string;
                 files: string[];
                 name: string;
+                description: string;
+                severity: "error" | "warning";
                 rule: {
                     type: "must-export";
                     names: string[];
@@ -2504,8 +2504,8 @@ declare const EntropyConfigSchema: z.ZodObject<{
                     type: "no-import";
                     from: string;
                 } | {
-                    type: "naming";
                     match: string;
+                    type: "naming";
                     convention: "camelCase" | "PascalCase" | "UPPER_SNAKE" | "kebab-case";
                 } | {
                     type: "max-exports";
@@ -2545,10 +2545,10 @@ declare const EntropyConfigSchema: z.ZodObject<{
         } | undefined;
         patterns?: boolean | {
             patterns: {
-                severity: "error" | "warning";
-                description: string;
                 files: string[];
                 name: string;
+                description: string;
+                severity: "error" | "warning";
                 rule: {
                     type: "must-export";
                     names: string[];
@@ -2566,8 +2566,8 @@ declare const EntropyConfigSchema: z.ZodObject<{
                     type: "no-import";
                     from: string;
                 } | {
-                    type: "naming";
                     match: string;
+                    type: "naming";
                     convention: "camelCase" | "PascalCase" | "UPPER_SNAKE" | "kebab-case";
                 } | {
                     type: "max-exports";
@@ -2609,10 +2609,10 @@ declare const EntropyConfigSchema: z.ZodObject<{
         } | undefined;
         patterns?: boolean | {
             patterns: {
-                severity: "error" | "warning";
-                description: string;
                 files: string[];
                 name: string;
+                description: string;
+                severity: "error" | "warning";
                 rule: {
                     type: "must-export";
                     names: string[];
@@ -2630,8 +2630,8 @@ declare const EntropyConfigSchema: z.ZodObject<{
                     type: "no-import";
                     from: string;
                 } | {
-                    type: "naming";
                     match: string;
+                    type: "naming";
                     convention: "camelCase" | "PascalCase" | "UPPER_SNAKE" | "kebab-case";
                 } | {
                     type: "max-exports";
@@ -2680,7 +2680,7 @@ interface BaselinesFile {
     updatedFrom: string;
     benchmarks: Record<string, Baseline>;
 }
-interface RegressionResult {
+interface RegressionResult$1 {
     benchmark: string;
     current: BenchmarkResult;
     baseline: Baseline;
@@ -2691,7 +2691,7 @@ interface RegressionResult {
     withinNoise: boolean;
 }
 interface RegressionReport {
-    regressions: RegressionResult[];
+    regressions: RegressionResult$1[];
     improvements: Array<{
         benchmark: string;
         improvementPct: number;
@@ -3350,6 +3350,1269 @@ declare function diff(current: MetricResult[], baseline: ArchBaseline): ArchDiff
  */
 declare function resolveThresholds(scope: string, config: ArchConfig): ThresholdConfig;
 
+declare const CategorySnapshotSchema: z.ZodObject<{
+    /** Aggregate metric value (e.g., violation count, avg complexity) */
+    value: z.ZodNumber;
+    /** Count of violations in this category */
+    violationCount: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    value: number;
+    violationCount: number;
+}, {
+    value: number;
+    violationCount: number;
+}>;
+type CategorySnapshot = z.infer<typeof CategorySnapshotSchema>;
+declare const TimelineSnapshotSchema: z.ZodObject<{
+    /** ISO 8601 timestamp of capture */
+    capturedAt: z.ZodString;
+    /** Git commit hash at capture time */
+    commitHash: z.ZodString;
+    /** Composite stability score (0-100, higher is healthier) */
+    stabilityScore: z.ZodNumber;
+    /** Per-category metric aggregates */
+    metrics: z.ZodRecord<z.ZodEnum<["circular-deps", "layer-violations", "complexity", "coupling", "forbidden-imports", "module-size", "dependency-depth"]>, z.ZodObject<{
+        /** Aggregate metric value (e.g., violation count, avg complexity) */
+        value: z.ZodNumber;
+        /** Count of violations in this category */
+        violationCount: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        value: number;
+        violationCount: number;
+    }, {
+        value: number;
+        violationCount: number;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    metrics: Partial<Record<"complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth", {
+        value: number;
+        violationCount: number;
+    }>>;
+    capturedAt: string;
+    commitHash: string;
+    stabilityScore: number;
+}, {
+    metrics: Partial<Record<"complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth", {
+        value: number;
+        violationCount: number;
+    }>>;
+    capturedAt: string;
+    commitHash: string;
+    stabilityScore: number;
+}>;
+type TimelineSnapshot = z.infer<typeof TimelineSnapshotSchema>;
+declare const TimelineFileSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    snapshots: z.ZodArray<z.ZodObject<{
+        /** ISO 8601 timestamp of capture */
+        capturedAt: z.ZodString;
+        /** Git commit hash at capture time */
+        commitHash: z.ZodString;
+        /** Composite stability score (0-100, higher is healthier) */
+        stabilityScore: z.ZodNumber;
+        /** Per-category metric aggregates */
+        metrics: z.ZodRecord<z.ZodEnum<["circular-deps", "layer-violations", "complexity", "coupling", "forbidden-imports", "module-size", "dependency-depth"]>, z.ZodObject<{
+            /** Aggregate metric value (e.g., violation count, avg complexity) */
+            value: z.ZodNumber;
+            /** Count of violations in this category */
+            violationCount: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            value: number;
+            violationCount: number;
+        }, {
+            value: number;
+            violationCount: number;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        metrics: Partial<Record<"complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth", {
+            value: number;
+            violationCount: number;
+        }>>;
+        capturedAt: string;
+        commitHash: string;
+        stabilityScore: number;
+    }, {
+        metrics: Partial<Record<"complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth", {
+            value: number;
+            violationCount: number;
+        }>>;
+        capturedAt: string;
+        commitHash: string;
+        stabilityScore: number;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    version: 1;
+    snapshots: {
+        metrics: Partial<Record<"complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth", {
+            value: number;
+            violationCount: number;
+        }>>;
+        capturedAt: string;
+        commitHash: string;
+        stabilityScore: number;
+    }[];
+}, {
+    version: 1;
+    snapshots: {
+        metrics: Partial<Record<"complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth", {
+            value: number;
+            violationCount: number;
+        }>>;
+        capturedAt: string;
+        commitHash: string;
+        stabilityScore: number;
+    }[];
+}>;
+type TimelineFile = z.infer<typeof TimelineFileSchema>;
+declare const TrendLineSchema: z.ZodObject<{
+    /** Current value */
+    current: z.ZodNumber;
+    /** Previous value (from comparison snapshot) */
+    previous: z.ZodNumber;
+    /** Absolute delta (current - previous) */
+    delta: z.ZodNumber;
+    /** Direction indicator */
+    direction: z.ZodEnum<["improving", "stable", "declining"]>;
+}, "strip", z.ZodTypeAny, {
+    direction: "improving" | "stable" | "declining";
+    delta: number;
+    current: number;
+    previous: number;
+}, {
+    direction: "improving" | "stable" | "declining";
+    delta: number;
+    current: number;
+    previous: number;
+}>;
+type TrendLine = z.infer<typeof TrendLineSchema>;
+declare const TrendResultSchema: z.ZodObject<{
+    /** Overall stability trend */
+    stability: z.ZodObject<{
+        /** Current value */
+        current: z.ZodNumber;
+        /** Previous value (from comparison snapshot) */
+        previous: z.ZodNumber;
+        /** Absolute delta (current - previous) */
+        delta: z.ZodNumber;
+        /** Direction indicator */
+        direction: z.ZodEnum<["improving", "stable", "declining"]>;
+    }, "strip", z.ZodTypeAny, {
+        direction: "improving" | "stable" | "declining";
+        delta: number;
+        current: number;
+        previous: number;
+    }, {
+        direction: "improving" | "stable" | "declining";
+        delta: number;
+        current: number;
+        previous: number;
+    }>;
+    /** Per-category trends */
+    categories: z.ZodRecord<z.ZodEnum<["circular-deps", "layer-violations", "complexity", "coupling", "forbidden-imports", "module-size", "dependency-depth"]>, z.ZodObject<{
+        /** Current value */
+        current: z.ZodNumber;
+        /** Previous value (from comparison snapshot) */
+        previous: z.ZodNumber;
+        /** Absolute delta (current - previous) */
+        delta: z.ZodNumber;
+        /** Direction indicator */
+        direction: z.ZodEnum<["improving", "stable", "declining"]>;
+    }, "strip", z.ZodTypeAny, {
+        direction: "improving" | "stable" | "declining";
+        delta: number;
+        current: number;
+        previous: number;
+    }, {
+        direction: "improving" | "stable" | "declining";
+        delta: number;
+        current: number;
+        previous: number;
+    }>>;
+    /** Number of snapshots analyzed */
+    snapshotCount: z.ZodNumber;
+    /** Time range covered */
+    from: z.ZodString;
+    to: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    from: string;
+    stability: {
+        direction: "improving" | "stable" | "declining";
+        delta: number;
+        current: number;
+        previous: number;
+    };
+    categories: Partial<Record<"complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth", {
+        direction: "improving" | "stable" | "declining";
+        delta: number;
+        current: number;
+        previous: number;
+    }>>;
+    snapshotCount: number;
+    to: string;
+}, {
+    from: string;
+    stability: {
+        direction: "improving" | "stable" | "declining";
+        delta: number;
+        current: number;
+        previous: number;
+    };
+    categories: Partial<Record<"complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth", {
+        direction: "improving" | "stable" | "declining";
+        delta: number;
+        current: number;
+        previous: number;
+    }>>;
+    snapshotCount: number;
+    to: string;
+}>;
+type TrendResult = z.infer<typeof TrendResultSchema>;
+/**
+ * Reasonable ceiling per category for normalizing health scores.
+ * health = max(0, 1 - (value / threshold))
+ * Categories at or above threshold get health = 0.
+ */
+declare const DEFAULT_STABILITY_THRESHOLDS: Record<ArchMetricCategory, number>;
+
+declare class TimelineManager {
+    private readonly timelinePath;
+    constructor(rootDir: string);
+    /**
+     * Load timeline from disk.
+     * Returns empty TimelineFile if file does not exist or is invalid.
+     */
+    load(): TimelineFile;
+    /**
+     * Save timeline to disk using atomic write (temp file + rename).
+     * Creates parent directories if they do not exist.
+     */
+    save(timeline: TimelineFile): void;
+    /**
+     * Capture a new snapshot from current metric results.
+     * Aggregates MetricResult[] by category, computes stability score,
+     * appends to timeline (or replaces if same commitHash), and saves.
+     */
+    capture(results: MetricResult[], commitHash: string): TimelineSnapshot;
+    /**
+     * Compute trends between snapshots over a window.
+     * @param options.last - Number of recent snapshots to analyze (default: 10)
+     * @param options.since - ISO date string to filter snapshots from
+     */
+    trends(options?: {
+        last?: number;
+        since?: string;
+    }): TrendResult;
+    /**
+     * Compute composite stability score from category metrics.
+     * Equal weight across all categories. Score is 0-100 (higher = healthier).
+     * health = max(0, 1 - (value / threshold)) per category.
+     */
+    computeStabilityScore(metrics: Record<ArchMetricCategory, CategorySnapshot>, thresholds?: Record<ArchMetricCategory, number>): number;
+    private aggregateByCategory;
+    private buildTrendLine;
+    private buildCategoryTrends;
+    private emptyTrendResult;
+}
+
+declare const ConfidenceTierSchema: z.ZodEnum<["high", "medium", "low"]>;
+type ConfidenceTier = z.infer<typeof ConfidenceTierSchema>;
+declare const RegressionResultSchema: z.ZodObject<{
+    slope: z.ZodNumber;
+    intercept: z.ZodNumber;
+    rSquared: z.ZodNumber;
+    dataPoints: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    slope: number;
+    intercept: number;
+    rSquared: number;
+    dataPoints: number;
+}, {
+    slope: number;
+    intercept: number;
+    rSquared: number;
+    dataPoints: number;
+}>;
+type RegressionResult = z.infer<typeof RegressionResultSchema>;
+declare const DirectionSchema: z.ZodEnum<["improving", "stable", "declining"]>;
+type Direction = z.infer<typeof DirectionSchema>;
+declare const CategoryForecastSchema: z.ZodObject<{
+    category: z.ZodEnum<["circular-deps", "layer-violations", "complexity", "coupling", "forbidden-imports", "module-size", "dependency-depth"]>;
+    current: z.ZodNumber;
+    threshold: z.ZodNumber;
+    projectedValue4w: z.ZodNumber;
+    projectedValue8w: z.ZodNumber;
+    projectedValue12w: z.ZodNumber;
+    thresholdCrossingWeeks: z.ZodNullable<z.ZodNumber>;
+    confidence: z.ZodEnum<["high", "medium", "low"]>;
+    regression: z.ZodObject<{
+        slope: z.ZodNumber;
+        intercept: z.ZodNumber;
+        rSquared: z.ZodNumber;
+        dataPoints: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        slope: number;
+        intercept: number;
+        rSquared: number;
+        dataPoints: number;
+    }, {
+        slope: number;
+        intercept: number;
+        rSquared: number;
+        dataPoints: number;
+    }>;
+    direction: z.ZodEnum<["improving", "stable", "declining"]>;
+}, "strip", z.ZodTypeAny, {
+    direction: "improving" | "stable" | "declining";
+    category: "complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth";
+    threshold: number;
+    current: number;
+    projectedValue4w: number;
+    projectedValue8w: number;
+    projectedValue12w: number;
+    thresholdCrossingWeeks: number | null;
+    confidence: "high" | "medium" | "low";
+    regression: {
+        slope: number;
+        intercept: number;
+        rSquared: number;
+        dataPoints: number;
+    };
+}, {
+    direction: "improving" | "stable" | "declining";
+    category: "complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth";
+    threshold: number;
+    current: number;
+    projectedValue4w: number;
+    projectedValue8w: number;
+    projectedValue12w: number;
+    thresholdCrossingWeeks: number | null;
+    confidence: "high" | "medium" | "low";
+    regression: {
+        slope: number;
+        intercept: number;
+        rSquared: number;
+        dataPoints: number;
+    };
+}>;
+type CategoryForecast = z.infer<typeof CategoryForecastSchema>;
+declare const SpecImpactSignalsSchema: z.ZodObject<{
+    newFileCount: z.ZodNumber;
+    affectedLayers: z.ZodArray<z.ZodString, "many">;
+    newDependencies: z.ZodNumber;
+    phaseCount: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    newFileCount: number;
+    affectedLayers: string[];
+    newDependencies: number;
+    phaseCount: number;
+}, {
+    newFileCount: number;
+    affectedLayers: string[];
+    newDependencies: number;
+    phaseCount: number;
+}>;
+declare const SpecImpactEstimateSchema: z.ZodObject<{
+    specPath: z.ZodString;
+    featureName: z.ZodString;
+    signals: z.ZodObject<{
+        newFileCount: z.ZodNumber;
+        affectedLayers: z.ZodArray<z.ZodString, "many">;
+        newDependencies: z.ZodNumber;
+        phaseCount: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        newFileCount: number;
+        affectedLayers: string[];
+        newDependencies: number;
+        phaseCount: number;
+    }, {
+        newFileCount: number;
+        affectedLayers: string[];
+        newDependencies: number;
+        phaseCount: number;
+    }>;
+    deltas: z.ZodOptional<z.ZodRecord<z.ZodEnum<["circular-deps", "layer-violations", "complexity", "coupling", "forbidden-imports", "module-size", "dependency-depth"]>, z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    specPath: string;
+    featureName: string;
+    signals: {
+        newFileCount: number;
+        affectedLayers: string[];
+        newDependencies: number;
+        phaseCount: number;
+    };
+    deltas?: Partial<Record<"complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth", number>> | undefined;
+}, {
+    specPath: string;
+    featureName: string;
+    signals: {
+        newFileCount: number;
+        affectedLayers: string[];
+        newDependencies: number;
+        phaseCount: number;
+    };
+    deltas?: Partial<Record<"complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth", number>> | undefined;
+}>;
+type SpecImpactEstimate = z.infer<typeof SpecImpactEstimateSchema>;
+declare const ContributingFeatureSchema: z.ZodObject<{
+    name: z.ZodString;
+    specPath: z.ZodString;
+    delta: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    delta: number;
+    specPath: string;
+}, {
+    name: string;
+    delta: number;
+    specPath: string;
+}>;
+declare const AdjustedForecastSchema: z.ZodObject<{
+    baseline: z.ZodObject<{
+        category: z.ZodEnum<["circular-deps", "layer-violations", "complexity", "coupling", "forbidden-imports", "module-size", "dependency-depth"]>;
+        current: z.ZodNumber;
+        threshold: z.ZodNumber;
+        projectedValue4w: z.ZodNumber;
+        projectedValue8w: z.ZodNumber;
+        projectedValue12w: z.ZodNumber;
+        thresholdCrossingWeeks: z.ZodNullable<z.ZodNumber>;
+        confidence: z.ZodEnum<["high", "medium", "low"]>;
+        regression: z.ZodObject<{
+            slope: z.ZodNumber;
+            intercept: z.ZodNumber;
+            rSquared: z.ZodNumber;
+            dataPoints: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            slope: number;
+            intercept: number;
+            rSquared: number;
+            dataPoints: number;
+        }, {
+            slope: number;
+            intercept: number;
+            rSquared: number;
+            dataPoints: number;
+        }>;
+        direction: z.ZodEnum<["improving", "stable", "declining"]>;
+    }, "strip", z.ZodTypeAny, {
+        direction: "improving" | "stable" | "declining";
+        category: "complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth";
+        threshold: number;
+        current: number;
+        projectedValue4w: number;
+        projectedValue8w: number;
+        projectedValue12w: number;
+        thresholdCrossingWeeks: number | null;
+        confidence: "high" | "medium" | "low";
+        regression: {
+            slope: number;
+            intercept: number;
+            rSquared: number;
+            dataPoints: number;
+        };
+    }, {
+        direction: "improving" | "stable" | "declining";
+        category: "complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth";
+        threshold: number;
+        current: number;
+        projectedValue4w: number;
+        projectedValue8w: number;
+        projectedValue12w: number;
+        thresholdCrossingWeeks: number | null;
+        confidence: "high" | "medium" | "low";
+        regression: {
+            slope: number;
+            intercept: number;
+            rSquared: number;
+            dataPoints: number;
+        };
+    }>;
+    adjusted: z.ZodObject<{
+        category: z.ZodEnum<["circular-deps", "layer-violations", "complexity", "coupling", "forbidden-imports", "module-size", "dependency-depth"]>;
+        current: z.ZodNumber;
+        threshold: z.ZodNumber;
+        projectedValue4w: z.ZodNumber;
+        projectedValue8w: z.ZodNumber;
+        projectedValue12w: z.ZodNumber;
+        thresholdCrossingWeeks: z.ZodNullable<z.ZodNumber>;
+        confidence: z.ZodEnum<["high", "medium", "low"]>;
+        regression: z.ZodObject<{
+            slope: z.ZodNumber;
+            intercept: z.ZodNumber;
+            rSquared: z.ZodNumber;
+            dataPoints: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            slope: number;
+            intercept: number;
+            rSquared: number;
+            dataPoints: number;
+        }, {
+            slope: number;
+            intercept: number;
+            rSquared: number;
+            dataPoints: number;
+        }>;
+        direction: z.ZodEnum<["improving", "stable", "declining"]>;
+    }, "strip", z.ZodTypeAny, {
+        direction: "improving" | "stable" | "declining";
+        category: "complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth";
+        threshold: number;
+        current: number;
+        projectedValue4w: number;
+        projectedValue8w: number;
+        projectedValue12w: number;
+        thresholdCrossingWeeks: number | null;
+        confidence: "high" | "medium" | "low";
+        regression: {
+            slope: number;
+            intercept: number;
+            rSquared: number;
+            dataPoints: number;
+        };
+    }, {
+        direction: "improving" | "stable" | "declining";
+        category: "complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth";
+        threshold: number;
+        current: number;
+        projectedValue4w: number;
+        projectedValue8w: number;
+        projectedValue12w: number;
+        thresholdCrossingWeeks: number | null;
+        confidence: "high" | "medium" | "low";
+        regression: {
+            slope: number;
+            intercept: number;
+            rSquared: number;
+            dataPoints: number;
+        };
+    }>;
+    contributingFeatures: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        specPath: z.ZodString;
+        delta: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        delta: number;
+        specPath: string;
+    }, {
+        name: string;
+        delta: number;
+        specPath: string;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    baseline: {
+        direction: "improving" | "stable" | "declining";
+        category: "complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth";
+        threshold: number;
+        current: number;
+        projectedValue4w: number;
+        projectedValue8w: number;
+        projectedValue12w: number;
+        thresholdCrossingWeeks: number | null;
+        confidence: "high" | "medium" | "low";
+        regression: {
+            slope: number;
+            intercept: number;
+            rSquared: number;
+            dataPoints: number;
+        };
+    };
+    adjusted: {
+        direction: "improving" | "stable" | "declining";
+        category: "complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth";
+        threshold: number;
+        current: number;
+        projectedValue4w: number;
+        projectedValue8w: number;
+        projectedValue12w: number;
+        thresholdCrossingWeeks: number | null;
+        confidence: "high" | "medium" | "low";
+        regression: {
+            slope: number;
+            intercept: number;
+            rSquared: number;
+            dataPoints: number;
+        };
+    };
+    contributingFeatures: {
+        name: string;
+        delta: number;
+        specPath: string;
+    }[];
+}, {
+    baseline: {
+        direction: "improving" | "stable" | "declining";
+        category: "complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth";
+        threshold: number;
+        current: number;
+        projectedValue4w: number;
+        projectedValue8w: number;
+        projectedValue12w: number;
+        thresholdCrossingWeeks: number | null;
+        confidence: "high" | "medium" | "low";
+        regression: {
+            slope: number;
+            intercept: number;
+            rSquared: number;
+            dataPoints: number;
+        };
+    };
+    adjusted: {
+        direction: "improving" | "stable" | "declining";
+        category: "complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth";
+        threshold: number;
+        current: number;
+        projectedValue4w: number;
+        projectedValue8w: number;
+        projectedValue12w: number;
+        thresholdCrossingWeeks: number | null;
+        confidence: "high" | "medium" | "low";
+        regression: {
+            slope: number;
+            intercept: number;
+            rSquared: number;
+            dataPoints: number;
+        };
+    };
+    contributingFeatures: {
+        name: string;
+        delta: number;
+        specPath: string;
+    }[];
+}>;
+type AdjustedForecast = z.infer<typeof AdjustedForecastSchema>;
+declare const PredictionWarningSchema: z.ZodObject<{
+    severity: z.ZodEnum<["critical", "warning", "info"]>;
+    category: z.ZodEnum<["circular-deps", "layer-violations", "complexity", "coupling", "forbidden-imports", "module-size", "dependency-depth"]>;
+    message: z.ZodString;
+    weeksUntil: z.ZodNumber;
+    confidence: z.ZodEnum<["high", "medium", "low"]>;
+    contributingFeatures: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    message: string;
+    category: "complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth";
+    severity: "warning" | "info" | "critical";
+    confidence: "high" | "medium" | "low";
+    contributingFeatures: string[];
+    weeksUntil: number;
+}, {
+    message: string;
+    category: "complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth";
+    severity: "warning" | "info" | "critical";
+    confidence: "high" | "medium" | "low";
+    contributingFeatures: string[];
+    weeksUntil: number;
+}>;
+type PredictionWarning = z.infer<typeof PredictionWarningSchema>;
+declare const StabilityForecastSchema: z.ZodObject<{
+    current: z.ZodNumber;
+    projected4w: z.ZodNumber;
+    projected8w: z.ZodNumber;
+    projected12w: z.ZodNumber;
+    confidence: z.ZodEnum<["high", "medium", "low"]>;
+    direction: z.ZodEnum<["improving", "stable", "declining"]>;
+}, "strip", z.ZodTypeAny, {
+    direction: "improving" | "stable" | "declining";
+    current: number;
+    confidence: "high" | "medium" | "low";
+    projected4w: number;
+    projected8w: number;
+    projected12w: number;
+}, {
+    direction: "improving" | "stable" | "declining";
+    current: number;
+    confidence: "high" | "medium" | "low";
+    projected4w: number;
+    projected8w: number;
+    projected12w: number;
+}>;
+type StabilityForecast = z.infer<typeof StabilityForecastSchema>;
+declare const PredictionResultSchema: z.ZodObject<{
+    generatedAt: z.ZodString;
+    snapshotsUsed: z.ZodNumber;
+    timelineRange: z.ZodObject<{
+        from: z.ZodString;
+        to: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        from: string;
+        to: string;
+    }, {
+        from: string;
+        to: string;
+    }>;
+    stabilityForecast: z.ZodObject<{
+        current: z.ZodNumber;
+        projected4w: z.ZodNumber;
+        projected8w: z.ZodNumber;
+        projected12w: z.ZodNumber;
+        confidence: z.ZodEnum<["high", "medium", "low"]>;
+        direction: z.ZodEnum<["improving", "stable", "declining"]>;
+    }, "strip", z.ZodTypeAny, {
+        direction: "improving" | "stable" | "declining";
+        current: number;
+        confidence: "high" | "medium" | "low";
+        projected4w: number;
+        projected8w: number;
+        projected12w: number;
+    }, {
+        direction: "improving" | "stable" | "declining";
+        current: number;
+        confidence: "high" | "medium" | "low";
+        projected4w: number;
+        projected8w: number;
+        projected12w: number;
+    }>;
+    categories: z.ZodRecord<z.ZodEnum<["circular-deps", "layer-violations", "complexity", "coupling", "forbidden-imports", "module-size", "dependency-depth"]>, z.ZodObject<{
+        baseline: z.ZodObject<{
+            category: z.ZodEnum<["circular-deps", "layer-violations", "complexity", "coupling", "forbidden-imports", "module-size", "dependency-depth"]>;
+            current: z.ZodNumber;
+            threshold: z.ZodNumber;
+            projectedValue4w: z.ZodNumber;
+            projectedValue8w: z.ZodNumber;
+            projectedValue12w: z.ZodNumber;
+            thresholdCrossingWeeks: z.ZodNullable<z.ZodNumber>;
+            confidence: z.ZodEnum<["high", "medium", "low"]>;
+            regression: z.ZodObject<{
+                slope: z.ZodNumber;
+                intercept: z.ZodNumber;
+                rSquared: z.ZodNumber;
+                dataPoints: z.ZodNumber;
+            }, "strip", z.ZodTypeAny, {
+                slope: number;
+                intercept: number;
+                rSquared: number;
+                dataPoints: number;
+            }, {
+                slope: number;
+                intercept: number;
+                rSquared: number;
+                dataPoints: number;
+            }>;
+            direction: z.ZodEnum<["improving", "stable", "declining"]>;
+        }, "strip", z.ZodTypeAny, {
+            direction: "improving" | "stable" | "declining";
+            category: "complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth";
+            threshold: number;
+            current: number;
+            projectedValue4w: number;
+            projectedValue8w: number;
+            projectedValue12w: number;
+            thresholdCrossingWeeks: number | null;
+            confidence: "high" | "medium" | "low";
+            regression: {
+                slope: number;
+                intercept: number;
+                rSquared: number;
+                dataPoints: number;
+            };
+        }, {
+            direction: "improving" | "stable" | "declining";
+            category: "complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth";
+            threshold: number;
+            current: number;
+            projectedValue4w: number;
+            projectedValue8w: number;
+            projectedValue12w: number;
+            thresholdCrossingWeeks: number | null;
+            confidence: "high" | "medium" | "low";
+            regression: {
+                slope: number;
+                intercept: number;
+                rSquared: number;
+                dataPoints: number;
+            };
+        }>;
+        adjusted: z.ZodObject<{
+            category: z.ZodEnum<["circular-deps", "layer-violations", "complexity", "coupling", "forbidden-imports", "module-size", "dependency-depth"]>;
+            current: z.ZodNumber;
+            threshold: z.ZodNumber;
+            projectedValue4w: z.ZodNumber;
+            projectedValue8w: z.ZodNumber;
+            projectedValue12w: z.ZodNumber;
+            thresholdCrossingWeeks: z.ZodNullable<z.ZodNumber>;
+            confidence: z.ZodEnum<["high", "medium", "low"]>;
+            regression: z.ZodObject<{
+                slope: z.ZodNumber;
+                intercept: z.ZodNumber;
+                rSquared: z.ZodNumber;
+                dataPoints: z.ZodNumber;
+            }, "strip", z.ZodTypeAny, {
+                slope: number;
+                intercept: number;
+                rSquared: number;
+                dataPoints: number;
+            }, {
+                slope: number;
+                intercept: number;
+                rSquared: number;
+                dataPoints: number;
+            }>;
+            direction: z.ZodEnum<["improving", "stable", "declining"]>;
+        }, "strip", z.ZodTypeAny, {
+            direction: "improving" | "stable" | "declining";
+            category: "complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth";
+            threshold: number;
+            current: number;
+            projectedValue4w: number;
+            projectedValue8w: number;
+            projectedValue12w: number;
+            thresholdCrossingWeeks: number | null;
+            confidence: "high" | "medium" | "low";
+            regression: {
+                slope: number;
+                intercept: number;
+                rSquared: number;
+                dataPoints: number;
+            };
+        }, {
+            direction: "improving" | "stable" | "declining";
+            category: "complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth";
+            threshold: number;
+            current: number;
+            projectedValue4w: number;
+            projectedValue8w: number;
+            projectedValue12w: number;
+            thresholdCrossingWeeks: number | null;
+            confidence: "high" | "medium" | "low";
+            regression: {
+                slope: number;
+                intercept: number;
+                rSquared: number;
+                dataPoints: number;
+            };
+        }>;
+        contributingFeatures: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            specPath: z.ZodString;
+            delta: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            delta: number;
+            specPath: string;
+        }, {
+            name: string;
+            delta: number;
+            specPath: string;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        baseline: {
+            direction: "improving" | "stable" | "declining";
+            category: "complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth";
+            threshold: number;
+            current: number;
+            projectedValue4w: number;
+            projectedValue8w: number;
+            projectedValue12w: number;
+            thresholdCrossingWeeks: number | null;
+            confidence: "high" | "medium" | "low";
+            regression: {
+                slope: number;
+                intercept: number;
+                rSquared: number;
+                dataPoints: number;
+            };
+        };
+        adjusted: {
+            direction: "improving" | "stable" | "declining";
+            category: "complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth";
+            threshold: number;
+            current: number;
+            projectedValue4w: number;
+            projectedValue8w: number;
+            projectedValue12w: number;
+            thresholdCrossingWeeks: number | null;
+            confidence: "high" | "medium" | "low";
+            regression: {
+                slope: number;
+                intercept: number;
+                rSquared: number;
+                dataPoints: number;
+            };
+        };
+        contributingFeatures: {
+            name: string;
+            delta: number;
+            specPath: string;
+        }[];
+    }, {
+        baseline: {
+            direction: "improving" | "stable" | "declining";
+            category: "complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth";
+            threshold: number;
+            current: number;
+            projectedValue4w: number;
+            projectedValue8w: number;
+            projectedValue12w: number;
+            thresholdCrossingWeeks: number | null;
+            confidence: "high" | "medium" | "low";
+            regression: {
+                slope: number;
+                intercept: number;
+                rSquared: number;
+                dataPoints: number;
+            };
+        };
+        adjusted: {
+            direction: "improving" | "stable" | "declining";
+            category: "complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth";
+            threshold: number;
+            current: number;
+            projectedValue4w: number;
+            projectedValue8w: number;
+            projectedValue12w: number;
+            thresholdCrossingWeeks: number | null;
+            confidence: "high" | "medium" | "low";
+            regression: {
+                slope: number;
+                intercept: number;
+                rSquared: number;
+                dataPoints: number;
+            };
+        };
+        contributingFeatures: {
+            name: string;
+            delta: number;
+            specPath: string;
+        }[];
+    }>>;
+    warnings: z.ZodArray<z.ZodObject<{
+        severity: z.ZodEnum<["critical", "warning", "info"]>;
+        category: z.ZodEnum<["circular-deps", "layer-violations", "complexity", "coupling", "forbidden-imports", "module-size", "dependency-depth"]>;
+        message: z.ZodString;
+        weeksUntil: z.ZodNumber;
+        confidence: z.ZodEnum<["high", "medium", "low"]>;
+        contributingFeatures: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        message: string;
+        category: "complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth";
+        severity: "warning" | "info" | "critical";
+        confidence: "high" | "medium" | "low";
+        contributingFeatures: string[];
+        weeksUntil: number;
+    }, {
+        message: string;
+        category: "complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth";
+        severity: "warning" | "info" | "critical";
+        confidence: "high" | "medium" | "low";
+        contributingFeatures: string[];
+        weeksUntil: number;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    categories: Partial<Record<"complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth", {
+        baseline: {
+            direction: "improving" | "stable" | "declining";
+            category: "complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth";
+            threshold: number;
+            current: number;
+            projectedValue4w: number;
+            projectedValue8w: number;
+            projectedValue12w: number;
+            thresholdCrossingWeeks: number | null;
+            confidence: "high" | "medium" | "low";
+            regression: {
+                slope: number;
+                intercept: number;
+                rSquared: number;
+                dataPoints: number;
+            };
+        };
+        adjusted: {
+            direction: "improving" | "stable" | "declining";
+            category: "complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth";
+            threshold: number;
+            current: number;
+            projectedValue4w: number;
+            projectedValue8w: number;
+            projectedValue12w: number;
+            thresholdCrossingWeeks: number | null;
+            confidence: "high" | "medium" | "low";
+            regression: {
+                slope: number;
+                intercept: number;
+                rSquared: number;
+                dataPoints: number;
+            };
+        };
+        contributingFeatures: {
+            name: string;
+            delta: number;
+            specPath: string;
+        }[];
+    }>>;
+    generatedAt: string;
+    snapshotsUsed: number;
+    timelineRange: {
+        from: string;
+        to: string;
+    };
+    stabilityForecast: {
+        direction: "improving" | "stable" | "declining";
+        current: number;
+        confidence: "high" | "medium" | "low";
+        projected4w: number;
+        projected8w: number;
+        projected12w: number;
+    };
+    warnings: {
+        message: string;
+        category: "complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth";
+        severity: "warning" | "info" | "critical";
+        confidence: "high" | "medium" | "low";
+        contributingFeatures: string[];
+        weeksUntil: number;
+    }[];
+}, {
+    categories: Partial<Record<"complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth", {
+        baseline: {
+            direction: "improving" | "stable" | "declining";
+            category: "complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth";
+            threshold: number;
+            current: number;
+            projectedValue4w: number;
+            projectedValue8w: number;
+            projectedValue12w: number;
+            thresholdCrossingWeeks: number | null;
+            confidence: "high" | "medium" | "low";
+            regression: {
+                slope: number;
+                intercept: number;
+                rSquared: number;
+                dataPoints: number;
+            };
+        };
+        adjusted: {
+            direction: "improving" | "stable" | "declining";
+            category: "complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth";
+            threshold: number;
+            current: number;
+            projectedValue4w: number;
+            projectedValue8w: number;
+            projectedValue12w: number;
+            thresholdCrossingWeeks: number | null;
+            confidence: "high" | "medium" | "low";
+            regression: {
+                slope: number;
+                intercept: number;
+                rSquared: number;
+                dataPoints: number;
+            };
+        };
+        contributingFeatures: {
+            name: string;
+            delta: number;
+            specPath: string;
+        }[];
+    }>>;
+    generatedAt: string;
+    snapshotsUsed: number;
+    timelineRange: {
+        from: string;
+        to: string;
+    };
+    stabilityForecast: {
+        direction: "improving" | "stable" | "declining";
+        current: number;
+        confidence: "high" | "medium" | "low";
+        projected4w: number;
+        projected8w: number;
+        projected12w: number;
+    };
+    warnings: {
+        message: string;
+        category: "complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth";
+        severity: "warning" | "info" | "critical";
+        confidence: "high" | "medium" | "low";
+        contributingFeatures: string[];
+        weeksUntil: number;
+    }[];
+}>;
+type PredictionResult = z.infer<typeof PredictionResultSchema>;
+declare const PredictionOptionsSchema: z.ZodObject<{
+    horizon: z.ZodDefault<z.ZodNumber>;
+    includeRoadmap: z.ZodDefault<z.ZodBoolean>;
+    categories: z.ZodOptional<z.ZodArray<z.ZodEnum<["circular-deps", "layer-violations", "complexity", "coupling", "forbidden-imports", "module-size", "dependency-depth"]>, "many">>;
+    thresholds: z.ZodOptional<z.ZodRecord<z.ZodEnum<["circular-deps", "layer-violations", "complexity", "coupling", "forbidden-imports", "module-size", "dependency-depth"]>, z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    horizon: number;
+    includeRoadmap: boolean;
+    thresholds?: Partial<Record<"complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth", number>> | undefined;
+    categories?: ("complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth")[] | undefined;
+}, {
+    thresholds?: Partial<Record<"complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth", number>> | undefined;
+    categories?: ("complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth")[] | undefined;
+    horizon?: number | undefined;
+    includeRoadmap?: boolean | undefined;
+}>;
+type PredictionOptions = z.infer<typeof PredictionOptionsSchema>;
+
+/**
+ * Pure math module for weighted linear regression.
+ * No harness type dependencies — independently testable with synthetic data.
+ */
+interface DataPoint {
+    t: number;
+    value: number;
+    weight: number;
+}
+interface RegressionFit {
+    slope: number;
+    intercept: number;
+    rSquared: number;
+    dataPoints: number;
+}
+/**
+ * Weighted least squares linear regression.
+ * Fits y = slope * t + intercept, minimizing weighted sum of squared residuals.
+ */
+declare function weightedLinearRegression(points: DataPoint[]): RegressionFit;
+/**
+ * Assign recency weights to a time-ordered series of values.
+ * Newest value gets weight 1.0, each older value is multiplied by decay.
+ *
+ * @param values - Time-ordered array of { t, value } (oldest first)
+ * @param decay - Weight decay factor per step (default: 0.85)
+ * @returns DataPoint array with recency weights assigned
+ */
+declare function applyRecencyWeights(values: Array<{
+    t: number;
+    value: number;
+}>, decay?: number): DataPoint[];
+/**
+ * Project a value at future time t using a regression fit.
+ *
+ * @param fit - The regression fit (slope + intercept)
+ * @param t - The time to project to
+ * @returns Projected value
+ */
+declare function projectValue(fit: RegressionFit, t: number): number;
+/**
+ * Calculate weeks until projected value crosses a threshold.
+ *
+ * @param fit - The regression fit
+ * @param currentT - Current time point (weeks from first snapshot)
+ * @param threshold - The threshold value to cross
+ * @returns Weeks until crossing, or null if slope <= 0 (improving/stable) or already crossed
+ */
+declare function weeksUntilThreshold(fit: RegressionFit, currentT: number, threshold: number): number | null;
+/**
+ * Classify confidence based on R-squared and data point count.
+ *
+ * High:   R-squared >= 0.7 AND 5+ data points
+ * Medium: R-squared >= 0.4 AND 3+ data points
+ * Low:    anything else
+ *
+ * @param rSquared - Goodness of fit (0-1)
+ * @param dataPoints - Number of data points used
+ * @returns Confidence tier
+ */
+declare function classifyConfidence(rSquared: number, dataPoints: number): 'high' | 'medium' | 'low';
+
+/** Configurable coefficients for signal-to-delta mapping */
+interface EstimatorCoefficients {
+    newFileModuleSize?: number;
+    newFileComplexity?: number;
+    layerViolation?: number;
+    depCoupling?: number;
+    depDepth?: number;
+    phaseComplexity?: number;
+}
+/**
+ * SpecImpactEstimator: mechanical extraction of structural signals from spec files.
+ * Applies configurable coefficients to produce per-category metric deltas.
+ *
+ * No LLM dependency -- deterministic, auditable extraction.
+ */
+declare class SpecImpactEstimator {
+    private readonly rootDir;
+    private readonly coefficients;
+    private readonly layerNames;
+    constructor(rootDir: string, coefficients?: EstimatorCoefficients);
+    /**
+     * Estimate impact of a single spec file.
+     * @param specPath - Relative path from rootDir to the spec file.
+     */
+    estimate(specPath: string): SpecImpactEstimate;
+    /**
+     * Estimate impact for all planned features that have specs.
+     * Skips features with null specs or specs that don't exist on disk.
+     */
+    estimateAll(features: Array<{
+        name: string;
+        spec: string | null;
+    }>): SpecImpactEstimate[];
+    /**
+     * Count file paths in Technical Design sections that don't exist on disk.
+     * Looks for paths in code blocks (```) under ## Technical Design.
+     */
+    private extractNewFileCount;
+    /**
+     * Match layer names from harness.config.json mentioned in the spec.
+     * Returns deduplicated array of matched layer names.
+     */
+    private extractAffectedLayers;
+    /**
+     * Count dependency-related keywords: "import", "depend" (covers depends/dependency),
+     * "package" in dependency context.
+     */
+    private extractNewDependencies;
+    /**
+     * Count H3/H4 headings under "Implementation" or "Implementation Order" sections.
+     */
+    private extractPhaseCount;
+    private computeDeltas;
+    private loadLayerNames;
+    private escapeRegex;
+}
+
+/**
+ * PredictionEngine: orchestrates weighted regression over timeline snapshots
+ * to produce per-category forecasts and warnings.
+ *
+ * Supports roadmap-aware adjusted forecasts via SpecImpactEstimator.
+ */
+declare class PredictionEngine {
+    private readonly rootDir;
+    private readonly timelineManager;
+    private readonly estimator;
+    constructor(rootDir: string, timelineManager: TimelineManager, estimator: SpecImpactEstimator | null);
+    /**
+     * Produce a PredictionResult with per-category forecasts and warnings.
+     * Throws if fewer than 3 snapshots are available.
+     */
+    predict(options?: Partial<PredictionOptions>): PredictionResult;
+    private resolveOptions;
+    private resolveThresholds;
+    /**
+     * Extract time series for a single category from snapshots.
+     * Returns array of { t (weeks from first), value } sorted oldest first.
+     */
+    private extractTimeSeries;
+    /**
+     * Produce a CategoryForecast for a single category using regression.
+     */
+    private forecastCategory;
+    private classifyDirection;
+    private zeroForecast;
+    /**
+     * Generate warnings based on severity rules from spec:
+     * - critical: threshold crossing <= 4w, confidence high or medium
+     * - warning: threshold crossing <= 8w, confidence high or medium
+     * - info: threshold crossing <= 12w, any confidence
+     */
+    private generateWarnings;
+    /**
+     * Compute composite stability forecast by projecting per-category values
+     * forward and computing stability scores at each horizon.
+     */
+    private computeStabilityForecast;
+    private buildMetricsFromForecasts;
+    private medianConfidence;
+    /**
+     * Load roadmap features, estimate spec impacts via the estimator.
+     * Returns null if estimator is null or includeRoadmap is false.
+     */
+    private computeSpecImpacts;
+}
+
 declare const FailureEntrySchema: z.ZodObject<{
     date: z.ZodString;
     skill: z.ZodString;
@@ -3357,13 +4620,13 @@ declare const FailureEntrySchema: z.ZodObject<{
     description: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     type: string;
-    date: string;
     description: string;
+    date: string;
     skill: string;
 }, {
     type: string;
-    date: string;
     description: string;
+    date: string;
     skill: string;
 }>;
 type FailureEntry = z.infer<typeof FailureEntrySchema>;
@@ -3426,14 +4689,14 @@ declare const GateResultSchema: z.ZodObject<{
         output: z.ZodOptional<z.ZodString>;
         duration: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
-        passed: boolean;
         name: string;
+        passed: boolean;
         command: string;
         output?: string | undefined;
         duration?: number | undefined;
     }, {
-        passed: boolean;
         name: string;
+        passed: boolean;
         command: string;
         output?: string | undefined;
         duration?: number | undefined;
@@ -3441,8 +4704,8 @@ declare const GateResultSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     passed: boolean;
     checks: {
-        passed: boolean;
         name: string;
+        passed: boolean;
         command: string;
         output?: string | undefined;
         duration?: number | undefined;
@@ -3450,8 +4713,8 @@ declare const GateResultSchema: z.ZodObject<{
 }, {
     passed: boolean;
     checks: {
-        passed: boolean;
         name: string;
+        passed: boolean;
         command: string;
         output?: string | undefined;
         duration?: number | undefined;
@@ -3514,13 +4777,13 @@ declare const HarnessStateSchema: z.ZodObject<{
         description: z.ZodString;
         status: z.ZodEnum<["open", "resolved"]>;
     }, "strip", z.ZodTypeAny, {
-        status: "resolved" | "open";
         id: string;
         description: string;
-    }, {
         status: "resolved" | "open";
+    }, {
         id: string;
         description: string;
+        status: "resolved" | "open";
     }>, "many">>;
     progress: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodEnum<["pending", "in_progress", "complete"]>>>;
     lastSession: z.ZodOptional<z.ZodObject<{
@@ -3546,9 +4809,9 @@ declare const HarnessStateSchema: z.ZodObject<{
         decision: string;
     }[];
     blockers: {
-        status: "resolved" | "open";
         id: string;
         description: string;
+        status: "resolved" | "open";
     }[];
     schemaVersion: 1;
     position: {
@@ -3570,9 +4833,9 @@ declare const HarnessStateSchema: z.ZodObject<{
         decision: string;
     }[] | undefined;
     blockers?: {
-        status: "resolved" | "open";
         id: string;
         description: string;
+        status: "resolved" | "open";
     }[] | undefined;
     position?: {
         task?: string | undefined;
@@ -4109,9 +5372,9 @@ declare const SecurityConfigSchema: z.ZodObject<{
         } | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
+    rules: Record<string, "error" | "warning" | "info" | "off">;
     enabled: boolean;
     strict: boolean;
-    rules: Record<string, "error" | "warning" | "info" | "off">;
     exclude: string[];
     external?: {
         semgrep?: {
@@ -4123,9 +5386,9 @@ declare const SecurityConfigSchema: z.ZodObject<{
         } | undefined;
     } | undefined;
 }, {
+    rules?: Record<string, "error" | "warning" | "info" | "off"> | undefined;
     enabled?: boolean | undefined;
     strict?: boolean | undefined;
-    rules?: Record<string, "error" | "warning" | "info" | "off"> | undefined;
     exclude?: string[] | undefined;
     external?: {
         semgrep?: {
@@ -5215,7 +6478,7 @@ declare class GitHubIssuesSyncAdapter implements TrackerSyncAdapter {
  * Mutates `roadmap` in-place (stores new externalIds).
  * Never throws -- errors collected per-feature.
  */
-declare function syncToExternal(roadmap: Roadmap, adapter: TrackerSyncAdapter, _config: TrackerSyncConfig): Promise<SyncResult>;
+declare function syncToExternal(roadmap: Roadmap, adapter: TrackerSyncAdapter, config: TrackerSyncConfig, prefetchedTickets?: ExternalTicketState[]): Promise<SyncResult>;
 /**
  * Pull execution fields (assignee, status) from external service.
  * - External assignee wins over local assignee
@@ -5224,7 +6487,7 @@ declare function syncToExternal(roadmap: Roadmap, adapter: TrackerSyncAdapter, _
  * Mutates `roadmap` in-place.
  * Never throws -- errors collected per-feature.
  */
-declare function syncFromExternal(roadmap: Roadmap, adapter: TrackerSyncAdapter, config: TrackerSyncConfig, options?: ExternalSyncOptions): Promise<SyncResult>;
+declare function syncFromExternal(roadmap: Roadmap, adapter: TrackerSyncAdapter, config: TrackerSyncConfig, options?: ExternalSyncOptions, prefetchedTickets?: ExternalTicketState[]): Promise<SyncResult>;
 /**
  * Full bidirectional sync: read roadmap, push, pull, write back.
  * Serialized by in-process mutex.
@@ -5283,12 +6546,12 @@ declare const QuestionSchema: z.ZodObject<{
     default: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     text: string;
-    options?: string[] | undefined;
     default?: string | undefined;
+    options?: string[] | undefined;
 }, {
     text: string;
-    options?: string[] | undefined;
     default?: string | undefined;
+    options?: string[] | undefined;
 }>;
 declare const ConfirmationSchema: z.ZodObject<{
     text: z.ZodString;
@@ -5332,12 +6595,12 @@ declare const EmitInteractionInputSchema: z.ZodObject<{
         default: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         text: string;
-        options?: string[] | undefined;
         default?: string | undefined;
+        options?: string[] | undefined;
     }, {
         text: string;
-        options?: string[] | undefined;
         default?: string | undefined;
+        options?: string[] | undefined;
     }>>;
     confirmation: z.ZodOptional<z.ZodObject<{
         text: z.ZodString;
@@ -5377,8 +6640,8 @@ declare const EmitInteractionInputSchema: z.ZodObject<{
     stream?: string | undefined;
     question?: {
         text: string;
-        options?: string[] | undefined;
         default?: string | undefined;
+        options?: string[] | undefined;
     } | undefined;
     confirmation?: {
         text: string;
@@ -5398,8 +6661,8 @@ declare const EmitInteractionInputSchema: z.ZodObject<{
     stream?: string | undefined;
     question?: {
         text: string;
-        options?: string[] | undefined;
         default?: string | undefined;
+        options?: string[] | undefined;
     } | undefined;
     confirmation?: {
         text: string;
@@ -5664,4 +6927,4 @@ declare function parseCCRecords(): UsageRecord[];
  */
 declare const VERSION = "0.15.0";
 
-export { AGENT_DESCRIPTORS, ARCHITECTURE_DESCRIPTOR, type AST, type ActionContext, type ActionEvent, type ActionEventHandler, type ActionEventType, type ActionResult, type ActionSink, type ActionTracker, type ActionType, type AgentAction, AgentActionEmitter, type AgentExecutor, type AgentMapLink, type AgentMapSection, type AgentMapValidation, type AgentProcess, type AgentReviewResult, type AgentType, type AgentsMapConfig, ArchBaseline, ArchBaselineManager, ArchConfig, ArchDiffResult, ArchMetricCategory, BUG_DETECTION_DESCRIPTOR, type BaseError, type Baseline, BaselineManager, type BaselinesFile, type BenchmarkResult, type BenchmarkRunOptions, BenchmarkRunner, type BlueprintData, BlueprintGenerator, type BlueprintModule, type BlueprintOptions, type BoundaryDefinition, type BoundaryValidation, type BoundaryValidator, type BoundaryViolation, type BrokenLink, type BudgetedLearningsOptions, type Bundle, type BundleConstraints, BundleConstraintsSchema, BundleSchema, CACHE_TTL_MS, COMPLIANCE_DESCRIPTOR, type ChangeType, type ChangedFile, ChecklistBuilder, type CircularDependency, CircularDepsCollector, type CircularDepsResult, type CleanupFinding, type CodeBlock, type CodeChanges, type CodePattern, type CodeReference, type CodeSymbol, type CodebaseSnapshot, Collector, type CommentedCodeBlock, type CommitFormat, type CommitHistoryEntry, type CommitValidation, ComplexityCollector, type ComplexityConfig, type ComplexityReport, type ComplexityThresholds, type ComplexityViolation, type ConfigError, type ConfigPattern, type Confirmation, ConfirmationSchema, type ConflictReport, ConsoleSink, type ConstraintError, type ConstraintNodeStore, ConstraintRule, type Content, ContentPipeline, type ContextBundle, type ContextError, type ContextFile, type ContextFilterResult, type ContextScopeOptions, type Contributions, ContributionsSchema, type Convention, CouplingCollector, type CouplingConfig, type CouplingReport, type CouplingThresholds, type CouplingViolation, type CoverageOptions, type CoverageReport, type CriticalPathEntry, CriticalPathResolver, type CriticalPathSet, type CustomRule, type CustomRuleResult, DEFAULT_PROVIDER_TIERS, DEFAULT_SECURITY_CONFIG, DEFAULT_STATE, DEFAULT_STREAM_INDEX, DESTRUCTIVE_BASH, type DeadCodeConfig, type DeadCodeReport, type DeadExport, type DeadFile, type DeadInternal, type DeduplicateFindingsOptions, DepDepthCollector, type DependencyEdge, type DependencyGraph, type DependencyValidation, type DependencyViolation, type DetectStaleResult, type DiffInfo, type DocumentationDrift, type DocumentationFile, type DocumentationGap, type DriftConfig, type DriftReport, EXTENSION_MAP, type EligibilityResult, type EmitEventInput, type EmitEventOptions, type EmitEventResult, type EmitInteractionInput, EmitInteractionInputSchema, EntropyAnalyzer, type EntropyConfig, EntropyConfigSchema, type EntropyError, type EntropyReport, type EventType, type EvidenceCoverageReport, ExclusionSet, type ExecutorHealth, type Export, type ExportMap, type ExternalSyncOptions, type FailureEntry, FailureEntrySchema, type FallbackPricingFile, type FanOutOptions, type FeedbackAgentConfig, type FeedbackConfig, type FeedbackError$1 as FeedbackError, type FileCategory, FileSink, type FindingSeverity, type Fix, type FixConfig, type FixResult, type FixType, ForbiddenImportCollector, type ForbiddenImportViolation, type ForbiddenPattern, type GateConfig, GateConfigSchema, type GateResult, GateResultSchema, type GenerationSection, type GitHubInlineComment, GitHubIssuesSyncAdapter, type GraphAdapter, type GraphComplexityData, type GraphCouplingData, type GraphCoverageData, type GraphCriticalPathData, type GraphDependencyData, type GraphHarnessCheckData, type GraphImpactData, type Handoff, HandoffSchema, type HarnessState, HarnessStateSchema, type HealthCheckResult, type Hotspot, type HotspotContext, type Import, type InjectionFinding, type InjectionPattern, type InjectionSeverity, type InlineReference, type IntegrityReport, type InteractionType, InteractionTypeSchema, type InternalSymbol, type JSDocComment, LITELLM_PRICING_URL, type LanguageParser, type Layer, type LayerConfig, LayerViolationCollector, type LearningPattern, type LearningsFrontmatter, type LearningsIndexEntry, type LiteLLMModelEntry, type LiteLLMPricingData, type LoadEventsOptions, type Lockfile, type LockfilePackage, LockfilePackageSchema, LockfileSchema, type LogEntry, type LogFilter, type Manifest, ManifestSchema, type MechanicalCheckOptions, type MechanicalCheckResult, type MechanicalCheckStatus, type MechanicalFinding, type MergeResult, type Metric, MetricResult, type ModelProvider, type ModelTier, type ModelTierConfig, type ModuleDependency, ModuleSizeCollector, NoOpExecutor, NoOpSink, NoOpTelemetryAdapter, type OrphanedDep, type OutlineResult, type ParseError, type ParsedFile, type PatternConfig, PatternConfigSchema, type PatternMatch, type PatternReport, type PatternViolation, type PeerReview, type PeerReviewOptions, type PilotScoringOptions, type PipelineContext, type PipelineFlags, type PipelineOptions, type PipelineResult, type PrMetadata, type PricingCacheFile, type PricingDataset, type PriorReview, ProjectScanner, type PromoteResult, type ProviderDefaults, type PruneResult, type Question, QuestionSchema, REQUIRED_SECTIONS, type ReachabilityNode, RegressionDetector, type RegressionReport, type RegressionResult, type ReviewAgentDescriptor, type ReviewAssessment, type ReviewChecklist, type ReviewComment, type ReviewContext, type ReviewDomain, type ReviewFinding, type ReviewItem, type ReviewOutputOptions, type ReviewPipelineResult, type ReviewStrength, type RuleOverride, RuleRegistry, type RunCIChecksInput, type RunPipelineOptions, SECURITY_DESCRIPTOR, STALENESS_WARNING_DAYS, STATUS_RANK, type SafetyLevel, type ScanConfigFileResult, type ScanConfigFinding, type ScanConfigResult, type ScanResult, type ScoredCandidate, type SearchMatch, type SearchResult, type SecurityCategory, type SecurityConfidence, type SecurityConfig, SecurityConfigSchema, type SecurityFinding, type SecurityRule, SecurityScanner, type SecuritySeverity, type SelfReviewConfig, type SessionSummaryData, SharableBoundaryConfigSchema, SharableForbiddenImportSchema, SharableLayerSchema, SharableSecurityRulesSchema, type SizeBudgetConfig, type SizeBudgetReport, type SizeBudgetViolation, type SkillEvent, SkillEventSchema, type SkillExecutor, type SourceFile, type Span, type SpanEvent, type StaleConstraint, type StepExecutor, type StreamIndex, StreamIndexSchema, type StreamInfo, StreamInfoSchema, type StructureValidation, type Suggestion, type SuggestionReport, type SupportedLanguage, type SuppressionRecord, type SymbolKind, type SyncChange, type SyncOptions, type TaintCheckResult, type TaintFinding, type TaintState, type TelemetryAdapter, type TelemetryHealth, ThresholdConfig, type TimeRange, type TokenBudget, type TokenBudgetOverrides, type Trace, type TrackerSyncAdapter, type Transition, TransitionSchema, type TurnExecutor, TypeScriptParser, type UnfoldResult, type UnusedImport, type UpdateCheckState, VERSION, type ValidateFindingsOptions, type ValidationError, type WorkflowPhase, addProvenance, agentConfigRules, aggregateByDay, aggregateBySession, analyzeDiff, analyzeLearningPatterns, appendFailure, appendLearning, appendSessionEntry, applyFixes, applyHotspotDowngrade, applySyncChanges, archiveFailures, archiveLearnings, archiveSession, archiveStream, assignFeature, buildDependencyGraph, buildExclusionSet, buildSnapshot, calculateCost, checkDocCoverage, checkEligibility, checkEvidenceCoverage, checkTaint, classifyFinding, clearEventHashCache, clearFailuresCache, clearLearningsCache, clearTaint, computeOverallSeverity, computeScanExitCode, configureFeedback, constraintRuleId, contextBudget, contextFilter, countLearningEntries, createBoundaryValidator, createCommentedCodeFixes, createError, createFixes, createForbiddenImportFixes, createOrphanedDepFixes, createParseError, createSelfReview, createStream, cryptoRules, deduplicateCleanupFindings, deduplicateFindings, deepMergeConstraints, defaultCollectors, defineLayer, deserializationRules, detectChangeType, detectCircularDeps, detectCircularDepsInFiles, detectComplexityViolations, detectCouplingViolations, detectDeadCode, detectDocDrift, detectLanguage, detectPatternViolations, detectSizeBudgetViolations, detectStack, detectStaleConstraints, determineAssessment, diff, emitEvent, executeWorkflow, expressRules, extractBundle, extractIndexEntry, extractMarkdownLinks, extractSections, fanOutReview, formatEventTimeline, formatFindingBlock, formatGitHubComment, formatGitHubSummary, formatOutline, formatTerminalOutput, fullSync, generateAgentsMap, generateSuggestions, getActionEmitter, getExitCode, getFeedbackConfig, getInjectionPatterns, getModelPrice, getOutline, getParser, getPhaseCategories, getStreamForBranch, getTaintFilePath, getUpdateNotification, goRules, injectionRules, insecureDefaultsRules, isDuplicateFinding, isRegression, isSmallSuggestion, isUpdateCheckEnabled, listActiveSessions, listStreams, listTaintedSessions, loadBudgetedLearnings, loadEvents, loadFailures, loadHandoff, loadIndexEntries, loadPricingData, loadRelevantLearnings, loadSessionSummary, loadState, loadStreamIndex, logAgentAction, mapInjectionFindings, mapSecurityFindings, mapSecuritySeverity, mcpRules, migrateToStreams, networkRules, nodeRules, parseCCRecords, parseDateFromEntry, parseDiff, parseFile, parseFrontmatter, parseHarnessIgnore, parseLiteLLMData, parseManifest, parseRoadmap, parseSecurityConfig, parseSize, pathTraversalRules, previewFix, promoteSessionLearnings, pruneLearnings, reactRules, readCheckState, readCostRecords, readLockfile, readSessionSection, readSessionSections, readTaint, removeContributions, removeProvenance, requestMultiplePeerReviews, requestPeerReview, resetFeedbackConfig, resetParserCache, resolveFileToLayer, resolveModelTier, resolveReverseStatus, resolveRuleSeverity, resolveSessionDir, resolveStreamPath, resolveThresholds, runAll, runArchitectureAgent, runBugDetectionAgent, runCIChecks, runComplianceAgent, runMechanicalChecks, runMechanicalGate, runMultiTurnPipeline, runPipeline, runReviewPipeline, runSecurityAgent, saveHandoff, saveState, saveStreamIndex, scanForInjection, scopeContext, scoreRoadmapCandidates, searchSymbols, secretRules, serializeRoadmap, setActiveStream, sharpEdgesRules, shouldRunCheck, spawnBackgroundCheck, syncConstraintNodes, syncFromExternal, syncRoadmap, syncToExternal, tagUncitedFindings, touchStream, trackAction, unfoldRange, unfoldSymbol, updateSessionEntryStatus, updateSessionIndex, validateAgentsMap, validateBoundaries, validateCommitMessage, validateConfig, validateDependencies, validateFileStructure, validateFindings, validateKnowledgeMap, validatePatternConfig, violationId, writeConfig, writeLockfile, writeSessionSummary, writeTaint, xssRules };
+export { AGENT_DESCRIPTORS, ARCHITECTURE_DESCRIPTOR, type AST, type ActionContext, type ActionEvent, type ActionEventHandler, type ActionEventType, type ActionResult, type ActionSink, type ActionTracker, type ActionType, type AdjustedForecast, AdjustedForecastSchema, type AgentAction, AgentActionEmitter, type AgentExecutor, type AgentMapLink, type AgentMapSection, type AgentMapValidation, type AgentProcess, type AgentReviewResult, type AgentType, type AgentsMapConfig, ArchBaseline, ArchBaselineManager, ArchConfig, ArchDiffResult, ArchMetricCategory, BUG_DETECTION_DESCRIPTOR, type BaseError, type Baseline, BaselineManager, type BaselinesFile, type BenchmarkResult, type BenchmarkRunOptions, BenchmarkRunner, type BlueprintData, BlueprintGenerator, type BlueprintModule, type BlueprintOptions, type BoundaryDefinition, type BoundaryValidation, type BoundaryValidator, type BoundaryViolation, type BrokenLink, type BudgetedLearningsOptions, type Bundle, type BundleConstraints, BundleConstraintsSchema, BundleSchema, CACHE_TTL_MS, COMPLIANCE_DESCRIPTOR, type CategoryForecast, CategoryForecastSchema, CategorySnapshotSchema, type ChangeType, type ChangedFile, ChecklistBuilder, type CircularDependency, CircularDepsCollector, type CircularDepsResult, type CleanupFinding, type CodeBlock, type CodeChanges, type CodePattern, type CodeReference, type CodeSymbol, type CodebaseSnapshot, Collector, type CommentedCodeBlock, type CommitFormat, type CommitHistoryEntry, type CommitValidation, ComplexityCollector, type ComplexityConfig, type ComplexityReport, type ComplexityThresholds, type ComplexityViolation, type ConfidenceTier, ConfidenceTierSchema, type ConfigError, type ConfigPattern, type Confirmation, ConfirmationSchema, type ConflictReport, ConsoleSink, type ConstraintError, type ConstraintNodeStore, ConstraintRule, type Content, ContentPipeline, type ContextBundle, type ContextError, type ContextFile, type ContextFilterResult, type ContextScopeOptions, ContributingFeatureSchema, type Contributions, ContributionsSchema, type Convention, CouplingCollector, type CouplingConfig, type CouplingReport, type CouplingThresholds, type CouplingViolation, type CoverageOptions, type CoverageReport, type CriticalPathEntry, CriticalPathResolver, type CriticalPathSet, type CustomRule, type CustomRuleResult, DEFAULT_PROVIDER_TIERS, DEFAULT_SECURITY_CONFIG, DEFAULT_STABILITY_THRESHOLDS, DEFAULT_STATE, DEFAULT_STREAM_INDEX, DESTRUCTIVE_BASH, type DataPoint, type DeadCodeConfig, type DeadCodeReport, type DeadExport, type DeadFile, type DeadInternal, type DeduplicateFindingsOptions, DepDepthCollector, type DependencyEdge, type DependencyGraph, type DependencyValidation, type DependencyViolation, type DetectStaleResult, type DiffInfo, type Direction, DirectionSchema, type DocumentationDrift, type DocumentationFile, type DocumentationGap, type DriftConfig, type DriftReport, EXTENSION_MAP, type EligibilityResult, type EmitEventInput, type EmitEventOptions, type EmitEventResult, type EmitInteractionInput, EmitInteractionInputSchema, EntropyAnalyzer, type EntropyConfig, EntropyConfigSchema, type EntropyError, type EntropyReport, type EstimatorCoefficients, type EventType, type EvidenceCoverageReport, ExclusionSet, type ExecutorHealth, type Export, type ExportMap, type ExternalSyncOptions, type FailureEntry, FailureEntrySchema, type FallbackPricingFile, type FanOutOptions, type FeedbackAgentConfig, type FeedbackConfig, type FeedbackError$1 as FeedbackError, type FileCategory, FileSink, type FindingSeverity, type Fix, type FixConfig, type FixResult, type FixType, ForbiddenImportCollector, type ForbiddenImportViolation, type ForbiddenPattern, type GateConfig, GateConfigSchema, type GateResult, GateResultSchema, type GenerationSection, type GitHubInlineComment, GitHubIssuesSyncAdapter, type GraphAdapter, type GraphComplexityData, type GraphCouplingData, type GraphCoverageData, type GraphCriticalPathData, type GraphDependencyData, type GraphHarnessCheckData, type GraphImpactData, type Handoff, HandoffSchema, type HarnessState, HarnessStateSchema, type HealthCheckResult, type Hotspot, type HotspotContext, type Import, type InjectionFinding, type InjectionPattern, type InjectionSeverity, type InlineReference, type IntegrityReport, type InteractionType, InteractionTypeSchema, type InternalSymbol, type JSDocComment, LITELLM_PRICING_URL, type LanguageParser, type Layer, type LayerConfig, LayerViolationCollector, type LearningPattern, type LearningsFrontmatter, type LearningsIndexEntry, type LiteLLMModelEntry, type LiteLLMPricingData, type LoadEventsOptions, type Lockfile, type LockfilePackage, LockfilePackageSchema, LockfileSchema, type LogEntry, type LogFilter, type Manifest, ManifestSchema, type MechanicalCheckOptions, type MechanicalCheckResult, type MechanicalCheckStatus, type MechanicalFinding, type MergeResult, type Metric, MetricResult, type ModelProvider, type ModelTier, type ModelTierConfig, type ModuleDependency, ModuleSizeCollector, NoOpExecutor, NoOpSink, NoOpTelemetryAdapter, type OrphanedDep, type OutlineResult, type ParseError, type ParsedFile, type PatternConfig, PatternConfigSchema, type PatternMatch, type PatternReport, type PatternViolation, type PeerReview, type PeerReviewOptions, type PilotScoringOptions, type PipelineContext, type PipelineFlags, type PipelineOptions, type PipelineResult, type PrMetadata, PredictionEngine, type PredictionOptions, PredictionOptionsSchema, type RegressionResult as PredictionRegressionResult, RegressionResultSchema as PredictionRegressionResultSchema, type PredictionResult, PredictionResultSchema, type PredictionWarning, PredictionWarningSchema, type PricingCacheFile, type PricingDataset, type PriorReview, ProjectScanner, type PromoteResult, type ProviderDefaults, type PruneResult, type Question, QuestionSchema, REQUIRED_SECTIONS, type ReachabilityNode, RegressionDetector, type RegressionFit, type RegressionReport, type RegressionResult$1 as RegressionResult, type ReviewAgentDescriptor, type ReviewAssessment, type ReviewChecklist, type ReviewComment, type ReviewContext, type ReviewDomain, type ReviewFinding, type ReviewItem, type ReviewOutputOptions, type ReviewPipelineResult, type ReviewStrength, type RuleOverride, RuleRegistry, type RunCIChecksInput, type RunPipelineOptions, SECURITY_DESCRIPTOR, STALENESS_WARNING_DAYS, STATUS_RANK, type SafetyLevel, type ScanConfigFileResult, type ScanConfigFinding, type ScanConfigResult, type ScanResult, type ScoredCandidate, type SearchMatch, type SearchResult, type SecurityCategory, type SecurityConfidence, type SecurityConfig, SecurityConfigSchema, type SecurityFinding, type SecurityRule, SecurityScanner, type SecuritySeverity, type SelfReviewConfig, type SessionSummaryData, SharableBoundaryConfigSchema, SharableForbiddenImportSchema, SharableLayerSchema, SharableSecurityRulesSchema, type SizeBudgetConfig, type SizeBudgetReport, type SizeBudgetViolation, type SkillEvent, SkillEventSchema, type SkillExecutor, type SourceFile, type Span, type SpanEvent, type SpecImpactEstimate, SpecImpactEstimateSchema, SpecImpactEstimator, SpecImpactSignalsSchema, type StabilityForecast, StabilityForecastSchema, type StaleConstraint, type StepExecutor, type StreamIndex, StreamIndexSchema, type StreamInfo, StreamInfoSchema, type StructureValidation, type Suggestion, type SuggestionReport, type SupportedLanguage, type SuppressionRecord, type SymbolKind, type SyncChange, type SyncOptions, type TaintCheckResult, type TaintFinding, type TaintState, type TelemetryAdapter, type TelemetryHealth, ThresholdConfig, type TimeRange, type CategorySnapshot as TimelineCategorySnapshot, type TimelineFile, TimelineFileSchema, TimelineManager, type TimelineSnapshot, TimelineSnapshotSchema, type TokenBudget, type TokenBudgetOverrides, type Trace, type TrackerSyncAdapter, type Transition, TransitionSchema, type TrendLine, TrendLineSchema, type TrendResult, TrendResultSchema, type TurnExecutor, TypeScriptParser, type UnfoldResult, type UnusedImport, type UpdateCheckState, VERSION, type ValidateFindingsOptions, type ValidationError, type WorkflowPhase, addProvenance, agentConfigRules, aggregateByDay, aggregateBySession, analyzeDiff, analyzeLearningPatterns, appendFailure, appendLearning, appendSessionEntry, applyFixes, applyHotspotDowngrade, applyRecencyWeights, applySyncChanges, archiveFailures, archiveLearnings, archiveSession, archiveStream, assignFeature, buildDependencyGraph, buildExclusionSet, buildSnapshot, calculateCost, checkDocCoverage, checkEligibility, checkEvidenceCoverage, checkTaint, classifyConfidence, classifyFinding, clearEventHashCache, clearFailuresCache, clearLearningsCache, clearTaint, computeOverallSeverity, computeScanExitCode, configureFeedback, constraintRuleId, contextBudget, contextFilter, countLearningEntries, createBoundaryValidator, createCommentedCodeFixes, createError, createFixes, createForbiddenImportFixes, createOrphanedDepFixes, createParseError, createSelfReview, createStream, cryptoRules, deduplicateCleanupFindings, deduplicateFindings, deepMergeConstraints, defaultCollectors, defineLayer, deserializationRules, detectChangeType, detectCircularDeps, detectCircularDepsInFiles, detectComplexityViolations, detectCouplingViolations, detectDeadCode, detectDocDrift, detectLanguage, detectPatternViolations, detectSizeBudgetViolations, detectStack, detectStaleConstraints, determineAssessment, diff, emitEvent, executeWorkflow, expressRules, extractBundle, extractIndexEntry, extractMarkdownLinks, extractSections, fanOutReview, formatEventTimeline, formatFindingBlock, formatGitHubComment, formatGitHubSummary, formatOutline, formatTerminalOutput, fullSync, generateAgentsMap, generateSuggestions, getActionEmitter, getExitCode, getFeedbackConfig, getInjectionPatterns, getModelPrice, getOutline, getParser, getPhaseCategories, getStreamForBranch, getTaintFilePath, getUpdateNotification, goRules, injectionRules, insecureDefaultsRules, isDuplicateFinding, isRegression, isSmallSuggestion, isUpdateCheckEnabled, listActiveSessions, listStreams, listTaintedSessions, loadBudgetedLearnings, loadEvents, loadFailures, loadHandoff, loadIndexEntries, loadPricingData, loadRelevantLearnings, loadSessionSummary, loadState, loadStreamIndex, logAgentAction, mapInjectionFindings, mapSecurityFindings, mapSecuritySeverity, mcpRules, migrateToStreams, networkRules, nodeRules, parseCCRecords, parseDateFromEntry, parseDiff, parseFile, parseFrontmatter, parseHarnessIgnore, parseLiteLLMData, parseManifest, parseRoadmap, parseSecurityConfig, parseSize, pathTraversalRules, previewFix, projectValue, promoteSessionLearnings, pruneLearnings, reactRules, readCheckState, readCostRecords, readLockfile, readSessionSection, readSessionSections, readTaint, removeContributions, removeProvenance, requestMultiplePeerReviews, requestPeerReview, resetFeedbackConfig, resetParserCache, resolveFileToLayer, resolveModelTier, resolveReverseStatus, resolveRuleSeverity, resolveSessionDir, resolveStreamPath, resolveThresholds, runAll, runArchitectureAgent, runBugDetectionAgent, runCIChecks, runComplianceAgent, runMechanicalChecks, runMechanicalGate, runMultiTurnPipeline, runPipeline, runReviewPipeline, runSecurityAgent, saveHandoff, saveState, saveStreamIndex, scanForInjection, scopeContext, scoreRoadmapCandidates, searchSymbols, secretRules, serializeRoadmap, setActiveStream, sharpEdgesRules, shouldRunCheck, spawnBackgroundCheck, syncConstraintNodes, syncFromExternal, syncRoadmap, syncToExternal, tagUncitedFindings, touchStream, trackAction, unfoldRange, unfoldSymbol, updateSessionEntryStatus, updateSessionIndex, validateAgentsMap, validateBoundaries, validateCommitMessage, validateConfig, validateDependencies, validateFileStructure, validateFindings, validateKnowledgeMap, validatePatternConfig, violationId, weeksUntilThreshold, weightedLinearRegression, writeConfig, writeLockfile, writeSessionSummary, writeTaint, xssRules };