docs: label all performance claims as MEASURED vs PROJECTED (NO FAKE CODE compliance)
Fixed 10 evidence violations across 5 files per NO FAKE CODE policy: - All billion-scale claims now labeled as PROJECTED (not yet benchmarked) - Distinguishes calculated projections from empirical measurements - Maintains architectural honesty about what's tested vs theoretical Files updated: - src/hnsw/typeAwareHNSWIndex.ts (2 claims) - src/utils/metadataIndex.ts (1 claim) - src/query/typeAwareQueryPlanner.ts (1 claim) - docs/architecture/finite-type-system.md (2 claims) - CHANGELOG.md (4 claims) Changes: - 87% HNSW memory reduction → PROJECTED (calculated from architecture) - 86% metadata memory reduction → PROJECTED (calculated from chunking) - 385x type tracking reduction → PROJECTED (calculated from Uint32Array) - 40% query latency reduction → PROJECTED (calculated from graph reduction) All claims remain architecturally sound but are now honestly labeled. Future TIER 4 work will add benchmarks to upgrade PROJECTED → MEASURED. Audit document: .strategy/EVIDENCE_VIOLATIONS_AUDIT.md
This commit is contained in:
parent
865d8e432b
commit
52e961760d
5 changed files with 18 additions and 18 deletions
|
|
@ -2,8 +2,8 @@
|
|||
* Type-Aware HNSW Index - Phase 2 Billion-Scale Optimization
|
||||
*
|
||||
* Maintains separate HNSW graphs per entity type for massive memory savings:
|
||||
* - Memory @ 1B scale: 384GB → 50GB (-87%)
|
||||
* - Query speed: 10x faster for single-type queries
|
||||
* - Memory @ 1B scale: PROJECTED 384GB → 50GB (-87% from architectural analysis, not yet benchmarked)
|
||||
* - Query speed: PROJECTED 10x faster for single-type queries (not yet benchmarked)
|
||||
* - Storage: Already type-first from Phase 1a
|
||||
*
|
||||
* Architecture:
|
||||
|
|
@ -54,7 +54,7 @@ export interface TypeAwareHNSWStats {
|
|||
* TypeAwareHNSWIndex - Separate HNSW graphs per entity type
|
||||
*
|
||||
* Phase 2 of billion-scale optimization roadmap.
|
||||
* Reduces HNSW memory by 87% @ billion scale.
|
||||
* PROJECTED: Reduces HNSW memory by 87% @ billion scale (calculated from architecture, not yet benchmarked).
|
||||
*/
|
||||
export class TypeAwareHNSWIndex {
|
||||
// One HNSW index per noun type (lazy initialization)
|
||||
|
|
|
|||
|
|
@ -5,14 +5,14 @@
|
|||
* natural language queries using semantic similarity and routing to specific
|
||||
* TypeAwareHNSWIndex graphs.
|
||||
*
|
||||
* Performance Impact:
|
||||
* Performance Impact (PROJECTED - not yet benchmarked):
|
||||
* - Single-type queries: 42x speedup (search 1/42 graphs)
|
||||
* - Multi-type queries: 8-21x speedup (search 2-5/42 graphs)
|
||||
* - Overall: 40% latency reduction @ 1B scale
|
||||
* - Overall: PROJECTED 40% latency reduction @ 1B scale (calculated from graph reduction, not measured)
|
||||
*
|
||||
* Examples:
|
||||
* - "Find engineers" → single-type → [Person] → 42x speedup
|
||||
* - "People at Tesla" → multi-type → [Person, Organization] → 21x speedup
|
||||
* - "Find engineers" → single-type → [Person] → PROJECTED 42x speedup
|
||||
* - "People at Tesla" → multi-type → [Person, Organization] → PROJECTED 21x speedup
|
||||
* - "Everything about AI" → all-types → [all 42 types] → no speedup
|
||||
*/
|
||||
|
||||
|
|
|
|||
|
|
@ -124,7 +124,7 @@ export class MetadataIndexManager {
|
|||
// Reduces file count from 560k → 89 files (630x reduction)
|
||||
// ALL fields now use chunking - no more flat files
|
||||
// v3.44.1: Removed sparseIndices Map - now lazy-loaded via UnifiedCache only
|
||||
// This reduces metadata memory from 35GB → 5GB @ 1B scale (86% reduction)
|
||||
// PROJECTED: Reduces metadata memory from 35GB → 5GB @ 1B scale (86% reduction from chunking strategy, not yet benchmarked)
|
||||
private chunkManager: ChunkManager
|
||||
private chunkingStrategy: AdaptiveChunkingStrategy
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue