@harness-engineering/core 0.26.0 → 0.26.1

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { Result, LoadingLevel, SkillContextBudget, SessionSectionName, SessionEntry, SessionSections, WorkflowStep, WorkflowStepResult, Workflow, WorkflowResult, SkillLifecycleHooks, SkillContext, SkillResult, TurnContext, CICheckName, CIFailOnSeverity, CICheckReport, RoadmapFeature, ExternalTicket, ExternalTicketState, TrackerComment, TrackerSyncConfig, CINotifyOptions, Roadmap, FeatureStatus, SyncResult, Priority, ModelPricing, UsageRecord, DailyUsage, SessionUsage, SkillInvocationRecord, SkillAdoptionSummary, StabilityTier, TelemetryIdentity, TelemetryConfig, ConsentState, TelemetryEvent, SolutionCategory, SanitizedResult, PulseConfig, PulseAdapter, PulseWindow } from '@harness-engineering/types';
+import { Result, LoadingLevel, SkillContextBudget, SessionSectionName, SessionEntry, SessionSections, WorkflowStep, WorkflowStepResult, Workflow, WorkflowResult, SkillLifecycleHooks, SkillContext, SkillResult, TurnContext, CICheckName, CIFailOnSeverity, CICheckReport, RoadmapFeature, ExternalTicket, ExternalTicketState, TrackerComment, TrackerSyncConfig, CINotifyOptions, Roadmap, FeatureStatus, SyncResult, Priority, ModelPricing, UsageRecord, DailyUsage, SessionUsage, SkillInvocationRecord, SkillAdoptionSummary, StabilityTier, TelemetryIdentity, TelemetryConfig, ConsentState, TelemetryEvent, PromptCacheStats, SolutionCategory, SanitizedResult, PulseConfig, PulseAdapter, PulseWindow } from '@harness-engineering/types';
 export * from '@harness-engineering/types';
 export { BlockerRef, BugTrackCategory, Issue, IssueTrackerClient, KnowledgeTrackCategory, PulseAdapter, PulseConfig, PulseDbSource, PulseRunStatus, PulseRunStatusType, PulseSources, PulseWindow, SanitizeFn, SanitizedResult, SolutionCategory, SolutionDocFrontmatter, SolutionTrack, TrackerConfig } from '@harness-engineering/types';
 import { z } from 'zod';
@@ -8804,6 +8804,16 @@ declare function isUpdateCheckEnabled(configInterval?: number): boolean;
  * If state is null (never checked), returns true.
  */
 declare function shouldRunCheck(state: UpdateCheckState | null, intervalMs: number): boolean;
+/**
+ * Removes the cached update-check state.
+ *
+ * Call after a successful `harness update` so the next CLI invocation cannot
+ * print a stale "Update available" notification reflecting the pre-upgrade
+ * state. With the file gone, `readCheckState` returns null and the
+ * notification path bails out; the next invocation will rerun the background
+ * check on its normal cadence.
+ */
+declare function invalidateCheckState(): void;
 /**
  * Reads the update check state from ~/.harness/update-check.json.
  * Returns null if the file is missing, unreadable, or has invalid content.
@@ -9296,6 +9306,188 @@ declare function collectEvents(projectRoot: string, consent: ConsentState & {
  */
 declare function send(events: TelemetryEvent[], apiKey: string): Promise<void>;
 
+/**
+ * CacheMetricsRecorder — in-memory ring buffer recording prompt-cache
+ * hits/misses per backend invocation. Powers `GET /api/v1/telemetry/cache/stats`
+ * and the dashboard `/insights/cache` widget.
+ *
+ * Design notes:
+ * - Sliding window of the last `capacity` records (default 1000). When
+ *   the buffer is full, oldest records are evicted FIFO. Restarts reset
+ *   the window — this is intentional: prompt-cache hit-rate is a
+ *   debugging/observability signal, not an audit record.
+ * - `windowStartedAt` is set on the first `record()` after construction
+ *   (or after `reset()`) and is reported as a unix-ms timestamp. Empty
+ *   recorders report `0` so the API response remains JSON-stable.
+ * - All operations are O(1) amortized; `record()` is on the hot path
+ *   for every Anthropic response and must not allocate.
+ */
+
+interface CacheMetricsRecorderOptions {
+    capacity?: number;
+    /** Injectable clock for deterministic testing. Defaults to `Date.now`. */
+    now?: () => number;
+}
+declare class CacheMetricsRecorder {
+    private readonly capacity;
+    private readonly now;
+    private readonly buffer;
+    private windowStartedAt;
+    constructor(opts?: CacheMetricsRecorderOptions);
+    /**
+     * Append a single cache observation. Hot-path: O(1) amortized, no
+     * allocations beyond the sample object itself.
+     */
+    record(backendId: string, hit: boolean, tokensCreated: number, tokensRead: number): void;
+    /** Aggregate the current window into a `PromptCacheStats` snapshot. */
+    getStats(): PromptCacheStats;
+    /** Clear the buffer and reset the window-start marker. */
+    reset(): void;
+}
+
+/**
+ * In-tree trace span shapes for the OTLP/HTTP JSON exporter.
+ *
+ * These are the internal representations the orchestrator buffers and
+ * hands to `OTLPExporter.push()`. The exporter converts them to the OTLP
+ * wire format (string-encoded int64 timestamps, hex-encoded ids) before
+ * serializing as JSON for `/v1/traces` requests.
+ *
+ * See `packages/types/src/telemetry.ts` for the OTLP wire-format shapes
+ * and the rationale for stringly-typed nanosecond timestamps.
+ */
+/**
+ * SpanKind enum mirroring the OTel spec values 1..5. Spans emitted by
+ * the orchestrator are predominantly `INTERNAL`; we leave the other
+ * variants exposed for future producer/consumer fanout instrumentation.
+ */
+declare enum SpanKind {
+    INTERNAL = 1,
+    SERVER = 2,
+    CLIENT = 3,
+    PRODUCER = 4,
+    CONSUMER = 5
+}
+/**
+ * Free-form attribute bag attached to a span. Values must be scalar:
+ * strings, numbers, or booleans (the OTLP/HTTP JSON converter only
+ * supports `stringValue` / `intValue` / `doubleValue` / `boolValue`).
+ */
+interface SpanAttributes {
+    [key: string]: string | number | boolean;
+}
+/**
+ * A completed trace span ready for export. `startTimeNs` and `endTimeNs`
+ * are unix epoch nanoseconds as `bigint` (JS `number` cannot losslessly
+ * hold int64); the exporter stringifies them for the OTLP JSON payload.
+ *
+ * `traceId` is a 32-char lowercase hex string (16 bytes); `spanId` and
+ * `parentSpanId` are 16-char lowercase hex strings (8 bytes) per the
+ * OTel trace context spec.
+ *
+ * `statusCode` follows OTel convention: 0 = UNSET, 1 = OK, 2 = ERROR.
+ */
+interface TraceSpan {
+    traceId: string;
+    spanId: string;
+    parentSpanId?: string;
+    name: string;
+    kind: SpanKind;
+    startTimeNs: bigint;
+    endTimeNs: bigint;
+    attributes: SpanAttributes;
+    statusCode?: 0 | 1 | 2;
+}
+
+/**
+ * OTLPExporter — hand-rolled OTLP/HTTP JSON exporter for trace spans.
+ *
+ * Buffers `TraceSpan` instances in-memory and flushes them as OTLP/HTTP
+ * v1.0.0 JSON payloads to a configurable `/v1/traces` endpoint on a
+ * timer (default 2 s) or when the batch size is hit (default 64).
+ *
+ * Design contracts:
+ * - {@link push} is synchronous and never awaits. The orchestrator hot
+ *   path may call `push()` thousands of times per second; we must add
+ *   < 5 ms p99 to dispatch latency (Phase 5 acceptance criterion).
+ * - {@link flush} is fire-and-forget. On HTTP failure we retry up to 3
+ *   times with 1 s / 2 s / 4 s backoff, then drop the batch and log a
+ *   single `console.warn`. The exporter never queues to disk.
+ * - When `enabled: false`, {@link push} is a constant-time no-op so
+ *   callers can wire the recorder unconditionally without branching.
+ * - {@link stop} flushes the remaining buffer before resolving so we
+ *   don't lose data on graceful shutdown.
+ *
+ * Wire format (per OTLP/HTTP v1.0.0 spec):
+ * ```json
+ * {
+ *   "resourceSpans": [{
+ *     "resource": { "attributes": [{ "key": "service.name", "value": { "stringValue": "harness" } }] },
+ *     "scopeSpans": [{
+ *       "scope": { "name": "harness" },
+ *       "spans": [ ...OTLPSpan[] ]
+ *     }]
+ *   }]
+ * }
+ * ```
+ *
+ * `traceId` / `spanId` are lowercase hex strings (16 / 8 bytes); time
+ * fields are stringly-typed nanoseconds (JSON cannot losslessly hold
+ * int64).
+ */
+
+interface OTLPExporterOptions {
+    /** Full OTLP/HTTP traces endpoint, e.g. `http://localhost:4318/v1/traces`. */
+    endpoint: string;
+    /** Default `true`. When `false`, push() is a no-op. */
+    enabled?: boolean;
+    /** Custom headers (auth tokens, etc.). */
+    headers?: Record<string, string>;
+    /** Flush interval in ms. Default 2000. */
+    flushIntervalMs?: number;
+    /** Buffer size that triggers an immediate flush. Default 64. */
+    batchSize?: number;
+    /** Injectable fetch for tests. Defaults to `globalThis.fetch`. */
+    fetchImpl?: typeof fetch;
+    /** Injectable warn for tests. Defaults to `console.warn`. */
+    warn?: (...args: unknown[]) => void;
+}
+declare class OTLPExporter {
+    private readonly endpoint;
+    private readonly enabled;
+    private readonly headers;
+    private readonly flushIntervalMs;
+    private readonly batchSize;
+    private readonly fetchImpl;
+    private readonly warn;
+    private buffer;
+    private timer;
+    private readonly inFlightFlushes;
+    constructor(opts: OTLPExporterOptions);
+    /**
+     * O(1) buffer push. When `enabled === false` this is a no-op. If the
+     * buffer reaches `batchSize`, a flush is triggered without awaiting.
+     */
+    push(span: TraceSpan): void;
+    /** Start the periodic flush timer. Idempotent. */
+    start(): void;
+    /** Flush any pending spans and stop the timer. Awaits all in-flight flushes. */
+    stop(): Promise<void>;
+    /**
+     * Synchronously claim the current buffer and POST it to `/v1/traces`.
+     * Each invocation runs independently — concurrent flushes (e.g. one
+     * from the timer, one from a `batchSize` trip) each drain their own
+     * batch. Retries up to 3 times on transport or 5xx failure, then
+     * drops with a single warning.
+     */
+    private flush;
+    /**
+     * Build the OTLP/HTTP JSON envelope for a batch of spans. Public for
+     * tests; not part of the supported API surface.
+     */
+    spansToOTLPJSON(spans: TraceSpan[]): unknown;
+}
+
 declare class CompoundLockHeldError extends Error {
     readonly category: SolutionCategory;
     readonly holderPid: number;
@@ -9722,6 +9914,6 @@ interface AssembleInput {
 }
 declare function assembleCandidateReport(input: AssembleInput): string;
 
-declare const VERSION = "0.23.3";
+declare const VERSION = "0.25.0";
 
-export { AGENT_DESCRIPTORS, AGREEMENT_LINE_GAP, ALLOWED_FIELD_KEYS, ALL_SOLUTION_CATEGORIES, ARCHITECTURE_DESCRIPTOR, type AST, type AcquireOptions, type ActionContext, type ActionEvent, type ActionEventHandler, type ActionEventType, type ActionResult, type ActionSink, type ActionTracker, type ActionType, type AdjustedForecast, AdjustedForecastSchema, type AgentAction, AgentActionEmitter, type AgentConfigFallbackReason, type AgentConfigFinding, type AgentConfigOptions, type AgentConfigSeverity, type AgentConfigValidation, type AgentExecutor, type AgentMapLink, type AgentMapSection, type AgentMapValidation, type AgentProcess, type AgentReviewResult, type AgentType, type AgentsMapConfig, type AnnotationIssue, type AnnotationIssueType, AnthropicCacheAdapter, type AppendLearningResult, ArchBaseline, ArchBaselineManager, ArchConfig, ArchDiffResult, ArchMetricCategory, type AssembleInput, BUG_DETECTION_DESCRIPTOR, BUG_TRACK_CATEGORIES, 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 BranchValidationResult, type BranchingConfig, type BrokenLink, type BudgetedLearningsOptions, type Bundle, type BundleConstraints, BundleConstraintsSchema, BundleSchema, CACHE_TTL_MS, CINotifier, COMPLIANCE_DESCRIPTOR, CORROBORATED_AGREEMENT, 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 CompoundLockHandle, CompoundLockHeldError, type ConfidenceTier, ConfidenceTierSchema, type ConfigError, type ConfigPattern, type Confirmation, ConfirmationSchema, ConflictError, 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_LOADER_CONFIG, DEFAULT_PROVIDER_TIERS, DEFAULT_SECURITY_CONFIG, DEFAULT_STABILITY_THRESHOLDS, DEFAULT_STATE, DEFAULT_STREAM_INDEX, DEFAULT_TOKEN_BUDGET, DESTRUCTIVE_BASH, DOMAIN_BASELINES, 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$1 as Direction, DirectionSchema$1 as DirectionSchema, type DocumentationDrift, type DocumentationFile, type DocumentationGap, type DriftConfig, type DriftReport, EMPTY_SUPPLY_CHAIN, ETagStore, EVIDENCE_SATURATION, EXTENSION_MAP, type EligibilityResult, EmergenceResult, 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, FACTOR_WEIGHTS, type FailureEntry, FailureEntrySchema, type FallbackPricingFile, type FanOutOptions, type FeaturePatch, type FeedbackAgentConfig, type FeedbackConfig, type FeedbackError$1 as FeedbackError, type FileCategory, type FileLessScoredCandidate, FileSink, type FindingLifecycle, FindingLifecycleSchema, type FindingSeverity, type Fix, type FixConfig, type FixResult, type FixType, ForbiddenImportCollector, type ForbiddenImportViolation, type ForbiddenPattern, type GateConfig, GateConfigSchema, type GateResult, GateResultSchema, GeminiCacheAdapter, type GenerateRubricOptions, type GenerationSection, type GitHubInlineComment, GitHubIssuesSyncAdapter, type GitScanOptions, type GraphAdapter, type GraphComplexityData, type GraphCouplingData, type GraphCoverageData, type GraphCriticalPathData, type GraphDependencyData, type GraphHarnessCheckData, type GraphImpactData, type GraphNode, type Handoff, HandoffSchema, type HarnessState, HarnessStateSchema, type HealthCheckResult, type HistoryEvent, type HistoryEventType, type Hotspot$1 as Hotspot, type HotspotContext, type Import, type InjectionFinding, type InjectionPattern, type InjectionSeverity, type InlineReference, type IntegrityReport, type InteractionType, InteractionTypeSchema, type InternalSymbol, type IsoWeek, type JSDocComment, KNOWLEDGE_TRACK_CATEGORIES, LITELLM_PRICING_URL, type LanguageParser, type Layer, type LayerConfig, LayerViolationCollector, type LearningPattern, type LearningsFrontmatter, type LearningsIndexEntry, type LiteLLMModelEntry, type LiteLLMPricingData, type LoadEventsOptions, type LoaderConfig, type Lockfile, type LockfilePackage, LockfilePackageSchema, LockfileSchema, type LogEntry, type LogFilter, MOCK_ADAPTER_NAME, type MakeTrackerConflictBodyOptions, 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, type NewFeatureInput, NoOpExecutor, NoOpSink, NoOpTelemetryAdapter, OpenAICacheAdapter, type OrchestratorResult, type OrphanedDep, type OutlineResult, type OverlapDimensions, type OverlapResult, PII_FIELD_DENYLIST, PII_LINE_RE, PII_TOKENS, type PackedEnvelope, type PaginatedSlice, type PaginationMeta, type ParallelGroups, type ParseError, type ParsedFile, type ParsedSection, type ParserLookup, 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 ProtectedRegion, type ProtectedRegionMap, type ProtectionScope, type ProviderDefaults, type ProviderSystemBlock, type ProviderToolBlock, type PruneResult, PulseAdapterAlreadyRegisteredError, PulseConfigSchema, type PulseConfigValidation, PulseDbSourceSchema, PulseSourcesSchema, 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 ReviewStage, type ReviewStrength, type RoadmapMode, type RoadmapModeConfig, type RoadmapModeValidationConfig, type RoadmapTrackerClient, type Rubric, type RubricItem, type RuleOverride, RuleRegistry, type RunCIChecksInput, type RunPipelineOptions, SECURITY_DESCRIPTOR, STALENESS_WARNING_DAYS, STANDALONE_AGREEMENT, STATUS_RANK, type SafetyLevel, type ScanConfigFileResult, type ScanConfigFinding, type ScanConfigResult, type Hotspot as ScanHotspot, type HotspotOptions as ScanHotspotOptions, type ScanResult, type ScannedCommit, type ScoredCandidate, type SearchMatch, type SearchResult, type SecurityCategory, type SecurityCategorySnapshot, SecurityCategorySnapshotSchema, type SecurityConfidence, type SecurityConfig, SecurityConfigSchema, type Direction as SecurityDirection, DirectionSchema as SecurityDirectionSchema, type SecurityFinding, type SecurityRule, SecurityScanner, type SecuritySeverity, type SecurityTimelineFile, SecurityTimelineFileSchema, SecurityTimelineManager, type SecurityTimelineSnapshot, SecurityTimelineSnapshotSchema, type SecurityTrendLine, SecurityTrendLineSchema, type SecurityTrendResult, SecurityTrendResultSchema, type SeedOptions, type SelfReviewConfig, type SessionSummaryData, SharableBoundaryConfigSchema, SharableForbiddenImportSchema, SharableLayerSchema, SharableSecurityRulesSchema, type SizeBudgetConfig, type SizeBudgetReport, type SizeBudgetViolation, type SkillEvent, SkillEventSchema, type SkillExecutor, type SkillLoadPlan, SolutionDocFrontmatterSchema, type SolutionsDirValidation, type SourceFile, type Span, type SpanEvent, type SpecImpactEstimate, SpecImpactEstimateSchema, SpecImpactEstimator, SpecImpactSignalsSchema, type StabilityForecast, StabilityForecastSchema, type StabilityTaggedBlock, type StaleConstraint, type StalenessEntry, type StalenessReport, type StepExecutor, type StrategySeed, type StreamIndex, StreamIndexSchema, type StreamInfo, StreamInfoSchema, StructuralStrategy, type StructureValidation, type Suggestion, type SuggestionReport, type SupplyChainSnapshot, SupplyChainSnapshotSchema, type SupportedLanguage, type SuppressionRecord, type SymbolKind, type SyncChange, type SyncOptions, type TaintCheckResult, type TaintFinding, type TaintState, type TelemetryAdapter, type TelemetryHealth, ThresholdConfig, type TimeRange, type TimeToFixResult, TimeToFixResultSchema, type TimeToFixStats, TimeToFixStatsSchema, type CategorySnapshot as TimelineCategorySnapshot, type TimelineFile, TimelineFileSchema, TimelineManager, type TimelineSnapshot, TimelineSnapshotSchema, type TokenBudget, type TokenBudgetOverrides, type ToolDefinition, type Trace, type TrackedFeature, type TrackerClientConfig, type TrackerConflictBody, type TrackerSyncAdapter, type Transition, TransitionSchema, type TrendAttribution, TrendAttributionSchema, type TrendLine, TrendLineSchema, type TrendResult, TrendResultSchema, TruncationStrategy, type TrustScoreOptions, type TurnExecutor, TypeScriptParser, type UnfoldResult, type UnusedImport, type UpdateCheckState, VALIDATION_SCORES, VALID_SCOPES, VERSION, type ValidateFindingsOptions, type ValidationError, Violation, type ViolationCluster, ViolationHistory, ViolationHistoryManager, ViolationSnapshot, WHATWG_BAD_PORTS, type WorkflowPhase, type WritePulseConfigOptions, acquireCompoundLock, addProvenance, agentConfigRules, aggregateByDay as aggregateAdoptionByDay, aggregateByDay$1 as aggregateByDay, aggregateBySession, aggregateBySkill, analyzeDiff, analyzeLearningPatterns, appendFailure, appendLearning, appendSessionEntry, applyFixes, applyHotspotDowngrade, applyRecencyWeights, applySyncChanges, archiveFailures, archiveLearnings, archiveSession, archiveStream, assembleCandidateReport, assembleReport, assertPortUsable, assertSanitized, assignFeature, buildDependencyGraph, buildExclusionSet, buildSnapshot, calculateCacheSavings, calculateCost, checkDocCoverage, checkEligibility, checkEvidenceCoverage, checkOverlap, checkTaint, classifyConfidence, classifyFinding, clearEventHashCache, clearFailuresCache, clearLearningsCache, clearPulseAdapters, clearTaint, clusterViolations, collectEvents, computeContentHash, computeHotspots, computeLexicalSimilarity, computeLoadPlan, computeOverallSeverity, computeScanExitCode, computeTrustScores, computeWindow, configureFeedback, constraintRuleId, contextBudget, contextFilter, countLearningEntries, createBoundaryValidator, createCommentedCodeFixes, createError, createFixes, createForbiddenImportFixes, createOrphanedDepFixes, createParseError, createRegionMap, createSelfReview, createStream, createTrackerClient, crossReferenceUndocumentedFixes, cryptoRules, deduplicateCleanupFindings, deduplicateFindings, deepMergeConstraints, defaultCollectors, defineLayer, deserializationRules, detectChangeType, detectCircularDeps, detectCircularDepsInFiles, detectComplexityViolations, detectCouplingViolations, detectDeadCode, detectDocDrift, detectEmergentConstraints, detectLanguage, detectPatternViolations, detectSizeBudgetViolations, detectStack, detectStaleConstraints, detectStaleLearnings, determineAssessment, diff, emitEvent, estimateTokens, executeWorkflow, expressRules, extractBundle, extractDirectoryScope, extractFileReferences, extractHeadlines, extractIndexEntry, extractLevel, extractMarkdownLinks, extractSections, fanOutReview, findParallelGroups, formatCIReportAsMarkdown, formatEventTimeline, formatFindingBlock, formatGitHubComment, formatGitHubSummary, formatIsoWeek, formatOutline, formatTerminalOutput, fullSync, generateAgentsMap, generateRubric, generateSuggestions, getActionEmitter, getExitCode, getFeedbackConfig, getInjectionPatterns, getModelPrice, getOrCreateInstallId, getOutline, getParser, getPhaseCategories, getPulseAdapter, getRoadmapMode, getStreamForBranch, getTaintFilePath, getTrustLevel, getUpdateNotification, gitScan, goRules, injectionRules, insecureDefaultsRules, isBadPort, isDuplicateFinding, isRegression, isSanitizedResult, isSmallSuggestion, isUpdateCheckEnabled, isoWeek, listActiveSessions, listPulseAdapters, listStreams, listTaintedSessions, loadBudgetedLearnings, loadEvents, loadFailures, loadHandoff, loadIndexEntries, loadPricingData, loadProjectRoadmapMode, loadRelevantLearnings, loadSessionSummary, loadState, loadStreamIndex, loadTrackerClientConfigFromProject, loadTrackerSyncConfig, logAgentAction, makeTrackerConflictBody, mapInjectionFindings, mapSecurityFindings, mapSecuritySeverity, markProtectedFindings, mcpRules, index as migrate, migrateToStreams, networkRules, nodeRules, normalizeLearningContent, normalizeViolationPattern, paginate, parseCCRecords, parseDateFromEntry, parseDiff, parseFile, parseFileRegions, parseFrontmatter, parseHarnessIgnore, parseLiteLLMData, parseLookback, parseManifest, parseProtectedRegions, parseRoadmap, parseSections, parseSecurityConfig, parseSize, pathTraversalRules, previewFix, projectValue, promoteSessionLearnings, pruneLearnings, reactRules, readAdoptionRecords, readCheckState, readCostRecords, readIdentity, readLockfile, readSessionSection, readSessionSections, readTaint, registerMockAdapter, registerPulseAdapter, removeContributions, removeProvenance, requestMultiplePeerReviews, requestPeerReview, resetFeedbackConfig, resetParserCache, resolveConsent, resolveFileToLayer, resolveModelTier, resolveReverseStatus, resolveRuleSeverity, resolveSessionDir, resolveStability, resolveStreamPath, resolveThresholds, runFallbackRules as runAgentConfigFallbackRules, runAll, runArchitectureAgent, runBugDetectionAgent, runCIChecks, runComplianceAgent, runMechanicalChecks, runMechanicalGate, runMultiTurnPipeline, runPipeline, runPulse, runReviewPipeline, runSecurityAgent, saveHandoff, saveState, saveStreamIndex, scanForInjection, scopeContext, scoreRoadmapCandidates, scoreRoadmapCandidatesFileLess, scoreRoadmapCandidatesForMode, searchSymbols, secretRules, securityFindingId, seedFromStrategy, send, serializeEnvelope, serializeRoadmap, setActiveStream, sharpEdgesRules, shouldRunCheck, spawnBackgroundCheck, splitBundlesByStage, stageDomains, suggestCategory, syncConstraintNodes, syncFromExternal, syncRoadmap, syncToExternal, tagUncitedFindings, topSkills, touchStream, trackAction, unfoldRange, unfoldSymbol, updateSessionEntryStatus, updateSessionIndex, validateAgentConfigs, validateAgentsMap, validateBoundaries, validateBranchName, validateCommitMessage, validateConfig, validateDependencies, validateFileStructure, validateFindings, validateKnowledgeMap, validatePatternConfig, validatePulseConfig, validateRoadmapMode, validateSolutionsDir, violationId, weeksUntilThreshold, weightedLinearRegression, writeConfig, writeLockfile, writePulseConfig, writeSessionSummary, writeTaint, xssRules };
+export { AGENT_DESCRIPTORS, AGREEMENT_LINE_GAP, ALLOWED_FIELD_KEYS, ALL_SOLUTION_CATEGORIES, ARCHITECTURE_DESCRIPTOR, type AST, type AcquireOptions, type ActionContext, type ActionEvent, type ActionEventHandler, type ActionEventType, type ActionResult, type ActionSink, type ActionTracker, type ActionType, type AdjustedForecast, AdjustedForecastSchema, type AgentAction, AgentActionEmitter, type AgentConfigFallbackReason, type AgentConfigFinding, type AgentConfigOptions, type AgentConfigSeverity, type AgentConfigValidation, type AgentExecutor, type AgentMapLink, type AgentMapSection, type AgentMapValidation, type AgentProcess, type AgentReviewResult, type AgentType, type AgentsMapConfig, type AnnotationIssue, type AnnotationIssueType, AnthropicCacheAdapter, type AppendLearningResult, ArchBaseline, ArchBaselineManager, ArchConfig, ArchDiffResult, ArchMetricCategory, type AssembleInput, BUG_DETECTION_DESCRIPTOR, BUG_TRACK_CATEGORIES, 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 BranchValidationResult, type BranchingConfig, type BrokenLink, type BudgetedLearningsOptions, type Bundle, type BundleConstraints, BundleConstraintsSchema, BundleSchema, CACHE_TTL_MS, CINotifier, COMPLIANCE_DESCRIPTOR, CORROBORATED_AGREEMENT, type CacheAdapter, CacheMetricsRecorder, type CacheMetricsRecorderOptions, 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 CompoundLockHandle, CompoundLockHeldError, type ConfidenceTier, ConfidenceTierSchema, type ConfigError, type ConfigPattern, type Confirmation, ConfirmationSchema, ConflictError, 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_LOADER_CONFIG, DEFAULT_PROVIDER_TIERS, DEFAULT_SECURITY_CONFIG, DEFAULT_STABILITY_THRESHOLDS, DEFAULT_STATE, DEFAULT_STREAM_INDEX, DEFAULT_TOKEN_BUDGET, DESTRUCTIVE_BASH, DOMAIN_BASELINES, 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$1 as Direction, DirectionSchema$1 as DirectionSchema, type DocumentationDrift, type DocumentationFile, type DocumentationGap, type DriftConfig, type DriftReport, EMPTY_SUPPLY_CHAIN, ETagStore, EVIDENCE_SATURATION, EXTENSION_MAP, type EligibilityResult, EmergenceResult, 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, FACTOR_WEIGHTS, type FailureEntry, FailureEntrySchema, type FallbackPricingFile, type FanOutOptions, type FeaturePatch, type FeedbackAgentConfig, type FeedbackConfig, type FeedbackError$1 as FeedbackError, type FileCategory, type FileLessScoredCandidate, FileSink, type FindingLifecycle, FindingLifecycleSchema, type FindingSeverity, type Fix, type FixConfig, type FixResult, type FixType, ForbiddenImportCollector, type ForbiddenImportViolation, type ForbiddenPattern, type GateConfig, GateConfigSchema, type GateResult, GateResultSchema, GeminiCacheAdapter, type GenerateRubricOptions, type GenerationSection, type GitHubInlineComment, GitHubIssuesSyncAdapter, type GitScanOptions, type GraphAdapter, type GraphComplexityData, type GraphCouplingData, type GraphCoverageData, type GraphCriticalPathData, type GraphDependencyData, type GraphHarnessCheckData, type GraphImpactData, type GraphNode, type Handoff, HandoffSchema, type HarnessState, HarnessStateSchema, type HealthCheckResult, type HistoryEvent, type HistoryEventType, type Hotspot$1 as Hotspot, type HotspotContext, type Import, type InjectionFinding, type InjectionPattern, type InjectionSeverity, type InlineReference, type IntegrityReport, type InteractionType, InteractionTypeSchema, type InternalSymbol, type IsoWeek, type JSDocComment, KNOWLEDGE_TRACK_CATEGORIES, LITELLM_PRICING_URL, type LanguageParser, type Layer, type LayerConfig, LayerViolationCollector, type LearningPattern, type LearningsFrontmatter, type LearningsIndexEntry, type LiteLLMModelEntry, type LiteLLMPricingData, type LoadEventsOptions, type LoaderConfig, type Lockfile, type LockfilePackage, LockfilePackageSchema, LockfileSchema, type LogEntry, type LogFilter, MOCK_ADAPTER_NAME, type MakeTrackerConflictBodyOptions, 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, type NewFeatureInput, NoOpExecutor, NoOpSink, NoOpTelemetryAdapter, OTLPExporter, type OTLPExporterOptions, OpenAICacheAdapter, type OrchestratorResult, type OrphanedDep, type OutlineResult, type OverlapDimensions, type OverlapResult, PII_FIELD_DENYLIST, PII_LINE_RE, PII_TOKENS, type PackedEnvelope, type PaginatedSlice, type PaginationMeta, type ParallelGroups, type ParseError, type ParsedFile, type ParsedSection, type ParserLookup, 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 ProtectedRegion, type ProtectedRegionMap, type ProtectionScope, type ProviderDefaults, type ProviderSystemBlock, type ProviderToolBlock, type PruneResult, PulseAdapterAlreadyRegisteredError, PulseConfigSchema, type PulseConfigValidation, PulseDbSourceSchema, PulseSourcesSchema, 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 ReviewStage, type ReviewStrength, type RoadmapMode, type RoadmapModeConfig, type RoadmapModeValidationConfig, type RoadmapTrackerClient, type Rubric, type RubricItem, type RuleOverride, RuleRegistry, type RunCIChecksInput, type RunPipelineOptions, SECURITY_DESCRIPTOR, STALENESS_WARNING_DAYS, STANDALONE_AGREEMENT, STATUS_RANK, type SafetyLevel, type ScanConfigFileResult, type ScanConfigFinding, type ScanConfigResult, type Hotspot as ScanHotspot, type HotspotOptions as ScanHotspotOptions, type ScanResult, type ScannedCommit, type ScoredCandidate, type SearchMatch, type SearchResult, type SecurityCategory, type SecurityCategorySnapshot, SecurityCategorySnapshotSchema, type SecurityConfidence, type SecurityConfig, SecurityConfigSchema, type Direction as SecurityDirection, DirectionSchema as SecurityDirectionSchema, type SecurityFinding, type SecurityRule, SecurityScanner, type SecuritySeverity, type SecurityTimelineFile, SecurityTimelineFileSchema, SecurityTimelineManager, type SecurityTimelineSnapshot, SecurityTimelineSnapshotSchema, type SecurityTrendLine, SecurityTrendLineSchema, type SecurityTrendResult, SecurityTrendResultSchema, type SeedOptions, type SelfReviewConfig, type SessionSummaryData, SharableBoundaryConfigSchema, SharableForbiddenImportSchema, SharableLayerSchema, SharableSecurityRulesSchema, type SizeBudgetConfig, type SizeBudgetReport, type SizeBudgetViolation, type SkillEvent, SkillEventSchema, type SkillExecutor, type SkillLoadPlan, SolutionDocFrontmatterSchema, type SolutionsDirValidation, type SourceFile, type Span, type SpanAttributes, type SpanEvent, SpanKind, type SpecImpactEstimate, SpecImpactEstimateSchema, SpecImpactEstimator, SpecImpactSignalsSchema, type StabilityForecast, StabilityForecastSchema, type StabilityTaggedBlock, type StaleConstraint, type StalenessEntry, type StalenessReport, type StepExecutor, type StrategySeed, type StreamIndex, StreamIndexSchema, type StreamInfo, StreamInfoSchema, StructuralStrategy, type StructureValidation, type Suggestion, type SuggestionReport, type SupplyChainSnapshot, SupplyChainSnapshotSchema, type SupportedLanguage, type SuppressionRecord, type SymbolKind, type SyncChange, type SyncOptions, type TaintCheckResult, type TaintFinding, type TaintState, type TelemetryAdapter, type TelemetryHealth, ThresholdConfig, type TimeRange, type TimeToFixResult, TimeToFixResultSchema, type TimeToFixStats, TimeToFixStatsSchema, type CategorySnapshot as TimelineCategorySnapshot, type TimelineFile, TimelineFileSchema, TimelineManager, type TimelineSnapshot, TimelineSnapshotSchema, type TokenBudget, type TokenBudgetOverrides, type ToolDefinition, type Trace, type TraceSpan, type TrackedFeature, type TrackerClientConfig, type TrackerConflictBody, type TrackerSyncAdapter, type Transition, TransitionSchema, type TrendAttribution, TrendAttributionSchema, type TrendLine, TrendLineSchema, type TrendResult, TrendResultSchema, TruncationStrategy, type TrustScoreOptions, type TurnExecutor, TypeScriptParser, type UnfoldResult, type UnusedImport, type UpdateCheckState, VALIDATION_SCORES, VALID_SCOPES, VERSION, type ValidateFindingsOptions, type ValidationError, Violation, type ViolationCluster, ViolationHistory, ViolationHistoryManager, ViolationSnapshot, WHATWG_BAD_PORTS, type WorkflowPhase, type WritePulseConfigOptions, acquireCompoundLock, addProvenance, agentConfigRules, aggregateByDay as aggregateAdoptionByDay, aggregateByDay$1 as aggregateByDay, aggregateBySession, aggregateBySkill, analyzeDiff, analyzeLearningPatterns, appendFailure, appendLearning, appendSessionEntry, applyFixes, applyHotspotDowngrade, applyRecencyWeights, applySyncChanges, archiveFailures, archiveLearnings, archiveSession, archiveStream, assembleCandidateReport, assembleReport, assertPortUsable, assertSanitized, assignFeature, buildDependencyGraph, buildExclusionSet, buildSnapshot, calculateCacheSavings, calculateCost, checkDocCoverage, checkEligibility, checkEvidenceCoverage, checkOverlap, checkTaint, classifyConfidence, classifyFinding, clearEventHashCache, clearFailuresCache, clearLearningsCache, clearPulseAdapters, clearTaint, clusterViolations, collectEvents, computeContentHash, computeHotspots, computeLexicalSimilarity, computeLoadPlan, computeOverallSeverity, computeScanExitCode, computeTrustScores, computeWindow, configureFeedback, constraintRuleId, contextBudget, contextFilter, countLearningEntries, createBoundaryValidator, createCommentedCodeFixes, createError, createFixes, createForbiddenImportFixes, createOrphanedDepFixes, createParseError, createRegionMap, createSelfReview, createStream, createTrackerClient, crossReferenceUndocumentedFixes, cryptoRules, deduplicateCleanupFindings, deduplicateFindings, deepMergeConstraints, defaultCollectors, defineLayer, deserializationRules, detectChangeType, detectCircularDeps, detectCircularDepsInFiles, detectComplexityViolations, detectCouplingViolations, detectDeadCode, detectDocDrift, detectEmergentConstraints, detectLanguage, detectPatternViolations, detectSizeBudgetViolations, detectStack, detectStaleConstraints, detectStaleLearnings, determineAssessment, diff, emitEvent, estimateTokens, executeWorkflow, expressRules, extractBundle, extractDirectoryScope, extractFileReferences, extractHeadlines, extractIndexEntry, extractLevel, extractMarkdownLinks, extractSections, fanOutReview, findParallelGroups, formatCIReportAsMarkdown, formatEventTimeline, formatFindingBlock, formatGitHubComment, formatGitHubSummary, formatIsoWeek, formatOutline, formatTerminalOutput, fullSync, generateAgentsMap, generateRubric, generateSuggestions, getActionEmitter, getExitCode, getFeedbackConfig, getInjectionPatterns, getModelPrice, getOrCreateInstallId, getOutline, getParser, getPhaseCategories, getPulseAdapter, getRoadmapMode, getStreamForBranch, getTaintFilePath, getTrustLevel, getUpdateNotification, gitScan, goRules, injectionRules, insecureDefaultsRules, invalidateCheckState, isBadPort, isDuplicateFinding, isRegression, isSanitizedResult, isSmallSuggestion, isUpdateCheckEnabled, isoWeek, listActiveSessions, listPulseAdapters, listStreams, listTaintedSessions, loadBudgetedLearnings, loadEvents, loadFailures, loadHandoff, loadIndexEntries, loadPricingData, loadProjectRoadmapMode, loadRelevantLearnings, loadSessionSummary, loadState, loadStreamIndex, loadTrackerClientConfigFromProject, loadTrackerSyncConfig, logAgentAction, makeTrackerConflictBody, mapInjectionFindings, mapSecurityFindings, mapSecuritySeverity, markProtectedFindings, mcpRules, index as migrate, migrateToStreams, networkRules, nodeRules, normalizeLearningContent, normalizeViolationPattern, paginate, parseCCRecords, parseDateFromEntry, parseDiff, parseFile, parseFileRegions, parseFrontmatter, parseHarnessIgnore, parseLiteLLMData, parseLookback, parseManifest, parseProtectedRegions, parseRoadmap, parseSections, parseSecurityConfig, parseSize, pathTraversalRules, previewFix, projectValue, promoteSessionLearnings, pruneLearnings, reactRules, readAdoptionRecords, readCheckState, readCostRecords, readIdentity, readLockfile, readSessionSection, readSessionSections, readTaint, registerMockAdapter, registerPulseAdapter, removeContributions, removeProvenance, requestMultiplePeerReviews, requestPeerReview, resetFeedbackConfig, resetParserCache, resolveConsent, resolveFileToLayer, resolveModelTier, resolveReverseStatus, resolveRuleSeverity, resolveSessionDir, resolveStability, resolveStreamPath, resolveThresholds, runFallbackRules as runAgentConfigFallbackRules, runAll, runArchitectureAgent, runBugDetectionAgent, runCIChecks, runComplianceAgent, runMechanicalChecks, runMechanicalGate, runMultiTurnPipeline, runPipeline, runPulse, runReviewPipeline, runSecurityAgent, saveHandoff, saveState, saveStreamIndex, scanForInjection, scopeContext, scoreRoadmapCandidates, scoreRoadmapCandidatesFileLess, scoreRoadmapCandidatesForMode, searchSymbols, secretRules, securityFindingId, seedFromStrategy, send, serializeEnvelope, serializeRoadmap, setActiveStream, sharpEdgesRules, shouldRunCheck, spawnBackgroundCheck, splitBundlesByStage, stageDomains, suggestCategory, syncConstraintNodes, syncFromExternal, syncRoadmap, syncToExternal, tagUncitedFindings, topSkills, touchStream, trackAction, unfoldRange, unfoldSymbol, updateSessionEntryStatus, updateSessionIndex, validateAgentConfigs, validateAgentsMap, validateBoundaries, validateBranchName, validateCommitMessage, validateConfig, validateDependencies, validateFileStructure, validateFindings, validateKnowledgeMap, validatePatternConfig, validatePulseConfig, validateRoadmapMode, validateSolutionsDir, violationId, weeksUntilThreshold, weightedLinearRegression, writeConfig, writeLockfile, writePulseConfig, writeSessionSummary, writeTaint, xssRules };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { Result, LoadingLevel, SkillContextBudget, SessionSectionName, SessionEntry, SessionSections, WorkflowStep, WorkflowStepResult, Workflow, WorkflowResult, SkillLifecycleHooks, SkillContext, SkillResult, TurnContext, CICheckName, CIFailOnSeverity, CICheckReport, RoadmapFeature, ExternalTicket, ExternalTicketState, TrackerComment, TrackerSyncConfig, CINotifyOptions, Roadmap, FeatureStatus, SyncResult, Priority, ModelPricing, UsageRecord, DailyUsage, SessionUsage, SkillInvocationRecord, SkillAdoptionSummary, StabilityTier, TelemetryIdentity, TelemetryConfig, ConsentState, TelemetryEvent, SolutionCategory, SanitizedResult, PulseConfig, PulseAdapter, PulseWindow } from '@harness-engineering/types';
+import { Result, LoadingLevel, SkillContextBudget, SessionSectionName, SessionEntry, SessionSections, WorkflowStep, WorkflowStepResult, Workflow, WorkflowResult, SkillLifecycleHooks, SkillContext, SkillResult, TurnContext, CICheckName, CIFailOnSeverity, CICheckReport, RoadmapFeature, ExternalTicket, ExternalTicketState, TrackerComment, TrackerSyncConfig, CINotifyOptions, Roadmap, FeatureStatus, SyncResult, Priority, ModelPricing, UsageRecord, DailyUsage, SessionUsage, SkillInvocationRecord, SkillAdoptionSummary, StabilityTier, TelemetryIdentity, TelemetryConfig, ConsentState, TelemetryEvent, PromptCacheStats, SolutionCategory, SanitizedResult, PulseConfig, PulseAdapter, PulseWindow } from '@harness-engineering/types';
 export * from '@harness-engineering/types';
 export { BlockerRef, BugTrackCategory, Issue, IssueTrackerClient, KnowledgeTrackCategory, PulseAdapter, PulseConfig, PulseDbSource, PulseRunStatus, PulseRunStatusType, PulseSources, PulseWindow, SanitizeFn, SanitizedResult, SolutionCategory, SolutionDocFrontmatter, SolutionTrack, TrackerConfig } from '@harness-engineering/types';
 import { z } from 'zod';
@@ -8804,6 +8804,16 @@ declare function isUpdateCheckEnabled(configInterval?: number): boolean;
  * If state is null (never checked), returns true.
  */
 declare function shouldRunCheck(state: UpdateCheckState | null, intervalMs: number): boolean;
+/**
+ * Removes the cached update-check state.
+ *
+ * Call after a successful `harness update` so the next CLI invocation cannot
+ * print a stale "Update available" notification reflecting the pre-upgrade
+ * state. With the file gone, `readCheckState` returns null and the
+ * notification path bails out; the next invocation will rerun the background
+ * check on its normal cadence.
+ */
+declare function invalidateCheckState(): void;
 /**
  * Reads the update check state from ~/.harness/update-check.json.
  * Returns null if the file is missing, unreadable, or has invalid content.
@@ -9296,6 +9306,188 @@ declare function collectEvents(projectRoot: string, consent: ConsentState & {
  */
 declare function send(events: TelemetryEvent[], apiKey: string): Promise<void>;
 
+/**
+ * CacheMetricsRecorder — in-memory ring buffer recording prompt-cache
+ * hits/misses per backend invocation. Powers `GET /api/v1/telemetry/cache/stats`
+ * and the dashboard `/insights/cache` widget.
+ *
+ * Design notes:
+ * - Sliding window of the last `capacity` records (default 1000). When
+ *   the buffer is full, oldest records are evicted FIFO. Restarts reset
+ *   the window — this is intentional: prompt-cache hit-rate is a
+ *   debugging/observability signal, not an audit record.
+ * - `windowStartedAt` is set on the first `record()` after construction
+ *   (or after `reset()`) and is reported as a unix-ms timestamp. Empty
+ *   recorders report `0` so the API response remains JSON-stable.
+ * - All operations are O(1) amortized; `record()` is on the hot path
+ *   for every Anthropic response and must not allocate.
+ */
+
+interface CacheMetricsRecorderOptions {
+    capacity?: number;
+    /** Injectable clock for deterministic testing. Defaults to `Date.now`. */
+    now?: () => number;
+}
+declare class CacheMetricsRecorder {
+    private readonly capacity;
+    private readonly now;
+    private readonly buffer;
+    private windowStartedAt;
+    constructor(opts?: CacheMetricsRecorderOptions);
+    /**
+     * Append a single cache observation. Hot-path: O(1) amortized, no
+     * allocations beyond the sample object itself.
+     */
+    record(backendId: string, hit: boolean, tokensCreated: number, tokensRead: number): void;
+    /** Aggregate the current window into a `PromptCacheStats` snapshot. */
+    getStats(): PromptCacheStats;
+    /** Clear the buffer and reset the window-start marker. */
+    reset(): void;
+}
+
+/**
+ * In-tree trace span shapes for the OTLP/HTTP JSON exporter.
+ *
+ * These are the internal representations the orchestrator buffers and
+ * hands to `OTLPExporter.push()`. The exporter converts them to the OTLP
+ * wire format (string-encoded int64 timestamps, hex-encoded ids) before
+ * serializing as JSON for `/v1/traces` requests.
+ *
+ * See `packages/types/src/telemetry.ts` for the OTLP wire-format shapes
+ * and the rationale for stringly-typed nanosecond timestamps.
+ */
+/**
+ * SpanKind enum mirroring the OTel spec values 1..5. Spans emitted by
+ * the orchestrator are predominantly `INTERNAL`; we leave the other
+ * variants exposed for future producer/consumer fanout instrumentation.
+ */
+declare enum SpanKind {
+    INTERNAL = 1,
+    SERVER = 2,
+    CLIENT = 3,
+    PRODUCER = 4,
+    CONSUMER = 5
+}
+/**
+ * Free-form attribute bag attached to a span. Values must be scalar:
+ * strings, numbers, or booleans (the OTLP/HTTP JSON converter only
+ * supports `stringValue` / `intValue` / `doubleValue` / `boolValue`).
+ */
+interface SpanAttributes {
+    [key: string]: string | number | boolean;
+}
+/**
+ * A completed trace span ready for export. `startTimeNs` and `endTimeNs`
+ * are unix epoch nanoseconds as `bigint` (JS `number` cannot losslessly
+ * hold int64); the exporter stringifies them for the OTLP JSON payload.
+ *
+ * `traceId` is a 32-char lowercase hex string (16 bytes); `spanId` and
+ * `parentSpanId` are 16-char lowercase hex strings (8 bytes) per the
+ * OTel trace context spec.
+ *
+ * `statusCode` follows OTel convention: 0 = UNSET, 1 = OK, 2 = ERROR.
+ */
+interface TraceSpan {
+    traceId: string;
+    spanId: string;
+    parentSpanId?: string;
+    name: string;
+    kind: SpanKind;
+    startTimeNs: bigint;
+    endTimeNs: bigint;
+    attributes: SpanAttributes;
+    statusCode?: 0 | 1 | 2;
+}
+
+/**
+ * OTLPExporter — hand-rolled OTLP/HTTP JSON exporter for trace spans.
+ *
+ * Buffers `TraceSpan` instances in-memory and flushes them as OTLP/HTTP
+ * v1.0.0 JSON payloads to a configurable `/v1/traces` endpoint on a
+ * timer (default 2 s) or when the batch size is hit (default 64).
+ *
+ * Design contracts:
+ * - {@link push} is synchronous and never awaits. The orchestrator hot
+ *   path may call `push()` thousands of times per second; we must add
+ *   < 5 ms p99 to dispatch latency (Phase 5 acceptance criterion).
+ * - {@link flush} is fire-and-forget. On HTTP failure we retry up to 3
+ *   times with 1 s / 2 s / 4 s backoff, then drop the batch and log a
+ *   single `console.warn`. The exporter never queues to disk.
+ * - When `enabled: false`, {@link push} is a constant-time no-op so
+ *   callers can wire the recorder unconditionally without branching.
+ * - {@link stop} flushes the remaining buffer before resolving so we
+ *   don't lose data on graceful shutdown.
+ *
+ * Wire format (per OTLP/HTTP v1.0.0 spec):
+ * ```json
+ * {
+ *   "resourceSpans": [{
+ *     "resource": { "attributes": [{ "key": "service.name", "value": { "stringValue": "harness" } }] },
+ *     "scopeSpans": [{
+ *       "scope": { "name": "harness" },
+ *       "spans": [ ...OTLPSpan[] ]
+ *     }]
+ *   }]
+ * }
+ * ```
+ *
+ * `traceId` / `spanId` are lowercase hex strings (16 / 8 bytes); time
+ * fields are stringly-typed nanoseconds (JSON cannot losslessly hold
+ * int64).
+ */
+
+interface OTLPExporterOptions {
+    /** Full OTLP/HTTP traces endpoint, e.g. `http://localhost:4318/v1/traces`. */
+    endpoint: string;
+    /** Default `true`. When `false`, push() is a no-op. */
+    enabled?: boolean;
+    /** Custom headers (auth tokens, etc.). */
+    headers?: Record<string, string>;
+    /** Flush interval in ms. Default 2000. */
+    flushIntervalMs?: number;
+    /** Buffer size that triggers an immediate flush. Default 64. */
+    batchSize?: number;
+    /** Injectable fetch for tests. Defaults to `globalThis.fetch`. */
+    fetchImpl?: typeof fetch;
+    /** Injectable warn for tests. Defaults to `console.warn`. */
+    warn?: (...args: unknown[]) => void;
+}
+declare class OTLPExporter {
+    private readonly endpoint;
+    private readonly enabled;
+    private readonly headers;
+    private readonly flushIntervalMs;
+    private readonly batchSize;
+    private readonly fetchImpl;
+    private readonly warn;
+    private buffer;
+    private timer;
+    private readonly inFlightFlushes;
+    constructor(opts: OTLPExporterOptions);
+    /**
+     * O(1) buffer push. When `enabled === false` this is a no-op. If the
+     * buffer reaches `batchSize`, a flush is triggered without awaiting.
+     */
+    push(span: TraceSpan): void;
+    /** Start the periodic flush timer. Idempotent. */
+    start(): void;
+    /** Flush any pending spans and stop the timer. Awaits all in-flight flushes. */
+    stop(): Promise<void>;
+    /**
+     * Synchronously claim the current buffer and POST it to `/v1/traces`.
+     * Each invocation runs independently — concurrent flushes (e.g. one
+     * from the timer, one from a `batchSize` trip) each drain their own
+     * batch. Retries up to 3 times on transport or 5xx failure, then
+     * drops with a single warning.
+     */
+    private flush;
+    /**
+     * Build the OTLP/HTTP JSON envelope for a batch of spans. Public for
+     * tests; not part of the supported API surface.
+     */
+    spansToOTLPJSON(spans: TraceSpan[]): unknown;
+}
+
 declare class CompoundLockHeldError extends Error {
     readonly category: SolutionCategory;
     readonly holderPid: number;
@@ -9722,6 +9914,6 @@ interface AssembleInput {
 }
 declare function assembleCandidateReport(input: AssembleInput): string;
 
-declare const VERSION = "0.23.3";
+declare const VERSION = "0.25.0";
 
-export { AGENT_DESCRIPTORS, AGREEMENT_LINE_GAP, ALLOWED_FIELD_KEYS, ALL_SOLUTION_CATEGORIES, ARCHITECTURE_DESCRIPTOR, type AST, type AcquireOptions, type ActionContext, type ActionEvent, type ActionEventHandler, type ActionEventType, type ActionResult, type ActionSink, type ActionTracker, type ActionType, type AdjustedForecast, AdjustedForecastSchema, type AgentAction, AgentActionEmitter, type AgentConfigFallbackReason, type AgentConfigFinding, type AgentConfigOptions, type AgentConfigSeverity, type AgentConfigValidation, type AgentExecutor, type AgentMapLink, type AgentMapSection, type AgentMapValidation, type AgentProcess, type AgentReviewResult, type AgentType, type AgentsMapConfig, type AnnotationIssue, type AnnotationIssueType, AnthropicCacheAdapter, type AppendLearningResult, ArchBaseline, ArchBaselineManager, ArchConfig, ArchDiffResult, ArchMetricCategory, type AssembleInput, BUG_DETECTION_DESCRIPTOR, BUG_TRACK_CATEGORIES, 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 BranchValidationResult, type BranchingConfig, type BrokenLink, type BudgetedLearningsOptions, type Bundle, type BundleConstraints, BundleConstraintsSchema, BundleSchema, CACHE_TTL_MS, CINotifier, COMPLIANCE_DESCRIPTOR, CORROBORATED_AGREEMENT, 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 CompoundLockHandle, CompoundLockHeldError, type ConfidenceTier, ConfidenceTierSchema, type ConfigError, type ConfigPattern, type Confirmation, ConfirmationSchema, ConflictError, 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_LOADER_CONFIG, DEFAULT_PROVIDER_TIERS, DEFAULT_SECURITY_CONFIG, DEFAULT_STABILITY_THRESHOLDS, DEFAULT_STATE, DEFAULT_STREAM_INDEX, DEFAULT_TOKEN_BUDGET, DESTRUCTIVE_BASH, DOMAIN_BASELINES, 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$1 as Direction, DirectionSchema$1 as DirectionSchema, type DocumentationDrift, type DocumentationFile, type DocumentationGap, type DriftConfig, type DriftReport, EMPTY_SUPPLY_CHAIN, ETagStore, EVIDENCE_SATURATION, EXTENSION_MAP, type EligibilityResult, EmergenceResult, 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, FACTOR_WEIGHTS, type FailureEntry, FailureEntrySchema, type FallbackPricingFile, type FanOutOptions, type FeaturePatch, type FeedbackAgentConfig, type FeedbackConfig, type FeedbackError$1 as FeedbackError, type FileCategory, type FileLessScoredCandidate, FileSink, type FindingLifecycle, FindingLifecycleSchema, type FindingSeverity, type Fix, type FixConfig, type FixResult, type FixType, ForbiddenImportCollector, type ForbiddenImportViolation, type ForbiddenPattern, type GateConfig, GateConfigSchema, type GateResult, GateResultSchema, GeminiCacheAdapter, type GenerateRubricOptions, type GenerationSection, type GitHubInlineComment, GitHubIssuesSyncAdapter, type GitScanOptions, type GraphAdapter, type GraphComplexityData, type GraphCouplingData, type GraphCoverageData, type GraphCriticalPathData, type GraphDependencyData, type GraphHarnessCheckData, type GraphImpactData, type GraphNode, type Handoff, HandoffSchema, type HarnessState, HarnessStateSchema, type HealthCheckResult, type HistoryEvent, type HistoryEventType, type Hotspot$1 as Hotspot, type HotspotContext, type Import, type InjectionFinding, type InjectionPattern, type InjectionSeverity, type InlineReference, type IntegrityReport, type InteractionType, InteractionTypeSchema, type InternalSymbol, type IsoWeek, type JSDocComment, KNOWLEDGE_TRACK_CATEGORIES, LITELLM_PRICING_URL, type LanguageParser, type Layer, type LayerConfig, LayerViolationCollector, type LearningPattern, type LearningsFrontmatter, type LearningsIndexEntry, type LiteLLMModelEntry, type LiteLLMPricingData, type LoadEventsOptions, type LoaderConfig, type Lockfile, type LockfilePackage, LockfilePackageSchema, LockfileSchema, type LogEntry, type LogFilter, MOCK_ADAPTER_NAME, type MakeTrackerConflictBodyOptions, 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, type NewFeatureInput, NoOpExecutor, NoOpSink, NoOpTelemetryAdapter, OpenAICacheAdapter, type OrchestratorResult, type OrphanedDep, type OutlineResult, type OverlapDimensions, type OverlapResult, PII_FIELD_DENYLIST, PII_LINE_RE, PII_TOKENS, type PackedEnvelope, type PaginatedSlice, type PaginationMeta, type ParallelGroups, type ParseError, type ParsedFile, type ParsedSection, type ParserLookup, 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 ProtectedRegion, type ProtectedRegionMap, type ProtectionScope, type ProviderDefaults, type ProviderSystemBlock, type ProviderToolBlock, type PruneResult, PulseAdapterAlreadyRegisteredError, PulseConfigSchema, type PulseConfigValidation, PulseDbSourceSchema, PulseSourcesSchema, 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 ReviewStage, type ReviewStrength, type RoadmapMode, type RoadmapModeConfig, type RoadmapModeValidationConfig, type RoadmapTrackerClient, type Rubric, type RubricItem, type RuleOverride, RuleRegistry, type RunCIChecksInput, type RunPipelineOptions, SECURITY_DESCRIPTOR, STALENESS_WARNING_DAYS, STANDALONE_AGREEMENT, STATUS_RANK, type SafetyLevel, type ScanConfigFileResult, type ScanConfigFinding, type ScanConfigResult, type Hotspot as ScanHotspot, type HotspotOptions as ScanHotspotOptions, type ScanResult, type ScannedCommit, type ScoredCandidate, type SearchMatch, type SearchResult, type SecurityCategory, type SecurityCategorySnapshot, SecurityCategorySnapshotSchema, type SecurityConfidence, type SecurityConfig, SecurityConfigSchema, type Direction as SecurityDirection, DirectionSchema as SecurityDirectionSchema, type SecurityFinding, type SecurityRule, SecurityScanner, type SecuritySeverity, type SecurityTimelineFile, SecurityTimelineFileSchema, SecurityTimelineManager, type SecurityTimelineSnapshot, SecurityTimelineSnapshotSchema, type SecurityTrendLine, SecurityTrendLineSchema, type SecurityTrendResult, SecurityTrendResultSchema, type SeedOptions, type SelfReviewConfig, type SessionSummaryData, SharableBoundaryConfigSchema, SharableForbiddenImportSchema, SharableLayerSchema, SharableSecurityRulesSchema, type SizeBudgetConfig, type SizeBudgetReport, type SizeBudgetViolation, type SkillEvent, SkillEventSchema, type SkillExecutor, type SkillLoadPlan, SolutionDocFrontmatterSchema, type SolutionsDirValidation, type SourceFile, type Span, type SpanEvent, type SpecImpactEstimate, SpecImpactEstimateSchema, SpecImpactEstimator, SpecImpactSignalsSchema, type StabilityForecast, StabilityForecastSchema, type StabilityTaggedBlock, type StaleConstraint, type StalenessEntry, type StalenessReport, type StepExecutor, type StrategySeed, type StreamIndex, StreamIndexSchema, type StreamInfo, StreamInfoSchema, StructuralStrategy, type StructureValidation, type Suggestion, type SuggestionReport, type SupplyChainSnapshot, SupplyChainSnapshotSchema, type SupportedLanguage, type SuppressionRecord, type SymbolKind, type SyncChange, type SyncOptions, type TaintCheckResult, type TaintFinding, type TaintState, type TelemetryAdapter, type TelemetryHealth, ThresholdConfig, type TimeRange, type TimeToFixResult, TimeToFixResultSchema, type TimeToFixStats, TimeToFixStatsSchema, type CategorySnapshot as TimelineCategorySnapshot, type TimelineFile, TimelineFileSchema, TimelineManager, type TimelineSnapshot, TimelineSnapshotSchema, type TokenBudget, type TokenBudgetOverrides, type ToolDefinition, type Trace, type TrackedFeature, type TrackerClientConfig, type TrackerConflictBody, type TrackerSyncAdapter, type Transition, TransitionSchema, type TrendAttribution, TrendAttributionSchema, type TrendLine, TrendLineSchema, type TrendResult, TrendResultSchema, TruncationStrategy, type TrustScoreOptions, type TurnExecutor, TypeScriptParser, type UnfoldResult, type UnusedImport, type UpdateCheckState, VALIDATION_SCORES, VALID_SCOPES, VERSION, type ValidateFindingsOptions, type ValidationError, Violation, type ViolationCluster, ViolationHistory, ViolationHistoryManager, ViolationSnapshot, WHATWG_BAD_PORTS, type WorkflowPhase, type WritePulseConfigOptions, acquireCompoundLock, addProvenance, agentConfigRules, aggregateByDay as aggregateAdoptionByDay, aggregateByDay$1 as aggregateByDay, aggregateBySession, aggregateBySkill, analyzeDiff, analyzeLearningPatterns, appendFailure, appendLearning, appendSessionEntry, applyFixes, applyHotspotDowngrade, applyRecencyWeights, applySyncChanges, archiveFailures, archiveLearnings, archiveSession, archiveStream, assembleCandidateReport, assembleReport, assertPortUsable, assertSanitized, assignFeature, buildDependencyGraph, buildExclusionSet, buildSnapshot, calculateCacheSavings, calculateCost, checkDocCoverage, checkEligibility, checkEvidenceCoverage, checkOverlap, checkTaint, classifyConfidence, classifyFinding, clearEventHashCache, clearFailuresCache, clearLearningsCache, clearPulseAdapters, clearTaint, clusterViolations, collectEvents, computeContentHash, computeHotspots, computeLexicalSimilarity, computeLoadPlan, computeOverallSeverity, computeScanExitCode, computeTrustScores, computeWindow, configureFeedback, constraintRuleId, contextBudget, contextFilter, countLearningEntries, createBoundaryValidator, createCommentedCodeFixes, createError, createFixes, createForbiddenImportFixes, createOrphanedDepFixes, createParseError, createRegionMap, createSelfReview, createStream, createTrackerClient, crossReferenceUndocumentedFixes, cryptoRules, deduplicateCleanupFindings, deduplicateFindings, deepMergeConstraints, defaultCollectors, defineLayer, deserializationRules, detectChangeType, detectCircularDeps, detectCircularDepsInFiles, detectComplexityViolations, detectCouplingViolations, detectDeadCode, detectDocDrift, detectEmergentConstraints, detectLanguage, detectPatternViolations, detectSizeBudgetViolations, detectStack, detectStaleConstraints, detectStaleLearnings, determineAssessment, diff, emitEvent, estimateTokens, executeWorkflow, expressRules, extractBundle, extractDirectoryScope, extractFileReferences, extractHeadlines, extractIndexEntry, extractLevel, extractMarkdownLinks, extractSections, fanOutReview, findParallelGroups, formatCIReportAsMarkdown, formatEventTimeline, formatFindingBlock, formatGitHubComment, formatGitHubSummary, formatIsoWeek, formatOutline, formatTerminalOutput, fullSync, generateAgentsMap, generateRubric, generateSuggestions, getActionEmitter, getExitCode, getFeedbackConfig, getInjectionPatterns, getModelPrice, getOrCreateInstallId, getOutline, getParser, getPhaseCategories, getPulseAdapter, getRoadmapMode, getStreamForBranch, getTaintFilePath, getTrustLevel, getUpdateNotification, gitScan, goRules, injectionRules, insecureDefaultsRules, isBadPort, isDuplicateFinding, isRegression, isSanitizedResult, isSmallSuggestion, isUpdateCheckEnabled, isoWeek, listActiveSessions, listPulseAdapters, listStreams, listTaintedSessions, loadBudgetedLearnings, loadEvents, loadFailures, loadHandoff, loadIndexEntries, loadPricingData, loadProjectRoadmapMode, loadRelevantLearnings, loadSessionSummary, loadState, loadStreamIndex, loadTrackerClientConfigFromProject, loadTrackerSyncConfig, logAgentAction, makeTrackerConflictBody, mapInjectionFindings, mapSecurityFindings, mapSecuritySeverity, markProtectedFindings, mcpRules, index as migrate, migrateToStreams, networkRules, nodeRules, normalizeLearningContent, normalizeViolationPattern, paginate, parseCCRecords, parseDateFromEntry, parseDiff, parseFile, parseFileRegions, parseFrontmatter, parseHarnessIgnore, parseLiteLLMData, parseLookback, parseManifest, parseProtectedRegions, parseRoadmap, parseSections, parseSecurityConfig, parseSize, pathTraversalRules, previewFix, projectValue, promoteSessionLearnings, pruneLearnings, reactRules, readAdoptionRecords, readCheckState, readCostRecords, readIdentity, readLockfile, readSessionSection, readSessionSections, readTaint, registerMockAdapter, registerPulseAdapter, removeContributions, removeProvenance, requestMultiplePeerReviews, requestPeerReview, resetFeedbackConfig, resetParserCache, resolveConsent, resolveFileToLayer, resolveModelTier, resolveReverseStatus, resolveRuleSeverity, resolveSessionDir, resolveStability, resolveStreamPath, resolveThresholds, runFallbackRules as runAgentConfigFallbackRules, runAll, runArchitectureAgent, runBugDetectionAgent, runCIChecks, runComplianceAgent, runMechanicalChecks, runMechanicalGate, runMultiTurnPipeline, runPipeline, runPulse, runReviewPipeline, runSecurityAgent, saveHandoff, saveState, saveStreamIndex, scanForInjection, scopeContext, scoreRoadmapCandidates, scoreRoadmapCandidatesFileLess, scoreRoadmapCandidatesForMode, searchSymbols, secretRules, securityFindingId, seedFromStrategy, send, serializeEnvelope, serializeRoadmap, setActiveStream, sharpEdgesRules, shouldRunCheck, spawnBackgroundCheck, splitBundlesByStage, stageDomains, suggestCategory, syncConstraintNodes, syncFromExternal, syncRoadmap, syncToExternal, tagUncitedFindings, topSkills, touchStream, trackAction, unfoldRange, unfoldSymbol, updateSessionEntryStatus, updateSessionIndex, validateAgentConfigs, validateAgentsMap, validateBoundaries, validateBranchName, validateCommitMessage, validateConfig, validateDependencies, validateFileStructure, validateFindings, validateKnowledgeMap, validatePatternConfig, validatePulseConfig, validateRoadmapMode, validateSolutionsDir, violationId, weeksUntilThreshold, weightedLinearRegression, writeConfig, writeLockfile, writePulseConfig, writeSessionSummary, writeTaint, xssRules };
+export { AGENT_DESCRIPTORS, AGREEMENT_LINE_GAP, ALLOWED_FIELD_KEYS, ALL_SOLUTION_CATEGORIES, ARCHITECTURE_DESCRIPTOR, type AST, type AcquireOptions, type ActionContext, type ActionEvent, type ActionEventHandler, type ActionEventType, type ActionResult, type ActionSink, type ActionTracker, type ActionType, type AdjustedForecast, AdjustedForecastSchema, type AgentAction, AgentActionEmitter, type AgentConfigFallbackReason, type AgentConfigFinding, type AgentConfigOptions, type AgentConfigSeverity, type AgentConfigValidation, type AgentExecutor, type AgentMapLink, type AgentMapSection, type AgentMapValidation, type AgentProcess, type AgentReviewResult, type AgentType, type AgentsMapConfig, type AnnotationIssue, type AnnotationIssueType, AnthropicCacheAdapter, type AppendLearningResult, ArchBaseline, ArchBaselineManager, ArchConfig, ArchDiffResult, ArchMetricCategory, type AssembleInput, BUG_DETECTION_DESCRIPTOR, BUG_TRACK_CATEGORIES, 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 BranchValidationResult, type BranchingConfig, type BrokenLink, type BudgetedLearningsOptions, type Bundle, type BundleConstraints, BundleConstraintsSchema, BundleSchema, CACHE_TTL_MS, CINotifier, COMPLIANCE_DESCRIPTOR, CORROBORATED_AGREEMENT, type CacheAdapter, CacheMetricsRecorder, type CacheMetricsRecorderOptions, 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 CompoundLockHandle, CompoundLockHeldError, type ConfidenceTier, ConfidenceTierSchema, type ConfigError, type ConfigPattern, type Confirmation, ConfirmationSchema, ConflictError, 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_LOADER_CONFIG, DEFAULT_PROVIDER_TIERS, DEFAULT_SECURITY_CONFIG, DEFAULT_STABILITY_THRESHOLDS, DEFAULT_STATE, DEFAULT_STREAM_INDEX, DEFAULT_TOKEN_BUDGET, DESTRUCTIVE_BASH, DOMAIN_BASELINES, 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$1 as Direction, DirectionSchema$1 as DirectionSchema, type DocumentationDrift, type DocumentationFile, type DocumentationGap, type DriftConfig, type DriftReport, EMPTY_SUPPLY_CHAIN, ETagStore, EVIDENCE_SATURATION, EXTENSION_MAP, type EligibilityResult, EmergenceResult, 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, FACTOR_WEIGHTS, type FailureEntry, FailureEntrySchema, type FallbackPricingFile, type FanOutOptions, type FeaturePatch, type FeedbackAgentConfig, type FeedbackConfig, type FeedbackError$1 as FeedbackError, type FileCategory, type FileLessScoredCandidate, FileSink, type FindingLifecycle, FindingLifecycleSchema, type FindingSeverity, type Fix, type FixConfig, type FixResult, type FixType, ForbiddenImportCollector, type ForbiddenImportViolation, type ForbiddenPattern, type GateConfig, GateConfigSchema, type GateResult, GateResultSchema, GeminiCacheAdapter, type GenerateRubricOptions, type GenerationSection, type GitHubInlineComment, GitHubIssuesSyncAdapter, type GitScanOptions, type GraphAdapter, type GraphComplexityData, type GraphCouplingData, type GraphCoverageData, type GraphCriticalPathData, type GraphDependencyData, type GraphHarnessCheckData, type GraphImpactData, type GraphNode, type Handoff, HandoffSchema, type HarnessState, HarnessStateSchema, type HealthCheckResult, type HistoryEvent, type HistoryEventType, type Hotspot$1 as Hotspot, type HotspotContext, type Import, type InjectionFinding, type InjectionPattern, type InjectionSeverity, type InlineReference, type IntegrityReport, type InteractionType, InteractionTypeSchema, type InternalSymbol, type IsoWeek, type JSDocComment, KNOWLEDGE_TRACK_CATEGORIES, LITELLM_PRICING_URL, type LanguageParser, type Layer, type LayerConfig, LayerViolationCollector, type LearningPattern, type LearningsFrontmatter, type LearningsIndexEntry, type LiteLLMModelEntry, type LiteLLMPricingData, type LoadEventsOptions, type LoaderConfig, type Lockfile, type LockfilePackage, LockfilePackageSchema, LockfileSchema, type LogEntry, type LogFilter, MOCK_ADAPTER_NAME, type MakeTrackerConflictBodyOptions, 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, type NewFeatureInput, NoOpExecutor, NoOpSink, NoOpTelemetryAdapter, OTLPExporter, type OTLPExporterOptions, OpenAICacheAdapter, type OrchestratorResult, type OrphanedDep, type OutlineResult, type OverlapDimensions, type OverlapResult, PII_FIELD_DENYLIST, PII_LINE_RE, PII_TOKENS, type PackedEnvelope, type PaginatedSlice, type PaginationMeta, type ParallelGroups, type ParseError, type ParsedFile, type ParsedSection, type ParserLookup, 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 ProtectedRegion, type ProtectedRegionMap, type ProtectionScope, type ProviderDefaults, type ProviderSystemBlock, type ProviderToolBlock, type PruneResult, PulseAdapterAlreadyRegisteredError, PulseConfigSchema, type PulseConfigValidation, PulseDbSourceSchema, PulseSourcesSchema, 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 ReviewStage, type ReviewStrength, type RoadmapMode, type RoadmapModeConfig, type RoadmapModeValidationConfig, type RoadmapTrackerClient, type Rubric, type RubricItem, type RuleOverride, RuleRegistry, type RunCIChecksInput, type RunPipelineOptions, SECURITY_DESCRIPTOR, STALENESS_WARNING_DAYS, STANDALONE_AGREEMENT, STATUS_RANK, type SafetyLevel, type ScanConfigFileResult, type ScanConfigFinding, type ScanConfigResult, type Hotspot as ScanHotspot, type HotspotOptions as ScanHotspotOptions, type ScanResult, type ScannedCommit, type ScoredCandidate, type SearchMatch, type SearchResult, type SecurityCategory, type SecurityCategorySnapshot, SecurityCategorySnapshotSchema, type SecurityConfidence, type SecurityConfig, SecurityConfigSchema, type Direction as SecurityDirection, DirectionSchema as SecurityDirectionSchema, type SecurityFinding, type SecurityRule, SecurityScanner, type SecuritySeverity, type SecurityTimelineFile, SecurityTimelineFileSchema, SecurityTimelineManager, type SecurityTimelineSnapshot, SecurityTimelineSnapshotSchema, type SecurityTrendLine, SecurityTrendLineSchema, type SecurityTrendResult, SecurityTrendResultSchema, type SeedOptions, type SelfReviewConfig, type SessionSummaryData, SharableBoundaryConfigSchema, SharableForbiddenImportSchema, SharableLayerSchema, SharableSecurityRulesSchema, type SizeBudgetConfig, type SizeBudgetReport, type SizeBudgetViolation, type SkillEvent, SkillEventSchema, type SkillExecutor, type SkillLoadPlan, SolutionDocFrontmatterSchema, type SolutionsDirValidation, type SourceFile, type Span, type SpanAttributes, type SpanEvent, SpanKind, type SpecImpactEstimate, SpecImpactEstimateSchema, SpecImpactEstimator, SpecImpactSignalsSchema, type StabilityForecast, StabilityForecastSchema, type StabilityTaggedBlock, type StaleConstraint, type StalenessEntry, type StalenessReport, type StepExecutor, type StrategySeed, type StreamIndex, StreamIndexSchema, type StreamInfo, StreamInfoSchema, StructuralStrategy, type StructureValidation, type Suggestion, type SuggestionReport, type SupplyChainSnapshot, SupplyChainSnapshotSchema, type SupportedLanguage, type SuppressionRecord, type SymbolKind, type SyncChange, type SyncOptions, type TaintCheckResult, type TaintFinding, type TaintState, type TelemetryAdapter, type TelemetryHealth, ThresholdConfig, type TimeRange, type TimeToFixResult, TimeToFixResultSchema, type TimeToFixStats, TimeToFixStatsSchema, type CategorySnapshot as TimelineCategorySnapshot, type TimelineFile, TimelineFileSchema, TimelineManager, type TimelineSnapshot, TimelineSnapshotSchema, type TokenBudget, type TokenBudgetOverrides, type ToolDefinition, type Trace, type TraceSpan, type TrackedFeature, type TrackerClientConfig, type TrackerConflictBody, type TrackerSyncAdapter, type Transition, TransitionSchema, type TrendAttribution, TrendAttributionSchema, type TrendLine, TrendLineSchema, type TrendResult, TrendResultSchema, TruncationStrategy, type TrustScoreOptions, type TurnExecutor, TypeScriptParser, type UnfoldResult, type UnusedImport, type UpdateCheckState, VALIDATION_SCORES, VALID_SCOPES, VERSION, type ValidateFindingsOptions, type ValidationError, Violation, type ViolationCluster, ViolationHistory, ViolationHistoryManager, ViolationSnapshot, WHATWG_BAD_PORTS, type WorkflowPhase, type WritePulseConfigOptions, acquireCompoundLock, addProvenance, agentConfigRules, aggregateByDay as aggregateAdoptionByDay, aggregateByDay$1 as aggregateByDay, aggregateBySession, aggregateBySkill, analyzeDiff, analyzeLearningPatterns, appendFailure, appendLearning, appendSessionEntry, applyFixes, applyHotspotDowngrade, applyRecencyWeights, applySyncChanges, archiveFailures, archiveLearnings, archiveSession, archiveStream, assembleCandidateReport, assembleReport, assertPortUsable, assertSanitized, assignFeature, buildDependencyGraph, buildExclusionSet, buildSnapshot, calculateCacheSavings, calculateCost, checkDocCoverage, checkEligibility, checkEvidenceCoverage, checkOverlap, checkTaint, classifyConfidence, classifyFinding, clearEventHashCache, clearFailuresCache, clearLearningsCache, clearPulseAdapters, clearTaint, clusterViolations, collectEvents, computeContentHash, computeHotspots, computeLexicalSimilarity, computeLoadPlan, computeOverallSeverity, computeScanExitCode, computeTrustScores, computeWindow, configureFeedback, constraintRuleId, contextBudget, contextFilter, countLearningEntries, createBoundaryValidator, createCommentedCodeFixes, createError, createFixes, createForbiddenImportFixes, createOrphanedDepFixes, createParseError, createRegionMap, createSelfReview, createStream, createTrackerClient, crossReferenceUndocumentedFixes, cryptoRules, deduplicateCleanupFindings, deduplicateFindings, deepMergeConstraints, defaultCollectors, defineLayer, deserializationRules, detectChangeType, detectCircularDeps, detectCircularDepsInFiles, detectComplexityViolations, detectCouplingViolations, detectDeadCode, detectDocDrift, detectEmergentConstraints, detectLanguage, detectPatternViolations, detectSizeBudgetViolations, detectStack, detectStaleConstraints, detectStaleLearnings, determineAssessment, diff, emitEvent, estimateTokens, executeWorkflow, expressRules, extractBundle, extractDirectoryScope, extractFileReferences, extractHeadlines, extractIndexEntry, extractLevel, extractMarkdownLinks, extractSections, fanOutReview, findParallelGroups, formatCIReportAsMarkdown, formatEventTimeline, formatFindingBlock, formatGitHubComment, formatGitHubSummary, formatIsoWeek, formatOutline, formatTerminalOutput, fullSync, generateAgentsMap, generateRubric, generateSuggestions, getActionEmitter, getExitCode, getFeedbackConfig, getInjectionPatterns, getModelPrice, getOrCreateInstallId, getOutline, getParser, getPhaseCategories, getPulseAdapter, getRoadmapMode, getStreamForBranch, getTaintFilePath, getTrustLevel, getUpdateNotification, gitScan, goRules, injectionRules, insecureDefaultsRules, invalidateCheckState, isBadPort, isDuplicateFinding, isRegression, isSanitizedResult, isSmallSuggestion, isUpdateCheckEnabled, isoWeek, listActiveSessions, listPulseAdapters, listStreams, listTaintedSessions, loadBudgetedLearnings, loadEvents, loadFailures, loadHandoff, loadIndexEntries, loadPricingData, loadProjectRoadmapMode, loadRelevantLearnings, loadSessionSummary, loadState, loadStreamIndex, loadTrackerClientConfigFromProject, loadTrackerSyncConfig, logAgentAction, makeTrackerConflictBody, mapInjectionFindings, mapSecurityFindings, mapSecuritySeverity, markProtectedFindings, mcpRules, index as migrate, migrateToStreams, networkRules, nodeRules, normalizeLearningContent, normalizeViolationPattern, paginate, parseCCRecords, parseDateFromEntry, parseDiff, parseFile, parseFileRegions, parseFrontmatter, parseHarnessIgnore, parseLiteLLMData, parseLookback, parseManifest, parseProtectedRegions, parseRoadmap, parseSections, parseSecurityConfig, parseSize, pathTraversalRules, previewFix, projectValue, promoteSessionLearnings, pruneLearnings, reactRules, readAdoptionRecords, readCheckState, readCostRecords, readIdentity, readLockfile, readSessionSection, readSessionSections, readTaint, registerMockAdapter, registerPulseAdapter, removeContributions, removeProvenance, requestMultiplePeerReviews, requestPeerReview, resetFeedbackConfig, resetParserCache, resolveConsent, resolveFileToLayer, resolveModelTier, resolveReverseStatus, resolveRuleSeverity, resolveSessionDir, resolveStability, resolveStreamPath, resolveThresholds, runFallbackRules as runAgentConfigFallbackRules, runAll, runArchitectureAgent, runBugDetectionAgent, runCIChecks, runComplianceAgent, runMechanicalChecks, runMechanicalGate, runMultiTurnPipeline, runPipeline, runPulse, runReviewPipeline, runSecurityAgent, saveHandoff, saveState, saveStreamIndex, scanForInjection, scopeContext, scoreRoadmapCandidates, scoreRoadmapCandidatesFileLess, scoreRoadmapCandidatesForMode, searchSymbols, secretRules, securityFindingId, seedFromStrategy, send, serializeEnvelope, serializeRoadmap, setActiveStream, sharpEdgesRules, shouldRunCheck, spawnBackgroundCheck, splitBundlesByStage, stageDomains, suggestCategory, syncConstraintNodes, syncFromExternal, syncRoadmap, syncToExternal, tagUncitedFindings, topSkills, touchStream, trackAction, unfoldRange, unfoldSymbol, updateSessionEntryStatus, updateSessionIndex, validateAgentConfigs, validateAgentsMap, validateBoundaries, validateBranchName, validateCommitMessage, validateConfig, validateDependencies, validateFileStructure, validateFindings, validateKnowledgeMap, validatePatternConfig, validatePulseConfig, validateRoadmapMode, validateSolutionsDir, violationId, weeksUntilThreshold, weightedLinearRegression, writeConfig, writeLockfile, writePulseConfig, writeSessionSummary, writeTaint, xssRules };

package/dist/index.js

@@ -55,6 +55,7 @@ __export(index_exports, {
   CINotifier: () => CINotifier,
   COMPLIANCE_DESCRIPTOR: () => COMPLIANCE_DESCRIPTOR,
   CORROBORATED_AGREEMENT: () => CORROBORATED_AGREEMENT,
+  CacheMetricsRecorder: () => CacheMetricsRecorder,
   CategoryBaselineSchema: () => CategoryBaselineSchema,
   CategoryForecastSchema: () => CategoryForecastSchema,
   CategoryRegressionSchema: () => CategoryRegressionSchema,
@@ -119,6 +120,7 @@ __export(index_exports, {
   NoOpExecutor: () => NoOpExecutor,
   NoOpSink: () => NoOpSink,
   NoOpTelemetryAdapter: () => NoOpTelemetryAdapter,
+  OTLPExporter: () => OTLPExporter,
   OpenAICacheAdapter: () => OpenAICacheAdapter,
   PII_FIELD_DENYLIST: () => PII_FIELD_DENYLIST,
   PII_LINE_RE: () => PII_LINE_RE,
@@ -157,6 +159,7 @@ __export(index_exports, {
   SharableSecurityRulesSchema: () => SharableSecurityRulesSchema,
   SkillEventSchema: () => SkillEventSchema,
   SolutionDocFrontmatterSchema: () => SolutionDocFrontmatterSchema,
+  SpanKind: () => SpanKind,
   SpecImpactEstimateSchema: () => SpecImpactEstimateSchema,
   SpecImpactEstimator: () => SpecImpactEstimator,
   SpecImpactSignalsSchema: () => SpecImpactSignalsSchema,
@@ -325,6 +328,7 @@ __export(index_exports, {
   goRules: () => goRules,
   injectionRules: () => injectionRules,
   insecureDefaultsRules: () => insecureDefaultsRules,
+  invalidateCheckState: () => invalidateCheckState,
   isBadPort: () => isBadPort,
   isDuplicateFinding: () => isDuplicateFinding,
   isRegression: () => isRegression,
@@ -5645,7 +5649,10 @@ function findDeadFiles(snapshot, reachability) {
   return deadFiles;
 }
 function isIdentifierUsedInAST(ast, identifier, skipImportDeclaration = true) {
-  const astString = JSON.stringify(ast);
+  const astString = JSON.stringify(
+    ast,
+    (_key, value) => typeof value === "bigint" ? value.toString() : value
+  );
   const identifierPattern = new RegExp(`"name"\\s*:\\s*"${identifier}"`, "g");
   const matches = astString.match(identifierPattern);
   if (!matches) return false;
@@ -20193,6 +20200,12 @@ function shouldRunCheck(state, intervalMs) {
   if (state === null) return true;
   return state.lastCheckTime + intervalMs <= Date.now();
 }
+function invalidateCheckState() {
+  try {
+    fs36.unlinkSync(getStatePath());
+  } catch {
+  }
+}
 function readCheckState() {
   try {
     const raw = fs36.readFileSync(getStatePath(), "utf-8");
@@ -21390,7 +21403,7 @@ function resolveConsent(projectRoot, config) {
 }
 
 // src/version.ts
-var VERSION = "0.23.3";
+var VERSION = "0.25.0";
 
 // src/telemetry/collector.ts
 function mapOutcome(outcome) {
@@ -21451,6 +21464,221 @@ async function send(events, apiKey) {
   }
 }
 
+// src/telemetry/cache-metrics.ts
+var DEFAULT_CAPACITY = 1e3;
+var CacheMetricsRecorder = class {
+  capacity;
+  now;
+  buffer = [];
+  windowStartedAt = 0;
+  constructor(opts = {}) {
+    this.capacity = opts.capacity ?? DEFAULT_CAPACITY;
+    this.now = opts.now ?? Date.now;
+  }
+  /**
+   * Append a single cache observation. Hot-path: O(1) amortized, no
+   * allocations beyond the sample object itself.
+   */
+  record(backendId, hit, tokensCreated, tokensRead) {
+    if (this.windowStartedAt === 0) this.windowStartedAt = this.now();
+    if (this.buffer.length >= this.capacity) this.buffer.shift();
+    this.buffer.push({ backendId, hit, tokensCreated, tokensRead });
+  }
+  /** Aggregate the current window into a `PromptCacheStats` snapshot. */
+  getStats() {
+    let hits = 0;
+    let misses = 0;
+    const byBackend = {};
+    for (const s of this.buffer) {
+      if (s.hit) hits++;
+      else misses++;
+      const slot = byBackend[s.backendId] ?? { hits: 0, misses: 0 };
+      if (s.hit) slot.hits++;
+      else slot.misses++;
+      byBackend[s.backendId] = slot;
+    }
+    const totalRequests = hits + misses;
+    const hitRate = totalRequests === 0 ? 0 : hits / totalRequests;
+    return {
+      totalRequests,
+      hits,
+      misses,
+      hitRate,
+      byBackend,
+      windowStartedAt: this.windowStartedAt
+    };
+  }
+  /** Clear the buffer and reset the window-start marker. */
+  reset() {
+    this.buffer.length = 0;
+    this.windowStartedAt = 0;
+  }
+};
+
+// src/telemetry/exporter/otlp-http.ts
+var RETRY_BACKOFFS_MS = [1e3, 2e3, 4e3];
+function toUnixNanoString(ns) {
+  return ns.toString(10);
+}
+function attributesToOTLP(attrs) {
+  const out = [];
+  for (const [key, value] of Object.entries(attrs)) {
+    if (typeof value === "string") {
+      out.push({ key, value: { stringValue: value } });
+    } else if (typeof value === "boolean") {
+      out.push({ key, value: { boolValue: value } });
+    } else if (typeof value === "number") {
+      if (Number.isInteger(value)) {
+        out.push({ key, value: { intValue: String(value) } });
+      } else {
+        out.push({ key, value: { doubleValue: value } });
+      }
+    }
+  }
+  return out;
+}
+var OTLPExporter = class {
+  endpoint;
+  enabled;
+  headers;
+  flushIntervalMs;
+  batchSize;
+  fetchImpl;
+  warn;
+  buffer = [];
+  timer = null;
+  inFlightFlushes = /* @__PURE__ */ new Set();
+  constructor(opts) {
+    this.endpoint = opts.endpoint;
+    this.enabled = opts.enabled !== false;
+    this.headers = { "Content-Type": "application/json", ...opts.headers ?? {} };
+    this.flushIntervalMs = opts.flushIntervalMs ?? 2e3;
+    this.batchSize = opts.batchSize ?? 64;
+    this.fetchImpl = opts.fetchImpl ?? globalThis.fetch.bind(globalThis);
+    this.warn = opts.warn ?? ((...a) => console.warn(...a));
+  }
+  /**
+   * O(1) buffer push. When `enabled === false` this is a no-op. If the
+   * buffer reaches `batchSize`, a flush is triggered without awaiting.
+   */
+  push(span) {
+    if (!this.enabled) return;
+    this.buffer.push(span);
+    if (this.buffer.length >= this.batchSize) {
+      void this.flush();
+    }
+  }
+  /** Start the periodic flush timer. Idempotent. */
+  start() {
+    if (!this.enabled || this.timer !== null) return;
+    this.timer = setInterval(() => {
+      void this.flush();
+    }, this.flushIntervalMs);
+    if (typeof this.timer.unref === "function") {
+      this.timer.unref();
+    }
+  }
+  /** Flush any pending spans and stop the timer. Awaits all in-flight flushes. */
+  async stop() {
+    if (this.timer !== null) {
+      clearInterval(this.timer);
+      this.timer = null;
+    }
+    void this.flush();
+    while (this.inFlightFlushes.size > 0) {
+      await Promise.all([...this.inFlightFlushes]);
+    }
+  }
+  /**
+   * Synchronously claim the current buffer and POST it to `/v1/traces`.
+   * Each invocation runs independently — concurrent flushes (e.g. one
+   * from the timer, one from a `batchSize` trip) each drain their own
+   * batch. Retries up to 3 times on transport or 5xx failure, then
+   * drops with a single warning.
+   */
+  flush() {
+    if (this.buffer.length === 0) return Promise.resolve();
+    const batch = this.buffer;
+    this.buffer = [];
+    const payload = this.spansToOTLPJSON(batch);
+    const work = (async () => {
+      let lastError = null;
+      for (let attempt = 0; attempt < RETRY_BACKOFFS_MS.length; attempt++) {
+        try {
+          const response = await this.fetchImpl(this.endpoint, {
+            method: "POST",
+            headers: this.headers,
+            body: JSON.stringify(payload)
+          });
+          if (response.ok) return;
+          try {
+            await response.text();
+          } catch {
+          }
+          lastError = new Error(`OTLP endpoint returned ${response.status}`);
+        } catch (err) {
+          lastError = err;
+        }
+        const backoff = RETRY_BACKOFFS_MS[attempt] ?? 0;
+        if (attempt < RETRY_BACKOFFS_MS.length - 1) {
+          await new Promise((resolve12) => setTimeout(resolve12, backoff));
+        }
+      }
+      this.warn(
+        `[harness telemetry] dropping ${batch.length} span(s) after 3 failed OTLP attempts:`,
+        lastError
+      );
+    })();
+    this.inFlightFlushes.add(work);
+    void work.finally(() => this.inFlightFlushes.delete(work));
+    return work;
+  }
+  /**
+   * Build the OTLP/HTTP JSON envelope for a batch of spans. Public for
+   * tests; not part of the supported API surface.
+   */
+  spansToOTLPJSON(spans) {
+    return {
+      resourceSpans: [
+        {
+          resource: {
+            attributes: [{ key: "service.name", value: { stringValue: "harness" } }]
+          },
+          scopeSpans: [
+            {
+              scope: { name: "harness" },
+              spans: spans.map((s) => {
+                const span = {
+                  traceId: s.traceId,
+                  spanId: s.spanId,
+                  name: s.name,
+                  kind: s.kind,
+                  startTimeUnixNano: toUnixNanoString(s.startTimeNs),
+                  endTimeUnixNano: toUnixNanoString(s.endTimeNs),
+                  attributes: attributesToOTLP(s.attributes)
+                };
+                if (s.parentSpanId !== void 0) span["parentSpanId"] = s.parentSpanId;
+                if (s.statusCode !== void 0) span["status"] = { code: s.statusCode };
+                return span;
+              })
+            }
+          ]
+        }
+      ]
+    };
+  }
+};
+
+// src/telemetry/exporter/types.ts
+var SpanKind = /* @__PURE__ */ ((SpanKind2) => {
+  SpanKind2[SpanKind2["INTERNAL"] = 1] = "INTERNAL";
+  SpanKind2[SpanKind2["SERVER"] = 2] = "SERVER";
+  SpanKind2[SpanKind2["CLIENT"] = 3] = "CLIENT";
+  SpanKind2[SpanKind2["PRODUCER"] = 4] = "PRODUCER";
+  SpanKind2[SpanKind2["CONSUMER"] = 5] = "CONSUMER";
+  return SpanKind2;
+})(SpanKind || {});
+
 // src/locks/compound-lock.ts
 var fs43 = __toESM(require("fs"));
 var path43 = __toESM(require("path"));
@@ -22210,6 +22438,7 @@ function assembleCandidateReport(input) {
   CINotifier,
   COMPLIANCE_DESCRIPTOR,
   CORROBORATED_AGREEMENT,
+  CacheMetricsRecorder,
   CategoryBaselineSchema,
   CategoryForecastSchema,
   CategoryRegressionSchema,
@@ -22274,6 +22503,7 @@ function assembleCandidateReport(input) {
   NoOpExecutor,
   NoOpSink,
   NoOpTelemetryAdapter,
+  OTLPExporter,
   OpenAICacheAdapter,
   PII_FIELD_DENYLIST,
   PII_LINE_RE,
@@ -22312,6 +22542,7 @@ function assembleCandidateReport(input) {
   SharableSecurityRulesSchema,
   SkillEventSchema,
   SolutionDocFrontmatterSchema,
+  SpanKind,
   SpecImpactEstimateSchema,
   SpecImpactEstimator,
   SpecImpactSignalsSchema,
@@ -22480,6 +22711,7 @@ function assembleCandidateReport(input) {
   goRules,
   injectionRules,
   insecureDefaultsRules,
+  invalidateCheckState,
   isBadPort,
   isDuplicateFinding,
   isRegression,

package/dist/index.mjs

@@ -3988,7 +3988,10 @@ function findDeadFiles(snapshot, reachability) {
   return deadFiles;
 }
 function isIdentifierUsedInAST(ast, identifier, skipImportDeclaration = true) {
-  const astString = JSON.stringify(ast);
+  const astString = JSON.stringify(
+    ast,
+    (_key, value) => typeof value === "bigint" ? value.toString() : value
+  );
   const identifierPattern = new RegExp(`"name"\\s*:\\s*"${identifier}"`, "g");
   const matches = astString.match(identifierPattern);
   if (!matches) return false;
@@ -16920,6 +16923,12 @@ function shouldRunCheck(state, intervalMs) {
   if (state === null) return true;
   return state.lastCheckTime + intervalMs <= Date.now();
 }
+function invalidateCheckState() {
+  try {
+    fs36.unlinkSync(getStatePath());
+  } catch {
+  }
+}
 function readCheckState() {
   try {
     const raw = fs36.readFileSync(getStatePath(), "utf-8");
@@ -18117,7 +18126,7 @@ function resolveConsent(projectRoot, config) {
 }
 
 // src/version.ts
-var VERSION = "0.23.3";
+var VERSION = "0.25.0";
 
 // src/telemetry/collector.ts
 function mapOutcome(outcome) {
@@ -18178,6 +18187,221 @@ async function send(events, apiKey) {
   }
 }
 
+// src/telemetry/cache-metrics.ts
+var DEFAULT_CAPACITY = 1e3;
+var CacheMetricsRecorder = class {
+  capacity;
+  now;
+  buffer = [];
+  windowStartedAt = 0;
+  constructor(opts = {}) {
+    this.capacity = opts.capacity ?? DEFAULT_CAPACITY;
+    this.now = opts.now ?? Date.now;
+  }
+  /**
+   * Append a single cache observation. Hot-path: O(1) amortized, no
+   * allocations beyond the sample object itself.
+   */
+  record(backendId, hit, tokensCreated, tokensRead) {
+    if (this.windowStartedAt === 0) this.windowStartedAt = this.now();
+    if (this.buffer.length >= this.capacity) this.buffer.shift();
+    this.buffer.push({ backendId, hit, tokensCreated, tokensRead });
+  }
+  /** Aggregate the current window into a `PromptCacheStats` snapshot. */
+  getStats() {
+    let hits = 0;
+    let misses = 0;
+    const byBackend = {};
+    for (const s of this.buffer) {
+      if (s.hit) hits++;
+      else misses++;
+      const slot = byBackend[s.backendId] ?? { hits: 0, misses: 0 };
+      if (s.hit) slot.hits++;
+      else slot.misses++;
+      byBackend[s.backendId] = slot;
+    }
+    const totalRequests = hits + misses;
+    const hitRate = totalRequests === 0 ? 0 : hits / totalRequests;
+    return {
+      totalRequests,
+      hits,
+      misses,
+      hitRate,
+      byBackend,
+      windowStartedAt: this.windowStartedAt
+    };
+  }
+  /** Clear the buffer and reset the window-start marker. */
+  reset() {
+    this.buffer.length = 0;
+    this.windowStartedAt = 0;
+  }
+};
+
+// src/telemetry/exporter/otlp-http.ts
+var RETRY_BACKOFFS_MS = [1e3, 2e3, 4e3];
+function toUnixNanoString(ns) {
+  return ns.toString(10);
+}
+function attributesToOTLP(attrs) {
+  const out = [];
+  for (const [key, value] of Object.entries(attrs)) {
+    if (typeof value === "string") {
+      out.push({ key, value: { stringValue: value } });
+    } else if (typeof value === "boolean") {
+      out.push({ key, value: { boolValue: value } });
+    } else if (typeof value === "number") {
+      if (Number.isInteger(value)) {
+        out.push({ key, value: { intValue: String(value) } });
+      } else {
+        out.push({ key, value: { doubleValue: value } });
+      }
+    }
+  }
+  return out;
+}
+var OTLPExporter = class {
+  endpoint;
+  enabled;
+  headers;
+  flushIntervalMs;
+  batchSize;
+  fetchImpl;
+  warn;
+  buffer = [];
+  timer = null;
+  inFlightFlushes = /* @__PURE__ */ new Set();
+  constructor(opts) {
+    this.endpoint = opts.endpoint;
+    this.enabled = opts.enabled !== false;
+    this.headers = { "Content-Type": "application/json", ...opts.headers ?? {} };
+    this.flushIntervalMs = opts.flushIntervalMs ?? 2e3;
+    this.batchSize = opts.batchSize ?? 64;
+    this.fetchImpl = opts.fetchImpl ?? globalThis.fetch.bind(globalThis);
+    this.warn = opts.warn ?? ((...a) => console.warn(...a));
+  }
+  /**
+   * O(1) buffer push. When `enabled === false` this is a no-op. If the
+   * buffer reaches `batchSize`, a flush is triggered without awaiting.
+   */
+  push(span) {
+    if (!this.enabled) return;
+    this.buffer.push(span);
+    if (this.buffer.length >= this.batchSize) {
+      void this.flush();
+    }
+  }
+  /** Start the periodic flush timer. Idempotent. */
+  start() {
+    if (!this.enabled || this.timer !== null) return;
+    this.timer = setInterval(() => {
+      void this.flush();
+    }, this.flushIntervalMs);
+    if (typeof this.timer.unref === "function") {
+      this.timer.unref();
+    }
+  }
+  /** Flush any pending spans and stop the timer. Awaits all in-flight flushes. */
+  async stop() {
+    if (this.timer !== null) {
+      clearInterval(this.timer);
+      this.timer = null;
+    }
+    void this.flush();
+    while (this.inFlightFlushes.size > 0) {
+      await Promise.all([...this.inFlightFlushes]);
+    }
+  }
+  /**
+   * Synchronously claim the current buffer and POST it to `/v1/traces`.
+   * Each invocation runs independently — concurrent flushes (e.g. one
+   * from the timer, one from a `batchSize` trip) each drain their own
+   * batch. Retries up to 3 times on transport or 5xx failure, then
+   * drops with a single warning.
+   */
+  flush() {
+    if (this.buffer.length === 0) return Promise.resolve();
+    const batch = this.buffer;
+    this.buffer = [];
+    const payload = this.spansToOTLPJSON(batch);
+    const work = (async () => {
+      let lastError = null;
+      for (let attempt = 0; attempt < RETRY_BACKOFFS_MS.length; attempt++) {
+        try {
+          const response = await this.fetchImpl(this.endpoint, {
+            method: "POST",
+            headers: this.headers,
+            body: JSON.stringify(payload)
+          });
+          if (response.ok) return;
+          try {
+            await response.text();
+          } catch {
+          }
+          lastError = new Error(`OTLP endpoint returned ${response.status}`);
+        } catch (err) {
+          lastError = err;
+        }
+        const backoff = RETRY_BACKOFFS_MS[attempt] ?? 0;
+        if (attempt < RETRY_BACKOFFS_MS.length - 1) {
+          await new Promise((resolve10) => setTimeout(resolve10, backoff));
+        }
+      }
+      this.warn(
+        `[harness telemetry] dropping ${batch.length} span(s) after 3 failed OTLP attempts:`,
+        lastError
+      );
+    })();
+    this.inFlightFlushes.add(work);
+    void work.finally(() => this.inFlightFlushes.delete(work));
+    return work;
+  }
+  /**
+   * Build the OTLP/HTTP JSON envelope for a batch of spans. Public for
+   * tests; not part of the supported API surface.
+   */
+  spansToOTLPJSON(spans) {
+    return {
+      resourceSpans: [
+        {
+          resource: {
+            attributes: [{ key: "service.name", value: { stringValue: "harness" } }]
+          },
+          scopeSpans: [
+            {
+              scope: { name: "harness" },
+              spans: spans.map((s) => {
+                const span = {
+                  traceId: s.traceId,
+                  spanId: s.spanId,
+                  name: s.name,
+                  kind: s.kind,
+                  startTimeUnixNano: toUnixNanoString(s.startTimeNs),
+                  endTimeUnixNano: toUnixNanoString(s.endTimeNs),
+                  attributes: attributesToOTLP(s.attributes)
+                };
+                if (s.parentSpanId !== void 0) span["parentSpanId"] = s.parentSpanId;
+                if (s.statusCode !== void 0) span["status"] = { code: s.statusCode };
+                return span;
+              })
+            }
+          ]
+        }
+      ]
+    };
+  }
+};
+
+// src/telemetry/exporter/types.ts
+var SpanKind = /* @__PURE__ */ ((SpanKind2) => {
+  SpanKind2[SpanKind2["INTERNAL"] = 1] = "INTERNAL";
+  SpanKind2[SpanKind2["SERVER"] = 2] = "SERVER";
+  SpanKind2[SpanKind2["CLIENT"] = 3] = "CLIENT";
+  SpanKind2[SpanKind2["PRODUCER"] = 4] = "PRODUCER";
+  SpanKind2[SpanKind2["CONSUMER"] = 5] = "CONSUMER";
+  return SpanKind2;
+})(SpanKind || {});
+
 // src/locks/compound-lock.ts
 import * as fs43 from "fs";
 import * as path43 from "path";
@@ -18935,6 +19159,7 @@ export {
   CINotifier,
   COMPLIANCE_DESCRIPTOR,
   CORROBORATED_AGREEMENT,
+  CacheMetricsRecorder,
   CategoryBaselineSchema,
   CategoryForecastSchema,
   CategoryRegressionSchema,
@@ -18999,6 +19224,7 @@ export {
   NoOpExecutor,
   NoOpSink,
   NoOpTelemetryAdapter,
+  OTLPExporter,
   OpenAICacheAdapter,
   PII_FIELD_DENYLIST,
   PII_LINE_RE,
@@ -19037,6 +19263,7 @@ export {
   SharableSecurityRulesSchema,
   SkillEventSchema,
   SolutionDocFrontmatterSchema,
+  SpanKind,
   SpecImpactEstimateSchema,
   SpecImpactEstimator,
   SpecImpactSignalsSchema,
@@ -19205,6 +19432,7 @@ export {
   goRules,
   injectionRules,
   insecureDefaultsRules,
+  invalidateCheckState,
   isBadPort,
   isDuplicateFinding,
   isRegression,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@harness-engineering/core",
-  "version": "0.26.0",
+  "version": "0.26.1",
   "description": "Core library for Harness Engineering toolkit",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",