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 follows Studio's semantic timeline

rponec45f68a8612d
diff --git a/.agents/skills/hypit/references/local-author-package.md b/.agents/skills/hypit/references/local-author-package.md
index 34952563..89bfe56a 100644
--- a/.agents/skills/hypit/references/local-author-package.md
+++ b/.agents/skills/hypit/references/local-author-package.md
@@ -80,6 +80,11 @@ The package is project-local even when the project is the Hypit checkout. Do not
official package automatically. After the result is accepted, offer promotion as a separate
contribution.
+Expect it to draw as a generic block in Studio until then. `packages/studio/src/studio-registry.ts`
+picks an adapter by the module that placed the Track, and no adapter names a `@hypit/local-…` module,
+so the component reaches the `visual-fallback` adapter: it renders, without its own family colour,
+icon or inspector. Registering it means editing a shared package, which is what promotion is for.
+
## Complete implementation
The main agent writes all code. Gemini must not receive or produce TypeScript, `package.json`,
@@ -241,9 +246,12 @@ person to do it should correct what follows.
`devDependencies`; in the package's own test harness; and in **both** package catalogs,
`docs/guide/packages.md` and `docs/zh/guide/packages.md`. An English-only catalog entry is a half
promotion.
-- **Studio keeps a hand-maintained list.** `packages/studio/src/adapters/generic.ts` enumerates the
- modules that get the component adapter. A package missing from it still renders, through the visual
- fallback — second-class in Studio, and invisible as itself in review.
+- **Studio keeps a hand-maintained registry.** `packages/studio/src/studio-registry.ts` composes the
+ adapter sets under `packages/studio/src/adapters/`, and each adapter names the modules it claims. A
+ family joins an existing set's `modules` list or brings its own adapter file, the way `deck.ts`
+ does. A package named by none of them still renders, through the `visual-fallback` and
+ `audio-fallback` adapters in `generic.ts` — second-class in Studio, and invisible as itself in
+ review.
- **Its own chrome is untracked today.** Git ignores `projects/`, so the texture the package
reads with `readFile(new URL("../assets/…"))` is not in git. Promotion is the first moment those
bytes enter the repository, and **no package under `packages/` has a non-`preview/` asset
diff --git a/.agents/skills/hypit/references/preview.md b/.agents/skills/hypit/references/preview.md
index 12fe8100..43bbfe7f 100644
--- a/.agents/skills/hypit/references/preview.md
+++ b/.agents/skills/hypit/references/preview.md
@@ -68,11 +68,36 @@ pnpm studio -- --run path/to/build.svrun \
Read the startup output for the chosen port. `--run` is required: Studio's unit of work is the Run
Source, and it reads the Author SVML back out of it. Pass `--runtime` only when the Author Source
-reuses accepted Build records.
+reuses accepted Build records. `--workspace` selects the Source Workspace and defaults to the Run's
+own directory, so pass it when the Run's relative Sources resolve against a different root.
Studio opens a Run whose material is satisfied. When a projection is missing it names the issue and
stops, so a Run that opens is a Run whose Tracks all resolved.
+One Run in the repository is satisfied already, so Studio can be seen without spending anything:
+
+```bash
+pnpm studio -- --run examples/all-components-preview/studio.svrun --workspace .
+```
+
+It supplies its own Semantic Takes and caption plan from committed fixtures. Every other Run under
+`examples/` still names shots a Provider has to make, or footage that is not committed.
+
+## A timeline block is not the authored Selection
+
+Studio keeps three stages of an item's time apart, and reading one for another misreads the program:
+
+- the **semantic source** the author named — a Selection, Segment, Moment or Program, with its
+ occurrence identity and its anchors on the Semantic Track;
+- the **projection** of that source into frame space, after occurrence expansion, offset evaluation,
+ clipping and frame quantization. One authored binding can project to zero, one or several windows;
+- the **consumption** window the realized Track actually uses, which the projection does not have to
+ equal — a source-audio trim reads different samples than its target window, and a Ranking exposes
+ one outer window alongside its reveal phases.
+
+A projection line connects a source to its realized window, and the projection view is read-only.
+`docs/guide/studio-temporal-windows.md` is authoritative for what each stage carries.
+
Studio is a browser preview **for a person to look at**. It is not a source of images for an
automated comparison — that is what the local still render above is for.