## Phase 158: Neith DCC-Integrated Video Sequence Editor (VSE) — Blender VSE / Cinema 4D Timeline / Maya Sequencer / Houdini MPlay Parity

Closes the DCC-integrated linear-editing gap. Phase 135 ships a Nuke-class
compositor plus EDL/AAF/OTIO conform for post-production. Phase 147 ships a
specialist colorist suite. Phase 44.4 ships an editor module in Neith Studio.
None of these deliver a **DCC-native VSE** — the lightweight linear NLE that
lives _inside_ the 3D DCC for cuts, previs edits, rough animatics,
rendered-frame review, and documentary- style assembly without leaving the
animation workspace.

Sovereign replacement for Blender Video Sequence Editor, Cinema 4D timeline clip
editor, Maya Sequencer, Houdini MPlay + playblast, and the lightweight NLEs
found in Modo, LightWave, and DaVinci's Cut Page when used as a DCC-adjacent
tool. Distinct from Phase 135 (feature-film post) and Phase 44.4 (full editor) —
this VSE is **embedded in the artist's 3D workspace** for tight in-DCC
iteration.

---

### 158.1 @neith/vse-core — Timeline & Strip Model

- [x] **158.1.1** Timeline with unlimited audio + video + meta channels
- [x] **158.1.2** Strip primitives (video / audio / scene / effect / text / mask
      / image sequence)
- [x] **158.1.3** Strip transformation (move / trim / slip / slide / ripple)
- [x] **158.1.4** Frame-accurate in / out handles
- [x] **158.1.5** Sub-frame audio edit with sample accuracy
- [x] **158.1.6** Strip grouping + meta-strip
- [x] **158.1.7** Strip lock / mute / solo
- [x] **158.1.8** Colour tag per strip
- [x] **158.1.9** Marker system with labels + colour
- [x] **158.1.10** Playhead snap (markers / strips / frame)
- [x] **158.1.11** Multi-selection + ripple-edit operations
- [x] **158.1.12** Three-point edit (source / record in-out)
- [x] **158.1.13** Insert / overwrite / replace modes
- [x] **158.1.14** J / K / L playback shuttle
- [x] **158.1.15** Keyframe animation on any strip property

---

### 158.2 @neith/vse-ingest — Media Ingest & Proxy

- [x] **158.2.1** Import MP4 / MOV / MKV / WebM / ProRes / DNx / EXR-seq
- [x] **158.2.2** Auto-proxy generation at 1/2, 1/4, 1/8 resolution
- [x] **158.2.3** Proxy cache directory management
- [x] **158.2.4** Timecode + reel metadata preserve
- [x] **158.2.5** Variable frame-rate conform
- [x] **158.2.6** Metadata-based auto-rename / reorganise
- [x] **158.2.7** Image-sequence ingest (PNG/TIFF/EXR)
- [x] **158.2.8** 3D render-layer import from Phase 138 / Phase 154
- [x] **158.2.9** Scene-strip (live 3D scene preview as strip)
- [x] **158.2.10** Grease Pencil (Phase 156) strip
- [x] **158.2.11** Audio waveform cache
- [x] **158.2.12** Audio sample-rate auto-convert
- [x] **158.2.13** Multi-channel (5.1 / 7.1 / Atmos) import
- [x] **158.2.14** HDR (HDR10 / Dolby Vision / HLG) metadata preserve
- [x] **158.2.15** Camera RAW ingest (via Phase 147 colorist-raw)

---

### 158.3 @neith/vse-transitions — Transitions & Effects

- [x] **158.3.1** Cross-dissolve (linear / log / sigmoid)
- [x] **158.3.2** Dip-to-colour (black / white / custom)
- [x] **158.3.3** Wipe (directional / clock / iris / gradient)
- [x] **158.3.4** Push / slide / spin
- [x] **158.3.5** Morph cut (face-align)
- [x] **158.3.6** Audio cross-fade with constant-power curve
- [x] **158.3.7** Audio equal-loudness fade
- [x] **158.3.8** Transition library + preset save
- [x] **158.3.9** Custom transition via shader node
- [x] **158.3.10** Keyframeable transition param
- [x] **158.3.11** Glitch / stutter / whip-pan stylised transitions
- [x] **158.3.12** 3D transition (cube / flip / page-turn)
- [x] **158.3.13** Match-cut alignment helper
- [x] **158.3.14** Audio duck / side-chain during transition
- [x] **158.3.15** Auto-transition based on detected cut

---

### 158.4 @neith/vse-effects — Per-Strip Effects

- [x] **158.4.1** Colour balance / curves / levels
- [x] **158.4.2** Hue / saturation / luma curve
- [x] **158.4.3** Bright / contrast / gamma
- [x] **158.4.4** Tone-map + OCIO view transform
- [x] **158.4.5** Chroma / luma key
- [x] **158.4.6** Mask (shape / spline / alpha)
- [x] **158.4.7** Stabilise (reuse Phase 153 matchmove)
- [x] **158.4.8** Speed ramp / retime with optical flow
- [x] **158.4.9** Reverse
- [x] **158.4.10** Loop / hold / freeze frame
- [x] **158.4.11** Crop + pan & scan
- [x] **158.4.12** Blur / sharpen / denoise
- [x] **158.4.13** Motion blur synthesise
- [x] **158.4.14** Film grain
- [x] **158.4.15** LUT application (CUBE / 3DL / OCIO)
- [x] **158.4.16** Text-overlay generator with typography
- [x] **158.4.17** Subtitles / captions track
- [x] **158.4.18** Watermark insert
- [x] **158.4.19** Picture-in-picture with rounded corners / shadow
- [x] **158.4.20** Stack effect nodes (graph inside strip)

---

### 158.5 @neith/vse-audio — Audio Track Features

- [x] **158.5.1** Per-strip gain + pan
- [x] **158.5.2** Track-level mixer with bus routing
- [x] **158.5.3** VST3 / AU / LV2 / CLAP plugin host (Phase 132)
- [x] **158.5.4** Built-in EQ / compressor / limiter / de-esser
- [x] **158.5.5** LUFS meter + true-peak
- [x] **158.5.6** Auto-ducking under dialogue
- [x] **158.5.7** Music beat-grid (Phase 133 integration)
- [x] **158.5.8** Edit-to-beat snapping
- [x] **158.5.9** Audio waveform scrubbing
- [x] **158.5.10** Speech-to-text caption generation (Phase 47 Nous)
- [x] **158.5.11** Audio noise-reduction (Phase 133 RX-class)
- [x] **158.5.12** Stereo / mono / 5.1 / Atmos bus
- [x] **158.5.13** Per-strip sidechain input
- [x] **158.5.14** Sync to external MIDI / LTC
- [x] **158.5.15** Loudness normalisation for final render

---

### 158.6 @neith/vse-playback — Real-Time Playback Engine

- [x] **158.6.1** RAM + disk playback cache with LRU eviction
- [x] **158.6.2** Background prefetch thread
- [x] **158.6.3** Decode accelerated (VideoToolbox / NVDEC / VAAPI / D3D12 VP9
      HEVC AV1)
- [x] **158.6.4** GPU upload with CPU fallback
- [x] **158.6.5** Dropped-frame counter + heuristic
- [x] **158.6.6** Timeline-scrub frame-exact
- [x] **158.6.7** Audio-only / video-only playback option
- [x] **158.6.8** Fullscreen preview on second display
- [x] **158.6.9** AJA / Blackmagic SDI video-out
- [x] **158.6.10** Audio routing to CoreAudio / ASIO / JACK (Phase 132)
- [x] **158.6.11** Frame-step / field-step
- [x] **158.6.12** Fit-to-timeline speed override
- [x] **158.6.13** Lock preview rate to project rate
- [x] **158.6.14** Ripple + J/K/L modifier key combos
- [x] **158.6.15** Latency under 50 ms during scrub

---

### 158.7 @neith/vse-render — Render Queue & Output

- [x] **158.7.1** Render preset manager (codec / bitrate / res / colour)
- [x] **158.7.2** H.264 / HEVC / AV1 / ProRes / DNxHR / MPEG-2 encoders
- [x] **158.7.3** 10-bit / 12-bit / 16-bit float output
- [x] **158.7.4** HDR metadata embed (HDR10 / HDR10+ / Dolby Vision / HLG)
- [x] **158.7.5** Multi-format simultaneous render
- [x] **158.7.6** Distributed render across farm (Phase 138)
- [x] **158.7.7** Frame-range + strip-only render
- [x] **158.7.8** Render stamp / burn-in
- [x] **158.7.9** Audio stem render (dialogue / music / SFX)
- [x] **158.7.10** Closed-caption sidecar output (.srt / .vtt / .cc)
- [x] **158.7.11** Thumbnail image sheet generation
- [x] **158.7.12** Auto-upload to sovereign CDN / storage
- [x] **158.7.13** Render queue with pause / resume / retry
- [x] **158.7.14** Version export (v001 naming pattern)
- [x] **158.7.15** Render-to-new-strip (re-ingest for further edit)

---

### 158.8 @neith/vse-review — Dailies & Frame Review

- [x] **158.8.1** Frame-notes anchored to timecode
- [x] **158.8.2** Drawable annotation over video
- [x] **158.8.3** Voice-memo annotation
- [x] **158.8.4** Reviewer role + permission
- [x] **158.8.5** Approval state per shot / per version
- [x] **158.8.6** Side-by-side version compare
- [x] **158.8.7** A / B wipe with slider
- [x] **158.8.8** Notes export PDF / CSV
- [x] **158.8.9** Notes sync to Phase 135 ShotOps
- [x] **158.8.10** Live-share review session (Phase 139 chat + video)

---

### 158.9 @neith/vse-conform — Conform, Roundtrip & Interchange

- [x] **158.9.1** OTIO import / export
- [x] **158.9.2** AAF round-trip
- [x] **158.9.3** FCPXML round-trip
- [x] **158.9.4** EDL (CMX-3600) export
- [x] **158.9.5** XML (Premiere) export
- [x] **158.9.6** Send-to Phase 135 VFX Compositor
- [x] **158.9.7** Send-to Phase 147 Colorist
- [x] **158.9.8** Send-to Phase 141 2D animation
- [x] **158.9.9** Auto-conform from editorial cut
- [x] **158.9.10** Version-up preserves edit timing

---

### 158.10 @neith/vse-storyboard — Storyboard / Animatic Mode

- [x] **158.10.1** Still-image sequence mode for boards
- [x] **158.10.2** Board panel timing quick-edit
- [x] **158.10.3** Scratch-track scratch audio
- [x] **158.10.4** Beat-alignment to scratch
- [x] **158.10.5** Promote to Phase 156 Grease Pencil in 3D scene
- [x] **158.10.6** Promote to Phase 135 storyboarding
- [x] **158.10.7** Animatic-to-previs migration
- [x] **158.10.8** Script / dialogue column
- [x] **158.10.9** Auto-slate with shot number
- [x] **158.10.10** Export board PDF with timing

---

### 158.11 Testing & Validation

- [ ] **158.11.1** 4K playback ≥ 60 FPS from proxy: the `vse-playback` path is
      implemented; measure it on the Mac, which has VideoToolbox hardware
      decode. Generate a 4K proxy test clip with ffmpeg (`/usr/bin/ffmpeg`).
      Verify: on the Mac, proxy playback of the 4K fixture sustains ≥ 60 FPS
      averaged over a 30-second scrub, with the achieved FPS recorded; the
      software-decode path on the Linux server is measured too and its lower
      rate noted.
- [ ] **158.11.2** 8K playback ≥ 24 FPS with full-quality decode. Full-quality
      (non-proxy) 8K decode at 24 FPS needs an 8K-capable workstation; the
      MacBook Air cannot sustain it and the Linux server has no GPU decode
      (stated 2026-09-18). `blocked:hardware`
- [x] **158.11.3** A/B parity vs Blender VSE on identical project
- [x] **158.11.4** OTIO / AAF / FCPXML / EDL round-trip fidelity
- [x] **158.11.5** HDR metadata preservation tests
- [x] **158.11.6** Audio phase-coherent sample-accurate
- [ ] **158.11.7** Long-session soak (8 h edit without leak): run the bounded
      edit-storm soak (already implemented as the release gate) for 8 wall-clock
      hours on the Linux server with per-edit invariants and RSS-growth
      enforcement. Verify: the 8-hour run completes with zero invariant failures
      and RSS growth under the enforced bound, with the metrics log committed.
- [x] **158.11.8** DCC-integrated 3D scene strip live-update
- [x] **158.11.9** Distributed render deterministic frame-hash
- [ ] **158.11.10** Dogfood: cut Oshun marketing videos in the VSE. This is an
      organisational rollout (real editors cutting real marketing videos), not a
      code deliverable, and depends on that adoption happening (stated
      2026-09-18). `blocked:release`
