# Клонируйте репозиторий и установите зависимости
cd codegraph
pip install -r requirements.txt

# Настройте учетные данные API (выберите один вариант)
export GIGACHAT_AUTH_KEY="ваш-ключ-здесь"    # GigaChat (Сбер)
# ИЛИ
export OPENAI_API_KEY="ваш-ключ-здесь"        # OpenAI

python -m src.tui.app

╭─────────────────────────────────────────────────────────╮
│  Интерактивная консоль CodeGraph                          │
│  Введите /help для получения списка команд, /exit для выхода │
╰─────────────────────────────────────────────────────────╯

> Где определена функция heap_insert?

╭─────────────── Ответ ────────────────╮
│ heap_insert определена в:            │
│   src/backend/access/heap/heapam.c    │
│   Строка: 2156                        │
│                                       │
│ Сигнатура:                            │
│   void heap_insert(Relation relation, │
│                    HeapTuple tup,     │
│                    CommandId cid,     │
│                    ...)               │
╰───────────────────────────────────────╯

/select 01

> Что такое подсистема исполнителя (executor)?

╭─────────────── Ответ ────────────────╮
│ Подсистема исполнителя отвечает за  │
│ выполнение планов запросов,          │
│ сгенерированных планировщиком.       │
│                                      │
│ Основные компоненты:                 │
│   - ExecutorStart: Инициализация     │
│   - ExecutorRun: Основной цикл       │
│   - ExecutorEnd: Освобождение ресурсов│
│                                      │
│ Точка входа: src/backend/executor/   │
│              execMain.c              │
╰──────────────────────────────────────╯

> Каковы основные точки входа в исполнитель?

> Покажите архитектуру выполнения запросов

> Что делает ExecProcNode?
> Кто вызывает ExecutorRun?
> Объясните связь между Plan и PlanState

> Как работает выделение памяти в PostgreSQL?

╭─────────────── Ответ ────────────────╮
│ PostgreSQL использует контексты      │
│ памяти для иерархического управления│
│ памятью:                             │
│                                      │
│ Основные функции:                    │
│   palloc()  - Выделить память        │
│   pfree()   - Освободить память      │
│   MemoryContextCreate() - Новый контекст│
│   MemoryContextReset()  - Массовое освобождение│
│                                      │
│ Основные контексты:                  │
│   TopMemoryContext - Корневой контекст│
│   CurrentMemoryContext - Текущий     │
│   MessageContext - На сообщение      │
╰──────────────────────────────────────╯

> Где определена функция palloc?

╭─────────────── Ответ ────────────────╮
│ palloc определена в:                 │
│   src/backend/utils/mmgr/mcxt.c:1089 │
│                                      │
│ Сигнатура:                           │
│   void *palloc(Size size)            │
│                                      │
│ Связанные функции:                   │
│   palloc0(), palloc_extended(),      │
│   repalloc(), pfree()                │
╰──────────────────────────────────────╯

> Покажите всех вызывающих palloc

╭─────────────── Вызывающие ───────────╮
│ 1. heap_form_tuple()                 │
│ 2. ExecStoreTuple()                  │
│ 3. construct_array()                 │
│ 4. pnstrdup()                        │
│ 5. SPI_connect()                     │
│ ... (показано первые 5 из 2 847)     │
╰──────────────────────────────────────╯

> Какие функции вызывает LWLockAcquire?

> Как проходят данные от pg_parse_query до исполнителя?

╭─────────────── Поток данных ─────────╮
│ pg_parse_query()                     │
│     ↓                                │
│ pg_analyze_and_rewrite()             │
│     ↓                                │
│ pg_plan_queries()                    │
│     ↓                                │
│ PortalRun()                          │
│     ↓                                │
│ ExecutorRun()                        │
│     ↓                                │
│ ExecProcNode()                       │
╰──────────────────────────────────────╯

/select 04

> Где мне добавить новый алгоритм соединения?

╭─────────────── Ответ ────────────────╮
│ Чтобы добавить новый алгоритм:       │
│                                      │
│ 1. Определите тип узла:              │
│    src/include/nodes/plannodes.h     │
│                                      │
│ 2. Добавьте поддержку в планировщик:│
│    src/backend/optimizer/path/       │
│    joinpath.c - add_xxx_path()       │
│                                      │
│ 3. Добавьте поддержку в исполнитель:│
│    src/backend/executor/             │
│    nodeXxxjoin.c - ExecXxxJoin()     │
│                                      │
│ 4. Зарегистрируйте в execProcnode.c  │
╰──────────────────────────────────────╯

> Какие хуки существуют в исполнителе для пользовательских узлов плана?

> Покажите, как hashjoin интегрируется с планировщиком

> Что сломается, если я изменю add_path?

╭──────────── Анализ влияния ──────────╮
│ Изменение add_path() повлияет на:   │
│                                      │
│ Прямые вызывающие (47):             │
│   - add_partial_path()               │
│   - add_partial_path_precheck()      │
│   - create_seqscan_path()            │
│   - create_index_path()              │
│   ...                                │
│                                      │
│ Риск: ВЫСОКИЙ — ядро выбора путей    │
│ Рекомендация: Добавьте новую функцию │
│ вместо изменения существующей        │
╰──────────────────────────────────────╯

> Покажите зависимости create_hashjoin_path

/select 15

> Где в исполнителе используются макросы утверждений (assert)?

╭─────────────── Ответ ────────────────╮
│ Макросы утверждений в исполнителе:   │
│                                      │
│ Assert() - src/include/c.h:846       │
│ AssertArg() - Проверка аргументов    │
│ AssertState() - Проверка состояния   │
│                                      │
│ Использование в исполнителе:         │
│   execMain.c: 89 утверждений         │
│   execProcnode.c: 34 утверждения     │
│   execScan.c: 23 утверждения         │
╰──────────────────────────────────────╯

> Найдите вызовы elog в heap_insert

> Какие функции пишут в WAL?

> Отследите выполнение от INSERT до heap_insert

╭──────────── Трассировка выполнения ──╮
│ ProcessQuery()                       │
│   ↓                                  │
│ PortalRunMulti()                     │
│   ↓                                  │
│ ExecutorRun()                        │
│   ↓                                  │
│ ExecModifyTable()                    │
│   ↓                                  │
│ ExecInsert()                         │
│   ↓                                  │
│ table_tuple_insert()                 │
│   ↓                                  │
│ heap_insert()                        │
╰──────────────────────────────────────╯

> Где поставить точки останова для фиксации транзакции?

/select 05

> Найдите неиспользуемые статические функции в исполнителе

╭──────────── Неиспользуемый код ──────╮
│ Потенциально неиспользуемые функции: │
│                                      │
│ 1. execUtils.c:                      │
│    - old_get_typlenbyval() :234      │
│                                      │
│ 2. execTuples.c:                     │
│    - legacy_slot_init() :456         │
│                                      │
│ Всего: 12 кандидатов                 │
│ Подтверждено неиспользуемых: 8       │
╰──────────────────────────────────────╯

> Покажите устаревшие функции, которые всё ещё используются

> Найдите дублирующиеся шаблоны обработки ошибок

> От чего зависит ExecProcNode?

╭──────────── Зависимости ─────────────╮
│ Прямые зависимости: 47               │
│ Транзитивные зависимости: 312        │
│                                      │
│ Ключевые вызывающие:                 │
│   - ExecutorRun()                    │
│   - ExecSubPlan()                    │
│   - ExecMaterial()                   │
│   - ExecSort()                       │
│                                      │
│ Риск рефакторинга: КРИТИЧЕСКИЙ       │
│ Рекомендация: Поэтапная миграция     │
╰──────────────────────────────────────╯

> Влияние переименования heap_open в table_open

/select 07

> Какие функции не покрыты тестами?

╭─────────────── Пробелы в покрытии ─────────╮
│ Функции без прямых тестов:                │
│                                           │
│ Критические (executor):                   │
│   - ExecParallelHashJoinNewBatch()        │
│   - ExecReScanGather()                    │
│                                           │
│ Высокий приоритет (storage):              │
│   - heap_lock_updated_tuple()             │
│   - heap_abort_speculative()              │
│                                           │
│ Всего непротестированных: 234 функции     │
│ Оценка покрытия: 78%                      │
╰───────────────────────────────────────────╯

> Какие критические функции нужно протестировать в первую очередь?

> Найти непротестированные пути обработки ошибок

> Какие непротестированные функции имеют наибольшее влияние?

╭─────────────── Список приоритетов ─────────╮
│ Высокое влияние + нет тестов:              │
│                                            │
│ 1. heap_lock_updated_tuple()               │
│    Влияние: Целостность транзакций         │
│    Количество вызовов: 23                  │
│                                            │
│ 2. ExecParallelHashJoinNewBatch()          │
│    Влияние: Корректность параллельных запросов │
│    Количество вызовов: 8                   │
│                                            │
│ 3. AtEOXact_RelationCache()                │
│    Влияние: Согласованность кэша           │
│    Количество вызовов: 4                   │
╰────────────────────────────────────────────╯

> Показать точки входа без тестов

/review github 123

/review gitlab 456

/review git

/review file path/to/changes.patch

╭─────────────── Результаты ревью ────────────────────────────╮
│                                                             │
│  Оценка: 72/100         Рекомендация: REQUEST_CHANGES        │
│                                                             │
│  ══════════════════════════════════════════════════════     │
│                                                             │
│  Найденные проблемы:                                        │
│                                                             │
│  🔴 КРИТИЧЕСКИЙ  Риск SQL-инъекции                           │
│     Местоположение: src/api/user_query.c:45                 │
│     Паттерн: Ввод пользователя вставляется в запрос напрямую │
│     Исправление: Использовать параметризованные запросы     │
│                                                             │
│  🟡 СРЕДНИЙ     Сложность по Маккейбу                       │
│     Местоположение: src/parser/gram.y:1234                  │
│     Значение: 47 (порог: 10)                                │
│     Исправление: Вынести вспомогательные функции             │
│                                                             │
│  🟢 НИЗКИЙ      Отсутствует проверка на NULL                │
│     Местоположение: src/utils/string.c:89                   │
│     Исправление: Добавить проверку указателя на NULL        │
│                                                             │
╰─────────────────────────────────────────────────────────────╯

/review git --format md --inline

╭─────────────── Встроенные комментарии ───────────────────────────╮
│                                                                   │
│  src/api/user_query.c                                             │
│  ─────────────────────                                            │
│                                                                   │
│  Строка 45:                                                       │
│    sprintf(query, "SELECT * FROM users WHERE id=%s", id);         │
│    ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^│
│    🔴 SQL-инъекция: Используйте snprintf с правильным экранированием │
│                                                                   │
│  Строка 67:                                                       │
│    char *result = malloc(len);                                    │
│    ^^^^^^^^^^^^^^^^^^^^^^^^^^^                                    │
│    🟡 Память: Проверьте возвращаемое значение malloc на NULL      │
│                                                                   │
╰───────────────────────────────────────────────────────────────────╯

> Сгенерируй тестовые сценарии для heap_insert

╭─────────────── Тестовые сценарии ────────────────────────────────╮
│                                                                  │
│ Функция: heap_insert()                                           │
│ Файл: src/backend/access/heap/heapam.c:2156                      │
│                                                                  │
│ ═════════════════════════════════════════════════════════        │
│                                                                  │
│ 1. Обычная вставка                                               │
│    Входные данные: Корректная таблица, корректный кортеж,         │
│                    корректный CommandId                           │
│    Ожидаемое: Возвращён OID, кортеж виден                         │
│                                                                  │
│ 2. NULL в указателе таблицы                                      │
│    Входные данные: Указатель таблицы равен NULL                   │
│    Ожидаемое: Сбой утверждения или корректное сообщение об ошибке │
│                                                                  │
│ 3. Слишком большой кортеж                                         │
│    Входные данные: Кортеж больше BLCKSZ                          │
│    Ожидаемое: Ошибка с понятным сообщением                       │
│                                                                  │
│ 4. Параллельная вставка                                          │
│    Входные данные: Несколько потоков выполняют вставку            │
│    Ожидаемое: Все вставки успешны, без повреждений данных         │
│                                                                  │
│ 5. Откат транзакции                                              │
│    Входные данные: Вставка, за которой следует ROLLBACK           │
│    Ожидаемое: Кортеж не виден после отката                       │
│                                                                  │
│ 6. Требуется TOAST                                               │
│    Входные данные: Кортеж с большим полем varlena                │
│    Ожидаемое: TOAST-таблица заполнена корректно                  │
│                                                                  │
╰──────────────────────────────────────────────────────────────────╯

> Какие граничные случаи нужно протестировать в LWLockAcquire?

> Создай тестовые данные для сценариев фиксации транзакций

/select 02

> Найти уязвимости типа SQL-инъекция

╭─────────────── Результаты проверки безопасности ─────────────────────────╮
│                                                                           │
│  🔴 КРИТИЧЕСКИЙ: SQL-инъекция                                               │
│     ──────────────────────────────────────                                │
│                                                                           │
│     Расположение: src/pl/plpgsql/src/pl_exec.c:4567                       │
│     Паттерн: Динамический запрос с конкатенацией строк                     │
│     Код:                                                                 │
│       snprintf(query, "SELECT * FROM %s", table_name);                    │
│                                                                           │
│     Риск: Управляемое пользователем имя таблицы может внедрить SQL         │
│     Исправление: Использовать quote_identifier() для имён таблиц          │
│     CWE: CWE-89                                                           │
│                                                                           │
│  ──────────────────────────────────────────────────────────────────────── │
│                                                                           │
│     Расположение: src/backend/utils/adt/ruleutils.c:2341                  │
│     Паттерн: Строка формата с внешним вводом                              │
│     Риск: Потенциальная инъекция строки формата                           │
│     Исправление: Проверить спецификаторы формата                          │
│                                                                           │
│  Всего найдено: 7 критических, 12 высоких, 34 средних                      │
│                                                                           │
╰───────────────────────────────────────────────────────────────────────────╯

> Найти риски переполнения буфера в строковых функциях

> Показать функции, использующие sprintf без проверки границ

> Найти все внешние точки входа

╭─────────────── Точки входа ──────────────────────────────╮
│                                                           │
│  Сетевые точки входа:                                     │
│    - pq_getmsgstring()     - Чтение строки от клиента     │
│    - pq_getmsgint()        - Чтение целого от клиента     │
│    - ProcessClientRead()   - Прямое чтение из сокета      │
│                                                           │
│  Точки входа SQL:                                         │
│    - exec_simple_query()   - Прямое выполнение SQL        │
│    - exec_parse_message()  - Подготовленный оператор      │
│    - exec_bind_message()   - Привязка параметров          │
│                                                           │
│  Файловые точки входа:                                    │
│    - pg_read_file()        - Чтение произвольного файла   │
│    - pg_ls_dir()           - Просмотр содержимого папки    │
│                                                           │
│  Всего: обнаружено 47 точек входа                         │
│                                                           │
╰───────────────────────────────────────────────────────────╯

> Показать обработчики сетевого ввода

> Перечислить функции ввода пользователя

> Отследить поток данных от PQgetvalue до выполнения SQL

╭─────────────── Поток заражённых данных ────────────────────────╮
│                                                               │
│  ИСТОЧНИК: PQgetvalue() [Ввод клиента]                         │
│      ↓                                                        │
│  pq_getmsgstring()                                            │
│      ↓                                                        │
│  exec_simple_query()                                          │
│      ↓                                                        │
│  pg_parse_query()                                             │
│      ↓                                                        │
│  СТОК: SPI_execute() [Выполнение SQL]                         │
│                                                               │
│  ════════════════════════════════════════════════════         │
│                                                               │
│  Санация найдена: ДА                                           │
│  Расположение: pg_parse_query() проверяет синтаксис            │
│  НО: Не предотвращает семантическую инъекцию                   │
│                                                               │
│  Уровень риска: ВЫСОКИЙ                                        │
│  Рекомендация: Добавить проверку ввода на точке входа          │
│                                                               │
╰───────────────────────────────────────────────────────────────╯

> Достигает ли ввод пользователя strcpy без проверки?

> Показать путь от чтения из сокета до выделения памяти

> Где ввод санируется перед выполнением запроса?

╭─────────────── Точки санации данных ───────────────────────╮
│                                                           │
│  Обнаруженные средства санации:                            │
│                                                           │
│  1. quote_identifier()                                    │
│     Расположение: src/backend/utils/adt/ruleutils.c:10234 │
│     Назначение: Экранирование идентификаторов SQL         │
│     Охват: Частичный — не всегда используется             │
│                                                           │
│  2. quote_literal()                                       │
│     Расположение: src/backend/utils/adt/quote.c:45        │
│     Назначение: Экранирование литералов SQL               │
│     Охват: Хороший — широко используется                  │
│                                                           │
│  3. pg_parse_query()                                      │
│     Расположение: src/backend/tcop/postgres.c:645         │
│     Назначение: Проверка синтаксиса                       │
│     Охват: Все запросы                                    │
│                                                           │
│  Отсутствует санация в:                                   │
│    - Построение имён таблиц (12 мест)                     │
│    - Построение строк формата (5 мест)                    │
│                                                           │
╰───────────────────────────────────────────────────────────╯

> Найти все функции проверки в аутентификации

/select 02

> Выполнить проверку соответствия D3FEND

╭─────────────── Отчёт о соответствии D3FEND ─────────────────────╮
│                                                               │
│  Общий балл соответствия: 72,5%                                │
│                                                               │
│  ═══════════════════════════════════════════════════════════  │
│                                                               │
│  Найденные проблемы по методикам:                             │
│                                                               │
│  D3-VI (Инициализация переменных): 23 проблемы                │
│  ──────────────────────────────────────────────────────      │
│    - palloc без palloc0: 15 мест                              │
│    - Неинициализированные поля структур: 8 мест               │
│                                                               │
│  D3-TL (Надёжные библиотеки): 12 проблем                      │
│  ─────────────────────────────────────────────────────       │
│    🔴 использование strcpy: src/backend/utils/adt/varlena.c:234│
│    🔴 использование sprintf: src/backend/libpq/auth.c:567      │
│    🟡 использование strtok: src/backend/parser/gram.c:1234     │
│                                                               │
│  D3-NPC (Проверка на null-указатель): 8 проблем               │
│  ──────────────────────────────────────────────────────      │
│    - malloc без проверки на NULL: 5 мест                      │
│    - palloc без проверки: 3 места                             │
│                                                               │
│  D3-RN (Обнуление ссылок): 6 проблем                          │
│  ──────────────────────────────────────────────────────      │
│    - pfree без ptr = NULL: 6 мест                             │
│                                                               │
│  Баллы по категориям:                                         │
│    Инициализация: 65%                                         │
│    Безопасность памяти: 78%                                   │
│    Безопасность указателей: 82%                               │
│    Безопасность библиотек: 58%                                │
│                                                               │
╰───────────────────────────────────────────────────────────────╯

> Проверить использование небезопасных функций (D3-TL Надёжные библиотеки)

╭─────────────── D3-TL: Надёжные библиотеки ───────────────────────╮
│                                                               │
│  Найдено небезопасных функций: 47                              │
│                                                               │
│  🔴 КРИТИЧЕСКИЙ - strcpy (риск переполнения буфера):           │
│  ──────────────────────────────────────────────────────       │
│    src/backend/utils/adt/varlena.c:234                        │
│    src/backend/libpq/pqformat.c:567                           │
│    src/pl/plpgsql/src/pl_exec.c:1234                          │
│                                                               │
│  🔴 КРИТИЧЕСКИЙ - sprintf (риск строки формата):               │
│  ──────────────────────────────────────────────────────       │
│    src/backend/libpq/auth.c:567                               │
│    src/backend/utils/error/elog.c:890                         │
│                                                               │
│  🟡 ВЫСОКИЙ - gets (устарела, всегда небезопасна):             │
│  ──────────────────────────────────────────────────────       │
│    Не найдено ✓                                               │
│                                                               │
│  🟡 ВЫСОКИЙ - rand (слабый генератор случайных чисел):         │
│  ──────────────────────────────────────────────────────       │
│    src/backend/utils/misc/pg_random.c:45                      │
│                                                               │
│  Рекомендации по исправлению:                                 │
│  ──────────────────────────────                               │
│    - strcpy → strncpy/strlcpy                                 │
│    - sprintf → snprintf                                       │
│    - gets → fgets                                             │
│    - rand → pg_prng_* или arc4random                          │
│                                                               │
╰───────────────────────────────────────────────────────────────╯

> Найти уязвимости из-за отсутствия проверки null-указателя (D3-NPC)

╭─────────────── D3-NPC: Проверка на null-указатель ────────────────╮
│                                                               │
│  Отсутствие проверки NULL после выделения: 23                   │
│                                                               │
│  malloc без проверки:                                         │
│  ─────────────────────                                        │
│    src/backend/utils/mmgr/aset.c:345                          │
│      char *buf = malloc(size);                                │
│      use(buf);  // ← Нет проверки на NULL!                    │
│                                                               │
│  palloc без проверки:                                         │
│  ──────────────────────────                                   │
│    src/backend/executor/execUtils.c:234                       │
│      TupleTableSlot *slot = palloc(sizeof(...));              │
│      slot->tts_values = palloc(...);  // ← Нет проверки       │
│                                                               │
│  Примечание PostgreSQL: palloc() вызывает ERROR при нехватке памяти,│
│  но явные проверки улучшают читаемость кода.                   │
│                                                               │
│  Пример исправления:                                          │
│  ─────────────────────                                        │
│    char *buf = malloc(size);                                  │
│    if (buf == NULL) {                                         │
│        ereport(ERROR, (errcode(ERRCODE_OUT_OF_MEMORY)));      │
│    }                                                          │
│                                                               │
╰───────────────────────────────────────────────────────────────╯

> Проверить риски использования после освобождения

╭─────────────── D3-RN: Обнуление ссылок ────────────────╮
│                                                       │
│  Освобождение без обнуления: 34 места                 │
│                                                       │
│  pfree без присвоения NULL:                           │
│  ──────────────────────────────                       │
│                                                       │
│    src/backend/utils/cache/relcache.c:567             │
│    ─────────────────────────────────────              │
│      pfree(rel->rd_options);                          │
│      // rel->rd_options всё ещё указывает на освобождённую память! │
│                                                       │
│      ✓ ИСПРАВЛЕНИЕ:                                   │
│      pfree(rel->rd_options);                          │
│      rel->rd_options = NULL;                          │
│                                                       │
│    src/backend/executor/nodeHash.c:234                │
│    ─────────────────────────────────                  │
│      pfree(hashtable->buckets);                       │
│      // Риск висячего указателя в путях обработки ошибок │
│                                                       │
│  MemoryContextDelete без обнуления:                   │
│  ──────────────────────────────────────────           │
│                                                       │
│    src/backend/utils/mmgr/mcxt.c:890                  │
│      MemoryContextDelete(ctx);                        │
│      // ctx может быть использован позже!             │
│                                                       │
│  Справка CWE: CWE-416 (Использование после освобождения) │
│                                                       │
╰───────────────────────────────────────────────────────╯

> Найти неинициализированные переменные

╭─────────────── D3-VI: Инициализация переменных ───────────────╮
│                                                               │
│  Найдено неинициализированных переменных: 56                   │
│                                                               │
│  Локальные переменные без инициализации:                      │
│  ──────────────────────────────────────────────────────      │
│                                                               │
│    src/backend/executor/execMain.c:456                        │
│    ─────────────────────────────────────                      │
│      EState *estate;        // ← Неинициализирована           │
│      QueryDesc *queryDesc;  // ← Неинициализирована           │
│                                                               │
│      ✓ ИСПРАВЛЕНИЕ:                                           │
│      EState *estate =

## Сценарии для технического писателя

### Генерация документации по API

**Сценарий:** Технический писатель документирует публичное API.

#### Шаг 1: Выбор сценария документации

#### Шаг 2: Генерация документации по функциям

c                                                     │
│  void heap_insert(Relation relation,                      │
│                   HeapTuple tup,                          │
│                   CommandId cid,                          │
│                   int options,                            │
│                   BulkInsertState bistate)                │
│

                                                  │

c                                                     │
│  HeapTuple tuple = heap_form_tuple(desc, values, nulls);  │
│  heap_insert(rel, tuple, GetCurrentCommandId(true),       │
│              0, NULL);                                    │
│

                                                  │

---

### Понимание архитектуры модуля

**Сценарий:** Технический писатель документирует архитектуру системы.

---

### Создание справочника функций

**Сценарий:** Технический писатель составляет индекс функций.

#### Использование прямого SQL-запроса

## Справочник команд TUI

### Все команды

| Команда | Аргументы | Описание |
|--------|----------|--------|
| `/help` | `[команда]` | Показать справку по всем командам или по конкретной команде |
| `/scenarios` | `[группа]` | Список доступных сценариев, с опциональной фильтрацией |
| `/select` | `<номер>` | Выбрать сценарий по номеру (01–16) |
| `/history` | `[количество]` | Показать историю диалога |
| `/save` | `[имя_файла]` | Сохранить текущую сессию |
| `/load` | `<имя_файла>` | Загрузить сохранённую сессию |
| `/config` | `[раздел] [ключ] [значение]` | Просмотр или изменение конфигурации |
| `/stat` | | Показать статистику CPG и ChromaDB |
| `/query` | `<SQL>` | Выполнить SQL-запрос к базе данных CPG |
| `/review` | `[источник] [id] [--format] [--inline]` | Запустить анализ кода |
| `/demo` | `[--scenarios N,N] [--lang en\|ru]` | Запустить быстрое тестирование |
| `/clear` | | Очистить экран |
| `/exit` | | Выйти из приложения |
| `/project` | `[list\|switch\|add]` | Управление проектами CPG |

### Подробное описание команд

#### /project

Управление несколькими проектами CPG (переключение между разными кодовыми базами).

```bash
# Показать информацию о текущем проекте
/project

# Список всех доступных проектов
/project list

# Переключиться на другой проект
/project switch fsin_module
/project switch postgresql

# Добавить новый проект
/project add myproject path/to/project.duckdb python "Мой Python-проект"

projects:
  postgresql:
    db_path: "cpg.duckdb"
    language: c
    description: "Исходный код PostgreSQL 17"
  fsin_module:
    db_path: "workspace/fsin_module_v2.duckdb"
    language: python
    description: "Django-модуль FSIN"

active_project: postgresql

# Пример: переключение на проект Python/Django
/project switch fsin_module
# Вывод: Домен активирован: python_django

# Пример: возврат к проекту на C
/project switch postgresql
# Вывод: Домен активирован: postgresql

# Показать все сценарии
/scenarios

# Фильтрация по группе
/scenarios security    # Сценарии, связанные с безопасностью
/scenarios dev         # Сценарии разработки
/scenarios qa          # Сценарии обеспечения качества

# Выбор по номеру
/select 1     # Онбординг
/select 02    # Аудит безопасности
/select 15    # Отладка

# Показать все разделы конфигурации
/config

# Показать конкретный раздел
/config llm

# Установить значение
/config llm temperature 0.7
/config llm provider gigachat

# Простые запросы
/query SELECT COUNT(*) FROM nodes_method
/query SELECT name, filename FROM nodes_method WHERE name LIKE 'heap%'

# Описание таблиц
/query DESCRIBE nodes_method
/query SHOW TABLES

# Сложные запросы
/query SELECT caller.name, callee.name
       FROM edges_call e
       JOIN nodes_method caller ON e.src = caller.id
       JOIN nodes_method callee ON e.dst = callee.id
       WHERE callee.name = 'palloc'
       LIMIT 10

# Интерактивный режим (выбор источника)
/review

# GitHub PR
/review github 123
/review github 123 --format json

# GitLab MR
/review gitlab 456 --inline

# Локальные изменения в git
/review git
/review git --format yaml

# Файл патча
/review file changes.patch --format md --inline

# config.yaml
llm:
  provider: "gigachat"
  gigachat:
    credentials: ${GIGACHAT_AUTH_KEY}
    model: "GigaChat-2"  # или GigaChat-2-Pro, GigaChat-2-Max
    temperature: 0.7

# Переменная окружения
export GIGACHAT_AUTH_KEY="ваш-ключ-в-base64"

# config.yaml
llm:
  provider: "openai"
  openai:
    api_key: ${OPENAI_API_KEY}
    model: "gpt-4"
    temperature: 0.7

# Переменная окружения
export OPENAI_API_KEY="sk-..."

# config.yaml
llm:
  provider: "local"
  local:
    model_path: ${LLMXCPG_MODEL_PATH}
    n_gpu_layers: -1  # Все слои на GPU
    n_ctx: 8192

retrieval:
  embedding_model: "all-MiniLM-L6-v2"
  top_k_qa: 3       # Количество извлекаемых примеров вопросов и ответов
  max_results: 50   # Максимальное количество результатов поиска

query:
  default_limit: 100  # Значение LIMIT по умолчанию для SQL
  max_limit: 1000     # Максимально допустимое значение LIMIT

python -m src.cli.security_audit full \
  --path /path/to/django/project \
  --output-dir ./security_reports \
  --language ru

# Отчёт по безопасности: My Django Project

**Путь к проекту:** `/path/to/django/project`
**Время аудита:** 2025-12-09 20:43:19
**Проанализировано файлов:** 88

SECRET_KEY = os.environ.get('SECRET_KEY', 'insecure-fallback')

python -m src.cli.security_audit quick --path .

╭─────────────────── Результаты быстрой проверки ───────────────────╮
│                                                                 │
│  Проверено файлов: 45                                           │
│  Время: 0.3с                                                    │
│                                                                 │
│  Обнаружено:                                                    │
│    🔴 Критические: 0                                            │
│    🟠 Высокие: 2                                                │
│    🟡 Средние: 1                                                │
│                                                                 │
│  Запустите 'security-audit full', чтобы получить подробный отчёт │
│                                                                 │
╰─────────────────────────────────────────────────────────────────╯

security-audit:
  stage: test
  script:
    - pip install -r requirements.txt
    - python -m src.cli.security_audit full \
        --path . \
        --output-dir ./security_reports \
        --format json,sarif
    - |
      CRITICAL=$(jq '.summary.critical_issues' security_reports/security_report.json)
      if [ "$CRITICAL" -gt 0 ]; then
        echo "❌ Обнаружены критические уязвимости!"
        exit 1
      fi
  artifacts:
    paths:
      - security_reports/
    reports:
      sast: security_reports/security_report.sarif

from src.security.file_scanner import FileSecurityScanner
from src.security.report_generator import ReportGenerator

# Инициализация сканера
scanner = FileSecurityScanner()

# Запуск сканирования
result = scanner.scan_project('/path/to/project')

# Генерация отчёта
generator = ReportGenerator()
report = generator.create_report(
    project_name='My Project',
    project_path=result.project_path,
    scan_result=result
)

# Сохранение в нескольких форматах
output_files = generator.save_report(
    output_dir='./reports',
    formats=['markdown', 'json', 'sarif'],
    language='ru'  # Локализация на русский язык
)

print(f"Отчёт сохранён в: {output_files['markdown']}")

# Утренний анализ безопасности
/select 02
> Найти уязвимости в недавно изменённых файлах
/review git
/exit

# Еженедельный анализ качества
/select 05
> Найти неиспользуемый код, появившийся на этой неделе

/select 12
> Показать сводку по техническому долгу

/select 07
> Какие новые функции не покрыты тестами?

# Перед основным релизом
/select 08
> Сгенерировать отчёт о соответствии OWASP Top 10

/select 02
> Найти все критические уязвимости

/review git --format json > audit_report.json

# Настройка первого дня
/select 01
> Объясни общую архитектуру
> Какие основные подсистемы существуют?
> С какого места лучше начать изучение кода?

/save onboarding_session

# Через командную строку
python -m src.tui.app --theme dark

# В config.yaml
tui:
  theme: dark

/save              # Сохранить текущую сессию
/save analysis_v2  # Сохранить с указанием пользовательского имени
/load              # Вывести список сессий
/load analysis_v2  # Загрузить конкретную сессию

/select 2
Найти уязвимости к SQL-инъекциям
Найти риски командных инъекций
Найти уязвимости к XSS

/select 1
Что делает функция main?
Покажи граф вызовов для функции X

/review git
# Просмотр результатов
/save security_review_dec9

pip install chromadb
# или
pip install -r requirements.txt

bash
   python -m src.cli.import_commands full --path ./mycode

bash
   /project list

bash
   echo $GIGACHAT_CREDENTIALS
   echo $OPENAI_API_KEY

bash
   /config llm

yaml
   llm:
     local:
       n_ctx: 4096  # Уменьшить с 8192

# Установите UTF-8 в PowerShell
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8

# Или используйте Windows Terminal (рекомендуется)

python -m src.tui.app --debug