@thinkingai/ae-cli 6.0.38 → 6.0.39

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

@@ -24,9 +24,9 @@ ae-cli engage-scene strategy update --project-id <project_id> \
 # Query a strategy's log
 ae-cli engage-scene strategy log --project-id <project_id> --strategy-uuid <uuid>
 
-# Predict custom-audience size (mix QP)
+# Predict custom-audience size
 ae-cli engage-scene strategy predict --project-id <project_id> \
-  --qp '<targetClusterQp JSON string>' \
+  --definition-request '{"type":"condition","conditions":{...}}' \
   --zone-offset 8 \
   [--strategy-uuid <uuid>]
 
@@ -48,7 +48,7 @@ ae-cli engage-scene strategy manage --project-id <project_id> --config-id <confi
 | create | `--project-id`, `--payload` | payload = `ConfigStrategyAddDTO`. |
 | update | `--project-id`, `--payload` | payload = `ConfigStrategyModifyDTO` (`strategyUuid` + fields). |
 | log | `--project-id`, `--strategy-uuid` | read. |
-| predict | `--project-id`, `--qp`, `--zone-offset` | Optional `--strategy-uuid`, `--request-id`. read. |
+| predict | `--project-id`, `--definition-request`, `--zone-offset` | Optional `--strategy-uuid`, `--request-id`. read. |
 | batch-copy | `--project-id`, `--config-id`, `--strategy-ids` | `--op-mode` optional (default `batch`). |
 | manage | `--project-id`, `--config-id`, `--action` | Lifecycle actions require `--strategy-uuid-list`; review actions require `--strategy-list`; write. |
 
@@ -67,10 +67,10 @@ ae-cli engage-scene strategy manage --project-id <project_id> --config-id <confi
 - Discover real strategy UUIDs / config IDs first; never invent IDs.
 - **Custom audience (`targetClusterType=1`)** — follow [`scene-strategy-audience.md`](scene-strategy-audience.md) end-to-end:
   1. Preflight every **用户满足** user property and **用户行为** event via `analysis-meta property get` / `event get`; if missing, **stop** and list available properties — never invent or drop.
-  2. Assemble mix QP with **two-block layout**: `totalCFilter.filts[0]` = 用户满足, `totalCFilter.filts[1]` = 用户行为; `totalCFilter.relation` = 且/或 between them. **Never** nest `event` inside user-side `COMPOUND`.
-  3. `JSON.stringify` → `targetClusterQp`; then `strategy create|update`.
+  2. Build an Analysis-compatible semantic condition in `payload.definitionRequest`.
+  3. Reuse the same definition with `strategy predict --definition-request`.
   4. **Do not** call `analysis user-cluster create` unless the user explicitly asks for an existing/named cluster.
-  - Full QP spec + examples A/B/C: [`scene-strategy-audience.md`](scene-strategy-audience.md).
+  - Semantic contract and examples: [`scene-strategy-audience.md`](scene-strategy-audience.md).
 - **`create` requires an enabled template** on the same config item. Enable workflow: `config-param batch-add` → `template create` → `template update` (non-empty `config[]` with real `paramId`) → `template update-status --status 1`. Otherwise `create` returns `TEMPLATE_ENABLE`.
 - `create` output field is `data.strategy_uuid` (not `strategy_id`).
 - `manage` supports `online`, `offline`, `suspend`, `delete`, `approve`, `deny`, and `cancel`; it is a write operation.

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

@@ -5,6 +5,16 @@ Query the details of a single task.
 
 Mapped command: `ae-cli engage-task task get`
 
+For a custom target audience, the response hides persisted `qp` and returns:
+
+- `definition_status`: `AVAILABLE`, `UNAVAILABLE`, or `NOT_APPLICABLE`
+- `definition_request`: the Analysis-compatible semantic audience definition when available
+- `definition_unavailable_reason`: present only when a historical QP cannot be reversed
+
+Reuse `definition_request` as `req.targetConfig.definitionRequest` when updating a task.
+Soft-deleted tasks are treated as unavailable and return `TASK_NOT_FOUND`, matching task-list
+visibility.
+
 ## Flags
 
 | Flag | Type | Required | Description |

package/skills/ae-engage/references/task-submit-approval.md

@@ -0,0 +1,45 @@
+# engage-task task submit-approval
+
+Submit an existing draft engagement task for approval. The legacy full save-and-submit request remains supported.
+This is a regular write operation.
+
+> Capability id: `engage-task.task.submit-approval` · Domain: `engage`.
+
+```bash
+ae-cli engage-task task submit-approval --project-id <project_id> --task-id <task_id>
+```
+
+## Parameters
+
+| Flag | Required | Notes |
+|---|---|---|
+| `--project-id` / `-p` | yes | Numeric project ID. |
+| `--task-id` | conditional | Existing draft task ID. Recommended after `task save`. |
+| `--request` | conditional | Legacy `ApprovalSaveAndSubmitDTO` / `OperationTaskOpDTO` JSON (camelCase or snake_case). |
+
+Provide exactly one of `--task-id` or `--request`.
+
+## Output
+
+- `data.task_id`
+
+## Request notes
+
+- Prefer `task save` followed by `submit-approval --task-id`. The server loads the persisted draft, validates its
+  trigger rule, and reuses the existing save-and-submit approval workflow.
+- Do not reconstruct or pass `trigger_rule`. It is an internal persisted field.
+- The legacy `--request` mode remains available for existing callers.
+- Required body fields (server validates): `task_name`, `channel_type`, `channel_id`, `group_content_list`, `target_cluster_type`, `trigger_type`, `completion_indicator_def`, `frequency_limits`, `enable_channel_touch_limits`, `group_id`, `trigger_time_strategy`.
+- Missing `expConfig` is auto-filled as `{"enableExp":false}` (same as activity task create/update).
+- TEXT channel params missing `config` are auto-filled with Slate.js JSON from `value`.
+- For schedule-single (`triggerType=0`), include a future `triggerTime` (and `tzOffset` / `triggerTimeStrategy` as needed).
+- Prefer save → submit by task ID; do not invent `taskId` / `channelId`.
+
+## Common Errors
+
+| code | when |
+|---|---|
+| `APPROVAL_INPUT_INVALID` | neither or both of `task_id` and `request` supplied |
+| `REQUEST_REQUIRED` | `--request` missing or not an object |
+| `REQUEST_FIELDS_REQUIRED` | required body fields absent/blank |
+| `CAPABILITY_EXECUTION_FAILED` | unmapped domain failure; check `invocation_id` / Hermes logs |

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

@@ -30,7 +30,7 @@ Use `--operation-mode save_flow` for the current exposed MCP protocol. Use `save
 Important current rules:
 
 - `event_trigger` / `event_judge` A segment: use `periodStart`, `periodEnd`, `periodTimeSymbol`; do not use branch-style `delayTime`.
-- `event_split_flow` branch segment: use `delayTime`, `delayTimeSymbol`, `targetClusterType`; omit `triggerRule` on default branches.
+- `event_split_flow` branch segment: use `delayTime`, `delayTimeSymbol`, `targetClusterType`; omit `triggerDefinition` on default branches.
 - `event_trigger targetUserType=2` is invalid.
 - Push `OBJ_ARRAY.value` must be a JSON array, not a stringified array.
 - Push `contentList[].content` should be a JSON array, but a JSON-stringified array is accepted for compatibility.

package/skills/ae-generate-tracking-code/SKILL.md

@@ -91,12 +91,12 @@ First, check if `.ae-cli/draft.json` exists and read existing configuration:
 **⚠️ Key: SERVER_URL and APP_ID are independent config items. Even if draft.json has project_id and host, you MUST resolve and confirm them. `project_id` ≠ `APP_ID`, `host` ≠ `SERVER_URL`.**
 
 1. **APP_ID** — Prefer automatic lookup before asking:
-   - If `meta.project_id` is known, run `ae-cli analysis project info list` once for the current host.
+   - If `meta.project_id` is known, run `ae-cli project info list` once for the current host.
    - Find the project whose `projectId` matches `meta.project_id`.
    - If the matched project has `appId`, ask: **"I found APP_ID `<appId>` for project `<projectId>`. Use it? yes / enter new value"**
    - If the project is missing, ambiguous, or has no `appId`, ask the user to copy APP_ID from AE Admin → "Project Settings" → "Integration Config".
 2. **SERVER_URL** — Data ingestion endpoint (**different from web URL**; go to AE Admin → "Project Settings" → "Integration Config" → fill in "Public URL")
-   - If `meta.project_id` is known, you may try `ae-cli analysis project info get --project-id <project_id>` once.
+   - If `meta.project_id` is known, you may try `ae-cli project info get --project-id <project_id>` once.
    - Use the returned value only if the response explicitly contains a receiver URL field such as `serverUrl`, `pushUrl`, `push_url`, `receiverUrl`, `publicUrl`, `publicReceiverAddress`, `privateReceiverAddress`, or equivalent ingestion endpoint field.
    - If both `publicReceiverAddress` and `privateReceiverAddress` are present, prefer `publicReceiverAddress` as `SERVER_URL` for generated snippets unless the user explicitly needs an internal/private-network receiver.
    - If a value is found, ask: **"I found SERVER_URL `<url>` for project `<projectId>`. Use it? yes / enter new value"**

package/skills/ae-metadata/SKILL.md

@@ -53,7 +53,7 @@ ae-cli metadata property <dimension-table-action> [options]
 
 ## PROJECT_ID_GATE
 
-Same rules as `ae-analysis`: reuse verified project context in one conversation; otherwise `ae-cli analysis project info list` (or `ae-analysis` skill) to resolve `project_id`.
+Same rules as `ae-analysis`: reuse verified project context in one conversation; otherwise `ae-cli project info list` (or `ae-analysis` skill) to resolve `project_id`.
 
 ## Commands (10)
 

package/dist/config-BSSALXEN.js

@@ -1,128 +0,0 @@
-import {
-  GLOBAL_QUERY_CONFIG_KEY,
-  getAnalysisMappingPathForClusterMode,
-  getClusterInfoFilePath,
-  isGlobalQueryModeEnabled,
-  setGlobalQueryModeEnabled
-} from "./chunk-LCXU3AAT.js";
-import {
-  printError,
-  printOutput
-} from "./chunk-KTYR3U6D.js";
-import "./chunk-E7UXXHO3.js";
-import "./chunk-IR4ZLVPW.js";
-import {
-  addHost,
-  loadConfig,
-  normalizeUrl,
-  setActiveHost
-} from "./chunk-V6FR6WTW.js";
-import "./chunk-LYVNONC4.js";
-
-// src/commands/config.ts
-function registerConfig(program) {
-  const configCmd = program.command("config").description("AE host and environment configuration").action(() => {
-    printError("config", "Missing subcommand.", "Run: ae-cli config --help");
-    process.exit(1);
-  });
-  configCmd.command("list").description("List configured AE environments").action(async () => {
-    await printConfigList(program);
-  });
-  configCmd.command("current").description("Show the active AE environment").action(async () => {
-    await printCurrentConfig(program);
-  });
-  configCmd.command("use <env>").description("Switch active AE environment by exact URL or unique label").action(async (env) => {
-    await useConfigEnv(program, env);
-  });
-  configCmd.command("set-host <url>").description("Set the active AE host non-interactively (adds it if not already configured)").option("--label <label>", "Display label for this host (defaults to the host URL)").action(async (url, opts) => {
-    const normalized = normalizeUrl(url);
-    const label = opts.label || normalized;
-    addHost(normalized, label);
-    setActiveHost(normalized);
-    await printOutput({ activeHost: normalized, label }, program.opts().format || "json");
-  });
-  const clusterMode = configCmd.command("cluster-mode").description("Manage local multi-cluster analysis MCP mode").action(async () => {
-    await printClusterModeStatus(program);
-  });
-  clusterMode.command("status").description("Show local multi-cluster analysis MCP mode").action(async () => {
-    await printClusterModeStatus(program);
-  });
-  clusterMode.command("enable").description("Enable local multi-cluster analysis MCP mode").action(async () => {
-    setGlobalQueryModeEnabled(true);
-    await printClusterModeStatus(program);
-  });
-  clusterMode.command("disable").description("Disable local multi-cluster analysis MCP mode").action(async () => {
-    setGlobalQueryModeEnabled(false);
-    await printClusterModeStatus(program);
-  });
-}
-async function printClusterModeStatus(program) {
-  const enabled = isGlobalQueryModeEnabled();
-  await printOutput({
-    [GLOBAL_QUERY_CONFIG_KEY]: enabled,
-    path: getClusterInfoFilePath(),
-    analysisMappingPath: getAnalysisMappingPathForClusterMode(enabled)
-  }, program.opts().format || "json", program.opts().jq);
-}
-function readHostViews() {
-  const config = loadConfig();
-  const hosts = Object.entries(config.hosts).map(([url, entry]) => ({
-    url,
-    label: entry.label,
-    active: url === config.activeHost
-  }));
-  return { activeHost: config.activeHost, hosts };
-}
-async function printConfigList(program) {
-  const { activeHost, hosts } = readHostViews();
-  await printOutput({ activeHost, hosts }, program.opts().format || "json", program.opts().jq);
-}
-async function printCurrentConfig(program) {
-  const { activeHost, hosts } = readHostViews();
-  const current = hosts.find((h) => h.url === activeHost);
-  if (!current) {
-    failConfig("No active AE environment configured.", "Run: ae-cli config use <env> or ae-cli config list");
-    return;
-  }
-  await printOutput({ activeHost: current.url, label: current.label }, program.opts().format || "json", program.opts().jq);
-}
-async function useConfigEnv(program, env) {
-  const target = resolveHost(env);
-  if (target.status === "not-found") {
-    failConfig(
-      `No AE environment matched: ${env}`,
-      target.hosts.length > 0 ? `Available environments: ${formatHostOptions(target.hosts)}` : "Run: ae-cli config list"
-    );
-    return;
-  }
-  if (target.status === "duplicate-label") {
-    failConfig(
-      `Duplicate label: ${env}`,
-      `Rename duplicate labels first. Run: ae-cli config list \u2014 ${formatHostOptions(target.matches)}`
-    );
-    return;
-  }
-  setActiveHost(target.host.url);
-  await printOutput({ activeHost: target.host.url, label: target.host.label }, program.opts().format || "json", program.opts().jq);
-}
-function resolveHost(env) {
-  const raw = env.trim();
-  const selector = raw.startsWith("http://") || raw.startsWith("https://") ? normalizeUrl(raw) : raw;
-  const { hosts } = readHostViews();
-  const byUrl = hosts.find((h) => h.url === selector);
-  if (byUrl) return { status: "found", host: byUrl };
-  const byLabel = hosts.filter((h) => h.label === raw);
-  if (byLabel.length === 1) return { status: "found", host: byLabel[0] };
-  if (byLabel.length > 1) return { status: "duplicate-label", matches: byLabel };
-  return { status: "not-found", hosts };
-}
-function formatHostOptions(hosts) {
-  return hosts.map((h) => `${h.label} (${h.url})`).join(", ");
-}
-function failConfig(message, hint) {
-  printError("config", message, hint);
-  process.exitCode = 1;
-}
-export {
-  registerConfig
-};