@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,44 +1,11 @@
1
- # ae-engage +task_experiment_report
1
+ # engage-task.task-data.experiment-report
2
2
 
3
+ Query a task experiment report through the L3 Capability Gateway.
3
4
 
4
- Query the task experiment report.
5
+ Mapped command: `ae-cli capability run engage-task.task-data.experiment-report --input '<json>'`
5
6
 
6
- Mapped command: `ae-cli engage +task_experiment_report`
7
-
8
- ## Flags
9
-
10
- | Flag | Type | Required | Description |
11
- |------|------|------|------|
12
- | `--project_id` / `-p` | number | Yes | Project ID |
13
- | `--task_id` | string | Yes | task ID |
14
- | `--report_type` | string | Yes | report type: `overview` or `detail` |
15
- | `--start_time` | string | Yes | Start date |
16
- | `--end_time` | string | Yes | End date |
17
- | `--request_id` | string | No | query requestId |
18
- | `--push_language_code` | string | No | push language code |
19
-
20
- ## Enum Notes
21
-
22
- ### `--report_type`
23
-
24
- - `overview`: experiment overview
25
- - `detail`: experiment detail
26
-
27
- ### `--push_language_code`
28
-
29
- Common values include:
30
-
31
- - `default`
32
- - `en`
33
- - `zh-Hans`
34
- - `zh-Hant`
35
- - `ja`
36
- - `ko`
37
-
38
- ## Examples
7
+ Required input: `project_id`, `task_id`, `report_type`, `start_time`, `end_time`. `report_type` is `overview` or `detail`.
39
8
 
40
9
  ```bash
41
- ae-cli engage +task_experiment_report \
42
- --project_id 1 --task_id task_123 \
43
- --report_type overview --start_time 2026-04-01 --end_time 2026-04-07
10
+ ae-cli capability run engage-task.task-data.experiment-report --input '{"project_id":1,"task_id":"task_123","report_type":"overview","start_time":"2026-04-01","end_time":"2026-04-07"}'
44
11
  ```
@@ -1,15 +1,15 @@
1
- # ae-engage +task_list
1
+ # ae-cli engage-task task list
2
2
 
3
3
 
4
4
  Query the paginated task list.
5
5
 
6
- Mapped command: `ae-cli engage +task_list`
6
+ Mapped command: `ae-cli engage-task task list`
7
7
 
8
8
  ## Flags
9
9
 
10
10
  | Flag | Type | Required | Description |
11
11
  |------|------|------|------|
12
- | `--project_id` / `-p` | number | Yes | Project ID |
12
+ | `--project-id` / `-p` | number | Yes | Project ID |
13
13
  | `--req` | json | Yes | query-condition JSON object |
14
14
 
15
15
  ## `--req` Object Fields
@@ -86,5 +86,5 @@ Common fields are listed below; provide them as needed:
86
86
  ## Examples
87
87
 
88
88
  ```bash
89
- ae-cli engage +task_list --project_id 1 --req '{"pageNum":1,"pageSize":20}'
89
+ ae-cli engage-task task list --project-id 1 --req '{"pageNum":1,"pageSize":20}'
90
90
  ```
@@ -1,49 +1,11 @@
1
- # ae-engage +task_metric_detail
1
+ # engage-task.task-data.metric-detail
2
2
 
3
+ Query a task metric detail report through the L3 Capability Gateway.
3
4
 
4
- Query the metric-oriented detail report for a task.
5
+ Mapped command: `ae-cli capability run engage-task.task-data.metric-detail --input '<json>'`
5
6
 
6
- Mapped command: `ae-cli engage +task_metric_detail`
7
-
8
- ## Flags
9
-
10
- | Flag | Type | Required | Description |
11
- |------|------|------|------|
12
- | `--project_id` / `-p` | number | Yes | Project ID |
13
- | `--task_id` | string | Yes | task ID |
14
- | `--start_time` | string | Yes | Start date |
15
- | `--end_time` | string | Yes | End date |
16
- | `--request_id` | string | No | query requestId |
17
- | `--push_language_code` | string | No | push language code |
18
- | `--metric_id_list` | json | No | metric ID JSON array |
19
- | `--group_type` | number | No | group type |
20
- | `--show_time_zone` | string | No | Display timezone offset |
21
-
22
- ## Enum Notes
23
-
24
- ### `--group_type`
25
-
26
- - `1`: group by batch
27
- - `2`: group by date
28
- - `3`: group by trigger
29
- - `4`: group by experiment result
30
-
31
- ### `--push_language_code`
32
-
33
- Common values include:
34
-
35
- - `default`
36
- - `en`
37
- - `zh-Hans`
38
- - `zh-Hant`
39
- - `ja`
40
- - `ko`
41
-
42
- ## Examples
7
+ Required input: `project_id`, `task_id`, `start_time`, `end_time`. Optional input includes `request_id`, `push_language_code`, `metric_id_list`, `group_type`, and `show_time_zone`.
43
8
 
44
9
  ```bash
45
- ae-cli engage +task_metric_detail \
46
- --project_id 1 --task_id task_123 \
47
- --start_time 2026-04-01 --end_time 2026-04-07 \
48
- --metric_id_list '["metric_1"]'
10
+ ae-cli capability run engage-task.task-data.metric-detail --input '{"project_id":1,"task_id":"task_123","start_time":"2026-04-01","end_time":"2026-04-07"}'
49
11
  ```
@@ -1,20 +1,20 @@
1
- # ae-engage +task_stats
1
+ # ae-cli engage-task task stats
2
2
 
3
3
 
4
4
  Query task status statistics.
5
5
 
6
- Mapped command: `ae-cli engage +task_stats`
6
+ Mapped command: `ae-cli engage-task task stats`
7
7
 
8
8
  ## Flags
9
9
 
10
10
  | Flag | Type | Required | Description |
11
11
  |------|------|------|------|
12
- | `--project_id` / `-p` | number | Yes | Project ID |
12
+ | `--project-id` / `-p` | number | Yes | Project ID |
13
13
  | `--req` | json | Yes | statistics-condition JSON object |
14
14
 
15
15
  ## `--req` Object Fields
16
16
 
17
- The `--req` structure of `+task_stats` is broadly the same as `+task_list`, and common fields include:
17
+ The `--req` structure of `engage-task task stats` is broadly the same as `engage-task task list`, and common fields include:
18
18
 
19
19
  | Field | Type | Required | Description |
20
20
  |------|------|------|------|
@@ -84,5 +84,5 @@ The `--req` structure of `+task_stats` is broadly the same as `+task_list`, and
84
84
  ## Examples
85
85
 
86
86
  ```bash
87
- ae-cli engage +task_stats --project_id 1 --req '{"pageNum":1,"pageSize":20}'
87
+ ae-cli engage-task task stats --project-id 1 --req '{"pageNum":1,"pageSize":20}'
88
88
  ```
@@ -1,24 +1,24 @@
1
- # ae-engage +update_channel_status
1
+ # ae-engage engage-setting channel update-status
2
2
 
3
3
 
4
4
  Update the status of an Engage channel.
5
5
 
6
- Mapped command: `ae-cli engage +update_channel_status`
6
+ Mapped command: `ae-cli engage-setting channel update-status`
7
7
 
8
8
  ## Flags
9
9
 
10
10
  | Flag | Type | Required | Description |
11
11
  |------|------|------|------|
12
- | `--project_id` / `-p` | number | Yes | Project ID |
13
- | `--channel_id` | string | Yes | channel ID |
12
+ | `--project-id` / `-p` | number | Yes | Project ID |
13
+ | `--channel-id` | string | Yes | channel ID |
14
14
  | `--status` | number | Yes | channel status |
15
15
 
16
16
  ## Enum Notes
17
17
 
18
18
  ### `--status`
19
19
 
20
- - `0`: disabled
21
20
  - `1`: enabled
21
+ - `2`: disabled
22
22
 
23
23
  ## Safety Constraints
24
24
 
@@ -27,5 +27,5 @@ This command is a **write operation** and Before executing, confirm that the use
27
27
  ## Examples
28
28
 
29
29
  ```bash
30
- ae-cli engage +update_channel_status --project_id 1 --channel_id <channel_id> --status 1
30
+ ae-cli engage-setting channel update-status --project-id 1 --channel-id <channel_id> --status 1
31
31
  ```
@@ -1,30 +1,31 @@
1
- # ae-engage +validate_flow_node_config
1
+ # ae-cli engage-flow node-config validate
2
2
 
3
3
 
4
4
  Validate and normalize a single node configuration before placing it into a `save_flow` request.
5
5
 
6
- Mapped command: `ae-cli engage +validate_flow_node_config`
6
+ Mapped command: `ae-cli engage-flow node-config validate`
7
7
 
8
8
  ## Flags
9
9
 
10
10
  | Flag | Type | Required | Description |
11
11
  |------|------|------|------|
12
- | `--node_type` | string | Yes | Flow node type |
12
+ | `--project-id` / `-p` | number | Yes | Project ID |
13
+ | `--node-type` | string | Yes | Flow node type |
13
14
  | `--config` | string | Yes | Node config JSON object encoded as a string |
14
- | `--operation_mode` | string | Yes | Validation mode |
15
+ | `--operation-mode` | string | Yes | Validation mode |
15
16
 
16
17
  ## When To Use
17
18
 
18
- Use this after `+flow_node_config_schema` and before passing a config into `+save_flow`.
19
+ Use this after `engage-flow node-config schema` and before passing a config into `engage-flow flow save`.
19
20
 
20
21
  The command validates one node config only; it does not validate the full canvas topology. It returns:
21
22
 
22
23
  - `valid`: whether the candidate config passed validation
23
24
  - `normalizedConfigObject`: backend-normalized config with defaulted fields
24
- - `errors`: hard validation failures to fix before calling `+save_flow`
25
+ - `errors`: hard validation failures to fix before calling `engage-flow flow save`
25
26
  - `warnings`: issues that depend on live channel/template/config data
26
27
 
27
- Use `--operation_mode save_flow` for the current exposed MCP protocol. Use `save_submit_flow` only when you intentionally want stricter submit-time checks.
28
+ Use `--operation-mode save_flow` for the current exposed MCP protocol. Use `save_submit_flow` only when you intentionally want stricter submit-time checks.
28
29
 
29
30
  Important current rules:
30
31
 
@@ -38,7 +39,7 @@ Important current rules:
38
39
 
39
40
  ## Enum Notes
40
41
 
41
- ### `--node_type`
42
+ ### `--node-type`
42
43
 
43
44
  Schema-backed node types include:
44
45
 
@@ -56,7 +57,7 @@ Schema-backed node types include:
56
57
  - `ab_split_flow`
57
58
  - `exit_flow`
58
59
 
59
- ### `--operation_mode`
60
+ ### `--operation-mode`
60
61
 
61
62
  - `save_flow`
62
63
  - `save_submit_flow`
@@ -64,6 +65,6 @@ Schema-backed node types include:
64
65
  ## Examples
65
66
 
66
67
  ```bash
67
- ae-cli engage +validate_flow_node_config \
68
- --node_type message_push --operation_mode save_flow --config '{}'
68
+ ae-cli engage-flow node-config validate \
69
+ --project-id 1 --node-type message_push --operation-mode save_flow --config '{}'
69
70
  ```
@@ -1,18 +1,18 @@
1
- # ae-engage +whitelist_list
1
+ # ae-engage engage-setting whitelist list
2
2
 
3
3
 
4
4
  Query the whitelist list in a project.
5
5
 
6
- Mapped command: `ae-cli engage +whitelist_list`
6
+ Mapped command: `ae-cli engage-setting whitelist list`
7
7
 
8
8
  ## Flags
9
9
 
10
10
  | Flag | Type | Required | Description |
11
11
  |------|------|------|------|
12
- | `--project_id` / `-p` | number | Yes | Project ID |
12
+ | `--project-id` / `-p` | number | Yes | Project ID |
13
13
 
14
14
  ## Examples
15
15
 
16
16
  ```bash
17
- ae-cli engage +whitelist_list --project_id 1
17
+ ae-cli engage-setting whitelist list --project-id 1
18
18
  ```
@@ -68,5 +68,5 @@ ae-cli engage-setting whitelist verify \
68
68
  ## Decision Rules
69
69
 
70
70
  - Use these commands when the user asks to add / edit / delete / verify project whitelist entries.
71
- - Discover existing whitelist IDs with `ae-cli engage +whitelist_list --project_id <project_id>` first; never invent IDs.
71
+ - Discover existing whitelist IDs with `ae-cli engage-setting whitelist list --project-id <project_id>` first; never invent IDs.
72
72
  - `delete` is `high-risk-write` and requires `--yes` (or interactive confirmation).
@@ -2,7 +2,7 @@
2
2
 
3
3
  > Capability ids: `engage-workbench.workbench.{list,add,update,delete}` · Domain: `engage`.
4
4
 
5
- 工作台 - 工作台指标卡槽(workbench slot)管理。每个用户在每个项目下最多 4 个指标卡;卡槽按当前登录用户隔离,`update`/`delete` 只能操作本人卡槽。首次 `list` 会自动初始化 4 个默认卡槽。
5
+ Workbench workbench metric slot management. Each user may configure up to 4 metric cards per project; slots are scoped to the current login user, so `update`/`delete` only affect the caller's own slots. The first `list` auto-initialises 4 default slots.
6
6
 
7
7
  ## Commands
8
8
 
@@ -34,7 +34,7 @@ description: "Interactive generation of AE tracking code, LogBus2 configuration,
34
34
  | LogBus2 配置 | LogBus2 Configuration | `daemon.json` for LogBus2 log sync tool |
35
35
  | LoggerConsumer | LoggerConsumer | Server SDK consumer that writes events to local log files |
36
36
  | BatchConsumer | BatchConsumer | Server SDK consumer that uploads events in batches |
37
- | 公共属性 | Super Property | Properties attached to all events automatically |
37
+ | 公共属性 | Super Property | Properties attached to all events automatically. ⚠️ The correct Chinese AE term is "公共属性" or "公共事件属性". Never translate "Super Property" as "超级属性" — that is NOT a valid AE term. |
38
38
  | 预置属性 | Preset Property | System properties prefixed with `#` (e.g. `#device_id`, `#time`) |
39
39
  | 事件属性 | Event Property | Custom properties on specific events |
40
40
  | 用户属性 | User Property | Properties set on the user profile |
@@ -91,12 +91,12 @@ First, check if `.ae-cli/draft.json` exists and read existing configuration:
91
91
  **⚠️ Key: SERVER_URL and APP_ID are independent config items. Even if draft.json has project_id and host, you MUST resolve and confirm them. `project_id` ≠ `APP_ID`, `host` ≠ `SERVER_URL`.**
92
92
 
93
93
  1. **APP_ID** — Prefer automatic lookup before asking:
94
- - If `meta.project_id` is known, run `ae-cli analysis_common +list_projects` once for the current host.
94
+ - If `meta.project_id` is known, run `ae-cli analysis project info list` once for the current host.
95
95
  - Find the project whose `projectId` matches `meta.project_id`.
96
96
  - If the matched project has `appId`, ask: **"I found APP_ID `<appId>` for project `<projectId>`. Use it? yes / enter new value"**
97
97
  - If the project is missing, ambiguous, or has no `appId`, ask the user to copy APP_ID from AE Admin → "Project Settings" → "Integration Config".
98
98
  2. **SERVER_URL** — Data ingestion endpoint (**different from web URL**; go to AE Admin → "Project Settings" → "Integration Config" → fill in "Public URL")
99
- - If `meta.project_id` is known, you may try `ae-cli analysis_meta +get_project_config --project_id <project_id>` once.
99
+ - If `meta.project_id` is known, you may try `ae-cli analysis project info get --project-id <project_id>` once.
100
100
  - Use the returned value only if the response explicitly contains a receiver URL field such as `serverUrl`, `pushUrl`, `push_url`, `receiverUrl`, `publicUrl`, `publicReceiverAddress`, `privateReceiverAddress`, or equivalent ingestion endpoint field.
101
101
  - If both `publicReceiverAddress` and `privateReceiverAddress` are present, prefer `publicReceiverAddress` as `SERVER_URL` for generated snippets unless the user explicitly needs an internal/private-network receiver.
102
102
  - If a value is found, ask: **"I found SERVER_URL `<url>` for project `<projectId>`. Use it? yes / enter new value"**
@@ -646,6 +646,7 @@ Validation steps:
646
646
  - Including `platform === "server"` exclusive events in client code
647
647
  - Including `platform === "client"` exclusive events in server code (unless `platform === "both"`)
648
648
  - **Skipping SDK main doc read and guessing integration method** — each SDK has different integration approaches; must read wiki main doc's "Integrate SDK" section first, and choose the correct method based on project characteristics (with/without build tools)
649
+ - **Translating "Super Property" as "超级属性" in any user-facing output (code comments, interaction prompts, markdown) — the correct AE Chinese term is "公共事件属性" or "公共属性"**
649
650
  - **Entering Phase 1 before Phase 0.5 is complete** — SDK integration must be confirmed before inserting code, otherwise generated track() calls won't work
650
651
 
651
652
  ---
@@ -1,6 +1,6 @@
1
1
  # Mode A — Client SDK Code Insertion
2
2
 
3
- > **Terminology**: 客户端 SDK = client SDK | 代码插入 = code insertion/injection | 前置检查 = pre-check | 集成方式 = integration method | 埋点 = tracking/event tracking | 业务触发点 = business trigger point | 公共属性 = super property | 用户属性 = user property | 自动采集事件 = auto-track event | 插入位置预览 = insertion site preview | 语言风格校验 = language style check
3
+ > **Terminology**: 客户端 SDK = client SDK | 代码插入 = code insertion/injection | 前置检查 = pre-check | 集成方式 = integration method | 埋点 = tracking/event tracking | 业务触发点 = business trigger point | 公共属性 = super property (公共事件属性; never "超级属性") | 用户属性 = user property | 自动采集事件 = auto-track event | 插入位置预览 = insertion site preview | 语言风格校验 = language style check
4
4
 
5
5
  ## ⚠️ Mandatory Pre-checks (do not skip)
6
6
 
@@ -1,6 +1,6 @@
1
1
  # Server-side Code Insertion (LoggerConsumer + LogBus2)
2
2
 
3
- > **Terminology**: 服务端 SDK = server-side SDK | 代码插入 = code insertion/injection | LoggerConsumer = writes events to local log files (recommended for production) | LogBus2 = log sync tool that reads local logs and uploads to TE | 架构 = architecture | 异步上报 = async upload | 批量上传 = batch upload | 重试策略 = retry strategy | 公共属性 = super property | 用户属性 = user property | 依赖管理 = dependency management
3
+ > **Terminology**: 服务端 SDK = server-side SDK | 代码插入 = code insertion/injection | LoggerConsumer = writes events to local log files (recommended for production) | LogBus2 = log sync tool that reads local logs and uploads to TE | 架构 = architecture | 异步上报 = async upload | 批量上传 = batch upload | 重试策略 = retry strategy | 公共属性 = super property (公共事件属性; never "超级属性") | 用户属性 = user property | 依赖管理 = dependency management
4
4
 
5
5
  ## Architecture
6
6
 
@@ -1,6 +1,6 @@
1
1
  # Snippet Output Mode
2
2
 
3
- > **Terminology**: 片段/代码片段 = snippet/code snippet | 产物 = deliverable/output | markdown 响应 = markdown response | 初始化 = initialization | 公共属性 = super property | 用户属性 = user property | 事件组 = event group | 触发时机 = trigger timing | 验证步骤 = verification steps | 设备绑定 = device binding | 自动采集事件 = auto-track event | 占位值 = placeholder value | 属性类型 = property type
3
+ > **Terminology**: 片段/代码片段 = snippet/code snippet | 产物 = deliverable/output | markdown 响应 = markdown response | 初始化 = initialization | 公共属性 = super property (公共事件属性; never "超级属性") | 用户属性 = user property | 事件组 = event group | 触发时机 = trigger timing | 验证步骤 = verification steps | 设备绑定 = device binding | 自动采集事件 = auto-track event | 占位值 = placeholder value | 属性类型 = property type
4
4
 
5
5
  ## Deliverables
6
6
 
@@ -29,7 +29,7 @@ description: "Interactive generation of an AE tracking plan and upload. Trigger
29
29
  | 货币体系 | Currency System | Hard currency (diamonds), soft currency (gold), etc. |
30
30
  | 事件 | Event | Named user action or system occurrence (`event_name`) |
31
31
  | 事件属性 | Event Property | Data attached to an event (`prop_names`) |
32
- | 公共事件属性 | Common/Super Property | Property attached to every event automatically |
32
+ | 公共事件属性 | Common/Super Property | Property attached to every event automatically. ⚠️ The correct Chinese AE term is "公共事件属性" or "公共属性". Never translate "Super Property" as "超级属性" — that is NOT a valid AE term. |
33
33
  | 用户属性 | User Property | Property on the user profile (persistent state) |
34
34
  | 预置属性 | Preset Property | System property prefixed with `#` (`#device_id`, `#time`, etc.) |
35
35
  | 自动采集事件 | Auto-track Event | SDK auto-collected events (`ta_app_start`, `ta_page_show`, etc.) |
@@ -700,7 +700,10 @@ Based on SDK integration mode collected in Phase 0, decide whether to inject aut
700
700
  3. Auto-track event `event_tag` set to `"System Event"`
701
701
  4. Auto-track events only carry preset properties (`prop_names` is empty or contains only preset property names)
702
702
  5. Preset properties prefixed with `#` are not added to `event_properties` pool (auto-collected by SDK)
703
- 6. **Deduplication**: Templates may already contain same-name auto-track events (e.g. `ta_app_start` marked `source: "template"`); CLI deduplicates by event name globally and will not inject duplicates
703
+ 6. **Cleanup + Deduplication**: The CLI will:
704
+ - **Remove** auto-track events inherited from templates or existing plans that don't match the user's selected SDKs. For example: if a template built for Android/iOS contains `ta_app_install`, `ta_app_start`, `ta_app_end` but the user selects JavaScript SDK, those `ta_app_*` events will be automatically removed since JavaScript SDK does not support them.
705
+ - **Inject** the correct auto-track events for the user's selected SDKs.
706
+ - **Deduplicate** by event name globally — won't inject events that already exist in the draft (correct auto-track events inherited from templates are kept).
704
707
 
705
708
  **SDK type → Recommended events** (see `references/autotrack-events.md` for details):
706
709
 
@@ -1300,6 +1303,7 @@ The tracking plan has been uploaded successfully. Would you like to generate tra
1300
1303
  - Asking all anchor questions at once
1301
1304
  - Skipping Phase 3 and uploading directly
1302
1305
  - Manually assembling xlsx bypassing `.ae-cli/draft.json`
1306
+ - Translating "Super Property" as "超级属性" in any user-facing output (interaction prompts, plan summaries, event/property descriptions) — the correct AE Chinese term is "公共事件属性" or "公共属性"
1303
1307
  - Calling `fetch` AE API directly within the skill — all AE communication must go through project scripts / CLI
1304
1308
 
1305
1309
  ---
@@ -125,15 +125,17 @@ ae-cli kb +status --name engineering-handbook
125
125
 
126
126
  ### Query Knowledge
127
127
 
128
- Use `+query` with a natural-language question and a JSON array of source refs.
128
+ Use `+query` with a natural-language question. Optionally scope to specific knowledge bases or tune result count and locale.
129
129
 
130
130
  ```bash
131
131
  ae-cli kb +query \
132
132
  --query "How do we release a dashboard?" \
133
- --sources '[{"scope":"company","name":"engineering-handbook"}]'
133
+ --sources '[{"scope":"company","name":"engineering-handbook"}]' \
134
+ --top-k 10 \
135
+ --locale zh
134
136
  ```
135
137
 
136
- `--sources` entries require:
138
+ When `--sources` is provided, each entry requires:
137
139
 
138
140
  - `scope`: knowledge base scope such as `personal` or `company`.
139
141
  - `name`: knowledge base name.
@@ -234,11 +236,13 @@ ae-cli kb +remove --name engineering-handbook
234
236
  ### `+query`
235
237
 
236
238
  ```bash
237
- ae-cli kb +query --query "<question>" --sources '[{"scope":"company","name":"kb-name"}]'
239
+ ae-cli kb +query --query "<question>" [--sources '[{"scope":"company","name":"kb-name"}]'] [--top-k 10] [--locale zh|en|ja|ko]
238
240
  ```
239
241
 
240
242
  - `--query`, alias `-q`: required natural-language question.
241
- - `--sources`: required JSON array of knowledge base refs.
243
+ - `--sources`: optional JSON array of knowledge base refs. Omit to search all accessible knowledge bases.
244
+ - `--top-k`: optional max number of hits, 1-50, default 10.
245
+ - `--locale`: optional locale: `zh`, `en`, `ja`, or `ko`.
242
246
 
243
247
  ### `+ask`
244
248
 
@@ -1,14 +1,14 @@
1
1
  ---
2
2
  name: ae-metadata
3
3
  version: 1.0.0
4
- description: "AE/TE metadata capability-gateway CLI: metadata event/property detail, data-table management, and property dimension-table binding. Metadata CLI routes through the analysis gateway. Input-file upload belongs to ae-analysis."
4
+ description: "AE/TE metadata capability-gateway CLI: metadata data-table management and property dimension-table binding. Metadata CLI routes through the analysis gateway. Input-file upload and event/property detail belong to ae-analysis."
5
5
  ---
6
6
 
7
7
  # ae-metadata
8
8
 
9
9
  CLI domain **`metadata`** routes to the analysis capability gateway (`/api/cli/analysis/v1/...`), using auth header **`cli-token`**.
10
10
 
11
- Parallel to **`ae-analysis`** (MCP `analysis_meta` for metadata lists/governance). Use **this skill** for gateway-backed metadata detail and data-table/dimension-table operations; use **`ae-analysis`** for MCP metadata list/search, metrics, virtual create, and batch edit.
11
+ Parallel to **`ae-analysis`**. Use **this skill** for gateway-backed metadata detail and data-table/dimension-table operations; use **`ae-analysis`** for metadata list/search, metrics, virtual create, and batch edit.
12
12
 
13
13
  ## Global AE CLI Rules
14
14
 
@@ -16,7 +16,7 @@ Parallel to **`ae-analysis`** (MCP `analysis_meta` for metadata lists/governance
16
16
  |---|---|
17
17
  | `--format <json\|table>` | Output format. Default JSON. |
18
18
  | `--jq <expr>` | jq filter on JSON output. |
19
- | `--host <url>` | Override active AE host, e.g. `ae-cli metadata event get --host <url> ...`. |
19
+ | `--host <url>` | Override active AE host, e.g. `ae-cli metadata data-table list --host <url> ...`. |
20
20
  | `--validate` | Optional: fix params only (`/validate`). Alone while iterating complex `qp` / payload — then run. Do not stack with `--dry-run`. |
21
21
  | `--dry-run` | Optional: confirm ready to run (`/dry-run`). Alone for risk/output preview. Do not stack with `--validate`. |
22
22
 
@@ -28,20 +28,18 @@ Output and errors:
28
28
  Safety:
29
29
  - Read-only commands can run directly after IDs/names are verified.
30
30
  - Ordinary writes (`data-table *-write`, `property-bindings-update`, dimension-table bind/create) execute without `--yes`. Delete commands are `high-risk-write`: dry-run first, summarize impact, wait for explicit confirmation, then execute with `--yes`.
31
- - **Before any command**, read the matching `references/<name>.md` (filename = command with spaces → underscores, e.g. `metadata event get` → `metadata_event_get.md`).
31
+ - **Before any command**, read the matching `references/<name>.md` (filename = command with spaces → underscores, e.g. `metadata data-table list` → `metadata_data_table_list.md`).
32
32
  - Never invent `project_id`, event/property names, `input_file_id`, or `data_table_id`. Discover names via `ae-analysis` and data table IDs via `metadata data-table list`.
33
33
 
34
34
  ## When to Use
35
35
 
36
36
  Switch to **`ae-metadata`** when the user needs:
37
37
 
38
- - Full detail for **one** super-event (incl. virtual event `definition`)
39
- - Full detail for **one** super-property (incl. virtual property `definition`)
40
38
  - Metadata data-table list/get/create/update/delete/download
41
39
  - For local uploads, switch to `ae-analysis` and use `analysis input-file upload` with a discovered purpose.
42
40
  - Bind an existing data table to a property, or create a CSV dimension table and bind it
43
41
 
44
- Stay on **`ae-analysis`** for: metadata event/property/metric list/search, metric CRUD, batch metadata, virtual create, project config, tracking plans.
42
+ Stay on **`ae-analysis`** for: metadata event/property detail, metadata event/property/metric list/search, metric CRUD, batch metadata, virtual create, project config, tracking plans.
45
43
 
46
44
  ## Command Format
47
45
 
@@ -55,14 +53,12 @@ ae-cli metadata property <dimension-table-action> [options]
55
53
 
56
54
  ## PROJECT_ID_GATE
57
55
 
58
- Same rules as `ae-analysis`: reuse verified project context in one conversation; otherwise `ae-cli analysis_common +list_projects` (or `ae-analysis` skill) to resolve `project_id`.
56
+ Same rules as `ae-analysis`: reuse verified project context in one conversation; otherwise `ae-cli analysis project info list` (or `ae-analysis` skill) to resolve `project_id`.
59
57
 
60
- ## Commands (12)
58
+ ## Commands (10)
61
59
 
62
60
  | User command | Capability id | Reference |
63
61
  |---|---|---|
64
- | `metadata event get` | `metadata.event.get` | [metadata_event_get.md](references/metadata_event_get.md) |
65
- | `metadata property get` | `metadata.property.get` | [metadata_property_get.md](references/metadata_property_get.md) |
66
62
  | `metadata data-table list` | `metadata.data_table.list` | [metadata_data_table_list.md](references/metadata_data_table_list.md) |
67
63
  | `metadata data-table get` | `metadata.data_table.get` | [metadata_data_table_get.md](references/metadata_data_table_get.md) |
68
64
  | `metadata data-table csv-write` | `metadata.data_table.csv_write` | [metadata_data_table_csv_write.md](references/metadata_data_table_csv_write.md) |
@@ -78,15 +74,12 @@ Same rules as `ae-analysis`: reuse verified project context in one conversation;
78
74
 
79
75
  ```bash
80
76
  ae-cli metadata --help
81
- ae-cli metadata event get --help
82
- ae-cli metadata property get --help
83
77
  ae-cli metadata data-table list --help
84
- ae-cli metadata event get --project-id 1 --event-name <name> --dry-run
85
78
  ae-cli metadata data-table list --project-id 1 --dry-run
86
79
  ae-cli analysis input-file purpose list --project-id 1
87
80
  ```
88
81
 
89
82
  ## Related Skills
90
83
 
91
- - **`ae-analysis`**: `analysis-meta event list` / `analysis-meta property list` to discover names before detail get.
84
+ - **`ae-analysis`**: `analysis-meta event get` / `analysis-meta property get` for detail, and `analysis-meta event list` / `analysis-meta property list` to discover names.
92
85
  - **Dev workflow**: `.cursor/skills/te-cli-capability-gateway` — inspect gateway schema when adding new metadata capabilities.
@@ -22,6 +22,6 @@ ae-cli metadata property bind-existing-dimension-table --project-id <project_id>
22
22
 
23
23
  ## Decision Rules
24
24
 
25
- - Confirm the property with `metadata property get` or `analysis-meta property list`.
25
+ - Confirm the property with `analysis-meta property get` or `analysis-meta property list`.
26
26
  - Confirm the data table with `metadata data-table get`.
27
27
  - This is an ordinary `write` command and does not require CLI confirmation.
@@ -1,61 +0,0 @@
1
- import {
2
- callMcpTool,
3
- parseMcpResult,
4
- resolveMcpUrl
5
- } from "./chunk-3P3562ZX.js";
6
- import "./chunk-LCXU3AAT.js";
7
- import "./chunk-E7UXXHO3.js";
8
- import "./chunk-IR4ZLVPW.js";
9
- import "./chunk-V6FR6WTW.js";
10
- import "./chunk-24BAVOX3.js";
11
- import "./chunk-LYVNONC4.js";
12
-
13
- // src/commands/te-common/shared.ts
14
- function createMcpCommand(config) {
15
- const toolName = config.command.slice(1);
16
- const mcpService = config.mcpService || "analysis";
17
- return {
18
- service: "analysis_common",
19
- command: config.command,
20
- description: config.description,
21
- flags: config.flags,
22
- risk: config.risk,
23
- dryRun: (ctx) => ({
24
- method: "tools/call",
25
- url: resolveMcpUrl(ctx.mcpUrl(), ctx.host(), mcpService),
26
- body: {
27
- name: toolName,
28
- arguments: config.buildArgs(ctx)
29
- }
30
- }),
31
- execute: async (ctx) => {
32
- const url = resolveMcpUrl(ctx.mcpUrl(), ctx.host(), mcpService);
33
- const result = await callMcpTool(url, toolName, config.buildArgs(ctx), ctx.host());
34
- return parseMcpResult(result);
35
- }
36
- };
37
- }
38
-
39
- // src/commands/te-common/project/list-projects.ts
40
- var listProjects = createMcpCommand({
41
- command: "+list_projects",
42
- description: "List all projects accessible to the current user. No parameters are required. Returns project IDs, names, company IDs, project types, remarks, app IDs, and the user's current role in each project.",
43
- flags: [],
44
- risk: "read",
45
- buildArgs: () => ({})
46
- });
47
-
48
- // src/commands/te-common/project/index.ts
49
- var commands = [
50
- listProjects
51
- ];
52
- var project_default = commands;
53
-
54
- // src/commands/te-common/index.ts
55
- var commands2 = [
56
- ...project_default
57
- ];
58
- var te_common_default = commands2;
59
- export {
60
- te_common_default as default
61
- };