@thinkingai/ae-cli 6.0.20 → 6.0.24

package/dist/index.js

@@ -1,28 +1,33 @@
 import {
   TeAgentApiError,
   TeAgentCredentialsError
-} from "./chunk-I5CRVM2S.js";
+} from "./chunk-4FQ36OGO.js";
 import {
   printError,
   printOutput
-} from "./chunk-2DUEAXV3.js";
+} from "./chunk-ONOA6DYB.js";
 import {
-  httpGet
-} from "./chunk-BJX3GXWC.js";
+  CapabilityGatewayError,
+  executeCapability,
+  uploadInputFileBytes
+} from "./chunk-2OW2RENH.js";
 import {
   PermissionError
 } from "./chunk-NOO24N7W.js";
+import {
+  clearCliToken,
+  getCliToken
+} from "./chunk-OCQPQYHZ.js";
 import {
   SecureStoreAuthError,
-  getToken,
   resolveHost
-} from "./chunk-RSHMZ3LG.js";
+} from "./chunk-PFJFZVCK.js";
 import {
   getActiveHost,
   getConfigDir,
   logger,
   safeJsonParse
-} from "./chunk-6W4QOZAL.js";
+} from "./chunk-65DKFJZB.js";
 
 // src/index.ts
 import { Command as CommanderCommand } from "commander";
@@ -33,13 +38,13 @@ import * as readline from "readline";
 async function runCommand(cmd, opts, globalOpts) {
   try {
     const ctx = createRuntimeContext(cmd, opts, globalOpts);
-    const cmdName = `${cmd.service} ${cmd.command}`;
+    const cmdName = cmd.resource ? `${cmd.service} ${cmd.resource} ${cmd.command}` : `${cmd.service} ${cmd.command}`;
     logger.command(cmdName, opts);
     for (const flag of cmd.flags) {
       if (flag.required) {
         const val = opts[camelCase(flag.name)];
         if (val === void 0 || val === null || val === "") {
-          printError("validation", `Missing required flag: --${flag.name}`, `Usage: ae-cli ${cmd.service} ${cmd.command} --${flag.name} <value>`);
+          printError("validation", `Missing required flag: --${flag.name}`, `Usage: ae-cli ${cmdName} --${flag.name} <value>`);
           process.exit(1);
         }
       }
@@ -71,7 +76,7 @@ async function runCommand(cmd, opts, globalOpts) {
       return;
     }
     if (cmd.risk === "write" && !globalOpts.yes) {
-      const confirmed = await confirm(`This is a write operation (${cmd.service} ${cmd.command}). Continue?`);
+      const confirmed = await confirm(`This is a write operation (${cmdName}). Continue?`);
       if (!confirmed) {
         process.stderr.write("Aborted.\n");
         process.exit(0);
@@ -86,6 +91,8 @@ async function runCommand(cmd, opts, globalOpts) {
       printError("config", message, err.hint);
     } else if (err instanceof PermissionError) {
       printError("permission", message);
+    } else if (err instanceof CapabilityGatewayError) {
+      printError("api", message, err.hint, err.code);
     } else if (err instanceof SecureStoreAuthError) {
       printError("auth", message, "Run: ae-cli auth login");
     } else if (err instanceof TeAgentApiError) {
@@ -113,7 +120,7 @@ function createRuntimeContext(cmd, opts, globalOpts) {
   let _clientModule = null;
   async function getClient() {
     if (!_clientModule) {
-      _clientModule = await import("./client-2UJ63MVQ.js");
+      _clientModule = await import("./client-7L735LVY.js");
     }
     return _clientModule;
   }
@@ -161,8 +168,8 @@ function createRuntimeContext(cmd, opts, globalOpts) {
       return client.queryReportData(projectId, reportId, qp, eventModel, options, ctx.host());
     },
     async token() {
-      const { getToken: getToken2 } = await import("./auth-DYC2BGLM.js");
-      return getToken2(ctx.host());
+      const { getToken } = await import("./auth-IDPKDFSY.js");
+      return getToken(ctx.host());
     },
     host() {
       if (globalOpts.host) return globalOpts.host;
@@ -185,10 +192,10 @@ function camelCase(str) {
 }
 async function confirm(message) {
   const rl = readline.createInterface({ input: process.stdin, output: process.stderr });
-  return new Promise((resolve2) => {
+  return new Promise((resolve3) => {
     rl.question(`${message} [y/N] `, (answer) => {
       rl.close();
-      resolve2(answer.toLowerCase() === "y" || answer.toLowerCase() === "yes");
+      resolve3(answer.toLowerCase() === "y" || answer.toLowerCase() === "yes");
     });
   });
 }
@@ -207,7 +214,15 @@ function registerCommands(program2, commands) {
       serviceCmd = program2.command(service).description(`${service} domain commands`);
     }
     for (const cmd of cmds) {
-      const sub = serviceCmd.command(cmd.command).description(cmd.description);
+      let parent = serviceCmd;
+      if (cmd.resource) {
+        let resourceCmd = serviceCmd.commands.find((c) => c.name() === cmd.resource);
+        if (!resourceCmd) {
+          resourceCmd = serviceCmd.command(cmd.resource).description(`${cmd.resource} commands`);
+        }
+        parent = resourceCmd;
+      }
+      const sub = parent.command(cmd.command).description(cmd.description);
       for (const flag of cmd.flags) {
         const flagStr = buildFlagString(flag);
         if (flag.type === "boolean") {
@@ -403,7 +418,7 @@ function notifyIfUpdateAvailable(pkg2) {
 
 // src/commands/tracking/plan.ts
 import { readFile, writeFile, cp } from "fs/promises";
-import path3, { resolve } from "path";
+import path3, { resolve as resolve2 } from "path";
 
 // src/tracking/xlsx/write.ts
 import ExcelJS from "exceljs";
@@ -1016,30 +1031,13 @@ async function writeDraftXlsx(d, outPath, locale = "zh") {
   await workbook.xlsx.writeFile(outPath);
 }
 
-// src/tracking/i18n/ae-locale.ts
-function aeLocaleToCli(raw) {
-  const normalized = raw.trim().replace("-", "_").toLowerCase();
-  if (normalized.startsWith("zh")) return "zh";
-  if (normalized.startsWith("en")) return "en";
-  if (normalized.startsWith("ja")) return "ja";
-  if (normalized.startsWith("ko")) return "ko";
-  return null;
-}
-function cliLocaleToAE(locale) {
-  switch (locale) {
-    case "zh":
-      return "zh_CN";
-    case "en":
-      return "en_US";
-    case "ja":
-      return "ja_JP";
-    case "ko":
-      return "ko_KR";
-  }
-}
-
 // src/core/tracking-client.ts
 var DEBUG_BASE = "/v1/ta/bury/manage/debug";
+var TRACK_CAPABILITY_DOMAIN = "analysis";
+var TRACK_PROGRAM_QUERY = "track.program.query";
+var TRACK_PROGRAM_DELETE = "track.program.delete";
+var TRACK_PROGRAM_EXCEL_SAVE = "track.program.excel_save";
+var TRACK_PROGRAM_XLSX_PURPOSE = "track.program.xlsx";
 function buildUrl(host, modulePath, params = {}) {
   const base = host.replace(/\/$/, "");
   const p = modulePath.startsWith("/") ? modulePath : `/${modulePath}`;
@@ -1049,89 +1047,185 @@ function buildUrl(host, modulePath, params = {}) {
   }
   return url.toString();
 }
-function extractLangFromConfig(data) {
+function record(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : null;
+}
+function pick(source, camelKey, snakeKey) {
+  return source[camelKey] ?? source[snakeKey];
+}
+function stringArray(value) {
+  return Array.isArray(value) ? value.filter((item) => typeof item === "string") : [];
+}
+function mapArray(value, mapper) {
+  return Array.isArray(value) ? value.map(record).filter((item) => item !== null).map(mapper) : [];
+}
+function normalizeProperty(value) {
+  return {
+    name: value.name,
+    displayName: pick(value, "displayName", "display_name"),
+    type: value.type,
+    desc: value.desc,
+    createTime: pick(value, "createTime", "create_time"),
+    creator: value.creator,
+    lastUpdateAuth: pick(value, "lastUpdateAuth", "last_update_auth"),
+    lastUpdateTime: pick(value, "lastUpdateTime", "last_update_time"),
+    hasReported: pick(value, "hasReported", "has_reported")
+  };
+}
+function normalizeUserProperty(value) {
+  return {
+    ...normalizeProperty(value),
+    propTag: pick(value, "propTag", "prop_tag"),
+    updateType: pick(value, "updateType", "update_type") ?? "user_set",
+    updateTypeName: pick(value, "updateTypeName", "update_type_name")
+  };
+}
+function normalizeEvent(value) {
+  return {
+    eventName: pick(value, "eventName", "event_name") ?? "",
+    displayName: pick(value, "displayName", "display_name"),
+    eventDesc: pick(value, "eventDesc", "event_desc"),
+    eventTag: pick(value, "eventTag", "event_tag"),
+    createTime: pick(value, "createTime", "create_time"),
+    creator: value.creator,
+    lastUpdateAuth: pick(value, "lastUpdateAuth", "last_update_auth"),
+    lastUpdateTime: pick(value, "lastUpdateTime", "last_update_time"),
+    hasReported: pick(value, "hasReported", "has_reported"),
+    props: stringArray(value.props),
+    propInfosOnEvent: pick(value, "propInfosOnEvent", "prop_infos_on_event")
+  };
+}
+function normalizeProgram(value) {
+  const data = record(value);
   if (!data) return null;
-  const raw = typeof data.lang === "string" && data.lang || typeof data.umi_locale === "string" && data.umi_locale || typeof data.locale === "string" && data.locale || null;
-  return raw ? aeLocaleToCli(raw) : null;
+  return {
+    projectId: pick(data, "projectId", "project_id") ?? 0,
+    createTime: pick(data, "createTime", "create_time"),
+    events: mapArray(data.events, normalizeEvent),
+    eventProps: mapArray(pick(data, "eventProps", "event_props"), normalizeProperty),
+    commonEventProps: mapArray(pick(data, "commonEventProps", "common_event_props"), normalizeProperty),
+    userProps: mapArray(pick(data, "userProps", "user_props"), normalizeUserProperty)
+  };
+}
+function normalizeUploadError(value) {
+  return {
+    errorType: pick(value, "errorType", "error_type") ?? "",
+    errorTypeDesc: pick(value, "errorTypeDesc", "error_type_desc") ?? "",
+    cellName: pick(value, "cellName", "cell_name") ?? "",
+    row: Number(value.row ?? 0),
+    value: String(value.value ?? "")
+  };
+}
+function normalizeUploadErrorMap(value) {
+  const data = record(value);
+  if (!data) return void 0;
+  const result = {};
+  for (const [key, items] of Object.entries(data)) {
+    result[key] = mapArray(items, normalizeUploadError);
+  }
+  return result;
+}
+function normalizeUploadResponse(value) {
+  const data = record(value);
+  if (!data) return { return_code: 0, return_message: "success" };
+  const responseData = record(data.data);
+  const uploadErrors = record(pick(data, "uploadErrors", "upload_errors")) ?? record(pick(responseData ?? {}, "uploadErrors", "upload_errors"));
+  const errorSource = uploadErrors ?? responseData ?? data;
+  const eventErrorMap = normalizeUploadErrorMap(pick(errorSource, "eventErrorMap", "event_error_map"));
+  const userErrorMap = normalizeUploadErrorMap(pick(errorSource, "userErrorMap", "user_error_map"));
+  const hasErrors = Boolean(
+    eventErrorMap && Object.keys(eventErrorMap).length > 0 || userErrorMap && Object.keys(userErrorMap).length > 0
+  );
+  return {
+    return_code: typeof data.return_code === "number" ? data.return_code : 0,
+    return_message: typeof data.return_message === "string" ? data.return_message : hasErrors ? "validation errors" : "success",
+    data: hasErrors ? { eventErrorMap, userErrorMap } : void 0
+  };
 }
 var TrackingClient = class {
-  constructor(host, token) {
+  constructor(host, cliToken) {
     this.host = host;
-    this.token = token;
+    this.cliToken = cliToken;
   }
   host;
-  token;
-  async resolveToken() {
-    return this.token ?? getToken(this.host);
+  cliToken;
+  async resolveCliToken() {
+    return this.cliToken ?? getCliToken(this.host);
+  }
+  async requestJson(modulePath, params = {}, body, method = body === void 0 ? "GET" : "POST", retry = true) {
+    const token = await this.resolveCliToken();
+    const url = buildUrl(this.host, modulePath, params);
+    const headers = {
+      "cli-token": token,
+      accept: "application/json"
+    };
+    const init = { method, headers };
+    if (body !== void 0 && method !== "GET") {
+      headers["content-type"] = "application/json";
+      init.body = JSON.stringify(body);
+    }
+    const resp = await fetch(url, init);
+    const env = safeJsonParse(await resp.text());
+    logger.api(method, url, resp.status, body, env);
+    if (resp.status === 401 && retry) {
+      clearCliToken(this.host);
+      this.cliToken = await getCliToken(this.host);
+      return this.requestJson(modulePath, params, body, method, false);
+    }
+    if (resp.status === 403) {
+      throw new Error(env?.return_message || "Permission denied");
+    }
+    if (!resp.ok) {
+      throw new Error(`AE API HTTP error: ${resp.status} ${resp.statusText}`);
+    }
+    if (env?.return_code === -1001 && retry) {
+      clearCliToken(this.host);
+      this.cliToken = await getCliToken(this.host);
+      return this.requestJson(modulePath, params, body, method, false);
+    }
+    if (env?.return_code !== 0 && env?.return_code !== void 0) {
+      throw new Error(env.return_message || `AE API error (code: ${env.return_code})`);
+    }
+    return env?.data;
   }
   async getProgram(projectId) {
-    const data = await httpGet(
-      "/v1/ta/bury/manage/program/query",
-      { projectId, "@t": Date.now() },
-      this.host
-    );
-    return data ?? null;
+    const data = await executeCapability(this.host, TRACK_CAPABILITY_DOMAIN, TRACK_PROGRAM_QUERY, {
+      project_id: projectId
+    });
+    return normalizeProgram(data);
   }
   async deleteProgram(projectId) {
-    const token = await this.resolveToken();
-    const url = buildUrl(this.host, "/v1/ta/bury/manage/program/delete", {
-      projectId,
-      "@t": Date.now()
+    await executeCapability(this.host, TRACK_CAPABILITY_DOMAIN, TRACK_PROGRAM_DELETE, {
+      project_id: projectId
     });
-    const resp = await fetch(url, {
-      method: "GET",
-      headers: {
-        authorization: `bearer ${token}`,
-        accept: "application/json"
-      }
-    });
-    const env = safeJsonParse(await resp.text());
-    if (env.return_code !== 0) {
-      throw new Error(env.return_message || `AE API error (code: ${env.return_code})`);
-    }
-    return { return_code: env.return_code, return_message: env.return_message };
+    return { return_code: 0, return_message: "success" };
   }
   async uploadProgramExcel(args) {
-    const token = await this.resolveToken();
-    const form = new FormData();
-    form.append(
-      "file",
-      new Blob([new Uint8Array(args.file)], {
-        type: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
-      }),
-      args.filename
+    const inputFile = await uploadInputFileBytes(
+      this.host,
+      TRACK_CAPABILITY_DOMAIN,
+      args.projectId,
+      TRACK_PROGRAM_XLSX_PURPOSE,
+      args.file,
+      args.filename,
+      "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
     );
-    form.append("projectId", String(args.projectId));
-    form.append("access_token", token);
-    const url = buildUrl(this.host, "/v1/ta/bury/manage/program/excel-save");
-    const resp = await fetch(url, { method: "POST", body: form });
-    const env = safeJsonParse(await resp.text());
+    const inputFileId = inputFile?.input_file_id ?? inputFile?.inputFileId ?? inputFile?.id;
+    if (!inputFileId) {
+      throw new Error("Capability gateway input-file upload did not return input_file_id");
+    }
+    const data = await executeCapability(this.host, TRACK_CAPABILITY_DOMAIN, TRACK_PROGRAM_EXCEL_SAVE, {
+      project_id: args.projectId,
+      input_file_id: inputFileId
+    });
+    const env = normalizeUploadResponse(data);
     if (env.return_code !== 0 && env.return_code !== void 0 && !env.data?.eventErrorMap && !env.data?.userErrorMap) {
       logger.error(`Upload failed: ${env.return_message || `AE API error (code: ${env.return_code})`}`);
     }
     return env;
   }
-  async getUserAutoConfig() {
-    const data = await httpGet(
-      "/v1/ta/auto/config/getUserAutoConfig",
-      { "@t": Date.now() },
-      this.host
-    );
-    if (data && typeof data === "object") {
-      return data;
-    }
-    return null;
-  }
-  async getServerLang() {
-    const config = await this.getUserAutoConfig();
-    return extractLangFromConfig(config);
-  }
-  /** lang format: zh_CN, en_US, ja_JP, ko_KR */
-  async saveUserAutoConfig(langCode) {
-    await httpGet("/v1/ta/auto/config/getUserAutoConfig", { "@t": Date.now(), lang: langCode }, this.host);
-  }
   async debugGet(path5, params) {
-    const data = await httpGet(`${DEBUG_BASE}${path5}`, { ...params, "@t": Date.now() }, this.host);
+    const data = await this.requestJson(`${DEBUG_BASE}${path5}`, { ...params, "@t": Date.now() });
     return data;
   }
   async listDevice(projectId) {
@@ -1157,8 +1251,7 @@ var TrackingClient = class {
   }
 };
 async function createTrackingClient(host) {
-  const token = await getToken(host);
-  return new TrackingClient(host, token);
+  return new TrackingClient(host);
 }
 
 // src/tracking/te-plan/fetch.ts
@@ -1746,23 +1839,70 @@ function formatConflictReport(result, existingSummary) {
 }
 
 // src/commands/tracking/plan.ts
+import { existsSync as existsSync5 } from "fs";
+
+// src/tracking/templates.ts
 import { readdir } from "fs/promises";
-import { existsSync as existsSync4 } from "fs";
+import { existsSync as existsSync3 } from "fs";
+import { resolve } from "path";
+function getTemplateDirs() {
+  return [
+    resolve(getPackageRoot(), "tracking-plan-template"),
+    resolve(getConfigDir(), "templates")
+  ];
+}
+async function listTrackingTemplates() {
+  const found = [];
+  for (const dir of getTemplateDirs()) {
+    if (!existsSync3(dir)) continue;
+    let entries = [];
+    try {
+      entries = await readdir(dir);
+    } catch {
+      continue;
+    }
+    for (const f of entries) {
+      if (!f.endsWith(".xlsx")) continue;
+      const base = f.replace(/\.xlsx$/i, "");
+      const mdPath = resolve(dir, base + ".md");
+      const hasMd = existsSync3(mdPath);
+      found.push({
+        path: hasMd ? mdPath : resolve(dir, f),
+        name: base,
+        hasMd
+      });
+    }
+  }
+  return found;
+}
+async function resolveTrackingTemplateByName(name) {
+  const normalized = name.trim().replace(/\.(md|xlsx)$/i, "");
+  const templates = await listTrackingTemplates();
+  const template = templates.find((item) => item.name === normalized);
+  if (!template) {
+    const available = templates.map((item) => item.name).join(", ");
+    throw new Error(
+      available ? `Template not found: ${name}. Available templates: ${available}` : `Template not found: ${name}. No tracking plan templates are available.`
+    );
+  }
+  return template;
+}
 
 // src/commands/tracking/shared.ts
-import { existsSync as existsSync3, statSync } from "fs";
+import { existsSync as existsSync4, statSync } from "fs";
 var HOST_OPTION_DESC = "Override active AE host URL";
 function resolveTrackingHost(program2, opts) {
   const root = program2.root ?? program2;
   const globalHost = root.opts()?.host;
-  const host = resolveHost(opts.host || globalHost);
+  const explicitHost = opts.host || globalHost;
+  const host = resolveHost(explicitHost);
   if (!host) {
     throw new Error("No active AE host configured. Run: ae-cli auth login");
   }
   return host;
 }
 function isExistingDirectory(path5) {
-  if (!existsSync3(path5)) return false;
+  if (!existsSync4(path5)) return false;
   try {
     return statSync(path5).isDirectory();
   } catch {
@@ -1778,7 +1918,7 @@ function assertOutputFilePath(path5, optionName = "--out") {
 }
 function assertInputFilePath(path5, optionName = "--in") {
   const trimmed = path5.trim();
-  if (!existsSync3(trimmed)) {
+  if (!existsSync4(trimmed)) {
     console.error(t("error.input_path_not_found", { path: trimmed, option: optionName }));
     process.exit(1);
   }
@@ -1790,10 +1930,6 @@ function assertInputFilePath(path5, optionName = "--in") {
 
 // src/commands/tracking/plan.ts
 var MAX_FIX_RETRIES = 3;
-var TEMPLATE_DIRS = [
-  resolve(getPackageRoot(), "tracking-plan-template"),
-  resolve(getConfigDir(), "templates")
-];
 function registerPlan(cmd, rootProgram) {
   cmd.description("manage AE tracking plans");
   cmd.command("draft").description("Generate xlsx from draft.json (inject autotrack events; use --fix to auto-repair validation errors)").requiredOption("--in <path>", "draft JSON input").requiredOption("--out <path>", "xlsx output").option("--fix", "auto fix validation errors", false).action(async (opts) => {
@@ -1871,27 +2007,12 @@ function registerPlan(cmd, rootProgram) {
       }
     }
   });
-  cmd.command("upload").description("Upload xlsx tracking plan to AE (conflict check, auto-fix retry, optional --switch-lang)").requiredOption("-p, --project <id>", "AE projectId", (v) => parseInt(v, 10)).requiredOption("--xlsx <path>", "xlsx file").requiredOption("--draft <path>", "draft JSON (for auto-fix)").option("--host <url>", HOST_OPTION_DESC).option("--lang <locale>", "xlsx language: zh / en / ja / ko").option("--replace", "delete existing plan first", false).option("--auto-fix", "auto fix upload errors and retry", true).option("--switch-lang", "auto switch AE project language to match xlsx", false).action(async (opts) => {
+  cmd.command("upload").description("Upload xlsx tracking plan to AE (conflict check, auto-fix retry)").requiredOption("-p, --project <id>", "AE projectId", (v) => parseInt(v, 10)).requiredOption("--xlsx <path>", "xlsx file").requiredOption("--draft <path>", "draft JSON (for auto-fix)").option("--host <url>", HOST_OPTION_DESC).option("--lang <locale>", "xlsx language: zh / en / ja / ko").option("--replace", "delete existing plan first", false).option("--auto-fix", "auto fix upload errors and retry", true).action(async (opts) => {
     assertInputFilePath(opts.draft, "--draft");
     assertInputFilePath(opts.xlsx, "--xlsx");
     const host = resolveTrackingHost(rootProgram, opts);
     let client = await createTrackingClient(host);
     const draftPre = JSON.parse(await readFile(opts.draft, "utf8"));
-    const xlsxLocale = opts.lang ?? draftPre.meta.lang ?? detectCliLocale();
-    const aeLocale = await client.getServerLang();
-    if (aeLocale && aeLocale !== xlsxLocale) {
-      console.log("\n" + t("plan.ae_lang_mismatch", { aeLang: aeLocale, xlsxLang: xlsxLocale }));
-      if (opts.switchLang) {
-        const aeLangCode = cliLocaleToAE(xlsxLocale);
-        await client.saveUserAutoConfig(aeLangCode);
-        console.log(t("plan.ae_lang_switched", { aeLang: aeLangCode }));
-        await new Promise((r) => setTimeout(r, 2e3));
-        client = await createTrackingClient(host);
-      } else {
-        console.log(t("plan.ae_lang_switch_hint"));
-        process.exit(13);
-      }
-    }
     if (!opts.replace) {
       console.log(t("plan.checking_conflicts"));
       try {
@@ -1931,7 +2052,7 @@ function registerPlan(cmd, rootProgram) {
     if (opts.replace) {
       const del = await client.deleteProgram(opts.project);
       console.log(t("plan.deleted_existing_plan", { message: del.return_message }));
-      await new Promise((resolve2) => setTimeout(resolve2, 5e3));
+      await new Promise((resolve3) => setTimeout(resolve3, 5e3));
     }
     let retryCount = 0;
     let draft = JSON.parse(await readFile(opts.draft, "utf8"));
@@ -1979,8 +2100,8 @@ function registerPlan(cmd, rootProgram) {
     const msg = lastRes?.return_message ?? "";
     const isLangMismatch = msg.includes("\u65E0\u6CD5\u8BC6\u522B\u8868\u683C\u5185\u5BB9") || msg.includes("The content of the form cannot be recognized") || msg.includes("\u30C6\u30FC\u30D6\u30EB\u306E\u5185\u5BB9\u3092\u8A8D\u8B58\u3067\u304D\u307E\u305B\u3093") || msg.includes("\uD2B8\uB798\uD0B9 \uBC29\uC548\uC744 \uC2E4\uBCC4 \uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4");
     if (lastRes && lastRes.return_code !== 0 && isLangMismatch) {
-      const xlsxLocale2 = opts.lang ?? draft.meta.lang ?? detectCliLocale();
-      console.log("\n" + t("plan.language_mismatch_hint", { locale: xlsxLocale2 }));
+      const xlsxLocale = opts.lang ?? draft.meta.lang ?? detectCliLocale();
+      console.log("\n" + t("plan.language_mismatch_hint", { locale: xlsxLocale }));
     }
   });
   cmd.command("fetch").description("Fetch tracking plan from AE and output draft.json").requiredOption("-p, --project <id>", "AE projectId", (v) => parseInt(v, 10)).option("--host <url>", HOST_OPTION_DESC).option("--out <path>", "write to file instead of stdout").action(async (opts) => {
@@ -1992,12 +2113,12 @@ function registerPlan(cmd, rootProgram) {
       await writeFile(opts.out, s, "utf8");
     } else process.stdout.write(s);
   });
-  cmd.command("archive").description("Copy draft.xlsx to plans/ and record archive metadata in draft.json").requiredOption("--draft <path>", "draft.json path").requiredOption("--xlsx <path>", "draft.xlsx path").requiredOption("--name <name>", "plan name for filename").option("--plans-dir <dir>", "plans output directory", resolve(process.cwd(), "plans")).action(async (opts) => {
+  cmd.command("archive").description("Copy draft.xlsx to plans/ and record archive metadata in draft.json").requiredOption("--draft <path>", "draft.json path").requiredOption("--xlsx <path>", "draft.xlsx path").requiredOption("--name <name>", "plan name for filename").option("--plans-dir <dir>", "plans output directory", resolve2(process.cwd(), "plans")).action(async (opts) => {
     assertInputFilePath(opts.draft, "--draft");
     assertInputFilePath(opts.xlsx, "--xlsx");
     const stamp = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-    const dest = resolve(opts.plansDir, `${stamp}-${opts.name}.xlsx`);
-    if (existsSync4(dest)) {
+    const dest = resolve2(opts.plansDir, `${stamp}-${opts.name}.xlsx`);
+    if (existsSync5(dest)) {
       console.error(t("plan.archive_exists", { path: dest }));
       console.error(t("plan.remove_or_rename"));
       return;
@@ -2025,30 +2146,14 @@ function registerPlan(cmd, rootProgram) {
     const res = await client.deleteProgram(opts.project);
     console.log(JSON.stringify(res, null, 2));
   });
-  cmd.command("list-templates").description("List bundled and user tracking plan templates (xlsx/md)").action(async () => {
-    const found = [];
-    for (const dir of TEMPLATE_DIRS) {
-      if (!existsSync4(dir)) continue;
-      let entries = [];
-      try {
-        entries = await readdir(dir);
-      } catch {
-        continue;
-      }
-      for (const f of entries) {
-        if (!f.endsWith(".xlsx")) continue;
-        const base = f.replace(/\.xlsx$/i, "");
-        const mdPath = resolve(dir, base + ".md");
-        const hasMd = existsSync4(mdPath);
-        found.push({
-          path: hasMd ? mdPath : resolve(dir, f),
-          name: base,
-          hasMd
-        });
-      }
+  cmd.command("list-templates").description("List bundled and user tracking plan templates (xlsx/md)").option("--json", "print machine-readable template list", false).action(async (opts) => {
+    const found = await listTrackingTemplates();
+    if (opts.json) {
+      console.log(JSON.stringify(found, null, 2));
+      return;
     }
     if (found.length === 0) {
-      console.log(t("plan.no_templates_found", { dirs: TEMPLATE_DIRS.join(", ") }));
+      console.log(t("plan.no_templates_found", { dirs: getTemplateDirs().join(", ") }));
       return;
     }
     console.log(t("plan.templates_found", { count: found.length }) + "\n");
@@ -2742,10 +2847,17 @@ function inferSdkMode(events) {
 }
 function registerCode(cmd) {
   cmd.description("tooling for ae-generate-tracking-code skill");
-  const importTemplateCmd = cmd.command("import-template").description("Import a template file (md or xlsx) to draft.json, inferring sdk_integration_mode from events").requiredOption("--template <path>", "Path to template file (.md or .xlsx)").requiredOption("--out <path>", "Output path for draft.json").option("--sdk-type <type>", "Client SDK type (android/ios/openharmony/javascript/etc.)").option("--languages <langs>", "Client languages comma-separated (e.g., java,kotlin for android)").option("--server <lang>", "Server language (java/python/go/etc.)").action(async (opts) => {
-    assertInputFilePath(opts.template, "--template");
+  const importTemplateCmd = cmd.command("import-template").description("Import a template file (md or xlsx) to draft.json, inferring sdk_integration_mode from events").option("--template <path>", "Path to template file (.md or .xlsx)").option("--template-name <name>", "Built-in or user template name from tracking plan list-templates").requiredOption("--out <path>", "Output path for draft.json").option("--sdk-type <type>", "Client SDK type (android/ios/openharmony/javascript/etc.)").option("--languages <langs>", "Client languages comma-separated (e.g., java,kotlin for android)").option("--server <lang>", "Server language (java/python/go/etc.)").action(async (opts) => {
+    if (!opts.template && !opts.templateName) {
+      throw new Error("Either --template or --template-name is required");
+    }
+    if (opts.template && opts.templateName) {
+      throw new Error("Use only one of --template or --template-name");
+    }
     assertOutputFilePath(opts.out, "--out");
-    const draft = opts.template.endsWith(".md") ? await readTemplateMd(opts.template) : await readTemplateXlsx(opts.template);
+    const templatePath = opts.templateName ? (await resolveTrackingTemplateByName(opts.templateName)).path : opts.template;
+    assertInputFilePath(templatePath, opts.templateName ? "--template-name" : "--template");
+    const draft = templatePath.endsWith(".md") ? await readTemplateMd(templatePath) : await readTemplateXlsx(templatePath);
     const inferredMode = inferSdkMode(draft.events);
     if (inferredMode) {
       draft.meta.sdk_integration_mode = inferredMode;
@@ -2803,12 +2915,12 @@ function registerCode(cmd) {
 }
 
 // src/tracking/wiki-query/query.ts
-import { readFileSync as readFileSync3, existsSync as existsSync5 } from "fs";
+import { readFileSync as readFileSync3, existsSync as existsSync6 } from "fs";
 import { join as join4 } from "path";
 var WIKI_ROOT = join4(getPackageRoot(), "wiki/te-docs");
 function searchIndex(keyword) {
   const indexPath = join4(WIKI_ROOT, "index.md");
-  if (!existsSync5(indexPath)) return [];
+  if (!existsSync6(indexPath)) return [];
   const lines = readFileSync3(indexPath, "utf8").split("\n");
   const kw = keyword.toLowerCase();
   const hits = [];
@@ -2840,36 +2952,34 @@ function registerWiki(cmd) {
 // src/commands/tracking/lang.ts
 var SUPPORTED = ["zh", "en", "ja", "ko"];
 var SUPPORTED_LABELS = {
-  zh: "\u4E2D\u6587 (Chinese)",
+  zh: "Chinese",
   en: "English",
-  ja: "\u65E5\u672C\u8A9E (Japanese)",
-  ko: "\uD55C\uAD6D\uC5B4 (Korean)"
+  ja: "Japanese",
+  ko: "Korean"
 };
-function registerLang(cmd, rootProgram) {
-  cmd.description("manage AE server language for tracking commands");
-  cmd.command("set").description("set the AE server language").argument("<locale>", "language code: zh / en / ja / ko").option("--host <url>", HOST_OPTION_DESC).action(async (locale, opts) => {
+function registerLang(cmd, _rootProgram) {
+  cmd.description("manage local language hints for tracking commands");
+  cmd.command("status").description("show local language settings for tracking commands").action(() => {
+    const aeLang = process.env.AE_LANG?.trim() || "(unset)";
+    const lang = process.env.LANG?.trim() || "(unset)";
+    console.log("CLI language settings:");
+    console.log(`- AE_LANG: ${aeLang}`);
+    console.log(`- LANG: ${lang}`);
+    console.log(`- resolved: ${detectCliLocale()}`);
+  });
+  cmd.command("set").description("print the AE_LANG value to use for subsequent commands").argument("<locale>", "language code: zh / en / ja / ko").action((locale) => {
     const normalized = locale.trim().toLowerCase();
     if (!SUPPORTED.includes(normalized)) {
       console.error(`Unsupported language: "${locale}"`);
       console.error("Supported languages:");
       for (const code of SUPPORTED) {
-        console.error(`  ${code} \u2014 ${SUPPORTED_LABELS[code]}`);
+        console.error(`  ${code} - ${SUPPORTED_LABELS[code]}`);
       }
       process.exit(1);
     }
-    const host = resolveTrackingHost(rootProgram, opts);
-    const client = await createTrackingClient(host);
-    const aeCode = cliLocaleToAE(normalized);
-    await client.saveUserAutoConfig(aeCode);
-    process.stderr.write(`[ae-cli] Server language saved: ${aeCode}
-`);
-    const config = await client.getUserAutoConfig();
-    if (config) {
-      const serverLang = config.lang ?? config.umi_locale ?? config.locale;
-      console.log(`Server response: ${JSON.stringify({ lang: serverLang })}`);
-    } else {
-      console.log("Server response: (empty)");
-    }
+    console.log("Use this environment variable for subsequent commands:");
+    console.log(`export AE_LANG=${normalized}`);
+    console.log(`AE_LANG=${normalized} ae-cli tracking plan draft --in .ae-cli/draft.json --out .ae-cli/draft.xlsx`);
   });
 }
 
@@ -2891,88 +3001,93 @@ program.name("ae-cli").version(version).description("CLI tool for ThinkingAI (AE
 async function loadCommands() {
   const commands = [];
   try {
-    const teAnalysis = await import("./te-analysis-HJ22TUAA.js");
+    const teAnalysis = await import("./te-analysis-CRPFK3LX.js");
     commands.push(...teAnalysis.default);
   } catch {
   }
   try {
-    const teAudience = await import("./te-audience-MYDE5WEH.js");
+    const teAudience = await import("./te-audience-RO2IZOUC.js");
     commands.push(...teAudience.default);
   } catch {
   }
   try {
-    const teMeta = await import("./te-meta-JVO4QJBH.js");
+    const teMeta = await import("./te-meta-5ESSQ5B3.js");
     commands.push(...teMeta.default);
   } catch {
   }
   try {
-    const teCommon = await import("./te-common-WNCZB7R7.js");
+    const teCommon = await import("./te-common-PUXBUPOL.js");
     commands.push(...teCommon.default);
   } catch {
   }
   try {
-    const engage = await import("./te-engage-4XHCTS6I.js");
+    const engage = await import("./te-engage-YPQIVF5H.js");
     commands.push(...engage.default);
   } catch {
   }
   try {
-    const community = await import("./te-community-JEEFXPB3.js");
+    const community = await import("./te-community-NPDZQKMY.js");
     commands.push(...community.default);
   } catch {
   }
   try {
-    const dataops = await import("./te-dataops-ZTS7XMXM.js");
+    const dataops = await import("./te-dataops-6KWLFNV4.js");
     commands.push(...dataops.default);
   } catch {
   }
   try {
-    const teKb = await import("./te-kb-OWM3RQRH.js");
+    const teKb = await import("./te-kb-DOGDQIU4.js");
     commands.push(...teKb.default);
   } catch {
   }
   try {
-    const teTeam = await import("./te-team-YY24VORI.js");
+    const teTeam = await import("./te-team-SOVKZIDD.js");
     commands.push(...teTeam.default);
   } catch {
   }
   try {
-    const teAgent = await import("./te-agent-CYZUC4US.js");
+    const teAgent = await import("./te-agent-OYNNTJDU.js");
     commands.push(...teAgent.default);
   } catch {
   }
+  try {
+    const metadata = await import("./metadata-XWTEGEN2.js");
+    commands.push(...metadata.default);
+  } catch {
+  }
   return commands;
 }
 async function registerAuthCommands() {
   try {
-    const { registerAuth } = await import("./auth-GHBMJ5ZR.js");
+    const { registerAuth } = await import("./auth-A2XXG5K4.js");
     registerAuth(program);
   } catch {
   }
 }
 async function registerConfigCommands() {
   try {
-    const { registerConfig } = await import("./config-NCUGK6NS.js");
+    const { registerConfig } = await import("./config-SXD2JKSL.js");
     registerConfig(program);
   } catch {
   }
 }
 async function registerApiCommand() {
   try {
-    const { registerApi } = await import("./raw-7NVWSVJP.js");
+    const { registerApi } = await import("./raw-IANB4AV5.js");
     registerApi(program);
   } catch {
   }
 }
 async function registerSyncCommand() {
   try {
-    const { registerSync } = await import("./sync-GRVO4K3U.js");
+    const { registerSync } = await import("./sync-4HQ3CXSK.js");
     registerSync(program);
   } catch {
   }
 }
 async function registerModelCommand() {
   try {
-    const { registerModel } = await import("./model-SJSOZTRS.js");
+    const { registerModel } = await import("./model-3OVX42DA.js");
     registerModel(program);
   } catch {
   }