@dommaker/harness 0.9.0 → 0.10.0

package/dist/cli/commands/traces.js

@@ -0,0 +1,167 @@
+"use strict";
+/**
+ * Trace CLI 命令
+ *
+ * 查看和分析 Execution Traces
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tracesCommand = tracesCommand;
+const traces_1 = require("../../monitoring/traces");
+const trace_analyzer_1 = require("../../monitoring/trace-analyzer");
+/**
+ * trace 命令
+ */
+async function tracesCommand(subcommand, options) {
+    switch (subcommand) {
+        case 'stats':
+            await showStats(options);
+            break;
+        case 'summary':
+            await showSummary(options);
+            break;
+        case 'anomalies':
+            await showAnomalies(options);
+            break;
+        case 'report':
+            await generateReport(options);
+            break;
+        case 'clean':
+            await cleanTraces(options);
+            break;
+        default:
+            console.log('Usage: harness traces <subcommand>');
+            console.log('');
+            console.log('Subcommands:');
+            console.log('  stats     Show trace file statistics');
+            console.log('  summary   Show constraint summaries');
+            console.log('  anomalies Show detected anomalies');
+            console.log('  report    Generate full report');
+            console.log('  clean     Clean old trace files');
+            console.log('');
+            console.log('Options:');
+            console.log('  --hours <n>       Analyze last N hours (default: 1)');
+            console.log('  --constraint <id> Filter by constraint ID');
+            console.log('  --format <format> Output format: json or text (default: text)');
+    }
+}
+/**
+ * 显示 trace 文件统计
+ */
+async function showStats(options) {
+    const collector = (0, traces_1.getTraceCollector)();
+    const stats = collector.getStats();
+    if (options.format === 'json') {
+        console.log(JSON.stringify(stats, null, 2));
+    }
+    else {
+        console.log('📊 Trace File Statistics');
+        console.log('');
+        console.log(`File: ${collector.getStats().fileExists ? '✅ exists' : '❌ not found'}`);
+        if (stats.fileExists) {
+            console.log(`Size: ${(stats.fileSize / 1024).toFixed(2)} KB`);
+            console.log(`Lines: ${stats.totalLines}`);
+            if (stats.oldestTrace) {
+                console.log(`Oldest: ${new Date(stats.oldestTrace).toISOString()}`);
+            }
+            if (stats.newestTrace) {
+                console.log(`Newest: ${new Date(stats.newestTrace).toISOString()}`);
+            }
+        }
+    }
+}
+/**
+ * 显示约束汇总
+ */
+async function showSummary(options) {
+    const hours = options.hours || 1;
+    const analyzer = (0, trace_analyzer_1.createAnalyzer)();
+    let summaries;
+    if (options.constraintId) {
+        summaries = analyzer.analyzeConstraint(options.constraintId);
+    }
+    else {
+        summaries = analyzer.analyzeRecent(hours);
+    }
+    if (options.format === 'json') {
+        console.log(JSON.stringify(summaries, null, 2));
+    }
+    else {
+        console.log(`📈 Constraint Summaries (last ${hours}h)`);
+        console.log('');
+        if (summaries.length === 0) {
+            console.log('No traces found.');
+            return;
+        }
+        for (const summary of summaries) {
+            const levelEmoji = {
+                iron_law: '🔴',
+                guideline: '🟡',
+                tip: '🔵',
+            }[summary.level];
+            const trendEmoji = {
+                rising: '📈',
+                falling: '📉',
+                stable: '➡️',
+            }[summary.recentTrend];
+            console.log(`${levelEmoji} ${summary.constraintId}`);
+            console.log(`   Checks: ${summary.totalChecks}`);
+            console.log(`   Pass: ${Math.round(summary.passRate * 100)}%`);
+            console.log(`   Fail: ${Math.round(summary.failRate * 100)}%`);
+            console.log(`   Bypass: ${Math.round(summary.bypassRate * 100)}%`);
+            console.log(`   Trend: ${trendEmoji} ${summary.recentTrend}`);
+            console.log('');
+        }
+    }
+}
+/**
+ * 显示异常检测结果
+ */
+async function showAnomalies(options) {
+    const hours = options.hours || 24;
+    const analyzer = (0, trace_analyzer_1.createAnalyzer)();
+    const anomalies = analyzer.runDailyAnomalyCheck();
+    if (options.format === 'json') {
+        console.log(JSON.stringify(anomalies, null, 2));
+    }
+    else {
+        console.log(`⚠️ Anomalies Detected (last ${hours}h)`);
+        console.log('');
+        if (anomalies.length === 0) {
+            console.log('✅ No anomalies detected.');
+            return;
+        }
+        for (const anomaly of anomalies) {
+            console.log(`⚠️ ${anomaly.type}: ${anomaly.constraintId}`);
+            console.log(`   ${anomaly.message}`);
+            console.log(`   Suggested: ${anomaly.suggestedAction}`);
+            console.log('');
+        }
+        console.log(`Total: ${anomalies.length} anomalies`);
+    }
+}
+/**
+ * 生成完整报告
+ */
+async function generateReport(options) {
+    const hours = options.hours || 24;
+    const analyzer = (0, trace_analyzer_1.createAnalyzer)();
+    const summaries = analyzer.analyzeRecent(hours);
+    const anomalies = analyzer.detectAnomalies(summaries);
+    if (options.format === 'json') {
+        console.log(JSON.stringify({ summaries, anomalies }, null, 2));
+    }
+    else {
+        const report = analyzer.generateReport(summaries, anomalies);
+        console.log(report);
+    }
+}
+/**
+ * 清理旧 trace 文件
+ */
+async function cleanTraces(options) {
+    const maxAgeDays = options.maxAgeDays || 30;
+    const collector = (0, traces_1.getTraceCollector)();
+    const deletedCount = collector.cleanupOldFiles(maxAgeDays);
+    console.log(`🧹 Cleaned ${deletedCount} old trace files (older than ${maxAgeDays} days)`);
+}
+//# sourceMappingURL=traces.js.map

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

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

package/dist/constraints/index.d.ts

@@ -1,5 +1,4 @@
 export * from './types';
-export * from './safety';
-export * from './quality';
 export * from './registry';
+export * from './lifecycle-runner';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/constraints/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/constraints/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC"}

package/dist/constraints/index.js

@@ -15,7 +15,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./types"), exports);
-__exportStar(require("./safety"), exports);
-__exportStar(require("./quality"), exports);
 __exportStar(require("./registry"), exports);
+__exportStar(require("./lifecycle-runner"), exports);
 //# sourceMappingURL=index.js.map

package/dist/constraints/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/constraints/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,2CAAyB;AACzB,4CAA0B;AAC1B,6CAA2B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/constraints/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,6CAA2B;AAC3B,qDAAmC"}

package/dist/constraints/lifecycle-runner.d.ts

@@ -0,0 +1,52 @@
+/**
+ * 约束生命周期执行器
+ *
+ * 将 ConstraintEvolver 生成的提案转化为 ConstraintRegistry 实际操作。
+ * 连接 monitoring 层（proposal）和 constraints 层（registry）。
+ */
+import { ConstraintRegistry } from './registry';
+import type { ConstraintProposal } from '../monitoring/constraint-evolver';
+import type { ConstraintLevel } from '../types/constraint';
+import type { DeprecationSchedule } from './types';
+/**
+ * 提案执行结果
+ */
+export interface ExecutionResult {
+    proposalId: string;
+    constraintId: string;
+    action: string;
+    success: boolean;
+    details: string;
+}
+/**
+ * 约束生命周期执行器
+ *
+ * 将 evolver 的提案（proposal）转化为 registry 的实际操作（degrade/rollback/scheduleDeprecation）
+ */
+export declare class ConstraintLifecycleRunner {
+    private registry;
+    constructor(registry?: ConstraintRegistry);
+    getRegistry(): ConstraintRegistry;
+    /**
+     * 执行单个已接受的提案
+     */
+    execute(proposal: ConstraintProposal): ExecutionResult;
+    /**
+     * 批量执行提案
+     */
+    executeBatch(proposals: ConstraintProposal[]): ExecutionResult[];
+    /**
+     * 回滚已降级的约束
+     */
+    rollbackConstraint(constraintId: string, originalLevel: ConstraintLevel): boolean;
+    /**
+     * 设置约束的弃用计划
+     */
+    scheduleDeprecation(constraintId: string, schedule: DeprecationSchedule): boolean;
+    private executeLevelChange;
+    private executeAddException;
+    private executeAdjustTrigger;
+    private executeModifyMessage;
+    private failResult;
+}
+//# sourceMappingURL=lifecycle-runner.d.ts.map

package/dist/constraints/lifecycle-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-runner.d.ts","sourceRoot":"","sources":["../../src/constraints/lifecycle-runner.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,qBAAa,yBAAyB;IACpC,OAAO,CAAC,QAAQ,CAAqB;gBAEzB,QAAQ,CAAC,EAAE,kBAAkB;IAIzC,WAAW,IAAI,kBAAkB;IAIjC;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,kBAAkB,GAAG,eAAe;IAqBtD;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,kBAAkB,EAAE,GAAG,eAAe,EAAE;IAIhE;;OAEG;IACH,kBAAkB,CAAC,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,eAAe,GAAG,OAAO;IAIjF;;OAEG;IACH,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,mBAAmB,GAAG,OAAO;IAIjF,OAAO,CAAC,kBAAkB;IA8B1B,OAAO,CAAC,mBAAmB;IAyB3B,OAAO,CAAC,oBAAoB;IAkB5B,OAAO,CAAC,oBAAoB;IAiB5B,OAAO,CAAC,UAAU;CASnB"}

package/dist/constraints/lifecycle-runner.js

@@ -0,0 +1,151 @@
+"use strict";
+/**
+ * 约束生命周期执行器
+ *
+ * 将 ConstraintEvolver 生成的提案转化为 ConstraintRegistry 实际操作。
+ * 连接 monitoring 层（proposal）和 constraints 层（registry）。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConstraintLifecycleRunner = void 0;
+const registry_1 = require("./registry");
+/**
+ * 约束生命周期执行器
+ *
+ * 将 evolver 的提案（proposal）转化为 registry 的实际操作（degrade/rollback/scheduleDeprecation）
+ */
+class ConstraintLifecycleRunner {
+    registry;
+    constructor(registry) {
+        this.registry = registry || new registry_1.ConstraintRegistry();
+    }
+    getRegistry() {
+        return this.registry;
+    }
+    /**
+     * 执行单个已接受的提案
+     */
+    execute(proposal) {
+        switch (proposal.type) {
+            case 'change_level':
+                return this.executeLevelChange(proposal);
+            case 'add_exception':
+                return this.executeAddException(proposal);
+            case 'adjust_trigger':
+                return this.executeAdjustTrigger(proposal);
+            case 'modify_message':
+                return this.executeModifyMessage(proposal);
+            default:
+                return {
+                    proposalId: proposal.id,
+                    constraintId: proposal.constraintId,
+                    action: proposal.type,
+                    success: false,
+                    details: `Unsupported proposal type: ${proposal.type}`,
+                };
+        }
+    }
+    /**
+     * 批量执行提案
+     */
+    executeBatch(proposals) {
+        return proposals.map(p => this.execute(p));
+    }
+    /**
+     * 回滚已降级的约束
+     */
+    rollbackConstraint(constraintId, originalLevel) {
+        return this.registry.rollback(constraintId, originalLevel);
+    }
+    /**
+     * 设置约束的弃用计划
+     */
+    scheduleDeprecation(constraintId, schedule) {
+        return this.registry.scheduleDeprecation(constraintId, schedule);
+    }
+    executeLevelChange(proposal) {
+        const constraint = this.registry.get(proposal.constraintId);
+        if (!constraint) {
+            return this.failResult(proposal, `Constraint ${proposal.constraintId} not found`);
+        }
+        if (constraint.layer === 'safety') {
+            return this.failResult(proposal, 'Cannot change level of safety-layer constraint');
+        }
+        const targetLevel = proposal.content.proposed;
+        const currentLevel = constraint.level;
+        const levelOrder = { iron_law: 0, guideline: 1, tip: 2 };
+        if ((levelOrder[targetLevel] ?? 99) > (levelOrder[currentLevel] ?? 0)) {
+            const success = this.registry.degrade(proposal.constraintId);
+            return {
+                proposalId: proposal.id,
+                constraintId: proposal.constraintId,
+                action: 'degrade',
+                success,
+                details: success
+                    ? `Degraded from ${currentLevel} to ${targetLevel}`
+                    : 'Degradation failed',
+            };
+        }
+        return this.failResult(proposal, 'Level change direction not supported via registry');
+    }
+    executeAddException(proposal) {
+        const constraint = this.registry.get(proposal.constraintId);
+        if (!constraint) {
+            return this.failResult(proposal, `Constraint ${proposal.constraintId} not found`);
+        }
+        const exception = proposal.content.proposed;
+        const currentExceptions = constraint.exceptions || [];
+        if (currentExceptions.includes(exception)) {
+            return this.failResult(proposal, `Exception ${exception} already exists`);
+        }
+        if (!constraint.exceptions)
+            constraint.exceptions = [];
+        constraint.exceptions.push(exception);
+        return {
+            proposalId: proposal.id,
+            constraintId: proposal.constraintId,
+            action: 'add_exception',
+            success: true,
+            details: `Added exception: ${exception}`,
+        };
+    }
+    executeAdjustTrigger(proposal) {
+        const constraint = this.registry.get(proposal.constraintId);
+        if (!constraint) {
+            return this.failResult(proposal, `Constraint ${proposal.constraintId} not found`);
+        }
+        const oldTrigger = constraint.trigger;
+        constraint.trigger = proposal.content.proposed;
+        return {
+            proposalId: proposal.id,
+            constraintId: proposal.constraintId,
+            action: 'adjust_trigger',
+            success: true,
+            details: `Changed trigger from ${JSON.stringify(oldTrigger)} to ${JSON.stringify(proposal.content.proposed)}`,
+        };
+    }
+    executeModifyMessage(proposal) {
+        const constraint = this.registry.get(proposal.constraintId);
+        if (!constraint) {
+            return this.failResult(proposal, `Constraint ${proposal.constraintId} not found`);
+        }
+        constraint.message = proposal.content.proposed;
+        return {
+            proposalId: proposal.id,
+            constraintId: proposal.constraintId,
+            action: 'modify_message',
+            success: true,
+            details: 'Updated message',
+        };
+    }
+    failResult(proposal, details) {
+        return {
+            proposalId: proposal.id,
+            constraintId: proposal.constraintId,
+            action: proposal.type,
+            success: false,
+            details,
+        };
+    }
+}
+exports.ConstraintLifecycleRunner = ConstraintLifecycleRunner;
+//# sourceMappingURL=lifecycle-runner.js.map

package/dist/constraints/lifecycle-runner.js.map

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

package/dist/constraints/registry.d.ts

@@ -1,64 +1,26 @@
 /**
  * 约束注册表
  *
- * 统一管理安全层和质量层约束，提供分层查询、退化管理
+ * 基于 core/constraints/definitions 构建，附加分层和退化元数据。
+ * 分层规则：iron_law → safety（永久），guideline/tip → quality（可退化）
  */
 import type { Constraint, ConstraintLevel, ConstraintTrigger } from '../types/constraint';
 import type { LayeredConstraint, ConstraintLayer, DeprecationStatus, LayerStats, DeprecationSchedule } from './types';
 export declare class ConstraintRegistry {
     private constraints;
     constructor();
-    /**
-     * 获取约束（兼容旧 API）
-     */
     get(id: string): LayeredConstraint | undefined;
-    /**
-     * 获取所有约束
-     */
     getAll(): LayeredConstraint[];
-    /**
-     * 按层获取约束
-     */
     getByLayer(layer: ConstraintLayer): LayeredConstraint[];
-    /**
-     * 按退化状态获取约束
-     */
     getByStatus(status: DeprecationStatus): LayeredConstraint[];
-    /**
-     * 按触发条件查找约束
-     */
     getByTrigger(trigger: ConstraintTrigger): LayeredConstraint[];
-    /**
-     * 获取退化候选（拦截率低于阈值的约束）
-     */
     getDeprecationCandidates(interceptRates: Map<string, number>): LayeredConstraint[];
-    /**
-     * 执行退化：降低约束级别
-     */
     degrade(id: string): boolean;
-    /**
-     * 回滚退化
-     */
     rollback(id: string, originalLevel: ConstraintLevel): boolean;
-    /**
-     * 标记为计划退化
-     */
     scheduleDeprecation(id: string, schedule: DeprecationSchedule): boolean;
-    /**
-     * 获取层统计
-     */
     getLayerStats(): LayerStats[];
-    /**
-     * 转换为旧格式 Constraint（兼容）
-     */
     toLegacyConstraints(): Constraint[];
-    /**
-     * 注册自定义约束
-     */
     register(constraint: LayeredConstraint): void;
-    /**
-     * 移除约束
-     */
     remove(id: string): boolean;
 }
 //# sourceMappingURL=registry.d.ts.map

package/dist/constraints/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/constraints/registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC1F,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,iBAAiB,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAItH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,WAAW,CAAiC;;IAwBpD;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAI9C;;OAEG;IACH,MAAM,IAAI,iBAAiB,EAAE;IAI7B;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,iBAAiB,EAAE;IAIvD;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,iBAAiB,EAAE;IAI3D;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,iBAAiB,GAAG,iBAAiB,EAAE;IAO7D;;OAEG;IACH,wBAAwB,CAAC,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,iBAAiB,EAAE;IAWlF;;OAEG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAU5B;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,eAAe,GAAG,OAAO;IAU7D;;OAEG;IACH,mBAAmB,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,mBAAmB,GAAG,OAAO;IASvE;;OAEG;IACH,aAAa,IAAI,UAAU,EAAE;IAe7B;;OAEG;IACH,mBAAmB,IAAI,UAAU,EAAE;IAcnC;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,iBAAiB,GAAG,IAAI;IAI7C;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;CAG5B"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/constraints/registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC1F,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,iBAAiB,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAkBtH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,WAAW,CAAiC;;IAUpD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAI9C,MAAM,IAAI,iBAAiB,EAAE;IAI7B,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,iBAAiB,EAAE;IAIvD,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,iBAAiB,EAAE;IAI3D,YAAY,CAAC,OAAO,EAAE,iBAAiB,GAAG,iBAAiB,EAAE;IAO7D,wBAAwB,CAAC,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,iBAAiB,EAAE;IAWlF,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAS5B,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,eAAe,GAAG,OAAO;IAS7D,mBAAmB,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,mBAAmB,GAAG,OAAO;IAQvE,aAAa,IAAI,UAAU,EAAE;IAe7B,mBAAmB,IAAI,UAAU,EAAE;IAcnC,QAAQ,CAAC,UAAU,EAAE,iBAAiB,GAAG,IAAI;IAI7C,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;CAG5B"}

package/dist/constraints/registry.js

@@ -2,71 +2,53 @@
 /**
  * 约束注册表
  *
- * 统一管理安全层和质量层约束，提供分层查询、退化管理
+ * 基于 core/constraints/definitions 构建，附加分层和退化元数据。
+ * 分层规则：iron_law → safety（永久），guideline/tip → quality（可退化）
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ConstraintRegistry = void 0;
-const safety_1 = require("./safety");
-const quality_1 = require("./quality");
+const definitions_1 = require("../core/constraints/definitions");
+function toLayered(constraint) {
+    const layer = constraint.level === 'iron_law' ? 'safety' : 'quality';
+    return {
+        ...constraint,
+        layer,
+        deprecationStatus: 'active',
+        permanent: layer === 'safety',
+        deprecationSchedule: layer === 'quality' ? {
+            targetLevel: (constraint.level === 'guideline' ? 'tip' : 'info'),
+            reason: '自动退化：拦截率持续低于阈值',
+            rollbackable: true,
+        } : undefined,
+    };
+}
 class ConstraintRegistry {
     constraints;
     constructor() {
         this.constraints = new Map();
-        // 注册安全层约束（克隆避免修改静态定义）
-        for (const [id, constraint] of Object.entries(safety_1.SAFETY_CONSTRAINTS)) {
-            this.constraints.set(id, {
-                ...constraint,
-                deprecationSchedule: constraint.deprecationSchedule
-                    ? { ...constraint.deprecationSchedule }
-                    : undefined,
-            });
-        }
-        // 注册质量层约束
-        for (const [id, constraint] of Object.entries(quality_1.QUALITY_CONSTRAINTS)) {
-            this.constraints.set(id, {
-                ...constraint,
-                deprecationSchedule: constraint.deprecationSchedule
-                    ? { ...constraint.deprecationSchedule }
-                    : undefined,
-            });
+        const all = { ...definitions_1.IRON_LAWS, ...definitions_1.GUIDELINES, ...definitions_1.TIPS };
+        for (const [id, constraint] of Object.entries(all)) {
+            this.constraints.set(id, toLayered(constraint));
         }
     }
-    /**
-     * 获取约束（兼容旧 API）
-     */
     get(id) {
         return this.constraints.get(id);
     }
-    /**
-     * 获取所有约束
-     */
     getAll() {
         return Array.from(this.constraints.values());
     }
-    /**
-     * 按层获取约束
-     */
     getByLayer(layer) {
         return this.getAll().filter(c => c.layer === layer);
     }
-    /**
-     * 按退化状态获取约束
-     */
     getByStatus(status) {
         return this.getAll().filter(c => c.deprecationStatus === status);
     }
-    /**
-     * 按触发条件查找约束
-     */
     getByTrigger(trigger) {
         return this.getAll().filter(c => {
             const triggers = Array.isArray(c.trigger) ? c.trigger : [c.trigger];
             return triggers.includes(trigger);
         });
     }
-    /**
-     * 获取退化候选（拦截率低于阈值的约束）
-     */
     getDeprecationCandidates(interceptRates) {
         return this.getAll().filter(c => {
             if (c.layer !== 'quality' || !c.deprecationSchedule)
@@ -80,9 +62,6 @@ class ConstraintRegistry {
             return rate !== undefined && rate < threshold;
         });
     }
-    /**
-     * 执行退化：降低约束级别
-     */
     degrade(id) {
         const constraint = this.constraints.get(id);
         if (!constraint || !constraint.deprecationSchedule)
@@ -93,9 +72,6 @@ class ConstraintRegistry {
         constraint.deprecationStatus = 'deprecated';
         return true;
     }
-    /**
-     * 回滚退化
-     */
     rollback(id, originalLevel) {
         const constraint = this.constraints.get(id);
         if (!constraint)
@@ -106,9 +82,6 @@ class ConstraintRegistry {
         constraint.deprecationStatus = 'active';
         return true;
     }
-    /**
-     * 标记为计划退化
-     */
     scheduleDeprecation(id, schedule) {
         const constraint = this.constraints.get(id);
         if (!constraint || constraint.layer !== 'quality')
@@ -117,9 +90,6 @@ class ConstraintRegistry {
         constraint.deprecationStatus = 'scheduled';
         return true;
     }
-    /**
-     * 获取层统计
-     */
     getLayerStats() {
         const layers = ['safety', 'quality'];
         return layers.map(layer => {
@@ -134,9 +104,6 @@ class ConstraintRegistry {
             };
         });
     }
-    /**
-     * 转换为旧格式 Constraint（兼容）
-     */
     toLegacyConstraints() {
         return this.getAll().map(c => ({
             id: c.id,
@@ -150,15 +117,9 @@ class ConstraintRegistry {
             exceptions: c.exceptions,
         }));
     }
-    /**
-     * 注册自定义约束
-     */
     register(constraint) {
         this.constraints.set(constraint.id, constraint);
     }
-    /**
-     * 移除约束
-     */
     remove(id) {
         return this.constraints.delete(id);
     }