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
8 changes: 8 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,8 @@ has a matching GitHub release whose body comes from its section below.

## [Unreleased]

## [v0.6.1] - 2026-11-15

### Fixed

- The gateway no longer sends a request to an engine whose lease is draining, parking or releasing. It holds the
Expand All @@ -18,6 +20,12 @@ has a matching GitHub release whose body comes from its section below.
instead of idle. Before, an NInfer build without `/slots`, or Ollama, read idle while it served, and a juggle
handed its card over as if no request were running. `berth status --format json` shows the new
`in_flight_reported` field per engine.
- On a phone narrower than 340 pixels, the SCHEDULE label in the harbor's bottom tab bar no longer runs into the
labels beside it.

### Documentation

- The README and the harbor guide show the SCHEDULE tab, and the harbor screenshots are new.

## [v0.6.0] - 2026-11-14

Expand Down
10 changes: 6 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@ claim. When another engine holds it, Berth:
The numbered markers on the timeline are those four steps. A process that holds VRAM without a lease
shows up as a stowaway: Berth reports its PID and memory and leaves it running.

> **Status: alpha, v0.6.0.** Runs daily on an RTX 4090 workstation beside llama-swap, NInfer,
> **Status: alpha, v0.6.1.** Runs daily on an RTX 4090 workstation beside llama-swap, NInfer,
> Strata, ComfyUI and games, and testers run it on Windows. The [docs](docs/README.md) cover what works and has tests; the
> [roadmap](docs/roadmap.md) lists the phases and what is still missing.

Expand Down Expand Up @@ -270,16 +270,18 @@ which `berth service status` prints.

## Preview

The screenshots show the harbor web UI with its built-in demo data: the CARD tab, the Engines tab in advanced
mode, and the CARD tab at phone width.
The screenshots show the harbor web UI with its built-in demo data: the CARD tab, the SCHEDULE tab, the Engines
tab in advanced mode, and the CARD tab at phone width.
[The harbor and telemetry](docs/harbor.md) explains every panel and shows how to add the harbor to an
iPhone's Home Screen.

<p align="center"><img src="assets/preview-harbor.png" alt="Berth harbor: the CARD tab with ticket counter, request KPIs, the tide of card memory by holder, and the model timeline" width="900"></p>

<p align="center"><img src="assets/preview-schedule.png" alt="Berth harbor SCHEDULE tab: NOW with the holders, the waiters and the booking in force, 7 DAYS with one track per day of bookings, windows and the live holder, and the list of bookings" width="900"></p>

<p align="center"><img src="assets/preview-requests.png" alt="Berth harbor Engines tab, advanced mode: decode throughput per engine, the token ledger, the per-model leaderboard, storage and residency" width="900"></p>

<p align="center"><img src="assets/preview-mobile.png" alt="Berth harbor at phone width: the CARD tab with the ticket counter, collisions avoided, the collision tiles and the decode and TPOT KPIs, with CARD, SWITCH, ENGINES and ABOUT in a bottom bar" width="300"></p>
<p align="center"><img src="assets/preview-mobile.png" alt="Berth harbor at phone width: the CARD tab with the ticket counter and collisions avoided, with CARD, SWITCH, SCHEDULE, ENGINES and ABOUT in a bottom bar" width="300"></p>

## Install

Expand Down
Binary file modified assets/preview-harbor.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified assets/preview-mobile.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified assets/preview-requests.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/preview-schedule.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
14 changes: 12 additions & 2 deletions docs/harbor.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,10 @@ fixture replays: a model that ran without a lease after a daemon restart, which

<p align="center"><img src="https://raw.githubusercontent.com/T-Crypt/berth/main/assets/preview-harbor.png" alt="Berth harbor: the CARD tab with ticket counter, request KPIs, the tide of card memory by holder, and the model timeline" width="900"></p>

The SCHEDULE tab: what holds the card now, the next seven days of bookings, and every booking in order.

<p align="center"><img src="https://raw.githubusercontent.com/T-Crypt/berth/main/assets/preview-schedule.png" alt="Berth harbor SCHEDULE tab: NOW with the holders, the waiters and the booking in force, 7 DAYS with one track per day of bookings, windows and the live holder, and the list of bookings" width="900"></p>

The Engines tab (advanced mode): the engine cards with their learned footprints as
EST. VRAM, the library (shelf, quant, size, the cached tier, the serving engine),
decode throughput, the token ledger, the per-model leaderboard, storage and residency.
Expand All @@ -17,7 +21,7 @@ decode throughput, the token ledger, the per-model leaderboard, storage and resi
On a phone, the harbor fits the screen. The tabs move to a bar at the bottom and the panels stack. This is the
CARD tab at phone width, from the same demo fixture.

<p align="center"><img src="https://raw.githubusercontent.com/T-Crypt/berth/main/assets/preview-mobile.png" alt="Berth harbor at phone width: the CARD tab with the ticket counter, collisions avoided, the collision tiles and the decode and TPOT KPIs, with CARD, SWITCH, ENGINES and ABOUT in a bottom bar" width="300"></p>
<p align="center"><img src="https://raw.githubusercontent.com/T-Crypt/berth/main/assets/preview-mobile.png" alt="Berth harbor at phone width: the CARD tab with the ticket counter and collisions avoided, with CARD, SWITCH, SCHEDULE, ENGINES and ABOUT in a bottom bar" width="300"></p>

### The harbor on your iPhone's Home Screen

Expand Down Expand Up @@ -132,7 +136,7 @@ for a phone.
lists the last 10 events and quits. `berth service install --notify` starts it at logon.

## The harbor's views
Everything the node collects shows in one of four tabs, and every panel answers a
Everything the node collects shows in one of five tabs, and every panel answers a
question an operator actually asks.

**The CARD tab.**
Expand Down Expand Up @@ -195,6 +199,12 @@ reads the key and never creates it. Without a key, the tab says so and offers no
`berth gateway --harbor URL` redirects the gateway's old `/gui/` index and `/` to `URL/#switch`, so a bookmark of the
engine list lands on this tab; its per-engine wake pages keep answering.

**The SCHEDULE tab** answers "who has the card now, and who has it next?" NOW lists what holds each card, the
waiters in queue order, the booking in force and the next one. 7 DAYS draws one 24-hour track per day with every
booking to the minute (run, priority or down), each engine's window and the live holder. BOOKINGS lists every
booking by start, on the node's clock. A paired device books by clicking an empty hour, and moves or cancels a
booking by clicking it or its EDIT button. [Book the card](leasing.md#book-the-card) explains the bookings themselves.

**The ENGINES tab.**
- **The engine cards** answer "is this engine up and serving?" with the state the
engine reports, its loaded models, decode and prefill rates, and its learned
Expand Down
9 changes: 9 additions & 0 deletions docs/roadmap.md
Original file line number Diff line number Diff line change
Expand Up @@ -149,6 +149,15 @@ v0.6.0 was tagged first as `v0.6.0-rc.1`.
turn it was in, and a drain no longer stops an engine that is still resuming
([#275](https://github.com/T-Crypt/berth/issues/275)).

## Shipped: v0.6.1, cleaner handoffs (2026-11-15)

- **No request into a draining engine.** The gateway holds a request while its engine's lease drains, parks or
releases, instead of sending it to an engine that is stopping.
- **A minimum turn needs a request.** An engine woken by a health probe or a warm-up no longer keeps the card for
its full `--min-turn` while a real request waits.
- **Busy or unknown.** An engine that reports no in-flight figure reads as unknown, not idle, so a juggle does not
hand its card over mid-request.

## Next: v0.6.x

- **A warmth ladder.** An engine steps down from live to parked to stopped by idle time and the next booking, and
Expand Down
6 changes: 4 additions & 2 deletions internal/gateway/schedule_test.go
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,9 @@ func decode[T any](t *testing.T, resp *http.Response) T {
// a clash is a 409 naming the booking it hits.
func TestScheduleRoutes(t *testing.T) {
srv, _ := scheduleGateway(t)
resp := call(t, "POST", srv.URL+"/v1/berth/schedule", `{"who":"pi-pocket","engine":"pocket","start":"23:00","for":"5h","priority":"batch"}`)
// Absolute starts: between 23:00 and 23:30, "23:00" is tomorrow and "23:30" today, so they never clash.
day := time.Now().AddDate(0, 0, 1).Format("2006-01-02")
resp := call(t, "POST", srv.URL+"/v1/berth/schedule", `{"who":"pi-pocket","engine":"pocket","start":"`+day+` 23:00","for":"5h","priority":"batch"}`)
if resp.StatusCode != http.StatusCreated {
t.Fatalf("book = %d %s", resp.StatusCode, readAll(resp))
}
Expand All @@ -58,7 +60,7 @@ func TestScheduleRoutes(t *testing.T) {
t.Fatalf("booked = %+v", made)
}

resp = call(t, "POST", srv.URL+"/v1/berth/schedule", `{"who":"train","engine":"sft","start":"23:30","for":"1h"}`)
resp = call(t, "POST", srv.URL+"/v1/berth/schedule", `{"who":"train","engine":"sft","start":"`+day+` 23:30","for":"1h"}`)
if body := readAll(resp); resp.StatusCode != http.StatusConflict || !strings.Contains(body, "clashes with b1") {
t.Fatalf("clash = %d %s", resp.StatusCode, body)
}
Expand Down
4 changes: 4 additions & 0 deletions internal/harbor/web/harbor.css
Original file line number Diff line number Diff line change
Expand Up @@ -1949,6 +1949,10 @@ dialog.sheet::backdrop { background: var(--scrim); backdrop-filter: blur(3px); }
.about-dl { grid-template-columns: 1fr; }
.about-hero, .about-sec { padding: var(--s4); }
}
/* five tabs share the bottom bar: under 340px SCHEDULE is wider than its fifth */
@media (max-width: 339px) {
.tab { letter-spacing: 0; padding-inline: 0; }
}

/* ---------- motion preferences and other media ---------- */
@media (prefers-reduced-motion: reduce) {
Expand Down
Loading