@dommaker/harness 0.16.6 → 0.16.8

package/dist/governance/index.js

@@ -1,13 +0,0 @@
-"use strict";
-/**
- * 治理模块
- *
- * harness 检测差异，LLM 自行修复
- * 只提供检测能力，不提供修复机制
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.governanceExecutor = exports.GovernanceExecutor = void 0;
-var executor_1 = require("./executor");
-Object.defineProperty(exports, "GovernanceExecutor", { enumerable: true, get: function () { return executor_1.GovernanceExecutor; } });
-Object.defineProperty(exports, "governanceExecutor", { enumerable: true, get: function () { return executor_1.governanceExecutor; } });
-//# sourceMappingURL=index.js.map

package/dist/governance/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/governance/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,uCAAoE;AAA3D,8GAAA,kBAAkB,OAAA;AAAE,8GAAA,kBAAkB,OAAA"}

package/dist/governance/types.d.ts

@@ -1,46 +0,0 @@
-/**
- * 治理类型定义
- *
- * harness 检测差异，LLM 自行决定如何修复
- * 不需要 hook 返回内容、不需要 apply 机制
- */
-/**
- * 差异类型
- */
-export type DiffType = 'doc_mismatch' | 'context_missing' | 'context_outdated' | 'test_gap' | 'constraint_violation';
-/**
- * 治理检查结果（harness 检测到的差异）
- */
-export interface GovernanceDiff {
-    /** 差异类型 */
-    type: DiffType;
-    /** 项目路径 */
-    projectPath: string;
-    /** 差异详情 */
-    details: {
-        /** 目标文件 */
-        file?: string;
-        /** 现有内容 */
-        current?: string;
-        /** 期望内容（代码实际情况） */
-        expected?: string;
-        /** 相关文件列表 */
-        files?: string[];
-        /** 模块名 */
-        moduleName?: string;
-        /** 约束 ID */
-        constraintId?: string;
-        /** 额外上下文 */
-        context?: Record<string, unknown>;
-    };
-}
-/**
- * 治理执行结果
- */
-export interface GovernanceResult {
-    /** 是否有差异 */
-    hasDiffs: boolean;
-    /** 检测到的差异 */
-    diffs: GovernanceDiff[];
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/governance/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/governance/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,MAAM,QAAQ,GAChB,cAAc,GACd,iBAAiB,GACjB,kBAAkB,GAClB,UAAU,GACV,sBAAsB,CAAC;AAE3B;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,WAAW;IACX,IAAI,EAAE,QAAQ,CAAC;IACf,WAAW;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW;IACX,OAAO,EAAE;QACP,WAAW;QACX,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW;QACX,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,mBAAmB;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,aAAa;QACb,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,UAAU;QACV,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,YAAY;QACZ,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,YAAY;QACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,YAAY;IACZ,QAAQ,EAAE,OAAO,CAAC;IAClB,aAAa;IACb,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB"}

package/dist/governance/types.js

@@ -1,9 +0,0 @@
-"use strict";
-/**
- * 治理类型定义
- *
- * harness 检测差异，LLM 自行决定如何修复
- * 不需要 hook 返回内容、不需要 apply 机制
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=types.js.map

package/dist/governance/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/governance/types.ts"],"names":[],"mappings":";AAAA;;;;;GAKG"}

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

@@ -1,273 +0,0 @@
-#!/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

@@ -1,72 +0,0 @@
-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

@@ -1,68 +0,0 @@
-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"