bain-riper-cli 0.1.1

package/bin/cli.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+
+import { main } from '../src/index.js';
+
+// Handle Ctrl+C gracefully
+process.on('uncaughtException', (error) => {
+  if (error?.name === 'ExitPromptError') {
+    console.log('\n  已取消。\n');
+    process.exit(0);
+  }
+  throw error;
+});
+
+main(process.argv.slice(2));

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "bain-riper-cli",
+  "version": "0.1.1",
+  "description": "CLI tool to scaffold bain-riper AI engineering assets into your project",
+  "type": "module",
+  "bin": {
+    "bain-riper-cli": "./bin/cli.js"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "templates/"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "prepublishOnly": "node scripts/sync-templates.js",
+    "sync": "node scripts/sync-templates.js",
+    "test": "node --test test/"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^7.0.0"
+  },
+  "keywords": [
+    "cli",
+    "ai",
+    "engineering",
+    "scaffold",
+    "openspec",
+    "bain-riper"
+  ],
+  "license": "MIT"
+}

package/src/commands/add.js

@@ -0,0 +1,28 @@
+import { getModuleById, modules } from '../modules.js';
+import { copyModule, printSummary } from '../utils/copier.js';
+import { printChecklist } from '../utils/checklist.js';
+import { logger } from '../utils/logger.js';
+
+/**
+ * Add a specific module by ID.
+ */
+export async function addCommand(moduleId, flags = {}) {
+  const mod = getModuleById(moduleId);
+
+  if (!mod) {
+    logger.error(`未知模块：${moduleId}`);
+    console.log();
+    logger.plain('可用模块：');
+    for (const m of modules) {
+      logger.plain(`  ${m.id.padEnd(18)} ${m.description}`);
+    }
+    console.log();
+    process.exit(1);
+  }
+
+  logger.header(`正在安装：${mod.name}`);
+
+  const results = await copyModule(mod, { force: flags.force });
+  printSummary(results);
+  printChecklist([mod.id]);
+}

package/src/commands/init.js

@@ -0,0 +1,58 @@
+import { checkbox } from '@inquirer/prompts';
+import { modules } from '../modules.js';
+import { copyModule, printSummary } from '../utils/copier.js';
+import { printChecklist } from '../utils/checklist.js';
+import { logger } from '../utils/logger.js';
+
+/**
+ * Init command: interactive module selection or --all for full install.
+ */
+export async function initCommand(flags = {}) {
+  let selectedIds;
+
+  if (flags.all) {
+    // Non-interactive: select all modules
+    selectedIds = modules.map(m => m.id);
+  } else {
+    // Check if stdin is a TTY (interactive terminal)
+    if (!process.stdin.isTTY) {
+      logger.error('未检测到交互式终端，请使用 --all 参数全量安装。');
+      logger.plain('示例：npx bain-riper-cli init --all');
+      process.exit(1);
+    }
+
+    // Interactive: show checkbox selection
+    logger.header('bain-riper CLI - 项目初始化');
+
+    selectedIds = await checkbox({
+      message: '选择要安装的模块（空格切换，回车确认）',
+      choices: modules.map(mod => ({
+        name: `${mod.name.padEnd(18)} - ${mod.description}`,
+        value: mod.id,
+        checked: false,
+      })),
+    });
+
+    if (selectedIds.length === 0) {
+      logger.info('未选择任何模块，已退出。');
+      return;
+    }
+  }
+
+  // Install selected modules
+  const allResults = { created: [], skipped: [], overwritten: [], errors: [] };
+
+  for (const id of selectedIds) {
+    const mod = modules.find(m => m.id === id);
+    logger.header(`正在安装：${mod.name}`);
+    const results = await copyModule(mod, { force: flags.force });
+
+    allResults.created.push(...results.created);
+    allResults.skipped.push(...results.skipped);
+    allResults.overwritten.push(...results.overwritten);
+    allResults.errors.push(...results.errors);
+  }
+
+  printSummary(allResults);
+  printChecklist(selectedIds);
+}

package/src/commands/list.js

@@ -0,0 +1,44 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { modules, getTargetPath } from '../modules.js';
+import { logger } from '../utils/logger.js';
+
+/**
+ * List command: show installation status of all modules.
+ */
+export async function listCommand() {
+  const cwd = process.cwd();
+
+  logger.header('bain-riper 模块状态');
+
+  for (const mod of modules) {
+    let present = 0;
+    const missing = [];
+
+    for (const file of mod.files) {
+      const filePath = getTargetPath(mod, file, cwd);
+      try {
+        await fs.access(filePath);
+        present++;
+      } catch {
+        missing.push(file);
+      }
+    }
+
+    const total = mod.files.length;
+    const ratio = present / total;
+
+    if (ratio === 1) {
+      logger.success(`${mod.id.padEnd(18)} [已安装]   ${present}/${total} 个文件就位`);
+    } else if (ratio > 0) {
+      logger.plain(`  ◐ ${mod.id.padEnd(16)} [部分安装] ${present}/${total} 个文件就位`);
+      for (const f of missing) {
+        logger.plain(`      缺失：${path.join(mod.targetBase, f)}`);
+      }
+    } else {
+      logger.skip(`${mod.id.padEnd(18)} [未安装]`);
+    }
+  }
+
+  console.log();
+}

package/src/index.js

@@ -0,0 +1,86 @@
+import { readFile } from 'node:fs/promises';
+import { fileURLToPath } from 'node:url';
+import path from 'node:path';
+
+import { initCommand } from './commands/init.js';
+import { addCommand } from './commands/add.js';
+import { listCommand } from './commands/list.js';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+const HELP_TEXT = `
+  bain-riper-cli - 将 AI 工程化资产脚手架化到你的项目
+
+  用法：
+    bain-riper-cli init [--all] [--force]   交互式选择模块（--all 全量安装）
+    bain-riper-cli add <module> [--force]   安装指定模块
+    bain-riper-cli list                     查看模块安装状态
+
+  模块：
+    rules             7 个 AI 规则文件（宪法 / Preflight / Task Tiers 等）
+    skills            需求拆分 Skill（requirement-breakdown）
+    mcp               CodeGraph MCP 配置（mcp.json）
+    openspec          OpenSpec 工作流配置 + 项目 Profile
+    reference-code    Java CRUD 参考模板（EmployeeTraining 八层示例）
+
+  参数：
+    --all             非交互模式，安装全部模块
+    --force           覆盖已存在的文件
+
+  示例：
+    npx bain-riper-cli init                 # 交互式选择
+    npx bain-riper-cli init --all           # 全量安装
+    npx bain-riper-cli add rules            # 只安装规则
+    npx bain-riper-cli list                 # 查看安装状态
+`;
+
+export async function main(args) {
+  const command = args[0];
+  const flags = {
+    all: args.includes('--all'),
+    force: args.includes('--force'),
+  };
+
+  switch (command) {
+    case 'init':
+      await initCommand(flags);
+      break;
+
+    case 'add': {
+      const moduleId = args[1];
+      if (!moduleId || moduleId.startsWith('--')) {
+        console.error('\n  错误：缺少模块名称。');
+        console.error('  用法：bain-riper-cli add <module>');
+        console.error('  可用模块：rules, skills, mcp, openspec, reference-code\n');
+        process.exit(1);
+      }
+      await addCommand(moduleId, flags);
+      break;
+    }
+
+    case 'list':
+      await listCommand();
+      break;
+
+    case '--help':
+    case '-h':
+    case 'help':
+      console.log(HELP_TEXT);
+      break;
+
+    case '--version':
+    case '-v': {
+      const pkgPath = path.resolve(__dirname, '..', 'package.json');
+      const pkg = JSON.parse(await readFile(pkgPath, 'utf-8'));
+      console.log(`bain-riper-cli v${pkg.version}`);
+      break;
+    }
+
+    default:
+      if (command) {
+        console.error(`\n  未知命令：${command}\n`);
+      }
+      console.log(HELP_TEXT);
+      process.exit(command ? 1 : 0);
+  }
+}

package/src/modules.js

@@ -0,0 +1,136 @@
+import { fileURLToPath } from 'node:url';
+import path from 'node:path';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+export const TEMPLATES_DIR = path.resolve(__dirname, '..', 'templates');
+
+export const modules = [
+  {
+    id: 'rules',
+    name: 'Rules',
+    description: '7 个 AI 规则文件（宪法 / Preflight / Task Tiers 等）',
+    templateBase: 'qoder/rules',
+    targetBase: '.qoder/rules',
+    files: [
+      'project_constitution.md',
+      'openspec_preflight.md',
+      'openspec_task_tiers.md',
+      'openspec_specifications.md',
+      'openspec_codegraph.md',
+      'openspec_output_specs.md',
+      'openspec_reverse_sync.md',
+    ],
+    checklistItems: [],
+  },
+  {
+    id: 'skills',
+    name: 'Skills',
+    description: '需求拆分 Skill（requirement-breakdown）',
+    templateBase: 'qoder/skills',
+    targetBase: '.qoder/skills',
+    files: [
+      'requirement-breakdown/SKILL.md',
+    ],
+    checklistItems: [],
+  },
+  {
+    id: 'mcp',
+    name: 'MCP',
+    description: 'CodeGraph MCP 配置（mcp.json）',
+    templateBase: 'qoder',
+    targetBase: '.qoder',
+    files: [
+      'mcp.json',
+    ],
+    checklistItems: [
+      {
+        file: '.qoder/mcp.json',
+        field: 'args -p 参数',
+        action: '将 "/path/to/your-java-project" 替换为你的项目绝对路径',
+      },
+    ],
+  },
+  {
+    id: 'openspec',
+    name: 'OpenSpec',
+    description: 'OpenSpec 工作流配置 + 项目 Profile',
+    templateBase: 'openspec',
+    targetBase: 'openspec',
+    files: [
+      'config.yaml',
+      'project-profile.md',
+    ],
+    checklistItems: [
+      {
+        file: 'openspec/project-profile.md',
+        field: '§1 技术栈',
+        action: '替换为你的项目技术栈（语言版本、框架、ORM、构建工具等）',
+      },
+      {
+        file: 'openspec/project-profile.md',
+        field: '§2 项目骨架',
+        action: '替换 Maven groupId、基础包路径、Mapper XML 路径、构建命令等',
+      },
+      {
+        file: 'openspec/project-profile.md',
+        field: '§3 标准分层',
+        action: '根据你的项目结构调整分层目录',
+      },
+      {
+        file: 'openspec/project-profile.md',
+        field: '§4 领域约定',
+        action: '替换基类名称、注解名称、多租户字段名等',
+      },
+      {
+        file: 'openspec/project-profile.md',
+        field: '§5 参考模板',
+        action: '替换为你自己项目中的 CRUD 参考文件清单',
+      },
+      {
+        file: 'openspec/project-profile.md',
+        field: '§6 repowiki',
+        action: '根据实际 repowiki 目录树重写章节映射表',
+      },
+    ],
+    extraDirs: [
+      'openspec/changes',
+      'openspec/specs',
+    ],
+  },
+  {
+    id: 'reference-code',
+    name: 'Reference Code',
+    description: 'Java CRUD 参考模板（EmployeeTraining 八层示例）',
+    templateBase: 'docs/reference-code',
+    targetBase: 'docs/reference-code',
+    files: [
+      'controller/EmployeeTrainingController.java',
+      'service/IEmployeeTrainingService.java',
+      'service/impl/EmployeeTrainingServiceImpl.java',
+      'mapper/EmployeeTrainingMapper.java',
+      'resources/mapper/EmployeeTrainingMapper.xml',
+      'domain/EmployeeTraining.java',
+      'domain/bo/EmployeeTrainingBo.java',
+      'domain/vo/EmployeeTrainingVo.java',
+    ],
+    checklistItems: [
+      {
+        file: 'docs/reference-code/',
+        field: '整体',
+        action: '替换为你自己项目中的 CRUD 示例代码，保持八层结构',
+      },
+    ],
+  },
+];
+
+export function getModuleById(id) {
+  return modules.find(m => m.id === id);
+}
+
+export function getTemplatePath(mod, file) {
+  return path.join(TEMPLATES_DIR, mod.templateBase, file);
+}
+
+export function getTargetPath(mod, file, cwd = process.cwd()) {
+  return path.join(cwd, mod.targetBase, file);
+}

package/src/utils/checklist.js

@@ -0,0 +1,49 @@
+import { modules } from '../modules.js';
+import { logger } from './logger.js';
+
+/**
+ * Print post-install checklist for the given installed module IDs.
+ */
+export function printChecklist(installedIds) {
+  const items = [];
+
+  for (const id of installedIds) {
+    const mod = modules.find(m => m.id === id);
+    if (mod && mod.checklistItems.length > 0) {
+      items.push(...mod.checklistItems);
+    }
+  }
+
+  if (items.length === 0) {
+    return;
+  }
+
+  logger.header('安装后须知');
+  logger.plain('以下文件需要手动编辑后才能使用：\n');
+
+  // Group by file
+  const grouped = new Map();
+  for (const item of items) {
+    if (!grouped.has(item.file)) {
+      grouped.set(item.file, []);
+    }
+    grouped.get(item.file).push(item);
+  }
+
+  for (const [file, fileItems] of grouped) {
+    logger.plain(`[ ] ${file}`);
+    for (const item of fileItems) {
+      logger.plain(`    ${item.field} → ${item.action}`);
+    }
+    console.log();
+  }
+
+  // General suggestions
+  logger.plain('─'.repeat(60));
+  logger.plain('其他建议：');
+  logger.plain('[ ] 创建 .qoder/repowiki/ 项目知识库');
+  logger.plain('[ ] 安装 OpenSpec CLI：npm install -g @openspec/cli');
+  logger.plain('[ ] 安装 CodeGraph：  npm install -g codegraph');
+  logger.plain('[ ] 执行 openspec init 初始化工作流');
+  console.log();
+}

package/src/utils/copier.js

@@ -0,0 +1,100 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { getTemplatePath, getTargetPath } from '../modules.js';
+import { logger } from './logger.js';
+
+/**
+ * Check if a file exists.
+ */
+async function fileExists(filePath) {
+  try {
+    await fs.access(filePath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Copy all files for a given module from templates/ to the target project.
+ * @param {Object} mod - Module definition from modules.js
+ * @param {Object} options - { force: boolean, cwd: string }
+ * @returns {Promise<{ created: string[], skipped: string[], overwritten: string[], errors: {file: string, error: string}[] }>}
+ */
+export async function copyModule(mod, options = {}) {
+  const { force = false, cwd = process.cwd() } = options;
+  const results = { created: [], skipped: [], overwritten: [], errors: [] };
+
+  for (const file of mod.files) {
+    const srcPath = getTemplatePath(mod, file);
+    const destPath = getTargetPath(mod, file, cwd);
+    const relDest = path.join(mod.targetBase, file);
+
+    try {
+      const exists = await fileExists(destPath);
+
+      if (exists && !force) {
+        results.skipped.push(relDest);
+        logger.skip(`${relDest} （已存在）`);
+        continue;
+      }
+
+      // Create target directory
+      await fs.mkdir(path.dirname(destPath), { recursive: true });
+
+      // Copy file
+      await fs.copyFile(srcPath, destPath);
+
+      if (exists && force) {
+        results.overwritten.push(relDest);
+        logger.overwrite(relDest);
+      } else {
+        results.created.push(relDest);
+        logger.success(relDest);
+      }
+    } catch (err) {
+      results.errors.push({ file: relDest, error: err.message });
+      logger.error(`${relDest}: ${err.message}`);
+    }
+  }
+
+  // Create extra directories if defined (e.g., openspec/changes, openspec/specs)
+  if (mod.extraDirs) {
+    for (const dir of mod.extraDirs) {
+      const dirPath = path.join(cwd, dir);
+      await fs.mkdir(dirPath, { recursive: true });
+      const gitkeepPath = path.join(dirPath, '.gitkeep');
+      if (!(await fileExists(gitkeepPath))) {
+        await fs.writeFile(gitkeepPath, '');
+      }
+      logger.info(`已创建目录：${dir}/`);
+    }
+  }
+
+  return results;
+}
+
+/**
+ * Print a summary of copy results.
+ */
+export function printSummary(results) {
+  const total = results.created.length + results.skipped.length
+              + results.overwritten.length + results.errors.length;
+
+  logger.header('汇总');
+  if (results.created.length) {
+    logger.success(`已创建 ${results.created.length} 个文件`);
+  }
+  if (results.overwritten.length) {
+    logger.info(`已覆盖 ${results.overwritten.length} 个文件`);
+  }
+  if (results.skipped.length) {
+    logger.skip(`已跳过 ${results.skipped.length} 个文件（已存在，使用 --force 可覆盖）`);
+  }
+  if (results.errors.length) {
+    logger.error(`失败 ${results.errors.length} 个文件`);
+  }
+  if (total === 0) {
+    logger.info('未处理任何文件。');
+  }
+}

package/src/utils/logger.js

@@ -0,0 +1,18 @@
+const c = {
+  green:  (s) => `\x1b[32m${s}\x1b[0m`,
+  yellow: (s) => `\x1b[33m${s}\x1b[0m`,
+  red:    (s) => `\x1b[31m${s}\x1b[0m`,
+  cyan:   (s) => `\x1b[36m${s}\x1b[0m`,
+  dim:    (s) => `\x1b[2m${s}\x1b[0m`,
+  bold:   (s) => `\x1b[1m${s}\x1b[0m`,
+};
+
+export const logger = {
+  success(msg) { console.log(`  ${c.green('✓')} ${msg}`); },
+  skip(msg)    { console.log(`  ${c.yellow('⊘')} ${c.dim(msg)}`); },
+  error(msg)   { console.error(`  ${c.red('✗')} ${msg}`); },
+  info(msg)    { console.log(`  ${c.cyan('ℹ')} ${msg}`); },
+  header(msg)  { console.log(`\n${c.bold(msg)}\n`); },
+  overwrite(m) { console.log(`  ${c.yellow('↻')} ${m} ${c.dim('（已覆盖）')}`); },
+  plain(msg)   { console.log(`  ${msg}`); },
+};

package/templates/docs/reference-code/controller/EmployeeTrainingController.java

@@ -0,0 +1,107 @@
+package com.reference.controller;
+
+import cn.dev33.satoken.annotation.SaCheckPermission;
+import com.reference.domain.bo.EmployeeTrainingBo;
+import com.reference.domain.vo.EmployeeTrainingVo;
+import com.reference.service.IEmployeeTrainingService;
+import jakarta.servlet.http.HttpServletResponse;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import lombok.RequiredArgsConstructor;
+import org.dromara.common.core.domain.R;
+import org.dromara.common.core.validate.AddGroup;
+import org.dromara.common.core.validate.EditGroup;
+import org.dromara.common.excel.utils.ExcelUtil;
+import org.dromara.common.idempotent.annotation.RepeatSubmit;
+import org.dromara.common.log.annotation.Log;
+import org.dromara.common.log.enums.BusinessType;
+import org.dromara.common.mybatis.core.page.PageQuery;
+import org.dromara.common.mybatis.core.page.TableDataInfo;
+import org.dromara.common.web.core.BaseController;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.List;
+
+/**
+ * 员工培训档案
+ *
+ * @author LiuBin
+ * @date 2025-12-07
+ */
+@Validated
+@RequiredArgsConstructor
+@RestController
+@RequestMapping("/employee/training")
+public class EmployeeTrainingController extends BaseController {
+
+    private final IEmployeeTrainingService employeeTrainingService;
+
+    /**
+     * 查询员工培训档案列表
+     */
+    @SaCheckPermission("employee:training:list")
+    @GetMapping("/list")
+    public TableDataInfo<EmployeeTrainingVo> list(EmployeeTrainingBo bo, PageQuery pageQuery) {
+        return employeeTrainingService.queryPageList(bo, pageQuery);
+    }
+
+    /**
+     * 导出员工培训档案列表
+     */
+    @SaCheckPermission("employee:training:export")
+    @Log(title = "员工培训档案", businessType = BusinessType.EXPORT)
+    @PostMapping("/export")
+    public void export(EmployeeTrainingBo bo, HttpServletResponse response) {
+        List<EmployeeTrainingVo> list = employeeTrainingService.queryList(bo);
+        ExcelUtil.exportExcel(list, "员工培训档案", EmployeeTrainingVo.class, response);
+    }
+
+    /**
+     * 获取员工培训档案详细信息
+     *
+     * @param id 主键
+     */
+    @SaCheckPermission("employee:training:query")
+    @GetMapping("/{id}")
+    public R<EmployeeTrainingVo> getInfo(@NotNull(message = "主键不能为空")
+                                         @PathVariable Long id) {
+        return R.ok(employeeTrainingService.queryById(id));
+    }
+
+    /**
+     * 新增员工培训档案
+     */
+    @SaCheckPermission("employee:training:add")
+    @Log(title = "员工培训档案", businessType = BusinessType.INSERT)
+    @RepeatSubmit()
+    @PostMapping()
+    public R<Void> add(@Validated(AddGroup.class) @RequestBody EmployeeTrainingBo bo) {
+        return toAjax(employeeTrainingService.insertByBo(bo));
+    }
+
+    /**
+     * 修改员工培训档案
+     */
+    @SaCheckPermission("employee:training:edit")
+    @Log(title = "员工培训档案", businessType = BusinessType.UPDATE)
+    @RepeatSubmit()
+    @PutMapping()
+    public R<Void> edit(@Validated(EditGroup.class) @RequestBody EmployeeTrainingBo bo) {
+        return toAjax(employeeTrainingService.updateByBo(bo));
+    }
+
+    /**
+     * 删除员工培训档案
+     *
+     * @param ids 主键串
+     */
+    @SaCheckPermission("employee:training:remove")
+    @Log(title = "员工培训档案", businessType = BusinessType.DELETE)
+    @DeleteMapping("/{ids}")
+    public R<Void> remove(@NotEmpty(message = "主键不能为空")
+                          @PathVariable Long[] ids) {
+        return toAjax(employeeTrainingService.deleteWithValidByIds(List.of(ids), true));
+    }
+
+}