@kb-labs/quality-entry 2.94.0 → 2.96.0

package/dist/cli/commands/build-order.d.ts

@@ -1,16 +1,9 @@
 import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
-import { TopologicalSortResult } from '@kb-labs/quality-core/graph';
+import { CLIInput } from '@kb-labs/sdk';
+import { BuildOrderFlags } from './flags.js';
 
-type BuildOrderFlags = {
-    package?: string;
-    layers?: boolean;
-    script?: boolean;
-    json?: boolean;
-    argv?: string[];
-};
-type BuildOrderInput = BuildOrderFlags & {
-    argv?: string[];
-};
-declare const _default: _kb_labs_shared_command_kit.CommandHandlerV3<unknown, BuildOrderInput, TopologicalSortResult>;
+declare const _default: _kb_labs_shared_command_kit.CommandHandlerV3<unknown, CLIInput<BuildOrderFlags>, {
+    exitCode: number;
+}>;
 
 export { _default as default };

package/dist/cli/commands/build-order.js

@@ -1,5 +1,6 @@
-import { defineCommand } from '@kb-labs/sdk';
-import { buildDependencyGraph, getBuildOrderForPackage, topologicalSort } from '@kb-labs/quality-core/graph';
+import { defineCommand, useConfig } from '@kb-labs/sdk';
+import { analyzeBuildOrder } from '@kb-labs/quality-core';
+import { defaultQualityConfig } from '@kb-labs/quality-contracts';
 
 // src/cli/commands/build-order.ts
 var build_order_default = defineCommand({
@@ -7,106 +8,53 @@ var build_order_default = defineCommand({
   description: "Calculate build order using topological sort",
   handler: {
     async execute(ctx, input) {
-      const { ui } = ctx;
-      const flags = "flags" in input && typeof input.flags === "object" && input.flags !== null ? input.flags : input;
-      const graph = buildDependencyGraph(ctx.cwd);
-      let result;
-      if (flags.package) {
-        result = getBuildOrderForPackage(graph, flags.package);
-      } else {
-        result = topologicalSort(graph);
-      }
-      if (result.circular.length > 0) {
-        ui?.error?.(
-          `Found ${result.circular.length} circular dependencies. Build order cannot be determined.`
-        );
-        outputCircularDependencies(result.circular, ui);
-        return { exitCode: 1, result };
-      }
-      outputBuildOrder(result, flags, ui);
-      return { exitCode: 0, result };
-    }
-  }
-});
-function outputBuildOrder(result, flags, ui) {
-  if (flags.json) {
-    ui?.json?.(result);
-    return;
-  }
-  if (flags.script) {
-    ui?.write?.("#!/bin/bash");
-    ui?.write?.("# Generated build script");
-    ui?.write?.("set -e");
-    ui?.write?.("");
-    for (let i = 0; i < result.layers.length; i++) {
-      const layer = result.layers[i];
-      if (!layer) {
-        continue;
+      const { flags } = input;
+      const config = await useConfig();
+      const cfg = config ?? defaultQualityConfig;
+      const cwd = ctx.cwd ?? process.cwd();
+      const result = analyzeBuildOrder({
+        rootDir: cwd,
+        layerMap: cfg.layers,
+        filterPackage: flags.package
+      });
+      if (result.hasCircular) {
+        if (flags.json) {
+          ctx.ui?.json?.({ ...result, ok: false });
+        } else {
+          ctx.ui?.error?.(`Circular dependencies detected \u2014 build order cannot be fully determined`, {
+            sections: result.circular.map((cycle, i) => ({
+              header: `Cycle ${i + 1}`,
+              items: cycle
+            }))
+          });
+        }
+        return { exitCode: 1 };
       }
-      ui?.write?.(`# Layer ${i + 1} (${layer.length} packages)`);
-      for (const pkg of layer) {
-        ui?.write?.(`pnpm --filter "${pkg}" run build`);
+      if (flags.json) {
+        ctx.ui?.json?.(result);
+        return { exitCode: 0 };
       }
-      ui?.write?.("");
-    }
-    return;
-  }
-  const sections = [];
-  if (flags.layers) {
-    const layerItems = [];
-    for (let i = 0; i < result.layers.length; i++) {
-      const layer = result.layers[i];
-      if (!layer) {
-        continue;
-      }
-      layerItems.push(`Layer ${i + 1}: ${layer.length} packages (can build in parallel)`);
-      for (const pkg of layer) {
-        layerItems.push(`  \u2022 ${pkg}`);
+      if (flags.script) {
+        for (let i = 0; i < result.layers.length; i++) {
+          const layer = result.layers[i];
+          if (!layer) continue;
+          ctx.ui?.success?.(`# Layer ${i + 1}`, { sections: [{ header: "", items: layer.map((p) => `pnpm --filter "${p}" run build`) }] });
+        }
+        return { exitCode: 0 };
       }
-      layerItems.push("");
+      const sections = flags.layers ? result.layers.map((layer, i) => ({
+        header: `Layer ${i + 1} \u2014 ${layer.length} package(s) (parallel)`,
+        items: layer
+      })) : [{ header: "Build order", items: result.sorted.map((p, i) => `${i + 1}. ${p}`) }];
+      sections.push({
+        header: "Summary",
+        items: [`${result.packageCount} packages in ${result.layerCount} layers`]
+      });
+      ctx.ui?.success?.(flags.package ? `Build order for ${flags.package}` : "Monorepo build order", { sections });
+      return { exitCode: 0 };
     }
-    sections.push({ header: "Build Layers", items: layerItems });
-  } else {
-    const orderItems = result.sorted.map((pkg, idx) => `${idx + 1}. ${pkg}`);
-    sections.push({ header: "Build Order", items: orderItems });
   }
-  sections.push({
-    header: "Summary",
-    items: [
-      `Total packages: ${result.sorted.length}`,
-      `Build layers: ${result.layers.length}`,
-      `Circular dependencies: ${result.circular.length}`
-    ]
-  });
-  const title = flags.package ? `\u{1F4E6} Build Order for ${flags.package}` : "\u{1F4E6} Monorepo Build Order";
-  ui?.success?.("Build order calculated successfully", {
-    title,
-    sections
-  });
-}
-function outputCircularDependencies(cycles, ui) {
-  const sections = [];
-  for (let i = 0; i < cycles.length; i++) {
-    const cycle = cycles[i];
-    if (!cycle) {
-      continue;
-    }
-    sections.push({
-      header: `Cycle ${i + 1}`,
-      items: cycle.map((pkg, idx) => {
-        if (idx === cycle.length - 1) {
-          const firstPkg = cycle[0];
-          return `  ${pkg} \u2192 ${firstPkg ?? "?"} (circular!)`;
-        }
-        return `  ${pkg} \u2192`;
-      })
-    });
-  }
-  ui?.error?.("Circular dependencies detected", {
-    title: "\u26A0\uFE0F Circular Dependencies",
-    sections
-  });
-}
+});
 
 export { build_order_default as default };
 //# sourceMappingURL=build-order.js.map

package/dist/cli/commands/build-order.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/cli/commands/build-order.ts"],"names":[],"mappings":"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","file":"build-order.js","sourcesContent":["/**\n * quality:build-order - Calculate build order and dependency layers\n *\n * Uses topological sort to determine correct build order.\n * Shows build layers where each layer can build in parallel.\n */\n\nimport { defineCommand, type PluginContextV3, type UIFacade } from '@kb-labs/sdk';\nimport {\n  buildDependencyGraph,\n  topologicalSort,\n  getBuildOrderForPackage,\n  type TopologicalSortResult,\n} from '@kb-labs/quality-core/graph';\n\ntype BuildOrderFlags = {\n  package?: string;\n  layers?: boolean;\n  script?: boolean;\n  json?: boolean;\n  argv?: string[];\n};\n\ntype BuildOrderInput = BuildOrderFlags & { argv?: string[] };\n\ntype BuildOrderCommandResult = {\n  exitCode: number;\n  result?: TopologicalSortResult;\n};\n\nexport default defineCommand({\n  id: 'quality:build-order',\n  description: 'Calculate build order using topological sort',\n\n  handler: {\n    async execute(ctx: PluginContextV3, input: BuildOrderInput): Promise<BuildOrderCommandResult> {\n      const { ui } = ctx;\n\n      // V3: Flags may come wrapped in input.flags or passed directly\n      const flags = ('flags' in input && typeof (input as { flags?: unknown }).flags === 'object' && (input as { flags?: unknown }).flags !== null)\n        ? (input as { flags: BuildOrderInput }).flags\n        : input;\n\n      // Build dependency graph\n      const graph = buildDependencyGraph(ctx.cwd);\n\n      // Calculate build order\n      let result: TopologicalSortResult;\n      if (flags.package) {\n        result = getBuildOrderForPackage(graph, flags.package);\n      } else {\n        result = topologicalSort(graph);\n      }\n\n      // Check for circular dependencies\n      if (result.circular.length > 0) {\n        ui?.error?.(\n          `Found ${result.circular.length} circular dependencies. Build order cannot be determined.`\n        );\n        outputCircularDependencies(result.circular, ui);\n        return { exitCode: 1, result };\n      }\n\n      // Output results\n      outputBuildOrder(result, flags, ui);\n\n      return { exitCode: 0, result };\n    },\n  },\n});\n\n/**\n * Output build order results\n */\nfunction outputBuildOrder(result: TopologicalSortResult, flags: BuildOrderFlags, ui: UIFacade | undefined) {\n  if (flags.json) {\n    ui?.json?.(result);\n    return;\n  }\n\n  if (flags.script) {\n    // Output as shell script\n    ui?.write?.('#!/bin/bash');\n    ui?.write?.('# Generated build script');\n    ui?.write?.('set -e');\n    ui?.write?.('');\n\n    for (let i = 0; i < result.layers.length; i++) {\n      const layer = result.layers[i];\n      if (!layer) {continue;}\n      ui?.write?.(`# Layer ${i + 1} (${layer.length} packages)`);\n      for (const pkg of layer) {\n        ui?.write?.(`pnpm --filter \"${pkg}\" run build`);\n      }\n      ui?.write?.('');\n    }\n    return;\n  }\n\n  // Build sections\n  const sections: Array<{ header: string; items: string[] }> = [];\n\n  if (flags.layers) {\n    // Show build layers\n    const layerItems: string[] = [];\n    for (let i = 0; i < result.layers.length; i++) {\n      const layer = result.layers[i];\n      if (!layer) {continue;}\n      layerItems.push(`Layer ${i + 1}: ${layer.length} packages (can build in parallel)`);\n      for (const pkg of layer) {\n        layerItems.push(`  • ${pkg}`);\n      }\n      layerItems.push('');\n    }\n    sections.push({ header: 'Build Layers', items: layerItems });\n  } else {\n    // Show sequential order\n    const orderItems = result.sorted.map((pkg, idx) => `${idx + 1}. ${pkg}`);\n    sections.push({ header: 'Build Order', items: orderItems });\n  }\n\n  // Summary\n  sections.push({\n    header: 'Summary',\n    items: [\n      `Total packages: ${result.sorted.length}`,\n      `Build layers: ${result.layers.length}`,\n      `Circular dependencies: ${result.circular.length}`,\n    ],\n  });\n\n  const title = flags.package\n    ? `📦 Build Order for ${flags.package}`\n    : '📦 Monorepo Build Order';\n\n  ui?.success?.('Build order calculated successfully', {\n    title,\n    sections,\n  });\n}\n\n/**\n * Output circular dependencies\n */\nfunction outputCircularDependencies(cycles: string[][], ui: UIFacade | undefined) {\n  const sections: Array<{ header: string; items: string[] }> = [];\n\n  for (let i = 0; i < cycles.length; i++) {\n    const cycle = cycles[i];\n    if (!cycle) {continue;}\n    sections.push({\n      header: `Cycle ${i + 1}`,\n      items: cycle.map((pkg, idx) => {\n        if (idx === cycle.length - 1) {\n          const firstPkg = cycle[0];\n          return `  ${pkg} → ${firstPkg ?? '?'} (circular!)`;\n        }\n        return `  ${pkg} →`;\n      }),\n    });\n  }\n\n  ui?.error?.('Circular dependencies detected', {\n    title: '⚠️ Circular Dependencies',\n    sections,\n  });\n}\n"]}
+{"version":3,"sources":["../../../src/cli/commands/build-order.ts"],"names":[],"mappings":"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","file":"build-order.js","sourcesContent":["/**\n * quality:build-order - Calculate build order and dependency layers\n *\n * Uses topological sort to determine correct build order.\n * Shows build layers where each layer can build in parallel.\n */\n\nimport { defineCommand, useConfig, type CLIInput, type PluginContextV3 } from '@kb-labs/sdk';\nimport { analyzeBuildOrder } from '@kb-labs/quality-core';\nimport { defaultQualityConfig, type QualityPluginConfig } from '@kb-labs/quality-contracts';\nimport type { BuildOrderFlags } from './flags.js';\n\nexport default defineCommand<unknown, CLIInput<BuildOrderFlags>, { exitCode: number }>({\n  id: 'quality:build-order',\n  description: 'Calculate build order using topological sort',\n\n  handler: {\n    async execute(ctx: PluginContextV3, input: CLIInput<BuildOrderFlags>): Promise<{ exitCode: number }> {\n      const { flags } = input;\n      const config = await useConfig<QualityPluginConfig>();\n      const cfg = config ?? defaultQualityConfig;\n      const cwd = ctx.cwd ?? process.cwd();\n\n      const result = analyzeBuildOrder({\n        rootDir: cwd,\n        layerMap: cfg.layers,\n        filterPackage: flags.package,\n      });\n\n      if (result.hasCircular) {\n        if (flags.json) {\n          ctx.ui?.json?.({ ...result, ok: false });\n        } else {\n          ctx.ui?.error?.(`Circular dependencies detected — build order cannot be fully determined`, {\n            sections: result.circular.map((cycle, i) => ({\n              header: `Cycle ${i + 1}`,\n              items: cycle,\n            })),\n          });\n        }\n        return { exitCode: 1 };\n      }\n\n      if (flags.json) {\n        ctx.ui?.json?.(result);\n        return { exitCode: 0 };\n      }\n\n      if (flags.script) {\n        for (let i = 0; i < result.layers.length; i++) {\n          const layer = result.layers[i];\n          if (!layer) continue;\n          ctx.ui?.success?.(`# Layer ${i + 1}`, { sections: [{ header: '', items: layer.map(p => `pnpm --filter \"${p}\" run build`) }] });\n        }\n        return { exitCode: 0 };\n      }\n\n      const sections = flags.layers\n        ? result.layers.map((layer, i) => ({\n            header: `Layer ${i + 1} — ${layer.length} package(s) (parallel)`,\n            items: layer,\n          }))\n        : [{ header: 'Build order', items: result.sorted.map((p, i) => `${i + 1}. ${p}`) }];\n\n      sections.push({\n        header: 'Summary',\n        items: [`${result.packageCount} packages in ${result.layerCount} layers`],\n      });\n\n      ctx.ui?.success?.(flags.package ? `Build order for ${flags.package}` : 'Monorepo build order', { sections });\n      return { exitCode: 0 };\n    },\n  },\n});\n\n"]}

package/dist/cli/commands/check-layers.d.ts

@@ -0,0 +1,9 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import { CLIInput } from '@kb-labs/sdk';
+import { CheckLayersFlags } from './flags.js';
+
+declare const _default: _kb_labs_shared_command_kit.CommandHandlerV3<unknown, CLIInput<CheckLayersFlags>, {
+    exitCode: number;
+}>;
+
+export { _default as default };

package/dist/cli/commands/check-layers.js

@@ -0,0 +1,48 @@
+import { defineCommand, useConfig } from '@kb-labs/sdk';
+import { analyzeLayering } from '@kb-labs/quality-core';
+
+// src/cli/commands/check-layers.ts
+var check_layers_default = defineCommand({
+  id: "quality:check-layers",
+  description: "Detect layering violations (lower layer importing higher layer)",
+  handler: {
+    async execute(ctx, input) {
+      const { flags } = input;
+      const config = await useConfig();
+      const cwd = ctx.cwd ?? process.cwd();
+      const report = await analyzeLayering({
+        rootDir: cwd,
+        layerMap: config?.layers
+      });
+      const filtered = flags.package ? {
+        ...report,
+        violations: report.violations.filter((v) => v.fromPackage.includes(flags.package)),
+        totalViolations: report.violations.filter((v) => v.fromPackage.includes(flags.package)).length
+      } : report;
+      if (flags.json) {
+        ctx.ui?.json?.(filtered);
+        return { exitCode: filtered.totalViolations > 0 ? 1 : 0 };
+      }
+      if (filtered.totalViolations === 0) {
+        ctx.ui?.success?.("No layering violations found");
+        return { exitCode: 0 };
+      }
+      const byPackage = /* @__PURE__ */ new Map();
+      for (const v of filtered.violations) {
+        const list = byPackage.get(v.fromPackage) ?? [];
+        list.push(v);
+        byPackage.set(v.fromPackage, list);
+      }
+      const sections = [...byPackage.entries()].map(([pkg, vs]) => ({
+        header: `${pkg} (Layer ${vs[0]?.fromLayer})`,
+        items: vs.map((v) => `\u2192 ${v.toPackage} (Layer ${v.toLayer})  ${v.importSpecifier}`)
+      }));
+      ctx.ui?.error?.(`${filtered.totalViolations} layering violation(s) in ${filtered.affectedPackages.length} package(s)`, { sections });
+      return { exitCode: 1 };
+    }
+  }
+});
+
+export { check_layers_default as default };
+//# sourceMappingURL=check-layers.js.map
+//# sourceMappingURL=check-layers.js.map

package/dist/cli/commands/check-layers.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/cli/commands/check-layers.ts"],"names":[],"mappings":";;;;AAUA,IAAO,uBAAQ,aAAA,CAAyE;AAAA,EACtF,EAAA,EAAI,sBAAA;AAAA,EACJ,WAAA,EAAa,iEAAA;AAAA,EAEb,OAAA,EAAS;AAAA,IACP,MAAM,OAAA,CAAQ,GAAA,EAAsB,KAAA,EAAkE;AACpG,MAAA,MAAM,EAAE,OAAM,GAAI,KAAA;AAClB,MAAA,MAAM,MAAA,GAAS,MAAM,SAAA,EAA+B;AACpD,MAAA,MAAM,GAAA,GAAM,GAAA,CAAI,GAAA,IAAO,OAAA,CAAQ,GAAA,EAAI;AAEnC,MAAA,MAAM,MAAA,GAAS,MAAM,eAAA,CAAgB;AAAA,QACnC,OAAA,EAAS,GAAA;AAAA,QACT,UAAU,MAAA,EAAQ;AAAA,OACnB,CAAA;AAED,MAAA,MAAM,QAAA,GAAW,MAAM,OAAA,GACnB;AAAA,QACE,GAAG,MAAA;AAAA,QACH,UAAA,EAAY,MAAA,CAAO,UAAA,CAAW,MAAA,CAAO,CAAC,CAAA,KAAyB,CAAA,CAAE,WAAA,CAAY,QAAA,CAAS,KAAA,CAAM,OAAQ,CAAC,CAAA;AAAA,QACrG,eAAA,EAAiB,MAAA,CAAO,UAAA,CAAW,MAAA,CAAO,CAAC,CAAA,KAAyB,CAAA,CAAE,WAAA,CAAY,QAAA,CAAS,KAAA,CAAM,OAAQ,CAAC,CAAA,CAAE;AAAA,OAC9G,GACA,MAAA;AAEJ,MAAA,IAAI,MAAM,IAAA,EAAM;AACd,QAAA,GAAA,CAAI,EAAA,EAAI,OAAO,QAAQ,CAAA;AACvB,QAAA,OAAO,EAAE,QAAA,EAAU,QAAA,CAAS,eAAA,GAAkB,CAAA,GAAI,IAAI,CAAA,EAAE;AAAA,MAC1D;AAEA,MAAA,IAAI,QAAA,CAAS,oBAAoB,CAAA,EAAG;AAClC,QAAA,GAAA,CAAI,EAAA,EAAI,UAAU,8BAA8B,CAAA;AAChD,QAAA,OAAO,EAAE,UAAU,CAAA,EAAE;AAAA,MACvB;AAEA,MAAA,MAAM,SAAA,uBAAgB,GAAA,EAAwC;AAC9D,MAAA,KAAA,MAAW,CAAA,IAAK,SAAS,UAAA,EAAY;AACnC,QAAA,MAAM,OAAO,SAAA,CAAU,GAAA,CAAI,CAAA,CAAE,WAAW,KAAK,EAAC;AAC9C,QAAA,IAAA,CAAK,KAAK,CAAC,CAAA;AACX,QAAA,SAAA,CAAU,GAAA,CAAI,CAAA,CAAE,WAAA,EAAa,IAAI,CAAA;AAAA,MACnC;AAEA,MAAA,MAAM,QAAA,GAAW,CAAC,GAAG,SAAA,CAAU,OAAA,EAAS,CAAA,CAAE,GAAA,CAAI,CAAC,CAAC,GAAA,EAAK,EAAE,CAAA,MAAO;AAAA,QAC5D,QAAQ,CAAA,EAAG,GAAG,WAAW,EAAA,CAAG,CAAC,GAAG,SAAS,CAAA,CAAA,CAAA;AAAA,QACzC,KAAA,EAAO,EAAA,CAAG,GAAA,CAAI,CAAC,MAAyB,CAAA,OAAA,EAAK,CAAA,CAAE,SAAS,CAAA,QAAA,EAAW,CAAA,CAAE,OAAO,CAAA,GAAA,EAAM,CAAA,CAAE,eAAe,CAAA,CAAE;AAAA,OACvG,CAAE,CAAA;AAEF,MAAA,GAAA,CAAI,EAAA,EAAI,KAAA,GAAQ,CAAA,EAAG,QAAA,CAAS,eAAe,CAAA,0BAAA,EAA6B,QAAA,CAAS,gBAAA,CAAiB,MAAM,CAAA,WAAA,CAAA,EAAe,EAAE,QAAA,EAAU,CAAA;AACnI,MAAA,OAAO,EAAE,UAAU,CAAA,EAAE;AAAA,IACvB;AAAA;AAEJ,CAAC","file":"check-layers.js","sourcesContent":["import {\n  defineCommand,\n  useConfig,\n  type CLIInput,\n  type PluginContextV3,\n} from '@kb-labs/sdk';\nimport { analyzeLayering } from '@kb-labs/quality-core';\nimport { type QualityPluginConfig, type LayeringViolation } from '@kb-labs/quality-contracts';\nimport type { CheckLayersFlags } from './flags.js';\n\nexport default defineCommand<unknown, CLIInput<CheckLayersFlags>, { exitCode: number }>({\n  id: 'quality:check-layers',\n  description: 'Detect layering violations (lower layer importing higher layer)',\n\n  handler: {\n    async execute(ctx: PluginContextV3, input: CLIInput<CheckLayersFlags>): Promise<{ exitCode: number }> {\n      const { flags } = input;\n      const config = await useConfig<QualityPluginConfig>();\n      const cwd = ctx.cwd ?? process.cwd();\n\n      const report = await analyzeLayering({\n        rootDir: cwd,\n        layerMap: config?.layers,\n      });\n\n      const filtered = flags.package\n        ? {\n            ...report,\n            violations: report.violations.filter((v: LayeringViolation) => v.fromPackage.includes(flags.package!)),\n            totalViolations: report.violations.filter((v: LayeringViolation) => v.fromPackage.includes(flags.package!)).length,\n          }\n        : report;\n\n      if (flags.json) {\n        ctx.ui?.json?.(filtered);\n        return { exitCode: filtered.totalViolations > 0 ? 1 : 0 };\n      }\n\n      if (filtered.totalViolations === 0) {\n        ctx.ui?.success?.('No layering violations found');\n        return { exitCode: 0 };\n      }\n\n      const byPackage = new Map<string, typeof filtered.violations>();\n      for (const v of filtered.violations) {\n        const list = byPackage.get(v.fromPackage) ?? [];\n        list.push(v);\n        byPackage.set(v.fromPackage, list);\n      }\n\n      const sections = [...byPackage.entries()].map(([pkg, vs]) => ({\n        header: `${pkg} (Layer ${vs[0]?.fromLayer})`,\n        items: vs.map((v: LayeringViolation) => `→ ${v.toPackage} (Layer ${v.toLayer})  ${v.importSpecifier}`),\n      }));\n\n      ctx.ui?.error?.(`${filtered.totalViolations} layering violation(s) in ${filtered.affectedPackages.length} package(s)`, { sections });\n      return { exitCode: 1 };\n    },\n  },\n});\n"]}

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

@@ -0,0 +1,9 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import { CLIInput } from '@kb-labs/sdk';
+import { ContextFlags } from './flags.js';
+
+declare const _default: _kb_labs_shared_command_kit.CommandHandlerV3<unknown, CLIInput<ContextFlags>, {
+    exitCode: number;
+}>;
+
+export { _default as default };

package/dist/cli/commands/context.js

@@ -0,0 +1,94 @@
+import { defineCommand, useConfig } from '@kb-labs/sdk';
+import { scanWorkspace, buildPackageMap } from '@kb-labs/quality-core';
+import { defaultQualityConfig } from '@kb-labs/quality-contracts';
+
+// src/cli/commands/context.ts
+var LAYER_NAMES = {
+  0: "core",
+  1: "sdk / shared",
+  2: "cli / adapters",
+  3: "plugins",
+  4: "studio"
+};
+var context_default = defineCommand({
+  id: "quality:context",
+  description: "Package context for agents: layer, dependents, dependencies, coupling",
+  handler: {
+    async execute(ctx, input) {
+      const { flags } = input;
+      const config = await useConfig();
+      const cwd = ctx.cwd ?? process.cwd();
+      const layerMap = config?.layers ?? defaultQualityConfig.layers;
+      const packages = scanWorkspace(cwd, layerMap);
+      const packageMap = buildPackageMap(packages);
+      const allNames = new Set(packageMap.keys());
+      const pkgName = flags.package;
+      if (!pkgName) {
+        const byLayer = /* @__PURE__ */ new Map();
+        for (const p of packages) {
+          const list = byLayer.get(p.layer) ?? [];
+          list.push(p.name);
+          byLayer.set(p.layer, list);
+        }
+        if (flags.json) {
+          const summary = Object.fromEntries(
+            [...byLayer.entries()].map(([l, names]) => [LAYER_NAMES[l] ?? `layer-${l}`, names])
+          );
+          ctx.ui?.json?.({ totalPackages: packages.length, byLayer: summary });
+          return { exitCode: 0 };
+        }
+        const sections = [...byLayer.entries()].sort(([a], [b]) => a - b).map(([layer, names]) => ({
+          header: `Layer ${layer}: ${LAYER_NAMES[layer] ?? "unknown"} (${names.length})`,
+          items: names
+        }));
+        ctx.ui?.success?.(`Workspace: ${packages.length} packages`, { sections });
+        return { exitCode: 0 };
+      }
+      const pkg = packageMap.get(pkgName);
+      if (!pkg) {
+        ctx.ui?.error?.(`Package not found: ${pkgName}`);
+        return { exitCode: 1 };
+      }
+      const wsDeps = pkg.deps.filter((d) => allNames.has(d));
+      const wsDevDeps = pkg.devDeps.filter((d) => allNames.has(d));
+      const dependents = packages.filter((p) => p.name !== pkgName && (p.deps.includes(pkgName) || p.devDeps.includes(pkgName))).map((p) => p.name);
+      const ce = wsDeps.length + wsDevDeps.length;
+      const ca = dependents.length;
+      const instability = ca + ce === 0 ? 0 : Math.round(ce / (ca + ce) * 100) / 100;
+      const context = {
+        name: pkgName,
+        layer: pkg.layer,
+        layerName: LAYER_NAMES[pkg.layer] ?? "unknown",
+        dir: pkg.dir.replace(cwd + "/", ""),
+        coupling: { afferent: ca, efferent: ce, instability },
+        dependents,
+        dependencies: wsDeps,
+        devDependencies: wsDevDeps
+      };
+      if (flags.json) {
+        ctx.ui?.json?.(context);
+        return { exitCode: 0 };
+      }
+      ctx.ui?.success?.(`Context: ${pkgName}`, {
+        sections: [
+          {
+            header: "Package info",
+            items: [
+              `Layer: ${pkg.layer} (${LAYER_NAMES[pkg.layer] ?? "unknown"})`,
+              `Dir: ${context.dir}`,
+              `Instability: ${instability}  Ca: ${ca}  Ce: ${ce}`
+            ]
+          },
+          ...dependents.length > 0 ? [{ header: `Dependents (${ca}) \u2014 packages that import this`, items: dependents }] : [{ header: "Dependents", items: ["none \u2014 this package is a leaf"] }],
+          ...wsDeps.length > 0 ? [{ header: `Dependencies (${wsDeps.length}) \u2014 workspace packages this imports`, items: wsDeps }] : [],
+          ...wsDevDeps.length > 0 ? [{ header: `Dev dependencies (${wsDevDeps.length})`, items: wsDevDeps }] : []
+        ]
+      });
+      return { exitCode: 0 };
+    }
+  }
+});
+
+export { context_default as default };
+//# sourceMappingURL=context.js.map
+//# sourceMappingURL=context.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/cli/commands/context.ts"],"names":[],"mappings":"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","file":"context.js","sourcesContent":["import {\n  defineCommand,\n  useConfig,\n  type CLIInput,\n  type PluginContextV3,\n} from '@kb-labs/sdk';\nimport { scanWorkspace, buildPackageMap } from '@kb-labs/quality-core';\nimport { defaultQualityConfig, type QualityPluginConfig } from '@kb-labs/quality-contracts';\nimport type { ContextFlags } from './flags.js';\n\nconst LAYER_NAMES: Record<number, string> = {\n  0: 'core',\n  1: 'sdk / shared',\n  2: 'cli / adapters',\n  3: 'plugins',\n  4: 'studio',\n};\n\nexport default defineCommand<unknown, CLIInput<ContextFlags>, { exitCode: number }>({\n  id: 'quality:context',\n  description: 'Package context for agents: layer, dependents, dependencies, coupling',\n\n  handler: {\n    async execute(ctx: PluginContextV3, input: CLIInput<ContextFlags>): Promise<{ exitCode: number }> {\n      const { flags } = input;\n      const config = await useConfig<QualityPluginConfig>();\n      const cwd = ctx.cwd ?? process.cwd();\n      const layerMap = config?.layers ?? defaultQualityConfig.layers;\n\n      const packages = scanWorkspace(cwd, layerMap);\n      const packageMap = buildPackageMap(packages);\n      const allNames = new Set(packageMap.keys());\n\n      const pkgName = flags.package;\n\n      if (!pkgName) {\n        // No package specified — show workspace summary\n        const byLayer = new Map<number, string[]>();\n        for (const p of packages) {\n          const list = byLayer.get(p.layer) ?? [];\n          list.push(p.name);\n          byLayer.set(p.layer, list);\n        }\n\n        if (flags.json) {\n          const summary = Object.fromEntries(\n            [...byLayer.entries()].map(([l, names]) => [LAYER_NAMES[l] ?? `layer-${l}`, names])\n          );\n          ctx.ui?.json?.({ totalPackages: packages.length, byLayer: summary });\n          return { exitCode: 0 };\n        }\n\n        const sections = [...byLayer.entries()]\n          .sort(([a], [b]) => a - b)\n          .map(([layer, names]) => ({\n            header: `Layer ${layer}: ${LAYER_NAMES[layer] ?? 'unknown'} (${names.length})`,\n            items: names,\n          }));\n\n        ctx.ui?.success?.(`Workspace: ${packages.length} packages`, { sections });\n        return { exitCode: 0 };\n      }\n\n      const pkg = packageMap.get(pkgName);\n      if (!pkg) {\n        ctx.ui?.error?.(`Package not found: ${pkgName}`);\n        return { exitCode: 1 };\n      }\n\n      // Workspace deps (efferent)\n      const wsDeps = pkg.deps.filter(d => allNames.has(d));\n      const wsDevDeps = pkg.devDeps.filter(d => allNames.has(d));\n\n      // Who depends on this package (afferent) — scan all packages\n      const dependents = packages\n        .filter(p => p.name !== pkgName && (p.deps.includes(pkgName) || p.devDeps.includes(pkgName)))\n        .map(p => p.name);\n\n      const ce = wsDeps.length + wsDevDeps.length;\n      const ca = dependents.length;\n      const instability = ca + ce === 0 ? 0 : Math.round((ce / (ca + ce)) * 100) / 100;\n\n      const context = {\n        name: pkgName,\n        layer: pkg.layer,\n        layerName: LAYER_NAMES[pkg.layer] ?? 'unknown',\n        dir: pkg.dir.replace(cwd + '/', ''),\n        coupling: { afferent: ca, efferent: ce, instability },\n        dependents,\n        dependencies: wsDeps,\n        devDependencies: wsDevDeps,\n      };\n\n      if (flags.json) {\n        ctx.ui?.json?.(context);\n        return { exitCode: 0 };\n      }\n\n      ctx.ui?.success?.(`Context: ${pkgName}`, {\n        sections: [\n          {\n            header: 'Package info',\n            items: [\n              `Layer: ${pkg.layer} (${LAYER_NAMES[pkg.layer] ?? 'unknown'})`,\n              `Dir: ${context.dir}`,\n              `Instability: ${instability}  Ca: ${ca}  Ce: ${ce}`,\n            ],\n          },\n          ...(dependents.length > 0\n            ? [{ header: `Dependents (${ca}) — packages that import this`, items: dependents }]\n            : [{ header: 'Dependents', items: ['none — this package is a leaf'] }]),\n          ...(wsDeps.length > 0\n            ? [{ header: `Dependencies (${wsDeps.length}) — workspace packages this imports`, items: wsDeps }]\n            : []),\n          ...(wsDevDeps.length > 0\n            ? [{ header: `Dev dependencies (${wsDevDeps.length})`, items: wsDevDeps }]\n            : []),\n        ],\n      });\n\n      return { exitCode: 0 };\n    },\n  },\n});\n"]}

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

@@ -0,0 +1,9 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import { CLIInput } from '@kb-labs/sdk';
+import { CouplingFlags } from './flags.js';
+
+declare const _default: _kb_labs_shared_command_kit.CommandHandlerV3<unknown, CLIInput<CouplingFlags>, {
+    exitCode: number;
+}>;
+
+export { _default as default };

package/dist/cli/commands/coupling.js

@@ -0,0 +1,35 @@
+import { defineCommand, useConfig } from '@kb-labs/sdk';
+import { analyzeCoupling } from '@kb-labs/quality-core';
+
+// src/cli/commands/coupling.ts
+var coupling_default = defineCommand({
+  id: "quality:coupling",
+  description: "Show coupling metrics per package (afferent/efferent/instability)",
+  handler: {
+    async execute(ctx, input) {
+      const { flags } = input;
+      const config = await useConfig();
+      const cwd = ctx.cwd ?? process.cwd();
+      const report = analyzeCoupling({ rootDir: cwd, layerMap: config?.layers, topN: flags.top });
+      if (flags.json) {
+        ctx.ui?.json?.(report);
+        return { exitCode: 0 };
+      }
+      const sorted = flags.sort === "coupled" ? [...report.packages].sort((a, b) => b.afferent + b.efferent - (a.afferent + a.efferent)) : [...report.packages].sort((a, b) => b.instability - a.instability);
+      const top = sorted.slice(0, flags.top ?? 10);
+      const threshold = config?.thresholds?.instability ?? 0.85;
+      const items = top.map((p) => {
+        const warn = p.instability > threshold ? " \u26A0 unstable" : "";
+        return `${p.name}  Ca: ${p.afferent}  Ce: ${p.efferent}  I: ${p.instability.toFixed(2)}${warn}`;
+      });
+      ctx.ui?.success?.(`Coupling \u2014 avg instability: ${report.avgInstability.toFixed(2)}`, {
+        sections: [{ header: `Top ${top.length} by instability`, items }]
+      });
+      return { exitCode: 0 };
+    }
+  }
+});
+
+export { coupling_default as default };
+//# sourceMappingURL=coupling.js.map
+//# sourceMappingURL=coupling.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/cli/commands/coupling.ts"],"names":[],"mappings":";;;;AAUA,IAAO,mBAAQ,aAAA,CAAsE;AAAA,EACnF,EAAA,EAAI,kBAAA;AAAA,EACJ,WAAA,EAAa,mEAAA;AAAA,EAEb,OAAA,EAAS;AAAA,IACP,MAAM,OAAA,CAAQ,GAAA,EAAsB,KAAA,EAA+D;AACjG,MAAA,MAAM,EAAE,OAAM,GAAI,KAAA;AAClB,MAAA,MAAM,MAAA,GAAS,MAAM,SAAA,EAA+B;AACpD,MAAA,MAAM,GAAA,GAAM,GAAA,CAAI,GAAA,IAAO,OAAA,CAAQ,GAAA,EAAI;AAEnC,MAAA,MAAM,MAAA,GAAS,eAAA,CAAgB,EAAE,OAAA,EAAS,GAAA,EAAK,QAAA,EAAU,MAAA,EAAQ,MAAA,EAAQ,IAAA,EAAM,KAAA,CAAM,GAAA,EAAK,CAAA;AAE1F,MAAA,IAAI,MAAM,IAAA,EAAM;AACd,QAAA,GAAA,CAAI,EAAA,EAAI,OAAO,MAAM,CAAA;AACrB,QAAA,OAAO,EAAE,UAAU,CAAA,EAAE;AAAA,MACvB;AAEA,MAAA,MAAM,MAAA,GACJ,KAAA,CAAM,IAAA,KAAS,SAAA,GACX,CAAC,GAAG,MAAA,CAAO,QAAQ,CAAA,CAAE,KAAK,CAAC,CAAA,EAAG,CAAA,KAAM,CAAA,CAAE,WAAW,CAAA,CAAE,QAAA,IAAY,CAAA,CAAE,QAAA,GAAW,CAAA,CAAE,QAAA,CAAS,CAAA,GACvF,CAAC,GAAG,MAAA,CAAO,QAAQ,CAAA,CAAE,IAAA,CAAK,CAAC,CAAA,EAAG,CAAA,KAAM,CAAA,CAAE,WAAA,GAAc,EAAE,WAAW,CAAA;AAEvE,MAAA,MAAM,MAAM,MAAA,CAAO,KAAA,CAAM,CAAA,EAAG,KAAA,CAAM,OAAO,EAAE,CAAA;AAC3C,MAAA,MAAM,SAAA,GAAY,MAAA,EAAQ,UAAA,EAAY,WAAA,IAAe,IAAA;AAErD,MAAA,MAAM,KAAA,GAAQ,GAAA,CAAI,GAAA,CAAI,CAAA,CAAA,KAAK;AACzB,QAAA,MAAM,IAAA,GAAO,CAAA,CAAE,WAAA,GAAc,SAAA,GAAY,kBAAA,GAAgB,EAAA;AACzD,QAAA,OAAO,GAAG,CAAA,CAAE,IAAI,CAAA,MAAA,EAAS,CAAA,CAAE,QAAQ,CAAA,MAAA,EAAS,CAAA,CAAE,QAAQ,CAAA,KAAA,EAAQ,EAAE,WAAA,CAAY,OAAA,CAAQ,CAAC,CAAC,GAAG,IAAI,CAAA,CAAA;AAAA,MAC/F,CAAC,CAAA;AAED,MAAA,GAAA,CAAI,EAAA,EAAI,UAAU,CAAA,iCAAA,EAA+B,MAAA,CAAO,eAAe,OAAA,CAAQ,CAAC,CAAC,CAAA,CAAA,EAAI;AAAA,QACnF,QAAA,EAAU,CAAC,EAAE,MAAA,EAAQ,OAAO,GAAA,CAAI,MAAM,CAAA,eAAA,CAAA,EAAmB,KAAA,EAAO;AAAA,OACjE,CAAA;AAED,MAAA,OAAO,EAAE,UAAU,CAAA,EAAE;AAAA,IACvB;AAAA;AAEJ,CAAC","file":"coupling.js","sourcesContent":["import {\n  defineCommand,\n  useConfig,\n  type CLIInput,\n  type PluginContextV3,\n} from '@kb-labs/sdk';\nimport { analyzeCoupling } from '@kb-labs/quality-core';\nimport { type QualityPluginConfig } from '@kb-labs/quality-contracts';\nimport type { CouplingFlags } from './flags.js';\n\nexport default defineCommand<unknown, CLIInput<CouplingFlags>, { exitCode: number }>({\n  id: 'quality:coupling',\n  description: 'Show coupling metrics per package (afferent/efferent/instability)',\n\n  handler: {\n    async execute(ctx: PluginContextV3, input: CLIInput<CouplingFlags>): Promise<{ exitCode: number }> {\n      const { flags } = input;\n      const config = await useConfig<QualityPluginConfig>();\n      const cwd = ctx.cwd ?? process.cwd();\n\n      const report = analyzeCoupling({ rootDir: cwd, layerMap: config?.layers, topN: flags.top });\n\n      if (flags.json) {\n        ctx.ui?.json?.(report);\n        return { exitCode: 0 };\n      }\n\n      const sorted =\n        flags.sort === 'coupled'\n          ? [...report.packages].sort((a, b) => b.afferent + b.efferent - (a.afferent + a.efferent))\n          : [...report.packages].sort((a, b) => b.instability - a.instability);\n\n      const top = sorted.slice(0, flags.top ?? 10);\n      const threshold = config?.thresholds?.instability ?? 0.85;\n\n      const items = top.map(p => {\n        const warn = p.instability > threshold ? ' ⚠ unstable' : '';\n        return `${p.name}  Ca: ${p.afferent}  Ce: ${p.efferent}  I: ${p.instability.toFixed(2)}${warn}`;\n      });\n\n      ctx.ui?.success?.(`Coupling — avg instability: ${report.avgInstability.toFixed(2)}`, {\n        sections: [{ header: `Top ${top.length} by instability`, items }],\n      });\n\n      return { exitCode: 0 };\n    },\n  },\n});\n"]}

package/dist/cli/commands/dead-code.d.ts

@@ -1,10 +1,9 @@
 import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
-import { DeadCodeResult, DeadCodeRemovalResult, DeadCodeBackupManifest } from '@kb-labs/quality-contracts';
+import { CLIInput } from '@kb-labs/sdk';
 import { DeadCodeFlags } from './flags.js';
 
-type DeadCodeInput = DeadCodeFlags & {
-    argv?: string[];
-};
-declare const _default: _kb_labs_shared_command_kit.CommandHandlerV3<unknown, DeadCodeInput, DeadCodeResult | DeadCodeRemovalResult | DeadCodeBackupManifest[]>;
+declare const _default: _kb_labs_shared_command_kit.CommandHandlerV3<unknown, CLIInput<DeadCodeFlags>, {
+    exitCode: number;
+}>;
 
 export { _default as default };