# Repo Health: code-navigation-demo/audioread

- Репозиторий: https://sourcecraft.dev/code-navigation-demo/audioread
- Язык: Python
- Дата анализа: 13.10.2026 13:37

## Итоговый Score

**52/100**

## Категории

- **Документация:** 35/100
- **CI/CD:** 0/100
- **Безопасность:** Нет данных (Ответ 404 для https://appsec.sourcecraft.tech/v1/scans/latest)
- **Активность:** 55/100
- **Issues:** 36/100
- **Состояние кода:** 80/100


Категории без данных не обнуляют итог: их вес перераспределяется между категориями, где балл есть.



## Рекомендации

- **[критическая]** 34 задач не обновлялись более 30 дней (Issues)
  - Из 34 открытых issues 34 (100%) не получали обновлений более 30 дней.
  - Действие: Разберите зависшие issues: закройте неактуальные, назначьте ответственных на остальные и настройте автоматическую пометку stale через bot/CI.
  - Ожидаемый прирост Repo Health Score: +8

- **[высокая]** Нет конфигурации SourceCraft CI (CI/CD)
  - В дереве репозитория не найден .sourcecraft/ci.yaml.
  - Действие: Добавьте .sourcecraft/ci.yaml с базовой проверкой сборки.
  - Ожидаемый прирост Repo Health Score: +7

- **[высокая]** Нет инструкций по сборке и тестам (Документация)
  - В README не описано, как собрать проект и запустить тесты.
  - Действие: Добавьте разделы Build и Test с командами и необходимыми зависимостями.
  - Ожидаемый прирост Repo Health Score: +2

- **[средняя]** Мало merge requests за последние 30 дней (Активность)
  - Подметрика «Merge requests» — 0 из 100. Полный балл — от 10 merge requests.
  - Действие: Проверьте, что изменения проходят через merge requests, а не только прямыми коммитами.
  - Ожидаемый прирост Repo Health Score: +6

- **[средняя]** Мало релизов за последние 30 дней (Активность)
  - Подметрика «Релизы» — 0 из 100. Полный балл — от 3 релизов за 30 дней.
  - Действие: Выпустите релиз или опишите, почему проект их не использует — балл считает отсутствие релизов недобором.
  - Ожидаемый прирост Repo Health Score: +5

- **[средняя]** Нет конфигурации линтера/форматтера (Состояние кода)
  - В репозитории не найдено конфигов известных линтеров/форматтеров (ESLint, Ruff/Flake8, Prettier, rustfmt и т.п.).
  - Действие: Подключите линтер и форматтер под используемый стек и зафиксируйте правила в конфиге.
  - Ожидаемый прирост Repo Health Score: +5

- **[средняя]** Нет CHANGELOG и каталога docs/ (Документация)
  - Не найдены CHANGELOG и каталог docs/ — история изменений и подробная документация отсутствуют.
  - Действие: Заведите CHANGELOG.md и каталог docs/ для пользовательской и разработческой документации.
  - Ожидаемый прирост Repo Health Score: +4

- **[средняя]** Нет CONTRIBUTING и CODEOWNERS (Документация)
  - Не найдены файлы CONTRIBUTING и CODEOWNERS — внешним контрибьюторам неясен процесс.
  - Действие: Добавьте CONTRIBUTING.md с процессом PR и CODEOWNERS для автоназначения ревьюеров.
  - Ожидаемый прирост Repo Health Score: +4

- **[средняя]** README неполный (Документация)
  - README есть, но «README» — 50 из 100: не хватает объёма или раздела о структуре.
  - Действие: Допишите README: зачем проект и из чего состоит репозиторий.
  - Ожидаемый прирост Repo Health Score: +3

- **[средняя]** Тип лицензии не распознан (Документация)
  - Файл лицензии есть, но его тип не удалось автоматически распознать (MIT/Apache-2.0/GPL/BSD).
  - Действие: Используйте стандартный текст лицензии без существенных правок.
  - Ожидаемый прирост Repo Health Score: +2

- **[низкая]** Накопленные TODO/FIXME (Состояние кода)
  - Найдено 1 TODO/FIXME/HACK/XXX (в 11 проверенных файлах), из них 1 старше 180 дней.
  - Действие: Проревизируйте старые TODO/FIXME: часть закройте, часть переведите в issues с владельцем.
  - Ожидаемый прирост Repo Health Score: +2