Closed general

Clean break: adom/pup-bridge rename + browser_* -> pup_* verbs (NO aliases, callers WILL break by design)

John Lauer · 2d ago ·closed by John Lauer

Heads-up: this repo and its entire verb surface are being HARD-renamed as part of the 2026-08 naming overhaul. This is a deliberate CLEAN BREAK, no aliases, no deprecation shims. Nothing here has ever shipped to the public, so we are not carrying legacy names. If your thread, skill, or tool calls this bridge by an old name, it will error after this lands, and that is the point: we want the errors so we locate and fix every caller instead of hiding them behind aliases.

Slug + title

  • Slug: adom/adom-desktop-puppeteer-bridge -> adom/pup-bridge
  • Title: Adom Desktop - Puppeteer Bridge -> Pup - Puppeteer Bridge
  • The wiki still 301s the old URL so links don't 404, but that is the only concession. There are no code-level fallbacks.

Verbs: browser_* -> pup_* (hard, no aliases)

The verb family renames from browser_* to pup_*, and the old names are removed:

  • browser_open_window -> pup_open_window
  • browser_screenshot -> pup_screenshot
  • browser_eval -> pup_eval
  • browser_navigate -> pup_navigate
  • browser_list_windows -> pup_list_windows
  • browser_readiness -> pup_readiness
  • browser_prewarm -> pup_prewarm
  • browser_describe -> pup_describe
  • ...and the rest of the family, one-for-one.

pup keeps its name (always lowercase). The CLI binary stays adom-desktop for now (rename pending in adom/adom-desktop#55), so calls become adom-desktop pup_open_window ....

What breaks on purpose

  • Any adom-desktop browser_* call errors with an unknown-verb error.
  • Bridge core's own first-run / cold-start calls (browser_prewarm, browser_readiness) break until Bridge core is updated to pup_*. Filing that against adom/adom-desktop.
  • Every skill / AI thread that calls browser_* breaks until it moves to pup_*.

All intended. Fix your callers to pup_*.

Prose + definitions

  • "Adom Desktop" / "via AD" -> Bridge across README, SKILL.md, CLAUDE.md, dev-skills, PUBLISHING, install/uninstall, package.json, manifest.
  • browser_* was a frozen identifier in definitions; this unfreezes it to pup_* (coordinating the canonical update so the whole fleet adopts pup_*).

Status

Executing in the pup build thread now: verb rename + reship, slug + title, prose sweep. Reporting back to flip the definitions tracking-list row to DONE, and filing the Bridge-core follow-up for the AD-side browser_* calls.

1 Reply

John Lauer · 1d ago

Executed in full: clean break shipped 2.0.0-2.0.1, callers migrated fleet-wide, guidance shim added in 2.0.14 (verb_renamed errors naming the exact pup_* replacement, nothing aliased).

Log in to reply.