Skip to content

fix: the site workflow finds the site verb under grouped help - #720

Merged
REPPL merged 2 commits into
mainfrom
fix/site-probe-agent-help
Sep 26, 2026
Merged

REPPL merged 2 commits into
mainfrom
fix/site-probe-agent-help

Conversation

@REPPL

@REPPL REPPL commented Sep 26, 2026

Copy link
Copy Markdown
Collaborator

With this change, the site workflow finds the site verb again, so abcdev.app deploys: the preview on every push to main, and the production render for a release.

  • Since the root help was grouped, abcd --help lists only the human-facing verbs, and site appears under abcd --help --agent. The workflow probed the plain listing, so every site run since then refused with "this binary has no site verb": every preview on main, and v0.11.0's production render after it was published.
  • Each of the four probes now reads the agent listing first and falls back to the plain one. A release from before the grouping (v0.6.2 to v0.10.0) refuses --agent and still lists site in its plain help, so an emergency redeploy of an older tag keeps working; a binary with no site verb still refuses in one line.
  • TestSiteWorkflowProbeFindsTheSiteVerb runs each probing step's own script out of the committed workflow against the real command tree's help, a flat pre-grouping listing, a pre-site binary and one with site removed.

After this merges, the v0.11.0 site is redeployed from main through the workflow's documented emergency path.

Review: Fable 5.1 (review-siteprobe).

Resolves: iss-2609260709386741
Assisted-by: Claude:claude-opus-5-5

Since the grouped root help (#711) `abcd --help` names only the person's
verbs, and `site` is listed under `abcd --help --agent` alone. site.yml's
four probing steps grepped the plain listing, so every site run on a
binary built after a3cdf26 refused with "this binary has no site verb":
the preview on every push to main, and the production render the release
chain calls after publishing v0.11.0.

Each probe now reads `--help --agent` and falls back to `--help` when the
flag is refused, which is how every tag before v0.11.0 answers it (exit 2,
nothing on stdout) while listing all its verbs in the plain help. A binary
from before the site slice passes neither and still refuses in one line.
The listing is captured in a variable rather than piped, so neither the
fallback's non-zero exit nor grep's early exit meets pipefail. Checked
against binaries built from v0.6.1 (refused), v0.10.0 and v0.11.0 (found).

TestSiteWorkflowProbeFindsTheSiteVerb executes each probing step's own
run: script against a stand-in binary answering with the real command
tree's help, for four binaries: grouped with the verb, flat with the verb
and no --agent, neither, and grouped with the verb withdrawn. It captures
the defect in this commit too. No other workflow or script greps a help
listing for a verb, and the scaffold templates carry no such probe.

Refs: iss-2609260709386741
Assisted-by: Claude:claude-opus-5-5
Resolves: iss-2609260709386741
Assisted-by: Claude:claude-opus-5-5
@REPPL
REPPL enabled auto-merge September 26, 2026 07:38
@REPPL
REPPL added this pull request to the merge queue Sep 26, 2026
Merged via the queue into main with commit 89a664c Sep 26, 2026
12 checks passed
@REPPL
REPPL deleted the fix/site-probe-agent-help branch September 26, 2026 08:27
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