docs: regenerate command docs

Author: github-actions[bot]

docs/modapi.md

@@ -38,13 +38,15 @@ modapi [flags]
 
 * [modapi account](modapi_account.md)	 - Operations for account
 * [modapi actions](modapi_actions.md)	 - Operations for actions
+* [modapi analytics](modapi_analytics.md)	 - Operations for analytics
 * [modapi auth](modapi_auth.md)	 - Manage authentication credentials
 * [modapi authors](modapi_authors.md)	 - Operations for authors
 * [modapi channels](modapi_channels.md)	 - Operations for channels
 * [modapi configure](modapi_configure.md)	 - Configure authentication credentials and preferences
 * [modapi content](modapi_content.md)	 - Operations for content
 * [modapi doctor](modapi_doctor.md)	 - Check the Moderation API setup of this project
 * [modapi explore](modapi_explore.md)	 - Interactively browse and run commands
+* [modapi feedback](modapi_feedback.md)	 - Operations for feedback
 * [modapi init](modapi_init.md)	 - Set up Moderation API in this project
 * [modapi link](modapi_link.md)	 - Connect this directory to an existing Moderation API project
 * [modapi login](modapi_login.md)	 - Sign in with your Moderation API account

docs/modapi_analytics.md

@@ -0,0 +1,51 @@
+## modapi analytics
+
+Operations for analytics
+
+### Synopsis
+
+Operations for analytics
+
+```
+modapi analytics [flags]
+```
+
+### Options
+
+```
+  -h, --help   help for analytics
+```
+
+### Options inherited from parent commands
+
+```
+      --agent-mode             Enable structured errors and default TOON output for AI coding agents. Automatically enabled when a known agent environment is detected (CLAUDECODE, CURSOR_AGENT, etc.). Use --agent-mode=false to disable.
+      --color string           Control colored output: auto (color when output is a TTY), always, or never. Respects NO_COLOR and FORCE_COLOR env vars. (default "auto")
+  -d, --debug                  Log request and response diagnostics to stderr
+      --dry-run                Preview API requests without sending them (no network, no OS keychain). Human preview on stderr; with -o json or --jq, one JSON object per request on stdout. Local mutation commands (auth login, auth logout and configure) make no request: they skip prompts and writes and report a no-op (stderr, or one JSON object on stdout in the machine form)
+  -H, --header stringArray     Set a custom HTTP request header (format: "Key: Value"). Can be specified multiple times.
+      --include-headers        Include HTTP response headers in the output
+      --interactive            Prompt for missing inputs and open guided configure/auth forms (forms fall back to line prompts on stdin off-TTY) (default true)
+  -q, --jq string              Filter and transform output using a jq expression (e.g., '.name', '.items[] | .id')
+      --no-interactive         Disable all interactive features (auto-prompting, explorer auto-launch, TUI forms)
+      --no-keyring             Never read or write the OS keychain; store secrets in the config file instead (env: MODAPI_NO_KEYRING)
+  -o, --output-format string   Specify the output format. Options: pretty, json, yaml, table, toon. (default "pretty")
+      --raw-output             Write --jq string results as raw text instead of JSON strings (like jq -r); non-string results stay JSON
+      --secret-key string      HTTP Bearer
+      --server string          Select a server by index (for indexed servers) or name (for named servers)
+      --server-url string      Override the default server URL
+      --timeout string         HTTP request timeout (e.g., 30s, 5m, 100ms)
+      --usage                  Print the CLI Usage schema in KDL format
+```
+
+### SEE ALSO
+
+* [modapi](modapi.md)	 - Moderation API: Moderate text, images, video and audio in real time, manage authors, review queues and actions, and receive webhooks
+* [modapi analytics authors](modapi_analytics_authors.md)	 - Get the most flagged authors
+* [modapi analytics automation](modapi_analytics_automation.md)	 - Get the automation breakdown
+* [modapi analytics channels](modapi_analytics_channels.md)	 - Get analytics per channel
+* [modapi analytics policies](modapi_analytics_policies.md)	 - Get the most flagged policies
+* [modapi analytics summary](modapi_analytics_summary.md)	 - Get the analytics summary
+* [modapi analytics volumes](modapi_analytics_volumes.md)	 - Get volumes over time
+
+Exit codes: 0 ok · 1 runtime · 2 usage · 3 authentication/authorization

docs/modapi_analytics_authors.md

@@ -0,0 +1,62 @@
+## modapi analytics authors
+
+Get the most flagged authors
+
+### Synopsis
+
+Get the authors with the most flagged content in a time window, largest first.
+
+```
+modapi analytics authors [flags]
+```
+
+### Examples
+
+```
+  modapi analytics authors
+```
+
+### Options
+
+```
+  -c, --channel string      string value
+  -h, --help                help for authors
+  -l, --limit int           integer value (default 6)
+  -p, --project-id string   The project to act on, by ID or name. Required with an organization key unless the key reaches only one project; list projects with GET /projects. A project key acts on its own project and needs no value: naming another one is an error.
+  -r, --range string        The time window. '24h' is the last 24 hours, in hourly buckets. '7d', '30d' and '90d' are whole UTC days that end with today, in daily buckets. (options: 24h, 7d, 30d, 90d) (default "30d")
+```
+
+### Options inherited from parent commands
+
+```
+      --agent-mode             Enable structured errors and default TOON output for AI coding agents. Automatically enabled when a known agent environment is detected (CLAUDECODE, CURSOR_AGENT, etc.). Use --agent-mode=false to disable.
+      --color string           Control colored output: auto (color when output is a TTY), always, or never. Respects NO_COLOR and FORCE_COLOR env vars. (default "auto")
+  -d, --debug                  Log request and response diagnostics to stderr
+      --dry-run                Preview API requests without sending them (no network, no OS keychain). Human preview on stderr; with -o json or --jq, one JSON object per request on stdout. Local mutation commands (auth login, auth logout and configure) make no request: they skip prompts and writes and report a no-op (stderr, or one JSON object on stdout in the machine form)
+  -H, --header stringArray     Set a custom HTTP request header (format: "Key: Value"). Can be specified multiple times.
+      --include-headers        Include HTTP response headers in the output
+      --interactive            Prompt for missing inputs and open guided configure/auth forms (forms fall back to line prompts on stdin off-TTY) (default true)
+  -q, --jq string              Filter and transform output using a jq expression (e.g., '.name', '.items[] | .id')
+      --no-interactive         Disable all interactive features (auto-prompting, explorer auto-launch, TUI forms)
+      --no-keyring             Never read or write the OS keychain; store secrets in the config file instead (env: MODAPI_NO_KEYRING)
+  -o, --output-format string   Specify the output format. Options: pretty, json, yaml, table, toon. (default "pretty")
+      --raw-output             Write --jq string results as raw text instead of JSON strings (like jq -r); non-string results stay JSON
+      --secret-key string      HTTP Bearer
+      --server string          Select a server by index (for indexed servers) or name (for named servers)
+      --server-url string      Override the default server URL
+      --timeout string         HTTP request timeout (e.g., 30s, 5m, 100ms)
+      --usage                  Print the CLI Usage schema in KDL format
+```
+
+### SEE ALSO
+
+* [modapi analytics](modapi_analytics.md)	 - Operations for analytics
+
+### Machine interface
+
+* `modapi analytics authors --usage` — this command's flags, defaults and env vars as machine-readable KDL
+* `modapi analytics authors --dry-run` — preview the request without OS-keychain access or a network call (human preview on stderr)
+* `--dry-run --output-format json` (or a caller-explicit `--jq`) writes one preview object per request as NDJSON on stdout; jq is not applied to previews
+* `--output-format json` or `--jq <expr>` for machine-readable live output; in agent mode errors are a JSON envelope on stderr
+
+Exit codes: 0 ok · 1 runtime · 2 usage · 3 authentication/authorization

docs/modapi_analytics_automation.md

@@ -0,0 +1,61 @@
+## modapi analytics automation
+
+Get the automation breakdown
+
+### Synopsis
+
+Get how flagged content was handled in a time window: settled by rules or the casebook, or sent to human review, and what the reviewers decided.
+
+```
+modapi analytics automation [flags]
+```
+
+### Examples
+
+```
+  modapi analytics automation
+```
+
+### Options
+
+```
+  -c, --channel string      string value
+  -h, --help                help for automation
+  -p, --project-id string   The project to act on, by ID or name. Required with an organization key unless the key reaches only one project; list projects with GET /projects. A project key acts on its own project and needs no value: naming another one is an error.
+  -r, --range string        The time window. '24h' is the last 24 hours, in hourly buckets. '7d', '30d' and '90d' are whole UTC days that end with today, in daily buckets. (options: 24h, 7d, 30d, 90d) (default "30d")
+```
+
+### Options inherited from parent commands
+
+```
+      --agent-mode             Enable structured errors and default TOON output for AI coding agents. Automatically enabled when a known agent environment is detected (CLAUDECODE, CURSOR_AGENT, etc.). Use --agent-mode=false to disable.
+      --color string           Control colored output: auto (color when output is a TTY), always, or never. Respects NO_COLOR and FORCE_COLOR env vars. (default "auto")
+  -d, --debug                  Log request and response diagnostics to stderr
+      --dry-run                Preview API requests without sending them (no network, no OS keychain). Human preview on stderr; with -o json or --jq, one JSON object per request on stdout. Local mutation commands (auth login, auth logout and configure) make no request: they skip prompts and writes and report a no-op (stderr, or one JSON object on stdout in the machine form)
+  -H, --header stringArray     Set a custom HTTP request header (format: "Key: Value"). Can be specified multiple times.
+      --include-headers        Include HTTP response headers in the output
+      --interactive            Prompt for missing inputs and open guided configure/auth forms (forms fall back to line prompts on stdin off-TTY) (default true)
+  -q, --jq string              Filter and transform output using a jq expression (e.g., '.name', '.items[] | .id')
+      --no-interactive         Disable all interactive features (auto-prompting, explorer auto-launch, TUI forms)
+      --no-keyring             Never read or write the OS keychain; store secrets in the config file instead (env: MODAPI_NO_KEYRING)
+  -o, --output-format string   Specify the output format. Options: pretty, json, yaml, table, toon. (default "pretty")
+      --raw-output             Write --jq string results as raw text instead of JSON strings (like jq -r); non-string results stay JSON
+      --secret-key string      HTTP Bearer
+      --server string          Select a server by index (for indexed servers) or name (for named servers)
+      --server-url string      Override the default server URL
+      --timeout string         HTTP request timeout (e.g., 30s, 5m, 100ms)
+      --usage                  Print the CLI Usage schema in KDL format
+```
+
+### SEE ALSO
+
+* [modapi analytics](modapi_analytics.md)	 - Operations for analytics
+
+### Machine interface
+
+* `modapi analytics automation --usage` — this command's flags, defaults and env vars as machine-readable KDL
+* `modapi analytics automation --dry-run` — preview the request without OS-keychain access or a network call (human preview on stderr)
+* `--dry-run --output-format json` (or a caller-explicit `--jq`) writes one preview object per request as NDJSON on stdout; jq is not applied to previews
+* `--output-format json` or `--jq <expr>` for machine-readable live output; in agent mode errors are a JSON envelope on stderr
+
+Exit codes: 0 ok · 1 runtime · 2 usage · 3 authentication/authorization

docs/modapi_analytics_channels.md

@@ -0,0 +1,60 @@
+## modapi analytics channels
+
+Get analytics per channel
+
+### Synopsis
+
+Get requests, flags and flag rate for each channel of the project in a time window.
+
+```
+modapi analytics channels [flags]
+```
+
+### Examples
+
+```
+  modapi analytics channels
+```
+
+### Options
+
+```
+  -h, --help                help for channels
+  -p, --project-id string   The project to act on, by ID or name. Required with an organization key unless the key reaches only one project; list projects with GET /projects. A project key acts on its own project and needs no value: naming another one is an error.
+  -r, --range string        The time window. '24h' is the last 24 hours, in hourly buckets. '7d', '30d' and '90d' are whole UTC days that end with today, in daily buckets. (options: 24h, 7d, 30d, 90d) (default "30d")
+```
+
+### Options inherited from parent commands
+
+```
+      --agent-mode             Enable structured errors and default TOON output for AI coding agents. Automatically enabled when a known agent environment is detected (CLAUDECODE, CURSOR_AGENT, etc.). Use --agent-mode=false to disable.
+      --color string           Control colored output: auto (color when output is a TTY), always, or never. Respects NO_COLOR and FORCE_COLOR env vars. (default "auto")
+  -d, --debug                  Log request and response diagnostics to stderr
+      --dry-run                Preview API requests without sending them (no network, no OS keychain). Human preview on stderr; with -o json or --jq, one JSON object per request on stdout. Local mutation commands (auth login, auth logout and configure) make no request: they skip prompts and writes and report a no-op (stderr, or one JSON object on stdout in the machine form)
+  -H, --header stringArray     Set a custom HTTP request header (format: "Key: Value"). Can be specified multiple times.
+      --include-headers        Include HTTP response headers in the output
+      --interactive            Prompt for missing inputs and open guided configure/auth forms (forms fall back to line prompts on stdin off-TTY) (default true)
+  -q, --jq string              Filter and transform output using a jq expression (e.g., '.name', '.items[] | .id')
+      --no-interactive         Disable all interactive features (auto-prompting, explorer auto-launch, TUI forms)
+      --no-keyring             Never read or write the OS keychain; store secrets in the config file instead (env: MODAPI_NO_KEYRING)
+  -o, --output-format string   Specify the output format. Options: pretty, json, yaml, table, toon. (default "pretty")
+      --raw-output             Write --jq string results as raw text instead of JSON strings (like jq -r); non-string results stay JSON
+      --secret-key string      HTTP Bearer
+      --server string          Select a server by index (for indexed servers) or name (for named servers)
+      --server-url string      Override the default server URL
+      --timeout string         HTTP request timeout (e.g., 30s, 5m, 100ms)
+      --usage                  Print the CLI Usage schema in KDL format
+```
+
+### SEE ALSO
+
+* [modapi analytics](modapi_analytics.md)	 - Operations for analytics
+
+### Machine interface
+
+* `modapi analytics channels --usage` — this command's flags, defaults and env vars as machine-readable KDL
+* `modapi analytics channels --dry-run` — preview the request without OS-keychain access or a network call (human preview on stderr)
+* `--dry-run --output-format json` (or a caller-explicit `--jq`) writes one preview object per request as NDJSON on stdout; jq is not applied to previews
+* `--output-format json` or `--jq <expr>` for machine-readable live output; in agent mode errors are a JSON envelope on stderr
+
+Exit codes: 0 ok · 1 runtime · 2 usage · 3 authentication/authorization

docs/modapi_analytics_policies.md

@@ -0,0 +1,62 @@
+## modapi analytics policies
+
+Get the most flagged policies
+
+### Synopsis
+
+Get the policy labels that flagged the most content in a time window, largest first, with the count in the window before.
+
+```
+modapi analytics policies [flags]
+```
+
+### Examples
+
+```
+  modapi analytics policies
+```
+
+### Options
+
+```
+  -c, --channel string      string value
+  -h, --help                help for policies
+  -l, --limit int           integer value (default 8)
+  -p, --project-id string   The project to act on, by ID or name. Required with an organization key unless the key reaches only one project; list projects with GET /projects. A project key acts on its own project and needs no value: naming another one is an error.
+  -r, --range string        The time window. '24h' is the last 24 hours, in hourly buckets. '7d', '30d' and '90d' are whole UTC days that end with today, in daily buckets. (options: 24h, 7d, 30d, 90d) (default "30d")
+```
+
+### Options inherited from parent commands
+
+```
+      --agent-mode             Enable structured errors and default TOON output for AI coding agents. Automatically enabled when a known agent environment is detected (CLAUDECODE, CURSOR_AGENT, etc.). Use --agent-mode=false to disable.
+      --color string           Control colored output: auto (color when output is a TTY), always, or never. Respects NO_COLOR and FORCE_COLOR env vars. (default "auto")
+  -d, --debug                  Log request and response diagnostics to stderr
+      --dry-run                Preview API requests without sending them (no network, no OS keychain). Human preview on stderr; with -o json or --jq, one JSON object per request on stdout. Local mutation commands (auth login, auth logout and configure) make no request: they skip prompts and writes and report a no-op (stderr, or one JSON object on stdout in the machine form)
+  -H, --header stringArray     Set a custom HTTP request header (format: "Key: Value"). Can be specified multiple times.
+      --include-headers        Include HTTP response headers in the output
+      --interactive            Prompt for missing inputs and open guided configure/auth forms (forms fall back to line prompts on stdin off-TTY) (default true)
+  -q, --jq string              Filter and transform output using a jq expression (e.g., '.name', '.items[] | .id')
+      --no-interactive         Disable all interactive features (auto-prompting, explorer auto-launch, TUI forms)
+      --no-keyring             Never read or write the OS keychain; store secrets in the config file instead (env: MODAPI_NO_KEYRING)
+  -o, --output-format string   Specify the output format. Options: pretty, json, yaml, table, toon. (default "pretty")
+      --raw-output             Write --jq string results as raw text instead of JSON strings (like jq -r); non-string results stay JSON
+      --secret-key string      HTTP Bearer
+      --server string          Select a server by index (for indexed servers) or name (for named servers)
+      --server-url string      Override the default server URL
+      --timeout string         HTTP request timeout (e.g., 30s, 5m, 100ms)
+      --usage                  Print the CLI Usage schema in KDL format
+```
+
+### SEE ALSO
+
+* [modapi analytics](modapi_analytics.md)	 - Operations for analytics
+
+### Machine interface
+
+* `modapi analytics policies --usage` — this command's flags, defaults and env vars as machine-readable KDL
+* `modapi analytics policies --dry-run` — preview the request without OS-keychain access or a network call (human preview on stderr)
+* `--dry-run --output-format json` (or a caller-explicit `--jq`) writes one preview object per request as NDJSON on stdout; jq is not applied to previews
+* `--output-format json` or `--jq <expr>` for machine-readable live output; in agent mode errors are a JSON envelope on stderr
+
+Exit codes: 0 ok · 1 runtime · 2 usage · 3 authentication/authorization