@harness-engineering/core 0.21.1 → 0.21.3

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-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';
+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, SkillInvocationRecord, SkillAdoptionSummary, StabilityTier, TelemetryIdentity, TelemetryConfig, ConsentState, TelemetryEvent } 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-D20x48U9.js';
@@ -1728,25 +1728,21 @@ declare class EntropyAnalyzer {
  */
 declare function buildSnapshot(config: EntropyConfig): Promise<Result<CodebaseSnapshot, EntropyError>>;
 
-/**
- * Detect documentation drift in a codebase.
- * When graphDriftData is provided, uses graph-derived edges instead of snapshot-based analysis.
- */
-declare function detectDocDrift(snapshot: CodebaseSnapshot, config?: Partial<DriftConfig>, graphDriftData?: {
+type GraphDriftData = {
     staleEdges: Array<{
         docNodeId: string;
         codeNodeId: string;
         edgeType: string;
     }>;
     missingTargets: string[];
-}): Promise<Result<DriftReport, EntropyError>>;
-
+};
 /**
- * Detect dead code in a codebase snapshot.
- * Analyzes exports, files, imports, and internal symbols to find unused code.
- * When graphDeadCodeData is provided, uses graph-derived reachability instead of snapshot-based BFS.
+ * Detect documentation drift in a codebase.
+ * When graphDriftData is provided, uses graph-derived edges instead of snapshot-based analysis.
  */
-declare function detectDeadCode(snapshot: CodebaseSnapshot, graphDeadCodeData?: {
+declare function detectDocDrift(snapshot: CodebaseSnapshot, config?: Partial<DriftConfig>, graphDriftData?: GraphDriftData): Promise<Result<DriftReport, EntropyError>>;
+
+type GraphDeadCodeData = {
     reachableNodeIds: Set<string> | string[];
     unreachableNodes: Array<{
         id: string;
@@ -1754,7 +1750,8 @@ declare function detectDeadCode(snapshot: CodebaseSnapshot, graphDeadCodeData?:
         name: string;
         path?: string;
     }>;
-}): Promise<Result<DeadCodeReport, EntropyError>>;
+};
+declare function detectDeadCode(snapshot: CodebaseSnapshot, graphDeadCodeData?: GraphDeadCodeData): Promise<Result<DeadCodeReport, EntropyError>>;
 
 /**
  * Detect pattern violations across a codebase
@@ -2796,6 +2793,7 @@ declare class CriticalPathResolver {
     resolve(graphData?: GraphCriticalPathData): Promise<CriticalPathSet>;
     private scanAnnotations;
     private walkDir;
+    private resolveFunctionName;
     private scanFile;
 }
 
@@ -3235,6 +3233,8 @@ declare class ModuleSizeCollector implements Collector {
 declare class DepDepthCollector implements Collector {
     readonly category: "dependency-depth";
     getRules(config: ArchConfig, _rootDir: string): ConstraintRule[];
+    private buildImportGraph;
+    private buildModuleMap;
     collect(config: ArchConfig, rootDir: string): Promise<MetricResult[]>;
 }
 
@@ -3333,21 +3333,6 @@ declare class ArchBaselineManager {
 
 declare function diff(current: MetricResult[], baseline: ArchBaseline): ArchDiffResult;
 
-/**
- * Resolve effective thresholds for a given scope.
- *
- * When scope is 'project' or has no matching module entry, returns
- * project-wide thresholds. Otherwise, merges project thresholds
- * with module-level overrides (module wins per-category).
- *
- * For object-valued thresholds (e.g. coupling: { maxFanIn, maxFanOut }),
- * performs a shallow merge at the category level:
- *   project { maxFanIn: 10, maxFanOut: 8 } + module { maxFanOut: 5 }
- *   => { maxFanIn: 10, maxFanOut: 5 }
- *
- * When either side is a scalar, the module value replaces the project
- * value entirely (no merge across scalar/object boundaries).
- */
 declare function resolveThresholds(scope: string, config: ArchConfig): ThresholdConfig;
 
 declare const CategorySnapshotSchema: z.ZodObject<{
@@ -4579,6 +4564,8 @@ declare class PredictionEngine {
      * Throws if fewer than 3 snapshots are available.
      */
     predict(options?: Partial<PredictionOptions>): PredictionResult;
+    private loadValidatedSnapshots;
+    private computeTimeOffsets;
     private resolveOptions;
     private resolveThresholds;
     private computeBaselines;
@@ -4602,6 +4589,7 @@ declare class PredictionEngine {
      * - info: threshold crossing <= 12w, any confidence
      */
     private generateWarnings;
+    private buildCategoryWarning;
     /**
      * Compute composite stability forecast by projecting per-category values
      * forward and computing stability scores at each horizon.
@@ -4858,6 +4846,57 @@ declare const DEFAULT_STATE: HarnessState;
 declare function loadState(projectPath: string, stream?: string, session?: string): Promise<Result<HarnessState, Error>>;
 declare function saveState(projectPath: string, state: HarnessState, stream?: string, session?: string): Promise<Result<void, Error>>;
 
+/**
+ * PackedEnvelope — the structured result of applying a compaction pipeline
+ * to one or more tool responses or content sections.
+ *
+ * Serialized as structured markdown for readability by AI agents.
+ * Example output:
+ *
+ *   <!-- packed: structural+truncate | 4200→1100 tokens (-74%) -->
+ *   ### [gather_context]
+ *   ...compacted content...
+ *
+ *   ### [docs/changes/spec.md]
+ *   ...compacted content...
+ */
+interface PackedEnvelope {
+    meta: {
+        /** Ordered list of strategy names applied. */
+        strategy: string[];
+        /** Estimated token count of the original input (chars / 4). */
+        originalTokenEstimate: number;
+        /** Estimated token count after compaction. */
+        compactedTokenEstimate: number;
+        /** Reduction percentage: (1 - compacted/original) * 100, rounded. */
+        reductionPct: number;
+        /** Whether this result was served from cache. */
+        cached: boolean;
+        /** Prompt cache read tokens (from provider response), if available. */
+        cacheReadTokens?: number;
+        /** Total input tokens sent to provider, if available. */
+        cacheInputTokens?: number;
+    };
+    sections: Array<{
+        /** Tool name, file path, or section label — used as the section heading. */
+        source: string;
+        /** Compacted content for this section. */
+        content: string;
+    }>;
+}
+/**
+ * Estimates token count using the chars/4 heuristic from the spec.
+ */
+declare function estimateTokens(content: string): number;
+/**
+ * Serializes a PackedEnvelope to the spec's structured markdown format:
+ *
+ *   <!-- packed: structural+truncate | 4200→1100 tokens (-74%) [cached] -->
+ *   ### [source-name]
+ *   content
+ */
+declare function serializeEnvelope(envelope: PackedEnvelope): string;
+
 interface LearningsFrontmatter {
     hash: string;
     tags: string[];
@@ -5338,6 +5377,12 @@ declare class SecurityScanner {
     scanContent(content: string, filePath: string, startLine?: number): SecurityFinding[];
     scanFile(filePath: string): Promise<SecurityFinding[]>;
     private scanContentForFile;
+    /** Build a finding for a suppression comment that is missing its justification. */
+    private buildSuppressionFinding;
+    /** Check one line against a rule's patterns; return a finding or null. */
+    private matchRuleLine;
+    /** Scan a single line against a resolved rule; push any findings into the array. */
+    private scanLineForRule;
     /**
      * Core scanning loop shared by scanContent and scanContentForFile.
      * Evaluates each rule against each line, handling suppression (FP gate)
@@ -6483,6 +6528,9 @@ declare class GitHubIssuesSyncAdapter implements TrackerSyncAdapter {
     createTicket(feature: RoadmapFeature, milestone: string): Promise<Result<ExternalTicket>>;
     updateTicket(externalId: string, changes: Partial<RoadmapFeature>, milestone?: string): Promise<Result<ExternalTicket>>;
     fetchTicketState(externalId: string): Promise<Result<ExternalTicketState>>;
+    private buildLabelsParam;
+    private issueToTicketState;
+    private fetchIssuePage;
     fetchAllTickets(): Promise<Result<ExternalTicketState[]>>;
     assignTicket(externalId: string, assignee: string): Promise<Result<void>>;
 }
@@ -6741,10 +6789,6 @@ declare class BlueprintGenerator {
     generate(data: BlueprintData, options: BlueprintOptions): Promise<void>;
 }
 
-declare class ContentPipeline {
-    generateModuleContent(module: BlueprintModule): Promise<Content>;
-}
-
 interface UpdateCheckState {
     lastCheckTime: number;
     latestVersion: string | null;
@@ -6900,7 +6944,7 @@ declare function aggregateBySession(records: UsageRecord[]): SessionUsage[];
  * Aggregates an array of UsageRecords into per-day summaries.
  * Groups by calendar date (UTC) derived from the record timestamp.
  */
-declare function aggregateByDay(records: UsageRecord[]): DailyUsage[];
+declare function aggregateByDay$1(records: UsageRecord[]): DailyUsage[];
 
 /**
  * Reads .harness/metrics/costs.jsonl and normalizes snake_case hook output
@@ -6923,24 +6967,297 @@ declare function readCostRecords(projectRoot: string): UsageRecord[];
 declare function parseCCRecords(): UsageRecord[];
 
 /**
- * @harness-engineering/core
+ * Reads .harness/metrics/adoption.jsonl and returns parsed SkillInvocationRecord[].
  *
- * Core library for Harness Engineering toolkit.
- * This library provides the fundamental building blocks for codebase analysis,
- * validation, entropy management, and agent-driven workflows.
+ * - Returns empty array if the file does not exist
+ * - Skips malformed lines with a warning to stderr
+ * - Skips blank lines silently
+ */
+declare function readAdoptionRecords(projectRoot: string): SkillInvocationRecord[];
+
+/**
+ * Return type for daily aggregation.
+ */
+interface DailyAdoption {
+    /** Calendar date (YYYY-MM-DD) */
+    date: string;
+    /** Number of invocations on this date */
+    invocations: number;
+    /** Count of distinct skills invoked on this date */
+    uniqueSkills: number;
+}
+/**
+ * Aggregates records by skill name into SkillAdoptionSummary[].
+ * Sorted by invocation count descending.
  */
+declare function aggregateBySkill(records: SkillInvocationRecord[]): SkillAdoptionSummary[];
 /**
- * Re-export all fundamental types from the types package.
+ * Aggregates records by calendar date (derived from startedAt).
+ * Sorted by date descending (most recent first).
  */
+declare function aggregateByDay(records: SkillInvocationRecord[]): DailyAdoption[];
+/**
+ * Returns the top N skills by invocation count.
+ * Convenience wrapper over aggregateBySkill.
+ */
+declare function topSkills(records: SkillInvocationRecord[], n: number): SkillAdoptionSummary[];
 
 /**
- * The current version of the Harness Engineering core library.
+ * CompactionStrategy — the shared interface for all compaction strategies.
+ * Defined here in structural.ts as the foundation type; re-exported from
+ * packages/core/src/compaction/index.ts.
+ */
+interface CompactionStrategy {
+    name: 'structural' | 'truncate' | 'pack' | 'semantic';
+    lossy: boolean;
+    apply(content: string, budget?: number): string;
+}
+/**
+ * Lossless structural compressor.
+ *
+ * For valid JSON input:
+ * - Removes null, undefined, empty-string, empty-array, and empty-object fields
+ * - Collapses single-item arrays to scalar values
+ * - Strips redundant whitespace from string values (leading/trailing and internal runs)
+ * - Normalizes output to compact JSON (no pretty-printing)
  *
- * @deprecated Read the CLI version from `@harness-engineering/cli/package.json`
- * instead. This hardcoded constant drifts from the actual CLI version on each
- * release. Kept only as a fallback for consumers that cannot resolve the CLI
- * package at runtime.
+ * For non-JSON input: returns the string unchanged.
  */
-declare const VERSION = "0.15.0";
+declare class StructuralStrategy implements CompactionStrategy {
+    readonly name: "structural";
+    readonly lossy = false;
+    apply(content: string, _budget?: number): string;
+}
+
+declare const DEFAULT_TOKEN_BUDGET = 4000;
+/**
+ * Prioritized budget truncation.
+ *
+ * Splits content into lines, scores each line for semantic priority, and
+ * rebuilds output within the token budget by including the highest-priority
+ * lines first. A truncation marker is appended when lines are cut.
+ *
+ * Default budget: 4000 tokens (4000 * 4 = 16 000 chars).
+ */
+declare class TruncationStrategy implements CompactionStrategy {
+    readonly name: "truncate";
+    readonly lossy = false;
+    apply(content: string, budget?: number): string;
+}
+
+/**
+ * CompactionPipeline composes an ordered list of CompactionStrategy instances
+ * and applies them in sequence, passing the output of each strategy as the
+ * input to the next.
+ *
+ * Budget is forwarded to every strategy unchanged — each strategy applies
+ * its own interpretation of the budget.
+ */
+declare class CompactionPipeline {
+    private readonly strategies;
+    constructor(strategies: CompactionStrategy[]);
+    /** The ordered list of strategy names in this pipeline. */
+    get strategyNames(): string[];
+    /**
+     * Apply all strategies in order.
+     * @param content — input string
+     * @param budget — optional token budget forwarded to each strategy
+     */
+    apply(content: string, budget?: number): string;
+}
+
+/**
+ * Resolve the stability tier for a content type or graph node type.
+ *
+ * Accepts both PascalCase display names (e.g., 'SkillDefinition') and
+ * lowercase NodeType enum values (e.g., 'file', 'packed_summary').
+ *
+ * Returns 'ephemeral' for any unrecognized type.
+ */
+declare function resolveStability(contentType: string): StabilityTier;
+
+/**
+ * A content block tagged with its stability classification.
+ * Used by CacheAdapter.orderContent() to sort blocks for optimal cache hits.
+ */
+interface StabilityTaggedBlock {
+    /** Stability classification of this content */
+    stability: StabilityTier;
+    /** The content payload (system prompt text, tool output, etc.) */
+    content: string;
+    /** The role this block serves in the message (system, user, assistant) */
+    role: 'system' | 'user' | 'assistant';
+}
+/**
+ * Provider-formatted system prompt block.
+ * Shape varies by provider -- may include cache_control (Anthropic),
+ * cachedContentRef (Gemini), or plain text (OpenAI).
+ */
+interface ProviderSystemBlock {
+    type: 'text';
+    text: string;
+    /** Anthropic cache control directive */
+    cache_control?: {
+        type: 'ephemeral';
+        ttl?: string;
+    };
+    /** Gemini cached content reference */
+    cachedContentRef?: string;
+}
+/**
+ * A tool definition as passed to provider APIs.
+ * Minimal shape -- provider adapters may extend individual entries.
+ */
+interface ToolDefinition {
+    name: string;
+    description: string;
+    input_schema: Record<string, unknown>;
+    /** Anthropic cache control directive (added by adapter) */
+    cache_control?: {
+        type: 'ephemeral';
+        ttl?: string;
+    };
+}
+/**
+ * Provider-formatted tool block wrapping an array of tool definitions.
+ */
+interface ProviderToolBlock {
+    tools: ToolDefinition[];
+}
+/**
+ * Unified interface for provider-specific prompt cache behavior.
+ *
+ * Each provider has different mechanisms for prompt caching:
+ * - Anthropic: explicit cache_control breakpoints
+ * - OpenAI: automatic prefix-matching (content ordering matters)
+ * - Gemini: cachedContents resource for static content
+ *
+ * Adapters translate stability tiers into provider-native directives.
+ */
+interface CacheAdapter {
+    /** Provider identifier */
+    provider: 'claude' | 'openai' | 'gemini';
+    /** Wrap a system prompt block with provider-specific cache directives */
+    wrapSystemBlock(content: string, stability: StabilityTier): ProviderSystemBlock;
+    /** Wrap tool definitions with provider-specific cache directives */
+    wrapTools(tools: ToolDefinition[], stability: StabilityTier): ProviderToolBlock;
+    /** Order message content blocks for optimal cache hit rates */
+    orderContent(blocks: StabilityTaggedBlock[]): StabilityTaggedBlock[];
+    /** Extract cache token counts from a provider API response */
+    parseCacheUsage(response: unknown): {
+        cacheCreationTokens: number;
+        cacheReadTokens: number;
+    };
+}
+
+/**
+ * Anthropic cache adapter.
+ *
+ * Uses explicit `cache_control` breakpoints on content blocks:
+ * - static: cache_control with type "ephemeral" and ttl "1h"
+ * - session: cache_control with type "ephemeral" (default 5m TTL)
+ * - ephemeral: no cache_control (not cached)
+ *
+ * Tool definitions get cache_control on the last entry (Anthropic's
+ * breakpoint model caches everything up to and including the marked block).
+ */
+declare class AnthropicCacheAdapter implements CacheAdapter {
+    readonly provider: "claude";
+    wrapSystemBlock(content: string, stability: StabilityTier): ProviderSystemBlock;
+    wrapTools(tools: ToolDefinition[], stability: StabilityTier): ProviderToolBlock;
+    orderContent(blocks: StabilityTaggedBlock[]): StabilityTaggedBlock[];
+    parseCacheUsage(response: unknown): {
+        cacheCreationTokens: number;
+        cacheReadTokens: number;
+    };
+}
+
+/**
+ * OpenAI cache adapter.
+ *
+ * OpenAI uses automatic prefix-matching for prompt caching -- no explicit
+ * cache directives are needed. The only optimization is content ordering:
+ * static content first, then session, then ephemeral. This maximizes the
+ * stable prefix length that OpenAI's automatic caching can match.
+ *
+ * wrapSystemBlock and wrapTools are passthroughs.
+ */
+declare class OpenAICacheAdapter implements CacheAdapter {
+    readonly provider: "openai";
+    wrapSystemBlock(content: string, _stability: StabilityTier): ProviderSystemBlock;
+    wrapTools(tools: ToolDefinition[], _stability: StabilityTier): ProviderToolBlock;
+    orderContent(blocks: StabilityTaggedBlock[]): StabilityTaggedBlock[];
+    parseCacheUsage(response: unknown): {
+        cacheCreationTokens: number;
+        cacheReadTokens: number;
+    };
+}
+
+/**
+ * Gemini cache adapter.
+ *
+ * Gemini uses explicit `cachedContents` resources for static content:
+ * - static: marked with cachedContentRef for the orchestrator to resolve
+ *   into a real cachedContents/{id} via the Gemini API
+ * - session: passthrough (relies on implicit caching in Gemini 2.5+)
+ * - ephemeral: passthrough
+ *
+ * Tools are passed through unchanged -- Gemini caches tools as part
+ * of the cachedContents resource when applicable.
+ */
+declare class GeminiCacheAdapter implements CacheAdapter {
+    readonly provider: "gemini";
+    wrapSystemBlock(content: string, stability: StabilityTier): ProviderSystemBlock;
+    wrapTools(tools: ToolDefinition[], _stability: StabilityTier): ProviderToolBlock;
+    orderContent(blocks: StabilityTaggedBlock[]): StabilityTaggedBlock[];
+    parseCacheUsage(response: unknown): {
+        cacheCreationTokens: number;
+        cacheReadTokens: number;
+    };
+}
+
+/**
+ * Reads optional identity fields from `.harness/telemetry.json`.
+ * Returns empty object if the file is missing or malformed.
+ */
+declare function readIdentity(projectRoot: string): TelemetryIdentity;
+/**
+ * Resolves telemetry consent by checking (in order):
+ * 1. DO_NOT_TRACK=1 env var (ecosystem standard)
+ * 2. HARNESS_TELEMETRY_OPTOUT=1 env var
+ * 3. config.enabled (from harness.config.json telemetry section)
+ *
+ * If allowed, reads install ID and optional identity fields.
+ */
+declare function resolveConsent(projectRoot: string, config: TelemetryConfig | undefined): ConsentState;
+
+/**
+ * Reads or creates a persistent UUIDv4 install ID at `.harness/.install-id`.
+ *
+ * The ID is anonymous -- it correlates events from the same machine without
+ * containing any PII. Created on first telemetry call, reused thereafter.
+ */
+declare function getOrCreateInstallId(projectRoot: string): string;
+
+/**
+ * Reads adoption.jsonl records and formats them as TelemetryEvent payloads.
+ *
+ * Requires an allowed ConsentState (discriminated union with allowed: true).
+ * Populates OS, Node version, harness version, and optional identity fields.
+ */
+declare function collectEvents(projectRoot: string, consent: ConsentState & {
+    allowed: true;
+}): TelemetryEvent[];
+
+/**
+ * Sends telemetry events to PostHog HTTP /batch endpoint.
+ *
+ * - 3 attempts with linear backoff (1s, 2s)
+ * - 5s timeout per attempt via AbortSignal.timeout
+ * - Silent failure: never throws, never blocks session teardown
+ */
+declare function send(events: TelemetryEvent[], apiKey: string): Promise<void>;
+
+declare const VERSION = "0.21.3";
 
-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, computeContentHash, 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, normalizeLearningContent, 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 };
+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, AnthropicCacheAdapter, 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 CacheAdapter, 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, CompactionPipeline, type CompactionStrategy, 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, 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, DEFAULT_TOKEN_BUDGET, DESTRUCTIVE_BASH, type DailyAdoption, 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, GeminiCacheAdapter, 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, OpenAICacheAdapter, type OrphanedDep, type OutlineResult, type PackedEnvelope, 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 ProviderSystemBlock, type ProviderToolBlock, 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 StabilityTaggedBlock, type StaleConstraint, type StepExecutor, type StreamIndex, StreamIndexSchema, type StreamInfo, StreamInfoSchema, StructuralStrategy, 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 ToolDefinition, type Trace, type TrackerSyncAdapter, type Transition, TransitionSchema, type TrendLine, TrendLineSchema, type TrendResult, TrendResultSchema, TruncationStrategy, type TurnExecutor, TypeScriptParser, type UnfoldResult, type UnusedImport, type UpdateCheckState, VERSION, type ValidateFindingsOptions, type ValidationError, type WorkflowPhase, addProvenance, agentConfigRules, aggregateByDay as aggregateAdoptionByDay, aggregateByDay$1 as aggregateByDay, aggregateBySession, aggregateBySkill, 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, collectEvents, computeContentHash, 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, estimateTokens, executeWorkflow, expressRules, extractBundle, extractIndexEntry, extractMarkdownLinks, extractSections, fanOutReview, formatEventTimeline, formatFindingBlock, formatGitHubComment, formatGitHubSummary, formatOutline, formatTerminalOutput, fullSync, generateAgentsMap, generateSuggestions, getActionEmitter, getExitCode, getFeedbackConfig, getInjectionPatterns, getModelPrice, getOrCreateInstallId, 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, normalizeLearningContent, parseCCRecords, parseDateFromEntry, parseDiff, parseFile, parseFrontmatter, parseHarnessIgnore, parseLiteLLMData, parseManifest, parseRoadmap, parseSecurityConfig, parseSize, pathTraversalRules, previewFix, projectValue, promoteSessionLearnings, pruneLearnings, reactRules, readAdoptionRecords, readCheckState, readCostRecords, readIdentity, readLockfile, readSessionSection, readSessionSections, readTaint, removeContributions, removeProvenance, requestMultiplePeerReviews, requestPeerReview, resetFeedbackConfig, resetParserCache, resolveConsent, resolveFileToLayer, resolveModelTier, resolveReverseStatus, resolveRuleSeverity, resolveSessionDir, resolveStability, resolveStreamPath, resolveThresholds, runAll, runArchitectureAgent, runBugDetectionAgent, runCIChecks, runComplianceAgent, runMechanicalChecks, runMechanicalGate, runMultiTurnPipeline, runPipeline, runReviewPipeline, runSecurityAgent, saveHandoff, saveState, saveStreamIndex, scanForInjection, scopeContext, scoreRoadmapCandidates, searchSymbols, secretRules, send, serializeEnvelope, serializeRoadmap, setActiveStream, sharpEdgesRules, shouldRunCheck, spawnBackgroundCheck, syncConstraintNodes, syncFromExternal, syncRoadmap, syncToExternal, tagUncitedFindings, topSkills, touchStream, trackAction, unfoldRange, unfoldSymbol, updateSessionEntryStatus, updateSessionIndex, validateAgentsMap, validateBoundaries, validateCommitMessage, validateConfig, validateDependencies, validateFileStructure, validateFindings, validateKnowledgeMap, validatePatternConfig, violationId, weeksUntilThreshold, weightedLinearRegression, writeConfig, writeLockfile, writeSessionSummary, writeTaint, xssRules };