@thinkingai/ae-cli 6.0.48 → 6.1.0-project-role-upsert.1

package/README.md

@@ -2,7 +2,7 @@
 
 # ae-cli
 
-`ae-cli` is the command-line client for the ThinkingAI AgenticEngine (AE) platform. It provides stable, structured interfaces for both AI Agents and human operators across analytics and project configuration, metadata, tracking, local-data ingestion, Engage, DataOps, knowledge bases, Agent resources, user memory, and system administration.
+`ae-cli` is the command-line client for the ThinkingAI AgenticEngine (AE) platform. It provides stable, structured interfaces for both AI Agents and human operators across analytics, experimentation, project configuration, metadata, tracking, local-data ingestion, Engage, DataOps, knowledge bases, Agent resources, user memory, and system administration.
 
 The CLI is designed around:
 
@@ -109,11 +109,13 @@ The table covers every current root command individually. Use `ae-cli --help` fo
 | Category | Root command | Purpose |
 |---|---|---|
 | Analysis and projects | `analysis` | Reports, dashboards, ad-hoc analysis, drilldowns, details, alerts, tags, and cohorts |
+| Analysis and projects | `experiment` | Atlas experiments, reports, traffic layers, buckets, Features, metrics, and operation logs |
 | Analysis and projects | `analysis-meta` | Event/property catalogs, metrics, virtual metadata, tracking governance, and project analysis settings |
 | Analysis and projects | `analysis-governance` | Data-asset search, lineage, impact analysis, certification, and governance |
 | Analysis and projects | `project` | Project information, members, roles, permissions, entities, time zones, and handover settings |
 | Analysis and projects | `metadata` | Capability-backed data-table, property, and dimension-table binding operations |
 | Analysis and projects | `personal-semantic-preference` | Project-scoped lightweight semantic preferences for the current user |
+| Analysis and projects | `project-semantic` | Governed project semantics, asset packages, candidate validation, review, and publishing |
 | Data and tracking | `tracking` | Tracking plans, SDK samples, checks, ingestion diagnostics, code generation, and bundled wiki |
 | Data and tracking | `data-integration` | Inspect, plan, convert, upload, hand off, and reuse local CSV/JSON/Excel data |
 | Community insights | `community` | Community posts, comments, topics, sentiment, livestream, and report workflows |
@@ -355,6 +357,7 @@ npm test
 npm run qa-changed
 npm run self-check
 npm run check:release
+npm run verify:experiment-tools
 npm run verify:readme
 npm run verify:auth-credentials
 npm run verify:update-check

package/README.zh.md

@@ -2,7 +2,7 @@
 
 # ae-cli
 
-`ae-cli` 是 ThinkingAI AgenticEngine（AE）平台的命令行客户端，为 AI Agent 和人工操作提供稳定、结构化的接口，覆盖分析与项目配置、元数据、埋点、本地数据接入、运营、DataOps、知识库、Agent 资源、用户记忆及系统管理。
+`ae-cli` 是 ThinkingAI AgenticEngine（AE）平台的命令行客户端，为 AI Agent 和人工操作提供稳定、结构化的接口，覆盖分析、实验、项目配置、元数据、埋点、本地数据接入、运营、DataOps、知识库、Agent 资源、用户记忆及系统管理。
 
 CLI 的核心设计包括：
 
@@ -113,11 +113,13 @@ ae-cli capability list --domain analysis --jq '.data.capabilities[] | .id'
 | 类别 | 根命令 | 用途 |
 |---|---|---|
 | 分析与项目 | `analysis` | 报告、看板、即席分析、下钻、详情、告警、标签和分群 |
+| 分析与项目 | `experiment` | Atlas 实验、报表、流量层、分桶、Feature、指标和操作日志 |
 | 分析与项目 | `analysis-meta` | 事件/属性目录、指标、虚拟元数据、埋点治理和项目分析配置 |
 | 分析与项目 | `analysis-governance` | 数据资产搜索、血缘、影响分析、认证和治理 |
 | 分析与项目 | `project` | 项目信息、成员、角色、权限、实体、时区和交接配置 |
 | 分析与项目 | `metadata` | 基于 Capability Gateway 的数据表、属性及维度表绑定 |
 | 分析与项目 | `personal-semantic-preference` | 当前用户按项目维护轻量个人语义偏好 |
+| 分析与项目 | `project-semantic` | 项目语义治理、资产包、候选校验、审核和发布 |
 | 数据与埋点 | `tracking` | 埋点方案、SDK 示例、检查、采集诊断、代码生成和内置 Wiki |
 | 数据与埋点 | `data-integration` | 检查、规划、转换、上传、交接和复用本地 CSV/JSON/Excel 数据 |
 | 社区洞察 | `community` | 社区帖子、评论、话题、情感、直播和报告工作流 |
@@ -359,6 +361,7 @@ npm test
 npm run qa-changed
 npm run self-check
 npm run check:release
+npm run verify:experiment-tools
 npm run verify:readme
 npm run verify:auth-credentials
 npm run verify:update-check

package/dist/{capability-J4FU4JZW.js → capability-AXFQW5WM.js}

@@ -3,14 +3,6 @@ import {
   normalizeRiskLevel,
   requiresConfirmation
 } from "./chunk-AMBFK2K3.js";
-import {
-  findGatewayDomain,
-  listRegisteredCapabilityDomains,
-  resolveGatewayDomain
-} from "./chunk-TKHSULJT.js";
-import {
-  resolveHost
-} from "./chunk-ECBLHAZO.js";
 import {
   CapabilityGatewayError,
   dryRunCapabilityWithEnvelope,
@@ -20,6 +12,14 @@ import {
   listCapabilitiesWithEnvelope,
   validateCapabilityWithEnvelope
 } from "./chunk-QJQZH5GQ.js";
+import {
+  findGatewayDomain,
+  listRegisteredCapabilityDomains,
+  resolveGatewayDomain
+} from "./chunk-TKHSULJT.js";
+import {
+  resolveHost
+} from "./chunk-ECBLHAZO.js";
 import {
   printError,
   printOutput,
@@ -195,7 +195,10 @@ function registerCapability(program) {
     "after",
     "\nExamples:\n  ae-cli capability list --domain analysis\n  ae-cli capability list --domain analysis --project-id 1"
   );
-  capability.command("search").description("Search capability IDs and descriptions in a domain").argument("<query>", "Case-insensitive search terms").requiredOption("--domain <domain>", "Capability namespace, such as analysis or metadata").option("--project-id <project-id>", "Filter by project membership, permissions, and enabled features").action(async (query, opts) => {
+  capability.command("search").description("Search capability IDs and descriptions in a domain").argument("<query>", "Case-insensitive search terms").requiredOption(
+    "--domain <domain>",
+    "Capability namespace. One of: analysis, project, system, tracking, metadata, experiment, engage-flow, engage-task, engage-setting, engage-scene, engage-activity, engage-workbench, community"
+  ).option("--project-id <project-id>", "Filter by project membership, permissions, and enabled features").action(async (query, opts) => {
     await executeAndPrint(program, async (host) => {
       const gatewayDomain = resolveCapabilityListDomain(opts.domain);
       const projectId = parseOptionalProjectId(opts.projectId);
@@ -213,7 +216,7 @@ function registerCapability(program) {
     });
   }).addHelpText(
     "after",
-    '\nExamples:\n  ae-cli capability search "dashboard list" --domain analysis\n  ae-cli capability search "dashboard list" --domain analysis --project-id 1'
+    '\nDomains (--domain):\n  analysis, project, system, tracking, metadata,\n  experiment, engage-flow, engage-task, engage-setting,\n  engage-scene, engage-activity, engage-workbench, community\n\nExamples:\n  ae-cli capability search "dashboard list" --domain analysis\n  ae-cli capability search "dashboard list" --domain analysis --project-id 1\n  ae-cli capability search "info list" --domain project\n  ae-cli capability search "usage" --domain system\n  ae-cli capability search "plan" --domain tracking\n  ae-cli capability search "data_table" --domain metadata\n  ae-cli capability search "report" --domain experiment\n  ae-cli capability search "flow" --domain engage-flow\n  ae-cli capability search "task" --domain engage-task\n  ae-cli capability search "channel" --domain engage-setting\n  ae-cli capability search "strategy" --domain engage-scene\n  ae-cli capability search "topic" --domain engage-activity\n  ae-cli capability search "workbench" --domain engage-workbench\n  ae-cli capability search "post" --domain community'
   );
   capability.command("inspect").description("Inspect one capability schema, risk, auth, and output metadata").argument("<capability-id>", "Capability ID, such as analysis.report.list").option("--domain <domain>", "Override the capability namespace used for gateway routing").option("--project-id <project-id>", "Check availability in a project before returning metadata").action(async (capabilityId, opts) => {
     await executeAndPrint(program, async (host) => {

package/dist/{chunk-6KBBAPPP.js → chunk-JDPEVVHR.js}

@@ -1,12 +1,12 @@
 import { createRequire as __createRequire } from 'node:module'; const require = __createRequire(import.meta.url);
-import {
-  resolveGatewayDomain
-} from "./chunk-TKHSULJT.js";
 import {
   dryRunCapability,
   executeCapabilityWithEnvelope,
   validateCapability
 } from "./chunk-QJQZH5GQ.js";
+import {
+  resolveGatewayDomain
+} from "./chunk-TKHSULJT.js";
 import {
   withOutputMetadata
 } from "./chunk-CZU3V3DQ.js";
@@ -20,6 +20,7 @@ function createCapabilityCommand(config) {
     command: config.command,
     capabilityId: config.capabilityId,
     description: config.description,
+    helpText: config.helpText,
     flags: config.flags,
     risk: config.risk,
     validate: config.validate,

package/dist/index.js

@@ -1,7 +1,4 @@
 import { createRequire as __createRequire } from 'node:module'; const require = __createRequire(import.meta.url);
-import {
-  requiresConfirmation
-} from "./chunk-AMBFK2K3.js";
 import {
   allHeaderNames,
   allSheetNames,
@@ -15,13 +12,13 @@ import {
   validateDraft,
   writeDraftXlsx
 } from "./chunk-LNZBEQXW.js";
-import "./chunk-I4WQAEYB.js";
 import {
   getLocalCliPackageInfo
 } from "./chunk-E2JKXMVO.js";
 import {
-  resolveHost
-} from "./chunk-ECBLHAZO.js";
+  requiresConfirmation
+} from "./chunk-AMBFK2K3.js";
+import "./chunk-I4WQAEYB.js";
 import {
   TeAgentApiError,
   TeAgentCredentialsError
@@ -31,6 +28,9 @@ import {
   executeCapability,
   uploadInputFileBytes
 } from "./chunk-QJQZH5GQ.js";
+import {
+  resolveHost
+} from "./chunk-ECBLHAZO.js";
 import {
   formatCapabilityMissCompatHint,
   printError,
@@ -282,7 +282,7 @@ function capabilityGatewayHint(err) {
 ${compatExtra}` : base;
   }
   if (err.httpStatus === 404 && !err.code) {
-    const base = "The current host returned 404 for this capability route. Do not keep retrying the same command; verify the backend route/capability deployment.";
+    const base = "The current host returned 404 for this capability route. Do not keep retrying the same command; verify the backend route/capability deployment. If --host points directly to a local Common service instead of the deployed gateway, scope AE_CLI_CAPABILITY_GATEWAY_DOMAIN= to this command so it uses /api/cli/v1.";
     return compatExtra ? `${base}
 ${compatExtra}` : base;
   }
@@ -2326,15 +2326,20 @@ program.name("ae-cli").version(version).description("CLI tool for ThinkingAI (AE
 async function loadCommands() {
   const commands = [];
   try {
-    const teAnalysis = await import("./te-analysis-WHYXHRJD.js");
+    const teAnalysis = await import("./te-analysis-TV2YZ4IC.js");
     commands.push(...teAnalysis.default);
   } catch {
   }
   try {
-    const engage = await import("./te-engage-DHKNJ5BO.js");
+    const engage = await import("./te-engage-EUVMTUDJ.js");
     commands.push(...engage.default);
   } catch {
   }
+  try {
+    const experiment = await import("./te-experiment-ESEYE2SK.js");
+    commands.push(...experiment.default);
+  } catch {
+  }
   try {
     const community = await import("./te-community-UDBI672N.js");
     commands.push(...community.default);
@@ -2371,12 +2376,17 @@ async function loadCommands() {
   } catch {
   }
   try {
-    const metadata = await import("./metadata-3J5ZAVMF.js");
+    const metadata = await import("./metadata-SOALPEA7.js");
     commands.push(...metadata.default);
   } catch {
   }
   try {
-    const personalSemanticPreference = await import("./personal-semantic-preference-32AAJ37M.js");
+    const projectSemantic = await import("./project-semantic-RV6NA5LN.js");
+    commands.push(...projectSemantic.default);
+  } catch {
+  }
+  try {
+    const personalSemanticPreference = await import("./personal-semantic-preference-LOF33N5X.js");
     commands.push(...personalSemanticPreference.default);
   } catch {
   }
@@ -2403,14 +2413,14 @@ async function registerConfigCommands() {
 }
 async function registerCapabilityCommands() {
   try {
-    const { registerCapability } = await import("./capability-J4FU4JZW.js");
+    const { registerCapability } = await import("./capability-AXFQW5WM.js");
     registerCapability(program);
   } catch {
   }
 }
 async function registerSyncCommand() {
   try {
-    const { registerSync } = await import("./sync-2GTAKZYX.js");
+    const { registerSync } = await import("./sync-YV3E66IF.js");
     registerSync(program);
   } catch {
   }

package/dist/{metadata-3J5ZAVMF.js → metadata-SOALPEA7.js}

@@ -1,14 +1,14 @@
 import { createRequire as __createRequire } from 'node:module'; const require = __createRequire(import.meta.url);
 import {
   withAsyncArtifactLifecycle
-} from "./chunk-HPLNYQPM.js";
+} from "./chunk-RSG4ONOI.js";
 import {
   createCapabilityCommand
-} from "./chunk-6KBBAPPP.js";
+} from "./chunk-JDPEVVHR.js";
+import "./chunk-QJQZH5GQ.js";
 import {
   registerCapabilityGatewayRoute
 } from "./chunk-TKHSULJT.js";
-import "./chunk-QJQZH5GQ.js";
 import "./chunk-CZU3V3DQ.js";
 import "./chunk-Y74WTIKJ.js";
 import "./chunk-ATSM5XAW.js";

package/dist/{personal-semantic-preference-32AAJ37M.js → personal-semantic-preference-LOF33N5X.js}

@@ -1,11 +1,11 @@
 import { createRequire as __createRequire } from 'node:module'; const require = __createRequire(import.meta.url);
 import {
   createCapabilityCommand
-} from "./chunk-6KBBAPPP.js";
+} from "./chunk-JDPEVVHR.js";
+import "./chunk-QJQZH5GQ.js";
 import {
   registerCapabilityGatewayRoute
 } from "./chunk-TKHSULJT.js";
-import "./chunk-QJQZH5GQ.js";
 import "./chunk-CZU3V3DQ.js";
 import "./chunk-Y74WTIKJ.js";
 import "./chunk-ATSM5XAW.js";