@generativereality/browser-automation 0.3.2 → 0.4.1

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.
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "browser-automation",
3
3
  "description": "Daemonless, per-tab-isolated browser automation for Claude Code via the `browser-automation` CLI. Drives one shared headed Chrome (persistent profile + extensions) over per-target CDP — many parallel sessions, no focus stealing, nothing long-lived to crash.",
4
- "version": "0.3.2",
4
+ "version": "0.4.1",
5
5
  "author": {
6
6
  "name": "generativereality"
7
7
  },
package/README.md CHANGED
@@ -96,6 +96,7 @@ browser-automation bind -s bank -m nordnet # …or adopt it into a session
96
96
  | `eval (-s\|-m\|-t) <js>` | Evaluate a JS expression in the tab (escape hatch) |
97
97
  | `download (-s\|-m\|-t) (--click <ref>\|--url <href>)` | Capture a file/CSV download, wait for completion, print the path |
98
98
  | `network (-s\|-m\|-t) [--reload\|--click\|--nav] [--filter --headers --body]` | Capture network requests (find the API, headers, response bodies) |
99
+ | `screenshot (-s\|-m\|-t) [--full] [-o path]` | Save a PNG screenshot (viewport or full page) |
99
100
  | `close (-s\|-m\|-t) [--tab]` | Forget the session (tab stays open); `--tab` also closes the browser tab |
100
101
 
101
102
  ## How refs work
package/dist/index.js CHANGED
@@ -7,7 +7,7 @@ import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, s
7
7
  import { spawnSync } from "node:child_process";
8
8
  import { fileURLToPath } from "node:url";
9
9
  //#region package.json
10
- var version = "0.3.2";
10
+ var version = "0.4.1";
11
11
  var description = "Daemonless, per-tab-isolated browser automation CLI for Claude Code. Drives one shared headed Chrome (persistent profile + extensions) over per-target CDP — many parallel sessions, no focus stealing, nothing long-lived to crash.";
12
12
  //#endregion
13
13
  //#region src/core/session.ts
@@ -202,6 +202,16 @@ async function evaluateUntil(targetId, expression, ready, { timeout = 5e3, inter
202
202
  }
203
203
  return last;
204
204
  }
205
+ /** Capture a PNG screenshot of a page target (optionally the full page). */
206
+ async function captureScreenshot(targetId, { fullPage = false } = {}) {
207
+ return withPage(targetId, async (s) => {
208
+ const r = await s.send("Page.captureScreenshot", {
209
+ format: "png",
210
+ captureBeyondViewport: fullPage
211
+ });
212
+ return Buffer.from(r.data, "base64");
213
+ });
214
+ }
205
215
  /** Navigate a page target and wait for load (or timeout). */
206
216
  async function navigate(targetId, url, { timeout = 3e4 } = {}) {
207
217
  return withPage(targetId, async (s) => {
@@ -417,17 +427,37 @@ function __baText(root){
417
427
  `;
418
428
  const SNAPSHOT_EXPR = WALK + `(() => {
419
429
  __baEachEl((el)=>{ if(el.getAttribute && el.getAttribute('data-ba-ref')) el.removeAttribute('data-ba-ref'); });
420
- const isInteractive=(el)=>{try{return el.matches('a,button,input,select,textarea,summary,[role=button],[role=link],[role=tab],[role=checkbox],[role=radio],[role=menuitem],[role=switch],[onclick],[contenteditable=""],[contenteditable=true]');}catch(e){return false;}};
430
+ const ptr=(el)=>{try{return getComputedStyle(el).cursor==='pointer';}catch(e){return false;}};
431
+ // Interactive = semantic control, OR focusable (tabindex>=0), OR the OUTERMOST
432
+ // element in a cursor:pointer chain (catches React clickable <div>s without
433
+ // dragging in their pointer-inheriting children or huge containers).
434
+ const isInteractive=(el)=>{
435
+ try{ if(el.matches('a,button,input,select,textarea,summary,label,[role=button],[role=link],[role=tab],[role=checkbox],[role=radio],[role=option],[role=menuitem],[role=switch],[onclick],[contenteditable=""],[contenteditable=true]')) return true; }catch(e){}
436
+ const ti=el.getAttribute&&el.getAttribute('tabindex');
437
+ if(ti!=null&&parseInt(ti,10)>=0) return true;
438
+ if(ptr(el)){ const p=el.parentElement; if(!p||!ptr(p)) return true; }
439
+ return false;
440
+ };
441
+ const truthy=(v)=>v==='true';
442
+ const stateOf=(el)=>{
443
+ let checked=(el.tagName==='INPUT')?!!el.checked:false;
444
+ const inp=el.querySelector&&el.querySelector('input[type=checkbox],input[type=radio]');
445
+ if(inp&&inp.checked) checked=true;
446
+ if(truthy(el.getAttribute&&el.getAttribute('aria-checked'))||truthy(el.getAttribute&&el.getAttribute('aria-selected'))||truthy(el.getAttribute&&el.getAttribute('aria-pressed'))) checked=true;
447
+ const disabled=(el.disabled===true)||truthy(el.getAttribute&&el.getAttribute('aria-disabled'));
448
+ return [checked?'checked':'',disabled?'disabled':''].filter(Boolean).join(' ');
449
+ };
421
450
  const out=[]; let i=1;
422
451
  __baEachEl((el)=>{
452
+ if(out.length>=200) return;
423
453
  if(!isInteractive(el)||!__baVisible(el))return;
424
454
  const ref='e'+(i++);
425
455
  el.setAttribute('data-ba-ref',ref);
426
456
  const tag=el.tagName.toLowerCase();
427
457
  const role=el.getAttribute('role')||tag;
428
458
  const type=el.getAttribute('type')||'';
429
- let name=(el.getAttribute('aria-label')||el.getAttribute('placeholder')||(el.value||'')||el.innerText||el.getAttribute('title')||el.getAttribute('name')||'').toString().trim().replace(/\\s+/g,' ').slice(0,80);
430
- out.push({ref,role,tag,type,name});
459
+ let name=(el.getAttribute('aria-label')||el.getAttribute('placeholder')||(el.value||'')||el.innerText||el.textContent||el.getAttribute('title')||el.getAttribute('name')||'').toString().trim().replace(/\\s+/g,' ').slice(0,80);
460
+ out.push({ref,role,tag,type,name,state:stateOf(el)});
431
461
  });
432
462
  return {url:location.href,title:document.title,count:out.length,elements:out};
433
463
  })()`;
@@ -471,6 +501,40 @@ function fillExpr(ref, value, submit) {
471
501
  return {ok:true,value:el.value!==undefined?String(el.value).slice(0,80):${v}};
472
502
  })()`;
473
503
  }
504
+ /** Focus + scroll an element by ref and select-all its existing value. Used by
505
+ * `fill --native`: the actual character insertion is then driven via CDP
506
+ * Input.insertText, which fires trusted events that controlled React forms
507
+ * (RHF, Final Form, Formik Controller) actually subscribe to. */
508
+ function focusAndSelectExpr(ref) {
509
+ const r = JSON.stringify(ref);
510
+ return WALK + `(() => {
511
+ const el=__baFind(${r});
512
+ if(!el)return {err:'ref not found: '+${r}+' (re-run snapshot)'};
513
+ el.scrollIntoView({block:'center',inline:'center'});
514
+ el.focus();
515
+ try{ if(typeof el.select==='function') el.select(); }catch(e){}
516
+ return {ok:true,tag:el.tagName.toLowerCase(),len:el.value!==undefined?String(el.value).length:0};
517
+ })()`;
518
+ }
519
+ /** Re-read an input/textarea/contenteditable's effective value AND, when present,
520
+ * React's internal `_valueTracker.getValue()` — which is what React's onChange
521
+ * fires on. A divergence between the two is the canonical signature of
522
+ * "DOM value set but React form-state stayed stale" (the controlled-form
523
+ * stickiness gotcha — see SKILL.md). Also reports whether a React fiber is
524
+ * attached at all, so callers can tell "controlled component" from "plain DOM". */
525
+ function readValueAndTrackerExpr(ref) {
526
+ const r = JSON.stringify(ref);
527
+ return WALK + `(() => {
528
+ const el=__baFind(${r});
529
+ if(!el)return {err:'ref not found: '+${r}+' (re-run snapshot)'};
530
+ const value=el.value!==undefined?String(el.value):(el.isContentEditable?(el.textContent||''):'');
531
+ let trackerValue=null;
532
+ try{ const t=el._valueTracker; if(t&&typeof t.getValue==='function') trackerValue=String(t.getValue()); }catch(e){}
533
+ let hasReactFiber=false;
534
+ try{ hasReactFiber=Object.keys(el).some(k=>k.startsWith('__reactProps$')||k.startsWith('__reactFiber$')); }catch(e){}
535
+ return {value,trackerValue,hasReactFiber};
536
+ })()`;
537
+ }
474
538
  function readExpr(selector) {
475
539
  return WALK + `(() => { const r=${selector ? `__baQuery(${JSON.stringify(selector)})` : `document.body`}; return r ? __baText(r) : ${selector ? `'(no element matches ' + ${JSON.stringify(selector)} + ')'` : `''`}; })()`;
476
540
  }
@@ -495,7 +559,8 @@ const snapshotCommand = define({
495
559
  consola.log(`# ${snap.title}\n# ${snap.url}\n# ${snap.count} interactive elements`);
496
560
  for (const el of snap.elements) {
497
561
  const label = el.type ? `${el.role}[${el.type}]` : el.role;
498
- consola.log(`${el.ref.padEnd(5)} ${label.padEnd(18)} ${el.name}`);
562
+ const st = el.state ? `[${el.state}] ` : "";
563
+ consola.log(`${el.ref.padEnd(5)} ${label.padEnd(18)} ${st}${el.name}`);
499
564
  }
500
565
  }
501
566
  });
@@ -527,6 +592,7 @@ const clickCommand = define({
527
592
  });
528
593
  //#endregion
529
594
  //#region src/commands/fill.ts
595
+ const SELECT_ALL_MOD = process.platform === "darwin" ? 4 : 2;
530
596
  const fillCommand = define({
531
597
  name: "fill",
532
598
  description: "Type a value into an input/textarea/contenteditable by ref",
@@ -536,6 +602,14 @@ const fillCommand = define({
536
602
  type: "boolean",
537
603
  description: "Submit the form after filling (requestSubmit / Enter)"
538
604
  },
605
+ native: {
606
+ type: "boolean",
607
+ description: "Use CDP Input.insertText for trusted keyboard events. Slower than the default JS-dispatched path, but reaches controlled React forms (RHF / Final Form / Formik Controller) that ignore synthetic input events."
608
+ },
609
+ verify: {
610
+ type: "boolean",
611
+ description: "After filling, re-read the field and warn if its DOM value diverges from the value passed, or if React's internal _valueTracker still holds the old value (signals controlled-form state stickiness — the next submit will serialize stale data)."
612
+ },
539
613
  ref: {
540
614
  type: "positional",
541
615
  description: "Element ref, e.g. e3"
@@ -556,12 +630,71 @@ const fillCommand = define({
556
630
  consola.error("A value is required");
557
631
  process.exit(1);
558
632
  }
559
- const r = await evaluate(await resolveExistingTargetId(targetOpts(ctx.values)), fillExpr(ref, value, ctx.values.submit ?? false));
560
- if (r.err) {
561
- consola.error(r.err);
562
- process.exit(1);
633
+ const targetId = await resolveExistingTargetId(targetOpts(ctx.values));
634
+ const native = ctx.values.native ?? false;
635
+ const submit = ctx.values.submit ?? false;
636
+ if (native) {
637
+ const focus = await evaluate(targetId, focusAndSelectExpr(ref));
638
+ if (focus.err) {
639
+ consola.error(focus.err);
640
+ process.exit(1);
641
+ }
642
+ await withPage(targetId, async (s) => {
643
+ await s.send("Input.dispatchKeyEvent", {
644
+ type: "rawKeyDown",
645
+ key: "a",
646
+ code: "KeyA",
647
+ windowsVirtualKeyCode: 65,
648
+ nativeVirtualKeyCode: 65,
649
+ modifiers: SELECT_ALL_MOD,
650
+ commands: ["selectAll"]
651
+ });
652
+ await s.send("Input.dispatchKeyEvent", {
653
+ type: "keyUp",
654
+ key: "a",
655
+ code: "KeyA",
656
+ windowsVirtualKeyCode: 65,
657
+ nativeVirtualKeyCode: 65,
658
+ modifiers: SELECT_ALL_MOD
659
+ });
660
+ await s.send("Input.insertText", { text: value });
661
+ if (submit) {
662
+ await s.send("Input.dispatchKeyEvent", {
663
+ type: "rawKeyDown",
664
+ key: "Enter",
665
+ code: "Enter",
666
+ windowsVirtualKeyCode: 13,
667
+ nativeVirtualKeyCode: 13
668
+ });
669
+ await s.send("Input.dispatchKeyEvent", {
670
+ type: "keyUp",
671
+ key: "Enter",
672
+ code: "Enter",
673
+ windowsVirtualKeyCode: 13,
674
+ nativeVirtualKeyCode: 13
675
+ });
676
+ }
677
+ });
678
+ } else {
679
+ const r = await evaluate(targetId, fillExpr(ref, value, submit));
680
+ if (r.err) {
681
+ consola.error(r.err);
682
+ process.exit(1);
683
+ }
563
684
  }
564
- consola.success(`filled ${ref} = "${r.value}"${ctx.values.submit ? " + submitted" : ""}`);
685
+ if (ctx.values.verify) {
686
+ const v = await evaluate(targetId, readValueAndTrackerExpr(ref));
687
+ if (v.err) consola.warn(`verify failed to re-read field: ${v.err}`);
688
+ else {
689
+ const domMatches = v.value === value;
690
+ const trackerKnown = v.trackerValue !== null && v.trackerValue !== void 0;
691
+ const trackerMatches = !trackerKnown || v.trackerValue === value;
692
+ if (!domMatches) consola.warn(`verify: DOM value is "${v.value}" but you requested "${value}" — wrong element selected, or the page rewrote it.`);
693
+ else if (!trackerMatches) consola.warn(`verify: DOM shows "${value}" but React's _valueTracker still holds "${v.trackerValue}". The form library will likely submit the stale value. Try --native, or capture the form's PUT endpoint and call it directly (see SKILL.md "Controlled-form state stickiness").`);
694
+ else if (v.hasReactFiber && !trackerKnown && !native) consola.info(`verify: field has a React fiber but no _valueTracker — if the next submit serializes the old value, try --native.`);
695
+ }
696
+ }
697
+ consola.success(`filled ${ref} = "${value}"${native ? " [native]" : ""}${submit ? " + submitted" : ""}`);
565
698
  }
566
699
  });
567
700
  //#endregion
@@ -656,7 +789,7 @@ function urlTriggerExpr(url) {
656
789
  }
657
790
  //#endregion
658
791
  //#region src/commands/download.ts
659
- const DEFAULT_DIR = join(homedir(), ".browser-automation", "downloads");
792
+ const DEFAULT_DIR$1 = join(homedir(), ".browser-automation", "downloads");
660
793
  const downloadCommand = define({
661
794
  name: "download",
662
795
  description: "Capture a file download (e.g. a CSV export): trigger it with --click <ref> or --url, wait for completion",
@@ -673,7 +806,7 @@ const downloadCommand = define({
673
806
  dir: {
674
807
  type: "string",
675
808
  short: "d",
676
- description: `Directory to save into (default: ${DEFAULT_DIR})`
809
+ description: `Directory to save into (default: ${DEFAULT_DIR$1})`
677
810
  },
678
811
  timeout: {
679
812
  type: "number",
@@ -691,7 +824,7 @@ const downloadCommand = define({
691
824
  consola.error(`--click expects a ref like e42 (run snapshot first)`);
692
825
  process.exit(1);
693
826
  }
694
- const r = await captureDownload(await resolveExistingTargetId(targetOpts(ctx.values)), ctx.values.dir || DEFAULT_DIR, click ? clickTriggerExpr(click) : urlTriggerExpr(url), ctx.values.timeout ?? 3e4);
827
+ const r = await captureDownload(await resolveExistingTargetId(targetOpts(ctx.values)), ctx.values.dir || DEFAULT_DIR$1, click ? clickTriggerExpr(click) : urlTriggerExpr(url), ctx.values.timeout ?? 3e4);
695
828
  consola.success(`Downloaded ${r.filename} (${r.bytes} bytes)`);
696
829
  process.stdout.write(r.path + "\n");
697
830
  }
@@ -834,6 +967,37 @@ const networkCommand = define({
834
967
  }
835
968
  });
836
969
  //#endregion
970
+ //#region src/commands/screenshot.ts
971
+ const DEFAULT_DIR = join(homedir(), ".browser-automation", "screenshots");
972
+ const screenshotCommand = define({
973
+ name: "screenshot",
974
+ description: "Save a PNG screenshot of a tab (--full for the whole page)",
975
+ args: {
976
+ ...targetArgs,
977
+ out: {
978
+ type: "string",
979
+ short: "o",
980
+ description: "Output file path (default: ~/.browser-automation/screenshots/<ts>.png)"
981
+ },
982
+ full: {
983
+ type: "boolean",
984
+ description: "Capture the full scrollable page, not just the viewport"
985
+ }
986
+ },
987
+ async run(ctx) {
988
+ const targetId = await resolveExistingTargetId(targetOpts(ctx.values));
989
+ const png = await captureScreenshot(targetId, { fullPage: ctx.values.full });
990
+ let out = ctx.values.out;
991
+ if (!out) {
992
+ mkdirSync(DEFAULT_DIR, { recursive: true });
993
+ out = join(DEFAULT_DIR, `${((await listPageTargets()).find((p) => p.id === targetId)?.title || "page").replace(/[^a-z0-9]+/gi, "-").replace(/^-|-$/g, "").slice(0, 40) || "page"}.png`);
994
+ }
995
+ writeFileSync(out, png);
996
+ consola.success(`Saved screenshot (${png.length} bytes)`);
997
+ process.stdout.write(out + "\n");
998
+ }
999
+ });
1000
+ //#endregion
837
1001
  //#region src/commands/list.ts
838
1002
  const listCommand = define({
839
1003
  name: "list",
@@ -1024,6 +1188,8 @@ const subCommands = new Map([
1024
1188
  ["eval", evalCommand],
1025
1189
  ["download", downloadCommand],
1026
1190
  ["network", networkCommand],
1191
+ ["screenshot", screenshotCommand],
1192
+ ["shot", screenshotCommand],
1027
1193
  ["list", listCommand],
1028
1194
  ["ls", listCommand],
1029
1195
  ["close", closeCommand],
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@generativereality/browser-automation",
3
- "version": "0.3.2",
3
+ "version": "0.4.1",
4
4
  "description": "Daemonless, per-tab-isolated browser automation CLI for Claude Code. Drives one shared headed Chrome (persistent profile + extensions) over per-target CDP — many parallel sessions, no focus stealing, nothing long-lived to crash.",
5
5
  "type": "module",
6
6
  "bin": {
@@ -84,6 +84,7 @@ Page commands take a tab selector — `-s <session>` (default `$BAC_SESSION`, el
84
84
  | Evaluate JS in the tab (escape hatch) | `browser-automation eval -m op.fi 'document.title'` |
85
85
  | Download a file / CSV export | `browser-automation download -m bank --click e42` (or `--url <href>`) |
86
86
  | Inspect network (find the API, headers, bodies) | `browser-automation network -m bank --reload --filter api --headers --body` |
87
+ | Screenshot a tab | `browser-automation screenshot -m op.fi --full -o shot.png` |
87
88
  | Forget a session (tab stays open) | `browser-automation close -s work` |
88
89
  | Forget **and** close the browser tab | `browser-automation close -s work --tab` |
89
90
 
@@ -131,8 +132,46 @@ There's no `state-save`/`state-load` to manage — the profile *is* the auth sto
131
132
  those refs for one action → re-snapshot. "ref not found" means re-snapshot.
132
133
  - **`isTrusted` / synthetic events.** Clicks and fills are JS-dispatched, so a
133
134
  small number of hard anti-bot or payment widgets that demand trusted events
134
- may ignore them. For those, escalate to a foregrounded native-input path
135
- (future `--native` flag) or have the user do that one step manually.
135
+ may ignore them. For fills, pass `--native` to drive character insertion
136
+ through CDP `Input.insertText` instead — that fires real (trusted)
137
+ `beforeinput`/`input` events. For clicks, escalate to a foregrounded
138
+ native-input path or have the user do that one step manually.
139
+ - **Controlled-form state stickiness.** Form libraries that subscribe to React's
140
+ internal value-setter (React Hook Form, Final Form, Formik with a `Controller`,
141
+ Blocket/finn.no's `recommerce` editor) sometimes ignore the synthetic `input`
142
+ event the default `fill` dispatches: the DOM input shows the new value, but
143
+ the form's React state stays on the old one — and the next submit serializes
144
+ the *old* value. Two ways out:
145
+ 1. **`fill --native --verify <ref> <value>`** — drives character insertion
146
+ through CDP `Input.insertText` (trusted events). `--verify` re-reads the
147
+ field afterwards and warns if either the DOM value diverged from what you
148
+ asked for, or if React's internal `_valueTracker` still holds the old
149
+ value (the canonical state-stickiness signature). Use this first; it
150
+ solves the vast majority of cases.
151
+ 2. **API bypass** — when even `--native` doesn't stick (e.g. the form library
152
+ binds to an external state machine that drives its own POST/PUT), grab the
153
+ form's underlying endpoint and hit it directly:
154
+ ```bash
155
+ # Hook fetch and persist a real form-submit's body + headers via localStorage
156
+ # (it survives the post-submit navigation, unlike window.* globals):
157
+ browser-automation eval -s app "(function(){var f=window.fetch;window.fetch=function(u,o){if(o&&o.method==='PUT'&&u.toString().includes('/api/item/')){localStorage.setItem('__lastPut',o.body||'');localStorage.setItem('__lastHdrs',JSON.stringify(o.headers||{}));}return f.apply(this,arguments);};})()"
158
+ # …then click Save once in the form so the hook captures the canonical PUT…
159
+ browser-automation eval -s app "({body:localStorage.getItem('__lastPut'),headers:localStorage.getItem('__lastHdrs')})"
160
+ # …gives you the endpoint, exact body shape, and custom headers
161
+ # (e.g. Blocket uses E-Tag, not the standard If-Match — and the etag lives
162
+ # in the JSON body, not the HTTP header).
163
+ ```
164
+ Then re-fetch the GET endpoint for current data + the current etag, PUT
165
+ directly with the modified field(s) and the captured custom header, and
166
+ **drive the form's terminal commit step through the UI** — many two-step
167
+ editors (`edit → delivery → publish`) only persist `state: "edit"`
168
+ server-side until that final Save fires the commit.
169
+
170
+ Blocket's recommerce price field is the canonical case: default `fill e43 "500"`
171
+ shows 500 in the input but submits 750. Fix: `fill --native --verify e43 "500"`
172
+ (or, if --native doesn't stick: direct PUT to
173
+ `/recommerce/create/api/item/<id>` with `E-Tag: <body.etag>`, then click
174
+ Save on the delivery page to commit).
136
175
  - **Cross-origin iframes are separate CDP targets.** `read`/`snapshot` see the
137
176
  page's own document and same-origin frames, not cross-origin iframes (common
138
177
  for SSO bank login widgets and embedded captchas). If the content you need
@@ -193,10 +232,14 @@ working around it forever**:
193
232
  selection). Add a command by creating `src/commands/x.ts` and registering it
194
233
  in `src/commands/index.ts`.
195
234
  3. **Validate locally** against the running Chrome:
196
- `npm install && npm run typecheck && npm run build`, then `npm link` (so the
197
- global `browser-automation` points at your build) — or run `node dist/index.js …`.
198
- Reproduce the failure, confirm the fix, and re-test on a scratch tab you
199
- created (read-only-safe; never disrupt the user's live tabs).
235
+ `npm install && npm run typecheck && npm run build`, then run your build as
236
+ **`node dist/index.js <cmd>`** from the clone. **Do NOT `npm link`** — it
237
+ repoints the machine-global `browser-automation` bin, so a parallel Claude
238
+ Code session (or the user's main session) would suddenly be running *your*
239
+ work-in-progress clone instead of the installed release. Validate via the
240
+ explicit `node dist/index.js` path instead. Reproduce the failure, confirm
241
+ the fix, and re-test on a scratch tab you created (read-only-safe; never
242
+ disrupt the user's live tabs).
200
243
  4. **Propose a PR** for the user to review and contribute upstream — don't
201
244
  publish yourself (the maintainer cuts releases):
202
245
  ```bash