@thinkingai/ae-cli 6.0.31 → 6.0.32

package/README.md

@@ -95,7 +95,7 @@ ae-cli auth logout
 | `community` | 10+ | Community analysis: posts search, sentiment analysis, topic trends, livestream data |
 | `analysis_common` | 2 | Cross-module common constraints: resource link completion, project ID gate |
 | `team` | 14 | AI Agent Team: manage teams (list/create/update/delete/ai-generate/templates/projects) and execute TeamRuns (start/watch/chat/reply/cancel/result/artifacts) |
-| `kb` | 10 | Knowledge base lifecycle: query / new / add (md/dir/url) / schema / compile / rm-source / remove; retrieval primitives: index / grep / read |
+| `kb` | 11 | Knowledge base lifecycle: query / new / add (md/dir/url) / schema / compile / rm-source / remove; retrieval primitives: list / index / grep / read |
 | `auth` / `config` | 2 | Authentication and host configuration |
 
 ### kb
@@ -111,8 +111,9 @@ Knowledge base lifecycle (`+new` → `+add` → `+schema` → `+compile` → `+s
 - **Remove source** (`+rm-source`): `--name`, `--display-name`
 - **Remove KB** (`+remove`): `--name`
 
-Retrieval primitives for external agents (`+index` → `+grep` → `+read`); these are deterministic file-search endpoints with no server-side LLM, designed for agents (Claude Code / Codex / Cursor) to explore a KB the way they explore a codebase:
+Retrieval primitives for external agents (`+list` → `+index` → `+grep` → `+read`); these are deterministic file-search endpoints with no server-side LLM, designed for agents (Claude Code / Codex / Cursor) to explore a KB the way they explore a codebase:
 
+- **List** (`+list`): optional `--build-status` (default `compiled`), optional `--locale`. Returns accessible knowledge base metadata including `buildStatus`, without `index.md` navigation maps.
 - **Index** (`+index`): optional `--sources` JSON refs (omit to list all accessible KBs), optional `--locale`. Returns each KB's metadata plus its `index.md` navigation map.
 - **Grep** (`+grep`): `--query` / `-q`, optional `--sources`, `--top-k` (1-50, default 10), `--locale`. Returns matched lines with path, line number, breadcrumb and context snippet.
 - **Read** (`+read`): `--source` JSON ref (exactly one KB), `--path` (page path relative to the KB root), optional `--offset` / `--limit` (line window), `--locale`. Returns the full page or a line window.

package/README.zh.md

@@ -96,7 +96,7 @@ ae-cli auth logout
 | `analysis_common` | 2 | 跨模块通用约束：资源链接补全、项目 ID 门控 |
 | `agent` | 15 | Agent 平台资源管理：模型、MCP 服务、Skill、附件库的增删查和启停 |
 | `team` | 14 | AI Agent Team：团队管理（列表/创建/更新/删除/AI生成/模板/项目）和 TeamRun 执行（启动/监听/对话/回复/取消/结果/产物） |
-| `kb` | 10 | 知识库生命周期：查询 / 新建 / 添加源（md/目录/url）/ schema / 编译 / 删除源 / 删除；检索原语：index / grep / read |
+| `kb` | 11 | 知识库生命周期：查询 / 新建 / 添加源（md/目录/url）/ schema / 编译 / 删除源 / 删除；检索原语：list / index / grep / read |
 | `auth` / `config` | 2 | 身份验证和主机配置 |
 
 ### kb（知识库）
@@ -112,8 +112,9 @@ ae-cli auth logout
 - **删除源** (`+rm-source`)：`--name`，`--display-name`
 - **删除知识库** (`+remove`)：`--name`
 
-面向外部 agent 的检索原语（`+index` → `+grep` → `+read`）；均为确定性文件检索端点、服务端零 LLM 调用，让 agent（Claude Code / Codex / Cursor）像翻代码库一样探索知识库：
+面向外部 agent 的检索原语（`+list` → `+index` → `+grep` → `+read`）；均为确定性文件检索端点、服务端零 LLM 调用，让 agent（Claude Code / Codex / Cursor）像翻代码库一样探索知识库：
 
+- **列表** (`+list`)：可选 `--build-status`（默认 `compiled`）、`--locale`。返回可访问知识库的元信息（含 `buildStatus`），不含 `index.md` 导航地图。
 - **索引** (`+index`)：可选 `--sources` JSON 引用（省略则列出全部可访问知识库），可选 `--locale`。返回每个知识库的元信息及其 `index.md` 导航地图。
 - **检索** (`+grep`)：`--query` / `-q`，可选 `--sources`、`--top-k`（1-50，默认 10）、`--locale`。返回命中行的路径、行号、面包屑与上下文片段。
 - **读取** (`+read`)：`--source` JSON 引用（精确指向一个知识库），`--path`（相对知识库根目录的页面路径），可选 `--offset` / `--limit`（行窗口）、`--locale`。返回页面全文或行窗口。

package/dist/{capability-SQ2IWKP3.js → capability-QW4AVJHI.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-OO6XR6LK.js";
 import {
   findGatewayDomain
-} from "./chunk-HL2AJQ4Q.js";
+} from "./chunk-PTE56QPL.js";
 import {
   CapabilityGatewayError,
   dryRunCapability,

package/dist/{capability-SEH3JWLN.js → capability-SCRFGODD.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-OO6XR6LK.js";
 import {
   findGatewayDomain
-} from "./chunk-HL2AJQ4Q.js";
+} from "./chunk-PTE56QPL.js";
 import {
   CapabilityGatewayError,
   dryRunCapability,

package/dist/{chunk-N2QORU5D.js → chunk-7OLGDQQ2.js}

@@ -1,6 +1,6 @@
 import {
   resolveGatewayDomain
-} from "./chunk-HL2AJQ4Q.js";
+} from "./chunk-PTE56QPL.js";
 import {
   dryRunCapability,
   executeCapabilityWithEnvelope,
@@ -22,6 +22,9 @@ function createCapabilityCommand(config) {
     flags: config.flags,
     risk: config.risk,
     validate: config.validate,
+    preflight: (ctx) => {
+      config.buildInput(ctx);
+    },
     validateInput: async (ctx) => {
       const gatewayDomain = resolveGatewayDomain(config.cliService, config.gatewayDomain);
       const requestHost = config.requestHost ?? ctx.host();
@@ -40,7 +43,7 @@ function createCapabilityCommand(config) {
       const input = withLifecycleRequestId(config, config.buildInput(ctx));
       announceDispatch(config.capabilityId, input);
       const result = await executeCapabilityWithEnvelope(requestHost, gatewayDomain, config.capabilityId, input);
-      const data = config.postProcess ? config.postProcess(result.data, input) : result.data;
+      const data = config.postProcess ? config.postProcess(result.data, input, ctx) : result.data;
       return withOutputMetadata(data, result.meta);
     }
   };

package/dist/{chunk-TKQJQXWT.js → chunk-TBHBYKXZ.js}

@@ -1,6 +1,6 @@
 import {
   resolveGatewayDomain
-} from "./chunk-HL2AJQ4Q.js";
+} from "./chunk-PTE56QPL.js";
 import {
   dryRunCapability,
   executeCapabilityWithEnvelope,
@@ -22,6 +22,9 @@ function createCapabilityCommand(config) {
     flags: config.flags,
     risk: config.risk,
     validate: config.validate,
+    preflight: (ctx) => {
+      config.buildInput(ctx);
+    },
     validateInput: async (ctx) => {
       const gatewayDomain = resolveGatewayDomain(config.cliService, config.gatewayDomain);
       const requestHost = config.requestHost ?? ctx.host();
@@ -40,7 +43,7 @@ function createCapabilityCommand(config) {
       const input = withLifecycleRequestId(config, config.buildInput(ctx));
       announceDispatch(config.capabilityId, input);
       const result = await executeCapabilityWithEnvelope(requestHost, gatewayDomain, config.capabilityId, input);
-      const data = config.postProcess ? config.postProcess(result.data, input) : result.data;
+      const data = config.postProcess ? config.postProcess(result.data, input, ctx) : result.data;
       return withOutputMetadata(data, result.meta);
     }
   };

package/dist/index.js

@@ -38,27 +38,42 @@ import { createRequire } from "module";
 
 // src/framework/runner.ts
 import * as readline from "readline";
+function missingRequiredFlagsError(cmdName, missing) {
+  const names = missing.map((flag) => `--${flag.name}`);
+  const message = missing.length === 1 ? `Missing required flag: ${names[0]}` : `Missing required flags: ${names.join(", ")}`;
+  const hintParts = missing.map((flag) => flag.hint?.trim()).filter((hint2) => Boolean(hint2));
+  const hint = hintParts.length > 0 ? hintParts.join(" ") : `Usage: ae-cli ${cmdName} ${names.map((name) => `${name} <value>`).join(" ")}`;
+  return { message, hint };
+}
 async function runCommand(cmd, opts, globalOpts) {
   try {
     const ctx = createRuntimeContext(cmd, opts, globalOpts);
     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 ${cmdName} --${flag.name} <value>`);
-          process.exit(1);
-        }
-      }
+    const missingRequired = cmd.flags.filter((flag) => {
+      if (!flag.required) return false;
+      const val = opts[camelCase(flag.name)];
+      return val === void 0 || val === null || val === "";
+    });
+    if (missingRequired.length > 0) {
+      const { message, hint } = missingRequiredFlagsError(cmdName, missingRequired);
+      printError("validation", message, hint);
+      process.exit(1);
     }
     if (cmd.validate) {
       cmd.validate(ctx);
     }
     const LIMIT_FLAG_PATTERNS = [/limit/i, /page_size/i, /pagesize/i, /row_limit/i, /block_limit/i, /top[-_]?k/i];
     for (const flag of cmd.flags) {
-      if (flag.type !== "number") continue;
       const val = opts[camelCase(flag.name)];
+      if (flag.type === "boolean") {
+        if (val !== void 0 && typeof val !== "boolean") {
+          printError("validation", `Invalid boolean for --${flag.name}: ${val}. Use true/false.`);
+          process.exit(1);
+        }
+        continue;
+      }
+      if (flag.type !== "number") continue;
       if (val === void 0 || val === null || val === "") continue;
       const num = Number(val);
       if (!Number.isFinite(num)) {
@@ -113,11 +128,14 @@ async function runCommand(cmd, opts, globalOpts) {
       }
       return;
     }
-    if (requiresConfirmation(cmd.risk) && !globalOpts.yes) {
-      const confirmed = await confirm(`This is a high-risk-write operation (${cmdName}). Continue?`);
-      if (!confirmed) {
-        process.stderr.write("Aborted.\n");
-        process.exit(0);
+    if (requiresConfirmation(cmd.risk)) {
+      cmd.preflight?.(ctx);
+      if (!globalOpts.yes) {
+        const confirmed = await confirm(`This is a high-risk-write operation (${cmdName}). Continue?`);
+        if (!confirmed) {
+          process.stderr.write("Aborted.\n");
+          process.exit(0);
+        }
       }
     }
     const result = await cmd.execute(ctx);
@@ -154,6 +172,9 @@ async function runCommand(cmd, opts, globalOpts) {
   }
 }
 function capabilityGatewayHint(err) {
+  if (err.code === "UPLOAD_NOT_EXIST" && (err.meta?.capability_id === "engage-setting.config-table.save" || err.meta?.capability_id === "engage-setting.config-table.update-data")) {
+    return "Run config-table upload first with the same --project-id and --request-id, then retry this command within 10 minutes. The upload cache is consumed after a successful save/update.";
+  }
   if (err.code === "CAPABILITY_NOT_FOUND") {
     return "The current host does not expose this capability. Do not retry with different parameters; use a supported command path or ask the platform/backend owner to enable the capability.";
   }
@@ -320,7 +341,7 @@ function parseBooleanValue(value, flagName) {
   if (normalized === "false" || normalized === "0" || normalized === "no" || normalized === "n" || normalized === "off") {
     return false;
   }
-  throw new Error(`Invalid boolean for --${flagName}: ${value}. Use true/false.`);
+  return value;
 }
 function extractGlobalOptions(program2) {
   const opts = program2.opts();
@@ -1093,7 +1114,8 @@ async function writeDraftXlsx(d, outPath, locale = "zh") {
 
 // src/core/tracking-client.ts
 var DEBUG_BASE = "/v1/ta/bury/manage/debug";
-var TRACK_CAPABILITY_DOMAIN = "analysis";
+var TRACK_LOCAL_HOST = "http://localhost:8992";
+var TRACK_CAPABILITY_DOMAIN = "";
 var TRACK_PROGRAM_QUERY = "track.program.query";
 var TRACK_PROGRAM_DELETE = "track.program.delete";
 var TRACK_PROGRAM_EXCEL_SAVE = "track.program.excel_save";
@@ -1312,7 +1334,7 @@ var TrackingClient = class {
   }
 };
 async function createTrackingClient(host) {
-  return new TrackingClient(host);
+  return new TrackingClient(TRACK_LOCAL_HOST);
 }
 
 // src/tracking/te-plan/fetch.ts
@@ -3071,22 +3093,22 @@ program.name("ae-cli").version(version).description("CLI tool for ThinkingAI (AE
 async function loadCommands() {
   const commands = [];
   try {
-    const teAnalysis = await import("./te-analysis-NJGNWZFC.js");
+    const teAnalysis = await import("./te-analysis-PUVF5IF4.js");
     commands.push(...teAnalysis.default);
   } catch {
   }
   try {
-    const teMeta = await import("./te-meta-MAAUHFQO.js");
+    const teMeta = await import("./te-meta-UUROEODR.js");
     commands.push(...teMeta.default);
   } catch {
   }
   try {
-    const teCommon = await import("./te-common-7VTJZPII.js");
+    const teCommon = await import("./te-common-VUX3VOXZ.js");
     commands.push(...teCommon.default);
   } catch {
   }
   try {
-    const engage = await import("./te-engage-BUWVSSSK.js");
+    const engage = await import("./te-engage-QBCCME22.js");
     commands.push(...engage.default);
   } catch {
   }
@@ -3101,7 +3123,7 @@ async function loadCommands() {
   } catch {
   }
   try {
-    const teKb = await import("./te-kb-NT33UHAE.js");
+    const teKb = await import("./te-kb-AYCODNU6.js");
     commands.push(...teKb.default);
   } catch {
   }
@@ -3116,7 +3138,7 @@ async function loadCommands() {
   } catch {
   }
   try {
-    const metadata = await import("./metadata-W6JFFMBA.js");
+    const metadata = await import("./metadata-FCLDBXX2.js");
     commands.push(...metadata.default);
   } catch {
   }
@@ -3145,7 +3167,7 @@ async function registerApiCommand() {
 }
 async function registerCapabilityCommands() {
   try {
-    const { registerCapability } = await import("./capability-SEH3JWLN.js");
+    const { registerCapability } = await import("./capability-SCRFGODD.js");
     registerCapability(program);
   } catch {
   }

package/dist/{metadata-X62TKIVK.js → metadata-BFDL6RUK.js}

@@ -1,9 +1,9 @@
 import {
   createCapabilityCommand
-} from "./chunk-N2QORU5D.js";
+} from "./chunk-7OLGDQQ2.js";
 import {
   registerCapabilityGatewayRoute
-} from "./chunk-HL2AJQ4Q.js";
+} from "./chunk-PTE56QPL.js";
 import "./chunk-DYOS6YY7.js";
 import "./chunk-TNW2CI4W.js";
 import "./chunk-NOO24N7W.js";

package/dist/{metadata-W6JFFMBA.js → metadata-FCLDBXX2.js}

@@ -1,9 +1,9 @@
 import {
   createCapabilityCommand
-} from "./chunk-TKQJQXWT.js";
+} from "./chunk-TBHBYKXZ.js";
 import {
   registerCapabilityGatewayRoute
-} from "./chunk-HL2AJQ4Q.js";
+} from "./chunk-PTE56QPL.js";
 import "./chunk-I4A62X3N.js";
 import "./chunk-TNW2CI4W.js";
 import "./chunk-NOO24N7W.js";