Skip to content

skills(uptime-alerts): document the deploy-runner checks - #171

Open
DJRHails wants to merge 2 commits into
mainfrom
skills-uptime-alerts-deploy-runners
Open

DJRHails wants to merge 2 commits into
mainfrom
skills-uptime-alerts-deploy-runners

Conversation

@DJRHails

@DJRHails DJRHails commented Sep 14, 2026

Copy link
Copy Markdown
Owner

Documents the deploy-runner checks the uptime watcher gains in touchstone#4581: the check names, the two failure shapes each reads, the path override, and the runbook the alert carries. Skill content only; merge after the watcher change lands.

via gantry

The watcher now covers the static deploy runners beside the CI pools;
describe the check names, the failure shapes each reads, the path
override, and the runbook the alert carries.

@DJRHails DJRHails left a comment

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Automated review — findings posted inline. This file is glassine-encrypted, so the diff GitHub shows is ciphertext; the comments below anchor on the data line and describe the plaintext section they refer to without quoting it. P2 fixed in a follow-up commit; P3s fixed alongside since each is a one-line edit in the same file.

via gantry

Comment thread modules/agents/skills/uptime-alerts/SKILL.md Outdated
Comment thread modules/agents/skills/uptime-alerts/SKILL.md Outdated
Comment thread modules/agents/skills/uptime-alerts/SKILL.md Outdated
Comment thread modules/agents/skills/uptime-alerts/SKILL.md Outdated
- F1 (P2): list the deployment-runner checkout (or the compose path
  override) among the runner-pool-host prerequisites; without it the
  new conf check alerts on every run.
- F2 (P3): the layout intro now counts four kinds of check.
- F3 (P3): name the never-registered example as the since-retired
  service it was.
- F4 (P3): the testing paragraph names the deploy-runner scenarios the
  regression test now covers.
@DJRHails

Copy link
Copy Markdown
Owner Author

Review Summary

Docs-only change to a glassine-encrypted skill file; the plaintext was reviewed from the checkout and its claims checked against the watcher change it documents (touchstone#4581, still open) and the live runner registrations. Check names, the path override, the failure shapes, the sweep-ending behaviour on an API failure, the runbook, and the 16-offline count all match the script and the current API state.

# Severity Finding Resolution
F1 P2 Prerequisites paragraph omits the second checkout (or its path override) the new check parses; a host set up as written trips the companion conf check every run Fixed in 335be53
F2 P3 Layout intro still counts three kinds of check; there are now four Fixed in 335be53
F3 P3 Never-registered example attributed to a runner service retired on 2026-09-08 as if current Fixed in 335be53
F4 P3 Testing paragraph does not mention the deploy-runner scenarios the regression test now covers Fixed in 335be53

Envelope: sops metadata intact, 7 age recipients matching the repo-wide rule in .sops.yaml, MAC and timestamp updated; staged blob re-encrypted through the glassine clean filter.

Verified: prek run on the changed file (gitleaks, trufflehog, check-crypt-patterns, glassine-check, and the shell test suites — all passed); glassine check; the touchstone watcher diff and its regression test read line by line; live runner status for all 17 declared runners via the GitHub API. The repo has no CI, so hooks are the only gate.

Ordering note: the PR body already says to merge after the watcher change lands; touchstone#4581 is still open, so hold this until it merges or the skill describes checks that do not exist yet.

Fix commit: 335be53
Reviewed head: 335be53

Verdict: approve

via gantry

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