tooling: verify generated CLI manpage drift #362

New issue

Closed

opened 2026-05-11 21:02:06 +00:00 by barrettruth · 0 comments

barrettruth commented

2026-05-11 21:02:06 +00:00

Owner

Parent: #355

Problem

cli/man/delta.1 is generated from cli/man/delta.1.md, but the version check only verifies the generated manpage version line. Body drift could pass CI.

Solution

Make version:check detect generated manpage drift:

render the manpage to a temporary file during the check
compare it with the tracked generated manpage
keep the existing version-sync checks intact

Acceptance criteria

A stale generated cli/man/delta.1 fails pnpm version:check.
Current tracked manpage passes after regeneration.
Tests cover the drift-check helper where practical.

Parent: #355 ## Problem `cli/man/delta.1` is generated from `cli/man/delta.1.md`, but the version check only verifies the generated manpage version line. Body drift could pass CI. ## Solution Make `version:check` detect generated manpage drift: - render the manpage to a temporary file during the check - compare it with the tracked generated manpage - keep the existing version-sync checks intact ## Acceptance criteria - A stale generated `cli/man/delta.1` fails `pnpm version:check`. - Current tracked manpage passes after regeneration. - Tests cover the drift-check helper where practical.

barrettruth added the

track:infra

type:cleanup

labels

2026-05-11 21:02:06 +00:00

barrettruth referenced this issue

2026-05-11 21:02:45 +00:00

tracker: foundation hardening before Google sync #355

barrettruth referenced this issue from a pull request that will close it,

2026-05-11 21:18:12 +00:00

tooling: verify generated CLI manpage drift #378

barrettruth closed this issue