@rishiqing/cli 0.1.3 → 0.1.5

package/README.md

@@ -6,19 +6,7 @@
 
 面向 Agent 和开发者的日事清 CLI，由 `rishiqing.openapi.json` 驱动命令注册。它不是简单包一层 HTTP 请求，而是把“发现命令、理解参数、预览请求、执行调用”整理成一套稳定的终端接口，方便人和 AI Agent 直接操作日事清。
 
-[安装](#安装与快速开始) · [Agent 能力](#agent-能力) · [命令体系](#命令体系) · [进阶用法](#进阶用法) · [安全](#安全与约束) · [开发](#开发)
-
-## 功能
-
-当前共提供 **54** 个命令，覆盖 5 个业务域：
-
-| 类别 | 当前能力 |
-| --- | --- |
-| `workflow` | 流程应用、模板、步骤、表单、审核项、流程实例、运行中步骤流转 |
-| `project` | 项目、模块、卡片、项目成员 |
-| `task` | 创建、查询、更新、完成、删除任务，评论，执行人/负责人/参与人维护 |
-| `datasheet` | 数据表列表、字段、记录的查询/新增/更新/删除 |
-| `contacts` | 全员列表、按姓名解析 `userId` |
+[安装](#安装与快速开始) · [Agent 能力](#agent-能力) · [命令体系](#命令体系) · [进阶用法](#进阶用法) · [安全](#安全与约束)
 
 ## 安装与快速开始
 
@@ -39,7 +27,7 @@
 npm install -g @rishiqing/cli
 ```
 
-# 安装 CLI Skill（推荐）
+#### 安装 CLI Skill
 ```bash
 rsq-cli install
 ```
@@ -79,14 +67,6 @@ rsq-cli config init
 rsq-cli config path
 ```
 
-设置接口域名：
-
-```bash
-rsq-cli config baseurl
-rsq-cli config baseurl www.rishiqing.com
-rsq-cli config baseurl https://www.rishiqing.com
-```
-
 ## Agent 能力
 
 `rsq-cli` 既提供内建的 agent contract，也保留了仓库内可复用的 skill。
@@ -96,6 +76,7 @@ rsq-cli config baseurl https://www.rishiqing.com
 | `describe` | 结构化输出全部命令、参数、请求体 schema、示例 |
 | `search` | 按自然语言意图检索命令 |
 | `describe-agent-contract` | 输出面向 Agent 的路由规则、领域关键词和全局约束 |
+| `agent` | 面向 Agent 的包装命令；收到内联 `--body` 时会自动落盘并转成 `--body-file` 执行 |
 | `skills/rishiqing` | 识别“日事清”领域请求并路由到对应模块 |
 | `skills/rsq-workflow-createFlowApplication` | 根据流程场景自动创建流程应用，优先匹配模板，匹配不到回退到标准模式 |
 
@@ -118,7 +99,8 @@ rsq-cli task --help
 例如：
 
 ```bash
-rsq-cli project create --body '{"name":"新项目"}' --json
+echo '{"name":"新项目"}' > request.json
+rsq-cli project create --body-file request.json --json
 rsq-cli task get --task-id task_xxx --json
 rsq-cli workflow list-templates --json
 ```
@@ -128,10 +110,10 @@ rsq-cli workflow list-templates --json
 这类命令会在内部串联多个步骤，适合 Agent 直接调用：
 
 ```bash
-rsq-cli contacts resolve-user --user-name 张三 --json
-rsq-cli task set-executor-by-name --task-id task_xxx --user-name 张三 --json
-rsq-cli project set-member-by-name --project-id proj_xxx --user-name 李四 --json
-rsq-cli workflow create-audit-by-names \
+rsq-cli agent contacts resolve-user --user-name 张三 --json
+rsq-cli agent task set-executor-by-name --task-id task_xxx --user-name 张三 --json
+rsq-cli agent project set-member-by-name --project-id proj_xxx --user-name 李四 --json
+rsq-cli agent workflow create-audit-by-names \
   --flow-application-id flow_xxx \
   --step-info-id step_xxx \
   --audit-info-name 部门审批 \
@@ -156,32 +138,3 @@ rsq-cli describe-agent-contract
 本工具可被 AI Agent 调用执行真实的日事清写操作，因此请务必注意：
 
 - `X-Rsq-Api-key` 具备真实权限，不应出现在日志、截图或共享终端中
-- 生产环境与测试环境的 `baseUrl` 应严格区分
-
-## 开发
-
-### 安装依赖
-
-```bash
-npm install
-```
-
-### 类型检查
-
-```bash
-npm run check
-```
-
-### 构建
-
-```bash
-npm run build
-```
-
-### 本地调试
-
-```bash
-node dist/cli.js --help
-node dist/cli.js search "create task" --json
-node dist/cli.js describe --json
-```

package/dist/cli.js

@@ -2,14 +2,16 @@
 
 // src/cli.ts
 import { Command, InvalidArgumentError, Option } from "commander";
-import { readFile as readFile2 } from "fs/promises";
+import { mkdtemp, readFile as readFile2, rm, writeFile as writeFile2 } from "fs/promises";
+import os3 from "os";
+import path4 from "path";
 import readline from "readline/promises";
 import { stdin, stdout } from "process";
 
 // package.json
 var package_default = {
   name: "@rishiqing/cli",
-  version: "0.1.3",
+  version: "0.1.5",
   description: "Agent-oriented CLI for Rishiqing APIs",
   license: "MIT",
   type: "module",
@@ -1154,7 +1156,9 @@ function getSkillContract() {
     globalRules: [
       "\u9047\u5230\u65E5\u4E8B\u6E05\u9886\u57DF\u77ED\u8BED\u65F6\uFF0C\u5148\u8BC6\u522B\u4E3A rsq-cli \u64CD\u4F5C\u610F\u56FE\uFF0C\u4E0D\u8981\u628A\u5B83\u5F53\u6210\u6CDB\u5316\u9879\u76EE\u7BA1\u7406\u8BF7\u6C42\u3002",
       "\u4E0D\u786E\u5B9A\u5177\u4F53\u547D\u4EE4\u65F6\uFF0C\u5148\u8C03\u7528 rsq-cli search\uFF1B\u786E\u8BA4\u5019\u9009\u547D\u4EE4\u540E\u518D\u8C03\u7528 rsq-cli describe \u9605\u8BFB\u53C2\u6570\u548C requestBodySchema\u3002",
+      "\u771F\u6B63\u6267\u884C API \u547D\u4EE4\u65F6\uFF0C\u4F18\u5148\u8D70 rsq-cli agent <module> <command> ...\uFF1Bdescribe/search \u7EE7\u7EED\u8D70\u539F\u5165\u53E3\u3002",
       "\u6D89\u53CA\u521B\u5EFA\u3001\u66F4\u65B0\u3001\u7ED1\u5B9A\u3001\u5206\u914D\u7B49\u5199\u64CD\u4F5C\u65F6\uFF0C\u4F18\u5148\u4F7F\u7528 --dry-run --json \u9884\u89C8\u3002",
+      "\u53EA\u8981\u547D\u4EE4\u5E26 request body\uFF0C\u4F18\u5148\u628A JSON \u5199\u5165\u6587\u4EF6\u5E76\u901A\u8FC7 --body-file \u4F20\u5165\uFF0C\u4E0D\u8981\u9ED8\u8BA4\u62FC\u5185\u8054 --body\u3002",
       "\u6240\u6709 id \u5B57\u6BB5\u90FD\u5FC5\u987B\u4F20\u524D\u7F00+uuid\u98CE\u683C\u7684\u5B57\u7B26\u4E32\uFF0C\u4F8B\u5982 flowApp_019d6c0c2f03770b8b789ec313076e64\u3002",
       "\u4E0D\u8981\u4F20\u6570\u5B57\u7C7B\u578B id\uFF0C\u4E5F\u4E0D\u8981\u4F20\u7EAF\u6570\u5B57\u5B57\u7B26\u4E32 id\u3002",
       "\u8C03\u7528\u524D\u4F18\u5148\u9605\u8BFB\u53C2\u6570\u8BF4\u660E\u548C requestBodySchema \u4E2D\u7684\u5B57\u6BB5\u8BF4\u660E\uFF0C\u518D\u7EC4\u88C5\u53C2\u6570\u3002"
@@ -1206,6 +1210,7 @@ async function main() {
   registerDescribe(program);
   registerInstall(program);
   registerSearch(program);
+  registerAgent(program);
   for (const moduleDefinition of getModuleDefinitions()) {
     const moduleCommand = program.command(moduleDefinition.name).description(moduleDefinition.description);
     for (const definition of getRegistry().filter((entry) => entry.module === moduleDefinition.name)) {
@@ -1391,7 +1396,32 @@ function registerSearch(program) {
     printOutput(ranked, options);
   });
 }
-function registerApiCommand(parent, definition) {
+function registerAgent(program) {
+  const agent = program.command("agent").description("Agent-oriented wrappers that stabilize request body handling");
+  for (const moduleDefinition of getModuleDefinitions()) {
+    const moduleCommand = agent.command(moduleDefinition.name).description(moduleDefinition.description);
+    for (const definition of getRegistry().filter((entry) => entry.module === moduleDefinition.name)) {
+      if (definition.module === "contacts" && definition.name === "resolveUser") {
+        registerResolveUserCommand(moduleCommand, definition);
+        continue;
+      }
+      if (definition.module === "task" && ["setTaskExecutorByName", "setTaskResponsibleByName", "addTaskParticipantByName"].includes(definition.name)) {
+        registerTaskUserByNameCommand(moduleCommand, definition);
+        continue;
+      }
+      if (definition.module === "project" && definition.name === "setProjectMemberByName") {
+        registerProjectUserByNameCommand(moduleCommand, definition);
+        continue;
+      }
+      if (definition.module === "workflow" && ["createAuditInfoByNames", "updateAuditInfoByNames"].includes(definition.name)) {
+        registerWorkflowAuditByNamesCommand(moduleCommand, definition);
+        continue;
+      }
+      registerApiCommand(moduleCommand, definition, "agent-wrapper");
+    }
+  }
+}
+function registerApiCommand(parent, definition, mode = "direct") {
   if (!definition.api) {
     throw new Error(`Missing API mapping for command: ${definition.module} ${definition.name}`);
   }
@@ -1410,9 +1440,15 @@ function registerApiCommand(parent, definition) {
     command.addOption(new Option("--body-file <path>", "Read JSON request body from a file"));
   }
   command.action(async (options) => {
-    const body = sanitizeRequestBody(definition, await readBody(options));
+    await executeApiCommand(definition, options, mode);
+  });
+}
+async function executeApiCommand(definition, options, mode) {
+  const resolvedOptions = await prepareBodyOptions(options, mode);
+  try {
+    const body = sanitizeRequestBody(definition, await readBody(resolvedOptions));
     validateRequestBody(definition, body);
-    const request = buildRequest(definition, options, body);
+    const request = buildRequest(definition, resolvedOptions, body);
     if (options.dryRun) {
       const appConfig = await readAppConfig();
       printOutput(
@@ -1422,7 +1458,11 @@ function registerApiCommand(parent, definition) {
           api: definition.api,
           baseUrl: appConfig.baseUrl,
           url: new URL(request.path, ensureTrailingSlash2(appConfig.baseUrl)).toString(),
-          request
+          request,
+          agentWrapper: mode === "agent-wrapper" ? {
+            enabled: true,
+            requestBodyTransport: resolvedOptions.bodyFile ? "body-file" : "none"
+          } : void 0
         },
         { json: true }
       );
@@ -1432,7 +1472,9 @@ function registerApiCommand(parent, definition) {
     if (!options.quiet) {
       printOutput(result, options);
     }
-  });
+  } finally {
+    await cleanupPreparedBodyOptions(resolvedOptions);
+  }
 }
 function registerResolveUserCommand(parent, definition) {
   const command = parent.command(definition.name).description(definition.summary);
@@ -1673,29 +1715,8 @@ function sanitizeRequestBody(definition, body) {
   if (body === void 0) {
     return void 0;
   }
-  if (definition.module === "workflow" && definition.name === "createForm") {
-    return sanitizeWorkflowCreateFormBody(body);
-  }
   return body;
 }
-function sanitizeWorkflowCreateFormBody(body) {
-  if (!isRecord(body)) {
-    return body;
-  }
-  const sanitized = { ...body };
-  delete sanitized.formId;
-  if (Array.isArray(body.fields)) {
-    sanitized.fields = body.fields.map((field) => {
-      if (!isRecord(field)) {
-        return field;
-      }
-      const sanitizedField = { ...field };
-      delete sanitizedField.fieldId;
-      return sanitizedField;
-    });
-  }
-  return sanitized;
-}
 function validateRequestBody(definition, body) {
   if (!definition.hasRequestBody || body === void 0 || !definition.requestBodySchema) {
     return;
@@ -1722,19 +1743,19 @@ function validateCustomBodyRules(definition, body, issues) {
     }
   }
 }
-function validateValueAgainstSchema(value, schema, path4, issues) {
+function validateValueAgainstSchema(value, schema, path5, issues) {
   if (value === void 0 || value === null) {
     return;
   }
   if (schema.type === "object" && isRecord(value)) {
     for (const requiredKey of schema.required ?? []) {
       if (!(requiredKey in value)) {
-        issues.push(`${path4}.${requiredKey}: missing required field`);
+        issues.push(`${path5}.${requiredKey}: missing required field`);
       }
     }
     for (const [propertyName, propertySchema] of Object.entries(schema.properties ?? {})) {
       if (propertyName in value) {
-        validateValueAgainstSchema(value[propertyName], propertySchema, `${path4}.${propertyName}`, issues);
+        validateValueAgainstSchema(value[propertyName], propertySchema, `${path5}.${propertyName}`, issues);
       }
     }
     return;
@@ -1742,19 +1763,19 @@ function validateValueAgainstSchema(value, schema, path4, issues) {
   if (schema.type === "array" && Array.isArray(value)) {
     value.forEach((item, index) => {
       if (schema.items) {
-        validateValueAgainstSchema(item, schema.items, `${path4}[${index}]`, issues);
+        validateValueAgainstSchema(item, schema.items, `${path5}[${index}]`, issues);
       }
     });
     return;
   }
   if (schema.type === "string" && typeof value === "string") {
-    validateStringByDescription(value, schema.description, path4, issues);
+    validateStringByDescription(value, schema.description, path5, issues);
   }
 }
-function validateIdLikeBodyValues(value, path4, issues) {
+function validateIdLikeBodyValues(value, path5, issues) {
   if (Array.isArray(value)) {
     value.forEach((item, index) => {
-      validateIdLikeBodyValues(item, `${path4}[${index}]`, issues);
+      validateIdLikeBodyValues(item, `${path5}[${index}]`, issues);
     });
     return;
   }
@@ -1762,7 +1783,7 @@ function validateIdLikeBodyValues(value, path4, issues) {
     return;
   }
   for (const [key, fieldValue] of Object.entries(value)) {
-    const nextPath = `${path4}.${key}`;
+    const nextPath = `${path5}.${key}`;
     if (looksLikeIdField2(key)) {
       const issue = getIdLikeValidationIssue(fieldValue, nextPath);
       if (issue) {
@@ -1811,7 +1832,7 @@ function getIdLikeValidationIssue(value, label) {
   }
   return void 0;
 }
-function validateStringByDescription(value, description, path4, issues) {
+function validateStringByDescription(value, description, path5, issues) {
   if (!description) {
     return;
   }
@@ -1819,7 +1840,7 @@ function validateStringByDescription(value, description, path4, issues) {
     const isDateOnly = /^\d{4}-\d{2}-\d{2}$/.test(value);
     const isOffsetDateTime = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:Z|[+-]\d{2}:\d{2})$/.test(value);
     if (!isDateOnly && !isOffsetDateTime) {
-      issues.push(`${path4}: invalid format "${value}". Allowed formats: yyyy-MM-dd or yyyy-MM-dd'T'HH:mm:ssXXX`);
+      issues.push(`${path5}: invalid format "${value}". Allowed formats: yyyy-MM-dd or yyyy-MM-dd'T'HH:mm:ssXXX`);
     }
   }
 }
@@ -1835,6 +1856,26 @@ async function readBody(options) {
   }
   return void 0;
 }
+async function prepareBodyOptions(options, mode) {
+  if (mode !== "agent-wrapper" || !options.body) {
+    return options;
+  }
+  const tempDir = await mkdtemp(path4.join(os3.tmpdir(), "rsq-cli-agent-"));
+  const bodyFile = path4.join(tempDir, "request.json");
+  await writeFile2(bodyFile, options.body, "utf8");
+  return {
+    ...options,
+    body: void 0,
+    bodyFile,
+    __tempDir: tempDir
+  };
+}
+async function cleanupPreparedBodyOptions(options) {
+  if (!options.__tempDir) {
+    return;
+  }
+  await rm(options.__tempDir, { recursive: true, force: true });
+}
 function optionName(parameterName) {
   return `--${toKebabCase(parameterName)} <value>`;
 }