demoman 0.9.3 → 0.9.4
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 +1 -1
- package/THIRD_PARTY_NOTICES +1 -1
- package/dist/cli.mjs +34844 -0
- package/dist/demoman.mjs +7 -34429
- package/dist/page/executor-entry.js +43 -3
- package/dist/page/mux-entry.js +23 -18
- package/dist/page/render-entry.js +18 -17
- package/dist/recipe.md +19 -20
- package/dist/studio/assets/{editor-B0QH2SX6.js → editor-PQAWxnr8.js} +1 -1
- package/dist/studio/assets/{library-5-DKU9o1.js → library-DhAZ4-QM.js} +1 -1
- package/dist/studio/assets/{settings-DEDyzRMN.js → settings-C8S32Yjl.js} +1 -1
- package/dist/studio/assets/{state-BoH98Hy3.js → state-nRiGhQ0_.js} +1 -1
- package/dist/studio/assets/{toast-B_KSsgnJ.js → toast-D-n2UDmc.js} +1 -1
- package/dist/studio/assets/{view-DWP5EfCT.js → view-BAVIEhJQ.js} +1 -1
- package/dist/studio/editor.html +4 -4
- package/dist/studio/library.html +3 -3
- package/dist/studio/settings.html +3 -3
- package/dist/studio/studio-build.json +3 -3
- package/package.json +2 -2
|
@@ -1638,7 +1638,40 @@
|
|
|
1638
1638
|
|
|
1639
1639
|
// ../../packages/run-core/dist/url.js
|
|
1640
1640
|
var PLACEHOLDER = "redacted";
|
|
1641
|
+
var UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
|
|
1642
|
+
function charClass(c) {
|
|
1643
|
+
if (c >= "a" && c <= "z")
|
|
1644
|
+
return "l";
|
|
1645
|
+
if (c >= "A" && c <= "Z")
|
|
1646
|
+
return "u";
|
|
1647
|
+
if (c >= "0" && c <= "9")
|
|
1648
|
+
return "d";
|
|
1649
|
+
return null;
|
|
1650
|
+
}
|
|
1651
|
+
function looksLikeToken(raw) {
|
|
1652
|
+
let segment;
|
|
1653
|
+
try {
|
|
1654
|
+
segment = decodeURIComponent(raw);
|
|
1655
|
+
} catch {
|
|
1656
|
+
segment = raw;
|
|
1657
|
+
}
|
|
1658
|
+
if (!/^[\w.~+=-]{20,}$/.test(segment) || UUID.test(segment))
|
|
1659
|
+
return false;
|
|
1660
|
+
const classes = [...segment].map(charClass).filter((c) => c !== null);
|
|
1661
|
+
let switches = 0;
|
|
1662
|
+
for (let i = 1; i < classes.length; i++) {
|
|
1663
|
+
if (classes[i] !== classes[i - 1])
|
|
1664
|
+
switches++;
|
|
1665
|
+
}
|
|
1666
|
+
return switches * (/[A-Z]/.test(segment) ? 3 : 4) >= segment.length;
|
|
1667
|
+
}
|
|
1641
1668
|
function scrubUrl(raw) {
|
|
1669
|
+
return scrub(raw, true);
|
|
1670
|
+
}
|
|
1671
|
+
function pageKey(raw) {
|
|
1672
|
+
return scrub(raw, false);
|
|
1673
|
+
}
|
|
1674
|
+
function scrub(raw, path) {
|
|
1642
1675
|
let url;
|
|
1643
1676
|
try {
|
|
1644
1677
|
url = new URL(raw);
|
|
@@ -1648,7 +1681,9 @@
|
|
|
1648
1681
|
url.username = "";
|
|
1649
1682
|
url.password = "";
|
|
1650
1683
|
url.hash = "";
|
|
1651
|
-
|
|
1684
|
+
if (path) {
|
|
1685
|
+
url.pathname = url.pathname.split("/").map((segment) => looksLikeToken(segment) || scrubSecrets(segment) !== segment ? PLACEHOLDER : segment).join("/");
|
|
1686
|
+
}
|
|
1652
1687
|
for (const key of Array.from(new Set(url.searchParams.keys()))) {
|
|
1653
1688
|
url.searchParams.set(key, PLACEHOLDER);
|
|
1654
1689
|
}
|
|
@@ -1666,9 +1701,10 @@
|
|
|
1666
1701
|
failureReason: report.failureReason
|
|
1667
1702
|
};
|
|
1668
1703
|
if (resolved && report.element !== null) {
|
|
1704
|
+
const href = window.location.href;
|
|
1669
1705
|
const { anchor } = await captureAnchor(report.element, {
|
|
1670
1706
|
anchorId: intent.id,
|
|
1671
|
-
url: scrubUrl(
|
|
1707
|
+
url: scrubUrl(href),
|
|
1672
1708
|
// No step index exists yet for a freshly authored anchor;
|
|
1673
1709
|
// driftPick's own remap capture makes the same choice.
|
|
1674
1710
|
actionIndex: 0,
|
|
@@ -1692,6 +1728,7 @@
|
|
|
1692
1728
|
failureReason: null,
|
|
1693
1729
|
intentResolution,
|
|
1694
1730
|
pageUrl: null,
|
|
1731
|
+
here: pageKey(href),
|
|
1695
1732
|
document: documentOf(),
|
|
1696
1733
|
...credentialField === void 0 ? {} : { credentialField }
|
|
1697
1734
|
};
|
|
@@ -1711,6 +1748,7 @@
|
|
|
1711
1748
|
// frame knows which document just failed to resolve the intent. Scrubbed
|
|
1712
1749
|
// like every other URL that leaves the page.
|
|
1713
1750
|
pageUrl: scrubUrl(window.location.href),
|
|
1751
|
+
here: pageKey(window.location.href),
|
|
1714
1752
|
document: documentOf(),
|
|
1715
1753
|
// No element to ask: when the caller checks credentials, that is "could
|
|
1716
1754
|
// not tell", which a typed step hides (launch C spec 3.5).
|
|
@@ -1842,8 +1880,10 @@
|
|
|
1842
1880
|
fields.push({ target, value });
|
|
1843
1881
|
}
|
|
1844
1882
|
const notListed = candidates.length - END_PAGE_MAX_FIELDS;
|
|
1883
|
+
const href = doc.location?.href;
|
|
1845
1884
|
return {
|
|
1846
|
-
|
|
1885
|
+
// Written to `report.json`: scrubbed like every address that is.
|
|
1886
|
+
url: href === void 0 ? "" : scrubUrl(href),
|
|
1847
1887
|
text,
|
|
1848
1888
|
fields,
|
|
1849
1889
|
...notListed > 0 ? { fieldsNotListed: notListed } : {}
|
package/dist/page/mux-entry.js
CHANGED
|
@@ -16208,14 +16208,14 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
|
|
|
16208
16208
|
* unchanged, but its MEANING narrows: this now records which frames PLAY,
|
|
16209
16209
|
* not which the author chose. The editor writes it nowhere — since
|
|
16210
16210
|
* 2026-09-28 every write the editor makes carries the store's current
|
|
16211
|
-
* value (`persist()` in `apps/
|
|
16212
|
-
* writers
|
|
16213
|
-
*
|
|
16214
|
-
*
|
|
16215
|
-
*
|
|
16216
|
-
*
|
|
16217
|
-
*
|
|
16218
|
-
*
|
|
16211
|
+
* value (`persist()` in `apps/studio/pages/src/editor/session.ts`). Two
|
|
16212
|
+
* writers set it, both outside the editor: `assembleAuthored`
|
|
16213
|
+
* (`@demoman/replay-engine`) writes `screen` on every new take, and the
|
|
16214
|
+
* library card's "Back to your recording"
|
|
16215
|
+
* (`apps/studio/pages/entrypoints/library/main.ts`) sets `screen`. Nothing writes `demo` today; it is
|
|
16216
|
+
* read from takes the retired extension re-shot. Neither writer deletes
|
|
16217
|
+
* anything — the recording stays on disk under either mode
|
|
16218
|
+
* (`chooseActiveBundle`'s own docblock) — so a re-shoot that turns
|
|
16219
16219
|
* out worse than the recording is always reversible by writing this field
|
|
16220
16220
|
* back.
|
|
16221
16221
|
*/
|
|
@@ -16763,9 +16763,10 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
|
|
|
16763
16763
|
branding: ScriptBrandingSchema.optional(),
|
|
16764
16764
|
/**
|
|
16765
16765
|
* One of the author's brand kits, by the name Settings shows (case and
|
|
16766
|
-
* surrounding space ignored). Resolved by the
|
|
16767
|
-
* door; a name that is not
|
|
16768
|
-
* replaced by the default kit
|
|
16766
|
+
* surrounding space ignored). Resolved by the runner at the run's
|
|
16767
|
+
* door (`lookForRun`, in `@demoman/run-core`); a name that is not
|
|
16768
|
+
* there is refused (`unknownKit`), never replaced by the default kit
|
|
16769
|
+
* (spec 2026-10-08 §3).
|
|
16769
16770
|
*/
|
|
16770
16771
|
kit: external_exports.string().trim().min(1).optional(),
|
|
16771
16772
|
cursor: CursorSchema.optional(),
|
|
@@ -16938,9 +16939,9 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
|
|
|
16938
16939
|
verticalMaxScale: 1.15,
|
|
16939
16940
|
/**
|
|
16940
16941
|
* CSS px of page kept round a zoomed target on every side, so its edges
|
|
16941
|
-
* and the cursor on it are not flush with the frame.
|
|
16942
|
-
*
|
|
16943
|
-
*
|
|
16942
|
+
* and the cursor on it are not flush with the frame. Generated zooms fit
|
|
16943
|
+
* against the capture viewport with it (`zoomsForClicks`,
|
|
16944
|
+
* `@demoman/run-core`); a `cover` render fits against its own crop with it
|
|
16944
16945
|
* (`solveCamera`'s `fitWindow`).
|
|
16945
16946
|
*/
|
|
16946
16947
|
fitMarginPx: 24,
|
|
@@ -16954,8 +16955,8 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
|
|
|
16954
16955
|
*/
|
|
16955
16956
|
actSettleMs: 400,
|
|
16956
16957
|
/**
|
|
16957
|
-
* The push-in and the pull-out at the DEFAULT smoothness — what
|
|
16958
|
-
*
|
|
16958
|
+
* The push-in and the pull-out at the DEFAULT smoothness — what
|
|
16959
|
+
* `@demoman/run-core` sizes a fresh zoom's length by (`zoom-defaults.ts`) and the
|
|
16959
16960
|
* editor draws an unauthored end with. A render reads the document's own
|
|
16960
16961
|
* smoothness through `motionTimings`, so these are the timings of a take
|
|
16961
16962
|
* that never touched the slider, not of every take.
|
|
@@ -26805,7 +26806,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
|
|
|
26805
26806
|
},
|
|
26806
26807
|
// Bytes or a reason, never an empty array: a 0-byte file stored as a
|
|
26807
26808
|
// successful output is a Download button that does nothing, and the
|
|
26808
|
-
// render loop, the
|
|
26809
|
+
// render loop, the runner's render page and the editor all read `bytes` as
|
|
26809
26810
|
// "it worked".
|
|
26810
26811
|
async finish() {
|
|
26811
26812
|
finished = true;
|
|
@@ -26901,7 +26902,11 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
|
|
|
26901
26902
|
const blob = await response.blob();
|
|
26902
26903
|
const bitmap = await createImageBitmap(blob);
|
|
26903
26904
|
try {
|
|
26904
|
-
|
|
26905
|
+
const evened = [0, 1].includes(bitmap.width - manifest.width) && [0, 1].includes(bitmap.height - manifest.height);
|
|
26906
|
+
if (evened)
|
|
26907
|
+
ctx.drawImage(bitmap, 0, 0);
|
|
26908
|
+
else
|
|
26909
|
+
ctx.drawImage(bitmap, 0, 0, manifest.width, manifest.height);
|
|
26905
26910
|
} finally {
|
|
26906
26911
|
bitmap.close();
|
|
26907
26912
|
}
|
|
@@ -16337,14 +16337,14 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
|
|
|
16337
16337
|
* unchanged, but its MEANING narrows: this now records which frames PLAY,
|
|
16338
16338
|
* not which the author chose. The editor writes it nowhere — since
|
|
16339
16339
|
* 2026-09-28 every write the editor makes carries the store's current
|
|
16340
|
-
* value (`persist()` in `apps/
|
|
16341
|
-
* writers
|
|
16342
|
-
*
|
|
16343
|
-
*
|
|
16344
|
-
*
|
|
16345
|
-
*
|
|
16346
|
-
*
|
|
16347
|
-
*
|
|
16340
|
+
* value (`persist()` in `apps/studio/pages/src/editor/session.ts`). Two
|
|
16341
|
+
* writers set it, both outside the editor: `assembleAuthored`
|
|
16342
|
+
* (`@demoman/replay-engine`) writes `screen` on every new take, and the
|
|
16343
|
+
* library card's "Back to your recording"
|
|
16344
|
+
* (`apps/studio/pages/entrypoints/library/main.ts`) sets `screen`. Nothing writes `demo` today; it is
|
|
16345
|
+
* read from takes the retired extension re-shot. Neither writer deletes
|
|
16346
|
+
* anything — the recording stays on disk under either mode
|
|
16347
|
+
* (`chooseActiveBundle`'s own docblock) — so a re-shoot that turns
|
|
16348
16348
|
* out worse than the recording is always reversible by writing this field
|
|
16349
16349
|
* back.
|
|
16350
16350
|
*/
|
|
@@ -16939,9 +16939,10 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
|
|
|
16939
16939
|
branding: ScriptBrandingSchema.optional(),
|
|
16940
16940
|
/**
|
|
16941
16941
|
* One of the author's brand kits, by the name Settings shows (case and
|
|
16942
|
-
* surrounding space ignored). Resolved by the
|
|
16943
|
-
* door; a name that is not
|
|
16944
|
-
* replaced by the default kit
|
|
16942
|
+
* surrounding space ignored). Resolved by the runner at the run's
|
|
16943
|
+
* door (`lookForRun`, in `@demoman/run-core`); a name that is not
|
|
16944
|
+
* there is refused (`unknownKit`), never replaced by the default kit
|
|
16945
|
+
* (spec 2026-10-08 §3).
|
|
16945
16946
|
*/
|
|
16946
16947
|
kit: external_exports.string().trim().min(1).optional(),
|
|
16947
16948
|
cursor: CursorSchema.optional(),
|
|
@@ -17957,9 +17958,9 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
|
|
|
17957
17958
|
verticalMaxScale: 1.15,
|
|
17958
17959
|
/**
|
|
17959
17960
|
* CSS px of page kept round a zoomed target on every side, so its edges
|
|
17960
|
-
* and the cursor on it are not flush with the frame.
|
|
17961
|
-
*
|
|
17962
|
-
*
|
|
17961
|
+
* and the cursor on it are not flush with the frame. Generated zooms fit
|
|
17962
|
+
* against the capture viewport with it (`zoomsForClicks`,
|
|
17963
|
+
* `@demoman/run-core`); a `cover` render fits against its own crop with it
|
|
17963
17964
|
* (`solveCamera`'s `fitWindow`).
|
|
17964
17965
|
*/
|
|
17965
17966
|
fitMarginPx: 24,
|
|
@@ -17973,8 +17974,8 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
|
|
|
17973
17974
|
*/
|
|
17974
17975
|
actSettleMs: 400,
|
|
17975
17976
|
/**
|
|
17976
|
-
* The push-in and the pull-out at the DEFAULT smoothness — what
|
|
17977
|
-
*
|
|
17977
|
+
* The push-in and the pull-out at the DEFAULT smoothness — what
|
|
17978
|
+
* `@demoman/run-core` sizes a fresh zoom's length by (`zoom-defaults.ts`) and the
|
|
17978
17979
|
* editor draws an unauthored end with. A render reads the document's own
|
|
17979
17980
|
* smoothness through `motionTimings`, so these are the timings of a take
|
|
17980
17981
|
* that never touched the slider, not of every take.
|
|
@@ -47284,7 +47285,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
|
|
|
47284
47285
|
},
|
|
47285
47286
|
// Bytes or a reason, never an empty array: a 0-byte file stored as a
|
|
47286
47287
|
// successful output is a Download button that does nothing, and the
|
|
47287
|
-
// render loop, the
|
|
47288
|
+
// render loop, the runner's render page and the editor all read `bytes` as
|
|
47288
47289
|
// "it worked".
|
|
47289
47290
|
async finish() {
|
|
47290
47291
|
finished = true;
|
package/dist/recipe.md
CHANGED
|
@@ -13,8 +13,8 @@ user; section 7 lists every reason.
|
|
|
13
13
|
`secretsFile` are the demo accounts below.
|
|
14
14
|
2. The browser is signed in only where the user ran `npx demoman signin <url>`
|
|
15
15
|
(`status.sessions` lists them). A demo account records best. A page
|
|
16
|
-
that sends this browser to its sign-in page answers `signedOut`
|
|
17
|
-
|
|
16
|
+
that sends this browser to its sign-in page answers `signedOut` with
|
|
17
|
+
the exact command in `detail`: give the user that command and
|
|
18
18
|
spend no run until they say they have run it, unless a demo account can
|
|
19
19
|
sign in (below). Only demo accounts: never ask for the
|
|
20
20
|
user's own password, or type it. A sign-in or sign-up demo is not
|
|
@@ -41,8 +41,7 @@ user; section 7 lists every reason.
|
|
|
41
41
|
`sessionsUnreadable`, when present: the saved sessions could not be read; tell the user.
|
|
42
42
|
|
|
43
43
|
`status.sessions` lists an account's saved session with an `account` (and
|
|
44
|
-
`origin`) beside `site`;
|
|
45
|
-
`npx demoman signin <url>`.
|
|
44
|
+
`origin`) beside `site`; one without is a manual `npx demoman signin` session.
|
|
46
45
|
|
|
47
46
|
`status.secretsFile` is `null` (no usable accounts file), `{path, absent:
|
|
48
47
|
true}` (no secrets file: only `DEMOMAN_SECRET_*` can supply values),
|
|
@@ -136,7 +135,7 @@ The file, with one account:
|
|
|
136
135
|
once more when a call lands on a sign-in page; `signedIn`
|
|
137
136
|
(`{account, steps, ms}`) says it did. A second failure answers
|
|
138
137
|
`signInFailed`. A session that lapses mid-run keeps no video; Demoman has
|
|
139
|
-
signed in again:
|
|
138
|
+
signed in again: run again.
|
|
140
139
|
|
|
141
140
|
## 2. Look at the page
|
|
142
141
|
|
|
@@ -148,11 +147,11 @@ targets, leaving the page open. Each entry is
|
|
|
148
147
|
translate a name from another tool's accessibility tree: Demoman's roles
|
|
149
148
|
are not Chrome's.
|
|
150
149
|
- `landedElsewhere: true` - the app redirected, often to its sign-in page;
|
|
151
|
-
`landedUrl` says where. If it is a sign-in page,
|
|
152
|
-
|
|
150
|
+
`landedUrl` says where. If it is a sign-in page,
|
|
151
|
+
see `session` below and spend no run. If it is not a sign-in page (a
|
|
153
152
|
trailing slash, `https`, a locale prefix), use `landedUrl` as the
|
|
154
153
|
script's `target`; this snapshot stands.
|
|
155
|
-
`landedElsewhere: null
|
|
154
|
+
`landedElsewhere: null`: the address could not be read; not an
|
|
156
155
|
all-clear.
|
|
157
156
|
- `session` - `"saved"`: a session is saved for this site; `"none"`: none
|
|
158
157
|
is (normal for a public page); `"signedOut"`: the page is a sign-in page,
|
|
@@ -163,8 +162,8 @@ targets, leaving the page open. Each entry is
|
|
|
163
162
|
`"none"` or `"unchecked"` means the same. Tell the user to run
|
|
164
163
|
`npx demoman signin <the page to record>`; spend no run. Otherwise on
|
|
165
164
|
`"unchecked"`, carry on only if `landedUrl` is not a sign-in page.
|
|
166
|
-
- `settled: false` - the page was still loading; `settleNote` says what
|
|
167
|
-
|
|
165
|
+
- `settled: false` - the page was still loading; `settleNote` says what
|
|
166
|
+
was left. Snapshot again before concluding something is absent.
|
|
168
167
|
- `rect` is in page coordinates; `inFirstViewport`: in view before any
|
|
169
168
|
scroll. `rect: null`: no box yet (a closed FAQ answer), still a valid
|
|
170
169
|
`waitFor … until: "visible"` target after the step that opens it.
|
|
@@ -179,15 +178,14 @@ targets, leaving the page open. Each entry is
|
|
|
179
178
|
(name, text, stableId, kind, value) to narrow. `containsNote`: no match.
|
|
180
179
|
- A snapshot sees only the page as it loads: hidden content in the
|
|
181
180
|
page is listed; content a click creates (a menu, dialog, results, a new row) is not. To list it, `probe` your script
|
|
182
|
-
cut off after the step that opens it, and copy targets from that answer. A probe acts on the app for real
|
|
181
|
+
cut off after the step that opens it, and copy targets from that answer. A probe acts on the app for real: an "Add item"
|
|
183
182
|
in it can make a unique target ambiguous in the run; in the Studio an edit saves into the video. `stopped`: a step did not play; fix it as a
|
|
184
183
|
run's stop with that reason says, and probe again.
|
|
185
184
|
|
|
186
185
|
### Recording a phone demo
|
|
187
186
|
|
|
188
187
|
1. Call `snapshot` with `device` (`"phone"` or `"tablet"`), and
|
|
189
|
-
copy targets from that answer only
|
|
190
|
-
desktop target is often not on it.
|
|
188
|
+
copy targets from that answer only, never a desktop one.
|
|
191
189
|
2. `run` a script that names the same `device`.
|
|
192
190
|
3. Leave `look.canvas` at `auto`, which comes out portrait, or name `9:16`.
|
|
193
191
|
4. No `hover` steps: tap instead.
|
|
@@ -251,7 +249,8 @@ A flow in the repo (.demoman/flows) is rewritten by each run: commit that file w
|
|
|
251
249
|
`possibleDuplicate` lists `matches`: use one's `id`, or repeat with
|
|
252
250
|
`confirmedNew: true` for a different flow. `nameTaken` names the
|
|
253
251
|
`holder`: use its `id` or another name. The report's `flow`
|
|
254
|
-
says what was made.
|
|
252
|
+
says what was made; `flow.otherRepo`: joined another
|
|
253
|
+
repo's flow; tell the user.
|
|
255
254
|
1. `run(script, flow)`. It answers the run's report, or
|
|
256
255
|
`{ "outcome": "stillRunning", "id": … }` after about 50 s; then call
|
|
257
256
|
`report(id)` until the outcome is neither `running` nor `stillRunning`.
|
|
@@ -488,12 +487,12 @@ Studio exports go to `~/Downloads`.
|
|
|
488
487
|
| `sessionNotLoaded` | `snapshot`, `run`¹ | The browser refused the saved sessions; `detail` says why. Tell the user to run `npx demoman signin` again there. |
|
|
489
488
|
| `signInFailed` | `snapshot`, `run`¹ | Signed in as the account, the page still showed a sign-in page, or a step could not run; `detail` says where. It tried once. Fix the account's steps or secret, or tell the user; do not rerun unchanged. |
|
|
490
489
|
| `secretMissing` | `snapshot`, `run`¹, `ci` | No `DEMOMAN_SECRET_NAME` for a `{secret:NAME}` in the environment (unused through `project`) or `.demoman/secrets.env`; `detail` names both. Write one (section 1) or ask the user; `ci`: give the person `command`. |
|
|
491
|
-
| `secretTooShort` | `snapshot`, `run`¹, `ci` |
|
|
490
|
+
| `secretTooShort` | `snapshot`, `run`¹, `ci` | Secret `NAME` is under 8 characters. Write a longer one; `ci`: give the person `command`. |
|
|
492
491
|
| `secretUnbound` | `snapshot`, `run`¹ | `DEMOMAN_SECRET_NAME` has no `DEMOMAN_SECRET_NAME_ORIGIN` beside it, or one that is no origin; `detail` names the line and site. Nothing typed. Add it to `secrets.env` for an account you made; else tell the user. |
|
|
493
492
|
| `secretOffOrigin` | `snapshot`, `run`¹ | A secret was about to be typed off its site: a sign-in step's page is not the site's origin, or the `_ORIGIN` names another site; `detail` names both. Nothing typed. Check the account's site and `goto`, then tell the user. |
|
|
494
493
|
| `secretsFileNotIgnored` | `snapshot`, `run`¹ | Git does not ignore `.demoman/secrets.env`, so Demoman did not read it. Add it to `.gitignore` (`detail` says the line), or untrack it. |
|
|
495
494
|
| `secretsFileInvalid` | `snapshot`, `run`¹ | A line of `.demoman/secrets.env` is not `DEMOMAN_SECRET_NAME=value`, a comment or blank; `detail` gives the line. Fix it. |
|
|
496
|
-
| `accountsInvalid` | `snapshot`, `run`¹ | `.demoman/accounts.json` is malformed or breaks a rule; `detail` names
|
|
495
|
+
| `accountsInvalid` | `snapshot`, `run`¹ | `.demoman/accounts.json` is malformed or breaks a rule; `detail` names it. Fix the file. |
|
|
497
496
|
| `unknownAccount` | `snapshot`, `run`¹ | The script names an account the site lacks, or none and the site has no `default`; `detail` lists the accounts. Name one, or add it (section 1). |
|
|
498
497
|
| `invalidProject` | `snapshot`, `run`¹, `attach` | `project` is not an absolute path to a folder. Pass one, or leave it out. |
|
|
499
498
|
| `ghMissing`, `ghOutdated`, `ghSignedOut`, `notGitHub`, `prNotFound`, `prUnreadable` | `attach`¹, `ci` | `gh` is missing, too old or signed out; not a GitHub remote; no such PR, or GitHub did not answer. Nothing posted; do as `detail` says. |
|
|
@@ -509,14 +508,14 @@ Studio exports go to `~/Downloads`.
|
|
|
509
508
|
| `browserSilent` | `status`, `flows`, `derive`, `report` | The browser did not answer in about 50 s. Call `status` once; if again, tell the user. From `report` the run may still be going: call `report(id)` again. |
|
|
510
509
|
| `libraryUnreadable` | `flows`, `studio` | Unreadable; report it. |
|
|
511
510
|
| `libraryUnwritable` | `run` (in `notStored`) | Not a `reason`: the report has a `notStored` entry `{ "what": "video", "error": … }` and a null `provenance.videoId`. Nothing saved; quote the `error`. |
|
|
512
|
-
| `unknownRun` | `report` | This demoman-mcp never issued that id (ids do not survive a
|
|
511
|
+
| `unknownRun` | `report` | This demoman-mcp never issued that id, or let it go (it keeps the last 50 finished; ids do not survive a restart). |
|
|
513
512
|
| `noReport` | `report` | No report for that id: this server keeps only its latest; `detail` says which. Do not run again. |
|
|
514
513
|
| `notAnObject` | `run` | The script is not a JSON object. |
|
|
515
514
|
| `invalidScript` | `run` | The schema refused the script; `field` names where. |
|
|
516
515
|
| `unfilledHoles` | `run` | A derived draft still has holes (section 3); also a re-film of a video that did not keep a value. |
|
|
517
516
|
| `flowRequired` | `run`¹ | No `flow` was given. Find one (section 4), or pass `{ new }`. |
|
|
518
517
|
| `possibleDuplicate`, `nameTaken` | `run`¹ | A similar flow exists (`matches`) or the name is taken (`holder`). Section 4. |
|
|
519
|
-
| `repoFlowNameTaken`, `duplicateFlow`, `repoFlowUnreadable` | `run`¹; the first two also `flows` with `file` | Repo flows: this library has another flow with that name (`detail` gives the `join-flow` command to tell the user); two files in `.demoman/flows` or the old folder before it name one flow (delete one); a file there will not read (`detail` names it
|
|
518
|
+
| `repoFlowNameTaken`, `duplicateFlow`, `repoFlowUnreadable` | `run`¹; the first two also `flows` with `file` | Repo flows: this library has another flow with that name (`detail` gives the `join-flow` command to tell the user); two files in `.demoman/flows` or the old folder before it name one flow (delete one); a file there will not read (`detail` names it and the fix). |
|
|
520
519
|
| `flowNotFound` | `run`¹ | No flow has that `id`; call `flows`. |
|
|
521
520
|
| `wrongIdKind` | any | Wrong kind of id; see `detail`. |
|
|
522
521
|
| `flowUnreadable`, `flowUnwritable` | `run`¹, `flows` | The flow records could not be read or written; quote `detail`. Nothing recorded. |
|
|
@@ -536,7 +535,7 @@ Studio exports go to `~/Downloads`.
|
|
|
536
535
|
| `invalidQuality`, `invalidMaxMB` | `export`¹, `attach` | Through these tools, only `quality` or `maxMB` given for a GIF or stills; the schema rejects a bad value first. |
|
|
537
536
|
| `noVideoId`, `noFrames` | `export`¹ | No video id; no frames to render. |
|
|
538
537
|
| `videoNotFound`, `videoUnreadable` | `export`¹, `run` re-film ¹, `studio` (`videoNotFound`: call `flows`) | No such video; it could not be read (or, for `run`, built into a script). |
|
|
539
|
-
| `unresolvedAnchor`, `anchorNotRendered`, `waitTimeout` | `run`² | The target was not there in the 10 s a step waits, or a `waitFor`/`waitForLoad` timed out. Check it against a `snapshot` and the step before; `scrollTo` first in a long list. |
|
|
538
|
+
| `unresolvedAnchor`, `anchorNotRendered`, `waitTimeout` | `run`² | The target was not there in the 10 s a step waits, or a `waitFor`/`waitForLoad` timed out. Check it against a `snapshot` and the step before; `scrollTo` first in a long list. A `detail` naming a closed shadow root: its targets can't be reached; pick one outside. |
|
|
540
539
|
| `ambiguousAnchor` | `run`² | Several elements matched; name the target more exactly. |
|
|
541
540
|
| `anchorFrameMismatch`, `anchorUnreachable`, `occlusionTimeout` | `run`² | `anchorFrameMismatch`: its frame changed; pick another target. The others are not the script (unmeasurable, or window covered): run again once. |
|
|
542
541
|
| `pageWentElsewhere`, `unperformableStep` | `run`² | The app left the page unasked (sign-in expired, or a missing `waitForLoad`); or the step asks the impossible. |
|
|
@@ -549,7 +548,7 @@ Studio exports go to `~/Downloads`.
|
|
|
549
548
|
| `pageFaulted`, `snapshotThrew`, `probeThrew` | `snapshot`, `probe` | The page threw, or a fault; quote `detail`. |
|
|
550
549
|
| `portFailure` | `probe` | The browser gave way, not the script. Probe once more; quote `detail` if it repeats. |
|
|
551
550
|
| `notInRepo`, `outsideRepo`, `outputTaken`, `logoUnreadable`, `handSignIn`, `cannotRefilm`, `keepRefused`, `exportFailed`, `repoFlowUnwritable` | `add`, `ci` | `detail`: what was written, the fix. |
|
|
552
|
-
| `appInvalid`, `appOriginMismatch`, `appUnknown`, `appHoles`, `appInstallFailed`, `appStartExited`, `appNeverAnswered`, `appServiceFailed`, `appPortTaken`, `appDockerMissing`, `appNowInFuture`, `appNowTooOld`, `appNowNotPinned`, `checkoutFailed`, `noRepoFlow`, `refreshFailed`, `checkThrew`, `alreadySetUp`, `setupPrOpen`, `setupBranchExists`, `noRepoFlows`, `noRelease`, `noDeployment`, `routeRefused`, `githubUnreadable`, `noSetupBranch`, `secretsUnknown`, `secretsUnreadable`, `workflowRefused`, `filesUnreadable`, `setupUnreadable`, `secretRefused`, `actionsRefused`, `actionsUnknown`, `prFailed` | `ci` | `detail`: what was done, the fix. |
|
|
551
|
+
| `checkNeedsPerson`, `appInvalid`, `appOriginMismatch`, `appUnknown`, `appHoles`, `appInstallFailed`, `appStartExited`, `appNeverAnswered`, `appServiceFailed`, `appPortTaken`, `appDockerMissing`, `appNowInFuture`, `appNowTooOld`, `appNowNotPinned`, `checkoutFailed`, `noRepoFlow`, `refreshFailed`, `checkThrew`, `alreadySetUp`, `setupPrOpen`, `setupBranchExists`, `noRepoFlows`, `noRelease`, `noDeployment`, `routeRefused`, `githubUnreadable`, `noSetupBranch`, `secretsUnknown`, `secretsUnreadable`, `workflowRefused`, `filesUnreadable`, `setupUnreadable`, `secretRefused`, `actionsRefused`, `actionsUnknown`, `prFailed` | `ci` | `detail`: what was done, the fix. |
|
|
553
552
|
|
|
554
553
|
## 8. Repo flows and CI
|
|
555
554
|
|