@kb-labs/quality-core 0.6.0

package/README.md

@@ -0,0 +1,63 @@
+# @kb-labs/quality-core
+
+Core business logic for KB Labs Quality Plugin. This package contains all the analysis and computation logic for monorepo quality analysis, separated from CLI and REST handlers.
+
+## Architecture
+
+This package follows the **commit-plugin** pattern where business logic is extracted into a separate `core` package:
+
+```
+quality-core/        # Business logic (this package)
+quality-cli/         # CLI commands + REST handlers
+quality-contracts/   # Shared types and schemas
+```
+
+## Modules
+
+### `stats` - Monorepo Statistics
+- `calculateStats(rootDir: string): Promise<StatsResult>`
+- Package counting, LOC analysis, size calculation
+
+### `health` - Health Scoring
+- `calculateHealth(rootDir: string): Promise<HealthResult>`
+- Dependency health, structure validation, grade A-F
+
+### `dependencies` - Dependency Analysis
+- `analyzeDependencies(rootDir: string): Promise<DependencyAnalysis>`
+- Find duplicates, unused, missing workspace dependencies
+
+### `build-order` - Topological Sort
+- `calculateBuildOrder(rootDir: string): Promise<BuildOrderResult>`
+- Topological sort with parallel build layers
+- Circular dependency detection
+
+### `graph` - Dependency Graph
+- `buildDependencyGraph(rootDir: string): DependencyGraph`
+- Tree view, reverse dependencies, impact analysis
+
+## Usage
+
+```typescript
+import { calculateStats } from '@kb-labs/quality-core/stats';
+import { calculateHealth } from '@kb-labs/quality-core/health';
+import { analyzeDependencies } from '@kb-labs/quality-core/dependencies';
+
+// In CLI command
+const stats = await calculateStats(ctx.cwd);
+ctx.ui.success('Stats calculated', { data: stats });
+
+// In REST handler
+const health = await calculateHealth(ctx.cwd);
+return { score: health.score, grade: health.grade };
+```
+
+## Why Separate Core?
+
+- **Reusability**: CLI, REST handlers, and Studio all use same logic
+- **Testability**: Easy to unit test without CLI/REST overhead
+- **Maintainability**: Business logic changes don't affect handlers
+- **Type Safety**: Single source of truth for calculations
+
+## License
+
+MIT

package/dist/builds/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Check build status across monorepo packages
+ *
+ * Pure computation - no CLI, no dependencies on devkit
+ */
+interface BuildCheckResult {
+    totalPackages: number;
+    passing: number;
+    failing: number;
+    failures: Array<{
+        package: string;
+        error: string;
+        exitCode: number;
+    }>;
+    staleBuilds: Array<{
+        package: string;
+        distMtime: number;
+        srcMtime: number;
+    }>;
+    duration: number;
+}
+interface BuildCheckOptions {
+    packageFilter?: string;
+    includeDevDeps?: boolean;
+    timeout?: number;
+}
+/**
+ * Check builds across monorepo
+ *
+ * @returns Build check results with failures and stale builds
+ */
+declare function checkBuilds(rootDir: string, options?: BuildCheckOptions): Promise<BuildCheckResult>;
+
+export { type BuildCheckOptions, type BuildCheckResult, checkBuilds };

package/dist/builds/index.js

@@ -0,0 +1,133 @@
+import { exec } from 'child_process';
+import { promisify } from 'util';
+import fs from 'fs';
+import path from 'path';
+
+// src/builds/check-builds.ts
+var execAsync = promisify(exec);
+function findPackagesWithBuildScript(rootDir, filter) {
+  const packages = [];
+  if (!fs.existsSync(rootDir)) {
+    return 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)) {
+        const pkgJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf-8"));
+        if (!pkgJson.scripts?.build) {
+          continue;
+        }
+        if (filter && !pkgJson.name.includes(filter) && !pkgDir.name.includes(filter)) {
+          continue;
+        }
+        packages.push(packageJsonPath);
+      }
+    }
+  }
+  return packages;
+}
+function isDistStale(packageDir) {
+  const distFile = path.join(packageDir, "dist/index.js");
+  const srcDir = path.join(packageDir, "src");
+  if (!fs.existsSync(distFile)) {
+    return { stale: false };
+  }
+  if (!fs.existsSync(srcDir)) {
+    return { stale: false };
+  }
+  const distMtime = fs.statSync(distFile).mtime.getTime();
+  let newestSrcMtime = 0;
+  function walkDir(dir) {
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+      const fullPath = path.join(dir, entry.name);
+      if (entry.isDirectory()) {
+        walkDir(fullPath);
+      } else if (/\.(ts|tsx|js|jsx)$/.test(entry.name)) {
+        const mtime = fs.statSync(fullPath).mtime.getTime();
+        if (mtime > newestSrcMtime) {
+          newestSrcMtime = mtime;
+        }
+      }
+    }
+  }
+  walkDir(srcDir);
+  return {
+    stale: newestSrcMtime > distMtime,
+    distMtime,
+    srcMtime: newestSrcMtime
+  };
+}
+async function tryBuildPackage(packageDir, packageName, timeout) {
+  try {
+    await execAsync("pnpm run build", {
+      cwd: packageDir,
+      timeout,
+      encoding: "utf-8"
+    });
+    return { success: true };
+  } catch (err) {
+    return {
+      success: false,
+      error: err.stderr?.trim() || err.message,
+      exitCode: err.code || 1
+    };
+  }
+}
+async function checkBuilds(rootDir, options = {}) {
+  const startTime = Date.now();
+  const timeout = options.timeout || 3e4;
+  const packagePaths = findPackagesWithBuildScript(rootDir, options.packageFilter);
+  const result = {
+    totalPackages: packagePaths.length,
+    passing: 0,
+    failing: 0,
+    failures: [],
+    staleBuilds: [],
+    duration: 0
+  };
+  for (const pkgPath of packagePaths) {
+    const pkgJson = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+    const packageName = pkgJson.name;
+    const packageDir = path.dirname(pkgPath);
+    const staleCheck = isDistStale(packageDir);
+    if (staleCheck.stale) {
+      result.staleBuilds.push({
+        package: packageName,
+        distMtime: staleCheck.distMtime,
+        srcMtime: staleCheck.srcMtime
+      });
+    }
+    const buildResult = await tryBuildPackage(packageDir, packageName, timeout);
+    if (buildResult.success) {
+      result.passing++;
+    } else {
+      result.failing++;
+      result.failures.push({
+        package: packageName,
+        error: buildResult.error,
+        exitCode: buildResult.exitCode
+      });
+    }
+  }
+  result.duration = Date.now() - startTime;
+  return result;
+}
+
+export { checkBuilds };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/builds/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/builds/check-builds.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Check build status across monorepo packages\n *\n * Pure computation - no CLI, no dependencies on devkit\n */\n\nimport { exec } from 'node:child_process';\nimport { promisify } from 'node:util';\nimport fs from 'node:fs';\nimport path from 'node:path';\n\nconst execAsync = promisify(exec);\n\nexport interface BuildCheckResult {\n  totalPackages: number;\n  passing: number;\n  failing: number;\n  failures: Array<{\n    package: string;\n    error: string;\n    exitCode: number;\n  }>;\n  staleBuilds: Array<{\n    package: string;\n    distMtime: number;\n    srcMtime: number;\n  }>;\n  duration: number;\n}\n\nexport interface BuildCheckOptions {\n  packageFilter?: string;\n  includeDevDeps?: boolean;\n  timeout?: number; // per-package timeout in ms\n}\n\n/**\n * Find all packages with build scripts\n */\nfunction findPackagesWithBuildScript(rootDir: string, filter?: string): string[] {\n  const packages: string[] = [];\n\n  if (!fs.existsSync(rootDir)) {\n    return packages;\n  }\n\n  const entries = fs.readdirSync(rootDir, { withFileTypes: true });\n\n  for (const entry of entries) {\n    if (!entry.isDirectory() || !entry.name.startsWith('kb-labs-')) {continue;}\n\n    const repoPath = path.join(rootDir, entry.name);\n    const packagesDir = path.join(repoPath, 'packages');\n\n    if (!fs.existsSync(packagesDir)) {continue;}\n\n    const packageDirs = fs.readdirSync(packagesDir, { withFileTypes: true });\n\n    for (const pkgDir of packageDirs) {\n      if (!pkgDir.isDirectory()) {continue;}\n\n      const packageJsonPath = path.join(packagesDir, pkgDir.name, 'package.json');\n\n      if (fs.existsSync(packageJsonPath)) {\n        const pkgJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));\n\n        // Skip if no build script\n        if (!pkgJson.scripts?.build) {continue;}\n\n        // Skip if filter doesn't match\n        if (filter && !pkgJson.name.includes(filter) && !pkgDir.name.includes(filter)) {\n          continue;\n        }\n\n        packages.push(packageJsonPath);\n      }\n    }\n  }\n\n  return packages;\n}\n\n/**\n * Check if dist/ is stale (older than src/)\n */\nfunction isDistStale(packageDir: string): {\n  stale: boolean;\n  distMtime?: number;\n  srcMtime?: number;\n} {\n  const distFile = path.join(packageDir, 'dist/index.js');\n  const srcDir = path.join(packageDir, 'src');\n\n  if (!fs.existsSync(distFile)) {\n    return { stale: false };\n  }\n\n  if (!fs.existsSync(srcDir)) {\n    return { stale: false };\n  }\n\n  const distMtime = fs.statSync(distFile).mtime.getTime();\n\n  // Find newest file in src/\n  let newestSrcMtime = 0;\n\n  function walkDir(dir: string) {\n    const entries = fs.readdirSync(dir, { withFileTypes: true });\n    for (const entry of entries) {\n      const fullPath = path.join(dir, entry.name);\n      if (entry.isDirectory()) {\n        walkDir(fullPath);\n      } else if (/\\.(ts|tsx|js|jsx)$/.test(entry.name)) {\n        const mtime = fs.statSync(fullPath).mtime.getTime();\n        if (mtime > newestSrcMtime) {\n          newestSrcMtime = mtime;\n        }\n      }\n    }\n  }\n\n  walkDir(srcDir);\n\n  return {\n    stale: newestSrcMtime > distMtime,\n    distMtime,\n    srcMtime: newestSrcMtime,\n  };\n}\n\n/**\n * Try to build a single package\n */\nasync function tryBuildPackage(\n  packageDir: string,\n  packageName: string,\n  timeout: number\n): Promise<{ success: boolean; error?: string; exitCode?: number }> {\n  try {\n    await execAsync('pnpm run build', {\n      cwd: packageDir,\n      timeout,\n      encoding: 'utf-8',\n    });\n\n    return { success: true };\n  } catch (err: any) {\n    return {\n      success: false,\n      error: err.stderr?.trim() || err.message,\n      exitCode: err.code || 1,\n    };\n  }\n}\n\n/**\n * Check builds across monorepo\n *\n * @returns Build check results with failures and stale builds\n */\nexport async function checkBuilds(\n  rootDir: string,\n  options: BuildCheckOptions = {}\n): Promise<BuildCheckResult> {\n  const startTime = Date.now();\n  const timeout = options.timeout || 30000; // 30s default\n\n  const packagePaths = findPackagesWithBuildScript(rootDir, options.packageFilter);\n\n  const result: BuildCheckResult = {\n    totalPackages: packagePaths.length,\n    passing: 0,\n    failing: 0,\n    failures: [],\n    staleBuilds: [],\n    duration: 0,\n  };\n\n  // Check builds sequentially (parallel would be too heavy)\n  for (const pkgPath of packagePaths) {\n    const pkgJson = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));\n    const packageName = pkgJson.name;\n    const packageDir = path.dirname(pkgPath);\n\n    // Check if dist is stale\n    const staleCheck = isDistStale(packageDir);\n    if (staleCheck.stale) {\n      result.staleBuilds.push({\n        package: packageName,\n        distMtime: staleCheck.distMtime!,\n        srcMtime: staleCheck.srcMtime!,\n      });\n    }\n\n    // Try to build\n    const buildResult = await tryBuildPackage(packageDir, packageName, timeout);\n\n    if (buildResult.success) {\n      result.passing++;\n    } else {\n      result.failing++;\n      result.failures.push({\n        package: packageName,\n        error: buildResult.error!,\n        exitCode: buildResult.exitCode!,\n      });\n    }\n  }\n\n  result.duration = Date.now() - startTime;\n\n  return result;\n}\n"]}

package/dist/dead-code/index.d.ts

@@ -0,0 +1,121 @@
+import { DeadCodeOptions, DeadCodeResult, DeadCodeRemovalResult, DeadCodeBackupManifest } from '@kb-labs/quality-contracts';
+
+/**
+ * Dead code file scanner — main orchestrator
+ *
+ * Per-package analysis: collect entry points, build import graph,
+ * BFS reachability, report unreachable files.
+ */
+
+/**
+ * Scan the monorepo for dead (unreachable) source files.
+ *
+ * For each package:
+ * 1. Collect entry points (package.json, tsup, manifest, tests, configs)
+ * 2. Build file-level import graph
+ * 3. BFS from entry points to find reachable files
+ * 4. Everything not reachable = dead
+ */
+declare function scanDeadFiles(rootDir: string, options?: DeadCodeOptions): Promise<DeadCodeResult>;
+
+/**
+ * Entry point collection for dead code detection
+ *
+ * Collects all files that are "alive by definition" — entry points from
+ * package.json, tsup.config.ts, manifest.ts, tests, and configs.
+ *
+ * Fail-open: if we can't parse a config, we emit a warning and treat
+ * ALL files in the package as alive (zero false positives).
+ */
+interface EntryPointResult {
+    /** Absolute paths of entry point files (roots for BFS) */
+    entryFiles: Set<string>;
+    /** Files alive by convention (tests, configs) — not part of graph traversal */
+    aliveByConvention: Set<string>;
+    /** Non-fatal issues during parsing */
+    warnings: string[];
+    /** If true, couldn't parse configs — all files should be treated as alive */
+    failOpen: boolean;
+}
+/**
+ * Collect all entry points for a package.
+ *
+ * A file is an entry point if it's referenced by package.json, tsup.config.ts,
+ * or manifest.ts. Tests and config files are always alive by convention.
+ */
+declare function collectEntryPoints(packageDir: string, packageJson: Record<string, unknown>): Promise<EntryPointResult>;
+/**
+ * Map a dist/ path to its src/ counterpart.
+ * dist/index.js → src/index.ts
+ * dist/sandbox/bootstrap.js → src/sandbox/bootstrap.ts
+ */
+declare function distPathToSrcPath(distPath: string, packageDir: string): string | null;
+/**
+ * Parse entry points from tsup config file content.
+ * Handles: string, array of strings, object of strings.
+ */
+declare function parseTsupEntries(content: string): string[];
+/**
+ * Extract handler paths from manifest.ts content.
+ * Matches: handler: './path/to/file.js#export' and handlerPath: './path/to/file.js'
+ */
+declare function parseManifestHandlers(content: string): string[];
+
+/**
+ * File-level import graph and BFS reachability analysis
+ *
+ * Builds a directed graph of file → imported files, then walks from
+ * entry points to find all reachable (alive) files.
+ */
+/**
+ * Extract all import paths from a source file's content.
+ * Returns raw import specifiers (both relative and package).
+ */
+declare function extractFileImports(content: string): string[];
+/**
+ * Resolve a relative import to an absolute file path.
+ *
+ * Handles ESM convention where source code imports './foo.js'
+ * but the actual file is './foo.ts'.
+ */
+declare function resolveRelativeImport(specifier: string, sourceFile: string): string | null;
+/**
+ * Build a file-level import graph for all source files.
+ *
+ * Returns a map: absolute file path → set of absolute imported file paths.
+ * Only includes relative imports (not external packages).
+ */
+declare function buildFileImportGraph(sourceFiles: string[]): Map<string, Set<string>>;
+/**
+ * BFS from entry points through the import graph.
+ * Returns the set of all reachable file paths.
+ */
+declare function findReachableFiles(entryPoints: Set<string>, importGraph: Map<string, Set<string>>): Set<string>;
+
+/**
+ * Backup, restore, and auto-removal for dead code files
+ *
+ * Creates timestamped backups before deletion, supports full restore,
+ * and cleans up empty directories + package.json exports.
+ */
+
+/**
+ * Remove dead files with full backup.
+ * Creates a timestamped backup directory, copies files, then deletes.
+ */
+declare function removeDeadFiles(rootDir: string, scanResult: DeadCodeResult, options?: {
+    dryRun?: boolean;
+}): Promise<DeadCodeRemovalResult>;
+/**
+ * Restore files from a backup.
+ */
+declare function restoreFromBackup(rootDir: string, backupId: string): Promise<{
+    restoredFiles: number;
+    restoredExports: number;
+}>;
+/**
+ * List all available backups.
+ */
+declare function listBackups(rootDir: string): DeadCodeBackupManifest[];
+
+export { buildFileImportGraph, collectEntryPoints, distPathToSrcPath, extractFileImports, findReachableFiles, listBackups, parseManifestHandlers, parseTsupEntries, removeDeadFiles, resolveRelativeImport, restoreFromBackup, scanDeadFiles };