@thinkingai/ae-cli 6.0.34 → 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 (89) hide show
  1. package/dist/index.js +22 -14
  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,363 +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-meta/shared.ts
14
- function createMcpCommand(config) {
15
- const toolName = config.command.slice(1);
16
- const mcpService = config.mcpService || "analysis";
17
- return {
18
- service: "analysis_meta",
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
- function optionalString(ctx, name) {
39
- const value = ctx.str(name);
40
- return value === "" ? void 0 : value;
41
- }
42
- function optionalNumber(ctx, name) {
43
- const value = ctx.str(name);
44
- return value === "" ? void 0 : Number(value);
45
- }
46
- function optionalJson(ctx, name) {
47
- const value = ctx.str(name);
48
- return value === "" ? void 0 : ctx.json(name);
49
- }
50
- function requiredJsonString(ctx, name) {
51
- return JSON.stringify(ctx.json(name));
52
- }
53
-
54
- // src/commands/te-meta/meta/batch-edit-metadata.ts
55
- var batchEditMetadata = createMcpCommand({
56
- command: "+batch_edit_metadata",
57
- description: "Batch edit effective system metadata only",
58
- flags: [
59
- { name: "project_id", type: "number", required: true, alias: "p", desc: "Project ID" },
60
- { name: "type", type: "string", required: true, desc: "Metadata type: event, event_property, or user_property" },
61
- { name: "items", type: "json", required: true, desc: "Batch edit item list JSON array" }
62
- ],
63
- risk: "write",
64
- mcpService: "te_analysis_extend",
65
- buildArgs: (ctx) => ({
66
- projectId: ctx.num("project_id"),
67
- type: ctx.str("type"),
68
- items: ctx.json("items")
69
- })
70
- });
71
-
72
- // src/commands/te-meta/meta/batch-create-metadata.ts
73
- var batchCreateMetadata = createMcpCommand({
74
- command: "+batch_create_metadata",
75
- description: "Batch create effective system metadata only",
76
- flags: [
77
- { name: "project_id", type: "number", required: true, alias: "p", desc: "Project ID" },
78
- { name: "events", type: "json", required: false, desc: "Event creation list JSON array" },
79
- { name: "event_properties", type: "json", required: false, desc: "Event property creation list JSON array" },
80
- { name: "user_properties", type: "json", required: false, desc: "User property creation list JSON array" }
81
- ],
82
- risk: "write",
83
- mcpService: "te_analysis_extend",
84
- buildArgs: (ctx) => ({
85
- projectId: ctx.num("project_id"),
86
- events: optionalJson(ctx, "events"),
87
- eventProperties: optionalJson(ctx, "event_properties"),
88
- userProperties: optionalJson(ctx, "user_properties")
89
- })
90
- });
91
-
92
- // src/commands/te-meta/meta/index.ts
93
- var commands = [
94
- batchEditMetadata,
95
- batchCreateMetadata
96
- ];
97
- var meta_default = commands;
98
-
99
- // src/commands/te-meta/project/get-project-config.ts
100
- var getProjectConfig = createMcpCommand({
101
- command: "+get_project_config",
102
- description: "Get project configuration details including timezone settings",
103
- flags: [
104
- { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" }
105
- ],
106
- risk: "read",
107
- buildArgs: (ctx) => ({
108
- projectId: ctx.num("project_id")
109
- })
110
- });
111
-
112
- // src/commands/te-meta/project/list-project-users.ts
113
- var listProjectUsers = createMcpCommand({
114
- command: "+list_project_users",
115
- description: "Get all project members",
116
- flags: [
117
- { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" }
118
- ],
119
- risk: "read",
120
- buildArgs: (ctx) => ({
121
- projectId: ctx.num("project_id")
122
- })
123
- });
124
-
125
- // src/commands/te-meta/project/get-track-program.ts
126
- var getTrackProgram = createMcpCommand({
127
- command: "+get_track_program",
128
- description: "Query tracking-plan metadata (bury program)",
129
- flags: [
130
- { name: "project_id", type: "number", required: true, alias: "p", desc: "Project ID" }
131
- ],
132
- risk: "read",
133
- mcpService: "te_analysis_extend",
134
- buildArgs: (ctx) => ({
135
- projectId: ctx.num("project_id")
136
- })
137
- });
138
-
139
- // src/commands/te-meta/project/save-track-items.ts
140
- var saveTrackItems = createMcpCommand({
141
- command: "+save_track_items",
142
- description: "Create or update tracking-plan metadata only",
143
- flags: [
144
- { name: "project_id", type: "number", required: true, alias: "p", desc: "Project ID" },
145
- { name: "track_data", type: "json", required: true, desc: "Track program JSON object with events/eventProps/userProps/commonEventProps" }
146
- ],
147
- risk: "write",
148
- mcpService: "te_analysis_extend",
149
- buildArgs: (ctx) => ({
150
- projectId: ctx.num("project_id"),
151
- trackData: requiredJsonString(ctx, "track_data")
152
- })
153
- });
154
-
155
- // src/commands/te-meta/project/delete-track-items.ts
156
- var deleteTrackItems = createMcpCommand({
157
- command: "+delete_track_items",
158
- description: "Delete tracking-plan metadata items only",
159
- flags: [
160
- { name: "project_id", type: "number", required: true, alias: "p", desc: "Project ID" },
161
- { name: "delete_data", type: "json", required: true, desc: "Delete payload JSON object with events/eventPropNames/userPropNames/commonEventPropNames" }
162
- ],
163
- risk: "high-risk-write",
164
- mcpService: "te_analysis_extend",
165
- buildArgs: (ctx) => ({
166
- projectId: ctx.num("project_id"),
167
- deleteData: requiredJsonString(ctx, "delete_data")
168
- })
169
- });
170
-
171
- // src/commands/te-meta/project/generate-track-program.ts
172
- var generateTrackProgram = createMcpCommand({
173
- command: "+generate_track_program",
174
- description: "Generate a tracking plan from structured business context (async)",
175
- flags: [
176
- { name: "project_id", type: "number", required: true, alias: "p", desc: "Project ID" },
177
- { name: "language", type: "string", required: true, alias: "l", desc: "Language code (zh-CN, en-US, ja-JP, ko-KR)" },
178
- { name: "form_data", type: "json", required: true, desc: "Structured business context JSON object, optional fields for example: account_system, revenue_model, core_gameplay, currency_system, main_entries, predefinedEvent, developmentCarrier" }
179
- ],
180
- risk: "write",
181
- mcpService: "te_analysis_extend",
182
- buildArgs: (ctx) => ({
183
- projectId: ctx.num("project_id"),
184
- language: ctx.str("language"),
185
- formData: ctx.json("form_data")
186
- })
187
- });
188
-
189
- // src/commands/te-meta/project/generate-track-sdk-sample.ts
190
- var generateTrackSdkSample = createMcpCommand({
191
- command: "+generate_track_sdk_sample",
192
- description: "Generate SDK sample files based on tracking plan (async)",
193
- flags: [
194
- { name: "project_id", type: "number", required: true, alias: "p", desc: "Project ID" },
195
- { name: "sdk_type", type: "json", required: true, desc: "SDK types 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" }
196
- ],
197
- risk: "write",
198
- mcpService: "te_analysis_extend",
199
- buildArgs: (ctx) => ({
200
- projectId: ctx.num("project_id"),
201
- sdkType: ctx.json("sdk_type")
202
- })
203
- });
204
-
205
- // src/commands/te-meta/project/create-project-mark-time.ts
206
- var createProjectMarkTime = createMcpCommand({
207
- command: "+create_project_mark_time",
208
- description: "Create a project date marker",
209
- flags: [
210
- { name: "project_id", type: "number", required: true, alias: "p", desc: "Project ID" },
211
- { name: "marked_at", type: "string", required: true, desc: "Marked time yyyy-MM-dd HH:mm" },
212
- { name: "zone_offset", type: "number", required: false, desc: "Marker time zone offset" },
213
- { name: "content", type: "string", required: true, desc: "Marker content" },
214
- { name: "is_visible", type: "number", required: false, desc: "Whether the marker is visible. Default: 1" }
215
- ],
216
- risk: "write",
217
- mcpService: "te_analysis_extend",
218
- buildArgs: (ctx) => ({
219
- projectId: ctx.num("project_id"),
220
- markedAt: ctx.str("marked_at"),
221
- zoneOffset: optionalNumber(ctx, "zone_offset"),
222
- content: ctx.str("content"),
223
- isVisible: optionalNumber(ctx, "is_visible")
224
- })
225
- });
226
-
227
- // src/commands/te-meta/project/update-project-mark-time.ts
228
- var updateProjectMarkTime = createMcpCommand({
229
- command: "+update_project_mark_time",
230
- description: "Update an existing project date marker",
231
- flags: [
232
- { name: "mark_time_id", type: "number", required: true, desc: "Mark time ID" },
233
- { name: "project_id", type: "number", required: true, alias: "p", desc: "Project ID" },
234
- { name: "marked_at", type: "string", required: true, desc: "Marked time yyyy-MM-dd HH:mm" },
235
- { name: "zone_offset", type: "number", required: false, desc: "Marker time zone offset" },
236
- { name: "content", type: "string", required: true, desc: "Marker content" },
237
- { name: "is_visible", type: "number", required: false, desc: "Whether the marker is visible. Default: 1" }
238
- ],
239
- risk: "write",
240
- mcpService: "te_analysis_extend",
241
- buildArgs: (ctx) => ({
242
- markTimeId: ctx.num("mark_time_id"),
243
- projectId: ctx.num("project_id"),
244
- markedAt: ctx.str("marked_at"),
245
- zoneOffset: optionalNumber(ctx, "zone_offset"),
246
- content: ctx.str("content"),
247
- isVisible: optionalNumber(ctx, "is_visible")
248
- })
249
- });
250
-
251
- // src/commands/te-meta/project/list-project-mark-times.ts
252
- var listProjectMarkTimes = createMcpCommand({
253
- command: "+list_project_mark_times",
254
- description: "List project date markers. Query performs fuzzy matching on markContent. Supports fields/limit/offset pagination.",
255
- flags: [
256
- { name: "project_id", type: "number", required: true, alias: "p", desc: "Project ID" },
257
- { name: "zone_offset", type: "number", required: false, desc: "Marker time zone offset" },
258
- { name: "query", type: "string", required: false, alias: "q", desc: "Optional keyword filter. Fuzzy match on markContent." },
259
- { name: "fields", type: "json", required: false, desc: "Optional fields to return. Supported: id, projectId, markTime, userZoneTime, zoneOffset, markContent, isShow, creatorName, creatorId, lastModifierName, lastModifierId, createTime, updateTime." },
260
- { name: "limit", type: "number", required: false, desc: "Optional limit. Default: 50, maximum: 200.", min: 1, max: 200 },
261
- { name: "offset", type: "number", required: false, desc: "Optional offset. Default: 0." }
262
- ],
263
- risk: "read",
264
- mcpService: "te_analysis_extend",
265
- buildArgs: (ctx) => ({
266
- projectId: ctx.num("project_id"),
267
- zoneOffset: optionalNumber(ctx, "zone_offset"),
268
- query: optionalString(ctx, "query"),
269
- fields: optionalJson(ctx, "fields"),
270
- limit: optionalNumber(ctx, "limit"),
271
- offset: optionalNumber(ctx, "offset")
272
- })
273
- });
274
-
275
- // src/commands/te-meta/project/delete-project-mark-times.ts
276
- var deleteProjectMarkTimes = createMcpCommand({
277
- command: "+delete_project_mark_times",
278
- description: "Delete one or more project date markers",
279
- flags: [
280
- { name: "project_id", type: "number", required: true, alias: "p", desc: "Project ID" },
281
- { name: "mark_time_ids", type: "json", required: true, desc: "Marker ID list JSON array" }
282
- ],
283
- risk: "high-risk-write",
284
- mcpService: "te_analysis_extend",
285
- buildArgs: (ctx) => ({
286
- projectId: ctx.num("project_id"),
287
- markTimeIds: ctx.json("mark_time_ids")
288
- })
289
- });
290
-
291
- // src/commands/te-meta/project/index.ts
292
- var commands2 = [
293
- getProjectConfig,
294
- listProjectUsers,
295
- getTrackProgram,
296
- saveTrackItems,
297
- deleteTrackItems,
298
- generateTrackProgram,
299
- generateTrackSdkSample,
300
- createProjectMarkTime,
301
- updateProjectMarkTime,
302
- listProjectMarkTimes,
303
- deleteProjectMarkTimes
304
- ];
305
- var project_default = commands2;
306
-
307
- // src/commands/te-meta/entity/list-entities.ts
308
- var listEntities = createMcpCommand({
309
- command: "+list_entities",
310
- description: "List entities in the project. Query performs fuzzy matching on entityName, columnName and columnDesc. Supports fields/limit/offset payload governance. Default returned fields: entityId, entityName, columnName, columnDesc, selectType. Entity metadata exposes columnDesc as the description field; no remark field is available in this list response.",
311
- flags: [
312
- { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" },
313
- { name: "event_name", type: "string", required: false, desc: "Optional event name filter" },
314
- { name: "query", type: "string", required: false, desc: "Optional keyword filter. Fuzzy match is applied to entityName, columnName, and columnDesc; if omitted, all entities are returned.", alias: "q" },
315
- { name: "fields", type: "json", required: false, desc: "Optional fields to return. Supported fields: entityId, entityName, columnName, columnDesc, selectType, tableType, entityType. Default fields when omitted: entityId, entityName, columnName, columnDesc, selectType.", alias: "f" },
316
- { name: "limit", type: "number", required: false, desc: "Optional page size. Default: 50, maximum: 200.", alias: "l", min: 1, max: 200 },
317
- { name: "offset", type: "number", required: false, desc: "Optional page offset. Default: 0.", alias: "o" }
318
- ],
319
- risk: "read",
320
- buildArgs: (ctx) => ({
321
- projectId: ctx.num("project_id"),
322
- eventName: optionalString(ctx, "event_name"),
323
- query: optionalString(ctx, "query"),
324
- fields: optionalJson(ctx, "fields"),
325
- limit: optionalNumber(ctx, "limit"),
326
- offset: optionalNumber(ctx, "offset")
327
- })
328
- });
329
-
330
- // src/commands/te-meta/entity/create-entity.ts
331
- var createEntity = createMcpCommand({
332
- command: "+create_entity",
333
- description: "Create a new entity that links an event or user property as an analysis dimension.",
334
- flags: [
335
- { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" },
336
- { name: "entity_name", type: "string", required: true, desc: "Entity name" },
337
- { name: "column_name", type: "string", required: true, desc: "Property column name to associate with the entity" },
338
- { name: "table_type", type: "number", required: true, desc: "Table type: 0 = event property, 1 = user property" }
339
- ],
340
- risk: "write",
341
- mcpService: "te_analysis_extend",
342
- buildArgs: (ctx) => ({
343
- projectId: ctx.num("project_id"),
344
- entityName: ctx.str("entity_name"),
345
- columnName: ctx.str("column_name"),
346
- tableType: ctx.num("table_type")
347
- })
348
- });
349
-
350
- // src/commands/te-meta/entity/index.ts
351
- var commands3 = [listEntities, createEntity];
352
- var entity_default = commands3;
353
-
354
- // src/commands/te-meta/index.ts
355
- var commands4 = [
356
- ...meta_default,
357
- ...project_default,
358
- ...entity_default
359
- ];
360
- var te_meta_default = commands4;
361
- export {
362
- te_meta_default as default
363
- };
@@ -1,41 +0,0 @@
1
- # analysis_meta +batch_create_metadata (Batch Create Metadata)
2
-
3
- > **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
4
-
5
- Domain: **Metadata Query**
6
-
7
- ## Use Cases
8
- - Batch create SYSTEM METADATA in one atomic request (events/eventProperties/userProperties) and apply name-based associations. This tool is only for effective production metadata, not tracking-plan metadata. For bury plan draft/review/publish data, use BuryProgramTool only.
9
- - Do not use it to edit existing metadata; use `+batch_edit_metadata` after resolving the existing names.
10
-
11
- ## Output
12
- The response reports the batch creation outcome. Treat any item-level validation error as a failed item; do not assume the whole requested batch was created from transport success alone.
13
-
14
- ## Commands
15
- ```bash
16
- ae-cli analysis_meta +batch_create_metadata --project_id <project_id>
17
- ae-cli analysis_meta +batch_create_metadata --project_id <project_id> --events '[{"eventName":"purchase"}]' --event_properties '[{"propName":"price","selectType":"number"}]' --user_properties '[{"propName":"vip_level","selectType":"string"}]'
18
- ae-cli analysis_meta +batch_create_metadata --dry-run
19
- ```
20
-
21
- ## Parameters
22
- | Parameter | Required | Description |
23
- |---|---|---|
24
- | `--project_id` / `-p` | Yes | Project ID |
25
- | `--events` | No | Event creation list. Each item: eventName(required), eventDesc(optional), remark(optional), superEventPropNames(optional List<String>). |
26
- | `--event_properties` | No | Event property creation list. Each item: propName(required), selectType(required canonical: number/string/date/bool/list; aliases like datetime/timestamp/time auto-normalize to date), propDesc(optional, defaults to propName when omitted), propRemark(optional), commonProp(optional boolean), superEventNames(optional List<String>). |
27
- | `--user_properties` | No | User property creation list. Each item: propName(required), selectType(required canonical: number/string/date/bool/list; aliases like datetime/timestamp/time auto-normalize to date), propDesc(optional, defaults to propName when omitted), propRemark(optional). |
28
-
29
- ## Decision Rules
30
- - For the first run, pass only the required parameter (`--project_id`) to confirm the path works, then add optional parameters.
31
- - Wrap JSON parameters in single quotes (for example `--events '{}'` and `--event_properties '{}'`) to avoid shell escaping issues.
32
- - At least one non-empty list among `--events`, `--event_properties`, and `--user_properties` must be provided.
33
- - For cross-project troubleshooting, first confirm whether `--project_id` matches the current permissions and target environment.
34
- - This is an ordinary `write` operation and does not require CLI confirmation.
35
-
36
- ## Next Steps After Failure
37
- - If required parameters are missing, fall back to the smallest runnable command and fill them in first (focus on `--project_id`).
38
- - If `Invalid JSON` appears, first validate with the smallest JSON structure (such as `{}` or `[]`), then add fields step by step.
39
-
40
- ## Recommended Chaining
41
- - +batch_create_metadata -> +batch_edit_metadata
@@ -1,39 +0,0 @@
1
- # analysis_meta +batch_edit_metadata (Batch Edit Metadata)
2
-
3
- > **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
4
-
5
- Domain: **Metadata Query**
6
-
7
- ## Use Cases
8
- - Batch edit SYSTEM METADATA already effective in project (super events / event properties / user properties). Do NOT use for tracking-plan metadata (bury/track program); tracking plan operations must use BuryProgramTool. Routing rule: if target is planned/unpublished bury metadata, never call this tool.
9
- - Batch edit SYSTEM METADATA already effective in project (super events / event properties / user properties).
10
-
11
- ## Output
12
- The response reports the batch update outcome. Review item-level failures before claiming that every requested metadata item changed.
13
-
14
- ## Command
15
- ```bash
16
- ae-cli analysis_meta +batch_edit_metadata --project_id <project_id> --type event --items '[{"eventName":"purchase","eventDesc":"Purchase"}]'
17
- ae-cli analysis_meta +batch_edit_metadata --dry-run
18
- ```
19
-
20
- ## Parameters
21
- | Parameter | Required | Description |
22
- |---|---|---|
23
- | `--project_id` / `-p` | Yes | Project ID |
24
- | `--type` | Yes | Type of metadata to update: event, event_property, or user_property |
25
- | `--items` | Yes | Batch update list. For event: eventName (required), eventDesc (optional), remark (optional). For properties: propName (required), propDesc (optional), remark (optional). |
26
-
27
- ## Decision Rules
28
- - First run should only pass required parameters (`--project_id`, `--type`, `--items`), and add optional parameters only after the path is confirmed to work.
29
- - Wrap JSON arguments in single quotes (for example `--items '{}'`) to avoid shell escaping issues.
30
- - `--type` only accepts `event`, `event_property`, and `user_property`.
31
- - For cross-project troubleshooting, first confirm whether `--project_id` matches the current permissions and target environment.
32
- - This is an ordinary `write` operation and does not require CLI confirmation.
33
-
34
- ## Next Steps After Failure
35
- - If required parameters are missing, fall back to the smallest runnable command and fill them in (focus on `--project_id`, `--type`, and `--items`).
36
- - If `Invalid JSON` occurs, validate with the smallest JSON structure first (for example `{}` or `[]`), then add fields step by step.
37
-
38
- ## Recommended Chaining
39
- - +batch_edit_metadata -> +batch_create_metadata
@@ -1,38 +0,0 @@
1
- # analysis +cancel_query (cancel MCP query)
2
-
3
- > **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
4
-
5
- Domain: **Query lifecycle**
6
-
7
- ## Use Cases
8
- - Cancel a running MCP query when the user asks to stop waiting.
9
- - Cancel a query when the caller or agent timed out before the query returned but it may still be running on the server.
10
- - Cancel a query by the same `requestId` that was supplied to or returned by a previous query command.
11
- - For proactive cancellation, pass `requestId` to the query tool before starting it, then call `cancel_query` with the same value if you stop waiting.
12
- - If a query returns `fetch failed`, hits an HTTP timeout, or the caller stops waiting, the backend query may still be running; call `+cancel_query --request_id <same value>` with the preset `requestId`.
13
- - MCP query tools require caller-supplied `requestId`; generate and pass it before starting any cancelable query, then reuse the same value if cleanup is needed.
14
-
15
- ## Command
16
- ```bash
17
- ae-cli analysis +cancel_query --request_id mcp_0123456789abcdef0123456789abcdef
18
- ae-cli analysis +cancel_query --request_id mcp_0123456789abcdef0123456789abcdef --reason "agent timeout"
19
- ae-cli analysis +cancel_query --request_id mcp_0123456789abcdef0123456789abcdef --dry-run
20
- ```
21
-
22
- ## Parameters
23
- | Parameter | Required | Description |
24
- |---|---|---|
25
- | `--request_id` | Yes | Request ID returned by a query tool in `metadata.requestId`, or the requestId supplied before starting the query. It must use `mcp_<32 lowercase hex UUID>`, for example `mcp_0123456789abcdef0123456789abcdef`. |
26
- | `--reason` | No | Optional cancellation reason. Default: `MCP_CANCEL_QUERY_TOOL`. |
27
-
28
- ## Decision Rules
29
- - This is an ordinary `write` operation and does not require CLI confirmation.
30
- - The request must belong to the current MCP user. Otherwise the service returns `REQUEST_NOT_FOUND_OR_NOT_OWNED`.
31
- - Do not invent a request ID. Use the ID from the query response or the ID explicitly supplied to the original query.
32
- - This command cancels by request ID only. It does not cancel by SQL text, report ID, dashboard ID, BI panel ID, run ID, or tool call ID.
33
- - For query commands that expose `--request_id`, supplying a stable ID before execution is required. Use `mcp_<32 lowercase hex UUID>`, for example `mcp_0123456789abcdef0123456789abcdef`, so proactive cancellation does not depend on waiting for the response metadata.
34
- - For query commands that may exceed the CLI/MCP HTTP timeout, preset `--request_id`; if `fetch failed`, HTTP timeout, or caller timeout happens, immediately call `+cancel_query --request_id <same value>`.
35
-
36
- ## Next Steps on Failure
37
- - If `REQUEST_NOT_FOUND_OR_NOT_OWNED` appears, verify the request ID, user identity, host, and whether the original query already finished.
38
- - If cancellation succeeds but the UI still shows stale data, refresh the query status/result surface rather than sending another cancel blindly.
@@ -1,47 +0,0 @@
1
- # analysis +create_alert (Create 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
- - Create a new alert. After creation, use list_alerts or get_alert to retrieve the created alert. See get_alert_definition_schema for the parameter structure.
10
- - Create a new alert.
11
-
12
- ## Mandatory prerequisites (MUST)
13
- - Before constructing `--definition`, you must first read and follow:
14
- - [`./get_alert_definition_schema.md`](./get_alert_definition_schema.md)
15
- - Do not generate the final `definition` until the documentation review and schema call are complete.
16
-
17
- ## Prerequisite call chain (required for constructing 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 `definition` from the schema, then call `+create_alert`.
21
-
22
- ## Command
23
- ```bash
24
- ae-cli analysis +create_alert --project_id <project_id> --definition '{}'
25
- ae-cli analysis +create_alert --dry-run
26
- ```
27
-
28
- ## Parameters
29
- | Parameter | Required | Description |
30
- |---|---|---|
31
- | `--project_id` / `-p` | Yes | Project ID |
32
- | `--definition` | Yes | Alert definition JSON. MUST call `+get_alert_definition_schema` first and strictly follow the returned structure. |
33
-
34
- ## Decision Rules
35
- - `definition` cannot be written from experience alone: it must satisfy the alert schema structure constraints.
36
- - On the first run, start with only the required parameters (`--project_id`, `--definition`) and add optional parameters after confirming the path works.
37
- - Wrap JSON parameters in single quotes (for example `--definition '{}'`) to avoid shell escaping issues.
38
- - For cross-project troubleshooting, first confirm whether `--project_id` matches the current permissions and target environment.
39
- - This is an ordinary `write` operation and does not require CLI confirmation.
40
-
41
- ## Next Steps on Failure
42
- - If required parameters are missing, fall back to the smallest runnable command and fill them in first (focus on `--project_id` and `--definition`).
43
- - If `Invalid JSON` appears, first check the schema required fields and enumeration values, then add fields incrementally.
44
- - If the result after writing does not match expectations, immediately read back the corresponding list/get interface to compare before and after.
45
-
46
- ## Recommended chaining
47
- - +get_alert_definition_schema -> +create_alert
@@ -1,39 +0,0 @@
1
- # analysis_meta +create_entity (Create Entity)
2
-
3
- > **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
4
-
5
- Domain: **Entity Management**
6
-
7
- ## Use Cases
8
- - Create a new entity that links an event property or user property as an analysis dimension.
9
- - Use `+list_entities` first to confirm the entity does not already exist.
10
-
11
- ## Commands
12
- ```bash
13
- ae-cli analysis_meta +create_entity --project_id <project_id> --entity_name "User Entity" --column_name user_id --table_type 1
14
- ae-cli analysis_meta +create_entity --project_id <project_id> --entity_name "Event Entity" --column_name event_col --table_type 0
15
- ae-cli analysis_meta +create_entity --dry-run
16
- ```
17
-
18
- ## Parameters
19
- | Parameter | Required | Description |
20
- |---|---|---|
21
- | `--project_id` / `-p` | Yes | Project ID |
22
- | `--entity_name` | Yes | Entity name |
23
- | `--column_name` | Yes | Property column name to associate with the entity |
24
- | `--table_type` | Yes | Table type: `0` = event property, `1` = user property |
25
-
26
- ## Decision Rules
27
- - `--table_type` must be `0` (event property) or `1` (user property); no other values are accepted.
28
- - Before using `--column_name`, call `analysis-meta property list` to verify it exists. If the same column name appears in **both** event properties and user properties, **stop and ask the user which table type to use** — do not guess `--table_type`. Ask every time this condition is met; never carry over the answer from a previous request.
29
- - For the first run, pass only the required parameters and confirm before adding others.
30
- - This is an ordinary `write` operation and does not require CLI confirmation.
31
-
32
- ## Next Steps After Failure
33
- - If `PROJECT_ID_REQUIRED` or `ENTITY_NAME_REQUIRED` appears, check that all required parameters are provided.
34
- - If `INVALID_TABLE_TYPE` appears, verify `--table_type` is exactly `0` or `1`.
35
- - If the result after writing is not as expected, use `analysis_meta +list_entities` to compare before and after.
36
-
37
- ## Recommended Chaining
38
- - `analysis_meta +list_entities` → `+create_entity`
39
- - `analysis-meta property list` → `+create_entity`
@@ -1,39 +0,0 @@
1
- # analysis_meta +create_project_mark_time (Create 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
- - Create a project date marker. Returns the new marker ID, timestamp, content, and visibility status.
9
- - Create a project date marker.
10
- - Do not use it to modify an existing marker; use `+update_project_mark_time` with the verified marker ID.
11
-
12
- ## Command
13
- ```bash
14
- ae-cli analysis_meta +create_project_mark_time --project_id <project_id> --marked_at '2026-04-09 10:00' --content demo
15
- ae-cli analysis_meta +create_project_mark_time --project_id <project_id> --marked_at '2026-04-09 10:00' --zone_offset 8 --content demo --is_visible 1
16
- ae-cli analysis_meta +create_project_mark_time --dry-run
17
- ```
18
-
19
- ## Parameters
20
- | Parameter | Required | Description |
21
- |---|---|---|
22
- | `--project_id` / `-p` | Yes | Project ID |
23
- | `--marked_at` | Yes | Marker timestamp. Format: yyyy-MM-dd HH:mm |
24
- | `--zone_offset` | No | Marker time zone offset |
25
- | `--content` | Yes | Marker content |
26
- | `--is_visible` | No | Whether the marker is visible. Default: 1 |
27
-
28
- ## Decision Rules
29
- - First run should only pass required parameters (`--project_id`, `--marked_at`, `--content`), and add optional parameters only after the path is confirmed to work.
30
- - For date/time ranges, first validate with a short range, then expand the range step by step.
31
- - For cross-project troubleshooting, first confirm whether `--project_id` matches the current permissions and target environment.
32
- - This is an ordinary `write` operation and does not require CLI confirmation.
33
-
34
- ## Next Steps After Failure
35
- - If required parameters are missing, fall back to the smallest runnable command and fill them in (focus on `--project_id`, `--marked_at`, and `--content`).
36
- - If the result after writing is not as expected, immediately read back the corresponding list/get interface for a before-and-after comparison.
37
-
38
- ## Recommended Chaining
39
- - +create_project_mark_time -> +list_project_mark_times
@@ -1,32 +0,0 @@
1
- # analysis +delete_alert (Delete Alert)
2
-
3
- > **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
4
-
5
- Domain: **Alert Management**
6
-
7
- ## Use Cases
8
- - Permanently delete an alert by its ID.
9
- - Do not use this command to disable or edit an alert; use `+update_alert` when the alert must remain.
10
-
11
- ## Output
12
- Success confirms that the specified alert was deleted. The command does not return alert data; use `+list_alerts` to verify it is absent.
13
-
14
- ## Commands
15
- ```bash
16
- ae-cli analysis +delete_alert --project_id <project_id> --alert_id <alert_id> --dry-run
17
- # Summarize the target and impact, then wait for explicit user confirmation.
18
- ae-cli analysis +delete_alert --project_id <project_id> --alert_id <alert_id> --yes
19
- ```
20
-
21
- ## Parameters
22
- | Parameter | Required | Description |
23
- |---|---|---|
24
- | `--project_id` / `-p` | Yes | Project ID |
25
- | `--alert_id` | Yes | Alert ID to delete |
26
-
27
- ## Decision Rules
28
- - Use `+list_alerts` first to confirm the alert ID before deleting.
29
- - This is `high-risk-write`: inspect the dry-run, summarize the target and impact, and wait for explicit user confirmation before the `--yes` execution.
30
-
31
- ## Recommended Chain
32
- - `+list_alerts` -> `+delete_alert`