@thinkingai/ae-cli 1.0.1

package/dist/te-meta-HGYNXVGF.js

@@ -0,0 +1,479 @@
+import {
+  callMcpTool,
+  parseMcpResult,
+  resolveMcpUrl
+} from "./chunk-JD5DXMKL.js";
+import "./chunk-RJNLN3KQ.js";
+import "./chunk-OVQOK35G.js";
+
+// src/commands/te-meta/shared.ts
+function createMcpCommand(config) {
+  const toolName = config.command.slice(1);
+  const mcpService = config.mcpService || "te_analysis";
+  return {
+    service: "te_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

@@ -0,0 +1,53 @@
+{
+  "name": "@thinkingai/ae-cli",
+  "version": "1.0.1",
+  "description": "CLI tool for ThinkingAI AgenticEngine (AE) analytics platform",
+  "type": "module",
+  "bin": {
+    "ae-cli": "bin/ae-cli.js"
+  },
+  "main": "dist/index.js",
+  "files": [
+    "bin/",
+    "dist/",
+    "skills/",
+    "README.md"
+  ],
+  "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",
+    "prepublishOnly": "npm run build",
+    "start": "node dist/index.js",
+    "test": "npx tsx src/index.ts --help"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ThinkingAIAgenticEngine/ae-cli.git"
+  },
+  "keywords": [
+    "thinkingengine",
+    "analytics",
+    "cli"
+  ],
+  "author": "ThinkingAI",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "cli-table3": "^0.6.5",
+    "commander": "^12.1.0",
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/ws": "^8.5.0",
+    "tsup": "^8.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.5.0"
+  }
+}

package/skills/te-analysis/SKILL.md

@@ -0,0 +1,107 @@
+---
+name: te-analysis
+version: 2.0.0
+description: "TE analysis query and visualization: report (report) and dashboard (dashboard) creation/query, ad-hoc model analysis, user drilldown, alert configuration, entity/event detail queries, analysis SQL, and filter/group-by schemas. Covers event analysis, retention analysis, funnel analysis, SQL analysis, user property analysis, distribution analysis, interval analysis, path analysis, and attribution analysis. Triggers when users mention check data/analyze data/view trends/view conversion funnels/view retention/run path attribution/write analysis SQL/drill into user behavior/edit reports and dashboards/configure alerts."
+metadata:
+  requires:
+    bins: ["ae-cli"]
+  cliHelp: "ae-cli te_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 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)
+
+## When to Use
+
+When a user needs TE for analysis queries, drilldown details, report/dashboard management, or alert configuration, use `te-analysis`.
+
+It applies to requests such as viewing data, analyzing data, checking details, creating reports, and configuring alerts. If the request is for audiences/tags, tracking plans, or project configuration, switch to another skill.
+
+- Alerts: view alert definitions, list alerts, get a single alert, create alerts, or update alerts.
+  Common commands: `+get_alert_definition_schema`, `+list_alerts`, `+get_alert`, `+create_alert`, `+update_alert`
+- Reports and dashboards: create or query reports, inspect dashboard structure and data, update dashboards, and manage public links and remarks.
+  Common commands: `+create_report`, `+query_report_data`, `+create_dashboard`, `+query_dashboard_detail`, `+update_dashboard`
+- Model analysis: run event analysis, retention analysis, funnel analysis, SQL analysis, user property analysis, distribution analysis, interval analysis, path analysis, attribution analysis, heat map, and ranking-list ad-hoc analysis, and support user drilldown and result clustering.
+  Common commands: `+query_adhoc`, `+drilldown_users`, `+drilldown_user_events`, `+create_result_cluster`
+- Entities and events: query entity details, event details, or generate the corresponding detail SQL.
+  Common commands: `+query_entity_details`, `+query_event_details`, `+build_entity_details_sql`, `+build_event_details_sql`
+- Analysis schema and helpers: get analysis query, filter, and groupby schemas, load available filter conditions, and inspect table columns.
+  Common commands: `+get_analysis_query_schema`, `+get_filter_schema`, `+get_groupby_schema`, `+load_filters`, `+get_table_columns`
+
+## When to Switch to Other Skills
+
+When the user requests the following, switch to the corresponding skill:
+
+| User Intent | Use |
+|---------|--------|
+| Create/query clusters, tags, or cluster schemas | `te-audience` |
+| Manage tracking plans, project configuration, or entity lists | `te-meta` |
+| Ops task flows, processes, or channels | `te-operation` |
+
+## Parameters and Conventions
+
+- Command format: `ae-cli te_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]'`
+- Write operations prompt for confirmation; use `--yes` to skip it.
+
+## Tool Groups (31)
+
+### Alerts (5)
+- `+get_alert_definition_schema` ([doc](./references/get-alert-definition-schema.md))
+- `+list_alerts` ([doc](./references/list-alerts.md))
+- `+get_alert` ([doc](./references/get-alert.md))
+- `+create_alert` ([doc](./references/create-alert.md))
+- `+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
+- `+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
+- `+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
+- `+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))
+- `+update_public_access_link` ([doc](./references/update-public-access-link.md))
+
+### Model Analysis (6)
+- `+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
+- `+load_filters` ([doc](./references/load-filters.md))
+- `+get_table_columns` ([doc](./references/get-table-columns.md))
+
+### Entity Details / Event Details
+- `+query_entity_details` ([doc](./references/query-entity-details.md))
+- `+query_event_details` ([doc](./references/query-event-details.md))
+- `+build_entity_details_sql` ([doc](./references/build-entity-details-sql.md))
+- `+build_event_details_sql` ([doc](./references/build-event-details-sql.md))
+
+### Schema (8)
+- `+get_analysis_query_schema` ([doc](./references/get-analysis-query-schema.md))
+- `+get_filter_schema` ([doc](./references/get-filter-schema.md))
+- `+get_groupby_schema` ([doc](./references/get-groupby-schema.md))
+
+## Quick Verification
+
+```bash
+ae-cli te_analysis --help
+npm run verify:te-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
+```
+
+## Reference Docs
+
+See the `references/` directory (31 per-command docs in total).