@thinkingai/ae-cli 6.1.6 → 6.1.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (89) hide show
  1. package/dist/index.js +25 -17
  2. package/dist/{metadata-W2MEOI4Z.js → metadata-ELUAR3EJ.js} +0 -53
  3. package/dist/{metadata-3M5F2AED.js → metadata-P5GIVMZ6.js} +0 -53
  4. package/dist/{te-agent-K2OWMZXT.js → te-agent-BOQ7ZY56.js} +194 -1
  5. package/dist/{te-analysis-Q7AZCDU4.js → te-analysis-HZIP6SYW.js} +446 -562
  6. package/dist/{te-analysis-I73ZS4NK.js → te-analysis-ZT2MYAHL.js} +446 -562
  7. package/dist/{te-dataops-MJV54MNY.js → te-dataops-VYN3IOKO.js} +6 -6
  8. package/dist/{te-dataops-OA7I6HBG.js → te-dataops-Y5QAPPPF.js} +6 -6
  9. package/dist/te-meta-GBDTMPEL.js +95 -0
  10. package/dist/te-meta-ZTLTSHXC.js +95 -0
  11. package/package.json +5 -4
  12. package/skills/ae-agent/SKILL.md +5 -1
  13. package/skills/ae-agent/references/list-sandbox-tools.md +79 -0
  14. package/skills/ae-analysis/SKILL.md +8 -9
  15. package/skills/ae-analysis/references/adhoc_export.md +8 -0
  16. package/skills/ae-analysis/references/adhoc_run.md +9 -0
  17. package/skills/ae-analysis/references/ai_models.md +3 -1
  18. package/skills/ae-analysis/references/analysis_data_retrieval.md +2 -0
  19. package/skills/ae-analysis/references/analysis_drilldown_contract.md +2 -0
  20. package/skills/ae-analysis/references/analysis_gateway_assets.md +9 -7
  21. package/skills/ae-analysis/references/command_index.md +18 -40
  22. package/skills/ae-analysis/references/dashboard_report_data_export.md +4 -2
  23. package/skills/ae-analysis/references/dashboard_report_data_run.md +5 -3
  24. package/skills/ae-analysis/references/drilldown_entities_export.md +3 -0
  25. package/skills/ae-analysis/references/drilldown_entities_run.md +2 -1
  26. package/skills/ae-analysis/references/drilldown_events_export.md +3 -0
  27. package/skills/ae-analysis/references/drilldown_events_run.md +2 -1
  28. package/skills/ae-analysis/references/drilldown_user_events_export.md +3 -0
  29. package/skills/ae-analysis/references/drilldown_user_events_run.md +2 -0
  30. package/skills/ae-analysis/references/entity_id_import_options.md +1 -1
  31. package/skills/ae-analysis/references/filter_value_list.md +47 -0
  32. package/skills/ae-analysis/references/project_space_get.md +3 -3
  33. package/skills/ae-analysis/references/project_space_list.md +6 -2
  34. package/skills/ae-analysis/references/query_cancel.md +3 -1
  35. package/skills/ae-analysis/references/query_cluster_list.md +34 -0
  36. package/skills/ae-analysis/references/query_create_result_cluster.md +2 -0
  37. package/skills/ae-analysis/references/report_create.md +5 -1
  38. package/skills/ae-analysis/references/report_data_export.md +9 -2
  39. package/skills/ae-analysis/references/report_data_run.md +8 -3
  40. package/skills/ae-analysis/references/report_get.md +3 -1
  41. package/skills/ae-analysis/references/report_update.md +4 -0
  42. package/skills/ae-analysis/references/virtual_event_create.md +7 -6
  43. package/skills/ae-analysis-global/SKILL.md +15 -32
  44. package/skills/ae-community/SKILL.md +1 -1
  45. package/skills/ae-data-integration-helper/SKILL.md +3 -2
  46. package/skills/ae-data-integration-helper/references/sdk_usage_notes.md +1 -1
  47. package/skills/ae-dataops/SKILL.md +2 -1
  48. package/skills/ae-dataops/references/dataops-integration.md +75 -6
  49. package/skills/ae-generate-tracking-code/SKILL.md +4 -3
  50. package/skills/ae-generate-tracking-code/references/client-sdk-insert.md +1 -1
  51. package/skills/ae-generate-tracking-code/references/server-sdk-insert.md +1 -1
  52. package/skills/ae-generate-tracking-code/references/snippet-delivery.md +1 -1
  53. package/skills/ae-generate-tracking-plan/SKILL.md +6 -2
  54. package/skills/ae-metadata/SKILL.md +8 -15
  55. package/skills/ae-metadata/references/metadata_property_dimension_table_bind_existing.md +1 -1
  56. package/dist/te-common-ST3QPSXJ.js +0 -61
  57. package/dist/te-common-WSLIKKPC.js +0 -61
  58. package/dist/te-meta-Q4L6EE3Q.js +0 -363
  59. package/dist/te-meta-VHCN4Q62.js +0 -363
  60. package/skills/ae-analysis/references/batch_create_metadata.md +0 -41
  61. package/skills/ae-analysis/references/batch_edit_metadata.md +0 -39
  62. package/skills/ae-analysis/references/cancel_query.md +0 -38
  63. package/skills/ae-analysis/references/create_alert.md +0 -47
  64. package/skills/ae-analysis/references/create_entity.md +0 -39
  65. package/skills/ae-analysis/references/create_project_mark_time.md +0 -39
  66. package/skills/ae-analysis/references/delete_alert.md +0 -32
  67. package/skills/ae-analysis/references/delete_project_mark_times.md +0 -36
  68. package/skills/ae-analysis/references/delete_track_items.md +0 -36
  69. package/skills/ae-analysis/references/generate_track_program.md +0 -52
  70. package/skills/ae-analysis/references/generate_track_sdk_sample.md +0 -44
  71. package/skills/ae-analysis/references/get_alert.md +0 -35
  72. package/skills/ae-analysis/references/get_alert_definition_schema.md +0 -33
  73. package/skills/ae-analysis/references/get_project_config.md +0 -33
  74. package/skills/ae-analysis/references/get_track_program.md +0 -34
  75. package/skills/ae-analysis/references/list_alerts.md +0 -41
  76. package/skills/ae-analysis/references/list_entities.md +0 -42
  77. package/skills/ae-analysis/references/list_project_mark_times.md +0 -43
  78. package/skills/ae-analysis/references/list_project_users.md +0 -33
  79. package/skills/ae-analysis/references/list_projects.md +0 -39
  80. package/skills/ae-analysis/references/load_filters.md +0 -47
  81. package/skills/ae-analysis/references/save_track_items.md +0 -37
  82. package/skills/ae-analysis/references/update_alert.md +0 -49
  83. package/skills/ae-analysis/references/update_project_mark_time.md +0 -40
  84. package/skills/ae-analysis-global/references/list_query_clusters.md +0 -68
  85. package/skills/ae-metadata/references/metadata_event_get.md +0 -52
  86. package/skills/ae-metadata/references/metadata_property_get.md +0 -54
  87. package/dist/{config-RCCGHHYA.js → config-PMPISN5Y.js} +4 -4
  88. package/dist/{te-community-WXGB6IOX.js → te-community-QOYIYEJI.js} +3 -3
  89. package/dist/{te-community-X2AHXGCA.js → te-community-UFKI6ONP.js} +3 -3
@@ -1,36 +0,0 @@
1
- # analysis_meta +delete_project_mark_times (Delete Project Mark Times)
2
-
3
- > **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
4
-
5
- Domain: **Project Configuration**
6
-
7
- ## Use Cases
8
- - Delete one or more project date markers.
9
- - Do not use it to hide or edit a marker; use `+update_project_mark_time` when the marker should remain.
10
-
11
- ## Commands
12
- ```bash
13
- ae-cli analysis_meta +delete_project_mark_times --project_id <project_id> --mark_time_ids '[]' --dry-run
14
- # Summarize the target and impact, then wait for explicit user confirmation.
15
- ae-cli analysis_meta +delete_project_mark_times --project_id <project_id> --mark_time_ids '[]' --yes
16
- ```
17
-
18
- ## Parameters
19
- | Parameter | Required | Description |
20
- |---|---|---|
21
- | `--project_id` / `-p` | Yes | Project ID |
22
- | `--mark_time_ids` | Yes | List of marker IDs |
23
-
24
- ## Decision Rules
25
- - For the first run, pass only the required parameters (`--project_id` and `--mark_time_ids`) to confirm the path works, then add optional parameters.
26
- - Wrap JSON parameters in single quotes (for example `--mark_time_ids '{}'`) to avoid shell escaping issues.
27
- - For cross-project troubleshooting, first confirm whether `--project_id` matches the current permissions and target environment.
28
- - This is `high-risk-write`: inspect the dry-run, summarize the target and impact, and wait for explicit user confirmation before the `--yes` execution.
29
-
30
- ## Next Steps After Failure
31
- - If required parameters are missing, fall back to the smallest runnable command and fill them in first (focus on `--project_id` and `--mark_time_ids`).
32
- - If `Invalid JSON` appears, first validate with the smallest JSON structure (such as `{}` or `[]`), then add fields step by step.
33
- - If the result after writing does not match expectations, immediately reread the corresponding list/get interfaces for before-and-after comparison.
34
-
35
- ## Recommended Chaining
36
- - +list_project_mark_times -> +delete_project_mark_times
@@ -1,36 +0,0 @@
1
- # analysis_meta +delete_track_items (Delete Track Program Items)
2
-
3
- > **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
4
-
5
- Domain: **Project Configuration**
6
-
7
- ## Use Cases
8
- - Delete TRACKING-PLAN metadata items only. Do not use for effective system metadata deletion/editing; those belong to MetaPowerTool/other system metadata flows.
9
- - Delete TRACKING-PLAN metadata items only.
10
-
11
- ## Command
12
- ```bash
13
- ae-cli analysis_meta +delete_track_items --project_id <project_id> --delete_data '{}' --dry-run
14
- # Summarize the target and impact, then wait for explicit user confirmation.
15
- ae-cli analysis_meta +delete_track_items --project_id <project_id> --delete_data '{}' --yes
16
- ```
17
-
18
- ## Parameters
19
- | Parameter | Required | Description |
20
- |---|---|---|
21
- | `--project_id` / `-p` | Yes | Project ID |
22
- | `--delete_data` | Yes | Delete payload JSON object with events/eventPropNames/userPropNames/commonEventPropNames. At least one list must be provided. |
23
-
24
- ## Decision Rules
25
- - First run should only pass required parameters (`--project_id`, `--delete_data`), and add optional parameters only after the path is confirmed to work.
26
- - Wrap JSON arguments in single quotes (for example `--delete_data '{}'`) to avoid shell escaping issues.
27
- - For cross-project troubleshooting, first confirm whether `--project_id` matches the current permissions and target environment.
28
- - This is `high-risk-write`: inspect the dry-run, summarize the target and impact, and wait for explicit user confirmation before the `--yes` execution.
29
-
30
- ## Next Steps After Failure
31
- - If required parameters are missing, fall back to the smallest runnable command and fill them in (focus on `--project_id` and `--delete_data`).
32
- - If `Invalid JSON` occurs, validate with the smallest JSON structure first (for example `{}` or `[]`), then add fields step by step.
33
- - If the result after writing is not as expected, immediately read back the corresponding list/get interface for a before-and-after comparison.
34
-
35
- ## Recommended Chaining
36
- - +get_track_program -> +delete_track_items -> +get_track_program
@@ -1,52 +0,0 @@
1
- # analysis_meta +generate_track_program (Generate Tracking Plan)
2
-
3
- > **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
4
-
5
- Domain: **Project Configuration**
6
-
7
- ## Use Cases
8
- - Generate a tracking plan from structured business context. This AI generation flow is different from save_track_items: save_track_items persists explicitly provided plan items, while this tool requests AI generation and saves the generated result asynchronously.
9
- - Users should check the in-site message center for final results.
10
- - Do not use it to persist a fully specified set of tracking items; use `+save_track_items` when the exact items are already known.
11
-
12
- ## CRITICAL: Pre-execution Check
13
- **Before calling this command, you MUST:**
14
- 1. Call `+get_track_program` first to check if a tracking plan already exists.
15
- 2. If the tracking plan is empty/missing, proceed directly with `+generate_track_program`.
16
- 3. If the tracking plan already exists, STOP and warn the user: "A tracking plan already exists. Generating a new one will trigger a merge operation. Do you want to continue?" Wait for user confirmation before proceeding.
17
-
18
- ## Commands
19
- ```bash
20
- ae-cli analysis_meta +generate_track_program --project_id <project_id> --language <language> --form_data '{}'
21
- ae-cli analysis_meta +generate_track_program --dry-run
22
- ```
23
-
24
- ## Parameters
25
- | Parameter | Required | Description |
26
- |-----------------------|----------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
27
- | `--project_id` / `-p` | Yes | Project ID |
28
- | `--language` / `-l` | Yes | Language code. Supported values: `zh-CN`, `en-US`, `ja-JP`, `ko-KR` |
29
- | `--form_data` | Yes | Structured business context JSON object. Optional fields for example: account_system, revenue_model, core_gameplay, currency_system, main_entries, predefinedEvent (array of event names like install, start, close), developmentCarrier (array of platforms like Android, iOS, Unity, Cocos, Douyin Mini Game, WeChat Mini Game). All fields can be customized based on business needs. |
30
-
31
- ## Decision Rules
32
- - **CRITICAL: Always call `+get_track_program` first to check existing tracking plan before generating.**
33
- - First run should only pass the required parameters (`--project_id`, `--language`, `--form_data`).
34
- - Wrap JSON arguments in single quotes (for example `--form_data '{}'`) to avoid shell escaping issues.
35
- - This is an asynchronous operation; check in-site message center for generation results.
36
- - For cross-project troubleshooting, first confirm whether `--project_id` matches the current permissions and target environment.
37
-
38
- ## Next Steps After Failure
39
- - If required parameters are missing, fall back to the smallest runnable command and fill them in (focus on `--project_id`, `--language`, and `--form_data`).
40
- - If `Invalid JSON` occurs, validate with the smallest JSON structure first.
41
-
42
- ## Agent Response Flow
43
- **After successful command execution, the agent MUST inform the user in English:**
44
- 1. The command has been submitted successfully
45
- 2. It's running asynchronously in the background
46
- 3. Check the TE page inbox/notifications for the generation results
47
-
48
- Example response: "Command submitted successfully. The tracking plan generation is running asynchronously. Please check your TE inbox for the results once it completes."
49
-
50
- ## Recommended Chaining
51
- - **+get_track_program (check existing) -> +generate_track_program (if empty or user confirms) -> (check message center) -> +get_track_program (verify result)**
52
- - +get_project_config -> +get_track_program -> +generate_track_program
@@ -1,44 +0,0 @@
1
- # analysis_meta +generate_track_sdk_sample (Generate SDK Sample Files)
2
-
3
- > **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
4
-
5
- Domain: **Project Configuration**
6
-
7
- ## Use Cases
8
- - Generate SDK sample files based on the current tracking plan and requested SDK types. This flow is asynchronous and users should check in-site messages for final downloadable results.
9
- - Useful for developers who need SDK integration code samples based on the tracking plan.
10
- - Do not use it to create or change the tracking plan itself; generate samples only after `+get_track_program` confirms the plan content.
11
-
12
- ## Commands
13
- ```bash
14
- ae-cli analysis_meta +generate_track_sdk_sample --project_id <project_id> --sdk_type '["android-java","ios-swift"]'
15
- ae-cli analysis_meta +generate_track_sdk_sample --dry-run
16
- ```
17
-
18
- ## Parameters
19
- | Parameter | Required | Description |
20
- |---|---|---|
21
- | `--project_id` / `-p` | Yes | Project ID |
22
- | `--sdk_type` | Yes | SDK types as JSON array. Allowed values: android-java, server-php, ios-swift, server-python, web-js, server-java, server-nodejs, wechat-miniapp, harmonyos-arkts, android-kotlin, unity-csharp, cocos-creator-ts, server-go, server-cpp, ios-objc. |
23
-
24
- ## Decision Rules
25
- - First run should only pass the required parameters (`--project_id`, `--sdk_type`).
26
- - Wrap JSON arguments in single quotes (for example `--sdk_type '["android-java"]'`) to avoid shell escaping issues.
27
- - This is an asynchronous operation; check in-site message center for downloadable SDK sample results.
28
- - For cross-project troubleshooting, first confirm whether `--project_id` matches the current permissions and target environment.
29
-
30
- ## Next Steps After Failure
31
- - If required parameters are missing, fall back to the smallest runnable command and fill them in (focus on `--project_id` and `--sdk_type`).
32
- - If `SDK_TYPE_INVALID` occurs, verify that all SDK types are from the allowed values list: android-java, server-php, ios-swift, server-python, web-js, server-java, server-nodejs, wechat-miniapp, harmonyos-arkts, android-kotlin, unity-csharp, cocos-creator-ts, server-go, server-cpp, ios-objc.
33
- - If `Invalid JSON` occurs, validate with the smallest JSON array first (for example `["android-java"]`).
34
-
35
- ## Agent Response Flow
36
- **After successful command execution, the agent MUST inform the user in English:**
37
- 1. The command has been submitted successfully
38
- 2. It's running asynchronously in the background
39
- 3. Check the TE page inbox/notifications for the final downloadable results
40
-
41
- Example response: "Command submitted successfully. The SDK sample generation is running asynchronously. Please check your TE inbox for the download link once it completes."
42
-
43
- ## Recommended Chaining
44
- - +get_track_program -> +generate_track_sdk_sample -> (check message center for download)
@@ -1,35 +0,0 @@
1
- # analysis +get_alert (view alert definition)
2
-
3
- > **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
4
-
5
- Domain: **Metadata Lookup**
6
-
7
- ## Use Cases
8
- - Get detailed information about a specific alert by alertId.
9
- - Do not use it to discover an unknown alert ID; call `+list_alerts` first.
10
-
11
- ## Output
12
- Returns the alert identity and saved definition. Use that returned definition as the baseline before an update; do not reconstruct it from memory.
13
-
14
- ## Commands
15
- ```bash
16
- ae-cli analysis +get_alert --project_id <project_id> --alert_id 1
17
- ae-cli analysis +get_alert --dry-run
18
- ```
19
-
20
- ## Parameters
21
- | Parameter | Required | Description |
22
- |---|---|---|
23
- | `--project_id` / `-p` | Yes | Project ID |
24
- | `--alert_id` / `-a` | Yes | Alert ID |
25
-
26
- ## Decision Rules
27
- - For the first run, it is recommended to pass only the required parameters (`--project_id`, `--alert_id`) and add optional parameters after confirming the chain works.
28
- - For cross-project troubleshooting, first confirm whether `--project_id` matches the current permissions and target environment.
29
-
30
- ## Next Step After Failure
31
- - If required parameters are missing, fall back to the smallest runnable command and fill them in (focus on `--project_id`, `--alert_id`).
32
- - If reading fails, first verify whether the object ID exists and belongs to the current project.
33
-
34
- ## Recommended Chaining
35
- - +get_alert
@@ -1,33 +0,0 @@
1
- # analysis +get_alert_definition_schema (Get Alert Definition Schema)
2
-
3
- > **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
4
-
5
- Domain: **Metadata queries**
6
-
7
- ## Use Cases
8
- - Helper tool positioning: this command provides structural definitions (schema) and should be used as a prerequisite step.
9
- - Recommended order: first use the current schema tool to get the structure, then call the specific business tool.
10
- - Typical follow-up tools: `+create_alert`, `+update_alert`
11
- - Get the alert definition schema. Returns field definitions, enum descriptions, and examples for creating or updating alerts.
12
- - Use this to understand the alert definition structure before calling create_alert or update_alert.
13
- - Do not use the schema response as an alert instance or query result; it only describes valid definition fields.
14
-
15
- ## Command
16
- ```bash
17
- ae-cli analysis +get_alert_definition_schema
18
- ae-cli analysis +get_alert_definition_schema --dry-run
19
- ```
20
-
21
- ## Parameters
22
- | Parameter | Required | Description |
23
- |---|---|---|
24
- | None | - | This command has no business parameters; call it directly. |
25
-
26
- ## Decision Rules
27
- - It is recommended to run `--dry-run` first to inspect the request body mapping before making the formal call.
28
-
29
- ## Next Steps on Failure
30
- - If reading fails, first verify whether the object ID exists and belongs to the current project.
31
-
32
- ## Recommended chaining
33
- - +get_alert_definition_schema
@@ -1,33 +0,0 @@
1
- # analysis_meta +get_project_config (Read Project Analysis Configuration)
2
-
3
- > **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
4
-
5
- Domain: **Project Configuration**
6
-
7
- ## Use Cases
8
- - Get project configuration details. Returns: projectId, projectName, companyId, defaultTimeZoneOffset (project default time zone offset), remark, timeZoneEnabled (whether multiple time zones are supported), timeZoneOffsetColumn (time zone column name in event data), and availableTimeZones (array of time zone offsets used in this project). Call this tool when you need project basic info or time zone configuration.
9
- - Get project configuration details.
10
- - Do not use it for project discovery or membership lookup; use `analysis_common +list_projects` or `+list_project_users` respectively.
11
-
12
- ## Command
13
- ```bash
14
- ae-cli analysis_meta +get_project_config --project_id <project_id>
15
- ae-cli analysis_meta +get_project_config --dry-run
16
- ```
17
-
18
- ## Parameters
19
- | Parameter | Required | Description |
20
- |---|---|---|
21
- | `--project_id` / `-p` | Yes | Project ID |
22
-
23
- ## Decision Rules
24
- - First run should only pass the required parameter (`--project_id`), and add optional parameters only after the path is confirmed to work.
25
- - `timeZoneEnabled` and `availableTimeZones` are often used to determine whether `zone_offset` can be passed to `create/update_cluster` and `create/update_tag`.
26
- - For cross-project troubleshooting, first confirm whether `--project_id` matches the current permissions and target environment.
27
-
28
- ## Next Steps After Failure
29
- - If the required parameter is missing, fall back to the smallest runnable command and fill it in (focus on `--project_id`).
30
- - If reading fails, first verify whether the object ID exists and belongs to the current project.
31
-
32
- ## Recommended Chaining
33
- - +get_project_config -> +create_project_mark_time / +update_project_mark_time
@@ -1,34 +0,0 @@
1
- # analysis_meta +get_track_program (Read Tracking Plan Baseline)
2
-
3
- > **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
4
-
5
- Domain: **Project Configuration**
6
-
7
- ## Use Cases
8
- - Query TRACKING-PLAN metadata (bury program), including planned events/properties/common properties. This is NOT system metadata. Do NOT use MetaTool/MetaPowerTool for these plan objects.
9
- - Query TRACKING-PLAN metadata (bury program), including planned events/properties/common properties.
10
-
11
- ## Output
12
- Returns the current plan content. An empty plan permits first-time generation; a non-empty result must be reviewed before any merge-generating operation.
13
-
14
- ## Commands
15
- ```bash
16
- ae-cli analysis_meta +get_track_program --project_id <project_id>
17
- ae-cli analysis_meta +get_track_program --dry-run
18
- ```
19
-
20
- ## Parameters
21
- | Parameter | Required | Description |
22
- |---|---|---|
23
- | `--project_id` / `-p` | Yes | Project ID |
24
-
25
- ## Decision Rules
26
- - For the first run, pass only the required parameter (`--project_id`) to confirm the path works, then add optional parameters.
27
- - For cross-project troubleshooting, first confirm whether `--project_id` matches the current permissions and target environment.
28
-
29
- ## Next Steps After Failure
30
- - If required parameters are missing, fall back to the smallest runnable command and fill them in first (focus on `--project_id`).
31
- - If reading fails, first verify that the object ID exists and belongs to the current project.
32
-
33
- ## Recommended Chaining
34
- - +get_project_config -> +get_track_program
@@ -1,41 +0,0 @@
1
- # analysis +list_alerts (alert strategy search)
2
-
3
- > **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
4
-
5
- Domain: **Metadata Lookup**
6
-
7
- ## Constraints
8
-
9
- **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).
10
-
11
- ## Use Cases
12
- - List all alerts in the project. Supports keyword filtering by alert name. Returns a paginated list containing alerts array and pager result with total count.
13
- - List all alerts in the project.
14
- - Do not use it for alert result data or one known alert's complete definition; use `+get_alert` after resolving the ID.
15
-
16
- ## Commands
17
- ```bash
18
- ae-cli analysis +list_alerts --project_id <project_id>
19
- ae-cli analysis +list_alerts --project_id <project_id> --query demo
20
- ae-cli analysis +list_alerts --project_id <project_id> --limit 50 --offset 0
21
- ae-cli analysis +list_alerts --dry-run
22
- ```
23
-
24
- ## Parameters
25
- | Parameter | Required | Description |
26
- |---|---|---|
27
- | `--project_id` / `-p` | Yes | Project ID |
28
- | `--query` / `-q` | No | Optional keyword filter. Performs fuzzy matching against alert names; if omitted, all alerts are returned. |
29
- | `--limit` / `-l` | No | Optional page size. Default: 50, maximum: 200. |
30
- | `--offset` / `-o` | No | Optional page offset. Default: 0. |
31
-
32
- ## Decision Rules
33
- - For the first run, it is recommended to pass only the required parameters (`--project_id`) and add optional parameters after confirming the chain works.
34
- - For cross-project troubleshooting, first confirm whether `--project_id` matches the current permissions and target environment.
35
-
36
- ## Next Step After Failure
37
- - If required parameters are missing, fall back to the smallest runnable command and fill them in (focus on `--project_id`).
38
- - If the result is empty, first confirm the project ID/keyword, then try broadening the filter conditions.
39
-
40
- ## Recommended Chaining
41
- - +list_alerts
@@ -1,42 +0,0 @@
1
- # analysis_meta +list_entities (Entity Search)
2
-
3
- > **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
4
-
5
- Domain: **Entity Query**
6
-
7
- ## Use Cases
8
- - List entities in the project. Returns entity details such as entity ID, name, column name, column description, and type. Can be filtered by event name.
9
- - List entities in the project.
10
- - Do not use it to list user members or event rows; it returns entity metadata only.
11
-
12
- ## Command
13
- ```bash
14
- ae-cli analysis_meta +list_entities --project_id <project_id>
15
- ae-cli analysis_meta +list_entities --project_id <project_id> --query demo
16
- ae-cli analysis_meta +list_entities --project_id <project_id> --event_name demo
17
- ae-cli analysis_meta +list_entities --project_id <project_id> --fields '["entityId", "entityName", "columnName", "columnDesc", "selectType"]' --limit 50 --offset 0
18
- ae-cli analysis_meta +list_entities --dry-run
19
- ```
20
-
21
- ## Parameters
22
- | Parameter | Required | Description |
23
- |---|---|---|
24
- | `--project_id` / `-p` | Yes | Project ID |
25
- | `--event_name` | No | Optional event name filter |
26
- | `--query` / `-q` | No | Optional keyword filter. Fuzzy match is applied to entityName, columnName, and columnDesc; if omitted, all accessible dashboards are returned. |
27
- | `--fields` / `-f` | No | Optional fields to return (JSON array). Supported fields: `entityId`, `entityName`, `columnName`, `columnDesc`, `selectType`, `tableType`, `entityType`. Default fields when omitted: `entityId`, `entityName`, `columnName`, `columnDesc`, `selectType`. Entity metadata exposes `columnDesc` as the description field; no remark field is available in this list response. |
28
- | `--limit` / `-l` | No | Optional page size. Default: 50, maximum: 200. |
29
- | `--offset` / `-o` | No | Optional page offset. Default: 0. |
30
-
31
-
32
- ## Decision Rules
33
- - First run should only pass the required parameter (`--project_id`), and add optional parameters only after the path is confirmed to work.
34
- - `--event_name` is used to filter entities by event name, not for keyword search.
35
- - For cross-project troubleshooting, first confirm whether `--project_id` matches the current permissions and target environment.
36
-
37
- ## Next Steps After Failure
38
- - If the required parameter is missing, fall back to the smallest runnable command and fill it in (focus on `--project_id`).
39
- - If the result is empty, first confirm the project ID/keyword, then try loosening the filter conditions.
40
-
41
- ## Recommended Chaining
42
- - +list_entities -> analysis-meta virtual-property create / analysis-meta virtual-event create
@@ -1,43 +0,0 @@
1
- # analysis_meta +list_project_mark_times (List Project Mark Times)
2
-
3
- > **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
4
-
5
- Domain: **Project Configuration**
6
-
7
- ## Use Cases
8
- - List project date markers. Returns marker IDs, timestamps, content, and visibility status.
9
- - Supports pagination with fields/limit/offset for payload governance.
10
- - Query performs fuzzy matching on markContent.
11
- - Do not use it for report time ranges or event timestamps; this command only lists project date markers.
12
-
13
- ## Commands
14
- ```bash
15
- ae-cli analysis_meta +list_project_mark_times --project_id <project_id>
16
- ae-cli analysis_meta +list_project_mark_times --project_id <project_id> --zone_offset 8
17
- ae-cli analysis_meta +list_project_mark_times --project_id <project_id> --query demo --fields '["id","markTime","markContent"]' --limit 10 --offset 0
18
- ae-cli analysis_meta +list_project_mark_times --dry-run
19
- ```
20
-
21
- ## Parameters
22
- | Parameter | Required | Description |
23
- |---|---|---|
24
- | `--project_id` / `-p` | Yes | Project ID |
25
- | `--zone_offset` | No | Marker time zone offset |
26
- | `--query` / `-q` | No | Optional keyword filter. Fuzzy match on markContent. |
27
- | `--fields` | No | Optional fields to return. Supported: id, projectId, markTime, userZoneTime, zoneOffset, markContent, isShow, creatorName, creatorId, lastModifierName, lastModifierId, createTime, updateTime. Invalid fields cause INVALID_FIELDS error. |
28
- | `--limit` | No | Optional limit. Default: 50, maximum: 200. |
29
- | `--offset` | No | Optional offset. Default: 0. |
30
-
31
- ## Decision Rules
32
- - For the first run, pass only the required parameter (`--project_id`) to confirm the path works, then add optional parameters.
33
- - For pagination, use `--limit` and `--offset` together. Default limit is 20.
34
- - Use `--fields` to select specific columns for lighter response payloads.
35
- - For cross-project troubleshooting, first confirm whether `--project_id` matches the current permissions and target environment.
36
-
37
- ## Next Steps After Failure
38
- - If required parameters are missing, fall back to the smallest runnable command and fill them in first (focus on `--project_id`).
39
- - If the result is empty, first confirm the project ID/keyword, then try loosening the filter conditions.
40
- - If INVALID_FIELDS error appears, check that all field names in `--fields` match the supported list.
41
-
42
- ## Recommended Chaining
43
- - +get_project_config -> +list_project_mark_times
@@ -1,33 +0,0 @@
1
- # analysis_meta +list_project_users (Read Project Member List)
2
-
3
- > **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
4
-
5
- Domain: **Project Configuration**
6
-
7
- ## Use Cases
8
- - Get all project members. Returns userId, loginName, and userName for each member. Use this to resolve userId when managing dashboard share members.
9
- - Get all project members.
10
- - Do not use it as an organization-wide people search or as proof of resource-level authority; it lists project membership only.
11
-
12
- ## Command
13
- ```bash
14
- ae-cli analysis_meta +list_project_users --project_id <project_id>
15
- ae-cli analysis_meta +list_project_users --dry-run
16
- ```
17
-
18
- ## Parameters
19
- | Parameter | Required | Description |
20
- |---|---|---|
21
- | `--project_id` / `-p` | Yes | Project ID |
22
-
23
- ## Decision Rules
24
- - First run should only pass the required parameter (`--project_id`), and add optional parameters only after the path is confirmed to work.
25
- - The result can be used for dashboard member configuration, permission mapping, and similar scenarios.
26
- - For cross-project troubleshooting, first confirm whether `--project_id` matches the current permissions and target environment.
27
-
28
- ## Next Steps After Failure
29
- - If the required parameter is missing, fall back to the smallest runnable command and fill it in (focus on `--project_id`).
30
- - If the result is empty, first confirm the project ID/keyword, then try loosening the filter conditions.
31
-
32
- ## Recommended Chaining
33
- - +get_project_config -> +list_project_users
@@ -1,39 +0,0 @@
1
- # analysis_common +list_projects (view projects accessible to the current user)
2
-
3
- > **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
4
-
5
- Domain: **project discovery / cross-module pre-query**
6
-
7
- ## Use Cases
8
- - List all projects accessible to the current user. No parameters are required.
9
- - Returns a list of project summaries; key fields include: `projectId`, `projectName`, `companyId`, `projectType`, `remark`, `appId`, `roleName`.
10
-
11
- ## Mandatory Rules (MUST)
12
- - This command does not accept any business parameters; do not invent `project_id`, keywords, or pagination parameters.
13
- - If a later target command requires `project_id`, `+list_projects` is used for first-time project discovery, new project verification, project switching, or ambiguity resolution. Do not call it repeatedly when the same continuous conversation already has a verified project context for the same host/environment.
14
- - In the final response, prioritize the returned `projectId`, `projectName`, and `roleName` to help the user confirm the project.
15
-
16
- ## Command
17
- ```bash
18
- ae-cli analysis_common +list_projects
19
- ae-cli analysis_common +list_projects --dry-run
20
- ```
21
-
22
- ## Parameters
23
- | Parameter | Required | Description |
24
- |---|---|---|
25
- | None | - | No business parameters required |
26
-
27
- ## Decision Rules
28
- - When the user says "let me see what projects I have", "list the available projects first", or "I don't know project_id", call this command first.
29
- - When a later command depends on `project_id` and there is no verified project context, show candidate projects first, then ask the user to explicitly confirm the target `projectId`.
30
- - When the same continuous conversation already has a verified `project_id` for the same host/environment, reuse it directly and do not call `+list_projects` again unless the user switches projects, switches host/environment, asks to list projects, or the current project context becomes ambiguous.
31
- - If there are many projects returned, prioritize summarizing by `projectName`, `projectId`, and `roleName` to avoid expanding all low-value fields at once.
32
-
33
- ## Next Step on Failure
34
- - If the result is empty, first confirm whether the current account, environment, and permissions are correct.
35
- - If the call fails, first check the authentication status, the target environment host, and the current login identity.
36
-
37
- ## Recommended Chaining
38
- - First use: `+list_projects` -> user confirms `project_id` -> any command that requires `project_id`
39
- - Follow-up use in the same verified context: reuse confirmed `project_id` -> target command
@@ -1,47 +0,0 @@
1
- # analysis +load_filters (load filter candidate values)
2
-
3
- > **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
4
-
5
- Domain: **Model Analysis**
6
-
7
- ## Use Cases
8
- - Load candidate values for a property. Queries the available enum values of the specified property (quot), which is useful when building filter conditions.
9
- - tableType values:
10
- - event: event property
11
- - user: user property
12
- - clusterDatePolicy is only used when tableType=user and user clusters are involved. Supported values: LATEST, AUTO, SPECIFIED.
13
- - Load candidate values for a property.
14
-
15
- ## Output
16
- Returns candidate values for the requested property and scope. Treat the list as selectable values, not as aggregated counts or analysis results.
17
-
18
- ## Commands
19
- ```bash
20
- ae-cli analysis +load_filters --project_id <project_id> --quot demo --table_type event
21
- ae-cli analysis +load_filters --project_id <project_id> --quot demo --table_type event --event_name demo --inputdata demo --zone_offset 8 --cluster_date_policy SPECIFIED --specified_cluster_date 2026-04-08 --is_report true
22
- ae-cli analysis +load_filters --dry-run
23
- ```
24
-
25
- ## Parameters
26
- | Parameter | Required | Description |
27
- |---|---|---|
28
- | `--project_id` / `-p` | Yes | Project ID |
29
- | `--quot` | Yes | Property identifier (field name). This is the property whose candidate values will be loaded. |
30
- | `--table_type` | Yes | Table type: event for event properties, user for user properties |
31
- | `--event_name` | No | Optional event name. When tableType=event, this can limit the query scope to a specific event. |
32
- | `--inputdata` | No | Optional input prefix used for fuzzy filtering of candidate values. If omitted, all candidate values are returned. |
33
- | `--zone_offset` | No | Time zone offset in hours. For example, UTC+8 is 8 |
34
- | `--cluster_date_policy` | No | Cluster date policy: LATEST, AUTO, or SPECIFIED |
35
- | `--specified_cluster_date` | No | Specified cluster date in yyyy-MM-dd format. Effective only when clusterDatePolicy=SPECIFIED. |
36
- | `--is_report` | No | Whether this is report mode. Default: false |
37
-
38
- ## Decision Rules
39
- - For the first run, it is recommended to pass only the required parameters (`--project_id`, `--quot`, `--table_type`) and add optional parameters after confirming the chain works.
40
- - When dates/time ranges are involved, validate with a short range first and then expand gradually.
41
- - For cross-project troubleshooting, first confirm whether `--project_id` matches the current permissions and target environment.
42
-
43
- ## Next Step After Failure
44
- - If required parameters are missing, fall back to the smallest runnable command and fill them in (focus on `--project_id`, `--quot`, `--table_type`).
45
-
46
- ## Recommended Chaining
47
- - +load_filters
@@ -1,37 +0,0 @@
1
- # analysis_meta +save_track_items (Save Track Program Items)
2
-
3
- > **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
4
-
5
- Domain: **Project Configuration**
6
-
7
- ## Use Cases
8
- - Create/update TRACKING-PLAN metadata only (planned bury items). Do not use this tool to create or edit effective system metadata. If the user intent is production metadata changes, route to MetaPowerTool instead.
9
- - Create/update TRACKING-PLAN metadata only (planned bury items).
10
-
11
- ## Output
12
- The response reports persistence of the submitted tracking-plan items. Read the plan back with `+get_track_program` before claiming the saved structure is effective.
13
-
14
- ## Command
15
- ```bash
16
- ae-cli analysis_meta +save_track_items --project_id <project_id> --track_data '{}'
17
- ae-cli analysis_meta +save_track_items --dry-run
18
- ```
19
-
20
- ## Parameters
21
- | Parameter | Required | Description |
22
- |---|---|---|
23
- | `--project_id` / `-p` | Yes | Project ID |
24
- | `--track_data` | Yes | Track program JSON object. Example: {"events":[{"eventName":"purchase","displayName":"Purchase","eventDesc":"User purchases a product","eventTag":"eCommerce","dataOrigin":"APP","props":["item_id","price"]}],"eventProps":[{"name":"price","displayName":"Price","type":"number","desc":"Product price"}],"userProps":[{"name":"vip_level","displayName":"Membership Level","type":"string","updateType":"user_set","propTag":"Membership","desc":"User membership level"}],"commonEventProps":[{"name":"platform","displayName":"Platform","type":"string","desc":"Application platform"}]}. Required fields: eventName/name and type. type values: string, number, datetime, bool, array_string, row, array_row. updateType values: user_setOnce, user_set, user_add, user_append. Constraints: eventName/name max 64 chars (letters, digits, underscore), displayName max 60 chars, desc/eventDesc max 200 chars. |
25
-
26
- ## Decision Rules
27
- - First run should only pass the required parameters (`--project_id`, `--track_data`), and add optional parameters only after the path is confirmed to work.
28
- - Wrap JSON arguments in single quotes (for example `--track_data '{}'`) to avoid shell escaping issues.
29
- - For cross-project troubleshooting, first confirm whether `--project_id` matches the current permissions and target environment.
30
- - This is an ordinary `write` operation and does not require CLI confirmation.
31
-
32
- ## Next Steps After Failure
33
- - If required parameters are missing, fall back to the smallest runnable command and fill them in (focus on `--project_id` and `--track_data`).
34
- - If `Invalid JSON` occurs, validate with the smallest JSON structure first (for example `{}` or `[]`), then add fields step by step.
35
-
36
- ## Recommended Chaining
37
- - +get_track_program -> +save_track_items -> +get_track_program