Публічний реєстр
Звіт про здоров'я програмного забезпеченнясхема 0.34.0 · метрики 2.10.0 · 2026-10-12 08:55 UTC

Adeniyikayodee / ng-postcode

Validate Nigerian postcodes in Rust, Python, JavaScript, Java, PostgreSQL, DuckDB, and Polars, with MCP servers for AI agents. Covers Nigeria's NIPOST digital postcode (NDAPS): offline validation, lookup, and reverse geocoding.

Python · Rust · JavaMIT★ 4 зірки⑂ 1 форкз жовт. 2026 р.Переглянути на GitHub ↗
ТипБібліотекаMCP-серверІнструмент командного рядкаяк це визначено
#address#address-validation#geocoding#nigeria#nipost#postal-code#postcode#reverse-geocoding#rust#ndaps#ai-agents#mcp#mcp-server#javascript#python#typescript#java#duckdb#polars#postgresql

Adeniyikayodee/ng-postcode має індекс здоров’я 71 зі 100, що відповідає смузі «Добрий». Найвищий показник — Engineering Quality (90/100), найнижчий — Community & Adoption (44/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).

Власність

Kayode AdeniyiОсобистий обліковий запис
16 підписників60 публічних репозиторіївз лист. 2018 р.

Цей репозиторій належить особистому обліковому запису. Проєкт з єдиним власником несе більший ризик безперервності, ніж підтримуваний організацією.

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

РеєстрПакетВерсіяЗавантажень / місВерсіїОстання публікаціяТеги
crates.iong-postcode0.5.493150 днів томуndapsnigerianipostpostal-codepostcodeapi-bindingsvalue-formattingparser-implementations
PyPIng-postcode-mcp0.6.17 281160 днів томуaddress-validationai-agentsgeocodingmcpmcp-servermodel-context-protocolndapsnigerianigeriannipostpostal-codepostcode
PyPIng-address-resolver0.1.880290 днів томуaddressaddress-parserai-agentsclaudegeocodingndapsnigerianipostpostcode
PyPIng-postcode0.3.4846110 днів томуaddressaddress-validationgeocodingndapsnigerianigeriannipostpostal-codepostcodevalidationvalidatorzip-code

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

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

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

69Добрий · 21% загального індексу

Активність розробки

55Помірний
Як обчислюється оцінка
36/36Свіжість push — останній push 0 дн. тому
1.4/36Ритм комітів — 2/52 тижнів із комітами
18/18Обсяг комітів — 319 комітів за останній рік
0/10OpenSSF Scorecard: Maintained — project was created within the last 90 days. Please review its contents carefully
Використані вхідні дані
commits_last_year319
human_commit_share0,93
days_since_last_push0
active_weeks_last_year2

Дисципліна релізів

90Відмінний
Як обчислюється оцінка
27/27Випускає релізи — опубліковано 6 релізів
36/36Свіжість релізів — останній реліз 0 дн. тому
27/27Ритм релізів — реліз кожні ~1,6 дн.
0/10OpenSSF Scorecard: Signed-Releases — Project has not signed or included provenance with any releases.
Використані вхідні дані
releases_count6
latest_release_tagmcp-v0.6.1
releases_from_tagsні
days_since_latest_release0
mean_days_between_releases1,6

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

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

44Слабкий · 17% загального індексу

Популярність і впровадження

8Критичний
Як обчислюється оцінка
7.7/60Зірки — 4 зірок
0/25Форки — 1 форків
0/15Спостерігачі — 0 спостерігачів
Використані вхідні дані
forks1
stars4
watchers0
growth_stateunverified
growth_factor_pct100
growth_unverified_reasonno_history

Здоров'я спільноти

70Добрий
Як обчислюється оцінка
22.5/22.5README
22.5/22.5Ліцензія — визнана ліцензія (MIT)
18/18Настанови CONTRIBUTING
0/13.5Кодекс поведінки
0/7.2Шаблон issue
0/6.3Шаблон PR
Використані вхідні дані
has_readmeтак
has_licenseтак
readme_badges6
has_contributingтак
has_issue_templateні
has_code_of_conductні
readme_badge_servicesgithub.com, shields.io
has_pull_request_templateні

Впровадження в екосистемі (завантаження)

66Добрий
Як обчислюється оцінка
52.7/80Щомісячні завантаження — 9 022 завантажень/місяць у crates, pypi
0/20Залежні пакети в реєстрі — ця екосистема цього не повідомляє
Використані вхідні дані
packagesng-postcode, ng-postcode-mcp, ng-address-resolver, ng-postcode
dependents—
ecosystemscrates, pypi
total_downloads280
monthly_downloads9 022
unverified_packages_excluded—
Виключено з оцінювання (немає даних або не застосовно): Залежні пакети в реєстрі. Залишкові ваги перенормовано.

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

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

53Помірний · 23% загального індексу

Стійкість мейнтейнерів (бас-фактор)

10Критичний
Як обчислюється оцінка
9/54Бас-фактор — на 1 контриб’ютор(ів) припадає половина всіх комітів
0/22.5Розподіл комітів — головний контриб’ютор — автор 100% комітів
1.4/13.5Широта контриб’юторів — 1 контриб’юторів
0/10OpenSSF Scorecard: Contributors — project has 0 contributing companies or organizations -- score normalized to 0
Використані вхідні дані
bus_factor1
contributors_sampled1
top_contributor_share1

Реактивність на issue та PR

65Добрий
Як обчислюється оцінка
0/42Вирішення issue — немає issue або даних
29.4/30Прийняття PR — злито 95/97 вирішених PR
0/13Newcomer PR acceptance — за 30 дн. не вирішено жодного PR від новачка
0/15OpenSSF Scorecard: Code-Review — Found 0/11 approved changesets -- score normalized to 0
Використані вхідні дані
merged_prs95
open_issues0
closed_issues0
prs_merged_7d49
prs_decided_7d49
prs_merged_30d53
prs_decided_30d53
issue_closed_ratio—
closed_unmerged_prs2
first_time_authors_30d0
first_time_prs_merged_30d0
first_time_prs_decided_30d0
Виключено з оцінювання (немає даних або не застосовно): Вирішення issue, Newcomer PR acceptance. Залишкові ваги перенормовано.

Власність та опіка

55Помірний
Як обчислюється оцінка
10/30Підтримка власника — особистий (користувацький) обліковий запис
0/20Верифікований домен — не застосовно до користувацьких облікових записів
8.8/25Охоплення власника — 16 підписників у Adeniyikayodee
25/25Послужний список — 60 публічних репозиторіїв, вік облікового запису ~7 р.
Використані вхідні дані
followers16
owner_typeUser
is_verified—
owner_loginAdeniyikayodee
public_repos60
account_age_days2 877
Виключено з оцінювання (немає даних або не застосовно): Верифікований домен. Залишкові ваги перенормовано.

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

100Винятковий
Як обчислюється оцінка
25/25Опубліковано й доступно — 4 пакет(ів) у crates, pypi
35/35Свіжість публікацій — остання публікація 0 дн. тому
20/20Історія версій — 16 опублікованих версій
20/20Не застарілий — активний, не deprecated і не yanked
Використані вхідні дані
packagesng-postcode, ng-postcode-mcp, ng-address-resolver, ng-postcode
ecosystemscrates, pypi
any_deprecatedні
min_days_since_publish0

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

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

90Відмінний · 19% загального індексу

Інженерні практики

84Відмінний
Як обчислюється оцінка
24/24Процеси CI — 11 процес(ів) CI
24/24Наявні тести
16/16Конфігурація лінтера — agent/pyproject.toml ([tool.ruff]), biome.json, mcp/pyproject.toml ([tool.ruff]), python/pyproject.toml ([tool.ruff])
0/9.6Pre-commit-хуки
0/6.4.editorconfig
20/20OpenSSF Scorecard: CI-Tests — 11 out of 11 merged PRs checked by a CI test -- score normalized to 10
Використані вхідні дані
has_ciтак
has_testsтак
has_editorconfigні
has_linter_configтак
has_precommit_configні

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

100Винятковий
Як обчислюється оцінка
30/30README
25/25Каталог документації
15/15Сайт документації / домашня сторінка — https://adeniyikayodee.github.io/ng-postcode/
10/10Опис репозиторію
10/10Теми — 20 тем
10/10Wiki
Використані вхідні дані
topicsaddress, address-validation, geocoding, nigeria, nipost, postal-code, postcode, reverse-geocoding, rust, ndaps, ai-agents, mcp, mcp-server, javascript, python, typescript, java, duckdb, polars, postgresql
has_wikiтак
homepagehttps://adeniyikayodee.github.io/ng-postcode/
docs_sitehttps://adeniyikayodee.github.io/ng-postcode/
has_readmeтак
has_docs_dirтак
has_descriptionтак

Безпека

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

53Помірний · 16% загального індексу

Стан безпеки

53Помірний
Як обчислюється оцінка
7.5/7.5Binary-Artifacts — no binaries found in the repo
2.2/7.5Branch-Protection — branch protection is not maximal on development and all release branches
2.5/2.5CI-Tests — 11 out of 11 merged PRs checked by a CI test -- score normalized to 10
0/2.5CII-Best-Practices — no effort to earn an OpenSSF best practices badge detected
0/7.5Code-Review — Found 0/11 approved changesets -- score normalized to 0
0/2.5Contributors — project has 0 contributing companies or organizations -- score normalized to 0
10/10Dangerous-Workflow — no dangerous workflow patterns detected
7.5/7.5Dependency-Update-Tool — update tool detected
0/5Fuzzing — project is not fuzzed
2.5/2.5Ліцензія — license file detected
0/7.5Maintained — project was created within the last 90 days. Please review its contents carefully
5/5Packaging — packaging workflow detected
5/5Pinned-Dependencies — all dependencies are pinned
0/5SAST — SAST tool is not run on all commits -- score normalized to 0
0/5Security-Policy — security policy file not detected
0/7.5Signed-Releases — Project has not signed or included provenance with any releases.
7.5/7.5Token-Permissions — GitHub workflow tokens follow principle of least privilege
6/7.5Vulnerabilities — 2 existing vulnerabilities detected
Використані вхідні дані
sourceopenssf_scorecard
checks_evaluated18
scorecard_versionv5.5.0
checks_inconclusive0
scorecard_aggregate5,3

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

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

78Добрий · 4% загального індексу

Контекст і настанови для агентів

55Помірний
Як обчислюється оцінка
0/45Інструкції для агентів — немає CLAUDE.md / AGENTS.md / правил редактора
15/15Машиночитана документація (llms.txt) — llms.txt наявний
40/40Читабельна історія комітів — намір зазначено у 93 з 93 людських комітів (структурований заголовок або пояснювальний текст)
Використані вхідні дані
has_llms_txtтак
llms_txt_url—
legible_history_share1
agent_instruction_files—
agent_instruction_max_bytes—

Цикл верифікації (збірка / тести / перевірка типів)

85Відмінний
Як обчислюється оцінка
12.6/18Розгортання однією командою — Cargo.toml, java/api/pom.xml, java/core/pom.xml (домовленість інструментарію, без раннера задач)
22/22Автоматизовані тести
11/11Конфігурація лінтера / форматера — agent/pyproject.toml ([tool.ruff]), biome.json, mcp/pyproject.toml ([tool.ruff]), python/pyproject.toml ([tool.ruff])
11/11Статична перевірка типів — agent/src/ng_address/py.typed, js/packages/ng-postcode-js/tsconfig.json, js/packages/ng-postcode-mcp/tsconfig.json, mcp/src/ng_postcode_mcp/py.typed, native/polars/ng_postcode_polars/py.typed, python/src/ng_postcode/py.typed
10/10Відтворюване середовище — Dockerfile, lockfile
0/10Підтверджена практика роботи з агентами — серед останніх 100 комітів немає створених агентом
8/8Автоматизоване супроводження — 7 з останніх 100 комітів — автоматичні оновлення залежностей
10/10OpenSSF Scorecard: Pinned-Dependencies — all dependencies are pinned
Використані вхідні дані
has_nixні
has_testsтак
lockfilesCargo.lock, package-lock.json, uv.lock
has_dockerfileтак
typed_languageні
bootstrap_files—
has_devcontainerні
has_linter_configтак
typecheck_configsagent/src/ng_address/py.typed, js/packages/ng-postcode-js/tsconfig.json, js/packages/ng-postcode-mcp/tsconfig.json, mcp/src/ng_postcode_mcp/py.typed, native/polars/ng_postcode_polars/py.typed, python/src/ng_postcode/py.typed
agent_commit_share0
toolchain_manifestsCargo.toml, java/api/pom.xml, java/core/pom.xml, java/pom.xml, native/pg/Cargo.toml, native/polars/Cargo.toml
dependency_bot_commit_share0,07

Читабельність коду для моделей

82Відмінний
Як обчислюється оцінка
27/45Типізований код — Python з конфігурацією перевірки типів (agent/src/ng_address/py.typed, js/packages/ng-postcode-js/tsconfig.json, js/packages/ng-postcode-mcp/tsconfig.json, mcp/src/ng_postcode_mcp/py.typed, native/polars/ng_postcode_polars/py.typed, python/src/ng_postcode/py.typed)
55/55Керовані розміри файлів — 0/92 файлів вихідного коду понад 60 КБ
Використані вхідні дані
primary_languagePython
largest_source_bytes28 707
source_files_sampled92
oversized_source_files0

Машиночитні інтерфейси

100Винятковий
Як обчислюється оцінка
0/40Схема API (OpenAPI/GraphQL/proto) — не застосовно до цього типу програмного забезпечення
20/20Сервер MCP
40/40Придатні до запуску приклади — examples
Використані вхідні дані
example_dirsexamples
has_mcp_signalтак
api_schema_files—
interfaces_expected_of—
Виключено з оцінювання (немає даних або не застосовно): Схема API (OpenAPI/GraphQL/proto). Залишкові ваги перенормовано.

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

4зірок GitHub
1контриб'юторів
319комітів за останні 12 місяців
0днів від останнього пушу
6релізів
1бас-фактор
0відкритих issue
crates.io, Maven, npm, PyPIпакетних екосистем

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

  • Star history unavailable: GitHub GraphQL error: Resource not accessible by personal access token
  • GitHub dependency-graph SBOM unavailable (404); the dependency graph may be disabled for this repository
  • deps.dev does not index crates:ng-postcode@0.5.4; advisories assessed against the repository dependency graph instead

Докладніше

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

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

10Binary-Artifactsno binaries found in the repo
3Branch-Protectionbranch protection is not maximal on development and all release branches
10CI-Tests11 out of 11 merged PRs checked by a CI test -- score normalized to 10
0CII-Best-Practicesno effort to earn an OpenSSF best practices badge detected
0Code-ReviewFound 0/11 approved changesets -- score normalized to 0
0Contributorsproject has 0 contributing companies or organizations -- score normalized to 0
10Dangerous-Workflowno dangerous workflow patterns detected
10Dependency-Update-Toolupdate tool detected
0Fuzzingproject is not fuzzed
10Licenselicense file detected
0Maintainedproject was created within the last 90 days. Please review its contents carefully
10Packagingpackaging workflow detected
10Pinned-Dependenciesall dependencies are pinned
0SASTSAST tool is not run on all commits -- score normalized to 0
0Security-Policysecurity policy file not detected
0Signed-ReleasesProject has not signed or included provenance with any releases.
10Token-PermissionsGitHub workflow tokens follow principle of least privilege
8Vulnerabilities2 existing vulnerabilities detected
Прямі залежності 11
РеєстрПакетОбмеження версіїМаніфест
crates.ioserde1Cargo.toml
crates.ioserde_json1Cargo.toml
crates.ioureq3Cargo.toml
PyPIhttpx>=0.27agent/pyproject.toml
PyPIng-postcode>=0.3.4,<0.4agent/pyproject.toml
PyPIpydantic>=2.7agent/pyproject.toml
Mavenorg.junit:junit-bom6.1.3java/pom.xml
Mavencom.fasterxml.jackson.core:jackson-databind${jackson.version}java/pom.xml
PyPImcp>=2.3,<3mcp/pyproject.toml
PyPIng-address-resolver>=0.1.8,<0.2mcp/pyproject.toml
PyPIng-postcode>=0.3.4,<0.4mcp/pyproject.toml
Усі залежності не зібрано

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

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

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

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

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

Пов’язані записи

Перевірені репозиторії, що мають спільні каталожні теги або екосистеми з Adeniyikayodee/ng-postcode. Читати поруч →

98ComposioHQ/composioComposio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.Винятковий98apache/foryA blazingly fast multi-language serialization framework for idiomatic domain objects, schema IDL, and cross-language data exchange.Винятковий98semgrep/semgrepLightweight static analysis for many languages. Find bug variants with patterns that look like source code.Винятковий99IBM/mcp-context-forgeAn AI Gateway, registry, and proxy that sits in front of any MCP, A2A, or REST/gRPC APIs, exposing a unified endpoint with centralized discovery, guardrails and management. Optimizes Agent & Tool calling, and supports plugins.Винятковий99taskforcesh/bullmqBullMQ - Message Queue and Batch processing for NodeJS, Python, .NET, Elixir, Rust and PHP based on Redis or PostgreSQLВинятковий100deepset-ai/haystackOpen-source AI orchestration framework for building context-engineered, production-ready LLM applications. Design modular pipelines and agent workflows with explicit control over retrieval, routing, memory, and generation. Built for scalable agents, RAG, multimodal applications, semantic search, and conversational systems.Винятковий

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

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

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