cloudcc-cli 2.3.4 → 2.3.6

package/test/fields.cli.test.js

@@ -12,7 +12,7 @@ function quoteArg(value) {
 }
 
 async function runCc(args) {
-  const cmd = `npx --prefix "${repoRoot}" cc ${args.map(quoteArg).join(" ")}`;
+  const cmd = `npx --prefix "${repoRoot}" cloudcc ${args.map(quoteArg).join(" ")}`;
   return execAsync(cmd, { cwd: repoRoot });
 }
 
@@ -44,7 +44,7 @@ test("字段管理流程：获取对象列表→create 字段→get 字段列表
 
   t.test("2) create 创建一个文本字段（S）", async () => {
     assert.ok(objId, "需要对象 id");
-    // create fields 调用约定：cc create fields <path> <fieldType> <objid> <nameLabel> [...]
+    // create fields 调用约定：cloudcc create fields <path> <fieldType> <objid> <nameLabel> [...]
     const { stdout, stderr } = await runCc(["create", "fields", repoRoot, "S", objId, fieldLabel]);
     // create fields 会通过 console.error 输出创建结果（见 src/fields/create.js）
     assert.match(

package/test/globalSelectList.cli.test.js

@@ -12,7 +12,7 @@ function quoteArg(value) {
 }
 
 async function runCc(args) {
-  const cmd = `npx --prefix "${repoRoot}" cc ${args.map(quoteArg).join(" ")}`;
+  const cmd = `npx --prefix "${repoRoot}" cloudcc ${args.map(quoteArg).join(" ")}`;
   return execAsync(cmd, { cwd: repoRoot });
 }
 

package/test/menu-script.cli.test.js

@@ -12,7 +12,7 @@ function quoteArg(value) {
 }
 
 async function runCc(args) {
-  const cmd = `npx --prefix "${repoRoot}" cc ${args.map(quoteArg).join(" ")}`;
+  const cmd = `npx --prefix "${repoRoot}" cloudcc ${args.map(quoteArg).join(" ")}`;
   return execAsync(cmd, { cwd: repoRoot });
 }
 

package/test/menu.cli.test.js

@@ -12,7 +12,7 @@ function quoteArg(value) {
 }
 
 async function runCc(args) {
-  const cmd = `npx --prefix "${repoRoot}" cc ${args.map(quoteArg).join(" ")}`;
+  const cmd = `npx --prefix "${repoRoot}" cloudcc ${args.map(quoteArg).join(" ")}`;
   return execAsync(cmd, { cwd: repoRoot });
 }
 

package/test/object.cli.test.js

@@ -12,7 +12,7 @@ function quoteArg(value) {
 }
 
 async function runCc(args) {
-  const cmd = `npx --prefix "${repoRoot}" cc ${args.map(quoteArg).join(" ")}`;
+  const cmd = `npx --prefix "${repoRoot}" cloudcc ${args.map(quoteArg).join(" ")}`;
   return execAsync(cmd, { cwd: repoRoot });
 }
 

package/test/plugin.cli.test.js

@@ -14,7 +14,7 @@ function quoteArg(value) {
 }
 
 async function runCc(args) {
-  const cmd = `npx --prefix "${repoRoot}" cc ${args.map(quoteArg).join(" ")}`;
+  const cmd = `npx --prefix "${repoRoot}" cloudcc ${args.map(quoteArg).join(" ")}`;
   return execAsync(cmd, { cwd: repoRoot });
 }
 

package/test/scheduleJob.cli.test.js

@@ -12,7 +12,7 @@ function quoteArg(value) {
 }
 
 async function runCc(args) {
-  const cmd = `npx --prefix "${repoRoot}" cc ${args.map(quoteArg).join(" ")}`;
+  const cmd = `npx --prefix "${repoRoot}" cloudcc ${args.map(quoteArg).join(" ")}`;
   return execAsync(cmd, { cwd: repoRoot });
 }
 

package/test/script.cli.test.js

@@ -14,7 +14,7 @@ function quoteArg(value) {
 }
 
 async function runCc(args) {
-  const cmd = `npx --prefix "${repoRoot}" cc ${args.map(quoteArg).join(" ")}`;
+  const cmd = `npx --prefix "${repoRoot}" cloudcc ${args.map(quoteArg).join(" ")}`;
   return execAsync(cmd, { cwd: repoRoot });
 }
 

package/test/staticResource.cli.test.js

@@ -12,7 +12,7 @@ function quoteArg(value) {
 }
 
 async function runCc(args) {
-  const cmd = `npx --prefix "${repoRoot}" cc ${args.map(quoteArg).join(" ")}`;
+  const cmd = `npx --prefix "${repoRoot}" cloudcc ${args.map(quoteArg).join(" ")}`;
   return execAsync(cmd, { cwd: repoRoot });
 }
 

package/test/timer.cli.test.js

@@ -14,7 +14,7 @@ function quoteArg(value) {
 }
 
 async function runCc(args) {
-  const cmd = `npx --prefix "${repoRoot}" cc ${args.map(quoteArg).join(" ")}`;
+  const cmd = `npx --prefix "${repoRoot}" cloudcc ${args.map(quoteArg).join(" ")}`;
   return execAsync(cmd, { cwd: repoRoot });
 }
 

package/test/trigger.cli.test.js

@@ -14,7 +14,7 @@ function quoteArg(value) {
 }
 
 async function runCc(args) {
-  const cmd = `npx --prefix "${repoRoot}" cc ${args.map(quoteArg).join(" ")}`;
+  const cmd = `npx --prefix "${repoRoot}" cloudcc ${args.map(quoteArg).join(" ")}`;
   return execAsync(cmd, { cwd: repoRoot });
 }
 

package/utils/checkVersion.js

@@ -5,6 +5,12 @@ const chalk = require("chalk")
 const { readCache, writeCache } = require("./cache")
 const fs = require('fs');
 const path = require('path');
+const {
+    semverCompare,
+    getReleasesBetween,
+    defaultReadmePath,
+} = require("./readmeReleases");
+const { printReleaseNotesBlocks } = require("./formatReleaseNotes");
 
 function checkNpmVersion() {
     let currentVersion = Number(config.version.replace(/\./g, ""));
@@ -31,7 +37,9 @@ function checkNpmVersion() {
     console.error('  ' + chalk.yellow('★') + ' Published At    : ' + chalk.gray(formattedTime));
     console.error('  ' + chalk.magenta('★') + ' Developer Docs  : ' + chalk.cyan('https://help.cloudcc.cn/'));
     console.error('  ' + chalk.magenta('★') + ' Changelog       : ' + chalk.cyan('https://www.npmjs.com/package/cloudcc-cli'));
-    console.error('  ' + chalk.gray('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n'));
+    console.error('  ' + chalk.gray('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
+
+    printReadmeReleaseNotesIfUpgradeNeeded(config.version, onlineVersion);
 
     if (onlineVersionNum - currentVersion > 0) {
         return onlineVersion;
@@ -39,6 +47,23 @@ function checkNpmVersion() {
     return null;
 }
 
+/**
+ * Prints README `# ReleaseV*` sections only when the registry has a **newer** version than local:
+ * all release blocks from current (exclusive) through latest (inclusive). If already up to date,
+ * prints nothing (changelog link remains in the version panel above).
+ */
+function printReadmeReleaseNotesIfUpgradeNeeded(currentVersion, latestVersion) {
+    if (semverCompare(latestVersion, currentVersion) <= 0) {
+        return;
+    }
+    const readmePath = defaultReadmePath();
+    const blocks = getReleasesBetween(readmePath, currentVersion, latestVersion);
+    if (blocks.length === 0) {
+        return;
+    }
+    printReleaseNotesBlocks(blocks, console.error);
+}
+
 
 function askUpdate() {
     console.error();
@@ -154,4 +179,4 @@ function checkAndReplaceJar(projectPath = process.cwd()) {
     }
 }
 
-module.exports = { checkUpdate };
+module.exports = { checkUpdate, checkNpmVersion, update };

package/utils/commandStats.js

@@ -0,0 +1,94 @@
+const fs = require("fs")
+const path = require("path")
+const os = require("os")
+
+/**
+ * 默认开启：在 ~/.cloudcc-cli/command-stats.json 累计调用次数；
+ * 键为人类可读形式，如 `cloudcc doc classes`、`cloudcc get brief`。
+ * 设 `CLOUDCC_CLI_STATS=0` / `false` / `off` 可关闭。
+ */
+function isEnabled() {
+  const v = process.env.CLOUDCC_CLI_STATS
+  if (v == null || String(v).trim() === "") return true
+  const s = String(v).trim().toLowerCase()
+  if (s === "0" || s === "false" || s === "no" || s === "off") return false
+  return true
+}
+
+function statsFilePath() {
+  return path.join(os.homedir(), ".cloudcc-cli", "command-stats.json")
+}
+
+/**
+ * @param {string} action 第一参数（或全局标志如 -v、--help）
+ * @param {string} resource 第二参数；无第二段时用 "_"；子帮助用 "_help"；action 级 -h 用 "-h"
+ */
+function formatRecordKey(action, resource) {
+  const res = resource == null || resource === "" ? "_" : String(resource)
+  if (res === "_") {
+    if (
+      action === "-v" ||
+      action === "--v" ||
+      action === "-version" ||
+      action === "--version"
+    ) {
+      return "cloudcc --version"
+    }
+    if (action === "-h" || action === "--h" || action === "--help") {
+      return "cloudcc --help"
+    }
+    return `cloudcc ${action}`
+  }
+  if (res === "_help") {
+    return `cloudcc ${action} --help`
+  }
+  if (res === "-h" || res === "--help") {
+    return `cloudcc ${action} -h`
+  }
+  return `cloudcc ${action} ${res}`
+}
+
+/**
+ * @param {string} action 第一参数，如 get、doc、create
+ * @param {string} resource 第二参数；无第二段时用 "_"（全局子命令）
+ */
+function record(action, resource) {
+  if (!isEnabled()) return
+  if (!action || typeof action !== "string") return
+  const res = resource == null || resource === "" ? "_" : String(resource)
+  const key = formatRecordKey(action, res)
+  try {
+    const file = statsFilePath()
+    const dir = path.dirname(file)
+    if (!fs.existsSync(dir)) {
+      fs.mkdirSync(dir, { recursive: true })
+    }
+    let data = { version: 1, counts: {}, updatedAt: null }
+    if (fs.existsSync(file)) {
+      data = JSON.parse(fs.readFileSync(file, "utf8"))
+      if (!data.counts || typeof data.counts !== "object") data.counts = {}
+    }
+    data.counts[key] = (data.counts[key] || 0) + 1
+    data.updatedAt = new Date().toISOString()
+    fs.writeFileSync(file, JSON.stringify(data, null, 2), "utf8")
+  } catch (_e) {
+    // 统计失败不影响 CLI
+  }
+}
+
+function readStats() {
+  try {
+    const file = statsFilePath()
+    if (fs.existsSync(file)) {
+      return JSON.parse(fs.readFileSync(file, "utf8"))
+    }
+  } catch (_e) {}
+  return { version: 1, counts: {}, updatedAt: null }
+}
+
+module.exports = {
+  isEnabled,
+  record,
+  readStats,
+  statsFilePath,
+}

package/utils/formatReleaseNotes.js

@@ -0,0 +1,312 @@
+const chalk = require("chalk")
+
+const BAR = "─"
+const W = 40
+const RIGHT_MARGIN = 2
+
+function getColumns() {
+  const c = process.stdout.columns
+  return typeof c === "number" && c > 20 ? c : 80
+}
+
+/**
+ * Split on spaces but keep `` `...` `` segments intact (never break inside backticks).
+ */
+function splitWordsRespectingBackticks(text) {
+  const out = []
+  let i = 0
+  while (i < text.length) {
+    while (i < text.length && text[i] === " ") i++
+    if (i >= text.length) break
+    if (text[i] === "`") {
+      const j = text.indexOf("`", i + 1)
+      if (j === -1) {
+        out.push(text.slice(i))
+        break
+      }
+      out.push(text.slice(i, j + 1))
+      i = j + 1
+    } else {
+      const j = text.indexOf(" ", i)
+      if (j === -1) {
+        out.push(text.slice(i))
+        break
+      }
+      out.push(text.slice(i, j))
+      i = j
+    }
+  }
+  return out
+}
+
+/**
+ * Plain-text word wrap. `firstMax` / `contMax` are max **characters** per line (content only).
+ */
+function wordWrapPlain(text, firstMax, contMax) {
+  const words = splitWordsRespectingBackticks(text)
+  const lines = []
+  let useMax = firstMax
+  let line = ""
+
+  function hardBreakWord(w) {
+    let rest = w
+    while (rest.length > useMax) {
+      lines.push(rest.slice(0, useMax))
+      rest = rest.slice(useMax)
+      useMax = contMax
+    }
+    line = rest
+  }
+
+  for (const w of words) {
+    if (w.length > useMax) {
+      if (line) {
+        lines.push(line)
+        line = ""
+      }
+      if (w.startsWith("`")) {
+        lines.push(w)
+        useMax = contMax
+        continue
+      }
+      hardBreakWord(w)
+      useMax = contMax
+      continue
+    }
+    const tryLine = line ? `${line} ${w}` : w
+    if (tryLine.length <= useMax) {
+      line = tryLine
+    } else {
+      if (line) lines.push(line)
+      line = w
+      useMax = contMax
+    }
+  }
+  if (line) lines.push(line)
+  return lines
+}
+
+/**
+ * Keep `(alias for` + `` `code` `` on the same wrapped line when possible (readability).
+ */
+function mergeAliasForWithNextLine(lines) {
+  const out = []
+  let i = 0
+  while (i < lines.length) {
+    let chunk = lines[i]
+    while (
+      i + 1 < lines.length &&
+      /\bfor\s*$/.test(chunk.trimEnd()) &&
+      lines[i + 1].trimStart().startsWith("`")
+    ) {
+      i += 1
+      chunk += " " + lines[i]
+    }
+    out.push(chunk)
+    i += 1
+  }
+  return out
+}
+
+/**
+ * If a wrap boundary split inside a `` `...` `` pair, merge lines until backticks balance.
+ */
+function mergeBrokenBacktickLines(lines) {
+  const out = []
+  let i = 0
+  while (i < lines.length) {
+    let chunk = lines[i]
+    let cnt = (chunk.match(/`/g) || []).length
+    while (cnt % 2 === 1 && i + 1 < lines.length) {
+      i += 1
+      chunk += " " + lines[i]
+      cnt = (chunk.match(/`/g) || []).length
+    }
+    out.push(chunk)
+    i += 1
+  }
+  return out
+}
+
+/**
+ * Backtick segments → cyan; rest uses `baseStyle` (default gray).
+ */
+function styleInlineCode(str, baseStyle) {
+  const base = baseStyle || ((s) => chalk.white(s))
+  const parts = str.split(/(`[^`]*`)/g)
+  return parts
+    .map((p) => {
+      if (p.startsWith("`") && p.endsWith("`") && p.length >= 2) {
+        return chalk.cyan.bold(p.slice(1, -1))
+      }
+      return base(p)
+    })
+    .join("")
+}
+
+/**
+ * Bullet + wrapped text; continuation lines align with text after "● ".
+ */
+function printWrappedBullet(pad, text, stream) {
+  const cols = getColumns()
+  const bulletStr = "● "
+  const contPad = pad + "  "
+  const firstMax = Math.max(24, cols - pad.length - bulletStr.length - RIGHT_MARGIN)
+  const contMax = Math.max(24, cols - contPad.length - RIGHT_MARGIN)
+
+  const plainLines = mergeBrokenBacktickLines(
+    mergeAliasForWithNextLine(wordWrapPlain(text, firstMax, contMax))
+  )
+  plainLines.forEach((plain, i) => {
+    const styled = styleInlineCode(plain, (s) => chalk.white(s))
+    if (i === 0) {
+      stream(pad + chalk.greenBright(bulletStr) + styled)
+    } else {
+      stream(contPad + styled)
+    }
+  })
+}
+
+/**
+ * @param {string} line raw line (may have leading indent for nested bullets)
+ * @param {string} baseIndent e.g. two spaces
+ */
+function formatReleaseLine(line, baseIndent) {
+  const trimmedEnd = line.replace(/\s+$/, "")
+  const t = trimmedEnd.trim()
+  if (t === "") {
+    return null
+  }
+
+  const rel = /^# ReleaseV(\d+\.\d+\.\d+)\s*$/.exec(t)
+  if (rel) {
+    return (
+      baseIndent +
+      chalk.bold.cyan("▸ ") +
+      chalk.bold.white("Release ") +
+      chalk.bold.greenBright("v" + rel[1])
+    )
+  }
+
+  const h4 = /^####\s+(.+)$/.exec(t)
+  if (h4) {
+    return (
+      baseIndent +
+      "  " +
+      chalk.bold.magenta("▼ ") +
+      chalk.bold.white(h4[1].trim())
+    )
+  }
+
+  return baseIndent + "  " + styleInlineCode(t, (s) => chalk.gray(s))
+}
+
+/**
+ * Wrap long `#### Key: value` lines (value part).
+ */
+function printWrappedMeta(baseIndent, key, val, stream) {
+  const cols = getColumns()
+  const pad = baseIndent + "  "
+  const labelChars = `${key}: `.length
+  const firstPrefix = pad + chalk.cyan(key) + chalk.dim(": ")
+  if (!val.length) {
+    stream(firstPrefix)
+    return
+  }
+  const firstMax = Math.max(24, cols - pad.length - labelChars - RIGHT_MARGIN)
+  const contPad = pad + " ".repeat(labelChars)
+  const contMax = Math.max(24, cols - contPad.length - RIGHT_MARGIN)
+
+  const lines = mergeBrokenBacktickLines(
+    wordWrapPlain(val, firstMax, contMax)
+  )
+  lines.forEach((plain, i) => {
+    const styled = chalk.greenBright(plain)
+    if (i === 0) {
+      stream(firstPrefix + styled)
+    } else {
+      stream(contPad + styled)
+    }
+  })
+}
+
+/**
+ * @param {string} body
+ * @param {function} stream default console.error
+ * @param {string} baseIndent
+ */
+function printReleaseNotesBody(body, stream = console.error, baseIndent = "  ") {
+  const lines = body.split("\n")
+  for (const line of lines) {
+    const trimmedEnd = line.replace(/\s+$/, "")
+    const t = trimmedEnd.trim()
+    if (t === "") {
+      stream("")
+      continue
+    }
+
+    const bullet = /^(\s*)-\s+(.*)$/.exec(line)
+    if (bullet) {
+      const ws = bullet[1].length
+      const pad = baseIndent + " ".repeat(2 + ws)
+      printWrappedBullet(pad, bullet[2], stream)
+      continue
+    }
+
+    const meta = /^####\s+([^:]+):\s*(.*)$/.exec(t)
+    if (meta) {
+      const key = meta[1].trim()
+      const val = meta[2].trim()
+      printWrappedMeta(baseIndent, key, val, stream)
+      continue
+    }
+
+    const out = formatReleaseLine(line, baseIndent)
+    if (out === null) stream("")
+    else stream(out)
+  }
+}
+
+/**
+ * @param {{ body: string }[]} blocks
+ * @param {function} stream
+ */
+function printReleaseNotesBlocks(blocks, stream = console.error) {
+  if (!blocks || blocks.length === 0) return
+
+  stream("")
+  stream(
+    "  " + chalk.bold.cyan("Release notes ") + chalk.gray.dim("(README.md)")
+  )
+  stream(
+    "  " +
+      chalk.cyan.dim("╭") +
+      chalk.gray(BAR.repeat(W)) +
+      chalk.cyan.dim("╮")
+  )
+
+  for (let i = 0; i < blocks.length; i++) {
+    if (i > 0) {
+      stream("")
+      stream("  " + chalk.dim("  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·"))
+    }
+    stream("")
+    printReleaseNotesBody(blocks[i].body, stream, "  ")
+  }
+
+  stream(
+    "  " +
+      chalk.cyan.dim("╰") +
+      chalk.gray(BAR.repeat(W)) +
+      chalk.cyan.dim("╯")
+  )
+  stream("")
+}
+
+module.exports = {
+  formatReleaseLine,
+  printReleaseNotesBody,
+  printReleaseNotesBlocks,
+  styleInlineCode,
+  wordWrapPlain,
+}

package/utils/readmeReleases.js

@@ -0,0 +1,69 @@
+const fs = require("fs")
+const path = require("path")
+
+function semverCompare(a, b) {
+  const pa = String(a)
+    .split(".")
+    .map((n) => parseInt(n, 10) || 0)
+  const pb = String(b)
+    .split(".")
+    .map((n) => parseInt(n, 10) || 0)
+  const len = Math.max(pa.length, pb.length)
+  for (let i = 0; i < len; i++) {
+    const da = pa[i] || 0
+    const db = pb[i] || 0
+    if (da !== db) return da > db ? 1 : -1
+  }
+  return 0
+}
+
+/**
+ * @param {string} readmePath
+ * @returns {{ version: string, body: string }[]}
+ */
+function parseReadmeReleases(readmePath) {
+  if (!fs.existsSync(readmePath)) return []
+  const content = fs.readFileSync(readmePath, "utf8")
+  const re = /^# ReleaseV(\d+\.\d+\.\d+)\s*$/gm
+  const matches = []
+  let m
+  while ((m = re.exec(content)) !== null) {
+    matches.push({ version: m[1], start: m.index })
+  }
+  matches.sort((a, b) => a.start - b.start)
+  const out = []
+  for (let i = 0; i < matches.length; i++) {
+    const end = i + 1 < matches.length ? matches[i + 1].start : content.length
+    const body = content.slice(matches[i].start, end).trim()
+    out.push({ version: matches[i].version, body })
+  }
+  return out
+}
+
+function getReleaseForExact(readmePath, version) {
+  return parseReadmeReleases(readmePath).find((r) => r.version === version) || null
+}
+
+/**
+ * Versions strictly after `current` and up to and including `latest` (per README sections).
+ */
+function getReleasesBetween(readmePath, current, latest) {
+  return parseReadmeReleases(readmePath)
+    .filter(
+      (r) =>
+        semverCompare(r.version, current) > 0 && semverCompare(r.version, latest) <= 0
+    )
+    .sort((a, b) => semverCompare(b.version, a.version))
+}
+
+function defaultReadmePath() {
+  return path.join(__dirname, "..", "README.md")
+}
+
+module.exports = {
+  semverCompare,
+  parseReadmeReleases,
+  getReleaseForExact,
+  getReleasesBetween,
+  defaultReadmePath,
+}