@aiready/core 0.23.23 → 0.24.0

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { T as ToolName, S as ScanOptions, a as SpokeOutput, b as ToolScoringOutput, c as ToolOptions, d as Severity, A as AnalysisResult, E as ExportWithImports, F as FileImport, e as AIReadyConfig, I as Issue, M as Metrics, f as TechnicalValueChain, g as ModelContextTier, C as CostConfig, h as TokenBudget, P as ProductivityImpact, i as AcceptancePrediction, j as ComprehensionDifficulty, k as TechnicalValueChainSummary, L as Language, l as LanguageParser, m as ParseResult, N as NamingConvention, n as ExportInfo } from './index-Ctl_0z6F.mjs';
-export { o as AIReadyConfigSchema, p as ASTNode, q as AnalysisResultSchema, r as AnalysisStatus, s as AnalysisStatusSchema, B as BusinessMetrics, t as COMMON_FINE_TUNING_OPTIONS, u as CONTEXT_TIER_THRESHOLDS, v as CommonASTNode, w as Config, D as DEFAULT_TOOL_WEIGHTS, x as FRIENDLY_TOOL_NAMES, y as FileContent, G as GLOBAL_INFRA_OPTIONS, z as GLOBAL_SCAN_OPTIONS, H as GraphData, J as GraphEdge, K as GraphIssueSeverity, O as GraphMetadata, Q as GraphNode, R as IssueOverlay, U as IssueSchema, V as IssueType, W as IssueTypeSchema, X as LANGUAGE_EXTENSIONS, Y as LanguageConfig, Z as Lead, _ as LeadSchema, $ as LeadSource, a0 as LeadSourceSchema, a1 as LeadSubmission, a2 as LeadSubmissionSchema, a3 as Location, a4 as LocationSchema, a5 as ManagedAccount, a6 as ManagedAccountSchema, a7 as MetricsSchema, a8 as ModelTier, a9 as ModelTierSchema, aa as ParseError, ab as ParseStatistics, ac as ReadinessRating, ad as RecommendationPriority, ae as SCORING_PROFILES, af as SIZE_ADJUSTED_THRESHOLDS, ag as ScanResult, ah as ScoringConfig, ai as ScoringProfile, aj as ScoringResult, ak as SeveritySchema, al as SourceLocation, am as SourceRange, an as SpokeOutputSchema, ao as SpokeSummary, ap as SpokeSummarySchema, aq as TOOL_NAME_MAP, ar as ToolNameSchema, as as ToolOutput, at as UnifiedReport, au as UnifiedReportSchema, av as calculateOverallScore, aw as formatScore, ax as formatToolScore, ay as generateHTML, az as getPriorityIcon, aA as getProjectSizeTier, aB as getRating, aC as getRatingDisplay, aD as getRatingEmoji, aE as getRatingLabel, aF as getRatingMetadata, aG as getRatingSlug, aH as getRatingWithContext, aI as getRecommendedThreshold, aJ as getToolEmoji, aK as getToolWeight, aL as normalizeToolName, aM as parseWeightString } from './index-Ctl_0z6F.mjs';
+import { T as ToolName, S as ScanOptions, a as SpokeOutput, b as ToolScoringOutput, c as Severity, d as ToolOptions, A as AnalysisResult, E as ExportWithImports, F as FileImport, e as AIReadyConfig, I as Issue, M as Metrics, f as TechnicalValueChain, g as ModelContextTier, C as CostConfig, h as TokenBudget, P as ProductivityImpact, i as AcceptancePrediction, j as ComprehensionDifficulty, k as TechnicalValueChainSummary, L as Language, l as LanguageParser, m as ParseResult, N as NamingConvention, n as ExportInfo } from './index-EQ2jRSlB.mjs';
+export { o as AIReadyConfigSchema, p as ASTNode, q as AnalysisResultSchema, r as AnalysisStatus, s as AnalysisStatusSchema, B as BusinessMetrics, t as COMMON_FINE_TUNING_OPTIONS, u as CONTEXT_TIER_THRESHOLDS, v as CommonASTNode, w as Config, D as DEFAULT_TOOL_WEIGHTS, x as FRIENDLY_TOOL_NAMES, y as FileContent, G as GLOBAL_INFRA_OPTIONS, z as GLOBAL_SCAN_OPTIONS, H as GraphData, J as GraphEdge, K as GraphIssueSeverity, O as GraphMetadata, Q as GraphNode, R as IssueOverlay, U as IssueSchema, V as IssueType, W as IssueTypeSchema, X as LANGUAGE_EXTENSIONS, Y as LanguageConfig, Z as Lead, _ as LeadSchema, $ as LeadSource, a0 as LeadSourceSchema, a1 as LeadSubmission, a2 as LeadSubmissionSchema, a3 as Location, a4 as LocationSchema, a5 as ManagedAccount, a6 as ManagedAccountSchema, a7 as MetricsSchema, a8 as ModelTier, a9 as ModelTierSchema, aa as ParseError, ab as ParseStatistics, ac as ReadinessRating, ad as RecommendationPriority, ae as SCORING_PROFILES, af as SIZE_ADJUSTED_THRESHOLDS, ag as ScanResult, ah as ScoringConfig, ai as ScoringProfile, aj as ScoringResult, ak as SeveritySchema, al as SourceLocation, am as SourceRange, an as SpokeOutputSchema, ao as SpokeSummary, ap as SpokeSummarySchema, aq as TOOL_NAME_MAP, ar as ToolNameSchema, as as ToolOutput, at as UnifiedReport, au as UnifiedReportSchema, av as calculateOverallScore, aw as formatScore, ax as formatToolScore, ay as generateHTML, az as getPriorityIcon, aA as getProjectSizeTier, aB as getRating, aC as getRatingDisplay, aD as getRatingEmoji, aE as getRatingLabel, aF as getRatingMetadata, aG as getRatingSlug, aH as getRatingWithContext, aI as getRecommendedThreshold, aJ as getToolEmoji, aK as getToolWeight, aL as normalizeToolName, aM as parseWeightString } from './index-EQ2jRSlB.mjs';
 import { z } from 'zod';
 import * as chalk from 'chalk';
 import * as Parser from 'web-tree-sitter';
@@ -199,11 +199,10 @@ declare function getFileExtension(filePath: string): string;
  */
 declare function isSourceFile(filePath: string): boolean;
 
-/**
- * Common CLI configuration interface
- * @deprecated Use ToolOptions from @aiready/core instead
- */
-type CLIOptions = ToolOptions;
+/** @internal */
+declare function ensureDir(path: string): void;
+/** @internal */
+declare function getFilesByPattern(dir: string, pattern: RegExp): string[];
 /**
  * Resolve output file path, defaulting to .aiready directory.
  * Creates parent directories if they don't exist.
@@ -215,18 +214,6 @@ type CLIOptions = ToolOptions;
  * @lastUpdated 2026-03-18
  */
 declare function resolveOutputPath(userPath: string | undefined, defaultFilename: string, workingDir?: string): string;
-/**
- * Load and merge configuration with CLI options.
- *
- * @param directory - Root directory to load config from.
- * @param defaults - Default configuration values.
- * @param cliOptions - Configuration overrides from CLI arguments.
- * @returns Merged configuration object.
- * @lastUpdated 2026-03-18
- */
-declare function loadMergedConfig<T extends Record<string, any>>(directory: string, defaults: T, cliOptions: Partial<T>): Promise<T & {
-    rootDir: string;
-}>;
 /**
  * Handle JSON output for CLI commands.
  * Writes to file if outputFile is provided, otherwise logs to console.
@@ -238,46 +225,74 @@ declare function loadMergedConfig<T extends Record<string, any>>(directory: stri
  */
 declare function handleJSONOutput(data: any, outputFile?: string, successMessage?: string): void;
 /**
- * Get a formatted terminal divider string based on current terminal width.
+ * Find the latest aiready report in a directory by modification time.
+ * Searches for both new format (aiready-report-*) and legacy format (aiready-scan-*).
  *
- * @param color - Chalk color function to use for the divider.
- * @param maxWidth - Maximum width for the divider (default: 60).
- * @returns String representation of the divider.
+ * @param dirPath - The directory path to search for .aiready directory.
+ * @returns The path to the latest report or null if not found.
+ * @lastUpdated 2026-03-18
  */
-declare function getTerminalDivider(color?: any, maxWidth?: number): string;
+declare function findLatestReport(dirPath: string): string | null;
 /**
- * Print a standard terminal header with dividers.
+ * Find the latest scan report file with a specific prefix.
  *
- * @param title - Header title text.
- * @param color - Chalk color function for the dividers.
+ * @param scanReportsDir - Directory containing reports.
+ * @param reportFilePrefix - Filename prefix to match (e.g. "report-").
+ * @returns Path to the latest matching report or null.
+ * @lastUpdated 2026-03-18
  */
-declare function printTerminalHeader(title: string, color?: any): void;
+declare function findLatestScanReport(scanReportsDir: string, reportFilePrefix: string): string | null;
+
+/** @internal */
+declare function normalizeSeverity(s: string | undefined): Severity | null;
 /**
- * Common CLI error handler for CLI commands.
- * Logs error and exits process with code 1.
+ * Get numeric severity value for comparison (4-1)
+ * @param s Severity level string
+ * @returns Numeric value (4: critical, 3: major, 2: minor, 1: info)
+ */
+declare function getSeverityValue(s: string | undefined): number;
+/**
+ * Get numeric severity level (alias for getSeverityValue)
+ * @param s Severity level string
+ * @returns Numeric value
+ */
+declare function getSeverityLevel(s: string | undefined): number;
+/**
+ * Get Severity enum from string for internal logic
+ * @param s Severity level string
+ * @returns Normalized severity string
+ */
+declare function getSeverityEnum(s: string | undefined): any;
+/**
+ * Get chalk color function for a given severity
  *
- * @param error - Error object or message.
- * @param commandName - Name of the command that failed.
- * @returns Never returns as it exits the process.
- * @lastUpdated 2026-03-18
+ * @param severity - Severity level string.
+ * @param chalkInstance - Optional chalk instance to use.
+ * @returns Chalk color function.
  */
-declare function handleCLIError(error: unknown, commandName: string): never;
+declare function getSeverityColor(severity: string, chalkInstance?: any): any;
 /**
- * Calculate elapsed time and format for display
+ * Get a formatted severity badge string
+ */
+declare function getSeverityBadge(severity: string, chalkInstance?: any): string;
+/**
+ * Get a human-readable severity label with emoji
  *
- * @param startTime - Start timestamp in milliseconds.
- * @returns Formatted duration string in seconds.
- * @lastUpdated 2026-03-18
+ * @param severity - The severity level to label.
+ * @returns Formatted label string for UI display.
  */
-declare function getElapsedTime(startTime: number): string;
+declare function getSeverityLabel(severity: Severity): string;
 /**
- * Generate a visual score bar for console output
+ * Filter items by minimum severity threshold
  *
- * @param val - Score value between 0 and 100.
- * @returns String representation of the bar (e.g., "█████░░░░░").
- * @lastUpdated 2026-03-18
+ * @param items - List of items with a severity property.
+ * @param minSeverity - Minimum threshold for inclusion.
+ * @returns Filtered list of items.
  */
-declare function getScoreBar(val: number): string;
+declare function filterBySeverity<T extends {
+    severity: Severity;
+}>(items: T[], minSeverity: Severity): T[];
+
 /**
  * Get status icon for safety ratings
  *
@@ -286,6 +301,20 @@ declare function getScoreBar(val: number): string;
  * @lastUpdated 2026-03-18
  */
 declare function getSafetyIcon(rating: string): string;
+
+/**
+ * Print a stylized terminal header for a tool
+ */
+declare function printTerminalHeader(title: string, colorFn?: any, width?: number): void;
+/**
+ * Get a terminal divider line
+ */
+declare function getTerminalDivider(colorFn?: any, width?: number): string;
+/**
+ * Get a visual score bar (emoji/block based)
+ */
+declare function getScoreBar(score: number, width?: number): string;
+
 /**
  * Emit progress update with throttling to reduce log noise
  * @param processed Number of items processed
@@ -296,58 +325,36 @@ declare function getSafetyIcon(rating: string): string;
  * @param throttleCount Frequency of updates (every N items)
  */
 declare function emitProgress(processed: number, total: number, toolId: string, message: string, onProgress?: (processed: number, total: number, message: string) => void, throttleCount?: number): void;
+
 /**
- * Get chalk color function for a given severity
+ * Calculate elapsed time and format for display
  *
- * @param severity - Severity level string.
- * @param chalkInstance - Optional chalk instance to use.
- * @returns Chalk color function.
- * @lastUpdated 2026-03-18
- */
-declare function getSeverityColor(severity: string, chalkInstance?: any): any;
-/**
- * Get numeric severity value for comparison (4-1)
- * @param s Severity level string
- * @returns Numeric value (4: critical, 3: major, 2: minor, 1: info)
- */
-declare function getSeverityValue(s: string | undefined): number;
-/**
- * Get numeric severity level (alias for getSeverityValue)
- * @param s Severity level string
- * @returns Numeric value
- */
-declare function getSeverityLevel(s: string | undefined): number;
-/**
- * Get colored severity badge for console output
- * @param severity Severity level
- * @param chalkInstance Chalk instance (optional)
- * @returns Formatted badge string
+ * @param startTime - Start timestamp in milliseconds.
+ * @returns Formatted duration string in seconds.
  */
-declare function getSeverityBadge(severity: Severity | string, chalkInstance?: any): string;
+declare function getElapsedTime(startTime: number): string;
 /**
- * Get Severity enum from string for internal logic
- * @param s Severity level string
- * @returns Normalized severity string
+ * Common CLI error handler for CLI commands.
  */
-declare function getSeverityEnum(s: string | undefined): any;
+declare function handleCLIError(error: unknown, commandName: string): never;
+
 /**
- * Find the latest aiready report in a directory by modification time.
- * Searches for both new format (aiready-report-*) and legacy format (aiready-scan-*).
- *
- * @param dirPath - The directory path to search for .aiready directory.
- * @returns The path to the latest report or null if not found.
- * @lastUpdated 2026-03-18
+ * Common CLI configuration interface
+ * @deprecated Use ToolOptions from @aiready/core instead
  */
-declare function findLatestReport(dirPath: string): string | null;
+type CLIOptions = ToolOptions;
 /**
- * Find the latest scan report file with a specific prefix.
+ * Load and merge configuration with CLI options.
  *
- * @param scanReportsDir - Directory containing reports.
- * @param reportFilePrefix - Filename prefix to match (e.g. "report-").
- * @returns Path to the latest matching report or null.
+ * @param directory - Root directory to load config from.
+ * @param defaults - Default configuration values.
+ * @param cliOptions - Configuration overrides from CLI arguments.
+ * @returns Merged configuration object.
  * @lastUpdated 2026-03-18
  */
-declare function findLatestScanReport(scanReportsDir: string, reportFilePrefix: string): string | null;
+declare function loadMergedConfig<T extends Record<string, any>>(directory: string, defaults: T, cliOptions: Partial<T>): Promise<T & {
+    rootDir: string;
+}>;
 
 /**
  * Generate timestamp for report filenames (YYYYMMDD-HHMMSS)
@@ -499,65 +506,35 @@ declare function loadConfig(rootDir: string): Promise<AIReadyConfig | null>;
  */
 declare function mergeConfigWithDefaults(userConfig: AIReadyConfig | null, defaults: any): any;
 
-/**
- * Shared HTML report formatting utilities.
- * Provides common template parts for generating self-contained HTML reports.
- *
- * @lastUpdated 2026-03-24
- */
+declare function generateReportHead(title: string, styles?: string): string;
+declare function generateReportHero(title: string, subtitle?: string): string;
+declare function generateStatCards(cards: any[]): string;
+declare function generateTable(config: any): string;
+declare function generateIssueSummary(crit: number, maj: number, min: number, savings?: number): string;
+declare function generateReportFooter(options: any): string;
+declare function wrapInCard(content: string, title?: string): string;
+declare function generateCompleteReport(options: any, body: string): string;
+interface StatCard {
+    value: string | number;
+    label: string;
+    color?: string;
+}
+interface HtmlReportSection {
+    title: string;
+    content: string;
+}
 interface ReportOptions {
     title: string;
-    subtitle?: string;
     packageName: string;
     packageUrl?: string;
     bugUrl?: string;
     version?: string;
+    emoji?: string;
 }
-interface StatCard {
-    value: string | number;
+declare function generateStandardHtmlReport(options: ReportOptions, stats: StatCard[], sections: HtmlReportSection[], score?: {
+    value: number | string;
     label: string;
-    color?: string;
-}
-interface TableConfig {
-    headers: string[];
-    rows: string[][];
-}
-/**
- * Generate the HTML document head with common styles.
- */
-declare function generateReportHead(title: string): string;
-/**
- * Generate a hero section for the report.
- */
-declare function generateReportHero(title: string, subtitle?: string): string;
-/**
- * Generate stat cards section.
- */
-declare function generateStatCards(cards: StatCard[]): string;
-/**
- * Generate a score card with a single large value.
- */
-declare function generateScoreCard(value: string | number, label: string): string;
-/**
- * Generate an HTML table from configuration.
- */
-declare function generateTable(config: TableConfig): string;
-/**
- * Generate an issue summary card.
- */
-declare function generateIssueSummary(critical: number, major: number, minor: number, potentialSavings?: number): string;
-/**
- * Generate the report footer.
- */
-declare function generateReportFooter(options: ReportOptions): string;
-/**
- * Wrap content in a card div.
- */
-declare function wrapInCard(content: string, title?: string): string;
-/**
- * Generate a complete report by combining all parts.
- */
-declare function generateCompleteReport(options: ReportOptions, bodyContent: string): string;
+}): string;
 
 /**
  * Normalizes raw issue data into a strict Issue object.
@@ -682,16 +659,28 @@ declare function getScoreColor(score: number): chalk.ChalkInstance;
 declare function displayStandardConsoleReport(data: StandardReportData): void;
 
 /**
- * Logical code block extracted from source
+ * Represents a block of code extracted from a source file.
+ * Used for pattern detection and code analysis.
  */
 interface CodeBlock {
+    /** Relative file path */
     file: string;
+    /** Starting line number (1-based) */
     startLine: number;
+    /** Ending line number (1-based) */
     endLine: number;
+    /** The actual code content */
     code: string;
+    /** Approximate token count */
     tokens: number;
+    /** Type of pattern (e.g., 'function', 'class', 'block') */
     patternType: string;
+    /** Optional function/method signature for matching */
+    signature?: string;
+    /** Optional hash for quick duplicate detection */
+    hash?: string;
 }
+
 /**
  * Infer the type of code pattern based on keywords and naming conventions.
  */
@@ -1509,6 +1498,17 @@ interface AiSignalClarity {
     topRisk: string;
     /** Actionable recommendations to improve clarity */
     recommendations: string[];
+    /** Metric dimensions for scoring (0-100) */
+    dimensions: {
+        overloadingScore: number;
+        magicLiteralScore: number;
+        booleanTrapScore: number;
+        implicitSideEffectScore: number;
+        deepCallbackScore: number;
+        ambiguityScore: number;
+        documentationScore: number;
+        sizeScore: number;
+    };
 }
 /**
  * Calculate AI Signal Clarity metrics based on various documented and undocumented code patterns.
@@ -1930,4 +1930,42 @@ declare function severityToAnnotationLevel(severity: string): 'error' | 'warning
  */
 declare function emitIssuesAsAnnotations(issues: any[]): void;
 
-export { AIReadyConfig, AcceptancePrediction, type AgentGroundingScore, type AiSignalClarity, type AiSignalClaritySignal, AnalysisResult, type CLIOptions, CSharpParser, type ChangeAmplificationScore, type CodeBlock, type CognitiveLoad, ComprehensionDifficulty, type ConceptCohesion, CostConfig, DEFAULT_COST_CONFIG, DEFAULT_EXCLUDE, type DependencyHealthScore, type DocDriftRisk, ExportInfo, ExportWithImports, FileImport, type FileTestability, type FileWithDomain, GoParser, Issue, type JSONOutputParams, JavaParser, type KnowledgeConcentrationRisk, Language, LanguageParser, type LoadFactor, MODEL_PRICING_PRESETS, Metrics, ModelContextTier, type ModelPricingPreset, NamingConvention, ParseResult, ParserFactory, type PatternEntropy, ProductivityImpact, type ProviderFactoryConfig, PythonParser, type ReportOptions, SEVERITY_TIME_ESTIMATES, ScanOptions, type ScoreHistoryEntry, type ScoreTrend, type SemanticDistance, Severity, Severity as SeverityType, SpokeOutput, type StandardReportData, type StandardScoringParams, type StatCard, type TableConfig, type TechnicalDebtInterest, TechnicalValueChain, TechnicalValueChainSummary, type TestabilityIndex, TokenBudget, ToolName, ToolOptions, type ToolProvider, ToolRegistry, ToolScoringOutput, TypeScriptParser, VAGUE_FILE_NAMES, buildFactorsFromDimensions, buildSimpleProviderScore, buildSpokeOutput, buildStandardToolScore, calculateAgentGrounding, calculateAiSignalClarity, calculateBusinessROI, calculateChangeAmplification, calculateCognitiveLoad, calculateComprehensionDifficulty, calculateConceptCohesion, calculateDebtInterest, calculateDependencyHealth, calculateDetailedTokenROI, calculateDocDrift, calculateExtendedFutureProofScore, calculateFutureProofScore, calculateHeuristicConfidence, calculateImportSimilarity, calculateKnowledgeConcentration, calculateMonthlyCost, calculatePatternEntropy, calculateProductivityImpact, calculateSemanticDistance, calculateStringSimilarity, calculateTechnicalValueChain, calculateTestabilityIndex, calculateTokenBudget, clearHistory, createProvider, createStandardProgressCallback, displayStandardConsoleReport, emitAnnotation, emitIssuesAsAnnotations, emitProgress, estimateCostFromBudget, estimateTokens, exportHistory, extractCodeBlocks, findLatestReport, findLatestScanReport, formatAcceptanceRate, formatCost, formatHours, formatStandardCliResult, formatStandardReport, generateCompleteReport, generateIssueSummary, generateReportFooter, generateReportHead, generateReportHero, generateScoreCard, generateStatCards, generateTable, generateValueChain, getElapsedTime, getFileCommitTimestamps, getFileExtension, getHistorySummary, getLineRangeLastModifiedCached, getModelPreset, getParser, getRepoMetadata, getReportTimestamp, getSafetyIcon, getScoreBar, getScoreColor, getSeverityBadge, getSeverityColor, getSeverityEnum, getSeverityLevel, getSeverityValue, getSupportedLanguages, getTerminalDivider, getWasmPath, groupIssuesByFile, handleCLIError, handleJSONOutput, handleStandardJSONOutput, inferPatternType, initTreeSitter, initializeParsers, isFileSupported, isSourceFile, loadConfig, loadMergedConfig, loadScoreHistory, mergeConfigWithDefaults, normalizeAnalysisResult, normalizeIssue, normalizeMetrics, normalizeSpokeOutput, parseFileExports, predictAcceptanceRate, prepareActionConfig, printTerminalHeader, readFileContent, resolveOutputFormat, resolveOutputPath, runStandardCliAction, saveScoreEntry, scanEntries, scanFiles, setupParser, severityToAnnotationLevel, validateSpokeOutput, validateWithSchema, wrapInCard };
+/**
+ * Generic batch analysis runner with progress reporting.
+ */
+declare function runBatchAnalysis<T, R>(items: T[], label: string, toolId: string, onProgress: ((processed: number, total: number, message: string) => void) | undefined, processFn: (item: T) => Promise<R>, onResult: (result: R) => void): Promise<void>;
+
+/**
+ * Shared logic for spoke-specific CLI entry points to reduce code duplication.
+ */
+declare function executeSpokeCli(name: string, description: string, options: any, analyzeFn: (config: any) => Promise<any>): Promise<any>;
+
+/**
+ * Common test file patterns for multiple languages.
+ */
+declare const TEST_PATTERNS: RegExp[];
+/**
+ * Check if a file path matches known test patterns.
+ *
+ * @param filePath - The file path to check.
+ * @param extraPatterns - Optional extra patterns to include.
+ * @returns True if the file is considered a test file.
+ */
+declare function isTestFile(filePath: string, extraPatterns?: string[]): boolean;
+/**
+ * Detect if a testing framework is present in the root directory.
+ * Supports Node.js (Jest, Vitest, etc.), Python (Pytest), Java (JUnit), and Go.
+ *
+ * @param rootDir - The root directory of the project.
+ * @returns True if a testing framework is detected.
+ */
+declare function detectTestFramework(rootDir: string): boolean;
+/**
+ * Check if a file path belongs to a build artifact or dependency folder.
+ *
+ * @param filePath - The path to check.
+ * @returns True if the file is a build artifact.
+ */
+declare function isBuildArtifact(filePath: string): boolean;
+
+export { AIReadyConfig, AcceptancePrediction, type AgentGroundingScore, type AiSignalClarity, type AiSignalClaritySignal, AnalysisResult, type CLIOptions, CSharpParser, type ChangeAmplificationScore, type CodeBlock, type CognitiveLoad, ComprehensionDifficulty, type ConceptCohesion, CostConfig, DEFAULT_COST_CONFIG, DEFAULT_EXCLUDE, type DependencyHealthScore, type DocDriftRisk, ExportInfo, ExportWithImports, FileImport, type FileTestability, type FileWithDomain, GoParser, type HtmlReportSection, Issue, type JSONOutputParams, JavaParser, type KnowledgeConcentrationRisk, Language, LanguageParser, type LoadFactor, MODEL_PRICING_PRESETS, Metrics, ModelContextTier, type ModelPricingPreset, NamingConvention, ParseResult, ParserFactory, type PatternEntropy, ProductivityImpact, type ProviderFactoryConfig, PythonParser, type ReportOptions, SEVERITY_TIME_ESTIMATES, ScanOptions, type ScoreHistoryEntry, type ScoreTrend, type SemanticDistance, Severity, Severity as SeverityType, SpokeOutput, type StandardReportData, type StandardScoringParams, type StatCard, TEST_PATTERNS, type TechnicalDebtInterest, TechnicalValueChain, TechnicalValueChainSummary, type TestabilityIndex, TokenBudget, ToolName, ToolOptions, type ToolProvider, ToolRegistry, ToolScoringOutput, TypeScriptParser, VAGUE_FILE_NAMES, buildFactorsFromDimensions, buildSimpleProviderScore, buildSpokeOutput, buildStandardToolScore, calculateAgentGrounding, calculateAiSignalClarity, calculateBusinessROI, calculateChangeAmplification, calculateCognitiveLoad, calculateComprehensionDifficulty, calculateConceptCohesion, calculateDebtInterest, calculateDependencyHealth, calculateDetailedTokenROI, calculateDocDrift, calculateExtendedFutureProofScore, calculateFutureProofScore, calculateHeuristicConfidence, calculateImportSimilarity, calculateKnowledgeConcentration, calculateMonthlyCost, calculatePatternEntropy, calculateProductivityImpact, calculateSemanticDistance, calculateStringSimilarity, calculateTechnicalValueChain, calculateTestabilityIndex, calculateTokenBudget, clearHistory, createProvider, createStandardProgressCallback, detectTestFramework, displayStandardConsoleReport, emitAnnotation, emitIssuesAsAnnotations, emitProgress, ensureDir, estimateCostFromBudget, estimateTokens, executeSpokeCli, exportHistory, extractCodeBlocks, filterBySeverity, findLatestReport, findLatestScanReport, formatAcceptanceRate, formatCost, formatHours, formatStandardCliResult, formatStandardReport, generateCompleteReport, generateIssueSummary, generateReportFooter, generateReportHead, generateReportHero, generateStandardHtmlReport, generateStatCards, generateTable, generateValueChain, getElapsedTime, getFileCommitTimestamps, getFileExtension, getFilesByPattern, getHistorySummary, getLineRangeLastModifiedCached, getModelPreset, getParser, getRepoMetadata, getReportTimestamp, getSafetyIcon, getScoreBar, getScoreColor, getSeverityBadge, getSeverityColor, getSeverityEnum, getSeverityLabel, getSeverityLevel, getSeverityValue, getSupportedLanguages, getTerminalDivider, getWasmPath, groupIssuesByFile, handleCLIError, handleJSONOutput, handleStandardJSONOutput, inferPatternType, initTreeSitter, initializeParsers, isBuildArtifact, isFileSupported, isSourceFile, isTestFile, loadConfig, loadMergedConfig, loadScoreHistory, mergeConfigWithDefaults, normalizeAnalysisResult, normalizeIssue, normalizeMetrics, normalizeSeverity, normalizeSpokeOutput, parseFileExports, predictAcceptanceRate, prepareActionConfig, printTerminalHeader, readFileContent, resolveOutputFormat, resolveOutputPath, runBatchAnalysis, runStandardCliAction, saveScoreEntry, scanEntries, scanFiles, setupParser, severityToAnnotationLevel, validateSpokeOutput, validateWithSchema, wrapInCard };