@nuasite/cli 0.50.1 → 0.52.0

package/README.md

@@ -3,7 +3,7 @@
 `@nuasite/cli` is the cli tool that powers [Astro](https://astro.build/) projects updated by
 [Nua Site](https://www.nuasite.com). It wraps `astro build`, `astro dev`, and
 `astro preview` with the Nua defaults and adds project-level commands
-(`init`, `clean`, `migrate`).
+(`check`, `init`, `clean`, `migrate`).
 
 ## Install
 
@@ -58,6 +58,41 @@ Specifically it:
 After running, follow the printed next-steps: `bun install`, review the
 config, and run `nua dev`.
 
+### `nua check`
+
+Validates the content collections without building the site:
+
+```bash
+nua check           # exit 1 on errors
+nua check --json    # machine-readable report
+nua check --strict  # warnings fail too
+```
+
+Run it anywhere in the project: with no `astro.config.*` in the current directory
+it checks every `packages/*` that has one, so a monorepo root works too — which is
+where `bun run build` typically builds something else entirely.
+
+It reads `src/content.config.ts`, walks every collection's entries and reports
+frontmatter that does not parse, values that do not match a declared field type
+(`order: ""` where the schema wants a number), missing required fields, and
+`reference()` values pointing at no entry.
+
+Use it instead of a full build when you only need to know whether the content is
+still valid: `astro build` validates the same things but costs the whole render
+and stops at the first bad entry, while this reports every problem in one pass —
+under a second on a 1500-entry site. A dangling reference is a warning, because
+it builds green and then renders nothing.
+
+`check` is new in 0.51.0. Most projects do not depend on `@nuasite/cli` directly
+— it arrives through `@nuasite/nua`, which pins it exactly — so a project on an
+older `@nuasite/nua` has an older `nua` and answers `Unknown command: check`
+until it bumps. To run it regardless of what the project pins, and from a plain
+shell where `node_modules/.bin` is not on `PATH`:
+
+```bash
+bunx @nuasite/cli@latest check
+```
+
 ### `nua clean`
 
 Ejects your project from the Nua toolchain back to a standard Astro setup: