@democratize-quality/qualitylens-core 0.1.0

package/dist/reporters/base.reporter.js

@@ -0,0 +1,32 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/reporters/base.reporter.ts
+var base_reporter_exports = {};
+__export(base_reporter_exports, {
+  BaseReporter: () => BaseReporter
+});
+module.exports = __toCommonJS(base_reporter_exports);
+var BaseReporter = class {
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BaseReporter
+});
+//# sourceMappingURL=base.reporter.js.map

package/dist/reporters/base.reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/reporters/base.reporter.ts"],"sourcesContent":["/**\n * src/reporters/base.reporter.ts\n * \n * Abstract base class for all reporters.\n * To add a new output format: extend this class, implement write().\n */\n\nimport { CoverageReport } from '../core/types'\n\nexport abstract class BaseReporter {\n  abstract readonly name: string\n\n  /**\n   * Write the report to the given output path.\n   * For console reporter, outputPath may be ignored.\n   */\n  abstract write(report: CoverageReport, outputPath: string): Promise<void>\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AASO,IAAe,eAAf,MAA4B;AAQnC;","names":[]}

package/dist/reporters/base.reporter.mjs

@@ -0,0 +1,7 @@
+// src/reporters/base.reporter.ts
+var BaseReporter = class {
+};
+export {
+  BaseReporter
+};
+//# sourceMappingURL=base.reporter.mjs.map

package/dist/reporters/base.reporter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/reporters/base.reporter.ts"],"sourcesContent":["/**\n * src/reporters/base.reporter.ts\n * \n * Abstract base class for all reporters.\n * To add a new output format: extend this class, implement write().\n */\n\nimport { CoverageReport } from '../core/types'\n\nexport abstract class BaseReporter {\n  abstract readonly name: string\n\n  /**\n   * Write the report to the given output path.\n   * For console reporter, outputPath may be ignored.\n   */\n  abstract write(report: CoverageReport, outputPath: string): Promise<void>\n}\n"],"mappings":";AASO,IAAe,eAAf,MAA4B;AAQnC;","names":[]}

package/dist/reporters/console.reporter.d.mts

@@ -0,0 +1,16 @@
+import { BaseReporter } from './base.reporter.mjs';
+import { CoverageReport } from '../core/types.mjs';
+
+/**
+ * src/reporters/console.reporter.ts
+ * Pretty terminal output using chalk.
+ * Kept concise — this is a summary, not the full report.
+ */
+
+declare class ConsoleReporter extends BaseReporter {
+    readonly name = "console";
+    write(report: CoverageReport, _outputDir: string): Promise<void>;
+    private colourise;
+}
+
+export { ConsoleReporter };

package/dist/reporters/console.reporter.d.ts

@@ -0,0 +1,16 @@
+import { BaseReporter } from './base.reporter.js';
+import { CoverageReport } from '../core/types.js';
+
+/**
+ * src/reporters/console.reporter.ts
+ * Pretty terminal output using chalk.
+ * Kept concise — this is a summary, not the full report.
+ */
+
+declare class ConsoleReporter extends BaseReporter {
+    readonly name = "console";
+    write(report: CoverageReport, _outputDir: string): Promise<void>;
+    private colourise;
+}
+
+export { ConsoleReporter };

package/dist/reporters/console.reporter.js

@@ -0,0 +1,130 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/reporters/console.reporter.ts
+var console_reporter_exports = {};
+__export(console_reporter_exports, {
+  ConsoleReporter: () => ConsoleReporter
+});
+module.exports = __toCommonJS(console_reporter_exports);
+var path = __toESM(require("path"));
+var import_chalk = __toESM(require("chalk"));
+
+// src/reporters/base.reporter.ts
+var BaseReporter = class {
+};
+
+// src/reporters/console.reporter.ts
+var ConsoleReporter = class extends BaseReporter {
+  name = "console";
+  async write(report, _outputDir) {
+    const { summary, areas, uncategorised } = report;
+    const allRoutes = [...areas.flatMap((a) => a.routes), ...uncategorised];
+    const noCoverage = allRoutes.filter((r) => r.status === "none");
+    const stale = allRoutes.filter((r) => r.staleness === "stale");
+    const totalColoured = this.colourise(summary.totalCoverage, `${summary.totalCoverage}%`);
+    console.log(
+      `
+qualitylens: ${totalColoured} total  (${import_chalk.default.cyan(summary.automatedCoverage + "%")} auto \xB7 ${import_chalk.default.magenta(summary.manualOnlyCoverage + "%")} manual \xB7 ${import_chalk.default.red(summary.noCoverage + "%")} none)
+`
+    );
+    for (const area of areas) {
+      const filled = Math.round(area.coveragePercent / 5);
+      const bar = this.colourise(
+        area.coveragePercent,
+        "\u2588".repeat(filled) + "\u2591".repeat(20 - filled)
+      );
+      const pct = this.colourise(area.coveragePercent, `${area.coveragePercent}%`);
+      console.log(`
+  ${area.name.padEnd(24)} ${bar} ${pct}`);
+      for (const r of area.routes) {
+        const method = r.route.method ? import_chalk.default.dim(`${r.route.method} `) : "";
+        const routeLine = r.status === "none" ? import_chalk.default.red(`    \u274C ${method}${r.route.path}`) : r.status === "automated" ? import_chalk.default.green(`    \u2705 ${method}${r.route.path}`) : r.status === "both" ? import_chalk.default.cyan(`    \u2B50 ${method}${r.route.path}`) : import_chalk.default.blue(`    \u{1F535} ${method}${r.route.path}`);
+        console.log(routeLine);
+        for (const t of r.automatedTests) {
+          const file = t.filePath ? import_chalk.default.dim(` (${path.basename(t.filePath)})`) : "";
+          console.log(import_chalk.default.green(`       \u2192 "${t.title}"`) + file);
+        }
+        for (const t of r.manualTests) {
+          const src = import_chalk.default.dim(` (${t.source})`);
+          console.log(import_chalk.default.blue(`       \u2192 "${t.title}"`) + src);
+        }
+      }
+    }
+    if (uncategorised.length > 0) {
+      console.log(import_chalk.default.dim(`
+  Uncategorised`));
+      for (const r of uncategorised) {
+        const method = r.route.method ? import_chalk.default.dim(`${r.route.method} `) : "";
+        console.log(
+          r.status === "none" ? import_chalk.default.red(`    \u274C ${method}${r.route.path}`) : import_chalk.default.dim(`    \xB7 ${method}${r.route.path}`)
+        );
+        for (const t of r.automatedTests) {
+          const file = t.filePath ? import_chalk.default.dim(` (${path.basename(t.filePath)})`) : "";
+          console.log(import_chalk.default.green(`       \u2192 "${t.title}"`) + file);
+        }
+        for (const t of r.manualTests) {
+          console.log(import_chalk.default.blue(`       \u2192 "${t.title}"`) + import_chalk.default.dim(` (${t.source})`));
+        }
+      }
+    }
+    if (noCoverage.length > 0) {
+      console.log(import_chalk.default.red(`
+No coverage (${noCoverage.length} routes): `) + noCoverage.map((r) => import_chalk.default.red(r.route.path)).join(", "));
+    }
+    if (stale.length > 0) {
+      console.log(import_chalk.default.yellow(`
+Stale manual coverage (${stale.length} routes):`));
+      stale.forEach((r) => {
+        const days = r.lastTestedAt ? Math.round((Date.now() - r.lastTestedAt.getTime()) / 864e5) : "?";
+        console.log(import_chalk.default.yellow(`  \u26A0\uFE0F  ${r.route.path.padEnd(40)} \u2014 last tested ${days}d ago`));
+      });
+    }
+    if (report.unmatchedTests.length > 0) {
+      console.log(import_chalk.default.magenta(`
+Orphaned tests \u2014 matched no route (${report.unmatchedTests.length}):`));
+      for (const t of report.unmatchedTests) {
+        const file = t.filePath ? import_chalk.default.dim(` (${path.basename(t.filePath)})`) : "";
+        console.log(import_chalk.default.magenta(`  \u26A0  "${t.title}"`) + file);
+      }
+    }
+    console.log();
+  }
+  // Colours a string based on a numeric coverage percentage threshold
+  colourise(percent, str) {
+    if (percent >= 80) return import_chalk.default.green(str);
+    if (percent >= 50) return import_chalk.default.yellow(str);
+    return import_chalk.default.red(str);
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ConsoleReporter
+});
+//# sourceMappingURL=console.reporter.js.map

package/dist/reporters/console.reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/reporters/console.reporter.ts","../../src/reporters/base.reporter.ts"],"sourcesContent":["/**\n * src/reporters/console.reporter.ts\n * Pretty terminal output using chalk.\n * Kept concise — this is a summary, not the full report.\n */\n\nimport * as path from 'path'\nimport chalk from 'chalk'\nimport { BaseReporter } from './base.reporter'\nimport { CoverageReport } from '../core/types'\n\nexport class ConsoleReporter extends BaseReporter {\n  readonly name = 'console'\n\n  async write(report: CoverageReport, _outputDir: string): Promise<void> {\n    const { summary, areas, uncategorised } = report\n    const allRoutes = [...areas.flatMap(a => a.routes), ...uncategorised]\n    const noCoverage = allRoutes.filter(r => r.status === 'none')\n    const stale = allRoutes.filter(r => r.staleness === 'stale')\n\n    // ── Summary line ─────────────────────────────────────────────────────────\n    const totalColoured = this.colourise(summary.totalCoverage, `${summary.totalCoverage}%`)\n    console.log(\n      `\\nqualitylens: ${totalColoured} total` +\n      `  (${chalk.cyan(summary.automatedCoverage + '%')} auto` +\n      ` · ${chalk.magenta(summary.manualOnlyCoverage + '%')} manual` +\n      ` · ${chalk.red(summary.noCoverage + '%')} none)\\n`\n    )\n\n    // ── Per-area breakdown with route + test traceability ────────────────────\n    for (const area of areas) {\n      const filled = Math.round(area.coveragePercent / 5)\n      const bar = this.colourise(\n        area.coveragePercent,\n        '█'.repeat(filled) + '░'.repeat(20 - filled)\n      )\n      const pct = this.colourise(area.coveragePercent, `${area.coveragePercent}%`)\n      console.log(`\\n  ${area.name.padEnd(24)} ${bar} ${pct}`)\n\n      for (const r of area.routes) {\n        const method = r.route.method ? chalk.dim(`${r.route.method} `) : ''\n        const routeLine = r.status === 'none'\n          ? chalk.red(`    ❌ ${method}${r.route.path}`)\n          : r.status === 'automated'\n            ? chalk.green(`    ✅ ${method}${r.route.path}`)\n            : r.status === 'both'\n              ? chalk.cyan(`    ⭐ ${method}${r.route.path}`)\n              : chalk.blue(`    🔵 ${method}${r.route.path}`)\n        console.log(routeLine)\n\n        for (const t of r.automatedTests) {\n          const file = t.filePath ? chalk.dim(` (${path.basename(t.filePath)})`) : ''\n          console.log(chalk.green(`       → \"${t.title}\"`) + file)\n        }\n        for (const t of r.manualTests) {\n          const src = chalk.dim(` (${t.source})`)\n          console.log(chalk.blue(`       → \"${t.title}\"`) + src)\n        }\n      }\n    }\n\n    // ── Uncategorised routes ──────────────────────────────────────────────────\n    if (uncategorised.length > 0) {\n      console.log(chalk.dim(`\\n  Uncategorised`))\n      for (const r of uncategorised) {\n        const method = r.route.method ? chalk.dim(`${r.route.method} `) : ''\n        console.log(r.status === 'none'\n          ? chalk.red(`    ❌ ${method}${r.route.path}`)\n          : chalk.dim(`    · ${method}${r.route.path}`)\n        )\n        for (const t of r.automatedTests) {\n          const file = t.filePath ? chalk.dim(` (${path.basename(t.filePath)})`) : ''\n          console.log(chalk.green(`       → \"${t.title}\"`) + file)\n        }\n        for (const t of r.manualTests) {\n          console.log(chalk.blue(`       → \"${t.title}\"`) + chalk.dim(` (${t.source})`))\n        }\n      }\n    }\n\n    // ── No coverage summary ───────────────────────────────────────────────────\n    if (noCoverage.length > 0) {\n      console.log(chalk.red(`\\nNo coverage (${noCoverage.length} routes): `) +\n        noCoverage.map(r => chalk.red(r.route.path)).join(', '))\n    }\n\n    // ── Stale manual coverage list ───────────────────────────────────────────\n    if (stale.length > 0) {\n      console.log(chalk.yellow(`\\nStale manual coverage (${stale.length} routes):`))\n      stale.forEach(r => {\n        const days = r.lastTestedAt\n          ? Math.round((Date.now() - r.lastTestedAt.getTime()) / 86400000)\n          : '?'\n        console.log(chalk.yellow(`  ⚠️  ${r.route.path.padEnd(40)} — last tested ${days}d ago`))\n      })\n    }\n\n    // ── Orphaned tests (matched no route) ────────────────────────────────────\n    if (report.unmatchedTests.length > 0) {\n      console.log(chalk.magenta(`\\nOrphaned tests — matched no route (${report.unmatchedTests.length}):`))\n      for (const t of report.unmatchedTests) {\n        const file = t.filePath ? chalk.dim(` (${path.basename(t.filePath)})`) : ''\n        console.log(chalk.magenta(`  ⚠  \"${t.title}\"`) + file)\n      }\n    }\n\n    console.log()\n  }\n\n  // Colours a string based on a numeric coverage percentage threshold\n  private colourise(percent: number, str: string): string {\n    if (percent >= 80) return chalk.green(str)\n    if (percent >= 50) return chalk.yellow(str)\n    return chalk.red(str)\n  }\n}\n","/**\n * src/reporters/base.reporter.ts\n * \n * Abstract base class for all reporters.\n * To add a new output format: extend this class, implement write().\n */\n\nimport { CoverageReport } from '../core/types'\n\nexport abstract class BaseReporter {\n  abstract readonly name: string\n\n  /**\n   * Write the report to the given output path.\n   * For console reporter, outputPath may be ignored.\n   */\n  abstract write(report: CoverageReport, outputPath: string): Promise<void>\n}\n"],"mappings":"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","names":["chalk"]}

package/dist/reporters/console.reporter.mjs

@@ -0,0 +1,95 @@
+// src/reporters/console.reporter.ts
+import * as path from "path";
+import chalk from "chalk";
+
+// src/reporters/base.reporter.ts
+var BaseReporter = class {
+};
+
+// src/reporters/console.reporter.ts
+var ConsoleReporter = class extends BaseReporter {
+  name = "console";
+  async write(report, _outputDir) {
+    const { summary, areas, uncategorised } = report;
+    const allRoutes = [...areas.flatMap((a) => a.routes), ...uncategorised];
+    const noCoverage = allRoutes.filter((r) => r.status === "none");
+    const stale = allRoutes.filter((r) => r.staleness === "stale");
+    const totalColoured = this.colourise(summary.totalCoverage, `${summary.totalCoverage}%`);
+    console.log(
+      `
+qualitylens: ${totalColoured} total  (${chalk.cyan(summary.automatedCoverage + "%")} auto \xB7 ${chalk.magenta(summary.manualOnlyCoverage + "%")} manual \xB7 ${chalk.red(summary.noCoverage + "%")} none)
+`
+    );
+    for (const area of areas) {
+      const filled = Math.round(area.coveragePercent / 5);
+      const bar = this.colourise(
+        area.coveragePercent,
+        "\u2588".repeat(filled) + "\u2591".repeat(20 - filled)
+      );
+      const pct = this.colourise(area.coveragePercent, `${area.coveragePercent}%`);
+      console.log(`
+  ${area.name.padEnd(24)} ${bar} ${pct}`);
+      for (const r of area.routes) {
+        const method = r.route.method ? chalk.dim(`${r.route.method} `) : "";
+        const routeLine = r.status === "none" ? chalk.red(`    \u274C ${method}${r.route.path}`) : r.status === "automated" ? chalk.green(`    \u2705 ${method}${r.route.path}`) : r.status === "both" ? chalk.cyan(`    \u2B50 ${method}${r.route.path}`) : chalk.blue(`    \u{1F535} ${method}${r.route.path}`);
+        console.log(routeLine);
+        for (const t of r.automatedTests) {
+          const file = t.filePath ? chalk.dim(` (${path.basename(t.filePath)})`) : "";
+          console.log(chalk.green(`       \u2192 "${t.title}"`) + file);
+        }
+        for (const t of r.manualTests) {
+          const src = chalk.dim(` (${t.source})`);
+          console.log(chalk.blue(`       \u2192 "${t.title}"`) + src);
+        }
+      }
+    }
+    if (uncategorised.length > 0) {
+      console.log(chalk.dim(`
+  Uncategorised`));
+      for (const r of uncategorised) {
+        const method = r.route.method ? chalk.dim(`${r.route.method} `) : "";
+        console.log(
+          r.status === "none" ? chalk.red(`    \u274C ${method}${r.route.path}`) : chalk.dim(`    \xB7 ${method}${r.route.path}`)
+        );
+        for (const t of r.automatedTests) {
+          const file = t.filePath ? chalk.dim(` (${path.basename(t.filePath)})`) : "";
+          console.log(chalk.green(`       \u2192 "${t.title}"`) + file);
+        }
+        for (const t of r.manualTests) {
+          console.log(chalk.blue(`       \u2192 "${t.title}"`) + chalk.dim(` (${t.source})`));
+        }
+      }
+    }
+    if (noCoverage.length > 0) {
+      console.log(chalk.red(`
+No coverage (${noCoverage.length} routes): `) + noCoverage.map((r) => chalk.red(r.route.path)).join(", "));
+    }
+    if (stale.length > 0) {
+      console.log(chalk.yellow(`
+Stale manual coverage (${stale.length} routes):`));
+      stale.forEach((r) => {
+        const days = r.lastTestedAt ? Math.round((Date.now() - r.lastTestedAt.getTime()) / 864e5) : "?";
+        console.log(chalk.yellow(`  \u26A0\uFE0F  ${r.route.path.padEnd(40)} \u2014 last tested ${days}d ago`));
+      });
+    }
+    if (report.unmatchedTests.length > 0) {
+      console.log(chalk.magenta(`
+Orphaned tests \u2014 matched no route (${report.unmatchedTests.length}):`));
+      for (const t of report.unmatchedTests) {
+        const file = t.filePath ? chalk.dim(` (${path.basename(t.filePath)})`) : "";
+        console.log(chalk.magenta(`  \u26A0  "${t.title}"`) + file);
+      }
+    }
+    console.log();
+  }
+  // Colours a string based on a numeric coverage percentage threshold
+  colourise(percent, str) {
+    if (percent >= 80) return chalk.green(str);
+    if (percent >= 50) return chalk.yellow(str);
+    return chalk.red(str);
+  }
+};
+export {
+  ConsoleReporter
+};
+//# sourceMappingURL=console.reporter.mjs.map

package/dist/reporters/console.reporter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/reporters/console.reporter.ts","../../src/reporters/base.reporter.ts"],"sourcesContent":["/**\n * src/reporters/console.reporter.ts\n * Pretty terminal output using chalk.\n * Kept concise — this is a summary, not the full report.\n */\n\nimport * as path from 'path'\nimport chalk from 'chalk'\nimport { BaseReporter } from './base.reporter'\nimport { CoverageReport } from '../core/types'\n\nexport class ConsoleReporter extends BaseReporter {\n  readonly name = 'console'\n\n  async write(report: CoverageReport, _outputDir: string): Promise<void> {\n    const { summary, areas, uncategorised } = report\n    const allRoutes = [...areas.flatMap(a => a.routes), ...uncategorised]\n    const noCoverage = allRoutes.filter(r => r.status === 'none')\n    const stale = allRoutes.filter(r => r.staleness === 'stale')\n\n    // ── Summary line ─────────────────────────────────────────────────────────\n    const totalColoured = this.colourise(summary.totalCoverage, `${summary.totalCoverage}%`)\n    console.log(\n      `\\nqualitylens: ${totalColoured} total` +\n      `  (${chalk.cyan(summary.automatedCoverage + '%')} auto` +\n      ` · ${chalk.magenta(summary.manualOnlyCoverage + '%')} manual` +\n      ` · ${chalk.red(summary.noCoverage + '%')} none)\\n`\n    )\n\n    // ── Per-area breakdown with route + test traceability ────────────────────\n    for (const area of areas) {\n      const filled = Math.round(area.coveragePercent / 5)\n      const bar = this.colourise(\n        area.coveragePercent,\n        '█'.repeat(filled) + '░'.repeat(20 - filled)\n      )\n      const pct = this.colourise(area.coveragePercent, `${area.coveragePercent}%`)\n      console.log(`\\n  ${area.name.padEnd(24)} ${bar} ${pct}`)\n\n      for (const r of area.routes) {\n        const method = r.route.method ? chalk.dim(`${r.route.method} `) : ''\n        const routeLine = r.status === 'none'\n          ? chalk.red(`    ❌ ${method}${r.route.path}`)\n          : r.status === 'automated'\n            ? chalk.green(`    ✅ ${method}${r.route.path}`)\n            : r.status === 'both'\n              ? chalk.cyan(`    ⭐ ${method}${r.route.path}`)\n              : chalk.blue(`    🔵 ${method}${r.route.path}`)\n        console.log(routeLine)\n\n        for (const t of r.automatedTests) {\n          const file = t.filePath ? chalk.dim(` (${path.basename(t.filePath)})`) : ''\n          console.log(chalk.green(`       → \"${t.title}\"`) + file)\n        }\n        for (const t of r.manualTests) {\n          const src = chalk.dim(` (${t.source})`)\n          console.log(chalk.blue(`       → \"${t.title}\"`) + src)\n        }\n      }\n    }\n\n    // ── Uncategorised routes ──────────────────────────────────────────────────\n    if (uncategorised.length > 0) {\n      console.log(chalk.dim(`\\n  Uncategorised`))\n      for (const r of uncategorised) {\n        const method = r.route.method ? chalk.dim(`${r.route.method} `) : ''\n        console.log(r.status === 'none'\n          ? chalk.red(`    ❌ ${method}${r.route.path}`)\n          : chalk.dim(`    · ${method}${r.route.path}`)\n        )\n        for (const t of r.automatedTests) {\n          const file = t.filePath ? chalk.dim(` (${path.basename(t.filePath)})`) : ''\n          console.log(chalk.green(`       → \"${t.title}\"`) + file)\n        }\n        for (const t of r.manualTests) {\n          console.log(chalk.blue(`       → \"${t.title}\"`) + chalk.dim(` (${t.source})`))\n        }\n      }\n    }\n\n    // ── No coverage summary ───────────────────────────────────────────────────\n    if (noCoverage.length > 0) {\n      console.log(chalk.red(`\\nNo coverage (${noCoverage.length} routes): `) +\n        noCoverage.map(r => chalk.red(r.route.path)).join(', '))\n    }\n\n    // ── Stale manual coverage list ───────────────────────────────────────────\n    if (stale.length > 0) {\n      console.log(chalk.yellow(`\\nStale manual coverage (${stale.length} routes):`))\n      stale.forEach(r => {\n        const days = r.lastTestedAt\n          ? Math.round((Date.now() - r.lastTestedAt.getTime()) / 86400000)\n          : '?'\n        console.log(chalk.yellow(`  ⚠️  ${r.route.path.padEnd(40)} — last tested ${days}d ago`))\n      })\n    }\n\n    // ── Orphaned tests (matched no route) ────────────────────────────────────\n    if (report.unmatchedTests.length > 0) {\n      console.log(chalk.magenta(`\\nOrphaned tests — matched no route (${report.unmatchedTests.length}):`))\n      for (const t of report.unmatchedTests) {\n        const file = t.filePath ? chalk.dim(` (${path.basename(t.filePath)})`) : ''\n        console.log(chalk.magenta(`  ⚠  \"${t.title}\"`) + file)\n      }\n    }\n\n    console.log()\n  }\n\n  // Colours a string based on a numeric coverage percentage threshold\n  private colourise(percent: number, str: string): string {\n    if (percent >= 80) return chalk.green(str)\n    if (percent >= 50) return chalk.yellow(str)\n    return chalk.red(str)\n  }\n}\n","/**\n * src/reporters/base.reporter.ts\n * \n * Abstract base class for all reporters.\n * To add a new output format: extend this class, implement write().\n */\n\nimport { CoverageReport } from '../core/types'\n\nexport abstract class BaseReporter {\n  abstract readonly name: string\n\n  /**\n   * Write the report to the given output path.\n   * For console reporter, outputPath may be ignored.\n   */\n  abstract write(report: CoverageReport, outputPath: string): Promise<void>\n}\n"],"mappings":"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","names":[]}

package/dist/sources/base.source.d.mts

@@ -0,0 +1,22 @@
+import { TestEntry } from '../core/types.mjs';
+
+/**
+ * src/sources/base.source.ts
+ *
+ * Abstract base class for all test sources.
+ * To add a new source: extend this class, implement collect().
+ * Sources are stateless — no caching, no shared state.
+ */
+
+declare abstract class BaseSource {
+    abstract readonly name: string;
+    /**
+     * Collect all test entries from this source.
+     * Must never throw — return [] and log a warning on failure.
+     */
+    abstract collect(): Promise<TestEntry[]>;
+    protected log(msg: string): void;
+    protected warn(msg: string, detail?: unknown): void;
+}
+
+export { BaseSource };

package/dist/sources/base.source.d.ts

@@ -0,0 +1,22 @@
+import { TestEntry } from '../core/types.js';
+
+/**
+ * src/sources/base.source.ts
+ *
+ * Abstract base class for all test sources.
+ * To add a new source: extend this class, implement collect().
+ * Sources are stateless — no caching, no shared state.
+ */
+
+declare abstract class BaseSource {
+    abstract readonly name: string;
+    /**
+     * Collect all test entries from this source.
+     * Must never throw — return [] and log a warning on failure.
+     */
+    abstract collect(): Promise<TestEntry[]>;
+    protected log(msg: string): void;
+    protected warn(msg: string, detail?: unknown): void;
+}
+
+export { BaseSource };

package/dist/sources/base.source.js

@@ -0,0 +1,130 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/sources/base.source.ts
+var base_source_exports = {};
+__export(base_source_exports, {
+  BaseSource: () => BaseSource
+});
+module.exports = __toCommonJS(base_source_exports);
+
+// src/utils/logger.ts
+var fs = __toESM(require("fs"));
+var path = __toESM(require("path"));
+var Logger = class {
+  logPath = null;
+  fd = null;
+  /**
+   * Open (or create) qualitylens.log in the given directory.
+   * Appends to an existing log so multiple runs accumulate history.
+   * Call once at the start of each command.
+   */
+  configure(outputDir) {
+    try {
+      fs.mkdirSync(outputDir, { recursive: true });
+      this.logPath = path.join(outputDir, "qualitylens.log");
+      this.fd = fs.openSync(this.logPath, "a");
+      this.write("INFO", `--- qualitylens session started (pid ${process.pid}) ---`);
+    } catch {
+      this.logPath = null;
+      this.fd = null;
+    }
+  }
+  /** Path to the current log file, or null if not configured. */
+  get filePath() {
+    return this.logPath;
+  }
+  info(msg, detail) {
+    this.write("INFO", msg, detail);
+  }
+  warn(msg, detail) {
+    this.write("WARN", msg, detail);
+  }
+  /** Logs full detail (stack trace, raw error) to file only. */
+  error(msg, detail) {
+    this.write("ERROR", msg, detail);
+  }
+  debug(msg, detail) {
+    this.write("DEBUG", msg, detail);
+  }
+  close() {
+    if (this.fd !== null) {
+      try {
+        fs.closeSync(this.fd);
+      } catch {
+      }
+      this.fd = null;
+    }
+  }
+  write(level, msg, detail) {
+    if (this.fd === null) return;
+    const ts = (/* @__PURE__ */ new Date()).toISOString();
+    let line = `[${ts}] ${level.padEnd(5)} ${msg}`;
+    if (detail !== void 0) {
+      if (detail instanceof Error) {
+        line += `
+  ${detail.message}`;
+        if (detail.stack) {
+          line += "\n" + detail.stack.split("\n").map((l) => "  " + l).join("\n");
+        }
+      } else if (typeof detail === "string" && detail.trim()) {
+        line += "\n" + detail.split("\n").map((l) => "  " + l).join("\n");
+      } else if (typeof detail === "object") {
+        try {
+          line += "\n  " + JSON.stringify(detail, null, 2).replace(/\n/g, "\n  ");
+        } catch {
+        }
+      }
+    }
+    try {
+      fs.writeSync(this.fd, line + "\n");
+    } catch {
+    }
+  }
+};
+var logger = new Logger();
+
+// src/sources/base.source.ts
+var BaseSource = class {
+  log(msg) {
+    process.stdout.write(`  [${this.name}] ${msg}
+`);
+    logger.info(`[${this.name}] ${msg}`);
+  }
+  warn(msg, detail) {
+    process.stderr.write(`  [${this.name}] WARNING: ${msg}
+`);
+    logger.warn(`[${this.name}] ${msg}`, detail);
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BaseSource
+});
+//# sourceMappingURL=base.source.js.map

package/dist/sources/base.source.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/sources/base.source.ts","../../src/utils/logger.ts"],"sourcesContent":["/**\n * src/sources/base.source.ts\n * \n * Abstract base class for all test sources.\n * To add a new source: extend this class, implement collect().\n * Sources are stateless — no caching, no shared state.\n */\n\nimport { TestEntry } from '../core/types'\nimport { logger } from '../utils/logger'\n\nexport abstract class BaseSource {\n  abstract readonly name: string\n\n  /**\n   * Collect all test entries from this source.\n   * Must never throw — return [] and log a warning on failure.\n   */\n  abstract collect(): Promise<TestEntry[]>\n\n  protected log(msg: string): void {\n    process.stdout.write(`  [${this.name}] ${msg}\\n`)\n    logger.info(`[${this.name}] ${msg}`)\n  }\n\n  protected warn(msg: string, detail?: unknown): void {\n    process.stderr.write(`  [${this.name}] WARNING: ${msg}\\n`)\n    logger.warn(`[${this.name}] ${msg}`, detail)\n  }\n}\n","/**\n * src/utils/logger.ts\n *\n * Module-level singleton logger.\n * - Always writes to a log file (qualitylens.log) with timestamps and full detail.\n * - Console output is handled separately by each command — the logger only writes the file.\n *\n * Usage:\n *   import { logger } from './utils/logger'\n *   logger.configure('./reports')        // call once at startup\n *   logger.info('scan started', { config: opts.config })\n *   logger.error('route discovery failed', err)\n */\n\nimport * as fs from 'fs'\nimport * as path from 'path'\n\ntype LogLevel = 'INFO' | 'WARN' | 'ERROR' | 'DEBUG'\n\nclass Logger {\n  private logPath: string | null = null\n  private fd: number | null = null\n\n  /**\n   * Open (or create) qualitylens.log in the given directory.\n   * Appends to an existing log so multiple runs accumulate history.\n   * Call once at the start of each command.\n   */\n  configure(outputDir: string): void {\n    try {\n      fs.mkdirSync(outputDir, { recursive: true })\n      this.logPath = path.join(outputDir, 'qualitylens.log')\n      this.fd = fs.openSync(this.logPath, 'a')\n      this.write('INFO', `--- qualitylens session started (pid ${process.pid}) ---`)\n    } catch {\n      // If we can't open a log file, continue silently — logging is non-blocking\n      this.logPath = null\n      this.fd = null\n    }\n  }\n\n  /** Path to the current log file, or null if not configured. */\n  get filePath(): string | null {\n    return this.logPath\n  }\n\n  info(msg: string, detail?: unknown): void {\n    this.write('INFO', msg, detail)\n  }\n\n  warn(msg: string, detail?: unknown): void {\n    this.write('WARN', msg, detail)\n  }\n\n  /** Logs full detail (stack trace, raw error) to file only. */\n  error(msg: string, detail?: unknown): void {\n    this.write('ERROR', msg, detail)\n  }\n\n  debug(msg: string, detail?: unknown): void {\n    this.write('DEBUG', msg, detail)\n  }\n\n  close(): void {\n    if (this.fd !== null) {\n      try { fs.closeSync(this.fd) } catch { /* ignore */ }\n      this.fd = null\n    }\n  }\n\n  private write(level: LogLevel, msg: string, detail?: unknown): void {\n    if (this.fd === null) return\n\n    const ts = new Date().toISOString()\n    let line = `[${ts}] ${level.padEnd(5)} ${msg}`\n\n    if (detail !== undefined) {\n      if (detail instanceof Error) {\n        line += `\\n  ${detail.message}`\n        if (detail.stack) {\n          line += '\\n' + detail.stack.split('\\n').map(l => '  ' + l).join('\\n')\n        }\n      } else if (typeof detail === 'string' && detail.trim()) {\n        line += '\\n' + detail.split('\\n').map(l => '  ' + l).join('\\n')\n      } else if (typeof detail === 'object') {\n        try {\n          line += '\\n  ' + JSON.stringify(detail, null, 2).replace(/\\n/g, '\\n  ')\n        } catch { /* circular ref or similar — skip */ }\n      }\n    }\n\n    try {\n      fs.writeSync(this.fd, line + '\\n')\n    } catch { /* disk full or fd closed — ignore */ }\n  }\n}\n\nexport const logger = new Logger()\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACcA,SAAoB;AACpB,WAAsB;AAItB,IAAM,SAAN,MAAa;AAAA,EACH,UAAyB;AAAA,EACzB,KAAoB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAO5B,UAAU,WAAyB;AACjC,QAAI;AACF,MAAG,aAAU,WAAW,EAAE,WAAW,KAAK,CAAC;AAC3C,WAAK,UAAe,UAAK,WAAW,iBAAiB;AACrD,WAAK,KAAQ,YAAS,KAAK,SAAS,GAAG;AACvC,WAAK,MAAM,QAAQ,wCAAwC,QAAQ,GAAG,OAAO;AAAA,IAC/E,QAAQ;AAEN,WAAK,UAAU;AACf,WAAK,KAAK;AAAA,IACZ;AAAA,EACF;AAAA;AAAA,EAGA,IAAI,WAA0B;AAC5B,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,KAAK,KAAa,QAAwB;AACxC,SAAK,MAAM,QAAQ,KAAK,MAAM;AAAA,EAChC;AAAA,EAEA,KAAK,KAAa,QAAwB;AACxC,SAAK,MAAM,QAAQ,KAAK,MAAM;AAAA,EAChC;AAAA;AAAA,EAGA,MAAM,KAAa,QAAwB;AACzC,SAAK,MAAM,SAAS,KAAK,MAAM;AAAA,EACjC;AAAA,EAEA,MAAM,KAAa,QAAwB;AACzC,SAAK,MAAM,SAAS,KAAK,MAAM;AAAA,EACjC;AAAA,EAEA,QAAc;AACZ,QAAI,KAAK,OAAO,MAAM;AACpB,UAAI;AAAE,QAAG,aAAU,KAAK,EAAE;AAAA,MAAE,QAAQ;AAAA,MAAe;AACnD,WAAK,KAAK;AAAA,IACZ;AAAA,EACF;AAAA,EAEQ,MAAM,OAAiB,KAAa,QAAwB;AAClE,QAAI,KAAK,OAAO,KAAM;AAEtB,UAAM,MAAK,oBAAI,KAAK,GAAE,YAAY;AAClC,QAAI,OAAO,IAAI,EAAE,KAAK,MAAM,OAAO,CAAC,CAAC,IAAI,GAAG;AAE5C,QAAI,WAAW,QAAW;AACxB,UAAI,kBAAkB,OAAO;AAC3B,gBAAQ;AAAA,IAAO,OAAO,OAAO;AAC7B,YAAI,OAAO,OAAO;AAChB,kBAAQ,OAAO,OAAO,MAAM,MAAM,IAAI,EAAE,IAAI,OAAK,OAAO,CAAC,EAAE,KAAK,IAAI;AAAA,QACtE;AAAA,MACF,WAAW,OAAO,WAAW,YAAY,OAAO,KAAK,GAAG;AACtD,gBAAQ,OAAO,OAAO,MAAM,IAAI,EAAE,IAAI,OAAK,OAAO,CAAC,EAAE,KAAK,IAAI;AAAA,MAChE,WAAW,OAAO,WAAW,UAAU;AACrC,YAAI;AACF,kBAAQ,SAAS,KAAK,UAAU,QAAQ,MAAM,CAAC,EAAE,QAAQ,OAAO,MAAM;AAAA,QACxE,QAAQ;AAAA,QAAuC;AAAA,MACjD;AAAA,IACF;AAEA,QAAI;AACF,MAAG,aAAU,KAAK,IAAI,OAAO,IAAI;AAAA,IACnC,QAAQ;AAAA,IAAwC;AAAA,EAClD;AACF;AAEO,IAAM,SAAS,IAAI,OAAO;;;ADtF1B,IAAe,aAAf,MAA0B;AAAA,EASrB,IAAI,KAAmB;AAC/B,YAAQ,OAAO,MAAM,MAAM,KAAK,IAAI,KAAK,GAAG;AAAA,CAAI;AAChD,WAAO,KAAK,IAAI,KAAK,IAAI,KAAK,GAAG,EAAE;AAAA,EACrC;AAAA,EAEU,KAAK,KAAa,QAAwB;AAClD,YAAQ,OAAO,MAAM,MAAM,KAAK,IAAI,cAAc,GAAG;AAAA,CAAI;AACzD,WAAO,KAAK,IAAI,KAAK,IAAI,KAAK,GAAG,IAAI,MAAM;AAAA,EAC7C;AACF;","names":[]}

package/dist/sources/base.source.mjs

@@ -0,0 +1,93 @@
+// src/utils/logger.ts
+import * as fs from "fs";
+import * as path from "path";
+var Logger = class {
+  logPath = null;
+  fd = null;
+  /**
+   * Open (or create) qualitylens.log in the given directory.
+   * Appends to an existing log so multiple runs accumulate history.
+   * Call once at the start of each command.
+   */
+  configure(outputDir) {
+    try {
+      fs.mkdirSync(outputDir, { recursive: true });
+      this.logPath = path.join(outputDir, "qualitylens.log");
+      this.fd = fs.openSync(this.logPath, "a");
+      this.write("INFO", `--- qualitylens session started (pid ${process.pid}) ---`);
+    } catch {
+      this.logPath = null;
+      this.fd = null;
+    }
+  }
+  /** Path to the current log file, or null if not configured. */
+  get filePath() {
+    return this.logPath;
+  }
+  info(msg, detail) {
+    this.write("INFO", msg, detail);
+  }
+  warn(msg, detail) {
+    this.write("WARN", msg, detail);
+  }
+  /** Logs full detail (stack trace, raw error) to file only. */
+  error(msg, detail) {
+    this.write("ERROR", msg, detail);
+  }
+  debug(msg, detail) {
+    this.write("DEBUG", msg, detail);
+  }
+  close() {
+    if (this.fd !== null) {
+      try {
+        fs.closeSync(this.fd);
+      } catch {
+      }
+      this.fd = null;
+    }
+  }
+  write(level, msg, detail) {
+    if (this.fd === null) return;
+    const ts = (/* @__PURE__ */ new Date()).toISOString();
+    let line = `[${ts}] ${level.padEnd(5)} ${msg}`;
+    if (detail !== void 0) {
+      if (detail instanceof Error) {
+        line += `
+  ${detail.message}`;
+        if (detail.stack) {
+          line += "\n" + detail.stack.split("\n").map((l) => "  " + l).join("\n");
+        }
+      } else if (typeof detail === "string" && detail.trim()) {
+        line += "\n" + detail.split("\n").map((l) => "  " + l).join("\n");
+      } else if (typeof detail === "object") {
+        try {
+          line += "\n  " + JSON.stringify(detail, null, 2).replace(/\n/g, "\n  ");
+        } catch {
+        }
+      }
+    }
+    try {
+      fs.writeSync(this.fd, line + "\n");
+    } catch {
+    }
+  }
+};
+var logger = new Logger();
+
+// src/sources/base.source.ts
+var BaseSource = class {
+  log(msg) {
+    process.stdout.write(`  [${this.name}] ${msg}
+`);
+    logger.info(`[${this.name}] ${msg}`);
+  }
+  warn(msg, detail) {
+    process.stderr.write(`  [${this.name}] WARNING: ${msg}
+`);
+    logger.warn(`[${this.name}] ${msg}`, detail);
+  }
+};
+export {
+  BaseSource
+};
+//# sourceMappingURL=base.source.mjs.map

package/dist/sources/base.source.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/logger.ts","../../src/sources/base.source.ts"],"sourcesContent":["/**\n * src/utils/logger.ts\n *\n * Module-level singleton logger.\n * - Always writes to a log file (qualitylens.log) with timestamps and full detail.\n * - Console output is handled separately by each command — the logger only writes the file.\n *\n * Usage:\n *   import { logger } from './utils/logger'\n *   logger.configure('./reports')        // call once at startup\n *   logger.info('scan started', { config: opts.config })\n *   logger.error('route discovery failed', err)\n */\n\nimport * as fs from 'fs'\nimport * as path from 'path'\n\ntype LogLevel = 'INFO' | 'WARN' | 'ERROR' | 'DEBUG'\n\nclass Logger {\n  private logPath: string | null = null\n  private fd: number | null = null\n\n  /**\n   * Open (or create) qualitylens.log in the given directory.\n   * Appends to an existing log so multiple runs accumulate history.\n   * Call once at the start of each command.\n   */\n  configure(outputDir: string): void {\n    try {\n      fs.mkdirSync(outputDir, { recursive: true })\n      this.logPath = path.join(outputDir, 'qualitylens.log')\n      this.fd = fs.openSync(this.logPath, 'a')\n      this.write('INFO', `--- qualitylens session started (pid ${process.pid}) ---`)\n    } catch {\n      // If we can't open a log file, continue silently — logging is non-blocking\n      this.logPath = null\n      this.fd = null\n    }\n  }\n\n  /** Path to the current log file, or null if not configured. */\n  get filePath(): string | null {\n    return this.logPath\n  }\n\n  info(msg: string, detail?: unknown): void {\n    this.write('INFO', msg, detail)\n  }\n\n  warn(msg: string, detail?: unknown): void {\n    this.write('WARN', msg, detail)\n  }\n\n  /** Logs full detail (stack trace, raw error) to file only. */\n  error(msg: string, detail?: unknown): void {\n    this.write('ERROR', msg, detail)\n  }\n\n  debug(msg: string, detail?: unknown): void {\n    this.write('DEBUG', msg, detail)\n  }\n\n  close(): void {\n    if (this.fd !== null) {\n      try { fs.closeSync(this.fd) } catch { /* ignore */ }\n      this.fd = null\n    }\n  }\n\n  private write(level: LogLevel, msg: string, detail?: unknown): void {\n    if (this.fd === null) return\n\n    const ts = new Date().toISOString()\n    let line = `[${ts}] ${level.padEnd(5)} ${msg}`\n\n    if (detail !== undefined) {\n      if (detail instanceof Error) {\n        line += `\\n  ${detail.message}`\n        if (detail.stack) {\n          line += '\\n' + detail.stack.split('\\n').map(l => '  ' + l).join('\\n')\n        }\n      } else if (typeof detail === 'string' && detail.trim()) {\n        line += '\\n' + detail.split('\\n').map(l => '  ' + l).join('\\n')\n      } else if (typeof detail === 'object') {\n        try {\n          line += '\\n  ' + JSON.stringify(detail, null, 2).replace(/\\n/g, '\\n  ')\n        } catch { /* circular ref or similar — skip */ }\n      }\n    }\n\n    try {\n      fs.writeSync(this.fd, line + '\\n')\n    } catch { /* disk full or fd closed — ignore */ }\n  }\n}\n\nexport const logger = new Logger()\n","/**\n * src/sources/base.source.ts\n * \n * Abstract base class for all test sources.\n * To add a new source: extend this class, implement collect().\n * Sources are stateless — no caching, no shared state.\n */\n\nimport { TestEntry } from '../core/types'\nimport { logger } from '../utils/logger'\n\nexport abstract class BaseSource {\n  abstract readonly name: string\n\n  /**\n   * Collect all test entries from this source.\n   * Must never throw — return [] and log a warning on failure.\n   */\n  abstract collect(): Promise<TestEntry[]>\n\n  protected log(msg: string): void {\n    process.stdout.write(`  [${this.name}] ${msg}\\n`)\n    logger.info(`[${this.name}] ${msg}`)\n  }\n\n  protected warn(msg: string, detail?: unknown): void {\n    process.stderr.write(`  [${this.name}] WARNING: ${msg}\\n`)\n    logger.warn(`[${this.name}] ${msg}`, detail)\n  }\n}\n"],"mappings":";AAcA,YAAY,QAAQ;AACpB,YAAY,UAAU;AAItB,IAAM,SAAN,MAAa;AAAA,EACH,UAAyB;AAAA,EACzB,KAAoB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAO5B,UAAU,WAAyB;AACjC,QAAI;AACF,MAAG,aAAU,WAAW,EAAE,WAAW,KAAK,CAAC;AAC3C,WAAK,UAAe,UAAK,WAAW,iBAAiB;AACrD,WAAK,KAAQ,YAAS,KAAK,SAAS,GAAG;AACvC,WAAK,MAAM,QAAQ,wCAAwC,QAAQ,GAAG,OAAO;AAAA,IAC/E,QAAQ;AAEN,WAAK,UAAU;AACf,WAAK,KAAK;AAAA,IACZ;AAAA,EACF;AAAA;AAAA,EAGA,IAAI,WAA0B;AAC5B,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,KAAK,KAAa,QAAwB;AACxC,SAAK,MAAM,QAAQ,KAAK,MAAM;AAAA,EAChC;AAAA,EAEA,KAAK,KAAa,QAAwB;AACxC,SAAK,MAAM,QAAQ,KAAK,MAAM;AAAA,EAChC;AAAA;AAAA,EAGA,MAAM,KAAa,QAAwB;AACzC,SAAK,MAAM,SAAS,KAAK,MAAM;AAAA,EACjC;AAAA,EAEA,MAAM,KAAa,QAAwB;AACzC,SAAK,MAAM,SAAS,KAAK,MAAM;AAAA,EACjC;AAAA,EAEA,QAAc;AACZ,QAAI,KAAK,OAAO,MAAM;AACpB,UAAI;AAAE,QAAG,aAAU,KAAK,EAAE;AAAA,MAAE,QAAQ;AAAA,MAAe;AACnD,WAAK,KAAK;AAAA,IACZ;AAAA,EACF;AAAA,EAEQ,MAAM,OAAiB,KAAa,QAAwB;AAClE,QAAI,KAAK,OAAO,KAAM;AAEtB,UAAM,MAAK,oBAAI,KAAK,GAAE,YAAY;AAClC,QAAI,OAAO,IAAI,EAAE,KAAK,MAAM,OAAO,CAAC,CAAC,IAAI,GAAG;AAE5C,QAAI,WAAW,QAAW;AACxB,UAAI,kBAAkB,OAAO;AAC3B,gBAAQ;AAAA,IAAO,OAAO,OAAO;AAC7B,YAAI,OAAO,OAAO;AAChB,kBAAQ,OAAO,OAAO,MAAM,MAAM,IAAI,EAAE,IAAI,OAAK,OAAO,CAAC,EAAE,KAAK,IAAI;AAAA,QACtE;AAAA,MACF,WAAW,OAAO,WAAW,YAAY,OAAO,KAAK,GAAG;AACtD,gBAAQ,OAAO,OAAO,MAAM,IAAI,EAAE,IAAI,OAAK,OAAO,CAAC,EAAE,KAAK,IAAI;AAAA,MAChE,WAAW,OAAO,WAAW,UAAU;AACrC,YAAI;AACF,kBAAQ,SAAS,KAAK,UAAU,QAAQ,MAAM,CAAC,EAAE,QAAQ,OAAO,MAAM;AAAA,QACxE,QAAQ;AAAA,QAAuC;AAAA,MACjD;AAAA,IACF;AAEA,QAAI;AACF,MAAG,aAAU,KAAK,IAAI,OAAO,IAAI;AAAA,IACnC,QAAQ;AAAA,IAAwC;AAAA,EAClD;AACF;AAEO,IAAM,SAAS,IAAI,OAAO;;;ACtF1B,IAAe,aAAf,MAA0B;AAAA,EASrB,IAAI,KAAmB;AAC/B,YAAQ,OAAO,MAAM,MAAM,KAAK,IAAI,KAAK,GAAG;AAAA,CAAI;AAChD,WAAO,KAAK,IAAI,KAAK,IAAI,KAAK,GAAG,EAAE;AAAA,EACrC;AAAA,EAEU,KAAK,KAAa,QAAwB;AAClD,YAAQ,OAAO,MAAM,MAAM,KAAK,IAAI,cAAc,GAAG;AAAA,CAAI;AACzD,WAAO,KAAK,IAAI,KAAK,IAAI,KAAK,GAAG,IAAI,MAAM;AAAA,EAC7C;AACF;","names":[]}