skill-any-code 1.0.0 → 1.0.1

package/src/application/services/llm.analysis.service.ts

@@ -1,237 +0,0 @@
-import type { ILLMClient, IFileSplitter, IAnalysisCache } from '../../domain/interfaces';
-import type { FileAnalysis, LLMConfig, FileChunkAnalysis } from '../../common/types';
-import {
-  FILE_STRUCTURE_PROMPT,
-  FILE_DESCRIPTION_PROMPT,
-  FILE_SUMMARY_PROMPT,
-  PARSE_RETRY_HINT,
-  CHUNK_ANALYSIS_PROMPT,
-  DIRECTORY_DESCRIPTION_PROMPT,
-  DIRECTORY_SUMMARY_PROMPT
-} from '../../infrastructure/llm/prompt.template';
-import Mustache from 'mustache';
-import { AppError, ErrorCode } from '../../common/errors';
-import { FileHashCache } from '../../infrastructure/cache/file.hash.cache';
-import path from 'path';
-
-/** 从 LLM 返回中解析单字段：支持 {"key": "value"} 或纯字符串 */
-function parseSingleField(content: string, field: 'description' | 'summary'): string {
-  const trimmed = content.trim();
-  try {
-    const o = JSON.parse(trimmed);
-    if (o && typeof o[field] === 'string') return o[field];
-  } catch {
-    // 非 JSON 则整体视为该字段内容
-  }
-  return trimmed || '';
-}
-
-export class LLMAnalysisService {
-  private llmClient: ILLMClient;
-  private fileSplitter: IFileSplitter;
-  private cache: IAnalysisCache;
-  private config: LLMConfig;
-
-  constructor(
-    llmClient: ILLMClient,
-    fileSplitter: IFileSplitter,
-    cache: IAnalysisCache,
-    config: LLMConfig
-  ) {
-    this.llmClient = llmClient;
-    this.fileSplitter = fileSplitter;
-    this.cache = cache;
-    this.config = config;
-  }
-
-  async analyzeFile(filePath: string, fileContent: string, fileHash: string): Promise<FileAnalysis> {
-    // 先查缓存
-    if (this.config.cache_enabled) {
-      const cachedResult = await this.cache.get(fileHash);
-      if (cachedResult) {
-        cachedResult.path = filePath;
-        cachedResult.lastAnalyzedAt = new Date().toISOString();
-        return cachedResult;
-      }
-    }
-
-    let result: FileAnalysis;
-
-    // 检查文件大小是否超过上下文窗口
-    if (fileContent.length > this.config.context_window_size * 0.8) {
-      // 大文件分片解析
-      result = await this.analyzeLargeFile(filePath, fileContent);
-    } else {
-      // 小文件直接解析
-      result = await this.analyzeSmallFile(filePath, fileContent);
-    }
-
-    // 保存缓存
-    if (this.config.cache_enabled) {
-      await this.cache.set(fileHash, result);
-    }
-
-    result.path = filePath;
-    result.lastAnalyzedAt = new Date().toISOString();
-    return result;
-  }
-
-  /** 三步协议（需求 10.5.3 / 10.9.1）：结构 → 功能描述 → 概述，程序组装为完整 FileAnalysis；某次解析失败仅重试当次（10.9.2）。 */
-  private async analyzeSmallFile(filePath: string, fileContent: string): Promise<FileAnalysis> {
-    const opts = { temperature: 0.1 };
-
-    // 第一步：仅提取结构（classes / globalVariables / globalFunctions），不包含基础信息
-    const structure = await this.callWithParseRetry(
-      Mustache.render(FILE_STRUCTURE_PROMPT, { filePath, fileContent }),
-      opts,
-      (content) => {
-        const o = JSON.parse(content);
-        return {
-          classes: Array.isArray(o.classes) ? o.classes : [],
-          functions: Array.isArray(o.functions) ? o.functions : []
-        };
-      }
-    );
-
-    const structureJson = JSON.stringify(structure, null, 2);
-
-    // 第二步：仅生成功能描述
-    const description = await this.callWithParseRetry(
-      Mustache.render(FILE_DESCRIPTION_PROMPT, { structureJson }),
-      opts,
-      (content) => parseSingleField(content, 'description')
-    );
-
-    // 第三步：仅生成概述
-    const summary = await this.callWithParseRetry(
-      Mustache.render(FILE_SUMMARY_PROMPT, { structureJson, description }),
-      opts,
-      (content) => parseSingleField(content, 'summary')
-    );
-
-    // 基础信息由程序侧负责（设计文档 13.2.2）
-    const name = path.basename(filePath);
-    const language = this.detectLanguage(filePath);
-    const linesOfCode = fileContent.split(/\r?\n/).length;
-
-    return {
-      type: 'file',
-      path: filePath,
-      name,
-      language,
-      linesOfCode,
-      dependencies: [],
-      description,
-      summary,
-      classes: structure.classes,
-      functions: structure.functions,
-      lastAnalyzedAt: new Date().toISOString(),
-      commitHash: ''
-    };
-  }
-
-  private detectLanguage(filePath: string): string {
-    const ext = path.extname(filePath).toLowerCase();
-    switch (ext) {
-      case '.ts':
-      case '.tsx':
-        return 'TypeScript';
-      case '.js':
-      case '.jsx':
-        return 'JavaScript';
-      case '.py':
-        return 'Python';
-      case '.java':
-        return 'Java';
-      case '.go':
-        return 'Go';
-      case '.cs':
-        return 'C#';
-      default:
-        return '';
-    }
-  }
-
-  /** 单次调用：解析失败则仅重试该次一次，不重做已成功步骤（需求 10.9.2）。 */
-  private async callWithParseRetry<T>(
-    prompt: string,
-    options: { temperature?: number },
-    parseFn: (content: string) => T
-  ): Promise<T> {
-    let lastError: unknown;
-    for (let attempt = 0; attempt < 2; attempt++) {
-      try {
-        const response = await this.llmClient.call(
-          attempt === 1 ? prompt + PARSE_RETRY_HINT : prompt,
-          { ...options, retries: 0 }
-        );
-        return parseFn(response.content);
-      } catch (e) {
-        lastError = e;
-      }
-    }
-    throw new AppError(
-      ErrorCode.LLM_RESPONSE_PARSE_FAILED,
-      `Failed to parse LLM response after retry: ${(lastError as Error)?.message}`,
-      lastError
-    );
-  }
-
-  private async analyzeLargeFile(filePath: string, fileContent: string): Promise<FileAnalysis> {
-    // 分片
-    const chunks = await this.fileSplitter.split(fileContent, this.config.context_window_size * 0.7);
-    
-    // 并行解析所有分片（仅提取结构）
-    const chunkAnalysisPromises = chunks.map(async (chunk) => {
-      const prompt = Mustache.render(CHUNK_ANALYSIS_PROMPT, {
-        filePath,
-        chunkId: chunk.id,
-        chunkContent: chunk.content,
-        context: chunk.context || ''
-      });
-
-      const response = await this.llmClient.call(prompt, { temperature: 0.1 });
-
-      const parsed = JSON.parse(response.content);
-      return {
-        chunkId: chunk.id,
-        classes: Array.isArray(parsed.classes) ? parsed.classes : [],
-        functions: Array.isArray(parsed.functions) ? parsed.functions : []
-      } as FileChunkAnalysis;
-    });
-
-    const chunkResults = await Promise.all(chunkAnalysisPromises);
-    
-    // 合并分片结果
-    return this.fileSplitter.merge(chunkResults, filePath);
-  }
-
-  /**
-   * 目录两步协议（需求 10.6.3 / 10.9.3）：基于子项精简信息先生成 description，再生成 summary。
-   */
-  async analyzeDirectory(
-    childrenDirs: Array<{ name: string; summary: string; description: string }>,
-    childrenFiles: Array<{ name: string; summary: string; description: string }>
-  ): Promise<{ description: string; summary: string }> {
-    const opts = { temperature: 0.1 };
-    const payload = { childrenDirs, childrenFiles };
-    const childrenJson = JSON.stringify(payload, null, 2);
-
-    // 第一步：功能描述
-    const description = await this.callWithParseRetry(
-      Mustache.render(DIRECTORY_DESCRIPTION_PROMPT, { childrenJson }),
-      opts,
-      (content) => parseSingleField(content, 'description')
-    );
-
-    // 第二步：概述
-    const summary = await this.callWithParseRetry(
-      Mustache.render(DIRECTORY_SUMMARY_PROMPT, { description, childrenJson }),
-      opts,
-      (content) => parseSingleField(content, 'summary')
-    );
-
-    return { description, summary };
-  }
-
-}

package/src/cli.ts

@@ -1,297 +0,0 @@
-#!/usr/bin/env node
-import { Command } from 'commander';
-import pc from 'picocolors';
-import fs from 'fs-extra';
-import path from 'path';
-import { version } from '../package.json';
-import { AnalysisAppService } from './application/analysis.app.service';
-import { configManager } from './common/config';
-import { logger } from './common/logger';
-import { cliRenderer } from './common/ui';
-import type { TokenUsageStats } from './common/types';
-import { AppError, ErrorCode } from './common/errors';
-import { LocalStorageService } from './infrastructure/storage.service';
-import { GitService } from './infrastructure/git.service';
-import { generateProjectSlug } from './common/utils';
-import { DEFAULT_CONCURRENCY } from './common/constants';
-
-const program = new Command();
-
-// 主命令配置
-program
-  .name('skill-any-code')
-  .alias('sac')
-  .description('Skill Any Code: a CLI for large codebase understanding and analysis')
-  .version(version, '-v, --version', 'Show version number')
-  .helpOption('-h, --help', 'Show help information')
-  .option('--log-level <level>', 'Log level: debug/info/warn/error')
-  .option('--path <path>', 'Project root path to analyze', process.cwd())
-  .option('-m, --mode <mode>', 'Analysis mode: full/incremental/auto', 'auto')
-  .option('-d, --depth <number>', 'Max directory depth (-1 = unlimited)', '-1')
-  .option('-C, --concurrency <number>', 'Max concurrent workers (default: CPU*2, capped by analyze.max_concurrency)')
-  .option('--output-dir <path>', 'Custom output directory for results')
-  .option('--skills-providers <list>', 'Comma-separated AI tool providers (opencode/cursor/claude/codex)')
-  .option('--no-skills', 'Skip skill generation')
-  // LLM相关参数
-  .option('--llm-base-url <url>', 'LLM API base URL')
-  .option('--llm-api-key <key>', 'LLM API key')
-  .option('--llm-model <model>', 'LLM model name')
-  .option('--llm-temperature <number>', 'LLM temperature (0-2)', parseFloat)
-  .option('--llm-max-tokens <number>', 'LLM max output tokens', parseInt)
-  .option('--llm-timeout <ms>', 'LLM request timeout (ms)', parseInt)
-  .option('--llm-max-retries <number>', 'LLM max retries', parseInt)
-  .option('--llm-retry-delay <ms>', 'LLM retry delay (ms)', parseInt)
-  .option('--llm-context-window-size <number>', 'LLM context window size', parseInt)
-  .option('--no-llm-cache', 'Disable LLM result cache')
-  .option('--llm-cache-dir <path>', 'LLM cache directory')
-  .option('--clear-cache', 'Clear existing LLM cache before analyzing');
-
-// init 子命令：显式初始化配置文件（V2.5）
-program
-  .command('init')
-  .description('Initialize or reset the config file')
-  .action(async () => {
-    try {
-      const resolvedPath = '~/.config/skill-any-code/config.yaml';
-      const fsPath = resolvedPath.replace('~', process.env.HOME || process.env.USERPROFILE || '');
-      const exists = await fs.pathExists(fsPath);
-
-      await configManager.init();
-      logger.success(exists ? `Config file reset: ${fsPath}` : `Config file created: ${fsPath}`);
-      process.exit(0);
-    } catch (error) {
-      logger.error('Failed to initialize config', error as Error);
-      process.exit(1);
-    }
-  });
-
-// 默认解析（不带子命令时直接执行）
-program.action(async () => {
-    const os = require('os');
-    try {
-      // 加载配置（V2.5：配置未初始化时直接失败，提示先执行 init）
-      let config;
-      try {
-        config = await configManager.load();
-      } catch (e: any) {
-        if (e instanceof AppError && e.code === ErrorCode.CONFIG_NOT_INITIALIZED) {
-          process.stderr.write(
-            `Config is not initialized. Run "skill-any-code init" to create: ~/.config/skill-any-code/config.yaml\n`,
-          );
-          process.exit(1);
-          return;
-        }
-        throw e;
-      }
-      const cliLogLevel = program.opts().logLevel as any;
-      if (cliLogLevel) {
-        logger.setLevel(cliLogLevel);
-      }
-
-      // 合并LLM命令行参数
-      const options = program.opts();
-      if (options.llmBaseUrl) config.llm.base_url = options.llmBaseUrl;
-      if (options.llmApiKey) config.llm.api_key = options.llmApiKey;
-      if (options.llmModel) config.llm.model = options.llmModel;
-      if (options.llmTemperature !== undefined) config.llm.temperature = options.llmTemperature;
-      if (options.llmMaxTokens !== undefined) config.llm.max_tokens = options.llmMaxTokens;
-      if (options.llmTimeout !== undefined) config.llm.timeout = options.llmTimeout;
-      if (options.llmMaxRetries !== undefined) config.llm.max_retries = options.llmMaxRetries;
-      if (options.llmRetryDelay !== undefined) config.llm.retry_delay = options.llmRetryDelay;
-      if (options.llmContextWindowSize !== undefined) config.llm.context_window_size = options.llmContextWindowSize;
-      if (options.llmCache !== undefined) config.llm.cache_enabled = options.llmCache;
-      if (options.llmCacheDir) config.llm.cache_dir = options.llmCacheDir;
-
-      // 处理清空缓存选项
-      if (options.clearCache) {
-        const { FileHashCache } = await import('./infrastructure/cache/file.hash.cache');
-        const homeDir = os.homedir();
-        const cache = new FileHashCache({
-          cacheDir: config.llm.cache_dir.replace(/^~(?=\/|\\|$)/, homeDir),
-          maxSizeMb: config.llm.cache_max_size_mb,
-        });
-        await cache.clear();
-        logger.info('LLM cache cleared');
-      }
-
-      // 默认并发：CPU*2，但不超过配置中的 analyze.max_concurrency
-      const cpuBasedConcurrency = DEFAULT_CONCURRENCY;
-      const configuredMax = Number(config.analyze.max_concurrency ?? DEFAULT_CONCURRENCY);
-      const defaultConcurrency =
-        configuredMax > 0 ? Math.min(cpuBasedConcurrency, configuredMax) : cpuBasedConcurrency;
-
-      const analysisParams = {
-        path: options.path,
-        mode: options.mode as any,
-        depth: Number(options.depth),
-        concurrency: options.concurrency !== undefined ? Number(options.concurrency) : defaultConcurrency,
-        outputDir: options.outputDir || config.global.output_dir,
-        llmConfig: config.llm,
-        skillsProviders: options.skillsProviders
-          ? options.skillsProviders.split(',').map((s: string) => s.trim().toLowerCase())
-          : undefined,
-        noSkills: options.skills === false,
-      };
-
-      // V2.5：解析前执行 LLM 连接可用性校验，失败则立即退出（需求文档 13.4.2 / 测试文档 ST-LLM-CONNECT-001）
-      const { OpenAIClient } = await import('./infrastructure/llm/openai.client');
-      const llmClient = new OpenAIClient(config.llm);
-      logger.info(
-        `LLM client initialized. Testing connectivity and config (url=${config.llm.base_url}, model=${config.llm.model})`,
-      );
-      try {
-        await llmClient.testConnection(config.llm);
-      } catch (e: any) {
-        const detail = e?.message || String(e);
-        process.stderr.write(`LLM connectivity/config validation failed: ${detail}\n`);
-        process.exit(1);
-      }
-
-      const analysisService = new AnalysisAppService();
-
-      // 在 analyze 生命周期内，将所有 logger 输出通过 CLI 渲染器固定到进度块下方，
-      // 避免产生额外的进度/对象/Tokens 区域块。
-      logger.setSink((line) => {
-        cliRenderer.logBelow(line);
-      });
-
-      const paramsWithProgress = {
-        ...analysisParams,
-        onTotalKnown: (total: number) => {
-          cliRenderer.setTotal(total);
-        },
-        onProgress: (done: number, total: number, current?: { path: string }) => {
-          cliRenderer.updateProgress(done, total, current?.path, analysisParams.concurrency);
-        },
-        onTokenUsageSnapshot: (stats: TokenUsageStats) => {
-          cliRenderer.updateTokens(stats);
-        },
-        onScanProgress: (scannedFiles: number) => {
-          cliRenderer.updateScanProgress(scannedFiles);
-        },
-      };
-
-      let result;
-      // 执行解析（V2.4+：不再在 CLI 中做交互式错误处理，所有 LLM 错误由应用层统一抛出）
-      result = await analysisService.runAnalysis(paramsWithProgress);
-      
-      if (result.success) {
-        const files = result.data?.analyzedFilesCount || 0;
-        const dirs = (result as any).data?.analyzedDirsCount || 0;
-        const objects = files + dirs;
-        logger.success(
-          `Analysis completed. Processed ${objects} object(s)`,
-        );
-        const summaryPath = result.data?.summaryPath || '';
-        const summaryLabel = summaryPath ? `Entry file: ${path.basename(summaryPath)}` : 'Entry file: index.md';
-        logger.success(`Project analysis result. ${summaryLabel}`);
-        const usage = result.data?.tokenUsage;
-        if (usage) {
-          logger.info(
-            `LLM calls: ${usage.totalCalls}, prompt tokens: ${usage.totalPromptTokens}, ` +
-            `completion tokens: ${usage.totalCompletionTokens}, total tokens: ${usage.totalTokens}`
-          );
-        }
-      } else {
-        logger.error(`Analysis failed: ${result.message}`);
-        if (result.errors && result.errors.length > 0) {
-          result.errors.forEach(err => logger.error(`- ${err.path}: ${err.message}`));
-        }
-        process.exit(1);
-      }
-    } catch (error) {
-      const err = error as any;
-      // V2.5：LLM 连接/配置校验失败时统一输出明确前缀，满足 ST-LLM-CONNECT-001/002/003
-      if (err && err.code && (
-          err.code === ErrorCode.LLM_INVALID_CONFIG ||
-          err.code === ErrorCode.LLM_CALL_FAILED ||
-          err.code === ErrorCode.LLM_TIMEOUT
-        )) {
-        const detail = err.message || '';
-        process.stderr.write(`LLM connectivity/config validation failed: ${detail}\n`);
-      } else if (err instanceof AppError) {
-        logger.error(`Execution failed: ${err.message}`, err);
-      } else {
-        logger.error('Execution failed', err as Error);
-      }
-      process.exit(1);
-    }
-  });
-
-// resolve 子命令（V2.6：根据相对路径推导分析结果 Markdown 路径，不依赖索引）
-program
-  .command('resolve')
-  .description('Resolve the analysis result Markdown path for a file/directory')
-  .argument('<relative-path>', 'Relative path of the file/directory (from project root)')
-  .option('-p, --project <path>', 'Project root path', process.cwd())
-  .action(async (relativePath: string, options: { project?: string }) => {
-    try {
-      logger.setLevel(program.opts().logLevel as any);
-      const projectRoot = options.project || process.cwd();
-
-      const DEFAULT_OUTPUT_DIR = '.skill-any-code-result'
-
-      const normalizeRel = (input: string): { rel: string; rawHadTrailingSlash: boolean } => {
-        const raw = (input || '').trim()
-        const rawPosix = raw.replace(/\\/g, '/')
-        const rawHadTrailingSlash = rawPosix.endsWith('/') && rawPosix.length > 1
-        let rel = rawPosix
-        while (rel.startsWith('./')) rel = rel.slice(2)
-        if (rel.endsWith('/') && rel.length > 1) rel = rel.slice(0, -1)
-        if (rel === '') rel = '.'
-        return { rel, rawHadTrailingSlash }
-      }
-
-      const { rel, rawHadTrailingSlash } = normalizeRel(relativePath)
-      const targetAbs = path.resolve(projectRoot, rel)
-      if (!(await fs.pathExists(targetAbs))) {
-        process.stdout.write('N/A\n')
-        process.exit(0)
-        return
-      }
-
-      const stat = await fs.stat(targetAbs)
-      const isDir = stat.isDirectory() || rawHadTrailingSlash || rel === '.'
-
-      let mdRel: string
-      if (isDir) {
-        mdRel =
-          rel === '.'
-            ? path.posix.join(DEFAULT_OUTPUT_DIR, 'index.md')
-            : path.posix.join(DEFAULT_OUTPUT_DIR, rel, 'index.md')
-      } else {
-        const parsed = path.posix.parse(rel)
-        const dirPart = parsed.dir
-        const name =
-          parsed.name === 'index' && parsed.ext
-            ? `index${parsed.ext}.md`
-            : `${parsed.name}.md`
-        mdRel = dirPart ? path.posix.join(DEFAULT_OUTPUT_DIR, dirPart, name) : path.posix.join(DEFAULT_OUTPUT_DIR, name)
-      }
-
-      const mdAbs = path.resolve(projectRoot, mdRel)
-      if (await fs.pathExists(mdAbs)) {
-        process.stdout.write(mdRel + '\n')
-      } else {
-        process.stdout.write('N/A\n')
-      }
-      process.exit(0);
-    } catch (error: unknown) {
-      const msg = error instanceof Error ? error.message : String(error);
-      process.stderr.write(`Resolve failed: ${msg}\n`);
-      process.exit(1);
-    }
-  });
-
-// 全局错误处理
-program.showSuggestionAfterError();
-program.configureHelp({
-  sortSubcommands: true,
-  sortOptions: true,
-});
-
-// 解析命令行参数
-program.parseAsync(process.argv).catch((error) => {
-  console.error(pc.red(`\nExecution failed: ${error.message}`));
-  process.exit(1);
-});