@democratize-quality/qualitylens-core 0.1.0

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

@@ -0,0 +1,34 @@
+import { BaseSource } from './base.source.mjs';
+import { TestEntry } from '../core/types.mjs';
+
+/**
+ * src/sources/playwright.source.ts
+ *
+ * Reads Playwright test files and extracts test titles via AST parsing.
+ * Uses @typescript-eslint/parser — NOT regex — for reliability.
+ *
+ * AI INSTRUCTIONS (Claude Code / Copilot):
+ * Implement the collect() method using the skeleton and comments below.
+ * Do not change the class signature or constructor shape.
+ */
+
+declare class PlaywrightSource extends BaseSource {
+    private rootDir;
+    readonly name = "playwright";
+    constructor(rootDir: string);
+    collect(): Promise<TestEntry[]>;
+    /**
+     * AI INSTRUCTIONS:
+     * Parse the source string using @typescript-eslint/parser.
+     * Walk the AST recursively (write a helper walkNode(node, visitor)).
+     * Find CallExpression nodes where:
+     *   - callee.type === 'Identifier' && callee.name === 'test' or 'it'
+     *   - OR callee.type === 'MemberExpression' && callee.property.name === 'only' or 'skip'
+     * Extract the first argument as a string literal title.
+     * Return one TestEntry per title found.
+     */
+    private extractTestTitles;
+    private getCalleeName;
+}
+
+export { PlaywrightSource };

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

@@ -0,0 +1,34 @@
+import { BaseSource } from './base.source.js';
+import { TestEntry } from '../core/types.js';
+
+/**
+ * src/sources/playwright.source.ts
+ *
+ * Reads Playwright test files and extracts test titles via AST parsing.
+ * Uses @typescript-eslint/parser — NOT regex — for reliability.
+ *
+ * AI INSTRUCTIONS (Claude Code / Copilot):
+ * Implement the collect() method using the skeleton and comments below.
+ * Do not change the class signature or constructor shape.
+ */
+
+declare class PlaywrightSource extends BaseSource {
+    private rootDir;
+    readonly name = "playwright";
+    constructor(rootDir: string);
+    collect(): Promise<TestEntry[]>;
+    /**
+     * AI INSTRUCTIONS:
+     * Parse the source string using @typescript-eslint/parser.
+     * Walk the AST recursively (write a helper walkNode(node, visitor)).
+     * Find CallExpression nodes where:
+     *   - callee.type === 'Identifier' && callee.name === 'test' or 'it'
+     *   - OR callee.type === 'MemberExpression' && callee.property.name === 'only' or 'skip'
+     * Extract the first argument as a string literal title.
+     * Return one TestEntry per title found.
+     */
+    private extractTestTitles;
+    private getCalleeName;
+}
+
+export { PlaywrightSource };

package/dist/sources/playwright.source.js

@@ -0,0 +1,209 @@
+"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/playwright.source.ts
+var playwright_source_exports = {};
+__export(playwright_source_exports, {
+  PlaywrightSource: () => PlaywrightSource
+});
+module.exports = __toCommonJS(playwright_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);
+  }
+};
+
+// src/sources/playwright.source.ts
+var path2 = __toESM(require("path"));
+var fs2 = __toESM(require("fs"));
+var import_fast_glob = __toESM(require("fast-glob"));
+var import_parser = require("@typescript-eslint/parser");
+var PlaywrightSource = class extends BaseSource {
+  constructor(rootDir) {
+    super();
+    this.rootDir = rootDir;
+  }
+  name = "playwright";
+  async collect() {
+    const entries = [];
+    const specFiles = await (0, import_fast_glob.default)(["**/*.spec.ts", "**/*.test.ts"], {
+      cwd: this.rootDir,
+      absolute: true,
+      ignore: ["**/node_modules/**", "**/dist/**"]
+    });
+    this.log(`found ${specFiles.length} spec files`);
+    for (const filePath of specFiles) {
+      try {
+        const source = fs2.readFileSync(filePath, "utf-8");
+        const titles = this.extractTestTitles(source, filePath);
+        entries.push(...titles);
+      } catch (err) {
+        this.warn(`skipping ${path2.basename(filePath)}: ${err.message}`);
+      }
+    }
+    this.log(`extracted ${entries.length} test titles`);
+    return entries;
+  }
+  /**
+   * AI INSTRUCTIONS:
+   * Parse the source string using @typescript-eslint/parser.
+   * Walk the AST recursively (write a helper walkNode(node, visitor)).
+   * Find CallExpression nodes where:
+   *   - callee.type === 'Identifier' && callee.name === 'test' or 'it'
+   *   - OR callee.type === 'MemberExpression' && callee.property.name === 'only' or 'skip'
+   * Extract the first argument as a string literal title.
+   * Return one TestEntry per title found.
+   */
+  extractTestTitles(source, filePath) {
+    const ast = (0, import_parser.parse)(source, { jsx: true, range: true });
+    const titles = [];
+    const walkNode = (node) => {
+      if (!node || typeof node !== "object") return;
+      if (node.type === "CallExpression") {
+        const calleeName = this.getCalleeName(node.callee);
+        if (["test", "it", "test.only", "it.only", "test.skip", "it.skip"].includes(calleeName)) {
+          const firstArg = node.arguments?.[0];
+          if (firstArg?.type === "Literal" && typeof firstArg.value === "string") {
+            titles.push(firstArg.value);
+          }
+        }
+      }
+      for (const key of Object.keys(node)) {
+        const child = node[key];
+        if (Array.isArray(child)) {
+          child.forEach(walkNode);
+        } else if (child && typeof child === "object" && child.type) {
+          walkNode(child);
+        }
+      }
+    };
+    walkNode(ast);
+    return titles.map((title) => ({ title, source: "playwright", filePath }));
+  }
+  // Extracts the name from a callee node.
+  // test(...)        → callee is Identifier { name: 'test' }       → 'test'
+  // test.only(...)   → callee is MemberExpression { object: 'test', property: 'only' } → 'test.only'
+  getCalleeName(callee) {
+    if (callee?.type === "Identifier") return callee.name;
+    if (callee?.type === "MemberExpression") {
+      return `${callee.object?.name}.${callee.property?.name}`;
+    }
+    return "";
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PlaywrightSource
+});
+//# sourceMappingURL=playwright.source.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/sources/playwright.source.ts","../../src/utils/logger.ts","../../src/sources/base.source.ts"],"sourcesContent":["/**\n * src/sources/playwright.source.ts\n * \n * Reads Playwright test files and extracts test titles via AST parsing.\n * Uses @typescript-eslint/parser — NOT regex — for reliability.\n * \n * AI INSTRUCTIONS (Claude Code / Copilot):\n * Implement the collect() method using the skeleton and comments below.\n * Do not change the class signature or constructor shape.\n */\n\nimport { BaseSource } from './base.source'\nimport { TestEntry } from '../core/types'\nimport * as path from 'path'\nimport * as fs from 'fs'\nimport glob from 'fast-glob'\n\nimport { parse } from '@typescript-eslint/parser'\n\nexport class PlaywrightSource extends BaseSource {\n  readonly name = 'playwright'\n\n  constructor(private rootDir: string) {\n    super()\n  }\n\n  async collect(): Promise<TestEntry[]> {\n    const entries: TestEntry[] = []\n\n    // Step 1: find all spec files\n    const specFiles = await glob(['**/*.spec.ts', '**/*.test.ts'], {\n      cwd: this.rootDir,\n      absolute: true,\n      ignore: ['**/node_modules/**', '**/dist/**'],\n    })\n\n    this.log(`found ${specFiles.length} spec files`)\n\n    // Step 2: parse each file\n    for (const filePath of specFiles) {\n      try {\n        const source = fs.readFileSync(filePath, 'utf-8')\n        const titles = this.extractTestTitles(source, filePath)\n        entries.push(...titles)\n      } catch (err) {\n        // gracefully skip unparseable files\n        this.warn(`skipping ${path.basename(filePath)}: ${(err as Error).message}`)\n      }\n    }\n\n    this.log(`extracted ${entries.length} test titles`)\n    return entries\n  }\n\n  /**\n   * AI INSTRUCTIONS:\n   * Parse the source string using @typescript-eslint/parser.\n   * Walk the AST recursively (write a helper walkNode(node, visitor)).\n   * Find CallExpression nodes where:\n   *   - callee.type === 'Identifier' && callee.name === 'test' or 'it'\n   *   - OR callee.type === 'MemberExpression' && callee.property.name === 'only' or 'skip'\n   * Extract the first argument as a string literal title.\n   * Return one TestEntry per title found.\n   */\n  private extractTestTitles(source: string, filePath: string): TestEntry[] {\n    // Parse the file into an AST (Abstract Syntax Tree).\n    // jsx:true handles .tsx files; range:true attaches character positions (unused but harmless).\n    const ast = parse(source, { jsx: true, range: true })\n    const titles: string[] = []\n\n    // Recursive walker — visits every node in the tree.\n    // We pass a visitor function that runs on each node.\n    const walkNode = (node: any) => {\n      if (!node || typeof node !== 'object') return\n\n      // We're looking for function calls: test('title', ...) or it('title', ...)\n      if (node.type === 'CallExpression') {\n        const calleeName = this.getCalleeName(node.callee)\n        // Match bare calls (test, it) and scoped calls (test.only, test.skip)\n        if (['test', 'it', 'test.only', 'it.only', 'test.skip', 'it.skip'].includes(calleeName)) {\n          const firstArg = node.arguments?.[0]\n          // Only grab plain string literals — skip template literals and variables\n          if (firstArg?.type === 'Literal' && typeof firstArg.value === 'string') {\n            titles.push(firstArg.value)\n          }\n        }\n      }\n\n      // Walk all child properties of this node\n      for (const key of Object.keys(node)) {\n        const child = node[key]\n        if (Array.isArray(child)) {\n          child.forEach(walkNode)\n        } else if (child && typeof child === 'object' && child.type) {\n          walkNode(child)\n        }\n      }\n    }\n\n    walkNode(ast)\n    return titles.map(title => ({ title, source: 'playwright' as const, filePath }))\n  }\n\n  // Extracts the name from a callee node.\n  // test(...)        → callee is Identifier { name: 'test' }       → 'test'\n  // test.only(...)   → callee is MemberExpression { object: 'test', property: 'only' } → 'test.only'\n  private getCalleeName(callee: any): string {\n    if (callee?.type === 'Identifier') return callee.name\n    if (callee?.type === 'MemberExpression') {\n      return `${callee.object?.name}.${callee.property?.name}`\n    }\n    return ''\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","/**\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":"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","names":["path","fs","glob"]}

package/dist/sources/playwright.source.mjs

@@ -0,0 +1,172 @@
+// 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);
+  }
+};
+
+// src/sources/playwright.source.ts
+import * as path2 from "path";
+import * as fs2 from "fs";
+import glob from "fast-glob";
+import { parse } from "@typescript-eslint/parser";
+var PlaywrightSource = class extends BaseSource {
+  constructor(rootDir) {
+    super();
+    this.rootDir = rootDir;
+  }
+  name = "playwright";
+  async collect() {
+    const entries = [];
+    const specFiles = await glob(["**/*.spec.ts", "**/*.test.ts"], {
+      cwd: this.rootDir,
+      absolute: true,
+      ignore: ["**/node_modules/**", "**/dist/**"]
+    });
+    this.log(`found ${specFiles.length} spec files`);
+    for (const filePath of specFiles) {
+      try {
+        const source = fs2.readFileSync(filePath, "utf-8");
+        const titles = this.extractTestTitles(source, filePath);
+        entries.push(...titles);
+      } catch (err) {
+        this.warn(`skipping ${path2.basename(filePath)}: ${err.message}`);
+      }
+    }
+    this.log(`extracted ${entries.length} test titles`);
+    return entries;
+  }
+  /**
+   * AI INSTRUCTIONS:
+   * Parse the source string using @typescript-eslint/parser.
+   * Walk the AST recursively (write a helper walkNode(node, visitor)).
+   * Find CallExpression nodes where:
+   *   - callee.type === 'Identifier' && callee.name === 'test' or 'it'
+   *   - OR callee.type === 'MemberExpression' && callee.property.name === 'only' or 'skip'
+   * Extract the first argument as a string literal title.
+   * Return one TestEntry per title found.
+   */
+  extractTestTitles(source, filePath) {
+    const ast = parse(source, { jsx: true, range: true });
+    const titles = [];
+    const walkNode = (node) => {
+      if (!node || typeof node !== "object") return;
+      if (node.type === "CallExpression") {
+        const calleeName = this.getCalleeName(node.callee);
+        if (["test", "it", "test.only", "it.only", "test.skip", "it.skip"].includes(calleeName)) {
+          const firstArg = node.arguments?.[0];
+          if (firstArg?.type === "Literal" && typeof firstArg.value === "string") {
+            titles.push(firstArg.value);
+          }
+        }
+      }
+      for (const key of Object.keys(node)) {
+        const child = node[key];
+        if (Array.isArray(child)) {
+          child.forEach(walkNode);
+        } else if (child && typeof child === "object" && child.type) {
+          walkNode(child);
+        }
+      }
+    };
+    walkNode(ast);
+    return titles.map((title) => ({ title, source: "playwright", filePath }));
+  }
+  // Extracts the name from a callee node.
+  // test(...)        → callee is Identifier { name: 'test' }       → 'test'
+  // test.only(...)   → callee is MemberExpression { object: 'test', property: 'only' } → 'test.only'
+  getCalleeName(callee) {
+    if (callee?.type === "Identifier") return callee.name;
+    if (callee?.type === "MemberExpression") {
+      return `${callee.object?.name}.${callee.property?.name}`;
+    }
+    return "";
+  }
+};
+export {
+  PlaywrightSource
+};
+//# sourceMappingURL=playwright.source.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/logger.ts","../../src/sources/base.source.ts","../../src/sources/playwright.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","/**\n * src/sources/playwright.source.ts\n * \n * Reads Playwright test files and extracts test titles via AST parsing.\n * Uses @typescript-eslint/parser — NOT regex — for reliability.\n * \n * AI INSTRUCTIONS (Claude Code / Copilot):\n * Implement the collect() method using the skeleton and comments below.\n * Do not change the class signature or constructor shape.\n */\n\nimport { BaseSource } from './base.source'\nimport { TestEntry } from '../core/types'\nimport * as path from 'path'\nimport * as fs from 'fs'\nimport glob from 'fast-glob'\n\nimport { parse } from '@typescript-eslint/parser'\n\nexport class PlaywrightSource extends BaseSource {\n  readonly name = 'playwright'\n\n  constructor(private rootDir: string) {\n    super()\n  }\n\n  async collect(): Promise<TestEntry[]> {\n    const entries: TestEntry[] = []\n\n    // Step 1: find all spec files\n    const specFiles = await glob(['**/*.spec.ts', '**/*.test.ts'], {\n      cwd: this.rootDir,\n      absolute: true,\n      ignore: ['**/node_modules/**', '**/dist/**'],\n    })\n\n    this.log(`found ${specFiles.length} spec files`)\n\n    // Step 2: parse each file\n    for (const filePath of specFiles) {\n      try {\n        const source = fs.readFileSync(filePath, 'utf-8')\n        const titles = this.extractTestTitles(source, filePath)\n        entries.push(...titles)\n      } catch (err) {\n        // gracefully skip unparseable files\n        this.warn(`skipping ${path.basename(filePath)}: ${(err as Error).message}`)\n      }\n    }\n\n    this.log(`extracted ${entries.length} test titles`)\n    return entries\n  }\n\n  /**\n   * AI INSTRUCTIONS:\n   * Parse the source string using @typescript-eslint/parser.\n   * Walk the AST recursively (write a helper walkNode(node, visitor)).\n   * Find CallExpression nodes where:\n   *   - callee.type === 'Identifier' && callee.name === 'test' or 'it'\n   *   - OR callee.type === 'MemberExpression' && callee.property.name === 'only' or 'skip'\n   * Extract the first argument as a string literal title.\n   * Return one TestEntry per title found.\n   */\n  private extractTestTitles(source: string, filePath: string): TestEntry[] {\n    // Parse the file into an AST (Abstract Syntax Tree).\n    // jsx:true handles .tsx files; range:true attaches character positions (unused but harmless).\n    const ast = parse(source, { jsx: true, range: true })\n    const titles: string[] = []\n\n    // Recursive walker — visits every node in the tree.\n    // We pass a visitor function that runs on each node.\n    const walkNode = (node: any) => {\n      if (!node || typeof node !== 'object') return\n\n      // We're looking for function calls: test('title', ...) or it('title', ...)\n      if (node.type === 'CallExpression') {\n        const calleeName = this.getCalleeName(node.callee)\n        // Match bare calls (test, it) and scoped calls (test.only, test.skip)\n        if (['test', 'it', 'test.only', 'it.only', 'test.skip', 'it.skip'].includes(calleeName)) {\n          const firstArg = node.arguments?.[0]\n          // Only grab plain string literals — skip template literals and variables\n          if (firstArg?.type === 'Literal' && typeof firstArg.value === 'string') {\n            titles.push(firstArg.value)\n          }\n        }\n      }\n\n      // Walk all child properties of this node\n      for (const key of Object.keys(node)) {\n        const child = node[key]\n        if (Array.isArray(child)) {\n          child.forEach(walkNode)\n        } else if (child && typeof child === 'object' && child.type) {\n          walkNode(child)\n        }\n      }\n    }\n\n    walkNode(ast)\n    return titles.map(title => ({ title, source: 'playwright' as const, filePath }))\n  }\n\n  // Extracts the name from a callee node.\n  // test(...)        → callee is Identifier { name: 'test' }       → 'test'\n  // test.only(...)   → callee is MemberExpression { object: 'test', property: 'only' } → 'test.only'\n  private getCalleeName(callee: any): string {\n    if (callee?.type === 'Identifier') return callee.name\n    if (callee?.type === 'MemberExpression') {\n      return `${callee.object?.name}.${callee.property?.name}`\n    }\n    return ''\n  }\n}\n"],"mappings":"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","names":["path","fs"]}

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

@@ -0,0 +1,58 @@
+import { TestGapConfig, AppRoute } from '../core/types.mjs';
+
+/**
+ * src/sources/routes.source.ts
+ *
+ * Discovers application routes from the project structure.
+ * Supports: Next.js pages/, Next.js app/, OpenAPI spec, Express manifest.
+ *
+ * AI INSTRUCTIONS:
+ * Implement each strategy as a private method.
+ * collect() dispatches to the right strategy based on config.type.
+ */
+
+declare class RoutesSource {
+    private config;
+    constructor(config: TestGapConfig['routes']);
+    collect(): Promise<AppRoute[]>;
+    /**
+     * Next.js pages/ or app/ directory scanner.
+     *
+     * AI INSTRUCTIONS:
+     * 1. Glob all .tsx, .ts, .jsx, .js files under config.path
+     * 2. Convert file path to route:
+     *    pages/checkout/payment.tsx   → /checkout/payment
+     *    pages/index.tsx              → /
+     *    pages/auth/[id].tsx          → /auth/:id
+     *    app/checkout/page.tsx        → /checkout  (App Router pattern)
+     * 3. Skip: _app, _document, _error, api/ routes, layout.tsx, loading.tsx
+     * 4. Return AppRoute[]
+     */
+    private collectNextJs;
+    /**
+     * OpenAPI / Swagger spec parser.
+     *
+     * AI INSTRUCTIONS:
+     * 1. Read the JSON or YAML file at config.path
+     * 2. Extract spec.paths object — keys are route paths
+     * 3. For each path, extract HTTP methods (get, post, put, delete, patch)
+     * 4. Return one AppRoute per path+method combination
+     * 5. Support both JSON (.json) and YAML (.yaml, .yml) specs
+     */
+    private collectOpenApi;
+    /**
+     * Express routes manifest (JSON file).
+     * Format: [{ path: '/checkout', method: 'GET' }, ...]
+     * Users generate this with express-list-routes or similar.
+     */
+    private collectExpress;
+    /**
+     * Manual route list in qualitylens.yaml.
+     * config.path points to a JSON file with [{ path: '/route' }]
+     */
+    private collectManual;
+    /** Shared reader for express and manual JSON route manifests. */
+    private readJsonRouteManifest;
+}
+
+export { RoutesSource };

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

@@ -0,0 +1,58 @@
+import { TestGapConfig, AppRoute } from '../core/types.js';
+
+/**
+ * src/sources/routes.source.ts
+ *
+ * Discovers application routes from the project structure.
+ * Supports: Next.js pages/, Next.js app/, OpenAPI spec, Express manifest.
+ *
+ * AI INSTRUCTIONS:
+ * Implement each strategy as a private method.
+ * collect() dispatches to the right strategy based on config.type.
+ */
+
+declare class RoutesSource {
+    private config;
+    constructor(config: TestGapConfig['routes']);
+    collect(): Promise<AppRoute[]>;
+    /**
+     * Next.js pages/ or app/ directory scanner.
+     *
+     * AI INSTRUCTIONS:
+     * 1. Glob all .tsx, .ts, .jsx, .js files under config.path
+     * 2. Convert file path to route:
+     *    pages/checkout/payment.tsx   → /checkout/payment
+     *    pages/index.tsx              → /
+     *    pages/auth/[id].tsx          → /auth/:id
+     *    app/checkout/page.tsx        → /checkout  (App Router pattern)
+     * 3. Skip: _app, _document, _error, api/ routes, layout.tsx, loading.tsx
+     * 4. Return AppRoute[]
+     */
+    private collectNextJs;
+    /**
+     * OpenAPI / Swagger spec parser.
+     *
+     * AI INSTRUCTIONS:
+     * 1. Read the JSON or YAML file at config.path
+     * 2. Extract spec.paths object — keys are route paths
+     * 3. For each path, extract HTTP methods (get, post, put, delete, patch)
+     * 4. Return one AppRoute per path+method combination
+     * 5. Support both JSON (.json) and YAML (.yaml, .yml) specs
+     */
+    private collectOpenApi;
+    /**
+     * Express routes manifest (JSON file).
+     * Format: [{ path: '/checkout', method: 'GET' }, ...]
+     * Users generate this with express-list-routes or similar.
+     */
+    private collectExpress;
+    /**
+     * Manual route list in qualitylens.yaml.
+     * config.path points to a JSON file with [{ path: '/route' }]
+     */
+    private collectManual;
+    /** Shared reader for express and manual JSON route manifests. */
+    private readJsonRouteManifest;
+}
+
+export { RoutesSource };