@thinkingai/ae-cli 1.0.22 → 1.0.27

package/README.md

@@ -60,6 +60,21 @@ ae-cli analysis_meta +list_events --project_id 1 --format table
 
 # Raw API call
 ae-cli api GET /v1/ta/event/catalog/listEvent --params '{"projectId": 1}'
+
+# Knowledge base (create → upload → compile → query)
+ae-cli kb +new --scope company --name engineering-handbook --description "Team docs"
+ae-cli kb +add --name engineering-handbook --files '["./docs/guide.md","https://example.com/page"]'
+ae-cli kb +schema --name engineering-handbook
+ae-cli kb +compile --name engineering-handbook
+ae-cli kb +query -q "How to configure sandbox?" \
+  --sources '[{"scope":"company","name":"engineering-handbook"}]'
+
+# Retrieval primitives for external agents (read index → grep → read page)
+ae-cli kb +index --sources '[{"scope":"company","name":"engineering-handbook"}]'
+ae-cli kb +grep -q "sandbox config" \
+  --sources '[{"scope":"company","name":"engineering-handbook"}]'
+ae-cli kb +read --source '{"scope":"company","name":"engineering-handbook"}' \
+  --path "wiki/sandbox.md"
 ```
 
 ## Authentication
@@ -97,8 +112,29 @@ ae-cli auth logout
 | `dataops_integration` | 20+ | Data integration: datasource management, sync solutions, data synchronization |
 | `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 |
 | `auth` / `config` | 2 | Authentication and host configuration |
 
+### kb
+
+Knowledge base lifecycle (`+new` → `+add` → `+schema` → `+compile` → `+status` → `+query`):
+
+- **Create** (`+new`): `--scope personal|company`, `--name`, optional `--description`, `--tags`, `--project-id`, `--project-name`
+- **Upload** (`+add`): `--name`, `--files` JSON array (`.md` file, directory non-recursive scan, or http(s) URL with HTML-to-Markdown conversion)
+- **Schema** (`+schema`): `--name`, optional `--force`, `--model`
+- **Compile** (`+compile`): `--name`, `--mode incremental|full` (default: incremental)
+- **Status** (`+status`): `--name`
+- **Query** (`+query`): `--query` / `-q`, `--sources` JSON refs e.g. `[{"scope":"company","name":"engineering-handbook"}]`
+- **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:
+
+- **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.
+
 ### Global Options
 
 | Option | Description | Default |
@@ -108,6 +144,7 @@ ae-cli auth logout
 | `--jq <expr>` | Filter expression | - |
 | `--dry-run` | Preview request | false |
 | `--yes` | Skip confirmation | false |
+| `--no-update-check` | Skip checking for newer ae-cli versions | false |
 
 ## Skills
 
@@ -185,7 +222,8 @@ src/
     ├── te-engage/
     ├── te-dataops/
     ├── te-community/
-    └── te-common/
+    ├── te-common/
+    └── te-kb/
 ```
 
 ## Verification Scripts

package/README.zh.md

@@ -60,6 +60,21 @@ ae-cli analysis_meta +list_events --project_id 1 --format table
 
 # 原始 API 调用
 ae-cli api GET /v1/ta/event/catalog/listEvent --params '{"projectId": 1}'
+
+# 知识库（新建 → 上传 → 编译 → 查询）
+ae-cli kb +new --scope company --name engineering-handbook --description "Team docs"
+ae-cli kb +add --name engineering-handbook --files '["./docs/guide.md","https://example.com/page"]'
+ae-cli kb +schema --name engineering-handbook
+ae-cli kb +compile --name engineering-handbook
+ae-cli kb +query -q "如何配置 sandbox 容器？" \
+  --sources '[{"scope":"company","name":"engineering-handbook"}]'
+
+# 面向外部 agent 的检索原语（读 index → grep 定位 → read 翻页）
+ae-cli kb +index --sources '[{"scope":"company","name":"engineering-handbook"}]'
+ae-cli kb +grep -q "sandbox 配置" \
+  --sources '[{"scope":"company","name":"engineering-handbook"}]'
+ae-cli kb +read --source '{"scope":"company","name":"engineering-handbook"}' \
+  --path "wiki/sandbox.md"
 ```
 
 ## 身份验证
@@ -97,8 +112,30 @@ ae-cli auth logout
 | `dataops_integration` | 20+ | 数据集成：数据源管理、同步方案、数据同步 |
 | `community` | 10+ | 社区分析：帖子搜索、情感分析、话题趋势、直播数据 |
 | `analysis_common` | 2 | 跨模块通用约束：资源链接补全、项目 ID 门控 |
+| `agent` | 15 | Agent 平台资源管理：模型、MCP 服务、Skill、附件库的增删查和启停 |
+| `team` | 14 | AI Agent Team：团队管理（列表/创建/更新/删除/AI生成/模板/项目）和 TeamRun 执行（启动/监听/对话/回复/取消/结果/产物） |
+| `kb` | 10 | 知识库生命周期：查询 / 新建 / 添加源（md/目录/url）/ schema / 编译 / 删除源 / 删除；检索原语：index / grep / read |
 | `auth` / `config` | 2 | 身份验证和主机配置 |
 
+### kb（知识库）
+
+知识库生命周期（`+new` → `+add` → `+schema` → `+compile` → `+status` → `+query`）：
+
+- **新建** (`+new`)：`--scope personal|company`，`--name`，可选 `--description`、`--tags`、`--project-id`、`--project-name`
+- **上传源** (`+add`)：`--name`，`--files` JSON 数组（`.md` 文件、目录非递归扫描、或 http(s) URL 自动转 Markdown）
+- **生成 schema** (`+schema`)：`--name`，可选 `--force`、`--model`
+- **编译** (`+compile`)：`--name`，`--mode incremental|full`（默认 incremental）
+- **查询状态** (`+status`)：`--name`
+- **查询** (`+query`)：`--query` / `-q`，`--sources` JSON 引用，如 `[{"scope":"company","name":"engineering-handbook"}]`
+- **删除源** (`+rm-source`)：`--name`，`--display-name`
+- **删除知识库** (`+remove`)：`--name`
+
+面向外部 agent 的检索原语（`+index` → `+grep` → `+read`）；均为确定性文件检索端点、服务端零 LLM 调用，让 agent（Claude Code / Codex / Cursor）像翻代码库一样探索知识库：
+
+- **索引** (`+index`)：可选 `--sources` JSON 引用（省略则列出全部可访问知识库），可选 `--locale`。返回每个知识库的元信息及其 `index.md` 导航地图。
+- **检索** (`+grep`)：`--query` / `-q`，可选 `--sources`、`--top-k`（1-50，默认 10）、`--locale`。返回命中行的路径、行号、面包屑与上下文片段。
+- **读取** (`+read`)：`--source` JSON 引用（精确指向一个知识库），`--path`（相对知识库根目录的页面路径），可选 `--offset` / `--limit`（行窗口）、`--locale`。返回页面全文或行窗口。
+
 ### 全局选项
 
 | 选项 | 描述 | 默认值 |
@@ -108,6 +145,7 @@ ae-cli auth logout
 | `--jq <expr>` | 过滤表达式 | - |
 | `--dry-run` | 预览请求 | false |
 | `--yes` | 跳过确认 | false |
+| `--no-update-check` | 跳过 ae-cli 新版本检查 | false |
 
 ## Skills
 
@@ -185,7 +223,8 @@ src/
     ├── te-engage/
     ├── te-dataops/
     ├── te-community/
-    └── te-common/
+    ├── te-common/
+    └── te-kb/
 ```
 
 ## 验证脚本

package/dist/{auth-YM7OI23X.js → auth-TXFJHPXU.js}

@@ -7,8 +7,9 @@ import {
   saveToken,
   setTokenManual,
   validateToken
-} from "./chunk-24ZKQWG2.js";
-import "./chunk-TMMUBSKW.js";
+} from "./chunk-SRRUNQIM.js";
+import "./chunk-BI5ZVD6T.js";
+import "./chunk-MNHE6SSI.js";
 export {
   clearToken,
   getAuthStatus,

package/dist/{auth-5S7SPPEJ.js → auth-W2JZ3DKA.js}

@@ -1,13 +1,13 @@
 import {
   printError,
   printOutput
-} from "./chunk-KM57HI5B.js";
+} from "./chunk-B4UL2VIJ.js";
 import {
   clearMcpToken,
   loadMcpTokenStore,
   setMcpTokenManual,
   validateMcpToken
-} from "./chunk-MPFTXJFG.js";
+} from "./chunk-2NGWYMLB.js";
 import {
   clearToken,
   getAuthStatus,
@@ -15,11 +15,14 @@ import {
   resolveHost,
   setTokenManual,
   validateToken
-} from "./chunk-24ZKQWG2.js";
+} from "./chunk-SRRUNQIM.js";
 import {
   loadConfig,
   saveConfig
-} from "./chunk-TMMUBSKW.js";
+} from "./chunk-BI5ZVD6T.js";
+import {
+  logger
+} from "./chunk-MNHE6SSI.js";
 
 // src/commands/auth.ts
 function registerAuth(program) {
@@ -37,11 +40,13 @@ function registerAuth(program) {
         config.activeHost = host;
       }
       saveConfig(config);
+      logger.info(`Host config auto-saved for ${host}`);
       process.stderr.write(`[ae-cli] Config saved for ${host}
 `);
     }
     try {
       const token = await getToken(host);
+      logger.info(`Auth login successful for ${host}`);
       process.stderr.write(`[ae-cli] Authenticated to ${host}
 `);
       printOutput({ authenticated: true, host, token: token.slice(0, 8) + "..." }, program.opts().format || "json");
@@ -71,12 +76,14 @@ function registerAuth(program) {
 `);
     const isValid = await validateToken(token, host);
     if (!isValid) {
+      logger.warn(`Token validation failed for ${host}`);
       process.stderr.write(`[ae-cli] Token validation failed
 `);
       printError("auth", "Invalid token", "Please check your token and try again");
       process.exit(1);
     }
     setTokenManual(token, host);
+    logger.info(`Token manually set and validated for ${host}`);
     process.stderr.write(`[ae-cli] Token verified and saved for ${host}
 `);
     printOutput({ saved: true, host, verified: true }, program.opts().format || "json");

package/dist/{chunk-MPFTXJFG.js → chunk-2NGWYMLB.js}

@@ -1,13 +1,16 @@
 import {
   getToken
-} from "./chunk-24ZKQWG2.js";
+} from "./chunk-SRRUNQIM.js";
 import {
   forceMigrateFromFallback,
   getActiveHost,
   getConfigDir,
   safeJsonParse,
   safeReadJsonFile
-} from "./chunk-TMMUBSKW.js";
+} from "./chunk-BI5ZVD6T.js";
+import {
+  logger
+} from "./chunk-MNHE6SSI.js";
 
 // src/core/mcp.ts
 import fs from "fs";
@@ -98,9 +101,11 @@ async function getMcpToken(hostOverride) {
   if (store[hostUrl]) {
     return store[hostUrl];
   }
+  logger.info(`Generating MCP token for ${hostUrl}`);
   const mcpToken = await generateMcpToken(hostUrl);
   const updatedStore = { ...store, [hostUrl]: mcpToken };
   saveMcpTokenStore(updatedStore);
+  logger.info(`MCP token generated and cached for ${hostUrl}`);
   return mcpToken;
 }
 function clearMcpToken(hostUrl) {
@@ -118,6 +123,7 @@ function setMcpTokenManual(token, hostUrl) {
   const store = loadMcpTokenStore();
   store[hostUrl] = token;
   saveMcpTokenStore(store);
+  logger.info(`MCP token manually set for ${hostUrl}`);
 }
 async function validateMcpToken(token, hostUrl) {
   const mapping = getMcpMapping("analysis");
@@ -180,8 +186,10 @@ async function mcpRequest(url, method, params = {}, hostOverride) {
     body: JSON.stringify(body)
   });
   if (!resp.ok) {
+    logger.warn(`MCP request failed (HTTP ${resp.status}) for ${hostUrl}, trying fallback`);
     const migrated = forceMigrateFromFallback();
     if (migrated && migrated[hostUrl]) {
+      logger.info(`MCP token refreshed from fallback for ${hostUrl}`);
       process.stderr.write(`[ae-cli] MCP token refreshed from fallback for ${hostUrl}
 `);
       headers["mcp-token"] = migrated[hostUrl];
@@ -212,7 +220,11 @@ async function callMcpTool(url, toolName, args = {}, hostOverride) {
     name: toolName,
     arguments: args
   };
+  logger.info(`MCP tool call: ${toolName}`);
   const result = await mcpRequest(url, "tools/call", params, hostOverride);
+  if (result.isError) {
+    logger.warn(`MCP tool call failed: ${toolName}`);
+  }
   return {
     content: result.content.map((item) => {
       if (item.type === "text") {