---
name: resolution-beats
description: Turn a documented gap into a clear remedy, sequential checks and a completion stamp in an editable ten-second film.
version: 1.0.3
---

# Resolution Beats

A parameterized editorial renderer for concise explanatory sequences. The first beat circles a problem on an editable page; the second connects it to an answer and fills the check chips in order; the third settles a short completion stamp onto the page. The closing hold keeps the evidence and remedy together.

## Prepare the brief

Write JSON with `collection`, `heading`, two `context` strings, `issue`, `remedy`, `explanation`, two to five `checks`, `seal`, `closing`, `scheme`, and optional `lang` (`en` or `zh-CN`). Choose `lagoon`, `apricot`, or `violet`. All substantive copy comes from this input. Treat invented examples as illustrative; do not imply verification of external facts.

Keep the heading within 48 characters, issue within 84, remedy within 76, explanation within 110, checks within 14 each, stamp within 12 and closing within 90. These are input caps, not a guarantee every phrase fits; inspect actual typesetting and shorten crowded copy. Use an honest completion phrase appropriate to the demonstrated action.

## Install and generate

Requires Node.js 22+, Chrome, and FFmpeg. Run `npm ci --no-audit --no-fund` in this directory. Dependencies are fixed by the lockfile and fetched from the official npm registry. Retain the installed upstream licenses and the notices copied to generated assets. GSAP 3.13.0, Noto Sans SC 5.2.5, HyperFrames 0.8.30 and Playwright Core 1.56.1 are the declared dependencies.

Run `node create.mjs brief.json /absolute/path/to/new-project`. Existing project directories are rejected to protect previous versions. Render using `node node_modules/hyperframes/bin/hyperframes.mjs render /absolute/path/to/new-project --output /absolute/path/to/film.mp4 --fps 30 --quality high --strict --workers 1 --experimental-fast-capture=false`. Set `HYPERFRAMES_BROWSER_PATH` and `HYPERFRAMES_FFMPEG_PATH` for managed installations.

## Edit and inspect

The project contains all editable text, SVG geometry and the paused GSAP timeline in `index.html`, plus `brief.json`, metadata and local runtime assets. `window.__timelines['resolution-beats']` exposes deterministic seeking. Use the whole ten-second sequence; preserve the distinct problem, answer and completion intervals. Chips complete in array order. The stamp settles once, without a bounce. New spatial compositions require authoring; this tool is not an unrestricted prompt-to-film system.

Inspect zero, each transition, backward seeks and the final hold. Verify text remains within its panels, chips complete in order, and the stamp returns attention to the original page. Decode the final encoded MP4 and watch it at 1x. Record playback statistics rather than assuming a render guarantees smooth playback. Outputs are silent; narration, music and editorial audio mixing are outside this package. No external screenshots, photos or presenter footage are required for the editable document mode.