Skip to content

fix: re-fix markdownlint and cspell regressions on main - #464

Merged
mrbobbytables merged 1 commit into
mainfrom
fix/ci-lint-checks
Sep 22, 2026
Merged

mrbobbytables merged 1 commit into
mainfrom
fix/ci-lint-checks

Conversation

@mrbobbytables

Copy link
Copy Markdown
Member

What

Fixes the specific lint regressions reported in #392: 12 markdownlint
errors across 4 files and 1 cspell error, all re-introduced by
individually-green PRs (#198, #293, #384, #385) shortly after #315 and
#292 had fixed them.

  • .cspell.yml: add lightboxes (used in CONTRIBUTING.md), re-broken
    after fix: add missing cspell words and drop phantom analyses path #292's cspell-word merge.
  • LAUNCH.md, adr/README.md: fix MD060 compact-table pipe spacing.
  • README.md: fix MD009 trailing whitespace.
  • adr/stakeholder-outreach-draft-for-0001.md: add a language hint to
    the fenced draft-email block (MD040).

Verified on a clean checkout: npm run check:spelling and
npm run check:markdown both now exit 0. npm run test:unit and
npm run build:production also pass.

What this PR does not do

#392's root-cause recommendation is to add a CI job that runs
check:spelling/check:markdown (and optionally check:format) on
every PR, so this kind of regression can't merge silently again. I
attempted that (a new lint job in .github/workflows/ci.yml), but
the token available to me lacks the OAuth workflow scope, and GitHub
rejects any push that touches .github/workflows/* without it:

! [remote rejected] (refusing to allow an OAuth App to create or
update workflow `.github/workflows/ci.yml` without `workflow` scope)

That part of the fix needs a maintainer (or a token with workflow
scope) to land — the change is straightforward: a lint job that runs
npm run check:spelling and npm run check:markdown after npm ci.
I'm leaving check:format out of that job even for a maintainer to
add later, since it currently fails on ~60 unrelated files across
main and fixing that is a separate, much larger change.

Fixes #392 (the reported regressions; the CI-wiring recommendation
remains open pending a workflow-scoped push).

— hive: backend=copilot model=claude-sonnet-5

🐝 Hive Agent: contributor | SHA: 2545644

Individually-green PRs (#198, #293, #384, #385 after #292's cspell fix
and #315's markdown fix) re-broke check:markdown and check:spelling on
main within hours, because no CI workflow runs those checks (#392).

- .cspell.yml: add 'lightboxes' (used in CONTRIBUTING.md), re-broken
  after #292's cspell-word merge.
- LAUNCH.md, adr/README.md: fix MD060 compact-table pipe spacing.
- README.md: fix MD009 trailing whitespace.
- adr/stakeholder-outreach-draft-for-0001.md: add a language hint to
  the fenced draft-email block (MD040).

Verified with a clean checkout: npm run check:spelling and
npm run check:markdown both now exit 0.

This does not add the CI job requested in #392 to run these checks on
every PR: doing so requires pushing a .github/workflows/ci.yml change,
which this environment's token cannot do (it lacks the OAuth 'workflow'
scope, so GitHub rejects the push server-side). See the PR description
for details.

Signed-off-by: mrbobbytables <mrbobbytables@users.noreply.github.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

1 participant