brainy/src/importers
David Snelling 52782898a3 feat: implement progressive flush intervals for streaming imports
Progressive intervals adjust dynamically based on current entity count
(not total), making them work for both known and unknown totals.

**Key Features:**
- 0-999 entities: Flush every 100 (frequent early updates for UX)
- 1K-9.9K: Flush every 1000 (balanced performance)
- 10K+: Flush every 5000 (minimal overhead ~0.3%)

**Benefits:**
- Works with known totals (file imports)
- Works with unknown totals (streaming APIs, database cursors)
- Adapts automatically as import grows
- Zero configuration required

**Implementation:**
- Replaced adaptive intervals (requires total count) with progressive
- Added interval transition logging for observability
- Enhanced documentation to highlight engineering sophistication
- Final flush with statistics reporting

**Documentation:**
- Added "Engineering Insight" section showcasing advanced approach
- Updated all interval references from "adaptive" to "progressive"
- Added comprehensive examples in streaming-imports.md

Generated with Claude Code (https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-22 17:36:27 -07:00
..
index.ts feat: add unified import system with auto-detection and dual storage 2025-10-08 16:55:30 -07:00
SmartCSVImporter.ts feat: implement progressive flush intervals for streaming imports 2025-10-22 17:36:27 -07:00
SmartDOCXImporter.ts feat: implement progressive flush intervals for streaming imports 2025-10-22 17:36:27 -07:00
SmartExcelImporter.ts feat: implement progressive flush intervals for streaming imports 2025-10-22 17:36:27 -07:00
SmartImportOrchestrator.ts feat: add real-time progress callbacks for relationship building phase 2025-10-16 12:08:46 -07:00
SmartJSONImporter.ts feat: implement progressive flush intervals for streaming imports 2025-10-22 17:36:27 -07:00
SmartMarkdownImporter.ts feat: implement progressive flush intervals for streaming imports 2025-10-22 17:36:27 -07:00
SmartPDFImporter.ts feat: implement progressive flush intervals for streaming imports 2025-10-22 17:36:27 -07:00
SmartYAMLImporter.ts feat: implement progressive flush intervals for streaming imports 2025-10-22 17:36:27 -07:00
VFSStructureGenerator.ts feat: implement progressive flush intervals for streaming imports 2025-10-22 17:36:27 -07:00