Skip to content

docs(handoff): update the CLI docs consolidation handoff (r3) - #271

Open
ZacxDev wants to merge 1 commit into
mainfrom
docs/handoff-consolidation-r3
Open

docs(handoff): update the CLI docs consolidation handoff (r3)#271
ZacxDev wants to merge 1 commit into
mainfrom
docs/handoff-consolidation-r3

Conversation

@ZacxDev

@ZacxDev ZacxDev commented Aug 7, 2026

Copy link
Copy Markdown
Contributor

Updates claudedocs/handoff-cli-docs-consolidation.md in place (same topic — overwrites rather than forking a fourth doc).

Shipped since r2: #264 fixed the login --help NUL byte at source, closing issue #253; docs #48 re-captured the help snapshot at 9cfe468 so the published reference matches.

Two open investigations closed with measurements, not predictions:

One narrowed. #42 fixed the reference page's frontmatter to be audience-neutral, but the body still opens "the canonical tool for authoring Civitai Apps" (apps/reference/cli.md:23-24). So the IA finding shrinks to a two-sentence reword, and the llms-channel concern that used to ride along with it is gone.

One opened, measured by driving the guard's own exported helpers:

OLD snapshot (12 CLI commits stale) -> tag v0.1.90 | ahead 13 | verdict: ok
NEW snapshot                        -> tag v0.1.90 | ahead 25 | verdict: ok

check-appblocks-cli-snapshot.mjs classifies on release tag alone, so it could not have flagged docs #48 and cannot flag any between-release drift — most drift, on a repo where main moves daily and tags are rare. The obvious sha-comparison fix is ruled out in the doc (8 of those 12 commits touched no help text → a permanently-red daily gate).

Also corrects the Long/Annotations migration step, which r2 under-stated: Long renders in --help and README cells run to 2,263 chars, so it needs a split decision and a one-group pilot rather than a straight move.

Docs-only — no code paths touched.

🤖 Generated with Claude Code

Records #264 (the login --help NUL fix, closing issue #253) and docs #48 (the
help-snapshot re-capture at 9cfe468), and closes two open investigations with
measurements rather than predictions: llms-full.txt now carries the CLI
reference (15 'civitai generate' mentions, 0 before docs #45), and the drift
cron went green.

Narrows the IA finding — #42 fixed the reference page's frontmatter, but the
BODY still opens 'the canonical tool for authoring Civitai Apps', so a
two-sentence reword is now the only remaining defect there.

Opens one, measured by driving the guard's own helpers: the snapshot-freshness
check classifies on release tag alone and verdicts ok at both 13 and 25 commits
stale, so it cannot detect between-release drift at all.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
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