docs(8.0): Phase F — deep clean across 21 docs

Aligned every public doc to the 8.0 contract: filesystem + memory adapters
only, vector index provider terminology (config.vector with recall +
quantization + persistMode knobs), no cloud storage adapters, no closed-
source product names.

Tier 1 — heavier rewrites:
- docs/architecture/storage-architecture.md
- docs/architecture/data-storage-architecture.md
- docs/architecture/distributed-storage.md DELETED — content was 100%
  cloud-coordination examples with no 8.0 substance.
- docs/guides/distributed-system.md DELETED — same reason; no inbound refs.
- docs/SCALING.md rewritten for single-node guidance.
- docs/PLUGINS.md, docs/augmentations/{COMPLETE-REFERENCE,README}.md:
  HnswProvider→VectorIndexProvider, hnsw→vector key.
- docs/PERFORMANCE.md, docs/BATCHING.md cloud-detection + sharding
  sections replaced with single-node vector tuning + filesystem framing.

Tier 2 — surgical renames + cloud-section deletions:
- architecture/{index,initialization-and-rebuild,overview}.md
- transactions.md, DEVELOPER_LEARNING_PATH.md
- vfs/{VFS_API_GUIDE,COMMON_PATTERNS}.md
- api/README.md, guides/{inspection,import-flow}.md

Tier 3 — light edits:
- docs/README.md, architecture/augmentation-system-audit.md

MIGRATION-V3-TO-V4.md untouched (internal migration doc, no stale terms).

docs/augmentations/COMPLETE-REFERENCE.md

@@ -10,10 +10,10 @@
 import { Brainy } from '@soulcraft/brainy'
 
 const brain = new Brainy({
- // Augmentations auto-configure based on environment
- storage: 'auto', // Storage augmentation
- cache: true, // Cache augmentation
- index: true // Index augmentation
+  // Augmentations auto-configure based on environment
+  storage: { type: 'auto', rootDirectory: './brainy-data' }, // Storage augmentation
+  cache: true, // Cache augmentation
+  index: true // Index augmentation
 })
 
 await brain.init() // Augmentations initialize automatically
@@ -66,77 +66,27 @@ Augmentations are modular extensions that add functionality to Brainy without cl
 
 ---
 
-## Storage Augmentations (8 total)
+## Storage Augmentations
 
 ### MemoryStorageAugmentation
 **Location**: `src/augmentations/storageAugmentations.ts`
-**Auto-enabled**: When `storage: 'memory'` or in test environments
+**Auto-enabled**: When `storage: { type: 'memory' }` or in test environments
 **Purpose**: In-memory storage for testing and temporary data
 ```typescript
-const brain = new Brainy({ storage: 'memory' })
+const brain = new Brainy({ storage: { type: 'memory' } })
 ```
 
 ### FileSystemStorageAugmentation
 **Location**: `src/augmentations/storageAugmentations.ts`
-**Auto-enabled**: When `storage: 'filesystem'` or Node.js detected
+**Auto-enabled**: When `storage: { type: 'filesystem' }` or Node.js detected
 **Purpose**: Persistent file-based storage for Node.js applications
 ```typescript
 const brain = new Brainy({
- storage: { type: 'filesystem', path: './data' }
+  storage: { type: 'filesystem', rootDirectory: './data' }
 })
 ```
 
-### OPFSStorageAugmentation
-**Location**: `src/augmentations/storageAugmentations.ts`
-**Auto-enabled**: When `storage: 'opfs'` or browser with OPFS support
-**Purpose**: Browser-based persistent storage using Origin Private File System
-```typescript
-const brain = new Brainy({ storage: 'opfs' })
-```
-
-### S3StorageAugmentation
-**Location**: `src/augmentations/storageAugmentations.ts`
-**Manual**: Requires AWS credentials
-**Purpose**: AWS S3-compatible cloud storage
-```typescript
-const brain = new Brainy({
- storage: {
- type: 's3',
- bucket: 'my-bucket',
- region: 'us-east-1',
- credentials: { accessKeyId, secretAccessKey }
- }
-})
-```
-
-### R2StorageAugmentation
-**Location**: `src/augmentations/storageAugmentations.ts`
-**Manual**: Requires Cloudflare credentials
-**Purpose**: Cloudflare R2 storage (S3-compatible)
-```typescript
-const brain = new Brainy({
- storage: {
- type: 'r2',
- accountId: 'xxx',
- bucket: 'my-bucket',
- credentials: { accessKeyId, secretAccessKey }
- }
-})
-```
-
-### GCSStorageAugmentation
-**Location**: `src/augmentations/storageAugmentations.ts`
-**Manual**: Requires Google Cloud credentials
-**Purpose**: Google Cloud Storage
-```typescript
-const brain = new Brainy({
- storage: {
- type: 'gcs',
- bucket: 'my-bucket',
- projectId: 'my-project'
- }
-})
-```
+For off-site backup, snapshot `rootDirectory` from your scheduler using `gsutil rsync`, `aws s3 sync`, `rclone`, or `tar` — there are no cloud storage augmentations.
 
 ### StorageAugmentation (base)
 **Location**: `src/augmentations/storageAugmentation.ts`
@@ -195,11 +145,6 @@ brain.addNouns([...]) // Automatically batched
 **Auto-enabled**: Always active
 **Purpose**: Prevents duplicate concurrent operations
 
-### ConnectionPoolAugmentation
-**Location**: `src/augmentations/connectionPoolAugmentation.ts`
-**Auto-enabled**: For network storage
-**Purpose**: Connection pooling for cloud storage adapters
-
 ---
 
 ## Data Integrity Augmentations (3 total)
@@ -309,11 +254,11 @@ class NotionSynapse extends SynapseAugmentation {
 ### Auto-Configuration
 ```typescript
 const brain = new Brainy({
- // These auto-register augmentations:
- storage: 'auto', // Storage augmentation
- cache: true, // Cache augmentation
- index: true, // Index augmentation
- metrics: true // Metrics augmentation
+  // These auto-register augmentations:
+  storage: { type: 'auto', rootDirectory: './brainy-data' }, // Storage augmentation
+  cache: true,   // Cache augmentation
+  index: true,   // Index augmentation
+  metrics: true  // Metrics augmentation
 })
 ```
 
@@ -403,7 +348,7 @@ Most augmentations have minimal overhead:
 - **Cache**: ~1ms per search (saves 10-100ms on hits)
 - **Index**: ~1ms per operation (saves 100ms+ on queries)
 - **Metrics**: <1ms per operation
-- **Storage**: Varies by adapter (memory: 0ms, S3: 50-200ms)
+- **Storage**: Varies by adapter (memory: 0ms, filesystem: 1-10ms)
 
 ---
 

docs/augmentations/README.md

@@ -55,10 +55,11 @@ Replace or enhance the storage layer.
 
 | Augmentation | Description | Timing | Status |
 |-------------|-------------|--------|--------|
-| **S3StorageAugmentation** | Use S3 as storage backend | `replace` | 📝 Example |
 | **RedisAugmentation** | Redis caching layer | `around` | 📝 Example |
 | **PostgresAugmentation** | PostgreSQL persistence | `replace` | 📝 Example |
 
+> Brainy 8.0 ships `filesystem` and `memory` adapters out of the box. For off-site backup of the filesystem artifact, snapshot `rootDirectory` from your scheduler (`gsutil rsync`, `aws s3 sync`, `rclone`, `tar`).
+
 ### 🔄 Real-time & Sync
 Handle real-time updates and synchronization.
 
@@ -73,7 +74,6 @@ Core infrastructure and reliability features.
 
 | Augmentation | Description | Timing | Status |
 |-------------|-------------|--------|--------|
-| **ConnectionPoolAugmentation** | Optimize cloud storage connections | `before` | ✅ Production |
 | **RequestDeduplicatorAugmentation** | Prevent duplicate concurrent requests | `before` | ✅ Production |
 | **TransactionAugmentation** | ACID transaction support | `around` | 🚧 Planned |
 | **CacheAugmentation** | Multi-level caching | `around` | ✅ Production |