@siteoshq/cli 1.2.0 → 1.3.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 and Integrations. This source prepares version 1.2.0; publishing is a separate release.
+Search, Trace, SEO and Integrations. This source prepares version 1.3.0; publishing is a separate release.
 Node.js 22 or newer is required.
 
 ## Install and authenticate
@@ -69,7 +69,7 @@ siteos project environment connect forms --environment production --resource '<f
 Omit `--resource` to create a new local environment. `siteos project environment list` reports the
 common catalog and connections. Forms/Search/Trace operational `--environment` flags accept common
 slugs and resolve explicit native bindings; without the flag, commands use the selected environment.
-Pulse/Cookie use separate bound resources per environment. Missing bindings fail without a fallback.
+Pulse/Cookie/SEO use separate bound resources per environment. Missing bindings fail without a fallback.
 Manage names and website URLs with `project update` and `project environment update <slug>`.
 Cookie/Trace published addresses remain unchanged until explicit republication.
 
@@ -136,6 +136,35 @@ 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)
+
+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.
+
+```sh
+siteos project connect seo --json
+siteos seo status --environment production --json
+siteos seo audit run --environment production --json
+siteos seo audit list --json
+siteos seo audit show '<audit-id>' --json
+siteos seo pages --audit '<audit-id>' --json
+siteos seo issues --audit '<audit-id>' --json
+siteos seo changes --audit '<audit-id>' --state resolved --json
+siteos seo recheck --audit '<audit-id>' --url https://example.com/pricing --json
+```
+
+Setup performs no crawl. `audit run` queues a full HTML audit; `recheck` queues one previously
+observed URL. Read the returned audit ID until a terminal state; a queued response is not a result.
+`audit cancel '<audit-id>'` revokes further work. Pages and changes are paginated with `--page`.
+
+`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
+Auth policy permits CLI service-grant issuance to Organization owners/admins. JSON uses contract
+version 1 and does not include credentials. The focused plugin skill is `siteos-seo`.
+
 ## Local state and diagnostics
 
 ```sh

package/dist/cli.js

@@ -483,7 +483,8 @@ var siteOSServiceAudienceSchema = z.enum([
   "siteos-cookie",
   "siteos-forms",
   "siteos-pulse",
-  "siteos-search"
+  "siteos-search",
+  "siteos-seo"
 ]);
 var siteOSServiceScopeSchema = z.string().min(1).max(160).regex(/^[a-z][a-z0-9-]*(?::[a-z][a-z0-9-]*){2,}$/);
 var scopeNamespaceByAudience = {
@@ -493,7 +494,8 @@ var scopeNamespaceByAudience = {
   "siteos-cookie": "cookie",
   "siteos-forms": "forms",
   "siteos-pulse": "pulse",
-  "siteos-search": "search"
+  "siteos-search": "search",
+  "siteos-seo": "seo"
 };
 function matchingServiceScopes(value, context) {
   const prefix = `${scopeNamespaceByAudience[value.audience]}:`;
@@ -1442,7 +1444,8 @@ var PROJECT_SERVICES = [
   "cookie",
   "forms",
   "search",
-  "trace"
+  "trace",
+  "seo"
 ];
 var ProjectSchema = z4.object({
   id: z4.string().min(1),
@@ -1496,7 +1499,7 @@ var OverviewSchema = z4.object({
 });
 function createProjectApi(input) {
   const origin = resolveSiteOSAuthBaseUrl(input.env);
-  async function request(path29, schema, body, method) {
+  async function request(path30, schema, body, method) {
     const scope = body === void 0 ? "projects:workspace:read" : "projects:workspace:write";
     const grant = await input.grants.acquire({
       audience: "siteos-projects",
@@ -1510,7 +1513,7 @@ function createProjectApi(input) {
         message: "SiteOS API access is unavailable."
       });
     const response = await input.fetchImpl(
-      `${origin}/api/projects/v1/projects${path29}`,
+      `${origin}/api/projects/v1/projects${path30}`,
       {
         method: method ?? (body === void 0 ? "GET" : "POST"),
         headers: {
@@ -1706,14 +1709,14 @@ async function commonServiceContext(options, service, environmentSlug) {
   const binding = attachment.environments.find(
     (item) => item.environmentId === context.environment.id
   );
-  if (["pulse", "cookie"].includes(service) && !binding)
+  if (["pulse", "cookie", "seo"].includes(service) && !binding)
     throw new SiteOSAuthApiError({
       code: "PROJECT_ENVIRONMENT_NOT_CONFIGURED",
       message: `Set up ${service} in ${context.environment.name} with \`siteos project connect ${service}\`.`
     });
   return {
     ...context,
-    resourceId: ["pulse", "cookie"].includes(service) ? binding.resourceId : attachment.resourceId,
+    resourceId: ["pulse", "cookie", "seo"].includes(service) ? binding.resourceId : attachment.resourceId,
     environmentBinding: binding
   };
 }
@@ -8752,13 +8755,13 @@ Usage:
   siteos project use <id-or-slug> [--json]
   siteos project update [--name <name>] [--slug <slug>] [--url <production-url>] [--json]
   siteos project status [--json]
-  siteos project connect <pulse|cookie|forms|search|trace> [--resource <id>] [--json]
+  siteos project connect <pulse|cookie|forms|search|trace|seo> [--resource <id>] [--json]
   siteos project environment list [--json]
   siteos project environment create --name <name> --slug <slug> [--url <url>] [--json]
   siteos project environment use <slug> [--json]
   siteos project environment update <slug> [--name <name>] [--url <url>] [--json]
-  siteos project environment resources <pulse|cookie|forms|search|trace> [--json]
-  siteos project environment connect <pulse|cookie|forms|search|trace> --environment <slug> [--resource <id>] [--json]
+  siteos project environment resources <pulse|cookie|forms|search|trace|seo> [--json]
+  siteos project environment connect <pulse|cookie|forms|search|trace|seo> --environment <slug> [--resource <id>] [--json]
 
 Select a Project once per repository. Service commands use its configured resources.
 Connect creates a draft workspace, or explicitly attaches an existing resource.
@@ -8856,7 +8859,7 @@ Run \`siteos project status\` to inspect its services.`;
         const service = parsed.positionals[0];
         if (!PROJECT_SERVICES.includes(service))
           throw new Error(
-            "Choose pulse, cookie, forms, search or trace. Organization connections use `siteos integrations`. "
+            "Choose pulse, cookie, forms, search, trace or seo. Organization connections use `siteos integrations`. "
           );
         overview = await api.connect(
           overview.project.id,
@@ -8912,7 +8915,7 @@ async function runEnvironmentCommand3(options) {
     throw new Error("Environment create requires --name and --slug.");
   const service = positionals[0];
   if ((action === "connect" || action === "resources") && !PROJECT_SERVICES.includes(service))
-    throw new Error("Choose pulse, cookie, forms, search or trace.");
+    throw new Error("Choose pulse, cookie, forms, search, trace or seo.");
   if (action === "connect" && !values.environment)
     throw new Error("Choose a Project environment with --environment <slug>.");
   const context = await readCommonProject(
@@ -9359,6 +9362,382 @@ async function runServiceCommand(service, options) {
   }
 }
 
+// src/services/seo-command.ts
+import { writeFile as writeFile8 } from "fs/promises";
+import path29 from "path";
+import { parseArgs as parseArgs4 } from "util";
+import { z as z16 } from "zod";
+var SEO_HELP = `Audit public HTML in the selected Project environment.
+
+Usage:
+  siteos seo status [--environment <slug>] [--json]
+  siteos seo audit run [--environment <slug>] [--json]
+  siteos seo audit list [--environment <slug>] [--json]
+  siteos seo audit show <id> [--environment <slug>] [--json]
+  siteos seo audit cancel <id> [--environment <slug>] [--json]
+  siteos seo pages [--audit <id>] [--query <text>] [--url <url>] [--page <number>] [--environment <slug>] [--json]
+  siteos seo issues [--audit <id>] [--rule <id>] [--page <number>] [--environment <slug>] [--json]
+  siteos seo changes [--audit <id>] [--state <new|reopened|still_present|resolved|not_rechecked>] [--page <number>] [--environment <slug>] [--json]
+  siteos seo recheck --audit <id> --url <url> [--environment <slug>] [--json]
+  siteos seo issue <ignore|restore> --audit <id> --url <url> --rule <id> --reason <text> --revision <number> [--environment <slug>] [--json]
+  siteos seo schedule show [--environment <slug>] [--json]
+  siteos seo schedule set --enabled <true|false> --weekday <1-7> --time <HH:mm> --timezone <IANA> --revision <number> [--environment <slug>] [--json]
+  siteos seo notifications retry <notification-id> [--environment <slug>] [--json]
+  siteos seo notifications show [--environment <slug>] [--json]
+  siteos seo notifications destinations [--environment <slug>] [--json]
+  siteos seo notifications set --enabled <true|false> [--destination <candidate-id>] --severity <error|warning> --failures <true|false> --revision <number> [--environment <slug>] [--json]
+  siteos seo export --audit <id> --kind <pages|issues|changes> --format <csv|json> --output <new-file> [--query <text>] [--rule <id>] [--severity <error|warning|notice>] [--state <page-or-change-state>] [--environment <slug>] [--json]
+
+Schedule and notification writes require an owner/admin and the saved revision (initially 0).
+Export writes all matching rows to a new file; existing files are never overwritten.
+Runs are queued. Read audit show until terminal; an accepted run is not a completed check.
+Recheck accepts a URL observed in the source audit. Cross-page rules require a full audit.
+Read the current disposition revision before ignore/restore; use 0 if no decision exists.
+Setup: siteos project connect seo. No crawl runs during setup.`;
+async function runSeoCommand(options) {
+  if (!options.args.length || options.args.some((arg) => ["--help", "-h"].includes(arg)))
+    return { exitCode: 0, stdout: SEO_HELP };
+  const json = options.args.includes("--json");
+  try {
+    const { positionals, values } = parseArgs4({
+      args: options.args,
+      strict: true,
+      allowPositionals: true,
+      options: {
+        json: { type: "boolean" },
+        environment: { type: "string" },
+        audit: { type: "string" },
+        url: { type: "string" },
+        rule: { type: "string" },
+        reason: { type: "string" },
+        revision: { type: "string" },
+        query: { type: "string" },
+        page: { type: "string" },
+        state: { type: "string" },
+        enabled: { type: "string" },
+        weekday: { type: "string" },
+        time: { type: "string" },
+        timezone: { type: "string" },
+        destination: { type: "string" },
+        severity: { type: "string" },
+        failures: { type: "string" },
+        kind: { type: "string" },
+        format: { type: "string" },
+        output: { type: "string" }
+      }
+    });
+    const route = positionals.slice(0, 2).join(" ");
+    const action = positionals[0];
+    const operations = {
+      status: { flags: [], args: 1 },
+      "schedule show": { flags: [], args: 2 },
+      "schedule set": {
+        flags: ["enabled", "weekday", "time", "timezone", "revision"],
+        args: 2
+      },
+      "notifications retry": { flags: [], args: 3 },
+      "notifications show": { flags: [], args: 2 },
+      "notifications destinations": { flags: [], args: 2 },
+      "notifications set": {
+        flags: ["enabled", "destination", "severity", "failures", "revision"],
+        args: 2
+      },
+      export: {
+        flags: [
+          "audit",
+          "kind",
+          "format",
+          "output",
+          "query",
+          "rule",
+          "severity",
+          "state"
+        ],
+        args: 1
+      },
+      "audit run": { flags: [], args: 2 },
+      "audit list": { flags: [], args: 2 },
+      "audit show": { flags: [], args: 3 },
+      "audit cancel": { flags: [], args: 3 },
+      pages: { flags: ["audit", "url", "query", "page"], args: 1 },
+      issues: { flags: ["audit", "rule", "page"], args: 1 },
+      changes: { flags: ["audit", "state", "page"], args: 1 },
+      recheck: { flags: ["audit", "url"], args: 1 },
+      "issue ignore": {
+        flags: ["audit", "url", "rule", "reason", "revision"],
+        args: 2
+      },
+      "issue restore": {
+        flags: ["audit", "url", "rule", "reason", "revision"],
+        args: 2
+      }
+    };
+    const operation = operations[route];
+    if (!operation || positionals.length !== operation.args || Object.keys(values).some(
+      (key) => !["json", "environment", ...operation.flags].includes(key)
+    ))
+      throw new Error(
+        "Invalid SEO operation or flags. Run `siteos seo --help`."
+      );
+    if (action === "recheck" && (!values.audit || !values.url))
+      throw new Error("Recheck requires --audit and --url.");
+    if (action === "issue" && ["audit", "url", "rule", "reason", "revision"].some(
+      (key) => !values[key]
+    ))
+      throw new Error(
+        "Issue decisions require --audit, --url, --rule, --reason and --revision."
+      );
+    if (values.page && !/^[1-9]\d{0,5}$/u.test(values.page))
+      throw new Error("Use a positive page number.");
+    if (values.revision && !/^\d{1,9}$/u.test(values.revision))
+      throw new Error("Use a non-negative revision.");
+    if (values.reason && (values.reason.trim().length < 3 || values.reason.length > 500))
+      throw new Error("Use a reason between 3 and 500 characters.");
+    const pageStateFilter = action === "export" && values.kind !== "changes";
+    if (values.state && !(pageStateFilter ? ["analyzed", "unavailable", "excluded", "non_html"] : ["new", "reopened", "still_present", "resolved", "not_rechecked"]).includes(values.state))
+      throw new Error("Use a documented page or change state for this export.");
+    const automation = ["schedule", "notifications"].includes(action ?? "");
+    const setting = automation && positionals[1] === "set";
+    if (setting && (!values.revision || !["true", "false"].includes(values.enabled ?? "")))
+      throw new Error("Settings require --enabled true|false and --revision.");
+    if (route === "schedule set") {
+      if (!/^[1-7]$/u.test(values.weekday ?? "") || !/^([01]\d|2[0-3]):[0-5]\d$/u.test(values.time ?? "") || !values.timezone)
+        throw new Error("Use weekday 1\u20137, HH:mm and an IANA time zone.");
+      try {
+        new Intl.DateTimeFormat("en", { timeZone: values.timezone });
+      } catch {
+        throw new Error("Use a valid IANA time zone.");
+      }
+    }
+    if (route === "notifications set" && (!["error", "warning"].includes(values.severity ?? "") || !["true", "false"].includes(values.failures ?? "") || values.enabled === "true" && !values.destination))
+      throw new Error(
+        "Notifications require --severity, --failures and an available --destination when enabled."
+      );
+    if (action === "export" && (!values.audit || !["pages", "issues", "changes"].includes(values.kind ?? "") || !["csv", "json"].includes(values.format ?? "") || !values.output))
+      throw new Error(
+        "Export requires --audit, --kind, --format and --output."
+      );
+    if (values.severity && !["error", "warning", "notice"].includes(values.severity))
+      throw new Error("Use a documented severity.");
+    const context = await commonServiceContext(
+      options,
+      "seo",
+      values.environment
+    );
+    if (!context)
+      throw new Error(
+        "Select a SiteOS Project with `siteos project use` first."
+      );
+    const runtime = commonProjectRuntime(options);
+    const retryNotification = route === "notifications retry";
+    const writing = retryNotification || setting || [
+      "audit run",
+      "audit cancel",
+      "recheck",
+      "issue ignore",
+      "issue restore"
+    ].includes(route);
+    const scope = retryNotification ? "seo:notifications:write" : setting ? action === "schedule" ? "seo:schedule:write" : "seo:notifications:write" : !writing ? "seo:workspace:read" : action === "issue" ? "seo:issues:write" : "seo:audits:write";
+    const grant = await runtime.grants.acquire({
+      audience: "siteos-seo",
+      scopes: [scope]
+    });
+    if (grant.grant.audience !== "siteos-seo" || grant.grant.scopes.length !== 1 || grant.grant.scopes[0] !== scope || grant.grant.organizationId !== context.overview.project.organizationId)
+      throw new SiteOSAuthApiError({
+        code: "AUTH_INVALID_RESPONSE",
+        message: "The SEO grant does not match this Project and operation."
+      });
+    const query = new URLSearchParams();
+    for (const [flag, name] of [
+      ["audit", "audit"],
+      ["rule", "rule"],
+      ["query", "q"],
+      ["url", "pageUrl"],
+      ["page", "page"],
+      ["state", "change"],
+      ["kind", "kind"],
+      ["format", "format"],
+      ["severity", "severity"]
+    ])
+      if (values[flag] && !writing) query.set(name, values[flag]);
+    if (pageStateFilter && values.state) {
+      query.delete("change");
+      query.set("state", values.state);
+    }
+    if (route === "audit show") query.set("audit", positionals[2]);
+    const suffix = retryNotification ? "/notification-retries" : automation ? setting ? `/${action}` : route === "notifications destinations" ? "/destinations" : "/automation" : action === "export" ? `/export?${query}` : route === "audit run" ? "/audits" : route === "audit cancel" ? `/audits/${encodeURIComponent(positionals[2])}/cancel` : action === "recheck" ? "/rechecks" : action === "issue" ? "/dispositions" : `?${query}`;
+    const body = retryNotification ? { notificationId: positionals[2] } : route === "schedule set" ? {
+      enabled: values.enabled === "true",
+      weekday: Number(values.weekday),
+      time: values.time,
+      timeZone: values.timezone,
+      expectedRevision: Number(values.revision)
+    } : route === "notifications set" ? {
+      enabled: values.enabled === "true",
+      candidateId: values.destination ?? null,
+      minimumSeverity: values.severity,
+      includeFailures: values.failures === "true",
+      expectedRevision: Number(values.revision)
+    } : action === "recheck" ? { auditId: values.audit, urls: [values.url] } : action === "issue" ? {
+      auditId: values.audit,
+      url: values.url,
+      ruleId: values.rule,
+      reason: values.reason,
+      expectedRevision: Number(values.revision),
+      ignored: positionals[1] === "ignore"
+    } : void 0;
+    if (!options.fetchImpl)
+      throw new Error("SiteOS API access is unavailable.");
+    const response = await options.fetchImpl(
+      `${runtime.api.origin}/api/seo/v1/resources/${encodeURIComponent(context.resourceId)}${suffix}`,
+      {
+        method: setting ? "PATCH" : writing ? "POST" : "GET",
+        headers: {
+          Accept: "application/json",
+          Authorization: `Bearer ${grant.accessToken}`,
+          ...body ? { "Content-Type": "application/json" } : {}
+        },
+        ...body ? { body: JSON.stringify(body) } : {},
+        signal: AbortSignal.timeout(3e4)
+      }
+    );
+    if (action === "export" && response.ok) {
+      if (!(response instanceof Response))
+        throw new Error("The API transport does not support file exports.");
+      const mime = values.format === "csv" ? "text/csv" : "application/json";
+      const rows = Number(response.headers.get("X-SEO-Export-Rows"));
+      if (response.headers.get("X-SEO-Audit-Id") !== values.audit || !response.headers.get("Content-Type")?.startsWith(mime) || !response.headers.has("X-SEO-Export-Rows") || !Number.isSafeInteger(rows) || rows < 0)
+        throw new Error(
+          "The export response does not match the requested audit."
+        );
+      const text = await response.text();
+      if (values.format === "json")
+        z16.object({
+          contractVersion: z16.literal(1),
+          audit: z16.object({
+            id: z16.literal(values.audit),
+            resourceId: z16.literal(context.resourceId)
+          }),
+          kind: z16.literal(values.kind),
+          totalRows: z16.literal(rows),
+          rows: z16.array(z16.unknown()).length(rows)
+        }).parse(JSON.parse(text));
+      const output = path29.resolve(options.cwd ?? process.cwd(), values.output);
+      await writeFile8(output, text, { flag: "wx", mode: 384 });
+      return {
+        exitCode: 0,
+        stdout: JSON.stringify(
+          {
+            auditId: values.audit,
+            kind: values.kind,
+            format: values.format,
+            rows,
+            output
+          },
+          null,
+          2
+        )
+      };
+    }
+    const data = await response.json();
+    if (!response.ok) {
+      const result = z16.object({
+        error: z16.object({ code: z16.string(), message: z16.string().max(500) })
+      }).safeParse(data);
+      throw new SiteOSAuthApiError({
+        code: result.success ? result.data.error.code : "SEO_REQUEST_FAILED",
+        message: result.success ? result.data.error.message : "The SEO request failed.",
+        status: response.status
+      });
+    }
+    const record = z16.object({ contractVersion: z16.literal(1) }).passthrough().parse(data);
+    if (automation) {
+      z16.literal(context.resourceId).parse(record.resourceId);
+      const schedule = z16.object({
+        enabled: z16.boolean(),
+        weekday: z16.number().int().min(1).max(7),
+        time: z16.string(),
+        timeZone: z16.string(),
+        revision: z16.number().int().min(0),
+        nextRunAt: z16.string().nullable()
+      });
+      const notificationRoute = z16.object({
+        enabled: z16.boolean(),
+        minimumSeverity: z16.enum(["error", "warning"]),
+        includeFailures: z16.boolean(),
+        revision: z16.number().int().min(0),
+        destinationId: z16.string().nullable()
+      });
+      if (retryNotification) {
+        z16.literal(true).parse(record.retryQueued);
+        z16.literal(positionals[2]).parse(record.notificationId);
+      } else if (route === "notifications destinations")
+        z16.object({
+          candidates: z16.array(
+            z16.object({
+              candidateId: z16.string(),
+              label: z16.string(),
+              availability: z16.literal("available")
+            })
+          )
+        }).parse(record);
+      else if (setting) {
+        const value = action === "schedule" ? schedule.parse(record.schedule) : notificationRoute.parse(record.route);
+        if (value.revision !== Number(values.revision) + 1 || value.enabled !== (values.enabled === "true"))
+          throw new Error("The saved settings do not match this change.");
+      } else {
+        schedule.parse(record.schedule);
+        notificationRoute.parse(record.route);
+      }
+    } else if (!writing) {
+      const validated = z16.object({
+        resource: z16.object({
+          id: z16.literal(context.resourceId),
+          organizationId: z16.literal(context.overview.project.organizationId)
+        }),
+        audits: z16.array(z16.object({ id: z16.string() }).passthrough()),
+        audit: z16.object({
+          id: z16.string(),
+          resourceId: z16.literal(context.resourceId)
+        }).passthrough().nullable(),
+        pages: z16.array(z16.unknown()),
+        issues: z16.array(z16.unknown()),
+        changes: z16.array(z16.unknown()),
+        totalChanges: z16.number(),
+        dispositions: z16.array(z16.unknown())
+      }).passthrough().parse(record);
+      const selected = query.get("audit");
+      if (selected && validated.audit?.id !== selected)
+        throw new Error("The SEO response does not match the requested audit.");
+    } else if (record.audit)
+      z16.object({
+        id: z16.string(),
+        resourceId: z16.literal(context.resourceId),
+        organizationId: z16.literal(context.overview.project.organizationId),
+        state: z16.literal("queued")
+      }).parse(record.audit);
+    else if (route === "audit cancel") z16.literal(true).parse(record.cancelled);
+    else if (action === "issue")
+      z16.object({
+        url: z16.literal(values.url),
+        ruleId: z16.literal(values.rule),
+        ignored: z16.literal(positionals[1] === "ignore"),
+        revision: z16.literal(Number(values.revision) + 1)
+      }).parse(record.disposition);
+    else throw new Error("The SEO service returned an invalid response.");
+    return { exitCode: 0, stdout: JSON.stringify(record, null, 2) };
+  } catch (cause) {
+    const error = {
+      code: cause instanceof SiteOSAuthApiError ? cause.code : "SEO_COMMAND_FAILED",
+      message: cause instanceof z16.ZodError ? "The SEO service returned an invalid response." : cause instanceof Error ? cause.message : "The SEO command failed."
+    };
+    return {
+      exitCode: cause instanceof SiteOSAuthApiError ? 1 : 2,
+      ...json ? { stdout: JSON.stringify({ error }) } : { stderr: error.message }
+    };
+  }
+}
+
 // src/cli.ts
 var [command, ...args] = process.argv.slice(2);
 var HELP_FLAGS5 = /* @__PURE__ */ new Set(["--help", "-h"]);
@@ -9392,6 +9771,12 @@ if (!command || command === "--help" || command === "-h") {
 }
 function rootCommandRegistry() {
   return createCommandRegistry({
+    seo: (args2) => runSeoCommand({
+      args: args2,
+      cwd: process.cwd(),
+      env: process.env,
+      fetchImpl: globalThis.fetch
+    }),
     "health-check": runHealthCheck,
     project: (args2) => runProjectCommand4({
       args: args2,
@@ -9499,6 +9884,7 @@ Usage:
   siteos project --help
   siteos cookie --help
   siteos trace --help
+  siteos seo --help
   siteos integrations --help
   siteos pulse --help
   siteos search --help
@@ -9510,6 +9896,7 @@ Commands:
   project       Select one Project and configure its services and environments.
   cookie        Configure, publish, and inspect the Project\u2019s cookie banner.
   trace         Configure analytics observation and inspect evidence.
+  seo           Audit HTML, inspect changes and verify fixes.
   integrations  Manage Organization connections and destinations.
   pulse         Manage monitoring checks, tests, and deployments.
   search        Run SiteOS search operations for a project environment.