@dommaker/harness 0.16.6 → 0.16.8

package/dist/tools/definitions/definitions/core/validation/validate-readme-stats.yml

@@ -1,155 +0,0 @@
-# validate-readme-stats.yml - README 统计一致性检查
-# ============================================================================
-# 能力类型: validation（工具型）
-# 执行方式: 纯脚本，检查统计数字
-# 用途: 验证 README 中的统计数据与实际文件数量一致
-# ============================================================================
-
-name: validate-readme-stats
-description: 检查 README 统计数据是否与实际文件数量一致
-category: validation
-version: 1.0.0
-
-# 铁律
-iron_law:
-  rule: "README STATS MUST REFLECT REALITY"
-  message: "README 中的统计数据必须与实际文件数量一致"
-
-# 输入
-input:
-  readme_path:
-    type: path
-    required: false
-    default: "README.md"
-    description: README 文件路径
-  
-  tools_dir:
-    type: path
-    required: false
-    default: "tools"
-    description: tools 目录路径
-  
-  steps_dir:
-    type: path
-    required: false
-    default: "steps"
-    description: steps 目录路径
-  
-  workflows_dir:
-    type: path
-    required: false
-    default: "workflows"
-    description: workflows 目录路径
-
-# 输出
-output:
-  actual_tools:
-    type: number
-    description: 实际 tools 数量
-  
-  actual_steps:
-    type: number
-    description: 实际 steps 数量
-  
-  actual_workflows:
-    type: number
-    description: 实际 workflows 数量
-  
-  readme_tools:
-    type: number
-    description: README 中记录的 tools 数量
-  
-  readme_steps:
-    type: number
-    description: README 中记录的 steps 数量
-  
-  readme_workflows:
-    type: number
-    description: README 中记录的 workflows 数量
-  
-  passed:
-    type: boolean
-    description: 是否全部一致
-
-# 执行脚本
-script: |
-  #!/bin/bash
-  set -euo pipefail
-  
-  README_PATH="{{readme_path}}"
-  TOOLS_DIR="{{tools_dir}}"
-  STEPS_DIR="{{steps_dir}}"
-  WORKFLOWS_DIR="{{workflows_dir}}"
-  
-  echo "🔍 检查 README 统计一致性"
-  echo "  README: $README_PATH"
-  echo ""
-  
-  # 计算实际数量
-  ACTUAL_TOOLS=$(find "$TOOLS_DIR" -name "*.yml" -o -name "*.yaml" 2>/dev/null | grep -v README | wc -l)
-  ACTUAL_STEPS=$(find "$STEPS_DIR" -name "*.yml" -o -name "*.yaml" 2>/dev/null | grep -v README | wc -l)
-  ACTUAL_WORKFLOWS=$(find "$WORKFLOWS_DIR" -name "*.yml" -o -name "*.yaml" 2>/dev/null | wc -l)
-  
-  echo "📊 实际统计:"
-  echo "  Tools: $ACTUAL_TOOLS"
-  echo "  Steps: $ACTUAL_STEPS"
-  echo "  Workflows: $ACTUAL_WORKFLOWS"
-  echo ""
-  
-  # 从 README 提取统计
-  # 格式: | **Tools** | 25 | ... |
-  README_TOOLS=$(grep -E "\*\*Tools\*\*" "$README_PATH" | grep -oE '\|[ ]*[0-9]+' | head -1 | grep -oE '[0-9]+' || echo "0")
-  README_STEPS=$(grep -E "\*\*Steps\*\*" "$README_PATH" | grep -oE '\|[ ]*[0-9]+' | head -1 | grep -oE '[0-9]+' || echo "0")
-  README_WORKFLOWS=$(grep -E "\*\*Workflows\*\*" "$README_PATH" | grep -oE '\|[ ]*[0-9]+' | head -1 | grep -oE '[0-9]+' || echo "0")
-  
-  echo "📝 README 统计:"
-  echo "  Tools: $README_TOOLS"
-  echo "  Steps: $README_STEPS"
-  echo "  Workflows: $README_WORKFLOWS"
-  echo ""
-  
-  # 对比
-  ERRORS=0
-  
-  echo "🔍 对比结果:"
-  
-  if [ "$ACTUAL_TOOLS" = "$README_TOOLS" ]; then
-    echo "  ✅ Tools: $ACTUAL_TOOLS = $README_TOOLS"
-  else
-    echo "  ❌ Tools: 实际=$ACTUAL_TOOLS, README=$README_TOOLS"
-    ERRORS=$((ERRORS + 1))
-  fi
-  
-  if [ "$ACTUAL_STEPS" = "$README_STEPS" ]; then
-    echo "  ✅ Steps: $ACTUAL_STEPS = $README_STEPS"
-  else
-    echo "  ❌ Steps: 实际=$ACTUAL_STEPS, README=$README_STEPS"
-    ERRORS=$((ERRORS + 1))
-  fi
-  
-  if [ "$ACTUAL_WORKFLOWS" = "$README_WORKFLOWS" ]; then
-    echo "  ✅ Workflows: $ACTUAL_WORKFLOWS = $README_WORKFLOWS"
-  else
-    echo "  ❌ Workflows: 实际=$ACTUAL_WORKFLOWS, README=$README_WORKFLOWS"
-    ERRORS=$((ERRORS + 1))
-  fi
-  
-  echo ""
-  
-  if [ $ERRORS -gt 0 ]; then
-    echo "================================"
-    echo "❌ 发现 $ERRORS 处不一致"
-    echo ""
-    echo "请更新 README.md 中的统计数据:"
-    echo ""
-    echo "| 层级 | 数量 |"
-    echo "|------|------|"
-    echo "| **Tools** | $ACTUAL_TOOLS |"
-    echo "| **Steps** | $ACTUAL_STEPS |"
-    echo "| **Workflows** | $ACTUAL_WORKFLOWS |"
-    echo "================================"
-    exit 1
-  fi
-  
-  echo "✅ README 统计数据与实际一致"
-  exit 0

package/dist/tools/definitions/definitions/core/validation/validate-yaml-syntax.yml

@@ -1,134 +0,0 @@
-# validate-yaml-syntax.yml - YAML 语法检查
-# ============================================================================
-# 能力类型: validation（工具型）
-# 执行方式: 纯脚本，检查 YAML 语法
-# 用途: 验证所有 YAML 文件语法正确
-# ============================================================================
-
-name: validate-yaml-syntax
-description: 检查所有 YAML 文件语法正确性
-category: validation
-version: 1.0.0
-
-# 铁律
-iron_law:
-  rule: "YAML MUST BE VALID"
-  message: "所有 YAML 文件必须通过语法检查"
-
-# 输入
-input:
-  search_dirs:
-    type: array
-    required: false
-    default: ["tools", "steps", "workflows"]
-    description: 要检查的目录列表
-  
-  exclude_patterns:
-    type: array
-    required: false
-    default: ["README"]
-    description: 排除的模式列表
-
-# 输出
-output:
-  total_files:
-    type: number
-    description: 检查的文件总数
-  
-  valid_files:
-    type: number
-    description: 有效的文件数量
-  
-  invalid_files:
-    type: array
-    description: 无效文件列表及错误
-  
-  passed:
-    type: boolean
-    description: 是否全部通过
-
-# 执行脚本
-script: |
-  #!/bin/bash
-  set -euo pipefail
-  
-  echo "🔍 检查 YAML 语法"
-  echo ""
-  
-  # 检查是否安装了 yamllint
-  if ! command -v yamllint &> /dev/null; then
-    echo "⚠️  yamllint 未安装，使用基础检查"
-    USE_YAMLLINT=false
-  else
-    USE_YAMLLINT=true
-  fi
-  
-  TOTAL=0
-  VALID=0
-  INVALID=()
-  
-  # 检查函数
-  check_yaml() {
-    local file="$1"
-    
-    if $USE_YAMLLINT; then
-      # 使用 yamllint
-      if yamllint -d "{extends: relaxed, rules: {line-length: disable}}" "$file" > /dev/null 2>&1; then
-        return 0
-      else
-        return 1
-      fi
-    else
-      # 使用 Python yaml 模块
-      if python3 -c "import yaml; yaml.safe_load(open('$file'))" 2>/dev/null; then
-        return 0
-      else
-        return 1
-      fi
-    fi
-  }
-  
-  # 遍历目录
-  for dir in tools steps workflows; do
-    if [ -d "$dir" ]; then
-      for f in $(find "$dir" -name "*.yml" -o -name "*.yaml" 2>/dev/null | grep -v README | sort); do
-        TOTAL=$((TOTAL + 1))
-        
-        if check_yaml "$f"; then
-          VALID=$((VALID + 1))
-          echo "  ✅ $f"
-        else
-          INVALID+=("$f")
-          echo "  ❌ $f"
-          # 显示错误详情
-          if $USE_YAMLLINT; then
-            yamllint -d "{extends: relaxed, rules: {line-length: disable}}" "$file" 2>&1 | head -5
-          else
-            python3 -c "import yaml; yaml.safe_load(open('$f'))" 2>&1 | head -3
-          fi
-          echo ""
-        fi
-      done
-    fi
-  done
-  
-  echo ""
-  echo "================================"
-  echo "📊 统计:"
-  echo "  总计: $TOTAL 个文件"
-  echo "  有效: $VALID 个"
-  echo "  无效: ${#INVALID[@]} 个"
-  echo "================================"
-  
-  if [ ${#INVALID[@]} -gt 0 ]; then
-    echo ""
-    echo "❌ 发现无效 YAML 文件:"
-    for f in "${INVALID[@]}"; do
-      echo "  - $f"
-    done
-    exit 1
-  fi
-  
-  echo ""
-  echo "✅ 所有 YAML 文件语法正确"
-  exit 0

package/dist/tools/definitions/definitions/ext/browser/browser-automate.sh

@@ -1,255 +0,0 @@
-#!/bin/bash
-# browser-automate.sh - 浏览器自动化测试脚本
-# 基于 agent-browser-stealth 实现（Puppeteer + 隐身增强）
-
-set -e
-
-# 参数解析
-ACTION="${1:-test}"
-URL="${2:-}"
-SCRIPT="${3:-}"
-OUTPUT_DIR="${4:-/tmp/browser-test-$(date +%s)}"
-SESSION_NAME="browser-test-$(date +%s)"
-HEADLESS="${HEADLESS:-true}"
-
-# 颜色输出
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-BLUE='\033[0;34m'
-NC='\033[0m'
-
-log_info() {
-  echo -e "${GREEN}[INFO]${NC} $1"
-}
-
-log_warn() {
-  echo -e "${YELLOW}[WARN]${NC} $1"
-}
-
-log_error() {
-  echo -e "${RED}[ERROR]${NC} $1"
-}
-
-log_debug() {
-  echo -e "${BLUE}[DEBUG]${NC} $1"
-}
-
-# 检查 agent-browser-stealth 是否安装
-check_abs() {
-  if ! command -v abs &> /dev/null; then
-    log_warn "agent-browser-stealth not found, installing..."
-    npm install -g agent-browser-stealth
-    abs install
-  fi
-}
-
-# 运行浏览器测试（使用 agent-browser-stealth）
-run_browser_test() {
-  local url="$1"
-  local actions="$2"
-  
-  log_info "Starting browser automation test (agent-browser-stealth)..."
-  log_info "URL: $url"
-  log_info "Session: $SESSION_NAME"
-  log_info "Output: $OUTPUT_DIR"
-  
-  mkdir -p "$OUTPUT_DIR"
-  
-  # 结果数组
-  declare -a RESULTS=()
-  
-  # 检查 abs 命令
-  check_abs
-  
-  # 1. 打开页面
-  log_info "Opening URL..."
-  if ! abs open "$url" --session-name "$SESSION_NAME" 2>&1 | tee -a "$OUTPUT_DIR/test.log"; then
-    log_error "Failed to open URL: $url"
-    RESULTS+=("{\"action\":\"navigate\",\"status\":\"failed\",\"url\":\"$url\"}")
-    echo "{\"results\":[$(IFS=,; echo "${RESULTS[*]}")],\"errors\":[\"Failed to open URL\"]}"
-    exit 1
-  fi
-  RESULTS+=("{\"action\":\"navigate\",\"status\":\"success\",\"url\":\"$url\"}")
-  
-  # 2. 等待页面加载
-  sleep 2
-  
-  # 3. 初始截图
-  abs screenshot "$OUTPUT_DIR/screenshot-initial.png" --session-name "$SESSION_NAME" 2>/dev/null || true
-  
-  # 4. 获取元素映射
-  log_info "Getting element snapshot..."
-  SNAPSHOT_OUTPUT=$(abs snapshot -i --session-name "$SESSION_NAME" 2>&1) || true
-  
-  # 保存 snapshot 输出供调试
-  echo "$SNAPSHOT_OUTPUT" > "$OUTPUT_DIR/snapshot.txt"
-  
-  # 5. 执行测试脚本
-  if [ -n "$actions" ] && [ "$actions" != "[]" ]; then
-    log_info "Executing test actions..."
-    
-    # 解析 JSON actions 并执行
-    echo "$actions" | jq -c '.[]' 2>/dev/null | while read -r action; do
-      action_type=$(echo "$action" | jq -r '.type')
-      selector=$(echo "$action" | jq -r '.selector // ""')
-      value=$(echo "$action" | jq -r '.value // ""')
-      delay=$(echo "$action" | jq -r '.delay // 500')
-      filename=$(echo "$action" | jq -r '.filename // "screenshot.png"')
-      should_exist=$(echo "$action" | jq -r '.shouldExist // true')
-      
-      log_debug "Action: $action_type, Selector: $selector"
-      
-      case "$action_type" in
-        click)
-          # 尝试使用 @ref 引用，否则直接使用 selector
-          if abs click "$selector" --session-name "$SESSION_NAME" 2>&1 | tee -a "$OUTPUT_DIR/test.log"; then
-            log_info "Click success: $selector"
-            sleep 0.5
-          else
-            log_warn "Click failed: $selector"
-          fi
-          ;;
-        
-        type)
-          if abs type "$selector" "$value" --session-name "$SESSION_NAME" 2>&1 | tee -a "$OUTPUT_DIR/test.log"; then
-            log_info "Type success: $selector"
-          else
-            log_warn "Type failed: $selector"
-          fi
-          ;;
-        
-        wait)
-          log_info "Waiting for: $selector"
-          sleep "${delay::-3}2"  # 转换为秒
-          ;;
-        
-        screenshot)
-          abs screenshot "$OUTPUT_DIR/$filename" --session-name "$SESSION_NAME" 2>&1 | tee -a "$OUTPUT_DIR/test.log" || true
-          log_info "Screenshot saved: $filename"
-          ;;
-        
-        assert)
-          # 使用 abs eval 检查元素是否存在
-          if abs eval "document.querySelector('$selector')" --session-name "$SESSION_NAME" 2>&1 | grep -q "null"; then
-            log_warn "Element not found: $selector"
-          else
-            log_info "Element found: $selector"
-          fi
-          ;;
-        
-        scroll)
-          abs eval "window.scrollBy(0, ${value:-500})" --session-name "$SESSION_NAME" 2>&1 | tee -a "$OUTPUT_DIR/test.log" || true
-          log_info "Scrolled: ${value:-500}px"
-          ;;
-        
-        *)
-          log_warn "Unknown action: $action_type"
-          ;;
-      esac
-    done
-  fi
-  
-  # 6. 最终截图
-  abs screenshot "$OUTPUT_DIR/screenshot-final.png" --full-page --session-name "$SESSION_NAME" 2>/dev/null || true
-  
-  # 7. 获取性能指标
-  METRICS=$(abs eval "JSON.stringify(performance.getEntriesByType('navigation')[0])" --session-name "$SESSION_NAME" 2>/dev/null || echo "{}")
-  echo "$METRICS" > "$OUTPUT_DIR/metrics.json"
-  
-  # 8. 关闭浏览器
-  abs close --session-name "$SESSION_NAME" 2>/dev/null || true
-  
-  # 9. 生成结果
-  log_info "Generating test results..."
-  
-  # 构建结果 JSON
-  cat > "$OUTPUT_DIR/test-results.json" << EOF
-{
-  "results": [
-    {"action": "navigate", "status": "success", "url": "$url"},
-    {"action": "session", "status": "success", "sessionName": "$SESSION_NAME"}
-  ],
-  "screenshots": [
-    "$OUTPUT_DIR/screenshot-initial.png",
-    "$OUTPUT_DIR/screenshot-final.png"
-  ],
-  "metrics": $METRICS,
-  "outputDir": "$OUTPUT_DIR"
-}
-EOF
-  
-  log_info "Test completed. Results:"
-  cat "$OUTPUT_DIR/test-results.json"
-}
-
-# 交互式测试模式
-run_interactive_test() {
-  local url="$1"
-  
-  log_info "Starting interactive browser session..."
-  log_info "URL: $url"
-  log_info "Session: $SESSION_NAME"
-  log_info ""
-  log_info "Commands:"
-  log_info "  abs snapshot -i           # Get interactive element references"
-  log_info "  abs click @e1             # Click element by reference"
-  log_info "  abs type @e1 'text'       # Type text"
-  log_info "  abs screenshot out.png    # Take screenshot"
-  log_info "  abs close                 # Close browser"
-  log_info ""
-  
-  check_abs
-  abs open "$url" --session-name "$SESSION_NAME"
-}
-
-# 示例测试脚本
-example_login_test() {
-  cat << 'EOF'
-[
-  {"type": "wait", "selector": "input[name='username']"},
-  {"type": "type", "selector": "input[name='username']", "value": "test@example.com"},
-  {"type": "type", "selector": "input[name='password']", "value": "password123"},
-  {"type": "click", "selector": "button[type='submit']"},
-  {"type": "wait", "selector": ".dashboard", "delay": 2000},
-  {"type": "screenshot", "filename": "dashboard.png"}
-]
-EOF
-}
-
-# 主函数
-main() {
-  case "$ACTION" in
-    test)
-      if [ -z "$URL" ]; then
-        log_error "URL is required for test action"
-        echo "Usage: $0 test <url> [script]"
-        echo "Example: $0 test https://example.com '$(example_login_test)'"
-        exit 1
-      fi
-      run_browser_test "$URL" "$SCRIPT"
-      ;;
-    
-    interactive)
-      if [ -z "$URL" ]; then
-        log_error "URL is required for interactive mode"
-        echo "Usage: $0 interactive <url>"
-        exit 1
-      fi
-      run_interactive_test "$URL"
-      ;;
-    
-    example)
-      echo "Example login test script:"
-      example_login_test
-      ;;
-    
-    *)
-      log_error "Unknown action: $ACTION"
-      echo "Actions: test, interactive, example"
-      exit 1
-      ;;
-  esac
-}
-
-main "$@"

package/dist/tools/definitions/definitions/ext/browser/browser-automate.yml

@@ -1,166 +0,0 @@
-# browser-automate.yml - 浏览器自动化测试能力
-name: browser-automate
-description: 基于 agent-browser-stealth 的浏览器自动化测试（Puppeteer + 隐身增强），支持反检测、会话保持、调试能力
-
-# 输入参数
-input:
-  url:
-    type: string
-    required: true
-    description: 要测试的页面 URL
-  
-  actions:
-    type: array
-    required: false
-    description: 测试动作列表
-    default: []
-    items:
-      type: object
-      properties:
-        type:
-          type: string
-          enum: [click, type, wait, screenshot, assert, scroll]
-          description: 动作类型
-        selector:
-          type: string
-          description: CSS 选择器
-        value:
-          type: string
-          description: 输入值（type 动作）
-        delay:
-          type: number
-          description: 延迟时间（毫秒）
-        filename:
-          type: string
-          description: 截图文件名
-        shouldExist:
-          type: boolean
-          description: 断言元素是否存在
-
-  headless:
-    type: boolean
-    required: false
-    default: true
-    description: 是否无头模式运行
-
-  timeout:
-    type: number
-    required: false
-    default: 30000
-    description: 页面加载超时时间（毫秒）
-
-# 输出
-output:
-  results:
-    type: array
-    description: 测试结果列表
-  
-  screenshots:
-    type: array
-    description: 截图文件路径列表
-  
-  metrics:
-    type: object
-    description: 页面性能指标
-  
-  errors:
-    type: array
-    description: 错误列表
-
-# 执行配置
-timeout: 300  # 秒
-agent: codex
-
-# 执行脚本
-handler: script
-script: ./browser-automate.sh
-
-# 示例用法
-examples:
-  - name: 登录测试
-    input:
-      url: https://example.com/login
-      actions:
-        - type: wait
-          selector: "input[name='username']"
-        - type: type
-          selector: "input[name='username']"
-          value: "test@example.com"
-        - type: type
-          selector: "input[name='password']"
-          value: "password123"
-        - type: click
-          selector: "button[type='submit']"
-        - type: wait
-          selector: ".dashboard"
-          delay: 2000
-        - type: screenshot
-          filename: "dashboard.png"
-        - type: assert
-          selector: ".user-profile"
-          shouldExist: true
-
-  - name: 表单填写测试
-    input:
-      url: https://example.com/form
-      actions:
-        - type: wait
-          selector: "form"
-        - type: type
-          selector: "#name"
-          value: "测试用户"
-        - type: type
-          selector: "#email"
-          value: "test@example.com"
-        - type: click
-          selector: "button[type='submit']"
-        - type: wait
-          selector: ".success-message"
-        - type: screenshot
-          filename: "form-success.png"
-
-# 与 agent-browser-stealth 集成说明
-integration:
-  agent_browser_stealth:
-    description: |
-      本 Tool 底层已使用 agent-browser-stealth 作为引擎，提供：
-      
-      1. 反检测 - 多层指纹伪装、行为人性化
-      2. 会话保持 - --session-name 支持多会话
-      3. 调试能力 - trace、profiler、console、errors
-      4. 元素引用 - snapshot -i 获取 @e1, @e2 引用
-      5. 引擎选择 - Chrome + Lightpanda
-      
-    cli_commands: |
-      # 交互式使用（更灵活）
-      abs open https://example.com --session-name my-session
-      abs snapshot -i                    # 获取元素引用 @e1, @e2, ...
-      abs click @e1                      # 点击元素
-      abs type @e2 "hello" --delay 50    # 模拟人类输入
-      abs screenshot result.png          # 截图
-      abs close                          # 关闭
-      
-    advanced: |
-      # 反检测模式
-      abs open https://example.com --risk-mode warn
-      
-      # 使用 Lightpanda 引擎（更快）
-      abs open https://example.com --engine lightpanda
-      
-      # 调试模式
-      abs open https://example.com --trace --verbose
-
-# 标签
-tags:
-  - browser
-  - e2e
-  - testing
-  - automation
-  - puppeteer
-  - stealth
-  - agent-browser-stealth
-  - dom
-  - anti-detection
-
-# 分类
-category: testing