@wwkit/harness 1.0.27 → 1.0.29

package/skills/jstest/references/src/jstest-sample/OrderService.js

@@ -0,0 +1,98 @@
+export class OrderService {
+
+  static TRANSITIONS = {
+    'created': ['paid', 'cancelled'],
+    'paid': ['shipped', 'refunded'],
+    'shipped': ['delivered', 'returned'],
+    'delivered': ['returned'],
+    'cancelled': [],
+    'refunded': [],
+    'returned': []
+  }
+
+  constructor(baseUrl = 'https://api.example.com') {
+    this.baseUrl = baseUrl
+  }
+
+  _getDiscount(amount) {
+    if (amount > 1000) {
+      return 0.10
+    } else if (amount > 500) {
+      return 0.05
+    } else if (amount > 100) {
+      return 0.03
+    }
+    return 0.0
+  }
+
+  _getTax(amount) {
+    if (amount > 500) {
+      return 0.08
+    } else if (amount > 100) {
+      return 0.05
+    }
+    return 0.0
+  }
+
+  async createOrder(userId, items) {
+    const total = items.reduce((sum, item) => sum + (item.price || 0) * (item.quantity || 1), 0)
+    const discount = this._getDiscount(total)
+    const tax = this._getTax(total)
+    const discounted = total * (1 - discount)
+    const taxed = discounted * (1 + tax)
+    const response = await fetch(`${this.baseUrl}/orders`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({
+        user_id: userId,
+        items,
+        total: Math.round(taxed * 100) / 100,
+        status: 'created',
+        created_at: new Date().toISOString()
+      })
+    })
+    return response.json()
+  }
+
+  async updateStatus(orderId, newStatus) {
+    const response = await fetch(`${this.baseUrl}/orders/${orderId}`)
+    const order = await response.json()
+    const currentStatus = order.status
+    const allowed = OrderService.TRANSITIONS[currentStatus] || []
+    if (!allowed.includes(newStatus)) {
+      throw new Error(`Cannot transition from ${currentStatus} to ${newStatus}`)
+    }
+    const patchResponse = await fetch(`${this.baseUrl}/orders/${orderId}`, {
+      method: 'PATCH',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ status: newStatus })
+    })
+    return patchResponse.json()
+  }
+
+  async getOrder(orderId) {
+    const response = await fetch(`${this.baseUrl}/orders/${orderId}`)
+    if (response.status === 404) {
+      return null
+    }
+    return response.json()
+  }
+
+  async cancelOrder(orderId) {
+    return this.updateStatus(orderId, 'cancelled')
+  }
+
+  async listOrders(userId) {
+    const response = await fetch(`${this.baseUrl}/orders?user_id=${userId}`)
+    return response.json()
+  }
+
+  calculateTotal(items) {
+    const total = items.reduce((sum, item) => sum + (item.price || 0) * (item.quantity || 1), 0)
+    const discount = this._getDiscount(total)
+    const tax = this._getTax(total)
+    const discounted = total * (1 - discount)
+    const taxed = discounted * (1 + tax)
+    return Math.round(taxed * 100) / 100
+  }
+}

package/skills/jstest/references/src/jstest-sample/TokenGenerator.js

@@ -0,0 +1,60 @@
+import crypto from 'crypto'
+
+export class TokenGenerator {
+
+  static generateToken(length = 32) {
+    const chars = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789'
+    let result = ''
+    for (let i = 0; i < length; i++) {
+      result += chars[Math.floor(Math.random() * chars.length)]
+    }
+    return result
+  }
+
+  static generateTokenWithTimestamp(length = 16) {
+    const timestamp = String(Date.now() / 1000)
+    const chars = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789'
+    let randomPart = ''
+    for (let i = 0; i < length; i++) {
+      randomPart += chars[Math.floor(Math.random() * chars.length)]
+    }
+    return `${timestamp}${randomPart}`
+  }
+
+  static generateUuidLike() {
+    const chars = '0123456789abcdef'
+    let randomPart = ''
+    for (let i = 0; i < 32; i++) {
+      randomPart += chars[Math.floor(Math.random() * chars.length)]
+    }
+    const parts = [
+      randomPart.slice(0, 8),
+      randomPart.slice(8, 12),
+      randomPart.slice(12, 16),
+      randomPart.slice(16, 20),
+      randomPart.slice(20, 31)
+    ]
+    return parts.join('-')
+  }
+
+  static generateHash(data, algorithm = 'sha256') {
+    if (typeof data === 'string') {
+      data = Buffer.from(data, 'utf-8')
+    }
+    const hasher = crypto.createHash(algorithm)
+    hasher.update(data)
+    return hasher.digest('hex')
+  }
+
+  static generateBatch(count, length = 32) {
+    const tokens = []
+    for (let i = 0; i < count; i++) {
+      tokens.push(TokenGenerator.generateToken(length))
+    }
+    return tokens
+  }
+
+  static validateTokenLength(token, expectedLength) {
+    return token.length === expectedLength
+  }
+}

package/skills/jstest/references/src/jstest-sample/UserService.js

@@ -0,0 +1,56 @@
+export class UserService {
+
+  constructor(baseUrl = 'https://api.example.com') {
+    this.baseUrl = baseUrl
+  }
+
+  validateEmail(email) {
+    const pattern = /^[\w.+-]+@[\w-]+\.[\w.]{2}$/
+    return pattern.test(email)
+  }
+
+  async createUser(username, email) {
+    if (!username) {
+      throw new Error('Username is required')
+    }
+    if (!this.validateEmail(email)) {
+      throw new Error('Invalid email format')
+    }
+    const response = await fetch(`${this.baseUrl}/users`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ username, email })
+    })
+    return response.json()
+  }
+
+  async getUser(userId) {
+    const response = await fetch(`${this.baseUrl}/users/${userId}`)
+    if (response.status === 404) {
+      return null
+    }
+    return response.json()
+  }
+
+  async updateLastLogin(userId) {
+    const now = new Date()
+    const response = await fetch(`${this.baseUrl}/users/${userId}`, {
+      method: 'PATCH',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ last_login: now.toISOString() })
+    })
+    return response.json()
+  }
+
+  async searchUsers(query) {
+    const response = await fetch(`${this.baseUrl}/users?q=${encodeURIComponent(query)}`)
+    return response.json()
+  }
+
+  async deleteUser(userId) {
+    const response = await fetch(`${this.baseUrl}/users/${userId}`, {
+      method: 'DELETE'
+    })
+    return response.status === 204
+  }
+}

package/skills/jstest/references/src/jstest-sample/index.js

@@ -0,0 +1,6 @@
+export { Calculator } from './Calculator.js'
+export { UserService } from './UserService.js'
+export { FileProcessor } from './FileProcessor.js'
+export { TokenGenerator } from './TokenGenerator.js'
+export { ConfigManager } from './ConfigManager.js'
+export { OrderService } from './OrderService.js'

package/skills/jstest/references/suitability-check.md

@@ -0,0 +1,232 @@
+> **原 skill**: `jstest-suitability-check`（已合并入 jstest）
+> **适用**: 测试代理的适用性评估阶段，在创建用例前过滤不适合的模块。
+> **不适用**: 非 JS/TS 项目、非测试类型判断。
+
+---
+
+# 模块适用性评估
+
+## 工作流模式
+
+本 Skill 采用 **顺序执行** 工作流：
+
+1. **递归扫描**：遍历包目录及子目录下所有 .js/.ts 文件
+2. **模块提取**：从每个文件中提取导出的类、函数和常量
+3. **分类判定**：按信号规则对每个模块分类
+4. **适用性过滤**：根据 test_type 判断每个模块是否适合
+5. **输出清单**：返回可测试模块清单
+
+## 输入
+
+| 参数 | 必填 | 类型 | 说明 |
+|------|------|------|------|
+| target | 是 | string | 源码包目录路径 |
+| test_type | 是 | string | 测试类型：`unit` 或 `integration`（也接受 `ut`/`it` 简写，内部归一化） |
+
+## 输出
+
+- 可测试模块清单（文件路径 + 模块名 + 分类）
+- 不适合的模块清单（文件路径 + 模块名 + 分类 + 原因）
+- 如果可测试清单为空，agent 应终止流程
+
+---
+
+## 阶段一：递归扫描
+
+**操作**：递归遍历 target 目录及所有子目录
+
+1. 遍历 target 目录，收集所有 .js/.ts 文件
+2. 排除以下文件：
+   - `index.js` / `index.ts`（入口文件，通常仅 re-export）
+   - `*.test.js` / `*.test.ts`（已有测试文件）
+   - `*.spec.js` / `*.spec.ts`（已有测试文件）
+   - `*.config.js` / `*.config.ts`（配置文件）
+   - `*.setup.js` / `*.setup.ts`（setup 文件）
+3. 记录每个文件的相对路径（相对于 target）
+
+**决策**：
+
+| 条件 | 动作 |
+|------|------|
+| 找到 .js/.ts 文件 | 进入阶段二 |
+| 未找到 .js/.ts 文件 | 返回空清单 |
+
+---
+
+## 阶段二：模块提取
+
+**操作**：从每个 .js/.ts 文件中提取导出的类、函数和常量
+
+1. 读取文件内容
+2. 提取所有 `export class Name` 定义
+3. 提取所有 `export function name` 定义
+4. 提取所有 `export const name` 定义（箭头函数形式）
+5. 提取所有 `module.exports = { ... }` 定义（CommonJS）
+6. 对每个导出提取：
+   - 模块名（类名/函数名/常量名）
+   - 导出类型（class / function / const / module.exports）
+   - 装饰器/注解（TypeScript 装饰器、JSDoc 标签等）
+   - import/require 语句（文件级，共享给同文件模块）
+   - 方法列表及方法体（对 class）
+7. 对无导出的文件（仅副作用执行），跳过
+
+**决策**：
+
+| 条件 | 动作 |
+|------|------|
+| 文件有 `export class` 定义 | 逐个类进入阶段三 |
+| 文件有 `export function`/`export const` | 作为模块级单元进入阶段三 |
+| 文件有 `module.exports` | 作为模块级单元进入阶段三 |
+| 文件为空或仅含 import/require | 跳过 |
+| 文件无导出（仅副作用） | 跳过 |
+
+---
+
+## 阶段三：分类判定
+
+**操作**：按信号规则对每个类（或模块级函数单元）分类
+
+### 分类规则
+
+| 模块类型 | 适合 UT | 适合 IT | 说明 |
+|---------|---------|---------|------|
+| Pure Utility | ✅ | ❌ | 纯函数，无外部依赖，无副作用 |
+| Data Model | ✅ | ❌ | 数据容器，无业务逻辑 |
+| Service Class | ✅ | ✅ | 有 DB/HTTP/文件 I/O 操作 |
+| Integration Point | ✅ | ✅ | 编排多个 Service 调用 |
+| External Adapter | ✅ | ⚠️ | 封装外部 API/SDK，需测试环境 |
+
+### 信号采集
+
+#### 1. import/require 分析
+
+| import/require 内容 | 指向分类 |
+|---------------------|---------|
+| 仅 Node.js 内置（path, fs, url, crypto, util） | Pure Utility |
+| fetch, axios, http, https | Service Class (HTTP) |
+| mongoose, sequelize, pg, mysql2, prisma | Service Class (DB) |
+| fs, path, fs/promises 中的文件操作 | Service Class (文件) |
+| 内部 service 模块（相对路径 import） | Integration Point |
+| 外部 SDK（aws-sdk, googleapis, @octokit 等） | External Adapter |
+
+#### 2. 方法体分析
+
+| 方法体特征 | 指向分类 |
+|-----------|---------|
+| 无外部调用、无副作用、纯计算 | Pure Utility |
+| 含 `fetch()`/`axios.get()`/`db.query()` | Service Class |
+| 调用多个其他 Service 的方法 | Integration Point |
+| 封装外部 SDK 调用 | External Adapter |
+| 仅 getter/setter/属性定义 | Data Model |
+
+#### 3. 模块结构分析
+
+| 模块结构特征 | 指向分类 |
+|-----------|---------|
+| 仅含类型定义（interface/type） | Data Model |
+| 构造函数接收 config/依赖注入 | Service Class |
+| 抽象类且仅含抽象方法 | 跳过（无可测实现） |
+| 仅含 `export const` 常量定义 | 跳过（无可测逻辑） |
+| `process.env` 读取 | Service Class (环境变量) |
+
+### 分类优先级
+
+当一个模块有多个信号时，按优先级判定：
+
+1. Integration Point > Service Class > External Adapter > Pure Utility > Data Model
+2. 即：如果一个模块既调用 DB 又编排多个 Service，归类为 Integration Point
+
+---
+
+## 阶段四：适用性过滤
+
+**操作**：根据 test_type 过滤
+
+### test_type = unit / ut
+
+UT 对所有有逻辑的模块都适合，不过滤，返回全部模块。
+
+| 模块类型 | 是否返回 | 说明 |
+|---------|---------|------|
+| Pure Utility | ✅ | 纯函数逻辑测试 |
+| Data Model | ✅ | 验证逻辑、计算属性测试 |
+| Service Class | ✅ | Mock 依赖，测业务逻辑 |
+| Integration Point | ✅ | Mock 子 Service，测编排逻辑 |
+| External Adapter | ✅ | Mock 外部 API，测适配逻辑 |
+
+### test_type = integration / it
+
+IT 仅适合有外部依赖可集成的模块。
+
+| 模块类型 | 是否返回 | 原因 |
+|---------|---------|------|
+| Pure Utility | ❌ | 无外部依赖，IT = UT，无意义 |
+| Data Model | ❌ | 无交互可测，IT 无意义 |
+| Service Class | ✅ | 真实连接 DB/HTTP 测试 |
+| Integration Point | ✅ | 多 Service 真实编排测试 |
+| External Adapter | ✅ | 真实调用外部 API（需测试环境） |
+
+---
+
+## 阶段五：输出清单
+
+**输出格式**：
+
+```
+## 模块适用性评估
+
+### 可测试模块清单
+| 文件路径 | 模块名 | 分类 |
+|---------|--------|------|
+| src/services/UserService.js | UserService | Service Class |
+| src/services/OrderService.js | OrderService | Integration Point |
+
+### 不适合的模块
+| 文件路径 | 模块名 | 分类 | 原因 |
+|---------|--------|------|------|
+| src/utils/stringUtils.js | stringUtils | Pure Utility | 纯函数无外部依赖，IT 无意义 |
+| src/models/User.js | User | Data Model | 数据容器，IT 无意义 |
+
+### 结论
+- 适合的模块: X 个
+- 不适合的模块: Y 个
+- 可测试清单: [文件路径列表]
+```
+
+---
+
+## 决策
+
+| 条件 | 动作 |
+|------|------|
+| 可测试清单非空 | 返回清单给 agent，agent 继续后续步骤 |
+| 可测试清单为空 | 返回空清单，agent 终止流程 |
+
+## 失败处理
+
+| 场景 | 处理方式 |
+|------|---------|
+| target 路径不存在 | 返回空清单，提示路径无效 |
+| target 不是目录 | 返回空清单，提示需要目录路径 |
+| .js/.ts 文件语法错误 | 跳过该文件，记录警告 |
+| 无法判定分类 | 默认归类为 Service Class（保守策略） |
+
+## 一定要做
+
+1. 必须递归扫描所有子目录
+2. 必须逐个模块分类，不按文件整体判断
+3. 必须排除 index.js、*.test.js、*.spec.js、*.config.js、*.setup.js
+4. 必须对纯函数文件做模块级评估
+5. unit 类型必须返回全部模块（不过滤）
+6. integration 类型必须过滤掉 Pure Utility 和 Data Model
+7. 必须输出不适合的模块及原因
+8. 无法判定时必须保守归类为 Service Class
+
+## 一定不要做
+
+1. 不要修改源码文件
+2. 不要跳过子目录
+3. 不要按文件/模块整体判断（必须逐个导出）
+4. 不要对 ut 类型做过滤
+5. 不要将空文件或纯类型定义文件纳入清单
+6. 不要主观臆断分类，必须基于信号规则