Публічний реєстр
Звіт про здоров'я програмного забезпеченнясхема 0.11.0 · метрики 2.10.0 · 2026-07-16 21:39 UTC

AlmanacCode / codealmanac

A codebase wiki for AI coding agents. Captures what the code can't say: decisions, flows, invariants, gotchas.

TypeScript · PythonApache-2.0★ 482 зірки⑂ 41 форкз квіт. 2026 р.Переглянути на GitHub ↗
ТипБібліотекаМережевий сервісяк це визначено

AlmanacCode/codealmanac має індекс здоров’я 71 зі 100, що відповідає смузі «Добрий». Найвищий показник — Vitality (83/100), найнижчий — Security (34/100). Останнє оновлення — сьогодні. Більшість нещодавньої роботи виконує один учасник.

71
загалом / 100
Добрий

Індекс здоров'я програмного забезпечення

Метрики згруповано у зважені категорії на шкалі 1–100. Загальна оцінка починається як їхнє зважене середнє, відкаліброване за розподілом публічного реєстру, тож діапазони мають перцентильний зміст; коли публічні дані активують Політику юрисдикцій високого ризику, рейтинг коригується й отримує верхню межу 34 («У зоні ризику»).

71
Винятковий93-100Верхній щабель реєстру (≈ топ-5%); відповідає практично всім перевіреним критеріям
Відмінний80-92Сильний за всіма напрямами; незначні прогалини
Добрий65-79Здоровий; прогалини обмежені та керовані
Помірний50-64Прийнятний, але з помітними прогалинами; рекомендовано перевірку
Слабкий35-49Суттєві недоліки в кількох сферах
У зоні ризику20-34Суттєві слабкі місця; впровадження потребує обережності
Критичний1-19Серйозні проблеми (покинутий, єдиний мейнтейнер, без базової гігієни)
ЖиттєздатністьСпільнота тавпровадженняСталість таврядуванняІнженернаякістьБезпекаГотовність доШІ

Профіль оцінок

Кожна вісь — окрема категорія. Форма важить більше, ніж середнє: здоровий об'єкт заповнює всю фігуру, тоді як профіль із піками та провалами означає, що сила в одному вимірі маскує ризик в іншому.

Зважений загальний бал 63 калібровано до 71 за шкалою опублікованого індексу (калібрування реєстру 2026-08-02).

Власність

AlmanacОрганізація
3 підписники4 публічні репозиторіїз лют. 2026 р.

За цим репозиторієм стоїть організація — спільна, підзвітна опіка, здатна пережити будь-якого окремого мейнтейнера.

Пакетні екосистеми

РеєстрПакетВерсіяЗавантажень / місВерсіїОстання публікаціяТеги
PyPIcodealmanac0.4.74 532330 днів томуagentscodebasedocumentationwiki

Метрики за категоріями

Життєздатність

Чи живий проєкт — чи пишеться код і чи виходять релізи?

83Відмінний · 21% загального індексу
Як обчислюється оцінка
36/36Свіжість pushостанній push 0 дн. тому
8.3/36Ритм комітів12/52 тижнів із комітами
18/18Обсяг комітів807 комітів за останній рік
10/10OpenSSF Scorecard: Maintained30 commit(s) and 8 issue activity found in the last 90 days -- score normalized to 10
Використані вхідні дані
commits_last_year807
human_commit_share
days_since_last_push0
active_weeks_last_year12
Як обчислюється оцінка
27/27Випускає релізиопубліковано 4 релізів
36/36Свіжість релізівостанній реліз 5 дн. тому
27/27Ритм релізівреліз кожні ~0,2 дн.
0/10OpenSSF Scorecard: Signed-Releasesнемає даних
Використані вхідні дані
releases_count4
latest_release_tagv0.4.4
releases_from_tagsні
days_since_latest_release5
mean_days_between_releases0,2
Виключено з оцінювання (немає даних або не застосовно): OpenSSF Scorecard: Signed-Releases. Залишкові ваги перенормовано.

Спільнота та впровадження

Чи має проєкт користувачів, завантаження, увагу та влаштовані умови для контриб’юторів?

67Добрий · 17% загального індексу
Як обчислюється оцінка
43.5/60Зірки482 зірок
13.4/25Форки41 форків
3.9/15Спостерігачі6 спостерігачів
Використані вхідні дані
forks41
stars482
watchers6
growth_stateunverified
growth_factor_pct100
growth_unverified_reasonno_history
Як обчислюється оцінка
22.5/22.5README
22.5/22.5Ліцензіявизнана ліцензія (Apache-2.0)
18/18Настанови CONTRIBUTING
0/13.5Кодекс поведінки
0/7.2Шаблон issue
6.3/6.3Шаблон PR
Використані вхідні дані
has_readmeтак
has_licenseтак
readme_badges
has_contributingтак
has_issue_templateні
has_code_of_conductні
readme_badge_services
has_pull_request_templateтак
Як обчислюється оцінка
48.8/80Щомісячні завантаження4 532 завантажень/місяць у pypi
0/20Залежні пакети в реєстріця екосистема цього не повідомляє
Використані вхідні дані
packagescodealmanac
dependents
ecosystemspypi
total_downloads
monthly_downloads4 532
unverified_packages_excluded
Виключено з оцінювання (немає даних або не застосовно): Залежні пакети в реєстрі. Залишкові ваги перенормовано.

Сталість та врядування

Чи переживе проєкт своїх людей — бас-фактор, реактивність, хто за ним стоїть і як супроводжуються пакети?

49Слабкий · 23% загального індексу
Як обчислюється оцінка
9/54Бас-факторна 1 контриб’ютор(ів) припадає половина всіх комітів
5.3/22.5Розподіл комітівголовний контриб’ютор — автор 76% комітів
6.8/13.5Широта контриб’юторів5 контриб’юторів
6/10OpenSSF Scorecard: Contributorsproject has 2 contributing companies or organizations -- score normalized to 6
Використані вхідні дані
bus_factor1
contributors_sampled5
top_contributor_share0,763
Як обчислюється оцінка
17.5/42Вирішення issueзакрито 42% issue
8.6/30Прийняття PRзлито 2/7 вирішених PR
0/13Newcomer PR acceptanceза 30 дн. не вирішено жодного PR від новачка
1.5/15OpenSSF Scorecard: Code-ReviewFound 1/9 approved changesets -- score normalized to 1
Використані вхідні дані
merged_prs2
open_issues7
closed_issues5
prs_merged_7d
prs_decided_7d
prs_merged_30d
prs_decided_30d
issue_closed_ratio0,417
closed_unmerged_prs5
first_time_authors_30d
first_time_prs_merged_30d
first_time_prs_decided_30d
Виключено з оцінювання (немає даних або не застосовно): Newcomer PR acceptance. Залишкові ваги перенормовано.
Як обчислюється оцінка
30/30Підтримка власникау власності організації
0/20Верифікований доменстатус підтвердженого домену для цієї організації не зчитано
4.3/25Охоплення власника3 підписників у AlmanacCode
5.8/25Послужний список4 публічних репозиторіїв, вік облікового запису ~0 р.
Використані вхідні дані
followers3
owner_typeOrganization
is_verified
owner_loginAlmanacCode
public_repos4
account_age_days138
Виключено з оцінювання (немає даних або не застосовно): Верифікований домен. Залишкові ваги перенормовано.

Супровід пакетів

100Винятковий
Як обчислюється оцінка
25/25Опубліковано й доступно1 пакет(ів) у pypi
35/35Свіжість публікаційостання публікація 0 дн. тому
20/20Історія версій33 опублікованих версій
20/20Не застарілийактивний, не deprecated і не yanked
Використані вхідні дані
packagescodealmanac
ecosystemspypi
any_deprecatedні
min_days_since_publish0

Інженерна якість

Чи наявні базові інженерні практики та документація?

75Добрий · 19% загального індексу
Як обчислюється оцінка
24/24Процеси CI3 процес(ів) CI
24/24Наявні тести
0/16Конфігурація лінтера
0/9.6Pre-commit-хуки
0/6.4.editorconfig
10/20OpenSSF Scorecard: CI-Tests1 out of 2 merged PRs checked by a CI test -- score normalized to 5
Використані вхідні дані
has_ciтак
has_testsтак
has_editorconfigні
has_linter_configні
has_precommit_configні

Документація

100Винятковий
Як обчислюється оцінка
30/30README
25/25Каталог документації
15/15Сайт документації / домашня сторінкаhttps://codealmanac.com
10/10Опис репозиторію
10/10Теми11 тем
10/10Wiki
Використані вхідні дані
topicsai, claude, cli, codebase, codex, coding-agents, developer-tools, documentation, knowledge-base, typescript, wiki
has_wikiтак
homepagehttps://codealmanac.com
docs_sitehttps://codealmanac.com
has_readmeтак
has_docs_dirтак
has_descriptionтак

Безпека

Чи міцні видимі практики безпеки й ланцюга постачання, без непослабленої пов’язаності з юрисдикціями високого ризику?

34У зоні ризику · 16% загального індексу

Стан безпеки

34У зоні ризику
Як обчислюється оцінка
7.5/7.5Binary-Artifactsno binaries found in the repo
0/7.5Branch-Protectionbranch protection not enabled on development/release branches
1.2/2.5CI-Tests1 out of 2 merged PRs checked by a CI test -- score normalized to 5
0/2.5CII-Best-Practicesno effort to earn an OpenSSF best practices badge detected
0.8/7.5Code-ReviewFound 1/9 approved changesets -- score normalized to 1
1.5/2.5Contributorsproject has 2 contributing companies or organizations -- score normalized to 6
10/10Dangerous-Workflowno dangerous workflow patterns detected
0/7.5Dependency-Update-Toolno update tool detected
0/5Fuzzingproject is not fuzzed
2.5/2.5Ліцензіяlicense file detected
7.5/7.5Maintained30 commit(s) and 8 issue activity found in the last 90 days -- score normalized to 10
0/5Packagingнемає даних
0/5Pinned-Dependenciesdependency not pinned by hash detected -- score normalized to 0
0/5SASTSAST tool is not run on all commits -- score normalized to 0
0/5Security-Policysecurity policy file not detected
0/7.5Signed-Releasesнемає даних
0/7.5Token-Permissionsdetected GitHub workflow tokens with excessive permissions
0/7.5Vulnerabilities26 existing vulnerabilities detected
Використані вхідні дані
sourceopenssf_scorecard
checks_evaluated16
scorecard_versionv5.5.0
checks_inconclusive2
scorecard_aggregate3,4
Виключено з оцінювання (немає даних або не застосовно): Packaging, Signed-Releases. Залишкові ваги перенормовано.

Готовність до ШІ

Наскільки репозиторій оснащений для розробки та супроводу за участі ШІ-агентів? Має свідомо малу вагу (4%): агентний інструментарій — реальний сигнал супроводу, але репозиторій без нього все одно може отримати 100/100.

73Добрий · 4% загального індексу
Як обчислюється оцінка
45/45Інструкції для агентівAGENTS.md, CLAUDE.md
0/15Машиночитана документація (llms.txt)
0/40Читабельна історія комітівнемає даних
Використані вхідні дані
has_llms_txtні
llms_txt_url
legible_history_share
agent_instruction_filesAGENTS.md, CLAUDE.md
agent_instruction_max_bytes15 847
Виключено з оцінювання (немає даних або не застосовно): Читабельна історія комітів. Залишкові ваги перенормовано.
Як обчислюється оцінка
18/18Розгортання однією командоюarchive/code/Makefile
22/22Автоматизовані тести
0/11Конфігурація лінтера / форматера
11/11Статична перевірка типівarchive/code/tsconfig.json
10/10Відтворюване середовищеlockfile
0/10Підтверджена практика роботи з агентаминемає даних
0/8Автоматизоване супроводженнянемає даних
0/10OpenSSF Scorecard: Pinned-Dependenciesdependency not pinned by hash detected -- score normalized to 0
Використані вхідні дані
has_nixні
has_testsтак
lockfilespackage-lock.json, uv.lock
has_dockerfileні
typed_languageтак
bootstrap_filesarchive/code/Makefile
has_devcontainerні
has_linter_configні
typecheck_configsarchive/code/tsconfig.json
agent_commit_share
toolchain_manifests
dependency_bot_commit_share
Виключено з оцінювання (немає даних або не застосовно): Підтверджена практика роботи з агентами, Автоматизоване супроводження. Залишкові ваги перенормовано.
Як обчислюється оцінка
45/45Типізований кодTypeScript (статично типізована)
54.8/55Керовані розміри файлів2/705 файлів вихідного коду понад 60 КБ
Використані вхідні дані
primary_languageTypeScript
largest_source_bytes67 584
source_files_sampled705
oversized_source_files2
Як обчислюється оцінка
0/40Схема API (OpenAPI/GraphQL/proto)
0/20Сервер MCP
40/40Придатні до запуску прикладиexamples
Використані вхідні дані
example_dirsexamples
has_mcp_signalні
api_schema_files
interfaces_expected_ofnetwork-service

Ключові факти

482зірок GitHub
5контриб'юторів
807комітів за останні 12 місяців
0днів від останнього пушу
4релізів
1бас-фактор
7відкритих issue
PyPIпакетних екосистем

Попередження щодо збору даних

  • GitHub dependency-graph SBOM unavailable (404); the dependency graph may be disabled for this repository

Докладніше

OpenSSF Scorecard 3.4 / 10
3.4сукупно

Незалежна, не прив'язана до інструментів оцінка безпеки від відкритого проєкту OpenSSF Scorecard. Кожна перевірка винагороджує практику безпеки, а не інструмент конкретного постачальника. Перевірки, які Scorecard не зміг визначити, позначено н/д і виключено з оцінки безпеки (вони ніколи не зараховуються як нуль).Scorecard v5.5.0 · 2026-07-16 21:38 UTC

10Binary-Artifactsno binaries found in the repo
0Branch-Protectionbranch protection not enabled on development/release branches
5CI-Tests1 out of 2 merged PRs checked by a CI test -- score normalized to 5
0CII-Best-Practicesno effort to earn an OpenSSF best practices badge detected
1Code-ReviewFound 1/9 approved changesets -- score normalized to 1
6Contributorsproject has 2 contributing companies or organizations -- score normalized to 6
10Dangerous-Workflowno dangerous workflow patterns detected
0Dependency-Update-Toolno update tool detected
0Fuzzingproject is not fuzzed
10Licenselicense file detected
10Maintained30 commit(s) and 8 issue activity found in the last 90 days -- score normalized to 10
н/дPackagingpackaging workflow not detected
0Pinned-Dependenciesdependency not pinned by hash detected -- score normalized to 0
0SASTSAST tool is not run on all commits -- score normalized to 0
0Security-Policysecurity policy file not detected
н/дSigned-Releasesno releases found
0Token-Permissionsdetected GitHub workflow tokens with excessive permissions
0Vulnerabilities26 existing vulnerabilities detected
Прямі залежності 18
РеєстрПакетОбмеження версіїМаніфест
PyPIalmanac-yoke>=0.1.7,<0.2pyproject.toml
PyPIbeautifulsoup4>=4.15.0pyproject.toml
PyPIcharset-normalizer>=3.4.7pyproject.toml
PyPIfastapi>=0.138.1pyproject.toml
PyPIfilelock>=3.12.0pyproject.toml
PyPIhttpx>=0.28.1pyproject.toml
PyPIhumanfriendly>=10.0pyproject.toml
PyPIjsonlines>=4.0pyproject.toml
PyPImarkdown-it-py>=4.2.0pyproject.toml
PyPIpathspec>=1.1.1pyproject.toml
PyPIposthog>=7,<8pyproject.toml
PyPIpsutil>=7.2.2pyproject.toml
PyPIpydantic>=2.8pyproject.toml
PyPIpydantic-settings>=2.12.0pyproject.toml
PyPIpython-frontmatter>=1.3.0pyproject.toml
PyPIpyyaml>=6.0pyproject.toml
PyPIruamel-yaml>=0.19.1pyproject.toml
PyPIuvicorn>=0.49.0pyproject.toml
Усі залежності не зібрано

Не вдалося зібрати розв'язаний набір залежностей для цього звіту: GitHub dependency-graph SBOM unavailable (404); the dependency graph may be disabled for this repository

Звіт у форматі JSON машиночитний

Зворотний зв’язок

Помітили щось хибне у цьому звіті або маєте чим поділитися? Неправильні вимірювання, непомічені інструменти, ідеї, запитання — усе доречно. Кожне повідомлення читається й отримує відповідь.

Повідомлення збережеться під час входу.

Оцінки — це сигнали, а не гарантії. Вони відображають публічно видимі практики на GitHub — це не аудит коду й не гарантія безпеки.

Відсутні дані виключаються, а ваги перенормовуються — нуль за відсутність ніколи не ставиться. Методологія версіонована й відкрита: метрики v2.10.0, схема v0.11.0 — повна методологія · вікі метрик.

Як окремий результат виглядає на тлі всього реєстру: сукупна статистикаPyPI.