@kb-labs/devkit 1.0.0 → 1.2.0

package/bin/devkit-check-commands.mjs

@@ -17,6 +17,9 @@ import { execSync, spawn } from 'node:child_process';
 import fs from 'node:fs';
 import path from 'node:path';
 
+// Shared package discovery — supports both flat and categorized layouts
+import { findPackages } from './lib/find-packages.mjs';
+
 // ANSI colors
 const colors = {
   reset: '\x1b[0m',
@@ -49,31 +52,12 @@ const options = {
  * Find all plugin manifests in monorepo
  */
 function findPluginManifests(rootDir) {
-  const manifests = [];
-  const entries = fs.readdirSync(rootDir, { withFileTypes: true });
-
-  for (const entry of entries) {
-    if (!entry.isDirectory() || !entry.name.startsWith('kb-labs-')) {continue;}
-
-    const repoPath = path.join(rootDir, entry.name);
-    const packagesDir = path.join(repoPath, 'packages');
-
-    if (!fs.existsSync(packagesDir)) {continue;}
-
-    const packageDirs = fs.readdirSync(packagesDir, { withFileTypes: true });
-
-    for (const pkgDir of packageDirs) {
-      if (!pkgDir.isDirectory()) {continue;}
-
-      const manifestPath = path.join(packagesDir, pkgDir.name, 'manifest.json');
-
-      if (fs.existsSync(manifestPath)) {
-        manifests.push(manifestPath);
-      }
-    }
-  }
-
-  return manifests;
+  return findPackages(rootDir)
+    .map((pkgPath) => {
+      const manifestPath = path.join(path.dirname(pkgPath), 'manifest.json');
+      return fs.existsSync(manifestPath) ? manifestPath : null;
+    })
+    .filter(Boolean);
 }
 
 /**

package/bin/devkit-check-deprecated.mjs

@@ -27,6 +27,9 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 
+// Shared package discovery — supports both flat and categorized layouts
+import { findPackages as _findPackagePaths } from './lib/find-packages.mjs';
+
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
 // ANSI colors
@@ -85,48 +88,30 @@ Options:
 }
 
 /**
- * Find all kb-labs-* packages
+ * Find all kb-labs-* packages with src directories
  */
 function findPackages(rootDir, filterPackage) {
-  const packages = [];
-  const entries = fs.readdirSync(rootDir, { withFileTypes: true });
-
-  for (const entry of entries) {
-    if (!entry.isDirectory() || !entry.name.startsWith('kb-labs-')) {continue;}
-
-    const repoPath = path.join(rootDir, entry.name);
-    const packagesDir = path.join(repoPath, 'packages');
-
-    if (!fs.existsSync(packagesDir)) {continue;}
-
-    const packageDirs = fs.readdirSync(packagesDir, { withFileTypes: true });
-
-    for (const pkgDir of packageDirs) {
-      if (!pkgDir.isDirectory()) {continue;}
-
-      if (filterPackage && pkgDir.name !== filterPackage) {continue;}
-
-      const packageJsonPath = path.join(packagesDir, pkgDir.name, 'package.json');
-      const srcDir = path.join(packagesDir, pkgDir.name, 'src');
-
-      if (fs.existsSync(packageJsonPath) && fs.existsSync(srcDir)) {
-        try {
-          const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
-          packages.push({
-            name: packageJson.name,
-            shortName: pkgDir.name,
-            repo: entry.name,
-            path: path.join(packagesDir, pkgDir.name),
-            srcPath: srcDir,
-          });
-        } catch {
-          // Skip invalid package.json
-        }
+  return _findPackagePaths(rootDir, filterPackage)
+    .map((pkgPath) => {
+      const dir = path.dirname(pkgPath);
+      const srcDir = path.join(dir, 'src');
+      if (!fs.existsSync(srcDir)) return null;
+      try {
+        const packageJson = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+        const parts = pkgPath.split(path.sep);
+        const repo = parts.find((p) => p.startsWith('kb-labs-')) || 'unknown';
+        return {
+          name: packageJson.name,
+          shortName: path.basename(dir),
+          repo,
+          path: dir,
+          srcPath: srcDir,
+        };
+      } catch {
+        return null;
       }
-    }
-  }
-
-  return packages;
+    })
+    .filter(Boolean);
 }
 
 /**

package/bin/devkit-check-duplicates.mjs

@@ -19,6 +19,9 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 
+// Shared package discovery — supports both flat and categorized layouts
+import { findPackages } from './lib/find-packages.mjs';
+
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
 // ANSI colors
@@ -45,40 +48,6 @@ const options = {
   verbose: args.includes('--verbose') || args.includes('-v'),
 };
 
-/**
- * Find all packages in monorepo
- */
-function findPackages(rootDir, filterPackage) {
-  const packages = [];
-  const entries = fs.readdirSync(rootDir, { withFileTypes: true });
-
-  for (const entry of entries) {
-    if (!entry.isDirectory() || !entry.name.startsWith('kb-labs-')) {continue;}
-
-    const repoPath = path.join(rootDir, entry.name);
-    const packagesDir = path.join(repoPath, 'packages');
-
-    if (!fs.existsSync(packagesDir)) {continue;}
-
-    const packageDirs = fs.readdirSync(packagesDir, { withFileTypes: true });
-
-    for (const pkgDir of packageDirs) {
-      if (!pkgDir.isDirectory()) {continue;}
-
-      // Filter by package name if specified
-      if (filterPackage && pkgDir.name !== filterPackage) {continue;}
-
-      const packageJsonPath = path.join(packagesDir, pkgDir.name, 'package.json');
-
-      if (fs.existsSync(packageJsonPath)) {
-        packages.push(packageJsonPath);
-      }
-    }
-  }
-
-  return packages;
-}
-
 /**
  * Collect all dependencies from all packages
  */

package/bin/devkit-check-exports.mjs

@@ -19,6 +19,9 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 
+// Shared package discovery — supports both flat and categorized layouts
+import { findPackages } from './lib/find-packages.mjs';
+
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
 // ANSI colors
@@ -382,40 +385,6 @@ function checkPackage(packageJsonPath, allPackages) {
   };
 }
 
-/**
- * Find all packages in monorepo
- */
-function findPackages(rootDir, filterPackage) {
-  const packages = [];
-  const entries = fs.readdirSync(rootDir, { withFileTypes: true });
-
-  for (const entry of entries) {
-    if (!entry.isDirectory() || !entry.name.startsWith('kb-labs-')) {continue;}
-
-    const repoPath = path.join(rootDir, entry.name);
-    const packagesDir = path.join(repoPath, 'packages');
-
-    if (!fs.existsSync(packagesDir)) {continue;}
-
-    const packageDirs = fs.readdirSync(packagesDir, { withFileTypes: true });
-
-    for (const pkgDir of packageDirs) {
-      if (!pkgDir.isDirectory()) {continue;}
-
-      // Filter by package name if specified
-      if (filterPackage && pkgDir.name !== filterPackage) {continue;}
-
-      const packageJsonPath = path.join(packagesDir, pkgDir.name, 'package.json');
-
-      if (fs.existsSync(packageJsonPath)) {
-        packages.push(packageJsonPath);
-      }
-    }
-  }
-
-  return packages;
-}
-
 /**
  * Main function
  */

package/bin/devkit-check-imports.mjs

@@ -19,6 +19,9 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 
+// Shared package discovery — supports both flat and categorized layouts
+import { findPackages } from './lib/find-packages.mjs';
+
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
 /**
@@ -356,40 +359,6 @@ function checkPackage(packageJsonPath) {
   };
 }
 
-/**
- * Find all packages in monorepo
- */
-function findPackages(rootDir, filterPackage) {
-  const packages = [];
-  const entries = fs.readdirSync(rootDir, { withFileTypes: true });
-
-  for (const entry of entries) {
-    if (!entry.isDirectory() || !entry.name.startsWith('kb-labs-')) {continue;}
-
-    const repoPath = path.join(rootDir, entry.name);
-    const packagesDir = path.join(repoPath, 'packages');
-
-    if (!fs.existsSync(packagesDir)) {continue;}
-
-    const packageDirs = fs.readdirSync(packagesDir, { withFileTypes: true });
-
-    for (const pkgDir of packageDirs) {
-      if (!pkgDir.isDirectory()) {continue;}
-
-      // Filter by package name if specified
-      if (filterPackage && pkgDir.name !== filterPackage) {continue;}
-
-      const packageJsonPath = path.join(packagesDir, pkgDir.name, 'package.json');
-
-      if (fs.existsSync(packageJsonPath)) {
-        packages.push(packageJsonPath);
-      }
-    }
-  }
-
-  return packages;
-}
-
 /**
  * Detect circular dependencies between packages
  */

package/bin/devkit-check-paths.mjs

@@ -21,6 +21,9 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 
+// Shared package discovery — supports both flat and categorized layouts
+import { findPackages as _findPackagePaths } from './lib/find-packages.mjs';
+
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
 // ANSI colors
@@ -52,40 +55,14 @@ const options = {
 };
 
 /**
- * Find all packages in monorepo
+ * Find all packages in monorepo (returns objects with path, dir, repo)
  */
 function findPackages(rootDir, filterPackage) {
-  const packages = [];
-  const entries = fs.readdirSync(rootDir, { withFileTypes: true });
-
-  for (const entry of entries) {
-    if (!entry.isDirectory() || !entry.name.startsWith('kb-labs-')) {continue;}
-
-    const repoPath = path.join(rootDir, entry.name);
-    const packagesDir = path.join(repoPath, 'packages');
-
-    if (!fs.existsSync(packagesDir)) {continue;}
-
-    const packageDirs = fs.readdirSync(packagesDir, { withFileTypes: true });
-
-    for (const pkgDir of packageDirs) {
-      if (!pkgDir.isDirectory()) {continue;}
-
-      if (filterPackage && pkgDir.name !== filterPackage) {continue;}
-
-      const packageJsonPath = path.join(packagesDir, pkgDir.name, 'package.json');
-
-      if (fs.existsSync(packageJsonPath)) {
-        packages.push({
-          path: packageJsonPath,
-          dir: path.join(packagesDir, pkgDir.name),
-          repo: entry.name,
-        });
-      }
-    }
-  }
-
-  return packages;
+  return _findPackagePaths(rootDir, filterPackage).map((pkgPath) => {
+    const parts = pkgPath.split(path.sep);
+    const repo = parts.find((p) => p.startsWith('kb-labs-')) || 'unknown';
+    return { path: pkgPath, dir: path.dirname(pkgPath), repo };
+  });
 }
 
 /**

package/bin/devkit-check-structure.mjs

@@ -20,6 +20,9 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 
+// Shared package discovery — supports both flat and categorized layouts
+import { findPackages } from './lib/find-packages.mjs';
+
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
 // ANSI colors
@@ -272,40 +275,6 @@ function checkPackage(packageJsonPath) {
   };
 }
 
-/**
- * Find all packages in monorepo
- */
-function findPackages(rootDir, filterPackage) {
-  const packages = [];
-  const entries = fs.readdirSync(rootDir, { withFileTypes: true });
-
-  for (const entry of entries) {
-    if (!entry.isDirectory() || !entry.name.startsWith('kb-labs-')) {continue;}
-
-    const repoPath = path.join(rootDir, entry.name);
-    const packagesDir = path.join(repoPath, 'packages');
-
-    if (!fs.existsSync(packagesDir)) {continue;}
-
-    const packageDirs = fs.readdirSync(packagesDir, { withFileTypes: true });
-
-    for (const pkgDir of packageDirs) {
-      if (!pkgDir.isDirectory()) {continue;}
-
-      // Filter by package name if specified
-      if (filterPackage && pkgDir.name !== filterPackage) {continue;}
-
-      const packageJsonPath = path.join(packagesDir, pkgDir.name, 'package.json');
-
-      if (fs.existsSync(packageJsonPath)) {
-        packages.push(packageJsonPath);
-      }
-    }
-  }
-
-  return packages;
-}
-
 /**
  * Main function
  */

package/bin/devkit-check-types.mjs

@@ -18,6 +18,9 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 
+// Shared package discovery — supports both flat and categorized layouts
+import { findPackages as _findPackagePaths } from './lib/find-packages.mjs';
+
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
 // ANSI colors
@@ -50,39 +53,13 @@ const options = {
 };
 
 /**
- * Find all packages
+ * Find all packages (returns objects with path, dir)
  */
 function findPackages(rootDir, filterPackage) {
-  const packages = [];
-  const entries = fs.readdirSync(rootDir, { withFileTypes: true });
-
-  for (const entry of entries) {
-    if (!entry.isDirectory() || !entry.name.startsWith('kb-labs-')) {continue;}
-
-    const repoPath = path.join(rootDir, entry.name);
-    const packagesDir = path.join(repoPath, 'packages');
-
-    if (!fs.existsSync(packagesDir)) {continue;}
-
-    const packageDirs = fs.readdirSync(packagesDir, { withFileTypes: true });
-
-    for (const pkgDir of packageDirs) {
-      if (!pkgDir.isDirectory()) {continue;}
-
-      if (filterPackage && pkgDir.name !== filterPackage) {continue;}
-
-      const packageJsonPath = path.join(packagesDir, pkgDir.name, 'package.json');
-
-      if (fs.existsSync(packageJsonPath)) {
-        packages.push({
-          path: packageJsonPath,
-          dir: path.join(packagesDir, pkgDir.name),
-        });
-      }
-    }
-  }
-
-  return packages;
+  return _findPackagePaths(rootDir, filterPackage).map((pkgPath) => ({
+    path: pkgPath,
+    dir: path.dirname(pkgPath),
+  }));
 }
 
 /**

package/bin/devkit-fix-deps.mjs

@@ -24,6 +24,9 @@ import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { execSync } from 'node:child_process';
 
+// Shared package discovery — supports both flat and categorized layouts
+import { findPackages } from './lib/find-packages.mjs';
+
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
 // ANSI colors
@@ -66,39 +69,6 @@ if (options.all) {
   options.alignVersions = true;
 }
 
-/**
- * Find all packages in monorepo
- */
-function findPackages(rootDir, filterPackage) {
-  const packages = [];
-  const entries = fs.readdirSync(rootDir, { withFileTypes: true });
-
-  for (const entry of entries) {
-    if (!entry.isDirectory() || !entry.name.startsWith('kb-labs-')) {continue;}
-
-    const repoPath = path.join(rootDir, entry.name);
-    const packagesDir = path.join(repoPath, 'packages');
-
-    if (!fs.existsSync(packagesDir)) {continue;}
-
-    const packageDirs = fs.readdirSync(packagesDir, { withFileTypes: true });
-
-    for (const pkgDir of packageDirs) {
-      if (!pkgDir.isDirectory()) {continue;}
-
-      if (filterPackage && pkgDir.name !== filterPackage) {continue;}
-
-      const packageJsonPath = path.join(packagesDir, pkgDir.name, 'package.json');
-
-      if (fs.existsSync(packageJsonPath)) {
-        packages.push(packageJsonPath);
-      }
-    }
-  }
-
-  return packages;
-}
-
 /**
  * Extract imports from source files
  */

package/bin/devkit-health.mjs

@@ -28,6 +28,9 @@ import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { execSync } from 'node:child_process';
 
+// Shared package discovery — supports both flat and categorized layouts
+import { findPackages as _findPackagePaths } from './lib/find-packages.mjs';
+
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
 // ANSI colors
@@ -66,42 +69,17 @@ const rootDir = findMonorepoRoot();
  * Find all packages in monorepo
  */
 function findAllPackages() {
-  const packages = [];
-  const searchDirs = [
-    'packages',
-    'kb-labs-*/packages',
-  ];
-
-  for (const pattern of searchDirs) {
-    const dirs = pattern.includes('*')
-      ? execSync(`find ${rootDir} -type d -path "*/${pattern}" 2>/dev/null || true`, { encoding: 'utf-8' })
-          .split('\n')
-          .filter(Boolean)
-      : [path.join(rootDir, pattern)];
-
-    for (const dir of dirs) {
-      if (!fs.existsSync(dir)) {continue;}
-
-      const subDirs = fs.readdirSync(dir, { withFileTypes: true })
-        .filter((d) => d.isDirectory())
-        .map((d) => path.join(dir, d.name));
-
-      for (const subDir of subDirs) {
-        const pkgPath = path.join(subDir, 'package.json');
-        if (fs.existsSync(pkgPath)) {
-          try {
-            const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
-            if (packageFilter && !pkg.name.includes(packageFilter)) {continue;}
-            packages.push({ name: pkg.name, path: subDir, pkg });
-          } catch (err) {
-            // Skip invalid package.json
-          }
-        }
+  return _findPackagePaths(rootDir)
+    .map((pkgJsonPath) => {
+      try {
+        const pkg = JSON.parse(fs.readFileSync(pkgJsonPath, 'utf-8'));
+        if (packageFilter && !pkg.name.includes(packageFilter)) return null;
+        return { name: pkg.name, path: path.dirname(pkgJsonPath), pkg };
+      } catch (err) {
+        return null;
       }
-    }
-  }
-
-  return packages;
+    })
+    .filter(Boolean);
 }
 
 /**

package/bin/devkit-stats.mjs

@@ -17,6 +17,9 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 
+// Shared package discovery — supports both flat and categorized layouts
+import { findPackages } from './lib/find-packages.mjs';
+
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
 // ANSI colors
@@ -46,37 +49,6 @@ const options = {
   health: args.includes('--health'),
 };
 
-/**
- * Find all packages
- */
-function findPackages(rootDir) {
-  const packages = [];
-  const entries = fs.readdirSync(rootDir, { withFileTypes: true });
-
-  for (const entry of entries) {
-    if (!entry.isDirectory() || !entry.name.startsWith('kb-labs-')) {continue;}
-
-    const repoPath = path.join(rootDir, entry.name);
-    const packagesDir = path.join(repoPath, 'packages');
-
-    if (!fs.existsSync(packagesDir)) {continue;}
-
-    const packageDirs = fs.readdirSync(packagesDir, { withFileTypes: true });
-
-    for (const pkgDir of packageDirs) {
-      if (!pkgDir.isDirectory()) {continue;}
-
-      const packageJsonPath = path.join(packagesDir, pkgDir.name, 'package.json');
-
-      if (fs.existsSync(packageJsonPath)) {
-        packages.push(packageJsonPath);
-      }
-    }
-  }
-
-  return packages;
-}
-
 /**
  * Calculate package size
  */

package/bin/devkit-types-audit.mjs

@@ -25,6 +25,9 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 
+// Shared package discovery — supports both flat and categorized layouts
+import { findPackages as _findPackagePaths } from './lib/find-packages.mjs';
+
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
 // ANSI colors
@@ -57,42 +60,18 @@ const options = {
 };
 
 /**
- * Find all packages
+ * Find all packages with TypeScript configs
  */
 function findPackages(rootDir) {
-  const packages = [];
-  const entries = fs.readdirSync(rootDir, { withFileTypes: true });
-
-  for (const entry of entries) {
-    if (!entry.isDirectory() || !entry.name.startsWith('kb-labs-')) {continue;}
-
-    const repoPath = path.join(rootDir, entry.name);
-    const packagesDir = path.join(repoPath, 'packages');
-
-    if (!fs.existsSync(packagesDir)) {continue;}
-
-    const packageDirs = fs.readdirSync(packagesDir, { withFileTypes: true });
-
-    for (const pkgDir of packageDirs) {
-      if (!pkgDir.isDirectory()) {continue;}
-
-      const packageJsonPath = path.join(packagesDir, pkgDir.name, 'package.json');
-      const tsconfigPath = path.join(packagesDir, pkgDir.name, 'tsconfig.json');
-
-      if (fs.existsSync(packageJsonPath) && fs.existsSync(tsconfigPath)) {
-        const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
-
-        packages.push({
-          name: packageJson.name,
-          path: packageJsonPath,
-          dir: path.join(packagesDir, pkgDir.name),
-          tsconfigPath,
-        });
-      }
-    }
-  }
-
-  return packages;
+  return _findPackagePaths(rootDir)
+    .map((pkgPath) => {
+      const dir = path.dirname(pkgPath);
+      const tsconfigPath = path.join(dir, 'tsconfig.json');
+      if (!fs.existsSync(tsconfigPath)) return null;
+      const packageJson = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+      return { name: packageJson.name, path: pkgPath, dir, tsconfigPath };
+    })
+    .filter(Boolean);
 }
 
 /**