mirror of
https://github.com/mastra-ai/mastra.git
synced 2026-11-17 08:44:46 +00:00
## 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
|
|
|---|---|---|
| .. | ||
| commands | ||
| skills | ||
| settings.json | ||