@dommaker/harness 0.9.0 → 0.10.0

package/dist/monitoring/constraint-doctor.js

@@ -29,7 +29,8 @@ class ConstraintDoctor {
     config;
     traces;
     summary;
-    constructor(config) {
+    llm;
+    constructor(config, llm) {
         this.config = {
             enabled: false,
             maxTracesInPrompt: 20,
@@ -38,6 +39,7 @@ class ConstraintDoctor {
         };
         this.traces = [];
         this.summary = null;
+        this.llm = llm || null;
     }
     /**
      * 设置诊断数据
@@ -56,11 +58,15 @@ class ConstraintDoctor {
         const relevantTraces = this.filterRelevantTraces(anomaly);
         // 基于规则的初步诊断（不消耗 Token）
         const ruleBasedDiagnosis = this.ruleBasedDiagnose(anomaly, relevantTraces);
-        // 如果 Agent 启用，可以进一步分析（预留）
-        if (this.config.enabled && this.config.agentType) {
-            // TODO: 调用 Agent 进行深度分析
-            // const agentDiagnosis = await this.agentDiagnose(anomaly, relevantTraces);
-            // return agentDiagnosis;
+        // 如果 LLM 可用，进行深度分析
+        if (this.config.enabled && this.llm) {
+            try {
+                return await this.agentDiagnose(anomaly, relevantTraces, ruleBasedDiagnosis);
+            }
+            catch {
+                // LLM 调用失败，降级到规则诊断
+                return ruleBasedDiagnosis;
+            }
         }
         return ruleBasedDiagnosis;
     }
@@ -205,9 +211,78 @@ class ConstraintDoctor {
         }
         return diagnosis;
     }
+    /**
+     * LLM 深度诊断
+     *
+     * 将异常和相关 traces 构造为 prompt，调用 LLM 分析根因
+     * 成本：~2000 Token/次
+     */
+    async agentDiagnose(anomaly, traces, fallback) {
+        const maxTraces = this.config.maxTracesInPrompt || 20;
+        const traceSummary = traces.slice(0, maxTraces).map(t => `[${t.result}] ${t.constraintId} | ${t.operation || 'unknown'} | ${t.timestamp ? new Date(t.timestamp).toISOString() : 'no-ts'}`).join('\n');
+        const prompt = `你是约束系统诊断专家。分析以下异常并给出诊断结果。
+
+## 异常信息
+- 约束 ID: ${anomaly.constraintId}
+- 异常类型: ${anomaly.type}
+- 约束层级: ${anomaly.level}
+- 当前数据: ${JSON.stringify(anomaly.data)}
+
+## 相关 Traces（最近 ${Math.min(traces.length, maxTraces)} 条）
+${traceSummary || '无相关 traces'}
+
+## 要求
+以 JSON 格式返回诊断结果，包含以下字段：
+{
+  "rootCause": { "primary": "主要原因", "secondary": ["次要原因1", "次要原因2"] },
+  "impact": { "severity": "low|medium|high", "scope": "single_project|multiple_projects|team", "userImpact": "用户影响描述" },
+  "recommendations": [{ "type": "add_exception|adjust_threshold|modify_constraint|user_training", "content": "建议内容", "expectedOutcome": "预期效果", "implementationCost": "low|medium|high" }],
+  "needsChange": true/false,
+  "urgency": "low|medium|high"
+}
+
+只返回 JSON，不要其他内容。`;
+        const response = await this.llm.complete(prompt, {
+            maxTokens: 1000,
+            temperature: 0.3,
+        });
+        // 解析 LLM 响应
+        const parsed = this.parseAgentResponse(response);
+        return {
+            ...fallback,
+            rootCause: {
+                primary: parsed.rootCause?.primary || fallback.rootCause.primary,
+                secondary: parsed.rootCause?.secondary || fallback.rootCause.secondary,
+                evidence: fallback.rootCause.evidence,
+            },
+            impact: {
+                severity: parsed.impact?.severity || fallback.impact.severity,
+                scope: parsed.impact?.scope || fallback.impact.scope,
+                userImpact: parsed.impact?.userImpact || fallback.impact.userImpact,
+            },
+            recommendations: parsed.recommendations?.length ? parsed.recommendations : fallback.recommendations,
+            needsChange: parsed.needsChange ?? fallback.needsChange,
+            urgency: parsed.urgency || fallback.urgency,
+        };
+    }
+    /**
+     * 解析 LLM 返回的 JSON 诊断结果
+     */
+    parseAgentResponse(response) {
+        try {
+            // 提取 JSON（可能被 markdown 代码块包裹）
+            const jsonMatch = response.match(/\{[\s\S]*\}/);
+            if (!jsonMatch)
+                return {};
+            return JSON.parse(jsonMatch[0]);
+        }
+        catch {
+            return {};
+        }
+    }
     /**
      * 过滤相关 traces
-   *
+     *
      * 只保留与异常相关的 traces，减少 prompt 内容
      */
     filterRelevantTraces(anomaly) {
@@ -299,7 +374,7 @@ exports.ConstraintDoctor = ConstraintDoctor;
 /**
  * 创建诊断器
  */
-function createDoctor(config) {
-    return new ConstraintDoctor(config);
+function createDoctor(config, llm) {
+    return new ConstraintDoctor(config, llm);
 }
 //# sourceMappingURL=constraint-doctor.js.map

package/dist/monitoring/constraint-doctor.js.map

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

package/dist/presets/long-running.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Long-Running Agents 预设
+ *
+ * 适用于 Anthropic Long-Running Agents 模式的项目
+ */
+import type { PresetConfig } from './standard';
+/**
+ * Long-Running 预设
+ *
+ * 包含：
+ * - 核心约束（standard preset）
+ * - Long-Running 扩展约束
+ */
+export declare const LONG_RUNNING_PRESET: PresetConfig;
+/**
+ * 获取 Long-Running 预设的约束列表
+ */
+export declare function getLongRunningPresetConstraints(): {
+    ironLaws: string[];
+    guidelines: string[];
+    tips: string[];
+};
+/**
+ * 预设说明
+ */
+export declare const LONG_RUNNING_PRESET_INFO: {
+    name: string;
+    description: string;
+    usage: string;
+    features: string[];
+    requires: string[];
+};
+//# sourceMappingURL=long-running.d.ts.map

package/dist/presets/long-running.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"long-running.d.ts","sourceRoot":"","sources":["../../src/presets/long-running.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAO/C;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,EAAE,YAKjC,CAAC;AAEF;;GAEG;AACH,wBAAgB,+BAA+B,IAAI;IACjD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,CAQA;AAED;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;CAapC,CAAC"}

package/dist/presets/long-running.js

@@ -0,0 +1,52 @@
+"use strict";
+/**
+ * Long-Running Agents 预设
+ *
+ * 适用于 Anthropic Long-Running Agents 模式的项目
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LONG_RUNNING_PRESET_INFO = exports.LONG_RUNNING_PRESET = void 0;
+exports.getLongRunningPresetConstraints = getLongRunningPresetConstraints;
+const long_running_1 = require("../extensions/long-running");
+/**
+ * Long-Running 预设
+ *
+ * 包含：
+ * - 核心约束（standard preset）
+ * - Long-Running 扩展约束
+ */
+exports.LONG_RUNNING_PRESET = {
+    name: 'long-running',
+    ironLaws: null, // 全部启用（包括扩展）
+    guidelines: null, // 全部启用（包括扩展）
+    tips: null, // 全部启用
+};
+/**
+ * 获取 Long-Running 预设的约束列表
+ */
+function getLongRunningPresetConstraints() {
+    const constraints = (0, long_running_1.getAllLongRunningConstraints)();
+    return {
+        ironLaws: constraints.filter(c => c.level === 'iron_law').map(c => c.id),
+        guidelines: constraints.filter(c => c.level === 'guideline').map(c => c.id),
+        tips: constraints.filter(c => c.level === 'tip').map(c => c.id),
+    };
+}
+/**
+ * 预设说明
+ */
+exports.LONG_RUNNING_PRESET_INFO = {
+    name: 'long-running',
+    description: 'Anthropic Long-Running Agents 模式预设',
+    usage: '适用于使用 feature_list.json 和跨 session 追踪的项目',
+    features: [
+        '单功能推进（每次 session 只做一个功能）',
+        '功能拆解（initializer.yml 自动拆解需求）',
+        'E2E 测试（Puppeteer 自动化验证）',
+    ],
+    requires: [
+        'agent-workflows: initializer.yml, coding-agent.yml, puppeteer-test.yml',
+        'agent-runtime: CleanStateManager, PuppeteerTool, PassesGate extension',
+    ],
+};
+//# sourceMappingURL=long-running.js.map

package/dist/presets/long-running.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"long-running.js","sourceRoot":"","sources":["../../src/presets/long-running.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AA0BH,0EAYC;AAnCD,6DAIoC;AAEpC;;;;;;GAMG;AACU,QAAA,mBAAmB,GAAiB;IAC/C,IAAI,EAAE,cAAc;IACpB,QAAQ,EAAE,IAAI,EAAK,aAAa;IAChC,UAAU,EAAE,IAAI,EAAG,aAAa;IAChC,IAAI,EAAE,IAAI,EAAS,OAAO;CAC3B,CAAC;AAEF;;GAEG;AACH,SAAgB,+BAA+B;IAK7C,MAAM,WAAW,GAAG,IAAA,2CAA4B,GAAE,CAAC;IAEnD,OAAO;QACL,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxE,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3E,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChE,CAAC;AACJ,CAAC;AAED;;GAEG;AACU,QAAA,wBAAwB,GAAG;IACtC,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE,oCAAoC;IACjD,KAAK,EAAE,0CAA0C;IACjD,QAAQ,EAAE;QACR,0BAA0B;QAC1B,8BAA8B;QAC9B,yBAAyB;KAC1B;IACD,QAAQ,EAAE;QACR,wEAAwE;QACxE,uEAAuE;KACxE;CACF,CAAC"}

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"