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: align engineering records with implemented system
kashorin7904eb50371d
diff --git a/README.md b/README.mdindex d30a2036..c3f84fa9 100644--- a/README.md+++ b/README.md@@ -73,11 +73,12 @@ The repository implements:- three exact MiMo TTS models, independently reached through Xiaomi's official Provider;- local ffprobe/ffmpeg media processing;- S3 multipart Artifact streaming and AWS Lambda media processing;-- local pinned WhisperX service;+- managed warm local WhisperX service;- Vertex Gemini display-only Caption planning;- local frame-parallel HyperFrames rendering;- recoverable Step Functions/Lambda HyperFrames rendering;-- Speech, Caption, Text, B-roll, Film, audio and final mux vertical slices.+- Speech, Fine Caption, Typography, Media Item/Sequence, Deck, Ranking, Comment Sticker, Audio and+ Screen Overlay packages lowering to peer Tracks, followed by Film, HyperFrames and final mux.The complete live path is:@@ -187,9 +188,9 @@ packages/run syntax-neutral Run Source closure and complete Run Grappackages/run-markup optional official human-readable Run Frontendpackages/runtime environment-neutral scheduling and Store portspackages/driver-node trusted Node command execution-packages/local zero-service SQLite/filesystem developer assembly+packages/local in-process SQLite/filesystem developer assemblypackages/* optional Frontend, domain, Endpoint and adapter packages-services/whisperx pinned local WhisperX sidecar+services/whisperx managed warm local WhisperX External Servicespec current normative contractsdocs architecture, status, roadmap and focused implementation recordsexamples source-closure checks and the live acceptance witness@@ -211,11 +212,10 @@ pnpm smoke:kie # opt-in paid Provider smoke test; requires credentials## Current priorities-The domain-neutral Run/Runtime foundation, developer inspection path and replaceable local/AWS-Endpoint environments are implemented. Current work is split between preparing trusted-developer-distribution and completing the video-domain packages needed by real deliveries. Fresh generation,-historical reuse and previews remain ordinary explicit `.svrun` choices rather than a second-workflow layer. Caption, exact Audio and self-contained Screen Overlay execute; Text and Media-remain vertical slices, while their full visual breadth, Deck, Ranking and the final video-compatibility freeze remain active work. See the+The domain-neutral Run/Runtime foundation, developer inspection path, replaceable local/AWS+Endpoint environments and current pre-release video packages are implemented. Current work is+delivery-driven correction, deployment hardening and preparing a source-checkout project for its+first public package release. Fresh generation, historical reuse and previews remain ordinary+explicit `.svrun` choices rather than a second workflow layer. The repository-internal Track and+Visual IR waist is frozen; author-facing video Surfaces remain pre-release. See the[implementation status](docs/implementation-status.md) and [roadmap](docs/roadmap.md).diff --git a/docs/README.md b/docs/README.mdindex 1f84c67a..a3edcab5 100644--- a/docs/README.md+++ b/docs/README.md@@ -9,8 +9,8 @@ the working tree contains only documents that should inform current implementati2. [`architecture.md`](./architecture.md) — current Author Graph, Run Graph, Satisfaction, Runtimeand package boundaries.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.+4. [`roadmap.md`](./roadmap.md) — active domain-neutral, environment/Provider and delivery-driven+ video-package work.5. [`open-source-distribution.md`](./open-source-distribution.md) — what can ship independently,current packaging truth and public-release gates.6. [`../spec/core-kernel.md`](../spec/core-kernel.md) — compact normative Kernel laws for the@@ -51,7 +51,7 @@ the working tree contains only documents that should inform current implementati- [`../spec/typography-track.md`](../spec/typography-track.md) — complete two-dimensional Text model, old-systemand editor attack audit, terminal-IR gaps and Caption feedback.- [`../spec/ranking-track.md`](../spec/ranking-track.md) — old Ranking audit, separate official- components, triggered group schedule and renderer-neutral migration plan.+ components, triggered group schedule and executable renderer-neutral lowering.- [`../spec/media-track.md`](../spec/media-track.md) — unified Item/Sequence media model, orderedlayers, playback, motion, internal handoffs, audio projection and Speech reuse.- [`../spec/deck-track.md`](../spec/deck-track.md) — independent depth-stack Deck Track, collectiondiff --git a/examples/talking-film-golden/README.md b/examples/talking-film-golden/README.mdindex c941c126..f98c89fb 100644--- a/examples/talking-film-golden/README.md+++ b/examples/talking-film-golden/README.md@@ -76,10 +76,10 @@ Candidates and Operations.| `caption-fine:Style` / `caption:Program` | Fine + common Caption | explicit default over all words + ordered whole-Style replacement by Role or word subset | implemented || `caption-ai:Planner` | `@narratage/caption-gemini` | immutable display Atoms/Words + per-run requirements -> whole-Atom Cue cuts and optional per-Word fields | implemented; Google Vertex Endpoint implemented separately || `caption-fine:Track` | `@narratage/caption-fine` | CaptionPlan + independent SemanticMap + complete Fine Styles -> VisualTrack | implemented |-| `text:Track` | `@narratage/typography-track` | package Spec + ProgramSpace -> VisualTrack | provider-free Surface/lowering implemented; exact-font use remains |+| `text:Track` | `@narratage/typography-track` | package Spec + ProgramSpace -> VisualTrack | provider-free Surface/lowering and exact `fonts-open` stack implemented || `film:Film` | `@narratage/film` | finite TrackSet fold -> Composition | Graph Fragment and official Surface implemented || `render:Video` | `@narratage/render-hyperframes` | Composition -> silent HyperframesDocument render + explicit program audio + mux -> final video Artifact + Receipt | Surface, Fragment and all local execution Providers implemented |-| `studio.svs` | `@narratage/svs` | generic immutable Recipe Records; consuming packages validate and lower them | parser, imports and current package consumers implemented; exact font assets remain |+| `studio.svs` | `@narratage/svs` | generic immutable Recipe Records; consuming packages validate and lower them | parser, imports and current package consumers implemented; fonts are separate explicit graph values |The remaining work is intentionally package-local. None of these rows requires a new Core video type,a component-family registry in Core, a privileged Film root or another Track kind.diff --git a/examples/talking-film-graph-check/svml.packages.lock b/examples/talking-film-graph-check/svml.packages.lockindex 1e4217ab..b0126fd8 100644--- a/examples/talking-film-graph-check/svml.packages.lock+++ b/examples/talking-film-graph-check/svml.packages.lock@@ -619,7 +619,7 @@{"name": "@narratage/media-pipeline","version": "0.0.0-dev",- "digest": "sha256:8394a4c3b09699048bf23f40e348858a5e52ebaa2c7c1bbe16eb3df946a8139c"+ "digest": "sha256:1e7d4aeab2baf6a36a3f89e87fbcc25e287ce120f087d163b307a7221a38c5e6"},{"name": "@narratage/media-track",@@ -850,7 +850,7 @@"version": "0.0.0-dev"},"facetsDigest": "sha256:d42e3034775755a1da5c41d7fee274c6d04f7519f5e0fb52a4d62e2b189f5274",- "closureDigest": "sha256:451be772203278d064ec63b3efd3f82cfacb45917cf67a52e08417c057932629"+ "closureDigest": "sha256:43480420be3cc687ba5e33ccbd59e0f8d4b3342c7ef17e99aca2d10f81a7d424"},{"specifier": "@narratage/media-track",@@ -886,7 +886,7 @@"version": "0.0.0-dev"},"facetsDigest": "sha256:6e91e842a7306e4840bfc5b98a1bb328d78b7c0a04b8734dc8d3a0bd3b481a30",- "closureDigest": "sha256:a631ae0d85a64e11a5613ae6262ceb8c027e480b90389b5d1e717792f537687e"+ "closureDigest": "sha256:832e5a76a7236bf5e29b52afbc163cbd0a696058aee874dad248509777efedbe"},{"specifier": "@narratage/run-markup",@@ -976,7 +976,7 @@"version": "0.0.0-dev"},"facetsDigest": "sha256:f497578707222b4a310b4561ee60cc6f76967c2a8b296df295d85fd5f09a057a",- "closureDigest": "sha256:e8b39ab5d64e8d81bf4e03a50024f8ec82389e8aa9a7d056e9587a6fa5f92f2a"+ "closureDigest": "sha256:43bd731c8f901eb9780fc50699db950ac3277e0dc49a267ed28fda9ea3654ed9"},{"specifier": "@narratage/svs",@@ -1030,8 +1030,8 @@"version": "0.0.0-dev"},"facetsDigest": "sha256:5d82bc1ffa3841d795792edfdfc3ad45d26162edc65bd8bed2edaf6cd240ed76",- "closureDigest": "sha256:d5c2b093afe55bd0441a7ea1a614629fce15bbae796497794a4dee2b4c979e54"+ "closureDigest": "sha256:6cf01887a8a128de0865c008804911e78c9ab10b2b2eb8e8ca7d307527ff7d5c"}],- "digest": "sha256:1cbafbf8d879d9ebcb4b008928919c40d7d00158c97ba316ef638f61c03daaf5"+ "digest": "sha256:948295067a2fe8fe1b41cf37d8d62f6b2ad5e4d6d3581c1db730a757e3cd29b6"}diff --git a/examples/talking-film-live/README.md b/examples/talking-film-live/README.mdindex da2f63ad..ec24fa8f 100644--- a/examples/talking-film-live/README.md+++ b/examples/talking-film-live/README.md@@ -19,7 +19,7 @@ Prerequisites for the exact checked-in Runtime Profile:- `GOOGLE_CLOUD_PROJECT` naming a project with Vertex AI enabled;- `GOOGLE_APPLICATION_CREDENTIALS_JSON` containing the credential JSON, not a committed path orsecret file;-- `ffmpeg`, `ffprobe`, Chrome/HyperFrames and the prepared local WhisperX sidecar.+- `ffmpeg`, `ffprobe`, Chrome/HyperFrames and the prepared managed local WhisperX service.Prepare and health-check WhisperX as described in[`../../services/whisperx/README.md`](../../services/whisperx/README.md). `narratage check` validatesdiff --git a/examples/talking-film-live/svml.packages.lock b/examples/talking-film-live/svml.packages.lockindex 064c671e..ef7e2359 100644--- a/examples/talking-film-live/svml.packages.lock+++ b/examples/talking-film-live/svml.packages.lock@@ -624,7 +624,7 @@{"name": "@narratage/media-pipeline","version": "0.0.0-dev",- "digest": "sha256:8394a4c3b09699048bf23f40e348858a5e52ebaa2c7c1bbe16eb3df946a8139c"+ "digest": "sha256:1e7d4aeab2baf6a36a3f89e87fbcc25e287ce120f087d163b307a7221a38c5e6"},{"name": "@narratage/media-track",@@ -869,7 +869,7 @@"version": "0.0.0-dev"},"facetsDigest": "sha256:d42e3034775755a1da5c41d7fee274c6d04f7519f5e0fb52a4d62e2b189f5274",- "closureDigest": "sha256:451be772203278d064ec63b3efd3f82cfacb45917cf67a52e08417c057932629"+ "closureDigest": "sha256:43480420be3cc687ba5e33ccbd59e0f8d4b3342c7ef17e99aca2d10f81a7d424"},{"specifier": "@narratage/media-track",@@ -905,7 +905,7 @@"version": "0.0.0-dev"},"facetsDigest": "sha256:6e91e842a7306e4840bfc5b98a1bb328d78b7c0a04b8734dc8d3a0bd3b481a30",- "closureDigest": "sha256:a631ae0d85a64e11a5613ae6262ceb8c027e480b90389b5d1e717792f537687e"+ "closureDigest": "sha256:832e5a76a7236bf5e29b52afbc163cbd0a696058aee874dad248509777efedbe"},{"specifier": "@narratage/run-markup",@@ -995,7 +995,7 @@"version": "0.0.0-dev"},"facetsDigest": "sha256:f497578707222b4a310b4561ee60cc6f76967c2a8b296df295d85fd5f09a057a",- "closureDigest": "sha256:e8b39ab5d64e8d81bf4e03a50024f8ec82389e8aa9a7d056e9587a6fa5f92f2a"+ "closureDigest": "sha256:43bd731c8f901eb9780fc50699db950ac3277e0dc49a267ed28fda9ea3654ed9"},{"specifier": "@narratage/svs",@@ -1049,8 +1049,8 @@"version": "0.0.0-dev"},"facetsDigest": "sha256:5d82bc1ffa3841d795792edfdfc3ad45d26162edc65bd8bed2edaf6cd240ed76",- "closureDigest": "sha256:d5c2b093afe55bd0441a7ea1a614629fce15bbae796497794a4dee2b4c979e54"+ "closureDigest": "sha256:6cf01887a8a128de0865c008804911e78c9ab10b2b2eb8e8ca7d307527ff7d5c"}],- "digest": "sha256:a61026c5834c98ccb9860a45a679bc82408cd4f64d68332b8b7d67a61a60c2a4"+ "digest": "sha256:bc963243cd4b28ad43e04660c5d92d5a1a2b3f8281621cdc3a1915eefed9c0fd"}diff --git a/examples/talking-film-live/svml.runtime-packages.lock b/examples/talking-film-live/svml.runtime-packages.lockindex bce286e1..143507fc 100644--- a/examples/talking-film-live/svml.runtime-packages.lock+++ b/examples/talking-film-live/svml.runtime-packages.lock@@ -99,7 +99,7 @@{"name": "@narratage/media-pipeline","version": "0.0.0-dev",- "digest": "sha256:8394a4c3b09699048bf23f40e348858a5e52ebaa2c7c1bbe16eb3df946a8139c"+ "digest": "sha256:1e7d4aeab2baf6a36a3f89e87fbcc25e287ce120f087d163b307a7221a38c5e6"},{"name": "@narratage/media",@@ -144,7 +144,7 @@{"name": "@narratage/provider-whisperx-local","version": "0.0.0-dev",- "digest": "sha256:debcae78e6911a98bd3abf0ffaa6e22a5fe20cac0372eb28f0ac8fb8e24c5d65"+ "digest": "sha256:2aea383b431858033dd8a27ede705d99cbafb3d55cce0971c7bca09af20d3df2"},{"name": "@narratage/render-hyperframes",@@ -879,7 +879,7 @@"version": "0.0.0-dev"},"facetsDigest": "sha256:b14b721bdc0c9d5d9ced1c345107c92a3a5878f3383dea2ecd3e310442c2a40c",- "closureDigest": "sha256:08c58ec73f6d4aa7bf210ab2fd53c904171fc9d8489e190c72a06cf687a1a128"+ "closureDigest": "sha256:809fb41176bafd674f0875c47314e4ebaa46fe0993adc1cc460dfc88b16af317"},{"specifier": "@narratage/provider-kie",@@ -897,7 +897,7 @@"version": "0.0.0-dev"},"facetsDigest": "sha256:701abcc923bf8a711c20b6e308d8cc8be27bf560f249b8c5a801e1dbd9cb3979",- "closureDigest": "sha256:c1fa50524692077ce52f4f6800837fd5c022335bbd61d87163a41872060e8e52"+ "closureDigest": "sha256:470fe327b8ffc5d43dd31d22c7c699e3a76e0bdc14e1f8d0bb5609df136a77d1"},{"specifier": "@narratage/provider-whisperx-local",@@ -906,8 +906,8 @@"version": "0.0.0-dev"},"facetsDigest": "sha256:3686b84c42cc2b1bcaccf57cbdcda25a15c7d9d3778fb92d25437f9880ed8f5d",- "closureDigest": "sha256:e89dccda3bf1410e9ac0a39aa51831bd1423318b4e005093e0d35084949218b6"+ "closureDigest": "sha256:daa223d9c0864dc2efa428d87f98d4927b452d379a27289f8f8a5a9ee3591bec"}],- "digest": "sha256:c66fb23f7c7c0906f4e99028600d2ba20394f446f579df4f69c6616e9bf2f289"+ "digest": "sha256:70e892eed31df5635f55517993da1120fe280d85ea8d7c9e082e2089b72e9de7"}diff --git a/examples/talking-head-aroll/README.md b/examples/talking-head-aroll/README.mdindex 11fc0345..41f4e4ef 100644--- a/examples/talking-head-aroll/README.md+++ b/examples/talking-head-aroll/README.md@@ -83,7 +83,7 @@ pnpm narratage plan examples/talking-head-aroll/build.svrun \--root .```-Build the complete film after starting the local WhisperX sidecar and exposing `KIE_API_KEY`,+Build the complete film after preparing the managed local WhisperX service and exposing `KIE_API_KEY`,`GOOGLE_CLOUD_PROJECT` and `GOOGLE_APPLICATION_CREDENTIALS_JSON`:```shdiff --git a/examples/talking-head-aroll/svml.packages.lock b/examples/talking-head-aroll/svml.packages.lockindex 7d1542ad..a6f259a4 100644--- a/examples/talking-head-aroll/svml.packages.lock+++ b/examples/talking-head-aroll/svml.packages.lock@@ -624,7 +624,7 @@{"name": "@narratage/media-pipeline","version": "0.0.0-dev",- "digest": "sha256:8394a4c3b09699048bf23f40e348858a5e52ebaa2c7c1bbe16eb3df946a8139c"+ "digest": "sha256:1e7d4aeab2baf6a36a3f89e87fbcc25e287ce120f087d163b307a7221a38c5e6"},{"name": "@narratage/media-track",@@ -864,7 +864,7 @@"version": "0.0.0-dev"},"facetsDigest": "sha256:d42e3034775755a1da5c41d7fee274c6d04f7519f5e0fb52a4d62e2b189f5274",- "closureDigest": "sha256:451be772203278d064ec63b3efd3f82cfacb45917cf67a52e08417c057932629"+ "closureDigest": "sha256:43480420be3cc687ba5e33ccbd59e0f8d4b3342c7ef17e99aca2d10f81a7d424"},{"specifier": "@narratage/narrative",@@ -891,7 +891,7 @@"version": "0.0.0-dev"},"facetsDigest": "sha256:6e91e842a7306e4840bfc5b98a1bb328d78b7c0a04b8734dc8d3a0bd3b481a30",- "closureDigest": "sha256:a631ae0d85a64e11a5613ae6262ceb8c027e480b90389b5d1e717792f537687e"+ "closureDigest": "sha256:832e5a76a7236bf5e29b52afbc163cbd0a696058aee874dad248509777efedbe"},{"specifier": "@narratage/run-markup",@@ -981,7 +981,7 @@"version": "0.0.0-dev"},"facetsDigest": "sha256:f497578707222b4a310b4561ee60cc6f76967c2a8b296df295d85fd5f09a057a",- "closureDigest": "sha256:e8b39ab5d64e8d81bf4e03a50024f8ec82389e8aa9a7d056e9587a6fa5f92f2a"+ "closureDigest": "sha256:43bd731c8f901eb9780fc50699db950ac3277e0dc49a267ed28fda9ea3654ed9"},{"specifier": "@narratage/svs",@@ -1017,8 +1017,8 @@"version": "0.0.0-dev"},"facetsDigest": "sha256:5d82bc1ffa3841d795792edfdfc3ad45d26162edc65bd8bed2edaf6cd240ed76",- "closureDigest": "sha256:d5c2b093afe55bd0441a7ea1a614629fce15bbae796497794a4dee2b4c979e54"+ "closureDigest": "sha256:6cf01887a8a128de0865c008804911e78c9ab10b2b2eb8e8ca7d307527ff7d5c"}],- "digest": "sha256:fcba312519c09e7239cb25a1dc65627bb2cb7c83dca13640de79dfbd30b1eb71"+ "digest": "sha256:b33bc3d1c4932405c07a5459a5c97a21e8bcf853e6ea99d66da3f302803b0a91"}diff --git a/examples/talking-head-aroll/svml.runtime-packages.lock b/examples/talking-head-aroll/svml.runtime-packages.lockindex bce286e1..143507fc 100644--- a/examples/talking-head-aroll/svml.runtime-packages.lock+++ b/examples/talking-head-aroll/svml.runtime-packages.lock@@ -99,7 +99,7 @@{"name": "@narratage/media-pipeline","version": "0.0.0-dev",- "digest": "sha256:8394a4c3b09699048bf23f40e348858a5e52ebaa2c7c1bbe16eb3df946a8139c"+ "digest": "sha256:1e7d4aeab2baf6a36a3f89e87fbcc25e287ce120f087d163b307a7221a38c5e6"},{"name": "@narratage/media",@@ -144,7 +144,7 @@{"name": "@narratage/provider-whisperx-local","version": "0.0.0-dev",- "digest": "sha256:debcae78e6911a98bd3abf0ffaa6e22a5fe20cac0372eb28f0ac8fb8e24c5d65"+ "digest": "sha256:2aea383b431858033dd8a27ede705d99cbafb3d55cce0971c7bca09af20d3df2"},{"name": "@narratage/render-hyperframes",@@ -879,7 +879,7 @@"version": "0.0.0-dev"},"facetsDigest": "sha256:b14b721bdc0c9d5d9ced1c345107c92a3a5878f3383dea2ecd3e310442c2a40c",- "closureDigest": "sha256:08c58ec73f6d4aa7bf210ab2fd53c904171fc9d8489e190c72a06cf687a1a128"+ "closureDigest": "sha256:809fb41176bafd674f0875c47314e4ebaa46fe0993adc1cc460dfc88b16af317"},{"specifier": "@narratage/provider-kie",@@ -897,7 +897,7 @@"version": "0.0.0-dev"},"facetsDigest": "sha256:701abcc923bf8a711c20b6e308d8cc8be27bf560f249b8c5a801e1dbd9cb3979",- "closureDigest": "sha256:c1fa50524692077ce52f4f6800837fd5c022335bbd61d87163a41872060e8e52"+ "closureDigest": "sha256:470fe327b8ffc5d43dd31d22c7c699e3a76e0bdc14e1f8d0bb5609df136a77d1"},{"specifier": "@narratage/provider-whisperx-local",@@ -906,8 +906,8 @@"version": "0.0.0-dev"},"facetsDigest": "sha256:3686b84c42cc2b1bcaccf57cbdcda25a15c7d9d3778fb92d25437f9880ed8f5d",- "closureDigest": "sha256:e89dccda3bf1410e9ac0a39aa51831bd1423318b4e005093e0d35084949218b6"+ "closureDigest": "sha256:daa223d9c0864dc2efa428d87f98d4927b452d379a27289f8f8a5a9ee3591bec"}],- "digest": "sha256:c66fb23f7c7c0906f4e99028600d2ba20394f446f579df4f69c6616e9bf2f289"+ "digest": "sha256:70e892eed31df5635f55517993da1120fe280d85ea8d7c9e082e2089b72e9de7"}diff --git a/packages/artifact-store-s3/README.md b/packages/artifact-store-s3/README.mdindex 1a242bfb..f1f865e6 100644--- a/packages/artifact-store-s3/README.md+++ b/packages/artifact-store-s3/README.md@@ -9,9 +9,14 @@ Objects use deterministic keys:```Writes use `If-None-Match: *`; an already-existing object is downloaded and digest-verified rather-than trusted by key. Reads always recompute SHA-256. The current port transfers whole objects, so-multipart upload and ranged streaming remain a later ArtifactStore extension rather than hidden-behavior in this adapter.+than trusted by key. Whole-object reads always recompute SHA-256. The AWS client also exposes the+optional streaming and retention facets: streamed writes use multipart upload to an isolated+staging key followed by a server-side copy to the content-addressed key; streamed reads verify the+digest before their iterator completes; `list`/`delete` support explicit reachability GC.++Those optional facets are attached only when an injected client supplies every operation needed to+implement them. A reduced test or MinIO client therefore advertises only the capabilities it can+actually perform instead of failing midway through a Build.```tsconst artifacts = createS3ArtifactStorePackage({diff --git a/packages/local/README.md b/packages/local/README.mdindex 79f40122..1983a9ac 100644--- a/packages/local/README.md+++ b/packages/local/README.md@@ -1,8 +1,9 @@# `@narratage/local`-The trusted, zero-service developer distribution. It keeps Core and the authoritative Build-Scheduler in the current Node process while allowing every capability Endpoint to run in a different-place.+The in-process developer assembly. It keeps Core and the authoritative Build Scheduler in the+current Node process while allowing every capability Endpoint to run in a different place. Loaded+implementation packages are trusted and byte-locked; that trust boundary describes code execution,+not a special class of user.The convenience assembly uses:diff --git a/packages/media-pipeline/README.md b/packages/media-pipeline/README.mdindex 257b05b8..e89e1b99 100644--- a/packages/media-pipeline/README.md+++ b/packages/media-pipeline/README.md@@ -53,5 +53,5 @@ RenderedVisual + TimelineAudio -> mux-program-media Need -> MuxedMediaCompiling an `AudioProgramPlan` is ordinary deterministic code. Reading Artifact bytes, decoding,resampling, mixing, encoding or muxing is never a Producer shortcut: it is an explicit ProviderNeed. The plan fixes exact 48 kHz sample boundaries, gain/fade/playback parameters and the absence-of hidden normalization/limiting. A local FFmpeg Provider and a future Lambda Provider must consume-the same plan and return the same public contracts.+of hidden normalization/limiting. The local FFmpeg and AWS Lambda Providers consume the same shared+execution body and return the same public contracts.diff --git a/packages/provider-whisperx-local/README.md b/packages/provider-whisperx-local/README.mdindex 89dcf157..916d4d1e 100644--- a/packages/provider-whisperx-local/README.md+++ b/packages/provider-whisperx-local/README.md@@ -19,8 +19,9 @@ createLocalWhisperXProvider({```The service must be on loopback because this protocol deliberately passes a local staged path. A-future Lambda/hosted Provider should use an Artifact URL or request payload owned by that Provider;-it is a different deployment package but must return the same `WhisperXAlignmentEvidence` type.+future persistent remote Provider should use an Artifact URL or request payload owned by that+Provider; it is a different deployment package but must return the same+`WhisperXAlignmentEvidence` type. Lambda is deliberately not the target for this warm model.The configured model, device, compute mode, batch size, service version, WhisperX version andsentence-tokenizer data digest are checked through `/health` and contribute to Provider identity.diff --git a/services/media-lambda/README.md b/services/media-lambda/README.mdindex 9d1a5850..60e3bf74 100644--- a/services/media-lambda/README.md+++ b/services/media-lambda/README.md@@ -1,8 +1,8 @@# Narratage media execution service-This service answers the five media Needs — inspect, normalize, speech-evidence projection,-timeline audio and mux — in AWS Lambda. It is deployment state, not an author-importable SVML-package.+This service answers eight media Needs in AWS Lambda: inspect, normalize, transform, extract audio,+extract frame, speech-evidence projection, timeline audio and mux. It is deployment state, not an+author-importable SVML package.It owns no media semantics. `@narratage/media-execution` contains the FFmpeg commands andframe/sample arithmetic shared with `@narratage/provider-media-local`. This directory contributes@@ -100,8 +100,11 @@ meaning because a newer deployment happened.## Live canary-The canary generates a one-second local fixture and runs all five remote media operations. Its S3-prefix is isolated and removed after success or failure unless `NARRATAGE_MEDIA_CANARY_KEEP=1`.+The current deployed canary generates a one-second local fixture and runs the original five remote+media operations: inspect/normalize, speech-evidence projection, timeline audio and mux. The three+newer utility operations use the same tested handler but still need to be added to the live canary+before all eight can be claimed as remotely witnessed. Its S3 prefix is isolated and removed after+success or failure unless `NARRATAGE_MEDIA_CANARY_KEEP=1`.```bashexport NARRATAGE_MEDIA_FUNCTION_ARN=arn:aws:lambda:us-east-1:123456789012:function:narratage-media-dev:1diff --git a/spec/author-surface-binding.md b/spec/author-surface-binding.mdindex dc1fb765..cb27a623 100644--- a/spec/author-surface-binding.md+++ b/spec/author-surface-binding.md@@ -9,7 +9,7 @@ The generic Markup Frontend owns element syntax. A package-owned Surface owns whmeans. SVS owns only its stylesheet syntax and produces generic immutable Recipe records. NeitherMarkup, SVS nor Core owns Caption, Media, Film or another package's property vocabulary.-The missing bridge is compile-time reference inspection: a Surface such as Caption must be able to+The bridge is compile-time reference inspection: a Surface such as Caption must be able toread an explicitly referenced public Recipe and lower it into a nominal `CaptionProgram` before theCore graph is built.diff --git a/spec/deck-track.md b/spec/deck-track.mdindex d0f968fd..3b08a9d6 100644--- a/spec/deck-track.md+++ b/spec/deck-track.md@@ -9,7 +9,7 @@ define a universal Deck protocol.A Deck is not a Media Item mode and is not the third primitive of Media Track. It is a higher-ordervisual component whose members happen to use media material.-The first official implementation is provisionally `@narratage/deck-track`. Its honest author+The first official implementation is `@narratage/deck-track`. Its honest authormeaning is a **depth-stack Deck**:```textdiff --git a/spec/media-track.md b/spec/media-track.mdindex 48085769..d0da6ab8 100644--- a/spec/media-track.md+++ b/spec/media-track.md@@ -25,7 +25,7 @@ optional owned pairwise replacement relationshipoptional explicit audio projection```-They belong in one video-domain package, provisionally `@narratage/media-track`, and all lower to+They belong in one video-domain package, `@narratage/media-track`, and all lower toordinary peer `VisualTrack` and, only when explicitly authored, `AudioTrack` values.One package does not mean one conditional super-component. The author Surface exposes twodiff --git a/spec/ranking-track.md b/spec/ranking-track.mdindex 13c7241c..af50845a 100644--- a/spec/ranking-track.md+++ b/spec/ranking-track.md@@ -58,7 +58,7 @@ Migration preserves the useful visual capabilities, not these accidental semanti## 3. Author-facing shape-The exact XML spelling will be fixed with the temporal Surface parser. The intended shape is:+The executable author Surface is:```svml<import as="ranking" from="@narratage/ranking@1"/>diff --git a/spec/spatial-layout.md b/spec/spatial-layout.mdindex 072993ab..cced73b1 100644--- a/spec/spatial-layout.md+++ b/spec/spatial-layout.md@@ -2,8 +2,9 @@Status: executable foundational authority for shared Spatial geometry. `@narratage/spatial`implements CanvasSpace, Frame/Point/Path, IntrinsicExtent, ContentFit and pure fitting; Film now-consumes the same explicit CanvasSpace as Track layout. Text, Media and all four Ranking migration-witnesses execute; only the final shared Visual IR compatibility audit and public ABI freeze remain.+consumes the same explicit CanvasSpace as Track layout. Text, Media and all four Ranking witnesses+execute, and the repository-internal Visual IR compatibility audit passes. Public package ABI+publication remains separate.## 1. Conclusion@@ -47,7 +48,7 @@ the same Artifact. There is no single global "inner frame" shared by every layer## 2. Boundary-The focused video-domain package is provisionally named `@narratage/spatial`. It owns pure types,+The focused video-domain package is `@narratage/spatial`. It owns pure types,validators, author Surfaces for reusable geometry and deterministic geometry Producers. It does notown:diff --git a/spec/track-authoring.md b/spec/track-authoring.mdindex aea28044..e1621aa7 100644--- a/spec/track-authoring.md+++ b/spec/track-authoring.md@@ -1,6 +1,6 @@# SVML Video Track Authoring Model-Status: executable temporal authority for the next official Track-package migration. The focused+Status: executable temporal authority shared by the official Track packages. The focused`@narratage/temporal` package implements strict occurrence expansion, exact rational windowprojection and triggered sibling schedules. Shared Spatial, Text, Ranking, Media,Audio and Screen Overlay are now specified in [`spatial-layout.md`](./spatial-layout.md),@@ -170,8 +170,8 @@ repeating an occurrence-invariant projection would otherwise manufacture identic## 4. Occurrence expansion is strict and precedes projection-The old shape `{ kind: "single", cardinality: "exactly_one" }` repeats one fact twice. The new-contract should have two non-overlapping choices, provisionally named:+The old shape `{ kind: "single", cardinality: "exactly_one" }` repeats one fact twice. The executable+contract has two non-overlapping choices:```tstype OccurrenceExpansion =@@ -179,8 +179,8 @@ type OccurrenceExpansion =| { readonly kind: "each" };```-`each` means compile-time expansion, not media looping. The final author spelling may use-`for-each` if that avoids confusion with playback terminology.+`each` means compile-time expansion, not media looping. Author Surfaces expose it through their+own explicit occurrence setting and lower to this exact value.### `one`@@ -393,8 +393,8 @@ The former umbrella `contracts` package is intentionally absent. Nominal sharedby focused modules such as Narrative, ProgramSpace, Media and Composition; Core has no registry ofvideo-domain unions.-The temporal algebra in this document should therefore become a focused video-domain package,-provisionally `@narratage/temporal`. It should own the projection types, validators and pure+The temporal algebra in this document is implemented by the focused video-domain package+`@narratage/temporal`. It owns the projection types, validators and pureframe-window projection. It may consume Narrative point references, SemanticMap location andProgramSpace, but it must not know Text, Media Track, Ranking, Comment Sticker, Film, HyperFrames,Runtime or a Provider.@@ -417,11 +417,11 @@ structural cuts are Narrative Selection consumption.## 8. Migration consequences-The current simple `typography-track` Surface still supports only `during="full"` or an identity-Selection mapping. It must not independently grow another timing enum. Its rewrite must consume the-shared temporal package. Media Track already consumes that package for Item and Sequence timing.+The current `typography-track` Surface consumes the shared temporal package for Program, Selection+and Moment bindings, explicit point expressions and `one`/`each` expansion. It does not maintain a+second timing enum. Media Track consumes the same package for Item and Sequence timing.-The first implementation batch must include tests for:+The executable acceptance coverage includes:- Selection and Moment `one` success and cardinality failure;- Selection and Moment `each`, stable occurrence identity and source-order preservation;diff --git a/spec/typography-track.md b/spec/typography-track.mdindex 216b3247..cae9ea42 100644--- a/spec/typography-track.md+++ b/spec/typography-track.md@@ -441,7 +441,8 @@ or package-owned resolved geometry used to materialize a Surface.## 11. Terminal Visual IR findings-The candidate `svml.visual-ir@1` now carries the smallest additions proven by this migration:+The frozen repository-internal `svml.visual-ir@1` carries the smallest additions proven by this+migration:- `text-flow` owns the bounded rich document, exact typography, ordered Paint and sequence values;- `path-text` owns typed vector commands and exact path-flow facts;