chore(8.0): final pre-RC1 sweep — API consistency, named errors, orphans, zero-cast codebase

docs/guides/installation.md

@@ -5,10 +5,10 @@ public: true
 category: getting-started
 template: guide
 order: 1
-description: Install Brainy with npm, bun, yarn, or pnpm. Works in Node.js 22+, Bun 1.0+, and browser (OPFS). TypeScript included.
+description: Install Brainy with npm, bun, yarn, or pnpm. Works in Node.js 22+ and Bun 1.0+ (server-only since 8.0). TypeScript included.
 next:
   - getting-started/quick-start
-  - concepts/zero-config
+  - guides/storage-adapters
 ---
 
 # Installation
@@ -53,28 +53,18 @@ npm install @soulcraft/cortex
 
 ```typescript
 import { Brainy } from '@soulcraft/brainy'
-import { registerCortex } from '@soulcraft/cortex'
 
-registerCortex()  // activates native acceleration globally
-
-const brain = new Brainy()
-await brain.init()
+const brain = new Brainy({ plugins: ['@soulcraft/cortex'] })
+await brain.init()  // native providers registered during init
 ```
 
 Cortex delivers a **5.2x geometric mean speedup** — see [Brainy vs Cortex](/docs/cortex/comparison) for measured benchmarks.
 
-## Browser (OPFS)
+## Server-only since 8.0
 
-Brainy works in the browser using the Origin Private File System:
-
-```typescript
-import { Brainy } from '@soulcraft/brainy'
-
-const brain = new Brainy({ storage: 'opfs' })
-await brain.init()
-```
-
-No server required. Data persists across page refreshes in the browser's private storage.
+Brainy 8.0 runs on Node.js 22+ and Bun 1.0+. Browser support (OPFS storage,
+Web Workers, in-browser WASM embeddings) was removed in 8.0 — the 7.x line
+remains available on npm if you need it.
 
 ## TypeScript
 
@@ -96,5 +86,4 @@ const id = await brain.add({
 ## Next Steps
 
 - [Quick Start](/docs/getting-started/quick-start) — build your first knowledge graph in 60 seconds
-- [Zero Configuration](/docs/concepts/zero-config) — understand what Brainy auto-detects
 - [Storage Adapters](/docs/guides/storage-adapters) — choose the right storage for your deployment