@cnbcool/cnb-cli 1.2.6 → 1.3.0

package/bin/cnb.js

@@ -1,3 +1,3 @@
 #!/usr/bin/env node
 
-require("../skills/cnb-api/scripts/core/index.js");
+require("../cli/core/index.js");

package/{skills/cnb-api/scripts → cli}/core/config/cag.config.js

@@ -1,6 +1,7 @@
 module.exports = {
   target: 'https://api.cnb.cool/swagger.json',
   skillsOutputDir: `./skills/cnb-api`,
+  skillScriptOutputDir: `./cli`,
   // skillsDev: true,
   skillConfig: {
     fetchConfig: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cnbcool/cnb-cli",
-  "version": "1.2.6",
+  "version": "1.3.0",
   "description": "CNB OpenAPI 命令行工具，基于 CNB 平台 Swagger 自动生成，支持 Issues、PR、Git、组织管理等全部 API 操作",
   "main": "skills/cnb-api/scripts/core/index.js",
   "bin": {
@@ -8,7 +8,7 @@
   },
   "files": [
     "bin/",
-    "skills/cnb-api/scripts/"
+    "cli/"
   ],
   "engines": {
     "node": ">=18.0.0"
@@ -37,6 +37,6 @@
     "skills": "^1.4.4"
   },
   "dependencies": {
-    "@cnbcool/cnb-api-generate": "^2.2.2"
+    "@cnbcool/cnb-api-generate": "^2.3.0"
   }
 }

package/skills/cnb-api/scripts/core/modules.help.js

@@ -1,53 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.showModuleHelp = showModuleHelp;
-exports.trimSummary = trimSummary;
-/**
- * 去除 summary 中的英文部分（保留中文句号前的内容）
- */
-function trimSummary(summary) {
-  if (!summary) return '';
-  // 匹配中文句号"。"后面跟英文的模式，只保留中文部分
-  const match = summary.match(/^(.*?[\u4e00-\u9fff].*?)[。.]\s*[A-Z]/);
-  if (match) return match[1];
-  // 没有匹配到则返回原文
-  return summary;
-}
-
-/**
- * 显示模块帮助文档
- * @param helpData 帮助数据
- * @param moduleName 模块名称
- */
-function showModuleHelp(helpData, moduleName) {
-  const moduleHelpData = helpData.modulesHelp[moduleName];
-  if (!moduleHelpData) {
-    console.error(`模块 ${moduleName} 不存在`);
-    process.exit(1);
-  }
-  const cliCmd = "cnb" || 'cnb';
-  const entries = Object.values(moduleHelpData).map(info => ({
-    name: info.filename,
-    summary: trimSummary(info.summary || '')
-  }));
-  const maxNameLen = Math.max(...entries.map(e => e.name.length));
-  const pad = maxNameLen + 2;
-  let toolListMsg = '';
-  for (const {
-    name,
-    summary
-  } of entries) {
-    toolListMsg += `  ${name.padEnd(pad)} ${summary}\n`;
-  }
-  const helpMsg = `
-${moduleName} 模块
-
-工具:
-${toolListMsg}
-用法: ${cliCmd} ${moduleName} <tool> --help
-`;
-  console.log(helpMsg);
-}

package/skills/cnb-api/scripts/core/schemaToJson.js

@@ -1,32 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.schemaToJson = schemaToJson;
-function schemaToJson(schema, json) {
-  if (schema.type === 'object' || schema.type === 'array') {
-    const props = schema.type === 'object' ? schema.properties : schema.items.properties;
-    // eslint-disable-next-line no-restricted-syntax
-    for (const key in props) {
-      const {
-        type,
-        items
-      } = props[key];
-      if (type === 'object') {
-        json[key] = schemaToJson(props[key], {});
-      } else if (type === 'array') {
-        if (items.properties) {
-          json[key] = [schemaToJson(props[key], {})];
-        } else {
-          json[key] = [items.type];
-        }
-      } else {
-        json[key] = type;
-      }
-    }
-  } else {
-    return schema.type;
-  }
-  return json;
-}

package/skills/cnb-api/scripts/core/tools.help.js

@@ -1,127 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.showToolHelp = showToolHelp;
-var _modules = require("./modules.help");
-/**
- * 显示工具帮助文档
- * - path 和 query 参数混合展示为统一的 --key value 格式（LLM 不需要区分来源）
- * - body 参数展示顶层字段列表，从 schema.required 数组读取必填标记
- * - 权限直接读 help.json 中预提取的 permission 字段
- * @param helpData 帮助数据
- * @param moduleName 模块名称
- * @param tool 工具名称
- */
-function showToolHelp(helpData, moduleName, tool) {
-  const toolHelpData = helpData.modulesHelp[moduleName][tool];
-  if (!toolHelpData) {
-    console.error(`工具 ${tool} 不存在`);
-    process.exit(1);
-  }
-  const cliCmd = "cnb" || 'cnb';
-  const {
-    summary,
-    permission,
-    help
-  } = toolHelpData;
-  const {
-    parameter
-  } = help;
-  const {
-    path,
-    query,
-    body
-  } = parameter;
-
-  // 收集所有扁平参数（path + query 混合展示）
-  const paramLines = [];
-  const exampleParts = [];
-
-  // path 参数
-  if (path) {
-    for (const [key, param] of Object.entries(path)) {
-      const req = param.required ? ',必填' : '';
-      paramLines.push(`  --${key.padEnd(14)} (${param.type}${req}) ${param.description || ''}`);
-      if (param.required) {
-        exampleParts.push(`--${key} <${param.type}>`);
-      }
-    }
-  }
-
-  // query 参数
-  if (query) {
-    for (const [key, param] of Object.entries(query)) {
-      const req = param.required ? ',必填' : '';
-      const enumStr = param.enum ? ` [${param.enum.join(',')}]` : '';
-      paramLines.push(`  --${key.padEnd(14)} (${param.type}${req}) ${param.description || ''}${enumStr}`);
-      if (param.required) {
-        exampleParts.push(`--${key} <${param.type}>`);
-      }
-    }
-  }
-
-  // body 参数
-  let bodyMsg = '';
-  let bodyExample = '';
-  if (body) {
-    const {
-      schema
-    } = body;
-    if (schema) {
-      const bodyLines = [];
-      const bodyExampleObj = {};
-      const props = schema.type === 'array' ? schema.items?.properties : schema.properties;
-
-      // Swagger 的 required 是父级数组，不在每个 property 上
-      const requiredFields = new Set(schema.required || schema.items?.required || []);
-      if (props) {
-        for (const [key, prop] of Object.entries(props)) {
-          const type = prop.type || 'object';
-          const isRequired = requiredFields.has(key);
-          const req = isRequired ? ',必填' : '';
-          // body 属性的 description 在生成时未 trim，运行时 trim
-          const desc = (0, _modules.trimSummary)(prop.description || '');
-          bodyLines.push(`  ${key.padEnd(16)} (${type}${req}) ${desc}`);
-          if (isRequired) {
-            bodyExampleObj[key] = `<${type}>`;
-          }
-        }
-      }
-      if (bodyLines.length > 0) {
-        bodyMsg = `\nBody (--data JSON):\n${bodyLines.join('\n')}`;
-      }
-      if (Object.keys(bodyExampleObj).length > 0) {
-        bodyExample = ` --data '${JSON.stringify(bodyExampleObj)}'`;
-      } else if (bodyLines.length > 0) {
-        // 没有 required 标记时，取前两个字段作为示例
-        const sampleKeys = Object.keys(props).slice(0, 2);
-        const sampleObj = {};
-        for (const k of sampleKeys) {
-          sampleObj[k] = `<${props[k].type || 'string'}>`;
-        }
-        if (sampleKeys.length > 0) {
-          bodyExample = ` --data '${JSON.stringify(sampleObj)}'`;
-        }
-      }
-    }
-  }
-
-  // 构建输出
-  let output = `${moduleName} ${tool} - ${summary}`;
-  if (permission) {
-    output += `\n权限: ${permission}`;
-  }
-  if (paramLines.length > 0) {
-    output += `\n\n参数:\n${paramLines.join('\n')}`;
-  }
-  if (bodyMsg) {
-    output += bodyMsg;
-  }
-
-  // 示例
-  const exampleCmd = `${cliCmd} ${moduleName} ${tool}${exampleParts.length > 0 ? ' ' + exampleParts.join(' ') : ''}${bodyExample}`;
-  output += `\n\n示例: ${exampleCmd}`;
-  console.log(output);
-}