Add mapbox directions route

CHANGELOG.md

@@ -19,6 +19,25 @@ that may never merge. They are not releases and are not listed here.
 
 ## Unreleased
 
+- `mapbox directions route`, routes between 2-25 waypoints for driving (with
+  or without live traffic), walking, or cycling. Hand-authored into
+  `custom-openapi/` rather than waiting on an upstream spec — the whole
+  Navigation API category had no CLI coverage before this; excludes the
+  ~30 electric-vehicle-routing parameters
+  (`engine=electric` and everything under it), which describe a vehicle's
+  charging curve down to the watt and are a poor fit for a hand-typed CLI
+  flag — the EV Charge Finder API is a better fit for that case and its own
+  follow-up. Two path-parameter bugs surfaced while wiring this up and are
+  fixed for every command, not just this one: a spec parameter literally
+  named `profile` (the routing profile, `mapbox/driving` etc.) silently
+  collided with the global `--profile` credentials flag, since clap has one
+  namespace of ids per command and a positional of the same name replaced it
+  outright; and an enum-constrained path parameter whose only valid values
+  contain a literal `/` (again, `mapbox/driving`) was being percent-encoded
+  to `%2F` by the same escaping that stops a free-text value from smuggling
+  in extra path segments — safe to skip once clap has already limited the
+  value to one of the spec's own literal strings.
+
 - `MAPBOX_CLI_EXTRA_QUERY` appends raw query parameters to every request, in
   the same `k1=v1&k2=v2` shape as a URL's own query string — for an API
   parameter this CLI's specs don't declare a flag for.

README.md

@@ -168,15 +168,13 @@ Each API is a top-level subcommand, one sub-subcommand per operation:
 
 ```sh
 mapbox accounts *
+mapbox directions *
 mapbox fonts *
 mapbox geocoder *
-mapbox rasterarrays *
 mapbox search *
 mapbox sprites *
-mapbox static-images *
-mapbox static-tiles *
+mapbox static *
 mapbox styles *
-mapbox tilequery *
 mapbox tilesets *
 ```