@aiready/core 0.21.10 → 0.21.13

package/dist/client.d.ts

@@ -433,8 +433,15 @@ interface ScanOptions {
     includeTests?: boolean;
 }
 /**
- * Global options that should not be repeated in tool-specific audit logs
+ * Global infrastructure options that apply to the whole scan process.
+ * These are passed to all tools but usually omitted from tool-specific audit logs
+ * to avoid redundancy.
  */
+declare const GLOBAL_INFRA_OPTIONS: string[];
+/**
+ * Common fine-tuning options that might be passed globally but are actually tool-specific.
+ */
+declare const COMMON_FINE_TUNING_OPTIONS: string[];
 declare const GLOBAL_SCAN_OPTIONS: string[];
 interface AIReadyConfig {
     scan?: {
@@ -551,6 +558,7 @@ interface Report {
         overallScore: number;
         tokenCostTotal: number;
         avgConsistency: number;
+        executionTime?: number;
     };
 }
 /**
@@ -595,6 +603,8 @@ interface GraphMetadata {
     infoIssues: number;
     /** AI token budget unit economics (v0.13+) */
     tokenBudget?: TokenBudget;
+    /** Execution time in milliseconds */
+    executionTime?: number;
 }
 /**
  * Complete graph data structure for visualization
@@ -923,4 +933,4 @@ declare function formatToolScore(output: ToolScoringOutput): string;
  */
 declare function generateHTML(graph: GraphData): string;
 
-export { type AIReadyConfig, type AcceptancePrediction, type AnalysisResult, AnalysisResultSchema, AnalysisStatus, AnalysisStatusSchema, type BusinessReport, CONTEXT_TIER_THRESHOLDS, type CommonASTNode, type ComprehensionDifficulty, type CostConfig, DEFAULT_TOOL_WEIGHTS, type ExportInfo, FRIENDLY_TOOL_NAMES, 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 NamingConvention, ParseError, type ParseResult, type ParseStatistics, type ProductivityImpact, 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 AnalysisResult, AnalysisResultSchema, AnalysisStatus, AnalysisStatusSchema, type BusinessReport, COMMON_FINE_TUNING_OPTIONS, CONTEXT_TIER_THRESHOLDS, type CommonASTNode, type ComprehensionDifficulty, 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 NamingConvention, ParseError, type ParseResult, type ParseStatistics, type ProductivityImpact, 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 };

package/dist/client.js

@@ -23,9 +23,11 @@ __export(client_exports, {
   AnalysisResultSchema: () => AnalysisResultSchema,
   AnalysisStatus: () => AnalysisStatus,
   AnalysisStatusSchema: () => AnalysisStatusSchema,
+  COMMON_FINE_TUNING_OPTIONS: () => COMMON_FINE_TUNING_OPTIONS,
   CONTEXT_TIER_THRESHOLDS: () => CONTEXT_TIER_THRESHOLDS,
   DEFAULT_TOOL_WEIGHTS: () => DEFAULT_TOOL_WEIGHTS,
   FRIENDLY_TOOL_NAMES: () => FRIENDLY_TOOL_NAMES,
+  GLOBAL_INFRA_OPTIONS: () => GLOBAL_INFRA_OPTIONS,
   GLOBAL_SCAN_OPTIONS: () => GLOBAL_SCAN_OPTIONS,
   IssueSchema: () => IssueSchema,
   IssueType: () => IssueType,
@@ -218,21 +220,35 @@ var UnifiedReportSchema = import_zod.z.object({
 }).catchall(import_zod.z.any());
 
 // src/types.ts
-var GLOBAL_SCAN_OPTIONS = [
+var GLOBAL_INFRA_OPTIONS = [
   "rootDir",
-  "tools",
-  "toolConfigs",
+  // Essential for every tool
   "include",
   "exclude",
   "onProgress",
   "progressCallback",
   "includeTests",
   "useSmartDefaults",
-  "maxDepth",
   "streamResults",
   "batchSize",
-  "costConfig"
+  "costConfig",
+  "tools",
+  "toolConfigs"
+];
+var COMMON_FINE_TUNING_OPTIONS = [
+  "maxDepth",
+  "minSimilarity",
+  "minLines",
+  "minCohesion",
+  // AI Signal Clarity options
+  "checkMagicLiterals",
+  "checkBooleanTraps",
+  "checkAmbiguousNames",
+  "checkUndocumentedExports",
+  "checkImplicitSideEffects",
+  "checkDeepCallbacks"
 ];
+var GLOBAL_SCAN_OPTIONS = [...GLOBAL_INFRA_OPTIONS];
 
 // src/types/language.ts
 var Language = /* @__PURE__ */ ((Language2) => {
@@ -626,9 +642,11 @@ function generateHTML(graph) {
   AnalysisResultSchema,
   AnalysisStatus,
   AnalysisStatusSchema,
+  COMMON_FINE_TUNING_OPTIONS,
   CONTEXT_TIER_THRESHOLDS,
   DEFAULT_TOOL_WEIGHTS,
   FRIENDLY_TOOL_NAMES,
+  GLOBAL_INFRA_OPTIONS,
   GLOBAL_SCAN_OPTIONS,
   IssueSchema,
   IssueType,

package/dist/client.mjs

@@ -2,9 +2,11 @@ import {
   AnalysisResultSchema,
   AnalysisStatus,
   AnalysisStatusSchema,
+  COMMON_FINE_TUNING_OPTIONS,
   CONTEXT_TIER_THRESHOLDS,
   DEFAULT_TOOL_WEIGHTS,
   FRIENDLY_TOOL_NAMES,
+  GLOBAL_INFRA_OPTIONS,
   GLOBAL_SCAN_OPTIONS,
   IssueSchema,
   IssueType,
@@ -37,14 +39,16 @@ import {
   getToolWeight,
   normalizeToolName,
   parseWeightString
-} from "./chunk-XKK7YHPX.mjs";
+} from "./chunk-COHIBX3Q.mjs";
 export {
   AnalysisResultSchema,
   AnalysisStatus,
   AnalysisStatusSchema,
+  COMMON_FINE_TUNING_OPTIONS,
   CONTEXT_TIER_THRESHOLDS,
   DEFAULT_TOOL_WEIGHTS,
   FRIENDLY_TOOL_NAMES,
+  GLOBAL_INFRA_OPTIONS,
   GLOBAL_SCAN_OPTIONS,
   IssueSchema,
   IssueType,

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, ParseResult, NamingConvention } from './client.mjs';
-export { AnalysisResult, AnalysisResultSchema, AnalysisStatus, AnalysisStatusSchema, BusinessReport, CONTEXT_TIER_THRESHOLDS, CommonASTNode, DEFAULT_TOOL_WEIGHTS, ExportInfo, FRIENDLY_TOOL_NAMES, GLOBAL_SCAN_OPTIONS, GraphData, GraphEdge, GraphIssueSeverity, GraphMetadata, GraphNode, ImportInfo, Issue, IssueSchema, IssueType, IssueTypeSchema, LANGUAGE_EXTENSIONS, LanguageConfig, Location, LocationSchema, Metrics, MetricsSchema, ModelTier, ModelTierSchema, ParseError, ParseStatistics, 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 { AnalysisResult, AnalysisResultSchema, AnalysisStatus, AnalysisStatusSchema, BusinessReport, COMMON_FINE_TUNING_OPTIONS, CONTEXT_TIER_THRESHOLDS, CommonASTNode, DEFAULT_TOOL_WEIGHTS, ExportInfo, 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, ParseError, ParseStatistics, 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';
 import { z } from 'zod';
 
 /**

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, ParseResult, NamingConvention } from './client.js';
-export { AnalysisResult, AnalysisResultSchema, AnalysisStatus, AnalysisStatusSchema, BusinessReport, CONTEXT_TIER_THRESHOLDS, CommonASTNode, DEFAULT_TOOL_WEIGHTS, ExportInfo, FRIENDLY_TOOL_NAMES, GLOBAL_SCAN_OPTIONS, GraphData, GraphEdge, GraphIssueSeverity, GraphMetadata, GraphNode, ImportInfo, Issue, IssueSchema, IssueType, IssueTypeSchema, LANGUAGE_EXTENSIONS, LanguageConfig, Location, LocationSchema, Metrics, MetricsSchema, ModelTier, ModelTierSchema, ParseError, ParseStatistics, 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 { AnalysisResult, AnalysisResultSchema, AnalysisStatus, AnalysisStatusSchema, BusinessReport, COMMON_FINE_TUNING_OPTIONS, CONTEXT_TIER_THRESHOLDS, CommonASTNode, DEFAULT_TOOL_WEIGHTS, ExportInfo, 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, ParseError, ParseStatistics, 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';
 import { z } from 'zod';
 
 /**

package/dist/index.js

@@ -33,11 +33,13 @@ __export(index_exports, {
   AnalysisResultSchema: () => AnalysisResultSchema,
   AnalysisStatus: () => AnalysisStatus,
   AnalysisStatusSchema: () => AnalysisStatusSchema,
+  COMMON_FINE_TUNING_OPTIONS: () => COMMON_FINE_TUNING_OPTIONS,
   CONTEXT_TIER_THRESHOLDS: () => CONTEXT_TIER_THRESHOLDS,
   DEFAULT_COST_CONFIG: () => DEFAULT_COST_CONFIG,
   DEFAULT_EXCLUDE: () => DEFAULT_EXCLUDE,
   DEFAULT_TOOL_WEIGHTS: () => DEFAULT_TOOL_WEIGHTS,
   FRIENDLY_TOOL_NAMES: () => FRIENDLY_TOOL_NAMES,
+  GLOBAL_INFRA_OPTIONS: () => GLOBAL_INFRA_OPTIONS,
   GLOBAL_SCAN_OPTIONS: () => GLOBAL_SCAN_OPTIONS,
   IssueSchema: () => IssueSchema,
   IssueType: () => IssueType,
@@ -299,21 +301,35 @@ var UnifiedReportSchema = import_zod.z.object({
 }).catchall(import_zod.z.any());
 
 // src/types.ts
-var GLOBAL_SCAN_OPTIONS = [
+var GLOBAL_INFRA_OPTIONS = [
   "rootDir",
-  "tools",
-  "toolConfigs",
+  // Essential for every tool
   "include",
   "exclude",
   "onProgress",
   "progressCallback",
   "includeTests",
   "useSmartDefaults",
-  "maxDepth",
   "streamResults",
   "batchSize",
-  "costConfig"
+  "costConfig",
+  "tools",
+  "toolConfigs"
 ];
+var COMMON_FINE_TUNING_OPTIONS = [
+  "maxDepth",
+  "minSimilarity",
+  "minLines",
+  "minCohesion",
+  // AI Signal Clarity options
+  "checkMagicLiterals",
+  "checkBooleanTraps",
+  "checkAmbiguousNames",
+  "checkUndocumentedExports",
+  "checkImplicitSideEffects",
+  "checkDeepCallbacks"
+];
+var GLOBAL_SCAN_OPTIONS = [...GLOBAL_INFRA_OPTIONS];
 
 // src/types/language.ts
 var Language = /* @__PURE__ */ ((Language2) => {
@@ -1010,13 +1026,16 @@ function mergeConfigWithDefaults(userConfig, defaults) {
     if (userConfig.scan.include) result.include = userConfig.scan.include;
     if (userConfig.scan.exclude) result.exclude = userConfig.scan.exclude;
   }
-  if (userConfig.tools) {
-    for (const [toolName, toolConfig] of Object.entries(userConfig.tools)) {
+  const toolOverrides = userConfig.tools && !Array.isArray(userConfig.tools) && typeof userConfig.tools === "object" ? userConfig.tools : userConfig.toolConfigs;
+  if (toolOverrides) {
+    if (!result.toolConfigs) result.toolConfigs = {};
+    for (const [toolName, toolConfig] of Object.entries(toolOverrides)) {
       if (typeof toolConfig === "object" && toolConfig !== null) {
-        if (toolName === "pattern-detect" || toolName === "context-analyzer") {
-          Object.assign(result, toolConfig);
-        }
         result[toolName] = { ...result[toolName], ...toolConfig };
+        result.toolConfigs[toolName] = {
+          ...result.toolConfigs[toolName],
+          ...toolConfig
+        };
       }
     }
   }
@@ -3285,11 +3304,13 @@ function getRepoMetadata(directory) {
   AnalysisResultSchema,
   AnalysisStatus,
   AnalysisStatusSchema,
+  COMMON_FINE_TUNING_OPTIONS,
   CONTEXT_TIER_THRESHOLDS,
   DEFAULT_COST_CONFIG,
   DEFAULT_EXCLUDE,
   DEFAULT_TOOL_WEIGHTS,
   FRIENDLY_TOOL_NAMES,
+  GLOBAL_INFRA_OPTIONS,
   GLOBAL_SCAN_OPTIONS,
   IssueSchema,
   IssueType,

package/dist/index.mjs

@@ -2,9 +2,11 @@ import {
   AnalysisResultSchema,
   AnalysisStatus,
   AnalysisStatusSchema,
+  COMMON_FINE_TUNING_OPTIONS,
   CONTEXT_TIER_THRESHOLDS,
   DEFAULT_TOOL_WEIGHTS,
   FRIENDLY_TOOL_NAMES,
+  GLOBAL_INFRA_OPTIONS,
   GLOBAL_SCAN_OPTIONS,
   IssueSchema,
   IssueType,
@@ -37,7 +39,7 @@ import {
   getToolWeight,
   normalizeToolName,
   parseWeightString
-} from "./chunk-XKK7YHPX.mjs";
+} from "./chunk-COHIBX3Q.mjs";
 
 // src/types/contract.ts
 function validateSpokeOutput(toolName, output) {
@@ -703,13 +705,16 @@ function mergeConfigWithDefaults(userConfig, defaults) {
     if (userConfig.scan.include) result.include = userConfig.scan.include;
     if (userConfig.scan.exclude) result.exclude = userConfig.scan.exclude;
   }
-  if (userConfig.tools) {
-    for (const [toolName, toolConfig] of Object.entries(userConfig.tools)) {
+  const toolOverrides = userConfig.tools && !Array.isArray(userConfig.tools) && typeof userConfig.tools === "object" ? userConfig.tools : userConfig.toolConfigs;
+  if (toolOverrides) {
+    if (!result.toolConfigs) result.toolConfigs = {};
+    for (const [toolName, toolConfig] of Object.entries(toolOverrides)) {
       if (typeof toolConfig === "object" && toolConfig !== null) {
-        if (toolName === "pattern-detect" || toolName === "context-analyzer") {
-          Object.assign(result, toolConfig);
-        }
         result[toolName] = { ...result[toolName], ...toolConfig };
+        result.toolConfigs[toolName] = {
+          ...result.toolConfigs[toolName],
+          ...toolConfig
+        };
       }
     }
   }
@@ -2620,11 +2625,13 @@ export {
   AnalysisResultSchema,
   AnalysisStatus,
   AnalysisStatusSchema,
+  COMMON_FINE_TUNING_OPTIONS,
   CONTEXT_TIER_THRESHOLDS,
   DEFAULT_COST_CONFIG,
   DEFAULT_EXCLUDE,
   DEFAULT_TOOL_WEIGHTS,
   FRIENDLY_TOOL_NAMES,
+  GLOBAL_INFRA_OPTIONS,
   GLOBAL_SCAN_OPTIONS,
   IssueSchema,
   IssueType,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiready/core",
-  "version": "0.21.10",
+  "version": "0.21.13",
   "description": "Shared utilities for AIReady analysis tools",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",