v7.30.2 — find limit calibration + UX
Highlights
- Recalibrate
find({ limit })cap formula from 100 KB/result to 25 KB/result (matches observed entity footprint). Typical caps ~4× more generous;maxQueryLimit/reservedQueryMemoryoverrides unchanged. - Two-tier enforcement: silent pass below cap, one-time warning per call site in the soft tier (
cap < limit ≤ 2× cap), throw in the hard tier (> 2× cap). - Improved error / warning messages name the three escape valves (
maxQueryLimit,reservedQueryMemory, pagination), include caller stack frame, link to new docs. - New public guide:
docs/guides/find-limits.md. findCallerLocation()extracted tosrc/utils/callerLocation.tsand shared with the 7.30.1 subtype enforcement.
Cortex compatibility
Zero changes required. All work is JS-side validation that runs before any storage / Cortex call.
Tests
- New
tests/integration/find-limits.test.ts(9 tests) - Recalibrated
tests/unit/utils/memoryLimits.test.ts(4 tests) - 1468 / 1468 unit suite passing
See RELEASES.md for the full entry.