argorant 0.14.1 → 0.15.0

package/README.md

@@ -138,21 +138,33 @@ credits, `4` rate limit with the wait time in the message).
 
 ## Filters
 
-Combine free text with structured filters:
+Every filter-taking command (`count`, `search`, `reveal`, `export`, `list create`, `lists create`,
+`lists add`, `companies`, `company`, `campaigns leads add`) takes the same filters, with the same
+meaning as the app, the API and the Claude connector. Each list filter has an include flag and an
+exclude flag, and you can use both together. A comma means any of them.
 
 ```
---keywords --title --exclude-title --seniority --department --industry
---country --geography --state --city --company --domain
+--title / --exclude-title          --title-match words|exact|contains
+--keywords / --exclude-keywords    --keyword-scope company|people|any
+--industry / --exclude-industry    --country / --exclude-country (regions too)
+--state / --exclude-state          --city / --exclude-city
+--seniority / --exclude-seniority  --department / --exclude-department
+--domain / --exclude-domain        --company
+--employees, --employees-min, --employees-max
+--revenue, --revenue-min, --revenue-max
+--near <place id or lat,lon> --radius <n> [--radius-unit mi|km] [--radius-target person|company]
+--gender, --income                 (estimates; not for lending audiences)
 --has-phone --has-linkedin --has-email --verified-only
 ```
 
-`--keywords` is the widest, most reliable filter (comma = OR) - prefer it over
-`--industry`. `--country`/`--geography` accept regions (Europe, EMEA, DACH,
-Nordics, APAC, LATAM, GCC…).
+`--title-match words` (the default) matches whole words, so excluding "Data" does not drop
+"Database Administrator". `exact` matches the whole job title ("CEO" does not match
+"Founder & CEO"); `contains` matches the text anywhere. `--keyword-scope company` (the default)
+looks only at the company's tags, industry and description; `people` at the person's skills and
+profile text; `any` at both plus job title and company name.
 
-`--exclude-title` currently applies fully to `export` and `list create`; on
-`count`/`search`/`reveal` it's a platform-side gap and the CLI prints a note
-to stderr rather than silently dropping your filter.
+`argorant filters` lists every filter, its values and which filters can be used right now.
+A filter that is not ready yet is refused with a plain message, never ignored.
 
 Options: `-n/--limit`, `-o/--output`, `--json`, `-y/--yes`, `--base`,
 `--grade <valid|valid-plus-catchall>`.