rushes 0.3.0 → 0.4.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/.claude-plugin/plugin.json +1 -1
- package/AGENTS.md +1 -1
- package/README.md +2 -0
- package/dist/core/cues.js +39 -0
- package/dist/core/project.js +9 -4
- package/dist/core/schema.js +8 -1
- package/dist/mcp/tools.js +13 -1
- package/dist/server/app.js +7 -3
- package/dist/server/assets.js +6 -5
- package/dist/server/files.js +4 -0
- package/dist/server/found.js +5 -1
- package/package.json +1 -1
- package/skills/rushes/SKILL.md +1 -1
- package/web-dist/assets/{index-BDMm5p1-.css → index-BFr1m3wH.css} +1 -1
- package/web-dist/assets/index-BZnZV0XS.js +3 -0
- package/web-dist/index.html +2 -2
- package/web-dist/assets/index-C9dBtlRy.js +0 -3
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "rushes",
|
|
3
3
|
"description": "A local review desk for video made with AI agents: timecoded notes, script edits and audio picks your agent reads and acts on.",
|
|
4
|
-
"version": "0.
|
|
4
|
+
"version": "0.4.0",
|
|
5
5
|
"author": { "name": "Red Morley Hewitt" },
|
|
6
6
|
"homepage": "https://github.com/iamredmh/rushes",
|
|
7
7
|
"repository": "https://github.com/iamredmh/rushes",
|
package/AGENTS.md
CHANGED
|
@@ -64,7 +64,7 @@ Every tab is visible from the start, in workflow order, even before it has anyth
|
|
|
64
64
|
- Other shapes of the same cut (a 9:16, 1:1 or 4:5 of the 16:9: same edit, same length): register every shape you rendered, main one first. `rushes_add_version` with `file` (the main one) and `formats: [{ file }, …]` registers them all in one call; `rushes_add_format` (`file`, optional `video`, `version` and `label`) adds one to a cut already registered. Rushes measures each ratio with ffprobe; here `label` is only a ratio hint for an unusual shape such as 2.39:1 (not the cut's short label, which belongs to `rushes_add_version`). A second render with a ratio the cut already has is refused: a re-render is a new version. A shape more than 0.1 s off the cut's length is still registered, with a warning: `rushes_add_format` returns it as `warning`, and `rushes_add_version` returns a list as `formatWarnings` (there, `warning` means "Picture is locked").
|
|
65
65
|
- A VO script: `rushes_set_script` with sections `{start, end, current}` in seconds. It merges by `id`: send only the sections you changed, with their ids, plus any new ones without an id. Sections you leave out are kept, with their takes. Pass `replace: true` only when you mean to replace the whole script. `rushes_get_script` reads the whole script back.
|
|
66
66
|
- A voice read: `rushes_add_variant` with `stage: "voice"` and `round` (the round's name, e.g. "Round 2 · Gerald, tone" — reads in one round are compared side by side; a new direction gets a new round, a small fix to a marked word can stay in the current one). Say in `description` what the read is, or what changed from the one it's based on. `rushes_add_take` stays in the file format and API for compatibility only; voiceover work doesn't use it.
|
|
67
|
-
- Music beds or SFX passes: `rushes_add_variant` with `stage` `music` or `sfx`. Give it `meta: {description: "..."}`, shown on its lane card in place of `bpm`/`key`; SFX passes also take `cues` (`{name, t}` in seconds), labelled on the waveform.
|
|
67
|
+
- Music beds or SFX passes: `rushes_add_variant` with `stage` `music` or `sfx`. Give it `meta: {description: "..."}`, shown on its lane card in place of `bpm`/`key`; SFX passes also take `cues` (`{name, t, file?}`: `t` in seconds, and `file` the sample you placed there, an audio file, optional), labelled on the waveform. Give a sound the same name every time it comes back (`thud`, not `thud 2`): the Sound effects tab groups cues by name into layers, one per sound, and shows a cue's `file` on its card, where the user can play that sample on its own.
|
|
68
68
|
- The storyboard's shots, once you have the first cut: `rushes_set_shots` with `video`, optional `version` (defaults to the newest) and `shots` as `{start, name, tag?}`. Send new timings whenever a later cut moves them.
|
|
69
69
|
2. **Open it for the user:** `rushes_open`. It also looks through the project folder and brings in the files that go with the cut (next section). Each project's dashboard lives at its own address, `/p/<id>/` — safe to run more than one project at once. A tab unlocks as soon as it has something in it.
|
|
70
70
|
3. **Wait for feedback.** The user presses **Send to agent**, which saves a batch and gives them a prompt to paste to you. Call `rushes_get_batch` to read the latest batch, its notes and any changed script sections.
|
package/README.md
CHANGED
|
@@ -111,6 +111,7 @@ In the Voiceover, Music, Sound effects and Mix tabs:
|
|
|
111
111
|
- **←/→** step one frame (Shift: ten)
|
|
112
112
|
- **I/O** set in and out
|
|
113
113
|
- **N** new note
|
|
114
|
+
- **←/→** with a cue or a layer's tick focused: the previous or next cue (**Home**/**End**: the first or last); **Enter** moves the playhead there; **Esc** hides the card
|
|
114
115
|
|
|
115
116
|
Anywhere:
|
|
116
117
|
|
|
@@ -241,6 +242,7 @@ Voiceover works in rounds: the same script read by a few voices, then variations
|
|
|
241
242
|
- On Music, Sound effects and Mix, a note can carry marks: toggle **Rise**, **Fall**, **Louder** or **Quieter** (with a dB amount, 3 by default) to say how a range should change — "Fall" or "Quieter 3 dB".
|
|
242
243
|
- **Mix** shows a loudness readout — integrated LUFS, true peak, and the music's level under the VO — measured over exactly what Mix plays, using the newest round's picked voice read. It needs **ffmpeg** on your PATH; without it, the readout shows "—". After a timeout or an error, click the readout to measure again.
|
|
243
244
|
- Each **Mix** lane (Voiceover, Music, Sound effects) has a level slider, −24 dB to +6 dB in 0.5 dB steps, shown as e.g. `−14.0 dB`. Double-click resets it to 0; arrow keys move it 0.5 dB at a time. Levels are saved with your picks, never change a file, and the loudness readout is measured with them applied.
|
|
245
|
+
- On **Sound effects**, rest the pointer on a cue's label or tick (or Tab to it) for a card with its full name, its time, where it falls in the pass (`cue 5 of 80`) and, when your agent sent one, its source file. The arrow beside a pass's name opens its **layers by sound**: one row per sound, in the order it first comes in, with a count (`thud ×19`) and a tick everywhere it plays. Click a tick to move the playhead there; click a layer's file name to hear that sample on its own (it stops the tab, and Play stops it). The layers stay open while you work, until you reload. Mix's Sound effects lane has the card too.
|
|
244
246
|
|
|
245
247
|
## What gets saved
|
|
246
248
|
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
// §23: a cue's optional source file -- the sample an agent placed at that cue. Checked where it
|
|
2
|
+
// comes in (an audio file, at most 1024 characters, so it can never open the allow-list to
|
|
3
|
+
// anything else) and served by /media only because it is registered (§15.5 applies unchanged).
|
|
4
|
+
import { InvalidError } from "./errors.js";
|
|
5
|
+
export const CUE_FILE_MAX = 1024;
|
|
6
|
+
/** The sample types a cue may name: the audio half of §15.5's outside-the-project list. */
|
|
7
|
+
export const CUE_FILE_EXT = new Set(["wav", "mp3", "m4a", "aac", "aif", "aiff", "flac", "ogg", "opus"]);
|
|
8
|
+
function extOf(file) {
|
|
9
|
+
const base = file.slice(Math.max(file.lastIndexOf("/"), file.lastIndexOf("\\")) + 1);
|
|
10
|
+
const dot = base.lastIndexOf(".");
|
|
11
|
+
return dot > 0 ? base.slice(dot + 1).toLowerCase() : "";
|
|
12
|
+
}
|
|
13
|
+
/** Whether `file` may be a cue's source: not empty, at most 1024 characters, no NUL, an audio extension. */
|
|
14
|
+
export function isCueFile(file) {
|
|
15
|
+
return file.length > 0 && file.length <= CUE_FILE_MAX && !file.includes("\0") && CUE_FILE_EXT.has(extOf(file));
|
|
16
|
+
}
|
|
17
|
+
/** `file` when it may be a cue's source; otherwise an InvalidError (400) naming the cue. */
|
|
18
|
+
export function checkCueFile(cueName, file) {
|
|
19
|
+
if (file.length > CUE_FILE_MAX)
|
|
20
|
+
throw new InvalidError(`Cue "${cueName}": its file path is over ${CUE_FILE_MAX} characters`);
|
|
21
|
+
if (!isCueFile(file)) {
|
|
22
|
+
throw new InvalidError(`Cue "${cueName}": "${file}" isn't an audio file. Send a .wav, .mp3, .m4a, .aac, .aif, .aiff, .flac, .ogg or .opus.`);
|
|
23
|
+
}
|
|
24
|
+
return file;
|
|
25
|
+
}
|
|
26
|
+
/**
|
|
27
|
+
* Every cue file the project names, once each, in manifest order. A stored one that isn't an
|
|
28
|
+
* audio file (a hand edit) is left out, so it is never served.
|
|
29
|
+
*/
|
|
30
|
+
export function cueFiles(project) {
|
|
31
|
+
const out = new Set();
|
|
32
|
+
for (const l of project.lanes) {
|
|
33
|
+
for (const v of l.variants)
|
|
34
|
+
for (const c of v.cues)
|
|
35
|
+
if (c.file !== undefined && isCueFile(c.file))
|
|
36
|
+
out.add(c.file);
|
|
37
|
+
}
|
|
38
|
+
return [...out];
|
|
39
|
+
}
|
package/dist/core/project.js
CHANGED
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import { basename } from "node:path";
|
|
2
2
|
import { newProjectId, slugify, uniqueId } from "./ids.js";
|
|
3
3
|
import { InvalidError, NotFoundError, RushesError } from "./errors.js";
|
|
4
|
+
import { checkCueFile } from "./cues.js";
|
|
4
5
|
import { MAX_FORMATS, durationWarning, ratioId, sameShape, settleLabel, versionFormats } from "./formats.js";
|
|
5
6
|
import { oneLineOf } from "./labels.js";
|
|
6
7
|
/** Sets `p.id` when missing. Returns whether it changed anything. */
|
|
@@ -81,6 +82,14 @@ function resolveVersion(video, versionId) {
|
|
|
81
82
|
}
|
|
82
83
|
const LANE_NAMES = { voice: "Voiceover", music: "Music", sfx: "Sound effects" };
|
|
83
84
|
export function addVariant(p, input) {
|
|
85
|
+
// §23: the cues first, so a cue refused for its file leaves the project untouched.
|
|
86
|
+
const cues = [];
|
|
87
|
+
for (const c of input.cues ?? []) {
|
|
88
|
+
const cue = { id: uniqueId(slugify(c.name), cues.map((x) => x.id)), name: c.name, t: c.t };
|
|
89
|
+
if (c.file !== undefined)
|
|
90
|
+
cue.file = checkCueFile(c.name, c.file);
|
|
91
|
+
cues.push(cue);
|
|
92
|
+
}
|
|
84
93
|
// Lane ids are capped at 64 by the schema; a slug can outgrow its source (NFKD splits ligatures).
|
|
85
94
|
const laneId = slugify(input.lane ?? input.round ?? input.stage).slice(0, 64).replace(/-+$/, "");
|
|
86
95
|
let lane = p.lanes.find((l) => l.id === laneId);
|
|
@@ -90,10 +99,6 @@ export function addVariant(p, input) {
|
|
|
90
99
|
lane = { id: laneId, stage: input.stage, name: input.round ?? input.lane ?? LANE_NAMES[input.stage], variants: [] };
|
|
91
100
|
p.lanes.push(lane);
|
|
92
101
|
}
|
|
93
|
-
const cues = [];
|
|
94
|
-
for (const c of input.cues ?? []) {
|
|
95
|
-
cues.push({ id: uniqueId(slugify(c.name), cues.map((x) => x.id)), name: c.name, t: c.t });
|
|
96
|
-
}
|
|
97
102
|
const variant = {
|
|
98
103
|
id: uniqueId(slugify(input.name), lane.variants.map((v) => v.id)),
|
|
99
104
|
name: input.name,
|
package/dist/core/schema.js
CHANGED
|
@@ -75,7 +75,14 @@ export const VideoSchema = z.object({
|
|
|
75
75
|
versions: z.array(VersionSchema).default([]),
|
|
76
76
|
lockedVersion: z.string().nullable().default(null),
|
|
77
77
|
});
|
|
78
|
-
export const CueSchema = z.object({
|
|
78
|
+
export const CueSchema = z.object({
|
|
79
|
+
id,
|
|
80
|
+
name: z.string().min(1),
|
|
81
|
+
t: seconds,
|
|
82
|
+
// §23: the sample placed at this cue, as a manifest path (CUE_FILE_MAX in cues.ts). Optional and
|
|
83
|
+
// absent on every older cue, so a 0.2.x project loads and writes back unchanged.
|
|
84
|
+
file: z.string().min(1).max(1024).optional(),
|
|
85
|
+
});
|
|
79
86
|
export const VariantSchema = z.object({
|
|
80
87
|
id,
|
|
81
88
|
name: z.string().min(1),
|
package/dist/mcp/tools.js
CHANGED
|
@@ -224,7 +224,19 @@ export function createMcpServer(ctx) {
|
|
|
224
224
|
.max(200)
|
|
225
225
|
.optional()
|
|
226
226
|
.describe("One line on what this read, bed or pass is, shown on its lane card. Stored as meta.description, and wins over one given in meta."),
|
|
227
|
-
cues: z
|
|
227
|
+
cues: z
|
|
228
|
+
.array(z.object({
|
|
229
|
+
name: z.string(),
|
|
230
|
+
t: z.number().nonnegative(),
|
|
231
|
+
// No .max here: the 1024 limit is on the stored path, so checkCueFile enforces it and names the cue (§23.6).
|
|
232
|
+
file: z
|
|
233
|
+
.string()
|
|
234
|
+
.min(1)
|
|
235
|
+
.optional()
|
|
236
|
+
.describe("Optional: the sample you placed at this cue (an audio file, a path of up to 1024 characters), so the user can see which it is and hear it on its own."),
|
|
237
|
+
}))
|
|
238
|
+
.optional()
|
|
239
|
+
.describe("SFX cues with times in seconds, each optionally with the `file` of its sample. Give a sound the same name every time it comes back: the tab groups cues by name."),
|
|
228
240
|
},
|
|
229
241
|
}, safe(async ({ project, ...b }) => (await ctx.client(project)).post("/api/variants", b)));
|
|
230
242
|
server.registerTool("rushes_set_script", {
|
package/dist/server/app.js
CHANGED
|
@@ -28,7 +28,7 @@ import { byOf, logBookFor } from "./logbook.js";
|
|
|
28
28
|
import { broughtInEvent, cutEvent, fileEvent, formatEvent, lineEvent, lockEvent, notesSentEvent, picksEvent, repliesEvent, scriptEvent, takeEvent, variantEvent, } from "../core/logEvents.js";
|
|
29
29
|
import { LOG_AREAS, LOG_MAX, changeLogFileName, logText, recentChanges } from "../core/logText.js";
|
|
30
30
|
import { defaultRunner, measureMix } from "./loudness.js";
|
|
31
|
-
export const VERSION = "0.
|
|
31
|
+
export const VERSION = "0.4.0";
|
|
32
32
|
async function body(c, schema) {
|
|
33
33
|
let json;
|
|
34
34
|
try {
|
|
@@ -113,7 +113,9 @@ const VariantBody = z.object({
|
|
|
113
113
|
file: z.string().min(1),
|
|
114
114
|
meta: z.record(z.string(), z.union([z.string(), z.number()])).optional(),
|
|
115
115
|
description: z.string().min(1).max(200).optional(),
|
|
116
|
-
|
|
116
|
+
// §23.6: a cue's file has no length cap here. The 1024 limit applies to the stored (manifest) form,
|
|
117
|
+
// which checkCueFile enforces with a 400 naming the cue.
|
|
118
|
+
cues: z.array(z.object({ name: z.string().min(1), t, file: z.string().min(1).optional() })).optional(),
|
|
117
119
|
});
|
|
118
120
|
const ScriptBody = z.object({
|
|
119
121
|
wordsPerSecond: z.number().positive().optional(),
|
|
@@ -1007,7 +1009,9 @@ export function createApp(store, opts = {}) {
|
|
|
1007
1009
|
});
|
|
1008
1010
|
app.post("/api/variants", async (c) => {
|
|
1009
1011
|
const b = await body(c, VariantBody);
|
|
1010
|
-
|
|
1012
|
+
// §23: a cue's file is stored as a manifest path, like the variant's own.
|
|
1013
|
+
const cues = b.cues?.map((q) => (q.file === undefined ? q : { ...q, file: toManifestPath(store.root, q.file) }));
|
|
1014
|
+
const { result } = await store.update("project", (p) => addVariant(p, { ...b, cues, file: toManifestPath(store.root, b.file) }));
|
|
1011
1015
|
await log.add(() => variantEvent(result.lane, result.variant), by(c));
|
|
1012
1016
|
return c.json(result, 201);
|
|
1013
1017
|
});
|
package/dist/server/assets.js
CHANGED
|
@@ -222,11 +222,12 @@ export async function listAssets(store, project, script) {
|
|
|
222
222
|
return [...screenshots, ...cuts, ...proxies, ...takes, ...voice, ...music, ...sfx, ...library];
|
|
223
223
|
}
|
|
224
224
|
/**
|
|
225
|
-
* Every path
|
|
226
|
-
*
|
|
227
|
-
*
|
|
228
|
-
*
|
|
229
|
-
*
|
|
225
|
+
* Every path the project knows, without stat'ing any of them: registered media (cuts, takes,
|
|
226
|
+
* variants -- present whether or not the file is actually there), plus every *.png directly
|
|
227
|
+
* inside screenshots/ and .rushes/grabs/ whose name the matching safe-name regex would let /media
|
|
228
|
+
* serve. That is everything `/api/assets` lists and also cue samples (§23), which Assets doesn't
|
|
229
|
+
* list (§23.7). POST /api/reveal and /api/open use this to check a path cheaply, stat'ing only
|
|
230
|
+
* the one file they actually need instead of every asset in the project.
|
|
230
231
|
*/
|
|
231
232
|
export async function candidatePaths(store, project, script) {
|
|
232
233
|
const paths = registeredMedia(project, script);
|
package/dist/server/files.js
CHANGED
|
@@ -2,6 +2,7 @@ import { createReadStream } from "node:fs";
|
|
|
2
2
|
import { lstat, realpath, stat } from "node:fs/promises";
|
|
3
3
|
import { extname, isAbsolute, join, normalize, sep } from "node:path";
|
|
4
4
|
import { Readable } from "node:stream";
|
|
5
|
+
import { cueFiles } from "../core/cues.js";
|
|
5
6
|
import { VIDEO_EXT } from "../core/media.js";
|
|
6
7
|
import { PROXY_PATH } from "./proxy.js";
|
|
7
8
|
export const CONTENT_TYPES = {
|
|
@@ -82,6 +83,9 @@ export function registeredMedia(project, script) {
|
|
|
82
83
|
for (const l of project.lanes)
|
|
83
84
|
for (const variant of l.variants)
|
|
84
85
|
files.add(variant.file);
|
|
86
|
+
// §23: each cue's sample, when it is an audio file; served only because it is registered.
|
|
87
|
+
for (const f of cueFiles(project))
|
|
88
|
+
files.add(f);
|
|
85
89
|
for (const s of script.sections)
|
|
86
90
|
for (const t of s.takes)
|
|
87
91
|
files.add(t.file);
|
package/dist/server/found.js
CHANGED
|
@@ -7,6 +7,7 @@ import { slugify } from "../core/ids.js";
|
|
|
7
7
|
import { AUDIO_FORMATS, probe as ffprobe } from "../core/media.js";
|
|
8
8
|
import { fromManifestPath, toManifestPath } from "../core/paths.js";
|
|
9
9
|
import { addFile, addVariant, addVersion, resolveVideo } from "../core/project.js";
|
|
10
|
+
import { cueFiles } from "../core/cues.js";
|
|
10
11
|
import { logBookFor } from "./logbook.js";
|
|
11
12
|
import { broughtInEvent, cutName } from "../core/logEvents.js";
|
|
12
13
|
/** The audio kinds, which an include can settle. */
|
|
@@ -217,7 +218,7 @@ export function foundAnnouncer(store) {
|
|
|
217
218
|
store.emit("change", { file: "found", rev: ++seq });
|
|
218
219
|
};
|
|
219
220
|
}
|
|
220
|
-
/** Every manifest path the project has registered: cuts and their formats, variants, library files and script takes. */
|
|
221
|
+
/** Every manifest path the project has registered: cuts and their formats, variants, cue samples, library files and script takes. */
|
|
221
222
|
export function registeredPaths(project, script) {
|
|
222
223
|
const out = [];
|
|
223
224
|
for (const v of project.videos) {
|
|
@@ -231,6 +232,9 @@ export function registeredPaths(project, script) {
|
|
|
231
232
|
for (const l of project.lanes)
|
|
232
233
|
for (const variant of l.variants)
|
|
233
234
|
out.push(variant.file);
|
|
235
|
+
// §23: a cue's sample is part of its pass, not a pass of its own to bring in.
|
|
236
|
+
for (const f of cueFiles(project))
|
|
237
|
+
out.push(f);
|
|
234
238
|
for (const f of project.files)
|
|
235
239
|
out.push(f.file);
|
|
236
240
|
for (const s of script.sections)
|
package/package.json
CHANGED
package/skills/rushes/SKILL.md
CHANGED
|
@@ -13,7 +13,7 @@ If the user pastes a prompt copied from a locked tab, act on it directly — it
|
|
|
13
13
|
- `rushes_add_version` for a render. Give every cut a short `label` (48 characters at most) saying what changed, and put the detail in `note`. If the cut is likely to play badly in a browser, the reply carries `proxySuggested: true` and `proxyReason`; Picture offers the user a proxy. Prefer H.264 MP4 to avoid this;
|
|
14
14
|
- `rushes_add_format` for each other shape of a cut (a 9:16, 1:1 or 4:5 of the same edit): register every shape you rendered, main one first, or pass `formats: [{ file }]` to `rushes_add_version`. Its `label` is only a ratio hint such as 2.39:1, never the cut's short label;
|
|
15
15
|
- `rushes_set_script` for the VO script. It merges by `id`, so send only the sections you changed; sections you leave out are kept. `rushes_get_script` reads the whole script;
|
|
16
|
-
- `rushes_add_variant` for each voice read, music bed or SFX pass. Voice reads carry `stage: "voice"` and a `round` (its name — reads in one round are compared side by side; a new direction gets a new round); say what the read is, or what changed, in `description`. Music and SFX carry `meta.description` for their lane card;
|
|
16
|
+
- `rushes_add_variant` for each voice read, music bed or SFX pass. Voice reads carry `stage: "voice"` and a `round` (its name — reads in one round are compared side by side; a new direction gets a new round); say what the read is, or what changed, in `description`. Music and SFX carry `meta.description` for their lane card, and SFX passes carry `cues` as `{name, t, file?}`: the same name each time a sound comes back, and `file` (an audio file) when you know which sample you placed;
|
|
17
17
|
- `rushes_set_shots` for the storyboard's shots, once you have the first cut; send new timings when a later cut moves them.
|
|
18
18
|
2. Call `rushes_open` and tell the user it's ready, with what it brought in and what it left (below). Each project's dashboard lives at its own address, `/p/<id>/`.
|
|
19
19
|
3. When the user sends a batch, call `rushes_get_batch` and fix every note in it. A note carries the `shot` it falls in; on an audio stage, call `rushes_get_picks` first — on Mix it also returns `levels` (dB per lane), which you read, not set. Its `on` says what it's about: `"<lane>/<variant>"` for a bed, pass or voice read (on Voiceover the lane names the round), `"<lane>/<variant>:<cue>"` for an SFX cue, `"vo"` for the Mix VO lane, or `null` for the whole mix; older notes may carry a section id or `"<section>:<take>"`. On Music, Sound effects and Mix treat `marks` (e.g. "Fall", "Quieter 3 dB") as part of the note; Voiceover notes carry none — they're Whole (`Speaker`, `Pacing`, `Tone`, `Overall`) or Point (`Fix this`, `Keep this`) instead. A Picture note's `format` is null for every format, or a format id such as `"9x16"`: when it isn't null, fix only that format. Picks are set from the dashboard only — no tool or CLI command sets one.
|