@dommaker/harness 0.6.1 → 0.7.2

package/dist/core/constraints/interceptor.js

@@ -0,0 +1,176 @@
+"use strict";
+/**
+ * ConstraintInterceptor - 约束拦截器
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.constraintInterceptor = exports.ConstraintInterceptor = void 0;
+exports.interceptOperation = interceptOperation;
+exports.claimOperation = claimOperation;
+const constraint_1 = require("../../types/constraint");
+const checker_1 = require("./checker");
+class ConstraintInterceptor {
+    static instance;
+    executors = new Map();
+    enabled = true;
+    skipEnforcements = new Set();
+    constructor() { }
+    static getInstance() {
+        if (!ConstraintInterceptor.instance) {
+            ConstraintInterceptor.instance = new ConstraintInterceptor();
+        }
+        return ConstraintInterceptor.instance;
+    }
+    setEnabled(enabled) {
+        this.enabled = enabled;
+    }
+    register(enforcementId, executor, source) {
+        this.executors.set(enforcementId, executor);
+    }
+    registerBatch(registrations) {
+        for (const { enforcementId, executor } of registrations) {
+            this.register(enforcementId, executor);
+        }
+    }
+    unregister(enforcementId) {
+        return this.executors.delete(enforcementId);
+    }
+    hasExecutor(enforcementId) {
+        return this.executors.has(enforcementId);
+    }
+    getExecutor(enforcementId) {
+        return this.executors.get(enforcementId);
+    }
+    getRegistrations() {
+        return Array.from(this.executors.entries()).map(([id, executor]) => ({
+            id,
+            executor,
+            registeredAt: new Date(),
+            source: undefined,
+        }));
+    }
+    skip(enforcementIds) {
+        for (const id of enforcementIds) {
+            this.skipEnforcements.add(id);
+        }
+    }
+    clearSkips() {
+        this.skipEnforcements.clear();
+    }
+    async intercept(trigger, context) {
+        if (!this.enabled) {
+            return {
+                passed: true,
+                constraints: [],
+                violations: [],
+                message: '拦截器已禁用',
+                interceptedAt: new Date(),
+            };
+        }
+        const result = {
+            passed: true,
+            constraints: [],
+            violations: [],
+            interceptedAt: new Date(),
+        };
+        const constraints = checker_1.constraintChecker.getConstraints();
+        const allConstraints = [
+            ...Object.values(constraints.ironLaws),
+            ...Object.values(constraints.guidelines),
+            ...Object.values(constraints.tips),
+        ];
+        const applicableConstraints = allConstraints.filter(constraint => {
+            const triggers = Array.isArray(constraint.trigger)
+                ? constraint.trigger
+                : [constraint.trigger];
+            return triggers.includes(trigger);
+        });
+        const order = { iron_law: 0, guideline: 1, tip: 2 };
+        const ordered = applicableConstraints.sort((a, b) => order[a.level] - order[b.level]);
+        for (const constraint of ordered) {
+            const enforcementId = constraint.enforcement;
+            if (this.skipEnforcements.has(enforcementId)) {
+                result.constraints.push({ constraint, skipped: true, skipReason: 'configured to skip' });
+                continue;
+            }
+            const executor = this.executors.get(enforcementId);
+            if (!executor) {
+                result.constraints.push({ constraint, skipped: true, skipReason: `no executor for '${enforcementId}'` });
+                continue;
+            }
+            const enforcementContext = { ...context, enforcementId, constraint };
+            const start = Date.now();
+            try {
+                const enforcementResult = await executor.execute(enforcementContext);
+                enforcementResult.duration = Date.now() - start;
+                result.constraints.push({ constraint, enforcementResult });
+                if (!enforcementResult.passed) {
+                    if (constraint.level === 'iron_law') {
+                        result.passed = false;
+                        result.violations.push(constraint);
+                        throw new constraint_1.ConstraintViolationError({
+                            id: constraint.id,
+                            level: constraint.level,
+                            satisfied: false,
+                            constraint,
+                            message: constraint.message,
+                            requiredAction: constraint.enforcement,
+                            checkedAt: new Date(),
+                        });
+                    }
+                    if (constraint.level === 'guideline') {
+                        result.violations.push(constraint);
+                    }
+                }
+            }
+            catch (error) {
+                if (error instanceof constraint_1.ConstraintViolationError)
+                    throw error;
+                result.constraints.push({ constraint, enforcementResult: { passed: false, error: error.message, duration: Date.now() - start } });
+                if (constraint.level === 'iron_law') {
+                    result.passed = false;
+                    result.violations.push(constraint);
+                    throw new constraint_1.ConstraintViolationError({
+                        id: constraint.id,
+                        level: constraint.level,
+                        satisfied: false,
+                        constraint,
+                        message: `Enforcement failed: ${error.message}`,
+                        requiredAction: constraint.enforcement,
+                        checkedAt: new Date(),
+                    });
+                }
+            }
+        }
+        result.message = result.violations.length === 0 ? '✅ 拦截通过' : `❌ ${result.violations.length} 个约束违规`;
+        return result;
+    }
+    async claim(trigger, context) {
+        const result = await this.intercept(trigger, context);
+        if (!result.passed) {
+            throw new constraint_1.ConstraintViolationError({
+                id: result.violations[0]?.id || 'unknown',
+                level: 'iron_law',
+                satisfied: false,
+                message: result.message,
+                checkedAt: new Date(),
+            });
+        }
+    }
+    async canProceed(trigger, context) {
+        try {
+            return (await this.intercept(trigger, context)).passed;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+exports.ConstraintInterceptor = ConstraintInterceptor;
+exports.constraintInterceptor = ConstraintInterceptor.getInstance();
+async function interceptOperation(trigger, context) {
+    return exports.constraintInterceptor.intercept(trigger, context);
+}
+async function claimOperation(trigger, context) {
+    return exports.constraintInterceptor.claim(trigger, context);
+}
+//# sourceMappingURL=interceptor.js.map

package/dist/core/constraints/interceptor.js.map

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

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

@@ -0,0 +1,7 @@
+/**
+ * Spec 验证模块
+ *
+ * 框架提供验证机制，项目定义自己的 Spec Schema
+ */
+export * from './validator';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/core/spec/index.js

@@ -0,0 +1,23 @@
+"use strict";
+/**
+ * Spec 验证模块
+ *
+ * 框架提供验证机制，项目定义自己的 Spec Schema
+ */
+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("./validator"), exports);
+//# sourceMappingURL=index.js.map

package/dist/core/spec/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/spec/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;;;;;;;;;;;AAEH,8CAA4B"}

package/dist/core/spec/validator.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Spec 验证器
+ *
+ * 框架提供验证机制，项目定义自己的 Spec Schema
+ *
+ * 设计原则：
+ * - 框架不包含具体 Schema 定义
+ * - 动态加载项目的 Schema
+ * - 支持 Zod / JSON Schema / 自定义验证器
+ */
+import type { SpecValidatorConfig, SpecValidationResult, BatchSpecValidationResult, SpecSchemaDefinition, SpecType } from '../../types/spec';
+/**
+ * Spec 验证器
+ */
+export declare class SpecValidator {
+    private static instance;
+    private config;
+    private schemaCache;
+    private constructor();
+    /**
+     * 获取单例实例
+     */
+    static getInstance(config?: Partial<SpecValidatorConfig>): SpecValidator;
+    /**
+     * 更新配置
+     */
+    setConfig(config: Partial<SpecValidatorConfig>): void;
+    /**
+     * 加载项目的 Schema
+     *
+     * 支持两种方式：
+     * 1. 指定 schemaPath 目录，自动加载 index.ts/js
+     * 2. 使用 --schema 参数指定路径
+     */
+    loadSchema(schemaPath: string): Promise<SpecSchemaDefinition | null>;
+    /**
+     * 检测 Spec 类型
+     */
+    detectSpecType(filePath: string): SpecType;
+    /**
+     * 验证单个文件
+     */
+    validateFile(filePath: string, schema?: SpecSchemaDefinition): Promise<SpecValidationResult>;
+    /**
+     * 基础验证（无 Schema 时）
+     */
+    private basicValidation;
+    /**
+     * 批量验证
+     */
+    validateAll(projectPath?: string, staged?: boolean): Promise<BatchSpecValidationResult>;
+    /**
+     * 获取 Spec 文件
+     */
+    private getSpecFiles;
+    /**
+     * 获取暂存的 Spec 文件
+     */
+    private getStagedFiles;
+    /**
+     * 判断是否为 Spec 文件
+     */
+    private isSpecFile;
+    /**
+     * 检查文件是否存在
+     */
+    private fileExists;
+    /**
+     * 动态导入模块
+     */
+    private dynamicImport;
+}
+/**
+ * 便捷函数
+ */
+export declare function validateSpec(filePath: string, schemaPath?: string): Promise<SpecValidationResult>;
+export declare function validateAllSpecs(projectPath?: string, staged?: boolean): Promise<BatchSpecValidationResult>;
+//# sourceMappingURL=validator.d.ts.map

package/dist/core/spec/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../src/core/spec/validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EACV,mBAAmB,EACnB,oBAAoB,EACpB,yBAAyB,EACzB,oBAAoB,EACpB,QAAQ,EACT,MAAM,kBAAkB,CAAC;AAY1B;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAgB;IACvC,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,WAAW,CAAgD;IAEnE,OAAO;IAIP;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,aAAa;IAOxE;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,IAAI;IAKrD;;;;;;OAMG;IACG,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IAwC1E;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ;IAkB1C;;OAEG;IACG,YAAY,CAChB,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,oBAAoB,GAC5B,OAAO,CAAC,oBAAoB,CAAC;IA+ChC;;OAEG;YACW,eAAe;IAwC7B;;OAEG;IACG,WAAW,CACf,WAAW,CAAC,EAAE,MAAM,EACpB,MAAM,CAAC,EAAE,OAAO,GACf,OAAO,CAAC,yBAAyB,CAAC;IAwCrC;;OAEG;YACW,YAAY;IAe1B;;OAEG;YACW,cAAc;IAc5B;;OAEG;IACH,OAAO,CAAC,UAAU;IAoBlB;;OAEG;YACW,UAAU;IASxB;;OAEG;YACW,aAAa;CAiB5B;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,oBAAoB,CAAC,CAO/B;AAED,wBAAsB,gBAAgB,CACpC,WAAW,CAAC,EAAE,MAAM,EACpB,MAAM,CAAC,EAAE,OAAO,GACf,OAAO,CAAC,yBAAyB,CAAC,CAGpC"}

package/dist/core/spec/validator.js

@@ -0,0 +1,372 @@
+"use strict";
+/**
+ * Spec 验证器
+ *
+ * 框架提供验证机制，项目定义自己的 Spec Schema
+ *
+ * 设计原则：
+ * - 框架不包含具体 Schema 定义
+ * - 动态加载项目的 Schema
+ * - 支持 Zod / JSON Schema / 自定义验证器
+ */
+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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SpecValidator = void 0;
+exports.validateSpec = validateSpec;
+exports.validateAllSpecs = validateAllSpecs;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+const glob = __importStar(require("fast-glob"));
+/**
+ * 默认配置
+ */
+const DEFAULT_CONFIG = {
+    enabled: true,
+    schemaPath: './specs/schemas',
+    files: ['ARCHITECTURE.md', 'specs/**/*.yml', 'specs/**/*.yaml'],
+    failureLevel: 'error',
+};
+/**
+ * Spec 验证器
+ */
+class SpecValidator {
+    static instance;
+    config;
+    schemaCache = new Map();
+    constructor(config) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * 获取单例实例
+     */
+    static getInstance(config) {
+        if (!SpecValidator.instance) {
+            SpecValidator.instance = new SpecValidator(config);
+        }
+        return SpecValidator.instance;
+    }
+    /**
+     * 更新配置
+     */
+    setConfig(config) {
+        this.config = { ...this.config, ...config };
+        this.schemaCache.clear();
+    }
+    /**
+     * 加载项目的 Schema
+     *
+     * 支持两种方式：
+     * 1. 指定 schemaPath 目录，自动加载 index.ts/js
+     * 2. 使用 --schema 参数指定路径
+     */
+    async loadSchema(schemaPath) {
+        const cached = this.schemaCache.get(schemaPath);
+        if (cached)
+            return cached;
+        const absolutePath = path.resolve(schemaPath);
+        try {
+            // 尝试加载 TypeScript/JavaScript 模块
+            const indexPath = path.join(absolutePath, 'index.ts');
+            const indexPathJs = path.join(absolutePath, 'index.js');
+            let schemaModule;
+            if (await this.fileExists(indexPath)) {
+                // 动态导入 TypeScript 模块（需要 tsx 或编译后的 .js）
+                schemaModule = await this.dynamicImport(indexPath);
+            }
+            else if (await this.fileExists(indexPathJs)) {
+                schemaModule = await this.dynamicImport(indexPathJs);
+            }
+            else {
+                // 尝试直接加载指定文件
+                schemaModule = await this.dynamicImport(absolutePath);
+            }
+            if (schemaModule && schemaModule.validate) {
+                const schema = {
+                    name: schemaModule.name || 'custom',
+                    version: schemaModule.version,
+                    validate: schemaModule.validate,
+                };
+                this.schemaCache.set(schemaPath, schema);
+                return schema;
+            }
+            return null;
+        }
+        catch (error) {
+            // Schema 加载失败是正常的（项目可能没有自定义 Schema）
+            return null;
+        }
+    }
+    /**
+     * 检测 Spec 类型
+     */
+    detectSpecType(filePath) {
+        const basename = path.basename(filePath).toLowerCase();
+        if (basename === 'architecture.md') {
+            return 'architecture';
+        }
+        if (filePath.includes('module') || filePath.includes('modules')) {
+            return 'module';
+        }
+        if (filePath.includes('api') || filePath.includes('apis')) {
+            return 'api';
+        }
+        return 'custom';
+    }
+    /**
+     * 验证单个文件
+     */
+    async validateFile(filePath, schema) {
+        const specType = this.detectSpecType(filePath);
+        const absolutePath = path.resolve(filePath);
+        // 检查文件是否存在
+        if (!(await this.fileExists(absolutePath))) {
+            return {
+                valid: false,
+                file: filePath,
+                type: specType,
+                errors: [{ path: '', message: `文件不存在: ${filePath}`, severity: 'error' }],
+                warnings: [],
+            };
+        }
+        // 如果没有传入 Schema，尝试加载项目的 Schema
+        let schemaToUse = schema;
+        if (!schemaToUse) {
+            const loadedSchema = await this.loadSchema(this.config.schemaPath);
+            schemaToUse = loadedSchema ?? undefined;
+        }
+        // 如果没有 Schema，使用基础验证
+        if (!schemaToUse) {
+            return this.basicValidation(filePath, specType);
+        }
+        // 使用项目的 Schema 验证
+        try {
+            const content = await fs.readFile(absolutePath, 'utf-8');
+            const result = await schemaToUse.validate(content, filePath);
+            return result;
+        }
+        catch (error) {
+            return {
+                valid: false,
+                file: filePath,
+                type: specType,
+                errors: [{
+                        path: '',
+                        message: `验证失败: ${error instanceof Error ? error.message : String(error)}`,
+                        severity: 'error',
+                    }],
+                warnings: [],
+            };
+        }
+    }
+    /**
+     * 基础验证（无 Schema 时）
+     */
+    async basicValidation(filePath, specType) {
+        const absolutePath = path.resolve(filePath);
+        const content = await fs.readFile(absolutePath, 'utf-8');
+        const errors = [];
+        const warnings = [];
+        // ARCHITECTURE.md 基础检查
+        if (specType === 'architecture') {
+            if (!content.includes('# ') && !content.includes('## ')) {
+                errors.push({
+                    path: '',
+                    message: 'ARCHITECTURE.md 应包含标题和章节',
+                    severity: 'warning',
+                });
+            }
+        }
+        // YAML 文件基础检查
+        if (filePath.endsWith('.yml') || filePath.endsWith('.yaml')) {
+            try {
+                const yaml = await Promise.resolve().then(() => __importStar(require('js-yaml')));
+                yaml.load(content);
+            }
+            catch (e) {
+                errors.push({
+                    path: '',
+                    message: `YAML 解析失败: ${e instanceof Error ? e.message : String(e)}`,
+                    severity: 'error',
+                });
+            }
+        }
+        return {
+            valid: errors.length === 0,
+            file: filePath,
+            type: specType,
+            errors,
+            warnings,
+        };
+    }
+    /**
+     * 批量验证
+     */
+    async validateAll(projectPath, staged) {
+        const cwd = projectPath || process.cwd();
+        const results = [];
+        // 加载项目的 Schema
+        const loadedSchema = await this.loadSchema(this.config.schemaPath);
+        const schema = loadedSchema ?? undefined;
+        // 获取要验证的文件
+        let files;
+        if (staged) {
+            files = await this.getStagedFiles();
+        }
+        else {
+            files = await this.getSpecFiles(cwd);
+        }
+        // 过滤只保留 Spec 相关文件
+        const specFiles = files.filter(f => this.isSpecFile(f));
+        // 验证每个文件
+        for (const file of specFiles) {
+            const result = await this.validateFile(file, schema);
+            results.push(result);
+        }
+        // 统计结果
+        const passed = results.filter(r => r.valid).length;
+        const failed = results.filter(r => !r.valid).length;
+        const warnings = results.reduce((sum, r) => sum + r.warnings.length, 0);
+        return {
+            total: specFiles.length,
+            passed,
+            failed,
+            warnings,
+            results,
+        };
+    }
+    /**
+     * 获取 Spec 文件
+     */
+    async getSpecFiles(cwd) {
+        const allFiles = [];
+        for (const pattern of this.config.files) {
+            const files = await glob.glob(pattern, {
+                cwd,
+                absolute: true,
+                ignore: ['node_modules/**', 'dist/**', '.git/**'],
+            });
+            allFiles.push(...files);
+        }
+        return [...new Set(allFiles)];
+    }
+    /**
+     * 获取暂存的 Spec 文件
+     */
+    async getStagedFiles() {
+        const { exec } = await Promise.resolve().then(() => __importStar(require('child_process')));
+        const { promisify } = await Promise.resolve().then(() => __importStar(require('util')));
+        const execAsync = promisify(exec);
+        try {
+            const { stdout } = await execAsync('git diff --cached --name-only');
+            const allFiles = stdout.trim().split('\n').filter(Boolean);
+            return allFiles.filter(f => this.isSpecFile(f));
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * 判断是否为 Spec 文件
+     */
+    isSpecFile(filePath) {
+        const basename = path.basename(filePath).toLowerCase();
+        // ARCHITECTURE.md
+        if (basename === 'architecture.md')
+            return true;
+        // specs 目录下的文件
+        if (filePath.includes('specs/') || filePath.includes('spec/'))
+            return true;
+        // 符合配置的文件模式
+        for (const pattern of this.config.files) {
+            if (pattern.startsWith('specs/')) {
+                // 检查路径是否匹配
+                if (filePath.includes('/specs/'))
+                    return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * 检查文件是否存在
+     */
+    async fileExists(filePath) {
+        try {
+            await fs.access(filePath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * 动态导入模块
+     */
+    async dynamicImport(modulePath) {
+        try {
+            // 尝试直接导入
+            return await Promise.resolve(`${modulePath}`).then(s => __importStar(require(s)));
+        }
+        catch {
+            // 如果是 TypeScript 文件，尝试加载编译后的 JS
+            if (modulePath.endsWith('.ts')) {
+                const jsPath = modulePath.replace(/\.ts$/, '.js');
+                try {
+                    return await Promise.resolve(`${jsPath}`).then(s => __importStar(require(s)));
+                }
+                catch {
+                    return null;
+                }
+            }
+            return null;
+        }
+    }
+}
+exports.SpecValidator = SpecValidator;
+/**
+ * 便捷函数
+ */
+async function validateSpec(filePath, schemaPath) {
+    const validator = SpecValidator.getInstance();
+    if (schemaPath) {
+        const loadedSchema = await validator.loadSchema(schemaPath);
+        return validator.validateFile(filePath, loadedSchema ?? undefined);
+    }
+    return validator.validateFile(filePath);
+}
+async function validateAllSpecs(projectPath, staged) {
+    const validator = SpecValidator.getInstance();
+    return validator.validateAll(projectPath, staged);
+}
+//# sourceMappingURL=validator.js.map