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: align engineering records with implemented system

kashorin7904eb50371d
diff --git a/README.md b/README.md
index 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 Grap
packages/run-markup optional official human-readable Run Frontend
packages/runtime environment-neutral scheduling and Store ports
packages/driver-node trusted Node command execution
-packages/local zero-service SQLite/filesystem developer assembly
+packages/local in-process SQLite/filesystem developer assembly
packages/* optional Frontend, domain, Endpoint and adapter packages
-services/whisperx pinned local WhisperX sidecar
+services/whisperx managed warm local WhisperX External Service
spec current normative contracts
docs architecture, status, roadmap and focused implementation records
examples 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.md
index 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 implementati
2. [`architecture.md`](./architecture.md) — current Author Graph, Run Graph, Satisfaction, Runtime
and 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-system
and 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, ordered
layers, playback, motion, internal handoffs, audio projection and Speech reuse.
- [`../spec/deck-track.md`](../spec/deck-track.md) — independent depth-stack Deck Track, collection
diff --git a/examples/talking-film-golden/README.md b/examples/talking-film-golden/README.md
index 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.lock
index 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.md
index 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 or
secret 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` validates
diff --git a/examples/talking-film-live/svml.packages.lock b/examples/talking-film-live/svml.packages.lock
index 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.lock
index 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.md
index 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`:
```sh
diff --git a/examples/talking-head-aroll/svml.packages.lock b/examples/talking-head-aroll/svml.packages.lock
index 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.lock
index 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.md
index 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.
```ts
const artifacts = createS3ArtifactStorePackage({
diff --git a/packages/local/README.md b/packages/local/README.md
index 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.md
index 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 -> MuxedMedia
Compiling an `AudioProgramPlan` is ordinary deterministic code. Reading Artifact bytes, decoding,
resampling, mixing, encoding or muxing is never a Producer shortcut: it is an explicit Provider
Need. 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.md
index 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 and
sentence-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.md
index 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 and
frame/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`.
```bash
export NARRATAGE_MEDIA_FUNCTION_ARN=arn:aws:lambda:us-east-1:123456789012:function:narratage-media-dev:1
diff --git a/spec/author-surface-binding.md b/spec/author-surface-binding.md
index 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 wh
means. SVS owns only its stylesheet syntax and produces generic immutable Recipe records. Neither
Markup, 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 to
read an explicitly referenced public Recipe and lower it into a nominal `CaptionProgram` before the
Core graph is built.
diff --git a/spec/deck-track.md b/spec/deck-track.md
index 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-order
visual 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 author
meaning is a **depth-stack Deck**:
```text
diff --git a/spec/media-track.md b/spec/media-track.md
index 48085769..d0da6ab8 100644
--- a/spec/media-track.md
+++ b/spec/media-track.md
@@ -25,7 +25,7 @@ optional owned pairwise replacement relationship
optional 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 to
ordinary peer `VisualTrack` and, only when explicitly authored, `AudioTrack` values.
One package does not mean one conditional super-component. The author Surface exposes two
diff --git a/spec/ranking-track.md b/spec/ranking-track.md
index 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.md
index 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 not
own:
diff --git a/spec/track-authoring.md b/spec/track-authoring.md
index 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 window
projection 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:
```ts
type 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 shared
by focused modules such as Narrative, ProgramSpace, Media and Composition; Core has no registry of
video-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 pure
frame-window projection. It may consume Narrative point references, SemanticMap location and
ProgramSpace, 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.md
index 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;