Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 0 additions & 2 deletions .claude/skills/verify-resume/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,8 +30,6 @@ just rs tla moq-net/verify/resume/ResumeReader.tla -config rs/moq-net/verify/res

The first checks every rule over two routes, three groups, two switches, and a reader holding each group until it finishes it: about 14.3M distinct states, in minutes. The second trades a group for a third route, so a route can come up after another failed: about 7.1M states, in minutes. Both pass at the sync commit. `just test tla rs/moq-net/verify/resume` runs every config here, as Nightly does, and fails if a config with an `\* Open finding:` line passes.

`Chart.cfg` is a story (`Story`) small enough to draw whole, where the reader switches to a route that holds an older group and asks it for that group.

## Open findings

None at the sync commit.
Expand Down
38 changes: 0 additions & 38 deletions js/publish/verify/Publish.view.ts

This file was deleted.

17 changes: 7 additions & 10 deletions js/publish/verify/README.md
Original file line number Diff line number Diff line change
@@ -1,31 +1,28 @@
# Publish flow

`Publish.tla` is a TLA+ model of going live with `<moq-publish source="camera">`, written to be
drawn as a statechart. It follows the camera and microphone capture (asking,
`Publish.tla` is a TLA+ model of going live with `<moq-publish source="camera">`.
It follows the camera and microphone capture (asking,
capturing, denied, a lost device reopening within its retry budget, failed), the encoders
settling, the `source`-mode announce gate in `src/announce.ts`, and the relay connection. The
chart labels each state with what the status badge says and whether viewers can find the
broadcast.
settling, the `source`-mode announce gate in `src/announce.ts`, and the relay connection, along
with what the status badge says and whether viewers can find the broadcast.

| Rule | Holds when | Today |
| --- | --- | --- |
| `LiveMeansWatchable` | The badge says LIVE only while viewers can find the broadcast. | Breaks: the badge reads the connection and the captured sources, not the announce gate, so it says LIVE while the gate waits for the encoders to settle. Accepted 2026-11-10 (maintainer): the window is usually milliseconds, so `Publish.cfg` leaves it out. |
| `StopStopsPublishing` | A publisher who stopped the camera publishes nothing. | Holds. |
| `DenialIsShown` | A publisher who refused the camera is told so. | Holds. |

The chart also shows that a camera lost after going live keeps the broadcast announced (by
A camera lost after going live keeps the broadcast announced (by
design, so a capture gap only edits the catalog) while the badge says NO SOURCE, then CAMERA
FAILED once the reopen budget runs out. It hides "you stop the camera", which every selected
state has.
FAILED once the reopen budget runs out.

## Run

```sh
just test tla js/publish
```

This must pass, as Nightly checks. The chart draws from
`Publish.tla`, `Publish.cfg`, and `Publish.view.ts`.
This must pass, as Nightly checks.

## Left out

Expand Down
9 changes: 4 additions & 5 deletions js/room/verify/README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Room flow

`Room.tla` is a TLA+ model of you and Bob in a room, written to be drawn as a statechart.
`Room.tla` is a TLA+ model of you and Bob in a room.
Your side is `src/local.ts`: joining announces your camera broadcast, and a live
screen share announces your screen broadcast while joined. Your view of Bob is `src/room.ts`: each of his
announcements adds or removes one of his broadcasts, and your connection dropping removes him
Expand All @@ -10,17 +10,16 @@ until the reconnect announces him again.
| --- | --- |
| `LeavingStopsPublishing` | Someone who has not joined the room, or has left it, publishes nothing to it. |

The chart also shows every participant leaving your screen while your connection is down and
coming back once it reconnects.
Every participant also leaves your screen while your connection is down and
comes back once it reconnects.

## Run

```sh
just test tla js/room
```

The chart draws from
`Room.tla`, `Room.cfg`, and `Room.view.ts`. `Room.cfg` plays only Bob's camera; add `"screen"` to
`Room.cfg` plays only Bob's camera; add `"screen"` to
`Kinds` to play his share too.

## Left out
Expand Down
2 changes: 1 addition & 1 deletion js/room/verify/Room.cfg
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
\* Bob only joins and leaves, which keeps the chart readable; add "screen" to play his share too.
\* Bob only joins and leaves; add "screen" to play his share too.
SPECIFICATION Spec
CONSTANT Kinds = {"camera"}
INVARIANT LeavingStopsPublishing
64 changes: 0 additions & 64 deletions js/room/verify/Room.view.ts

This file was deleted.

82 changes: 0 additions & 82 deletions js/watch/verify/Failover.view.ts

This file was deleted.

5 changes: 2 additions & 3 deletions js/watch/verify/README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Watch flows

TLA+ models of two viewer flows, written to be drawn as statecharts. Each
TLA+ models of two viewer flows. Each
models what the code does today, in the viewer's words, so a rule that breaks is a bug a viewer
can hit.

Expand Down Expand Up @@ -46,8 +46,7 @@ just test tla js/watch
This runs every config, as Nightly does. `Watch.cfg` and `Failover.cfg` check the rules that hold
and must pass; each rule that breaks has its own config, marked `\* Open finding:`, which must
fail until the fix moves its rule into the passing one. A config checks the spec its name starts
with. A chart draws from the spec, a config, and its `.view.ts`; a
finding's config charts its break.
with.

## Left out

Expand Down
51 changes: 0 additions & 51 deletions js/watch/verify/Watch.view.ts

This file was deleted.

Loading