@dommaker/harness 0.7.3 → 0.7.4

package/dist/spec/annotation-checker.d.ts

@@ -0,0 +1,47 @@
+/**
+ * 代码注释规范检查器
+ *
+ * 检查代码中的 @spec 注释是否规范
+ */
+export interface AnnotationCheckResult {
+    valid: boolean;
+    file: string;
+    annotations: SpecAnnotation[];
+    errors: AnnotationError[];
+    warnings: AnnotationWarning[];
+}
+export interface SpecAnnotation {
+    specId: string;
+    implements?: string[];
+    acceptance?: string[];
+    dependencies?: string[];
+    author?: string;
+    since?: string;
+    line: number;
+    type: 'class' | 'method' | 'function' | 'inline';
+}
+export interface AnnotationError {
+    line: number;
+    message: string;
+    code: 'MISSING_SPEC' | 'INVALID_SPEC_FORMAT' | 'SPEC_NOT_APPROVED' | 'IMPLEMENTS_NOT_FOUND';
+}
+export interface AnnotationWarning {
+    line: number;
+    message: string;
+    code: 'MISSING_IMPLEMENTS' | 'MISSING_ACCEPTANCE' | 'MISSING_AUTHOR';
+}
+/**
+ * 检查单个文件
+ */
+export declare function checkFile(filePath: string): AnnotationCheckResult;
+/**
+ * 批量检查目录
+ */
+export declare function checkDirectory(dir: string, options?: {
+    extensions?: string[];
+}): AnnotationCheckResult[];
+/**
+ * 生成报告
+ */
+export declare function generateReport(results: AnnotationCheckResult[]): string;
+//# sourceMappingURL=annotation-checker.d.ts.map

package/dist/spec/annotation-checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotation-checker.d.ts","sourceRoot":"","sources":["../../src/spec/annotation-checker.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,CAAC;CAClD;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,cAAc,GAAG,qBAAqB,GAAG,mBAAmB,GAAG,sBAAsB,CAAC;CAC7F;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,oBAAoB,GAAG,oBAAoB,GAAG,gBAAgB,CAAC;CACtE;AAKD;;GAEG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,qBAAqB,CAkEjE;AA0KD;;GAEG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;CAAO,GACtC,qBAAqB,EAAE,CAKzB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,EAAE,GAAG,MAAM,CAgCvE"}

package/dist/spec/annotation-checker.js

@@ -0,0 +1,299 @@
+"use strict";
+/**
+ * 代码注释规范检查器
+ *
+ * 检查代码中的 @spec 注释是否规范
+ */
+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.checkFile = checkFile;
+exports.checkDirectory = checkDirectory;
+exports.generateReport = generateReport;
+const fs_1 = require("fs");
+const path = __importStar(require("path"));
+// Spec ID 格式: AR-XXX, WS-XXX, etc.
+const SPEC_ID_REGEX = /^[A-Z]{2,3}-\d{3}$/;
+/**
+ * 检查单个文件
+ */
+function checkFile(filePath) {
+    const content = (0, fs_1.readFileSync)(filePath, 'utf-8');
+    const lines = content.split('\n');
+    const result = {
+        valid: true,
+        file: filePath,
+        annotations: [],
+        errors: [],
+        warnings: [],
+    };
+    let inJSDoc = false;
+    let currentJSDoc = [];
+    let currentJSDocStartLine = 0;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i].trim();
+        // JSDoc 开始
+        if (line.startsWith('/**')) {
+            inJSDoc = true;
+            currentJSDoc = [line];
+            currentJSDocStartLine = i + 1;
+            continue;
+        }
+        // JSDoc 结束
+        if (inJSDoc && line.endsWith('*/')) {
+            inJSDoc = false;
+            currentJSDoc.push(line);
+            const annotation = parseJSDoc(currentJSDoc, currentJSDocStartLine);
+            if (annotation) {
+                result.annotations.push(annotation);
+                validateAnnotation(annotation, result);
+            }
+            currentJSDoc = [];
+            continue;
+        }
+        // JSDoc 中间
+        if (inJSDoc) {
+            currentJSDoc.push(line);
+        }
+        // 行内注释 // @spec AR-001
+        const inlineMatch = line.match(/\/\/\s*@spec\s+(\S+)/);
+        if (inlineMatch) {
+            const specId = inlineMatch[1];
+            const annotation = {
+                specId,
+                line: i + 1,
+                type: 'inline',
+            };
+            result.annotations.push(annotation);
+            validateAnnotation(annotation, result);
+        }
+    }
+    // 检查公共导出是否有注释
+    checkPublicExports(content, result);
+    result.valid = result.errors.length === 0;
+    return result;
+}
+/**
+ * 解析 JSDoc 注释
+ */
+function parseJSDoc(lines, startLine) {
+    const content = lines.join('\n');
+    // 检查是否有 @spec
+    const specMatch = content.match(/@spec\s+(\S+)/);
+    if (!specMatch) {
+        return null;
+    }
+    const specId = specMatch[1];
+    // 解析其他标签
+    const annotation = {
+        specId,
+        line: startLine,
+        type: inferType(content),
+    };
+    // @implements
+    const implementsMatch = content.match(/@implements\s+([\w\-_,\s]+)/);
+    if (implementsMatch) {
+        annotation.implements = implementsMatch[1]
+            .split(/[,\s]+/)
+            .map(s => s.trim())
+            .filter(Boolean);
+    }
+    // @acceptance
+    const acceptanceMatch = content.match(/@acceptance\s+([\w\-_,\s]+)/);
+    if (acceptanceMatch) {
+        annotation.acceptance = acceptanceMatch[1]
+            .split(/[,\s]+/)
+            .map(s => s.trim())
+            .filter(Boolean);
+    }
+    // @dependencies
+    const depsMatch = content.match(/@dependencies\s+([\w\-_,\s\/]+)/);
+    if (depsMatch) {
+        annotation.dependencies = depsMatch[1]
+            .split(/[,\s]+/)
+            .map(s => s.trim())
+            .filter(Boolean);
+    }
+    // @author
+    const authorMatch = content.match(/@author\s+(\S+)/);
+    if (authorMatch) {
+        annotation.author = authorMatch[1];
+    }
+    // @since
+    const sinceMatch = content.match(/@since\s+(\d{4}-\d{2}-\d{2})/);
+    if (sinceMatch) {
+        annotation.since = sinceMatch[1];
+    }
+    return annotation;
+}
+/**
+ * 推断注释类型
+ */
+function inferType(content) {
+    if (content.includes('class '))
+        return 'class';
+    if (content.includes('async ') || content.includes('function '))
+        return 'function';
+    return 'method';
+}
+/**
+ * 验证注释
+ */
+function validateAnnotation(annotation, result) {
+    // 检查 Spec ID 格式
+    if (!SPEC_ID_REGEX.test(annotation.specId)) {
+        result.errors.push({
+            line: annotation.line,
+            message: `Invalid spec ID format: ${annotation.specId}`,
+            code: 'INVALID_SPEC_FORMAT',
+        });
+    }
+    // 警告：建议标记 @implements
+    if (!annotation.implements && annotation.type !== 'inline') {
+        result.warnings.push({
+            line: annotation.line,
+            message: 'Missing @implements tag',
+            code: 'MISSING_IMPLEMENTS',
+        });
+    }
+    // 警告：建议标记 @acceptance
+    if (!annotation.acceptance) {
+        result.warnings.push({
+            line: annotation.line,
+            message: 'Missing @acceptance tag',
+            code: 'MISSING_ACCEPTANCE',
+        });
+    }
+}
+/**
+ * 检查公共导出是否有注释
+ */
+function checkPublicExports(content, result) {
+    // 查找 export class/function 但没有 @spec 的
+    const exportRegex = /^(export\s+(?:abstract\s+)?(?:class|interface|function|const|let|var))\s+(\w+)/gm;
+    let match;
+    while ((match = exportRegex.exec(content)) !== null) {
+        const line = content.substring(0, match.index).split('\n').length;
+        const name = match[2];
+        // 检查前10行是否有 @spec
+        const beforeContent = content.substring(Math.max(0, match.index - 500), match.index);
+        if (!beforeContent.includes('@spec')) {
+            result.warnings.push({
+                line,
+                message: `Public export "${name}" missing @spec annotation`,
+                code: 'MISSING_SPEC',
+            });
+        }
+    }
+}
+/**
+ * 递归获取目录下所有文件
+ */
+function getFilesRecursively(dir, extensions) {
+    const files = [];
+    try {
+        const items = (0, fs_1.readdirSync)(dir);
+        for (const item of items) {
+            const fullPath = path.join(dir, item);
+            const stat = (0, fs_1.statSync)(fullPath);
+            if (stat.isDirectory()) {
+                // 跳过 node_modules 和 dist
+                if (item === 'node_modules' || item === 'dist') {
+                    continue;
+                }
+                files.push(...getFilesRecursively(fullPath, extensions));
+            }
+            else if (stat.isFile()) {
+                const ext = path.extname(item);
+                if (extensions.includes(ext) && !item.endsWith('.d.ts')) {
+                    files.push(fullPath);
+                }
+            }
+        }
+    }
+    catch {
+        // 目录不存在或无法访问
+    }
+    return files;
+}
+/**
+ * 批量检查目录
+ */
+function checkDirectory(dir, options = {}) {
+    const extensions = options.extensions || ['.ts', '.tsx', '.js', '.jsx'];
+    const files = getFilesRecursively(dir, extensions);
+    return files.map(file => checkFile(file));
+}
+/**
+ * 生成报告
+ */
+function generateReport(results) {
+    const totalFiles = results.length;
+    const validFiles = results.filter(r => r.valid).length;
+    const totalErrors = results.reduce((sum, r) => sum + r.errors.length, 0);
+    const totalWarnings = results.reduce((sum, r) => sum + r.warnings.length, 0);
+    let report = `## 注释规范检查报告\n\n`;
+    report += `- 检查文件: ${totalFiles}\n`;
+    report += `- 通过: ${validFiles}/${totalFiles}\n`;
+    report += `- 错误: ${totalErrors}\n`;
+    report += `- 警告: ${totalWarnings}\n\n`;
+    if (totalErrors > 0) {
+        report += `### ❌ 错误\n\n`;
+        for (const result of results) {
+            for (const error of result.errors) {
+                report += `- ${result.file}:${error.line} - ${error.message}\n`;
+            }
+        }
+        report += '\n';
+    }
+    if (totalWarnings > 0) {
+        report += `### ⚠️ 警告\n\n`;
+        for (const result of results) {
+            for (const warning of result.warnings.slice(0, 5)) {
+                report += `- ${result.file}:${warning.line} - ${warning.message}\n`;
+            }
+        }
+    }
+    return report;
+}
+// CLI 入口
+if (require.main === module) {
+    const args = process.argv.slice(2);
+    const dir = args[0] || process.cwd();
+    const results = checkDirectory(dir);
+    console.log(generateReport(results));
+    const hasErrors = results.some(r => r.errors.length > 0);
+    process.exit(hasErrors ? 1 : 0);
+}
+//# sourceMappingURL=annotation-checker.js.map

package/dist/spec/annotation-checker.js.map

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

package/dist/types/index.d.ts

@@ -6,6 +6,7 @@ export * from './checkpoint';
 export * from './passes-gate';
 export * from './cso';
 export * from './trace';
+export * from './performance';
 export type { Diagnosis } from '../monitoring/constraint-doctor';
 export type { ConstraintProposal, ProposalReviewResult, } from '../monitoring/constraint-evolver';
 export { StartupCheckpoints, StartupCheckpointType, StartupCheckpointResult, CleanStateConfig, CleanStateResult, DetectedBug, TaskListJson, TaskStepStatus, SessionInfo, } from './session';
@@ -13,4 +14,5 @@ export { DynamicTask as ExtendedDynamicTask, TaskTestResult as ExtendedTaskTestR
 export * from './project-config';
 export * from './enforcement';
 export * from './spec';
+export { ErrorType, FailureLevel, ErrorClassificationRule, FailureRecord, ClassificationResult, DEFAULT_CLASSIFICATION_RULES, DEFAULT_LEVEL_MAPPING, } from '../failure/types';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,cAAc,cAAc,CAAC;AAE7B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,OAAO,CAAC;AAGtB,cAAc,SAAS,CAAC;AAGxB,YAAY,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AACjE,YAAY,EACV,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,kCAAkC,CAAC;AAG1C,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,uBAAuB,EACvB,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,cAAc,EACd,WAAW,GACZ,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,WAAW,IAAI,mBAAmB,EAAE,cAAc,IAAI,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAGzG,cAAc,kBAAkB,CAAC;AAGjC,cAAc,eAAe,CAAC;AAG9B,cAAc,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,cAAc,cAAc,CAAC;AAE7B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,OAAO,CAAC;AAGtB,cAAc,SAAS,CAAC;AAGxB,cAAc,eAAe,CAAC;AAG9B,YAAY,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AACjE,YAAY,EACV,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,kCAAkC,CAAC;AAG1C,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,uBAAuB,EACvB,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,cAAc,EACd,WAAW,GACZ,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,WAAW,IAAI,mBAAmB,EAAE,cAAc,IAAI,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAGzG,cAAc,kBAAkB,CAAC;AAGjC,cAAc,eAAe,CAAC;AAG9B,cAAc,QAAQ,CAAC;AAGvB,OAAO,EACL,SAAS,EACT,YAAY,EACZ,uBAAuB,EACvB,aAAa,EACb,oBAAoB,EACpB,4BAA4B,EAC5B,qBAAqB,GACtB,MAAM,kBAAkB,CAAC"}

package/dist/types/index.js

@@ -17,6 +17,7 @@ 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 });
+exports.DEFAULT_LEVEL_MAPPING = exports.DEFAULT_CLASSIFICATION_RULES = exports.FailureLevel = exports.ErrorType = void 0;
 // 约束类型（三层体系）
 __exportStar(require("./constraint"), exports);
 __exportStar(require("./checkpoint"), exports);
@@ -24,10 +25,18 @@ __exportStar(require("./passes-gate"), exports);
 __exportStar(require("./cso"), exports);
 // Trace 类型（Execution Trace 系统）
 __exportStar(require("./trace"), exports);
+// Performance 类型（Performance Trace 系统）
+__exportStar(require("./performance"), exports);
 // 项目配置类型
 __exportStar(require("./project-config"), exports);
 // Enforcement 类型
 __exportStar(require("./enforcement"), exports);
 // Spec 验证类型
 __exportStar(require("./spec"), exports);
+// Failure 类型（从 failure 模块导入）
+var types_1 = require("../failure/types");
+Object.defineProperty(exports, "ErrorType", { enumerable: true, get: function () { return types_1.ErrorType; } });
+Object.defineProperty(exports, "FailureLevel", { enumerable: true, get: function () { return types_1.FailureLevel; } });
+Object.defineProperty(exports, "DEFAULT_CLASSIFICATION_RULES", { enumerable: true, get: function () { return types_1.DEFAULT_CLASSIFICATION_RULES; } });
+Object.defineProperty(exports, "DEFAULT_LEVEL_MAPPING", { enumerable: true, get: function () { return types_1.DEFAULT_LEVEL_MAPPING; } });
 //# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;AAEH,aAAa;AACb,+CAA6B;AAE7B,+CAA6B;AAC7B,gDAA8B;AAC9B,wCAAsB;AAEtB,+BAA+B;AAC/B,0CAAwB;AAyBxB,SAAS;AACT,mDAAiC;AAEjC,iBAAiB;AACjB,gDAA8B;AAE9B,YAAY;AACZ,yCAAuB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;AAEH,aAAa;AACb,+CAA6B;AAE7B,+CAA6B;AAC7B,gDAA8B;AAC9B,wCAAsB;AAEtB,+BAA+B;AAC/B,0CAAwB;AAExB,uCAAuC;AACvC,gDAA8B;AAyB9B,SAAS;AACT,mDAAiC;AAEjC,iBAAiB;AACjB,gDAA8B;AAE9B,YAAY;AACZ,yCAAuB;AAEvB,6BAA6B;AAC7B,0CAQ0B;AAPxB,kGAAA,SAAS,OAAA;AACT,qGAAA,YAAY,OAAA;AAIZ,qHAAA,4BAA4B,OAAA;AAC5B,8GAAA,qBAAqB,OAAA"}

package/dist/types/performance.d.ts

@@ -0,0 +1,204 @@
+/**
+ * Performance Trace 类型定义
+ *
+ * 轻量设计：只记录核心信息，零 Token 成本
+ *
+ * 与 ExecutionTrace 的区别：
+ * - ExecutionTrace: 记录约束检查结果（业务行为）
+ * - PerformanceTrace: 记录操作耗时（性能指标）
+ */
+/**
+ * 性能追踪记录
+ *
+ * 设计原则：
+ * - 只记录核心字段（零 Token）
+ * - 文件存储，追加写入
+ * - 支持多种操作类型
+ */
+export interface PerformanceTrace {
+    /** 操作类型 */
+    operation: string;
+    /** 时间戳（Unix timestamp） */
+    timestamp: number;
+    /** 耗时（毫秒） */
+    duration: number;
+    /** 结果 */
+    result: 'ok' | 'exceeded' | 'error';
+    /** 阈值（毫秒），用于计算是否超阈值 */
+    threshold?: number;
+    /** 项目路径（用于区分多项目） */
+    projectPath?: string;
+    /** 会话 ID（用于追踪同一会话的多次操作） */
+    sessionId?: string;
+    /** 任务 ID */
+    taskId?: string;
+    /** 角色ID（用于角色相关操作） */
+    roleId?: string;
+    /** 额外元数据 */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * 性能统计汇总
+ */
+export interface PerformanceSummary {
+    /** 操作类型 */
+    operation: string;
+    /** 统计时间范围 */
+    timeRange: {
+        start: number;
+        end: number;
+    };
+    /** 总执行次数 */
+    totalCalls: number;
+    /** 成功次数 */
+    okCount: number;
+    /** 超阈值次数 */
+    exceededCount: number;
+    /** 错误次数 */
+    errorCount: number;
+    /** 平均耗时（毫秒） */
+    avgDuration: number;
+    /** 最大耗时 */
+    maxDuration: number;
+    /** 最小耗时 */
+    minDuration: number;
+    /** P95 耗时 */
+    p95Duration: number;
+    /** P99 耗时 */
+    p99Duration: number;
+    /** 成功率 (0-1) */
+    okRate: number;
+    /** 超阈值率 (0-1) */
+    exceededRate: number;
+    /** 错误率 (0-1) */
+    errorRate: number;
+    /** 最近趋势 */
+    recentTrend: 'stable' | 'rising' | 'falling';
+    /** 对比上一周期的变化 */
+    changeFromLastPeriod?: {
+        avgDurationDelta: number;
+        exceededRateDelta: number;
+    };
+}
+/**
+ * 性能异常
+ */
+export interface PerformanceAnomaly {
+    /** 异常类型 */
+    type: 'high_avg_duration' | 'rising_duration' | 'high_exceeded_rate' | 'rising_exceeded_rate' | 'high_error_rate';
+    /** 操作类型 */
+    operation: string;
+    /** 异常描述 */
+    message: string;
+    /** 相关数据 */
+    data: {
+        currentValue: number;
+        threshold: number;
+        trend?: 'rising' | 'falling' | 'stable';
+    };
+    /** 检测时间 */
+    detectedAt: number;
+    /** 建议的下一步 */
+    suggestedAction?: 'optimize' | 'adjust_threshold' | 'notify_user';
+}
+/**
+ * 性能追踪过滤条件
+ */
+export interface PerformanceTraceFilter {
+    /** 操作类型（可选） */
+    operation?: string;
+    /** 结果类型（可选） */
+    result?: 'ok' | 'exceeded' | 'error';
+    /** 时间范围（可选） */
+    timeRange?: {
+        start: number;
+        end: number;
+    };
+    /** 项目路径（可选） */
+    projectPath?: string;
+    /** 会话 ID（可选） */
+    sessionId?: string;
+    /** 任务 ID（可选） */
+    taskId?: string;
+    /** 角色 ID（可选） */
+    roleId?: string;
+}
+/**
+ * PerformanceCollector 配置
+ */
+export interface PerformanceCollectorConfig {
+    /** 日志文件路径，默认 .harness/logs/performance.log */
+    logFile?: string;
+    /** 最大文件大小（字节），超出则滚动，默认 10MB */
+    maxFileSize?: number;
+    /** 是否启用（默认 true） */
+    enabled?: boolean;
+}
+/**
+ * PerformanceAnalyzer 配置
+ */
+export interface PerformanceAnalyzerConfig {
+    /** Summary 文件路径 */
+    summaryFile?: string;
+    /** 周期长度（毫秒），默认 1 小时 */
+    periodMs?: number;
+    /** 异常阈值 */
+    thresholds?: {
+        /** 平均耗时阈值（毫秒），超过则告警 */
+        avgDuration?: number;
+        /** 超阈值率阈值，默认 0.3 */
+        exceededRate?: number;
+        /** 错误率阈值，默认 0.1 */
+        errorRate?: number;
+    };
+}
+/**
+ * Token 使用记录
+ */
+export interface TokenUsageRecord {
+    /** 时间戳 */
+    timestamp: number;
+    /** 会话/会议 ID */
+    sessionId: string;
+    /** 任务 ID（可选） */
+    taskId?: string;
+    /** 角色 ID（可选） */
+    roleId?: string;
+    /** 上下文 Token 数 */
+    contextTokens: number;
+    /** 执行 Token 数 */
+    executionTokens: number;
+    /** 总 Token 数 */
+    totalTokens: number;
+    /** 预算 */
+    budget: number;
+    /** 是否超预算 */
+    exceeded: boolean;
+    /** 项目路径 */
+    projectPath?: string;
+}
+/**
+ * Token 使用统计
+ */
+export interface TokenUsageSummary {
+    /** 会话 ID */
+    sessionId: string;
+    /** 时间范围 */
+    timeRange: {
+        start: number;
+        end: number;
+    };
+    /** 总 Token 使用 */
+    totalTokens: number;
+    /** 平均每次 Token 使用 */
+    avgTokensPerCall: number;
+    /** 超预算次数 */
+    exceededCount: number;
+    /** 超预算率 */
+    exceededRate: number;
+    /** 按任务统计 */
+    byTask?: Map<string, number>;
+    /** 按角色统计 */
+    byRole?: Map<string, number>;
+}
+//# sourceMappingURL=performance.d.ts.map

package/dist/types/performance.d.ts.map

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

package/dist/types/performance.js

@@ -0,0 +1,12 @@
+"use strict";
+/**
+ * Performance Trace 类型定义
+ *
+ * 轻量设计：只记录核心信息，零 Token 成本
+ *
+ * 与 ExecutionTrace 的区别：
+ * - ExecutionTrace: 记录约束检查结果（业务行为）
+ * - PerformanceTrace: 记录操作耗时（性能指标）
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=performance.js.map

package/dist/types/performance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance.js","sourceRoot":"","sources":["../../src/types/performance.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dommaker/harness",
-  "version": "0.7.3",
+  "version": "0.7.4",
   "description": "通用工程约束框架 - 铁律系统、检查点验证、测试门控、拦截器",
   "keywords": [
     "harness",
@@ -47,6 +47,7 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
+    "@dommaker/harness": "file:dommaker-harness-0.7.3.tgz",
     "chalk": "^4.1.2",
     "commander": "^12.0.0",
     "fast-glob": "^3.3.3",
@@ -54,6 +55,7 @@
     "zod": "^3.22.4"
   },
   "devDependencies": {
+    "@types/glob": "^8.1.0",
     "@types/jest": "^29.5.0",
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^20.11.0",