@siteoshq/cli 2.5.0 → 2.5.1

package/README.md

@@ -232,9 +232,9 @@ siteos seo gsc export --dataset queries --format csv --output ./gsc-queries.csv
 Run `siteos seo --help` for request JSON, limits, saved inputs, cancellation and GSC settings.
 Research supports keywords, Domain Overview (`domain`), rankings, backlinks, brand and AI visibility without GSC.
 AI Visibility category history uses `--kind ai-rankings`; Prompt checks stays separate under
-`--kind ai-visibility`. Category requests use `kind: ai-visibility` with a `category-aeo-v2`
-category. Reports and exports preserve AEO scores, recommendation roles, first choices, objections,
-model settings and the exact supporting answers. See the SEO skill's AI visibility reference for
+`--kind ai-visibility`. Category requests use `kind: ai-visibility` with a `category-mentions-v3`
+category: ordinary answers, text Mentions and Citations. Historical reports retain AEO scores and
+annotations. Reports and exports include model settings and the exact supporting answers. See the SEO skill's AI visibility reference for
 the versioned request and scoring method; historical v1 reports remain readable without inferred scores.
 Domain Overview collects domain totals, up to 100 ranking keywords, pages and competitors for a market.
 `--kind domain` includes legacy `competitors` history; existing `competitors` inputs keep their original two-part plan.

package/dist/cli.js

@@ -9015,15 +9015,15 @@ var RESEARCH_HELP = `
 
 Research request kinds: keywords, domain, rankings, backlinks, brand, ai-visibility.
 Read sections also accept --kind ai-rankings for category comparisons; --kind ai-visibility selects Prompt checks.
-Category run/plan inputs use kind ai-visibility with category-aeo-v2; both sections share AI request execution.
+Category run/plan inputs use kind ai-visibility with category-mentions-v3; both sections share AI request execution.
 Domain Overview: {"kind":"domain","target":"example.com","country":"US","language":"en"}.
 Domain collects summary, ranking keywords, top pages and competitors. The legacy competitors kind retains its two-part plan; domain history includes those reports.
 Request JSON: {"kind":"keywords","target":"example.com","keywords":["website analytics"],"country":"US","language":"en"}.
-Rankings accepts up to 10 keywords and 5 competitors. AI visibility accepts brand, platforms and either prompt or a category-aeo-v2 category with products and questions.
+Rankings accepts up to 10 keywords and 5 competitors. AI visibility accepts brand, platforms and either prompt or a category-mentions-v3 category with products and questions.
 Markets: US, GB, ES, DE, FR, CA, AU. Languages: en, es, de, fr, pt, it, nl, ru.
 Platforms: chat_gpt, claude, gemini, perplexity. Brand lookup uses brandPlatform chat_gpt|google and brandMatch domain|brand.
 Plan validates the request and shows planned parts and available research credits without enqueueing work.
-Retry creates a continuation using the original questions and settings; it preserves usable saved answers and only requests missing parts. It consumes credits and requires explicit scope authorization, like Run. Original reports and observation dates remain available.
+Retry creates a continuation using the original questions and platforms; category continuations collect ordinary text with category-mentions-v3; it preserves usable saved answers and only requests missing parts. It consumes credits and requires explicit scope authorization, like Run. Original reports and observation dates remain available.
 Run consumes Organization research credits through the same worker as the interface. Preserve the retry key after an uncertain response.
 SERP ensure collects one saved organic snapshot for a keyword returned by the selected completed Keyword Research report. It uses research credits once; repeating the same report/word returns the saved job, including failures. Show/wait/export only read and never spend. New reports can collect fresh snapshots.
 History returns the latest 30 checks per section; show/export can address older retained run IDs. Saved checks are limited to 100 per resource.