regenerate ward-kdl guardfile doc once cli-guard ships the condition-language note (cli-guard#145) #97

New issue

Closed

opened 2026-06-16 00:46:14 +00:00 by coilysiren · 1 comment

coilysiren commented

2026-06-16 00:46:14 +00:00

Owner

Context

cli-guard#145 added a "Condition language" note to the generated guardfile reference doc, naming the until/fail-when dialect as JMESPath Community Edition. That change is in cli-guard renderProse.

ward's committed docs/ward-kdl.forgejo.guardfile.md is generated by the specverb-gen driver, which the Makefile pins to a released cli-guard (REF). So the note does not reach ward's committed copy until cli-guard releases the change and ward bumps the ref.

This change also added an author-facing comment naming the dialect directly in cmd/ward-kdl/ward-kdl.forgejo.guardfile.kdl, so the guardfile author surface already carries it.

Action

Once cli-guard releases (auto minor bump on the push of cli-guard#145):

Bump the cli-guard REF in Makefile to the release carrying cli-guard#145.
make build-ward-kdl (or the lock+build+doc target) to regenerate docs/ward-kdl.forgejo.guardfile.md.
Commit the regenerated doc - the "Condition language" section should appear after the ci-watch action stanza.

## Context cli-guard#145 added a "Condition language" note to the generated guardfile reference doc, naming the `until`/`fail-when` dialect as JMESPath Community Edition. That change is in cli-guard `renderProse`. ward's committed `docs/ward-kdl.forgejo.guardfile.md` is generated by the specverb-gen driver, which the Makefile pins to a **released** cli-guard (`REF`). So the note does not reach ward's committed copy until cli-guard releases the change and ward bumps the ref. This change also added an author-facing comment naming the dialect directly in `cmd/ward-kdl/ward-kdl.forgejo.guardfile.kdl`, so the guardfile author surface already carries it. ## Action Once cli-guard releases (auto minor bump on the push of cli-guard#145): 1. Bump the cli-guard `REF` in `Makefile` to the release carrying cli-guard#145. 2. `make build-ward-kdl` (or the lock+build+doc target) to regenerate `docs/ward-kdl.forgejo.guardfile.md`. 3. Commit the regenerated doc - the "Condition language" section should appear after the `ci-watch` action stanza.

coilysiren referenced this issue from a commit

2026-06-16 00:46:55 +00:00

docs(ward-kdl): name the until/fail-when dialect in the guardfile

coilysiren added the

label

2026-06-17 07:05:38 +00:00

coilysiren commented

2026-06-17 08:21:58 +00:00

Author

Owner

Backlog burndown 2026-06-17: closing low-priority (P3/P4) to bring the open count to a manageable level. Nothing lost — reopen if this resurfaces. Batch tag: burndown-2026-06.

Backlog burndown 2026-06-17: closing low-priority (P3/P4) to bring the open count to a manageable level. Nothing lost — reopen if this resurfaces. Batch tag: `burndown-2026-06`.

coilysiren

2026-06-17 08:21:58 +00:00