@siteoshq/cli 1.11.0 → 1.12.0

package/README.md

@@ -1,7 +1,7 @@
 # SiteOS CLI
 
 `@siteoshq/cli` exposes one `siteos` binary for Auth, common Projects, Pulse, Cookie, Forms,
-Search, Trace, SEO and Integrations. This source prepares version 1.11.0; publishing is a separate release.
+Search, Trace, SEO/GEO and Integrations. This source is version 1.11.0; source changes require a separate release to reach npm.
 Node.js 22 or newer is required.
 
 ## Install and authenticate
@@ -167,11 +167,17 @@ snippet is unavailable until runtime publication succeeds. Integrations connecti
 Organization; provider authorization opens the shared browser flow, and notification destinations
 are connected explicitly by each service.
 
-### SEO (prepared for release)
+### SEO/GEO
 
-Check `siteos seo --help` before use; install a matching release only after it is published. An
-SEO-capable server returns SEO in its Project service catalog, which older strict CLI parsers may
-reject. Coordinate the CLI update before that server rollout, then publish the matching plugin.
+The application calls this service **SEO/GEO**; its command and Project service key remain `seo`.
+GEO means generative engine optimization, including technical AI-search accessibility and
+AI mentions/citations. Check `siteos seo --help` against the installed CLI and server version.
+
+Site Audit checks public HTML, canonical, robots.txt, sitemaps, snippets and basic structured data.
+Its crawler-policy checks do not prove access from actual provider IPs. Performance adds
+selected-page Lighthouse and response/rendered HTML comparisons. Brand lookup and Prompt checks
+provide separate AI visibility evidence. No autonomous agent journey or target API/MCP audit is
+performed by these commands, and no result guarantees AI inclusion or a universal AI rank.
 
 ```sh
 siteos project connect seo --json
@@ -192,8 +198,8 @@ observed URL. Read the returned audit ID until a terminal state; a queued respon
 `issue ignore` and `issue restore` require `--audit`, `--url`, `--rule`, `--reason` and the current
 `--revision` (0 before the first decision). They use a distinct issue-write scope. Read back the
 decision after success; a revision conflict requires refreshing it. Ignore never means resolved.
-All SEO commands resolve the selected common Project and explicit environment binding. Current
-The source CLI also supports SEO research and GSC Insights with a matching server release:
+All SEO/GEO commands resolve the selected common Project and explicit environment binding.
+Research and GSC Insights use these commands with a matching server release:
 
 ```sh
 siteos seo research summary --json
@@ -209,7 +215,10 @@ 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, rankings, competitors, backlinks, brand and AI visibility without GSC.
+Research supports keywords, Domain Overview (`domain`), rankings, backlinks, brand and AI visibility without GSC.
+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.
+New request example: `{"kind":"domain","target":"example.com","country":"US","language":"en"}`.
 Reading/planning/saving spends no research credits. Launch uses Organization credits and the same
 server admission as the interface. Keep the retry key after an uncertain response; no paid retries
 are automatic. Wait exit 3 means pending; exit 4 failed/cancelled. Partial evidence remains readable.

package/dist/cli.js

@@ -10520,7 +10520,9 @@ var RESEARCH_HELP = `
   siteos seo research saved save --input <request.json> --name <name> [--id <saved-id>] [--environment <slug>] [--json]
   siteos seo research saved remove <saved-id> [--environment <slug>] [--json]
 
-Research kinds: keywords, rankings, competitors, backlinks, brand, ai-visibility.
+Research kinds: keywords, domain, rankings, backlinks, brand, ai-visibility.
+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 requires brand, prompt and platforms.
 Markets: US, GB, ES, DE, FR, CA, AU. Languages: en, es, de, fr, pt, it, nl, ru.
@@ -10539,7 +10541,10 @@ var kinds = [
   "brand",
   "ai-visibility"
 ];
-var requestSchema = z19.object({ kind: z19.enum(kinds), target: z19.string().min(1).max(253) }).passthrough();
+var requestSchema = z19.object({
+  kind: z19.enum(["domain", ...kinds]).transform((kind) => kind === "domain" ? "competitors" : kind),
+  target: z19.string().min(1).max(253)
+}).passthrough();
 var runStates = z19.enum([
   "queued",
   "running",
@@ -10596,6 +10601,7 @@ async function runSeoResearchCommand(options) {
       throw new Error(
         "Invalid research operation or flags. Run siteos seo --help."
       );
+    if (values.kind === "domain") values.kind = "competitors";
     if (operation.flags.includes("kind") && !kinds.includes(values.kind))
       throw new Error("Choose a documented --kind.");
     if (operation.flags.includes("input") && !values.input)
@@ -11273,7 +11279,15 @@ async function runSeoPerformanceCommand(options) {
 }
 
 // src/services/seo-command.ts
-var SEO_HELP = `Audit SEO and work with search and AI research in the selected Project environment.
+var SEO_HELP = `SEO/GEO: audit your website and research search-engine and AI visibility in the selected Project environment.
+
+Site Audit checks public HTML, canonical, robots.txt, sitemap and technical GEO signals.
+Performance measures selected pages with Lighthouse and compares response/rendered HTML.
+Research covers keywords, rankings, competitors, backlinks, Brand lookup and Prompt checks.
+GSC Insights reads your connected property's Google Search Console data; other research needs no GSC.
+Technical GEO checks crawler policies, content, snippets and structured-data syntax/shape.
+These checks do not measure autonomous agent journeys or guarantee AI inclusion or citations.
+The service is named SEO/GEO in the application; its command remains siteos seo.
 
 Usage:
   siteos seo status [--environment <slug>] [--json]
@@ -11820,7 +11834,7 @@ Commands:
   cookie        Configure, publish, and inspect the Project\u2019s cookie banner.
   trace         Configure analytics observation and inspect evidence.
   analytics     Configure website Analytics, events and realtime reports.
-  seo           Audit HTML, inspect changes and verify fixes.
+  seo           SEO/GEO audits, keyword research and AI visibility reports.
   integrations  Manage Organization connections and destinations.
   pulse         Manage monitoring checks, tests, and deployments.
   search        Run SiteOS search operations for a project environment.