yuangs 3.23.0 → 3.26.0

package/dist/core/capabilitySystem.d.ts

@@ -10,7 +10,7 @@ export declare class CapabilitySystem {
     loadMergedConfig(): MergedConfig;
     loadCustomModels(): ModelCapabilities[];
     getAllModels(): ModelCapabilities[];
-    createAndSaveExecutionRecord(commandName: string, requirement: CapabilityRequirement, matchResult: CapabilityMatchResult, command?: string): string;
+    createAndSaveExecutionRecord(commandName: string, requirement: CapabilityRequirement, matchResult: CapabilityMatchResult, command?: string, rawInput?: string, mode?: string): string;
     replayExecution(recordId: string, options: ReplayOptions): Promise<ReplayResult>;
     explainConfig(): string;
 }

package/dist/core/capabilitySystem.js

@@ -50,9 +50,9 @@ class CapabilitySystem {
         const customModels = this.loadCustomModels();
         return [...this.primaryModels, ...this.fallbackModels, ...customModels];
     }
-    createAndSaveExecutionRecord(commandName, requirement, matchResult, command) {
+    createAndSaveExecutionRecord(commandName, requirement, matchResult, command, rawInput, mode) {
         const config = this.loadMergedConfig();
-        const record = (0, executionRecord_1.createExecutionRecord)(commandName, requirement, config, matchResult, { success: matchResult.selected !== null }, command);
+        const record = (0, executionRecord_1.createExecutionRecord)(commandName, requirement, config, matchResult, { success: matchResult.selected !== null }, command, rawInput, mode);
         const filePath = (0, executionStore_1.saveExecutionRecord)(record);
         return record.id;
     }

package/dist/core/capabilitySystem.js.map

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

package/dist/core/executionRecord.d.ts

@@ -9,6 +9,7 @@ export interface ExecutionMeta {
     projectPath: string;
     args?: any;
     rawInput?: string;
+    mode?: string;
     replayable?: boolean;
     version?: string;
 }
@@ -43,6 +44,6 @@ export interface ExecutionRecord {
     command?: string;
 }
 export declare function createExecutionId(): string;
-export declare function createExecutionRecord(commandName: string, requirement: CapabilityRequirement, config: MergedConfig, matchResult: any, outcome?: Partial<ExecutionOutcome>, command?: string): ExecutionRecord;
+export declare function createExecutionRecord(commandName: string, requirement: CapabilityRequirement, config: MergedConfig, matchResult: any, outcome?: Partial<ExecutionOutcome>, command?: string, rawInput?: string, mode?: string): ExecutionRecord;
 export declare function serializeExecutionRecord(record: ExecutionRecord): string;
 export declare function deserializeExecutionRecord(json: string): ExecutionRecord;

package/dist/core/executionRecord.js

@@ -7,7 +7,7 @@ exports.deserializeExecutionRecord = deserializeExecutionRecord;
 function createExecutionId() {
     return `exec_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
 }
-function createExecutionRecord(commandName, requirement, config, matchResult, outcome = {}, command) {
+function createExecutionRecord(commandName, requirement, config, matchResult, outcome = {}, command, rawInput, mode) {
     const version = require('../../package.json').version;
     return {
         id: createExecutionId(),
@@ -16,6 +16,8 @@ function createExecutionRecord(commandName, requirement, config, matchResult, ou
             timestamp: new Date().toISOString(),
             toolVersion: version,
             projectPath: process.cwd(),
+            rawInput,
+            mode,
             version,
             replayable: true,
         },

package/dist/core/executionRecord.js.map

@@ -1 +1 @@
-{"version":3,"file":"executionRecord.js","sourceRoot":"","sources":["../../src/core/executionRecord.ts"],"names":[],"mappings":";;AAkDA,8CAEC;AAED,sDAqCC;AAED,4DAEC;AAED,gEAEC;AAjDD,SAAgB,iBAAiB;IAC/B,OAAO,QAAQ,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AACzE,CAAC;AAED,SAAgB,qBAAqB,CACnC,WAAmB,EACnB,WAAkC,EAClC,MAAoB,EACpB,WAAgB,EAChB,UAAqC,EAAE,EACvC,OAAgB;IAEhB,MAAM,OAAO,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC,OAAO,CAAC;IAEtD,OAAO;QACL,EAAE,EAAE,iBAAiB,EAAE;QACvB,IAAI,EAAE;YACJ,WAAW;YACX,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,WAAW,EAAE,OAAO;YACpB,WAAW,EAAE,OAAO,CAAC,GAAG,EAAE;YAC1B,OAAO;YACP,UAAU,EAAE,IAAI;SACjB;QACD,MAAM,EAAE;YACN,QAAQ,EAAE,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC;YAC1C,SAAS,EAAE,WAAW,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC;YAC5C,iBAAiB,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC,kBAAkB;SAChE;QACD,cAAc,EAAE,MAAM;QACtB,QAAQ,EAAE;YACR,eAAe,EAAE,WAAW,CAAC,UAAU,IAAI,EAAE;YAC7C,aAAa,EAAE,WAAW,CAAC,QAAQ;YACnC,YAAY,EAAE,WAAW,CAAC,gBAAgB;SAC3C;QACD,OAAO,EAAE;YACP,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,KAAK;YACjC,GAAG,OAAO;SACX;QACD,OAAO;KACR,CAAC;AACJ,CAAC;AAED,SAAgB,wBAAwB,CAAC,MAAuB;IAC9D,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACzC,CAAC;AAED,SAAgB,0BAA0B,CAAC,IAAY;IACrD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAoB,CAAC;AAC7C,CAAC"}
+{"version":3,"file":"executionRecord.js","sourceRoot":"","sources":["../../src/core/executionRecord.ts"],"names":[],"mappings":";;AAmDA,8CAEC;AAED,sDAyCC;AAED,4DAEC;AAED,gEAEC;AArDD,SAAgB,iBAAiB;IAC/B,OAAO,QAAQ,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AACzE,CAAC;AAED,SAAgB,qBAAqB,CACnC,WAAmB,EACnB,WAAkC,EAClC,MAAoB,EACpB,WAAgB,EAChB,UAAqC,EAAE,EACvC,OAAgB,EAChB,QAAiB,EACjB,IAAa;IAEb,MAAM,OAAO,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC,OAAO,CAAC;IAEtD,OAAO;QACL,EAAE,EAAE,iBAAiB,EAAE;QACvB,IAAI,EAAE;YACJ,WAAW;YACX,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,WAAW,EAAE,OAAO;YACpB,WAAW,EAAE,OAAO,CAAC,GAAG,EAAE;YAC1B,QAAQ;YACR,IAAI;YACJ,OAAO;YACP,UAAU,EAAE,IAAI;SACjB;QACD,MAAM,EAAE;YACN,QAAQ,EAAE,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC;YAC1C,SAAS,EAAE,WAAW,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC;YAC5C,iBAAiB,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC,kBAAkB;SAChE;QACD,cAAc,EAAE,MAAM;QACtB,QAAQ,EAAE;YACR,eAAe,EAAE,WAAW,CAAC,UAAU,IAAI,EAAE;YAC7C,aAAa,EAAE,WAAW,CAAC,QAAQ;YACnC,YAAY,EAAE,WAAW,CAAC,gBAAgB;SAC3C;QACD,OAAO,EAAE;YACP,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,KAAK;YACjC,GAAG,OAAO;SACX;QACD,OAAO;KACR,CAAC;AACJ,CAAC;AAED,SAAgB,wBAAwB,CAAC,MAAuB;IAC9D,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACzC,CAAC;AAED,SAAgB,0BAA0B,CAAC,IAAY;IACrD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAoB,CAAC;AAC7C,CAAC"}

package/dist/core/kernel/ASTParser.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Enhanced AST Parser for X-Resolver
+ *
+ * 增强版 AST 解析器，支持：
+ * 1. 提取导出符号（函数、类、接口、类型别名）
+ * 2. 提取 JSDoc 注释和标签
+ * 3. 提供符号的完整元数据（名称、类型、JSDoc、行号等）
+ *
+ * 使用 TypeScript Compiler API 实现精确解析
+ */
+/**
+ * 符号元数据接口
+ */
+export interface SymbolMetadata {
+    /** 符号名称 */
+    name: string;
+    /** 符号类型 */
+    kind: string;
+    /** JSDoc 注释内容 */
+    jsDoc: string;
+    /** 起始行号（从1开始） */
+    startLine: number;
+    /** 是否已导出 */
+    isExported: boolean;
+}
+/**
+ * AST 解析结果
+ */
+export interface ASTParseResult {
+    /** 提取的符号列表 */
+    symbols: SymbolMetadata[];
+    /** 解析是否成功 */
+    success: boolean;
+    /** 错误信息（如果失败） */
+    error?: string;
+}
+/**
+ * 增强版 AST 解析器
+ *
+ * 为 X-Resolver 提供精确的符号提取能力
+ */
+export declare class EnhancedASTParser {
+    /**
+     * 从文件中提取导出符号及其 JSDoc
+     *
+     * @param filePath - 要解析的文件路径
+     * @returns 包含符号元数据的解析结果
+     */
+    parseFile(filePath: string): Promise<ASTParseResult>;
+    /**
+     * 从代码字符串中提取导出符号及其 JSDoc
+     *
+     * @param code - 要解析的代码字符串
+     * @param filePath - 文件路径（用于错误消息和行号计算）
+     * @returns 包含符号元数据的解析结果
+     */
+    parse(code: string, filePath: string): ASTParseResult;
+    /**
+     * 递归遍历 AST 节点，提取导出符号及其 JSDoc
+     *
+     * @param node - AST 节点
+     * @param symbols - 符号列表（输出参数）
+     */
+    private visitAndExtractSymbols;
+    /**
+     * 从节点提取 JSDoc 注释
+     *
+     * @param node - AST 节点
+     * @returns 提取的 JSDoc 文档字符串
+     */
+    private extractJSDoc;
+    /**
+     * 将 TypeScript 节点类型映射为可读字符串
+     *
+     * @param kind - TypeScript 语法种类
+     * @returns 可读的符号类型字符串
+     */
+    private mapNodeKindToString;
+    /**
+     * 获取文件中所有导出的符号名称（快捷方法）
+     *
+     * @param filePath - 文件路径
+     * @returns 导出符号名称数组
+     */
+    getExportedSymbolNames(filePath: string): Promise<string[]>;
+}

package/dist/core/kernel/ASTParser.js

@@ -0,0 +1,208 @@
+"use strict";
+/**
+ * Enhanced AST Parser for X-Resolver
+ *
+ * 增强版 AST 解析器，支持：
+ * 1. 提取导出符号（函数、类、接口、类型别名）
+ * 2. 提取 JSDoc 注释和标签
+ * 3. 提供符号的完整元数据（名称、类型、JSDoc、行号等）
+ *
+ * 使用 TypeScript Compiler API 实现精确解析
+ */
+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.EnhancedASTParser = void 0;
+const ts = __importStar(require("typescript"));
+const fs = __importStar(require("fs/promises"));
+/**
+ * 增强版 AST 解析器
+ *
+ * 为 X-Resolver 提供精确的符号提取能力
+ */
+class EnhancedASTParser {
+    /**
+     * 从文件中提取导出符号及其 JSDoc
+     *
+     * @param filePath - 要解析的文件路径
+     * @returns 包含符号元数据的解析结果
+     */
+    async parseFile(filePath) {
+        try {
+            const content = await fs.readFile(filePath, 'utf-8');
+            return this.parse(content, filePath);
+        }
+        catch (error) {
+            return {
+                symbols: [],
+                success: false,
+                error: error instanceof Error ? error.message : 'Failed to read file'
+            };
+        }
+    }
+    /**
+     * 从代码字符串中提取导出符号及其 JSDoc
+     *
+     * @param code - 要解析的代码字符串
+     * @param filePath - 文件路径（用于错误消息和行号计算）
+     * @returns 包含符号元数据的解析结果
+     */
+    parse(code, filePath) {
+        try {
+            const sourceFile = ts.createSourceFile(filePath, code, ts.ScriptTarget.Latest, true);
+            const symbols = [];
+            this.visitAndExtractSymbols(sourceFile, symbols);
+            return {
+                symbols,
+                success: true
+            };
+        }
+        catch (error) {
+            return {
+                symbols: [],
+                success: false,
+                error: error instanceof Error ? error.message : 'Unknown parsing error'
+            };
+        }
+    }
+    /**
+     * 递归遍历 AST 节点，提取导出符号及其 JSDoc
+     *
+     * @param node - AST 节点
+     * @param symbols - 符号列表（输出参数）
+     */
+    visitAndExtractSymbols(node, symbols) {
+        let isExported = false;
+        // 检查节点是否有导出修饰符（仅在支持的节点类型上）
+        if (ts.canHaveModifiers(node)) {
+            const modifiers = ts.getModifiers(node);
+            isExported = modifiers?.some(m => m.kind === ts.SyntaxKind.ExportKeyword) ?? false;
+        }
+        // 提取符号名称和 JSDoc
+        let name = '';
+        let kind = '';
+        if ((ts.isFunctionDeclaration(node) ||
+            ts.isClassDeclaration(node) ||
+            ts.isInterfaceDeclaration(node) ||
+            ts.isTypeAliasDeclaration(node) ||
+            ts.isEnumDeclaration(node)) && node.name) {
+            name = node.name.text;
+            kind = this.mapNodeKindToString(node.kind);
+        }
+        else if (ts.isVariableStatement(node) && isExported) {
+            const declaration = node.declarationList.declarations[0];
+            if (declaration && ts.isIdentifier(declaration.name)) {
+                name = declaration.name.text;
+                kind = 'Variable';
+            }
+        }
+        // 如果找到了符号名称，提取其元数据
+        if (name) {
+            const sourceFile = node.getSourceFile();
+            const startLine = sourceFile.getLineAndCharacterOfPosition(node.getStart()).line + 1;
+            const jsDoc = this.extractJSDoc(node);
+            symbols.push({
+                name,
+                kind,
+                jsDoc,
+                startLine,
+                isExported
+            });
+        }
+        // 递归处理子节点
+        ts.forEachChild(node, (child) => this.visitAndExtractSymbols(child, symbols));
+    }
+    /**
+     * 从节点提取 JSDoc 注释
+     *
+     * @param node - AST 节点
+     * @returns 提取的 JSDoc 文档字符串
+     */
+    extractJSDoc(node) {
+        const jsDocNodes = node.jsDoc;
+        if (!jsDocNodes || !Array.isArray(jsDocNodes) || jsDocNodes.length === 0) {
+            return '';
+        }
+        const jsDoc = jsDocNodes[0];
+        const comment = jsDoc.comment || '';
+        const tags = jsDoc.tags?.map((tag) => {
+            const tagName = tag.tagName?.text || '';
+            const tagComment = tag.comment || '';
+            const paramName = tag.name?.text || '';
+            const paramText = paramName ? `${tagName} ${paramName}` : tagName;
+            return tagComment ? `@${paramText} ${tagComment}` : `@${paramText}`;
+        }).join('\n') || '';
+        const docText = [comment, tags].filter(Boolean).join('\n').trim();
+        return docText;
+    }
+    /**
+     * 将 TypeScript 节点类型映射为可读字符串
+     *
+     * @param kind - TypeScript 语法种类
+     * @returns 可读的符号类型字符串
+     */
+    mapNodeKindToString(kind) {
+        switch (kind) {
+            case ts.SyntaxKind.FunctionDeclaration:
+                return 'Function';
+            case ts.SyntaxKind.ClassDeclaration:
+                return 'Class';
+            case ts.SyntaxKind.InterfaceDeclaration:
+                return 'Interface';
+            case ts.SyntaxKind.TypeAliasDeclaration:
+                return 'Type';
+            case ts.SyntaxKind.EnumDeclaration:
+                return 'Enum';
+            case ts.SyntaxKind.VariableStatement:
+                return 'Variable';
+            default:
+                return 'Symbol';
+        }
+    }
+    /**
+     * 获取文件中所有导出的符号名称（快捷方法）
+     *
+     * @param filePath - 文件路径
+     * @returns 导出符号名称数组
+     */
+    async getExportedSymbolNames(filePath) {
+        const result = await this.parseFile(filePath);
+        if (!result.success) {
+            return [];
+        }
+        return result.symbols.filter(s => s.isExported).map(s => s.name);
+    }
+}
+exports.EnhancedASTParser = EnhancedASTParser;
+//# sourceMappingURL=ASTParser.js.map

package/dist/core/kernel/ASTParser.js.map

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

package/dist/core/kernel/AtomicTransactionManager.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Atomic Transaction Manager for X-Resolver
+ *
+ * 原子事务管理器 - 确保多文件修改的原子性
+ *
+ * 核心功能：
+ * 1. 开启多文件组合事务
+ * 2. 为事务中的文件创建快照
+ * 3. 验证并提交事务
+ * 4. 失败时全盘回退
+ */
+/**
+ * 事务状态
+ */
+export declare enum TransactionState {
+    /** 未开始 */
+    IDLE = "idle",
+    /** 进行中 */
+    ACTIVE = "active",
+    /** 已提交 */
+    COMMITTED = "committed",
+    /** 已回滚 */
+    ROLLED_BACK = "rolled_back"
+}
+/**
+ * 事务元数据
+ */
+export interface TransactionMetadata {
+    /** 事务 ID */
+    id: string;
+    /** 事务名称 */
+    name: string;
+    /** 涉及的文件列表 */
+    files: string[];
+    /** 事务状态 */
+    state: TransactionState;
+    /** 创建时间 */
+    createdAt: Date;
+    /** 快照目录路径 */
+    snapshotDir: string;
+}
+/**
+ * 事务提交结果
+ */
+export interface CommitResult {
+    /** 是否成功 */
+    success: boolean;
+    /** 提交的文件数量 */
+    filesCommitted: number;
+    /** 错误信息（如果失败） */
+    error?: string;
+}
+/**
+ * 原子事务管理器
+ *
+ * 管理多文件修改的原子性，确保要么全部成功，要么全部回滚
+ */
+export declare class AtomicTransactionManager {
+    private transactions;
+    private snapshotBaseDir;
+    constructor(snapshotBaseDir?: string);
+    /**
+     * 生成唯一事务 ID
+     */
+    private generateTransactionId;
+    /**
+     * 开启多文件组合事务
+     *
+     * @param taskName - 任务名称
+     * @param files - 涉及的文件列表
+     * @returns 事务 ID
+     */
+    startBatch(taskName: string, files: string[]): Promise<string>;
+    /**
+     * 为单个文件创建快照
+     */
+    private createSnapshot;
+    /**
+     * 提交事务
+     *
+     * @param transactionId - 事务 ID
+     * @returns 提交结果
+     */
+    commitBatch(transactionId: string): Promise<CommitResult>;
+    /**
+     * 回滚事务
+     *
+     * @param transactionId - 事务 ID
+     */
+    abortBatch(transactionId: string): Promise<void>;
+    /**
+     * 全盘回退到快照状态
+     */
+    private rollbackAll;
+    /**
+     * 清理快照目录
+     */
+    private clearSnapshots;
+    /**
+     * 列出快照目录中的所有文件
+     */
+    private listSnapshotFiles;
+    /**
+     * 获取事务状态
+     */
+    getTransactionState(transactionId: string): TransactionState | null;
+    /**
+     * 清理所有已完成的事务
+     */
+    cleanupCompletedTransactions(): Promise<void>;
+    /**
+     * 获取活跃事务列表
+     */
+    getActiveTransactions(): TransactionMetadata[];
+    /**
+     * 设置快照基础目录
+     */
+    setSnapshotBaseDir(dir: string): void;
+}