@aiready/core 0.21.21 → 0.22.1

package/dist/client.d.mts

@@ -960,6 +960,21 @@ declare const TOOL_NAME_MAP: Record<string, string>;
  * Model context tiers for context-aware threshold calibration.
  */
 type ModelContextTier = 'compact' | 'standard' | 'extended' | 'frontier';
+/**
+ * Scoring profiles for project-type-aware weighting.
+ */
+declare enum ScoringProfile {
+    Default = "default",
+    Agentic = "agentic",// Focus on AI agent navigation and signal
+    Logic = "logic",// Focus on testability and complexity
+    UI = "ui",// Focus on consistency and context (lower penalty for magic literals)
+    Cost = "cost",// Focus on token waste (duplication and fragmentation)
+    Security = "security"
+}
+/**
+ * Project-type-aware tool weight presets.
+ */
+declare const SCORING_PROFILES: Record<ScoringProfile, Record<string, number>>;
 /**
  * Context budget thresholds per tier.
  */
@@ -995,16 +1010,17 @@ declare function getRecommendedThreshold(fileCount: number, modelTier?: ModelCon
  */
 declare function normalizeToolName(shortName: string): string;
 /**
- * Retrieve the weight for a specific tool, considering overrides
+ * Retrieve the weight for a specific tool, considering overrides and profiles
  *
  * @param toolName The canonical tool ID
  * @param toolConfig Optional configuration for the tool containing a weight
  * @param cliOverride Optional weight override from the CLI
+ * @param profile Optional scoring profile to use
  * @returns The weight to be used for this tool in overall scoring
  */
 declare function getToolWeight(toolName: string, toolConfig?: {
     scoreWeight?: number;
-}, cliOverride?: number): number;
+}, cliOverride?: number, profile?: ScoringProfile): number;
 /**
  * Parse a comma-separated weight string (e.g. "patterns:30,context:10")
  *
@@ -1075,4 +1091,4 @@ declare function formatToolScore(output: ToolScoringOutput): string;
  */
 declare function generateHTML(graph: GraphData): string;
 
-export { type AIReadyConfig, type AcceptancePrediction, type AiSignalClarityConfig, type AnalysisResult, AnalysisResultSchema, AnalysisStatus, AnalysisStatusSchema, type BaseToolConfig, type BusinessReport, COMMON_FINE_TUNING_OPTIONS, CONTEXT_TIER_THRESHOLDS, type CommonASTNode, type ComprehensionDifficulty, type ContextAnalyzerConfig, type CostConfig, DEFAULT_TOOL_WEIGHTS, type ExportInfo, FRIENDLY_TOOL_NAMES, GLOBAL_INFRA_OPTIONS, GLOBAL_SCAN_OPTIONS, type GraphData, type GraphEdge, type GraphIssueSeverity, type GraphMetadata, type GraphNode, type ImportInfo, type Issue, IssueSchema, IssueType, IssueTypeSchema, LANGUAGE_EXTENSIONS, Language, type LanguageConfig, type LanguageParser, type Location, LocationSchema, type Metrics, MetricsSchema, type ModelContextTier, ModelTier, ModelTierSchema, type NamingConsistencyConfig, type NamingConvention, ParseError, type ParseResult, type ParseStatistics, type PatternDetectConfig, type ProductivityImpact, ReadinessRating, RecommendationPriority, type Report, SIZE_ADJUSTED_THRESHOLDS, type ScanOptions, type ScoringConfig, type ScoringResult, Severity, SeveritySchema, type SourceLocation, type SourceRange, type SpokeOutput, SpokeOutputSchema, type SpokeSummary, SpokeSummarySchema, TOOL_NAME_MAP, type TechnicalValueChain, type TechnicalValueChainSummary, type TokenBudget, ToolName, ToolNameSchema, type ToolScoringOutput, type UnifiedReport, UnifiedReportSchema, calculateOverallScore, formatScore, formatToolScore, generateHTML, getProjectSizeTier, getRating, getRatingDisplay, getRatingWithContext, getRecommendedThreshold, getToolWeight, normalizeToolName, parseWeightString };
+export { type AIReadyConfig, type AcceptancePrediction, type AiSignalClarityConfig, type AnalysisResult, AnalysisResultSchema, AnalysisStatus, AnalysisStatusSchema, type BaseToolConfig, type BusinessReport, COMMON_FINE_TUNING_OPTIONS, CONTEXT_TIER_THRESHOLDS, type CommonASTNode, type ComprehensionDifficulty, type ContextAnalyzerConfig, type CostConfig, DEFAULT_TOOL_WEIGHTS, type ExportInfo, FRIENDLY_TOOL_NAMES, GLOBAL_INFRA_OPTIONS, GLOBAL_SCAN_OPTIONS, type GraphData, type GraphEdge, type GraphIssueSeverity, type GraphMetadata, type GraphNode, type ImportInfo, type Issue, IssueSchema, IssueType, IssueTypeSchema, LANGUAGE_EXTENSIONS, Language, type LanguageConfig, type LanguageParser, type Location, LocationSchema, type Metrics, MetricsSchema, type ModelContextTier, ModelTier, ModelTierSchema, type NamingConsistencyConfig, type NamingConvention, ParseError, type ParseResult, type ParseStatistics, type PatternDetectConfig, type ProductivityImpact, ReadinessRating, RecommendationPriority, type Report, SCORING_PROFILES, SIZE_ADJUSTED_THRESHOLDS, type ScanOptions, type ScoringConfig, ScoringProfile, type ScoringResult, Severity, SeveritySchema, type SourceLocation, type SourceRange, type SpokeOutput, SpokeOutputSchema, type SpokeSummary, SpokeSummarySchema, TOOL_NAME_MAP, type TechnicalValueChain, type TechnicalValueChainSummary, type TokenBudget, ToolName, ToolNameSchema, type ToolScoringOutput, type UnifiedReport, UnifiedReportSchema, calculateOverallScore, formatScore, formatToolScore, generateHTML, getProjectSizeTier, getRating, getRatingDisplay, getRatingWithContext, getRecommendedThreshold, getToolWeight, normalizeToolName, parseWeightString };

package/dist/client.d.ts

@@ -960,6 +960,21 @@ declare const TOOL_NAME_MAP: Record<string, string>;
  * Model context tiers for context-aware threshold calibration.
  */
 type ModelContextTier = 'compact' | 'standard' | 'extended' | 'frontier';
+/**
+ * Scoring profiles for project-type-aware weighting.
+ */
+declare enum ScoringProfile {
+    Default = "default",
+    Agentic = "agentic",// Focus on AI agent navigation and signal
+    Logic = "logic",// Focus on testability and complexity
+    UI = "ui",// Focus on consistency and context (lower penalty for magic literals)
+    Cost = "cost",// Focus on token waste (duplication and fragmentation)
+    Security = "security"
+}
+/**
+ * Project-type-aware tool weight presets.
+ */
+declare const SCORING_PROFILES: Record<ScoringProfile, Record<string, number>>;
 /**
  * Context budget thresholds per tier.
  */
@@ -995,16 +1010,17 @@ declare function getRecommendedThreshold(fileCount: number, modelTier?: ModelCon
  */
 declare function normalizeToolName(shortName: string): string;
 /**
- * Retrieve the weight for a specific tool, considering overrides
+ * Retrieve the weight for a specific tool, considering overrides and profiles
  *
  * @param toolName The canonical tool ID
  * @param toolConfig Optional configuration for the tool containing a weight
  * @param cliOverride Optional weight override from the CLI
+ * @param profile Optional scoring profile to use
  * @returns The weight to be used for this tool in overall scoring
  */
 declare function getToolWeight(toolName: string, toolConfig?: {
     scoreWeight?: number;
-}, cliOverride?: number): number;
+}, cliOverride?: number, profile?: ScoringProfile): number;
 /**
  * Parse a comma-separated weight string (e.g. "patterns:30,context:10")
  *
@@ -1075,4 +1091,4 @@ declare function formatToolScore(output: ToolScoringOutput): string;
  */
 declare function generateHTML(graph: GraphData): string;
 
-export { type AIReadyConfig, type AcceptancePrediction, type AiSignalClarityConfig, type AnalysisResult, AnalysisResultSchema, AnalysisStatus, AnalysisStatusSchema, type BaseToolConfig, type BusinessReport, COMMON_FINE_TUNING_OPTIONS, CONTEXT_TIER_THRESHOLDS, type CommonASTNode, type ComprehensionDifficulty, type ContextAnalyzerConfig, type CostConfig, DEFAULT_TOOL_WEIGHTS, type ExportInfo, FRIENDLY_TOOL_NAMES, GLOBAL_INFRA_OPTIONS, GLOBAL_SCAN_OPTIONS, type GraphData, type GraphEdge, type GraphIssueSeverity, type GraphMetadata, type GraphNode, type ImportInfo, type Issue, IssueSchema, IssueType, IssueTypeSchema, LANGUAGE_EXTENSIONS, Language, type LanguageConfig, type LanguageParser, type Location, LocationSchema, type Metrics, MetricsSchema, type ModelContextTier, ModelTier, ModelTierSchema, type NamingConsistencyConfig, type NamingConvention, ParseError, type ParseResult, type ParseStatistics, type PatternDetectConfig, type ProductivityImpact, ReadinessRating, RecommendationPriority, type Report, SIZE_ADJUSTED_THRESHOLDS, type ScanOptions, type ScoringConfig, type ScoringResult, Severity, SeveritySchema, type SourceLocation, type SourceRange, type SpokeOutput, SpokeOutputSchema, type SpokeSummary, SpokeSummarySchema, TOOL_NAME_MAP, type TechnicalValueChain, type TechnicalValueChainSummary, type TokenBudget, ToolName, ToolNameSchema, type ToolScoringOutput, type UnifiedReport, UnifiedReportSchema, calculateOverallScore, formatScore, formatToolScore, generateHTML, getProjectSizeTier, getRating, getRatingDisplay, getRatingWithContext, getRecommendedThreshold, getToolWeight, normalizeToolName, parseWeightString };
+export { type AIReadyConfig, type AcceptancePrediction, type AiSignalClarityConfig, type AnalysisResult, AnalysisResultSchema, AnalysisStatus, AnalysisStatusSchema, type BaseToolConfig, type BusinessReport, COMMON_FINE_TUNING_OPTIONS, CONTEXT_TIER_THRESHOLDS, type CommonASTNode, type ComprehensionDifficulty, type ContextAnalyzerConfig, type CostConfig, DEFAULT_TOOL_WEIGHTS, type ExportInfo, FRIENDLY_TOOL_NAMES, GLOBAL_INFRA_OPTIONS, GLOBAL_SCAN_OPTIONS, type GraphData, type GraphEdge, type GraphIssueSeverity, type GraphMetadata, type GraphNode, type ImportInfo, type Issue, IssueSchema, IssueType, IssueTypeSchema, LANGUAGE_EXTENSIONS, Language, type LanguageConfig, type LanguageParser, type Location, LocationSchema, type Metrics, MetricsSchema, type ModelContextTier, ModelTier, ModelTierSchema, type NamingConsistencyConfig, type NamingConvention, ParseError, type ParseResult, type ParseStatistics, type PatternDetectConfig, type ProductivityImpact, ReadinessRating, RecommendationPriority, type Report, SCORING_PROFILES, SIZE_ADJUSTED_THRESHOLDS, type ScanOptions, type ScoringConfig, ScoringProfile, type ScoringResult, Severity, SeveritySchema, type SourceLocation, type SourceRange, type SpokeOutput, SpokeOutputSchema, type SpokeSummary, SpokeSummarySchema, TOOL_NAME_MAP, type TechnicalValueChain, type TechnicalValueChainSummary, type TokenBudget, ToolName, ToolNameSchema, type ToolScoringOutput, type UnifiedReport, UnifiedReportSchema, calculateOverallScore, formatScore, formatToolScore, generateHTML, getProjectSizeTier, getRating, getRatingDisplay, getRatingWithContext, getRecommendedThreshold, getToolWeight, normalizeToolName, parseWeightString };

package/dist/client.js

@@ -41,7 +41,9 @@ __export(client_exports, {
   ParseError: () => ParseError,
   ReadinessRating: () => ReadinessRating,
   RecommendationPriority: () => RecommendationPriority,
+  SCORING_PROFILES: () => SCORING_PROFILES,
   SIZE_ADJUSTED_THRESHOLDS: () => SIZE_ADJUSTED_THRESHOLDS,
+  ScoringProfile: () => ScoringProfile,
   Severity: () => Severity,
   SeveritySchema: () => SeveritySchema,
   SpokeOutputSchema: () => SpokeOutputSchema,
@@ -333,6 +335,51 @@ var TOOL_NAME_MAP = {
   "change-amp": "change-amplification" /* ChangeAmplification */,
   "change-amplification": "change-amplification" /* ChangeAmplification */
 };
+var ScoringProfile = /* @__PURE__ */ ((ScoringProfile2) => {
+  ScoringProfile2["Default"] = "default";
+  ScoringProfile2["Agentic"] = "agentic";
+  ScoringProfile2["Logic"] = "logic";
+  ScoringProfile2["UI"] = "ui";
+  ScoringProfile2["Cost"] = "cost";
+  ScoringProfile2["Security"] = "security";
+  return ScoringProfile2;
+})(ScoringProfile || {});
+var SCORING_PROFILES = {
+  ["default" /* Default */]: DEFAULT_TOOL_WEIGHTS,
+  ["agentic" /* Agentic */]: {
+    ["ai-signal-clarity" /* AiSignalClarity */]: 30,
+    ["agent-grounding" /* AgentGrounding */]: 30,
+    ["testability-index" /* TestabilityIndex */]: 20,
+    ["context-analyzer" /* ContextAnalyzer */]: 10,
+    ["naming-consistency" /* NamingConsistency */]: 10
+  },
+  ["logic" /* Logic */]: {
+    ["testability-index" /* TestabilityIndex */]: 40,
+    ["naming-consistency" /* NamingConsistency */]: 20,
+    ["context-analyzer" /* ContextAnalyzer */]: 20,
+    ["pattern-detect" /* PatternDetect */]: 10,
+    ["change-amplification" /* ChangeAmplification */]: 10
+  },
+  ["ui" /* UI */]: {
+    ["naming-consistency" /* NamingConsistency */]: 30,
+    ["context-analyzer" /* ContextAnalyzer */]: 30,
+    ["pattern-detect" /* PatternDetect */]: 20,
+    ["doc-drift" /* DocDrift */]: 10,
+    ["ai-signal-clarity" /* AiSignalClarity */]: 10
+  },
+  ["cost" /* Cost */]: {
+    ["pattern-detect" /* PatternDetect */]: 50,
+    ["context-analyzer" /* ContextAnalyzer */]: 30,
+    ["change-amplification" /* ChangeAmplification */]: 10,
+    ["dependency-health" /* DependencyHealth */]: 10
+  },
+  ["security" /* Security */]: {
+    ["naming-consistency" /* NamingConsistency */]: 40,
+    ["testability-index" /* TestabilityIndex */]: 30,
+    ["dependency-health" /* DependencyHealth */]: 20,
+    ["context-analyzer" /* ContextAnalyzer */]: 10
+  }
+};
 var CONTEXT_TIER_THRESHOLDS = {
   compact: { idealTokens: 3e3, criticalTokens: 1e4, idealDepth: 4 },
   standard: { idealTokens: 5e3, criticalTokens: 15e3, idealDepth: 5 },
@@ -367,10 +414,11 @@ function getRecommendedThreshold(fileCount, modelTier = "standard") {
 function normalizeToolName(shortName) {
   return TOOL_NAME_MAP[shortName.toLowerCase()] || shortName;
 }
-function getToolWeight(toolName, toolConfig, cliOverride) {
+function getToolWeight(toolName, toolConfig, cliOverride, profile = "default" /* Default */) {
   if (cliOverride !== void 0) return cliOverride;
   if (toolConfig?.scoreWeight !== void 0) return toolConfig.scoreWeight;
-  return DEFAULT_TOOL_WEIGHTS[toolName] || 5;
+  const profileWeights = SCORING_PROFILES[profile] || DEFAULT_TOOL_WEIGHTS;
+  return profileWeights[toolName] ?? DEFAULT_TOOL_WEIGHTS[toolName] ?? 5;
 }
 function parseWeightString(weightStr) {
   const weights = /* @__PURE__ */ new Map();
@@ -392,11 +440,12 @@ function calculateOverallScore(toolOutputs, config, cliWeights) {
   if (toolOutputs.size === 0) {
     throw new Error("No tool outputs provided for scoring");
   }
+  const profile = config?.scoring?.profile || "default" /* Default */;
   const weights = /* @__PURE__ */ new Map();
   for (const [toolName] of toolOutputs.entries()) {
     const cliWeight = cliWeights?.get(toolName);
     const configWeight = config?.tools?.[toolName]?.scoreWeight;
-    const weight = cliWeight ?? configWeight ?? DEFAULT_TOOL_WEIGHTS[toolName] ?? 5;
+    const weight = cliWeight ?? configWeight ?? getToolWeight(toolName, void 0, void 0, profile);
     weights.set(toolName, weight);
   }
   let weightedSum = 0;
@@ -688,7 +737,9 @@ function generateHTML(graph) {
   ParseError,
   ReadinessRating,
   RecommendationPriority,
+  SCORING_PROFILES,
   SIZE_ADJUSTED_THRESHOLDS,
+  ScoringProfile,
   Severity,
   SeveritySchema,
   SpokeOutputSchema,

package/dist/client.mjs

@@ -20,7 +20,9 @@ import {
   ParseError,
   ReadinessRating,
   RecommendationPriority,
+  SCORING_PROFILES,
   SIZE_ADJUSTED_THRESHOLDS,
+  ScoringProfile,
   Severity,
   SeveritySchema,
   SpokeOutputSchema,
@@ -41,7 +43,7 @@ import {
   getToolWeight,
   normalizeToolName,
   parseWeightString
-} from "./chunk-SWTDBVYJ.mjs";
+} from "./chunk-5HIXDC3X.mjs";
 export {
   AnalysisResultSchema,
   AnalysisStatus,
@@ -64,7 +66,9 @@ export {
   ParseError,
   ReadinessRating,
   RecommendationPriority,
+  SCORING_PROFILES,
   SIZE_ADJUSTED_THRESHOLDS,
+  ScoringProfile,
   Severity,
   SeveritySchema,
   SpokeOutputSchema,

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import { ToolName, ScanOptions, SpokeOutput, ToolScoringOutput, AIReadyConfig, ModelContextTier, CostConfig, TokenBudget, ProductivityImpact, AcceptancePrediction, ComprehensionDifficulty, TechnicalValueChainSummary, TechnicalValueChain, LanguageParser, Language, ExportInfo, ParseResult, NamingConvention } from './client.mjs';
-export { AiSignalClarityConfig, AnalysisResult, AnalysisResultSchema, AnalysisStatus, AnalysisStatusSchema, BaseToolConfig, BusinessReport, COMMON_FINE_TUNING_OPTIONS, CONTEXT_TIER_THRESHOLDS, CommonASTNode, ContextAnalyzerConfig, DEFAULT_TOOL_WEIGHTS, FRIENDLY_TOOL_NAMES, GLOBAL_INFRA_OPTIONS, GLOBAL_SCAN_OPTIONS, GraphData, GraphEdge, GraphIssueSeverity, GraphMetadata, GraphNode, ImportInfo, Issue, IssueSchema, IssueType, IssueTypeSchema, LANGUAGE_EXTENSIONS, LanguageConfig, Location, LocationSchema, Metrics, MetricsSchema, ModelTier, ModelTierSchema, NamingConsistencyConfig, ParseError, ParseStatistics, PatternDetectConfig, ReadinessRating, RecommendationPriority, Report, SIZE_ADJUSTED_THRESHOLDS, ScoringConfig, ScoringResult, Severity, SeveritySchema, SourceLocation, SourceRange, SpokeOutputSchema, SpokeSummary, SpokeSummarySchema, TOOL_NAME_MAP, ToolNameSchema, UnifiedReport, UnifiedReportSchema, calculateOverallScore, formatScore, formatToolScore, generateHTML, getProjectSizeTier, getRating, getRatingDisplay, getRatingWithContext, getRecommendedThreshold, getToolWeight, normalizeToolName, parseWeightString } from './client.mjs';
+export { AiSignalClarityConfig, AnalysisResult, AnalysisResultSchema, AnalysisStatus, AnalysisStatusSchema, BaseToolConfig, BusinessReport, COMMON_FINE_TUNING_OPTIONS, CONTEXT_TIER_THRESHOLDS, CommonASTNode, ContextAnalyzerConfig, DEFAULT_TOOL_WEIGHTS, FRIENDLY_TOOL_NAMES, GLOBAL_INFRA_OPTIONS, GLOBAL_SCAN_OPTIONS, GraphData, GraphEdge, GraphIssueSeverity, GraphMetadata, GraphNode, ImportInfo, Issue, IssueSchema, IssueType, IssueTypeSchema, LANGUAGE_EXTENSIONS, LanguageConfig, Location, LocationSchema, Metrics, MetricsSchema, ModelTier, ModelTierSchema, NamingConsistencyConfig, ParseError, ParseStatistics, PatternDetectConfig, ReadinessRating, RecommendationPriority, Report, SCORING_PROFILES, SIZE_ADJUSTED_THRESHOLDS, ScoringConfig, ScoringProfile, ScoringResult, Severity, SeveritySchema, SourceLocation, SourceRange, SpokeOutputSchema, SpokeSummary, SpokeSummarySchema, TOOL_NAME_MAP, ToolNameSchema, UnifiedReport, UnifiedReportSchema, calculateOverallScore, formatScore, formatToolScore, generateHTML, getProjectSizeTier, getRating, getRatingDisplay, getRatingWithContext, getRecommendedThreshold, getToolWeight, normalizeToolName, parseWeightString } from './client.mjs';
 import { z } from 'zod';
 import * as Parser from 'web-tree-sitter';
 import { TSESTree } from '@typescript-eslint/typescript-estree';
@@ -769,6 +769,7 @@ declare function calculateAiSignalClarity(params: {
     deepCallbacks: number;
     ambiguousNames: number;
     undocumentedExports: number;
+    largeFiles?: number;
     totalSymbols: number;
     totalExports: number;
 }): AiSignalClarity;
@@ -987,4 +988,28 @@ declare function getRepoMetadata(directory: string): {
     author?: string;
 };
 
-export { AIReadyConfig, type ASTNode, AcceptancePrediction, type AgentGroundingScore, type AiSignalClarity, type AiSignalClaritySignal, type CLIOptions, CSharpParser, type ChangeAmplificationScore, type CognitiveLoad, ComprehensionDifficulty, type ConceptCohesion, CostConfig, DEFAULT_COST_CONFIG, DEFAULT_EXCLUDE, type DependencyHealthScore, type DocDriftRisk, ExportInfo, type ExportWithImports, type FileImport, type FileWithDomain, GoParser, JavaParser, type KnowledgeConcentrationRisk, Language, LanguageParser, type LoadFactor, MODEL_PRICING_PRESETS, ModelContextTier, type ModelPricingPreset, NamingConvention, ParseResult, ParserFactory, type PatternEntropy, ProductivityImpact, PythonParser, SEVERITY_TIME_ESTIMATES, ScanOptions, type ScoreHistoryEntry, type ScoreTrend, type SemanticDistance, SpokeOutput, type TechnicalDebtInterest, TechnicalValueChain, TechnicalValueChainSummary, type TestabilityIndex, TokenBudget, ToolName, type ToolProvider, ToolRegistry, ToolScoringOutput, TypeScriptParser, VAGUE_FILE_NAMES, calculateAgentGrounding, calculateAiSignalClarity, calculateBusinessROI, calculateChangeAmplification, calculateCognitiveLoad, calculateComprehensionDifficulty, calculateConceptCohesion, calculateDebtInterest, calculateDependencyHealth, calculateDocDrift, calculateExtendedFutureProofScore, calculateFutureProofScore, calculateImportSimilarity, calculateKnowledgeConcentration, calculateMonthlyCost, calculatePatternEntropy, calculateProductivityImpact, calculateSemanticDistance, calculateTechnicalValueChain, calculateTestabilityIndex, calculateTokenBudget, clearHistory, emitProgress, estimateCostFromBudget, estimateTokens, exportHistory, extractFunctions, extractImports, formatAcceptanceRate, formatCost, formatHours, generateValueChain, getElapsedTime, getFileCommitTimestamps, getFileExtension, getHistorySummary, getLineRangeLastModifiedCached, getModelPreset, getParser, getRepoMetadata, getSafetyIcon, getScoreBar, getSeverityColor, getSupportedLanguages, getWasmPath, handleCLIError, handleJSONOutput, initTreeSitter, initializeParsers, isFileSupported, isSourceFile, loadConfig, loadMergedConfig, loadScoreHistory, mergeConfigWithDefaults, parseCode, parseFileExports, predictAcceptanceRate, readFileContent, resolveOutputPath, saveScoreEntry, scanEntries, scanFiles, setupParser, validateSpokeOutput, validateWithSchema };
+/**
+ * Utilities for GitHub Actions integration
+ */
+/**
+ * Emit a GitHub Action annotation
+ * Format: ::(error|warning|notice) file={file},line={line},col={col},title={title}::{message}
+ */
+declare function emitAnnotation(params: {
+    level: 'error' | 'warning' | 'notice';
+    file: string;
+    line?: number;
+    col?: number;
+    title?: string;
+    message: string;
+}): void;
+/**
+ * Map AIReady severity to GitHub Action annotation level
+ */
+declare function severityToAnnotationLevel(severity: string): 'error' | 'warning' | 'notice';
+/**
+ * Emit multiple annotations from an array of issues
+ */
+declare function emitIssuesAsAnnotations(issues: any[]): void;
+
+export { AIReadyConfig, type ASTNode, AcceptancePrediction, type AgentGroundingScore, type AiSignalClarity, type AiSignalClaritySignal, type CLIOptions, CSharpParser, type ChangeAmplificationScore, type CognitiveLoad, ComprehensionDifficulty, type ConceptCohesion, CostConfig, DEFAULT_COST_CONFIG, DEFAULT_EXCLUDE, type DependencyHealthScore, type DocDriftRisk, ExportInfo, type ExportWithImports, type FileImport, type FileWithDomain, GoParser, JavaParser, type KnowledgeConcentrationRisk, Language, LanguageParser, type LoadFactor, MODEL_PRICING_PRESETS, ModelContextTier, type ModelPricingPreset, NamingConvention, ParseResult, ParserFactory, type PatternEntropy, ProductivityImpact, PythonParser, SEVERITY_TIME_ESTIMATES, ScanOptions, type ScoreHistoryEntry, type ScoreTrend, type SemanticDistance, SpokeOutput, type TechnicalDebtInterest, TechnicalValueChain, TechnicalValueChainSummary, type TestabilityIndex, TokenBudget, ToolName, type ToolProvider, ToolRegistry, ToolScoringOutput, TypeScriptParser, VAGUE_FILE_NAMES, calculateAgentGrounding, calculateAiSignalClarity, calculateBusinessROI, calculateChangeAmplification, calculateCognitiveLoad, calculateComprehensionDifficulty, calculateConceptCohesion, calculateDebtInterest, calculateDependencyHealth, calculateDocDrift, calculateExtendedFutureProofScore, calculateFutureProofScore, calculateImportSimilarity, calculateKnowledgeConcentration, calculateMonthlyCost, calculatePatternEntropy, calculateProductivityImpact, calculateSemanticDistance, calculateTechnicalValueChain, calculateTestabilityIndex, calculateTokenBudget, clearHistory, emitAnnotation, emitIssuesAsAnnotations, emitProgress, estimateCostFromBudget, estimateTokens, exportHistory, extractFunctions, extractImports, formatAcceptanceRate, formatCost, formatHours, generateValueChain, getElapsedTime, getFileCommitTimestamps, getFileExtension, getHistorySummary, getLineRangeLastModifiedCached, getModelPreset, getParser, getRepoMetadata, getSafetyIcon, getScoreBar, getSeverityColor, getSupportedLanguages, getWasmPath, handleCLIError, handleJSONOutput, initTreeSitter, initializeParsers, isFileSupported, isSourceFile, loadConfig, loadMergedConfig, loadScoreHistory, mergeConfigWithDefaults, parseCode, parseFileExports, predictAcceptanceRate, readFileContent, resolveOutputPath, saveScoreEntry, scanEntries, scanFiles, setupParser, severityToAnnotationLevel, validateSpokeOutput, validateWithSchema };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { ToolName, ScanOptions, SpokeOutput, ToolScoringOutput, AIReadyConfig, ModelContextTier, CostConfig, TokenBudget, ProductivityImpact, AcceptancePrediction, ComprehensionDifficulty, TechnicalValueChainSummary, TechnicalValueChain, LanguageParser, Language, ExportInfo, ParseResult, NamingConvention } from './client.js';
-export { AiSignalClarityConfig, AnalysisResult, AnalysisResultSchema, AnalysisStatus, AnalysisStatusSchema, BaseToolConfig, BusinessReport, COMMON_FINE_TUNING_OPTIONS, CONTEXT_TIER_THRESHOLDS, CommonASTNode, ContextAnalyzerConfig, DEFAULT_TOOL_WEIGHTS, FRIENDLY_TOOL_NAMES, GLOBAL_INFRA_OPTIONS, GLOBAL_SCAN_OPTIONS, GraphData, GraphEdge, GraphIssueSeverity, GraphMetadata, GraphNode, ImportInfo, Issue, IssueSchema, IssueType, IssueTypeSchema, LANGUAGE_EXTENSIONS, LanguageConfig, Location, LocationSchema, Metrics, MetricsSchema, ModelTier, ModelTierSchema, NamingConsistencyConfig, ParseError, ParseStatistics, PatternDetectConfig, ReadinessRating, RecommendationPriority, Report, SIZE_ADJUSTED_THRESHOLDS, ScoringConfig, ScoringResult, Severity, SeveritySchema, SourceLocation, SourceRange, SpokeOutputSchema, SpokeSummary, SpokeSummarySchema, TOOL_NAME_MAP, ToolNameSchema, UnifiedReport, UnifiedReportSchema, calculateOverallScore, formatScore, formatToolScore, generateHTML, getProjectSizeTier, getRating, getRatingDisplay, getRatingWithContext, getRecommendedThreshold, getToolWeight, normalizeToolName, parseWeightString } from './client.js';
+export { AiSignalClarityConfig, AnalysisResult, AnalysisResultSchema, AnalysisStatus, AnalysisStatusSchema, BaseToolConfig, BusinessReport, COMMON_FINE_TUNING_OPTIONS, CONTEXT_TIER_THRESHOLDS, CommonASTNode, ContextAnalyzerConfig, DEFAULT_TOOL_WEIGHTS, FRIENDLY_TOOL_NAMES, GLOBAL_INFRA_OPTIONS, GLOBAL_SCAN_OPTIONS, GraphData, GraphEdge, GraphIssueSeverity, GraphMetadata, GraphNode, ImportInfo, Issue, IssueSchema, IssueType, IssueTypeSchema, LANGUAGE_EXTENSIONS, LanguageConfig, Location, LocationSchema, Metrics, MetricsSchema, ModelTier, ModelTierSchema, NamingConsistencyConfig, ParseError, ParseStatistics, PatternDetectConfig, ReadinessRating, RecommendationPriority, Report, SCORING_PROFILES, SIZE_ADJUSTED_THRESHOLDS, ScoringConfig, ScoringProfile, ScoringResult, Severity, SeveritySchema, SourceLocation, SourceRange, SpokeOutputSchema, SpokeSummary, SpokeSummarySchema, TOOL_NAME_MAP, ToolNameSchema, UnifiedReport, UnifiedReportSchema, calculateOverallScore, formatScore, formatToolScore, generateHTML, getProjectSizeTier, getRating, getRatingDisplay, getRatingWithContext, getRecommendedThreshold, getToolWeight, normalizeToolName, parseWeightString } from './client.js';
 import { z } from 'zod';
 import * as Parser from 'web-tree-sitter';
 import { TSESTree } from '@typescript-eslint/typescript-estree';
@@ -769,6 +769,7 @@ declare function calculateAiSignalClarity(params: {
     deepCallbacks: number;
     ambiguousNames: number;
     undocumentedExports: number;
+    largeFiles?: number;
     totalSymbols: number;
     totalExports: number;
 }): AiSignalClarity;
@@ -987,4 +988,28 @@ declare function getRepoMetadata(directory: string): {
     author?: string;
 };
 
-export { AIReadyConfig, type ASTNode, AcceptancePrediction, type AgentGroundingScore, type AiSignalClarity, type AiSignalClaritySignal, type CLIOptions, CSharpParser, type ChangeAmplificationScore, type CognitiveLoad, ComprehensionDifficulty, type ConceptCohesion, CostConfig, DEFAULT_COST_CONFIG, DEFAULT_EXCLUDE, type DependencyHealthScore, type DocDriftRisk, ExportInfo, type ExportWithImports, type FileImport, type FileWithDomain, GoParser, JavaParser, type KnowledgeConcentrationRisk, Language, LanguageParser, type LoadFactor, MODEL_PRICING_PRESETS, ModelContextTier, type ModelPricingPreset, NamingConvention, ParseResult, ParserFactory, type PatternEntropy, ProductivityImpact, PythonParser, SEVERITY_TIME_ESTIMATES, ScanOptions, type ScoreHistoryEntry, type ScoreTrend, type SemanticDistance, SpokeOutput, type TechnicalDebtInterest, TechnicalValueChain, TechnicalValueChainSummary, type TestabilityIndex, TokenBudget, ToolName, type ToolProvider, ToolRegistry, ToolScoringOutput, TypeScriptParser, VAGUE_FILE_NAMES, calculateAgentGrounding, calculateAiSignalClarity, calculateBusinessROI, calculateChangeAmplification, calculateCognitiveLoad, calculateComprehensionDifficulty, calculateConceptCohesion, calculateDebtInterest, calculateDependencyHealth, calculateDocDrift, calculateExtendedFutureProofScore, calculateFutureProofScore, calculateImportSimilarity, calculateKnowledgeConcentration, calculateMonthlyCost, calculatePatternEntropy, calculateProductivityImpact, calculateSemanticDistance, calculateTechnicalValueChain, calculateTestabilityIndex, calculateTokenBudget, clearHistory, emitProgress, estimateCostFromBudget, estimateTokens, exportHistory, extractFunctions, extractImports, formatAcceptanceRate, formatCost, formatHours, generateValueChain, getElapsedTime, getFileCommitTimestamps, getFileExtension, getHistorySummary, getLineRangeLastModifiedCached, getModelPreset, getParser, getRepoMetadata, getSafetyIcon, getScoreBar, getSeverityColor, getSupportedLanguages, getWasmPath, handleCLIError, handleJSONOutput, initTreeSitter, initializeParsers, isFileSupported, isSourceFile, loadConfig, loadMergedConfig, loadScoreHistory, mergeConfigWithDefaults, parseCode, parseFileExports, predictAcceptanceRate, readFileContent, resolveOutputPath, saveScoreEntry, scanEntries, scanFiles, setupParser, validateSpokeOutput, validateWithSchema };
+/**
+ * Utilities for GitHub Actions integration
+ */
+/**
+ * Emit a GitHub Action annotation
+ * Format: ::(error|warning|notice) file={file},line={line},col={col},title={title}::{message}
+ */
+declare function emitAnnotation(params: {
+    level: 'error' | 'warning' | 'notice';
+    file: string;
+    line?: number;
+    col?: number;
+    title?: string;
+    message: string;
+}): void;
+/**
+ * Map AIReady severity to GitHub Action annotation level
+ */
+declare function severityToAnnotationLevel(severity: string): 'error' | 'warning' | 'notice';
+/**
+ * Emit multiple annotations from an array of issues
+ */
+declare function emitIssuesAsAnnotations(issues: any[]): void;
+
+export { AIReadyConfig, type ASTNode, AcceptancePrediction, type AgentGroundingScore, type AiSignalClarity, type AiSignalClaritySignal, type CLIOptions, CSharpParser, type ChangeAmplificationScore, type CognitiveLoad, ComprehensionDifficulty, type ConceptCohesion, CostConfig, DEFAULT_COST_CONFIG, DEFAULT_EXCLUDE, type DependencyHealthScore, type DocDriftRisk, ExportInfo, type ExportWithImports, type FileImport, type FileWithDomain, GoParser, JavaParser, type KnowledgeConcentrationRisk, Language, LanguageParser, type LoadFactor, MODEL_PRICING_PRESETS, ModelContextTier, type ModelPricingPreset, NamingConvention, ParseResult, ParserFactory, type PatternEntropy, ProductivityImpact, PythonParser, SEVERITY_TIME_ESTIMATES, ScanOptions, type ScoreHistoryEntry, type ScoreTrend, type SemanticDistance, SpokeOutput, type TechnicalDebtInterest, TechnicalValueChain, TechnicalValueChainSummary, type TestabilityIndex, TokenBudget, ToolName, type ToolProvider, ToolRegistry, ToolScoringOutput, TypeScriptParser, VAGUE_FILE_NAMES, calculateAgentGrounding, calculateAiSignalClarity, calculateBusinessROI, calculateChangeAmplification, calculateCognitiveLoad, calculateComprehensionDifficulty, calculateConceptCohesion, calculateDebtInterest, calculateDependencyHealth, calculateDocDrift, calculateExtendedFutureProofScore, calculateFutureProofScore, calculateImportSimilarity, calculateKnowledgeConcentration, calculateMonthlyCost, calculatePatternEntropy, calculateProductivityImpact, calculateSemanticDistance, calculateTechnicalValueChain, calculateTestabilityIndex, calculateTokenBudget, clearHistory, emitAnnotation, emitIssuesAsAnnotations, emitProgress, estimateCostFromBudget, estimateTokens, exportHistory, extractFunctions, extractImports, formatAcceptanceRate, formatCost, formatHours, generateValueChain, getElapsedTime, getFileCommitTimestamps, getFileExtension, getHistorySummary, getLineRangeLastModifiedCached, getModelPreset, getParser, getRepoMetadata, getSafetyIcon, getScoreBar, getSeverityColor, getSupportedLanguages, getWasmPath, handleCLIError, handleJSONOutput, initTreeSitter, initializeParsers, isFileSupported, isSourceFile, loadConfig, loadMergedConfig, loadScoreHistory, mergeConfigWithDefaults, parseCode, parseFileExports, predictAcceptanceRate, readFileContent, resolveOutputPath, saveScoreEntry, scanEntries, scanFiles, setupParser, severityToAnnotationLevel, validateSpokeOutput, validateWithSchema };

package/dist/index.js

@@ -59,8 +59,10 @@ __export(index_exports, {
   PythonParser: () => PythonParser,
   ReadinessRating: () => ReadinessRating,
   RecommendationPriority: () => RecommendationPriority,
+  SCORING_PROFILES: () => SCORING_PROFILES,
   SEVERITY_TIME_ESTIMATES: () => SEVERITY_TIME_ESTIMATES,
   SIZE_ADJUSTED_THRESHOLDS: () => SIZE_ADJUSTED_THRESHOLDS,
+  ScoringProfile: () => ScoringProfile,
   Severity: () => Severity,
   SeveritySchema: () => SeveritySchema,
   SpokeOutputSchema: () => SpokeOutputSchema,
@@ -95,6 +97,8 @@ __export(index_exports, {
   calculateTestabilityIndex: () => calculateTestabilityIndex,
   calculateTokenBudget: () => calculateTokenBudget,
   clearHistory: () => clearHistory,
+  emitAnnotation: () => emitAnnotation,
+  emitIssuesAsAnnotations: () => emitIssuesAsAnnotations,
   emitProgress: () => emitProgress,
   estimateCostFromBudget: () => estimateCostFromBudget,
   estimateTokens: () => estimateTokens,
@@ -148,6 +152,7 @@ __export(index_exports, {
   scanEntries: () => scanEntries,
   scanFiles: () => scanFiles,
   setupParser: () => setupParser,
+  severityToAnnotationLevel: () => severityToAnnotationLevel,
   validateSpokeOutput: () => validateSpokeOutput,
   validateWithSchema: () => validateWithSchema
 });
@@ -3174,6 +3179,51 @@ var TOOL_NAME_MAP = {
   "change-amp": "change-amplification" /* ChangeAmplification */,
   "change-amplification": "change-amplification" /* ChangeAmplification */
 };
+var ScoringProfile = /* @__PURE__ */ ((ScoringProfile2) => {
+  ScoringProfile2["Default"] = "default";
+  ScoringProfile2["Agentic"] = "agentic";
+  ScoringProfile2["Logic"] = "logic";
+  ScoringProfile2["UI"] = "ui";
+  ScoringProfile2["Cost"] = "cost";
+  ScoringProfile2["Security"] = "security";
+  return ScoringProfile2;
+})(ScoringProfile || {});
+var SCORING_PROFILES = {
+  ["default" /* Default */]: DEFAULT_TOOL_WEIGHTS,
+  ["agentic" /* Agentic */]: {
+    ["ai-signal-clarity" /* AiSignalClarity */]: 30,
+    ["agent-grounding" /* AgentGrounding */]: 30,
+    ["testability-index" /* TestabilityIndex */]: 20,
+    ["context-analyzer" /* ContextAnalyzer */]: 10,
+    ["naming-consistency" /* NamingConsistency */]: 10
+  },
+  ["logic" /* Logic */]: {
+    ["testability-index" /* TestabilityIndex */]: 40,
+    ["naming-consistency" /* NamingConsistency */]: 20,
+    ["context-analyzer" /* ContextAnalyzer */]: 20,
+    ["pattern-detect" /* PatternDetect */]: 10,
+    ["change-amplification" /* ChangeAmplification */]: 10
+  },
+  ["ui" /* UI */]: {
+    ["naming-consistency" /* NamingConsistency */]: 30,
+    ["context-analyzer" /* ContextAnalyzer */]: 30,
+    ["pattern-detect" /* PatternDetect */]: 20,
+    ["doc-drift" /* DocDrift */]: 10,
+    ["ai-signal-clarity" /* AiSignalClarity */]: 10
+  },
+  ["cost" /* Cost */]: {
+    ["pattern-detect" /* PatternDetect */]: 50,
+    ["context-analyzer" /* ContextAnalyzer */]: 30,
+    ["change-amplification" /* ChangeAmplification */]: 10,
+    ["dependency-health" /* DependencyHealth */]: 10
+  },
+  ["security" /* Security */]: {
+    ["naming-consistency" /* NamingConsistency */]: 40,
+    ["testability-index" /* TestabilityIndex */]: 30,
+    ["dependency-health" /* DependencyHealth */]: 20,
+    ["context-analyzer" /* ContextAnalyzer */]: 10
+  }
+};
 var CONTEXT_TIER_THRESHOLDS = {
   compact: { idealTokens: 3e3, criticalTokens: 1e4, idealDepth: 4 },
   standard: { idealTokens: 5e3, criticalTokens: 15e3, idealDepth: 5 },
@@ -3208,10 +3258,11 @@ function getRecommendedThreshold(fileCount, modelTier = "standard") {
 function normalizeToolName(shortName) {
   return TOOL_NAME_MAP[shortName.toLowerCase()] || shortName;
 }
-function getToolWeight(toolName, toolConfig, cliOverride) {
+function getToolWeight(toolName, toolConfig, cliOverride, profile = "default" /* Default */) {
   if (cliOverride !== void 0) return cliOverride;
   if (toolConfig?.scoreWeight !== void 0) return toolConfig.scoreWeight;
-  return DEFAULT_TOOL_WEIGHTS[toolName] || 5;
+  const profileWeights = SCORING_PROFILES[profile] || DEFAULT_TOOL_WEIGHTS;
+  return profileWeights[toolName] ?? DEFAULT_TOOL_WEIGHTS[toolName] ?? 5;
 }
 function parseWeightString(weightStr) {
   const weights = /* @__PURE__ */ new Map();
@@ -3233,11 +3284,12 @@ function calculateOverallScore(toolOutputs, config, cliWeights) {
   if (toolOutputs.size === 0) {
     throw new Error("No tool outputs provided for scoring");
   }
+  const profile = config?.scoring?.profile || "default" /* Default */;
   const weights = /* @__PURE__ */ new Map();
   for (const [toolName] of toolOutputs.entries()) {
     const cliWeight = cliWeights?.get(toolName);
     const configWeight = config?.tools?.[toolName]?.scoreWeight;
-    const weight = cliWeight ?? configWeight ?? DEFAULT_TOOL_WEIGHTS[toolName] ?? 5;
+    const weight = cliWeight ?? configWeight ?? getToolWeight(toolName, void 0, void 0, profile);
     weights.set(toolName, weight);
   }
   let weightedSum = 0;
@@ -4011,6 +4063,8 @@ function calculateAiSignalClarity(params) {
     deepCallbacks,
     ambiguousNames,
     undocumentedExports,
+    largeFiles = 0,
+    // Default to 0 to prevent NaN
     totalSymbols,
     totalExports
   } = params;
@@ -4027,28 +4081,35 @@ function calculateAiSignalClarity(params) {
   const overloadSignal = {
     name: "Symbol Overloading",
     count: overloadedSymbols,
-    riskContribution: Math.round(Math.min(1, overloadRatio) * 100 * 0.25),
+    riskContribution: Math.round(Math.min(1, overloadRatio) * 100 * 0.2),
     description: `${overloadedSymbols} overloaded symbols \u2014 AI picks wrong signature`
   };
+  const largeFileSignal = {
+    name: "Large Files",
+    count: largeFiles,
+    riskContribution: Math.round(Math.min(5, largeFiles) * 5),
+    // up to 25 points
+    description: `${largeFiles} large files \u2014 pushing AI context limits`
+  };
   const magicRatio = magicLiterals / Math.max(1, totalSymbols * 2);
   const magicSignal = {
     name: "Magic Literals",
     count: magicLiterals,
-    riskContribution: Math.round(Math.min(1, magicRatio) * 100 * 0.2),
+    riskContribution: Math.round(Math.min(1, magicRatio) * 100 * 0.15),
     description: `${magicLiterals} unnamed constants \u2014 AI invents wrong values`
   };
   const trapRatio = booleanTraps / Math.max(1, totalSymbols);
   const trapSignal = {
     name: "Boolean Traps",
     count: booleanTraps,
-    riskContribution: Math.round(Math.min(1, trapRatio) * 100 * 0.2),
+    riskContribution: Math.round(Math.min(1, trapRatio) * 100 * 0.15),
     description: `${booleanTraps} boolean trap parameters \u2014 AI inverts intent`
   };
   const sideEffectRatio = implicitSideEffects / Math.max(1, totalExports);
   const sideEffectSignal = {
     name: "Implicit Side Effects",
     count: implicitSideEffects,
-    riskContribution: Math.round(Math.min(1, sideEffectRatio) * 100 * 0.15),
+    riskContribution: Math.round(Math.min(1, sideEffectRatio) * 100 * 0.1),
     description: `${implicitSideEffects} functions with implicit side effects \u2014 AI misses contracts`
   };
   const callbackRatio = deepCallbacks / Math.max(1, totalSymbols * 0.1);
@@ -4062,18 +4123,19 @@ function calculateAiSignalClarity(params) {
   const ambiguousSignal = {
     name: "Ambiguous Names",
     count: ambiguousNames,
-    riskContribution: Math.round(Math.min(1, ambiguousRatio) * 100 * 0.1),
+    riskContribution: Math.round(Math.min(1, ambiguousRatio) * 100 * 0.05),
     description: `${ambiguousNames} non-descriptive identifiers \u2014 AI guesses wrong intent`
   };
   const undocRatio = undocumentedExports / Math.max(1, totalExports);
   const undocSignal = {
     name: "Undocumented Exports",
     count: undocumentedExports,
-    riskContribution: Math.round(Math.min(1, undocRatio) * 100 * 0.1),
+    riskContribution: Math.round(Math.min(1, undocRatio) * 100 * 0.05),
     description: `${undocumentedExports} public functions without docs \u2014 AI fabricates behavior`
   };
   const signals = [
     overloadSignal,
+    largeFileSignal,
     magicSignal,
     trapSignal,
     sideEffectSignal,
@@ -4096,6 +4158,10 @@ function calculateAiSignalClarity(params) {
   );
   const topRisk = topSignal.riskContribution > 0 ? topSignal.description : "No significant issues detected";
   const recommendations = [];
+  if (largeFileSignal.riskContribution > 5)
+    recommendations.push(
+      `Split ${largeFiles} large files (> 500 lines) into smaller, single-responsibility modules`
+    );
   if (overloadSignal.riskContribution > 5)
     recommendations.push(
       `Rename ${overloadedSymbols} overloaded symbols to unique, intent-revealing names`
@@ -4731,6 +4797,46 @@ function getRepoMetadata(directory) {
   }
   return metadata;
 }
+
+// src/utils/github-utils.ts
+function emitAnnotation(params) {
+  const { level, file, line, col, title, message } = params;
+  const parts = [];
+  if (file) parts.push(`file=${file}`);
+  if (line) parts.push(`line=${line}`);
+  if (col) parts.push(`col=${col}`);
+  if (title) parts.push(`title=${title}`);
+  const metadata = parts.length > 0 ? ` ${parts.join(",")}` : "";
+  console.log(`::${level}${metadata}::${message.replace(/\n/g, "%0A")}`);
+}
+function severityToAnnotationLevel(severity) {
+  switch (severity.toLowerCase()) {
+    case "critical":
+    case "high-risk":
+    case "blind-risk":
+      return "error";
+    case "major":
+    case "moderate-risk":
+      return "warning";
+    case "minor":
+    case "info":
+    case "safe":
+    default:
+      return "notice";
+  }
+}
+function emitIssuesAsAnnotations(issues) {
+  issues.forEach((issue) => {
+    emitAnnotation({
+      level: severityToAnnotationLevel(issue.severity || "info"),
+      file: issue.file || issue.fileName || "",
+      line: issue.line || issue.location?.start?.line,
+      col: issue.column || issue.location?.start?.column,
+      title: `${issue.tool || "AIReady"}: ${issue.type || "Issue"}`,
+      message: issue.message || issue.description || "No description provided"
+    });
+  });
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AnalysisResultSchema,
@@ -4762,8 +4868,10 @@ function getRepoMetadata(directory) {
   PythonParser,
   ReadinessRating,
   RecommendationPriority,
+  SCORING_PROFILES,
   SEVERITY_TIME_ESTIMATES,
   SIZE_ADJUSTED_THRESHOLDS,
+  ScoringProfile,
   Severity,
   SeveritySchema,
   SpokeOutputSchema,
@@ -4798,6 +4906,8 @@ function getRepoMetadata(directory) {
   calculateTestabilityIndex,
   calculateTokenBudget,
   clearHistory,
+  emitAnnotation,
+  emitIssuesAsAnnotations,
   emitProgress,
   estimateCostFromBudget,
   estimateTokens,
@@ -4851,6 +4961,7 @@ function getRepoMetadata(directory) {
   scanEntries,
   scanFiles,
   setupParser,
+  severityToAnnotationLevel,
   validateSpokeOutput,
   validateWithSchema
 });