archicore 0.1.0

package/README.md

@@ -0,0 +1,530 @@
+# AIArhitector
+
+**AI Software Architect System** - система ИИ-архитектор, которая понимает весь код, держит контекст и снижает риск багов практически до нуля.
+
+## Ключевые возможности
+
+### 1. **Понимание всего кода**
+- 🌲 **AST Parsing** - парсинг кода через Tree-sitter
+- 🕸️ **Dependency Graph** - полный граф зависимостей между компонентами
+- 🔍 **Symbol Extraction** - извлечение всех символов (функции, классы, интерфейсы)
+- 📊 **Call Graph** - граф вызовов функций
+
+### 2. **Семантическая память**
+- 🧠 **Vector Database** - хранение семантического понимания кода (Qdrant)
+- 🔎 **Semantic Search** - поиск по смыслу, а не по тексту
+- 💾 **Long-term Memory** - долговременная память о назначении компонентов
+
+### 3. **Архитектурные знания**
+- 🏛️ **Bounded Contexts** - описание границ контекстов
+- 📐 **Domain Entities** - доменные сущности и их связи
+- 📋 **Architectural Rules** - правила архитектуры
+- ⚖️ **Invariants** - инварианты системы
+
+### 4. **Анализ влияния изменений**
+- 🎯 **Impact Analysis** - определение затронутых компонентов
+- ⚠️ **Risk Assessment** - оценка рисков
+- 💡 **Recommendations** - автоматические рекомендации
+- 📈 **Impact Graph** - визуальный граф влияния
+
+### 5. **LLM Orchestration**
+- 🤖 **AI Architect** - ИИ-архитектор для принятия решений
+- 💬 **Contextual Answers** - ответы с учётом всего контекста
+- 🔄 **Code Review** - автоматический ревью кода
+- 📝 **Documentation** - генерация документации
+
+## Архитектура системы
+
+```
+┌─────────────────────────────────────────────────────┐
+│                   Git Repository                     │
+└─────────────────────────────────────────────────────┘
+                        ↓
+┌─────────────────────────────────────────────────────┐
+│              Code Index (AST + Graph)               │
+│  - Tree-sitter Parser                               │
+│  - Symbol Extraction                                │
+│  - Dependency Graph Builder                         │
+└─────────────────────────────────────────────────────┘
+                        ↓
+┌─────────────────────────────────────────────────────┐
+│          Semantic Memory (Vector DB)                │
+│  - Embeddings Generation                            │
+│  - Qdrant Vector Store                              │
+│  - Semantic Search                                  │
+└─────────────────────────────────────────────────────┘
+                        ↓
+┌─────────────────────────────────────────────────────┐
+│        Architecture Knowledge Layer                 │
+│  - Bounded Contexts                                 │
+│  - Domain Entities                                  │
+│  - Architectural Rules                              │
+│  - Invariants Validation                            │
+└─────────────────────────────────────────────────────┘
+                        ↓
+┌─────────────────────────────────────────────────────┐
+│           Change Impact Engine                      │
+│  - Affected Components Detection                    │
+│  - Risk Assessment                                  │
+│  - Recommendations Generation                       │
+│  - Impact Graph Building                            │
+└─────────────────────────────────────────────────────┘
+                        ↓
+┌─────────────────────────────────────────────────────┐
+│              LLM Orchestrator                       │
+│  - Claude / GPT Integration                         │
+│  - Context Management                               │
+│  - Architectural Decision Making                    │
+│  - Code Generation & Review                         │
+└─────────────────────────────────────────────────────┘
+                        ↓
+┌─────────────────────────────────────────────────────┐
+│          Interfaces (CLI, API, IDE)                 │
+└─────────────────────────────────────────────────────┘
+```
+
+## Установка
+
+### 1. Клонировать репозиторий
+
+```bash
+git clone https://github.com/yourusername/AIarhitector.git
+cd AIarhitector
+```
+
+### 2. Установить зависимости
+
+```bash
+npm install
+```
+
+### 3. Настроить окружение
+
+Создайте файл `.env`:
+
+```bash
+cp .env.example .env
+```
+
+Заполните необходимые ключи:
+
+```env
+# LLM API Keys
+ANTHROPIC_API_KEY=your_key_here
+OPENAI_API_KEY=your_key_here
+
+# Vector Database
+QDRANT_URL=http://localhost:6333
+QDRANT_API_KEY=
+
+# Database
+DATABASE_URL=postgresql://localhost:5432/aiarhitector
+```
+
+### 4. Запустить Qdrant (векторная БД)
+
+**Вариант A: Через скрипт (рекомендуется)**
+
+```bash
+# Windows
+start-qdrant.bat
+
+# Linux/Mac
+chmod +x start-qdrant.sh
+./start-qdrant.sh
+```
+
+Скрипт автоматически:
+- Использует Docker если установлен
+- Или скачает и запустит Qdrant binary
+
+**Вариант B: Через Docker Compose**
+
+```bash
+docker-compose up -d
+```
+
+**Вариант C: Вручную через Docker**
+
+```bash
+docker run -d --name qdrant -p 6333:6333 -p 6334:6334 qdrant/qdrant
+```
+
+После запуска Qdrant доступен на:
+- **API:** http://localhost:6333
+- **Dashboard:** http://localhost:6333/dashboard
+
+### 5. Собрать проект
+
+```bash
+npm run build
+```
+
+## Использование
+
+### CLI Команды
+
+#### 1. Индексирование проекта
+
+```bash
+npm run index
+# или
+npx tsx src/cli.ts index --dir /path/to/project
+```
+
+Результат:
+```
+✓ Проект проиндексирован!
+
+📊 Статистика:
+
+  Всего файлов: 156
+  Всего символов: 1243
+  Узлов в графе: 1399
+  Связей: 2847
+
+🔤 Символы по типам:
+
+  function: 687
+  class: 234
+  interface: 145
+  variable: 177
+
+🧠 Семантическая память:
+
+  Векторов: 1243
+  Точек: 1243
+```
+
+#### 2. Анализ влияния изменений
+
+```bash
+npx tsx src/cli.ts analyze \
+  --description "Объединить уроки и базу знаний в единую сущность" \
+  --files "src/lessons,src/knowledge-base" \
+  --type "refactor"
+```
+
+Результат:
+```
+📋 ОТЧЁТ ОБ АНАЛИЗЕ ВЛИЯНИЯ
+
+⚠ ЗАТРОНУТЫЕ КОМПОНЕНТЫ:
+
+  Всего: 47
+  🔴 Критические: 12
+  🟠 Высокие: 18
+  🟡 Средние: 11
+  🟢 Низкие: 6
+
+🔴 КРИТИЧЕСКИЕ КОМПОНЕНТЫ:
+
+  - CourseService (src/services/course.ts)
+    Directly modified
+  - KnowledgeRepository (src/repositories/knowledge.ts)
+    Direct dependency
+  - ProgressTracker (src/tracking/progress.ts)
+    Direct dependency
+
+⚠ РИСКИ:
+
+  [HIGH] Change affects 12 critical components
+  💡 Consider breaking into smaller changes
+
+  [CRITICAL] Modification may break API contracts
+  💡 Review and update all API consumers
+
+✅ РЕКОМЕНДАЦИИ:
+
+  [CRITICAL] Review all affected components
+  47 components will be affected by this change
+
+  [CRITICAL] Test critical components
+  Focus on: CourseService, KnowledgeRepository, ProgressTracker
+
+  [CRITICAL] Address high-severity risks
+  Change affects 12 critical components; Modification may break API contracts
+```
+
+#### 3. Семантический поиск
+
+```bash
+npx tsx src/cli.ts search \
+  --query "функции для обработки платежей" \
+  --limit 5
+```
+
+Результат:
+```
+🔍 РЕЗУЛЬТАТЫ ПОИСКА:
+
+1. src/payments/processor.ts:45
+   Релевантность: 94.23%
+   export class PaymentProcessor { processPayment(...)
+
+2. src/payments/stripe.ts:12
+   Релевантность: 87.15%
+   async function handleStripePayment(...)
+
+3. src/billing/charge.ts:78
+   Релевантность: 82.34%
+   function calculateCharge(amount, currency)
+```
+
+#### 4. Вопрос архитектору
+
+```bash
+npx tsx src/cli.ts ask \
+  --question "Как организована работа с платежами в системе?"
+```
+
+Результат:
+```
+💬 ОТВЕТ AI АРХИТЕКТОРА:
+
+В системе используется слоистая архитектура для работы с платежами:
+
+1. **Слой домена** (src/domain/payments)
+   - PaymentEntity - доменная сущность платежа
+   - PaymentStatus - статусы платежа
+   - Бизнес-правила валидации
+
+2. **Слой приложения** (src/application/payments)
+   - PaymentService - основной сервис обработки платежей
+   - UseCase классы для различных сценариев
+
+3. **Инфраструктурный слой** (src/infrastructure/payments)
+   - StripeAdapter - интеграция со Stripe
+   - PaymentRepository - персистентность
+   - EventPublisher - публикация событий
+
+Платежи обрабатываются асинхронно через очередь, что обеспечивает
+надёжность и возможность повторных попыток при ошибках.
+```
+
+#### 5. Генерация документации
+
+```bash
+npx tsx src/cli.ts docs --output ARCHITECTURE.md
+```
+
+Создаст подробную документацию по архитектуре проекта.
+
+## Поддерживаемые LLM провайдеры
+
+AIArhitector поддерживает несколько LLM провайдеров:
+
+### 1. **Claude (Anthropic)** ⭐ Рекомендуется
+- Лучшее качество для архитектурных решений
+- Модели: `claude-opus-4-20250514`, `claude-sonnet-4-20250514`
+- Контекст: до 200K токенов
+- Цена: $$$ (высокая)
+
+### 2. **GPT (OpenAI)**
+- Отличное качество
+- Модели: `gpt-4-turbo-preview`, `gpt-4`, `gpt-3.5-turbo`
+- Контекст: до 128K токенов
+- Цена: $$ (средняя-высокая)
+
+### 3. **DeepSeek** 💰 Бюджетный вариант ⚡ С автооптимизацией
+- Приемлемое качество для простых задач
+- Модели: `deepseek-chat`, `deepseek-coder`
+- Контекст: 16-32K токенов
+- Цена: $ (очень низкая, ~99% дешевле GPT-4)
+- **🚀 Автоматическая оптимизация промптов для лучшего качества!**
+
+⚠️ **Важно**: Для критических архитектурных решений рекомендуется Claude или GPT-4. DeepSeek подходит для разработки/тестирования.
+
+📖 **Документация**:
+- [DEEPSEEK.md](./DEEPSEEK.md) - Подробное сравнение плюсов/минусов
+- [DEEPSEEK_OPTIMIZATION.md](./DEEPSEEK_OPTIMIZATION.md) - Как работает автооптимизация
+
+#### Что делает автооптимизация:
+
+1. **Упрощает промпты** - убирает сложные формулировки
+2. **Сокращает контекст** - только топ-3 самых важных фрагмента
+3. **Переводит на английский** - DeepSeek лучше понимает английский
+4. **Структурирует вывод** - требует четкий формат ответа
+5. **Обрезает до оптимума** - 8000 символов вместо 32K
+6. **Retry с упрощением** - до 2 попыток с прогрессивным упрощением
+
+**Результат**: DeepSeek работает в **1.5-2x точнее** с автооптимизацией!
+
+### Пример использования DeepSeek
+
+```typescript
+const ai = new AIArhitector({
+  rootDir: '/path/to/project',
+  llm: {
+    provider: 'deepseek',      // вместо 'anthropic' или 'openai'
+    model: 'deepseek-chat',
+    temperature: 0.1,
+    maxTokens: 4096
+  },
+  vectorStore: {
+    url: 'http://localhost:6333',
+    collectionName: 'my-project'
+  }
+});
+```
+
+## Платформы
+
+### 🐧 Linux
+
+Для Linux созданы shell-скрипты:
+
+- **`setup.sh`** - Автоматическая установка и настройка
+- **`analyze-project.sh`** - Полный анализ проекта
+- **`ask-question.sh`** - Интерактивные вопросы AI
+- **`search-code.sh`** - Семантический поиск
+- **`test-full.sh`** - Проверка всей системы
+- **`start-qdrant-docker.sh`** - Запуск Qdrant в Docker
+
+**Быстрый старт Linux:**
+```bash
+# 1. Запустить установку
+chmod +x setup.sh
+./setup.sh
+
+# 2. Настроить .env с API ключами
+nano .env
+
+# 3. Запустить анализ
+./analyze-project.sh
+```
+
+📖 **Документация:**
+- [SETUP_LINUX.md](./SETUP_LINUX.md) - Полное руководство по установке
+- [QUICKSTART_LINUX.md](./QUICKSTART_LINUX.md) - Быстрый старт за 5 минут
+
+**Преимущества Linux:**
+- ✅ Лучше для production серверов
+- ✅ Легкая автоматизация (cron jobs)
+- ✅ Нет проблем с кодировкой
+- ✅ Отличная поддержка Docker
+- ✅ SSH доступ для удаленной работы
+
+## Программное использование
+
+```typescript
+import { AIArhitector, Change } from 'aiarhitector';
+
+// Создание экземпляра
+const ai = new AIArhitector({
+  rootDir: '/path/to/project',
+  llm: {
+    provider: 'anthropic',
+    model: 'claude-sonnet-4-20250514',
+    temperature: 0.1,
+    maxTokens: 4096
+  },
+  vectorStore: {
+    url: 'http://localhost:6333',
+    collectionName: 'my-project'
+  }
+});
+
+// Инициализация
+await ai.initialize();
+
+// Анализ изменений
+const change: Change = {
+  type: 'modify',
+  description: 'Обновление API аутентификации',
+  files: ['src/auth/api.ts'],
+  symbols: ['AuthController', 'loginUser']
+};
+
+const impact = await ai.analyzeChange(change);
+
+console.log('Затронутые компоненты:', impact.affectedNodes.length);
+console.log('Риски:', impact.risks);
+console.log('Рекомендации:', impact.recommendations);
+
+// Семантический поиск
+const results = await ai.searchCode('функции валидации email', 5);
+
+// Вопрос архитектору
+const answer = await ai.askQuestion(
+  'Какие компоненты отвечают за аутентификацию?'
+);
+
+// Ревью кода
+const review = await ai.reviewCode(
+  codeContent,
+  ['src/auth/api.ts'],
+);
+
+// Генерация документации
+const docs = await ai.generateDocumentation();
+```
+
+## Конфигурация архитектуры
+
+Создайте файл `.aiarhitector/architecture.json`:
+
+```json
+{
+  "boundedContexts": [
+    {
+      "id": "core",
+      "name": "Core Domain",
+      "description": "Основная бизнес-логика",
+      "modules": ["src/core"],
+      "dependencies": [],
+      "prohibitedDependencies": ["src/ui", "src/external"]
+    }
+  ],
+  "entities": [
+    {
+      "id": "user",
+      "name": "User",
+      "context": "core",
+      "properties": [...],
+      "relationships": [...],
+      "invariants": [...]
+    }
+  ],
+  "rules": [],
+  "invariants": []
+}
+```
+
+Пример см. в `.aiarhitector/architecture.example.json`
+
+## Этапы внедрения
+
+### Этап 1 (2-3 недели)
+- ✅ Индексация кода (AST + граф)
+- ✅ Семантическая память (векторная БД)
+- ✅ Анализ влияния изменений (read-only)
+
+### Этап 2 (1-2 недели)
+- ⏳ PR-анализ
+- ⏳ Автоматические подсказки
+- ⏳ Интеграция с IDE
+
+### Этап 3 (2-3 недели)
+- ⏳ Микро-рефакторинг
+- ⏳ Автоматическая документация
+- ⏳ Continuous learning
+
+## Технологический стек
+
+- **Языки**: TypeScript
+- **AST**: Tree-sitter (TypeScript, JavaScript, Python)
+- **Vector DB**: Qdrant
+- **LLM**: Anthropic Claude, OpenAI GPT
+- **Database**: PostgreSQL (опционально)
+- **CLI**: Commander.js
+- **Logging**: Custom logger with Chalk
+
+## Производительность
+
+- Индексация 1000 файлов: ~30 секунд
+- Анализ влияния: ~2-5 секунд
+- Семантический поиск: ~100ms
+- LLM запрос: ~2-10 секунд (зависит от модели)
+
+

package/dist/analyzers/dead-code.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Dead Code Detector
+ *
+ * Обнаружение неиспользуемого кода:
+ * - Неиспользуемые экспорты
+ * - Неиспользуемые переменные
+ * - Unreachable code
+ * - Пустые функции/классы
+ * - Закомментированный код
+ */
+import { DependencyGraph, Symbol } from '../types/index.js';
+export interface DeadCodeResult {
+    unusedExports: UnusedExport[];
+    unusedVariables: UnusedVariable[];
+    unreachableCode: UnreachableCode[];
+    emptyBlocks: EmptyBlock[];
+    commentedCode: CommentedCode[];
+    summary: DeadCodeSummary;
+}
+export interface UnusedExport {
+    name: string;
+    type: string;
+    file: string;
+    line: number;
+    suggestion: string;
+}
+export interface UnusedVariable {
+    name: string;
+    file: string;
+    line: number;
+    scope: string;
+}
+export interface UnreachableCode {
+    file: string;
+    startLine: number;
+    endLine: number;
+    reason: string;
+}
+export interface EmptyBlock {
+    type: 'function' | 'class' | 'if' | 'catch' | 'loop';
+    name?: string;
+    file: string;
+    line: number;
+}
+export interface CommentedCode {
+    file: string;
+    startLine: number;
+    endLine: number;
+    linesCount: number;
+    preview: string;
+}
+export interface DeadCodeSummary {
+    totalIssues: number;
+    unusedExportsCount: number;
+    unusedVariablesCount: number;
+    unreachableCodeLines: number;
+    emptyBlocksCount: number;
+    commentedCodeLines: number;
+    estimatedCleanupHours: number;
+}
+export declare class DeadCodeDetector {
+    /**
+     * Анализ мёртвого кода
+     */
+    analyze(graph: DependencyGraph, symbols: Map<string, Symbol>, fileContents: Map<string, string>): Promise<DeadCodeResult>;
+    /**
+     * Поиск неиспользуемых экспортов
+     */
+    private findUnusedExports;
+    /**
+     * Поиск неиспользуемых переменных
+     */
+    private findUnusedVariables;
+    /**
+     * Поиск недостижимого кода
+     */
+    private findUnreachableCode;
+    /**
+     * Поиск пустых блоков
+     */
+    private findEmptyBlocks;
+    /**
+     * Поиск закомментированного кода
+     */
+    private findCommentedCode;
+    /**
+     * Подсказка для неиспользуемого экспорта
+     */
+    private getSuggestionForUnusedExport;
+    /**
+     * Сводка
+     */
+    private calculateSummary;
+}
+//# sourceMappingURL=dead-code.d.ts.map