packaging: README (NASA style) + possibilistic perf baseline + CI benchmark job

README: purpose-first (possibility not boolean, caller owns evidence/time), install, verified quick start, concepts (result shape, overlays, temporal context), API table, development commands, design notes. benchmark: scripts/benchmark.js on @tenere/benchmark-lib — eight contours (direct/union/denied/meta/overlay/binary checks, snapshot build/restore), committed .rigor-baseline.json, exit 1 on high-severity regressions. CI: benchmark job compares on push (continue-on-error), re-saves baseline and uploads it as an artifact on tags; publish now depends on benchmark passing as well as test.
2026-08-02 12:52:21 -07:00
parent 2d27321b38
commit 223cfb97c3
6 changed files with 508 additions and 3 deletions
@@ -0,0 +1,142 @@
+{
+  "version": 1,
+  "generated": "2026-08-02T19:51:19.208Z",
+  "actions": {
+    "check[direct-hit]": {
+      "mostPlausible": 0.25810395981996936,
+      "alphaCuts": {
+        "p50": {
+          "lower": 0.16434574601481775,
+          "upper": 0.40535024830520205
+        },
+        "p95": {
+          "lower": 0.10394999999999016,
+          "upper": 1.2158777106838974
+        },
+        "p99": {
+          "lower": 0.10394999999999016,
+          "upper": 2.040950000000002
+        }
+      }
+    },
+    "check[union-ttu]": {
+      "mostPlausible": 0.3581109933665416,
+      "alphaCuts": {
+        "p50": {
+          "lower": 0.07645000000001517,
+          "upper": 0.35811139703768785
+        },
+        "p95": {
+          "lower": 0.07645000000001517,
+          "upper": 0.35811139703768785
+        },
+        "p99": {
+          "lower": 0.07645000000001517,
+          "upper": 0.35811139703768785
+        }
+      }
+    },
+    "check[denied-miss]": {
+      "mostPlausible": 0.21718442918988012,
+      "alphaCuts": {
+        "p50": {
+          "lower": 0.18384889559816292,
+          "upper": 0.2565642603295502
+        },
+        "p95": {
+          "lower": 0.13274999999997988,
+          "upper": 0.3601500000000823
+        },
+        "p99": {
+          "lower": 0.13274999999997988,
+          "upper": 0.3601500000000823
+        }
+      }
+    },
+    "check[include-meta]": {
+      "mostPlausible": 0.9937660048895368,
+      "alphaCuts": {
+        "p50": {
+          "lower": 0.9937660048895368,
+          "upper": 0.9937663566453343
+        },
+        "p95": {
+          "lower": 0.9937660048895368,
+          "upper": 0.9937663566453343
+        },
+        "p99": {
+          "lower": 0.9937660048895368,
+          "upper": 0.9937663566453343
+        }
+      }
+    },
+    "check[overlay-on-top]": {
+      "mostPlausible": 0.3485105914857449,
+      "alphaCuts": {
+        "p50": {
+          "lower": 0.26044999999998425,
+          "upper": 0.3881187132654935
+        },
+        "p95": {
+          "lower": 0.26044999999998425,
+          "upper": 0.5286391152207875
+        },
+        "p99": {
+          "lower": 0.26044999999998425,
+          "upper": 0.5374790233000701
+        }
+      }
+    },
+    "check[binary-direct]": {
+      "mostPlausible": 0.2660225524868295,
+      "alphaCuts": {
+        "p50": {
+          "lower": 0.21220996174732032,
+          "upper": 0.3334807973509898
+        },
+        "p95": {
+          "lower": 0.16554999999993186,
+          "upper": 0.5780022226626057
+        },
+        "p99": {
+          "lower": 0.16554999999993186,
+          "upper": 0.8219500000000078
+        }
+      }
+    },
+    "snapshot[build-binary]": {
+      "mostPlausible": 4.119453383803492,
+      "alphaCuts": {
+        "p50": {
+          "lower": 3.638457178151043,
+          "upper": 4.664037328289517
+        },
+        "p95": {
+          "lower": 3.1707499999999906,
+          "upper": 6.309350037482752
+        },
+        "p99": {
+          "lower": 3.1707499999999906,
+          "upper": 7.547749999999944
+        }
+      }
+    },
+    "snapshot[restore-binary]": {
+      "mostPlausible": 6.906283652168588,
+      "alphaCuts": {
+        "p50": {
+          "lower": 3.2581500000001067,
+          "upper": 6.906283919208314
+        },
+        "p95": {
+          "lower": 3.2581500000001067,
+          "upper": 6.906283919208314
+        },
+        "p99": {
+          "lower": 3.2581500000001067,
+          "upper": 6.906283919208314
+        }
+      }
+    }
+  }
+}