@aiready/context-analyzer 0.17.5 → 0.19.1

package/dist/cli.js

@@ -37,7 +37,7 @@ __export(python_context_exports, {
 });
 async function analyzePythonContext(files, rootDir) {
   const results = [];
-  const parser = (0, import_core7.getParser)("dummy.py");
+  const parser = (0, import_core8.getParser)("dummy.py");
   if (!parser) {
     console.warn("Python parser not available");
     return results;
@@ -101,7 +101,7 @@ async function analyzePythonContext(files, rootDir) {
 }
 async function buildPythonDependencyGraph(files, rootDir) {
   const graph = /* @__PURE__ */ new Map();
-  const parser = (0, import_core7.getParser)("dummy.py");
+  const parser = (0, import_core8.getParser)("dummy.py");
   if (!parser) return graph;
   for (const file of files) {
     try {
@@ -181,7 +181,7 @@ async function calculatePythonImportDepth(file, dependencyGraph, visited, depth
 }
 function estimateContextBudget(code, imports, dependencyGraph) {
   void dependencyGraph;
-  let budget = (0, import_core7.estimateTokens)(code);
+  let budget = (0, import_core8.estimateTokens)(code);
   const avgTokensPerDep = 500;
   budget += imports.length * avgTokensPerDep;
   return budget;
@@ -231,11 +231,11 @@ function detectCircularDependencies2(file, dependencyGraph) {
   dfs(file, []);
   return [...new Set(circular)];
 }
-var import_core7, import_path, import_fs;
+var import_core8, import_path, import_fs;
 var init_python_context = __esm({
   "src/analyzers/python-context.ts"() {
     "use strict";
-    import_core7 = require("@aiready/core");
+    import_core8 = require("@aiready/core");
     import_path = require("path");
     import_fs = __toESM(require("fs"));
   }
@@ -245,7 +245,7 @@ var init_python_context = __esm({
 var import_commander = require("commander");
 
 // src/index.ts
-var import_core8 = require("@aiready/core");
+var import_core9 = require("@aiready/core");
 
 // src/analyzer.ts
 var import_core4 = require("@aiready/core");
@@ -537,12 +537,9 @@ function calculateEnhancedCohesion(exports2, filePath, options) {
     }
   }
   const avgImportScore = pairsWithData > 0 ? importScoreTotal / pairsWithData : 0;
-  let score = 0;
-  if (anyImportData) {
-    score = domainScore * 0.4 + avgImportScore * 0.6;
-    if (score === 0 && domainScore === 0) score = 0.1;
-  } else {
-    score = domainScore;
+  let score = anyImportData ? domainScore * 0.4 + avgImportScore * 0.6 : domainScore;
+  if (anyImportData && score === 0 && domainScore === 0) {
+    score = 0.1;
   }
   let structuralScore = 0;
   for (const exp of exports2) {
@@ -562,19 +559,7 @@ function calculateFragmentation(files, domain, options) {
     files.map((f) => f.split("/").slice(0, -1).join("/"))
   );
   const uniqueDirs = directories.size;
-  let score = 0;
-  if (options?.useLogScale) {
-    if (uniqueDirs <= 1) score = 0;
-    else {
-      const total = files.length;
-      const base = options.logBase || Math.E;
-      const num = Math.log(uniqueDirs) / Math.log(base);
-      const den = Math.log(total) / Math.log(base);
-      score = den > 0 ? num / den : 0;
-    }
-  } else {
-    score = (uniqueDirs - 1) / (files.length - 1);
-  }
+  let score = options?.useLogScale ? uniqueDirs <= 1 ? 0 : Math.log(uniqueDirs) / Math.log(options.logBase || Math.E) / (Math.log(files.length) / Math.log(options.logBase || Math.E)) : (uniqueDirs - 1) / (files.length - 1);
   if (options?.sharedImportRatio && options.sharedImportRatio > 0.5) {
     const discount = (options.sharedImportRatio - 0.5) * 0.4;
     score = score * (1 - discount);
@@ -1344,11 +1329,180 @@ function isBuildArtifact(filePath) {
   return lower.includes("/node_modules/") || lower.includes("/dist/") || lower.includes("/build/") || lower.includes("/out/") || lower.includes("/.next/");
 }
 
+// src/provider.ts
+var import_core6 = require("@aiready/core");
+
 // src/scoring.ts
 var import_core5 = require("@aiready/core");
+function calculateContextScore(summary, costConfig) {
+  const {
+    avgContextBudget,
+    maxContextBudget,
+    avgImportDepth,
+    maxImportDepth,
+    avgFragmentation,
+    criticalIssues,
+    majorIssues
+  } = summary;
+  const budgetScore = avgContextBudget < 5e3 ? 100 : Math.max(0, 100 - (avgContextBudget - 5e3) / 150);
+  const depthScore = avgImportDepth < 5 ? 100 : Math.max(0, 100 - (avgImportDepth - 5) * 10);
+  const fragmentationScore = avgFragmentation < 0.3 ? 100 : Math.max(0, 100 - (avgFragmentation - 0.3) * 200);
+  const criticalPenalty = criticalIssues * 10;
+  const majorPenalty = majorIssues * 3;
+  const maxBudgetPenalty = maxContextBudget > 15e3 ? Math.min(20, (maxContextBudget - 15e3) / 500) : 0;
+  const rawScore = budgetScore * 0.4 + depthScore * 0.3 + fragmentationScore * 0.3;
+  const finalScore = rawScore - criticalPenalty - majorPenalty - maxBudgetPenalty;
+  const score = Math.max(0, Math.min(100, Math.round(finalScore)));
+  const factors = [
+    {
+      name: "Context Budget",
+      impact: Math.round(budgetScore * 0.4 - 40),
+      description: `Avg ${Math.round(avgContextBudget)} tokens per file ${avgContextBudget < 5e3 ? "(excellent)" : avgContextBudget < 1e4 ? "(acceptable)" : "(high)"}`
+    },
+    {
+      name: "Import Depth",
+      impact: Math.round(depthScore * 0.3 - 30),
+      description: `Avg ${avgImportDepth.toFixed(1)} levels ${avgImportDepth < 5 ? "(excellent)" : avgImportDepth < 8 ? "(acceptable)" : "(deep)"}`
+    },
+    {
+      name: "Fragmentation",
+      impact: Math.round(fragmentationScore * 0.3 - 30),
+      description: `${(avgFragmentation * 100).toFixed(0)}% fragmentation ${avgFragmentation < 0.3 ? "(well-organized)" : avgFragmentation < 0.5 ? "(moderate)" : "(high)"}`
+    }
+  ];
+  if (criticalIssues > 0) {
+    factors.push({
+      name: "Critical Issues",
+      impact: -criticalPenalty,
+      description: `${criticalIssues} critical context issue${criticalIssues > 1 ? "s" : ""}`
+    });
+  }
+  if (majorIssues > 0) {
+    factors.push({
+      name: "Major Issues",
+      impact: -majorPenalty,
+      description: `${majorIssues} major context issue${majorIssues > 1 ? "s" : ""}`
+    });
+  }
+  if (maxBudgetPenalty > 0) {
+    factors.push({
+      name: "Extreme File Detected",
+      impact: -Math.round(maxBudgetPenalty),
+      description: `One file requires ${Math.round(maxContextBudget)} tokens (very high)`
+    });
+  }
+  const recommendations = [];
+  if (avgContextBudget > 1e4) {
+    const estimatedImpact = Math.min(
+      15,
+      Math.round((avgContextBudget - 1e4) / 1e3)
+    );
+    recommendations.push({
+      action: "Reduce file dependencies to lower context requirements",
+      estimatedImpact,
+      priority: "high"
+    });
+  }
+  if (avgImportDepth > 8) {
+    const estimatedImpact = Math.min(10, Math.round((avgImportDepth - 8) * 2));
+    recommendations.push({
+      action: "Flatten import chains to reduce depth",
+      estimatedImpact,
+      priority: avgImportDepth > 10 ? "high" : "medium"
+    });
+  }
+  if (avgFragmentation > 0.5) {
+    const estimatedImpact = Math.min(
+      12,
+      Math.round((avgFragmentation - 0.5) * 40)
+    );
+    recommendations.push({
+      action: "Consolidate related code into cohesive modules",
+      estimatedImpact,
+      priority: "medium"
+    });
+  }
+  if (maxContextBudget > 2e4) {
+    recommendations.push({
+      action: `Split large file (${Math.round(maxContextBudget)} tokens) into smaller modules`,
+      estimatedImpact: 8,
+      priority: "high"
+    });
+  }
+  const cfg = { ...import_core5.DEFAULT_COST_CONFIG, ...costConfig };
+  const estimatedMonthlyCost = (0, import_core5.calculateMonthlyCost)(
+    avgContextBudget * (summary.totalFiles || 1),
+    cfg
+  );
+  const issues = [
+    ...Array(criticalIssues).fill({ severity: "critical" }),
+    ...Array(majorIssues).fill({ severity: "major" })
+  ];
+  const productivityImpact = (0, import_core5.calculateProductivityImpact)(issues);
+  return {
+    toolName: import_core5.ToolName.ContextAnalyzer,
+    score,
+    rawMetrics: {
+      avgContextBudget: Math.round(avgContextBudget),
+      maxContextBudget: Math.round(maxContextBudget),
+      avgImportDepth: Math.round(avgImportDepth * 10) / 10,
+      maxImportDepth,
+      avgFragmentation: Math.round(avgFragmentation * 100) / 100,
+      criticalIssues,
+      majorIssues,
+      estimatedMonthlyCost,
+      estimatedDeveloperHours: productivityImpact.totalHours
+    },
+    factors,
+    recommendations
+  };
+}
+
+// src/provider.ts
+var ContextAnalyzerProvider = {
+  id: import_core6.ToolName.ContextAnalyzer,
+  alias: ["context", "fragmentation", "budget"],
+  async analyze(options) {
+    const results = await analyzeContext(options);
+    const summary = generateSummary(results);
+    const normalizedResults = results.map(
+      (r) => ({
+        fileName: r.file,
+        issues: r.issues.map((msg) => ({
+          type: import_core6.IssueType.ContextFragmentation,
+          severity: r.severity,
+          message: msg,
+          location: { file: r.file, line: 1 },
+          suggestion: r.recommendations[0]
+        })),
+        metrics: {
+          tokenCost: r.tokenCost,
+          complexityScore: r.importDepth
+          // Map other context-specific metrics if needed
+        }
+      })
+    );
+    return import_core6.SpokeOutputSchema.parse({
+      results: normalizedResults,
+      summary: {
+        ...summary
+      },
+      metadata: {
+        toolName: import_core6.ToolName.ContextAnalyzer,
+        version: "0.17.5",
+        timestamp: (/* @__PURE__ */ new Date()).toISOString()
+      }
+    });
+  },
+  score(output, options) {
+    const summary = output.summary;
+    return calculateContextScore(summary, options.costConfig);
+  },
+  defaultWeight: 19
+};
 
 // src/defaults.ts
-var import_core6 = require("@aiready/core");
+var import_core7 = require("@aiready/core");
 
 // src/summary.ts
 function generateSummary(results) {
@@ -1478,6 +1632,7 @@ function generateSummary(results) {
 }
 
 // src/index.ts
+import_core9.ToolRegistry.register(ContextAnalyzerProvider);
 async function analyzeContext(options) {
   const {
     maxDepth = 5,
@@ -1488,7 +1643,7 @@ async function analyzeContext(options) {
     includeNodeModules = false,
     ...scanOptions
   } = options;
-  const files = await (0, import_core8.scanFiles)({
+  const files = await (0, import_core9.scanFiles)({
     ...scanOptions,
     exclude: includeNodeModules && scanOptions.exclude ? scanOptions.exclude.filter(
       (pattern) => pattern !== "**/node_modules/**"
@@ -1498,7 +1653,7 @@ async function analyzeContext(options) {
   const fileContents = await Promise.all(
     files.map(async (file) => ({
       file,
-      content: await (0, import_core8.readFileContent)(file)
+      content: await (0, import_core9.readFileContent)(file)
     }))
   );
   const graph = buildDependencyGraph(
@@ -1665,7 +1820,7 @@ async function analyzeContext(options) {
 var import_chalk = __toESM(require("chalk"));
 var import_fs2 = require("fs");
 var import_path2 = require("path");
-var import_core9 = require("@aiready/core");
+var import_core10 = require("@aiready/core");
 var import_prompts = __toESM(require("prompts"));
 var program = new import_commander.Command();
 program.name("aiready-context").description("Analyze AI context window cost and code structure").version("0.1.0").addHelpText(
@@ -1705,7 +1860,7 @@ program.name("aiready-context").description("Analyze AI context window cost and
       exclude: void 0,
       maxResults: 10
     };
-    let finalOptions = await (0, import_core9.loadMergedConfig)(directory, defaults, {
+    let finalOptions = await (0, import_core10.loadMergedConfig)(directory, defaults, {
       maxDepth: options.maxDepth ? parseInt(options.maxDepth) : void 0,
       maxContextBudget: options.maxContext ? parseInt(options.maxContext) : void 0,
       minCohesion: options.minCohesion ? parseFloat(options.minCohesion) : void 0,
@@ -1720,7 +1875,7 @@ program.name("aiready-context").description("Analyze AI context window cost and
       finalOptions = await runInteractiveSetup(directory, finalOptions);
     }
     const results = await analyzeContext(finalOptions);
-    const elapsedTime = (0, import_core9.getElapsedTime)(startTime);
+    const elapsedTime = (0, import_core10.getElapsedTime)(startTime);
     const summary = generateSummary(results);
     if (options.output === "json") {
       const jsonOutput = {
@@ -1729,12 +1884,12 @@ program.name("aiready-context").description("Analyze AI context window cost and
         timestamp: (/* @__PURE__ */ new Date()).toISOString(),
         analysisTime: elapsedTime
       };
-      const outputPath = (0, import_core9.resolveOutputPath)(
+      const outputPath = (0, import_core10.resolveOutputPath)(
         options.outputFile,
         `context-report-${(/* @__PURE__ */ new Date()).toISOString().split("T")[0]}.json`,
         directory
       );
-      (0, import_core9.handleJSONOutput)(
+      (0, import_core10.handleJSONOutput)(
         jsonOutput,
         outputPath,
         `
@@ -1744,7 +1899,7 @@ program.name("aiready-context").description("Analyze AI context window cost and
     }
     if (options.output === "html") {
       const html = generateHTMLReport(summary, results);
-      const outputPath = (0, import_core9.resolveOutputPath)(
+      const outputPath = (0, import_core10.resolveOutputPath)(
         options.outputFile,
         `context-report-${(/* @__PURE__ */ new Date()).toISOString().split("T")[0]}.html`,
         directory
@@ -1766,7 +1921,7 @@ program.name("aiready-context").description("Analyze AI context window cost and
     );
     displayTuningGuidance(results, finalOptions);
   } catch (error) {
-    (0, import_core9.handleCLIError)(error, "Analysis");
+    (0, import_core10.handleCLIError)(error, "Analysis");
   }
 });
 program.parse();

package/dist/cli.mjs

@@ -2,7 +2,7 @@
 import {
   analyzeContext,
   generateSummary
-} from "./chunk-7VK3XTSH.mjs";
+} from "./chunk-Q2GDZ2FZ.mjs";
 
 // src/cli.ts
 import { Command } from "commander";

package/dist/index.d.mts

@@ -1,4 +1,9 @@
-import { Severity, ScanOptions, CostConfig, ToolScoringOutput } from '@aiready/core';
+import { ToolProvider, Severity, ScanOptions, CostConfig, ToolScoringOutput } from '@aiready/core';
+
+/**
+ * Context Analyzer Tool Provider
+ */
+declare const ContextAnalyzerProvider: ToolProvider;
 
 interface ContextAnalyzerOptions extends ScanOptions {
     maxDepth?: number;
@@ -354,4 +359,4 @@ declare function findConsolidationCandidates(graph: DependencyGraph, coUsageMatr
  */
 declare function analyzeContext(options: ContextAnalyzerOptions): Promise<ContextAnalysisResult[]>;
 
-export { type CoUsageData, type ContextAnalysisResult, type ContextAnalyzerOptions, type ContextSummary, type DependencyGraph, type DependencyNode, type DomainAssignment, type DomainSignals, type ExportInfo, type FileClassification, type ModuleCluster, type TypeDependency, adjustCohesionForClassification, adjustFragmentationForClassification, analyzeContext, analyzeIssues, buildCoUsageMatrix, buildDependencyGraph, buildTypeGraph, calculateCohesion, calculateContextBudget, calculateContextScore, calculateDirectoryDistance, calculateDomainConfidence, calculateEnhancedCohesion, calculateFragmentation, calculateImportDepth, calculatePathEntropy, calculateStructuralCohesionFromCoUsage, classifyFile, detectCircularDependencies, detectModuleClusters, extractDomainKeywordsFromPaths, extractExports, extractImportsFromContent, findConsolidationCandidates, findSemanticClusters, generateSummary, getClassificationRecommendations, getCoUsageData, getGeneralRecommendations, getSmartDefaults, getTransitiveDependencies, inferDomain, inferDomainFromSemantics, isBarrelExport, isConfigFile, isEmailTemplate, isLambdaHandler, isNextJsPage, isParserFile, isServiceFile, isSessionFile, isTypeDefinition, isUtilityModule, mapScoreToRating };
+export { type CoUsageData, type ContextAnalysisResult, type ContextAnalyzerOptions, ContextAnalyzerProvider, type ContextSummary, type DependencyGraph, type DependencyNode, type DomainAssignment, type DomainSignals, type ExportInfo, type FileClassification, type ModuleCluster, type TypeDependency, adjustCohesionForClassification, adjustFragmentationForClassification, analyzeContext, analyzeIssues, buildCoUsageMatrix, buildDependencyGraph, buildTypeGraph, calculateCohesion, calculateContextBudget, calculateContextScore, calculateDirectoryDistance, calculateDomainConfidence, calculateEnhancedCohesion, calculateFragmentation, calculateImportDepth, calculatePathEntropy, calculateStructuralCohesionFromCoUsage, classifyFile, detectCircularDependencies, detectModuleClusters, extractDomainKeywordsFromPaths, extractExports, extractImportsFromContent, findConsolidationCandidates, findSemanticClusters, generateSummary, getClassificationRecommendations, getCoUsageData, getGeneralRecommendations, getSmartDefaults, getTransitiveDependencies, inferDomain, inferDomainFromSemantics, isBarrelExport, isConfigFile, isEmailTemplate, isLambdaHandler, isNextJsPage, isParserFile, isServiceFile, isSessionFile, isTypeDefinition, isUtilityModule, mapScoreToRating };

package/dist/index.d.ts

@@ -1,4 +1,9 @@
-import { Severity, ScanOptions, CostConfig, ToolScoringOutput } from '@aiready/core';
+import { ToolProvider, Severity, ScanOptions, CostConfig, ToolScoringOutput } from '@aiready/core';
+
+/**
+ * Context Analyzer Tool Provider
+ */
+declare const ContextAnalyzerProvider: ToolProvider;
 
 interface ContextAnalyzerOptions extends ScanOptions {
     maxDepth?: number;
@@ -354,4 +359,4 @@ declare function findConsolidationCandidates(graph: DependencyGraph, coUsageMatr
  */
 declare function analyzeContext(options: ContextAnalyzerOptions): Promise<ContextAnalysisResult[]>;
 
-export { type CoUsageData, type ContextAnalysisResult, type ContextAnalyzerOptions, type ContextSummary, type DependencyGraph, type DependencyNode, type DomainAssignment, type DomainSignals, type ExportInfo, type FileClassification, type ModuleCluster, type TypeDependency, adjustCohesionForClassification, adjustFragmentationForClassification, analyzeContext, analyzeIssues, buildCoUsageMatrix, buildDependencyGraph, buildTypeGraph, calculateCohesion, calculateContextBudget, calculateContextScore, calculateDirectoryDistance, calculateDomainConfidence, calculateEnhancedCohesion, calculateFragmentation, calculateImportDepth, calculatePathEntropy, calculateStructuralCohesionFromCoUsage, classifyFile, detectCircularDependencies, detectModuleClusters, extractDomainKeywordsFromPaths, extractExports, extractImportsFromContent, findConsolidationCandidates, findSemanticClusters, generateSummary, getClassificationRecommendations, getCoUsageData, getGeneralRecommendations, getSmartDefaults, getTransitiveDependencies, inferDomain, inferDomainFromSemantics, isBarrelExport, isConfigFile, isEmailTemplate, isLambdaHandler, isNextJsPage, isParserFile, isServiceFile, isSessionFile, isTypeDefinition, isUtilityModule, mapScoreToRating };
+export { type CoUsageData, type ContextAnalysisResult, type ContextAnalyzerOptions, ContextAnalyzerProvider, type ContextSummary, type DependencyGraph, type DependencyNode, type DomainAssignment, type DomainSignals, type ExportInfo, type FileClassification, type ModuleCluster, type TypeDependency, adjustCohesionForClassification, adjustFragmentationForClassification, analyzeContext, analyzeIssues, buildCoUsageMatrix, buildDependencyGraph, buildTypeGraph, calculateCohesion, calculateContextBudget, calculateContextScore, calculateDirectoryDistance, calculateDomainConfidence, calculateEnhancedCohesion, calculateFragmentation, calculateImportDepth, calculatePathEntropy, calculateStructuralCohesionFromCoUsage, classifyFile, detectCircularDependencies, detectModuleClusters, extractDomainKeywordsFromPaths, extractExports, extractImportsFromContent, findConsolidationCandidates, findSemanticClusters, generateSummary, getClassificationRecommendations, getCoUsageData, getGeneralRecommendations, getSmartDefaults, getTransitiveDependencies, inferDomain, inferDomainFromSemantics, isBarrelExport, isConfigFile, isEmailTemplate, isLambdaHandler, isNextJsPage, isParserFile, isServiceFile, isSessionFile, isTypeDefinition, isUtilityModule, mapScoreToRating };

package/dist/index.js

@@ -37,7 +37,7 @@ __export(python_context_exports, {
 });
 async function analyzePythonContext(files, rootDir) {
   const results = [];
-  const parser = (0, import_core7.getParser)("dummy.py");
+  const parser = (0, import_core8.getParser)("dummy.py");
   if (!parser) {
     console.warn("Python parser not available");
     return results;
@@ -101,7 +101,7 @@ async function analyzePythonContext(files, rootDir) {
 }
 async function buildPythonDependencyGraph(files, rootDir) {
   const graph = /* @__PURE__ */ new Map();
-  const parser = (0, import_core7.getParser)("dummy.py");
+  const parser = (0, import_core8.getParser)("dummy.py");
   if (!parser) return graph;
   for (const file of files) {
     try {
@@ -181,7 +181,7 @@ async function calculatePythonImportDepth(file, dependencyGraph, visited, depth
 }
 function estimateContextBudget(code, imports, dependencyGraph) {
   void dependencyGraph;
-  let budget = (0, import_core7.estimateTokens)(code);
+  let budget = (0, import_core8.estimateTokens)(code);
   const avgTokensPerDep = 500;
   budget += imports.length * avgTokensPerDep;
   return budget;
@@ -231,11 +231,11 @@ function detectCircularDependencies2(file, dependencyGraph) {
   dfs(file, []);
   return [...new Set(circular)];
 }
-var import_core7, import_path, import_fs;
+var import_core8, import_path, import_fs;
 var init_python_context = __esm({
   "src/analyzers/python-context.ts"() {
     "use strict";
-    import_core7 = require("@aiready/core");
+    import_core8 = require("@aiready/core");
     import_path = require("path");
     import_fs = __toESM(require("fs"));
   }
@@ -244,6 +244,7 @@ var init_python_context = __esm({
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  ContextAnalyzerProvider: () => ContextAnalyzerProvider,
   adjustCohesionForClassification: () => adjustCohesionForClassification,
   adjustFragmentationForClassification: () => adjustFragmentationForClassification,
   analyzeContext: () => analyzeContext,
@@ -290,7 +291,7 @@ __export(index_exports, {
   mapScoreToRating: () => mapScoreToRating
 });
 module.exports = __toCommonJS(index_exports);
-var import_core8 = require("@aiready/core");
+var import_core9 = require("@aiready/core");
 
 // src/analyzer.ts
 var import_core4 = require("@aiready/core");
@@ -633,12 +634,9 @@ function calculateEnhancedCohesion(exports2, filePath, options) {
     }
   }
   const avgImportScore = pairsWithData > 0 ? importScoreTotal / pairsWithData : 0;
-  let score = 0;
-  if (anyImportData) {
-    score = domainScore * 0.4 + avgImportScore * 0.6;
-    if (score === 0 && domainScore === 0) score = 0.1;
-  } else {
-    score = domainScore;
+  let score = anyImportData ? domainScore * 0.4 + avgImportScore * 0.6 : domainScore;
+  if (anyImportData && score === 0 && domainScore === 0) {
+    score = 0.1;
   }
   let structuralScore = 0;
   for (const exp of exports2) {
@@ -677,19 +675,7 @@ function calculateFragmentation(files, domain, options) {
     files.map((f) => f.split("/").slice(0, -1).join("/"))
   );
   const uniqueDirs = directories.size;
-  let score = 0;
-  if (options?.useLogScale) {
-    if (uniqueDirs <= 1) score = 0;
-    else {
-      const total = files.length;
-      const base = options.logBase || Math.E;
-      const num = Math.log(uniqueDirs) / Math.log(base);
-      const den = Math.log(total) / Math.log(base);
-      score = den > 0 ? num / den : 0;
-    }
-  } else {
-    score = (uniqueDirs - 1) / (files.length - 1);
-  }
+  let score = options?.useLogScale ? uniqueDirs <= 1 ? 0 : Math.log(uniqueDirs) / Math.log(options.logBase || Math.E) / (Math.log(files.length) / Math.log(options.logBase || Math.E)) : (uniqueDirs - 1) / (files.length - 1);
   if (options?.sharedImportRatio && options.sharedImportRatio > 0.5) {
     const discount = (options.sharedImportRatio - 0.5) * 0.4;
     score = score * (1 - discount);
@@ -1504,6 +1490,9 @@ function isBuildArtifact(filePath) {
   return lower.includes("/node_modules/") || lower.includes("/dist/") || lower.includes("/build/") || lower.includes("/out/") || lower.includes("/.next/");
 }
 
+// src/provider.ts
+var import_core6 = require("@aiready/core");
+
 // src/scoring.ts
 var import_core5 = require("@aiready/core");
 function calculateContextScore(summary, costConfig) {
@@ -1612,7 +1601,7 @@ function calculateContextScore(summary, costConfig) {
   ];
   const productivityImpact = (0, import_core5.calculateProductivityImpact)(issues);
   return {
-    toolName: "context-analyzer",
+    toolName: import_core5.ToolName.ContextAnalyzer,
     score,
     rawMetrics: {
       avgContextBudget: Math.round(avgContextBudget),
@@ -1637,10 +1626,53 @@ function mapScoreToRating(score) {
   return "critical";
 }
 
+// src/provider.ts
+var ContextAnalyzerProvider = {
+  id: import_core6.ToolName.ContextAnalyzer,
+  alias: ["context", "fragmentation", "budget"],
+  async analyze(options) {
+    const results = await analyzeContext(options);
+    const summary = generateSummary(results);
+    const normalizedResults = results.map(
+      (r) => ({
+        fileName: r.file,
+        issues: r.issues.map((msg) => ({
+          type: import_core6.IssueType.ContextFragmentation,
+          severity: r.severity,
+          message: msg,
+          location: { file: r.file, line: 1 },
+          suggestion: r.recommendations[0]
+        })),
+        metrics: {
+          tokenCost: r.tokenCost,
+          complexityScore: r.importDepth
+          // Map other context-specific metrics if needed
+        }
+      })
+    );
+    return import_core6.SpokeOutputSchema.parse({
+      results: normalizedResults,
+      summary: {
+        ...summary
+      },
+      metadata: {
+        toolName: import_core6.ToolName.ContextAnalyzer,
+        version: "0.17.5",
+        timestamp: (/* @__PURE__ */ new Date()).toISOString()
+      }
+    });
+  },
+  score(output, options) {
+    const summary = output.summary;
+    return calculateContextScore(summary, options.costConfig);
+  },
+  defaultWeight: 19
+};
+
 // src/defaults.ts
-var import_core6 = require("@aiready/core");
+var import_core7 = require("@aiready/core");
 async function getSmartDefaults(directory, userOptions) {
-  const files = await (0, import_core6.scanFiles)({
+  const files = await (0, import_core7.scanFiles)({
     rootDir: directory,
     include: userOptions.include,
     exclude: userOptions.exclude
@@ -1812,6 +1844,7 @@ function generateSummary(results) {
 }
 
 // src/index.ts
+import_core9.ToolRegistry.register(ContextAnalyzerProvider);
 async function analyzeContext(options) {
   const {
     maxDepth = 5,
@@ -1822,7 +1855,7 @@ async function analyzeContext(options) {
     includeNodeModules = false,
     ...scanOptions
   } = options;
-  const files = await (0, import_core8.scanFiles)({
+  const files = await (0, import_core9.scanFiles)({
     ...scanOptions,
     exclude: includeNodeModules && scanOptions.exclude ? scanOptions.exclude.filter(
       (pattern) => pattern !== "**/node_modules/**"
@@ -1832,7 +1865,7 @@ async function analyzeContext(options) {
   const fileContents = await Promise.all(
     files.map(async (file) => ({
       file,
-      content: await (0, import_core8.readFileContent)(file)
+      content: await (0, import_core9.readFileContent)(file)
     }))
   );
   const graph = buildDependencyGraph(
@@ -1996,6 +2029,7 @@ async function analyzeContext(options) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  ContextAnalyzerProvider,
   adjustCohesionForClassification,
   adjustFragmentationForClassification,
   analyzeContext,

package/dist/index.mjs

@@ -1,4 +1,5 @@
 import {
+  ContextAnalyzerProvider,
   adjustCohesionForClassification,
   adjustFragmentationForClassification,
   analyzeContext,
@@ -43,8 +44,9 @@ import {
   isTypeDefinition,
   isUtilityModule,
   mapScoreToRating
-} from "./chunk-7VK3XTSH.mjs";
+} from "./chunk-Q2GDZ2FZ.mjs";
 export {
+  ContextAnalyzerProvider,
   adjustCohesionForClassification,
   adjustFragmentationForClassification,
   analyzeContext,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiready/context-analyzer",
-  "version": "0.17.5",
+  "version": "0.19.1",
   "description": "AI context window cost analysis - detect fragmented code, deep import chains, and expensive context budgets",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -49,7 +49,7 @@
     "commander": "^14.0.0",
     "chalk": "^5.3.0",
     "prompts": "^2.4.2",
-    "@aiready/core": "0.19.5"
+    "@aiready/core": "0.21.1"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",

package/src/index.ts

@@ -1,4 +1,4 @@
-import { scanFiles, readFileContent } from '@aiready/core';
+import { scanFiles, readFileContent, ToolRegistry } from '@aiready/core';
 import {
   buildDependencyGraph,
   calculateImportDepth,
@@ -16,18 +16,23 @@ import {
 import { calculateContextScore } from './scoring';
 import { getSmartDefaults } from './defaults';
 import { generateSummary } from './summary';
+import { ContextAnalyzerProvider } from './provider';
 import type {
   ContextAnalyzerOptions,
   ContextAnalysisResult,
   ContextSummary,
 } from './types';
 
+// Register with global registry
+ToolRegistry.register(ContextAnalyzerProvider);
+
 export * from './analyzer';
 export * from './scoring';
 export * from './defaults';
 export * from './summary';
 export * from './types';
 export * from './semantic-analysis';
+export { ContextAnalyzerProvider };
 
 /**
  * Analyze AI context window cost for a codebase