Add agentic stamping workflow to marker context documentation

This commit is contained in:
2026-06-20 17:00:31 -06:00
parent 6af1dd51cf
commit d1893a520e
+53
View File
@@ -91,6 +91,59 @@ Both bounds are deliverable chapter candidates. Do **not** use `gamign` or `env`
--- ---
## Agentic stamping workflow (MCP)
Run on the **active sequence** in Premiere Pro with the CEP bridge panel connected (`ws://127.0.0.1:9801`). Do **not** auto-fill `editDesc` — markers and `prtranscript/` sidecars only.
### 1. Premiere + MCP prep
1. Open the stream `.prproj` / sequence (e.g. `2026-06-18 slump.ts`).
2. Open **PremierPro MCP Bridge** (CEP) — confirm connected on port **9801**.
3. Rebuild MCP if transcript tools are missing: `go build -o bin/server.exe ./cmd/server` in `AdobePremiereProMCP/go-orchestrator`, then restart the **premiere-pro** MCP in Cursor.
4. Local mp4 for ffmpeg probes: `{year}/{date} {stream}.mp4` (e.g. `2026/2026-06-18 slump.ts.mp4`).
### 2. Export transcript (before visual pass)
Premiere 25 **Text > Transcript** is not readable via ExtendScript. Export through MCP:
| Tool | `premiere_export_sequence_transcript` |
|------|----------------------------------------|
| `output_path` | `editDesc/prtranscript/{stream}.prtranscript` (absolute path) |
| `format` | `prtranscript` (default), `json`, or `text` |
**Pr 25 (preferred):** open **Window > UXP Plugins > PremierPro MCP UXP Bridge** and confirm **Connected** on `ws://127.0.0.1:9802`. Source clips must already be transcribed in **Text > Transcript**.
Install once: `scripts/install-uxp-panel-win.bat` in the MCP repo. Enable UXP developer mode in Premiere preferences.
**Fallback (no UXP / Pr 24):** in Text panel, **Create Captions**, then call the same tool (reads caption tracks; speakers often `Unknown`).
Optional: `premiere_export_captions``.srt` / `.vtt` when a caption track exists.
Use the exported `*_prtranscript.txt` (or `.prtranscript` blocks) as **segment seeds** for the visual pass — not as chapter timestamps alone.
### 3. Baseline snapshot
`premiere_get_sequence_markers` → save `editDesc/prtranscript/{stream}_markers_baseline.json`.
### 4. Visual pass
1. Merge transcript seeds with existing marker labels.
2. ffmpeg probes: `editDesc/prtranscript/_*_probe/` — opsec clusters (below) plus ~10min sweeps during gameplay.
3. `premiere_capture_frame_base64` at seeds / map titles when mp4 is unavailable.
4. Write `editDesc/prtranscript/{stream}_visual_tags.txt`.
### 5. Add markers
- **Red (1):** new agent deliverable location/activity stamps only.
- **White (5):** agent-added `INT:` / `LORE:` only when opsec rules justify them.
- Never recolor or rename the user's existing markers.
### 6. After snapshot + save
Save `editDesc/prtranscript/{stream}_markers_after.json`. **Ctrl+S** the project (Synology paths may time out on `premiere_save_project`).
---
## Opsec pass (agent) ## Opsec pass (agent)
For each `gamign``env` cluster: For each `gamign``env` cluster: