Skip to content

feat: /status, /pause and /doctor from Telegram #32

Closed

Description

@groupsky

Why

Today the owner needs a root shell on the host to see the state of an instance, to pause it, or to check its setup. On a phone that means SSH, which is the step pullgate wants to remove.

Proposal

New commands from the owner, in the owner's chat only (as /check today; others get no reply):

As with /check, the listener only writes a small request file with no data from the message; root reads it and acts. Rate-limit each command as /check is.

/resume and /ask-again are #33, because they can undo a safety stop.

Done when

  • /status, /pause and /doctor work as above; tests with the fake Telegram server, including messages from another user or chat (no reply, no request).
  • The listener writes only request files; root does the work (a test that the listener user cannot pause by writing state).
  • /help (feat: /help in Telegram, and a hint to it for any message the bot does not handle #26) lists them.
  • THREAT-MODEL.md: what a stolen bot token or a compromised listener can do with these commands (see a status, pause an instance) and why that is acceptable.

Activity

  1. groupsky commented on Nov 19, 2026

    @groupsky
    ContributorAuthor

    Done in #51 (squash commit 9fa707e), except /doctor.

    Rate limits: the listener takes the same command for the same instance once a minute; root answers /status and replies to /pause at most once a minute (the pause itself is never limited). pullgate-check@NAME.path now also starts the run for these requests.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions