@siteoshq/cli 2.7.0 → 2.9.0

package/README.md

@@ -417,6 +417,26 @@ for exact inputs, thresholds and installation of the common GTM execution monito
 The installation response supplies `gtmExecutionMonitor.templateUrl` and its trigger contract.
 MCP exposes read-only issue, event, observation, coverage, GTM and notification views.
 
+### Search content and quality
+
+`siteos search crawl list --environment <slug>` lists crawlers. Create one with `crawl create --name "Documentation" --file <crawler.json>` or update it with `crawl configure --crawler <id> --file <crawler.json>`. Use `--environment <slug>` for every command. Configuration includes HTML scope and a schedule with selected weekdays, time and time zone. Use `crawl start --crawler <id>`, read `crawl status --crawler <id>`, then `crawl publish --run <id> --apply` after reviewing changes. Partial crawls additionally require `--accept-truncated`. The crawler preserves other sources and keeps the current index serving until publication. See the canonical Search skill crawler reference for limits and robots/noindex policy.
+
+`siteos search sync --environment <slug> --file <payload.json>` validates and previews a full replacement. Add `--apply` after reviewing removals. `search content` inspects the published documents and `search query --query <text>` runs a query without visitor telemetry.
+
+Use `search relevance show`, `preview --file <relevance.json>`, `compare --revision <id>` and `apply --revision <id>` to compare a separately indexed configuration before serving it. `search installation verify --url <website-query-endpoint> --query <known-page>` verifies the real website proxy without sending it a management credential.
+
+`search visitors report --days 30` reports consented visitor searches and result clicks. Collection defaults off; `search visitors configure --enabled true --retention-days 30` enables the backend after the website consent flow is connected. Operational `search analytics` keeps its existing index/job meaning. All commands use the selected common Project and explicit `--environment`; run `siteos search --help` for complete syntax.
+
+### Algolia migration preparation
+
+`siteos search migrate algolia --records records.ndjson --mapping mapping.json --out migration-review --json` prepares a local export without Auth or network access. Optional `--settings`, `--synonyms` and `--rules` preserve configuration for review. Original bytes are archived; invalid rows or oversized content prevent creation of a replacement payload. See the canonical [migration workflow](../../plugins/siteos/skills/siteos-search/references/algolia-migration.md).
+
+Search delivery uses `siteos search delivery status --environment staging --json` and reviewed
+`delivery configure --environment staging --file delivery.json --apply --json`. The configure file
+contains `settings` (`enabled`, exact `allowedOrigins`), `confirmPublic: true` and optional `rotateKey`.
+Search sync stages snapshots over 4 MB in bounded upload parts, up to 100 MB/100,000 documents,
+and queues one replacement only after preview and `--apply`.
+
 
 ## Forms workspace and recurring SEO audits (2.7.0)