@jspg-ai/coding-bb 0.0.1

package/cbb/lib/superpowers/index.js

@@ -0,0 +1,265 @@
+#!/usr/bin/env node
+
+/**
+ * Superpowers Skills 管理模块
+ *
+ * 负责从 GitHub (obra/superpowers) 下载 skills 并部署到本项目。
+ * 提供 cbb update --upstream-superpowers 选项，以及 init 时的自动部署能力。
+ */
+
+const fs = require('fs');
+const path = require('path');
+const https = require('https');
+const os = require('os');
+const { execSync } = require('child_process');
+
+const SHARED_STANDARDS_DIR = path.join(__dirname, '..', '..', '..');
+
+// Superpowers 本地存储目录
+const SUPERPOWERS_DIR = path.join(SHARED_STANDARDS_DIR, 'superpowers');
+const SUPERPOWERS_SKILLS_DIR = path.join(SUPERPOWERS_DIR, 'skills');
+const VERSION_FILE = path.join(SUPERPOWERS_DIR, '.version');
+
+// GitHub 配置
+const GITHUB_REPO = 'obra/superpowers';
+const GITHUB_BRANCH = 'main';
+const GITHUB_TARBALL_URL = `https://api.github.com/repos/${GITHUB_REPO}/tarball/${GITHUB_BRANCH}`;
+const GITHUB_API_COMMIT_URL = `https://api.github.com/repos/${GITHUB_REPO}/commits/${GITHUB_BRANCH}`;
+
+// 预期的 skill 列表（14 个）
+const EXPECTED_SKILLS = [
+  'brainstorming',
+  'dispatching-parallel-agents',
+  'executing-plans',
+  'finishing-a-development-branch',
+  'receiving-code-review',
+  'requesting-code-review',
+  'subagent-driven-development',
+  'systematic-debugging',
+  'test-driven-development',
+  'using-git-worktrees',
+  'using-superpowers',
+  'verification-before-completion',
+  'writing-plans',
+  'writing-skills',
+];
+
+const { log } = require('../utils/output');
+
+// ── HTTP 工具 ──────────────────────────────────────────────────
+
+/**
+ * 发起 HTTPS GET 请求，跟随重定向（最多 5 次）。
+ * @param {string} url
+ * @param {object} [headers]
+ * @returns {Promise<{statusCode: number, headers: object, body: Buffer}>}
+ */
+function httpsGet(url, headers = {}, redirectCount = 0) {
+  if (redirectCount > 5) throw new Error('Too many redirects');
+
+  return new Promise((resolve, reject) => {
+    const defaultHeaders = { 'User-Agent': 'cbb-cli' };
+    https.get(url, { headers: { ...defaultHeaders, ...headers } }, (res) => {
+      // 跟随重定向
+      if ([301, 302, 307, 308].includes(res.statusCode) && res.headers.location) {
+        res.resume(); // 消费响应体
+        return httpsGet(res.headers.location, headers, redirectCount + 1)
+          .then(resolve, reject);
+      }
+
+      const chunks = [];
+      res.on('data', chunk => chunks.push(chunk));
+      res.on('end', () => {
+        resolve({
+          statusCode: res.statusCode,
+          headers: res.headers,
+          body: Buffer.concat(chunks),
+        });
+      });
+      res.on('error', reject);
+    }).on('error', reject);
+  });
+}
+
+/**
+ * 下载文件到指定路径。
+ */
+async function downloadToFile(url, destPath) {
+  const res = await httpsGet(url);
+  if (res.statusCode !== 200) {
+    throw new Error(`HTTP ${res.statusCode}: ${url}`);
+  }
+  fs.mkdirSync(path.dirname(destPath), { recursive: true });
+  fs.writeFileSync(destPath, res.body);
+  return res;
+}
+
+// ── 版本管理 ──────────────────────────────────────────────────
+
+/**
+ * 获取 GitHub 上 main 分支最新的 commit SHA。
+ * @returns {Promise<string>}
+ */
+async function fetchLatestCommitSha() {
+  const res = await httpsGet(GITHUB_API_COMMIT_URL, {
+    'Accept': 'application/vnd.github.v3+json',
+  });
+  if (res.statusCode !== 200) {
+    throw new Error(`无法获取最新 commit: HTTP ${res.statusCode}`);
+  }
+  const data = JSON.parse(res.body.toString('utf-8'));
+  return data.sha;
+}
+
+/**
+ * 读取本地 .version 文件中的 commit SHA。
+ * @returns {string|null}
+ */
+function getLocalVersion() {
+  if (!fs.existsSync(VERSION_FILE)) return null;
+  try {
+    const content = fs.readFileSync(VERSION_FILE, 'utf-8').trim();
+    // 格式：commit SHA（纯字符串）或 JSON { sha, updatedAt }
+    if (content.startsWith('{')) {
+      const data = JSON.parse(content);
+      return data.sha || null;
+    }
+    return content || null;
+  } catch (_) {
+    return null;
+  }
+}
+
+/**
+ * 写入版本信息到 .version 文件。
+ * @param {string} sha
+ */
+function writeVersion(sha) {
+  const data = {
+    sha,
+    branch: GITHUB_BRANCH,
+    repo: GITHUB_REPO,
+    updatedAt: new Date().toISOString(),
+  };
+  fs.writeFileSync(VERSION_FILE, JSON.stringify(data, null, 2) + '\n');
+}
+
+// ── 下载与解压 ──────────────────────────────────────────────────
+
+/**
+ * 从 GitHub 下载 tarball 并解压 skills 目录到 superpowers/skills/。
+ * @returns {Promise<{sha: string, skillCount: number}>}
+ */
+async function fetchLatestSkills() {
+  // 1. 获取最新 commit SHA
+  log('正在获取 superpowers 最新版本信息...', 'info');
+  const sha = await fetchLatestCommitSha();
+  const localSha = getLocalVersion();
+
+  if (sha === localSha) {
+    log(`已是最新版本 (${sha.slice(0, 8)})`, 'success');
+    return { sha, skillCount: getSkillCount(), skipped: true };
+  }
+
+  // 2. 下载 tarball
+  log(`正在下载 superpowers (${GITHUB_BRANCH}@${sha.slice(0, 8)})...`, 'info');
+  const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'cbb-sp-'));
+  const tarballPath = path.join(tmpDir, 'superpowers.tar.gz');
+
+  try {
+    await downloadToFile(GITHUB_TARBALL_URL, tarballPath);
+
+    // 3. 解压 tarball
+    log('正在解压...', 'info');
+    execSync(`tar -xzf "${tarballPath}" -C "${tmpDir}"`, { stdio: 'pipe' });
+
+    // 4. 找到解压后的目录（GitHub tarball 解压后目录名格式：obra-superpowers-<short-sha>）
+    const entries = fs.readdirSync(tmpDir).filter(f => {
+      const p = path.join(tmpDir, f);
+      return fs.statSync(p).isDirectory() && f.startsWith('obra-superpowers');
+    });
+    if (entries.length === 0) {
+      throw new Error('解压后未找到 superpowers 目录');
+    }
+    const extractedDir = path.join(tmpDir, entries[0]);
+    const extractedSkills = path.join(extractedDir, 'skills');
+
+    if (!fs.existsSync(extractedSkills)) {
+      throw new Error('解压后未找到 skills 目录');
+    }
+
+    // 5. 清空并复制 skills
+    if (fs.existsSync(SUPERPOWERS_SKILLS_DIR)) {
+      fs.rmSync(SUPERPOWERS_SKILLS_DIR, { recursive: true });
+    }
+    fs.mkdirSync(SUPERPOWERS_SKILLS_DIR, { recursive: true });
+    fs.cpSync(extractedSkills, SUPERPOWERS_SKILLS_DIR, { recursive: true });
+
+    // 6. 记录版本
+    writeVersion(sha);
+
+    const skillCount = getSkillCount();
+    log(`已更新 superpowers skills: ${localSha ? localSha.slice(0, 8) : '(无)'} → ${sha.slice(0, 8)} (${skillCount} 个 skills)`, 'success');
+
+    return { sha, skillCount, skipped: false };
+  } finally {
+    // 清理临时目录
+    try { fs.rmSync(tmpDir, { recursive: true, force: true }); } catch (_) { /* ignore */ }
+  }
+}
+
+// ── Skills 校验 ──────────────────────────────────────────────────
+
+/**
+ * 获取本地 skills 目录中的 skill 数量。
+ */
+function getSkillCount() {
+  if (!fs.existsSync(SUPERPOWERS_SKILLS_DIR)) return 0;
+  return fs.readdirSync(SUPERPOWERS_SKILLS_DIR)
+    .filter(f => {
+      const p = path.join(SUPERPOWERS_SKILLS_DIR, f);
+      return fs.statSync(p).isDirectory();
+    }).length;
+}
+
+/**
+ * 校验本地 skills 完整性：所有预期的 skill 目录存在且包含 SKILL.md。
+ * @returns {{valid: boolean, missing: string[], incomplete: string[]}}
+ */
+function validateSkills() {
+  const missing = [];
+  const incomplete = [];
+
+  for (const skill of EXPECTED_SKILLS) {
+    const skillDir = path.join(SUPERPOWERS_SKILLS_DIR, skill);
+    if (!fs.existsSync(skillDir)) {
+      missing.push(skill);
+    } else if (!fs.existsSync(path.join(skillDir, 'SKILL.md'))) {
+      incomplete.push(skill);
+    }
+  }
+
+  return {
+    valid: missing.length === 0 && incomplete.length === 0,
+    missing,
+    incomplete,
+  };
+}
+
+// ── 导出 ──────────────────────────────────────────────────────────
+
+module.exports = {
+  // 常量
+  SUPERPOWERS_DIR,
+  SUPERPOWERS_SKILLS_DIR,
+  VERSION_FILE,
+  EXPECTED_SKILLS,
+  GITHUB_REPO,
+  GITHUB_BRANCH,
+
+  // 核心函数
+  fetchLatestSkills,
+  getLocalVersion,
+  validateSkills,
+  getSkillCount,
+};

package/cbb/lib/utils/check-update.js

@@ -0,0 +1,147 @@
+#!/usr/bin/env node
+
+/**
+ * 版本检查脚本，由 hook 调用。
+ *
+ * 通过 UserPromptSubmit 事件触发：用户发消息时，若有新版本则以 additionalContext 注入对话，
+ * 由 AI 助手主动告知。会话级去重，每会话只提示一次。
+ *
+ * 每天最多请求一次 registry；任何异常静默退出 0，绝不打断会话。
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+// 共享版本工具（readInstalledVersion / fetchLatest / compareVersions / 常量）
+const versionUtil = require('./version');
+
+const CACHE_FILE = path.join('.cbb', '.update-check-cache.json');
+const CACHE_TTL = 24 * 60 * 60 * 1000;
+
+function getProjectDir() {
+  return process.env.QODER_PROJECT_DIR || process.env.CLAUDE_PROJECT_DIR || process.cwd();
+}
+
+/** 通过环境变量检测当前调用方对应的适配器名称 */
+function detectAdapterName() {
+  if (process.env.QODER_PROJECT_DIR) return 'qoder';
+  if (process.env.CLAUDE_PROJECT_DIR) return 'claude-code';
+  return null;
+}
+
+/**
+ * 读取项目内已安装的版本号，优先按适配器取版本（adapterVersions 字段），
+ * 缺失时回退到清单的全局 version。cbb setup 的升级确认不走这个函数，
+ * 直接用 version.js 的 readInstalledVersion（只看全局 version）。
+ */
+function readInstalledVersion(projectDir, adapterName) {
+  const manifestPath = path.join(projectDir, versionUtil.MANIFEST_FILE);
+  if (!fs.existsSync(manifestPath)) return null;
+  try {
+    const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf-8'));
+    if (adapterName && manifest.adapterVersions && manifest.adapterVersions[adapterName]) {
+      return manifest.adapterVersions[adapterName] || null;
+    }
+    return manifest.version || null;
+  } catch (_) {
+    return null;
+  }
+}
+
+function readCache(projectDir) {
+  const cachePath = path.join(projectDir, CACHE_FILE);
+  if (!fs.existsSync(cachePath)) return null;
+  try {
+    return JSON.parse(fs.readFileSync(cachePath, 'utf-8'));
+  } catch (_) {
+    return null;
+  }
+}
+
+function writeCache(projectDir, data) {
+  const cachePath = path.join(projectDir, CACHE_FILE);
+  fs.mkdirSync(path.dirname(cachePath), { recursive: true });
+  fs.writeFileSync(cachePath, JSON.stringify(data) + '\n');
+}
+
+/** 读取 hook 传入的 stdin（session_id）；TTY 或异常返回空对象 */
+function readStdin() {
+  return new Promise(resolve => {
+    if (process.stdin.isTTY) { resolve({}); return; }
+    let data = '';
+    let done = false;
+    const finish = val => { if (!done) { done = true; resolve(val); } };
+    const timer = setTimeout(() => finish({}), 500);
+    process.stdin.setEncoding('utf-8');
+    process.stdin.on('data', chunk => { data += chunk; });
+    process.stdin.on('end', () => {
+      clearTimeout(timer);
+      try {
+        const json = JSON.parse(data);
+        finish({ sessionId: json.session_id || null });
+      } catch (_) { finish({}); }
+    });
+    process.stdin.on('error', () => { clearTimeout(timer); finish({}); });
+  });
+}
+
+function buildMessage(installed, latest, isPrerelease) {
+  const installTag = isPrerelease ? '@beta' : '@latest';
+  return `📢 coding-bb 有新版本：${installed} → ${latest}\n` +
+    `升级步骤：\n` +
+    `  1. npm install -g ${versionUtil.PKG_NAME}${installTag}\n` +
+    `  2. cd <项目目录> && cbb update`;
+}
+
+async function main() {
+  const { sessionId } = await readStdin();
+  const projectDir = getProjectDir();
+  const adapterName = detectAdapterName();
+
+  const installed = readInstalledVersion(projectDir, adapterName);
+  if (!installed) return; // 本项目未安装本规范（或当前适配器无版本记录）
+
+  const isPrerelease = versionUtil.detectIsPrerelease(installed);
+  const tag = isPrerelease ? 'beta' : 'latest';
+  const now = Date.now();
+  let cache = readCache(projectDir) || {};
+
+  // 决定最新版本：命中每日缓存且 tag 一致则复用，否则请求 registry
+  let latest = cache.latest;
+  const cacheFresh = cache.lastCheck && (now - cache.lastCheck) < CACHE_TTL && cache.latest && cache.tag === tag;
+  if (!cacheFresh) {
+    try {
+      latest = await versionUtil.fetchLatest(tag);
+    } catch (_) {
+      return; // 网络失败静默
+    }
+    cache = { ...cache, lastCheck: now, latest, tag };
+    writeCache(projectDir, cache);
+  }
+
+  if (!latest || versionUtil.compareVersions(latest, installed) <= 0) return; // 已是最新
+
+  const message = buildMessage(installed, latest, isPrerelease);
+
+  // Hook 调用（有 sessionId）：以 additionalContext 注入，由 AI 助手提醒用户
+  if (sessionId) {
+    // 按适配器分别去重，同一会话同一适配器只提示一次
+    const notifiedKey = adapterName || '_default';
+    if (!cache.notifiedSessions) cache.notifiedSessions = {};
+    if (cache.notifiedSessions[notifiedKey] === sessionId) return; // 本会话本适配器已提示过
+    process.stdout.write(Buffer.from(JSON.stringify({
+      hookSpecificOutput: {
+        hookEventName: 'UserPromptSubmit',
+        additionalContext: `[系统提示] 检测到 ${message}\n请用一句话友好地提醒用户当前安装的开发规范有新版本，并给出上面的升级命令。`,
+      },
+    }) + '\n', 'utf8'));
+    cache.notifiedSessions[notifiedKey] = sessionId;
+    writeCache(projectDir, cache);
+    return;
+  }
+
+  // 手动运行（无 sessionId）：stderr 黄色输出
+  process.stderr.write(Buffer.from(`\n\x1b[33m${message}\x1b[0m\n\n`, 'utf8'));
+}
+
+main().catch(() => {}).finally(() => process.exit(0));