viatris-exam-cli 1.4.1 → 1.6.0

package/README.md

@@ -72,15 +72,26 @@ viatris-exam describe --compact
 
 ## 命令
 
+### 产品主数据
+
+```bash
+viatris-exam products list
+viatris-exam products create --input product.json
+viatris-exam products update "$PRODUCT_ID" --input verified-medical-data.json
+```
+
+创建产品时仅中文名称 `name` 必填；`code` 和 `nameEn` 可省略，省略 `code` 时由服务端生成。创建会同步初始化规范知识树根节点。更新命令仅用于补充经资料核验的英文名、通用名、适应症、剂型规格和备注。
+
 ### 产品知识树
 
 ```bash
 viatris-exam products get "$PRODUCT_ID"
 viatris-exam products update-knowledge-tree "$PRODUCT_ID" \
   --input knowledge-tree.json
+viatris-exam products delete-knowledge-tree "$PRODUCT_ID"
 ```
 
-产品是隐藏系统容器，不属于业务知识树层级。固定维度为 L1；知识树回写是完整替换操作，必须一次提交全部 15-500 个 L2/L3/L4 动态节点。先查询产品以获取固定 L1 维度的 `clientRef`。
+产品主数据不属于业务知识树层级；详情查询使用产品主数据 ID，并兼容历史知识树根节点 ID。固定维度为 L1；知识树回写是完整替换操作，必须一次提交全部 15-500 个 L2/L3/L4 动态节点。整树删除会保留产品根和固定维度，但级联删除动态节点及文档并解绑题目，只能在明确要求时执行。
 
 ### 知识节点与文档
 
@@ -91,7 +102,7 @@ viatris-exam knowledge nodes create --input node.json
 viatris-exam knowledge nodes get <node-id>
 viatris-exam knowledge nodes update <node-id> --input changes.json
 viatris-exam knowledge nodes move <node-id> --input move.json
-viatris-exam knowledge nodes delete <node-id>
+viatris-exam knowledge nodes delete <node-id> [--recursive]
 viatris-exam knowledge documents list <node-id>
 viatris-exam knowledge documents create <node-id> --input document.json
 viatris-exam knowledge documents upsert <node-id> --input documents.json
@@ -99,7 +110,7 @@ viatris-exam knowledge documents update <document-id> --input changes.json
 viatris-exam knowledge documents delete <document-id>
 ```
 
-节点删除会级联删除整棵子树及文档。产品根和固定维度受保护，不能改名、移动或删除。
+节点删除默认在存在子节点或题目绑定时返回冲突；`--recursive` 才会级联删除整棵子树及文档并解绑题目。产品根和固定维度受保护，不能改名、移动或删除。
 
 `/knowledge` CRUD 响应中的 `level` 是物理存储层级（产品根为 1、固定维度为 2）；产品生成接口使用业务层级（产品隐藏、固定维度为 L1、动态节点为 L2-L4）。
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "viatris-exam-cli",
-  "version": "1.4.1",
+  "version": "1.6.0",
   "description": "Agent-friendly CLI for the Viatris exam OpenAPI",
   "type": "module",
   "bin": {

package/skills/viatris-exam-cli/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: viatris-exam-cli
 description: Operate the Viatris exam OpenAPI through its agent-friendly CLI. Use for products, knowledge nodes or documents, generation tasks, exam records, scoring, exams, questions, or medical search.
-version: 1.4.1
+version: 1.6.0
 ---
 
 # Viatris Exam CLI
@@ -22,11 +22,14 @@ Use the repository-local CLI for every supported API operation. Do not call the
 - Prefer `--input <file>` for existing payloads and stdin for generated payloads.
 - Parse successful `stdout` as JSON.
 - Parse failed `stderr` as JSON and branch on both exit code and `error.type`.
+- Use `products list` to resolve product master IDs and stable codes before product-specific workflows. `products create` requires only a Chinese name and also initializes the canonical knowledge-tree root.
+- Use `products update` only for verified optional medical master data. Do not infer English names, generic names, indications, dosage forms, or remarks without evidence.
 - Preserve `externalRef` when retrying question submission. It is the idempotency key.
 - For product-wide generation tasks, create one or more questions for every entry in `knowledgeContexts` and include its `knowledgeNodeId`.
 - Apply every returned generation rule. Product-scoped rules identify applicable product codes through `products`; global rules return an empty `products` array.
 - Prefer scoring rule V2 for generated questions and scoring results. Use stable point and deduction-rule IDs.
-- Treat product IDs as hidden containers, not knowledge-tree levels. Fixed dimensions are business L1; generated nodes are L2-L4.
+- Treat product master records as outside business knowledge-tree levels. Fixed dimensions are business L1; generated nodes are L2-L4. Product detail lookup also accepts a historical knowledge-tree root ID.
+- Treat knowledge-tree and recursive node deletion as destructive. Inspect the target first and perform them only when the user explicitly requests deletion.
 - Do not automatically retry POST, PUT, PATCH, or DELETE commands. Inspect the returned error and determine whether the server accepted the request.
 - Keep temporary payloads outside the repository unless they are requested deliverables.
 

package/skills/viatris-exam-cli/references/cli-reference.md

@@ -42,13 +42,50 @@ node src/cli.js --version
 
 ## Commands
 
+List product master data:
+
+```bash
+node src/cli.js products list --compact
+```
+
+The response is `{ "items": [...] }`, ordered by `sortOrder` and then name. Each record includes the stable `code`, Chinese name, optional English name, generic name, indication, dosage form, `active` or `inactive` status, remark, and timestamps.
+
+Create a product and initialize its canonical knowledge-tree root:
+
+```bash
+node src/cli.js products create --json '{
+  "name": "络活喜",
+  "genericName": "苯磺酸氨氯地平片",
+  "indication": "高血压、冠心病",
+  "dosageForm": "片剂",
+  "sortOrder": 20,
+  "remark": "由外部系统创建"
+}'
+```
+
+Only `name` is required and the Chinese name must be unique. `code` is optional; when supplied it must contain only lowercase letters, digits, and hyphens and be globally unique, while omission lets the server generate it. `nameEn` and the remaining fields are optional. Omitted `sortOrder` defaults to 0. This POST is not automatically retried; after an uncertain network outcome, list products and resolve by name or code before attempting another create.
+
 Get a product and its fixed L1 dimensions:
 
 ```bash
 node src/cli.js products get "$PRODUCT_ID" --compact
 ```
 
-The product ID represents a hidden system container and is not part of business levels L1-L4. Use each returned `fixedDimensions[].clientRef` as the parent reference for an L2 node. Each fixed dimension also returns `level: 1` and a display `codePrefix`.
+Use the product master `id`; historical knowledge-tree root IDs remain accepted for compatibility. The response also contains nullable `nameEn`, `genericName`, `indication`, `dosageForm`, and `remark`. Product master data is outside business levels L1-L4. Use each returned `fixedDimensions[].clientRef` as the parent reference for an L2 node. Each fixed dimension also returns `level: 1` and a display `codePrefix`.
+
+Update verified optional medical master data:
+
+```bash
+node src/cli.js products update "$PRODUCT_ID" --json '{
+  "nameEn": "Lipitor",
+  "genericName": "阿托伐他汀钙片",
+  "indication": "高胆固醇血症、混合型血脂异常及心血管疾病预防",
+  "dosageForm": "片剂 10mg/20mg/40mg",
+  "remark": "生产企业：辉瑞制药有限公司"
+}'
+```
+
+Only supplied fields are updated. Each supplied value must be a nonempty string within the API length limit. Update these fields only from verified source material; this endpoint does not update `code`, Chinese `name`, status, or sort order.
 
 Replace a product knowledge tree:
 
@@ -100,6 +137,14 @@ Payload shape:
 
 Submit the complete L2/L3/L4 node set, between 15 and 500 nodes. Every `clientRef` must be unique within the payload. L2 nodes use `dimension:<code>` as `parentClientRef`; L3/L4 nodes use their direct parent's `clientRef`. Every L4 node needs at least one document. A successful PUT replaces the previous dynamic nodes, so do not send a partial tree.
 
+Delete all dynamic knowledge-tree content:
+
+```bash
+node src/cli.js products delete-knowledge-tree "$PRODUCT_ID"
+```
+
+This destructive operation preserves the product root and five fixed L1 dimensions, deletes all L2-L4 nodes and evidence documents, and unbinds affected questions. Inspect the product and tree first, and execute only when the user explicitly requests the full reset.
+
 ### Incremental Knowledge Management
 
 Get the complete physical tree and all product documents:
@@ -135,9 +180,10 @@ node src/cli.js knowledge nodes update "$NODE_ID" \
 node src/cli.js knowledge nodes move "$NODE_ID" \
   --json '{"newParentId":"NEW_PARENT_ID","sortOrder":30}'
 node src/cli.js knowledge nodes delete "$NODE_ID"
+node src/cli.js knowledge nodes delete "$NODE_ID" --recursive
 ```
 
-Product roots and fixed dimensions are protected from rename, move, and deletion. Moving cannot cross products, target the node itself or its descendants, or produce levels deeper than L4. Deleting a node deletes its entire subtree and attached documents; inspect the node first and only delete when explicitly required.
+Product roots and fixed dimensions are protected from rename, move, and deletion. Moving cannot cross products, target the node itself or its descendants, or produce levels deeper than L4. Plain deletion is the safe default and returns HTTP 409 when children or question bindings exist. `--recursive` deletes the full subtree and documents and unbinds affected questions. Inspect the node first and use recursive deletion only when explicitly requested.
 
 Manage documents:
 

package/src/args.js

@@ -1,6 +1,6 @@
 import { CliError } from "./errors.js";
 
-const BOOLEAN_OPTIONS = new Set(["help", "compact", "version"]);
+const BOOLEAN_OPTIONS = new Set(["help", "compact", "version", "recursive"]);
 const GLOBAL_OPTIONS = [
   "base_url",
   "key_header",

package/src/command-handlers/knowledge.js

@@ -61,9 +61,12 @@ export async function resolveKnowledge(positionals, options) {
 
   if (area === "nodes" && action === "delete") {
     assertNoExtraPositionals(positionals, 4);
-    assertOptions(options);
+    assertOptions(options, ["recursive"]);
     const id = nodePath(positionals, "knowledge node ID");
-    return { method: "DELETE", path: `/openapi/knowledge/nodes/${id}` };
+    return {
+      method: "DELETE",
+      path: `/openapi/knowledge/nodes/${id}${options.recursive ? "?recursive=true" : ""}`,
+    };
   }
 
   if (area === "nodes" && action === "move") {

package/src/command-handlers/products.js

@@ -9,6 +9,22 @@ export async function resolveProducts(positionals, options) {
   const [resource, action] = positionals;
   if (resource !== "products") return null;
 
+  if (action === "list") {
+    assertNoExtraPositionals(positionals, 2);
+    assertOptions(options);
+    return { method: "GET", path: "/openapi/products" };
+  }
+
+  if (action === "create") {
+    assertNoExtraPositionals(positionals, 2);
+    assertOptions(options, ["input", "json"]);
+    return {
+      method: "POST",
+      path: "/openapi/products",
+      body: await readJsonInput(options),
+    };
+  }
+
   if (action === "get") {
     assertNoExtraPositionals(positionals, 3);
     assertOptions(options);
@@ -16,6 +32,17 @@ export async function resolveProducts(positionals, options) {
     return { method: "GET", path: `/openapi/products/${id}` };
   }
 
+  if (action === "update") {
+    assertNoExtraPositionals(positionals, 3);
+    assertOptions(options, ["input", "json"]);
+    const id = requiredId(positionals, 2, "product ID");
+    return {
+      method: "PATCH",
+      path: `/openapi/products/${id}`,
+      body: await readJsonInput(options),
+    };
+  }
+
   if (action === "update-knowledge-tree") {
     assertNoExtraPositionals(positionals, 3);
     assertOptions(options, ["input", "json"]);
@@ -27,5 +54,15 @@ export async function resolveProducts(positionals, options) {
     };
   }
 
+  if (action === "delete-knowledge-tree") {
+    assertNoExtraPositionals(positionals, 3);
+    assertOptions(options);
+    const id = requiredId(positionals, 2, "product ID");
+    return {
+      method: "DELETE",
+      path: `/openapi/products/${id}/knowledge-tree`,
+    };
+  }
+
   return null;
 }

package/src/help.js

@@ -8,14 +8,18 @@ Usage:
   viatris-exam describe
 
 Commands:
+  products list
+  products create --input <file|->
   products get <product-id>
+  products update <product-id> --input <file|->
   products update-knowledge-tree <product-id> --input <file|->
+  products delete-knowledge-tree <product-id>
   knowledge tree <product-code>
   knowledge nodes by-path --input <file|->
   knowledge nodes create --input <file|->
   knowledge nodes get <node-id>
   knowledge nodes update <node-id> --input <file|->
-  knowledge nodes delete <node-id>
+  knowledge nodes delete <node-id> [--recursive]
   knowledge nodes move <node-id> --input <file|->
   knowledge documents list <node-id>
   knowledge documents create <node-id> --input <file|->

package/src/metadata.js

@@ -1,4 +1,4 @@
-export const VERSION = "1.4.1";
+export const VERSION = "1.6.0";
 export const DEFAULT_TIMEOUT_MS = 30_000;
 export const DEFAULT_RETRIES = 2;
 
@@ -15,12 +15,32 @@ export const API_ENVIRONMENT_ALIASES = Object.freeze({
 });
 
 export const COMMANDS = Object.freeze([
+  {
+    command: "products list",
+    method: "GET",
+    path: "/openapi/products",
+    summary: "List all product master records in display order.",
+  },
+  {
+    command: "products create",
+    method: "POST",
+    path: "/openapi/products",
+    input: "{name, code?, nameEn?, genericName?, indication?, dosageForm?, sortOrder?, remark?}",
+    summary: "Create a product and initialize its canonical knowledge-tree root.",
+  },
   {
     command: "products get <product-id>",
     method: "GET",
     path: "/openapi/products/{id}",
     summary: "Get a product, knowledge-tree status, and fixed dimensions.",
   },
+  {
+    command: "products update <product-id>",
+    method: "PATCH",
+    path: "/openapi/products/{id}",
+    input: "{nameEn?, genericName?, indication?, dosageForm?, remark?}",
+    summary: "Update verified optional medical product master data.",
+  },
   {
     command: "products update-knowledge-tree <product-id>",
     method: "PUT",
@@ -28,6 +48,12 @@ export const COMMANDS = Object.freeze([
     input: "{nodes: [...]}",
     summary: "Replace the product's dynamic L2/L3/L4 knowledge-tree nodes.",
   },
+  {
+    command: "products delete-knowledge-tree <product-id>",
+    method: "DELETE",
+    path: "/openapi/products/{id}/knowledge-tree",
+    summary: "Delete all dynamic product knowledge-tree nodes and documents.",
+  },
   {
     command: "knowledge tree <product-code>",
     method: "GET",
@@ -65,7 +91,10 @@ export const COMMANDS = Object.freeze([
     command: "knowledge nodes delete <node-id>",
     method: "DELETE",
     path: "/openapi/knowledge/nodes/{id}",
-    summary: "Delete a knowledge node, its subtree, and documents.",
+    options: {
+      "--recursive": "delete descendants, documents, and node bindings",
+    },
+    summary: "Delete a node, optionally recursing through its subtree.",
   },
   {
     command: "knowledge nodes move <node-id>",