@vlynk-studios/nodulus-core 1.2.0 → 1.2.5

package/dist/cli/index.js

@@ -8,13 +8,26 @@ import { Command } from "commander";
 import fs from "fs";
 import path from "path";
 import pc from "picocolors";
+
+// src/core/errors.ts
+var NodulusError = class extends Error {
+  code;
+  details;
+  constructor(code, message, details) {
+    super(message);
+    this.name = "NodulusError";
+    this.code = code;
+    this.details = details;
+  }
+};
+
+// src/cli/commands/create-module.ts
 function createModuleCommand() {
   return new Command("create-module").description("Scaffolds a new Nodulus module").argument("<name>", "Module name (lowercase, no spaces/special chars)").option("-p, --path <path>", "Destination folder path (default: src/modules/<name>)").option("--no-repository", "Skip generating a repository file").option("--no-schema", "Skip generating a schema file").option("--js", "Force generate JavaScript (.js) files").option("--ts", "Force generate TypeScript (.ts) files").action((name, options) => {
     if (!/^[a-z0-9-]+$/.test(name)) {
-      console.error(pc.red(`
+      throw new NodulusError("CLI_ERROR", pc.red(`
 Error: Invalid module name "${name}". Module names must be lowercase and contain only letters, numbers, or hyphens.
 `));
-      process.exit(1);
     }
     let ext;
     if (options.js) {
@@ -27,10 +40,9 @@ Error: Invalid module name "${name}". Module names must be lowercase and contain
     }
     const modulePath = options.path ? path.resolve(process.cwd(), options.path) : path.resolve(process.cwd(), `src/modules/${name}`);
     if (fs.existsSync(modulePath)) {
-      console.error(pc.red(`
+      throw new NodulusError("CLI_ERROR", pc.red(`
 Error: The directory "${modulePath}" already exists. Cannot scaffold module here.
 `));
-      process.exit(1);
     }
     fs.mkdirSync(modulePath, { recursive: true });
     const files = {
@@ -122,10 +134,9 @@ Schema('${capName}Schema', { module: '${name}' })
 
 // src/cli/commands/sync-tsconfig.ts
 import { Command as Command2 } from "commander";
-import fs3 from "fs";
-import path3 from "path";
+import fs4 from "fs";
+import path4 from "path";
 import pc3 from "picocolors";
-import fg from "fast-glob";
 import { parse, stringify } from "comment-json";
 
 // src/core/config.ts
@@ -171,25 +182,27 @@ function resolveLogLevel(explicit) {
 var defaultStrict = typeof process !== "undefined" && process.env?.NODE_ENV !== "production";
 var DEFAULTS = {
   modules: "src/modules/*",
+  domains: void 0,
+  shared: void 0,
   prefix: "",
   aliases: {},
   strict: defaultStrict,
   resolveAliases: true,
   logger: defaultLogHandler,
-  logLevel: resolveLogLevel()
+  logLevel: resolveLogLevel(),
+  nits: {
+    enabled: true,
+    similarityThreshold: void 0,
+    // Use dynamic by default
+    registryPath: ".nodulus/registry.json"
+  }
 };
 var loadConfig = async (options = {}) => {
   const cwd = process.cwd();
   let fileConfig = {};
   const tsPath = path2.join(cwd, "nodulus.config.ts");
   const jsPath = path2.join(cwd, "nodulus.config.js");
-  const isProduction = process.env.NODE_ENV === "production";
-  const hasTsLoader = process.execArgv.some((arg) => arg.includes("ts-node") || arg.includes("tsx")) || process._preload_modules?.some((m) => m.includes("ts-node") || m.includes("tsx"));
-  const candidates = [];
-  if (!isProduction || hasTsLoader) {
-    candidates.push(tsPath);
-  }
-  candidates.push(jsPath);
+  const candidates = [tsPath, jsPath];
   let configPathToLoad = null;
   for (const candidate of candidates) {
     if (fs2.existsSync(candidate)) {
@@ -216,6 +229,8 @@ var loadConfig = async (options = {}) => {
   }
   return {
     modules: options.modules ?? fileConfig.modules ?? DEFAULTS.modules,
+    domains: options.domains ?? fileConfig.domains ?? DEFAULTS.domains,
+    shared: options.shared ?? fileConfig.shared ?? DEFAULTS.shared,
     prefix: options.prefix ?? fileConfig.prefix ?? DEFAULTS.prefix,
     aliases: {
       ...DEFAULTS.aliases,
@@ -226,95 +241,148 @@ var loadConfig = async (options = {}) => {
     strict: options.strict ?? fileConfig.strict ?? DEFAULTS.strict,
     resolveAliases: options.resolveAliases ?? fileConfig.resolveAliases ?? DEFAULTS.resolveAliases,
     logger: options.logger ?? fileConfig.logger ?? DEFAULTS.logger,
-    logLevel: resolveLogLevel(options.logLevel ?? fileConfig.logLevel)
+    logLevel: resolveLogLevel(options.logLevel ?? fileConfig.logLevel),
+    nits: {
+      enabled: options.nits?.enabled ?? fileConfig.nits?.enabled ?? DEFAULTS.nits.enabled,
+      similarityThreshold: options.nits?.similarityThreshold ?? fileConfig.nits?.similarityThreshold ?? DEFAULTS.nits.similarityThreshold,
+      registryPath: options.nits?.registryPath ?? fileConfig.nits?.registryPath ?? DEFAULTS.nits.registryPath
+    }
   };
 };
 
+// src/cli/lib/tsconfig-generator.ts
+import fs3 from "fs";
+import path3 from "path";
+import fg from "fast-glob";
+async function generatePathAliases(config, cwd) {
+  const pathsObj = {};
+  if (config.modules) {
+    const globPattern = config.modules.replace(/\\/g, "/");
+    const moduleDirs = await fg(globPattern, {
+      onlyDirectories: true,
+      absolute: true,
+      cwd
+    });
+    moduleDirs.sort();
+    for (const dirPath of moduleDirs) {
+      const modName = path3.basename(dirPath);
+      const aliasKey = `@modules/${modName}`;
+      let indexPath = path3.join(dirPath, "index.ts");
+      if (!fs3.existsSync(indexPath)) {
+        indexPath = path3.join(dirPath, "index.js");
+      }
+      let relativeIndexPath = path3.relative(cwd, indexPath).replace(/\\/g, "/");
+      if (!relativeIndexPath.startsWith("./") && !relativeIndexPath.startsWith("../")) {
+        relativeIndexPath = "./" + relativeIndexPath;
+      }
+      let relativeDirPath = path3.relative(cwd, dirPath).replace(/\\/g, "/");
+      if (!relativeDirPath.startsWith("./") && !relativeDirPath.startsWith("../")) {
+        relativeDirPath = "./" + relativeDirPath;
+      }
+      pathsObj[aliasKey] = [relativeIndexPath];
+      pathsObj[`${aliasKey}/*`] = [`${relativeDirPath}/*`];
+    }
+  }
+  if (config.domains) {
+    const globPattern = config.domains.replace(/\\/g, "/");
+    const domainDirs = await fg(globPattern, {
+      onlyDirectories: true,
+      absolute: true,
+      cwd
+    });
+    domainDirs.sort();
+    for (const dirPath of domainDirs) {
+      const domainName = path3.basename(dirPath);
+      let indexPath = path3.join(dirPath, "index.ts");
+      if (!fs3.existsSync(indexPath)) {
+        indexPath = path3.join(dirPath, "index.js");
+      }
+      let relativeIndexPath = path3.relative(cwd, indexPath).replace(/\\/g, "/");
+      if (!relativeIndexPath.startsWith("./") && !relativeIndexPath.startsWith("../")) {
+        relativeIndexPath = "./" + relativeIndexPath;
+      }
+      let relativeDirPath = path3.relative(cwd, dirPath).replace(/\\/g, "/");
+      if (!relativeDirPath.startsWith("./") && !relativeDirPath.startsWith("../")) {
+        relativeDirPath = "./" + relativeDirPath;
+      }
+      pathsObj[`@${domainName}`] = [relativeIndexPath];
+      pathsObj[`@${domainName}/*`] = [`${relativeDirPath}/*`];
+    }
+  }
+  if (config.aliases) {
+    for (const [alias, target] of Object.entries(config.aliases)) {
+      let normalizedTarget = path3.isAbsolute(target) ? path3.relative(cwd, target) : target;
+      normalizedTarget = normalizedTarget.replace(/\\/g, "/");
+      if (!normalizedTarget.startsWith("./") && !normalizedTarget.startsWith("../")) {
+        normalizedTarget = "./" + normalizedTarget;
+      }
+      const isExplicitFile = /\.(ts|js|mts|mjs|cts|cjs|json)$/.test(normalizedTarget);
+      const cleanAlias = alias.replace(/\/\*$/, "");
+      const cleanTarget = normalizedTarget.replace(/\/\*$/, "");
+      if (isExplicitFile) {
+        pathsObj[cleanAlias] = [cleanTarget];
+      } else {
+        pathsObj[cleanAlias] = [cleanTarget];
+        pathsObj[`${cleanAlias}/*`] = [`${cleanTarget}/*`];
+      }
+    }
+  }
+  return pathsObj;
+}
+
 // src/cli/commands/sync-tsconfig.ts
 function syncTsconfigCommand() {
   return new Command2("sync-tsconfig").description("Syncs Nodulus aliases into tsconfig.json paths array for IDE support").option("--tsconfig <path>", "Path to tsconfig.json", "tsconfig.json").action(async (options) => {
     try {
       const cwd = process.cwd();
-      const configPath = path3.resolve(cwd, options.tsconfig);
-      if (!fs3.existsSync(configPath)) {
-        console.error(pc3.red(`
+      const configPath = path4.resolve(cwd, options.tsconfig);
+      if (!fs4.existsSync(configPath)) {
+        throw new Error(pc3.red(`
 Error: Could not find ${options.tsconfig} at ${configPath}
 `));
-        process.exit(1);
       }
       const config = await loadConfig();
-      const globPattern = config.modules.replace(/\\/g, "/");
-      const moduleDirs = await fg(globPattern, {
-        onlyDirectories: true,
-        absolute: true,
-        cwd
-      });
-      moduleDirs.sort();
-      const pathsObj = {};
-      for (const dirPath of moduleDirs) {
-        const modName = path3.basename(dirPath);
-        const aliasKey = `@modules/${modName}`;
-        let indexPath = path3.join(dirPath, "index.ts");
-        if (!fs3.existsSync(indexPath)) {
-          indexPath = path3.join(dirPath, "index.js");
-        }
-        let relativePosixPath = path3.relative(cwd, indexPath).replace(/\\/g, "/");
-        if (!relativePosixPath.startsWith("./") && !relativePosixPath.startsWith("../")) {
-          relativePosixPath = "./" + relativePosixPath;
-        }
-        pathsObj[aliasKey] = [relativePosixPath];
-      }
-      if (config.aliases) {
-        for (const [alias, target] of Object.entries(config.aliases)) {
-          let relativePosixPath = path3.isAbsolute(target) ? path3.relative(cwd, target) : target;
-          relativePosixPath = relativePosixPath.replace(/\\/g, "/");
-          if (!relativePosixPath.startsWith("./") && !relativePosixPath.startsWith("../")) {
-            relativePosixPath = "./" + relativePosixPath;
-          }
-          const key = alias.endsWith("/*") ? alias : `${alias}/*`;
-          const val = relativePosixPath.endsWith("/*") ? relativePosixPath : `${relativePosixPath}/*`;
-          pathsObj[key] = [val];
-        }
-      }
-      const rawContent = fs3.readFileSync(configPath, "utf8");
+      const pathsObj = await generatePathAliases(config, cwd);
+      const rawContent = await fs4.promises.readFile(configPath, "utf8");
       const tsconfig = parse(rawContent);
       if (!tsconfig.compilerOptions) {
         tsconfig.compilerOptions = {};
       }
-      if (!tsconfig.compilerOptions.paths) {
-        tsconfig.compilerOptions.paths = {};
+      const compilerOptions = tsconfig.compilerOptions;
+      if (!compilerOptions.paths) {
+        compilerOptions.paths = {};
       }
-      for (const key of Object.keys(tsconfig.compilerOptions.paths)) {
-        const val = tsconfig.compilerOptions.paths[key];
+      const paths = compilerOptions.paths;
+      for (const key of Object.keys(paths)) {
+        const val = paths[key];
         if (key.startsWith("@modules/") && !pathsObj[key]) {
-          delete tsconfig.compilerOptions.paths[key];
+          delete paths[key];
         } else if (!pathsObj[key] && key.endsWith("/*") && Array.isArray(val) && val.length === 1 && typeof val[0] === "string" && (val[0].startsWith("./") || val[0].startsWith("../")) && val[0].endsWith("/*")) {
-          delete tsconfig.compilerOptions.paths[key];
+          delete paths[key];
         }
       }
-      Object.assign(tsconfig.compilerOptions.paths, pathsObj);
+      Object.assign(paths, pathsObj);
       const sortedPaths = {};
-      Object.keys(tsconfig.compilerOptions.paths).sort().forEach((k) => {
-        sortedPaths[k] = tsconfig.compilerOptions.paths[k];
+      Object.keys(paths).sort().forEach((k) => {
+        sortedPaths[k] = paths[k];
       });
-      tsconfig.compilerOptions.paths = sortedPaths;
-      fs3.writeFileSync(configPath, stringify(tsconfig, null, 2) + "\n", "utf8");
+      compilerOptions.paths = sortedPaths;
+      fs4.writeFileSync(configPath, stringify(tsconfig, null, 2) + "\n", "utf8");
       const moduleCount = Object.keys(pathsObj).filter((k) => k.startsWith("@modules/")).length;
       const aliasCount = Object.keys(pathsObj).length - moduleCount;
       console.log(pc3.green(`
 \u2714 tsconfig.json updated \u2014 ${moduleCount} module(s), ${aliasCount} folder alias(es)`));
       console.log(`Added paths:`);
       const maxKeyLength = Math.max(...Object.keys(pathsObj).map((k) => k.length));
-      for (const [key, paths] of Object.entries(pathsObj)) {
+      for (const [key, paths2] of Object.entries(pathsObj)) {
         const paddedKey = key.padEnd(maxKeyLength);
-        console.log(`  ${pc3.cyan(paddedKey)}  \u2192 ${paths[0]}`);
+        console.log(`  ${pc3.cyan(paddedKey)}  \u2192 ${paths2[0]}`);
       }
       console.log("");
     } catch (err) {
-      console.error(pc3.red(`
+      throw new Error(pc3.red(`
 Error synchronizing tsconfig: ${err.message}
-`));
-      process.exit(1);
+`), { cause: err });
     }
   });
 }
@@ -325,13 +393,13 @@ import pc4 from "picocolors";
 
 // src/cli/lib/graph-builder.ts
 import fg2 from "fast-glob";
-import path4 from "path";
-import fs5 from "fs";
+import path5 from "path";
+import fs6 from "fs";
 
 // src/cli/lib/ast-parser.ts
-import * as fs4 from "fs";
+import * as fs5 from "fs";
 
-// node_modules/acorn/dist/acorn.mjs
+// ../../node_modules/acorn/dist/acorn.mjs
 var astralIdentifierCodes = [509, 0, 227, 0, 150, 4, 294, 9, 1368, 2, 2, 1, 6, 3, 41, 2, 5, 0, 166, 1, 574, 3, 9, 9, 7, 9, 32, 4, 318, 1, 78, 5, 71, 10, 50, 3, 123, 2, 54, 14, 32, 10, 3, 1, 11, 3, 46, 10, 8, 0, 46, 9, 7, 2, 37, 13, 2, 9, 6, 1, 45, 0, 13, 2, 49, 13, 9, 3, 2, 11, 83, 11, 7, 0, 3, 0, 158, 11, 6, 9, 7, 3, 56, 1, 2, 6, 3, 1, 3, 2, 10, 0, 11, 1, 3, 6, 4, 4, 68, 8, 2, 0, 3, 0, 2, 3, 2, 4, 2, 0, 15, 1, 83, 17, 10, 9, 5, 0, 82, 19, 13, 9, 214, 6, 3, 8, 28, 1, 83, 16, 16, 9, 82, 12, 9, 9, 7, 19, 58, 14, 5, 9, 243, 14, 166, 9, 71, 5, 2, 1, 3, 3, 2, 0, 2, 1, 13, 9, 120, 6, 3, 6, 4, 0, 29, 9, 41, 6, 2, 3, 9, 0, 10, 10, 47, 15, 199, 7, 137, 9, 54, 7, 2, 7, 17, 9, 57, 21, 2, 13, 123, 5, 4, 0, 2, 1, 2, 6, 2, 0, 9, 9, 49, 4, 2, 1, 2, 4, 9, 9, 55, 9, 266, 3, 10, 1, 2, 0, 49, 6, 4, 4, 14, 10, 5350, 0, 7, 14, 11465, 27, 2343, 9, 87, 9, 39, 4, 60, 6, 26, 9, 535, 9, 470, 0, 2, 54, 8, 3, 82, 0, 12, 1, 19628, 1, 4178, 9, 519, 45, 3, 22, 543, 4, 4, 5, 9, 7, 3, 6, 31, 3, 149, 2, 1418, 49, 513, 54, 5, 49, 9, 0, 15, 0, 23, 4, 2, 14, 1361, 6, 2, 16, 3, 6, 2, 1, 2, 4, 101, 0, 161, 6, 10, 9, 357, 0, 62, 13, 499, 13, 245, 1, 2, 9, 233, 0, 3, 0, 8, 1, 6, 0, 475, 6, 110, 6, 6, 9, 4759, 9, 787719, 239];
 var astralIdentifierStartCodes = [0, 11, 2, 25, 2, 18, 2, 1, 2, 14, 3, 13, 35, 122, 70, 52, 268, 28, 4, 48, 48, 31, 14, 29, 6, 37, 11, 29, 3, 35, 5, 7, 2, 4, 43, 157, 19, 35, 5, 35, 5, 39, 9, 51, 13, 10, 2, 14, 2, 6, 2, 1, 2, 10, 2, 14, 2, 6, 2, 1, 4, 51, 13, 310, 10, 21, 11, 7, 25, 5, 2, 41, 2, 8, 70, 5, 3, 0, 2, 43, 2, 1, 4, 0, 3, 22, 11, 22, 10, 30, 66, 18, 2, 1, 11, 21, 11, 25, 7, 25, 39, 55, 7, 1, 65, 0, 16, 3, 2, 2, 2, 28, 43, 28, 4, 28, 36, 7, 2, 27, 28, 53, 11, 21, 11, 18, 14, 17, 111, 72, 56, 50, 14, 50, 14, 35, 39, 27, 10, 22, 251, 41, 7, 1, 17, 5, 57, 28, 11, 0, 9, 21, 43, 17, 47, 20, 28, 22, 13, 52, 58, 1, 3, 0, 14, 44, 33, 24, 27, 35, 30, 0, 3, 0, 9, 34, 4, 0, 13, 47, 15, 3, 22, 0, 2, 0, 36, 17, 2, 24, 20, 1, 64, 6, 2, 0, 2, 3, 2, 14, 2, 9, 8, 46, 39, 7, 3, 1, 3, 21, 2, 6, 2, 1, 2, 4, 4, 0, 19, 0, 13, 4, 31, 9, 2, 0, 3, 0, 2, 37, 2, 0, 26, 0, 2, 0, 45, 52, 19, 3, 21, 2, 31, 47, 21, 1, 2, 0, 185, 46, 42, 3, 37, 47, 21, 0, 60, 42, 14, 0, 72, 26, 38, 6, 186, 43, 117, 63, 32, 7, 3, 0, 3, 7, 2, 1, 2, 23, 16, 0, 2, 0, 95, 7, 3, 38, 17, 0, 2, 0, 29, 0, 11, 39, 8, 0, 22, 0, 12, 45, 20, 0, 19, 72, 200, 32, 32, 8, 2, 36, 18, 0, 50, 29, 113, 6, 2, 1, 2, 37, 22, 0, 26, 5, 2, 1, 2, 31, 15, 0, 24, 43, 261, 18, 16, 0, 2, 12, 2, 33, 125, 0, 80, 921, 103, 110, 18, 195, 2637, 96, 16, 1071, 18, 5, 26, 3994, 6, 582, 6842, 29, 1763, 568, 8, 30, 18, 78, 18, 29, 19, 47, 17, 3, 32, 20, 6, 18, 433, 44, 212, 63, 33, 24, 3, 24, 45, 74, 6, 0, 67, 12, 65, 1, 2, 0, 15, 4, 10, 7381, 42, 31, 98, 114, 8702, 3, 2, 6, 2, 1, 2, 290, 16, 0, 30, 2, 3, 0, 15, 3, 9, 395, 2309, 106, 6, 12, 4, 8, 8, 9, 5991, 84, 2, 70, 2, 1, 3, 0, 3, 1, 3, 3, 2, 11, 2, 0, 2, 6, 2, 64, 2, 3, 3, 7, 2, 6, 2, 27, 2, 3, 2, 4, 2, 0, 4, 6, 2, 339, 3, 24, 2, 24, 2, 30, 2, 24, 2, 30, 2, 24, 2, 30, 2, 24, 2, 30, 2, 24, 2, 7, 1845, 30, 7, 5, 262, 61, 147, 44, 11, 6, 17, 0, 322, 29, 19, 43, 485, 27, 229, 29, 3, 0, 208, 30, 2, 2, 2, 1, 2, 6, 3, 4, 10, 1, 225, 6, 2, 3, 2, 1, 2, 14, 2, 196, 60, 67, 8, 0, 1205, 3, 2, 26, 2, 1, 2, 0, 3, 0, 2, 9, 2, 3, 2, 0, 2, 0, 7, 0, 5, 0, 2, 0, 2, 0, 2, 2, 2, 1, 2, 0, 3, 0, 2, 0, 2, 0, 2, 0, 2, 0, 2, 1, 2, 0, 3, 3, 2, 6, 2, 3, 2, 3, 2, 0, 2, 9, 2, 16, 6, 2, 2, 4, 2, 16, 4421, 42719, 33, 4381, 3, 5773, 3, 7472, 16, 621, 2467, 541, 1507, 4938, 6, 8489];
 var nonASCIIidentifierChars = "\u200C\u200D\xB7\u0300-\u036F\u0387\u0483-\u0487\u0591-\u05BD\u05BF\u05C1\u05C2\u05C4\u05C5\u05C7\u0610-\u061A\u064B-\u0669\u0670\u06D6-\u06DC\u06DF-\u06E4\u06E7\u06E8\u06EA-\u06ED\u06F0-\u06F9\u0711\u0730-\u074A\u07A6-\u07B0\u07C0-\u07C9\u07EB-\u07F3\u07FD\u0816-\u0819\u081B-\u0823\u0825-\u0827\u0829-\u082D\u0859-\u085B\u0897-\u089F\u08CA-\u08E1\u08E3-\u0903\u093A-\u093C\u093E-\u094F\u0951-\u0957\u0962\u0963\u0966-\u096F\u0981-\u0983\u09BC\u09BE-\u09C4\u09C7\u09C8\u09CB-\u09CD\u09D7\u09E2\u09E3\u09E6-\u09EF\u09FE\u0A01-\u0A03\u0A3C\u0A3E-\u0A42\u0A47\u0A48\u0A4B-\u0A4D\u0A51\u0A66-\u0A71\u0A75\u0A81-\u0A83\u0ABC\u0ABE-\u0AC5\u0AC7-\u0AC9\u0ACB-\u0ACD\u0AE2\u0AE3\u0AE6-\u0AEF\u0AFA-\u0AFF\u0B01-\u0B03\u0B3C\u0B3E-\u0B44\u0B47\u0B48\u0B4B-\u0B4D\u0B55-\u0B57\u0B62\u0B63\u0B66-\u0B6F\u0B82\u0BBE-\u0BC2\u0BC6-\u0BC8\u0BCA-\u0BCD\u0BD7\u0BE6-\u0BEF\u0C00-\u0C04\u0C3C\u0C3E-\u0C44\u0C46-\u0C48\u0C4A-\u0C4D\u0C55\u0C56\u0C62\u0C63\u0C66-\u0C6F\u0C81-\u0C83\u0CBC\u0CBE-\u0CC4\u0CC6-\u0CC8\u0CCA-\u0CCD\u0CD5\u0CD6\u0CE2\u0CE3\u0CE6-\u0CEF\u0CF3\u0D00-\u0D03\u0D3B\u0D3C\u0D3E-\u0D44\u0D46-\u0D48\u0D4A-\u0D4D\u0D57\u0D62\u0D63\u0D66-\u0D6F\u0D81-\u0D83\u0DCA\u0DCF-\u0DD4\u0DD6\u0DD8-\u0DDF\u0DE6-\u0DEF\u0DF2\u0DF3\u0E31\u0E34-\u0E3A\u0E47-\u0E4E\u0E50-\u0E59\u0EB1\u0EB4-\u0EBC\u0EC8-\u0ECE\u0ED0-\u0ED9\u0F18\u0F19\u0F20-\u0F29\u0F35\u0F37\u0F39\u0F3E\u0F3F\u0F71-\u0F84\u0F86\u0F87\u0F8D-\u0F97\u0F99-\u0FBC\u0FC6\u102B-\u103E\u1040-\u1049\u1056-\u1059\u105E-\u1060\u1062-\u1064\u1067-\u106D\u1071-\u1074\u1082-\u108D\u108F-\u109D\u135D-\u135F\u1369-\u1371\u1712-\u1715\u1732-\u1734\u1752\u1753\u1772\u1773\u17B4-\u17D3\u17DD\u17E0-\u17E9\u180B-\u180D\u180F-\u1819\u18A9\u1920-\u192B\u1930-\u193B\u1946-\u194F\u19D0-\u19DA\u1A17-\u1A1B\u1A55-\u1A5E\u1A60-\u1A7C\u1A7F-\u1A89\u1A90-\u1A99\u1AB0-\u1ABD\u1ABF-\u1ADD\u1AE0-\u1AEB\u1B00-\u1B04\u1B34-\u1B44\u1B50-\u1B59\u1B6B-\u1B73\u1B80-\u1B82\u1BA1-\u1BAD\u1BB0-\u1BB9\u1BE6-\u1BF3\u1C24-\u1C37\u1C40-\u1C49\u1C50-\u1C59\u1CD0-\u1CD2\u1CD4-\u1CE8\u1CED\u1CF4\u1CF7-\u1CF9\u1DC0-\u1DFF\u200C\u200D\u203F\u2040\u2054\u20D0-\u20DC\u20E1\u20E5-\u20F0\u2CEF-\u2CF1\u2D7F\u2DE0-\u2DFF\u302A-\u302F\u3099\u309A\u30FB\uA620-\uA629\uA66F\uA674-\uA67D\uA69E\uA69F\uA6F0\uA6F1\uA802\uA806\uA80B\uA823-\uA827\uA82C\uA880\uA881\uA8B4-\uA8C5\uA8D0-\uA8D9\uA8E0-\uA8F1\uA8FF-\uA909\uA926-\uA92D\uA947-\uA953\uA980-\uA983\uA9B3-\uA9C0\uA9D0-\uA9D9\uA9E5\uA9F0-\uA9F9\uAA29-\uAA36\uAA43\uAA4C\uAA4D\uAA50-\uAA59\uAA7B-\uAA7D\uAAB0\uAAB2-\uAAB4\uAAB7\uAAB8\uAABE\uAABF\uAAC1\uAAEB-\uAAEF\uAAF5\uAAF6\uABE3-\uABEA\uABEC\uABED\uABF0-\uABF9\uFB1E\uFE00-\uFE0F\uFE20-\uFE2F\uFE33\uFE34\uFE4D-\uFE4F\uFF10-\uFF19\uFF3F\uFF65";
@@ -5982,7 +6050,7 @@ function parse4(input, options) {
   return Parser.parse(input, options);
 }
 
-// node_modules/acorn-walk/dist/walk.mjs
+// ../../node_modules/acorn-walk/dist/walk.mjs
 function simple(node, visitors, baseVisitor, state, override) {
   if (!baseVisitor) {
     baseVisitor = base;
@@ -6310,7 +6378,7 @@ base.MethodDefinition = base.PropertyDefinition = base.Property = function(node,
 function extractModuleImports(filePath) {
   const imports = [];
   try {
-    const code = fs4.readFileSync(filePath, "utf-8");
+    const code = fs5.readFileSync(filePath, "utf-8");
     const ast = parse4(code, {
       ecmaVersion: "latest",
       sourceType: "module",
@@ -6318,27 +6386,33 @@ function extractModuleImports(filePath) {
     });
     simple(ast, {
       ImportDeclaration(node) {
-        if (node.source && typeof node.source.value === "string") {
-          const specifier = node.source.value;
+        const imp = node;
+        if (imp.source && typeof imp.source.value === "string") {
+          const specifier = imp.source.value;
           if (specifier.startsWith("@modules/")) {
             imports.push({
               specifier,
-              line: node.loc?.start.line || 0,
+              line: imp.loc?.start.line || 0,
               file: filePath
             });
           }
         }
       }
     });
-  } catch (_error) {
+  } catch (error) {
+    if (error.code === "ENOENT") {
+      return [];
+    }
+    console.warn(`[Nodulus] [Parser] Warning: Failed to parse imports in "${filePath}".`);
+    console.debug(`  Detail: ${error.message}`);
     return [];
   }
   return imports;
 }
-function extractModuleDeclaration(indexPath) {
+function extractIdentifierCall(filePath, calleeName) {
   let found = null;
   try {
-    const code = fs4.readFileSync(indexPath, "utf-8");
+    const code = fs5.readFileSync(filePath, "utf-8");
     const ast = parse4(code, {
       ecmaVersion: "latest",
       sourceType: "module",
@@ -6346,44 +6420,97 @@ function extractModuleDeclaration(indexPath) {
     });
     simple(ast, {
       CallExpression(node) {
-        if (node.callee && node.callee.name === "Module") {
-          const nameArg = node.arguments[0];
+        const call = node;
+        if (call.callee.type === "Identifier" && call.callee.name === calleeName) {
+          const nameArg = call.arguments[0];
           if (nameArg && nameArg.type === "Literal") {
             const name = nameArg.value;
-            const imports = [];
-            const optionsArg = node.arguments[1];
+            const options = {};
+            const optionsArg = call.arguments[1];
             if (optionsArg && optionsArg.type === "ObjectExpression") {
               for (const prop of optionsArg.properties) {
-                const isImportsKey = prop.key.type === "Identifier" && prop.key.name === "imports" || prop.key.type === "Literal" && prop.key.value === "imports";
-                if (isImportsKey && prop.value.type === "ArrayExpression") {
-                  for (const elem of prop.value.elements) {
+                if (prop.type !== "Property") continue;
+                let keyName = "";
+                if (prop.key.type === "Identifier") {
+                  keyName = prop.key.name;
+                } else if (prop.key.type === "Literal") {
+                  keyName = String(prop.key.value);
+                }
+                if (keyName && prop.value.type === "ArrayExpression") {
+                  const arr = [];
+                  const arrayVal = prop.value;
+                  for (const elem of arrayVal.elements) {
                     if (elem && elem.type === "Literal") {
-                      imports.push(elem.value);
+                      arr.push(String(elem.value));
                     }
                   }
+                  options[keyName] = arr;
+                } else if (keyName && prop.value.type === "Literal") {
+                  options[keyName] = prop.value.value;
                 }
               }
             }
-            found = { name, imports };
+            found = { name, options };
           }
         }
       }
     });
-  } catch (_error) {
+  } catch (error) {
+    if (error.code !== "ENOENT") {
+      console.warn(`[Nodulus] [Parser] Warning: Failed to parse identifier call in "${filePath}".`);
+      console.debug(`  Detail: ${error.message}`);
+    }
     return null;
   }
   return found;
 }
+function extractModuleDeclaration(indexPath) {
+  const result = extractIdentifierCall(indexPath, "Module");
+  if (!result) return null;
+  return {
+    name: result.name,
+    imports: Array.isArray(result.options.imports) ? result.options.imports : []
+  };
+}
+function extractInternalIdentifiers(filePath) {
+  const names = [];
+  const targetCallees = ["Service", "Controller", "Repository", "Schema"];
+  try {
+    const code = fs5.readFileSync(filePath, "utf-8");
+    const ast = parse4(code, {
+      ecmaVersion: "latest",
+      sourceType: "module"
+    });
+    simple(ast, {
+      CallExpression(node) {
+        const call = node;
+        if (call.callee.type === "Identifier" && targetCallees.includes(call.callee.name)) {
+          const nameArg = call.arguments[0];
+          if (nameArg && nameArg.type === "Literal" && typeof nameArg.value === "string") {
+            names.push(nameArg.value);
+          }
+        }
+      }
+    });
+  } catch (error) {
+    if (error.code !== "ENOENT") {
+      console.warn(`[Nodulus] [Parser] Warning: Failed to parse internal identifiers in "${filePath}".`);
+      console.debug(`  Detail: ${error.message}`);
+    }
+  }
+  return names;
+}
 
 // src/cli/lib/graph-builder.ts
-async function buildModuleGraph(modulesGlob, cwd) {
+async function buildModuleGraph(config, cwd) {
+  const modulesGlob = config.modules || "src/modules/*";
   const dirs = await fg2(modulesGlob, { cwd, onlyDirectories: true, absolute: true });
   const nodes = [];
   for (const dirPath of dirs) {
-    let indexPath = path4.join(dirPath, "index.ts");
-    if (!fs5.existsSync(indexPath)) {
-      indexPath = path4.join(dirPath, "index.js");
-      if (!fs5.existsSync(indexPath)) {
+    let indexPath = path5.join(dirPath, "index.ts");
+    if (!fs6.existsSync(indexPath)) {
+      indexPath = path5.join(dirPath, "index.js");
+      if (!fs6.existsSync(indexPath)) {
         continue;
       }
     }
@@ -6392,6 +6519,8 @@ async function buildModuleGraph(modulesGlob, cwd) {
       continue;
     }
     const actualImports = [];
+    const internalIdentifiers = [];
+    internalIdentifiers.push(...extractInternalIdentifiers(indexPath));
     const moduleFiles = await fg2("**/*.{ts,js,mts,mjs}", {
       cwd: dirPath,
       absolute: true,
@@ -6400,262 +6529,121 @@ async function buildModuleGraph(modulesGlob, cwd) {
     for (const file of moduleFiles) {
       const fileImports = extractModuleImports(file);
       actualImports.push(...fileImports);
+      const fileIdentifiers = extractInternalIdentifiers(file);
+      internalIdentifiers.push(...fileIdentifiers);
     }
     nodes.push({
       name: declaration.name,
       dirPath,
       indexPath,
       declaredImports: declaration.imports,
-      actualImports
+      actualImports,
+      internalIdentifiers
     });
   }
-  return nodes;
+  return {
+    domains: [],
+    modules: nodes
+  };
 }
 
-// src/core/registry.ts
-import { AsyncLocalStorage } from "async_hooks";
-
-// src/core/errors.ts
-var NodulusError = class extends Error {
-  code;
-  details;
-  constructor(code, message, details) {
-    super(message);
-    this.name = "NodulusError";
-    this.code = code;
-    this.details = details;
-  }
-};
-
-// src/core/registry.ts
-var toRegisteredModule = (entry) => ({
-  name: entry.name,
-  path: entry.path,
-  imports: entry.imports,
-  exports: entry.exports,
-  controllers: entry.controllers.map((c) => c.name)
-});
-function createRegistry() {
-  const modules = /* @__PURE__ */ new Map();
-  const aliases = /* @__PURE__ */ new Map();
-  const controllers = /* @__PURE__ */ new Map();
-  const services = /* @__PURE__ */ new Map();
-  const repositories = /* @__PURE__ */ new Map();
-  const schemas = /* @__PURE__ */ new Map();
-  return {
-    hasModule(name) {
-      return modules.has(name);
-    },
-    getModule(name) {
-      const entry = modules.get(name);
-      return entry ? toRegisteredModule(entry) : void 0;
-    },
-    getAllModules() {
-      return Array.from(modules.values()).map(toRegisteredModule);
-    },
-    resolveAlias(alias) {
-      return aliases.get(alias);
-    },
-    getAllAliases() {
-      return Object.fromEntries(aliases.entries());
-    },
-    getDependencyGraph() {
-      const graph = /* @__PURE__ */ new Map();
-      for (const [name, entry] of modules.entries()) {
-        graph.set(name, entry.imports);
-      }
-      return graph;
-    },
-    findCircularDependencies() {
-      const cycles = [];
-      const visited = /* @__PURE__ */ new Set();
-      const recStack = /* @__PURE__ */ new Set();
-      const path5 = [];
-      const dfs = (node) => {
-        visited.add(node);
-        recStack.add(node);
-        path5.push(node);
-        const deps = modules.get(node)?.imports || [];
-        for (const neighbor of deps) {
-          if (!visited.has(neighbor)) {
-            dfs(neighbor);
-          } else if (recStack.has(neighbor)) {
-            const cycleStart = path5.indexOf(neighbor);
-            cycles.push([...path5.slice(cycleStart), neighbor]);
-          }
-        }
-        recStack.delete(node);
-        path5.pop();
-      };
-      for (const node of modules.keys()) {
-        if (!visited.has(node)) {
-          dfs(node);
-        }
-      }
-      return cycles;
-    },
-    registerModule(name, options, dirPath, indexPath) {
-      if (modules.has(name)) {
-        throw new NodulusError(
-          "DUPLICATE_MODULE",
-          `A module with this name already exists. Each module must have a unique name.`,
-          `Module name: ${name}`
-        );
-      }
-      const existing = Array.from(modules.values()).find((m) => m.path === dirPath);
-      if (existing) {
-        throw new NodulusError(
-          "DUPLICATE_MODULE",
-          `A module is already registered for this folder. Call Module() only once per directory.`,
-          `Existing: ${existing.name}, New: ${name}, Folder: ${dirPath}`
-        );
-      }
-      const entry = {
-        name,
-        path: dirPath,
-        indexPath,
-        imports: options.imports || [],
-        exports: options.exports || [],
-        controllers: []
-      };
-      modules.set(name, entry);
-    },
-    registerAlias(alias, targetPath) {
-      const existing = aliases.get(alias);
-      if (existing && existing !== targetPath) {
-        throw new NodulusError(
-          "DUPLICATE_ALIAS",
-          `An alias with this name is already registered to a different target path.`,
-          `Alias: ${alias}, Existing: ${existing}, New: ${targetPath}`
-        );
-      }
-      aliases.set(alias, targetPath);
-    },
-    registerControllerMetadata(entry) {
-      if (controllers.has(entry.path)) {
-        throw new NodulusError(
-          "INVALID_CONTROLLER",
-          `Controller() was called more than once in the same file.`,
-          `File: ${entry.path}`
-        );
-      }
-      controllers.set(entry.path, entry);
-    },
-    getControllerMetadata(filePath) {
-      return controllers.get(filePath);
-    },
-    getAllControllersMetadata() {
-      return Array.from(controllers.values());
-    },
-    getRawModule(name) {
-      return modules.get(name);
-    },
-    registerFileMetadata(entry) {
-      if (entry.type === "service") {
-        if (services.has(entry.name)) {
-          throw new NodulusError(
-            "DUPLICATE_SERVICE",
-            `A service named "${entry.name}" is already registered. Each Service() name must be unique within the registry.`,
-            `Duplicate name: ${entry.name}`
-          );
-        }
-        services.set(entry.name, entry);
-      } else if (entry.type === "repository") {
-        if (repositories.has(entry.name)) {
-          throw new NodulusError(
-            "DUPLICATE_REPOSITORY",
-            `A repository named "${entry.name}" is already registered. Each Repository() name must be unique within the registry.`,
-            `Duplicate name: ${entry.name}`
-          );
-        }
-        repositories.set(entry.name, entry);
-      } else if (entry.type === "schema") {
-        if (schemas.has(entry.name)) {
-          throw new NodulusError(
-            "DUPLICATE_SCHEMA",
-            `A schema named "${entry.name}" is already registered. Each Schema() name must be unique within the registry.`,
-            `Duplicate name: ${entry.name}`
-          );
-        }
-        schemas.set(entry.name, entry);
-      }
-    },
-    getAllServices() {
-      return Array.from(services.values());
-    },
-    getService(name) {
-      return services.get(name);
-    },
-    getAllRepositories() {
-      return Array.from(repositories.values());
-    },
-    getRepository(name) {
-      return repositories.get(name);
-    },
-    getAllSchemas() {
-      return Array.from(schemas.values());
-    },
-    getSchema(name) {
-      return schemas.get(name);
-    },
-    clearRegistry() {
-      modules.clear();
-      aliases.clear();
-      controllers.clear();
-      services.clear();
-      repositories.clear();
-      schemas.clear();
-    }
+// src/core/utils/cycle-detector.ts
+function findCircularDependencies(dependencyMap) {
+  const cycles = [];
+  const visited = /* @__PURE__ */ new Set();
+  const recStack = /* @__PURE__ */ new Set();
+  const path8 = [];
+  const dfs = (node) => {
+    visited.add(node);
+    recStack.add(node);
+    path8.push(node);
+    const deps = dependencyMap.get(node) || [];
+    for (const neighbor of deps) {
+      if (!visited.has(neighbor)) {
+        dfs(neighbor);
+      } else if (recStack.has(neighbor)) {
+        const cycleStart = path8.indexOf(neighbor);
+        cycles.push([...path8.slice(cycleStart), neighbor]);
+      }
+    }
+    recStack.delete(node);
+    path8.pop();
   };
+  for (const node of dependencyMap.keys()) {
+    if (!visited.has(node)) {
+      dfs(node);
+    }
+  }
+  return cycles;
 }
-var registryContext = new AsyncLocalStorage();
 
 // src/cli/lib/violations.ts
-function detectViolations(nodes) {
+var ViolationType = {
+  PRIVATE_IMPORT: "private-import",
+  UNDECLARED_IMPORT: "undeclared-import",
+  CIRCULAR_DEPENDENCY: "circular-dependency"
+};
+function analyzeImport(specifier) {
+  const parts = specifier.split("/");
+  const isModules = specifier.startsWith("@modules/");
+  const isAtAlias = specifier.startsWith("@");
+  if (isModules) {
+    if (parts.length > 2) {
+      return { isPrivate: true, suggestion: `${parts[0]}/${parts[1]}`, target: parts[1] };
+    }
+    return { isPrivate: false, suggestion: "", target: parts[1] };
+  }
+  if (isAtAlias) {
+    if (parts.length > 2) {
+      return { isPrivate: true, suggestion: `${parts[0]}/${parts[1]}`, target: parts[1] };
+    }
+    const target = (parts[1] || parts[0]).replace(/^@/, "");
+    return { isPrivate: false, suggestion: "", target };
+  }
+  return { isPrivate: false, suggestion: "", target: "" };
+}
+function detectViolations(graph) {
   const violations = [];
+  const nodes = graph.modules;
   const moduleNames = new Set(nodes.map((n) => n.name));
-  const registry = createRegistry();
-  for (const node of nodes) {
-    try {
-      registry.registerModule(node.name, { imports: node.declaredImports }, node.dirPath, node.indexPath);
-    } catch (_err) {
+  if (graph.domains) {
+    for (const d of graph.domains) {
+      moduleNames.add(d.name);
     }
   }
   for (const node of nodes) {
     for (const imp of node.actualImports) {
-      const parts = imp.specifier.split("/");
-      let isPrivate = false;
-      if (parts.length > 2) {
-        isPrivate = true;
+      const { isPrivate, suggestion, target } = analyzeImport(imp.specifier);
+      if (isPrivate) {
         violations.push({
-          type: "private-import",
+          type: ViolationType.PRIVATE_IMPORT,
           module: node.name,
           message: `Private import detected: module "${node.name}" directly imports internal path from "${imp.specifier}".`,
-          suggestion: `Import only the public index: "@modules/${parts[1]}".`,
+          suggestion: `Import only the public index: "${suggestion}".`,
           location: { file: imp.file, line: imp.line }
         });
-      }
-      if (!isPrivate) {
-        const targetModule = parts[1];
-        if (targetModule !== node.name && moduleNames.has(targetModule)) {
-          if (!node.declaredImports.includes(targetModule)) {
-            violations.push({
-              type: "undeclared-import",
-              module: node.name,
-              message: `Undeclared import: module "${node.name}" imports from "${targetModule}" but it is not declared.`,
-              suggestion: `Add "${targetModule}" to the imports array in the Module() declaration of "${node.name}".`,
-              location: { file: imp.file, line: imp.line }
-            });
-          }
+      } else if (target && target !== node.name && moduleNames.has(target)) {
+        if (!node.declaredImports.includes(target)) {
+          violations.push({
+            type: ViolationType.UNDECLARED_IMPORT,
+            module: node.name,
+            message: `Undeclared import: module "${node.name}" imports from "${target}" but it is not declared.`,
+            suggestion: `Add "${target}" to the imports array in the Module() declaration of "${node.name}".`,
+            location: { file: imp.file, line: imp.line }
+          });
         }
       }
     }
   }
-  const cycles = registry.findCircularDependencies();
+  const dependencyMap = /* @__PURE__ */ new Map();
+  for (const node of nodes) {
+    dependencyMap.set(node.name, node.declaredImports);
+  }
+  const cycles = findCircularDependencies(dependencyMap);
   for (const cycle of cycles) {
     const cycleStr = cycle.join(" -> ");
     violations.push({
-      type: "circular-dependency",
+      type: ViolationType.CIRCULAR_DEPENDENCY,
       module: cycle[0],
       message: `Circular dependency detected: ${cycleStr}`,
       suggestion: "Extract shared logic into a separate module to break the cycle.",
@@ -6665,61 +6653,222 @@ function detectViolations(nodes) {
   return violations;
 }
 
+// src/nits/nits-store.ts
+import fs7 from "fs";
+import path6 from "path";
+function loadNitsRegistry(cwd, registryPath) {
+  const fullPath = path6.isAbsolute(registryPath) ? registryPath : path6.join(cwd, registryPath);
+  if (!fs7.existsSync(fullPath)) {
+    return { version: "1.0.0", modules: {} };
+  }
+  try {
+    const content = fs7.readFileSync(fullPath, "utf-8");
+    const data2 = JSON.parse(content);
+    if (!data2.modules || typeof data2.modules !== "object") {
+      throw new Error("Invalid registry format");
+    }
+    return data2;
+  } catch (_err) {
+    return { version: "1.0.0", modules: {} };
+  }
+}
+function saveNitsRegistry(cwd, registry, registryPath) {
+  const fullPath = path6.isAbsolute(registryPath) ? registryPath : path6.join(cwd, registryPath);
+  const dir = path6.dirname(fullPath);
+  if (!fs7.existsSync(dir)) {
+    fs7.mkdirSync(dir, { recursive: true });
+  }
+  fs7.writeFileSync(fullPath, JSON.stringify(registry, null, 2), "utf-8");
+}
+
+// src/nits/nits-reconciler.ts
+import path7 from "path";
+
+// src/nits/constants.ts
+var DEFAULT_SIMILARITY_THRESHOLD = 0.9;
+var MINIMUM_SIMILARITY_THRESHOLD = 0.5;
+
+// src/nits/nits-hash.ts
+function calculateJaccardSimilarity(setA, setB) {
+  if (setA.size === 0 && setB.size === 0) return 1;
+  const intersectionSize = [...setA].filter((x) => setB.has(x)).length;
+  const unionSize = (/* @__PURE__ */ new Set([...setA, ...setB])).size;
+  return intersectionSize / unionSize;
+}
+function getDynamicThreshold(identifierCount) {
+  if (identifierCount <= 0) return DEFAULT_SIMILARITY_THRESHOLD;
+  const formulaValue = 1 - 1 / identifierCount;
+  return Math.min(
+    DEFAULT_SIMILARITY_THRESHOLD,
+    Math.max(MINIMUM_SIMILARITY_THRESHOLD, formulaValue)
+  );
+}
+function areIdentitiesSimilar(oldIdentifiers, newIdentifiers, configThreshold) {
+  const oldSet = new Set(oldIdentifiers);
+  const newSet = new Set(newIdentifiers);
+  const similarity = calculateJaccardSimilarity(oldSet, newSet);
+  const thresholdUsed = configThreshold ?? getDynamicThreshold(Math.max(oldSet.size, newSet.size));
+  return {
+    isSimilar: similarity >= thresholdUsed,
+    similarity,
+    thresholdUsed
+  };
+}
+
+// src/nits/nits-id.ts
+import { randomBytes } from "crypto";
+function generateNitsId() {
+  const chars = randomBytes(4).toString("hex");
+  return `mod_${chars}`;
+}
+
+// src/nits/nits-reconciler.ts
+function reconcile(graph, oldRegistry, cwd, configThreshold) {
+  const newModulesRecord = {};
+  const orphanedEntries = Object.entries(oldRegistry.modules);
+  const summary = {
+    newModules: 0,
+    movedModules: 0,
+    healedConflicts: 0
+  };
+  const usedIds = /* @__PURE__ */ new Set();
+  const normalize = (p) => path7.relative(cwd, p).replace(/\\/g, "/");
+  const unmatchedNodes = [...graph.modules];
+  for (let i = unmatchedNodes.length - 1; i >= 0; i--) {
+    const node = unmatchedNodes[i];
+    const relPath = normalize(node.dirPath);
+    const matchIdx = orphanedEntries.findIndex(([_, entry]) => entry.path === relPath);
+    if (matchIdx !== -1) {
+      const [_, entry] = orphanedEntries[matchIdx];
+      if (usedIds.has(entry.id)) {
+        entry.id = generateNitsId();
+        summary.healedConflicts++;
+      }
+      usedIds.add(entry.id);
+      newModulesRecord[node.name] = {
+        id: entry.id,
+        path: relPath,
+        identifiers: node.internalIdentifiers
+      };
+      unmatchedNodes.splice(i, 1);
+      orphanedEntries.splice(matchIdx, 1);
+    }
+  }
+  for (let i = unmatchedNodes.length - 1; i >= 0; i--) {
+    const node = unmatchedNodes[i];
+    let bestMatchIdx = -1;
+    let highestSim = 0;
+    for (let j = 0; j < orphanedEntries.length; j++) {
+      const [_, entry] = orphanedEntries[j];
+      const simResult = areIdentitiesSimilar(entry.identifiers, node.internalIdentifiers, configThreshold);
+      if (simResult.isSimilar && simResult.similarity > highestSim) {
+        highestSim = simResult.similarity;
+        bestMatchIdx = j;
+      }
+    }
+    if (bestMatchIdx !== -1) {
+      const [_, entry] = orphanedEntries[bestMatchIdx];
+      if (usedIds.has(entry.id)) {
+        entry.id = generateNitsId();
+        summary.healedConflicts++;
+      }
+      usedIds.add(entry.id);
+      newModulesRecord[node.name] = {
+        id: entry.id,
+        path: normalize(node.dirPath),
+        identifiers: node.internalIdentifiers
+      };
+      summary.movedModules++;
+      unmatchedNodes.splice(i, 1);
+      orphanedEntries.splice(bestMatchIdx, 1);
+    }
+  }
+  for (const node of unmatchedNodes) {
+    const id = generateNitsId();
+    usedIds.add(id);
+    newModulesRecord[node.name] = {
+      id,
+      path: normalize(node.dirPath),
+      identifiers: node.internalIdentifiers
+    };
+    summary.newModules++;
+  }
+  return {
+    registry: {
+      version: oldRegistry.version || "1.0.0",
+      modules: newModulesRecord
+    },
+    summary
+  };
+}
+
 // src/cli/commands/check.ts
 function checkCommand() {
   const check = new Command3("check");
   check.description("Analyzes the project structural integrity to detect architectural violations").option("--strict", "Exit with code 1 if any violation is found", false).option("--module <moduleName>", "Filter analysis by a specific module").option("--format <format>", "Output format: text or json", "text").option("--no-circular", "Skip circular dependency detection").action(async (options) => {
-    try {
-      const cwd = process.cwd();
-      const config = await loadConfig();
-      let nodes = await buildModuleGraph(config.modules, cwd);
-      if (options.module) {
-        nodes = nodes.filter((n) => n.name === options.module);
-        if (nodes.length === 0) {
-          console.error(pc4.red(`\u2717 Error: Module "${options.module}" does not exist.`));
-          process.exit(1);
-        }
+    const cwd = process.cwd();
+    const config = await loadConfig();
+    const graph = await buildModuleGraph(config, cwd);
+    if (config.nits.enabled) {
+      const oldRegistry = loadNitsRegistry(cwd, config.nits.registryPath);
+      const { registry: updatedRegistry, summary } = reconcile(
+        graph,
+        oldRegistry,
+        cwd,
+        config.nits.similarityThreshold
+      );
+      saveNitsRegistry(cwd, updatedRegistry, config.nits.registryPath);
+      for (const node of graph.modules) {
+        node.id = updatedRegistry.modules[node.name]?.id;
       }
-      let violations = detectViolations(nodes);
-      if (options.circular === false) {
-        violations = violations.filter((v) => v.type !== "circular-dependency");
+      if (summary.healedConflicts > 0 && options.format !== "json") {
+        console.log(pc4.yellow(`\u26A0 NITS: Healed ${summary.healedConflicts} ID conflict(s) in registry.`));
       }
-      if (options.format === "json") {
-        console.log(JSON.stringify({ modules: nodes, violations }, null, 2));
-        if (options.strict && violations.length > 0) {
-          process.exit(1);
-        }
-        return;
+    }
+    let nodes = graph.modules;
+    if (options.module) {
+      graph.modules = graph.modules.filter((n) => n.name === options.module);
+      nodes = graph.modules;
+      if (nodes.length === 0) {
+        throw new Error(pc4.red(`\u2717 Error: Module "${options.module}" does not exist.`));
       }
-      console.log(pc4.bold(pc4.cyan("\nNodulus Architecture Analysis\n")));
-      for (const node of nodes) {
-        const moduleViolations = violations.filter((v) => v.module === node.name);
-        if (moduleViolations.length === 0) {
-          console.log(pc4.green(`\u2714 ${node.name} \u2014 OK`));
-        } else {
-          console.log(pc4.red(`\u2717 ${node.name} \u2014 ${moduleViolations.length} problem(s)`));
-          for (const v of moduleViolations) {
-            const prefix = pc4.yellow("  WARN ");
-            if (v.type === "circular-dependency" && v.cycle) {
-              console.log(`${prefix} ${v.message}`);
-              console.log(pc4.gray(`       Suggestion: ${v.suggestion}`));
-            } else {
-              const loc = v.location ? `${v.location.file}:${v.location.line}` : "Unknown location";
-              console.log(`${prefix} ${v.message} ${pc4.gray(`(${loc})`)}`);
-              console.log(pc4.gray(`       Suggestion: ${v.suggestion}`));
-            }
+    }
+    let violations = detectViolations(graph);
+    if (options.circular === false) {
+      violations = violations.filter((v) => v.type !== ViolationType.CIRCULAR_DEPENDENCY);
+    }
+    if (options.format === "json") {
+      console.log(JSON.stringify({ domains: graph.domains, modules: nodes, violations }, null, 2));
+      if (options.strict && violations.length > 0) {
+        throw new Error("Structural integrity violations found (JSON format)");
+      }
+      return;
+    }
+    console.log(pc4.bold(pc4.cyan("\nNodulus Architecture Analysis\n")));
+    for (const node of nodes) {
+      const moduleViolations = violations.filter((v) => v.module === node.name);
+      const idStr = node.id ? pc4.gray(` [${node.id}]`) : "";
+      if (moduleViolations.length === 0) {
+        console.log(pc4.green(`\u2714 ${node.name}${idStr} \u2014 OK`));
+      } else {
+        console.log(pc4.red(`\u2717 ${node.name} \u2014 ${moduleViolations.length} problem(s)`));
+        for (const v of moduleViolations) {
+          const prefix = pc4.yellow("  WARN ");
+          if (v.type === ViolationType.CIRCULAR_DEPENDENCY && v.cycle) {
+            console.log(`${prefix} ${v.message}`);
+            console.log(pc4.gray(`       Suggestion: ${v.suggestion}`));
+          } else {
+            const loc = v.location ? `${v.location.file}:${v.location.line}` : "Unknown location";
+            console.log(`${prefix} ${v.message} ${pc4.gray(`(${loc})`)}`);
+            console.log(pc4.gray(`       Suggestion: ${v.suggestion}`));
           }
         }
       }
-      console.log(`
+    }
+    console.log(`
 ${violations.length} problem(s) found.`);
-      if (options.strict && violations.length > 0) {
-        process.exit(1);
-      }
-    } catch (error) {
-      console.error(pc4.red(`
-An error occurred during check: ${error.message}`));
-      process.exit(1);
+    if (options.strict && violations.length > 0) {
+      throw new Error("Structural integrity violations found.");
     }
   });
   return check;
@@ -6730,9 +6879,24 @@ import { createRequire } from "module";
 var require2 = createRequire(import.meta.url);
 var pkg = require2("../../package.json");
 var program = new Command4();
-program.name("nodulus").description("Nodulus CLI").version(pkg.version);
-program.addCommand(createModuleCommand());
-program.addCommand(syncTsconfigCommand());
-program.addCommand(checkCommand());
-program.parse();
+program.name("nodulus").description("Nodulus CLI").version(pkg.version).addCommand(createModuleCommand()).addCommand(syncTsconfigCommand()).addCommand(checkCommand()).exitOverride();
+try {
+  await program.parseAsync();
+} catch (err) {
+  if (err.name === "CommanderError") {
+    if (err.code === "commander.helpDisplayed" || err.code === "commander.help" || err.code === "commander.version") {
+      process.exit(0);
+    }
+    console.error(err.message);
+    process.exit(err.exitCode || 1);
+  }
+  if (err.message && err.message.includes("\nError:")) {
+    console.error(err.message);
+  } else {
+    console.error(`
+${err.message || "An unknown error occurred"}
+`);
+  }
+  process.exit(typeof err.exitCode === "number" ? err.exitCode : 1);
+}
 //# sourceMappingURL=index.js.map