@kb-labs/quality-entry 2.14.0

package/dist/cli/commands/health.js

@@ -0,0 +1,210 @@
+import { defineCommand } from '@kb-labs/sdk';
+import { CACHE_KEYS } from '@kb-labs/quality-contracts';
+import fs from 'fs';
+import path from 'path';
+
+// src/cli/commands/health.ts
+var health_default = defineCommand({
+  id: "quality:health",
+  description: "Check monorepo health score",
+  handler: {
+    async execute(ctx, input) {
+      const { ui, platform } = ctx;
+      const flags = input.flags ?? input;
+      const health = await calculateHealth(ctx.cwd, flags.package);
+      await platform.cache.set(CACHE_KEYS.HEALTH, health, 5 * 60 * 1e3);
+      await platform.analytics.track("quality:health", {
+        score: health.score,
+        grade: health.grade,
+        issueCount: health.issues.length,
+        packageSpecific: !!flags.package
+      });
+      outputHealth(health, flags, ui);
+      return {
+        exitCode: health.score < 60 ? 1 : 0,
+        result: health
+      };
+    }
+  }
+});
+function findPackages(rootDir, specificPackage) {
+  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)) {
+        if (specificPackage) {
+          const pkgJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf-8"));
+          if (pkgJson.name === specificPackage || pkgDir.name === specificPackage) {
+            packages.push(packageJsonPath);
+          }
+        } else {
+          packages.push(packageJsonPath);
+        }
+      }
+    }
+  }
+  return packages;
+}
+async function calculateHealth(rootDir, specificPackage) {
+  const packages = findPackages(rootDir, specificPackage);
+  let score = 100;
+  const issues = [];
+  const allDeps = /* @__PURE__ */ new Map();
+  for (const packagePath of packages) {
+    const packageJson = JSON.parse(fs.readFileSync(packagePath, "utf-8"));
+    const deps = {
+      ...packageJson.dependencies,
+      ...packageJson.devDependencies
+    };
+    for (const [dep, version] of Object.entries(deps)) {
+      if (!allDeps.has(dep)) {
+        allDeps.set(dep, /* @__PURE__ */ new Set());
+      }
+      allDeps.get(dep).add(version);
+    }
+  }
+  const duplicates = Array.from(allDeps.entries()).filter(([_, versions]) => versions.size > 1).filter(([dep]) => !dep.startsWith("@kb-labs/"));
+  if (duplicates.length > 0) {
+    const penalty = Math.min(20, duplicates.length * 2);
+    score -= penalty;
+    issues.push({
+      type: "duplicates",
+      severity: "warning",
+      message: `${duplicates.length} duplicate dependencies (-${penalty})`
+    });
+  }
+  let missingReadmes = 0;
+  for (const packagePath of packages) {
+    const packageDir = path.dirname(packagePath);
+    const readmePath = path.join(packageDir, "README.md");
+    if (!fs.existsSync(readmePath)) {
+      missingReadmes++;
+    }
+  }
+  if (missingReadmes > 0) {
+    const penalty = Math.min(15, missingReadmes);
+    score -= penalty;
+    issues.push({
+      type: "missing-docs",
+      severity: "warning",
+      message: `${missingReadmes} packages missing README (-${penalty})`
+    });
+  }
+  let namingIssues = 0;
+  for (const packagePath of packages) {
+    const packageJson = JSON.parse(fs.readFileSync(packagePath, "utf-8"));
+    const packageName = packageJson.name;
+    if (!packageName || !packageName.startsWith("@kb-labs/")) {
+      namingIssues++;
+    }
+  }
+  if (namingIssues > 0) {
+    const penalty = Math.min(10, namingIssues * 2);
+    score -= penalty;
+    issues.push({
+      type: "naming",
+      severity: "critical",
+      message: `${namingIssues} packages with naming issues (-${penalty})`
+    });
+  }
+  let missingTypes = 0;
+  for (const packagePath of packages) {
+    const packageJson = JSON.parse(fs.readFileSync(packagePath, "utf-8"));
+    if (!packageJson.types && !packageJson.typings) {
+      missingTypes++;
+    }
+  }
+  if (missingTypes > 0) {
+    const penalty = Math.min(15, missingTypes);
+    score -= penalty;
+    issues.push({
+      type: "missing-types",
+      severity: "warning",
+      message: `${missingTypes} packages missing types field (-${penalty})`
+    });
+  }
+  let grade;
+  if (score >= 90) {
+    grade = "A";
+  } else if (score >= 80) {
+    grade = "B";
+  } else if (score >= 70) {
+    grade = "C";
+  } else if (score >= 60) {
+    grade = "D";
+  } else {
+    grade = "F";
+  }
+  return {
+    score: Math.max(0, score),
+    grade,
+    issues
+  };
+}
+function outputHealth(health, flags, ui) {
+  if (flags.json) {
+    ui?.json?.(health);
+    return;
+  }
+  const sections = [];
+  const scoreItems = [
+    `Score: ${health.score}/100`,
+    `Grade: ${health.grade}`,
+    `Status: ${health.score >= 80 ? "\u2705 Healthy" : health.score >= 60 ? "\u26A0\uFE0F Needs Attention" : "\u274C Critical"}`
+  ];
+  sections.push({ header: "Health Score", items: scoreItems });
+  if (health.issues.length > 0) {
+    const issueItems = health.issues.map((issue) => {
+      const icon = issue.severity === "critical" ? "\u274C" : issue.severity === "warning" ? "\u26A0\uFE0F" : "\u2139\uFE0F";
+      return `${icon} ${issue.message}`;
+    });
+    if (flags.detailed) {
+      sections.push({ header: "Issues (Detailed)", items: issueItems });
+    } else {
+      sections.push({ header: "Issues", items: issueItems });
+    }
+  } else {
+    sections.push({ header: "Issues", items: ["\u2705 No issues found!"] });
+  }
+  if (health.score < 90) {
+    const recommendations = [];
+    if (health.issues.some((i) => i.type === "duplicates")) {
+      recommendations.push("Run `kb quality:fix-deps --align-versions` to fix duplicates");
+    }
+    if (health.issues.some((i) => i.type === "missing-docs")) {
+      recommendations.push("Add README.md files to packages");
+    }
+    if (health.issues.some((i) => i.type === "missing-types")) {
+      recommendations.push('Add "types" field to package.json or enable dts generation');
+    }
+    if (recommendations.length > 0) {
+      sections.push({ header: "Recommendations", items: recommendations });
+    }
+  }
+  const title = health.score >= 80 ? "\u{1F49A} Monorepo Health Check - Healthy" : health.score >= 60 ? "\u{1F49B} Monorepo Health Check - Needs Attention" : "\u2764\uFE0F Monorepo Health Check - Critical";
+  ui?.success?.("Health check completed", {
+    title,
+    sections
+  });
+}
+
+export { health_default as default };
+//# sourceMappingURL=health.js.map
+//# sourceMappingURL=health.js.map

package/dist/cli/commands/health.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/cli/commands/health.ts"],"names":[],"mappings":";;;;;;AA0BA,IAAO,iBAAQ,aAAA,CAAc;AAAA,EAC3B,EAAA,EAAI,gBAAA;AAAA,EACJ,WAAA,EAAa,6BAAA;AAAA,EAEb,OAAA,EAAS;AAAA,IACP,MAAM,OAAA,CAAQ,GAAA,EAAsB,KAAA,EAAkD;AACpF,MAAA,MAAM,EAAE,EAAA,EAAI,QAAA,EAAS,GAAI,GAAA;AAGzB,MAAA,MAAM,KAAA,GAAS,MAAc,KAAA,IAAS,KAAA;AAGtC,MAAA,MAAM,SAAS,MAAM,eAAA,CAAgB,GAAA,CAAI,GAAA,EAAK,MAAM,OAAO,CAAA;AAG3D,MAAA,MAAM,QAAA,CAAS,MAAM,GAAA,CAAI,UAAA,CAAW,QAAQ,MAAA,EAAQ,CAAA,GAAI,KAAK,GAAI,CAAA;AAGjE,MAAA,MAAM,QAAA,CAAS,SAAA,CAAU,KAAA,CAAM,gBAAA,EAAkB;AAAA,QAC/C,OAAO,MAAA,CAAO,KAAA;AAAA,QACd,OAAO,MAAA,CAAO,KAAA;AAAA,QACd,UAAA,EAAY,OAAO,MAAA,CAAO,MAAA;AAAA,QAC1B,eAAA,EAAiB,CAAC,CAAC,KAAA,CAAM;AAAA,OAC1B,CAAA;AAGD,MAAA,YAAA,CAAa,MAAA,EAAQ,OAAO,EAAE,CAAA;AAE9B,MAAA,OAAO;AAAA,QACL,QAAA,EAAU,MAAA,CAAO,KAAA,GAAQ,EAAA,GAAK,CAAA,GAAI,CAAA;AAAA,QAClC,MAAA,EAAQ;AAAA,OACV;AAAA,IACF;AAAA;AAEJ,CAAC;AAKD,SAAS,YAAA,CAAa,SAAiB,eAAA,EAAoC;AACzE,EAAA,MAAM,WAAqB,EAAC;AAE5B,EAAA,IAAI,CAAC,EAAA,CAAG,UAAA,CAAW,OAAO,CAAA,EAAG;AAC3B,IAAA,OAAO,QAAA;AAAA,EACT;AAEA,EAAA,MAAM,UAAU,EAAA,CAAG,WAAA,CAAY,SAAS,EAAE,aAAA,EAAe,MAAM,CAAA;AAE/D,EAAA,KAAA,MAAW,SAAS,OAAA,EAAS;AAC3B,IAAA,IAAI,CAAC,MAAM,WAAA,EAAY,IAAK,CAAC,KAAA,CAAM,IAAA,CAAK,UAAA,CAAW,UAAU,CAAA,EAAG;AAAC,MAAA;AAAA,IAAS;AAE1E,IAAA,MAAM,QAAA,GAAW,IAAA,CAAK,IAAA,CAAK,OAAA,EAAS,MAAM,IAAI,CAAA;AAC9C,IAAA,MAAM,WAAA,GAAc,IAAA,CAAK,IAAA,CAAK,QAAA,EAAU,UAAU,CAAA;AAElD,IAAA,IAAI,CAAC,EAAA,CAAG,UAAA,CAAW,WAAW,CAAA,EAAG;AAAC,MAAA;AAAA,IAAS;AAE3C,IAAA,MAAM,cAAc,EAAA,CAAG,WAAA,CAAY,aAAa,EAAE,aAAA,EAAe,MAAM,CAAA;AAEvE,IAAA,KAAA,MAAW,UAAU,WAAA,EAAa;AAChC,MAAA,IAAI,CAAC,MAAA,CAAO,WAAA,EAAY,EAAG;AAAC,QAAA;AAAA,MAAS;AAErC,MAAA,MAAM,kBAAkB,IAAA,CAAK,IAAA,CAAK,WAAA,EAAa,MAAA,CAAO,MAAM,cAAc,CAAA;AAE1E,MAAA,IAAI,EAAA,CAAG,UAAA,CAAW,eAAe,CAAA,EAAG;AAElC,QAAA,IAAI,eAAA,EAAiB;AACnB,UAAA,MAAM,UAAU,IAAA,CAAK,KAAA,CAAM,GAAG,YAAA,CAAa,eAAA,EAAiB,OAAO,CAAC,CAAA;AACpE,UAAA,IAAI,OAAA,CAAQ,IAAA,KAAS,eAAA,IAAmB,MAAA,CAAO,SAAS,eAAA,EAAiB;AACvE,YAAA,QAAA,CAAS,KAAK,eAAe,CAAA;AAAA,UAC/B;AAAA,QACF,CAAA,MAAO;AACL,UAAA,QAAA,CAAS,KAAK,eAAe,CAAA;AAAA,QAC/B;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,EAAA,OAAO,QAAA;AACT;AAKA,eAAe,eAAA,CAAgB,SAAiB,eAAA,EAAgD;AAC9F,EAAA,MAAM,QAAA,GAAW,YAAA,CAAa,OAAA,EAAS,eAAe,CAAA;AACtD,EAAA,IAAI,KAAA,GAAQ,GAAA;AACZ,EAAA,MAAM,SAAkB,EAAC;AAGzB,EAAA,MAAM,OAAA,uBAAc,GAAA,EAAyB;AAE7C,EAAA,KAAA,MAAW,eAAe,QAAA,EAAU;AAClC,IAAA,MAAM,cAAc,IAAA,CAAK,KAAA,CAAM,GAAG,YAAA,CAAa,WAAA,EAAa,OAAO,CAAC,CAAA;AACpE,IAAA,MAAM,IAAA,GAAO;AAAA,MACX,GAAG,WAAA,CAAY,YAAA;AAAA,MACf,GAAG,WAAA,CAAY;AAAA,KACjB;AAEA,IAAA,KAAA,MAAW,CAAC,GAAA,EAAK,OAAO,KAAK,MAAA,CAAO,OAAA,CAAQ,IAAI,CAAA,EAAG;AACjD,MAAA,IAAI,CAAC,OAAA,CAAQ,GAAA,CAAI,GAAG,CAAA,EAAG;AACrB,QAAA,OAAA,CAAQ,GAAA,CAAI,GAAA,kBAAK,IAAI,GAAA,EAAK,CAAA;AAAA,MAC5B;AACA,MAAA,OAAA,CAAQ,GAAA,CAAI,GAAG,CAAA,CAAG,GAAA,CAAI,OAAiB,CAAA;AAAA,IACzC;AAAA,EACF;AAEA,EAAA,MAAM,UAAA,GAAa,KAAA,CAAM,IAAA,CAAK,OAAA,CAAQ,OAAA,EAAS,CAAA,CAC5C,MAAA,CAAO,CAAC,CAAC,CAAA,EAAG,QAAQ,CAAA,KAAM,SAAS,IAAA,GAAO,CAAC,CAAA,CAC3C,MAAA,CAAO,CAAC,CAAC,GAAG,CAAA,KAAM,CAAC,GAAA,CAAI,UAAA,CAAW,WAAW,CAAC,CAAA;AAEjD,EAAA,IAAI,UAAA,CAAW,SAAS,CAAA,EAAG;AACzB,IAAA,MAAM,UAAU,IAAA,CAAK,GAAA,CAAI,EAAA,EAAI,UAAA,CAAW,SAAS,CAAC,CAAA;AAClD,IAAA,KAAA,IAAS,OAAA;AACT,IAAA,MAAA,CAAO,IAAA,CAAK;AAAA,MACV,IAAA,EAAM,YAAA;AAAA,MACN,QAAA,EAAU,SAAA;AAAA,MACV,OAAA,EAAS,CAAA,EAAG,UAAA,CAAW,MAAM,6BAA6B,OAAO,CAAA,CAAA;AAAA,KAClE,CAAA;AAAA,EACH;AAGA,EAAA,IAAI,cAAA,GAAiB,CAAA;AACrB,EAAA,KAAA,MAAW,eAAe,QAAA,EAAU;AAClC,IAAA,MAAM,UAAA,GAAa,IAAA,CAAK,OAAA,CAAQ,WAAW,CAAA;AAC3C,IAAA,MAAM,UAAA,GAAa,IAAA,CAAK,IAAA,CAAK,UAAA,EAAY,WAAW,CAAA;AACpD,IAAA,IAAI,CAAC,EAAA,CAAG,UAAA,CAAW,UAAU,CAAA,EAAG;AAC9B,MAAA,cAAA,EAAA;AAAA,IACF;AAAA,EACF;AAEA,EAAA,IAAI,iBAAiB,CAAA,EAAG;AACtB,IAAA,MAAM,OAAA,GAAU,IAAA,CAAK,GAAA,CAAI,EAAA,EAAI,cAAc,CAAA;AAC3C,IAAA,KAAA,IAAS,OAAA;AACT,IAAA,MAAA,CAAO,IAAA,CAAK;AAAA,MACV,IAAA,EAAM,cAAA;AAAA,MACN,QAAA,EAAU,SAAA;AAAA,MACV,OAAA,EAAS,CAAA,EAAG,cAAc,CAAA,2BAAA,EAA8B,OAAO,CAAA,CAAA;AAAA,KAChE,CAAA;AAAA,EACH;AAGA,EAAA,IAAI,YAAA,GAAe,CAAA;AACnB,EAAA,KAAA,MAAW,eAAe,QAAA,EAAU;AAClC,IAAA,MAAM,cAAc,IAAA,CAAK,KAAA,CAAM,GAAG,YAAA,CAAa,WAAA,EAAa,OAAO,CAAC,CAAA;AACpE,IAAA,MAAM,cAAc,WAAA,CAAY,IAAA;AAEhC,IAAA,IAAI,CAAC,WAAA,IAAe,CAAC,WAAA,CAAY,UAAA,CAAW,WAAW,CAAA,EAAG;AACxD,MAAA,YAAA,EAAA;AAAA,IACF;AAAA,EACF;AAEA,EAAA,IAAI,eAAe,CAAA,EAAG;AACpB,IAAA,MAAM,OAAA,GAAU,IAAA,CAAK,GAAA,CAAI,EAAA,EAAI,eAAe,CAAC,CAAA;AAC7C,IAAA,KAAA,IAAS,OAAA;AACT,IAAA,MAAA,CAAO,IAAA,CAAK;AAAA,MACV,IAAA,EAAM,QAAA;AAAA,MACN,QAAA,EAAU,UAAA;AAAA,MACV,OAAA,EAAS,CAAA,EAAG,YAAY,CAAA,+BAAA,EAAkC,OAAO,CAAA,CAAA;AAAA,KAClE,CAAA;AAAA,EACH;AAGA,EAAA,IAAI,YAAA,GAAe,CAAA;AACnB,EAAA,KAAA,MAAW,eAAe,QAAA,EAAU;AAClC,IAAA,MAAM,cAAc,IAAA,CAAK,KAAA,CAAM,GAAG,YAAA,CAAa,WAAA,EAAa,OAAO,CAAC,CAAA;AAEpE,IAAA,IAAI,CAAC,WAAA,CAAY,KAAA,IAAS,CAAC,YAAY,OAAA,EAAS;AAC9C,MAAA,YAAA,EAAA;AAAA,IACF;AAAA,EACF;AAEA,EAAA,IAAI,eAAe,CAAA,EAAG;AACpB,IAAA,MAAM,OAAA,GAAU,IAAA,CAAK,GAAA,CAAI,EAAA,EAAI,YAAY,CAAA;AACzC,IAAA,KAAA,IAAS,OAAA;AACT,IAAA,MAAA,CAAO,IAAA,CAAK;AAAA,MACV,IAAA,EAAM,eAAA;AAAA,MACN,QAAA,EAAU,SAAA;AAAA,MACV,OAAA,EAAS,CAAA,EAAG,YAAY,CAAA,gCAAA,EAAmC,OAAO,CAAA,CAAA;AAAA,KACnE,CAAA;AAAA,EACH;AAGA,EAAA,IAAI,KAAA;AACJ,EAAA,IAAI,SAAS,EAAA,EAAI;AAAC,IAAA,KAAA,GAAQ,GAAA;AAAA,EAAI,CAAA,MAAA,IACrB,SAAS,EAAA,EAAI;AAAC,IAAA,KAAA,GAAQ,GAAA;AAAA,EAAI,CAAA,MAAA,IAC1B,SAAS,EAAA,EAAI;AAAC,IAAA,KAAA,GAAQ,GAAA;AAAA,EAAI,CAAA,MAAA,IAC1B,SAAS,EAAA,EAAI;AAAC,IAAA,KAAA,GAAQ,GAAA;AAAA,EAAI,CAAA,MAC9B;AAAC,IAAA,KAAA,GAAQ,GAAA;AAAA,EAAI;AAElB,EAAA,OAAO;AAAA,IACL,KAAA,EAAO,IAAA,CAAK,GAAA,CAAI,CAAA,EAAG,KAAK,CAAA;AAAA,IACxB,KAAA;AAAA,IACA;AAAA,GACF;AACF;AAKA,SAAS,YAAA,CAAa,MAAA,EAAqB,KAAA,EAAY,EAAA,EAAS;AAC9D,EAAA,IAAI,MAAM,IAAA,EAAM;AACd,IAAA,EAAA,EAAI,OAAO,MAAM,CAAA;AACjB,IAAA;AAAA,EACF;AAGA,EAAA,MAAM,WAAuD,EAAC;AAG9D,EAAA,MAAM,UAAA,GAAa;AAAA,IACjB,CAAA,OAAA,EAAU,OAAO,KAAK,CAAA,IAAA,CAAA;AAAA,IACtB,CAAA,OAAA,EAAU,OAAO,KAAK,CAAA,CAAA;AAAA,IACtB,CAAA,QAAA,EAAW,OAAO,KAAA,IAAS,EAAA,GAAK,mBAAc,MAAA,CAAO,KAAA,IAAS,EAAA,GAAK,8BAAA,GAAuB,iBAAY,CAAA;AAAA,GACxG;AACA,EAAA,QAAA,CAAS,KAAK,EAAE,MAAA,EAAQ,cAAA,EAAgB,KAAA,EAAO,YAAY,CAAA;AAG3D,EAAA,IAAI,MAAA,CAAO,MAAA,CAAO,MAAA,GAAS,CAAA,EAAG;AAC5B,IAAA,MAAM,UAAA,GAAa,MAAA,CAAO,MAAA,CAAO,GAAA,CAAI,CAAA,KAAA,KAAS;AAC5C,MAAA,MAAM,IAAA,GAAO,MAAM,QAAA,KAAa,UAAA,GAAa,WAAM,KAAA,CAAM,QAAA,KAAa,YAAY,cAAA,GAAO,cAAA;AACzF,MAAA,OAAO,CAAA,EAAG,IAAI,CAAA,CAAA,EAAI,KAAA,CAAM,OAAO,CAAA,CAAA;AAAA,IACjC,CAAC,CAAA;AAED,IAAA,IAAI,MAAM,QAAA,EAAU;AAClB,MAAA,QAAA,CAAS,KAAK,EAAE,MAAA,EAAQ,mBAAA,EAAqB,KAAA,EAAO,YAAY,CAAA;AAAA,IAClE,CAAA,MAAO;AACL,MAAA,QAAA,CAAS,KAAK,EAAE,MAAA,EAAQ,QAAA,EAAU,KAAA,EAAO,YAAY,CAAA;AAAA,IACvD;AAAA,EACF,CAAA,MAAO;AACL,IAAA,QAAA,CAAS,IAAA,CAAK,EAAE,MAAA,EAAQ,QAAA,EAAU,OAAO,CAAC,yBAAoB,GAAG,CAAA;AAAA,EACnE;AAGA,EAAA,IAAI,MAAA,CAAO,QAAQ,EAAA,EAAI;AACrB,IAAA,MAAM,kBAA4B,EAAC;AAEnC,IAAA,IAAI,OAAO,MAAA,CAAO,IAAA,CAAK,OAAK,CAAA,CAAE,IAAA,KAAS,YAAY,CAAA,EAAG;AACpD,MAAA,eAAA,CAAgB,KAAK,8DAA8D,CAAA;AAAA,IACrF;AACA,IAAA,IAAI,OAAO,MAAA,CAAO,IAAA,CAAK,OAAK,CAAA,CAAE,IAAA,KAAS,cAAc,CAAA,EAAG;AACtD,MAAA,eAAA,CAAgB,KAAK,iCAAiC,CAAA;AAAA,IACxD;AACA,IAAA,IAAI,OAAO,MAAA,CAAO,IAAA,CAAK,OAAK,CAAA,CAAE,IAAA,KAAS,eAAe,CAAA,EAAG;AACvD,MAAA,eAAA,CAAgB,KAAK,4DAA4D,CAAA;AAAA,IACnF;AAEA,IAAA,IAAI,eAAA,CAAgB,SAAS,CAAA,EAAG;AAC9B,MAAA,QAAA,CAAS,KAAK,EAAE,MAAA,EAAQ,iBAAA,EAAmB,KAAA,EAAO,iBAAiB,CAAA;AAAA,IACrE;AAAA,EACF;AAEA,EAAA,MAAM,KAAA,GAAQ,OAAO,KAAA,IAAS,EAAA,GAC1B,8CACA,MAAA,CAAO,KAAA,IAAS,KAChB,mDAAA,GACA,+CAAA;AAEJ,EAAA,EAAA,EAAI,UAAU,wBAAA,EAA0B;AAAA,IACtC,KAAA;AAAA,IACA;AAAA,GACD,CAAA;AACH","file":"health.js","sourcesContent":["/**\n * quality:health - Monorepo health check\n *\n * Analyzes monorepo health including:\n * - Dependency issues (duplicates, unused, missing)\n * - Structure problems (missing READMEs, inconsistent naming)\n * - Build health (TypeScript errors, missing types)\n * - Overall health score with grade (A-F)\n */\n\nimport { defineCommand, type PluginContextV3 } from '@kb-labs/sdk';\nimport type { HealthScore, Issue } from '@kb-labs/quality-contracts';\nimport { CACHE_KEYS } from '@kb-labs/quality-contracts';\nimport type { HealthFlags } from './flags.js';\nimport fs from 'node:fs';\nimport path from 'node:path';\n\n// Input type with backward compatibility\ntype HealthInput = HealthFlags & { argv?: string[] };\n\ntype HealthCommandResult = {\n  exitCode: number;\n  result?: HealthScore;\n  meta?: Record<string, unknown>;\n};\n\nexport default defineCommand({\n  id: 'quality:health',\n  description: 'Check monorepo health score',\n\n  handler: {\n    async execute(ctx: PluginContextV3, input: HealthInput): Promise<HealthCommandResult> {\n      const { ui, platform } = ctx;\n\n      // V3: Flags come in input.flags object (not auto-merged)\n      const flags = (input as any).flags ?? input;\n\n      // Calculate health score\n      const health = await calculateHealth(ctx.cwd, flags.package);\n\n      // Cache results for 5 minutes\n      await platform.cache.set(CACHE_KEYS.HEALTH, health, 5 * 60 * 1000);\n\n      // Track analytics\n      await platform.analytics.track('quality:health', {\n        score: health.score,\n        grade: health.grade,\n        issueCount: health.issues.length,\n        packageSpecific: !!flags.package,\n      });\n\n      // Output results\n      outputHealth(health, flags, ui);\n\n      return {\n        exitCode: health.score < 60 ? 1 : 0,\n        result: health,\n      };\n    },\n  },\n});\n\n/**\n * Find all packages in the monorepo\n */\nfunction findPackages(rootDir: string, specificPackage?: 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        // If specific package requested, filter\n        if (specificPackage) {\n          const pkgJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));\n          if (pkgJson.name === specificPackage || pkgDir.name === specificPackage) {\n            packages.push(packageJsonPath);\n          }\n        } else {\n          packages.push(packageJsonPath);\n        }\n      }\n    }\n  }\n\n  return packages;\n}\n\n/**\n * Calculate comprehensive health score\n */\nasync function calculateHealth(rootDir: string, specificPackage?: string): Promise<HealthScore> {\n  const packages = findPackages(rootDir, specificPackage);\n  let score = 100;\n  const issues: Issue[] = [];\n\n  // 1. Check for duplicate dependencies\n  const allDeps = new Map<string, Set<string>>();\n\n  for (const packagePath of packages) {\n    const packageJson = JSON.parse(fs.readFileSync(packagePath, 'utf-8'));\n    const deps = {\n      ...packageJson.dependencies,\n      ...packageJson.devDependencies,\n    };\n\n    for (const [dep, version] of Object.entries(deps)) {\n      if (!allDeps.has(dep)) {\n        allDeps.set(dep, new Set());\n      }\n      allDeps.get(dep)!.add(version as string);\n    }\n  }\n\n  const duplicates = Array.from(allDeps.entries())\n    .filter(([_, versions]) => versions.size > 1)\n    .filter(([dep]) => !dep.startsWith('@kb-labs/')); // Ignore workspace deps\n\n  if (duplicates.length > 0) {\n    const penalty = Math.min(20, duplicates.length * 2);\n    score -= penalty;\n    issues.push({\n      type: 'duplicates',\n      severity: 'warning',\n      message: `${duplicates.length} duplicate dependencies (-${penalty})`,\n    });\n  }\n\n  // 2. Check for missing READMEs\n  let missingReadmes = 0;\n  for (const packagePath of packages) {\n    const packageDir = path.dirname(packagePath);\n    const readmePath = path.join(packageDir, 'README.md');\n    if (!fs.existsSync(readmePath)) {\n      missingReadmes++;\n    }\n  }\n\n  if (missingReadmes > 0) {\n    const penalty = Math.min(15, missingReadmes);\n    score -= penalty;\n    issues.push({\n      type: 'missing-docs',\n      severity: 'warning',\n      message: `${missingReadmes} packages missing README (-${penalty})`,\n    });\n  }\n\n  // 3. Check for inconsistent naming\n  let namingIssues = 0;\n  for (const packagePath of packages) {\n    const packageJson = JSON.parse(fs.readFileSync(packagePath, 'utf-8'));\n    const packageName = packageJson.name;\n\n    if (!packageName || !packageName.startsWith('@kb-labs/')) {\n      namingIssues++;\n    }\n  }\n\n  if (namingIssues > 0) {\n    const penalty = Math.min(10, namingIssues * 2);\n    score -= penalty;\n    issues.push({\n      type: 'naming',\n      severity: 'critical',\n      message: `${namingIssues} packages with naming issues (-${penalty})`,\n    });\n  }\n\n  // 4. Check for missing type definitions\n  let missingTypes = 0;\n  for (const packagePath of packages) {\n    const packageJson = JSON.parse(fs.readFileSync(packagePath, 'utf-8'));\n\n    if (!packageJson.types && !packageJson.typings) {\n      missingTypes++;\n    }\n  }\n\n  if (missingTypes > 0) {\n    const penalty = Math.min(15, missingTypes);\n    score -= penalty;\n    issues.push({\n      type: 'missing-types',\n      severity: 'warning',\n      message: `${missingTypes} packages missing types field (-${penalty})`,\n    });\n  }\n\n  // Determine grade\n  let grade: 'A' | 'B' | 'C' | 'D' | 'F';\n  if (score >= 90) {grade = 'A';}\n  else if (score >= 80) {grade = 'B';}\n  else if (score >= 70) {grade = 'C';}\n  else if (score >= 60) {grade = 'D';}\n  else {grade = 'F';}\n\n  return {\n    score: Math.max(0, score),\n    grade,\n    issues,\n  };\n}\n\n/**\n * Output health check results\n */\nfunction outputHealth(health: HealthScore, flags: any, ui: any) {\n  if (flags.json) {\n    ui?.json?.(health);\n    return;\n  }\n\n  // Build sections\n  const sections: Array<{ header: string; items: string[] }> = [];\n\n  // Score section\n  const scoreItems = [\n    `Score: ${health.score}/100`,\n    `Grade: ${health.grade}`,\n    `Status: ${health.score >= 80 ? '✅ Healthy' : health.score >= 60 ? '⚠️ Needs Attention' : '❌ Critical'}`,\n  ];\n  sections.push({ header: 'Health Score', items: scoreItems });\n\n  // Issues section\n  if (health.issues.length > 0) {\n    const issueItems = health.issues.map(issue => {\n      const icon = issue.severity === 'critical' ? '❌' : issue.severity === 'warning' ? '⚠️' : 'ℹ️';\n      return `${icon} ${issue.message}`;\n    });\n\n    if (flags.detailed) {\n      sections.push({ header: 'Issues (Detailed)', items: issueItems });\n    } else {\n      sections.push({ header: 'Issues', items: issueItems });\n    }\n  } else {\n    sections.push({ header: 'Issues', items: ['✅ No issues found!'] });\n  }\n\n  // Recommendations\n  if (health.score < 90) {\n    const recommendations: string[] = [];\n\n    if (health.issues.some(i => i.type === 'duplicates')) {\n      recommendations.push('Run `kb quality:fix-deps --align-versions` to fix duplicates');\n    }\n    if (health.issues.some(i => i.type === 'missing-docs')) {\n      recommendations.push('Add README.md files to packages');\n    }\n    if (health.issues.some(i => i.type === 'missing-types')) {\n      recommendations.push('Add \"types\" field to package.json or enable dts generation');\n    }\n\n    if (recommendations.length > 0) {\n      sections.push({ header: 'Recommendations', items: recommendations });\n    }\n  }\n\n  const title = health.score >= 80\n    ? '💚 Monorepo Health Check - Healthy'\n    : health.score >= 60\n    ? '💛 Monorepo Health Check - Needs Attention'\n    : '❤️ Monorepo Health Check - Critical';\n\n  ui?.success?.('Health check completed', {\n    title,\n    sections,\n  });\n}\n"]}

package/dist/cli/commands/index.d.ts

@@ -0,0 +1,14 @@
+export { default as buildOrder } from './build-order.js';
+export { default as checkBuilds } from './check-builds.js';
+export { default as checkTests } from './check-tests.js';
+export { default as checkTypes } from './check-types.js';
+export { default as cycles } from './cycles.js';
+export { default as deadCode } from './dead-code.js';
+export { default as fixDeps } from './fix-deps.js';
+export { default as health } from './health.js';
+export { default as stats } from './stats.js';
+export { default as visualize } from './visualize.js';
+import '@kb-labs/shared-command-kit';
+import '@kb-labs/quality-core/graph';
+import '@kb-labs/quality-contracts';
+import './flags.js';