@thinkingai/ae-cli 1.0.3 → 1.0.18

package/dist/te-meta-HGYNXVGF.js

@@ -1,479 +0,0 @@
-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/skills/te-analysis/SKILL.md

@@ -1,107 +0,0 @@
----
-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 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 `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)
-
-## 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 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 `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 `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 `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))
-- `+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 `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))
-
-### 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 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 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).

package/skills/te-analysis/references/get-analysis-query-schema.md

@@ -1,36 +0,0 @@
-# analysis +get_analysis_query_schema (Get Analysis Query Schema)
-
-> **Prerequisite:** Read [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
-
-Domain: **Model schema queries**
-
-- This is the documentation for the `+get_analysis_query_schema` command; read it before running `ae-cli analysis +get_analysis_query_schema`.
-- Get the query schema for the specified analysis model type. Different model types use different schema structures. This tool returns field definitions and examples.
-
-## Use Cases
-- Helper tool positioning: this command provides structural definitions (schema) and should be used as a prerequisite step.
-- Recommended order: first use the current schema tool to get the structure, then call the specific business tool.
-- Typical follow-up tools: `+create_metric`, `+create_report`, `+drilldown_users`, `+get_cluster_definition_schema`, `+get_filter_schema`, `+get_groupby_schema`, `+get_tag_definition_schema`, `+query_adhoc`
-- Get the analysis query schema for the specified model type. Different model types use different query structures. This tool returns field definitions and examples. Supported model types: event, retention, funnel, distribution, sql, interval, path, attribution, prop_analysis, rank_list, heat_map.
-- Get the analysis query schema for the specified model type.
-
-## Command
-```bash
-ae-cli analysis +get_analysis_query_schema --model_type event
-ae-cli analysis +get_analysis_query_schema --model_type event --dry-run
-```
-
-## Parameters
-| Parameter | Required | Description |
-|---|---|---|
-| `--model_type` | Yes | Model type. Supported values: event, retention, funnel, distribution, sql, interval, path, attribution, prop_analysis, rank_list, heat_map |
-
-## Decision Rules
-- It is recommended to run `--dry-run` first to inspect the request body mapping before making the formal call.
-
-## Next Steps on Failure
-- If reading fails, first verify whether the object ID exists and belongs to the current project.
-- If the schema does not match expectations, confirm whether the correct schema interface was called (filter/groupby/query/tag/cluster).
-
-## Recommended chaining
-- +get_analysis_query_schema -> +get_filter_schema -> +get_groupby_schema

package/skills/te-analysis/references/list-public-access-links.md

@@ -1,31 +0,0 @@
-# analysis +list_public_access_links (public link search)
-
-> **Prerequisite:** Read [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
-
-Domain: **Dashboard Management**
-
-## Use Cases
-- List public access links in the project. Returns link IDs, short codes, access targets, status, effective time, expiration time, and related metadata.
-- List public access links in the project.
-
-## Commands
-```bash
-ae-cli analysis +list_public_access_links --project_id 1
-ae-cli analysis +list_public_access_links --dry-run
-```
-
-## Parameters
-| Parameter | Required | Description |
-|---|---|---|
-| `--project_id` / `-p` | Yes | Project ID |
-
-## Decision Rules
-- For the first run, it is recommended to pass only the required parameters (`--project_id`) and add optional parameters after confirming the chain works.
-- For cross-project troubleshooting, first confirm whether `--project_id` matches the current permissions and target environment.
-
-## Next Step After Failure
-- If required parameters are missing, fall back to the smallest runnable command and fill them in (focus on `--project_id`).
-- If the result is empty, first confirm the project ID/keyword, then try broadening the filter conditions.
-
-## Recommended Chaining
-- +list_public_access_links -> +update_public_access_link