@kb-labs/quality-entry 2.14.0

package/README.md

@@ -0,0 +1,120 @@
+# @kb-labs/plugin-template-cli
+
+Reference CLI/REST/Studio plugin package for KB Labs Plugin Template.
+
+## Vision & Purpose
+
+**@kb-labs/plugin-template-cli** is the canonical example plugin package used by `@kb-labs/plugin-template`.  
+It shows how to implement a plugin that exposes:
+
+- a **CLI command** (Hello),
+- a **REST handler**, and
+- a **Studio widget**,
+
+all driven by a single manifest and contracts package.
+
+## Package Status
+
+- **Version**: 0.1.0  
+- **Stage**: Stable (template)  
+- **Status**: Reference Implementation ✅
+
+## Architecture
+
+### High-Level Overview
+
+```
+plugin-cli
+    │
+    ├──► contracts     (from @kb-labs/plugin-template-contracts)
+    ├──► shared        (constants/helpers)
+    ├──► domain        (Greeting entity and invariants)
+    ├──► application   (use-cases: create greeting, etc.)
+    ├──► cli           (Hello command wiring)
+    ├──► rest          (Hello REST handler + schema)
+    └──► studio        (Hello Studio widget)
+```
+
+### Key Components
+
+- `src/domain/`: `Greeting` entity and domain rules
+- `src/application/`: use-cases that orchestrate domain logic
+- `src/cli/commands/hello/*`: CLI command implementation
+- `src/rest/handlers/hello-handler.ts`: REST handler bound to manifest
+- `src/studio/widgets/hello-widget.tsx`: Studio widget implementation
+- `src/manifest.v2.ts`: Plugin manifest v2 (CLI/REST/Studio wiring)
+
+## Features
+
+- **Single-source manifest** for CLI/REST/Studio surfaces
+- **Layered architecture** (shared → domain → application → interface)
+- **Type-safe contracts** via `@kb-labs/plugin-template-contracts`
+- **Hello-world flow** demonstrating end-to-end plugin wiring
+
+## Exports
+
+From `src/index.ts`:
+
+- `manifest`: Plugin Manifest V2
+- All public surfaces:
+  - CLI command exports
+  - domain/application/shared re-exports
+
+## Dependencies
+
+### Runtime
+
+- `@kb-labs/setup-operations`: reusable setup operations
+- `@kb-labs/plugin-manifest`: manifest types and helpers
+- `@kb-labs/plugin-template-contracts`: public contracts for this template plugin
+- `@kb-labs/shared-cli-ui`: shared CLI UI helpers
+- `react`, `react-dom`, `zod`
+
+### Development
+
+- `@kb-labs/devkit`: shared TS/ESLint/Vitest/TSUP presets
+- `typescript`, `tsup`, `vitest`, `rimraf`
+
+## Scripts
+
+From `kb-labs-plugin-template` repo root:
+
+```bash
+pnpm install
+pnpm --filter @kb-labs/plugin-template-cli build
+pnpm --filter @kb-labs/plugin-template-cli test
+```
+
+To run sandboxes, see the root `README.md` (`pnpm sandbox:cli`, `sandbox:rest`, `sandbox:studio`).
+
+## Command Implementation
+
+This template demonstrates **three different approaches** to implementing CLI commands:
+
+1. **High-level wrapper (`defineCommand`)** - Recommended for most cases
+2. **Low-level atomic tools** - For maximum control
+3. **Hybrid approach** - Combining both
+
+See [`COMMAND_IMPLEMENTATION_GUIDE.md`](./COMMAND_IMPLEMENTATION_GUIDE.md) for detailed explanations and examples.
+
+### Quick Start
+
+The `template:hello` command in `src/cli/commands/hello/run.ts` shows all three approaches with working code examples. The default implementation uses Approach 1 (`defineCommand`), which provides:
+
+- ✅ Zero-boilerplate flag validation
+- ✅ Automatic analytics integration
+- ✅ Structured logging
+- ✅ Error handling
+- ✅ Timing tracking
+- ✅ JSON output mode
+
+## Customising for Your Plugin
+
+When using this as a starting point:
+
+- Rename the package in `package.json` (e.g. `@kb-labs/my-plugin-cli`)
+- Update manifest IDs and the contracts package
+- Replace the Hello flow with your own domain, use-cases, and surfaces
+- Choose the command implementation approach that fits your needs (see `COMMAND_IMPLEMENTATION_GUIDE.md`)
+
+

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

@@ -0,0 +1,16 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import { TopologicalSortResult } from '@kb-labs/quality-core/graph';
+
+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>;
+
+export { _default as default };

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

@@ -0,0 +1,113 @@
+import { defineCommand } from '@kb-labs/sdk';
+import { buildDependencyGraph, getBuildOrderForPackage, topologicalSort } from '@kb-labs/quality-core/graph';
+
+// src/cli/commands/build-order.ts
+var build_order_default = defineCommand({
+  id: "quality:build-order",
+  description: "Calculate build order using topological sort",
+  handler: {
+    async execute(ctx, input) {
+      const { ui } = ctx;
+      const flags = 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;
+      }
+      ui?.write?.(`# Layer ${i + 1} (${layer.length} packages)`);
+      for (const pkg of layer) {
+        ui?.write?.(`pnpm --filter "${pkg}" run build`);
+      }
+      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}`);
+      }
+      layerItems.push("");
+    }
+    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
+//# sourceMappingURL=build-order.js.map

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

@@ -0,0 +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 } 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 come in input.flags object (not auto-merged)\n      const flags = (input as any).flags ?? 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: any, ui: any) {\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: any) {\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"]}

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

@@ -0,0 +1,10 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import { BuildCheckResult } from '@kb-labs/quality-contracts';
+import { CheckBuildsFlags } from './flags.js';
+
+type CheckBuildsInput = CheckBuildsFlags & {
+    argv?: string[];
+};
+declare const _default: _kb_labs_shared_command_kit.CommandHandlerV3<unknown, CheckBuildsInput, BuildCheckResult>;
+
+export { _default as default };

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

@@ -0,0 +1,93 @@
+import { defineCommand } from '@kb-labs/sdk';
+import { CACHE_KEYS } from '@kb-labs/quality-contracts';
+import { checkBuilds } from '@kb-labs/quality-core/builds';
+
+// src/cli/commands/check-builds.ts
+var check_builds_default = defineCommand({
+  id: "quality:check-builds",
+  description: "Check build status across monorepo",
+  handler: {
+    async execute(ctx, input) {
+      const { ui, platform } = ctx;
+      const flags = input.flags ?? input;
+      const cacheKey = `${CACHE_KEYS.BUILDS}:${flags.package || "all"}`;
+      if (!flags.refresh) {
+        const cached = await platform.cache.get(cacheKey);
+        if (cached) {
+          outputBuildCheck({ ...cached, cached: true }, flags, ui);
+          return { exitCode: cached.failing > 0 ? 1 : 0, result: cached };
+        }
+      }
+      const result = await checkBuilds(ctx.cwd, {
+        packageFilter: flags.package,
+        timeout: flags.timeout ? Number(flags.timeout) : 3e4
+      });
+      await platform.cache.set(cacheKey, result, 10 * 60 * 1e3);
+      await platform.analytics.track("quality:check-builds", {
+        totalPackages: result.totalPackages,
+        passing: result.passing,
+        failing: result.failing,
+        staleBuilds: result.staleBuilds.length,
+        duration: result.duration,
+        packageSpecific: !!flags.package
+      });
+      outputBuildCheck({ ...result, cached: false }, flags, ui);
+      return {
+        exitCode: result.failing > 0 ? 1 : 0,
+        result
+      };
+    }
+  }
+});
+function outputBuildCheck(result, flags, ui) {
+  if (flags.json) {
+    ui?.json?.(result);
+    return;
+  }
+  const sections = [];
+  const statusIcon = result.failing === 0 ? "\u2705" : "\u274C";
+  const statusText = result.failing === 0 ? "All builds passing" : "Build failures detected";
+  const statusItems = [
+    `${statusIcon} ${statusText}`,
+    `Passing: ${result.passing} package(s)`,
+    result.failing > 0 ? `Failing: ${result.failing} package(s)` : null
+  ].filter(Boolean);
+  sections.push({ header: "Build Status", items: statusItems });
+  if (result.failures.length > 0) {
+    const failureItems = [];
+    for (const failure of result.failures.slice(0, 5)) {
+      failureItems.push(`\u2022 ${failure.package}`);
+      const firstLine = failure.error.split("\n")[0];
+      failureItems.push(`  ${firstLine?.substring(0, 80) || "Build failed"}`);
+    }
+    if (result.failures.length > 5) {
+      failureItems.push(`... and ${result.failures.length - 5} more failures`);
+    }
+    sections.push({ header: "\u274C Failed Packages", items: failureItems });
+  }
+  if (result.staleBuilds.length > 0) {
+    const staleItems = result.staleBuilds.slice(0, 5).map((s) => `\u2022 ${s.package}`);
+    if (result.staleBuilds.length > 5) {
+      staleItems.push(`... and ${result.staleBuilds.length - 5} more`);
+    }
+    sections.push({
+      header: "\u26A0\uFE0F  Stale Builds (dist/ older than src/)",
+      items: staleItems
+    });
+  }
+  const summaryItems = [
+    `Total packages: ${result.totalPackages}`,
+    `Duration: ${(result.duration / 1e3).toFixed(1)}s`,
+    result.cached ? "\u{1F4BE} Cached (use --refresh to recheck)" : "\u{1F504} Fresh check"
+  ];
+  sections.push({ header: "Summary", items: summaryItems });
+  const title = result.failing === 0 ? "\u2705 All Builds Passing" : `\u274C ${result.failing} Build Failure(s) Detected`;
+  ui?.success?.("Build check completed", {
+    title,
+    sections
+  });
+}
+
+export { check_builds_default as default };
+//# sourceMappingURL=check-builds.js.map
+//# sourceMappingURL=check-builds.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/cli/commands/check-builds.ts"],"names":[],"mappings":"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","file":"check-builds.js","sourcesContent":["/**\n * quality:check-builds - Check build status across monorepo\n *\n * Analyzes build status including:\n * - Build failures with error messages\n * - Stale builds (dist/ older than src/)\n * - Build duration tracking\n */\n\nimport { defineCommand, type PluginContextV3 } from '@kb-labs/sdk';\nimport type { BuildCheckResult } from '@kb-labs/quality-contracts';\nimport { CACHE_KEYS } from '@kb-labs/quality-contracts';\nimport { checkBuilds } from '@kb-labs/quality-core/builds';\nimport type { CheckBuildsFlags } from './flags.js';\n\n// Input type with backward compatibility\ntype CheckBuildsInput = CheckBuildsFlags & { argv?: string[] };\n\ntype CheckBuildsCommandResult = {\n  exitCode: number;\n  result?: BuildCheckResult;\n  meta?: Record<string, unknown>;\n};\n\nexport default defineCommand({\n  id: 'quality:check-builds',\n  description: 'Check build status across monorepo',\n\n  handler: {\n    async execute(\n      ctx: PluginContextV3,\n      input: CheckBuildsInput\n    ): Promise<CheckBuildsCommandResult> {\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      // Check cache unless refresh requested\n      const cacheKey = `${CACHE_KEYS.BUILDS}:${flags.package || 'all'}`;\n\n      if (!flags.refresh) {\n        const cached = await platform.cache.get<BuildCheckResult>(cacheKey);\n        if (cached) {\n          outputBuildCheck({ ...cached, cached: true }, flags, ui);\n          return { exitCode: cached.failing > 0 ? 1 : 0, result: cached };\n        }\n      }\n\n      // Run build check\n      const result = await checkBuilds(ctx.cwd, {\n        packageFilter: flags.package,\n        timeout: flags.timeout ? Number(flags.timeout) : 30000,\n      });\n\n      // Cache results for 10 minutes\n      await platform.cache.set(cacheKey, result, 10 * 60 * 1000);\n\n      // Track analytics\n      await platform.analytics.track('quality:check-builds', {\n        totalPackages: result.totalPackages,\n        passing: result.passing,\n        failing: result.failing,\n        staleBuilds: result.staleBuilds.length,\n        duration: result.duration,\n        packageSpecific: !!flags.package,\n      });\n\n      // Output results\n      outputBuildCheck({ ...result, cached: false }, flags, ui);\n\n      return {\n        exitCode: result.failing > 0 ? 1 : 0,\n        result,\n      };\n    },\n  },\n});\n\n/**\n * Output build check results\n */\nfunction outputBuildCheck(\n  result: BuildCheckResult & { cached?: boolean },\n  flags: any,\n  ui: any\n) {\n  if (flags.json) {\n    ui?.json?.(result);\n    return;\n  }\n\n  // Build sections\n  const sections: Array<{ header: string; items: string[] }> = [];\n\n  // Status section\n  const statusIcon = result.failing === 0 ? '✅' : '❌';\n  const statusText = result.failing === 0 ? 'All builds passing' : 'Build failures detected';\n  const statusItems = [\n    `${statusIcon} ${statusText}`,\n    `Passing: ${result.passing} package(s)`,\n    result.failing > 0 ? `Failing: ${result.failing} package(s)` : null,\n  ].filter(Boolean) as string[];\n\n  sections.push({ header: 'Build Status', items: statusItems });\n\n  // Failed packages\n  if (result.failures.length > 0) {\n    const failureItems: string[] = [];\n    for (const failure of result.failures.slice(0, 5)) {\n      failureItems.push(`• ${failure.package}`);\n      // Show first line of error\n      const firstLine = failure.error.split('\\n')[0];\n      failureItems.push(`  ${firstLine?.substring(0, 80) || 'Build failed'}`);\n    }\n\n    if (result.failures.length > 5) {\n      failureItems.push(`... and ${result.failures.length - 5} more failures`);\n    }\n\n    sections.push({ header: '❌ Failed Packages', items: failureItems });\n  }\n\n  // Stale builds\n  if (result.staleBuilds.length > 0) {\n    const staleItems = result.staleBuilds.slice(0, 5).map((s) => `• ${s.package}`);\n\n    if (result.staleBuilds.length > 5) {\n      staleItems.push(`... and ${result.staleBuilds.length - 5} more`);\n    }\n\n    sections.push({\n      header: '⚠️  Stale Builds (dist/ older than src/)',\n      items: staleItems,\n    });\n  }\n\n  // Summary\n  const summaryItems = [\n    `Total packages: ${result.totalPackages}`,\n    `Duration: ${(result.duration / 1000).toFixed(1)}s`,\n    result.cached ? '💾 Cached (use --refresh to recheck)' : '🔄 Fresh check',\n  ];\n\n  sections.push({ header: 'Summary', items: summaryItems });\n\n  const title =\n    result.failing === 0\n      ? '✅ All Builds Passing'\n      : `❌ ${result.failing} Build Failure(s) Detected`;\n\n  ui?.success?.('Build check completed', {\n    title,\n    sections,\n  });\n}\n"]}

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

@@ -0,0 +1,10 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import { TestRunResult } from '@kb-labs/quality-contracts';
+import { CheckTestsFlags } from './flags.js';
+
+type CheckTestsInput = CheckTestsFlags & {
+    argv?: string[];
+};
+declare const _default: _kb_labs_shared_command_kit.CommandHandlerV3<unknown, CheckTestsInput, TestRunResult>;
+
+export { _default as default };

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

@@ -0,0 +1,114 @@
+import { defineCommand } from '@kb-labs/sdk';
+import { runTests } from '@kb-labs/quality-core/tests';
+import { CACHE_KEYS } from '@kb-labs/quality-contracts';
+
+// src/cli/commands/check-tests.ts
+var check_tests_default = defineCommand({
+  id: "quality:check-tests",
+  description: "Run tests and track coverage across monorepo",
+  handler: {
+    async execute(ctx, input) {
+      const { ui, platform } = ctx;
+      const flags = input.flags ?? input;
+      const cacheKey = `${CACHE_KEYS.TESTS}:${flags.package || "all"}`;
+      if (!flags.refresh) {
+        const cached = await platform.cache.get(cacheKey);
+        if (cached) {
+          outputTestResults({ ...cached, cached: true }, flags, ui);
+          return { exitCode: cached.failing > 0 ? 1 : 0, result: cached };
+        }
+      }
+      const result = await runTests(ctx.cwd, {
+        packageFilter: flags.package,
+        timeout: flags.timeout ? Number(flags.timeout) : 6e4,
+        withCoverage: flags["with-coverage"],
+        coverageOnly: flags["coverage-only"]
+      });
+      await platform.cache.set(cacheKey, result, 5 * 60 * 1e3);
+      await platform.analytics.track("quality:check-tests", {
+        packageFilter: flags.package || "all",
+        totalPackages: result.totalPackages,
+        passing: result.passing,
+        failing: result.failing,
+        withCoverage: flags["with-coverage"],
+        cached: false
+      });
+      outputTestResults({ ...result, cached: false }, flags, ui);
+      return {
+        exitCode: result.failing > 0 ? 1 : 0,
+        result,
+        meta: { cached: false }
+      };
+    }
+  }
+});
+function outputTestResults(result, flags, ui) {
+  if (flags.json) {
+    ui?.json?.(result);
+    return;
+  }
+  const sections = [];
+  const statusIcon = result.failing === 0 ? "\u2705" : "\u274C";
+  const statusText = result.failing === 0 ? "All tests passing" : "Test failures detected";
+  const statusItems = [
+    `${statusIcon} ${statusText}`,
+    `Total packages: ${result.totalPackages}`,
+    `Passing: ${result.passing}`,
+    result.failing > 0 ? `Failing: ${result.failing}` : null,
+    result.skipped > 0 ? `Skipped: ${result.skipped} (no test script)` : null
+  ].filter(Boolean);
+  sections.push({ header: "Test Status", items: statusItems });
+  if (result.summary.totalTests > 0) {
+    const summaryItems2 = [
+      `Total tests: ${result.summary.totalTests}`,
+      `Passed: ${result.summary.passedTests}`,
+      result.summary.failedTests > 0 ? `Failed: ${result.summary.failedTests}` : null
+    ].filter(Boolean);
+    sections.push({ header: "Test Summary", items: summaryItems2 });
+  }
+  if (result.failures.length > 0) {
+    const failureItems = [];
+    for (const failure of result.failures.slice(0, 5)) {
+      failureItems.push(`\u274C ${failure.package}`);
+      if (failure.failedTests && failure.totalTests) {
+        failureItems.push(`  ${failure.failedTests}/${failure.totalTests} tests failed`);
+      }
+      const firstLine = failure.error.split("\n")[0];
+      failureItems.push(`  ${firstLine?.substring(0, 80) || "Test failed"}`);
+    }
+    if (result.failures.length > 5) {
+      failureItems.push(`... and ${result.failures.length - 5} more failures`);
+    }
+    sections.push({ header: "Failed Packages", items: failureItems });
+  }
+  if (result.coverage.packages.length > 0) {
+    const coverageItems = [];
+    coverageItems.push(`Average coverage: ${result.coverage.avgCoverage.toFixed(1)}%`);
+    coverageItems.push("");
+    const topPackages = result.coverage.packages.sort((a, b) => b.lines - a.lines).slice(0, 5);
+    for (const pkg of topPackages) {
+      coverageItems.push(`${pkg.name}`);
+      coverageItems.push(
+        `  Lines: ${pkg.lines.toFixed(1)}% | Statements: ${pkg.statements.toFixed(1)}% | Functions: ${pkg.functions.toFixed(1)}% | Branches: ${pkg.branches.toFixed(1)}%`
+      );
+    }
+    if (result.coverage.packages.length > 5) {
+      coverageItems.push(`... and ${result.coverage.packages.length - 5} more packages`);
+    }
+    sections.push({ header: "Coverage", items: coverageItems });
+  }
+  const summaryItems = [
+    `Duration: ${(result.duration / 1e3).toFixed(1)}s`,
+    result.cached ? "\u{1F4BE} Cached (use --refresh to re-run)" : "\u{1F504} Fresh run"
+  ];
+  sections.push({ header: "Summary", items: summaryItems });
+  const title = result.failing === 0 ? "\u2705 All Tests Passed" : `\u274C ${result.failing} Package(s) with Test Failures`;
+  ui?.success?.("Test run completed", {
+    title,
+    sections
+  });
+}
+
+export { check_tests_default as default };
+//# sourceMappingURL=check-tests.js.map
+//# sourceMappingURL=check-tests.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/cli/commands/check-tests.ts"],"names":["summaryItems"],"mappings":"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","file":"check-tests.js","sourcesContent":["/**\n * quality:check-tests - Test execution and coverage tracking\n *\n * Runs tests across monorepo packages and collects coverage statistics.\n */\n\nimport { defineCommand, type PluginContextV3 } from '@kb-labs/sdk';\nimport { runTests } from '@kb-labs/quality-core/tests';\nimport { CACHE_KEYS, type TestRunResult } from '@kb-labs/quality-contracts';\nimport { type CheckTestsFlags } from './flags.js';\n\n// Input type with backward compatibility\ntype CheckTestsInput = CheckTestsFlags & { argv?: string[] };\n\ntype CheckTestsCommandResult = {\n  exitCode: number;\n  result?: TestRunResult;\n  meta?: Record<string, unknown>;\n};\n\nexport default defineCommand({\n  id: 'quality:check-tests',\n  description: 'Run tests and track coverage across monorepo',\n\n  handler: {\n    async execute(\n      ctx: PluginContextV3,\n      input: CheckTestsInput\n    ): Promise<CheckTestsCommandResult> {\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      const cacheKey = `${CACHE_KEYS.TESTS}:${flags.package || 'all'}`;\n\n      // Check cache unless refresh requested\n      if (!flags.refresh) {\n        const cached = await platform.cache.get<TestRunResult>(cacheKey);\n        if (cached) {\n          outputTestResults({ ...cached, cached: true }, flags, ui);\n          return { exitCode: cached.failing > 0 ? 1 : 0, result: cached };\n        }\n      }\n\n      // Run tests\n      const result = await runTests(ctx.cwd, {\n        packageFilter: flags.package,\n        timeout: flags.timeout ? Number(flags.timeout) : 60000,\n        withCoverage: flags['with-coverage'],\n        coverageOnly: flags['coverage-only'],\n      });\n\n      // Cache result (5 min TTL - tests are slower)\n      await platform.cache.set(cacheKey, result, 5 * 60 * 1000);\n\n      // Track analytics\n      await platform.analytics.track('quality:check-tests', {\n        packageFilter: flags.package || 'all',\n        totalPackages: result.totalPackages,\n        passing: result.passing,\n        failing: result.failing,\n        withCoverage: flags['with-coverage'],\n        cached: false,\n      });\n\n      // Output results\n      outputTestResults({ ...result, cached: false }, flags, ui);\n\n      return {\n        exitCode: result.failing > 0 ? 1 : 0,\n        result,\n        meta: { cached: false },\n      };\n    },\n  },\n});\n\n/**\n * Output test results\n */\nfunction outputTestResults(\n  result: TestRunResult & { cached: boolean },\n  flags: CheckTestsInput,\n  ui: any\n): void {\n  if (flags.json) {\n    ui?.json?.(result);\n    return;\n  }\n\n  // Build sections\n  const sections: Array<{ header: string; items: string[] }> = [];\n\n  // Status section\n  const statusIcon = result.failing === 0 ? '✅' : '❌';\n  const statusText = result.failing === 0 ? 'All tests passing' : 'Test failures detected';\n  const statusItems = [\n    `${statusIcon} ${statusText}`,\n    `Total packages: ${result.totalPackages}`,\n    `Passing: ${result.passing}`,\n    result.failing > 0 ? `Failing: ${result.failing}` : null,\n    result.skipped > 0 ? `Skipped: ${result.skipped} (no test script)` : null,\n  ].filter(Boolean) as string[];\n\n  sections.push({ header: 'Test Status', items: statusItems });\n\n  // Test summary\n  if (result.summary.totalTests > 0) {\n    const summaryItems = [\n      `Total tests: ${result.summary.totalTests}`,\n      `Passed: ${result.summary.passedTests}`,\n      result.summary.failedTests > 0 ? `Failed: ${result.summary.failedTests}` : null,\n    ].filter(Boolean) as string[];\n\n    sections.push({ header: 'Test Summary', items: summaryItems });\n  }\n\n  // Failed packages\n  if (result.failures.length > 0) {\n    const failureItems: string[] = [];\n    for (const failure of result.failures.slice(0, 5)) {\n      failureItems.push(`❌ ${failure.package}`);\n      if (failure.failedTests && failure.totalTests) {\n        failureItems.push(`  ${failure.failedTests}/${failure.totalTests} tests failed`);\n      }\n      // Show first line of error\n      const firstLine = failure.error.split('\\n')[0];\n      failureItems.push(`  ${firstLine?.substring(0, 80) || 'Test failed'}`);\n    }\n\n    if (result.failures.length > 5) {\n      failureItems.push(`... and ${result.failures.length - 5} more failures`);\n    }\n\n    sections.push({ header: 'Failed Packages', items: failureItems });\n  }\n\n  // Coverage section (if available)\n  if (result.coverage.packages.length > 0) {\n    const coverageItems: string[] = [];\n    coverageItems.push(`Average coverage: ${result.coverage.avgCoverage.toFixed(1)}%`);\n    coverageItems.push('');\n\n    const topPackages = result.coverage.packages\n      .sort((a, b) => b.lines - a.lines)\n      .slice(0, 5);\n\n    for (const pkg of topPackages) {\n      coverageItems.push(`${pkg.name}`);\n      coverageItems.push(\n        `  Lines: ${pkg.lines.toFixed(1)}% | Statements: ${pkg.statements.toFixed(1)}% | Functions: ${pkg.functions.toFixed(1)}% | Branches: ${pkg.branches.toFixed(1)}%`\n      );\n    }\n\n    if (result.coverage.packages.length > 5) {\n      coverageItems.push(`... and ${result.coverage.packages.length - 5} more packages`);\n    }\n\n    sections.push({ header: 'Coverage', items: coverageItems });\n  }\n\n  // Summary\n  const summaryItems = [\n    `Duration: ${(result.duration / 1000).toFixed(1)}s`,\n    result.cached ? '💾 Cached (use --refresh to re-run)' : '🔄 Fresh run',\n  ];\n\n  sections.push({ header: 'Summary', items: summaryItems });\n\n  const title =\n    result.failing === 0\n      ? '✅ All Tests Passed'\n      : `❌ ${result.failing} Package(s) with Test Failures`;\n\n  ui?.success?.('Test run completed', {\n    title,\n    sections,\n  });\n}\n"]}

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

@@ -0,0 +1,10 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import { TypeAnalysisResult } from '@kb-labs/quality-contracts';
+import { CheckTypesFlags } from './flags.js';
+
+type CheckTypesInput = CheckTypesFlags & {
+    argv?: string[];
+};
+declare const _default: _kb_labs_shared_command_kit.CommandHandlerV3<unknown, CheckTypesInput, TypeAnalysisResult>;
+
+export { _default as default };

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

@@ -0,0 +1,108 @@
+import { defineCommand } from '@kb-labs/sdk';
+import { analyzeTypes } from '@kb-labs/quality-core/types';
+import { CACHE_KEYS } from '@kb-labs/quality-contracts';
+
+// src/cli/commands/check-types.ts
+var check_types_default = defineCommand({
+  id: "quality:check-types",
+  description: "Analyze TypeScript type safety across monorepo",
+  handler: {
+    async execute(ctx, input) {
+      const { ui, platform } = ctx;
+      const flags = input.flags ?? input;
+      const cacheKey = `${CACHE_KEYS.TYPE_ANALYSIS}:${flags.package || "all"}`;
+      if (!flags.refresh) {
+        const cached = await platform.cache.get(cacheKey);
+        if (cached) {
+          outputTypeAnalysis({ ...cached, cached: true }, flags, ui);
+          return { exitCode: cached.totalErrors > 0 ? 1 : 0, result: cached };
+        }
+      }
+      const result = await analyzeTypes(ctx.cwd, {
+        packageFilter: flags.package,
+        errorsOnly: flags["errors-only"]
+      });
+      await platform.cache.set(cacheKey, result, 10 * 60 * 1e3);
+      await platform.analytics.track("quality:check-types", {
+        packageFilter: flags.package || "all",
+        totalPackages: result.totalPackages,
+        totalErrors: result.totalErrors,
+        avgCoverage: result.avgCoverage,
+        cached: false
+      });
+      outputTypeAnalysis({ ...result, cached: false }, flags, ui);
+      return {
+        exitCode: result.totalErrors > 0 ? 1 : 0,
+        result,
+        meta: { cached: false }
+      };
+    }
+  }
+});
+function outputTypeAnalysis(result, flags, ui) {
+  if (flags.json) {
+    ui?.json?.(result);
+    return;
+  }
+  const errorsOnly = flags["errors-only"] || false;
+  const sections = [];
+  const statusIcon = result.totalErrors === 0 ? "\u2705" : "\u274C";
+  const statusText = result.totalErrors === 0 ? "All packages passed type checks" : "Type errors detected";
+  const statusItems = [
+    `${statusIcon} ${statusText}`,
+    `Analyzed: ${result.totalPackages} package(s)`,
+    `Errors: ${result.totalErrors}`,
+    `Warnings: ${result.totalWarnings}`,
+    `Avg Coverage: ${result.avgCoverage.toFixed(1)}%`
+  ];
+  sections.push({ header: "Type Safety Status", items: statusItems });
+  if (result.packagesWithErrors > 0) {
+    const errorItems = [];
+    const packagesToShow = result.packages.filter((pkg) => !errorsOnly || pkg.errors > 0).slice(0, 10);
+    for (const pkg of packagesToShow) {
+      const status = pkg.errors > 0 ? "\u274C" : "\u2705";
+      errorItems.push(`${status} ${pkg.name}`);
+      const details = [
+        pkg.errors > 0 ? `${pkg.errors} error(s)` : null,
+        pkg.warnings > 0 ? `${pkg.warnings} warning(s)` : null,
+        `${pkg.coverage.toFixed(1)}% coverage`,
+        pkg.anyCount > 0 ? `${pkg.anyCount} any` : null,
+        pkg.tsIgnoreCount > 0 ? `${pkg.tsIgnoreCount} @ts-ignore` : null
+      ].filter(Boolean).join(", ");
+      errorItems.push(`  ${details}`);
+    }
+    if (result.packages.length > 10) {
+      errorItems.push(`... and ${result.packages.length - 10} more packages`);
+    }
+    sections.push({
+      header: `Packages with Type Errors (${result.packagesWithErrors})`,
+      items: errorItems
+    });
+  }
+  const excellent = result.packages.filter((p) => p.coverage >= 90).length;
+  const good = result.packages.filter((p) => p.coverage >= 70 && p.coverage < 90).length;
+  const poor = result.packages.filter((p) => p.coverage < 70).length;
+  if (result.packages.length > 0) {
+    const coverageItems = [
+      `\u2705 Excellent (\u226590%): ${excellent} package(s)`,
+      `\u26A0\uFE0F  Good (70-90%):   ${good} package(s)`,
+      poor > 0 ? `\u274C Poor (<70%):     ${poor} package(s)` : null
+    ].filter(Boolean);
+    sections.push({ header: "Type Coverage Distribution", items: coverageItems });
+  }
+  const summaryItems = [
+    `Total packages: ${result.totalPackages}`,
+    `Duration: ${(result.duration / 1e3).toFixed(1)}s`,
+    result.cached ? "\u{1F4BE} Cached (use --refresh to recheck)" : "\u{1F504} Fresh analysis"
+  ];
+  sections.push({ header: "Summary", items: summaryItems });
+  const title = result.totalErrors === 0 ? "\u2705 All Type Checks Passed" : `\u274C ${result.packagesWithErrors} Package(s) with Type Errors`;
+  ui?.success?.("Type analysis completed", {
+    title,
+    sections
+  });
+}
+
+export { check_types_default as default };
+//# sourceMappingURL=check-types.js.map
+//# sourceMappingURL=check-types.js.map