symref
Version:
Static code checker for AI code agents (Windsurf, Cline, etc.)
160 lines • 7.31 kB
JavaScript
import { SymbolReferenceAnalyzer } from '../../analyzer/SymbolReferenceAnalyzer.js';
import * as fs from 'fs';
import * as path from 'path';
/**
* シンボル間の呼び出し経路を分析するコマンド
*/
export class TraceCommand {
/**
* コマンドを実行する
* @param fromTo 開始シンボルと終了シンボルの指定（"from --to=to"形式）
* @param options コマンドオプション
*/
static async execute(fromTo, options) {
try {
// fromとtoのシンボルを解析
const parts = fromTo.split('--to=');
if (parts.length !== 2) {
console.error('エラー: 引数の形式が正しくありません。例: "main --to=MyClass.method"');
process.exit(1);
}
const fromSymbol = parts[0].trim();
const toSymbol = parts[1].trim();
// 分析オプションを設定
const analyzerOptions = {
basePath: options.dir,
tsConfigPath: options.project,
includePatterns: options.include ? options.include.split(',') : undefined,
excludePatterns: options.exclude ? options.exclude.split(',') : undefined,
runtime: options.runtime || false,
env: options.env,
method: options.method
};
// アナライザーを初期化
const analyzer = new SymbolReferenceAnalyzer(analyzerOptions);
console.log(`\n=== '${fromSymbol}' から '${toSymbol}' への呼び出し経路を分析中... ===\n`);
try {
// 呼び出しグラフを構築
const nodeCount = analyzer.buildCallGraph();
console.log(`${nodeCount} 個のシンボルを分析しました。\n`);
// 呼び出し経路を分析
let result;
if (analyzerOptions.runtime) {
try {
result = await analyzer.traceCallPathRuntime(fromSymbol, toSymbol);
}
catch (error) {
console.log('注意: 動的トレースの実行に失敗しました。静的解析を実行します。');
result = analyzer.traceCallPath(fromSymbol, toSymbol);
}
}
else {
result = analyzer.traceCallPath(fromSymbol, toSymbol);
}
// 結果を表示
TraceCommand.displayResult(result, fromSymbol, toSymbol);
// Mermaidファイルを生成（オプション）
if (options.mermaid) {
TraceCommand.generateMermaidFile(result, options.mermaid);
}
}
catch (error) {
console.error(`エラー: ${error.message}`);
process.exit(1);
}
}
catch (error) {
console.error(`エラー: ${error.message}`);
process.exit(1);
}
}
/**
* 分析結果を表示
* @param result 分析結果
* @param fromSymbol 開始シンボル
* @param toSymbol 終了シンボル
*/
static displayResult(result, fromSymbol, toSymbol) {
if (result.paths.length === 0) {
console.log(`'${fromSymbol}' から '${toSymbol}' への呼び出し経路は見つかりませんでした。`);
return;
}
console.log(`${result.paths.length} 個の呼び出し経路が見つかりました:\n`);
// 各経路を表示
result.paths.forEach((path, index) => {
console.log(`経路 ${index + 1}:`);
// 経路上のノードを表示
for (let i = 0; i < path.nodes.length; i++) {
const node = path.nodes[i];
const location = node.location;
const locationStr = location.filePath && location.line > 0
? `${location.filePath}:${location.line}`
: '不明な位置';
// 最初のノード
if (i === 0) {
console.log(`${node.symbol} (${locationStr})`);
}
// 中間ノードと最後のノード
else {
// エッジ情報を表示
const edge = path.edges[i - 1];
const edgeLocation = edge?.location;
const callLocationStr = edgeLocation?.filePath && edgeLocation?.line > 0
? `${edgeLocation.filePath}:${edgeLocation.line}`
: locationStr;
console.log(` ↓ calls (${callLocationStr})`);
console.log(`${node.symbol} (${locationStr})`);
}
}
// 動的トレース情報を表示
const runtimeResult = result;
if (runtimeResult.parameters || runtimeResult.state) {
console.log('\n実行時情報:');
if (runtimeResult.parameters) {
console.log(' パラメータ:', JSON.stringify(runtimeResult.parameters, null, 2));
}
if (runtimeResult.state) {
console.log(' 状態:', JSON.stringify(runtimeResult.state, null, 2));
}
}
console.log('\n');
});
}
/**
* Mermaidファイルを生成
* @param result 分析結果
* @param outputPath 出力パス
*/
static generateMermaidFile(result, outputPath) {
if (!result.graphMermaidFormat) {
console.warn('警告: Mermaidグラフデータを生成できませんでした。');
return;
}
try {
// 出力ディレクトリを.symbolsに変更
const outputDir = '.symbols';
const now = new Date();
const year = now.getFullYear();
const month = String(now.getMonth() + 1).padStart(2, '0');
const day = String(now.getDate()).padStart(2, '0');
const hours = String(now.getHours()).padStart(2, '0');
const minutes = String(now.getMinutes()).padStart(2, '0');
const timestamp = `${year}${month}${day}_${hours}${minutes}`;
const safeBaseName = outputPath.replace(/[^a-zA-Z0-9]/g, '_');
const fileName = `${safeBaseName}_${timestamp}.md`;
const resolvedPath = path.resolve(process.cwd(), outputDir, fileName);
// 出力ディレクトリを確保
const dir = path.dirname(resolvedPath);
if (!fs.existsSync(dir)) {
fs.mkdirSync(dir, { recursive: true });
}
fs.writeFileSync(resolvedPath, result.graphMermaidFormat);
console.log(`Mermaidグラフファイルを生成しました: ${resolvedPath}`);
console.log('可視化するには: GitHubで表示するか、https://mermaid.live で開いてください');
}
catch (error) {
console.error(`Mermaidファイルの生成中にエラーが発生しました: ${error.message}`);
}
}
}
//# sourceMappingURL=TraceCommand.js.map