Skip to content

docs(dependency-audit): recommend quoting glob targets for portable scripts - #64

Merged
manzoorwanijk merged 2 commits into
mainfrom
docs/dependency-audit-glob-quoting
Jun 19, 2026
Merged

docs(dependency-audit): recommend quoting glob targets for portable scripts#64
manzoorwanijk merged 2 commits into
mainfrom
docs/dependency-audit-glob-quoting

Conversation

@manzoorwanijk

Copy link
Copy Markdown
Owner

What

Recommend quoting glob targets (e.g. "./packages/*") in the dependency-audit README and CLI reference, so the CLI — not the shell — does the expansion.

Why

Follow-up to the cross-platform glob expansion (#61). On a POSIX shell an unquoted ./packages/* is expanded by the shell before the CLI sees it; on Windows cmd.exe/PowerShell it isn't. Both produce the same audit result (verified byte-identical, including under --collapse-root-cause), but quoting makes a package.json script portable: the CLI's own expansion runs identically everywhere, and it sidesteps the no-match/nullglob edge cases of an unquoted glob.

This came out of review feedback on the Gutenberg consumer PR, where the script is now quoted to be Windows-safe.

Changes

  • README and docs/cli.md examples now quote the glob, with a short note on why.
  • Corrects no behavior — docs only. Patch changeset included (the README ships in the package).

Verification

Ran the real Gutenberg lint:published-deps with the quoted glob: it expanded the full ../../packages/* tree (127 targets) and audited cleanly — same result as the unquoted form, now portable.

… scripts

Quote `"./packages/*"` in the examples so a POSIX shell doesn't expand it before
the CLI does — the result is identical, but quoting keeps a package.json script
portable to Windows shells (which don't expand globs). Verified shell-expanded
and CLI-expanded runs produce byte-identical output, including under
--collapse-root-cause.
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Jun 19, 2026

Copy link
Copy Markdown

Deploying mawesome with  Cloudflare Pages  Cloudflare Pages

Latest commit: a0fd1a0
Status: ✅  Deploy successful!
Preview URL: https://f63640f4.mawesome.pages.dev
Branch Preview URL: https://docs-dependency-audit-glob-q.mawesome.pages.dev

View logs

astro <6.4.6 has a Host-header SSRF (GHSA-2pvr-wf23-7pc7); the docs site pulled
it transitively via @astrojs/starlight, failing `pnpm audit --audit-level=high`
on CI. Bump the direct dependency to the patched line (6.4.8 is held back by the
3-day minimumReleaseAge cooldown). The site app doesn't publish, so no changeset.
@manzoorwanijk
manzoorwanijk merged commit 655dd79 into main Jun 19, 2026
6 checks passed
@manzoorwanijk
manzoorwanijk deleted the docs/dependency-audit-glob-quoting branch June 19, 2026 11:35
@mawesome-bot mawesome-bot Bot mentioned this pull request Jun 19, 2026
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