@dommaker/harness 0.8.3 → 0.10.0

package/dist/tools/core/index.js

@@ -0,0 +1,198 @@
+"use strict";
+/**
+ * 核心工具定义
+ *
+ * 内置工具：file / git / npm / shell
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CORE_TOOLS = exports.SHELL_TOOLS = exports.NPM_TOOLS = exports.GIT_TOOLS = exports.FILE_TOOLS = void 0;
+exports.FILE_TOOLS = [
+    {
+        id: 'read_file',
+        name: 'Read File',
+        description: '读取文件内容',
+        category: 'core',
+        parameters: {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: '文件路径' },
+                offset: { type: 'number', description: '起始行号' },
+                limit: { type: 'number', description: '读取行数' },
+            },
+            required: ['path'],
+        },
+        sandboxLevel: 1,
+    },
+    {
+        id: 'write_file',
+        name: 'Write File',
+        description: '写入文件内容',
+        category: 'core',
+        parameters: {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: '文件路径' },
+                content: { type: 'string', description: '文件内容' },
+            },
+            required: ['path', 'content'],
+        },
+        sandboxLevel: 3,
+    },
+    {
+        id: 'edit_file',
+        name: 'Edit File',
+        description: '编辑文件（精确替换）',
+        category: 'core',
+        parameters: {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: '文件路径' },
+                old_string: { type: 'string', description: '要替换的文本' },
+                new_string: { type: 'string', description: '替换后的文本' },
+            },
+            required: ['path', 'old_string', 'new_string'],
+        },
+        sandboxLevel: 3,
+    },
+    {
+        id: 'list_directory',
+        name: 'List Directory',
+        description: '列出目录内容',
+        category: 'core',
+        parameters: {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: '目录路径' },
+            },
+            required: ['path'],
+        },
+        sandboxLevel: 1,
+    },
+];
+exports.GIT_TOOLS = [
+    {
+        id: 'git_status',
+        name: 'Git Status',
+        description: '查看 git 工作区状态',
+        category: 'core',
+        parameters: { type: 'object', properties: {} },
+        sandboxLevel: 1,
+    },
+    {
+        id: 'git_diff',
+        name: 'Git Diff',
+        description: '查看 git 差异',
+        category: 'core',
+        parameters: {
+            type: 'object',
+            properties: {
+                staged: { type: 'boolean', description: '是否查看暂存区' },
+                file: { type: 'string', description: '指定文件' },
+            },
+        },
+        sandboxLevel: 1,
+    },
+    {
+        id: 'git_commit',
+        name: 'Git Commit',
+        description: '创建 git 提交',
+        category: 'core',
+        parameters: {
+            type: 'object',
+            properties: {
+                message: { type: 'string', description: '提交信息' },
+                files: { type: 'array', items: { type: 'string' }, description: '要提交的文件' },
+            },
+            required: ['message'],
+        },
+        sandboxLevel: 3,
+        requiresConfirmation: true,
+    },
+    {
+        id: 'git_log',
+        name: 'Git Log',
+        description: '查看 git 提交历史',
+        category: 'core',
+        parameters: {
+            type: 'object',
+            properties: {
+                limit: { type: 'number', description: '显示条数' },
+                file: { type: 'string', description: '指定文件' },
+            },
+        },
+        sandboxLevel: 1,
+    },
+];
+exports.NPM_TOOLS = [
+    {
+        id: 'npm_install',
+        name: 'NPM Install',
+        description: '安装依赖',
+        category: 'core',
+        parameters: {
+            type: 'object',
+            properties: {
+                packages: { type: 'array', items: { type: 'string' }, description: '包名列表' },
+                dev: { type: 'boolean', description: '是否为开发依赖' },
+            },
+        },
+        sandboxLevel: 3,
+        rateLimit: 10,
+    },
+    {
+        id: 'npm_run',
+        name: 'NPM Run',
+        description: '执行 npm 脚本',
+        category: 'core',
+        parameters: {
+            type: 'object',
+            properties: {
+                script: { type: 'string', description: '脚本名称' },
+                args: { type: 'array', items: { type: 'string' }, description: '参数' },
+            },
+            required: ['script'],
+        },
+        sandboxLevel: 3,
+    },
+    {
+        id: 'npm_test',
+        name: 'NPM Test',
+        description: '运行测试',
+        category: 'core',
+        parameters: {
+            type: 'object',
+            properties: {
+                pattern: { type: 'string', description: '测试文件匹配模式' },
+                coverage: { type: 'boolean', description: '是否生成覆盖率报告' },
+            },
+        },
+        sandboxLevel: 3,
+    },
+];
+exports.SHELL_TOOLS = [
+    {
+        id: 'shell_exec',
+        name: 'Shell Execute',
+        description: '执行 shell 命令',
+        category: 'core',
+        parameters: {
+            type: 'object',
+            properties: {
+                command: { type: 'string', description: '命令' },
+                cwd: { type: 'string', description: '工作目录' },
+                timeout: { type: 'number', description: '超时（ms）' },
+            },
+            required: ['command'],
+        },
+        sandboxLevel: 3,
+        rateLimit: 30,
+    },
+];
+/** 所有核心工具 */
+exports.CORE_TOOLS = [
+    ...exports.FILE_TOOLS,
+    ...exports.GIT_TOOLS,
+    ...exports.NPM_TOOLS,
+    ...exports.SHELL_TOOLS,
+];
+//# sourceMappingURL=index.js.map

package/dist/tools/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/core/index.ts"],"names":[],"mappings":"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"}

package/dist/tools/definitions/core/code/fingerprint.sh

@@ -0,0 +1,273 @@
+#!/bin/bash
+# fingerprint.sh - 代码结构指纹工具
+# ============================================================================
+# 功能：提取代码结构签名，区分"结构性变更"和"表面变更"
+# 用途：增量分析、变更影响评估、代码审查优先级排序
+# ============================================================================
+
+set -e
+
+# 参数
+FILE_PATH="${1:-}"
+PROJECT_PATH="${2:-.}"
+COMPARE_WITH="${3:-previous}"
+
+# 颜色输出
+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"; }
+
+# 显示帮助
+show_help() {
+  cat << EOF
+代码结构指纹工具
+
+用法:
+  $0 <file_path> [project_path] [compare_with]
+
+参数:
+  file_path     文件路径（相对于项目根目录）
+  project_path  项目根路径（默认: 当前目录）
+  compare_with  对比目标（默认: previous）
+                - "previous" - 与上一个 commit 对比
+                - "base" - 与基准分支对比
+                - <commit_hash> - 具体的 commit
+
+输出:
+  JSON 格式的结构指纹和变更分析结果
+
+示例:
+  $0 src/utils.ts
+  $0 src/utils.ts /home/user/project previous
+  $0 src/api.ts . HEAD~3
+EOF
+  exit 0
+}
+
+# 检查参数
+if [[ "$1" == "-h" || "$1" == "--help" || -z "$FILE_PATH" ]]; then
+  show_help
+fi
+
+cd "$PROJECT_PATH"
+
+# 检查文件是否存在
+if [[ ! -f "$FILE_PATH" ]]; then
+  log_error "文件不存在: $FILE_PATH"
+  exit 1
+fi
+
+# 获取文件扩展名和语言
+EXT="${FILE_PATH##*.}"
+LANG_MAP=(
+  "ts:typescript"
+  "tsx:typescript"
+  "js:javascript"
+  "jsx:javascript"
+  "py:python"
+  "go:go"
+  "rs:rust"
+  "java:java"
+  "cpp:c++"
+  "c:c"
+  "rb:ruby"
+  "php:php"
+  "swift:swift"
+  "kt:kotlin"
+  "scala:scala"
+  "cs:c#"
+  "vue:vue"
+  "svelte:svelte"
+  "css:css"
+  "scss:scss"
+  "html:html"
+  "json:json"
+  "yaml:yaml"
+  "md:markdown"
+  "sh:bash"
+)
+
+get_language() {
+  local ext="$1"
+  for entry in "${LANG_MAP[@]}"; do
+    if [[ "$entry" == "$ext:"* ]]; then
+      echo "${entry#*:}"
+      return
+    fi
+  done
+  echo "unknown"
+}
+
+LANGUAGE=$(get_language "$EXT")
+
+# 提取代码结构
+extract_structure() {
+  local file="$1"
+  local lang="$2"
+  
+  case "$lang" in
+    typescript|javascript)
+      # 提取函数、类、导入
+      local functions=$(grep -oE "(function\s+[a-zA-Z_][a-zA-Z0-9_]*|const\s+[a-zA-Z_][a-zA-Z0-9_]*\s*=\s*(async\s*)?\(|const\s+[a-zA-Z_][a-zA-Z0-9_]*\s*=\s*function)" "$file" 2>/dev/null | sed 's/function\s\|const\s\|=\s*(\|async\s//g' | tr -d '()' || echo "")
+      local classes=$(grep -oE "(class|interface|type)\s+[a-zA-Z_][a-zA-Z0-9_]*" "$file" 2>/dev/null | awk '{print $2}' || echo "")
+      local imports=$(grep -oE "import.*from\s+['\"][^'\"]+['\"]" "$file" 2>/dev/null | sed "s/.*from\s*['\"]//;s/['\"]//g" || echo "")
+      ;;
+    python)
+      local functions=$(grep -oE "^def\s+[a-zA-Z_][a-zA-Z0-9_]*" "$file" 2>/dev/null | sed 's/def\s//' || echo "")
+      local classes=$(grep -oE "^class\s+[a-zA-Z_][a-zA-Z0-9_]*" "$file" 2>/dev/null | sed 's/class\s//' || echo "")
+      local imports=$(grep -oE "^import\s+[a-zA-Z_][a-zA-Z0-9_.]*|^from\s+[a-zA-Z_][a-zA-Z0-9_.]*\s+import" "$file" 2>/dev/null | head -20 || echo "")
+      ;;
+    go)
+      local functions=$(grep -oE "func\s+(\([a-zA-Z_][a-zA-Z0-9_]*\s+\*?[a-zA-Z_][a-zA-Z0-9_]*\)\s+)?[a-zA-Z_][a-zA-Z0-9_]*" "$file" 2>/dev/null | sed 's/func\s\|func\s*(.*)\s//g' || echo "")
+      local classes=$(grep -oE "type\s+[a-zA-Z_][a-zA-Z0-9_]*\s+struct" "$file" 2>/dev/null | awk '{print $2}' || echo "")
+      local imports=$(grep -oE "import\s+[\"]?[^\"\n]+[\"]?" "$file" 2>/dev/null | sed 's/import\s\|\"//g' || echo "")
+      ;;
+    *)
+      # 通用提取：函数定义
+      local functions=$(grep -oE "(function|func|def|fn)\s+[a-zA-Z_][a-zA-Z0-9_]*" "$file" 2>/dev/null | awk '{print $2}' || echo "")
+      local classes=$(grep -oE "(class|struct|interface)\s+[a-zA-Z_][a-zA-Z0-9_]*" "$file" 2>/dev/null | awk '{print $2}' || echo "")
+      local imports=""
+      ;;
+  esac
+  
+  # 输出 JSON
+  echo "{\"functions\":[$(echo "$functions" | tr '\n' ',' | sed 's/,$//' | while read f; do [[ -n "$f" ]] && echo "\"$f\""; done | tr '\n' ',' | sed 's/,$//')],\"classes\":[$(echo "$classes" | tr '\n' ',' | sed 's/,$//' | while read c; do [[ -n "$c" ]] && echo "\"$c\""; done | tr '\n' ',' | sed 's/,$//')],\"imports\":[$(echo "$imports" | tr '\n' ',' | sed 's/,$//' | while read i; do [[ -n "$i" ]] && echo "\"$i\""; done | tr '\n' ',' | sed 's/,$//')]}"
+}
+
+# 计算内容哈希
+compute_hash() {
+  local file="$1"
+  sha256sum "$file" 2>/dev/null | awk '{print $1}' || md5sum "$file" 2>/dev/null | awk '{print $1}'
+}
+
+# 获取 git diff
+get_git_diff() {
+  local file="$1"
+  local compare="$2"
+  
+  case "$compare" in
+    previous)
+      git diff HEAD~1 HEAD -- "$file" 2>/dev/null || echo ""
+      ;;
+    base)
+      local base_branch=$(git remote show origin 2>/dev/null | grep 'HEAD branch' | awk '{print $NF}' || echo "main")
+      git diff "$base_branch" HEAD -- "$file" 2>/dev/null || echo ""
+      ;;
+    *)
+      git diff "$compare" HEAD -- "$file" 2>/dev/null || echo ""
+      ;;
+  esac
+}
+
+# 分析变更级别
+analyze_change_level() {
+  local diff="$1"
+  
+  if [[ -z "$diff" ]]; then
+    echo "NONE"
+    return
+  fi
+  
+  # 检查是否有结构变更
+  local structural_patterns="(function|func|def|class|interface|struct|type|enum)\s+[a-zA-Z_]"
+  local structural_changes=$(echo "$diff" | grep -E "^[\+\-].*$structural_patterns" | grep -v "^[\+\-][\+\-][\+\-]" | wc -l)
+  
+  # 检查是否有导入变更
+  local import_patterns="(import|require|from\s+['\"])"
+  local import_changes=$(echo "$diff" | grep -E "^[\+\-].*$import_patterns" | grep -v "^[\+\-][\+\-][\+\-]" | wc -l)
+  
+  # 检查是否只有注释或格式变更
+  local cosmetic_only=true
+  local added_lines=$(echo "$diff" | grep "^+" | grep -v "^+++" | wc -l)
+  local removed_lines=$(echo "$diff" | grep "^-" | grep -v "^---" | wc -l)
+  
+  # 检查非注释变更
+  local code_lines=$(echo "$diff" | grep -E "^[\+\-]" | grep -v "^[\+\-][\+\-][\+\-]" | grep -v "^\+\s*(//|/\*|\*|<!--|#)" | wc -l)
+  
+  if [[ $structural_changes -gt 0 || $import_changes -gt 0 ]]; then
+    echo "STRUCTURAL"
+  elif [[ $code_lines -gt 0 ]]; then
+    echo "COSMETIC"
+  else
+    echo "NONE"
+  fi
+}
+
+# 提取变更详情
+extract_change_details() {
+  local diff="$1"
+  local level="$2"
+  local details=()
+  
+  if [[ "$level" == "NONE" ]]; then
+    echo "[]"
+    return
+  fi
+  
+  # 提取新增的函数
+  local new_functions=$(echo "$diff" | grep "^+" | grep -oE "(function|func|def)\s+[a-zA-Z_][a-zA-Z0-9_]*" | sed 's/function\s\|func\s\|def\s//' | head -5)
+  for f in $new_functions; do
+    details+=("added function: $f")
+  done
+  
+  # 提取删除的函数
+  local removed_functions=$(echo "$diff" | grep "^-" | grep -oE "(function|func|def)\s+[a-zA-Z_][a-zA-Z0-9_]*" | sed 's/function\s\|func\s\|def\s//' | head -5)
+  for f in $removed_functions; do
+    details+=("removed function: $f")
+  done
+  
+  # 提取新增的类
+  local new_classes=$(echo "$diff" | grep "^+" | grep -oE "(class|interface|struct|type)\s+[a-zA-Z_][a-zA-Z0-9_]*" | awk '{print $2}' | head -5)
+  for c in $new_classes; do
+    details+=("added class/interface: $c")
+  done
+  
+  # 提取新增的导入
+  local new_imports=$(echo "$diff" | grep "^+" | grep -oE "import.*from\s+['\"][^'\"]+['\"]" | sed "s/.*from\s*['\"]//;s/['\"]//g" | head -5)
+  for i in $new_imports; do
+    details+=("added import: $i")
+  done
+  
+  # 输出 JSON 数组
+  local json="["
+  for d in "${details[@]}"; do
+    [[ -n "$d" ]] && json+="\"$d\","
+  done
+  json="${json%,}]"
+  echo "$json"
+}
+
+# 主流程
+log_info "分析文件: $FILE_PATH"
+log_info "语言: $LANGUAGE"
+log_info "对比目标: $COMPARE_WITH"
+
+# 提取当前结构
+CURRENT_STRUCTURE=$(extract_structure "$FILE_PATH" "$LANGUAGE")
+CONTENT_HASH=$(compute_hash "$FILE_PATH")
+
+# 获取 diff 并分析变更
+DIFF=$(get_git_diff "$FILE_PATH" "$COMPARE_WITH")
+CHANGE_LEVEL=$(analyze_change_level "$DIFF")
+CHANGE_DETAILS=$(extract_change_details "$DIFF" "$CHANGE_LEVEL")
+
+# 输出结果
+cat << EOF
+{
+  "file_path": "$FILE_PATH",
+  "language": "$LANGUAGE",
+  "fingerprint": $CURRENT_STRUCTURE,
+  "content_hash": "$CONTENT_HASH",
+  "change_level": "$CHANGE_LEVEL",
+  "details": $CHANGE_DETAILS
+}
+EOF
+
+log_info "完成"

package/dist/tools/definitions/core/code/fingerprint.yml

@@ -0,0 +1,72 @@
+name: code/fingerprint
+description: |
+  生成代码结构指纹，用于变更检测。
+  
+  通过提取代码的结构签名（函数签名、类结构、导入导出），
+  可以区分"结构性变更"和"表面变更"（如注释、格式化）。
+  
+  用途：
+  - 增量分析（只处理真正变更的文件）
+  - 变更影响评估
+  - 代码审查优先级排序
+
+inputs:
+  - name: file_path
+    type: string
+    required: true
+    description: 文件路径
+    
+  - name: project_path
+    type: string
+    required: true
+    description: 项目根路径
+    
+  - name: compare_with
+    type: string
+    required: false
+    description: |
+      对比目标：
+      - "previous" - 与上一个 commit 对比
+      - "base" - 与基准分支对比
+      - 具体的 commit hash
+
+outputs:
+  - name: fingerprint
+    type: object
+    description: 结构指纹对象
+    
+  - name: content_hash
+    type: string
+    description: 内容哈希（SHA-256）
+    
+  - name: change_level
+    type: string
+    description: |
+      变更级别：
+      - "NONE" - 无变更
+      - "COSMETIC" - 表面变更（注释、格式）
+      - "STRUCTURAL" - 结构性变更
+      
+  - name: details
+    type: array
+    description: 变更详情列表
+
+handler: script
+script: ./fingerprint.sh
+
+examples:
+  - description: 检测文件变更级别
+    inputs:
+      file_path: "src/utils.ts"
+      project_path: "/home/user/project"
+      compare_with: "previous"
+    outputs:
+      fingerprint:
+        functions: ["helper", "format"]
+        classes: []
+        imports: ["lodash"]
+      content_hash: "abc123..."
+      change_level: "COSMETIC"
+      details: ["internal logic changed (no structural impact)"]
+
+version: "1.0.0"

package/dist/tools/definitions/core/code/parse.yml

@@ -0,0 +1,68 @@
+name: code/parse
+description: |
+  使用 Tree-sitter 解析代码文件，提取 AST 结构。
+  支持函数、类、导入、导出等结构化信息提取。
+  
+  用途：
+  - 代码结构分析
+  - 知识图谱构建
+  - 变更检测（fingerprint）
+  
+inputs:
+  - name: file_path
+    type: string
+    required: true
+    description: 要解析的文件路径
+    
+  - name: language
+    type: string
+    required: false
+    description: |
+      语言类型（可选，自动检测）。
+      支持：typescript, javascript, python, go, rust, java, cpp, c, ruby, php
+      
+  - name: project_path
+    type: string
+    required: false
+    description: 项目根路径（用于相对路径计算）
+
+outputs:
+  - name: ast_nodes
+    type: array
+    description: AST 节点列表
+    
+  - name: functions
+    type: array
+    description: 函数列表（名称、参数、返回类型、行范围）
+    
+  - name: classes
+    type: array
+    description: 类列表（名称、方法、属性、行范围）
+    
+  - name: imports
+    type: array
+    description: 导入列表（来源、说明符）
+    
+  - name: exports
+    type: array
+    description: 导出列表（名称、类型）
+
+handler: builtin
+handlerName: code_parse
+
+examples:
+  - description: 解析 TypeScript 文件
+    inputs:
+      file_path: "src/index.ts"
+      project_path: "/home/user/project"
+    outputs:
+      functions:
+        - name: "main"
+          params: ["args"]
+          returnType: "void"
+          lineRange: [10, 25]
+      imports:
+        - source: "fs"
+          specifiers: ["readFileSync", "writeFileSync"]
+
+version: "1.0.0"