solver-sdk 3.1.18 → 5.0.0

package/README.md

@@ -1,7 +1,7 @@
-# Code Solver SDK v3.1.15
+# Code Solver SDK v5.0.0
 
-> **JavaScript/TypeScript SDK для VS Code Extensions**  
-> Подключение к AI бэкенду для индексации, поиска и работы с кодом
+> **🗑️ Ультра-чистый JavaScript/TypeScript SDK для VS Code Extensions**  
+> Без legacy кода, без мертвых методов, только актуальный API
 
 JavaScript/TypeScript SDK для работы с Code Solver API. Предоставляет простой интерфейс для индексации кода, семантического поиска функций и работы с AI чатом.
 
@@ -9,87 +9,15 @@ JavaScript/TypeScript SDK для работы с Code Solver API. Предост
 
 - **💬 Chat API** - взаимодействие с AI моделями (Claude, GPT)
 - **🔍 Code Search** - семантический поиск по коду и функциям
-- **📊 Project Indexing** - индексация и анализ проектов
+- **📊 Project Indexing** - индексация и анализ проектов с **богатой информацией**
 - **📝 Context API** - получение контекста для AI
 - **🛠️ Code Modification** - модификация кода через AI
 - **🔇 Настраиваемое логирование** - полный контроль над выводом в консоль
+- **✨ Улучшенная типизация** - полные TypeScript типы с примерами и документацией
 
-## 🔄 Последние обновления v3.1.15
+## 🚀 Что нового в v5.0.0
 
-### 🐛 Критические исправления (v3.1.15)
-
-- **ИСПРАВЛЕНА КРИТИЧЕСКАЯ ОШИБКА 404**: Полностью обновлен SDK для работы с унифицированным API
-  - Все методы теперь используют правильный endpoint `/api/v1/projects`
-  - Убраны ссылки на несуществующий endpoint `/projects/find-or-create`
-  - Полная совместимость с backend API v3.1.14
-  - Решены все проблемы с дедупликацией проектов
-
-### 🎯 Унифицированная архитектура
-
-- **Один endpoint для всех операций**: Все методы создания проектов используют единый `POST /projects` с автоматической дедупликацией
-- **Никаких дубликатов**: Система автоматически находит существующие проекты по пути
-- **Упрощенная API**: Убрана избыточность, улучшена консистентность
-
-### 🔄 Предыдущие обновления v3.1.9
-
-### ✅ КРИТИЧЕСКОЕ ИСПРАВЛЕНИЕ: Соответствие официальной документации Anthropic API
-
-- **🔧 Tool choice валидация**: Исправлена согласно официальной документации
-  - Только `tool_choice: "any"` или `{ type: "any" }` с thinking (как в документации)
-  - Убраны неточные валидации `auto`, `none` с thinking
-- **🛡️ Interleaved thinking**: Улучшена логика добавления beta header
-  - Добавляет `interleaved-thinking-2025-05-14` только если `options.beta` не установлен
-- **📋 onEvent callback**: Финальное исправление структуры данных
-  - 100% соответствие стандарту Anthropic API в onEvent callbacks
-
-### v3.1.8 (предыдущие обновления)
-
-### 🚨 КРИТИЧЕСКОЕ ИСПРАВЛЕНИЕ: onEvent callback данные
-- **Проблема решена**: onEvent callback теперь получает **оригинальные события Anthropic API**
-- **Исправлено**: `content_block_start` содержит полный `content_block` объект с правильными `id`, `name`, `input`
-- **Исправлено**: `input_json_delta` передается как `delta.type: 'input_json_delta'` вместо обычного text
-- **Убрано**: Лишние поля `projectId`, `timestamp` которые нарушали стандарт Anthropic
-- **Результат**: Полная совместимость с Anthropic API стандартом для tool_use событий
-
-### 🔧 Что было исправлено:
-```javascript
-// ❌ БЫЛО (v3.1.7): onEvent получал обработанные данные
-onEvent: (type, data) => {
-  // data содержал: { projectId, timestamp, content_block: null }
-}
-
-// ✅ СТАЛО (v3.1.8): onEvent получает оригинальные данные
-onEvent: (type, data) => {
-  // data содержит стандартные Anthropic события:
-  // content_block_start: { type, index, content_block: { type: 'tool_use', id, name, input } }
-  // content_block_delta: { type, index, delta: { type: 'input_json_delta', partial_json } }
-}
-```
-
-### v3.1.7 (предыдущие обновления)
-
-### 🚨 ИСПРАВЛЕНО: Избыточное логирование в консоли
-- **Проблема решена**: SDK больше не создает спам в Developer Console VS Code
-- **Новые уровни логирования**: `'silent' | 'error' | 'warn' | 'info' | 'debug'`
-- **Детальный контроль потоков**: Настройка логирования SSE событий, chunk'ов и callbacks
-- **Обратная совместимость**: Старые опции `debug: true/false/'verbose'` работают как раньше
-
-### v3.1.6 (предыдущие обновления)
-
-- **🔧 КРИТИЧЕСКОЕ ИСПРАВЛЕНИЕ**: Восстановлена передача `content_block_start` событий для `tool_use` блоков
-- **✅ Tool Continuation**: Исправлена поддержка tool continuation функциональности
-- **🛠️ Новые события**: Добавлена обработка `input_json_delta`, `signature_delta` для инструментов
-- **📊 Улучшенная обработка**: Корректная обработка всех типов content блоков (thinking, text, tool_use)
-- **🔒 Валидация**: Исправлена валидация `tool_choice` согласно документации Anthropic
-
-### v3.1.5 (предыдущие улучшения)
-- **✅ Исправлена критическая проблема `toJSON`** - решена ошибка сериализации в VS Code IPC
-- **🆕 Новые API методы**: `getIndexingStatus()`, `getProjectInfo()` для безопасной работы  
-- **🔧 Безопасная сериализация**: Все Date объекты автоматически преобразуются в ISO строки
-- **🧠 Thinking API**: Полная поддержка мышления Claude с real-time выводом
-- **📊 Real-time данные**: Приоритет live данных над статическими из БД
-
-> **Для разработчиков инструментов**: v3.1.6 восстанавливает корректную работу tool continuation!
+> **Чистая версия** - убраны все устаревшие методы. Только актуальный API без мертвого кода.
 
 ## 📦 Установка
 
@@ -97,518 +25,199 @@ onEvent: (type, data) => {
 npm install solver-sdk
 ```
 
-## 🔇 Настройка логирования (v3.1.7+)
-
-SDK предлагает гибкую систему логирования для контроля вывода в консоль:
-
-### 📊 Уровни логирования
-```javascript
-const sdk = await CodeSolverSDK.create({
-  baseURL: 'http://localhost:3000',
-  
-  // Уровни логирования (от тихого к подробному):
-  debug: 'silent', // Полное отключение (даже ошибки)
-  debug: 'error',  // Только ошибки (рекомендуется для VS Code)  
-  debug: 'warn',   // Предупреждения и ошибки
-  debug: 'info',   // Базовая информация
-  debug: 'debug',  // Подробная отладка
-  
-  // Обратная совместимость:
-  debug: false,     // Отключено
-  debug: true,      // Базовое логирование
-  debug: 'verbose'  // Подробное (аналог 'debug')
-});
-```
+## ⚙️ Конфигурация
 
-### 🎛️ Детальный контроль потоков
 ```javascript
 const sdk = await CodeSolverSDK.create({
-  baseURL: 'http://localhost:3000',
-  debug: 'debug', // или любой уровень
-  
-  // Точная настройка логирования потоков:
-  streamLogging: {
-    sseEvents: false,     // SSE события (content_block_start/delta/stop)
-    streamChunks: false,  // Chunk'и потока (каждый кусок текста)
-    eventCallbacks: false,// onEvent callback'и
-    importantOnly: true   // Только важные события (start, stop, errors)
-  }
+  baseURL: 'http://localhost:3000',     // Обязательный  
+  apiKey: 'your-api-key',               // Опционально
+  timeout: 30000,                       // Таймаут запросов (мс)
+  debug: 'error'                        // Уровень логирования
 });
 ```
 
-### 🎯 Рекомендуемые настройки
-```javascript
-// 🔹 VS Code Extension (production):
-debug: 'error'
-
-// 🔹 Development:
-debug: 'info'
-
-// 🔹 Deep debugging:
-debug: 'debug',
-streamLogging: { sseEvents: true, streamChunks: true }
-
-// 🔹 Полная тишина:
-debug: 'silent'
-```
+### 📊 Уровни логирования
+- `'silent'` - полное отключение
+- `'error'` - только ошибки (рекомендуется)  
+- `'warn'` - предупреждения и ошибки
+- `'info'` - базовая информация
+- `'debug'` - подробная отладка
 
 ## 🚀 Быстрый старт
 
 ```javascript
 import { CodeSolverSDK } from 'solver-sdk';
 
-// Создание SDK с чистой консолью (рекомендуется для VS Code)
+// Создание SDK
 const sdk = await CodeSolverSDK.create({
   baseURL: 'http://localhost:3000',
-  debug: 'error' // Только ошибки, никакого спама
+  debug: 'error' // Рекомендуемый уровень для production
 });
 
-// Или с детальным логированием для отладки
-const debugSdk = await CodeSolverSDK.create({
-  baseURL: 'http://localhost:3000',
-  debug: 'debug',
-  streamLogging: {
-    sseEvents: true,     // Логировать SSE события
-    streamChunks: true,  // Логировать chunk'и потока
-    eventCallbacks: true // Логировать onEvent callbacks
-  }
-});
-
-// Создание и индексация проекта
-const project = await sdk.projects.findOrCreateProject(
-  '/path/to/project',
-  'My Project'
+// 1. Создание проекта (с автоматической дедупликацией)
+const project = await sdk.projects.createProject(
+  'My Project',
+  '/path/to/project'
 );
 
+// 2. Запуск индексации
 await sdk.projects.startIndexing(project.id);
 
-// 📝 Важно (v3.1.15): Все методы создания проектов теперь используют
-// единый endpoint /api/v1/projects с автоматической дедупликацией.
-// Никаких дубликатов проектов!
+// 3. Проверка статуса
+const status = await sdk.projects.getIndexingStatus(project.id);
+console.log(`Статус: ${status.status}, прогресс: ${status.progress}%`);
 
-// Поиск кода
-const searchResults = await sdk.search.searchCode(project.id, {
+// 4. Поиск в коде
+const results = await sdk.search.searchCode(project.id, {
   query: 'function calculateSum',
   limit: 10
 });
 
-// Поиск функций
-const functions = await sdk.search.searchFunctions(project.id, {
-  query: 'FileIndexingService',
-  limit: 5
-});
-
-// Работа с чатом
+// 5. Чат с AI
 const response = await sdk.chat.chat([
-  { role: 'user', content: 'Объясни этот код' }
+  { role: 'user', content: 'Объясни найденный код' }
 ], { projectId: project.id });
 
-// Потоковый чат с thinking (мышлением)
-for await (const chunk of sdk.chat.streamChat([
-  { role: 'user', content: 'Объясни рекурсию пошагово' }
-], { 
-  projectId: project.id,
-  thinking: {
-    type: 'enabled',
-    budget_tokens: 5000
-  },
-  onEvent: (type, data) => {
-    if (type === 'content_block_delta' && data.delta?.type === 'thinking_delta') {
-      console.log(`🧠 Думает: ${data.delta.thinking}`);
-    } else if (type === 'content_block_delta' && data.delta?.type === 'text_delta') {
-      console.log(`💬 Отвечает: ${data.delta.text}`);
-    }
-  }
-})) {
-  if (chunk.text) {
-    process.stdout.write(chunk.text);
-  }
-}
+console.log(response.content);
 ```
 
 ## 📋 API Методы
 
 ### 📁 Projects API
 ```javascript
-// Создание проекта (исправленная сигнатура)
-await sdk.projects.createProject(
-  'Project Name',           // name
-  '/project/path',          // path
-  { description: 'Desc' }   // data (опционально)
-);
-  
-// Получение списка проектов  
-await sdk.projects.getProjects();
-
-// Получение информации о проекте
-await sdk.projects.getProject(projectId);
+// Создание проекта
+await sdk.projects.createProject('Project Name', '/project/path');
+await sdk.projects.createProject('Project Name', '/project/path', { description: 'Optional' });
 
-// Получение готовых проектов
-await sdk.projects.getReadyProjects();
+// Получение проектов
+await sdk.projects.getAllProjects();       // Все проекты
+await sdk.projects.getReadyProjects();     // Только готовые к работе
+await sdk.projects.getProject(projectId);  // Конкретный проект с полной информацией
 ```
 
-### 🔄 Projects & Indexing API
+### ⚙️ Indexing API  
 ```javascript
-// Создание/поиск проекта и запуск индексации
-const project = await sdk.projects.findOrCreateProject('/path/to/project', 'Project Name');
-await sdk.projects.startIndexing(project.id, { force: false }); // options опционально
-
-// Получение real-time статуса индексации
-const indexingStatus = await sdk.projects.getIndexingStatus(project.id);
-console.log('Статус:', indexingStatus.status, 'Прогресс:', indexingStatus.progress + '%');
-
-// Получение общей информации о проекте  
-const projectInfo = await sdk.projects.getProjectInfo(project.id);
-
-// Ожидание завершения индексации
-while (true) {
-  const status = await sdk.projects.getIndexingStatus(project.id);
-  console.log(`Прогресс: ${status.progress}%, Файлы: ${status.processedFiles}/${status.totalFiles}`);
-  
-  if (status.status === 'complete') break;
-  if (status.status === 'failed') throw new Error('Ошибка индексации: ' + status.error);
-  
-  await new Promise(resolve => setTimeout(resolve, 2000));
-}
+// Управление индексацией
+await sdk.projects.startIndexing(projectId);
+await sdk.projects.cancelIndexing(projectId);
+
+// Статус индексации
+const status = await sdk.projects.getIndexingStatus(projectId);
+console.log(`${status.status}: ${status.progress}%`);
 ```
 
 ### 🔍 Search API
 ```javascript
-// Поиск кода (гибкая сигнатура)
-// Способ 1: projectId отдельно
-await sdk.search.searchCode(projectId, {
-  query: 'search query',
+// Поиск в коде
+const results = await sdk.search.searchCode(projectId, {
+  query: 'function name',
   limit: 20
 });
 
-// Способ 2: projectId в параметрах
-await sdk.search.searchCode({
-  projectId: projectId,
-  query: 'search query',
-  limit: 20
-});
-
-// Поиск функций (гибкая сигнатура)
-// Способ 1: projectId отдельно
+// Поиск функций
 const functions = await sdk.search.searchFunctions(projectId, {
-  query: 'calculateSum',
-  limit: 10
-});
-
-// Способ 2: projectId в параметрах
-const functions = await sdk.search.searchFunctions({
-  projectId: projectId,
-  query: 'calculateSum',
+  query: 'calculateSum', 
   limit: 10
 });
 
-// Статистика функций в проекте
+// Статистика
 const stats = await sdk.search.getFunctionStats(projectId);
-console.log(`Всего функций: ${stats.stats.totalFunctions}`);
 ```
 
 ### 💬 Chat API
 ```javascript
-// Обычный чат (projectId опционален в реализации, но рекомендуется)
+// Обычный чат
 const response = await sdk.chat.chat([
-  { role: 'user', content: 'Объясни этот код' }
-], { projectId: 'your-project-id' }); // projectId опционален
+  { role: 'user', content: 'Explain this code' }
+], { projectId });
 
-// Потоковый чат
-for await (const chunk of sdk.chat.streamChat(messages, { projectId: 'your-project-id' })) {
+// Потоковый чат  
+for await (const chunk of sdk.chat.streamChat(messages, { projectId })) {
   console.log(chunk.text);
 }
 
-// 🧠 Chat с thinking (мышлением Claude)
-const response = await sdk.chat.chat([
-  { role: 'user', content: 'Объясни рекурсию подробно' }
-], { 
-  projectId: 'your-project-id',
-  thinking: {
-    type: 'enabled',
-    budget_tokens: 5000  // Бюджет для мышления
-  }
+// С thinking (мышление Claude)
+const response = await sdk.chat.chat(messages, { 
+  projectId,
+  thinking: { type: 'enabled', budget_tokens: 5000 }
 });
+```
+
+## 💡 Типы данных
 
-// 🧠 Потоковый чат с thinking и real-time выводом
-for await (const chunk of sdk.chat.streamChat([
-  { role: 'user', content: 'Проанализируй архитектуру проекта' }
-], {
-  projectId: 'your-project-id',
-  thinking: {
-    type: 'enabled',
-    budget_tokens: 8000
-  },
-  onEvent: (type, data) => {
-    if (type === 'content_block_delta' && data.delta?.type === 'thinking_delta') {
-      console.log(`🧠 Думает: ${data.delta.thinking}`);
-    } else if (type === 'content_block_delta' && data.delta?.type === 'text_delta') {
-      console.log(`💬 Отвечает: ${data.delta.text}`);
-    }
-  }
-})) {
-  if (chunk.text) {
-    process.stdout.write(chunk.text);
-  }
+### Project
+```typescript
+interface Project {
+  id: string;
+  name: string; 
+  path: string;
+  ready: boolean;              // Готов к работе
+  fileCount: number;           // Количество файлов
+  indexStatus: 'pending' | 'indexing' | 'indexed' | 'failed' | 'cancelled';
+  indexingProgress?: number;   // 0-100%
+  languageStats?: {[lang: string]: number};  // Статистика языков
+  indexingErrors?: any[];      // Ошибки индексации
+  // ... и еще 10+ полей
 }
 ```
 
-## ⚙️ Конфигурация
+## 📚 Пример использования
 
 ```javascript
+import { CodeSolverSDK } from 'solver-sdk';
+
 const sdk = await CodeSolverSDK.create({
-  baseURL: 'http://localhost:3000',     // Обязательный
-  apiKey: 'your-api-key',               // Рекомендуется
-  timeout: 30000,                       // Таймаут запросов
-  debug: false                          // Отладка
+  baseURL: 'http://localhost:3000'
 });
-```
-
-**⚠️ Важно**: Для Chat API `projectId` **рекомендуется**, но не обязателен в реализации:
-```javascript
-// ✅ РАБОТАЕТ (но без контекста проекта)
-const response = await sdk.chat.chat(messages);
-
-// ✅ РЕКОМЕНДУЕТСЯ (с контекстом проекта)
-const response = await sdk.chat.chat(messages, { projectId: 'your-project-id' });
-
-// 💡 Получить projectId можно так:
-const projects = await sdk.projects.getReadyProjects();
-const projectId = projects[0].id;
-```
 
-## 🧪 Тестирование
-
-```bash
-# Все тесты
-npm test
-
-# Только HTTP тесты
-npm test -- --testNamePattern="HTTP"
-
-# Интеграционные тесты
-npm run test:integration
-
-# Тесты индексации
-npm test -- --testPathPattern="indexing"
-```
-
-## 📚 Примеры использования
-
-### Полный цикл работы с проектом
-
-```javascript
-import { CodeSolverSDK } from 'solver-sdk';
+// Работа с проектом
+const project = await sdk.projects.createProject('My App', '/path/to/app');
+await sdk.projects.startIndexing(project.id);
 
-async function fullWorkflow() {
-  const sdk = await CodeSolverSDK.create({
-    baseURL: 'http://localhost:3000'
-  });
-  
-  try {
-    // 1. Создаем проект
-    const project = await sdk.projects.findOrCreateProject(
-      '/path/to/react-app',
-      'My React App'
-    );
-  
-    // 2. Запускаем индексацию
-    console.log('Запуск индексации...');
-    await sdk.projects.startIndexing(project.id);
-
-    // 3. Ждем завершения индексации
-    console.log('Ожидание завершения индексации...');
-    while (true) {
-      const status = await sdk.projects.getIndexingStatus(project.id);
-      if (status.status === 'complete') break;
-      if (status.status === 'failed') throw new Error('Ошибка индексации: ' + status.error);
-      await new Promise(resolve => setTimeout(resolve, 2000));
-    }
-
-    // 4. Ищем React компоненты
-    const components = await sdk.search.searchCode(project.id, {
-      query: 'React.Component class',
-      limit: 10
-    });
-
-    // 5. Задаем вопрос AI о коду
-    const aiResponse = await sdk.chat.chat([
-      {
-        role: 'user',
-        content: `Проанализируй найденные React компоненты: ${JSON.stringify(components)}`
-      }
-    ], { projectId: project.id });
-    
-    console.log('✅ Анализ завершен');
-    console.log('📊 Компоненты:', components.results.length);
-    console.log('🤖 AI анализ:', aiResponse.content);
-
-  } catch (error) {
-    console.error('❌ Ошибка:', error.message);
-  }
-}
+// Ожидание индексации
+let status;
+do {
+  status = await sdk.projects.getIndexingStatus(project.id);
+  console.log(`${status.status}: ${status.progress}%`);
+  await new Promise(r => setTimeout(r, 2000));
+} while (status.status === 'indexing');
+
+// Поиск и чат
+const results = await sdk.search.searchCode(project.id, { 
+  query: 'function main', 
+  limit: 5 
+});
 
-fullWorkflow();
+const response = await sdk.chat.chat([
+  { role: 'user', content: 'Explain this code' }
+], { projectId: project.id });
 ```
 
 ## 🔧 Устранение неполадок
 
-### ✅ Исправлена проблема toJSON (v3.1.5)
-```javascript
-// ❌ СТАРАЯ ОШИБКА (до v3.1.5):
-// CodeExpectedError: Method not found: toJSON
-
-// ✅ РЕШЕНИЕ: Обновите SDK до последней версии
-npm install solver-sdk@latest  # v3.1.15
-
-// ✅ Теперь все API возвращают JSON-совместимые объекты
-const status = await sdk.projects.getIndexingStatus(projectId);
-// Все Date объекты автоматически преобразуются в ISO строки
-```
-
-### Проблемы с подключением
 ```javascript
-// Проверка здоровья API
-const isHealthy = await sdk.checkHealth();
-console.log('API доступен:', isHealthy);
-```
+// Проверка подключения
+const response = await fetch('http://localhost:3000/health');
+console.log('Backend доступен:', response.ok);
 
-### Таймауты и повторы
-```javascript
-// Увеличение таймаутов для больших проектов
+// Увеличение таймаута для больших проектов  
 const sdk = await CodeSolverSDK.create({
   baseURL: 'http://localhost:3000',
   timeout: 120000  // 2 минуты
 });
+
+// Отладка с подробными логами
+const sdk = await CodeSolverSDK.create({
+  baseURL: 'http://localhost:3000', 
+  debug: 'debug'
+});
 ```
 
 ## 📄 Лицензия
 
 MIT License
 
-## 🔧 Индексация: полный workflow
-
-```javascript
-async function indexProject(projectPath, projectName) {
-  const sdk = await CodeSolverSDK.create({
-    baseURL: 'http://localhost:3000'
-  });
-  
-  // 1. Создать/найти проект
-  const project = await sdk.projects.findOrCreateProject(projectPath, projectName);
-  
-  // 2. Запустить индексацию
-  await sdk.projects.startIndexing(project.id);
-  
-  // 3. Мониторинг прогресса
-  while (true) {
-    const status = await sdk.projects.getIndexingStatus(project.id);
-    
-    if (status.status === 'complete') {
-      console.log('✅ Индексация завершена!');
-      break;
-    } else if (status.status === 'failed') {
-      console.log('❌ Ошибка:', status.error);
-      break;
-    }
-    
-    console.log(`📊 Прогресс: ${status.progress || 0}%`);
-    await new Promise(resolve => setTimeout(resolve, 2000));
-  }
-  
-  return project;
-}
-```
-
-## 🔌 VS Code Extension (готовый код)
-
-```typescript
-import { CodeSolverSDK } from 'solver-sdk';
-import * as vscode from 'vscode';
-
-let sdk: CodeSolverSDK;
-
-export async function activate(context: vscode.ExtensionContext) {
-  sdk = await CodeSolverSDK.create({
-    baseURL: 'http://localhost:3000'
-  });
-  
-  // Команда индексации
-  const indexCmd = vscode.commands.registerCommand('extension.indexProject', async () => {
-    const folder = vscode.workspace.workspaceFolders?.[0];
-    if (!folder) return;
-    
-    return vscode.window.withProgress({
-      location: vscode.ProgressLocation.Notification,
-      title: 'Индексация проекта',
-      cancellable: false
-    }, async (progress) => {
-      const project = await sdk.projects.findOrCreateProject(folder.uri.fsPath, folder.name);
-      await sdk.projects.startIndexing(project.id);
-      
-      while (true) {
-        const status = await sdk.projects.getIndexingStatus(project.id);
-        if (status.status === 'complete') break;
-        progress.report({ message: `${status.progress || 0}%` });
-        await new Promise(resolve => setTimeout(resolve, 2000));
-      }
-      
-      vscode.window.showInformationMessage('✅ Проект проиндексирован!');
-    });
-  });
-  
-  // Команда поиска функций
-  const searchCmd = vscode.commands.registerCommand('extension.searchFunctions', async () => {
-    const query = await vscode.window.showInputBox({ prompt: 'Поиск функций' });
-    if (!query) return;
-    
-    const projects = await sdk.projects.getReadyProjects();
-    if (projects.length === 0) return;
-    
-    const response = await sdk.search.searchFunctions(projects[0].id, { query, limit: 20 });
-    
-    if (!response.success || response.results.length === 0) {
-      vscode.window.showInformationMessage('Функции не найдены');
-      return;
-    }
-    
-    const items = response.results.map(fn => ({
-      label: fn.name,
-      description: fn.signature,
-      detail: `${fn.filePath}:${fn.startLine}`,
-      function: fn
-    }));
-    
-    const selected = await vscode.window.showQuickPick(items);
-    if (selected) {
-      const doc = await vscode.workspace.openTextDocument(selected.function.filePath);
-      const editor = await vscode.window.showTextDocument(doc);
-      
-      const range = new vscode.Range(
-        selected.function.startLine - 1, 0,
-        selected.function.endLine - 1, 0
-      );
-      
-      editor.selection = new vscode.Selection(range.start, range.end);
-      editor.revealRange(range, vscode.TextEditorRevealType.InCenter);
-    }
-  });
-  
-  context.subscriptions.push(indexCmd, searchCmd);
-}
-
-// package.json для VS Code Extension
-{
-  "contributes": {
-    "commands": [
-      { "command": "extension.indexProject", "title": "📊 Индексировать проект" },
-      { "command": "extension.searchFunctions", "title": "🔍 Поиск функций" }
-    ]
-  },
-  "dependencies": { "solver-sdk": "^3.1.5" }
-}
-```
-
 ---
 
-**🎉 Один файл = полная документация!**
+> **Документация актуальна для v5.0.0**  
+> История изменений: [CHANGELOG.md](CHANGELOG.md)