@deepstorm/cli 0.9.2 → 0.10.0

package/dist/skills/reef-pr/scripts/create-pr.mjs

@@ -0,0 +1,217 @@
+#!/usr/bin/env node
+
+/**
+ * create-pr.mjs — PR 上下文收集与创建
+ *
+ * 用法:
+ *   node create-pr.mjs --collect          # 收集 PR 上下文
+ *   node create-pr.mjs --create <args>    # 创建 PR
+ *   node create-pr.mjs --help
+ */
+
+import { execSync } from 'node:child_process';
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+
+// ── Pure functions ────────────────────────────────────────────────
+
+export function checkUncommitted(statusShort) {
+  return statusShort.trim().length > 0;
+}
+
+export function buildPrBody(ctx) {
+  const lines = [];
+
+  lines.push('## 概要');
+  if (ctx.proposalTitle) {
+    lines.push(ctx.proposalTitle);
+  } else if (ctx.commitLog && ctx.commitLog.length > 0) {
+    lines.push(ctx.commitLog[0].message);
+  } else {
+    lines.push(ctx.branch);
+  }
+
+  lines.push('');
+  lines.push('## 关联');
+  lines.push(`Branch: ${ctx.branch}`);
+
+  if (ctx.diffStat) {
+    const s = ctx.diffStat;
+    lines.push(`Changes: ${s.files} 文件, +${s.insertions}/-${s.deletions}`);
+    lines.push('');
+    lines.push('## 变更清单');
+    s.changedFiles.forEach(f => lines.push(`- \`${f}\``));
+  }
+
+  if (ctx.commitLog && ctx.commitLog.length > 0) {
+    lines.push('');
+    lines.push('## Commits');
+    ctx.commitLog.forEach(c => lines.push(`- ${c.hash} ${c.message}`));
+  }
+
+  return lines.join('\n');
+}
+
+export function buildGhCreateArgs(opts) {
+  const args = ['gh pr create'];
+  args.push(`--title "${opts.title}"`);
+  args.push(`--body "${opts.body}"`);
+  if (opts.reviewer) args.push(`--reviewer ${opts.reviewer}`);
+  if (opts.label) args.push(`--label ${opts.label}`);
+  if (opts.draft) args.push('--draft');
+  return args.join(' ');
+}
+
+// ── Git helpers ────────────────────────────────────────────────────
+
+function exec(command) {
+  try {
+    return execSync(command, { encoding: 'utf8', timeout: 10000 }).trim();
+  } catch {
+    return '';
+  }
+}
+
+function collectContext() {
+  const branch = exec('git branch --show-current');
+  const forkPoint = exec(
+    'git merge-base main HEAD 2>/dev/null || echo ""'
+  );
+  const diffStat = exec(
+    `git diff "${forkPoint || 'main'}..HEAD" --stat`
+  );
+  const commitLog = forkPoint
+    ? exec(`git log "${forkPoint}"..HEAD --oneline`)
+    : '';
+  const statusShort = exec('git status --short');
+
+  // 查找关联 proposal
+  let proposalTitle = '';
+  const root = exec(
+    'git rev-parse --show-toplevel 2>/dev/null || echo ""'
+  );
+  if (root && branch) {
+    const p = join(root, 'openspec', 'changes', branch, 'proposal.md');
+    if (existsSync(p)) {
+      const firstLine = readFileSync(p, 'utf8')
+        .split('\n')[0] || '';
+      proposalTitle = firstLine.replace(/^#+\s*/, '').trim();
+    }
+  }
+
+  return {
+    branch,
+    hasUncommitted: checkUncommitted(statusShort),
+    proposalTitle,
+    commitLog: commitLog
+      ? commitLog.split('\n').filter(Boolean).map(l => {
+          const m = l.match(/^(\S+)\s+(.*)/);
+          return m ? { hash: m[1], message: m[2] } : null;
+        }).filter(Boolean)
+      : [],
+    diffStat: diffStat ? parseDiffStat(diffStat) : null,
+  };
+}
+
+function parseDiffStat(output) {
+  const lines = output.trim().split('\n').filter(Boolean);
+  const changedFiles = [];
+  let files = 0, insertions = 0, deletions = 0;
+
+  for (const line of lines) {
+    const sm = line.match(/(\d+)\s+files?\s+changed/);
+    if (sm) {
+      files = parseInt(sm[1], 10);
+      const im = line.match(/(\d+)\s+insertions?\(\+\)/);
+      if (im) insertions = parseInt(im[1], 10);
+      const dm = line.match(/(\d+)\s+deletions?\(-\)/);
+      if (dm) deletions = parseInt(dm[1], 10);
+      continue;
+    }
+    const fm = line.match(/^\s*(.+?)\s+\|/);
+    if (fm) changedFiles.push(fm[1].trim());
+  }
+
+  return { files, insertions, deletions, changedFiles };
+}
+
+function checkExistingPR() {
+  const out = exec('gh pr view --json url 2>/dev/null || true');
+  return out ? { exists: true, url: out } : { exists: false };
+}
+
+// ── CLI entry ─────────────────────────────────────────────────────
+
+if (import.meta.filename === process.argv[1]) {
+  if (process.argv.includes('--help') || process.argv.includes('-h')) {
+    console.log(`
+create-pr.mjs — PR 上下文收集与创建
+
+用法:
+  node create-pr.mjs --collect            收集 PR 上下文（JSON）
+  node create-pr.mjs --create             创建 PR
+  node create-pr.mjs --help               显示帮助
+
+--create 选项:
+  --title <text>     PR 标题
+  --body <text>      PR 正文
+  --reviewer <user>  Reviewer
+  --label <label>    标签
+  --draft            创建 Draft PR
+`);
+    process.exit(0);
+  }
+
+  if (process.argv.includes('--collect')) {
+    const ctx = collectContext();
+    process.stdout.write(JSON.stringify(ctx, null, 2) + '\n');
+    process.exit(0);
+  }
+
+  if (process.argv.includes('--create')) {
+    const titleArg = process.argv.indexOf('--title');
+    const bodyArg = process.argv.indexOf('--body');
+    const reviewerArg = process.argv.indexOf('--reviewer');
+    const labelArg = process.argv.indexOf('--label');
+    const isDraft = process.argv.includes('--draft');
+
+    if (titleArg < 0 || bodyArg < 0) {
+      console.error('--title 和 --body 必填');
+      process.exit(1);
+    }
+
+    const existing = checkExistingPR();
+    if (existing.exists) {
+      process.stdout.write(JSON.stringify(existing, null, 2) + '\n');
+      process.exit(0);
+    }
+
+    const branch = exec('git branch --show-current');
+    const pushOut = exec(`git push -u origin ${branch} 2>&1`);
+    if (!pushOut) {
+      console.error('git push 失败');
+      process.exit(1);
+    }
+
+    const cmd = buildGhCreateArgs({
+      title: process.argv[titleArg + 1],
+      body: process.argv[bodyArg + 1],
+      branch,
+      reviewer: reviewerArg >= 0
+        ? process.argv[reviewerArg + 1] : null,
+      label: labelArg >= 0 ? process.argv[labelArg + 1] : null,
+      draft: isDraft,
+    });
+
+    const out = exec(cmd);
+    process.stdout.write(JSON.stringify({
+      created: true,
+      url: out,
+    }, null, 2) + '\n');
+    process.exit(0);
+  }
+
+  // 默认：--collect
+  const ctx = collectContext();
+  process.stdout.write(JSON.stringify(ctx, null, 2) + '\n');
+}

package/dist/skills/reef-style-backend/fragments/nodejs/eslint-config.json

@@ -0,0 +1,30 @@
+{
+  "root": true,
+  "env": {
+    "node": true,
+    "jest": true
+  },
+  "parser": "@typescript-eslint/parser",
+  "parserOptions": {
+    "project": "tsconfig.json",
+    "sourceType": "module"
+  },
+  "plugins": ["@typescript-eslint/eslint-plugin"],
+  "extends": [
+    "plugin:@typescript-eslint/recommended",
+    "plugin:prettier/recommended"
+  ],
+  "rules": {
+    "@typescript-eslint/no-explicit-any": "error",
+    "@typescript-eslint/no-unused-vars": ["error", { "argsIgnorePattern": "^_" }],
+    "@typescript-eslint/explicit-function-return-type": "off",
+    "@typescript-eslint/explicit-module-boundary-types": "off",
+    "no-console": "warn",
+    "prefer-const": "error",
+    "no-var": "error",
+    "eqeqeq": ["error", "always"],
+    "curly": ["error", "all"],
+    "no-throw-literal": "error",
+    "prefer-promise-reject-errors": "error"
+  }
+}

package/dist/skills/reef-style-backend/fragments/nodejs/nestjs-structure.md

@@ -0,0 +1,58 @@
+# NestJS 项目结构规范
+
+## 顶层目录
+
+```
+src/
+├── main.ts               # 入口（Bootstrap）
+├── app.module.ts         # 根模块
+├── app.controller.ts     # 健康检查
+└── app.service.ts        # 全局服务
+```
+
+## 模块目录规范
+
+```
+src/modules/{module-name}/
+├── {module-name}.module.ts         # Module 定义
+├── {module-name}.controller.ts     # REST Controller
+├── {module-name}.service.ts        # 业务逻辑
+├── dto/
+│   ├── create-{entity}.dto.ts      # 创建 DTO
+│   └── update-{entity}.dto.ts      # 更新 DTO（PartialType）
+└── entities/
+    └── {entity}.entity.ts          # Prisma 封装类型（可选）
+```
+
+## 公共目录
+
+```
+src/
+├── prisma/
+│   ├── prisma.module.ts
+│   └── prisma.service.ts
+├── common/
+│   ├── filters/
+│   │   └── http-exception.filter.ts
+│   ├── pipes/
+│   │   └── validation.pipe.ts
+│   ├── interceptors/
+│   │   ├── transform.interceptor.ts
+│   │   └── logging.interceptor.ts
+│   └── guards/
+│       └── auth.guard.ts
+└── config/
+    └── configuration.ts
+```
+
+## 命名规范
+
+| 类型 | 命名规则 | 示例 |
+|------|---------|------|
+| Module 类 | PascalCase + Module | `UsersModule` |
+| Controller 类 | PascalCase + Controller | `UsersController` |
+| Service 类 | PascalCase + Service | `UsersService` |
+| DTO 类 | PascalCase + Dto | `CreateUserDto` |
+| Module 目录 | kebab-case | `src/modules/user-roles/` |
+| DTO 文件 | kebab-case | `create-user-role.dto.ts` |
+| 配置键 | UPPER_SNAKE_CASE | `DATABASE_URL` |

package/dist/skills/reef-style-backend/fragments/nodejs/prettier-config.json

@@ -0,0 +1,19 @@
+{
+  "semi": true,
+  "singleQuote": true,
+  "tabWidth": 2,
+  "trailingComma": "all",
+  "printWidth": 100,
+  "bracketSpacing": true,
+  "arrowParens": "always",
+  "endOfLine": "lf",
+  "quoteProps": "as-needed",
+  "overrides": [
+    {
+      "files": "*.prisma",
+      "options": {
+        "tabWidth": 2
+      }
+    }
+  ]
+}

package/dist/skills/reef-style-backend/variants/nodejs/examples/module-example.md

@@ -0,0 +1,166 @@
+# NestJS Module 示例 — Users 模块
+
+```typescript
+// users.module.ts
+import { Module } from '@nestjs/common';
+import { UsersController } from './users.controller';
+import { UsersService } from './users.service';
+import { PrismaModule } from '../prisma/prisma.module';
+
+/**
+ * 用户管理模块
+ * 提供用户 CRUD 操作和权限管理
+ */
+@Module({
+  imports: [PrismaModule],
+  controllers: [UsersController],
+  providers: [UsersService],
+  exports: [UsersService],
+})
+export class UsersModule {}
+```
+
+```typescript
+// users.controller.ts
+import {
+  Controller, Get, Post, Body, Param, Put, Delete,
+  ParseIntPipe,
+} from '@nestjs/common';
+import { ApiTags, ApiOperation, ApiBearerAuth } from '@nestjs/swagger';
+import { UsersService } from './users.service';
+import { CreateUserDto } from './dto/create-user.dto';
+import { UpdateUserDto } from './dto/update-user.dto';
+
+@ApiTags('Users')
+@Controller('users')
+@ApiBearerAuth()
+export class UsersController {
+  constructor(private readonly usersService: UsersService) {}
+
+  @Post()
+  @ApiOperation({ summary: '创建用户', description: '创建一个新的系统用户' })
+  create(@Body() createUserDto: CreateUserDto) {
+    return this.usersService.create(createUserDto);
+  }
+
+  @Get()
+  @ApiOperation({ summary: '查询用户列表' })
+  findAll() {
+    return this.usersService.findAll();
+  }
+
+  @Get(':id')
+  @ApiOperation({ summary: '查询单个用户' })
+  findOne(@Param('id', ParseIntPipe) id: number) {
+    return this.usersService.findOne(id);
+  }
+
+  @Put(':id')
+  @ApiOperation({ summary: '更新用户信息' })
+  update(
+    @Param('id', ParseIntPipe) id: number,
+    @Body() updateUserDto: UpdateUserDto,
+  ) {
+    return this.usersService.update(id, updateUserDto);
+  }
+
+  @Delete(':id')
+  @ApiOperation({ summary: '删除用户' })
+  remove(@Param('id', ParseIntPipe) id: number) {
+    return this.usersService.remove(id);
+  }
+}
+```
+
+```typescript
+// users.service.ts
+import { Injectable, Logger, NotFoundException } from '@nestjs/common';
+import { PrismaService } from '../prisma/prisma.service';
+import { CreateUserDto } from './dto/create-user.dto';
+import { UpdateUserDto } from './dto/update-user.dto';
+
+@Injectable()
+export class UsersService {
+  private readonly logger = new Logger(UsersService.name);
+
+  constructor(private readonly prisma: PrismaService) {}
+
+  /**
+   * 创建用户
+   * @param createUserDto 用户创建参数
+   * @returns 创建的用户记录
+   */
+  async create(createUserDto: CreateUserDto) {
+    return this.prisma.user.create({ data: createUserDto });
+  }
+
+  /** 查询所有用户 */
+  async findAll() {
+    return this.prisma.user.findMany();
+  }
+
+  /**
+   * 根据 ID 查询用户
+   * @param id 用户 ID
+   * @throws NotFoundException 用户不存在
+   */
+  async findOne(id: number) {
+    const user = await this.prisma.user.findUnique({ where: { id } });
+    if (!user) throw new NotFoundException(`User #${id} not found`);
+    return user;
+  }
+
+  /**
+   * 更新用户信息
+   * @param id 用户 ID
+   * @param updateUserDto 更新参数
+   */
+  async update(id: number, updateUserDto: UpdateUserDto) {
+    await this.findOne(id);
+    return this.prisma.user.update({
+      where: { id },
+      data: updateUserDto,
+    });
+  }
+
+  /**
+   * 删除用户
+   * @param id 用户 ID
+   */
+  async remove(id: number) {
+    await this.findOne(id);
+    return this.prisma.user.delete({ where: { id } });
+  }
+}
+```
+
+```typescript
+// dto/create-user.dto.ts
+import { ApiProperty } from '@nestjs/swagger';
+import { IsString, IsEmail, IsOptional, IsBoolean } from 'class-validator';
+
+/** 创建用户请求 DTO */
+export class CreateUserDto {
+  @ApiProperty({ description: '用户名', example: 'john_doe' })
+  @IsString()
+  name!: string;
+
+  @ApiProperty({ description: '邮箱地址', example: 'john@example.com' })
+  @IsEmail()
+  email!: string;
+
+  @ApiProperty({ description: '是否激活', required: false, default: true })
+  @IsOptional()
+  @IsBoolean()
+  active?: boolean;
+}
+```
+
+```typescript
+// dto/update-user.dto.ts
+import { PartialType } from '@nestjs/swagger';
+import { CreateUserDto } from './create-user.dto';
+
+/** 更新用户请求 DTO — 所有字段可选 */
+export class UpdateUserDto extends PartialType(CreateUserDto) {}
+```

package/dist/skills/reef-style-backend/variants/nodejs/examples/prisma-example.md

@@ -0,0 +1,115 @@
+# Prisma Service 与 Schema 示例
+
+## Prisma Schema
+
+```prisma
+// prisma/schema.prisma
+
+generator client {
+  provider = "prisma-client-js"
+}
+
+datasource db {
+  provider = "postgresql"
+  url      = env("DATABASE_URL")
+}
+
+/// 系统用户
+model User {
+  id        Int      @id @default(autoincrement())
+  name      String
+  email     String   @unique
+  active    Boolean  @default(true)
+  posts     Post[]
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  @@map("users")
+}
+
+/// 文章
+model Post {
+  id        Int      @id @default(autoincrement())
+  title     String
+  content   String
+  published Boolean  @default(false)
+  author    User     @relation(fields: [authorId], references: [id], onDelete: Cascade)
+  authorId  Int
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  @@map("posts")
+}
+```
+
+## Prisma Module & Service
+
+```typescript
+// prisma/prisma.module.ts
+import { Global, Module } from '@nestjs/common';
+import { PrismaService } from './prisma.service';
+
+/**
+ * Prisma 全局模块
+ * 作为 Global 模块，所有其他模块无需 imports 即可注入 PrismaService
+ */
+@Global()
+@Module({
+  providers: [PrismaService],
+  exports: [PrismaService],
+})
+export class PrismaModule {}
+```
+
+```typescript
+// prisma/prisma.service.ts
+import { Injectable, Logger, OnModuleInit, OnModuleDestroy } from '@nestjs/common';
+import { PrismaClient } from '@prisma/client';
+
+/**
+ * Prisma 数据库服务
+ * 封装 PrismaClient，提供数据库连接生命周期管理
+ */
+@Injectable()
+export class PrismaService extends PrismaClient implements OnModuleInit, OnModuleDestroy {
+  private readonly logger = new Logger(PrismaService.name);
+
+  async onModuleInit() {
+    await this.$connect();
+    this.logger.log('Database connected');
+  }
+
+  async onModuleDestroy() {
+    await this.$disconnect();
+    this.logger.log('Database disconnected');
+  }
+}
+```
+
+## Prisma 查询最佳实践
+
+```typescript
+// 使用事务：多个原子操作
+const [user, post] = await this.prisma.$transaction([
+  this.prisma.user.create({ data: { name: 'Alice', email: 'alice@test.com' } }),
+  this.prisma.post.create({ data: { title: 'Hello', content: 'World', authorId: 1 } }),
+]);
+
+// 使用 select 限制返回字段，避免 N+1
+const users = await this.prisma.user.findMany({
+  select: {
+    id: true,
+    name: true,
+    email: true,
+    posts: {
+      select: { title: true, published: true },
+      where: { published: true },
+    },
+  },
+});
+
+// 使用 findFirstOrThrow 简化判空
+const user = await this.prisma.user.findFirstOrThrow({
+  where: { email: 'alice@test.com' },
+});
+```