@zhoujinandrew/te-cli 1.0.0 → 1.0.2

package/README.md

@@ -4,14 +4,25 @@ CLI tool for ThinkingEngine (TE) analytics platform. Designed for both AI Agent
 
 ## Installation
 
+**Step 1: Install te-cli**
+
 ```bash
 npm install -g @zhoujinandrew/te-cli
 ```
 
-To update to the latest version:
+**Step 2: Install AI Agent Skills**
+
+```bash
+npx skills add zjandrew/te-cli -g -y
+```
+
+This installs 5 skill packages into your AI coding agent (Claude Code, Trae, Cursor, etc.), enabling the agent to understand and call te-cli commands.
+
+To update:
 
 ```bash
 npm update -g @zhoujinandrew/te-cli
+npx skills add zjandrew/te-cli -g -y
 ```
 
 ## Quick Start
@@ -90,6 +101,24 @@ te-cli auth logout
 | `--dry-run` | Preview request | false |
 | `--yes` | Skip confirmation | false |
 
+## Skills
+
+5 AI Agent skill packages are included in the `skills/` directory:
+
+| Skill | Description |
+|-------|-------------|
+| `te-shared` | Authentication, configuration, global options |
+| `te-meta` | Metadata: events, properties, entities, metrics, tables |
+| `te-analysis` | Reports, dashboards, SQL queries, report data |
+| `te-audience` | Tags, clusters, audience events/properties |
+| `te-operation` | Tasks, flows, channels, space navigation |
+
+Install them with:
+
+```bash
+npx skills add zjandrew/te-cli -g -y
+```
+
 ## Development
 
 ```bash
@@ -98,12 +127,3 @@ cd te-cli
 npm install
 npx tsx src/index.ts --help
 ```
-
-## Skills
-
-AI Agent skill documentation is in the `skills/` directory:
-- `te-shared` — Authentication, configuration, global options
-- `te-meta` — Metadata queries
-- `te-analysis` — Analysis and reporting
-- `te-audience` — Audience management
-- `te-operation` — Operations management

package/dist/analysis-GWLVZ2YM.js

@@ -0,0 +1,218 @@
+// src/commands/analysis/list-reports.ts
+var listReports = {
+  service: "analysis",
+  command: "+list-reports",
+  description: "List all analysis reports for a project",
+  flags: [
+    { name: "project-id", type: "number", required: true, alias: "p", desc: "Project ID" }
+  ],
+  risk: "read",
+  execute: async (ctx) => {
+    return ctx.api("POST", "/v1/ta/event/listAll", {
+      projectId: ctx.num("project-id")
+    });
+  }
+};
+
+// src/commands/analysis/get-report.ts
+var getReport = {
+  service: "analysis",
+  command: "+get-report",
+  description: "Get full report definition by ID",
+  flags: [
+    { name: "project-id", type: "number", required: true, alias: "p", desc: "Project ID" },
+    { name: "report-id", type: "number", required: true, desc: "Report ID" }
+  ],
+  risk: "read",
+  execute: async (ctx) => {
+    return ctx.api("GET", "/v1/ta/event/reportsearch", {
+      projectId: ctx.num("project-id"),
+      reportId: ctx.num("report-id")
+    });
+  }
+};
+
+// src/commands/analysis/save-report.ts
+var saveReport = {
+  service: "analysis",
+  command: "+save-report",
+  description: "Save (create/update) an analysis report",
+  flags: [
+    { name: "project-id", type: "number", required: true, alias: "p", desc: "Project ID" },
+    { name: "report-name", type: "string", required: true, desc: "Report name" },
+    { name: "report-model", type: "number", required: true, desc: "0=Event, 1=Retention, 2=Funnel, 10=Distribution" },
+    { name: "events", type: "json", required: true, desc: "Events configuration array" },
+    { name: "event-view", type: "json", required: true, desc: "Event view configuration" }
+  ],
+  risk: "write",
+  execute: async (ctx) => {
+    return ctx.api("POST", "/v1/ta/event/reportsave", {
+      projectId: ctx.num("project-id")
+    }, {
+      reportName: ctx.str("report-name"),
+      reportModel: ctx.num("report-model"),
+      events: ctx.json("events"),
+      eventView: ctx.json("event-view")
+    });
+  }
+};
+
+// src/commands/analysis/list-dashboards.ts
+var listDashboards = {
+  service: "analysis",
+  command: "+list-dashboards",
+  description: "List all dashboards for a project",
+  flags: [
+    { name: "project-id", type: "number", required: true, alias: "p", desc: "Project ID" }
+  ],
+  risk: "read",
+  execute: async (ctx) => {
+    return ctx.api("GET", "/v1/ta/dashboard/all-dashboards", {
+      projectId: ctx.num("project-id")
+    });
+  }
+};
+
+// src/commands/analysis/get-dashboard.ts
+var getDashboard = {
+  service: "analysis",
+  command: "+get-dashboard",
+  description: "Get dashboard details by ID",
+  flags: [
+    { name: "project-id", type: "number", required: true, alias: "p", desc: "Project ID" },
+    { name: "dashboard-id", type: "number", required: true, desc: "Dashboard ID" }
+  ],
+  risk: "read",
+  execute: async (ctx) => {
+    return ctx.api("POST", "/v1/ta/dashboard/search-dashboard", {
+      projectId: ctx.num("project-id")
+    }, {
+      dashboardId: ctx.num("dashboard-id")
+    });
+  }
+};
+
+// src/commands/analysis/create-dashboard.ts
+var createDashboard = {
+  service: "analysis",
+  command: "+create-dashboard",
+  description: "Create a new dashboard",
+  flags: [
+    { name: "project-id", type: "number", required: true, alias: "p", desc: "Project ID" },
+    { name: "dashboard-name", type: "string", required: true, desc: "Dashboard name" }
+  ],
+  risk: "write",
+  execute: async (ctx) => {
+    return ctx.api("POST", "/v1/ta/dashboard/create-dashboard", {
+      projectId: ctx.num("project-id")
+    }, {
+      dashboardName: ctx.str("dashboard-name")
+    });
+  }
+};
+
+// src/commands/analysis/update-dashboard.ts
+var updateDashboard = {
+  service: "analysis",
+  command: "+update-dashboard",
+  description: "Update dashboard report layout",
+  flags: [
+    { name: "project-id", type: "number", required: true, alias: "p", desc: "Project ID" },
+    { name: "dashboard-id", type: "number", required: true, desc: "Dashboard ID" },
+    { name: "reports", type: "json", required: true, desc: "[{reportId, reportWidth?, indexOrder}]" }
+  ],
+  risk: "write",
+  execute: async (ctx) => {
+    return ctx.api("POST", "/v1/ta/dashboard/update-dashboard", {
+      projectId: ctx.num("project-id")
+    }, {
+      dashbordId: ctx.num("dashboard-id"),
+      reports: ctx.json("reports")
+    });
+  }
+};
+
+// src/commands/analysis/list-dashboard-reports.ts
+var listDashboardReports = {
+  service: "analysis",
+  command: "+list-dashboard-reports",
+  description: "List reports within a dashboard",
+  flags: [
+    { name: "project-id", type: "number", required: true, alias: "p", desc: "Project ID" },
+    { name: "dashboard-id", type: "number", required: true, desc: "Dashboard ID" }
+  ],
+  risk: "read",
+  execute: async (ctx) => {
+    const result = await ctx.api("POST", "/v1/ta/dashboard/search-dashboard", {
+      projectId: ctx.num("project-id")
+    }, {
+      dashboardId: ctx.num("dashboard-id")
+    });
+    return result?.eventReportList ?? result;
+  }
+};
+
+// src/commands/analysis/query-report-data.ts
+var queryReportData = {
+  service: "analysis",
+  command: "+query-report-data",
+  description: "Query report data by report ID",
+  flags: [
+    { name: "project-id", type: "number", required: true, alias: "p", desc: "Project ID" },
+    { name: "report-id", type: "number", required: true, desc: "Report ID" },
+    { name: "dashboard-id", type: "number", desc: "Dashboard ID (optional)" },
+    { name: "start-time", type: "string", desc: "Start time (YYYY-MM-DD HH:mm:ss)" },
+    { name: "end-time", type: "string", desc: "End time (YYYY-MM-DD HH:mm:ss)" }
+  ],
+  risk: "read",
+  execute: async (ctx) => {
+    const projectId = ctx.num("project-id");
+    const reportId = ctx.num("report-id");
+    const report = await ctx.api("GET", "/v1/ta/event/reportsearch", {
+      projectId,
+      reportId
+    });
+    const qp = {
+      events: report.events,
+      eventView: report.eventView
+    };
+    const startTime = ctx.str("start-time");
+    const endTime = ctx.str("end-time");
+    if (startTime) qp.eventView = { ...qp.eventView, startTime };
+    if (endTime) qp.eventView = { ...qp.eventView, endTime };
+    return ctx.queryReportData(projectId, reportId, qp, report.reportModel || 0);
+  }
+};
+
+// src/commands/analysis/query-sql.ts
+var querySql = {
+  service: "analysis",
+  command: "+query-sql",
+  description: "Execute a SQL query against the project",
+  flags: [
+    { name: "project-id", type: "number", required: true, alias: "p", desc: "Project ID" },
+    { name: "sql", type: "string", required: true, desc: "SQL query string" }
+  ],
+  risk: "read",
+  execute: async (ctx) => {
+    return ctx.querySql(ctx.num("project-id"), ctx.str("sql"));
+  }
+};
+
+// src/commands/analysis/index.ts
+var commands = [
+  listReports,
+  getReport,
+  saveReport,
+  listDashboards,
+  getDashboard,
+  createDashboard,
+  updateDashboard,
+  listDashboardReports,
+  queryReportData,
+  querySql
+];
+var analysis_default = commands;
+export {
+  analysis_default as default
+};

package/dist/analysis-M54YNGTJ.js

@@ -0,0 +1,216 @@
+// src/commands/analysis/list-reports.ts
+var listReports = {
+  service: "analysis",
+  command: "+list-reports",
+  description: "List all analysis reports for a project",
+  flags: [
+    { name: "project-id", type: "number", required: true, alias: "p", desc: "Project ID" }
+  ],
+  risk: "read",
+  execute: async (ctx) => {
+    return ctx.api("POST", "/v1/ta/event/listAll", {
+      projectId: ctx.num("project-id")
+    });
+  }
+};
+
+// src/commands/analysis/get-report.ts
+var getReport = {
+  service: "analysis",
+  command: "+get-report",
+  description: "Get full report definition by ID",
+  flags: [
+    { name: "project-id", type: "number", required: true, alias: "p", desc: "Project ID" },
+    { name: "report-id", type: "number", required: true, desc: "Report ID" }
+  ],
+  risk: "read",
+  execute: async (ctx) => {
+    return ctx.api("GET", "/v1/ta/event/reportsearch", {
+      projectId: ctx.num("project-id"),
+      reportId: ctx.num("report-id")
+    });
+  }
+};
+
+// src/commands/analysis/save-report.ts
+var saveReport = {
+  service: "analysis",
+  command: "+save-report",
+  description: "Save (create/update) an analysis report",
+  flags: [
+    { name: "project-id", type: "number", required: true, alias: "p", desc: "Project ID" },
+    { name: "report-name", type: "string", required: true, desc: "Report name" },
+    { name: "report-model", type: "number", required: true, desc: "0=Event, 1=Retention, 2=Funnel, 10=Distribution" },
+    { name: "events", type: "json", required: true, desc: "Events configuration array" },
+    { name: "event-view", type: "json", required: true, desc: "Event view configuration" }
+  ],
+  risk: "write",
+  execute: async (ctx) => {
+    return ctx.api("POST", "/v1/ta/event/reportsave", {
+      projectId: ctx.num("project-id")
+    }, {
+      reportName: ctx.str("report-name"),
+      reportModel: ctx.num("report-model"),
+      events: ctx.json("events"),
+      eventView: ctx.json("event-view")
+    });
+  }
+};
+
+// src/commands/analysis/list-dashboards.ts
+var listDashboards = {
+  service: "analysis",
+  command: "+list-dashboards",
+  description: "List all dashboards for a project",
+  flags: [
+    { name: "project-id", type: "number", required: true, alias: "p", desc: "Project ID" }
+  ],
+  risk: "read",
+  execute: async (ctx) => {
+    return ctx.api("GET", "/v1/ta/dashboard/all-dashboards", {
+      projectId: ctx.num("project-id")
+    });
+  }
+};
+
+// src/commands/analysis/get-dashboard.ts
+var getDashboard = {
+  service: "analysis",
+  command: "+get-dashboard",
+  description: "Get dashboard details by ID",
+  flags: [
+    { name: "project-id", type: "number", required: true, alias: "p", desc: "Project ID" },
+    { name: "dashboard-id", type: "number", required: true, desc: "Dashboard ID" }
+  ],
+  risk: "read",
+  execute: async (ctx) => {
+    return ctx.api("POST", "/v1/ta/dashboard/search-dashboard", {
+      projectId: ctx.num("project-id"),
+      dashbordId: ctx.num("dashboard-id")
+    });
+  }
+};
+
+// src/commands/analysis/create-dashboard.ts
+var createDashboard = {
+  service: "analysis",
+  command: "+create-dashboard",
+  description: "Create a new dashboard",
+  flags: [
+    { name: "project-id", type: "number", required: true, alias: "p", desc: "Project ID" },
+    { name: "dashboard-name", type: "string", required: true, desc: "Dashboard name" }
+  ],
+  risk: "write",
+  execute: async (ctx) => {
+    return ctx.api("POST", "/v1/ta/dashboard/create-dashboard", {
+      projectId: ctx.num("project-id")
+    }, {
+      dashboardName: ctx.str("dashboard-name")
+    });
+  }
+};
+
+// src/commands/analysis/update-dashboard.ts
+var updateDashboard = {
+  service: "analysis",
+  command: "+update-dashboard",
+  description: "Update dashboard report layout",
+  flags: [
+    { name: "project-id", type: "number", required: true, alias: "p", desc: "Project ID" },
+    { name: "dashboard-id", type: "number", required: true, desc: "Dashboard ID" },
+    { name: "reports", type: "json", required: true, desc: "[{reportId, reportWidth?, indexOrder}]" }
+  ],
+  risk: "write",
+  execute: async (ctx) => {
+    return ctx.api("POST", "/v1/ta/dashboard/update-dashboard", {
+      projectId: ctx.num("project-id")
+    }, {
+      dashbordId: ctx.num("dashboard-id"),
+      reports: ctx.json("reports")
+    });
+  }
+};
+
+// src/commands/analysis/list-dashboard-reports.ts
+var listDashboardReports = {
+  service: "analysis",
+  command: "+list-dashboard-reports",
+  description: "List reports within a dashboard",
+  flags: [
+    { name: "project-id", type: "number", required: true, alias: "p", desc: "Project ID" },
+    { name: "dashboard-id", type: "number", required: true, desc: "Dashboard ID" }
+  ],
+  risk: "read",
+  execute: async (ctx) => {
+    const result = await ctx.api("POST", "/v1/ta/dashboard/search-dashboard", {
+      projectId: ctx.num("project-id"),
+      dashbordId: ctx.num("dashboard-id")
+    });
+    return result?.eventReportList ?? result;
+  }
+};
+
+// src/commands/analysis/query-report-data.ts
+var queryReportData = {
+  service: "analysis",
+  command: "+query-report-data",
+  description: "Query report data by report ID",
+  flags: [
+    { name: "project-id", type: "number", required: true, alias: "p", desc: "Project ID" },
+    { name: "report-id", type: "number", required: true, desc: "Report ID" },
+    { name: "dashboard-id", type: "number", desc: "Dashboard ID (optional)" },
+    { name: "start-time", type: "string", desc: "Start time (YYYY-MM-DD HH:mm:ss)" },
+    { name: "end-time", type: "string", desc: "End time (YYYY-MM-DD HH:mm:ss)" }
+  ],
+  risk: "read",
+  execute: async (ctx) => {
+    const projectId = ctx.num("project-id");
+    const reportId = ctx.num("report-id");
+    const report = await ctx.api("GET", "/v1/ta/event/reportsearch", {
+      projectId,
+      reportId
+    });
+    const qp = {
+      events: report.events,
+      eventView: report.eventView
+    };
+    const startTime = ctx.str("start-time");
+    const endTime = ctx.str("end-time");
+    if (startTime) qp.eventView = { ...qp.eventView, startTime };
+    if (endTime) qp.eventView = { ...qp.eventView, endTime };
+    return ctx.queryReportData(projectId, reportId, qp, report.reportModel || 0);
+  }
+};
+
+// src/commands/analysis/query-sql.ts
+var querySql = {
+  service: "analysis",
+  command: "+query-sql",
+  description: "Execute a SQL query against the project",
+  flags: [
+    { name: "project-id", type: "number", required: true, alias: "p", desc: "Project ID" },
+    { name: "sql", type: "string", required: true, desc: "SQL query string" }
+  ],
+  risk: "read",
+  execute: async (ctx) => {
+    return ctx.querySql(ctx.num("project-id"), ctx.str("sql"));
+  }
+};
+
+// src/commands/analysis/index.ts
+var commands = [
+  listReports,
+  getReport,
+  saveReport,
+  listDashboards,
+  getDashboard,
+  createDashboard,
+  updateDashboard,
+  listDashboardReports,
+  queryReportData,
+  querySql
+];
+var analysis_default = commands;
+export {
+  analysis_default as default
+};