@thinkingai/ae-cli 1.0.27 → 1.0.28

package/dist/{te-analysis-CMXADIJM.js → te-analysis-A2OSGHQ4.js}

@@ -2,10 +2,12 @@ import {
   callMcpTool,
   parseMcpResult,
   resolveMcpUrl
-} from "./chunk-2NGWYMLB.js";
-import "./chunk-SRRUNQIM.js";
-import "./chunk-BI5ZVD6T.js";
-import "./chunk-MNHE6SSI.js";
+} from "./chunk-WCHI7725.js";
+import {
+  isGlobalQueryModeEnabled
+} from "./chunk-GSJGPNKK.js";
+import "./chunk-CAQYQA4R.js";
+import "./chunk-SRJIAOBN.js";
 
 // src/commands/te-analysis/shared.ts
 function createMcpCommand(config) {
@@ -56,6 +58,24 @@ function optionalJsonString(ctx, name) {
 function requiredJsonString(ctx, name) {
   return JSON.stringify(ctx.json(name));
 }
+function clusterQueryFlags(scopeDesc) {
+  if (!isGlobalQueryModeEnabled()) {
+    return [];
+  }
+  return [
+    { name: "cluster_query_scope", type: "string", required: false, desc: scopeDesc },
+    { name: "slave_cluster_id", type: "string", required: false, desc: "Slave cluster ID. Required when cluster_query_scope=SLAVE. Use +list_query_clusters first to choose this value." }
+  ];
+}
+function optionalClusterQueryArgs(ctx) {
+  if (!isGlobalQueryModeEnabled()) {
+    return {};
+  }
+  return {
+    clusterQueryScope: optionalString(ctx, "cluster_query_scope"),
+    slaveClusterId: optionalString(ctx, "slave_cluster_id")
+  };
+}
 var DEFAULT_QUERY_LIMIT = 1e3;
 var MAX_QUERY_LIMIT = 1e5;
 function assertLimitWithinCap(value, flagName) {
@@ -249,7 +269,8 @@ var queryReportData = createMcpCommand({
     { name: "start_date", type: "string", required: false, desc: "Optional start date in yyyy-MM-dd format" },
     { name: "end_date", type: "string", required: false, desc: "Optional end date in yyyy-MM-dd format" },
     { name: "time_granularity", type: "string", required: false, desc: "Optional time granularity used to override the report default. Supported values: minute, minute5, minute10, hour, day, week, month, quarter, year, total." },
-    { name: "timeout_minutes", type: "number", required: false, desc: "Query timeout in minutes. If omitted, 30 minutes is used." }
+    { name: "timeout_minutes", type: "number", required: false, desc: "Query timeout in minutes. If omitted, 30 minutes is used." },
+    ...clusterQueryFlags("Optional cluster query scope. Supported values: GLOBAL, SLAVE. Omit to query the current self cluster.")
   ],
   risk: "read",
   buildArgs: (ctx) => ({
@@ -262,7 +283,8 @@ var queryReportData = createMcpCommand({
     startDate: optionalString(ctx, "start_date"),
     endDate: optionalString(ctx, "end_date"),
     timeGranularity: optionalString(ctx, "time_granularity"),
-    timeoutMinutes: optionalNumber(ctx, "timeout_minutes")
+    timeoutMinutes: optionalNumber(ctx, "timeout_minutes"),
+    ...optionalClusterQueryArgs(ctx)
   })
 });
 
@@ -350,7 +372,8 @@ var queryDashboardReportData = createMcpCommand({
     { name: "end_date", type: "string", required: false, desc: "Optional end date in yyyy-MM-dd format" },
     { name: "time_granularity", type: "string", required: false, desc: "Optional time granularity used to override the report default. Supported values: minute, minute5, minute10, hour, day, week, month, quarter, year, total." },
     { name: "use_cache", type: "boolean", required: false, desc: "Whether to use cache. Default: true" },
-    { name: "report_ids", type: "json", required: false, desc: "Optional report IDs JSON array" }
+    { name: "report_ids", type: "json", required: false, desc: "Optional report IDs JSON array" },
+    ...clusterQueryFlags("Optional cluster query scope. Supported values: GLOBAL, SLAVE. Omit to follow dashboard configuration.")
   ],
   risk: "read",
   buildArgs: (ctx) => ({
@@ -361,7 +384,8 @@ var queryDashboardReportData = createMcpCommand({
     endDate: optionalString(ctx, "end_date"),
     timeGranularity: optionalString(ctx, "time_granularity"),
     useCache: optionalBoolean(ctx, "use_cache"),
-    reportIds: optionalJson(ctx, "report_ids")
+    reportIds: optionalJson(ctx, "report_ids"),
+    ...optionalClusterQueryArgs(ctx)
   })
 });
 
@@ -562,7 +586,8 @@ var queryAdhoc = createMcpCommand({
     { name: "fields", type: "json", required: false, desc: "Optional fields to return. Must match column names in result." },
     { name: "limit", type: "number", required: false, desc: "Optional limit. Default: 1000, maximum: 100000. For model_type=sql, either omit LIMIT in the SQL or keep it equal to --limit (the two must not differ)." },
     { name: "offset", type: "number", required: false, desc: "Optional offset. Default: 0." },
-    { name: "timeout_minutes", type: "number", required: false, desc: "Query timeout in minutes. If omitted, 30 minutes is used." }
+    { name: "timeout_minutes", type: "number", required: false, desc: "Query timeout in minutes. If omitted, 30 minutes is used." },
+    ...clusterQueryFlags("Optional cluster query scope. Supported values: GLOBAL, SLAVE. Omit to query the current self cluster. SQL model analysis does not support this parameter.")
   ],
   risk: "read",
   validate: (ctx) => {
@@ -584,7 +609,8 @@ var queryAdhoc = createMcpCommand({
     fields: optionalJson(ctx, "fields"),
     limit: resolveSqlAwareLimit(optionalNumber(ctx, "limit"), ctx.str("model_type"), ctx.json("qp")),
     offset: optionalNumber(ctx, "offset"),
-    timeoutMinutes: optionalNumber(ctx, "timeout_minutes")
+    timeoutMinutes: optionalNumber(ctx, "timeout_minutes"),
+    ...optionalClusterQueryArgs(ctx)
   })
 });
 
@@ -1069,16 +1095,36 @@ var commands6 = [
 ];
 var schema_default = commands6;
 
-// src/commands/te-analysis/index.ts
+// src/commands/te-analysis/global/list-query-clusters.ts
+var listQueryClusters = createMcpCommand({
+  command: "+list_query_clusters",
+  description: "List query cluster options accessible to the current account in the project. Use this to decide whether to query the current self cluster, global aggregated data, or one specific slave cluster.",
+  flags: [
+    { name: "project_id", type: "number", required: true, desc: "Project ID used to resolve cluster query permissions", alias: "p" }
+  ],
+  risk: "read",
+  buildArgs: (ctx) => ({
+    projectId: ctx.num("project_id")
+  })
+});
+
+// src/commands/te-analysis/global/index.ts
 var commands7 = [
+  listQueryClusters
+];
+var global_default = commands7;
+
+// src/commands/te-analysis/index.ts
+var commands8 = [
   ...meta_default,
   ...report_default,
   ...dashboard_default,
   ...model_default,
   ...entity_default,
-  ...schema_default
+  ...schema_default,
+  ...isGlobalQueryModeEnabled() ? global_default : []
 ];
-var te_analysis_default = commands7;
+var te_analysis_default = commands8;
 export {
   te_analysis_default as default
 };

package/dist/{te-audience-LPZFFSXM.js → te-audience-LI67PPGO.js}

@@ -2,10 +2,10 @@ import {
   callMcpTool,
   parseMcpResult,
   resolveMcpUrl
-} from "./chunk-2NGWYMLB.js";
-import "./chunk-SRRUNQIM.js";
-import "./chunk-BI5ZVD6T.js";
-import "./chunk-MNHE6SSI.js";
+} from "./chunk-WCHI7725.js";
+import "./chunk-GSJGPNKK.js";
+import "./chunk-CAQYQA4R.js";
+import "./chunk-SRJIAOBN.js";
 
 // src/commands/te-audience/shared.ts
 function createMcpCommand(config) {
@@ -59,7 +59,7 @@ function requiredJsonString(ctx, name) {
 // src/commands/te-audience/cluster/list-clusters.ts
 var listClusters = createMcpCommand({
   command: "+list_clusters",
-  description: "List cluster metadata with optional query/fields/limit/offset",
+  description: "List user cohort/segment cluster metadata with optional query/fields/limit/offset.",
   flags: [
     { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" },
     { name: "query", type: "string", required: false, desc: "Keyword filter", alias: "q" },

package/dist/{te-common-BXQFKTB3.js → te-common-35WVU3C5.js}

@@ -2,10 +2,10 @@ import {
   callMcpTool,
   parseMcpResult,
   resolveMcpUrl
-} from "./chunk-2NGWYMLB.js";
-import "./chunk-SRRUNQIM.js";
-import "./chunk-BI5ZVD6T.js";
-import "./chunk-MNHE6SSI.js";
+} from "./chunk-WCHI7725.js";
+import "./chunk-GSJGPNKK.js";
+import "./chunk-CAQYQA4R.js";
+import "./chunk-SRJIAOBN.js";
 
 // src/commands/te-common/shared.ts
 function createMcpCommand(config) {
@@ -49,15 +49,25 @@ var commands = [
 var project_default = commands;
 
 // src/commands/te-common/resource/get-resource-url.ts
-function normalizeResourceUrlFields(node) {
+function normalizeResourceUrlFields(node, host) {
   if (!node || typeof node !== "object") return;
   const obj = node;
-  for (const value of Object.values(obj)) {
-    if (value && typeof value === "object") {
-      normalizeResourceUrlFields(value);
+  for (const [key, value] of Object.entries(obj)) {
+    if (typeof value === "string") {
+      if (/url|link/i.test(key) || value.includes("/#/")) {
+        obj[key] = absolutizeRelativeUrls(value, host);
+      }
+    } else if (value && typeof value === "object") {
+      normalizeResourceUrlFields(value, host);
     }
   }
 }
+function absolutizeRelativeUrls(s, host) {
+  const base = host.replace(/\/+$/, "");
+  s = s.replace(/\]\((\/(?!\/)[^)]*)\)/g, `](${base}$1)`);
+  if (/^\/(?!\/)/.test(s)) s = base + s;
+  return s;
+}
 var getResourceUrl = {
   service: "analysis_common",
   command: "+get_resource_url",
@@ -96,7 +106,7 @@ var getResourceUrl = {
     if (typeof parsed !== "object" || parsed === null) {
       return parsed;
     }
-    normalizeResourceUrlFields(parsed);
+    normalizeResourceUrlFields(parsed, ctx.host());
     return parsed;
   }
 };

package/dist/{te-community-K5S3VOZY.js → te-community-LEAP6PWT.js}

@@ -3,10 +3,10 @@ import {
   parseMcpResult,
   registerMcpMappings,
   resolveMcpUrl
-} from "./chunk-2NGWYMLB.js";
-import "./chunk-SRRUNQIM.js";
-import "./chunk-BI5ZVD6T.js";
-import "./chunk-MNHE6SSI.js";
+} from "./chunk-WCHI7725.js";
+import "./chunk-GSJGPNKK.js";
+import "./chunk-CAQYQA4R.js";
+import "./chunk-SRJIAOBN.js";
 
 // src/commands/te-community/get_channel_info.ts
 var getChannelInfo = {

package/dist/{te-dataops-567IMCQG.js → te-dataops-N2LGZBOX.js}

@@ -3,10 +3,10 @@ import {
   parseMcpResult,
   registerMcpMappings,
   resolveMcpUrl
-} from "./chunk-2NGWYMLB.js";
-import "./chunk-SRRUNQIM.js";
-import "./chunk-BI5ZVD6T.js";
-import "./chunk-MNHE6SSI.js";
+} from "./chunk-WCHI7725.js";
+import "./chunk-GSJGPNKK.js";
+import "./chunk-CAQYQA4R.js";
+import "./chunk-SRJIAOBN.js";
 
 // src/commands/te-dataops/datatable/list-tables-by-page.ts
 var listTablesByPage = {

package/dist/{te-engage-TBUTGW5F.js → te-engage-H7C72Z46.js}

@@ -3,10 +3,10 @@ import {
   parseMcpResult,
   registerMcpMappings,
   resolveMcpUrl
-} from "./chunk-2NGWYMLB.js";
-import "./chunk-SRRUNQIM.js";
-import "./chunk-BI5ZVD6T.js";
-import "./chunk-MNHE6SSI.js";
+} from "./chunk-WCHI7725.js";
+import "./chunk-GSJGPNKK.js";
+import "./chunk-CAQYQA4R.js";
+import "./chunk-SRJIAOBN.js";
 
 // src/commands/te-engage/utils.ts
 function buildMcpDryRun(ctx, serviceName46, toolName46, args) {

package/dist/{te-kb-XHVBWP5E.js → te-kb-I2OKTBAI.js}

@@ -1,11 +1,11 @@
 import {
   kbApi,
   kbUpload
-} from "./chunk-MWWYGZ76.js";
-import "./chunk-2NGWYMLB.js";
-import "./chunk-SRRUNQIM.js";
-import "./chunk-BI5ZVD6T.js";
-import "./chunk-MNHE6SSI.js";
+} from "./chunk-OJDNO5QY.js";
+import "./chunk-WCHI7725.js";
+import "./chunk-GSJGPNKK.js";
+import "./chunk-CAQYQA4R.js";
+import "./chunk-SRJIAOBN.js";
 
 // src/commands/te-kb/query.ts
 var API_PATH = "/agent/api/external/knowledge-bases/query";

package/dist/{te-meta-NQ4U3VJW.js → te-meta-HBTIEDRO.js}

@@ -2,10 +2,10 @@ import {
   callMcpTool,
   parseMcpResult,
   resolveMcpUrl
-} from "./chunk-2NGWYMLB.js";
-import "./chunk-SRRUNQIM.js";
-import "./chunk-BI5ZVD6T.js";
-import "./chunk-MNHE6SSI.js";
+} from "./chunk-WCHI7725.js";
+import "./chunk-GSJGPNKK.js";
+import "./chunk-CAQYQA4R.js";
+import "./chunk-SRJIAOBN.js";
 
 // src/commands/te-meta/shared.ts
 function createMcpCommand(config) {

package/dist/{te-team-556APRIU.js → te-team-EM5OWRQL.js}

@@ -1,14 +1,14 @@
 import {
   kbApi
-} from "./chunk-MWWYGZ76.js";
+} from "./chunk-OJDNO5QY.js";
 import {
   printError,
   printOutput
-} from "./chunk-B4UL2VIJ.js";
-import "./chunk-2NGWYMLB.js";
-import "./chunk-SRRUNQIM.js";
-import "./chunk-BI5ZVD6T.js";
-import "./chunk-MNHE6SSI.js";
+} from "./chunk-CLJF7MQA.js";
+import "./chunk-WCHI7725.js";
+import "./chunk-GSJGPNKK.js";
+import "./chunk-CAQYQA4R.js";
+import "./chunk-SRJIAOBN.js";
 
 // src/commands/te-team/shared.ts
 var API_PREFIX = process.env.AE_API_PREFIX ?? "/agent";
@@ -176,7 +176,7 @@ var listTemplates = {
 };
 
 // src/commands/te-team/team/list-projects.ts
-var OAUTH_CHECK_PATH = "/api/oauth/check";
+var OAUTH_CHECK_PATH = `${API_PREFIX}/api/oauth/check`;
 var listProjects = {
   service: "team",
   command: "+list-projects",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thinkingai/ae-cli",
-  "version": "1.0.27",
+  "version": "1.0.28",
   "description": "CLI tool for ThinkingAI (AE) analytics platform",
   "type": "module",
   "bin": {
@@ -16,13 +16,17 @@
   "scripts": {
     "dev": "tsx src/index.ts",
     "build": "tsup src/index.ts --format esm --outDir dist",
-    "verify:analysis-tools": "node scripts/verify-te-analysis-tools.mjs",
+    "verify:config": "node test/config-commands.test.mjs",
+    "verify:analysis-tools": "tsx scripts/verify-te-analysis-tools.mjs",
+    "verify:analysis-cluster-routing": "node scripts/verify-analysis-cluster-routing.mjs",
+    "verify:multi-cluster-mode": "node test/multi-cluster-mode.test.mjs",
     "verify:analysis-builder-dry-run": "node scripts/verify-te-analysis-builder-dry-run.mjs",
     "verify:analysis-audience-tools": "node scripts/verify-te-audience-tools.mjs",
     "verify:analysis-meta-tools": "node scripts/verify-te-meta-tools.mjs",
     "verify:analysis-common-tools": "node scripts/verify-te-common-tools.mjs",
     "verify:team-tools": "node scripts/verify-te-team-tools.mjs",
     "verify:agent-tools": "node scripts/verify-agent-tools.mjs",
+    "verify:self-check-overlay": "node test/self-check-overlay.test.mjs",
     "verify:update-check": "npx tsx test/update-check.test.mjs",
     "self-check": "node self-check/scan.mjs",
     "check:agents-docs": "node scripts/check-agents-docs-sync.mjs",

package/skills/ae-agent/SKILL.md

@@ -21,6 +21,7 @@ ae-cli agent +<command> [options]
 - Toggle operations on company/system resources only affect the current user's preference, not the global state.
 - JSON flags must be valid JSON strings, usually wrapped in single quotes in shell.
 - Successful commands return JSON by default. Use `--format table` when a table is easier to scan.
+- `--host <url>` overrides the active AE host. It is available on every command and may be placed after the subcommand, e.g. `ae-cli agent +<command> --host <url>`.
 
 ## Commands
 

package/skills/ae-analysis/SKILL.md

@@ -6,7 +6,6 @@ description: "AE/TE/ThinkingEngine/ThinkingAI ae-cli manual for analysis-side ta
 
 # ae-analysis
 
-> **CRITICAL - This skill is self-contained.** Use the Global AE CLI Rules below; do not require a separate shared skill for analysis-side tasks.
 > **CRITICAL - For all commands that require `project_id`, you MUST satisfy `PROJECT_ID_GATE` first (no guessing): verify the project by ID/name with `analysis_common +list_projects` only when there is no valid project context yet, when the user switches project/host/environment, or when the supplied project is ambiguous. Reuse a project already verified in the same continuous conversation and same host/environment.**
 > **CRITICAL - For write operations in this skill, you MUST complete the post-write link loop when applicable:** after success and extractable `resource_id`, call `analysis_common +get_resource_url` and return the main result + resource link (or explicit link-failure reason).
 > **CRITICAL - Before running any `+<tool_name>` command, you MUST first read the corresponding `references/<tool_name>.md`.** The reference filename always equals the command name without the leading `+`, for example `+query_adhoc` -> `references/query_adhoc.md`.
@@ -21,6 +20,7 @@ Global parameters:
 |---|---|
 | `--format <json\|table>` | Output format. Default is JSON. |
 | `--jq <expr>` | jq filter expression for JSON output. |
+| `--host <url>` | Override the active AE host. Available on every command and may be placed after the subcommand, e.g. `ae-cli analysis +list_dashboards --host <url>`. |
 
 Output and errors:
 - Successful commands return machine-readable JSON by default.

package/skills/ae-analysis/references/list_clusters.md

@@ -1,4 +1,4 @@
-# analysis_audience +list_clusters (Cluster Search)
+# analysis_audience +list_clusters (Audience/User Segment Cluster Search)
 
 > **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
 
@@ -8,8 +8,10 @@ Domain: **Cluster Management**
 
 **Fuzzy Search Fallback:** If `--query` returns no results, retry with broader keywords (max 3 attempts), then fall back to full list. See [SKILL.md § C. FUZZY_SEARCH_FALLBACK](../SKILL.md#c-fuzzy_search_fallback).
 
+**Term boundary:** This command lists audience/user segment clusters only. It is not a server, region, or deployment inventory tool.
+
 ## Use Cases
-- List cluster metadata accessible to the current user in the project.
+- List audience/user segment cluster metadata accessible to the current user in the project.
 - Supports payload governance parameters: `query`, `fields`, `limit`, `offset`.
 - Returns a paginated envelope (items + total + limit + offset + hasMore), not cluster members.
 

package/skills/ae-analysis-global/SKILL.md

@@ -0,0 +1,51 @@
+---
+name: ae-analysis-global
+version: 1.0.0
+description: "Overlay rules for AE/TE analysis global multi-cluster mode. Use only when ae-cli config cluster-mode status reports sw_cfg_enable_global_query=true. This skill supplements ae-analysis; it does not replace it."
+---
+
+# ae-analysis-global
+
+
+This is an overlay for `ae-analysis`. First use the normal `ae-analysis` rules and matching command references. Apply the rules below only when local multi-cluster mode is enabled (`ae-cli config cluster-mode status`):
+
+```bash
+ae-cli config cluster-mode status
+```
+
+The result must contain:
+
+```json
+{"sw_cfg_enable_global_query": true}
+```
+
+If the mode is not enabled, do not use this overlay.
+
+For commands added only by this overlay, read this skill's matching reference file before composing commands. Example: `+list_query_clusters` -> `references/list_query_clusters.md`.
+
+Every command accepts `--host <url>` to override the active AE host, and it may be placed after the subcommand (e.g. `ae-cli analysis +list_query_clusters --project_id <id> --host <url>`). Host selection is independent of `--cluster_query_scope`: `--host` chooses which AE instance to call, while `--cluster_query_scope` / `--slave_cluster_id` choose which cluster within global mode.
+
+## Routing Rules
+
+- In this overlay, **query cluster / service cluster / deployment cluster** means multi-cluster routing for analysis queries. **audience/user segment cluster** means audience membership assets under `analysis_audience`.
+- If the user asks for cluster inventory or cluster info, call `ae-cli analysis +list_query_clusters --project_id <project_id>`. Localized examples include "集群信息" and "有哪些集群".
+- Do not answer query-cluster inventory questions with `ae-cli analysis_audience +list_clusters` unless the user explicitly asks for audience clusters, cohorts, segments, user membership, or cluster definitions.
+- If the user mentions country, region, server, shard, site, market, or deployment area semantics, call `ae-cli analysis +list_query_clusters --project_id <project_id>` before choosing query scope.
+- Match slave cluster intent only against `slaveClusters[].clusterId`, `slaveClusters[].clusterName`, and `slaveClusters[].clusterDesc` returned by `+list_query_clusters`.
+- If a matching accessible slave cluster exists, pass `--cluster_query_scope SLAVE --slave_cluster_id <clusterId>` to `+query_report_data`, `+query_dashboard_report_data`, or `+query_adhoc`.
+- Use `--cluster_query_scope GLOBAL` only when the user clearly asks for global, all clusters, all servers, or cross-cluster aggregated data, and `permissions.canQueryGlobal=true`.
+- If the user does not express global or slave-cluster intent, omit `--cluster_query_scope`.
+- If requested global/slave scope is not allowed, explain `permissions.allowedClusterQueryParams` instead of guessing forbidden parameters.
+- For `+query_adhoc --model_type sql`, never pass `--cluster_query_scope`; SQL model analysis only supports the current self cluster.
+
+## Response Wording
+
+- For `+list_query_clusters`, call the result "query clusters" and summarize `currentCluster`, `slaveClusters`, and `permissions.allowedClusterQueryParams`.
+- For `analysis_audience +list_clusters`, call the result "audience clusters" or "user segments"; do not call those results query clusters.
+
+## Commands Added By Multi-Cluster Mode
+
+- `ae-cli analysis +list_query_clusters --project_id <project_id>`
+- `ae-cli analysis +query_report_data ... --cluster_query_scope <GLOBAL|SLAVE> [--slave_cluster_id <id>]`
+- `ae-cli analysis +query_dashboard_report_data ... --cluster_query_scope <GLOBAL|SLAVE> [--slave_cluster_id <id>]`
+- `ae-cli analysis +query_adhoc ... --cluster_query_scope <GLOBAL|SLAVE> [--slave_cluster_id <id>]`

package/skills/ae-analysis-global/references/list_query_clusters.md

@@ -0,0 +1,67 @@
+# analysis +list_query_clusters (Query Cluster Options)
+
+> **Prerequisite:** Use this reference only after `ae-analysis-global` confirms local multi-cluster mode is enabled. This command is added by the global overlay, not by the base `ae-analysis` skill.
+
+Domain: **Multi-Cluster Query Routing**
+
+## Use Cases
+
+- List the query cluster options accessible to the current account in the project.
+- Answer user questions such as "cluster info", "available query clusters", or "current cluster". Localized examples include "集群信息" and "有哪些集群".
+- Decide whether a later report/dashboard/ad-hoc query should use the current self cluster, global aggregated data, or one specific slave cluster.
+- Resolve country, region, game server, service shard, site, market, or deployment area wording to an accessible slave cluster before passing `cluster_query_scope=SLAVE`.
+
+This command is not for audience/user segment clusters. For cohort, audience, or segment assets, use `analysis_audience +list_clusters`.
+
+## Commands
+
+```bash
+ae-cli analysis +list_query_clusters --project_id <project_id>
+ae-cli analysis +list_query_clusters --dry-run
+```
+
+## Parameters
+
+| Parameter | Required | Description |
+|---|---|---|
+| `--project_id` / `-p` | Yes | Project ID used to resolve the current account's cluster query permissions. |
+
+## Output Shape
+
+The result data follows the server DTO used by `list_query_clusters`:
+
+| Field | Description |
+|---|---|
+| `globalQueryEnabled` | Whether global query is enabled by server config. |
+| `currentCluster` | The current self query cluster. Fields: `clusterId`, `clusterName`, `clusterDesc`. |
+| `slaveClusters` | Accessible slave query clusters for this account and project. Each item has `clusterId`, `clusterName`, `clusterDesc`. |
+| `permissions` | Permission summary for choosing query scope. |
+| `permissions.canQueryCurrent` | Whether the user can query the current self cluster. Usually true. |
+| `permissions.canQueryGlobal` | Whether `cluster_query_scope=GLOBAL` is allowed. |
+| `permissions.canQueryAllSlaveClusters` | Whether any enabled slave cluster may be queried. |
+| `permissions.allowedSlaveClusterIds` | Slave cluster IDs this account may use. |
+| `permissions.allowedClusterQueryParams` | Human-readable allowed query parameter combinations, e.g. `omit clusterQueryScope`, `clusterQueryScope=GLOBAL`, or `clusterQueryScope=SLAVE, slaveClusterId in [...]`. |
+
+## Decision Rules
+
+- For query-cluster inventory or cluster-info questions, call this command and answer with "query clusters", not "audience clusters".
+- Default query behavior is to omit `cluster_query_scope`, which queries the current self cluster or follows the tool-specific default.
+- Pass `--cluster_query_scope GLOBAL` only when the user clearly asks for global, all clusters, all servers, cross-cluster aggregation, or equivalent aggregate wording, and `permissions.canQueryGlobal=true`.
+- Pass `--cluster_query_scope SLAVE --slave_cluster_id <clusterId>` only after this command confirms a requested country, region, server, site, market, or deployment maps to an accessible `slaveClusters[]` item.
+- Match slave intent only against `slaveClusters[].clusterId`, `slaveClusters[].clusterName`, and `slaveClusters[].clusterDesc`.
+- If the requested scope is not allowed, do not guess forbidden parameters. Explain `permissions.allowedClusterQueryParams`.
+- For `+query_adhoc --model_type sql`, never pass `cluster_query_scope`; SQL model analysis only supports the current self cluster.
+
+## Recommended Chains
+
+- Cluster inventory / cluster info -> `analysis +list_query_clusters`
+- Query DAU for Japan server -> `analysis +list_query_clusters` -> match JP/Japan slave cluster -> query report/dashboard/ad-hoc with `--cluster_query_scope SLAVE --slave_cluster_id <clusterId>`
+- Query all-cluster aggregated DAU -> `analysis +list_query_clusters` -> if `permissions.canQueryGlobal=true`, query with `--cluster_query_scope GLOBAL`
+- View audience cohorts or user segments -> `analysis_audience +list_clusters` instead
+
+## Response Wording
+
+- Use "current query cluster" for `currentCluster`.
+- Use "accessible slave query clusters" for `slaveClusters`.
+- Use "allowed query-scope parameters" for `permissions.allowedClusterQueryParams`.
+- Do not call `analysis_audience +list_clusters` results query clusters; those are audience clusters or user segments.

package/skills/ae-community/SKILL.md

@@ -1,13 +1,11 @@
 ---
 name: ae-community
 version: 2.0.0
-description: "AE community analysis: post search, comment sentiment, topic trends, risky content, livestream data. Includes AE CLI authentication, global parameters, and safety rules (self-contained)."
+description: "AE community analysis: post search, comment sentiment, topic trends, risky content, livestream data."
 ---
 
 # ae-community
 
-> **CRITICAL - This skill is self-contained.** Use the Global AE CLI Rules below; do not require a separate shared skill for community-side tasks.
-
 The AE Community domain provides social data analysis: post/video search, comment analytics, sentiment and topics, risk monitoring, and livestream metrics. Commands run as **`ae-cli community +<subcommand>`** — every community subcommand uses the **`+` prefix**.
 
 | Route (MCP) | CLI service | Responsibility |
@@ -28,6 +26,7 @@ Global parameters:
 |---|---|
 | `--format <json\|table>` | Output format. Default is JSON. |
 | `--jq <expr>` | jq filter expression for JSON output. |
+| `--host <url>` | Override the active AE host. Available on every command and may be placed after the subcommand, e.g. `ae-cli community +<command> --host <url>`. |
 
 Output and errors:
 - Successful commands return machine-readable JSON by default.

package/skills/ae-dataops/SKILL.md

@@ -6,8 +6,6 @@ description: "AE Data Development and Operations: Data warehouse management, flo
 
 # ae-dataops
 
-> **CRITICAL - This skill is self-contained.** Use the Global AE CLI Rules below; do not require a separate shared skill for DataOps-side tasks.
-
 The AE Data Development and Operations domain provides capabilities for data warehouse management, flow orchestration, IDE SQL queries, data integration, operations and backfill management, including the following subcommands:
 
 | Subcommand | Responsibility | Corresponding Scenario Skill |
@@ -33,6 +31,7 @@ Global parameters:
 |---|---|
 | `--format <json\|table>` | Output format. Default is JSON. |
 | `--jq <expr>` | jq filter expression for JSON output. |
+| `--host <url>` | Override the active AE host. Available on every command and may be placed after the subcommand, e.g. `ae-cli dataops_ide +<command> --host <url>`. |
 
 Output and errors:
 - Successful commands return machine-readable JSON by default.

package/skills/ae-engage/SKILL.md

@@ -18,6 +18,7 @@ Global parameters:
 |---|---|
 | `--format <json\|table>` | Output format. Default is JSON. |
 | `--jq <expr>` | jq filter expression for JSON output. |
+| `--host <url>` | Override the active AE host. Available on every command and may be placed after the subcommand, e.g. `ae-cli engage +<command> --host <url>`. |
 
 Output and errors:
 - Successful commands return machine-readable JSON by default.

package/skills/ae-engage/references/add-approver.md

@@ -1,6 +1,5 @@
 # ae-engage +add_approver
 
-> **Prerequisite:** Read [`../../ae-shared/SKILL.md`](../../ae-shared/SKILL.md)
 
 Batch add approvers.
 

package/skills/ae-engage/references/add-channel.md

@@ -1,6 +1,5 @@
 # ae-engage +add_channel
 
-> **Prerequisite:** Read [`../../ae-shared/SKILL.md`](../../ae-shared/SKILL.md)
 
 Create a new Engage channel.
 

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

@@ -1,6 +1,5 @@
 # ae-engage +approver_list
 
-> **Prerequisite:** Read [`../../ae-shared/SKILL.md`](../../ae-shared/SKILL.md)
 
 Query the project approver list.
 

package/skills/ae-engage/references/cancel-query-by-request-id.md

@@ -1,6 +1,5 @@
 # ae-engage +cancel_query_by_request_id
 
-> **Prerequisite:** Read [`../../ae-shared/SKILL.md`](../../ae-shared/SKILL.md)
 
 Cancel a running data query by requestId.
 

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

@@ -1,6 +1,5 @@
 # ae-engage +channel_detail
 
-> **Prerequisite:** Read [`../../ae-shared/SKILL.md`](../../ae-shared/SKILL.md)
 
 Query the details of a single Engage channel.
 

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

@@ -1,6 +1,5 @@
 # ae-engage +channel_list
 
-> **Prerequisite:** Read [`../../ae-shared/SKILL.md`](../../ae-shared/SKILL.md)
 
 Query the list of Engage channels in a project.
 

package/skills/ae-engage/references/config-channel-detail.md

@@ -1,6 +1,5 @@
 # ae-engage +config_channel_detail
 
-> **Prerequisite:** Read [`../../ae-shared/SKILL.md`](../../ae-shared/SKILL.md)
 
 Query config channel details.
 

package/skills/ae-engage/references/config-channel-list.md

@@ -1,6 +1,5 @@
 # ae-engage +config_channel_list
 
-> **Prerequisite:** Read [`../../ae-shared/SKILL.md`](../../ae-shared/SKILL.md)
 
 Query the config channel list.