tidaldb/tidal/docs/planning/milestone-0/phase-1/task-02-sandboxed-storage.md
jx12n 3bcfb3c576 feat: Bazel build, crate docs/ai-lookup, docker images, and engine hardening
- Add BUILD.bazel across tidal, tidal-net, tidal-server, tidalctl for bzlmod build
- Add tidal/ crate docs (README, CHANGELOG, CONTRIBUTING, AGENTS, CLAUDE, API, ARCHITECTURE) and ai-lookup reference
- Add docker standalone/cluster/deploy images, compose, and prometheus config
- Harden WAL (batch format, writer, dedup, diagnostics), text syncer/collectors, and vector registry
- Expand tidalctl CLI and tests; restructure WAL/visibility integration test suites
- Refine tidal-net transport/client/server and tidal-server cluster/scatter-gather
2026-06-07 18:29:38 -06:00

745 B

Task 02 — Sandboxed Storage Layout

Goal: deterministic filesystem layout for embedded instances so tooling/cleanup is reliable.

Deliverables

  • Paths helper that derives {base}/wal, {base}/items, {base}/users, etc., and ensures directories exist with correct perms.
  • Temp-dir helper (TempTidalHome) for tests; implements Drop to delete directories unless preserve=true.
  • Documentation table describing folder purpose for future CLI use.

Acceptance Criteria

  • Integration test proves two builders pointing to different TempTidalHome roots never collide.
  • Cleanup confirmed via test that drops the helper and asserts directories removed.
  • Paths helper reused by upcoming CLI (Phase 2) — single source of truth.