@dommaker/harness 0.9.0 → 0.10.0

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

@@ -0,0 +1,155 @@
+# 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/core/validation/validate-yaml-syntax.yml

@@ -0,0 +1,134 @@
+# 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/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/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/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"