feat: initial commit - Jhonny Editor

- Adicionado estrutura completa do projeto - Configurado MCP server para Premiere Pro - Adicionado documentação e skills - Configurado Gitignore para o projeto
2026-09-08 09:59:31 -04:00
commit b541f502ba
1507 changed files with 387650 additions and 0 deletions
@@ -0,0 +1,45 @@
+# Guarded track-item slides through stable UXP
+
+`slide_track_item_uxp` is a bounded documented-UXP composition for a familiar
+three-item timeline slide: it moves the center clip while trimming only its
+immediate same-track neighbours to retain both adjacent cuts.
+
+## Authority and API boundary
+
+The implementation uses stable Premiere UXP 25.6+ audio/video TrackItem timing
+getters; `createMoveAction`, `createSetStartAction`, `createSetEndAction`,
+`createSetInPointAction`, and `createSetOutPointAction`; plus
+`Project.lockedAccess` and `Project.executeTransaction`. It does not use CEP,
+QE, raw evaluation, UI automation, or a native SDK.
+
+## Guarded flow
+
+1. Call `action: "inspect"` for a bounded media type, track index, and center
+   clip index. The command returns the active project/sequence IDs and complete
+   timing/source/speed snapshots for the previous, center, and following clips.
+2. Call `action: "apply"` with that unchanged complete snapshot,
+   `confirm_slide: true`, a non-zero `slide_by_seconds` in -60 through 60, and
+   a required `operation_id`.
+3. The panel serializes slides and source-only slips per project/sequence/media
+   track. It re-resolves the complete triplet after entering that tail, rejects
+   every stale field, then creates five documented actions in one transaction:
+   center move, previous timeline/source extension, and following
+   timeline/source trim.
+4. It resolves the same coordinates again and verifies each source/timeline
+   endpoint, duration, speed, reverse state, and both contiguous cuts.
+
+Only immediate contiguous forward 1x clip items whose source and timeline
+durations agree are supported. The requested slide must leave both neighbours
+with positive source and timeline durations within the documented 0–86,400
+second bound. The command neither discovers source handles nor changes clips on
+other tracks.
+
+## Proof boundary
+
+Automated tests exercise closed schemas, complete-triplet stale checks,
+same-operation replay, one-transaction action composition, post-readback, and
+deterministic serialization against a concurrent slip. They are mock/static
+contract evidence only. No licensed Premiere host has validated media handles,
+linked A/V synchronization, rendered frames, playback, persistence after
+reopening, or Undo. A verification failure can occur after the host transaction
+commits; inspect all three items before another edit.