@thinkingai/ae-cli 1.0.1 → 1.0.3

package/dist/te-meta-FMM7KCVI.js

@@ -0,0 +1,479 @@
+import {
+  callMcpTool,
+  parseMcpResult,
+  resolveMcpUrl
+} from "./chunk-53FNNCZW.js";
+import "./chunk-3CDLNXTD.js";
+import "./chunk-EBFUVWIZ.js";
+
+// src/commands/te-meta/shared.ts
+function createMcpCommand(config) {
+  const toolName = config.command.slice(1);
+  const mcpService = config.mcpService || "analysis";
+  return {
+    service: "analysis_meta",
+    command: config.command,
+    description: config.description,
+    flags: config.flags,
+    risk: config.risk,
+    dryRun: (ctx) => ({
+      method: "tools/call",
+      url: resolveMcpUrl(ctx.mcpUrl(), ctx.host(), mcpService),
+      body: {
+        name: toolName,
+        arguments: config.buildArgs(ctx)
+      }
+    }),
+    execute: async (ctx) => {
+      const url = resolveMcpUrl(ctx.mcpUrl(), ctx.host(), mcpService);
+      const result = await callMcpTool(url, toolName, config.buildArgs(ctx), ctx.host());
+      return parseMcpResult(result);
+    }
+  };
+}
+function optionalString(ctx, name) {
+  const value = ctx.str(name);
+  return value === "" ? void 0 : value;
+}
+function optionalNumber(ctx, name) {
+  const value = ctx.str(name);
+  return value === "" ? void 0 : Number(value);
+}
+function optionalBoolean(ctx, name) {
+  const value = ctx.str(name);
+  return value === "" ? void 0 : ctx.bool(name);
+}
+function optionalJson(ctx, name) {
+  const value = ctx.str(name);
+  return value === "" ? void 0 : ctx.json(name);
+}
+function optionalJsonString(ctx, name) {
+  const value = optionalJson(ctx, name);
+  return value === void 0 ? void 0 : JSON.stringify(value);
+}
+function requiredJsonString(ctx, name) {
+  return JSON.stringify(ctx.json(name));
+}
+
+// src/commands/te-meta/meta/list-events.ts
+var listEvents = createMcpCommand({
+  command: "+list_events",
+  description: "Read-only query for effective system event metadata",
+  flags: [
+    { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" },
+    { name: "query", type: "string", required: false, desc: "Optional keyword filter", alias: "q" }
+  ],
+  risk: "read",
+  buildArgs: (ctx) => ({
+    projectId: ctx.num("project_id"),
+    query: optionalString(ctx, "query")
+  })
+});
+
+// src/commands/te-meta/meta/list-properties.ts
+var listProperties = createMcpCommand({
+  command: "+list_properties",
+  description: "Read-only query for effective system property metadata",
+  flags: [
+    { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" },
+    { name: "scope", type: "string", required: false, desc: "Property scope: event or user" },
+    { name: "event_name", type: "string", required: false, desc: "Optional event name filter" },
+    { name: "query", type: "string", required: false, desc: "Optional keyword filter", alias: "q" }
+  ],
+  risk: "read",
+  buildArgs: (ctx) => ({
+    projectId: ctx.num("project_id"),
+    scope: optionalString(ctx, "scope"),
+    eventName: optionalString(ctx, "event_name"),
+    query: optionalString(ctx, "query")
+  })
+});
+
+// src/commands/te-meta/meta/batch-edit-metadata.ts
+var batchEditMetadata = createMcpCommand({
+  command: "+batch_edit_metadata",
+  description: "Batch edit effective system metadata only",
+  flags: [
+    { name: "project_id", type: "number", required: true, alias: "p", desc: "Project ID" },
+    { name: "type", type: "string", required: true, desc: "Metadata type: event, event_property, or user_property" },
+    { name: "items", type: "json", required: true, desc: "Batch edit item list JSON array" }
+  ],
+  risk: "write",
+  mcpService: "te_analysis_extend",
+  buildArgs: (ctx) => ({
+    projectId: ctx.num("project_id"),
+    type: ctx.str("type"),
+    items: ctx.json("items")
+  })
+});
+
+// src/commands/te-meta/meta/batch-create-metadata.ts
+var batchCreateMetadata = createMcpCommand({
+  command: "+batch_create_metadata",
+  description: "Batch create effective system metadata only",
+  flags: [
+    { name: "project_id", type: "number", required: true, alias: "p", desc: "Project ID" },
+    { name: "events", type: "json", required: false, desc: "Event creation list JSON array" },
+    { name: "event_properties", type: "json", required: false, desc: "Event property creation list JSON array" },
+    { name: "user_properties", type: "json", required: false, desc: "User property creation list JSON array" }
+  ],
+  risk: "write",
+  mcpService: "te_analysis_extend",
+  buildArgs: (ctx) => ({
+    projectId: ctx.num("project_id"),
+    events: optionalJson(ctx, "events"),
+    eventProperties: optionalJson(ctx, "event_properties"),
+    userProperties: optionalJson(ctx, "user_properties")
+  })
+});
+
+// src/commands/te-meta/meta/create-virtual-event.ts
+var createVirtualEvent = createMcpCommand({
+  command: "+create_virtual_event",
+  description: "Create a virtual event by combining multiple events with optional filters",
+  flags: [
+    { name: "project_id", type: "number", required: true, alias: "p", desc: "Project ID" },
+    { name: "event_name", type: "string", required: true, desc: "Virtual event name. Must start with 'ta@' and follow the naming constraints in the schema" },
+    { name: "event_desc", type: "string", required: true, desc: "Virtual event description" },
+    { name: "remark", type: "string", required: false, desc: "Optional remark" },
+    { name: "events", type: "json", required: true, desc: "JSON array of events to combine" },
+    { name: "filter", type: "json", required: false, desc: "Optional global filter JSON" },
+    { name: "override", type: "boolean", required: false, desc: "Whether to override if the event already exists. Default: false" }
+  ],
+  risk: "write",
+  mcpService: "te_analysis_extend",
+  buildArgs: (ctx) => ({
+    projectId: ctx.num("project_id"),
+    eventName: ctx.str("event_name"),
+    eventDesc: ctx.str("event_desc"),
+    remark: optionalString(ctx, "remark"),
+    events: requiredJsonString(ctx, "events"),
+    filter: optionalJsonString(ctx, "filter"),
+    override: optionalBoolean(ctx, "override")
+  })
+});
+
+// src/commands/te-meta/meta/create-virtual-property.ts
+var createVirtualProperty = createMcpCommand({
+  command: "+create_virtual_property",
+  description: "Create a SQL-based virtual property",
+  flags: [
+    { name: "project_id", type: "number", required: true, alias: "p", desc: "Project ID" },
+    { name: "property_name", type: "string", required: true, desc: "Property name. Must start with '#vp@' and follow the naming constraints in the schema" },
+    { name: "property_desc", type: "string", required: false, desc: "Display name/description" },
+    { name: "table_type", type: "string", required: true, desc: "Table type: event or user" },
+    { name: "select_type", type: "string", required: true, desc: "Select type: string, number, bool, or datetime" },
+    { name: "sql_expression", type: "string", required: true, desc: "SQL expression for computing the property" },
+    { name: "sql_event_relation_type", type: "string", required: true, desc: "SQL event relation type: relation_default, relation_always, or relation_by_setting" },
+    { name: "related_events", type: "json", required: false, desc: "Optional related events JSON array. Required when sql_event_relation_type is relation_by_setting" },
+    { name: "property_remark", type: "string", required: false, desc: "Optional property remark" }
+  ],
+  risk: "write",
+  mcpService: "te_analysis_extend",
+  buildArgs: (ctx) => ({
+    projectId: ctx.num("project_id"),
+    propertyName: ctx.str("property_name"),
+    propertyDesc: optionalString(ctx, "property_desc"),
+    tableType: ctx.str("table_type"),
+    selectType: ctx.str("select_type"),
+    sqlExpression: ctx.str("sql_expression"),
+    sqlEventRelationType: ctx.str("sql_event_relation_type"),
+    relatedEvents: optionalJsonString(ctx, "related_events"),
+    propertyRemark: optionalString(ctx, "property_remark")
+  })
+});
+
+// src/commands/te-meta/meta/list-metrics.ts
+var listMetrics = createMcpCommand({
+  command: "+list_metrics",
+  description: "List metric metadata in the project",
+  flags: [
+    { name: "project_id", type: "number", required: true, alias: "p", desc: "Project ID" },
+    { name: "query", type: "string", required: false, alias: "q", desc: "Optional keyword filter" }
+  ],
+  risk: "read",
+  mcpService: "te_analysis_extend",
+  buildArgs: (ctx) => ({
+    projectId: ctx.num("project_id"),
+    query: optionalString(ctx, "query")
+  })
+});
+
+// src/commands/te-meta/meta/get-metric.ts
+var getMetric = createMcpCommand({
+  command: "+get_metric",
+  description: "Get the definition details of a single metric",
+  flags: [
+    { name: "project_id", type: "number", required: true, alias: "p", desc: "Project ID" },
+    { name: "metric_id", type: "number", required: true, alias: "m", desc: "Metric ID" }
+  ],
+  risk: "read",
+  mcpService: "te_analysis_extend",
+  buildArgs: (ctx) => ({
+    projectId: ctx.num("project_id"),
+    metricId: ctx.num("metric_id")
+  })
+});
+
+// src/commands/te-meta/meta/create-metric.ts
+var createMetric = createMcpCommand({
+  command: "+create_metric",
+  description: "Create a metric from analysis configuration",
+  flags: [
+    { name: "project_id", type: "number", required: true, alias: "p", desc: "Project ID" },
+    { name: "name", type: "string", required: true, desc: "Metric name. Must start with a lowercase letter and contain only lowercase letters, digits, and underscores. Maximum length: 80." },
+    { name: "display_name", type: "string", required: true, desc: "Metric display name" },
+    { name: "remark", type: "string", required: false, desc: "Optional metric remark" },
+    { name: "model_type", type: "string", required: true, desc: "Metric model type: event or retention" },
+    { name: "events", type: "json", required: true, desc: "Metric events JSON. Use get_analysis_query_schema first to obtain the schema." },
+    { name: "params", type: "json", required: true, desc: "Metric parameters JSON. For event, use format config; for retention, use the eventView configuration." }
+  ],
+  risk: "write",
+  mcpService: "te_analysis_extend",
+  buildArgs: (ctx) => ({
+    projectId: ctx.num("project_id"),
+    name: ctx.str("name"),
+    displayName: ctx.str("display_name"),
+    remark: optionalString(ctx, "remark"),
+    modelType: ctx.str("model_type"),
+    events: requiredJsonString(ctx, "events"),
+    params: requiredJsonString(ctx, "params")
+  })
+});
+
+// src/commands/te-meta/meta/update-metric.ts
+var updateMetric = createMcpCommand({
+  command: "+update_metric",
+  description: "Update a metric definition",
+  flags: [
+    { name: "project_id", type: "number", required: true, alias: "p", desc: "Project ID" },
+    { name: "metric_id", type: "number", required: true, alias: "m", desc: "Metric ID" },
+    { name: "name", type: "string", required: true, desc: "Metric name. Must start with a lowercase letter and contain only lowercase letters, digits, and underscores. Maximum length: 80." },
+    { name: "display_name", type: "string", required: true, desc: "Metric display name" },
+    { name: "remark", type: "string", required: false, desc: "Optional metric remark" },
+    { name: "model_type", type: "string", required: true, desc: "Metric model type: event or retention" },
+    { name: "events", type: "json", required: true, desc: "Metric event definition JSON" },
+    { name: "params", type: "json", required: false, desc: "Metric parameter definition JSON" }
+  ],
+  risk: "write",
+  mcpService: "te_analysis_extend",
+  buildArgs: (ctx) => ({
+    projectId: ctx.num("project_id"),
+    metricId: ctx.num("metric_id"),
+    name: ctx.str("name"),
+    displayName: ctx.str("display_name"),
+    remark: optionalString(ctx, "remark"),
+    modelType: ctx.str("model_type"),
+    events: requiredJsonString(ctx, "events"),
+    params: optionalJsonString(ctx, "params")
+  })
+});
+
+// src/commands/te-meta/meta/index.ts
+var commands = [
+  listEvents,
+  listProperties,
+  batchEditMetadata,
+  batchCreateMetadata,
+  createVirtualEvent,
+  createVirtualProperty,
+  listMetrics,
+  getMetric,
+  createMetric,
+  updateMetric
+];
+var meta_default = commands;
+
+// src/commands/te-meta/project/get-project-config.ts
+var getProjectConfig = createMcpCommand({
+  command: "+get_project_config",
+  description: "Get project configuration details including timezone settings",
+  flags: [
+    { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" }
+  ],
+  risk: "read",
+  buildArgs: (ctx) => ({
+    projectId: ctx.num("project_id")
+  })
+});
+
+// src/commands/te-meta/project/list-project-users.ts
+var listProjectUsers = createMcpCommand({
+  command: "+list_project_users",
+  description: "Get all project members",
+  flags: [
+    { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" }
+  ],
+  risk: "read",
+  buildArgs: (ctx) => ({
+    projectId: ctx.num("project_id")
+  })
+});
+
+// src/commands/te-meta/project/get-track-program.ts
+var getTrackProgram = createMcpCommand({
+  command: "+get_track_program",
+  description: "Query tracking-plan metadata (bury program)",
+  flags: [
+    { name: "project_id", type: "number", required: true, alias: "p", desc: "Project ID" }
+  ],
+  risk: "read",
+  mcpService: "te_analysis_extend",
+  buildArgs: (ctx) => ({
+    projectId: ctx.num("project_id")
+  })
+});
+
+// src/commands/te-meta/project/save-track-items.ts
+var saveTrackItems = createMcpCommand({
+  command: "+save_track_items",
+  description: "Create or update tracking-plan metadata only",
+  flags: [
+    { name: "project_id", type: "number", required: true, alias: "p", desc: "Project ID" },
+    { name: "track_data", type: "json", required: true, desc: "Track program JSON object with events/eventProps/userProps/commonEventProps" }
+  ],
+  risk: "write",
+  mcpService: "te_analysis_extend",
+  buildArgs: (ctx) => ({
+    projectId: ctx.num("project_id"),
+    trackData: requiredJsonString(ctx, "track_data")
+  })
+});
+
+// src/commands/te-meta/project/delete-track-items.ts
+var deleteTrackItems = createMcpCommand({
+  command: "+delete_track_items",
+  description: "Delete tracking-plan metadata items only",
+  flags: [
+    { name: "project_id", type: "number", required: true, alias: "p", desc: "Project ID" },
+    { name: "delete_data", type: "json", required: true, desc: "Delete payload JSON object with events/eventPropNames/userPropNames/commonEventPropNames" }
+  ],
+  risk: "write",
+  mcpService: "te_analysis_extend",
+  buildArgs: (ctx) => ({
+    projectId: ctx.num("project_id"),
+    deleteData: requiredJsonString(ctx, "delete_data")
+  })
+});
+
+// src/commands/te-meta/project/create-project-mark-time.ts
+var createProjectMarkTime = createMcpCommand({
+  command: "+create_project_mark_time",
+  description: "Create a project date marker",
+  flags: [
+    { name: "project_id", type: "number", required: true, alias: "p", desc: "Project ID" },
+    { name: "marked_at", type: "string", required: true, desc: "Marked time yyyy-MM-dd HH:mm" },
+    { name: "zone_offset", type: "number", required: false, desc: "Marker time zone offset" },
+    { name: "content", type: "string", required: true, desc: "Marker content" },
+    { name: "is_visible", type: "number", required: false, desc: "Whether the marker is visible. Default: 1" }
+  ],
+  risk: "write",
+  mcpService: "te_analysis_extend",
+  buildArgs: (ctx) => ({
+    projectId: ctx.num("project_id"),
+    markedAt: ctx.str("marked_at"),
+    zoneOffset: optionalNumber(ctx, "zone_offset"),
+    content: ctx.str("content"),
+    isVisible: optionalNumber(ctx, "is_visible")
+  })
+});
+
+// src/commands/te-meta/project/update-project-mark-time.ts
+var updateProjectMarkTime = createMcpCommand({
+  command: "+update_project_mark_time",
+  description: "Update an existing project date marker",
+  flags: [
+    { name: "mark_time_id", type: "number", required: true, desc: "Mark time ID" },
+    { name: "project_id", type: "number", required: true, alias: "p", desc: "Project ID" },
+    { name: "marked_at", type: "string", required: true, desc: "Marked time yyyy-MM-dd HH:mm" },
+    { name: "zone_offset", type: "number", required: false, desc: "Marker time zone offset" },
+    { name: "content", type: "string", required: true, desc: "Marker content" },
+    { name: "is_visible", type: "number", required: false, desc: "Whether the marker is visible. Default: 1" }
+  ],
+  risk: "write",
+  mcpService: "te_analysis_extend",
+  buildArgs: (ctx) => ({
+    markTimeId: ctx.num("mark_time_id"),
+    projectId: ctx.num("project_id"),
+    markedAt: ctx.str("marked_at"),
+    zoneOffset: optionalNumber(ctx, "zone_offset"),
+    content: ctx.str("content"),
+    isVisible: optionalNumber(ctx, "is_visible")
+  })
+});
+
+// src/commands/te-meta/project/list-project-mark-times.ts
+var listProjectMarkTimes = createMcpCommand({
+  command: "+list_project_mark_times",
+  description: "List project date markers",
+  flags: [
+    { name: "project_id", type: "number", required: true, alias: "p", desc: "Project ID" },
+    { name: "zone_offset", type: "number", required: false, desc: "Marker time zone offset" }
+  ],
+  risk: "read",
+  mcpService: "te_analysis_extend",
+  buildArgs: (ctx) => ({
+    projectId: ctx.num("project_id"),
+    zoneOffset: optionalNumber(ctx, "zone_offset")
+  })
+});
+
+// src/commands/te-meta/project/delete-project-mark-times.ts
+var deleteProjectMarkTimes = createMcpCommand({
+  command: "+delete_project_mark_times",
+  description: "Delete one or more project date markers",
+  flags: [
+    { name: "project_id", type: "number", required: true, alias: "p", desc: "Project ID" },
+    { name: "mark_time_ids", type: "json", required: true, desc: "Marker ID list JSON array" }
+  ],
+  risk: "write",
+  mcpService: "te_analysis_extend",
+  buildArgs: (ctx) => ({
+    projectId: ctx.num("project_id"),
+    markTimeIds: ctx.json("mark_time_ids")
+  })
+});
+
+// src/commands/te-meta/project/index.ts
+var commands2 = [
+  getProjectConfig,
+  listProjectUsers,
+  getTrackProgram,
+  saveTrackItems,
+  deleteTrackItems,
+  createProjectMarkTime,
+  updateProjectMarkTime,
+  listProjectMarkTimes,
+  deleteProjectMarkTimes
+];
+var project_default = commands2;
+
+// src/commands/te-meta/entity/list-entities.ts
+var listEntities = createMcpCommand({
+  command: "+list_entities",
+  description: "List entities in the project",
+  flags: [
+    { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" },
+    { name: "event_name", type: "string", required: false, desc: "Optional event name filter" }
+  ],
+  risk: "read",
+  buildArgs: (ctx) => ({
+    projectId: ctx.num("project_id"),
+    eventName: optionalString(ctx, "event_name")
+  })
+});
+
+// src/commands/te-meta/entity/index.ts
+var commands3 = [listEntities];
+var entity_default = commands3;
+
+// src/commands/te-meta/index.ts
+var commands4 = [
+  ...meta_default,
+  ...project_default,
+  ...entity_default
+];
+var te_meta_default = commands4;
+export {
+  te_meta_default as default
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thinkingai/ae-cli",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "CLI tool for ThinkingAI AgenticEngine (AE) analytics platform",
   "type": "module",
   "bin": {
@@ -16,10 +16,10 @@
   "scripts": {
     "dev": "tsx src/index.ts",
     "build": "tsup src/index.ts --format esm --outDir dist",
-    "verify:te-analysis-tools": "node scripts/verify-te-analysis-tools.mjs",
-    "verify:te-audience-tools": "node scripts/verify-te-audience-tools.mjs",
-    "verify:te-meta-tools": "node scripts/verify-te-meta-tools.mjs",
-    "verify:te-common-tools": "node scripts/verify-te-common-tools.mjs",
+    "verify:analysis-tools": "node scripts/verify-te-analysis-tools.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",
     "prepublishOnly": "npm run build",
     "start": "node dist/index.js",
     "test": "npx tsx src/index.ts --help"
@@ -39,8 +39,10 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
+    "@types/json-bigint": "^1.0.4",
     "cli-table3": "^0.6.5",
     "commander": "^12.1.0",
+    "json-bigint": "^1.0.0",
     "ws": "^8.18.0"
   },
   "devDependencies": {

package/skills/te-analysis/SKILL.md

@@ -5,13 +5,13 @@ description: "TE analysis query and visualization: report (report) and dashboard
 metadata:
   requires:
     bins: ["ae-cli"]
-  cliHelp: "ae-cli te_analysis --help"
+  cliHelp: "ae-cli analysis --help"
 ---
 
 # te-analysis
 
 > **CRITICAL - Before starting, you MUST first read [`../te-shared/SKILL.md`](../te-shared/SKILL.md)**: authentication, host configuration, global parameters, and write-operation confirmation rules are all documented there.
-> **CRITICAL - For write operations marked with ⚠️, after a successful execution you MUST first read and follow the "post-write link completion" constraint in [`../te-common/SKILL.md`](../te-common/SKILL.md). You MUST call `te_common +get_resource_url` to complete the link-completion loop.**
+> **CRITICAL - For write operations marked with ⚠️, after a successful execution you MUST first read and follow the "post-write link completion" constraint in [`../te-common/SKILL.md`](../te-common/SKILL.md). You MUST call `analysis_common +get_resource_url` to complete the link-completion loop.**
 > **CRITICAL - For all commands that require `project_id`, you MUST follow `te-common`'s `PROJECT_ID_GATE` (stop if missing and confirm with the user).**
 > **CRITICAL - Before running any `+<tool_name>` command, you MUST first read the corresponding reference document `./references/<tool-name>.md`.** For example: before running `+get_analysis_query_schema`, you must first read [`./references/get-analysis-query-schema.md`](./references/get-analysis-query-schema.md)
 
@@ -44,7 +44,7 @@ When the user requests the following, switch to the corresponding skill:
 
 ## Parameters and Conventions
 
-- Command format: `ae-cli te_analysis +<tool_name> [options]`
+- Command format: `ae-cli analysis +<tool_name> [options]`
 - CLI flags use underscores: `--project_id`
 - MCP parameters map automatically to camelCase: `projectId`
 - Pass JSON parameters directly as JSON strings: `'{}'`, `'[1,2]'`
@@ -60,15 +60,15 @@ When the user requests the following, switch to the corresponding skill:
 - `+update_alert` ([doc](./references/update-alert.md))
 
 ### Reports and Dashboards (13)
-- `+create_report` ([doc](./references/create-report.md)) ⚠️ write operation, after it succeeds you MUST call `te_common +get_resource_url` to complete the link-completion loop
+- `+create_report` ([doc](./references/create-report.md)) ⚠️ write operation, after it succeeds you MUST call `analysis_common +get_resource_url` to complete the link-completion loop
 - `+get_report_definition` ([doc](./references/get-report-definition.md))
 - `+list_reports` ([doc](./references/list-reports.md))
 - `+query_report_data` ([doc](./references/query-report-data.md))
-- `+create_dashboard` ([doc](./references/create-dashboard.md)) ⚠️ write operation, after it succeeds you MUST call `te_common +get_resource_url` to complete the link-completion loop
+- `+create_dashboard` ([doc](./references/create-dashboard.md)) ⚠️ write operation, after it succeeds you MUST call `analysis_common +get_resource_url` to complete the link-completion loop
 - `+list_dashboards` ([doc](./references/list-dashboards.md))
 - `+query_dashboard_detail` ([doc](./references/query-dashboard-detail.md))
 - `+query_dashboard_report_data` ([doc](./references/query-dashboard-report-data.md))
-- `+update_dashboard` ([doc](./references/update-dashboard.md)) ⚠️ write operation, after it succeeds you MUST call `te_common +get_resource_url` to complete the link-completion loop
+- `+update_dashboard` ([doc](./references/update-dashboard.md)) ⚠️ write operation, after it succeeds you MUST call `analysis_common +get_resource_url` to complete the link-completion loop
 - `+create_or_update_dashboard_note` ([doc](./references/create-or-update-dashboard-note.md))
 - `+list_public_access_links` ([doc](./references/list-public-access-links.md))
 - `+create_public_access_link` ([doc](./references/create-public-access-link.md))
@@ -78,7 +78,7 @@ When the user requests the following, switch to the corresponding skill:
 - `+query_adhoc` ([doc](./references/query-adhoc.md))
 - `+drilldown_users` ([doc](./references/drilldown-users.md))
 - `+drilldown_user_events` ([doc](./references/drilldown-user-events.md))
-- `+create_result_cluster` ([doc](./references/create-result-cluster.md)) ⚠️ write operation, after it succeeds you MUST call `te_common +get_resource_url` to complete the link-completion loop
+- `+create_result_cluster` ([doc](./references/create-result-cluster.md)) ⚠️ write operation, after it succeeds you MUST call `analysis_common +get_resource_url` to complete the link-completion loop
 - `+load_filters` ([doc](./references/load-filters.md))
 - `+get_table_columns` ([doc](./references/get-table-columns.md))
 
@@ -96,10 +96,10 @@ When the user requests the following, switch to the corresponding skill:
 ## Quick Verification
 
 ```bash
-ae-cli te_analysis --help
-npm run verify:te-analysis-tools
+ae-cli analysis --help
+npm run verify:analysis-tools
 # Example: use dry-run to preview the request (replace project_id with your actual project ID)
-ae-cli te_analysis +query_adhoc --project_id <YOUR_PROJECT_ID> --model_type event --qp "{}" --dry-run
+ae-cli analysis +query_adhoc --project_id <YOUR_PROJECT_ID> --model_type event --qp "{}" --dry-run
 ```
 
 ## Reference Docs

package/skills/te-analysis/references/build-entity-details-sql.md

@@ -1,4 +1,4 @@
-# te_analysis +build_entity_details_sql (Generate Entity Details SQL)
+# analysis +build_entity_details_sql (Generate Entity Details SQL)
 
 > **Prerequisite:** Read [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
 
@@ -18,16 +18,16 @@ Domain: **Entity details SQL queries**
 
 ## Prerequisite call chain (required for constructing definition/properties)
 1. First confirm the cluster type (condition / sql).
-2. Read `get-cluster-definition-schema.md`, then call `te-cli te_audience +get_cluster_definition_schema --cluster_type <condition|sql>` to get the structure.
-3. Read `list-events.md`, then call `te-cli te_meta +list_events --project_id 1`.
-4. Read `list-properties.md`, then call `te-cli te_meta +list_properties --project_id 1`.
+2. Read `get-cluster-definition-schema.md`, then call `ae-cli analysis_audience +get_cluster_definition_schema --cluster_type <condition|sql>` to get the structure.
+3. Read `list-events.md`, then call `ae-cli analysis_meta +list_events --project_id 1`.
+4. Read `list-properties.md`, then call `ae-cli analysis_meta +list_properties --project_id 1`.
 5. Build `definition` (and optional `properties`) from the schema + metadata, then call `+build_entity_details_sql`.
 
 ## Command
 ```bash
-te-cli te_analysis +build_entity_details_sql --project_id 1 --definition '{}'
-te-cli te_analysis +build_entity_details_sql --project_id 1 --entity_id 1001 --definition '{}' --properties '{}' --sort_by time --sort_order desc --limit 100 --zone_offset 8
-te-cli te_analysis +build_entity_details_sql --dry-run
+ae-cli analysis +build_entity_details_sql --project_id 1 --definition '{}'
+ae-cli analysis +build_entity_details_sql --project_id 1 --entity_id 1001 --definition '{}' --properties '{}' --sort_by time --sort_order desc --limit 100 --zone_offset 8
+ae-cli analysis +build_entity_details_sql --dry-run
 ```
 
 ## Parameters
@@ -35,8 +35,8 @@ te-cli te_analysis +build_entity_details_sql --dry-run
 |---|---|---|
 | `--project_id` / `-p` | Yes | Project ID |
 | `--entity_id` | No | Optional entity ID used in multi-entity scenarios. If omitted, the default user entity is used. |
-| `--definition` | Yes | Cluster definition JSON. MUST call `+get_cluster_definition_schema` first, then fill valid event/property names from `te_meta +list_events` / `te_meta +list_properties` in the same `project_id`. |
-| `--properties` | No | Optional display properties JSON, for example `[{"columnName":"#user_id","tableType":"0"},{"columnName":"device_id","tableType":"0"}]`. If provided, property names should come from `te_meta +list_properties` in the same `project_id`. |
+| `--definition` | Yes | Cluster definition JSON. MUST call `+get_cluster_definition_schema` first, then fill valid event/property names from `analysis_meta +list_events` / `analysis_meta +list_properties` in the same `project_id`. |
+| `--properties` | No | Optional display properties JSON, for example `[{"columnName":"#user_id","tableType":"0"},{"columnName":"device_id","tableType":"0"}]`. If provided, property names should come from `analysis_meta +list_properties` in the same `project_id`. |
 | `--sort_by` | No | Optional sort field |
 | `--sort_order` | No | Optional sort order. Supported values: asc and desc |
 | `--limit` | No | Optional result limit. Default: 1000, maximum: 10000 |
@@ -54,5 +54,5 @@ te-cli te_analysis +build_entity_details_sql --dry-run
 - If `Invalid JSON` appears, first check the schema required fields, then verify whether the event/property names come from metadata query results for the same `project_id`.
 
 ## Recommended chaining
-- +get_cluster_definition_schema -> te_meta +list_events -> te_meta +list_properties -> +build_entity_details_sql
+- +get_cluster_definition_schema -> analysis_meta +list_events -> analysis_meta +list_properties -> +build_entity_details_sql
 - +query_entity_details -> +query_event_details -> +build_event_details_sql