yuangs 5.43.0 → 5.45.0

package/dist/core/ConfigManager.js

@@ -0,0 +1,127 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configManager = exports.ConfigManager = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const js_yaml_1 = __importDefault(require("js-yaml"));
+const errors_1 = require("./errors");
+const Logger_1 = require("../utils/Logger");
+const DEFAULT_CONFIG = {
+    git: {
+        auto: {
+            model: 'Assistant',
+            maxTasks: 5,
+            minScore: 85,
+            autoCommit: false,
+            reviewLevel: 'standard',
+        },
+        reviewThreshold: 7,
+    },
+    ui: {
+        theme: 'auto',
+        showProgress: true,
+        useEmoji: true,
+    },
+    ai: {
+        defaultModel: 'Assistant',
+        temperature: 0.7,
+        maxTokens: 2000,
+    },
+};
+const CONFIG_FILES = [
+    '.yuangsrc',
+    '.yuangsrc.json',
+    '.yuangsrc.yaml',
+    '.yuangsrc.yml',
+    'yuangs.config.json',
+];
+class ConfigManager {
+    cwd;
+    config = DEFAULT_CONFIG;
+    configPath = null;
+    constructor(cwd = process.cwd()) {
+        this.cwd = cwd;
+    }
+    /**
+     * Initialize and load configuration from disk
+     */
+    async init() {
+        const configPath = this.findConfigFile();
+        if (configPath) {
+            this.configPath = configPath;
+            await this.loadConfig(configPath);
+        }
+    }
+    findConfigFile() {
+        for (const file of CONFIG_FILES) {
+            const fullPath = path_1.default.join(this.cwd, file);
+            if (fs_1.default.existsSync(fullPath)) {
+                return fullPath;
+            }
+        }
+        // Check home directory as well
+        const homeDir = process.env.HOME || process.env.USERPROFILE;
+        if (homeDir) {
+            for (const file of CONFIG_FILES) {
+                const fullPath = path_1.default.join(homeDir, file);
+                if (fs_1.default.existsSync(fullPath)) {
+                    return fullPath;
+                }
+            }
+        }
+        return null;
+    }
+    async loadConfig(filePath) {
+        try {
+            const content = await fs_1.default.promises.readFile(filePath, 'utf8');
+            let parsed;
+            if (filePath.endsWith('.yaml') || filePath.endsWith('.yml') || !filePath.includes('.')) {
+                parsed = js_yaml_1.default.load(content);
+            }
+            else {
+                parsed = JSON.parse(content);
+            }
+            this.config = this.deepMerge(DEFAULT_CONFIG, parsed || {});
+            Logger_1.logger.debug('Config', `Configuration loaded from ${filePath}`);
+        }
+        catch (error) {
+            throw new errors_1.ConfigError(`Failed to load config: ${error.message}`, [
+                `Check if ${filePath} is a valid JSON or YAML file.`,
+            ]);
+        }
+    }
+    deepMerge(target, source) {
+        const result = { ...target };
+        for (const key in source) {
+            if (source[key] && typeof source[key] === 'object' && !Array.isArray(source[key])) {
+                result[key] = this.deepMerge(target[key] || {}, source[key]);
+            }
+            else {
+                result[key] = source[key];
+            }
+        }
+        return result;
+    }
+    get(path) {
+        const parts = path.split('.');
+        let value = this.config;
+        for (const part of parts) {
+            if (value === undefined || value === null)
+                return undefined;
+            value = value[part];
+        }
+        return value;
+    }
+    getAll() {
+        return this.config;
+    }
+    getConfigPath() {
+        return this.configPath;
+    }
+}
+exports.ConfigManager = ConfigManager;
+exports.configManager = new ConfigManager();
+//# sourceMappingURL=ConfigManager.js.map

package/dist/core/ConfigManager.js.map

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

package/dist/core/GlobalErrorHandler.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Global error handler for the CLI
+ */
+export declare class GlobalErrorHandler {
+    /**
+     * Standard way to display errors to the user
+     */
+    static handleError(error: any, context?: string): void;
+    private static getGenericSuggestions;
+}

package/dist/core/GlobalErrorHandler.js

@@ -0,0 +1,65 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GlobalErrorHandler = void 0;
+const chalk_1 = __importDefault(require("chalk"));
+const errors_1 = require("./errors");
+const Logger_1 = require("../utils/Logger");
+/**
+ * Global error handler for the CLI
+ */
+class GlobalErrorHandler {
+    /**
+     * Standard way to display errors to the user
+     */
+    static handleError(error, context) {
+        const isYuangsError = error instanceof errors_1.YuangsError;
+        // Log the error details
+        Logger_1.logger.error(context || 'Global', error.message, {
+            code: isYuangsError ? error.code : 'UNKNOWN',
+            stack: error.stack
+        });
+        console.log('\n' + chalk_1.default.red.bold('✕ Error: ') + chalk_1.default.white(error.message));
+        if (isYuangsError && error.code) {
+            console.log(chalk_1.default.gray(`Code: ${error.code}`));
+        }
+        if (isYuangsError && error.suggestions && error.suggestions.length > 0) {
+            console.log('\n' + chalk_1.default.yellow.bold('💡 Suggestions:'));
+            error.suggestions.forEach(suggestion => {
+                console.log(chalk_1.default.yellow(`  • ${suggestion}`));
+            });
+        }
+        else {
+            // Generic suggestions based on common error patterns
+            const genericSuggestions = this.getGenericSuggestions(error);
+            if (genericSuggestions.length > 0) {
+                console.log('\n' + chalk_1.default.cyan.bold('💡 Suggestions:'));
+                genericSuggestions.forEach(suggestion => {
+                    console.log(chalk_1.default.cyan(`  • ${suggestion}`));
+                });
+            }
+        }
+        console.log(''); // New line for spacing
+    }
+    static getGenericSuggestions(error) {
+        const message = error.message?.toLowerCase() || '';
+        const suggestions = [];
+        if (message.includes('not a git repository')) {
+            suggestions.push('Run this command inside a Git repository.', 'Use "git init" to create a new repository.');
+        }
+        else if (message.includes('permission denied') || message.includes('eacces')) {
+            suggestions.push('Try running with elevated permissions.', 'Check the file/directory ownership.');
+        }
+        else if (message.includes('enoent')) {
+            suggestions.push('Verify that the file or directory exists.');
+        }
+        else if (message.includes('network') || message.includes('econn')) {
+            suggestions.push('Check your internet connection.', 'Verify if the remote service is up.');
+        }
+        return suggestions;
+    }
+}
+exports.GlobalErrorHandler = GlobalErrorHandler;
+//# sourceMappingURL=GlobalErrorHandler.js.map

package/dist/core/GlobalErrorHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GlobalErrorHandler.js","sourceRoot":"","sources":["../../src/core/GlobalErrorHandler.ts"],"names":[],"mappings":";;;;;;AAAA,kDAA0B;AAC1B,qCAAuC;AACvC,4CAAyC;AAEzC;;GAEG;AACH,MAAa,kBAAkB;IAC3B;;OAEG;IACI,MAAM,CAAC,WAAW,CAAC,KAAU,EAAE,OAAgB;QAClD,MAAM,aAAa,GAAG,KAAK,YAAY,oBAAW,CAAC;QAEnD,wBAAwB;QACxB,eAAM,CAAC,KAAK,CAAC,OAAO,IAAI,QAAQ,EAAE,KAAK,CAAC,OAAO,EAAE;YAC7C,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;YAC5C,KAAK,EAAE,KAAK,CAAC,KAAK;SACrB,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,eAAK,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,eAAK,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QAE7E,IAAI,aAAa,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YAC9B,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACnD,CAAC;QAED,IAAI,aAAa,IAAI,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrE,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,eAAK,CAAC,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC;YACzD,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE;gBACnC,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,MAAM,CAAC,OAAO,UAAU,EAAE,CAAC,CAAC,CAAC;YACnD,CAAC,CAAC,CAAC;QACP,CAAC;aAAM,CAAC;YACJ,qDAAqD;YACrD,MAAM,kBAAkB,GAAG,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC;YAC7D,IAAI,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAChC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,eAAK,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC;gBACvD,kBAAkB,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE;oBACpC,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,OAAO,UAAU,EAAE,CAAC,CAAC,CAAC;gBACjD,CAAC,CAAC,CAAC;YACP,CAAC;QACL,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,uBAAuB;IAC5C,CAAC;IAEO,MAAM,CAAC,qBAAqB,CAAC,KAAU;QAC3C,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;QACnD,MAAM,WAAW,GAAa,EAAE,CAAC;QAEjC,IAAI,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,CAAC;YAC3C,WAAW,CAAC,IAAI,CAAC,2CAA2C,EAAE,4CAA4C,CAAC,CAAC;QAChH,CAAC;aAAM,IAAI,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7E,WAAW,CAAC,IAAI,CAAC,wCAAwC,EAAE,qCAAqC,CAAC,CAAC;QACtG,CAAC;aAAM,IAAI,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YACpC,WAAW,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;QAClE,CAAC;aAAM,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAClE,WAAW,CAAC,IAAI,CAAC,iCAAiC,EAAE,qCAAqC,CAAC,CAAC;QAC/F,CAAC;QAED,OAAO,WAAW,CAAC;IACvB,CAAC;CACJ;AAtDD,gDAsDC"}

package/dist/core/capability/CapabilityLevel.d.ts

@@ -1,125 +1,57 @@
 /**
- * Git 能力等级枚举
- *
- * 定义了不同层级的代码理解和处理能力，用于：
- * - 评估任务的复杂度
- * - 决定降级策略
- * - 选择合适的 AI 模型和工具
- *
- * 等级说明：
- * - SEMANTIC (5): 语义理解，需要理解代码意图和设计模式
- * - STRUCTURAL (4): 结构分析，需要理解代码结构和依赖关系
- * - LINE (3): 行级分析，需要理解具体代码行逻辑
- * - TEXT (2): 文本分析，只需要处理文本内容
- * - NONE (1): 无需智能分析
+ * CapabilityLevel
+ * ----------------
+ * 定义系统中「能力（Capability）」的智能等级。
+ *
+ * 该等级用于：
+ * - AI Capability 匹配
+ * - 模型路由规划
+ * - 执行阶段降级决策
+ * - todo.md 任务标注
+ *
+ * 级别说明：
+ * - SEMANTIC: 极致语义，理解业务意图和全局架构
+ * - STRUCTURAL: 结构分析，理解代码依赖和模块接口
+ * - LINE: 行级操作，关注具体逻辑实现
+ * - TEXT: 文本处理，简单的替换或格式化
+ * - NONE: 无智能要求
  */
 export declare enum CapabilityLevel {
-    SEMANTIC = 5,
-    STRUCTURAL = 4,
-    LINE = 3,
-    TEXT = 2,
-    NONE = 1
+    /** 极致语义：理解业务、架构和设计意图 */
+    SEMANTIC = 4,
+    /** 结构分析：理解模块依赖、接口和类结构 */
+    STRUCTURAL = 3,
+    /** 行级分析：理解具体的代码行逻辑 */
+    LINE = 2,
+    /** 文本分析：简单的字符串处理和文本替换 */
+    TEXT = 1,
+    /** 无需智能分析 */
+    NONE = 0
 }
 /**
- * 将 CapabilityLevel 枚举转换为字符串
- * @param level 能力等级
- * @returns 字符串表示
- */
-export declare function capabilityLevelToString(level: CapabilityLevel): string;
-/**
- * 将字符串转换为 CapabilityLevel
- * 用于从配置或 LLM 输出解析能力等级
- *
- * @param str 能力等级字符串（不区分大小写）
- * @returns CapabilityLevel 枚举值，如果字符串无效则返回 undefined
- *
- * @example
- * ```typescript
- * const level = stringToCapabilityLevel('semantic');
- * console.log(level); // CapabilityLevel.SEMANTIC
- *
- * const invalid = stringToCapabilityLevel('INVALID');
- * console.log(invalid); // undefined
- * ```
+ * 校验 Capability 降级链是否严格单调递减，且最终降级到 NONE
  */
-export declare function stringToCapabilityLevel(str: string): CapabilityLevel | undefined;
+export declare function validateStrictDecreasing(chain: CapabilityLevel[]): boolean;
 /**
- * 比较两个能力等级
- * @param a 第一个能力等级
- * @param b 第二个能力等级
- * @returns 正数表示 a > b，负数表示 a < b，0 表示相等
+ * 能力等级的可读标签
  */
-export declare function compareCapabilities(a: CapabilityLevel, b: CapabilityLevel): number;
+export declare const CapabilityLevelLabel: Record<CapabilityLevel, string>;
 /**
- * 判断能力等级 a 是否高于 b
- * @param a 第一个能力等级
- * @param b 第二个能力等级
- * @returns 如果 a > b 返回 true
- */
-export declare function isCapabilityHigher(a: CapabilityLevel, b: CapabilityLevel): boolean;
-/**
- * 判断能力等级 a 是否低于 b
- * @param a 第一个能力等级
- * @param b 第二个能力等级
- * @returns 如果 a < b 返回 true
- */
-export declare function isCapabilityLower(a: CapabilityLevel, b: CapabilityLevel): boolean;
-/**
- * 验证能力等级序列的单调性（严格递减）
- * 用于检查 fallbackChain 是否符合从高到低的要求
- *
- * @param levels 能力等级数组
- * @returns 如果序列严格递减返回 true
- *
- * @example
- * ```typescript
- * validateCapabilityMonotonicity([
- *   CapabilityLevel.SEMANTIC,
- *   CapabilityLevel.STRUCTURAL,
- *   CapabilityLevel.NONE
- * ]); // true
- *
- * validateCapabilityMonotonicity([
- *   CapabilityLevel.TEXT,
- *   CapabilityLevel.SEMANTIC
- * ]); // false
- * ```
- */
-export declare function validateCapabilityMonotonicity(levels: CapabilityLevel[]): boolean;
-/**
- * 最小能力和降级链接口
- * 定义模块的能力需求和降级路径
+ * 最小能力要求配置接口
  */
 export interface MinCapability {
     minCapability: CapabilityLevel;
     fallbackChain: CapabilityLevel[];
 }
 /**
- * 验证降级链的有效性
- *
- * 规则：
- * 1. 降级链必须严格递减（从高到低）
- * 2. 降级链必须以 NONE 结束
- *
- * @param minCapability 包含最小能力和降级链的对象
- * @returns 如果降级链有效返回 true
- *
- * @example
- * ```typescript
- * validateFallbackChain({
- *   minCapability: CapabilityLevel.SEMANTIC,
- *   fallbackChain: [CapabilityLevel.STRUCTURAL, CapabilityLevel.TEXT, CapabilityLevel.NONE]
- * }); // true
- *
- * validateFallbackChain({
- *   minCapability: CapabilityLevel.SEMANTIC,
- *   fallbackChain: [CapabilityLevel.NONE]
- * }); // true
- *
- * validateFallbackChain({
- *   minCapability: CapabilityLevel.SEMANTIC,
- *   fallbackChain: [CapabilityLevel.TEXT] // 未以 NONE 结束
- * }); // false
- * ```
+ * 从字符串解析 CapabilityLevel (支持标签或数值字符串)
+ */
+export declare function parseCapabilityLevel(value?: string | number, fallback?: CapabilityLevel): CapabilityLevel;
+/**
+ * 判断能力是否满足要求
+ */
+export declare function canExecute(current: CapabilityLevel, required: CapabilityLevel): boolean;
+/**
+ * 获取能力等级的友好显示名称
  */
-export declare function validateFallbackChain(minCapability: MinCapability): boolean;
+export declare function describeCapabilityLevel(level: CapabilityLevel): string;

package/dist/core/capability/CapabilityLevel.js

@@ -1,184 +1,101 @@
 "use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CapabilityLevel = void 0;
-exports.capabilityLevelToString = capabilityLevelToString;
-exports.stringToCapabilityLevel = stringToCapabilityLevel;
-exports.compareCapabilities = compareCapabilities;
-exports.isCapabilityHigher = isCapabilityHigher;
-exports.isCapabilityLower = isCapabilityLower;
-exports.validateCapabilityMonotonicity = validateCapabilityMonotonicity;
-exports.validateFallbackChain = validateFallbackChain;
 /**
- * Git 能力等级枚举
+ * CapabilityLevel
+ * ----------------
+ * 定义系统中「能力（Capability）」的智能等级。
  *
- * 定义了不同层级的代码理解和处理能力，用于：
- * - 评估任务的复杂度
- * - 决定降级策略
- * - 选择合适的 AI 模型和工具
+ * 该等级用于：
+ * - AI Capability 匹配
+ * - 模型路由规划
+ * - 执行阶段降级决策
+ * - todo.md 任务标注
  *
- * 等级说明：
- * - SEMANTIC (5): 语义理解，需要理解代码意图和设计模式
- * - STRUCTURAL (4): 结构分析，需要理解代码结构和依赖关系
- * - LINE (3): 行级分析，需要理解具体代码行逻辑
- * - TEXT (2): 文本分析，只需要处理文本内容
- * - NONE (1): 无需智能分析
+ * 级别说明：
+ * - SEMANTIC: 极致语义，理解业务意图和全局架构
+ * - STRUCTURAL: 结构分析，理解代码依赖和模块接口
+ * - LINE: 行级操作，关注具体逻辑实现
+ * - TEXT: 文本处理，简单的替换或格式化
+ * - NONE: 无智能要求
  */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CapabilityLevelLabel = exports.CapabilityLevel = void 0;
+exports.validateStrictDecreasing = validateStrictDecreasing;
+exports.parseCapabilityLevel = parseCapabilityLevel;
+exports.canExecute = canExecute;
+exports.describeCapabilityLevel = describeCapabilityLevel;
 var CapabilityLevel;
 (function (CapabilityLevel) {
-    CapabilityLevel[CapabilityLevel["SEMANTIC"] = 5] = "SEMANTIC";
-    CapabilityLevel[CapabilityLevel["STRUCTURAL"] = 4] = "STRUCTURAL";
-    CapabilityLevel[CapabilityLevel["LINE"] = 3] = "LINE";
-    CapabilityLevel[CapabilityLevel["TEXT"] = 2] = "TEXT";
-    CapabilityLevel[CapabilityLevel["NONE"] = 1] = "NONE";
+    /** 极致语义：理解业务、架构和设计意图 */
+    CapabilityLevel[CapabilityLevel["SEMANTIC"] = 4] = "SEMANTIC";
+    /** 结构分析：理解模块依赖、接口和类结构 */
+    CapabilityLevel[CapabilityLevel["STRUCTURAL"] = 3] = "STRUCTURAL";
+    /** 行级分析：理解具体的代码行逻辑 */
+    CapabilityLevel[CapabilityLevel["LINE"] = 2] = "LINE";
+    /** 文本分析：简单的字符串处理和文本替换 */
+    CapabilityLevel[CapabilityLevel["TEXT"] = 1] = "TEXT";
+    /** 无需智能分析 */
+    CapabilityLevel[CapabilityLevel["NONE"] = 0] = "NONE";
 })(CapabilityLevel || (exports.CapabilityLevel = CapabilityLevel = {}));
 /**
- * 将 CapabilityLevel 枚举转换为字符串
- * @param level 能力等级
- * @returns 字符串表示
+ * 校验 Capability 降级链是否严格单调递减，且最终降级到 NONE
  */
-function capabilityLevelToString(level) {
-    switch (level) {
-        case CapabilityLevel.SEMANTIC:
-            return 'SEMANTIC';
-        case CapabilityLevel.STRUCTURAL:
-            return 'STRUCTURAL';
-        case CapabilityLevel.LINE:
-            return 'LINE';
-        case CapabilityLevel.TEXT:
-            return 'TEXT';
-        case CapabilityLevel.NONE:
-            return 'NONE';
-        default:
-            // 如果传入未知值，返回其数字表示
-            return String(level);
-    }
-}
-/**
- * 将字符串转换为 CapabilityLevel
- * 用于从配置或 LLM 输出解析能力等级
- *
- * @param str 能力等级字符串（不区分大小写）
- * @returns CapabilityLevel 枚举值，如果字符串无效则返回 undefined
- *
- * @example
- * ```typescript
- * const level = stringToCapabilityLevel('semantic');
- * console.log(level); // CapabilityLevel.SEMANTIC
- *
- * const invalid = stringToCapabilityLevel('INVALID');
- * console.log(invalid); // undefined
- * ```
- */
-function stringToCapabilityLevel(str) {
-    const upper = str.toUpperCase();
-    switch (upper) {
-        case 'SEMANTIC':
-            return CapabilityLevel.SEMANTIC;
-        case 'STRUCTURAL':
-            return CapabilityLevel.STRUCTURAL;
-        case 'LINE':
-            return CapabilityLevel.LINE;
-        case 'TEXT':
-            return CapabilityLevel.TEXT;
-        case 'NONE':
-            return CapabilityLevel.NONE;
-        default:
-            return undefined;
+function validateStrictDecreasing(chain) {
+    if (chain.length === 0)
+        return true;
+    for (let i = 0; i < chain.length - 1; i++) {
+        if (chain[i] <= chain[i + 1])
+            return false;
     }
+    return chain[chain.length - 1] === CapabilityLevel.NONE;
 }
 /**
- * 比较两个能力等级
- * @param a 第一个能力等级
- * @param b 第二个能力等级
- * @returns 正数表示 a > b，负数表示 a < b，0 表示相等
- */
-function compareCapabilities(a, b) {
-    return a - b;
-}
-/**
- * 判断能力等级 a 是否高于 b
- * @param a 第一个能力等级
- * @param b 第二个能力等级
- * @returns 如果 a > b 返回 true
+ * 能力等级的可读标签
  */
-function isCapabilityHigher(a, b) {
-    return a > b;
-}
+exports.CapabilityLevelLabel = {
+    [CapabilityLevel.SEMANTIC]: 'semantic',
+    [CapabilityLevel.STRUCTURAL]: 'structural',
+    [CapabilityLevel.LINE]: 'line',
+    [CapabilityLevel.TEXT]: 'text',
+    [CapabilityLevel.NONE]: 'none'
+};
 /**
- * 判断能力等级 a 是否低于 b
- * @param a 第一个能力等级
- * @param b 第二个能力等级
- * @returns 如果 a < b 返回 true
+ * 从字符串解析 CapabilityLevel (支持标签或数值字符串)
  */
-function isCapabilityLower(a, b) {
-    return a < b;
+function parseCapabilityLevel(value, fallback = CapabilityLevel.NONE) {
+    if (value === undefined || value === null)
+        return fallback;
+    if (typeof value === 'number') {
+        return CapabilityLevel[value] !== undefined ? value : fallback;
+    }
+    const normalized = value.toString().toLowerCase();
+    // 1. 尝试按标签匹配
+    for (const [level, label] of Object.entries(exports.CapabilityLevelLabel)) {
+        if (label === normalized)
+            return Number(level);
+    }
+    // 2. 尝试解析数值字符串
+    const numeric = parseInt(normalized);
+    if (!isNaN(numeric)) {
+        return CapabilityLevel[numeric] !== undefined ? numeric : fallback;
+    }
+    return fallback;
 }
 /**
- * 验证能力等级序列的单调性（严格递减）
- * 用于检查 fallbackChain 是否符合从高到低的要求
- *
- * @param levels 能力等级数组
- * @returns 如果序列严格递减返回 true
- *
- * @example
- * ```typescript
- * validateCapabilityMonotonicity([
- *   CapabilityLevel.SEMANTIC,
- *   CapabilityLevel.STRUCTURAL,
- *   CapabilityLevel.NONE
- * ]); // true
- *
- * validateCapabilityMonotonicity([
- *   CapabilityLevel.TEXT,
- *   CapabilityLevel.SEMANTIC
- * ]); // false
- * ```
+ * 判断能力是否满足要求
  */
-function validateCapabilityMonotonicity(levels) {
-    if (levels.length <= 1)
-        return true;
-    for (let i = 0; i < levels.length - 1; i++) {
-        if (levels[i] <= levels[i + 1]) {
-            return false;
-        }
-    }
-    return true;
+function canExecute(current, required) {
+    return current >= required;
 }
 /**
- * 验证降级链的有效性
- *
- * 规则：
- * 1. 降级链必须严格递减（从高到低）
- * 2. 降级链必须以 NONE 结束
- *
- * @param minCapability 包含最小能力和降级链的对象
- * @returns 如果降级链有效返回 true
- *
- * @example
- * ```typescript
- * validateFallbackChain({
- *   minCapability: CapabilityLevel.SEMANTIC,
- *   fallbackChain: [CapabilityLevel.STRUCTURAL, CapabilityLevel.TEXT, CapabilityLevel.NONE]
- * }); // true
- *
- * validateFallbackChain({
- *   minCapability: CapabilityLevel.SEMANTIC,
- *   fallbackChain: [CapabilityLevel.NONE]
- * }); // true
- *
- * validateFallbackChain({
- *   minCapability: CapabilityLevel.SEMANTIC,
- *   fallbackChain: [CapabilityLevel.TEXT] // 未以 NONE 结束
- * }); // false
- * ```
+ * 获取能力等级的友好显示名称
  */
-function validateFallbackChain(minCapability) {
-    if (minCapability.fallbackChain.length === 0) {
-        return true;
-    }
-    if (!validateCapabilityMonotonicity([minCapability.minCapability, ...minCapability.fallbackChain])) {
-        return false;
+function describeCapabilityLevel(level) {
+    switch (level) {
+        case CapabilityLevel.SEMANTIC: return '极致语义 (Semantic)';
+        case CapabilityLevel.STRUCTURAL: return '结构分析 (Structural)';
+        case CapabilityLevel.LINE: return '行级分析 (Line)';
+        case CapabilityLevel.TEXT: return '文本处理 (Text)';
+        default: return '无智能要求 (None)';
     }
-    return minCapability.fallbackChain[minCapability.fallbackChain.length - 1] === CapabilityLevel.NONE;
 }
 //# sourceMappingURL=CapabilityLevel.js.map

package/dist/core/capability/CapabilityLevel.js.map

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