viatris-exam-cli 1.4.1 → 1.5.0

package/README.md

@@ -72,6 +72,15 @@ viatris-exam describe --compact
 
 ## 命令
 
+### 产品主数据
+
+```bash
+viatris-exam products list
+viatris-exam products create --input product.json
+```
+
+创建产品时必须提供全局唯一的 `code`、中文名称 `name` 和英文名称 `nameEn`，并会同步初始化规范知识树根节点。创建请求不会自动重试；网络结果不确定时，应先按列表中的稳定编码确认是否已创建。
+
 ### 产品知识树
 
 ```bash
@@ -80,7 +89,7 @@ viatris-exam products update-knowledge-tree "$PRODUCT_ID" \
   --input knowledge-tree.json
 ```
 
-产品是隐藏系统容器，不属于业务知识树层级。固定维度为 L1；知识树回写是完整替换操作，必须一次提交全部 15-500 个 L2/L3/L4 动态节点。先查询产品以获取固定 L1 维度的 `clientRef`。
+产品主数据不属于业务知识树层级；详情查询使用产品主数据 ID，并兼容历史知识树根节点 ID。固定维度为 L1；知识树回写是完整替换操作，必须一次提交全部 15-500 个 L2/L3/L4 动态节点。先查询产品以获取固定 L1 维度的 `clientRef`。
 
 ### 知识节点与文档
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "viatris-exam-cli",
-  "version": "1.4.1",
+  "version": "1.5.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.5.0
 ---
 
 # Viatris Exam CLI
@@ -22,11 +22,12 @@ 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` also initializes the canonical knowledge-tree root.
 - 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.
 - 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,38 @@ 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 and English names, optional 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 '{
+  "code": "norvasc",
+  "name": "络活喜",
+  "nameEn": "Norvasc",
+  "genericName": "苯磺酸氨氯地平片",
+  "indication": "高血压、冠心病",
+  "dosageForm": "片剂",
+  "sortOrder": 20,
+  "remark": "由外部系统创建"
+}'
+```
+
+`code`, `name`, and `nameEn` are required. The code must contain only lowercase letters, digits, and hyphens and must be globally unique. The Chinese name must also be unique. Omitted `sortOrder` defaults to 0. This POST is not automatically retried; after an uncertain network outcome, list products and resolve by 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. 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`.
 
 Replace a product knowledge tree:
 

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);

package/src/help.js

@@ -8,6 +8,8 @@ Usage:
   viatris-exam describe
 
 Commands:
+  products list
+  products create --input <file|->
   products get <product-id>
   products update-knowledge-tree <product-id> --input <file|->
   knowledge tree <product-code>

package/src/metadata.js

@@ -1,4 +1,4 @@
-export const VERSION = "1.4.1";
+export const VERSION = "1.5.0";
 export const DEFAULT_TIMEOUT_MS = 30_000;
 export const DEFAULT_RETRIES = 2;
 
@@ -15,6 +15,19 @@ 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: "{code, name, nameEn, genericName?, indication?, dosageForm?, sortOrder?, remark?}",
+    summary: "Create a product and initialize its canonical knowledge-tree root.",
+  },
   {
     command: "products get <product-id>",
     method: "GET",