flowleap-patentlisted

# FlowLeap Patent Auth and global flags: see `flowleap-shared`. EP/WO search runs on the user's own EPO patent-data key. A `provider_keys_required` error is a **user-action stop for that office, never an exhausted route**: do not fall back to web-scraped patent data, deliver whatever the live office (US via `flowleap uspto search`) returns in full, name the gap as a missing-key gap, and ask for the free key at the end of the turn. A zero-result search is not a gate — reformulate and persist as normal. See `flowleap-keys`. ## Commands ### Search Patents ```bash flowleap patent search --query <query> [flags] ``` Posts to `/v1/patent-search`. Returns patent results with publication number, title, applicant, and date. | Flag | Description | Default | |------|-------------|---------| | `--query`, `-q` | EPO CQL query (required) — e.g. `ti="battery separator"` | — | | `--limit` | Maximum results (1-100) | `10` | | `--countries` | Country filter, comma-separated (e.g. `EP,WO`) | none | Jurisdiction is set with `--countries` — `patent search` has no `--source` flag (that flag belongs to `academic search`, for `scholar` vs `arxiv`). For US-specific searches use `flowleap uspto search` (ODP Lucene syntax). CQL terms must be at least 3 characters — OPS rejects shorter prefixes with a `400 CLIENT.PrefixTooShort`. Spell the word out (`ti="ultraviolet"`, not `ti="uv"`); this applies to hand-written queries and to CQL from `build-query`. #### Examples ```bash # Basic search flow