refactor(analytics-agent): remove structured knowledge entry commands

Drop the top-level `knowledge list/get/create/update/delete` subcommands
along with their routes and helpers, keeping the space/node/folder/file
command surface. Update the spec and tests to match.

Co-Authored-By: cz-cli <noreply@clickzetta.com>

Author: 2 people

openspec/specs/analytics-agent-knowledge/spec.md

@@ -1,7 +1,7 @@
 # analytics-agent-knowledge 规格说明
 
 ## Purpose
-定义 `analytics-agent knowledge` 命令组的第一批能力，包括结构化知识 CRUD、知识空间查询/创建，以及文档知识的 folder/file 基础命令面。
+定义 `analytics-agent knowledge` 命令组的能力，包括知识空间查询/创建，以及文档知识的 folder/file 基础命令面。
 
 ## Requirements
 
@@ -23,60 +23,6 @@ When the active profile already provides Analytics Agent specific `agent` contex
 - **THEN** CLI MUST fall back to the existing Studio context resolution path
 - **AND** the existing non-agent command behavior MUST remain unchanged
 
-### Requirement: 结构化知识 CRUD
-
-CLI MUST provide `analytics-agent knowledge list/create/update/delete` for structured knowledge entries by calling open analytics-agent knowledge endpoints.
-
-#### Scenario: 列出结构化知识
-
-- **WHEN** 用户执行 `cz-cli analytics-agent knowledge list`
-- **THEN** CLI MUST call the open knowledge list endpoint
-- **AND** the primary output MUST expose user-facing fields including knowledge id, aliases, type, status, and bound domain ids when present
-
-#### Scenario: 创建文本知识
-
-- **WHEN** 用户执行 `cz-cli analytics-agent knowledge create --alias <alias> --content <text>`
-- **THEN** CLI MUST call the open knowledge create endpoint with a text-knowledge payload
-- **AND** the request MUST map `--content` to the stored text content field
-- **AND** the success output MUST include the created knowledge id and aliases
-
-#### Scenario: 从本地文件创建文本知识
-
-- **WHEN** 用户执行 `cz-cli analytics-agent knowledge create --alias <alias> --file <local-path>`
-- **THEN** CLI MUST read the local file content before sending the request
-- **AND** CLI MUST call the open knowledge create endpoint with the loaded text content
-- **AND** the success output MUST include the created knowledge id and aliases
-
-#### Scenario: 更新文本知识
-
-- **WHEN** 用户执行 `cz-cli analytics-agent knowledge update <knowledge-id> --alias <alias> --content <text>`
-- **THEN** CLI MUST call the open knowledge update endpoint for that id
-- **AND** the request MUST preserve the knowledge id in the path rather than the JSON body only
-
-#### Scenario: 获取结构化知识详情
-
-- **WHEN** 用户执行 `cz-cli analytics-agent knowledge get <knowledge-id>`
-- **THEN** CLI MUST call the open knowledge detail endpoint for that id
-- **AND** the primary output MUST include the knowledge id, aliases, type, and content or dictionary payload
-
-#### Scenario: 删除结构化知识
-
-- **WHEN** 用户执行 `cz-cli analytics-agent knowledge delete <knowledge-id>`
-- **THEN** CLI MUST call the open knowledge delete endpoint for that id
-- **AND** the command MUST succeed on the backend no-data success shape
-
-#### Scenario: 创建知识缺少内容
-
-- **WHEN** 用户执行 `cz-cli analytics-agent knowledge create --alias <alias>` without `--content` and without `--dictionary`
-- **THEN** CLI MUST reject the request before sending it
-- **AND** the error message MUST explain that text knowledge requires content
-
-#### Scenario: 从本地文件创建知识时文件不存在
-
-- **WHEN** 用户执行 `cz-cli analytics-agent knowledge create --alias <alias> --file <missing-path>`
-- **THEN** CLI MUST reject the request before sending it
-- **AND** the error message MUST explain that the local path does not exist
-
 ### Requirement: 知识空间查询与维护
 
 CLI MUST provide `analytics-agent knowledge space list/create/rename/delete` for document knowledge spaces.

packages/cz-cli/src/commands/analytics-agent.ts

@@ -60,11 +60,6 @@ const ROUTES = {
   columnVirtualSet: { method: "POST", path: (argv: Record<string, unknown>) => `/open/api/v1/analytics-agent/datasets/${encodePath(argv["dataset-id"])}/virtual-columns` },
   columnVirtualList: { method: "GET", path: (argv: Record<string, unknown>) => `/open/api/v1/analytics-agent/datasets/${encodePath(argv["dataset-id"])}/virtual-columns` },
   columnVirtualDelete: { method: "DELETE", path: (argv: Record<string, unknown>) => `/open/api/v1/analytics-agent/datasets/${encodePath(argv["dataset-id"])}/virtual-columns/${encodePath(argv["attr-id"])}` },
-  knowledgeEntryList: { method: "GET", path: "/open/api/v1/analytics-agent/knowledge/entries" },
-  knowledgeEntryDetail: { method: "GET", path: (argv: Record<string, unknown>) => `/open/api/v1/analytics-agent/knowledge/entries/${encodePath(argv["knowledge-id"])}` },
-  knowledgeEntryCreate: { method: "POST", path: "/open/api/v1/analytics-agent/knowledge/entries" },
-  knowledgeEntryUpdate: { method: "PUT", path: (argv: Record<string, unknown>) => `/open/api/v1/analytics-agent/knowledge/entries/${encodePath(argv["knowledge-id"])}` },
-  knowledgeEntryDelete: { method: "DELETE", path: (argv: Record<string, unknown>) => `/open/api/v1/analytics-agent/knowledge/entries/${encodePath(argv["knowledge-id"])}` },
   knowledgeSpaceList: { method: "GET", path: "/open/api/v1/analytics-agent/knowledge/spaces" },
   knowledgeSpaceCreate: { method: "POST", path: "/open/api/v1/analytics-agent/knowledge/spaces" },
   knowledgeSpaceRename: { method: "PUT", path: (argv: Record<string, unknown>) => `/open/api/v1/analytics-agent/knowledge/spaces/${encodePath(argv["space-id"])}` },
@@ -1199,33 +1194,6 @@ async function executeKnowledgeNodeDomainCommand(
   }
 }
 
-function knowledgeEntryBody(argv: Record<string, unknown>): Record<string, unknown> {
-  const format = typeof argv.format === "string" ? argv.format : "json"
-  return mergeBody({}, {
-    aliases: stringArray(argv.alias),
-    content: argv.content,
-    dictionary: parseOptionalJsonObject(argv.dictionary as string | undefined, "--dictionary"),
-    type: argv.type,
-    domainIds: positiveIntegerArray(argv["domain-id"], "--domain-id", format),
-  })
-}
-
-async function knowledgeCreateBody(argv: Record<string, unknown>): Promise<Record<string, unknown>> {
-  const format = typeof argv.format === "string" ? argv.format : "json"
-  const content = typeof argv.content === "string"
-    ? argv.content
-    : typeof argv.file === "string"
-      ? await Bun.file((await collectKnowledgeLocalFile(argv.file)).absolutePath).text()
-      : undefined
-  return mergeBody({}, {
-    aliases: stringArray(argv.alias),
-    content,
-    dictionary: parseOptionalJsonObject(argv.dictionary as string | undefined, "--dictionary"),
-    type: argv.type,
-    domainIds: positiveIntegerArray(argv["domain-id"], "--domain-id", format),
-  })
-}
-
 function normalizedRemotePath(pathValue: string | undefined): string {
   if (!pathValue) return ""
   const normalized = pathValue.replaceAll("\\", "/").split("/").filter(Boolean).join("/")
@@ -2613,87 +2581,6 @@ export function registerAnalyticsAgentCommand(cli: Argv<GlobalArgs>): void {
       })
       .command("knowledge", "Manage Analytics Agent knowledge", (knowledge) => {
         knowledge
-          .command(
-            "list",
-            "List structured knowledge entries",
-            (y) =>
-              y
-                .option("keyword", { type: "string", describe: "Keyword for fuzzy search" })
-                .option("domain-id", { type: "number", describe: "Bound domain ID" })
-                .option("type", { type: "string", choices: ["text", "dictionary"], describe: "Knowledge type" })
-                .option("page-num", { type: "number", describe: "Page number" })
-                .option("page-size", { type: "number", describe: "Page size" }),
-            async (argv) => {
-              await executeAnalyticsCommand("analytics-agent knowledge list", argv as Record<string, unknown>, ROUTES.knowledgeEntryList, {}, {
-                keyword: argv.keyword,
-                domainId: argv["domain-id"],
-                type: argv.type,
-                pageNum: argv["page-num"],
-                pageSize: argv["page-size"],
-              })
-            },
-          )
-          .command(
-            "get <knowledge-id>",
-            "Show structured knowledge detail",
-            (y) => y.positional("knowledge-id", { type: "number", demandOption: true, describe: "Knowledge ID" }),
-            async (argv) => {
-              await executeAnalyticsCommand("analytics-agent knowledge get", argv as Record<string, unknown>, ROUTES.knowledgeEntryDetail, {})
-            },
-          )
-          .command(
-            "create",
-            "Create structured knowledge",
-            (y) =>
-              y
-                .option("alias", { type: "string", array: true, describe: "Knowledge alias, can be repeated" })
-                .option("content", { type: "string", describe: "Text knowledge content" })
-                .option("file", { type: "string", describe: "Local file path to load as text knowledge content" })
-                .option("dictionary", { type: "string", describe: "Dictionary JSON object" })
-                .option("type", { type: "string", choices: ["text", "dictionary"], describe: "Knowledge type" })
-                .option("domain-id", { type: "number", array: true, describe: "Bound domain ID, can be repeated" }),
-            async (argv) => {
-              const type = typeof argv.type === "string" ? argv.type : "text"
-              if (type === "dictionary" && !argv.dictionary) {
-                handledError("USAGE_ERROR", "dictionary knowledge requires --dictionary", { format: typeof argv.format === "string" ? argv.format : "json" })
-              }
-              if (type !== "dictionary" && !argv.content && !argv.file && !argv.dictionary) {
-                handledError("USAGE_ERROR", "text knowledge requires --content or --file", { format: typeof argv.format === "string" ? argv.format : "json" })
-              }
-              let body: Record<string, unknown>
-              try {
-                body = await knowledgeCreateBody(argv as Record<string, unknown>)
-              } catch (err) {
-                handledError("ANALYTICS_AGENT_ERROR", err instanceof Error ? err.message : String(err), {
-                  format: typeof argv.format === "string" ? argv.format : "json",
-                })
-              }
-              await executeAnalyticsCommand("analytics-agent knowledge create", argv as Record<string, unknown>, ROUTES.knowledgeEntryCreate, body)
-            },
-          )
-          .command(
-            "update <knowledge-id>",
-            "Update structured knowledge",
-            (y) =>
-              y
-                .positional("knowledge-id", { type: "number", demandOption: true, describe: "Knowledge ID" })
-                .option("alias", { type: "string", array: true, describe: "Knowledge alias, can be repeated" })
-                .option("content", { type: "string", describe: "Text knowledge content" })
-                .option("dictionary", { type: "string", describe: "Dictionary JSON object" })
-                .option("type", { type: "string", choices: ["text", "dictionary"], describe: "Knowledge type" })
-                .option("domain-id", { type: "number", array: true, describe: "Bound domain ID, can be repeated" }),
-            async (argv) => {
-              await executeAnalyticsCommand("analytics-agent knowledge update", argv as Record<string, unknown>, ROUTES.knowledgeEntryUpdate, knowledgeEntryBody(argv as Record<string, unknown>))
-            },
-          )
-          .command(
-            "delete <knowledge-id>",
-            "Delete structured knowledge",
-            (y) => y.positional("knowledge-id", { type: "number", demandOption: true, describe: "Knowledge ID" }),
-            async (argv) => {
-              await executeAnalyticsCommand("analytics-agent knowledge delete", argv as Record<string, unknown>, ROUTES.knowledgeEntryDelete, {})
-            },
-          )
           .command(
             "space",
             "Manage knowledge spaces",