Skip to content

chore(cli): reserve runner.inspect from the public-API generator - #1516

Closed
Erzhan Torokulov (erzhtor) wants to merge 0 commit into
mainfrom
arc-556-reserve-runner-inspect
Closed

chore(cli): reserve runner.inspect from the public-API generator#1516
Erzhan Torokulov (erzhtor) wants to merge 0 commit into
mainfrom
arc-556-reserve-runner-inspect

Conversation

@erzhtor

@erzhtor Erzhan Torokulov (erzhtor) commented Aug 21, 2026

Copy link
Copy Markdown

Relates to ARC-556. Bottom of a 2-PR stack; #1517 is stacked on this.

Overview of Changes

@qawolf/api-contracts will publish a runner.inspect contract once the platform side of ARC-556 merges (platform PRs #31741/#31758/#31759, all open). The moment that dependency bumps, bun run generate fails: the generator cannot turn runner.inspect's discriminated-union request input into CLI flags, the same way it already can't for runner.performAction's action union. This reserves the name in the hand-written runner.* skip-list ahead of time, mirroring how the platform's own stack shipped contracts with no consumer yet (their PR2).

No functional change. The name is inert against the currently published 0.26.0, which has no such contract — nothing today calls runner.inspect or reads it from the skip-list differently. The actual dependency bump (chore(deps): bump api-contracts to X.Y.Z) and the qawolf runner inspect command consuming it land in #1517, once the platform side publishes.

Testing

bun run typecheck
bun run lint
bun run format:check
bun run knip
bun run test
bun run build

Checklist

  • Changes follow the code style of this project
  • Self-review completed
  • Tests added/updated (or not applicable) — no behavior to test; existing suite is unaffected
  • No breaking changes (or described below)

@coderabbitai

coderabbitai Bot commented Aug 21, 2026

Copy link
Copy Markdown

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro

Run ID: d924bb1b-c194-4a7a-a61b-a7a7a6cda041

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review

Comment @coderabbitai help to get the list of available commands.

Erzhan Torokulov (erzhtor) added a commit that referenced this pull request Aug 25, 2026
Adds `qawolf runner inspect session|contexts|page-source|elements`
alongside the browser-only `element-html`/`page-html`/`variable` arms
already on main, reading a mobile runner's Appium session, WebView
contexts, page source, or elements — via the platform's separate
`runner.inspectMobile` contract (qawolf/platform#31758), not by
extending `runner.inspect`.

`qawolf runner act` answers `action-not-supported-on-mobile` for
`double_click`, `scroll`, `move`, `keypress`, `navigate`, and a `click`
whose `--button` isn't `left` — none of those have a touchscreen
equivalent. `--button` and `--path` note the mobile-specific behavior
(left-only clicks, drag collapses to its path's first and last point).

Screenshots need no change: the platform re-encodes a mobile device's
screen to JPEG before answering, same as a browser, so the format-aware
handling an earlier draft of this added is dropped as unnecessary.

Depends on `@qawolf/api-contracts` publishing `runner.inspectMobile`
and the mobile dispatch for `performAction` (ARC-556, platform PRs
#31741/#31758/#31759). Until that lands, `inspectMobile.ts` and
`inspectMobileRequest.ts` reference contract members the pinned
`api-contracts` does not export yet, and `bun run typecheck`/`lint`
fail on exactly those two files plus the new `performAction.ts` case —
expected and scoped to this dependency, same as the two-PR stack this
supersedes documented (#1516, #1517).
@erzhtor
Erzhan Torokulov (erzhtor) force-pushed the arc-556-reserve-runner-inspect branch from 9ad8eea to 1e7f0af Compare August 25, 2026 11:42
@erzhtor

Copy link
Copy Markdown
Author

Closing as superseded. Main already reserves `runner.inspect` (and the whole runner.* skip-list) via #1519's 02727c3 ("refactor(runner): move the runner group to success/failure outcomes"), which landed independently while this branch was open. This branch has been rebased onto `main` for the record — it is now an empty diff.

The mobile inspect work that actually depends on the reservation continues in #1517, rebased directly onto `main`.

@erzhtor
Erzhan Torokulov (erzhtor) deleted the arc-556-reserve-runner-inspect branch August 25, 2026 11:43
@erzhtor
Erzhan Torokulov (erzhtor) restored the arc-556-reserve-runner-inspect branch August 25, 2026 11:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

1 participant