chore: recovery checkpoint - v3.0 API successfully recovered

CRITICAL CHECKPOINT - DO NOT PUSH TO GITHUB

Recovery Status:
- Successfully recovered brainy.ts from compiled JavaScript
- All core v3.0 API methods functional (add, get, update, delete, relate, find, etc.)
- Neural subsystem intact (562KB embedded patterns, NLP working)
- Augmentation pipeline operational (20+ augmentations)
- HNSW clustering system complete
- Triple Intelligence compiled (needs constructor fix)
- Test suite validates functionality

Changes preserved:
- 898 files with changes from last 3 days
- 144,475 insertions
- All augmentation improvements
- All test coverage enhancements
- Complete v3.0 feature set

This is a LOCAL checkpoint only - contains recovered work after corruption incident.
Created backup in .backups/brainy-full-20250910-151314.tar.gz

Branch: recovery-checkpoint-20250910-151433
Date: Wed Sep 10 03:18:04 PM PDT 2025

examples/README.md

@@ -0,0 +1,32 @@
+# Brainy Examples
+
+This directory contains example code and test scripts for Brainy.
+
+## Structure
+
+- `demo.ts` - Basic demonstration of Brainy's core features
+- `tests/` - Various test scripts demonstrating different aspects of Brainy
+  - Performance tests
+  - Memory tests
+  - Storage adapter tests
+  - API functionality tests
+  - CLI tests
+
+## Running Examples
+
+### Basic Demo
+```bash
+npm run build
+node dist/examples/demo.js
+```
+
+### Test Scripts
+The scripts in `tests/` are standalone Node.js scripts that can be run directly:
+
+```bash
+node examples/tests/test-simple.js
+node examples/tests/test-core-functionality.js
+```
+
+## Note
+These are examples and test scripts for reference. For production use, see the main documentation in the project root.