@deepstorm/cli 0.9.2 → 0.10.0

package/dist/skills/reef-commit/scripts/collect-git-context.mjs

@@ -0,0 +1,186 @@
+#!/usr/bin/env node
+
+/**
+ * collect-git-context.mjs
+ * 收集 git 上下文，输出结构化 JSON。
+ *
+ * 用法:
+ *   node collect-git-context.mjs              # 输出 JSON
+ *   node collect-git-context.mjs --help       # 查看帮助
+ */
+
+import { execSync } from 'node:child_process';
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+
+// ── Pure parse functions (testable) ──────────────────────────────────
+
+/**
+ * 解析 `git diff --stat` 输出
+ * @param {string} output
+ * @returns {{ files: number, insertions: number, deletions: number, changedFiles: string[] }}
+ */
+export 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) {
+    // 匹配汇总行: "2 files changed, 13 insertions(+), 2 deletions(-)"
+    const summaryMatch = line.match(/(\d+)\s+files?\s+changed/);
+    if (summaryMatch) {
+      files = parseInt(summaryMatch[1], 10);
+      const insMatch = line.match(/(\d+)\s+insertions?\(\+\)/);
+      if (insMatch) insertions = parseInt(insMatch[1], 10);
+      const delMatch = line.match(/(\d+)\s+deletions?\(-\)/);
+      if (delMatch) deletions = parseInt(delMatch[1], 10);
+      continue;
+    }
+    // 匹配文件行: "src/main.ts | 10 ++++++++--"
+    const fileMatch = line.match(/^\s*(.+?)\s+\|/);
+    if (fileMatch) {
+      changedFiles.push(fileMatch[1].trim());
+    }
+  }
+
+  return { files, insertions, deletions, changedFiles };
+}
+
+/**
+ * 解析 `git log --oneline` 输出
+ * @param {string} output
+ * @returns {Array<{ hash: string, message: string }>}
+ */
+export function parseCommitLog(output) {
+  const lines = output.trim().split('\n').filter(Boolean);
+  return lines.map(line => {
+    const match = line.match(/^(\S+)\s+(.*)/);
+    return match ? { hash: match[1], message: match[2] } : null;
+  }).filter(Boolean);
+}
+
+/**
+ * 从分支名或 commit 信息中提取 JIRA 引用编号
+ * @param {string} branchName
+ * @param {Array<{hash:string,message:string}>} [commitLog]
+ * @returns {string|null}
+ */
+export function extractJiraRef(branchName, commitLog) {
+  const JIRA_RE = /[A-Z]{2,}-\d+/;
+  const branchMatch = branchName.match(JIRA_RE);
+  if (branchMatch) return branchMatch[0];
+  if (commitLog) {
+    for (const commit of commitLog) {
+      const match = commit.message.match(JIRA_RE);
+      if (match) return match[0];
+    }
+  }
+  return null;
+}
+
+// ── Shell exec helpers ──────────────────────────────────────────────
+
+function exec(command) {
+  try {
+    return execSync(command, { encoding: 'utf8', timeout: 10000 }).trim();
+  } catch {
+    return '';
+  }
+}
+
+// ── Context collection ──────────────────────────────────────────────
+
+/**
+ * 收集完整的 git 上下文
+ * @returns {{ branch: string, forkPoint: string|null, diffStat: object|null, commitLog: Array, hasUncommitted: boolean, openspecChanges: Array|null }}
+ */
+export function collectContext() {
+  const branch = exec('git branch --show-current');
+  let forkPoint;
+  let error;
+  try {
+    forkPoint = execSync('git merge-base main HEAD', { encoding: 'utf8' }).trim();
+  } catch {
+    error = '无法找到基准点';
+  }
+  const diffStat = exec(`git diff "${forkPoint || 'main'}..HEAD" --stat`);
+  const commitLogRaw = forkPoint
+    ? exec(`git log "${forkPoint}"..HEAD --oneline`)
+    : '';
+  const statusShort = exec('git status --short');
+  const hasUncommitted = statusShort.length > 0;
+
+  // OpenSpec change 扫描
+  let openspecChanges = null;
+  const root = exec('git rev-parse --show-toplevel 2>/dev/null || echo ""');
+  if (root) {
+    const changesDir = join(root, 'openspec', 'changes');
+    if (existsSync(changesDir)) {
+      try {
+        const entries = readdirSync(changesDir, { withFileTypes: true });
+        const changeDirs = entries
+          .filter(e => e.isDirectory() && e.name !== 'archive')
+          .map(e => {
+            const proposalPath = join(changesDir, e.name, 'proposal.md');
+            const hasProposal = existsSync(proposalPath);
+            let title = e.name;
+            if (hasProposal) {
+              const firstLine = readFileSync(proposalPath, 'utf8').split('\n')[0] || '';
+              title = firstLine.replace(/^#\s*/, '').trim() || e.name;
+            }
+            return {
+              name: e.name,
+              hasProposal,
+              matched: branch === e.name,
+              title,
+            };
+          });
+        if (changeDirs.length > 0) openspecChanges = changeDirs;
+      } catch {
+        // ignore
+      }
+    }
+  }
+
+  const parsedCommitLog = commitLogRaw ? parseCommitLog(commitLogRaw) : [];
+
+  return {
+    branch,
+    forkPoint: forkPoint || null,
+    diffStat: diffStat ? parseDiffStat(diffStat) : null,
+    commitLog: parsedCommitLog,
+    hasUncommitted,
+    openspecChanges,
+    jiraRef: extractJiraRef(branch, parsedCommitLog),
+    ...(error ? { error } : {}),
+  };
+}
+
+// ── CLI entry ───────────────────────────────────────────────────────
+
+function printHelp() {
+  console.log(`
+collect-git-context.mjs — 收集 git 上下文
+
+用法:
+  node collect-git-context.mjs         输出 JSON 格式的 git 上下文
+  node collect-git-context.mjs --help  显示本帮助
+
+输出字段:
+  branch          当前分支名
+  forkPoint       main 的 merge-base
+  diffStat        { files, insertions, deletions, changedFiles }
+  commitLog       [{ hash, message }]
+  hasUncommitted  是否有未提交变更
+  openspecChanges [{ name, hasProposal, matched, title }] 或 null
+`);
+}
+
+if (import.meta.filename === process.argv[1]) {
+  if (process.argv.includes('--help') || process.argv.includes('-h')) {
+    printHelp();
+    process.exit(0);
+  }
+  const context = collectContext();
+  process.stdout.write(JSON.stringify(context, null, 2) + '\n');
+}

package/dist/skills/reef-commit/scripts/run-tests.sh

@@ -0,0 +1,91 @@
+#!/bin/bash
+# run-tests.sh
+# 根据项目类型自动检测并运行测试。
+#
+# 用法:
+#   bash run-tests.sh              # 自动检测并运行
+#   bash run-tests.sh --json       # JSON 格式输出结果
+#   bash run-tests.sh --help       # 显示帮助
+
+set -euo pipefail
+
+MODE="text"
+for arg in "$@"; do
+  case "$arg" in
+    --json) MODE="json" ;;
+    --help|-h)
+      echo "用法: bash run-tests.sh [--json]"
+      echo "自动检测项目类型（Java/Python/Frontend）并运行测试"
+      exit 0
+      ;;
+  esac
+done
+
+FRONTEND_FAILED=false
+BACKEND_FAILED=false
+HAS_FRONTEND=false
+HAS_BACKEND=false
+
+# 检测后端
+if [ -f "build.gradle" ] || [ -f "build.gradle.kts" ]; then
+  HAS_BACKEND=true
+  echo "🔍 检测到 Gradle 项目，运行 ./gradlew test..."
+  if ./gradlew test 2>&1; then
+    echo "✅ Java 测试通过"
+  else
+    BACKEND_FAILED=true
+    echo "❌ Java 测试失败"
+  fi
+elif [ -f "pom.xml" ]; then
+  HAS_BACKEND=true
+  echo "🔍 检测到 Maven 项目，运行 mvn test..."
+  if mvn test 2>&1; then
+    echo "✅ Java 测试通过"
+  else
+    BACKEND_FAILED=true
+    echo "❌ Java 测试失败"
+  fi
+elif [ -f "pyproject.toml" ] || [ -f "pytest.ini" ]; then
+  HAS_BACKEND=true
+  echo "🔍 检测到 Python 项目，运行 pytest..."
+  if python -m pytest 2>&1; then
+    echo "✅ Python 测试通过"
+  else
+    BACKEND_FAILED=true
+    echo "❌ Python 测试失败"
+  fi
+fi
+
+# 检测前端
+if [ -f "package.json" ]; then
+  HAS_FRONTEND=true
+  echo "🔍 检测到前端项目，运行 pnpm test..."
+  if pnpm test -- --run 2>&1; then
+    echo "✅ 前端测试通过"
+  else
+    FRONTEND_FAILED=true
+    echo "❌ 前端测试失败"
+  fi
+fi
+
+if [ "$HAS_BACKEND" = false ] && [ "$HAS_FRONTEND" = false ]; then
+  echo "⚠️  未检测到可运行的测试项目"
+fi
+
+# JSON 输出
+if [ "$MODE" = "json" ]; then
+  cat <<EOF
+{
+  "hasFrontend": $HAS_FRONTEND,
+  "hasBackend": $HAS_BACKEND,
+  "frontendPassed": $( [ "$FRONTEND_FAILED" = false ] && echo "$HAS_FRONTEND" || echo false ),
+  "backendPassed": $( [ "$BACKEND_FAILED" = false ] && echo "$HAS_BACKEND" || echo false ),
+  "allPassed": $( [ "$FRONTEND_FAILED" = false ] && [ "$BACKEND_FAILED" = false ] && echo true || echo false )
+}
+EOF
+fi
+
+# exit code
+if [ "$FRONTEND_FAILED" = true ] || [ "$BACKEND_FAILED" = true ]; then
+  exit 1
+fi

package/dist/skills/reef-commit/scripts/stash-and-switch.sh

@@ -0,0 +1,44 @@
+#!/bin/bash
+# stash-and-switch.sh
+# git stash → checkout main → pull → checkout -b → stash pop
+#
+# 用法:
+#   bash stash-and-switch.sh <new-branch-name>
+#
+# 说明:
+#   自动处理 stash 保存和恢复当前工作区变更。
+#   新分支基于 main 的最新提交。
+
+set -euo pipefail
+
+if [ $# -lt 1 ]; then
+  echo "用法: bash $0 <new-branch-name>"
+  exit 1
+fi
+
+NEW_BRANCH="$1"
+STASHED=false
+
+# stash 当前变更（如有）
+if [ -n "$(git status --porcelain)" ]; then
+  echo "📦 暂存当前未提交变更..."
+  git stash push -m "stash-and-switch-auto-stash"
+  STASHED=true
+fi
+
+# 切换到 main 并更新
+echo "🔀 切换到 main..."
+git checkout main
+git pull origin main 2>/dev/null || echo "  ⚠️  pull 失败（可能无远程）"
+
+# 创建新分支
+echo "🌿 创建新分支: $NEW_BRANCH"
+git checkout -b "$NEW_BRANCH"
+
+# 恢复暂存的变更
+if [ "$STASHED" = true ]; then
+  echo "📦 恢复暂存的变更..."
+  git stash pop
+fi
+
+echo "✅ 已切换到新分支: $NEW_BRANCH"

package/dist/skills/reef-gen-backend/variants/nodejs/steps.md

@@ -0,0 +1,53 @@
+# Node.js / NestJS 后端编码步骤
+
+按以下顺序逐块编写，依赖关系由前向后：
+
+1. **Prisma Schema** — 定义数据模型（`prisma/schema.prisma`），**先于所有代码**，因为它决定类型结构
+2. **DTO** — 数据传输对象（请求/响应），使用 `class-validator` + `@nestjs/swagger` 装饰器
+3. **Entity** — Prisma 生成的 TypeScript 类型，必要时封装为 Entity 类（可选）
+4. **PrismaService** — 数据库访问服务（`PrismaModule` + `PrismaService`），如果尚未创建
+5. **Service** — 业务逻辑层，依赖 `PrismaService`，事务处理
+6. **Controller** — REST API，请求/响应，参数校验
+7. **Module** — NestJS 模块，将 Controller/Service 注册到 DI 容器
+
+每完成一块对照 `reef:reef-style-backend` 中对应章节检查。
+
+## 注释要求
+
+每类文件必须包含以下注释（缺少则视为未完成）：
+
+| 文件类型 | 注释要求 |
+|---------|---------|
+| **Prisma Schema** | 每个 model 加 `/// 注释` 描述实体用途；每个字段加 `/// 注释` |
+| **DTO** | 类 JSDoc `/** 用途说明 */`；字段通过 `@ApiProperty({ description: '...' })` 提供文档 |
+| **Service** | 每个 public 方法加 JSDoc `/** 功能、@param、@returns */`；复杂逻辑内联注释说明 |
+| **Controller** | 每个端点加 `@ApiOperation({ summary: '...', description: '...' })` |
+| **Module** | 类 JSDoc `/** 模块职责 */` |
+
+## 安全红线
+
+- 所有环境变量通过 `ConfigService` 读取，禁止 `process.env` 直读
+- 敏感字段（密码、Token）在 API 响应前使用 `select` 或 `@Exclude()` 排除
+- 禁止在 TypeScript 代码中硬编码 API Key / Token
+- Prisma 条件查询使用参数化查询（Prisma 默认安全），禁止手动拼接 `where` 条件
+- API 端点需添加 `@ApiBearerAuth()` 和 `@UseGuards(AuthGuard())`
+
+## 构建命令
+
+```bash
+# 依赖安装
+pnpm install
+
+# Prisma 客户端生成
+npx prisma generate
+
+# 代码检查
+npx eslint src/ --ext .ts
+npx prettier --check src/
+
+# 测试
+npx jest
+
+# 构建
+npx nest build
+```

package/dist/skills/reef-harden/SKILL.md

@@ -10,25 +10,17 @@ deepstorm:
 
 ## 上下文约定
 
-当前 change 名 = 当前分支名（由 jira-start 阶段三建立）：
+使用 `find-change-dir.mjs` 自动发现当前 change：
 
 ```bash
-# 自动发现当前 change
-CHANGE=$(git branch --show-current)
-CHANGE_DIR="openspec/changes/$CHANGE"
-
-# 如分支名与 change 目录不匹配，遍历所有 change 取最近一个
-if [ ! -d "$CHANGE_DIR" ]; then
-  CHANGE=$(ls -t openspec/changes/ 2>/dev/null | head -1)
-  CHANGE_DIR="openspec/changes/$CHANGE"
-fi
-
-# 如仍无结果，列出所有 change 让用户选择
-if [ ! -d "$CHANGE_DIR" ]; then
-  echo "未找到 openspec change，可用的目录:"
-  ls openspec/changes/
-  echo "请指定 change 名"
-fi
+node packages/reef/skills/reef-harden/scripts/find-change-dir.mjs
+```
+
+输出 JSON。`noMatch: true` 时需让用户选择；有 `suggestion` 时使用推荐 change。
+
+如需并列出 SDD 文档路径：
+```bash
+node packages/reef/skills/reef-harden/scripts/find-change-dir.mjs --files
 ```
 
 ## 快速开始
@@ -45,8 +37,8 @@ fi
 ### Step 1: 加载文档
 
 ```bash
-# 列出当前 change 下所有 SDD 文档
-find "$CHANGE_DIR" -name "*.md" -maxdepth 2 | sort
+CHANGE_JSON=$(node packages/reef/skills/reef-harden/scripts/find-change-dir.mjs)
+# CHANGE_JSON 中包含 path 和 files[]，files 为所有 SDD 文档路径
 ```
 
 读取所有这些文档。目录结构通常为：

package/dist/skills/reef-harden/scripts/find-change-dir.mjs

@@ -0,0 +1,157 @@
+#!/usr/bin/env node
+
+/**
+ * find-change-dir.mjs
+ * 自动发现当前 OpenSpec change 目录。
+ *
+ * 用法:
+ *   node find-change-dir.mjs                   # 根据分支自动查找
+ *   node find-change-dir.mjs --branch <name>   # 指定分支
+ *   node find-change-dir.mjs --files           # 同时列出 SDD 文档
+ *   node find-change-dir.mjs --dir <path>      # 指定扫描目录
+ *   node find-change-dir.mjs --help
+ */
+
+import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
+import { execSync } from 'node:child_process';
+import { join } from 'node:path';
+
+const CHANGES_GLOB = 'openspec/changes';
+
+// ── Pure functions ────────────────────────────────────────────────
+
+function isArchivePath(changePath) {
+  return changePath.includes('/archive/');
+}
+
+/**
+ * 在 changes 列表中按 name 精确查找
+ * @param {Array} changes
+ * @param {string} name
+ * @returns {object|null}
+ */
+export function findChangeByName(changes, name) {
+  return changes.find(c =>
+    c.name === name && !isArchivePath(c.path)
+  ) || null;
+}
+
+/**
+ * 返回最近修改的非归档 change
+ * @param {Array} changes
+ * @returns {object|null}
+ */
+export function findMostRecent(changes) {
+  const active = changes.filter(c => !c.archived);
+  if (active.length === 0) return null;
+  return active.sort((a, b) => b.mtimeMs - a.mtimeMs)[0];
+}
+
+/**
+ * 列出 changes 目录下的所有 change
+ * @param {string} changesDir
+ * @returns {Array<{name:string, path:string, archived:boolean, mtimeMs:number, files:string[]}>}
+ */
+export function listChanges(changesDir) {
+  if (!existsSync(changesDir)) return [];
+  const entries = readdirSync(changesDir, { withFileTypes: true });
+  const results = [];
+
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue;
+    if (entry.name === 'archive') continue;
+
+    const dirPath = join(changesDir, entry.name);
+    const stats = statSync(dirPath);
+
+    // 收集 .md 文件
+    const files = collectMdFiles(dirPath);
+
+    results.push({
+      name: entry.name,
+      path: dirPath,
+      archived: false,
+      mtimeMs: stats.mtimeMs,
+      files,
+    });
+  }
+
+  return results;
+}
+
+function collectMdFiles(dir) {
+  try {
+    const entries = readdirSync(dir, { withFileTypes: true });
+    const files = [];
+    for (const e of entries) {
+      if (e.isFile() && e.name.endsWith('.md')) {
+        files.push(join(dir, e.name));
+      }
+      if (e.isDirectory()) {
+        const sub = collectMdFiles(join(dir, e.name));
+        files.push(...sub);
+      }
+    }
+    return files;
+  } catch {
+    return [];
+  }
+}
+
+// ── CLI entry ─────────────────────────────────────────────────────
+
+if (import.meta.filename === process.argv[1]) {
+  if (process.argv.includes('--help') || process.argv.includes('-h')) {
+    console.log(`
+find-change-dir.mjs — 发现 OpenSpec change 目录
+
+用法:
+  node find-change-dir.mjs                 根据分支自动查找
+  node find-change-dir.mjs --branch <name> 指定分支
+  node find-change-dir.mjs --files         同时列出 SDD 文档
+  node find-change-dir.mjs --dir <path>    指定扫描目录
+  node find-change-dir.mjs --help
+`);
+    process.exit(0);
+  }
+
+  const root = process.argv.indexOf('--dir') >= 0
+    ? process.argv[process.argv.indexOf('--dir') + 1]
+    : process.env.INIT_CWD || process.cwd();
+  const changesDir = join(root, CHANGES_GLOB);
+  const allChanges = listChanges(changesDir);
+
+  const branchIdx = process.argv.indexOf('--branch');
+  let result;
+
+  if (branchIdx >= 0) {
+    const branch = process.argv[branchIdx + 1];
+    result = findChangeByName(allChanges, branch);
+    if (!result) {
+      result = {
+        noMatch: true,
+        branch,
+        suggestion: findMostRecent(allChanges),
+      };
+    }
+  } else {
+    const branch = execGitBranch();
+    result = branch
+      ? (findChangeByName(allChanges, branch) ||
+         { noMatch: true, branch,
+           suggestion: findMostRecent(allChanges) })
+      : { noMatch: true, allChanges };
+  }
+
+  process.stdout.write(JSON.stringify(result, null, 2) + '\n');
+}
+
+function execGitBranch() {
+  try {
+    return execSync('git branch --show-current', {
+      encoding: 'utf8', timeout: 5000,
+    }).trim() || null;
+  } catch {
+    return null;
+  }
+}

package/dist/skills/reef-pr/SKILL.md

@@ -30,15 +30,10 @@ CHANGE_DIR="openspec/changes/$BRANCH"
 先检查未提交变更。如有则提示「请先 commit 再创建 PR」，中止流程。
 
 ```bash
-BRANCH=$(git branch --show-current)
-FORK_POINT=$(git merge-base main HEAD 2>/dev/null)
-echo "Branch: $BRANCH"; git status -sb
-echo "Commits:"; git log "$FORK_POINT"..HEAD --oneline
-echo "Changes:"; git diff "$FORK_POINT"..HEAD --stat
-ls -d openspec/changes/$BRANCH/*.md 2>/dev/null
+node packages/reef/skills/reef-pr/scripts/create-pr.mjs --collect
 ```
 
-如有 OpenSpec change，读取 `proposal.md` 和 `tasks.md` 作为描述素材。
+输出 JSON 包含 `branch`、`hasUncommitted`、`diffStat`、`commitLog`、`proposalTitle`。如有 OpenSpec change，`proposalTitle` 会包含 proposal 标题。
 
 ### 2. 构建 PR 信息
 
@@ -71,20 +66,11 @@ OpenSpec: openspec/changes/{branch-name}/
 
 ### 4. 推送并创建 PR
 
-先检查是否已有打开的 PR：
+先检查是否已有打开的 PR，用 `create-pr.mjs` 统一处理：
 
 ```bash
-EXISTING_PR=$(gh pr view --json url 2>/dev/null)
-```
-
-如有则询问「已有 PR，是否更新描述？」，用户确认后用 `gh pr update` 更新；否则正常创建：
-
-```bash
-# 首次推送当前分支
-git push -u origin $(git branch --show-current)
-
-# 创建 PR（如有 reviewer/label/draft 则追加对应参数）
-gh pr create \
+# --title 和 --body 从步骤 2 构建的 PR 信息中取
+node packages/reef/skills/reef-pr/scripts/create-pr.mjs --create \
   --title "<标题>" \
   --body "<正文>" \
   [--reviewer "<用户>"] \
@@ -92,6 +78,8 @@ gh pr create \
   [--draft]
 ```
 
+如有已有 PR，脚本输出 `{"exists":true}` 并在 stderr 输出提示，此时可用 `gh pr update` 更新。
+
 ### 5. 输出结果
 
 返回 PR 链接。