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

narrativetrace / narrativetrace-java

Execution transparency for AI-written code: business-logic tracing that reads as a narrative. Redacted, diffable, approval-testable traces for humans and AI agents. NarrativeTrace for Java.

JavaВласна ліцензія★ 1 зірка⑂ 0 форківз серп. 2026 р.Переглянути на GitHub ↗
#agentic-ai#ai#ai-agents#ai-assisted-development#approval-testing#code-comprehension#debugging#generative-ai#gradle-plugin#java#kotlin#llm#logging#observability#opentelemetry#redaction#slf4j#snapshot-testing#structured-logging#tracing

narrativetrace/narrativetrace-java має індекс здоров’я 48 зі 100, що відповідає смузі «Слабкий». Найвищий показник — AI Readiness (85/100), найнижчий — Sustainability & Governance (22/100). Останнє оновлення було 1 день тому. Більшість нещодавньої роботи виконує один учасник.

48
загалом / 100
Слабкий

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

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

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

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

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

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

Власність

NarrativeTraceОрганізація · підтверджений домен
1 підписник5 публічних репозиторіївз серп. 2026 р.

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

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

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

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

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

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

54Помірний
Як обчислюється оцінка
36/36Свіжість push — останній push 1 дн. тому
4.2/36Ритм комітів — 6/52 тижнів із комітами
13.6/18Обсяг комітів — 32 комітів за останній рік
0/10OpenSSF Scorecard: Maintained — project was created within the last 90 days. Please review its contents carefully
Використані вхідні дані
commits_last_year32
human_commit_share1
days_since_last_push1
active_weeks_last_year6

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

88Відмінний
Як обчислюється оцінка
16.2/27Випускає релізи — 8 тегів версій (без релізів GitHub)
36/36Свіжість релізів — останній реліз 2 дн. тому
27/27Ритм релізів — реліз кожні ~5,7 дн.
0/10OpenSSF Scorecard: Signed-Releases — немає даних
Використані вхідні дані
releases_count8
latest_release_tagv0.4.0
releases_from_tagsтак
days_since_latest_release2
mean_days_between_releases5,7
Виключено з оцінювання (немає даних або не застосовно): OpenSSF Scorecard: Signed-Releases. Залишкові ваги перенормовано.

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

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

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

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

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

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

64Помірний
Як обчислюється оцінка
22.5/22.5README
16.9/22.5Ліцензія — файл ліцензії наявний, не є визнаною ліцензією
18/18Настанови CONTRIBUTING
0/13.5Кодекс поведінки
0/7.2Шаблон issue
0/6.3Шаблон PR
Використані вхідні дані
has_readmeтак
has_licenseтак
readme_badges0
has_contributingтак
has_issue_templateні
has_code_of_conductні
readme_badge_services—
has_pull_request_templateні

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

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

22У зоні ризику · 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

1Критичний
Як обчислюється оцінка
0/42Вирішення issue — немає issue або даних
0/30Прийняття PR — немає вирішених pull request-ів або даних
0/13Newcomer PR acceptance — за 30 дн. не вирішено жодного PR від новачка
0/15OpenSSF Scorecard: Code-Review — Found 0/30 approved changesets -- score normalized to 0
Використані вхідні дані
merged_prs0
open_issues0
closed_issues0
prs_merged_7d0
prs_decided_7d0
prs_merged_30d0
prs_decided_30d0
issue_closed_ratio—
closed_unmerged_prs0
first_time_authors_30d0
first_time_prs_merged_30d0
first_time_prs_decided_30d0
Виключено з оцінювання (немає даних або не застосовно): Вирішення issue, Прийняття PR, Newcomer PR acceptance. Залишкові ваги перенормовано.

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

58Помірний
Як обчислюється оцінка
30/30Підтримка власника — у власності організації
20/20Верифікований домен
2.2/25Охоплення власника — 1 підписників у narrativetrace
6/25Послужний список — 5 публічних репозиторіїв, вік облікового запису ~0 р.
Використані вхідні дані
followers1
owner_typeOrganization
is_verifiedтак
owner_loginnarrativetrace
public_repos5
account_age_days52

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

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

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

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

60Помірний
Як обчислюється оцінка
24/24Процеси CI — 3 процес(ів) CI
24/24Наявні тести
0/16Конфігурація лінтера
0/9.6Pre-commit-хуки
0/6.4.editorconfig
0/20OpenSSF Scorecard: CI-Tests — немає даних
Використані вхідні дані
has_ciтак
has_testsтак
has_editorconfigні
has_linter_configні
has_precommit_configні
Виключено з оцінювання (немає даних або не застосовно): OpenSSF Scorecard: CI-Tests. Залишкові ваги перенормовано.

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

100Винятковий
Як обчислюється оцінка
30/30README
25/25Каталог документації
15/15Сайт документації / домашня сторінка — https://narrativetrace.ai
10/10Опис репозиторію
10/10Теми — 20 тем
10/10Wiki
Використані вхідні дані
topicsagentic-ai, ai, ai-agents, ai-assisted-development, approval-testing, code-comprehension, debugging, generative-ai, gradle-plugin, java, kotlin, llm, logging, observability, opentelemetry, redaction, slf4j, snapshot-testing, structured-logging, tracing
has_wikiтак
homepagehttps://narrativetrace.ai
docs_sitehttps://narrativetrace.ai
has_readmeтак
has_docs_dirтак
has_descriptionтак

Безпека

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

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

Стан безпеки

41Слабкий
Як обчислюється оцінка
6/7.5Binary-Artifacts — binaries present in source code
0/7.5Branch-Protection — branch protection not enabled on development/release branches
0/2.5CI-Tests — немає даних
0/2.5CII-Best-Practices — no effort to earn an OpenSSF best practices badge detected
0/7.5Code-Review — Found 0/30 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
0/7.5Dependency-Update-Tool — no update tool detected
0/5Fuzzing — project is not fuzzed
2.2/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
3.5/5Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 7
0/5SAST — no SAST tool detected
5/5Security-Policy — security policy file detected
0/7.5Signed-Releases — немає даних
7.5/7.5Token-Permissions — GitHub workflow tokens follow principle of least privilege
0/7.5Vulnerabilities — 78 existing vulnerabilities detected
Використані вхідні дані
sourceopenssf_scorecard
checks_evaluated16
scorecard_versionv5.5.0
checks_inconclusive2
scorecard_aggregate4,1
Виключено з оцінювання (немає даних або не застосовно): CI-Tests, Signed-Releases. Залишкові ваги перенормовано.

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

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

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

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

100Винятковий
Як обчислюється оцінка
45/45Інструкції для агентів — .cursor/rules/narrativetrace.mdc, AGENTS.md
15/15Машиночитана документація (llms.txt) — llms.txt наявний
40/40Читабельна історія комітів — намір зазначено у 32 з 32 людських комітів (структурований заголовок або пояснювальний текст)
Використані вхідні дані
has_llms_txtтак
llms_txt_url—
legible_history_share1
agent_instruction_files.cursor/rules/narrativetrace.mdc, AGENTS.md
agent_instruction_max_bytes6 319

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

63Помірний
Як обчислюється оцінка
12.6/18Розгортання однією командою — build.gradle.kts, buildSrc/build.gradle.kts, contract-probe/build.gradle.kts (домовленість інструментарію, без раннера задач)
22/22Автоматизовані тести
0/11Конфігурація лінтера / форматера
11/11Статична перевірка типів — Java (статично типізована)
10/10Відтворюване середовище — Dockerfile
0/10Підтверджена практика роботи з агентами — серед останніх 32 комітів немає створених агентом
0/8Автоматизоване супроводження — автоматичних оновлень залежностей не виявлено
7/10OpenSSF Scorecard: Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 7
Використані вхідні дані
has_nixні
has_testsтак
lockfiles—
has_dockerfileтак
typed_languageтак
bootstrap_files—
has_devcontainerні
has_linter_configні
typecheck_configs—
agent_commit_share0
toolchain_manifestsbuild.gradle.kts, buildSrc/build.gradle.kts, contract-probe/build.gradle.kts, narrativetrace-agent-example/build.gradle.kts, narrativetrace-agent/build.gradle.kts, narrativetrace-api/build.gradle.kts, narrativetrace-benchmarks/build.gradle.kts, narrativetrace-build-tests/build.gradle.kts, narrativetrace-clarity/build.gradle.kts, narrativetrace-cli/build.gradle.kts, narrativetrace-core/build.gradle.kts, narrativetrace-diagrams/build.gradle.kts, narrativetrace-examples/build.gradle.kts, narrativetrace-examples/clarity/build.gradle.kts, narrativetrace-examples/common/build.gradle.kts, narrativetrace-examples/ecommerce/build.gradle.kts, narrativetrace-examples/ejb4/build.gradle.kts, narrativetrace-examples/library/build.gradle.kts, narrativetrace-examples/minecraft/build.gradle.kts, narrativetrace-glossary/build.gradle.kts, narrativetrace-gradle-plugin/build.gradle.kts, narrativetrace-jcstress/build.gradle.kts, narrativetrace-junit4-example/build.gradle.kts, narrativetrace-junit4/build.gradle.kts, narrativetrace-junit5/build.gradle.kts, narrativetrace-maven-example/pom.xml, narrativetrace-micrometer/build.gradle.kts, narrativetrace-micronaut-http/build.gradle.kts, narrativetrace-micronaut/build.gradle.kts, narrativetrace-opentelemetry/build.gradle.kts, narrativetrace-proxy/build.gradle.kts, narrativetrace-security-tests/build.gradle.kts, narrativetrace-servlet/build.gradle.kts, narrativetrace-skills-catalogue/build.gradle.kts, narrativetrace-skills-catalogue/evals/fixtures/clarity-consumer/build.gradle.kts, narrativetrace-skills-catalogue/evals/fixtures/clarity-junit4-class-rule/build.gradle.kts, narrativetrace-skills-catalogue/evals/fixtures/clarity-output-disabled/build.gradle.kts, narrativetrace-skills-catalogue/evals/fixtures/empty-project/build.gradle.kts, narrativetrace-skills-catalogue/evals/fixtures/existing-service-checkout-currency/build.gradle.kts, narrativetrace-skills-catalogue/evals/fixtures/existing-service-checkout/build.gradle.kts, narrativetrace-skills-catalogue/evals/fixtures/existing-service/build.gradle.kts, narrativetrace-skills-catalogue/evals/fixtures/feedback-false-positive/build.gradle.kts, narrativetrace-skills-catalogue/evals/fixtures/feedback-value-free/build.gradle.kts, narrativetrace-skills-catalogue/evals/fixtures/redaction-gap/build.gradle.kts, narrativetrace-skills-catalogue/evals/fixtures/spring-boot-service/build.gradle.kts, narrativetrace-skills/build.gradle.kts, narrativetrace-slf4j/build.gradle.kts, narrativetrace-soak/app/notify/build.gradle.kts, narrativetrace-soak/app/shop/build.gradle.kts, narrativetrace-soak/build.gradle.kts, narrativetrace-spring-web/build.gradle.kts, narrativetrace-spring/build.gradle.kts, narrativetrace-tooling/build.gradle.kts, recipes/checkout/build.gradle.kts, sixty-seconds/build.gradle.kts
dependency_bot_commit_share0

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

100Винятковий
Як обчислюється оцінка
45/45Типізований код — Java (статично типізована)
54.9/55Керовані розміри файлів — 4/1 521 файлів вихідного коду понад 60 КБ
Використані вхідні дані
primary_languageJava
largest_source_bytes93 907
source_files_sampled1 521
oversized_source_files4

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

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

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

1зірок GitHub
1контриб'юторів
32комітів за останні 12 місяців
1днів від останнього пушу
8релізів
1бас-фактор
0відкритих issue
Mavenпакетних екосистем

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

  • Star history unavailable: GitHub GraphQL error: Resource not accessible by personal access token
  • Could not fetch maven package 'ai.narrativetrace.examples:narrativetrace-maven-example' from its registry
  • GitHub dependency-graph SBOM unavailable (404); the dependency graph may be disabled for this repository

Докладніше

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

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

8Binary-Artifactsbinaries present in source code
0Branch-Protectionbranch protection not enabled on development/release branches
н/дCI-Testsno pull request found
0CII-Best-Practicesno effort to earn an OpenSSF best practices badge detected
0Code-ReviewFound 0/30 approved changesets -- score normalized to 0
0Contributorsproject has 0 contributing companies or organizations -- score normalized to 0
10Dangerous-Workflowno dangerous workflow patterns detected
0Dependency-Update-Toolno update tool detected
0Fuzzingproject is not fuzzed
9Licenselicense file detected
0Maintainedproject was created within the last 90 days. Please review its contents carefully
10Packagingpackaging workflow detected
7Pinned-Dependenciesdependency not pinned by hash detected -- score normalized to 7
0SASTno SAST tool detected
10Security-Policysecurity policy file detected
н/дSigned-Releasesno releases found
10Token-PermissionsGitHub workflow tokens follow principle of least privilege
0Vulnerabilities78 existing vulnerabilities detected
Усі залежності не зібрано

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

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

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

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

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

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

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

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.Винятковий100open-telemetry/opentelemetry-dotnetThe OpenTelemetry .NET ClientВинятковий99google/adk-pythonAn open-source, code-first Python toolkit for building, evaluating, and deploying sophisticated AI agents with flexibility and control.Винятковий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.Винятковий99pydantic/logfireAI observability platform for production LLM and agent systems.Винятковий98langwatch/langwatchThe platform for LLM evaluations and AI agent testingВинятковий

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

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

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