@thinkingai/ae-cli 1.0.15 → 1.0.20

package/skills/ae-community/SKILL.md

@@ -2,10 +2,6 @@
 name: ae-community
 version: 2.0.0
 description: "AE community analysis: post search, comment sentiment, topic trends, risky content, livestream data. Includes AE CLI authentication, global parameters, and safety rules (self-contained)."
-metadata:
-  requires:
-    bins: ["ae-cli"]
-  cliHelp: "ae-cli community --help"
 ---
 
 # ae-community
@@ -24,107 +20,24 @@ The AE Community domain provides social data analysis: post/video search, commen
 
 ## Global AE CLI Rules
 
-AE CLI (`ae-cli`) is the command-line tool for the ThinkingEngine data analysis platform, used by AI Agents and human users. For community-side requests, prefer `ae-cli` and this skill’s reference docs over model memory.
+AE CLI (`ae-cli`) is the command-line tool for the AE / TE / ThinkingEngine analysis platform. For AE analysis-side requests, prefer `ae-cli` and this skill's reference docs over model memory.
 
-### Authentication
+Global parameters:
 
-You must authenticate before use. Authentication priority:
+| Parameter | Description |
+|---|---|
+| `--format <json\|table>` | Output format. Default is JSON. |
+| `--jq <expr>` | jq filter expression for JSON output. |
 
-1. Environment variable `TE_TOKEN` (highest priority, suitable for CI/scripts)
-2. Cached token (`~/.ae-cli/tokens.json`, valid for 20 hours)
-3. macOS automatically extracts it from Chrome (macOS only)
+Output and errors:
+- Successful commands return machine-readable JSON by default.
+- Failed commands return `{ "ok": false, "error": { "type": "...", "message": "...", "hint": "..." } }` and exit non-zero.
 
-**Authentication commands**
-
-```bash
-# Automatic macOS authentication (extract token from Chrome)
-ae-cli auth login
-
-# Manually set token
-ae-cli auth set-token <token>
-
-# View authentication status
-ae-cli auth status
-
-# Log out
-ae-cli auth logout
-```
-
-**Multi-environment support**
-
-```bash
-# Specify host
-ae-cli auth login --host ta-staging.example.com
-ae-cli auth set-token <token> --host ta-staging.example.com
-
-# Configure default host
-ae-cli config set defaultHost ta-staging.example.com
-```
-
-### Global parameters
-
-All commands support the following global parameters:
-
-| Parameter | Description | Default |
-|------|------|--------|
-| `--host <host>` | AE instance address | defaultHost from config or ta.thinkingdata.cn |
-| `--format <json\|table>` | Output format | json |
-| `--jq <expr>` | jq filter expression | - |
-| `--dry-run` | Show the request only, do not execute it | false |
-| `--yes` | Skip confirmation for write operations | false |
-
-### Output format
-
-**JSON (default)**
-
-```json
-{
-  "ok": true,
-  "data": { ... }
-}
-```
-
-**Table**
-
-```bash
-ae-cli analysis_meta +list_events --project_id <YOUR_PROJECT_ID> --format table
-```
-
-**jq filtering**
-
-```bash
-ae-cli analysis_meta +list_events --project_id <YOUR_PROJECT_ID> --jq '.'
-```
-
-### Error handling
-
-Error output goes to stderr, in the following format:
-
-```json
-{
-  "ok": false,
-  "error": {
-    "type": "auth | api | validation | config",
-    "message": "...",
-    "hint": "..."
-  }
-}
-```
-
-Exit code: success `0`, error `1`.
-
-### Security constraints
-
-- Commands with `risk: read` execute directly
-- Commands with `risk: write` require confirmation unless `--yes` is passed
-- Use `--dry-run` to preview the request that will be sent
-
-### Command structure
-
-```bash
-ae-cli <domain> +<command> [flags]
-ae-cli api <METHOD> <PATH> [--params] [--data]
-```
+Safety constraints:
+- Read commands can execute directly after required IDs and references are verified.
+- Write commands require explicit user intent and normally keep the confirmation prompt.
+- Never invent command names, flags, JSON payloads, `project_id`, resource IDs, field names, event names, property names, metric definitions, or date formats. Read the matching command reference and discover real project metadata first.
+- **NEVER fabricate or guess resource names** (reports, dashboards, events, properties, metrics, clusters, tags, alerts). Always use list commands to discover real resources first. If a resource is not found after fuzzy search and full list fallback, explicitly tell the user "resource not found" and stop - do not proceed with fabricated names.
 
 **Community** commands use the domain `community` (this skill). Other AE domains include: `analysis` (analysis), `analysis_audience` (audience), `analysis_meta` (metadata), `analysis_common` (common), `operation` (operations).
 

package/skills/ae-dataops/SKILL.md

@@ -2,10 +2,6 @@
 name: ae-dataops
 version: 2.0.0
 description: "AE Data Development and Operations: Data warehouse management, flow orchestration, IDE queries, data integration, operations and backfill management"
-metadata:
-  requires:
-    bins: ["ae-cli"]
-  cliHelp: "ae-cli dataops_repo --help, ae-cli dataops_datatable --help, ae-cli dataops_flow --help, ae-cli dataops_ide --help, ae-cli dataops_integration --help, ae-cli dataops_operations --help"
 ---
 
 # ae-dataops
@@ -26,68 +22,27 @@ The AE Data Development and Operations domain provides capabilities for data war
 
 ---
 
-## Global AE CLI Rules
-
-AE CLI (`ae-cli`) is the command-line tool for the AE data development and operations platform. For DataOps-side requests, prefer `ae-cli` and this skill's reference docs over model memory.
-
-Authentication priority:
-1. `TE_TOKEN` environment variable.
-2. Cached token in `~/.ae-cli/tokens.json`, usually valid for 20 hours.
-3. macOS Chrome token extraction via `ae-cli auth login`.
-
-Useful authentication commands:
-
-```bash
-ae-cli auth login
-ae-cli auth set-token <token>
-ae-cli auth status
-ae-cli auth logout
-```
 
-Multi-environment support:
+## Global AE CLI Rules
 
-```bash
-# Specify host
-ae-cli auth login --host ta-staging.example.com
-ae-cli auth set-token <token> --host ta-staging.example.com
-
-# Configure default host
-ae-cli config set defaultHost ta-staging.example.com
-```
+AE CLI (`ae-cli`) is the command-line tool for the AE / TE / ThinkingEngine analysis platform. For AE analysis-side requests, prefer `ae-cli` and this skill's reference docs over model memory.
 
 Global parameters:
 
-| Parameter | Description | Default |
-|---|---|---|
-| `--host <host>` | Target AE instance address | defaultHost from config or ta.thinkingdata.cn |
-| `--format <json|table>` | Output format | json |
-| `--jq <expr>` | jq filter expression for JSON output | - |
-| `--dry-run` | Preview the request without executing it | false |
-| `--yes` | Skip confirmation for write operations | false |
-
-Output format:
-
-- JSON (default): `{ "ok": true, "data": { ... } }`
-- Table: `ae-cli dataops_flow +list_flows --spaceCode xxx --format table`
-- jq filtering: `ae-cli dataops_flow +list_flows --spaceCode xxx --jq '.'`
+| Parameter | Description |
+|---|---|
+| `--format <json\|table>` | Output format. Default is JSON. |
+| `--jq <expr>` | jq filter expression for JSON output. |
 
-Error handling:
-
-- Failed commands return `{ "ok": false, "error": { "type": "auth|api|validation|config", "message": "...", "hint": "..." } }` to stderr.
-- Exit code: success `0`, error `1`.
+Output and errors:
+- Successful commands return machine-readable JSON by default.
+- Failed commands return `{ "ok": false, "error": { "type": "...", "message": "...", "hint": "..." } }` and exit non-zero.
 
 Safety constraints:
-
-- Commands with `risk: read` execute directly.
-- Commands with `risk: write` require confirmation unless `--yes` is passed.
-- Use `--dry-run` to preview the request that will be sent.
-
-Command structure:
-
-```bash
-ae-cli <domain> +<command> [flags]
-ae-cli api <METHOD> <PATH> [--params] [--data]
-```
+- Read commands can execute directly after required IDs and references are verified.
+- Write commands require explicit user intent and normally keep the confirmation prompt.
+- Never invent command names, flags, JSON payloads, `project_id`, resource IDs, field names, event names, property names, metric definitions, or date formats. Read the matching command reference and discover real project metadata first.
+- **NEVER fabricate or guess resource names** (reports, dashboards, events, properties, metrics, clusters, tags, alerts). Always use list commands to discover real resources first. If a resource is not found after fuzzy search and full list fallback, explicitly tell the user "resource not found" and stop - do not proceed with fabricated names.
 
 Domains for DataOps: `dataops_repo`, `dataops_datatable`, `dataops_flow`, `dataops_ide`, `dataops_integration`, `dataops_operations`
 

package/skills/ae-engage/SKILL.md

@@ -2,115 +2,32 @@
 name: ae-engage
 version: 1.0.0
 description: "AE Engage MCP: config items, flows, channel settings, task data query, and management"
-metadata:
-  requires:
-    bins: ["ae-cli"]
-  cliHelp: "ae-cli engage --help"
 ---
 
 # ae-engage
 
 AE CLI (`ae-cli`) is the command-line tool for the ThinkingEngine data analysis platform, used by AI Agents and human users.
 
-## Authentication
+## Global AE CLI Rules
 
-You must authenticate before use. Authentication priority:
+AE CLI (`ae-cli`) is the command-line tool for the AE / TE / ThinkingEngine analysis platform. For AE analysis-side requests, prefer `ae-cli` and this skill's reference docs over model memory.
 
-1. Environment variable `TE_TOKEN` (highest priority, suitable for CI/scripts)
-2. Cached token (`~/.ae-cli/tokens.json`, valid for 20 hours)
-3. macOS automatically extracts it from Chrome (macOS only)
+Global parameters:
 
-### Authentication Commands
+| Parameter | Description |
+|---|---|
+| `--format <json\|table>` | Output format. Default is JSON. |
+| `--jq <expr>` | jq filter expression for JSON output. |
 
-```bash
-# Automatic macOS authentication (extract token from Chrome)
-ae-cli auth login
-
-# Manually set token
-ae-cli auth set-token <token>
-
-# View authentication status
-ae-cli auth status
-
-# Log out
-ae-cli auth logout
-```
-
-### Multi-environment Support
-
-```bash
-# Specify host
-ae-cli auth login --host ta-staging.example.com
-ae-cli auth set-token <token> --host ta-staging.example.com
-
-# Configure default host
-ae-cli config set defaultHost ta-staging.example.com
-```
-
-## Global Parameters
-
-All commands support the following global parameters:
-
-| Parameter | Description | Default |
-|------|------|--------|
-| `--host <host>` | AE instance address | defaultHost from config or ta.thinkingdata.cn |
-| `--format <json\|table>` | Output format | json |
-| `--jq <expr>` | jq filter expression | - |
-| `--dry-run` | Show the request only, do not execute it | false |
-| `--yes` | Skip confirmation for write operations | false |
-
-## Output Format
-
-### JSON (default)
-
-```json
-{
-  "ok": true,
-  "data": { ... }
-}
-```
-
-### Table
+Output and errors:
+- Successful commands return machine-readable JSON by default.
+- Failed commands return `{ "ok": false, "error": { "type": "...", "message": "...", "hint": "..." } }` and exit non-zero.
 
-```bash
-ae-cli engage +channel_list --project_id <YOUR_PROJECT_ID> --format table
-```
-
-### jq Filtering
-
-```bash
-ae-cli engage +channel_list --project_id <YOUR_PROJECT_ID> --jq '.'
-```
-
-## Error Handling
-
-Error output goes to stderr, in the following format:
-
-```json
-{
-  "ok": false,
-  "error": {
-    "type": "auth | api | validation | config",
-    "message": "...",
-    "hint": "..."
-  }
-}
-```
-
-Exit code: success `0`, error `1`.
-
-## Security Constraints
-
-- Commands with `risk: read` execute directly
-- Commands with `risk: write` require confirmation unless `--yes` is passed
-- Use `--dry-run` to preview the request that will be sent
-
-## Command Structure
-
-```bash
-ae-cli <domain> +<command> [flags]
-ae-cli api <METHOD> <PATH> [--params] [--data]
-```
+Safety constraints:
+- Read commands can execute directly after required IDs and references are verified.
+- Write commands require explicit user intent and normally keep the confirmation prompt.
+- Never invent command names, flags, JSON payloads, `project_id`, resource IDs, field names, event names, property names, metric definitions, or date formats. Read the matching command reference and discover real project metadata first.
+- **NEVER fabricate or guess resource names** (reports, dashboards, events, properties, metrics, clusters, tags, alerts). Always use list commands to discover real resources first. If a resource is not found after fuzzy search and full list fallback, explicitly tell the user "resource not found" and stop - do not proceed with fabricated names.
 
 ## Overview
 

package/dist/auth-U2GHFMFY.js

@@ -1,81 +0,0 @@
-import {
-  printError,
-  printOutput
-} from "./chunk-KM57HI5B.js";
-import {
-  clearToken,
-  getAuthStatus,
-  getToken,
-  resolveHost,
-  setTokenManual
-} from "./chunk-UK6HO5O5.js";
-import {
-  loadConfig,
-  saveConfig
-} from "./chunk-EBFUVWIZ.js";
-
-// src/commands/auth.ts
-function registerAuth(program) {
-  const auth = program.command("auth").description("Authentication management");
-  auth.command("login").description("Login to AE (auto-extract token from Chrome on macOS)").action(async () => {
-    const host = resolveHost(program.opts().host);
-    if (!host) {
-      printError("config", "No AE host configured.", "Run: ae-cli config set-host");
-      process.exit(1);
-    }
-    try {
-      const token = await getToken(host);
-      process.stderr.write(`[ae-cli] Authenticated to ${host}
-`);
-      printOutput({ authenticated: true, host, token: token.slice(0, 8) + "..." }, program.opts().format || "json");
-    } catch (err) {
-      printError("auth", err.message);
-      process.exit(1);
-    }
-  });
-  auth.command("set-token <token>").description("Manually set authentication token for active host").action((token) => {
-    const host = resolveHost(program.opts().host);
-    if (!host) {
-      printError("config", "No AE host configured.", "Run: ae-cli config set-host");
-      process.exit(1);
-    }
-    const config = loadConfig();
-    if (!config.hosts[host]) {
-      config.hosts[host] = { label: host };
-      if (!config.activeHost) {
-        config.activeHost = host;
-      }
-      saveConfig(config);
-      process.stderr.write(`[ae-cli] Config saved for ${host}
-`);
-      printOutput({ saved: true, config }, program.opts().format || "json");
-    }
-    setTokenManual(token, host);
-    process.stderr.write(`[ae-cli] Token saved for ${host}
-`);
-    printOutput({ saved: true, host }, program.opts().format || "json");
-  });
-  auth.command("status").description("Show current authentication status").action(() => {
-    const host = resolveHost(program.opts().host);
-    if (!host) {
-      printOutput({ authenticated: false, host: "(none)", hint: "Run: ae-cli config set-host" }, program.opts().format || "json");
-      return;
-    }
-    const status = getAuthStatus(host);
-    printOutput(status, program.opts().format || "json");
-  });
-  auth.command("logout").description("Clear stored token for active host").action(() => {
-    const host = resolveHost(program.opts().host);
-    if (!host) {
-      printError("config", "No AE host configured.", "Run: ae-cli config set-host");
-      process.exit(1);
-    }
-    clearToken(host);
-    process.stderr.write(`[ae-cli] Token cleared for ${host}
-`);
-    printOutput({ cleared: true, host }, program.opts().format || "json");
-  });
-}
-export {
-  registerAuth
-};