@jspg-ai/coding-bb 0.0.1

package/cbb/lib/wiki/cli.js

@@ -0,0 +1,427 @@
+#!/usr/bin/env node
+
+/**
+ * cbb wiki 子命令 — Wiki 查询与管理。
+ *
+ * 用法:
+ *   cbb wiki get <pageId> [--expand=...] [--full]
+ *   cbb wiki children <pageId> [--limit=50] [--start=0]
+ *   cbb wiki search "<cql>" [--limit=20] [--excerpt=highlight] [--order=lastmodified desc]
+ *   cbb wiki spaces [--limit=100] [--type=global]
+ *   cbb wiki comments <pageId> [--limit=50]
+ *   cbb wiki user [--current] [--account-id=<id>] [--username=<name>]
+ *   cbb wiki versions <pageId> [--limit=20]
+ *   cbb wiki attachments <pageId> list [--limit=50]
+ *   cbb wiki attachments <pageId> upload --file=<path> [--comment="..."]
+ *   cbb wiki attachments <pageId> delete --attachment-id=<id>
+ *   cbb wiki comment <pageId> --body-file=<path> [--parent=<parentCommentId>]
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { markdownToXhtml } = require('./convert');
+const api = require('./api-client');
+
+// ── 工具 ──────────────────────────────────────────────
+
+function out(msg) {
+  process.stdout.write(Buffer.from(msg + '\n', 'utf8'));
+}
+
+function err(msg) {
+  process.stderr.write(Buffer.from(msg + '\n', 'utf8'));
+}
+
+// 已知带值选项：允许 --flag value 与 --flag=value 两种写法。
+// 出现未在此列出的选项时，按布尔处理（保持旧版行为，便于未知选项平滑升级）。
+const VALUED_OPTIONS = new Set([
+  'parent-id', 'title', 'file', 'page-id', 'body-file',
+  'attachment-id', 'account-id', 'username', 'parent',
+  'comment', 'limit', 'start', 'excerpt', 'order',
+  'expand', 'type',
+]);
+// 已知布尔选项：显式声明为开关，避免与同名带值选项（如 --type、--expand）冲突时误吞参数
+const BOOLEAN_OPTIONS = new Set(['full', 'current', 'minor-edit']);
+
+function parseArgs(argv) {
+  const pos = [];
+  const opts = {};
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a.startsWith('--')) {
+      const eq = a.indexOf('=');
+      let key;
+      let value;
+      if (eq > 0) {
+        // --flag=value 形式
+        key = a.slice(2, eq);
+        value = a.slice(eq + 1);
+      } else {
+        key = a.slice(2);
+        if (VALUED_OPTIONS.has(key)) {
+          // --flag value 形式：消耗下一个参数作为值
+          value = argv[++i];
+          if (value === undefined) {
+            err(`选项 --${key} 需要一个值（用法: --${key} <value> 或 --${key}=<value>）`);
+            process.exit(1);
+          }
+        } else {
+          // 未知 / 已知布尔选项 → 视为 true
+          value = true;
+        }
+      }
+      opts[key] = value;
+    } else {
+      pos.push(a);
+    }
+  }
+  return { pos, opts };
+}
+
+function showHelp() {
+  out(`cbb wiki — Wiki 操作（查询 + 发布 + 管理）
+
+参数格式：
+  本工具同时支持两种写法，请按习惯任选其一：
+    --flag <value>     GNU 风格（推荐，shell 提示更友好）
+    --flag=<value>     等号风格
+
+子命令：
+  create --parent-id <id> --title "..." --file <md>     创建新页面
+  create --parent-id=<id> --title="..." --file=<md>     等价写法
+  update --page-id <id> --file <md>                     更新已有页面
+  update --page-id=<id> --file=<md>                     等价写法
+  get <pageId> [--expand=...] [--full]                  读页面（--full 输出正文）
+  children <pageId> [--limit=50] [--start=0]            列子页
+  search "<cql>" [--limit=20] [--excerpt=highlight]     CQL 搜索
+  spaces [--limit=100] [--type=global]                  列空间
+  comments <pageId> [--limit=50]                        列评论
+  user [--current] [--account-id=<id>] [--username=<name>]  查用户
+  versions <pageId> [--limit=20]                        列历史版本
+  attachments <pageId> list [--limit=50]                列附件
+  attachments <pageId> upload --file=<path>             上传附件
+  attachments <pageId> delete --attachment-id=<id>      删除附件
+  comment <pageId> --body-file=<path>                   创建评论
+
+示例：
+  cbb wiki create --parent-id 123456 --title "方案" --file design.md
+  cbb wiki get 123456 --full
+  cbb wiki search 'type=page AND title~"freight"'
+
+认证：环境变量 CBB_WIKI_EMAIL + CBB_WIKI_TOKEN，或 ~/.cbb/wiki-config.json
+      令牌获取: https://wiki.amh-group.com/plugins/tokens/view.action`);
+}
+
+// ── 子命令实现 ────────────────────────────────────────
+
+async function cmdGet({ pos, opts }) {
+  if (!pos[0]) { err('用法: cbb wiki get <pageId> [--expand=...] [--full]'); process.exit(1); }
+  const result = await api.getPage(pos[0], { includeBody: opts.full });
+  if (!result.success) { err(`获取失败: ${result.error}`); process.exit(1); }
+
+  const d = result.data;
+  out('# Wiki 页面信息');
+  out('');
+  out(`- **内容ID**: ${d.id}`);
+  out(`- **内容标题**: ${d.title}`);
+  out(`- **所属空间Key**: ${d.spaceKey}`);
+  out(`- **所属空间名称**: ${d.spaceName}`);
+  out(`- **版本**: ${d.version}`);
+  if (d.bodyStorage) {
+    if (opts.full) {
+      out('');
+      out('## 内容正文 (XHTML)');
+      out('```html');
+      out(d.bodyStorage);
+      out('```');
+    } else {
+      out(`- **正文字节数**: ${d.bodyStorage.length}（加 --full 查看全文）`);
+    }
+  }
+}
+
+async function cmdChildren({ pos, opts }) {
+  if (!pos[0]) { err('用法: cbb wiki children <pageId> [--limit=50] [--start=0]'); process.exit(1); }
+  const result = await api.getChildren(pos[0], { limit: Number(opts.limit) || 50, start: Number(opts.start) || 0 });
+  if (!result.success) { err(`获取失败: ${result.error}`); process.exit(1); }
+
+  const d = result.data;
+  const results = d.results || [];
+  out('# Wiki 子页面列表');
+  out(`- **父页面ID**: ${pos[0]}`);
+  out(`- **本页数量**: ${results.length}`);
+  out('');
+  if (results.length === 0) { out('（无子页面）'); return; }
+  results.forEach((p, i) => {
+    out(`### ${i + 1}. ${p.title}`);
+    out(`- **页面ID**: ${p.id}`);
+    out(`- **版本**: ${p.version && p.version.number}`);
+    if (p.version && p.version.when) out(`- **最后修改**: ${p.version.when}`);
+    out('');
+  });
+}
+
+async function cmdSearch({ pos, opts }) {
+  if (!pos[0]) { err('用法: cbb wiki search "<cql>" [--limit=20] [--excerpt=highlight] [--order=lastmodified desc]'); process.exit(1); }
+  const result = await api.search(pos[0], {
+    limit: Number(opts.limit) || 20,
+    excerpt: opts.excerpt,
+    order: opts.order,
+  });
+  if (!result.success) { err(`搜索失败: ${result.error}`); process.exit(1); }
+
+  const d = result.data;
+  const results = d.results || [];
+  out('# Wiki 搜索结果');
+  out(`- **CQL**: ${pos[0]}`);
+  out(`- **命中数量**: ${d.totalSize != null ? d.totalSize : results.length}`);
+  out('');
+  if (results.length === 0) { out('（无结果）'); return; }
+  results.forEach((r, i) => {
+    out(`### ${i + 1}. ${r.content && r.content.title || r.title || '(未知)'}`);
+    out(`- **页面ID**: ${r.content && r.content.id || r.entityId}`);
+    if (r.excerpt) out(`- **摘要**: ${r.excerpt}`);
+    out('');
+  });
+}
+
+async function cmdSpaces({ opts }) {
+  const result = await api.getSpaces({ limit: Number(opts.limit) || 100, type: opts.type });
+  if (!result.success) { err(`获取失败: ${result.error}`); process.exit(1); }
+
+  const d = result.data;
+  const results = d.results || [];
+  out('# Wiki 空间列表');
+  out(`- **本页数量**: ${results.length}`);
+  out('');
+  if (results.length === 0) { out('（无空间）'); return; }
+  results.forEach((s, i) => {
+    out(`### ${i + 1}. ${s.name}`);
+    out(`- **空间Key**: ${s.key}`);
+    out(`- **类型**: ${s.type}`);
+    out('');
+  });
+}
+
+async function cmdComments({ pos, opts }) {
+  if (!pos[0]) { err('用法: cbb wiki comments <pageId> [--limit=50]'); process.exit(1); }
+  const result = await api.getComments(pos[0], { limit: Number(opts.limit) || 50 });
+  if (!result.success) { err(`获取失败: ${result.error}`); process.exit(1); }
+
+  const d = result.data;
+  const results = d.results || [];
+  out('# Wiki 评论列表');
+  out(`- **页面ID**: ${pos[0]}`);
+  out(`- **评论数量**: ${results.length}`);
+  out('');
+  if (results.length === 0) { out('（无评论）'); return; }
+  results.forEach((c, i) => {
+    out(`### 评论 ${i + 1}`);
+    out(`- **评论ID**: ${c.id}`);
+    if (c.version && c.version.by && c.version.by.displayName) out(`- **作者**: ${c.version.by.displayName}`);
+    if (c.version && c.version.when) out(`- **时间**: ${c.version.when}`);
+    if (c.body && c.body.storage) {
+      const text = c.body.storage.value.replace(/<[^>]+>/g, '').slice(0, 200);
+      out(`- **内容**: ${text}${c.body.storage.value.length > 200 ? '...' : ''}`);
+    }
+    out('');
+  });
+}
+
+async function cmdUser({ opts }) {
+  const result = await api.getUser({
+    current: opts.current,
+    accountId: opts['account-id'],
+    username: opts.username,
+  });
+  if (!result.success) { err(`查询失败: ${result.error}`); process.exit(1); }
+
+  const d = result.data;
+  out('# Wiki 用户信息');
+  if (d.accountId) out(`- **accountId**: ${d.accountId}`);
+  if (d.username) out(`- **用户名**: ${d.username}`);
+  if (d.displayName) out(`- **显示名**: ${d.displayName}`);
+  if (d.email) out(`- **邮箱**: ${d.email}`);
+  if (d.accountType) out(`- **账户类型**: ${d.accountType}`);
+}
+
+async function cmdVersions({ pos, opts }) {
+  if (!pos[0]) { err('用法: cbb wiki versions <pageId> [--limit=20]'); process.exit(1); }
+  const result = await api.getVersions(pos[0], { limit: Number(opts.limit) || 20 });
+  if (!result.success) { err(`获取失败: ${result.error}`); process.exit(1); }
+
+  const d = result.data;
+  const results = d.results || [];
+  out('# Wiki 历史版本');
+  out(`- **页面ID**: ${pos[0]}`);
+  out(`- **版本数量**: ${results.length}`);
+  out('');
+  if (results.length === 0) { out('（无版本记录）'); return; }
+  results.forEach((v, i) => {
+    out(`### 版本 ${v.number}`);
+    if (v.by && v.by.displayName) out(`- **修改人**: ${v.by.displayName}`);
+    if (v.when) out(`- **时间**: ${v.when}`);
+    if (v.message) out(`- **说明**: ${v.message}`);
+    out('');
+  });
+}
+
+async function cmdAttachments({ pos, opts }) {
+  if (!pos[0] || !pos[1]) { err('用法: cbb wiki attachments <pageId> <list|upload|delete> [选项]'); process.exit(1); }
+  const pageId = pos[0];
+  const action = pos[1];
+
+  if (action === 'list') {
+    const result = await api.getAttachments(pageId, { limit: Number(opts.limit) || 50 });
+    if (!result.success) { err(`获取失败: ${result.error}`); process.exit(1); }
+    const d = result.data;
+    const results = d.results || [];
+    out('# Wiki 附件列表');
+    out(`- **页面ID**: ${pageId}`);
+    out(`- **附件数量**: ${results.length}`);
+    out('');
+    if (results.length === 0) { out('（无附件）'); return; }
+    results.forEach((a, i) => {
+      out(`### 附件 ${i + 1}`);
+      out(`- **附件ID**: ${a.id}`);
+      out(`- **文件名**: ${a.title}`);
+      if (a.metadata && a.metadata.mediaType) out(`- **类型**: ${a.metadata.mediaType}`);
+      if (a.extensions && a.extensions.fileSize) out(`- **大小**: ${a.extensions.fileSize} bytes`);
+      if (a.version && a.version.when) out(`- **上传时间**: ${a.version.when}`);
+      out('');
+    });
+    return;
+  }
+
+  if (action === 'upload') {
+    if (!opts.file) { err('upload 需要 --file=<path>'); process.exit(1); }
+    const result = await api.uploadAttachment(pageId, opts.file, opts.comment);
+    if (!result.success) { err(`上传失败: ${result.error}`); process.exit(1); }
+    const att = (result.data.results && result.data.results[0]) || result.data;
+    out('# 附件上传成功');
+    out(`- **附件ID**: ${att.id}`);
+    out(`- **文件名**: ${att.title}`);
+    out(`- **页面ID**: ${pageId}`);
+    return;
+  }
+
+  if (action === 'delete') {
+    if (!opts['attachment-id']) { err('delete 需要 --attachment-id=<id>'); process.exit(1); }
+    const result = await api.deleteAttachment(opts['attachment-id']);
+    if (!result.success) { err(`删除失败: ${result.error}`); process.exit(1); }
+    out('# 附件删除成功');
+    out(`- **附件ID**: ${opts['attachment-id']}`);
+    return;
+  }
+
+  err(`未知操作: ${action}（支持 list/upload/delete）`);
+  process.exit(1);
+}
+
+async function cmdComment({ pos, opts }) {
+  if (!pos[0] || !opts['body-file']) {
+    err('用法: cbb wiki comment <pageId> --body-file=<path> [--parent=<parentCommentId>]');
+    process.exit(1);
+  }
+  const body = fs.readFileSync(opts['body-file'], 'utf8');
+  const result = await api.createComment(pos[0], body, opts.parent);
+  if (!result.success) { err(`创建失败: ${result.error}`); process.exit(1); }
+  out('# 评论创建成功');
+  out(`- **评论ID**: ${result.data.id}`);
+  out(`- **页面ID**: ${pos[0]}`);
+  if (opts.parent) out(`- **回复目标**: ${opts.parent}`);
+}
+
+// ── 发布命令 ─────────────────────────────────────────
+
+function readAndConvert(filePath) {
+  const resolved = path.resolve(filePath);
+  if (!fs.existsSync(resolved)) { err(`文件不存在: ${resolved}`); process.exit(1); }
+  const markdown = fs.readFileSync(resolved, 'utf-8');
+  if (!markdown.trim()) { err(`文件为空: ${resolved}`); process.exit(1); }
+  err('转换 Markdown → Confluence Storage XHTML...');
+  const xhtml = markdownToXhtml(markdown);
+  err(`转换完成，${xhtml.length} 字符`);
+  return xhtml;
+}
+
+async function cmdCreate({ pos, opts }) {
+  if (!opts['parent-id'] || !opts.title || !opts.file) {
+    err('用法: cbb wiki create --parent-id <id> --title "..." --file <md>');
+    process.exit(1);
+  }
+  const xhtml = readAndConvert(opts.file);
+  err(`创建页面 "${opts.title}" 在父页面 ${opts['parent-id']} 下...`);
+  const result = await api.createPage(opts.title, opts['parent-id'], xhtml);
+  if (!result.success) {
+    err(`创建失败: ${result.error}`);
+    if (result.statusCode === 401 || result.statusCode === 403) {
+      err('认证失败。请检查 CBB_WIKI_EMAIL / CBB_WIKI_TOKEN 或 ~/.cbb/wiki-config.json。');
+    } else if (result.statusCode === 409) {
+      err('版本冲突，请重试。');
+    }
+    process.exit(1);
+  }
+  const url = api.buildPageUrl(result.data);
+  err(`创建成功！页面 ID: ${result.data.id}`);
+  err(`访问: ${url}`);
+}
+
+async function cmdUpdate({ pos, opts }) {
+  if (!opts['page-id'] || !opts.file) {
+    err('用法: cbb wiki update --page-id <id> --file <md>');
+    process.exit(1);
+  }
+  const xhtml = readAndConvert(opts.file);
+  err(`获取页面 ${opts['page-id']} 信息...`);
+  const pageInfo = await api.getPage(opts['page-id']);
+  if (!pageInfo.success) { err(`获取页面失败: ${pageInfo.error}`); process.exit(1); }
+  err(`更新页面: ${pageInfo.data.title} (v${pageInfo.data.version} → v${pageInfo.data.version + 1})`);
+  const result = await api.updatePage(opts['page-id'], pageInfo.data.version, pageInfo.data.title, xhtml);
+  if (!result.success) {
+    err(`更新失败: ${result.error}`);
+    if (result.statusCode === 401 || result.statusCode === 403) {
+      err('认证失败。请检查 CBB_WIKI_EMAIL / CBB_WIKI_TOKEN 或 ~/.cbb/wiki-config.json。');
+    } else if (result.statusCode === 409) {
+      err('版本冲突，页面可能已被他人修改，请重试。');
+    }
+    process.exit(1);
+  }
+  const url = api.buildPageUrl(result.data);
+  err(`更新成功！页面 ID: ${result.data.id}`);
+  err(`访问: ${url}`);
+}
+
+// ── 路由 ──────────────────────────────────────────────
+
+const commands = {
+  create: cmdCreate,
+  update: cmdUpdate,
+  get: cmdGet,
+  children: cmdChildren,
+  search: cmdSearch,
+  spaces: cmdSpaces,
+  comments: cmdComments,
+  user: cmdUser,
+  versions: cmdVersions,
+  attachments: cmdAttachments,
+  comment: cmdComment,
+};
+
+async function run(argv) {
+  const sub = argv[0];
+  if (!sub || sub === '-h' || sub === '--help') {
+    showHelp();
+    return;
+  }
+  const handler = commands[sub];
+  if (!handler) {
+    err(`未知子命令: ${sub}`);
+    showHelp();
+    process.exit(1);
+  }
+  const args = parseArgs(argv.slice(1));
+  await handler(args);
+}
+
+module.exports = { run, parseArgs, VALUED_OPTIONS };