brainy/docs/technical
David Snelling abc17397b1 feat: Remove dangerous getAllNouns/getAllVerbs methods, add safe pagination
BREAKING CHANGE: Removed getAllNouns() and getAllVerbs() from StorageAdapter interface
These methods could cause expensive full scans on cloud storage (S3/R2) leading to
high costs and performance issues. Replaced with safe paginated methods.

Changes:
- Remove getAllNouns/getAllVerbs from StorageAdapter interface and implementations
- Add internal optimization methods for intelligent preloading when safe
- Fix OPFS storage file naming consistency (.json extension)
- Fix S3 high-volume mode detection thresholds (was too aggressive)
- Fix TypeScript compilation errors with async methods
- Update all tests to use paginated methods

Performance:
- Add smart dataset size detection for automatic optimization
- Maintain all internal performance optimizations through safe preloading
- Only preload data in read-only mode or when dataset is small (<10k entities)

Fixes:
- Fix intelligent verb scoring tests metadata structure
- Fix S3 storage getVerbsBySource/Target/Type methods
- Fix memory usage in search operations using pagination

Docs:
- Add comprehensive storage architecture documentation
- Document known bash redirection issue
- Update README with architecture doc link

All affected tests passing
2025-08-10 16:25:12 -07:00
..
COMPATIBILITY.md feat(docs): add comprehensive user guides and installation instructions for Brainy 2025-08-03 17:33:52 -07:00
CONCURRENCY_ANALYSIS.md **chore: remove outdated changelog and summary documents** 2025-07-30 11:51:39 -07:00
ENVIRONMENT_TESTING.md **chore(archive): remove outdated documentation and summaries** 2025-08-01 16:21:35 -07:00
METADATA_HANDLING.md **chore: remove outdated changelog and summary documents** 2025-07-30 11:51:39 -07:00
model-bundling-analysis.md **chore(archive): remove outdated documentation and summaries** 2025-08-01 16:21:35 -07:00
REALTIME_UPDATES.md **chore: remove outdated changelog and summary documents** 2025-07-30 11:51:39 -07:00
SCALING_STRATEGY.md **chore(archive): remove outdated documentation and summaries** 2025-08-01 16:21:35 -07:00
STATISTICS.md feat: add comprehensive throttling detection and metrics collection 2025-08-08 07:14:10 -07:00
STORAGE_AND_RETRIEVAL_ARCHITECTURE.md feat: Remove dangerous getAllNouns/getAllVerbs methods, add safe pagination 2025-08-10 16:25:12 -07:00
STORAGE_CONCURRENCY_ANALYSIS.md **chore: remove outdated changelog and summary documents** 2025-07-30 11:51:39 -07:00
STORAGE_TESTING.md **chore: remove outdated changelog and summary documents** 2025-07-30 11:51:39 -07:00
TECHNICAL_GUIDES.md refactor: simplify build system and improve model loading flexibility 2025-08-05 16:09:30 -07:00
TESTING.md **chore: remove outdated changelog and summary documents** 2025-07-30 11:51:39 -07:00
THREADING.md refactor: simplify build system and improve model loading flexibility 2025-08-05 16:09:30 -07:00
THROTTLING_METRICS.md feat: add comprehensive throttling detection and metrics collection 2025-08-08 07:14:10 -07:00
USE_MODEL_LOADING_EXPLANATION.md **chore: remove outdated changelog and summary documents** 2025-07-30 11:51:39 -07:00
VECTOR_DIMENSION_STANDARDIZATION.md **chore(archive): remove outdated documentation and summaries** 2025-08-01 16:21:35 -07:00
VITEST_IMPROVEMENTS.md **chore: remove outdated changelog and summary documents** 2025-07-30 11:51:39 -07:00