0
Fork 0
mirror of https://github.com/mastra-ai/mastra.git synced 2026-11-17 08:44:46 +00:00
mastra/.claude
mastra-platform[bot] 76770b323c
fix(docs): clear pnpm check warnings and run docs-audit checks through pnpm check (#29843)
## Summary

Follow-up to #29801 (unified `pnpm check` for docs).

**Clear the remaining `pnpm check` warnings** — `pnpm --filter
mastra-docs check` now reports 0 errors and 0 warnings across 1,005
files.
- `mastra/no-self-host-url`: links to `https://mastra.ai/...` pages are
now root-relative in the quickstart partials, `reference/auth/neon.mdx`,
`reference/manual-install.mdx`, and the generated `models/index.mdx`.
The generator (`packages/core/scripts/generate-model-docs.ts`) now emits
`/models/providers/<id>` so regeneration stays clean. Link labels are
unchanged, so copied prompts still show full URLs, and the llms.txt
plugin still turns root-relative links into absolute ones with
`siteUrl`.
- `mastra/frontmatter-packages-max`: `integrations/channels/github.mdx`
listed five packages. I removed `@mastra/libsql` because the page only
uses it as the example's storage adapter.

**docs-audit `run-checks.sh` now uses `pnpm check`** — the separate
oxfmt-mdx, remark, Vale, and `pnpm validate` calls are replaced by one
`pnpm check --format json <docs>` run. The script still prints the same
five summary lines that the skill and report template read
(`format-target`, `remark-target`, `vale-target`, `validate-target`,
`repo-wide-failures`). Findings are now matched to audited pages by file
path, which replaces the old grep/awk route matching. Error findings on
audited pages give `fail`. Warning findings on audited pages, or a
skipped Vale run, give `warn`. Errors in other files are listed under
`repo-wide-failures`. The script stays read-only and is still not run in
CI.

## Test plan
- [x] `pnpm check --no-vale --format json` → `passed`, 0 errors, 0
warnings, 1,005 files
- [x] `run-checks.sh` on clean pages → all `pass`, exit 0
- [x] Added a second H1, a fence with no language, and a formatting
error to an audited page → `format-target=fail`, `remark-target=fail`,
diagnostics printed, exit 1
- [x] Out-of-date `vercel.json` while auditing an unrelated page →
targets `pass`, `repo-wide-failures=validate`, exit 0
- [x] Vale binary missing → `vale-target=warn`, exit 0; a path outside
docs/ → exit 2

Co-authored-by: mastra-platform[bot] <mastra-platform[bot]@users.noreply.github.com>
Co-authored-by: mastra-platform[bot] <284800079+mastra-platform[bot]@users.noreply.github.com>
History 2026-11-09 17:53:33 -07:00
..
commands fix(mastracode): stop command shims shadowing goal skills (#19709) 2026-07-20 19:30:39 +01:00
skills fix(docs): clear pnpm check warnings and run docs-audit checks through pnpm check (#29843) 2026-11-09 17:53:33 -07:00
settings.json chore(claude): add ralph plugin (#11660) 2026-01-06 14:14:22 -05:00