yuangs 3.23.0 → 3.26.0

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

@@ -0,0 +1,86 @@
+/**
+ * Post-Check Verifier for Atomic Transactions
+ *
+ * 后验证检查器 - 确保代码修改后的工程质量
+ *
+ * 核心功能：
+ * 1. 执行 TypeScript 类型检查
+ * 2. 运行自定义验证命令
+ * 3. 捕获并结构化错误信息
+ * 4. 为 AI 提供可修复的反馈
+ */
+/**
+ * 验证结果
+ */
+export interface VerificationResult {
+    /** 验证是否通过 */
+    passed: boolean;
+    /** 输出日志（标准输出） */
+    stdout?: string;
+    /** 错误日志（标准错误） */
+    stderr?: string;
+    /** 完整的错误信息 */
+    error?: string;
+    /** 验证耗时（毫秒） */
+    duration: number;
+}
+/**
+ * 验证器配置
+ */
+export interface VerifierConfig {
+    /** TypeScript 检查命令（默认: npx tsc --noEmit） */
+    typeCheckCommand: string;
+    /** 自定义验证命令（可选） */
+    customCheckCommand?: string;
+    /** 工作目录（默认: 当前目录） */
+    cwd?: string;
+    /** 超时时间（毫秒） */
+    timeout?: number;
+}
+/**
+ * 后验证检查器
+ *
+ * 执行编译检查和自定义验证，确保代码修改不会破坏项目
+ */
+export declare class PostCheckVerifier {
+    private config;
+    constructor(config?: Partial<VerifierConfig>);
+    /**
+     * 执行类型检查
+     *
+     * @returns 验证结果
+     */
+    verifyTypeCheck(): Promise<VerificationResult>;
+    /**
+     * 执行自定义验证
+     *
+     * @returns 验证结果
+     */
+    verifyCustomCheck(): Promise<VerificationResult>;
+    /**
+     * 执行所有验证
+     *
+     * @returns 验证结果（任何一项失败即整体失败）
+     */
+    verifyAll(): Promise<VerificationResult>;
+    /**
+     * 运行单个检查命令
+     */
+    private runCheck;
+    /**
+     * 格式化错误信息，便于 AI 理解
+     */
+    formatErrorForAI(result: VerificationResult): string;
+    /**
+     * 提取文件路径和行号（用于定位错误）
+     */
+    extractErrorLocations(result: VerificationResult): Array<{
+        file: string;
+        line: number;
+        message: string;
+    }>;
+    /**
+     * 更新配置
+     */
+    updateConfig(config: Partial<VerifierConfig>): void;
+}

package/dist/core/kernel/PostCheckVerifier.js

@@ -0,0 +1,182 @@
+"use strict";
+/**
+ * Post-Check Verifier for Atomic Transactions
+ *
+ * 后验证检查器 - 确保代码修改后的工程质量
+ *
+ * 核心功能：
+ * 1. 执行 TypeScript 类型检查
+ * 2. 运行自定义验证命令
+ * 3. 捕获并结构化错误信息
+ * 4. 为 AI 提供可修复的反馈
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PostCheckVerifier = void 0;
+const child_process_1 = require("child_process");
+const util_1 = require("util");
+const execAsync = (0, util_1.promisify)(child_process_1.exec);
+/**
+ * 后验证检查器
+ *
+ * 执行编译检查和自定义验证，确保代码修改不会破坏项目
+ */
+class PostCheckVerifier {
+    config;
+    constructor(config) {
+        this.config = {
+            typeCheckCommand: 'npx tsc --noEmit',
+            cwd: process.cwd(),
+            timeout: 60000,
+            ...config
+        };
+    }
+    /**
+     * 执行类型检查
+     *
+     * @returns 验证结果
+     */
+    async verifyTypeCheck() {
+        return this.runCheck(this.config.typeCheckCommand, 'Type Check');
+    }
+    /**
+     * 执行自定义验证
+     *
+     * @returns 验证结果
+     */
+    async verifyCustomCheck() {
+        if (!this.config.customCheckCommand) {
+            return {
+                passed: true,
+                duration: 0
+            };
+        }
+        return this.runCheck(this.config.customCheckCommand, 'Custom Check');
+    }
+    /**
+     * 执行所有验证
+     *
+     * @returns 验证结果（任何一项失败即整体失败）
+     */
+    async verifyAll() {
+        const typeCheckResult = await this.verifyTypeCheck();
+        if (!typeCheckResult.passed) {
+            return {
+                ...typeCheckResult,
+                error: `Type check failed:\n${typeCheckResult.error}`
+            };
+        }
+        const customCheckResult = await this.verifyCustomCheck();
+        if (!customCheckResult.passed) {
+            return {
+                ...customCheckResult,
+                error: `Custom check failed:\n${customCheckResult.error}`
+            };
+        }
+        return {
+            passed: true,
+            duration: typeCheckResult.duration + customCheckResult.duration
+        };
+    }
+    /**
+     * 运行单个检查命令
+     */
+    async runCheck(command, checkName) {
+        const startTime = Date.now();
+        try {
+            console.log(`\n[Verifier] 🛡️ Executing ${checkName}: ${command}...`);
+            const { stdout, stderr } = await execAsync(command, {
+                cwd: this.config.cwd,
+                timeout: this.config.timeout,
+                encoding: 'utf-8'
+            });
+            const duration = Date.now() - startTime;
+            return {
+                passed: true,
+                stdout,
+                stderr,
+                duration
+            };
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            let errorMessage = '';
+            if (error.stdout) {
+                errorMessage += error.stdout;
+            }
+            if (error.stderr) {
+                if (errorMessage)
+                    errorMessage += '\n';
+                errorMessage += error.stderr;
+            }
+            if (error.killed && error.signal === 'SIGTERM') {
+                errorMessage += '\nCommand timed out';
+            }
+            if (!errorMessage) {
+                errorMessage = error.message || 'Unknown error';
+            }
+            return {
+                passed: false,
+                stdout: error.stdout,
+                stderr: error.stderr,
+                error: errorMessage,
+                duration
+            };
+        }
+    }
+    /**
+     * 格式化错误信息，便于 AI 理解
+     */
+    formatErrorForAI(result) {
+        if (result.passed) {
+            return '✅ Verification passed: All checks successful.';
+        }
+        let formatted = '❌ Verification failed. Please fix the following errors:\n\n';
+        if (result.error) {
+            const errorLines = result.error.split('\n');
+            const relevantLines = errorLines.filter(line => {
+                return line.includes('error TS') ||
+                    line.includes('error ') ||
+                    line.includes('Error:');
+            });
+            if (relevantLines.length > 0) {
+                formatted += '=== Type Errors ===\n';
+                formatted += relevantLines.slice(0, 50).join('\n');
+                if (relevantLines.length > 50) {
+                    formatted += `\n... and ${relevantLines.length - 50} more errors`;
+                }
+                formatted += '\n\n';
+            }
+            else {
+                formatted += `=== Error Details ===\n${result.error.slice(0, 2000)}\n\n`;
+            }
+        }
+        return formatted;
+    }
+    /**
+     * 提取文件路径和行号（用于定位错误）
+     */
+    extractErrorLocations(result) {
+        if (result.passed || !result.error) {
+            return [];
+        }
+        const locations = [];
+        const errorPattern = /([^(:]+)\((\d+),\d+\): (error TS\d+: .+)/g;
+        let match;
+        while ((match = errorPattern.exec(result.error)) !== null) {
+            locations.push({
+                file: match[1],
+                line: parseInt(match[2], 10),
+                message: match[3]
+            });
+        }
+        return locations;
+    }
+    /**
+     * 更新配置
+     */
+    updateConfig(config) {
+        this.config = { ...this.config, ...config };
+    }
+}
+exports.PostCheckVerifier = PostCheckVerifier;
+//# sourceMappingURL=PostCheckVerifier.js.map

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

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

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

@@ -0,0 +1,76 @@
+/**
+ * X-Resolver: Cross-File Symbol Dependency Resolver
+ *
+ * 跨文件符号依赖解析器 - yuangs 的全域感知核心
+ *
+ * 核心功能：
+ * 1. 探测目标文件的所有导出符号（函数、类、接口、类型）
+ * 2. 搜索项目中所有引用这些符号的文件
+ * 3. 提取相关的代码片段和 JSDoc 文档
+ * 4. 为 Agent 提供跨文件上下文感知
+ */
+import { EnhancedASTParser, SymbolMetadata } from './ASTParser';
+import { FastScanner } from './FastScanner';
+/**
+ * 符号影响分析结果
+ */
+export interface SymbolImpact {
+    /** 消费者文件路径 */
+    filePath: string;
+    /** 使用的导出符号列表 */
+    symbols: string[];
+    /** 相关代码片段（经过智能切片） */
+    snippet: string;
+    /** 符号的 JSDoc 文档 */
+    jsDoc?: string;
+}
+/**
+ * X-Resolver 解析结果
+ */
+export interface XResolverResult {
+    /** 目标文件路径 */
+    targetFile: string;
+    /** 导出的符号列表 */
+    exportedSymbols: SymbolMetadata[];
+    /** 受影响的使用者列表 */
+    impacts: SymbolImpact[];
+    /** 扫描耗时（毫秒） */
+    duration: number;
+}
+/**
+ * 跨文件符号解析器
+ *
+ * 为 yuangs Agent 提供跨文件依赖感知能力
+ */
+export declare class XResolver {
+    private astParser;
+    private scanner;
+    constructor(astParser?: EnhancedASTParser, scanner?: FastScanner);
+    /**
+     * 分析目标文件的跨文件影响域
+     *
+     * @param targetFilePath - 要分析的目标文件路径
+     * @returns 跨文件影响分析结果
+     */
+    getImpactAnalysis(targetFilePath: string): Promise<XResolverResult>;
+    /**
+     * 从消费者文件中提取相关上下文
+     */
+    private extractImpactContext;
+    /**
+     * 提取相关代码片段（智能切片）
+     */
+    private extractRelevantSnippet;
+    /**
+     * 聚合符号的 JSDoc
+     */
+    private getAggregatedJSDoc;
+    /**
+     * 渲染为 AI 友好的上下文格式
+     */
+    renderAsAIContext(result: XResolverResult): string;
+    /**
+     * 快捷方法：仅获取导出符号
+     */
+    getExportedSymbols(filePath: string): Promise<SymbolMetadata[]>;
+}

package/dist/core/kernel/XResolver.js

@@ -0,0 +1,217 @@
+"use strict";
+/**
+ * X-Resolver: Cross-File Symbol Dependency Resolver
+ *
+ * 跨文件符号依赖解析器 - yuangs 的全域感知核心
+ *
+ * 核心功能：
+ * 1. 探测目标文件的所有导出符号（函数、类、接口、类型）
+ * 2. 搜索项目中所有引用这些符号的文件
+ * 3. 提取相关的代码片段和 JSDoc 文档
+ * 4. 为 Agent 提供跨文件上下文感知
+ */
+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.XResolver = void 0;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+const ASTParser_1 = require("./ASTParser");
+const FastScanner_1 = require("./FastScanner");
+const ts = __importStar(require("typescript"));
+/**
+ * 跨文件符号解析器
+ *
+ * 为 yuangs Agent 提供跨文件依赖感知能力
+ */
+class XResolver {
+    astParser;
+    scanner;
+    constructor(astParser, scanner) {
+        this.astParser = astParser || new ASTParser_1.EnhancedASTParser();
+        this.scanner = scanner || new FastScanner_1.FastScanner();
+    }
+    /**
+     * 分析目标文件的跨文件影响域
+     *
+     * @param targetFilePath - 要分析的目标文件路径
+     * @returns 跨文件影响分析结果
+     */
+    async getImpactAnalysis(targetFilePath) {
+        const startTime = Date.now();
+        const parseResult = await this.astParser.parseFile(targetFilePath);
+        if (!parseResult.success) {
+            return {
+                targetFile: targetFilePath,
+                exportedSymbols: [],
+                impacts: [],
+                duration: Date.now() - startTime
+            };
+        }
+        const exportedSymbols = parseResult.symbols.filter(s => s.isExported);
+        if (exportedSymbols.length === 0) {
+            return {
+                targetFile: targetFilePath,
+                exportedSymbols: [],
+                impacts: [],
+                duration: Date.now() - startTime
+            };
+        }
+        const baseName = path.basename(targetFilePath, path.extname(targetFilePath));
+        const scanResult = await this.scanner.findConsumerFiles(baseName, path.dirname(targetFilePath));
+        const impacts = [];
+        for (const consumerFile of scanResult.consumerFiles) {
+            const impact = await this.extractImpactContext(consumerFile, exportedSymbols);
+            if (impact) {
+                impacts.push(impact);
+            }
+        }
+        return {
+            targetFile: targetFilePath,
+            exportedSymbols,
+            impacts,
+            duration: Date.now() - startTime
+        };
+    }
+    /**
+     * 从消费者文件中提取相关上下文
+     */
+    async extractImpactContext(consumerFile, exportedSymbols) {
+        try {
+            const content = await fs.readFile(consumerFile, 'utf-8');
+            const sourceFile = ts.createSourceFile(consumerFile, content, ts.ScriptTarget.Latest, true);
+            const usedSymbols = exportedSymbols.filter(sym => content.includes(sym.name));
+            if (usedSymbols.length === 0) {
+                return null;
+            }
+            const snippet = this.extractRelevantSnippet(content, sourceFile, usedSymbols);
+            const jsDoc = this.getAggregatedJSDoc(usedSymbols);
+            return {
+                filePath: consumerFile,
+                symbols: usedSymbols.map(s => s.name),
+                snippet,
+                jsDoc
+            };
+        }
+        catch (error) {
+            console.warn(`[X-Resolver] Failed to analyze ${consumerFile}: ${error}`);
+            return null;
+        }
+    }
+    /**
+     * 提取相关代码片段（智能切片）
+     */
+    extractRelevantSnippet(content, sourceFile, usedSymbols) {
+        const lines = content.split('\n');
+        const matchedLines = new Set();
+        lines.forEach((line, idx) => {
+            if (usedSymbols.some(sym => line.includes(sym.name))) {
+                for (let i = Math.max(0, idx - 3); i <= Math.min(lines.length - 1, idx + 5); i++) {
+                    matchedLines.add(i);
+                }
+            }
+        });
+        const sortedLines = Array.from(matchedLines).sort((a, b) => a - b);
+        let snippet = '';
+        for (let i = 0; i < sortedLines.length; i++) {
+            const lineNum = sortedLines[i];
+            const prevLine = i > 0 ? sortedLines[i - 1] : -1;
+            if (lineNum > prevLine + 1) {
+                snippet += '\n// ...\n';
+            }
+            snippet += `${lineNum + 1}: ${lines[lineNum]}\n`;
+        }
+        return snippet.trim();
+    }
+    /**
+     * 聚合符号的 JSDoc
+     */
+    getAggregatedJSDoc(symbols) {
+        const docs = symbols.filter(s => s.jsDoc).map(s => {
+            return `=== ${s.name} (${s.kind}) ===\n${s.jsDoc}`;
+        });
+        return docs.length > 0 ? docs.join('\n\n') : '';
+    }
+    /**
+     * 渲染为 AI 友好的上下文格式
+     */
+    renderAsAIContext(result) {
+        let context = `\n${'='.repeat(60)}\n`;
+        context += `X-RESOLVER: CROSS-FILE DEPENDENCY CONTEXT\n`;
+        context += `Target: ${result.targetFile}\n`;
+        context += `Exported Symbols: ${result.exportedSymbols.length}\n`;
+        context += `Affected Files: ${result.impacts.length}\n`;
+        context += `Analysis Time: ${result.duration}ms\n`;
+        context += `${'='.repeat(60)}\n\n`;
+        if (result.exportedSymbols.length > 0) {
+            context += `[EXPORTED SYMBOLS]\n`;
+            for (const symbol of result.exportedSymbols) {
+                context += `- ${symbol.name} (${symbol.kind}) at line ${symbol.startLine}\n`;
+                if (symbol.jsDoc) {
+                    const shortDoc = symbol.jsDoc.split('\n')[0];
+                    if (shortDoc) {
+                        context += `  Doc: ${shortDoc}\n`;
+                    }
+                }
+            }
+            context += '\n';
+        }
+        if (result.impacts.length > 0) {
+            context += `[AFFECTED FILES]\n\n`;
+            for (const impact of result.impacts) {
+                context += `<<< EXTERNAL DEPENDENCY REFERENCE >>>\n`;
+                context += `File: ${impact.filePath}\n`;
+                context += `Role: READ-ONLY (This file consumes symbols from target file)\n`;
+                context += `Symbols Used: ${impact.symbols.join(', ')}\n`;
+                if (impact.jsDoc) {
+                    context += `\n--- SYMBOL CONTRACT (JSDoc) ---\n`;
+                    context += `${impact.jsDoc}\n`;
+                }
+                context += `\n--- USAGE SNIPPET ---\n`;
+                context += `${impact.snippet}\n`;
+                context += `<<< END OF REFERENCE >>>\n\n`;
+            }
+        }
+        return context;
+    }
+    /**
+     * 快捷方法：仅获取导出符号
+     */
+    async getExportedSymbols(filePath) {
+        const result = await this.astParser.parseFile(filePath);
+        return result.success ? result.symbols.filter(s => s.isExported) : [];
+    }
+}
+exports.XResolver = XResolver;
+//# sourceMappingURL=XResolver.js.map

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

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

package/dist/utils/renderer.d.ts

@@ -1,11 +1,19 @@
 import { Ora } from 'ora';
+export interface RendererOptions {
+    autoFinish?: boolean;
+    onChunkCallback?: (chunk: string) => void;
+    quietMode?: boolean;
+}
 export declare class StreamMarkdownRenderer {
     private fullResponse;
     private prefix;
     private isFirstOutput;
     private spinner;
     private startTime;
-    constructor(prefix?: string, spinner?: Ora);
+    private quietMode;
+    private autoFinish;
+    private onChunkCallback;
+    constructor(prefix?: string, spinner?: Ora, options?: RendererOptions | boolean);
     /**
      * 处理流式数据块
      */
@@ -18,4 +26,13 @@ export declare class StreamMarkdownRenderer {
      * 计算文本在终端的可视行数
      */
     private getVisualLineCount;
+    /**
+     * Start chunking mode for Agent Runtime
+     * Returns a callback function that Agent can use to send chunks
+     */
+    startChunking(): (chunk: string) => void;
+    /**
+     * Check if response appears complete (heuristic)
+     */
+    private isComplete;
 }