schemashift-cli 0.8.0 → 0.10.0

package/README.md

@@ -33,6 +33,10 @@ schemashift analyze <path> [options]
 | `--detailed` | Full stats with complexity scoring | Individual+ |
 | `--readiness <path>` | Migration readiness report, e.g. `yup->zod` | Individual+ |
 | `--complexity` | Per-schema complexity scores | Individual+ |
+| `--behavioral <migration>` | Behavioral difference warnings, e.g. `yup->zod` | Free |
+| `--bundle <migration>` | Bundle size estimation, e.g. `zod->valibot` | Individual+ |
+| `--performance <migration>` | Performance impact analysis, e.g. `zod-v3->v4` | Individual+ |
+| `--dedup` | Detect duplicate type definitions | Individual+ |
 
 ### `migrate`
 
@@ -73,6 +77,8 @@ schemashift migrate <path> [options]
 | `--compat-check` | Run compatibility check before migration | Pro+ |
 | `--fail-on-warnings` | Exit 1 if any warnings | Team |
 | `--max-risk-score <n>` | Exit 1 if any file exceeds risk score | Team |
+| `--scaffold-tests` | Generate validation tests after migration | Pro+ |
+| `--audit` | Enable migration audit logging | Team |
 
 ### `watch`
 
@@ -193,6 +199,18 @@ schemashift migrate ./src --chain yup->zod->valibot
 # CI mode
 schemashift migrate ./src --from yup --to zod --ci --report json
 
+# Backward migration: Zod→Yup
+schemashift migrate ./src --from zod --to yup
+
+# Backward migration: Valibot→Zod
+schemashift migrate ./src --from valibot --to zod
+
+# Analyze with behavioral warnings and bundle estimation
+schemashift analyze ./src --behavioral yup->zod --bundle yup->zod
+
+# Migrate with test scaffolding
+schemashift migrate ./src --from yup --to zod --scaffold-tests
+
 # Rollback last migration
 schemashift rollback
 ```

package/dist/cli.js

@@ -10,17 +10,25 @@ import { existsSync as existsSync4, readFileSync as readFileSync4, statSync, wri
 import { dirname as dirname2, join as join3, resolve as resolve2 } from "path";
 import { fileURLToPath } from "url";
 import {
+  BehavioralWarningAnalyzer,
+  BundleEstimator,
   CompatibilityAnalyzer,
   DetailedAnalyzer,
   detectFormLibraries,
   GovernanceEngine,
+  IncrementalTracker,
   loadConfig,
+  MigrationAuditLog,
   MigrationChain,
+  PerformanceAnalyzer,
   PluginLoader,
   SchemaAnalyzer,
   SchemaDependencyResolver,
-  TransformEngine
+  TestScaffolder,
+  TransformEngine,
+  TypeDedupDetector
 } from "@schemashift/core";
+import { createIoTsToEffectHandler } from "@schemashift/io-ts-effect";
 import { createIoTsToZodHandler } from "@schemashift/io-ts-zod";
 import { createJoiToZodHandler } from "@schemashift/joi-zod";
 
@@ -35827,7 +35835,13 @@ var TIER_FEATURES = {
     maxRiskScoreThreshold: false,
     formResolverMigration: false,
     complexityEstimator: false,
-    monorepoAware: false
+    monorepoAware: false,
+    behavioralWarnings: true,
+    bundleEstimator: false,
+    performanceAnalyzer: false,
+    typeDeduplication: false,
+    testScaffolding: false,
+    auditLogging: false
   },
   [
     "individual"
@@ -35854,7 +35868,13 @@ var TIER_FEATURES = {
     maxRiskScoreThreshold: false,
     formResolverMigration: true,
     complexityEstimator: true,
-    monorepoAware: false
+    monorepoAware: false,
+    behavioralWarnings: true,
+    bundleEstimator: true,
+    performanceAnalyzer: true,
+    typeDeduplication: true,
+    testScaffolding: false,
+    auditLogging: false
   },
   [
     "pro"
@@ -35867,7 +35887,14 @@ var TIER_FEATURES = {
       "zod-v3->v4",
       "io-ts->zod",
       "zod->valibot",
-      "any->valibot"
+      "any->valibot",
+      "zod->yup",
+      "valibot->zod",
+      "zod->arktype",
+      "arktype->zod",
+      "zod->superstruct",
+      "superstruct->zod",
+      "io-ts->effect"
     ],
     devices: 4,
     ciSupport: true,
@@ -35888,7 +35915,13 @@ var TIER_FEATURES = {
     maxRiskScoreThreshold: false,
     formResolverMigration: true,
     complexityEstimator: true,
-    monorepoAware: true
+    monorepoAware: true,
+    behavioralWarnings: true,
+    bundleEstimator: true,
+    performanceAnalyzer: true,
+    typeDeduplication: true,
+    testScaffolding: true,
+    auditLogging: false
   },
   [
     "team"
@@ -35901,7 +35934,14 @@ var TIER_FEATURES = {
       "zod-v3->v4",
       "io-ts->zod",
       "any->valibot",
-      "zod->valibot"
+      "zod->valibot",
+      "zod->yup",
+      "valibot->zod",
+      "zod->arktype",
+      "arktype->zod",
+      "zod->superstruct",
+      "superstruct->zod",
+      "io-ts->effect"
     ],
     devices: Infinity,
     ciSupport: true,
@@ -35922,7 +35962,13 @@ var TIER_FEATURES = {
     maxRiskScoreThreshold: true,
     formResolverMigration: true,
     complexityEstimator: true,
-    monorepoAware: true
+    monorepoAware: true,
+    behavioralWarnings: true,
+    bundleEstimator: true,
+    performanceAnalyzer: true,
+    typeDeduplication: true,
+    testScaffolding: true,
+    auditLogging: true
   }
 };
 function canUseMigration(tier, from, to) {
@@ -36199,9 +36245,14 @@ var LicenseManager = class {
 };
 
 // src/cli.ts
-import { createYupToZodHandler } from "@schemashift/yup-zod";
+import { createYupToZodHandler, createZodToYupHandler } from "@schemashift/yup-zod";
+import { createArktypeToZodHandler, createZodToArktypeHandler } from "@schemashift/zod-arktype";
+import {
+  createSuperstructToZodHandler,
+  createZodToSuperstructHandler
+} from "@schemashift/zod-superstruct";
 import { createZodV3ToV4Handler } from "@schemashift/zod-v3-v4";
-import { createZodToValibotHandler } from "@schemashift/zod-valibot";
+import { createValibotToZodHandler, createZodToValibotHandler } from "@schemashift/zod-valibot";
 import { Command } from "commander";
 import { glob as glob2 } from "glob";
 import { Listr } from "listr2";
@@ -36883,6 +36934,12 @@ var WatchMode = class {
     console.log(pc3.cyan(`
 Watching ${files.length} files for changes...
 `));
+    if (options.dependents && options.dependents.size > 0) {
+      console.log(
+        pc3.dim(`Dependency-aware mode: ${options.dependents.size} files with dependents
+`)
+      );
+    }
     console.log(pc3.dim("Press Ctrl+C to stop\n"));
     const directories = new Set(files.map((f) => f.split("/").slice(0, -1).join("/")));
     for (const dir of directories) {
@@ -36903,8 +36960,26 @@ Watching ${files.length} files for changes...
 Changed: ${relative2(process.cwd(), fullPath)}`));
             try {
               await options.onTransform(fullPath);
-              console.log(pc3.green(`Transformed successfully
-`));
+              console.log(pc3.green(`Transformed successfully`));
+              const dependentFiles = options.dependents?.get(fullPath);
+              if (dependentFiles && dependentFiles.length > 0) {
+                console.log(
+                  pc3.cyan(`  Re-transforming ${dependentFiles.length} dependent file(s)...`)
+                );
+                for (const depFile of dependentFiles) {
+                  try {
+                    await options.onTransform(depFile);
+                    console.log(pc3.green(`  \u2713 ${relative2(process.cwd(), depFile)}`));
+                  } catch (error) {
+                    console.error(
+                      pc3.red(
+                        `  \u2717 ${relative2(process.cwd(), depFile)}: ${error instanceof Error ? error.message : String(error)}`
+                      )
+                    );
+                  }
+                }
+              }
+              console.log("");
             } catch (error) {
               console.error(
                 pc3.red(
@@ -36930,6 +37005,21 @@ Changed: ${relative2(process.cwd(), fullPath)}`));
     }
     this.debounceTimers.clear();
   }
+  /**
+   * Build a reverse dependency map (file -> files that depend on it).
+   * Takes the forward dependency map from SchemaDependencyResolver and inverts it.
+   */
+  static buildDependentsMap(dependencies) {
+    const dependents = /* @__PURE__ */ new Map();
+    for (const [file, deps] of dependencies) {
+      for (const dep of deps) {
+        const existing = dependents.get(dep) ?? [];
+        existing.push(file);
+        dependents.set(dep, existing);
+      }
+    }
+    return dependents;
+  }
   matchesPatterns(file, include, exclude) {
     const isIncluded = include.some((p) => minimatch(file, p));
     const isExcluded = exclude.some((p) => minimatch(file, p));
@@ -36948,6 +37038,13 @@ engine.registerHandler("joi", "zod", createJoiToZodHandler());
 engine.registerHandler("io-ts", "zod", createIoTsToZodHandler());
 engine.registerHandler("zod-v3", "v4", createZodV3ToV4Handler());
 engine.registerHandler("zod", "valibot", createZodToValibotHandler());
+engine.registerHandler("zod", "yup", createZodToYupHandler());
+engine.registerHandler("valibot", "zod", createValibotToZodHandler());
+engine.registerHandler("zod", "arktype", createZodToArktypeHandler());
+engine.registerHandler("arktype", "zod", createArktypeToZodHandler());
+engine.registerHandler("zod", "superstruct", createZodToSuperstructHandler());
+engine.registerHandler("superstruct", "zod", createSuperstructToZodHandler());
+engine.registerHandler("io-ts", "effect", createIoTsToEffectHandler());
 var POLAR_URL = "https://schemashift.qwady.app";
 program.name("schemashift").version(pkg.version).description("TypeScript schema migration CLI");
 program.command("init").description("Create .schemashiftrc.json config file").option("-f, --force", "Overwrite existing config").action((options) => {
@@ -36977,7 +37074,10 @@ program.command("init").description("Create .schemashiftrc.json config file").op
   console.log(pc4.green("Created .schemashiftrc.json"));
   console.log(pc4.dim("Edit the file to customize your migration settings."));
 });
-program.command("analyze <path>").description("Analyze schemas in your project").option("--json", "Output as JSON").option("-v, --verbose", "Show detailed analysis").option("--detailed", "Show complexity analysis (Individual+)").option("--readiness <migration>", "Check migration readiness, e.g. yup->zod (Individual+)").option("--complexity", "Show per-schema complexity scores (Individual+)").action(async (targetPath, options) => {
+program.command("analyze <path>").description("Analyze schemas in your project").option("--json", "Output as JSON").option("-v, --verbose", "Show detailed analysis").option("--detailed", "Show complexity analysis (Individual+)").option("--readiness <migration>", "Check migration readiness, e.g. yup->zod (Individual+)").option("--complexity", "Show per-schema complexity scores (Individual+)").option("--behavioral <migration>", "Show behavioral difference warnings, e.g. yup->zod").option("--bundle <migration>", "Show bundle size estimation, e.g. zod->valibot (Individual+)").option(
+  "--performance <migration>",
+  "Show performance impact analysis, e.g. zod-v3->v4 (Individual+)"
+).option("--dedup", "Detect duplicate type definitions (Individual+)").action(async (targetPath, options) => {
   const analyzer = new SchemaAnalyzer();
   let files;
   if (existsSync4(targetPath) && statSync(targetPath).isFile()) {
@@ -37158,13 +37258,147 @@ Migration Readiness: ${from} -> ${to}
       }
     }
   }
+  if (options.behavioral) {
+    const migParts = options.behavioral.split("->");
+    if (migParts.length !== 2) {
+      console.error(pc4.red("Invalid format. Use: --behavioral yup->zod"));
+    } else {
+      const [bFrom, bTo] = migParts;
+      const behavioralAnalyzer = new BehavioralWarningAnalyzer();
+      const sourceFiles = analyzer.getProject().getSourceFiles();
+      const behavioralResult = behavioralAnalyzer.analyze(
+        sourceFiles,
+        bFrom,
+        bTo
+      );
+      if (behavioralResult.warnings.length > 0) {
+        console.log(pc4.bold("\nBehavioral Difference Warnings\n"));
+        const byCategory = /* @__PURE__ */ new Map();
+        for (const w of behavioralResult.warnings) {
+          const existing = byCategory.get(w.category) ?? [];
+          existing.push(w);
+          byCategory.set(w.category, existing);
+        }
+        for (const [category, catWarnings] of byCategory) {
+          console.log(pc4.yellow(`  [${category}] ${catWarnings.length} warning(s)`));
+          for (const w of catWarnings.slice(0, 5)) {
+            console.log(`    ${w.message}`);
+            console.log(`    ${pc4.dim(w.detail)}`);
+          }
+          if (catWarnings.length > 5) {
+            console.log(pc4.dim(`    ... and ${catWarnings.length - 5} more`));
+          }
+        }
+      } else {
+        console.log(pc4.green("\nNo behavioral difference warnings found."));
+      }
+    }
+  }
+  if (options.bundle) {
+    const validation = await licenseManager.validate();
+    const tier = validation.license?.features || TIER_FEATURES[LicenseTier.FREE];
+    if (!tier.bundleEstimator) {
+      console.error(pc4.red("\nBundle estimation requires Individual tier or higher."));
+      console.log(`Upgrade at: ${pc4.cyan(POLAR_URL)}`);
+    } else {
+      const migParts = options.bundle.split("->");
+      if (migParts.length !== 2) {
+        console.error(pc4.red("Invalid format. Use: --bundle zod->valibot"));
+      } else {
+        const [bFrom, bTo] = migParts;
+        const bundleEstimator = new BundleEstimator();
+        const sourceFiles = analyzer.getProject().getSourceFiles();
+        const estimate = bundleEstimator.estimate(
+          sourceFiles,
+          bFrom,
+          bTo
+        );
+        console.log(pc4.bold("\nBundle Size Estimation\n"));
+        console.log(
+          `  ${estimate.from.library}: ~${pc4.cyan(`${estimate.from.minifiedGzipKb}kB`)}`
+        );
+        console.log(`  ${estimate.to.library}: ~${pc4.cyan(`${estimate.to.minifiedGzipKb}kB`)}`);
+        console.log(
+          `  Delta: ${pc4.yellow(`${estimate.estimatedDelta > 0 ? "+" : ""}${estimate.estimatedDelta.toFixed(1)}kB (${estimate.deltaPercent.toFixed(0)}%)`)}`
+        );
+        console.log(`
+  ${pc4.dim(estimate.summary)}`);
+      }
+    }
+  }
+  if (options.performance) {
+    const validation = await licenseManager.validate();
+    const tier = validation.license?.features || TIER_FEATURES[LicenseTier.FREE];
+    if (!tier.performanceAnalyzer) {
+      console.error(pc4.red("\nPerformance analysis requires Individual tier or higher."));
+      console.log(`Upgrade at: ${pc4.cyan(POLAR_URL)}`);
+    } else {
+      const migParts = options.performance.split("->");
+      if (migParts.length !== 2) {
+        console.error(pc4.red("Invalid format. Use: --performance zod-v3->v4"));
+      } else {
+        const [pFrom, pTo] = migParts;
+        const perfAnalyzer = new PerformanceAnalyzer();
+        const sourceFiles = analyzer.getProject().getSourceFiles();
+        const perfResult = perfAnalyzer.analyze(
+          sourceFiles,
+          pFrom,
+          pTo
+        );
+        if (perfResult.warnings.length > 0) {
+          console.log(pc4.bold("\nPerformance Impact Analysis\n"));
+          for (const w of perfResult.warnings) {
+            const color = w.severity === "error" ? pc4.red : w.severity === "warning" ? pc4.yellow : pc4.dim;
+            console.log(`  ${color(`[${w.severity}]`)} ${w.message}`);
+            console.log(`    ${pc4.dim(w.detail)}`);
+          }
+          console.log(`
+  ${pc4.dim(perfResult.recommendation)}`);
+        } else {
+          console.log(pc4.green("\nNo performance concerns detected."));
+        }
+      }
+    }
+  }
+  if (options.dedup) {
+    const validation = await licenseManager.validate();
+    const tier = validation.license?.features || TIER_FEATURES[LicenseTier.FREE];
+    if (!tier.typeDeduplication) {
+      console.error(pc4.red("\nType deduplication detection requires Individual tier or higher."));
+      console.log(`Upgrade at: ${pc4.cyan(POLAR_URL)}`);
+    } else {
+      const dedupDetector = new TypeDedupDetector();
+      const sourceFiles = analyzer.getProject().getSourceFiles();
+      const dedupResult = dedupDetector.detect(sourceFiles);
+      if (dedupResult.candidates.length > 0) {
+        console.log(pc4.bold("\nDuplicate Type Candidates\n"));
+        for (const c of dedupResult.candidates.slice(0, 10)) {
+          console.log(`  ${pc4.cyan(c.typeName)} <-> ${pc4.cyan(c.schemaName)}`);
+          console.log(`    Type: ${pc4.dim(c.typeFilePath)}:${c.typeLineNumber}`);
+          console.log(`    Schema: ${pc4.dim(c.schemaFilePath)}:${c.schemaLineNumber}`);
+          console.log(`    Confidence: ${pc4.dim(c.confidence)} | ${pc4.dim(c.suggestion)}`);
+        }
+        if (dedupResult.candidates.length > 10) {
+          console.log(pc4.dim(`  ... and ${dedupResult.candidates.length - 10} more`));
+        }
+      } else {
+        console.log(pc4.green("\nNo duplicate type candidates found."));
+      }
+    }
+  }
 });
-program.command("migrate <path>").description("Migrate schemas from one library to another").requiredOption("-f, --from <library>", "Source library (yup, joi, io-ts, zod-v3, zod)").requiredOption("-t, --to <library>", "Target library (zod, v4, valibot)").option("-d, --dry-run", "Preview changes without writing files").option("-v, --verbose", "Show detailed transformation info").option("-c, --config <path>", "Path to config file").option("--report <format>", "Generate report (json, html, csv)").option("--report-output <path>", "Report output path").option("--git-branch", "Create git branch for changes").option("--git-commit", "Auto-commit changes").option("--no-backup", "Skip backup creation").option("--yes", "Skip confirmation prompt").option("--ci", "CI mode (non-interactive, exit code on failure)").option("--cross-file", "Resolve cross-file schema dependencies (Pro+)").option("--chain <path>", "Chain migrations, e.g. yup->zod->valibot (Pro+)").option("--compat-check", "Run compatibility check before migration (Pro+)").option("--fail-on-warnings", "Exit 1 if any warnings (Team+)").option(
+program.command("migrate <path>").description("Migrate schemas from one library to another").option("-f, --from <library>", "Source library (yup, joi, io-ts, zod-v3, zod)").option("-t, --to <library>", "Target library (zod, v4, valibot, yup, arktype, superstruct)").option("-d, --dry-run", "Preview changes without writing files").option("-v, --verbose", "Show detailed transformation info").option("-c, --config <path>", "Path to config file").option("--report <format>", "Generate report (json, html, csv)").option("--report-output <path>", "Report output path").option("--git-branch", "Create git branch for changes").option("--git-commit", "Auto-commit changes").option("--no-backup", "Skip backup creation").option("--yes", "Skip confirmation prompt").option("--ci", "CI mode (non-interactive, exit code on failure)").option("--cross-file", "Resolve cross-file schema dependencies (Pro+)").option("--chain <path>", "Chain migrations, e.g. yup->zod->valibot (Pro+)").option("--compat-check", "Run compatibility check before migration (Pro+)").option("--fail-on-warnings", "Exit 1 if any warnings (Team+)").option(
   "--max-risk-score <score>",
   "Exit 1 if any file exceeds risk score (Team+)",
   Number.parseInt
-).action(async (targetPath, options) => {
+).option("--incremental", "Enable incremental migration (file-by-file with progress tracking)").option("--resume", "Resume a previously started incremental migration").option("--incremental-status", "Show incremental migration progress").option("--scaffold-tests", "Generate validation tests after migration (Pro+)").option("--audit", "Enable migration audit logging (Team+)").action(async (targetPath, options) => {
   const startTime = Date.now();
+  if (!options.chain && (!options.from || !options.to)) {
+    console.error(pc4.red("Either --from and --to, or --chain must be specified."));
+    console.error(pc4.dim("  Single-step: schemashift migrate <path> -f yup -t zod"));
+    console.error(pc4.dim("  Chain:       schemashift migrate <path> --chain yup->zod->valibot"));
+    process.exit(1);
+  }
   if (options.maxRiskScore !== void 0 && Number.isNaN(options.maxRiskScore)) {
     console.error(pc4.red("--max-risk-score must be a valid number."));
     process.exit(1);
@@ -37288,10 +37522,14 @@ Compatibility score: ${pc4.cyan(compatResult.overallScore.toString())}%`);
   if (options.chain) {
     const migrationChain = new MigrationChain();
     chainSteps = migrationChain.parseChain(options.chain);
-    const validation2 = migrationChain.validateChain(chainSteps, engine);
-    if (!validation2.valid) {
+    if (chainSteps.length > 0) {
+      if (!options.from) options.from = chainSteps[0]?.from;
+      if (!options.to) options.to = chainSteps[chainSteps.length - 1]?.to;
+    }
+    const chainValidation = migrationChain.validateChain(chainSteps, engine);
+    if (!chainValidation.valid) {
       console.error(pc4.red("Chain migration validation failed:"));
-      for (const err of validation2.errors) {
+      for (const err of chainValidation.errors) {
         console.error(`  ${pc4.red(err)}`);
       }
       process.exit(1);
@@ -37318,6 +37556,41 @@ Compatibility score: ${pc4.cyan(compatResult.overallScore.toString())}%`);
     console.log(pc4.yellow("No files found matching patterns."));
     process.exit(0);
   }
+  const incrementalTracker = new IncrementalTracker(resolve2(targetPath));
+  if (options.incrementalStatus) {
+    const progress = incrementalTracker.getProgress();
+    if (!progress) {
+      console.log(pc4.yellow("No incremental migration in progress."));
+      process.exit(0);
+    }
+    console.log(pc4.bold("\nIncremental Migration Status\n"));
+    console.log(`Completed: ${pc4.green(progress.completed.toString())}`);
+    console.log(`Remaining: ${pc4.cyan(progress.remaining.toString())}`);
+    console.log(`Failed:    ${pc4.red(progress.failed.toString())}`);
+    console.log(`Total:     ${progress.total}`);
+    console.log(`Progress:  ${pc4.cyan(`${progress.percent}%`)}`);
+    process.exit(0);
+  }
+  if (options.resume) {
+    const state = incrementalTracker.resume();
+    if (!state) {
+      console.error(pc4.red("No incremental migration to resume."));
+      process.exit(1);
+    }
+    files = state.remainingFiles;
+    console.log(pc4.dim(`Resuming incremental migration: ${state.migrationId}`));
+    const progress = incrementalTracker.getProgress();
+    if (progress) {
+      console.log(
+        pc4.dim(
+          `Progress: ${progress.completed}/${progress.total} completed (${progress.percent}%)`
+        )
+      );
+    }
+  } else if (options.incremental) {
+    incrementalTracker.start(files, options.from, options.to);
+    console.log(pc4.dim("Started incremental migration."));
+  }
   if (files.length > features.maxFiles) {
     console.error(
       pc4.red(`File limit exceeded. Found ${files.length}, max ${features.maxFiles}.`)
@@ -37452,6 +37725,30 @@ Migrating ${displayPath}
       }
     }
   }
+  if (options.incremental || options.resume) {
+    for (const result of results) {
+      if (result.success) {
+        incrementalTracker.markComplete(result.filePath);
+      } else {
+        incrementalTracker.markFailed(result.filePath);
+      }
+    }
+    const progress = incrementalTracker.getProgress();
+    if (progress) {
+      console.log(
+        pc4.bold(`
+Incremental: ${progress.completed}/${progress.total} (${progress.percent}%)`)
+      );
+      if (progress.remaining > 0) {
+        console.log(
+          pc4.dim(`Run with --resume to continue. ${progress.remaining} files remaining.`)
+        );
+      }
+      if (progress.failed > 0) {
+        console.log(pc4.yellow(`${progress.failed} file(s) failed. Run with --resume to retry.`));
+      }
+    }
+  }
   if (options.gitCommit && git.isAvailable() && !options.dryRun) {
     const successFiles = results.filter((r) => r.success).map((r) => r.filePath);
     if (successFiles.length > 0) {
@@ -37464,9 +37761,11 @@ Migrating ${displayPath}
     if (options.report === "html" && !features.htmlReports) {
       console.error(pc4.red("HTML reports require Individual tier or higher."));
       console.log(`Upgrade at: ${pc4.cyan(POLAR_URL)}`);
+      process.exit(1);
     } else if (options.report === "csv" && !features.csvExport) {
       console.error(pc4.red("CSV export requires Individual tier or higher."));
       console.log(`Upgrade at: ${pc4.cyan(POLAR_URL)}`);
+      process.exit(1);
     } else {
       const reporter = new ReportGenerator();
       const includeRisk = features.riskScoring;
@@ -37489,6 +37788,58 @@ Migrating ${displayPath}
       console.log(pc4.green(`Report saved: ${outputPath}`));
     }
   }
+  if (options.scaffoldTests) {
+    if (!features.testScaffolding) {
+      console.error(pc4.red("\nTest scaffolding requires Pro tier or higher."));
+      console.log(`Upgrade at: ${pc4.cyan(POLAR_URL)}`);
+    } else {
+      const scaffolder = new TestScaffolder();
+      const successfulFiles = results.filter((r) => r.success).map((r) => r.filePath);
+      if (successfulFiles.length > 0) {
+        const scaffoldAnalyzer = new SchemaAnalyzer();
+        for (const f of successfulFiles) {
+          scaffoldAnalyzer.addSourceFiles([f]);
+        }
+        const sourceFiles = scaffoldAnalyzer.getProject().getSourceFiles();
+        const scaffoldResult = scaffolder.scaffold(sourceFiles, options.from, options.to);
+        console.log(pc4.bold("\nTest Scaffolding\n"));
+        console.log(
+          `  Generated ${pc4.cyan(scaffoldResult.tests.length.toString())} test file(s) for ${scaffoldResult.totalSchemas} schema(s)`
+        );
+        for (const test of scaffoldResult.tests) {
+          console.log(`  ${pc4.dim(test.filePath)} (${test.schemaCount} schemas)`);
+        }
+      }
+    }
+  }
+  if (options.audit) {
+    if (!features.auditLogging) {
+      console.error(pc4.red("\nAudit logging requires Team tier."));
+      console.log(`Upgrade at: ${pc4.cyan(POLAR_URL)}`);
+    } else {
+      const projectPath = resolve2(targetPath);
+      const auditLog = new MigrationAuditLog(projectPath);
+      const migrationId = `${options.from}->${options.to}-${Date.now()}`;
+      for (const result of results) {
+        const entry = auditLog.createEntry({
+          migrationId,
+          filePath: result.filePath,
+          from: options.from,
+          to: options.to,
+          originalCode: result.originalCode ?? "",
+          transformedCode: result.transformedCode,
+          success: result.success,
+          warningCount: result.warnings.length,
+          errorCount: result.errors.length
+        });
+        auditLog.append(entry);
+      }
+      console.log(
+        pc4.dim(`
+Audit log saved to .schemashift/audit-log.json (${results.length} entries)`)
+      );
+    }
+  }
   if (options.dryRun) {
     const diffOutput = generateDiffPreview(results);
     if (diffOutput) {
@@ -37571,15 +37922,15 @@ program.command("watch <path>").description("Watch files and migrate on change")
     };
   }
   const watchMode = new WatchMode();
-  const analyzer = new SchemaAnalyzer();
   await watchMode.start({
     patterns: config2.include.map((p) => join3(targetPath, p)),
     exclude: config2.exclude,
     from: options.from,
     to: options.to,
     onTransform: async (file) => {
-      analyzer.addSourceFiles([file]);
-      const sourceFile = analyzer.getProject().getSourceFileOrThrow(resolve2(file));
+      const fileAnalyzer = new SchemaAnalyzer();
+      fileAnalyzer.addSourceFiles([file]);
+      const sourceFile = fileAnalyzer.getProject().getSourceFileOrThrow(resolve2(file));
       const result = engine.transform(sourceFile, options.from, options.to, {
         from: options.from,
         to: options.to,

package/dist/index.cjs

@@ -33791,7 +33791,13 @@ var TIER_FEATURES = {
     maxRiskScoreThreshold: false,
     formResolverMigration: false,
     complexityEstimator: false,
-    monorepoAware: false
+    monorepoAware: false,
+    behavioralWarnings: true,
+    bundleEstimator: false,
+    performanceAnalyzer: false,
+    typeDeduplication: false,
+    testScaffolding: false,
+    auditLogging: false
   },
   [
     "individual"
@@ -33818,7 +33824,13 @@ var TIER_FEATURES = {
     maxRiskScoreThreshold: false,
     formResolverMigration: true,
     complexityEstimator: true,
-    monorepoAware: false
+    monorepoAware: false,
+    behavioralWarnings: true,
+    bundleEstimator: true,
+    performanceAnalyzer: true,
+    typeDeduplication: true,
+    testScaffolding: false,
+    auditLogging: false
   },
   [
     "pro"
@@ -33831,7 +33843,14 @@ var TIER_FEATURES = {
       "zod-v3->v4",
       "io-ts->zod",
       "zod->valibot",
-      "any->valibot"
+      "any->valibot",
+      "zod->yup",
+      "valibot->zod",
+      "zod->arktype",
+      "arktype->zod",
+      "zod->superstruct",
+      "superstruct->zod",
+      "io-ts->effect"
     ],
     devices: 4,
     ciSupport: true,
@@ -33852,7 +33871,13 @@ var TIER_FEATURES = {
     maxRiskScoreThreshold: false,
     formResolverMigration: true,
     complexityEstimator: true,
-    monorepoAware: true
+    monorepoAware: true,
+    behavioralWarnings: true,
+    bundleEstimator: true,
+    performanceAnalyzer: true,
+    typeDeduplication: true,
+    testScaffolding: true,
+    auditLogging: false
   },
   [
     "team"
@@ -33865,7 +33890,14 @@ var TIER_FEATURES = {
       "zod-v3->v4",
       "io-ts->zod",
       "any->valibot",
-      "zod->valibot"
+      "zod->valibot",
+      "zod->yup",
+      "valibot->zod",
+      "zod->arktype",
+      "arktype->zod",
+      "zod->superstruct",
+      "superstruct->zod",
+      "io-ts->effect"
     ],
     devices: Infinity,
     ciSupport: true,
@@ -33886,7 +33918,13 @@ var TIER_FEATURES = {
     maxRiskScoreThreshold: true,
     formResolverMigration: true,
     complexityEstimator: true,
-    monorepoAware: true
+    monorepoAware: true,
+    behavioralWarnings: true,
+    bundleEstimator: true,
+    performanceAnalyzer: true,
+    typeDeduplication: true,
+    testScaffolding: true,
+    auditLogging: true
   }
 };
 var POLAR_ORG_ID = process.env.POLAR_ORG_ID || "79bbe935-1836-4b9e-9ca8-4c7a94217f5e";
@@ -34641,6 +34679,12 @@ var WatchMode = class {
     console.log(import_picocolors.default.cyan(`
 Watching ${files.length} files for changes...
 `));
+    if (options.dependents && options.dependents.size > 0) {
+      console.log(
+        import_picocolors.default.dim(`Dependency-aware mode: ${options.dependents.size} files with dependents
+`)
+      );
+    }
     console.log(import_picocolors.default.dim("Press Ctrl+C to stop\n"));
     const directories = new Set(files.map((f) => f.split("/").slice(0, -1).join("/")));
     for (const dir of directories) {
@@ -34661,8 +34705,26 @@ Watching ${files.length} files for changes...
 Changed: ${(0, import_node_path2.relative)(process.cwd(), fullPath)}`));
             try {
               await options.onTransform(fullPath);
-              console.log(import_picocolors.default.green(`Transformed successfully
-`));
+              console.log(import_picocolors.default.green(`Transformed successfully`));
+              const dependentFiles = options.dependents?.get(fullPath);
+              if (dependentFiles && dependentFiles.length > 0) {
+                console.log(
+                  import_picocolors.default.cyan(`  Re-transforming ${dependentFiles.length} dependent file(s)...`)
+                );
+                for (const depFile of dependentFiles) {
+                  try {
+                    await options.onTransform(depFile);
+                    console.log(import_picocolors.default.green(`  \u2713 ${(0, import_node_path2.relative)(process.cwd(), depFile)}`));
+                  } catch (error) {
+                    console.error(
+                      import_picocolors.default.red(
+                        `  \u2717 ${(0, import_node_path2.relative)(process.cwd(), depFile)}: ${error instanceof Error ? error.message : String(error)}`
+                      )
+                    );
+                  }
+                }
+              }
+              console.log("");
             } catch (error) {
               console.error(
                 import_picocolors.default.red(
@@ -34688,6 +34750,21 @@ Changed: ${(0, import_node_path2.relative)(process.cwd(), fullPath)}`));
     }
     this.debounceTimers.clear();
   }
+  /**
+   * Build a reverse dependency map (file -> files that depend on it).
+   * Takes the forward dependency map from SchemaDependencyResolver and inverts it.
+   */
+  static buildDependentsMap(dependencies) {
+    const dependents = /* @__PURE__ */ new Map();
+    for (const [file, deps] of dependencies) {
+      for (const dep of deps) {
+        const existing = dependents.get(dep) ?? [];
+        existing.push(file);
+        dependents.set(dep, existing);
+      }
+    }
+    return dependents;
+  }
   matchesPatterns(file, include, exclude) {
     const isIncluded = include.some((p) => (0, import_minimatch.minimatch)(file, p));
     const isExcluded = exclude.some((p) => (0, import_minimatch.minimatch)(file, p));

package/dist/index.d.cts

@@ -91,12 +91,19 @@ interface WatchOptions {
     from: string;
     to: string;
     onTransform: (file: string) => Promise<void>;
+    /** Optional: dependency map from SchemaDependencyResolver. Keys are file paths, values are lists of files that depend on the key. */
+    dependents?: Map<string, string[]>;
 }
 declare class WatchMode {
     private watchers;
     private debounceTimers;
     start(options: WatchOptions): Promise<void>;
     stop(): void;
+    /**
+     * Build a reverse dependency map (file -> files that depend on it).
+     * Takes the forward dependency map from SchemaDependencyResolver and inverts it.
+     */
+    static buildDependentsMap(dependencies: Map<string, string[]>): Map<string, string[]>;
     private matchesPatterns;
 }
 

package/dist/index.d.ts

@@ -91,12 +91,19 @@ interface WatchOptions {
     from: string;
     to: string;
     onTransform: (file: string) => Promise<void>;
+    /** Optional: dependency map from SchemaDependencyResolver. Keys are file paths, values are lists of files that depend on the key. */
+    dependents?: Map<string, string[]>;
 }
 declare class WatchMode {
     private watchers;
     private debounceTimers;
     start(options: WatchOptions): Promise<void>;
     stop(): void;
+    /**
+     * Build a reverse dependency map (file -> files that depend on it).
+     * Takes the forward dependency map from SchemaDependencyResolver and inverts it.
+     */
+    static buildDependentsMap(dependencies: Map<string, string[]>): Map<string, string[]>;
     private matchesPatterns;
 }
 

package/dist/index.js

@@ -33750,7 +33750,13 @@ var TIER_FEATURES = {
     maxRiskScoreThreshold: false,
     formResolverMigration: false,
     complexityEstimator: false,
-    monorepoAware: false
+    monorepoAware: false,
+    behavioralWarnings: true,
+    bundleEstimator: false,
+    performanceAnalyzer: false,
+    typeDeduplication: false,
+    testScaffolding: false,
+    auditLogging: false
   },
   [
     "individual"
@@ -33777,7 +33783,13 @@ var TIER_FEATURES = {
     maxRiskScoreThreshold: false,
     formResolverMigration: true,
     complexityEstimator: true,
-    monorepoAware: false
+    monorepoAware: false,
+    behavioralWarnings: true,
+    bundleEstimator: true,
+    performanceAnalyzer: true,
+    typeDeduplication: true,
+    testScaffolding: false,
+    auditLogging: false
   },
   [
     "pro"
@@ -33790,7 +33802,14 @@ var TIER_FEATURES = {
       "zod-v3->v4",
       "io-ts->zod",
       "zod->valibot",
-      "any->valibot"
+      "any->valibot",
+      "zod->yup",
+      "valibot->zod",
+      "zod->arktype",
+      "arktype->zod",
+      "zod->superstruct",
+      "superstruct->zod",
+      "io-ts->effect"
     ],
     devices: 4,
     ciSupport: true,
@@ -33811,7 +33830,13 @@ var TIER_FEATURES = {
     maxRiskScoreThreshold: false,
     formResolverMigration: true,
     complexityEstimator: true,
-    monorepoAware: true
+    monorepoAware: true,
+    behavioralWarnings: true,
+    bundleEstimator: true,
+    performanceAnalyzer: true,
+    typeDeduplication: true,
+    testScaffolding: true,
+    auditLogging: false
   },
   [
     "team"
@@ -33824,7 +33849,14 @@ var TIER_FEATURES = {
       "zod-v3->v4",
       "io-ts->zod",
       "any->valibot",
-      "zod->valibot"
+      "zod->valibot",
+      "zod->yup",
+      "valibot->zod",
+      "zod->arktype",
+      "arktype->zod",
+      "zod->superstruct",
+      "superstruct->zod",
+      "io-ts->effect"
     ],
     devices: Infinity,
     ciSupport: true,
@@ -33845,7 +33877,13 @@ var TIER_FEATURES = {
     maxRiskScoreThreshold: true,
     formResolverMigration: true,
     complexityEstimator: true,
-    monorepoAware: true
+    monorepoAware: true,
+    behavioralWarnings: true,
+    bundleEstimator: true,
+    performanceAnalyzer: true,
+    typeDeduplication: true,
+    testScaffolding: true,
+    auditLogging: true
   }
 };
 var POLAR_ORG_ID = process.env.POLAR_ORG_ID || "79bbe935-1836-4b9e-9ca8-4c7a94217f5e";
@@ -34608,6 +34646,12 @@ var WatchMode = class {
     console.log(pc.cyan(`
 Watching ${files.length} files for changes...
 `));
+    if (options.dependents && options.dependents.size > 0) {
+      console.log(
+        pc.dim(`Dependency-aware mode: ${options.dependents.size} files with dependents
+`)
+      );
+    }
     console.log(pc.dim("Press Ctrl+C to stop\n"));
     const directories = new Set(files.map((f) => f.split("/").slice(0, -1).join("/")));
     for (const dir of directories) {
@@ -34628,8 +34672,26 @@ Watching ${files.length} files for changes...
 Changed: ${relative2(process.cwd(), fullPath)}`));
             try {
               await options.onTransform(fullPath);
-              console.log(pc.green(`Transformed successfully
-`));
+              console.log(pc.green(`Transformed successfully`));
+              const dependentFiles = options.dependents?.get(fullPath);
+              if (dependentFiles && dependentFiles.length > 0) {
+                console.log(
+                  pc.cyan(`  Re-transforming ${dependentFiles.length} dependent file(s)...`)
+                );
+                for (const depFile of dependentFiles) {
+                  try {
+                    await options.onTransform(depFile);
+                    console.log(pc.green(`  \u2713 ${relative2(process.cwd(), depFile)}`));
+                  } catch (error) {
+                    console.error(
+                      pc.red(
+                        `  \u2717 ${relative2(process.cwd(), depFile)}: ${error instanceof Error ? error.message : String(error)}`
+                      )
+                    );
+                  }
+                }
+              }
+              console.log("");
             } catch (error) {
               console.error(
                 pc.red(
@@ -34655,6 +34717,21 @@ Changed: ${relative2(process.cwd(), fullPath)}`));
     }
     this.debounceTimers.clear();
   }
+  /**
+   * Build a reverse dependency map (file -> files that depend on it).
+   * Takes the forward dependency map from SchemaDependencyResolver and inverts it.
+   */
+  static buildDependentsMap(dependencies) {
+    const dependents = /* @__PURE__ */ new Map();
+    for (const [file, deps] of dependencies) {
+      for (const dep of deps) {
+        const existing = dependents.get(dep) ?? [];
+        existing.push(file);
+        dependents.set(dep, existing);
+      }
+    }
+    return dependents;
+  }
   matchesPatterns(file, include, exclude) {
     const isIncluded = include.some((p) => minimatch(file, p));
     const isExcluded = exclude.some((p) => minimatch(file, p));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "schemashift-cli",
-  "version": "0.8.0",
+  "version": "0.10.0",
   "description": "TypeScript schema migration CLI - migrate between Zod, Yup, Joi, and more",
   "type": "module",
   "bin": {
@@ -48,13 +48,19 @@
   },
   "author": "Joseph May",
   "license": "MIT",
+  "engines": {
+    "node": ">=22.0.0"
+  },
   "dependencies": {
-    "@schemashift/core": "0.8.0",
-    "@schemashift/io-ts-zod": "0.8.0",
-    "@schemashift/joi-zod": "0.8.0",
-    "@schemashift/yup-zod": "0.8.0",
-    "@schemashift/zod-valibot": "0.8.0",
-    "@schemashift/zod-v3-v4": "0.8.0",
+    "@schemashift/core": "0.10.0",
+    "@schemashift/io-ts-effect": "0.10.0",
+    "@schemashift/io-ts-zod": "0.10.0",
+    "@schemashift/joi-zod": "0.10.0",
+    "@schemashift/yup-zod": "0.10.0",
+    "@schemashift/zod-arktype": "0.10.0",
+    "@schemashift/zod-superstruct": "0.10.0",
+    "@schemashift/zod-valibot": "0.10.0",
+    "@schemashift/zod-v3-v4": "0.10.0",
     "commander": "14.0.2",
     "cosmiconfig": "9.0.0",
     "glob": "13.0.0",
@@ -63,7 +69,7 @@
     "picocolors": "1.1.1"
   },
   "devDependencies": {
-    "@schemashift/license": "0.5.0"
+    "@schemashift/license": "0.10.0"
   },
   "publishConfig": {
     "access": "public"