@jspg-ai/coding-bb 0.0.1

package/cbb/lib/utils/version.js

@@ -0,0 +1,135 @@
+'use strict';
+
+/**
+ * 版本管理工具：被 check-update.js（hook）和 init.js（cbb setup 升级确认）共用。
+ * - 读取已安装版本（manifest 中的 version 字段）
+ * - 查询npm registry 最新版本
+ * - 比较版本号（含预发布后缀）
+ *
+ * 所有 IO 出错一律走 Promise reject / 返回 null，由调用方决定如何降级处理，
+ * 本模块绝不抛出阻塞上层的异常。
+ */
+
+const fs = require('fs');
+const path = require('path');
+const http = require('http');
+
+const PKG_NAME = '@jspg-ai/coding-bb';
+const REGISTRY = 'https://registry.npmjs.org';
+const MANIFEST_FILE = path.join('.cbb', '.managed-by-cbb');
+const REQUEST_TIMEOUT = 3000;
+
+/**
+ * 读取项目内已安装的版本号（从 .cbb/.managed-by-cbb 清单）。
+ * 不存在或解析失败返回 null。
+ */
+function readInstalledVersion(projectDir) {
+  const manifestPath = path.join(projectDir, MANIFEST_FILE);
+  if (!fs.existsSync(manifestPath)) return null;
+  try {
+    const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf-8'));
+    return manifest.version || null;
+  } catch (_) {
+    return null;
+  }
+}
+
+/**
+ * 从 registry 查询指定 tag（latest / beta）的最新版本号。
+ * 网络错误 / 非 200 / 缺 tag 均 reject，由调用方降级。
+ */
+function fetchLatest(tag) {
+  return new Promise((resolve, reject) => {
+    const url = `${REGISTRY}/${encodeURIComponent(PKG_NAME).replace('%2F', '/')}`;
+    const req = http.get(url, { timeout: REQUEST_TIMEOUT }, res => {
+      if (res.statusCode !== 200) { res.resume(); reject(new Error(`status ${res.statusCode}`)); return; }
+      let body = '';
+      res.setEncoding('utf-8');
+      res.on('data', chunk => { body += chunk; });
+      res.on('end', () => {
+        try {
+          const ver = JSON.parse(body)['dist-tags'][tag];
+          if (!ver) { reject(new Error(`no ${tag} tag`)); return; }
+          resolve(ver);
+        } catch (err) { reject(err); }
+      });
+    });
+    req.on('timeout', () => req.destroy(new Error('timeout')));
+    req.on('error', reject);
+  });
+}
+
+/**
+ * 语义化版本比较：a > b 返回 1，a < b 返回 -1，相等返回 0。
+ * 正确处理预发布后缀（如 1.0.4-beta.7 > 1.0.4-beta.6，正式版 > 任意预发布版）。
+ */
+function compareVersions(a, b) {
+  const parse = v => {
+    const [core, pre] = String(v).split('-');
+    return { nums: core.split('.').map(n => parseInt(n, 10) || 0), pre: pre ? pre.split('.') : null };
+  };
+  const pa = parse(a), pb = parse(b);
+  for (let i = 0; i < 3; i++) {
+    const d = (pa.nums[i] || 0) - (pb.nums[i] || 0);
+    if (d !== 0) return d > 0 ? 1 : -1;
+  }
+  if (!pa.pre && !pb.pre) return 0;
+  if (!pa.pre) return 1;
+  if (!pb.pre) return -1;
+  const len = Math.max(pa.pre.length, pb.pre.length);
+  for (let i = 0; i < len; i++) {
+    const x = pa.pre[i], y = pb.pre[i];
+    if (x === undefined) return -1;
+    if (y === undefined) return 1;
+    const nx = parseInt(x, 10), ny = parseInt(y, 10);
+    const bothNum = !isNaN(nx) && !isNaN(ny) && String(nx) === x && String(ny) === y;
+    if (bothNum) { if (nx !== ny) return nx > ny ? 1 : -1; }
+    else if (x !== y) return x > y ? 1 : -1;
+  }
+  return 0;
+}
+
+/** 判断是否为预发布版本（含 -beta / -rc 等后缀） */
+function detectIsPrerelease(version) {
+  return typeof version === 'string' && version.includes('-');
+}
+
+/**
+ * 反查指定版本所属的 dist-tag：从 registry 获取全量 tag 映射，
+ * 找到指向该版本的 tag 名称（如 zjc / beta / latest）。
+ *  - 不依赖版本号格式，兼容任意 prerelease 命名
+ *  - 网络失败 / 找不到 / 多个 tag 指向同一版本（选第一个）→ 返回 null，由调用方降级
+ */
+function findTagForVersion(version) {
+  return new Promise((resolve, reject) => {
+    const url = `${REGISTRY}/${encodeURIComponent(PKG_NAME).replace('%2F', '/')}`;
+    const req = http.get(url, { timeout: REQUEST_TIMEOUT }, res => {
+      if (res.statusCode !== 200) { res.resume(); reject(new Error(`status ${res.statusCode}`)); return; }
+      let body = '';
+      res.setEncoding('utf-8');
+      res.on('data', chunk => { body += chunk; });
+      res.on('end', () => {
+        try {
+          const distTags = JSON.parse(body)['dist-tags'] || {};
+          // 找到指向目标版本的 tag（取第一个，避免重复）
+          const found = Object.keys(distTags).find(k => distTags[k] === version);
+          resolve(found || null);
+        } catch (err) { reject(err); }
+      });
+    });
+    req.on('timeout', () => req.destroy(new Error('timeout')));
+    req.on('error', reject);
+  });
+}
+
+module.exports = {
+  PKG_NAME,
+  REGISTRY,
+  MANIFEST_FILE,
+  REQUEST_TIMEOUT,
+  readInstalledVersion,
+  fetchLatest,
+  compareVersions,
+  detectIsPrerelease,
+  findTagForVersion,
+};

package/cbb/lib/wiki/api-client.js

@@ -0,0 +1,358 @@
+#!/usr/bin/env node
+
+/**
+ * Confluence REST API 客户端：通过 HTTP Basic Auth 调用 Confluence REST API，
+ * 完成页面的增删改查。Wiki 地址从 config/cbb.yaml 读取（项目级配置），
+ * 认证凭据来自环境变量 CBB_WIKI_EMAIL/CBB_WIKI_TOKEN 或 ~/.cbb/wiki-config.json。
+ * 所有函数返回 { success, data?, error? }。
+ */
+
+
+
+
+const https = require('https');
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const yaml = require('js-yaml');
+const PROJECT_CONFIG_PATH = path.join(__dirname, '..', '..', '..', 'config', 'cbb.yaml');
+function loadBaseUrl() {
+  try {
+    const cfg = yaml.load(fs.readFileSync(PROJECT_CONFIG_PATH, 'utf-8'));
+    if (cfg && cfg.wiki && cfg.wiki.baseUrl) return cfg.wiki.baseUrl;
+  } catch (_) { /* 配置缺失或解析失败，用默认 */ }
+  return 'wiki.amh-group.com';
+}
+const BASE_URL = loadBaseUrl();
+const CONFIG_FILE = path.join(os.homedir(), '.cbb', 'wiki-config.json');
+const REQUEST_TIMEOUT = 30000;
+const MAX_ATTEMPTS = 3; 
+
+// ── 认证 ──────────────────────────────────────────────
+
+function getAuthHeader() {
+  const email = process.env.CBB_WIKI_EMAIL;
+  const token = process.env.CBB_WIKI_TOKEN;
+  if (email && token) {
+    return 'Basic ' + Buffer.from(email + ':' + token).toString('base64');
+  }
+  if (fs.existsSync(CONFIG_FILE)) {
+    try {
+      const config = JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf-8'));
+      if (config.email && config.token) {
+        return 'Basic ' + Buffer.from(config.email + ':' + config.token).toString('base64');
+      }
+    } catch (_) { /* ignore */ }
+  }
+  return null;
+}
+
+
+function hasAuth() {
+  return getAuthHeader() !== null;
+}
+
+// ── HTTP 请求（参考 check-update.js 模式） ────────────
+
+
+function request(method, apiPath, body, extraHeaders, rawBody) {
+  const auth = getAuthHeader();
+  if (!auth) {
+    return Promise.resolve({ success: false, error: '未配置 Wiki 认证。请设置环境变量 CBB_WIKI_EMAIL 和 CBB_WIKI_TOKEN，或创建 ~/.cbb/wiki-config.json 文件（格式：{"email":"...","token":"..."}）' });
+  }
+
+  const bodyStr = rawBody !== null && rawBody !== undefined ? rawBody : (body ? JSON.stringify(body) : null);
+
+  
+  
+  return new Promise((resolve) => {
+    let attempt = 0;
+    let lastResult = null;
+
+    const tryOnce = () => {
+      attempt++;
+      const headers = {
+        'Accept': 'application/json',
+        'Authorization': auth,
+        'X-Atlassian-Token': 'no-check',
+        ...extraHeaders,
+      };
+      if (bodyStr && !extraHeaders?.['Content-Type']) {
+        headers['Content-Type'] = 'application/json';
+      }
+      if (bodyStr) {
+        headers['Content-Length'] = Buffer.byteLength(bodyStr);
+      }
+
+      const options = {
+        hostname: BASE_URL,
+        port: 443,
+        path: apiPath,
+        method,
+        headers,
+        timeout: REQUEST_TIMEOUT,
+      };
+
+
+      const req = https.request(options, (res) => {
+        let data = '';
+        res.setEncoding('utf-8');
+        res.on('data', chunk => { data += chunk; });
+        res.on('end', () => {
+          try {
+            const parsed = data ? JSON.parse(data) : {};
+            if (res.statusCode >= 200 && res.statusCode < 300) {
+              resolve({ success: true, statusCode: res.statusCode, data: parsed });
+            } else {
+              resolve({ success: false, statusCode: res.statusCode, error: parsed.message || `HTTP ${res.statusCode}`, data: parsed });
+            }
+          } catch (e) {
+            resolve({ success: false, statusCode: res.statusCode, error: `响应解析失败: ${e.message}` });
+          }
+        });
+      });
+
+      req.on('timeout', () => {
+        req.destroy();
+        lastResult = { success: false, error: '请求超时' };
+        if (attempt < MAX_ATTEMPTS) retryAfter();
+        else resolve(lastResult);
+      });
+      req.on('error', (err) => {
+        lastResult = { success: false, error: err.message };
+        if (attempt < MAX_ATTEMPTS) retryAfter();
+        else resolve(lastResult);
+      });
+
+      if (bodyStr) req.write(bodyStr);
+      req.end();
+    };
+
+    const retryAfter = () => {
+      
+      const delay = 1000 * attempt;
+      setTimeout(tryOnce, delay);
+    };
+
+    tryOnce();
+  });
+}
+
+// ── 公开 API ──────────────────────────────────────────
+
+
+async function getPage(pageId, options = {}) {
+  const expand = options.includeBody ? 'version,space,body.storage' : 'version,space';
+  const result = await request('GET', `/rest/api/content/${pageId}?expand=${expand}`);
+  if (!result.success) return result;
+  return {
+    success: true,
+    data: {
+      id: result.data.id,
+      version: result.data.version?.number || 1,
+      title: result.data.title || '',
+      spaceKey: result.data.space?.key || '',
+      spaceName: result.data.space?.name || '',
+      bodyStorage: result.data.body?.storage?.value || '',
+    },
+  };
+}
+
+
+async function createPage(title, parentId, xhtmlContent) {
+  const parentResult = await request('GET', `/rest/api/content/${parentId}?expand=space`);
+  if (!parentResult.success) {
+    return { success: false, error: `无法获取父页面信息: ${parentResult.error}` };
+  }
+  const spaceKey = parentResult.data.space?.key;
+  if (!spaceKey) {
+    return { success: false, error: `父页面 ${parentId} 无 space 信息` };
+  }
+
+  
+  
+  const cql = `type=page AND ancestor=${parentId} AND title="${title.replace(/"/g, '\\"')}"`;
+  const dupResult = await request('GET', `/rest/api/content/search?cql=${encodeURIComponent(cql)}&limit=1`);
+  if (dupResult.success && Array.isArray(dupResult.data.results) && dupResult.data.results.length > 0) {
+    const existing = dupResult.data.results[0];
+    const existingId = existing.id;
+    
+    const pageInfo = await getPage(existingId);
+    if (!pageInfo.success) {
+      return { success: false, error: `同名页面已存在但获取版本失败: ${pageInfo.error}` };
+    }
+    const updateResult = await updatePage(existingId, pageInfo.data.version, pageInfo.data.title, xhtmlContent);
+    if (updateResult.success) {
+      return { ...updateResult, mode: 'updated' };
+    }
+    return updateResult;
+  }
+
+  const payload = {
+    type: 'page',
+    title,
+    space: { key: spaceKey },
+    ancestors: [{ id: parentId }],
+    body: {
+      storage: {
+        value: xhtmlContent,
+        representation: 'storage',
+      },
+    },
+  };
+
+  const result = await request('POST', '/rest/api/content', payload);
+  if (result.success) {
+    return { ...result, mode: 'created' };
+  }
+  return result;
+}
+
+
+async function updatePage(pageId, currentVersion, title, xhtmlContent, minorEdit = false) {
+  const payload = {
+    id: pageId,
+    type: 'page',
+    title,
+    version: {
+      number: currentVersion + 1,
+      minorEdit,
+    },
+    body: {
+      storage: {
+        value: xhtmlContent,
+        representation: 'storage',
+      },
+    },
+  };
+
+  return request('PUT', `/rest/api/content/${pageId}`, payload);
+}
+
+
+async function getChildren(pageId, opts = {}) {
+  const limit = opts.limit || 50;
+  const start = opts.start || 0;
+  return request('GET', `/rest/api/content/${pageId}/child/page?limit=${limit}&start=${start}`);
+}
+
+
+async function search(cql, opts = {}) {
+  const params = new URLSearchParams({ cql, limit: String(opts.limit || 20), start: String(opts.start || 0) });
+  if (opts.excerpt) params.set('excerptHighlight', 'true');
+  if (opts.order) params.set('order', opts.order);
+  return request('GET', `/rest/api/search?${params.toString()}`);
+}
+
+
+async function getSpaces(opts = {}) {
+  const params = new URLSearchParams({ limit: String(opts.limit || 100) });
+  if (opts.type) params.set('type', opts.type);
+  return request('GET', `/rest/api/space?${params.toString()}`);
+}
+
+
+async function getComments(pageId, opts = {}) {
+  const limit = opts.limit || 50;
+  return request('GET', `/rest/api/content/${pageId}/child/comment?limit=${limit}`);
+}
+
+
+async function getUser(opts = {}) {
+  if (opts.current) return request('GET', '/rest/api/user/current');
+  if (opts.accountId) return request('GET', `/rest/api/user?accountId=${encodeURIComponent(opts.accountId)}`);
+  if (opts.username) return request('GET', `/rest/api/user?username=${encodeURIComponent(opts.username)}`);
+  return { success: false, error: 'getUser 需要指定 --current、--account-id 或 --username' };
+}
+
+
+async function getVersions(pageId, opts = {}) {
+  const limit = opts.limit || 20;
+  return request('GET', `/rest/experimental/content/${pageId}/version?limit=${limit}`);
+}
+
+
+async function getAttachments(pageId, opts = {}) {
+  const limit = opts.limit || 50;
+  return request('GET', `/rest/api/content/${pageId}/child/attachment?limit=${limit}`);
+}
+
+
+async function createComment(pageId, xhtmlContent, parentCommentId) {
+  const payload = {
+    type: 'comment',
+    body: { storage: { value: xhtmlContent, representation: 'storage' } },
+    container: { type: 'page', id: String(pageId) },
+  };
+  if (parentCommentId) {
+    payload.container = { type: 'comment', id: String(parentCommentId) };
+  }
+  return request('POST', '/rest/api/content', payload);
+}
+
+
+async function uploadAttachment(pageId, filePath, comment) {
+  const auth = getAuthHeader();
+  if (!auth) {
+    return { success: false, error: '未配置 Wiki 认证' };
+  }
+  if (!fs.existsSync(filePath)) {
+    return { success: false, error: `文件不存在 ${filePath}` };
+  }
+
+  const boundary = '----wiki' + Math.random().toString(16).slice(2);
+  const fileName = path.basename(filePath);
+  const fileBuf = fs.readFileSync(filePath);
+  const parts = [];
+  parts.push(Buffer.from(`--${boundary}\r\nContent-Disposition: form-data; name="file"; filename="${fileName}"\r\nContent-Type: application/octet-stream\r\n\r\n`));
+  parts.push(fileBuf);
+  parts.push(Buffer.from('\r\n'));
+  if (comment) {
+    parts.push(Buffer.from(`--${boundary}\r\nContent-Disposition: form-data; name="comment"\r\n\r\n${comment}\r\n`));
+  }
+  parts.push(Buffer.from(`--${boundary}--\r\n`));
+  const rawBody = Buffer.concat(parts);
+
+  return request('POST', `/rest/api/content/${pageId}/child/attachment`, null, {
+    'Content-Type': `multipart/form-data; boundary=${boundary}`,
+  }, rawBody);
+}
+
+/**
+ * 删除附件
+ * @param {string} attachmentId
+ * @returns {Promise<{success: boolean, error?: string}>}
+ */
+async function deleteAttachment(attachmentId) {
+  return request('DELETE', `/rest/api/content/${attachmentId}`);
+}
+
+/**
+ * 根据页面数据构建 Wiki URL
+ * @param {{ id: string }} pageData
+ * @returns {string}
+ */
+function buildPageUrl(pageData) {
+  return `https://${BASE_URL}/pages/viewpage.action?pageId=${pageData.id}`;
+}
+
+
+
+async function appendToPage(pageId, newXhtml, options = {}) {
+  
+  const pageInfo = await getPage(pageId, { includeBody: true });
+  if (!pageInfo.success) return pageInfo;
+  const oldBody = pageInfo.data.bodyStorage || '';
+  const separator = options.separator || '\n\n';
+  const merged = oldBody + (oldBody && !oldBody.endsWith('\n') ? '\n' : '') + separator + newXhtml;
+
+  
+  return updatePage(pageId, pageInfo.data.version, pageInfo.data.title, merged, !!options.minorEdit);
+}
+
+module.exports = {
+  getPage, createPage, updatePage, appendToPage, buildPageUrl, hasAuth,
+  getChildren, search, getSpaces, getComments, getUser,
+  getVersions, getAttachments, createComment, uploadAttachment, deleteAttachment,
+};