@vijaypjavvadi/bdd2pw 4.3.2 → 4.4.1

package/dist/reports/coverage.js

@@ -0,0 +1,360 @@
+"use strict";
+/**
+ * v4.4.0 Slice 2 — `bdd2pw coverage <repo>`.
+ *
+ * Reads the same set of artefacts Slice 1's `quarantine-stats`
+ * consumes, plus the healing telemetry, and turns "which rules fired
+ * in this repo" into a decision surface:
+ *
+ *   - rule hit rate       — which rules bound how many steps, ordered
+ *                            by use.
+ *   - per-pack hit rate   — how much each domain rule pack pulled its
+ *                            weight; a pack with no hits is a
+ *                            candidate for `domains: [...]` removal.
+ *   - dead rules          — every rule the current registry knows about
+ *                            that did NOT fire in this repo. Not a
+ *                            verdict on the rule — just a repo-scoped
+ *                            report.
+ *   - promotion trail     — candidate rules proposed from LLM bindings
+ *                            → which became real rules → which of
+ *                            those now fire. The loop closing is the
+ *                            number worth publishing.
+ *   - heal pressure       — locators that heal most often (from
+ *                            `artefacts/heal-events.jsonl`). A rule
+ *                            that binds and then always needs healing
+ *                            is worse than no rule.
+ *
+ * Report shape (both stdout and `<repo>/artefacts/coverage.json`):
+ *
+ *   {
+ *     "version":     "<bdd2pw version>",
+ *     "generatedAt": "<ISO-8601>",
+ *     "repo":        "<absolute path>",
+ *     "sidecars":    <int>,
+ *     "totals":      { scenarios: { ... }, steps: { ... } },   // shared with quarantine-stats
+ *     "rules": {
+ *       "hit":       [{ ruleId, pack?, hitCount, sampleSteps: [ ... ] }, ...],
+ *       "dead":      [{ ruleId, pack? }, ...],
+ *     },
+ *     "packs": {
+ *       "hit":  { <packName>: { hitCount, ruleIdsFired: [ ... ] } },
+ *       "dead": [ <packName>, ... ]
+ *     },
+ *     "promotions":  { candidateStepsSurveyed, promoted, promotedStepTexts },   // shared with quarantine-stats
+ *     "healPressure": [{ locatorKey, healCount, page?, name? }, ...],
+ *     "missingArtefacts": [ "artefacts/heal-events.jsonl", ... ],
+ *     "warnings":    [ ... ]
+ *   }
+ *
+ * The reader is best-effort. Missing artefacts are reported, not
+ * fatal. Exits non-zero only on a real I/O error against the repo
+ * root itself. The output shape is invariant with `quarantine-stats`
+ * where the fields overlap (`totals`, `promotions`) so a dashboard
+ * can read either without switching schemas.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.analyseCoverage = analyseCoverage;
+exports.renderCoverageTable = renderCoverageTable;
+exports.renderSuggestRetire = renderSuggestRetire;
+const fs = __importStar(require("fs-extra"));
+const path = __importStar(require("path"));
+const quarantineStats_1 = require("./quarantineStats");
+async function analyseCoverage(opts) {
+    var _a;
+    const repo = path.resolve(opts.repo);
+    const missingArtefacts = [];
+    const warnings = [];
+    const sampleCap = opts.sampleStepsPerRule ?? 3;
+    const healTopN = opts.healPressureTopN ?? 10;
+    // 1) Shared totals + promotions — re-use Slice 1's aggregator so
+    // this and quarantine-stats always agree on the shared numbers.
+    // Write to a scratch path we discard; only the returned stats
+    // object matters here.
+    const scratch = path.join(repo, "artefacts", ".coverage-scratch.json");
+    const { stats } = await (0, quarantineStats_1.analyseQuarantineStats)({
+        repo,
+        version: opts.version,
+        outputPath: scratch,
+    });
+    await fs.remove(scratch).catch(() => { });
+    for (const w of stats.warnings)
+        warnings.push(w);
+    // 2) Walk sidecars for rule hits.
+    const hitByRule = new Map();
+    const testsDir = path.join(repo, "tests");
+    const sidecarFiles = [];
+    if (await fs.pathExists(testsDir)) {
+        await walkForSidecars(testsDir, sidecarFiles);
+    }
+    else {
+        missingArtefacts.push("tests/");
+    }
+    for (const file of sidecarFiles) {
+        let sidecar;
+        try {
+            sidecar = JSON.parse(await fs.readFile(file, "utf8"));
+        }
+        catch {
+            continue; // Already warned in Slice 1's pass.
+        }
+        for (const scenario of sidecar.scenarios ?? []) {
+            for (const step of scenario.steps ?? []) {
+                if (step.rule && typeof step.rule === "object") {
+                    const ruleId = step.rule.ruleId;
+                    if (!ruleId)
+                        continue;
+                    let hit = hitByRule.get(ruleId);
+                    if (!hit) {
+                        hit = {
+                            ruleId,
+                            pack: step.rule.pack,
+                            hitCount: 0,
+                            sampleSteps: [],
+                        };
+                        hitByRule.set(ruleId, hit);
+                    }
+                    hit.hitCount += 1;
+                    if (hit.sampleSteps.length < sampleCap && step.text) {
+                        hit.sampleSteps.push(step.text);
+                    }
+                }
+            }
+        }
+    }
+    // 3) Dead rules = every registry ruleId NOT in hitByRule.
+    const hitRuleIds = new Set(hitByRule.keys());
+    const deadRules = [];
+    for (const r of opts.registryRuleIds) {
+        if (!hitRuleIds.has(r.ruleId)) {
+            deadRules.push(r.pack ? { ruleId: r.ruleId, pack: r.pack } : { ruleId: r.ruleId });
+        }
+    }
+    // 4) Per-pack roll-up.
+    const packHits = {};
+    const packsSeen = new Set();
+    for (const r of opts.registryRuleIds) {
+        if (r.pack)
+            packsSeen.add(r.pack);
+    }
+    for (const [, hit] of hitByRule) {
+        if (!hit.pack)
+            continue;
+        const acc = (packHits[_a = hit.pack] ?? (packHits[_a] = { hitCount: 0, ruleIdsFired: [] }));
+        acc.hitCount += hit.hitCount;
+        if (!acc.ruleIdsFired.includes(hit.ruleId)) {
+            acc.ruleIdsFired.push(hit.ruleId);
+        }
+    }
+    const deadPacks = [];
+    for (const p of packsSeen) {
+        if (!packHits[p])
+            deadPacks.push(p);
+    }
+    deadPacks.sort();
+    // 5) Heal pressure — read artefacts/heal-events.jsonl and count
+    // `healed` / `heal_attempt` events per locator.
+    const healPath = path.join(repo, "artefacts", "heal-events.jsonl");
+    const pwHealPath = path.join(repo, ".pwheal", "heal-events.jsonl");
+    const healPressureMap = new Map();
+    const activeHealPath = (await fs.pathExists(healPath))
+        ? healPath
+        : (await fs.pathExists(pwHealPath))
+            ? pwHealPath
+            : undefined;
+    if (!activeHealPath) {
+        // Not an error — many repos don't run --self-healing. Note it.
+        missingArtefacts.push("artefacts/heal-events.jsonl (or .pwheal/heal-events.jsonl)");
+    }
+    else {
+        try {
+            const raw = await fs.readFile(activeHealPath, "utf8");
+            for (const line of raw.split(/\r?\n/)) {
+                const trimmed = line.trim();
+                if (!trimmed)
+                    continue;
+                let ev;
+                try {
+                    ev = JSON.parse(trimmed);
+                }
+                catch {
+                    continue;
+                }
+                if (ev.event !== "healed" && ev.event !== "heal_attempt")
+                    continue;
+                const key = `${ev.page ?? "?"}.${ev.name ?? "?"}`;
+                let bucket = healPressureMap.get(key);
+                if (!bucket) {
+                    bucket = { healCount: 0, page: ev.page, name: ev.name };
+                    healPressureMap.set(key, bucket);
+                }
+                bucket.healCount += 1;
+            }
+        }
+        catch (e) {
+            warnings.push(`Could not read heal-events log: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    }
+    const healPressure = Array.from(healPressureMap.entries())
+        .map(([locatorKey, v]) => ({ locatorKey, ...v }))
+        .sort((a, b) => b.healCount - a.healCount)
+        .slice(0, healTopN);
+    // 6) candidate-rules.jsonl awareness — record its absence as a
+    // missing artefact when nothing to promote and no file present.
+    const candidatesPath = path.join(repo, "artefacts", "candidate-rules.jsonl");
+    if (!(await fs.pathExists(candidatesPath))) {
+        missingArtefacts.push("artefacts/candidate-rules.jsonl");
+    }
+    const coverage = {
+        version: opts.version,
+        generatedAt: new Date().toISOString(),
+        repo,
+        sidecars: stats.totals.sidecars,
+        totals: stats.totals,
+        rules: {
+            hit: Array.from(hitByRule.values()).sort((a, b) => b.hitCount - a.hitCount),
+            dead: deadRules,
+        },
+        packs: {
+            hit: packHits,
+            dead: deadPacks,
+        },
+        promotions: stats.promotions,
+        healPressure,
+        missingArtefacts,
+        warnings,
+    };
+    const outputPath = opts.outputPath ?? path.join(repo, "artefacts", "coverage.json");
+    await fs.ensureDir(path.dirname(outputPath));
+    await fs.writeFile(outputPath, JSON.stringify(coverage, null, 2) + "\n", "utf8");
+    return { coverage, outputPath };
+}
+/** Depth-first walk for `.spec.meta.json` files. */
+async function walkForSidecars(dir, out) {
+    let entries;
+    try {
+        entries = await fs.readdir(dir, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        const full = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            await walkForSidecars(full, out);
+        }
+        else if (entry.isFile() && entry.name.endsWith(".spec.meta.json")) {
+            out.push(full);
+        }
+    }
+}
+/**
+ * Human-readable one-page render. Separate from the JSON generator so
+ * tests can assert on the JSON shape without parsing text, and callers
+ * that want raw JSON pass `--json` at the CLI layer.
+ */
+function renderCoverageTable(cov) {
+    const lines = [];
+    lines.push(`bdd2pw coverage (v${cov.version})`);
+    lines.push(`repo: ${cov.repo}`);
+    lines.push(`generated: ${cov.generatedAt}`);
+    lines.push("");
+    lines.push(`sidecars: ${cov.sidecars}  scenarios: ${cov.totals.scenarios.total}  steps: ${cov.totals.steps.total}`);
+    lines.push("");
+    lines.push(`rules fired: ${cov.rules.hit.length}   dead: ${cov.rules.dead.length}`);
+    const topRules = cov.rules.hit.slice(0, 10);
+    if (topRules.length > 0) {
+        lines.push("");
+        lines.push("top firing rules:");
+        for (const r of topRules) {
+            lines.push(`  ${r.ruleId.padEnd(12)} ${String(r.hitCount).padStart(4)}  ${r.pack ?? "core"}`);
+        }
+    }
+    const deadPacks = cov.packs.dead;
+    if (deadPacks.length > 0) {
+        lines.push("");
+        lines.push(`dead packs (no rule fired in this repo): ${deadPacks.join(", ")}`);
+        lines.push(`  → drop from your domains: [...] to shrink the rule table (--suggest-retire prints the stanza).`);
+    }
+    if (cov.healPressure.length > 0) {
+        lines.push("");
+        lines.push("heal pressure (most healed locators):");
+        for (const h of cov.healPressure) {
+            lines.push(`  ${h.locatorKey.padEnd(40)} ${h.healCount}`);
+        }
+    }
+    lines.push("");
+    lines.push(`promotions: ${cov.promotions.promoted}/${cov.promotions.candidateStepsSurveyed} candidate step(s) now rule-bound`);
+    if (cov.missingArtefacts.length > 0) {
+        lines.push("");
+        lines.push("missing artefacts (report continued with what was present):");
+        for (const m of cov.missingArtefacts)
+            lines.push(`  - ${m}`);
+    }
+    if (cov.warnings.length > 0) {
+        lines.push("");
+        lines.push("warnings:");
+        for (const w of cov.warnings)
+            lines.push(`  - ${w}`);
+    }
+    return lines.join("\n") + "\n";
+}
+/**
+ * Render the `--suggest-retire` stanza — a copyable block the user can
+ * paste into their bdd2pw config (or bench harness) to shrink the
+ * active rule table. Never edits anything itself.
+ */
+function renderSuggestRetire(cov) {
+    const lines = [];
+    lines.push("# `bdd2pw coverage --suggest-retire` — copy the block(s) you want to apply.");
+    lines.push("# Each entry is a rule or pack that did NOT fire in this repo. Removing");
+    lines.push("# them is safe here; it may not be safe across all your repos.");
+    lines.push("");
+    if (cov.packs.dead.length > 0) {
+        lines.push("# Domain packs to drop from ScaffoldOptions.domains:");
+        for (const p of cov.packs.dead) {
+            lines.push(`#   - "${p}"`);
+        }
+        lines.push("");
+    }
+    if (cov.rules.dead.length > 0) {
+        lines.push("# Rules that never fired here (repo-scoped only; NOT a global verdict):");
+        for (const r of cov.rules.dead) {
+            lines.push(`#   - ${r.ruleId}${r.pack ? ` (pack: ${r.pack})` : ""}`);
+        }
+    }
+    return lines.join("\n") + "\n";
+}
+//# sourceMappingURL=coverage.js.map

package/dist/reports/coverage.js.map

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

package/dist/reports/metaSidecar.d.ts

@@ -39,6 +39,27 @@ export interface MetaSidecarStep {
     locator?: string;
     /** Matcher name or method name when the binding has one. */
     assertion?: string;
+    /**
+     * v4.4.0 — provenance. `null` when this step was bound by the LLM
+     * fallback; a `{ ruleId, pack? }` object when bound by the
+     * deterministic rule table. Absent only when the binding was
+     * emitted before v4.4 (old sidecars remain parseable).
+     */
+    rule?: null | {
+        ruleId: string;
+        pack?: string;
+    };
+    /**
+     * v4.4.0 — populated iff this step was bound by the LLM fallback.
+     * Consumed by `bdd2pw quarantine-stats` and `bdd2pw coverage`.
+     */
+    llm?: {
+        provider: "anthropic" | "openai" | "gemini";
+        model: string;
+        cached: boolean;
+        governance: "sanitised" | "skipped";
+        at: string;
+    };
 }
 export interface MetaSidecarScenario {
     name: string;

package/dist/reports/metaSidecar.js

@@ -80,6 +80,26 @@ function bindingsToMetaSteps(bindings) {
             step.locator = b.assertion.locator;
             step.assertion = b.assertion.matcher;
         }
+        // v4.4.0 — provenance passthrough.
+        //   LLM binding → `rule: null` + full `llm` block.
+        //   Rule binding → `rule: { ruleId, pack? }`.
+        //   No provenance (legacy binding) → both fields absent.
+        if (b.provenance?.source === "llm" && b.provenance.llm) {
+            step.rule = null;
+            step.llm = {
+                provider: b.provenance.llm.provider,
+                model: b.provenance.llm.model,
+                cached: b.provenance.llm.cached,
+                governance: b.provenance.llm.governance,
+                at: b.provenance.llm.at,
+            };
+        }
+        else if (b.provenance?.source === "rule" && b.provenance.ruleId) {
+            step.rule = {
+                ruleId: b.provenance.ruleId,
+                ...(b.provenance.pack ? { pack: b.provenance.pack } : {}),
+            };
+        }
         return step;
     });
 }

package/dist/reports/metaSidecar.js.map

@@ -1 +1 @@
-{"version":3,"file":"metaSidecar.js","sourceRoot":"","sources":["../../src/reports/metaSidecar.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;;AAwDH,kDAmBC;AAhDD;;;;;;;;;;GAUG;AACH,SAAS,cAAc,CAAC,CAAc;IACpC,IAAI,CAAC,CAAC,UAAU;QAAE,OAAO,KAAK,CAAC;IAC/B,IAAI,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,OAAO;QAAE,OAAO,MAAM,CAAC;IAC5E,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;QACd,OAAO,CAAC,CAAC,OAAO,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,aAAa,CAAC;IACpE,CAAC;IACD,IAAI,CAAC,CAAC,SAAS;QAAE,OAAO,WAAW,CAAC;IACpC,IAAI,CAAC,CAAC,UAAU;QAAE,OAAO,UAAU,CAAC;IACpC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,mBAAmB,CACjC,QAAuB;IAEvB,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE;QAC7B,MAAM,IAAI,GAAoB;YAC5B,EAAE,EAAE,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;YACpC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO;YACvB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI;YACjB,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;SAC1B,CAAC;QACF,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;YACd,IAAI,CAAC,OAAO,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YACvD,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;QACpC,CAAC;aAAM,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;YACvB,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC;YACnC,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC;QACvC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"metaSidecar.js","sourceRoot":"","sources":["../../src/reports/metaSidecar.ts"],"names":[],"mappings":"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"}

package/dist/reports/quarantineStats.d.ts

@@ -0,0 +1,102 @@
+/**
+ * v4.4.0 Slice 1 — `bdd2pw quarantine-stats <repo>`.
+ *
+ * Aggregates the LLM-provenance data written by v4.4.0's scaffold path
+ * (`*.spec.meta.json` sidecars + `artefacts/candidate-rules.jsonl`)
+ * into a per-feature / per-pack report. The point is to make the two
+ * lanes measurable:
+ *
+ *   trusted lane   — scenarios with NO `@llm-generated` tag; every
+ *                    step bound by the deterministic rule table.
+ *   review lane    — scenarios with the `@llm-generated` tag; at
+ *                    least one step bound by the LLM fallback.
+ *
+ * Report shape (both stdout and `artefacts/quarantine-stats.json`):
+ *
+ *   {
+ *     "version":           "<bdd2pw version>",
+ *     "generatedAt":       "<ISO-8601>",
+ *     "repo":              "<absolute path>",
+ *     "totals": {
+ *       "sidecars":        <int>,
+ *       "scenarios":       { "total": N, "llmGenerated": N, "deterministic": N },
+ *       "steps":           { "total": N, "byRule": N, "byLlm": N },
+ *       "llmCacheHitShare": <0..1 | null>
+ *     },
+ *     "byFeature":         [{ source, scenarios, steps }, ...],
+ *     "promotions": {
+ *       "candidateStepsSurveyed": <int>,
+ *       "promoted":               <int>,
+ *       "promotedStepTexts":      [ ... ]
+ *     },
+ *     "sidecarsScanned":   ["<path>", ...]
+ *   }
+ *
+ * The reader is best-effort — a malformed sidecar is skipped with a
+ * warning and does not crash the run. Only I/O failures on the repo
+ * root itself surface as non-zero exit codes; the report is not a gate.
+ */
+/** Top-level per-repo summary. */
+export interface QuarantineStats {
+    version: string;
+    generatedAt: string;
+    repo: string;
+    totals: {
+        sidecars: number;
+        scenarios: {
+            total: number;
+            llmGenerated: number;
+            deterministic: number;
+        };
+        steps: {
+            total: number;
+            byRule: number;
+            byLlm: number;
+        };
+        /** null when no LLM steps were recorded (avoids fake precision). */
+        llmCacheHitShare: number | null;
+    };
+    byFeature: {
+        source: string;
+        scenarios: {
+            total: number;
+            llmGenerated: number;
+            deterministic: number;
+        };
+        steps: {
+            total: number;
+            byRule: number;
+            byLlm: number;
+        };
+    }[];
+    promotions: {
+        candidateStepsSurveyed: number;
+        promoted: number;
+        promotedStepTexts: string[];
+    };
+    sidecarsScanned: string[];
+    warnings: string[];
+}
+export interface AnalyseQuarantineStatsOptions {
+    /** Repo root containing tests/, artefacts/. */
+    repo: string;
+    /** Package version to embed. Propagated from the CLI. */
+    version: string;
+    /** Optional override for the output path. Default: <repo>/artefacts/quarantine-stats.json. */
+    outputPath?: string;
+}
+export interface AnalyseQuarantineStatsResult {
+    stats: QuarantineStats;
+    outputPath: string;
+}
+/**
+ * Walk `<repo>/tests/**\/*.spec.meta.json` and produce the aggregate
+ * report. Writes the JSON payload alongside the artefacts directory.
+ */
+export declare function analyseQuarantineStats(opts: AnalyseQuarantineStatsOptions): Promise<AnalyseQuarantineStatsResult>;
+/**
+ * Human-readable one-page render. Kept separate from the report
+ * generation so tests can assert on the JSON shape without parsing
+ * text.
+ */
+export declare function renderQuarantineStatsTable(stats: QuarantineStats): string;