RURALReal-project import exercise
A verified local import and readback of 687 records and 1,227 links, with its limits.
Verified local exercise · 23 September 2026 · macOS arm64. RURAL imported a read-only copy of another project's SurrealDB-derived projection into an isolated local profile. The original project files remained authoritative; its application was not switched to RURAL.
What the exercise contained#
The source projection held 687 records and 1,227 links at source sequence 212. RURAL mapped source identities deterministically, stored compact searchable documents plus bounded payload chunks, and represented links as graph edges. The final profile committed 2,872 actions and reached main head 2874.
After restarting the RURAL service, an independent verifier reconstructed all 687 source JSON records byte for byte from 687 summaries and 956 chunks. It also checked every link payload and mapped endpoint through paged graph reads. A native Atlas window opened the imported collection and displayed an initial bounded page of 50 records; the CLI and verifier could address the rest.
The importer's progress file is synchronized before each submitted action. If a response is lost, rerunning with the same projection and profile replays the pending request identity. Historical authority and wallet-like fields are stored as inert data; they never grant credentials, spending rights or execution authority.
Limits that matter#
This is a one-way local alpha bridge, not live synchronization, a general SurrealDB compatibility layer or an application migration. The Atlas initial view is limited to 50 records; native search and pagination are future work. The exercise does not prove production throughput, clustering, viral-scale intake or a performance advantage over another database. The full developer runbook and exact source digest remain in the repository's local prototype documentation; private source data and operator paths are excluded from this public page.
See mathematical foundations for the transaction model and project status for the acceptance gates.