@aiready/core 0.24.22 → 0.24.25

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-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-c5MKV8s5.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-c5MKV8s5.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-ClwnZa_Y.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-ClwnZa_Y.mjs';
 import { z } from 'zod';
 import { Command } from 'commander';
 import * as chalk from 'chalk';
@@ -219,34 +219,18 @@ declare function scanEntries(options: ScanOptions): Promise<{
     files: string[];
     dirs: string[];
 }>;
-/**
- * Read the contents of a file as a UTF-8 string.
- * @param filePath - Absolute path to the file to read
- * @returns The file contents as a string
- */
 /**
  * Read the contents of a file as a UTF-8 string.
  * @param filePath - Absolute path to the file to read
  * @returns The file contents as a string
  */
 declare function readFileContent(filePath: string): Promise<string>;
-/**
- * Extract the file extension from a file path.
- * @param filePath - The file path to extract extension from
- * @returns The file extension without the dot (e.g., 'ts', 'js', 'py')
- */
 /**
  * Extract the file extension from a file path.
  * @param filePath - The file path to extract extension from
  * @returns The file extension without the dot (e.g., 'ts', 'js', 'py')
  */
 declare function getFileExtension(filePath: string): string;
-/**
- * Check if a file is a source code file based on its extension.
- * Supports TypeScript, JavaScript, Python, Java, Go, Rust, and C#.
- * @param filePath - The file path to check
- * @returns True if the file has a source code extension
- */
 /**
  * Check if a file is a source code file based on its extension.
  * Supports TypeScript, JavaScript, Python, Java, Go, Rust, and C#.
@@ -270,6 +254,14 @@ declare function getFilesByPattern(dir: string, pattern: RegExp): string[];
  * @lastUpdated 2026-03-18
  */
 declare function resolveOutputPath(userPath: string | undefined, defaultFilename: string, workingDir?: string): string;
+/**
+ * Safe JSON stringify that handles BigInt values.
+ *
+ * @param obj - Object to stringify.
+ * @param indent - Indentation spaces.
+ * @returns JSON string.
+ */
+declare function safeJsonStringify(obj: any, indent?: number): string;
 /**
  * Handle JSON output for CLI commands.
  * Writes to file if outputFile is provided, otherwise logs to console.
@@ -567,12 +559,32 @@ declare function parseFileExports(code: string, filePath: string): Promise<{
  */
 declare function estimateTokens(text: string): number;
 
+declare const DEFAULT_AUTO_EXCLUDE_PATTERNS: {
+    tests: string[];
+    mocks: string[];
+    barrels: string[];
+    generated: string[];
+};
+interface ValidationWarning {
+    line?: number;
+    rule: string;
+    message: string;
+    suggestion?: string;
+}
 /**
  * Search upwards for AIReady configuration files and load the first one found.
  * @param rootDir Starting directory for the search
+ * @param options Options for config loading
  * @returns Parsed configuration object or null if not found
  */
-declare function loadConfig(rootDir: string): Promise<AIReadyConfig | null>;
+declare function loadConfig(rootDir: string, options?: {
+    validate?: boolean;
+    applyAutoExclude?: boolean;
+}): Promise<{
+    config: AIReadyConfig | null;
+    warnings: ValidationWarning[];
+}>;
+declare function validateConfig(configPath: string): ValidationWarning[];
 /**
  * Merge user-provided configuration with default settings.
  * @param userConfig The configuration loaded from file
@@ -771,6 +783,15 @@ declare function inferPatternType(keyword: string, name: string): string;
  */
 declare function extractCodeBlocks(file: string, content: string): CodeBlock[];
 
+/**
+ * Common utility to get the directory name from import.meta.url.
+ * Handles both ESM and CJS compatibility for local development.
+ *
+ * @param importMetaUrl - The import.meta.url from the calling module.
+ * @returns The absolute directory path of the calling module.
+ */
+declare function getDirname(importMetaUrl?: string): string;
+
 /**
  * Business Value Metrics Module.
  *
@@ -2083,6 +2104,14 @@ declare function getRepoMetadata(directory: string): {
     commit?: string;
     author?: string;
 };
+/**
+ * Get a list of files that have been changed in the current repository.
+ * Includes staged and unstaged changes, and untracked files.
+ *
+ * @param directory - The repository root directory.
+ * @returns Array of relative file paths.
+ */
+declare function getChangedFiles(directory: string): string[];
 
 /**
  * Utilities for GitHub Actions integration
@@ -2197,4 +2226,59 @@ declare function withErrorHandling<T>(operation: () => Promise<T>, context?: str
     error: string;
 }>;
 
-export { AIReadyConfig, AWS_CONSTANTS, AcceptancePrediction, type AgentGroundingScore, type AiSignalClarity, type AiSignalClaritySignal, AnalysisResult, type AwsRegion, type CLIOptions, CSharpParser, type ChangeAmplificationScore, type CodeBlock, type CognitiveLoad, ComprehensionDifficulty, type ConceptCohesion, type ConfigProvider, CostConfig, DEFAULT_COST_CONFIG, DEFAULT_EXCLUDE, DIContainer, DI_TOKENS, type DependencyHealthScore, type DocDriftRisk, ExportInfo, ExportWithImports, type Factory, FileImport, type FileSystem, type FileTestability, type FileWithDomain, GoParser, type HtmlReportSection, Issue, type JSONOutputParams, JavaParser, type KnowledgeConcentrationRisk, Language, LanguageParser, type LoadFactor, type Logger, 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 TableConfig, type TechnicalDebtInterest, TechnicalValueChain, TechnicalValueChainSummary, type TestabilityIndex, type Token, 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, createErrorResponse, createProvider, createStandardCommand, createStandardProgressCallback, defaultImplementations, 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, getErrorMessage, getFileCommitTimestamps, getFileExtension, getFilesByPattern, getHistorySummary, getLineRangeLastModifiedCached, getModelPreset, getParser, getRepoMetadata, getReportTimestamp, getSafetyIcon, getScoreBar, getScoreColor, getSeverityBadge, getSeverityColor, getSeverityEnum, getSeverityLabel, getSeverityLevel, getSeverityValue, getSupportedLanguages, getTerminalDivider, getWasmPath, globalContainer, groupIssuesByFile, handleCLIError, handleJSONOutput, handleStandardJSONOutput, inferPatternType, initTreeSitter, initializeParsers, isBuildArtifact, isFileSupported, isIgnorableSourceFile, 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, toErrorMessage, validateSpokeOutput, validateWithSchema, withErrorHandling, wrapInCard };
+interface IssueContext {
+    number: number;
+    title: string;
+    body: string;
+    labels: string[];
+    author?: string;
+}
+interface ResolveResult {
+    success: boolean;
+    message: string;
+    changes?: string[];
+}
+interface ResolverOptions {
+    generate: (prompt: string) => Promise<string>;
+    trustedAuthors?: string[];
+}
+declare class GitHubIssueResolverAgent {
+    private generate;
+    private trustedAuthors;
+    constructor(options: ResolverOptions);
+    resolve(issue: IssueContext, workingDir: string): Promise<ResolveResult>;
+    private identifyStrategy;
+    private executeSubtreeSync;
+    private applyContributionPattern;
+    private applyAgenticPatch;
+    private extractVersion;
+}
+
+interface GitHubIssue {
+    title: string;
+    body: string;
+    labels?: string[];
+}
+declare class GitHubService {
+    private octokit;
+    constructor(token: string);
+    /**
+     * Creates an issue in a repository.
+     */
+    createHubIssue(owner: string, repo: string, issue: GitHubIssue): Promise<number>;
+    /**
+     * Creates a Pull Request in a repository.
+     */
+    createPullRequest(owner: string, repo: string, pr: {
+        title: string;
+        body: string;
+        head: string;
+        base: string;
+    }): Promise<number>;
+    /**
+     * Scans a repository content.
+     */
+    listRecentChangesInRepo(owner: string, repo: string, path?: string): Promise<string[]>;
+}
+
+export { AIReadyConfig, AWS_CONSTANTS, AcceptancePrediction, type AgentGroundingScore, type AiSignalClarity, type AiSignalClaritySignal, AnalysisResult, type AwsRegion, type CLIOptions, CSharpParser, type ChangeAmplificationScore, type CodeBlock, type CognitiveLoad, ComprehensionDifficulty, type ConceptCohesion, type ConfigProvider, CostConfig, DEFAULT_AUTO_EXCLUDE_PATTERNS, DEFAULT_COST_CONFIG, DEFAULT_EXCLUDE, DIContainer, DI_TOKENS, type DependencyHealthScore, type DocDriftRisk, ExportInfo, ExportWithImports, type Factory, FileImport, type FileSystem, type FileTestability, type FileWithDomain, type GitHubIssue, GitHubIssueResolverAgent, GitHubService, GoParser, type HtmlReportSection, Issue, type IssueContext, type JSONOutputParams, JavaParser, type KnowledgeConcentrationRisk, Language, LanguageParser, type LoadFactor, type Logger, MODEL_PRICING_PRESETS, Metrics, ModelContextTier, type ModelPricingPreset, NamingConvention, ParseResult, ParserFactory, type PatternEntropy, ProductivityImpact, type ProviderFactoryConfig, PythonParser, type ReportOptions, type ResolveResult, type ResolverOptions, SEVERITY_TIME_ESTIMATES, ScanOptions, type ScoreHistoryEntry, type ScoreTrend, type SemanticDistance, Severity, Severity as SeverityType, SpokeOutput, type StandardReportData, type StandardScoringParams, type StatCard, TEST_PATTERNS, type TableConfig, type TechnicalDebtInterest, TechnicalValueChain, TechnicalValueChainSummary, type TestabilityIndex, type Token, TokenBudget, ToolName, ToolOptions, type ToolProvider, ToolRegistry, ToolScoringOutput, TypeScriptParser, VAGUE_FILE_NAMES, type ValidationWarning, 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, createErrorResponse, createProvider, createStandardCommand, createStandardProgressCallback, defaultImplementations, 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, getChangedFiles, getDirname, getElapsedTime, getErrorMessage, getFileCommitTimestamps, getFileExtension, getFilesByPattern, getHistorySummary, getLineRangeLastModifiedCached, getModelPreset, getParser, getRepoMetadata, getReportTimestamp, getSafetyIcon, getScoreBar, getScoreColor, getSeverityBadge, getSeverityColor, getSeverityEnum, getSeverityLabel, getSeverityLevel, getSeverityValue, getSupportedLanguages, getTerminalDivider, getWasmPath, globalContainer, groupIssuesByFile, handleCLIError, handleJSONOutput, handleStandardJSONOutput, inferPatternType, initTreeSitter, initializeParsers, isBuildArtifact, isFileSupported, isIgnorableSourceFile, isSourceFile, isTestFile, loadConfig, loadMergedConfig, loadScoreHistory, mergeConfigWithDefaults, normalizeAnalysisResult, normalizeIssue, normalizeMetrics, normalizeSeverity, normalizeSpokeOutput, parseFileExports, predictAcceptanceRate, prepareActionConfig, printTerminalHeader, readFileContent, resolveOutputFormat, resolveOutputPath, runBatchAnalysis, runStandardCliAction, safeJsonStringify, saveScoreEntry, scanEntries, scanFiles, setupParser, severityToAnnotationLevel, toErrorMessage, validateConfig, validateSpokeOutput, validateWithSchema, withErrorHandling, wrapInCard };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-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-c5MKV8s5.js';
-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-c5MKV8s5.js';
+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-ClwnZa_Y.js';
+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-ClwnZa_Y.js';
 import { z } from 'zod';
 import { Command } from 'commander';
 import * as chalk from 'chalk';
@@ -219,34 +219,18 @@ declare function scanEntries(options: ScanOptions): Promise<{
     files: string[];
     dirs: string[];
 }>;
-/**
- * Read the contents of a file as a UTF-8 string.
- * @param filePath - Absolute path to the file to read
- * @returns The file contents as a string
- */
 /**
  * Read the contents of a file as a UTF-8 string.
  * @param filePath - Absolute path to the file to read
  * @returns The file contents as a string
  */
 declare function readFileContent(filePath: string): Promise<string>;
-/**
- * Extract the file extension from a file path.
- * @param filePath - The file path to extract extension from
- * @returns The file extension without the dot (e.g., 'ts', 'js', 'py')
- */
 /**
  * Extract the file extension from a file path.
  * @param filePath - The file path to extract extension from
  * @returns The file extension without the dot (e.g., 'ts', 'js', 'py')
  */
 declare function getFileExtension(filePath: string): string;
-/**
- * Check if a file is a source code file based on its extension.
- * Supports TypeScript, JavaScript, Python, Java, Go, Rust, and C#.
- * @param filePath - The file path to check
- * @returns True if the file has a source code extension
- */
 /**
  * Check if a file is a source code file based on its extension.
  * Supports TypeScript, JavaScript, Python, Java, Go, Rust, and C#.
@@ -270,6 +254,14 @@ declare function getFilesByPattern(dir: string, pattern: RegExp): string[];
  * @lastUpdated 2026-03-18
  */
 declare function resolveOutputPath(userPath: string | undefined, defaultFilename: string, workingDir?: string): string;
+/**
+ * Safe JSON stringify that handles BigInt values.
+ *
+ * @param obj - Object to stringify.
+ * @param indent - Indentation spaces.
+ * @returns JSON string.
+ */
+declare function safeJsonStringify(obj: any, indent?: number): string;
 /**
  * Handle JSON output for CLI commands.
  * Writes to file if outputFile is provided, otherwise logs to console.
@@ -567,12 +559,32 @@ declare function parseFileExports(code: string, filePath: string): Promise<{
  */
 declare function estimateTokens(text: string): number;
 
+declare const DEFAULT_AUTO_EXCLUDE_PATTERNS: {
+    tests: string[];
+    mocks: string[];
+    barrels: string[];
+    generated: string[];
+};
+interface ValidationWarning {
+    line?: number;
+    rule: string;
+    message: string;
+    suggestion?: string;
+}
 /**
  * Search upwards for AIReady configuration files and load the first one found.
  * @param rootDir Starting directory for the search
+ * @param options Options for config loading
  * @returns Parsed configuration object or null if not found
  */
-declare function loadConfig(rootDir: string): Promise<AIReadyConfig | null>;
+declare function loadConfig(rootDir: string, options?: {
+    validate?: boolean;
+    applyAutoExclude?: boolean;
+}): Promise<{
+    config: AIReadyConfig | null;
+    warnings: ValidationWarning[];
+}>;
+declare function validateConfig(configPath: string): ValidationWarning[];
 /**
  * Merge user-provided configuration with default settings.
  * @param userConfig The configuration loaded from file
@@ -771,6 +783,15 @@ declare function inferPatternType(keyword: string, name: string): string;
  */
 declare function extractCodeBlocks(file: string, content: string): CodeBlock[];
 
+/**
+ * Common utility to get the directory name from import.meta.url.
+ * Handles both ESM and CJS compatibility for local development.
+ *
+ * @param importMetaUrl - The import.meta.url from the calling module.
+ * @returns The absolute directory path of the calling module.
+ */
+declare function getDirname(importMetaUrl?: string): string;
+
 /**
  * Business Value Metrics Module.
  *
@@ -2083,6 +2104,14 @@ declare function getRepoMetadata(directory: string): {
     commit?: string;
     author?: string;
 };
+/**
+ * Get a list of files that have been changed in the current repository.
+ * Includes staged and unstaged changes, and untracked files.
+ *
+ * @param directory - The repository root directory.
+ * @returns Array of relative file paths.
+ */
+declare function getChangedFiles(directory: string): string[];
 
 /**
  * Utilities for GitHub Actions integration
@@ -2197,4 +2226,59 @@ declare function withErrorHandling<T>(operation: () => Promise<T>, context?: str
     error: string;
 }>;
 
-export { AIReadyConfig, AWS_CONSTANTS, AcceptancePrediction, type AgentGroundingScore, type AiSignalClarity, type AiSignalClaritySignal, AnalysisResult, type AwsRegion, type CLIOptions, CSharpParser, type ChangeAmplificationScore, type CodeBlock, type CognitiveLoad, ComprehensionDifficulty, type ConceptCohesion, type ConfigProvider, CostConfig, DEFAULT_COST_CONFIG, DEFAULT_EXCLUDE, DIContainer, DI_TOKENS, type DependencyHealthScore, type DocDriftRisk, ExportInfo, ExportWithImports, type Factory, FileImport, type FileSystem, type FileTestability, type FileWithDomain, GoParser, type HtmlReportSection, Issue, type JSONOutputParams, JavaParser, type KnowledgeConcentrationRisk, Language, LanguageParser, type LoadFactor, type Logger, 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 TableConfig, type TechnicalDebtInterest, TechnicalValueChain, TechnicalValueChainSummary, type TestabilityIndex, type Token, 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, createErrorResponse, createProvider, createStandardCommand, createStandardProgressCallback, defaultImplementations, 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, getErrorMessage, getFileCommitTimestamps, getFileExtension, getFilesByPattern, getHistorySummary, getLineRangeLastModifiedCached, getModelPreset, getParser, getRepoMetadata, getReportTimestamp, getSafetyIcon, getScoreBar, getScoreColor, getSeverityBadge, getSeverityColor, getSeverityEnum, getSeverityLabel, getSeverityLevel, getSeverityValue, getSupportedLanguages, getTerminalDivider, getWasmPath, globalContainer, groupIssuesByFile, handleCLIError, handleJSONOutput, handleStandardJSONOutput, inferPatternType, initTreeSitter, initializeParsers, isBuildArtifact, isFileSupported, isIgnorableSourceFile, 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, toErrorMessage, validateSpokeOutput, validateWithSchema, withErrorHandling, wrapInCard };
+interface IssueContext {
+    number: number;
+    title: string;
+    body: string;
+    labels: string[];
+    author?: string;
+}
+interface ResolveResult {
+    success: boolean;
+    message: string;
+    changes?: string[];
+}
+interface ResolverOptions {
+    generate: (prompt: string) => Promise<string>;
+    trustedAuthors?: string[];
+}
+declare class GitHubIssueResolverAgent {
+    private generate;
+    private trustedAuthors;
+    constructor(options: ResolverOptions);
+    resolve(issue: IssueContext, workingDir: string): Promise<ResolveResult>;
+    private identifyStrategy;
+    private executeSubtreeSync;
+    private applyContributionPattern;
+    private applyAgenticPatch;
+    private extractVersion;
+}
+
+interface GitHubIssue {
+    title: string;
+    body: string;
+    labels?: string[];
+}
+declare class GitHubService {
+    private octokit;
+    constructor(token: string);
+    /**
+     * Creates an issue in a repository.
+     */
+    createHubIssue(owner: string, repo: string, issue: GitHubIssue): Promise<number>;
+    /**
+     * Creates a Pull Request in a repository.
+     */
+    createPullRequest(owner: string, repo: string, pr: {
+        title: string;
+        body: string;
+        head: string;
+        base: string;
+    }): Promise<number>;
+    /**
+     * Scans a repository content.
+     */
+    listRecentChangesInRepo(owner: string, repo: string, path?: string): Promise<string[]>;
+}
+
+export { AIReadyConfig, AWS_CONSTANTS, AcceptancePrediction, type AgentGroundingScore, type AiSignalClarity, type AiSignalClaritySignal, AnalysisResult, type AwsRegion, type CLIOptions, CSharpParser, type ChangeAmplificationScore, type CodeBlock, type CognitiveLoad, ComprehensionDifficulty, type ConceptCohesion, type ConfigProvider, CostConfig, DEFAULT_AUTO_EXCLUDE_PATTERNS, DEFAULT_COST_CONFIG, DEFAULT_EXCLUDE, DIContainer, DI_TOKENS, type DependencyHealthScore, type DocDriftRisk, ExportInfo, ExportWithImports, type Factory, FileImport, type FileSystem, type FileTestability, type FileWithDomain, type GitHubIssue, GitHubIssueResolverAgent, GitHubService, GoParser, type HtmlReportSection, Issue, type IssueContext, type JSONOutputParams, JavaParser, type KnowledgeConcentrationRisk, Language, LanguageParser, type LoadFactor, type Logger, MODEL_PRICING_PRESETS, Metrics, ModelContextTier, type ModelPricingPreset, NamingConvention, ParseResult, ParserFactory, type PatternEntropy, ProductivityImpact, type ProviderFactoryConfig, PythonParser, type ReportOptions, type ResolveResult, type ResolverOptions, SEVERITY_TIME_ESTIMATES, ScanOptions, type ScoreHistoryEntry, type ScoreTrend, type SemanticDistance, Severity, Severity as SeverityType, SpokeOutput, type StandardReportData, type StandardScoringParams, type StatCard, TEST_PATTERNS, type TableConfig, type TechnicalDebtInterest, TechnicalValueChain, TechnicalValueChainSummary, type TestabilityIndex, type Token, TokenBudget, ToolName, ToolOptions, type ToolProvider, ToolRegistry, ToolScoringOutput, TypeScriptParser, VAGUE_FILE_NAMES, type ValidationWarning, 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, createErrorResponse, createProvider, createStandardCommand, createStandardProgressCallback, defaultImplementations, 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, getChangedFiles, getDirname, getElapsedTime, getErrorMessage, getFileCommitTimestamps, getFileExtension, getFilesByPattern, getHistorySummary, getLineRangeLastModifiedCached, getModelPreset, getParser, getRepoMetadata, getReportTimestamp, getSafetyIcon, getScoreBar, getScoreColor, getSeverityBadge, getSeverityColor, getSeverityEnum, getSeverityLabel, getSeverityLevel, getSeverityValue, getSupportedLanguages, getTerminalDivider, getWasmPath, globalContainer, groupIssuesByFile, handleCLIError, handleJSONOutput, handleStandardJSONOutput, inferPatternType, initTreeSitter, initializeParsers, isBuildArtifact, isFileSupported, isIgnorableSourceFile, isSourceFile, isTestFile, loadConfig, loadMergedConfig, loadScoreHistory, mergeConfigWithDefaults, normalizeAnalysisResult, normalizeIssue, normalizeMetrics, normalizeSeverity, normalizeSpokeOutput, parseFileExports, predictAcceptanceRate, prepareActionConfig, printTerminalHeader, readFileContent, resolveOutputFormat, resolveOutputPath, runBatchAnalysis, runStandardCliAction, safeJsonStringify, saveScoreEntry, scanEntries, scanFiles, setupParser, severityToAnnotationLevel, toErrorMessage, validateConfig, validateSpokeOutput, validateWithSchema, withErrorHandling, wrapInCard };