Skip to content

fix(ci): quarterly-doc-audit hardening — lfs filter disable + drop unmatched mdx pathspec - #214

Merged
acamarata merged 1 commit into
mainfrom
fix/quarterly-doc-audit-mdx-lfs
Aug 16, 2026
Merged

acamarata merged 1 commit into
mainfrom
fix/quarterly-doc-audit-mdx-lfs

Conversation

@acamarata

Copy link
Copy Markdown
Collaborator

Summary

Part of a consistency fix across the 5 repos sharing this workflow (cli/admin/web/plugins/ntask), following the tarball-extraction fix (#213) and the plugins mdx-pathspec bug (nself-org/plugins#31):

  • Drop **/*.mdx from add-paths: this repo has zero .mdx files. git add's multi-pathspec matching is atomic — an unmatched pathspec element aborts the entire git add, which broke plugins' Open auto-fix PR step whenever the audit actually produced .md changes to stage. Currently latent here (cli's last audit run was clean), but the bug is real.
  • Disable git-lfs filters right after Checkout (defensive): same shared-workflow hardening as admin (fix(ci): doc audit — discard non-doc changes before opening the PR admin#70) and web, where .gitattributes-declared filter=lfs binaries that were never actually migrated to real LFS pointers show as perpetually "modified" to git, breaking peter-evans/create-pull-request's internal stash/checkout dance. cli has one candidate file (vendor/.../chroma.jpg) that doesn't presently trip this, but this keeps the workflow consistent across all 5 repos.

Test plan

  • Confirmed via full-tree grep this repo has 0 .mdx files.
  • git lfs uninstall --local is a documented, safe no-op when nothing is affected.
  • Watch Quarterly doc audit stays green on main HEAD after merge.

… + drop unmatched mdx pathspec

Consistent with the same investigation/fix applied to admin/web/plugins:

1. Disable git-lfs filters right after Checkout (defensive; cli currently
   has one candidate LFS-filtered file — vendor/.../chroma.jpg — that
   doesn't presently trip this, but keeps this repo consistent with the
   others in case that changes).

2. Drop the unmatched **/*.mdx pathspec from add-paths — this repo has
   zero .mdx files (confirmed via a full-tree grep), so any run where the
   audit actually finds+fixes .md issues would hit the same
   'pathspec did not match any files' fatal error that broke plugins'
   Open-auto-fix-PR step (see plugins #31). Currently latent here since
   cli's last audit run was clean (no .md changes to stage), but the bug
   is real and would trip the moment findings appear.
@acamarata
acamarata merged commit c8c1efe into main Aug 16, 2026
27 checks passed
@acamarata
acamarata deleted the fix/quarterly-doc-audit-mdx-lfs branch August 16, 2026 16:23
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