vibeostheog 0.19.9 → 0.20.1

package/CHANGELOG.md

@@ -1,3 +1,13 @@
+## 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
+Merge pull request #59 from DrunkkToys/codex/fix-thinking-directive-precedence
+
+
 ## 0.19.9
 - fix: show live run model in footer
 

package/README.md

@@ -1,18 +1,44 @@
 # vibeOS for OpenCode
 
-> **Alpha Release** — This is the first alpha milestone of vibeOS. See [CHANGELOG.md](CHANGELOG.md) for release notes.
-vibeOS is the cost-aware routing layer for OpenCode Desktop. It keeps high-tier models focused on orchestration, pushes implementation work to cheaper tiers, and makes the savings visible in real time through the live footer and dashboard.
+> **Alpha Omega Launch** - This release is the first major public launch of vibeOS. See [CHANGELOG.md](CHANGELOG.md) for release notes.
 
+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.
 
-It also adds 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.
 
-## Why Teams Use It
+## 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 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.
 
-- Routes work to the right model tier without manual babysitting
-- Tracks delegation savings and cache savings separately
-- Shows live status in chat, the footer, and the web dashboard
-- Adds runtime controls for flow, TDD, model locking, and blackbox mode
-- Falls back to local algorithms if the remote API is unavailable
 
 ## Install
 
@@ -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
@@ -99,7 +125,7 @@ Additional reporting commands:
 
 The footer shows:
 
-- the active model split
+- the active provider/model in use for the current run
 - cumulative delegation savings
 - cache savings
 - stress level

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "vibeostheog",
-  "version": "0.19.9",
+  "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": {}
+  }
 }