You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
feat: /status, /pause and /doctor from Telegram #32
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):
/status [NAME]: the same facts as pullgate status (mode, applied, tip, open question, paused and why). Read-only.
/pause NAME [reason]: pauses the instance. The pause file records that it came from Telegram, and when.
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).
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.
The listener writes only request files; root does the work: TestListenerCannotPauseByOtherFiles (a bad pause file, a paused file and a state.json in the check directory pause nothing and are removed). The pause file is made with a hard link, so an existing pause is never replaced.
/help lists them: TestHelp.
THREAT-MODEL.md T18b: what a stolen bot token or a compromised listener can do with them (see a status, pause an instance) and why that is acceptable.
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.
Activity
groupsky commentedon Nov 19, 2026
Done in #51 (squash commit 9fa707e), except
/doctor./status,/pauseand/doctorwork as above./statusand/pauseare done:TestStatusRequest,TestPauseRequest,TestPauseRequestKeepsAnOtherPause(internal/gate/request_test.go);TestStatusAndPauseCommands,TestStatusAndPauseNotForOthers(internal/listener/listener_test.go, fake Telegram server; another user, another chat and an edited message get no reply and write no request)./doctorneedspullgate doctor(feat: pullgate doctor, read-back of modes, and no silent "asked" when a question was not delivered #28). feat: /doctor from Telegram #50 takes it, and feat: pullgate doctor, read-back of modes, and no silent "asked" when a question was not delivered #28 blocks it. This box stays open for that reason.TestListenerCannotPauseByOtherFiles(a badpausefile, apausedfile and astate.jsonin the check directory pause nothing and are removed). The pause file is made with a hard link, so an existing pause is never replaced./helplists them:TestHelp.Rate limits: the listener takes the same command for the same instance once a minute; root answers
/statusand replies to/pauseat most once a minute (the pause itself is never limited).pullgate-check@NAME.pathnow also starts the run for these requests.