Auto Update

Author: andrestubbe

REFERENCE.md

@@ -0,0 +1,26 @@
+# FastFileIndex Reference
+
+## 1. CPU Feature Model
+*   **AVX2** — detected via CPUID. Enables 32-byte vector ops.
+*   **SSE4.2** — detected via CPUID. 16-byte fallback.
+*   **Fallback rule**: AVX2 → SSE4.2 → scalar.
+
+## 2. Guarantees
+*   **Zero-Copy**: All operations use `GetPrimitiveArrayCritical` for direct memory access.
+*   **Unaligned Access**: Safe on all byte boundaries.
+*   **Thread-Safety**: All static native methods are thread-safe.
+
+## 3. JNI & Memory Contracts
+*   **Direct Memory Pinning**: No implicit copies are made by the JNI bridge.
+*   **No Allocation**: All operations work on pre-allocated Java arrays or buffers.
+*   **Critical Sections**: Native calls minimize blocking to prevent GC impact.
+
+## 4. Platform Support
+| Platform | Status |
+|----------|--------|
+| Windows 10/11 (x64) | ✅ Fully Supported |
+
+---
+**Part of the FastJava Ecosystem** — *Making the JVM faster.*
+
+Made with ⚡ by Andre Stubbe

ROADMAP.md

@@ -0,0 +1,24 @@
+# FastFileIndex Roadmap 🗺️
+
+**Vision:** To provide the fastest possible native primitives for file indexing by aggressively bypassing bottlenecks in standard Java.
+
+## 🟢 v0.1.0: Initial Release (Current)
+- [x] **Core Native Engine**: Basic JNI implementation.
+- [x] **Blueprint Standards**: README, Reference, and Philosophy integration.
+- [ ] **Basic Performance Suite**: Initial benchmarks vs standard Java.
+
+## 🟡 v0.2.0: Optimization Phase
+- [ ] **SIMD Acceleration**: Implement AVX2/SSE4.2 paths for core loops.
+- [ ] **Software Prefetching**: Optimize memory access patterns.
+- [ ] **Alignment Enforcement**: Ensure zero-penalty memory boundaries.
+
+## 🟠 v0.5.0: Platform & Logic Expansion
+- [ ] **ARM NEON Port**: Parity for Apple Silicon/Mobile.
+- [ ] **Advanced Features**: Multi-threaded paths and complex batch operations.
+
+## 🔴 v1.0.0: Production Hardening
+- [ ] **Full Stability Audit**: Long-run stress testing.
+- [ ] **Enterprise Support**: NUMA-awareness and Large Pages support.
+
+---
+**Focus:** Performance is our USP. We optimize where Java stops.