sela-core 1.0.7 → 1.0.9

package/dist/services/DnaEditorService.js

@@ -17,14 +17,14 @@ function bakPath(dir, key) {
 }
 // Derive a best-effort selector from engine snapshot fields when none is stored.
 function deriveSelector(snap) {
-    const id = snap['id'];
-    const classes = snap['classes'];
-    const tagName = snap['tagName'];
-    if (typeof id === 'string' && id)
+    const id = snap["id"];
+    const classes = snap["classes"];
+    const tagName = snap["tagName"];
+    if (typeof id === "string" && id)
         return `#${id}`;
     if (Array.isArray(classes) && classes.length > 0)
-        return `.${classes.join('.')}`;
-    return typeof tagName === 'string' ? tagName : 'unknown';
+        return `.${classes.join(".")}`;
+    return typeof tagName === "string" ? tagName : "unknown";
 }
 function dnaError(message, code) {
     const err = new Error(message);
@@ -40,15 +40,15 @@ class DnaEditorService {
         const target = jsonPath(this.snapshotDir, key);
         let raw;
         try {
-            raw = await promises_1.default.readFile(target, 'utf-8');
+            raw = await promises_1.default.readFile(target, "utf-8");
         }
         catch {
-            throw dnaError(`DNA not found: ${key}`, 'DNA_NOT_FOUND');
+            throw dnaError(`DNA not found: ${key}`, "DNA_NOT_FOUND");
         }
         const parsed = JSON.parse(raw);
         // Promote to extended format if selector not stored
-        if (!parsed['selector']) {
-            parsed['selector'] = deriveSelector(parsed);
+        if (!parsed["selector"]) {
+            parsed["selector"] = deriveSelector(parsed);
         }
         return parsed;
     }
@@ -59,22 +59,25 @@ class DnaEditorService {
         // 1. Read existing snapshot
         const original = await this.read(key);
         // 2. Shallow-merge patch (arrays and objects replaced, not deep-merged)
-        const merged = { ...original, ...patch };
+        const merged = {
+            ...original,
+            ...patch,
+        };
         // Any CLI write = human has reviewed the DNA → clear auto-heal status flag.
-        delete merged['status'];
-        // 3. Derive selector only when absent — never override an explicit (possibly invalid) value
-        if (merged['selector'] == null) {
-            merged['selector'] = deriveSelector(merged);
+        delete merged["status"];
+        // 3. Derive selector only when absent - never override an explicit (possibly invalid) value
+        if (merged["selector"] == null) {
+            merged["selector"] = deriveSelector(merged);
         }
         // 4. Validate before touching disk
         const validation = this.validate(merged);
         if (!validation.valid) {
-            throw dnaError(`Validation failed for ${key}: ${validation.errors.join('; ')}`, 'VALIDATION_FAILED');
+            throw dnaError(`Validation failed for ${key}: ${validation.errors.join("; ")}`, "VALIDATION_FAILED");
         }
         // 5. Backup current file (overwrite previous bak)
-        await promises_1.default.writeFile(bak, JSON.stringify(original, null, 2), 'utf-8');
+        await promises_1.default.writeFile(bak, JSON.stringify(original, null, 2), "utf-8");
         // 6. Write to tmp
-        await promises_1.default.writeFile(tmp, JSON.stringify(merged, null, 2), 'utf-8');
+        await promises_1.default.writeFile(tmp, JSON.stringify(merged, null, 2), "utf-8");
         // 7. Atomic rename tmp → json
         await promises_1.default.rename(tmp, target);
         return bak;
@@ -86,111 +89,127 @@ class DnaEditorService {
             await promises_1.default.access(bak);
         }
         catch {
-            throw dnaError(`No backup found for: ${key}`, 'DNA_NOT_FOUND');
+            throw dnaError(`No backup found for: ${key}`, "DNA_NOT_FOUND");
         }
         await promises_1.default.rename(bak, target);
     }
     validate(candidate) {
         const errors = [];
-        if (typeof candidate !== 'object' || candidate === null || Array.isArray(candidate)) {
-            return { valid: false, errors: ['candidate must be a plain object'] };
+        if (typeof candidate !== "object" ||
+            candidate === null ||
+            Array.isArray(candidate)) {
+            return { valid: false, errors: ["candidate must be a plain object"] };
         }
         const snap = candidate;
         // ── Required top-level fields ─────────────────────────────────────────────
-        for (const field of ['tagName', 'selector', 'schemaVersion', 'timestamp']) {
+        for (const field of [
+            "tagName",
+            "selector",
+            "schemaVersion",
+            "timestamp",
+        ]) {
             if (!(field in snap) || snap[field] === undefined) {
                 errors.push(`Missing required field: ${field}`);
             }
         }
-        if (snap['schemaVersion'] !== 2) {
-            errors.push(`schemaVersion must be 2, got ${String(snap['schemaVersion'])}`);
+        if (snap["schemaVersion"] !== 2) {
+            errors.push(`schemaVersion must be 2, got ${String(snap["schemaVersion"])}`);
         }
         // ── selector ─────────────────────────────────────────────────────────────
-        const sel = snap['selector'];
-        if (typeof sel === 'string') {
-            if (sel.trim() === '')
-                errors.push('selector must not be empty');
-            if (sel === 'undefined')
+        const sel = snap["selector"];
+        if (typeof sel === "string") {
+            if (sel.trim() === "")
+                errors.push("selector must not be empty");
+            if (sel === "undefined")
                 errors.push('selector must not be the string "undefined"');
             if (/[\r\n]/.test(sel))
-                errors.push('selector must not contain raw newlines');
+                errors.push("selector must not contain raw newlines");
         }
-        else if ('selector' in snap) {
-            errors.push('selector must be a string');
+        else if ("selector" in snap) {
+            errors.push("selector must be a string");
         }
         // ── tagName ───────────────────────────────────────────────────────────────
-        const tag = snap['tagName'];
-        if (typeof tag === 'string') {
+        const tag = snap["tagName"];
+        if (typeof tag === "string") {
             if (!/^[a-z][a-z0-9-]*$/.test(tag)) {
-                errors.push('tagName must match /^[a-z][a-z0-9-]*$/');
+                errors.push("tagName must match /^[a-z][a-z0-9-]*$/");
             }
         }
-        else if ('tagName' in snap) {
-            errors.push('tagName must be a string');
+        else if ("tagName" in snap) {
+            errors.push("tagName must be a string");
         }
         // ── text ─────────────────────────────────────────────────────────────────
-        const text = snap['text'];
+        const text = snap["text"];
         if (text !== null && text !== undefined) {
-            if (typeof text !== 'string') {
-                errors.push('text must be a string or null');
+            if (typeof text !== "string") {
+                errors.push("text must be a string or null");
             }
             else if (text.length >= 2000) {
-                errors.push('text must be fewer than 2000 characters');
+                errors.push("text must be fewer than 2000 characters");
             }
         }
         // ── attributes ───────────────────────────────────────────────────────────
-        const attrs = snap['attributes'];
+        const attrs = snap["attributes"];
         if (attrs !== undefined) {
-            if (typeof attrs !== 'object' || attrs === null || Array.isArray(attrs)) {
-                errors.push('attributes must be a plain object');
+            if (typeof attrs !== "object" || attrs === null || Array.isArray(attrs)) {
+                errors.push("attributes must be a plain object");
             }
             else {
                 for (const [k, v] of Object.entries(attrs)) {
                     if (!k)
-                        errors.push('attributes keys must not be empty');
-                    if (typeof v !== 'string')
+                        errors.push("attributes keys must not be empty");
+                    if (typeof v !== "string")
                         errors.push(`attributes["${k}"] must be a string`);
                 }
             }
         }
         // ── visibility (all 4 keys required) ─────────────────────────────────────
-        const vis = snap['visibility'];
-        if (typeof vis === 'object' && vis !== null && !Array.isArray(vis)) {
+        const vis = snap["visibility"];
+        if (typeof vis === "object" && vis !== null && !Array.isArray(vis)) {
             const visObj = vis;
-            for (const key of ['isGhost', 'ghostReason', 'isOccluded', 'opacity']) {
+            for (const key of [
+                "isGhost",
+                "ghostReason",
+                "isOccluded",
+                "opacity",
+            ]) {
                 if (!(key in visObj))
                     errors.push(`visibility.${key} is required`);
             }
         }
         else {
-            errors.push('visibility block is required and must be an object');
+            errors.push("visibility block is required and must be an object");
         }
         // ── anchors (all 3 keys required) ────────────────────────────────────────
-        const anch = snap['anchors'];
-        if (typeof anch === 'object' && anch !== null && !Array.isArray(anch)) {
+        const anch = snap["anchors"];
+        if (typeof anch === "object" && anch !== null && !Array.isArray(anch)) {
             const anchObj = anch;
-            for (const key of ['closestLabel', 'rowAnchor', 'neighborTexts']) {
+            for (const key of [
+                "closestLabel",
+                "rowAnchor",
+                "neighborTexts",
+            ]) {
                 if (!(key in anchObj))
                     errors.push(`anchors.${key} is required`);
             }
-            const cl = anchObj['closestLabel'];
-            if (cl !== null && typeof cl !== 'string') {
-                errors.push('anchors.closestLabel must be a string or null');
+            const cl = anchObj["closestLabel"];
+            if (cl !== null && typeof cl !== "string") {
+                errors.push("anchors.closestLabel must be a string or null");
             }
-            const nt = anchObj['neighborTexts'];
+            const nt = anchObj["neighborTexts"];
             if (!Array.isArray(nt)) {
-                errors.push('anchors.neighborTexts must be an array');
+                errors.push("anchors.neighborTexts must be an array");
             }
             else {
                 if (nt.length > 10)
-                    errors.push('anchors.neighborTexts must have at most 10 elements');
-                if (!nt.every((x) => typeof x === 'string')) {
-                    errors.push('anchors.neighborTexts elements must all be strings');
+                    errors.push("anchors.neighborTexts must have at most 10 elements");
+                if (!nt.every((x) => typeof x === "string")) {
+                    errors.push("anchors.neighborTexts elements must all be strings");
                 }
             }
         }
         else {
-            errors.push('anchors block is required and must be an object');
+            errors.push("anchors block is required and must be an object");
         }
         return { valid: errors.length === 0, errors };
     }

package/dist/services/DnaIndexService.d.ts

@@ -1,4 +1,4 @@
-import type { DnaRecord, DnaIndex } from './types.js';
+import type { DnaRecord, DnaIndex } from "./types.js";
 export interface IDnaIndexService {
     buildIndex(snapshotDir: string): Promise<DnaIndex>;
     findBySelector(pattern: string): DnaRecord[];

package/dist/services/DnaIndexService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DnaIndexService.d.ts","sourceRoot":"","sources":["../../src/services/DnaIndexService.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAatD,MAAM,WAAW,gBAAgB;IAC/B,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnD,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,CAAC;IAC7C,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,CAAC;IACzC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,CAAC;IAChD,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,CAAC;IAC9C,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;IACxC,QAAQ,IAAI,QAAQ,CAAC;IACrB,OAAO,IAAI,IAAI,CAAC;CACjB;AAkED,qBAAa,eAAgB,YAAW,gBAAgB;IACtD,OAAO,CAAC,WAAW,CAAyB;IAEtC,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAkCxD,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE;IAK5C,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE;IAKxC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE;IAO/C,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE;IAK7C,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAIvC,QAAQ,IAAI,QAAQ;IAIpB,OAAO,IAAI,IAAI;IAIf,OAAO,CAAC,YAAY;CAQrB"}
+{"version":3,"file":"DnaIndexService.d.ts","sourceRoot":"","sources":["../../src/services/DnaIndexService.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAatD,MAAM,WAAW,gBAAgB;IAC/B,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnD,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,CAAC;IAC7C,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,CAAC;IACzC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,CAAC;IAChD,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,CAAC;IAC9C,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;IACxC,QAAQ,IAAI,QAAQ,CAAC;IACrB,OAAO,IAAI,IAAI,CAAC;CACjB;AAkED,qBAAa,eAAgB,YAAW,gBAAgB;IACtD,OAAO,CAAC,WAAW,CAAyB;IAEtC,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAoCxD,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE;IAK5C,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE;IAOxC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE;IAO/C,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE;IAK7C,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAIvC,QAAQ,IAAI,QAAQ;IAIpB,OAAO,IAAI,IAAI;IAIf,OAAO,CAAC,YAAY;CAQrB"}

package/dist/services/DnaIndexService.js

@@ -12,7 +12,7 @@ function toRegExp(pattern) {
     const m = pattern.match(/^\/(.+)\/([gimsuy]*)$/);
     if (m)
         return new RegExp(m[1], m[2]);
-    return new RegExp(pattern.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'), 'i');
+    return new RegExp(pattern.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"), "i");
 }
 function deriveSelector(snap) {
     if (snap.selector)
@@ -20,19 +20,19 @@ function deriveSelector(snap) {
     if (snap.id)
         return `#${snap.id}`;
     if (snap.classes.length > 0)
-        return `.${snap.classes.join('.')}`;
+        return `.${snap.classes.join(".")}`;
     return snap.tagName;
 }
 function isWithin7Days(iso) {
     return new Date(iso).getTime() >= Date.now() - 7 * 24 * 60 * 60 * 1000;
 }
 function toRecord(filePath, raw) {
-    const key = path_1.default.basename(filePath, '.json');
-    const sourceFile = raw.sourceFile ?? '';
+    const key = path_1.default.basename(filePath, ".json");
+    const sourceFile = raw.sourceFile ?? "";
     return {
         key,
         filePath,
-        testTitle: raw.testTitle ?? '',
+        testTitle: raw.testTitle ?? "",
         sourceFile,
         sourceLine: raw.sourceLine ?? 0,
         selector: deriveSelector(raw),
@@ -40,8 +40,8 @@ function toRecord(filePath, raw) {
         text: raw.text ?? null,
         lastHealed: raw.lastHealed ?? null,
         schemaVersion: raw.schemaVersion ?? 1,
-        // Only flag orphaned when sourceFile is known — engine snapshots have no sourceFile
-        isOrphaned: sourceFile !== '' && !(0, fs_1.existsSync)(sourceFile),
+        // Only flag orphaned when sourceFile is known - engine snapshots have no sourceFile
+        isOrphaned: sourceFile !== "" && !(0, fs_1.existsSync)(sourceFile),
         status: raw.status,
     };
 }
@@ -60,9 +60,9 @@ async function collectJsonFiles(dir) {
             results.push(...(await collectJsonFiles(full)));
         }
         else if (entry.isFile() &&
-            entry.name.endsWith('.json') &&
-            !entry.name.endsWith('.bak') &&
-            !entry.name.endsWith('.tmp')) {
+            entry.name.endsWith(".json") &&
+            !entry.name.endsWith(".bak") &&
+            !entry.name.endsWith(".tmp")) {
             results.push(full);
         }
     }));
@@ -73,11 +73,11 @@ class DnaIndexService {
     async buildIndex(snapshotDir) {
         const files = await collectJsonFiles(snapshotDir);
         const settled = await Promise.allSettled(files.map(async (filePath) => {
-            const content = await promises_1.default.readFile(filePath, 'utf-8');
+            const content = await promises_1.default.readFile(filePath, "utf-8");
             return toRecord(filePath, JSON.parse(content));
         }));
         const records = settled
-            .filter((r) => r.status === 'fulfilled')
+            .filter((r) => r.status === "fulfilled")
             .map((r) => r.value);
         const healedAllTime = records.filter((r) => r.lastHealed !== null).length;
         const healedLast7Days = records.filter((r) => r.lastHealed !== null && isWithin7Days(r.lastHealed)).length;
@@ -121,8 +121,8 @@ class DnaIndexService {
     }
     requireIndex() {
         if (!this.cachedIndex) {
-            const err = new Error('Index not built — call buildIndex() first');
-            err.code = 'SNAPSHOT_DIR_MISSING';
+            const err = new Error("Index not built - call buildIndex() first");
+            err.code = "SNAPSHOT_DIR_MISSING";
             throw err;
         }
         return this.cachedIndex;

package/dist/services/HealReportService.d.ts

@@ -1,5 +1,6 @@
 import type { AuditVerdict, AuditVerdictValue } from "./IntentAuditor";
 import type { ElementSnapshotV2 } from "../types";
+import { type ReportData } from "./ReportGenerator";
 export type HealEventKind = "HEALED" | "FAILED" | "PROTECTED";
 export interface DnaSummary {
     tagName: string;
@@ -17,10 +18,6 @@ export interface DnaSummary {
 }
 export interface AuditorBlock {
     verdict: AuditVerdictValue;
-    /**
-     * Adjusted confidence 0-100. `undefined` when the auditor produced no score
-     * (e.g. SafetyGuard bypassed it) — reports MUST render this as "n/a".
-     */
     confidence?: number;
     reason: string;
     inversionType: AuditVerdict["inversionType"];
@@ -41,30 +38,13 @@ interface HealEventBase {
 }
 export interface HealedEvent extends HealEventBase {
     kind: "HEALED";
-    /**
-     * Marks events produced during a `SELA_DRY_RUN=1` session — the in-memory
-     * heal completed (LLM call, SafetyGuard verdict, candidate diff captured)
-     * but no source file was modified and no commit was produced. Reports
-     * render these with an explicit "Dry Run · No Write" chip.
-     */
     dryRun?: boolean;
     oldSelector: string;
     newSelector: string;
-    /** First removed line from the native git diff (backward-compat fallback). */
     oldCodeLine: string;
-    /** First added line from the native git diff (backward-compat fallback). */
     newCodeLine: string;
     newLineNumber: number;
-    /**
-     * Raw `git diff --unified=1` output captured immediately after the AST
-     * mutation hit disk and BEFORE any `git add`. Includes headers (---/+++)
-     * and one or more @@ hunks. Renderers strip headers; PR body emits the
-     * hunks verbatim inside a ```diff fence so cross-file healing, multi-line
-     * edits, and template-literal changes are all displayed natively without
-     * any in-process line-index math.
-     */
     gitUnifiedDiff?: string;
-    /** AI-reported confidence 0-100. `undefined` when the model omitted it. */
     aiConfidence?: number;
     aiExplanation: string;
     aiAlternatives: string[];
@@ -90,15 +70,6 @@ export interface FailedEvent extends HealEventBase {
     aiConfidence?: number;
     aiExplanation?: string;
     dnaBefore: DnaSummary | null;
-    /**
-     * Base64-encoded PNG screenshot captured by `SelaReporter` from the
-     * Playwright `TestResult.attachments` slot at the moment the test
-     * failed. NEVER prefixed with `data:image/png;base64,` — the HTML
-     * renderer prepends the data URL header at render time so the JSON
-     * payload stays compact and the bytes survive Playwright's temp
-     * folder cleanup. `undefined` when no screenshot was attached
-     * (worker crash, screenshot disabled, off-attachment failure).
-     */
     failureScreenshotPng?: string;
 }
 export interface ProtectedEvent extends HealEventBase {
@@ -108,7 +79,6 @@ export interface ProtectedEvent extends HealEventBase {
     reason: string;
     safetyLevel: string;
     auditor: AuditorBlock | null;
-    /** AI-reported confidence 0-100. `undefined` when the model omitted it. */
     aiConfidence?: number;
     aiExplanation: string;
     dnaBefore: DnaSummary | null;
@@ -127,42 +97,48 @@ export declare class HealReportService {
     size(): number;
     clear(): void;
     hasContent(): boolean;
-    /** All HEALED events accumulated in this session. */
     getHealedEvents(): HealedEvent[];
-    /** All PROTECTED events (SafetyGuard blocks) accumulated in this session. */
     getProtectedEvents(): ProtectedEvent[];
-    /** All FAILED events accumulated in this session. */
     getFailedEvents(): FailedEvent[];
     /**
-     * Inject a Playwright failure screenshot (Base64 PNG, no data: prefix)
-     * onto the FAILED event(s) matching the supplied identity hints. Used
-     * by `SelaReporter` to enrich engine-emitted FAILED events with the
-     * Playwright-captured screenshot from `TestResult.attachments`.
-     *
-     * Match policy (all supplied hints must agree):
-     *   • `sourceFile` — suffix-matched both directions to absorb
-     *     project-relative vs absolute path mismatches between the engine
-     *     (relative) and Playwright TestInfo.location.file (absolute).
-     *   • `testTitle` — exact match.
-     *   • `stableId`  — exact match.
-     *
-     * Returns the number of events updated. Zero means the caller should
-     * keep the screenshot pending until the matching FailedEvent is
-     * recorded (worker-crash edge case where the heal pipeline did not
-     * run before the Reporter received the failure).
+     * Attach a Playwright failure screenshot (Base64 PNG, no data: prefix)
+     * onto the FAILED event(s) matching the supplied identity hints.
+     * Returns the number of events updated.
      */
     attachFailureScreenshot(match: {
         sourceFile?: string;
         testTitle?: string;
         stableId?: string;
     }, base64Png: string): number;
+    private readHistory;
+    private writeHistory;
+    /**
+     * Generate and write `sela-report.html` + `sela-report.json` to targetDir.
+     * Also updates `.sela-history.json` with the current run's stats.
+     * Returns the absolute path of the HTML report, or null when there is
+     * nothing to write.
+     */
+    flushToDisk(targetDir?: string, opts?: {
+        runId?: string;
+    }): string | null;
     /**
-     * Write `sela-report.html` (+ `sela-report.json` debug dump) to cwd.
-     * Returns the absolute path of the HTML report, or null if nothing to write.
+     * Render and persist a pre-computed {@link ReportData} payload to `targetDir`:
+     *   • `.sela-history.json` (the rolling window from `data.historical_runs`)
+     *   • `sela-report.html`   (the embedded dashboard)
+     *   • `sela-report.json`   (the raw payload for CI consumers)
+     *
+     * Extracted from {@link flushToDisk} so the CI merge path
+     * (`ReportMergeService`) writes a shard-aggregated report through the exact
+     * same rendering / serialisation logic — no duplication.
+     *
+     * Unlike `flushToDisk`, this writes unconditionally: an empty-event payload
+     * still produces a report and a `healed:0` history row. That is the desired
+     * CI behaviour — a clean, zero-heal pipeline is a healthy data point that
+     * must keep the trend chart's x-axis cadence intact.
+     *
+     * Returns the absolute path of the written HTML report.
      */
-    flushToDisk(targetDir?: string): string | null;
-    private renderHtml;
-    private computeStats;
+    writeReportData(targetDir: string, data: ReportData): string;
 }
 export declare const sharedHealReport: HealReportService;
 export {};

package/dist/services/HealReportService.d.ts.map

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