The lists below are split by surface so you can focus on the layer you own: Python SDK, CLI, or Operator.
Happy Paths
A happy path is the canonical, no-edge-cases flow through a feature — what a user runs when everything works. For Lakeshore, the paths below are both:
- the test plan — each one is a scripted walkthrough; "green across all of them" is the shipping bar; and
- the implementation roadmap — when one is red, the work to turn it green is the next concrete unit.
Working through them
- Walk top-down. Ordered leaf-nodes-first; each depends on the
ones above. If
02is red, don't chase08— fix02first. - One owner, one outcome. Each page ends with a single "I ran it and it worked" verdict.
- Status drifts. Re-run regularly; a green path can go red when unrelated changes ship.
- Cheap checkpoint vs. expensive. Unit-test surface lives at /get-started/status (runs every commit). Happy paths are the expensive checkpoint that ties everything together.
What this isn't
Not the user-facing tutorial set (Tutorials). Happy paths are project-facing — contributors and operators run them to verify the surface is intact. Many duplicate the tutorials on purpose, with stricter step-by-step assertions.
The list
| # | Path | Verifies |
|---|---|---|
| 01 | Hello, local Python | Python SDK install + decorator |
| 02 | Hello, hosted control plane | Auth + token wire |
| 03 | Hello, local stack | CP + nymph + CLI on localhost |
| 04 | Smoke-exec cascade | The whole daemon exec surface |
| 05 | Hello, queue-bound UDF | Submit → poll → execute round-trip |
| 06 | Fan out and gather | Parallelism + ordered collection |
| 07 | SSH provider smoke | Provider abstraction (no daemon) |
| 08 | Bootstrap a daemon on a remote host | Daemon-on-remote install |
| 09 | Storage round-trip | Presigned URLs against a real bucket |
| 10 | Code mount | Local code → S3 → worker |
| 11 | Storage access from a UDF | Worker fetch from logical storage |
| 12 | Compose a cluster declaratively | Declarative lakeshore up/down |
| 13 | Cloud provider launch | EC2/GCE/Slurm/Kube launch |
| 14 | Dashboard observability | Reactive view of the system |
| 15 | Token lifecycle | Admin → namespace → client auth |