@trackunit/migrations 0.2.58-alpha-62031fc7c43.0 → 0.2.58

package/CHANGELOG.md

@@ -1,3 +1,20 @@
+## 0.2.58 (2026-08-25)
+
+### 🩹 Fixes
+
+- **migrations:** route every directory listing through the tolerant reader [GLU-2029] ([eff5dba9767](https://github.com/Trackunit/manager/commit/eff5dba9767))
+- **migrations:** warn when package discovery skips a directory [GLU-2028] ([09cc451476c](https://github.com/Trackunit/manager/commit/09cc451476c))
+- **migrations:** GLU-2007 make discovery and react codemods work in consumer repos ([3f25bb543f9](https://github.com/Trackunit/manager/commit/3f25bb543f9))
+
+### ❤️ Thank You
+
+- Cursor @cursoragent
+- Mikkel Thorbjørn Andersen
+
+## 0.2.57 (2026-08-25)
+
+This was a version bump only for migrations to align it with other projects, there were no code changes.
+
 ## 0.2.56 (2026-08-20)
 
 This was a version bump only for migrations to align it with other projects, there were no code changes.

package/migrations/entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.js","sourceRoot":"","sources":["../../../../libs/migrations/migrations/entry.ts"],"names":[],"mappings":"","sourcesContent":["export {};\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trackunit/migrations",
-  "version": "0.2.58-alpha-62031fc7c43.0",
+  "version": "0.2.58",
   "repository": "https://github.com/Trackunit/manager",
   "license": "SEE LICENSE IN LICENSE.txt",
   "engines": {

package/src/generators/utils/discover-packages.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.discoverTrackunitPackages = exports.discoverWorkspaceTrackunitPackages = exports.compareVersions = exports.loadMigrationsJson = void 0;
 const tslib_1 = require("tslib");
+const devkit_1 = require("@nx/devkit");
 const fs_1 = require("fs");
 const path_1 = tslib_1.__importDefault(require("path"));
 const readPackageJson = (pkgJsonPath) => {
@@ -43,10 +44,31 @@ const semver_1 = require("semver");
  */
 const compareVersions = (a, b) => (0, semver_1.compare)(a, b);
 exports.compareVersions = compareVersions;
+// Swallowing a failed directory read shrinks the discovered package set, which
+// `migrate` then reports as "no pending migrations" -- indistinguishable from
+// the green-run-no-codemods symptom this walker exists to fix. Warning keeps
+// the walk crash-proof while making a truncated result visible.
+const warnSkipped = (dir, error) => {
+    const reason = error instanceof Error ? error.message : String(error);
+    devkit_1.logger.warn(`Skipped "${dir}" while discovering @trackunit packages: ${reason}. Discovered migrations may be incomplete.`);
+};
+// `existsSync` only says the entry resolved, not that it can be listed: an
+// unreadable store directory or a path that turns out to be a file still
+// throws. Every listing in this module goes through here so one bad directory
+// cannot abort discovery.
+const readDirEntries = (dir) => {
+    try {
+        return (0, fs_1.readdirSync)(dir, { withFileTypes: true });
+    }
+    catch (error) {
+        warnSkipped(dir, error);
+        return [];
+    }
+};
 const scanScopeDir = (scopeDir) => {
     if (!(0, fs_1.existsSync)(scopeDir))
         return [];
-    const entries = (0, fs_1.readdirSync)(scopeDir, { withFileTypes: true });
+    const entries = readDirEntries(scopeDir);
     const found = [];
     for (const entry of entries) {
         if (!entry.isDirectory() && !entry.isSymbolicLink())
@@ -69,6 +91,11 @@ const scanScopeDir = (scopeDir) => {
 };
 const MANAGER_REPO_PACKAGE_NAME = "@trackunit/manager";
 const WORKSPACE_SCAN_ROOTS = ["libs", "apps"];
+// Levels to climb from a resolved package directory to reach the
+// `node_modules` holding it: `<store>/node_modules/name` versus
+// `<store>/node_modules/@scope/name`.
+const UNSCOPED_DEPTH = 1;
+const SCOPED_DEPTH = 2;
 const isManagerMonorepo = (cwd) => {
     const rootPkgJson = readPackageJson(path_1.default.join(cwd, "package.json"));
     return rootPkgJson?.name === MANAGER_REPO_PACKAGE_NAME;
@@ -81,14 +108,7 @@ const walkForPackageJsons = (rootDir, onPackageJson) => {
         const dir = stack.pop();
         if (dir === undefined)
             continue;
-        let entries;
-        try {
-            entries = (0, fs_1.readdirSync)(dir, { withFileTypes: true });
-        }
-        catch {
-            continue;
-        }
-        for (const entry of entries) {
+        for (const entry of readDirEntries(dir)) {
             if (entry.name === "node_modules" || entry.name.startsWith("."))
                 continue;
             const entryPath = path_1.default.join(dir, entry.name);
@@ -135,49 +155,90 @@ exports.discoverWorkspaceTrackunitPackages = discoverWorkspaceTrackunitPackages;
  * and nested node_modules inside every package. When the same package
  * is found at multiple levels, the highest semver version is kept.
  *
- * Works with all package managers (npm, yarn, pnpm, bun).
+ * Works with hoisted layouts (npm, yarn) and with the isolated layouts
+ * where dependencies are symlinks into a content store (Yarn
+ * `nodeLinker: pnpm`, pnpm, bun), including pnpm with hoisting disabled,
+ * where a package's dependencies are siblings of it inside the store
+ * rather than nested beneath it.
  *
  * When invoked inside the manager monorepo (root package.json name
  * is "@trackunit/manager"), additionally scans libs/ and apps/ for
  * workspace packages that ship migrations, since those are not
  * linked under node_modules/@trackunit/.
+ *
+ * @param cwd - Workspace root to scan; defaults to the current directory
+ * @returns {ReadonlyArray<DiscoveredPackage>} One entry per package name, at its highest discovered version
  */
-const discoverTrackunitPackages = () => {
-    const cwd = process.cwd();
+const discoverTrackunitPackages = (cwd = process.cwd()) => {
     const rootNodeModules = path_1.default.resolve(cwd, "node_modules");
     const allFound = [];
     const visited = new Set();
     const walkNodeModules = (nodeModulesDir) => {
         if (!(0, fs_1.existsSync)(nodeModulesDir))
             return;
-        const canonical = path_1.default.resolve(nodeModulesDir);
+        // Isolated layouts (Yarn `nodeLinker: pnpm`, pnpm, bun) symlink every
+        // dependency into a content store, so a mutual dependency produces
+        // endless distinct logical paths pointing at the same real directories.
+        // `path.resolve` normalises but does not follow symlinks, so it cannot
+        // recognise the repeat and the walk grows the path until the OS rejects
+        // it. Canonicalising through the real path is what makes this terminate.
+        let canonical;
+        try {
+            canonical = (0, fs_1.realpathSync)(nodeModulesDir);
+        }
+        catch (error) {
+            warnSkipped(nodeModulesDir, error);
+            return;
+        }
         if (visited.has(canonical))
             return;
         visited.add(canonical);
         const trackunitScope = path_1.default.join(nodeModulesDir, "@trackunit");
         allFound.push(...scanScopeDir(trackunitScope));
-        const topEntries = (0, fs_1.readdirSync)(nodeModulesDir, {
-            withFileTypes: true,
-        });
-        for (const entry of topEntries) {
+        for (const entry of readDirEntries(nodeModulesDir)) {
             if (!entry.isDirectory() && !entry.isSymbolicLink())
                 continue;
             const entryPath = path_1.default.join(nodeModulesDir, entry.name);
             if (entry.name.startsWith("@")) {
-                const scopeEntries = (0, fs_1.readdirSync)(entryPath, {
-                    withFileTypes: true,
-                });
-                for (const scopeEntry of scopeEntries) {
+                for (const scopeEntry of readDirEntries(entryPath)) {
                     if (!scopeEntry.isDirectory() && !scopeEntry.isSymbolicLink())
                         continue;
-                    walkNodeModules(path_1.default.join(entryPath, scopeEntry.name, "node_modules"));
+                    const scopedPkgDir = path_1.default.join(entryPath, scopeEntry.name);
+                    walkNodeModules(path_1.default.join(scopedPkgDir, "node_modules"));
+                    walkStoreSiblingsOf(scopedPkgDir, SCOPED_DEPTH);
                 }
             }
             else {
                 walkNodeModules(path_1.default.join(entryPath, "node_modules"));
+                walkStoreSiblingsOf(entryPath, UNSCOPED_DEPTH);
             }
         }
     };
+    /**
+     * pnpm with hoisting disabled places a package's dependencies *alongside*
+     * it inside the store rather than nested beneath it, so probing only
+     * `<entry>/node_modules` never reaches a @trackunit package that is purely
+     * transitive. Resolving the entry and walking the store `node_modules` that
+     * contains it reaches those siblings. In hoisted layouts this resolves back
+     * to a directory the walk has already scanned, so `visited` makes it free.
+     */
+    function walkStoreSiblingsOf(pkgDir, depth) {
+        if (!(0, fs_1.existsSync)(pkgDir))
+            return;
+        let real;
+        try {
+            real = (0, fs_1.realpathSync)(pkgDir);
+        }
+        catch (error) {
+            warnSkipped(pkgDir, error);
+            return;
+        }
+        let candidate = real;
+        for (let level = 0; level < depth; level += 1)
+            candidate = path_1.default.dirname(candidate);
+        if (path_1.default.basename(candidate) === "node_modules")
+            walkNodeModules(candidate);
+    }
     walkNodeModules(rootNodeModules);
     if (isManagerMonorepo(cwd)) {
         allFound.push(...(0, exports.discoverWorkspaceTrackunitPackages)(cwd));

package/src/generators/utils/discover-packages.js.map

@@ -1 +1 @@
-{"version":3,"file":"discover-packages.js","sourceRoot":"","sources":["../../../../../../libs/migrations/src/generators/utils/discover-packages.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, readdirSync, readFileSync } from \"fs\";\nimport path from \"path\";\n\ntype PackageJsonWithMigrations = {\n  readonly name?: string;\n  readonly version: string;\n  readonly migrations?: string | { readonly migrations: string };\n};\n\nexport type DiscoveredPackage = {\n  readonly name: string;\n  readonly version: string;\n  readonly migrationsJsonPath: string;\n};\n\nconst readPackageJson = (pkgJsonPath: string): PackageJsonWithMigrations | undefined => {\n  try {\n    const raw = readFileSync(pkgJsonPath, \"utf-8\");\n    return JSON.parse(raw);\n  } catch {\n    return undefined;\n  }\n};\n\nconst resolveMigrationsPath = (pkgDir: string, pkgJson: PackageJsonWithMigrations): string | undefined => {\n  const migrations = pkgJson.migrations;\n  if (migrations === undefined) return undefined;\n\n  const migrationsFile = typeof migrations === \"string\" ? migrations : migrations.migrations;\n  const resolved = path.resolve(pkgDir, migrationsFile);\n\n  return existsSync(resolved) ? resolved : undefined;\n};\n\n/** Compares two semver strings, returning negative/zero/positive like Array.sort comparators. */\n/** Loads and parses a migrations.json file from disk. */\nexport const loadMigrationsJson = (\n  migrationsPath: string\n):\n  | {\n      readonly generators?: Record<\n        string,\n        { readonly version: string; readonly description: string; readonly implementation: string }\n      >;\n    }\n  | undefined => {\n  try {\n    const raw = readFileSync(migrationsPath, \"utf-8\");\n    return JSON.parse(raw);\n  } catch {\n    return undefined;\n  }\n};\n\nimport { compare } from \"semver\";\n/**\n * Compare two semver strings, returning negative/zero/positive like Array.sort comparators.\n *\n * @param a - The first semver string to compare.\n * @param b - The second semver string to compare.\n * @returns {number} A negative number if a < b, 0 if a === b, and a positive number if a > b.\n */\nexport const compareVersions = (a: string, b: string): number => compare(a, b);\n\nconst scanScopeDir = (scopeDir: string): ReadonlyArray<DiscoveredPackage> => {\n  if (!existsSync(scopeDir)) return [];\n\n  const entries = readdirSync(scopeDir, { withFileTypes: true });\n  const found: Array<DiscoveredPackage> = [];\n\n  for (const entry of entries) {\n    if (!entry.isDirectory() && !entry.isSymbolicLink()) continue;\n\n    const pkgDir = path.join(scopeDir, entry.name);\n    const pkgJsonPath = path.join(pkgDir, \"package.json\");\n    const pkgJson = readPackageJson(pkgJsonPath);\n\n    if (!pkgJson) continue;\n\n    const migrationsJsonPath = resolveMigrationsPath(pkgDir, pkgJson);\n    if (migrationsJsonPath) {\n      found.push({\n        name: pkgJson.name ?? `@trackunit/${entry.name}`,\n        version: pkgJson.version,\n        migrationsJsonPath,\n      });\n    }\n  }\n\n  return found;\n};\n\nconst MANAGER_REPO_PACKAGE_NAME = \"@trackunit/manager\";\nconst WORKSPACE_SCAN_ROOTS: ReadonlyArray<string> = [\"libs\", \"apps\"];\n\nconst isManagerMonorepo = (cwd: string): boolean => {\n  const rootPkgJson = readPackageJson(path.join(cwd, \"package.json\"));\n  return rootPkgJson?.name === MANAGER_REPO_PACKAGE_NAME;\n};\n\nconst walkForPackageJsons = (rootDir: string, onPackageJson: (pkgJsonPath: string) => void): void => {\n  if (!existsSync(rootDir)) return;\n\n  const stack: Array<string> = [rootDir];\n  while (stack.length > 0) {\n    const dir = stack.pop();\n    if (dir === undefined) continue;\n\n    let entries;\n    try {\n      entries = readdirSync(dir, { withFileTypes: true });\n    } catch {\n      continue;\n    }\n\n    for (const entry of entries) {\n      if (entry.name === \"node_modules\" || entry.name.startsWith(\".\")) continue;\n      const entryPath = path.join(dir, entry.name);\n      if (entry.isDirectory()) {\n        stack.push(entryPath);\n      } else if (entry.isFile() && entry.name === \"package.json\") {\n        onPackageJson(entryPath);\n      }\n    }\n  }\n};\n\n/**\n * In-monorepo fallback discovery: scans libs/ and apps/ for\n * package.json files whose name starts with \"@trackunit/\" and that\n * declare a \"migrations\" field. Used only when the engine is run\n * inside the manager monorepo (root package.json name is\n * \"@trackunit/manager\"), since internal workspace projects are not\n * symlinked under node_modules/@trackunit/* by Yarn.\n */\nexport const discoverWorkspaceTrackunitPackages = (cwd: string = process.cwd()): ReadonlyArray<DiscoveredPackage> => {\n  const found: Array<DiscoveredPackage> = [];\n\n  for (const root of WORKSPACE_SCAN_ROOTS) {\n    walkForPackageJsons(path.join(cwd, root), pkgJsonPath => {\n      const pkgJson = readPackageJson(pkgJsonPath);\n      if (!pkgJson?.name || !pkgJson.name.startsWith(\"@trackunit/\")) return;\n\n      const migrationsJsonPath = resolveMigrationsPath(path.dirname(pkgJsonPath), pkgJson);\n      if (!migrationsJsonPath) return;\n\n      found.push({\n        name: pkgJson.name,\n        version: pkgJson.version,\n        migrationsJsonPath,\n      });\n    });\n  }\n\n  return found;\n};\n\n/**\n * Recursively walks node_modules directories looking for @trackunit/*\n * packages that declare a \"migrations\" field. Scans root node_modules\n * and nested node_modules inside every package. When the same package\n * is found at multiple levels, the highest semver version is kept.\n *\n * Works with all package managers (npm, yarn, pnpm, bun).\n *\n * When invoked inside the manager monorepo (root package.json name\n * is \"@trackunit/manager\"), additionally scans libs/ and apps/ for\n * workspace packages that ship migrations, since those are not\n * linked under node_modules/@trackunit/.\n */\nexport const discoverTrackunitPackages = (): ReadonlyArray<DiscoveredPackage> => {\n  const cwd = process.cwd();\n  const rootNodeModules = path.resolve(cwd, \"node_modules\");\n  const allFound: Array<DiscoveredPackage> = [];\n  const visited = new Set<string>();\n\n  const walkNodeModules = (nodeModulesDir: string): void => {\n    if (!existsSync(nodeModulesDir)) return;\n\n    const canonical = path.resolve(nodeModulesDir);\n    if (visited.has(canonical)) return;\n    visited.add(canonical);\n\n    const trackunitScope = path.join(nodeModulesDir, \"@trackunit\");\n    allFound.push(...scanScopeDir(trackunitScope));\n\n    const topEntries = readdirSync(nodeModulesDir, {\n      withFileTypes: true,\n    });\n    for (const entry of topEntries) {\n      if (!entry.isDirectory() && !entry.isSymbolicLink()) continue;\n\n      const entryPath = path.join(nodeModulesDir, entry.name);\n\n      if (entry.name.startsWith(\"@\")) {\n        const scopeEntries = readdirSync(entryPath, {\n          withFileTypes: true,\n        });\n        for (const scopeEntry of scopeEntries) {\n          if (!scopeEntry.isDirectory() && !scopeEntry.isSymbolicLink()) continue;\n          walkNodeModules(path.join(entryPath, scopeEntry.name, \"node_modules\"));\n        }\n      } else {\n        walkNodeModules(path.join(entryPath, \"node_modules\"));\n      }\n    }\n  };\n\n  walkNodeModules(rootNodeModules);\n\n  if (isManagerMonorepo(cwd)) {\n    allFound.push(...discoverWorkspaceTrackunitPackages(cwd));\n  }\n\n  const byName = new Map<string, DiscoveredPackage>();\n  for (const pkg of allFound) {\n    const existing = byName.get(pkg.name);\n    if (!existing || compareVersions(pkg.version, existing.version) > 0) {\n      byName.set(pkg.name, pkg);\n    }\n  }\n\n  return [...byName.values()];\n};\n"]}
+{"version":3,"file":"discover-packages.js","sourceRoot":"","sources":["../../../../../../libs/migrations/src/generators/utils/discover-packages.ts"],"names":[],"mappings":";;;;AAAA,uCAAoC;AACpC,2BAAsF;AACtF,wDAAwB;AAcxB,MAAM,eAAe,GAAG,CAAC,WAAmB,EAAyC,EAAE;IACrF,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAA,iBAAY,EAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAC/C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,qBAAqB,GAAG,CAAC,MAAc,EAAE,OAAkC,EAAsB,EAAE;IACvG,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IACtC,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAE/C,MAAM,cAAc,GAAG,OAAO,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC;IAC3F,MAAM,QAAQ,GAAG,cAAI,CAAC,OAAO,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAEtD,OAAO,IAAA,eAAU,EAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;AACrD,CAAC,CAAC;AAEF,iGAAiG;AACjG,yDAAyD;AAClD,MAAM,kBAAkB,GAAG,CAChC,cAAsB,EAQV,EAAE;IACd,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAA,iBAAY,EAAC,cAAc,EAAE,OAAO,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC,CAAC;AAhBW,QAAA,kBAAkB,sBAgB7B;AAEF,mCAAiC;AACjC;;;;;;GAMG;AACI,MAAM,eAAe,GAAG,CAAC,CAAS,EAAE,CAAS,EAAU,EAAE,CAAC,IAAA,gBAAO,EAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAAlE,QAAA,eAAe,mBAAmD;AAE/E,+EAA+E;AAC/E,8EAA8E;AAC9E,6EAA6E;AAC7E,gEAAgE;AAChE,MAAM,WAAW,GAAG,CAAC,GAAW,EAAE,KAAc,EAAQ,EAAE;IACxD,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACtE,eAAM,CAAC,IAAI,CACT,YAAY,GAAG,4CAA4C,MAAM,4CAA4C,CAC9G,CAAC;AACJ,CAAC,CAAC;AAEF,2EAA2E;AAC3E,yEAAyE;AACzE,8EAA8E;AAC9E,0BAA0B;AAC1B,MAAM,cAAc,GAAG,CAAC,GAAW,EAAyB,EAAE;IAC5D,IAAI,CAAC;QACH,OAAO,IAAA,gBAAW,EAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,WAAW,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACxB,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,CAAC,QAAgB,EAAoC,EAAE;IAC1E,IAAI,CAAC,IAAA,eAAU,EAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,CAAC;IAErC,MAAM,OAAO,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IACzC,MAAM,KAAK,GAA6B,EAAE,CAAC;IAE3C,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE;YAAE,SAAS;QAE9D,MAAM,MAAM,GAAG,cAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/C,MAAM,WAAW,GAAG,cAAI,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;QACtD,MAAM,OAAO,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;QAE7C,IAAI,CAAC,OAAO;YAAE,SAAS;QAEvB,MAAM,kBAAkB,GAAG,qBAAqB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClE,IAAI,kBAAkB,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC;gBACT,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,cAAc,KAAK,CAAC,IAAI,EAAE;gBAChD,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,kBAAkB;aACnB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,MAAM,yBAAyB,GAAG,oBAAoB,CAAC;AACvD,MAAM,oBAAoB,GAA0B,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAErE,iEAAiE;AACjE,gEAAgE;AAChE,sCAAsC;AACtC,MAAM,cAAc,GAAG,CAAC,CAAC;AACzB,MAAM,YAAY,GAAG,CAAC,CAAC;AAEvB,MAAM,iBAAiB,GAAG,CAAC,GAAW,EAAW,EAAE;IACjD,MAAM,WAAW,GAAG,eAAe,CAAC,cAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC,CAAC;IACpE,OAAO,WAAW,EAAE,IAAI,KAAK,yBAAyB,CAAC;AACzD,CAAC,CAAC;AAEF,MAAM,mBAAmB,GAAG,CAAC,OAAe,EAAE,aAA4C,EAAQ,EAAE;IAClG,IAAI,CAAC,IAAA,eAAU,EAAC,OAAO,CAAC;QAAE,OAAO;IAEjC,MAAM,KAAK,GAAkB,CAAC,OAAO,CAAC,CAAC;IACvC,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;QACxB,IAAI,GAAG,KAAK,SAAS;YAAE,SAAS;QAEhC,KAAK,MAAM,KAAK,IAAI,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;YACxC,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;gBAAE,SAAS;YAC1E,MAAM,SAAS,GAAG,cAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAC7C,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACxB,CAAC;iBAAM,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;gBAC3D,aAAa,CAAC,SAAS,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC,CAAC;AAEF;;;;;;;GAOG;AACI,MAAM,kCAAkC,GAAG,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE,EAAoC,EAAE;IAClH,MAAM,KAAK,GAA6B,EAAE,CAAC;IAE3C,KAAK,MAAM,IAAI,IAAI,oBAAoB,EAAE,CAAC;QACxC,mBAAmB,CAAC,cAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,WAAW,CAAC,EAAE;YACtD,MAAM,OAAO,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;YAC7C,IAAI,CAAC,OAAO,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC;gBAAE,OAAO;YAEtE,MAAM,kBAAkB,GAAG,qBAAqB,CAAC,cAAI,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC,CAAC;YACrF,IAAI,CAAC,kBAAkB;gBAAE,OAAO;YAEhC,KAAK,CAAC,IAAI,CAAC;gBACT,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,kBAAkB;aACnB,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AApBW,QAAA,kCAAkC,sCAoB7C;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACI,MAAM,yBAAyB,GAAG,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE,EAAoC,EAAE;IACzG,MAAM,eAAe,GAAG,cAAI,CAAC,OAAO,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IAC1D,MAAM,QAAQ,GAA6B,EAAE,CAAC;IAC9C,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAElC,MAAM,eAAe,GAAG,CAAC,cAAsB,EAAQ,EAAE;QACvD,IAAI,CAAC,IAAA,eAAU,EAAC,cAAc,CAAC;YAAE,OAAO;QAExC,sEAAsE;QACtE,mEAAmE;QACnE,wEAAwE;QACxE,uEAAuE;QACvE,wEAAwE;QACxE,yEAAyE;QACzE,IAAI,SAAiB,CAAC;QACtB,IAAI,CAAC;YACH,SAAS,GAAG,IAAA,iBAAY,EAAC,cAAc,CAAC,CAAC;QAC3C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,WAAW,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;YACnC,OAAO;QACT,CAAC;QACD,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC;YAAE,OAAO;QACnC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAEvB,MAAM,cAAc,GAAG,cAAI,CAAC,IAAI,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;QAC/D,QAAQ,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,cAAc,CAAC,CAAC,CAAC;QAE/C,KAAK,MAAM,KAAK,IAAI,cAAc,CAAC,cAAc,CAAC,EAAE,CAAC;YACnD,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE;gBAAE,SAAS;YAE9D,MAAM,SAAS,GAAG,cAAI,CAAC,IAAI,CAAC,cAAc,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAExD,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC/B,KAAK,MAAM,UAAU,IAAI,cAAc,CAAC,SAAS,CAAC,EAAE,CAAC;oBACnD,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,IAAI,CAAC,UAAU,CAAC,cAAc,EAAE;wBAAE,SAAS;oBACxE,MAAM,YAAY,GAAG,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;oBAC3D,eAAe,CAAC,cAAI,CAAC,IAAI,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC,CAAC;oBACzD,mBAAmB,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;gBAClD,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,eAAe,CAAC,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC;gBACtD,mBAAmB,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;YACjD,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF;;;;;;;OAOG;IACH,SAAS,mBAAmB,CAAC,MAAc,EAAE,KAAa;QACxD,IAAI,CAAC,IAAA,eAAU,EAAC,MAAM,CAAC;YAAE,OAAO;QAEhC,IAAI,IAAY,CAAC;QACjB,IAAI,CAAC;YACH,IAAI,GAAG,IAAA,iBAAY,EAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YAC3B,OAAO;QACT,CAAC;QAED,IAAI,SAAS,GAAG,IAAI,CAAC;QACrB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,EAAE,KAAK,IAAI,CAAC;YAAE,SAAS,GAAG,cAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAEnF,IAAI,cAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,KAAK,cAAc;YAAE,eAAe,CAAC,SAAS,CAAC,CAAC;IAC9E,CAAC;IAED,eAAe,CAAC,eAAe,CAAC,CAAC;IAEjC,IAAI,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3B,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAA,0CAAkC,EAAC,GAAG,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,GAAG,EAA6B,CAAC;IACpD,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,QAAQ,IAAI,IAAA,uBAAe,EAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YACpE,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;AAC9B,CAAC,CAAC;AAtFW,QAAA,yBAAyB,6BAsFpC","sourcesContent":["import { logger } from \"@nx/devkit\";\nimport { type Dirent, existsSync, readdirSync, readFileSync, realpathSync } from \"fs\";\nimport path from \"path\";\n\ntype PackageJsonWithMigrations = {\n  readonly name?: string;\n  readonly version: string;\n  readonly migrations?: string | { readonly migrations: string };\n};\n\nexport type DiscoveredPackage = {\n  readonly name: string;\n  readonly version: string;\n  readonly migrationsJsonPath: string;\n};\n\nconst readPackageJson = (pkgJsonPath: string): PackageJsonWithMigrations | undefined => {\n  try {\n    const raw = readFileSync(pkgJsonPath, \"utf-8\");\n    return JSON.parse(raw);\n  } catch {\n    return undefined;\n  }\n};\n\nconst resolveMigrationsPath = (pkgDir: string, pkgJson: PackageJsonWithMigrations): string | undefined => {\n  const migrations = pkgJson.migrations;\n  if (migrations === undefined) return undefined;\n\n  const migrationsFile = typeof migrations === \"string\" ? migrations : migrations.migrations;\n  const resolved = path.resolve(pkgDir, migrationsFile);\n\n  return existsSync(resolved) ? resolved : undefined;\n};\n\n/** Compares two semver strings, returning negative/zero/positive like Array.sort comparators. */\n/** Loads and parses a migrations.json file from disk. */\nexport const loadMigrationsJson = (\n  migrationsPath: string\n):\n  | {\n      readonly generators?: Record<\n        string,\n        { readonly version: string; readonly description: string; readonly implementation: string }\n      >;\n    }\n  | undefined => {\n  try {\n    const raw = readFileSync(migrationsPath, \"utf-8\");\n    return JSON.parse(raw);\n  } catch {\n    return undefined;\n  }\n};\n\nimport { compare } from \"semver\";\n/**\n * Compare two semver strings, returning negative/zero/positive like Array.sort comparators.\n *\n * @param a - The first semver string to compare.\n * @param b - The second semver string to compare.\n * @returns {number} A negative number if a < b, 0 if a === b, and a positive number if a > b.\n */\nexport const compareVersions = (a: string, b: string): number => compare(a, b);\n\n// Swallowing a failed directory read shrinks the discovered package set, which\n// `migrate` then reports as \"no pending migrations\" -- indistinguishable from\n// the green-run-no-codemods symptom this walker exists to fix. Warning keeps\n// the walk crash-proof while making a truncated result visible.\nconst warnSkipped = (dir: string, error: unknown): void => {\n  const reason = error instanceof Error ? error.message : String(error);\n  logger.warn(\n    `Skipped \"${dir}\" while discovering @trackunit packages: ${reason}. Discovered migrations may be incomplete.`\n  );\n};\n\n// `existsSync` only says the entry resolved, not that it can be listed: an\n// unreadable store directory or a path that turns out to be a file still\n// throws. Every listing in this module goes through here so one bad directory\n// cannot abort discovery.\nconst readDirEntries = (dir: string): ReadonlyArray<Dirent> => {\n  try {\n    return readdirSync(dir, { withFileTypes: true });\n  } catch (error) {\n    warnSkipped(dir, error);\n    return [];\n  }\n};\n\nconst scanScopeDir = (scopeDir: string): ReadonlyArray<DiscoveredPackage> => {\n  if (!existsSync(scopeDir)) return [];\n\n  const entries = readDirEntries(scopeDir);\n  const found: Array<DiscoveredPackage> = [];\n\n  for (const entry of entries) {\n    if (!entry.isDirectory() && !entry.isSymbolicLink()) continue;\n\n    const pkgDir = path.join(scopeDir, entry.name);\n    const pkgJsonPath = path.join(pkgDir, \"package.json\");\n    const pkgJson = readPackageJson(pkgJsonPath);\n\n    if (!pkgJson) continue;\n\n    const migrationsJsonPath = resolveMigrationsPath(pkgDir, pkgJson);\n    if (migrationsJsonPath) {\n      found.push({\n        name: pkgJson.name ?? `@trackunit/${entry.name}`,\n        version: pkgJson.version,\n        migrationsJsonPath,\n      });\n    }\n  }\n\n  return found;\n};\n\nconst MANAGER_REPO_PACKAGE_NAME = \"@trackunit/manager\";\nconst WORKSPACE_SCAN_ROOTS: ReadonlyArray<string> = [\"libs\", \"apps\"];\n\n// Levels to climb from a resolved package directory to reach the\n// `node_modules` holding it: `<store>/node_modules/name` versus\n// `<store>/node_modules/@scope/name`.\nconst UNSCOPED_DEPTH = 1;\nconst SCOPED_DEPTH = 2;\n\nconst isManagerMonorepo = (cwd: string): boolean => {\n  const rootPkgJson = readPackageJson(path.join(cwd, \"package.json\"));\n  return rootPkgJson?.name === MANAGER_REPO_PACKAGE_NAME;\n};\n\nconst walkForPackageJsons = (rootDir: string, onPackageJson: (pkgJsonPath: string) => void): void => {\n  if (!existsSync(rootDir)) return;\n\n  const stack: Array<string> = [rootDir];\n  while (stack.length > 0) {\n    const dir = stack.pop();\n    if (dir === undefined) continue;\n\n    for (const entry of readDirEntries(dir)) {\n      if (entry.name === \"node_modules\" || entry.name.startsWith(\".\")) continue;\n      const entryPath = path.join(dir, entry.name);\n      if (entry.isDirectory()) {\n        stack.push(entryPath);\n      } else if (entry.isFile() && entry.name === \"package.json\") {\n        onPackageJson(entryPath);\n      }\n    }\n  }\n};\n\n/**\n * In-monorepo fallback discovery: scans libs/ and apps/ for\n * package.json files whose name starts with \"@trackunit/\" and that\n * declare a \"migrations\" field. Used only when the engine is run\n * inside the manager monorepo (root package.json name is\n * \"@trackunit/manager\"), since internal workspace projects are not\n * symlinked under node_modules/@trackunit/* by Yarn.\n */\nexport const discoverWorkspaceTrackunitPackages = (cwd: string = process.cwd()): ReadonlyArray<DiscoveredPackage> => {\n  const found: Array<DiscoveredPackage> = [];\n\n  for (const root of WORKSPACE_SCAN_ROOTS) {\n    walkForPackageJsons(path.join(cwd, root), pkgJsonPath => {\n      const pkgJson = readPackageJson(pkgJsonPath);\n      if (!pkgJson?.name || !pkgJson.name.startsWith(\"@trackunit/\")) return;\n\n      const migrationsJsonPath = resolveMigrationsPath(path.dirname(pkgJsonPath), pkgJson);\n      if (!migrationsJsonPath) return;\n\n      found.push({\n        name: pkgJson.name,\n        version: pkgJson.version,\n        migrationsJsonPath,\n      });\n    });\n  }\n\n  return found;\n};\n\n/**\n * Recursively walks node_modules directories looking for @trackunit/*\n * packages that declare a \"migrations\" field. Scans root node_modules\n * and nested node_modules inside every package. When the same package\n * is found at multiple levels, the highest semver version is kept.\n *\n * Works with hoisted layouts (npm, yarn) and with the isolated layouts\n * where dependencies are symlinks into a content store (Yarn\n * `nodeLinker: pnpm`, pnpm, bun), including pnpm with hoisting disabled,\n * where a package's dependencies are siblings of it inside the store\n * rather than nested beneath it.\n *\n * When invoked inside the manager monorepo (root package.json name\n * is \"@trackunit/manager\"), additionally scans libs/ and apps/ for\n * workspace packages that ship migrations, since those are not\n * linked under node_modules/@trackunit/.\n *\n * @param cwd - Workspace root to scan; defaults to the current directory\n * @returns {ReadonlyArray<DiscoveredPackage>} One entry per package name, at its highest discovered version\n */\nexport const discoverTrackunitPackages = (cwd: string = process.cwd()): ReadonlyArray<DiscoveredPackage> => {\n  const rootNodeModules = path.resolve(cwd, \"node_modules\");\n  const allFound: Array<DiscoveredPackage> = [];\n  const visited = new Set<string>();\n\n  const walkNodeModules = (nodeModulesDir: string): void => {\n    if (!existsSync(nodeModulesDir)) return;\n\n    // Isolated layouts (Yarn `nodeLinker: pnpm`, pnpm, bun) symlink every\n    // dependency into a content store, so a mutual dependency produces\n    // endless distinct logical paths pointing at the same real directories.\n    // `path.resolve` normalises but does not follow symlinks, so it cannot\n    // recognise the repeat and the walk grows the path until the OS rejects\n    // it. Canonicalising through the real path is what makes this terminate.\n    let canonical: string;\n    try {\n      canonical = realpathSync(nodeModulesDir);\n    } catch (error) {\n      warnSkipped(nodeModulesDir, error);\n      return;\n    }\n    if (visited.has(canonical)) return;\n    visited.add(canonical);\n\n    const trackunitScope = path.join(nodeModulesDir, \"@trackunit\");\n    allFound.push(...scanScopeDir(trackunitScope));\n\n    for (const entry of readDirEntries(nodeModulesDir)) {\n      if (!entry.isDirectory() && !entry.isSymbolicLink()) continue;\n\n      const entryPath = path.join(nodeModulesDir, entry.name);\n\n      if (entry.name.startsWith(\"@\")) {\n        for (const scopeEntry of readDirEntries(entryPath)) {\n          if (!scopeEntry.isDirectory() && !scopeEntry.isSymbolicLink()) continue;\n          const scopedPkgDir = path.join(entryPath, scopeEntry.name);\n          walkNodeModules(path.join(scopedPkgDir, \"node_modules\"));\n          walkStoreSiblingsOf(scopedPkgDir, SCOPED_DEPTH);\n        }\n      } else {\n        walkNodeModules(path.join(entryPath, \"node_modules\"));\n        walkStoreSiblingsOf(entryPath, UNSCOPED_DEPTH);\n      }\n    }\n  };\n\n  /**\n   * pnpm with hoisting disabled places a package's dependencies *alongside*\n   * it inside the store rather than nested beneath it, so probing only\n   * `<entry>/node_modules` never reaches a @trackunit package that is purely\n   * transitive. Resolving the entry and walking the store `node_modules` that\n   * contains it reaches those siblings. In hoisted layouts this resolves back\n   * to a directory the walk has already scanned, so `visited` makes it free.\n   */\n  function walkStoreSiblingsOf(pkgDir: string, depth: number): void {\n    if (!existsSync(pkgDir)) return;\n\n    let real: string;\n    try {\n      real = realpathSync(pkgDir);\n    } catch (error) {\n      warnSkipped(pkgDir, error);\n      return;\n    }\n\n    let candidate = real;\n    for (let level = 0; level < depth; level += 1) candidate = path.dirname(candidate);\n\n    if (path.basename(candidate) === \"node_modules\") walkNodeModules(candidate);\n  }\n\n  walkNodeModules(rootNodeModules);\n\n  if (isManagerMonorepo(cwd)) {\n    allFound.push(...discoverWorkspaceTrackunitPackages(cwd));\n  }\n\n  const byName = new Map<string, DiscoveredPackage>();\n  for (const pkg of allFound) {\n    const existing = byName.get(pkg.name);\n    if (!existing || compareVersions(pkg.version, existing.version) > 0) {\n      byName.set(pkg.name, pkg);\n    }\n  }\n\n  return [...byName.values()];\n};\n"]}