@dommaker/harness 0.16.6 → 0.16.8

package/src/governance/executor.ts

@@ -1,229 +0,0 @@
-/**
- * 治理执行器
- *
- * 检测差异 → 返回结果 → LLM 自行修复
- * harness 只做检测，不做修复
- */
-
-import * as fs from 'fs/promises';
-import * as path from 'path';
-import * as yaml from 'js-yaml';
-import { detectSourceRoots } from '../utils/detect-source-roots';
-import type {
-  GovernanceDiff,
-  GovernanceResult,
-} from './types';
-
-export class GovernanceExecutor {
-  /**
-   * 执行治理检查
-   *
-   * 检测差异并返回结果，不调用 hook，不执行修复
-   * LLM 拿到结果后自行决定如何处理
-   */
-  async check(projectPath: string): Promise<GovernanceResult> {
-    const diffs = await this.detectDiffs(projectPath);
-
-    return {
-      hasDiffs: diffs.length > 0,
-      diffs,
-    };
-  }
-
-  /**
-   * 检测项目中的治理差异
-   */
-  async detectDiffs(projectPath: string): Promise<GovernanceDiff[]> {
-    const diffs: GovernanceDiff[] = [];
-
-    // 1. 检查 CAPABILITIES.md 与源码的差异
-    const capDiffs = await this.checkCapabilitiesSync(projectPath);
-    diffs.push(...capDiffs);
-
-    // 2. 检查 CONTEXT.md
-    const contextDiffs = await this.checkContextFiles(projectPath);
-    diffs.push(...contextDiffs);
-
-    return diffs;
-  }
-
-  /**
-   * 检查 CAPABILITIES.md 与源码是否同步
-   */
-  private async checkCapabilitiesSync(projectPath: string): Promise<GovernanceDiff[]> {
-    const diffs: GovernanceDiff[] = [];
-    const capabilitiesPath = path.join(projectPath, 'CAPABILITIES.md');
-
-    // 读取 CAPABILITIES.md
-    let capContent: string;
-    try {
-      capContent = await fs.readFile(capabilitiesPath, 'utf-8');
-    } catch {
-      // CAPABILITIES.md 不存在
-      return [];
-    }
-
-    // 解析表格中的文件路径
-    const listedFiles = this.parseCapabilitiesFiles(capContent);
-
-    // 如果没有表格，跳过
-    if (listedFiles.length === 0) return [];
-
-    // 扫描所有源码目录中的实际文件
-    const sourceRoots = detectSourceRoots(projectPath);
-    const actualFiles: string[] = [];
-    for (const root of sourceRoots) {
-      const rootDir = path.join(projectPath, root);
-      const files = await this.findSourceFiles(rootDir, projectPath);
-      actualFiles.push(...files);
-    }
-
-    // 找出新增但未列出的文件
-    const missing = actualFiles.filter(f => !listedFiles.includes(f));
-
-    // 找出已列出但已删除的文件
-    const removed = listedFiles.filter(f => !actualFiles.includes(f));
-
-    if (missing.length > 0) {
-      diffs.push({
-        type: 'doc_mismatch',
-        projectPath,
-        details: {
-          file: capabilitiesPath,
-          current: capContent,
-          expected: `新增文件未在 CAPABILITIES.md 中列出: ${missing.join(', ')}`,
-          files: missing,
-          context: { missing, listedFiles, actualFiles },
-        },
-      });
-    }
-
-    if (removed.length > 0) {
-      diffs.push({
-        type: 'doc_mismatch',
-        projectPath,
-        details: {
-          file: capabilitiesPath,
-          current: capContent,
-          expected: `CAPABILITIES.md 中列出的文件已不存在: ${removed.join(', ')}`,
-          files: removed,
-          context: { removed, listedFiles, actualFiles },
-        },
-      });
-    }
-
-    return diffs;
-  }
-
-  /**
-   * 检查 CONTEXT.md 文件
-   */
-  private async checkContextFiles(projectPath: string): Promise<GovernanceDiff[]> {
-    const diffs: GovernanceDiff[] = [];
-    const requiredDirs = await this.getRequiredContextDirs(projectPath);
-
-    for (const dir of requiredDirs) {
-      const contextPath = path.join(projectPath, dir, 'CONTEXT.md');
-
-      try {
-        const content = await fs.readFile(contextPath, 'utf-8');
-
-        // 检查内容是否只是模板（没有实际填写）
-        const isTemplate = content.includes('<!-- 本目录')
-          || content.includes('<!-- 此文件描述');
-
-        if (isTemplate) {
-          diffs.push({
-            type: 'context_outdated',
-            projectPath,
-            details: {
-              file: contextPath,
-              current: content,
-              moduleName: dir,
-              context: { reason: 'CONTEXT.md 仍为模板，未填写实际内容' },
-            },
-          });
-        }
-      } catch {
-        // CONTEXT.md 不存在
-        diffs.push({
-          type: 'context_missing',
-          projectPath,
-          details: {
-            file: contextPath,
-            moduleName: dir,
-            context: { requiredDir: dir },
-          },
-        });
-      }
-    }
-
-    return diffs;
-  }
-
-  /**
-   * 从治理配置获取需要 CONTEXT.md 的目录
-   */
-  private async getRequiredContextDirs(projectPath: string): Promise<string[]> {
-    const configPath = path.join(projectPath, '.harness', 'config.yml');
-    try {
-      const content = await fs.readFile(configPath, 'utf-8');
-      const config = yaml.load(content) as Record<string, unknown>;
-      const governance = config.governance as Record<string, unknown> | undefined;
-      const contextFiles = governance?.context_files as Record<string, unknown> | undefined;
-      if (contextFiles?.enabled && Array.isArray(contextFiles.required_dirs)) {
-        return contextFiles.required_dirs as string[];
-      }
-    } catch {
-      // 配置不存在
-    }
-    return [];
-  }
-
-  /**
-   * 解析 CAPABILITIES.md 中的文件路径
-   */
-  private parseCapabilitiesFiles(content: string): string[] {
-    const files: string[] = [];
-    const tableRowRegex = /^\|[^|]+\|\s*([^|]+?\.(?:ts|tsx|js|jsx))\s*\|/gm;
-    let match;
-    while ((match = tableRowRegex.exec(content)) !== null) {
-      files.push(match[1].trim());
-    }
-    return files;
-  }
-
-  /**
-   * 递归查找源文件
-   */
-  private async findSourceFiles(dir: string, projectPath: string): Promise<string[]> {
-    const results: string[] = [];
-    let entries: string[];
-    try {
-      entries = await fs.readdir(dir);
-    } catch {
-      return [];
-    }
-
-    for (const entry of entries) {
-      if (entry === 'node_modules' || entry === '__tests__' || entry === 'dist') continue;
-      const entryPath = path.join(dir, entry);
-      try {
-        const stat = await fs.stat(entryPath);
-        if (stat.isDirectory()) {
-          results.push(...await this.findSourceFiles(entryPath, projectPath));
-        } else if (entry.endsWith('.ts') && !entry.endsWith('.d.ts') && entry !== 'index.ts') {
-          results.push(path.relative(projectPath, entryPath));
-        }
-      } catch {
-        // ignore
-      }
-    }
-    return results;
-  }
-}
-
-/**
- * 全局治理执行器单例
- */
-export const governanceExecutor = new GovernanceExecutor();

package/src/governance/index.ts

@@ -1,13 +0,0 @@
-/**
- * 治理模块
- *
- * harness 检测差异，LLM 自行修复
- * 只提供检测能力，不提供修复机制
- */
-
-export { GovernanceExecutor, governanceExecutor } from './executor';
-export type {
-  DiffType,
-  GovernanceDiff,
-  GovernanceResult,
-} from './types';

package/src/governance/types.ts

@@ -1,53 +0,0 @@
-/**
- * 治理类型定义
- *
- * harness 检测差异，LLM 自行决定如何修复
- * 不需要 hook 返回内容、不需要 apply 机制
- */
-
-/**
- * 差异类型
- */
-export type DiffType =
-  | 'doc_mismatch'       // 文档内容与代码不一致
-  | 'context_missing'    // 缺少 CONTEXT.md
-  | 'context_outdated'   // CONTEXT.md 内容过时
-  | '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[];
-}

package/src/tools/core/package.json

@@ -1,7 +0,0 @@
-{
-  "name": "core-tools",
-  "description": "Built-in core tools for harness",
-  "dependencies": {
-    "@dommaker/harness": "0.12.13"
-  }
-}

package/src/tools/core/pnpm-lock.yaml

@@ -1,232 +0,0 @@
-lockfileVersion: '9.0'
-
-settings:
-  autoInstallPeers: true
-  excludeLinksFromLockfile: false
-
-importers:
-
-  .:
-    dependencies:
-      '@dommaker/harness':
-        specifier: 0.12.13
-        version: 0.12.13
-
-packages:
-
-  '@dommaker/harness@0.12.13':
-    resolution: {integrity: sha512-rdp4BaFQ2OMe6E5pWBgiE9Skd/f7Vs6FvHxfe2fPxac2BVpQ9cpaYavNNVQL0jDhreZcb2GlaBRDQgG4Nls8XA==}
-    engines: {node: '>=18.0.0'}
-    hasBin: true
-
-  '@nodelib/fs.scandir@2.1.5':
-    resolution: {integrity: sha512-vq24Bq3ym5HEQm2NKCr3yXDwjc7vTsEThRDnkp2DK9p1uqLR+DHurm/NOTo0KG7HYHU7eppKZj3MyqYuMBf62g==}
-    engines: {node: '>= 8'}
-
-  '@nodelib/fs.stat@2.0.5':
-    resolution: {integrity: sha512-RkhPPp2zrqDAQA/2jNhnztcPAlv64XdhIp7a7454A5ovI7Bukxgt7MX7udwAu3zg1DcpPU0rz3VV1SeaqvY4+A==}
-    engines: {node: '>= 8'}
-
-  '@nodelib/fs.walk@1.2.8':
-    resolution: {integrity: sha512-oGB+UxlgWcgQkgwo8GcEGwemoTFt3FIO9ababBmaGwXIoBKZ+GTy0pP185beGg7Llih/NSHSV2XAs1lnznocSg==}
-    engines: {node: '>= 8'}
-
-  ansi-styles@4.3.0:
-    resolution: {integrity: sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==}
-    engines: {node: '>=8'}
-
-  argparse@2.0.1:
-    resolution: {integrity: sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==}
-
-  braces@3.0.3:
-    resolution: {integrity: sha512-yQbXgO/OSZVD2IsiLlro+7Hf6Q18EJrKSEsdoMzKePKXct3gvD8oLcOQdIzGupr5Fj+EDe8gO/lxc1BzfMpxvA==}
-    engines: {node: '>=8'}
-
-  chalk@4.1.2:
-    resolution: {integrity: sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==}
-    engines: {node: '>=10'}
-
-  color-convert@2.0.1:
-    resolution: {integrity: sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==}
-    engines: {node: '>=7.0.0'}
-
-  color-name@1.1.4:
-    resolution: {integrity: sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==}
-
-  commander@12.1.0:
-    resolution: {integrity: sha512-Vw8qHK3bZM9y/P10u3Vib8o/DdkvA2OtPtZvD871QKjy74Wj1WSKFILMPRPSdUSx5RFK1arlJzEtA4PkFgnbuA==}
-    engines: {node: '>=18'}
-
-  fast-glob@3.3.3:
-    resolution: {integrity: sha512-7MptL8U0cqcFdzIzwOTHoilX9x5BrNqye7Z/LuC7kCMRio1EMSyqRK3BEAUD7sXRq4iT4AzTVuZdhgQ2TCvYLg==}
-    engines: {node: '>=8.6.0'}
-
-  fastq@1.20.1:
-    resolution: {integrity: sha512-GGToxJ/w1x32s/D2EKND7kTil4n8OVk/9mycTc4VDza13lOvpUZTGX3mFSCtV9ksdGBVzvsyAVLM6mHFThxXxw==}
-
-  fill-range@7.1.1:
-    resolution: {integrity: sha512-YsGpe3WHLK8ZYi4tWDg2Jy3ebRz2rXowDxnld4bkQB00cc/1Zw9AWnC0i9ztDJitivtQvaI9KaLyKrc+hBW0yg==}
-    engines: {node: '>=8'}
-
-  glob-parent@5.1.2:
-    resolution: {integrity: sha512-AOIgSQCepiJYwP3ARnGx+5VnTu2HBYdzbGP45eLw1vr3zB3vZLeyed1sC9hnbcOc9/SrMyM5RPQrkGz4aS9Zow==}
-    engines: {node: '>= 6'}
-
-  has-flag@4.0.0:
-    resolution: {integrity: sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==}
-    engines: {node: '>=8'}
-
-  is-extglob@2.1.1:
-    resolution: {integrity: sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ==}
-    engines: {node: '>=0.10.0'}
-
-  is-glob@4.0.3:
-    resolution: {integrity: sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==}
-    engines: {node: '>=0.10.0'}
-
-  is-number@7.0.0:
-    resolution: {integrity: sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==}
-    engines: {node: '>=0.12.0'}
-
-  js-yaml@4.1.1:
-    resolution: {integrity: sha512-qQKT4zQxXl8lLwBtHMWwaTcGfFOZviOJet3Oy/xmGk2gZH677CJM9EvtfdSkgWcATZhj/55JZ0rmy3myCT5lsA==}
-    hasBin: true
-
-  merge2@1.4.1:
-    resolution: {integrity: sha512-8q7VEgMJW4J8tcfVPy8g09NcQwZdbwFEqhe/WZkoIzjn/3TGDwtOCYtXGxA3O8tPzpczCCDgv+P2P5y00ZJOOg==}
-    engines: {node: '>= 8'}
-
-  micromatch@4.0.8:
-    resolution: {integrity: sha512-PXwfBhYu0hBCPw8Dn0E+WDYb7af3dSLVWKi3HGv84IdF4TyFoC0ysxFd0Goxw7nSv4T/PzEJQxsYsEiFCKo2BA==}
-    engines: {node: '>=8.6'}
-
-  picomatch@2.3.2:
-    resolution: {integrity: sha512-V7+vQEJ06Z+c5tSye8S+nHUfI51xoXIXjHQ99cQtKUkQqqO1kO/KCJUfZXuB47h/YBlDhah2H3hdUGXn8ie0oA==}
-    engines: {node: '>=8.6'}
-
-  queue-microtask@1.2.3:
-    resolution: {integrity: sha512-NuaNSa6flKT5JaSYQzJok04JzTL1CA6aGhv5rfLW3PgqA+M2ChpZQnAC8h8i4ZFkBS8X5RqkDBHA7r4hej3K9A==}
-
-  reusify@1.1.0:
-    resolution: {integrity: sha512-g6QUff04oZpHs0eG5p83rFLhHeV00ug/Yf9nZM6fLeUrPguBTkTQOdpAWWspMh55TZfVQDPaN3NQJfbVRAxdIw==}
-    engines: {iojs: '>=1.0.0', node: '>=0.10.0'}
-
-  run-parallel@1.2.0:
-    resolution: {integrity: sha512-5l4VyZR86LZ/lDxZTR6jqL8AFE2S0IFLMP26AbjsLVADxHdhB/c0GUsH+y39UfCi3dzz8OlQuPmnaJOMoDHQBA==}
-
-  supports-color@7.2.0:
-    resolution: {integrity: sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==}
-    engines: {node: '>=8'}
-
-  to-regex-range@5.0.1:
-    resolution: {integrity: sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ==}
-    engines: {node: '>=8.0'}
-
-  zod@3.25.76:
-    resolution: {integrity: sha512-gzUt/qt81nXsFGKIFcC3YnfEAx5NkunCfnDlvuBSSFS02bcXu4Lmea0AFIUwbLWxWPx3d9p8S5QoaujKcNQxcQ==}
-
-snapshots:
-
-  '@dommaker/harness@0.12.13':
-    dependencies:
-      chalk: 4.1.2
-      commander: 12.1.0
-      fast-glob: 3.3.3
-      js-yaml: 4.1.1
-      zod: 3.25.76
-
-  '@nodelib/fs.scandir@2.1.5':
-    dependencies:
-      '@nodelib/fs.stat': 2.0.5
-      run-parallel: 1.2.0
-
-  '@nodelib/fs.stat@2.0.5': {}
-
-  '@nodelib/fs.walk@1.2.8':
-    dependencies:
-      '@nodelib/fs.scandir': 2.1.5
-      fastq: 1.20.1
-
-  ansi-styles@4.3.0:
-    dependencies:
-      color-convert: 2.0.1
-
-  argparse@2.0.1: {}
-
-  braces@3.0.3:
-    dependencies:
-      fill-range: 7.1.1
-
-  chalk@4.1.2:
-    dependencies:
-      ansi-styles: 4.3.0
-      supports-color: 7.2.0
-
-  color-convert@2.0.1:
-    dependencies:
-      color-name: 1.1.4
-
-  color-name@1.1.4: {}
-
-  commander@12.1.0: {}
-
-  fast-glob@3.3.3:
-    dependencies:
-      '@nodelib/fs.stat': 2.0.5
-      '@nodelib/fs.walk': 1.2.8
-      glob-parent: 5.1.2
-      merge2: 1.4.1
-      micromatch: 4.0.8
-
-  fastq@1.20.1:
-    dependencies:
-      reusify: 1.1.0
-
-  fill-range@7.1.1:
-    dependencies:
-      to-regex-range: 5.0.1
-
-  glob-parent@5.1.2:
-    dependencies:
-      is-glob: 4.0.3
-
-  has-flag@4.0.0: {}
-
-  is-extglob@2.1.1: {}
-
-  is-glob@4.0.3:
-    dependencies:
-      is-extglob: 2.1.1
-
-  is-number@7.0.0: {}
-
-  js-yaml@4.1.1:
-    dependencies:
-      argparse: 2.0.1
-
-  merge2@1.4.1: {}
-
-  micromatch@4.0.8:
-    dependencies:
-      braces: 3.0.3
-      picomatch: 2.3.2
-
-  picomatch@2.3.2: {}
-
-  queue-microtask@1.2.3: {}
-
-  reusify@1.1.0: {}
-
-  run-parallel@1.2.0:
-    dependencies:
-      queue-microtask: 1.2.3
-
-  supports-color@7.2.0:
-    dependencies:
-      has-flag: 4.0.0
-
-  to-regex-range@5.0.1:
-    dependencies:
-      is-number: 7.0.0
-
-  zod@3.25.76: {}

package/src/types/iron-law.ts

@@ -1,50 +0,0 @@
-/**
- * 铁律类型定义
- * 
- * @deprecated 请使用 './constraint' 代替
- * 
- * 此模块保留用于向后兼容。
- * 新代码应使用三层约束类型：
- * - Constraint
- * - ConstraintLevel ('iron_law' | 'guideline' | 'tip')
- */
-
-import type {
-  ConstraintId,
-  ConstraintLevel,
-  ConstraintTrigger,
-  Constraint,
-  ConstraintResult,
-  ConstraintContext,
-} from './constraint';
-
-import { ConstraintViolationError } from './constraint';
-
-// 重新导出新的约束类型
-export type {
-  ConstraintId as IronLawId,
-  ConstraintLevel,
-  ConstraintTrigger as IronLawTrigger,
-  Constraint as IronLaw,
-  ConstraintResult as IronLawResult,
-  ConstraintContext as IronLawContext,
-} from './constraint';
-
-export {
-  ConstraintViolationError as IronLawViolationError,
-} from './constraint';
-
-// 向后兼容的 severity 类型
-export type IronLawSeverity = 'error' | 'warning' | 'info';
-
-// 向后兼容的配置类型
-export interface IronLawConfig {
-  /** @deprecated */
-  ironLaws: Constraint[];
-  /** @deprecated */
-  preset?: 'strict' | 'standard' | 'relaxed';
-  /** @deprecated */
-  enabled?: boolean;
-  /** @deprecated */
-  configPath?: string;
-}