Guide

Lenses / What happens when

What happens when a request comes in.

One route, drawn as a tree. The request comes in at the top; each fork is a branch the code takes, each ring an effect, and each path ends in what the request gets back. Yichus computes the tree from the program, so your agent can show you every way an action can go before anyone uses it.

The scenario tree and its bug/fix colouring come from Lauren Tan’s (poteto) TLA+ diagrams.

Wrappers fold away

A shared wrapper, such as a permission check or an audit write, folds into one shaded box, so the route’s own work stands out.

Loading the audited-notes tree.

Loading the audited-notes tree.

A fix, drawn on the path it fixed

The fix checks the author before saving. The refused edit now ends green, and the old red ending is drawn faded beside it.

Loading the shared-docs tree.

When Yichus cannot say

Where Yichus cannot follow the code, the ending is hollow and the reason is written under the tree.

Loading the sequence-probe tree.

Loops and work not waited for

A loop sits in a shaded band holding one pass of it; its ends move on to the next item. Work the route starts and does not wait for gets a band of its own, and the request answers without it.

Loading the outbox tree.

Loading the detached-task tree.

A read that chooses what flows without being copied into it is named after the value: selected by, then the read. The muted feed below reads selected by mutes; its near miss keeps every post and does not.

Loading the keep-skip tree.

Loading the keep-skip-unfiltered tree.

A small service

Each notes route is one sign-in check and one path.

Loading the notes-api tree.

A policy decided when the program is built

A policy chosen when the program is built: the read route has no branch, the write route depends on the caller.

Loading the policy-docs tree.

A larger program

Icetakes takes in articles from its readers. The main path runs straight down, and each early refusal is a short line off to the side.

Loading the Icetakes tree.

Ask your agent about anything here; it has the detail.

Where this fits

What this is about: Lenses and diagrams