@thinkingai/ae-cli 6.0.31 → 6.0.32

package/skills/ae-kb/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: ae-kb
 version: 1.0.0
-description: "AE/TE knowledge base CLI manual for creating, querying, LLM-powered ask, deterministic index/grep/read retrieval, checking status, uploading, compiling, schema generation, URL sources, source deletion, and knowledge base deletion. Use when the user asks to manage TE/AE/ThinkingEngine knowledge bases, upload documents or URLs to a knowledge base, query knowledge, ask knowledge bases with an LLM, inspect knowledge base indexes, search knowledge base pages, read a specific knowledge base page, check knowledge base status, generate schemas, compile knowledge, remove sources, or delete a knowledge base. Must use ae-cli kb commands and must not guess knowledge base names, scopes, page paths, source display names, JSON payload shapes, or URL formats."
+description: "AE/TE knowledge base CLI manual for creating, querying, LLM-powered ask, listing accessible knowledge bases, deterministic index/grep/read retrieval, checking status, uploading, compiling, schema generation, URL sources, source deletion, and knowledge base deletion. Use when the user asks to manage TE/AE/ThinkingEngine knowledge bases, upload documents or URLs to a knowledge base, query knowledge, ask knowledge bases with an LLM, list accessible knowledge bases, inspect knowledge base indexes, search knowledge base pages, read a specific knowledge base page, check knowledge base status, generate schemas, compile knowledge, remove sources, or delete a knowledge base. Must use ae-cli kb commands and must not guess knowledge base names, scopes, page paths, source display names, JSON payload shapes, or URL formats."
 ---
 
 # ae-kb
@@ -14,8 +14,8 @@ ae-cli kb +<command> [options]
 
 ## Global Rules
 
-- Use this skill for TE/AE knowledge base tasks: create, query, ask with LLM, inspect indexes, grep pages, read pages, check status, upload sources, add URL sources, generate schema, compile, remove source files, and delete knowledge bases.
-- Read and ordinary `write` operations can run directly after required inputs and user intent are known. Only `high-risk-write` operations use the confirmation gate.
+- Use this skill for TE/AE knowledge base tasks: create, query, ask with LLM, list accessible knowledge bases, inspect indexes, grep pages, read pages, check status, upload sources, add URL sources, generate schema, compile, remove source files, and delete knowledge bases.
+- Read operations can run directly after required inputs are known. Write operations require explicit user intent and normally keep the confirmation prompt unless the user asks to bypass it.
 - Prefer `--dry-run` before destructive or broad writes when the user has not already validated the target.
 - Do not invent knowledge base names, scopes, source display names, or JSON payloads. Ask the user or query known context when values are missing.
 - JSON flags must be valid JSON strings, usually wrapped in single quotes in shell commands.
@@ -29,6 +29,7 @@ ae-cli kb +<command> [options]
 |---|---:|---|
 | `+query` | read | Query one or more knowledge bases with a natural-language question. |
 | `+ask` | read | LLM-powered Q&A over knowledge bases. Consumes platform tokens. |
+| `+list` | read | List accessible knowledge bases filtered by buildStatus (default: compiled). |
 | `+index` | read | List accessible knowledge bases and their `index.md` navigation maps. |
 | `+grep` | read | Keyword-search knowledge base pages and return matched lines with context. |
 | `+read` | read | Read a full knowledge base page or a line window. |
@@ -145,21 +146,35 @@ ae-cli kb +ask \
   --question "How do we troubleshoot payment alerts?" \
   --sources '[{"scope":"company","name":"engineering-handbook"}]' \
   --model-id claude-sonnet-4-6 \
-  --max-turns 10 \
+  --max-turns 50 \
   --locale zh
 ```
 
 - `--question`, alias `-q`: required natural-language question (1-2000 characters).
 - `--sources`: optional JSON array of knowledge base refs. Omit to search all accessible knowledge bases.
 - `--model-id`: optional LLM model ID. Omit to use the platform default.
-- `--max-turns`: optional agent turn limit (1-20, server default 10).
+- `--max-turns`: optional agent turn limit (1-100, server default 50).
 - `--locale`: optional locale: `zh`, `en`, `ja`, or `ko`.
 
+### List Accessible Knowledge Bases
+
+Use `+list` when you only need accessible knowledge base metadata without loading `index.md` navigation maps. By default it returns knowledge bases with `buildStatus: compiled`:
+
+```bash
+ae-cli kb +list
+ae-cli kb +list --locale zh
+ae-cli kb +list --build-status compiled
+```
+
 ### Explore Knowledge Base Pages
 
 Use the deterministic retrieval primitives when an agent needs to explore knowledge base content like a code repository. These endpoints do not call an LLM on the server side.
 
-Start with `+index` to see accessible knowledge bases and navigation maps:
+Start with `+list` or `+index` to discover accessible knowledge bases. Use `+index` when you also need navigation maps:
+
+```bash
+ae-cli kb +list
+```
 
 ```bash
 ae-cli kb +index \
@@ -187,6 +202,7 @@ ae-cli kb +read \
 
 Retrieval rules:
 
+- `+list` accepts optional `--build-status` (default `compiled`) and `--locale`. Returns accessible knowledge base metadata including `buildStatus`, without `index.md` navigation maps.
 - `+index` accepts optional `--sources` and `--locale`; omit `--sources` to list all accessible knowledge bases.
 - `+grep` requires `--query` / `-q`; optional `--sources`, `--top-k` (1-50, default 10), and `--locale`.
 - `+read` requires `--source` pointing to exactly one knowledge base and `--path` relative to the knowledge base root; optional `--offset`, `--limit` (1-10000), and `--locale`.
@@ -226,16 +242,26 @@ ae-cli kb +query --query "<question>" --sources '[{"scope":"company","name":"kb-
 ### `+ask`
 
 ```bash
-ae-cli kb +ask --question "<question>" [--sources '[{"scope":"company","name":"kb-name"}]'] [--model-id claude-sonnet-4-6] [--max-turns 10] [--locale zh|en|ja|ko]
+ae-cli kb +ask --question "<question>" [--sources '[{"scope":"company","name":"kb-name"}]'] [--model-id claude-sonnet-4-6] [--max-turns 50] [--locale zh|en|ja|ko]
 ```
 
 - `--question`, alias `-q`: required natural-language question (1-2000 characters).
 - `--sources`: optional JSON array of knowledge base refs. Omit to search all accessible knowledge bases.
 - `--model-id`: optional LLM model ID. Omit to use the platform default.
-- `--max-turns`: optional agent turn limit, 1-20, server default 10.
+- `--max-turns`: optional agent turn limit (1-100, server default 50).
 - `--locale`: optional locale: `zh`, `en`, `ja`, or `ko`.
 - **Token cost**: this command invokes an LLM on the server and consumes platform tokens. Prefer `+index` -> `+grep` -> `+read` for token-free deterministic retrieval.
 
+### `+list`
+
+```bash
+ae-cli kb +list [--build-status compiled] [--locale zh|en|ja|ko]
+```
+
+- `--build-status`: optional build status filter (default: `compiled`).
+- `--locale`: optional locale: `zh`, `en`, `ja`, or `ko`.
+- Response items include `buildStatus`.
+
 ### `+index`
 
 ```bash

package/skills/ae-metadata/SKILL.md

@@ -87,5 +87,5 @@ ae-cli analysis input-file purpose list --project-id 1
 
 ## Related Skills
 
-- **`ae-analysis`**: `analysis_meta +list_events` / `+list_properties` to discover names before detail get.
+- **`ae-analysis`**: `analysis-meta event list` / `analysis-meta property list` 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_event_get.md

@@ -35,18 +35,18 @@ Gateway request body uses snake_case `input`:
 
 ## Decision Rules
 
-- Prefer **`metadata event get`** over `analysis_meta +list_events` when you need **full detail + virtual definition**, not browsing or fuzzy search.
-- Use `ae-analysis` → `analysis_meta +list_events` first when the event name is unknown or you need keyword search / pagination.
+- Prefer **`metadata event get`** over `analysis-meta event list` when you need **full detail + virtual definition**, not browsing or fuzzy search.
+- Use `ae-analysis` → `analysis-meta event list` first when the event name is unknown or you need keyword search / pagination.
 - If the gateway returns `EVENT_NOT_FOUND`, verify `event_name` spelling and `project_id`; do not invent names.
 - Auth: `cli-token` header (ae-cli injects automatically in sandbox; local CLI uses `getCliToken()`).
 
 ## Recommended Chaining
 
-- `ae-analysis`: `analysis_meta +list_events` (discover name) → `metadata event get` (detail)
+- `ae-analysis`: `analysis-meta event list` (discover name) → `metadata event get` (detail)
 - `metadata event get` → `metadata property get` (inspect properties listed in response)
 
 ## Next Steps After Failure
 
-- Empty or not found: confirm project id and exact `event_name` from `+list_events`.
+- Empty or not found: confirm project id and exact `event_name` from `analysis-meta event list`.
 - Permission error: confirm metadata view permission in the project.
 - Gateway unavailable: confirm nginx routes `/api/cli/metadata/` and backend capability catalog is deployed.

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

@@ -22,6 +22,6 @@ ae-cli metadata property bind-existing-dimension-table --project-id <project_id>
 
 ## Decision Rules
 
-- Confirm the property with `metadata property get` or `analysis_meta +list_properties`.
+- Confirm the property with `metadata property get` or `analysis-meta property list`.
 - Confirm the data table with `metadata data-table get`.
 - This is an ordinary `write` command and does not require CLI confirmation.

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

@@ -37,18 +37,18 @@ Gateway request body uses snake_case `input`:
 
 ## Decision Rules
 
-- Prefer **`metadata property get`** over `analysis_meta +list_properties` when you need **full detail + virtual definition**, not browsing or fuzzy search.
-- Use `ae-analysis` → `analysis_meta +list_properties` first when the property name is unknown or you need keyword search / pagination.
+- Prefer **`metadata property get`** over `analysis-meta property list` when you need **full detail + virtual definition**, not browsing or fuzzy search.
+- Use `ae-analysis` → `analysis-meta property list` first when the property name is unknown or you need keyword search / pagination.
 - `property_scope` must be exactly `event` or `user` (backend accepts case-insensitive).
 - Virtual / dict / exchange-rate properties are addressed by `property-name` only; do not pass legacy `prop_name`.
 - Event-scoped names like `#account_id` must be passed literally (quote in shell when `#` is present).
 
 ## Recommended Chaining
 
-- `ae-analysis`: `analysis_meta +list_properties` (discover name + scope) → `metadata property get` (detail)
+- `ae-analysis`: `analysis-meta property list` (discover name + scope) → `metadata property get` (detail)
 - `metadata event get` → `metadata property get` (follow properties from event detail)
 
 ## Next Steps After Failure
 
-- Not found: confirm scope (`event` vs `user`) and exact name from `+list_properties`.
+- Not found: confirm scope (`event` vs `user`) and exact name from `analysis-meta property list`.
 - Permission error: confirm metadata view permission in the project.

package/dist/te-common-5NJLF3XG.js

@@ -1,130 +0,0 @@
-import {
-  callMcpTool,
-  parseMcpResult,
-  resolveMcpUrl
-} from "./chunk-6LEYLOV3.js";
-import "./chunk-KGJQCYVC.js";
-import "./chunk-NOO24N7W.js";
-import "./chunk-2NDGFQHW.js";
-import "./chunk-AJTH7LT3.js";
-import "./chunk-YCLVYFK7.js";
-
-// src/commands/te-common/shared.ts
-function createMcpCommand(config) {
-  const toolName = config.command.slice(1);
-  const mcpService = config.mcpService || "analysis";
-  return {
-    service: "analysis_common",
-    command: config.command,
-    description: config.description,
-    flags: config.flags,
-    risk: config.risk,
-    dryRun: (ctx) => ({
-      method: "tools/call",
-      url: resolveMcpUrl(ctx.mcpUrl(), ctx.host(), mcpService),
-      body: {
-        name: toolName,
-        arguments: config.buildArgs(ctx)
-      }
-    }),
-    execute: async (ctx) => {
-      const url = resolveMcpUrl(ctx.mcpUrl(), ctx.host(), mcpService);
-      const result = await callMcpTool(url, toolName, config.buildArgs(ctx), ctx.host());
-      return parseMcpResult(result);
-    }
-  };
-}
-
-// src/commands/te-common/project/list-projects.ts
-var listProjects = createMcpCommand({
-  command: "+list_projects",
-  description: "List all projects accessible to the current user. No parameters are required. Returns project IDs, names, company IDs, project types, remarks, app IDs, and the user's current role in each project.",
-  flags: [],
-  risk: "read",
-  buildArgs: () => ({})
-});
-
-// src/commands/te-common/project/index.ts
-var commands = [
-  listProjects
-];
-var project_default = commands;
-
-// src/commands/te-common/resource/get-resource-url.ts
-function normalizeResourceUrlFields(node, host) {
-  if (!node || typeof node !== "object") return;
-  const obj = node;
-  for (const [key, value] of Object.entries(obj)) {
-    if (typeof value === "string") {
-      if (/url|link/i.test(key) || value.includes("/#/")) {
-        obj[key] = absolutizeRelativeUrls(value, host);
-      }
-    } else if (value && typeof value === "object") {
-      normalizeResourceUrlFields(value, host);
-    }
-  }
-}
-function absolutizeRelativeUrls(s, host) {
-  const base = host.replace(/\/+$/, "");
-  s = s.replace(/\]\((\/(?!\/)[^)]*)\)/g, `](${base}$1)`);
-  if (/^\/(?!\/)/.test(s)) s = base + s;
-  return s;
-}
-var getResourceUrl = {
-  service: "analysis_common",
-  command: "+get_resource_url",
-  description: "Generate a clickable Markdown link for a resource by ID and type (absolute URL)",
-  flags: [
-    { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" },
-    { name: "resource_type", type: "string", required: true, desc: "Resource type: dashboard/report/metric/alert/tag/cluster/data_table/super_event/super_prop_user/super_prop_event/virtual_event/user_virtual_prop/event_virtual_prop" },
-    { name: "resource_id", type: "number", required: true, desc: "Numeric resource ID" }
-  ],
-  risk: "read",
-  dryRun: (ctx) => ({
-    method: "tools/call",
-    url: resolveMcpUrl(ctx.mcpUrl(), ctx.host(), "analysis"),
-    body: {
-      name: "get_resource_url",
-      arguments: {
-        projectId: ctx.num("project_id"),
-        resourceType: ctx.str("resource_type"),
-        resourceId: ctx.num("resource_id")
-      }
-    }
-  }),
-  execute: async (ctx) => {
-    const url = resolveMcpUrl(ctx.mcpUrl(), ctx.host(), "analysis");
-    const result = await callMcpTool(
-      url,
-      "get_resource_url",
-      {
-        projectId: ctx.num("project_id"),
-        resourceType: ctx.str("resource_type"),
-        resourceId: ctx.num("resource_id")
-      },
-      ctx.host()
-    );
-    const parsed = parseMcpResult(result);
-    if (typeof parsed !== "object" || parsed === null) {
-      return parsed;
-    }
-    normalizeResourceUrlFields(parsed, ctx.host());
-    return parsed;
-  }
-};
-
-// src/commands/te-common/resource/index.ts
-var commands2 = [
-  getResourceUrl
-];
-var resource_default = commands2;
-
-// src/commands/te-common/index.ts
-var commands3 = [
-  ...project_default,
-  ...resource_default
-];
-var te_common_default = commands3;
-export {
-  te_common_default as default
-};

package/dist/te-common-7VTJZPII.js

@@ -1,130 +0,0 @@
-import {
-  callMcpTool,
-  parseMcpResult,
-  resolveMcpUrl
-} from "./chunk-PKRD2IEM.js";
-import "./chunk-KGJQCYVC.js";
-import "./chunk-NOO24N7W.js";
-import "./chunk-2NDGFQHW.js";
-import "./chunk-AJTH7LT3.js";
-import "./chunk-YCLVYFK7.js";
-
-// src/commands/te-common/shared.ts
-function createMcpCommand(config) {
-  const toolName = config.command.slice(1);
-  const mcpService = config.mcpService || "analysis";
-  return {
-    service: "analysis_common",
-    command: config.command,
-    description: config.description,
-    flags: config.flags,
-    risk: config.risk,
-    dryRun: (ctx) => ({
-      method: "tools/call",
-      url: resolveMcpUrl(ctx.mcpUrl(), ctx.host(), mcpService),
-      body: {
-        name: toolName,
-        arguments: config.buildArgs(ctx)
-      }
-    }),
-    execute: async (ctx) => {
-      const url = resolveMcpUrl(ctx.mcpUrl(), ctx.host(), mcpService);
-      const result = await callMcpTool(url, toolName, config.buildArgs(ctx), ctx.host());
-      return parseMcpResult(result);
-    }
-  };
-}
-
-// src/commands/te-common/project/list-projects.ts
-var listProjects = createMcpCommand({
-  command: "+list_projects",
-  description: "List all projects accessible to the current user. No parameters are required. Returns project IDs, names, company IDs, project types, remarks, app IDs, and the user's current role in each project.",
-  flags: [],
-  risk: "read",
-  buildArgs: () => ({})
-});
-
-// src/commands/te-common/project/index.ts
-var commands = [
-  listProjects
-];
-var project_default = commands;
-
-// src/commands/te-common/resource/get-resource-url.ts
-function normalizeResourceUrlFields(node, host) {
-  if (!node || typeof node !== "object") return;
-  const obj = node;
-  for (const [key, value] of Object.entries(obj)) {
-    if (typeof value === "string") {
-      if (/url|link/i.test(key) || value.includes("/#/")) {
-        obj[key] = absolutizeRelativeUrls(value, host);
-      }
-    } else if (value && typeof value === "object") {
-      normalizeResourceUrlFields(value, host);
-    }
-  }
-}
-function absolutizeRelativeUrls(s, host) {
-  const base = host.replace(/\/+$/, "");
-  s = s.replace(/\]\((\/(?!\/)[^)]*)\)/g, `](${base}$1)`);
-  if (/^\/(?!\/)/.test(s)) s = base + s;
-  return s;
-}
-var getResourceUrl = {
-  service: "analysis_common",
-  command: "+get_resource_url",
-  description: "Generate a clickable Markdown link for a resource by ID and type (absolute URL)",
-  flags: [
-    { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" },
-    { name: "resource_type", type: "string", required: true, desc: "Resource type: dashboard/report/metric/alert/tag/cluster/data_table/super_event/super_prop_user/super_prop_event/virtual_event/user_virtual_prop/event_virtual_prop" },
-    { name: "resource_id", type: "number", required: true, desc: "Numeric resource ID" }
-  ],
-  risk: "read",
-  dryRun: (ctx) => ({
-    method: "tools/call",
-    url: resolveMcpUrl(ctx.mcpUrl(), ctx.host(), "analysis"),
-    body: {
-      name: "get_resource_url",
-      arguments: {
-        projectId: ctx.num("project_id"),
-        resourceType: ctx.str("resource_type"),
-        resourceId: ctx.num("resource_id")
-      }
-    }
-  }),
-  execute: async (ctx) => {
-    const url = resolveMcpUrl(ctx.mcpUrl(), ctx.host(), "analysis");
-    const result = await callMcpTool(
-      url,
-      "get_resource_url",
-      {
-        projectId: ctx.num("project_id"),
-        resourceType: ctx.str("resource_type"),
-        resourceId: ctx.num("resource_id")
-      },
-      ctx.host()
-    );
-    const parsed = parseMcpResult(result);
-    if (typeof parsed !== "object" || parsed === null) {
-      return parsed;
-    }
-    normalizeResourceUrlFields(parsed, ctx.host());
-    return parsed;
-  }
-};
-
-// src/commands/te-common/resource/index.ts
-var commands2 = [
-  getResourceUrl
-];
-var resource_default = commands2;
-
-// src/commands/te-common/index.ts
-var commands3 = [
-  ...project_default,
-  ...resource_default
-];
-var te_common_default = commands3;
-export {
-  te_common_default as default
-};