@jspg-ai/coding-bb 0.0.1

package/cbb/lib/install/qoder.js

@@ -0,0 +1,20 @@
+/**
+ * Qoder 适配器
+ *
+ * 将编码规范分发到 .qoder/rules/ 目录
+ */
+
+const path = require('path');
+const os = require('os');
+
+module.exports = {
+  name: 'qoder',
+  displayName: 'Qoder',
+  rulesDir: '.qoder/rules',
+  skillsDir: '.qoder/skills',
+  commandsDir: '.qoder/commands/opsx',
+  // 用户级 settings，写入全局生效，不污染项目目录
+  settingsFile: path.join(os.homedir(), '.qoder', 'settings.json'),
+  settingsFileIsUserLevel: true,
+  hookEvents: ['UserPromptSubmit'],
+};

package/cbb/lib/install/workspaces.js

@@ -0,0 +1,232 @@
+'use strict';
+
+/**
+ * 业务空间配置加载与匹配工具。
+ *
+ * 数据源：包内随发的 config/workspaces.json（含 _comment 字段会被忽略）。
+ * 提供：
+ *  - 加载 + 校验
+ *  - 归一化 remote URL（兼容 SSH / HTTPS 两种写法）
+ *  - 检测当前目录是否已拉取指定 workspace 的仓库
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+const DEFAULT_CONFIG = 'config/workspaces.json';
+const SAMPLE_CONFIG  = 'config/config.sample.json';
+
+/**
+ * 归一化 git remote URL：提取 "namespace/repo" 形式（去掉 .git 后缀）。
+ * 支持 SSH / HTTPS / HTTP / 已经是 path 的形式。
+ * 仅接受非空字符串，其它输入（null / undefined / 非字符串 / 空串）一律返回 ''，
+ * 由调用方决定如何处理。
+ */
+function normalizeRepoUrl(url) {
+  if (typeof url !== 'string') return '';
+  const u = url.trim();
+  if (!u) return '';
+  const stripped = u.replace(/\.git$/i, '');
+  // SSH: git@host:path/to/repo
+  const ssh = stripped.match(/^git@[^:\s]+:(.+)$/);
+  if (ssh) return ssh[1];
+  // HTTPS/HTTP: scheme://host/path/to/repo
+  const http = stripped.match(/^https?:\/\/[^/]+\/(.+)$/i);
+  if (http) return http[1];
+  // 已是 path 形式（兼容裸 "group/repo"）
+  return stripped.replace(/^\/+/, '');
+}
+
+/**
+ * 判断 git remote URL 是否匹配配置的 repo。
+ * 采用归一化后严格相等比较（同一仓库的 SSH/HTTPS 写法归一后相等）。
+ */
+function matchesConfiguredRepo(remoteUrl, configRepo) {
+  if (!remoteUrl || !configRepo) return false;
+  return normalizeRepoUrl(remoteUrl) === normalizeRepoUrl(configRepo);
+}
+
+/**
+ * 加载并校验业务空间配置。
+ * @param {string} [configPath] 相对于包根目录的配置文件路径，默认 config/workspaces.json
+ * @returns {{name: string, repo: string, businessLine: string}[]}
+ * @throws 配置缺失 / 格式错误时抛出，错误信息面向最终用户
+ */
+function loadWorkspaces(configPath = DEFAULT_CONFIG) {
+  const absPath = path.isAbsolute(configPath)
+    ? configPath
+    : path.resolve(__dirname, '..', '..', '..', configPath);
+
+  if (!fs.existsSync(absPath)) {
+    throw new Error(
+      `未找到业务空间配置文件：${configPath}\n` +
+      `请在项目维护方提供的本包内维护该文件后再试。`
+    );
+  }
+
+  let raw;
+  try {
+    raw = JSON.parse(fs.readFileSync(absPath, 'utf-8'));
+  } catch (e) {
+    throw new Error(`业务空间配置 ${configPath} 不是合法 JSON：${e.message}`);
+  }
+
+  if (!raw || typeof raw !== 'object' || !Array.isArray(raw.workspaces)) {
+    throw new Error(`业务空间配置 ${configPath} 缺少 workspaces 数组`);
+  }
+  if (raw.workspaces.length === 0) {
+    throw new Error(`业务空间配置 ${configPath} 的 workspaces 数组为空，请至少配置一项`);
+  }
+
+  return raw.workspaces.map((w, i) => {
+    const itemLabel = `第 ${i + 1} 项`;
+    if (!w || typeof w !== 'object') {
+      throw new Error(`业务空间配置 ${itemLabel} 不是对象`);
+    }
+    if (typeof w.name !== 'string' || !w.name.trim()) {
+      throw new Error(`业务空间配置 ${itemLabel} 缺少 name（业务空间名）`);
+    }
+    if (typeof w.repo !== 'string' || !w.repo.trim()) {
+      throw new Error(`业务空间 "${w.name}" 缺少 repo（GitLab 仓库地址）`);
+    }
+    if (typeof w.businessLine !== 'string' || !w.businessLine.trim()) {
+      throw new Error(`业务空间 "${w.name}" 缺少 businessLine（业务线，如：直采、增值、KA）`);
+    }
+    return {
+      name: w.name.trim(),
+      repo: w.repo.trim(),
+      businessLine: w.businessLine.trim(),
+    };
+  });
+}
+
+/**
+ * 校验业务工作空间 CONFIG.json 的格式是否合法。
+ *
+ * 校验项：
+ *  - 文件存在且为合法 JSON
+ *  - 含 apps 数组且非空
+ *  - 每个 app 对象必须含 name / repo / side 三个字段
+ *  - name、repo 为非空字符串；side 必须为 'front' 或 'back'
+ *
+ * @param {string} configPath CONFIG.json 的绝对路径
+ * @returns {{ valid: boolean, message?: string, config?: object }}
+ */
+function validateWorkspaceConfig(configPath) {
+  if (!fs.existsSync(configPath)) {
+    return { valid: false, message: `CONFIG.json 不存在：${configPath}` };
+  }
+
+  let raw;
+  try {
+    raw = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+  } catch (e) {
+    return { valid: false, message: `CONFIG.json 不是合法 JSON：${e.message}` };
+  }
+
+  if (!raw || typeof raw !== 'object') {
+    return { valid: false, message: 'CONFIG.json 内容应为 JSON 对象' };
+  }
+
+  if (!Array.isArray(raw.apps)) {
+    return { valid: false, message: 'CONFIG.json 缺少 apps 数组' };
+  }
+
+  if (raw.apps.length === 0) {
+    return { valid: false, message: 'CONFIG.json 中 apps 数组为空，请至少配置一个关联应用' };
+  }
+
+  const VALID_SIDES = ['front', 'back'];
+  for (let i = 0; i < raw.apps.length; i++) {
+    const app = raw.apps[i];
+    const label = `第 ${i + 1} 项`;
+
+    if (!app || typeof app !== 'object') {
+      return { valid: false, message: `CONFIG.json ${label}不是对象` };
+    }
+    if (typeof app.name !== 'string' || !app.name.trim()) {
+      return { valid: false, message: `CONFIG.json ${label}缺少 name（应用名）` };
+    }
+    if (typeof app.repo !== 'string' || !app.repo.trim()) {
+      return { valid: false, message: `CONFIG.json "${app.name}" 缺少 repo（Git 仓库地址）` };
+    }
+    if (typeof app.side !== 'string' || !app.side.trim()) {
+      return { valid: false, message: `CONFIG.json "${app.name}" 缺少 side（仓库类型，可选值：front / back）` };
+    }
+    if (!VALID_SIDES.includes(app.side.trim())) {
+      return { valid: false, message: `CONFIG.json "${app.name}" 的 side 字段值无效："${app.side}"（可选值：front / back）` };
+    }
+  }
+
+  return { valid: true, config: raw };
+}
+
+/**
+ * 在指定目录执行 `git remote -v`，解析出 [{ name, url }] 列表。
+ * 任何异常静默返回空数组，便于上层用 state 机判定。
+ */
+function readGitRemotes(cwd) {
+  try {
+    const out = execSync('git remote -v', {
+      cwd,
+      stdio: ['ignore', 'pipe', 'ignore'],
+      encoding: 'utf-8',
+      timeout: 10000,
+    });
+    const remotes = [];
+    out.split(/\r?\n/).forEach(line => {
+      // 仅保留 fetch 行，避免 push/fetch 各占一行导致重复
+      const m = line.match(/^(\S+)\s+(\S+)\s+\(fetch\)$/);
+      if (m) remotes.push({ name: m[1], url: m[2] });
+    });
+    return remotes;
+  } catch (_) {
+    return [];
+  }
+}
+
+/**
+ * 检测目标目录相对于 configRepo 的"是否已拉取"状态。
+ * @returns {{ state: 'not-git' | 'matched' | 'mismatched', remotes: {name:string,url:string}[] }}
+ *   - not-git：目录不是 git 仓库
+ *   - matched：是 git 仓库且任一 remote 匹配 configRepo
+ *   - mismatched：是 git 仓库但没有任何 remote 匹配 configRepo
+ */
+function detectRepo(cwd, configRepo) {
+  const gitDir = path.join(cwd, '.git');
+  if (!fs.existsSync(gitDir)) {
+    return { state: 'not-git', remotes: [] };
+  }
+  const remotes = readGitRemotes(cwd);
+  const matched = remotes.some(r => matchesConfiguredRepo(r.url, configRepo));
+  return matched
+    ? { state: 'matched', remotes }
+    : { state: 'mismatched', remotes };
+}
+
+/**
+ * 从 git remote URL 中提取仓库目录名（最后一段 path）。
+ *  - git@host:group/repo.git        → 'repo'
+ *  - https://host/group/repo.git    → 'repo'
+ *  - group/sub/repo                 → 'repo'
+ * 非法输入返回空串。
+ */
+function extractRepoBasename(url) {
+  const normalized = normalizeRepoUrl(url);
+  if (!normalized) return '';
+  const parts = normalized.split('/').filter(Boolean);
+  return parts.length > 0 ? parts[parts.length - 1] : '';
+}
+
+module.exports = {
+  DEFAULT_CONFIG,
+  SAMPLE_CONFIG,
+  normalizeRepoUrl,
+  matchesConfiguredRepo,
+  loadWorkspaces,
+  validateWorkspaceConfig,
+  readGitRemotes,
+  detectRepo,
+  extractRepoBasename,
+};