@deepstorm/cli 0.9.2 → 0.9.3

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-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 链接。

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/sweep-init/SKILL.md

@@ -103,107 +103,21 @@ E2E_PATH=$(cat .deepstorm/settings.json 2>/dev/null | grep -o '"e2eProjectPath"[
 
 ---
 
-### 步骤 2：创建项目目录结构
+### 步骤 2+3：创建项目目录与配置文件
 
-在 `{TARGET_DIR}` 下创建 E2E 测试项目的目录骨架。
-
-#### 目录结构（当 TARGET_DIR 为 `"."` 时）
-
-```
-.
-├── flows/                       # 测试意图文档目录
-│   ├── topology.yaml            # 功能模块拓扑定义（待用户编辑）
-│   └── reports/                 # 执行报告持久化目录
-├── scripts/
-│   └── flow-selector.mjs        # 层级选择工具（预置）
-├── .env                         # 环境变量（gitignored，即模板）
-├── package.json                 # 依赖声明
-└── tsconfig.json                # TypeScript 配置
-```
-
-> 如果 TARGET_DIR 为 `"e2e"`，以上所有文件在 `e2e/` 下生成。如果框架为 `playwright`，还会额外生成 `playwright.config.ts`。
-
-#### 执行
+使用 `init-project.mjs` 一键创建目录结构并生成所有配置文件：
 
 ```bash
-# 计算目标目录：TARGET_DIR 为 "." 时用当前目录，否则用 TARGET_DIR
-if [ "$TARGET_DIR" != "." ]; then
-  mkdir -p "$TARGET_DIR"/flows "$TARGET_DIR"/flows/reports "$TARGET_DIR"/scripts
-  echo "📂 将在 $TARGET_DIR/ 目录下生成 E2E 测试项目"
-else
-  mkdir -p flows flows/reports scripts
-fi
-```
-
----
-
-### 步骤 3：生成项目配置文件（框架感知）
-
-根据步骤 0 读取的框架配置，在 `{TARGET_DIR}` 下生成对应的配置文件。
-
-> 所有文件写入路径以 `{TARGET_DIR}` 为前缀。当 `TARGET_DIR` 为 `"."` 时，路径不变。
-
-#### 3.1 package.json
-
-写入基础 `package.json`。如果框架为 `playwright`，包含 Playwright 依赖：
-
-```json
-{
-  "name": "sweep-e2e",
-  "version": "1.0.0",
-  "private": true,
-  "type": "module",
-  "scripts": {
-    "test": "playwright test",
-    "report": "playwright show-report"
-  },
-  "devDependencies": {
-    "@playwright/test": "^1.50.0",
-    "@inquirer/checkbox": "^4.0.0",
-    "@types/node": "^22.0.0"
-  }
-}
-```
-
-> 当 E2E 框架未知或未配置时，`package.json` 中仅包含 `@inquirer/checkbox` 和 `@types/node` 依赖，**不包含** `@playwright/test`。
-
-#### 3.2 框架配置文件
-
-**当框架为 `playwright` 时**，写入 `{TARGET_DIR}/playwright.config.ts`，包含多环境 baseURL 设置：
-
-```ts
-import { defineConfig } from '@playwright/test';
-
-export default defineConfig({
-  use: {
-    baseURL: process.env.BASE_URL || 'http://localhost:3000',
-  },
-  timeout: 30000,
-  retries: 0,
-  reporter: [['line'], ['html', { outputFolder: 'flows/reports' }]],
-  projects: [
-    { name: 'chromium', use: { browserName: 'chromium' } },
-  ],
-});
+node packages/sweep/skills/sweep-init/scripts/init-project.mjs \
+  --dir "$TARGET_DIR" \
+  --framework "$(node scripts/env-manager.mjs --framework | node -pe "JSON.parse(require('fs').readFileSync('/dev/stdin','utf8')).framework || ''")"
 ```
 
-**当框架未知或未配置时**，跳过框架配置文件的生成，输出提示："框架未配置，请运行 deepstorm setup 并选择 E2E 框架。"
-
-#### 3.3 tsconfig.json
-
-写入 TypeScript 配置（框架无关）：
-
-```json
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "ESNext",
-    "moduleResolution": "bundler",
-    "strict": true,
-    "esModuleInterop": true
-  }
-}
-```
+脚本会自动：
+- 创建 `flows/`、`flows/reports/`、`scripts/` 目录
+- 生成 `package.json`（含框架对应依赖）、`tsconfig.json`、`playwright.config.ts`（仅 playwright）
+- 不覆盖已有的 `topology.yaml`
+- 执行 `npm install`
 
 ---
 
@@ -312,38 +226,11 @@ cat .mcp.json 2>/dev/null | grep -c "deepstorm-playwright"
 
 #### 8.1 写入 e2eProjectPath 到 settings.json
 
-将 `sweep.e2eProjectPath` 写入 `.deepstorm/settings.json`。**不再创建 `.sweep-init` 标记文件。**
-
-```bash
-# 值由步骤 0A 确定：
-#   独立项目 → "."
-#   混放项目 → 用户选择的路径（如 "e2e"）
-```
-
-写入后的 settings.json 结构示例：
-
-```json
-{
-  "sweep": {
-    "e2eFramework": "playwright",
-    "e2eProjectPath": "e2e",
-    "environments": { ... }
-  }
-}
-```
-
-#### 8.2 安装依赖
-
 ```bash
-# 在目标目录中执行 npm install
-if [ "$TARGET_DIR" != "." ]; then
-  cd "$TARGET_DIR" && npm install
-else
-  npm install
-fi
+node scripts/env-manager.mjs --set-e2e-path "$TARGET_DIR"
 ```
 
-#### 8.3 输出完成信息
+#### 8.2 输出完成信息
 
 ```
 ✅ Sweep E2E 测试项目初始化完成！