@deepstorm/cli 0.9.2 → 0.9.3

package/dist/skills/sweep-init/scripts/init-project.mjs

@@ -0,0 +1,166 @@
+#!/usr/bin/env node
+
+/**
+ * init-project.mjs
+ * 初始化 E2E 测试项目骨架。
+ *
+ * 用法:
+ *   node init-project.mjs                 # 在当前目录
+ *   node init-project.mjs --dir e2e       # 指定子目录
+ *   node init-project.mjs --framework playwright
+ *   node init-project.mjs --help
+ */
+
+import { mkdirSync, writeFileSync, existsSync } from 'node:fs';
+import { resolve, join } from 'node:path';
+import { execSync } from 'node:child_process';
+
+// ── Template writers ──────────────────────────────────────────────
+
+function writePackageJson(targetDir, framework) {
+  const deps = {
+    '@inquirer/checkbox': '^4.0.0',
+    '@types/node': '^22.0.0',
+  };
+  if (framework === 'playwright') {
+    deps['@playwright/test'] = '^1.50.0';
+  }
+  const scripts = { report: 'playwright show-report' };
+  if (framework === 'playwright') {
+    scripts.test = 'playwright test';
+  }
+
+  writeFileSync(join(targetDir, 'package.json'), JSON.stringify({
+    name: 'sweep-e2e',
+    version: '1.0.0',
+    private: true,
+    type: 'module',
+    scripts,
+    devDependencies: deps,
+  }, null, 2) + '\n');
+}
+
+function writePlaywrightConfig(targetDir) {
+  writeFileSync(join(targetDir, 'playwright.config.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' } },",
+    '  ],',
+    '});',
+    '',
+  ].join('\n'));
+}
+
+function writeTsconfig(targetDir) {
+  writeFileSync(join(targetDir, 'tsconfig.json'), JSON.stringify({
+    compilerOptions: {
+      target: 'ES2022',
+      module: 'ESNext',
+      moduleResolution: 'bundler',
+      strict: true,
+      esModuleInterop: true,
+    },
+  }, null, 2) + '\n');
+}
+
+function writeTopologyYaml(targetDir) {
+  writeFileSync(join(targetDir, 'flows', 'topology.yaml'), [
+    '# flows/topology.yaml',
+    'name: E2E 测试拓扑',
+    'version: 1',
+    'modules:',
+    '  - name: example',
+    '    description: 示例模块',
+    '    children:',
+    '      - name: feature1',
+    '        description: 功能 1',
+    '        features: []',
+    '',
+  ].join('\n'));
+}
+
+// ── Main ──────────────────────────────────────────────────────────
+
+export function initProject(opts = {}) {
+  const {
+    framework = null,   // 'playwright' | null
+    dir = '.',
+  } = opts;
+
+  const targetDir = resolve(process.cwd(), dir);
+  const flowsDir = join(targetDir, 'flows');
+  const reportsDir = join(flowsDir, 'reports');
+  const scriptsDir = join(targetDir, 'scripts');
+
+  // 创建目录
+  mkdirSync(flowsDir, { recursive: true });
+  mkdirSync(reportsDir, { recursive: true });
+  mkdirSync(scriptsDir, { recursive: true });
+
+  // 写入配置文件
+  writePackageJson(targetDir, framework);
+  writeTsconfig(targetDir);
+
+  if (framework === 'playwright') {
+    writePlaywrightConfig(targetDir);
+  }
+
+  if (!existsSync(join(flowsDir, 'topology.yaml'))) {
+    writeTopologyYaml(targetDir);
+  }
+
+  // npm install
+  try {
+    execSync('npm install', {
+      cwd: targetDir,
+      stdio: 'pipe',
+      timeout: 60000,
+    });
+  } catch {
+    // npm install 失败不阻塞
+  }
+
+  const created = [
+    'flows/', 'flows/reports/', 'scripts/',
+    'package.json', 'tsconfig.json',
+  ];
+  if (framework === 'playwright') created.push('playwright.config.ts');
+  if (!existsSync(join(flowsDir, 'topology.yaml'))) {
+    created.push('flows/topology.yaml');
+  }
+
+  return { dir: targetDir, created, framework };
+}
+
+// ── CLI entry ─────────────────────────────────────────────────────
+
+if (import.meta.filename === process.argv[1]) {
+  if (process.argv.includes('--help') || process.argv.includes('-h')) {
+    console.log(`
+init-project.mjs — E2E 测试项目初始化
+
+用法:
+  node init-project.mjs                         当前目录
+  node init-project.mjs --dir e2e               指定子目录
+  node init-project.mjs --framework playwright   指定框架
+  node init-project.mjs --help
+`);
+    process.exit(0);
+  }
+
+  const dirIdx = process.argv.indexOf('--dir');
+  const fwIdx = process.argv.indexOf('--framework');
+  const result = initProject({
+    dir: dirIdx >= 0 ? process.argv[dirIdx + 1] : '.',
+    framework: fwIdx >= 0 ? process.argv[fwIdx + 1] : null,
+  });
+  process.stdout.write(JSON.stringify(result, null, 2) + '\n');
+}

package/dist/skills/sweep-run/SKILL.md

@@ -58,52 +58,28 @@ node scripts/env-manager.mjs --framework
 
 ### 步骤 1：检查初始化状态与路径导航
 
-从 `.deepstorm/settings.json` 读取 `sweep.e2eProjectPath`，确定 E2E 测试项目的位置，如非根目录则自动切换。支持从子目录向上查找以兼容用户在 E2E 项目子目录中执行的情况。
+从 `.deepstorm/settings.json` 读取 `sweep.e2eProjectPath`，确定 E2E 测试项目的位置。
 
 ```bash
-# 向上查找 .deepstorm/settings.json
-DEEPSTORM_DIR=""
-CUR="$PWD"
-while [ "$CUR" != "/" ]; do
-  if [ -f "$CUR/.deepstorm/settings.json" ]; then
-    DEEPSTORM_DIR="$CUR"
-    break
-  fi
-  CUR=$(dirname "$CUR")
-done
-
-if [ -n "$DEEPSTORM_DIR" ]; then
-  E2E_PATH=$(grep -o '"e2eProjectPath"[^,]*' "$DEEPSTORM_DIR/.deepstorm/settings.json" | head -1 | cut -d'"' -f4)
-else
-  E2E_PATH=""
-fi
+node scripts/env-manager.mjs --project-root
+# 输出: {"found":true,"path":"/abs/path/to/project"}
 ```
 
 #### 1.1 配置存在 → 路径导航
 
-- **WHEN** `E2E_PATH` 不为空
-- **THEN** 判断路径值。注意 `E2E_PATH` 是基于 `DEEPSTORM_DIR`（settings.json 所在目录）的相对路径，若当前在子目录则需拼接：
+- **WHEN** `--project-root` 输出 `found: true`
+- **THEN** 读取 `sweep.e2eProjectPath`：
   ```bash
-  if [ "$E2E_PATH" != "." ]; then
-    # 若从子目录找到的 settings.json，E2E_PATH 相对于 DEEPSTORM_DIR
-    TARGET_DIR="$E2E_PATH"
-    if [ -n "$DEEPSTORM_DIR" ] && [ "$DEEPSTORM_DIR" != "$PWD" ]; then
-      TARGET_DIR="$DEEPSTORM_DIR/$E2E_PATH"
-    fi
-    if [ -d "$TARGET_DIR" ]; then
-      echo "📂 切换到 E2E 项目目录: $E2E_PATH"
-      cd "$TARGET_DIR"
-    else
-      echo "❌ E2E 项目目录不存在: $E2E_PATH，请重新运行 /sweep-init"
-      exit 1
-    fi
-  fi
+  E2E_PATH=$(grep -o '"e2eProjectPath"[^,]*' \
+    "$(node scripts/env-manager.mjs --project-root | \
+      node -pe "JSON.parse(require('fs').readFileSync('/dev/stdin','utf8')).path")/.deepstorm/settings.json" \
+    | head -1 | cut -d'"' -f4)
   ```
 
 #### 1.2 配置不存在 → 报错退出
 
-- **WHEN** `E2E_PATH` 为空
-- **THEN** 提示"❌ 未检测到 E2E 项目。请先运行 /sweep-init 初始化。"并退出
+- **WHEN** `--project-root` 输出 `found: false`
+- **THEN** 提示"❌ 未检测到深风项目。请先运行 deepstorm setup。"并退出
 
 ---
 

package/dist/skills/sweep-run/scripts/env-manager.mjs

@@ -20,8 +20,8 @@
  *   import { resolveEnv, listEnvs, readFramework, checkMcpAvailable } from './env-manager.mjs'
  */
 
-import { readFileSync, existsSync } from 'node:fs';
-import { resolve } from 'node:path';
+import { readFileSync, writeFileSync, existsSync } from 'node:fs';
+import { resolve, dirname, sep } from 'node:path';
 
 // ── Path helpers (lazy, respect process.cwd() changes) ────────────
 
@@ -217,6 +217,55 @@ export function readFramework() {
 
 // ── MCP availability ──────────────────────────────────────────────
 
+// ── Project root discovery ──────────────────────────────────────────
+
+/**
+ * Walk up from startDir to find .deepstorm/settings.json
+ *
+ * @param {string} [startDir] - defaults to process.cwd()
+ * @returns {string|null} resolved dir containing settings.json, or null
+ */
+export function resolveProjectRoot(startDir) {
+  let dir = startDir ? resolve(startDir) : process.cwd();
+  while (true) {
+    if (existsSync(resolve(dir, '.deepstorm', 'settings.json'))) {
+      return dir;
+    }
+    const parent = dirname(dir);
+    if (parent === dir) return null;
+    dir = parent;
+  }
+}
+
+/**
+ * Write or update a key in .deepstorm/settings.json.
+ *
+ * @param {string} keyPath dot-separated path, e.g. "sweep.e2eProjectPath"
+ * @param {*} value
+ * @returns {boolean}
+ */
+export function writeDeepstormConfig(keyPath, value) {
+  const filePath = resolve(process.cwd(), '.deepstorm', 'settings.json');
+  if (!existsSync(filePath)) return false;
+  try {
+    const content = readFileSync(filePath, 'utf-8');
+    const config = JSON.parse(content);
+    const keys = keyPath.split('.');
+    let obj = config;
+    for (let i = 0; i < keys.length - 1; i++) {
+      if (!obj[keys[i]] || typeof obj[keys[i]] !== 'object') {
+        obj[keys[i]] = {};
+      }
+      obj = obj[keys[i]];
+    }
+    obj[keys[keys.length - 1]] = value;
+    writeFileSync(filePath, JSON.stringify(config, null, 2) + '\n');
+    return true;
+  } catch {
+    return false;
+  }
+}
+
 /**
  * Check if the required MCP service is configured in .mcp.json.
  *
@@ -263,6 +312,26 @@ if (process.argv[1] === import.meta.filename) {
     process.exit(0);
   }
 
+  if (args.includes('--project-root')) {
+    const startIdx = args.indexOf('--project-root');
+    const startDir = startIdx + 1 < args.length ? args[startIdx + 1] : undefined;
+    const result = resolveProjectRoot(startDir);
+    if (result) {
+      console.log(JSON.stringify({ found: true, path: result }));
+    } else {
+      console.log(JSON.stringify({ found: false }));
+    }
+    process.exit(0);
+  }
+
+  if (args.includes('--set-e2e-path')) {
+    const idx = args.indexOf('--set-e2e-path');
+    const path = idx + 1 < args.length ? args[idx + 1] : '.';
+    const ok = writeDeepstormConfig('sweep.e2eProjectPath', path);
+    console.log(JSON.stringify({ ok, path }));
+    process.exit(0);
+  }
+
   // Default: resolve env
   const envFlag = args.find(a => a.startsWith('--env='));
   const envName = envFlag ? envFlag.split('=')[1] : undefined;

package/dist/skills/sweep-run/scripts/generate-report.mjs

@@ -0,0 +1,116 @@
+#!/usr/bin/env node
+
+/**
+ * generate-report.mjs
+ * 生成格式化的 E2E 测试报告（markdown）。
+ *
+ * 用法:
+ *   node generate-report.mjs --results <json> -o report.md
+ *   node generate-report.mjs --help
+ */
+
+import { writeFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+
+// ── Pure functions ────────────────────────────────────────────────
+
+/**
+ * 生成 markdown 格式的测试报告
+ * @param {object} data
+ * @param {string} data.fileName - .flow.md 文件名
+ * @param {string} data.timestamp - 执行时间
+ * @param {string} data.env - 目标环境名
+ * @param {string} data.envUrl - 环境 URL
+ * @param {string} data.mode - 执行模式
+ * @param {Array} data.flows - [{ id, title, steps: [{n,op,vf,result}] }]
+ * @param {number} data.passed - 通过步骤数
+ * @param {number} data.failed - 失败步骤数
+ * @param {number} data.skipped - 跳过的步骤数
+ * @returns {string} markdown 报告内容
+ */
+export function generateReport(data) {
+  const total = data.passed + data.failed + data.skipped;
+  const passRate = total > 0
+    ? Math.round((data.passed / total) * 100) : 0;
+
+  const lines = [];
+  lines.push('# 测试执行报告\n');
+  lines.push(`**文件：** ${data.fileName}`);
+  lines.push(`**执行时间：** ${data.timestamp}`);
+  lines.push(`**目标环境：** ${data.env} (${data.envUrl || '-'})`);
+  lines.push(`**执行模式：** ${data.mode}\n`);
+  lines.push('---\n');
+
+  for (const flow of data.flows) {
+    const status = flow.failed > 0 ? 'X' : 'OK';
+    lines.push(`## Flow: ${flow.id} - ${flow.title} ${status}\n`);
+    lines.push('| 步骤 | 操作 | 验证 | 结果 |');
+    lines.push('|------|------|------|------|');
+
+    for (const step of flow.steps) {
+      let resultStr = '';
+      if (step.result === 'skip') resultStr = '>';
+      else if (step.result === 'pass') resultStr = 'OK';
+      else if (step.result === 'fail') resultStr = 'X';
+      else resultStr = step.result || '-';
+
+      lines.push(`| ${step.n} | ${step.op} | ${step.vf} | ${resultStr} |`);
+    }
+    lines.push('');
+  }
+
+  lines.push('---\n');
+  lines.push('## 汇总\n');
+  lines.push('| 项目 | 值 |');
+  lines.push('|------|-----|');
+  lines.push(`| 总 Flows 数 | ${data.flows.length} |`);
+  lines.push(`| 总步骤数 | ${total} |`);
+  lines.push(`| 通过 | ${data.passed} |`);
+  lines.push(`| 失败 | ${data.failed} |`);
+  lines.push(`| 跳过 | ${data.skipped} |`);
+  lines.push(`| 通过率 | ${passRate}% |\n`);
+
+  return lines.join('\n');
+}
+
+// ── CLI entry ─────────────────────────────────────────────────────
+
+if (import.meta.filename === process.argv[1]) {
+  if (process.argv.includes('--help') || process.argv.includes('-h')) {
+    console.log(`
+generate-report.mjs — 生成测试报告
+
+用法:
+  node generate-report.mjs --results <json> -o report.md
+  node generate-report.mjs --help
+`);
+    process.exit(0);
+  }
+
+  const resultsIdx = process.argv.indexOf('--results');
+  const outIdx = process.argv.indexOf('-o');
+
+  if (resultsIdx < 0) {
+    console.error('--results 必填');
+    process.exit(1);
+  }
+
+  const resultsJson = process.argv[resultsIdx + 1];
+  let data;
+  try {
+    data = JSON.parse(resultsJson);
+  } catch {
+    console.error('--results 值不是有效 JSON');
+    process.exit(1);
+  }
+
+  const report = generateReport(data);
+
+  if (outIdx >= 0) {
+    const outPath = resolve(process.cwd(), process.argv[outIdx + 1]);
+    writeFileSync(outPath, report, 'utf8');
+    console.log(JSON.stringify({ written: true, path: outPath }));
+  } else {
+    process.stdout.write(report + '\n');
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deepstorm/cli",
-  "version": "0.9.2",
+  "version": "0.9.3",
   "description": "DeepStorm CLI — 一键配置项目开发环境",
   "license": "MIT",
   "author": "billkang",
@@ -16,7 +16,7 @@
     "dotenv": "^17.4.2",
     "handlebars": "^4.7.8",
     "js-yaml": "^4.1.0",
-    "@deepstorm/pilot": "^0.9.2"
+    "@deepstorm/pilot": "^0.9.3"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",