@thinkingai/ae-cli 6.0.27 → 6.0.28

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 (64) hide show
  1. package/dist/index.js +1 -1
  2. package/dist/{te-analysis-QMZ2UH7F.js → te-analysis-5WZKVFHI.js} +1158 -302
  3. package/dist/{te-analysis-2U5EPXQC.js → te-analysis-KAEZXLNS.js} +1158 -302
  4. package/package.json +1 -1
  5. package/skills/ae-analysis/SKILL.md +56 -4
  6. package/skills/ae-analysis/references/analysis_gateway_assets.md +7 -5
  7. package/skills/ae-analysis/references/asset_abnormal_get.md +27 -0
  8. package/skills/ae-analysis/references/asset_abnormal_list.md +24 -0
  9. package/skills/ae-analysis/references/asset_authentication_list.md +23 -0
  10. package/skills/ae-analysis/references/asset_authentication_update.md +24 -0
  11. package/skills/ae-analysis/references/asset_recent_list.md +24 -0
  12. package/skills/ae-analysis/references/asset_search.md +24 -0
  13. package/skills/ae-analysis/references/bi_panel_get.md +5 -0
  14. package/skills/ae-analysis/references/bi_panel_share.md +6 -0
  15. package/skills/ae-analysis/references/bi_panel_update.md +4 -1
  16. package/skills/ae-analysis/references/bi_panel_version_get.md +23 -0
  17. package/skills/ae-analysis/references/bi_panel_version_publish.md +20 -0
  18. package/skills/ae-analysis/references/dashboard_daily_report_send.md +6 -1
  19. package/skills/ae-analysis/references/dashboard_report_data_export.md +6 -0
  20. package/skills/ae-analysis/references/dashboard_report_data_run.md +6 -0
  21. package/skills/ae-analysis/references/datatable_columns_get.md +24 -0
  22. package/skills/ae-analysis/references/datatable_influence_list.md +24 -0
  23. package/skills/ae-analysis/references/datatable_version_get.md +24 -0
  24. package/skills/ae-analysis/references/datatable_version_list.md +24 -0
  25. package/skills/ae-analysis/references/event_changelog_list.md +24 -0
  26. package/skills/ae-analysis/references/event_create.md +24 -0
  27. package/skills/ae-analysis/references/event_delete.md +24 -0
  28. package/skills/ae-analysis/references/event_get.md +24 -0
  29. package/skills/ae-analysis/references/event_hide_update.md +25 -0
  30. package/skills/ae-analysis/references/event_influence_list.md +24 -0
  31. package/skills/ae-analysis/references/event_list.md +23 -0
  32. package/skills/ae-analysis/references/event_relation_update.md +24 -0
  33. package/skills/ae-analysis/references/event_update.md +26 -0
  34. package/skills/ae-analysis/references/exchange_config_update.md +24 -0
  35. package/skills/ae-analysis/references/exchange_rate_refresh.md +23 -0
  36. package/skills/ae-analysis/references/exchange_rule_list.md +23 -0
  37. package/skills/ae-analysis/references/exchange_rule_update.md +24 -0
  38. package/skills/ae-analysis/references/exchange_rule_validate.md +24 -0
  39. package/skills/ae-analysis/references/metric_create.md +24 -0
  40. package/skills/ae-analysis/references/metric_delete.md +24 -0
  41. package/skills/ae-analysis/references/metric_get.md +24 -0
  42. package/skills/ae-analysis/references/metric_list.md +24 -0
  43. package/skills/ae-analysis/references/metric_update.md +24 -0
  44. package/skills/ae-analysis/references/property_changelog_list.md +25 -0
  45. package/skills/ae-analysis/references/property_create.md +25 -0
  46. package/skills/ae-analysis/references/property_delete.md +25 -0
  47. package/skills/ae-analysis/references/property_get.md +25 -0
  48. package/skills/ae-analysis/references/property_hide_update.md +26 -0
  49. package/skills/ae-analysis/references/property_influence_list.md +25 -0
  50. package/skills/ae-analysis/references/property_list.md +24 -0
  51. package/skills/ae-analysis/references/property_related_events.md +24 -0
  52. package/skills/ae-analysis/references/property_relation_update.md +25 -0
  53. package/skills/ae-analysis/references/property_update.md +27 -0
  54. package/skills/ae-analysis/references/super_metadata_export.md +36 -0
  55. package/skills/ae-analysis/references/super_metadata_import.md +24 -0
  56. package/skills/ae-analysis/references/virtual_event_create.md +25 -0
  57. package/skills/ae-analysis/references/virtual_event_delete.md +24 -0
  58. package/skills/ae-analysis/references/virtual_event_get.md +24 -0
  59. package/skills/ae-analysis/references/virtual_property_create.md +24 -0
  60. package/skills/ae-analysis/references/virtual_property_sql_rule_delete.md +25 -0
  61. package/skills/ae-analysis/references/virtual_property_sql_rule_update.md +24 -0
  62. package/skills/ae-generate-tracking-code/SKILL.md +16 -1
  63. package/skills/ae-generate-tracking-code/references/snippet-delivery.md +17 -1
  64. package/skills/ae-generate-tracking-plan/SKILL.md +30 -8
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@thinkingai/ae-cli",
3
- "version": "6.0.27",
3
+ "version": "6.0.28",
4
4
  "description": "CLI tool for ThinkingAI (AE) analytics platform",
5
5
  "type": "module",
6
6
  "bin": {
@@ -75,6 +75,7 @@ ae-cli analysis dashboard-report-data export --project-id <project_id> --dashboa
75
75
  ae-cli analysis run inspect --run-id <run_id>
76
76
  ae-cli analysis artifact download --run-id <run_id> --artifact-id <artifact_id> --output <file>
77
77
  ae-cli analysis bi-panel-page-data run --project-id <project_id> --panel-id <panel_id> --page-key <page_key> --result-type charts
78
+ ae-cli analysis bi-panel-version get --project-id <project_id> --panel-id <panel_id> --version-type draft
78
79
  ae-cli analysis project-space list --project-id <project_id>
79
80
  ae-cli analysis query cancel --run-id <run_id>
80
81
  ```
@@ -85,13 +86,13 @@ Use capability-gateway asset commands when the user wants to manage or inspect:
85
86
  - Dashboard report data that may be large or long-running. Prefer `dashboard-report-data export` for large results; use `run` only for bounded inline results.
86
87
  - Dashboard definition export/import. Use `dashboard-definition import --validate-only true` for import pre-checks; do not look for a separate import-check command.
87
88
  - Dashboard daily report update or immediate send.
88
- - BI panel list/detail/create/update/delete/share/copy and BI page data. Prefer `bi-panel-page-data export` for large results.
89
+ - BI panel list/detail/create/update/delete/share/copy, BI panel release/draft version get/publish, and BI page data. Prefer `bi-panel-page-data export` for large results.
89
90
  - Project spaces, folders, favorites, and public links.
90
91
 
91
92
  Do **not** use these commands for:
92
93
 
93
94
  - Ad-hoc model analysis, report definition, report data, drilldown, entity/event details, metadata/schema helpers, alerts, audience clusters/tags, or project lookup. Use the existing `+<tool_name>` commands for those.
94
- - Dashboard locks, BI panel version/lock, dashboard filter module, UI reorder/move/tree operations, daily report retry/download/get-config, public-link logs/source-list/get, or other product-manager-red-marked abilities.
95
+ - Dashboard locks, BI panel lock, dashboard filter module, UI reorder/move/tree operations, daily report retry/download/get-config, public-link logs/source-list/get, or other product-manager-red-marked abilities.
95
96
  - Internal-only or UI-only payloads unless the gateway command reference explicitly exposes them through `--payload`.
96
97
 
97
98
  Capability-gateway output:
@@ -361,7 +362,58 @@ After outputting attribution results, verify that dimension contributions sum to
361
362
 
362
363
  ## Tool Groups (100)
363
364
 
364
- ### analysis (61)
365
+ ### analysis (108)
366
+
367
+
368
+ Metadata Capabilities (47):
369
+
370
+ - `asset abnormal-get` ([doc](references/asset_abnormal_get.md))
371
+ - `asset abnormal-list` ([doc](references/asset_abnormal_list.md))
372
+ - `asset authentication-list` ([doc](references/asset_authentication_list.md))
373
+ - `asset authentication-update` ([doc](references/asset_authentication_update.md))
374
+ - `asset recent-list` ([doc](references/asset_recent_list.md))
375
+ - `asset search` ([doc](references/asset_search.md))
376
+ - `datatable columns-get` ([doc](references/datatable_columns_get.md))
377
+ - `datatable influence-list` ([doc](references/datatable_influence_list.md))
378
+ - `datatable version-get` ([doc](references/datatable_version_get.md))
379
+ - `datatable version-list` ([doc](references/datatable_version_list.md))
380
+ - `event changelog-list` ([doc](references/event_changelog_list.md))
381
+ - `event create` ([doc](references/event_create.md))
382
+ - `event delete` ([doc](references/event_delete.md))
383
+ - `event get` ([doc](references/event_get.md))
384
+ - `event hide-update` ([doc](references/event_hide_update.md))
385
+ - `event influence-list` ([doc](references/event_influence_list.md))
386
+ - `event list` ([doc](references/event_list.md))
387
+ - `event relation-update` ([doc](references/event_relation_update.md))
388
+ - `event update` ([doc](references/event_update.md))
389
+ - `exchange config-update` ([doc](references/exchange_config_update.md))
390
+ - `exchange rate-refresh` ([doc](references/exchange_rate_refresh.md))
391
+ - `exchange rule-list` ([doc](references/exchange_rule_list.md))
392
+ - `exchange rule-update` ([doc](references/exchange_rule_update.md))
393
+ - `exchange rule-validate` ([doc](references/exchange_rule_validate.md))
394
+ - `metric create` ([doc](references/metric_create.md))
395
+ - `metric delete` ([doc](references/metric_delete.md))
396
+ - `metric get` ([doc](references/metric_get.md))
397
+ - `metric list` ([doc](references/metric_list.md))
398
+ - `metric update` ([doc](references/metric_update.md))
399
+ - `property changelog-list` ([doc](references/property_changelog_list.md))
400
+ - `property create` ([doc](references/property_create.md))
401
+ - `property delete` ([doc](references/property_delete.md))
402
+ - `property get` ([doc](references/property_get.md))
403
+ - `property hide-update` ([doc](references/property_hide_update.md))
404
+ - `property influence-list` ([doc](references/property_influence_list.md))
405
+ - `property list` ([doc](references/property_list.md))
406
+ - `property related-events` ([doc](references/property_related_events.md))
407
+ - `property relation-update` ([doc](references/property_relation_update.md))
408
+ - `property update` ([doc](references/property_update.md))
409
+ - `super-metadata export` ([doc](references/super_metadata_export.md))
410
+ - `super-metadata import` ([doc](references/super_metadata_import.md))
411
+ - `virtual-event create` ([doc](references/virtual_event_create.md))
412
+ - `virtual-event delete` ([doc](references/virtual_event_delete.md))
413
+ - `virtual-event get` ([doc](references/virtual_event_get.md))
414
+ - `virtual-property create` ([doc](references/virtual_property_create.md))
415
+ - `virtual-property sql-rule-delete` ([doc](references/virtual_property_sql_rule_delete.md))
416
+ - `virtual-property sql-rule-update` ([doc](references/virtual_property_sql_rule_update.md))
365
417
 
366
418
  Alerts (6):
367
419
  - `+get_alert_definition_schema` ([doc](references/get_alert_definition_schema.md))
@@ -498,4 +550,4 @@ npm run verify:analysis-common-tools
498
550
 
499
551
  ## Reference Docs
500
552
 
501
- See the unified `references/` directory (79 command docs total).
553
+ See the unified `references/` directory (126 command docs total).
@@ -14,7 +14,7 @@ This file is an overview only. Before running one command, read the dedicated co
14
14
 
15
15
  ## When to use
16
16
 
17
- Use these commands for dashboard, BI panel, project-space, folder, favorite, public-link, dashboard-definition, dashboard-daily-report, and dashboard/BI page data workflows.
17
+ Use these commands for dashboard, BI panel, BI panel version, project-space, folder, favorite, public-link, dashboard-definition, dashboard-daily-report, and dashboard/BI page data workflows.
18
18
 
19
19
  Prefer export commands for long-running or large data:
20
20
 
@@ -28,7 +28,7 @@ ae-cli analysis query cancel --run-id run_0123456789abcdef0123456789abcdef
28
28
 
29
29
  ## When not to use
30
30
 
31
- Do not use these commands for ad-hoc model analysis, report definition, report data, drilldown, schema helpers, alerts, audience clusters/tags, project lookup, metadata governance, dashboard locks, BI panel version/lock, dashboard filters, UI reorder/tree/move operations, daily report retry/download/get-config, or public-link logs/source-list/get. Use the existing `+<tool_name>` references for those.
31
+ Do not use these commands for ad-hoc model analysis, report definition, report data, drilldown, schema helpers, alerts, audience clusters/tags, project lookup, metadata governance, dashboard locks, BI panel lock, dashboard filters, UI reorder/tree/move operations, daily report retry/download/get-config, or public-link logs/source-list/get. Use the existing `+<tool_name>` references for those.
32
32
 
33
33
  ## Output
34
34
 
@@ -82,7 +82,7 @@ Prefer the run/artifact commands over hand-written HTTP, Python, or curl. The de
82
82
  | `dashboard freeze` | `analysis.dashboard.freeze` | Freeze/unfreeze dashboards | `--dashboard-ids`, optional `--freeze false` | Freeze status |
83
83
  | `dashboard abnormal-get` | `analysis.dashboard.abnormal_get` | Inspect abnormal dependencies | `--dashboard-id` | Abnormal info |
84
84
  | `dashboard task-status` | `analysis.dashboard.task_status` | Inspect scheduled task status | `--dashboard-id` | Task status |
85
- | `dashboard-report-data run` | `analysis.dashboard_report_data.run` | Bounded inline dashboard report data | `--dashboard-id`, optional `--report-ids`, `--start-time`, `--end-time`, `--limit` | Inline data |
85
+ | `dashboard-report-data run` | `analysis.dashboard_report_data.run` | Bounded inline dashboard report data; `--filters` is analysis Filter JSON from `+get_filter_schema` | `--dashboard-id`, optional `--report-ids`, `--filters`, `--start-time`, `--end-time`, `--limit` | Inline data |
86
86
  | `dashboard-report-data export` | `analysis.dashboard_report_data.export` | Large/long dashboard report data | same as run, plus optional `--artifact-format jsonl` | Async artifact descriptor |
87
87
  | `run inspect` | `analysis.run.inspect` | Poll async export status | `--run-id` | Run and artifact status |
88
88
  | `artifact download` | `analysis.artifact.download` | Download run-bound export artifact | `--run-id`, `--artifact-id`, `--output` | Local output file info |
@@ -90,14 +90,16 @@ Prefer the run/artifact commands over hand-written HTTP, Python, or curl. The de
90
90
  | `dashboard-definition export` | `analysis.dashboard_definition.export` | Export dashboard definition JSON | `--dashboard-id`, `--dashboard-ids`, `--dashboard-folder-ids`, `--shared-spaces`, or `--payload` | Definition JSON |
91
91
  | `dashboard-definition import` | `analysis.dashboard_definition.import` | Validate/import dashboard definition | `--definition`, optional `--validate-only true` | Validation or import result |
92
92
  | `dashboard-daily-report update` | `analysis.dashboard_daily_report.update` | Update daily report config; defaults are sent when `--payload` is absent | `--dashboard-id`, optional config flags or `--payload` | Config result |
93
- | `dashboard-daily-report send` | `analysis.dashboard_daily_report.send` | Send daily report immediately; defaults are sent when `--payload` is absent | `--dashboard-id`, optional config flags or `--payload` | Async send result |
93
+ | `dashboard-daily-report send` | `analysis.dashboard_daily_report.send` | Send daily report immediately; no config flags means use saved config, missing saved config fails | `--dashboard-id`, optional config flags or `--payload` | Async send result |
94
94
  | `bi-panel list` | `analysis.bi_panel.list` | Find accessible BI panels | `--project-id`, optional list filters | Paginated BI panel summaries |
95
- | `bi-panel get` | `analysis.bi_panel.get` | Inspect released BI panel page structure | `--panel-id`, optional `--fields` | Panel structure |
95
+ | `bi-panel get` | `analysis.bi_panel.get` | Inspect released BI panel page structure only | `--panel-id`, optional `--fields` | Panel structure |
96
96
  | `bi-panel create` | `analysis.bi_panel.create` | Create a BI panel | optional `--panel-name`, `--payload` | Created panel |
97
97
  | `bi-panel update` | `analysis.bi_panel.update` | Update BI panel content/metadata | optional `--payload` | Update result |
98
98
  | `bi-panel delete` | `analysis.bi_panel.delete` | Delete BI panels | `--panel-ids '[...]'` | Delete result |
99
99
  | `bi-panel share` | `analysis.bi_panel.share` | Modify BI panel sharing | `--panel-id`, `--payload` | Share update result |
100
100
  | `bi-panel copy` | `analysis.bi_panel.copy` | Copy a BI panel | optional source/target flags and `--payload` | Copied panel |
101
+ | `bi-panel-version get` | `analysis.bi_panel_version.get` | Inspect BI panel released or draft version | `--panel-id` or `--panel-uuid`, optional `--version-type release|draft` | Version detail |
102
+ | `bi-panel-version publish` | `analysis.bi_panel_version.publish` | Publish current BI panel draft after source version matches | `--panel-id` or `--panel-uuid`, `--source-version` | Published version |
101
103
  | `bi-panel-page-data run` | `analysis.bi_panel_page_data.run` | Bounded inline BI page data | `--panel-id`, `--page-key`, `--result-type charts|summary` | Inline page data |
102
104
  | `bi-panel-page-data export` | `analysis.bi_panel_page_data.export` | Large/long BI page data | same as run, optional `--artifact-format jsonl` | Async artifact descriptor |
103
105
  | `project-space list` | `analysis.project_space.list` | Find accessible project spaces | `--project-id`, optional list filters | Paginated project spaces |
@@ -0,0 +1,27 @@
1
+ # analysis asset abnormal-get
2
+
3
+ Use when the user needs to get abnormal reason for one asset.
4
+
5
+ Do not use this command for unrelated analysis queries, ad-hoc query construction, or MCP metadata discovery when an existing specialized command already fits the user's request.
6
+
7
+ Command:
8
+
9
+ ```bash
10
+ ae-cli analysis asset abnormal-get --project-id <project_id> --resource-type <resource_type> --resource-id <resource_id> --resource-name <resource_name> --table-type <table_type>
11
+ ae-cli analysis asset abnormal-get --dry-run
12
+ ```
13
+
14
+ Capability id: `metadata.asset_abnormal.get`.
15
+
16
+ Input sends `project_id`, `resource_type`, `resource_id`, `resource_name`, `table_type`.
17
+
18
+ Output is the gateway envelope. `data` contains the common-service capability result.
19
+
20
+ ## Parameters
21
+ | Parameter | Required | Description |
22
+ |---|---|---|
23
+ | `--project-id` | Yes | Numeric project ID. |
24
+ | `--resource-type` | Yes | Resource type. |
25
+ | `--resource-id` | No | Resource ID. |
26
+ | `--resource-name` | No | Resource name. |
27
+ | `--table-type` | No | Property table type when the resource is a property. |
@@ -0,0 +1,24 @@
1
+ # analysis asset abnormal-list
2
+
3
+ Use when the user needs to list abnormal assets by resource type.
4
+
5
+ Do not use this command for unrelated analysis queries, ad-hoc query construction, or MCP metadata discovery when an existing specialized command already fits the user's request.
6
+
7
+ Command:
8
+
9
+ ```bash
10
+ ae-cli analysis asset abnormal-list --project-id <project_id> --resource-types <resource_types>
11
+ ae-cli analysis asset abnormal-list --dry-run
12
+ ```
13
+
14
+ Capability id: `metadata.asset_abnormal.list`.
15
+
16
+ Input sends `project_id`, `resource_types`.
17
+
18
+ Output is the gateway envelope. `data` contains the common-service capability result.
19
+
20
+ ## Parameters
21
+ | Parameter | Required | Description |
22
+ |---|---|---|
23
+ | `--project-id` | Yes | Numeric project ID. |
24
+ | `--resource-types` | Yes | Resource types to query. |
@@ -0,0 +1,23 @@
1
+ # analysis asset authentication-list
2
+
3
+ Use when the user needs to list authenticatable project assets and authentication status.
4
+
5
+ Do not use this command for unrelated analysis queries, ad-hoc query construction, or MCP metadata discovery when an existing specialized command already fits the user's request.
6
+
7
+ Command:
8
+
9
+ ```bash
10
+ ae-cli analysis asset authentication-list --project-id <project_id>
11
+ ae-cli analysis asset authentication-list --dry-run
12
+ ```
13
+
14
+ Capability id: `metadata.asset_authentication.list`.
15
+
16
+ Input sends `project_id`.
17
+
18
+ Output is the gateway envelope. `data` contains the common-service capability result.
19
+
20
+ ## Parameters
21
+ | Parameter | Required | Description |
22
+ |---|---|---|
23
+ | `--project-id` | Yes | Numeric project ID. |
@@ -0,0 +1,24 @@
1
+ # analysis asset authentication-update
2
+
3
+ Use when the user needs to batch authenticate or unauthenticate assets.
4
+
5
+ Do not use this command for unrelated analysis queries, ad-hoc query construction, or MCP metadata discovery when an existing specialized command already fits the user's request.
6
+
7
+ Command:
8
+
9
+ ```bash
10
+ ae-cli analysis asset authentication-update --project-id <project_id> --payload '{}'
11
+ ae-cli analysis asset authentication-update --dry-run
12
+ ```
13
+
14
+ Capability id: `metadata.asset_authentication.update`.
15
+
16
+ Input sends `project_id`, `payload`.
17
+
18
+ Output is the gateway envelope. `data` contains the common-service capability result.
19
+
20
+ ## Parameters
21
+ | Parameter | Required | Description |
22
+ |---|---|---|
23
+ | `--project-id` | Yes | Numeric project ID. |
24
+ | `--payload` | Yes | Capability payload JSON. |
@@ -0,0 +1,24 @@
1
+ # analysis asset recent-list
2
+
3
+ Use when the user needs to list recently visited assets for the current user.
4
+
5
+ Do not use this command for unrelated analysis queries, ad-hoc query construction, or MCP metadata discovery when an existing specialized command already fits the user's request.
6
+
7
+ Command:
8
+
9
+ ```bash
10
+ ae-cli analysis asset recent-list --project-id <project_id> --payload '{}'
11
+ ae-cli analysis asset recent-list --dry-run
12
+ ```
13
+
14
+ Capability id: `metadata.asset.recent_list`.
15
+
16
+ Input sends `project_id`, `payload`.
17
+
18
+ Output is the gateway envelope. `data` contains the common-service capability result.
19
+
20
+ ## Parameters
21
+ | Parameter | Required | Description |
22
+ |---|---|---|
23
+ | `--project-id` | Yes | Numeric project ID. |
24
+ | `--payload` | Yes | Capability payload JSON. |
@@ -0,0 +1,24 @@
1
+ # analysis asset search
2
+
3
+ Use when the user needs to search project assets by keyword.
4
+
5
+ Do not use this command for unrelated analysis queries, ad-hoc query construction, or MCP metadata discovery when an existing specialized command already fits the user's request.
6
+
7
+ Command:
8
+
9
+ ```bash
10
+ ae-cli analysis asset search --project-id <project_id> --payload '{}'
11
+ ae-cli analysis asset search --dry-run
12
+ ```
13
+
14
+ Capability id: `metadata.asset.search`.
15
+
16
+ Input sends `project_id`, `payload`.
17
+
18
+ Output is the gateway envelope. `data` contains the common-service capability result.
19
+
20
+ ## Parameters
21
+ | Parameter | Required | Description |
22
+ |---|---|---|
23
+ | `--project-id` | Yes | Numeric project ID. |
24
+ | `--payload` | Yes | Capability payload JSON. |
@@ -2,6 +2,11 @@
2
2
 
3
3
  Use when the user needs one BI panel's released page structure.
4
4
 
5
+ This command reads only the released/queryable structure. It can fail with
6
+ `NOT_FOUND` for a newly created or draft-only panel. To inspect unpublished
7
+ edits, use `bi-panel-version get --version-type draft`. To make draft edits
8
+ queryable, publish them with `bi-panel-version publish`.
9
+
5
10
  Do not use to query chart data. Use `bi-panel-page-data run` or `bi-panel-page-data export`.
6
11
 
7
12
  Command:
@@ -12,4 +12,10 @@ ae-cli analysis bi-panel share --project-id <project_id> --panel-id <panel_id> [
12
12
 
13
13
  Input sends `project_id`, `panel_id`, and backend-compatible snake_case `payload`.
14
14
 
15
+ Supported payload fields include:
16
+
17
+ - `all_auth_user_authority`: project-wide BI panel authority. Use `READ`, `JUNIOR`, `SENIOR`, or `MAINTAIN`; `VIEWER` is accepted as `READ`.
18
+ - `auth_users`: user authority list.
19
+ - `auth_user_groups`: user-group authority list.
20
+
15
21
  Output is the gateway envelope. `data` contains the share update result.
@@ -2,7 +2,10 @@
2
2
 
3
3
  Use when the user wants to update BI panel content or metadata.
4
4
 
5
- Do not use for BI panel version or lock workflows; those are intentionally not CLI-enabled.
5
+ Do not use this command to verify draft content or publish a draft. `bi-panel get`
6
+ reads only the released/queryable version. Use `bi-panel-version get` to inspect
7
+ `release` or `draft`, and `bi-panel-version publish` to publish a matching draft
8
+ `source_version`.
6
9
 
7
10
  Command:
8
11
 
@@ -0,0 +1,23 @@
1
+ # analysis bi-panel-version get
2
+
3
+ Use when the user needs a BI panel's released version or unpublished draft version.
4
+
5
+ Do not use `bi-panel get` for draft verification; `bi-panel get` reads only the
6
+ released/queryable structure.
7
+
8
+ Command:
9
+
10
+ ```bash
11
+ ae-cli analysis bi-panel-version get --project-id <project_id> --panel-id <panel_id> --version-type draft
12
+ ae-cli analysis bi-panel-version get --project-id <project_id> --panel-uuid <panel_uuid> --version-type release
13
+ ```
14
+
15
+ Input sends `project_id`, one of `panel_id` or `panel_uuid`, optional
16
+ `version_type` (`release` by default), and optional `fields`.
17
+
18
+ Output is the gateway envelope. `data` contains `panel_id`, `panel_uuid`,
19
+ `requested_version_type`, `version_type`, `version`, `page_content`,
20
+ `panel_config`, and `worksheet_map`.
21
+
22
+ When the result is used before publishing, save `data.version` and pass it as
23
+ `--source-version` to `bi-panel-version publish`.
@@ -0,0 +1,20 @@
1
+ # analysis bi-panel-version publish
2
+
3
+ Use when the user wants to publish the current BI panel draft so `bi-panel get`
4
+ and BI page-data queries can read it as a released/queryable version.
5
+
6
+ Do not use this command blindly after `bi-panel update`. First inspect the draft with
7
+ `bi-panel-version get --version-type draft` and use the returned `data.version`
8
+ as `--source-version`. The gateway rejects stale `source_version` values.
9
+
10
+ Command:
11
+
12
+ ```bash
13
+ ae-cli analysis bi-panel-version publish --project-id <project_id> --panel-id <panel_id> --source-version <draft_version> --yes
14
+ ```
15
+
16
+ Input sends `project_id`, one of `panel_id` or `panel_uuid`, and required
17
+ `source_version`.
18
+
19
+ Output is the gateway envelope. `data` contains `panel_id`, `panel_uuid`,
20
+ `source_version_type`, `source_version`, and `published_version`.
@@ -12,6 +12,11 @@ ae-cli analysis dashboard-daily-report send --project-id <project_id> --dashboar
12
12
 
13
13
  Input sends `project_id`, `dashboard_id`, and optional daily report fields or `payload`.
14
14
 
15
- When `--payload` is absent, the command sends safe defaults expected by the gateway: `need_csv=false`, empty `host_url`, all channel switches false, `send_date=1,2,3,4,5,6,7`, `send_time=09:00`, `lang=zh-CN`, `screen_type=normal`, and `zone_offset=0`. When `--payload` is present, payload values remain authoritative; pass top-level flags only for fields you intentionally want to override.
15
+ Behavior:
16
+
17
+ - If no daily report config flags and no `--payload` are provided, the gateway uses the dashboard's saved daily report config.
18
+ - If the dashboard has no saved daily report config, the command fails with a stable business error instead of creating a misleading task.
19
+ - If any config flag or `--payload` is provided, the request config is used for this immediate send. Provide at least one valid channel, for example `--enable-dd true --dd-url '["https://..."]'`, or email fields such as `--enable-email true --email-login-users user@example.com`.
20
+ - Use `dashboard-daily-report update` to save or change scheduled daily report config.
16
21
 
17
22
  Output is the gateway envelope. `data` contains the immediate send result.
@@ -12,6 +12,12 @@ ae-cli analysis dashboard-report-data export --project-id <project_id> --dashboa
12
12
 
13
13
  Input sends `project_id`, `dashboard_id`, and optional `report_ids`, `filters`, `start_time`, `end_time`, `use_cache`, `request_id`, `timeout_seconds`, `format`. Use CLI flag `--artifact-format` for the gateway `format` input; `--format` is the CLI output formatter.
14
14
 
15
+ `--filters` is an analysis Filter JSON injected as `commonFilter.aiFilter` for each queried report. It is not a dashboard UI control dump. Use `ae-cli analysis +get_filter_schema` for the exact schema. Minimal shape:
16
+
17
+ ```json
18
+ {"relation":"and","filts":[{"field":{"type":"event_property","propertyName":"#event_name"},"operator":"equal","values":["login"]}]}
19
+ ```
20
+
15
21
  Output is the gateway envelope. `data` contains an async export descriptor with `run_id`, `artifact_id`, status fields, and expiration fields. It does not expose inspect/download API paths; use the CLI commands below.
16
22
 
17
23
  Follow-up workflow:
@@ -12,4 +12,10 @@ ae-cli analysis dashboard-report-data run --project-id <project_id> --dashboard-
12
12
 
13
13
  Input sends `project_id`, `dashboard_id`, and optional `report_ids`, `filters`, `start_time`, `end_time`, `use_cache`, `request_id`, `timeout_seconds`, `limit`.
14
14
 
15
+ `--filters` is an analysis Filter JSON injected as `commonFilter.aiFilter` for each queried report. It is not a dashboard UI control dump. Use `ae-cli analysis +get_filter_schema` for the exact schema. Minimal shape:
16
+
17
+ ```json
18
+ {"relation":"and","filts":[{"field":{"type":"event_property","propertyName":"#event_name"},"operator":"equal","values":["login"]}]}
19
+ ```
20
+
15
21
  Output is the gateway envelope. `data` contains bounded inline report data.
@@ -0,0 +1,24 @@
1
+ # analysis datatable columns-get
2
+
3
+ Use when the user needs to get columns for a project table reference.
4
+
5
+ Do not use this command for unrelated analysis queries, ad-hoc query construction, or MCP metadata discovery when an existing specialized command already fits the user's request.
6
+
7
+ Command:
8
+
9
+ ```bash
10
+ ae-cli analysis datatable columns-get --project-id <project_id> --table-ref <table_ref>
11
+ ae-cli analysis datatable columns-get --dry-run
12
+ ```
13
+
14
+ Capability id: `metadata.data_table.columns_get`.
15
+
16
+ Input sends `project_id`, `table_ref`.
17
+
18
+ Output is the gateway envelope. `data` contains the common-service capability result.
19
+
20
+ ## Parameters
21
+ | Parameter | Required | Description |
22
+ |---|---|---|
23
+ | `--project-id` | Yes | Numeric project ID. |
24
+ | `--table-ref` | Yes | Project table reference. |
@@ -0,0 +1,24 @@
1
+ # analysis datatable influence-list
2
+
3
+ Use when the user needs to list metadata and assets affected by data table deletion or column changes.
4
+
5
+ Do not use this command for unrelated analysis queries, ad-hoc query construction, or MCP metadata discovery when an existing specialized command already fits the user's request.
6
+
7
+ Command:
8
+
9
+ ```bash
10
+ ae-cli analysis datatable influence-list --project-id <project_id> --datatable-id <datatable_id>
11
+ ae-cli analysis datatable influence-list --dry-run
12
+ ```
13
+
14
+ Capability id: `metadata.data_table.influence_list`.
15
+
16
+ Input sends `project_id`, `datatable_id`.
17
+
18
+ Output is the gateway envelope. `data` contains the common-service capability result.
19
+
20
+ ## Parameters
21
+ | Parameter | Required | Description |
22
+ |---|---|---|
23
+ | `--project-id` | Yes | Numeric project ID. |
24
+ | `--datatable-id` | Yes | Data table ID. |
@@ -0,0 +1,24 @@
1
+ # analysis datatable version-get
2
+
3
+ Use when the user needs to get data table version detail.
4
+
5
+ Do not use this command for unrelated analysis queries, ad-hoc query construction, or MCP metadata discovery when an existing specialized command already fits the user's request.
6
+
7
+ Command:
8
+
9
+ ```bash
10
+ ae-cli analysis datatable version-get --project-id <project_id> --version-id <version_id>
11
+ ae-cli analysis datatable version-get --dry-run
12
+ ```
13
+
14
+ Capability id: `metadata.data_table_version.get`.
15
+
16
+ Input sends `project_id`, `version_id`.
17
+
18
+ Output is the gateway envelope. `data` contains the common-service capability result.
19
+
20
+ ## Parameters
21
+ | Parameter | Required | Description |
22
+ |---|---|---|
23
+ | `--project-id` | Yes | Numeric project ID. |
24
+ | `--version-id` | Yes | Data table version ID. |
@@ -0,0 +1,24 @@
1
+ # analysis datatable version-list
2
+
3
+ Use when the user needs to list data table historical versions.
4
+
5
+ Do not use this command for unrelated analysis queries, ad-hoc query construction, or MCP metadata discovery when an existing specialized command already fits the user's request.
6
+
7
+ Command:
8
+
9
+ ```bash
10
+ ae-cli analysis datatable version-list --project-id <project_id> --datatable-id <datatable_id>
11
+ ae-cli analysis datatable version-list --dry-run
12
+ ```
13
+
14
+ Capability id: `metadata.data_table_version.list`.
15
+
16
+ Input sends `project_id`, `datatable_id`.
17
+
18
+ Output is the gateway envelope. `data` contains the common-service capability result.
19
+
20
+ ## Parameters
21
+ | Parameter | Required | Description |
22
+ |---|---|---|
23
+ | `--project-id` | Yes | Numeric project ID. |
24
+ | `--datatable-id` | Yes | Data table ID. |
@@ -0,0 +1,24 @@
1
+ # analysis event changelog-list
2
+
3
+ Use when the user needs to list event metadata change logs.
4
+
5
+ Do not use this command for unrelated analysis queries, ad-hoc query construction, or MCP metadata discovery when an existing specialized command already fits the user's request.
6
+
7
+ Command:
8
+
9
+ ```bash
10
+ ae-cli analysis event changelog-list --project-id <project_id> --event-name <event_name>
11
+ ae-cli analysis event changelog-list --dry-run
12
+ ```
13
+
14
+ Capability id: `metadata.event.changelog_list`.
15
+
16
+ Input sends `project_id`, `event_name`.
17
+
18
+ Output is the gateway envelope. `data` contains the common-service capability result.
19
+
20
+ ## Parameters
21
+ | Parameter | Required | Description |
22
+ |---|---|---|
23
+ | `--project-id` | Yes | Numeric project ID. |
24
+ | `--event-name` | Yes | Event name. |
@@ -0,0 +1,24 @@
1
+ # analysis event create
2
+
3
+ Use when the user needs to create super events and optionally associate event properties.
4
+
5
+ Do not use this command for unrelated analysis queries, ad-hoc query construction, or MCP metadata discovery when an existing specialized command already fits the user's request.
6
+
7
+ Command:
8
+
9
+ ```bash
10
+ ae-cli analysis event create --project-id <project_id> --payload '{}'
11
+ ae-cli analysis event create --dry-run
12
+ ```
13
+
14
+ Capability id: `metadata.event.create`.
15
+
16
+ Input sends `project_id`, `payload`.
17
+
18
+ Output is the gateway envelope. `data` contains the common-service capability result.
19
+
20
+ ## Parameters
21
+ | Parameter | Required | Description |
22
+ |---|---|---|
23
+ | `--project-id` | Yes | Numeric project ID. |
24
+ | `--payload` | Yes | Capability payload JSON. |
@@ -0,0 +1,24 @@
1
+ # analysis event delete
2
+
3
+ Use when the user needs to batch delete events or virtual events.
4
+
5
+ Do not use this command for unrelated analysis queries, ad-hoc query construction, or MCP metadata discovery when an existing specialized command already fits the user's request.
6
+
7
+ Command:
8
+
9
+ ```bash
10
+ ae-cli analysis event delete --project-id <project_id> --event-names '{}'
11
+ ae-cli analysis event delete --dry-run
12
+ ```
13
+
14
+ Capability id: `metadata.event.delete`.
15
+
16
+ Input sends `project_id`, `event_names`.
17
+
18
+ Output is the gateway envelope. `data` contains the common-service capability result.
19
+
20
+ ## Parameters
21
+ | Parameter | Required | Description |
22
+ |---|---|---|
23
+ | `--project-id` | Yes | Numeric project ID. |
24
+ | `--event-names` | Yes | Event names JSON array, or a JSON string accepted by common-service. |
@@ -0,0 +1,24 @@
1
+ # analysis event get
2
+
3
+ Use when the user needs to get one super event metadata detail.
4
+
5
+ Do not use this command for unrelated analysis queries, ad-hoc query construction, or MCP metadata discovery when an existing specialized command already fits the user's request.
6
+
7
+ Command:
8
+
9
+ ```bash
10
+ ae-cli analysis event get --project-id <project_id> --event-name <event_name>
11
+ ae-cli analysis event get --dry-run
12
+ ```
13
+
14
+ Capability id: `metadata.event.get`.
15
+
16
+ Input sends `project_id`, `event_name`.
17
+
18
+ Output is the gateway envelope. `data` contains the common-service capability result.
19
+
20
+ ## Parameters
21
+ | Parameter | Required | Description |
22
+ |---|---|---|
23
+ | `--project-id` | Yes | Numeric project ID. |
24
+ | `--event-name` | Yes | Event name. |