@deepstorm/cli 0.11.0 → 0.11.1

package/dist/skills/sweep-run/scripts/flow-parser.mjs

@@ -62,7 +62,10 @@ function parseScenarios(content) {
   let inBody = false;
   for (const line of lines) {
     // Skip header and separator
-    if (/^\|[-]+\|/.test(line) && line.includes('---')) { inBody = true; continue; }
+    if (/^\|[-]+\|/.test(line) && line.includes('---')) {
+      inBody = true;
+      continue;
+    }
     if (!inBody) continue;
 
     const m = line.match(SCENARIO_ROW_RE);
@@ -172,9 +175,7 @@ function parseFlows(content) {
 
     // Get content between this flow heading and the next, or end of file
     const startIdx = heading.index + heading[0].length;
-    const endIdx = i + 1 < flowHeadings.length
-      ? flowHeadings[i + 1].index
-      : content.length;
+    const endIdx = i + 1 < flowHeadings.length ? flowHeadings[i + 1].index : content.length;
     const flowContent = content.slice(startIdx, endIdx);
 
     const preconditionsMatch = flowContent.match(PRECONDITIONS_RE);
@@ -186,8 +187,8 @@ function parseFlows(content) {
     if (preconditionsMatch) {
       const precondLines = preconditionsMatch[1]
         .split('\n')
-        .map(l => l.replace(/^-\s*/, '').trim())
-        .filter(l => l.length > 0);
+        .map((l) => l.replace(/^-\s*/, '').trim())
+        .filter((l) => l.length > 0);
       flow.preconditions = precondLines.join('\n');
     }
 

package/dist/skills/sweep-run/scripts/flow-selector.mjs

@@ -41,11 +41,7 @@ async function getCheckbox() {
 // ── TTY detection ───────────────────────────────────────────────────
 
 function isTtyAvailable() {
-  return Boolean(
-    process.stdout.isTTY &&
-    process.stdin.isTTY &&
-    process.stdin.setRawMode
-  );
+  return Boolean(process.stdout.isTTY && process.stdin.isTTY && process.stdin.setRawMode);
 }
 
 // ── YAML 解析（轻量，不依赖 yaml 包） ──────────────────────────
@@ -98,14 +94,10 @@ function resolveFlowFile(modulePath, baseFlowsDir) {
 
   const parts = modulePath.split('/');
   const leafName = parts[parts.length - 1];
-  const parentDir = parts.length > 1
-    ? join(baseFlowsDir, parts.slice(0, -1).join('/'))
-    : baseFlowsDir;
+  const parentDir = parts.length > 1 ? join(baseFlowsDir, parts.slice(0, -1).join('/')) : baseFlowsDir;
   if (existsSync(parentDir)) {
     const files = readdirSync(parentDir);
-    const found = files.find(
-      (f) => f.endsWith('.flow.md') && f.toLowerCase().includes(leafName.toLowerCase())
-    );
+    const found = files.find((f) => f.endsWith('.flow.md') && f.toLowerCase().includes(leafName.toLowerCase()));
     if (found) return join(parentDir, found);
   }
 
@@ -442,10 +434,7 @@ async function main() {
       }
     }
 
-    choices = [
-      { name: '📋 全部执行', value: '__all__' },
-      ...choices,
-    ];
+    choices = [{ name: '📋 全部执行', value: '__all__' }, ...choices];
 
     // ── Decide mode: text vs checkbox ──────────────────────
 

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

@@ -30,8 +30,7 @@ import { resolve } from 'node:path';
  */
 export function generateReport(data) {
   const total = data.passed + data.failed + data.skipped;
-  const passRate = total > 0
-    ? Math.round((data.passed / total) * 100) : 0;
+  const passRate = total > 0 ? Math.round((data.passed / total) * 100) : 0;
 
   const lines = [];
   lines.push('# 测试执行报告\n');

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

@@ -13,6 +13,10 @@
  *   node mcp-manager.mjs --status [--port 54321]
  *   node mcp-manager.mjs --stop [--port 54321]
  *   import { ensureMcp, stopMcp, getStatus } from './mcp-manager.mjs'
+ *
+ * Cross-platform note:
+ *   所有系统调用均兼容 macOS / Linux / Windows。
+ *   使用 Node.js 内置 API 替代 lsof / ps / sleep / SIGKILL 等 Unix-only 命令。
  */
 
 import { execSync, spawn } from 'node:child_process';
@@ -20,16 +24,39 @@ import { execSync, spawn } from 'node:child_process';
 const DEFAULT_PORT = 54321;
 const MCP_PACKAGE = '@playwright/mcp';
 
-// ── Process helpers ────────────────────────────────────────────────
+// ── Cross-platform helpers ─────────────────────────────────────────
 
 /**
- * Find PID of process listening on a given TCP port.
- * Returns null if nothing is listening.
+ * 跨平台同步 sleep — 使用 Atomics.wait 实现，不依赖 shell sleep 命令。
+ * @param {number} ms
+ */
+function sleepSync(ms) {
+  Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
+}
+
+// ── Cross-platform process helpers ──────────────────────────────────
+
+/**
+ * 跨平台查找监听指定 TCP 端口的进程 PID。
+ *
+ * - macOS/Linux: lsof -ti tcp:<port>
+ * - Windows: netstat -ano | findstr LISTENING
+ *
+ * @param {number} port
+ * @returns {number|null}
  */
 export function findPidByPort(port) {
+  if (process.platform === 'win32') {
+    return findPidByPortWin(port);
+  }
+  return findPidByPortUnix(port);
+}
+
+function findPidByPortUnix(port) {
   try {
-    const stdout = execSync(`lsof -ti tcp:${port} 2>/dev/null`, {
+    const stdout = execSync(`lsof -ti tcp:${port}`, {
       encoding: 'utf-8',
+      stdio: ['pipe', 'pipe', 'ignore'],
       timeout: 3000,
     }).trim();
     return stdout ? parseInt(stdout.split('\n')[0], 10) : null;
@@ -38,13 +65,47 @@ export function findPidByPort(port) {
   }
 }
 
+function findPidByPortWin(port) {
+  try {
+    const stdout = execSync(`netstat -ano | findstr "LISTENING" | findstr ":${port} "`, {
+      encoding: 'utf-8',
+      stdio: ['pipe', 'pipe', 'ignore'],
+      timeout: 5000,
+    }).trim();
+    // netstat output: TCP    0.0.0.0:8080    0.0.0.0:0    LISTENING    12345
+    const lines = stdout.split('\n');
+    for (const line of lines) {
+      const parts = line.trim().split(/\s+/);
+      const pid = parseInt(parts[parts.length - 1], 10);
+      if (Number.isFinite(pid)) return pid;
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+
 /**
- * Get the command line of a process by PID.
+ * 跨平台获取进程命令行。
+ *
+ * - macOS/Linux: ps -p <pid> -o args=
+ * - Windows: wmic process where processid=<pid> get commandline
+ *
+ * @param {number} pid
+ * @returns {string}
  */
 export function getProcessCommand(pid) {
+  if (process.platform === 'win32') {
+    return getProcessCommandWin(pid);
+  }
+  return getProcessCommandUnix(pid);
+}
+
+function getProcessCommandUnix(pid) {
   try {
-    return execSync(`ps -p ${pid} -o args= 2>/dev/null`, {
+    return execSync(`ps -p ${pid} -o args=`, {
       encoding: 'utf-8',
+      stdio: ['pipe', 'pipe', 'ignore'],
       timeout: 3000,
     }).trim();
   } catch {
@@ -52,6 +113,20 @@ export function getProcessCommand(pid) {
   }
 }
 
+function getProcessCommandWin(pid) {
+  try {
+    const stdout = execSync(`wmic process where processid=${pid} get commandline`, {
+      encoding: 'utf-8',
+      stdio: ['pipe', 'pipe', 'ignore'],
+      timeout: 5000,
+    }).trim();
+    const lines = stdout.split('\n').filter(Boolean);
+    return lines.length >= 2 ? lines[1].trim() : '';
+  } catch {
+    return '';
+  }
+}
+
 /**
  * Check if a process command indicates headless mode.
  */
@@ -60,12 +135,17 @@ export function isHeadless(cmd) {
 }
 
 /**
- * Kill a process by PID with escalation (SIGTERM -> SIGKILL).
+ * 跨平台终止进程。
+ *
+ * - macOS/Linux: SIGTERM → wait → SIGKILL (force)
+ * - Windows: process.kill SIGTERM → taskkill /F (force fallback)
+ *
+ * @param {number} pid
  */
 export function killProcess(pid) {
   try {
     process.kill(pid, 'SIGTERM');
-    // Wait briefly for graceful shutdown
+    // Wait briefly for graceful shutdown — polling with setTimeout
     const start = Date.now();
     while (Date.now() - start < 2000) {
       try {
@@ -73,10 +153,23 @@ export function killProcess(pid) {
       } catch {
         return; // process is gone
       }
-      execSync('sleep 0.2', { timeout: 1000 });
+      // Busy-wait with micro-pause to avoid CPU spin
+      const pollStart = Date.now();
+      while (Date.now() - pollStart < 50) {
+        /* yield */
+      }
     }
     // Force kill
-    process.kill(pid, 'SIGKILL');
+    if (process.platform === 'win32') {
+      // Windows: SIGKILL unsupported, use taskkill /F
+      try {
+        execSync(`taskkill /F /PID ${pid}`, { stdio: 'ignore', timeout: 5000 });
+      } catch {
+        // already dead
+      }
+    } else {
+      process.kill(pid, 'SIGKILL');
+    }
   } catch {
     // already dead
   }
@@ -142,7 +235,7 @@ export function ensureMcp(options = {}) {
     }
     // Running in wrong mode -- restart
     stopMcp(port);
-    execSync('sleep 1', { timeout: 2000 });
+    sleepSync(1000);
   }
 
   // Start MCP
@@ -161,7 +254,7 @@ export function ensureMcp(options = {}) {
   const deadline = Date.now() + 10000;
   let startedPid = null;
   while (Date.now() < deadline) {
-    execSync('sleep 0.3', { timeout: 1000 });
+    sleep(300);
     const found = findPidByPort(port);
     if (found) {
       startedPid = found;
@@ -181,8 +274,8 @@ export function ensureMcp(options = {}) {
 
 if (process.argv[1] === import.meta.filename) {
   const args = process.argv.slice(2);
-  const modeFlag = args.find(a => a.startsWith('--mode='));
-  const portFlag = args.find(a => a.startsWith('--port='));
+  const modeFlag = args.find((a) => a.startsWith('--mode='));
+  const portFlag = args.find((a) => a.startsWith('--port='));
   const mode = modeFlag ? modeFlag.split('=')[1] : 'headless';
   const port = portFlag ? parseInt(portFlag.split('=')[1], 10) : DEFAULT_PORT;
 

package/dist/skills/sweep-run/scripts/spec-compiler.mjs

@@ -24,7 +24,7 @@ function inferAction(description, index) {
   // Navigation
   if (/导航|打开|goto/i.test(desc)) {
     const urlMatch = desc.match(/`([^`]+)`/);
-    const url = urlMatch ? urlMatch[1] : 'process.env.BASE_URL || \'/\'';
+    const url = urlMatch ? urlMatch[1] : "process.env.BASE_URL || '/'";
     return {
       comment: desc,
       action: 'page.goto',
@@ -48,7 +48,9 @@ function inferAction(description, index) {
     const valueMatch = desc.match(/`([^`]+)`/);
     const value = valueMatch ? valueMatch[1] : '';
     const targetMatch = desc.match(/[""「」](.+?)[""」』]/);
-    const selector = targetMatch ? `[placeholder="${targetMatch[1]}" i]` : `input${index > 0 ? `:nth-child(${index})` : ''}`;
+    const selector = targetMatch
+      ? `[placeholder="${targetMatch[1]}" i]`
+      : `input${index > 0 ? `:nth-child(${index})` : ''}`;
     return {
       comment: desc,
       action: 'page.fill',
@@ -155,7 +157,9 @@ export function compile(parsed) {
   lines.push('');
 
   for (const flow of parsed.flows) {
-    lines.push(`${indent}test('${escapeStr(parsed.featureName)} - ${escapeStr(flow.id + ' - ' + flow.title)}', async ({ page }) => {`);
+    lines.push(
+      `${indent}test('${escapeStr(parsed.featureName)} - ${escapeStr(flow.id + ' - ' + flow.title)}', async ({ page }) => {`,
+    );
 
     // Preconditions as comments
     if (flow.preconditions) {
@@ -166,8 +170,8 @@ export function compile(parsed) {
     }
 
     // AI_REQUIRED marker — skip entire flow if any step needs AI
-    const hasAiRequired = flow.steps.some(s =>
-      s.description.includes('AI_REQUIRED') || s.description.includes('<!-- AI_REQUIRED -->')
+    const hasAiRequired = flow.steps.some(
+      (s) => s.description.includes('AI_REQUIRED') || s.description.includes('<!-- AI_REQUIRED -->'),
     );
     if (hasAiRequired) {
       lines.push(`${indent}${indent}// AI_REQUIRED — cannot execute natively, AI will handle`);
@@ -181,7 +185,7 @@ export function compile(parsed) {
 
       const action = inferAction(desc, step.order);
       if (action.action) {
-        const args = action.args.map(a => typeof a === 'string' ? `'${escapeStr(a)}'` : a).join(', ');
+        const args = action.args.map((a) => (typeof a === 'string' ? `'${escapeStr(a)}'` : a)).join(', ');
         lines.push(`${indent}${indent}await ${action.action}(${args});`);
       } else {
         // Cannot map to Playwright API — keep as TODO comment
@@ -196,11 +200,17 @@ export function compile(parsed) {
         if (va.assertion === 'toBeVisible') {
           lines.push(`${indent}${indent}await expect(page.locator('${escapeStr(va.args[0])}')).toBeVisible();`);
         } else if (va.assertion === 'toHaveText') {
-          lines.push(`${indent}${indent}await expect(page.locator('${escapeStr(va.args[0])}')).toHaveText('${escapeStr(va.args[1])}');`);
+          lines.push(
+            `${indent}${indent}await expect(page.locator('${escapeStr(va.args[0])}')).toHaveText('${escapeStr(va.args[1])}');`,
+          );
         } else if (va.assertion === 'toHaveTitle') {
-          lines.push(`${indent}${indent}await expect(page).toHaveTitle(${typeof va.args[0] === 'string' ? `'${escapeStr(va.args[0])}'` : va.args[0]});`);
+          lines.push(
+            `${indent}${indent}await expect(page).toHaveTitle(${typeof va.args[0] === 'string' ? `'${escapeStr(va.args[0])}'` : va.args[0]});`,
+          );
         } else if (va.assertion === 'toHaveURL') {
-          lines.push(`${indent}${indent}await expect(page).toHaveURL(${typeof va.args[0] === 'string' ? `'${escapeStr(va.args[0])}'` : va.args[0]});`);
+          lines.push(
+            `${indent}${indent}await expect(page).toHaveURL(${typeof va.args[0] === 'string' ? `'${escapeStr(va.args[0])}'` : va.args[0]});`,
+          );
         }
       }
 

package/dist/skills/tide-discuss/references/checklists.md

@@ -24,13 +24,13 @@
 
 ## 💼 analyst（必需）— 📊 业务分析师 Mary
 
-| # | 检查项 | 说明 |
-| -- | ------ | ---- |
-| 1 | 需求背景和业务目标 | 为什么做这个需求？业务层面要达成什么目标？ |
-| 2 | 目标用户画像 | 谁是目标用户？使用场景是什么？用户规模？ |
-| 3 | 核心痛点分析 | 当前有什么问题/痛点？用户反馈了什么？ |
-| 4 | 竞品和市场调研 | 竞品有类似功能吗？市场趋势如何？行业最佳实践？ |
-| 5 | 关键成功指标 | 怎么衡量需求上线后的效果？核心 KPI 是什么？ |
+| #   | 检查项             | 说明                                           |
+| --- | ------------------ | ---------------------------------------------- |
+| 1   | 需求背景和业务目标 | 为什么做这个需求？业务层面要达成什么目标？     |
+| 2   | 目标用户画像       | 谁是目标用户？使用场景是什么？用户规模？       |
+| 3   | 核心痛点分析       | 当前有什么问题/痛点？用户反馈了什么？          |
+| 4   | 竞品和市场调研     | 竞品有类似功能吗？市场趋势如何？行业最佳实践？ |
+| 5   | 关键成功指标       | 怎么衡量需求上线后的效果？核心 KPI 是什么？    |
 
 **完成标准：** 以上 5 项至少都提出了问题并收到用户反馈，不要仅凭 AI 自行补充。
 
@@ -38,13 +38,13 @@
 
 ## 📋 pm（必需）— 产品经理 John
 
-| # | 检查项 | 说明 |
-| -- | ------ | ---- |
-| 1 | MVP 功能范围 | 第一期做什么？边界在哪里？ |
-| 2 | 用户故事 | 从用户视角描述核心功能场景（格式：作为XXX，我想XXX，以便XXX） |
-| 3 | 优先级排序 | 功能点的优先级怎么排？Must have / Should have / Nice to have？ |
-| 4 | 验收标准 | 每个功能点的可验证完成标准 |
-| 5 | 边界与反例 | 明确不做什么、不做的情况，以及异常场景处理 |
+| #   | 检查项       | 说明                                                           |
+| --- | ------------ | -------------------------------------------------------------- |
+| 1   | MVP 功能范围 | 第一期做什么？边界在哪里？                                     |
+| 2   | 用户故事     | 从用户视角描述核心功能场景（格式：作为XXX，我想XXX，以便XXX）  |
+| 3   | 优先级排序   | 功能点的优先级怎么排？Must have / Should have / Nice to have？ |
+| 4   | 验收标准     | 每个功能点的可验证完成标准                                     |
+| 5   | 边界与反例   | 明确不做什么、不做的情况，以及异常场景处理                     |
 
 **完成标准：** 至少产出 3+ 条用户故事、2+ 条验收标准、明确的功能边界。
 
@@ -52,12 +52,12 @@
 
 ## 🏗️ architect（可选）— 架构师 Winston
 
-| # | 检查项 | 说明 |
-| -- | ------ | ---- |
-| 1 | 技术可行性 | 现有架构能否支撑？需要哪些新依赖或服务？ |
-| 2 | 系统影响 | 影响哪些已有模块？是否需要数据库变更？ |
-| 3 | 技术风险 | 性能瓶颈？安全风险？第三方依赖风险？ |
-| 4 | 架构建议 | 推荐的实现方案、技术选型、模块划分 |
+| #   | 检查项     | 说明                                     |
+| --- | ---------- | ---------------------------------------- |
+| 1   | 技术可行性 | 现有架构能否支撑？需要哪些新依赖或服务？ |
+| 2   | 系统影响   | 影响哪些已有模块？是否需要数据库变更？   |
+| 3   | 技术风险   | 性能瓶颈？安全风险？第三方依赖风险？     |
+| 4   | 架构建议   | 推荐的实现方案、技术选型、模块划分       |
 
 **完成标准：** 识别出主要技术风险和影响范围，给出架构决策建议。
 
@@ -65,12 +65,12 @@
 
 ## 🎨 designer（可选）— UX 设计师 Sally
 
-| # | 检查项 | 说明 |
-| -- | ------ | ---- |
-| 1 | 用户流程 | 用户完成功能的关键步骤和操作路径 |
-| 2 | 关键交互场景 | 核心界面交互，含正常流程和异常状态 |
-| 3 | UX 建议 | 交互细节、动效、文案、无障碍等建议 |
-| 4 | 设计约束 | 需要遵循的设计规范、组件库引用 |
+| #   | 检查项       | 说明                               |
+| --- | ------------ | ---------------------------------- |
+| 1   | 用户流程     | 用户完成功能的关键步骤和操作路径   |
+| 2   | 关键交互场景 | 核心界面交互，含正常流程和异常状态 |
+| 3   | UX 建议      | 交互细节、动效、文案、无障碍等建议 |
+| 4   | 设计约束     | 需要遵循的设计规范、组件库引用     |
 
 **完成标准：** 梳理出关键交互流程，给出至少 2 条 UX 改进建议。
 
@@ -78,11 +78,11 @@
 
 ## 👑 po（可选）— 产品负责人 Chris
 
-| # | 检查项 | 说明 |
-| -- | ------ | ---- |
-| 1 | 业务价值 | 这个需求对产品整体方向和商业目标的贡献 |
-| 2 | 投入产出评估 | 实现成本 vs 预期收益的权衡 |
-| 3 | 发布策略 | 发布方式（全量/灰度/内测）、时间窗口、回滚方案 |
-| 4 | 风险决策 | 是否值得做、什么时候做、与哪些需求并行 |
+| #   | 检查项       | 说明                                           |
+| --- | ------------ | ---------------------------------------------- |
+| 1   | 业务价值     | 这个需求对产品整体方向和商业目标的贡献         |
+| 2   | 投入产出评估 | 实现成本 vs 预期收益的权衡                     |
+| 3   | 发布策略     | 发布方式（全量/灰度/内测）、时间窗口、回滚方案 |
+| 4   | 风险决策     | 是否值得做、什么时候做、与哪些需求并行         |
 
 **完成标准：** 明确发布策略和优先级决策，给出明确的 Go/No-Go 建议。