@thinkingai/ae-cli 6.0.33 → 6.0.35

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 (167) hide show
  1. package/README.md +3 -2
  2. package/README.zh.md +3 -2
  3. package/dist/index.js +24 -16
  4. package/dist/{metadata-W2MEOI4Z.js → metadata-ELUAR3EJ.js} +0 -53
  5. package/dist/{metadata-3M5F2AED.js → metadata-P5GIVMZ6.js} +0 -53
  6. package/dist/{te-agent-K2OWMZXT.js → te-agent-BOQ7ZY56.js} +194 -1
  7. package/dist/{te-analysis-Q7AZCDU4.js → te-analysis-HZIP6SYW.js} +446 -562
  8. package/dist/{te-analysis-I73ZS4NK.js → te-analysis-ZT2MYAHL.js} +446 -562
  9. package/dist/{te-dataops-MJV54MNY.js → te-dataops-VYN3IOKO.js} +6 -6
  10. package/dist/{te-dataops-OA7I6HBG.js → te-dataops-Y5QAPPPF.js} +6 -6
  11. package/dist/{te-engage-GJRVQMK3.js → te-engage-2FSDUOIZ.js} +965 -1578
  12. package/dist/{te-engage-JIXX3WBI.js → te-engage-BMJ6UOUU.js} +965 -1578
  13. package/dist/{te-kb-CIZXRWMO.js → te-kb-E7NSCBRB.js} +25 -6
  14. package/dist/te-meta-GBDTMPEL.js +95 -0
  15. package/dist/te-meta-ZTLTSHXC.js +95 -0
  16. package/package.json +5 -4
  17. package/skills/ae-agent/SKILL.md +5 -1
  18. package/skills/ae-agent/references/list-sandbox-tools.md +79 -0
  19. package/skills/ae-analysis/SKILL.md +8 -9
  20. package/skills/ae-analysis/references/adhoc_export.md +8 -0
  21. package/skills/ae-analysis/references/adhoc_run.md +9 -0
  22. package/skills/ae-analysis/references/ai_models.md +3 -1
  23. package/skills/ae-analysis/references/analysis_data_retrieval.md +2 -0
  24. package/skills/ae-analysis/references/analysis_drilldown_contract.md +2 -0
  25. package/skills/ae-analysis/references/analysis_gateway_assets.md +9 -7
  26. package/skills/ae-analysis/references/command_index.md +18 -40
  27. package/skills/ae-analysis/references/dashboard_report_data_export.md +4 -2
  28. package/skills/ae-analysis/references/dashboard_report_data_run.md +5 -3
  29. package/skills/ae-analysis/references/drilldown_entities_export.md +3 -0
  30. package/skills/ae-analysis/references/drilldown_entities_run.md +2 -1
  31. package/skills/ae-analysis/references/drilldown_events_export.md +3 -0
  32. package/skills/ae-analysis/references/drilldown_events_run.md +2 -1
  33. package/skills/ae-analysis/references/drilldown_user_events_export.md +3 -0
  34. package/skills/ae-analysis/references/drilldown_user_events_run.md +2 -0
  35. package/skills/ae-analysis/references/entity_id_import_options.md +1 -1
  36. package/skills/ae-analysis/references/filter_value_list.md +47 -0
  37. package/skills/ae-analysis/references/project_space_get.md +3 -3
  38. package/skills/ae-analysis/references/project_space_list.md +6 -2
  39. package/skills/ae-analysis/references/query_cancel.md +3 -1
  40. package/skills/ae-analysis/references/query_cluster_list.md +34 -0
  41. package/skills/ae-analysis/references/query_create_result_cluster.md +2 -0
  42. package/skills/ae-analysis/references/report_create.md +5 -1
  43. package/skills/ae-analysis/references/report_data_export.md +9 -2
  44. package/skills/ae-analysis/references/report_data_run.md +8 -3
  45. package/skills/ae-analysis/references/report_get.md +3 -1
  46. package/skills/ae-analysis/references/report_update.md +4 -0
  47. package/skills/ae-analysis/references/virtual_event_create.md +7 -6
  48. package/skills/ae-analysis-global/SKILL.md +15 -32
  49. package/skills/ae-community/SKILL.md +1 -1
  50. package/skills/ae-data-integration-helper/SKILL.md +3 -2
  51. package/skills/ae-data-integration-helper/references/sdk_usage_notes.md +1 -1
  52. package/skills/ae-dataops/SKILL.md +2 -1
  53. package/skills/ae-dataops/references/dataops-integration.md +75 -6
  54. package/skills/ae-engage/SKILL.md +127 -104
  55. package/skills/ae-engage/references/activity-activity-type.md +1 -1
  56. package/skills/ae-engage/references/activity-activity.md +1 -1
  57. package/skills/ae-engage/references/activity-approval.md +5 -7
  58. package/skills/ae-engage/references/activity-task.md +12 -18
  59. package/skills/ae-engage/references/activity-topic.md +39 -22
  60. package/skills/ae-engage/references/add-approver.md +4 -4
  61. package/skills/ae-engage/references/add-channel.md +10 -5
  62. package/skills/ae-engage/references/approval-approver-delete.md +1 -1
  63. package/skills/ae-engage/references/approver-list.md +4 -4
  64. package/skills/ae-engage/references/build-task-save-guide.md +13 -13
  65. package/skills/ae-engage/references/cancel-query-by-request-id.md +7 -6
  66. package/skills/ae-engage/references/channel-detail.md +14 -9
  67. package/skills/ae-engage/references/channel-list.md +15 -10
  68. package/skills/ae-engage/references/channel-mgmt.md +109 -0
  69. package/skills/ae-engage/references/channel-test-send.md +1 -1
  70. package/skills/ae-engage/references/channel-update-config.md +1 -1
  71. package/skills/ae-engage/references/channel_touch_limits_list.md +1 -1
  72. package/skills/ae-engage/references/client-param.md +34 -16
  73. package/skills/ae-engage/references/common-metric.md +85 -18
  74. package/skills/ae-engage/references/config-item-analysis-report.md +8 -27
  75. package/skills/ae-engage/references/config-item-strategy-comparison.md +7 -18
  76. package/skills/ae-engage/references/config-item-trigger-report.md +8 -35
  77. package/skills/ae-engage/references/delete-channel.md +5 -5
  78. package/skills/ae-engage/references/delete-flow.md +5 -5
  79. package/skills/ae-engage/references/flow-ab-split-node-report.md +11 -45
  80. package/skills/ae-engage/references/flow-detail.md +15 -10
  81. package/skills/ae-engage/references/flow-list.md +9 -4
  82. package/skills/ae-engage/references/flow-node-config-schema.md +9 -8
  83. package/skills/ae-engage/references/flow-node-detail-report.md +11 -46
  84. package/skills/ae-engage/references/flow-node-overview-report.md +11 -43
  85. package/skills/ae-engage/references/flow-process-report.md +12 -50
  86. package/skills/ae-engage/references/flow-update-remark.md +19 -0
  87. package/skills/ae-engage/references/manage-flow.md +19 -19
  88. package/skills/ae-engage/references/manage-task.md +5 -5
  89. package/skills/ae-engage/references/modify-flow-base-info.md +8 -8
  90. package/skills/ae-engage/references/preset-event.md +1 -1
  91. package/skills/ae-engage/references/push-language.md +1 -1
  92. package/skills/ae-engage/references/save-flow.md +54 -52
  93. package/skills/ae-engage/references/save-task.md +23 -17
  94. package/skills/ae-engage/references/scene-config-channel.md +90 -10
  95. package/skills/ae-engage/references/scene-config-group.md +1 -1
  96. package/skills/ae-engage/references/scene-config-item.md +27 -4
  97. package/skills/ae-engage/references/scene-config-metric.md +1 -1
  98. package/skills/ae-engage/references/scene-config-param.md +2 -2
  99. package/skills/ae-engage/references/scene-preset-metric.md +1 -1
  100. package/skills/ae-engage/references/scene-strategy.md +19 -3
  101. package/skills/ae-engage/references/scene-template.md +10 -4
  102. package/skills/ae-engage/references/task-data-detail.md +5 -67
  103. package/skills/ae-engage/references/task-data-overview.md +5 -35
  104. package/skills/ae-engage/references/task-detail.md +5 -5
  105. package/skills/ae-engage/references/task-experiment-report.md +5 -38
  106. package/skills/ae-engage/references/task-list.md +4 -4
  107. package/skills/ae-engage/references/task-metric-detail.md +5 -43
  108. package/skills/ae-engage/references/task-stats.md +5 -5
  109. package/skills/ae-engage/references/update-channel-status.md +6 -6
  110. package/skills/ae-engage/references/validate-flow-node-config.md +12 -11
  111. package/skills/ae-engage/references/whitelist-list.md +4 -4
  112. package/skills/ae-engage/references/whitelist.md +1 -1
  113. package/skills/ae-engage/references/workbench-workbench.md +1 -1
  114. package/skills/ae-generate-tracking-code/SKILL.md +4 -3
  115. package/skills/ae-generate-tracking-code/references/client-sdk-insert.md +1 -1
  116. package/skills/ae-generate-tracking-code/references/server-sdk-insert.md +1 -1
  117. package/skills/ae-generate-tracking-code/references/snippet-delivery.md +1 -1
  118. package/skills/ae-generate-tracking-plan/SKILL.md +6 -2
  119. package/skills/ae-kb/SKILL.md +9 -5
  120. package/skills/ae-metadata/SKILL.md +8 -15
  121. package/skills/ae-metadata/references/metadata_property_dimension_table_bind_existing.md +1 -1
  122. package/dist/te-common-ST3QPSXJ.js +0 -61
  123. package/dist/te-common-WSLIKKPC.js +0 -61
  124. package/dist/te-meta-Q4L6EE3Q.js +0 -363
  125. package/dist/te-meta-VHCN4Q62.js +0 -363
  126. package/skills/ae-analysis/references/batch_create_metadata.md +0 -41
  127. package/skills/ae-analysis/references/batch_edit_metadata.md +0 -39
  128. package/skills/ae-analysis/references/cancel_query.md +0 -38
  129. package/skills/ae-analysis/references/create_alert.md +0 -47
  130. package/skills/ae-analysis/references/create_entity.md +0 -39
  131. package/skills/ae-analysis/references/create_project_mark_time.md +0 -39
  132. package/skills/ae-analysis/references/delete_alert.md +0 -32
  133. package/skills/ae-analysis/references/delete_project_mark_times.md +0 -36
  134. package/skills/ae-analysis/references/delete_track_items.md +0 -36
  135. package/skills/ae-analysis/references/generate_track_program.md +0 -52
  136. package/skills/ae-analysis/references/generate_track_sdk_sample.md +0 -44
  137. package/skills/ae-analysis/references/get_alert.md +0 -35
  138. package/skills/ae-analysis/references/get_alert_definition_schema.md +0 -33
  139. package/skills/ae-analysis/references/get_project_config.md +0 -33
  140. package/skills/ae-analysis/references/get_track_program.md +0 -34
  141. package/skills/ae-analysis/references/list_alerts.md +0 -41
  142. package/skills/ae-analysis/references/list_entities.md +0 -42
  143. package/skills/ae-analysis/references/list_project_mark_times.md +0 -43
  144. package/skills/ae-analysis/references/list_project_users.md +0 -33
  145. package/skills/ae-analysis/references/list_projects.md +0 -39
  146. package/skills/ae-analysis/references/load_filters.md +0 -47
  147. package/skills/ae-analysis/references/save_track_items.md +0 -37
  148. package/skills/ae-analysis/references/update_alert.md +0 -49
  149. package/skills/ae-analysis/references/update_project_mark_time.md +0 -40
  150. package/skills/ae-analysis-global/references/list_query_clusters.md +0 -68
  151. package/skills/ae-engage/references/config-channel-detail.md +0 -31
  152. package/skills/ae-engage/references/config-channel-list.md +0 -26
  153. package/skills/ae-engage/references/config-item-detail.md +0 -29
  154. package/skills/ae-engage/references/config-item-list.md +0 -18
  155. package/skills/ae-engage/references/copy-config-template.md +0 -28
  156. package/skills/ae-engage/references/delete-config-channel.md +0 -23
  157. package/skills/ae-engage/references/delete-config-item.md +0 -24
  158. package/skills/ae-engage/references/engage-scene-config-item.md +0 -69
  159. package/skills/ae-engage/references/manage-strategy.md +0 -73
  160. package/skills/ae-engage/references/strategy-detail.md +0 -72
  161. package/skills/ae-engage/references/strategy-list.md +0 -20
  162. package/skills/ae-engage/references/update-config-channel-status.md +0 -31
  163. package/skills/ae-metadata/references/metadata_event_get.md +0 -52
  164. package/skills/ae-metadata/references/metadata_property_get.md +0 -54
  165. package/dist/{config-RCCGHHYA.js → config-PMPISN5Y.js} +4 -4
  166. package/dist/{te-community-WXGB6IOX.js → te-community-QOYIYEJI.js} +3 -3
  167. package/dist/{te-community-X2AHXGCA.js → te-community-UFKI6ONP.js} +3 -3
@@ -1,49 +0,0 @@
1
- # analysis +update_alert (Update Alert)
2
-
3
- > **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
4
-
5
- Domain: **Metadata queries**
6
-
7
- ## Use Cases
8
- - Precondition helper: call `+get_alert_definition_schema` to get the structure before using this tool.
9
- - Update an existing alert. All fields in the definition will replace existing values. See get_alert_definition_schema for the parameter structure.
10
- - Update an existing alert.
11
-
12
- ## Mandatory prerequisites (MUST)
13
- - Before constructing a new `--definition`, you must first read and follow:
14
- - [`./get_alert_definition_schema.md`](./get_alert_definition_schema.md)
15
- - Do not submit the new `definition` until the documentation review and schema call are complete.
16
-
17
- ## Prerequisite call chain (required for updating definition)
18
- 1. Read `get_alert_definition_schema.md` to understand the return structure of `+get_alert_definition_schema`.
19
- 2. Call `ae-cli analysis +get_alert_definition_schema` to get the schema.
20
- 3. Build a new `definition` from the schema, then call `+update_alert`.
21
-
22
- ## Command
23
- ```bash
24
- ae-cli analysis +update_alert --project_id <project_id> --alert_id 1 --definition '{}'
25
- ae-cli analysis +update_alert --dry-run
26
- ```
27
-
28
- ## Parameters
29
- | Parameter | Required | Description |
30
- |---|---|---|
31
- | `--project_id` / `-p` | Yes | Project ID |
32
- | `--alert_id` / `-a` | Yes | Alert ID to update |
33
- | `--definition` | Yes | Alert definition JSON with updated fields. MUST call `+get_alert_definition_schema` first and strictly follow the returned structure. |
34
-
35
- ## Decision Rules
36
- - `definition` cannot be written from experience alone: it must satisfy the alert schema structure constraints.
37
- - On the first run, start with only the required parameters (`--project_id`, `--alert_id`, `--definition`) and add optional parameters after confirming the path works.
38
- - Wrap JSON parameters in single quotes (for example `--definition '{}'`) to avoid shell escaping issues.
39
- - For cross-project troubleshooting, first confirm whether `--project_id` matches the current permissions and target environment.
40
- - This is an ordinary `write` operation and does not require CLI confirmation.
41
-
42
- ## Next Steps on Failure
43
- - If required parameters are missing, fall back to the smallest runnable command and fill them in first (focus on `--project_id`, `--alert_id`, `--definition`).
44
- - If `Invalid JSON` appears, first check the schema required fields and enumeration values, then add fields incrementally.
45
- - If the result after writing does not match expectations, immediately read back the corresponding list/get interface to compare before and after.
46
-
47
- ## Recommended chaining
48
- - +get_alert_definition_schema -> +update_alert
49
- - +list_alerts -> +get_alert -> +update_alert
@@ -1,40 +0,0 @@
1
- # analysis_meta +update_project_mark_time (Update Project Date Marker)
2
-
3
- > **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
4
-
5
- Domain: **Project Configuration**
6
-
7
- ## Use Cases
8
- - Update an existing project date marker. Returns the updated marker ID, timestamp, content, and visibility status.
9
- - Update an existing project date marker.
10
- - Do not use it to create a marker or change analysis data; use `+create_project_mark_time` for a new marker.
11
-
12
- ## Command
13
- ```bash
14
- ae-cli analysis_meta +update_project_mark_time --mark_time_id 1 --project_id <project_id> --marked_at '2026-04-09 10:00' --content demo
15
- ae-cli analysis_meta +update_project_mark_time --mark_time_id 1 --project_id <project_id> --marked_at '2026-04-09 10:00' --zone_offset 8 --content demo --is_visible 1
16
- ae-cli analysis_meta +update_project_mark_time --dry-run
17
- ```
18
-
19
- ## Parameters
20
- | Parameter | Required | Description |
21
- |---|---|---|
22
- | `--mark_time_id` | Yes | Marker ID |
23
- | `--project_id` / `-p` | Yes | Project ID |
24
- | `--marked_at` | Yes | Marker timestamp. Format: yyyy-MM-dd HH:mm |
25
- | `--zone_offset` | No | Marker time zone offset |
26
- | `--content` | Yes | Marker content |
27
- | `--is_visible` | No | Whether the marker is visible. Default: 1 |
28
-
29
- ## Decision Rules
30
- - The smallest valid request also includes required `--content`; use `--dry-run` with `--mark_time_id`, `--project_id`, `--marked_at`, and `--content` before executing.
31
- - For date/time ranges, first validate with a short range, then expand the range step by step.
32
- - For cross-project troubleshooting, first confirm whether `--project_id` matches the current permissions and target environment.
33
- - This is an ordinary `write` operation and does not require CLI confirmation.
34
-
35
- ## Next Steps After Failure
36
- - If required parameters are missing, supply `--mark_time_id`, `--project_id`, `--marked_at`, and `--content` before retrying.
37
- - If the result after writing is not as expected, immediately read back the corresponding list/get interface for a before-and-after comparison.
38
-
39
- ## Recommended Chaining
40
- - +list_project_mark_times -> +update_project_mark_time
@@ -1,68 +0,0 @@
1
- # analysis +list_query_clusters (Query Cluster Options)
2
-
3
- > **Prerequisite:** Use this reference only after `ae-analysis-global` confirms local multi-cluster mode is enabled. This command is added by the global overlay, not by the base `ae-analysis` skill.
4
-
5
- Domain: **Multi-Cluster Query Routing**
6
-
7
- ## Use Cases
8
-
9
- - List the query cluster options accessible to the current account in the project.
10
- - Answer user questions such as "cluster info", "available query clusters", or "current cluster". Localized examples include "集群信息" and "有哪些集群".
11
- - Decide whether a later report/dashboard/ad-hoc query should use the current self cluster, global aggregated data, or one specific slave cluster.
12
- - Resolve country, region, game server, service shard, site, market, or deployment area wording to an accessible slave cluster before passing `cluster_query_scope=SLAVE`.
13
-
14
- This command is not for audience/user segment clusters. For cohort, audience, or segment assets, use `analysis user-cluster list`.
15
-
16
- ## Commands
17
-
18
- ```bash
19
- ae-cli analysis +list_query_clusters --project_id <project_id>
20
- ae-cli analysis +list_query_clusters --dry-run
21
- ```
22
-
23
- ## Parameters
24
-
25
- | Parameter | Required | Description |
26
- |---|---|---|
27
- | `--project_id` / `-p` | Yes | Project ID used to resolve the current account's cluster query permissions. |
28
-
29
- ## Output Shape
30
-
31
- The result data follows the server DTO used by `list_query_clusters`:
32
-
33
- | Field | Description |
34
- |---|---|
35
- | `globalQueryEnabled` | Whether global query is enabled by server config. |
36
- | `currentCluster` | The current self query cluster. Fields: `clusterId`, `clusterName`, `clusterDesc`. |
37
- | `slaveClusters` | Accessible slave query clusters for this account and project. Each item has `clusterId`, `clusterName`, `clusterDesc`. |
38
- | `permissions` | Permission summary for choosing query scope. |
39
- | `permissions.canQueryCurrent` | Whether the user can query the current self cluster. Usually true. |
40
- | `permissions.canQueryGlobal` | Whether `cluster_query_scope=GLOBAL` is allowed. |
41
- | `permissions.canQueryAllSlaveClusters` | Whether any enabled slave cluster may be queried. |
42
- | `permissions.allowedSlaveClusterIds` | Slave cluster IDs this account may use. |
43
- | `permissions.allowedClusterQueryParams` | Human-readable allowed query parameter combinations, e.g. `omit clusterQueryScope`, `clusterQueryScope=GLOBAL`, or `clusterQueryScope=SLAVE, slaveClusterId in [...]`. |
44
-
45
- ## Decision Rules
46
-
47
- - For query-cluster inventory or cluster-info questions, call this command and answer with "query clusters", not "audience clusters".
48
- - Default query behavior is to omit `cluster_query_scope`, which queries the current self cluster or follows the tool-specific default.
49
- - Pass `--cluster_query_scope GLOBAL` only when the user clearly asks for global, all clusters, all servers, cross-cluster aggregation, or equivalent aggregate wording, and `permissions.canQueryGlobal=true`.
50
- - Pass `--cluster_query_scope SLAVE --slave_cluster_id <clusterId>` only after this command confirms a requested country, region, server, site, market, or deployment maps to an accessible `slaveClusters[]` item.
51
- - Match slave intent only against `slaveClusters[].clusterId`, `slaveClusters[].clusterName`, and `slaveClusters[].clusterDesc`.
52
- - If the requested scope is not allowed, do not guess forbidden parameters. Explain `permissions.allowedClusterQueryParams`.
53
- - Unified ad-hoc gateway commands (`analysis adhoc run/export`) do not expose `cluster_query_scope`; if a global/slave ad-hoc query is requested, report that the gateway contract does not support it yet instead of using removed ad-hoc commands or hidden flags.
54
- - For SQL model analysis, never pass `cluster_query_scope`; SQL model analysis only supports the current self cluster in the current gateway contract.
55
-
56
- ## Recommended Chains
57
-
58
- - Cluster inventory / cluster info -> `analysis +list_query_clusters`
59
- - Query DAU for Japan server -> `analysis +list_query_clusters` -> match JP/Japan slave cluster -> use only commands that explicitly expose cluster routing; the current report/dashboard/ad-hoc gateway data commands do not.
60
- - Query all-cluster aggregated DAU -> `analysis +list_query_clusters` -> if `permissions.canQueryGlobal=true`, use only commands that explicitly expose cluster routing; otherwise stop and report the capability gap.
61
- - View audience cohorts or user segments -> `analysis user-cluster list` instead
62
-
63
- ## Response Wording
64
-
65
- - Use "current query cluster" for `currentCluster`.
66
- - Use "accessible slave query clusters" for `slaveClusters`.
67
- - Use "allowed query-scope parameters" for `permissions.allowedClusterQueryParams`.
68
- - Do not call `analysis user-cluster list` results query clusters; those are audience clusters or user segments.
@@ -1,31 +0,0 @@
1
- # ae-engage +config_channel_detail
2
-
3
-
4
- Query config channel details.
5
-
6
- Mapped command: `ae-cli engage +config_channel_detail`
7
-
8
- ## Flags
9
-
10
- | Flag | Type | Required | Description |
11
- |------|------|------|------|
12
- | `--project_id` / `-p` | number | Yes | Project ID |
13
- | `--channel_id` | string | Yes | config channel ID |
14
-
15
- ## Common enums in the response
16
-
17
- ### `channelType`
18
-
19
- - `0`: `WEBHOOK`
20
- - `1`: `CLIENT`
21
-
22
- ### `channelStatus`
23
-
24
- - `1`: enabled
25
- - `2`: disabled
26
-
27
- ## Examples
28
-
29
- ```bash
30
- ae-cli engage +config_channel_detail --project_id 1 --channel_id <channel_id>
31
- ```
@@ -1,26 +0,0 @@
1
- # ae-engage +config_channel_list
2
-
3
-
4
- Query the config channel list.
5
-
6
- Mapped command: `ae-cli engage +config_channel_list`
7
-
8
- ## Flags
9
-
10
- | Flag | Type | Required | Description |
11
- |------|------|------|------|
12
- | `--project_id` / `-p` | number | Yes | Project ID |
13
- | `--channel_type` | number | No | config channel type |
14
-
15
- ## Enum Notes
16
-
17
- ### `--channel_type`
18
-
19
- - `0`: `WEBHOOK`
20
- - `1`: `CLIENT`
21
-
22
- ## Examples
23
-
24
- ```bash
25
- ae-cli engage +config_channel_list --project_id 1
26
- ```
@@ -1,29 +0,0 @@
1
- # ae-engage +config_item_detail
2
-
3
-
4
- Query config item details.
5
-
6
- Mapped command: `ae-cli engage +config_item_detail`
7
-
8
- ## Flags
9
-
10
- | Flag | Type | Required | Description |
11
- |------|------|------|------|
12
- | `--project_id` / `-p` | number | Yes | Project ID |
13
- | `--config_id` | string | Yes | config item ID |
14
-
15
- ## Common enums in the response
16
-
17
- ### `channelType`
18
-
19
- - `1`: `WEBHOOK`
20
- - `2`: `APP_PUSH`
21
- - `3`: `CLIENT_PUSH`
22
- - `4`: `WECHAT`
23
- - `5`: `DOU_YIN`
24
-
25
- ## Examples
26
-
27
- ```bash
28
- ae-cli engage +config_item_detail --project_id 1 --config_id cfg_123
29
- ```
@@ -1,18 +0,0 @@
1
- # ae-engage +config_item_list
2
-
3
-
4
- Query the list of config items in a project.
5
-
6
- Mapped command: `ae-cli engage +config_item_list`
7
-
8
- ## Flags
9
-
10
- | Flag | Type | Required | Description |
11
- |------|------|------|------|
12
- | `--project_id` / `-p` | number | Yes | Project ID |
13
-
14
- ## Examples
15
-
16
- ```bash
17
- ae-cli engage +config_item_list --project_id 1
18
- ```
@@ -1,28 +0,0 @@
1
- # ae-engage +copy_config_template
2
-
3
-
4
- Copy a template from the source config item to the target config item.
5
-
6
- Mapped command: `ae-cli engage +copy_config_template`
7
-
8
- ## Flags
9
-
10
- | Flag | Type | Required | Description |
11
- |------|------|------|------|
12
- | `--source_project_id` | number | Yes | source Project ID |
13
- | `--source_config_id` | string | Yes | source config item ID |
14
- | `--source_template_id` | string | Yes | source template ID |
15
- | `--project_id` / `-p` | number | Yes | target Project ID |
16
- | `--config_id` | string | Yes | target config item ID |
17
-
18
- ## Safety Constraints
19
-
20
- This command is a **write operation** and and copies the template and dependent resources.
21
-
22
- ## Examples
23
-
24
- ```bash
25
- ae-cli engage +copy_config_template \
26
- --source_project_id 1 --source_config_id src_cfg --source_template_id tpl_1 \
27
- --project_id 2 --config_id dst_cfg
28
- ```
@@ -1,23 +0,0 @@
1
- # ae-engage +delete_config_channel
2
-
3
-
4
- Delete a config channel.
5
-
6
- Mapped command: `ae-cli engage +delete_config_channel`
7
-
8
- ## Flags
9
-
10
- | Flag | Type | Required | Description |
11
- |------|------|------|------|
12
- | `--project_id` / `-p` | number | Yes | Project ID |
13
- | `--channel_id` | string | Yes | config channel ID |
14
-
15
- ## Safety Constraints
16
-
17
- This command is a **write operation** and and deletes a config channel.
18
-
19
- ## Examples
20
-
21
- ```bash
22
- ae-cli engage +delete_config_channel --project_id 1 --channel_id <channel_id>
23
- ```
@@ -1,24 +0,0 @@
1
- # ae-engage +delete_config_item
2
-
3
-
4
- Delete a config item.
5
-
6
- Mapped command: `ae-cli engage +delete_config_item`
7
-
8
- ## Flags
9
-
10
- | Flag | Type | Required | Description |
11
- |------|------|------|------|
12
- | `--project_id` / `-p` | number | Yes | Project ID |
13
- | `--config_id` | string | Yes | config item ID |
14
- | `--open_id` | string | Yes | operator open ID |
15
-
16
- ## Safety Constraints
17
-
18
- This command is a **write operation** and deletes a config item.
19
-
20
- ## Examples
21
-
22
- ```bash
23
- ae-cli engage +delete_config_item --project_id 1 --config_id cfg_123 --open_id ou_xxx
24
- ```
@@ -1,69 +0,0 @@
1
- # engage-scene config-item
2
-
3
- > Capability ids: `engage-scene.config-item.{list,create,update}` · Domain: `engage`.
4
-
5
- `config-item` 是配置中心(场景管理)里的配置项。create 走 multipart,可携带可选头像文件。
6
-
7
- ## Commands
8
-
9
- ```bash
10
- # List config items of a project
11
- ae-cli engage-scene config-item list --project-id <project_id>
12
-
13
- # Create a config item (business type, group, optional avatar)
14
- ae-cli engage-scene config-item create \
15
- --project-id <project_id> --config-id <config_id> --config-name <name> \
16
- --business-type <config_file|params> \
17
- [--config-remark <remark>] [--group-id <group_id>] \
18
- [--avatar-word '["A","B"]'] [--file-name avatar.png] [--file-content "$(base64 -i avatar.png)"]
19
-
20
- # Update a config item's basic info and bound channel
21
- ae-cli engage-scene config-item update \
22
- --project-id <project_id> --config-id <config_id> \
23
- [--config-name <name>] [--config-remark <remark>] [--business-type <type>] \
24
- [--group-id <group_id>] [--channel-id <channel_id>]
25
- ```
26
-
27
- ## Parameters
28
-
29
- ### list
30
-
31
- | Parameter | Required | Description |
32
- |---|---|---|
33
- | `--project-id` / `-p` | Yes | Numeric project ID. |
34
-
35
- ### create
36
-
37
- | Parameter | Required | Description |
38
- |---|---|---|
39
- | `--project-id` / `-p` | Yes | Numeric project ID. |
40
- | `--config-id` | Yes | Config item ID (unique within the project). |
41
- | `--config-name` | Yes | Config item display name (<=80 chars). |
42
- | `--business-type` | Yes | Business type: `config_file` or `params`. |
43
- | `--config-remark` | No | Remark (<=200 chars). |
44
- | `--group-id` | No | Group ID (0 = default group). |
45
- | `--avatar-word` | No | JSON array of avatar words for the icon. |
46
- | `--file-name` | No | Avatar file name incl. extension. |
47
- | `--file-content` | No | Base64-encoded avatar file content. |
48
-
49
- ### update
50
-
51
- | Parameter | Required | Description |
52
- |---|---|---|
53
- | `--project-id` / `-p` | Yes | Numeric project ID. |
54
- | `--config-id` | Yes | Config item ID to update. |
55
- | `--config-name` | No | New display name. |
56
- | `--config-remark` | No | New remark. |
57
- | `--business-type` | No | New business type. |
58
- | `--group-id` | No | New group ID. |
59
- | `--channel-id` | No | Config channel ID to bind. |
60
-
61
- ## Output
62
-
63
- - `list`: `data.items` + `data.total`.
64
- - `create` / `update`: `data.success` — whether the operation succeeded.
65
-
66
- ## Decision Rules
67
-
68
- - `create` / `update` are `write`; `list` is read.
69
- - Use `config-item list` (or `engage +config_item_list`) to discover existing config items first; never invent IDs.
@@ -1,73 +0,0 @@
1
- # ae-engage +manage_strategy
2
-
3
-
4
- Batch manage strategy status or review actions.
5
-
6
- Mapped command: `ae-cli engage +manage_strategy`
7
-
8
- ## Flags
9
-
10
- | Flag | Type | Required | Description |
11
- |------|------|------|------|
12
- | `--project_id` / `-p` | number | Yes | Project ID |
13
- | `--config_id` | string | Yes | config item ID |
14
- | `--action` | string | Yes | action type |
15
- | `--strategy_uuid_list` | json | No | Strategy UUID JSON array |
16
- | `--strategy_list` | json | No | Review-entry JSON array |
17
- | `--reason` | string | No | review reason |
18
-
19
- ## Enum Notes
20
-
21
- ### `--action`
22
-
23
- - `online`: publish strategy, requires `--strategy_uuid_list`
24
- - `offline`: take strategy offline, requires `--strategy_uuid_list`
25
- - `suspend`: suspend strategy, requires `--strategy_uuid_list`
26
- - `delete`: delete strategy, requires `--strategy_uuid_list`
27
- - `approve`: review approved, requires `--strategy_list`
28
- - `deny`: review denied, requires `--strategy_list`
29
- - `cancel`: cancel review, requires `--strategy_list`
30
-
31
- ## JSON Parameter Notes
32
-
33
- ### `--strategy_uuid_list`
34
-
35
- Used for actions such as `online`, `offline`, `suspend`, and `delete` that batch-process items directly by UUID.
36
-
37
- ```json
38
- ["uuid_1", "uuid_2"]
39
- ```
40
-
41
- ### `--strategy_list`
42
-
43
- Used for review actions such as `approve`, `deny`, and `cancel`. Each array item is an object:
44
-
45
- | Field | Type | Required | Description |
46
- |------|------|------|------|
47
- | `strategyUuid` | string | Yes | strategy UUID |
48
- | `reason` | string | No | review reason for that strategy |
49
-
50
- Examples:
51
-
52
- ```json
53
- [
54
- { "strategyUuid": "uuid_1", "reason": "approve by ops" }
55
- ]
56
- ```
57
-
58
- ## Safety Constraints
59
-
60
- This command is a **write operation** and changes the strategy status.
61
-
62
- Different `action` values require different parameters:
63
-
64
- - `online` / `offline` / `suspend` / `delete`: must include `--strategy_uuid_list`
65
- - `approve` / `deny` / `cancel`: must include `--strategy_list`
66
-
67
- ## Examples
68
-
69
- ```bash
70
- ae-cli engage +manage_strategy \
71
- --project_id 1 --config_id cfg_123 --action online \
72
- --strategy_uuid_list '["uuid_1"]'
73
- ```
@@ -1,72 +0,0 @@
1
- # ae-engage +strategy_detail
2
-
3
-
4
- Query the details of a single strategy.
5
-
6
- Mapped command: `ae-cli engage +strategy_detail`
7
-
8
- ## Flags
9
-
10
- | Flag | Type | Required | Description |
11
- |------|------|------|------|
12
- | `--project_id` / `-p` | number | Yes | Project ID |
13
- | `--config_id` | string | Yes | config item ID |
14
- | `--strategy_uuid` | string | Yes | strategy UUID |
15
-
16
- ## Common enums in the response
17
-
18
- ### `status`
19
-
20
- - `0`: `DRAFT`
21
- - `1`: `ONLINE`
22
- - `2`: `SUSPEND`
23
- - `3`: `OFFLINE`
24
-
25
- ### `mappingStatus`
26
-
27
- - `0`: `DRAFT`
28
- - `1`: `APPROVE`
29
- - `2`: `DENY`
30
- - `3`: `REGISTERING`
31
- - `4`: `REGISTER_FAIL`
32
- - `5`: `WAITING`
33
- - `6`: `ONLINE`
34
- - `7`: `SUSPEND`
35
- - `8`: `OFFLINE`
36
-
37
- ### `targetClusterType`
38
-
39
- - `0`: `ALL_USERS`
40
- - `1`: `CUSTOM_CLUSTER`
41
- - `2`: `SINGLE_USER`
42
-
43
- ### `realtime`
44
-
45
- - `0`: physical cluster, physical audience
46
- - `1`: virtual cluster, virtual audience
47
-
48
- ### `triggerType`
49
-
50
- - `0`: `SCHEDULED_SINGLE`
51
- - `1`: `SCHEDULED_RECURRING`
52
- - `2`: `MANUAL`
53
-
54
- ### `versionType`
55
-
56
- - `0`: history version
57
- - `1`: current version
58
- - `2`: update-content version
59
-
60
- ### `channelType`
61
-
62
- - `1`: `WEBHOOK`
63
- - `2`: `APP_PUSH`
64
- - `3`: `CLIENT_PUSH`
65
- - `4`: `WECHAT`
66
- - `5`: `DOU_YIN`
67
-
68
- ## Examples
69
-
70
- ```bash
71
- ae-cli engage +strategy_detail --project_id 1 --config_id cfg_123 --strategy_uuid uuid_123
72
- ```
@@ -1,20 +0,0 @@
1
- # ae-engage +strategy_list
2
-
3
-
4
- Query the strategy list.
5
-
6
- Mapped command: `ae-cli engage +strategy_list`
7
-
8
- ## Flags
9
-
10
- | Flag | Type | Required | Description |
11
- |------|------|------|------|
12
- | `--project_id` / `-p` | number | Yes | Project ID |
13
- | `--config_id` | string | No | config item ID |
14
- | `--strategy_uuid_list` | json | No | strategy UUID JSON array |
15
-
16
- ## Examples
17
-
18
- ```bash
19
- ae-cli engage +strategy_list --project_id 1 --config_id cfg_123
20
- ```
@@ -1,31 +0,0 @@
1
- # ae-engage +update_config_channel_status
2
-
3
-
4
- Update the status of a config channel.
5
-
6
- Mapped command: `ae-cli engage +update_config_channel_status`
7
-
8
- ## Flags
9
-
10
- | Flag | Type | Required | Description |
11
- |------|------|------|------|
12
- | `--project_id` / `-p` | number | Yes | Project ID |
13
- | `--channel_id` | string | Yes | config channel ID |
14
- | `--channel_status` | number | Yes | config channel status |
15
-
16
- ## Enum Notes
17
-
18
- ### `--channel_status`
19
-
20
- - `1`: enabled
21
- - `2`: disabled
22
-
23
- ## Safety Constraints
24
-
25
- This command is a **write operation** and and modifies the config channel status.
26
-
27
- ## Examples
28
-
29
- ```bash
30
- ae-cli engage +update_config_channel_status --project_id 1 --channel_id <channel_id> --channel_status 1
31
- ```
@@ -1,52 +0,0 @@
1
- # metadata event get (Super-Event Detail)
2
-
3
- > **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md) (`ae-metadata` skill).
4
- >
5
- > Capability id: `metadata.event.get` · Domain: `metadata` (capability gateway REST, not MCP `analysis_meta`).
6
-
7
- ## Use Cases
8
-
9
- - Fetch **one** super-event metadata record by technical name (full detail, not a paginated list).
10
- - Inspect virtual event definition (`definition.sources`, filters, relation) when `event_kind=virtual_event`.
11
- - Read-only; requires metadata **view** permission (`VIEW_META`) in the target project.
12
-
13
- ## Commands
14
-
15
- ```bash
16
- ae-cli metadata event get --project-id <project_id> --event-name <event_name>
17
- ae-cli metadata event get -p <project_id> --event-name <event_name> --dry-run
18
- ```
19
-
20
- ## Parameters
21
-
22
- | Parameter | Required | Description |
23
- |-----------|----------|-------------|
24
- | `--project-id` / `-p` | Yes | Numeric project ID. |
25
- | `--event-name` | Yes | Super-event technical name. Virtual events use the same field. |
26
-
27
- Gateway request body uses snake_case `input`:
28
-
29
- ```json
30
- {
31
- "project_id": 1,
32
- "event_name": "purchase"
33
- }
34
- ```
35
-
36
- ## Decision Rules
37
-
38
- - Prefer **`metadata event get`** over `analysis-meta event list` when you need **full detail + virtual definition**, not browsing or fuzzy search.
39
- - Use `ae-analysis` → `analysis-meta event list` first when the event name is unknown or you need keyword search / pagination.
40
- - If the gateway returns `EVENT_NOT_FOUND`, verify `event_name` spelling and `project_id`; do not invent names.
41
- - Auth: `cli-token` header (ae-cli injects automatically in sandbox; local CLI uses `getCliToken()`).
42
-
43
- ## Recommended Chaining
44
-
45
- - `ae-analysis`: `analysis-meta event list` (discover name) → `metadata event get` (detail)
46
- - `metadata event get` → `metadata property get` (inspect properties listed in response)
47
-
48
- ## Next Steps After Failure
49
-
50
- - Empty or not found: confirm project id and exact `event_name` from `analysis-meta event list`.
51
- - Permission error: confirm metadata view permission in the project.
52
- - Gateway unavailable: confirm nginx routes `/api/cli/metadata/` and backend capability catalog is deployed.