feat/phase1 markdown powershell - #1
Conversation
kyle-sexton
commented
Jun 22, 2026
- chore: scaffold ci-workflows repo
- feat: add reusable markdown and powershell workflows with dogfood CI
Vendor the base hygiene configs (.editorconfig, .gitattributes, .gitignore) from the standards repo, add a weekly github-actions Dependabot config, and document the reuse contract in the README. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Add two SHA-pinnable reusable workflows consumed via uses:@sha: - markdown.yml runs markdownlint-cli2 (inputs: globs, config, version, node-version), installing the pinned version via npx. - powershell.yml runs PSScriptAnalyzer via the migrated runner script scripts/Invoke-Pssa.ps1 (inputs: paths, settings, exclude, analyzer-version). The runner lives here as execution; it self-checks-out via job.workflow_repository/job.workflow_sha (PAT-free) since a reusable workflow only receives the caller's checkout. ci.yml dogfoods both lanes against this repo's vendored config copies and aggregates them behind a local ci-status gateway job. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
An empty paths/exclude input split-and-filtered to $null, which the runner's non-null parameter contract rejects (Cannot bind argument to 'Patterns'). Wrap both in @() so the empty case stays an empty array. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 13f0bc6c6c
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
| repository: ${{ job.workflow_repository }} | ||
| ref: ${{ job.workflow_sha }} |
There was a problem hiding this comment.
Checkout the reusable workflow repository
In cross-repo consumers of this reusable workflow, these expressions are empty because the documented contexts expose github.workflow_sha/job.workflow_ref, not job.workflow_repository or job.workflow_sha (GitHub docs); GitHub also evaluates missing properties to an empty string. That means the second checkout does not fetch the ci-workflows commit that contains scripts/Invoke-Pssa.ps1 (it falls back to the triggering repo/ref or otherwise has blank inputs), so the later Analyze step cannot run the runner script unless the caller happened to copy it.
Useful? React with 👍 / 👎.
| VERSION: ${{ inputs.version }} | ||
| GLOBS: ${{ inputs.globs }} | ||
| # $GLOBS is intentionally unquoted so multiple glob arguments word-split. | ||
| run: npx --yes "markdownlint-cli2@$VERSION" --config "$CONFIG" $GLOBS |
There was a problem hiding this comment.
Prevent Bash from pre-expanding markdown globs
When a caller uses the default **/*.md in a repo with a match like docs/guide.md, this unquoted expansion is performed by the GitHub runner's Bash before markdownlint-cli2 sees it; with Bash globstar off by default, the shell passes only its one-directory matches and omits root/deeper files such as README.md/a/b/file.md. markdownlint-cli2's own usage notes recommend quoting glob arguments because shells expand globs differently, so the advertised default no longer lints all Markdown in common layouts.
Useful? React with 👍 / 👎.