viatris-exam-cli 1.4.0 → 1.4.1

package/README.md

@@ -148,18 +148,18 @@ viatris-exam questions version "$QUESTION_ID" --input version.json
 ```bash
 viatris-exam medical-search search "阿托伐他汀 适应症" \
   --file-type drug \
-  --limit 4 \
+  --limit 20 \
   --max-length 1200
 ```
 
 也可提交完整 JSON：
 
 ```bash
-printf '%s' '{"query":"阿托伐他汀 适应症","limit":4}' |
+printf '%s' '{"query":"阿托伐他汀 适应症","limit":20}' |
   viatris-exam medical-search search
 ```
 
-响应中的 `rawJson` 已是结构化对象，可直接读取 `rawJson.documents`，无需再次 `JSON.parse`。
+`limit` 允许 1-20，省略时默认为 20。响应中的 `rawJson` 已是结构化对象，可直接读取 `rawJson.documents`，无需再次 `JSON.parse`。
 
 ## 错误格式
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "viatris-exam-cli",
-  "version": "1.4.0",
+  "version": "1.4.1",
   "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.0
+version: 1.4.1
 ---
 
 # Viatris Exam CLI
@@ -24,6 +24,7 @@ Use the repository-local CLI for every supported API operation. Do not call the
 - Parse failed `stderr` as JSON and branch on both exit code and `error.type`.
 - 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.
 - Do not automatically retry POST, PUT, PATCH, or DELETE commands. Inspect the returned error and determine whether the server accepted the request.

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

@@ -173,6 +173,8 @@ node src/cli.js gen-tasks get "$TASK_ID" --compact
 
 For a leaf-node task, `knowledgeContext` is the mandatory target context. For a product-wide task, `dimension` is `all`, `knowledgeContext` is null, and `knowledgeContexts` contains every leaf context. Generate `questionsPerNode` questions for every listed context and follow all returned `rules`.
 
+Each rule has `scope` and `products`. For `scope: "product"`, `products` contains one or more applicable product codes. For `scope: "global"`, `products` is an empty array. Do not read the removed single-value `product` field.
+
 Submit generated questions:
 
 ```bash
@@ -327,7 +329,7 @@ Search medical evidence:
 ```bash
 node src/cli.js medical-search search "阿托伐他汀 适应症" \
   --file-type drug \
-  --limit 4 \
+  --limit 20 \
   --max-length 1200 \
   --compact
 ```
@@ -335,11 +337,11 @@ node src/cli.js medical-search search "阿托伐他汀 适应症" \
 Or use JSON:
 
 ```bash
-printf '%s' '{"query":"阿托伐他汀 适应症","limit":4}' |
+printf '%s' '{"query":"阿托伐他汀 适应症","limit":20}' |
   node src/cli.js medical-search search --compact
 ```
 
-Do not combine query flags with JSON input.
+Do not combine query flags with JSON input. `limit` accepts 1-20 and defaults to 20 when omitted. `maxLength` defaults to 1200.
 
 The response `rawJson` is already a structured object. Read `rawJson.documents` directly; do not call `JSON.parse`. Each result contains `rank`, `doc_info`, optional `medical_info`, and the upstream `logid`.
 

package/src/help.js

@@ -39,6 +39,9 @@ Input:
   --json <object>        Pass a JSON object inline.
   Piped stdin            Used automatically by commands that require JSON.
 
+Medical search:
+  --limit defaults to 20 when omitted; valid range is 1..20.
+
 Global options:
   --base-url <url>       Override the selected environment URL.
   --key-header <name>    Override VIATRIS_API_KEY_HEADER (default: X-API-Key).

package/src/metadata.js

@@ -1,4 +1,4 @@
-export const VERSION = "1.4.0";
+export const VERSION = "1.4.1";
 export const DEFAULT_TIMEOUT_MS = 30_000;
 export const DEFAULT_RETRIES = 2;
 
@@ -182,7 +182,7 @@ export const COMMANDS = Object.freeze([
     path: "/openapi/medical-search",
     options: {
       "--file-type": "string",
-      "--limit": "integer:1..20",
+      "--limit": "integer:1..20 (default:20)",
       "--max-length": "integer:100..5000",
     },
     input: "query flags or a JSON object",