Skip to content

update restarts a stale hub; doctor says where to update it; clearer desktop notes docs - #105

Merged
gaius-codius merged 2 commits into
mainfrom
hub-restart-stale
Oct 25, 2026
Merged

gaius-codius merged 2 commits into
mainfrom
hub-restart-stale

Conversation

@gaius-codius

@gaius-codius gaius-codius commented Oct 25, 2026 •

Copy link
Copy Markdown
Owner

The hub on this machine ran 0.6.0 while its checkout was on 0.8.0: the checkout had been pulled without ostrakon update, so the service never restarted. doctor said "run ostrakon update where the hub runs", but update found nothing to pull and stopped before the hub.

What changed

  • update.sh (ostrakon update) restarts the hub on this machine after new code, as before, and now also when the hub's /healthz reports a different release from the checkout's. It reads the port from the service's HUB_PORT (default 8790).
  • ostrakon doctor, when the hub runs a different release: if that's the hub on this machine (the service is active and its /healthz reports the same version), it says ostrakon update restarts it. Otherwise it names the hub's host: "on , run ostrakon update".
  • CHANGELOG (Unreleased) and the README's update paragraph.
  • README, Notes from the desktop, rewritten to skim: the commands first, the details as a list, subheadings for the quick-note key and other apps. The key binding is described for any desktop first, with Hyprland and Omarchy as examples.
  • CONTRIBUTING, Writing the docs: how the user-facing docs are written (lead with what to do, no walls of text, plain words, no assumed setup, mark what's untested).

Checked

  • shellcheck on both scripts.
  • doctor with the checkout's version set to 0.8.9: "the hub on this machine runs 0.8.0, this checkout 0.8.9; ostrakon update restarts it". The host is taken from https://box.tail1.ts.net:8443, http://10.0.0.5:8790/ and https://hub.example.com/x.
  • update.sh in a scratch clone of main: with a local commit setting the version to 0.8.9, it says "already up to date", "the hub runs 0.8.0, this checkout 0.8.9", "hub restarted", and the service's start time moved. With the versions matching, it says "already up to date" and leaves the hub alone.

@gaius-codius gaius-codius changed the title update restarts a hub left on an older release; doctor says where to update it update restarts a stale hub; doctor says where to update it; clearer desktop notes docs Oct 25, 2026
@gaius-codius
gaius-codius merged commit de0a1aa into main Oct 25, 2026
9 checks passed
@gaius-codius
gaius-codius deleted the hub-restart-stale branch October 25, 2026 04:21
@gaius-codius gaius-codius mentioned this pull request Oct 25, 2026
gaius-codius added a commit that referenced this pull request Oct 25, 2026
Release v0.8.1: the changelog's Unreleased section becomes 0.8.1, and
plugin.json's version is 0.8.1. It holds #105: `ostrakon update`
restarts a hub left on an older release, `doctor` says where to update
the hub, and clearer desktop-notes docs.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant