tackle-harness 0.0.2

package/plugins/core/validator-doc-sync/index.js

@@ -0,0 +1,248 @@
+/**
+ * validator-doc-sync - 文档同步验证器
+ *
+ * 检测 task.md 与 docs/wp/ 目录之间的不一致：
+ *   - task.md 中列出但 docs/wp/ 中缺少的 WP 文档
+ *   - docs/wp/ 中存在但 task.md 未列出的 WP 文档
+ *   - 状态不一致（task.md 标记完成但 WP 文档内容为空等）
+ *
+ * 使用方式：
+ *   var Validator = require('./index.js');
+ *   var v = new Validator({ projectRoot: '/path/to/project' });
+ *   var result = v.validate();  // { valid, errors, warnings }
+ */
+
+'use strict';
+
+var fs = require('fs');
+var path = require('path');
+var { ValidatorPlugin } = require('../../contracts/plugin-interface');
+
+/**
+ * WP 编号正则：匹配 task.md 表格行中的 WP-NNN
+ */
+var WP_TABLE_ROW_RE = /^\|\s*(WP-\d+)\s*\|/;
+
+/**
+ * 状态标记正则
+ */
+var STATUS_COMPLETE_RE = /✅\s*完成/;
+var STATUS_IN_PROGRESS_RE = /🔄\s*进行中/;
+var STATUS_PENDING_RE = /📋\s*待开始/;
+
+/**
+ * 从 task.md 提取状态标记
+ */
+function parseStatus(statusCell) {
+  if (STATUS_COMPLETE_RE.test(statusCell)) return 'completed';
+  if (STATUS_IN_PROGRESS_RE.test(statusCell)) return 'in-progress';
+  if (STATUS_PENDING_RE.test(statusCell)) return 'pending';
+  return 'unknown';
+}
+
+/**
+ * 检查文件内容是否实质为空
+ * 除去空白、标题行、YAML front matter 后内容极少视为空
+ */
+function isContentEmpty(content) {
+  if (!content) return true;
+
+  // 去除 YAML front matter
+  var body = content.replace(/^---[\s\S]*?---\n*/, '');
+  // 去除 markdown 标题和分隔线
+  body = body.replace(/^#{1,6}\s+.*$/gm, '');
+  body = body.replace(/^---+$/gm, '');
+  body = body.replace(/^>.*$/gm, '');
+  // 去除纯空白行
+  var lines = body.split('\n').filter(function (line) {
+    return line.trim().length > 0;
+  });
+
+  return lines.length < 3;
+}
+
+/**
+ * DocSyncValidator
+ */
+class DocSyncValidator extends ValidatorPlugin {
+  /**
+   * @param {object} [options]
+   * @param {string} [options.projectRoot] - 项目根目录，默认 process.cwd()
+   */
+  constructor(options) {
+    super();
+    options = options || {};
+
+    this.name = 'validator-doc-sync';
+    this.version = '1.0.0';
+    this.description = '文档同步验证器';
+    this.blocking = false;
+
+    /** @type {string} */
+    this._projectRoot = options.projectRoot || process.cwd();
+    /** @type {string} */
+    this._taskMdPath = path.join(this._projectRoot, 'task.md');
+    /** @type {string} */
+    this._docsWpDir = path.join(this._projectRoot, 'docs', 'wp');
+  }
+
+  /**
+   * 解析 task.md，提取所有 WP 条目及其状态
+   * @returns {Array<{id: string, status: string, rawStatus: string}>}
+   */
+  parseTaskMd() {
+    var content = this._readFile(this._taskMdPath);
+    if (content === null) return [];
+
+    var entries = [];
+    var lines = content.split('\n');
+
+    for (var i = 0; i < lines.length; i++) {
+      var match = WP_TABLE_ROW_RE.exec(lines[i]);
+      if (match) {
+        // 拆分表格单元格
+        var cells = lines[i].split('|').filter(function (c) { return c.trim().length > 0; });
+        var rawStatus = cells.length >= 2 ? cells[1].trim() : '';
+        // cells[0] 是 WP ID, cells[1] 是标题, cells[2] 是状态
+        // 实际格式：| WP-NNN | 标题 | 状态 | ...
+        rawStatus = cells.length >= 3 ? cells[2].trim() : (cells.length >= 2 ? cells[1].trim() : '');
+
+        entries.push({
+          id: match[1],
+          status: parseStatus(rawStatus),
+          rawStatus: rawStatus,
+        });
+      }
+    }
+
+    return entries;
+  }
+
+  /**
+   * 扫描 docs/wp/ 目录，返回存在的 WP 文件列表
+   * @returns {string[]} WP ID 列表，如 ['WP-001', 'WP-002']
+   */
+  scanDocsWp() {
+    var entries = [];
+    var files = this._readdir(this._docsWpDir);
+
+    for (var i = 0; i < files.length; i++) {
+      var match = /^(WP-\d+)\.md$/i.exec(files[i]);
+      if (match) {
+        entries.push(match[1].toUpperCase());
+      }
+    }
+
+    return entries;
+  }
+
+  /**
+   * 执行文档同步验证
+   * @param {object} [context] - 验证上下文（保留兼容接口）
+   * @returns {{ valid: boolean, errors: string[], warnings: string[] }}
+   */
+  validate(context) {
+    var errors = [];
+    var warnings = [];
+
+    // 1. 检查 task.md 可读
+    var taskEntries = this.parseTaskMd();
+    if (taskEntries.length === 0) {
+      // 尝试读取原始文件判断是真的空还是读不到
+      var rawContent = this._readFile(this._taskMdPath);
+      if (rawContent === null) {
+        errors.push('task.md 文件不存在或无法读取: ' + this._taskMdPath);
+        return { valid: false, errors: errors, warnings: warnings };
+      }
+      // 文件存在但解析不出 WP 条目
+      warnings.push('task.md 中未找到工作包条目');
+      return { valid: true, errors: errors, warnings: warnings };
+    }
+
+    // 2. 检查 docs/wp/ 目录可读
+    var docFiles = this.scanDocsWp();
+
+    // 3. 构建索引集合
+    var taskMap = {};
+    for (var i = 0; i < taskEntries.length; i++) {
+      taskMap[taskEntries[i].id] = taskEntries[i];
+    }
+    var docSet = {};
+    for (var j = 0; j < docFiles.length; j++) {
+      docSet[docFiles[j]] = true;
+    }
+
+    // 4. task.md 中有但 docs/wp/ 缺少的 WP
+    for (var k = 0; k < taskEntries.length; k++) {
+      var id = taskEntries[k].id;
+      if (!docSet[id]) {
+        errors.push(id + ' 在 task.md 中列出但 docs/wp/ 中缺少对应文档');
+      }
+    }
+
+    // 5. docs/wp/ 中有但 task.md 未列出的 WP
+    for (var m = 0; m < docFiles.length; m++) {
+      var docId = docFiles[m];
+      if (!taskMap[docId]) {
+        warnings.push(docId + ' 在 docs/wp/ 中存在但 task.md 未列出');
+      }
+    }
+
+    // 6. 状态不一致检测：task.md 标记完成但 WP 文档内容为空
+    for (var n = 0; n < taskEntries.length; n++) {
+      var entry = taskEntries[n];
+      if (entry.status === 'completed' && docSet[entry.id]) {
+        var wpPath = path.join(this._docsWpDir, entry.id + '.md');
+        var wpContent = this._readFile(wpPath);
+        if (wpContent !== null && isContentEmpty(wpContent)) {
+          errors.push(entry.id + ' 在 task.md 中标记为已完成，但 WP 文档内容实质为空');
+        }
+      }
+
+      // task.md 标记待开始但 WP 文档内容丰富（可能忘记更新状态）
+      if (entry.status === 'pending' && docSet[entry.id]) {
+        var wpPendingPath = path.join(this._docsWpDir, entry.id + '.md');
+        var wpPendingContent = this._readFile(wpPendingPath);
+        if (wpPendingContent !== null && !isContentEmpty(wpPendingContent)) {
+          warnings.push(entry.id + ' 在 task.md 中标记为待开始，但 WP 文档已有实质内容，可能需要更新状态');
+        }
+      }
+    }
+
+    return {
+      valid: errors.length === 0,
+      errors: errors,
+      warnings: warnings,
+    };
+  }
+
+  // --- internal helpers ---
+
+  /**
+   * 同步读取文件，失败返回 null
+   * @param {string} filePath
+   * @returns {string|null}
+   */
+  _readFile(filePath) {
+    try {
+      return fs.readFileSync(filePath, 'utf-8');
+    } catch (err) {
+      return null;
+    }
+  }
+
+  /**
+   * 同步读取目录，失败返回空数组
+   * @param {string} dirPath
+   * @returns {string[]}
+   */
+  _readdir(dirPath) {
+    try {
+      return fs.readdirSync(dirPath);
+    } catch (err) {
+      return [];
+    }
+  }
+}
+
+module.exports = DocSyncValidator;

package/plugins/core/validator-doc-sync/plugin.json

@@ -0,0 +1,9 @@
+{
+  "name": "validator-doc-sync",
+  "version": "1.0.0",
+  "type": "validator",
+  "description": "文档同步验证器 - 检测 task.md 与 docs/wp/ 的不一致",
+  "dependencies": [],
+  "provides": ["validator:doc-sync"],
+  "config": {}
+}

package/plugins/core/validator-work-package/index.js

@@ -0,0 +1,300 @@
+/**
+ * validator-work-package - 工作包文档验证器
+ *
+ * 检测 WP 文档结构缺陷和依赖有效性：
+ *   - 验证必要章节（目标、验收标准、关键文件）
+ *   - 验证依赖关系引用的 WP 是否存在
+ *   - validate(wpPath) 验证单个 WP 文档
+ *   - validateAll() 验证所有 WP 文档
+ *
+ * 使用方式：
+ *   var Validator = require('./index.js');
+ *   var v = new Validator({ projectRoot: '/path/to/project' });
+ *   var result = v.validate('/path/to/WP-001.md');
+ *   var allResult = v.validateAll();
+ */
+
+'use strict';
+
+var fs = require('fs');
+var path = require('path');
+var { ValidatorPlugin } = require('../../contracts/plugin-interface');
+
+/**
+ * WP 文档必要章节定义
+ * 每个 WP 文档应包含这些章节标题（二级标题 ## 或更高级别）
+ */
+var REQUIRED_SECTIONS = [
+  { id: 'goal', patterns: [/^#{1,6}\s*目标/m, /^#{1,6}\s*Goal/im] },
+  { id: 'acceptance', patterns: [/^#{1,6}\s*验收标准/m, /^#{1,6}\s*Acceptance/im] },
+  { id: 'keyfiles', patterns: [/^#{1,6}\s*关键文件/m, /^#{1,6}\s*Key\s*Files/im] },
+];
+
+/**
+ * 依赖关系提取正则
+ * 匹配 "依赖: WP-001, WP-002" 或 "依赖: 无" 或 "Dependencies: ..."
+ */
+var DEPS_LINE_RE = /^>\s*依赖[：:]\s*(.+)$/m;
+var DEPS_LINE_ALT_RE = /^\*?\*?依赖\*?\*?[：:]\s*(.+)$/m;
+
+/**
+ * WP ID 提取正则
+ */
+var WP_ID_RE = /WP-\d+/gi;
+
+/**
+ * WorkPackageValidator
+ */
+class WorkPackageValidator extends ValidatorPlugin {
+  /**
+   * @param {object} [options]
+   * @param {string} [options.projectRoot] - 项目根目录，默认 process.cwd()
+   */
+  constructor(options) {
+    super();
+    options = options || {};
+
+    this.name = 'validator-work-package';
+    this.version = '1.0.0';
+    this.description = '工作包文档验证器';
+    this.blocking = false;
+
+    /** @type {string} */
+    this._projectRoot = options.projectRoot || process.cwd();
+    /** @type {string} */
+    this._docsWpDir = path.join(this._projectRoot, 'docs', 'wp');
+    /** @type {string|null} */
+    this._taskMdPath = path.join(this._projectRoot, 'task.md');
+  }
+
+  /**
+   * 获取所有已知 WP ID（从 docs/wp/ 目录和 task.md 收集）
+   * @returns {Set<string>}
+   */
+  _getKnownWpIds() {
+    var ids = new Set();
+
+    // 从 docs/wp/ 目录
+    var files = this._readdir(this._docsWpDir);
+    for (var i = 0; i < files.length; i++) {
+      var match = /^(WP-\d+)\.md$/i.exec(files[i]);
+      if (match) {
+        ids.add(match[1].toUpperCase());
+      }
+    }
+
+    return ids;
+  }
+
+  /**
+   * 从 WP 文档内容中提取依赖的 WP ID
+   * @param {string} content
+   * @returns {string[]}
+   */
+  _extractDependencies(content) {
+    var deps = [];
+
+    // 尝试匹配依赖行
+    var match = DEPS_LINE_RE.exec(content) || DEPS_LINE_ALT_RE.exec(content);
+    if (match) {
+      var depStr = match[1].trim();
+      if (depStr === '无' || depStr === '-' || depStr === 'none') {
+        return [];
+      }
+
+      var ids = depStr.match(WP_ID_RE);
+      if (ids) {
+        for (var i = 0; i < ids.length; i++) {
+          deps.push(ids[i].toUpperCase());
+        }
+      }
+    }
+
+    // 也检查依赖图或表格中的引用（mermaid 语法）
+    var mermaidBlock = /```mermaid[\s\S]*?```/g.exec(content);
+    if (mermaidBlock) {
+      var mermaidDeps = mermaidBlock[0].match(/WP-\d+/gi);
+      if (mermaidDeps) {
+        for (var j = 0; j < mermaidDeps.length; j++) {
+          var id = mermaidDeps[j].toUpperCase();
+          if (deps.indexOf(id) === -1) {
+            deps.push(id);
+          }
+        }
+      }
+    }
+
+    return deps;
+  }
+
+  /**
+   * 检查文档中是否包含指定章节
+   * @param {string} content
+   * @param {{ id: string, patterns: RegExp[] }} section
+   * @returns {boolean}
+   */
+  _hasSection(content, section) {
+    for (var i = 0; i < section.patterns.length; i++) {
+      if (section.patterns[i].test(content)) {
+        return true;
+      }
+    }
+    return false;
+  }
+
+  /**
+   * 验证单个 WP 文档
+   * @param {string} wpPath - WP 文档的完整路径，或 WP ID (如 "WP-001")
+   * @param {object} [context] - 验证上下文（保留兼容接口）
+   * @returns {{ valid: boolean, errors: string[], warnings: string[] }}
+   */
+  validate(wpPath, context) {
+    var errors = [];
+    var warnings = [];
+
+    // 支持 WP ID 简写
+    var filePath = wpPath;
+    if (/^WP-\d+$/i.test(wpPath)) {
+      filePath = path.join(this._docsWpDir, wpPath.toUpperCase() + '.md');
+    }
+
+    var wpId = path.basename(filePath, '.md').toUpperCase();
+    var content = this._readFile(filePath);
+
+    if (content === null) {
+      errors.push(wpId + ' 文档文件不存在或无法读取: ' + filePath);
+      return { valid: false, errors: errors, warnings: warnings };
+    }
+
+    // 1. 检查必要章节
+    for (var i = 0; i < REQUIRED_SECTIONS.length; i++) {
+      var section = REQUIRED_SECTIONS[i];
+      if (!this._hasSection(content, section)) {
+        errors.push(wpId + ' 缺少必要章节: ' + section.id);
+      }
+    }
+
+    // 2. 检查依赖关系有效性
+    var deps = this._extractDependencies(content);
+    if (deps.length > 0) {
+      var knownIds = this._getKnownWpIds();
+
+      for (var j = 0; j < deps.length; j++) {
+        // 跳过自引用
+        if (deps[j] === wpId) {
+          warnings.push(wpId + ' 依赖关系中包含自引用');
+          continue;
+        }
+        if (!knownIds.has(deps[j])) {
+          errors.push(wpId + ' 引用了不存在的依赖: ' + deps[j]);
+        }
+      }
+    }
+
+    // 3. 额外结构检查
+
+    // 检查是否有预估时间
+    if (!/预估时间|Estimated\s*Time/i.test(content)) {
+      warnings.push(wpId + ' 缺少预估时间章节');
+    }
+
+    // 检查验收标准是否有复选框条目
+    if (/验收标准/.test(content)) {
+      var acceptanceSection = content.split(/#{1,6}\s*验收标准/)[1];
+      if (acceptanceSection) {
+        // 取到下一个章节标题之前
+        var nextSection = acceptanceSection.split(/^#{1,6}\s/m)[0];
+        if (nextSection && !/^\s*- \[[ x]\]/m.test(nextSection) && !/^\s*\[[ x]\]/m.test(nextSection)) {
+          warnings.push(wpId + ' 验收标准中未发现复选框条目，建议使用 - [ ] 格式列出验收项');
+        }
+      }
+    }
+
+    return {
+      valid: errors.length === 0,
+      errors: errors,
+      warnings: warnings,
+    };
+  }
+
+  /**
+   * 验证所有 WP 文档
+   * @param {object} [context] - 验证上下文（保留兼容接口）
+   * @returns {{ valid: boolean, errors: string[], warnings: string[], results: object }}
+   */
+  validateAll(context) {
+    var allErrors = [];
+    var allWarnings = [];
+    var perFile = {};
+
+    var files = this._readdir(this._docsWpDir);
+    var wpFiles = [];
+
+    for (var i = 0; i < files.length; i++) {
+      if (/^WP-\d+\.md$/i.test(files[i])) {
+        wpFiles.push(files[i]);
+      }
+    }
+
+    if (wpFiles.length === 0) {
+      allWarnings.push('docs/wp/ 目录下未找到任何 WP 文档');
+      return {
+        valid: true,
+        errors: allErrors,
+        warnings: allWarnings,
+        results: perFile,
+      };
+    }
+
+    for (var j = 0; j < wpFiles.length; j++) {
+      var filePath = path.join(this._docsWpDir, wpFiles[j]);
+      var result = this.validate(filePath);
+      var wpId = path.basename(filePath, '.md').toUpperCase();
+      perFile[wpId] = result;
+
+      for (var k = 0; k < result.errors.length; k++) {
+        allErrors.push(result.errors[k]);
+      }
+      for (var m = 0; m < result.warnings.length; m++) {
+        allWarnings.push(result.warnings[m]);
+      }
+    }
+
+    return {
+      valid: allErrors.length === 0,
+      errors: allErrors,
+      warnings: allWarnings,
+      results: perFile,
+    };
+  }
+
+  // --- internal helpers ---
+
+  /**
+   * 同步读取文件，失败返回 null
+   * @param {string} filePath
+   * @returns {string|null}
+   */
+  _readFile(filePath) {
+    try {
+      return fs.readFileSync(filePath, 'utf-8');
+    } catch (err) {
+      return null;
+    }
+  }
+
+  /**
+   * 同步读取目录，失败返回空数组
+   * @param {string} dirPath
+   * @returns {string[]}
+   */
+  _readdir(dirPath) {
+    try {
+      return fs.readdirSync(dirPath);
+    } catch (err) {
+      return [];
+    }
+  }
+}
+
+module.exports = WorkPackageValidator;

package/plugins/core/validator-work-package/plugin.json

@@ -0,0 +1,9 @@
+{
+  "name": "validator-work-package",
+  "version": "1.0.0",
+  "type": "validator",
+  "description": "工作包文档验证器 - 检测 WP 文档结构缺陷和依赖有效性",
+  "dependencies": [],
+  "provides": ["validator:work-package"],
+  "config": {}
+}

package/plugins/plugin-registry.json

@@ -0,0 +1,118 @@
+{
+  "version": "1.0.0",
+  "plugins": [
+    {
+      "name": "provider-state-store",
+      "source": "provider-state-store",
+      "enabled": true,
+      "config": {}
+    },
+    {
+      "name": "provider-role-registry",
+      "source": "provider-role-registry",
+      "enabled": true,
+      "config": {}
+    },
+    {
+      "name": "provider-memory-store",
+      "source": "provider-memory-store",
+      "enabled": true,
+      "config": {}
+    },
+    {
+      "name": "validator-doc-sync",
+      "source": "validator-doc-sync",
+      "enabled": true,
+      "config": {}
+    },
+    {
+      "name": "validator-work-package",
+      "source": "validator-work-package",
+      "enabled": true,
+      "config": {}
+    },
+    {
+      "name": "hook-skill-gate",
+      "source": "hook-skill-gate",
+      "enabled": true,
+      "config": {
+        "gatedSkills": [],
+        "blockedStates": [
+          "waiting"
+        ]
+      }
+    },
+    {
+      "name": "skill-task-creator",
+      "source": "skill-task-creator",
+      "enabled": true,
+      "config": {}
+    },
+    {
+      "name": "skill-batch-task-creator",
+      "source": "skill-batch-task-creator",
+      "enabled": true,
+      "config": {}
+    },
+    {
+      "name": "skill-split-work-package",
+      "source": "skill-split-work-package",
+      "enabled": true,
+      "config": {}
+    },
+    {
+      "name": "skill-progress-tracker",
+      "source": "skill-progress-tracker",
+      "enabled": true,
+      "config": {}
+    },
+    {
+      "name": "skill-team-cleanup",
+      "source": "skill-team-cleanup",
+      "enabled": true,
+      "config": {}
+    },
+    {
+      "name": "skill-human-checkpoint",
+      "source": "skill-human-checkpoint",
+      "enabled": true,
+      "config": {}
+    },
+    {
+      "name": "skill-role-manager",
+      "source": "skill-role-manager",
+      "enabled": true,
+      "config": {}
+    },
+    {
+      "name": "skill-checklist",
+      "source": "skill-checklist",
+      "enabled": true,
+      "config": {}
+    },
+    {
+      "name": "skill-completion-report",
+      "source": "skill-completion-report",
+      "enabled": true,
+      "config": {}
+    },
+    {
+      "name": "skill-experience-logger",
+      "source": "skill-experience-logger",
+      "enabled": true,
+      "config": {}
+    },
+    {
+      "name": "skill-agent-dispatcher",
+      "source": "skill-agent-dispatcher",
+      "enabled": true,
+      "config": {}
+    },
+    {
+      "name": "skill-workflow-orchestrator",
+      "source": "skill-workflow-orchestrator",
+      "enabled": true,
+      "config": {}
+    }
+  ]
+}