skill-any-code 1.0.0 → 1.0.1

package/src/common/types.ts

@@ -1,385 +0,0 @@
-// 元数据结构
-export interface AnalysisMetadata {
-  projectRoot: string
-  lastAnalyzedAt: string
-  gitCommits: Array<{
-    hash: string
-    branch: string
-    analyzedAt: string
-  }>
-  /**
-   * 非 Git 项目增量：文件快照（用于两次运行间的变更检测）。
-   * 仅记录 stat 级信息，避免全量读取文件内容。
-   *
-   * key 为相对 projectRoot 的文件路径（保持与运行时 path.relative 一致，可能含 \ 或 /）。
-   */
-  fileSnapshot?: Record<string, { mtimeMs: number; size: number }>
-  analysisVersion: string
-  analyzedFilesCount: number
-  schemaVersion: string
-}
-
-// 文件分析结果
-export interface FileAnalysis {
-  type: 'file'
-  path: string
-  name: string
-  language: string
-  linesOfCode: number
-  dependencies: string[]
-  /**
-   * 文件级 git commit id（最近一次修改该文件的提交），对应设计文档 10.3.2 / 13.2.1
-   * git 不可用或文件未提交时可为空
-   */
-  fileGitCommitId?: string
-  /**
-   * 解析时文件是否处于未提交（dirty）状态，对应设计文档 10.3.2 / 13.2.1
-   */
-  isDirtyWhenAnalyzed?: boolean
-  /**
-   * 解析时文件内容哈希，用于增量与缓存决策，对应设计文档 10.3.2 / 13.2.1
-   */
-  fileHashWhenAnalyzed?: string
-  /** 文件功能描述（200字以内），由 LLM 第二步调用生成 */
-  description?: string
-  summary: string
-  classes: Array<{
-    name: string
-    extends?: string
-    implements?: string[]
-    methods: Array<{
-      name: string
-      signature: string
-      description: string
-      visibility: 'public' | 'private' | 'protected'
-    }>
-    properties: Array<{
-      name: string
-      type: string
-      description: string
-      visibility: 'public' | 'private' | 'protected'
-    }>
-  }>
-  functions: Array<{
-    name: string
-    signature: string
-    description: string
-  }>
-  lastAnalyzedAt: string
-  commitHash: string
-}
-
-// 目录分析结果
-export interface DirectoryAnalysis {
-  type: 'directory'
-  path: string
-  name: string
-  /** 目录功能描述（200 字以内） */
-  description: string
-  /** 目录概述（100 字以内） */
-  summary: string
-  /** 直接子目录数量 */
-  childrenDirsCount: number
-  /** 直接子文件数量（仅解析范围内的文本代码文件） */
-  childrenFilesCount: number
-  structure: Array<{
-    name: string
-    type: 'file' | 'directory'
-    description: string
-  }>
-  lastAnalyzedAt: string
-  commitHash: string
-}
-
-// 项目整体总结
-export interface ProjectSummary {
-  projectName: string
-  slug: string
-  description: string
-  techStack: string[]
-  codeSize: {
-    files: number
-    lines: number
-    languages: Record<string, number>
-  }
-  architecture: {
-    layers: string[]
-    modules: Array<{ name: string; description: string }>
-    dependencies: Array<{ from: string; to: string }>
-  }
-  coreFlow: string
-  architectureDiagram: string
-  flowDiagram: string
-  generatedAt: string
-  commitHash: string
-}
-
-// 修正日志
-export interface ModificationLog {
-  id: string
-  timestamp: string
-  path: string
-  type: 'inconsistency' | 'omission' | 'error'
-  originalContent: string
-  correctedContent: string
-  reason: string
-}
-
-// 解析断点
-export interface AnalysisCheckpoint {
-  projectRoot: string
-  commitHash: string
-  mode: 'full' | 'incremental'
-  completedFiles: string[]
-  completedDirs: string[]
-  pendingTasks: Array<{ type: 'file' | 'directory'; path: string }>
-  createdAt: string
-}
-
-// ===== V2.3 索引相关类型 =====
-export interface IndexEntry {
-  resultPath: string
-  type: 'file' | 'directory'
-}
-
-export interface AnalysisIndex {
-  version: string
-  projectRoot: string
-  storageRoot: string
-  generatedAt: string
-  entries: Record<string, IndexEntry>
-}
-
-// ===== V2.3 resolve-config.json =====
-export interface ResolveConfig {
-  indexFilePath: string
-}
-
-export interface AnalysisObject {
-  type: 'file' | 'directory'
-  path: string
-}
-
-export interface ObjectResultMeta {
-  status: 'parsed' | 'cached' | 'filtered' | 'skipped' | 'failed'
-  reason?: string
-}
-
-// 进度回调：每完成一个对象（文件/目录）时调用（兼容旧接口）
-export type ProgressCallback = (done: number, total: number, current?: { path: string }) => void
-
-// 分析服务参数
-export interface FullAnalysisParams {
-  projectRoot: string
-  depth?: number
-  concurrency: number
-  /** 可选：每完成一个文件/目录时回调，用于进度条等 */
-  onProgress?: ProgressCallback
-  /** V2.4：对象级生命周期回调 */
-  onObjectPlanned?: (obj: AnalysisObject) => void
-  onObjectStarted?: (obj: AnalysisObject) => void
-  onObjectCompleted?: (obj: AnalysisObject, meta: ObjectResultMeta) => void
-  /** V2.6：扫描阶段进度回调，统计“将被解析的对象数（文件+目录）”，用于 CLI 单行实时展示 */
-  onScanProgress?: (scannedFiles: number) => void
-}
-
-export interface IncrementalAnalysisParams {
-  projectRoot: string
-  baseCommit: string
-  targetCommit: string
-  changedFiles: string[]
-  /**
-   * V2.6：增量自修复 - 需要重新聚合的目录列表（例如目录结果缺失但文件未变更）
-   */
-  changedDirs?: string[]
-  concurrency: number
-  /** V2.4：对象级生命周期回调 */
-  onObjectPlanned?: (obj: AnalysisObject) => void
-  onObjectStarted?: (obj: AnalysisObject) => void
-  onObjectCompleted?: (obj: AnalysisObject, meta: ObjectResultMeta) => void
-  /** 扫描阶段进度回调，用于 CLI 单行实时展示增量待处理对象数（文件+目录） */
-  onScanProgress?: (scannedObjects: number) => void
-}
-
-export interface ResumeAnalysisParams {
-  projectRoot: string
-  checkpoint: AnalysisCheckpoint
-}
-
-/**
- * 统一解析参数：全量与增量共享同一条管线，仅通过 fileFilter 区分过滤策略。
- */
-export interface AnalysisParams {
-  projectRoot: string
-  depth?: number
-  concurrency: number
-  mode: 'full' | 'incremental'
-  commitHash: string
-  /** 文件过滤器：返回 true 表示该文件需要（重新）解析 */
-  fileFilter: (relPath: string, absPath: string) => Promise<boolean>
-  /** 过滤完成后通知总对象数（用于 CLI 启动进度条） */
-  onTotalKnown?: (total: number) => void
-  onObjectPlanned?: (obj: AnalysisObject) => void
-  onObjectStarted?: (obj: AnalysisObject) => void
-  onObjectCompleted?: (obj: AnalysisObject, meta: ObjectResultMeta) => void
-  onScanProgress?: (scannedFiles: number) => void
-}
-
-// 分析结果
-export interface AnalysisResult {
-  success: boolean
-  analyzedFilesCount: number
-  analyzedDirsCount: number
-  duration: number
-  errors: Array<{ path: string; message: string }>
-  projectSlug: string
-  summaryPath: string
-  /** V2.3：解析过程中收集的索引条目 */
-  indexEntries: Array<{ sourcePath: string; resultPath: string; type: 'file' | 'directory' }>
-  /** V2.3：增量解析中已删除的源码路径 */
-  removedSourcePaths: string[]
-}
-
-// 命令参数类型
-export interface AnalyzeProjectCommandParams {
-  path?: string
-  mode?: 'full' | 'incremental' | 'auto'
-  depth?: number
-  concurrency?: number
-  llmConfig?: LLMConfig
-  /** V2.3：Skill 部署的 Provider 列表 */
-  skillsProviders?: string[]
-  /** V2.3：是否跳过 Skill 生成 */
-  noSkills?: boolean
-  /** V2.3：结果输出目录 */
-  outputDir?: string
-  /** 总对象数已知时回调（用于 CLI 启动进度条） */
-  onTotalKnown?: (total: number) => void
-  /** 进度更新回调（done, total, current） */
-  onProgress?: ProgressCallback
-  /** Token 使用快照回调：每次 LLM 调用后触发，用于 CLI UI 实时展示 Tokens 行 */
-  onTokenUsageSnapshot?: (stats: TokenUsageStats) => void
-  /** V2.6：扫描阶段进度回调，用于 CLI 单行显示“已扫描将被解析的对象数（文件+目录）” */
-  onScanProgress?: (scannedFiles: number) => void
-}
-
-// 命令返回结果
-export interface AnalyzeProjectCommandResult {
-  success: boolean
-  code: number
-  message: string
-  data?: {
-    projectName: string
-    mode: 'full' | 'incremental'
-    analyzedFilesCount: number
-    duration: number
-    summaryPath: string
-    tokenUsage?: TokenUsageStats
-  }
-  errors?: Array<{
-    path: string
-    message: string
-  }>
-}
-
-// LLM调用选项
-export interface LLMCallOptions {
-  model?: string;
-  temperature?: number;
-  maxTokens?: number;
-  timeout?: number;
-  retries?: number;
-}
-
-// LLM响应结果
-export interface LLMResponse {
-  content: string;
-  usage: {
-    promptTokens: number;
-    completionTokens: number;
-    totalTokens: number;
-  };
-  model: string;
-  responseTime: number;
-}
-
-export interface TokenUsageStats {
-  totalPromptTokens: number
-  totalCompletionTokens: number
-  totalTokens: number
-  totalCalls: number
-}
-
-// 文件分片
-export interface FileChunk {
-  id: number;
-  content: string;
-  startLine: number;
-  endLine: number;
-  context?: string;
-}
-
-// 分片解析结果
-export interface FileChunkAnalysis {
-  chunkId: number;
-  classes: Array<{
-    name: string;
-    extends?: string;
-    implements?: string[];
-    methods: Array<{
-      name: string;
-      signature: string;
-      description: string;
-      visibility: 'public' | 'private' | 'protected';
-    }>;
-    properties: Array<{
-      name: string;
-      type: string;
-      description: string;
-      visibility: 'public' | 'private' | 'protected';
-    }>;
-  }>;
-  functions: Array<{
-    name: string;
-    signature: string;
-    description: string;
-  }>;
-}
-
-// LLM配置
-export interface LLMConfig {
-  model: string;
-  api_key: string;
-  base_url?: string;
-  temperature: number;
-  max_tokens: number;
-  timeout: number;
-  proxy?: string;
-  max_retries: number;
-  retry_delay: number;
-  context_window_size: number;
-  cache_enabled: boolean;
-  cache_dir: string;
-  // V2.5：缓存容量上限（MB），0 表示禁用磁盘缓存
-  cache_max_size_mb: number;
-}
-
-// 扩展CLI配置（与 Config 对齐，供类型引用）
-export interface CliConfig {
-  global: {
-    logLevel: 'debug' | 'info' | 'warn' | 'error';
-    outputFormat: 'text' | 'json' | 'markdown';
-    autoConfirm: boolean;
-    outputDir: string;
-  };
-  llm: LLMConfig;
-  commands: {
-    analyze: {
-      defaultDepth: number;
-      defaultConcurrency: number;
-    };
-    skills: {
-      defaultProviders: string[];
-    };
-  };
-}

package/src/common/ui.ts

@@ -1,228 +0,0 @@
-import inquirer from 'inquirer';
-import pc from 'picocolors';
-import type { TokenUsageStats } from './types';
-
-interface CliRenderState {
-  total: number;
-  done: number;
-  currentObjects: string[];
-  tokens?: TokenUsageStats;
-  totalKnown: boolean;
-  scannedFiles?: number;
-}
-
-/**
- * CLI 多行区域渲染器：统一负责
- * - 进度行：「解析进度 |████...| 37% | 已处理: x/y 对象」
- * - 当前对象块：
- *   当前对象:
- *     [ foo ]
- *     [ bar ]
- * - Tokens 行：「Tokens: in=... out=... total=...」
- *
- * 通过 ANSI 光标控制码在同一块区域内重绘，避免产生多份重复的块。
- */
-export class CliMultiSectionRenderer {
-  private state: CliRenderState = {
-    total: 0,
-    done: 0,
-    currentObjects: [],
-    totalKnown: false,
-  };
-
-  // 最近一次渲染占用了多少行，用于回退光标和清空
-  private renderedLines = 0;
-  private readonly isInteractive: boolean;
-
-  constructor() {
-    this.isInteractive = !!process.stdout.isTTY && process.env.TERM !== 'dumb';
-  }
-
-  setTotal(total: number) {
-    this.state.total = total;
-    this.state.totalKnown = true;
-    if (this.state.done > total) {
-      this.state.done = total;
-    }
-    this.render();
-  }
-
-  updateProgress(done: number, total: number, currentPathsText?: string, maxLines?: number) {
-    this.state.done = done;
-    // 若 total 尚未通过 onTotalKnown 确认，则不接受外部传入的 total，避免占位魔法数字污染首帧。
-    if (this.state.totalKnown) {
-      this.state.total = total;
-    }
-    if (currentPathsText !== undefined) {
-      let lines = currentPathsText
-        .split('\n')
-        .map((l) => l.trim())
-        .filter((l) => l.length > 0);
-      if (typeof maxLines === 'number' && maxLines > 0 && lines.length > maxLines) {
-        lines = lines.slice(0, maxLines);
-      }
-      this.state.currentObjects = lines;
-    }
-    this.render();
-  }
-
-  updateTokens(tokens: TokenUsageStats) {
-    this.state.tokens = { ...tokens };
-    this.render();
-  }
-
-  /**
-   * 扫描阶段：实时更新“已扫描将被解析的文件数”。
-   * 该信息以单独一行展示，并在同一位置覆盖刷新。
-   */
-  updateScanProgress(scannedFiles: number) {
-    this.state.scannedFiles = scannedFiles;
-    this.render();
-  }
-
-  /**
-   * 在进度区域下方追加一条日志。
-   * 实现方式：先清空进度区域，将日志打印到 stdout，然后重新渲染进度区域。
-   */
-  logBelow(message: string) {
-    if (this.isInteractive) {
-      this.clearRenderedArea();
-      process.stdout.write(message + '\n');
-      this.render();
-    } else {
-      // 非交互终端下不做覆盖，仅顺序输出日志与最新快照，避免依赖 ANSI 光标控制。
-      process.stdout.write(message + '\n');
-      const lines = this.buildLines();
-      for (const line of lines) {
-        process.stdout.write(line + '\n');
-      }
-    }
-  }
-
-  private buildLines(): string[] {
-    const { total, done, currentObjects, tokens, totalKnown, scannedFiles } = this.state;
-
-    const safeTotal = totalKnown && total > 0 ? total : 1;
-    const ratio = totalKnown ? Math.max(0, Math.min(1, done / safeTotal)) : 0;
-    const percentage = totalKnown ? Math.floor(ratio * 100) : 0;
-
-    const barWidth = 40;
-    const completeCount = Math.round(barWidth * ratio);
-    const incompleteCount = barWidth - completeCount;
-    const bar =
-      '█'.repeat(completeCount) +
-      '░'.repeat(Math.max(0, incompleteCount));
-
-    const lines: string[] = [];
-
-    // 扫描阶段行：仅当有值时展示一行，实时覆盖刷新（对象=文件+目录）
-    if (typeof scannedFiles === 'number') {
-      lines.push(`Scanned objects to analyze: ${scannedFiles}`);
-    }
-
-    // 进度行（V2.4：将「已处理: x/y」拆为独立行，避免被“当前对象路径提取”误判为路径）
-    const totalLabel = totalKnown ? String(total) : '?';
-    lines.push(`${pc.blue('Progress')} |${pc.cyan(bar)}| ${percentage}%`);
-    lines.push(`Processed: ${done}/${totalLabel}`);
-
-    // 当前对象块
-    // 需求：仅当存在 worker 正在处理的对象时才展示该块；无对象时整段不输出（不占用任何行）。
-    if (currentObjects.length > 0) {
-      lines.push('Current:');
-      for (const obj of currentObjects) {
-        lines.push(`  [ ${obj} ]`);
-      }
-    }
-
-    // Tokens 行（即使 tokens 尚未产生也显示 0，避免首帧缺行导致 UI 跳变）
-    const t = tokens ?? { totalPromptTokens: 0, totalCompletionTokens: 0, totalTokens: 0, totalCalls: 0 };
-    lines.push(
-      `Tokens: in=${t.totalPromptTokens} out=${t.totalCompletionTokens} total=${t.totalTokens}`,
-    );
-
-    return lines;
-  }
-
-  private clearRenderedArea() {
-    if (!this.isInteractive || this.renderedLines <= 0) return;
-
-    // 将光标移动到渲染块的起始行
-    process.stdout.write(`\u001b[${this.renderedLines}F`);
-    for (let i = 0; i < this.renderedLines; i += 1) {
-      // 清除当前行并换行到下一行
-      process.stdout.write('\u001b[2K\r\n');
-    }
-    // 回到块的起始位置
-    process.stdout.write(`\u001b[${this.renderedLines}F`);
-    this.renderedLines = 0;
-  }
-
-  private render() {
-    const lines = this.buildLines();
-
-    if (this.isInteractive) {
-      // 将光标移到当前块顶部并清空旧内容
-      if (this.renderedLines > 0) {
-        process.stdout.write(`\u001b[${this.renderedLines}F`);
-      }
-      for (let i = 0; i < this.renderedLines; i += 1) {
-        process.stdout.write('\u001b[2K\r\n');
-      }
-      if (this.renderedLines > 0) {
-        process.stdout.write(`\u001b[${this.renderedLines}F`);
-      }
-
-      // 写入新内容
-      for (const line of lines) {
-        process.stdout.write('\u001b[2K'); // 清当前行
-        process.stdout.write(line + '\n');
-      }
-
-      this.renderedLines = lines.length;
-    } else {
-      // 非交互终端：不做覆盖，仅输出一次最新快照，避免光标控制符干扰日志采集。
-      for (const line of lines) {
-        process.stdout.write(line + '\n');
-      }
-      this.renderedLines = 0;
-    }
-  }
-}
-
-export const cliRenderer = new CliMultiSectionRenderer();
-
-export async function confirm(message: string, defaultAnswer: boolean = false): Promise<boolean> {
-  const { answer } = await inquirer.prompt([
-    {
-      type: 'confirm',
-      name: 'answer',
-      message,
-      default: defaultAnswer,
-    },
-  ]);
-  return answer;
-}
-
-export async function select(message: string, choices: string[]): Promise<string> {
-  const { selected } = await inquirer.prompt([
-    {
-      type: 'list',
-      name: 'selected',
-      message,
-      choices,
-    },
-  ]);
-  return selected;
-}
-
-export async function input(message: string, defaultValue?: string): Promise<string> {
-  const { value } = await inquirer.prompt([
-    {
-      type: 'input',
-      name: 'value',
-      message,
-      default: defaultValue,
-    },
-  ]);
-  return value;
-}

package/src/common/utils.ts

@@ -1,81 +0,0 @@
-import * as crypto from 'crypto'
-import * as path from 'path'
-import { DEFAULT_OUTPUT_DIR } from './constants'
-
-/**
- * 规范化路径：统一使用正斜杠、移除尾部斜杠
- * 用于索引文件中的路径标准化和 resolve 查询时的路径匹配
- */
-export function normalizePath(inputPath: string): string {
-  let normalized = inputPath.replace(/\\/g, '/')
-  if (normalized.length > 1 && normalized.endsWith('/')) {
-    normalized = normalized.slice(0, -1)
-  }
-  return normalized
-}
-
-export function generateProjectSlug(projectRoot: string, isGit: boolean, gitSlug?: string): string {
-  if (isGit && gitSlug) {
-    return gitSlug.replace('/', '-')
-  }
-  const dirName = path.basename(projectRoot)
-  const pathHash = crypto.createHash('md5').update(projectRoot).digest('hex').slice(0, 8)
-  return `${dirName}-${pathHash}`
-}
-
-export function getStoragePath(projectRoot: string, customOutputDir?: string): string {
-  const outputDir = customOutputDir || DEFAULT_OUTPUT_DIR
-  // 如果是相对路径，相对于项目根目录
-  if (!path.isAbsolute(outputDir)) {
-    return path.resolve(projectRoot, outputDir)
-  }
-  return outputDir
-}
-
-export function getFileOutputPath(storageRoot: string, filePath: string): string {
-  const parsed = path.parse(filePath)
-  // 特殊处理 index.xxx：为避免与目录级 index.md 冲突，文件结果命名为 index.xxx.md
-  if (parsed.name === 'index' && parsed.ext) {
-    return path.join(storageRoot, parsed.dir, `index${parsed.ext}.md`)
-  }
-  return path.join(storageRoot, parsed.dir, `${parsed.name}.md`)
-}
-
-export function getDirOutputPath(storageRoot: string, dirPath: string): string {
-  return path.join(storageRoot, dirPath, 'index.md')
-}
-
-/**
- * 受控并发执行：同时最多 limit 个 fn 在运行，所有 items 执行完毕后 resolve。
- */
-export async function mapLimit<T>(items: T[], limit: number, fn: (item: T) => Promise<void>): Promise<void> {
-  const concurrency = Math.max(1, Number(limit) || 1)
-  let nextIndex = 0
-  const runners = Array.from({ length: Math.min(concurrency, items.length) }, async () => {
-    while (true) {
-      const idx = nextIndex++
-      if (idx >= items.length) return
-      await fn(items[idx])
-    }
-  })
-  await Promise.all(runners)
-}
-
-export function getLanguageFromExtension(ext: string): string {
-  const map: Record<string, string> = {
-    '.js': 'javascript',
-    '.ts': 'typescript',
-    '.jsx': 'javascript',
-    '.tsx': 'typescript',
-    '.py': 'python',
-    '.java': 'java',
-    '.go': 'go',
-    '.cpp': 'cpp',
-    '.c': 'c',
-    '.cs': 'csharp',
-    '.php': 'php',
-    '.rb': 'ruby',
-    '.rs': 'rust'
-  }
-  return map[ext.toLowerCase()] || 'unknown'
-}

package/src/domain/index.ts

@@ -1 +0,0 @@
-export * from './interfaces'