@aiready/core 0.24.5 → 0.24.6

package/dist/client/index.d.mts

@@ -1,2 +1,2 @@
-export { e as AIReadyConfig, o as AIReadyConfigSchema, i as AcceptancePrediction, A as AnalysisResult, q as AnalysisResultSchema, r as AnalysisStatus, s as AnalysisStatusSchema, aN as BaseGraphLink, aO as BaseGraphNode, B as BusinessMetrics, t as COMMON_FINE_TUNING_OPTIONS, u as CONTEXT_TIER_THRESHOLDS, v as CommonASTNode, j as ComprehensionDifficulty, w as Config, C as CostConfig, D as DEFAULT_TOOL_WEIGHTS, n as ExportInfo, 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, I as Issue, R as IssueOverlay, U as IssueSchema, V as IssueType, W as IssueTypeSchema, X as LANGUAGE_EXTENSIONS, L as Language, Y as LanguageConfig, l as LanguageParser, Z as Lead, _ as LeadSchema, $ as LeadSource, a0 as LeadSourceSchema, a1 as LeadSubmission, a2 as LeadSubmissionSchema, a3 as Location, a4 as LocationSchema, M as Metrics, a7 as MetricsSchema, g as ModelContextTier, a8 as ModelTier, a9 as ModelTierSchema, N as NamingConvention, aa as ParseError, m as ParseResult, ab as ParseStatistics, P as ProductivityImpact, ad as RecommendationPriority, ae as SCORING_PROFILES, af as SIZE_ADJUSTED_THRESHOLDS, S as ScanOptions, ag as ScanResult, ah as ScoringConfig, ai as ScoringProfile, aj as ScoringResult, c as Severity, ak as SeveritySchema, c as SeverityType, al as SourceLocation, am as SourceRange, a as SpokeOutput, an as SpokeOutputSchema, ao as SpokeSummary, ap as SpokeSummarySchema, aq as TOOL_NAME_MAP, f as TechnicalValueChain, k as TechnicalValueChainSummary, h as TokenBudget, T as ToolName, ar as ToolNameSchema, d as ToolOptions, as as ToolOutput, b as ToolScoringOutput, at as UnifiedReport, au as UnifiedReportSchema, av as calculateOverallScore, aw as formatScore, ax as formatToolScore, ay as generateHTML, aA as getProjectSizeTier, aB as getRating, aC as getRatingDisplay, aG as getRatingSlug, aH as getRatingWithContext, aI as getRecommendedThreshold, aK as getToolWeight, aL as normalizeToolName, aM as parseWeightString } from '../index-EQ2jRSlB.mjs';
+export { e as AIReadyConfig, o as AIReadyConfigSchema, i as AcceptancePrediction, A as AnalysisResult, q as AnalysisResultSchema, r as AnalysisStatus, s as AnalysisStatusSchema, aN as BaseGraphLink, aO as BaseGraphNode, B as BusinessMetrics, t as COMMON_FINE_TUNING_OPTIONS, u as CONTEXT_TIER_THRESHOLDS, v as CommonASTNode, j as ComprehensionDifficulty, w as Config, C as CostConfig, D as DEFAULT_TOOL_WEIGHTS, n as ExportInfo, 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, I as Issue, R as IssueOverlay, U as IssueSchema, V as IssueType, W as IssueTypeSchema, X as LANGUAGE_EXTENSIONS, L as Language, Y as LanguageConfig, l as LanguageParser, Z as Lead, _ as LeadSchema, $ as LeadSource, a0 as LeadSourceSchema, a1 as LeadSubmission, a2 as LeadSubmissionSchema, a3 as Location, a4 as LocationSchema, M as Metrics, a7 as MetricsSchema, g as ModelContextTier, a8 as ModelTier, a9 as ModelTierSchema, N as NamingConvention, aa as ParseError, m as ParseResult, ab as ParseStatistics, P as ProductivityImpact, ad as RecommendationPriority, ae as SCORING_PROFILES, af as SIZE_ADJUSTED_THRESHOLDS, S as ScanOptions, ag as ScanResult, ah as ScoringConfig, ai as ScoringProfile, aj as ScoringResult, c as Severity, ak as SeveritySchema, c as SeverityType, al as SourceLocation, am as SourceRange, a as SpokeOutput, an as SpokeOutputSchema, ao as SpokeSummary, ap as SpokeSummarySchema, aq as TOOL_NAME_MAP, f as TechnicalValueChain, k as TechnicalValueChainSummary, h as TokenBudget, T as ToolName, ar as ToolNameSchema, d as ToolOptions, as as ToolOutput, b as ToolScoringOutput, at as UnifiedReport, au as UnifiedReportSchema, av as calculateOverallScore, aw as formatScore, ax as formatToolScore, ay as generateHTML, aA as getProjectSizeTier, aB as getRating, aC as getRatingDisplay, aG as getRatingSlug, aH as getRatingWithContext, aI as getRecommendedThreshold, aK as getToolWeight, aL as normalizeToolName, aM as parseWeightString } from '../index-ChiWzeQs.mjs';
 import 'zod';

package/dist/client/index.d.ts

@@ -1,2 +1,2 @@
-export { e as AIReadyConfig, o as AIReadyConfigSchema, i as AcceptancePrediction, A as AnalysisResult, q as AnalysisResultSchema, r as AnalysisStatus, s as AnalysisStatusSchema, aN as BaseGraphLink, aO as BaseGraphNode, B as BusinessMetrics, t as COMMON_FINE_TUNING_OPTIONS, u as CONTEXT_TIER_THRESHOLDS, v as CommonASTNode, j as ComprehensionDifficulty, w as Config, C as CostConfig, D as DEFAULT_TOOL_WEIGHTS, n as ExportInfo, 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, I as Issue, R as IssueOverlay, U as IssueSchema, V as IssueType, W as IssueTypeSchema, X as LANGUAGE_EXTENSIONS, L as Language, Y as LanguageConfig, l as LanguageParser, Z as Lead, _ as LeadSchema, $ as LeadSource, a0 as LeadSourceSchema, a1 as LeadSubmission, a2 as LeadSubmissionSchema, a3 as Location, a4 as LocationSchema, M as Metrics, a7 as MetricsSchema, g as ModelContextTier, a8 as ModelTier, a9 as ModelTierSchema, N as NamingConvention, aa as ParseError, m as ParseResult, ab as ParseStatistics, P as ProductivityImpact, ad as RecommendationPriority, ae as SCORING_PROFILES, af as SIZE_ADJUSTED_THRESHOLDS, S as ScanOptions, ag as ScanResult, ah as ScoringConfig, ai as ScoringProfile, aj as ScoringResult, c as Severity, ak as SeveritySchema, c as SeverityType, al as SourceLocation, am as SourceRange, a as SpokeOutput, an as SpokeOutputSchema, ao as SpokeSummary, ap as SpokeSummarySchema, aq as TOOL_NAME_MAP, f as TechnicalValueChain, k as TechnicalValueChainSummary, h as TokenBudget, T as ToolName, ar as ToolNameSchema, d as ToolOptions, as as ToolOutput, b as ToolScoringOutput, at as UnifiedReport, au as UnifiedReportSchema, av as calculateOverallScore, aw as formatScore, ax as formatToolScore, ay as generateHTML, aA as getProjectSizeTier, aB as getRating, aC as getRatingDisplay, aG as getRatingSlug, aH as getRatingWithContext, aI as getRecommendedThreshold, aK as getToolWeight, aL as normalizeToolName, aM as parseWeightString } from '../index-EQ2jRSlB.js';
+export { e as AIReadyConfig, o as AIReadyConfigSchema, i as AcceptancePrediction, A as AnalysisResult, q as AnalysisResultSchema, r as AnalysisStatus, s as AnalysisStatusSchema, aN as BaseGraphLink, aO as BaseGraphNode, B as BusinessMetrics, t as COMMON_FINE_TUNING_OPTIONS, u as CONTEXT_TIER_THRESHOLDS, v as CommonASTNode, j as ComprehensionDifficulty, w as Config, C as CostConfig, D as DEFAULT_TOOL_WEIGHTS, n as ExportInfo, 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, I as Issue, R as IssueOverlay, U as IssueSchema, V as IssueType, W as IssueTypeSchema, X as LANGUAGE_EXTENSIONS, L as Language, Y as LanguageConfig, l as LanguageParser, Z as Lead, _ as LeadSchema, $ as LeadSource, a0 as LeadSourceSchema, a1 as LeadSubmission, a2 as LeadSubmissionSchema, a3 as Location, a4 as LocationSchema, M as Metrics, a7 as MetricsSchema, g as ModelContextTier, a8 as ModelTier, a9 as ModelTierSchema, N as NamingConvention, aa as ParseError, m as ParseResult, ab as ParseStatistics, P as ProductivityImpact, ad as RecommendationPriority, ae as SCORING_PROFILES, af as SIZE_ADJUSTED_THRESHOLDS, S as ScanOptions, ag as ScanResult, ah as ScoringConfig, ai as ScoringProfile, aj as ScoringResult, c as Severity, ak as SeveritySchema, c as SeverityType, al as SourceLocation, am as SourceRange, a as SpokeOutput, an as SpokeOutputSchema, ao as SpokeSummary, ap as SpokeSummarySchema, aq as TOOL_NAME_MAP, f as TechnicalValueChain, k as TechnicalValueChainSummary, h as TokenBudget, T as ToolName, ar as ToolNameSchema, d as ToolOptions, as as ToolOutput, b as ToolScoringOutput, at as UnifiedReport, au as UnifiedReportSchema, av as calculateOverallScore, aw as formatScore, ax as formatToolScore, ay as generateHTML, aA as getProjectSizeTier, aB as getRating, aC as getRatingDisplay, aG as getRatingSlug, aH as getRatingWithContext, aI as getRecommendedThreshold, aK as getToolWeight, aL as normalizeToolName, aM as parseWeightString } from '../index-ChiWzeQs.js';
 import 'zod';

package/dist/client/index.js

@@ -469,6 +469,31 @@ var RecommendationPriority = /* @__PURE__ */ ((RecommendationPriority2) => {
 })(RecommendationPriority || {});
 
 // src/scoring.ts
+var SCORING_CONSTANTS = {
+  WEIGHTS: {
+    DEFAULT: 5,
+    MAX: 100
+  },
+  THRESHOLDS: {
+    XS: 80,
+    SMALL: 75,
+    MEDIUM: 70,
+    LARGE: 65,
+    ENTERPRISE: 58,
+    NORMALIZATION_OFFSET: 70
+  },
+  FILE_COUNTS: {
+    XS: 50,
+    SMALL: 200,
+    MEDIUM: 500,
+    LARGE: 2e3
+  },
+  DELIMITERS: {
+    LIST: ",",
+    PAIR: ":",
+    FORMULA_JOIN: " + "
+  }
+};
 var DEFAULT_TOOL_WEIGHTS = {
   ["pattern-detect" /* PatternDetect */]: 22,
   ["context-analyzer" /* ContextAnalyzer */]: 19,
@@ -556,22 +581,22 @@ var CONTEXT_TIER_THRESHOLDS = {
   frontier: { idealTokens: 5e4, criticalTokens: 15e4, idealDepth: 10 }
 };
 var SIZE_ADJUSTED_THRESHOLDS = {
-  xs: 80,
+  xs: SCORING_CONSTANTS.THRESHOLDS.XS,
   // < 50 files
-  small: 75,
+  small: SCORING_CONSTANTS.THRESHOLDS.SMALL,
   // 50-200 files
-  medium: 70,
+  medium: SCORING_CONSTANTS.THRESHOLDS.MEDIUM,
   // 200-500 files
-  large: 65,
+  large: SCORING_CONSTANTS.THRESHOLDS.LARGE,
   // 500-2000 files
-  enterprise: 58
+  enterprise: SCORING_CONSTANTS.THRESHOLDS.ENTERPRISE
   // 2000+ files
 };
 function getProjectSizeTier(fileCount) {
-  if (fileCount < 50) return "xs";
-  if (fileCount < 200) return "small";
-  if (fileCount < 500) return "medium";
-  if (fileCount < 2e3) return "large";
+  if (fileCount < SCORING_CONSTANTS.FILE_COUNTS.XS) return "xs";
+  if (fileCount < SCORING_CONSTANTS.FILE_COUNTS.SMALL) return "small";
+  if (fileCount < SCORING_CONSTANTS.FILE_COUNTS.MEDIUM) return "medium";
+  if (fileCount < SCORING_CONSTANTS.FILE_COUNTS.LARGE) return "large";
   return "enterprise";
 }
 function getRecommendedThreshold(fileCount, modelTier = "standard") {
@@ -587,14 +612,16 @@ function getToolWeight(toolName, toolConfig, cliOverride, profile = "default" /*
   if (cliOverride !== void 0) return cliOverride;
   if (toolConfig?.scoreWeight !== void 0) return toolConfig.scoreWeight;
   const profileWeights = SCORING_PROFILES[profile] ?? DEFAULT_TOOL_WEIGHTS;
-  return profileWeights[toolName] ?? DEFAULT_TOOL_WEIGHTS[toolName] ?? 5;
+  return profileWeights[toolName] ?? DEFAULT_TOOL_WEIGHTS[toolName] ?? SCORING_CONSTANTS.WEIGHTS.DEFAULT;
 }
 function parseWeightString(weightStr) {
   const weights = /* @__PURE__ */ new Map();
   if (!weightStr) return weights;
-  const pairs = weightStr.split(",");
+  const pairs = weightStr.split(SCORING_CONSTANTS.DELIMITERS.LIST);
   for (const pair of pairs) {
-    const [toolShortName, weightValueStr] = pair.split(":");
+    const [toolShortName, weightValueStr] = pair.split(
+      SCORING_CONSTANTS.DELIMITERS.PAIR
+    );
     if (toolShortName && weightValueStr) {
       const toolName = normalizeToolName(toolShortName.trim());
       const weight = parseInt(weightValueStr.trim(), 10);
@@ -609,7 +636,7 @@ 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 profile = config?.profile || "default" /* Default */;
   const weights = /* @__PURE__ */ new Map();
   for (const [toolName] of toolOutputs.entries()) {
     const cliWeight = cliWeights?.get(toolName);
@@ -623,7 +650,7 @@ function calculateOverallScore(toolOutputs, config, cliWeights) {
   const toolsUsed = [];
   const calculationWeights = {};
   for (const [toolName, output] of toolOutputs.entries()) {
-    const weight = weights.get(toolName) ?? 5;
+    const weight = weights.get(toolName) ?? SCORING_CONSTANTS.WEIGHTS.DEFAULT;
     weightedSum += output.score * weight;
     totalWeight += weight;
     toolsUsed.push(toolName);
@@ -634,11 +661,11 @@ function calculateOverallScore(toolOutputs, config, cliWeights) {
   const rating = getRating(overall);
   const formulaParts = Array.from(toolOutputs.entries()).map(
     ([name, output]) => {
-      const weight = weights.get(name) ?? 5;
+      const weight = weights.get(name) ?? SCORING_CONSTANTS.WEIGHTS.DEFAULT;
       return `(${output.score} \xD7 ${weight})`;
     }
   );
-  const formulaStr = `[${formulaParts.join(" + ")}] / ${totalWeight} = ${overall}`;
+  const formulaStr = `[${formulaParts.join(SCORING_CONSTANTS.DELIMITERS.FORMULA_JOIN)}] / ${totalWeight} = ${overall}`;
   return {
     overall,
     rating,
@@ -654,7 +681,7 @@ function calculateOverallScore(toolOutputs, config, cliWeights) {
 }
 function getRatingWithContext(score, fileCount, modelTier = "standard") {
   const threshold = getRecommendedThreshold(fileCount, modelTier);
-  const normalized = score - threshold + 70;
+  const normalized = score - threshold + SCORING_CONSTANTS.THRESHOLDS.NORMALIZATION_OFFSET;
   return getRating(normalized);
 }
 function getRatingDisplay(rating) {

package/dist/client/index.mjs

@@ -45,7 +45,7 @@ import {
   getToolWeight,
   normalizeToolName,
   parseWeightString
-} from "../chunk-2ILVUVRK.mjs";
+} from "../chunk-FAESSLG7.mjs";
 import {
   LANGUAGE_EXTENSIONS,
   Language,

package/dist/{csharp-parser-4ZKCSX5B.mjs → csharp-parser-C52DNAKT.mjs}

@@ -1,7 +1,7 @@
 import {
   CSharpParser
-} from "./chunk-FNPULWG7.mjs";
-import "./chunk-JJQLYW6Z.mjs";
+} from "./chunk-X63YJX5G.mjs";
+import "./chunk-DHFOYNMW.mjs";
 import "./chunk-2N7ISIKE.mjs";
 import "./chunk-U3IY2CFC.mjs";
 export {

package/dist/{csharp-parser-5HKICCRR.mjs → csharp-parser-XW7WHE77.mjs}

@@ -1,7 +1,7 @@
 import {
   CSharpParser
-} from "./chunk-QZNY7B2N.mjs";
-import "./chunk-L6BKANJC.mjs";
+} from "./chunk-EHUK4VMH.mjs";
+import "./chunk-3D3I5K5W.mjs";
 import "./chunk-2N7ISIKE.mjs";
 import "./chunk-U3IY2CFC.mjs";
 export {

package/dist/{go-parser-TKXL3DVH.mjs → go-parser-GO4BIRDD.mjs}

@@ -1,7 +1,7 @@
 import {
   GoParser
-} from "./chunk-QDCQETSI.mjs";
-import "./chunk-JJQLYW6Z.mjs";
+} from "./chunk-3FAI4YNO.mjs";
+import "./chunk-DHFOYNMW.mjs";
 import "./chunk-2N7ISIKE.mjs";
 import "./chunk-U3IY2CFC.mjs";
 export {

package/dist/{go-parser-XOM232XZ.mjs → go-parser-KTG4CGF5.mjs}

@@ -1,7 +1,7 @@
 import {
   GoParser
-} from "./chunk-GTS642BQ.mjs";
-import "./chunk-L6BKANJC.mjs";
+} from "./chunk-EJ74KPCV.mjs";
+import "./chunk-3D3I5K5W.mjs";
 import "./chunk-2N7ISIKE.mjs";
 import "./chunk-U3IY2CFC.mjs";
 export {

package/dist/{index-CkM98qn1.d.mts → index-ChiWzeQs.d.mts}

@@ -1,8 +1,182 @@
 import { z } from 'zod';
 
 /**
- * AST Parsing and Export Extraction Types
+ * Language-agnostic AST and parser interfaces for multi-language support
+ *
+ * This module provides abstractions for parsing different programming languages
+ * while maintaining a consistent interface for analysis tools.
+ */
+
+/**
+ * Supported programming languages
+ */
+declare enum Language {
+    TypeScript = "typescript",
+    JavaScript = "javascript",
+    Python = "python",
+    Java = "java",
+    Go = "go",
+    Rust = "rust",
+    CSharp = "csharp"
+}
+/**
+ * File extensions mapped to languages
+ */
+declare const LANGUAGE_EXTENSIONS: Record<string, Language>;
+/**
+ * Common AST node type (language-agnostic)
+ */
+interface CommonASTNode {
+    type: string;
+    loc?: SourceRange;
+    raw?: any;
+}
+/**
+ * Export information (function, class, variable, etc.)
+ */
+interface ExportInfo {
+    name: string;
+    type: 'function' | 'class' | 'const' | 'type' | 'interface' | 'default' | 'variable' | 'all';
+    loc?: SourceRange;
+    /** Imports used within this export */
+    imports?: string[];
+    /** Dependencies on other exports in same file */
+    dependencies?: string[];
+    /** TypeScript types referenced */
+    typeReferences?: string[];
+    /** For methods: parent class name */
+    parentClass?: string;
+    /** For functions/methods: parameters */
+    parameters?: string[];
+    /** For classes/interfaces: number of methods and properties */
+    methodCount?: number;
+    propertyCount?: number;
+    /** Visibility (public, private, protected) */
+    visibility?: 'public' | 'private' | 'protected';
+    /** Whether the value is a primitive (string, number, boolean) */
+    isPrimitive?: boolean;
+    /** Behavioral metadata for advanced metrics */
+    isPure?: boolean;
+    hasSideEffects?: boolean;
+    /** Whether the export has explicit type annotations (TS only) */
+    isTyped?: boolean;
+    /** Inferred domain/area this export belongs to (e.g., "auth", "database") */
+    inferredDomain?: string;
+    /** Associated documentation */
+    documentation?: {
+        content: string;
+        type: 'jsdoc' | 'docstring' | 'comment' | 'xml-doc';
+        loc?: SourceRange;
+        isStale?: boolean;
+    };
+}
+/**
+ * Parse result containing exports and imports
  */
+interface ParseResult {
+    exports: ExportInfo[];
+    imports: FileImport[];
+    /** Language of the parsed file */
+    language: Language;
+    /** Any parse warnings (non-fatal) */
+    warnings?: string[];
+}
+/**
+ * Naming convention rules per language
+ */
+interface NamingConvention {
+    /** Allowed variable naming patterns */
+    variablePattern: RegExp;
+    /** Allowed function naming patterns */
+    functionPattern: RegExp;
+    /** Allowed class naming patterns */
+    classPattern: RegExp;
+    /** Allowed constant naming patterns */
+    constantPattern: RegExp;
+    /** Allowed type naming patterns */
+    typePattern?: RegExp;
+    /** Allowed interface naming patterns */
+    interfacePattern?: RegExp;
+    /** Language-specific exceptions (e.g., __init__ in Python) */
+    exceptions?: string[];
+}
+/**
+ * Language-specific configuration
+ */
+interface LanguageConfig {
+    language: Language;
+    /** File extensions for this language */
+    extensions: string[];
+    /** Naming conventions */
+    namingConventions: NamingConvention;
+    /** Common abbreviations allowed */
+    allowedAbbreviations?: string[];
+    /** Language-specific keywords to ignore */
+    keywords?: string[];
+}
+/**
+ * Abstract interface for language parsers
+ * Each language implementation should implement this interface
+ */
+interface LanguageParser {
+    /** Language this parser handles */
+    readonly language: Language;
+    /** File extensions this parser supports */
+    readonly extensions: string[];
+    /**
+     * Parse source code and extract structure
+     * @param code - Source code to parse
+     * @param filePath - Path to the file (for context)
+     * @returns Parse result with exports and imports
+     * @throws ParseError if code has syntax errors
+     */
+    parse(code: string, filePath: string): ParseResult;
+    /**
+     * Get naming conventions for this language
+     */
+    getNamingConventions(): NamingConvention;
+    /**
+     * Initialize the parser (e.g. load WASM)
+     */
+    initialize(): Promise<void>;
+    /**
+     * Check if this parser can handle a file
+     * @param filePath - File path to check
+     */
+    canHandle(filePath: string): boolean;
+    /**
+     * Get the raw AST for advanced querying
+     * @param code - Source code to parse
+     * @param filePath - Path to the file
+     */
+    getAST(code: string, filePath: string): Promise<any>;
+    /**
+     * Analyze structural metadata for a node (e.g. purity)
+     * @param node - The AST node to analyze (language specific)
+     * @param code - The original source code
+     */
+    analyzeMetadata(node: any, code: string): Partial<ExportInfo>;
+}
+/**
+ * Parser error with location information
+ */
+declare class ParseError extends Error {
+    readonly filePath: string;
+    readonly loc?: SourceLocation | undefined;
+    constructor(message: string, filePath: string, loc?: SourceLocation | undefined);
+}
+/**
+ * Statistics about parsed code
+ */
+interface ParseStatistics {
+    language: Language;
+    filesAnalyzed: number;
+    totalExports: number;
+    totalImports: number;
+    parseErrors: number;
+    warnings: number;
+}
+
 /**
  * Location information in source code
  */
@@ -17,9 +191,10 @@ interface SourceRange {
     start: SourceLocation;
     end: SourceLocation;
 }
+
 interface ExportWithImports {
     name: string;
-    type: 'function' | 'class' | 'const' | 'type' | 'interface' | 'default' | 'all';
+    type: ExportInfo['type'];
     source?: string;
     imports: string[];
     dependencies: string[];
@@ -89,7 +264,8 @@ declare enum ToolName {
     CognitiveLoad = "cognitive-load",
     PatternEntropy = "pattern-entropy",
     ConceptCohesion = "concept-cohesion",
-    SemanticDistance = "semantic-distance"
+    SemanticDistance = "semantic-distance",
+    ContractEnforcement = "contract-enforcement"
 }
 /** Zod schema for ToolName enum */
 declare const ToolNameSchema: z.ZodEnum<typeof ToolName>;
@@ -118,7 +294,8 @@ declare enum IssueType {
     LowTestability = "low-testability",
     AgentNavigationFailure = "agent-navigation-failure",
     AmbiguousApi = "ambiguous-api",
-    ChangeAmplification = "change-amplification"
+    ChangeAmplification = "change-amplification",
+    ContractGap = "contract-gap"
 }
 /** Zod schema for IssueType enum */
 declare const IssueTypeSchema: z.ZodEnum<typeof IssueType>;
@@ -820,181 +997,6 @@ interface GraphMetadata {
     executionTime?: number;
 }
 
-/**
- * Language-agnostic AST and parser interfaces for multi-language support
- *
- * This module provides abstractions for parsing different programming languages
- * while maintaining a consistent interface for analysis tools.
- */
-
-/**
- * Supported programming languages
- */
-declare enum Language {
-    TypeScript = "typescript",
-    JavaScript = "javascript",
-    Python = "python",
-    Java = "java",
-    Go = "go",
-    Rust = "rust",
-    CSharp = "csharp"
-}
-/**
- * File extensions mapped to languages
- */
-declare const LANGUAGE_EXTENSIONS: Record<string, Language>;
-/**
- * Common AST node type (language-agnostic)
- */
-interface CommonASTNode {
-    type: string;
-    loc?: SourceRange;
-    raw?: any;
-}
-/**
- * Export information (function, class, variable, etc.)
- */
-interface ExportInfo {
-    name: string;
-    type: 'function' | 'class' | 'const' | 'type' | 'interface' | 'default' | 'variable';
-    loc?: SourceRange;
-    /** Imports used within this export */
-    imports?: string[];
-    /** Dependencies on other exports in same file */
-    dependencies?: string[];
-    /** TypeScript types referenced */
-    typeReferences?: string[];
-    /** For methods: parent class name */
-    parentClass?: string;
-    /** For functions/methods: parameters */
-    parameters?: string[];
-    /** For classes/interfaces: number of methods and properties */
-    methodCount?: number;
-    propertyCount?: number;
-    /** Visibility (public, private, protected) */
-    visibility?: 'public' | 'private' | 'protected';
-    /** Whether the value is a primitive (string, number, boolean) */
-    isPrimitive?: boolean;
-    /** Behavioral metadata for advanced metrics */
-    isPure?: boolean;
-    hasSideEffects?: boolean;
-    /** Whether the export has explicit type annotations (TS only) */
-    isTyped?: boolean;
-    /** Associated documentation */
-    documentation?: {
-        content: string;
-        type: 'jsdoc' | 'docstring' | 'comment' | 'xml-doc';
-        loc?: SourceRange;
-        isStale?: boolean;
-    };
-}
-/**
- * Parse result containing exports and imports
- */
-interface ParseResult {
-    exports: ExportInfo[];
-    imports: FileImport[];
-    /** Language of the parsed file */
-    language: Language;
-    /** Any parse warnings (non-fatal) */
-    warnings?: string[];
-}
-/**
- * Naming convention rules per language
- */
-interface NamingConvention {
-    /** Allowed variable naming patterns */
-    variablePattern: RegExp;
-    /** Allowed function naming patterns */
-    functionPattern: RegExp;
-    /** Allowed class naming patterns */
-    classPattern: RegExp;
-    /** Allowed constant naming patterns */
-    constantPattern: RegExp;
-    /** Allowed type naming patterns */
-    typePattern?: RegExp;
-    /** Allowed interface naming patterns */
-    interfacePattern?: RegExp;
-    /** Language-specific exceptions (e.g., __init__ in Python) */
-    exceptions?: string[];
-}
-/**
- * Language-specific configuration
- */
-interface LanguageConfig {
-    language: Language;
-    /** File extensions for this language */
-    extensions: string[];
-    /** Naming conventions */
-    namingConventions: NamingConvention;
-    /** Common abbreviations allowed */
-    allowedAbbreviations?: string[];
-    /** Language-specific keywords to ignore */
-    keywords?: string[];
-}
-/**
- * Abstract interface for language parsers
- * Each language implementation should implement this interface
- */
-interface LanguageParser {
-    /** Language this parser handles */
-    readonly language: Language;
-    /** File extensions this parser supports */
-    readonly extensions: string[];
-    /**
-     * Parse source code and extract structure
-     * @param code - Source code to parse
-     * @param filePath - Path to the file (for context)
-     * @returns Parse result with exports and imports
-     * @throws ParseError if code has syntax errors
-     */
-    parse(code: string, filePath: string): ParseResult;
-    /**
-     * Get naming conventions for this language
-     */
-    getNamingConventions(): NamingConvention;
-    /**
-     * Initialize the parser (e.g. load WASM)
-     */
-    initialize(): Promise<void>;
-    /**
-     * Check if this parser can handle a file
-     * @param filePath - File path to check
-     */
-    canHandle(filePath: string): boolean;
-    /**
-     * Get the raw AST for advanced querying
-     * @param code - Source code to parse
-     * @param filePath - Path to the file
-     */
-    getAST(code: string, filePath: string): Promise<any>;
-    /**
-     * Analyze structural metadata for a node (e.g. purity)
-     * @param node - The AST node to analyze (language specific)
-     * @param code - The original source code
-     */
-    analyzeMetadata(node: any, code: string): Partial<ExportInfo>;
-}
-/**
- * Parser error with location information
- */
-declare class ParseError extends Error {
-    readonly filePath: string;
-    readonly loc?: SourceLocation | undefined;
-    constructor(message: string, filePath: string, loc?: SourceLocation | undefined);
-}
-/**
- * Statistics about parsed code
- */
-interface ParseStatistics {
-    language: Language;
-    filesAnalyzed: number;
-    totalExports: number;
-    totalImports: number;
-    parseErrors: number;
-    warnings: number;
-}
-
 /**
  * Shared rating helper functions for scoring and display.
  * Extracted to eliminate duplication between scoring.ts and CLI output modules.
@@ -1140,6 +1142,12 @@ interface ScoringConfig {
     compareBaseline?: string;
     /** Target file path to persist the calculated score */
     saveTo?: string;
+    /** Scoring profile to use for weighting */
+    profile?: string;
+    /** Tool-specific configurations (e.g., weights) */
+    tools?: Record<string, {
+        scoreWeight?: number;
+    }>;
 }
 
 /**
@@ -1244,7 +1252,7 @@ declare function parseWeightString(weightStr?: string): Map<string, number>;
  * @param cliWeights Optional weight overrides from the CLI
  * @returns Consolidate ScoringResult including overall score and rating
  */
-declare function calculateOverallScore(toolOutputs: Map<string, ToolScoringOutput>, config?: any, cliWeights?: Map<string, number>): ScoringResult;
+declare function calculateOverallScore(toolOutputs: Map<string, ToolScoringOutput>, config?: ScoringConfig, cliWeights?: Map<string, number>): ScoringResult;
 /**
  * Convert score to rating with project-size and model awareness.
  *