pushmetrics-cli 0.1.0__py3-none-any.whl

pm/commands/help.py

@@ -0,0 +1,643 @@
+"""`pm help` — terse, agent-tuned help pages (pm-tool plan §2.3 / tasks A.1).
+
+Click already auto-renders verbose help via ``pm --help`` / ``pm <group>
+--help`` — that's the human-facing fallback. ``pm help`` is the
+*agent-facing* surface: every page is ≤600 chars (vs Click's ~1500–3000
+char rendering), structured as "Verbs → Body fields → Example", and
+filtered by the ``PM_AGENT_DENIED_ACTIONS`` env var so denied actions
+don't even appear in help (defense in depth alongside dispatch-layer
+denial in pm_tool.py per pm-consolidation).
+
+Why short pages matter
+----------------------
+The agent burns input tokens on every help fetch. A 3000-char Click
+``--help`` rendering pushes ~750 tokens through every time. A 500-char
+``pm help`` page is ~125 tokens. At the scale of hundreds of agent
+help fetches per workspace per day, the delta compounds.
+
+Suppression contract
+--------------------
+``PM_AGENT_DENIED_ACTIONS`` (CSV of ``<noun>.<verb>`` canonical_actions)
+is the single policy source. ``pm_tool.py`` reads it for dispatch
+denial; this module reads it for help rendering. Setting it to
+``block.delete,sftp.create,sftp.send`` (the default ``single_tool`` list)
+hides those verbs from ``pm help block`` and ``pm help sftp``.
+"""
+from __future__ import annotations
+
+import os
+from typing import Dict, List, Optional
+
+import click
+
+
+# ── Group-name → backend noun (for canonical_action mapping) ─────────
+#
+# Duplicates the map in prefect/queryme/agent/canonical_actions.py
+# because the CLI is HTTP-only (cli/tests/test_no_backend_imports.py)
+# and can't pull from the prefect agent. Keep these two maps in sync
+# manually — small static data, low churn risk.
+
+_GROUP_TO_NOUN: Dict[str, str] = {
+    "sql": "sql",
+    "email": "email",
+    "slack": "slack",
+    "sftp": "sftp",
+    "chart": "plotly",
+    "explore": "explore",
+    "metrics-view": "metrics_view",
+    "tableau": "tableau",
+    "slides": "google_slides",
+    "block": "block",
+}
+
+
+# ── Per-group pages ──────────────────────────────────────────────────
+#
+# Each entry has `verbs` (ordered dict mapping CLI verb → one-line
+# description) plus a `page` template that includes verb list + body
+# fields + example. Verbs are filtered against PM_AGENT_DENIED_ACTIONS
+# before rendering — the page template gets the filtered verb dict
+# back.
+
+_GROUP_PAGES: Dict[str, Dict] = {
+    "sql": {
+        "verbs": {
+            "create": "Create a SQL block (returns uid; does NOT run).",
+            "list":   "List. [--name <text>] [--limit <n>].",
+            "get":    "Show one. <uid>.",
+            "run":    "Execute by <uid>, or transient override via --stdin against an assigned scratch (no persist).",
+            "results": "Past execution result(s). <uid> [--last|--result-id].",
+        },
+        "body_fields": (
+            "  sql          (req) SQL query string\n"
+            "  database_id  (req) UID of the database to run against\n"
+            "  limit        (opt) row limit"
+        ),
+        "example": (
+            "  echo '{\"sql\":\"SELECT 1\",\"database_id\":\"<db_uid>\"}' \\\n"
+            "    | pm sql run --stdin --json"
+        ),
+        "summary": "Create + run SQL blocks (block_type=sql).",
+    },
+    "email": {
+        "verbs": {
+            "create": "Create; does not send.",
+            "list":   "List. [--name <text>] [--limit <n>].",
+            "get":    "Show one. <uid>.",
+            "send":   "Send <uid>, or a --stdin body once.",
+            "results": "Past sends. <uid> [--last|--result-id].",
+        },
+        "body_fields": (
+            "  subject         (req)\n"
+            "  body            (req) HTML/text\n"
+            "  integration_id  (req) email integration uid\n"
+            "  to_             (req) string or list — note trailing _\n"
+            "  cc, bcc         (opt) string or list"
+        ),
+        "example": (
+            "  echo '{\"subject\":\"Hi\",\"body\":\"x\",\"integration_id\":\"<int>\",\"to_\":\"a@b.com\"}' \\\n"
+            "    | pm email send --stdin --json"
+        ),
+        "summary": "Create + send email blocks.",
+    },
+    "slack": {
+        "verbs": {
+            "create": "Create a slack block.",
+            "list":   "List. [--name <text>] [--limit <n>].",
+            "get":    "Show one. <uid>.",
+            "send":   "Send by <uid>, or transient override via --stdin against an assigned scratch (no persist).",
+            "results": "Past send result(s).",
+        },
+        "body_fields": (
+            "  integration_id  (req) slack integration uid\n"
+            "  channels        (req) LIST of channel names or DM ids\n"
+            "  message         (req)"
+        ),
+        "example": (
+            "  echo '{\"integration_id\":\"<int>\",\"channels\":[\"#alerts\"],\"message\":\"deploy ok\"}' \\\n"
+            "    | pm slack send --stdin --json"
+        ),
+        "summary": "Create + send Slack message blocks.",
+    },
+    "sftp": {
+        "verbs": {
+            "create": "Create an SFTP block.",
+            "list":   "List. [--name <text>] [--limit <n>].",
+            "get":    "Show one. <uid>.",
+            "send":   "Upload by <uid>, or transient override via --stdin against an assigned scratch (no persist).",
+            "results": "Past upload result(s).",
+        },
+        "body_fields": (
+            "  integration_id  (req)\n"
+            "  path            (req) destination path on the SFTP server\n"
+            "  attachments     (opt) list of URLs/refs (e.g. csv_download_url\n"
+            "                        from prior run_sql) to upload"
+        ),
+        "example": (
+            "  pm sftp send <uid> --json"
+        ),
+        "summary": "Create + send SFTP upload blocks.",
+    },
+    "chart": {
+        "verbs": {
+            "create": "Create + auto-render. --name=<n> --stdin.",
+            "list":   "List. [--name <text>] [--limit <n>].",
+            "get":    "Show one. <uid>.",
+            "update": "<uid> --stdin (replaces the Plotly spec).",
+            "run":    "Re-render an existing chart block. <uid>.",
+            "results": "Past render result(s).",
+        },
+        "body_fields": (
+            "  properties      (req) {data, layout} per Plotly schema\n"
+            "  image_filename  (opt)"
+        ),
+        "example": (
+            "  pm chart create --name=q4-rev --stdin < spec.json"
+        ),
+        "summary": (
+            "Create + render Plotly chart blocks (block_type=plotly).\n"
+            "NOTE: creating a chart also renders the PNG as a side effect."
+        ),
+    },
+    "explore": {
+        "verbs": {
+            "create": "Create an explore block. --name=<n> --stdin.",
+            "list":   "List. [--name <text>] [--limit <n>].",
+            "get":    "Show one. <uid>.",
+            "update": "<uid> --stdin (replaces the saved-view definition).",
+        },
+        "body_fields": "  (free-form — saved-view definition)",
+        "example": (
+            "  pm explore create --name=daily-funnel --stdin < view.json\n"
+            "  pm explore list --json"
+        ),
+        "summary": (
+            "Create explore (saved-view) blocks.\n"
+            "NOTE: no execute verb — the UI renders these."
+        ),
+    },
+    "metrics-view": {
+        "verbs": {
+            "create":  "Create.",
+            "list":    "List. [--name <text>] [--limit <n>].",
+            "get":     "Show one. <uid>.",
+            "update":  "<uid> --stdin.",
+            "query":   "Semantic query. <uid> [flags or --stdin].",
+            "schema":  "Available measures/dimensions. <uid>.",
+        },
+        "body_fields": (
+            "  --measure NAME    repeatable, ≥1 required\n"
+            "  --dimension NAME  repeatable\n"
+            "  --time-range last_30d | 2026-01-01:2026-04-01\n"
+            "  --limit N, --offset N, --no-cache\n"
+            "  --stdin for filters/order_by/parameters"
+        ),
+        "example": (
+            "  pm metrics-view query <uid> --measure=orders --dimension=region --json"
+        ),
+        "summary": "Manage + query metrics view blocks (semantic layer).",
+    },
+    "tableau": {
+        "verbs": {
+            "create":  "Create.",
+            "list":    "List. [--name <text>] [--limit <n>].",
+            "get":     "Show one. <uid>.",
+            "run":     "Exports/downloads Tableau view as PNG/PDF/embed URL.",
+            "results": "Past render result(s).",
+            "search":  "List views (or --workbooks).",
+            "view":    "One view's metadata.",
+        },
+        "body_fields": (
+            "  --integration <uid>  search/view integration\n"
+            "  --keyword <text>     name filter\n"
+            "  --workbook-id <id>   narrow search\n"
+            "  --workbooks          search workbooks\n"
+            "  --view-id <id>       required for view"
+        ),
+        "example": (
+            "  pm tableau search --integration=<uid> --keyword=Sales --json"
+        ),
+        "summary": "Tableau blocks + discovery.",
+    },
+    "slides": {
+        "verbs": {
+            "create":          "Create.",
+            "list":            "List. [--name <text>] [--limit <n>].",
+            "get":             "Show one. <uid>.",
+            "run":             "Compose presentation.",
+            "results":         "Past render result(s).",
+            "parse-template":  "Parse master deck (once after create).",
+            "export":          "Export as PDF. [--filename]",
+            "batch-update":    "Slides API batchUpdate. --stdin.",
+        },
+        "body_fields": (
+            "  --stdin JSON:\n"
+            "    integration_id, template_id, source_file_id"
+        ),
+        "example": (
+            "  pm slides parse-template <uid> --json\n"
+            "  pm slides export <uid> --filename=q4.pdf --json"
+        ),
+        "summary": (
+            "Google Slides blocks (google_slides)."
+        ),
+    },
+    "block": {
+        "verbs": {
+            "get":     "Show one. <uid>.",
+            "list":    "List. [--type=<T>] [--name <text>] [--limit <n>].",
+            "create":  "--type=<T> --name=<n> --stdin.",
+            "update":  "<uid> [--name=<n>] [--stdin].",
+            "delete":  "<uid> [--yes].",
+            "run":     "Execute (stored type wins; --type rejected).",
+            "results": "<uid> [--last|--result-id].",
+        },
+        "body_fields": (
+            "  content_json shape on create depends on --type\n"
+            "  (see `pm help <type>` for per-type fields)."
+        ),
+        "example": (
+            "  pm block list --type=sql --json\n"
+            "  pm block create --type=email --name=daily --stdin < body.json"
+        ),
+        "summary": "CRUD plumbing across all block types.",
+    },
+
+    # ── CRUD resource groups ──────────────────────────────────────────
+    # Pages for the non-typed-block-group verbs. Without these, ``pm
+    # help report`` (etc.) returned ``No help for 'report'``, leaving
+    # the agent to guess flags after every failure (session N8wE87kOmz
+    # took 46 tool calls partly because of this discoverability gap).
+
+    "report": {
+        "verbs": {
+            "list":   "List reports (newest first). [--name <text>] [--limit <n>].",
+            "get":    "Show one. <uid>.",
+            "yaml":   "Dump YAML. <uid>.",
+            "update": "<uid> [--name=<n>].",
+            "apply":  (
+                "YAML via stdin: `pm report apply -`. With --uid, blocks "
+                "missing from the YAML are DELETED — use --no-prune to "
+                "only upsert, --dry-run to preview."
+            ),
+            "run":    "Trigger NEW run. For past runs use `pm run list --report=<uid>`.",
+            "delete": "<uid> [--yes].",
+        },
+        "example": (
+            "  pm report list --json\n"
+            "  pm run list --report=<uid> --last-days=7\n"
+            "  pm report apply - --uid=<uid>      # YAML via tool's stdin"
+        ),
+        "summary": "Reports and their runs.",
+    },
+    "run": {
+        "verbs": {
+            "list":    "Recent runs. [--report <uid>] [--last-days <n>] [--status <s>] [--limit <n>].",
+            "get":     "Status, timing, flow_run_id. <run_uid>.",
+            "results": "Per-block results for a run. <run_uid>.",
+            "logs":    "Log lines for a run. <run_uid|flow_run_id>.",
+        },
+        "body_fields": (
+            "  ``get`` is metadata only — NO row data (use `pm sql run\n"
+            "  --stdin`). Debug a failed report: list its runs, then\n"
+            "  read one run's logs (`--level=ERROR` for failure lines)."
+        ),
+        "example": (
+            "  pm run list --report=<report_uid> --last-days=2 --status=failed\n"
+            "  pm run logs <run_uid> --level=ERROR --json"
+        ),
+        "summary": "Noteflow run inspection.",
+    },
+    "database": {
+        "verbs": {
+            "list":        "Workspace databases. [--name <text>] [--limit <n>].",
+            "schemas":     "<db_ref>.",
+            "tables":      "<db_ref> <schema>.",
+            "describe":    "<db_ref> <schema> <table>.",
+            "select-star": "SELECT * SQL, not run. <db_ref> <schema> <table>.",
+            "exists":      "<db_ref> <schema> <table>.",
+            "search":      "<db_ref> <pattern> [--schema <s>].",
+            "functions":   "<db_ref>.",
+        },
+        "body_fields": (
+            "  <db_ref>: uid or name (quote spaces).\n"
+            "  select-star prints SQL; pipe it into `pm sql run --stdin`."
+        ),
+        "example": (
+            "  pm database list --json\n"
+            "  pm database tables \"Demo DB\" public --json"
+        ),
+        "summary": "Database introspection.",
+    },
+    "folder": {
+        "verbs": {
+            "list":   "Workspace folders. [--name <text>] [--limit <n>].",
+            "get":    "Show one folder. <uid>.",
+            "create": "Create a folder. --name=<n> [--parent=<uid>].",
+            "update": "Rename / move. <uid> [--name=<n>] [--parent=<uid>].",
+            "delete": "Delete a folder. <uid> [--yes].",
+        },
+        "example": (
+            "  pm folder list --json\n"
+            "  pm folder create --name=Marketing --json"
+        ),
+        "summary": "Folder CRUD.",
+    },
+    "user": {
+        "verbs": {
+            "list":     "Workspace users. [--name <text>] [--limit <n>].",
+            "get":      "Show one user. <uid>.",
+            "create":   "Create a user. --email=<e> [--name=<n>].",
+            "delete":   "Delete a user. <uid> [--yes].",
+            "set-role": "Assign a role. <user_uid> <role_name>.",
+        },
+        "example": (
+            "  pm user list --json\n"
+            "  pm user set-role <user_uid> editor --json"
+        ),
+        "summary": "User management.",
+    },
+    "recipient": {
+        "verbs": {
+            "list":    "Recipients in the workspace CRM. [--name <text>] [--limit <n>].",
+            "get":     "Show one recipient. <uid>.",
+            "details": "Aggregate read (linked destinations etc.). <uid>.",
+            "create":  "Create a recipient. --name=<n> --email=<e>.",
+            "update":  "Update recipient. <uid> [--name=<n>] [--email=<e>].",
+            "delete":  "Delete recipient. <uid> [--yes].",
+        },
+        "example": (
+            "  pm recipient list --json\n"
+            "  pm recipient create --name=\"Alice\" --email=alice@acme.test --json"
+        ),
+        "summary": "Recipients (delivery-target CRM).",
+    },
+    "integration": {
+        "verbs": {
+            "list": "Workspace integrations (Tableau / Slack / Email / SFTP / GCP / S3 / Slides etc.). [--name <text>] [--type <t>] [--limit <n>].",
+        },
+        "body_fields": (
+            "  Use ``--type=tableau`` (etc.) to filter to one type.\n"
+            "  Pass the resulting uid as ``--integration=<uid>`` to\n"
+            "  search / view / send verbs."
+        ),
+        "example": (
+            "  pm integration list --json\n"
+            "  pm integration list --type=tableau --json"
+        ),
+        "summary": "Integration discovery.",
+    },
+    "favorite": {
+        "verbs": {
+            "list":   "Favorited blocks / reports. [--limit <n>].",
+            "create": "Mark as favorite. <uid>.",
+            "delete": "Unfavorite. <uid>.",
+        },
+        "example": (
+            "  pm favorite list --json"
+        ),
+        "summary": "Favorites management.",
+    },
+    "organization": {
+        "verbs": {
+            "current": "Show the calling user's organization.",
+        },
+        "example": (
+            "  pm organization current --json"
+        ),
+        "summary": "Organization discovery.",
+    },
+    "role": {
+        "verbs": {
+            "list":   "Roles available in the workspace. [--name <text>] [--limit <n>].",
+            "assign": "Assign role to user. <user_uid> <role_name>.",
+            "revoke": "Revoke role from user. <user_uid> <role_name>.",
+        },
+        "example": (
+            "  pm role list --json\n"
+            "  pm role assign <user_uid> editor --json"
+        ),
+        "summary": "Role assignments.",
+    },
+    "saved-block": {
+        "verbs": {
+            "list":   "Saved (template) blocks in the workspace. [--name <text>] [--limit <n>].",
+            "update": "Update a saved block. <uid> [--name=<n>] [--stdin].",
+            "delete": "Delete a saved block. <uid> [--yes].",
+        },
+        "example": (
+            "  pm saved-block list --json"
+        ),
+        "summary": "Saved-block (template) management.",
+    },
+    "workspace": {
+        "verbs": {
+            "list":    "Workspaces this user belongs to. [--name <text>] [--limit <n>].",
+            "current": "Show the active workspace for this session.",
+        },
+        "body_fields": (
+            "  Switching / creating / deleting workspaces is intentionally\n"
+            "  NOT available to the agent — context comes from the calling\n"
+            "  user's session."
+        ),
+        "example": (
+            "  pm workspace current --json\n"
+            "  pm workspace list --json"
+        ),
+        "summary": "Workspace discovery (read-only for agents).",
+    },
+}
+
+
+# ── Account topics (plain pages, no verb table) ──────────────────────
+#
+# Listed on the top page, so `pm help <topic>` must answer for each.
+
+_PLAIN_PAGES: Dict[str, str] = {
+    "login": (
+        "pm login — Log in with a personal access token.\n\n"
+        "  pm login --token        paste the token at the hidden prompt\n"
+        "  <secrets-cmd> | pm login --token   pipe it from a secrets manager\n"
+        "  PM_API_TOKEN=...        use it without storing (CI, scripts)\n\n"
+        "Tokens are created in the web app under Access Tokens."
+    ),
+    "logout": (
+        "pm logout — Forget the stored token or session for the profile.\n\n"
+        "  pm logout\n  pm --profile staging logout"
+    ),
+    "whoami": (
+        "pm whoami — Show who you are logged in as, and the workspace.\n\n"
+        "  pm whoami --json\n\n"
+        "A token is bound to the workspace it was created in."
+    ),
+    "token": (
+        "pm token — Personal access tokens.\n\n"
+        "Verbs:\n"
+        "  list     Your tokens (metadata only). [--name <text>] [--limit <n>]\n"
+        "  create   Create one; the value is printed once, on stdout.\n"
+        "  revoke   Revoke by numeric ID. <id>\n\n"
+        "Example:\n  pm token create ci-exports --expires-on 2027-01-01"
+    ),
+    "config": (
+        "pm config — Profiles: which PushMetrics server pm talks to.\n\n"
+        "Verbs:\n"
+        "  list   Profiles and active env overrides.\n"
+        "  set    Set one field. <profile> <key> <value>\n"
+        "         keys: api_url auth0_domain auth0_client_id auth0_audience\n\n"
+        "Example:\n  pm config set staging api_url https://staging.example.com"
+    ),
+}
+
+
+# ── Top-level page (≤800 chars) ──────────────────────────────────────
+
+
+# NOTE: the surface map below only lists groups + verbs the agent can
+# actually invoke via the cli_adapter ALLOWED_COMMANDS set. `auth`
+# (login / logout / whoami), `webhook`, and the mutating
+# `workspace` / `organization` verbs are deliberately omitted —
+# the agent runs under a delegation JWT (no Auth0 needed), has no
+# webhook surface allowed, and inherits its workspace + organization
+# context from the calling user's session.
+_TOP_LEVEL_PAGE = """pm — PushMetrics CLI.
+
+Common:
+  pm sql run --stdin --json       Run SQL via assigned scratch (body on stdin)
+  pm report list                  List reports
+  pm block list --type=sql        Filter blocks by type
+  pm metrics-view query <uid>     Run a semantic query
+  pm tableau search --integration=<uid>  List Tableau views
+
+Surface:
+  Domain actions:   sql email slack sftp chart explore metrics-view
+                    tableau slides
+  Resources:        report folder favorite user role organization
+                    saved-block integration recipient run
+  Block plumbing:   block
+  DB:               database
+  Workspace:        workspace
+  Account:          login logout whoami token config
+
+`pm help <topic>` for verb-specific help with examples.
+`pm --help` lists every command."""
+
+
+# ── Suppression: PM_AGENT_DENIED_ACTIONS ─────────────────────────────
+
+
+def _denied_actions_from_env() -> "frozenset[str]":
+    """Parse ``PM_AGENT_DENIED_ACTIONS`` into a set of canonical_actions.
+
+    Empty / unset env var → empty set (no suppression). Whitespace
+    around commas tolerated. Unknown entries are kept as-is — the
+    canonical_action format is ``<noun>.<verb>``, but we don't validate
+    here; help suppression is best-effort and pm_tool.py is the
+    real enforcement point.
+    """
+    raw = os.environ.get("PM_AGENT_DENIED_ACTIONS", "")
+    return frozenset({x.strip() for x in raw.split(",") if x.strip()})
+
+
+def _canonical_action_for(group: str, verb: str) -> str:
+    """Map (group, verb) to ``<noun>.<verb>`` for deny-list matching.
+
+    Mirrors prefect/queryme/agent/canonical_actions.py's static map for
+    the typed-group case. Block-plumbing keeps ``block.<verb>`` here
+    (without uid-based type discrimination) because the help page
+    describes the verb generically — runtime dispatch will resolve to
+    a typed action via the real resolver.
+    """
+    noun = _GROUP_TO_NOUN.get(group, group)
+    return f"{noun}.{verb}"
+
+
+def _filter_verbs(
+    group: str,
+    verbs: Dict[str, str],
+    denied: "frozenset[str]",
+) -> Dict[str, str]:
+    if not denied:
+        return verbs
+    return {
+        verb: desc
+        for verb, desc in verbs.items()
+        if _canonical_action_for(group, verb) not in denied
+    }
+
+
+# ── Page rendering ────────────────────────────────────────────────────
+
+
+def _render_group_page(group: str, denied: "frozenset[str]") -> str:
+    spec = _GROUP_PAGES[group]
+    visible_verbs = _filter_verbs(group, spec["verbs"], denied)
+
+    lines: List[str] = [f"pm {group} — {spec['summary']}", ""]
+
+    if not visible_verbs:
+        lines.append(
+            "No verbs available in the current agent mode. "
+            "Check PM_AGENT_DENIED_ACTIONS or use a wider mode.",
+        )
+        return "\n".join(lines)
+
+    lines.append("Verbs:")
+    width = max(len(v) for v in visible_verbs) + 2
+    for verb, desc in visible_verbs.items():
+        lines.append(f"  {verb.ljust(width)}{desc}")
+
+    if "body_fields" in spec and spec["body_fields"]:
+        lines.append("")
+        lines.append("Body fields:")
+        lines.append(spec["body_fields"])
+
+    lines.append("")
+    lines.append("Example:")
+    lines.append(spec["example"])
+
+    return "\n".join(lines)
+
+
+def _known_topics() -> List[str]:
+    return sorted(set(_GROUP_PAGES) | set(_PLAIN_PAGES))
+
+
+# ── Click command ────────────────────────────────────────────────────
+
+
+@click.command(name="help")
+@click.argument("topic", required=False)
+@click.pass_context
+def help_cmd(ctx: click.Context, topic: Optional[str]) -> None:
+    """Show compact help for a group, with examples.
+
+    With no topic, prints the surface map; with a topic (e.g. pm help sql),
+    prints that group's page. This is the view the AI agent reads.
+
+    Suppresses verbs denied via PM_AGENT_DENIED_ACTIONS so agent-mode
+    help only surfaces invokable actions.
+    """
+    denied = _denied_actions_from_env()
+    if topic is None:
+        click.echo(_TOP_LEVEL_PAGE)
+        return
+    if topic in _PLAIN_PAGES:
+        click.echo(_PLAIN_PAGES[topic])
+        return
+    if topic not in _GROUP_PAGES:
+        click.echo(
+            f"No help for {topic!r}. Known topics: {', '.join(_known_topics())}",
+            err=True,
+        )
+        ctx.exit(1)
+    click.echo(_render_group_page(topic, denied))
+
+
+# Exposed for tests + introspection.
+__all__ = [
+    "help_cmd",
+    "_GROUP_PAGES",
+    "_GROUP_TO_NOUN",
+    "_TOP_LEVEL_PAGE",
+]