From 31c726e3fa18cc79f4fa117f7a32cfe57d5ec4ae Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Miguel=20=C3=81ngel?= Date: Tue, 31 Mar 2026 02:23:03 +0200 Subject: [PATCH] docs(cli): document --json and --verbose lint flags Co-Authored-By: Claude Opus 4.6 (1M context) --- packages/cli/README.md | 6 +++++- packages/cli/src/templates/_shared/CLAUDE.md | 4 +++- 2 files changed, 8 insertions(+), 2 deletions(-) diff --git a/packages/cli/README.md b/packages/cli/README.md index c95e77ec2..24a2ff175 100644 --- a/packages/cli/README.md +++ b/packages/cli/README.md @@ -51,9 +51,13 @@ npx hyperframes render ./my-composition.html -o output.mp4 Validate your Hyperframes HTML: ```bash -npx hyperframes lint ./my-composition.html +npx hyperframes lint ./my-composition +npx hyperframes lint ./my-composition --json # JSON output for CI/tooling +npx hyperframes lint ./my-composition --verbose # Include info-level findings ``` +By default only errors and warnings are shown. Use `--verbose` to also display informational findings (e.g., external script dependency notices). Use `--json` for machine-readable output with `errorCount`, `warningCount`, `infoCount`, and a `findings` array. + ### `compositions` List compositions found in the current project: diff --git a/packages/cli/src/templates/_shared/CLAUDE.md b/packages/cli/src/templates/_shared/CLAUDE.md index ada92b7a2..1c710c0c1 100644 --- a/packages/cli/src/templates/_shared/CLAUDE.md +++ b/packages/cli/src/templates/_shared/CLAUDE.md @@ -21,7 +21,9 @@ ```bash npx hyperframes dev # preview in browser (studio editor) npx hyperframes render # render to MP4 -npx hyperframes lint # validate compositions +npx hyperframes lint # validate compositions (errors + warnings) +npx hyperframes lint --verbose # include info-level findings +npx hyperframes lint --json # machine-readable output for CI npx hyperframes docs # reference docs in terminal ```