Skip to content

Docs: restarting isn't automatic, and APP_VERSION must be bumped - #2

Merged
bnh2n9rxn5-lab merged 1 commit into
mainfrom
docs/restart-and-version-bump
Aug 22, 2026
Merged

bnh2n9rxn5-lab merged 1 commit into
mainfrom
docs/restart-and-version-bump

Conversation

@bnh2n9rxn5-lab

Copy link
Copy Markdown
Contributor

Two ways to lose an afternoon that the docs didn't warn about.

KeepAlive restarts on crash, not on edit. server.py changes do nothing until the agent is kickstarted, and the failure mode is nasty: the source on disk shows a fix the running process has never loaded. The README now gives the restart command and says to compare process start time against file mtime when a symptom contradicts the code.

APP_VERSION had no comment at all. The client self-reload fires on a stamp mismatch, so editing the served page without bumping it leaves phones on the cached old UI indefinitely. The README also claimed the app "auto-reloads itself when the server is updated", which overstates it — it reloads when you bump the constant.

Docs and one comment only; no behaviour change. python3 -m unittest discover -s tests passes.

🤖 Generated with Claude Code

Two ways to lose an afternoon that the docs didn't warn about.

KeepAlive restarts the agent on crash, not on edit, so `server.py` changes do
nothing until the agent is kickstarted. The failure mode is nasty because the
source on disk shows a fix the running process has never loaded — so the README
now gives the restart command and says to compare process start time against
file mtime when a symptom contradicts the code.

APP_VERSION had no comment at all. The client self-reload fires on a stamp
mismatch, so editing the served page without bumping it leaves phones on the
cached old UI indefinitely. The README also claimed the app "auto-reloads
itself when the server is updated", which overstates it — it reloads when you
bump the constant.

Docs and one comment only; no behaviour change. Tests pass.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@bnh2n9rxn5-lab
bnh2n9rxn5-lab merged commit 5372673 into main Aug 22, 2026
6 checks passed
@bnh2n9rxn5-lab
bnh2n9rxn5-lab deleted the docs/restart-and-version-bump branch August 22, 2026 12:13
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