feat(cli): index media-use assets for catalog search

This commit is contained in:
Miguel Angel Simon Sierra
2026-09-21 00:14:20 -04:00
parent a5f1f88546
commit fde415553d
7 changed files with 306 additions and 30 deletions
+2 -2
View File
@@ -16,7 +16,7 @@ Run commands as `npx hyperframes ...` unless project instructions provide a wrap
## Development loop
1. **Scaffold:** `npx hyperframes init <project>` (centered blank). Or capture a site. Pass `--example=<name>` only to start from a named example.
2. **Find the move:** before authoring motion by hand, search for a primitive that already does it: `npx hyperframes catalog --query "reveal a headline one line at a time"`. Ask for the effect you want rather than the mechanism you have in mind. Install with `npx hyperframes add <name>` (see `/hyperframes-registry`). Author by hand only once nothing fits.
2. **Find the move:** if the request names an asset, sound, image, voice or fast visual edit, resolve it through `/media-use` before proposing a plan. Otherwise, before authoring motion by hand, search for a primitive that already does it: `npx hyperframes catalog --query "reveal a headline one line at a time"`. Ask for the effect you want rather than the mechanism you have in mind. Install with `npx hyperframes add <name>` (see `/hyperframes-registry`). Author by hand only once nothing fits.
3. **Author:** write the composition using `/hyperframes-core`. To know what is on a project's timeline (tracks, clips, starts, ends, what plays), run `npx hyperframes timeline --json` instead of reading `index.html` and every sub-composition file: nested rows carry absolute main-timeline `absStart`/`absEnd` and their owning `file`, not just their local, per-sub-composition time. Prefer `--json` over the text form; it costs fewer tokens for the same or better correctness. See `references/upgrade-info-misc.md` for one-liners that answer common questions without reading the whole output.
4. **Get fast feedback while editing:** run `npx hyperframes lint` after the first HTML pass and after structural changes.
5. **Run the final gate:** run `npx hyperframes check`; it reruns lint before opening the browser. Do not prepend a redundant standalone lint invocation. Add `--snapshots` for annotated overview frames and finding crops.
@@ -36,7 +36,7 @@ Run commands as `npx hyperframes ...` unless project instructions provide a wrap
- For fade-in/fade-out, crossfade, track gain, volume automation, ducking,
voiceover carve, or FX on placed audio, read `/hyperframes-audio`. Load core
alongside it when clip placement or picture timing also changes.
- Use `/media-use` only to source/generate media or preprocess a derived asset.
- A request naming an asset, sound, image, voice or fast visual edit resolves through `/media-use` before a plan is proposed.
Copy creator edit markup from `/hyperframes-core` → `references/creator-editing-recipes.md`.
```bash