# Repo Health: examples/code-navigation https://sourcecraft.dev/examples/code-navigation | Показатель | Значение | |---|---| | **Repo Health Score** | **20.4 / 100** — Критическое состояние | | Охват данных | 82% (метрик с данными: 61.8%) | | Основной язык | Java | | Последняя активность | 09.03.2026 | | Дата анализа | 29.09.2026 15:01 UTC | | Вид анализа | полный | | Оценки сообщества | 6 реакций, топ-5% каталога | | Воспроизводимость | методика v1.6, снапшот `ce8082eb39ad` | ## Оценки по категориям | Категория | Оценка | Вес | Ключевой факт | |---|---|---|---| | Безопасность | **Нет данных** | 18% | нет прав SourceCraft на просмотр AppSec этого репозитория | | Состояние кода и техдолг | 60.0/100 | 21% | Тесты: наличие и доля тестового кода: 0% кода в тестах | | Активность проекта | 0.4/100 | 18% | Осмысленные коммиты за 90 дней: 0 шт. | | Документация и практики | 23.1/100 | 17% | Лицензия (распознанный SPDX): нет | | CI/CD | 0.0/100 | 13% | Отсутствие SourceCraft CI подтверждено: .sourcecraft/ci.yaml не найден в полном дереве файлов | | Работа с issues | 1.0/100 | 13% | Зависшие открытые issues (без обновления > 60 дней): 100% открытых | **Как получен итог.** Score = (60.0×21 + 0.4×18 + 23.1×17 + 0.0×13 + 1.0×13) / 82 = 20.4. Охват данных 82% — доля веса категорий, по которым есть данные. Категории без данных (Безопасность) исключены из расчёта, их вес перераспределён. ## Сильные стороны - **Плотность TODO/FIXME/HACK на 1000 строк кода** — 0 на 1000 строк - **Доля TODO старше 6 месяцев** — 0% - **Инструкция запуска и сборки** — да ## Слабые стороны - **Тесты: наличие и доля тестового кода** — 0% кода в тестах - **Давность последнего осмысленного коммита** — 1.0 года назад - **Осмысленные коммиты за 90 дней** — 0 шт. - **Живые авторы за год (без ботов)** — 0 чел. - **Bus factor (авторов, покрывающих 50% коммитов за год)** — 0 чел. - **README: наличие, объём и ключевые разделы** — 25% - **Лицензия (распознанный SPDX)** — нет - **CONTRIBUTING, CODEOWNERS, CHANGELOG, SECURITY.md** — 0 из 4 - **Правила ревью и политики веток** — 0 из 2 - **Есть конфигурация CI (.sourcecraft/ci.yaml)** — нет - **Зависшие открытые issues (без обновления > 60 дней)** — 100% открытых - **Медиана первого ответа или текущего ожидания** — 8731 ч ## Рекомендации ### 1. Отвечать в issues быстрее - **Приоритет:** Средний, трудоёмкость низкая, категория «Issues» - **Проблема:** Медиана до первого ответа или уже прошедшего ожидания: 8730.8 ч. - **Почему это важно:** Первый ответ в течение суток-двух удерживает контрибьюторов. - **Что сделать:** Назначьте дежурного по issues, включите уведомления, используйте шаблоны ответов. - **Ожидаемый эффект:** +6.8 к Repo Health Score - **Основание:** [issues.open](https://sourcecraft.dev/examples/code-navigation/issues), [issues.closed](https://sourcecraft.dev/examples/code-navigation/issues) ### 2. Дополнить README недостающими разделами - **Приоритет:** Средний, трудоёмкость низкая, категория «Документация» - **Проблема:** В README нет части ключевых разделов (установка, запуск, сборка, тесты, использование, лицензия). - **Почему это важно:** Неполная документация увеличивает порог входа и число вопросов в issues. - **Что сделать:** Добавьте недостающие разделы с командами в блоках кода. - **Ожидаемый эффект:** +4.8 к Repo Health Score - **Основание:** [files.readme](https://sourcecraft.dev/examples/code-navigation/-/blob/main/README.md) ### 3. Разобрать зависшие issues - **Приоритет:** Средний, трудоёмкость средняя, категория «Issues» - **Проблема:** 100% открытых issues не обновлялись больше 60 дней. - **Почему это важно:** Зависшие задачи снижают доверие: пользователи не понимают, читают ли их. - **Что сделать:** Ответьте в каждой, закройте неактуальные, остальным задайте приоритет и исполнителя. - **Ожидаемый эффект:** +6.1 к Repo Health Score - **Основание:** [issues.open](https://sourcecraft.dev/examples/code-navigation/issues) ### 4. Проект не обновлялся больше года - **Приоритет:** Высокий, трудоёмкость высокая, категория «Активность» - **Проблема:** Последний коммит был 371 дней назад. - **Почему это важно:** Без изменений проект может устаревать, а пользователям сложно понять, поддерживается ли он. - **Что сделать:** Обновите зависимости, закройте или пометьте issues, опубликуйте статус проекта в README (поддерживается / архив). - **Ожидаемый эффект:** +5.9 к Repo Health Score - **Основание:** [git.last_commit_at](https://sourcecraft.dev/examples/code-navigation/-/commits/main) ### 5. Добавить автоматические тесты - **Приоритет:** Высокий, трудоёмкость высокая, категория «Состояние кода» - **Проблема:** В репозитории не найдено тестов. - **Почему это важно:** Без тестов CI проверяет только сборку, регрессии находят пользователи. - **Что сделать:** Добавьте тесты на ключевые сценарии и запуск тестов в CI. - **Ожидаемый эффект:** +5.8 к Repo Health Score - **Основание:** [code.test_files](https://sourcecraft.dev/examples/code-navigation) ### 6. Добавить файл LICENSE - **Приоритет:** Низкий, трудоёмкость низкая, категория «Документация» - **Проблема:** В репозитории нет лицензии. - **Почему это важно:** Для открытого проекта явные условия использования упрощают повторное применение кода. - **Что сделать:** Если хотите разрешить повторное использование кода, добавьте подходящую лицензию в корень репозитория. - **Ожидаемый эффект:** +3.2 к Repo Health Score - **Основание:** [files.license](https://sourcecraft.dev/examples/code-navigation) ### 7. Подключить линтер и форматтер - **Приоритет:** Низкий, трудоёмкость низкая, категория «Состояние кода» - **Проблема:** Не найдены конфигурации линтеров и форматтеров. - **Почему это важно:** Единый стиль и статические проверки снижают шум в ревью и число мелких ошибок. - **Что сделать:** Добавьте линтер для основного языка и .editorconfig, включите проверку в CI. - **Ожидаемый эффект:** +2.6 к Repo Health Score - **Основание:** [files.tooling](https://sourcecraft.dev/examples/code-navigation) ### 8. Ввести триаж issues: метки, приоритеты, исполнители - **Приоритет:** Низкий, трудоёмкость низкая, категория «Issues» - **Проблема:** Только 7% issues имеют метки, приоритет или исполнителя. - **Почему это важно:** Без триажа невозможно понять, что важно и кто отвечает. - **Что сделать:** Заведите набор меток, проставляйте приоритет и исполнителя при разборе. - **Ожидаемый эффект:** +1.7 к Repo Health Score - **Основание:** [issues.open](https://sourcecraft.dev/examples/code-navigation/issues) ### 9. Заполнить описание репозитория - **Приоритет:** Низкий, трудоёмкость низкая, категория «Документация» - **Проблема:** Описание репозитория в SourceCraft пустое или слишком короткое. - **Почему это важно:** Описание видно в каталоге и рейтинге, по нему проект находят. - **Что сделать:** Заполните поле «Описание» в настройках репозитория одним-двумя предложениями. - **Ожидаемый эффект:** +1.6 к Repo Health Score - **Основание:** [meta.description](https://sourcecraft.dev/examples/code-navigation) ### 10. Настроить CI: добавить .sourcecraft/ci.yaml - **Приоритет:** Высокий, трудоёмкость средняя, категория «CI/CD» - **Проблема:** В репозитории нет конфигурации CI. - **Почему это важно:** Без автоматических проверок изменения не проверяются, качество зависит от дисциплины каждого автора. - **Что сделать:** Добавьте `.sourcecraft/ci.yaml` с workflow на push и pull_request: установка зависимостей, линтер, тесты. - **Уточнение:** Эффект пока нельзя оценить: после изменения нужны новые данные для сопоставимого расчёта. - **Основание:** [files.ci_config](https://sourcecraft.dev/examples/code-navigation) ## Нет данных Эти показатели не участвовали в расчёте и не подменялись нулями. Подтверждённое отсутствие компонента, например файла конфигурации CI, оценивается отдельно. | Показатель | Почему нет данных | |---|---| | Открытые уязвимости, взвешенные по критичности | нет прав SourceCraft на просмотр AppSec этого репозитория | | Доля исправленных findings за 90 дней | нет прав SourceCraft на просмотр AppSec этого репозитория | | Открытые секреты в коде | нет прав SourceCraft на просмотр AppSec этого репозитория | | Свежий скан безопасности (≤ 30 дней) | нет прав SourceCraft на просмотр AppSec этого репозитория | | Зафиксированные зависимости (lockfile) при наличии манифеста | манифест зависимостей не найден — lockfile не требуется | | Давность последнего релиза или тега | в репозитории нет релизов и тегов | | Успешные прогоны среди последних 30 (с весом по свежести) | Отсутствие SourceCraft CI подтверждено: .sourcecraft/ci.yaml не найден в полном дереве файлов | | Последний прогон успешен | Отсутствие SourceCraft CI подтверждено: .sourcecraft/ci.yaml не найден в полном дереве файлов | | Нестабильность: чередование успех/провал | Отсутствие SourceCraft CI подтверждено: .sourcecraft/ci.yaml не найден в полном дереве файлов | | Медианная длительность прогона | Отсутствие SourceCraft CI подтверждено: .sourcecraft/ci.yaml не найден в полном дереве файлов | | CI запускается на pull request | Отсутствие SourceCraft CI подтверждено: .sourcecraft/ci.yaml не найден в полном дереве файлов | | Медианное время закрытия (за 180 дней) | за 180 дней не закрыто ни одной issue | | Закрытые / созданные за 90 дней | за 90 дней не создано ни одной issue | ## Как посчитана каждая категория ### Безопасность — нет данных (вес 18%) нет прав SourceCraft на просмотр AppSec этого репозитория | Метрика | Значение | Норм. | Вес | Вклад | |---|---|---|---|---| | Открытые уязвимости, взвешенные по критичности | нет данных | — | 5 | — | | Доля исправленных findings за 90 дней | нет данных | — | 2 | — | | Открытые секреты в коде | нет данных | — | 3 | — | | Свежий скан безопасности (≤ 30 дней) | нет данных | — | 1 | — | ### Состояние кода и техдолг — 60.0/100 (вес 21%) | Метрика | Значение | Норм. | Вес | Вклад | |---|---|---|---|---| | Плотность TODO/FIXME/HACK на 1000 строк кода | 0 на 1000 строк | 100% | 3 | 30.0 | | Доля TODO старше 6 месяцев | 0% | 100% | 2 | 20.0 | | Тесты: наличие и доля тестового кода | 0% кода в тестах | 0% | 3 | 0.0 | | Зафиксированные зависимости (lockfile) при наличии манифеста | нет данных | — | 1 | — | | Доля крупных и бинарных файлов | 0% | 100% | 1 | 10.0 | | Линтеры, форматтеры, editorconfig | 0 инструментов | 0% | 1 | 0.0 | ### Активность проекта — 0.4/100 (вес 18%) | Метрика | Значение | Норм. | Вес | Вклад | |---|---|---|---|---| | Давность последнего осмысленного коммита | 1.0 года назад | 2% | 3 | 0.44 | | Осмысленные коммиты за 90 дней | 0 шт. | 0% | 2 | 0.0 | | Живые авторы за год (без ботов) | 0 чел. | 0% | 2 | 0.0 | | Bus factor (авторов, покрывающих 50% коммитов за год) | 0 чел. | 0% | 2 | 0.0 | | Влитые PR за 90 дней | 0 шт. | 0% | 1 | 0.0 | | Разных авторов влитых PR за год | 0 чел. | 0% | 1 | 0.0 | | Давность последнего релиза или тега | нет данных | — | 1 | — | Ограничения категории: Нет коммитов больше года → не выше 20 (не повлияло) ### Документация и практики — 23.1/100 (вес 17%) | Метрика | Значение | Норм. | Вес | Вклад | |---|---|---|---|---| | README: наличие, объём и ключевые разделы | 25% | 25% | 4 | 7.69 | | Лицензия (распознанный SPDX) | нет | 0% | 2 | 0.0 | | CONTRIBUTING, CODEOWNERS, CHANGELOG, SECURITY.md | 0 из 4 | 0% | 2 | 0.0 | | Описание репозитория заполнено в SourceCraft | нет | 0% | 1 | 0.0 | | Правила ревью и политики веток | 0 из 2 | 0% | 2 | 0.0 | | Инструкция запуска и сборки | да | 100% | 2 | 15.38 | ### CI/CD — 0.0/100 (вес 13%) | Метрика | Значение | Норм. | Вес | Вклад | |---|---|---|---|---| | Есть конфигурация CI (.sourcecraft/ci.yaml) | нет | 0% | 3 | 0.0 | | Успешные прогоны среди последних 30 (с весом по свежести) | нет данных | — | 4 | — | | Последний прогон успешен | нет данных | — | 2 | — | | Нестабильность: чередование успех/провал | нет данных | — | 2 | — | | Медианная длительность прогона | нет данных | — | 1 | — | | CI запускается на pull request | нет данных | — | 1 | — | ### Работа с issues — 1.0/100 (вес 13%) | Метрика | Значение | Норм. | Вес | Вклад | |---|---|---|---|---| | Зависшие открытые issues (без обновления > 60 дней) | 100% открытых | 0% | 3 | 0.0 | | Медиана первого ответа или текущего ожидания | 8731 ч | 0% | 3 | 0.0 | | Медианное время закрытия (за 180 дней) | нет данных | — | 2 | — | | Закрытые / созданные за 90 дней | нет данных | — | 2 | — | | Использование меток, приоритетов, исполнителей | 7% issues | 7% | 1 | 0.96 | ## Подтверждающие факты | Факт | Значение | Источник | |---|---|---| | `meta.description` | | [meta](https://sourcecraft.dev/examples/code-navigation) | | `issues.open` | 15 | [issues](https://sourcecraft.dev/examples/code-navigation/issues) | | `issues.closed` | 0 | [issues](https://sourcecraft.dev/examples/code-navigation/issues) | | `pulls.total_seen` | 2 | [pulls](https://sourcecraft.dev/examples/code-navigation/pulls) | | `pulls.by_status` | {"open": 2} | [pulls](https://sourcecraft.dev/examples/code-navigation/pulls) | | `releases.count` | 0 | [releases](https://sourcecraft.dev/examples/code-navigation/releases) | | `tags.count` | 0 | [releases](https://sourcecraft.dev/examples/code-navigation/tags) | | `tree.files` | 8 | [tree](https://sourcecraft.dev/examples/code-navigation) | | `tree.sourcecraft_files` | [] | [tree](https://sourcecraft.dev/examples/code-navigation/.sourcecraft) | | `files.readme` | {"length": 222, "present": true, "sections": ["description"]} | [files](https://sourcecraft.dev/examples/code-navigation/-/blob/main/README.md) | | `files.license` | {"spdx": null, "present": false} | [files](https://sourcecraft.dev/examples/code-navigation) | | `files.ci_config` | нет | [files](https://sourcecraft.dev/examples/code-navigation) | | `files.practices` | {"changelog": false, "codeowners": false, "security_md": false, "contributing": false, "b… | [files](https://sourcecraft.dev/examples/code-navigation) | | `files.dependencies` | {"unlocked": [], "lockfiles": [], "manifests": []} | [files](https://sourcecraft.dev/examples/code-navigation) | | `files.tooling` | {"linters": [], "editorconfig": false} | [files](https://sourcecraft.dev/examples/code-navigation) | | `git.last_commit_at` | 2025-09-22T18:24:35+03:00 | [git](https://sourcecraft.dev/examples/code-navigation/-/commits/main) | | `git.meaningful_commits_90d` | 0 | [git](https://sourcecraft.dev/examples/code-navigation/-/commits/main) | | `git.human_authors_365d` | 0 | [git](https://sourcecraft.dev/examples/code-navigation) | | `git.activity_authenticity` | 1.0 | [git](https://sourcecraft.dev/examples/code-navigation) | | `code.todo_total` | 0 | [code](https://sourcecraft.dev/examples/code-navigation) | | `code.test_files` | 0 | [code](https://sourcecraft.dev/examples/code-navigation) | | `code.lines` | 294 | [code](https://sourcecraft.dev/examples/code-navigation) | | `metric.docs.description` | {"result": false, "saved_inputs": {"description": ""}} | [Данные на дату анализа · Описание проекта](https://sourcecraft.dev/examples/code-navigation) | | `metric.docs.run_instructions` | {"result": true, "saved_inputs": {"run_instructions": true, "inventory_complete": true}} | [Данные на дату анализа · Файлы](https://sourcecraft.dev/examples/code-navigation/-/tree/main) | | `metric.issues.triage_usage` | {"result": 0.067, "saved_inputs": {"total_seen": 15, "items": {"count": 15, "sample": [{"… | [Данные на дату анализа · Задачи](https://sourcecraft.dev/examples/code-navigation/issues) | | `metric.activity.pr_authors_365d` | {"result": 0, "saved_inputs": {"by_status": {"open": 2}, "items": {"count": 2, "sample": … | [Данные на дату анализа · Pull requests](https://sourcecraft.dev/examples/code-navigation/pulls) | | `metric.code.heavy_files_share` | {"result": 0.0, "saved_inputs": {"large_files": 0, "binary_files": 0, "files_scanned": 8,… | [Данные на дату анализа · Код](https://sourcecraft.dev/examples/code-navigation/-/tree/main) | | `metric.code.quality_tooling` | {"result": 0, "saved_inputs": {"linters": {"count": 0, "sample": []}, "editorconfig": fal… | [Данные на дату анализа · Файлы](https://sourcecraft.dev/examples/code-navigation/-/tree/main) | ## Сбор данных | Источник | Статус | Комментарий | |---|---|---| | Issues | собрано | | | Pull requests | собрано | | | CI/CD | нет доступа | запуски CI видны только участникам репозитория; учтены конфиг и merge-checks PR | | Релизы и теги | нет таких данных | нет релизов и тегов | | Дерево файлов | собрано | | | Ключевые файлы | собрано | git | | История git | собрано | | | Содержимое кода | собрано | просканировано 8 файлов | | AppSec SourceCraft | нет доступа | нет прав SourceCraft на просмотр AppSec этого репозитория | --- Отчёт сформирован сервисом SourceCraft Repo Health 29.09.2026 15:45 UTC. Описание методики: `docs/methodology.md`.