oracular 0.7.1 → 0.8.1

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.1",
+  "version": "0.8.1",
   "description": "On-device intent engine. Your app learns when the user is ready. Nothing leaves the device.",
   "keywords": [
     "oracular",
@@ -87,6 +87,10 @@
   "engines": {
     "node": ">=18"
   },
+  "workspaces": [
+    ".",
+    "packages/*"
+  ],
   "scripts": {
     "build": "tsup && tsup --config tsup.presets.config.ts && tsup --config tsup.inspect.config.ts",
     "test": "vitest run",
@@ -97,20 +101,22 @@
     "smoke": "node scripts/smoke.cjs && node scripts/smoke.mjs && node scripts/smoke-cli.mjs",
     "size": "size-limit",
     "pack:check": "node scripts/pack-check.mjs",
-    "check": "npm run lint && npm run typecheck && npm test && npm run build && npm run smoke && npm run size && npm run pack:check",
-    "prepublishOnly": "npm run check",
+    "check:core": "npm run lint && npm run typecheck && npm test && npm run build && npm run smoke && npm run size && npm run pack:check",
+    "check": "npm run check:core",
+    "prepublishOnly": "npm run check:core",
     "docs:api": "typedoc",
     "docs:dev": "npm run docs:api && vitepress dev docs",
     "docs:build": "npm run docs:api && vitepress build docs",
     "docs:preview": "vitepress preview docs",
     "changeset": "changeset",
+    "release:version": "changeset version && npm install --package-lock-only --ignore-scripts",
     "release": "node scripts/release.mjs"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.5",
     "@biomejs/biome": "^2.5.15",
     "@changesets/changelog-github": "^1.0.1",
-    "@changesets/cli": "^3.0.3",
+    "@changesets/cli": "3.0.3",
     "@size-limit/preset-small-lib": "^12.1.0",
     "@types/node": "^22.20.5",
     "fast-check": "^4.10.2",

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."
         }
       }
     },