Skip to content
Tenura docs

Start Here

Smallest useful programs and the local-dev / test / observe loop. Read these first.

When to read this section

You are new to grafOS and want a working program in your hands inside an hour, plus the tools you need to debug, test, and observe what you build later. Everything else in the cookbook assumes you can run a tasklet, inspect events, and have a deterministic test harness.

Suggested order

  1. The Smallest Working Tasklet — your first compile-and-run. Five minutes; produces a real output you can inspect.
  2. Local Development Loop — how to iterate. Sets up the dev fabric, the watch loop, and the redeploy story.
  3. Testing a Distributed System Without a Distributed System — the deterministic test harness. Read this before you write any production code that touches leases.
  4. Observing Everything — the meta-recipe. How structured events flow from your program through the fabric to operator dashboards and the audit chain.

What’s not here

Production patterns. Real workloads. Concurrency. Failure recovery. Those come next — once you have a green test and a dashboard panel for what you built.