History

jordan 936da3c520 feat: add exact qualified-hot ranking API		2026-09-09 09:34:26 -06:00
..
guides	feat: add exact qualified-hot ranking API	2026-09-09 09:34:26 -06:00
legal	feat(m12): multi-vector user preference modeling + ANN candidate-gen	2026-06-23 09:52:36 -06:00
ops	harden: restore CI verification, remove four wire-level fabrications, instrument the 401 path	2026-08-30 20:55:58 -06:00
planning	feat: add exact qualified-hot ranking API	2026-09-09 09:34:26 -06:00
profiling	fix(m12p6): 6-bug k3s 3-shard cluster repair (rc8+rc9)	2026-06-16 22:34:21 -06:00
research	feat(m12): multi-vector user preference modeling + ANN candidate-gen	2026-06-23 09:52:36 -06:00
reviews	feat(m11): observability+ops (m11p8) + perf-sweep wave 2 T2	2026-06-13 09:17:49 -06:00
runbooks	ci: gate the image on deterministic suites; the rolling upgrade becomes pre-release	2026-08-31 02:24:43 -06:00
specs	feat: add exact qualified-hot ranking API	2026-09-09 09:34:26 -06:00
content-strategy.md	feat: complete Milestone 5 — full-text search, RRF fusion, and creator search	2026-02-21 23:53:16 -07:00
personal-briefing-beachhead.md	feat: M0p1 runtime skeleton, M0p2 tooling & diagnostics, m1p4 signal ledger	2026-02-20 20:32:00 -07:00
README.md	docs(m12): refresh API, specs, ops, and roadmap to the shipped M12 reality	2026-06-23 21:39:55 -06:00
roadmap-to-cluster.md	feat(m11): sharding × replication + rebalancing (m11p6 L3-L5)	2026-06-13 18:23:43 -06:00

README.md

tidalDB Engineering Docs

The engineering documentation home. Top-level product docs (VISION, USE_CASES, SEQUENCE, ARCHITECTURE, API, QUICKSTART, CODING_GUIDELINES, thoughts) live at the repository root; everything below is the deeper engineering record.

This and the repo root are the two canonical doc homes. There is intentionally no per-crate doc mirror (no tidal/docs/). Edit the canonical file, never a copy.

Component specs — `specs/`

The authoritative component specifications (status: Implemented, M0–M12).

#	Spec	#	Spec
00	Architecture overview	08	Query engine
01	Storage engine	09	Ranking & scoring
02	Entity model	10	Feedback loop
03	Signal system	11	Schema
04	Relationships	12	Cold start
05	Cohorts	13	Concurrency
06	Text retrieval	14	Scale architecture
07	Vector retrieval

Planning — `planning/`

ROADMAP.md — milestones M0–M12, phase status, known gaps
roadmap-to-cluster.md — adopted M11 plan: gap analysis + phase specs taking the multi-process cluster from experimental to enterprise-grade (all nine phases m11p1–p9 ✅, 2026-06-13), grounded in the 2026-06-10 live stress-test baselines
PRODUCT_ROADMAP.md · architecture-review.md · roadmap-cohort-analysis.md · site-cohort-analysis.md
Per-milestone phase/task archive: planning/milestone-0,1,2,3,5,7,8,9,10,11,p/

Code reviews — `reviews/`

M0–M10 code review — 2026-06-07 — seven-dimension re-review, 88 verified findings
M0–M10 code review — 2026-06-08 — seven-dimension review, 142 findings (latest pass)
M0–M10 seven-dimension review — additional pass (2 BLOCKERs: signal-checkpoint trim, 30-day window)

Guides — `guides/`

Task-oriented, build-an-app docs (complements the root QUICKSTART.md and API.md):

Build a feed app — end-to-end TikTok/Reels-style "For You" feed, embedded and over HTTP
Embedding integration — wiring a real embedding model (OpenAI / Cohere / local) into the write + query paths
Server deployment — running the tidal-server HTTP service: config, auth, the served OpenAPI spec, Docker
Ranking-profile reference: ai-lookup/services/ranking-profiles.md — all 25 built-in profiles