@deepstorm/cli 0.9.2 → 0.10.0

package/dist/registry.json

@@ -355,6 +355,9 @@
                 "sourcePath": "src/main/java/ src/test/java/",
                 "styleRef": "→ 参考 [Java 后端速查](quick-reference.md)"
               },
+              "availableAiFrameworks": [
+                "spring-ai"
+              ],
               "affectedTemplates": [
                 "skills/reef-style-backend/SKILL.md.tmpl",
                 "agents/reef-review-backend.md.tmpl",
@@ -380,6 +383,7 @@
                 "styleRef": "→ 参考 [Python FastAPI 后瑞速查](quick-reference.md)",
                 "isPython": "true"
               },
+              "availableAiFrameworks": [],
               "affectedTemplates": [
                 "skills/reef-style-backend/SKILL.md.tmpl",
                 "agents/reef-review-backend.md.tmpl",
@@ -393,6 +397,33 @@
                 "python/security-redlines"
               ]
             },
+            {
+              "value": "nodejs",
+              "label": "Node.js / NestJS",
+              "template": {
+                "label": "NestJS + TypeScript + Prisma",
+                "buildTool": "pnpm:*",
+                "formatCmd": "npx eslint",
+                "fileExt": "*.ts",
+                "sourcePath": "src/ test/",
+                "styleRef": "→ 参考 [Node.js NestJS 后端速查](quick-reference.md)"
+              },
+              "availableAiFrameworks": [
+                "claude-agent-sdk"
+              ],
+              "affectedTemplates": [
+                "skills/reef-style-backend/SKILL.md.tmpl",
+                "agents/reef-review-backend.md.tmpl",
+                "skills/reef-review/SKILL.md.tmpl",
+                "skills/reef-gen-backend/SKILL.md.tmpl"
+              ],
+              "fragments": [
+                "nodejs/api-spec",
+                "nodejs/dependency-management",
+                "nodejs/exception-handling",
+                "nodejs/security-redlines"
+              ]
+            },
             {
               "value": "none",
               "label": "不使用后端",
@@ -790,6 +821,143 @@
             }
           ]
         },
+        {
+          "key": "reef.backend.nodejs.details",
+          "label": "Node.js 框架选型",
+          "description": "选择需要使用的 Node.js 框架和技术",
+          "type": "group",
+          "dependsOn": {
+            "key": "reef.backend.language",
+            "value": "nodejs"
+          },
+          "questions": [
+            {
+              "key": "reef.backend.nodejs.framework",
+              "label": "Web 框架",
+              "type": "select",
+              "options": [
+                {
+                  "value": "nestjs",
+                  "label": "NestJS",
+                  "template": {
+                    "styleRef": "→ 参考 [NestJS 后端速查](quick-reference.md)"
+                  },
+                  "affectedTemplates": [
+                    "skills/reef-style-backend/SKILL.md.tmpl"
+                  ],
+                  "fragments": [
+                    "nodejs/framework/nestjs"
+                  ]
+                },
+                {
+                  "value": "none",
+                  "label": "不使用",
+                  "template": {},
+                  "affectedTemplates": [
+                    "skills/reef-style-backend/SKILL.md.tmpl"
+                  ]
+                }
+              ]
+            },
+            {
+              "key": "reef.backend.nodejs.orm",
+              "label": "ORM",
+              "type": "select",
+              "options": [
+                {
+                  "value": "prisma",
+                  "label": "Prisma",
+                  "template": {
+                    "styleRef": "→ 参考 [Prisma 规范](prisma.md)"
+                  },
+                  "affectedTemplates": [
+                    "skills/reef-style-backend/SKILL.md.tmpl"
+                  ],
+                  "fragments": [
+                    "nodejs/orm/prisma"
+                  ]
+                },
+                {
+                  "value": "none",
+                  "label": "不使用",
+                  "template": {},
+                  "affectedTemplates": [
+                    "skills/reef-style-backend/SKILL.md.tmpl"
+                  ]
+                }
+              ]
+            },
+            {
+              "key": "reef.backend.nodejs.ai",
+              "label": "AI 集成",
+              "type": "select",
+              "options": [
+                {
+                  "value": "claude-agent-sdk",
+                  "label": "Claude Agent SDK",
+                  "template": {
+                    "styleRef": "→ 参考 [Claude Agent SDK 规范](claude-agent-sdk.md)"
+                  },
+                  "affectedTemplates": [
+                    "skills/reef-style-backend/SKILL.md.tmpl"
+                  ],
+                  "fragments": [
+                    "nodejs/ai/claude-agent-sdk"
+                  ]
+                },
+                {
+                  "value": "none",
+                  "label": "不使用",
+                  "template": {},
+                  "affectedTemplates": [
+                    "skills/reef-style-backend/SKILL.md.tmpl"
+                  ]
+                }
+              ]
+            },
+            {
+              "key": "reef.backend.nodejs.test",
+              "label": "单元测试",
+              "type": "select",
+              "options": [
+                {
+                  "value": "jest",
+                  "label": "Jest",
+                  "template": {
+                    "styleRef": "→ 参考 [Jest 规范](jest-testing.md)"
+                  },
+                  "affectedTemplates": [
+                    "skills/reef-style-backend/SKILL.md.tmpl"
+                  ],
+                  "fragments": [
+                    "nodejs/test/jest"
+                  ]
+                },
+                {
+                  "value": "vitest",
+                  "label": "Vitest",
+                  "template": {
+                    "styleRef": "→ 参考 [Vitest 规范](vitest-testing.md)"
+                  },
+                  "affectedTemplates": [
+                    "skills/reef-style-backend/SKILL.md.tmpl"
+                  ],
+                  "fragments": [
+                    "nodejs/test/vitest"
+                  ]
+                },
+                {
+                  "value": "none",
+                  "label": "不使用",
+                  "template": {},
+                  "affectedTemplates": [
+                    "skills/reef-style-backend/SKILL.md.tmpl"
+                  ]
+                }
+              ]
+            }
+          ]
+        },
         {
           "key": "reef.formatter",
           "label": "格式化增强配置",

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

@@ -41,75 +41,32 @@ git status --short
 
 ### 2. 分支名与任务相关性检查
 
-在审查待提交文件之前，先检查当前分支是否与待提交的任务相关。如果当前在 `main`/`master` 分支上则**必须**创建新分支；如果分支名与任务内容明显不匹配（如命名随意、与 OpenSpec 任务不符），建议创建新分支。
+通过 `branch-check.mjs` 检查当前分支是否合法：
 
 ```bash
-BRANCH=$(git branch --show-current)
-echo "当前分支: $BRANCH"
-
-# 检测是否需要创建新分支
-MUST_NEW_BRANCH=false
-
-# 条件一：在 main 或 master 上必须创建新分支
-if [ "$BRANCH" = "main" ] || [ "$BRANCH" = "master" ]; then
-  echo "⚠️ 当前在 $BRANCH 分支上，不允许直接提交，必须创建新分支"
-  MUST_NEW_BRANCH=true
-fi
-
-# 条件二：检查分支名是否包含 temp、wip、test、tmp、dev 等临时名称
-TEMP_PATTERN='^(temp|wip|test|tmp|dev)(/.*)?$'
-if echo "$BRANCH" | grep -qE "$TEMP_PATTERN"; then
-  echo "⚠️ 当前分支名 ($BRANCH) 看起来是临时分支，建议创建有意义的新分支"
-fi
-
-# 收集 OpenSpec 任务上下文
-for dir in openspec/changes/*/; do
-  if [ -f "$dir/proposal.md" ]; then
-    TASK_NAME=$(basename "$dir")
-    echo "发现 OpenSpec 任务: $TASK_NAME"
-  fi
-done
+node packages/reef/skills/reef-commit/scripts/branch-check.mjs
 ```
 
-**判断规则（LLM 自行推理执行）：**
+输出 JSON：
+```json
+{"isValid":true,"warning":false,"action":"continue"}
+```
 
-1. **如果 MUST_NEW_BRANCH=true**（当前在 main/master）：
-   - 直接进入步骤 3「创建新分支」，无需询问用户
-2. **如果分支名明显不相关**（如 `temp-xxx`、`test-foo`、或随意命名与当前变更毫无关联）：
-   - 向用户说明：「当前分支 $BRANCH 与待提交的变更内容似乎不匹配，是否创建一个新分支？」
-   - 用户同意 → 进入步骤 3「创建新分支」
-   - 用户不同意 → 继续当前分支
-3. **如果分支名合理**（如与 OpenSpec 任务同名，或包含功能描述的 kebab-case）：
-   - 直接继续
+**判断规则：**
+- `isValid: false, action: "create-branch"`（当前在 main/master）→ **直接进入步骤 3**
+- `warning: true, action: "suggest-rename"`（分支名像临时分支）→ 询问用户是否改名
+- `matchedTask` 有值 → 说明已匹配到 OpenSpec 任务
+- 其他 → 直接继续
 
 ### 3. 创建新分支
 
-当需要创建新分支时，按以下逻辑确定分支名：
-
-**分支名生成规则（优先级从高到低）：**
-1. **OpenSpec 任务名**：如果检测到 `openspec/changes/<task>/proposal.md`，使用 `<task>` 作为分支名
+按以下逻辑确定分支名（优先级从高到低）：
+1. **OpenSpec 任务名**：由 `branch-check.mjs` 输出的 `matchedTask` 确定
 2. **用户输入**：询问用户想要的分支名
-3. **AI 推导**：根据变更内容总结生成 kebab-case 分支名（例如 `feat/add-user-auth`、`fix/login-timeout`）
+3. **AI 推导**：根据变更内容总结生成 kebab-case 分支名
 
 ```bash
-# 暂存当前未提交变更
-STASHED=false
-if [ -n "$(git status --porcelain)" ]; then
-  git stash push -m "reef-commit-auto-stash"
-  STASHED=true
-fi
-
-# 创建并切换到新分支（基于 main）
-git checkout main
-git pull origin main 2>/dev/null || true
-git checkout -b <new-branch-name>
-
-# 恢复暂存的变更
-if [ "$STASHED" = true ]; then
-  git stash pop
-fi
-
-echo "✅ 已切换到新分支: <new-branch-name>"
+bash packages/reef/skills/reef-commit/scripts/stash-and-switch.sh <new-branch-name>
 ```
 
 > **注意**：创建新分支后，后续步骤（审查文件、范围检查、测试等）在新分支上继续执行。
@@ -129,9 +86,6 @@ git diff --stat
 检查当前分支是否涉及多个业务领域。如果跨领域，给出拆分建议并中止提交。
 
 ```bash
-BRANCH=$(git branch --show-current)
-FORK_POINT=$(git merge-base main HEAD 2>/dev/null || echo "")
-echo "检查分支范围（基准: main）..."
 SCOPE_HOOK="packages/reef/hooks/reef-scope-gate.sh"
 if [ -f "$SCOPE_HOOK" ]; then
   bash "$SCOPE_HOOK" || {
@@ -146,64 +100,37 @@ fi
 ### 6. 运行单元测试
 
 ```bash
-git status --short
-```
-
-如有变更则全量运行测试：
-
-```bash
-./gradlew test
-(cd src/main/web && pnpm test -- --run)
+bash packages/reef/skills/reef-commit/scripts/run-tests.sh --json
 ```
 
-- 测试全部通过 → 继续
-- 任一测试失败 → 提示用户修复后再提交
+- 全部通过（`allPassed: true`）→ 继续
+- 任一测试失败（`allPassed: false`）→ 提示用户修复后再提交
 
 ### 6.5 OpenSpec 验证与归档检查
 
 > 提交前检查关联的 OpenSpec change 是否已完成验证和归档。如果 `openspec/` 目录不存在或无活跃 change 则跳过本步骤。
 
-**判断流程（LLM 自行推理执行）：**
+**判断流程：**
 
 1. **查找关联的 OpenSpec change：**
    ```bash
-   BRANCH=$(git branch --show-current)
-   echo "当前分支: $BRANCH"
-
-   for dir in openspec/changes/*/; do
-     CHANGE_NAME=$(basename "$dir")
-     if [ -f "$dir/.openspec.yaml" ] && [ "$CHANGE_NAME" != "archive" ]; then
-       echo "发现活跃 OpenSpec change: $CHANGE_NAME"
-       cat "$dir/.openspec.yaml"
-     fi
-   done
+   node packages/reef/skills/reef-commit/scripts/check-openspec-status.mjs \
+     --branch "$(git branch --show-current)"
    ```
 
-2. **匹配规则：** 扫描 `openspec/changes/*/` 下活跃 change（不包含 `archive/`），与当前分支名比对；无匹配则跳过；多匹配则让用户选择。
-
-3. **检查归档状态：** 读取 `.openspec.yaml` 中 `status` 字段。`archived` → 跳过后续检查；否则继续。
-
-4. **运行验证：** 确认 `tasks.md` 全部 checkbox 已完成 → 通过 Skill 工具自动调用 `/opsx:verify`。有 CRITICAL 问题则中止；仅 WARNING/SUGGESTION 则通过。
-
+2. **匹配规则：** 脚本输出中 `name` 匹配当前分支名，`tasksAllDone` 检查任务完成状态。
+3. **检查归档状态：** 无输出（`noMatch: true`）→ 跳过。`hasTasksMd: true` + `tasksAllDone: true` → 已全部完成 → 调用 `/opsx:verify` 和 `/opsx:archive`。
+4. **运行验证：** 确认后通过 Skill 工具自动调用 `/opsx:verify`。有 CRITICAL 问题则中止；仅 WARNING/SUGGESTION 则通过。
 5. **运行归档：** 验证通过后 → 通过 Skill 工具自动调用 `/opsx:archive`。执行失败则提示用户手动处理。
 
-6. **确认已就绪：** 校验状态并向用户报告。
-
-> **提示：** verify/archive 执行后产生额外文件变更的，后续步骤会重新检测并纳入提交。
-
 ### 7. 收集上下文
 
 ```bash
-BRANCH=$(git branch --show-current)
-FORK_POINT=$(git merge-base main HEAD 2>/dev/null)
-echo "Branch: $BRANCH"; git diff "$FORK_POINT"..HEAD --stat
-ls -d openspec/changes/*/ 2>/dev/null | grep -v archive
-[ -f "openspec/changes/$BRANCH/proposal.md" ] && head -5 "openspec/changes/$BRANCH/proposal.md"
-# 从 proposal/commit 提取 Issue 引用
-grep -iE '(issue|jira|lc-|proj-)' "openspec/changes/$BRANCH/proposal.md" 2>/dev/null | head -3
-git log "$FORK_POINT"..HEAD --format="%B" 2>/dev/null | grep -ioP '[A-Z]+-\d+' | head -1
+node packages/reef/skills/reef-commit/scripts/collect-git-context.mjs
 ```
 
+输出 JSON 包含 `branch`、`diffStat`、`commitLog`、`openspecChanges` 等字段。提取 `openspecChanges` 中 `matched: true` 项的 `proposal.md` 标题作为提交信息素材。
+
 ### 8. 生成提交信息
 
 **标题：** 优先 OpenSpec proposal 标题 → 分支名（kebab-case 转中文）→ 变更总结。依赖更新用 `更新 {依赖} 至 {版本}`，问题修复用 `解决{问题描述}的问题`。

package/dist/skills/reef-commit/scripts/branch-check.mjs

@@ -0,0 +1,109 @@
+#!/usr/bin/env node
+
+/**
+ * branch-check.mjs
+ * 检查当前分支是否合法。
+ *
+ * 用法:
+ *   node branch-check.mjs
+ *   node branch-check.mjs --branch feat/add-auth
+ *   node branch-check.mjs --help
+ */
+
+import { execSync } from 'node:child_process';
+import { existsSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+
+// ── Exported constants (for test access) ──────────────────────────
+
+/** 临时分支名正则 */
+export const TEMP_PATTERN = /^(temp|wip|test|tmp|dev)(\/.*)?$/;
+
+// ── Pure functions ────────────────────────────────────────────────
+
+export function isMainOrMaster(branch) {
+  return branch === 'main' || branch === 'master';
+}
+
+/**
+ * 检查分支是否合法。
+ * @param {string} branch
+ * @param {Array<{name:string}>} openspecTasks
+ * @returns {{isValid:boolean, reason?:string, action:string,
+ *           warning:boolean, matchedTask?:string}}
+ */
+export function checkBranch(branch, openspecTasks = []) {
+  if (isMainOrMaster(branch)) {
+    return {
+      isValid: false,
+      reason: `不允许在 ${branch} 分支上直接提交`,
+      action: 'create-branch',
+      warning: false,
+    };
+  }
+
+  const isTemp = TEMP_PATTERN.test(branch);
+  const action = isTemp ? 'suggest-rename' : 'continue';
+  const matchedTask = openspecTasks.find(t =>
+    branch === t.name || branch.includes(t.name)
+  );
+
+  return {
+    isValid: true,
+    warning: isTemp,
+    action,
+    ...(isTemp ? { reason: '分支名像临时分支，建议改名' } : {}),
+    ...(matchedTask ? { matchedTask: matchedTask.name } : {}),
+  };
+}
+
+// ── Shell helpers ─────────────────────────────────────────────────
+
+function exec(command) {
+  try {
+    return execSync(command, { encoding: 'utf8', timeout: 5000 }).trim();
+  } catch {
+    return '';
+  }
+}
+
+function findOpenspecTasks() {
+  const root = exec(
+    'git rev-parse --show-toplevel 2>/dev/null || echo ""'
+  );
+  if (!root) return [];
+  const changesDir = join(root, 'openspec', 'changes');
+  if (!existsSync(changesDir)) return [];
+
+  const entries = readdirSync(changesDir, { withFileTypes: true });
+  return entries
+    .filter(e => e.isDirectory() && e.name !== 'archive')
+    .map(e => ({
+      name: e.name,
+      hasProposal: existsSync(join(changesDir, e.name, 'proposal.md')),
+    }));
+}
+
+// ── CLI entry ─────────────────────────────────────────────────────
+
+if (import.meta.filename === process.argv[1]) {
+  if (process.argv.includes('--help') || process.argv.includes('-h')) {
+    console.log(`
+branch-check.mjs — 检查分支合法性
+
+用法:
+  node branch-check.mjs                      自动检测
+  node branch-check.mjs --branch <name>      指定分支
+  node branch-check.mjs --help               显示帮助
+`);
+    process.exit(0);
+  }
+
+  const idx = process.argv.indexOf('--branch');
+  const branch = idx >= 0
+    ? process.argv[idx + 1]
+    : exec('git branch --show-current');
+  const tasks = findOpenspecTasks();
+  const result = checkBranch(branch, tasks);
+  process.stdout.write(JSON.stringify(result, null, 2) + '\n');
+}

package/dist/skills/reef-commit/scripts/check-openspec-status.mjs

@@ -0,0 +1,92 @@
+#!/usr/bin/env node
+
+/**
+ * check-openspec-status.mjs
+ * 扫描 OpenSpec change 的状态。
+ *
+ * 用法:
+ *   node check-openspec-status.mjs
+ *   node check-openspec-status.mjs --branch add-auth
+ *   node check-openspec-status.mjs --help
+ */
+
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+
+const TASKS_CHECKBOX_RE = /^- \[([ xX])\]/gm;
+
+// ── Pure functions ────────────────────────────────────────────────
+
+export function isArchived(changePath) {
+  return changePath.includes('/archive/');
+}
+
+export function parseTasksStatus(content) {
+  const matches = [...content.matchAll(TASKS_CHECKBOX_RE)];
+  const total = matches.length;
+  const complete = matches.filter(m => m[1] !== ' ').length;
+  return {
+    total,
+    complete,
+    allDone: total === 0 ? true : total === complete,
+  };
+}
+
+export function scanChanges(changesDir) {
+  if (!existsSync(changesDir)) return [];
+  const entries = readdirSync(changesDir, { withFileTypes: true });
+  return entries
+    .filter(e => e.isDirectory() && e.name !== 'archive')
+    .map(e => {
+      const dirPath = join(changesDir, e.name);
+      const tasksPath = join(dirPath, 'tasks.md');
+      const hasTasksMd = existsSync(tasksPath);
+      let tasksStatus = null;
+      if (hasTasksMd) {
+        tasksStatus = parseTasksStatus(
+          readFileSync(tasksPath, 'utf8')
+        );
+      }
+      return {
+        name: e.name,
+        archived: false,
+        hasTasksMd,
+        tasksAllDone: tasksStatus ? tasksStatus.allDone : null,
+        tasksTotal: tasksStatus ? tasksStatus.total : 0,
+        tasksComplete: tasksStatus ? tasksStatus.complete : 0,
+      };
+    });
+}
+
+// ── CLI entry ─────────────────────────────────────────────────────
+
+if (import.meta.filename === process.argv[1]) {
+  if (process.argv.includes('--help') || process.argv.includes('-h')) {
+    console.log(`
+check-openspec-status.mjs — 扫描 OpenSpec change 状态
+
+用法:
+  node check-openspec-status.mjs
+  node check-openspec-status.mjs --branch <name>
+  node check-openspec-status.mjs --help
+`);
+    process.exit(0);
+  }
+
+  const root = process.env.INIT_CWD || process.cwd();
+  const changesDir = join(root, 'openspec', 'changes');
+  const results = scanChanges(changesDir);
+
+  const branchIdx = process.argv.indexOf('--branch');
+  if (branchIdx >= 0) {
+    const branch = process.argv[branchIdx + 1];
+    const matched = results.filter(r =>
+      r.name === branch || branch.includes(r.name)
+    );
+    process.stdout.write(JSON.stringify(
+      matched.length > 0 ? matched : { noMatch: true, branch }, null, 2
+    ) + '\n');
+  } else {
+    process.stdout.write(JSON.stringify(results, null, 2) + '\n');
+  }
+}