Skip to content

armgit / hypit

Public Imported from GitHub
0

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.

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.md
index 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 configured
by setting its exact environment variable. `hypit auth login` deliberately refuses to prompt in
diff --git a/.agents/skills/hypit/references/environment.md b/.agents/skills/hypit/references/environment.md
index 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.md
index 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. A
declaration-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. A
diff --git a/.agents/skills/hypit/references/original-authoring/index.md b/.agents/skills/hypit/references/original-authoring/index.md
index 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 nobody
asked for.
diff --git a/.agents/skills/hypit/references/playbooks/craft/generated-dependencies.md b/.agents/skills/hypit/references/playbooks/craft/generated-dependencies.md
index 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 a
stretch that is delivered unbroken invents a seam nobody asked for, and inviting a generator to
re-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 as
long as it runs the picture is whatever the peer Tracks put there, and wherever they put nothing the
Film's own background shows through. A voiceover Segment is therefore an obligation: every frame of
it 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.md
index 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.md
index 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 an
explicit 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.md
index 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 but
does not create measured timing.
diff --git a/.agents/skills/hypit/references/playbooks/craft/sfx.md b/.agents/skills/hypit/references/playbooks/craft/sfx.md
index 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.md
index 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 how
many 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. Prefer
simple, 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.md
index 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 reuse
diff --git a/.agents/skills/hypit/references/playbooks/formats/mixcut.md b/.agents/skills/hypit/references/playbooks/formats/mixcut.md
index 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 CTA
copy.
- 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`; regenerate
only 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.md
index 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 when
authored 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 evidence
media 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.md
index 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 load
order 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.md
index 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 add
peer 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 through
diff --git a/.agents/skills/hypit/references/quickstart.md b/.agents/skills/hypit/references/quickstart.md
index 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 Runtime
authority. 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 durable
Runtime, inspect the frozen plan, submit a named Build, inspect its accepted Records, retrieve
diff --git a/.agents/skills/hypit/references/reconstruction/continuity.md b/.agents/skills/hypit/references/reconstruction/continuity.md
index 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 observed
lifetime. 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 and
do 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.md
index 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 thought
Each 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. The
preceding tail frame, audio tail and full-reference evidence are attached automatically; do not
reconstruct that context by hand.
A shot is never shorter than a second. Fragments below that are not shots, and clips that short are
rejected 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 about
evidence quality: a complete observation that says "unclear" is still complete, and that is what a
diff --git a/docs/guide/author-packages.md b/docs/guide/author-packages.md
index 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 one
that 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.md
index 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.json
index 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.ts
index 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.mjs
old mode 100644
new mode 100755
diff --git a/packages/seedance/README.md b/packages/seedance/README.md
index 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 exp
member 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 is
either 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.