@thinkingai/ae-cli 6.0.29 → 6.0.31

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

@@ -1,69 +0,0 @@
-# analysis_audience +get_tags_by_name (Locate Tags by Name)
-
-> **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
-
-Domain: **Tag Management**
-
-## Use Cases
-- Get tag definition details in batch by tag name. Returns complete tag information for matched tags, including IDs, names, display names, types, status, user counts, and tag definitions.
-
-## Commands
-```bash
-ae-cli analysis_audience +get_tags_by_name --project_id <project_id> --names '["demo"]'
-ae-cli analysis_audience +get_tags_by_name --dry-run
-```
-
-## Parameters
-| Parameter | Required | Description |
-|---|---|---|
-| `--project_id` / `-p` | Yes | Project ID |
-| `--names` | Yes | List of tag names (JSON array). Exact-name matching is used; unmatched tags are ignored automatically. |
-
-## Decision Rules
-- For the first execution, it is recommended to pass only the required parameters (`--project_id`, `--names`) and add optional parameters after confirming the path works.
-- `--names` must be passed as a JSON array (e.g. `--names '["tag_a","tag_b"]'`).
-- When troubleshooting across projects, first confirm whether `--project_id` matches the current permissions and target environment.
-
-## Enum Codebook (Asset Definition Interpretation Only)
-
-When interpreting tag `definition` for users, if operator enum codes appear, use the following complete `calcuSymbol` mapping instead of outputting raw codes only.
-
-| Code | Meaning | Applicable Types |
-|---|---|---|
-| `C00` | equals | all |
-| `C000` | equals empty string | string |
-| `C01` | not equals | all |
-| `C010` | not equals empty string | string |
-| `C02` | less than | number |
-| `C020` | less than or equal | number |
-| `C03` | greater than | number |
-| `C030` | greater than or equal | number |
-| `C04` | has value | all |
-| `C05` | no value | all |
-| `C06` | range | number/date |
-| `C060` | date range | date |
-| `C07` | contains | string |
-| `C08` | does not contain | string |
-| `C09` | true | bool |
-| `C10` | false | bool |
-| `C11` | regex match | string |
-| `C12` | regex does not match | string |
-| `C13` | relative to current time | date/datetime |
-| `C14` | relative to event time | date/datetime |
-| `C15` | element exists | array |
-| `C16` | element does not exist | array |
-| `C17` | element position | array |
-| `C18` | no value | array |
-| `C19` | has value | array |
-| `C20` | belongs to cluster | cluster/tag (`tableType="2"`) |
-| `C21` | does not belong to cluster | cluster/tag (`tableType="2"`) |
-| `C22` | object exists that satisfies condition | array |
-| `C23` | no object satisfies condition | array |
-| `C24` | all objects satisfy condition | array |
-
-## Next Step on Failure
-- If required parameters are missing, fall back to the smallest runnable command and fill the gap (focus on `--project_id`, `--names`).
-- If reading fails, first verify whether the object ID exists and belongs to the current project.
-
-## Recommended Chain
-- +list_tags -> +get_tags_by_name -> +update_tag

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

@@ -1,35 +0,0 @@
-# analysis +list_bi_panels (list BI panels)
-
-> **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
-
-Domain: **BI panel management**
-
-## Use Cases
-- Discover BI panels accessible to the current MCP user in a project.
-- Search BI panels by name before asking for structure or data.
-- Get lightweight panel metadata such as `panelId`, `name`, `pageCount`, and `hasSummary`.
-
-## Command
-```bash
-ae-cli analysis +list_bi_panels --project_id <project_id>
-ae-cli analysis +list_bi_panels --project_id <project_id> --query "history" --fields '["panelId","name","pageCount","hasSummary"]' --limit 20 --offset 0
-ae-cli analysis +list_bi_panels --project_id <project_id> --dry-run
-```
-
-## Parameters
-| Parameter | Required | Description |
-|---|---|---|
-| `--project_id` / `-p` | Yes | Project ID |
-| `--query` / `-q` | No | Optional keyword filter. Fuzzy matches BI panel names. |
-| `--fields` / `-f` | No | Optional returned fields. Supported values: `panelId`, `name`, `spaceId`, `spaceName`, `ownerName`, `updatedAt`, `pageCount`, `hasSummary`. |
-| `--limit` / `-l` | No | Optional page size. Default: 20, maximum: 10000. |
-| `--offset` / `-o` | No | Optional page offset. Default: 0. |
-
-## Decision Rules
-- Use this before `+get_bi_panel_detail` unless the target `panel_id` is already verified in the same project and host.
-- Do not use this command to inspect pages, charts, controls, raw config, SQL, or permission rules.
-- Do not pass `userId` or `openId`; the service uses the current MCP user.
-- If no panel is found by keyword, broaden the keyword or list accessible panels and ask the user to choose.
-
-## Recommended Chaining
-- `+list_bi_panels` -> `+get_bi_panel_detail` -> `+query_bi_panel_data`

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

@@ -1,45 +0,0 @@
-# analysis_audience +list_cluster_members (View Cluster Members)
-
-> **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
-
-Domain: **Cluster Management**
-
-## Use Cases
-- List members in the specified cluster.
-- Supports payload governance parameters: `query`, `fields`, `limit`, `offset`.
-- Returns a paginated envelope (items + total + limit + offset + hasMore).
-
-## Commands
-```bash
-ae-cli analysis_audience +list_cluster_members --project_id <project_id> --cluster_name demo
-ae-cli analysis_audience +list_cluster_members --project_id <project_id> --cluster_name demo --property_names '["#user_id","name"]' --use_cache false
-ae-cli analysis_audience +list_cluster_members --project_id <project_id> --cluster_name demo --query user_001 --fields '["#user_id","name"]' --limit 20 --offset 0 --request_id mcp_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa --timeout_minutes 8
-ae-cli analysis_audience +list_cluster_members --dry-run
-```
-
-## Parameters
-| Parameter | Required | Description |
-|---|---|---|
-| `--project_id` / `-p` | Yes | Project ID |
-| `--cluster_name` | Yes | Cluster name |
-| `--property_names` | No | Optional list of user property names (JSON array) |
-| `--use_cache` | No | Whether to use cache. Default: true |
-| `--query` | No | Optional keyword filter on `#user_id` and selected properties. |
-| `--fields` | No | Optional return field list (JSON array). Invalid fields will fail with `INVALID_FIELDS`. |
-| `--limit` | No | Optional page size. Default: 20, max: 50. |
-| `--offset` | No | Optional page offset. Default: 0. |
-| `--request_id` | Yes | Required unique request ID used for tracking and cancellation. Generate it before starting the query. It must use `mcp_<32 lowercase hex UUID>`, for example `mcp_0123456789abcdef0123456789abcdef`. Provide this before starting the query so it can be cancelled later with `+cancel_query --request_id <same value>`, even if the caller stops waiting before the tool returns. If `fetch failed`, HTTP timeout, or caller timeout happens, the backend query may still be running. `requestId` is not auto-generated for MCP query tools because the caller must know it before the response for proactive cleanup. If omitted or blank, the backend returns `REQUEST_ID_REQUIRED`; invalid format returns `INVALID_REQUEST_ID`. The response `metadata.requestId` echoes the supplied requestId and can also be passed to `cancel_query(requestId)` when the query is no longer needed. |
-| `--timeout_minutes` | No | Query timeout in minutes. If omitted, 30 minutes is used. |
-
-## Decision Rules
-- For the first execution, include all required parameters (`--project_id`, `--cluster_name`, `--request_id`) and add optional parameters after confirming the path works.
-- `--property_names` must be passed as a JSON array (e.g. `--property_names '["#user_id"]'`).
-- Generate and pass `--request_id` before starting any cancelable query; it is required. If `fetch failed`, HTTP timeout, or caller timeout happens, the backend query may still be running; call `+cancel_query --request_id <same value>` with the preset ID. The value must use `mcp_<32 lowercase hex UUID>`, for example `mcp_0123456789abcdef0123456789abcdef`. Omitted or blank IDs return `REQUEST_ID_REQUIRED`; invalid format returns `INVALID_REQUEST_ID`.
-- When troubleshooting across projects, first confirm whether `--project_id` matches the current permissions and target environment.
-
-## Next Step on Failure
-- If required parameters are missing, fall back to the smallest runnable command and fill the gap (focus on `--project_id`, `--cluster_name`, `--request_id`).
-- If the result is empty, first confirm the project ID/keyword, then try broadening the filter conditions.
-
-## Recommended Chain
-- +list_clusters -> +get_clusters_by_name -> +update_cluster

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

@@ -1,46 +0,0 @@
-# analysis_audience +list_clusters (Audience/User Segment Cluster Search)
-
-> **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
-
-Domain: **Cluster Management**
-
-## Constraints
-
-**Fuzzy Search Fallback:** If `--query` returns no results, retry with broader keywords (max 3 attempts), then fall back to full list. See [SKILL.md § C. FUZZY_SEARCH_FALLBACK](../SKILL.md#c-fuzzy_search_fallback).
-
-**Term boundary:** This command lists audience/user segment clusters only. It is not a server, region, or deployment inventory tool.
-
-## Use Cases
-- List audience/user segment cluster metadata accessible to the current user in the project.
-- Supports payload governance parameters: `query`, `fields`, `limit`, `offset`.
-- Returns a paginated envelope (items + total + limit + offset + hasMore), not cluster members.
-
-## Commands
-```bash
-ae-cli analysis_audience +list_clusters --project_id <project_id>
-ae-cli analysis_audience +list_clusters --project_id <project_id> --query demo
-ae-cli analysis_audience +list_clusters --project_id <project_id> --fields '["id","clusterName","displayName","remarks","clusterType","progress","usersNum"]' --limit 20 --offset 0
-ae-cli analysis_audience +list_clusters --dry-run
-```
-
-## Parameters
-| Parameter | Required | Description |
-|---|---|---|
-| `--project_id` / `-p` | Yes | Project ID |
-| `--query` / `-q` | No | Optional keyword filter. Performs fuzzy matching against clusterName, displayName, and remarks; if omitted, all clusters are returned. |
-| `--fields` | No | Optional return field list (JSON array). Supported fields: `id`, `clusterName`, `displayName`, `clusterType`, `progress`, `usersNum`, `refreshStatus`, `remarks`, `authenticationStatus`. Default fields when omitted: `id`, `clusterName`, `displayName`, `remarks`, `clusterType`, `progress`, `usersNum`, `authenticationStatus`. Invalid fields will fail with `INVALID_FIELDS`. |
-| `--limit` | No | Optional page size. Default: 20, max: 50. |
-| `--offset` | No | Optional page offset. Default: 0. |
-| `--authenticated_only` | No | When true, return only authenticated clusters. |
-
-## Decision Rules
-- Use `--authenticated_only true` only when the user explicitly asks for authenticated assets. `authenticationStatus` is `1` for authenticated and `0` for unauthenticated.
-- For the first execution, it is recommended to pass only the required parameters (`--project_id`) and add optional parameters after confirming the path works.
-- When troubleshooting across projects, first confirm whether `--project_id` matches the current permissions and target environment.
-
-## Next Step on Failure
-- If required parameters are missing, fall back to the smallest runnable command and fill the gap (focus on `--project_id`).
-- If the result is empty, first confirm the project ID/keyword, then try broadening the filter conditions.
-
-## Recommended Chain
-- +list_clusters -> +get_clusters_by_name -> +update_cluster

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

@@ -1,43 +0,0 @@
-# analysis +list_dashboards (List Dashboards)
-
-> **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
-
-Domain: **Dashboard management**
-
-## Constraints
-
-**Fuzzy Search Fallback:** If `--query` returns no results, retry with broader keywords (max 3 attempts), then fall back to full list. See [SKILL.md § C. FUZZY_SEARCH_FALLBACK](../SKILL.md#c-fuzzy_search_fallback).
-
-**Builder failure is terminal:** For builder-supported ad-hoc analysis, this command may be used only in the initial `QUERY_EXISTING_FIRST` dashboard search. Do not call dashboard/report detail tools as a fallback after a QP builder returns non-generated status.
-
-## Use Cases
-- List dashboard metadata accessible to the current user in the project. Supports keyword filtering and returns dashboard IDs, names, descriptions, and related metadata, but not dashboard configuration or report data.
-- List dashboard metadata accessible to the current user in the project.
-
-## Command
-```bash
-ae-cli analysis +list_dashboards --project_id <project_id>
-ae-cli analysis +list_dashboards --project_id <project_id> --query demo
-ae-cli analysis +list_dashboards --project_id <project_id> --fields '["dashboardId","dashboardName","remark"]' --limit 20 --offset 0
-ae-cli analysis +list_dashboards --dry-run
-```
-
-## Parameters
-| Parameter | Required | Description |
-|---|---|---|
-| `--project_id` / `-p` | Yes | Project ID |
-| `--query` / `-q` | No | Optional keyword filter. Performs fuzzy matching against dashboard names and remarks; if omitted, all accessible dashboards are returned. |
-| `--fields` / `-f` | No | Optional fields to return (JSON array). Supported fields: `dashboardId`, `dashboardName`, `remark`. Default fields when omitted: `dashboardId`, `dashboardName`, `remark`. Dashboard metadata exposes `remark` but no separate desc field. |
-| `--limit` / `-l` | No | Optional page size. Default: 20, maximum: 10000. |
-| `--offset` / `-o` | No | Optional page offset. Default: 0. |
-
-## Decision Rules
-- On the first run, start with only the required parameters (`--project_id`), and add optional parameters after confirming the path works.
-- For cross-project troubleshooting, first confirm whether `--project_id` matches the current permissions and target environment.
-
-## Next Steps on Failure
-- If required parameters are missing, fall back to the smallest runnable command and fill them in first (focus on `--project_id`).
-- If the result is empty, first confirm the project ID / keyword, then try loosening the filter conditions.
-
-## Recommended chaining
-- +list_dashboards -> +query_dashboard_detail -> +query_dashboard_report_data

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

@@ -1,41 +0,0 @@
-# analysis +list_public_access_links (public link search)
-
-> **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
-
-Domain: **Dashboard Management**
-
-## Use Cases
-- List public access links in the project. Returns link IDs, short codes, access targets, status, effective time, expiration time, and related metadata.
-- Supports pagination with fields/limit/offset for payload governance.
-- Query performs fuzzy matching on shorter and remarks.
-
-## Commands
-```bash
-ae-cli analysis +list_public_access_links --project_id <project_id>
-ae-cli analysis +list_public_access_links --project_id <project_id> --query demo
-ae-cli analysis +list_public_access_links --project_id <project_id> --query demo --fields '["id","shorter","accessStatus"]' --limit 10 --offset 0
-ae-cli analysis +list_public_access_links --dry-run
-```
-
-## Parameters
-| Parameter | Required | Description |
-|---|---|---|
-| `--project_id` / `-p` | Yes | Project ID |
-| `--query` / `-q` | No | Optional keyword filter. Fuzzy match on shorter and remarks. |
-| `--fields` | No | Optional fields to return. Supported: id, shorter, creator, projectIdAndName, source, accessId, target, options, remarks, accessStatus, effectTime, expireTime, createTime, updateTime. Invalid fields cause INVALID_FIELDS error. |
-| `--limit` | No | Optional limit. Default: 20, maximum: 10000. |
-| `--offset` | No | Optional offset. Default: 0. |
-
-## Decision Rules
-- For the first run, it is recommended to pass only the required parameters (`--project_id`) and add optional parameters after confirming the chain works.
-- For pagination, use `--limit` and `--offset` together. Default limit is 20.
-- Use `--fields` to select specific columns for lighter response payloads.
-- For cross-project troubleshooting, first confirm whether `--project_id` matches the current permissions and target environment.
-
-## Next Step After Failure
-- If required parameters are missing, fall back to the smallest runnable command and fill them in (focus on `--project_id`).
-- If the result is empty, first confirm the project ID/keyword, then try broadening the filter conditions.
-- If INVALID_FIELDS error appears, check that all field names in `--fields` match the supported list.
-
-## Recommended Chaining
-- +list_public_access_links -> +update_public_access_link

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

@@ -1,43 +0,0 @@
-# analysis +list_reports (List Reports)
-
-> **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
-
-Domain: **Report management**
-
-## Constraints
-
-**Fuzzy Search Fallback:** If `--query` returns no results, retry with broader keywords (max 3 attempts), then fall back to full list. See [SKILL.md § C. FUZZY_SEARCH_FALLBACK](../SKILL.md#c-fuzzy_search_fallback).
-
-**Builder failure is terminal:** For builder-supported ad-hoc analysis, this command may be used only in the initial `QUERY_EXISTING_FIRST` report search. Do not call `+list_reports` or `+get_report_definition` as a fallback after a QP builder returns non-generated status.
-
-## Use Cases
-- List report metadata accessible to the current user in the project. Supports keyword filtering and returns report IDs, names, model types, update times, and related metadata, but not report definitions or analysis data.
-- List report metadata accessible to the current user in the project.
-
-## Command
-```bash
-ae-cli analysis +list_reports --project_id <project_id>
-ae-cli analysis +list_reports --project_id <project_id> --query demo
-ae-cli analysis +list_reports --project_id <project_id> --fields '["reportId","reportName","reportDesc","remark","reportModel"]' --limit 20 --offset 0
-ae-cli analysis +list_reports --dry-run
-```
-
-## Parameters
-| Parameter | Required | Description |
-|---|---|---|
-| `--project_id` / `-p` | Yes | Project ID |
-| `--query` / `-q` | No | Optional keyword filter. Performs fuzzy matching against reportName, reportDesc, and remark; if omitted, all accessible reports are returned. |
-| `--fields` / `-f` | No | Optional fields to return (JSON array). Supported fields: `reportId`, `reportName`, `reportDesc`, `remark`, `reportModel`. Default fields when omitted: `reportId`, `reportName`, `reportDesc`, `remark`, `reportModel`. |
-| `--limit` / `-l` | No | Optional page size. Default: 20, maximum: 10000. |
-| `--offset` / `-o` | No | Optional page offset. Default: 0. |
-
-## Decision Rules
-- On the first run, start with only the required parameters (`--project_id`), and add optional parameters after confirming the path works.
-- For cross-project troubleshooting, first confirm whether `--project_id` matches the current permissions and target environment.
-
-## Next Steps on Failure
-- If required parameters are missing, fall back to the smallest runnable command and fill them in first (focus on `--project_id`).
-- If the result is empty, first confirm the project ID / keyword, then try loosening the filter conditions.
-
-## Recommended chaining
-- +list_reports -> +get_report_definition -> +query_report_data

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

@@ -1,27 +0,0 @@
-# analysis +list_spaces (List Spaces)
-
-> **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
-
-Domain: **Dashboard Management**
-
-## Use Cases
-- List all spaces and folders accessible to the current user as a recursive tree.
-- Returns two parts: (1) project spaces with spaceId, name, spaceDesc, and children (folders/dashboards); (2) personal-space folders (My Space / Shared with me / Ungrouped) with their children.
-- Use to resolve `spaceId` for `+create_dashboard` / `+copy_dashboard`, and `toSpaceId` / `toFolderId` / `fromSpaceId` / `fromFolderId` for `+move_dashboard` and `+copy_dashboard`.
-
-## Commands
-```bash
-ae-cli analysis_audience +list_spaces --project_id <project_id>
-ae-cli analysis_audience +list_spaces --dry-run
-```
-
-## Parameters
-| Parameter | Required | Description |
-|---|---|---|
-| `--project_id` / `-p` | Yes | Project ID |
-
-## Decision Rules
-- Call this before `+copy_dashboard` or `+move_dashboard` whenever the user specifies a target space or folder by name.
-
-## Recommended Chain
-- `+list_spaces` -> `+copy_dashboard` / `+move_dashboard` / `+create_dashboard`

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

@@ -1,46 +0,0 @@
-# analysis_audience +list_tag_members (View Tag Members)
-
-> **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
-
-Domain: **Tag Management**
-
-## Use Cases
-- List members in the specified tag.
-- Supports payload governance parameters: `query`, `fields`, `limit`, `offset`.
-- Returns a paginated envelope (items + total + limit + offset + hasMore) for the selected snapshot date.
-
-## Commands
-```bash
-ae-cli analysis_audience +list_tag_members --project_id <project_id> --tag_name demo
-ae-cli analysis_audience +list_tag_members --project_id <project_id> --tag_name demo --snapshot_date 2026-04-01 --property_names '["#user_id","name"]' --use_cache false
-ae-cli analysis_audience +list_tag_members --project_id <project_id> --tag_name demo --query user_001 --fields '["#user_id","name"]' --limit 20 --offset 0 --request_id mcp_bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb --timeout_minutes 8
-ae-cli analysis_audience +list_tag_members --dry-run
-```
-
-## Parameters
-| Parameter | Required | Description |
-|---|---|---|
-| `--project_id` / `-p` | Yes | Project ID |
-| `--tag_name` | Yes | Tag name |
-| `--snapshot_date` | No | Optional tag snapshot date. Format: YYYY-MM-DD |
-| `--property_names` | No | Optional list of user property names (JSON array) |
-| `--use_cache` | No | Whether to use cache. Default: true |
-| `--query` | No | Optional keyword filter on `#user_id` and selected properties. |
-| `--fields` | No | Optional return field list (JSON array). Invalid fields will fail with `INVALID_FIELDS`. |
-| `--limit` | No | Optional page size. Default: 20, max: 50. |
-| `--offset` | No | Optional page offset. Default: 0. |
-| `--request_id` | Yes | Required unique request ID used for tracking and cancellation. Generate it before starting the query. It must use `mcp_<32 lowercase hex UUID>`, for example `mcp_0123456789abcdef0123456789abcdef`. Provide this before starting the query so it can be cancelled later with `+cancel_query --request_id <same value>`, even if the caller stops waiting before the tool returns. If `fetch failed`, HTTP timeout, or caller timeout happens, the backend query may still be running. `requestId` is not auto-generated for MCP query tools because the caller must know it before the response for proactive cleanup. If omitted or blank, the backend returns `REQUEST_ID_REQUIRED`; invalid format returns `INVALID_REQUEST_ID`. The response `metadata.requestId` echoes the supplied requestId and can also be passed to `cancel_query(requestId)` when the query is no longer needed. |
-| `--timeout_minutes` | No | Query timeout in minutes. If omitted, 30 minutes is used. |
-
-## Decision Rules
-- For the first execution, include all required parameters (`--project_id`, `--tag_name`, `--request_id`) and add optional parameters after confirming the path works.
-- `--property_names` must be passed as a JSON array (e.g. `--property_names '["#user_id"]'`).
-- Generate and pass `--request_id` before starting any cancelable query; it is required. If `fetch failed`, HTTP timeout, or caller timeout happens, the backend query may still be running; call `+cancel_query --request_id <same value>` with the preset ID. The value must use `mcp_<32 lowercase hex UUID>`, for example `mcp_0123456789abcdef0123456789abcdef`. Omitted or blank IDs return `REQUEST_ID_REQUIRED`; invalid format returns `INVALID_REQUEST_ID`.
-- When troubleshooting across projects, first confirm whether `--project_id` matches the current permissions and target environment.
-
-## Next Step on Failure
-- If required parameters are missing, fall back to the smallest runnable command and fill the gap (focus on `--project_id`, `--tag_name`, `--request_id`).
-- If the result is empty, first confirm the project ID/keyword, then try broadening the filter conditions.
-
-## Recommended Chain
-- +list_tags -> +get_tags_by_name -> +update_tag

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

@@ -1,44 +0,0 @@
-# analysis_audience +list_tags (Tag Search)
-
-> **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
-
-Domain: **Tag Management**
-
-## Constraints
-
-**Fuzzy Search Fallback:** If `--query` returns no results, retry with broader keywords (max 3 attempts), then fall back to full list. See [SKILL.md § C. FUZZY_SEARCH_FALLBACK](../SKILL.md#c-fuzzy_search_fallback).
-
-## Use Cases
-- List tag metadata accessible to the current user in the project.
-- Supports payload governance parameters: `query`, `fields`, `limit`, `offset`.
-- Returns a paginated envelope (items + total + limit + offset + hasMore), not tag members.
-
-## Commands
-```bash
-ae-cli analysis_audience +list_tags --project_id <project_id>
-ae-cli analysis_audience +list_tags --project_id <project_id> --query demo
-ae-cli analysis_audience +list_tags --project_id <project_id> --fields '["id","clusterName","displayName","remarks","clusterType","subConditionTabType","progress","usersNum"]' --limit 20 --offset 0
-ae-cli analysis_audience +list_tags --dry-run
-```
-
-## Parameters
-| Parameter | Required | Description |
-|---|---|---|
-| `--project_id` / `-p` | Yes | Project ID |
-| `--query` / `-q` | No | Optional keyword filter. Performs fuzzy matching against tag names, display names, and remarks; if omitted, all tags are returned. |
-| `--fields` | No | Optional return field list (JSON array). Supported fields: `id`, `clusterName`, `displayName`, `clusterType`, `subConditionTabType`, `progress`, `usersNum`, `remarks`, `authenticationStatus`. Default fields when omitted: `id`, `clusterName`, `displayName`, `remarks`, `clusterType`, `subConditionTabType`, `progress`, `usersNum`, `authenticationStatus`. Invalid fields will fail with `INVALID_FIELDS`. |
-| `--limit` | No | Optional page size. Default: 20, max: 50. |
-| `--offset` | No | Optional page offset. Default: 0. |
-| `--authenticated_only` | No | When true, return only authenticated tags. |
-
-## Decision Rules
-- Use `--authenticated_only true` only when the user explicitly asks for authenticated assets. `authenticationStatus` is `1` for authenticated and `0` for unauthenticated.
-- For the first execution, it is recommended to pass only the required parameters (`--project_id`) and add optional parameters after confirming the path works.
-- When troubleshooting across projects, first confirm whether `--project_id` matches the current permissions and target environment.
-
-## Next Step on Failure
-- If required parameters are missing, fall back to the smallest runnable command and fill the gap (focus on `--project_id`).
-- If the result is empty, first confirm the project ID/keyword, then try broadening the filter conditions.
-
-## Recommended Chain
-- +list_tags -> +get_tags_by_name -> +update_tag

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

@@ -1,33 +0,0 @@
-# analysis +move_dashboard (Move Dashboard)
-
-> **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
-
-Domain: **Dashboard Management**
-
-## Use Cases
-- Move a dashboard to a different space or folder.
-- Provide `--to_space_id` to move to a space root, or both `--to_space_id` and `--to_folder_id` to move into a folder within that space.
-- `--from_space_id` and `--from_folder_id` are optional; provide them when the dashboard exists in multiple spaces to disambiguate the source path.
-
-## Commands
-```bash
-ae-cli analysis_audience +move_dashboard --project_id <project_id> --dashboard_id <dashboard_id> --to_space_id <space_id>
-ae-cli analysis_audience +move_dashboard --project_id <project_id> --dashboard_id <dashboard_id> --to_space_id <space_id> --to_folder_id <folder_id>
-ae-cli analysis_audience +move_dashboard --dry-run
-```
-
-## Parameters
-| Parameter | Required | Description |
-|---|---|---|
-| `--project_id` / `-p` | Yes | Project ID |
-| `--dashboard_id` | Yes | Dashboard ID to move |
-| `--to_space_id` | Yes | Target space ID |
-| `--to_folder_id` | No | Target folder ID within the target space. Omit to place at the space root. |
-| `--from_space_id` | No | Source space ID. Omit if unknown. |
-| `--from_folder_id` | No | Source folder ID. Omit if unknown. |
-
-## Decision Rules
-- Call `+list_spaces` first to resolve `to_space_id` and `to_folder_id`.
-
-## Recommended Chain
-- `+list_spaces` -> `+move_dashboard`

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

@@ -1,141 +0,0 @@
-# analysis +query_adhoc (Ad Hoc Analysis Execution)
-
-> **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
-
-Domain: **Model analysis**
-
-## Constraints
-
-**⚠️ QUERY_EXISTING_FIRST:** Before using ad-hoc query, you MUST first check for existing reports with `+list_reports` and dashboards with `analysis dashboard list`. Only use `query_adhoc` if no matching asset is used. See [SKILL.md § D. QUERY_EXISTING_FIRST](../SKILL.md#d-query_existing_first).
-
-**⚠️ QP_BUILDER_SUPPORTED_MODELS_ONLY:** QP builder supports all ten non-SQL ad-hoc model types: `event`, `retention`, `funnel`, `prop_analysis`, `attribution`, `distribution`, `heat_map`, `interval`, `path`, and `rank_list`.
-
-For these ten model types, call the matching builder before `query_adhoc`. Do not handcraft QP from `get_analysis_query_schema`, examples, or prior knowledge.
-
-Only `sql` has no builder. Use the schema/verified SQL-definition path for SQL.
-
-For builder-supported models, schema/metadata tools are not builder pre-steps. After report/dashboard lookup misses, do not call `get_analysis_query_schema`, `list_events`, `list_properties`, `list_metrics`, `get_metric`, or `get_report_definition` before the builder. The builder resolves event/property/metric metadata internally.
-
-**Hard stop rule:** If builder status is not `generated`, stop and ask the user to clarify or report the builder error. Do not call `query_adhoc`, `get_analysis_query_schema`, or manually assemble QP for any of the ten builder-supported models.
-
-Builder mapping:
-1. `event` -> `+build_event_analysis_qp`
-2. `retention` -> `+build_retention_analysis_qp`
-3. `funnel` -> `+build_funnel_analysis_qp`
-4. `prop_analysis` -> `+build_prop_analysis_qp`
-5. `attribution` -> `+build_attribution_analysis_qp`
-6. `distribution` -> `+build_distribution_analysis_qp`
-7. `heat_map` -> `+build_heat_map_analysis_qp`
-8. `interval` -> `+build_interval_analysis_qp`
-9. `path` -> `+build_path_analysis_qp`
-10. `rank_list` -> `+build_rank_list_analysis_qp`
-
-**Quick check workflow:**
-1. `list_reports --query <keyword>` - search matching reports
-2. `ae-cli analysis dashboard list --project-id <project_id> --query <keyword>` - search matching dashboards
-3. If found → use `+query_report_data` or `analysis dashboard-report-data run/export`
-4. If not found and model is non-SQL → read the matching builder reference, call the builder, then call `query_adhoc` with `model_type` + built `qp`; do not insert schema or metadata lookup before the builder
-5. If not found and model is `sql` → use the schema/verified SQL-definition path, then call `query_adhoc`
-
-## Use Cases
-- Execute a QP produced by the required chain for the target model.
-- Builder-supported models (all ten non-SQL models): execute the `qp` returned by builder tools.
-- SQL: execute QP from the schema/verified SQL-definition path.
-- Event analysis: metrics such as event trigger counts, user counts, sums, averages, and more.
-- Retention analysis: metrics such as user churn and retention.
-- Funnel analysis: metrics such as multi-step conversion.
-- Distribution analysis: bucketed distribution analysis.
-- Attribution analysis: multi-touch attribution analysis (first touch, last touch, linear attribution).
-- Interval analysis: time interval analysis between events.
-- Path analysis: user behavior path analysis.
-- Property analysis: user property distribution analysis.
-- Heat map: visual heat map analysis of user interactions.
-- Rank list: ranking / leaderboard analysis.
-- SQL: custom SQL analysis.
-- Process:
-  - Builder-supported models: builder -> `query_adhoc`
-  - SQL: schema/verified definition -> `query_adhoc`
-
-## Builder-Supported Model Chain
-Use this chain for all ten non-SQL models.
-
-1. Read the matching builder reference:
-   - `event`: [`build_event_analysis_qp.md`](./build_event_analysis_qp.md)
-   - `retention`: [`build_retention_analysis_qp.md`](./build_retention_analysis_qp.md)
-   - `funnel`: [`build_funnel_analysis_qp.md`](./build_funnel_analysis_qp.md)
-   - `prop_analysis`: [`build_prop_analysis_qp.md`](./build_prop_analysis_qp.md)
-   - `attribution`: [`build_attribution_analysis_qp.md`](./build_attribution_analysis_qp.md)
-   - `distribution`: [`build_distribution_analysis_qp.md`](./build_distribution_analysis_qp.md)
-   - `heat_map`: [`build_heat_map_analysis_qp.md`](./build_heat_map_analysis_qp.md)
-   - `interval`: [`build_interval_analysis_qp.md`](./build_interval_analysis_qp.md)
-   - `path`: [`build_path_analysis_qp.md`](./build_path_analysis_qp.md)
-   - `rank_list`: [`build_rank_list_analysis_qp.md`](./build_rank_list_analysis_qp.md)
-2. Compose the builder JSON using the documented DTO keys. Nested JSON keys are camelCase, not snake_case.
-3. Run the builder with all required flags. `--dry-run` is allowed only with complete required builder inputs, not by itself.
-4. If builder returns `status=generated`, copy `data.qp` from the builder response and pass it as `--qp`.
-5. If the builder returns `need_clarification`, `invalid_argument`, `unsupported_feature`, or `validation_error`, stop and ask for clarification. Do not use the manual path as a fallback.
-
-## Legacy Query Chain
-Use this chain only for `sql`.
-
-1. Read this reference and the required schema/metadata references.
-2. Call `+get_analysis_query_schema` for the target model when the QP shape is not already verified.
-3. Discover real events/properties/metrics with analysis metadata commands as needed.
-4. Construct QP according to the documented schema and verified metadata.
-5. Call `+query_adhoc`.
-
-Timezone rule:
-- Builder commands do not accept `zone_offset`.
-- Apply timezone only on this execution command, for example `--zone_offset -11`.
-
-## Command Syntax
-```bash
-ae-cli analysis +query_adhoc --project_id <project_id> --model_type <model_type> --qp '<qp_json_from_builder_or_legacy_chain>'
-ae-cli analysis +query_adhoc --project_id <project_id> --model_type <model_type> --qp '<qp_json_from_builder_or_legacy_chain>' --fields '["date","event"]' --limit 10 --offset 0 --zone_offset 8 --request_id mcp_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa --use_cache true --is_sort_by_columns true --resolve_recent_day true --timeout_minutes 8
-ae-cli analysis +query_adhoc --project_id <project_id> --model_type <model_type> --qp '<qp_json_from_builder_or_legacy_chain>' --dry-run
-```
-
-## Parameters
-| Parameter | Required | Description |
-|---|---|---|
-| `--project_id` / `-p` | Yes | Project ID used to identify the analysis project |
-| `--model_type` | Yes | Model type. Supported values: event, retention, funnel, distribution, attribution, heat_map, interval, path, rank_list, prop_analysis, sql. |
-| `--qp` | Yes | Query parameter JSON. For every non-SQL model, pass QP returned by the matching builder tool. For SQL, use the schema/verified-definition path. |
-| `--request_id` | Yes | Required unique request ID used for tracking and cancellation. Generate it before starting the query. It must use `mcp_<32 lowercase hex UUID>`, for example `mcp_0123456789abcdef0123456789abcdef`. Provide this before starting the query so it can be cancelled later with `+cancel_query --request_id <same value>`, even if the caller stops waiting before the tool returns. If `fetch failed`, HTTP timeout, or caller timeout happens, the backend query may still be running. `requestId` is not auto-generated for MCP query tools because the caller must know it before the response for proactive cleanup. If omitted or blank, the backend returns `REQUEST_ID_REQUIRED`; invalid format returns `INVALID_REQUEST_ID`. The response `metadata.requestId` echoes the supplied requestId and can also be passed to `cancel_query(requestId)` when the query is no longer needed. |
-| `--use_cache` | No | Whether to use result cache. Default: true |
-| `--zone_offset` | No | Time zone offset in hours. For example, UTC+8 is 8 and UTC-5 is -5 |
-| `--is_sort_by_columns` | No | Whether to sort query results by columns. Default: false |
-| `--resolve_recent_day` | No | Whether to resolve relative time expressions such as "last 7 days". If omitted, service auto-resolves when `qp.eventView.recentDay` exists and `startTime`/`endTime` is incomplete; otherwise defaults to false. |
-| `--fields` | No | Optional fields to return. Must match column names in result. Invalid fields cause INVALID_FIELDS error. |
-| `--limit` | No | Optional limit. Default: 1000, maximum: 10000. |
-| `--offset` | No | Optional offset. Default: 0. |
-| `--timeout_minutes` | No | Query timeout in minutes. If the query exceeds this time, it will be cancelled automatically. |
-
-## Decision Rules
-- On the first run, include all required parameters (`--project_id`,`--model_type`,`--qp`,`--request_id`). Generate `--request_id` before starting the query so cancellation can use the same value if the caller stops waiting.
-- Do not call this command with placeholder QP such as `{}`. For non-SQL models, wait for builder `status=generated`; for SQL, build QP from a verified schema/definition first.
-- For builder-supported models, do not run metadata/schema lookup to "help" the builder. The builder is the metadata resolver.
-- For pagination, use `--limit` and `--offset` together. Default limit is 1000, maximum 100000.
-- For `model_type=sql`, use exactly one row limit: either put `LIMIT` in the SQL, or use `--limit`. If both are present they must be equal — `query_adhoc` rejects mismatched values to avoid silently sampled or duplicated results. When the SQL already has a trailing `LIMIT`, you may omit `--limit` and the SQL governs.
-- Use `--fields` to select specific columns for lighter response payloads.
-- Non-SQL models must not manually craft QP with schema-first flow; call the matching builder and use its returned `qp`.
-- For SQL, `qp` must satisfy both schema structure and project metadata constraints.
-- Wrap JSON parameters in single quotes (for example `--qp '<real_qp_json>'`) to avoid shell escaping issues.
-- For cross-project troubleshooting, first confirm whether `--project_id` matches the current permissions and target environment.
-- If the user supplied a timezone such as UTC-11, pass `--zone_offset -11` here, not to the builder.
-
-## Next Steps on Failure
-- If required parameters are missing, resolve `project_id`, `model_type`, and a real `qp` first. Do not run placeholder calls except explicit `--dry-run` validation.
-- If a builder returns non-`generated` status, stop and ask the user to clarify before calling `query_adhoc`.
-- If `Invalid JSON` appears on legacy manual QP paths, first check schema required fields, then verify whether event/property names come from metadata query results for the same `project_id`.
-- If the query returns `fetch failed`, hits an HTTP timeout, or the caller stops waiting after you preset `--request_id`, immediately call `+cancel_query --request_id <same value> --yes`; the backend query may still be running.
-- If the query times out inside the service and returns `QUERY_TIMEOUT`, use the returned `metadata.requestId` for cancellation if further cleanup is needed, then narrow the time range / grouping dimensions and split subqueries to locate the issue.
-
-## Recommended chaining
-- +build_event_analysis_qp -> +query_adhoc
-- +build_retention_analysis_qp -> +query_adhoc
-- +build_funnel_analysis_qp -> +query_adhoc
-- +build_prop_analysis_qp -> +query_adhoc
-- +build_attribution_analysis_qp / +build_distribution_analysis_qp / +build_heat_map_analysis_qp / +build_interval_analysis_qp / +build_path_analysis_qp / +build_rank_list_analysis_qp -> +query_adhoc
-- +get_analysis_query_schema -> +query_adhoc (SQL only)
-- +list_events -> +list_properties -> +query_adhoc -> +drilldown_users -> +drilldown_user_events