Align persistence defaults, harden prediction contracts, and clean up package surface

CALIBRATION_GUIDE.md

@@ -236,7 +236,7 @@ engine.on('trajectory_anomaly', (signal) => {
 ```typescript
 // Current API — poll predictNextStates after each navigation
 engine.on('state_change', () => {
-  const predictions = intent.predictNextStates(0.65);
+  const predictions = intent.predictNextStates(0.65, (state) => state.startsWith('/articles/'));
   for (const { state, probability } of predictions) {
     if (probability > 0.65) {
       const nextUrl = stateToUrlMap[state];

README.md

@@ -22,7 +22,7 @@
 
 **Website:** [passiveintent.dev](https://passiveintent.dev)
 
-This repository is structured as an **npm workspaces monorepo** containing all PassiveIntent packages.
+This repository is structured as an **npm workspaces monorepo** containing the active PassiveIntent packages.
 
 ---
 
@@ -41,6 +41,8 @@ Full documentation for each package lives inside the package directory:
 - **Remix adapter** — [packages/remix/README.md](./packages/remix/README.md)
 - **Architecture & API deep-dive** — [packages/core/docs/architecture.md](./packages/core/docs/architecture.md)
 
+Archived exploratory packages still live under `packages/`, but they are intentionally excluded from the active workspace and release flow.
+
 ---
 
 ## Repository layout

demo-react/DEMO.md

@@ -21,7 +21,7 @@ Built with Vite + TypeScript + the `usePassiveIntent` hook.
 | Idle Detection     | `user_idle` + `user_resumed`               | 2-min idle, resume with idleMs                   |
 | Exit Intent        | `exit_intent`                              | Smart — requires Markov confidence ≥ 0.4         |
 | Bloom Filter       | `hasSeen()` + `BloomFilter`                | O(k) membership, bit visualizer, sizing API      |
-| Markov Predictions | `predictNextStates()` + `MarkovGraph`      | Prefetch next page, binary vs JSON size          |
+| Markov Predictions | `predictNextStates(threshold, sanitize)` + `MarkovGraph` | Prefetch next page, binary vs JSON size |
 | Bot Detection      | `bot_detected`                             | EntropyGuard — 5-signal scoring system           |
 | Conversion         | `trackConversion()`                        | Local-only revenue correlation, zero egress      |
 | Counters           | `incrementCounter/getCounter/resetCounter` | Session counters, impression capping             |

demo/DEMO.md

@@ -60,7 +60,7 @@ npm run dev
 | Idle Detection       | `user_idle`, `user_resumed`                                 |
 | Exit Intent          | `exit_intent`, `likelyNext` prediction                      |
 | Bloom Filter         | `BloomFilter`, `computeBloomConfig()`, `hasSeen()`          |
-| Markov Predictions   | `predictNextStates()`, `MarkovGraph`, binary vs JSON        |
+| Markov Predictions   | `predictNextStates(threshold, sanitize)`, `MarkovGraph`, binary vs JSON |
 | Bot Detection        | `bot_detected`, EntropyGuard                                |
 | Conversion Tracking  | `trackConversion()`, `conversion` event                     |
 | Session Counters     | `incrementCounter()`, `getCounter()`, `resetCounter()`      |