You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
CLI: prune stale output in fce generate (or document the rm -rf requirement) #247
fce generate only creates files — it never deletes a stale one. An error removed from the code leaves its page orphaned in the output directory. The repository's own CI must rm -rf the catalog before regenerating, and the workflow comment admits why (gendoc-docs.yml:60-62); but users following TheHtmlRenderer.en.md or CatalogVersioningCI.en.md to publish their own living catalogs will accumulate ghost pages for removed errors — precisely the drift the tool exists to prevent — with no mention of the workaround in the user docs.
Impact
The living-docs promise silently degrades for every external adopter of the documented CI publishing loop.
Direction
Preferred: a manifest-based prune (delete only files a previous generation wrote — safer than rm -rf for shared output directories) or a --clean flag on directory output.
At minimum: move the wipe-before-regenerate guidance from the workflow comment into TheHtmlRenderer and CatalogVersioningCI (EN+FR).
While in those pages: add the mandatory --service-name to TheHtmlRenderer.en.md's two copy-paste examples, which currently fail as written.
Acceptance criteria
Removing an error and regenerating leaves no orphaned page (or the docs state exactly what to wipe and why); the HTML-renderer examples run as pasted.
Context
Surfaced by the 2026-07-20 architecture, design & ecosystem audit (doc/handwritten/for-maintainers/audit/2026-07-20-firstclasserrors-architecture-and-design-audit.md, §12.4/§14-HV15; branch claude/firstclasserrors-audit-83gap7).
Activity
Reefact commentedon Jul 20, 2026
🔗 Opened from the 2026-07-20 ecosystem architecture & design audit (added to the repository in #255). Claude Code session that produced the audit and this issue: https://claude.ai/code/session_011RRd5dyXzphsaAwpDcDKP3
Generated by Claude Code