feat(wave): 0.1.9 product-film doctrine in business-motion-film

CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.1.9 — 2026-10-01
+
+Wave 0.1.9 body-only. Katalog tetap 65 (50 model + 15 manual). Tidak ada pertumbuhan allowlist. Tidak ada penambahan atau pensiun skill. Exception 0.1.8 tetap spent.
+MERGE: `kaventro/motion-designer` (`0cf0ba92d3db7d8d5ae603a65b56a99a2866311c`, MIT) ke `skills/business-motion-film`.
+
+- `business-motion-film`: Penambahan mode `product-film` untuk membuat film peluncuran (launch film, teaser, product promo) dari UI aplikasi nyata (iOS, macOS/Windows/Linux desktop, Electron/Tauri, web app) di dalam wadah perangkat asli (iPhone / window desktop), bukan iklan komersial abstrak.
+- Layar dibangun langsung dari kode sumber atau tangkapan layar terverifikasi di repo. Mockup generik ditolak. Mobile selalu di dalam frame iPhone (dynamic island / status bar); desktop selalu di dalam jendela aplikasi dengan pergerakan kursor yang bermakna.
+- Kontrak frame deterministik murni `seek(t)`: dilarang menggunakan timer (`setTimeout`/`setInterval`), `Date.now()`, `Math.random()`, maupun transisi/animasi CSS. Loop timeline harus menutup rapat; frame identik dari arah scrub manapun.
+- Beat-map audio: struktur narasi mengikuti tempo (BPM), bar, dan drop musik; aksi kunci mendarat tepat pada drop. Track audio pengguna selalu didahulukan.
+- Gerbang 4 still (buka, momen produk utama, drop, frame akhir) wajib disetujui pengguna sebelum build; berhenti jika belum disetujui.
+- QA & ledger bukti (`FACT:`): contact sheet + audit daftar kesalahan umum (label terpotong, UI full-bleed, crossfade sembarangan, pointer melayang, klaim tanpa bukti). Pelaporan wajib menyertakan path mp4, status ketersediaan ffmpeg dan Chrome, serta loudness LUFS jika ada audio. Ketiadaan ffmpeg atau Chrome dilaporkan sebagai `NOT_CONFIGURED`, bukan PASS palsu.
+- Pipeline render: pintu default tetap `hyperframes` (brag card 18 detik tetap `skills/hyperframes/references/brag.md`). Pipeline render Chrome DevTools upstream hanya digunakan jika diminta secara eksplisit dan Chrome tersedia.
+- Model audio/suara upstream (ACE-Step ~11 GB, Chatterbox, Kokoro) adalah `OPTIONAL_POINTER`. Tidak ada pengunduhan model dan script `install.sh` upstream tidak dijalankan. Ketiadaan model = `NOT_CONFIGURED`.
+- Peran spesialis tetangga tidak berubah: `id-demo-video` (demo narasi Indonesia), `scroll-craft` (scrollytelling 2D), `scroll-world` (kamera 3D), `emil-design-eng` (motion physics UI; token film memakai token Emil, bukan style kit Meadow/Midnight), `impeccable`, `found-this-design`, `ninerouter`.
+- Pin sumber dan lisensi dicatat di `vendor/sources.json`, `vendor/provenance.json`, `vendor/license-audit.json`, `vendor/licenses/KAVENTRO-MOTION-DESIGNER-MIT.txt`, `THIRD_PARTY_NOTICES.md`, dan `docs/source-wave.md`. Versi produk 0.1.9.
+
 ## 0.1.8 — 2026-10-01
 
 Unfreeze terbatas 0.1.8. Katalog tetap 65.

README.md

@@ -4,7 +4,7 @@ OpenCode 2 overlay: 65 frozen routed skills, thin `AGENTS.md`, `opencode-he`.
 
 Installer and runtime overlay for [OpenCode 2](https://opencode.ai/v2/docs/).
 
-Version **0.1.8**. The 65-skill catalog is strictly frozen.
+Version **0.1.9**. The 65-skill catalog is strictly frozen.
 
 ## What it is
 
@@ -117,7 +117,7 @@ Default: repository evidence first. Then at most one specialist.
 | Photoreal / media | `visual-studio` |
 | Scroll-led storytelling | `scroll-craft` |
 | Scroll-driven 3D / camera world | `scroll-world` |
-| Commercial launch films & business explainers | `business-motion-film` (render via `hyperframes`; absorbs Three.js product-hero patterns) |
+| Commercial launch films & business explainers | `business-motion-film` (render via `hyperframes`; absorbs Three.js product-hero patterns; real app UI launch films stay `launch_film` → `business-motion-film`) |
 | 9Router gateway (inference/image/video/TTS/STT/web) | `ninerouter` |
 | Deterministic HTML composition video | `hyperframes` (18s brag card via `references/brag.md`) |
 | Demo video aplikasi & narasi ID | `id-demo-video` (`/demo-video`) |
@@ -133,7 +133,7 @@ Default: repository evidence first. Then at most one specialist.
 | TS Oxlint install | `install-anti-slop` (explicit only) |
 | Architecture bake-off | `/architect` (manual) |
 
-Warehouse: `api-design`, `contract-first`, `automation-audit-ops`, `code-tour`, `click-path-audit` (plus Wave 2 diagnostics). Wave 0.1.7 additions: `json-render` (generative UI from typed catalogs), `deck-design` (consulting-grade PPTX & 16:9 HTML slide decks), `pageindex` (vectorless tree-reasoning long document navigation). Wave 0.1.8 additions: `business-motion-film` (commercial launch films; retires `img2threejs`), `ninerouter` (multi-provider gateway stub; retires `prompt-optimizer`).
+Warehouse: `api-design`, `contract-first`, `automation-audit-ops`, `code-tour`, `click-path-audit` (plus Wave 2 diagnostics). Wave 0.1.7 additions: `json-render` (generative UI from typed catalogs), `deck-design` (consulting-grade PPTX & 16:9 HTML slide decks), `pageindex` (vectorless tree-reasoning long document navigation). Wave 0.1.8 additions: `business-motion-film` (commercial launch films; retires `img2threejs`), `ninerouter` (multi-provider gateway stub; retires `prompt-optimizer`). Wave 0.1.9 body-only: merges `kaventro/motion-designer` into `business-motion-film` (product-film mode; catalog strictly 65/65).
 
 Examples: interactive product story told by scroll → `scroll-craft`. Unbroken camera through a miniature factory → `scroll-world`. Clean security dashboard → `impeccable`. Video, image generation, and Design V2 stay optional.
 

THIRD_PARTY_NOTICES.md

@@ -34,7 +34,7 @@ Machine-readable copy: `vendor/license-audit.json`.
 | Email design doctrine | Merged from [CosmoBlk/email-design](https://github.com/CosmoBlk/email-design) (MIT © 2026 CosmoBlk), [jayesh-bansal/email-pro-max](https://github.com/jayesh-bansal/email-pro-max) (MIT © 2026 Jayesh Bansal), [chunkydotdev/email-skills](https://github.com/chunkydotdev/email-skills) (MIT © 2026 chunkydotdev), and [Olshansk/agent-skills](https://github.com/Olshansk/agent-skills) (MIT © 2026 Olshansk) into `skills/impeccable/reference/email.md` | MIT | follow MIT |
 | Emil Kowalski motion doctrines | Merged from [emilkowalski/skills](https://github.com/emilkowalski/skills) (`85e8e2363b71`) into `skills/emil-design-eng/references/` (`motion.md`, `apple-principles.md`, `native-motion.md`, `interface-feel.md`). Text: `vendor/licenses/EMILKOWALSKI-MIT.txt` | MIT © 2026 Emil Kowalski | follow MIT |
 | Warehouse Batch 2a (`agent-architecture-audit`, `cost-aware-llm-pipeline`, `eval-harness`, `skill-stocktake`) | Adapted from [affaan-m/ECC](https://github.com/affaan-m/ECC); respective skill `NOTICE.md` files (prompt-optimizer retired in 0.1.8) | MIT © 2024-2026 affaan-m and ECC contributors | follow MIT |
-| `business-motion-film` | [echris6/motion-video-kit](https://github.com/echris6/motion-video-kit) `255562b` — `vendor/licenses/ECHRIS6-MOTION-VIDEO-KIT-MIT.txt`; skill `NOTICE.md` | MIT © 2026 echris6 | follow MIT |
+| `business-motion-film` | [echris6/motion-video-kit](https://github.com/echris6/motion-video-kit) `255562b` — `vendor/licenses/ECHRIS6-MOTION-VIDEO-KIT-MIT.txt`; [kaventro/motion-designer](https://github.com/kaventro/motion-designer) `0cf0ba9` (product-film mode) — `vendor/licenses/KAVENTRO-MOTION-DESIGNER-MIT.txt`; skill `NOTICE.md` | MIT © 2026 echris6; MIT © 2026 kaventro | follow MIT |
 | `ninerouter` | [decolua/9router](https://github.com/decolua/9router) `f01fb90`; skill `NOTICE.md`. First-party gateway stub; skills on-demand. | MIT © 2026 decolua | follow MIT |
 | Warehouse Batch 3a (`api-design`, `automation-audit-ops`, `click-path-audit`, `code-tour`, `contract-first`) | Adapted from [affaan-m/ECC](https://github.com/affaan-m/ECC); respective skill `NOTICE.md` files | MIT © 2024-2026 affaan-m and ECC contributors | follow MIT |
 | Design bank media | User-provided public bootstrap artifact or existing local bank | **not cleared** | not in git; normal install does not download it |

VERSION

@@ -1 +1 @@
-0.1.8
+0.1.9

docs/CATALOG-FREEZE.md

@@ -2,8 +2,9 @@
 
 This contract defines the immutable boundary and governance for the OpenCodeHighEnd catalog. The 65-skill catalog is strictly frozen.
 
-- **Product version**: 0.1.8
+- **Product version**: 0.1.9
 - **Catalog**: 65 names. 50 model-invoked under `skills/`. 15 manual under `manual-skills/` + `commands/`.
+- **Wave 0.1.9 body-only**: catalog strictly frozen at 65 (50 model + 15 manual). Zero catalog growth. No new exceptions; 0.1.8 exception is spent. Upstream `kaventro/motion-designer` merged into `business-motion-film` (product-film mode).
 - **Wave 0.1.8 limited unfreeze exception** (CHANGELOG 0.1.8): catalog stays 65 (50 model + 15 manual). Retired names: `img2threejs` (Three.js product-hero patterns moved to `business-motion-film` references), `prompt-optimizer` (overlaps `research` + `humanizer`). Added model-invoked: `business-motion-film` (from `echris6/motion-video-kit`, MIT), `ninerouter` (first-party gateway stub). Intent `img3d` replaced by `launch_film | gateway_llm`. This exception is spent.
 - **Wave 0.1.7 unfreeze exception** (CHANGELOG 0.1.7): catalog grew 62 → 65 to add `json-render`, `deck-design`, `pageindex`. No twin retired. (Spent).
 - **Retired in prior waves and not to be revived**: `ask-matt`, `grilling`, `wait-what`, `matt-implement`.

docs/architecture.md

@@ -47,7 +47,7 @@ Instead of opaque multi-agent swarms or chat-based delegation, OpenCodeHighEnd o
 5. **Generative UI Node (`json-render`)**: Handed off from `prototype` or `found-this-design` when UI must be generated from typed JSON schemas or component catalogs rather than freeform layout code.
 6. **Consulting Slide Decks Node (`deck-design`)**: Handed off from `smartdoc` for consulting PPTX and 16:9 HTML slide decks. `smartdoc` retains document contracts/OCR/PDF rendering; `markitdown` retains file-to-Markdown ingest.
 7. **Long-Document Navigation Node (`pageindex`)**: Handed off from `research` for navigating deep, structured documents (filings, manuals, technical specs) using hierarchical tree reasoning rather than naive vector similarity chunking. Primary-source citation rules remain strictly enforced.
-8. **Commercial Launch Films & Business Explainers (`business-motion-film`)**: Handed off for business ads, launch films, sample reels, and explainers. Rendering is strictly executed through `hyperframes`; Three.js product-hero patterns are absorbed into references (not a standalone skill). Continuous 3D camera flight stays with `scroll-world`, 18s brag cards stay in `hyperframes/references/brag.md`, and Indonesian narrated tours stay with `id-demo-video`.
+8. **Commercial Launch Films & Business Explainers (`business-motion-film`)**: Handed off for business ads, launch films (including real app UI product-film mode), sample reels, and explainers. Rendering is strictly executed through `hyperframes`; Three.js product-hero patterns are absorbed into references (not a standalone skill). Continuous 3D camera flight stays with `scroll-world`, 18s brag cards stay in `hyperframes/references/brag.md`, and Indonesian narrated tours stay with `id-demo-video`.
 9. **Multi-Provider Gateway Node (`ninerouter`)**: Handed off when routing inference, image/video generation, speech, transcription, embeddings, or web fetch/search through a user-managed 9Router gateway. 9Router is `FOREIGN_ON_DEMAND`, not an extra core MCP server. Zero-bind prohibition: fails closed immediately on `0.0.0.0`. Graceful degradation to `NOT_CONFIGURED` if the gateway is absent or unreachable.
 
 ## Harness Engineering Principles

docs/routing.md

@@ -35,7 +35,7 @@ academic | longdoc_nav | browser_qa | architecture | warehouse | ops_data | vide
 | `motion` | `emil-design-eng` | Micro-interactions, spring physics, touch feel |
 | `scroll_2d` | `scroll-craft` | Scrollytelling, pinned 2D timelines, scroll triggers |
 | `scroll_3d` | `scroll-world` | Continuous 3D fly-through, camera-scrub worlds |
-| `launch_film` | `business-motion-film` | Commercials, launch films, business explainers, sample reels; render via hyperframes; product-hero Three.js in references |
+| `launch_film` | `business-motion-film` | Commercials, launch films (including real app UI product-film), business explainers, sample reels; render via hyperframes; product-hero Three.js in references |
 | `gateway_llm` | `ninerouter` | 9Router gateway (chat, image, video, TTS, STT, embeddings, web) via NINEROUTER_URL; foreign on-demand stub |
 | `docs` | `smartdoc` | Technical docs, OCR/PDF/DOCX extraction & contracts |
 | `slides_pptx` | `deck-design` | Consulting PPTX / 16:9 HTML decks; smartdoc keeps PDF/DOCX; markitdown keeps ingest |
@@ -80,7 +80,7 @@ MANUAL_NOT_INVOKED
 
 Never list unused tools as used.
 
-UI direction from the bank routes to `found-this-design` first, which stops before component implementation. Visual UI and UI atoms (buttons, inputs, cards, nav) route to `impeccable` after Design V2 shortlist; BANK_MISS ≠ generate (+ shadcn/Design V2 internal). Stitch MCP is for screen/comp generation only, then found-this-design or impeccable with Design V2 atom shortlisting; never implement production UI from Stitch alone. UI Skills MCP is design-skill lookup only; product UI remains Design Bank + Impeccable + Design V2 atoms + shadcn; BANK_MISS ≠ generate from a random ui-skills document. Motion UI routes to `emil-design-eng`. Still/ads/non-UI surface route to `visual-studio`. Scroll-led stories route to `scroll-craft`, while continuous camera 3D fly-throughs route to `scroll-world`. Commercials, launch films, business explainers, sample reels, and pitch videos route to `business-motion-film` (render via hyperframes; Three.js product-hero patterns in references; 18s brag cards stay in `hyperframes/references/brag.md`). Schema/JSON generative UI from a typed catalog routes to `json-render` (after tokens/direction or internal schema UI; never bypass Design Bank for marketing).
+UI direction from the bank routes to `found-this-design` first, which stops before component implementation. Visual UI and UI atoms (buttons, inputs, cards, nav) route to `impeccable` after Design V2 shortlist; BANK_MISS ≠ generate (+ shadcn/Design V2 internal). Stitch MCP is for screen/comp generation only, then found-this-design or impeccable with Design V2 atom shortlisting; never implement production UI from Stitch alone. UI Skills MCP is design-skill lookup only; product UI remains Design Bank + Impeccable + Design V2 atoms + shadcn; BANK_MISS ≠ generate from a random ui-skills document. Motion UI routes to `emil-design-eng`. Still/ads/non-UI surface route to `visual-studio`. Scroll-led stories route to `scroll-craft`, while continuous camera 3D fly-throughs route to `scroll-world`. Commercials, launch films, business explainers, sample reels, and pitch videos route to `business-motion-film` (render via hyperframes; includes real app UI product-film mode; Three.js product-hero patterns in references; 18s brag cards stay in `hyperframes/references/brag.md`). Schema/JSON generative UI from a typed catalog routes to `json-render` (after tokens/direction or internal schema UI; never bypass Design Bank for marketing).
 
 Browser verification follows four explicit doors: exploratory application UI routes to `playwright-qa`, persistent multi-account sessions route to `browser-act`, observed Chromium cause routes to `chrome-devtools-axi`, and button handler sequential undo / shared-store side effects route to `click-path-audit`.
 

docs/skills.md

@@ -5,7 +5,7 @@ Policy: `vendor/skill-policy.json` plus `vendor/skill-allowlist.txt`.
 - 50 model-invoked skills live under `skills/` and install to `~/.config/opencode/skills/` (core + Wave 2/3 warehouse specialists + 0.1.7 `json-render`, `deck-design`, `pageindex` + 0.1.8 `business-motion-film`, `ninerouter`)
 - 15 manual skills live under `manual-skills/` and install to `~/.config/opencode/highend/skills/` plus `commands/`
 
-`smartdoc` is per-job document intelligence. `deck-design` owns consulting PPTX / 16:9 HTML slide decks. `pageindex` owns tree/reasoning navigation of long structured documents. `json-render` owns schema/JSON generative UI after tokens/direction (or internal schema UI). `markitdown` converts Office/PDF/HTML/CSV/XLSX/PPTX/EPUB/ZIP to Markdown for ingest; SmartDoc keeps contract/QA/render. `smartbook-ingest` compiles reusable local knowledge. `humanizer` cleans user-facing prose tells (`/unslop` is its manual alias). `academic` manages scholarly research, writing, and peer review. `hyperframes` handles deterministic HTML-to-MP4 video composition. `id-demo-video` coordinates Indonesian application demo video production (`/demo-video` is its manual slash command). `diagram-design` crafts editorial HTML/SVG diagrams. `business-motion-film` plans and quality-checks commercial launch films and explainers (rendered via hyperframes; absorbs Three.js product-hero patterns). `ninerouter` routes models, images, video, speech, and web tools through a 9Router gateway. Warehouse diagnostics include `agent-architecture-audit` (agent stack layers), `cost-aware-llm-pipeline` (token budgeting), `eval-harness` (benchmarks), and `skill-stocktake` (catalog hygiene; `prompt-optimizer` retired in 0.1.8 with prompt refinement handled by humanizer, research, and writing-for-agents). Wave 3 adds `api-design`, `contract-first`, `automation-audit-ops`, `code-tour`, and `click-path-audit`. Handwriting is a SmartDoc renderer, not a skill.
+`smartdoc` is per-job document intelligence. `deck-design` owns consulting PPTX / 16:9 HTML slide decks. `pageindex` owns tree/reasoning navigation of long structured documents. `json-render` owns schema/JSON generative UI after tokens/direction (or internal schema UI). `markitdown` converts Office/PDF/HTML/CSV/XLSX/PPTX/EPUB/ZIP to Markdown for ingest; SmartDoc keeps contract/QA/render. `smartbook-ingest` compiles reusable local knowledge. `humanizer` cleans user-facing prose tells (`/unslop` is its manual alias). `academic` manages scholarly research, writing, and peer review. `hyperframes` handles deterministic HTML-to-MP4 video composition. `id-demo-video` coordinates Indonesian application demo video production (`/demo-video` is its manual slash command). `diagram-design` crafts editorial HTML/SVG diagrams. `business-motion-film` plans and quality-checks commercial launch films, real app UI product promos, and explainers (rendered via hyperframes; absorbs Three.js product-hero patterns). `ninerouter` routes models, images, video, speech, and web tools through a 9Router gateway. Warehouse diagnostics include `agent-architecture-audit` (agent stack layers), `cost-aware-llm-pipeline` (token budgeting), `eval-harness` (benchmarks), and `skill-stocktake` (catalog hygiene; `prompt-optimizer` retired in 0.1.8 with prompt refinement handled by humanizer, research, and writing-for-agents). Wave 3 adds `api-design`, `contract-first`, `automation-audit-ops`, `code-tour`, and `click-path-audit`. Handwriting is a SmartDoc renderer, not a skill.
 
 OpenCode 2 discovers `~/.config/opencode/skills` and project `.opencode/skills`. Manual skills must not be copied into those directories; they live under `~/.config/opencode/highend/skills/` and are invoked only as `~/.config/opencode/commands/<name>.md` (or project `.opencode/commands/<name>.md`).