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(v2): audit live path and distribution boundaries

kashorinbff2482866be
diff --git a/README.md b/README.md
index 54f6d16d..cca07edf 100644
--- a/README.md
+++ b/README.md
@@ -7,8 +7,9 @@ Its reference video distribution lets an author address a video with words rathe
Script defines the semantic truth, generated speech supplies acoustic evidence, and independent
packages lower captions, B-roll, text and speech into peer Tracks.
-SVML is currently a pre-release v2 rewrite. It has completed one real paid talking-video Build, but
-its public package names and video authoring ABI are not frozen yet.
+SVML is currently a pre-release v2 rewrite. It has completed a real paid talking-video acceptance
+sequence, but the repository is currently a source-checkout workspace rather than a published npm
+distribution; its public package names and video authoring ABI are not frozen yet.
## Why a graph language
@@ -176,6 +177,8 @@ examples v2 checks/live witness plus retained v1 regression fixt
```
Start with the [documentation map](docs/README.md) and [roadmap](docs/roadmap.md).
+The [open-source distribution plan](docs/open-source-distribution.md) records what can ship
+independently and what remains before the first public package release.
## Development
diff --git a/docs/README.md b/docs/README.md
index 216579e2..e4a5e01a 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -11,7 +11,9 @@ the working tree contains only documents that should inform current implementati
3. [`implementation-status.md`](./implementation-status.md) — what actually executes today.
4. [`roadmap.md`](./roadmap.md) — active domain-neutral and environment/Provider work; deferred video
work is separated explicitly.
-5. [`../spec/core-kernel-v1.md`](../spec/core-kernel-v1.md) — compact normative Kernel laws for the
+5. [`open-source-distribution.md`](./open-source-distribution.md) — what can ship independently,
+ current packaging truth and public-release gates.
+6. [`../spec/core-kernel-v1.md`](../spec/core-kernel-v1.md) — compact normative Kernel laws for the
current `@2` wire data.
## Domain-neutral implementation records
diff --git a/examples/talking-film-live/README.md b/examples/talking-film-live/README.md
index 5414258c..2fc03de9 100644
--- a/examples/talking-film-live/README.md
+++ b/examples/talking-film-live/README.md
@@ -13,6 +13,19 @@ Both English lines resolve to five seconds with `pace="normal"`, `padding="0.3"`
minimum and `ceil` rounding. The generated presenter image is intentionally ignored by Git under
`assets/`; supply or regenerate `assets/presenter.png` before checking or building.
+Prerequisites for the exact checked-in Runtime Profile:
+
+- `KIE_API_KEY` for the two paid Seedance Mini generations;
+- `GOOGLE_CLOUD_PROJECT` naming a project with Vertex AI enabled;
+- `GOOGLE_APPLICATION_CREDENTIALS_JSON` containing the credential JSON, not a committed path or
+ secret file;
+- `ffmpeg`, `ffprobe`, Chrome/HyperFrames and the prepared local WhisperX sidecar.
+
+Prepare and health-check WhisperX as described in
+[`../../services/whisperx/README.md`](../../services/whisperx/README.md). `svml-v2 check` validates
+source, Run Graph and exact Runtime capability coverage before scheduling, but it does not make a
+paid Provider request or promise that remote credentials and service health are valid.
+
Run the complete graph through the explicit Run Graph and declarative local Runtime Profile:
```bash
@@ -26,13 +39,14 @@ pnpm svml:v2 inspect talking-film-live \
pnpm svml:v2 get talking-film-live \
--runtime examples/talking-film-live/svml.runtime.json \
+ --name final.video \
--to examples/talking-film-live/output/final.mp4
```
`build.svrun` owns the selected Target and fidelity. `svml.runtime.json` owns Provider instances,
permissions and concurrency. The Build archives all accepted intermediate Records and referenced
Artifacts even when no destination path is requested. `get` only makes an optional copy of the
-already archived sole target. The existing `svml.runtime.ts` shows the advanced executable
+already archived named target. The existing `svml.runtime.ts` shows the advanced executable
embedding API and remains supported.
To reuse the paid shot outputs from a verified earlier Build, add two zero-input Build Record
diff --git a/packages/cli/src/archive.ts b/packages/cli/src/archive.ts
index ef1b64e9..871a46c5 100644
--- a/packages/cli/src/archive.ts
+++ b/packages/cli/src/archive.ts
@@ -205,3 +205,19 @@ export function inspectBuild(state: BuildState, catalog?: BuildCatalogEntry) {
}),
};
}
+
+/** Compact Host presentation for routine list/status output. Detailed aliases belong to inspect. */
+export function summarizeBuildCatalog(catalog: BuildCatalogEntry, state?: BuildState) {
+ const targetOutputs = new Set(state?.request.targets.map((target) => target.output) ?? []);
+ const targetRecords = new Set(state?.plan.goals.map((goal) => goal.record) ?? []);
+ return {
+ source: catalog.source,
+ ...(catalog.run === undefined ? {} : { run: catalog.run }),
+ aliasCount: catalog.aliases.length,
+ targets: catalog.aliases
+ .filter((alias) => alias.ref.kind === "logical-output"
+ ? targetOutputs.has(alias.ref.id)
+ : targetRecords.has(alias.ref.id))
+ .map((alias) => alias.name),
+ };
+}
diff --git a/packages/cli/src/main.ts b/packages/cli/src/main.ts
index 28ef4c94..e924a088 100644
--- a/packages/cli/src/main.ts
+++ b/packages/cli/src/main.ts
@@ -22,6 +22,7 @@ import {
materializeArtifact,
materializeRecord,
selectArchivedRecord,
+ summarizeBuildCatalog,
} from "./archive.js";
import { loadRunFile } from "./run-file.js";
import { createOfficialRuntimeFromConfig } from "./runtime-config.js";
@@ -316,9 +317,7 @@ export async function runCli(argv: readonly string[], io: CliIo): Promise<void>
createdAt: entry.createdAt,
updatedAt: entry.updatedAt,
status: status.build?.state.status,
- source: entry.source,
- ...(entry.run === undefined ? {} : { run: entry.run }),
- outputs: entry.aliases.map((alias) => alias.name),
+ ...summarizeBuildCatalog(entry, status.build?.state),
};
}));
io.write(`${JSON.stringify({ builds }, null, 2)}\n`);
@@ -332,7 +331,9 @@ export async function runCli(argv: readonly string[], io: CliIo): Promise<void>
status: status.build.state.status,
diagnostics: status.build.state.diagnostics,
},
- catalog: status.catalog,
+ catalog: status.catalog === undefined
+ ? undefined
+ : summarizeBuildCatalog(status.catalog, status.build?.state),
operations: status.operations.map((operation) => ({
id: operation.id,
command: operation.command,
diff --git a/packages/cli/test/cli.test.ts b/packages/cli/test/cli.test.ts
index 7217026a..bbf0130e 100644
--- a/packages/cli/test/cli.test.ts
+++ b/packages/cli/test/cli.test.ts
@@ -555,7 +555,13 @@ export default {
let buildsOutput = "";
await runCli(["builds", "--runtime", runtimePath], { write: (text) => { buildsOutput += text; } });
- const listed = JSON.parse(buildsOutput) as { readonly builds: readonly { readonly build: string; readonly outputs: readonly string[] }[] };
+ const listed = JSON.parse(buildsOutput) as {
+ readonly builds: readonly {
+ readonly build: string;
+ readonly aliasCount: number;
+ readonly targets: readonly string[];
+ }[];
+ };
assert.deepEqual(listed.builds, [{
build: "archive-1",
core: buildDigest,
@@ -564,9 +570,24 @@ export default {
status: "active",
source: catalog.source,
run: catalog.run,
- outputs: ["final.video", "timing.rawEvidence"],
+ aliasCount: 2,
+ targets: ["final.video"],
}]);
+ let statusOutput = "";
+ await runCli(["status", "archive-1", "--runtime", runtimePath], {
+ write: (text) => { statusOutput += text; },
+ });
+ const status = JSON.parse(statusOutput) as {
+ readonly catalog: { readonly aliasCount: number; readonly targets: readonly string[] };
+ };
+ assert.deepEqual(status.catalog, {
+ source: catalog.source,
+ run: catalog.run,
+ aliasCount: 2,
+ targets: ["final.video"],
+ });
+
let getOutput = "";
await runCli([
"get", "archive-1", "--runtime", runtimePath,
diff --git a/packages/gemini-omni/README.md b/packages/gemini-omni/README.md
new file mode 100644
index 00000000..1c45e724
--- /dev/null
+++ b/packages/gemini-omni/README.md
@@ -0,0 +1,10 @@
+# `@svml/gemini-omni`
+
+Exact author/compute contract for Gemini Omni video generation.
+
+It defines one `video` endpoint with duration, aspect ratio, resolution and bounded image, opaque
+audio, video-range and character references. It validates and seals requests, then emits the
+provider-neutral `GeneratedVideoSet` contract from `@svml/generation`.
+
+The package does not call an API. `@svml/provider-kie` is one separately selected Runtime Endpoint
+implementation; another Provider can implement the same exact capability without changing Core.
diff --git a/packages/generation/README.md b/packages/generation/README.md
new file mode 100644
index 00000000..75d8392f
--- /dev/null
+++ b/packages/generation/README.md
@@ -0,0 +1,11 @@
+# `@svml/generation`
+
+Provider-neutral generated-media contracts shared by exact image and video model packages.
+
+The package owns `GenerationRequest`, `GeneratedImageSet` and `GeneratedVideoSet` identities,
+schemas, validators and graph facets. Generated sets are atomic Products: a Provider persists the
+returned bytes in an ArtifactStore and returns typed Blob references rather than transient URLs.
+
+This package does not choose a model, Provider, credential, queue or retry policy. Model packages
+declare exact request Capabilities; Endpoint packages such as `@svml/provider-kie` implement those
+Capabilities in a selected Runtime Profile.
diff --git a/packages/gpt-image/README.md b/packages/gpt-image/README.md
new file mode 100644
index 00000000..0c298d9a
--- /dev/null
+++ b/packages/gpt-image/README.md
@@ -0,0 +1,8 @@
+# `@svml/gpt-image`
+
+Exact author/compute contracts for GPT Image 2 text-to-image and image-to-image requests.
+
+The two modes are separate graph endpoints with mode-specific validation and a common
+provider-neutral `GeneratedImageSet` result. The package owns model semantics but no API key,
+Provider selection, queue or network code. `@svml/provider-kie` is one optional Runtime
+implementation.
diff --git a/packages/grok-imagine/README.md b/packages/grok-imagine/README.md
new file mode 100644
index 00000000..1f8a5b34
--- /dev/null
+++ b/packages/grok-imagine/README.md
@@ -0,0 +1,8 @@
+# `@svml/grok-imagine`
+
+Exact author/compute contracts for Grok Imagine video generation.
+
+It exposes distinct text, image and 1.5-preview endpoints. Each request is nominally typed and
+validated before yielding a provider-neutral `GeneratedVideoSet`. The package declares the model
+choice; it does not route to another model or access a Provider. `@svml/provider-kie` is one
+optional Runtime implementation.
diff --git a/packages/minimax-h3/README.md b/packages/minimax-h3/README.md
new file mode 100644
index 00000000..7ac43cbb
--- /dev/null
+++ b/packages/minimax-h3/README.md
@@ -0,0 +1,8 @@
+# `@svml/minimax-h3`
+
+Exact author/compute contracts for MiniMax H3 video generation.
+
+Text, first/last-frame and subject-reference modes are separate endpoints rather than one dynamic
+port mode. Each returns a provider-neutral `GeneratedVideoSet`. This package owns request semantics
+and validation only; Provider calls, credentials, retries and queueing belong to a Runtime Endpoint
+such as `@svml/provider-kie`.
diff --git a/packages/model-kit/README.md b/packages/model-kit/README.md
new file mode 100644
index 00000000..87b2e638
--- /dev/null
+++ b/packages/model-kit/README.md
@@ -0,0 +1,10 @@
+# `@svml/model-kit`
+
+Author-model package helper for defining exact generated-media requests without repeating the
+nominal Type → Producer → Need → Graph Fragment shell.
+
+`defineExactModelModule` does not make model requests generic. The calling package still owns its
+exact fields, constraints, model identity, capability name and validator. The helper adds no
+Provider routing, fallback, credentials or Runtime authority.
+
+This is a package-authoring utility, not an author-importable model by itself.
diff --git a/packages/nano-banana/README.md b/packages/nano-banana/README.md
new file mode 100644
index 00000000..7ccfad82
--- /dev/null
+++ b/packages/nano-banana/README.md
@@ -0,0 +1,7 @@
+# `@svml/nano-banana`
+
+Exact author/compute contracts for Nano Banana 2 and Nano Banana Pro image generation.
+
+The model variants are separate endpoints with exact request validation and a common
+provider-neutral `GeneratedImageSet` result. The package contains no Provider selection, API key or
+network execution. `@svml/provider-kie` is one optional Runtime implementation.
diff --git a/packages/package-loader-node/README.md b/packages/package-loader-node/README.md
index e90a2443..e7cf2315 100644
--- a/packages/package-loader-node/README.md
+++ b/packages/package-loader-node/README.md
@@ -5,6 +5,11 @@ package lock binds every selected physical package and declared dependency byte
Frontend, Text Surface, Producer and Type Validator identities. Loading verifies all artifacts and
checks compute facets against their static Manifests before granting a Host registry.
+The current convenience assembly always installs the official `@svml/text` entry Frontend and Text
+Surface registry. Its lock/verification rules are domain-neutral, but its assembled compiler is a
+Text-authoring Node Host. Core and `@svml/compiler-node` do not require Text; this package must be
+split or named more narrowly before claiming a frontend-neutral public loader.
+
This package is deliberately not an npm client and does not activate Provider or privileged Runtime
services. Source `<import>` can select only an already activated author module; trusted deployment
configuration independently chooses whether to grant author or deterministic compute registries.
diff --git a/packages/seedream/README.md b/packages/seedream/README.md
new file mode 100644
index 00000000..66796adb
--- /dev/null
+++ b/packages/seedream/README.md
@@ -0,0 +1,7 @@
+# `@svml/seedream`
+
+Exact author/compute contracts for Seedream 5 Lite text-to-image and image-to-image generation.
+
+The two modes are separate endpoints and return the provider-neutral `GeneratedImageSet` contract.
+This package defines what the author requested, not where it runs: API translation, credentials,
+retry and queue behavior belong to a selected Runtime Endpoint such as `@svml/provider-kie`.