From 5d437d5eecd65f05daa4ff451ebb85b71f88fdb9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Miguel=20=C3=81ngel?= <miguel.sierra@heygen.com>
Date: Thu, 29 Oct 2026 08:10:51 +0000
Subject: [PATCH] docs(cli): say which audio probes run once per file (#6731)

---
 docs/packages/cli.mdx                                    | 9 +++++----
 skills-manifest.json                                     | 2 +-
 .../hyperframes-cli/references/lint-validate-inspect.md  | 2 +-
 3 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/docs/packages/cli.mdx b/docs/packages/cli.mdx
index 1561221350..8ec38c41ee 100644
--- a/docs/packages/cli.mdx
+++ b/docs/packages/cli.mdx
@@ -1309,10 +1309,11 @@ stops the browser pass, and remote sources are not fetched.
 | `audio_check_unavailable`      | info     | The audio check itself failed, and the message says why, so the clips were not checked.                      | Re-run; if it repeats, run `hyperframes doctor`.                                             |
 | `audio_src_not_found`          | error    | An `<audio src>` names a file that is not in the project, so the render is silent. Reported by `lint`.        | Add the file or fix the path.                                                                |
 
-Each file is probed once, with the same audio probe render uses. The check runs
-alongside the browser pass, up to four files at a time. A clip longer than 3 s
-is first sampled at three 1-second spots and decoded in full only if all three
-are silent.
+Each media probe (the audio metadata render uses, and render's media-type rule)
+runs at most once per file; whether a `<video>` has sound is probed on each use.
+The check runs alongside the browser pass, up to four files at a time. A clip
+longer than 3 s is first sampled at three 1-second spots and decoded in full
+only if all three are silent.
 
 #### Mark intentional layout choices
 
diff --git a/skills-manifest.json b/skills-manifest.json
index 699936200e..e082ad2246 100644
--- a/skills-manifest.json
+++ b/skills-manifest.json
@@ -10,7 +10,7 @@
       "files": 77
     },
     "hyperframes-cli": {
-      "hash": "19cd51ab0ac43edc",
+      "hash": "7a49a6eb1161315f",
       "files": 13
     },
     "hyperframes-registry": {
diff --git a/skills/hyperframes-cli/references/lint-validate-inspect.md b/skills/hyperframes-cli/references/lint-validate-inspect.md
index a473b95c78..c972875a79 100644
--- a/skills/hyperframes-cli/references/lint-validate-inspect.md
+++ b/skills/hyperframes-cli/references/lint-validate-inspect.md
@@ -61,7 +61,7 @@ One command, one Chrome boot. `check` runs the linter first and skips the browse
   - `audio_none` (info): no clip plays audio and no unmuted `<video>` has an audio track. Fine for a silent film; otherwise add the `<audio>`.
   - `audio_check_unavailable` (info): the audio check itself failed (the message says why), so the clips were not checked. Re-run; if it repeats, run `hyperframes doctor`.
   - `audio_src_not_found` (error, from `lint`): an `<audio src>` names a file not in the project, so the render is silent. Add the file or fix the path.
-  - Cost: each file is probed once, with the same audio probe render uses. The check runs alongside the browser pass, up to four files at a time. A clip longer than 3 s is first sampled at three 1-second spots and decoded in full only if all three are silent.
+  - Cost: each media probe (the audio metadata render uses, and render's media-type rule) runs at most once per file; whether a `<video>` has sound is probed on each use. The check runs alongside the browser pass, up to four files at a time. A clip longer than 3 s is first sampled at three 1-second spots and decoded in full only if all three are silent.
 
 Every finding carries a selector, the element's `data-*` identity, the composition source file, a bbox, and the sample time: jump straight from the JSON to the HTML you must edit and re-run.