cloudcc-cli 2.3.3 → 2.3.5

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,
+}

package/.cloudcc-cache.json

@@ -1,38 +0,0 @@
-{
-  "version_check": {
-    "timestamp": 1774496967311
-  },
-  "oFKfA8V9DXIcs1l2EIe6tGNOd": {
-    "username": "junsales@demo.com",
-    "baseUrl": "https://solution.lightning.cloudcc.cn/ccdomaingateway",
-    "setupSvc": "https://solution.lightning.cloudcc.cn/ccdomaingateway/setup",
-    "orgId": "orgb5bc93c891c40ceac",
-    "clientId": "halqHvw6tDXVCfWxeY9GOLxdp",
-    "version": "public",
-    "openSecretKey": "10634880-6b3c-4238-a4ef-83177b27ca33",
-    "safetyMark": "oFKfA8V9DXIcs1l2EIe6tGNOd",
-    "CloudCCDev": "",
-    "apiSvc": "https://solution.lightning.cloudcc.cn/ccdomaingateway/apisvc",
-    "accessToken": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJhdWQiOiJjbG91ZGNjIiwibG9naW5OYW1lIjoianVuc2FsZXNAZGVtby5jb20iLCJiaW5kaW5nIjoiYzkyMDY3OTgtYTk0ZC00YzllLThhMzMtODYyMDM5OTY5ODNhIiwiQ2xpZW50SWQiOiJoYWxxSHZ3NnREWFZDZld4ZVk5R09MeGRwIiwiZXhwIjoxNzc0NjY5NzEzLCJvcmdJZCI6Im9yZ2I1YmM5M2M4OTFjNDBjZWFjIn0.y3siaeaE2LjPNljocJgC7QuotdtPN2Ty1uZQbuxCm8s",
-    "secretKey": "5c91aef5bc2740c49ab97831385036",
-    "pluginToken": "unified202625474e701",
-    "timestamp": 1774496913700
-  },
-  "QVOllKTKhnm5oHp49tCsSHvHg": {
-    "username": "appstore@cloudcc.cn",
-    "baseUrl": "https://yundong.lightning.cloudcc.cn/ccdomaingateway",
-    "setupSvc": "https://yundong.lightning.cloudcc.cn/ccdomaingateway/setup",
-    "orgId": "org9697882320dc71f28",
-    "clientId": "bIA1IXRHl28hBkaQdiwQ63hZZ",
-    "version": "public",
-    "openSecretKey": "15bba2de-e6e7-42dc-9d7c-f9b157cd0ddb",
-    "CloudCCDev": "",
-    "safetyMark": "QVOllKTKhnm5oHp49tCsSHvHg",
-    "buildVersion": "v2",
-    "apiSvc": "https://yundong.lightning.cloudcc.cn/ccdomaingateway/apisvc",
-    "accessToken": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJhdWQiOiJjbG91ZGNjIiwibG9naW5OYW1lIjoiYXBwc3RvcmVAY2xvdWRjYy5jbiIsImJpbmRpbmciOiI2OGE3YTEyNi0yNTFkLTQxYjctOWY2MC00ZDRkYWEwZmIwMzEiLCJDbGllbnRJZCI6ImJJQTFJWFJIbDI4aEJrYVFkaXdRNjNoWloiLCJleHAiOjE3NzQ2NzQzNDksIm9yZ0lkIjoib3JnOTY5Nzg4MjMyMGRjNzFmMjgifQ.JtebE5jXCssV_N0JBrqDbgDK9qSSGmKMR4J5NZ4w2Oo",
-    "secretKey": "d99313b4298544bc8ca1ee7459227b",
-    "pluginToken": "unified20267d70bae69",
-    "timestamp": 1774501550129
-  }
-}

package/.cursor/skills/cloudcc-cli-usage/SKILL.md

@@ -1,68 +0,0 @@
----
-name: cloudcc-cli-usage
-description: CloudCC CRM 二次开发 CLI 文档检索技能。用于在设计方案和实际开发时，优先通过各模块的 `cc doc <module> introduction` 与 `cc doc <module> devguide` 获取文档。用户提到 CloudCC、cloudcc-cli、`cc doc`、模块文档、设计方案、开发文档、项目初始化、开发环境、对象、字段、菜单、应用、类、定时类、触发器、自定义组件、自定义页面、自定义设置、客户端脚本、静态资源 时应优先使用。
----
-
-# CloudCC CLI Usage
-
-## 使用场景
-
-### 1. 设计实现方案时
-
-- 当用户要做方案设计、实现设计、模块选型时，优先调用每个模块的
-  `introduction`文档。
-- 命令格式：`cc doc <module> introduction`
-- 目标：先理解模块定位、适用场景、能力边界。
-- 然后编写详细的设计文档，包括对象，字段等。
-
-### 2. 开发实现时
-
-- 当用户进入实际开发阶段时，优先调用每个模块的 `devguide` 文档。
-- 命令格式：`cc doc <module> devguide`
-- 目标：先获取模块的开发说明、实现方式和注意事项。
-
-## 开发流程
-
-1. 先调用
-   `cc doc project devguide`，完成开发环境搭建、模板项目创建、密钥配置等准备工作。
-2. 再根据开发需要，调用对应模块的 `devguide` 文档。
-
-## 模块命令（按仓库现状）
-
-### 基础与环境
-
-- 项目与环境：`cc doc project introduction`、`cc doc project devguide`
-- CLI 配置：`cc doc config devguide`
-
-### 元数据与模型设计
-
-- 对象：`cc doc object introduction`、`cc doc object devguide`
-- 字段：`cc doc fields introduction`、`cc doc fields devguide`
-- 记录类型：`cc doc recordType introduction`、`cc doc recordType devguide`
-- 全局选项列表：`cc doc globalSelectList introduction`、`cc doc globalSelectList devguide`
-
-### 权限与组织管理
-
-- 用户：`cc doc user introduction`、`cc doc user devguide`
-- 角色：`cc doc role introduction`、`cc doc role devguide`
-- 简档：`cc doc profile introduction`、`cc doc profile devguide`
-
-### 业务扩展（后端）
-
-- 后端类：`cc doc classes introduction`、`cc doc classes devguide`
-- 触发器：`cc doc triggers introduction`、`cc doc triggers devguide`
-- 定时类：`cc doc timer introduction`、`cc doc timer devguide`
-- 定时作业：`cc doc scheduleJob introduction`、`cc doc scheduleJob devguide`
-
-### 业务扩展（前端）
-
-- 自定义组件：`cc doc plugin introduction`、`cc doc plugin devguide`
-- 自定义页面：`cc doc customPage introduction`、`cc doc customPage devguide`
-- 客户端脚本：`cc doc script introduction`、`cc doc script devguide`
-- 静态资源：`cc doc staticResource introduction`、`cc doc staticResource devguide`
-
-### 平台配置与导航
-
-- 菜单：`cc doc menu introduction`、`cc doc menu devguide`
-- 应用：`cc doc application introduction`、`cc doc application devguide`
-- 自定义设置：`cc doc customSetting introduction`、`cc doc customSetting devguide`