writeonce/docs/stories/language-runtime-database
shoney.arickathil 71d3985e81 docs: performance arc as story iterations (9e measure, 9f io_uring)
- 9e durability/throughput/scale: the measurement backbone -- run the
  employee program, restart to prove persistence, benchmark read/write
  through compiled .wo, ~1M-row mixed load with throughput floor + p99
  ceiling + flat RSS; the gate every optimization signs (before/after
  delta required, no measured delta = not accepted)
- 9f io_uring group-commit: replace fsync-per-commit with batched
  io_uring durability overlapped on shard threads; same ack-after-
  durable contract, crash battery unchanged, automatic fsync fallback
  on kernels without it; deliberately LAST (needs 8's threads to
  overlap and 9e's baseline to beat)
- wired the existing levers into the arc: iteration 8 (thread-per-core)
  = "optimize multithreading", 7b (mark-sweep) = "implement GC" --
  each now gated by re-running 9e and recording the delta
- explicit sequence recorded in 9e: 9b lands -> 9e baseline -> 7b
  re-bench -> 8 re-bench -> 9f re-bench
- roadmap + board rows for 9e/9f; four forks each for the specs
  (load generator, absolute vs relative budgets, what "1M" means,
  durable vs RAM headline; ring model, liburing vs raw, batch
  boundary, fallback testing)

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-15 22:12:48 +02:00
..
00-story.md docs: performance arc as story iterations (9e measure, 9f io_uring) 2026-08-15 22:12:48 +02:00
01-principles-doc.md language-runtime-database iterations 2026-08-07 19:36:49 +02:00
02-vm-core.md language-runtime-database iterations 2026-08-07 19:36:49 +02:00
03-compiler-front.md docs: compiler front-end specifications and plans (Tasks 2-6) 2026-08-10 09:11:04 +02:00
04-single-binary-e2e.md language-runtime-database iterations 2026-08-07 19:36:49 +02:00
05-language-surface.md docs: reprioritise to log-watcher-executable only; update stories and plans 2026-08-14 22:16:14 +02:00
06-program-mode-stdlib.md docs: reprioritise to log-watcher-executable only; update stories and plans 2026-08-14 22:16:14 +02:00
07-logwatcher-proof.md docs: reprioritise to log-watcher-executable only; update stories and plans 2026-08-14 22:16:14 +02:00
07b-inferred-gc-mark-sweep.md docs: performance arc as story iterations (9e measure, 9f io_uring) 2026-08-15 22:12:48 +02:00
08-shard-actor-runtime.md docs: performance arc as story iterations (9e measure, 9f io_uring) 2026-08-15 22:12:48 +02:00
09-database-engine.md docs: borrow/GC analysis for the database engine, into the iterations 2026-08-15 09:57:53 +02:00
09b-table-relations-query.md docs: borrow/GC analysis for the database engine, into the iterations 2026-08-15 09:57:53 +02:00
09c-cross-program-tables.md docs: employee-list sample -- program B's manifest pair (9c/9d target) 2026-08-15 12:34:19 +02:00
09d-keypair-attach-auth.md docs: employee-list sample -- program B's manifest pair (9c/9d target) 2026-08-15 12:34:19 +02:00
09e-durability-throughput-scale.md docs: performance arc as story iterations (9e measure, 9f io_uring) 2026-08-15 22:12:48 +02:00
09f-io-uring-commit.md docs: performance arc as story iterations (9e measure, 9f io_uring) 2026-08-15 22:12:48 +02:00
10-http-service.md language-runtime-database iterations 2026-08-07 19:36:49 +02:00
11-fibers.md docs: story iterations 11-12 (fibers, blue-green deploy) 2026-08-10 09:58:52 +02:00
12-blue-green-deploy.md docs: story iterations 11-12 (fibers, blue-green deploy) 2026-08-10 09:58:52 +02:00