Skip to content

The first screen of a new deployment names the mistake - #30

Merged
thankywal merged 1 commit into
mainfrom
the-first-screen-names-the-mistake
Sep 3, 2026
Merged

thankywal merged 1 commit into
mainfrom
the-first-screen-names-the-mistake

Conversation

@thankywal

Copy link
Copy Markdown
Owner

Found by booting the Worker against an empty database with a token that was not a token — the state a judge is in ten minutes after pressing Deploy. The first page of their deployment said:

Not ready yet.
Setup could not finish: Telegram getMe failed

An API method name, returned as a 500, to somebody who has just pasted one of two tokens into a box and has no way to tell which one was wrong. Pasting the business bot's token instead of the console bot's is the likeliest mistake there is, and this screen could not tell them.

Telegram says exactly what is wrong with a token — Unauthorized: invalid token specified — and that sentence was carried as far as the error's details and printed nowhere.

A rejected token is a setting to correct, not a crash, so it goes back the way every other bad setting on this page already does: named in missing, with what Telegram said, with what to do about it, and 503 rather than 500. It now reads:

Not ready yet.
Telegram did not accept the console bot token: Unauthorized: invalid token specified. It is the whole token @Botfather gave you for your console bot, digits and colon included, and not the bot your customers write to. Correct ADMIN_BOT_TOKEN in this Worker's settings and reload this page.
Missing: ADMIN_BOT_TOKEN

Nothing is written before the token is accepted — already true, now checked: a half-configured deployment looks set up and answers nobody.

Also verified on the same boot: an empty deployment answers /health with awaiting_setup and nothing missing, and Vectorize being unreachable during setup is a warning rather than a failure.

5 tests, RED-checked by putting the crash back. 785 pass.

🤖 Generated with Claude Code

https://claude.ai/code/session_01FMFyy3oXb9u2AxoYQKRXHu

Found by booting the Worker against an empty database with a token that
was not a token, which is the state a judge is in ten minutes after
pressing Deploy. The first page of their deployment said:

    Not ready yet.
    Setup could not finish: Telegram getMe failed

An API method name, returned as a 500, to somebody who has just pasted
one of two tokens into a box and has no way to tell which one was wrong.
Pasting the business bot's token instead of the console bot's is the
likeliest mistake there is, and this screen could not tell them.

Telegram says exactly what is wrong with a token — "Unauthorized:
invalid token specified" — and that sentence was carried as far as the
error's details and printed nowhere.

A rejected token is a setting to correct, not a crash, so it goes back
the way every other bad setting on this page already does: named in
missing, with what Telegram said, with what to do about it, and 503
rather than 500. Nothing is written before the token is accepted, which
was already true and is now checked: a half configured deployment looks
set up and answers nobody.

Also verified on the same boot: an empty deployment answers /health with
"awaiting_setup" and nothing missing, and Vectorize being unreachable
during setup is a warning rather than a failure.

5 tests, RED-checked by putting the crash back. 785 pass.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FMFyy3oXb9u2AxoYQKRXHu
@thankywal
thankywal merged commit 636bb4b into main Sep 3, 2026
1 check passed
@thankywal
thankywal deleted the the-first-screen-names-the-mistake branch September 3, 2026 09:32
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