ai-localize-cli 2.0.1 → 2.0.4

package/CHANGELOG.md

@@ -1,5 +1,48 @@
 # ai-localize-cli
 
+## 2.0.3
+
+### Minor Changes
+
+- **`keyStyle` config option** — `extract` and `full-migrate` commands now respect `keyStyle: "screaming_snake"` in `ai-localize.config.json`; all scanned hardcoded strings are extracted with UPPER_SNAKE_CASE keys matching the text value (e.g. `"Save Changes"` -> key `SAVE_CHANGES`, value `"Save Changes"`) instead of the default hierarchical path-based key style
+- **`staticKeys` config option** — `extract` and `full-migrate` commands now inject `staticKeys` entries from config into every generated locale file regardless of scanning results; useful for enum labels, status codes, and other constant strings not present as literals in source files
+
+### Patch Changes
+
+- Updated dependencies
+  - ai-localize-scanner@2.0.3
+  - ai-localize-config@2.0.3
+  - ai-localize-shared@2.0.3
+  - ai-localize-aws-cloudfront@2.0.3
+  - ai-localize-codemods@2.0.3
+  - ai-localize-framework-detectors@2.0.3
+  - ai-localize-locale-engine@2.0.3
+  - ai-localize-reporting@2.0.3
+  - ai-localize-validators@2.0.3
+
+## 2.0.2
+
+### Minor Changes
+
+- **Flat locale layout in `extract` and `full-migrate` commands** — `--locale-structure flat` flag (or `localeStructure: "flat"` in config) now writes one `<lang>.json` per language with all namespace keys merged
+- **Rich CLI report output** — `report` command now renders a structured terminal dashboard with coverage bars, top-file charts, missing-translation rankings, AST-context distribution, AI Insights, and actionable recommended next steps
+- **HTML analytics dashboard** — `report --format html` now generates a fully self-contained interactive dashboard (light/dark theme, sortable tables, SVG donut chart, CSV/JSON export, print/PDF)
+
+### Patch Changes
+
+- **Bug fix — locale key prefix** — resolved an issue where locale keys included ancestor path segments when `sourceRoot` was an absolute path
+- **Bug fix — codemods config wired through** — `codemods` block in `ai-localize.config.json` is now applied by all codemod commands instead of being silently ignored
+- Updated dependencies
+  - ai-localize-scanner@2.0.2
+  - ai-localize-config@2.0.2
+  - ai-localize-shared@2.0.2
+  - ai-localize-aws-cloudfront@2.0.2
+  - ai-localize-codemods@2.0.2
+  - ai-localize-framework-detectors@2.0.2
+  - ai-localize-locale-engine@2.0.2
+  - ai-localize-reporting@2.0.2
+  - ai-localize-validators@2.0.2
+
 ## 2.0.1
 
 ### Patch Changes

package/dist/cli.js

@@ -167,6 +167,13 @@ function extractCommand() {
       spinner.succeed("Configuration loaded");
       const structure = config.localeStructure ?? "nested";
       logger.info("Locale structure: " + import_chalk4.default.cyan(structure));
+      const staticKeys = config.staticKeys ?? {};
+      const staticKeyCount = Object.keys(staticKeys).length;
+      if (staticKeyCount > 0) {
+        logger.info(
+          "Static keys: " + import_chalk4.default.cyan(String(staticKeyCount)) + " (" + Object.keys(staticKeys).join(", ") + ")"
+        );
+      }
       const ss = createSpinner("Scanning for hardcoded text...").start();
       const scanner = new import_ai_localize_scanner2.ProjectScanner(config);
       const scanResult = await scanner.scan();
@@ -176,11 +183,14 @@ function extractCommand() {
       const extractor = new import_ai_localize_locale_engine.LocaleExtractor({
         defaultLanguage: config.defaultLanguage,
         targetLanguages: config.targetLanguages,
-        namespaceSplitting: structure === "nested"
+        namespaceSplitting: structure === "nested",
         // flat mode does not need namespace splitting
+        staticKeys
       });
       const { localeFiles, keyCount, namespaces } = extractor.extract(uniqueTexts);
-      logger.info("Keys generated: " + import_chalk4.default.green(String(keyCount)));
+      logger.info(
+        "Keys generated: " + import_chalk4.default.green(String(keyCount)) + (staticKeyCount > 0 ? import_chalk4.default.dim(" (+ " + staticKeyCount + " static)") : "")
+      );
       if (structure === "nested") {
         logger.info("Namespaces: " + import_chalk4.default.cyan(namespaces.join(", ")));
       }

package/package.json

@@ -1,25 +1,49 @@
 {
   "name": "ai-localize-cli",
-  "version": "2.0.1",
-  "description": "CLI for ai-localize-core: scan, extract, validate, migrate CDN",
+  "version": "2.0.4",
+  "description": "CLI for ai-localize-core: scan, extract, validate, codemod and migrate CDN",
   "bin": {
     "ai-localize": "./dist/cli.js"
   },
   "main": "./dist/cli.js",
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "keywords": [
+    "i18n",
+    "localization",
+    "l10n",
+    "internationalization",
+    "ai-localize",
+    "cli",
+    "scan",
+    "extract",
+    "codemod",
+    "cdn",
+    "cloudfront",
+    "react",
+    "vue",
+    "angular"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
   "dependencies": {
     "commander": "^12.0.0",
     "chalk": "^5.3.0",
     "ora": "^8.0.1",
     "inquirer": "^9.2.12",
-    "ai-localize-shared": "2.0.1",
-    "ai-localize-framework-detectors": "2.0.1",
-    "ai-localize-config": "2.0.1",
-    "ai-localize-scanner": "2.0.1",
-    "ai-localize-codemods": "2.0.1",
-    "ai-localize-locale-engine": "2.0.1",
-    "ai-localize-aws-cloudfront": "2.0.1",
-    "ai-localize-validators": "2.0.1",
-    "ai-localize-reporting": "2.0.1"
+    "ai-localize-config": "2.0.4",
+    "ai-localize-scanner": "2.0.4",
+    "ai-localize-codemods": "2.0.4",
+    "ai-localize-framework-detectors": "2.0.4",
+    "ai-localize-shared": "2.0.4",
+    "ai-localize-validators": "2.0.4",
+    "ai-localize-aws-cloudfront": "2.0.4",
+    "ai-localize-locale-engine": "2.0.4",
+    "ai-localize-reporting": "2.0.4"
   },
   "devDependencies": {
     "@types/inquirer": "^9.0.7",

package/src/cli.ts

@@ -1,33 +0,0 @@
-import { Command } from 'commander';
-import chalk from 'chalk';
-import { PLATFORM_VERSION } from 'ai-localize-shared';
-import { initCommand } from './commands/init.js';
-import { scanCommand } from './commands/scan.js';
-import { extractCommand } from './commands/extract.js';
-import { validateCommand } from './commands/validate.js';
-import { cleanupCommand } from './commands/cleanup.js';
-import { migrateCdnCommand } from './commands/migrate-cdn.js';
-import { uploadAssetsCommand } from './commands/upload-assets.js';
-import { replaceCdnCommand } from './commands/replace-cdn.js';
-import { reportCommand } from './commands/report.js';
-import { fullMigrateCommand } from './commands/full-migrate.js';
-
-const program = new Command();
-
-program
-  .name('ai-localize')
-  .description(chalk.cyan('ai-localize-core') + ' — Deterministic localization + CloudFront migration platform')
-  .version(PLATFORM_VERSION, '-v, --version');
-
-program.addCommand(initCommand());
-program.addCommand(scanCommand());
-program.addCommand(extractCommand());
-program.addCommand(validateCommand());
-program.addCommand(cleanupCommand());
-program.addCommand(migrateCdnCommand());
-program.addCommand(uploadAssetsCommand());
-program.addCommand(replaceCdnCommand());
-program.addCommand(reportCommand());
-program.addCommand(fullMigrateCommand());
-
-program.parse(process.argv);

package/src/commands/cleanup.ts

@@ -1,56 +0,0 @@
-import { Command } from 'commander';
-import chalk from 'chalk';
-import * as path from 'path';
-import * as fs from 'fs';
-import { logger } from '../utils/logger.js';
-import { createSpinner } from '../utils/spinner.js';
-import { loadConfig } from 'ai-localize-config';
-import { UnusedKeyValidator } from 'ai-localize-validators';
-import { readJsonSafe, writeJson } from 'ai-localize-shared';
-
-export function cleanupCommand(): Command {
-  return new Command('cleanup')
-    .description('Remove unused locale keys from translation files')
-    .option('--cwd <path>', 'Working directory', process.cwd())
-    .option('--dry-run', 'Preview changes without modifying files')
-    .action(async (opts) => {
-      logger.header('ai-localize cleanup');
-      const spinner = createSpinner('Validating keys...').start();
-      try {
-        const cwd = opts.cwd as string;
-        const { config } = await loadConfig(cwd);
-        const localesDir = path.resolve(cwd, config.localesDir);
-        const sourceDir = path.resolve(cwd, config.sourceDir);
-
-        const validator = new UnusedKeyValidator(localesDir, sourceDir, config.defaultLanguage);
-        const { unusedKeys } = validator.validate();
-        spinner.succeed('Found ' + chalk.yellow(String(unusedKeys.length)) + ' unused keys');
-
-        if (unusedKeys.length === 0) { logger.success('No unused keys found!'); return; }
-        unusedKeys.slice(0, 20).forEach((k) => logger.dim('- ' + k));
-
-        if (!opts.dryRun) {
-          const defaultDir = path.join(localesDir, config.defaultLanguage);
-          const nsFiles = fs.readdirSync(defaultDir).filter((f) => f.endsWith('.json'));
-          let removed = 0;
-          for (const nsFile of nsFiles) {
-            const ns = nsFile.replace('.json', '');
-            const fp = path.join(defaultDir, nsFile);
-            const entries = readJsonSafe<Record<string, string>>(fp) || {};
-            for (const key of unusedKeys) {
-              const lk = key.startsWith(ns + '.') ? key.slice(ns.length + 1) : null;
-              if (lk && lk in entries) { delete entries[lk]; removed++; }
-            }
-            writeJson(fp, entries);
-          }
-          logger.success('Removed ' + removed + ' unused keys');
-        } else {
-          logger.info('Dry run - ' + unusedKeys.length + ' keys would be removed');
-        }
-      } catch (err) {
-        spinner.fail('Cleanup failed');
-        logger.error(String(err));
-        process.exit(1);
-      }
-    });
-}

package/src/commands/extract.ts

@@ -1,74 +0,0 @@
-import { Command } from 'commander';
-import chalk from 'chalk';
-import * as path from 'path';
-import { logger } from '../utils/logger.js';
-import { createSpinner } from '../utils/spinner.js';
-import { loadConfig } from 'ai-localize-config';
-import { ProjectScanner } from 'ai-localize-scanner';
-import { deduplicateTexts, LocaleExtractor, LocaleWriter } from 'ai-localize-locale-engine';
-
-export function extractCommand(): Command {
-  return new Command('extract')
-    .description('Extract hardcoded text to locale JSON files')
-    .option('--cwd <path>', 'Working directory', process.cwd())
-    .option('--dry-run', 'Preview changes without modifying files')
-    .option('--no-merge', 'Overwrite existing keys')
-    .action(async (opts) => {
-      logger.header('ai-localize extract');
-      const cwd = opts.cwd as string;
-      const spinner = createSpinner('Loading configuration...').start();
-   try {
-        const { config } = await loadConfig(cwd);
-        spinner.succeed('Configuration loaded');
-
-        // Log locale structure in use
-        const structure = config.localeStructure ?? 'nested';
-        logger.info('Locale structure: ' + chalk.cyan(structure));
-
-   const ss = createSpinner('Scanning for hardcoded text...').start();
-        const scanner = new ProjectScanner(config);
-        const scanResult = await scanner.scan();
-     ss.succeed('Found ' + chalk.cyan(String(scanResult.detectedTexts.length)) + ' texts in ' + scanResult.scannedFiles + ' files');
-
- const uniqueTexts = deduplicateTexts(scanResult.detectedTexts);
-     logger.info('Unique texts: ' + chalk.cyan(String(uniqueTexts.length)));
-
-      const extractor = new LocaleExtractor({
-   defaultLanguage: config.defaultLanguage,
-      targetLanguages: config.targetLanguages,
-          namespaceSplitting: structure === 'nested', // flat mode does not need namespace splitting
-    });
-        const { localeFiles, keyCount, namespaces } = extractor.extract(uniqueTexts);
-        logger.info('Keys generated: ' + chalk.green(String(keyCount)));
-        if (structure === 'nested') {
-          logger.info('Namespaces: ' + chalk.cyan(namespaces.join(', ')));
-        }
-
-     if (!opts.dryRun) {
-          const localesDir = path.resolve(cwd, config.localesDir);
-    const writer = new LocaleWriter({
-      localesDir,
-            merge: opts.merge !== false,
-        localeStructure: structure,
-          });
-     const { written, created, merged } = writer.write(localeFiles);
-          logger.success(
-            'Wrote ' + written.length + ' locale files (' + created.length + ' new, ' + merged.length + ' merged)'
-  );
-          written.forEach((f) => logger.info('  ' + chalk.gray(f)));
-        } else {
-          logger.info('Dry run — no files written');
-          localeFiles.forEach((lf) => {
-        const label = structure === 'flat'
-              ? `${lf.language}.json`
-              : `${lf.language}/${lf.namespace}.json`;
-  logger.info('  ' + chalk.gray(label) + ' — ' + Object.keys(lf.entries).length + ' keys');
-     });
-        }
-      } catch (err) {
- spinner.fail('Extraction failed');
-        logger.error(String(err));
-        process.exit(1);
-      }
-    });
-}

package/src/commands/full-migrate.ts

@@ -1,113 +0,0 @@
-import { Command } from 'commander';
-import chalk from 'chalk';
-import * as path from 'path';
-import { logger } from '../utils/logger.js';
-import { createSpinner } from '../utils/spinner.js';
-import { loadConfig } from 'ai-localize-config';
-import { ProjectScanner } from 'ai-localize-scanner';
-import { deduplicateTexts, LocaleExtractor, LocaleWriter } from 'ai-localize-locale-engine';
-import { CodemodRunner } from 'ai-localize-codemods';
-import { LocaleValidator } from 'ai-localize-validators';
-import { buildReport, generateHtmlReport, printCliSummary } from 'ai-localize-reporting';
-
-export function fullMigrateCommand(): Command {
-  return new Command('full-migrate')
-    .description('Run full localization pipeline: scan -> extract -> codemod -> validate -> report')
-    .option('--cwd <path>', 'Working directory', process.cwd())
-    .option('--dry-run', 'Preview changes without modifying files')
-    .option('--no-codemods', 'Skip codemod phase')
-    .option('--no-report', 'Skip report generation')
-    .option('--report-dir <path>', 'Directory where the HTML report is saved', '.ai-localize-reports')
- .action(async (opts) => {
-logger.header('ai-localize full-migrate');
-      const cwd = opts.cwd as string;
-      const dryRun = opts.dryRun as boolean;
-      try {
-        const cs = createSpinner('Loading configuration...').start();
-        const { config } = await loadConfig(cwd);
-        cs.succeed('Configuration loaded');
-
-        const structure = config.localeStructure ?? 'nested';
-
-        const ss = createSpinner('Scanning for hardcoded text...').start();
-        const scanner = new ProjectScanner(config);
-        const scanResult = await scanner.scan();
-        ss.succeed(
-          'Found ' + chalk.cyan(String(scanResult.detectedTexts.length)) +
- ' texts in ' + scanResult.scannedFiles + ' files'
-        );
-
-        const es = createSpinner('Extracting locale keys...').start();
-    const uniqueTexts = deduplicateTexts(scanResult.detectedTexts);
-        const extractor = new LocaleExtractor({
-          defaultLanguage: config.defaultLanguage,
-          targetLanguages: config.targetLanguages,
-          // Flat layout merges all keys into one file per language — no namespace splitting
-          namespaceSplitting: structure === 'nested',
-      });
-        const { localeFiles, keyCount } = extractor.extract(uniqueTexts);
-        es.succeed('Generated ' + chalk.green(String(keyCount)) + ' locale keys');
-
-   if (!dryRun) {
-      const writer = new LocaleWriter({
-        localesDir: path.resolve(cwd, config.localesDir),
-            merge: true,
-            localeStructure: structure,
-    });
-          writer.write(localeFiles);
-        }
-
-        if (opts.codemods !== false) {
-     const ms = createSpinner('Applying i18n codemods...').start();
-          // Pass cwd so CodemodRunner can compute per-file relative import paths
-          // when codemods.importPackage is a local project path (e.g. "src/Locales/translate").
-       const runner = new CodemodRunner(config, cwd);
-const codemodResult = await runner.run(uniqueTexts, { dryRun });
-          ms.succeed(
-      'Codemods: ' + chalk.green(String(codemodResult.totalReplacements)) +
-            ' replacements in ' + codemodResult.changedFiles + ' files'
-  );
-}
-
-     const vs = createSpinner('Validating locale files...').start();
-        const validator = new LocaleValidator({
-     localesDir: path.resolve(cwd, config.localesDir),
-          sourceDir: path.resolve(cwd, config.sourceDir),
-      defaultLanguage: config.defaultLanguage,
-     targetLanguages: config.targetLanguages,
-        });
-        const validationResult = validator.validate();
-        vs.succeed(
-          validationResult.valid
-  ? chalk.green('Locale files valid!')
-            : chalk.yellow(
-   validationResult.errors.length + ' errors, ' +
-  validationResult.warnings.length + ' warnings'
-      )
-        );
-
- if (opts.report !== false) {
-          const rs = createSpinner('Generating report...').start();
-   const report = buildReport({ scanResult, validationResult });
-
-   // Always write an HTML report file
-   const reportDir = path.resolve(cwd, opts.reportDir as string);
-    const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
-     const htmlPath = path.join(reportDir, 'report-' + timestamp + '.html');
-          generateHtmlReport(report, htmlPath);
-          rs.succeed('Report saved to ' + chalk.cyan(htmlPath));
-
-printCliSummary(report);
-    logger.info(
-            '\n  View report:\n' +
-      '  ' + chalk.underline('file://' + htmlPath)
-);
-     }
-
-   logger.success('Full migration complete!');
-      } catch (err) {
-        logger.error('Migration failed: ' + String(err));
-        process.exit(1);
-      }
-    });
-}

package/src/commands/init.ts

@@ -1,33 +0,0 @@
-import { Command } from 'commander';
-import chalk from 'chalk';
-import { logger } from '../utils/logger.js';
-import { createSpinner } from '../utils/spinner.js';
-import { writeDefaultConfig } from 'ai-localize-config';
-import { detectFramework } from 'ai-localize-framework-detectors';
-
-export function initCommand(): Command {
-  return new Command('init')
-    .description('Initialize ai-localize configuration in the current project')
-    .option('-f, --framework <type>', 'Override framework detection')
-    .option('--cwd <path>', 'Working directory', process.cwd())
-    .action(async (opts) => {
-      logger.header('ai-localize init');
-      const spinner = createSpinner('Detecting framework...').start();
-      try {
-        const cwd = opts.cwd as string;
-        let framework = opts.framework as string;
-        if (!framework) {
-          framework = detectFramework(cwd).framework;
-          spinner.succeed('Detected framework: ' + chalk.cyan(framework));
-        } else {
-          spinner.succeed('Using framework: ' + chalk.cyan(framework));
-        }
-        const configPath = writeDefaultConfig(cwd, framework);
-        logger.success('Config created: ' + chalk.cyan(configPath));
-      } catch (err: any) {
-        spinner.fail('Initialization failed');
-        logger.error(err.message);
-        process.exit(1);
-      }
-    });
-}

package/src/commands/migrate-cdn.ts

@@ -1,57 +0,0 @@
-import { Command } from 'commander';
-import chalk from 'chalk';
-import * as path from 'path';
-import { logger } from '../utils/logger.js';
-import { createSpinner } from '../utils/spinner.js';
-import { loadConfig } from 'ai-localize-config';
-import { ProjectScanner } from 'ai-localize-scanner';
-import { CdnMigrator } from 'ai-localize-aws-cloudfront';
-
-export function migrateCdnCommand(): Command {
-  return new Command('migrate-cdn')
-    .description('Migrate legacy CDN URLs to CloudFront')
-    .option('--cwd <path>', 'Working directory', process.cwd())
-    .option('--assets-dir <path>', 'Local assets directory to upload')
-    .option('--dry-run', 'Preview changes without executing')
-    .option('--invalidate', 'Invalidate CloudFront cache after upload')
-    .action(async (opts) => {
-      logger.header('ai-localize migrate-cdn');
-      const spinner = createSpinner('Loading configuration...').start();
-      try {
-        const cwd = opts.cwd as string;
-        const { config } = await loadConfig(cwd);
-        if (!config.aws?.bucket) {
-          spinner.fail('AWS configuration missing');
-          logger.error('Set aws.bucket and aws.distributionId in ai-localize.config.json');
-          process.exit(1);
-        }
-        spinner.succeed('Configuration loaded');
-
-        const ss = createSpinner('Scanning for legacy CDN URLs...').start();
-        const scanner = new ProjectScanner(config);
-        const scanResult = await scanner.scan();
-        ss.succeed('Found ' + chalk.yellow(String(scanResult.legacyCdnUrls.length)) + ' legacy CDN URLs');
-
-        if (scanResult.legacyCdnUrls.length === 0) { logger.success('No legacy CDN URLs found!'); return; }
-
-        const migrator = new CdnMigrator(config.aws!);
-        const result = await migrator.migrate({
-          sourceDir: path.resolve(cwd, config.sourceDir),
-          assetsDir: path.resolve(cwd, opts.assetsDir as string),
-          legacyCdnUrls: scanResult.legacyCdnUrls,
-          dryRun: opts.dryRun as boolean,
-          invalidateCache: opts.invalidate as boolean,
-          onProgress: (step) => logger.step(step),
-        });
-
-        logger.success('Migration complete in ' + result.duration + 'ms');
-        logger.info('  Assets uploaded: ' + chalk.green(String(result.uploadedAssets.length)));
-        logger.info('  URLs replaced:   ' + chalk.green(String(result.replacedUrls)));
-        if (result.invalidationId) logger.info('  Invalidation ID: ' + chalk.cyan(result.invalidationId));
-      } catch (err) {
-        spinner.fail('CDN migration failed');
-        logger.error(String(err));
-        process.exit(1);
-      }
-    });
-}

package/src/commands/replace-cdn.ts

@@ -1,55 +0,0 @@
-import { Command } from 'commander';
-import chalk from 'chalk';
-import * as path from 'path';
-import { logger } from '../utils/logger.js';
-import { createSpinner } from '../utils/spinner.js';
-import { loadConfig } from 'ai-localize-config';
-import { ProjectScanner } from 'ai-localize-scanner';
-import { readJsonSafe } from 'ai-localize-shared';
-import type { CloudFrontAsset } from 'ai-localize-shared';
-import { batchReplaceCdnUrls } from 'ai-localize-codemods';
-
-export function replaceCdnCommand(): Command {
-  return new Command('replace-cdn')
-    .description('Replace legacy CDN URLs with CloudFront URLs in source files')
-    .option('--cwd <path>', 'Working directory', process.cwd())
-    .option('--manifest <path>', 'Path to upload manifest JSON')
-    .option('--dry-run', 'Preview changes without executing')
-    .action(async (opts) => {
-      logger.header('ai-localize replace-cdn');
-      const spinner = createSpinner('Loading configuration...').start();
-      try {
-        const cwd = opts.cwd as string;
-        const { config } = await loadConfig(cwd);
-        spinner.succeed('Configuration loaded');
-
-        let assets: CloudFrontAsset[] = [];
-        if (opts.manifest) {
-          assets = readJsonSafe<CloudFrontAsset[]>(path.resolve(cwd, opts.manifest as string)) || [];
-        }
-
-        const ss = createSpinner('Scanning for legacy CDN URLs...').start();
-        const scanner = new ProjectScanner(config);
-        const scanResult = await scanner.scan();
-        ss.succeed('Found ' + chalk.yellow(String(scanResult.legacyCdnUrls.length)) + ' legacy CDN URLs');
-
-        if (scanResult.legacyCdnUrls.length === 0) { logger.success('No legacy CDN URLs found!'); return; }
-
-        if (!opts.dryRun) {
-          const rs = createSpinner('Replacing URLs...').start();
-          const replacedCount = await batchReplaceCdnUrls(
-            path.resolve(cwd, config.sourceDir),
-            scanResult.legacyCdnUrls,
-            assets
-          );
-          rs.succeed('Replaced ' + chalk.green(String(replacedCount)) + ' URLs');
-        } else {
-          logger.info('Dry run - no URLs replaced');
-        }
-      } catch (err) {
-        spinner.fail('CDN replacement failed');
-        logger.error(String(err));
-        process.exit(1);
-      }
-    });
-}

package/src/commands/report.ts

@@ -1,70 +0,0 @@
-import { Command } from 'commander';
-import chalk from 'chalk';
-import * as path from 'path';
-import { logger } from '../utils/logger.js';
-import { createSpinner } from '../utils/spinner.js';
-import { loadConfig } from 'ai-localize-config';
-import { ProjectScanner } from 'ai-localize-scanner';
-import { LocaleValidator } from 'ai-localize-validators';
-import { buildReport, generateHtmlReport, printCliSummary } from 'ai-localize-reporting';
-
-export function reportCommand(): Command {
-  return new Command('report')
-    .description('Generate an HTML localization report with full details')
- .option('--cwd <path>', 'Working directory', process.cwd())
-.option('--output-dir <path>', 'Directory where the HTML report is saved', '.ai-localize-reports')
-    .option('--filename <name>', 'Report filename (default: report-<timestamp>.html)')
-    .option('--no-open', 'Do not log the file path after generation')
-    .action(async (opts) => {
-      logger.header('ai-localize report');
-      const spinner = createSpinner('Loading configuration...').start();
-      try {
-        const cwd = opts.cwd as string;
-        const { config } = await loadConfig(cwd);
-        spinner.succeed('Configuration loaded');
-
-        const ss = createSpinner('Scanning project...').start();
-        const scanner = new ProjectScanner(config);
-const scanResult = await scanner.scan();
-  ss.succeed('Scanned ' + chalk.cyan(String(scanResult.scannedFiles)) + ' files');
-
-     const vs = createSpinner('Validating locale files...').start();
-        const validator = new LocaleValidator({
-          localesDir: path.resolve(cwd, config.localesDir),
-          sourceDir: path.resolve(cwd, config.sourceDir),
-          defaultLanguage: config.defaultLanguage,
-          targetLanguages: config.targetLanguages,
-        });
-        const validationResult = validator.validate();
-        vs.succeed(
-          validationResult.valid
-          ? chalk.green('Locale files valid')
-  : chalk.yellow(validationResult.errors.length + ' errors, ' + validationResult.warnings.length + ' warnings')
-  );
-
-        const rs = createSpinner('Building report...').start();
-     const report = buildReport({ scanResult, validationResult });
-
-        // Resolve output path — always a .html file, never a bare directory
-        const outDir = path.resolve(cwd, opts.outputDir as string);
- const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
-        const filename = (opts.filename as string | undefined) || ('report-' + timestamp + '.html');
-        const htmlPath = path.join(outDir, filename);
-
-        generateHtmlReport(report, htmlPath);
- rs.succeed('HTML report written to ' + chalk.cyan(htmlPath));
-
-        // Print CLI summary to terminal as well
-        printCliSummary(report);
-
-     logger.info(
-   '\n  Open the report in your browser:\n' +
-    '  ' + chalk.underline('file://' + htmlPath)
-        );
-   } catch (err) {
-        spinner.fail('Report generation failed');
-      logger.error(String(err));
-     process.exit(1);
-      }
-    });
-}

package/src/commands/scan.ts

@@ -1,114 +0,0 @@
-import { Command } from 'commander';
-import chalk from 'chalk';
-import * as path from 'path';
-import * as fs from 'fs';
-import { logger } from '../utils/logger.js';
-import { createSpinner } from '../utils/spinner.js';
-import { loadConfig } from 'ai-localize-config';
-import { ProjectScanner, GitScanner } from 'ai-localize-scanner';
-import { writeJson } from 'ai-localize-shared';
-
-export function scanCommand(): Command {
-  return new Command('scan')
-    .description('Scan project for hardcoded texts and asset references')
-    .option('--incremental', 'Scan only changed files based on git diff')
-    .option('--staged', 'Scan only git staged files')
-    .option('--cwd <path>', 'Working directory', process.cwd())
-    .option('--output <path>', 'Output JSON file path for full scan results')
-    .option('--extract-cdns <path>', 'Extract all discovered CDN/legacy URLs to a JSON file (e.g. cdn-urls.json)')
-    .action(async (opts) => {
-      logger.header('ai-localize scan');
-   const spinner = createSpinner('Loading configuration...').start();
-      try {
-        const cwd = opts.cwd as string;
-        const { config } = await loadConfig(cwd);
-        spinner.succeed('Configuration loaded');
-
-      let files: string[] | undefined;
-        if (opts.staged || opts.incremental) {
-       const git = new GitScanner(cwd);
-          files = opts.staged ? git.getStagedFiles() : git.getChangedFiles();
-     logger.info('Changed files: ' + chalk.cyan(String(files.length)));
-     }
-
-        const scanSpinner = createSpinner('Scanning files...').start();
-        const scanner = new ProjectScanner(config);
-        const result = await scanner.scan({ files });
-    scanSpinner.succeed('Scanned ' + chalk.cyan(String(result.scannedFiles)) + ' files in ' + chalk.cyan(result.duration + 'ms'));
-
-        logger.info('Hardcoded texts:  ' + chalk.yellow(String(result.detectedTexts.length)));
-  logger.info('Asset references: ' + chalk.blue(String(result.assets.length)));
-   logger.info('Legacy CDN URLs:  ' + chalk.red(String(result.legacyCdnUrls.length)));
-
-        if (opts.output) {
-     const outPath = path.resolve(cwd, opts.output as string);
- writeJson(outPath, result);
-      logger.success('Results saved to ' + chalk.cyan(outPath));
-        }
-
-        // Extract CDN URLs to a dedicated file
-        if (opts.extractCdns) {
-    const cdnOutPath = path.resolve(cwd, opts.extractCdns as string);
-
-          // Build a structured CDN list similar to locale files
-       const cdnList: {
-            summary: {
-           totalLegacyCdnUrls: number;
-      totalAssetReferences: number;
-     scannedAt: string;
-            };
-legacyCdnUrls: Array<{
-        url: string;
- assetPath: string;
-  filePath: string;
-          line: number;
-            }>;
-        assetReferences: Array<{
-       assetPath: string;
-      assetType: string;
-    referenceType: string;
-        filePath: string;
- line: number;
-            }>;
-          } = {
-            summary: {
-   totalLegacyCdnUrls: result.legacyCdnUrls.length,
-     totalAssetReferences: result.assets.length,
-              scannedAt: result.timestamp,
-        },
-          legacyCdnUrls: result.legacyCdnUrls.map((cdn) => ({
-       url: cdn.url,
-       assetPath: cdn.assetPath,
-          filePath: cdn.filePath,
-            line: cdn.line,
-          })),
-            assetReferences: result.assets.map((asset) => ({
-       assetPath: asset.assetPath,
-      assetType: asset.assetType,
-         referenceType: asset.referenceType,
-       filePath: asset.filePath,
-    line: asset.line,
-   })),
-          };
-
-          // Ensure output directory exists
-          const cdnOutDir = path.dirname(cdnOutPath);
-          if (!fs.existsSync(cdnOutDir)) {
-       fs.mkdirSync(cdnOutDir, { recursive: true });
-          }
-          fs.writeFileSync(cdnOutPath, JSON.stringify(cdnList, null, 2), 'utf-8');
-   logger.success('CDN URLs extracted to ' + chalk.cyan(cdnOutPath));
-logger.info(
- '  Legacy CDN URLs: ' +
-     chalk.red(String(result.legacyCdnUrls.length)) +
-              '  Asset References: ' +
-   chalk.blue(String(result.assets.length))
-          );
-        }
-      } catch (err: any) {
-      spinner.fail('Scan failed');
-    logger.error(err.message);
-     process.exit(1);
-      }
-    });
-}

package/src/commands/upload-assets.ts

@@ -1,50 +0,0 @@
-import { Command } from 'commander';
-import chalk from 'chalk';
-import * as path from 'path';
-import { logger } from '../utils/logger.js';
-import { createSpinner } from '../utils/spinner.js';
-import { loadConfig } from 'ai-localize-config';
-import { S3Uploader } from 'ai-localize-aws-cloudfront';
-import { writeJson } from 'ai-localize-shared';
-
-export function uploadAssetsCommand(): Command {
-  return new Command('upload-assets')
-    .description('Upload local assets to AWS S3')
-    .option('--cwd <path>', 'Working directory', process.cwd())
-    .option('--assets-dir <path>', 'Directory containing assets to upload')
-    .option('--force', 'Force upload even if file already exists with same hash')
-    .option('--output <path>', 'Output manifest JSON path')
-    .action(async (opts) => {
-      logger.header('ai-localize upload-assets');
-      const spinner = createSpinner('Loading configuration...').start();
-      try {
-        const cwd = opts.cwd as string;
-        const { config } = await loadConfig(cwd);
-        if (!config.aws?.bucket) {
-          spinner.fail('AWS configuration missing');
-          process.exit(1);
-        }
-        spinner.succeed('Configuration loaded');
-
-        const uploader = new S3Uploader(config.aws!);
-        const assetsDir = path.resolve(cwd, opts.assetsDir as string);
-        const uploadSpinner = createSpinner('Uploading assets...').start();
-        const result = await uploader.uploadDirectory({
-          assetsDir,
-          force: opts.force as boolean,
-          onProgress: (_a, done, total) => { uploadSpinner.text = 'Uploading ' + done + '/' + total; },
-        });
-        uploadSpinner.succeed('Uploaded ' + chalk.green(String(result.uploaded.length)) + ' (' + result.skipped.length + ' skipped)');
-
-        if (opts.output) {
-          const outPath = path.resolve(cwd, opts.output as string);
-          writeJson(outPath, [...result.uploaded, ...result.skipped]);
-          logger.success('Manifest saved to ' + chalk.cyan(outPath));
-        }
-      } catch (err) {
-        spinner.fail('Upload failed');
-        logger.error(String(err));
-        process.exit(1);
-      }
-    });
-}

package/src/commands/validate.ts

@@ -1,56 +0,0 @@
-import { Command } from 'commander';
-import chalk from 'chalk';
-import * as path from 'path';
-import { logger } from '../utils/logger.js';
-import { createSpinner } from '../utils/spinner.js';
-import { loadConfig } from 'ai-localize-config';
-import { LocaleValidator } from 'ai-localize-validators';
-
-export function validateCommand(): Command {
-  return new Command('validate')
-    .description('Validate locale files for missing/duplicate/unused keys')
-    .option('--cwd <path>', 'Working directory', process.cwd())
-    .option('--no-unused', 'Skip unused key check')
-    .option('--no-duplicates', 'Skip duplicate key check')
-    .option('--no-placeholders', 'Skip placeholder check')
-    .option('--fail-on-warning', 'Exit with error if warnings exist')
-    .action(async (opts) => {
-      logger.header('ai-localize validate');
-      const spinner = createSpinner('Loading configuration...').start();
-      try {
-        const cwd = opts.cwd as string;
-        const { config } = await loadConfig(cwd);
-        spinner.succeed('Configuration loaded');
-
-        const vs = createSpinner('Validating locale files...').start();
-        const validator = new LocaleValidator({
-          localesDir: path.resolve(cwd, config.localesDir),
-          sourceDir: path.resolve(cwd, config.sourceDir),
-          defaultLanguage: config.defaultLanguage,
-          targetLanguages: config.targetLanguages,
-          checkUnused: opts.unused !== false,
-          checkDuplicates: opts.duplicates !== false,
-          checkPlaceholders: opts.placeholders !== false,
-        });
-
-        const result = validator.validate();
-
-        if (result.valid) {
-          vs.succeed(chalk.green('Locale files are valid!'));
-        } else {
-          vs.fail(chalk.red(`Validation failed with ${result.errors.length} errors and ${result.warnings.length} warnings.`));
-        }
-
-        result.errors.forEach((err) => logger.error(`[${err.type}] ${err.message}`));
-        result.warnings.forEach((warn) => logger.warn(`[${warn.type}] ${warn.message}`));
-
-        if (!result.valid || (opts.failOnWarning && result.warnings.length > 0)) {
-          process.exit(1);
-        }
-      } catch (err) {
-        spinner.fail('Validation failed');
-        logger.error(String(err));
-        process.exit(1);
-      }
-    });
-}

package/src/utils/logger.ts

@@ -1,11 +0,0 @@
-import chalk from 'chalk';
-
-export const logger = {
-  info: (msg: string) => console.log(chalk.blue('i'), msg),
-  success: (msg: string) => console.log(chalk.green('v'), msg),
-  warn: (msg: string) => console.log(chalk.yellow('!'), msg),
-  error: (msg: string) => console.error(chalk.red('x'), msg),
-  step: (msg: string) => console.log(chalk.cyan('>'), msg),
-  dim: (msg: string) => console.log(chalk.dim(msg)),
-  header: (msg: string) => console.log('\n' + chalk.bold.cyan(msg) + '\n'),
-};

package/src/utils/spinner.ts

@@ -1,5 +0,0 @@
-import ora, { type Ora } from 'ora';
-
-export function createSpinner(text: string): Ora {
-  return ora({ text, color: 'cyan' });
-}

package/tsconfig.json

@@ -1,6 +0,0 @@
-{
-  "extends": "../../tsconfig.base.json",
-  "compilerOptions": { "outDir": "./dist", "rootDir": "./src" },
-"include": ["src/**/*"],
-  "exclude": ["node_modules", "dist"]
-}

package/tsup.config.ts

@@ -1,11 +0,0 @@
-import { defineConfig } from 'tsup';
-
-export default defineConfig({
-  entry: ['src/cli.ts'],
-  format: ['cjs'],
-  target: 'node18',
-  clean: true,
-  banner: {
-    js: '#!/usr/bin/env node',
-  },
-});