@democratize-quality/qualitylens-core 0.1.0

package/dist/core/config.d.mts

@@ -0,0 +1,26 @@
+import { TestGapConfig } from './types.mjs';
+
+/**
+ * src/core/config.ts
+ * Loads and validates qualitylens.yaml. Generates starter config for `qualitylens init`.
+ */
+
+interface StarterOptions {
+    projectName: string;
+    routeType: 'nextjs' | 'openapi' | 'express' | 'manual';
+    routesPath: string;
+    generate?: string | null;
+    omitGenerate?: boolean;
+    basePath?: string | null;
+    testsPath?: string | null;
+    areas: Array<{
+        name: string;
+        patterns: string[];
+    }>;
+}
+declare class Config {
+    static load(filePath: string): TestGapConfig;
+    static generateStarter(opts: StarterOptions): string;
+}
+
+export { Config, type StarterOptions };

package/dist/core/config.d.ts

@@ -0,0 +1,26 @@
+import { TestGapConfig } from './types.js';
+
+/**
+ * src/core/config.ts
+ * Loads and validates qualitylens.yaml. Generates starter config for `qualitylens init`.
+ */
+
+interface StarterOptions {
+    projectName: string;
+    routeType: 'nextjs' | 'openapi' | 'express' | 'manual';
+    routesPath: string;
+    generate?: string | null;
+    omitGenerate?: boolean;
+    basePath?: string | null;
+    testsPath?: string | null;
+    areas: Array<{
+        name: string;
+        patterns: string[];
+    }>;
+}
+declare class Config {
+    static load(filePath: string): TestGapConfig;
+    static generateStarter(opts: StarterOptions): string;
+}
+
+export { Config, type StarterOptions };

package/dist/core/config.js

@@ -0,0 +1,139 @@
+"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/core/config.ts
+var config_exports = {};
+__export(config_exports, {
+  Config: () => Config
+});
+module.exports = __toCommonJS(config_exports);
+var fs = __toESM(require("fs"));
+var yaml = __toESM(require("js-yaml"));
+var Config = class {
+  static load(filePath) {
+    if (!fs.existsSync(filePath)) {
+      throw new Error(
+        `qualitylens.yaml not found at ${filePath}
+Run 'qualitylens init' to create one.`
+      );
+    }
+    const raw = yaml.load(fs.readFileSync(filePath, "utf-8"));
+    if (!raw.projectName) throw new Error("qualitylens.yaml: projectName is required");
+    if (!raw.routes) throw new Error("qualitylens.yaml: routes is required");
+    if (!raw.routes.type) throw new Error("qualitylens.yaml: routes.type is required");
+    if (!raw.routes.path) throw new Error("qualitylens.yaml: routes.path is required");
+    if (!raw.areas || raw.areas.length === 0) {
+      throw new Error("qualitylens.yaml: at least one area is required");
+    }
+    return {
+      ...raw,
+      projectName: raw.projectName,
+      routes: raw.routes,
+      areas: raw.areas,
+      staleThresholdDays: raw.staleThresholdDays ?? 30,
+      manualCoverage: raw.manualCoverage ?? [],
+      thresholds: raw.thresholds ?? [],
+      testHints: raw.testHints ?? []
+    };
+  }
+  static generateStarter(opts) {
+    const areasYaml = opts.areas.length > 0 ? opts.areas.map((a) => [
+      `  - name: ${a.name}`,
+      `    patterns:`,
+      ...a.patterns.map((p) => `      - ${p}`)
+    ].join("\n")).join("\n\n") : [
+      `  - name: API`,
+      `    patterns:`,
+      `      - /api`
+    ].join("\n");
+    const generateLine = opts.omitGenerate ? null : opts.generate ? `  generate: ${opts.generate}   # runs before route discovery to produce openapi.json` : `  # generate: npm run generate:openapi   # uncomment if your spec is generated at build time`;
+    const basePathLine = opts.basePath ? `  basePath: ${opts.basePath}   # prefix stripped when grouping routes into areas` : `  # basePath: /api   # uncomment and set if your routes share a common prefix (e.g. /api, /api/v1)`;
+    const testsSection = opts.testsPath ? `
+tests:
+  path: ${opts.testsPath}   # directory scanned for *.spec.ts / *.test.ts
+` : `
+# tests:
+#   path: ./e2e   # uncomment to specify a test directory (default: same folder as this file)
+`;
+    return `# qualitylens.yaml \u2014 generated by 'qualitylens init'
+# Run 'qualitylens scan' to generate your first coverage report.
+
+projectName: ${opts.projectName}
+
+# Days before a manual test entry is flagged as stale
+staleThresholdDays: 30
+
+routes:
+  type: ${opts.routeType}
+  path: ${opts.routesPath}
+${generateLine != null ? generateLine + "\n" : ""}${basePathLine}
+${testsSection}
+areas:
+${areasYaml}
+
+# Optional: Azure DevOps Test Plans integration
+# ado:
+#   orgUrl: https://dev.azure.com/your-org
+#   project: YourProject
+#   planId: 42
+#   patEnvVar: ADO_PAT
+
+# Optional: manual coverage entries
+# manualCoverage:
+#   - route: /your-route
+#     lastTested: 2026-01-01
+#     tester: your-name
+
+# Optional: CI gates
+# thresholds:
+#   - area: "*"
+#     minCoverage: 50
+
+# Optional: test hints (Pro) \u2014 resolve orphaned tests, flag route gaps, acknowledge stale tests
+# Run 'qualitylens hint add' or 'qualitylens orphans' to manage this section
+# testHints:
+#   - test: "Sign out after registration"
+#     status: resolved       # resolved | gap | acknowledged | ignore
+#     route: /login
+#     reason: Sign out is part of the authentication flow
+#     confidence: high
+#     resolvedBy: agent
+#   - test: "DELETE /users/:id returns 404"
+#     status: gap
+#     route: /users/:id
+#     method: DELETE
+#     reason: Route not in OpenAPI spec \u2014 missing implementation or undocumented
+`;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Config
+});
+//# sourceMappingURL=config.js.map

package/dist/core/config.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/config.ts"],"sourcesContent":["/**\n * src/core/config.ts\n * Loads and validates qualitylens.yaml. Generates starter config for `qualitylens init`.\n */\n\nimport * as fs from 'fs'\nimport * as yaml from 'js-yaml'\nimport { TestGapConfig } from './types'\n\nexport interface StarterOptions {\n  projectName: string\n  routeType: 'nextjs' | 'openapi' | 'express' | 'manual'\n  routesPath: string\n  generate?: string | null\n  omitGenerate?: boolean          // true = spec file already exists, skip generate line entirely\n  basePath?: string | null\n  testsPath?: string | null\n  areas: Array<{ name: string; patterns: string[] }>\n}\n\nexport class Config {\n  static load(filePath: string): TestGapConfig {\n    if (!fs.existsSync(filePath)) {\n      throw new Error(\n        `qualitylens.yaml not found at ${filePath}\\n` +\n        `Run 'qualitylens init' to create one.`\n      )\n    }\n\n    const raw = yaml.load(fs.readFileSync(filePath, 'utf-8')) as Partial<TestGapConfig>\n\n    // Validate required fields\n    if (!raw.projectName) throw new Error('qualitylens.yaml: projectName is required')\n    if (!raw.routes) throw new Error('qualitylens.yaml: routes is required')\n    if (!raw.routes.type) throw new Error('qualitylens.yaml: routes.type is required')\n    if (!raw.routes.path) throw new Error('qualitylens.yaml: routes.path is required')\n    if (!raw.areas || raw.areas.length === 0) {\n      throw new Error('qualitylens.yaml: at least one area is required')\n    }\n\n    // Apply defaults\n    return {\n      ...raw,\n      projectName: raw.projectName,\n      routes: raw.routes,\n      areas: raw.areas,\n      staleThresholdDays: raw.staleThresholdDays ?? 30,\n      manualCoverage: raw.manualCoverage ?? [],\n      thresholds: raw.thresholds ?? [],\n      testHints: raw.testHints ?? [],\n    }\n  }\n\n  static generateStarter(opts: StarterOptions): string {\n    const areasYaml = opts.areas.length > 0\n      ? opts.areas.map(a => [\n          `  - name: ${a.name}`,\n          `    patterns:`,\n          ...a.patterns.map(p => `      - ${p}`),\n        ].join('\\n')).join('\\n\\n')\n      : [\n          `  - name: API`,\n          `    patterns:`,\n          `      - /api`,\n        ].join('\\n')\n\n    const generateLine = opts.omitGenerate\n      ? null\n      : opts.generate\n        ? `  generate: ${opts.generate}   # runs before route discovery to produce openapi.json`\n        : `  # generate: npm run generate:openapi   # uncomment if your spec is generated at build time`\n\n    const basePathLine = opts.basePath\n      ? `  basePath: ${opts.basePath}   # prefix stripped when grouping routes into areas`\n      : `  # basePath: /api   # uncomment and set if your routes share a common prefix (e.g. /api, /api/v1)`\n\n    const testsSection = opts.testsPath\n      ? `\\ntests:\\n  path: ${opts.testsPath}   # directory scanned for *.spec.ts / *.test.ts\\n`\n      : `\\n# tests:\\n#   path: ./e2e   # uncomment to specify a test directory (default: same folder as this file)\\n`\n\n    return `# qualitylens.yaml — generated by 'qualitylens init'\n# Run 'qualitylens scan' to generate your first coverage report.\n\nprojectName: ${opts.projectName}\n\n# Days before a manual test entry is flagged as stale\nstaleThresholdDays: 30\n\nroutes:\n  type: ${opts.routeType}\n  path: ${opts.routesPath}\n${generateLine != null ? generateLine + '\\n' : ''}${basePathLine}\n${testsSection}\nareas:\n${areasYaml}\n\n# Optional: Azure DevOps Test Plans integration\n# ado:\n#   orgUrl: https://dev.azure.com/your-org\n#   project: YourProject\n#   planId: 42\n#   patEnvVar: ADO_PAT\n\n# Optional: manual coverage entries\n# manualCoverage:\n#   - route: /your-route\n#     lastTested: 2026-01-01\n#     tester: your-name\n\n# Optional: CI gates\n# thresholds:\n#   - area: \"*\"\n#     minCoverage: 50\n\n# Optional: test hints (Pro) — resolve orphaned tests, flag route gaps, acknowledge stale tests\n# Run 'qualitylens hint add' or 'qualitylens orphans' to manage this section\n# testHints:\n#   - test: \"Sign out after registration\"\n#     status: resolved       # resolved | gap | acknowledged | ignore\n#     route: /login\n#     reason: Sign out is part of the authentication flow\n#     confidence: high\n#     resolvedBy: agent\n#   - test: \"DELETE /users/:id returns 404\"\n#     status: gap\n#     route: /users/:id\n#     method: DELETE\n#     reason: Route not in OpenAPI spec — missing implementation or undocumented\n`\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAKA,SAAoB;AACpB,WAAsB;AAcf,IAAM,SAAN,MAAa;AAAA,EAClB,OAAO,KAAK,UAAiC;AAC3C,QAAI,CAAI,cAAW,QAAQ,GAAG;AAC5B,YAAM,IAAI;AAAA,QACR,iCAAiC,QAAQ;AAAA;AAAA,MAE3C;AAAA,IACF;AAEA,UAAM,MAAW,UAAQ,gBAAa,UAAU,OAAO,CAAC;AAGxD,QAAI,CAAC,IAAI,YAAa,OAAM,IAAI,MAAM,2CAA2C;AACjF,QAAI,CAAC,IAAI,OAAQ,OAAM,IAAI,MAAM,sCAAsC;AACvE,QAAI,CAAC,IAAI,OAAO,KAAM,OAAM,IAAI,MAAM,2CAA2C;AACjF,QAAI,CAAC,IAAI,OAAO,KAAM,OAAM,IAAI,MAAM,2CAA2C;AACjF,QAAI,CAAC,IAAI,SAAS,IAAI,MAAM,WAAW,GAAG;AACxC,YAAM,IAAI,MAAM,iDAAiD;AAAA,IACnE;AAGA,WAAO;AAAA,MACL,GAAG;AAAA,MACH,aAAa,IAAI;AAAA,MACjB,QAAQ,IAAI;AAAA,MACZ,OAAO,IAAI;AAAA,MACX,oBAAoB,IAAI,sBAAsB;AAAA,MAC9C,gBAAgB,IAAI,kBAAkB,CAAC;AAAA,MACvC,YAAY,IAAI,cAAc,CAAC;AAAA,MAC/B,WAAW,IAAI,aAAa,CAAC;AAAA,IAC/B;AAAA,EACF;AAAA,EAEA,OAAO,gBAAgB,MAA8B;AACnD,UAAM,YAAY,KAAK,MAAM,SAAS,IAClC,KAAK,MAAM,IAAI,OAAK;AAAA,MAClB,aAAa,EAAE,IAAI;AAAA,MACnB;AAAA,MACA,GAAG,EAAE,SAAS,IAAI,OAAK,WAAW,CAAC,EAAE;AAAA,IACvC,EAAE,KAAK,IAAI,CAAC,EAAE,KAAK,MAAM,IACzB;AAAA,MACE;AAAA,MACA;AAAA,MACA;AAAA,IACF,EAAE,KAAK,IAAI;AAEf,UAAM,eAAe,KAAK,eACtB,OACA,KAAK,WACH,eAAe,KAAK,QAAQ,6DAC5B;AAEN,UAAM,eAAe,KAAK,WACtB,eAAe,KAAK,QAAQ,yDAC5B;AAEJ,UAAM,eAAe,KAAK,YACtB;AAAA;AAAA,UAAqB,KAAK,SAAS;AAAA,IACnC;AAAA;AAAA;AAAA;AAEJ,WAAO;AAAA;AAAA;AAAA,eAGI,KAAK,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,UAMrB,KAAK,SAAS;AAAA,UACd,KAAK,UAAU;AAAA,EACvB,gBAAgB,OAAO,eAAe,OAAO,EAAE,GAAG,YAAY;AAAA,EAC9D,YAAY;AAAA;AAAA,EAEZ,SAAS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAmCT;AACF;","names":[]}

package/dist/core/config.mjs

@@ -0,0 +1,104 @@
+// src/core/config.ts
+import * as fs from "fs";
+import * as yaml from "js-yaml";
+var Config = class {
+  static load(filePath) {
+    if (!fs.existsSync(filePath)) {
+      throw new Error(
+        `qualitylens.yaml not found at ${filePath}
+Run 'qualitylens init' to create one.`
+      );
+    }
+    const raw = yaml.load(fs.readFileSync(filePath, "utf-8"));
+    if (!raw.projectName) throw new Error("qualitylens.yaml: projectName is required");
+    if (!raw.routes) throw new Error("qualitylens.yaml: routes is required");
+    if (!raw.routes.type) throw new Error("qualitylens.yaml: routes.type is required");
+    if (!raw.routes.path) throw new Error("qualitylens.yaml: routes.path is required");
+    if (!raw.areas || raw.areas.length === 0) {
+      throw new Error("qualitylens.yaml: at least one area is required");
+    }
+    return {
+      ...raw,
+      projectName: raw.projectName,
+      routes: raw.routes,
+      areas: raw.areas,
+      staleThresholdDays: raw.staleThresholdDays ?? 30,
+      manualCoverage: raw.manualCoverage ?? [],
+      thresholds: raw.thresholds ?? [],
+      testHints: raw.testHints ?? []
+    };
+  }
+  static generateStarter(opts) {
+    const areasYaml = opts.areas.length > 0 ? opts.areas.map((a) => [
+      `  - name: ${a.name}`,
+      `    patterns:`,
+      ...a.patterns.map((p) => `      - ${p}`)
+    ].join("\n")).join("\n\n") : [
+      `  - name: API`,
+      `    patterns:`,
+      `      - /api`
+    ].join("\n");
+    const generateLine = opts.omitGenerate ? null : opts.generate ? `  generate: ${opts.generate}   # runs before route discovery to produce openapi.json` : `  # generate: npm run generate:openapi   # uncomment if your spec is generated at build time`;
+    const basePathLine = opts.basePath ? `  basePath: ${opts.basePath}   # prefix stripped when grouping routes into areas` : `  # basePath: /api   # uncomment and set if your routes share a common prefix (e.g. /api, /api/v1)`;
+    const testsSection = opts.testsPath ? `
+tests:
+  path: ${opts.testsPath}   # directory scanned for *.spec.ts / *.test.ts
+` : `
+# tests:
+#   path: ./e2e   # uncomment to specify a test directory (default: same folder as this file)
+`;
+    return `# qualitylens.yaml \u2014 generated by 'qualitylens init'
+# Run 'qualitylens scan' to generate your first coverage report.
+
+projectName: ${opts.projectName}
+
+# Days before a manual test entry is flagged as stale
+staleThresholdDays: 30
+
+routes:
+  type: ${opts.routeType}
+  path: ${opts.routesPath}
+${generateLine != null ? generateLine + "\n" : ""}${basePathLine}
+${testsSection}
+areas:
+${areasYaml}
+
+# Optional: Azure DevOps Test Plans integration
+# ado:
+#   orgUrl: https://dev.azure.com/your-org
+#   project: YourProject
+#   planId: 42
+#   patEnvVar: ADO_PAT
+
+# Optional: manual coverage entries
+# manualCoverage:
+#   - route: /your-route
+#     lastTested: 2026-01-01
+#     tester: your-name
+
+# Optional: CI gates
+# thresholds:
+#   - area: "*"
+#     minCoverage: 50
+
+# Optional: test hints (Pro) \u2014 resolve orphaned tests, flag route gaps, acknowledge stale tests
+# Run 'qualitylens hint add' or 'qualitylens orphans' to manage this section
+# testHints:
+#   - test: "Sign out after registration"
+#     status: resolved       # resolved | gap | acknowledged | ignore
+#     route: /login
+#     reason: Sign out is part of the authentication flow
+#     confidence: high
+#     resolvedBy: agent
+#   - test: "DELETE /users/:id returns 404"
+#     status: gap
+#     route: /users/:id
+#     method: DELETE
+#     reason: Route not in OpenAPI spec \u2014 missing implementation or undocumented
+`;
+  }
+};
+export {
+  Config
+};
+//# sourceMappingURL=config.mjs.map

package/dist/core/config.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/config.ts"],"sourcesContent":["/**\n * src/core/config.ts\n * Loads and validates qualitylens.yaml. Generates starter config for `qualitylens init`.\n */\n\nimport * as fs from 'fs'\nimport * as yaml from 'js-yaml'\nimport { TestGapConfig } from './types'\n\nexport interface StarterOptions {\n  projectName: string\n  routeType: 'nextjs' | 'openapi' | 'express' | 'manual'\n  routesPath: string\n  generate?: string | null\n  omitGenerate?: boolean          // true = spec file already exists, skip generate line entirely\n  basePath?: string | null\n  testsPath?: string | null\n  areas: Array<{ name: string; patterns: string[] }>\n}\n\nexport class Config {\n  static load(filePath: string): TestGapConfig {\n    if (!fs.existsSync(filePath)) {\n      throw new Error(\n        `qualitylens.yaml not found at ${filePath}\\n` +\n        `Run 'qualitylens init' to create one.`\n      )\n    }\n\n    const raw = yaml.load(fs.readFileSync(filePath, 'utf-8')) as Partial<TestGapConfig>\n\n    // Validate required fields\n    if (!raw.projectName) throw new Error('qualitylens.yaml: projectName is required')\n    if (!raw.routes) throw new Error('qualitylens.yaml: routes is required')\n    if (!raw.routes.type) throw new Error('qualitylens.yaml: routes.type is required')\n    if (!raw.routes.path) throw new Error('qualitylens.yaml: routes.path is required')\n    if (!raw.areas || raw.areas.length === 0) {\n      throw new Error('qualitylens.yaml: at least one area is required')\n    }\n\n    // Apply defaults\n    return {\n      ...raw,\n      projectName: raw.projectName,\n      routes: raw.routes,\n      areas: raw.areas,\n      staleThresholdDays: raw.staleThresholdDays ?? 30,\n      manualCoverage: raw.manualCoverage ?? [],\n      thresholds: raw.thresholds ?? [],\n      testHints: raw.testHints ?? [],\n    }\n  }\n\n  static generateStarter(opts: StarterOptions): string {\n    const areasYaml = opts.areas.length > 0\n      ? opts.areas.map(a => [\n          `  - name: ${a.name}`,\n          `    patterns:`,\n          ...a.patterns.map(p => `      - ${p}`),\n        ].join('\\n')).join('\\n\\n')\n      : [\n          `  - name: API`,\n          `    patterns:`,\n          `      - /api`,\n        ].join('\\n')\n\n    const generateLine = opts.omitGenerate\n      ? null\n      : opts.generate\n        ? `  generate: ${opts.generate}   # runs before route discovery to produce openapi.json`\n        : `  # generate: npm run generate:openapi   # uncomment if your spec is generated at build time`\n\n    const basePathLine = opts.basePath\n      ? `  basePath: ${opts.basePath}   # prefix stripped when grouping routes into areas`\n      : `  # basePath: /api   # uncomment and set if your routes share a common prefix (e.g. /api, /api/v1)`\n\n    const testsSection = opts.testsPath\n      ? `\\ntests:\\n  path: ${opts.testsPath}   # directory scanned for *.spec.ts / *.test.ts\\n`\n      : `\\n# tests:\\n#   path: ./e2e   # uncomment to specify a test directory (default: same folder as this file)\\n`\n\n    return `# qualitylens.yaml — generated by 'qualitylens init'\n# Run 'qualitylens scan' to generate your first coverage report.\n\nprojectName: ${opts.projectName}\n\n# Days before a manual test entry is flagged as stale\nstaleThresholdDays: 30\n\nroutes:\n  type: ${opts.routeType}\n  path: ${opts.routesPath}\n${generateLine != null ? generateLine + '\\n' : ''}${basePathLine}\n${testsSection}\nareas:\n${areasYaml}\n\n# Optional: Azure DevOps Test Plans integration\n# ado:\n#   orgUrl: https://dev.azure.com/your-org\n#   project: YourProject\n#   planId: 42\n#   patEnvVar: ADO_PAT\n\n# Optional: manual coverage entries\n# manualCoverage:\n#   - route: /your-route\n#     lastTested: 2026-01-01\n#     tester: your-name\n\n# Optional: CI gates\n# thresholds:\n#   - area: \"*\"\n#     minCoverage: 50\n\n# Optional: test hints (Pro) — resolve orphaned tests, flag route gaps, acknowledge stale tests\n# Run 'qualitylens hint add' or 'qualitylens orphans' to manage this section\n# testHints:\n#   - test: \"Sign out after registration\"\n#     status: resolved       # resolved | gap | acknowledged | ignore\n#     route: /login\n#     reason: Sign out is part of the authentication flow\n#     confidence: high\n#     resolvedBy: agent\n#   - test: \"DELETE /users/:id returns 404\"\n#     status: gap\n#     route: /users/:id\n#     method: DELETE\n#     reason: Route not in OpenAPI spec — missing implementation or undocumented\n`\n  }\n}\n"],"mappings":";AAKA,YAAY,QAAQ;AACpB,YAAY,UAAU;AAcf,IAAM,SAAN,MAAa;AAAA,EAClB,OAAO,KAAK,UAAiC;AAC3C,QAAI,CAAI,cAAW,QAAQ,GAAG;AAC5B,YAAM,IAAI;AAAA,QACR,iCAAiC,QAAQ;AAAA;AAAA,MAE3C;AAAA,IACF;AAEA,UAAM,MAAW,UAAQ,gBAAa,UAAU,OAAO,CAAC;AAGxD,QAAI,CAAC,IAAI,YAAa,OAAM,IAAI,MAAM,2CAA2C;AACjF,QAAI,CAAC,IAAI,OAAQ,OAAM,IAAI,MAAM,sCAAsC;AACvE,QAAI,CAAC,IAAI,OAAO,KAAM,OAAM,IAAI,MAAM,2CAA2C;AACjF,QAAI,CAAC,IAAI,OAAO,KAAM,OAAM,IAAI,MAAM,2CAA2C;AACjF,QAAI,CAAC,IAAI,SAAS,IAAI,MAAM,WAAW,GAAG;AACxC,YAAM,IAAI,MAAM,iDAAiD;AAAA,IACnE;AAGA,WAAO;AAAA,MACL,GAAG;AAAA,MACH,aAAa,IAAI;AAAA,MACjB,QAAQ,IAAI;AAAA,MACZ,OAAO,IAAI;AAAA,MACX,oBAAoB,IAAI,sBAAsB;AAAA,MAC9C,gBAAgB,IAAI,kBAAkB,CAAC;AAAA,MACvC,YAAY,IAAI,cAAc,CAAC;AAAA,MAC/B,WAAW,IAAI,aAAa,CAAC;AAAA,IAC/B;AAAA,EACF;AAAA,EAEA,OAAO,gBAAgB,MAA8B;AACnD,UAAM,YAAY,KAAK,MAAM,SAAS,IAClC,KAAK,MAAM,IAAI,OAAK;AAAA,MAClB,aAAa,EAAE,IAAI;AAAA,MACnB;AAAA,MACA,GAAG,EAAE,SAAS,IAAI,OAAK,WAAW,CAAC,EAAE;AAAA,IACvC,EAAE,KAAK,IAAI,CAAC,EAAE,KAAK,MAAM,IACzB;AAAA,MACE;AAAA,MACA;AAAA,MACA;AAAA,IACF,EAAE,KAAK,IAAI;AAEf,UAAM,eAAe,KAAK,eACtB,OACA,KAAK,WACH,eAAe,KAAK,QAAQ,6DAC5B;AAEN,UAAM,eAAe,KAAK,WACtB,eAAe,KAAK,QAAQ,yDAC5B;AAEJ,UAAM,eAAe,KAAK,YACtB;AAAA;AAAA,UAAqB,KAAK,SAAS;AAAA,IACnC;AAAA;AAAA;AAAA;AAEJ,WAAO;AAAA;AAAA;AAAA,eAGI,KAAK,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,UAMrB,KAAK,SAAS;AAAA,UACd,KAAK,UAAU;AAAA,EACvB,gBAAgB,OAAO,eAAe,OAAO,EAAE,GAAG,YAAY;AAAA,EAC9D,YAAY;AAAA;AAAA,EAEZ,SAAS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAmCT;AACF;","names":[]}

package/dist/core/detector.d.mts

@@ -0,0 +1,43 @@
+import { AppRoute } from './types.mjs';
+
+/**
+ * src/core/detector.ts
+ *
+ * Auto-detection logic for `qualitylens init`.
+ * Inspects a target directory and returns everything it can infer:
+ * framework, route type, routes path, discovered routes, and suggested areas.
+ *
+ * Nothing here writes files or prompts the user — it only observes.
+ */
+
+type Framework = 'nextjs' | 'express-openapi' | 'express' | 'unknown';
+type RouteType = 'nextjs' | 'openapi' | 'express' | 'manual';
+interface SuggestedArea {
+    suggestedName: string;
+    routes: AppRoute[];
+    patterns: string[];
+}
+interface DetectionResult {
+    projectName: string;
+    framework: Framework;
+    routeType: RouteType;
+    routesPath: string | null;
+    testsPath: string | null;
+    generate: string | null;
+    basePath: string | null;
+    hasSwaggerJsdoc: boolean;
+    hasPlaywright: boolean;
+    discoveredRoutes: AppRoute[];
+    suggestedAreas: SuggestedArea[];
+}
+declare function detect(targetDir: string): Promise<DetectionResult>;
+/**
+ * Groups routes by their first meaningful path segment and maps each group
+ * to a human-readable area name.
+ * basePath (e.g. /api, /api/v1) is stripped per-route before grouping so routes
+ * are organised by service name rather than the shared prefix.
+ * Exported so the init command can re-run it after the user confirms/changes basePath.
+ */
+declare function suggestAreas(routes: AppRoute[], basePath: string | null): SuggestedArea[];
+
+export { type DetectionResult, type Framework, type RouteType, type SuggestedArea, detect, suggestAreas };

package/dist/core/detector.d.ts

@@ -0,0 +1,43 @@
+import { AppRoute } from './types.js';
+
+/**
+ * src/core/detector.ts
+ *
+ * Auto-detection logic for `qualitylens init`.
+ * Inspects a target directory and returns everything it can infer:
+ * framework, route type, routes path, discovered routes, and suggested areas.
+ *
+ * Nothing here writes files or prompts the user — it only observes.
+ */
+
+type Framework = 'nextjs' | 'express-openapi' | 'express' | 'unknown';
+type RouteType = 'nextjs' | 'openapi' | 'express' | 'manual';
+interface SuggestedArea {
+    suggestedName: string;
+    routes: AppRoute[];
+    patterns: string[];
+}
+interface DetectionResult {
+    projectName: string;
+    framework: Framework;
+    routeType: RouteType;
+    routesPath: string | null;
+    testsPath: string | null;
+    generate: string | null;
+    basePath: string | null;
+    hasSwaggerJsdoc: boolean;
+    hasPlaywright: boolean;
+    discoveredRoutes: AppRoute[];
+    suggestedAreas: SuggestedArea[];
+}
+declare function detect(targetDir: string): Promise<DetectionResult>;
+/**
+ * Groups routes by their first meaningful path segment and maps each group
+ * to a human-readable area name.
+ * basePath (e.g. /api, /api/v1) is stripped per-route before grouping so routes
+ * are organised by service name rather than the shared prefix.
+ * Exported so the init command can re-run it after the user confirms/changes basePath.
+ */
+declare function suggestAreas(routes: AppRoute[], basePath: string | null): SuggestedArea[];
+
+export { type DetectionResult, type Framework, type RouteType, type SuggestedArea, detect, suggestAreas };