Clone any viral video with AI agents. Not just a script, the whole workflow: swap the face, the words, the B-roll, ship 100 variants in one command, and get your 100M views.
TypeScript agentic-aiaiai-agentsai-videocompilerdslffmpeggenerative-aillmmarkup-languagemonorepoplugin-systemprogramming-languagetext-to-videotypescriptvideovideo-automationvideo-clonevideo-editingvideo-generation
docs: the skill's claims match the code again
rpone46e4fa6abebc
diff --git a/.agents/skills/hypit/references/credentials.md b/.agents/skills/hypit/references/credentials.mdindex 4e5a20a9..a42d76ec 100644--- a/.agents/skills/hypit/references/credentials.md+++ b/.agents/skills/hypit/references/credentials.md@@ -66,8 +66,9 @@ curl -s -o /dev/null -w '%{http_code}\n' -H "Authorization: Bearer $MIMO_API_KEY````hypit runtime down` stops the Worker for the whole project, so a Build running in another terminal-stops with it. The Build itself is durable and survives; resume it with-`hypit status <build-id> --watch`.+stops with it. The Build itself is durable and survives; bring the Worker back with `hypit runtime+up`, then reattach with `hypit status <build-id> --watch`. Observing requires a running Worker: with+none, `status --watch` reports the Worker's state and tells you to start it.An Endpoint whose Runtime Profile points at the read-only `env` CredentialStore must be configuredby setting its exact environment variable. `hypit auth login` deliberately refuses to prompt indiff --git a/.agents/skills/hypit/references/environment.md b/.agents/skills/hypit/references/environment.mdindex acfbcc68..90e98bed 100644--- a/.agents/skills/hypit/references/environment.md+++ b/.agents/skills/hypit/references/environment.md@@ -36,8 +36,9 @@ convention, it is the condition under which they work.## Requirements-Node.js 22+, pnpm 10.33.x via Corepack, Python 3.10–3.13 only for local-WhisperX/OpenCV, `uv` for locked Python environments, and `ffmpeg`/`ffprobe` for local media.+Node.js 22+, pnpm 10.33.x via Corepack, Python only for the local services — 3.10–3.13 for WhisperX+and 3.13 for OpenCV, which `uv python install 3.13` satisfies for both — `uv` for locked Python+environments, and `ffmpeg`/`ffprobe` for local media.macOS/Linux or Windows PowerShell:diff --git a/.agents/skills/hypit/references/local-author-package.md b/.agents/skills/hypit/references/local-author-package.mdindex d9153907..34952563 100644--- a/.agents/skills/hypit/references/local-author-package.md+++ b/.agents/skills/hypit/references/local-author-package.md@@ -95,7 +95,7 @@ Implement the parts required by the behavior, including:- lowering, Fragment or renderer implementation needed to produce the declared output;- README and a preview for each visual Surface.-Choose raw versus structured Surface, timing dependencies, ProgramSpace, Frame, SemanticMap,+Choose raw versus structured Surface, timing dependencies, ProgramSpace, Frame, SemanticTrack,Artifact, Recipe and output Types from the observed behavior and closest package architecture. Adeclaration-only or Surface-only package is incomplete.@@ -113,7 +113,8 @@ nothing.- Produce that file with `hypit image`:```bash- hypit image --prompt "the surface this component draws on" --to packages/local-<slug>/assets/paper.png+ hypit image --prompt "the surface this component draws on" \+ --to <project>/packages/local-<slug>/assets/paper.png```It writes a picture and nothing else — no Source, no Build, no Record, no Runtime Profile. Adiff --git a/.agents/skills/hypit/references/original-authoring/index.md b/.agents/skills/hypit/references/original-authoring/index.mdindex d571dd25..d1faadd0 100644--- a/.agents/skills/hypit/references/original-authoring/index.md+++ b/.agents/skills/hypit/references/original-authoring/index.md@@ -53,8 +53,8 @@ Everything else this route needs is discoverable:## Write the Script, then the sources`../authoring.md` is the syntax authority and names the checks. The Script comes first and the shots-come out of it, not the other way round: a Segment is what the Spine binds one Take to, so how the-Script is cut decides how many generations there are and where the seams fall —+come out of it, not the other way round: a Segment is what one `whisperx:SemanticTake` aligns one+Take to, so how the Script is cut decides how many generations there are and where the seams fall —`../playbooks/craft/generated-dependencies.md` says why over-splitting manufactures seams nobodyasked for.diff --git a/.agents/skills/hypit/references/playbooks/craft/generated-dependencies.md b/.agents/skills/hypit/references/playbooks/craft/generated-dependencies.mdindex e8e9562a..2ad35fba 100644--- a/.agents/skills/hypit/references/playbooks/craft/generated-dependencies.md+++ b/.agents/skills/hypit/references/playbooks/craft/generated-dependencies.md@@ -46,8 +46,8 @@ the parts, move on.## A Segment is a generation boundary-A Segment is what the Spine binds one Take to, so each one is a separate generation and a separate-seam. Cut the Script the way the program is *spoken*, not the way its shots are numbered: splitting a+A Segment is what one `whisperx:SemanticTake` aligns one Take to, so each one is a separate+generation and a separate seam. Cut the Script the way the program is *spoken*, not the way its shots are numbered: splitting astretch that is delivered unbroken invents a seam nobody asked for, and inviting a generator tore-establish the room across that seam is how continuity is lost for nothing.@@ -118,7 +118,9 @@ produces the blink.## An audio Take brings no picture, so its Segment is covered or it plays black-A `speech:Take audio={…}` creates program time and speech and contributes no visual at all. For as+An audio-only Take — media normalized with `video="none"`, aligned by `whisperx:SemanticTake`, and+assembled by `speech:Take source={…}` — creates program time and speech and contributes no visual at+all. For aslong as it runs the picture is whatever the peer Tracks put there, and wherever they put nothing theFilm's own background shows through. A voiceover Segment is therefore an obligation: every frame ofit belongs to some Item, and the frames nobody claimed are black in the delivery.diff --git a/.agents/skills/hypit/references/playbooks/craft/pip-overlay.md b/.agents/skills/hypit/references/playbooks/craft/pip-overlay.mdindex 835b0ca6..7ffaceb2 100644--- a/.agents/skills/hypit/references/playbooks/craft/pip-overlay.md+++ b/.agents/skills/hypit/references/playbooks/craft/pip-overlay.md@@ -20,7 +20,7 @@ secondary feed, or supporting image stays visible.<remove:Background id="presenter-cutout" source={presenter.image}/><space:Extent id="presenter-extent" width="1200" height="1600"/><space:Frame id="presenter-pip" within={vertical}- left="64%" top="52%" right="4%" bottom="8%"/>+ left="64%" top="52%" right="96%" bottom="92%"/><media-track:Track id="presenter-overlay" semantic={speech.semantic} canvas={vertical}><media-track:Item image={presenter-cutout.image} extent={presenter-extent}diff --git a/.agents/skills/hypit/references/playbooks/craft/screen-demo.md b/.agents/skills/hypit/references/playbooks/craft/screen-demo.mdindex ac744687..3d1a2250 100644--- a/.agents/skills/hypit/references/playbooks/craft/screen-demo.md+++ b/.agents/skills/hypit/references/playbooks/craft/screen-demo.md@@ -54,7 +54,7 @@ for both views is insufficient. Apply the complete gate in `visual-continuity.md- Place screenshots, recordings, and generated demonstrations with `media-track:Track`; define anexplicit Frame, appearance Recipe, motion Recipe, timing window, and stack order.- Use `during={story.selection.NAME}` for a spoken demonstration range, a Moment plus `for` for an- event, or explicit ProgramSpace timing for a silent demo.+ event, or explicit `start`/`end` timing in the SemanticTrack frame domain for a silent demo.- Inspect legibility at delivery size, not only full-resolution source size. Reject changed text,unreadable controls, moire, impossible perspective, screen reflections that hide evidence,same-background reverse views, or a hand interaction that does not match the UI state.diff --git a/.agents/skills/hypit/references/playbooks/craft/seedance-directing.md b/.agents/skills/hypit/references/playbooks/craft/seedance-directing.mdindex ff394bf6..ac0be627 100644--- a/.agents/skills/hypit/references/playbooks/craft/seedance-directing.md+++ b/.agents/skills/hypit/references/playbooks/craft/seedance-directing.md@@ -46,8 +46,10 @@ than relying on an unstated assumption.Invalid values fail closed.- Never generate from a prompt alone, and never author a take shorter than the floor.`generated-dependencies.md` says what to do with a stretch too short to be a take.-- Respect the ReferenceVideo caps: at most 9 images, 3 videos, 3 audio clips, and 12 total files.- Reference audio requires at least one visual reference.+- Respect the ReferenceVideo caps, which the selected model declares along with its duration range.+ `mini`, `fast` and `standard` take at most 9 images, 3 videos, 3 audio clips and 12 files in total,+ and their reference audio requires at least one visual reference; `2.5` takes more of each and+ imposes neither of those two constraints.- Use `estimate:Speech` for speech-driven duration planning; it estimates pronunciation length butdoes not create measured timing.diff --git a/.agents/skills/hypit/references/playbooks/craft/sfx.md b/.agents/skills/hypit/references/playbooks/craft/sfx.mdindex 5ebb3ea9..327859f1 100644--- a/.agents/skills/hypit/references/playbooks/craft/sfx.md+++ b/.agents/skills/hypit/references/playbooks/craft/sfx.md@@ -21,7 +21,7 @@ Declare the source, normalize it to audio-only `SynchronizedMedia`, and place it```svml<media:Audio id="reveal-source" src="./assets/reveal.wav"/><pipeline:Normalize id="reveal-media" source={reveal-source}- video="none" audio="default" span-authority="audio" frame-rate="30"/>+ video="none" audio="default" span-authority="audio" clock={clock}/><audio:Track id="effects" semantic={speech.semantic}><audio:Clip source={reveal-media.media}diff --git a/.agents/skills/hypit/references/playbooks/craft/visual-continuity.md b/.agents/skills/hypit/references/playbooks/craft/visual-continuity.mdindex 11a135c4..9a026ca9 100644--- a/.agents/skills/hypit/references/playbooks/craft/visual-continuity.md+++ b/.agents/skills/hypit/references/playbooks/craft/visual-continuity.md@@ -10,7 +10,7 @@`generated-dependencies.md` states both, and the reverse-view geometry below is what decides howmany views a location needs.- Keep one authoritative reference set and one stable Recipe for a continuous shot group. Split a- group only for a genuine edit or the 15-second Seedance ceiling; preserve camera, room, wardrobe,+ group only for a genuine edit or the selected model's duration ceiling; preserve camera, room, wardrobe,light, props, action state, and reference order across its parts.- Put each stable physical fact in both the reference image and the relevant prompt contract. Prefersimple, symmetric props when a distinctive feature repeatedly duplicates or mutates.diff --git a/.agents/skills/hypit/references/playbooks/formats/asmr.md b/.agents/skills/hypit/references/playbooks/formats/asmr.mdindex 503c4142..ed89f41b 100644--- a/.agents/skills/hypit/references/playbooks/formats/asmr.md+++ b/.agents/skills/hypit/references/playbooks/formats/asmr.md@@ -19,23 +19,24 @@ texture sound to create a calm, satisfying micro-film.reviewing the generated take.Avoid rapid edits, large camera moves, busy backgrounds, multiple simultaneous actions, or motion-that hides the contact point. Use `standard` for 1080p/4k detail; `fast` and `mini` are limited to-480p/720p.+that hides the contact point. Use `standard` for 1080p/4k detail; `fast`, `mini` and `2.5` render at+480p or 720p.## Author the sound- Use supplied or generated texture sound, ambience, and optional music as explicit sources.-- Normalize every Blob with `pipeline:Normalize`, then place it through `audio:Track` and- `audio:Clip` on the delivery ProgramSpace.+- Normalize every Blob with `pipeline:Normalize`, then place it through `audio:Track+ semantic={…}` and `audio:Clip`.- Align impacts and texture changes to the audience-perceived contact event with explicit timing.- Use one sound for one function. Do not cover a delicate material sound with unnecessary impacts,whooshes, or dense music.- Set trim, playback, gain, fade-in, and fade-out explicitly. Do not assume automatic looping,ducking, or loudness normalization.-For a speech-free ASMR edit, omit WhisperX and Caption components. Select a verified ProgramSpace-Record in `.svrun` with `build-record` and `satisfy`, then author explicit windows against that-ProgramSpace. The selected Record is the delivery time contract.+For a speech-free ASMR edit, keep the `whisperx:SemanticTake` and `speech:Track` declarations and+satisfy `<track>.semantic` in `.svrun` with `build-record` and `satisfy`. That Record is the delivery+time contract, and every window is an explicit `start`/`end` against it. Omit the Caption components.+`../index.md` says why the declarations stay.## Review and reusediff --git a/.agents/skills/hypit/references/playbooks/formats/mixcut.md b/.agents/skills/hypit/references/playbooks/formats/mixcut.mdindex 11dd362c..b16bd5ab 100644--- a/.agents/skills/hypit/references/playbooks/formats/mixcut.md+++ b/.agents/skills/hypit/references/playbooks/formats/mixcut.md@@ -31,10 +31,11 @@ A crop of the same image is not a new beat.## Author timing, text, and sound-- Lock the delivery ProgramSpace before laying out Items. For a voice-led cut, an audio-only- `speech:Take` supplies program time and semantic anchors. For a music-only cut, select a verified- ProgramSpace Record in `.svrun` with `build-record` and `satisfy`, then author explicit- `start`/`end` windows. Do not treat music as speech evidence.+- Lock the delivery SemanticTrack before laying out Items. For a voice-led cut, an audio-only Take+ supplies program time and semantic anchors. For a music-only cut, keep the `whisperx:SemanticTake`+ and `speech:Track` declarations and satisfy `<track>.semantic` in `.svrun` with `build-record` and+ `satisfy`, then author explicit `start`/`end` windows against it — `../index.md` says why the+ declarations stay. Do not treat music as speech evidence.- Omit Caption components when there is no spoken Script. Use `typo:Track` for title, benefit, and CTAcopy.- Keep no more than one or two text groups on screen at once. Align text handoffs to the final trimmed@@ -53,7 +54,7 @@ A crop of the same image is not a new beat.Review first frames, motion continuity, object/label stability, effective clip lengths, text handoffs,audio start/end, claim accuracy, and the first/last second of the complete Film. Pin every accepted-image, clip, audio source, and ProgramSpace with `.svrun` `build-record` and `satisfy`; regenerate+image, clip, audio source, and the SemanticTrack with `.svrun` `build-record` and `satisfy`; regenerateonly failed beats.Read `../craft/image-prompt-style.md`, `../craft/b-roll.md`, `../craft/overlays.md`,diff --git a/.agents/skills/hypit/references/playbooks/formats/ranking-listicle.md b/.agents/skills/hypit/references/playbooks/formats/ranking-listicle.mdindex 789c477a..ae8adf08 100644--- a/.agents/skills/hypit/references/playbooks/formats/ranking-listicle.md+++ b/.agents/skills/hypit/references/playbooks/formats/ranking-listicle.md@@ -5,12 +5,16 @@ explain why every item belongs where it is placed.## Author the Script schedule-- Write one outer Script Selection covering the complete ranking window.-- Declare one repeated Script Moment for item reveals and one terminal Moment for the completed board.-- The outer Selection must resolve exactly once. The terminal Moment must resolve exactly once.-- Repeat the same reveal Moment id once per item. Ranking applies strict `each` semantics; the- occurrence count must equal the number of authored items, and trigger frames must increase.-- Give every item a stable id, order, label, icon/image, rank or tier, and one evidence beat.+- Write one outer Script Selection covering the complete ranking window. It must resolve exactly once.+- `ranking:TierBoard` and `ranking:TopThree` are driven by Moments: declare one repeated Script+ Moment for item reveals and one terminal Moment for the completed board, which must resolve exactly+ once. Repeat the same reveal Moment id once per item — both apply strict `each` semantics, so the+ occurrence count must equal the number of authored items and trigger frames must increase.+- `ranking:Column` is driven by its items: give each item that is not `preset` its own Script+ Selection, and declare no Moments for it.+- Give every item a stable id, its rank or tier, its icon or image, and one evidence beat. Copy+ belongs to the item only where the component carries it: `ColumnItem` and `TopThreeItem` require a+ `label`, while a `TierItem` requires an `icon` and carries no copy of its own.## Author the SVML program@@ -19,8 +23,10 @@ explain why every item belongs where it is placed.2. Declare exact font bytes and the variant's package-owned Style.3. Choose exactly one primary component: `ranking:TierBoard`, `ranking:Column`, or`ranking:TopThree`.-4. Connect `semantic={speech.semantic}`, the outer `during` Selection, repeated- `triggers` Moment, terminal Moment, explicit frame, Style, and the complete ordered item list.+4. Connect `semantic={speech.semantic}`, the outer `during`, an explicit `frame`, the Style, and the+ complete ordered item list. `TierBoard` and `TopThree` also take the repeated `triggers` Moment+ and the `terminal` Moment; `Column` takes a required `canvas` instead and reads its timing from+ each item's own `during`.5. Add the component's `.visual` output to `film:Film`; add its optional `.audio` output only whenauthored sound is present.6. Put screenshots, demonstrations, or proof clips on a separate `media-track:Track`. Use@@ -40,7 +46,8 @@ explain why every item belongs where it is placed.## Review and reuse-Review resolved trigger count/order, terminal timing, item identity, rank/tier, labels, icon assets,+Review the resolved trigger count and order and the terminal timing where the component uses them,+item identity, rank/tier, labels, icon assets,evidence alignment, safe zones, stack order, and optional sounds. Pin accepted generated evidencemedia through `.svrun` before the final ranking Build.diff --git a/.agents/skills/hypit/references/playbooks/formats/voiceover-desk-demo.md b/.agents/skills/hypit/references/playbooks/formats/voiceover-desk-demo.mdindex 6ceaa64e..1e14c2d3 100644--- a/.agents/skills/hypit/references/playbooks/formats/voiceover-desk-demo.md+++ b/.agents/skills/hypit/references/playbooks/formats/voiceover-desk-demo.md@@ -54,8 +54,8 @@ screen, product, hand, or proof changes.clipped narration, or visual proof that arrives before its setup.- Pin accepted narration and visuals through `.svrun` `build-record` and `satisfy`.-Read `../craft/screen-demo.md`, `../craft/b-roll.md`, `../craft/persona-and-audio.md`,-`../craft/captions.md`, and `../craft/sfx.md`.+Read `../craft/screen-demo.md`, `../craft/b-roll.md`, `../craft/seedance-directing.md`,+`../craft/persona-and-audio.md`, `../craft/captions.md`, and `../craft/sfx.md`.That list is complete: `../index.md` does not repeat it, and the craft its required loadorder marks always-read is required regardless of format.diff --git a/.agents/skills/hypit/references/playbooks/index.md b/.agents/skills/hypit/references/playbooks/index.mdindex 608d3780..0a6192c8 100644--- a/.agents/skills/hypit/references/playbooks/index.md+++ b/.agents/skills/hypit/references/playbooks/index.md@@ -34,8 +34,13 @@ file that some jobs never open.ratio visible in the Author Source.- Build speech-led programs from normalized `whisperx:SemanticTake` values with `speech:Track`, then addpeer Caption, Media, Typography, Ranking, Deck, Comment, Screen, and Audio Tracks.-- Use `speech:Track` for ordered speech-bearing Semantic Takes. For speech-free formats, select a- verified ProgramSpace Record in `.svrun`, author explicit timing, and omit WhisperX/Caption work.+- Use `speech:Track` for ordered speech-bearing Semantic Takes. A program with no spoken words still+ has a SemanticTrack, because it is the frame domain every `start`/`end` window resolves into: keep+ the `whisperx:SemanticTake` and `speech:Track` declarations, which are what declares the+ `<track>.semantic` output, and satisfy that output in `.svrun` with a `build-record` Candidate from+ a Build that already produced one. Keep `<track>.visual` and `<track>.audio` out of the Film and the+ alignment goes unreached — `hypit plan` lists it under `Declared but not reached`. Time every Item+ and Clip with `start`/`end`, and omit the Caption components.- Assemble peer Tracks with `film:Film`, render with `render:Video`, and demand outputs through a`.svrun` Target.- Stage expensive work with narrow `.svrun` Targets. Explicitly reuse an accepted Record throughdiff --git a/.agents/skills/hypit/references/quickstart.md b/.agents/skills/hypit/references/quickstart.mdindex ed8a6ac7..16db5b2a 100644--- a/.agents/skills/hypit/references/quickstart.md+++ b/.agents/skills/hypit/references/quickstart.md@@ -8,24 +8,26 @@ The repository docs are authoritative:| SVS Recipes | `docs/quickstart/styles.md` || Media and Seedance | `docs/quickstart/generation.md` || Reusable Seedance Prompt Kits | `packages/seedance-kits/README.md` and the selected file under `packages/seedance-kits/kits/` |-| Speech Spine and SemanticMap | `docs/quickstart/timing.md` |+| Normalization, alignment and SemanticTrack assembly | `docs/quickstart/timing.md` || Caption, Media, Text, Audio Tracks | `docs/quickstart/tracks.md` and the `@hypit/audio-track` package README || Film and rendering | `docs/quickstart/composition.md` || Run Source, durable Runtime, Builds, retrieval, and reuse | `docs/quickstart/run.md` and `runtime.md` |Canonical path:-`Script → estimate:Speech/text → Seedance or supplied media → Speech Spine → WhisperX SemanticMap → peer Caption/Media/Typography/Audio Tracks → Film → render:Video`.+`Script → estimate:Speech/text → Seedance or supplied media → pipeline:Normalize → whisperx:SemanticTake → speech:Track → peer Caption/Media/Typography/Audio Tracks → Film → render:Video`.-Use explicit imports, exact fonts, Canvas/Frames, ProgramSpace, Targets, and Runtime+Use explicit imports, exact fonts, Canvas/Frames, the SemanticTrack, Targets, and Runtimeauthority. There is no implicit cache; reuse is explicit with `build-record` + `satisfy`.-Use `speech:Take video={...}` for a speech-bearing A/V take and `speech:Take audio={...}` for-voiceover. An audio Take creates program time and speech audio while peer Media Tracks provide the-visuals.+`speech:Take source={...}` assembles one aligned `whisperx:SemanticTake` into the Track, in program+order. A take whose media normalizes with `video="none"` creates program time and speech audio while+peer Media Tracks provide the visuals.-For a speech-free program, select a verified ProgramSpace Record through `.svrun` `build-record`-and `satisfy`, use explicit Track windows, and omit WhisperX and Caption components.+For a program with no spoken words, keep the `whisperx:SemanticTake` and `speech:Track` declarations —+the SemanticTrack is the frame domain every `start`/`end` window resolves into — satisfy+`<track>.semantic` through `.svrun` `build-record` and `satisfy`, keep `<track>.visual` and+`<track>.audio` out of the Film so the alignment goes unreached, and omit the Caption components.For execution, preserve the full lifecycle: diagnose the Profile, start or reuse the durableRuntime, inspect the frozen plan, submit a named Build, inspect its accepted Records, retrievediff --git a/.agents/skills/hypit/references/reconstruction/continuity.md b/.agents/skills/hypit/references/reconstruction/continuity.mdindex de5be86f..21793a08 100644--- a/.agents/skills/hypit/references/reconstruction/continuity.md+++ b/.agents/skills/hypit/references/reconstruction/continuity.md@@ -14,8 +14,8 @@ These invariants override superficial layer order and shot boundaries:- One overlay that continues across a cut remains one visual track spanning its full observedlifetime. Do not recreate it once per shot.- Merge two or three incorrectly split clips only when continuity evidence confirms one camera shot- and the combined duration is at most 15 seconds. If the duration exceeds 15 seconds, preserve the- continuous-group relationship without creating an overlong shot.+ and the combined duration stays inside the duration ceiling of the model that will generate it. Past+ that ceiling, preserve the continuous-group relationship without creating an overlong shot.- Reuse whole-reference people, voice and product evidence. Describe the promoted product once anddo not replace it with conflicting per-shot descriptions.diff --git a/.agents/skills/hypit/references/reconstruction/workflow.md b/.agents/skills/hypit/references/reconstruction/workflow.mdindex e174a429..bc911122 100644--- a/.agents/skills/hypit/references/reconstruction/workflow.md+++ b/.agents/skills/hypit/references/reconstruction/workflow.md@@ -92,15 +92,18 @@ a list of known items it stops being able to report the one thing nobody thoughtEach cut produces one `continuity` observation answering both questions under their own headings —whether the two shots are one continuous camera shot, and whether an overlay continues across the-boundary — and a window of three consecutive shots triggers a three-shot continuity review. The+boundary — and a window of three consecutive shots gets a three-shot continuity review when a+boundary observation reports continuity or uncertainty, or when `--reobserve` was passed. Thepreceding tail frame, audio tail and full-reference evidence are attached automatically; do notreconstruct that context by hand.A shot is never shorter than a second. Fragments below that are not shots, and clips that short arerejected by the model, so the detector merges them into the shot before them.-Completed observations are reused. Naming a shot does not re-run it. `--reobserve` is the only way to-run a completed observation again, and it exists for rebuilt media, not for doubt.+Completed observations are reused. Naming a shot does not re-run it. `--reobserve` re-runs a completed+observation without rebuilding its media, and it exists for rebuilt media, not for doubt. `--redo+media` clears every observation as a side effect of rebuilding the shots, so the next+`observe_reference` runs all of them again.`unresolved` lists the keys of observations that failed outright. It is not a judgement aboutevidence quality: a complete observation that says "unclear" is still complete, and that is what adiff --git a/docs/guide/author-packages.md b/docs/guide/author-packages.mdindex 9dc60a0a..20e48ada 100644--- a/docs/guide/author-packages.md+++ b/docs/guide/author-packages.md@@ -130,8 +130,8 @@ vocabulary: {```Declare a `preview` for every Surface whose result a reader needs to see to understand it. That is-not only Surfaces producing a `VisualTrack`: `@hypit/speech-track` declares one for a Spine because-its shape is easier to see than to describe. Skip it for a Surface with nothing to show, such as one+not only Surfaces producing a `VisualTrack`: `@hypit/speech-track` declares one for its SemanticTrack+because its shape is easier to see than to describe. Skip it for a Surface with nothing to show, such as onethat only assembles a request.`appearance` and `preview` answer different questions and neither replaces the other. `appearance`diff --git a/docs/zh/guide/author-packages.md b/docs/zh/guide/author-packages.mdindex 1563e904..b7ff5613 100644--- a/docs/zh/guide/author-packages.md+++ b/docs/zh/guide/author-packages.md@@ -120,7 +120,7 @@ vocabulary: {}```-凡是读者必须看一眼产出才能理解的 Surface,都要声明 `preview`。这不限于产出 `VisualTrack` 的 Surface:`@hypit/speech-track` 也为 Spine 声明了预览图,因为它的形态看一眼比读一段描述更快。没有可展示产出的 Surface 可以不声明,例如只负责装配请求的那种。+凡是读者必须看一眼产出才能理解的 Surface,都要声明 `preview`。这不限于产出 `VisualTrack` 的 Surface:`@hypit/speech-track` 也为 SemanticTrack 声明了预览图,因为它的形态看一眼比读一段描述更快。没有可展示产出的 Surface 可以不声明,例如只负责装配请求的那种。`appearance` 和 `preview` 回答的是两个不同的问题,谁都替代不了谁:`appearance` 说的是这个元素在所有情况下都会画出什么,预览图给出的是其中一个诚实的实例。diff --git a/package.json b/package.jsonindex 08f588d7..ea5c0bf3 100644--- a/package.json+++ b/package.json@@ -5,7 +5,8 @@"private": true,"type": "module","bin": {- "hypit": "./bin/hypit.mjs"+ "hypit": "./bin/hypit.mjs",+ "hypit-reference-video-tools": "./packages/reference-video-tools/bin/reference-video-tools.mjs"},"packageManager": "[email protected]","scripts": {diff --git a/packages/audio-track/src/manifest.ts b/packages/audio-track/src/manifest.tsindex 0c75b24e..3fe76438 100644--- a/packages/audio-track/src/manifest.ts+++ b/packages/audio-track/src/manifest.ts@@ -89,7 +89,7 @@ export const audioTrackMarkupSurfaces = [{name: "track", tag: "Track", mode: "structured",outputs: [audioTrackTypes.header, audioTrackTypes.clipSpec, audioTrackTypes.program, compositionTypes.audioTrack],vocabulary: {- summary: "One Audio Track: explicitly prepared audio Clips placed on a shared ProgramSpace and lowered to one ordinary peer AudioTrack.",+ summary: "One Audio Track: explicitly prepared audio Clips placed on a shared SemanticTrack and lowered to one ordinary peer AudioTrack.",attributes: [{ name: "id", kind: "identifier", required: true, summary: "Names this Audio Track and prefixes the identity of every Clip that does not name itself." },{ name: "semantic", kind: "reference", required: true, accepts: [semanticTrackTypes.track], summary: "Selects the continuous semantic frame domain every Clip window resolves into." },diff --git a/packages/reference-video-tools/bin/reference-video-tools.mjs b/packages/reference-video-tools/bin/reference-video-tools.mjsold mode 100644new mode 100755diff --git a/packages/seedance/README.md b/packages/seedance/README.mdindex cea8d2e4..888d715e 100644--- a/packages/seedance/README.md+++ b/packages/seedance/README.md@@ -13,6 +13,6 @@ All three preserve the remote result as one atomic `GeneratedVideoSet`, then expmember as an ordinary `BlobArtifact`. Their prompt ports consume ordinary `Text`, so a Script projection,generic Text Template or third-party author module can feed them without becoming part of Seedance.-`standard`, `fast` and `mini` select model variants independently of the invocation shape. Duration is+`standard`, `fast`, `mini` and `2.5` select model variants independently of the invocation shape. Duration iseither literal or supplied by an explicit `SpeechDuration` edge; the generic internal `DurationProgram`only delays that scalar binding and does not introduce a Speaker/Speech usage into the model interface.