oracular 0.7.0 → 0.8.0

package/dist/inspect.d.cts

@@ -12,7 +12,10 @@ interface Prediction {
     p: number;
     /** Standard deviation of the Beta distribution. */
     sd: number;
-    /** p − z·sd, clamped to [0, 1]. This is what `shouldReveal` compares to the threshold. */
+    /**
+     * The lower confidence bound `shouldReveal` compares to the threshold: p − z·sd clamped to
+     * [0, 1], or with `bound: 'exact'` the Beta quantile at Φ(−z).
+     */
     lower: number;
     /** 1 − 2·sd, clamped to [0, 1]. A heuristic: 1 when the estimate is sharp, 0 when it is as vague as possible. */
     confidence: number;

package/dist/inspect.d.ts

@@ -12,7 +12,10 @@ interface Prediction {
     p: number;
     /** Standard deviation of the Beta distribution. */
     sd: number;
-    /** p − z·sd, clamped to [0, 1]. This is what `shouldReveal` compares to the threshold. */
+    /**
+     * The lower confidence bound `shouldReveal` compares to the threshold: p − z·sd clamped to
+     * [0, 1], or with `bound: 'exact'` the Beta quantile at Φ(−z).
+     */
     lower: number;
     /** 1 − 2·sd, clamped to [0, 1]. A heuristic: 1 when the estimate is sharp, 0 when it is as vague as possible. */
     confidence: number;

package/dist/presets.d.cts

@@ -14,6 +14,13 @@ interface RevealOptions {
     z?: number;
     /** How long after `markRevealed` the intent stays revealed and `shouldReveal` is false. Default: the intent's `halfLife`. */
     cooldown?: number;
+    /**
+     * How `lower` is computed. `'normal'` (default): p − z·sd, clamped to [0, 1]. `'exact'`: the
+     * Beta distribution's own quantile at the same one-sided level, Φ(−z), so `z` keeps its
+     * meaning. The two differ on thin evidence near the threshold, where the approximation is
+     * optimistic; under `'exact'`, `z: 0` is the median rather than the mean.
+     */
+    bound?: 'normal' | 'exact';
 }
 /**
  * One thing the user might be about to do, tracked as a Beta(α, β) distribution with

package/dist/presets.d.ts

@@ -14,6 +14,13 @@ interface RevealOptions {
     z?: number;
     /** How long after `markRevealed` the intent stays revealed and `shouldReveal` is false. Default: the intent's `halfLife`. */
     cooldown?: number;
+    /**
+     * How `lower` is computed. `'normal'` (default): p − z·sd, clamped to [0, 1]. `'exact'`: the
+     * Beta distribution's own quantile at the same one-sided level, Φ(−z), so `z` keeps its
+     * meaning. The two differ on thin evidence near the threshold, where the approximation is
+     * optimistic; under `'exact'`, `z: 0` is the median rather than the mean.
+     */
+    bound?: 'normal' | 'exact';
 }
 /**
  * One thing the user might be about to do, tracked as a Beta(α, β) distribution with

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oracular",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "On-device intent engine. Your app learns when the user is ready. Nothing leaves the device.",
   "keywords": [
     "oracular",
@@ -88,7 +88,7 @@
     "node": ">=18"
   },
   "scripts": {
-    "build": "tsup",
+    "build": "tsup && tsup --config tsup.presets.config.ts && tsup --config tsup.inspect.config.ts",
     "test": "vitest run",
     "test:watch": "vitest",
     "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.cli.json --noEmit && tsc -p tsconfig.test.json --noEmit",
@@ -113,6 +113,7 @@
     "@changesets/cli": "^3.0.3",
     "@size-limit/preset-small-lib": "^12.1.0",
     "@types/node": "^22.20.5",
+    "fast-check": "^4.10.2",
     "publint": "^0.3.25",
     "size-limit": "^12.1.0",
     "tsup": "^8.5.1",

package/schema/config.schema.json

@@ -120,6 +120,11 @@
           "type": "number",
           "minimum": 0,
           "description": "How long after a reveal or the outcome the intent stays quiet. Default: the intent's halfLife."
+        },
+        "bound": {
+          "type": "string",
+          "enum": ["normal", "exact"],
+          "description": "How lower is computed: the normal approximation p − z·sd (default) or the exact Beta quantile at the same one-sided level."
         }
       }
     },