@thinkingai/ae-cli 1.0.1 → 1.0.15

package/skills/ae-engage/references/flow-process-report.md

@@ -0,0 +1,59 @@
+# ae-engage +flow_process_report
+
+> **Prerequisite:** Read [`../../ae-shared/SKILL.md`](../../ae-shared/SKILL.md)
+
+Query the process-level report for a flow.
+
+Mapped command: `ae-cli engage +flow_process_report`
+
+## Flags
+
+| Flag | Type | Required | Description |
+|------|------|------|------|
+| `--project_id` / `-p` | number | Yes | Project ID |
+| `--report_type` | string | Yes | report type |
+| `--flow_id` | string | No | Flow ID |
+| `--flow_uuid` | string | No | Flow UUID |
+| `--request_id` | string | No | Query requestId |
+| `--push_language_code` | string | No | push language code |
+| `--data_dim_type` | string | No | data dimension type |
+| `--start_time` | string | No | Start date |
+| `--end_time` | string | No | End date |
+| `--show_time_zone` | string | No | display timezone offset |
+
+## Enum Notes
+
+### `--report_type`
+
+- `overview`: flow overview
+- `detail`: flow detail
+- `exit_detail`: exit detail
+- `push_detail`: push detail
+
+### `--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`
+
+## Parameter Constraints
+
+- `--flow_id` At least one of `--flow_id` and `--flow_uuid` must be provided.
+- When `--report_type` is `detail`, `exit_detail`, or `push_detail`, both `--start_time` and `--end_time` are required.
+- When `--report_type` is `overview`, you may omit time or provide `--start_time` and `--end_time` as a pair.
+
+## Examples
+
+```bash
+ae-cli engage +flow_process_report --project_id 1 --flow_uuid flow_uuid_123 --report_type overview
+```

package/skills/ae-engage/references/manage-flow.md

@@ -0,0 +1,94 @@
+# ae-engage +manage_flow
+
+> **Prerequisite:** Read [`../../ae-shared/SKILL.md`](../../ae-shared/SKILL.md)
+
+Batch manage flow status or review actions.
+
+Mapped command: `ae-cli engage +manage_flow`
+
+## Flags
+
+| Flag | Type | Required | Description |
+|------|------|------|------|
+| `--project_id` / `-p` | number | Yes | Project ID |
+| `--action` | string | Yes | action type |
+| `--flow_list` | json | No | Review list JSON array |
+| `--pause_flow_list` | json | No | pause list JSON array |
+| `--flow_id_list` | json | No | Flow ID JSON array |
+| `--reason` | string | No | review reason |
+
+## Enum Notes
+
+### `--action`
+
+- `approve`: review approved, requires `--flow_list`
+- `deny`: review denied, requires `--flow_list`
+- `cancel`: cancel review, requires `--flow_list`
+- `pause`: pause flow, requires `--pause_flow_list`
+- `recover`: resume flow, requires `--flow_id_list`
+- `end`: end flow, requires `--flow_id_list`
+
+## JSON Parameter Notes
+
+### `--flow_list`
+
+Used for review actions such as `approve`, `deny`, and `cancel`. Each array item is an object:
+
+| Field | Type | Required | Description |
+|------|------|------|------|
+| `flowUuid` | string | Yes | Flow UUID |
+| `reason` | string | No | per-item review reason |
+
+Examples: 
+
+```json
+[
+  { "flowUuid": "flow_uuid_1", "reason": "approve by ops" }
+]
+```
+
+### `--pause_flow_list`
+
+Used for the `pause` action. Each array item is an object:
+
+| Field | Type | Required | Description |
+|------|------|------|------|
+| `flowId` | string | Yes | Flow ID |
+| `flowInstanceProcessType` | number | No | flow instance processing mode |
+
+`flowInstanceProcessType` enum:
+
+- `1`: normal, normal pause
+- `2`: force exit, force-exit the instance
+
+Examples: 
+
+```json
+[
+  { "flowId": "flow_id_1", "flowInstanceProcessType": 1 }
+]
+```
+
+### `--flow_id_list`
+
+Used for batch operations by ID such as `recover` and `end`:
+
+```json
+["flow_id_1", "flow_id_2"]
+```
+
+## Safety Constraints
+
+This command is a **write operation** and changes the flow status.
+
+Different `action` values require different parameters:
+
+- `approve` / `deny` / `cancel`: must include `--flow_list`
+- `pause`: must include `--pause_flow_list`
+- `recover` / `end`: must include `--flow_id_list`
+
+## Examples
+
+```bash
+ae-cli engage +manage_flow --project_id 1 --action end --flow_id_list '["flow_id_1"]'
+```

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

@@ -0,0 +1,74 @@
+# ae-engage +manage_strategy
+
+> **Prerequisite:** Read [`../../ae-shared/SKILL.md`](../../ae-shared/SKILL.md)
+
+Batch manage strategy status or review actions.
+
+Mapped command: `ae-cli engage +manage_strategy`
+
+## Flags
+
+| Flag | Type | Required | Description |
+|------|------|------|------|
+| `--project_id` / `-p` | number | Yes | Project ID |
+| `--config_id` | string | Yes | config item ID |
+| `--action` | string | Yes | action type |
+| `--strategy_uuid_list` | json | No | Strategy UUID JSON array |
+| `--strategy_list` | json | No | Review-entry JSON array |
+| `--reason` | string | No | review reason |
+
+## Enum Notes
+
+### `--action`
+
+- `online`: publish strategy, requires `--strategy_uuid_list`
+- `offline`: take strategy offline, requires `--strategy_uuid_list`
+- `suspend`: suspend strategy, requires `--strategy_uuid_list`
+- `delete`: delete strategy, requires `--strategy_uuid_list`
+- `approve`: review approved, requires `--strategy_list`
+- `deny`: review denied, requires `--strategy_list`
+- `cancel`: cancel review, requires `--strategy_list`
+
+## JSON Parameter Notes
+
+### `--strategy_uuid_list`
+
+Used for actions such as `online`, `offline`, `suspend`, and `delete` that batch-process items directly by UUID.
+
+```json
+["uuid_1", "uuid_2"]
+```
+
+### `--strategy_list`
+
+Used for review actions such as `approve`, `deny`, and `cancel`. Each array item is an object:
+
+| Field | Type | Required | Description |
+|------|------|------|------|
+| `strategyUuid` | string | Yes | strategy UUID |
+| `reason` | string | No | review reason for that strategy |
+
+Examples: 
+
+```json
+[
+  { "strategyUuid": "uuid_1", "reason": "approve by ops" }
+]
+```
+
+## Safety Constraints
+
+This command is a **write operation** and changes the strategy status.
+
+Different `action` values require different parameters:
+
+- `online` / `offline` / `suspend` / `delete`: must include `--strategy_uuid_list`
+- `approve` / `deny` / `cancel`: must include `--strategy_list`
+
+## Examples
+
+```bash
+ae-cli engage +manage_strategy \
+  --project_id 1 --config_id cfg_123 --action online \
+  --strategy_uuid_list '["uuid_1"]'
+```

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

@@ -0,0 +1,37 @@
+# ae-engage +manage_task
+
+> **Prerequisite:** Read [`../../ae-shared/SKILL.md`](../../ae-shared/SKILL.md)
+
+Perform task lifecycle actions such as send, pause, end, or review.
+
+Mapped command: `ae-cli engage +manage_task`
+
+## Flags
+
+| Flag | Type | Required | Description |
+|------|------|------|------|
+| `--project_id` / `-p` | number | Yes | Project ID |
+| `--task_id` | string | Yes | task ID |
+| `--action` | string | Yes | action type |
+| `--reason` | string | No | reason for review actions |
+
+## Enum Notes
+
+### `--action`
+
+- `send`: send immediately, typically for manually triggered tasks in the waiting state
+- `pause`: pause a running task
+- `end`: end a running or paused task
+- `approve`: review approved
+- `deny`: review denied
+- `cancel`: cancel review
+
+## Safety Constraints
+
+This command is a **write operation** and and changes the task status.
+
+## Examples
+
+```bash
+ae-cli engage +manage_task --project_id 1 --task_id task_123 --action pause
+```

package/skills/ae-engage/references/modify-flow-base-info.md

@@ -0,0 +1,27 @@
+# ae-engage +modify_flow_base_info
+
+> **Prerequisite:** Read [`../../ae-shared/SKILL.md`](../../ae-shared/SKILL.md)
+
+Modify the basic information of a flow canvas.
+
+Mapped command: `ae-cli engage +modify_flow_base_info`
+
+## Flags
+
+| Flag | Type | Required | Description |
+|------|------|------|------|
+| `--project_id` / `-p` | number | Yes | Project ID |
+| `--flow_uuid` | string | Yes | Flow UUID |
+| `--flow_name` | string | No | new flow name |
+| `--flow_desc` | string | No | new flow description |
+| `--group_id` | number | No | new group ID |
+
+## Safety Constraints
+
+This command is a **write operation** and modifies the basic information of a flow.
+
+## Examples
+
+```bash
+ae-cli engage +modify_flow_base_info --project_id 1 --flow_uuid flow_uuid_123 --flow_name "New Name"
+```