@thinkingai/ae-cli 6.0.37 → 6.0.39

package/skills/ae-agent/references/find-archived-conversations.md

@@ -0,0 +1,82 @@
+# agent +find-archived-conversations (Find Archived Conversations)
+
+> **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
+
+Domain: **Conversations / read**
+
+## Use Cases
+
+- Find conversations the current user previously archived.
+- Search one Agent by default inside an Agent sandbox.
+- Search a specific Agent from a regular terminal, or explicitly search all Agents.
+- Discover a real `conversation_id` before `+restore-conversation`.
+
+## Mandatory Rules (MUST)
+
+- Never silently search every Agent. Outside an Agent sandbox, provide `--agent-id` or `--all true`.
+- `--all false` does not authorize an all-Agent search.
+- `--agent-id` and `--all true` are mutually exclusive.
+- Inside an Agent sandbox, the default Agent is read from `TE_AGENT_CURRENT_AGENT_ID`.
+- Do not guess conversation IDs. Use the `conversation_id` returned by this command.
+- The command only finds archived conversations. It does not archive active conversations.
+
+## Command
+
+```bash
+# Current Agent inside an Agent sandbox
+ae-cli agent +find-archived-conversations
+
+# Specific Agent from any terminal
+ae-cli agent +find-archived-conversations --agent-id <agent-id> --q "quarterly review" --time-zone Asia/Shanghai
+
+# Display local timestamps in another time zone
+ae-cli agent +find-archived-conversations --agent-id <agent-id> --time-zone America/Los_Angeles
+
+# Explicit all-Agent search
+ae-cli agent +find-archived-conversations --all true --limit 100 --format table
+
+# Inspect the request without calling the API
+ae-cli agent +find-archived-conversations --agent-id <agent-id> --dry-run
+```
+
+## Parameters
+
+| Parameter     | Required    | Description                                                        |
+| ------------- | ----------- | ------------------------------------------------------------------ |
+| `--q`         | No          | Keyword matched against conversation titles and message previews   |
+| `--agent-id`  | Conditional | Agent ID; required outside a sandbox unless `--all true` is used   |
+| `--all`       | Conditional | Must be explicitly `true` to search every Agent                    |
+| `--limit`     | No          | Maximum results, integer 1–100; default 20                         |
+| `--time-zone` | No          | IANA time zone for local timestamp fields; default `Asia/Shanghai` |
+
+## Output
+
+- `items[].conversation_id`: stable ID accepted by `+restore-conversation`.
+- `items[].title`, `last_preview`: conversation summary.
+- `items[].archived_at`, `updated_at`: original UTC ISO timestamps for stable machine processing.
+- `items[].archived_at_local`, `updated_at_local`: timestamps converted to `items[].time_zone` in `YYYY-MM-DD HH:mm:ss` format.
+- `items[].time_zone`: IANA time zone used for the local timestamp fields.
+- `items[].agent`: originating Agent summary when available.
+- `has_more`: `true` when additional matches exist beyond the requested limit.
+
+When presenting results to a user, prefer `archived_at_local` and `updated_at_local`. Pass the user's IANA time zone through `--time-zone` when known; otherwise use the default `Asia/Shanghai`.
+
+## Next Steps on Failure
+
+- Scope error: add `--agent-id <agent-id>` or explicitly use `--all true`.
+- Time zone error: provide a valid IANA name such as `Asia/Shanghai` or `America/Los_Angeles`.
+- Empty result: try another keyword or an explicit all-Agent search.
+- Auth error: run `ae-cli auth login`, or verify that the command is running inside the expected Agent sandbox.
+
+## Recommended Chaining
+
+- `+find-archived-conversations` → choose a real `conversation_id` → `+restore-conversation`
+
+## Transition Metadata
+
+- Transition status: transitional
+- Owning module: te-claude conversation archive
+- Current transport: te-claude sandbox REST API
+- Gateway target: `agent.conversation.find_archived`
+- Review after: 2026-10-23
+- Exit condition: Migrate to the Gateway when the equivalent capability has stable metadata and output, or remove this command if L3 discovery provides the same typed scope and output guarantees.

package/skills/ae-agent/references/restore-conversation.md

@@ -0,0 +1,54 @@
+# agent +restore-conversation (Restore Conversation)
+
+> **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
+
+Domain: **Conversations / write**
+
+## Use Cases
+
+- Restore one archived conversation by its `conversation_id`.
+- Retry safely when a previous restore result was uncertain; restoring an already active conversation is idempotent and returns `changed: false`.
+
+## Mandatory Rules (MUST)
+
+- Obtain the real `conversation_id` from `+find-archived-conversations`; never guess it.
+- This is an ordinary `write` operation and does not require destructive confirmation.
+- Restoring a conversation does not restore its previous pinned state.
+- The command does not provide an archive operation.
+
+## Command
+
+```bash
+ae-cli agent +restore-conversation --conversation-id <conversation-id>
+ae-cli agent +restore-conversation --conversation-id <conversation-id> --dry-run
+```
+
+## Parameters
+
+| Parameter           | Required | Description                                   |
+| ------------------- | -------- | --------------------------------------------- |
+| `--conversation-id` | Yes      | ID returned by `+find-archived-conversations` |
+
+## Output
+
+- `conversation_id`: the restored conversation ID.
+- `changed`: `true` when this call restored the conversation, or `false` when it was already active.
+
+## Next Steps on Failure
+
+- `conversation_not_found`: refresh the archive search and verify ownership.
+- `conversation_active`: wait for the active run to finish before retrying.
+- Auth error: run `ae-cli auth login`, or verify the current Agent sandbox credentials.
+
+## Recommended Chaining
+
+- `+find-archived-conversations` → `+restore-conversation`
+
+## Transition Metadata
+
+- Transition status: transitional
+- Owning module: te-claude conversation archive
+- Current transport: te-claude sandbox REST API
+- Gateway target: `agent.conversation.restore`
+- Review after: 2026-10-23
+- Exit condition: Migrate to the Gateway when the equivalent capability has stable write metadata and idempotency guarantees, or remove this command if L3 provides the same typed safety.

package/skills/ae-agent/references/upload-skill.md

@@ -5,6 +5,7 @@
 Domain: **Skills / write**
 
 ## Use Cases
+
 - Upload a ZIP-format Skill package. The server parses SKILL.md from the ZIP, extracts files to the target directory, and writes the DB record.
 - Endpoint: `POST /api/sandbox/agent/skills/upload` (multipart/form-data, 120s timeout).
 - Supports form-field overrides for name, displayName, description, instructions, icon, category.
@@ -13,6 +14,7 @@ Domain: **Skills / write**
 - `--auto-rename` auto-renames on name conflict.
 
 ## Mandatory Rules (MUST)
+
 - `--file` is required and must be a `.zip` file that exists on disk.
 - The ZIP must contain a `SKILL.md` file (with name and content at minimum).
 - `--scope` must be `personal` or `company` (default `personal`).
@@ -21,9 +23,11 @@ Domain: **Skills / write**
 - This is an ordinary `write` operation and does not require CLI confirmation.
 
 ## Market Category Keys
+
 `ae_preset | dev_tool | search_tool | data_query | content_gen | enterprise | life | automation | other`
 
 ## Command
+
 ```bash
 # Upload a personal Skill from ZIP
 ae-cli agent +upload-skill --file ./my-skill.zip
@@ -43,7 +47,7 @@ echo "You are a helpful assistant..." | \
   ae-cli agent +upload-skill --file ./my-skill.zip --instructions @-
 
 # Replace an existing Skill
-ae-cli agent +upload-skill --file ./updated.zip --replace-skill-id <skill-cuid>
+ae-cli agent +upload-skill --file ./updated.zip --replace-skill-id <skill-cuid> --version 1.1
 
 # Auto-rename on conflict
 ae-cli agent +upload-skill --file ./my-skill.zip --auto-rename
@@ -53,29 +57,34 @@ ae-cli agent +upload-skill --dry-run --file ./my-skill.zip
 ```
 
 ## Parameters
-| Parameter | Required | Description |
-|---|---|---|
-| `--file` | Yes | Local `.zip` file path |
-| `--scope` | No | Target scope: `personal` (default) or `company` |
-| `--auto-rename` | No | Auto-rename on name conflict |
-| `--replace-skill-id` | No | Replace an existing Skill (CUID) instead of creating new |
-| `--category` | No | Market category key (see above) |
-| `--name` | No | Override Skill name (from ZIP SKILL.md if omitted) |
-| `--display-name` | No | Override display name |
-| `--description` | No | Override description |
-| `--instructions` | No | Override instructions (use `@-` to read from stdin) |
-| `--icon-emoji` | No | Market icon emoji (e.g. `robot`) |
-| `--icon-color` | No | Market icon color (e.g. `#1E76F0`) |
+
+| Parameter            | Required                 | Description                                                                                 |
+| -------------------- | ------------------------ | ------------------------------------------------------------------------------------------- |
+| `--file`             | Yes                      | Local `.zip` file path                                                                      |
+| `--scope`            | No                       | Target scope: `personal` (default) or `company`                                             |
+| `--auto-rename`      | No                       | Auto-rename on name conflict                                                                |
+| `--replace-skill-id` | No                       | Replace an existing Skill (CUID) instead of creating new                                    |
+| `--version`          | Required for replacement | Content version in `major.minor` format. Creation defaults to the package version or `1.0`. |
+| `--category`         | No                       | Market category key (see above)                                                             |
+| `--name`             | No                       | Override Skill name (from ZIP SKILL.md if omitted)                                          |
+| `--display-name`     | No                       | Override display name                                                                       |
+| `--description`      | No                       | Override description                                                                        |
+| `--instructions`     | No                       | Override instructions (use `@-` to read from stdin)                                         |
+| `--icon-emoji`       | No                       | Market icon emoji (e.g. `robot`)                                                            |
+| `--icon-color`       | No                       | Market icon color (e.g. `#1E76F0`)                                                          |
 
 ## Decision Rules
+
 - The ZIP must contain a `SKILL.md` with at least `name` and content — otherwise the upload fails with `missing_skill_md` or `missing_name_or_content`.
 - Form-field overrides take precedence over ZIP SKILL.md content.
 - Use `--replace-skill-id` to update an existing Skill's full content from a ZIP (different from `+edit-skill` which edits individual fields).
+- Replacement requires `--version`; the server rejects changed content unless the version is strictly higher.
 - Use `--auto-rename` when the Skill name might conflict with an existing one.
 - `company` scope requires root privileges.
 - Use `--dry-run` first to verify the request shape before executing.
 
 ## Next Steps on Failure
+
 - `File not found`: verify the local file path.
 - `--file must be a .zip file`: only ZIP format is supported.
 - `ZIP 中缺少 SKILL.md`: ensure the ZIP contains a `SKILL.md` file.
@@ -85,4 +94,5 @@ ae-cli agent +upload-skill --dry-run --file ./my-skill.zip
 - `409` / name conflict: use `--auto-rename` or choose a different `--name`.
 
 ## Recommended Chaining
+
 - `+upload-skill` → `+list-skills` (verify) → `+get-skill-content` (inspect) → `+edit-skill` (fine-tune) → `+submit-skill` (publish)

package/skills/ae-analysis/SKILL.md

@@ -94,7 +94,7 @@ For every gateway command that exposes `--request-id`, ae-cli generates a `reque
 Before a project-scoped command:
 
 1. Reuse a project only when its ID and host/environment were already verified in the same continuous conversation.
-2. Otherwise call `analysis project info list` and resolve the supplied ID/name.
+2. Otherwise call `project info list` and resolve the supplied ID/name.
 3. If there are multiple plausible projects, the host is unclear, or no project matches, show the candidates and ask; never guess.
 4. Re-verify after the user changes project, host, or environment.
 

package/skills/ae-analysis/references/command_index.md

@@ -76,48 +76,6 @@ This is the exhaustive command and flag inventory for the analysis skill. Read t
 | `ae-cli analysis input-file inspect` | gateway lifecycle | read | `--input-file-id` (string; required) — Uploaded input file ID, for example ifile_<32 lowercase hex>. | [input_file_inspect.md](input_file_inspect.md) |
 | `ae-cli analysis input-file purpose list` | analysis.input_file.purpose.list | read | `--project-id` (number; required) — Numeric project ID. | [input_file_purpose_list.md](input_file_purpose_list.md) |
 | `ae-cli analysis input-file upload` | gateway lifecycle | write | `--project-id` (number; required) — Numeric project ID.<br>`--purpose` (string; required) — Purpose returned by analysis input-file purpose list.<br>`--file` (string; required) — Local file path to upload. | [input_file_upload.md](input_file_upload.md) |
-| `ae-cli analysis project access-detail get` | project.access_detail.get | read | `--company-id` (number; required) — Company ID. | [project_access_detail_get.md](project_access_detail_get.md) |
-| `ae-cli analysis project data-power delete` | project.data_power.delete | high-risk-write | `--project-id` (number; required) — Numeric project ID.<br>`--data-power-id` (number; required) — Data power ID to delete.<br>`--new-data-power-id` (number; optional) — Optional replacement data power ID for affected users. | [project_data_power_delete.md](project_data_power_delete.md) |
-| `ae-cli analysis project data-power get` | project.data_power.get | read | `--project-id` (number; required) — Numeric project ID.<br>`--data-power-id` (number; required) — Data power ID. | [project_data_power_get.md](project_data_power_get.md) |
-| `ae-cli analysis project data-power list` | project.data_power.list | read | `--project-id` (number; required) — Numeric project ID. | [project_data_power_list.md](project_data_power_list.md) |
-| `ae-cli analysis project data-power upsert` | project.data_power.upsert | write | `--project-id` (number; required) — Numeric project ID.<br>`--payload` (json; required) — Required snake_case capability payload. Read the dedicated command reference for its semantic shape; an empty object is not a generic valid payload. | [project_data_power_upsert.md](project_data_power_upsert.md) |
-| `ae-cli analysis project entity create` | project.entity.create | write | `--project-id` (number; required) — Numeric project ID.<br>`--entity-name` (string; required) — Entity display name.<br>`--column-name` (string; required) — Property column name to bind.<br>`--table-type` (number; required) — Main table type: 0 for event property, 1 for user property.<br>`--order` (number; optional) — Optional entity display order. | [project_entity_create.md](project_entity_create.md) |
-| `ae-cli analysis project entity delete` | project.entity.delete | high-risk-write | `--project-id` (number; required) — Numeric project ID.<br>`--entity-id` (number; required) — Analysis entity ID. | [project_entity_delete.md](project_entity_delete.md) |
-| `ae-cli analysis project entity get` | project.entity.get | read | `--project-id` (number; required) — Numeric project ID.<br>`--entity-id` (number; required) — Analysis entity ID. | [project_entity_get.md](project_entity_get.md) |
-| `ae-cli analysis project entity list` | project.entity.list | read | `--project-id` (number; required) — Numeric project ID.<br>`--query` (string; optional) — Optional keyword filter.<br>`--fields` (json; optional) — Optional result field projection JSON array.<br>`--limit` (number; optional) — Optional inline result limit.<br>`--offset` (number; optional) — Optional zero-based result offset.<br>`--event-name` (string; optional) — Optional event name. When present, return entities related to the event. | [project_entity_list.md](project_entity_list.md) |
-| `ae-cli analysis project entity update` | project.entity.update | write | `--project-id` (number; required) — Numeric project ID.<br>`--entity-id` (number; required) — Analysis entity ID.<br>`--entity-name` (string; required) — Entity display name.<br>`--column-name` (string; required) — Property column name to bind.<br>`--table-type` (number; required) — Main table type: 0 for event property, 1 for user property.<br>`--order` (number; optional) — Optional entity display order. | [project_entity_update.md](project_entity_update.md) |
-| `ae-cli analysis project entity-event list` | project.entity_event.list | read | `--project-id` (number; required) — Numeric project ID.<br>`--event-names` (json; optional) — Optional event names JSON array to resolve entity mappings for. | [project_entity_event_list.md](project_entity_event_list.md) |
-| `ae-cli analysis project function list` | project.function.list | read | `--company-id` (number; optional) — Company ID.<br>`--project-id` (number; required) — Numeric project ID. | [project_function_list.md](project_function_list.md) |
-| `ae-cli analysis project info get` | project.info.get | read | `--project-id` (number; required) — Numeric project ID. | [project_info_get.md](project_info_get.md) |
-| `ae-cli analysis project info list` | project.info.list | read | `--query` (string; optional) — Optional keyword filter.<br>`--fields` (json; optional) — Optional result field projection JSON array.<br>`--limit` (number; optional) — Optional inline result limit.<br>`--offset` (number; optional) — Optional zero-based result offset. | [project_info_list.md](project_info_list.md) |
-| `ae-cli analysis project info update` | project.info.update | write | `--project-id` (number; required) — Numeric project ID.<br>`--project-name` (string; required) — New project name.<br>`--project-remark` (string; optional) — Optional project remark. | [project_info_update.md](project_info_update.md) |
-| `ae-cli analysis project mark-time create` | project.mark_time.create | write | `--project-id` (number; required) — Numeric project ID.<br>`--marked-at` (string; required) — Marker timestamp, for example yyyy-MM-dd HH:mm.<br>`--zone-offset` (number; optional) — Marker time zone offset.<br>`--content` (string; required) — Marker content.<br>`--is-visible` (number; optional) — Whether the marker is visible. 1 visible, 0 hidden. | [project_mark_time_create.md](project_mark_time_create.md) |
-| `ae-cli analysis project mark-time delete` | project.mark_time.delete | high-risk-write | `--project-id` (number; required) — Numeric project ID.<br>`--mark-time-ids` (json; required) — Date marker IDs JSON array to delete. | [project_mark_time_delete.md](project_mark_time_delete.md) |
-| `ae-cli analysis project mark-time list` | project.mark_time.list | read | `--project-id` (number; required) — Numeric project ID.<br>`--query` (string; optional) — Optional keyword filter.<br>`--fields` (json; optional) — Optional result field projection JSON array.<br>`--limit` (number; optional) — Optional inline result limit.<br>`--offset` (number; optional) — Optional zero-based result offset.<br>`--zone-offset` (number; optional) — Dashboard locked time zone offset. | [project_mark_time_list.md](project_mark_time_list.md) |
-| `ae-cli analysis project mark-time update` | project.mark_time.update | write | `--project-id` (number; required) — Numeric project ID.<br>`--mark-time-id` (number; required) — Date marker ID.<br>`--marked-at` (string; required) — Marker timestamp, for example yyyy-MM-dd HH:mm.<br>`--zone-offset` (number; optional) — Marker time zone offset.<br>`--content` (string; required) — Marker content.<br>`--is-visible` (number; optional) — Whether the marker is visible. 1 visible, 0 hidden. | [project_mark_time_update.md](project_mark_time_update.md) |
-| `ae-cli analysis project member add` | project.member.add | write | `--project-id` (number; required) — Numeric project ID.<br>`--payload` (json; required) — Required snake_case capability payload. Read the dedicated command reference for its semantic shape; an empty object is not a generic valid payload.<br>`--type` (string; required) — Add type accepted by ProjMemberAddTypeEnum. | [project_member_add.md](project_member_add.md) |
-| `ae-cli analysis project member batch-update` | project.member.batch_update | write | `--project-id` (number; required) — Numeric project ID.<br>`--payload` (json; required) — Required snake_case capability payload. Read the dedicated command reference for its semantic shape; an empty object is not a generic valid payload. | [project_member_batch_update.md](project_member_batch_update.md) |
-| `ae-cli analysis project member import` | project.member.import | high-risk-write | `--project-id` (number; required) — Numeric project ID.<br>`--source-project-id` (number; required) — Project ID to import members from. | [project_member_import.md](project_member_import.md) |
-| `ae-cli analysis project member list` | project.member.list | read | `--project-id` (number; required) — Numeric project ID. | [project_member_list.md](project_member_list.md) |
-| `ae-cli analysis project member remove` | project.member.remove | high-risk-write | `--project-id` (number; required) — Numeric project ID.<br>`--payload` (json; required) — Required snake_case capability payload. Read the dedicated command reference for its semantic shape; an empty object is not a generic valid payload.<br>`--from-open-id` (string; required) — Open ID of the member to remove. | [project_member_remove.md](project_member_remove.md) |
-| `ae-cli analysis project member update` | project.member.update | write | `--project-id` (number; required) — Numeric project ID.<br>`--payload` (json; required) — Required snake_case capability payload. Read the dedicated command reference for its semantic shape; an empty object is not a generic valid payload.<br>`--target-user-id` (number; required) — Target user ID. | [project_member_update.md](project_member_update.md) |
-| `ae-cli analysis project member-candidate list` | project.member_candidate.list | read | `--project-id` (number; required) — Numeric project ID.<br>`--type` (string; required) — Add type accepted by ProjMemberAddTypeEnum.<br>`--login-names` (string; optional) — Comma-separated login names when checking new users. | [project_member_candidate_list.md](project_member_candidate_list.md) |
-| `ae-cli analysis project member-handover export` | project.member_handover.export | high-risk-write | `--project-id` (number; required) — Numeric project ID.<br>`--payload` (json; required) — Required snake_case capability payload. Read the dedicated command reference for its semantic shape; an empty object is not a generic valid payload.<br>`--request-id` (string; optional) — Optional caller-supplied cli_<32 lowercase hex> lifecycle ID. ae-cli generates and prints one before dispatch when omitted. | [project_member_handover_export.md](project_member_handover_export.md) |
-| `ae-cli analysis project member-handover run` | project.member_handover.run | write | `--project-id` (number; required) — Numeric project ID.<br>`--payload` (json; required) — Required snake_case capability payload. Read the dedicated command reference for its semantic shape; an empty object is not a generic valid payload. | [project_member_handover_run.md](project_member_handover_run.md) |
-| `ae-cli analysis project member-receiver list` | project.member_receiver.list | read | `--project-id` (number; required) — Numeric project ID. | [project_member_receiver_list.md](project_member_receiver_list.md) |
-| `ae-cli analysis project owner update` | project.owner.update | write | `--project-id` (number; required) — Numeric project ID.<br>`--company-id` (number; required) — Company ID.<br>`--owner-user-id` (number; optional) — New owner user ID. Omit to only downgrade existing owner.<br>`--project-name` (string; optional) — Optional project name update.<br>`--project-remark` (string; optional) — Optional project remark update. | [project_owner_update.md](project_owner_update.md) |
-| `ae-cli analysis project permission-binding list` | project.permission_binding.list | read | `--project-id` (number; required) — Numeric project ID.<br>`--company-id` (number; required) — Company ID.<br>`--project-ids` (json; required) — Project IDs JSON array. | [project_permission_binding_list.md](project_permission_binding_list.md) |
-| `ae-cli analysis project receive-status update` | project.receive_status.update | high-risk-write | `--project-id` (number; required) — Numeric project ID.<br>`--receive-status` (string; required) — Receive status: NORMAL or STOP_RECEIVE. | [project_receive_status_update.md](project_receive_status_update.md) |
-| `ae-cli analysis project role delete` | project.role.delete | high-risk-write | `--project-id` (number; required) — Numeric project ID.<br>`--role-name` (string; required) — Role name to delete.<br>`--new-role-name` (string; optional) — Role name to migrate users to before deletion. | [project_role_delete.md](project_role_delete.md) |
-| `ae-cli analysis project role get` | project.role.get | read | `--project-id` (number; required) — Numeric project ID.<br>`--role-name` (string; required) — Role name. | [project_role_get.md](project_role_get.md) |
-| `ae-cli analysis project role list` | project.role.list | read | `--company-id` (number; optional) — Company ID. Required when project_id is absent.<br>`--project-id` (number; required) — Numeric project ID.<br>`--visible-only` (boolean; optional) — When true, list roles visible to the current user. | [project_role_list.md](project_role_list.md) |
-| `ae-cli analysis project role upsert` | project.role.upsert | write | `--project-id` (number; required) — Numeric project ID.<br>`--payload` (json; required) — Required snake_case capability payload. Read the dedicated command reference for its semantic shape; an empty object is not a generic valid payload. | [project_role_upsert.md](project_role_upsert.md) |
-| `ae-cli analysis project role-function list` | project.role_function.list | read | `--company-id` (number; optional) — Company ID.<br>`--project-id` (number; required) — Numeric project ID.<br>`--role-name` (string; optional) — Single role name.<br>`--role-names` (json; optional) — Role names JSON array. When omitted, all role functions are returned.<br>`--show-system-func` (boolean; optional) — Whether to include system functions. Default false. | [project_role_function_list.md](project_role_function_list.md) |
-| `ae-cli analysis project role-user list` | project.role_user.list | read | `--project-id` (number; required) — Numeric project ID.<br>`--role-name` (string; required) — Role name. | [project_role_user_list.md](project_role_user_list.md) |
-| `ae-cli analysis project timezone get` | project.timezone.get | read | `--project-id` (number; required) — Numeric project ID. | [project_timezone_get.md](project_timezone_get.md) |
-| `ae-cli analysis project timezone overview` | project.timezone.overview | read | `--project-id` (number; required) — Numeric project ID. | [project_timezone_overview.md](project_timezone_overview.md) |
-| `ae-cli analysis project timezone update` | project.timezone.update | write | `--project-id` (number; required) — Numeric project ID.<br>`--payload` (json; required) — Required snake_case capability payload. Read the dedicated command reference for its semantic shape; an empty object is not a generic valid payload.<br>`--item` (string; required) — Timezone item: timezone_toggle, zone_offset, user_timezone, project_timezone_display. | [project_timezone_update.md](project_timezone_update.md) |
-| `ae-cli analysis project user-id-items update` | project.user_id_items.update | write | `--project-id` (number; required) — Numeric project ID.<br>`--payload` (json; required) — Required snake_case capability payload. Read the dedicated command reference for its semantic shape; an empty object is not a generic valid payload. | [project_user_id_items_update.md](project_user_id_items_update.md) |
 | `ae-cli analysis project-space get` | analysis.project_space.get | read | `--project-id` (number; required) — Numeric project ID.<br>`--space-id` (number; required) — Project space ID.<br>`--fields` (json; optional) — Optional result field projection JSON array. | [project_space_get.md](project_space_get.md) |
 | `ae-cli analysis project-space list` | analysis.project_space.list | read | `--project-id` (number; required) — Numeric project ID.<br>`--query` (string; optional) — Optional keyword filter.<br>`--fields` (json; optional) — Optional result field projection JSON array.<br>`--limit` (number; optional, min=1, max=200) — Directory page size. Default: 50, max: 200. Values outside 1..200 are rejected.<br>`--offset` (number; optional) — Optional zero-based result offset. | [project_space_list.md](project_space_list.md) |
 | `ae-cli analysis public-link create` | analysis.public_link.create | write | `--project-id` (number; required) — Numeric project ID.<br>`--company-id` (number; optional) — Company ID. Derived from project ID when omitted.<br>`--resource-type` (string; required) — Resource type: dashboard or bi_panel.<br>`--resource-id` (number; required) — Target resource ID.<br>`--access-controls` (json; optional) — Public link access-control JSON.<br>`--remark` (string; optional) — Public link remark.<br>`--effective-at` (string; required) — Effective time, yyyy-MM-dd HH:mm:ss.<br>`--expires-at` (string; required) — Expiration time, yyyy-MM-dd HH:mm:ss.<br>`--payload` (json; optional) — Optional snake_case object for complex capability payload fields. | [public_link_create.md](public_link_create.md) |
@@ -233,12 +191,120 @@ This is the exhaustive command and flag inventory for the analysis skill. Read t
 | `ae-cli analysis-meta virtual-property create` | metadata.virtual_property.create | write | `--project-id` (number; required) — Numeric project ID.<br>`--sql-expression` (string; required) — SQL expression used to calculate the virtual property.<br>`--v-prop` (json; optional) — Virtual property JSON object with property.column_name/table_type/select_type fields.<br>`--property-name` (string; optional) — Virtual property name. Must start with '#vp@'.<br>`--property-desc` (string; optional) — Virtual property display name.<br>`--table-type` (string; optional) — Property table type: event or user.<br>`--select-type` (string; optional) — Property value type: string, number, bool, or datetime.<br>`--property-remark` (string; optional) — Optional virtual property remark.<br>`--properties` (json; optional) — Dependent property JSON array.<br>`--sql-event-relation-type` (string; optional) — relation_default, relation_always, or relation_by_setting.<br>`--related-events` (json; optional) — Related events JSON array when using relation_by_setting.<br>`--tag-date-policies` (json; optional) — Optional tag date policies JSON array.<br>`--replace-remark` (string; optional) — Replacement remark.<br>`--replace-suggestion` (string; optional) — Replacement suggestion. | [virtual_property_create.md](virtual_property_create.md) |
 | `ae-cli analysis-meta virtual-property sql-rule-delete` | metadata.virtual_property.sql_rule_delete | high-risk-write | `--project-id` (number; required) — Numeric project ID.<br>`--v-prop-id` (number; required) — Virtual property ID.<br>`--operation` (string; optional) — Delete operation. Use revoke to revoke instead of delete. | [virtual_property_sql_rule_delete.md](virtual_property_sql_rule_delete.md) |
 | `ae-cli analysis-meta virtual-property sql-rule-update` | metadata.virtual_property.sql_rule_update | write | `--project-id` (number; required) — Numeric project ID.<br>`--sql-expression` (string; required) — SQL expression used to calculate the virtual property.<br>`--v-prop` (json; required) — Virtual property JSON object with prop_id/property fields.<br>`--properties` (json; optional) — Dependent property JSON array.<br>`--sql-event-relation-type` (string; optional) — relation_default, relation_always, or relation_by_setting.<br>`--related-events` (json; optional) — Related events JSON array when using relation_by_setting.<br>`--tag-date-policies` (json; optional) — Optional tag date policies JSON array.<br>`--replace-remark` (string; optional) — Replacement remark.<br>`--replace-suggestion` (string; optional) — Replacement suggestion. | [virtual_property_sql_rule_update.md](virtual_property_sql_rule_update.md) |
+| `ae-cli project access-detail get` | project.access_detail.get | read | `--company-id` (number; required) — Company ID. | [project_access_detail_get.md](project_access_detail_get.md) |
+| `ae-cli project data-power delete` | project.data_power.delete | high-risk-write | `--project-id` (number; required) — Numeric project ID.<br>`--data-power-id` (number; required) — Data power ID to delete.<br>`--new-data-power-id` (number; optional) — Optional replacement data power ID for affected users. | [project_data_power_delete.md](project_data_power_delete.md) |
+| `ae-cli project data-power get` | project.data_power.get | read | `--project-id` (number; required) — Numeric project ID.<br>`--data-power-id` (number; required) — Data power ID. | [project_data_power_get.md](project_data_power_get.md) |
+| `ae-cli project data-power list` | project.data_power.list | read | `--project-id` (number; required) — Numeric project ID. | [project_data_power_list.md](project_data_power_list.md) |
+| `ae-cli project data-power upsert` | project.data_power.upsert | write | `--project-id` (number; required) — Numeric project ID.<br>`--payload` (json; required) — Required snake_case capability payload. Read the dedicated command reference for its semantic shape; an empty object is not a generic valid payload. | [project_data_power_upsert.md](project_data_power_upsert.md) |
+| `ae-cli project entity create` | project.entity.create | write | `--project-id` (number; required) — Numeric project ID.<br>`--entity-name` (string; required) — Entity display name.<br>`--column-name` (string; required) — Property column name to bind.<br>`--table-type` (number; required) — Main table type: 0 for event property, 1 for user property.<br>`--order` (number; optional) — Optional entity display order. | [project_entity_create.md](project_entity_create.md) |
+| `ae-cli project entity delete` | project.entity.delete | high-risk-write | `--project-id` (number; required) — Numeric project ID.<br>`--entity-id` (number; required) — Analysis entity ID. | [project_entity_delete.md](project_entity_delete.md) |
+| `ae-cli project entity get` | project.entity.get | read | `--project-id` (number; required) — Numeric project ID.<br>`--entity-id` (number; required) — Analysis entity ID. | [project_entity_get.md](project_entity_get.md) |
+| `ae-cli project entity list` | project.entity.list | read | `--project-id` (number; required) — Numeric project ID.<br>`--query` (string; optional) — Optional keyword filter.<br>`--fields` (json; optional) — Optional result field projection JSON array.<br>`--limit` (number; optional) — Optional inline result limit.<br>`--offset` (number; optional) — Optional zero-based result offset.<br>`--event-name` (string; optional) — Optional event name. When present, return entities related to the event. | [project_entity_list.md](project_entity_list.md) |
+| `ae-cli project entity update` | project.entity.update | write | `--project-id` (number; required) — Numeric project ID.<br>`--entity-id` (number; required) — Analysis entity ID.<br>`--entity-name` (string; required) — Entity display name.<br>`--column-name` (string; required) — Property column name to bind.<br>`--table-type` (number; required) — Main table type: 0 for event property, 1 for user property.<br>`--order` (number; optional) — Optional entity display order. | [project_entity_update.md](project_entity_update.md) |
+| `ae-cli project entity-event list` | project.entity_event.list | read | `--project-id` (number; required) — Numeric project ID.<br>`--event-names` (json; optional) — Optional event names JSON array to resolve entity mappings for. | [project_entity_event_list.md](project_entity_event_list.md) |
+| `ae-cli project function list` | project.function.list | read | `--company-id` (number; optional) — Company ID.<br>`--project-id` (number; required) — Numeric project ID. | [project_function_list.md](project_function_list.md) |
+| `ae-cli project info create` | project.info.create | write | `--company-id` (number; required, min=1) — Company ID.<br>`--project-name` (string; required, minLength=1, maxLength=80) — Project name.<br>`--load-history` (boolean; optional) — Load historical data. Default: false.<br>`--owner-user-id` (number; optional, min=1) — Optional owner user ID.<br>`--project-remark` (string; optional, maxLength=200) — Optional project remark. | [project_info_create.md](project_info_create.md) |
+| `ae-cli project info delete` | project.info.delete | high-risk-write | `--project-id` (number; required) — Numeric project ID. | [project_info_delete.md](project_info_delete.md) |
+| `ae-cli project info get` | project.info.get | read | `--project-id` (number; required) — Numeric project ID. | [project_info_get.md](project_info_get.md) |
+| `ae-cli project info list` | project.info.list | read | `--query` (string; optional) — Optional keyword filter.<br>`--fields` (json; optional) — Optional result field projection JSON array.<br>`--limit` (number; optional) — Optional inline result limit.<br>`--offset` (number; optional) — Optional zero-based result offset. | [project_info_list.md](project_info_list.md) |
+| `ae-cli project info update` | project.info.update | write | `--project-id` (number; required) — Numeric project ID.<br>`--project-name` (string; required) — New project name.<br>`--project-remark` (string; optional) — Optional project remark. | [project_info_update.md](project_info_update.md) |
+| `ae-cli project mark-time create` | project.mark_time.create | write | `--project-id` (number; required) — Numeric project ID.<br>`--marked-at` (string; required) — Marker timestamp, for example yyyy-MM-dd HH:mm.<br>`--zone-offset` (number; optional) — Marker time zone offset.<br>`--content` (string; required) — Marker content.<br>`--is-visible` (number; optional) — Whether the marker is visible. 1 visible, 0 hidden. | [project_mark_time_create.md](project_mark_time_create.md) |
+| `ae-cli project mark-time delete` | project.mark_time.delete | high-risk-write | `--project-id` (number; required) — Numeric project ID.<br>`--mark-time-ids` (json; required) — Date marker IDs JSON array to delete. | [project_mark_time_delete.md](project_mark_time_delete.md) |
+| `ae-cli project mark-time list` | project.mark_time.list | read | `--project-id` (number; required) — Numeric project ID.<br>`--query` (string; optional) — Optional keyword filter.<br>`--fields` (json; optional) — Optional result field projection JSON array.<br>`--limit` (number; optional) — Optional inline result limit.<br>`--offset` (number; optional) — Optional zero-based result offset.<br>`--zone-offset` (number; optional) — Dashboard locked time zone offset. | [project_mark_time_list.md](project_mark_time_list.md) |
+| `ae-cli project mark-time update` | project.mark_time.update | write | `--project-id` (number; required) — Numeric project ID.<br>`--mark-time-id` (number; required) — Date marker ID.<br>`--marked-at` (string; required) — Marker timestamp, for example yyyy-MM-dd HH:mm.<br>`--zone-offset` (number; optional) — Marker time zone offset.<br>`--content` (string; required) — Marker content.<br>`--is-visible` (number; optional) — Whether the marker is visible. 1 visible, 0 hidden. | [project_mark_time_update.md](project_mark_time_update.md) |
+| `ae-cli project member add` | project.member.add | write | `--project-id` (number; required) — Numeric project ID.<br>`--payload` (json; required) — Required snake_case capability payload. Read the dedicated command reference for its semantic shape; an empty object is not a generic valid payload.<br>`--type` (string; required) — Add type accepted by ProjMemberAddTypeEnum. | [project_member_add.md](project_member_add.md) |
+| `ae-cli project member batch-update` | project.member.batch_update | write | `--project-id` (number; required) — Numeric project ID.<br>`--payload` (json; required) — Required snake_case capability payload. Read the dedicated command reference for its semantic shape; an empty object is not a generic valid payload. | [project_member_batch_update.md](project_member_batch_update.md) |
+| `ae-cli project member import` | project.member.import | high-risk-write | `--project-id` (number; required) — Numeric project ID.<br>`--source-project-id` (number; required) — Project ID to import members from. | [project_member_import.md](project_member_import.md) |
+| `ae-cli project member list` | project.member.list | read | `--project-id` (number; required) — Numeric project ID. | [project_member_list.md](project_member_list.md) |
+| `ae-cli project member remove` | project.member.remove | high-risk-write | `--project-id` (number; required) — Numeric project ID.<br>`--payload` (json; required) — Required snake_case capability payload. Read the dedicated command reference for its semantic shape; an empty object is not a generic valid payload.<br>`--from-open-id` (string; required) — Open ID of the member to remove. | [project_member_remove.md](project_member_remove.md) |
+| `ae-cli project member update` | project.member.update | write | `--project-id` (number; required) — Numeric project ID.<br>`--payload` (json; required) — Required snake_case capability payload. Read the dedicated command reference for its semantic shape; an empty object is not a generic valid payload.<br>`--target-user-id` (number; required) — Target user ID. | [project_member_update.md](project_member_update.md) |
+| `ae-cli project member-candidate list` | project.member_candidate.list | read | `--project-id` (number; required) — Numeric project ID.<br>`--type` (string; required) — Add type accepted by ProjMemberAddTypeEnum.<br>`--login-names` (string; optional) — Comma-separated login names when checking new users. | [project_member_candidate_list.md](project_member_candidate_list.md) |
+| `ae-cli project member-handover export` | project.member_handover.export | high-risk-write | `--project-id` (number; required) — Numeric project ID.<br>`--payload` (json; required) — Required snake_case capability payload. Read the dedicated command reference for its semantic shape; an empty object is not a generic valid payload.<br>`--request-id` (string; optional) — Optional caller-supplied cli_<32 lowercase hex> lifecycle ID. ae-cli generates and prints one before dispatch when omitted. | [project_member_handover_export.md](project_member_handover_export.md) |
+| `ae-cli project member-handover run` | project.member_handover.run | write | `--project-id` (number; required) — Numeric project ID.<br>`--payload` (json; required) — Required snake_case capability payload. Read the dedicated command reference for its semantic shape; an empty object is not a generic valid payload. | [project_member_handover_run.md](project_member_handover_run.md) |
+| `ae-cli project member-receiver list` | project.member_receiver.list | read | `--project-id` (number; required) — Numeric project ID. | [project_member_receiver_list.md](project_member_receiver_list.md) |
+| `ae-cli project owner update` | project.owner.update | write | `--project-id` (number; required) — Numeric project ID.<br>`--company-id` (number; required) — Company ID.<br>`--owner-user-id` (number; optional) — New owner user ID. Omit to only downgrade existing owner.<br>`--project-name` (string; optional) — Optional project name update.<br>`--project-remark` (string; optional) — Optional project remark update. | [project_owner_update.md](project_owner_update.md) |
+| `ae-cli project permission-binding list` | project.permission_binding.list | read | `--project-id` (number; required) — Numeric project ID.<br>`--company-id` (number; required) — Company ID.<br>`--project-ids` (json; required) — Project IDs JSON array. | [project_permission_binding_list.md](project_permission_binding_list.md) |
+| `ae-cli project receive-status update` | project.receive_status.update | high-risk-write | `--project-id` (number; required) — Numeric project ID.<br>`--receive-status` (string; required) — Receive status: NORMAL or STOP_RECEIVE. | [project_receive_status_update.md](project_receive_status_update.md) |
+| `ae-cli project role delete` | project.role.delete | high-risk-write | `--project-id` (number; required) — Numeric project ID.<br>`--role-name` (string; required) — Role name to delete.<br>`--new-role-name` (string; optional) — Role name to migrate users to before deletion. | [project_role_delete.md](project_role_delete.md) |
+| `ae-cli project role get` | project.role.get | read | `--project-id` (number; required) — Numeric project ID.<br>`--role-name` (string; required) — Role name. | [project_role_get.md](project_role_get.md) |
+| `ae-cli project role list` | project.role.list | read | `--company-id` (number; optional) — Company ID. Required when project_id is absent.<br>`--project-id` (number; required) — Numeric project ID.<br>`--visible-only` (boolean; optional) — When true, list roles visible to the current user. | [project_role_list.md](project_role_list.md) |
+| `ae-cli project role upsert` | project.role.upsert | write | `--project-id` (number; required) — Numeric project ID.<br>`--payload` (json; required) — Required snake_case capability payload. Read the dedicated command reference for its semantic shape; an empty object is not a generic valid payload. | [project_role_upsert.md](project_role_upsert.md) |
+| `ae-cli project role-function list` | project.role_function.list | read | `--company-id` (number; optional) — Company ID.<br>`--project-id` (number; required) — Numeric project ID.<br>`--role-name` (string; optional) — Single role name.<br>`--role-names` (json; optional) — Role names JSON array. When omitted, all role functions are returned.<br>`--show-system-func` (boolean; optional) — Whether to include system functions. Default false. | [project_role_function_list.md](project_role_function_list.md) |
+| `ae-cli project role-user list` | project.role_user.list | read | `--project-id` (number; required) — Numeric project ID.<br>`--role-name` (string; required) — Role name. | [project_role_user_list.md](project_role_user_list.md) |
+| `ae-cli project timezone get` | project.timezone.get | read | `--project-id` (number; required) — Numeric project ID. | [project_timezone_get.md](project_timezone_get.md) |
+| `ae-cli project timezone overview` | project.timezone.overview | read | `--project-id` (number; required) — Numeric project ID. | [project_timezone_overview.md](project_timezone_overview.md) |
+| `ae-cli project timezone update` | project.timezone.update | write | `--project-id` (number; required) — Numeric project ID.<br>`--payload` (json; required) — Required snake_case capability payload. Read the dedicated command reference for its semantic shape; an empty object is not a generic valid payload.<br>`--item` (string; required) — Timezone item: timezone_toggle, zone_offset, user_timezone, project_timezone_display. | [project_timezone_update.md](project_timezone_update.md) |
+| `ae-cli project user-id-items update` | project.user_id_items.update | write | `--project-id` (number; required) — Numeric project ID.<br>`--payload` (json; required) — Required snake_case capability payload. Read the dedicated command reference for its semantic shape; an empty object is not a generic valid payload. | [project_user_id_items_update.md](project_user_id_items_update.md) |
+| `ae-cli system admin list` | system.admin.list | read | `--company-id` (number; required, min=1) — Company ID. | [system_admin_list.md](system_admin_list.md) |
+| `ae-cli system admin remove` | system.admin.remove | high-risk-write | `--company-id` (number; required, min=1) — Company ID.<br>`--target-open-id` (string; required) — Target member open ID. | [system_admin_remove.md](system_admin_remove.md) |
+| `ae-cli system admin upsert` | system.admin.upsert | high-risk-write | `--company-id` (number; required, min=1) — Company ID.<br>`--admins` (json; required) — Administrator array with target_user_id and function_names. | [system_admin_upsert.md](system_admin_upsert.md) |
+| `ae-cli system admin-function list` | system.admin_function.list | read | `--company-id` (number; required, min=1) — Company ID.<br>`--target-open-id` (string; required) — Target member open ID. | [system_admin_function_list.md](system_admin_function_list.md) |
+| `ae-cli system admin-function update` | system.admin_function.update | high-risk-write | `--company-id` (number; required, min=1) — Company ID.<br>`--target-open-id` (string; required) — Target member open ID.<br>`--function-names` (json; required) — Complete function-name JSON array. | [system_admin_function_update.md](system_admin_function_update.md) |
+| `ae-cli system function list` | system.function.list | read | `--company-id` (number; required, min=1) — Company ID. | [system_function_list.md](system_function_list.md) |
+| `ae-cli system member add` | system.member.add | write | `--company-id` (number; required, min=1) — Company ID.<br>`--members` (json; required) — Member array with login_name and user_name. | [system_member_add.md](system_member_add.md) |
+| `ae-cli system member delete` | system.member.delete | high-risk-write | `--company-id` (number; required, min=1) — Company ID.<br>`--target-user-id` (number; required, min=1) — Target member user ID. | [system_member_delete.md](system_member_delete.md) |
+| `ae-cli system member list` | system.member.list | read | `--company-id` (number; required, min=1) — Company ID.<br>`--query` (string; optional) — Optional keyword filter.<br>`--limit` (number; optional, min=1, max=200) — Page size. Default and maximum depend on the capability schema.<br>`--offset` (number; optional, min=0) — Zero-based result offset. | [system_member_list.md](system_member_list.md) |
+| `ae-cli system member update` | system.member.update | write | `--company-id` (number; required, min=1) — Company ID.<br>`--target-open-id` (string; required) — Target member open ID.<br>`--user-name` (string; required) — New display name. | [system_member_update.md](system_member_update.md) |
+| `ae-cli system member-candidate list` | system.member_candidate.list | read | `--company-id` (number; required, min=1) — Company ID.<br>`--login-names` (json; required) — Login-name JSON array. | [system_member_candidate_list.md](system_member_candidate_list.md) |
+| `ae-cli system member-mfa unbind` | system.member_mfa.unbind | high-risk-write | `--company-id` (number; required, min=1) — Company ID.<br>`--login-name` (string; required) — Target member login name. | [system_member_mfa_unbind.md](system_member_mfa_unbind.md) |
+| `ae-cli system member-password reset` | system.member_password.reset | high-risk-write | `--company-id` (number; required, min=1) — Company ID.<br>`--target-user-id` (number; required, min=1) — Target member user ID.<br>`--password-file` (string; optional) — New member password. Read from a local permission-protected file; the value is never accepted directly on argv. One of --password-file or --password-stdin is required.<br>`--password-stdin` (boolean; optional) — New member password. Read from stdin; do not combine with --password-file. One of --password-file or --password-stdin is required. | [system_member_password_reset.md](system_member_password_reset.md) |
+| `ae-cli system member-project batch-update` | system.member_project.batch_update | high-risk-write | `--company-id` (number; required, min=1) — Company ID.<br>`--target-open-id` (string; required) — Target member open ID.<br>`--project-updates` (json; optional) — Project update array: project_id, role_names, and optional data_power_id.<br>`--project-removals` (json; optional) — Project removal and handover array. | [system_member_project_batch_update.md](system_member_project_batch_update.md) |
+| `ae-cli system member-status update` | system.member_status.update | high-risk-write | `--company-id` (number; required, min=1) — Company ID.<br>`--target-open-id` (string; required) — Target member open ID.<br>`--status` (string; required) — Target status. | [system_member_status_update.md](system_member_status_update.md) |
+| `ae-cli system mfa get` | system.mfa.get | read | `--company-id` (number; required, min=1) — Company ID. | [system_mfa_get.md](system_mfa_get.md) |
+| `ae-cli system mfa update` | system.mfa.update | high-risk-write | `--company-id` (number; required, min=1) — Company ID.<br>`--enabled` (boolean; required) — Target MFA enforcement state. | [system_mfa_update.md](system_mfa_update.md) |
+| `ae-cli system node-monitor list` | system.node_monitor.list | read | `--company-id` (number; required, min=1) — Company ID.<br>`--limit` (number; optional, min=1, max=200) — Page size. Default: 50, max: 200.<br>`--offset` (number; optional, min=0) — Zero-based result offset.<br>`--fields` (json; optional) — Optional snake_case result field projection JSON array. | [system_node_monitor_list.md](system_node_monitor_list.md) |
+| `ae-cli system oauth2 update` | system.oauth2.update | write | `--company-id` (number; required, min=1) — Company ID.<br>`--enable-oauth2` (boolean; required) — Target OAuth2 login state. | [system_oauth2_update.md](system_oauth2_update.md) |
+| `ae-cli system ops-alert-contact delete` | system.ops_alert_contact.delete | high-risk-write | `--company-id` (number; required, min=1) — Company ID.<br>`--contact-id` (number; required, min=1) — Contact ID to delete. | [system_ops_alert_contact_delete.md](system_ops_alert_contact_delete.md) |
+| `ae-cli system ops-alert-contact list` | system.ops_alert_contact.list | read | `--company-id` (number; required, min=1) — Company ID.<br>`--limit` (number; optional, min=1, max=200) — Page size. Default: 50, max: 200.<br>`--offset` (number; optional, min=0) — Zero-based result offset. | [system_ops_alert_contact_list.md](system_ops_alert_contact_list.md) |
+| `ae-cli system ops-alert-contact test` | system.ops_alert_contact.test | write | `--company-id` (number; required, min=1) — Company ID.<br>`--channel` (string; required) — Test channel.<br>`--target-file` (string; optional) — Sensitive test destination. Read from a local permission-protected file; the value is never accepted directly on argv. One of --target-file or --target-stdin is required.<br>`--target-stdin` (boolean; optional) — Sensitive test destination. Read from stdin; do not combine with --target-file. One of --target-file or --target-stdin is required. | [system_ops_alert_contact_test.md](system_ops_alert_contact_test.md) |
+| `ae-cli system ops-alert-contact upsert` | system.ops_alert_contact.upsert | write | `--company-id` (number; required, min=1) — Company ID.<br>`--contact-id` (number; optional, min=1) — Existing contact ID; omit to create.<br>`--name` (string; optional) — Contact name.<br>`--mail-address` (string; optional) — Email delivery target.<br>`--mobile` (string; optional) — Mobile delivery target.<br>`--on-status` (number; optional) — Enable state: 0 or 1; required on create.<br>`--dingding-webhook-file` (string; optional) — DingTalk webhook. Read from a local permission-protected file; the value is never accepted directly on argv.<br>`--dingding-webhook-stdin` (boolean; optional) — DingTalk webhook. Read from stdin; do not combine with --dingding-webhook-file.<br>`--wechat-webhook-file` (string; optional) — WeCom webhook. Read from a local permission-protected file; the value is never accepted directly on argv.<br>`--wechat-webhook-stdin` (boolean; optional) — WeCom webhook. Read from stdin; do not combine with --wechat-webhook-file.<br>`--feishu-webhook-file` (string; optional) — Feishu webhook. Read from a local permission-protected file; the value is never accepted directly on argv.<br>`--feishu-webhook-stdin` (boolean; optional) — Feishu webhook. Read from stdin; do not combine with --feishu-webhook-file.<br>`--slack-webhook-file` (string; optional) — Slack webhook. Read from a local permission-protected file; the value is never accepted directly on argv.<br>`--slack-webhook-stdin` (boolean; optional) — Slack webhook. Read from stdin; do not combine with --slack-webhook-file.<br>`--kim-webhook-file` (string; optional) — KIM webhook. Read from a local permission-protected file; the value is never accepted directly on argv.<br>`--kim-webhook-stdin` (boolean; optional) — KIM webhook. Read from stdin; do not combine with --kim-webhook-file. | [system_ops_alert_contact_upsert.md](system_ops_alert_contact_upsert.md) |
+| `ae-cli system preference get` | system.preference.get | read | `--company-id` (number; required, min=1) — Company ID. | [system_preference_get.md](system_preference_get.md) |
+| `ae-cli system preference update` | system.preference.update | write | `--company-id` (number; required, min=1) — Company ID.<br>`--navigation-permission-hide` (boolean; required) — Hide navigation entries without permission. | [system_preference_update.md](system_preference_update.md) |
+| `ae-cli system project-usage list` | system.project_usage.list | read | `--company-id` (number; required, min=1) — Company ID.<br>`--start-time` (string; required) — Inclusive ISO date/time lower bound.<br>`--end-time` (string; required) — Inclusive ISO date/time upper bound.<br>`--fields` (json; optional) — Optional snake_case result field projection JSON array.<br>`--limit` (number; optional, min=1, max=200) — Page size. Default and maximum depend on the capability schema.<br>`--offset` (number; optional, min=0) — Zero-based result offset.<br>`--sort-by` (string; optional) — Sort field.<br>`--sort-order` (string; optional) — Sort direction. | [system_project_usage_list.md](system_project_usage_list.md) |
+| `ae-cli system query-alert-rule list` | system.query_alert_rule.list | read | `--company-id` (number; required, min=1) — Company ID. | [system_query_alert_rule_list.md](system_query_alert_rule_list.md) |
+| `ae-cli system query-alert-rule update` | system.query_alert_rule.update | high-risk-write | `--company-id` (number; required, min=1) — Company ID.<br>`--upserts` (json; optional) — Rule upsert JSON array.<br>`--delete-ids` (json; optional) — Positive rule-ID JSON array to delete. | [system_query_alert_rule_update.md](system_query_alert_rule_update.md) |
+| `ae-cli system query-monitor overview` | system.query_monitor.overview | read | `--company-id` (number; required, min=1) — Company ID.<br>`--duration-minutes` (number; optional, min=1, max=1440) — Monitoring duration in minutes. Default: 60.<br>`--project-ids` (json; optional) — Project ID JSON array.<br>`--space-codes` (json; optional) — Project space-code JSON array.<br>`--cluster-names` (json; required) — Query cluster-name JSON array.<br>`--point-interval-seconds` (number; optional, min=5, max=300) — Chart sample interval seconds. Default: 5. | [system_query_monitor_overview.md](system_query_monitor_overview.md) |
+| `ae-cli system query-task cancel` | system.query_task.cancel | high-risk-write | `--company-id` (number; required, min=1) — Company ID.<br>`--task-id` (string; required) — Query-monitor task ID, not a CLI run_id. | [system_query_task_cancel.md](system_query_task_cancel.md) |
+| `ae-cli system query-task export` | system.query_task.export | read | `--company-id` (number; required, min=1) — Company ID.<br>`--start-time` (string; required, pattern=^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}$) — Inclusive query range start, yyyy-MM-dd HH:mm:ss.<br>`--end-time` (string; required, pattern=^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}$) — Inclusive query range end, yyyy-MM-dd HH:mm:ss.<br>`--project-ids` (json; optional) — Project ID JSON array.<br>`--space-codes` (json; optional) — Project space-code JSON array.<br>`--status-codes` (json; required) — Task status-code JSON array.<br>`--content-codes` (json; required) — Query content-code JSON array.<br>`--task-type-codes` (json; required) — Query task-type-code JSON array.<br>`--cluster-names` (json; optional) — Optional cluster-name JSON array.<br>`--download-columns` (json; optional) — Optional CSV column JSON array.<br>`--request-id` (string; optional, pattern=^cli_[0-9a-f]{32}$) — Optional caller-supplied cli_<32 lowercase hex> lifecycle ID; ae-cli generates one before dispatch when omitted.<br>`--timeout-seconds` (number; optional, min=1, max=21600) — Maximum export runtime in seconds. Default and max: 21600. | [system_query_task_export.md](system_query_task_export.md) |
+| `ae-cli system query-task get` | system.query_task.get | read | `--company-id` (number; required, min=1) — Company ID.<br>`--task-id` (string; required) — Query-monitor task ID.<br>`--sql-max-chars` (number; optional, min=0, max=100000) — Maximum returned SQL characters. | [system_query_task_get.md](system_query_task_get.md) |
+| `ae-cli system query-task list` | system.query_task.list | read | `--company-id` (number; required, min=1) — Company ID.<br>`--start-time` (string; required, pattern=^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}$) — Inclusive query range start, yyyy-MM-dd HH:mm:ss.<br>`--end-time` (string; required, pattern=^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}$) — Inclusive query range end, yyyy-MM-dd HH:mm:ss.<br>`--project-ids` (json; optional) — Project ID JSON array.<br>`--space-codes` (json; optional) — Project space-code JSON array.<br>`--status-codes` (json; required) — Task status-code JSON array.<br>`--content-codes` (json; required) — Query content-code JSON array.<br>`--task-type-codes` (json; required) — Query task-type-code JSON array.<br>`--cluster-names` (json; optional) — Optional cluster-name JSON array.<br>`--limit` (number; optional, min=1, max=1000) — Maximum returned tasks. Default: 100, max: 1000.<br>`--offset` (number; optional, min=0) — Zero-based result offset.<br>`--fields` (json; optional) — Optional snake_case result field projection JSON array. | [system_query_task_list.md](system_query_task_list.md) |
+| `ae-cli system query-task options` | system.query_task.options | read | `--company-id` (number; required, min=1) — Company ID. | [system_query_task_options.md](system_query_task_options.md) |
+| `ae-cli system receiver-address delete` | system.receiver_address.delete | high-risk-write | `--company-id` (number; required, min=1) — Company ID.<br>`--address-url` (string; required) — Receiver address URL.<br>`--address-type` (string; required) — Receiver address type. | [system_receiver_address_delete.md](system_receiver_address_delete.md) |
+| `ae-cli system receiver-address overview` | system.receiver_address.overview | read | `--company-id` (number; required, min=1) — Company ID. | [system_receiver_address_overview.md](system_receiver_address_overview.md) |
+| `ae-cli system receiver-address project-list` | system.receiver_address.project_list | read | `--company-id` (number; required, min=1) — Company ID. | [system_receiver_address_project_list.md](system_receiver_address_project_list.md) |
+| `ae-cli system receiver-address promote` | system.receiver_address.promote | write | `--company-id` (number; required, min=1) — Company ID.<br>`--address-url` (string; required) — Receiver address URL.<br>`--address-type` (string; required) — Receiver address type.<br>`--remove-project-custom` (boolean; optional) — Remove matching project overrides after promotion. | [system_receiver_address_promote.md](system_receiver_address_promote.md) |
+| `ae-cli system receiver-address upsert` | system.receiver_address.upsert | write | `--company-id` (number; required, min=1) — Company ID.<br>`--scope` (string; required) — Receiver scope.<br>`--address-url` (string; required) — Receiver address URL.<br>`--address-type` (string; required) — Receiver address type.<br>`--project-ids` (json; optional) — Project ID JSON array; required for project scope.<br>`--original-address-url` (string; optional) — Original URL when changing an existing address.<br>`--original-address-type` (string; optional) — Original address type. | [system_receiver_address_upsert.md](system_receiver_address_upsert.md) |
+| `ae-cli system receiver-detection get` | system.receiver_detection.get | read | `--company-id` (number; required, min=1) — Company ID.<br>`--address-url` (string; required) — Receiver address URL. | [system_receiver_detection_get.md](system_receiver_detection_get.md) |
+| `ae-cli system receiver-detection run` | system.receiver_detection.run | write | `--company-id` (number; required, min=1) — Company ID.<br>`--address-url` (string; required) — Receiver address URL. | [system_receiver_detection_run.md](system_receiver_detection_run.md) |
+| `ae-cli system receiver-detection update` | system.receiver_detection.update | write | `--company-id` (number; required, min=1) — Company ID.<br>`--address-url` (string; required) — Receiver address URL.<br>`--execute-type` (string; required) — Detection execution scope.<br>`--schedule-type` (string; required) — Detection schedule.<br>`--allow-notification` (boolean; required) — Allow detection notifications. | [system_receiver_detection_update.md](system_receiver_detection_update.md) |
+| `ae-cli system role delete` | system.role.delete | high-risk-write | `--company-id` (number; required, min=1) — Company ID.<br>`--role-name` (string; required) — Role name.<br>`--new-role-name` (string; optional) — Replacement role for affected users. | [system_role_delete.md](system_role_delete.md) |
+| `ae-cli system role get` | system.role.get | read | `--company-id` (number; required, min=1) — Company ID.<br>`--role-name` (string; required) — Role name. | [system_role_get.md](system_role_get.md) |
+| `ae-cli system role list` | system.role.list | read | `--company-id` (number; required, min=1) — Company ID.<br>`--query` (string; optional) — Optional keyword filter.<br>`--limit` (number; optional, min=1, max=200) — Page size. Default and maximum depend on the capability schema.<br>`--offset` (number; optional, min=0) — Zero-based result offset. | [system_role_list.md](system_role_list.md) |
+| `ae-cli system role upsert` | system.role.upsert | high-risk-write | `--company-id` (number; required, min=1) — Company ID.<br>`--role-name` (string; optional) — Existing role name for update; omit when creating.<br>`--role-desc` (string; required) — Role description.<br>`--function-names` (json; required) — Complete function-name JSON array. | [system_role_upsert.md](system_role_upsert.md) |
+| `ae-cli system role-function list` | system.role_function.list | read | `--company-id` (number; required, min=1) — Company ID.<br>`--role-name` (string; required) — Role name. | [system_role_function_list.md](system_role_function_list.md) |
+| `ae-cli system role-user list` | system.role_user.list | read | `--company-id` (number; required, min=1) — Company ID.<br>`--role-name` (string; required) — Role name. | [system_role_user_list.md](system_role_user_list.md) |
+| `ae-cli system seat list` | system.seat.list | read | `--company-id` (number; required, min=1) — Company ID.<br>`--query` (string; optional) — Optional keyword filter.<br>`--limit` (number; optional, min=1, max=200) — Page size. Default and maximum depend on the capability schema.<br>`--offset` (number; optional, min=0) — Zero-based result offset.<br>`--seat-type` (string; optional) — Optional seat type. | [system_seat_list.md](system_seat_list.md) |
+| `ae-cli system seat update` | system.seat.update | high-risk-write | `--company-id` (number; required, min=1) — Company ID.<br>`--seat-type` (string; required) — Seat type; empty removes seats.<br>`--open-ids` (json; required) — Company member open-ID JSON array. | [system_seat_update.md](system_seat_update.md) |
+| `ae-cli system smtp delete` | system.smtp.delete | high-risk-write | `--company-id` (number; required, min=1) — Company ID. | [system_smtp_delete.md](system_smtp_delete.md) |
+| `ae-cli system smtp get` | system.smtp.get | read | `--company-id` (number; required, min=1) — Company ID. | [system_smtp_get.md](system_smtp_get.md) |
+| `ae-cli system smtp test` | system.smtp.test | write | `--company-id` (number; required, min=1) — Company ID.<br>`--receiver` (string; required) — Test email receiver. | [system_smtp_test.md](system_smtp_test.md) |
+| `ae-cli system smtp upsert` | system.smtp.upsert | write | `--company-id` (number; required, min=1) — Company ID.<br>`--server-host` (string; required) — SMTP server host.<br>`--server-port` (number; required, min=1, max=65535) — SMTP server port.<br>`--has-encrypt` (number; optional) — Encryption mode: 0, 1, or 2.<br>`--sender-address` (string; required) — Sender email address.<br>`--sender-name` (string; required) — Sender display name.<br>`--subject-prefix` (string; optional) — Optional subject prefix.<br>`--password-file` (string; optional) — SMTP password. Read from a local permission-protected file; the value is never accepted directly on argv. One of --password-file or --password-stdin is required.<br>`--password-stdin` (boolean; optional) — SMTP password. Read from stdin; do not combine with --password-file. One of --password-file or --password-stdin is required. | [system_smtp_upsert.md](system_smtp_upsert.md) |
+| `ae-cli system third-party-login disable` | system.third_party_login.disable | high-risk-write | `--company-id` (number; required, min=1) — Company ID.<br>`--login-type` (string; required) — Third-party login type. | [system_third_party_login_disable.md](system_third_party_login_disable.md) |
+| `ae-cli system third-party-login list` | system.third_party_login.list | read | `--company-id` (number; required, min=1) — Company ID. | [system_third_party_login_list.md](system_third_party_login_list.md) |
+| `ae-cli system third-party-login upsert` | system.third_party_login.upsert | write | `--company-id` (number; required, min=1) — Company ID.<br>`--login-type` (string; required) — Third-party login type.<br>`--app-id` (string; required) — Provider application ID.<br>`--corp-id` (string; optional) — Provider corporation ID.<br>`--agent-id` (string; optional) — Provider agent ID.<br>`--dd-scan-app-id` (string; optional) — DingTalk scan-login application ID.<br>`--app-secret-file` (string; optional) — Provider application secret. Read from a local permission-protected file; the value is never accepted directly on argv. One of --app-secret-file or --app-secret-stdin is required.<br>`--app-secret-stdin` (boolean; optional) — Provider application secret. Read from stdin; do not combine with --app-secret-file. One of --app-secret-file or --app-secret-stdin is required.<br>`--dd-scan-app-secret-file` (string; optional) — DingTalk scan-login application secret. Read from a local permission-protected file; the value is never accepted directly on argv.<br>`--dd-scan-app-secret-stdin` (boolean; optional) — DingTalk scan-login application secret. Read from stdin; do not combine with --dd-scan-app-secret-file. | [system_third_party_login_upsert.md](system_third_party_login_upsert.md) |
+| `ae-cli system usage overview` | system.usage.overview | read | `--company-id` (number; required, min=1) — Company ID. | [system_usage_overview.md](system_usage_overview.md) |
+| `ae-cli system usage-trend export` | system.usage_trend.export | read | `--company-id` (number; required, min=1) — Company ID.<br>`--start-time` (string; required) — Inclusive ISO date/time lower bound.<br>`--end-time` (string; required) — Inclusive ISO date/time upper bound.<br>`--metric` (string; required) — Supported usage metric; apollo_token is not available.<br>`--time-granularity` (string; required) — Aggregation granularity.<br>`--scope` (string; optional) — Aggregation scope.<br>`--project-ids` (json; optional) — Project ID JSON array; required for project scope.<br>`--data-type` (string; optional) — Optional event-volume data type.<br>`--request-id` (string; optional, pattern=^cli_[0-9a-f]{32}$) — Optional caller-supplied cli_<32 lowercase hex> lifecycle ID; ae-cli generates one before dispatch when omitted.<br>`--timeout-seconds` (number; optional, min=1, max=21600) — Maximum export runtime in seconds. Default and max: 21600. | [system_usage_trend_export.md](system_usage_trend_export.md) |
+| `ae-cli system usage-trend query` | system.usage_trend.query | read | `--company-id` (number; required, min=1) — Company ID.<br>`--start-time` (string; required) — Inclusive ISO date/time lower bound.<br>`--end-time` (string; required) — Inclusive ISO date/time upper bound.<br>`--metric` (string; required) — Supported usage metric; apollo_token is not available.<br>`--time-granularity` (string; required) — Aggregation granularity.<br>`--scope` (string; optional) — Aggregation scope.<br>`--project-ids` (json; optional) — Project ID JSON array; required for project scope.<br>`--data-type` (string; optional) — Optional event-volume data type. | [system_usage_trend_query.md](system_usage_trend_query.md) |
 | `ae-cli tracking check delete` | tracking.check.delete | high-risk-write | `--project-id` (number; required) — Numeric project ID.<br>`--uuid` (string; required) — Tracking check task UUID.<br>`--confirm` (boolean; required) — Must be true for this destructive tracking operation. Also use global --yes to skip local confirmation. | [check_delete.md](check_delete.md) |
 | `ae-cli tracking check export` | tracking.check.export | read | `--project-id` (number; required) — Numeric project ID.<br>`--uuid` (string; required) — Tracking check task UUID.<br>`--request-id` (string; optional) — Optional caller-supplied cli_<32 lowercase hex> lifecycle ID. ae-cli generates and prints one before dispatch when omitted.<br>`--timeout-seconds` (number; optional, min=1, max=21600) — Async runtime in seconds. Default and max: 21600 (6 hours); cancel earlier with analysis query cancel --run-id <run_id>. | [check_export.md](check_export.md) |
 | `ae-cli tracking check get` | tracking.check.get | read | `--project-id` (number; required) — Numeric project ID.<br>`--uuid` (string; required) — Tracking check task UUID.<br>`--request-id` (string; optional) — Optional caller-supplied cli_<32 lowercase hex> lifecycle ID. ae-cli generates and prints one before dispatch when omitted.<br>`--timeout-seconds` (number; optional) — Optional capability execution timeout in seconds. | [check_get.md](check_get.md) |
 | `ae-cli tracking check list` | tracking.check.list | read | `--project-id` (number; required) — Numeric project ID. | [check_list.md](check_list.md) |
 | `ae-cli tracking check retry` | tracking.check.retry | write | `--project-id` (number; required) — Numeric project ID.<br>`--uuid` (string; required) — Tracking check task UUID.<br>`--request-id` (string; optional) — Optional caller-supplied cli_<32 lowercase hex> lifecycle ID. ae-cli generates and prints one before dispatch when omitted.<br>`--timeout-seconds` (number; optional) — Optional capability execution timeout in seconds. | [check_retry.md](check_retry.md) |
 | `ae-cli tracking check run` | tracking.check.run | write | `--project-id` (number; required) — Numeric project ID.<br>`--check-scope` (json; required) — Tracking check scope JSON object.<br>`--result-scope` (json; optional) — Optional tracking check result scope JSON object. | [check_run.md](check_run.md) |
+| `ae-cli tracking debug-data list` | tracking.debug_data.list | read | `--project-id` (number; required) — Numeric project ID.<br>`--device-id` (string; required) — Debug device ID reported by the SDK as #device_id.<br>`--start-time` (string; optional) — Query start time in YYYY-MM-DD HH:mm:ss local time. Defaults to one hour ago.<br>`--event-name` (string; optional) — Optional event name filter. | [debug_data_list.md](debug_data_list.md) |
+| `ae-cli tracking debug-device add` | tracking.debug_device.add | write | `--project-id` (number; required) — Numeric project ID.<br>`--device-id` (string; required) — Debug device ID reported by the SDK as #device_id.<br>`--device-name` (string; required) — Human-readable name for the Debug device. | [debug_device_add.md](debug_device_add.md) |
+| `ae-cli tracking debug-device list` | tracking.debug_device.list | read | `--project-id` (number; required) — Numeric project ID. | [debug_device_list.md](debug_device_list.md) |
+| `ae-cli tracking debug-device select` | tracking.debug_device.select | write | `--project-id` (number; required) — Numeric project ID.<br>`--device-id` (string; required) — Debug device ID reported by the SDK as #device_id. | [debug_device_select.md](debug_device_select.md) |
 | `ae-cli tracking event-blacklist add` | tracking.event_blacklist.add | write | `--project-id` (number; required) — Numeric project ID.<br>`--event-names` (json; required) — JSON array of event names. | [event_blacklist_add.md](event_blacklist_add.md) |
 | `ae-cli tracking event-blacklist list` | tracking.event_blacklist.list | read | `--project-id` (number; required) — Numeric project ID. | [event_blacklist_list.md](event_blacklist_list.md) |
 | `ae-cli tracking event-blacklist update` | tracking.event_blacklist.update | write | `--project-id` (number; required) — Numeric project ID.<br>`--event-names` (json; required) — JSON array of event names.<br>`--type` (number; required) — Blacklist event config type: 0 or 1. | [event_blacklist_update.md](event_blacklist_update.md) |
@@ -252,6 +318,7 @@ This is the exhaustive command and flag inventory for the analysis skill. Read t
 | `ae-cli tracking plan get` | tracking.plan.get | read | `--project-id` (number; required) — Numeric project ID. | [plan_get.md](plan_get.md) |
 | `ae-cli tracking plan import-excel` | tracking.plan.import_excel | write | `--project-id` (number; required) — Numeric project ID.<br>`--input-file` (string; optional) — Local tracking-plan XLSX path. The CLI uploads it with purpose track.program.xlsx before import.<br>`--input-file-id` (string; optional) — Existing input_file_id returned by `analysis input-file upload --purpose track.program.xlsx`.<br>`--lang` (string; optional) — Excel language: zh, en, ja, ko, zh_CN, en_US, ja_JP, or ko_KR. | [plan_import_excel.md](plan_import_excel.md) |
 | `ae-cli tracking plan save-items` | tracking.plan.save_items | write | `--project-id` (number; required) — Numeric project ID.<br>`--events` (json; optional) — Optional JSON array of tracking events.<br>`--event-props` (json; optional) — Optional JSON array of tracking event properties.<br>`--user-props` (json; optional) — Optional JSON array of tracking user properties.<br>`--common-event-props` (json; optional) — Optional JSON array of common tracking event properties. | [plan_save_items.md](plan_save_items.md) |
+| `ae-cli tracking plan sync-display-names` | gateway lifecycle | write | `--project-id` (number; required) — Numeric project ID.<br>`--draft` (string; required) — Local tracking-plan draft.json containing event/property display_name values. | [plan_sync_display_names.md](plan_sync_display_names.md) |
 | `ae-cli tracking plan sync-from-meta` | tracking.plan.sync_from_meta | write | `--project-id` (number; required) — Numeric project ID. | [plan_sync_from_meta.md](plan_sync_from_meta.md) |
 | `ae-cli tracking plan-change-log export` | tracking.plan_change_log.export | read | `--project-id` (number; required) — Numeric project ID.<br>`--log-id` (number; required) — Tracking plan change log ID.<br>`--request-id` (string; optional) — Optional caller-supplied cli_<32 lowercase hex> lifecycle ID. ae-cli generates and prints one before dispatch when omitted.<br>`--timeout-seconds` (number; optional, min=1, max=21600) — Async runtime in seconds. Default and max: 21600 (6 hours); cancel earlier with analysis query cancel --run-id <run_id>. | [plan_change_log_export.md](plan_change_log_export.md) |
 | `ae-cli tracking plan-change-log list` | tracking.plan_change_log.list | read | `--project-id` (number; required) — Numeric project ID. | [plan_change_log_list.md](plan_change_log_list.md) |

package/skills/ae-analysis/references/debug_data_list.md

@@ -0,0 +1,28 @@
+# tracking debug-data list
+
+Use this command to query Debug data received from one device and verify an SDK reporting flow.
+
+Command:
+
+```bash
+ae-cli tracking debug-data list \
+  --project-id <project_id> \
+  --device-id <device_id> \
+  --start-time "YYYY-MM-DD HH:mm:ss" \
+  [--event-name <event_name>]
+```
+
+Capability id: `tracking.debug_data.list`.
+
+Input sends `project_id`, `device_id`, `start_time`, and optional `event_name`. When omitted, `start_time` defaults to one hour ago in local time.
+
+The normalized result includes `has_data`, `event_count`, `data_count`, `event_list`, and `device_data_list`. Treat validation as successful only when `has_data` is true and the returned event names, property structures, and error fields are correct.
+
+## Parameters
+
+| Parameter      | Required | Description                                                                |
+| -------------- | -------- | -------------------------------------------------------------------------- |
+| `--project-id` | Yes      | Numeric AE project ID.                                                     |
+| `--device-id`  | Yes      | Debug device ID used by the reporting client.                              |
+| `--start-time` | No       | Query start time in local `YYYY-MM-DD HH:mm:ss`; defaults to one hour ago. |
+| `--event-name` | No       | Exact event name filter.                                                   |

package/skills/ae-analysis/references/debug_device_add.md

@@ -0,0 +1,23 @@
+# tracking debug-device add
+
+Use this command to create or update a Debug device for one AE project.
+Do not use it to select the active device or query Debug data; use `debug-device select` and `debug-data list` for those actions.
+
+Command:
+
+```bash
+ae-cli tracking debug-device add --project-id <project_id> --device-id <device_id> --device-name <device_name>
+```
+
+Capability id: `tracking.debug_device.add`.
+
+Input sends `project_id`, `device_id`, and `device_name`. Prefer a stable device ID that the validation script can reuse. After creation, select the same device with `tracking debug-device select`.
+The result confirms that the device was created or updated; use `debug-device list` to verify the saved device before selecting it.
+
+## Parameters
+
+| Parameter       | Required | Description                                          |
+| --------------- | -------- | ---------------------------------------------------- |
+| `--project-id`  | Yes      | Numeric AE project ID.                               |
+| `--device-id`   | Yes      | Stable Debug device ID used by the reporting client. |
+| `--device-name` | Yes      | Human-readable Debug device name.                    |

package/skills/ae-analysis/references/debug_device_list.md

@@ -0,0 +1,19 @@
+# tracking debug-device list
+
+Use this command to list Debug devices for one AE project and identify the device selected by the current CLI user.
+
+Command:
+
+```bash
+ae-cli tracking debug-device list --project-id <project_id>
+```
+
+Capability id: `tracking.debug_device.list`.
+
+Input sends `project_id`. The result contains the available Debug devices and current selection. Use the returned device IDs for `debug-device select` and `debug-data list`; do not invent an ID.
+
+## Parameters
+
+| Parameter      | Required | Description            |
+| -------------- | -------- | ---------------------- |
+| `--project-id` | Yes      | Numeric AE project ID. |