@harness-engineering/core 0.13.1 → 0.14.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.mts CHANGED
@@ -1,4 +1,4 @@
1
- import { Result, WorkflowStep, WorkflowStepResult, Workflow, WorkflowResult, SkillLifecycleHooks, SkillContext, SkillResult, TurnContext, CICheckName, CIFailOnSeverity, CICheckReport, Roadmap, FeatureStatus } from '@harness-engineering/types';
1
+ import { Result, SessionSectionName, SessionEntry, SessionSections, WorkflowStep, WorkflowStepResult, Workflow, WorkflowResult, SkillLifecycleHooks, SkillContext, SkillResult, TurnContext, CICheckName, CIFailOnSeverity, CICheckReport, Roadmap, FeatureStatus } from '@harness-engineering/types';
2
2
  export * from '@harness-engineering/types';
3
3
  import { z } from 'zod';
4
4
  import { C as Collector, A as ArchConfig, a as ConstraintRule, M as MetricResult, b as ArchMetricCategory, c as ArchBaseline, d as ArchDiffResult, T as ThresholdConfig } from './matchers-D20x48U9.mjs';
@@ -2691,10 +2691,19 @@ declare class BenchmarkRunner {
2691
2691
  rawOutput: string;
2692
2692
  success: boolean;
2693
2693
  }>;
2694
+ /**
2695
+ * Extract a BenchmarkResult from a single assertion with benchmark data.
2696
+ */
2697
+ private parseBenchAssertion;
2698
+ /**
2699
+ * Extract JSON from output that may contain non-JSON preamble.
2700
+ */
2701
+ private extractJson;
2694
2702
  /**
2695
2703
  * Parse vitest bench JSON reporter output into BenchmarkResult[].
2696
2704
  * Vitest bench JSON output contains testResults with benchmark data.
2697
2705
  */
2706
+ private collectAssertionResults;
2698
2707
  parseVitestBenchOutput(output: string): BenchmarkResult[];
2699
2708
  }
2700
2709
 
@@ -3017,6 +3026,18 @@ declare class ChecklistBuilder {
3017
3026
  addRule(rule: CustomRule): this;
3018
3027
  addRules(rules: CustomRule[]): this;
3019
3028
  withDiffAnalysis(options: SelfReviewConfig['diffAnalysis'], graphImpactData?: GraphImpactData): this;
3029
+ /**
3030
+ * Build a single harness check item with or without graph data.
3031
+ */
3032
+ private buildHarnessCheckItem;
3033
+ /**
3034
+ * Build all harness check items based on harnessOptions and graph data.
3035
+ */
3036
+ private buildHarnessItems;
3037
+ /**
3038
+ * Execute a single custom rule and return a ReviewItem.
3039
+ */
3040
+ private executeCustomRule;
3020
3041
  run(changes: CodeChanges): Promise<Result<ReviewChecklist, FeedbackError>>;
3021
3042
  }
3022
3043
 
@@ -3238,19 +3259,6 @@ declare class ArchBaselineManager {
3238
3259
  save(baseline: ArchBaseline): void;
3239
3260
  }
3240
3261
 
3241
- /**
3242
- * Diff current metric results against a stored baseline.
3243
- *
3244
- * Pure function implementing the ratchet logic:
3245
- * - New violations (in current but not baseline) cause failure
3246
- * - Aggregate value exceeding baseline causes failure (regression)
3247
- * - Pre-existing violations (in both) are allowed
3248
- * - Resolved violations (in baseline but not current) are celebrated
3249
- *
3250
- * Categories present in current but absent from the baseline are treated
3251
- * as having an empty baseline (value: 0, no known violations), so any
3252
- * violations in those categories are considered new.
3253
- */
3254
3262
  declare function diff(current: MetricResult[], baseline: ArchBaseline): ArchDiffResult;
3255
3263
 
3256
3264
  /**
@@ -3717,6 +3725,34 @@ declare function loadSessionSummary(projectPath: string, sessionSlug: string): R
3717
3725
  */
3718
3726
  declare function listActiveSessions(projectPath: string): Result<string | null, Error>;
3719
3727
 
3728
+ /**
3729
+ * Reads all session sections. Returns empty sections if no session state exists.
3730
+ */
3731
+ declare function readSessionSections(projectPath: string, sessionSlug: string): Promise<Result<SessionSections, Error>>;
3732
+ /**
3733
+ * Reads a single session section by name. Returns empty array if section has no entries.
3734
+ */
3735
+ declare function readSessionSection(projectPath: string, sessionSlug: string, section: SessionSectionName): Promise<Result<SessionEntry[], Error>>;
3736
+ /**
3737
+ * Appends an entry to a session section (read-before-write).
3738
+ * Generates a unique ID and timestamp for the entry.
3739
+ */
3740
+ declare function appendSessionEntry(projectPath: string, sessionSlug: string, section: SessionSectionName, authorSkill: string, content: string): Promise<Result<SessionEntry, Error>>;
3741
+ /**
3742
+ * Updates the status of an existing entry in a session section.
3743
+ * Returns Err if the entry is not found.
3744
+ */
3745
+ declare function updateSessionEntryStatus(projectPath: string, sessionSlug: string, section: SessionSectionName, entryId: string, newStatus: SessionEntry['status']): Promise<Result<SessionEntry, Error>>;
3746
+
3747
+ /**
3748
+ * Archives a session by moving its directory to
3749
+ * `.harness/archive/sessions/<slug>-<date>`.
3750
+ *
3751
+ * The original session directory is removed. If an archive with the same
3752
+ * date already exists, a numeric counter is appended.
3753
+ */
3754
+ declare function archiveSession(projectPath: string, sessionSlug: string): Promise<Result<void, Error>>;
3755
+
3720
3756
  type StepExecutor = (step: WorkflowStep, previousArtifact?: string) => Promise<WorkflowStepResult>;
3721
3757
  declare function executeWorkflow(workflow: Workflow, executor: StepExecutor): Promise<WorkflowResult>;
3722
3758
 
@@ -3971,6 +4007,22 @@ interface MechanicalCheckOptions {
3971
4007
  /** Only scan these files for security (e.g., changed files from a PR) */
3972
4008
  changedFiles?: string[];
3973
4009
  }
4010
+ /**
4011
+ * Report on evidence coverage across review findings.
4012
+ * Produced by the evidence gate and included in review output.
4013
+ */
4014
+ interface EvidenceCoverageReport {
4015
+ /** Total evidence entries loaded from session state */
4016
+ totalEntries: number;
4017
+ /** Number of findings that have matching evidence entries */
4018
+ findingsWithEvidence: number;
4019
+ /** Number of findings without matching evidence (flagged [UNVERIFIED]) */
4020
+ uncitedCount: number;
4021
+ /** Titles of uncited findings (for reporting) */
4022
+ uncitedFindings: string[];
4023
+ /** Coverage percentage (findingsWithEvidence / total findings * 100) */
4024
+ coveragePercentage: number;
4025
+ }
3974
4026
 
3975
4027
  /**
3976
4028
  * Change type detected from commit message prefix or diff heuristic.
@@ -4194,6 +4246,8 @@ interface ReviewOutputOptions {
4194
4246
  prNumber?: number;
4195
4247
  /** Repository in owner/repo format (required for GitHub comments) */
4196
4248
  repo?: string;
4249
+ /** Evidence coverage report to append to output (optional) */
4250
+ evidenceCoverage?: EvidenceCoverageReport;
4197
4251
  }
4198
4252
  /**
4199
4253
  * A formatted GitHub inline comment ready for posting.
@@ -4333,6 +4387,8 @@ interface PipelineContext {
4333
4387
  checkDepsOutput?: string;
4334
4388
  /** Repository in owner/repo format (for --comment) */
4335
4389
  repo?: string;
4390
+ /** Session slug for evidence checking (optional) */
4391
+ sessionSlug?: string;
4336
4392
  /** Whether the pipeline was skipped by the gate */
4337
4393
  skipped: boolean;
4338
4394
  /** Reason for skipping (when skipped is true) */
@@ -4359,6 +4415,8 @@ interface PipelineContext {
4359
4415
  githubComments?: GitHubInlineComment[];
4360
4416
  /** Process exit code (0 = approve/comment, 1 = request-changes) */
4361
4417
  exitCode: number;
4418
+ /** Evidence coverage report (when session evidence is available) */
4419
+ evidenceCoverage?: EvidenceCoverageReport;
4362
4420
  }
4363
4421
  /**
4364
4422
  * Immutable result returned from `runPipeline()`.
@@ -4384,6 +4442,8 @@ interface ReviewPipelineResult {
4384
4442
  exitCode: number;
4385
4443
  /** Mechanical check result (for reporting) */
4386
4444
  mechanicalResult?: MechanicalCheckResult;
4445
+ /** Evidence coverage report (when session evidence is available) */
4446
+ evidenceCoverage?: EvidenceCoverageReport;
4387
4447
  }
4388
4448
 
4389
4449
  /**
@@ -4419,15 +4479,6 @@ declare function scopeContext(options: ContextScopeOptions): Promise<ContextBund
4419
4479
  * Descriptor for the compliance review agent.
4420
4480
  */
4421
4481
  declare const COMPLIANCE_DESCRIPTOR: ReviewAgentDescriptor;
4422
- /**
4423
- * Run the compliance review agent.
4424
- *
4425
- * Analyzes the context bundle for convention adherence, spec alignment,
4426
- * and documentation completeness. Produces ReviewFinding[] with domain 'compliance'.
4427
- *
4428
- * This function performs static/heuristic analysis. The actual LLM invocation
4429
- * for deeper compliance review happens at the orchestration layer (MCP/CLI).
4430
- */
4431
4482
  declare function runComplianceAgent(bundle: ContextBundle): ReviewFinding[];
4432
4483
 
4433
4484
  declare const BUG_DETECTION_DESCRIPTOR: ReviewAgentDescriptor;
@@ -4581,6 +4632,7 @@ declare function formatFindingBlock(finding: ReviewFinding): string;
4581
4632
  declare function formatTerminalOutput(options: {
4582
4633
  findings: ReviewFinding[];
4583
4634
  strengths: ReviewStrength[];
4635
+ evidenceCoverage?: EvidenceCoverageReport;
4584
4636
  }): string;
4585
4637
 
4586
4638
  /**
@@ -4602,8 +4654,22 @@ declare function formatGitHubComment(finding: ReviewFinding): GitHubInlineCommen
4602
4654
  declare function formatGitHubSummary(options: {
4603
4655
  findings: ReviewFinding[];
4604
4656
  strengths: ReviewStrength[];
4657
+ evidenceCoverage?: EvidenceCoverageReport;
4605
4658
  }): string;
4606
4659
 
4660
+ /**
4661
+ * Check evidence coverage for a set of review findings against session evidence entries.
4662
+ *
4663
+ * For each finding, checks whether any active evidence entry references the same
4664
+ * file:line location. Findings without matching evidence are flagged as uncited.
4665
+ */
4666
+ declare function checkEvidenceCoverage(findings: ReviewFinding[], evidenceEntries: SessionEntry[]): EvidenceCoverageReport;
4667
+ /**
4668
+ * Tag uncited findings by prefixing their title with [UNVERIFIED].
4669
+ * Mutates the findings array in place and returns it.
4670
+ */
4671
+ declare function tagUncitedFindings(findings: ReviewFinding[], evidenceEntries: SessionEntry[]): ReviewFinding[];
4672
+
4607
4673
  /**
4608
4674
  * Options for invoking the pipeline.
4609
4675
  */
@@ -4622,6 +4688,8 @@ interface RunPipelineOptions {
4622
4688
  config?: Record<string, unknown>;
4623
4689
  /** Pre-gathered commit history entries */
4624
4690
  commitHistory?: CommitHistoryEntry[];
4691
+ /** Session slug for loading evidence entries (optional) */
4692
+ sessionSlug?: string;
4625
4693
  }
4626
4694
  /**
4627
4695
  * Run the full 7-phase code review pipeline.
@@ -4919,6 +4987,6 @@ declare function getUpdateNotification(currentVersion: string): string | null;
4919
4987
  * release. Kept only as a fallback for consumers that cannot resolve the CLI
4920
4988
  * package at runtime.
4921
4989
  */
4922
- declare const VERSION = "0.13.0";
4990
+ declare const VERSION = "0.14.0";
4923
4991
 
4924
- export { AGENT_DESCRIPTORS, ARCHITECTURE_DESCRIPTOR, type AST, type ActionContext, type ActionEvent, type ActionEventHandler, type ActionEventType, type ActionResult, type ActionSink, type ActionTracker, type ActionType, type AgentAction, AgentActionEmitter, type AgentExecutor, type AgentMapLink, type AgentMapSection, type AgentMapValidation, type AgentProcess, type AgentReviewResult, type AgentType, type AgentsMapConfig, ArchBaseline, ArchBaselineManager, ArchConfig, ArchDiffResult, ArchMetricCategory, BUG_DETECTION_DESCRIPTOR, type BaseError, type Baseline, BaselineManager, type BaselinesFile, type BenchmarkResult, type BenchmarkRunOptions, BenchmarkRunner, type BlueprintData, BlueprintGenerator, type BlueprintModule, type BlueprintOptions, type BoundaryDefinition, type BoundaryValidation, type BoundaryValidator, type BoundaryViolation, type BrokenLink, type BudgetedLearningsOptions, type Bundle, type BundleConstraints, BundleConstraintsSchema, BundleSchema, COMPLIANCE_DESCRIPTOR, type ChangeType, type ChangedFile, ChecklistBuilder, type CircularDependency, CircularDepsCollector, type CircularDepsResult, type CleanupFinding, type CodeBlock, type CodeChanges, type CodePattern, type CodeReference, type CodebaseSnapshot, Collector, type CommentedCodeBlock, type CommitFormat, type CommitHistoryEntry, type CommitValidation, ComplexityCollector, type ComplexityConfig, type ComplexityReport, type ComplexityThresholds, type ComplexityViolation, type ConfigError, type ConfigPattern, type Confirmation, ConfirmationSchema, type ConflictReport, ConsoleSink, type ConstraintError, type ConstraintNodeStore, ConstraintRule, type Content, ContentPipeline, type ContextBundle, type ContextError, type ContextFile, type ContextFilterResult, type ContextScopeOptions, type Contributions, ContributionsSchema, type Convention, CouplingCollector, type CouplingConfig, type CouplingReport, type CouplingThresholds, type CouplingViolation, type CoverageOptions, type CoverageReport, type CriticalPathEntry, CriticalPathResolver, type CriticalPathSet, type CustomRule, type CustomRuleResult, DEFAULT_PROVIDER_TIERS, DEFAULT_SECURITY_CONFIG, DEFAULT_STATE, DEFAULT_STREAM_INDEX, type DeadCodeConfig, type DeadCodeReport, type DeadExport, type DeadFile, type DeadInternal, type DeduplicateFindingsOptions, DepDepthCollector, type DependencyEdge, type DependencyGraph, type DependencyValidation, type DependencyViolation, type DetectStaleResult, type DiffInfo, type DocumentationDrift, type DocumentationFile, type DocumentationGap, type DriftConfig, type DriftReport, type EligibilityResult, type EmitInteractionInput, EmitInteractionInputSchema, EntropyAnalyzer, type EntropyConfig, EntropyConfigSchema, type EntropyError, type EntropyReport, ExclusionSet, type ExecutorHealth, type Export, type ExportMap, type FailureEntry, FailureEntrySchema, type FanOutOptions, type FeedbackAgentConfig, type FeedbackConfig, type FeedbackError$1 as FeedbackError, type FileCategory, FileSink, type FindingSeverity, type Fix, type FixConfig, type FixResult, type FixType, ForbiddenImportCollector, type ForbiddenImportViolation, type ForbiddenPattern, type GateConfig, GateConfigSchema, type GateResult, GateResultSchema, type GenerationSection, type GitHubInlineComment, type GraphAdapter, type GraphComplexityData, type GraphCouplingData, type GraphCoverageData, type GraphCriticalPathData, type GraphDependencyData, type GraphHarnessCheckData, type GraphImpactData, type Handoff, HandoffSchema, type HarnessState, HarnessStateSchema, type HealthCheckResult, type Hotspot, type HotspotContext, type Import, type InlineReference, type IntegrityReport, type InteractionType, InteractionTypeSchema, type InternalSymbol, type JSDocComment, type LanguageParser, type Layer, type LayerConfig, LayerViolationCollector, type LearningPattern, type Lockfile, type LockfilePackage, LockfilePackageSchema, LockfileSchema, type LogEntry, type LogFilter, type Manifest, ManifestSchema, type MechanicalCheckOptions, type MechanicalCheckResult, type MechanicalCheckStatus, type MechanicalFinding, type MergeResult, type Metric, MetricResult, type ModelProvider, type ModelTier, type ModelTierConfig, type ModuleDependency, ModuleSizeCollector, NoOpExecutor, NoOpSink, NoOpTelemetryAdapter, type OrphanedDep, type ParseError, type PatternConfig, PatternConfigSchema, type PatternMatch, type PatternReport, type PatternViolation, type PeerReview, type PeerReviewOptions, type PipelineContext, type PipelineFlags, type PipelineOptions, type PipelineResult, type PrMetadata, type PriorReview, ProjectScanner, type ProviderDefaults, type PruneResult, type Question, QuestionSchema, REQUIRED_SECTIONS, type ReachabilityNode, RegressionDetector, type RegressionReport, type RegressionResult, type ReviewAgentDescriptor, type ReviewAssessment, type ReviewChecklist, type ReviewComment, type ReviewContext, type ReviewDomain, type ReviewFinding, type ReviewItem, type ReviewOutputOptions, type ReviewPipelineResult, type ReviewStrength, type RuleOverride, RuleRegistry, type RunCIChecksInput, type RunPipelineOptions, SECURITY_DESCRIPTOR, type SafetyLevel, type ScanResult, type SecurityCategory, type SecurityConfidence, type SecurityConfig, SecurityConfigSchema, type SecurityFinding, type SecurityRule, SecurityScanner, type SecuritySeverity, type SelfReviewConfig, type SessionSummaryData, SharableBoundaryConfigSchema, SharableForbiddenImportSchema, SharableLayerSchema, SharableSecurityRulesSchema, type SizeBudgetConfig, type SizeBudgetReport, type SizeBudgetViolation, type SkillExecutor, type SourceFile, type Span, type SpanEvent, type StaleConstraint, type StepExecutor, type StreamIndex, StreamIndexSchema, type StreamInfo, StreamInfoSchema, type StructureValidation, type Suggestion, type SuggestionReport, type SyncChange, type SyncOptions, type TelemetryAdapter, type TelemetryHealth, ThresholdConfig, type TimeRange, type TokenBudget, type TokenBudgetOverrides, type Trace, type Transition, TransitionSchema, type TurnExecutor, TypeScriptParser, type UnusedImport, type UpdateCheckState, VERSION, type ValidateFindingsOptions, type ValidationError, type WorkflowPhase, addProvenance, analyzeDiff, analyzeLearningPatterns, appendFailure, appendLearning, applyFixes, applyHotspotDowngrade, archiveFailures, archiveLearnings, archiveStream, buildDependencyGraph, buildExclusionSet, buildSnapshot, checkDocCoverage, checkEligibility, classifyFinding, clearFailuresCache, clearLearningsCache, configureFeedback, constraintRuleId, contextBudget, contextFilter, createBoundaryValidator, createCommentedCodeFixes, createError, createFixes, createForbiddenImportFixes, createOrphanedDepFixes, createParseError, createSelfReview, createStream, cryptoRules, deduplicateCleanupFindings, deduplicateFindings, deepMergeConstraints, defaultCollectors, defineLayer, deserializationRules, detectChangeType, detectCircularDeps, detectCircularDepsInFiles, detectComplexityViolations, detectCouplingViolations, detectDeadCode, detectDocDrift, detectPatternViolations, detectSizeBudgetViolations, detectStack, detectStaleConstraints, determineAssessment, diff, executeWorkflow, expressRules, extractBundle, extractMarkdownLinks, extractSections, fanOutReview, formatFindingBlock, formatGitHubComment, formatGitHubSummary, formatTerminalOutput, generateAgentsMap, generateSuggestions, getActionEmitter, getExitCode, getFeedbackConfig, getPhaseCategories, getStreamForBranch, getUpdateNotification, goRules, injectionRules, isSmallSuggestion, isUpdateCheckEnabled, listActiveSessions, listStreams, loadBudgetedLearnings, loadFailures, loadHandoff, loadRelevantLearnings, loadSessionSummary, loadState, loadStreamIndex, logAgentAction, migrateToStreams, networkRules, nodeRules, parseDateFromEntry, parseDiff, parseManifest, parseRoadmap, parseSecurityConfig, parseSize, pathTraversalRules, previewFix, pruneLearnings, reactRules, readCheckState, readLockfile, removeContributions, removeProvenance, requestMultiplePeerReviews, requestPeerReview, resetFeedbackConfig, resolveFileToLayer, resolveModelTier, resolveRuleSeverity, resolveSessionDir, resolveStreamPath, resolveThresholds, runAll, runArchitectureAgent, runBugDetectionAgent, runCIChecks, runComplianceAgent, runMechanicalChecks, runMechanicalGate, runMultiTurnPipeline, runPipeline, runReviewPipeline, runSecurityAgent, saveHandoff, saveState, saveStreamIndex, scopeContext, secretRules, serializeRoadmap, setActiveStream, shouldRunCheck, spawnBackgroundCheck, syncConstraintNodes, syncRoadmap, touchStream, trackAction, updateSessionIndex, validateAgentsMap, validateBoundaries, validateCommitMessage, validateConfig, validateDependencies, validateFileStructure, validateFindings, validateKnowledgeMap, validatePatternConfig, violationId, writeConfig, writeLockfile, writeSessionSummary, xssRules };
4992
+ export { AGENT_DESCRIPTORS, ARCHITECTURE_DESCRIPTOR, type AST, type ActionContext, type ActionEvent, type ActionEventHandler, type ActionEventType, type ActionResult, type ActionSink, type ActionTracker, type ActionType, type AgentAction, AgentActionEmitter, type AgentExecutor, type AgentMapLink, type AgentMapSection, type AgentMapValidation, type AgentProcess, type AgentReviewResult, type AgentType, type AgentsMapConfig, ArchBaseline, ArchBaselineManager, ArchConfig, ArchDiffResult, ArchMetricCategory, BUG_DETECTION_DESCRIPTOR, type BaseError, type Baseline, BaselineManager, type BaselinesFile, type BenchmarkResult, type BenchmarkRunOptions, BenchmarkRunner, type BlueprintData, BlueprintGenerator, type BlueprintModule, type BlueprintOptions, type BoundaryDefinition, type BoundaryValidation, type BoundaryValidator, type BoundaryViolation, type BrokenLink, type BudgetedLearningsOptions, type Bundle, type BundleConstraints, BundleConstraintsSchema, BundleSchema, COMPLIANCE_DESCRIPTOR, type ChangeType, type ChangedFile, ChecklistBuilder, type CircularDependency, CircularDepsCollector, type CircularDepsResult, type CleanupFinding, type CodeBlock, type CodeChanges, type CodePattern, type CodeReference, type CodebaseSnapshot, Collector, type CommentedCodeBlock, type CommitFormat, type CommitHistoryEntry, type CommitValidation, ComplexityCollector, type ComplexityConfig, type ComplexityReport, type ComplexityThresholds, type ComplexityViolation, type ConfigError, type ConfigPattern, type Confirmation, ConfirmationSchema, type ConflictReport, ConsoleSink, type ConstraintError, type ConstraintNodeStore, ConstraintRule, type Content, ContentPipeline, type ContextBundle, type ContextError, type ContextFile, type ContextFilterResult, type ContextScopeOptions, type Contributions, ContributionsSchema, type Convention, CouplingCollector, type CouplingConfig, type CouplingReport, type CouplingThresholds, type CouplingViolation, type CoverageOptions, type CoverageReport, type CriticalPathEntry, CriticalPathResolver, type CriticalPathSet, type CustomRule, type CustomRuleResult, DEFAULT_PROVIDER_TIERS, DEFAULT_SECURITY_CONFIG, DEFAULT_STATE, DEFAULT_STREAM_INDEX, type DeadCodeConfig, type DeadCodeReport, type DeadExport, type DeadFile, type DeadInternal, type DeduplicateFindingsOptions, DepDepthCollector, type DependencyEdge, type DependencyGraph, type DependencyValidation, type DependencyViolation, type DetectStaleResult, type DiffInfo, type DocumentationDrift, type DocumentationFile, type DocumentationGap, type DriftConfig, type DriftReport, type EligibilityResult, type EmitInteractionInput, EmitInteractionInputSchema, EntropyAnalyzer, type EntropyConfig, EntropyConfigSchema, type EntropyError, type EntropyReport, type EvidenceCoverageReport, ExclusionSet, type ExecutorHealth, type Export, type ExportMap, type FailureEntry, FailureEntrySchema, type FanOutOptions, type FeedbackAgentConfig, type FeedbackConfig, type FeedbackError$1 as FeedbackError, type FileCategory, FileSink, type FindingSeverity, type Fix, type FixConfig, type FixResult, type FixType, ForbiddenImportCollector, type ForbiddenImportViolation, type ForbiddenPattern, type GateConfig, GateConfigSchema, type GateResult, GateResultSchema, type GenerationSection, type GitHubInlineComment, type GraphAdapter, type GraphComplexityData, type GraphCouplingData, type GraphCoverageData, type GraphCriticalPathData, type GraphDependencyData, type GraphHarnessCheckData, type GraphImpactData, type Handoff, HandoffSchema, type HarnessState, HarnessStateSchema, type HealthCheckResult, type Hotspot, type HotspotContext, type Import, type InlineReference, type IntegrityReport, type InteractionType, InteractionTypeSchema, type InternalSymbol, type JSDocComment, type LanguageParser, type Layer, type LayerConfig, LayerViolationCollector, type LearningPattern, type Lockfile, type LockfilePackage, LockfilePackageSchema, LockfileSchema, type LogEntry, type LogFilter, type Manifest, ManifestSchema, type MechanicalCheckOptions, type MechanicalCheckResult, type MechanicalCheckStatus, type MechanicalFinding, type MergeResult, type Metric, MetricResult, type ModelProvider, type ModelTier, type ModelTierConfig, type ModuleDependency, ModuleSizeCollector, NoOpExecutor, NoOpSink, NoOpTelemetryAdapter, type OrphanedDep, type ParseError, type PatternConfig, PatternConfigSchema, type PatternMatch, type PatternReport, type PatternViolation, type PeerReview, type PeerReviewOptions, type PipelineContext, type PipelineFlags, type PipelineOptions, type PipelineResult, type PrMetadata, type PriorReview, ProjectScanner, type ProviderDefaults, type PruneResult, type Question, QuestionSchema, REQUIRED_SECTIONS, type ReachabilityNode, RegressionDetector, type RegressionReport, type RegressionResult, type ReviewAgentDescriptor, type ReviewAssessment, type ReviewChecklist, type ReviewComment, type ReviewContext, type ReviewDomain, type ReviewFinding, type ReviewItem, type ReviewOutputOptions, type ReviewPipelineResult, type ReviewStrength, type RuleOverride, RuleRegistry, type RunCIChecksInput, type RunPipelineOptions, SECURITY_DESCRIPTOR, type SafetyLevel, type ScanResult, type SecurityCategory, type SecurityConfidence, type SecurityConfig, SecurityConfigSchema, type SecurityFinding, type SecurityRule, SecurityScanner, type SecuritySeverity, type SelfReviewConfig, type SessionSummaryData, SharableBoundaryConfigSchema, SharableForbiddenImportSchema, SharableLayerSchema, SharableSecurityRulesSchema, type SizeBudgetConfig, type SizeBudgetReport, type SizeBudgetViolation, type SkillExecutor, type SourceFile, type Span, type SpanEvent, type StaleConstraint, type StepExecutor, type StreamIndex, StreamIndexSchema, type StreamInfo, StreamInfoSchema, type StructureValidation, type Suggestion, type SuggestionReport, type SyncChange, type SyncOptions, type TelemetryAdapter, type TelemetryHealth, ThresholdConfig, type TimeRange, type TokenBudget, type TokenBudgetOverrides, type Trace, type Transition, TransitionSchema, type TurnExecutor, TypeScriptParser, type UnusedImport, type UpdateCheckState, VERSION, type ValidateFindingsOptions, type ValidationError, type WorkflowPhase, addProvenance, analyzeDiff, analyzeLearningPatterns, appendFailure, appendLearning, appendSessionEntry, applyFixes, applyHotspotDowngrade, archiveFailures, archiveLearnings, archiveSession, archiveStream, buildDependencyGraph, buildExclusionSet, buildSnapshot, checkDocCoverage, checkEligibility, checkEvidenceCoverage, classifyFinding, clearFailuresCache, clearLearningsCache, configureFeedback, constraintRuleId, contextBudget, contextFilter, createBoundaryValidator, createCommentedCodeFixes, createError, createFixes, createForbiddenImportFixes, createOrphanedDepFixes, createParseError, createSelfReview, createStream, cryptoRules, deduplicateCleanupFindings, deduplicateFindings, deepMergeConstraints, defaultCollectors, defineLayer, deserializationRules, detectChangeType, detectCircularDeps, detectCircularDepsInFiles, detectComplexityViolations, detectCouplingViolations, detectDeadCode, detectDocDrift, detectPatternViolations, detectSizeBudgetViolations, detectStack, detectStaleConstraints, determineAssessment, diff, executeWorkflow, expressRules, extractBundle, extractMarkdownLinks, extractSections, fanOutReview, formatFindingBlock, formatGitHubComment, formatGitHubSummary, formatTerminalOutput, generateAgentsMap, generateSuggestions, getActionEmitter, getExitCode, getFeedbackConfig, getPhaseCategories, getStreamForBranch, getUpdateNotification, goRules, injectionRules, isSmallSuggestion, isUpdateCheckEnabled, listActiveSessions, listStreams, loadBudgetedLearnings, loadFailures, loadHandoff, loadRelevantLearnings, loadSessionSummary, loadState, loadStreamIndex, logAgentAction, migrateToStreams, networkRules, nodeRules, parseDateFromEntry, parseDiff, parseManifest, parseRoadmap, parseSecurityConfig, parseSize, pathTraversalRules, previewFix, pruneLearnings, reactRules, readCheckState, readLockfile, readSessionSection, readSessionSections, removeContributions, removeProvenance, requestMultiplePeerReviews, requestPeerReview, resetFeedbackConfig, resolveFileToLayer, resolveModelTier, resolveRuleSeverity, resolveSessionDir, resolveStreamPath, resolveThresholds, runAll, runArchitectureAgent, runBugDetectionAgent, runCIChecks, runComplianceAgent, runMechanicalChecks, runMechanicalGate, runMultiTurnPipeline, runPipeline, runReviewPipeline, runSecurityAgent, saveHandoff, saveState, saveStreamIndex, scopeContext, secretRules, serializeRoadmap, setActiveStream, shouldRunCheck, spawnBackgroundCheck, syncConstraintNodes, syncRoadmap, tagUncitedFindings, touchStream, trackAction, updateSessionEntryStatus, updateSessionIndex, validateAgentsMap, validateBoundaries, validateCommitMessage, validateConfig, validateDependencies, validateFileStructure, validateFindings, validateKnowledgeMap, validatePatternConfig, violationId, writeConfig, writeLockfile, writeSessionSummary, xssRules };
package/dist/index.d.ts CHANGED
@@ -1,4 +1,4 @@
1
- import { Result, WorkflowStep, WorkflowStepResult, Workflow, WorkflowResult, SkillLifecycleHooks, SkillContext, SkillResult, TurnContext, CICheckName, CIFailOnSeverity, CICheckReport, Roadmap, FeatureStatus } from '@harness-engineering/types';
1
+ import { Result, SessionSectionName, SessionEntry, SessionSections, WorkflowStep, WorkflowStepResult, Workflow, WorkflowResult, SkillLifecycleHooks, SkillContext, SkillResult, TurnContext, CICheckName, CIFailOnSeverity, CICheckReport, Roadmap, FeatureStatus } from '@harness-engineering/types';
2
2
  export * from '@harness-engineering/types';
3
3
  import { z } from 'zod';
4
4
  import { C as Collector, A as ArchConfig, a as ConstraintRule, M as MetricResult, b as ArchMetricCategory, c as ArchBaseline, d as ArchDiffResult, T as ThresholdConfig } from './matchers-D20x48U9.js';
@@ -2691,10 +2691,19 @@ declare class BenchmarkRunner {
2691
2691
  rawOutput: string;
2692
2692
  success: boolean;
2693
2693
  }>;
2694
+ /**
2695
+ * Extract a BenchmarkResult from a single assertion with benchmark data.
2696
+ */
2697
+ private parseBenchAssertion;
2698
+ /**
2699
+ * Extract JSON from output that may contain non-JSON preamble.
2700
+ */
2701
+ private extractJson;
2694
2702
  /**
2695
2703
  * Parse vitest bench JSON reporter output into BenchmarkResult[].
2696
2704
  * Vitest bench JSON output contains testResults with benchmark data.
2697
2705
  */
2706
+ private collectAssertionResults;
2698
2707
  parseVitestBenchOutput(output: string): BenchmarkResult[];
2699
2708
  }
2700
2709
 
@@ -3017,6 +3026,18 @@ declare class ChecklistBuilder {
3017
3026
  addRule(rule: CustomRule): this;
3018
3027
  addRules(rules: CustomRule[]): this;
3019
3028
  withDiffAnalysis(options: SelfReviewConfig['diffAnalysis'], graphImpactData?: GraphImpactData): this;
3029
+ /**
3030
+ * Build a single harness check item with or without graph data.
3031
+ */
3032
+ private buildHarnessCheckItem;
3033
+ /**
3034
+ * Build all harness check items based on harnessOptions and graph data.
3035
+ */
3036
+ private buildHarnessItems;
3037
+ /**
3038
+ * Execute a single custom rule and return a ReviewItem.
3039
+ */
3040
+ private executeCustomRule;
3020
3041
  run(changes: CodeChanges): Promise<Result<ReviewChecklist, FeedbackError>>;
3021
3042
  }
3022
3043
 
@@ -3238,19 +3259,6 @@ declare class ArchBaselineManager {
3238
3259
  save(baseline: ArchBaseline): void;
3239
3260
  }
3240
3261
 
3241
- /**
3242
- * Diff current metric results against a stored baseline.
3243
- *
3244
- * Pure function implementing the ratchet logic:
3245
- * - New violations (in current but not baseline) cause failure
3246
- * - Aggregate value exceeding baseline causes failure (regression)
3247
- * - Pre-existing violations (in both) are allowed
3248
- * - Resolved violations (in baseline but not current) are celebrated
3249
- *
3250
- * Categories present in current but absent from the baseline are treated
3251
- * as having an empty baseline (value: 0, no known violations), so any
3252
- * violations in those categories are considered new.
3253
- */
3254
3262
  declare function diff(current: MetricResult[], baseline: ArchBaseline): ArchDiffResult;
3255
3263
 
3256
3264
  /**
@@ -3717,6 +3725,34 @@ declare function loadSessionSummary(projectPath: string, sessionSlug: string): R
3717
3725
  */
3718
3726
  declare function listActiveSessions(projectPath: string): Result<string | null, Error>;
3719
3727
 
3728
+ /**
3729
+ * Reads all session sections. Returns empty sections if no session state exists.
3730
+ */
3731
+ declare function readSessionSections(projectPath: string, sessionSlug: string): Promise<Result<SessionSections, Error>>;
3732
+ /**
3733
+ * Reads a single session section by name. Returns empty array if section has no entries.
3734
+ */
3735
+ declare function readSessionSection(projectPath: string, sessionSlug: string, section: SessionSectionName): Promise<Result<SessionEntry[], Error>>;
3736
+ /**
3737
+ * Appends an entry to a session section (read-before-write).
3738
+ * Generates a unique ID and timestamp for the entry.
3739
+ */
3740
+ declare function appendSessionEntry(projectPath: string, sessionSlug: string, section: SessionSectionName, authorSkill: string, content: string): Promise<Result<SessionEntry, Error>>;
3741
+ /**
3742
+ * Updates the status of an existing entry in a session section.
3743
+ * Returns Err if the entry is not found.
3744
+ */
3745
+ declare function updateSessionEntryStatus(projectPath: string, sessionSlug: string, section: SessionSectionName, entryId: string, newStatus: SessionEntry['status']): Promise<Result<SessionEntry, Error>>;
3746
+
3747
+ /**
3748
+ * Archives a session by moving its directory to
3749
+ * `.harness/archive/sessions/<slug>-<date>`.
3750
+ *
3751
+ * The original session directory is removed. If an archive with the same
3752
+ * date already exists, a numeric counter is appended.
3753
+ */
3754
+ declare function archiveSession(projectPath: string, sessionSlug: string): Promise<Result<void, Error>>;
3755
+
3720
3756
  type StepExecutor = (step: WorkflowStep, previousArtifact?: string) => Promise<WorkflowStepResult>;
3721
3757
  declare function executeWorkflow(workflow: Workflow, executor: StepExecutor): Promise<WorkflowResult>;
3722
3758
 
@@ -3971,6 +4007,22 @@ interface MechanicalCheckOptions {
3971
4007
  /** Only scan these files for security (e.g., changed files from a PR) */
3972
4008
  changedFiles?: string[];
3973
4009
  }
4010
+ /**
4011
+ * Report on evidence coverage across review findings.
4012
+ * Produced by the evidence gate and included in review output.
4013
+ */
4014
+ interface EvidenceCoverageReport {
4015
+ /** Total evidence entries loaded from session state */
4016
+ totalEntries: number;
4017
+ /** Number of findings that have matching evidence entries */
4018
+ findingsWithEvidence: number;
4019
+ /** Number of findings without matching evidence (flagged [UNVERIFIED]) */
4020
+ uncitedCount: number;
4021
+ /** Titles of uncited findings (for reporting) */
4022
+ uncitedFindings: string[];
4023
+ /** Coverage percentage (findingsWithEvidence / total findings * 100) */
4024
+ coveragePercentage: number;
4025
+ }
3974
4026
 
3975
4027
  /**
3976
4028
  * Change type detected from commit message prefix or diff heuristic.
@@ -4194,6 +4246,8 @@ interface ReviewOutputOptions {
4194
4246
  prNumber?: number;
4195
4247
  /** Repository in owner/repo format (required for GitHub comments) */
4196
4248
  repo?: string;
4249
+ /** Evidence coverage report to append to output (optional) */
4250
+ evidenceCoverage?: EvidenceCoverageReport;
4197
4251
  }
4198
4252
  /**
4199
4253
  * A formatted GitHub inline comment ready for posting.
@@ -4333,6 +4387,8 @@ interface PipelineContext {
4333
4387
  checkDepsOutput?: string;
4334
4388
  /** Repository in owner/repo format (for --comment) */
4335
4389
  repo?: string;
4390
+ /** Session slug for evidence checking (optional) */
4391
+ sessionSlug?: string;
4336
4392
  /** Whether the pipeline was skipped by the gate */
4337
4393
  skipped: boolean;
4338
4394
  /** Reason for skipping (when skipped is true) */
@@ -4359,6 +4415,8 @@ interface PipelineContext {
4359
4415
  githubComments?: GitHubInlineComment[];
4360
4416
  /** Process exit code (0 = approve/comment, 1 = request-changes) */
4361
4417
  exitCode: number;
4418
+ /** Evidence coverage report (when session evidence is available) */
4419
+ evidenceCoverage?: EvidenceCoverageReport;
4362
4420
  }
4363
4421
  /**
4364
4422
  * Immutable result returned from `runPipeline()`.
@@ -4384,6 +4442,8 @@ interface ReviewPipelineResult {
4384
4442
  exitCode: number;
4385
4443
  /** Mechanical check result (for reporting) */
4386
4444
  mechanicalResult?: MechanicalCheckResult;
4445
+ /** Evidence coverage report (when session evidence is available) */
4446
+ evidenceCoverage?: EvidenceCoverageReport;
4387
4447
  }
4388
4448
 
4389
4449
  /**
@@ -4419,15 +4479,6 @@ declare function scopeContext(options: ContextScopeOptions): Promise<ContextBund
4419
4479
  * Descriptor for the compliance review agent.
4420
4480
  */
4421
4481
  declare const COMPLIANCE_DESCRIPTOR: ReviewAgentDescriptor;
4422
- /**
4423
- * Run the compliance review agent.
4424
- *
4425
- * Analyzes the context bundle for convention adherence, spec alignment,
4426
- * and documentation completeness. Produces ReviewFinding[] with domain 'compliance'.
4427
- *
4428
- * This function performs static/heuristic analysis. The actual LLM invocation
4429
- * for deeper compliance review happens at the orchestration layer (MCP/CLI).
4430
- */
4431
4482
  declare function runComplianceAgent(bundle: ContextBundle): ReviewFinding[];
4432
4483
 
4433
4484
  declare const BUG_DETECTION_DESCRIPTOR: ReviewAgentDescriptor;
@@ -4581,6 +4632,7 @@ declare function formatFindingBlock(finding: ReviewFinding): string;
4581
4632
  declare function formatTerminalOutput(options: {
4582
4633
  findings: ReviewFinding[];
4583
4634
  strengths: ReviewStrength[];
4635
+ evidenceCoverage?: EvidenceCoverageReport;
4584
4636
  }): string;
4585
4637
 
4586
4638
  /**
@@ -4602,8 +4654,22 @@ declare function formatGitHubComment(finding: ReviewFinding): GitHubInlineCommen
4602
4654
  declare function formatGitHubSummary(options: {
4603
4655
  findings: ReviewFinding[];
4604
4656
  strengths: ReviewStrength[];
4657
+ evidenceCoverage?: EvidenceCoverageReport;
4605
4658
  }): string;
4606
4659
 
4660
+ /**
4661
+ * Check evidence coverage for a set of review findings against session evidence entries.
4662
+ *
4663
+ * For each finding, checks whether any active evidence entry references the same
4664
+ * file:line location. Findings without matching evidence are flagged as uncited.
4665
+ */
4666
+ declare function checkEvidenceCoverage(findings: ReviewFinding[], evidenceEntries: SessionEntry[]): EvidenceCoverageReport;
4667
+ /**
4668
+ * Tag uncited findings by prefixing their title with [UNVERIFIED].
4669
+ * Mutates the findings array in place and returns it.
4670
+ */
4671
+ declare function tagUncitedFindings(findings: ReviewFinding[], evidenceEntries: SessionEntry[]): ReviewFinding[];
4672
+
4607
4673
  /**
4608
4674
  * Options for invoking the pipeline.
4609
4675
  */
@@ -4622,6 +4688,8 @@ interface RunPipelineOptions {
4622
4688
  config?: Record<string, unknown>;
4623
4689
  /** Pre-gathered commit history entries */
4624
4690
  commitHistory?: CommitHistoryEntry[];
4691
+ /** Session slug for loading evidence entries (optional) */
4692
+ sessionSlug?: string;
4625
4693
  }
4626
4694
  /**
4627
4695
  * Run the full 7-phase code review pipeline.
@@ -4919,6 +4987,6 @@ declare function getUpdateNotification(currentVersion: string): string | null;
4919
4987
  * release. Kept only as a fallback for consumers that cannot resolve the CLI
4920
4988
  * package at runtime.
4921
4989
  */
4922
- declare const VERSION = "0.13.0";
4990
+ declare const VERSION = "0.14.0";
4923
4991
 
4924
- export { AGENT_DESCRIPTORS, ARCHITECTURE_DESCRIPTOR, type AST, type ActionContext, type ActionEvent, type ActionEventHandler, type ActionEventType, type ActionResult, type ActionSink, type ActionTracker, type ActionType, type AgentAction, AgentActionEmitter, type AgentExecutor, type AgentMapLink, type AgentMapSection, type AgentMapValidation, type AgentProcess, type AgentReviewResult, type AgentType, type AgentsMapConfig, ArchBaseline, ArchBaselineManager, ArchConfig, ArchDiffResult, ArchMetricCategory, BUG_DETECTION_DESCRIPTOR, type BaseError, type Baseline, BaselineManager, type BaselinesFile, type BenchmarkResult, type BenchmarkRunOptions, BenchmarkRunner, type BlueprintData, BlueprintGenerator, type BlueprintModule, type BlueprintOptions, type BoundaryDefinition, type BoundaryValidation, type BoundaryValidator, type BoundaryViolation, type BrokenLink, type BudgetedLearningsOptions, type Bundle, type BundleConstraints, BundleConstraintsSchema, BundleSchema, COMPLIANCE_DESCRIPTOR, type ChangeType, type ChangedFile, ChecklistBuilder, type CircularDependency, CircularDepsCollector, type CircularDepsResult, type CleanupFinding, type CodeBlock, type CodeChanges, type CodePattern, type CodeReference, type CodebaseSnapshot, Collector, type CommentedCodeBlock, type CommitFormat, type CommitHistoryEntry, type CommitValidation, ComplexityCollector, type ComplexityConfig, type ComplexityReport, type ComplexityThresholds, type ComplexityViolation, type ConfigError, type ConfigPattern, type Confirmation, ConfirmationSchema, type ConflictReport, ConsoleSink, type ConstraintError, type ConstraintNodeStore, ConstraintRule, type Content, ContentPipeline, type ContextBundle, type ContextError, type ContextFile, type ContextFilterResult, type ContextScopeOptions, type Contributions, ContributionsSchema, type Convention, CouplingCollector, type CouplingConfig, type CouplingReport, type CouplingThresholds, type CouplingViolation, type CoverageOptions, type CoverageReport, type CriticalPathEntry, CriticalPathResolver, type CriticalPathSet, type CustomRule, type CustomRuleResult, DEFAULT_PROVIDER_TIERS, DEFAULT_SECURITY_CONFIG, DEFAULT_STATE, DEFAULT_STREAM_INDEX, type DeadCodeConfig, type DeadCodeReport, type DeadExport, type DeadFile, type DeadInternal, type DeduplicateFindingsOptions, DepDepthCollector, type DependencyEdge, type DependencyGraph, type DependencyValidation, type DependencyViolation, type DetectStaleResult, type DiffInfo, type DocumentationDrift, type DocumentationFile, type DocumentationGap, type DriftConfig, type DriftReport, type EligibilityResult, type EmitInteractionInput, EmitInteractionInputSchema, EntropyAnalyzer, type EntropyConfig, EntropyConfigSchema, type EntropyError, type EntropyReport, ExclusionSet, type ExecutorHealth, type Export, type ExportMap, type FailureEntry, FailureEntrySchema, type FanOutOptions, type FeedbackAgentConfig, type FeedbackConfig, type FeedbackError$1 as FeedbackError, type FileCategory, FileSink, type FindingSeverity, type Fix, type FixConfig, type FixResult, type FixType, ForbiddenImportCollector, type ForbiddenImportViolation, type ForbiddenPattern, type GateConfig, GateConfigSchema, type GateResult, GateResultSchema, type GenerationSection, type GitHubInlineComment, type GraphAdapter, type GraphComplexityData, type GraphCouplingData, type GraphCoverageData, type GraphCriticalPathData, type GraphDependencyData, type GraphHarnessCheckData, type GraphImpactData, type Handoff, HandoffSchema, type HarnessState, HarnessStateSchema, type HealthCheckResult, type Hotspot, type HotspotContext, type Import, type InlineReference, type IntegrityReport, type InteractionType, InteractionTypeSchema, type InternalSymbol, type JSDocComment, type LanguageParser, type Layer, type LayerConfig, LayerViolationCollector, type LearningPattern, type Lockfile, type LockfilePackage, LockfilePackageSchema, LockfileSchema, type LogEntry, type LogFilter, type Manifest, ManifestSchema, type MechanicalCheckOptions, type MechanicalCheckResult, type MechanicalCheckStatus, type MechanicalFinding, type MergeResult, type Metric, MetricResult, type ModelProvider, type ModelTier, type ModelTierConfig, type ModuleDependency, ModuleSizeCollector, NoOpExecutor, NoOpSink, NoOpTelemetryAdapter, type OrphanedDep, type ParseError, type PatternConfig, PatternConfigSchema, type PatternMatch, type PatternReport, type PatternViolation, type PeerReview, type PeerReviewOptions, type PipelineContext, type PipelineFlags, type PipelineOptions, type PipelineResult, type PrMetadata, type PriorReview, ProjectScanner, type ProviderDefaults, type PruneResult, type Question, QuestionSchema, REQUIRED_SECTIONS, type ReachabilityNode, RegressionDetector, type RegressionReport, type RegressionResult, type ReviewAgentDescriptor, type ReviewAssessment, type ReviewChecklist, type ReviewComment, type ReviewContext, type ReviewDomain, type ReviewFinding, type ReviewItem, type ReviewOutputOptions, type ReviewPipelineResult, type ReviewStrength, type RuleOverride, RuleRegistry, type RunCIChecksInput, type RunPipelineOptions, SECURITY_DESCRIPTOR, type SafetyLevel, type ScanResult, type SecurityCategory, type SecurityConfidence, type SecurityConfig, SecurityConfigSchema, type SecurityFinding, type SecurityRule, SecurityScanner, type SecuritySeverity, type SelfReviewConfig, type SessionSummaryData, SharableBoundaryConfigSchema, SharableForbiddenImportSchema, SharableLayerSchema, SharableSecurityRulesSchema, type SizeBudgetConfig, type SizeBudgetReport, type SizeBudgetViolation, type SkillExecutor, type SourceFile, type Span, type SpanEvent, type StaleConstraint, type StepExecutor, type StreamIndex, StreamIndexSchema, type StreamInfo, StreamInfoSchema, type StructureValidation, type Suggestion, type SuggestionReport, type SyncChange, type SyncOptions, type TelemetryAdapter, type TelemetryHealth, ThresholdConfig, type TimeRange, type TokenBudget, type TokenBudgetOverrides, type Trace, type Transition, TransitionSchema, type TurnExecutor, TypeScriptParser, type UnusedImport, type UpdateCheckState, VERSION, type ValidateFindingsOptions, type ValidationError, type WorkflowPhase, addProvenance, analyzeDiff, analyzeLearningPatterns, appendFailure, appendLearning, applyFixes, applyHotspotDowngrade, archiveFailures, archiveLearnings, archiveStream, buildDependencyGraph, buildExclusionSet, buildSnapshot, checkDocCoverage, checkEligibility, classifyFinding, clearFailuresCache, clearLearningsCache, configureFeedback, constraintRuleId, contextBudget, contextFilter, createBoundaryValidator, createCommentedCodeFixes, createError, createFixes, createForbiddenImportFixes, createOrphanedDepFixes, createParseError, createSelfReview, createStream, cryptoRules, deduplicateCleanupFindings, deduplicateFindings, deepMergeConstraints, defaultCollectors, defineLayer, deserializationRules, detectChangeType, detectCircularDeps, detectCircularDepsInFiles, detectComplexityViolations, detectCouplingViolations, detectDeadCode, detectDocDrift, detectPatternViolations, detectSizeBudgetViolations, detectStack, detectStaleConstraints, determineAssessment, diff, executeWorkflow, expressRules, extractBundle, extractMarkdownLinks, extractSections, fanOutReview, formatFindingBlock, formatGitHubComment, formatGitHubSummary, formatTerminalOutput, generateAgentsMap, generateSuggestions, getActionEmitter, getExitCode, getFeedbackConfig, getPhaseCategories, getStreamForBranch, getUpdateNotification, goRules, injectionRules, isSmallSuggestion, isUpdateCheckEnabled, listActiveSessions, listStreams, loadBudgetedLearnings, loadFailures, loadHandoff, loadRelevantLearnings, loadSessionSummary, loadState, loadStreamIndex, logAgentAction, migrateToStreams, networkRules, nodeRules, parseDateFromEntry, parseDiff, parseManifest, parseRoadmap, parseSecurityConfig, parseSize, pathTraversalRules, previewFix, pruneLearnings, reactRules, readCheckState, readLockfile, removeContributions, removeProvenance, requestMultiplePeerReviews, requestPeerReview, resetFeedbackConfig, resolveFileToLayer, resolveModelTier, resolveRuleSeverity, resolveSessionDir, resolveStreamPath, resolveThresholds, runAll, runArchitectureAgent, runBugDetectionAgent, runCIChecks, runComplianceAgent, runMechanicalChecks, runMechanicalGate, runMultiTurnPipeline, runPipeline, runReviewPipeline, runSecurityAgent, saveHandoff, saveState, saveStreamIndex, scopeContext, secretRules, serializeRoadmap, setActiveStream, shouldRunCheck, spawnBackgroundCheck, syncConstraintNodes, syncRoadmap, touchStream, trackAction, updateSessionIndex, validateAgentsMap, validateBoundaries, validateCommitMessage, validateConfig, validateDependencies, validateFileStructure, validateFindings, validateKnowledgeMap, validatePatternConfig, violationId, writeConfig, writeLockfile, writeSessionSummary, xssRules };
4992
+ export { AGENT_DESCRIPTORS, ARCHITECTURE_DESCRIPTOR, type AST, type ActionContext, type ActionEvent, type ActionEventHandler, type ActionEventType, type ActionResult, type ActionSink, type ActionTracker, type ActionType, type AgentAction, AgentActionEmitter, type AgentExecutor, type AgentMapLink, type AgentMapSection, type AgentMapValidation, type AgentProcess, type AgentReviewResult, type AgentType, type AgentsMapConfig, ArchBaseline, ArchBaselineManager, ArchConfig, ArchDiffResult, ArchMetricCategory, BUG_DETECTION_DESCRIPTOR, type BaseError, type Baseline, BaselineManager, type BaselinesFile, type BenchmarkResult, type BenchmarkRunOptions, BenchmarkRunner, type BlueprintData, BlueprintGenerator, type BlueprintModule, type BlueprintOptions, type BoundaryDefinition, type BoundaryValidation, type BoundaryValidator, type BoundaryViolation, type BrokenLink, type BudgetedLearningsOptions, type Bundle, type BundleConstraints, BundleConstraintsSchema, BundleSchema, COMPLIANCE_DESCRIPTOR, type ChangeType, type ChangedFile, ChecklistBuilder, type CircularDependency, CircularDepsCollector, type CircularDepsResult, type CleanupFinding, type CodeBlock, type CodeChanges, type CodePattern, type CodeReference, type CodebaseSnapshot, Collector, type CommentedCodeBlock, type CommitFormat, type CommitHistoryEntry, type CommitValidation, ComplexityCollector, type ComplexityConfig, type ComplexityReport, type ComplexityThresholds, type ComplexityViolation, type ConfigError, type ConfigPattern, type Confirmation, ConfirmationSchema, type ConflictReport, ConsoleSink, type ConstraintError, type ConstraintNodeStore, ConstraintRule, type Content, ContentPipeline, type ContextBundle, type ContextError, type ContextFile, type ContextFilterResult, type ContextScopeOptions, type Contributions, ContributionsSchema, type Convention, CouplingCollector, type CouplingConfig, type CouplingReport, type CouplingThresholds, type CouplingViolation, type CoverageOptions, type CoverageReport, type CriticalPathEntry, CriticalPathResolver, type CriticalPathSet, type CustomRule, type CustomRuleResult, DEFAULT_PROVIDER_TIERS, DEFAULT_SECURITY_CONFIG, DEFAULT_STATE, DEFAULT_STREAM_INDEX, type DeadCodeConfig, type DeadCodeReport, type DeadExport, type DeadFile, type DeadInternal, type DeduplicateFindingsOptions, DepDepthCollector, type DependencyEdge, type DependencyGraph, type DependencyValidation, type DependencyViolation, type DetectStaleResult, type DiffInfo, type DocumentationDrift, type DocumentationFile, type DocumentationGap, type DriftConfig, type DriftReport, type EligibilityResult, type EmitInteractionInput, EmitInteractionInputSchema, EntropyAnalyzer, type EntropyConfig, EntropyConfigSchema, type EntropyError, type EntropyReport, type EvidenceCoverageReport, ExclusionSet, type ExecutorHealth, type Export, type ExportMap, type FailureEntry, FailureEntrySchema, type FanOutOptions, type FeedbackAgentConfig, type FeedbackConfig, type FeedbackError$1 as FeedbackError, type FileCategory, FileSink, type FindingSeverity, type Fix, type FixConfig, type FixResult, type FixType, ForbiddenImportCollector, type ForbiddenImportViolation, type ForbiddenPattern, type GateConfig, GateConfigSchema, type GateResult, GateResultSchema, type GenerationSection, type GitHubInlineComment, type GraphAdapter, type GraphComplexityData, type GraphCouplingData, type GraphCoverageData, type GraphCriticalPathData, type GraphDependencyData, type GraphHarnessCheckData, type GraphImpactData, type Handoff, HandoffSchema, type HarnessState, HarnessStateSchema, type HealthCheckResult, type Hotspot, type HotspotContext, type Import, type InlineReference, type IntegrityReport, type InteractionType, InteractionTypeSchema, type InternalSymbol, type JSDocComment, type LanguageParser, type Layer, type LayerConfig, LayerViolationCollector, type LearningPattern, type Lockfile, type LockfilePackage, LockfilePackageSchema, LockfileSchema, type LogEntry, type LogFilter, type Manifest, ManifestSchema, type MechanicalCheckOptions, type MechanicalCheckResult, type MechanicalCheckStatus, type MechanicalFinding, type MergeResult, type Metric, MetricResult, type ModelProvider, type ModelTier, type ModelTierConfig, type ModuleDependency, ModuleSizeCollector, NoOpExecutor, NoOpSink, NoOpTelemetryAdapter, type OrphanedDep, type ParseError, type PatternConfig, PatternConfigSchema, type PatternMatch, type PatternReport, type PatternViolation, type PeerReview, type PeerReviewOptions, type PipelineContext, type PipelineFlags, type PipelineOptions, type PipelineResult, type PrMetadata, type PriorReview, ProjectScanner, type ProviderDefaults, type PruneResult, type Question, QuestionSchema, REQUIRED_SECTIONS, type ReachabilityNode, RegressionDetector, type RegressionReport, type RegressionResult, type ReviewAgentDescriptor, type ReviewAssessment, type ReviewChecklist, type ReviewComment, type ReviewContext, type ReviewDomain, type ReviewFinding, type ReviewItem, type ReviewOutputOptions, type ReviewPipelineResult, type ReviewStrength, type RuleOverride, RuleRegistry, type RunCIChecksInput, type RunPipelineOptions, SECURITY_DESCRIPTOR, type SafetyLevel, type ScanResult, type SecurityCategory, type SecurityConfidence, type SecurityConfig, SecurityConfigSchema, type SecurityFinding, type SecurityRule, SecurityScanner, type SecuritySeverity, type SelfReviewConfig, type SessionSummaryData, SharableBoundaryConfigSchema, SharableForbiddenImportSchema, SharableLayerSchema, SharableSecurityRulesSchema, type SizeBudgetConfig, type SizeBudgetReport, type SizeBudgetViolation, type SkillExecutor, type SourceFile, type Span, type SpanEvent, type StaleConstraint, type StepExecutor, type StreamIndex, StreamIndexSchema, type StreamInfo, StreamInfoSchema, type StructureValidation, type Suggestion, type SuggestionReport, type SyncChange, type SyncOptions, type TelemetryAdapter, type TelemetryHealth, ThresholdConfig, type TimeRange, type TokenBudget, type TokenBudgetOverrides, type Trace, type Transition, TransitionSchema, type TurnExecutor, TypeScriptParser, type UnusedImport, type UpdateCheckState, VERSION, type ValidateFindingsOptions, type ValidationError, type WorkflowPhase, addProvenance, analyzeDiff, analyzeLearningPatterns, appendFailure, appendLearning, appendSessionEntry, applyFixes, applyHotspotDowngrade, archiveFailures, archiveLearnings, archiveSession, archiveStream, buildDependencyGraph, buildExclusionSet, buildSnapshot, checkDocCoverage, checkEligibility, checkEvidenceCoverage, classifyFinding, clearFailuresCache, clearLearningsCache, configureFeedback, constraintRuleId, contextBudget, contextFilter, createBoundaryValidator, createCommentedCodeFixes, createError, createFixes, createForbiddenImportFixes, createOrphanedDepFixes, createParseError, createSelfReview, createStream, cryptoRules, deduplicateCleanupFindings, deduplicateFindings, deepMergeConstraints, defaultCollectors, defineLayer, deserializationRules, detectChangeType, detectCircularDeps, detectCircularDepsInFiles, detectComplexityViolations, detectCouplingViolations, detectDeadCode, detectDocDrift, detectPatternViolations, detectSizeBudgetViolations, detectStack, detectStaleConstraints, determineAssessment, diff, executeWorkflow, expressRules, extractBundle, extractMarkdownLinks, extractSections, fanOutReview, formatFindingBlock, formatGitHubComment, formatGitHubSummary, formatTerminalOutput, generateAgentsMap, generateSuggestions, getActionEmitter, getExitCode, getFeedbackConfig, getPhaseCategories, getStreamForBranch, getUpdateNotification, goRules, injectionRules, isSmallSuggestion, isUpdateCheckEnabled, listActiveSessions, listStreams, loadBudgetedLearnings, loadFailures, loadHandoff, loadRelevantLearnings, loadSessionSummary, loadState, loadStreamIndex, logAgentAction, migrateToStreams, networkRules, nodeRules, parseDateFromEntry, parseDiff, parseManifest, parseRoadmap, parseSecurityConfig, parseSize, pathTraversalRules, previewFix, pruneLearnings, reactRules, readCheckState, readLockfile, readSessionSection, readSessionSections, removeContributions, removeProvenance, requestMultiplePeerReviews, requestPeerReview, resetFeedbackConfig, resolveFileToLayer, resolveModelTier, resolveRuleSeverity, resolveSessionDir, resolveStreamPath, resolveThresholds, runAll, runArchitectureAgent, runBugDetectionAgent, runCIChecks, runComplianceAgent, runMechanicalChecks, runMechanicalGate, runMultiTurnPipeline, runPipeline, runReviewPipeline, runSecurityAgent, saveHandoff, saveState, saveStreamIndex, scopeContext, secretRules, serializeRoadmap, setActiveStream, shouldRunCheck, spawnBackgroundCheck, syncConstraintNodes, syncRoadmap, tagUncitedFindings, touchStream, trackAction, updateSessionEntryStatus, updateSessionIndex, validateAgentsMap, validateBoundaries, validateCommitMessage, validateConfig, validateDependencies, validateFileStructure, validateFindings, validateKnowledgeMap, validatePatternConfig, violationId, writeConfig, writeLockfile, writeSessionSummary, xssRules };