@fairfox/polly 0.80.0 → 0.82.0

package/dist/tools/mutate/src/run.d.ts

@@ -0,0 +1,11 @@
+import type { MutateConfig } from "./config.ts";
+/** Run Stryker against the resolved config. Inherits stdio for the live reporter; returns the exit code. */
+export declare function runStryker(cfg: MutateConfig): Promise<number>;
+/** Build the useless-test report from an existing mutation.json (no Stryker run). */
+export declare function reportFromFile(cfg: MutateConfig): Promise<string>;
+/**
+ * If the Stryker config doesn't already load polly's verify-primitive ignorer,
+ * return a one-line tip. The ignorer must be in the config before the run (it's
+ * read at Stryker startup), so this advises rather than mutating the user's config.
+ */
+export declare function presetAdvisory(cfg: MutateConfig): Promise<string | null>;

package/dist/tools/mutate/src/verify-matrix.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Verification artefact for the kill-matrix contract.
+ *
+ * The whole useless-test analysis rests on one fact: the patched bun runner
+ * emits a COMPLETE kill matrix — every test that detects a mutant appears in
+ * killedBy, not just the first. That depends on a pinned pair: (Bun version,
+ * plugin version + our patch). A Bun upgrade that changes JUnit output, or a
+ * patch that stops applying, would silently collapse killedBy to one id each —
+ * a green board with the redundancy signal quietly dead (the classic trap).
+ *
+ * `verifyMatrix` runs the full contract and returns the result; `isMatrixComplete`
+ * is the side-effect-free gate the report path consults to decide whether the
+ * redundancy/subsumption sections are trustworthy. Run the CLI form after any
+ * bump of Bun or the plugin:
+ *
+ *   polly mutate verify          # uses the existing report
+ *   polly mutate verify --run    # runs stryker first
+ */
+import { type MutationReport } from "./ingest.ts";
+export interface MatrixCheck {
+    ok: boolean;
+    checks: {
+        name: string;
+        ok: boolean;
+        detail: string;
+    }[];
+}
+/**
+ * Side-effect-free gate: is the kill matrix trustworthy for redundancy /
+ * subsumption analysis? True only when
+ *   (a) some killed mutant has >1 killer — proof the no-bail patched runner
+ *       recorded EVERY killer, not just the first (verifyMatrix check #4), and
+ *   (b) coverage was collected — not every mutant is NoCoverage, which would
+ *       mean the coverage dump broke (verifyMatrix check #5).
+ * Without both, REDUNDANCY/SUBSUMED would be computed off a partial matrix and
+ * lie, so the report path falls back to score + gaps + theatre only.
+ */
+export declare function isMatrixComplete(report: MutationReport): boolean;
+/**
+ * Run the full kill-matrix contract (all five checks), optionally running a
+ * fresh Stryker pass first. Returns the result rather than exiting, so callers
+ * decide what to do with it; the `import.meta.main` wrapper prints and sets the
+ * exit code.
+ */
+export declare function verifyMatrix(opts?: {
+    reportPath?: string;
+    run?: boolean;
+    strykerConfig?: string;
+}): Promise<MatrixCheck>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fairfox/polly",
-  "version": "0.80.0",
+  "version": "0.82.0",
   "private": false,
   "type": "module",
   "description": "Multi-execution-context framework with reactive state and cross-context messaging for Chrome extensions, PWAs, and worker-based applications",
@@ -62,6 +62,10 @@
       "import": "./dist/tools/verify/src/stryker/index.js",
       "types": "./dist/tools/verify/src/stryker/index.d.ts"
     },
+    "./mutate": {
+      "import": "./dist/tools/mutate/src/index.js",
+      "types": "./dist/tools/mutate/src/index.d.ts"
+    },
     "./test": {
       "import": "./dist/tools/test/src/index.js",
       "types": "./dist/tools/test/src/index.d.ts"
@@ -191,7 +195,7 @@
     "@types/pixelmatch": "5.2.6",
     "@types/pngjs": "6.0.5",
     "@types/ws": "8.18.1",
-    "dompurify": "3.4.2",
+    "dompurify": "3.4.10",
     "elysia": "1.4.28",
     "fast-check": "4.7.0",
     "marked": "18.0.3",
@@ -304,13 +308,5 @@
   "homepage": "https://github.com/AlexJeffcott/polly#readme",
   "trustedDependencies": [
     "node-datachannel"
-  ],
-  "overrides": {
-    "basic-ftp": "^5.3.1",
-    "brace-expansion": "^2.0.3",
-    "file-type": "^21.3.1",
-    "ip-address": "^10.1.1",
-    "minimatch": "^9.0.6",
-    "uuid": "^14.0.0"
-  }
+  ]
 }