skill-any-code 1.0.0 → 1.0.1

package/src/infrastructure/llm/openai.client.ts

@@ -1,162 +0,0 @@
-import OpenAI from 'openai';
-import { ILLMClient } from '../../domain/interfaces';
-import { LLMConfig, LLMCallOptions, LLMResponse } from '../../common/types';
-import { LLMUsageTracker } from './llm.usage.tracker';
-import { AppError, ErrorCode } from '../../common/errors';
-import { logger } from '../../common/logger';
-
-export class OpenAIClient implements ILLMClient {
-  private client: OpenAI;
-  private config: LLMConfig;
-  private tracker?: LLMUsageTracker;
-
-  constructor(config: LLMConfig, tracker?: LLMUsageTracker) {
-    this.config = config;
-    this.tracker = tracker;
-    this.client = new OpenAI({
-      apiKey: config.api_key,
-      baseURL: config.base_url,
-      timeout: config.timeout,
-      dangerouslyAllowBrowser: true,
-    });
-  }
-
-  /**
-   * 连接可用性校验（V2.5）
-   * - 在进入任何解析流程前调用；
-   * - 配置不完整或服务不可用时抛出带有明确 ErrorCode 的 AppError。
-   */
-  async testConnection(config: LLMConfig): Promise<void> {
-    // 保持与最新配置一致（允许运行时通过 CLI/环境变量覆盖）
-    this.config = config;
-    // 基本配置校验：base_url / api_key / model 不能为空
-    if (!this.config.base_url || !this.config.api_key || !this.config.model) {
-      throw new AppError(
-        ErrorCode.LLM_INVALID_CONFIG,
-        'Incomplete LLM config. Please set base_url/api_key/model via config file, env vars, or CLI options.',
-        {
-          missing: {
-            base_url: !this.config.base_url,
-            api_key: !this.config.api_key,
-            model: !this.config.model,
-          },
-        },
-      );
-    }
-
-    try {
-      const res = await this.client.chat.completions.create({
-        model: this.config.model,
-        temperature: 0,
-        max_tokens: 1,
-        messages: [{ role: 'system', content: 'health-check' }],
-      } as any);
-
-      const status = (res as any).status ?? 200;
-      if (status === 401) {
-        throw new AppError(ErrorCode.LLM_CALL_FAILED, 'LLM authentication failed (401)', { status });
-      }
-      if (status === 404) {
-        throw new AppError(ErrorCode.LLM_CALL_FAILED, 'LLM model not found (404)', { status });
-      }
-      if (status < 200 || status >= 300) {
-        throw new AppError(
-          ErrorCode.LLM_CALL_FAILED,
-          `LLM connectivity check returned non-2xx status: ${status}`,
-          { status },
-        );
-      }
-    } catch (e: any) {
-      if (e instanceof AppError) {
-        throw e;
-      }
-      const code = e?.code || e?.status;
-      if (code === 'ETIMEDOUT') {
-        throw new AppError(ErrorCode.LLM_TIMEOUT, 'LLM connectivity check timed out', e);
-      }
-      if (code === 'ENOTFOUND' || code === 'ECONNREFUSED' || code === 'ECONNRESET') {
-        throw new AppError(ErrorCode.LLM_CALL_FAILED, 'Unable to reach LLM service. Check network or base_url.', e);
-      }
-      throw new AppError(
-        ErrorCode.LLM_CALL_FAILED,
-        `LLM connectivity check failed: ${e?.message || String(e)}`,
-        e,
-      );
-    }
-  }
-
-  /**
-   * 向后兼容旧版本/测试中使用的 connectTest 名称。
-   * 内部直接代理到 V2.5 的 testConnection。
-   */
-  async connectTest(): Promise<void> {
-    await this.testConnection(this.config);
-  }
-
-  async call(prompt: string, options?: LLMCallOptions): Promise<LLMResponse> {
-    const startTime = Date.now();
-    const retries = options?.retries ?? this.config.max_retries;
-    
-    for (let attempt = 0; attempt <= retries; attempt++) {
-      try {
-        const response = await this.client.chat.completions.create({
-          model: options?.model ?? this.config.model,
-          temperature: options?.temperature ?? this.config.temperature,
-          max_tokens: options?.maxTokens ?? this.config.max_tokens,
-          messages: [
-            { role: 'user', content: prompt }
-          ]
-        });
-
-        const content = response.choices[0].message.content || '';
-        const usage = response.usage || { prompt_tokens: 0, completion_tokens: 0, total_tokens: 0 };
-
-        const normalizedUsage = {
-          promptTokens: usage.prompt_tokens ?? 0,
-          completionTokens: usage.completion_tokens ?? 0,
-          totalTokens: usage.total_tokens ?? 0,
-        };
-
-        if (this.tracker) {
-          this.tracker.addUsage(normalizedUsage);
-        }
-
-        return {
-          content,
-          usage: normalizedUsage,
-          model: response.model,
-          responseTime: Date.now() - startTime,
-        };
-      } catch (error: any) {
-        const errorMessage = error?.message || 'Unknown LLM call error';
-        logger.debug(`LLM call attempt ${attempt + 1} failed: ${errorMessage}`);
-
-        if (attempt === retries) {
-          if (error?.status === 429) {
-            throw new AppError(ErrorCode.LLM_RATE_LIMITED, 'LLM service rate limited', error);
-          } else if (error?.code === 'ETIMEDOUT') {
-            throw new AppError(ErrorCode.LLM_TIMEOUT, 'LLM call timeout', error);
-          } else {
-            throw new AppError(ErrorCode.LLM_CALL_FAILED, `LLM call failed: ${errorMessage}`, error);
-          }
-        }
-
-        await this.sleep(this.config.retry_delay * Math.pow(2, attempt));
-      }
-    }
-
-    throw new AppError(ErrorCode.LLM_CALL_FAILED, 'Max retries exceeded');
-  }
-
-  async batchCall(prompts: string[], options?: LLMCallOptions): Promise<LLMResponse[]> {
-    const results: LLMResponse[] = [];
-    for (const prompt of prompts) {
-      results.push(await this.call(prompt, options));
-    }
-    return results;
-  }
-
-  private sleep(ms: number): Promise<void> {
-    return new Promise(resolve => setTimeout(resolve, ms));
-  }
-}

package/src/infrastructure/llm.service.ts

@@ -1,70 +0,0 @@
-import OpenAI from 'openai';
-import { configManager } from '../common/config';
-import { AppError, ErrorCode } from '../common/errors';
-import { logger } from '../common/logger';
-
-export interface LLMService {
-  generateCompletion(prompt: string, systemPrompt?: string): Promise<string>;
-}
-
-export class OpenAILLMService implements LLMService {
-  private client: OpenAI | null = null;
-
-  private async getClient(): Promise<OpenAI> {
-    if (!this.client) {
-      let config: any;
-      try {
-        config = configManager.getConfig();
-      } catch (e) {
-        await configManager.load();
-        config = configManager.getConfig();
-      }
-      
-      if (!config.llm.api_key) {
-        throw new AppError(
-          ErrorCode.ANALYSIS_EXCEPTION,
-          'LLM API key not configured. Please set it in config file or via SKILL_ANY_CODE_LLM_API_KEY environment variable.',
-        );
-      }
-
-      this.client = new OpenAI({
-        baseURL: config.llm.base_url,
-        apiKey: config.llm.api_key,
-      });
-    }
-    return this.client;
-  }
-
-  async generateCompletion(prompt: string, systemPrompt: string = 'You are a code analysis expert. You help analyze code files, generate summaries, class diagrams, and other analysis results. Be concise and accurate.'): Promise<string> {
-    const client = await this.getClient();
-    const config = configManager.getConfig();
-
-    try {
-      logger.debug(`Calling LLM model ${config.llm.model} with prompt length: ${prompt.length}`);
-      
-      const response = await client.chat.completions.create({
-        model: config.llm.model,
-        messages: [
-          { role: 'system', content: systemPrompt },
-          { role: 'user', content: prompt },
-        ],
-        temperature: 0.1,
-        max_tokens: 2048,
-      });
-
-      const result = response.choices[0]?.message?.content?.trim() || '';
-      
-      if (!result) {
-        throw new AppError(ErrorCode.ANALYSIS_EXCEPTION, 'LLM returned empty response');
-      }
-
-      logger.debug(`LLM response received, length: ${result.length}`);
-      return result;
-    } catch (error: any) {
-      logger.error('LLM call failed:', error);
-      throw new AppError(ErrorCode.ANALYSIS_EXCEPTION, `LLM call failed: ${error.message}`);
-    }
-  }
-}
-
-export const llmService = new OpenAILLMService();

package/src/infrastructure/skill/skill.generator.ts

@@ -1,53 +0,0 @@
-import * as fs from 'fs-extra'
-import * as path from 'path'
-import { ISkillGenerator, SkillGenerateOptions, SkillProvider } from '../../domain/interfaces'
-import { getSkillMdContent } from './templates/skill.md.template'
-import { getResolveScriptContent } from './templates/resolve.script'
-import { logger } from '../../common/logger'
-
-const PROVIDER_DIRECTORY_MAP: Record<SkillProvider, string> = {
-  opencode: '.agents/skills/skill-any-code',
-  cursor: '.agents/skills/skill-any-code',
-  codex: '.agents/skills/skill-any-code',
-  claude: '.claude/skills/skill-any-code',
-}
-
-export class SkillGenerator implements ISkillGenerator {
-  async generate(options: SkillGenerateOptions): Promise<string[]> {
-    const { projectRoot, providers } = options
-    const deployedPaths: string[] = []
-
-    const uniqueDirs = new Set<string>()
-    for (const p of providers) {
-      const lowerProvider = p.toLowerCase() as SkillProvider
-      const dir = PROVIDER_DIRECTORY_MAP[lowerProvider]
-      if (dir) {
-        uniqueDirs.add(dir)
-      } else {
-        logger.warn(`Unknown provider: ${p}. Skipped.`)
-      }
-    }
-
-    const skillMd = getSkillMdContent()
-    const resolveScript = getResolveScriptContent()
-
-    for (const relativeDir of uniqueDirs) {
-      const targetDir = path.join(projectRoot, relativeDir)
-      try {
-        await fs.ensureDir(targetDir)
-        await fs.ensureDir(path.join(targetDir, 'scripts'))
-
-        await fs.writeFile(path.join(targetDir, 'SKILL.md'), skillMd, 'utf-8')
-        await fs.writeFile(path.join(targetDir, 'scripts', 'get-summary.py'), resolveScript, 'utf-8')
-
-        deployedPaths.push(targetDir)
-        logger.debug(`Skill deployed to: ${targetDir}`)
-      } catch (error: unknown) {
-        const msg = error instanceof Error ? error.message : String(error)
-        logger.warn(`Failed to deploy skill (${targetDir}): ${msg}`)
-      }
-    }
-
-    return deployedPaths
-  }
-}

package/src/infrastructure/skill/templates/skill.md.template.ts

@@ -1,45 +0,0 @@
-export function getSkillMdContent(): string {
-  const lines = [
-    '---',
-    'name: code-atlas-navigator',
-    'description: Use this skill when you need to explore, understand, or search this codebase. Input a file or directory path relative to the project root to retrieve the path to its detailed natural language summary. Use this progressively to navigate from the root directory down to specific target files without reading the full raw source code.',
-    '---',
-    '',
-    '# Codebase Navigation Guide',
-    '',
-    'This repository has been pre-analyzed and summarized into natural language Markdown files. To save context window and improve accuracy, **do not read the raw source code directly**. Instead, use this skill to progressively navigate the repository layer by layer.',
-    '',
-    '## 🧭 How to Explore the Codebase',
-    '',
-    "1. **Start High-Level**: If you don't know the exact file location, begin by querying the summary of the root directory (`.`).",
-    '2. **Progressive Disclosure**: Read the directory summary to understand its sub-components. Identify the next relevant sub-directory or file based on your current task.',
-    '3. **Drill Down**: Query the summaries of those specific sub-components. Repeat this until you locate the target function, class, or logic.',
-    '',
-    '## 🛠️ How to Locate a Summary File',
-    '',
-    'Use the provided Python script to map the original codebase path to its corresponding Markdown summary path.',
-    '',
-    '**Script Specification:**',
-    '* **Input Parameter**: The relative path of the target file or directory with respect to the project root.',
-    '* **Output**: The relative path of the Markdown summary file with respect to the project root.',
-    '* **Fallback**: If the summary Markdown file cannot be found, the script will strictly output `N/A`.',
-    '',
-    '### Execution Commands',
-    '',
-    'Since the execution environment may vary, please use the appropriate command based on your current operating system:',
-    '',
-    '**For Linux / macOS (Bash/Zsh):**',
-    '```bash',
-    'python3 scripts/get_summary.py <relative/path/to/target>',
-    '```',
-    '(Note: If python3 is not found, fallback to python).',
-    '',
-    '**For Windows (CMD/PowerShell):**',
-    '```dos',
-    'python scripts\\get_summary.py <relative\\path\\to\\target>',
-    '```',
-    '(Note: You may also use py or python3 depending on the Windows environment setup).',
-  ]
-
-  return lines.join('\n') + '\n'
-}

package/src/infrastructure/splitter/code.splitter.ts

@@ -1,176 +0,0 @@
-import { IFileSplitter } from '../../domain/interfaces';
-import { FileChunk, FileChunkAnalysis, FileAnalysis } from '../../common/types';
-import { AppError, ErrorCode } from '../../common/errors';
-import { ILLMClient } from '../../domain/interfaces';
-import {
-  MERGE_STRUCTURE_PROMPT,
-  FILE_DESCRIPTION_PROMPT,
-  FILE_SUMMARY_PROMPT,
-  PARSE_RETRY_HINT
-} from '../llm/prompt.template';
-import Mustache from 'mustache';
-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 CodeSplitter implements IFileSplitter {
-  private llmClient: ILLMClient;
-
-  constructor(llmClient: ILLMClient) {
-    this.llmClient = llmClient;
-  }
-
-  async split(fileContent: string, maxChunkSize: number): Promise<FileChunk[]> {
-    try {
-      const lines = fileContent.split('\n');
-      const chunks: FileChunk[] = [];
-      let currentChunkLines: string[] = [];
-      let currentChunkLength = 0;
-      let startLine = 0;
-
-      for (let i = 0; i < lines.length; i++) {
-        const line = lines[i];
-        const lineLength = line.length + 1; // +1 for newline
-
-        // 检查是否是语义边界：类/函数定义、空行、注释块结束等
-        const isSemanticBoundary = /^(class|function|interface|type|enum|export\s+(class|function|interface)|\/\/\s*|\/\*\*|\*\/|\s*$)/.test(line.trim());
-
-        if (currentChunkLength + lineLength > maxChunkSize && isSemanticBoundary && currentChunkLines.length > 0) {
-          // 保存当前分片
-          chunks.push({
-            id: chunks.length,
-            content: currentChunkLines.join('\n'),
-            startLine,
-            endLine: i - 1,
-            context: this.extractContext(currentChunkLines)
-          });
-
-          // 开始新分片
-          currentChunkLines = [];
-          currentChunkLength = 0;
-          startLine = i;
-        }
-
-        currentChunkLines.push(line);
-        currentChunkLength += lineLength;
-      }
-
-      // 添加最后一个分片
-      if (currentChunkLines.length > 0) {
-        chunks.push({
-          id: chunks.length,
-          content: currentChunkLines.join('\n'),
-          startLine,
-          endLine: lines.length - 1,
-          context: this.extractContext(currentChunkLines)
-        });
-      }
-
-      return chunks;
-    } catch (error: any) {
-      throw new AppError(ErrorCode.FILE_SPLIT_FAILED, `Failed to split file: ${error.message}`, error);
-    }
-  }
-
-  /**
-   * 合并阶段按需求 10.7.1 / 10.9.4：三步 LLM 调用（结构 → 功能描述 → 概述），与单文件非分片协议一致；
-   * 每次解析失败仅重试当次。
-   */
-  async merge(chunks: FileChunkAnalysis[], filePath: string): Promise<FileAnalysis> {
-    const opts = { temperature: 0.1 };
-
-    // 第一步：合并分片结果为统一结构
-    const structure = await this.callWithParseRetry(
-      Mustache.render(MERGE_STRUCTURE_PROMPT, {
-        filePath,
-        chunkResults: JSON.stringify(chunks, null, 2)
-      }),
-      opts,
-      (content) => {
-        const o = JSON.parse(content);
-        return {
-          name: o.name ?? path.basename(filePath),
-          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')
-    );
-
-    // 基础信息由程序侧负责，此处仅返回语义部分，路径等由调用方补充
-    const name = path.basename(filePath);
-
-    return {
-      type: 'file',
-      path: filePath,
-      name,
-      language: '',
-      linesOfCode: 0,
-      dependencies: [],
-      description,
-      summary,
-      classes: structure.classes,
-      functions: structure.functions,
-      lastAnalyzedAt: new Date().toISOString(),
-      commitHash: ''
-    };
-  }
-
-  /** 单次调用：解析失败则仅重试该次一次（需求 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.CHUNK_MERGE_FAILED,
-      `Failed to parse merge response after retry: ${(lastError as Error)?.message}`,
-      lastError
-    );
-  }
-
-  private extractContext(lines: string[]): string {
-    // 提取分片的上下文信息：导入语句、类/函数定义开头
-    const contextLines = lines.filter(line => 
-      /^(import|export|class|function|interface|type|enum)/.test(line.trim())
-    ).slice(0, 10); // 最多取前10行上下文
-    return contextLines.join('\n');
-  }
-}