@aiready/context-analyzer 0.3.7 → 0.4.0

package/dist/cli.mjs

@@ -2,14 +2,15 @@
 import {
   analyzeContext,
   generateSummary
-} from "./chunk-T6ZCOPPI.mjs";
+} from "./chunk-HDFXSEFW.mjs";
 
 // src/cli.ts
 import { Command } from "commander";
 import chalk from "chalk";
-import { writeFileSync } from "fs";
+import { writeFileSync, existsSync, readFileSync } from "fs";
 import { join } from "path";
 import { loadMergedConfig, handleJSONOutput, handleCLIError, getElapsedTime } from "@aiready/core";
+import prompts from "prompts";
 var program = new Command();
 program.name("aiready-context").description("Analyze AI context window cost and code structure").version("0.1.0").addHelpText("after", "\nCONFIGURATION:\n  Supports config files: aiready.json, aiready.config.json, .aiready.json, .aireadyrc.json, aiready.config.js, .aireadyrc.js\n  CLI options override config file settings").argument("<directory>", "Directory to analyze").option("--max-depth <number>", "Maximum acceptable import depth").option(
   "--max-context <number>",
@@ -24,7 +25,7 @@ program.name("aiready-context").description("Analyze AI context window cost and
   "-o, --output <format>",
   "Output format: console, json, html",
   "console"
-).option("--output-file <path>", "Output file path (for json/html)").action(async (directory, options) => {
+).option("--output-file <path>", "Output file path (for json/html)").option("--interactive", "Run interactive setup to suggest excludes and focus areas").action(async (directory, options) => {
   console.log(chalk.blue("\u{1F50D} Analyzing context window costs...\n"));
   const startTime = Date.now();
   try {
@@ -39,7 +40,7 @@ program.name("aiready-context").description("Analyze AI context window cost and
       exclude: void 0,
       maxResults: 10
     };
-    const finalOptions = loadMergedConfig(directory, defaults, {
+    let finalOptions = 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,
@@ -50,6 +51,9 @@ program.name("aiready-context").description("Analyze AI context window cost and
       exclude: options.exclude?.split(","),
       maxResults: options.maxResults ? parseInt(options.maxResults) : void 0
     });
+    if (options.interactive) {
+      finalOptions = await runInteractiveSetup(directory, finalOptions);
+    }
     const results = await analyzeContext(finalOptions);
     const elapsedTime = getElapsedTime(startTime);
     const summary = generateSummary(results);
@@ -384,3 +388,55 @@ function generateHTMLReport(summary, results) {
 </body>
 </html>`;
 }
+async function runInteractiveSetup(directory, current) {
+  console.log(chalk.yellow("\u{1F9ED} Interactive mode: let\u2019s tailor the analysis."));
+  const pkgPath = join(directory, "package.json");
+  let deps = {};
+  if (existsSync(pkgPath)) {
+    try {
+      const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+      deps = { ...pkg.dependencies || {}, ...pkg.devDependencies || {} };
+    } catch {
+    }
+  }
+  const hasNextJs = existsSync(join(directory, ".next")) || !!deps["next"];
+  const hasCDK = existsSync(join(directory, "cdk.out")) || !!deps["aws-cdk-lib"] || Object.keys(deps).some((d) => d.startsWith("@aws-cdk/"));
+  const recommendedExcludes = new Set(current.exclude || []);
+  if (hasNextJs && !Array.from(recommendedExcludes).some((p) => p.includes(".next"))) {
+    recommendedExcludes.add("**/.next/**");
+  }
+  if (hasCDK && !Array.from(recommendedExcludes).some((p) => p.includes("cdk.out"))) {
+    recommendedExcludes.add("**/cdk.out/**");
+  }
+  const { applyExcludes } = await prompts({
+    type: "toggle",
+    name: "applyExcludes",
+    message: `Detected ${hasNextJs ? "Next.js " : ""}${hasCDK ? "AWS CDK " : ""}frameworks. Apply recommended excludes?`,
+    initial: true,
+    active: "yes",
+    inactive: "no"
+  });
+  let nextOptions = { ...current };
+  if (applyExcludes) {
+    nextOptions.exclude = Array.from(recommendedExcludes);
+  }
+  const { focusArea } = await prompts({
+    type: "select",
+    name: "focusArea",
+    message: "Which areas to focus?",
+    choices: [
+      { title: "Frontend (web app)", value: "frontend" },
+      { title: "Backend (API/infra)", value: "backend" },
+      { title: "Both", value: "both" }
+    ],
+    initial: 2
+  });
+  if (focusArea === "frontend") {
+    nextOptions.include = ["**/*.{ts,tsx,js,jsx}"];
+    nextOptions.exclude = Array.from(/* @__PURE__ */ new Set([...nextOptions.exclude || [], "**/cdk.out/**", "**/infra/**", "**/server/**", "**/backend/**"]));
+  } else if (focusArea === "backend") {
+    nextOptions.include = ["**/api/**", "**/server/**", "**/backend/**", "**/infra/**", "**/*.{ts,js,py,java}"];
+  }
+  console.log(chalk.green("\u2713 Interactive configuration applied."));
+  return nextOptions;
+}

package/dist/index.d.mts

@@ -67,6 +67,10 @@ interface ContextSummary {
     }>;
 }
 
+/**
+ * Generate smart defaults for context analysis based on repository size
+ */
+declare function getSmartDefaults(directory: string, userOptions: Partial<ContextAnalyzerOptions>): Promise<ContextAnalyzerOptions>;
 /**
  * Analyze AI context window cost for a codebase
  */
@@ -76,4 +80,4 @@ declare function analyzeContext(options: ContextAnalyzerOptions): Promise<Contex
  */
 declare function generateSummary(results: ContextAnalysisResult[]): ContextSummary;
 
-export { type ContextAnalysisResult, type ContextAnalyzerOptions, type ContextSummary, type ModuleCluster, analyzeContext, generateSummary };
+export { type ContextAnalysisResult, type ContextAnalyzerOptions, type ContextSummary, type ModuleCluster, analyzeContext, generateSummary, getSmartDefaults };

package/dist/index.d.ts

@@ -67,6 +67,10 @@ interface ContextSummary {
     }>;
 }
 
+/**
+ * Generate smart defaults for context analysis based on repository size
+ */
+declare function getSmartDefaults(directory: string, userOptions: Partial<ContextAnalyzerOptions>): Promise<ContextAnalyzerOptions>;
 /**
  * Analyze AI context window cost for a codebase
  */
@@ -76,4 +80,4 @@ declare function analyzeContext(options: ContextAnalyzerOptions): Promise<Contex
  */
 declare function generateSummary(results: ContextAnalysisResult[]): ContextSummary;
 
-export { type ContextAnalysisResult, type ContextAnalyzerOptions, type ContextSummary, type ModuleCluster, analyzeContext, generateSummary };
+export { type ContextAnalysisResult, type ContextAnalyzerOptions, type ContextSummary, type ModuleCluster, analyzeContext, generateSummary, getSmartDefaults };

package/dist/index.js

@@ -21,7 +21,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   analyzeContext: () => analyzeContext,
-  generateSummary: () => generateSummary
+  generateSummary: () => generateSummary,
+  getSmartDefaults: () => getSmartDefaults
 });
 module.exports = __toCommonJS(index_exports);
 var import_core2 = require("@aiready/core");
@@ -299,6 +300,50 @@ function generateConsolidationPlan(domain, files, targetFiles) {
 }
 
 // src/index.ts
+async function getSmartDefaults(directory, userOptions) {
+  const files = await (0, import_core2.scanFiles)({
+    rootDir: directory,
+    include: userOptions.include,
+    exclude: userOptions.exclude
+  });
+  const estimatedBlocks = files.length;
+  let maxDepth;
+  let maxContextBudget;
+  let minCohesion;
+  let maxFragmentation;
+  if (estimatedBlocks < 100) {
+    maxDepth = 3;
+    maxContextBudget = 5e3;
+    minCohesion = 0.7;
+    maxFragmentation = 0.3;
+  } else if (estimatedBlocks < 500) {
+    maxDepth = 4;
+    maxContextBudget = 8e3;
+    minCohesion = 0.65;
+    maxFragmentation = 0.4;
+  } else if (estimatedBlocks < 2e3) {
+    maxDepth = 5;
+    maxContextBudget = 12e3;
+    minCohesion = 0.6;
+    maxFragmentation = 0.5;
+  } else {
+    maxDepth = 6;
+    maxContextBudget = 2e4;
+    minCohesion = 0.55;
+    maxFragmentation = 0.6;
+  }
+  return {
+    maxDepth,
+    maxContextBudget,
+    minCohesion,
+    maxFragmentation,
+    focus: "all",
+    includeNodeModules: false,
+    rootDir: userOptions.rootDir || directory,
+    include: userOptions.include,
+    exclude: userOptions.exclude
+  };
+}
 async function analyzeContext(options) {
   const {
     maxDepth = 5,
@@ -554,10 +599,33 @@ function analyzeIssues(params) {
     issues.push("No significant issues detected");
     recommendations.push("File is well-structured for AI context usage");
   }
+  if (isBuildArtifact(file)) {
+    issues.push("Detected build artifact (bundled/output file)");
+    recommendations.push("Exclude build outputs (e.g., cdk.out, dist, build, .next) from analysis");
+    severity = downgradeSeverity(severity);
+    potentialSavings = 0;
+  }
   return { severity, issues, recommendations, potentialSavings: Math.floor(potentialSavings) };
 }
+function isBuildArtifact(filePath) {
+  const lower = filePath.toLowerCase();
+  return lower.includes("/node_modules/") || lower.includes("/dist/") || lower.includes("/build/") || lower.includes("/out/") || lower.includes("/output/") || lower.includes("/cdk.out/") || lower.includes("/.next/") || /\/asset\.[^/]+\//.test(lower);
+}
+function downgradeSeverity(s) {
+  switch (s) {
+    case "critical":
+      return "minor";
+    case "major":
+      return "minor";
+    case "minor":
+      return "info";
+    default:
+      return "info";
+  }
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   analyzeContext,
-  generateSummary
+  generateSummary,
+  getSmartDefaults
 });

package/dist/index.mjs

@@ -1,8 +1,10 @@
 import {
   analyzeContext,
-  generateSummary
-} from "./chunk-T6ZCOPPI.mjs";
+  generateSummary,
+  getSmartDefaults
+} from "./chunk-HDFXSEFW.mjs";
 export {
   analyzeContext,
-  generateSummary
+  generateSummary,
+  getSmartDefaults
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiready/context-analyzer",
-  "version": "0.3.7",
+  "version": "0.4.0",
   "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,10 +49,12 @@
   "dependencies": {
     "commander": "^12.1.0",
     "chalk": "^5.3.0",
-    "@aiready/core": "0.3.6"
+    "prompts": "^2.4.2",
+    "@aiready/core": "0.5.0"
   },
   "devDependencies": {
     "@types/node": "^22.10.2",
+    "@types/prompts": "^2.4.9",
     "tsup": "^8.3.5",
     "typescript": "^5.7.3",
     "vitest": "^2.1.9",

package/src/cli.ts

@@ -3,9 +3,10 @@
 import { Command } from 'commander';
 import { analyzeContext, generateSummary } from './index';
 import chalk from 'chalk';
-import { writeFileSync } from 'fs';
+import { writeFileSync, existsSync, readFileSync } from 'fs';
 import { join } from 'path';
 import { loadMergedConfig, handleJSONOutput, handleCLIError, getElapsedTime } from '@aiready/core';
+import prompts from 'prompts';
 
 const program = new Command();
 
@@ -39,6 +40,7 @@ program
     'console'
   )
   .option('--output-file <path>', 'Output file path (for json/html)')
+  .option('--interactive', 'Run interactive setup to suggest excludes and focus areas')
   .action(async (directory, options) => {
     console.log(chalk.blue('🔍 Analyzing context window costs...\n'));
 
@@ -59,7 +61,7 @@ program
       };
 
       // Load and merge config with CLI options
-      const finalOptions = loadMergedConfig(directory, defaults, {
+      let finalOptions = loadMergedConfig(directory, defaults, {
         maxDepth: options.maxDepth ? parseInt(options.maxDepth) : undefined,
         maxContextBudget: options.maxContext ? parseInt(options.maxContext) : undefined,
         minCohesion: options.minCohesion ? parseFloat(options.minCohesion) : undefined,
@@ -71,6 +73,11 @@ program
         maxResults: options.maxResults ? parseInt(options.maxResults) : undefined,
       }) as any;
 
+      // Optional: interactive setup to refine options for first-time users
+      if (options.interactive) {
+        finalOptions = await runInteractiveSetup(directory, finalOptions);
+      }
+
       const results = await analyzeContext(finalOptions);
 
       const elapsedTime = getElapsedTime(startTime);
@@ -455,3 +462,66 @@ function generateHTMLReport(
 </body>
 </html>`;
 }
+
+/**
+ * Interactive setup: detect common frameworks and suggest excludes & focus areas
+ */
+async function runInteractiveSetup(directory: string, current: any): Promise<any> {
+  console.log(chalk.yellow('🧭 Interactive mode: let’s tailor the analysis.'));
+
+  const pkgPath = join(directory, 'package.json');
+  let deps: Record<string, string> = {};
+  if (existsSync(pkgPath)) {
+    try {
+      const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+      deps = { ...(pkg.dependencies || {}), ...(pkg.devDependencies || {}) };
+    } catch {}
+  }
+
+  const hasNextJs = existsSync(join(directory, '.next')) || !!deps['next'];
+  const hasCDK = existsSync(join(directory, 'cdk.out')) || !!deps['aws-cdk-lib'] || Object.keys(deps).some(d => d.startsWith('@aws-cdk/'));
+
+  const recommendedExcludes = new Set<string>(current.exclude || []);
+  if (hasNextJs && !Array.from(recommendedExcludes).some((p) => p.includes('.next'))) {
+    recommendedExcludes.add('**/.next/**');
+  }
+  if (hasCDK && !Array.from(recommendedExcludes).some((p) => p.includes('cdk.out'))) {
+    recommendedExcludes.add('**/cdk.out/**');
+  }
+
+  const { applyExcludes } = await prompts({
+    type: 'toggle',
+    name: 'applyExcludes',
+    message: `Detected ${hasNextJs ? 'Next.js ' : ''}${hasCDK ? 'AWS CDK ' : ''}frameworks. Apply recommended excludes?`,
+    initial: true,
+    active: 'yes',
+    inactive: 'no',
+  });
+
+  let nextOptions = { ...current };
+  if (applyExcludes) {
+    nextOptions.exclude = Array.from(recommendedExcludes);
+  }
+
+  const { focusArea } = await prompts({
+    type: 'select',
+    name: 'focusArea',
+    message: 'Which areas to focus?',
+    choices: [
+      { title: 'Frontend (web app)', value: 'frontend' },
+      { title: 'Backend (API/infra)', value: 'backend' },
+      { title: 'Both', value: 'both' },
+    ],
+    initial: 2,
+  });
+
+  if (focusArea === 'frontend') {
+    nextOptions.include = ['**/*.{ts,tsx,js,jsx}'];
+    nextOptions.exclude = Array.from(new Set([...(nextOptions.exclude || []), '**/cdk.out/**', '**/infra/**', '**/server/**', '**/backend/**']));
+  } else if (focusArea === 'backend') {
+    nextOptions.include = ['**/api/**', '**/server/**', '**/backend/**', '**/infra/**', '**/*.{ts,js,py,java}'];
+  }
+
+  console.log(chalk.green('✓ Interactive configuration applied.'));
+  return nextOptions;
+}

package/src/index.ts

@@ -19,6 +19,67 @@ import type {
 
 export type { ContextAnalyzerOptions, ContextAnalysisResult, ContextSummary, ModuleCluster };
 
+/**
+ * Generate smart defaults for context analysis based on repository size
+ */
+async function getSmartDefaults(
+  directory: string,
+  userOptions: Partial<ContextAnalyzerOptions>
+): Promise<ContextAnalyzerOptions> {
+  // Estimate repository size by scanning files
+  const files = await scanFiles({
+    rootDir: directory,
+    include: userOptions.include,
+    exclude: userOptions.exclude,
+  });
+
+  const estimatedBlocks = files.length;
+
+  // Smart defaults based on repository size
+  let maxDepth: number;
+  let maxContextBudget: number;
+  let minCohesion: number;
+  let maxFragmentation: number;
+
+  if (estimatedBlocks < 100) {
+    // Small project
+    maxDepth = 3;
+    maxContextBudget = 5000;
+    minCohesion = 0.7;
+    maxFragmentation = 0.3;
+  } else if (estimatedBlocks < 500) {
+    // Medium project
+    maxDepth = 4;
+    maxContextBudget = 8000;
+    minCohesion = 0.65;
+    maxFragmentation = 0.4;
+  } else if (estimatedBlocks < 2000) {
+    // Large project
+    maxDepth = 5;
+    maxContextBudget = 12000;
+    minCohesion = 0.6;
+    maxFragmentation = 0.5;
+  } else {
+    // Enterprise project
+    maxDepth = 6;
+    maxContextBudget = 20000;
+    minCohesion = 0.55;
+    maxFragmentation = 0.6;
+  }
+
+  return {
+    maxDepth,
+    maxContextBudget,
+    minCohesion,
+    maxFragmentation,
+    focus: 'all',
+    includeNodeModules: false,
+    rootDir: userOptions.rootDir || directory,
+    include: userOptions.include,
+    exclude: userOptions.exclude,
+  };
+}
+
 /**
  * Analyze AI context window cost for a codebase
  */
@@ -392,5 +453,46 @@ function analyzeIssues(params: {
     recommendations.push('File is well-structured for AI context usage');
   }
 
+  // Detect build artifacts and downgrade severity to reduce noise
+  if (isBuildArtifact(file)) {
+    issues.push('Detected build artifact (bundled/output file)');
+    recommendations.push('Exclude build outputs (e.g., cdk.out, dist, build, .next) from analysis');
+    severity = downgradeSeverity(severity);
+    // Build artifacts do not represent actionable savings
+    potentialSavings = 0;
+  }
+
   return { severity, issues, recommendations, potentialSavings: Math.floor(potentialSavings) };
 }
+
+export { getSmartDefaults };
+
+/**
+ * Heuristic: identify common build artifact paths
+ */
+function isBuildArtifact(filePath: string): boolean {
+  const lower = filePath.toLowerCase();
+  return (
+    lower.includes('/node_modules/') ||
+    lower.includes('/dist/') ||
+    lower.includes('/build/') ||
+    lower.includes('/out/') ||
+    lower.includes('/output/') ||
+    lower.includes('/cdk.out/') ||
+    lower.includes('/.next/') ||
+    /\/asset\.[^/]+\//.test(lower) // e.g., cdk.out/asset.*
+  );
+}
+
+function downgradeSeverity(s: ContextAnalysisResult['severity']): ContextAnalysisResult['severity'] {
+  switch (s) {
+    case 'critical':
+      return 'minor';
+    case 'major':
+      return 'minor';
+    case 'minor':
+      return 'info';
+    default:
+      return 'info';
+  }
+}