vibeostheog 0.20.0 → 0.20.1

package/CHANGELOG.md

@@ -1,3 +1,7 @@
+## 0.20.1
+- docs: rename blackbox to VibeBoX and document local fallback features
+
+
 ## 0.20.0
 - fix: resolve live OpenCode model and refresh README launch copy
 Merge pull request #61 from DrunkkToys/codex/release-candidate-blackbox-footer

package/README.md

@@ -4,16 +4,42 @@
 
 vibeOS is the cost-aware control plane for OpenCode Desktop. It helps individuals and teams keep expensive models focused on strategy, move implementation work to cheaper tiers, and make the resulting savings visible in real time through the live footer and dashboard.
 
-For teams, vibeOS adds practical guardrails: delegation enforcement, flow and TDD controls, pattern learning, stress-aware routing, blackbox decision tracking, reporting, and remote API protection for the core algorithms.
+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.
 
 ## What We Offer
 
 - Model routing that matches the job to the right provider and tier
 - Live savings visibility in chat, the footer, and the web dashboard
 - Separate tracking for delegation savings and cache savings
-- Runtime controls for flow, TDD, model locking, and blackbox mode
+- Runtime controls for flow, TDD, model locking, and VibeBoX mode
 - A local fallback path if the remote API is unavailable
 
+## Local Fallback Mode
+
+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.
+
+
 ## Install
 
 ### OpenCode plugin
@@ -83,7 +109,7 @@ The most common controls are:
 - `trinity patterns` / `trinity patterns clear` - inspect or reset learned patterns
 - `trinity diagnose` - run a health check
 - `trinity repair-state preview|apply` - fix state fingerprint collisions
-- `trinity blackbox on|off|status|reset` - control the decision engine
+- `trinity VibeBoX on|off|status|reset` - control the decision engine
 - `trinity guard` - refresh AGENTS.md and README.md checks
 - `trinity api-token <token>` - update the remote API token
 - `trinity api-bootstrap-token <token>` - store an alpha bootstrap token and exchange it for a normal API token on alpha builds

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "vibeostheog",
-  "version": "0.20.0",
+  "version": "0.20.1",
   "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",
     "release:patch": "node scripts/release.mjs patch --yes",
     "release:minor": "node scripts/release.mjs minor --yes",
     "release:major": "node scripts/release.mjs major --yes",
-    "build": "tsc -p tsconfig.json --noEmit && npx esbuild src/index.ts --bundle --outfile=src/index.js --platform=node --format=esm --target=node22 --external:node:* && node scripts/deploy.mjs",
+    "build": "npm run build:bundle && node scripts/deploy.mjs",
+    "build:bundle": "tsc -p tsconfig.json && node scripts/sync-ts-build.mjs",
     "deploy": "node scripts/deploy.mjs",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "checkpoint:validate": "node scripts/checkpoint-validate.mjs",
@@ -21,7 +22,11 @@
     "codex:hook:summary": "bash plugins/vibetheog-codex/hooks/post-command-summary.sh",
     "precommit": "node scripts/pre-commit.mjs",
     "audit-state": "node scripts/audit-state.mjs",
-    "migrate-ledger": "node scripts/migrate-ledger.mjs"
+    "migrate-ledger": "node scripts/migrate-ledger.mjs",
+    "lint": "eslint src/",
+    "lint:fix": "eslint src/ --fix",
+    "test:coverage": "c8 --reporter=text --reporter=html npm test",
+    "typecheck:strict": "tsc -p tsconfig.strict.json --noEmit"
   },
   "type": "module",
   "main": "./src/index.js",
@@ -70,11 +75,15 @@
   },
   "devDependencies": {
     "@playwright/test": "^1.60.0",
+    "@stylistic/eslint-plugin": "^5.10.0",
     "@types/express": "^5.0.6",
     "@types/node": "^22.15.30",
+    "@typescript-eslint/eslint-plugin": "^8.60.0",
+    "@typescript-eslint/parser": "^8.60.0",
+    "c8": "^11.0.0",
     "esbuild": "^0.28.0",
+    "eslint": "^10.4.0",
     "express": "^5.2.1",
     "typescript": "^5.9.3"
-  },
-  "dependencies": {}
+  }
 }