[STG-2453] refactor(cli): remove redundant browse refs command

[shrey150]

Summary

Removes the browse refs command. It only re-printed the xpathMap/urlMap cached from the last browse snapshot — which browse snapshot already returns — so it was redundant. It was also a footgun: it returned stale maps if the page had changed since that snapshot.

refs was introduced in the CLI's oclif rewrite as one of the driver commands and never pruned; nothing relies on it that browse snapshot doesn't already cover.

What's removed

• The browse refs command (src/commands/refs.ts)
• Its driver handler + the "refs" entry in DriverCommandName
• The now-unused getRefMaps() accessor on the session manager
• browse refs references in README.md and the browse SKILL.md

Ref-based commands (click, fill, select, …) are unaffected — they resolve from the cached maps via resolveSelector, which is untouched. browse snapshot continues to return the ref maps by default.

E2E Test Matrix

Command / flow	Observed output	Confidence
browse refs	"browse refs" is not a browse command … Error: command refs not found	Command removed
browse --help	no refs entry	Removed from the surface
browse snapshot	unchanged (still returns { tree, urlMap, xpathMap })	Snapshot behavior untouched
driver-commands unit tests	14/14 pass	No test regressions
pnpm --dir packages/cli build (tsc)	success	Typechecks (incl. narrowed DriverCommandName)

Linear: STG-2453

[changeset-bot]

🦋 Changeset detected

Latest commit: ac03a25

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 0 packages

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[cubic-dev-ai]

No issues found across 9 files

Confidence score: 5/5

• Automated review surfaced no issues in the provided summaries.
• No files require special attention.

Architecture diagram

sequenceDiagram
    participant CLI as CLI (oclif)
    participant BrowseCmd as Browse Commands
    participant SnapshotCmd as snapshot Command
    participant DriverCmd as Driver Command CLI
    participant SessMgr as Session Manager
    participant Driver as Browser Driver
    
    Note over CLI,Driver: Command resolution and execution flow
    
    CLI->>CLI: Parse argv (e.g., browse snapshot --full)
    CLI->>BrowseCmd: dispatch to matched command
    
    alt snapshot command
        BrowseCmd->>SnapshotCmd: execute snapshot
        SnapshotCmd->>DriverCmd: runDriverCommandFromFlags("snapshot", {full})
        DriverCmd->>SessMgr: execute driver snapshot handler
        SessMgr->>Driver: capture accessibility snapshot
        Driver-->>SessMgr: tree + refMaps (xpathMap, urlMap)
        SessMgr->>SessMgr: cache refMaps internally
        alt --full flag set
            SessMgr-->>DriverCmd: {tree, urlMap, xpathMap}
            DriverCmd-->>SnapshotCmd: full output
            SnapshotCmd-->>CLI: formatted result with maps
        else default (no --full)
            SessMgr-->>DriverCmd: {tree} only
            DriverCmd-->>SnapshotCmd: lean output
            SnapshotCmd-->>CLI: formatted tree only
        end
    end
    
    Note over CLI,Driver: Element commands (click, fill, select, etc.)
    
    CLI->>BrowseCmd: dispatch element command
    BrowseCmd->>DriverCmd: runDriverCommandFromFlags("click", ...)
    DriverCmd->>SessMgr: execute click handler
    SessMgr->>SessMgr: resolveSelector using cached refMaps
    SessMgr->>Driver: perform element action
    Driver-->>SessMgr: result
    SessMgr-->>DriverCmd: action outcome
    DriverCmd-->>BrowseCmd: formatted response
    BrowseCmd-->>CLI: output to user
    
    Note over CLI,Driver: Refs command removed – users must use snapshot --full
    
    CLI->>BrowseCmd: parse browse refs
    BrowseCmd-->>CLI: "command refs not found"
    CLI->>CLI: display error: "browse refs is not a browse command"

Loading

_{Re-trigger cubic}