npm - @harness-engineering/core - Versions diffs - 0.25.0 → 0.26.0 - Mend

@harness-engineering/core 0.25.0 → 0.26.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.

Files changed (5) hide show

package/dist/index.d.mts CHANGED Viewed

@@ -477,6 +477,38 @@ interface RoadmapModeValidationConfig extends RoadmapModeConfig {
  */
 declare function validateRoadmapMode(config: RoadmapModeValidationConfig, projectRoot: string): Result<void, ConfigError>;
+interface BranchingConfig {
+    /** Allowed branch name prefixes */
+    prefixes: string[];
+    /** Whether to enforce kebab-case for the branch slug */
+    enforceKebabCase: boolean;
+    /**
+     * Optional regex that fully replaces the default prefix and kebab-case checks.
+     * When set, only the ignore list and this regex are evaluated -- the `prefixes`,
+     * `enforceKebabCase`, and `maxLength` settings are bypassed. Use for projects
+     * whose convention does not fit the prefix/slug model.
+     */
+    customRegex?: string | undefined;
+    /** List of ignored branch names (exact match or glob) */
+    ignore: string[];
+    /** Maximum slug length (everything after the first `/`). Omit or set 0 to disable. */
+    maxLength?: number | undefined;
+}
+interface BranchValidationResult {
+    valid: boolean;
+    branchName: string;
+    message?: string;
+    suggestion?: string;
+}
+/**
+ * Validates a branch name against the provided configuration.
+ *
+ * @param branchName - The name of the branch to validate.
+ * @param config - The branching configuration.
+ * @returns A BranchValidationResult.
+ */
+declare function validateBranchName(branchName: string, config: BranchingConfig): BranchValidationResult;
 interface AgentMapLink {
     text: string;
     path: string;
@@ -9692,4 +9724,4 @@ declare function assembleCandidateReport(input: AssembleInput): string;
 declare const VERSION = "0.23.3";
-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 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, 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, 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 };

package/dist/index.d.ts CHANGED Viewed

@@ -477,6 +477,38 @@ interface RoadmapModeValidationConfig extends RoadmapModeConfig {
  */
 declare function validateRoadmapMode(config: RoadmapModeValidationConfig, projectRoot: string): Result<void, ConfigError>;
+interface BranchingConfig {
+    /** Allowed branch name prefixes */
+    prefixes: string[];
+    /** Whether to enforce kebab-case for the branch slug */
+    enforceKebabCase: boolean;
+    /**
+     * Optional regex that fully replaces the default prefix and kebab-case checks.
+     * When set, only the ignore list and this regex are evaluated -- the `prefixes`,
+     * `enforceKebabCase`, and `maxLength` settings are bypassed. Use for projects
+     * whose convention does not fit the prefix/slug model.
+     */
+    customRegex?: string | undefined;
+    /** List of ignored branch names (exact match or glob) */
+    ignore: string[];
+    /** Maximum slug length (everything after the first `/`). Omit or set 0 to disable. */
+    maxLength?: number | undefined;
+}
+interface BranchValidationResult {
+    valid: boolean;
+    branchName: string;
+    message?: string;
+    suggestion?: string;
+}
+/**
+ * Validates a branch name against the provided configuration.
+ *
+ * @param branchName - The name of the branch to validate.
+ * @param config - The branching configuration.
+ * @returns A BranchValidationResult.
+ */
+declare function validateBranchName(branchName: string, config: BranchingConfig): BranchValidationResult;
 interface AgentMapLink {
     text: string;
     path: string;
@@ -9692,4 +9724,4 @@ declare function assembleCandidateReport(input: AssembleInput): string;
 declare const VERSION = "0.23.3";
-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 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, 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, 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 };

package/dist/index.js CHANGED Viewed

@@ -459,6 +459,7 @@ __export(index_exports, {
   validateAgentConfigs: () => validateAgentConfigs,
   validateAgentsMap: () => validateAgentsMap,
   validateBoundaries: () => validateBoundaries,
+  validateBranchName: () => validateBranchName,
   validateCommitMessage: () => validateCommitMessage,
   validateConfig: () => validateConfig,
   validateDependencies: () => validateDependencies,
@@ -3058,8 +3059,82 @@ function validateRoadmapMode(config, projectRoot) {
   return (0, import_types.Ok)(void 0);
 }
-// src/context/doc-coverage.ts
+// src/validation/branch.ts
 var import_minimatch = require("minimatch");
+var KEBAB_CASE = /^[a-z0-9]+(-[a-z0-9]+)*$/;
+var TICKET_ID = /^([A-Z0-9]+-[0-9]+)-(.*)$/;
+function validateBranchName(branchName, config) {
+  for (const pattern of config.ignore) {
+    if ((0, import_minimatch.minimatch)(branchName, pattern)) {
+      return { valid: true, branchName };
+    }
+  }
+  if (config.customRegex) {
+    const regex = new RegExp(config.customRegex);
+    if (!regex.test(branchName)) {
+      return {
+        valid: false,
+        branchName,
+        message: `Branch name "${branchName}" does not match the custom regex: ${config.customRegex}`
+      };
+    }
+    return { valid: true, branchName };
+  }
+  const parts = branchName.split("/");
+  if (parts.length < 2) {
+    return {
+      valid: false,
+      branchName,
+      message: `Branch name "${branchName}" must have a prefix followed by a slash (e.g., "feat/my-feature").`,
+      suggestion: `Try renaming to "feat/${branchName}" or "fix/${branchName}".`
+    };
+  }
+  const prefix = parts[0];
+  const slug = parts.slice(1).join("/");
+  if (!config.prefixes.includes(prefix)) {
+    return {
+      valid: false,
+      branchName,
+      message: `Prefix "${prefix}" is not allowed.`,
+      suggestion: `Allowed prefixes: ${config.prefixes.join(", ")}.`
+    };
+  }
+  if (config.enforceKebabCase) {
+    for (const part of slug.split("/")) {
+      const ticketMatch = part.match(TICKET_ID);
+      if (ticketMatch) {
+        const rest = ticketMatch[2];
+        if (rest && !KEBAB_CASE.test(rest)) {
+          return {
+            valid: false,
+            branchName,
+            message: `Branch slug part "${part}" does not follow kebab-case after the ticket ID.`,
+            suggestion: `Ensure the description after "${ticketMatch[1]}" uses kebab-case (lowercase, single hyphens, no leading/trailing hyphen).`
+          };
+        }
+      } else if (!KEBAB_CASE.test(part)) {
+        return {
+          valid: false,
+          branchName,
+          message: `Branch slug part "${part}" must be in kebab-case (lowercase, single hyphens, no leading/trailing hyphen).`,
+          suggestion: `Change "${part}" to match the convention.`
+        };
+      }
+    }
+  }
+  if (typeof config.maxLength === "number" && config.maxLength > 0 && slug.length > config.maxLength) {
+    return {
+      valid: false,
+      branchName,
+      message: `Branch slug is ${slug.length} characters; max allowed is ${config.maxLength}.`,
+      suggestion: `Shorten the description after "${prefix}/" to ${config.maxLength} characters or fewer.`
+    };
+  }
+  return { valid: true, branchName };
+}
+// src/context/doc-coverage.ts
+var import_minimatch2 = require("minimatch");
 var import_path2 = require("path");
 function determineImportance(filePath) {
   const name = (0, import_path2.basename)(filePath).toLowerCase();
@@ -3102,7 +3177,7 @@ async function checkDocCoverage(domain, options = {}) {
     const filteredSourceFiles = sourceFiles.filter((file) => {
       const relativePath = relativePosix(sourceDir, file);
       return !excludePatterns.some((pattern) => {
-        return (0, import_minimatch.minimatch)(relativePath, pattern, { dot: true }) || (0, import_minimatch.minimatch)(file, pattern, { dot: true });
+        return (0, import_minimatch2.minimatch)(relativePath, pattern, { dot: true }) || (0, import_minimatch2.minimatch)(file, pattern, { dot: true });
       });
     });
     const docFiles = await findFiles("**/*.md", docsDir);
@@ -3636,7 +3711,7 @@ function getPhaseCategories(phase) {
 }
 // src/constraints/layers.ts
-var import_minimatch2 = require("minimatch");
+var import_minimatch3 = require("minimatch");
 function defineLayer(name, patterns, allowedDependencies) {
   return {
     name,
@@ -3647,7 +3722,7 @@ function defineLayer(name, patterns, allowedDependencies) {
 function resolveFileToLayer(file, layers) {
   for (const layer of layers) {
     for (const pattern of layer.patterns) {
-      if ((0, import_minimatch2.minimatch)(file, pattern)) {
+      if ((0, import_minimatch3.minimatch)(file, pattern)) {
         return layer;
       }
     }
@@ -4668,7 +4743,7 @@ function parseProtectedRegions(files) {
 // src/entropy/snapshot.ts
 var import_graph = require("@harness-engineering/graph");
 var import_path7 = require("path");
-var import_minimatch3 = require("minimatch");
+var import_minimatch4 = require("minimatch");
 // src/entropy/entry-points.ts
 var import_path6 = require("path");
@@ -5122,7 +5197,7 @@ async function buildSnapshot(config) {
   }
   sourceFilePaths = sourceFilePaths.filter((f) => {
     const rel = relativePosix(rootDir, f);
-    return !excludePatterns.some((p) => (0, import_minimatch3.minimatch)(rel, p));
+    return !excludePatterns.some((p) => (0, import_minimatch4.minimatch)(rel, p));
   });
   const files = [];
   for (const filePath of sourceFilePaths) {
@@ -5734,10 +5809,10 @@ async function detectDeadCode(snapshot, graphDeadCodeData, protectedRegions) {
 }
 // src/entropy/detectors/patterns.ts
-var import_minimatch4 = require("minimatch");
+var import_minimatch5 = require("minimatch");
 function fileMatchesPattern(filePath, pattern, rootDir) {
   const relativePath = relativePosix(rootDir, filePath);
-  return (0, import_minimatch4.minimatch)(relativePath, pattern);
+  return (0, import_minimatch5.minimatch)(relativePath, pattern);
 }
 var CONVENTION_DESCRIPTIONS = {
   camelCase: "camelCase (e.g., myFunction)",
@@ -13064,7 +13139,7 @@ async function runMultiTurnPipeline(initialContext, turnExecutor, options) {
 // src/security/scanner.ts
 var fs28 = __toESM(require("fs/promises"));
-var import_minimatch5 = require("minimatch");
+var import_minimatch6 = require("minimatch");
 // src/security/rules/registry.ts
 var RuleRegistry = class {
@@ -14024,7 +14099,7 @@ var SecurityScanner = class {
     const applicableRules = this.activeRules.filter((rule) => {
       if (!rule.fileGlob) return true;
       const globs = rule.fileGlob.split(",").map((g) => g.trim());
-      return globs.some((glob6) => (0, import_minimatch5.minimatch)(filePath, glob6, { dot: true }));
+      return globs.some((glob6) => (0, import_minimatch6.minimatch)(filePath, glob6, { dot: true }));
     });
     return this.scanLinesWithRules(lines, applicableRules, filePath, startLine);
   }
@@ -22539,6 +22614,7 @@ function assembleCandidateReport(input) {
   validateAgentConfigs,
   validateAgentsMap,
   validateBoundaries,
+  validateBranchName,
   validateCommitMessage,
   validateConfig,
   validateDependencies,

package/dist/index.mjs CHANGED Viewed

@@ -1713,8 +1713,82 @@ function validateRoadmapMode(config, projectRoot) {
   return Ok(void 0);
 }
-// src/context/doc-coverage.ts
+// src/validation/branch.ts
 import { minimatch } from "minimatch";
+var KEBAB_CASE = /^[a-z0-9]+(-[a-z0-9]+)*$/;
+var TICKET_ID = /^([A-Z0-9]+-[0-9]+)-(.*)$/;
+function validateBranchName(branchName, config) {
+  for (const pattern of config.ignore) {
+    if (minimatch(branchName, pattern)) {
+      return { valid: true, branchName };
+    }
+  }
+  if (config.customRegex) {
+    const regex = new RegExp(config.customRegex);
+    if (!regex.test(branchName)) {
+      return {
+        valid: false,
+        branchName,
+        message: `Branch name "${branchName}" does not match the custom regex: ${config.customRegex}`
+      };
+    }
+    return { valid: true, branchName };
+  }
+  const parts = branchName.split("/");
+  if (parts.length < 2) {
+    return {
+      valid: false,
+      branchName,
+      message: `Branch name "${branchName}" must have a prefix followed by a slash (e.g., "feat/my-feature").`,
+      suggestion: `Try renaming to "feat/${branchName}" or "fix/${branchName}".`
+    };
+  }
+  const prefix = parts[0];
+  const slug = parts.slice(1).join("/");
+  if (!config.prefixes.includes(prefix)) {
+    return {
+      valid: false,
+      branchName,
+      message: `Prefix "${prefix}" is not allowed.`,
+      suggestion: `Allowed prefixes: ${config.prefixes.join(", ")}.`
+    };
+  }
+  if (config.enforceKebabCase) {
+    for (const part of slug.split("/")) {
+      const ticketMatch = part.match(TICKET_ID);
+      if (ticketMatch) {
+        const rest = ticketMatch[2];
+        if (rest && !KEBAB_CASE.test(rest)) {
+          return {
+            valid: false,
+            branchName,
+            message: `Branch slug part "${part}" does not follow kebab-case after the ticket ID.`,
+            suggestion: `Ensure the description after "${ticketMatch[1]}" uses kebab-case (lowercase, single hyphens, no leading/trailing hyphen).`
+          };
+        }
+      } else if (!KEBAB_CASE.test(part)) {
+        return {
+          valid: false,
+          branchName,
+          message: `Branch slug part "${part}" must be in kebab-case (lowercase, single hyphens, no leading/trailing hyphen).`,
+          suggestion: `Change "${part}" to match the convention.`
+        };
+      }
+    }
+  }
+  if (typeof config.maxLength === "number" && config.maxLength > 0 && slug.length > config.maxLength) {
+    return {
+      valid: false,
+      branchName,
+      message: `Branch slug is ${slug.length} characters; max allowed is ${config.maxLength}.`,
+      suggestion: `Shorten the description after "${prefix}/" to ${config.maxLength} characters or fewer.`
+    };
+  }
+  return { valid: true, branchName };
+}
+// src/context/doc-coverage.ts
+import { minimatch as minimatch2 } from "minimatch";
 import { basename as basename2 } from "path";
 function determineImportance(filePath) {
   const name = basename2(filePath).toLowerCase();
@@ -1757,7 +1831,7 @@ async function checkDocCoverage(domain, options = {}) {
     const filteredSourceFiles = sourceFiles.filter((file) => {
       const relativePath = relativePosix(sourceDir, file);
       return !excludePatterns.some((pattern) => {
-        return minimatch(relativePath, pattern, { dot: true }) || minimatch(file, pattern, { dot: true });
+        return minimatch2(relativePath, pattern, { dot: true }) || minimatch2(file, pattern, { dot: true });
       });
     });
     const docFiles = await findFiles("**/*.md", docsDir);
@@ -3012,7 +3086,7 @@ function parseProtectedRegions(files) {
 // src/entropy/snapshot.ts
 import { skipDirGlobs } from "@harness-engineering/graph";
 import { resolve as resolve5 } from "path";
-import { minimatch as minimatch2 } from "minimatch";
+import { minimatch as minimatch3 } from "minimatch";
 // src/entropy/entry-points.ts
 import { join as join15, resolve as resolve4 } from "path";
@@ -3466,7 +3540,7 @@ async function buildSnapshot(config) {
   }
   sourceFilePaths = sourceFilePaths.filter((f) => {
     const rel = relativePosix(rootDir, f);
-    return !excludePatterns.some((p) => minimatch2(rel, p));
+    return !excludePatterns.some((p) => minimatch3(rel, p));
   });
   const files = [];
   for (const filePath of sourceFilePaths) {
@@ -4078,10 +4152,10 @@ async function detectDeadCode(snapshot, graphDeadCodeData, protectedRegions) {
 }
 // src/entropy/detectors/patterns.ts
-import { minimatch as minimatch3 } from "minimatch";
+import { minimatch as minimatch4 } from "minimatch";
 function fileMatchesPattern(filePath, pattern, rootDir) {
   const relativePath = relativePosix(rootDir, filePath);
-  return minimatch3(relativePath, pattern);
+  return minimatch4(relativePath, pattern);
 }
 var CONVENTION_DESCRIPTIONS = {
   camelCase: "camelCase (e.g., myFunction)",
@@ -9792,7 +9866,7 @@ async function runMultiTurnPipeline(initialContext, turnExecutor, options) {
 // src/security/scanner.ts
 import * as fs28 from "fs/promises";
-import { minimatch as minimatch4 } from "minimatch";
+import { minimatch as minimatch5 } from "minimatch";
 // src/security/rules/registry.ts
 var RuleRegistry = class {
@@ -10752,7 +10826,7 @@ var SecurityScanner = class {
     const applicableRules = this.activeRules.filter((rule) => {
       if (!rule.fileGlob) return true;
       const globs = rule.fileGlob.split(",").map((g) => g.trim());
-      return globs.some((glob5) => minimatch4(filePath, glob5, { dot: true }));
+      return globs.some((glob5) => minimatch5(filePath, glob5, { dot: true }));
     });
     return this.scanLinesWithRules(lines, applicableRules, filePath, startLine);
   }
@@ -19265,6 +19339,7 @@ export {
   validateAgentConfigs,
   validateAgentsMap,
   validateBoundaries,
+  validateBranchName,
   validateCommitMessage,
   validateConfig,
   validateDependencies,

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@harness-engineering/core",
-  "version": "0.25.0",
+  "version": "0.26.0",
   "description": "Core library for Harness Engineering toolkit",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -42,7 +42,7 @@
   },
   "homepage": "https://github.com/Intense-Visions/harness-engineering/tree/main/packages/core#readme",
   "dependencies": {
-    "@typescript-eslint/typescript-estree": "^7.18.0",
+    "@typescript-eslint/typescript-estree": "^8.29.0",
     "ejs": "^3.1.10",
     "glob": "^13.0.6",
     "gray-matter": "^4.0.3",
@@ -51,8 +51,8 @@
     "web-tree-sitter": "^0.24.7",
     "yaml": "^2.8.3",
     "zod": "^3.25.76",
-    "@harness-engineering/types": "0.11.0",
-    "@harness-engineering/graph": "0.9.0"
+    "@harness-engineering/graph": "0.9.0",
+    "@harness-engineering/types": "0.11.0"
   },
   "devDependencies": {
     "@types/ejs": "^3.1.5",