@vosjs/cli 0.35.0 → 0.37.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -105,7 +105,8 @@ vos plan take --reuse # re-time that cut onto
105
105
 
106
106
  ```
107
107
  take/
108
- recording.webm encoded footage (30 fps CFR WebM)
108
+ recording.webm encoded footage (30 fps CFR WebM; `recording.mp4` when a
109
+ pull brought the footage home in that container)
109
110
  frames/ raw screencast JPEGs, indexed by frames.json (kept for re-encode)
110
111
  cursor.json the synthesized CursorTrack: exact coordinates, element rects
111
112
  meta.json RecordingMeta (producer: "cli", per-step source extents)
@@ -119,6 +120,13 @@ take/
119
120
  mic.webm, cam.webm sidecar tracks, present on takes pulled from vos.so with --media
120
121
  ```
121
122
 
123
+ A take's own media is named after what it IS, not after a convention: a pull
124
+ reads the first bytes of each file it downloads and writes `recording.mp4` when
125
+ the footage is mp4, whatever the hosted asset was called or its Content-Type
126
+ claimed. Every verb resolves the name, and a push declares the container it
127
+ finds in the bytes, so a file never reaches vos.so under the wrong type.
128
+ `vos validate <take>` warns when an existing take holds one that does.
129
+
122
130
  A re-record replaces the footage, the cursor track, the frames and everything derived from them, moves `doc.json` to `doc.prev.json`, and keeps `actions.json` and `vos.json`.
123
131
 
124
132
  ## actions.json