cc2503d9c7
docs/tools/swarmctl-cli.md is rendered by `swarmctl markdown-docs`, and nix/checks.nix's swarmctl-docs-fresh check diffs the committed copy against fresh binary output. Enabling prettier on markdown rewrote its list bullets and footer indentation, which no regeneration can settle: formatting it fails the freshness check, not formatting it fails treefmt. .prettierignore already carried hivectl-cli.md for exactly this reason; swarmctl's doc was added later and the entry was not. Restore the file to its generated bytes, list it alongside hivectl's, and state the invariant where the next CLI doc gets added.
25 lines
1,007 B
Text
25 lines
1,007 B
Text
# Generated by `<tool> markdown-docs` — do not format. The matching
|
|
# *-docs-fresh check in nix/checks.nix diffs each against fresh binary
|
|
# output, so any reformatting fails that check permanently: the
|
|
# generator, not the formatter, owns these files' layout. Every CLI
|
|
# reference doc belongs here — adding one and forgetting this line is
|
|
# what made swarmctl's fail.
|
|
docs/tools/hivectl-cli.md
|
|
docs/tools/swarmctl-cli.md
|
|
|
|
# Files with multi-line list-item continuations that prettier strips to col 0.
|
|
# prettier's `proseWrap: "preserve"` prevents prose reflow but not list-item
|
|
# indentation normalisation, so these files need manual re-wrap before
|
|
# adding them back to the formatter scope.
|
|
CLAUDE.md
|
|
docs/agent-lifecycle/approvals.md
|
|
docs/process/conventions.md
|
|
docs/networking/gateway.md
|
|
docs/integrations/matrix.md
|
|
docs/agent-lifecycle/persistence.md
|
|
docs/web-ui/terminal-rendering.md
|
|
docs/tools/forge.md
|
|
docs/tools/matrix.md
|
|
docs/turn-loop/README.md
|
|
docs/web-ui/agent.md
|
|
docs/web-ui/dashboard.md
|