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.
@@ -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
- url.pathname = url.pathname.split("/").map((segment) => scrubSecrets(segment) === segment ? segment : PLACEHOLDER).join("/");
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(window.location.href),
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
- url: doc.location?.href ?? "",
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 } : {}
@@ -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/extension/src/editor/session.ts`). Two
16212
- * writers flip it, both outside the editor: the run page's re-shoot
16213
- * promotion (`promote` in `apps/extension/src/adapters/reshoot.ts`) sets
16214
- * `demo` when a re-shoot finishes complete, and the library card's "Back
16215
- * to your recording" (`backToRecording` in
16216
- * `apps/extension/entrypoints/library/main.ts`) sets `screen`. Neither
16217
- * deletes anything to do it — the recording stays on disk under either
16218
- * mode (`chooseActiveBundle`'s own docblock) — so a re-shoot that turns
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 extension at the run's
16767
- * door; a name that is not there is refused (`unknownKit`), never
16768
- * replaced by the default kit (spec 2026-10-08 §3).
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. The extension's
16942
- * generated zooms fit against the capture viewport with it
16943
- * (`zoomsForClicks`); a `cover` render fits against its own crop with it
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 the
16958
- * extension sizes a fresh zoom's length by (`zoom-defaults.ts`) and the
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 offscreen host and the editor all read `bytes` as
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
- ctx.drawImage(bitmap, 0, 0, manifest.width, manifest.height);
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/extension/src/editor/session.ts`). Two
16341
- * writers flip it, both outside the editor: the run page's re-shoot
16342
- * promotion (`promote` in `apps/extension/src/adapters/reshoot.ts`) sets
16343
- * `demo` when a re-shoot finishes complete, and the library card's "Back
16344
- * to your recording" (`backToRecording` in
16345
- * `apps/extension/entrypoints/library/main.ts`) sets `screen`. Neither
16346
- * deletes anything to do it — the recording stays on disk under either
16347
- * mode (`chooseActiveBundle`'s own docblock) — so a re-shoot that turns
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 extension at the run's
16943
- * door; a name that is not there is refused (`unknownKit`), never
16944
- * replaced by the default kit (spec 2026-10-08 §3).
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. The extension's
17961
- * generated zooms fit against the capture viewport with it
17962
- * (`zoomsForClicks`); a `cover` render fits against its own crop with it
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 the
17977
- * extension sizes a fresh zoom's length by (`zoom-defaults.ts`) and the
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 offscreen host and the editor all read `bytes` as
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` (section
17
- 7) with the exact command in `detail`: give the user that command and
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`; an entry without one is the site's manual session from
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: just run 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, this browser is not
152
- signed in there: see `session` below and spend no run. If it is not a sign-in page (a
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` means the page's address could not be read: not an
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 was
167
- outstanding. Snapshot again before concluding something is absent.
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, as its description says: an "Add item"
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: a phone shows a different page, and a
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` | The secret `NAME` is under 8 characters. Write a longer one; `ci`: give the person `command`. |
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 the field and the rule. Fix the file. |
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 server restart). |
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; fix or remove 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