@dommaker/harness 1.1.1 → 1.2.1

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

@@ -1,47 +0,0 @@
-/**
- * 代码注释规范检查器
- *
- * 检查代码中的 @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

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

@@ -1,279 +0,0 @@
-"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"));
-const file_walk_1 = require("../utils/file-walk");
-// 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',
-            });
-        }
-    }
-}
-/**
- * 递归获取目录下所有文件（收敛到 utils/file-walk 的 walkFiles，工单 O3）
- */
-function getFilesRecursively(dir, extensions) {
-    return (0, file_walk_1.walkFiles)(dir, {
-        skipDirs: ['node_modules', 'dist'],
-        filter: (name) => extensions.includes(path.extname(name)) && !name.endsWith('.d.ts'),
-    });
-}
-/**
- * 批量检查目录
- */
-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

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

package/dist/types/enforcement.d.ts

@@ -1,42 +0,0 @@
-/**
- * Enforcement 执行器类型定义
- */
-import type { Constraint, ConstraintContext } from './constraint';
-export type EnforcementId = string;
-export interface EnforcementContext extends ConstraintContext {
-    enforcementId: EnforcementId;
-    constraint: Constraint;
-    params?: Record<string, any>;
-}
-export interface EnforcementResult {
-    passed: boolean;
-    evidence?: string;
-    message?: string;
-    error?: string;
-    duration?: number;
-    validatedAt?: Date;
-}
-export interface EnforcementExecutor {
-    execute(context: EnforcementContext): Promise<EnforcementResult>;
-    description?: string;
-    supportedParams?: string[];
-}
-export interface EnforcementRegistration {
-    id: EnforcementId;
-    executor: EnforcementExecutor;
-    registeredAt: Date;
-    source?: string;
-}
-export interface InterceptionResult {
-    passed: boolean;
-    constraints: {
-        constraint: Constraint;
-        enforcementResult?: EnforcementResult;
-        skipped?: boolean;
-        skipReason?: string;
-    }[];
-    violations: Constraint[];
-    message?: string;
-    interceptedAt: Date;
-}
-//# sourceMappingURL=enforcement.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"enforcement.d.ts","sourceRoot":"","sources":["../../src/types/enforcement.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAElE,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC;AAEnC,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB;IAC3D,aAAa,EAAE,aAAa,CAAC;IAC7B,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,IAAI,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACjE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,aAAa,CAAC;IAClB,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,YAAY,EAAE,IAAI,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE;QACX,UAAU,EAAE,UAAU,CAAC;QACvB,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;QACtC,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,EAAE,CAAC;IACJ,UAAU,EAAE,UAAU,EAAE,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,IAAI,CAAC;CACrB"}

package/dist/types/enforcement.js

@@ -1,6 +0,0 @@
-"use strict";
-/**
- * Enforcement 执行器类型定义
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=enforcement.js.map

package/dist/types/enforcement.js.map

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

package/dist/types/monitoring-types.d.ts

@@ -1,53 +0,0 @@
-/**
- * 监控域类型（诊断）
- *
- * 原定义位于 monitoring/constraint-doctor.ts，
- * 但被 types/index.ts 反向再导出（类型层依赖业务模块，分层倒挂）。
- * 工单 14 将类型定义归位到 types 层，monitoring 改从 types 导入。
- */
-import type { ExecutionTrace } from './trace';
-/**
- * 诊断结果
- */
-export interface Diagnosis {
-    /** 异常 ID */
-    anomalyId: string;
-    /** 约束 ID */
-    constraintId: string;
-    /** 诊断时间 */
-    diagnosedAt: number;
-    /** 根因分析 */
-    rootCause: {
-        /** 主要原因 */
-        primary: string;
-        /** 次要原因 */
-        secondary?: string[];
-        /** 相关 traces */
-        evidence: ExecutionTrace[];
-    };
-    /** 影响评估 */
-    impact: {
-        /** 影响程度 */
-        severity: 'low' | 'medium' | 'high';
-        /** 影响范围 */
-        scope: 'single_project' | 'multiple_projects' | 'team';
-        /** 用户影响 */
-        userImpact: string;
-    };
-    /** 改进建议 */
-    recommendations: {
-        /** 建议类型 */
-        type: 'add_exception' | 'adjust_threshold' | 'modify_constraint' | 'user_training';
-        /** 建议内容 */
-        content: string;
-        /** 预期效果 */
-        expectedOutcome: string;
-        /** 实施成本 */
-        implementationCost: 'low' | 'medium' | 'high';
-    }[];
-    /** 是否需要变更 */
-    needsChange: boolean;
-    /** 紧急程度 */
-    urgency: 'low' | 'medium' | 'high';
-}
-//# sourceMappingURL=monitoring-types.d.ts.map

package/dist/types/monitoring-types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"monitoring-types.d.ts","sourceRoot":"","sources":["../../src/types/monitoring-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,YAAY;IACZ,SAAS,EAAE,MAAM,CAAC;IAElB,YAAY;IACZ,YAAY,EAAE,MAAM,CAAC;IAErB,WAAW;IACX,WAAW,EAAE,MAAM,CAAC;IAEpB,WAAW;IACX,SAAS,EAAE;QACT,WAAW;QACX,OAAO,EAAE,MAAM,CAAC;QAEhB,WAAW;QACX,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QAErB,gBAAgB;QAChB,QAAQ,EAAE,cAAc,EAAE,CAAC;KAC5B,CAAC;IAEF,WAAW;IACX,MAAM,EAAE;QACN,WAAW;QACX,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;QAEpC,WAAW;QACX,KAAK,EAAE,gBAAgB,GAAG,mBAAmB,GAAG,MAAM,CAAC;QAEvD,WAAW;QACX,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IAEF,WAAW;IACX,eAAe,EAAE;QACf,WAAW;QACX,IAAI,EAAE,eAAe,GAAG,kBAAkB,GAAG,mBAAmB,GAAG,eAAe,CAAC;QAEnF,WAAW;QACX,OAAO,EAAE,MAAM,CAAC;QAEhB,WAAW;QACX,eAAe,EAAE,MAAM,CAAC;QAExB,WAAW;QACX,kBAAkB,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;KAC/C,EAAE,CAAC;IAEJ,aAAa;IACb,WAAW,EAAE,OAAO,CAAC;IAErB,WAAW;IACX,OAAO,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CACpC"}

package/dist/types/monitoring-types.js

@@ -1,10 +0,0 @@
-"use strict";
-/**
- * 监控域类型（诊断）
- *
- * 原定义位于 monitoring/constraint-doctor.ts，
- * 但被 types/index.ts 反向再导出（类型层依赖业务模块，分层倒挂）。
- * 工单 14 将类型定义归位到 types 层，monitoring 改从 types 导入。
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=monitoring-types.js.map

package/dist/types/monitoring-types.js.map

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

package/dist/types/performance.d.ts

@@ -1,204 +0,0 @@
-/**
- * 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