@siteoshq/cli 1.6.0 → 1.7.0

package/README.md

@@ -281,3 +281,26 @@ Definitions include a generated SHA-256 `sourceExportId`; runtime sends it as `c
 A changed field requires a normal build/release, not a second hand-edited validation schema.
 `forms deployment-key list|revoke` manages release keys; submission keys cannot publish.
 See the SiteOS Forms skill for the portable generator and version serialization contract.
+
+
+## Website Analytics
+
+The source CLI includes `siteos analytics` for an explicitly connected Project environment. Check
+`siteos analytics --help` against the installed package and server before use; source availability
+does not establish publication. Start with `project status`, `analytics status` and
+`analytics installation`. Use `--environment <slug>` when selecting the target explicitly.
+
+`analytics settings show` returns the current revision. `analytics settings set --revision <n>`
+accepts partial `--enabled true|false`, `--cookie-events true|false` and
+`--minimal-realtime true|false` updates. Analytics collects independently by default. Native consent
+control belongs to Cookie's published `integrations.siteosAnalytics` switch in the same Project
+environment; attachment or a draft save does not enable it. External CMP gating is optional and
+must be configured before runtime initialization. Privacy signals and full opt-out still apply.
+Reload the website after configuration changes.
+
+`analytics events list|create|snippet`, campaigns, goals and funnels manage reviewed categorical
+definitions. Creation uses `--file <definition.json>`; reports and realtime read accepted data.
+`analytics monitoring prepare` prepares a Trace draft without publishing it. Auth grants are scoped
+to Analytics and the operation, with editor roles required for writes. Analytics is Unlimited in
+Usage during early access. See the canonical plugin's website Analytics skill for event contracts
+and the browser-to-report verification workflow; Search reports use `search analytics` separately.