@dommaker/harness 0.9.0 → 0.11.0

package/dist/tools/definitions/core/notification/notify.sh

@@ -0,0 +1,152 @@
+#!/bin/bash
+# notify.sh - 发送通知
+# ============================================================================
+# 功能：发送通知到指定渠道
+# 渠道：discord, queue (降级方案)
+# 用途：工作流完成通知、审核结果通知、状态更新
+# ============================================================================
+
+set -e
+
+# 参数
+CHANNEL="${1:-discord}"
+MESSAGE="${2:-}"
+TITLE="${3:-}"
+
+# 通知队列目录
+NOTIFICATION_DIR="${NOTIFICATION_DIR:-/tmp/agent-notifications}"
+
+# 颜色输出
+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"; }
+
+# 显示帮助
+show_help() {
+  cat << EOF
+发送通知
+
+用法:
+  $0 <channel> <message> [title]
+
+参数:
+  channel  通知渠道 (discord/queue)
+  message  通知内容
+  title    通知标题（可选）
+
+渠道说明:
+  discord  尝试发送到 Discord（需要 sessions_send）
+  queue    写入通知队列文件（降级方案）
+
+环境变量:
+  NOTIFICATION_DIR  通知队列目录（默认 /tmp/agent-notifications）
+
+输出:
+  JSON 格式的发送结果
+
+示例:
+  $0 discord "测试完成" "通知标题"
+  $0 queue "审核完成" "审核结果"
+EOF
+  exit 0
+}
+
+# 检查参数
+if [[ "$1" == "-h" || "$1" == "--help" || -z "$MESSAGE" ]]; then
+  show_help
+fi
+
+# 生成消息 ID
+MESSAGE_ID="notify-$(date +%s)-$$"
+
+# 构建通知内容
+if [[ -n "$TITLE" ]]; then
+  FULL_MESSAGE="**$TITLE**\n$MESSAGE"
+else
+  FULL_MESSAGE="$MESSAGE"
+fi
+
+# 根据渠道发送
+case "$CHANNEL" in
+  discord)
+    # 方案 1: 尝试使用 sessions_send（如果有 OpenClaw 环境）
+    # 方案 2: 降级到队列
+    
+    # 检查是否有 sessions_send 工具
+    # 这里我们写入队列，由 OpenClaw 的 heartbeat 检查并发送
+    mkdir -p "$NOTIFICATION_DIR"
+    
+    NOTIFICATION_FILE="$NOTIFICATION_DIR/${MESSAGE_ID}.json"
+    
+    cat > "$NOTIFICATION_FILE" << EOF
+{
+  "id": "$MESSAGE_ID",
+  "channel": "discord",
+  "title": "$TITLE",
+  "content": $(echo "$MESSAGE" | jq -Rs .),
+  "timestamp": "$(date -Iseconds)",
+  "status": "pending"
+}
+EOF
+    
+    log_info "通知已写入队列: $NOTIFICATION_FILE"
+    
+    cat << EOF
+{
+  "success": true,
+  "message_id": "$MESSAGE_ID",
+  "channel": "discord",
+  "status": "queued",
+  "file": "$NOTIFICATION_FILE"
+}
+EOF
+    ;;
+  
+  queue)
+    # 直接写入队列
+    mkdir -p "$NOTIFICATION_DIR"
+    
+    NOTIFICATION_FILE="$NOTIFICATION_DIR/${MESSAGE_ID}.json"
+    
+    cat > "$NOTIFICATION_FILE" << EOF
+{
+  "id": "$MESSAGE_ID",
+  "channel": "$CHANNEL",
+  "title": "$TITLE",
+  "content": $(echo "$MESSAGE" | jq -Rs .),
+  "timestamp": "$(date -Iseconds)",
+  "status": "pending"
+}
+EOF
+    
+    log_info "通知已写入队列: $NOTIFICATION_FILE"
+    
+    cat << EOF
+{
+  "success": true,
+  "message_id": "$MESSAGE_ID",
+  "channel": "$CHANNEL",
+  "status": "queued",
+  "file": "$NOTIFICATION_FILE"
+}
+EOF
+    ;;
+  
+  *)
+    log_error "不支持的通知渠道: $CHANNEL"
+    cat << EOF
+{
+  "success": false,
+  "error": "Unsupported channel: $CHANNEL",
+  "supported_channels": ["discord", "queue"]
+}
+EOF
+    exit 1
+    ;;
+esac

package/dist/tools/definitions/core/notification/notify.yml

@@ -0,0 +1,60 @@
+# notify.yml - 发送通知
+# ============================================================================
+# 工具类型: 通知
+# 用途: 发送通知到指定渠道
+# ============================================================================
+
+name: notification/notify
+description: |
+  发送通知到指定渠道
+  
+  支持渠道：
+  - discord
+  - slack
+  - email（待实现）
+
+input:
+  - name: channel
+    type: string
+    required: true
+    enum: [discord, slack, email]
+    description: 通知渠道
+  
+  - name: message
+    type: string
+    required: true
+    description: 通知内容
+  
+  - name: title
+    type: string
+    required: false
+    description: 通知标题（可选）
+
+output:
+  - name: success
+    type: boolean
+    description: 是否发送成功
+  
+  - name: message_id
+    type: string
+    description: 消息 ID
+
+# 实现说明
+implementation:
+  type: script
+  script: ./notify.sh
+  note: |
+    使用通知队列发送消息
+    
+    1. 写入通知到队列文件
+    2. 由 OpenClaw heartbeat 检查并发送
+    3. 支持 discord 和 queue 渠道
+
+# 元数据
+metadata:
+  author: Agent Studio
+  version: 1.0.0
+  tags:
+    - notification
+    - discord
+    - communication

package/dist/tools/definitions/core/npm/build.yml

@@ -0,0 +1,75 @@
+# build.yml - NPM 构建
+# ============================================================================
+# 能力类型: npm 操作（工具型）
+# 执行方式: 纯脚本，不调用 Agent
+# ============================================================================
+
+name: npm-build
+description: 构建 npm/pnpm 项目
+
+input:
+  repo_path:
+    type: path
+    required: true
+    description: 项目路径
+    
+  build_cmd:
+    type: string
+    required: false
+    description: 构建命令（可选，自动检测）
+    default: ""
+
+output:
+  build_result:
+    type: string
+    description: 构建结果
+
+script: |
+  #!/bin/bash
+  set -euo pipefail
+  
+  REPO_PATH="{{repo_path}}"
+  BUILD_CMD="{{build_cmd}}"
+  
+  cd "$REPO_PATH"
+  
+  echo "🔨 构建项目..."
+  echo "  路径: $REPO_PATH"
+  
+  # 自动检测包管理器
+  if [ -f "pnpm-lock.yaml" ]; then
+    PKG_MGR="pnpm"
+  elif [ -f "yarn.lock" ]; then
+    PKG_MGR="yarn"
+  else
+    PKG_MGR="npm"
+  fi
+  
+  echo "  包管理器: $PKG_MGR"
+  
+  # 确定构建命令
+  if [ -z "$BUILD_CMD" ]; then
+    # 检查 package.json 中的构建脚本
+    if [ -f "package.json" ] && grep -q '"build"' package.json; then
+      BUILD_CMD="$PKG_MGR run build"
+    else
+      echo "⚠️ 未找到构建脚本，跳过构建"
+      echo "BUILD_RESULT=skipped"
+      exit 0
+    fi
+  fi
+  
+  echo "  命令: $BUILD_CMD"
+  echo ""
+  
+  # 执行构建
+  if $BUILD_CMD 2>&1; then
+    echo ""
+    echo "✅ 构建成功"
+    echo "BUILD_RESULT=success"
+  else
+    echo ""
+    echo "❌ 构建失败"
+    echo "BUILD_RESULT=failed"
+    exit 1
+  fi

package/dist/tools/definitions/core/npm/install.yml

@@ -0,0 +1,58 @@
+# install.yml - NPM 安装依赖
+# ============================================================================
+# 能力类型: npm 操作（工具型）
+# 执行方式: 纯脚本，不调用 Agent
+# ============================================================================
+
+name: npm-install
+description: 安装 npm/pnpm 依赖
+
+input:
+  repo_path:
+    type: path
+    required: true
+    description: 项目路径
+
+output:
+  install_result:
+    type: string
+    description: 安装结果
+
+script: |
+  #!/bin/bash
+  set -euo pipefail
+  
+  REPO_PATH="{{repo_path}}"
+  
+  cd "$REPO_PATH"
+  
+  echo "📦 安装依赖..."
+  echo "  路径: $REPO_PATH"
+  
+  # 自动检测包管理器
+  if [ -f "pnpm-lock.yaml" ]; then
+    PKG_MGR="pnpm"
+    INSTALL_CMD="pnpm install"
+  elif [ -f "yarn.lock" ]; then
+    PKG_MGR="yarn"
+    INSTALL_CMD="yarn install"
+  else
+    PKG_MGR="npm"
+    INSTALL_CMD="npm install"
+  fi
+  
+  echo "  包管理器: $PKG_MGR"
+  echo "  命令: $INSTALL_CMD"
+  echo ""
+  
+  # 执行安装
+  if $INSTALL_CMD 2>&1; then
+    echo ""
+    echo "✅ 依赖安装成功"
+    echo "INSTALL_RESULT=success"
+  else
+    echo ""
+    echo "❌ 依赖安装失败"
+    echo "INSTALL_RESULT=failed"
+    exit 1
+  fi

package/dist/tools/definitions/core/npm/test.yml

@@ -0,0 +1,75 @@
+# test.yml - NPM 测试
+# ============================================================================
+# 能力类型: npm 操作（工具型）
+# 执行方式: 纯脚本，不调用 Agent
+# ============================================================================
+
+name: npm-test
+description: 运行 npm/pnpm 测试
+
+input:
+  repo_path:
+    type: path
+    required: true
+    description: 项目路径
+    
+  test_cmd:
+    type: string
+    required: false
+    description: 测试命令（可选，自动检测）
+    default: ""
+
+output:
+  test_result:
+    type: string
+    description: 测试结果
+
+script: |
+  #!/bin/bash
+  set -euo pipefail
+  
+  REPO_PATH="{{repo_path}}"
+  TEST_CMD="{{test_cmd}}"
+  
+  cd "$REPO_PATH"
+  
+  echo "🧪 运行测试..."
+  echo "  路径: $REPO_PATH"
+  
+  # 自动检测包管理器
+  if [ -f "pnpm-lock.yaml" ]; then
+    PKG_MGR="pnpm"
+  elif [ -f "yarn.lock" ]; then
+    PKG_MGR="yarn"
+  else
+    PKG_MGR="npm"
+  fi
+  
+  echo "  包管理器: $PKG_MGR"
+  
+  # 确定测试命令
+  if [ -z "$TEST_CMD" ]; then
+    # 检查 package.json 中的测试脚本
+    if [ -f "package.json" ] && grep -q '"test"' package.json; then
+      TEST_CMD="$PKG_MGR test"
+    else
+      echo "⚠️ 未找到测试脚本，跳过测试"
+      echo "TEST_RESULT=skipped"
+      exit 0
+    fi
+  fi
+  
+  echo "  命令: $TEST_CMD"
+  echo ""
+  
+  # 执行测试
+  if $TEST_CMD 2>&1; then
+    echo ""
+    echo "✅ 测试通过"
+    echo "TEST_RESULT=passed"
+  else
+    echo ""
+    echo "❌ 测试失败"
+    echo "TEST_RESULT=failed"
+    exit 1
+  fi

package/dist/tools/definitions/core/validation/check-reuse.yml

@@ -0,0 +1,170 @@
+# check-reuse.yml - 复用检查工具
+# ============================================================================
+# 能力类型: validation（工具型）
+# 执行方式: 纯脚本，检查现有能力
+# 用途: 在创建新 step/tool/workflow 前检查可复用的现有能力
+# 铁律: NO NEW CAPABILITIES WITHOUT REUSE CHECK FIRST
+# ============================================================================
+
+name: check-reuse
+description: 在创建新能力前检查是否有可复用的现有能力
+category: validation
+version: 1.0.0
+
+# 铁律
+iron_law:
+  rule: "NO NEW CAPABILITIES WITHOUT REUSE CHECK FIRST"
+  message: "在创建新能力之前，必须先检查是否有可复用的现有能力"
+
+# 输入
+input:
+  capability_type:
+    type: string
+    required: true
+    enum: [step, tool, workflow]
+    description: 要创建的能力类型
+  
+  keywords:
+    type: array
+    required: true
+    description: 关键词列表（用于搜索现有能力）
+  
+  description:
+    type: string
+    required: false
+    description: 功能描述（用于相似度匹配）
+  
+  workflows_path:
+    type: path
+    required: false
+    default: "~/projects/agent-workflows"
+    description: agent-workflows 路径
+
+# 输出
+output:
+  has_reusable:
+    type: boolean
+    description: 是否有可复用的能力
+  
+  existing_capabilities:
+    type: array
+    description: 找到的现有能力列表
+  
+  reuse_recommendation:
+    type: string
+    description: 复用建议
+  
+  should_create:
+    type: boolean
+    description: 是否建议创建新文件
+
+# 执行脚本
+script: |
+  #!/bin/bash
+  set -euo pipefail
+  
+  CAPABILITY_TYPE="{{capability_type}}"
+  KEYWORDS="{{keywords}}"
+  DESCRIPTION="{{description}}"
+  WORKFLOWS_PATH="{{workflows_path}}"
+  
+  echo "🔍 复用检查: 创建新 $CAPABILITY_TYPE"
+  echo "关键词: $KEYWORDS"
+  echo ""
+  
+  # 展开路径
+  WORKFLOWS_PATH="${WORKFLOWS_PATH/#\~/$HOME}"
+  
+  # 根据能力类型选择搜索目录
+  case "$CAPABILITY_TYPE" in
+    step)
+      SEARCH_DIR="$WORKFLOWS_PATH/steps"
+      ;;
+    tool)
+      SEARCH_DIR="$WORKFLOWS_PATH/tools"
+      ;;
+    workflow)
+      SEARCH_DIR="$WORKFLOWS_PATH/workflows"
+      ;;
+    *)
+      echo "❌ 未知的能力类型: $CAPABILITY_TYPE"
+      exit 1
+      ;;
+  esac
+  
+  if [ ! -d "$SEARCH_DIR" ]; then
+    echo "❌ 搜索目录不存在: $SEARCH_DIR"
+    exit 1
+  fi
+  
+  # 搜索现有能力
+  FOUND=()
+  
+  # 将关键词转换为数组
+  IFS=',' read -ra KEYWORD_ARRAY <<< "$KEYWORDS"
+  
+  for keyword in "${KEYWORD_ARRAY[@]}"; do
+    keyword=$(echo "$keyword" | xargs)  # trim
+    
+    # 搜索文件名和内容
+    for f in $(find "$SEARCH_DIR" -name "*.yml" -o -name "*.yaml" 2>/dev/null | grep -v README); do
+      # 检查文件名
+      if echo "$f" | grep -qi "$keyword"; then
+        FOUND+=("$f (文件名匹配)")
+      # 检查文件内容
+      elif grep -qi "$keyword" "$f" 2>/dev/null; then
+        FOUND+=("$f (内容匹配)")
+      fi
+    done
+  done
+  
+  # 去重
+  FOUND_UNIQUE=($(printf "%s\n" "${FOUND[@]}" | sort -u | tr '\n' ' '))
+  
+  # 输出结果
+  echo "================================"
+  echo "📊 搜索结果"
+  echo "================================"
+  echo ""
+  
+  if [ ${#FOUND_UNIQUE[@]} -gt 0 ]; then
+    echo "✅ 找到 ${#FOUND_UNIQUE[@]} 个相关能力:"
+    echo ""
+    for item in "${FOUND_UNIQUE[@]}"; do
+      echo "  - $item"
+    done
+    echo ""
+    echo "================================"
+    echo "📋 复用建议"
+    echo "================================"
+    echo ""
+    
+    # 根据匹配数量给出建议
+    if [ ${#FOUND_UNIQUE[@]} -ge 3 ]; then
+      echo "⚠️  找到多个相关能力，建议先评估是否可以复用或扩展"
+      echo "REUSE_RECOMMENDATION=evaluate"
+      echo "SHOULD_CREATE=false"
+    else
+      echo "💡 找到相关能力，建议检查是否满足需求"
+      echo "REUSE_RECOMMENDATION=check"
+      echo "SHOULD_CREATE=maybe"
+    fi
+    
+    echo ""
+    echo "has_reusable=true"
+  else
+    echo "❌ 未找到相关能力"
+    echo ""
+    echo "================================"
+    echo "📋 复用建议"
+    echo "================================"
+    echo ""
+    echo "✅ 可以创建新 $CAPABILITY_TYPE"
+    echo ""
+    echo "has_reusable=false"
+    echo "REUSE_RECOMMENDATION=create"
+    echo "SHOULD_CREATE=true"
+  fi
+  
+  echo ""
+  echo "existing_capabilities=${FOUND_UNIQUE[*]}"

package/dist/tools/definitions/core/validation/validate-handlers.yml

@@ -0,0 +1,118 @@
+# validate-handlers.yml - Handler 注册完整性检查
+# ============================================================================
+# 能力类型: validation（工具型）
+# 执行方式: 纯脚本，检查 handler 注册
+# 用途: 验证所有 step 的 handler 都已在 builtin-handlers.ts 中注册
+# ============================================================================
+
+name: validate-handlers
+description: 检查 step 的 handler 是否都在 builtin-handlers.ts 中注册
+category: validation
+version: 1.0.0
+
+# 铁律
+iron_law:
+  rule: "NO ORPHAN HANDLERS"
+  message: "所有 step 定义的 handler 必须在 builtin-handlers.ts 中注册"
+
+# 输入
+input:
+  steps_dir:
+    type: path
+    required: false
+    default: "steps"
+    description: steps 目录路径
+  
+  registry_file:
+    type: path
+    required: false
+    default: "../agent-runtime/src/core/builtin-handlers.ts"
+    description: builtin-handlers.ts 文件路径
+
+# 输出
+output:
+  total_handlers:
+    type: number
+    description: 发现的 handler 总数
+  
+  registered:
+    type: number
+    description: 已注册的 handler 数量
+  
+  missing:
+    type: array
+    description: 未注册的 handler 列表
+  
+  passed:
+    type: boolean
+    description: 是否全部通过
+
+# 执行脚本
+script: |
+  #!/bin/bash
+  set -euo pipefail
+  
+  STEPS_DIR="{{steps_dir}}"
+  REGISTRY_FILE="{{registry_file}}"
+  
+  echo "🔍 检查 Handler 注册完整性"
+  echo "  Steps 目录: $STEPS_DIR"
+  echo "  注册文件: $REGISTRY_FILE"
+  echo ""
+  
+  # 检查目录和文件是否存在
+  if [ ! -d "$STEPS_DIR" ]; then
+    echo "❌ Steps 目录不存在: $STEPS_DIR"
+    exit 1
+  fi
+  
+  if [ ! -f "$REGISTRY_FILE" ]; then
+    echo "❌ 注册文件不存在: $REGISTRY_FILE"
+    exit 1
+  fi
+  
+  MISSING=()
+  TOTAL=0
+  REGISTERED=0
+  
+  # 遍历所有 step 文件
+  for f in $(find "$STEPS_DIR" -name "*.yml" -o -name "*.yaml" 2>/dev/null | sort); do
+    # 提取 handler 字段
+    handler=$(grep -E "^\s*handler:" "$f" 2>/dev/null | head -1 | sed 's/.*handler:\s*//' | tr -d '"' | tr -d "'")
+    
+    if [ -n "$handler" ]; then
+      TOTAL=$((TOTAL + 1))
+      
+      # 检查是否在注册文件中
+      if grep -q "'$handler'" "$REGISTRY_FILE" 2>/dev/null; then
+        REGISTERED=$((REGISTERED + 1))
+        echo "  ✅ $handler"
+      else
+        MISSING+=("$handler")
+        echo "  ❌ $handler (from $(basename $(dirname $f))/$(basename $f))"
+      fi
+    fi
+  done
+  
+  echo ""
+  echo "================================"
+  echo "📊 统计:"
+  echo "  总计: $TOTAL 个 handler"
+  echo "  已注册: $REGISTERED 个"
+  echo "  未注册: ${#MISSING[@]} 个"
+  echo "================================"
+  
+  if [ ${#MISSING[@]} -gt 0 ]; then
+    echo ""
+    echo "❌ 发现未注册的 handler:"
+    for h in "${MISSING[@]}"; do
+      echo "  - $h"
+    done
+    echo ""
+    echo "请在 builtin-handlers.ts 中注册这些 handler"
+    exit 1
+  fi
+  
+  echo ""
+  echo "✅ 所有 handler 都已正确注册"
+  exit 0