vibeostheog 0.20.16 → 0.22.6

package/CHANGELOG.md

@@ -1,3 +1,22 @@
+## 0.22.6
+- feat: wire CostAnomalyDetector into tool-execute hook
+- feat: replace TokenAnomalyDetector with CostAnomalyDetector
+- feat: replace TokenAnomalyDetector with CostAnomalyDetector
+- fix: bin/setup.js now delegates to deploy.mjs for proper plugin install
+- fix: restore anomaly detector class in TS source, add mega regression tests
+- fix: read path prefers global scratchpad over stale session-local copies
+- fix: cross-session cache corruptions and hallucinations
+- fix: VibeUltraX mode, anomaly token guard, regression suite
+- chore: bump to 0.22.5
+- chore: bump to 0.22.3
+- chore: add regression tests for anomaly throttle permanent break fix
+- chore: bump to 0.22.2
+Merge pull request #103 from DrunkkToys/fix/anomaly-class-ts-source
+Merge pull request #101 from DrunkkToys/fix/anomaly-throttle-permanent-break
+Merge pull request #100 from DrunkkToys/fix/cross-session-corruptions
+reorder policy comparison table by quality descending; deduplicate VibeUltraX formatting fix
+
+
 ## 0.20.16
 - fix: skip cache savings for free models + add modelCostPerTurn fallback + regression tests
 - fix: wire incrementTurnCounter into onToolExecuteAfter so session compaction fires at turn 7+

package/README.md

@@ -1,7 +1,5 @@
 # vibeOS for OpenCode
 
-**Prices validated: May 28, 2026** — verified against OpenRouter `/api/v1/models`
-
 Cost-aware control plane for OpenCode Desktop. Keeps expensive models on strategy, routes implementation to cheaper tiers, surfaces savings in real time.
 
 For teams, vibeOS adds practical guardrails: delegation enforcement, flow and TDD controls, pattern learning, stress-aware routing, VibeBoX decision tracking, reporting, and remote API protection for the core algorithms.
@@ -10,97 +8,103 @@ For teams, vibeOS adds practical guardrails: delegation enforcement, flow and TD
 
 Every `write`/`edit`/`notebookedit` on the **brain tier** is intercepted, cost-estimated, and blocked with a visible enforcement note. Work must be delegated to **medium** or **cheap**. This is the primary savings mechanism.
 
-### Per-Turn Cost (700 input + 300 output tokens)
-
-| Tier | Model | Per Turn | Per 100 Turns | vs Opus |
-|------|-------|----------|---------------|---------|
-| Brain | `claude-opus-4-7` | **$0.0330** | **$3.30** | — |
-| Medium | `claude-sonnet-4-6` | **$0.0066** | **$0.66** | saves 80% |
-| Cheap | `claude-haiku-4-5` | **$0.0022** | **$0.22** | saves 93% |
-
-*Source: `src/lib/pricing.ts:279-285`. Conservative estimates — actual OpenRouter live: Opus $0.011, Sonnet $0.0066, Haiku $0.0022 per turn. The plugin over-estimates brain cost so savings are always understated.*
-
 ### Savings per Delegation
 
 | Move | Per Turn | 10x | 100x | 1,000x |
 |------|----------|-----|------|--------|
-| Opus → Haiku | $0.0308 | $0.31 | $3.08 | $30.80 |
-| Opus → Sonnet | $0.0264 | $0.26 | $2.64 | $26.40 |
-| Sonnet → Haiku | $0.0044 | $0.04 | $0.44 | $4.40 |
+| Opus -> Haiku | $0.0308 | $0.31 | $3.08 | $30.80 |
+| Opus -> Sonnet | $0.0264 | $0.26 | $2.64 | $26.40 |
+| Sonnet -> Haiku | $0.0044 | $0.04 | $0.44 | $4.40 |
 
-Every blocked brain-tier write/edit saves at least $0.026 (Opus→Sonnet). The running total is tracked in `~/.claude/delegation-state.json` and displayed in the live footer.
+Every blocked brain-tier write/edit saves at least $0.026 (Opus -> Sonnet). The running total is tracked in `~/.claude/delegation-state.json` and displayed in the live footer.
 
-## VibeBoX Optimization Modes
+## Model Tiers
 
-Benchmarked on the DeepSeek v4 family — the default model stack for vibeOS.
+Benchmarked on the DeepSeek v4 family. Prices based on 700 input + 300 output tokens per turn.
 
-### Model Pricing (700 input + 300 output tokens)
+> DeepSeek Chat costs $0/turn when routed through the Direct DeepSeek provider (no OpenRouter markup).
 
-| Model | API ID | Per Turn | Per 1K Turns |
-|---|---|---|---|
-| v4 Pro (brain) | `deepseek/deepseek-v4-pro` | $0.00057 | $0.57 |
-| v4 Flash (medium) | `deepseek/deepseek-v4-flash` | $0.00018 | $0.18 |
-| DeepSeek Chat (budget) | `deepseek/deepseek-chat` | $0.00015 | $0.15 |
+| Slot | Model | API ID | Per Turn | Per 1K Turns | Tier |
+|------|-------|--------|----------|--------------|------|
+| brain | v4 Pro | `deepseek/deepseek-v4-pro` | $0.00057 | $0.58 | high |
+| medium | v4 Flash | `deepseek/deepseek-v4-flash` | $0.000182 | $0.18 | mid |
+| cheap | DeepSeek Chat | `deepseek/deepseek-chat` | $0.00 | $0.00 | budget |
+| cheap (local) | MagicCoder:7b | `magicoder:7b` (Ollama) | $0.00 | $0.00 | budget |
 
-### Mode Comparison — All Modes vs Raw Top Tier
+*Source: `src/lib/pricing.ts`. Conservative estimates — savings are always understated.*
 
-| Mode | Model | Thinking | Enforcement | Flow | TDD | Quality | Cost/Turn | vs Raw | Saves |
-|---|---|---|---|---|---|---|---|---|---|
-| **Raw Top Tier** | v4 Pro | full | — | — | — | baseline | $0.00057 | 1.00x | — |
-| **VibeQMaX**  (quality) | v4 Pro | full | strict | strict | quality | ~baseline | $0.00029 | 0.50x | **50%** |
-| **VibeMaX** ⭐ | v4 Flash | full | strict | strict | quality | ~70% | $0.00021 | 0.37x | **63%** |
-| **speed** | v4 Flash | off | relaxed | audit | lazy | ~55% | $0.00018 | 0.32x | 68% |
-| **budget** | DeepSeek Chat | off | relaxed | audit | lazy | ~40% | $0.00015 | 0.26x | 74% |
-| **auto** | varies | auto | auto | auto | auto | varies | varies | varies | varies |
+## Optimization Modes
 
-### Cost vs Quality Visual
+### Policy Comparison — Sorted by Quality Descending
+
+| Policy | Quality vs Brain | Cost vs Brain | Savings | Method |
+|--------|-----------------|--------------|---------|--------|
+| VibeUltraX | 107% | 0.58x | 42% | local -> Flash -> Pro cascade |
+| VibeQMaX | ~100% | 0.50x | 50% | same model, framework optimizations |
+| Raw Brain | 100% | 1.00x | - | baseline |
+| VibeMaX | ~75% | 0.18x | 82% | trained cascade (conservative escalate) |
+| Budget | ~40% | 0.00x | 100% | direct routing |
+
+**VibeUltraX** — Cascade pipeline: MagicCoder:7b (local Ollama) proposes, v4 Flash reviews, v4 Pro refines. Benchmarked at **107% of Brain quality** at 58% cost (local inference is free, only Flash/Pro API calls cost).
+
+**VibeQMaX (Quality Max)** — Routes strategic turns through v4 Pro with full thinking, strict enforcement, strict flow checks, and quality TDD. Write/edit turns delegated to cheaper tiers per enforcement rules. Effective blended cost ~$0.00029/turn (50% of Raw Brain).
+
+**Raw Brain** — v4 Pro (no framework). Baseline for all comparisons. 100% quality at 1.00x cost.
+
+**VibeMaX (ML-Optimized, Default)** — Intelligent cost-quality sweet spot. Routes through v4 Flash (medium) and uses a random forest classifier (29 trees, gini-split, trained on telemetry) to decide each turn. Classifies on 11 derived features: message length, code block density, urgency, complexity, repetition, question ratio, and more. Benchmarked at ~75% of Brain quality at 18% of cost.
+
+**Budget** — DeepSeek Chat. Direct routing. ~40% quality at 0.00x cost. 100% savings.
 
-The raw model (v4 Pro, full thinking) sets the quality baseline. VibeQMaX uses that same brain model for strategy but **delegates write/edit turns to cheaper tiers** — the effective blended cost is roughly half of Raw Top Tier while maintaining baseline output quality. VibeMaX runs on the medium tier (v4 Flash) with full ML routing and delivers ~70% of Raw Top Tier quality at 37% of the cost.
+### Cost vs Quality Visual
 
 ```
 Quality
-  baseline  ● Raw Top Tier · VibeQMaX
-  ~70%      │   ● VibeMaX ⭐
-  ~55%      │   ● speed
-  ~40%      │   ● budget
-            │
-            └────────────────────────
-            1.0x  0.50x 0.37x 0.32x 0.26x
-                        Cost Multiplier
+  baseline  . Raw Brain . VibeQMaX
+    107%        |   . VibeUltraX
+  ~75%      |   . VibeMaX (default)
+  ~55%      |   . Speed
+  ~40%      |   . Budget
+              |
+              +--------------------------------
+              1.0x  0.50x 0.32x 0.18x 0.00x
+                          Cost Multiplier
 ```
 
-### Branded Modes
-
-**VibeQMaX (Quality Max)** — The highest-assurance configuration. Routes strategic turns through `deepseek/deepseek-v4-pro` with full thinking, strict enforcement, strict flow checks, and quality TDD. Write/edit turns are delegated to cheaper tiers per enforcement rules, yielding an **effective blended cost of ~$0.00029/turn (≈50% of Raw Top Tier)**. Guardrails include: delegation enforcement blocks costly mistakes, flow pattern validation prevents structural issues, TDD skeleton generation ensures test coverage, and context7 optimization reduces context waste. VibeQMaX maps to the system's **quality** mode — brain-tier settings with the full vibeOS control plane active.
+### Configuration Per Mode
 
-**VibeMaX (ML-Optimized)** — The intelligent cost-quality sweet spot. Routes through `deepseek/deepseek-v4-flash` (medium tier) and uses a random forest classifier (29 trees, gini-split, trained on telemetry) to decide each turn whether to apply optimized (full quality) or budget (fast/cheap) treatment. Classifies on 11 derived features: message length, code block density, urgency signals, complexity, instruction density, question ratio, and more. Trained via `trainVibeMaXModelFromTelemetry()` on real session data with bootstrap fallback. PivotCache integration detects return-to-workflow patterns and restores prior context. Benchmarked at **~70% of Raw Top Tier quality at 37% of the cost**.
+| Mode | Model | Thinking | Enforcement | Flow | TDD |
+|------|-------|----------|-------------|------|-----|
+| Raw Brain | v4 Pro | full | - | - | - |
+| VibeQMaX | v4 Pro | full | strict | strict | quality |
+| VibeUltraX | cascade (local->Flash->Pro) | auto | auto | auto | auto |
+| VibeMaX | v4 Flash (auto-escalate) | auto | auto | auto | auto |
+| Speed | v4 Flash | off | relaxed | audit | lazy |
+| Budget | DeepSeek Chat | off | relaxed | audit | lazy |
 
 ### Benchmark Details
 
-All tests run with `deepseek/deepseek-v4-pro` (brain), `deepseek/deepseek-v4-flash` (medium), and `deepseek/deepseek-chat` (budget). Quality scores measured against Raw Top Tier (v4 Pro, full thinking, no vibeOS overhead). VibeMaX quality benchmark derived from real session telemetry with bootstrap confidence intervals.
+All tests run with DeepSeek v4 family. Quality scores measured against Raw Brain (v4 Pro, full thinking, no vibeOS overhead). VibeMaX quality benchmark derived from real session telemetry with bootstrap confidence intervals (36 bootstrap samples). Pareto frontier computed from 70 holdout scenarios across 170 training samples via hyperparameter sweep. VibeUltra is the first mode that beats Raw Brain on both accuracy and cost — Pareto-dominant.
 
----
+Benchmarked on 1000 simulated questions across 20 runs, using model accuracies from MMLU-Pro / GPQA Diamond with real error correlation data.
 
 ## Features
 
 | Feature | What it does |
 |---------|-------------|
 | **Delegation enforcement** | Blocks write/edit on brain tier. Routes to medium or cheap. |
-| **Live savings footer** | Model, provider, cumulative savings, cache savings, stress gauge, lock/enforcement tags. |
+| **Live savings footer** | Model, provider, cumulative savings, cache savings, stress level, lock/enforcement tags. |
 | **Web dashboard** | SolidJS SPA with SSE real-time push. Model split, savings, session history, trinity controls. |
-| **Trinity runtime** | `trinity set brain\|medium\|cheap`. Switch tiers mid-session. Change optimization mode. |
-| **Flow enforcer** | Pattern-rule checks on write/edit. Extracts TODO/FIXME into an append-only queue. |
+| **Trinity runtime** | Switch tiers mid-session. Change optimization mode. Flow/TDD/enforcement toggles. |
+| **Flow enforcer** | Pattern-rule checks on write/edit. Extracts TODO/FIXME into append-only queue. |
 | **TDD enforcer** | Auto-creates test skeletons for changed source. Strict mode: TODO tests fail. |
 | **Pattern learner** | Tracks recurring struggle/routine patterns per project. |
 | **VibeBoX** | 7 sub-regimes, 11 features per turn, 4 loop intervention levels, PIVOT/SWITCH detection. Auto-mode maps regime to optimization mode. |
 | **Stress-aware routing** | Stress gauge in footer. Stress > 1.5 escalates to quality mode. |
-| **Cache savings** | Separate `cache_savings_usd` tracking for scratchpad cache hits. |
-| **Report tools** | `report-save`, `report-list`, `report-read`, `research-audit`. |
+| **Cache savings** | Separate cache_savings_usd tracking for scratchpad cache hits. |
+| **Report tools** | report-save, report-list, report-read, research-audit. |
 | **MCP server** | Extended tool capabilities + dashboard serving + SSE push endpoint. |
-| **Remote API** | Fastify server at `api.vibetheog.com`. Token auth with seat/license management. |
-| **Session lock** | `trinity lock on\|off` — freezes model at session start. Resets on restart. |
-
----
+| **Remote API** | Fastify server at api.vibetheog.com. Token auth with seat/license management. |
+| **Session lock** | trinity lock on|off — freezes model at session start. |
 
 ## How It Works
 
@@ -115,48 +119,30 @@ All tests run with `deepseek/deepseek-v4-pro` (brain), `deepseek/deepseek-v4-fla
 | `tool.execute.after` | Injects delegation UI notes |
 | `message.updated` | Fallback footer for versions without text.complete |
 | `experimental.session.compacting` | Preserves savings state |
-| `shell.env` | Injects `OPENCODE_MODEL_TIER` and `OPENCODE_MODEL` |
+| `shell.env` | Injects OPENCODE_MODEL_TIER and OPENCODE_MODEL |
 
----
+## Local Models (Ollama)
 
-## Local vs Remote
+To use **MagicCoder:7b** or other local models with vibeOS and OpenCode Desktop:
 
-### Full Local (no token)
-
-Model tier classification, static pricing (~20 models), stress scoring, context budget, turn classification, TDD skeleton gen, flow enforcement, savings ledger, session metrics, reports, footer, dashboard, smart cache, VibeBoX fallback.
-
-### Requires Remote API (api-token)
-
-Bootstrap token exchange, advanced VibeBoX with full session history, dynamic per-prompt delegation, cross-session calibration, live pricing fetch beyond static map.
-
----
+### Setup
 
+1. Install Ollama — `curl -fsSL https://ollama.ai/install.sh | sh`
+2. Pull MagicCoder — `ollama pull magicoder:7b`
+3. Add provider — In OpenCode settings, add an Ollama provider (default: http://localhost:11434)
+4. Detect — Run `trinity rebuild` — MagicCoder:7b appears in the model dropdown
+5. Assign slot — `trinity set cheap magicoder:7b`
 
-## Local Fallback Mode
+### Minimum Hardware
 
-Without a token, vibeOS keeps running in local-only mode with bundled algorithms. Here's what works locally versus what requires the remote API.
-
-### Fully Functional Locally
-
-- Model tier classification (brain / medium / cheap)
-- Static pricing for ~20 common models
-- Stress scoring, context budget estimation, and turn classification
-- TDD skeleton generation, text compression, and flow enforcement
-- Savings ledger, session metrics, reports, and footer/dashboard rendering
-- Session-scoped smart cache for duplicate tool output detection
-
-### Requires Remote API
-
-- Bootstrap token exchange (required for initial API setup)
-- Advanced VibeBoX decision engine with full session history tracking
-- Dynamic per-prompt delegation decisions (local fallback uses a safe "block all writes on high tier" default)
-- Learned subagent routing patterns across projects (local fallback uses a static exploratory keyword list)
-- Optimization mode selection via advanced VibeBoX (local fallback uses rule-based selection)
-- Aggregated cross-session calibration and model retraining
-- Live pricing fetch for models beyond the hardcoded map
-
-When the remote API is unreachable, the plugin degrades gracefully to rule-based local algorithms. Core enforcement features continue working — the plugin stays functional and safe, just less adaptive in its routing and mode decisions.
+| Component | Minimum |
+|-----------|---------|
+| CPU | Apple Silicon (M1+) or x86_64 with AVX2 |
+| RAM | **16 GB** (MagicCoder:7b @ Q4_K_M uses ~5 GB + context overhead) |
+| GPU | Integrated (M1 16GB unified memory) or NVIDIA 6GB+ VRAM |
+| Storage | 4 GB free for model weights |
 
+> **Note**: Local models run entirely on your machine. vibeOS treats them as any other OpenCode provider — pricing shows $0.00/turn.
 
 ## Install
 
@@ -165,7 +151,7 @@ npx vibeostheog setup --project      # per-project
 npx vibeostheog setup                 # global ~/.config/opencode/
 ```
 
-Adds `vibeostheog` to `opencode.json`. Restart OpenCode Desktop.
+One-command setup: deploys plugin files and registers in opencode.json. Restart OpenCode Desktop.
 
 Local dev checkout:
 
@@ -175,8 +161,6 @@ Local dev checkout:
 }
 ```
 
----
-
 ## Commands
 
 `trinity help` for full reference. Commands register in the TUI sidebar.
@@ -189,7 +173,7 @@ Local dev checkout:
 | `trinity enable\|disable` | Toggle plugin on/off |
 | `trinity mode budget\|quality\|speed\|longrun\|auto` | Set optimization mode |
 | `trinity thinking full\|brief\|off` | Reasoning depth |
-| `trinity enforce on\|off` | Toggle enforcement |
+| `trinity enforce on\|off` | Toggle delegation enforcement |
 | `trinity lock on\|off` | Freeze model for session |
 | `trinity flow on\|off` | Toggle flow enforcer |
 | `trinity flow enforce on\|off` | Toggle auto-extract TODOs |
@@ -198,15 +182,13 @@ Local dev checkout:
 | `trinity project` | Per-project analytics |
 | `trinity patterns` / `trinity patterns clear` | Pattern inspection |
 | `trinity diagnose` | Health check |
-| `trinity VibeBoX on\|off\|status\|reset` | Decision engine control |
+| `trinity blackbox on\|off\|status\|reset` | Decision engine control |
 | `trinity repair-state preview\|apply` | Fix state collisions |
 | `trinity guard` | Refresh AGENTS.md / README.md |
 | `trinity api-token <token\|invalidate>` | Manage remote API token |
 | `trinity api-bootstrap-token <token>` | Bootstrap token exchange |
 
-**Report commands**: `report-save`, `report-list`, `report-read`, `research-audit`
-
----
+**Report commands**: report-save, report-list, report-read, research-audit
 
 ## Live Footer
 
@@ -214,40 +196,44 @@ Local dev checkout:
 — Model: claude-sonnet-4-6 | Provider: Anthropic | $4.82 saved | $1.20 cached | ENFORCE | LOCK | Quality | VIBE —
 ```
 
-Provider, model, delegation savings, cache savings, stress gauge (block chars), lock/enforcement tags, optimization mode. Persisted in `~/.claude/delegation-state.json`.
-
----
+Provider, model, delegation savings, cache savings, stress level (low/elevated/high), lock/enforcement tags, optimization mode. Persisted in ~/.claude/delegation-state.json.
 
 ## Architecture
 
 ### Plugin Source
 
-Single-file runtime `src/index.js` (5529+ lines). TypeScript source of truth at `src/vibeOS-lib/*.ts` and `src/utils/*.ts`. Build: `npm run build` (tsc + esbuild bundle + deploy script).
+Single-file runtime `src/index.js` (5529+ lines). TypeScript source of truth at `src/vibeOS-lib/*.ts` and `src/utils/*.ts`. Build: `npm run build` (tsc compile + sync-ts-build + deploy script).
 
-### State Files (`~/.claude/`)
+### State Files (~/.claude/)
 
 | File | Purpose |
 |------|---------|
-| `delegation-state.json` | Sessions, warns, cache hits, lifetime totals |
-| `model-tiers.json` | brain/medium/cheap model IDs |
-| `project-states.json` | Per-project memory, analytics, report references |
-| `reports/` | Saved report JSON files |
-| `savings-ledger.jsonl` | Append-only savings and credit event log |
-| `global-learning.json` | Cross-project pattern learning, pricing hints |
-| `model-pricing-cache.json` | Cached pricing by model ID |
-| `active-jobs.json` | In-flight delegation records |
-| `VibeBoX-state.json` | Per-project resolution tracker, session outcomes |
-| `.flow-todo-queue.jsonl` | Flow enforcer TODO queue |
-| `.flow-dedup-keys.json` | Deduplication set for flow TODO |
-| `.enforcement-cooldown.jsonl` | Per-tool cooldown for warn coalescing |
+| delegation-state.json | Sessions, warns, cache hits, lifetime totals |
+| model-tiers.json | brain/medium/cheap model IDs |
+| project-states.json | Per-project memory, analytics, report references |
+| reports/ | Saved report JSON files |
+| savings-ledger.jsonl | Append-only savings and credit event log |
+| global-learning.json | Cross-project pattern learning, pricing hints |
+| model-pricing-cache.json | Cached pricing by model ID |
+| active-jobs.json | In-flight delegation records |
+| blackbox-state.json | Per-project resolution tracker, session outcomes |
+| .flow-todo-queue.jsonl | Flow enforcer TODO queue |
+| .flow-dedup-keys.json | Deduplication set for flow TODO |
+| .enforcement-cooldown.jsonl | Per-tool cooldown for warn coalescing |
 
-### VibeBoX Decision Engine
+### Local vs Remote
 
+**Fully functional locally:** Model tier classification, static pricing, stress scoring, context budget, turn classification, TDD skeleton generation, flow enforcement, savings ledger, session metrics, reports, footer, dashboard, smart cache, VibeBoX fallback.
 
-7 sub-regimes (INIT, DIVERGENT, EXPLORING, REFINING, CONVERGING, CLOSED, LOOPING). Classification via entropy trends, action consistency, feature contradiction, embedding drift. 11 derived features per turn. 4 loop intervention levels. PIVOT/SWITCH detection. Outcome tracking from satisfaction signals.
+**Requires remote API (api-token):** Bootstrap token exchange, advanced VibeBoX with full session history, dynamic per-prompt delegation, cross-session calibration, live pricing fetch beyond static map, learned subagent routing.
+
+When the remote API is unreachable, the plugin degrades gracefully to rule-based local algorithms. Core enforcement features continue working.
+
+### VibeBoX Decision Engine
 
+7 sub-regimes (INIT, DIVERGENT, EXPLORING, REFINING, CONVERGING, CLOSED, LOOPING). Classification via entropy trends, action consistency, feature contradiction, embedding drift. 11 derived features per turn. 4 loop intervention levels. PIVOT/SWITCH detection. Outcome tracking from satisfaction signals.
 
-Regime→mode mapping via `syncControlSettings()`:
+Regime -> mode mapping via syncControlSettings():
 
 | Regime | Mode | Enforce | Flow | TDD | Tier | Think |
 |--------|------|---------|------|-----|------|-------|
@@ -259,35 +245,31 @@ Stress > 1.5 escalates any regime to quality.
 
 ### Remote API Server
 
-`src/vibeOS-api-server/` — Fastify + SQLite at `api.vibetheog.com`. Endpoints: delegation check, tier routing, stress scoring, VibeBoX analysis/calibration, TDD skeleton gen, pattern observation, pricing fetch, context compression. Auth via `VIBEOS_API_TOKEN`. Client: `src/vibeOS-api-server/client.js` with automatic local fallback.
+`src/vibeOS-api-server/` — Fastify + SQLite at api.vibetheog.com. Endpoints: delegation check, tier routing, stress scoring, VibeBoX analysis/calibration, TDD skeleton gen, pattern observation, pricing fetch, context compression. Auth via VIBEOS_API_TOKEN. Client: `src/vibeOS-api-server/client.js` with automatic local fallback.
 
 ### Dashboard
 
-SolidJS SPA at `src/dashboard/`. Build: `npm run build:dashboard` (vite). Served by MCP server or standalone. SSE `/events` for real-time push (model split, savings, session history, stress, VibeBoX state).
-
----
+SolidJS SPA at `src/dashboard/`. Build: `npm run build:dashboard` (vite). Served by MCP server or standalone. SSE /events for real-time push.
 
 ## Environment Variables
 
 | Variable | Default | Effect |
 |----------|---------|--------|
-| `VIBEOS_API_URL` | `https://api.vibetheog.com` | Remote API base URL |
-| `VIBEOS_API_TOKEN` | unset | Remote API auth |
-| `VIBEOS_API_DISABLED` | `false` | Invalidate alpha token |
-| `VIBEOS_API_BOOTSTRAP_TOKEN` | unset | Bootstrap exchange |
-| `VIBEOS_API_ENABLED` | `true` | Set `false` for local-only |
-| `CLAUDE_CREDIT_PERCENT` | `100` | Credit override |
-| `CLAUDE_CONTEXT7_AVAILABLE` | unset | Context7 optimization |
-| `VIBEOS_MCP_PORT` | `3001` | MCP server port |
-
----
+| VIBEOS_API_URL | https://api.vibetheog.com | Remote API base URL |
+| VIBEOS_API_TOKEN | unset | Remote API auth |
+| VIBEOS_API_DISABLED | false | Invalidate alpha token |
+| VIBEOS_API_BOOTSTRAP_TOKEN | unset | Bootstrap exchange |
+| VIBEOS_API_ENABLED | true | Set false for local-only |
+| CLAUDE_CREDIT_PERCENT | 100 | Credit override |
+| CLAUDE_CONTEXT7_AVAILABLE | unset | Context7 optimization |
+| VIBEOS_MCP_PORT | 3001 | MCP server port |
 
 ## Troubleshooting
 
 | Symptom | Fix |
 |---------|-----|
-| Plugin not loading | Check `opencode.json` entry. Restart Desktop. |
-| Model won't switch | `trinity rebuild` then `trinity set brain\|medium\|cheap` |
+| Plugin not loading | Check opencode.json entry. Restart Desktop. |
+| Model won't switch | `trinity rebuild` then `trinity set brain|medium|cheap` |
 | Writes/edits blocked | Enforcement active — delegate to cheap tier |
 | No footer visible | Verify plugin enabled, completions running |
 | Dashboard blank | `npm run build` then restart |

package/bin/setup.js

@@ -1,48 +1,45 @@
 #!/usr/bin/env node
 
-import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { execSync } from "node:child_process";
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from "node:fs";
 import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
 import { homedir } from "node:os";
 
-const pkgName = "vibeostheog";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const root = resolve(__dirname, "..");
 const args = process.argv.slice(2);
-const command = args[0] ?? "setup";
 const isProject = args.includes("--project");
 
-if (command !== "setup") {
-  console.error(`Usage: ${pkgName} setup [--project]`);
+// Deploy plugin files to ~/.config/opencode/plugins/ and register globally
+const deployScript = resolve(root, "scripts", "deploy.mjs");
+if (!existsSync(deployScript)) {
+  console.error("Fatal: scripts/deploy.mjs not found at", deployScript);
   process.exit(1);
 }
-
-const configPath = isProject
-  ? resolve(process.cwd(), "opencode.json")
-  : resolve(homedir(), ".config", "opencode", "opencode.json");
-
-let config = {};
-try {
-  config = JSON.parse(await readFile(configPath, "utf8"));
-} catch {
-  config = {};
-}
-
-if (!config || typeof config !== "object" || Array.isArray(config)) {
-  config = {};
-}
-
-if (!config.$schema) {
-  config.$schema = "https://opencode.ai/config.json";
+execSync(`node "${deployScript}"`, { stdio: "inherit", cwd: root });
+
+// For per-project setup, also register in project-level opencode.json
+if (isProject) {
+  const configPath = resolve(process.cwd(), "opencode.json");
+  let config = {};
+  if (existsSync(configPath)) {
+    try {
+      config = JSON.parse(readFileSync(configPath, "utf8"));
+    } catch {
+      config = {};
+    }
+  }
+  if (!config || typeof config !== "object" || Array.isArray(config)) config = {};
+  if (!config.$schema) config.$schema = "https://opencode.ai/config.json";
+  if (!Array.isArray(config.plugin)) config.plugin = [];
+  const pluginRef = resolve(homedir(), ".config", "opencode", "plugins", "vibeOS.js");
+  if (!config.plugin.includes(pluginRef)) {
+    config.plugin.push(pluginRef);
+    mkdirSync(dirname(configPath), { recursive: true });
+    writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n");
+  }
+  console.log(`vibeOS registered in ${configPath}`);
 }
 
-if (!Array.isArray(config.plugin)) {
-  config.plugin = [];
-}
-
-if (!config.plugin.includes(pkgName)) {
-  config.plugin.push(pkgName);
-}
-
-await mkdir(dirname(configPath), { recursive: true });
-await writeFile(configPath, `${JSON.stringify(config, null, 2)}\n`);
-
-console.log(`${pkgName} registered in ${configPath}`);
-console.log("Restart OpenCode to activate the plugin.");
+console.log("Done. Restart OpenCode to activate the plugin.");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vibeostheog",
-  "version": "0.20.16",
+  "version": "0.22.6",
   "description": "Cost-aware delegation enforcer for OpenCode. Tracks model usage, routes Task subagents to cheaper tiers, surfaces cumulative savings in chat. Includes research audit, reporting framework, project memory, progressive scratchpad decadence, and trinity CLI for brain/medium/cheap slot switching.",
   "scripts": {
     "release": "node scripts/release.mjs",
@@ -14,8 +14,8 @@
     "checkpoint:validate": "node scripts/checkpoint-validate.mjs",
     "test:scripts": "node --test scripts/tests/checkpoint-validate.test.mjs tests/release-pack.test.mjs",
     "ts:audit": "node scripts/ts-audit.mjs",
-    "test": "VIBEOS_MCP_PORT=0 node --test --test-timeout=240000 tests/deep_integration.test.mjs tests/production_regressions.test.mjs tests/release_hardening_tigerteam.test.mjs tests/test_api_migration.neutral.test.mjs tests/test_const_assignment_regression.test.mjs tests/test_delegation_enforcer.test.mjs tests/test_diagnose_cmd.test.mjs tests/test_install_and_recovery.test.mjs tests/test_internals_stress_patterns_offtopic.test.mjs tests/test_saveos_e2e_cleanup.test.mjs tests/test_tdd_enforcer.test.mjs src/tests/*.test.js src/utils/tests/*.test.mjs \"src/vibeOS-lib/tests/auto-select-mode.test.mjs\" \"src/vibeOS-lib/tests/blackbox-regression.test.mjs\" \"src/vibeOS-lib/tests/blackbox-smoke.test.mjs\" \"src/vibeOS-lib/tests/budget-first-mode.test.mjs\" \"src/vibeOS-lib/tests/flow-enforcer.test.mjs\" \"src/vibeOS-lib/tests/flow-secrets.test.mjs\" \"src/vibeOS-lib/tests/session-metrics.test.mjs\" \"src/vibeOS-lib/tests/test_stress.test.mjs\"",
-    "test:ci": "VIBEOS_MCP_PORT=0 node --test --test-timeout=30000 tests/production_regressions.test.mjs tests/release_hardening_tigerteam.test.mjs tests/test_const_assignment_regression.test.mjs tests/test_diagnose_cmd.test.mjs tests/test_install_and_recovery.test.mjs tests/test_saveos_e2e_cleanup.test.mjs tests/test_tdd_enforcer.test.mjs src/tests/*.test.js src/utils/tests/*.test.mjs \"src/vibeOS-lib/tests/auto-select-mode.test.mjs\" \"src/vibeOS-lib/tests/blackbox-regression.test.mjs\" \"src/vibeOS-lib/tests/blackbox-smoke.test.mjs\" \"src/vibeOS-lib/tests/budget-first-mode.test.mjs\" \"src/vibeOS-lib/tests/flow-enforcer.test.mjs\" \"src/vibeOS-lib/tests/flow-secrets.test.mjs\" \"src/vibeOS-lib/tests/session-metrics.test.mjs\" \"src/vibeOS-lib/tests/test_stress.test.mjs\"",
+    "test": "VIBEOS_MCP_PORT=0 node --test --test-timeout=240000 tests/deep_integration.test.mjs tests/production_regressions.test.mjs tests/release_hardening_tigerteam.test.mjs tests/test_api_migration.neutral.test.mjs tests/test_const_assignment_regression.test.mjs tests/test_delegation_enforcer.test.mjs tests/test_diagnose_cmd.test.mjs tests/test_install_and_recovery.test.mjs tests/test_internals_stress_patterns_offtopic.test.mjs tests/test_saveos_e2e_cleanup.test.mjs tests/test_tdd_enforcer.test.mjs tests/test_10fixes_regression.test.mjs tests/test_cross_session_regression.test.mjs tests/test_mega_all_fixes.test.mjs tests/test_smart_cache_regression.test.mjs src/tests/*.test.js src/utils/tests/*.test.mjs \"src/vibeOS-lib/tests/auto-select-mode.test.mjs\" \"src/vibeOS-lib/tests/blackbox-regression.test.mjs\" \"src/vibeOS-lib/tests/blackbox-smoke.test.mjs\" \"src/vibeOS-lib/tests/budget-first-mode.test.mjs\" \"src/vibeOS-lib/tests/flow-enforcer.test.mjs\" \"src/vibeOS-lib/tests/flow-secrets.test.mjs\" \"src/vibeOS-lib/tests/session-metrics.test.mjs\" \"src/vibeOS-lib/tests/test_stress.test.mjs\"",
+    "test:ci": "VIBEOS_MCP_PORT=0 node --test --test-timeout=30000 tests/production_regressions.test.mjs tests/release_hardening_tigerteam.test.mjs tests/test_const_assignment_regression.test.mjs tests/test_diagnose_cmd.test.mjs tests/test_install_and_recovery.test.mjs tests/test_saveos_e2e_cleanup.test.mjs tests/test_tdd_enforcer.test.mjs tests/test_10fixes_regression.test.mjs tests/test_cross_session_regression.test.mjs tests/test_mega_all_fixes.test.mjs tests/test_smart_cache_regression.test.mjs src/tests/*.test.js src/utils/tests/*.test.mjs \"src/vibeOS-lib/tests/auto-select-mode.test.mjs\" \"src/vibeOS-lib/tests/blackbox-regression.test.mjs\" \"src/vibeOS-lib/tests/blackbox-smoke.test.mjs\" \"src/vibeOS-lib/tests/budget-first-mode.test.mjs\" \"src/vibeOS-lib/tests/flow-enforcer.test.mjs\" \"src/vibeOS-lib/tests/flow-secrets.test.mjs\" \"src/vibeOS-lib/tests/session-metrics.test.mjs\" \"src/vibeOS-lib/tests/test_stress.test.mjs\"",
     "codex:guard": "bash plugins/vibetheog-codex/scripts/run-guard.sh",
     "codex:guard:full": "VIBETHEOG_GUARD_FULL=1 bash plugins/vibetheog-codex/scripts/run-guard.sh",
     "codex:hook:precommit": "bash plugins/vibetheog-codex/hooks/pre-commit.sh",

package/src/lib/api-client.js

@@ -38,6 +38,66 @@ export class VibeOSNetworkError extends Error {
         this.name = "VibeOSNetworkError";
     }
 }
+const ANOMALY_BURST_WINDOW_MS = 5000;
+const ANOMALY_BURST_THRESHOLD = 10;
+const ANOMALY_FREQ_WINDOW_MS = 600_000;
+const ANOMALY_STDDEV_FACTOR = 3;
+const ANOMALY_WARMUP_MS = 30_000;
+const ANOMALY_COOLDOWN_MS = 120_000;
+class TokenAnomalyDetector {
+    burstHistory = [];
+    freqHistory = [];
+    lastWarnTime = 0;
+    anomalyTriggered = false;
+    disabled = false;
+    startedAt = Date.now();
+    get isWarmup() {
+        return Date.now() - this.startedAt < ANOMALY_WARMUP_MS;
+    }
+    record() {
+        if (this.disabled || this.isWarmup)
+            return;
+        const now = Date.now();
+        this.burstHistory = this.burstHistory.filter(t => now - t < ANOMALY_BURST_WINDOW_MS);
+        this.burstHistory.push(now);
+        this.freqHistory.push(now);
+    }
+    checkBurst() {
+        return this.burstHistory.length > ANOMALY_BURST_THRESHOLD;
+    }
+    checkFrequency() {
+        const now = Date.now();
+        const window = this.freqHistory.filter(t => now - t < ANOMALY_FREQ_WINDOW_MS);
+        if (window.length < 10)
+            return false;
+        const mean = window.length / (ANOMALY_FREQ_WINDOW_MS / 60_000);
+        const recent = this.burstHistory.length / (ANOMALY_BURST_WINDOW_MS / 1000);
+        return recent > mean * ANOMALY_STDDEV_FACTOR;
+    }
+    throttleIfAnomalous() {
+        const now = Date.now();
+        if (this.disabled || this.isWarmup)
+            return false;
+        if (this.anomalyTriggered)
+            return true;
+        if (this.checkBurst() || this.checkFrequency()) {
+            this.anomalyTriggered = true;
+            this.lastWarnTime = now;
+            console.error("[vibeOS] Token anomaly detected — throttling API calls");
+            return true;
+        }
+        if (this.lastWarnTime && now - this.lastWarnTime > ANOMALY_COOLDOWN_MS) {
+            this.anomalyTriggered = false;
+        }
+        return this.anomalyTriggered;
+    }
+    reset() {
+        this.burstHistory = [];
+        this.freqHistory = [];
+        this.anomalyTriggered = false;
+        this.lastWarnTime = 0;
+    }
+}
 function normalizeApiToken(token, fallback = "") {
     const clean = String(token || "").trim();
     return API_TOKEN_RE.test(clean) ? clean : fallback;
@@ -229,6 +289,15 @@ export class VibeOSApiClient {
             stress_score: stressScore,
         });
     }
+    async getModes() {
+        return this.request("/api/v1/modes", {}, "GET");
+    }
+    async selectMode(mode) {
+        return this.request("/api/v1/mode/select", { mode });
+    }
+    async classifyQuery(text, state) {
+        return this.request("/api/v1/mode/classify", { text, state: state || {} });
+    }
     async classifyTier(model, customRegex = null) {
         return this.request("/api/v1/tier/classify", { model, custom_regex: customRegex });
     }
@@ -424,6 +493,19 @@ export let VIBEOS_API_DISABLED = readApiDisabledFromDisk() || isTruthyFlag(proce
 export let VIBEOS_API_TOKEN = VIBEOS_API_DISABLED ? "" : (readTokenFromDisk() || normalizeApiToken(process.env.VIBEOS_API_TOKEN, "") || EMBEDDED_API_TOKEN);
 export let VIBEOS_API_BOOTSTRAP_TOKEN = VIBEOS_API_DISABLED ? "" : (readBootstrapTokenFromDisk() || process.env.VIBEOS_API_BOOTSTRAP_TOKEN || "");
 export let VIBEOS_API_ENABLED = !VIBEOS_API_DISABLED && process.env.VIBEOS_API_ENABLED !== "false" && (!!VIBEOS_API_TOKEN || !!VIBEOS_API_BOOTSTRAP_TOKEN);
+let _anomalyDetector = null;
+function getAnomalyDetector() {
+    if (!_anomalyDetector)
+        _anomalyDetector = new TokenAnomalyDetector();
+    return _anomalyDetector;
+}
+export function setAnomalyDetection(enabled) {
+    const d = getAnomalyDetector();
+    d.disabled = !enabled;
+    if (enabled)
+        d.reset();
+    console.error(`[vibeOS] Anomaly detection ${enabled ? "enabled" : "disabled"}`);
+}
 function persistBootstrapToken(token) {
     const clean = String(token || "").trim();
     try {
@@ -451,6 +533,8 @@ export function setApiToken(newToken) {
         VIBEOS_API_BOOTSTRAP_TOKEN = readBootstrapTokenFromDisk() || VIBEOS_API_BOOTSTRAP_TOKEN;
         VIBEOS_API_ENABLED = process.env.VIBEOS_API_ENABLED !== "false" && (!!VIBEOS_API_TOKEN || !!VIBEOS_API_BOOTSTRAP_TOKEN);
         persistPrimaryApiEnvState({ token: VIBEOS_API_TOKEN, disabled: false });
+        if (_anomalyDetector)
+            _anomalyDetector.reset();
         console.error("[vibeOS] API token updated via setApiToken");
     }
     catch (e) {
@@ -466,6 +550,8 @@ export function invalidateApiToken() {
         _apiClient = null;
         _apiFallbackMode = false;
         _apiFallbackSince = null;
+        if (_anomalyDetector)
+            _anomalyDetector.reset();
         persistBootstrapToken("");
         persistPrimaryApiEnvState({ token: "", disabled: true });
         resetApiConnection();
@@ -615,6 +701,15 @@ export async function remoteCall(method, args, fallbackFn) {
             return fallbackFn();
         return null;
     }
+    const detector = getAnomalyDetector();
+    detector.record();
+    if (detector.throttleIfAnomalous()) {
+        // Don't set _apiFallbackMode — detector's own cooldown resets it.
+        // This lets the API retry naturally after the throttle window.
+        if (fallbackFn)
+            return fallbackFn();
+        return null;
+    }
     try {
         const client = getApiClient();
         if (!client) {

package/src/lib/cost-anomaly.js

@@ -0,0 +1,75 @@
+// @ts-nocheck
+/**
+ * SPDX-License-Identifier: MIT
+ * SPDX-FileCopyrightText: 2026 vibeOS <https://github.com/DrunkkToys/vibeOS>
+ *
+ * Cost anomaly detector — monitors per-turn model costs and warns
+ * when a model cost spikes significantly above the running average.
+ */
+
+const COST_WINDOW_SIZE = 20
+const COST_ANOMALY_THRESHOLD = 3
+const COST_WARMUP_SAMPLES = 5
+
+export class CostAnomalyDetector {
+  constructor() {
+    this.costHistory = []
+    this.disabled = false
+    this.currentAnomalyModel = null
+    this.currentAnomalyCost = 0
+    this.currentAnomalyMean = 0
+  }
+
+  record(cost) {
+    if (this.disabled) return
+    this.costHistory.push(cost)
+    if (this.costHistory.length > COST_WINDOW_SIZE) {
+      this.costHistory.shift()
+    }
+  }
+
+  get mean() {
+    if (this.costHistory.length === 0) return 0
+    return this.costHistory.reduce((a, b) => a + b, 0) / this.costHistory.length
+  }
+
+  checkAnomaly(model, cost) {
+    if (this.disabled) return false
+    if (this.costHistory.length < COST_WARMUP_SAMPLES) return false
+    const avg = this.mean
+    if (avg <= 0 || cost <= avg) return false
+    const ratio = cost / avg
+    if (ratio > COST_ANOMALY_THRESHOLD) {
+      this.currentAnomalyModel = model
+      this.currentAnomalyCost = cost
+      this.currentAnomalyMean = avg
+      return true
+    }
+    return false
+  }
+
+  clearAnomaly() {
+    this.currentAnomalyModel = null
+    this.currentAnomalyCost = 0
+    this.currentAnomalyMean = 0
+  }
+
+  reset() {
+    this.costHistory = []
+    this.clearAnomaly()
+  }
+}
+
+let _costDetector = null
+
+export function getCostAnomalyDetector() {
+  if (!_costDetector) _costDetector = new CostAnomalyDetector()
+  return _costDetector
+}
+
+export function setCostAnomalyDetection(enabled) {
+  const d = getCostAnomalyDetector()
+  d.disabled = !enabled
+  if (enabled) d.reset()
+  console.error(`[vibeOS] Cost anomaly detection ${enabled ? "enabled" : "disabled"}`)
+}

package/src/lib/hooks/chat-transform.js

@@ -1,8 +1,8 @@
 // @ts-nocheck
-import { readFileSync, writeFileSync, appendFileSync, existsSync, mkdirSync } from "node:fs";
+import { readFileSync, writeFileSync, appendFileSync, existsSync, mkdirSync, rmSync } from "node:fs";
 import { join, basename } from "node:path";
 import { createHash } from "node:crypto";
-import { currentModel, currentProjectFingerprint, currentProjectName, _blackboxEnabled, loadSelection, writeSelection, safeJsonParse, applyDecadence, getSessionScratchpadDir, ensureSessionScratchpadDirs, indexAppend, briefedProjects, getActiveJobForProject, loadTodos, promotedProjectPatterns, detectTechStack, projectFingerprint, TRINITY_OPENCODE_CONFIG, TIERS_FILE, loadGlobalLearning, setCurrentProjectFingerprint, setCurrentProjectName, stableJson, TOOL_NAME_NORMALIZE, _cacheDb, recordCacheSaving, } from "../state.js";
+import { currentModel, currentProjectFingerprint, currentProjectName, _blackboxEnabled, loadSelection, writeSelection, safeJsonParse, applyDecadence, getSessionScratchpadDir, ensureSessionScratchpadDirs, indexAppend, briefedProjects, getActiveJobForProject, loadTodos, promotedProjectPatterns, detectTechStack, projectFingerprint, SCRATCHPAD_ROOT, TRINITY_OPENCODE_CONFIG, TIERS_FILE, loadGlobalLearning, setCurrentProjectFingerprint, setCurrentProjectName, stableJson, TOOL_NAME_NORMALIZE, _cacheDb, recordCacheSaving, } from "../state.js";
 import { applySlot, TRINITY_CHEAP, TRINITY_MEDIUM, cacheSavePer1MInputTokens, } from "../pricing.js";
 import { scoreStress, classifyTurnSimple, loadOptimizationMode, saveOptimizationMode, selectOptimizationModeRemote, computeControlVector, getBlackboxTracker, loadBlackboxState as loadBlackboxStateFromCtx, saveBlackboxState as saveBlackboxStateToCtx, extractLastUserText, isLikelyOffTopic, fetchBlackboxEnrichment, estimateContextBudget, buildControlHistoryEntry, } from "../turn-classify.js";
 import { applyBudgetFirstMode, peekBudgetFirstMode } from "../mode-policy.js";
@@ -277,25 +277,31 @@ function compressToolOutputs(messages) {
                 continue;
             const hash = createHash("sha256")
                 .update(`tool_result\n${raw}\n`).digest("hex").slice(0, 16);
-            const fullPath = join(getSessionScratchpadDir(), `${hash}.txt`);
+            const globalDir = join(SCRATCHPAD_ROOT, "by-hash");
+            const sessPath = join(getSessionScratchpadDir(), `${hash}.txt`);
+            const globalPath = join(globalDir, `${hash}.txt`);
             try {
+                mkdirSync(globalDir, { recursive: true });
                 ensureSessionScratchpadDirs();
-                if (!existsSync(fullPath)) {
-                    writeFileSync(fullPath, raw);
+                if (!existsSync(globalPath)) {
+                    writeFileSync(globalPath, raw);
                     indexAppend(hash, part.tool, raw.length);
-                    // Create pointer file for input-hash-based lookup
-                    const invPart = parts.slice(0, parts.indexOf(part)).reverse().find((p) => p?.type === "tool" && p?.tool === part.tool && p?.state?.input && p?.state?.status !== "completed");
-                    if (invPart?.state?.input) {
-                        const toolKey = TOOL_NAME_NORMALIZE[part.tool] || part.tool;
-                        const inputHash = createHash("sha256")
-                            .update(`${toolKey}\n${stableJson(invPart.state.input)}\n`)
-                            .digest("hex").slice(0, 16);
-                        const ptrPath = join(getSessionScratchpadDir(), `${inputHash}.ptr`);
-                        try {
-                            writeFileSync(ptrPath, JSON.stringify({ contentHash: hash, tool: part.tool }));
-                        }
-                        catch { }
+                    // Clean up any existing session-local copy
+                    if (existsSync(sessPath))
+                        rmSync(sessPath, { force: true });
+                }
+                // Create pointer file for input-hash-based lookup
+                const invPart = parts.slice(0, parts.indexOf(part)).reverse().find((p) => p?.type === "tool" && p?.tool === part.tool && p?.state?.input && p?.state?.status !== "completed");
+                if (invPart?.state?.input) {
+                    const toolKey = TOOL_NAME_NORMALIZE[part.tool] || part.tool;
+                    const inputHash = createHash("sha256")
+                        .update(`${toolKey}\n${stableJson(invPart.state.input)}\n`)
+                        .digest("hex").slice(0, 16);
+                    const ptrPath = join(getSessionScratchpadDir(), `${inputHash}.ptr`);
+                    try {
+                        writeFileSync(ptrPath, JSON.stringify({ contentHash: hash, tool: part.tool }));
                     }
+                    catch { }
                 }
             }
             catch (err) {
@@ -305,7 +311,7 @@ function compressToolOutputs(messages) {
             if (!isCold)
                 continue;
             const summary = raw.slice(0, 200).replace(/\n+/g, " ").trim() + (raw.length > 200 ? "\u2026" : "");
-            const ref = `${COMPRESS_MARKER} [${raw.length} chars compressed -- cold storage at ${fullPath}] ` +
+            const ref = `${COMPRESS_MARKER} [${raw.length} chars compressed -- cold storage at ${globalPath}] ` +
                 `[summary] ${summary}`;
             state.output = ref;
             compressedBytes += raw.length - ref.length;

package/src/lib/hooks/tool-execute.js

@@ -9,6 +9,7 @@ import { scoreStress, extractFirstWordFromArgs, shouldLogWarn, isUserAskingForTe
 import { saveReport } from "../reporting.js";
 import { loadCredit } from "../credit-api.js";
 import { remoteCall, VIBEOS_API_ENABLED } from "../api-client.js";
+import { getCostAnomalyDetector } from "../cost-anomaly.js";
 import { checkFlowRules } from "../../vibeOS-lib/flow-enforcer.js";
 import { computeDifficulty, addRouteEdge, predictBestModel, hashQuery } from "../../vibeOS-lib/ml-router.js";
 import { addCacheEntry, recordCacheStats, predictCacheHit } from "../../vibeOS-lib/smart-cache.js";
@@ -487,6 +488,25 @@ export const onToolExecuteBefore = async (input, output) => {
             return;
         }
     }
+    // Cost anomaly detection: warn if this model's per-turn cost spikes
+    // significantly above the session rolling average.
+    const costDetector = getCostAnomalyDetector();
+    if (!costDetector.disabled && currentModel) {
+        const modelCost = modelCostPerTurn(currentModel);
+        const fullModelName = currentModel;
+        if (costDetector.checkAnomaly(fullModelName, modelCost)) {
+            const avg = costDetector.currentAnomalyMean;
+            const ratio = avg > 0 ? (modelCost / avg).toFixed(1) : "?";
+            const msg = `Cost spike: ${shortModelName(fullModelName)} at $${modelCost.toFixed(4)}/turn — ${ratio}x higher than recent avg of $${avg.toFixed(4)}. Run \`trinity cheap\` or \`trinity medium\` to save.`;
+            if (shouldLogWarn(`${t}|cost-anomaly|${fullModelName}|${modelCost.toFixed(4)}`)) {
+                console.error(`[vibeOS] [cost-anomaly] ${msg}`);
+            }
+            pendingUiNote = `🚨 ${msg}`;
+            enforcementBlocked = true;
+            return;
+        }
+        costDetector.record(modelCost);
+    }
     // Credit < 40%: non-task tool — record and nudge to step aside.
     if (_credit < 40 && !compatibilityMode) {
         const total = recordSaving(t, "credit<40% high-tier", _estOpus, { firstWord: _firstWord });

package/src/lib/mode-router.js

@@ -0,0 +1,100 @@
+// Mode Router — 10 modes, 4 tiers. Full type-safe hierarchy.
+// Branded modes: user-selected strategy + tier pipeline.
+// Runtime modes: classifier-selected behavior per query.
+export const TIERS = {
+    brain: { cost: 0.002, desc: "v4 Pro tier — max quality" },
+    medium: { cost: 0.000182, desc: "v4 Flash tier — balanced" },
+    cheap: { cost: 0, desc: "Chat tier — free" },
+    local: { cost: 0, desc: "Ollama local model" },
+};
+export const BRANDED_MODES = [
+    {
+        id: "vibeultrax", index: 1, name: "VibeUltraX", icon: "\u{1F3C6}",
+        pipeline: ["local", "medium", "brain"],
+        thinking: "full", tdd: "quality", enforcement: "strict", flow: "strict",
+        qualityVsBrain: 107, costVsBrain: 58,
+        desc: "3-model debate: local proposes, medium reviews, brain refines.",
+    },
+    {
+        id: "vibeqmax", index: 2, name: "VibeQMaX", icon: "\u{2B50}",
+        pipeline: ["brain"],
+        thinking: "full", tdd: "quality", enforcement: "strict", flow: "strict",
+        qualityVsBrain: 100, costVsBrain: 50,
+        desc: "Brain tier only. Same quality as Raw Brain at half cost.",
+    },
+    {
+        id: "vibemax", index: 3, name: "VibeMaX", icon: "\u{26A1}",
+        pipeline: ["medium"],
+        thinking: "off", tdd: "lazy", enforcement: "relaxed", flow: "audit",
+        qualityVsBrain: 75, costVsBrain: 18, default: true,
+        desc: "Default mode. Medium tier auto-escalate. Speed-first.",
+    },
+];
+export const RUNTIME_MODES = [
+    {
+        id: "balanced", index: 4, name: "Balanced", icon: "\u{2696}\u{FE0F}",
+        pipeline: ["medium"],
+        thinking: "brief", tdd: "lazy", enforcement: "relaxed", flow: "audit",
+        qualityVsBrain: 70, costVsBrain: 30, defaultRuntime: true,
+        desc: "Default runtime. Auto-selects behavior per query.",
+    },
+    {
+        id: "speed", index: 5, name: "Speed", icon: "\u{1F680}",
+        pipeline: ["medium"],
+        thinking: "off", tdd: "off", enforcement: "relaxed", flow: "off",
+        qualityVsBrain: 55, costVsBrain: 32,
+        desc: "Medium tier. Fast responses, no overhead.",
+    },
+    {
+        id: "budget", index: 6, name: "Budget", icon: "\u{1F4B8}",
+        pipeline: ["cheap"],
+        thinking: "off", tdd: "off", enforcement: "off", flow: "off",
+        qualityVsBrain: 40, costVsBrain: 100,
+        desc: "Cheap tier only. Zero cost.",
+    },
+    {
+        id: "quality", index: 7, name: "Quality", icon: "\u{1F4AF}",
+        pipeline: ["brain"],
+        thinking: "full", tdd: "quality", enforcement: "strict", flow: "strict",
+        qualityVsBrain: 100, costVsBrain: 60,
+        desc: "Brain tier with full thinking and enforcement.",
+    },
+    {
+        id: "audit", index: 8, name: "Audit", icon: "\u{1F50D}",
+        pipeline: ["brain"],
+        thinking: "full", tdd: "quality", enforcement: "strict", flow: "strict",
+        qualityVsBrain: 100, costVsBrain: 55,
+        desc: "Brain tier security audit. OWASP validation.",
+    },
+    {
+        id: "longrun", index: 9, name: "Longrun", icon: "\u{1F3C3}",
+        pipeline: ["brain"],
+        thinking: "full", tdd: "quality", enforcement: "strict", flow: "strict",
+        qualityVsBrain: 100, costVsBrain: 70,
+        desc: "Brain tier extended session. Full context.",
+    },
+];
+export const RAW_MODE = {
+    id: "raw", index: 10, name: "Raw Brain", icon: "\u{1F9E0}",
+    pipeline: ["brain"],
+    thinking: "full", tdd: "\u2014", enforcement: "\u2014", flow: "\u2014",
+    qualityVsBrain: 100, costVsBrain: 0,
+    desc: "Pure v4 Pro baseline. No vibeOS overhead.",
+};
+export const ALL_MODES = [...BRANDED_MODES, ...RUNTIME_MODES, RAW_MODE];
+export function getMode(id) {
+    return ALL_MODES.find(m => m.id === id) ?? getDefault();
+}
+export function getDefault() {
+    return BRANDED_MODES.find(m => m.default);
+}
+export function getDefaultRuntime() {
+    return RUNTIME_MODES.find(m => m.defaultRuntime);
+}
+export function getBrandedModes() { return BRANDED_MODES; }
+export function getRuntimeModes() { return RUNTIME_MODES; }
+export function resolveTierModels(mode, tierMap) {
+    const models = mode.pipeline.map(t => tierMap[t] ?? t);
+    const costs = mode.pipeline.map(t => TIERS[t]?.cost ?? 0);
+    return { models, totalCost: costs.reduce((s, c) => s + c, 0) };
+}

package/src/lib/state.js

@@ -907,7 +907,7 @@ function getScratchpadHit(toolLower, args, baseDir = null) {
     const globalDir = SCRATCHPAD_GLOBAL_DIR;
     const sessionPath = join(sessionDir, `${hash}.txt`);
     const globalPath = join(globalDir, `${hash}.txt`);
-    let fullPath = existsSync(sessionPath) ? sessionPath : (existsSync(globalPath) ? globalPath : null);
+    let fullPath = existsSync(globalPath) ? globalPath : (existsSync(sessionPath) ? sessionPath : null);
     if (!fullPath) {
         // Try pointer files (created by compressToolOutputs mapping input hash -> content hash)
         const ptrSessionPath = join(sessionDir, `${hash}.ptr`);
@@ -921,7 +921,7 @@ function getScratchpadHit(toolLower, args, baseDir = null) {
                     resolvedHash = ptrData.contentHash;
                     const rSessionPath = join(sessionDir, `${resolvedHash}.txt`);
                     const rGlobalPath = join(globalDir, `${resolvedHash}.txt`);
-                    fullPath = existsSync(rSessionPath) ? rSessionPath : (existsSync(rGlobalPath) ? rGlobalPath : null);
+                    fullPath = existsSync(rGlobalPath) ? rGlobalPath : (existsSync(rSessionPath) ? rSessionPath : null);
                 }
             }
             catch { }
@@ -1454,9 +1454,9 @@ function recordDelegation(tool, saveEst, meta = {}) {
             s.sessions ??= {};
             const sid = _OC_SID;
             s.sessions[sid] ??= { started: now, session_started_at: now, source: "opencode", tool_counts: {}, warns: [] };
-            if (currentProjectFingerprint)
+            if (currentProjectFingerprint && !s.sessions[sid].project_fingerprint)
                 s.sessions[sid].project_fingerprint = currentProjectFingerprint;
-            if (currentProjectName)
+            if (currentProjectName && !s.sessions[sid].project_name)
                 s.sessions[sid].project_name = currentProjectName;
             s.sessions[sid].total_savings_usd = roundUsd(Number(s.sessions[sid].total_savings_usd || 0) + delta);
             _pruneOldSessions(s);
@@ -1474,31 +1474,37 @@ function recordCacheSaving(tool, saveEst, meta = {}) {
             const now = new Date().toISOString();
             const delta = Number(saveEst || 0);
             s.lifetime ??= { warn_count: 0, total_savings_usd: 0, last_updated: "" };
-            s.lifetime.cache_savings_usd = roundUsd(Number(s.lifetime.cache_savings_usd || 0) + delta);
             s.lifetime.last_updated = now;
             s.sessions ??= {};
             const sid = _OC_SID;
             s.sessions[sid] ??= { started: now, session_started_at: now, source: "opencode", tool_counts: {}, warns: [] };
-            if (currentProjectFingerprint)
+            if (currentProjectFingerprint && !s.sessions[sid].project_fingerprint)
                 s.sessions[sid].project_fingerprint = currentProjectFingerprint;
-            if (currentProjectName)
+            if (currentProjectName && !s.sessions[sid].project_name)
                 s.sessions[sid].project_name = currentProjectName;
             s.sessions[sid].session_cache_dir = getSessionScratchpadDir();
             s.sessions[sid].tool_counts[tool] = (s.sessions[sid].tool_counts[tool] || 0) + 1;
-            s.sessions[sid].cache_savings_usd = roundUsd(Number(s.sessions[sid].cache_savings_usd || 0) + delta);
             if (meta?.hash) {
                 s.sessions[sid].cache_hits ??= [];
-                s.sessions[sid].cache_hits.push({
-                    at: now,
-                    tool,
-                    hash: meta.hash,
-                    est_savings_usd: roundUsd(delta),
-                });
-                if (s.sessions[sid].cache_hits.length > 200) {
-                    console.error(`[vibeOS] session cache_hits truncated from ${s.sessions[sid].cache_hits.length} to 200 for ${sid}`);
-                    s.sessions[sid].cache_hits = s.sessions[sid].cache_hits.slice(-200);
+                if (!s.sessions[sid].cache_hits.some((h) => h.hash === meta.hash)) {
+                    s.sessions[sid].cache_hits.push({
+                        at: now,
+                        tool,
+                        hash: meta.hash,
+                        est_savings_usd: roundUsd(delta),
+                    });
+                    s.sessions[sid].cache_savings_usd = roundUsd(Number(s.sessions[sid].cache_savings_usd || 0) + delta);
+                    s.lifetime.cache_savings_usd = roundUsd(Number(s.lifetime.cache_savings_usd || 0) + delta);
+                    if (s.sessions[sid].cache_hits.length > 200) {
+                        console.error(`[vibeOS] session cache_hits truncated from ${s.sessions[sid].cache_hits.length} to 200 for ${sid}`);
+                        s.sessions[sid].cache_hits = s.sessions[sid].cache_hits.slice(-200);
+                    }
                 }
             }
+            else {
+                s.sessions[sid].cache_savings_usd = roundUsd(Number(s.sessions[sid].cache_savings_usd || 0) + delta);
+                s.lifetime.cache_savings_usd = roundUsd(Number(s.lifetime.cache_savings_usd || 0) + delta);
+            }
             _pruneOldSessions(s);
             return s;
         });

package/src/lib/trinity-tool.js

@@ -1,6 +1,7 @@
 // @ts-nocheck
 import { join } from "node:path";
 import { LABEL_MODES, buildDeterministicTrinity, resolveExecutionIdentity } from "./pricing.js";
+import { BRANDED_MODES, RUNTIME_MODES } from "./mode-router.js";
 import { invalidateApiToken } from "./api-client.js";
 export function createTrinityTool(deps) {
     return {
@@ -24,7 +25,7 @@ export function createTrinityTool(deps) {
             "Call this when the user says things like 'switch to medium', 'use cheap model', 'disable plugin', 'trinity status'.",
         args: {
             action: deps.tool.schema.enum(["status", "enable", "disable", "set", "mode", "thinking", "flow", "tdd", "setup", "project", "patterns", "rebuild", "diagnose", "help", "enforce", "repair-state", "blackbox", "report", "target", "guard", "api-token", "api-bootstrap-token", "todo", "todo-done", "todo-sync"]).optional(),
-            slot: deps.tool.schema.enum(["brain", "medium", "cheap", "budget", "quality", "speed", "longrun", "auto", "on", "off", "enforce", "strict", "preview", "apply", "clear", "savings"]).optional(),
+            slot: deps.tool.schema.enum(["brain", "medium", "cheap", "budget", "quality", "speed", "longrun", "auto", "vibeultrax", "on", "off", "enforce", "strict", "preview", "apply", "clear", "savings"]).optional(),
             level: deps.tool.schema.enum(["full", "brief", "off", "on"]).optional(),
             token: deps.tool.schema.string().optional(),
         },
@@ -178,42 +179,33 @@ export function createTrinityTool(deps) {
                 return `\u2705 Switched to ${slot} slot (${result.ocModel}). Active now (no restart needed).`;
             }
             if (action === "mode") {
+                const builtInIds = ["budget", "quality", "speed", "longrun"];
+                const brandedIds = BRANDED_MODES.map(m => m.id);
+                const allModeIds = [...builtInIds, "auto", ...brandedIds];
                 if (!slot)
-                    return `Provide mode: budget | quality | speed | longrun | vibemax | vibeqmax | auto`;
+                    return `Provide mode: ${builtInIds.join(" | ")} | auto | ${brandedIds.join(" | ")}`;
                 const modeAlias = { vibemax: "vibemax", vibeqmax: "quality" };
                 const resolvedSlot = modeAlias[slot] || slot;
-                if (!["budget", "quality", "speed", "longrun", "vibemax", "auto"].includes(resolvedSlot)) {
-                    return `Provide mode: budget | quality | speed | longrun | vibemax | vibeqmax | auto`;
+                if (!allModeIds.includes(resolvedSlot)) {
+                    return `Provide mode: ${builtInIds.join(" | ")} | auto | ${brandedIds.join(" | ")}`;
                 }
                 const ok = deps.saveOptimizationMode(resolvedSlot);
                 if (!ok)
                     return `Failed to write mode`;
-                const tierMap = { budget: "cheap", quality: "brain", speed: "medium", longrun: "brain", vibemax: "medium" };
-                const tierSlot = tierMap[slot] || "cheap";
-                deps.writeSelection("active_slot", tierSlot);
-                deps.writeSelection("onboarding_mode", slot === "quality" || slot === "longrun" ? "strict" : "assist");
-                if (slot === "budget") {
-                    deps.writeSelection("delegation_enforce", false);
-                    deps.writeSelection("flow_enabled", false);
-                    deps.writeSelection("flow_enforce", false);
-                    deps.writeSelection("tdd_enforce", false);
-                    deps.writeSelection("thinking_level", "off");
-                }
-                else if (slot === "quality") {
-                    deps.writeSelection("delegation_enforce", true);
-                    deps.writeSelection("flow_enabled", true);
-                    deps.writeSelection("flow_enforce", true);
-                    deps.writeSelection("tdd_enforce", true);
-                    deps.writeSelection("thinking_level", "full");
-                }
-                else if (slot === "speed") {
-                    deps.writeSelection("delegation_enforce", false);
-                    deps.writeSelection("flow_enabled", false);
-                    deps.writeSelection("flow_enforce", false);
-                    deps.writeSelection("tdd_enforce", false);
-                    deps.writeSelection("thinking_level", "off");
-                }
-                return `Mode set to ${slot.toUpperCase()}. Tier: ${tierSlot}.`;
+                const allEntries = [...BRANDED_MODES, ...RUNTIME_MODES];
+                const modeEntry = allEntries.find(e => e.id === slot);
+                if (modeEntry) {
+                    const tierSlot = modeEntry.pipeline[0] || "cheap";
+                    deps.writeSelection("active_slot", tierSlot);
+                    deps.writeSelection("onboarding_mode", modeEntry.tdd === "quality" || modeEntry.enforcement === "strict" ? "strict" : "assist");
+                    deps.writeSelection("delegation_enforce", modeEntry.enforcement === "strict" || modeEntry.enforcement === "on");
+                    deps.writeSelection("flow_enabled", modeEntry.flow === "strict" || modeEntry.flow === "on" || modeEntry.flow === "audit");
+                    deps.writeSelection("flow_enforce", modeEntry.flow === "strict" || modeEntry.flow === "on");
+                    deps.writeSelection("tdd_enforce", modeEntry.tdd === "quality" || modeEntry.tdd === "on" || modeEntry.tdd === "strict");
+                    deps.writeSelection("thinking_level", modeEntry.thinking);
+                    return `Mode set to ${slot.toUpperCase()}. Tier: ${tierSlot}.`;
+                }
+                return `Mode set to ${slot.toUpperCase()}.`;
             }
             if (action === "thinking") {
                 if (!level || !["full", "brief", "off"].includes(level)) {
@@ -1105,6 +1097,7 @@ export function createTrinityTool(deps) {
                     "  trinity enable/disable    Toggle vibeOS plugin on/off",
                     "  trinity enforce on        Block brain-tier writes/edits (save $$)",
                     "  trinity lock on/off       Lock model at session start (skip auto-reconcile)",
+                    "  trinity mode <profile>   Set optimization profile (built-in + branded modes)",
                     "  trinity thinking full|brief|off  Set reasoning depth",
                     "",
                     "GUARDRAILS:",

package/src/lib/turn-classify.js

@@ -45,18 +45,20 @@ export function bootstrapOptimizationSession() {
         const state = loadBlackboxState();
         if (!state.sessions)
             state.sessions = {};
-        if (!state.sessions[sid])
-            state.sessions[sid] = {};
-        state.sessions[sid].optimization_mode = resolvedMode;
-        state.sessions[sid].active_slot = resolvedSlot;
-        state.sessions[sid].sub_regime = state.sessions[sid].sub_regime || "INIT";
-        state.sessions[sid].regime = state.sessions[sid].regime || "INIT";
-        state.sessions[sid].resolution = state.sessions[sid].resolution || "unresolved";
-        state.sessions[sid].momentum = Number(state.sessions[sid].momentum || 0);
-        state.sessions[sid].loop_count = Number(state.sessions[sid].loop_count || 0);
-        state.sessions[sid].loop_intervention_level = state.sessions[sid].loop_intervention_level || "none";
-        state.sessions[sid].loop_start_turn = Number(state.sessions[sid].loop_start_turn || 0);
-        state.sessions[sid].loop_pattern_count = Number(state.sessions[sid].loop_pattern_count || 0);
+        if (sid && sid !== "undefined") {
+            if (!state.sessions[sid])
+                state.sessions[sid] = {};
+            state.sessions[sid].optimization_mode = resolvedMode;
+            state.sessions[sid].active_slot = resolvedSlot;
+            state.sessions[sid].sub_regime = state.sessions[sid].sub_regime || "INIT";
+            state.sessions[sid].regime = state.sessions[sid].regime || "INIT";
+            state.sessions[sid].resolution = state.sessions[sid].resolution || "unresolved";
+            state.sessions[sid].momentum = Number(state.sessions[sid].momentum || 0);
+            state.sessions[sid].loop_count = Number(state.sessions[sid].loop_count || 0);
+            state.sessions[sid].loop_intervention_level = state.sessions[sid].loop_intervention_level || "none";
+            state.sessions[sid].loop_start_turn = Number(state.sessions[sid].loop_start_turn || 0);
+            state.sessions[sid].loop_pattern_count = Number(state.sessions[sid].loop_pattern_count || 0);
+        }
         saveBlackboxState(state);
     }
     catch { }
@@ -314,11 +316,11 @@ export function getBlackboxTracker() {
         if (state.enabled !== undefined)
             _setGlobalBlackboxEnabled(state.enabled);
         const sid = _OC_SID;
-        if (state.sessions?.[sid]?.history) {
+        if (sid && sid !== "undefined" && state.sessions?.[sid]?.history) {
             _blackboxTracker = _BlackboxStub.deserialize(state.sessions[sid]);
         }
-        else if (currentProjectFingerprint) {
-            const projectKeys = Object.keys(state.sessions || {}).filter(k => state.sessions[k].project_fingerprint === currentProjectFingerprint);
+        else if (currentProjectFingerprint && sid && sid !== "undefined") {
+            const projectKeys = Object.keys(state.sessions || {}).filter(k => state.sessions[k].project_fingerprint === currentProjectFingerprint && k !== "undefined" && k !== null && k.trim() !== "");
             const latest = projectKeys.sort().slice(-1)[0];
             if (latest && state.sessions[latest]?.history) {
                 const data = state.sessions[latest];
@@ -589,12 +591,14 @@ export function incrementTurnCounter() {
         const sid = _OC_SID;
         if (!state.sessions)
             state.sessions = {};
-        if (!state.sessions[sid])
-            state.sessions[sid] = {};
-        const next = (state.sessions[sid].turn_counter || 0) + 1;
-        state.sessions[sid].turn_counter = next;
+        if (sid && sid !== "undefined") {
+            if (!state.sessions[sid])
+                state.sessions[sid] = {};
+            const next = (state.sessions[sid].turn_counter || 0) + 1;
+            state.sessions[sid].turn_counter = next;
+        }
         saveBlackboxState(state);
-        return next;
+        return 0;
     }
     catch {
         return 0;

package/src/vibeOS-lib/blackbox/index.js

@@ -3,11 +3,11 @@
 // @ts-nocheck
 // Blackbox — theWay decision core ported to TypeScript.
 // Barrel export for all blackbox modules.
-export { buildAdvice, buildDecisionBlock, computeModality, humanReadableAction, compressMetrics, compressUncertainty, compressEntropy, enforceClosure, stabilityScore, shouldUseFastPath, buildCautionNote, scoreUsefulness, getFallbackPlan, getActionSuggestion, getCuriosityPrompt, } from "./advice-layer.js";
-export { classifySituation, getActions, recommendAction, getSituationTypes, } from "./taxonomy.js";
+export { buildAdvice, buildDecisionBlock, computeModality, humanReadableAction, compressMetrics, compressUncertainty, compressEntropy, enforceClosure, stabilityScore, shouldUseFastPath, buildCautionNote, scoreUsefulness, getFallbackPlan, getActionSuggestion, getCuriosityPrompt } from "./advice-layer.js";
+export { classifySituation, getActions, recommendAction, getSituationTypes } from "./taxonomy.js";
 export { ResolutionTracker } from "./resolution-tracker.js";
 export { ExposureModel } from "./exposure-model.js";
-export { ACTION_TARGET, ACTION_TYPE, FALLBACK_PLANS, ACTION_SUGGESTIONS, CURIOSITY_PROMPTS, } from "./crew-constants.js";
-export { computeControlVector, buildControlHistoryEntry, REGIME_CONTROL_TABLE, } from "./meta-controller.js";
+export { ACTION_TARGET, ACTION_TYPE, FALLBACK_PLANS, ACTION_SUGGESTIONS, CURIOSITY_PROMPTS } from "./crew-constants.js";
+export { computeControlVector, buildControlHistoryEntry, REGIME_CONTROL_TABLE } from "./meta-controller.js";
 export { vibemaxSelectMode, vibemaxPipeline, predictVibeMaX, trainVibeMaXModelFromTelemetry, getVibeMaXModelMeta, resetVibeMaXPipeline } from "./vibemax.js";
 export { PivotCache } from "./pivot-cache.js";