@thinkingai/ae-cli 1.0.1 → 1.0.15

package/skills/ae-engage/references/strategy-detail.md

@@ -0,0 +1,73 @@
+# ae-engage +strategy_detail
+
+> **Prerequisite:** Read [`../../ae-shared/SKILL.md`](../../ae-shared/SKILL.md)
+
+Query the details of a single strategy.
+
+Mapped command: `ae-cli engage +strategy_detail`
+
+## Flags
+
+| Flag | Type | Required | Description |
+|------|------|------|------|
+| `--project_id` / `-p` | number | Yes | Project ID |
+| `--config_id` | string | Yes | config item ID |
+| `--strategy_uuid` | string | Yes | strategy UUID |
+
+## Common enums in the response
+
+### `status`
+
+- `0`: `DRAFT`
+- `1`: `ONLINE`
+- `2`: `SUSPEND`
+- `3`: `OFFLINE`
+
+### `mappingStatus`
+
+- `0`: `DRAFT`
+- `1`: `APPROVE`
+- `2`: `DENY`
+- `3`: `REGISTERING`
+- `4`: `REGISTER_FAIL`
+- `5`: `WAITING`
+- `6`: `ONLINE`
+- `7`: `SUSPEND`
+- `8`: `OFFLINE`
+
+### `targetClusterType`
+
+- `0`: `ALL_USERS`
+- `1`: `CUSTOM_CLUSTER`
+- `2`: `SINGLE_USER`
+
+### `realtime`
+
+- `0`: physical cluster, physical audience
+- `1`: virtual cluster, virtual audience
+
+### `triggerType`
+
+- `0`: `SCHEDULED_SINGLE`
+- `1`: `SCHEDULED_RECURRING`
+- `2`: `MANUAL`
+
+### `versionType`
+
+- `0`: history version
+- `1`: current version
+- `2`: update-content version
+
+### `channelType`
+
+- `1`: `WEBHOOK`
+- `2`: `APP_PUSH`
+- `3`: `CLIENT_PUSH`
+- `4`: `WECHAT`
+- `5`: `DOU_YIN`
+
+## Examples
+
+```bash
+ae-cli engage +strategy_detail --project_id 1 --config_id cfg_123 --strategy_uuid uuid_123
+```

package/skills/ae-engage/references/strategy-list.md

@@ -0,0 +1,21 @@
+# ae-engage +strategy_list
+
+> **Prerequisite:** Read [`../../ae-shared/SKILL.md`](../../ae-shared/SKILL.md)
+
+Query the strategy list.
+
+Mapped command: `ae-cli engage +strategy_list`
+
+## Flags
+
+| Flag | Type | Required | Description |
+|------|------|------|------|
+| `--project_id` / `-p` | number | Yes | Project ID |
+| `--config_id` | string | No | config item ID |
+| `--strategy_uuid_list` | json | No | strategy UUID JSON array |
+
+## Examples
+
+```bash
+ae-cli engage +strategy_list --project_id 1 --config_id cfg_123
+```

package/skills/ae-engage/references/task-data-detail.md

@@ -0,0 +1,74 @@
+# ae-engage +task_data_detail
+
+> **Prerequisite:** Read [`../../ae-shared/SKILL.md`](../../ae-shared/SKILL.md)
+
+Query the task detailed data report.
+
+Mapped command: `ae-cli engage +task_data_detail`
+
+## Flags
+
+| Flag | Type | Required | Description |
+|------|------|------|------|
+| `--project_id` / `-p` | number | Yes | Project ID |
+| `--task_id` | string | Yes | task ID |
+| `--detail_type` | string | Yes | detail type |
+| `--start_time` | string | Yes | Start date |
+| `--end_time` | string | Yes | End date |
+| `--request_id` | string | No | Query requestId |
+| `--push_language_code` | string | No | push language code |
+| `--task_instance_id` | string | No | task instance ID |
+| `--data_dim_type` | string | No | data dimension type |
+| `--retention_type` | string | No | retention type |
+| `--data_view_type` | number | No | Trigger task view type |
+| `--show_time_zone` | string | No | display timezone offset |
+
+## Enum Notes
+
+### `--detail_type`
+
+- `time`: view by time
+- `instance`: view by instance
+- `instance_daily`: view day-by-day details for a single instance
+
+### `--data_dim_type`
+
+- `uv`: count by unique users
+- `pv`: count by events/occurrences
+
+### `--retention_type`
+
+- `retention`: retention analysis
+- `lost`: churn analysis
+
+### `--data_view_type`
+
+Only valid when `--task_type` is `trigger` and `--detail_type` is `time`:
+
+- `2`: date view
+- `3`: trigger view
+
+### `--push_language_code`
+
+Common values include:
+
+- `default`
+- `en`
+- `zh-Hans`
+- `zh-Hant`
+- `ja`
+- `ko`
+
+## Parameter Constraints
+
+- When `--detail_type` is `instance_daily`, you must include `--task_instance_id`.
+- `--start_time`、`--end_time` use `yyyy-MM-dd`.
+
+## Examples
+
+```bash
+ae-cli engage +task_data_detail \
+  --project_id 1 --task_id task_123 \
+  --detail_type time \
+  --start_time 2026-04-01 --end_time 2026-04-07
+```

package/skills/ae-engage/references/task-data-overview.md

@@ -0,0 +1,42 @@
+# ae-engage +task_data_overview
+
+> **Prerequisite:** Read [`../../ae-shared/SKILL.md`](../../ae-shared/SKILL.md)
+
+Query the funnel-style task data overview.
+
+Mapped command: `ae-cli engage +task_data_overview`
+
+## Flags
+
+| Flag | Type | Required | Description |
+|------|------|------|------|
+| `--project_id` / `-p` | number | Yes | Project ID |
+| `--task_id` | string | Yes | task ID |
+| `--request_id` | string | No | Query requestId |
+| `--push_language_code` | string | No | push language code |
+| `--data_dim_type` | string | No | data dimension type |
+| `--show_time_zone` | string | No | display timezone offset |
+
+## Enum Notes
+
+### `--data_dim_type`
+
+- `uv`: count by unique users
+- `pv`: count by events/occurrences
+
+### `--push_language_code`
+
+Common values include:
+
+- `default`
+- `en`
+- `zh-Hans`
+- `zh-Hant`
+- `ja`
+- `ko`
+
+## Examples
+
+```bash
+ae-cli engage +task_data_overview --project_id 1 --task_id task_123
+```

package/skills/ae-engage/references/task-detail.md

@@ -0,0 +1,61 @@
+# ae-engage +task_detail
+
+> **Prerequisite:** Read [`../../ae-shared/SKILL.md`](../../ae-shared/SKILL.md)
+
+Query the details of a single task.
+
+Mapped command: `ae-cli engage +task_detail`
+
+## Flags
+
+| Flag | Type | Required | Description |
+|------|------|------|------|
+| `--project_id` / `-p` | number | Yes | Project ID |
+| `--task_id` | string | Yes | task ID |
+
+## Common enums in the response
+
+### `status`
+
+- `0`: `DRAFT`, draft, not submitted
+- `1`: `WORKING`, running
+- `2`: `PENDING`, paused
+- `3`: `COMPLETE`, completed
+
+### `mappingStatus`
+
+- `0`: `DRAFT`
+- `1`: `WORKING`
+- `2`: `PENDING`
+- `3`: `COMPLETE`
+- `4`: `APPROVE`, pending review
+- `5`: `DENY`, review denied
+
+### `channelType`
+
+- `1`: `WEBHOOK`
+- `2`: `APP_PUSH`
+- `3`: `CLIENT_PUSH`
+- `4`: `WECHAT`
+- `5`: `DOU_YIN`
+
+### `triggerType`
+
+- `0`: `SCHEDULED_SINGLE`
+- `1`: `SCHEDULED_RECURRING`
+- `2`: `MANUAL`
+- `3`: `TRIGGER_COMPLETE_A`
+- `4`: `TRIGGER_COMPLETE_A_THEN_B`
+- `5`: `TRIGGER_COMPLETE_A_NOT_B`
+- `6`: `CUSTOM_TRIGGER`
+
+### `realtime`
+
+- `0`: physical cluster, physical audience
+- `1`: virtual cluster, virtual audience
+
+## Examples
+
+```bash
+ae-cli engage +task_detail --project_id 1 --task_id task_123
+```

package/skills/ae-engage/references/task-experiment-report.md

@@ -0,0 +1,45 @@
+# ae-engage +task_experiment_report
+
+> **Prerequisite:** Read [`../../ae-shared/SKILL.md`](../../ae-shared/SKILL.md)
+
+Query the task experiment report.
+
+Mapped command: `ae-cli engage +task_experiment_report`
+
+## Flags
+
+| Flag | Type | Required | Description |
+|------|------|------|------|
+| `--project_id` / `-p` | number | Yes | Project ID |
+| `--task_id` | string | Yes | task ID |
+| `--report_type` | string | Yes | report type: `overview` or `detail` |
+| `--start_time` | string | Yes | Start date |
+| `--end_time` | string | Yes | End date |
+| `--request_id` | string | No | query requestId |
+| `--push_language_code` | string | No | push language code |
+
+## Enum Notes
+
+### `--report_type`
+
+- `overview`: experiment overview
+- `detail`: experiment detail
+
+### `--push_language_code`
+
+Common values include:
+
+- `default`
+- `en`
+- `zh-Hans`
+- `zh-Hant`
+- `ja`
+- `ko`
+
+## Examples
+
+```bash
+ae-cli engage +task_experiment_report \
+  --project_id 1 --task_id task_123 \
+  --report_type overview --start_time 2026-04-01 --end_time 2026-04-07
+```

package/skills/ae-engage/references/task-list.md

@@ -0,0 +1,91 @@
+# ae-engage +task_list
+
+> **Prerequisite:** Read [`../../ae-shared/SKILL.md`](../../ae-shared/SKILL.md)
+
+Query the paginated task list.
+
+Mapped command: `ae-cli engage +task_list`
+
+## Flags
+
+| Flag | Type | Required | Description |
+|------|------|------|------|
+| `--project_id` / `-p` | number | Yes | Project ID |
+| `--req` | json | Yes | query-condition JSON object |
+
+## `--req` Object Fields
+
+Common fields are listed below; provide them as needed:
+
+| Field | Type | Required | Description |
+|------|------|------|------|
+| `pageNum` | number | No | page number, starting from 1 |
+| `pageSize` | number | No | page size |
+| `mappingStatus` | number | No | status filter |
+| `triggerType` | number | No | trigger type filter |
+| `channelType` | number | No | channel type filter |
+| `groupId` | number | No | group ID |
+| `creator` | string | No | creator open_id |
+| `fuzzyField` | string | No | fuzzy search by task ID or task name |
+| `belongActivity` | number | No | activity association filter |
+| `expStatusList` | array | No | experiment status list |
+| `expReleaseStatusList` | array | No | experiment release status list |
+| `expTypeList` | array | No | experiment type list |
+
+`projectId` is automatically injected into `--req` by the CLI. You usually do not need to repeat it.
+
+## Enum Notes
+
+### `req.mappingStatus`
+
+- `0`: draft
+- `1`: in progress
+- `2`: paused
+- `3`: ended
+- `4`: approving
+- `5`: denied
+
+### `req.triggerType`
+
+- `0`: scheduled-single
+- `1`: scheduled-recurring
+- `2`: manual
+- `3`: trigger-complete A
+- `4`: trigger-complete A then B
+- `5`: trigger-complete A but not B
+- `6`: custom trigger
+
+### `req.channelType`
+
+- `1`: webhook
+- `2`: app_push
+- `3`: client_push
+- `4`: wechat
+- `5`: dou_yin
+
+### `req.belongActivity`
+
+- `0`: all
+- `1`: activity linked
+- `2`: activity not linked
+
+### `req.expStatusList[]`
+
+- `0`: experiment not created
+- `1`: experiment created
+
+### `req.expReleaseStatusList[]`
+
+- `0`: experiment not released
+- `1`: experiment released
+
+### `req.expTypeList[]`
+
+- `0`: normal
+- `1`: orthogonal
+
+## Examples
+
+```bash
+ae-cli engage +task_list --project_id 1 --req '{"pageNum":1,"pageSize":20}'
+```

package/skills/ae-engage/references/task-metric-detail.md

@@ -0,0 +1,50 @@
+# ae-engage +task_metric_detail
+
+> **Prerequisite:** Read [`../../ae-shared/SKILL.md`](../../ae-shared/SKILL.md)
+
+Query the metric-oriented detail report for a task.
+
+Mapped command: `ae-cli engage +task_metric_detail`
+
+## Flags
+
+| Flag | Type | Required | Description |
+|------|------|------|------|
+| `--project_id` / `-p` | number | Yes | Project ID |
+| `--task_id` | string | Yes | task ID |
+| `--start_time` | string | Yes | Start date |
+| `--end_time` | string | Yes | End date |
+| `--request_id` | string | No | query requestId |
+| `--push_language_code` | string | No | push language code |
+| `--metric_id_list` | json | No | metric ID JSON array |
+| `--group_type` | number | No | group type |
+| `--show_time_zone` | string | No | Display timezone offset |
+
+## Enum Notes
+
+### `--group_type`
+
+- `1`: group by batch
+- `2`: group by date
+- `3`: group by trigger
+- `4`: group by experiment result
+
+### `--push_language_code`
+
+Common values include:
+
+- `default`
+- `en`
+- `zh-Hans`
+- `zh-Hant`
+- `ja`
+- `ko`
+
+## Examples
+
+```bash
+ae-cli engage +task_metric_detail \
+  --project_id 1 --task_id task_123 \
+  --start_time 2026-04-01 --end_time 2026-04-07 \
+  --metric_id_list '["metric_1"]'
+```

package/skills/ae-engage/references/task-stats.md

@@ -0,0 +1,89 @@
+# ae-engage +task_stats
+
+> **Prerequisite:** Read [`../../ae-shared/SKILL.md`](../../ae-shared/SKILL.md)
+
+Query task status statistics.
+
+Mapped command: `ae-cli engage +task_stats`
+
+## Flags
+
+| Flag | Type | Required | Description |
+|------|------|------|------|
+| `--project_id` / `-p` | number | Yes | Project ID |
+| `--req` | json | Yes | statistics-condition JSON object |
+
+## `--req` Object Fields
+
+The `--req` structure of `+task_stats` is broadly the same as `+task_list`, and common fields include:
+
+| Field | Type | Required | Description |
+|------|------|------|------|
+| `mappingStatus` | number | No | status filter |
+| `triggerType` | number | No | trigger type filter |
+| `channelType` | number | No | channel type filter |
+| `groupId` | number | No | group ID |
+| `creator` | string | No | creator open_id |
+| `fuzzyField` | string | No | fuzzy search by task ID or task name |
+| `belongActivity` | number | No | activity association filter |
+| `expStatusList` | array | No | experiment status list |
+| `expReleaseStatusList` | array | No | experiment release status list |
+| `expTypeList` | array | No | experiment type list |
+
+`projectId` is automatically injected into `--req` by the CLI.
+
+## Enum Notes
+
+### `req.mappingStatus`
+
+- `0`: draft
+- `1`: in progress
+- `2`: paused
+- `3`: ended
+- `4`: approving
+- `5`: denied
+
+### `req.triggerType`
+
+- `0`: scheduled-single
+- `1`: scheduled-recurring
+- `2`: manual
+- `3`: trigger-complete A
+- `4`: trigger-complete A then B
+- `5`: trigger-complete A but not B
+- `6`: custom trigger
+
+### `req.channelType`
+
+- `1`: webhook
+- `2`: app_push
+- `3`: client_push
+- `4`: wechat
+- `5`: dou_yin
+
+### `req.belongActivity`
+
+- `0`: all
+- `1`: activity linked
+- `2`: activity not linked
+
+### `req.expStatusList[]`
+
+- `0`: experiment not created
+- `1`: experiment created
+
+### `req.expReleaseStatusList[]`
+
+- `0`: experiment not released
+- `1`: experiment released
+
+### `req.expTypeList[]`
+
+- `0`: normal
+- `1`: orthogonal
+
+## Examples
+
+```bash
+ae-cli engage +task_stats --project_id 1 --req '{"pageNum":1,"pageSize":20}'
+```

package/skills/ae-engage/references/update-channel-status.md

@@ -0,0 +1,32 @@
+# ae-engage +update_channel_status
+
+> **Prerequisite:** Read [`../../ae-shared/SKILL.md`](../../ae-shared/SKILL.md)
+
+Update the status of an Engage channel.
+
+Mapped command: `ae-cli engage +update_channel_status`
+
+## Flags
+
+| Flag | Type | Required | Description |
+|------|------|------|------|
+| `--project_id` / `-p` | number | Yes | Project ID |
+| `--channel_id` | string | Yes | channel ID |
+| `--status` | number | Yes | channel status |
+
+## Enum Notes
+
+### `--status`
+
+- `0`: disabled
+- `1`: enabled
+
+## Safety Constraints
+
+This command is a **write operation** and Before executing, confirm that the user explicitly wants to change the channel status.
+
+## Examples
+
+```bash
+ae-cli engage +update_channel_status --project_id 1 --channel_id <channel_id> --status 1
+```

package/skills/ae-engage/references/update-config-channel-status.md

@@ -0,0 +1,32 @@
+# ae-engage +update_config_channel_status
+
+> **Prerequisite:** Read [`../../ae-shared/SKILL.md`](../../ae-shared/SKILL.md)
+
+Update the status of a config channel.
+
+Mapped command: `ae-cli engage +update_config_channel_status`
+
+## Flags
+
+| Flag | Type | Required | Description |
+|------|------|------|------|
+| `--project_id` / `-p` | number | Yes | Project ID |
+| `--channel_id` | string | Yes | config channel ID |
+| `--channel_status` | number | Yes | config channel status |
+
+## Enum Notes
+
+### `--channel_status`
+
+- `1`: enabled
+- `2`: disabled
+
+## Safety Constraints
+
+This command is a **write operation** and and modifies the config channel status.
+
+## Examples
+
+```bash
+ae-cli engage +update_config_channel_status --project_id 1 --channel_id <channel_id> --channel_status 1
+```

package/skills/ae-engage/references/validate-flow-node-config.md

@@ -0,0 +1,52 @@
+# ae-engage +validate_flow_node_config
+
+> **Prerequisite:** Read [`../../ae-shared/SKILL.md`](../../ae-shared/SKILL.md)
+
+Validate a single node configuration before saving a flow.
+
+Mapped command: `ae-cli engage +validate_flow_node_config`
+
+## Flags
+
+| Flag | Type | Required | Description |
+|------|------|------|------|
+| `--node_type` | string | Yes | node type |
+| `--config` | string | Yes | node config JSON string |
+| `--operation_mode` | string | Yes | validation mode |
+
+## Enum Notes
+
+### `--node_type`
+
+Common node types include:
+
+- `single_trigger`
+- `repeat_trigger`
+- `event_trigger`
+- `feature_judge`
+- `event_judge`
+- `message_push`
+- `wechat_push`
+- `webhook_push`
+- `config_push`
+- `tag`
+- `time_control`
+- `feature_split_flow`
+- `event_split_flow`
+- `trigger_prop_split_flow`
+- `percent_split_flow`
+- `ab_split_flow`
+- `race_split_flow`
+- `exit_flow`
+
+### `--operation_mode`
+
+- `save_flow`
+- `save_submit_flow`
+
+## Examples
+
+```bash
+ae-cli engage +validate_flow_node_config \
+  --node_type message_push --operation_mode save_flow --config '{}'
+```

package/skills/ae-engage/references/whitelist-list.md

@@ -0,0 +1,19 @@
+# ae-engage +whitelist_list
+
+> **Prerequisite:** Read [`../../ae-shared/SKILL.md`](../../ae-shared/SKILL.md)
+
+Query the whitelist list in a project.
+
+Mapped command: `ae-cli engage +whitelist_list`
+
+## Flags
+
+| Flag | Type | Required | Description |
+|------|------|------|------|
+| `--project_id` / `-p` | number | Yes | Project ID |
+
+## Examples
+
+```bash
+ae-cli engage +whitelist_list --project_id 1
+```