@reportforge/playwright-pdf 0.19.1 → 0.20.1

package/dist/index.d.mts

@@ -204,6 +204,10 @@ interface ReporterOptions {
      * Offline failure root-cause analysis. Classifies failures into categories
      * using an embedded Naive Bayes model and renders a clustered breakdown in
      * the `detailed` PDF (one-liner in `executive`). No network calls at runtime.
+     * Optionally personalizes on YOUR machine: label collected failures
+     * (`label-feedback`), then `train-model` trains + evaluates a local layer that
+     * activates only when it measurably beats the base model. Training data, the
+     * trained model, and evaluation never leave the machine.
      * @example
      * failureAnalysis: { enabled: true, maxClusters: 5 }
      */
@@ -216,15 +220,35 @@ interface ReporterOptions {
         minStrength?: 'weak' | 'moderate' | 'strong';
         /** Max failures fed to the classifier; excess skipped, PDF notes it. Default: 500 */
         maxFailuresToAnalyse?: number;
-        /** Collect unknown/low-confidence failures to a local per-project CSV (Plan 3). Default: true */
+        /** Collect unrecognized failures to a local per-project CSV (redacted + tokenized; the on-device trainer's input). Default: true */
         collectUnclassified?: boolean;
         /**
-         * Auto-update the classifier model from the signed license-refresh channel
+         * What the collector stores while `collectUnclassified` is on:
+         * 'blind-spots' = unknown/low-confidence failures only; 'all' = every
+         * model-scored failure, so wrong-but-confident predictions can be corrected
+         * by labeling too (trades ring-buffer space). Default: 'blind-spots'
+         */
+        collectScope?: 'blind-spots' | 'all';
+        /**
+         * Auto-update the BASE classifier model from the signed license-refresh channel
          * (offline-tolerant; the bundled model is always the floor; the delivered model
          * is Ed25519-verified). Set false to pin the bundled model for reproducibility.
          * Default: true
          */
         autoUpdateModel?: boolean;
+        /**
+         * Use the on-device trained model (when present and it passed its local
+         * evaluation gate) ahead of the base model. Trained via the `train-model`
+         * CLI from feedback you labeled; never uploaded anywhere. Default: true
+         */
+        localModel?: boolean;
+        /**
+         * Path to a trained local model file (default: ~/.reportforge/model-local.json).
+         * Point this at a file committed to your repo (`train-model --out`) to share a
+         * team-trained model with ephemeral CI machines — the file contains only
+         * redacted token statistics, never raw failure text.
+         */
+        localModelPath?: string;
     };
     /**
      * Opt-in rich execution capture for the defect log. Reporter-side only — reads
@@ -463,6 +487,18 @@ declare class PdfReporter implements Reporter {
      * onBegin) and PDF generation (awaited in onEnd) — at most one network trip.
      */
     private license;
+    /**
+     * onEnd entry point for licensing: the memoized resolution can be as old as
+     * the whole run (it is shared with the live stream from onBegin), and a JWT
+     * issued near the subscription's period end can expire MID-RUN while the
+     * subscription itself renews and stays active — the exact case where the
+     * admin dashboard shows "active" but generateAll's expiry gate would throw.
+     * When the token is expired or about to be, re-resolve once: with < 24h TTL
+     * the client always takes the network path, and its token_expired recovery
+     * (clear cache → fresh activation) picks up the renewed period. A refresh
+     * failure downgrades to the normal warn-and-skip, never a hard ERROR.
+     */
+    private freshLicense;
     private resolveLicense;
     /**
      * Wires up live streaming: derives the run id (shared by all shards), kicks

package/dist/index.d.ts

@@ -204,6 +204,10 @@ interface ReporterOptions {
      * Offline failure root-cause analysis. Classifies failures into categories
      * using an embedded Naive Bayes model and renders a clustered breakdown in
      * the `detailed` PDF (one-liner in `executive`). No network calls at runtime.
+     * Optionally personalizes on YOUR machine: label collected failures
+     * (`label-feedback`), then `train-model` trains + evaluates a local layer that
+     * activates only when it measurably beats the base model. Training data, the
+     * trained model, and evaluation never leave the machine.
      * @example
      * failureAnalysis: { enabled: true, maxClusters: 5 }
      */
@@ -216,15 +220,35 @@ interface ReporterOptions {
         minStrength?: 'weak' | 'moderate' | 'strong';
         /** Max failures fed to the classifier; excess skipped, PDF notes it. Default: 500 */
         maxFailuresToAnalyse?: number;
-        /** Collect unknown/low-confidence failures to a local per-project CSV (Plan 3). Default: true */
+        /** Collect unrecognized failures to a local per-project CSV (redacted + tokenized; the on-device trainer's input). Default: true */
         collectUnclassified?: boolean;
         /**
-         * Auto-update the classifier model from the signed license-refresh channel
+         * What the collector stores while `collectUnclassified` is on:
+         * 'blind-spots' = unknown/low-confidence failures only; 'all' = every
+         * model-scored failure, so wrong-but-confident predictions can be corrected
+         * by labeling too (trades ring-buffer space). Default: 'blind-spots'
+         */
+        collectScope?: 'blind-spots' | 'all';
+        /**
+         * Auto-update the BASE classifier model from the signed license-refresh channel
          * (offline-tolerant; the bundled model is always the floor; the delivered model
          * is Ed25519-verified). Set false to pin the bundled model for reproducibility.
          * Default: true
          */
         autoUpdateModel?: boolean;
+        /**
+         * Use the on-device trained model (when present and it passed its local
+         * evaluation gate) ahead of the base model. Trained via the `train-model`
+         * CLI from feedback you labeled; never uploaded anywhere. Default: true
+         */
+        localModel?: boolean;
+        /**
+         * Path to a trained local model file (default: ~/.reportforge/model-local.json).
+         * Point this at a file committed to your repo (`train-model --out`) to share a
+         * team-trained model with ephemeral CI machines — the file contains only
+         * redacted token statistics, never raw failure text.
+         */
+        localModelPath?: string;
     };
     /**
      * Opt-in rich execution capture for the defect log. Reporter-side only — reads
@@ -463,6 +487,18 @@ declare class PdfReporter implements Reporter {
      * onBegin) and PDF generation (awaited in onEnd) — at most one network trip.
      */
     private license;
+    /**
+     * onEnd entry point for licensing: the memoized resolution can be as old as
+     * the whole run (it is shared with the live stream from onBegin), and a JWT
+     * issued near the subscription's period end can expire MID-RUN while the
+     * subscription itself renews and stays active — the exact case where the
+     * admin dashboard shows "active" but generateAll's expiry gate would throw.
+     * When the token is expired or about to be, re-resolve once: with < 24h TTL
+     * the client always takes the network path, and its token_expired recovery
+     * (clear cache → fresh activation) picks up the renewed period. A refresh
+     * failure downgrades to the normal warn-and-skip, never a hard ERROR.
+     */
+    private freshLicense;
     private resolveLicense;
     /**
      * Wires up live streaming: derives the run id (shared by all shards), kicks