@qulib/core 0.9.0 → 0.10.1

package/dist/cli/baseline-run.d.ts

@@ -0,0 +1,55 @@
+import type { Command } from 'commander';
+import type { BaselineSnapshot, BaselineDelta } from '../baseline/baseline.schema.js';
+import { type GapAnalysis } from '../schemas/gap-analysis.schema.js';
+/**
+ * Read and validate a GapAnalysis from a report.json written by `qulib analyze`.
+ * report.json is exactly a serialized GapAnalysis (see reporters/json-reporter.ts),
+ * so we parse it through GapAnalysisSchema — fail loudly on a malformed/foreign file
+ * rather than baselining garbage.
+ */
+export declare function loadGapAnalysisFromReport(reportPath: string, cwd?: string): Promise<GapAnalysis>;
+export interface BaselineSaveOptions {
+    url: string;
+    fromReport?: string;
+    label?: string;
+    dir?: string;
+    json?: boolean;
+}
+/** Render a saved snapshot as a short human line. */
+export declare function formatSavedSnapshot(snap: BaselineSnapshot): string;
+/**
+ * Core of `baseline save`, factored out so node:test can drive it without a process.
+ * Either --from-report (deterministic, reads a real on-disk report.json) or a live
+ * crawl of --url. --from-report is preferred for CI/agents that already ran analyze.
+ */
+export declare function runBaselineSave(options: BaselineSaveOptions, out?: (line: string) => void): Promise<BaselineSnapshot>;
+export interface BaselineListOptions {
+    url: string;
+    dir?: string;
+    json?: boolean;
+}
+/** Render a list of snapshots as a human table. */
+export declare function formatBaselineList(url: string, snaps: BaselineSnapshot[]): string;
+/** Core of `baseline list`, factored out for direct testing. */
+export declare function runBaselineList(options: BaselineListOptions, out?: (line: string) => void): Promise<BaselineSnapshot[]>;
+export interface BaselineCompareOptions {
+    /** Compare two explicit baseline ids. Takes precedence over --url. */
+    from?: string;
+    to?: string;
+    /** Or: compare the two most-recent baselines for this URL. */
+    url?: string;
+    dir?: string;
+    json?: boolean;
+}
+/** Render a delta as a human report. */
+export declare function formatBaselineDelta(delta: BaselineDelta): string;
+/**
+ * Core of `baseline compare`, factored out for direct testing.
+ * Resolution order:
+ *   1. --from and --to explicit ids → load both, compare.
+ *   2. --url → take the two most-recent baselines (prior = older, current = newest).
+ * Fails clearly when fewer than two baselines are available — never invents a delta.
+ */
+export declare function runBaselineCompare(options: BaselineCompareOptions, out?: (line: string) => void): Promise<BaselineDelta>;
+export declare function registerBaselineCommand(program: Command): void;
+//# sourceMappingURL=baseline-run.d.ts.map

package/dist/cli/baseline-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseline-run.d.ts","sourceRoot":"","sources":["../../src/cli/baseline-run.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQzC,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACtF,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,mCAAmC,CAAC;AA0BxF;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAC7C,UAAU,EAAE,MAAM,EAClB,GAAG,GAAE,MAAsB,GAC1B,OAAO,CAAC,WAAW,CAAC,CAsBtB;AAED,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,qDAAqD;AACrD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAQlE;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,mBAAmB,EAC5B,GAAG,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAkC,GACxD,OAAO,CAAC,gBAAgB,CAAC,CA6B3B;AAED,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,mDAAmD;AACnD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,EAAE,GAAG,MAAM,CAUjF;AAED,gEAAgE;AAChE,wBAAsB,eAAe,CACnC,OAAO,EAAE,mBAAmB,EAC5B,GAAG,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAkC,GACxD,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAW7B;AAED,MAAM,WAAW,sBAAsB;IACrC,sEAAsE;IACtE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,8DAA8D;IAC9D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wCAAwC;AACxC,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAiBhE;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,sBAAsB,EAC/B,GAAG,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAkC,GACxD,OAAO,CAAC,aAAa,CAAC,CAmCxB;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAwD9D"}

package/dist/cli/baseline-run.js

@@ -0,0 +1,259 @@
+/**
+ * `qulib baseline` — capture and compare quality-gap baselines over time.
+ *
+ * Surfaces the previously dead-ended baseline module (../baseline/baseline.js) as a
+ * first-class CLI. Until now save/load/list/compare existed only as a programmatic API
+ * with no consumer; this exposes them so an agent or CI can snapshot a release's gaps
+ * and detect drift (new / resolved / severity-changed gaps + confidence delta) between
+ * runs.
+ *
+ * Subcommands:
+ *   baseline save     — snapshot a GapAnalysis for a URL. Source the analysis either by
+ *                       crawling live (--url alone) or, deterministically, from an
+ *                       existing report.json written by `qulib analyze` (--from-report).
+ *   baseline list     — list saved baselines for a URL, newest-first.
+ *   baseline compare  — diff two baselines (explicit ids, or the two most-recent for a URL).
+ *
+ * Storage honesty (root design principle — no false confidence):
+ *   Baselines persist under <cwd>/.qulib-baselines/<url-slug>/ unless --dir overrides.
+ *   `compare` with fewer than two baselines fails with a clear, actionable message
+ *   rather than fabricating a delta against nothing.
+ *
+ * This file owns the `baseline` command group end-to-end and is registered from
+ * cli/index.ts via `registerBaselineCommand(program)`, so this command's build never
+ * edits the body of index.ts beyond a single additive registration line (mirrors the
+ * score-automation / scaffold / confidence convention).
+ */
+import { resolve } from 'node:path';
+import { readFile } from 'node:fs/promises';
+import { z } from 'zod';
+import { saveBaseline, listBaselines, loadBaseline, compareBaselines, } from '../baseline/baseline.js';
+import { GapAnalysisSchema } from '../schemas/gap-analysis.schema.js';
+import { analyzeApp } from '../analyze.js';
+const UrlSchema = z.string().url();
+/** Harness config used when `save --url` crawls live (no repo, read-only, no LLM). */
+function liveCrawlConfig() {
+    return {
+        maxPagesToScan: 10,
+        maxDepth: 3,
+        minPagesForConfidence: 3,
+        timeoutMs: 30000,
+        retryCount: 0,
+        llmTokenBudget: 4096,
+        testGenerationLimit: 5,
+        enableLlmScenarios: false,
+        readOnlyMode: true,
+        requireHumanReview: false,
+        failOnConsoleError: false,
+        explorer: 'playwright',
+        defaultAdapter: 'playwright',
+        adapters: ['playwright'],
+    };
+}
+/**
+ * Read and validate a GapAnalysis from a report.json written by `qulib analyze`.
+ * report.json is exactly a serialized GapAnalysis (see reporters/json-reporter.ts),
+ * so we parse it through GapAnalysisSchema — fail loudly on a malformed/foreign file
+ * rather than baselining garbage.
+ */
+export async function loadGapAnalysisFromReport(reportPath, cwd = process.cwd()) {
+    const abs = resolve(cwd, reportPath);
+    let raw;
+    try {
+        raw = await readFile(abs, 'utf8');
+    }
+    catch {
+        throw new Error(`--from-report path could not be read: ${abs}`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw new Error(`--from-report file is not valid JSON: ${abs}`);
+    }
+    const result = GapAnalysisSchema.safeParse(parsed);
+    if (!result.success) {
+        throw new Error(`--from-report file is not a valid qulib report.json (GapAnalysis): ${abs}\n` +
+            result.error.issues.map((i) => `  • ${i.path.join('.')}: ${i.message}`).join('\n'));
+    }
+    return result.data;
+}
+/** Render a saved snapshot as a short human line. */
+export function formatSavedSnapshot(snap) {
+    const labelTag = snap.label ? ` "${snap.label}"` : '';
+    return (`[qulib] Saved baseline ${snap.id}${labelTag}\n` +
+        `  url: ${snap.url}\n` +
+        `  releaseConfidence: ${snap.releaseConfidence}/100\n` +
+        `  gaps: ${snap.gapCount}`);
+}
+/**
+ * Core of `baseline save`, factored out so node:test can drive it without a process.
+ * Either --from-report (deterministic, reads a real on-disk report.json) or a live
+ * crawl of --url. --from-report is preferred for CI/agents that already ran analyze.
+ */
+export async function runBaselineSave(options, out = (line) => console.log(line)) {
+    const url = UrlSchema.parse(options.url);
+    let analysis;
+    if (options.fromReport && options.fromReport.trim()) {
+        analysis = await loadGapAnalysisFromReport(options.fromReport.trim());
+    }
+    else {
+        if (!options.json) {
+            out(`[qulib] Crawling ${url} to capture a fresh baseline (analyze_app)…`);
+        }
+        const result = await analyzeApp({
+            url,
+            writeArtifacts: false,
+            config: liveCrawlConfig(),
+        });
+        analysis = result.gapAnalysis;
+    }
+    const snapshot = await saveBaseline(analysis, url, {
+        ...(options.dir ? { baseDir: resolve(process.cwd(), options.dir) } : {}),
+        ...(options.label !== undefined ? { label: options.label } : {}),
+    });
+    if (options.json) {
+        out(JSON.stringify(snapshot, null, 2));
+    }
+    else {
+        out(formatSavedSnapshot(snapshot));
+    }
+    return snapshot;
+}
+/** Render a list of snapshots as a human table. */
+export function formatBaselineList(url, snaps) {
+    if (snaps.length === 0) {
+        return `[qulib] No baselines saved for ${url} yet. Run: qulib baseline save --url ${url} --from-report output/report.json`;
+    }
+    const lines = [`[qulib] ${snaps.length} baseline(s) for ${url} (newest first):`];
+    for (const s of snaps) {
+        const labelTag = s.label ? `  "${s.label}"` : '';
+        lines.push(`  ${s.id}  —  confidence ${s.releaseConfidence}/100, ${s.gapCount} gap(s)${labelTag}`);
+    }
+    return lines.join('\n');
+}
+/** Core of `baseline list`, factored out for direct testing. */
+export async function runBaselineList(options, out = (line) => console.log(line)) {
+    const url = UrlSchema.parse(options.url);
+    const snaps = await listBaselines(url, {
+        ...(options.dir ? { baseDir: resolve(process.cwd(), options.dir) } : {}),
+    });
+    if (options.json) {
+        out(JSON.stringify(snaps, null, 2));
+    }
+    else {
+        out(formatBaselineList(url, snaps));
+    }
+    return snaps;
+}
+/** Render a delta as a human report. */
+export function formatBaselineDelta(delta) {
+    const lines = [];
+    lines.push(`[qulib] Baseline comparison`);
+    lines.push(`  from: ${delta.fromId} (${delta.fromReleaseConfidence}/100)`);
+    lines.push(`  to:   ${delta.toId} (${delta.toReleaseConfidence}/100)`);
+    lines.push(`  ${delta.summary}`);
+    const section = (title, items) => {
+        if (items.length === 0)
+            return;
+        lines.push(`  ${title}:`);
+        for (const g of items) {
+            lines.push(`    • [${g.severity}] ${g.path} (${g.category}) — ${g.reason}`);
+        }
+    };
+    section('new gaps', delta.newGaps);
+    section('resolved gaps', delta.resolvedGaps);
+    section('severity changes', delta.severityChanges);
+    return lines.join('\n');
+}
+/**
+ * Core of `baseline compare`, factored out for direct testing.
+ * Resolution order:
+ *   1. --from and --to explicit ids → load both, compare.
+ *   2. --url → take the two most-recent baselines (prior = older, current = newest).
+ * Fails clearly when fewer than two baselines are available — never invents a delta.
+ */
+export async function runBaselineCompare(options, out = (line) => console.log(line)) {
+    const baseDirOpt = options.dir ? { baseDir: resolve(process.cwd(), options.dir) } : {};
+    let prior;
+    let current;
+    if (options.from || options.to) {
+        if (!options.from || !options.to) {
+            throw new Error('baseline compare with explicit ids requires BOTH --from and --to.');
+        }
+        prior = await loadBaseline(options.from, baseDirOpt);
+        current = await loadBaseline(options.to, baseDirOpt);
+    }
+    else if (options.url) {
+        const url = UrlSchema.parse(options.url);
+        const snaps = await listBaselines(url, baseDirOpt);
+        if (snaps.length < 2) {
+            throw new Error(`baseline compare needs at least two saved baselines for ${url}; found ${snaps.length}. ` +
+                `Save another with: qulib baseline save --url ${url} --from-report output/report.json`);
+        }
+        // listBaselines is newest-first: snaps[0] is current, snaps[1] is the prior.
+        current = snaps[0];
+        prior = snaps[1];
+    }
+    else {
+        throw new Error('baseline compare requires either --from + --to, or --url.');
+    }
+    const delta = compareBaselines(prior, current);
+    if (options.json) {
+        out(JSON.stringify(delta, null, 2));
+    }
+    else {
+        out(formatBaselineDelta(delta));
+    }
+    return delta;
+}
+export function registerBaselineCommand(program) {
+    const baseline = program
+        .command('baseline')
+        .description('Capture and compare quality-gap baselines over time. Snapshot a release\'s gaps, ' +
+        'then diff later runs to surface new / resolved / severity-changed gaps and confidence drift.');
+    baseline
+        .command('save')
+        .description('Save a baseline snapshot for a URL (from a report.json or a fresh live crawl)')
+        .requiredOption('--url <url>', 'URL the baseline is keyed to')
+        .option('--from-report <path>', 'Path to a report.json from `qulib analyze` (deterministic, no network). If omitted, the URL is crawled live.')
+        .option('--label <label>', 'Optional human label for this snapshot, e.g. before-refactor')
+        .option('--dir <path>', 'Baseline storage root (default: <cwd>/.qulib-baselines)')
+        .option('--json', 'Emit the saved BaselineSnapshot as JSON to stdout', false)
+        .action(async (options) => {
+        await runBaselineSave({
+            url: options.url,
+            fromReport: options.fromReport,
+            label: options.label,
+            dir: options.dir,
+            json: Boolean(options.json),
+        });
+    });
+    baseline
+        .command('list')
+        .description('List saved baselines for a URL, newest first')
+        .requiredOption('--url <url>', 'URL whose baselines to list')
+        .option('--dir <path>', 'Baseline storage root (default: <cwd>/.qulib-baselines)')
+        .option('--json', 'Emit the BaselineSnapshot[] as JSON to stdout', false)
+        .action(async (options) => {
+        await runBaselineList({ url: options.url, dir: options.dir, json: Boolean(options.json) });
+    });
+    baseline
+        .command('compare')
+        .description('Compare two baselines — pass --from and --to ids, or --url for the two most-recent')
+        .option('--from <id>', 'Prior baseline id')
+        .option('--to <id>', 'Current baseline id')
+        .option('--url <url>', 'Compare the two most-recent baselines for this URL')
+        .option('--dir <path>', 'Baseline storage root (default: <cwd>/.qulib-baselines)')
+        .option('--json', 'Emit the full BaselineDelta as JSON to stdout', false)
+        .action(async (options) => {
+        await runBaselineCompare({
+            from: options.from,
+            to: options.to,
+            url: options.url,
+            dir: options.dir,
+            json: Boolean(options.json),
+        });
+    });
+}

package/dist/cli/confidence-run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"confidence-run.d.ts","sourceRoot":"","sources":["../../src/cli/confidence-run.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAGzE,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAiBD,uEAAuE;AACvE,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAuCxF;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,iBAAiB,EAC1B,GAAG,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAkC,GACxD,OAAO,CAAC,iBAAiB,CAAC,CAmE5B;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmBhE"}
+{"version":3,"file":"confidence-run.d.ts","sourceRoot":"","sources":["../../src/cli/confidence-run.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAGzE,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAiBD,uEAAuE;AACvE,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAuCxF;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,iBAAiB,EAC1B,GAAG,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAkC,GACxD,OAAO,CAAC,iBAAiB,CAAC,CAmE5B;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuBhE"}

package/dist/cli/confidence-run.js

@@ -47,6 +47,11 @@ export function formatConfidenceReport(rc, subjectRef) {
         for (const b of rc.blockers)
             lines.push(`    • ${b}`);
     }
+    if (rc.honestyNotes.length > 0) {
+        lines.push('  honesty notes:');
+        for (const n of rc.honestyNotes)
+            lines.push(`    • ${n}`);
+    }
     lines.push('  contributions:');
     for (const c of rc.contributions) {
         const scoreLabel = c.score !== null ? `${c.score}/100` : 'n/a';
@@ -66,11 +71,6 @@ export function formatConfidenceReport(rc, subjectRef) {
         for (const r of rc.recommendedNextChecks)
             lines.push(`    • ${r}`);
     }
-    if (rc.honestyNotes.length > 0) {
-        lines.push('  honesty notes:');
-        for (const n of rc.honestyNotes)
-            lines.push(`    • ${n}`);
-    }
     return lines.join('\n');
 }
 /**
@@ -139,12 +139,16 @@ export async function runConfidence(options, out = (line) => console.log(line))
     return rc;
 }
 export function registerConfidenceCommand(program) {
+    // Canonical flagship command. Alias: release-confidence (for integrations that prefer the
+    // full concept name over the short form). Both names are kept through 1.0.
     program
         .command('confidence')
+        .alias('release-confidence')
         .description('Compute a fused Release Confidence verdict from qulib evidence collectors. ' +
         'Pass --url to include live-app quality + a11y + coverage evidence. ' +
         'Pass --repo to include test-automation maturity + API coverage. ' +
-        'Both may be combined.')
+        'Both may be combined. ' +
+        '(Alias: release-confidence)')
         .option('--url <url>', 'URL of the deployed app to analyze')
         .option('--repo <path>', 'Path to the local repository to score')
         .option('--json', 'Emit the full ReleaseConfidence object as JSON to stdout', false)

package/dist/cli/index.js

@@ -41,6 +41,8 @@ import { runAutomatedAuthLogin } from './auth-login-run.js';
 import { registerScaffoldCommand } from './scaffold-run.js';
 import { registerScoreAutomationCommand } from './score-automation-run.js';
 import { registerConfidenceCommand } from './confidence-run.js';
+import { registerBaselineCommand } from './baseline-run.js';
+import { registerAnalyzeDiffCommand } from './analyze-diff-run.js';
 const program = new Command();
 const AnalyzeUrlSchema = z.string().url();
 const FormLoginCliSchema = z.object({
@@ -207,6 +209,8 @@ program
 registerScaffoldCommand(program);
 registerScoreAutomationCommand(program);
 registerConfidenceCommand(program);
+registerBaselineCommand(program);
+registerAnalyzeDiffCommand(program);
 program
     .command('clean')
     .description('Remove all generated reports and scan state')

package/dist/cli/score-automation-run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"score-automation-run.d.ts","sourceRoot":"","sources":["../../src/cli/score-automation-run.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EACV,kBAAkB,EAEnB,MAAM,0CAA0C,CAAC;AAIlD,MAAM,WAAW,sBAAsB;IACrC,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,6FAA6F;IAC7F,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,GAAE,MAAsB,GAAG,MAAM,CAYnG;AA+BD,gGAAgG;AAChG,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM,CAiBtE;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,sBAAsB,EAC/B,GAAG,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAkC,GACxD,OAAO,CAAC,kBAAkB,CAAC,CAW7B;AAED,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAWrE"}
+{"version":3,"file":"score-automation-run.d.ts","sourceRoot":"","sources":["../../src/cli/score-automation-run.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EACV,kBAAkB,EAEnB,MAAM,0CAA0C,CAAC;AAIlD,MAAM,WAAW,sBAAsB;IACrC,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,6FAA6F;IAC7F,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,GAAE,MAAsB,GAAG,MAAM,CAYnG;AA+BD,gGAAgG;AAChG,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM,CAiBtE;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,sBAAsB,EAC/B,GAAG,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAkC,GACxD,OAAO,CAAC,kBAAkB,CAAC,CAW7B;AAED,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAerE"}

package/dist/cli/score-automation-run.js

@@ -112,9 +112,13 @@ export async function runScoreAutomation(options, out = (line) => console.log(li
     return maturity;
 }
 export function registerScoreAutomationCommand(program) {
+    // Canonical name kept for backwards compatibility. Alias: automation-score
+    // (confidence-family naming — shorter and consistent with the qulib_ MCP convention).
     program
         .command('score-automation')
-        .description("Score a local repo's test-automation maturity (overall + per-dimension, with honest applicability)")
+        .alias('automation-score')
+        .description("Score a local repo's test-automation maturity (overall + per-dimension, with honest applicability). " +
+        '(Alias: automation-score)')
         .requiredOption('--repo <path>', 'Path to the local repository to score')
         .option('--json', 'Emit the full AutomationMaturity object as JSON to stdout', false)
         .action(async (options) => {

package/dist/index.d.ts

@@ -12,6 +12,7 @@ export { discoverApiSurface, discoverApiSurfaceWithRepo } from './tools/repo/api
 export type { ApiSurface, DiscoveredEndpoint, DiscoverApiSurfaceOptions } from './tools/repo/api-surface.js';
 export { computeAutomationMaturity } from './tools/scoring/automation-maturity.js';
 export { computeApiCoverage } from './tools/scoring/api-coverage.js';
+export { detectPromptLeakage } from './tools/scoring/prompt-leakage.js';
 export type { ApiCoverageResult, ApiEndpointCoverage } from './tools/scoring/api-coverage.js';
 export { scaffoldTests } from './scaffold-tests.js';
 export type { ScaffoldOptions, ScaffoldResult, ProjectConfig } from './scaffold-tests.js';
@@ -29,6 +30,10 @@ export type { CallLlmConfigSlice } from './llm/provider.js';
 export type { HarnessConfig, AuthConfig, RouteInventory, GapAnalysis, RepoAnalysis, DetectedAuth, AuthExploration, AuthPath, AuthPathRequirements, CostIntelligence, LlmUsageRecord, RepeatedAiPattern, DeterministicMaturity, PublicSurface, AutomationMaturity, AutomationMaturityDimension, FrameworkDetectionResult, DetectedFrameworkPrimary, RecipeId, RecipeConfig, } from './schemas/index.js';
 export { RecipeIdSchema } from './schemas/index.js';
 export { computeReleaseConfidence } from './tools/scoring/confidence.js';
+export { analyzeRunDiff, formatAnalyzeDiffMarkdown, loadGapAnalysisFile } from './cli/analyze-diff-run.js';
+export { buildPageHeatmap, renderHeatmapSection, HEATMAP_DIMENSIONS, DIMENSION_LABELS } from './reporters/heatmap.js';
+export type { PageHeatmap, HeatmapRow, HeatmapCell, HeatmapDimension } from './reporters/heatmap.js';
+export type { AnalyzeDiffResult } from './cli/analyze-diff-run.js';
 export { ciResultsToEvidence } from './adapters/ci-results-adapter.js';
 export type { CiRunInput } from './adapters/ci-results-adapter.js';
 export { prMetadataToEvidence } from './adapters/pr-metadata-adapter.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -8,6 +8,7 @@ export { scanRepo } from './tools/repo/scan.js';
 export { discoverApiSurface, discoverApiSurfaceWithRepo } from './tools/repo/api-surface.js';
 export { computeAutomationMaturity } from './tools/scoring/automation-maturity.js';
 export { computeApiCoverage } from './tools/scoring/api-coverage.js';
+export { detectPromptLeakage } from './tools/scoring/prompt-leakage.js';
 export { scaffoldTests } from './scaffold-tests.js';
 export { expandRecipes, buildAuthScenarios, buildA11yScenarios, buildNavScenarios, buildSeedScenarios } from './recipes/index.js';
 export { createProvider } from './llm/provider-registry.js';
@@ -18,6 +19,10 @@ export { redactUrlForTelemetry } from './telemetry/emit.js';
 export { RecipeIdSchema } from './schemas/index.js';
 // P3 — Confidence Layer exports
 export { computeReleaseConfidence } from './tools/scoring/confidence.js';
+// analyze-diff — structured diff between two analyze_app outputs
+export { analyzeRunDiff, formatAnalyzeDiffMarkdown, loadGapAnalysisFile } from './cli/analyze-diff-run.js';
+// per-page coverage heatmap
+export { buildPageHeatmap, renderHeatmapSection, HEATMAP_DIMENSIONS, DIMENSION_LABELS } from './reporters/heatmap.js';
 // P4 — Evidence adapters (CI results + PR metadata)
 export { ciResultsToEvidence } from './adapters/ci-results-adapter.js';
 export { prMetadataToEvidence } from './adapters/pr-metadata-adapter.js';

package/dist/phases/think.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"think.d.ts","sourceRoot":"","sources":["../../src/phases/think.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,mCAAmC,CAAC;AACxF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAGlD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAIrE,wBAAsB,KAAK,CACzB,QAAQ,EAAE,aAAa,EACvB,MAAM,EAAE,aAAa,EACrB,SAAS,GAAE,mBAA8C,GACxD,OAAO,CAAC,WAAW,CAAC,CAmDtB;AAED,OAAO,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AACnE,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"think.d.ts","sourceRoot":"","sources":["../../src/phases/think.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,mCAAmC,CAAC;AACxF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAIlD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAIrE,wBAAsB,KAAK,CACzB,QAAQ,EAAE,aAAa,EACvB,MAAM,EAAE,aAAa,EACrB,SAAS,GAAE,mBAA8C,GACxD,OAAO,CAAC,WAAW,CAAC,CAyDtB;AAED,OAAO,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AACnE,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/phases/think.js

@@ -1,5 +1,6 @@
 import { GapAnalysisSchema } from '../schemas/gap-analysis.schema.js';
 import { analyzeGaps } from '../tools/scoring/gaps.js';
+import { detectPromptLeakage } from '../tools/scoring/prompt-leakage.js';
 import { logDecision } from '../harness/decision-logger.js';
 import { finalizeGapAnalysisFromDraft } from './think-finalize.js';
 import { emitTelemetry } from '../telemetry/emit.js';
@@ -13,6 +14,8 @@ export async function think(observed, config, artifacts = { writeArtifacts: true
     };
     emitTelemetry(artifacts.telemetry, 'phase.think.started', sessionId, { mode });
     const gapBlock = analyzeGaps(observed.routes, observed.repo, mode, config);
+    // Merge prompt-leakage gaps from all scanned routes (additive signal).
+    const promptLeakageGaps = observed.routes.routes.flatMap((route) => detectPromptLeakage(route));
     const draft = {
         analyzedAt: gapBlock.analyzedAt,
         mode: gapBlock.mode,
@@ -20,7 +23,7 @@ export async function think(observed, config, artifacts = { writeArtifacts: true
         coveragePagesScanned: gapBlock.coveragePagesScanned,
         coverageBudgetExceeded: gapBlock.coverageBudgetExceeded,
         coverageWarning: gapBlock.coverageWarning,
-        gaps: gapBlock.gaps,
+        gaps: [...gapBlock.gaps, ...promptLeakageGaps],
     };
     const partialAnalysis = GapAnalysisSchema.parse({
         ...draft,

package/dist/reporters/heatmap.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Per-page coverage heatmap for Markdown reports.
+ *
+ * buildPageHeatmap() is a pure function — no I/O, no side-effects.
+ * It derives a rows × dimensions matrix from GapAnalysis.gaps and sorts
+ * rows worst-first (most critical coverage problems bubble to the top).
+ *
+ * Dimensions map to the GapSchema.category enum values so the heatmap
+ * always stays in sync with what the scanner can produce.
+ */
+import type { Gap } from '../schemas/gap-analysis.schema.js';
+/** The ordered set of gap categories that appear as heatmap columns. */
+export declare const HEATMAP_DIMENSIONS: readonly ["untested-route", "a11y", "console-error", "broken-link", "coverage", "untested-api-endpoint", "auth-surface", "prompt-leakage"];
+export type HeatmapDimension = (typeof HEATMAP_DIMENSIONS)[number];
+/** Display labels for each dimension column header. */
+export declare const DIMENSION_LABELS: Record<HeatmapDimension, string>;
+/** One cell in the heatmap: the worst severity for that page × dimension. */
+export type HeatmapCell = {
+    /** Worst Gap severity found, or null when no gap exists. */
+    worstSeverity: Gap['severity'] | null;
+    /** Glyph to render in Markdown. */
+    glyph: string;
+    /** Count of gaps contributing to this cell. */
+    count: number;
+};
+/** One row in the heatmap: a page path and its per-dimension cells. */
+export type HeatmapRow = {
+    path: string;
+    /** Map from dimension to cell. Guaranteed to contain every HEATMAP_DIMENSION key. */
+    cells: Record<HeatmapDimension, HeatmapCell>;
+    /** Sum of severity scores across all cells — used for worst-first sort. */
+    worstScore: number;
+};
+/** The full heatmap structure returned by buildPageHeatmap(). */
+export type PageHeatmap = {
+    /** Rows sorted worst-first (highest total severity score first). */
+    rows: HeatmapRow[];
+    /** Ordered dimension labels for use as column headers. */
+    dimensions: typeof HEATMAP_DIMENSIONS;
+    /** Total number of gaps that fed into the heatmap. */
+    totalGaps: number;
+};
+/**
+ * Build a per-page coverage heatmap from a flat list of gaps.
+ *
+ * @param gaps  The gaps array from GapAnalysis.
+ * @returns     A PageHeatmap with rows sorted worst-first.
+ */
+export declare function buildPageHeatmap(gaps: Gap[]): PageHeatmap;
+/**
+ * Render a PageHeatmap as a Markdown section string.
+ * Returns an empty string when there are no rows (nothing scanned).
+ */
+export declare function renderHeatmapSection(heatmap: PageHeatmap): string;
+//# sourceMappingURL=heatmap.d.ts.map

package/dist/reporters/heatmap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heatmap.d.ts","sourceRoot":"","sources":["../../src/reporters/heatmap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,mCAAmC,CAAC;AAM7D,wEAAwE;AACxE,eAAO,MAAM,kBAAkB,4IASoB,CAAC;AAEpD,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnE,uDAAuD;AACvD,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAS7D,CAAC;AAuBF,6EAA6E;AAC7E,MAAM,MAAM,WAAW,GAAG;IACxB,4DAA4D;IAC5D,aAAa,EAAE,GAAG,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;IACtC,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,uEAAuE;AACvE,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,qFAAqF;IACrF,KAAK,EAAE,MAAM,CAAC,gBAAgB,EAAE,WAAW,CAAC,CAAC;IAC7C,2EAA2E;IAC3E,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,iEAAiE;AACjE,MAAM,MAAM,WAAW,GAAG;IACxB,oEAAoE;IACpE,IAAI,EAAE,UAAU,EAAE,CAAC;IACnB,0DAA0D;IAC1D,UAAU,EAAE,OAAO,kBAAkB,CAAC;IACtC,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAMF;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,WAAW,CAuDzD;AAMD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAmCjE"}