@thinkingai/ae-cli 6.0.18 → 6.0.22

package/skills/ae-generate-tracking-plan/SKILL.md

@@ -92,14 +92,44 @@ After user responds, record to `meta.scenario` and generate `meta.plan_name`.
 
 ### Item 2 — Source Material + Business Dimension (combined)
 
-Ask: **"Choose your source material (up to 2):"**
+Before asking, decide whether the current runtime is an agent sandbox. The agent may judge this from runtime context such as sandbox-provisioned `cli-token.json`, restricted filesystem access, or absence of the user's local files. Do not ask the user just to decide sandbox visibility.
 
-User can multi-select (max 2):
+Product document and Codebase are local-material options. **Hide both options in sandbox environments**. When options are hidden, renumber the visible list contiguously from 1; never show skipped numbers.
 
-1. **Product document** (local path, image file, or folder) — Extract events and properties from product docs; supports md/pdf/docx/URL/images (png/jpg/jpeg/webp)
-2. **Detailed description** (conversational) — Describe app business flow, core features, user behaviors, monetization model, etc.
-3. **Codebase** (local project path) — Analyze source code to extract events and properties
-4. **Pre-built template** (built-in industry and game genre templates) — Select a built-in template (run `AE_LANG=<user_lang> ae-cli tracking plan list-templates` to see available templates)
+If **not** in a sandbox environment, ask exactly:
+
+```text
+Choose your source material (up to 2):
+
+1 - Product document (local path, image file, or folder; hidden in sandbox) — Extract events and properties from product docs; supports md/pdf/docx/URL/images (png/jpg/jpeg/webp)
+2 - Detailed description (conversational) — Describe app business flow, core features, user behaviors, monetization model, etc.
+3 - Codebase (local project path; hidden in sandbox) — Analyze source code to extract events and properties
+4 - Pre-built template (built-in industry and game genre templates) — Select a built-in template
+
+Reply with number(s), e.g. 1 or 1,4. Select up to 2.
+```
+
+If in a sandbox environment, ask exactly:
+
+```text
+Choose your source material (up to 2):
+
+1 - Detailed description (conversational) — Describe app business flow, core features, user behaviors, monetization model, etc.
+2 - Pre-built template (built-in industry and game genre templates) — Select a built-in template
+
+Reply with number(s), e.g. 1 or 1,2. Select up to 2.
+```
+
+Do not rewrite this source material list as unnumbered bullets, cards, or prose. The user must be able to reply with the visible numbers.
+
+User can multi-select (max 2). Interpret numbers by the **visible list shown to the user**, not by the non-sandbox canonical list.
+
+Canonical source material options:
+
+- **Product document** (local path, image file, or folder; hidden in sandbox) — Extract events and properties from product docs; supports md/pdf/docx/URL/images (png/jpg/jpeg/webp)
+- **Detailed description** (conversational) — Describe app business flow, core features, user behaviors, monetization model, etc.
+- **Codebase** (local project path; hidden in sandbox) — Analyze source code to extract events and properties
+- **Pre-built template** (built-in industry and game genre templates) — Select a built-in template (run `AE_LANG=<user_lang> ae-cli tracking plan list-templates --json` to see available templates)
 
 Based on user selection, determine source material type and record to `meta.source_type`:
 
@@ -168,7 +198,7 @@ Platform validation: Use `business-dimension-mapping.md` Chapter 5 decision rule
 
 After business dimension confirmation, auto-detect matching templates based on app type:
 ```bash
-AE_LANG=<user_lang> ae-cli tracking plan list-templates
+AE_LANG=<user_lang> ae-cli tracking plan list-templates --json
 ```
 
 Show matching templates to user for confirmation. Confirmed templates serve as baseline and participate in Phase 1 event merging.
@@ -189,6 +219,8 @@ Show matching templates to user for confirmation. Confirmed templates serve as b
 
 Ask: **"What is your client platform? (multi-select OK, e.g. Android + iOS) Will you integrate a server-side SDK?"**
 
+After asking this Item 3 question, **stop and wait for the user's answer**. Do not display Item 4 in the same response.
+
 > **Language filter**: The following SDKs have Chinese-only documentation and are **visible to Chinese users only**: `Mini-program`, `Mini-game`, `OpenHarmony`, `LayaAir`, `Egret`, `Cocos2d-Lua`. Do not show these to non-Chinese users.
 
 **Client integration** (multi-select OK):
@@ -270,6 +302,14 @@ Record to `client_platform_languages`:
 
 `none` mode: Suitable for historical data import, batch data sync, third-party system integration, etc. Refine phase does not inject SDK auto-track events.
 
+**Item 3 confirmation gate**:
+
+After the user answers Item 3, normalize the SDK configuration and ask only the missing follow-up questions (for Android/iOS programming language or `Other` server language).
+
+Then summarize the normalized SDK config and ask: **"Confirm this SDK integration config? Reply ok to continue to Item 4, or describe changes."**
+
+Do not display Item 4 or ask identity questions until the user explicitly confirms this SDK integration config.
+
 ### Item 4 — User Identity System (visitor ID + account ID combined)
 
 Ask: **"What is the visitor ID generation strategy?"**
@@ -426,8 +466,8 @@ Draft
 Priority from low to high: **template → codebase → prd → chat → autotrack**
 
 - **template**: User-selected industry template (see "Template Lookup Convention" below) as baseline; each item marked `source: "template"`
-  - Templates prefer `.md` distilled files (`tracking-plan-template/*.md`), fall back to `.xlsx`
-  - Import command: `AE_LANG=<user_lang> ae-cli tracking code import-template --template <path> --out .ae-cli/draft.json`
+  - Templates are resolved by ae-cli from the ae-cli package root and user template directory
+  - Import command: `AE_LANG=<user_lang> ae-cli tracking code import-template --template-name "<template name>" --out .ae-cli/draft.json`
   - ⚠️ **Must validate immediately after template import** (see Phase 1.6); template content may not be fully correct
   - ⚠️ **Template content is in Chinese; must translate after import**: Read draft.json, translate `display_name`, `event_desc`, `event_tag`, and property `display_name`/`desc` to user's language, then write back. Only `event_name`, property `name`, `type` identifiers remain as-is.
   - ⚠️ **event_tag also needs translation**: `业务事件`→user's language (e.g. EN: `Business Event`), `系统事件`→user's language (e.g. EN: `System Event`; autotrack events are handled automatically by CLI, no need to re-translate)
@@ -601,21 +641,23 @@ Next: Phase 2 — Refine to confirm the plan.
 Run the following command to dynamically discover available templates:
 
 ```bash
-AE_LANG=<user_lang> ae-cli tracking plan list-templates
+AE_LANG=<user_lang> ae-cli tracking plan list-templates --json
 ```
 
 **Language rules**: Template file names are in Chinese. When displaying to users, **must translate to user's current language**; **do NOT** include the original Chinese name (e.g. show only "Card Game v1", not "Card Game (卡牌游戏) v1").
 
+Built-in templates are resolved by ae-cli from the ae-cli package root. User templates are resolved from the ae-cli user template directory. Do **not** manually construct `./tracking-plan-template/...` paths from the user's current workspace.
+
 Search directories in order:
 
-1. `./tracking-plan-template/` — Project root (development)
-2. `~/.ae-cli/templates/` — `ae-cli tracking` CLI user directory after installation (future default)
+1. `<ae-cli package root>/tracking-plan-template/` — bundled templates
+2. `~/.ae-cli/templates/` — user-provided template directory
 
 Each template prefers `.md` distilled file (if same-name `.md` exists, return md path; otherwise return xlsx path).
-Auto-detect format on import:
+Display translated template names to the user, but keep the original `name` from the JSON result for import. Auto-detect format on import:
 
 ```bash
-AE_LANG=<user_lang> ae-cli tracking code import-template --template <path> --out .ae-cli/draft.json
+AE_LANG=<user_lang> ae-cli tracking code import-template --template-name "<template name>" --out .ae-cli/draft.json
 ```
 
 ---
@@ -633,13 +675,22 @@ In order, one conversation round per segment:
 Per-segment flow:
 
 1. Display corresponding section of current draft
-2. Ask **"Does this look correct? `ok` to proceed to next segment, or describe what to change"**
+2. Ask a segment-specific confirmation question. Always include the current segment number, current segment key, and next segment key:
+   ```text
+   Segment <n>/5 <segment_key> confirmed? Reply ok to continue to Segment <n+1>/5 <next_segment_key>, or describe changes.
+   ```
+   For Segment 5:
+   ```text
+   Segment 5/5 props confirmed? Reply ok to archive the plan and continue to Phase 3, or describe changes.
+   ```
 3. User gives natural language instructions → update `.ae-cli/draft.json` → re-run:
    ```bash
    AE_LANG=<user_lang> ae-cli tracking plan draft --in .ae-cli/draft.json --out .ae-cli/draft.xlsx
    ```
 4. User `ok` → proceed to next segment
 
+`ok` is a refine state-machine input, not a repeated-message error. If the user replies `ok` multiple times in a row, advance exactly one segment per `ok` in order. Before each confirmation prompt, print the new segment heading first, so consecutive confirmations do not look like the same question repeated.
+
 User may say **"Go back to segment N"** at any time to jump to any segment (N = 1-5).
 
 ---
@@ -849,33 +900,59 @@ At the start of Phase 3, tell user:
 ```
 ## Phase 3 — Upload Preparation
 Next steps:
-1. AE web address
-2. Login to AE to get token
+1. Check active AE host and login status
+2. Login to AE to get token if needed
 3. AE project ID
 ```
 
-### 3.1 Get AE Web Address
+### 3.1 Check Active AE Host and Login Status
 
-❌ **Do NOT provide unconfirmed example URLs here.** Simply ask the user directly.
+Do not ask for the AE web address first. ae-cli stores an active AE host, and auth commands can use it directly.
 
-Ask user: **"What is the AE web address?"**
+First check current auth/host status:
 
-After user responds, save to `.ae-cli/draft.json` `meta.host` field.
+```bash
+ae-cli auth status
+```
+
+If an active host is configured, save that host to `.ae-cli/draft.json` `meta.host`. If `auth status` reports `authenticated: true`, skip login and continue to project ID.
+
+Only if ae-cli reports no active host / no AE host configured, ask the user:
+
+**"What is the AE web address?"**
+
+After user responds, configure it and save the same value to `.ae-cli/draft.json` `meta.host`:
+
+```bash
+ae-cli config set-host <host>
+```
+
+If `auth status` reports unauthenticated, use the agent split-flow. Do **not** run blocking `ae-cli auth login` directly from an AI agent.
 
-Guide getting and saving token based on AE web address:
+Step 1 — request an authorization URL and return control to the user:
 
 ```bash
-ae-cli auth login --host <host>
+ae-cli auth login --no-wait
+```
+
+Show the returned `verification_url` to the user and ask them to complete authorization. Keep the returned `device_code` for the next step.
+
+Step 2 — after the user says authorization is complete, finish login:
+
+```bash
+ae-cli auth login --device-code <device_code>
 ae-cli auth status
 ```
 
+Do not retry with `ae-cli auth login --host <host>` unless the previous command explicitly failed because no active host was configured. In that case, configure the host first, then restart the split-flow with `--no-wait`.
+
 Common error tips and self-recovery:
 
 | Error | Cause | What to Tell the User |
 |---|---|---|
-| `Chrome JS-from-AppleEvents disabled` | Chrome disabled AppleScript JS execution | Chrome menu View → Developer → Allow JavaScript from Apple Events, then retry |
-| `not_mac` | Not macOS | Manually set `export AE_TOKEN=<uuid>` (get from DevTools → Application → Local Storage → `ACCESS_TOKEN`, strip quotes) |
-| `NO_TAB_FOUND` | Not logged into AE in Chrome | Open and login to TE in Chrome first, then retry |
+| `Device authorize request failed` | The agent runtime cannot reach the authorization service | Report that no device code was created and include the exact error |
+| `not_mac` | A legacy browser-token flow was attempted | Retry the split-flow device-code login; do not ask the user for browser tokens |
+| `NO_TAB_FOUND` | A legacy browser-token flow was attempted | Retry the split-flow device-code login; do not ask the user to open Chrome |
 
 Token cached for 20 hours; same host avoids re-auth.
 
@@ -901,9 +978,11 @@ Checking project's existing plan...
 Before uploading, check if the project already has a tracking plan:
 
 ```bash
-AE_LANG=<user_lang> ae-cli tracking plan fetch --project <projectId> --host <host> > .ae-cli/existing-plan.json
+AE_LANG=<user_lang> ae-cli tracking plan fetch --project <projectId> > .ae-cli/existing-plan.json
 ```
 
+Do not add `--host` here unless the user explicitly provides a reachable override for this command. In agent sandboxes, ae-cli can resolve the request host from the sandbox-provisioned `cli-token.json`; passing a stale Kubernetes internal host can bypass that fallback.
+
 **Result assessment**:
 - File empty or command error `404` → project has no plan; upload directly
 - File has content → project has an existing plan; show summary + **conflict detection**
@@ -1008,12 +1087,10 @@ AE_LANG=<user_lang> ae-cli tracking plan upload --project <projectId> --xlsx .ae
 - **With `--replace`**: Delete existing project plan first then upload (when user chooses "Replace", or severe conflict switches to replace)
 - **Without `--replace`**: AE merge-by-name merge (no conflicts, or advisory only with user confirmation to append)
 
-If CLI returns exit code 13 (language mismatch), the AE project language differs from xlsx language. Do NOT silently retry; must prompt user:
-> "AE project language is {aeLang}, but current xlsx is {xlsxLang}. Switch AE language?"
-
-After user confirms, re-upload with `--switch-lang`:
+Upload language is controlled locally by `AE_LANG`, `--lang`, or `draft.meta.lang`. Do not call AE user language config APIs and do not use `--switch-lang`. If the xlsx language is wrong, regenerate the xlsx with the intended language before uploading:
 ```bash
-AE_LANG=<user_lang> ae-cli tracking plan upload --project <projectId> --xlsx .ae-cli/draft.xlsx --draft .ae-cli/draft.json --switch-lang [--replace]
+AE_LANG=<user_lang> ae-cli tracking plan draft --in .ae-cli/draft.json --out .ae-cli/draft.xlsx
+AE_LANG=<user_lang> ae-cli tracking plan upload --project <projectId> --xlsx .ae-cli/draft.xlsx --draft .ae-cli/draft.json [--replace]
 ```
 
 On successful upload, prompt user to verify in AE Admin. **Provide the full URL** (tracking plan page URL format: `https://<host>/#/data/plan`).

package/skills/ae-generate-tracking-plan/references/te-api.md

@@ -1,23 +1,22 @@
-# AE Backend API (internal reference)
+# AE Tracking Capability API (internal reference)
 
-> **Terminology**: 认证 = authentication | Token = bearer token from localStorage `ACCESS_TOKEN` | 端点 = endpoint | 抓包 = traffic capture | 埋点方案 = tracking plan | 上传 = upload | 删除 = delete | 查询 = query/fetch
+> **Terminology**: authentication = CLI token | capability = gateway-registered operation | tracking plan = program | upload = save xlsx | delete = clear program | query/fetch = read program
 
-> This file is the implementation basis for `src/client.ts`, maintained for internal contributors.
+> This file is the implementation basis for `src/core/tracking-client.ts`, maintained for internal contributors.
 > **Skill body should not reference this document** — skill users interact via CLI commands and do not need to know underlying endpoints.
 > xlsx format contract is in `xlsx-schema.md`, not here.
 
-Capture environment: `https://web-ta-demo.thinkingdata.cn`. If endpoints change, re-run the
-chrome-devtools capture flow from `docs/superpowers/plans/2026-04-15-ae-tracking-skill.md` Task 3.
+The AE CLI must call common-service through capability gateway URLs under `/api/cli/`.
+The legacy common-service endpoints are wrapped server-side by these capabilities and must not be
+called directly from `ae-cli`.
 
-## 认证
+## Authentication
 
-### Token
-- localStorage key：`ACCESS_TOKEN`
-- 存储形态：**JSON 编码字符串**（带双引号），使用前须 `replace(/^["']|["']$/g, '')`
+All capability requests use the CLI token chain:
 
-### 两种传 token 方式（按端点区分）
-- **GET/JSON 类接口**：Header `authorization: bearer <token>`（全小写）
-- **Excel 上传接口**：**form field `access_token`**，裸 UUID，**不用** Authorization header
+- Header: `cli-token: <token>`
+- Do not send `authorization: bearer ...`.
+- Do not send `access_token` form fields.
 
 ## 响应统一包装
 
@@ -25,16 +24,22 @@ chrome-devtools capture flow from `docs/superpowers/plans/2026-04-15-ae-tracking
 { "return_code": 0, "return_message": "success", "showStackMessage": false, "data": ... }
 ```
 - `return_code === 0` 为成功；非 0 抛错，取 `return_message`
-- 某些端点（如 `excel-save` / 空项目 `query`）成功时无 `data`
+- Empty project query may return no `data`.
 
-## 端点
+## Capabilities
 
-### 1. GET `/v1/ta/bury/manage/program/query`
+### 1. `track.program.query`
 
 获取项目唯一的埋点方案。
 
-- Query：`projectId` 必填 number
-- Header：`authorization: bearer <token>`
+- Method: `POST`
+- URL: `/api/cli/analysis/v1/capabilities/track.program.query/execute`
+- Input:
+
+```json
+{ "project_id": 1603 }
+```
+
 - Response `data` 结构（事件池 / 事件属性池 / 公共属性 / 用户属性）：
 
 ```jsonc
@@ -55,21 +60,46 @@ chrome-devtools capture flow from `docs/superpowers/plans/2026-04-15-ae-tracking
 
 空项目：`data` 不存在，直接 `{ return_code: 0, return_message: "success" }`。
 
-### 2. GET `/v1/ta/bury/manage/program/delete?projectId=<id>`
+### 2. `track.program.delete`
 
 一次清空整个项目的方案（事件 / 事件属性 / 公共属性 / 用户属性）。
 
-### 3. POST `/v1/ta/bury/manage/program/excel-save`
+- Method: `POST`
+- URL: `/api/cli/analysis/v1/capabilities/track.program.delete/execute`
+- Input:
+
+```json
+{ "project_id": 1603 }
+```
+
+### 3. `track.program.excel_save`
 
 批量上传 xlsx。
 
-- Content-Type：`multipart/form-data`
-- Form fields（全必填）：
-  - `file` — xlsx 二进制
-  - `projectId` — 文本
-  - `access_token` — 文本，裸 UUID
-- **无** Authorization header
-- Response：`{ return_code: 0, return_message: "success" }`（无 data）
+Upload is a two-step capability-gateway flow:
+
+1. Upload the xlsx as an input file.
+
+   - Method: `POST`
+   - URL: `/api/cli/analysis/v1/input-files`
+   - Content-Type: `multipart/form-data`
+   - Form fields:
+     - `project_id`
+     - `purpose`: `track.program.xlsx`
+     - `file`: xlsx binary
+   - Response includes `input_file_id`.
+
+2. Execute the save capability.
+
+   - Method: `POST`
+   - URL: `/api/cli/analysis/v1/capabilities/track.program.excel_save/execute`
+   - Input:
+
+```json
+{ "project_id": 1603, "input_file_id": "..." }
+```
+
+- Response: `{ return_code: 0, return_message: "success" }` on success.
 
 **合并语义**：对事件走 **merge-by-name**（同名不覆盖、新名新增）。若要完全替换，
 必须先调 `delete` 端点清空再上传。
@@ -96,5 +126,5 @@ chrome-devtools capture flow from `docs/superpowers/plans/2026-04-15-ae-tracking
 
 ## v2（暂未实现）
 
-- UI「逐个添加」通向单事件 CRUD 接口（`POST /v1/ta/bury/manage/event/*` 族），v1 走 excel-save 统一入口
+- UI「逐个添加」通向单事件 CRUD 接口，v1 走 `track.program.excel_save` 统一入口
 - 列项目、校验错误响应等见 plan 文档的"未抓端点"清单

package/skills/ae-metadata/SKILL.md

@@ -0,0 +1,90 @@
+---
+name: ae-metadata
+version: 1.0.0
+description: "AE/TE metadata capability-gateway CLI: metadata event/property detail, metadata data-table management, input-file upload, and property dimension-table binding. Use for ae-cli metadata commands backed by /api/cli/metadata/v1. Must read references before composing commands; command/flags use kebab-case while gateway input keeps snake_case. Never guess project_id, event/property names, input_file_id, or data_table_id."
+---
+
+# ae-metadata
+
+Capability-gateway domain **`metadata`** — REST via `/api/cli/metadata/v1/...`, auth header **`cli-token`**.
+
+Parallel to **`ae-analysis`** (MCP `analysis_meta` for metadata lists/governance). Use **this skill** for gateway-backed metadata detail and data-table/dimension-table operations; use **`ae-analysis`** for MCP metadata list/search, metrics, virtual create, and batch edit.
+
+## Global AE CLI Rules
+
+| Parameter | Description |
+|---|---|
+| `--format <json\|table>` | Output format. Default JSON. |
+| `--jq <expr>` | jq filter on JSON output. |
+| `--host <url>` | Override active AE host, e.g. `ae-cli metadata event get --host <url> ...`. |
+| `--dry-run` | Validate input against gateway schema without executing. |
+
+Output and errors:
+- Success: JSON envelope (default).
+- Failure: `{ "ok": false, "error": { "type", "message", "hint" } }`, non-zero exit.
+
+Safety:
+- Read-only commands can run directly after IDs/names are verified.
+- Write commands (`data-table *-write`, `*-delete`, `property-bindings-update`, dimension-table bind/create, `input-file upload`) require `--yes` for non-dry-run execution.
+- **Before any command**, read the matching `references/<name>.md` (filename = command with spaces → underscores, e.g. `metadata event get` → `metadata_event_get.md`).
+- Never invent `project_id`, event/property names, `input_file_id`, or `data_table_id`. Discover names via `ae-analysis` and data table IDs via `metadata data-table list`.
+
+## When to Use
+
+Switch to **`ae-metadata`** when the user needs:
+
+- Full detail for **one** super-event (incl. virtual event `definition`)
+- Full detail for **one** super-property (incl. virtual property `definition`)
+- Metadata data-table list/get/create/update/delete/download
+- Upload a local file to get `input_file_id`
+- Bind an existing data table to a property, or create a CSV dimension table and bind it
+
+Stay on **`ae-analysis`** for: metadata event/property/metric list/search, metric CRUD, batch metadata, virtual create, project config, tracking plans.
+
+## Command Format
+
+```bash
+ae-cli metadata <resource> <action> [options]
+ae-cli metadata property <dimension-table-action> [options]
+```
+
+- Commands and flags use **kebab-case**: `data-table`, `input-file`, `dimension-table`, `--project-id`, `--data-table-id`.
+- Gateway `input` body fields remain **snake_case** (`project_id`, `event_name`, …); ae-cli maps flags automatically.
+
+## PROJECT_ID_GATE
+
+Same rules as `ae-analysis`: reuse verified project context in one conversation; otherwise `ae-cli analysis_common +list_projects` (or `ae-analysis` skill) to resolve `project_id`.
+
+## Commands (13)
+
+| User command | Capability id | Reference |
+|---|---|---|
+| `metadata event get` | `metadata.event.get` | [metadata_event_get.md](references/metadata_event_get.md) |
+| `metadata property get` | `metadata.property.get` | [metadata_property_get.md](references/metadata_property_get.md) |
+| `metadata input-file upload` | `POST /input-files` | [metadata_input_file_upload.md](references/metadata_input_file_upload.md) |
+| `metadata data-table list` | `metadata.data_table.list` | [metadata_data_table_list.md](references/metadata_data_table_list.md) |
+| `metadata data-table get` | `metadata.data_table.get` | [metadata_data_table_get.md](references/metadata_data_table_get.md) |
+| `metadata data-table csv-write` | `metadata.data_table.csv_write` | [metadata_data_table_csv_write.md](references/metadata_data_table_csv_write.md) |
+| `metadata data-table sql-write` | `metadata.data_table.sql_write` | [metadata_data_table_sql_write.md](references/metadata_data_table_sql_write.md) |
+| `metadata data-table csv-delete` | `metadata.data_table.csv_delete` | [metadata_data_table_csv_delete.md](references/metadata_data_table_csv_delete.md) |
+| `metadata data-table sql-delete` | `metadata.data_table.sql_delete` | [metadata_data_table_sql_delete.md](references/metadata_data_table_sql_delete.md) |
+| `metadata data-table download` | `metadata.data_table.download` | [metadata_data_table_download.md](references/metadata_data_table_download.md) |
+| `metadata data-table property-bindings-update` | `metadata.data_table.property_bindings_update` | [metadata_data_table_property_bindings_update.md](references/metadata_data_table_property_bindings_update.md) |
+| `metadata property bind-existing-dimension-table` | `metadata.property.bind_existing_dimension_table` | [metadata_property_dimension_table_bind_existing.md](references/metadata_property_dimension_table_bind_existing.md) |
+| `metadata property create-and-bind-csv-dimension-table` | `metadata.property.create_and_bind_csv_dimension_table` | [metadata_property_dimension_table_create_and_bind_csv.md](references/metadata_property_dimension_table_create_and_bind_csv.md) |
+
+## Quick Verification
+
+```bash
+ae-cli metadata --help
+ae-cli metadata event get --help
+ae-cli metadata property get --help
+ae-cli metadata data-table list --help
+ae-cli metadata event get --project-id 1 --event-name <name> --dry-run
+ae-cli metadata data-table list --project-id 1 --dry-run
+```
+
+## Related Skills
+
+- **`ae-analysis`**: `analysis_meta +list_events` / `+list_properties` to discover names before detail get.
+- **Dev workflow**: `.cursor/skills/te-cli-capability-gateway` — inspect gateway schema when adding new metadata capabilities.

package/skills/ae-metadata/references/metadata_data_table_csv_delete.md

@@ -0,0 +1,15 @@
+# metadata data-table csv-delete
+
+> Capability id: `metadata.data_table.csv_delete` · Domain: `metadata`.
+
+```bash
+ae-cli metadata data-table csv-delete --project-id <project_id> --data-table-id <id> --yes
+ae-cli metadata data-table csv-delete --project-id <project_id> --data-table-id <id> --dry-run
+```
+
+| Parameter | Required | Description |
+|---|---|---|
+| `--project-id` / `-p` | Yes | Numeric project ID. |
+| `--data-table-id` | Yes | CSV-backed data table ID. |
+
+This is a write command. Confirm the table with `metadata data-table get` before deleting.

package/skills/ae-metadata/references/metadata_data_table_csv_write.md

@@ -0,0 +1,29 @@
+# metadata data-table csv-write
+
+> Capability id: `metadata.data_table.csv_write` · Domain: `metadata`.
+
+## Command
+
+```bash
+ae-cli metadata data-table csv-write --project-id <project_id> --operation create --input-file-id <input_file_id> --data-table-name <name> --columns '<columns_json>' --yes
+ae-cli metadata data-table csv-write --project-id <project_id> --operation incremental_update --data-table-id <id> --input-file-id <input_file_id> --yes
+ae-cli metadata data-table csv-write --project-id <project_id> --operation replace_update --data-table-id <id> --input-file-id <input_file_id> --yes
+```
+
+## Parameters
+
+| Parameter | Required | Description |
+|---|---|---|
+| `--project-id` / `-p` | Yes | Numeric project ID. |
+| `--operation` | Yes | `create`, `incremental_update`, or `replace_update`. |
+| `--input-file-id` | Yes | ID returned by `metadata input-file upload`. |
+| `--data-table-id` | For updates | Existing data table ID. |
+| `--data-table-name` | For create | Technical data table name. |
+| `--display-name` | No | Human-readable table name. |
+| `--description` | No | Table description. |
+| `--columns` | No | Column definitions JSON array. |
+
+## Decision Rules
+
+- Upload the CSV first with `metadata input-file upload --purpose data_table.csv`.
+- This is a write command; use `--dry-run` before non-dry-run and pass `--yes` when executing.

package/skills/ae-metadata/references/metadata_data_table_download.md

@@ -0,0 +1,17 @@
+# metadata data-table download
+
+> Capability id: `metadata.data_table.download` · Domain: `metadata`.
+
+```bash
+ae-cli metadata data-table download --project-id <project_id> --data-table-id <id>
+ae-cli metadata data-table download --project-id <project_id> --data-table-id <id> --request-id cli_0123456789abcdef0123456789abcdef --timeout-seconds 120
+```
+
+| Parameter | Required | Description |
+|---|---|---|
+| `--project-id` / `-p` | Yes | Numeric project ID. |
+| `--data-table-id` | Yes | Data table ID. |
+| `--request-id` | No | Optional `cli_<32 lowercase hex>` request ID. |
+| `--timeout-seconds` | No | Timeout in seconds, 1 to 7200. |
+
+Use this command when the user needs an exported data-table artifact.

package/skills/ae-metadata/references/metadata_data_table_get.md

@@ -0,0 +1,24 @@
+# metadata data-table get
+
+> Capability id: `metadata.data_table.get` · Domain: `metadata`.
+
+## Command
+
+```bash
+ae-cli metadata data-table get --project-id <project_id> --data-table-id <id>
+ae-cli metadata data-table get --project-id <project_id> --data-table-id <id> --include-preview true
+```
+
+## Parameters
+
+| Parameter | Required | Description |
+|---|---|---|
+| `--project-id` / `-p` | Yes | Numeric project ID. |
+| `--data-table-id` | Yes | Data table ID from `metadata data-table list`. |
+| `--include-preview` | No | Include preview rows when true. |
+
+## Request Body
+
+```json
+{ "project_id": 1, "data_table_id": 42, "include_preview": true }
+```

package/skills/ae-metadata/references/metadata_data_table_list.md

@@ -0,0 +1,27 @@
+# metadata data-table list
+
+> Capability id: `metadata.data_table.list` · Domain: `metadata`.
+
+## Command
+
+```bash
+ae-cli metadata data-table list --project-id <project_id>
+ae-cli metadata data-table list --project-id <project_id> --dry-run
+```
+
+## Parameters
+
+| Parameter | Required | Description |
+|---|---|---|
+| `--project-id` / `-p` | Yes | Numeric project ID. |
+
+## Request Body
+
+```json
+{ "project_id": 1 }
+```
+
+## Decision Rules
+
+- Use this command to discover `data_table_id` before get, delete, download, or property binding.
+- If the list is empty, do not invent IDs; create/upload a table first or ask for the target table.

package/skills/ae-metadata/references/metadata_data_table_property_bindings_update.md

@@ -0,0 +1,17 @@
+# metadata data-table property-bindings-update
+
+> Capability id: `metadata.data_table.property_bindings_update` · Domain: `metadata`.
+
+```bash
+ae-cli metadata data-table property-bindings-update --project-id <project_id> --data-table-id <id> --bind-properties '<bind_json>' --yes
+ae-cli metadata data-table property-bindings-update --project-id <project_id> --data-table-id <id> --unbind-properties '<unbind_json>' --yes
+```
+
+| Parameter | Required | Description |
+|---|---|---|
+| `--project-id` / `-p` | Yes | Numeric project ID. |
+| `--data-table-id` | Yes | Data table ID. |
+| `--bind-properties` | No | Properties to bind JSON array. Each item includes `property_name` and `property_scope`. |
+| `--unbind-properties` | No | Properties to unbind JSON array. Each item includes `property_name` and `property_scope`. |
+
+This is a write command. Use the direct property dimension-table commands when binding a single property is the user-facing goal.

package/skills/ae-metadata/references/metadata_data_table_sql_delete.md

@@ -0,0 +1,15 @@
+# metadata data-table sql-delete
+
+> Capability id: `metadata.data_table.sql_delete` · Domain: `metadata`.
+
+```bash
+ae-cli metadata data-table sql-delete --project-id <project_id> --data-table-id <id> --yes
+ae-cli metadata data-table sql-delete --project-id <project_id> --data-table-id <id> --dry-run
+```
+
+| Parameter | Required | Description |
+|---|---|---|
+| `--project-id` / `-p` | Yes | Numeric project ID. |
+| `--data-table-id` | Yes | SQL-backed data table ID. |
+
+This is a write command. Confirm the table with `metadata data-table get` before deleting.