@thinkingai/ae-cli 1.0.22 → 1.0.24

package/README.md

@@ -60,6 +60,14 @@ ae-cli analysis_meta +list_events --project_id 1 --format table
 
 # Raw API call
 ae-cli api GET /v1/ta/event/catalog/listEvent --params '{"projectId": 1}'
+
+# Knowledge base (create → upload → compile → query)
+ae-cli kb +new --scope company --name engineering-handbook --description "Team docs"
+ae-cli kb +add --name engineering-handbook --files '["./docs/guide.md","https://example.com/page"]'
+ae-cli kb +schema --name engineering-handbook
+ae-cli kb +compile --name engineering-handbook
+ae-cli kb +query -q "How to configure sandbox?" \
+  --sources '[{"scope":"company","name":"engineering-handbook"}]'
 ```
 
 ## Authentication
@@ -97,8 +105,21 @@ ae-cli auth logout
 | `dataops_integration` | 20+ | Data integration: datasource management, sync solutions, data synchronization |
 | `community` | 10+ | Community analysis: posts search, sentiment analysis, topic trends, livestream data |
 | `analysis_common` | 2 | Cross-module common constraints: resource link completion, project ID gate |
+| `kb` | 7 | Knowledge base lifecycle: query / new / add (md/dir/url) / schema / compile / rm-source / remove |
 | `auth` / `config` | 2 | Authentication and host configuration |
 
+### kb
+
+Knowledge base lifecycle (`+new` → `+add` → `+schema` → `+compile` → `+query`):
+
+- **Create** (`+new`): `--scope personal|company`, `--name`, optional `--description`, `--tags`, `--project-id`, `--project-name`
+- **Upload** (`+add`): `--name`, `--files` JSON array (`.md` file, directory non-recursive scan, or http(s) URL with HTML-to-Markdown conversion)
+- **Schema** (`+schema`): `--name`, optional `--force`, `--model`
+- **Compile** (`+compile`): `--name`, `--mode incremental|full` (default: incremental)
+- **Query** (`+query`): `--query` / `-q`, `--sources` JSON refs e.g. `[{"scope":"company","name":"engineering-handbook"}]`
+- **Remove source** (`+rm-source`): `--name`, `--display-name`
+- **Remove KB** (`+remove`): `--name`
+
 ### Global Options
 
 | Option | Description | Default |
@@ -108,6 +129,7 @@ ae-cli auth logout
 | `--jq <expr>` | Filter expression | - |
 | `--dry-run` | Preview request | false |
 | `--yes` | Skip confirmation | false |
+| `--no-update-check` | Skip checking for newer ae-cli versions | false |
 
 ## Skills
 
@@ -185,7 +207,8 @@ src/
     ├── te-engage/
     ├── te-dataops/
     ├── te-community/
-    └── te-common/
+    ├── te-common/
+    └── te-kb/
 ```
 
 ## Verification Scripts

package/README.zh.md

@@ -60,6 +60,14 @@ ae-cli analysis_meta +list_events --project_id 1 --format table
 
 # 原始 API 调用
 ae-cli api GET /v1/ta/event/catalog/listEvent --params '{"projectId": 1}'
+
+# 知识库（新建 → 上传 → 编译 → 查询）
+ae-cli kb +new --scope company --name engineering-handbook --description "Team docs"
+ae-cli kb +add --name engineering-handbook --files '["./docs/guide.md","https://example.com/page"]'
+ae-cli kb +schema --name engineering-handbook
+ae-cli kb +compile --name engineering-handbook
+ae-cli kb +query -q "如何配置 sandbox 容器？" \
+  --sources '[{"scope":"company","name":"engineering-handbook"}]'
 ```
 
 ## 身份验证
@@ -97,8 +105,21 @@ ae-cli auth logout
 | `dataops_integration` | 20+ | 数据集成：数据源管理、同步方案、数据同步 |
 | `community` | 10+ | 社区分析：帖子搜索、情感分析、话题趋势、直播数据 |
 | `analysis_common` | 2 | 跨模块通用约束：资源链接补全、项目 ID 门控 |
+| `kb` | 7 | 知识库生命周期：查询 / 新建 / 添加源（md/目录/url）/ schema / 编译 / 删除源 / 删除 |
 | `auth` / `config` | 2 | 身份验证和主机配置 |
 
+### kb（知识库）
+
+知识库生命周期（`+new` → `+add` → `+schema` → `+compile` → `+query`）：
+
+- **新建** (`+new`)：`--scope personal|company`，`--name`，可选 `--description`、`--tags`、`--project-id`、`--project-name`
+- **上传源** (`+add`)：`--name`，`--files` JSON 数组（`.md` 文件、目录非递归扫描、或 http(s) URL 自动转 Markdown）
+- **生成 schema** (`+schema`)：`--name`，可选 `--force`、`--model`
+- **编译** (`+compile`)：`--name`，`--mode incremental|full`（默认 incremental）
+- **查询** (`+query`)：`--query` / `-q`，`--sources` JSON 引用，如 `[{"scope":"company","name":"engineering-handbook"}]`
+- **删除源** (`+rm-source`)：`--name`，`--display-name`
+- **删除知识库** (`+remove`)：`--name`
+
 ### 全局选项
 
 | 选项 | 描述 | 默认值 |
@@ -108,6 +129,7 @@ ae-cli auth logout
 | `--jq <expr>` | 过滤表达式 | - |
 | `--dry-run` | 预览请求 | false |
 | `--yes` | 跳过确认 | false |
+| `--no-update-check` | 跳过 ae-cli 新版本检查 | false |
 
 ## Skills
 
@@ -185,7 +207,8 @@ src/
     ├── te-engage/
     ├── te-dataops/
     ├── te-community/
-    └── te-common/
+    ├── te-common/
+    └── te-kb/
 ```
 
 ## 验证脚本

package/dist/{auth-YM7OI23X.js → auth-4OPL4YWG.js}

@@ -7,8 +7,8 @@ import {
   saveToken,
   setTokenManual,
   validateToken
-} from "./chunk-24ZKQWG2.js";
-import "./chunk-TMMUBSKW.js";
+} from "./chunk-47MTN54I.js";
+import "./chunk-DC66L5AM.js";
 export {
   clearToken,
   getAuthStatus,

package/dist/{auth-5S7SPPEJ.js → auth-PBPAZQWP.js}

@@ -1,13 +1,13 @@
 import {
   printError,
   printOutput
-} from "./chunk-KM57HI5B.js";
+} from "./chunk-JJCRURTR.js";
 import {
   clearMcpToken,
   loadMcpTokenStore,
   setMcpTokenManual,
   validateMcpToken
-} from "./chunk-MPFTXJFG.js";
+} from "./chunk-OVHL4JAC.js";
 import {
   clearToken,
   getAuthStatus,
@@ -15,11 +15,12 @@ import {
   resolveHost,
   setTokenManual,
   validateToken
-} from "./chunk-24ZKQWG2.js";
+} from "./chunk-47MTN54I.js";
 import {
   loadConfig,
+  logger,
   saveConfig
-} from "./chunk-TMMUBSKW.js";
+} from "./chunk-DC66L5AM.js";
 
 // src/commands/auth.ts
 function registerAuth(program) {
@@ -37,11 +38,13 @@ function registerAuth(program) {
         config.activeHost = host;
       }
       saveConfig(config);
+      logger.info(`Host config auto-saved for ${host}`);
       process.stderr.write(`[ae-cli] Config saved for ${host}
 `);
     }
     try {
       const token = await getToken(host);
+      logger.info(`Auth login successful for ${host}`);
       process.stderr.write(`[ae-cli] Authenticated to ${host}
 `);
       printOutput({ authenticated: true, host, token: token.slice(0, 8) + "..." }, program.opts().format || "json");
@@ -71,12 +74,14 @@ function registerAuth(program) {
 `);
     const isValid = await validateToken(token, host);
     if (!isValid) {
+      logger.warn(`Token validation failed for ${host}`);
       process.stderr.write(`[ae-cli] Token validation failed
 `);
       printError("auth", "Invalid token", "Please check your token and try again");
       process.exit(1);
     }
     setTokenManual(token, host);
+    logger.info(`Token manually set and validated for ${host}`);
     process.stderr.write(`[ae-cli] Token verified and saved for ${host}
 `);
     printOutput({ saved: true, host, verified: true }, program.opts().format || "json");

package/dist/{chunk-24ZKQWG2.js → chunk-47MTN54I.js}

@@ -2,9 +2,10 @@ import {
   extractHostname,
   getActiveHost,
   getConfigDir,
+  logger,
   safeJsonParse,
   safeReadJsonFile
-} from "./chunk-TMMUBSKW.js";
+} from "./chunk-DC66L5AM.js";
 
 // src/core/auth.ts
 import fs from "fs";
@@ -90,6 +91,7 @@ function saveToken(token, hostUrl) {
   const tokens = loadAllTokens();
   tokens[hostUrl] = { token, updatedAt: (/* @__PURE__ */ new Date()).toISOString() };
   saveAllTokens(tokens);
+  logger.info(`Token saved for ${hostUrl}`);
 }
 function clearToken(hostUrl) {
   const tokens = loadAllTokens();
@@ -172,6 +174,7 @@ function extractTokenFromAllTabs() {
   }
 }
 async function requestTokenViaOsascript(hostUrl) {
+  logger.info(`Opening Chrome to ${hostUrl} for token extraction`);
   process.stderr.write(`[ae-cli] No AE tab found in Chrome. Opening ${hostUrl} ...
 `);
   process.stderr.write(`[ae-cli] Please login, then your token will be captured automatically.
@@ -189,24 +192,36 @@ async function requestTokenViaOsascript(hostUrl) {
     ];
     execFileSync("osascript", openScript.flatMap((line) => ["-e", line]), { timeout: 5e3 });
   } catch {
+    logger.warn(`Failed to open Chrome, user may need to open ${hostUrl} manually`);
     process.stderr.write(`[ae-cli] Could not open browser. Please open ${hostUrl} in Chrome manually.
 `);
   }
   const deadline = Date.now() + OSASCRIPT_POLL_TIMEOUT_MS;
+  let pollCount = 0;
   while (Date.now() < deadline) {
     await new Promise((r) => setTimeout(r, OSASCRIPT_POLL_INTERVAL_MS));
+    pollCount++;
     let result = extractTokenViaOsascript(hostUrl);
     if (result.error === "no_tab") {
       const fallback = extractTokenFromAllTabs();
-      if (fallback.token) result = fallback;
+      if (fallback.token) {
+        logger.info("Token captured via all-tabs fallback search");
+        result = fallback;
+      }
     }
     if (result.token) {
+      saveToken(result.token, hostUrl);
+      logger.info(`Token captured after ${pollCount} poll(s)`);
       process.stderr.write(`[ae-cli] Token captured from Chrome for ${hostUrl}.
 `);
       return result.token;
     }
-    if (result.error === "no_js_permission") return null;
+    if (result.error === "no_js_permission") {
+      logger.warn("Chrome JS permission denied during polling");
+      return null;
+    }
   }
+  logger.warn(`Token polling timed out after ${OSASCRIPT_POLL_TIMEOUT_MS / 1e3}s (${pollCount} polls)`);
   process.stderr.write(`[ae-cli] Polling timed out after ${OSASCRIPT_POLL_TIMEOUT_MS / 1e3}s.
 `);
   return null;
@@ -219,12 +234,17 @@ Run: ae-cli config set-host`
     );
   }
   if (process.env.TE_TOKEN) {
+    logger.info("Using token from env:TE_TOKEN");
     return process.env.TE_TOKEN;
   }
   const cached = loadToken(hostUrl);
-  if (cached && cached.token) return cached.token;
+  if (cached && cached.token) {
+    logger.info(`Using cached token for ${hostUrl}`);
+    return cached.token;
+  }
   const { token: osascriptToken, error } = extractTokenViaOsascript(hostUrl);
   if (error === "no_js_permission") {
+    logger.warn("Chrome JS Apple Events not enabled");
     throw new Error(
       `Chrome JavaScript from Apple Events is not enabled.
 Enable it: Chrome menu \u2192 View \u2192 Developer \u2192 Allow JavaScript from Apple Events`

package/dist/{chunk-TMMUBSKW.js → chunk-DC66L5AM.js}

@@ -1,5 +1,81 @@
-// src/core/json-utils.ts
+// src/core/logger.ts
 import fs from "fs";
+import path from "path";
+var LOG_DIR = path.join(process.env.HOME || "", ".ae-cli", "log");
+var Logger = class {
+  logDir;
+  date;
+  constructor() {
+    this.logDir = LOG_DIR;
+    this.date = this.today();
+    this.ensureDir();
+  }
+  today() {
+    const d = /* @__PURE__ */ new Date();
+    return `${d.getFullYear()}${String(d.getMonth() + 1).padStart(2, "0")}${String(d.getDate()).padStart(2, "0")}`;
+  }
+  timestamp() {
+    return (/* @__PURE__ */ new Date()).toISOString().replace("T", " ").split(".")[0];
+  }
+  ensureDir() {
+    if (!fs.existsSync(this.logDir)) {
+      fs.mkdirSync(this.logDir, { recursive: true });
+    }
+  }
+  filePath(level) {
+    const today = this.today();
+    if (today !== this.date) {
+      this.date = today;
+    }
+    return path.join(this.logDir, `${this.date}_${level}.log`);
+  }
+  /**
+   * 写入日志到文件（不输出到控制台，控制台由现有 process.stderr.write 负责）
+   */
+  write(level, message) {
+    const ts = this.timestamp();
+    const line = `[${ts}] ${message}
+`;
+    try {
+      fs.appendFileSync(this.filePath(level), line);
+    } catch {
+    }
+  }
+  /** 常规操作日志 */
+  info(message) {
+    this.write("info", message);
+  }
+  /** 警告日志 */
+  warn(message) {
+    this.write("warning", message);
+  }
+  /** 错误日志 */
+  error(message) {
+    this.write("error", message);
+  }
+  /** 记录 HTTP API 请求详情 */
+  api(method, url, status, reqBody, respBody) {
+    const parts = [`API ${method} ${url} \u2192 HTTP ${status}`];
+    if (reqBody !== void 0 && reqBody !== null) {
+      const s = typeof reqBody === "string" ? reqBody : JSON.stringify(reqBody);
+      parts.push(`REQ: ${s.slice(0, 500)}`);
+    }
+    if (respBody !== void 0 && respBody !== null) {
+      const s = typeof respBody === "string" ? respBody : JSON.stringify(respBody);
+      parts.push(`RESP: ${s.slice(0, 500)}`);
+    }
+    this.info(parts.join(" | "));
+  }
+  /** 记录命令执行 */
+  command(name, args) {
+    const filtered = Object.entries(args).filter(([, v]) => v !== void 0 && v !== null && v !== "").map(([k, v]) => `--${k}=${JSON.stringify(v)}`).join(" ");
+    this.info(`CMD ${name}${filtered ? " " + filtered : ""}`);
+  }
+};
+var logger = new Logger();
+
+// src/core/json-utils.ts
+import fs2 from "fs";
 import { createRequire } from "module";
 var require2 = createRequire(import.meta.url);
 var JSONbig = require2("json-bigint");
@@ -8,28 +84,28 @@ function safeJsonParse(text) {
   return jsonParser.parse(text);
 }
 function safeReadJsonFile(filePath) {
-  const content = fs.readFileSync(filePath, "utf-8");
+  const content = fs2.readFileSync(filePath, "utf-8");
   return safeJsonParse(content);
 }
 
 // src/core/config.ts
-import fs2 from "fs";
-import path from "path";
-var CONFIG_DIR = path.join(process.env.HOME || "", ".ae-cli");
-var CONFIG_FILE = path.join(CONFIG_DIR, "config.json");
-var MCP_TOKENS_FILE = path.join(CONFIG_DIR, "mcp-tokens.json");
+import fs3 from "fs";
+import path2 from "path";
+var CONFIG_DIR = path2.join(process.env.HOME || "", ".ae-cli");
+var CONFIG_FILE = path2.join(CONFIG_DIR, "config.json");
+var MCP_TOKENS_FILE = path2.join(CONFIG_DIR, "mcp-tokens.json");
 var FALLBACK_MCP_TOKEN_FILE = "/data/app/te_agent_ta/.ae-config/mcp-token.json";
 function ensureDir() {
-  if (!fs2.existsSync(CONFIG_DIR)) fs2.mkdirSync(CONFIG_DIR, { recursive: true });
+  if (!fs3.existsSync(CONFIG_DIR)) fs3.mkdirSync(CONFIG_DIR, { recursive: true });
 }
 function migrateFromFallback() {
-  if (!fs2.existsSync(FALLBACK_MCP_TOKEN_FILE) || fs2.existsSync(MCP_TOKENS_FILE)) {
+  if (!fs3.existsSync(FALLBACK_MCP_TOKEN_FILE) || fs3.existsSync(MCP_TOKENS_FILE)) {
     return null;
   }
   return doMigrateFromFallback();
 }
 function forceMigrateFromFallback() {
-  if (!fs2.existsSync(FALLBACK_MCP_TOKEN_FILE)) {
+  if (!fs3.existsSync(FALLBACK_MCP_TOKEN_FILE)) {
     return null;
   }
   return doMigrateFromFallback();
@@ -47,7 +123,7 @@ function doMigrateFromFallback() {
     }
     if (Object.keys(tokenStore).length > 0) {
       ensureDir();
-      fs2.writeFileSync(MCP_TOKENS_FILE, JSON.stringify(tokenStore, null, 2));
+      fs3.writeFileSync(MCP_TOKENS_FILE, JSON.stringify(tokenStore, null, 2));
       return tokenStore;
     }
   } catch {
@@ -57,7 +133,7 @@ function doMigrateFromFallback() {
 function loadConfig() {
   try {
     const migratedTokens = migrateFromFallback();
-    if (fs2.existsSync(CONFIG_FILE)) {
+    if (fs3.existsSync(CONFIG_FILE)) {
       const raw = safeReadJsonFile(CONFIG_FILE);
       if (raw.defaultHost && !raw.activeHost) {
         const migrated = migrateConfig(raw);
@@ -78,11 +154,13 @@ function loadConfig() {
 `);
       process.stderr.write(`[ae-cli] MCP tokens migrated from ${FALLBACK_MCP_TOKEN_FILE}
 `);
+      logger.info(`MCP tokens migrated from fallback: activeHost=${activeHost}, hosts=${Object.keys(hosts).length}`);
       const config = { activeHost, hosts };
       saveConfig(config);
       return config;
     }
   } catch (err) {
+    logger.error(`Error loading config: ${err.message}`);
     console.error(`Error loading config: ${err.message}`);
   }
   return { activeHost: "", hosts: {} };
@@ -104,7 +182,8 @@ function migrateConfig(old) {
 }
 function saveConfig(config) {
   ensureDir();
-  fs2.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
+  fs3.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
+  logger.info(`Config saved: activeHost=${config.activeHost}, hosts=${Object.keys(config.hosts).length}`);
 }
 function getActiveHost() {
   const config = loadConfig();
@@ -163,6 +242,7 @@ function extractHostname(fullUrl) {
 }
 
 export {
+  logger,
   safeJsonParse,
   safeReadJsonFile,
   forceMigrateFromFallback,

package/dist/{chunk-KM57HI5B.js → chunk-JJCRURTR.js}

@@ -1,3 +1,7 @@
+import {
+  logger
+} from "./chunk-DC66L5AM.js";
+
 // src/framework/output.ts
 import Table from "cli-table3";
 var KNOWN_ARRAY_FIELDS = [
@@ -95,7 +99,9 @@ function formatError(type, message, hint, code) {
   return JSON.stringify(envelope, null, 2);
 }
 function printError(type, message, hint, code) {
-  process.stderr.write(formatError(type, message, hint, code) + "\n");
+  const formatted = formatError(type, message, hint, code);
+  process.stderr.write(formatted + "\n");
+  logger.error(`[${type}] ${message}${hint ? " | " + hint : ""}`);
 }
 function printOutput(data, format, jqExpr) {
   process.stdout.write(formatOutput(data, format, jqExpr) + "\n");

package/dist/{chunk-NBFTPIAH.js → chunk-MZW6NOVS.js}

@@ -2,10 +2,11 @@ import {
   clearToken,
   getToken,
   resolveHost
-} from "./chunk-24ZKQWG2.js";
+} from "./chunk-47MTN54I.js";
 import {
+  logger,
   safeJsonParse
-} from "./chunk-TMMUBSKW.js";
+} from "./chunk-DC66L5AM.js";
 
 // src/core/client.ts
 import WebSocket from "ws";
@@ -39,11 +40,13 @@ async function request(method, modulePath, params = {}, body = null, retry = tru
   const options = { method, headers };
   if (body && method !== "GET") options.body = JSON.stringify(body);
   const resp = await fetch(url, options);
+  const text = await resp.text();
+  const data = safeJsonParse(text);
+  logger.api(method, url, resp.status, body, data);
   if ((resp.status === 401 || resp.status === 403) && retry) {
     clearToken(resolvedHost);
     return request(method, modulePath, params, body, false, resolvedHost);
   }
-  const data = safeJsonParse(await resp.text());
   if (data.return_code === -1001 && retry) {
     clearToken(resolvedHost);
     return request(method, modulePath, params, body, false, resolvedHost);
@@ -70,11 +73,13 @@ async function uploadRequest(modulePath, form, params = {}, retry = true, hostUr
     "Authorization": `bearer ${token}`
   };
   const resp = await fetch(url, { method: "POST", headers, body: form });
+  const text = await resp.text();
+  const data = safeJsonParse(text);
+  logger.api("POST", url, resp.status, { upload: true }, data);
   if ((resp.status === 401 || resp.status === 403) && retry) {
     clearToken(resolvedHost);
     return uploadRequest(modulePath, form, params, false, resolvedHost);
   }
-  const data = safeJsonParse(await resp.text());
   if (data.return_code === -1001 && retry) {
     clearToken(resolvedHost);
     return uploadRequest(modulePath, form, params, false, resolvedHost);

package/dist/{chunk-MPFTXJFG.js → chunk-OVHL4JAC.js}

@@ -1,13 +1,14 @@
 import {
   getToken
-} from "./chunk-24ZKQWG2.js";
+} from "./chunk-47MTN54I.js";
 import {
   forceMigrateFromFallback,
   getActiveHost,
   getConfigDir,
+  logger,
   safeJsonParse,
   safeReadJsonFile
-} from "./chunk-TMMUBSKW.js";
+} from "./chunk-DC66L5AM.js";
 
 // src/core/mcp.ts
 import fs from "fs";
@@ -98,9 +99,11 @@ async function getMcpToken(hostOverride) {
   if (store[hostUrl]) {
     return store[hostUrl];
   }
+  logger.info(`Generating MCP token for ${hostUrl}`);
   const mcpToken = await generateMcpToken(hostUrl);
   const updatedStore = { ...store, [hostUrl]: mcpToken };
   saveMcpTokenStore(updatedStore);
+  logger.info(`MCP token generated and cached for ${hostUrl}`);
   return mcpToken;
 }
 function clearMcpToken(hostUrl) {
@@ -118,6 +121,7 @@ function setMcpTokenManual(token, hostUrl) {
   const store = loadMcpTokenStore();
   store[hostUrl] = token;
   saveMcpTokenStore(store);
+  logger.info(`MCP token manually set for ${hostUrl}`);
 }
 async function validateMcpToken(token, hostUrl) {
   const mapping = getMcpMapping("analysis");
@@ -180,8 +184,10 @@ async function mcpRequest(url, method, params = {}, hostOverride) {
     body: JSON.stringify(body)
   });
   if (!resp.ok) {
+    logger.warn(`MCP request failed (HTTP ${resp.status}) for ${hostUrl}, trying fallback`);
     const migrated = forceMigrateFromFallback();
     if (migrated && migrated[hostUrl]) {
+      logger.info(`MCP token refreshed from fallback for ${hostUrl}`);
       process.stderr.write(`[ae-cli] MCP token refreshed from fallback for ${hostUrl}
 `);
       headers["mcp-token"] = migrated[hostUrl];
@@ -212,7 +218,11 @@ async function callMcpTool(url, toolName, args = {}, hostOverride) {
     name: toolName,
     arguments: args
   };
+  logger.info(`MCP tool call: ${toolName}`);
   const result = await mcpRequest(url, "tools/call", params, hostOverride);
+  if (result.isError) {
+    logger.warn(`MCP tool call failed: ${toolName}`);
+  }
   return {
     content: result.content.map((item) => {
       if (item.type === "text") {

package/dist/{client-7S23DVHH.js → client-TDH6MUWM.js}

@@ -6,9 +6,9 @@ import {
   queryReportData,
   querySql,
   wsQuery
-} from "./chunk-NBFTPIAH.js";
-import "./chunk-24ZKQWG2.js";
-import "./chunk-TMMUBSKW.js";
+} from "./chunk-MZW6NOVS.js";
+import "./chunk-47MTN54I.js";
+import "./chunk-DC66L5AM.js";
 export {
   httpDelete,
   httpGet,

package/dist/{config-RVUESJRF.js → config-5ELRYAIH.js}

@@ -4,14 +4,14 @@ import {
   getToken,
   loadToken,
   validateToken
-} from "./chunk-24ZKQWG2.js";
+} from "./chunk-47MTN54I.js";
 import {
   addHost,
   listHosts,
   removeHost,
   setActiveHost,
   updateHostLabel
-} from "./chunk-TMMUBSKW.js";
+} from "./chunk-DC66L5AM.js";
 
 // src/commands/config.ts
 import * as readline from "readline";

package/dist/index.js

@@ -1,11 +1,12 @@
 import {
   printError,
   printOutput
-} from "./chunk-KM57HI5B.js";
+} from "./chunk-JJCRURTR.js";
 import {
   getActiveHost,
+  logger,
   safeJsonParse
-} from "./chunk-TMMUBSKW.js";
+} from "./chunk-DC66L5AM.js";
 
 // src/index.ts
 import { Command as CommanderCommand } from "commander";
@@ -16,6 +17,8 @@ import * as readline from "readline";
 async function runCommand(cmd, opts, globalOpts) {
   try {
     const ctx = createRuntimeContext(cmd, opts, globalOpts);
+    const cmdName = `${cmd.service} ${cmd.command}`;
+    logger.command(cmdName, opts);
     for (const flag of cmd.flags) {
       if (flag.required) {
         const val = opts[camelCase(flag.name)];
@@ -48,6 +51,7 @@ async function runCommand(cmd, opts, globalOpts) {
     ctx.out(result);
   } catch (err) {
     const message = err.message || String(err);
+    logger.error(`Command failed: ${message}`);
     if (message.includes("token") || message.includes("auth") || message.includes("401") || message.includes("403")) {
       printError("auth", message, "Run: ae-cli auth login");
     } else if (message.includes("AE API error")) {
@@ -62,7 +66,7 @@ function createRuntimeContext(cmd, opts, globalOpts) {
   let _clientModule = null;
   async function getClient() {
     if (!_clientModule) {
-      _clientModule = await import("./client-7S23DVHH.js");
+      _clientModule = await import("./client-TDH6MUWM.js");
     }
     return _clientModule;
   }
@@ -88,12 +92,12 @@ function createRuntimeContext(cmd, opts, globalOpts) {
         process.exit(1);
       }
     },
-    async api(method, path, params, data) {
+    async api(method, path2, params, data) {
       const client = await getClient();
       if (method.toUpperCase() === "GET") {
-        return client.httpGet(path, params, ctx.host());
+        return client.httpGet(path2, params, ctx.host());
       } else {
-        return client.httpPost(path, params, data, ctx.host());
+        return client.httpPost(path2, params, data, ctx.host());
       }
     },
     async querySql(projectId, sql) {
@@ -105,7 +109,7 @@ function createRuntimeContext(cmd, opts, globalOpts) {
       return client.queryReportData(projectId, reportId, qp, eventModel, options, ctx.host());
     },
     async token() {
-      const { getToken } = await import("./auth-YM7OI23X.js");
+      const { getToken } = await import("./auth-4OPL4YWG.js");
       return getToken(ctx.host());
     },
     host() {
@@ -202,50 +206,192 @@ function extractGlobalOptions(program2) {
   };
 }
 
+// src/core/update-check.ts
+import fs from "fs";
+import path from "path";
+var CONFIG_DIR = path.join(process.env.HOME || "", ".ae-cli");
+var CACHE_FILE = path.join(CONFIG_DIR, "update-check.json");
+var CHECK_INTERVAL_MS = 24 * 60 * 60 * 1e3;
+var FETCH_TIMEOUT_MS = 3e3;
+var REGISTRY_BY_PACKAGE = {
+  "@thinkingai/ae-cli": "https://registry.npmjs.org"
+};
+var UPDATE_CHECK_PACKAGE = "@thinkingai/ae-cli";
+function isUpdateCheckEnabled(packageName) {
+  return packageName === UPDATE_CHECK_PACKAGE;
+}
+var DEFAULT_REGISTRY = "https://registry.npmjs.org";
+function parseVersion(version2) {
+  const core = version2.trim().split("-")[0];
+  return core.split(".").map((part) => {
+    const n = Number.parseInt(part, 10);
+    return Number.isFinite(n) ? n : 0;
+  });
+}
+function isNewer(latest, current) {
+  const a = parseVersion(latest);
+  const b = parseVersion(current);
+  const len = Math.max(a.length, b.length, 3);
+  for (let i = 0; i < len; i += 1) {
+    const av = a[i] ?? 0;
+    const bv = b[i] ?? 0;
+    if (av > bv) return true;
+    if (av < bv) return false;
+  }
+  return false;
+}
+function resolveRegistry(packageName) {
+  if (REGISTRY_BY_PACKAGE[packageName]) {
+    return REGISTRY_BY_PACKAGE[packageName];
+  }
+  const envRegistry = process.env.npm_config_registry?.replace(/\/$/, "");
+  return envRegistry || DEFAULT_REGISTRY;
+}
+function buildInstallCommand(packageName, registry) {
+  const base = `npm install -g ${packageName}@latest`;
+  if (registry === DEFAULT_REGISTRY) {
+    return base;
+  }
+  return `${base} --registry=${registry}`;
+}
+function shouldSkipUpdateCheck(argv = process.argv) {
+  if (process.env.AE_CLI_NO_UPDATE_CHECK === "1") return true;
+  if (process.env.CI === "true" || process.env.CI === "1") return true;
+  return argv.slice(2).some((arg) => {
+    if (arg === "--no-update-check") return true;
+    if (arg === "--version" || arg === "-V" || arg === "--help" || arg === "-h") return true;
+    return false;
+  });
+}
+function ensureConfigDir() {
+  if (!fs.existsSync(CONFIG_DIR)) {
+    fs.mkdirSync(CONFIG_DIR, { recursive: true });
+  }
+}
+function readCache() {
+  try {
+    if (!fs.existsSync(CACHE_FILE)) return null;
+    const raw = fs.readFileSync(CACHE_FILE, "utf8");
+    const data = JSON.parse(raw);
+    if (!data.packageName || !data.latestVersion || !data.lastCheckedAt) return null;
+    return data;
+  } catch {
+    return null;
+  }
+}
+function writeCache(cache) {
+  try {
+    ensureConfigDir();
+    fs.writeFileSync(CACHE_FILE, JSON.stringify(cache, null, 2));
+  } catch {
+  }
+}
+function cacheIsStale(cache, packageName) {
+  if (!cache || cache.packageName !== packageName) return true;
+  const age = Date.now() - new Date(cache.lastCheckedAt).getTime();
+  return age >= CHECK_INTERVAL_MS;
+}
+function printUpdateNotice(current, latest, installCommand) {
+  process.stderr.write(`[ae-cli] Update available: ${current} \u2192 ${latest}
+`);
+  process.stderr.write(`         Run: ${installCommand}
+`);
+}
+async function fetchLatestVersion(packageName, registry) {
+  const url = `${registry.replace(/\/$/, "")}/${encodeURIComponent(packageName)}`;
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+  try {
+    const resp = await fetch(url, {
+      signal: controller.signal,
+      headers: { Accept: "application/json" }
+    });
+    if (!resp.ok) return null;
+    const data = await resp.json();
+    const latest = data["dist-tags"]?.latest;
+    return typeof latest === "string" && latest.trim() ? latest.trim() : null;
+  } catch {
+    return null;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+async function refreshCache(pkg2, registry) {
+  const latest = await fetchLatestVersion(pkg2.name, registry);
+  if (!latest) return readCache();
+  const cache = {
+    packageName: pkg2.name,
+    currentVersion: pkg2.version,
+    latestVersion: latest,
+    lastCheckedAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  writeCache(cache);
+  return cache;
+}
+function maybeNotifyFromCache(pkg2, cache, registry) {
+  if (!cache || cache.packageName !== pkg2.name) return;
+  if (!isNewer(cache.latestVersion, pkg2.version)) return;
+  printUpdateNotice(pkg2.version, cache.latestVersion, buildInstallCommand(pkg2.name, registry));
+}
+function notifyIfUpdateAvailable(pkg2) {
+  if (!isUpdateCheckEnabled(pkg2.name)) return;
+  if (shouldSkipUpdateCheck()) return;
+  const registry = resolveRegistry(pkg2.name);
+  const cache = readCache();
+  maybeNotifyFromCache(pkg2, cache, registry);
+  if (!cacheIsStale(cache, pkg2.name)) return;
+  void refreshCache(pkg2, registry).then((fresh) => {
+    if (!fresh) return;
+    if (cache && fresh.latestVersion === cache.latestVersion) return;
+    maybeNotifyFromCache(pkg2, fresh, registry);
+  });
+}
+
 // src/index.ts
 var require2 = createRequire(import.meta.url);
-var { version } = require2("../package.json");
+var pkg = require2("../package.json");
+var { version } = pkg;
 var program = new CommanderCommand();
-program.name("ae-cli").version(version).description("CLI tool for ThinkingAI (AE) analytics platform").option("--host <url>", "Override active AE host URL (e.g., https://ta.thinkingdata.cn)").option("--mcp-url <url>", "Override MCP server URL (e.g., http://localhost/mcp/http/example)").option("--format <format>", "Output format: json | table", "json").option("--jq <expr>", "jq filter expression").option("--dry-run", "Show request details without executing", false).option("--yes", "Skip confirmation for write operations", false);
+program.name("ae-cli").version(version).description("CLI tool for ThinkingAI (AE) analytics platform").option("--host <url>", "Override active AE host URL (e.g., https://ta.thinkingdata.cn)").option("--mcp-url <url>", "Override MCP server URL (e.g., http://localhost/mcp/http/example)").option("--format <format>", "Output format: json | table", "json").option("--jq <expr>", "jq filter expression").option("--dry-run", "Show request details without executing", false).option("--yes", "Skip confirmation for write operations", false).option("--no-update-check", "Skip checking for newer ae-cli versions", false);
 async function loadCommands() {
   const commands = [];
   try {
-    const teAnalysis = await import("./te-analysis-RQST6AT3.js");
+    const teAnalysis = await import("./te-analysis-3KFSNUCJ.js");
     commands.push(...teAnalysis.default);
   } catch {
   }
   try {
-    const teAudience = await import("./te-audience-TJ74UJI3.js");
+    const teAudience = await import("./te-audience-GMYJFCSC.js");
     commands.push(...teAudience.default);
   } catch {
   }
   try {
-    const teMeta = await import("./te-meta-25SLZFXJ.js");
+    const teMeta = await import("./te-meta-3EFWLM3A.js");
     commands.push(...teMeta.default);
   } catch {
   }
   try {
-    const teCommon = await import("./te-common-W5URM2SH.js");
+    const teCommon = await import("./te-common-YLERCMQI.js");
     commands.push(...teCommon.default);
   } catch {
   }
   try {
-    const engage = await import("./te-engage-57UKFV74.js");
+    const engage = await import("./te-engage-ROJVZHDA.js");
     commands.push(...engage.default);
   } catch {
   }
   try {
-    const community = await import("./te-community-YRV2VAD4.js");
+    const community = await import("./te-community-PYDN5A6B.js");
     commands.push(...community.default);
   } catch {
   }
   try {
-    const dataops = await import("./te-dataops-ZPH72BCK.js");
+    const dataops = await import("./te-dataops-ETWS5O3X.js");
     commands.push(...dataops.default);
   } catch {
   }
   try {
-    const teKb = await import("./te-kb-GD7SJRYB.js");
+    const teKb = await import("./te-kb-VUNS2CC7.js");
     commands.push(...teKb.default);
   } catch {
   }
@@ -253,26 +399,27 @@ async function loadCommands() {
 }
 async function registerAuthCommands() {
   try {
-    const { registerAuth } = await import("./auth-5S7SPPEJ.js");
+    const { registerAuth } = await import("./auth-PBPAZQWP.js");
     registerAuth(program);
   } catch {
   }
 }
 async function registerConfigCommands() {
   try {
-    const { registerConfig } = await import("./config-RVUESJRF.js");
+    const { registerConfig } = await import("./config-5ELRYAIH.js");
     registerConfig(program);
   } catch {
   }
 }
 async function registerApiCommand() {
   try {
-    const { registerApi } = await import("./raw-5SYAUCJQ.js");
+    const { registerApi } = await import("./raw-EM7AP3RT.js");
     registerApi(program);
   } catch {
   }
 }
 async function main() {
+  notifyIfUpdateAvailable({ name: pkg.name, version: pkg.version });
   const commands = await loadCommands();
   registerCommands(program, commands);
   await registerAuthCommands();

package/dist/{raw-5SYAUCJQ.js → raw-EM7AP3RT.js}

@@ -1,17 +1,17 @@
 import {
   printError,
   printOutput
-} from "./chunk-KM57HI5B.js";
+} from "./chunk-JJCRURTR.js";
 import {
   httpGet,
   httpPost
-} from "./chunk-NBFTPIAH.js";
+} from "./chunk-MZW6NOVS.js";
 import {
   resolveHost
-} from "./chunk-24ZKQWG2.js";
+} from "./chunk-47MTN54I.js";
 import {
   safeJsonParse
-} from "./chunk-TMMUBSKW.js";
+} from "./chunk-DC66L5AM.js";
 
 // src/api/raw.ts
 function registerApi(program) {

package/dist/{te-analysis-RQST6AT3.js → te-analysis-3KFSNUCJ.js}

@@ -2,9 +2,9 @@ import {
   callMcpTool,
   parseMcpResult,
   resolveMcpUrl
-} from "./chunk-MPFTXJFG.js";
-import "./chunk-24ZKQWG2.js";
-import "./chunk-TMMUBSKW.js";
+} from "./chunk-OVHL4JAC.js";
+import "./chunk-47MTN54I.js";
+import "./chunk-DC66L5AM.js";
 
 // src/commands/te-analysis/shared.ts
 function createMcpCommand(config) {
@@ -459,6 +459,24 @@ var updatePublicAccessLink = createMcpCommand({
   })
 });
 
+// src/commands/te-analysis/dashboard/create-space.ts
+var createSpace = createMcpCommand({
+  command: "+create_space",
+  description: "Create a new space in a project. A space organizes dashboards and assets under a named container.",
+  flags: [
+    { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" },
+    { name: "space_name", type: "string", required: true, desc: "Space name (1-64 characters)" },
+    { name: "space_desc", type: "string", required: false, desc: "Optional space description (max 200 characters)" }
+  ],
+  risk: "write",
+  mcpService: "te_analysis_extend",
+  buildArgs: (ctx) => ({
+    projectId: ctx.num("project_id"),
+    spaceName: ctx.str("space_name"),
+    spaceDesc: optionalString(ctx, "space_desc")
+  })
+});
+
 // src/commands/te-analysis/dashboard/index.ts
 var commands3 = [
   listDashboards,
@@ -469,7 +487,8 @@ var commands3 = [
   createOrUpdateDashboardNote,
   listPublicAccessLinks,
   createPublicAccessLink,
-  updatePublicAccessLink
+  updatePublicAccessLink,
+  createSpace
 ];
 var dashboard_default = commands3;
 

package/dist/{te-audience-TJ74UJI3.js → te-audience-GMYJFCSC.js}

@@ -2,9 +2,9 @@ import {
   callMcpTool,
   parseMcpResult,
   resolveMcpUrl
-} from "./chunk-MPFTXJFG.js";
-import "./chunk-24ZKQWG2.js";
-import "./chunk-TMMUBSKW.js";
+} from "./chunk-OVHL4JAC.js";
+import "./chunk-47MTN54I.js";
+import "./chunk-DC66L5AM.js";
 
 // src/commands/te-audience/shared.ts
 function createMcpCommand(config) {

package/dist/{te-common-W5URM2SH.js → te-common-YLERCMQI.js}

@@ -2,9 +2,9 @@ import {
   callMcpTool,
   parseMcpResult,
   resolveMcpUrl
-} from "./chunk-MPFTXJFG.js";
-import "./chunk-24ZKQWG2.js";
-import "./chunk-TMMUBSKW.js";
+} from "./chunk-OVHL4JAC.js";
+import "./chunk-47MTN54I.js";
+import "./chunk-DC66L5AM.js";
 
 // src/commands/te-common/shared.ts
 function createMcpCommand(config) {

package/dist/{te-community-YRV2VAD4.js → te-community-PYDN5A6B.js}

@@ -3,9 +3,9 @@ import {
   parseMcpResult,
   registerMcpMappings,
   resolveMcpUrl
-} from "./chunk-MPFTXJFG.js";
-import "./chunk-24ZKQWG2.js";
-import "./chunk-TMMUBSKW.js";
+} from "./chunk-OVHL4JAC.js";
+import "./chunk-47MTN54I.js";
+import "./chunk-DC66L5AM.js";
 
 // src/commands/te-community/get_channel_info.ts
 var getChannelInfo = {

package/dist/{te-dataops-ZPH72BCK.js → te-dataops-ETWS5O3X.js}

@@ -3,9 +3,9 @@ import {
   parseMcpResult,
   registerMcpMappings,
   resolveMcpUrl
-} from "./chunk-MPFTXJFG.js";
-import "./chunk-24ZKQWG2.js";
-import "./chunk-TMMUBSKW.js";
+} from "./chunk-OVHL4JAC.js";
+import "./chunk-47MTN54I.js";
+import "./chunk-DC66L5AM.js";
 
 // src/commands/te-dataops/datatable/list-tables-by-page.ts
 var listTablesByPage = {

package/dist/{te-engage-57UKFV74.js → te-engage-ROJVZHDA.js}

@@ -3,9 +3,9 @@ import {
   parseMcpResult,
   registerMcpMappings,
   resolveMcpUrl
-} from "./chunk-MPFTXJFG.js";
-import "./chunk-24ZKQWG2.js";
-import "./chunk-TMMUBSKW.js";
+} from "./chunk-OVHL4JAC.js";
+import "./chunk-47MTN54I.js";
+import "./chunk-DC66L5AM.js";
 
 // src/commands/te-engage/utils.ts
 function buildMcpDryRun(ctx, serviceName44, toolName44, args) {

package/dist/{te-kb-GD7SJRYB.js → te-kb-VUNS2CC7.js}

@@ -1,22 +1,17 @@
 import {
   httpDelete,
   httpUpload
-} from "./chunk-NBFTPIAH.js";
-import "./chunk-24ZKQWG2.js";
-import "./chunk-TMMUBSKW.js";
+} from "./chunk-MZW6NOVS.js";
+import "./chunk-47MTN54I.js";
+import "./chunk-DC66L5AM.js";
 
 // src/commands/te-kb/query.ts
 var API_PATH = "/agent/api/external/knowledge-bases/query";
 function buildBody(ctx) {
-  const body = {
+  return {
     query: ctx.str("query"),
     sources: ctx.json("sources")
   };
-  const modelId = ctx.str("model-id");
-  if (modelId) body.modelId = modelId;
-  const maxTurnsRaw = ctx.str("max-turns");
-  if (maxTurnsRaw !== "") body.maxTurns = ctx.num("max-turns");
-  return body;
 }
 var query = {
   service: "kb",
@@ -24,9 +19,7 @@ var query = {
   description: "Query knowledge.",
   flags: [
     { name: "query", type: "string", required: true, alias: "q", desc: "Natural language question to query against the knowledge bases" },
-    { name: "sources", type: "json", required: true, desc: 'JSON array of knowledge base refs, e.g. [{"scope":"company","name":"engineering-handbook"}]' },
-    { name: "model-id", type: "string", required: false, default: "AE-Auto", desc: "Model identifier (default: AE-Auto)" },
-    { name: "max-turns", type: "number", required: false, default: 6, desc: "Maximum reasoning turns (default: 6)" }
+    { name: "sources", type: "json", required: true, desc: 'JSON array of knowledge base refs, e.g. [{"scope":"company","name":"engineering-handbook"}]' }
   ],
   risk: "read",
   dryRun: (ctx) => ({

package/dist/{te-meta-25SLZFXJ.js → te-meta-3EFWLM3A.js}

@@ -2,9 +2,9 @@ import {
   callMcpTool,
   parseMcpResult,
   resolveMcpUrl
-} from "./chunk-MPFTXJFG.js";
-import "./chunk-24ZKQWG2.js";
-import "./chunk-TMMUBSKW.js";
+} from "./chunk-OVHL4JAC.js";
+import "./chunk-47MTN54I.js";
+import "./chunk-DC66L5AM.js";
 
 // src/commands/te-meta/shared.ts
 function createMcpCommand(config) {
@@ -533,8 +533,28 @@ var listEntities = createMcpCommand({
   })
 });
 
+// src/commands/te-meta/entity/create-entity.ts
+var createEntity = createMcpCommand({
+  command: "+create_entity",
+  description: "Create a new entity that links an event or user property as an analysis dimension.",
+  flags: [
+    { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" },
+    { name: "entity_name", type: "string", required: true, desc: "Entity name" },
+    { name: "column_name", type: "string", required: true, desc: "Property column name to associate with the entity" },
+    { name: "table_type", type: "number", required: true, desc: "Table type: 0 = event property, 1 = user property" }
+  ],
+  risk: "write",
+  mcpService: "te_analysis_extend",
+  buildArgs: (ctx) => ({
+    projectId: ctx.num("project_id"),
+    entityName: ctx.str("entity_name"),
+    columnName: ctx.str("column_name"),
+    tableType: ctx.num("table_type")
+  })
+});
+
 // src/commands/te-meta/entity/index.ts
-var commands3 = [listEntities];
+var commands3 = [listEntities, createEntity];
 var entity_default = commands3;
 
 // src/commands/te-meta/index.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thinkingai/ae-cli",
-  "version": "1.0.22",
+  "version": "1.0.24",
   "description": "CLI tool for ThinkingAI (AE) analytics platform",
   "type": "module",
   "bin": {
@@ -21,6 +21,7 @@
     "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:update-check": "npx tsx test/update-check.test.mjs",
     "prepublishOnly": "npm run build",
     "start": "node dist/index.js",
     "test": "npx tsx src/index.ts --help"

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

@@ -0,0 +1,39 @@
+# analysis_meta +create_entity (Create Entity)
+
+> **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
+
+Domain: **Entity Management**
+
+## Use Cases
+- Create a new entity that links an event property or user property as an analysis dimension.
+- Use `+list_entities` first to confirm the entity does not already exist.
+
+## Commands
+```bash
+ae-cli analysis_meta +create_entity --project_id <project_id> --entity_name "User Entity" --column_name user_id --table_type 1
+ae-cli analysis_meta +create_entity --project_id <project_id> --entity_name "Event Entity" --column_name event_col --table_type 0
+ae-cli analysis_meta +create_entity --dry-run
+```
+
+## Parameters
+| Parameter | Required | Description |
+|---|---|---|
+| `--project_id` / `-p` | Yes | Project ID |
+| `--entity_name` | Yes | Entity name |
+| `--column_name` | Yes | Property column name to associate with the entity |
+| `--table_type` | Yes | Table type: `0` = event property, `1` = user property |
+
+## Decision Rules
+- `--table_type` must be `0` (event property) or `1` (user property); no other values are accepted.
+- Before using `--column_name`, call `analysis_meta +list_properties` to verify it exists. If the same column name appears in **both** event properties and user properties, **stop and ask the user which table type to use** — do not guess `--table_type`. Ask every time this condition is met; never carry over the answer from a previous request.
+- For the first run, pass only the required parameters and confirm before adding others.
+- Write operations keep the confirmation prompt by default; use `--yes` only for automation.
+
+## Next Steps After Failure
+- If `PROJECT_ID_REQUIRED` or `ENTITY_NAME_REQUIRED` appears, check that all required parameters are provided.
+- If `INVALID_TABLE_TYPE` appears, verify `--table_type` is exactly `0` or `1`.
+- If the result after writing is not as expected, use `analysis_meta +list_entities` to compare before and after.
+
+## Recommended Chaining
+- `analysis_meta +list_entities` → `+create_entity`
+- `analysis_meta +list_properties` → `+create_entity`

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

@@ -0,0 +1,34 @@
+# analysis +create_space (Create Space)
+
+> **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
+
+Domain: **Space Management**
+
+## Use Cases
+- Create a new space in a project to organize dashboards and assets under a named container.
+- Returns basic space information (ID, name, avatar settings).
+
+## Commands
+```bash
+ae-cli analysis +create_space --project_id <project_id> --space_name "My Space"
+ae-cli analysis +create_space --project_id <project_id> --space_name "Team Space" --space_desc "Team dashboards"
+ae-cli analysis +create_space --dry-run
+```
+
+## Parameters
+| Parameter | Required | Description |
+|---|---|---|
+| `--project_id` / `-p` | Yes | Project ID |
+| `--space_name` | Yes | Space name (1-64 characters) |
+| `--space_desc` | No | Optional space description (max 200 characters) |
+
+## Decision Rules
+- `--space_name` must be between 1 and 64 characters.
+- Write operations keep the confirmation prompt by default; use `--yes` only for automation.
+
+## Next Steps After Failure
+- If `SPACE_NAME_TOO_LONG` appears, shorten `--space_name` to 64 characters or fewer.
+- If the result after writing is not as expected, use `analysis +list_dashboards` to inspect the space context.
+
+## Recommended Chaining
+- `+create_space` → `+create_dashboard` (create dashboard inside the new space using `--space_id`)