tackle-harness 0.0.5 → 0.0.6

package/bin/tackle.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 /**
  * tackle-harness - CLI entry point for the AI Agent Harness framework
  *

package/package.json

@@ -1,29 +1,29 @@
-{
-  "name": "tackle-harness",
-  "version": "0.0.5",
-  "description": "Plugin-based AI Agent Harness framework for Claude Code",
-  "main": "plugins/runtime/harness-build.js",
-  "bin": {
-    "tackle-harness": "bin/tackle.js"
-  },
-  "files": [
-    "bin/",
-    "plugins/"
-  ],
-  "scripts": {
-    "build": "node bin/tackle.js build",
-    "validate": "node bin/tackle.js validate"
-  },
-  "keywords": [
-    "claude",
-    "claude-code",
-    "agent",
-    "harness",
-    "plugin",
-    "workflow"
-  ],
-  "license": "MIT",
-  "engines": {
-    "node": ">=14.0.0"
-  }
-}
+{
+  "name": "tackle-harness",
+  "version": "0.0.6",
+  "description": "Plugin-based AI Agent Harness framework for Claude Code",
+  "main": "plugins/runtime/harness-build.js",
+  "bin": {
+    "tackle-harness": "bin/tackle.js"
+  },
+  "files": [
+    "bin/",
+    "plugins/"
+  ],
+  "scripts": {
+    "build": "node bin/tackle.js build",
+    "validate": "node bin/tackle.js validate"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "agent",
+    "harness",
+    "plugin",
+    "workflow"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=14.0.0"
+  }
+}

package/plugins/core/provider-watchdog/assets/daemon-config.template.json

@@ -0,0 +1,32 @@
+{
+  "daemon": {
+    "mode": "background"
+  },
+  "heartbeat_dir": ".claude-daemon",
+  "check_interval_sec": 30,
+  "timeouts": {
+    "task_stalled_min": 15,
+    "session_stalled_min": 10,
+    "restart_cooldown_min": 2,
+    "marker_window_min": 5
+  },
+  "retry": {
+    "max_retries": 3,
+    "timeout_scale": [1.0, 1.33, 2.0],
+    "cooldown_min": [0, 2, 5]
+  },
+  "circuit_breaker": {
+    "consecutive_failures_threshold": 3,
+    "total_retries_multiplier": 2,
+    "cooldown_after_break_min": 15
+  },
+  "process": {
+    "kill_timeout_sec": 10,
+    "restart_command": "claude --skill agent-dispatcher"
+  },
+  "logging": {
+    "level": "info",
+    "max_file_size_mb": 10,
+    "max_files": 3
+  }
+}

package/plugins/core/provider-watchdog/assets/lib/config.js

@@ -0,0 +1,170 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+/**
+ * 默认配置模板
+ */
+const DEFAULT_CONFIG = {
+  daemon: {
+    mode: 'background'
+  },
+  heartbeat_dir: '.claude-daemon',
+  check_interval_sec: 30,
+  timeouts: {
+    task_stalled_min: 15,
+    session_stalled_min: 10,
+    restart_cooldown_min: 2,
+    marker_window_min: 5
+  },
+  retry: {
+    max_retries: 3,
+    timeout_scale: [1.0, 1.33, 2.0],
+    cooldown_min: [0, 2, 5]
+  },
+  circuit_breaker: {
+    consecutive_failures_threshold: 3,
+    total_retries_multiplier: 2,
+    cooldown_after_break_min: 15
+  },
+  process: {
+    kill_timeout_sec: 10,
+    restart_command: 'claude --skill agent-dispatcher'
+  },
+  logging: {
+    level: 'info',
+    max_file_size_mb: 10,
+    max_files: 3
+  }
+};
+
+/**
+ * 配置校验规则
+ */
+const VALIDATORS = {
+  daemon: {
+    mode: (val) => ['foreground', 'background'].includes(val)
+  },
+  check_interval_sec: (val) => val > 0,
+  timeouts: {
+    task_stalled_min: (val) => val > 0,
+    session_stalled_min: (val) => val > 0,
+    restart_cooldown_min: (val) => val >= 0,
+    marker_window_min: (val) => val > 0
+  },
+  retry: {
+    max_retries: (val) => val > 0,
+    timeout_scale: (val) => Array.isArray(val) && val.length > 0 && val.every(v => v > 0),
+    cooldown_min: (val) => Array.isArray(val) && val.length > 0 && val.every(v => v >= 0)
+  },
+  circuit_breaker: {
+    consecutive_failures_threshold: (val) => val > 0,
+    total_retries_multiplier: (val) => val > 0,
+    cooldown_after_break_min: (val) => val >= 0
+  },
+  process: {
+    kill_timeout_sec: (val) => val > 0,
+    restart_command: (val) => typeof val === 'string' && val.length > 0
+  },
+  logging: {
+    level: (val) => ['debug', 'info', 'warn', 'error'].includes(val),
+    max_file_size_mb: (val) => val > 0,
+    max_files: (val) => val > 0
+  }
+};
+
+/**
+ * 深度合并对象
+ */
+function deepMerge(target, source) {
+  const result = { ...target };
+
+  for (const key in source) {
+    if (source[key] && typeof source[key] === 'object' && !Array.isArray(source[key])) {
+      result[key] = deepMerge(target[key] || {}, source[key]);
+    } else {
+      result[key] = source[key];
+    }
+  }
+
+  return result;
+}
+
+/**
+ * 校验配置
+ * @param {Object} config - 待校验的配置
+ * @throws {Error} 校验失败时抛出错误
+ */
+function validateConfig(config) {
+  const errors = [];
+
+  function validate(obj, schema, prefix = '') {
+    for (const key in schema) {
+      const fullPath = prefix ? `${prefix}.${key}` : key;
+
+      if (!(key in obj)) {
+        errors.push(`缺少必需字段: ${fullPath}`);
+        continue;
+      }
+
+      const validator = schema[key];
+      const value = obj[key];
+
+      if (typeof validator === 'function') {
+        if (!validator(value)) {
+          errors.push(`字段 ${fullPath} 值无效: ${JSON.stringify(value)}`);
+        }
+      } else if (typeof validator === 'object' && typeof value === 'object' && !Array.isArray(value)) {
+        validate(value, validator, fullPath);
+      }
+    }
+  }
+
+  validate(config, VALIDATORS);
+
+  if (errors.length > 0) {
+    throw new Error('配置校验失败:\n  - ' + errors.join('\n  - '));
+  }
+}
+
+/**
+ * 加载配置文件
+ * @param {string} configPath - 配置文件路径
+ * @returns {Object} 合并后的配置对象
+ */
+function loadConfig(configPath) {
+  let userConfig = {};
+
+  // 尝试读取用户配置文件
+  if (configPath && fs.existsSync(configPath)) {
+    try {
+      const content = fs.readFileSync(configPath, 'utf8');
+      userConfig = JSON.parse(content);
+    } catch (err) {
+      throw new Error(`配置文件解析失败: ${err.message}`);
+    }
+  }
+
+  // 深度合并默认配置和用户配置
+  const config = deepMerge(DEFAULT_CONFIG, userConfig);
+
+  // 校验最终配置
+  validateConfig(config);
+
+  return config;
+}
+
+/**
+ * 获取配置文件模板路径
+ * @returns {string} 模板文件的绝对路径
+ */
+function getTemplatePath() {
+  return path.join(__dirname, '..', 'daemon-config.template.json');
+}
+
+module.exports = {
+  loadConfig,
+  getTemplatePath,
+  DEFAULT_CONFIG
+};