@dommaker/harness 0.1.0

package/dist/cli/commands/report.js

@@ -0,0 +1,205 @@
+"use strict";
+/**
+ * harness report 命令
+ *
+ * 生成检查报告
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.report = report;
+const chalk_1 = __importDefault(require("chalk"));
+const fs = __importStar(require("fs/promises"));
+/**
+ * 生成检查报告
+ */
+async function report(options) {
+    console.log(chalk_1.default.blue('📊 生成检查报告...'));
+    const projectPath = options.projectPath || process.cwd();
+    // TODO: 从实际检查中获取数据
+    const reportData = {
+        timestamp: new Date().toISOString(),
+        projectPath,
+        ironLaws: {
+            total: 11,
+            passed: 11,
+            failed: 0,
+            warnings: 0,
+            violations: [],
+        },
+        checkpoints: {
+            total: 0,
+            passed: 0,
+            failed: 0,
+            results: [],
+        },
+        passesGate: {
+            passed: true,
+            totalTests: 0,
+            passedTests: 0,
+            failedTests: 0,
+        },
+    };
+    // 生成报告内容
+    let content;
+    switch (options.format) {
+        case 'json':
+            content = JSON.stringify(reportData, null, 2);
+            break;
+        case 'markdown':
+            content = generateMarkdownReport(reportData);
+            break;
+        case 'html':
+            content = generateHtmlReport(reportData);
+            break;
+        default:
+            content = JSON.stringify(reportData, null, 2);
+    }
+    // 输出到文件或控制台
+    if (options.output) {
+        await fs.writeFile(options.output, content, 'utf-8');
+        console.log(chalk_1.default.green(`✅ 报告已保存到: ${options.output}`));
+    }
+    else {
+        console.log(content);
+    }
+}
+/**
+ * 生成 Markdown 格式报告
+ */
+function generateMarkdownReport(data) {
+    const lines = [
+        `# Harness 检查报告`,
+        ``,
+        `> 生成时间: ${data.timestamp}`,
+        `> 项目路径: ${data.projectPath}`,
+        ``,
+        `---`,
+        ``,
+        `## 📜 铁律检查`,
+        ``,
+        `| 指标 | 数值 |`,
+        `|------|------|`,
+        `| 总数 | ${data.ironLaws.total} |`,
+        `| 通过 | ${data.ironLaws.passed} |`,
+        `| 失败 | ${data.ironLaws.failed} |`,
+        `| 警告 | ${data.ironLaws.warnings} |`,
+        ``,
+    ];
+    if (data.ironLaws.violations.length > 0) {
+        lines.push(`### 违规项`, ``);
+        data.ironLaws.violations.forEach(v => {
+            lines.push(`- **${v.id}** (${v.severity}): ${v.message}`);
+        });
+        lines.push(``);
+    }
+    lines.push(`## 🔍 检查点验证`, ``, `| 指标 | 数值 |`, `|------|------|`, `| 总数 | ${data.checkpoints.total} |`, `| 通过 | ${data.checkpoints.passed} |`, `| 失败 | ${data.checkpoints.failed} |`, ``);
+    if (data.checkpoints.results.length > 0) {
+        lines.push(`### 检查点详情`, ``);
+        data.checkpoints.results.forEach(r => {
+            const icon = r.passed ? '✅' : '❌';
+            lines.push(`- ${icon} **${r.id}**: ${r.checks} 项检查`);
+        });
+        lines.push(``);
+    }
+    lines.push(`## 🚦 测试门控`, ``, `| 指标 | 数值 |`, `|------|------|`, `| 状态 | ${data.passesGate.passed ? '✅ 通过' : '❌ 未通过'} |`, `| 总测试 | ${data.passesGate.totalTests} |`, `| 通过 | ${data.passesGate.passedTests} |`, `| 失败 | ${data.passesGate.failedTests} |`, ``);
+    if (data.passesGate.coverage !== undefined) {
+        lines.push(`| 覆盖率 | ${data.passesGate.coverage}% |`, ``);
+    }
+    lines.push(`---`, `*报告由 @dommaker/harness 生成*`, ``);
+    return lines.join('\n');
+}
+/**
+ * 生成 HTML 格式报告
+ */
+function generateHtmlReport(data) {
+    return `<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Harness 检查报告</title>
+  <style>
+    body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; max-width: 800px; margin: 0 auto; padding: 20px; }
+    h1 { color: #333; border-bottom: 2px solid #4CAF50; padding-bottom: 10px; }
+    h2 { color: #555; margin-top: 30px; }
+    table { width: 100%; border-collapse: collapse; margin: 15px 0; }
+    th, td { border: 1px solid #ddd; padding: 8px; text-align: left; }
+    th { background-color: #4CAF50; color: white; }
+    tr:nth-child(even) { background-color: #f2f2f2; }
+    .passed { color: #4CAF50; }
+    .failed { color: #f44336; }
+    .meta { color: #666; font-size: 0.9em; margin-bottom: 20px; }
+  </style>
+</head>
+<body>
+  <h1>Harness 检查报告</h1>
+  <p class="meta">生成时间: ${data.timestamp}<br>项目路径: ${data.projectPath}</p>
+
+  <h2>📜 铁律检查</h2>
+  <table>
+    <tr><th>指标</th><th>数值</th></tr>
+    <tr><td>总数</td><td>${data.ironLaws.total}</td></tr>
+    <tr><td>通过</td><td class="passed">${data.ironLaws.passed}</td></tr>
+    <tr><td>失败</td><td class="failed">${data.ironLaws.failed}</td></tr>
+    <tr><td>警告</td><td>${data.ironLaws.warnings}</td></tr>
+  </table>
+
+  <h2>🔍 检查点验证</h2>
+  <table>
+    <tr><th>指标</th><th>数值</th></tr>
+    <tr><td>总数</td><td>${data.checkpoints.total}</td></tr>
+    <tr><td>通过</td><td class="passed">${data.checkpoints.passed}</td></tr>
+    <tr><td>失败</td><td class="failed">${data.checkpoints.failed}</td></tr>
+  </table>
+
+  <h2>🚦 测试门控</h2>
+  <table>
+    <tr><th>指标</th><th>数值</th></tr>
+    <tr><td>状态</td><td class="${data.passesGate.passed ? 'passed' : 'failed'}">${data.passesGate.passed ? '✅ 通过' : '❌ 未通过'}</td></tr>
+    <tr><td>总测试</td><td>${data.passesGate.totalTests}</td></tr>
+    <tr><td>通过</td><td>${data.passesGate.passedTests}</td></tr>
+    <tr><td>失败</td><td>${data.passesGate.failedTests}</td></tr>
+  </table>
+
+  <footer style="margin-top: 40px; color: #999; text-align: center;">
+    报告由 @dommaker/harness 生成
+  </footer>
+</body>
+</html>`;
+}
+//# sourceMappingURL=report.js.map

package/dist/cli/commands/report.js.map

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

package/dist/cli/commands/validate.d.ts

@@ -0,0 +1,22 @@
+/**
+ * harness validate 命令
+ *
+ * 验证检查点是否满足
+ */
+export interface ValidateOptions {
+    /** 检查点文件路径 */
+    file?: string;
+    /** 项目路径 */
+    projectPath?: string;
+    /** 是否严格模式 */
+    strict?: boolean;
+}
+/**
+ * 执行检查点验证
+ */
+export declare function validate(options: ValidateOptions): Promise<void>;
+/**
+ * 创建示例检查点文件
+ */
+export declare function createExampleCheckpoint(projectPath: string): Promise<void>;
+//# sourceMappingURL=validate.d.ts.map

package/dist/cli/commands/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/validate.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,MAAM,WAAW,eAAe;IAC9B,cAAc;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAqBD;;GAEG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CA2DtE;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoDhF"}

package/dist/cli/commands/validate.js

@@ -0,0 +1,175 @@
+"use strict";
+/**
+ * harness validate 命令
+ *
+ * 验证检查点是否满足
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validate = validate;
+exports.createExampleCheckpoint = createExampleCheckpoint;
+const chalk_1 = __importDefault(require("chalk"));
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+const yaml = __importStar(require("js-yaml"));
+const checkpoint_1 = require("../../core/validators/checkpoint");
+/**
+ * 默认检查点文件路径
+ */
+const DEFAULT_CHECKPOINT_FILE = '.harness/checkpoints.yml';
+/**
+ * 加载检查点配置
+ */
+async function loadCheckpoints(filePath) {
+    try {
+        const content = await fs.readFile(filePath, 'utf-8');
+        const data = yaml.load(content);
+        return data.checkpoints || [];
+    }
+    catch (error) {
+        console.log(chalk_1.default.yellow(`⚠️  未找到检查点文件: ${filePath}`));
+        return [];
+    }
+}
+/**
+ * 执行检查点验证
+ */
+async function validate(options) {
+    console.log(chalk_1.default.blue('🔍 验证检查点...'));
+    const projectPath = options.projectPath || process.cwd();
+    const checkpointFile = options.file || path.join(projectPath, DEFAULT_CHECKPOINT_FILE);
+    // 加载检查点
+    const checkpoints = await loadCheckpoints(checkpointFile);
+    if (checkpoints.length === 0) {
+        console.log(chalk_1.default.gray('没有定义检查点，跳过验证'));
+        return;
+    }
+    console.log(chalk_1.default.gray(`检查点文件: ${checkpointFile}`));
+    console.log(chalk_1.default.gray(`检查点数量: ${checkpoints.length}`));
+    console.log();
+    // 构建上下文
+    const context = {
+        projectPath,
+        workdir: projectPath,
+    };
+    // 执行验证
+    const validator = checkpoint_1.CheckpointValidator.getInstance();
+    const results = [];
+    for (const checkpoint of checkpoints) {
+        const result = await validator.validate(checkpoint, context);
+        results.push(result);
+        if (result.passed) {
+            console.log(chalk_1.default.green(`✅ ${checkpoint.id}: 通过`));
+        }
+        else {
+            console.log(chalk_1.default.red(`❌ ${checkpoint.id}: 失败`));
+            result.checks.forEach(check => {
+                if (!check.passed) {
+                    console.log(chalk_1.default.red(`   - ${check.checkId}: ${check.message || check.error}`));
+                }
+            });
+        }
+    }
+    // 统计结果
+    const passed = results.filter(r => r.passed).length;
+    const failed = results.filter(r => !r.passed).length;
+    console.log();
+    console.log(chalk_1.default.gray(`通过: ${passed}/${results.length}`));
+    if (failed > 0) {
+        console.log(chalk_1.default.red(`\n🛑 ${failed} 个检查点未通过`));
+        if (options.strict) {
+            process.exit(1);
+        }
+    }
+    else {
+        console.log(chalk_1.default.green('\n✅ 所有检查点验证通过'));
+    }
+}
+/**
+ * 创建示例检查点文件
+ */
+async function createExampleCheckpoint(projectPath) {
+    const filePath = path.join(projectPath, DEFAULT_CHECKPOINT_FILE);
+    const dir = path.dirname(filePath);
+    await fs.mkdir(dir, { recursive: true });
+    const example = [
+        {
+            id: 'build-success',
+            name: '构建成功',
+            checks: [
+                {
+                    id: 'build-command',
+                    type: 'command_success',
+                    config: { command: 'npm run build' },
+                    message: '构建命令必须成功执行',
+                },
+            ],
+        },
+        {
+            id: 'test-pass',
+            name: '测试通过',
+            checks: [
+                {
+                    id: 'test-command',
+                    type: 'command_success',
+                    config: { command: 'npm test' },
+                    message: '测试命令必须成功执行',
+                },
+            ],
+        },
+        {
+            id: 'no-console',
+            name: '无 console.log',
+            checks: [
+                {
+                    id: 'check-console',
+                    type: 'output_not_contains',
+                    config: {
+                        command: 'grep -r "console.log" src/ || true',
+                        expected: '',
+                    },
+                    message: '源代码中不应包含 console.log',
+                },
+            ],
+        },
+    ];
+    const content = yaml.dump({ checkpoints: example }, { indent: 2 });
+    await fs.writeFile(filePath, content, 'utf-8');
+    console.log(chalk_1.default.green(`✅ 已创建示例检查点文件: ${filePath}`));
+}
+//# sourceMappingURL=validate.js.map

package/dist/cli/commands/validate.js.map

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

package/dist/core/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 核心模块导出
+ */
+export * from './iron-laws';
+export * from './validators';
+export * from './session';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,23 @@
+"use strict";
+/**
+ * 核心模块导出
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./iron-laws"), exports);
+__exportStar(require("./validators"), exports);
+__exportStar(require("./session"), exports);
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;AAEH,8CAA4B;AAC5B,+CAA6B;AAC7B,4CAA0B"}

package/dist/core/iron-laws/checker.d.ts

@@ -0,0 +1,61 @@
+/**
+ * 铁律检查引擎
+ *
+ * 在执行关键操作前，强制检查铁律是否满足
+ */
+import type { IronLaw, IronLawResult, IronLawContext } from '../../types/iron-law';
+/**
+ * 铁律检查器
+ */
+export declare class IronLawChecker {
+    private static instance;
+    private constructor();
+    /**
+     * 获取单例实例
+     */
+    static getInstance(): IronLawChecker;
+    /**
+     * 检查单个铁律
+     */
+    check(lawId: string, context: IronLawContext): Promise<IronLawResult>;
+    /**
+     * 检查铁律前置条件
+     */
+    private checkPrecondition;
+    /**
+     * 查找适用于当前操作的铁律
+     */
+    findApplicableLaws(context: IronLawContext): string[];
+    /**
+     * 在执行前自动检查所有适用的铁律
+     *
+     * @throws IronLawViolationError 如果有 error 级别的铁律违规
+     */
+    beforeExecution(context: IronLawContext): Promise<void>;
+    /**
+     * 检查并返回所有铁律状态（用于 UI 显示）
+     */
+    checkAll(context: IronLawContext): Promise<IronLawResult[]>;
+    /**
+     * 获取所有铁律定义
+     */
+    getAllLaws(): IronLaw[];
+    /**
+     * 获取单个铁律定义
+     */
+    getLaw(lawId: string): IronLaw | null;
+}
+/**
+ * 快捷函数：检查铁律
+ */
+export declare function checkIronLaw(lawId: string, context: IronLawContext): Promise<IronLawResult>;
+/**
+ * 快捷函数：执行前检查
+ */
+export declare function checkBeforeExecution(context: IronLawContext): Promise<void>;
+/**
+ * 快捷函数：检查所有铁律
+ */
+export declare function checkAllIronLaws(context: IronLawContext): Promise<IronLawResult[]>;
+export declare const ironLawChecker: IronLawChecker;
+//# sourceMappingURL=checker.d.ts.map

package/dist/core/iron-laws/checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checker.d.ts","sourceRoot":"","sources":["../../../src/core/iron-laws/checker.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,OAAO,EACP,aAAa,EACb,cAAc,EAEf,MAAM,sBAAsB,CAAC;AAG9B;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAiB;IAExC,OAAO;IAEP;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,cAAc;IAOpC;;OAEG;IACG,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IA+B3E;;OAEG;YACW,iBAAiB;IAwD/B;;OAEG;IACH,kBAAkB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,EAAE;IAYrD;;;;OAIG;IACG,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAY7D;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAYjE;;OAEG;IACH,UAAU,IAAI,OAAO,EAAE;IAIvB;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI;CAGtC;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,aAAa,CAAC,CAExB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAEjF;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAExF;AAGD,eAAO,MAAM,cAAc,gBAA+B,CAAC"}