raintree-technology / hig-doctor
Apple HIG reference and cross-framework UI audit tooling for agents.
raintree-technology/hig-doctor має індекс здоров’я 86 зі 100, що відповідає смузі «Відмінний». Найвищий показник — AI Readiness (96/100), найнижчий — Sustainability & Governance (53/100). Останнє оновлення — сьогодні. Більшість нещодавньої роботи виконує один учасник.
Індекс здоров'я програмного забезпечення
Метрики згруповано у зважені категорії на шкалі 1–100. Загальна оцінка починається як їхнє зважене середнє, відкаліброване за розподілом публічного реєстру, тож діапазони мають перцентильний зміст; коли публічні дані активують Політику юрисдикцій високого ризику, рейтинг коригується й отримує верхню межу 34 («У зоні ризику»).
Профіль оцінок
Кожна вісь — окрема категорія. Форма важить більше, ніж середнє: здоровий об'єкт заповнює всю фігуру, тоді як профіль із піками та провалами означає, що сила в одному вимірі маскує ризик в іншому.
Зважений загальний бал 72 калібровано до 86 за шкалою опублікованого індексу (калібрування реєстру 2026-08-02).
Власність
За цим репозиторієм стоїть організація — спільна, підзвітна опіка, здатна пережити будь-якого окремого мейнтейнера.
Пакетні екосистеми
| Реєстр | Пакет | Версія | Завантажень / міс | Версії | Остання публікація | Теги |
|---|---|---|---|---|---|---|
| npm | hig-doctor | 2.0.3 | 2 045 | 4 | 38 днів тому | applehighuman-interface-guidelinesauditaccessibilityswiftuireactdesign-lint |
| npm | hig-mcp | 0.2.3 | 470 | 4 | 38 днів тому | — |
| npm | @raintree-technology/hig-doctor-core | 0.1.3 | 68 | 4 | 38 днів тому | applehighuman-interface-guidelinesauditaccessibilitylint-engine |
Метрики за категоріями
Життєздатність
Чи живий проєкт — чи пишеться код і чи виходять релізи?
Активність розробки
Як обчислюється оцінка
| 36/36 | Свіжість push — останній push 0 дн. тому |
| 13.2/36 | Ритм комітів — 19/52 тижнів із комітами |
| 18/18 | Обсяг комітів — 132 комітів за останній рік |
| 10/10 | OpenSSF Scorecard: Maintained — 30 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10 |
Використані вхідні дані
| commits_last_year | 132 |
| human_commit_share | 0,99 |
| days_since_last_push | 0 |
| active_weeks_last_year | 19 |
Дисципліна релізів
Як обчислюється оцінка
| 27/27 | Випускає релізи — опубліковано 4 релізів |
| 36/36 | Свіжість релізів — останній реліз 38 дн. тому |
| 19.8/27 | Ритм релізів — реліз кожні ~69 дн. |
| 0/10 | OpenSSF Scorecard: Signed-Releases — немає даних |
Використані вхідні дані
| releases_count | 4 |
| latest_release_tag | hig-doctor-v2.0.3 |
| releases_from_tags | ні |
| days_since_latest_release | 38 |
| mean_days_between_releases | 69 |
Спільнота та впровадження
Чи має проєкт користувачів, завантаження, увагу та влаштовані умови для контриб’юторів?
Популярність і впровадження
Як обчислюється оцінка
| 35/60 | Зірки — 144 зірок |
| 8/25 | Форки — 10 форків |
| 0/15 | Спостерігачі — 1 спостерігачів |
Використані вхідні дані
| forks | 10 |
| stars | 144 |
| watchers | 1 |
| growth_state | unverified |
| growth_factor_pct | 100 |
| growth_unverified_reason | no_history |
Здоров'я спільноти
Як обчислюється оцінка
| 22.5/22.5 | README |
| 22.5/22.5 | Ліцензія — визнана ліцензія (MIT) |
| 18/18 | Настанови CONTRIBUTING |
| 13.5/13.5 | Кодекс поведінки |
| 0/7.2 | Шаблон issue |
| 6.3/6.3 | Шаблон PR |
Використані вхідні дані
| has_readme | так |
| has_license | так |
| readme_badges | 0 |
| has_contributing | так |
| has_issue_template | ні |
| has_code_of_conduct | так |
| readme_badge_services | — |
| has_pull_request_template | так |
Впровадження в екосистемі (завантаження)
Як обчислюється оцінка
| 45.5/80 | Щомісячні завантаження — 2 583 завантажень/місяць у npm |
| 0/20 | Залежні пакети в реєстрі — ця екосистема цього не повідомляє |
Використані вхідні дані
| packages | hig-doctor, hig-mcp, @raintree-technology/hig-doctor-core |
| dependents | — |
| ecosystems | npm |
| total_downloads | — |
| monthly_downloads | 2 583 |
| unverified_packages_excluded | — |
Сталість та врядування
Чи переживе проєкт своїх людей — бас-фактор, реактивність, хто за ним стоїть і як супроводжуються пакети?
Стійкість мейнтейнерів (бас-фактор)
Як обчислюється оцінка
| 9/54 | Бас-фактор — на 1 контриб’ютор(ів) припадає половина всіх комітів |
| 9.9/22.5 | Розподіл комітів — головний контриб’ютор — автор 56% комітів |
| 4.1/13.5 | Широта контриб’юторів — 3 контриб’юторів |
| 6/10 | OpenSSF Scorecard: Contributors — project has 2 contributing companies or organizations -- score normalized to 6 |
Використані вхідні дані
| bus_factor | 1 |
| contributors_sampled | 3 |
| top_contributor_share | 0,561 |
Реактивність на issue та PR
Як обчислюється оцінка
| 41.1/42 | Вирішення issue — закрито 98% issue |
| 6.7/30 | Прийняття PR — злито 15/67 вирішених PR |
| 0/13 | Newcomer PR acceptance — за 30 дн. не вирішено жодного PR від новачка |
| 0/15 | OpenSSF Scorecard: Code-Review — Found 1/19 approved changesets -- score normalized to 0 |
Використані вхідні дані
| merged_prs | 15 |
| open_issues | 3 |
| closed_issues | 132 |
| prs_merged_7d | 1 |
| prs_decided_7d | 1 |
| prs_merged_30d | 1 |
| prs_decided_30d | 1 |
| issue_closed_ratio | 0,978 |
| closed_unmerged_prs | 52 |
| first_time_authors_30d | 0 |
| first_time_prs_merged_30d | 0 |
| first_time_prs_decided_30d | 0 |
Власність та опіка
Як обчислюється оцінка
| 30/30 | Підтримка власника — у власності організації |
| 0/20 | Верифікований домен |
| 7.8/25 | Охоплення власника — 11 підписників у raintree-technology |
| 8.8/25 | Послужний список — 8 публічних репозиторіїв, вік облікового запису ~0 р. |
Використані вхідні дані
| followers | 11 |
| owner_type | Organization |
| is_verified | ні |
| owner_login | raintree-technology |
| public_repos | 8 |
| account_age_days | 339 |
Супровід пакетів
Як обчислюється оцінка
| 25/25 | Опубліковано й доступно — 3 пакет(ів) у npm |
| 35/35 | Свіжість публікацій — остання публікація 38 дн. тому |
| 12/20 | Історія версій — 4 опублікованих версій |
| 20/20 | Не застарілий — активний, не deprecated і не yanked |
Використані вхідні дані
| packages | hig-doctor, hig-mcp, @raintree-technology/hig-doctor-core |
| ecosystems | npm |
| any_deprecated | ні |
| min_days_since_publish | 38 |
Інженерна якість
Чи наявні базові інженерні практики та документація?
Інженерні практики
Як обчислюється оцінка
| 24/24 | Процеси CI — 9 процес(ів) CI |
| 24/24 | Наявні тести |
| 16/16 | Конфігурація лінтера — biome.json |
| 0/9.6 | Pre-commit-хуки |
| 6.4/6.4 | .editorconfig |
| 14/20 | OpenSSF Scorecard: CI-Tests — 5 out of 7 merged PRs checked by a CI test -- score normalized to 7 |
Використані вхідні дані
| has_ci | так |
| has_tests | так |
| has_editorconfig | так |
| has_linter_config | так |
| has_precommit_config | ні |
Документація
Як обчислюється оцінка
| 30/30 | README |
| 25/25 | Каталог документації |
| 15/15 | Сайт документації / домашня сторінка — https://apple.raintree.technology/ |
| 10/10 | Опис репозиторію |
| 10/10 | Теми — 20 тем |
| 0/10 | Wiki |
Використані вхідні дані
| topics | agent-skills, ai-agents, apple-design, claude-code, hig, human-interface-guidelines, ios, macos, swiftui, uikit, accessibility, audit, cursor, apple-hig, cli, developer-tools, mcp, nextjs, react, static-analysis |
| has_wiki | ні |
| homepage | https://apple.raintree.technology/ |
| docs_site | https://apple.raintree.technology/ |
| has_readme | так |
| has_docs_dir | так |
| has_description | так |
Безпека
Чи міцні видимі практики безпеки й ланцюга постачання, без непослабленої пов’язаності з юрисдикціями високого ризику?
Стан безпеки
Як обчислюється оцінка
| 7.5/7.5 | Binary-Artifacts — no binaries found in the repo |
| 2.2/7.5 | Branch-Protection — branch protection is not maximal on development and all release branches |
| 1.8/2.5 | CI-Tests — 5 out of 7 merged PRs checked by a CI test -- score normalized to 7 |
| 0/2.5 | CII-Best-Practices — no effort to earn an OpenSSF best practices badge detected |
| 0/7.5 | Code-Review — Found 1/19 approved changesets -- score normalized to 0 |
| 1.5/2.5 | Contributors — project has 2 contributing companies or organizations -- score normalized to 6 |
| 10/10 | Dangerous-Workflow — no dangerous workflow patterns detected |
| 7.5/7.5 | Dependency-Update-Tool — update tool detected |
| 0/5 | Fuzzing — project is not fuzzed |
| 2.5/2.5 | Ліцензія — license file detected |
| 7.5/7.5 | Maintained — 30 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10 |
| 0/5 | Packaging — немає даних |
| 5/5 | Pinned-Dependencies — all dependencies are pinned |
| 3.5/5 | SAST — SAST tool detected but not run on all commits |
| 5/5 | Security-Policy — security policy file detected |
| 0/7.5 | Signed-Releases — немає даних |
| 6.8/7.5 | Token-Permissions — detected GitHub workflow tokens with excessive permissions |
| 0/7.5 | Vulnerabilities — 26 existing vulnerabilities detected |
Використані вхідні дані
| source | openssf_scorecard |
| checks_evaluated | 16 |
| scorecard_version | v5.5.0 |
| checks_inconclusive | 2 |
| scorecard_aggregate | 6,6 |
Сповіщення про залежності
Як обчислюється оцінка
| 35/35 | Прямі залежності без відомих сповіщень — жодна пряма залежність не має відомих сповіщень |
| 25/25 | Непрямі залежності без відомих сповіщень — жодна непряма залежність не має відомих сповіщень |
| 0/40 | Немає задавнених сповіщень — жодне сповіщення не має дати публікації |
Використані вхідні дані
| source | osv |
| advisories | 0 |
| affected_packages | 0 |
| assessed_packages | 1 |
| unassessed_packages | 0 |
| affected_by_severity | none |
| direct_affected_packages | 0 |
Готовність до ШІ
Наскільки репозиторій оснащений для розробки та супроводу за участі ШІ-агентів? Має свідомо малу вагу (4%): агентний інструментарій — реальний сигнал супроводу, але репозиторій без нього все одно може отримати 100/100.
Контекст і настанови для агентів
Як обчислюється оцінка
| 45/45 | Інструкції для агентів — AGENTS.md |
| 15/15 | Машиночитана документація (llms.txt) — llms.txt опубліковано на сайті проєкту (https://apple.raintree.technology/llms.txt) |
| 40/40 | Читабельна історія комітів — намір зазначено у 84 з 99 людських комітів (структурований заголовок або пояснювальний текст) |
Використані вхідні дані
| has_llms_txt | так |
| llms_txt_url | https://apple.raintree.technology/llms.txt |
| legible_history_share | 0,848 |
| agent_instruction_files | AGENTS.md |
| agent_instruction_max_bytes | 1 141 |
Як обчислюється оцінка
| 18/18 | Розгортання однією командою — mise.toml |
| 22/22 | Автоматизовані тести |
| 11/11 | Конфігурація лінтера / форматера — biome.json |
| 11/11 | Статична перевірка типів — packages/cli/tsconfig.json, packages/core/tsconfig.json, packages/mcp/tsconfig.json, website/tsconfig.json |
| 0/10 | Відтворюване середовище |
| 10/10 | Підтверджена практика роботи з агентами — 60 з останніх 100 комітів створено агентом або з його зазначенням |
| 8/8 | Автоматизоване супроводження — 1 з останніх 100 комітів — автоматичні оновлення залежностей |
| 10/10 | OpenSSF Scorecard: Pinned-Dependencies — all dependencies are pinned |
Використані вхідні дані
| has_nix | ні |
| has_tests | так |
| lockfiles | — |
| has_dockerfile | ні |
| typed_language | так |
| bootstrap_files | mise.toml |
| has_devcontainer | ні |
| has_linter_config | так |
| typecheck_configs | packages/cli/tsconfig.json, packages/core/tsconfig.json, packages/mcp/tsconfig.json, website/tsconfig.json |
| agent_commit_share | 0,6 |
| toolchain_manifests | — |
| dependency_bot_commit_share | 0,01 |
Читабельність коду для моделей
Як обчислюється оцінка
| 45/45 | Типізований код — TypeScript (статично типізована) |
| 54.5/55 | Керовані розміри файлів — 1/113 файлів вихідного коду понад 60 КБ |
Використані вхідні дані
| primary_language | TypeScript |
| largest_source_bytes | 107 643 |
| source_files_sampled | 113 |
| oversized_source_files | 1 |
Машиночитні інтерфейси
Як обчислюється оцінка
| 0/40 | Схема API (OpenAPI/GraphQL/proto) — не застосовно до цього типу програмного забезпечення |
| 20/20 | Сервер MCP |
| 40/40 | Придатні до запуску приклади — demos |
Використані вхідні дані
| example_dirs | demos |
| has_mcp_signal | так |
| api_schema_files | — |
| interfaces_expected_of | — |
Ключові факти
Попередження щодо збору даних
- Star history unavailable: GitHub GraphQL error: Resource not accessible by personal access token
- Could not fetch npm package 'apple-hig-skills-web' from its registry
Докладніше
Історія зірок і форків 0 ★ / 10 ⇿
Коли додано кожну зірку й форк — зібрано з GitHub і згруповано за днями. Кумулятивне зростання розміщено просто над денними додаваннями, з яких воно складається, тож їх видно одне проти одного: рівномірне органічне накопичення виглядає зовсім інакше, ніж різкий короткочасний сплеск. Там, де цю різницю можна виміряти, її подано як автентичність росту.
OpenSSF Scorecard 6.6 / 10
Незалежна, не прив'язана до інструментів оцінка безпеки від відкритого проєкту OpenSSF Scorecard. Кожна перевірка винагороджує практику безпеки, а не інструмент конкретного постачальника. Перевірки, які Scorecard не зміг визначити, позначено н/д і виключено з оцінки безпеки (вони ніколи не зараховуються як нуль).
| 10 | Binary-Artifacts | no binaries found in the repo |
| 3 | Branch-Protection | branch protection is not maximal on development and all release branches |
| 7 | CI-Tests | 5 out of 7 merged PRs checked by a CI test -- score normalized to 7 |
| 0 | CII-Best-Practices | no effort to earn an OpenSSF best practices badge detected |
| 0 | Code-Review | Found 1/19 approved changesets -- score normalized to 0 |
| 6 | Contributors | project has 2 contributing companies or organizations -- score normalized to 6 |
| 10 | Dangerous-Workflow | no dangerous workflow patterns detected |
| 10 | Dependency-Update-Tool | update tool detected |
| 0 | Fuzzing | project is not fuzzed |
| 10 | License | license file detected |
| 10 | Maintained | 30 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10 |
| н/д | Packaging | packaging workflow not detected |
| 10 | Pinned-Dependencies | all dependencies are pinned |
| 7 | SAST | SAST tool detected but not run on all commits |
| 10 | Security-Policy | security policy file detected |
| н/д | Signed-Releases | no releases found |
| 9 | Token-Permissions | detected GitHub workflow tokens with excessive permissions |
| 0 | Vulnerabilities | 26 existing vulnerabilities detected |
Прямі залежності 19
| Реєстр | Пакет | Обмеження версії | Маніфест |
|---|---|---|---|
| npm | @radix-ui/react-accordion | ^1.2.12 | website/package.json |
| npm | @radix-ui/react-separator | ^1.1.8 | website/package.json |
| npm | @radix-ui/react-slot | ^1.2.4 | website/package.json |
| npm | @types/hast | ^3.0.4 | website/package.json |
| npm | @vercel/analytics | ^1.6.1 | website/package.json |
| npm | @vercel/speed-insights | ^1.3.1 | website/package.json |
| npm | lucide-react | ^0.563.0 | website/package.json |
| npm | next | 16.3.8 | website/package.json |
| npm | react | ^19.0.0 | website/package.json |
| npm | react-dom | ^19.0.0 | website/package.json |
| npm | rehype-autolink-headings | ^7.1.0 | website/package.json |
| npm | rehype-sanitize | ^6.0.0 | website/package.json |
| npm | rehype-slug | ^6.0.0 | website/package.json |
| npm | rehype-stringify | ^10.0.1 | website/package.json |
| npm | remark-parse | ^11.0.0 | website/package.json |
| npm | remark-rehype | ^11.1.2 | website/package.json |
| npm | tailwindcss-animate | ^1.0.7 | website/package.json |
| npm | unified | ^11.0.5 | website/package.json |
| npm | unist-util-visit | ^5.1.0 | website/package.json |
Усі залежності 40
Повний розв'язаний набір залежностей із графа залежностей GitHub: 21 прямих і 19 непрямих (транзитивних) пакетів. Транзитивне замикання є повним, коли в репозиторії закомічено lockfile.
| Реєстр | Пакет | Версія | Зв'язок |
|---|---|---|---|
| npm | @radix-ui/react-accordion | ^1.2.12 | пряма |
| npm | @radix-ui/react-separator | ^1.1.8 | пряма |
| npm | @radix-ui/react-slot | ^1.2.4 | пряма |
| npm | @types/hast | ^3.0.4 | пряма |
| npm | @vercel/analytics | ^1.6.1 | пряма |
| npm | @vercel/speed-insights | ^1.3.1 | пряма |
| npm | lucide-react | ^0.563.0 | пряма |
| npm | next | 16.3.8 | пряма |
| npm | react | ^18.3.1 | пряма |
| npm | react | ^19.0.0 | пряма |
| npm | react-dom | ^18.3.1 | пряма |
| npm | react-dom | ^19.0.0 | пряма |
| npm | rehype-autolink-headings | ^7.1.0 | пряма |
| npm | rehype-sanitize | ^6.0.0 | пряма |
| npm | rehype-slug | ^6.0.0 | пряма |
| npm | rehype-stringify | ^10.0.1 | пряма |
| npm | remark-parse | ^11.0.0 | пряма |
| npm | remark-rehype | ^11.1.2 | пряма |
| npm | tailwindcss-animate | ^1.0.7 | пряма |
| npm | unified | ^11.0.5 | пряма |
| npm | unist-util-visit | ^5.1.0 | пряма |
| npm | @biomejs/biome | 2.5.6 | непряма |
| npm | @modelcontextprotocol/sdk | ^1.12.0 | непряма |
| npm | @remotion/cli | 4.0.484 | непряма |
| npm | @remotion/transitions | 4.0.484 | непряма |
| npm | @types/bun | ^1.3.3 | непряма |
| npm | @types/node | ^20 | непряма |
| npm | @types/react | ^19 | непряма |
| npm | @types/react-dom | ^19 | непряма |
| npm | autoprefixer | ^10.4.16 | непряма |
| npm | class-variance-authority | ^0.7.1 | непряма |
| npm | clsx | ^2.1.1 | непряма |
| npm | esbuild | ^0.25.0 | непряма |
| npm | ink | ^5.2.1 | непряма |
| npm | postcss | 8.5.26 | непряма |
| npm | remotion | 4.0.484 | непряма |
| npm | tailwind-merge | ^3.4.0 | непряма |
| npm | tailwindcss | ^3.4.1 | непряма |
| npm | typescript | ^5 | непряма |
| npm | typescript | ^5.9.3 | непряма |
Сповіщення про залежності 0
Встановлення npm:hig-doctor@2.0.3 тягне 1 пакетів, прямих і транзитивних: 0 мають відомі сповіщення, з них 0 — прямі залежності.
Жодне відоме сповіщення не стосується оцінених залежностей.
Сповіщення означає, що версія, записана в графі залежностей, потрапляє в уражений діапазон. Досяжність не аналізується, а граф містить піниї розробки й тестування — знахідка може стосуватися інструментів, а не поставленого коду.
Звіт у форматі JSON машиночитний
Зворотний зв’язок
Помітили щось хибне у цьому звіті або маєте чим поділитися? Неправильні вимірювання, непомічені інструменти, ідеї, запитання — усе доречно. Кожне повідомлення читається й отримує відповідь.
Оцінки — це сигнали, а не гарантії. Вони відображають публічно видимі практики на GitHub — це не аудит коду й не гарантія безпеки.
Відсутні дані виключаються, а ваги перенормовуються — нуль за відсутність ніколи не ставиться. Методологія версіонована й відкрита: метрики v2.10.0, схема v0.34.0 — повна методологія · вікі метрик.
Як окремий результат виглядає на тлі всього реєстру: сукупна статистика — npm.