Звіт про здоров'я програмного забезпеченнясхема 0.34.0 · метрики 2.10.0 · 2026-09-05 15:36 UTC

jdiejim / avodado

Avodado Doc as code

TypeScriptMIT★ 0 зірок⑂ 0 форківз лип. 2026 р.Переглянути на GitHub ↗

ТипІнструмент командного рядкаMCP-серверБібліотекаТермінальний інтерфейсяк це визначено

jdiejim/avodado має індекс здоров’я 60 зі 100, що відповідає смузі «Помірний». Найвищий показник — AI Readiness (81/100), найнижчий — Community & Adoption (32/100). Останнє оновлення було 5 днів тому. Більшість нещодавньої роботи виконує один учасник.

загалом / 100

Помірний

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

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

Винятковий93-100Верхній щабель реєстру (≈ топ-5%); відповідає практично всім перевіреним критеріям

Відмінний80-92Сильний за всіма напрямами; незначні прогалини

Добрий65-79Здоровий; прогалини обмежені та керовані

Помірний50-64Прийнятний, але з помітними прогалинами; рекомендовано перевірку

Слабкий35-49Суттєві недоліки в кількох сферах

У зоні ризику20-34Суттєві слабкі місця; впровадження потребує обережності

Критичний1-19Серйозні проблеми (покинутий, єдиний мейнтейнер, без базової гігієни)

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

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

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

Власність

Juan JimenezОсобистий обліковий запис

17 підписників68 публічних репозиторіївз вер. 2015 р.

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

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

Реєстр	Пакет	Версія	Завантажень / міс	Версії	Остання публікація	Теги
npm	avodado	0.43.0	422	36	5 днів тому	avodado documentation docs-as-code documentation-as-code markdown yaml typed-blocks diagrams diagrams-as-code mermaid-alternative sequence-diagram erd c4-model api-docs api-documentation system-design architecture architecture-diagrams adr design-system presentations technical-writing developer-docs ai-documentation claude cursor copilot mcp studio visual-editor html slides pdf static-site-generator cli developer-tools pptx powerpoint powerpoint-export
npm	@avodado/mcp	0.3.26	543	74	5 днів тому	avodado mcp model-context-protocol ai ai-documentation claude cursor llm agent documentation docs-as-code documentation-as-code markdown yaml typed-blocks api-documentation system-design architecture adr
npm	@avodado/core	0.21.0	378	27	5 днів тому	avodado documentation docs-as-code documentation-as-code markdown yaml typed-blocks diagrams-as-code parser schema zod validation ast cross-references api-documentation system-design architecture adr technical-writing developer-tools
npm	@avodado/render	0.30.0	428	64	5 днів тому	avodado documentation docs-as-code documentation-as-code markdown yaml html svg diagrams diagrams-as-code mermaid-alternative slides pdf themes render static-site-generator api-documentation system-design architecture c4-model presentations technical-writing
npm	@avodado/studio	0.13.0	245	21	5 днів тому	avodado studio documentation docs-as-code documentation-as-code visual-editor editor wysiwyg markdown yaml typed-blocks live-preview slides presentations diagrams api-documentation system-design architecture adr design-system ai-documentation technical-writing developer-tools

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

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

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

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

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

57Помірний

Як обчислюється оцінка

36/36	Свіжість push — останній push 5 дн. тому
3.5/36	Ритм комітів — 5/52 тижнів із комітами
17.8/18	Обсяг комітів — 94 комітів за останній рік
0/10	OpenSSF Scorecard: Maintained — project was created within the last 90 days. Please review its contents carefully

Використані вхідні дані

commits_last_year	94
human_commit_share	0,617
days_since_last_push	5
active_weeks_last_year	5

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

100Винятковий

Як обчислюється оцінка

27/27	Випускає релізи — опубліковано 12 релізів
36/36	Свіжість релізів — останній реліз 52 дн. тому
27/27	Ритм релізів — реліз кожні ~0 дн.
0/10	OpenSSF Scorecard: Signed-Releases — немає даних

Використані вхідні дані

releases_count	12
latest_release_tag	@avodado/studio@0.5.0
releases_from_tags	ні
days_since_latest_release	52
mean_days_between_releases	0

Виключено з оцінювання (немає даних або не застосовно): OpenSSF Scorecard: Signed-Releases. Залишкові ваги перенормовано.

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

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

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

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

50Помірний

Як обчислюється оцінка

22.5/22.5	README
22.5/22.5	Ліцензія — визнана ліцензія (MIT)
0/18	Настанови CONTRIBUTING
0/13.5	Кодекс поведінки
0/7.2	Шаблон issue
0/6.3	Шаблон PR

Використані вхідні дані

has_readme	так
has_license	так
readme_badges	5
has_contributing	ні
has_issue_template	ні
has_code_of_conduct	ні
readme_badge_services	shields.io
has_pull_request_template	ні

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

55Помірний

Як обчислюється оцінка

44.1/80	Щомісячні завантаження — 2 016 завантажень/місяць у npm
0/20	Залежні пакети в реєстрі — ця екосистема цього не повідомляє

Використані вхідні дані

packages	avodado, @avodado/mcp, @avodado/core, @avodado/render, @avodado/studio
dependents	—
ecosystems	npm
total_downloads	—
monthly_downloads	2 016
unverified_packages_excluded	—

Виключено з оцінювання (немає даних або не застосовно): Залежні пакети в реєстрі. Залишкові ваги перенормовано.

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

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

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

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

10Критичний

Як обчислюється оцінка

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

Використані вхідні дані

bus_factor	1
contributors_sampled	1
top_contributor_share	1

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

50Помірний

Як обчислюється оцінка

0/42	Вирішення issue — немає issue або даних
22.5/30	Прийняття PR — злито 3/4 вирішених PR
0/13	Newcomer PR acceptance — за 30 дн. не вирішено жодного PR від новачка
0/15	OpenSSF Scorecard: Code-Review — Found 0/30 approved changesets -- score normalized to 0

Використані вхідні дані

merged_prs	3
open_issues	0
closed_issues	0
prs_merged_7d	0
prs_decided_7d	0
prs_merged_30d	0
prs_decided_30d	0
issue_closed_ratio	—
closed_unmerged_prs	1
first_time_authors_30d	0
first_time_prs_merged_30d	0
first_time_prs_decided_30d	0

Виключено з оцінювання (немає даних або не застосовно): Вирішення issue, Newcomer PR acceptance. Залишкові ваги перенормовано.

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

55Помірний

Як обчислюється оцінка

10/30	Підтримка власника — особистий (користувацький) обліковий запис
0/20	Верифікований домен — не застосовно до користувацьких облікових записів
9/25	Охоплення власника — 17 підписників у jdiejim
25/25	Послужний список — 68 публічних репозиторіїв, вік облікового запису ~10 р.

Використані вхідні дані

followers	17
owner_type	User
is_verified	—
owner_login	jdiejim
public_repos	68
account_age_days	4 003

Виключено з оцінювання (немає даних або не застосовно): Верифікований домен. Залишкові ваги перенормовано.

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

100Винятковий

Як обчислюється оцінка

25/25	Опубліковано й доступно — 5 пакет(ів) у npm
35/35	Свіжість публікацій — остання публікація 5 дн. тому
20/20	Історія версій — 74 опублікованих версій
20/20	Не застарілий — активний, не deprecated і не yanked

Використані вхідні дані

packages	avodado, @avodado/mcp, @avodado/core, @avodado/render, @avodado/studio
ecosystems	npm
any_deprecated	ні
min_days_since_publish	5

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

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

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

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

80Відмінний

Як обчислюється оцінка

24/24	Процеси CI — 2 процес(ів) CI
24/24	Наявні тести
16/16	Конфігурація лінтера — eslint.config.js
0/9.6	Pre-commit-хуки
0/6.4	.editorconfig
0/20	OpenSSF Scorecard: CI-Tests — немає даних

Використані вхідні дані

has_ci	так
has_tests	так
has_editorconfig	ні
has_linter_config	так
has_precommit_config	ні

Виключено з оцінювання (немає даних або не застосовно): OpenSSF Scorecard: CI-Tests. Залишкові ваги перенормовано.

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

80Відмінний

Як обчислюється оцінка

30/30	README
25/25	Каталог документації
15/15	Сайт документації / домашня сторінка — https://avodado.dev
10/10	Опис репозиторію
0/10	Теми
0/10	Wiki

Використані вхідні дані

topics	—
has_wiki	ні
homepage	—
docs_site	https://avodado.dev
has_readme	так
has_docs_dir	так
has_description	так

Безпека

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

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

Стан безпеки

26У зоні ризику

Як обчислюється оцінка

7.5/7.5	Binary-Artifacts — no binaries found in the repo
0/7.5	Branch-Protection — branch protection not enabled on development/release branches
0/2.5	CI-Tests — немає даних
0/2.5	CII-Best-Practices — no effort to earn an OpenSSF best practices badge detected
0/7.5	Code-Review — Found 0/30 approved changesets -- score normalized to 0
0/2.5	Contributors — project has 0 contributing companies or organizations -- score normalized to 0
10/10	Dangerous-Workflow — no dangerous workflow patterns detected
0/7.5	Dependency-Update-Tool — no update tool detected
0/5	Fuzzing — project is not fuzzed
2.5/2.5	Ліцензія — license file detected
0/7.5	Maintained — project was created within the last 90 days. Please review its contents carefully
5/5	Packaging — packaging workflow detected
0/5	Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 0
0/5	SAST — no SAST tool detected
0/5	Security-Policy — security policy file not detected
0/7.5	Signed-Releases — немає даних
0/7.5	Token-Permissions — detected GitHub workflow tokens with excessive permissions
0/7.5	Vulnerabilities — 34 existing vulnerabilities detected

Використані вхідні дані

source	openssf_scorecard
checks_evaluated	16
scorecard_version	v5.5.0
checks_inconclusive	2
scorecard_aggregate	2,6

Виключено з оцінювання (немає даних або не застосовно): CI-Tests, Signed-Releases. Залишкові ваги перенормовано.

Сповіщення про залежності

85Відмінний

Як обчислюється оцінка

35/35	Прямі залежності без відомих сповіщень — жодна пряма залежність не має відомих сповіщень
10/25	Непрямі залежності без відомих сповіщень — уражено 1: image-size 1.2.1 (high 7.5)
40/40	Немає задавнених сповіщень — жодне сповіщення не є публічним довше за 90 дн.

Використані вхідні дані

source	osv
advisories	2
affected_packages	1
assessed_packages	119
unassessed_packages	0
affected_by_severity	high 1
direct_affected_packages	0

Звірено з runtime-замиканням залежностей npm:avodado@0.43.0 — тим, що тягне за собою встановлення опублікованого пакета, — 119 пакетів. Досяжність не аналізується.

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

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

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

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

85Відмінний

Як обчислюється оцінка

45/45	Інструкції для агентів — .cursor/rules/avodado.mdc, .github/copilot-instructions.md, .windsurfrules, CLAUDE.md, packages/cli/templates/.windsurfrules, packages/cli/templates/CLAUDE.md
0/15	Машиночитана документація (llms.txt)
40/40	Читабельна історія комітів — намір зазначено у 58 з 58 людських комітів (структурований заголовок або пояснювальний текст)

Використані вхідні дані

has_llms_txt	ні
llms_txt_url	—
legible_history_share	1
agent_instruction_files	.cursor/rules/avodado.mdc, .github/copilot-instructions.md, .windsurfrules, CLAUDE.md, packages/cli/templates/.windsurfrules, packages/cli/templates/CLAUDE.md
agent_instruction_max_bytes	5 168

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

64Помірний

Як обчислюється оцінка

0/18	Розгортання однією командою
22/22	Автоматизовані тести
11/11	Конфігурація лінтера / форматера — eslint.config.js
11/11	Статична перевірка типів — packages/cli/tsconfig.json, packages/core/tsconfig.json, packages/mcp/tsconfig.json, packages/render/tsconfig.json, packages/studio/tsconfig.json, tsconfig.json
10/10	Відтворюване середовище — lockfile
10/10	Підтверджена практика роботи з агентами — 52 з останніх 94 комітів створено агентом або з його зазначенням
0/8	Автоматизоване супроводження — автоматичних оновлень залежностей не виявлено
0/10	OpenSSF Scorecard: Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 0

Використані вхідні дані

has_nix	ні
has_tests	так
lockfiles	pnpm-lock.yaml
has_dockerfile	ні
typed_language	так
bootstrap_files	—
has_devcontainer	ні
has_linter_config	так
typecheck_configs	packages/cli/tsconfig.json, packages/core/tsconfig.json, packages/mcp/tsconfig.json, packages/render/tsconfig.json, packages/studio/tsconfig.json, tsconfig.json
agent_commit_share	0,553
toolchain_manifests	—
dependency_bot_commit_share	0

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

100Винятковий

Як обчислюється оцінка

45/45	Типізований код — TypeScript (статично типізована)
54.5/55	Керовані розміри файлів — 4/407 файлів вихідного коду понад 60 КБ

Використані вхідні дані

primary_language	TypeScript
largest_source_bytes	148 066
source_files_sampled	407
oversized_source_files	4

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

100Винятковий

Як обчислюється оцінка

0/40	Схема API (OpenAPI/GraphQL/proto) — не застосовно до цього типу програмного забезпечення
20/20	Сервер MCP
40/40	Придатні до запуску приклади — examples

Використані вхідні дані

example_dirs	examples
has_mcp_signal	так
api_schema_files	—
interfaces_expected_of	—

Виключено з оцінювання (немає даних або не застосовно): Схема API (OpenAPI/GraphQL/proto). Залишкові ваги перенормовано.

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

0зірок GitHub

1контриб'юторів

94комітів за останні 12 місяців

5днів від останнього пушу

12релізів

1бас-фактор

0відкритих issue

npmпакетних екосистем

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

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

Докладніше

OpenSSF Scorecard 2.6 / 10

2.6сукупно

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

10	Binary-Artifacts	no binaries found in the repo
0	Branch-Protection	branch protection not enabled on development/release branches
н/д	CI-Tests	no pull request found
0	CII-Best-Practices	no effort to earn an OpenSSF best practices badge detected
0	Code-Review	Found 0/30 approved changesets -- score normalized to 0
0	Contributors	project has 0 contributing companies or organizations -- score normalized to 0
10	Dangerous-Workflow	no dangerous workflow patterns detected
0	Dependency-Update-Tool	no update tool detected
0	Fuzzing	project is not fuzzed
10	License	license file detected
0	Maintained	project was created within the last 90 days. Please review its contents carefully
10	Packaging	packaging workflow detected
0	Pinned-Dependencies	dependency not pinned by hash detected -- score normalized to 0
0	SAST	no SAST tool detected
0	Security-Policy	security policy file not detected
н/д	Signed-Releases	no releases found
0	Token-Permissions	detected GitHub workflow tokens with excessive permissions
0	Vulnerabilities	34 existing vulnerabilities detected

Прямі залежності 25

Реєстр	Пакет	Обмеження версії	Маніфест
npm	@avodado/core	`workspace:*`	packages/cli/package.json
npm	@avodado/render	`workspace:*`	packages/cli/package.json
npm	@avodado/studio	`workspace:*`	packages/cli/package.json
npm	cfonts	`^3.3.0`	packages/cli/package.json
npm	commander	`^12.1.0`	packages/cli/package.json
npm	fast-glob	`^3.3.2`	packages/cli/package.json
npm	ink	`^5.1.0`	packages/cli/package.json
npm	ink-select-input	`^6.0.0`	packages/cli/package.json
npm	ink-table	`^3.1.0`	packages/cli/package.json
npm	jiti	`^2.4.2`	packages/cli/package.json
npm	open	`^10.1.0`	packages/cli/package.json
npm	picocolors	`^1.1.1`	packages/cli/package.json
npm	pptxgenjs	`^4.0.1`	packages/cli/package.json
npm	react	`^18.3.1`	packages/cli/package.json
npm	yaml	`^2.6.1`	packages/cli/package.json
npm	zod	`^3.24.1`	packages/cli/package.json
npm	yaml	`^2.6.1`	packages/core/package.json
npm	zod	`^3.24.1`	packages/core/package.json
npm	@avodado/core	`workspace:*`	packages/mcp/package.json
npm	@avodado/render	`workspace:*`	packages/mcp/package.json
npm	@modelcontextprotocol/sdk	`^1.29.0`	packages/mcp/package.json
npm	zod	`^3.24.1`	packages/mcp/package.json
npm	zod-to-json-schema	`^3.25.2`	packages/mcp/package.json
npm	@avodado/core	`workspace:*`	packages/render/package.json
npm	marked	`^14.1.4`	packages/render/package.json

Усі залежності не зібрано

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

Сповіщення про залежності 1

Встановлення npm:avodado@0.43.0 тягне 119 пакетів, прямих і транзитивних: 1 мають відомі сповіщення, з них 0 — прямі залежності.

Пакет	Версія	Зв'язок	Критичність	Сповіщень	Виправлено в
image-size	`1.2.1`	непряма	висока	2	—

Сповіщення означає, що версія, записана в графі залежностей, потрапляє в уражений діапазон. Досяжність не аналізується, а граф містить піниї розробки й тестування — знахідка може стосуватися інструментів, а не поставленого коду.

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

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

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

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

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

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

0/60	Зірки — 0 зірок
0/25	Форки — 0 форків
0/15	Спостерігачі — 0 спостерігачів

forks	0
stars	0
watchers	0
growth_state	unverified
growth_factor_pct	100
growth_unverified_reason	no_history

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

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

Власність

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

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

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

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

Докладніше

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

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