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

docs/guides/framework-integration.md

@@ -348,7 +348,7 @@ export default function RootLayout({ children }) {
 import { Brainy } from '@soulcraft/brainy'
 
 const brain = new Brainy({
-  storage: { type: 'filesystem', path: './data' }
+  storage: { type: 'filesystem', rootDirectory: './data' }
 })
 await brain.init()
 
@@ -536,12 +536,12 @@ import { Brainy } from '@soulcraft/brainy'
 
 export async function generateStaticProps() {
   const brain = new Brainy({
-    storage: { type: 'filesystem', path: './content' }
+    storage: { type: 'filesystem', rootDirectory: './content' }
   })
   await brain.init()
 
-  // Build search index
-  const allContent = await brain.export()
+  // Build search index (paginate with { limit, offset } for larger stores)
+  const allContent = await brain.find({ limit: 1000 })
 
   return {
     props: { searchIndex: allContent }

docs/guides/import-anything.md

@@ -49,28 +49,23 @@ await brain.import(csv, { format: 'csv' })
 
 ### 📊 Import Excel - Multi-Sheet Support
 ```javascript
-// Import entire Excel workbook
+// Import entire Excel workbook — every sheet is processed automatically
 await brain.import('sales-report.xlsx')
 // ✨ Processes all sheets, preserves structure, infers types!
 
-// Or specific sheets only
+// Mirror the workbook into the VFS, grouped by sheet
 await brain.import('data.xlsx', {
- excelSheets: ['Customers', 'Orders']
+ vfsPath: '/imports/data',
+ groupBy: 'sheet'
 })
 // ✨ Multi-sheet data becomes interconnected entities!
 ```
 
 ### 📑 Import PDF - Text & Tables
 ```javascript
-// Import PDF documents
+// Import PDF documents — text and tables are extracted automatically
 await brain.import('research-paper.pdf')
 // ✨ Extracts text, detects tables, preserves metadata!
-
-// With table extraction
-await brain.import('report.pdf', {
- pdfExtractTables: true
-})
-// ✨ Converts PDF tables to structured data automatically!
 ```
 
 ### 📝 Import YAML - File or String

docs/guides/import-flow.md

@@ -1173,21 +1173,22 @@ await this.graphIndex.addEdge(
 ```
 
 **Benefits**:
-- **O(1) relationship lookups**: `getRelations(entityId)` is instant
+- **O(1) relationship lookups**: `related(entityId)` is instant
 - **Bidirectional traversal**: Find incoming and outgoing edges
 - **Type filtering**: Get only `CreatedBy` relationships
 - **Global statistics**: Count relationships by type
 
 **Query Examples**:
 ```typescript
-// What did Mona Lisa create?
-const outgoing = await brain.getRelations('ent_mona_lisa_...', { direction: 'outgoing' })
+// What did Mona Lisa create? (outgoing edges)
+const outgoing = await brain.related({ from: 'ent_mona_lisa_...' })
 
-// What created Mona Lisa?
-const incoming = await brain.getRelations('ent_mona_lisa_...', { direction: 'incoming' })
+// What created Mona Lisa? (incoming edges)
+const incoming = await brain.related({ to: 'ent_mona_lisa_...' })
 
 // Get only CreatedBy relationships
-const createdBy = await brain.getRelations('ent_mona_lisa_...', {
+const createdBy = await brain.related({
+  from: 'ent_mona_lisa_...',
   type: VerbType.CreatedBy
 })
 ```

docs/guides/import-quick-reference.md

@@ -351,7 +351,7 @@ const result = await brain.import(file)
 const products = await brain.find({ type: 'Product' })
 
 // Get entity relationships
-const relations = await brain.getRelations(products[0].id)
+const relations = await brain.related(products[0].id)
 
 // Search VFS
 const vfsFiles = await brain.vfs().find(result.vfs.rootPath + '/**/*.json')

docs/guides/inspection.md

@@ -134,7 +134,7 @@ console.log(health.overall)
 await reader.close()
 ```
 
-Every mutation method (`add`, `update`, `delete`, `relate`, `transact`,
+Every mutation method (`add`, `update`, `remove`, `relate`, `transact`,
 `restore`, ...) throws on a read-only instance with a clear message.
 
 ## Backups

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

docs/guides/migrating-to-v4.md

@@ -252,7 +252,7 @@ const result = await brain.import('./glossary.xlsx', {
 // - "part_of"
 // - "related_to"
 
-const relations = await brain.getRelations({ limit: 100 })
+const relations = await brain.related({ limit: 100 })
 const types = new Set(relations.map(r => r.label))
 console.log(types)
 // Set { 'capital_of', 'guards', 'located_in', 'related_to' }

docs/guides/neural-api.md

@@ -367,5 +367,5 @@ const brain = new Brainy({
 ## Next Steps
 
 - Explore [Triple Intelligence](../architecture/triple-intelligence.md) for combined vector + graph + metadata queries
-- Learn about [Augmentations](../augmentations/README.md) to extend Neural API
+- Learn about [Plugins](../PLUGINS.md) to extend Brainy with native providers
 - See [API Reference](../api/README.md) for complete method documentation

docs/guides/storage-adapters.md

@@ -8,7 +8,7 @@ order: 2
 description: "Two adapters cover every deployment: in-memory for tests + ephemeral workloads, filesystem for everything that needs to persist. Both share one on-disk contract, including generational history and snapshots. Cloud backup is operator tooling, not a built-in adapter."
 next:
   - guides/plugins
-  - concepts/zero-config
+  - concepts/consistency-model
 ---
 
 # Storage Adapters

docs/guides/subtypes-and-facets.md

@@ -301,14 +301,14 @@ await brain.relate({
 
 ```typescript
 // Direct reports — fast path filter (column-store hit, not metadata fallback)
-const direct = await brain.getRelations({
+const direct = await brain.related({
   from: ceoId,
   type: VerbType.ReportsTo,
   subtype: 'direct'
 })
 
 // Set membership
-const allReports = await brain.getRelations({
+const allReports = await brain.related({
   from: ceoId,
   type: VerbType.ReportsTo,
   subtype: ['direct', 'dotted-line']
@@ -552,8 +552,8 @@ Brainy 8.0 ships:
 
 - `brain.relate({ ..., subtype: 'value' })` — write the field
 - `brain.updateRelation({ id, subtype, type?, weight?, ... })` — change a relationship
-- `brain.getRelations({ subtype })` — filter (fast path)
-- `brain.getRelations({ subtype: ['a', 'b'] })` — set membership
+- `brain.related({ subtype })` — filter (fast path)
+- `brain.related({ subtype: ['a', 'b'] })` — set membership
 - `brain.find({ connected: { via, subtype, depth } })` — traversal filter
 - `brain.counts.byRelationshipSubtype(verb, subtype?)` — O(1) counts
 - `brain.counts.topRelationshipSubtypes(verb, n?)` — top N by count